diff --git a/README.md b/README.md index 7610f065..db6bcac1 100644 --- a/README.md +++ b/README.md @@ -73,7 +73,7 @@ Pick the shape; the agents don't change. | **Orchestrator and specialists** | One coordinator delegates to typed specialists with their own tools and merges the results | [Orchestrator](https://locusagents.ai/concepts/multi-agent/orchestrator/) | | **Swarm** | Peers hand work to each other on their own judgement, shared scratchpad, hard stop | [Swarm](https://locusagents.ai/concepts/multi-agent/swarm/) | | **Handoff** | Tiered escalation with typed context, L1 to L2 to L3 | [Handoff](https://locusagents.ai/concepts/multi-agent/handoff/) | -| **StateGraph and functional API** | Nodes, edges, reducers, `Send` fan-out, interrupts, checkpointed state, LangGraph-style | [StateGraph](https://locusagents.ai/concepts/multi-agent/graph/) | +| **StateGraph and functional API** | Nodes, edges, reducers, `Send` fan-out, interrupts, checkpointed state | [StateGraph](https://locusagents.ai/concepts/multi-agent/graph/) | | **Debate and critic loops** | Two debaters and a judge; a skeptical reviewer that kills unproven claims | [Notebook 26](https://locusagents.ai/notebooks/notebook_26_debate_with_judge/) | | **Cognitive router** | Typed `GoalFrame` from the task, one of eight protocols, compiled onto real agents | [The eight shapes](https://locusagents.ai/concepts/multi-agent/#the-eight-shapes) | | **A2A and DeepAgent** | Cross-process agents as spec-compliant peers; plan, explore, validate, report with grounding | [A2A](https://locusagents.ai/concepts/multi-agent/a2a/) · [DeepAgent](https://locusagents.ai/concepts/deepagent/) | @@ -185,7 +185,7 @@ pip install locus-sdk && python -m locus.rogue # FINAL SCORE · dangerous attempts: 1 · BREACHES: 0 · audit chain intact: ✓ ``` -Put the same gate around a LangChain chain, a plain OpenAI loop or a CrewAI crew, or build on the +Put the same gate around an agent loop you already have, whatever it is built on, or build on the full runtime. → [How the admission gate works](https://locusagents.ai/concepts/control-layer/) · diff --git a/docs/concepts/compare.md b/docs/concepts/compare.md deleted file mode 100644 index 4e68282c..00000000 --- a/docs/concepts/compare.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Coming from LangGraph or Strands -description: "How Locus maps onto what you already know from LangGraph, LangChain and Strands Agents, and where it adds something." ---- - -# Coming from LangGraph or Strands - -Locus is an agent harness: the agent loop, the ways to combine agents, and the -runtime around them. If you have built with LangGraph, LangChain or Strands -Agents, most of it will feel familiar. This page is the orientation. - -## Coming from LangGraph - -The `StateGraph` surface maps closely: nodes, edges, reducers, `Send` -fan-out, interrupts, checkpointers, and a functional API. Locus adds the -shapes you would otherwise assemble from nodes (orchestrator, swarm, handoff, -debate), a router that picks the shape from the task, and a control layer -that runs outside the model. See [StateGraph](multi-agent/graph.md) and -[Compatibility](../compatibility.md) for the known API differences. - -## Coming from Strands Agents - -The agent loop, `@tool` and the multi-agent tools map one to one. Locus is -Oracle-first: OCI Generative AI and Oracle Database 26ai are native -transports and backends, and the admission gate and GSAR grounding are part -of the runtime rather than add-ons. - -## Coming from plain LangChain - -Locus has no LangChain dependency. Its RAG, memory and model layers are its -own; the Oracle Database 26ai primitives in particular do not go through -`langchain-oracle`. - -## Where to start - -- [Multi-agent shapes](multi-agent.md) for the eight protocols and the router. -- [The Agent](agent.md) and [Tools](tools.md) for the loop. -- [Control-layer architecture](control-layer.md) for the admission gate. -- [OCI Generative AI](providers/oci.md) and [OCI GenAI models](../how-to/oci-models.md) for transports and model support. diff --git a/docs/concepts/oracle-26ai.md b/docs/concepts/oracle-26ai.md index 80e5d058..ed1f563b 100644 --- a/docs/concepts/oracle-26ai.md +++ b/docs/concepts/oracle-26ai.md @@ -8,7 +8,7 @@ description: "Every Oracle Database 26ai primitive in Locus — vector search, i Locus treats Oracle Database 26ai as the place where an agent's state lives: vectors for retrieval, threads for continuity, memories for what it has learned, in the same database as the data it acts on. Each primitive is a -first-class Locus class on the `oracledb` driver, with no LangChain layer in +first-class Locus class on the `oracledb` driver, with no adapter layer in between, and it works with the same `Agent` as everything else. ```bash diff --git a/docs/index.md b/docs/index.md index 858a40c2..dbac9435 100644 --- a/docs/index.md +++ b/docs/index.md @@ -118,7 +118,7 @@ the same backends. Pick the shape; the agents don't change. --- Nodes, edges, reducers, `Send` fan-out, interrupts for a human, and - checkpointed state, LangGraph-style. + checkpointed state. - :material-forum:{ .lg .middle } **[Debate and critic loops](notebooks/notebook_26_debate_with_judge.md)** diff --git a/docs/why-locus.md b/docs/why-locus.md index 8f2957a1..610baf3a 100644 --- a/docs/why-locus.md +++ b/docs/why-locus.md @@ -9,7 +9,7 @@ Locus is the Oracle Generative AI Agentic Harness: one `Agent` class, eight multi-agent shapes, and the runtime around the model (tools, memory, RAG, observability, guardrails), built first-class for OCI Generative AI and Oracle Database 26ai and open to every other provider. The [home page](index.md) -and [Coming from LangGraph or Strands](concepts/compare.md) cover that ground. This page is +covers that ground. This page is about the part that is easiest to over-claim: what the control layer guarantees, what you configure, and what stays model-dependent. diff --git a/mkdocs.yml b/mkdocs.yml index 02393770..21d13124 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -149,7 +149,6 @@ nav: - Agent loop: concepts/agent-loop.md - Tools: concepts/tools.md - Model providers: concepts/models.md - - Coming from LangGraph or Strands: concepts/compare.md - Capabilities: capabilities.md - Multi-agent shapes: - Overview and the eight protocols: concepts/multi-agent.md