agentdeck-sdk 4.0.2__tar.gz → 4.0.3__tar.gz

agentdeck_sdk-4.0.3/.github/ISSUE_TEMPLATE/docs_contribution.yml

@@ -0,0 +1,119 @@
+name: Documentation contribution
+description: A scoped documentation task, specified well enough to be someone's first contribution.
+title: "docs: "
+labels: ["documentation", "area:docs"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Questions are welcome on this issue. Ask before you write if anything about
+        AgentDeck's intent is unclear: a maintainer will answer, and asking is not a
+        sign the task was too hard for you.
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: >
+        The AgentDeck concept this documents, and why the page exists. A contributor
+        should not have to reverse-engineer the architecture before starting.
+    validations:
+      required: true
+
+  - type: textarea
+    id: current-state
+    attributes:
+      label: Current state
+      description: What is implemented, and what the page already says. Link both the page and the source.
+    validations:
+      required: true
+
+  - type: textarea
+    id: missing
+    attributes:
+      label: What is missing
+      description: >
+        Precise. Not "improve this page". Name the artifact: a runnable example of X,
+        a diagram of Y, a troubleshooting entry for Z.
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected contribution
+      description: What to add, with a suggested structure or heading list.
+    validations:
+      required: true
+
+  - type: textarea
+    id: apis
+    attributes:
+      label: Relevant APIs and source files
+      description: The classes, functions and protocols to read, with links.
+    validations:
+      required: true
+
+  - type: input
+    id: files
+    attributes:
+      label: Files to change
+      description: The exact MDX or example paths.
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      value: |
+        - [ ] Uses only public APIs from `agentdeck`
+        - [ ] Any code shown runs against the current release
+        - [ ] Does not duplicate the Quickstart
+        - [ ] Includes the expected output
+        - [ ] Links the related reference page
+        - [ ] `make check` passes
+        - [ ] `docs-site` builds
+    validations:
+      required: true
+
+  - type: textarea
+    id: out-of-scope
+    attributes:
+      label: Out of scope
+      value: |
+        - No API redesign
+        - No new runtime behavior
+        - No change to Run semantics
+        - No navigation restructuring
+        - No new abstraction unless agreed on this issue first
+    validations:
+      required: true
+
+  - type: textarea
+    id: verify
+    attributes:
+      label: How to verify locally
+      value: |
+        ```bash
+        make install                 # editable install with every extra
+        make check                   # ruff, ty, import-linter, pytest
+
+        cd docs-site
+        npm install
+        npm run dev                  # http://localhost:3040
+        ```
+    validations:
+      required: true
+
+  - type: dropdown
+    id: difficulty
+    attributes:
+      label: Difficulty
+      description: Small and medium are eligible for `good first issue`. Advanced is not.
+      options:
+        - small
+        - medium
+        - advanced
+    validations:
+      required: true

agentdeck_sdk-4.0.3/.import_linter_cache/agentdeck.meta.json

@@ -0,0 +1 @@
+{"agentdeck.adapters.tools.mcp.lifecycle": 1787116965.5550206, "agentdeck.authoring.state": 1787116965.5558999, "agentdeck.adapters.stores.memory.store": 1787116965.5538716, "agentdeck.adapters.leases.memory": 1787116965.5535116, "agentdeck.observers": 1787116965.5570045, "agentdeck.core.ports.tools": 1787116965.5570045, "agentdeck.adapters.engines.openai_agents.reconcile": 1787116965.5529594, "agentdeck.adapters.control.memory": 1787116965.5522475, "agentdeck.testing": 1787116965.5592065, "agentdeck.authoring": 1787116965.5550206, "agentdeck.surfaces.serve.compat": 1787116965.5592065, "agentdeck.core.content": 1787116965.5565078, "agentdeck.errors": 1787116965.5570045, "agentdeck.mcp": 1787116965.5570045, "agentdeck.surfaces.serve": 1787116965.559095, "agentdeck.adapters.control.sqlite.port": 1787116965.552406, "agentdeck.authoring.graphs": 1787116965.5552967, "agentdeck.adapters.telemetry": 1787116965.5544012, "agentdeck.adapters.engines.langgraph": 1787116965.5525553, "agentdeck.adapters.engines.langgraph.engine": 1787116965.5526073, "agentdeck.adapters.control.memory.port": 1787116965.5522985, "agentdeck.adapters.tools.mcp.transport": 1787116965.5550206, "agentdeck.adapters.stores.postgres": 1787116965.5538716, "agentdeck.adapters.tools.mcp": 1787116965.5549686, "agentdeck.surfaces.cli.chat": 1787116965.559095, "agentdeck.core.ports.engine": 1787116965.5570045, "agentdeck.surfaces.cli": 1787116965.5590405, "agentdeck.adapters.leases.sqlite": 1787116965.553562, "agentdeck.adapters.telemetry.langfuse": 1787116965.5546103, "agentdeck.cli": 1787116965.5558999, "agentdeck.authoring.runners.agent": 1787116965.5558999, "agentdeck.authoring.compile": 1787116965.5552967, "agentdeck.deck": 1787116965.5570045, "agentdeck.adapters.telemetry.langfuse.client": 1787116965.5546634, "agentdeck.adapters.engines.stub.engine": 1787116965.5533779, "agentdeck.core.base": 1787116965.5565078, "agentdeck.authoring.instructions": 1787116965.5552967, "agentdeck.core.context": 1787116965.5565078, "agentdeck.core.invocable": 1787116965.5565078, "agentdeck.adapters.stores.memory": 1787116965.5538218, "agentdeck.runtime": 1787116965.5570045, "agentdeck.core.ports.lease": 1787116965.5570045, "agentdeck.authoring.tools": 1787116965.5558999, "agentdeck.authoring.timers": 1787116965.5558999, "agentdeck.authoring.runners.workflow": 1787116965.5558999, "agentdeck.adapters.engines.openai_agents.translate": 1787116965.5529594, "agentdeck.adapters.stores.redis.store": 1787116965.5542138, "agentdeck": 1787116965.552069, "agentdeck.authoring.web_search": 1787116965.5558999, "agentdeck.core.ports.store": 1787116965.5570045, "agentdeck.authoring.injection": 1787116965.5552967, "agentdeck.composition": 1787116965.5558999, "agentdeck.adapters": 1787116965.552069, "agentdeck.surfaces": 1787116965.5589151, "agentdeck.adapters.control.sqlite": 1787116965.5522985, "agentdeck.adapters.engines.langgraph.checkpointer": 1787116965.5526073, "agentdeck.authoring.runners": 1787116965.5552967, "agentdeck.authoring.agent": 1787116965.5552967, "agentdeck.core.ports": 1787116965.5565078, "agentdeck.adapters.tools": 1787116965.5546634, "agentdeck.surfaces.serve.workflows": 1787116965.5592065, "agentdeck.adapters.engines.openai_agents.engine": 1787116965.5529594, "agentdeck.adapters.telemetry.langfuse.sink": 1787116965.5546634, "agentdeck.core.events": 1787116965.5565078, "agentdeck.adapters.stores.sqlite.store": 1787116965.5544012, "agentdeck.authoring.nodes": 1787116965.5552967, "agentdeck.core.control": 1787116965.5565078, "agentdeck.authoring.workflow": 1787116965.5558999, "agentdeck.skills": 1787116965.557994, "agentdeck.adapters.engines": 1787116965.552406, "agentdeck.adapters.tools.mcp.wiring": 1787116965.5550206, "agentdeck.core.ports.sink": 1787116965.5570045, "agentdeck.runtime.dispatch": 1787116965.557994, "agentdeck.authoring.interrupts": 1787116965.5552967, "agentdeck.runtime.service": 1787116965.557994, "agentdeck.authoring.hooks": 1787116965.5552967, "agentdeck.adapters.leases": 1787116965.5533779, "agentdeck.adapters.leases.memory.port": 1787116965.553562, "agentdeck.runtime.registry": 1787116965.557994, "agentdeck.core.ports.control": 1787116965.5570045, "agentdeck.adapters.engines.openai_agents.sessions": 1787116965.5529594, "agentdeck.core": 1787116965.5558999, "agentdeck.adapters.engines.openai_agents.runconfig": 1787116965.5529594, "agentdeck.adapters.engines.stub": 1787116965.5529594, "agentdeck.core.status": 1787116965.5570045, "agentdeck.skills.bundle": 1787116965.5589151, "agentdeck.adapters.tools.mcp.source": 1787116965.5550206, "agentdeck.adapters.stores.redis": 1787116965.5540164, "agentdeck.adapters.engines.openai_agents": 1787116965.5526073, "agentdeck.adapters.leases.sqlite.port": 1787116965.5536659, "agentdeck.runtime.capture": 1787116965.557994, "agentdeck.runtime.settings": 1787116965.557994, "agentdeck.adapters.stores": 1787116965.5536659, "agentdeck.adapters.stores.sqlite": 1787116965.5542138, "agentdeck.core.reporting": 1787116965.5570045, "agentdeck.authoring.skills": 1787116965.5558999, "agentdeck.runtime.discovery": 1787116965.557994, "agentdeck.adapters.telemetry.langfuse.trace": 1787116965.5546634, "agentdeck.adapters.control": 1787116965.552186, "agentdeck.adapters.stores.postgres.store": 1787116965.5540164, "agentdeck.serve": 1787116965.557994, "agentdeck.surfaces.serve.app": 1787116965.5592065}

agentdeck_sdk-4.0.3/.import_linter_cache/cc0de4ae2e5697bf7cf3a0b9c3aff14b2ece24cd.data.json

@@ -0,0 +1 @@
+{"agentdeck.adapters.leases":[],"agentdeck.adapters.control.sqlite.port":[["sqlite3",10,"import sqlite3"],["asyncio",9,"import asyncio"],["typing",13,"from typing import TYPE_CHECKING"],["agentdeck.core.control",15,"from agentdeck.core.control import ControlSignal, Signal"],["__future__",7,"from __future__ import annotations"],["contextlib",11,"from contextlib import suppress"],["agentdeck.errors",17,"from agentdeck.errors import StoreError"],["pathlib",21,"from pathlib import Path"],["agentdeck.core.ports.control",16,"from agentdeck.core.ports.control import ControlPort"],["collections",20,"from collections.abc import Callable"],["functools",12,"from functools import partial"]],"agentdeck.core.ports.lease":[["__future__",14,"from __future__ import annotations"],["collections",20,"from collections.abc import Collection"],["typing",17,"from typing import TYPE_CHECKING"],["abc",16,"from abc import ABC, abstractmethod"],["datetime",21,"from datetime import timedelta"]],"agentdeck.authoring.instructions":[["inspect",20,"import inspect"],["typing",21,"from typing import TYPE_CHECKING, Any"],["agentdeck.authoring.injection",23,"from agentdeck.authoring.injection import analyze_callable, check_context_type, describe_callable"],["__future__",18,"from __future__ import annotations"],["agentdeck.errors",25,"from agentdeck.errors import ConfigError"],["agentdeck.core.context",24,"from agentdeck.core.context import Context, RunContext"],["collections",28,"from collections.abc import Callable"]],"agentdeck.adapters.tools.mcp.source":[["agentdeck.adapters.tools.mcp.wiring",13,"from agentdeck.adapters.tools.mcp.wiring import mcp_status_banner, resolve_agent_mcp_status"],["typing",11,"from typing import TYPE_CHECKING"],["agentdeck.core.ports.tools",14,"from agentdeck.core.ports.tools import ToolSet, ToolSourcePort"],["__future__",9,"from __future__ import annotations"],["agentdeck.core.invocable",17,"from agentdeck.core.invocable import InvocableSpec"]],"agentdeck.authoring.timers":[["__future__",7,"from __future__ import annotations"],["datetime",9,"from datetime import UTC, datetime"],["typing",10,"from typing import Any"],["langgraph",12,"from langgraph.types import interrupt"]],"agentdeck.adapters.control":[],"agentdeck.core.ports.sink":[["abc",9,"from abc import ABC, abstractmethod"],["agentdeck.core.events",13,"from agentdeck.core.events import Event"],["__future__",7,"from __future__ import annotations"],["typing",10,"from typing import TYPE_CHECKING"]],"agentdeck.adapters.tools":[],"agentdeck.adapters.stores.sqlite.store":[["pathlib",27,"from pathlib import Path"],["contextlib",14,"from contextlib import suppress"],["asyncio",11,"import asyncio"],["__future__",9,"from __future__ import annotations"],["agentdeck.core.context",29,"from agentdeck.core.context import RunContext"],["agentdeck.core.status",21,"from agentdeck.core.status import LIFECYCLE_KINDS, STATES, can_resume, status_of"],["datetime",15,"from datetime import datetime"],["sqlite3",13,"import sqlite3"],["json",12,"import json"],["agentdeck.core.status",31,"from agentdeck.core.status import RunStatus"],["agentdeck.core.events",19,"from agentdeck.core.events import Event"],["datetime",26,"from datetime import timedelta"],["agentdeck.core.ports",20,"from agentdeck.core.ports import EventStorePort, RunSummary, SessionClaim"],["agentdeck.errors",22,"from agentdeck.errors import DuplicateKeyError, StoreError"],["functools",16,"from functools import partial"],["typing",17,"from typing import TYPE_CHECKING"],["agentdeck.core.events",30,"from agentdeck.core.events import KnownPayload, RunResumed, RunStarted"],["collections",25,"from collections.abc import Callable, Sequence"]],"agentdeck.adapters.stores.sqlite":[["agentdeck.adapters.stores.sqlite.store",3,"from agentdeck.adapters.stores.sqlite.store import SqliteEventStore"]],"agentdeck.adapters.engines.openai_agents":[["agentdeck.adapters.engines.openai_agents.runconfig",6,"from agentdeck.adapters.engines.openai_agents.runconfig import RunSettings"],["__future__",3,"from __future__ import annotations"],["agentdeck.adapters.engines.openai_agents.engine",5,"from agentdeck.adapters.engines.openai_agents.engine import OpenAIAgentsEngine"],["agentdeck.adapters.engines.openai_agents.sessions",7,"from agentdeck.adapters.engines.openai_agents.sessions import ExecutionStore, SessionFactory"]],"agentdeck.surfaces":[],"agentdeck.adapters":[],"agentdeck.authoring.runners":[["agentdeck.authoring.runners.agent",3,"from agentdeck.authoring.runners.agent import BaseRunner, HeadlessRunner, StreamDone"],["agentdeck.authoring.runners.workflow",4,"from agentdeck.authoring.runners.workflow import BaseWorkflowRunner, DevWorkflowRunner"]],"agentdeck.adapters.engines.openai_agents.reconcile":[["agentdeck.core.events",42,"from agentdeck.core.events import Event"],["agentdeck.core.content",41,"from agentdeck.core.content import Input"],["typing",29,"from typing import TYPE_CHECKING, Any, Literal"],["__future__",24,"from __future__ import annotations"],["asyncio",26,"import asyncio"],["agents",39,"from agents.memory.session import Session"],["collections",36,"from collections.abc import Iterable, Sequence"],["agentdeck.core.content",32,"from agentdeck.core.content import DataBlock, TextBlock"],["agents",38,"from agents.items import TResponseInputItem"],["logging",28,"import logging"],["json",27,"import json"],["agentdeck.core.events",33,"from agentdeck.core.events import Custom, InputAppended, MessageCompleted, RunCancelled, RunStarted"],["weakref",30,"from weakref import WeakKeyDictionary"]],"agentdeck.adapters.leases.memory":[["agentdeck.adapters.leases.memory.port",3,"from agentdeck.adapters.leases.memory.port import MemoryLeasePort"]],"agentdeck.adapters.telemetry.langfuse.trace":[["collections",18,"from collections.abc import Mapping"],["typing",15,"from typing import TYPE_CHECKING, Any, Literal, Protocol"],["agentdeck.core.events",20,"from agentdeck.core.events import Usage"],["__future__",13,"from __future__ import annotations"]],"agentdeck.authoring.graphs":[["inspect",26,"import inspect"],["langgraph",38,"from langgraph.graph.state import StateGraph"],["asyncio",24,"import asyncio"],["agentdeck.authoring.injection",40,"from agentdeck.authoring.injection import CallableAnalysis"],["langgraph",29,"from langgraph.utils.runnable import RunnableCallable"],["typing",27,"from typing import TYPE_CHECKING, Any"],["__future__",22,"from __future__ import annotations"],["collections",36,"from collections.abc import Callable"],["agentdeck.authoring.injection",31,"from agentdeck.authoring.injection import analyze_callable, check_context_type, describe_callable"],["dataclasses",25,"import dataclasses"],["agentdeck.core.context",32,"from agentdeck.core.context import Context, RunContext"],["agentdeck.errors",33,"from agentdeck.errors import ConfigError"]],"agentdeck.authoring":[["agentdeck.authoring.timers",10,"from agentdeck.authoring.timers import sleep_until"],["agentdeck.authoring.interrupts",8,"from agentdeck.authoring.interrupts import InterruptResult"],["agentdeck.authoring.agent",7,"from agentdeck.authoring.agent import Agent, AgentDeclaration"],["agentdeck.authoring.nodes",9,"from agentdeck.authoring.nodes import AgentNode, LoadFileNode"],["agentdeck.authoring.workflow",11,"from agentdeck.authoring.workflow import Workflow, WorkflowDeclaration"]],"agentdeck.mcp":[["typing",14,"from typing import Any"],["__future__",10,"from __future__ import annotations"],["pydantic",16,"from pydantic import BaseModel, ConfigDict, Field"],["json",12,"import json"],["pathlib",13,"from pathlib import Path"],["agentdeck.errors",18,"from agentdeck.errors import ConfigError"]],"agentdeck.adapters.engines.stub.engine":[["agentdeck.core.context",28,"from agentdeck.core.context import RunContext"],["collections",15,"from collections.abc import Sequence"],["agentdeck.core.content",27,"from agentdeck.core.content import Input"],["agentdeck.core.events",19,"from agentdeck.core.events import RunInterrupted"],["agentdeck.core.events",29,"from agentdeck.core.events import Event, KnownPayload"],["agentdeck.errors",22,"from agentdeck.errors import ConfigError"],["agentdeck.core.control",18,"from agentdeck.core.control import ControlSignalled"],["__future__",13,"from __future__ import annotations"],["typing",16,"from typing import TYPE_CHECKING, Any, ClassVar"],["agentdeck.core.invocable",20,"from agentdeck.core.invocable import InvocableKind, InvocableSpec"],["agentdeck.core.ports",21,"from agentdeck.core.ports import EnginePort"],["collections",25,"from collections.abc import AsyncGenerator"]],"agentdeck.adapters.stores.redis.store":[["__future__",29,"from __future__ import annotations"],["agentdeck.core.events",51,"from agentdeck.core.events import KnownPayload, RunResumed, RunStarted"],["datetime",46,"from datetime import timedelta"],["agentdeck.errors",42,"from agentdeck.errors import DuplicateKeyError, StoreError"],["agentdeck.core.ports",40,"from agentdeck.core.ports import EventStorePort, RunSummary, SessionClaim"],["agentdeck.core.events",39,"from agentdeck.core.events import Event"],["datetime",32,"from datetime import UTC, datetime"],["redis",37,"from redis.exceptions import RedisError, WatchError"],["collections",45,"from collections.abc import Awaitable, Callable, Iterable, Sequence"],["redis",36,"from redis.asyncio import Redis"],["urllib",34,"from urllib.parse import quote, unquote"],["json",31,"import json"],["agentdeck.core.status",52,"from agentdeck.core.status import RunStatus"],["agentdeck.core.context",50,"from agentdeck.core.context import RunContext"],["redis",48,"from redis.asyncio.client import Pipeline"],["agentdeck.core.status",41,"from agentdeck.core.status import LIFECYCLE_KINDS, STATES, can_resume, status_of"],["typing",33,"from typing import TYPE_CHECKING, cast"]],"agentdeck.skills":[["agentdeck.skills.bundle",16,"from agentdeck.skills.bundle import SKILL_MD_FILENAME, SkillBundle"],["typing",13,"from typing import TYPE_CHECKING"],["agentdeck.errors",15,"from agentdeck.errors import DOCS_URL, ConfigError, NotFoundError"],["pathlib",12,"from pathlib import Path"],["__future__",10,"from __future__ import annotations"],["collections",19,"from collections.abc import Sequence"]],"agentdeck.adapters.tools.mcp":[["agentdeck.adapters.tools.mcp.lifecycle",5,"from agentdeck.adapters.tools.mcp.lifecycle import MCPLifecycle"],["agentdeck.adapters.tools.mcp.wiring",8,"from agentdeck.adapters.tools.mcp.wiring import mcp_status_banner, resolve_agent_mcp_servers, resolve_agent_mcp_status"],["__future__",3,"from __future__ import annotations"],["agentdeck.adapters.tools.mcp.source",6,"from agentdeck.adapters.tools.mcp.source import MCP_SERVER_NAMES_KEY, MCPToolSource"],["agentdeck.adapters.tools.mcp.transport",7,"from agentdeck.adapters.tools.mcp.transport import MCPServerStreamableHttpResilient"]],"agentdeck.runtime.dispatch":[["time",25,"import time"],["agentdeck.core.events",31,"from agentdeck.core.events import Event"],["logging",24,"import logging"],["asyncio",23,"import asyncio"],["typing",26,"from typing import TYPE_CHECKING"],["collections",29,"from collections.abc import Callable"],["__future__",21,"from __future__ import annotations"],["agentdeck.core.ports",32,"from agentdeck.core.ports import EventSinkPort"]],"agentdeck.authoring.interrupts":[["__future__",10,"from __future__ import annotations"],["typing",12,"from typing import Any, Literal, NotRequired, TypedDict"]],"agentdeck.authoring.runners.agent":[["__future__",15,"from __future__ import annotations"],["httpx",21,"import httpx"],["openai",23,"from openai import AsyncOpenAI"],["typing",19,"from typing import TYPE_CHECKING, Any, Self, cast"],["agentdeck.runtime.settings",26,"from agentdeck.runtime.settings import Settings, default_use_responses, get_settings"],["collections",29,"from collections.abc import AsyncGenerator, AsyncIterator"],["contextlib",17,"from contextlib import aclosing"],["agentdeck.adapters.engines.openai_agents.runconfig",25,"from agentdeck.adapters.engines.openai_agents.runconfig import build_handoff_ends_on_user_turn_mapper, tracing_enabled"],["dataclasses",18,"from dataclasses import dataclass, field"],["agents",22,"from agents import Agent, ModelSettings, OpenAIProvider, RunConfig, Runner, RunResult"]],"agentdeck.adapters.control.sqlite":[["agentdeck.adapters.control.sqlite.port",3,"from agentdeck.adapters.control.sqlite.port import SqliteControlPort"]],"agentdeck.deck":[["logging",40,"import logging"],["agentdeck.authoring.injection",53,"from agentdeck.authoring.injection import declared_context_type"],["__future__",36,"from __future__ import annotations"],["pathlib",44,"from pathlib import Path"],["uuid",41,"import uuid"],["types",45,"from types import MappingProxyType"],["agentdeck.authoring.interrupts",94,"from agentdeck.authoring.interrupts import InterruptResult"],["agentdeck.adapters.engines.langgraph",48,"from agentdeck.adapters.engines.langgraph import LangGraphEngine"],["agentdeck.core.events",96,"from agentdeck.core.events import Event, Usage"],["functools",39,"import functools"],["agentdeck.authoring.timers",56,"from agentdeck.authoring.timers import WAKE_AT_KEY, wake_at_of"],["agentdeck.core.content",66,"from agentdeck.core.content import DataBlock, TextBlock, coerce_input"],["asyncio",38,"import asyncio"],["agentdeck.skills",85,"from agentdeck.skills import Skills"],["agentdeck.runtime.service",99,"from agentdeck.runtime.service import PendingRun, Runtime"],["collections",89,"from collections.abc import AsyncGenerator, AsyncIterator, Generator, Mapping, Sequence"],["agentdeck.core.control",68,"from agentdeck.core.control import Signal"],["agentdeck.authoring.compile",52,"from agentdeck.authoring.compile import refresh_mcp_status"],["agentdeck.core.ports",98,"from agentdeck.core.ports import EnginePort, EventStorePort"],["agentdeck.composition",58,"from agentdeck.composition import ("],["agentdeck.core.content",95,"from agentdeck.core.content import Input"],["typing",46,"from typing import TYPE_CHECKING, Any, Literal"],["agentdeck.runtime.registry",83,"from agentdeck.runtime.registry import PROJECT_DIR, PluginRegistry, mount_project_dir"],["agents",92,"from agents.tool import FunctionTool"],["contextlib",42,"from contextlib import aclosing, suppress"],["datetime",43,"from datetime import UTC, datetime"],["agentdeck.authoring.skills",55,"from agentdeck.authoring.skills import skills_resolver"],["agentdeck.adapters.tools.mcp.lifecycle",50,"from agentdeck.adapters.tools.mcp.lifecycle import MCPLifecycle"],["agentdeck.authoring.workflow",57,"from agentdeck.authoring.workflow import Workflow"],["agentdeck.core.invocable",97,"from agentdeck.core.invocable import InvocableSpec"],["agentdeck.authoring.interrupts",54,"from agentdeck.authoring.interrupts import interrupt_result"],["agentdeck.runtime.discovery",82,"from agentdeck.runtime.discovery import InvocableRegistry"],["agentdeck.serve",1107,"from agentdeck.serve import build_asgi_app"],["agentdeck.core.ports",78,"from agentdeck.core.ports import EventSinkPort"],["agentdeck.runtime.settings",84,"from agentdeck.runtime.settings import Settings, get_settings"],["builtins",88,"import builtins"],["agentdeck.core.status",79,"from agentdeck.core.status import PRECONDITIONS, SUSPENDED_KINDS, Operation, RunStatus, Verdict"],["agentdeck.core.events",69,"from agentdeck.core.events import ("],["agents",91,"from agents.memory.session import Session"],["agentdeck.core.context",67,"from agentdeck.core.context import RunContext"],["agentdeck.adapters.engines.openai_agents",49,"from agentdeck.adapters.engines.openai_agents import ExecutionStore, OpenAIAgentsEngine, SessionFactory"],["agentdeck.authoring.agent",51,"from agentdeck.authoring.agent import Agent"],["agentdeck.errors",80,"from agentdeck.errors import AgentdeckError, ConfigError, NotFoundError, RunStateError, RunSuspendedError"],["agentdeck.mcp",81,"from agentdeck.mcp import MCP"]],"agentdeck.adapters.stores":[],"agentdeck.adapters.engines.stub":[["agentdeck.adapters.engines.stub.engine",3,"from agentdeck.adapters.engines.stub.engine import Step, StubEngine, stub_spec"]],"agentdeck.core.ports.control":[["abc",16,"from abc import ABC, abstractmethod"],["agentdeck.core.control",20,"from agentdeck.core.control import ControlSignal, Signal"],["__future__",14,"from __future__ import annotations"],["typing",17,"from typing import TYPE_CHECKING"]],"agentdeck.authoring.tools":[["agentdeck.errors",30,"from agentdeck.errors import ConfigError"],["collections",33,"from collections.abc import Callable"],["agents",26,"from agents import RunContextWrapper, default_tool_error_function, function_tool"],["__future__",20,"from __future__ import annotations"],["agentdeck.core.context",29,"from agentdeck.core.context import Context, RunContext"],["asyncio",22,"import asyncio"],["agentdeck.authoring.injection",37,"from agentdeck.authoring.injection import CallableAnalysis"],["typing",24,"from typing import TYPE_CHECKING, Any"],["inspect",23,"import inspect"],["agentdeck.authoring.injection",28,"from agentdeck.authoring.injection import analyze_callable, check_context_type, describe_callable"],["agents",35,"from agents.tool import FunctionTool"]],"agentdeck.core.ports.store":[["dataclasses",10,"from dataclasses import dataclass"],["abc",9,"from abc import ABC, abstractmethod"],["collections",16,"from collections.abc import Sequence"],["__future__",7,"from __future__ import annotations"],["agentdeck.core.context",19,"from agentdeck.core.context import RunContext"],["agentdeck.core.status",13,"from agentdeck.core.status import RunStatus, status_of"],["typing",11,"from typing import TYPE_CHECKING"],["datetime",17,"from datetime import timedelta"],["agentdeck.core.events",20,"from agentdeck.core.events import Event, KnownPayload, RunResumed, RunStarted"]],"agentdeck.composition":[["agentdeck.adapters.control.memory",21,"from agentdeck.adapters.control.memory import MemoryControlPort"],["datetime",42,"from datetime import timedelta"],["typing",19,"from typing import TYPE_CHECKING"],["agentdeck.adapters.stores.redis",240,"from agentdeck.adapters.stores.redis import RedisEventStore"],["agentdeck.adapters.stores.memory",26,"from agentdeck.adapters.stores.memory import MemoryEventStore"],["__future__",16,"from __future__ import annotations"],["agentdeck.errors",28,"from agentdeck.errors import DOCS_URL"],["agentdeck.runtime.settings",31,"from agentdeck.runtime.settings import ("],["agentdeck.adapters.control.sqlite",22,"from agentdeck.adapters.control.sqlite import SqliteControlPort"],["agentdeck.adapters.leases.sqlite",25,"from agentdeck.adapters.leases.sqlite import SqliteLeasePort"],["agentdeck.runtime.discovery",29,"from agentdeck.runtime.discovery import InvocableRegistry"],["agentdeck.adapters.stores.postgres",249,"from agentdeck.adapters.stores.postgres import PostgresEventStore"],["agentdeck.adapters.stores.sqlite",27,"from agentdeck.adapters.stores.sqlite import SqliteEventStore"],["agentdeck.core.invocable",44,"from agentdeck.core.invocable import InvocableSpec"],["agentdeck.core.ports",45,"from agentdeck.core.ports import ControlPort, EnginePort, EventSinkPort, EventStorePort, LeasePort"],["agentdeck.adapters.engines.openai_agents.runconfig",23,"from agentdeck.adapters.engines.openai_agents.runconfig import RunSettings"],["logging",18,"import logging"],["agentdeck.observers",112,"from agentdeck.observers import Langfuse"],["agentdeck.adapters.leases.memory",24,"from agentdeck.adapters.leases.memory import MemoryLeasePort"],["agentdeck.runtime.service",30,"from agentdeck.runtime.service import Runtime"],["collections",41,"from collections.abc import Mapping, Sequence"]],"agentdeck.authoring.web_search":[["__future__",10,"from __future__ import annotations"],["agents",13,"from agents import function_tool"],["httpx",12,"import httpx"],["agentdeck.runtime.settings",15,"from agentdeck.runtime.settings import get_settings"]],"agentdeck.adapters.tools.mcp.transport":[["typing",14,"from typing import TYPE_CHECKING, Any, TypeVar"],["logging",12,"import logging"],["agents",17,"from agents.mcp import MCPServerStreamableHttp"],["contextlib",13,"from contextlib import AsyncExitStack, suppress"],["__future__",9,"from __future__ import annotations"],["asyncio",11,"import asyncio"],["httpx",16,"import httpx"],["collections",20,"from collections.abc import Awaitable, Callable"]],"agentdeck.runtime.discovery":[["agentdeck.errors",19,"from agentdeck.errors import ConfigError"],["typing",12,"from typing import TYPE_CHECKING, Any, Final"],["agentdeck.authoring.agent",14,"from agentdeck.authoring.agent import Agent"],["agentdeck.core.invocable",18,"from agentdeck.core.invocable import InvocableKind, InvocableSpec"],["agents",25,"from agents import Agent as SDKAgent"],["__future__",10,"from __future__ import annotations"],["collections",23,"from collections.abc import Callable, Mapping, Sequence"],["agents",26,"from agents.tool import FunctionTool"],["agentdeck.core.ports",28,"from agentdeck.core.ports import EnginePort"],["agentdeck.authoring.workflow",17,"from agentdeck.authoring.workflow import Workflow"],["agentdeck.authoring.graphs",16,"from agentdeck.authoring.graphs import bridge_context_nodes"],["agentdeck.authoring.compile",15,"from agentdeck.authoring.compile import compile_agent, link_handoffs"],["agentdeck.runtime.registry",20,"from agentdeck.runtime.registry import PluginRegistry, mount_project_dir"]],"agentdeck.adapters.leases.memory.port":[["__future__",10,"from __future__ import annotations"],["typing",13,"from typing import TYPE_CHECKING"],["datetime",12,"from datetime import UTC, datetime"],["agentdeck.core.ports.lease",15,"from agentdeck.core.ports.lease import LeasePort"],["datetime",19,"from datetime import timedelta"],["collections",18,"from collections.abc import Callable, Collection"]],"agentdeck.authoring.runners.workflow":[["__future__",13,"from __future__ import annotations"],["dataclasses",15,"from dataclasses import dataclass, field"],["agentdeck.authoring.compile",21,"from agentdeck.authoring.compile import compile_workflow"],["typing",16,"from typing import TYPE_CHECKING, Any, Self, cast"],["agentdeck.authoring.workflow",29,"from agentdeck.authoring.workflow import Workflow"],["agentdeck.authoring.state",22,"from agentdeck.authoring.state import coerce_input"],["agentdeck.adapters.engines.langgraph.engine",20,"from agentdeck.adapters.engines.langgraph.engine import STREAM_CONFIGURABLE_KEY"],["langchain_core",18,"from langchain_core.runnables import RunnableConfig"],["collections",25,"from collections.abc import AsyncIterator"],["langgraph",27,"from langgraph.graph.state import CompiledStateGraph"]],"agentdeck.adapters.control.memory":[["agentdeck.adapters.control.memory.port",3,"from agentdeck.adapters.control.memory.port import MemoryControlPort"]],"agentdeck.authoring.skills":[["agentdeck.skills",20,"from agentdeck.skills import Skills"],["agents",13,"from agents import function_tool"],["agents",18,"from agents.tool import FunctionTool"],["collections",16,"from collections.abc import Callable, Sequence"],["typing",11,"from typing import TYPE_CHECKING"],["__future__",9,"from __future__ import annotations"]],"agentdeck.authoring.agent":[["agents",18,"from agents.lifecycle import AgentHooks"],["collections",15,"from collections.abc import Callable, Mapping, Sequence"],["agentdeck.authoring.compile",152,"from agentdeck.authoring.compile import compile_agent"],["agentdeck.authoring.runners.agent",158,"from agentdeck.authoring.runners.agent import HeadlessRunner"],["__future__",10,"from __future__ import annotations"],["typing",12,"from typing import TYPE_CHECKING, Any, ClassVar"],["agents",17,"from agents.agent_output import AgentOutputSchemaBase"]],"agentdeck.adapters.telemetry.langfuse.sink":[["agentdeck.core.events",53,"from agentdeck.core.events import Event, Usage"],["logging",25,"import logging"],["json",24,"import json"],["typing",28,"from typing import TYPE_CHECKING, Any"],["agentdeck.adapters.telemetry.langfuse.trace",51,"from agentdeck.adapters.telemetry.langfuse.trace import Level, Observation, ObservationKind, Tracer"],["agentdeck.core.ports",46,"from agentdeck.core.ports import EventSinkPort"],["agentdeck.core.events",31,"from agentdeck.core.events import ("],["agentdeck.core.content",52,"from agentdeck.core.content import Input"],["collections",49,"from collections.abc import Mapping"],["__future__",21,"from __future__ import annotations"],["asyncio",23,"import asyncio"],["agentdeck.core.content",30,"from agentdeck.core.content import DataBlock, ImageBlock, ResourceBlock, TextBlock"],["re",26,"import re"],["dataclasses",27,"from dataclasses import dataclass, field"]],"agentdeck.core.reporting":[["agentdeck.core.events",22,"from agentdeck.core.events import KnownPayload"],["__future__",12,"from __future__ import annotations"],["logging",14,"import logging"],["agentdeck.core.events",17,"from agentdeck.core.events import ProgressReported, StatusReported"],["typing",15,"from typing import TYPE_CHECKING"],["collections",20,"from collections import deque"]],"agentdeck.adapters.stores.memory.store":[["agentdeck.core.events",9,"from agentdeck.core.events import Event"],["agentdeck.core.events",19,"from agentdeck.core.events import KnownPayload, RunResumed, RunStarted"],["agentdeck.errors",12,"from agentdeck.errors import DuplicateKeyError, StoreError"],["datetime",6,"from datetime import UTC, datetime"],["agentdeck.core.status",11,"from agentdeck.core.status import LIFECYCLE_KINDS, STATES, RunStatus, can_resume, status_of"],["__future__",3,"from __future__ import annotations"],["collections",15,"from collections.abc import Callable, Sequence"],["typing",7,"from typing import TYPE_CHECKING"],["asyncio",5,"import asyncio"],["agentdeck.core.ports",10,"from agentdeck.core.ports import EventStorePort, RunSummary, SessionClaim"],["datetime",16,"from datetime import timedelta"],["agentdeck.core.context",18,"from agentdeck.core.context import RunContext"]],"agentdeck.authoring.hooks":[["inspect",21,"import inspect"],["typing",22,"from typing import TYPE_CHECKING, Any"],["agentdeck.core.context",27,"from agentdeck.core.context import Context, RunContext"],["agentdeck.errors",28,"from agentdeck.errors import ConfigError"],["__future__",19,"from __future__ import annotations"],["agents",24,"from agents.lifecycle import AgentHooks"],["collections",31,"from collections.abc import Callable"],["agentdeck.authoring.injection",26,"from agentdeck.authoring.injection import analyze_callable, check_context_type, describe_callable"]],"agentdeck.cli":[["agentdeck.adapters.control.sqlite",22,"from agentdeck.adapters.control.sqlite import SqliteControlPort"],["agentdeck.core.control",23,"from agentdeck.core.control import Signal"],["__future__",17,"from __future__ import annotations"],["argparse",19,"import argparse"],["asyncio",20,"import asyncio"]],"agentdeck":[["agentdeck.authoring",13,"from agentdeck.authoring import Agent, Workflow"],["importlib",10,"from importlib.metadata import PackageNotFoundError"],["importlib",11,"from importlib.metadata import version as _version"],["agentdeck.deck",15,"from agentdeck.deck import Deck, Run, TurnResult"],["agentdeck.errors",16,"from agentdeck.errors import ("],["agentdeck.core.context",14,"from agentdeck.core.context import Context"]],"agentdeck.core.invocable":[["enum",9,"from enum import StrEnum"],["agentdeck.core.base",14,"from agentdeck.core.base import CoreModel"],["typing",10,"from typing import Any"],["pydantic",12,"from pydantic import ConfigDict, Field"],["__future__",7,"from __future__ import annotations"]],"agentdeck.core.control":[["time",15,"import time"],["collections",24,"from collections.abc import Callable, Mapping"],["__future__",13,"from __future__ import annotations"],["enum",17,"from enum import StrEnum"],["agentdeck.core.status",21,"from agentdeck.core.status import Action, RunStatus, decide"],["agentdeck.core.events",26,"from agentdeck.core.events import ControlVerb, KnownPayload, SafePoint"],["agentdeck.core.ports.control",27,"from agentdeck.core.ports.control import ControlPort"],["typing",18,"from typing import TYPE_CHECKING, ClassVar"],["agentdeck.core.events",20,"from agentdeck.core.events import ControlObserved, ControlRequested, RunCancelled, RunPaused"],["dataclasses",16,"from dataclasses import dataclass"]],"agentdeck.serve":[["fastapi",108,"from fastapi.responses import JSONResponse, StreamingResponse"],["logging",55,"import logging"],["agentdeck.deck",83,"from agentdeck.deck import Deck"],["agentdeck.core.status",61,"from agentdeck.core.status import status_of"],["collections",72,"from collections.abc import AsyncGenerator, AsyncIterator, Awaitable, Callable"],["fastapi",74,"from fastapi import FastAPI"],["agentdeck.errors",62,"from agentdeck.errors import AgentdeckError, NotFoundError, RunStateError, SessionBusyError"],["os",56,"import os"],["__future__",52,"from __future__ import annotations"],["fastapi",107,"from fastapi import FastAPI, HTTPException, Request"],["agentdeck.deck",77,"from agentdeck.deck import Deck"],["contextlib",57,"from contextlib import aclosing, asynccontextmanager"],["agentdeck.core.content",60,"from agentdeck.core.content import coerce_input"],["typing",58,"from typing import TYPE_CHECKING, Any"],["uvicorn",354,"import uvicorn"],["agentdeck.surfaces.serve.compat",63,"from agentdeck.surfaces.serve.compat import ("],["argparse",54,"import argparse"],["agentdeck.core.events",76,"from agentdeck.core.events import Event"]],"agentdeck.adapters.engines.openai_agents.runconfig":[["dataclasses",22,"from dataclasses import dataclass"],["typing",23,"from typing import TYPE_CHECKING, Any, cast"],["httpx",25,"import httpx"],["agents",26,"from agents import ModelSettings, MultiProvider, OpenAIProvider, RunConfig, default_handoff_history_mapper"],["os",21,"import os"],["agents",30,"from agents.handoffs import HandoffHistoryMapper"],["agents",31,"from agents.items import TResponseInputItem"],["openai",27,"from openai import AsyncOpenAI"],["__future__",19,"from __future__ import annotations"]],"agentdeck.observers":[["typing",15,"from typing import TYPE_CHECKING"],["__future__",13,"from __future__ import annotations"],["agentdeck.core.ports",17,"from agentdeck.core.ports import EventSinkPort"],["agents",36,"from agents import set_trace_processors"],["agentdeck.core.events",22,"from agentdeck.core.events import Event"],["openinference",37,"from openinference.instrumentation.openai_agents import (  # ty: ignore[unresolved-import]  -  [observability] extra"],["agentdeck.errors",18,"from agentdeck.errors import ConfigError"],["agentdeck.runtime.settings",19,"from agentdeck.runtime.settings import get_settings"],["agentdeck.adapters.telemetry.langfuse.client",85,"from agentdeck.adapters.telemetry.langfuse.client import langfuse_sink"]],"agentdeck.adapters.engines.langgraph":[["agentdeck.adapters.engines.langgraph.checkpointer",5,"from agentdeck.adapters.engines.langgraph.checkpointer import resolve_checkpointer"],["__future__",3,"from __future__ import annotations"],["agentdeck.adapters.engines.langgraph.engine",6,"from agentdeck.adapters.engines.langgraph.engine import DURABLE_KEY, REPORTER_KEY, LangGraphEngine"]],"agentdeck.adapters.telemetry":[],"agentdeck.errors":[["__future__",12,"from __future__ import annotations"],["typing",14,"from typing import Any"],["agentdeck.core.status",16,"from agentdeck.core.status import RunStatus"]],"agentdeck.surfaces.serve.workflows":[["agentdeck.runtime.service",21,"from agentdeck.runtime.service import Runtime"],["collections",19,"from collections.abc import AsyncIterator"],["typing",12,"from typing import TYPE_CHECKING, Any"],["fastapi",14,"from fastapi import FastAPI"],["fastapi",15,"from fastapi.responses import StreamingResponse"],["__future__",10,"from __future__ import annotations"],["pydantic",16,"from pydantic import BaseModel"]],"agentdeck.adapters.leases.sqlite":[["agentdeck.adapters.leases.sqlite.port",3,"from agentdeck.adapters.leases.sqlite.port import SqliteLeasePort"]],"agentdeck.adapters.engines.openai_agents.translate":[["logging",15,"import logging"],["__future__",11,"from __future__ import annotations"],["json",14,"import json"],["hashlib",13,"import hashlib"],["agentdeck.core.events",18,"from agentdeck.core.events import ("],["typing",16,"from typing import Any"]],"agentdeck.surfaces.serve.app":[["fastapi",12,"from fastapi.responses import JSONResponse, StreamingResponse"],["http",8,"from http import HTTPStatus"],["agentdeck.core.events",21,"from agentdeck.core.events import Event"],["pydantic",13,"from pydantic import BaseModel, Field"],["agentdeck.errors",16,"from agentdeck.errors import SessionBusyError"],["__future__",6,"from __future__ import annotations"],["agentdeck.core.content",15,"from agentdeck.core.content import coerce_input"],["fastapi",11,"from fastapi import FastAPI"],["agentdeck.runtime.service",22,"from agentdeck.runtime.service import Runtime"],["collections",19,"from collections.abc import AsyncIterator"],["typing",9,"from typing import TYPE_CHECKING, Any"]],"agentdeck.adapters.engines.langgraph.engine":[["collections",39,"from collections.abc import Mapping"],["pydantic",46,"from pydantic import BaseModel"],["contextlib",58,"from contextlib import AbstractAsyncContextManager"],["agentdeck.errors",54,"from agentdeck.errors import DOCS_URL, ConfigError"],["agentdeck.core.context",66,"from agentdeck.core.context import RunContext"],["agentdeck.core.ports",52,"from agentdeck.core.ports import EnginePort"],["agentdeck.core.content",49,"from agentdeck.core.content import DataBlock, TextBlock"],["contextlib",40,"from contextlib import aclosing, nullcontext"],["langgraph",62,"from langgraph.graph.state import CompiledStateGraph"],["agentdeck.core.events",67,"from agentdeck.core.events import Event, KnownPayload"],["agentdeck.core.control",50,"from agentdeck.core.control import ControlSignalled"],["agentdeck.core.invocable",68,"from agentdeck.core.invocable import InvocableSpec"],["langgraph",63,"from langgraph.types import StreamMode"],["langgraph",43,"from langgraph.checkpoint.memory import MemorySaver"],["typing",41,"from typing import TYPE_CHECKING, Any, ClassVar, cast"],["json",38,"import json"],["agentdeck.core.content",65,"from agentdeck.core.content import Input"],["agentdeck.core.events",51,"from agentdeck.core.events import Custom, NodeUpdated, RunCompleted, RunInterrupted, Usage"],["langgraph",45,"from langgraph.types import Command"],["agentdeck.core.status",53,"from agentdeck.core.status import LIFECYCLE_KINDS"],["__future__",35,"from __future__ import annotations"],["langgraph",61,"from langgraph.checkpoint.base import BaseCheckpointSaver"],["agentdeck.adapters.engines.langgraph.checkpointer",48,"from agentdeck.adapters.engines.langgraph.checkpointer import resolve_checkpointer"],["langchain_core",60,"from langchain_core.runnables import RunnableConfig"],["langgraph",44,"from langgraph.graph.state import StateGraph"],["collections",57,"from collections.abc import AsyncGenerator, AsyncIterator, Callable, Sequence"],["dataclasses",37,"import dataclasses"]],"agentdeck.adapters.engines.openai_agents.sessions":[["agents",26,"from agents.memory.session import Session"],["agentdeck.runtime.settings",30,"from agentdeck.runtime.settings import SessionSettings"],["__future__",19,"from __future__ import annotations"],["agents",68,"from agents.extensions.memory import RedisSession"],["redis",27,"from redis.asyncio import Redis"],["redis",53,"from redis.asyncio import Redis"],["agents",23,"from agents import SQLiteSession"],["agentdeck.core.context",29,"from agentdeck.core.context import RunContext"],["typing",21,"from typing import TYPE_CHECKING"]],"agentdeck.adapters.stores.memory":[["agentdeck.adapters.stores.memory.store",3,"from agentdeck.adapters.stores.memory.store import MemoryEventStore"]],"agentdeck.adapters.tools.mcp.lifecycle":[["asyncio",19,"import asyncio"],["collections",27,"from collections.abc import Sequence"],["agents",29,"from agents.mcp import MCPServer"],["agentdeck.adapters.tools.mcp.transport",23,"from agentdeck.adapters.tools.mcp.transport import MCPServerStreamableHttpResilient"],["typing",21,"from typing import TYPE_CHECKING, Any"],["logging",20,"import logging"],["agentdeck.errors",24,"from agentdeck.errors import ConfigError"],["__future__",17,"from __future__ import annotations"]],"agentdeck.runtime.capture":[["enum",14,"from enum import StrEnum"],["__future__",12,"from __future__ import annotations"],["pydantic",16,"from pydantic import BaseModel"]],"agentdeck.authoring.nodes":[["agentdeck.adapters.engines.langgraph.engine",19,"from agentdeck.adapters.engines.langgraph.engine import STREAM_CONFIGURABLE_KEY"],["collections",13,"from collections.abc import Callable, Mapping"],["logging",12,"import logging"],["__future__",10,"from __future__ import annotations"],["typing",15,"from typing import Any"],["pathlib",14,"from pathlib import Path"],["agentdeck.authoring.runners.agent",22,"from agentdeck.authoring.runners.agent import HeadlessRunner, StreamDone"],["agentdeck.authoring.compile",21,"from agentdeck.authoring.compile import compile_agent"],["langgraph",17,"from langgraph.config import get_config, get_stream_writer"],["agentdeck.authoring.agent",20,"from agentdeck.authoring.agent import Agent"]],"agentdeck.testing":[["__future__",14,"from __future__ import annotations"],["threading",18,"import threading"],["agents",26,"from agents.usage import Usage"],["unittest",22,"from unittest.mock import patch"],["agents",25,"from agents.models.interface import Model"],["openai",36,"from openai.types.responses.response_usage import InputTokensDetails, OutputTokensDetails"],["asyncio",16,"import asyncio"],["typing",21,"from typing import TYPE_CHECKING, Any"],["collections",39,"from collections.abc import AsyncIterator, Callable, Iterator, Sequence"],["json",17,"import json"],["contextlib",19,"from contextlib import contextmanager"],["http",20,"from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer"],["openai",27,"from openai.types.responses import ("],["agents",24,"from agents.items import ModelResponse"]],"agentdeck.adapters.engines.openai_agents.engine":[["agentdeck.core.ports",53,"from agentdeck.core.ports import EnginePort"],["agents",59,"from agents.items import TResponseInputItem"],["agentdeck.core.invocable",67,"from agentdeck.core.invocable import InvocableSpec"],["agentdeck.errors",54,"from agentdeck.errors import ConfigError"],["contextlib",39,"from contextlib import AbstractAsyncContextManager, aclosing, asynccontextmanager, nullcontext"],["agents",61,"from agents.result import RunResultStreaming"],["agents",43,"from agents import Agent, Runner"],["collections",57,"from collections.abc import AsyncGenerator, AsyncIterator, Sequence"],["dataclasses",36,"import dataclasses"],["agentdeck.core.events",52,"from agentdeck.core.events import RunCompleted, Usage, UsageReported"],["agents",62,"from agents.usage import Usage as SDKUsage"],["dataclasses",40,"from dataclasses import dataclass"],["collections",38,"from collections.abc import Callable"],["__future__",34,"from __future__ import annotations"],["agents",60,"from agents.memory.session import Session"],["agentdeck.core.events",66,"from agentdeck.core.events import Event, KnownPayload"],["pydantic",44,"from pydantic import BaseModel"],["agentdeck.core.content",64,"from agentdeck.core.content import ContentBlock, Input"],["agentdeck.core.content",50,"from agentdeck.core.content import AudioBlock, DataBlock, ImageBlock, ResourceBlock, TextBlock, coerce_input"],["json",37,"import json"],["agentdeck.core.context",65,"from agentdeck.core.context import RunContext"],["agentdeck.adapters.engines.openai_agents.reconcile",46,"from agentdeck.adapters.engines.openai_agents.reconcile import reconcile, render_data_block"],["agentdeck.adapters.engines.openai_agents.translate",49,"from agentdeck.adapters.engines.openai_agents.translate import translate"],["agentdeck.adapters.engines.openai_agents.sessions",48,"from agentdeck.adapters.engines.openai_agents.sessions import ExecutionStore"],["agentdeck.adapters.engines.openai_agents.runconfig",47,"from agentdeck.adapters.engines.openai_agents.runconfig import RunSettings, build_run_config"],["agentdeck.core.control",51,"from agentdeck.core.control import ControlSignalled"],["typing",41,"from typing import TYPE_CHECKING, Any, ClassVar, cast"]],"agentdeck.runtime":[],"agentdeck.surfaces.cli.chat":[["json",12,"import json"],["collections",32,"from collections.abc import AsyncIterator"],["typing",13,"from typing import TYPE_CHECKING"],["httpx",34,"import httpx"],["agentdeck.core.events",16,"from agentdeck.core.events import ("],["agentdeck.core.content",15,"from agentdeck.core.content import TextBlock"],["__future__",10,"from __future__ import annotations"]],"agentdeck.core.ports.tools":[["agentdeck.core.invocable",22,"from agentdeck.core.invocable import InvocableSpec"],["__future__",12,"from __future__ import annotations"],["typing",15,"from typing import TYPE_CHECKING, Any"],["abc",14,"from abc import ABC, abstractmethod"],["agentdeck.core.base",19,"from agentdeck.core.base import CoreModel"],["pydantic",17,"from pydantic import ConfigDict"]],"agentdeck.authoring.workflow":[["__future__",11,"from __future__ import annotations"],["langgraph",195,"from langgraph.graph import END, START"],["agentdeck.authoring.interrupts",173,"from agentdeck.authoring.interrupts import interrupt_result"],["agentdeck.authoring.compile",172,"from agentdeck.authoring.compile import compile_workflow"],["agentdeck.authoring.compile",103,"from agentdeck.authoring.compile import compile_workflow"],["agentdeck.authoring.runners.workflow",108,"from agentdeck.authoring.runners.workflow import DevWorkflowRunner"],["pydantic",17,"from pydantic import BaseModel"],["agentdeck.authoring.interrupts",27,"from agentdeck.authoring.interrupts import InterruptResult"],["agentdeck.errors",19,"from agentdeck.errors import DOCS_URL, ConfigError"],["langgraph",164,"from langgraph.types import Command"],["agentdeck.authoring.interrupts",140,"from agentdeck.authoring.interrupts import as_interrupt"],["json",13,"import json"],["agents",24,"from agents.tool import FunctionTool"],["re",14,"import re"],["agentdeck.authoring.state",218,"from agentdeck.authoring.state import dump_state"],["collections",22,"from collections.abc import AsyncIterator, Callable, Iterable, Sequence"],["langgraph",25,"from langgraph.graph import StateGraph"],["agentdeck.authoring.interrupts",130,"from agentdeck.authoring.interrupts import INTERRUPT_KEY"],["agents",216,"from agents.tool import FunctionTool"],["typing",15,"from typing import TYPE_CHECKING, Any, ClassVar"]],"agentdeck.adapters.stores.redis":[["agentdeck.adapters.stores.redis.store",3,"from agentdeck.adapters.stores.redis.store import RedisEventStore"]],"agentdeck.surfaces.serve.compat":[["agentdeck.runtime.service",29,"from agentdeck.runtime.service import PendingRun"],["agentdeck.core.events",23,"from agentdeck.core.events import Custom, NodeUpdated, RunCompleted, RunInterrupted, TextDelta, UsageReported"],["contextlib",19,"from contextlib import aclosing"],["agentdeck.core.events",28,"from agentdeck.core.events import Event"],["agentdeck.core.content",22,"from agentdeck.core.content import DataBlock, TextBlock"],["typing",20,"from typing import TYPE_CHECKING, Any"],["json",18,"import json"],["__future__",16,"from __future__ import annotations"],["collections",26,"from collections.abc import AsyncGenerator, AsyncIterator, Sequence"]],"agentdeck.authoring.state":[["json",6,"import json"],["pydantic",11,"from pydantic import BaseModel"],["langgraph",10,"from langgraph.types import Command"],["typing",8,"from typing import Any"],["__future__",3,"from __future__ import annotations"],["dataclasses",5,"import dataclasses"],["collections",7,"from collections.abc import Mapping"]],"agentdeck.adapters.engines":[],"agentdeck.adapters.tools.mcp.wiring":[["typing",10,"from typing import TYPE_CHECKING"],["agentdeck.adapters.tools.mcp.lifecycle",12,"from agentdeck.adapters.tools.mcp.lifecycle import MCPLifecycle"],["__future__",8,"from __future__ import annotations"],["collections",15,"from collections.abc import Iterable, Sequence"],["agents",17,"from agents.mcp import MCPServer"]],"agentdeck.runtime.registry":[["importlib",10,"from importlib.machinery import ModuleSpec"],["dataclasses",9,"from dataclasses import dataclass, field"],["__future__",3,"from __future__ import annotations"],["sys",7,"import sys"],["agentdeck.errors",14,"from agentdeck.errors import ConfigError, NotFoundError"],["types",8,"import types"],["importlib",6,"import importlib.util"],["importlib",5,"import importlib"],["typing",12,"from typing import Generic, TypeVar"],["pathlib",11,"from pathlib import Path"]],"agentdeck.adapters.telemetry.langfuse":[["agentdeck.adapters.telemetry.langfuse.trace",5,"from agentdeck.adapters.telemetry.langfuse.trace import Level, Observation, ObservationKind, Tracer"],["agentdeck.adapters.telemetry.langfuse.client",3,"from agentdeck.adapters.telemetry.langfuse.client import LangfuseTracer, build_client, langfuse_sink"],["agentdeck.adapters.telemetry.langfuse.sink",4,"from agentdeck.adapters.telemetry.langfuse.sink import MAX_OPEN_CALLS, MAX_OPEN_RUNS, LangfuseSink"]],"agentdeck.core.context":[["agentdeck.core.control",23,"from agentdeck.core.control import Gate"],["agentdeck.core.reporting",24,"from agentdeck.core.reporting import Reporter"],["typing",21,"from typing import cast"],["__future__",18,"from __future__ import annotations"],["dataclasses",20,"from dataclasses import dataclass, field"]],"agentdeck.core.status":[["enum",20,"from enum import StrEnum"],["agentdeck.core.events",28,"from agentdeck.core.events import Event"],["__future__",17,"from __future__ import annotations"],["collections",26,"from collections.abc import Mapping, Sequence"],["dataclasses",19,"from dataclasses import dataclass"],["typing",21,"from typing import TYPE_CHECKING"],["agentdeck.core.events",23,"from agentdeck.core.events import TERMINAL_KINDS"]],"agentdeck.authoring.injection":[["agentdeck.errors",35,"from agentdeck.errors import ConfigError, ContextTypeError"],["inspect",29,"import inspect"],["dataclasses",31,"from dataclasses import dataclass"],["__future__",27,"from __future__ import annotations"],["types",30,"import types"],["collections",38,"from collections.abc import Callable, Iterable, Iterator, Mapping"],["agentdeck.core.context",34,"from agentdeck.core.context import Context"],["typing",32,"from typing import TYPE_CHECKING, Any, Union, get_args, get_origin, get_type_hints"]],"agentdeck.surfaces.cli":[["agentdeck.surfaces.cli.chat",5,"from agentdeck.surfaces.cli.chat import render, stream_chat"],["__future__",3,"from __future__ import annotations"]],"agentdeck.adapters.control.memory.port":[["agentdeck.core.ports.control",8,"from agentdeck.core.ports.control import ControlPort"],["__future__",5,"from __future__ import annotations"],["agentdeck.core.control",7,"from agentdeck.core.control import ControlSignal, Signal"]],"agentdeck.adapters.engines.langgraph.checkpointer":[["typing",26,"from typing import TYPE_CHECKING, Any, TypeVar"],["psycopg",191,"import psycopg  # ty: ignore[unresolved-import]  -  [durability] extra"],["asyncio",32,"from asyncio import AbstractEventLoop"],["aiosqlite",152,"import aiosqlite"],["langgraph",153,"from langgraph.checkpoint.sqlite import aio as sqlite_aio"],["asyncio",22,"import asyncio"],["threading",24,"import threading"],["langgraph",139,"from langgraph.checkpoint.memory import MemorySaver"],["agentdeck.errors",29,"from agentdeck.errors import DOCS_URL, StoreError"],["__future__",20,"from __future__ import annotations"],["functools",25,"from functools import cache, partial"],["langgraph",184,"from langgraph.checkpoint.postgres.aio import (  # ty: ignore[unresolved-import]  -  [durability] extra"],["collections",33,"from collections.abc import Callable, Coroutine, MutableMapping"],["weakref",27,"from weakref import WeakKeyDictionary"],["sqlite3",23,"import sqlite3"],["langgraph",35,"from langgraph.checkpoint.base import BaseCheckpointSaver"]],"agentdeck.core.content":[["__future__",11,"from __future__ import annotations"],["base64",13,"import base64"],["typing",14,"from typing import Annotated, Any, Literal, get_args"],["agentdeck.core.base",26,"from agentdeck.core.base import CoreModel, JsonData"],["pydantic",16,"from pydantic import ("]],"agentdeck.runtime.settings":[["collections",21,"from collections.abc import Mapping"],["logging",19,"import logging"],["pathlib",24,"from pathlib import Path"],["importlib",34,"from importlib.resources.abc import Traversable"],["dotenv",27,"from dotenv import load_dotenv"],["pydantic_settings",30,"from pydantic_settings.sources import YamlConfigSettingsSource"],["__future__",17,"from __future__ import annotations"],["os",20,"import os"],["pydantic",28,"from pydantic import BaseModel, ConfigDict, Field, field_validator"],["typing",25,"from typing import TYPE_CHECKING, Any, ClassVar, Self"],["functools",23,"from functools import lru_cache"],["collections",33,"from collections.abc import Callable"],["pydantic_settings",29,"from pydantic_settings import BaseSettings, SettingsConfigDict"],["datetime",22,"from datetime import timedelta"]],"agentdeck.skills.bundle":[["__future__",3,"from __future__ import annotations"],["re",5,"import re"],["pathlib",7,"from pathlib import Path"],["dataclasses",6,"from dataclasses import dataclass, field"],["agentdeck.errors",12,"from agentdeck.errors import ConfigError"],["yaml",10,"import yaml"],["typing",8,"from typing import Any"]],"agentdeck.core.events":[["agentdeck.core.base",38,"from agentdeck.core.base import CoreModel, JsonData"],["pydantic",26,"from pydantic import ("],["__future__",22,"from __future__ import annotations"],["typing",24,"from typing import Annotated, Any, Literal, get_args"],["agentdeck.core.content",39,"from agentdeck.core.content import Input  # noqa: TC001  -  pydantic resolves field annotations at runtime"]],"agentdeck.runtime.service":[["agentdeck.core.ports",62,"from agentdeck.core.ports import ControlPort, EnginePort, EventSinkPort, EventStorePort, LeasePort"],["agentdeck.core.content",26,"from agentdeck.core.content import DataBlock, coerce_input"],["agentdeck.core.events",29,"from agentdeck.core.events import ("],["agentdeck.core.ports.store",63,"from agentdeck.core.ports.store import RunSummary"],["contextlib",18,"from contextlib import aclosing, asynccontextmanager, suppress"],["datetime",20,"from datetime import timedelta"],["agentdeck.core.status",40,"from agentdeck.core.status import ("],["agentdeck.core.control",59,"from agentdeck.core.control import ControlSignal"],["uuid",22,"from uuid import uuid4"],["asyncio",15,"import asyncio"],["typing",56,"from typing import Any"],["agentdeck.core.invocable",61,"from agentdeck.core.invocable import InvocableSpec"],["dataclasses",19,"from dataclasses import dataclass, replace"],["agentdeck.core.content",58,"from agentdeck.core.content import Input"],["pydantic",24,"from pydantic import ValidationError"],["logging",16,"import logging"],["collections",17,"from collections import deque"],["agentdeck.runtime.dispatch",52,"from agentdeck.runtime.dispatch import SinkDispatch"],["__future__",13,"from __future__ import annotations"],["collections",55,"from collections.abc import AsyncGenerator, AsyncIterator, Mapping, Sequence"],["agentdeck.core.events",60,"from agentdeck.core.events import KnownPayload"],["agentdeck.core.reporting",39,"from agentdeck.core.reporting import Reporter"],["agentdeck.core.context",27,"from agentdeck.core.context import RunContext"],["agentdeck.core.control",28,"from agentdeck.core.control import CONTROL_POLL_INTERVAL, Gate, Signal"],["agentdeck.errors",51,"from agentdeck.errors import DOCS_URL, NotFoundError, RunStateError, SessionBusyError, StoreError"],["typing",21,"from typing import TYPE_CHECKING"]],"agentdeck.core.ports.engine":[["abc",9,"from abc import ABC, abstractmethod"],["agentdeck.core.content",15,"from agentdeck.core.content import Input"],["__future__",7,"from __future__ import annotations"],["agentdeck.core.events",17,"from agentdeck.core.events import Event, KnownPayload"],["typing",10,"from typing import TYPE_CHECKING, Any, ClassVar"],["agentdeck.core.invocable",18,"from agentdeck.core.invocable import InvocableSpec"],["collections",13,"from collections.abc import AsyncGenerator, Sequence"],["agentdeck.core.context",16,"from agentdeck.core.context import RunContext"]],"agentdeck.adapters.stores.postgres.store":[["agentdeck.core.events",27,"from agentdeck.core.events import Event"],["agentdeck.core.ports",28,"from agentdeck.core.ports import EventStorePort, RunSummary, SessionClaim"],["agentdeck.core.context",36,"from agentdeck.core.context import RunContext"],["collections",33,"from collections.abc import Awaitable, Callable, Sequence"],["agentdeck.core.status",29,"from agentdeck.core.status import LIFECYCLE_KINDS, STATES, can_resume, status_of"],["typing",21,"from typing import TYPE_CHECKING, Any"],["datetime",34,"from datetime import timedelta"],["psycopg",25,"from psycopg import sql"],["psycopg",24,"from psycopg import errors as pg_errors"],["psycopg",23,"import psycopg"],["asyncio",19,"import asyncio"],["agentdeck.core.status",38,"from agentdeck.core.status import RunStatus"],["__future__",17,"from __future__ import annotations"],["hashlib",20,"import hashlib"],["agentdeck.core.events",37,"from agentdeck.core.events import KnownPayload, RunResumed, RunStarted"],["agentdeck.errors",30,"from agentdeck.errors import DuplicateKeyError, StoreError"]],"agentdeck.adapters.leases.sqlite.port":[["asyncio",16,"import asyncio"],["sqlite3",17,"import sqlite3"],["contextlib",18,"from contextlib import suppress"],["collections",26,"from collections.abc import Callable, Collection"],["__future__",14,"from __future__ import annotations"],["agentdeck.core.ports.lease",22,"from agentdeck.core.ports.lease import LeasePort"],["typing",20,"from typing import TYPE_CHECKING"],["pathlib",28,"from pathlib import Path"],["agentdeck.errors",23,"from agentdeck.errors import StoreError"],["functools",19,"from functools import partial"],["datetime",27,"from datetime import timedelta"]],"agentdeck.surfaces.serve":[["__future__",3,"from __future__ import annotations"],["agentdeck.surfaces.serve.app",5,"from agentdeck.surfaces.serve.app import build_app"]],"agentdeck.core.base":[["typing",10,"from typing import Annotated"],["pydantic",12,"from pydantic import AfterValidator, BaseModel, ConfigDict, JsonValue"],["__future__",7,"from __future__ import annotations"],["math",9,"from math import isfinite"]],"agentdeck.authoring.compile":[["agentdeck.authoring.agent",172,"from agentdeck.authoring.agent import Agent as AuthoringAgent"],["agents",44,"from agents import ModelSettings"],["agentdeck.authoring.workflow",62,"from agentdeck.authoring.workflow import Workflow"],["agents",58,"from agents.tool import FunctionTool"],["agentdeck.authoring.tools",51,"from agentdeck.authoring.tools import compile_tool"],["agentdeck.authoring.instructions",50,"from agentdeck.authoring.instructions import compile_instructions"],["typing",41,"from typing import TYPE_CHECKING, Any, get_args, get_origin"],["collections",56,"from collections.abc import Callable, Mapping, Sequence"],["agents",45,"from agents import Tool as SDKTool"],["agentdeck.authoring.agent",61,"from agentdeck.authoring.agent import Agent"],["agentdeck.runtime.settings",53,"from agentdeck.runtime.settings import get_settings, parse_backend_url"],["agentdeck.errors",52,"from agentdeck.errors import ConfigError, NotFoundError"],["agentdeck.authoring.workflow",118,"from agentdeck.authoring.workflow import Workflow"],["agentdeck.authoring.hooks",49,"from agentdeck.authoring.hooks import compile_hooks"],["agentdeck.adapters.tools.mcp.wiring",48,"from agentdeck.adapters.tools.mcp.wiring import mcp_status_banner, resolve_agent_mcp_status"],["langgraph",59,"from langgraph.graph.state import CompiledStateGraph"],["agents",43,"from agents import Agent as SDKAgent"],["agentdeck.adapters.engines.langgraph.checkpointer",47,"from agentdeck.adapters.engines.langgraph.checkpointer import resolve_checkpointer"],["__future__",39,"from __future__ import annotations"]],"agentdeck.core.ports":[["agentdeck.core.ports.engine",12,"from agentdeck.core.ports.engine import EnginePort"],["agentdeck.core.ports.control",11,"from agentdeck.core.ports.control import ControlPort"],["agentdeck.core.ports.lease",13,"from agentdeck.core.ports.lease import LeasePort"],["agentdeck.core.ports.sink",14,"from agentdeck.core.ports.sink import EventSinkPort"],["agentdeck.core.ports.store",15,"from agentdeck.core.ports.store import EventStorePort, RunSummary, SessionClaim"],["agentdeck.core.ports.tools",16,"from agentdeck.core.ports.tools import ToolSet, ToolSourcePort"]],"agentdeck.adapters.stores.postgres":[["agentdeck.adapters.stores.postgres.store",3,"from agentdeck.adapters.stores.postgres.store import PostgresEventStore"]],"agentdeck.adapters.telemetry.langfuse.client":[["agentdeck.core.events",25,"from agentdeck.core.events import Usage"],["langfuse",102,"from langfuse import propagate_attributes  # ty: ignore[unresolved-import]  -  [observability] extra"],["collections",22,"from collections.abc import Mapping"],["logging",15,"import logging"],["os",16,"import os"],["agentdeck.adapters.telemetry.langfuse.trace",24,"from agentdeck.adapters.telemetry.langfuse.trace import Level, Observation, ObservationKind"],["agentdeck.runtime.settings",26,"from agentdeck.runtime.settings import LangfuseSettings"],["langfuse",60,"from langfuse import Langfuse  # ty: ignore[unresolved-import]  -  [observability] extra"],["agentdeck.adapters.telemetry.langfuse.sink",19,"from agentdeck.adapters.telemetry.langfuse.sink import LangfuseSink"],["typing",17,"from typing import TYPE_CHECKING, Any"],["__future__",13,"from __future__ import annotations"]],"agentdeck.core":[["agentdeck.core.invocable",55,"from agentdeck.core.invocable import InvocableKind, InvocableSpec"],["agentdeck.core.context",20,"from agentdeck.core.context import RunContext"],["agentdeck.core.reporting",56,"from agentdeck.core.reporting import Reporter"],["agentdeck.core.events",21,"from agentdeck.core.events import ("],["agentdeck.core.status",57,"from agentdeck.core.status import RunStatus, can_resume, status_of"],["agentdeck.core.content",7,"from agentdeck.core.content import ("]]}

{agentdeck_sdk-4.0.2 → agentdeck_sdk-4.0.3}/CHANGELOG.md

@@ -8,6 +8,31 @@ Fixed / Security` order  -  and are written to be attached to a release as-is.
 
 ## [Unreleased]
 
+## [4.0.3] - 2026-08-19
+
+### Added
+
+- **Documentation pages that are finished can ask for their next piece.** A `Contribute`
+  component marks one specific, scoped improvement at the end of a page and links the issue that
+  specifies it. It appears only on pages whose authoritative part is already written, so it
+  invites an addition rather than standing in for missing documentation. Live on
+  [How Jack is built](https://agentdecksdk.com/jack),
+  [Quickstart](https://agentdecksdk.com/meet-agentdeck/quickstart),
+  [Known Issues](https://agentdecksdk.com/resources/known-issues) and
+  [Implementation notes](https://agentdecksdk.com/jack/notes).
+
+### Changed
+
+- **The README follows the landing page again.** Jack is built with the three tools he actually
+  has, the division of labour lists the six concerns AgentDeck owns rather than four, and his
+  section links [How Jack is built](https://agentdecksdk.com/jack) and
+  [Implementation notes](https://agentdecksdk.com/jack/notes) ahead of the source directory.
+
+### Fixed
+
+- **The landing page's release chip said 4.0.1 on a 4.0.2 site.** It now tracks the release it
+  ships in.
+
 ## [4.0.2] - 2026-08-19
 
 ### Changed

{agentdeck_sdk-4.0.2 → agentdeck_sdk-4.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentdeck-sdk
-Version: 4.0.2
+Version: 4.0.3
 Summary: Declarative harness over the OpenAI Agents SDK and LangGraph: settings, capabilities, skills, runners, graph compilation, plug-in discovery.
 License-Expression: MIT
 License-File: LICENSE
@@ -109,10 +109,14 @@ def read_doc(slug: str, docs: Context[DocsCorpus]) -> str:
     """Read one AgentDeck documentation page in full, by its slug."""
     return docs.data.pages[slug]
 
+def read_changelog(subject: str, docs: Context[DocsCorpus]) -> str:
+    """Read AgentDeck's release history, by version or by topic."""
+    return docs.data.changelog(subject)
+
 jack = Agent(
     name="Jack",
     instructions="Help developers build with AgentDeck.",
-    tools=[search_docs, read_doc],
+    tools=[search_docs, read_doc, read_changelog],
 )
 
 deck = Deck(agents=[jack], context=DocsCorpus)
@@ -159,13 +163,16 @@ thing either reads.
 The panel on **[agentdecksdk.com](https://agentdecksdk.com/)** is that agent. Ask it something
 about AgentDeck and it searches these docs, reads the pages it finds, and cites them.
 
-Its whole source is [`examples/jack`](examples/jack/): three tools over one
-`Context[DocsCorpus]`, streaming the run's own canonical events to the browser over SSE with no
-translation layer on either side. Not a demo written to look good in a README. It is the thing
-serving the site, including the parts a public endpoint needs and a demo skips: an origin check,
-a per-day quota, a token ceiling, and an allowlist deciding which event kinds a browser may see.
+He is three tools over one `Context[DocsCorpus]`, streaming the run's own canonical events to
+the browser over SSE with no translation layer on either side, and he is the thing serving the
+site: an origin check, a per-day quota, a token ceiling, and an allowlist deciding which event
+kinds a browser may see are all parts a public endpoint needs and a demo skips.
+
+**[How Jack is built](https://agentdecksdk.com/jack)** walks the whole application, and
+**[Implementation notes](https://agentdecksdk.com/jack/notes)** records each decision and the
+alternative it beat. The source is [`examples/jack`](examples/jack/).
 
-It is also the honest test of the pitch. If *"agents you have to operate"* meant anything, it
+He is also the honest test of the pitch. If *"agents you have to operate"* meant anything, it
 had to survive being operated.
 
 ## Where your definitions live
@@ -189,17 +196,26 @@ async with Deck.from_project() as deck:   # discovers ./.agentdeck, fails fast
 unknown MCP name or a workflow that cannot compile fails at `build()`, not in production.
 
 Runnable projects are in [`examples/`](examples/): a chat agent with a tool, a workflow that
-pauses for human approval, an existing LangGraph agent wrapped without rewriting it, and Jack.
-All are built by the test suite, so none can quietly stop working.
+pauses for human approval, an existing LangGraph agent wrapped without rewriting it, and
+[Jack](https://agentdecksdk.com/jack). All are built by the test suite, so none can quietly stop
+working.
 
 ## You build the behavior. AgentDeck manages the machinery.
 
-| You | AgentDeck |
+Your code stays about the behavior and the structure of your application. Everything a run
+needs around it already has a place, and they were designed to work together: less machinery to
+build today, and nothing to retrofit when you need the next one.
+
+| You own | AgentDeck owns |
 | --- | --- |
-| application logic | execution |
-| agents, tools, workflows | sessions, streaming, one event log per run |
-| business state | pause, resume, cancel at documented safe points |
-| integrations | durable human approval that outlives the process |
+| agents, tools, workflows | **Events.** One ordered stream of what happened. |
+| what progress means | **Reporting.** Progress and status, sent from inside the work. |
+| when work should stop | **Control.** Execution paused, resumed or cancelled at safe points. |
+| when a person decides | **Interaction.** Branches that wait for external input. |
+| business state | **State.** Sessions that outlive a single call. |
+| your UI and integrations | **Surfaces.** Observers, HTTP and your UI read the same run. |
+
+The complexity is still there. It just lives in the layer built for it.
 
 **AgentDeck owns configuration; the
 [OpenAI Agents SDK](https://github.com/openai/openai-agents-python) and

{agentdeck_sdk-4.0.2 → agentdeck_sdk-4.0.3}/README.md

@@ -60,10 +60,14 @@ def read_doc(slug: str, docs: Context[DocsCorpus]) -> str:
     """Read one AgentDeck documentation page in full, by its slug."""
     return docs.data.pages[slug]
 
+def read_changelog(subject: str, docs: Context[DocsCorpus]) -> str:
+    """Read AgentDeck's release history, by version or by topic."""
+    return docs.data.changelog(subject)
+
 jack = Agent(
     name="Jack",
     instructions="Help developers build with AgentDeck.",
-    tools=[search_docs, read_doc],
+    tools=[search_docs, read_doc, read_changelog],
 )
 
 deck = Deck(agents=[jack], context=DocsCorpus)
@@ -110,13 +114,16 @@ thing either reads.
 The panel on **[agentdecksdk.com](https://agentdecksdk.com/)** is that agent. Ask it something
 about AgentDeck and it searches these docs, reads the pages it finds, and cites them.
 
-Its whole source is [`examples/jack`](examples/jack/): three tools over one
-`Context[DocsCorpus]`, streaming the run's own canonical events to the browser over SSE with no
-translation layer on either side. Not a demo written to look good in a README. It is the thing
-serving the site, including the parts a public endpoint needs and a demo skips: an origin check,
-a per-day quota, a token ceiling, and an allowlist deciding which event kinds a browser may see.
+He is three tools over one `Context[DocsCorpus]`, streaming the run's own canonical events to
+the browser over SSE with no translation layer on either side, and he is the thing serving the
+site: an origin check, a per-day quota, a token ceiling, and an allowlist deciding which event
+kinds a browser may see are all parts a public endpoint needs and a demo skips.
+
+**[How Jack is built](https://agentdecksdk.com/jack)** walks the whole application, and
+**[Implementation notes](https://agentdecksdk.com/jack/notes)** records each decision and the
+alternative it beat. The source is [`examples/jack`](examples/jack/).
 
-It is also the honest test of the pitch. If *"agents you have to operate"* meant anything, it
+He is also the honest test of the pitch. If *"agents you have to operate"* meant anything, it
 had to survive being operated.
 
 ## Where your definitions live
@@ -140,17 +147,26 @@ async with Deck.from_project() as deck:   # discovers ./.agentdeck, fails fast
 unknown MCP name or a workflow that cannot compile fails at `build()`, not in production.
 
 Runnable projects are in [`examples/`](examples/): a chat agent with a tool, a workflow that
-pauses for human approval, an existing LangGraph agent wrapped without rewriting it, and Jack.
-All are built by the test suite, so none can quietly stop working.
+pauses for human approval, an existing LangGraph agent wrapped without rewriting it, and
+[Jack](https://agentdecksdk.com/jack). All are built by the test suite, so none can quietly stop
+working.
 
 ## You build the behavior. AgentDeck manages the machinery.
 
-| You | AgentDeck |
+Your code stays about the behavior and the structure of your application. Everything a run
+needs around it already has a place, and they were designed to work together: less machinery to
+build today, and nothing to retrofit when you need the next one.
+
+| You own | AgentDeck owns |
 | --- | --- |
-| application logic | execution |
-| agents, tools, workflows | sessions, streaming, one event log per run |
-| business state | pause, resume, cancel at documented safe points |
-| integrations | durable human approval that outlives the process |
+| agents, tools, workflows | **Events.** One ordered stream of what happened. |
+| what progress means | **Reporting.** Progress and status, sent from inside the work. |
+| when work should stop | **Control.** Execution paused, resumed or cancelled at safe points. |
+| when a person decides | **Interaction.** Branches that wait for external input. |
+| business state | **State.** Sessions that outlive a single call. |
+| your UI and integrations | **Surfaces.** Observers, HTTP and your UI read the same run. |
+
+The complexity is still there. It just lives in the layer built for it.
 
 **AgentDeck owns configuration; the
 [OpenAI Agents SDK](https://github.com/openai/openai-agents-python) and