Add agents documentation; update README with extras install instructions

Copies Agentspan's docs/ (6 files: README, getting-started, writing-agents,
advanced, framework-agents, api-reference) into docs/agents/. Fixes the
two install-instruction lines that referenced the now-discarded package:
docs/agents/README.md's PyPI badge and docs/agents/getting-started.md's
`uv add conductor-agent-sdk` -- both now point at
`pip install 'conductor-python[agents]'`. Left CLI command references
(`agentspan deploy`, `agentspan credentials set`, etc.) untouched --
those describe the separate Go CLI binary, which is its own release
artifact in the agentspan monorepo, not part of this merge or the
Agentspan Python SDK being discarded.

Adds a new "AI Agents" section to the root README (deliberately
separate from the existing "AI & LLM Workflows" section, which covers
the older conductor.client.ai orchestrator layer, not this durable
agent-runtime layer) plus a docs-table entry and an extras-install
callout in "Install the SDK". Mirrors the same addition in
examples/README.md's AI/LLM Workflows area, pointing at the new
examples/agents/README.md catalog rather than duplicating its 270+
entries.

Author: Kowser

README.md

@@ -23,6 +23,7 @@ If you find [Conductor](https://github.com/conductor-oss/conductor) useful, plea
   * [Monitoring with Metrics](#monitoring-with-metrics)
   * [Managing Workflow Executions](#managing-workflow-executions)
 * [AI & LLM Workflows](#ai--llm-workflows)
+* [AI Agents](#ai-agents)
 * [Why Conductor?](#why-conductor)
 * [Examples](#examples)
 * [Documentation](#documentation)
@@ -67,6 +68,13 @@ pip install conductor-python
 
 > **Already in a virtual environment?** Skip the `venv` step and run `pip install conductor-python` directly. On macOS, Windows, or in containers where system Python is not locked down, you can also install globally.
 
+Building durable AI agents instead? Install the `agents` extra (or a per-framework extra —
+see [AI Agents](#ai-agents)):
+
+```shell
+pip install 'conductor-python[agents]'
+```
+
 ## 60-Second Quickstart
 
 **Step 1: Create a workflow**
@@ -407,6 +415,35 @@ python examples/rag_workflow.py document.pdf "What are the key findings?"
 
 ---
 
+## AI Agents
+
+Beyond the workflow-embedded LLM calls above, `conductor-python` also ships a durable
+agent-authoring layer — `Agent`, `AgentRuntime`, `tool`, guardrails, handoffs, and multi-agent
+strategies — where the agent itself compiles into a Conductor workflow that runs on the server,
+with retries, durable state, streaming, and human-in-the-loop pauses built in.
+
+```shell
+pip install 'conductor-python[agents]'
+```
+
+```python
+from conductor.ai.agents import Agent, AgentRuntime
+
+agent = Agent(name="greeter", model="anthropic/claude-sonnet-4-6",
+              instructions="You are a friendly assistant.")
+
+with AgentRuntime() as runtime:
+    result = runtime.run(agent, "Say hello.")
+    print(result.output)
+```
+
+Framework integrations (LangChain, LangGraph, Google ADK, the OpenAI Agents SDK, Claude Agent SDK)
+are optional extras — see [docs/agents/getting-started.md](docs/agents/getting-started.md) for
+per-framework install instructions, and [examples/agents/](examples/agents/) for 270+ runnable
+examples. Full docs: [docs/agents/](docs/agents/).
+
+---
+
 ## Why Conductor?
 
 | | |
@@ -467,6 +504,7 @@ End-to-end examples covering all APIs for each domain:
 | [Secrets](docs/SECRET_MANAGEMENT.md) | Secret storage |
 | [Prompts](docs/PROMPT.md) | AI/LLM prompt templates |
 | [Integrations](docs/INTEGRATION.md) | AI/LLM provider integrations |
+| [AI Agents](docs/agents/README.md) | Durable agent authoring: `Agent`, `AgentRuntime`, tools, guardrails, handoffs |
 | [Metrics](METRICS.md) | Prometheus metrics collection |
 | [Examples](examples/README.md) | Complete examples catalog |
 

docs/agents/README.md

@@ -0,0 +1,39 @@
+# Agentspan Python SDK
+
+> Ships as part of [`conductor-python`](https://pypi.org/project/conductor-python/) — install with the `agents` extra
+> (`pip install 'conductor-python[agents]'`) — you're in the right place.
+
+Long-running, dynamic plan-execute, and event-driven AI agents in Python. You write plain Python; Agentspan compiles your agent into a Conductor workflow that runs on a server — with automatic retries, durable state, human-in-the-loop pauses, streaming, scheduling, dynamic plan-execute, and full execution history.
+
+```python
+from conductor.ai.agents import Agent, AgentRuntime
+
+agent = Agent(name="greeter", model="anthropic/claude-sonnet-4-6",
+              instructions="You are a friendly assistant.")
+
+with AgentRuntime() as runtime:
+    result = runtime.run(agent, "Say hello.")
+    print(result.output)
+```
+
+## Docs
+
+- [Getting started](getting-started.md) — install, env vars, and a running agent in under 30 seconds.
+- [Writing agents](writing-agents.md) — the `Agent` class and `@agent`, tools, multi-agent strategies, handoffs, guardrails, termination, callbacks, streaming + HITL, schedules, stateful and instance agents.
+- [Framework agents](framework-agents.md) — run agents authored in the OpenAI Agents SDK, LangChain, LangGraph, or the Claude Agent SDK.
+- [Advanced](advanced.md) — runtime config, the control-plane `AgentClient`, deploy vs serve vs run vs plan, structured output, credentials, plans (`PLAN_EXECUTE`), skills.
+- [API reference](api-reference.md) — the public API surface in one place.
+
+## Import surface
+
+Everything public is importable from `conductor.ai.agents`:
+
+```python
+from conductor.ai.agents import Agent, AgentRuntime, tool, agent
+```
+
+A small OpenAI-Agents-compatible shim is also exposed at the top level:
+
+```python
+from conductor.ai import Runner, function_tool   # drop-in for `agents.Runner`
+```