Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -279,7 +279,7 @@ directly:
| [python-sdk](https://github.com/ai-agent-assembly/python-sdk) | **This repo** — the Python SDK. |
| [node-sdk](https://github.com/ai-agent-assembly/node-sdk) · [go-sdk](https://github.com/ai-agent-assembly/go-sdk) | Sibling SDKs for TypeScript/Node and Go. |
| [homebrew-tap](https://github.com/ai-agent-assembly/homebrew-tap) | Homebrew tap for installing the `aasm` runtime CLI. |
| [agent-assembly-examples](https://github.com/ai-agent-assembly/agent-assembly-examples) | Runnable examples — learn by running small, framework-specific Python (and Node/Go) samples covering policy enforcement, approvals, audit, trace, and runtime workflows. |
| [agent-assembly-examples](https://github.com/ai-agent-assembly/examples) | Runnable examples — learn by running small, framework-specific Python (and Node/Go) samples covering policy enforcement, approvals, audit, trace, and runtime workflows. |

The protocol specification and gateway behaviour the SDK targets live in the core runtime
monorepo; see its [README](https://github.com/ai-agent-assembly/agent-assembly#readme) for the
Expand Down
4 changes: 2 additions & 2 deletions docs/examples/agno.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,6 @@ uv run pytest tests/ -v

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/agno-tool-policy)
- [Example README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/agno-tool-policy/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/agno-tool-policy)
- [Example README](https://github.com/ai-agent-assembly/examples/blob/master/python/agno-tool-policy/README.md)
- [Agno documentation](https://docs.agno.com/)
4 changes: 2 additions & 2 deletions docs/examples/crewai-research-crew.md
Original file line number Diff line number Diff line change
Expand Up @@ -204,6 +204,6 @@ The `chain:` column in the audit replay is the delegation call stack each `Audit

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/crewai-research-crew)
- [Example README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/crewai-research-crew/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/crewai-research-crew)
- [Example README](https://github.com/ai-agent-assembly/examples/blob/master/python/crewai-research-crew/README.md)
- [CrewAI documentation](https://docs.crewai.com/)
4 changes: 2 additions & 2 deletions docs/examples/custom-tool-policy.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,6 +144,6 @@ Running governed tool calls:

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/custom-tool-policy)
- [README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/custom-tool-policy/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/custom-tool-policy)
- [README](https://github.com/ai-agent-assembly/examples/blob/master/python/custom-tool-policy/README.md)
- [LlamaIndex — manual tool policy](llamaindex-tool-policy.md)
4 changes: 2 additions & 2 deletions docs/examples/framework-support.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ entry points. On exit, all hooks are removed in reverse order.
Each framework below ships an adapter under `agent_assembly/adapters/`. The
**Runnable example** column reflects whether a complete, validated example exists today —
either inline in this guide or as a curated script in the central
[`agent-assembly-examples`](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python)
[`agent-assembly-examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
repository.

| Framework | Adapter | Runnable example |
Expand Down Expand Up @@ -104,7 +104,7 @@ directory for additional in-repo runnable scripts and their status.
## More runnable examples

Curated, end-to-end examples for each framework live in the central
[`agent-assembly-examples`](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python)
[`agent-assembly-examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
repository. Each directory is a self-contained, cloneable project. This section documents each
one in detail — start with [Preparing the runtime environment](preparing-the-runtime-environment.md),
then follow the per-framework page:
Expand Down
4 changes: 2 additions & 2 deletions docs/examples/google-adk.md
Original file line number Diff line number Diff line change
Expand Up @@ -161,6 +161,6 @@ Assembly context shut down.

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/google-adk)
- [Example README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/google-adk/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/google-adk)
- [Example README](https://github.com/ai-agent-assembly/examples/blob/master/python/google-adk/README.md)
- [Google ADK documentation](https://google.github.io/adk-docs/)
4 changes: 2 additions & 2 deletions docs/examples/haystack.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,6 +112,6 @@ uv run pytest tests/ -v

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/haystack-tool-policy)
- [Example README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/haystack-tool-policy/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/haystack-tool-policy)
- [Example README](https://github.com/ai-agent-assembly/examples/blob/master/python/haystack-tool-policy/README.md)
- [Haystack documentation](https://haystack.deepset.ai/)
2 changes: 1 addition & 1 deletion docs/examples/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

End-to-end, runnable examples that govern real AI agent frameworks with Agent Assembly. Each
example is a self-contained project in the
[`agent-assembly-examples`](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python)
[`agent-assembly-examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
repository, and each page below walks through what it demonstrates, how the `init_assembly()`
adapter flow wires the framework, an annotated code walkthrough, and the expected output.

Expand Down
4 changes: 2 additions & 2 deletions docs/examples/langchain-basic-agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -189,6 +189,6 @@ Assembly context shut down.

## Links

- Example directory: <https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/langchain-basic-agent>
- Example README: <https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/langchain-basic-agent/README.md>
- Example directory: <https://github.com/ai-agent-assembly/examples/tree/master/python/langchain-basic-agent>
- Example README: <https://github.com/ai-agent-assembly/examples/blob/master/python/langchain-basic-agent/README.md>
- LangChain documentation: <https://python.langchain.com/>
4 changes: 2 additions & 2 deletions docs/examples/langchain-research-agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -211,6 +211,6 @@ The final block replays the full audit trail and the running budget total — th

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/langchain-research-agent)
- [Example README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/langchain-research-agent/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/langchain-research-agent)
- [Example README](https://github.com/ai-agent-assembly/examples/blob/master/python/langchain-research-agent/README.md)
- [LangChain documentation](https://python.langchain.com/)
4 changes: 2 additions & 2 deletions docs/examples/langgraph.md
Original file line number Diff line number Diff line change
Expand Up @@ -165,6 +165,6 @@ Assembly context shut down.

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/langgraph)
- [README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/langgraph/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/langgraph)
- [README](https://github.com/ai-agent-assembly/examples/blob/master/python/langgraph/README.md)
- [LangGraph documentation](https://langchain-ai.github.io/langgraph/)
4 changes: 2 additions & 2 deletions docs/examples/llamaindex-tool-policy.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,6 +115,6 @@ uv run pytest tests/ -v

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/llamaindex-tool-policy)
- [Example README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/llamaindex-tool-policy/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/llamaindex-tool-policy)
- [Example README](https://github.com/ai-agent-assembly/examples/blob/master/python/llamaindex-tool-policy/README.md)
- [LlamaIndex documentation](https://docs.llamaindex.ai/)
4 changes: 2 additions & 2 deletions docs/examples/microsoft-agent-framework.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,6 +127,6 @@ The smoke tests `pytest.importorskip("agent_framework")`, so they **skip cleanly

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/microsoft-agent-framework-tool-policy)
- [Example README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/microsoft-agent-framework-tool-policy/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/microsoft-agent-framework-tool-policy)
- [Example README](https://github.com/ai-agent-assembly/examples/blob/master/python/microsoft-agent-framework-tool-policy/README.md)
- [Microsoft Agent Framework](https://github.com/microsoft/agent-framework)
4 changes: 2 additions & 2 deletions docs/examples/openai-agents-sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -157,6 +157,6 @@ Running governed tool calls:

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/openai-agents-sdk)
- [Example README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/openai-agents-sdk/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/openai-agents-sdk)
- [Example README](https://github.com/ai-agent-assembly/examples/blob/master/python/openai-agents-sdk/README.md)
- [OpenAI Agents SDK docs](https://openai.github.io/openai-agents-python/)
4 changes: 2 additions & 2 deletions docs/examples/preparing-the-runtime-environment.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Preparing the runtime environment

Every page in this section walks through a self-contained, cloneable example from the
[`agent-assembly-examples`](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python)
[`agent-assembly-examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
repository. The examples share the same prerequisites and the same run shape, so this page
collects everything you need **once** — each per-framework page then only lists what is
specific to that example.
Expand Down Expand Up @@ -41,7 +41,7 @@ The examples live in a dedicated repository. Clone it and change into the `pytho
directory:

```bash
git clone https://github.com/ai-agent-assembly/agent-assembly-examples.git
git clone https://github.com/ai-agent-assembly/examples.git
cd agent-assembly-examples/python
```

Expand Down
4 changes: 2 additions & 2 deletions docs/examples/pydantic-ai.md
Original file line number Diff line number Diff line change
Expand Up @@ -193,6 +193,6 @@ Assembly context shut down.

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/pydantic-ai)
- [Example README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/pydantic-ai/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/pydantic-ai)
- [Example README](https://github.com/ai-agent-assembly/examples/blob/master/python/pydantic-ai/README.md)
- [Pydantic AI documentation](https://ai.pydantic.dev/)
4 changes: 2 additions & 2 deletions docs/examples/smolagents.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,6 +112,6 @@ It asserts that an allowed tool runs its body, a denied tool returns the `[BLOCK

## Links

- [Example directory](https://github.com/ai-agent-assembly/agent-assembly-examples/tree/master/python/smolagents-tool-policy)
- [Example README](https://github.com/ai-agent-assembly/agent-assembly-examples/blob/master/python/smolagents-tool-policy/README.md)
- [Example directory](https://github.com/ai-agent-assembly/examples/tree/master/python/smolagents-tool-policy)
- [Example README](https://github.com/ai-agent-assembly/examples/blob/master/python/smolagents-tool-policy/README.md)
- [Smolagents documentation](https://github.com/huggingface/smolagents)