Context
The Go, Rust, and TypeScript SDKs each ship runnable planning and connectors examples, and the Java SDK tracks the same gap in getaxonflow/axonflow-sdk-java#146. The Python SDK's examples/ directory covers decisions, audit, and gateway flows, but has no example for the planning APIs or the connector listing API, even though axonflow/client.py supports both (generate_plan, execute_plan, list_connectors).
What
Add two flat example scripts in the existing house style:
examples/planning.py - exercises generate_plan and then execute_plan on the returned plan
examples/connectors.py - exercises list_connectors (read-only; works against a local community stack with no external credentials)
Sibling to imitate
examples/list_decisions.py in this repo is the template: module docstring listing required env vars, async main() returning an exit code, endpoint from AXONFLOW_AGENT_URL (default http://localhost:8080), credentials from AXONFLOW_CLIENT_ID / AXONFLOW_CLIENT_SECRET.
- For what each example should demonstrate, the Go SDK has runnable siblings at
examples/planning/ and examples/connectors/ in getaxonflow/axonflow-sdk-go.
Note: the planning example needs an LLM provider configured on the local stack; say so in the module docstring (the connectors example has no such requirement).
Acceptance criteria
Happy to help scope or review - questions welcome right here on the thread.
Context
The Go, Rust, and TypeScript SDKs each ship runnable
planningandconnectorsexamples, and the Java SDK tracks the same gap in getaxonflow/axonflow-sdk-java#146. The Python SDK'sexamples/directory covers decisions, audit, and gateway flows, but has no example for the planning APIs or the connector listing API, even thoughaxonflow/client.pysupports both (generate_plan,execute_plan,list_connectors).What
Add two flat example scripts in the existing house style:
examples/planning.py- exercisesgenerate_planand thenexecute_planon the returned planexamples/connectors.py- exerciseslist_connectors(read-only; works against a local community stack with no external credentials)Sibling to imitate
examples/list_decisions.pyin this repo is the template: module docstring listing required env vars, asyncmain()returning an exit code, endpoint fromAXONFLOW_AGENT_URL(defaulthttp://localhost:8080), credentials fromAXONFLOW_CLIENT_ID/AXONFLOW_CLIENT_SECRET.examples/planning/andexamples/connectors/in getaxonflow/axonflow-sdk-go.Note: the planning example needs an LLM provider configured on the local stack; say so in the module docstring (the connectors example has no such requirement).
Acceptance criteria
examples/planning.pyexists and runs against a local stack athttp://localhost:8080examples/connectors.pyexists and runs againsthttp://localhost:8080with no external credentialsexamples/list_decisions.pyHappy to help scope or review - questions welcome right here on the thread.