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

agentdeck_sdk-4.0.4/.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.4/.import_linter_cache/agentdeck.meta.json

@@ -0,0 +1 @@
+{"agentdeck.adapters.control.memory": 1787124808.4922376, "agentdeck.authoring.timers": 1787124808.4958086, "agentdeck.skills": 1787124808.4979315, "agentdeck.adapters.tools.mcp.wiring": 1787124808.4949489, "agentdeck.surfaces.serve.workflows": 1787124808.4991884, "agentdeck.serve": 1787124808.4979315, "agentdeck.core.content": 1787124808.4964523, "agentdeck.authoring.tools": 1787124808.4958086, "agentdeck.core.ports.store": 1787124808.496899, "agentdeck.authoring.runners": 1787124808.4952602, "agentdeck.testing": 1787124808.4991884, "agentdeck.adapters.leases.memory": 1787124808.493463, "agentdeck.core.invocable": 1787124808.4964523, "agentdeck.authoring.graphs": 1787124808.4952602, "agentdeck.adapters.control.sqlite": 1787124808.4922931, "agentdeck.authoring.state": 1787124808.4958086, "agentdeck.core.status": 1787124808.496899, "agentdeck.adapters.stores.sqlite": 1787124808.494179, "agentdeck.adapters.stores.sqlite.store": 1787124808.494368, "agentdeck.adapters.engines.langgraph": 1787124808.4925327, "agentdeck.core.ports.tools": 1787124808.496899, "agentdeck.adapters.tools.mcp.source": 1787124808.4949489, "agentdeck.adapters.control": 1787124808.4921763, "agentdeck.errors": 1787124808.496899, "agentdeck.authoring.web_search": 1787124808.4958086, "agentdeck.adapters.engines.openai_agents": 1787124808.492586, "agentdeck.authoring.compile": 1787124808.4952602, "agentdeck.authoring.skills": 1787124808.4958086, "agentdeck.adapters.stores.postgres.store": 1787124808.4939494, "agentdeck.authoring.nodes": 1787124808.4952602, "agentdeck.runtime.capture": 1787124808.4979315, "agentdeck.core.ports.lease": 1787124808.496899, "agentdeck.adapters": 1787124808.4920352, "agentdeck.core.control": 1787124808.4964523, "agentdeck.adapters.telemetry.langfuse": 1787124808.494568, "agentdeck": 1787124808.4920352, "agentdeck.runtime.dispatch": 1787124808.4979315, "agentdeck.core.context": 1787124808.4964523, "agentdeck.core.ports.engine": 1787124808.496899, "agentdeck.adapters.engines.openai_agents.sessions": 1787124808.49288, "agentdeck.surfaces.cli": 1787124808.4989896, "agentdeck.authoring.injection": 1787124808.4952602, "agentdeck.adapters.engines.stub": 1787124808.49288, "agentdeck.authoring": 1787124808.4949489, "agentdeck.deck": 1787124808.496899, "agentdeck.runtime.settings": 1787124808.4979315, "agentdeck.authoring.workflow": 1787124808.4958086, "agentdeck.core.reporting": 1787124808.496899, "agentdeck.core.base": 1787124808.4964523, "agentdeck.adapters.stores.memory": 1787124808.4937537, "agentdeck.authoring.instructions": 1787124808.4952602, "agentdeck.adapters.tools.mcp.transport": 1787124808.4949489, "agentdeck.authoring.hooks": 1787124808.4952602, "agentdeck.adapters.engines.langgraph.engine": 1787124808.492586, "agentdeck.adapters.telemetry.langfuse.sink": 1787124808.4946196, "agentdeck.surfaces.serve.app": 1787124808.4991884, "agentdeck.core.events": 1787124808.4964523, "agentdeck.adapters.tools.mcp.lifecycle": 1787124808.4949489, "agentdeck.core.ports": 1787124808.4964523, "agentdeck.adapters.stores.postgres": 1787124808.4938037, "agentdeck.adapters.engines.openai_agents.reconcile": 1787124808.49288, "agentdeck.adapters.tools.mcp": 1787124808.4948971, "agentdeck.observers": 1787124808.496899, "agentdeck.adapters.engines.openai_agents.translate": 1787124808.49288, "agentdeck.adapters.engines.stub.engine": 1787124808.4933414, "agentdeck.authoring.runners.agent": 1787124808.4958086, "agentdeck.surfaces": 1787124808.498866, "agentdeck.core": 1787124808.4958086, "agentdeck.adapters.control.memory.port": 1787124808.4922931, "agentdeck.adapters.engines.openai_agents.engine": 1787124808.49288, "agentdeck.adapters.stores.redis.store": 1787124808.494179, "agentdeck.runtime": 1787124808.496899, "agentdeck.composition": 1787124808.4958086, "agentdeck.adapters.engines.langgraph.checkpointer": 1787124808.492586, "agentdeck.authoring.interrupts": 1787124808.4952602, "agentdeck.runtime.registry": 1787124808.4979315, "agentdeck.runtime.discovery": 1787124808.4979315, "agentdeck.adapters.stores": 1787124808.4936168, "agentdeck.adapters.leases.sqlite.port": 1787124808.4936168, "agentdeck.adapters.stores.memory.store": 1787124808.4938037, "agentdeck.adapters.telemetry.langfuse.client": 1787124808.4946196, "agentdeck.surfaces.serve": 1787124808.49904, "agentdeck.authoring.agent": 1787124808.4952602, "agentdeck.surfaces.cli.chat": 1787124808.49904, "agentdeck.adapters.leases": 1787124808.4933414, "agentdeck.cli": 1787124808.4958086, "agentdeck.authoring.runners.workflow": 1787124808.4958086, "agentdeck.surfaces.serve.compat": 1787124808.4991884, "agentdeck.adapters.leases.sqlite": 1787124808.4935102, "agentdeck.adapters.control.sqlite.port": 1787124808.4923918, "agentdeck.adapters.engines.openai_agents.runconfig": 1787124808.49288, "agentdeck.adapters.telemetry.langfuse.trace": 1787124808.4946196, "agentdeck.mcp": 1787124808.496899, "agentdeck.adapters.tools": 1787124808.4946196, "agentdeck.adapters.engines": 1787124808.4923918, "agentdeck.core.ports.control": 1787124808.496899, "agentdeck.adapters.telemetry": 1787124808.494368, "agentdeck.adapters.leases.memory.port": 1787124808.4935102, "agentdeck.adapters.stores.redis": 1787124808.4939494, "agentdeck.core.ports.sink": 1787124808.496899, "agentdeck.skills.bundle": 1787124808.498866, "agentdeck.runtime.service": 1787124808.4979315}

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

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

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

@@ -8,6 +8,56 @@ Fixed / Security` order  -  and are written to be attached to a release as-is.
 
 ## [Unreleased]
 
+## [4.0.4] - 2026-08-19
+
+### Added
+
+- **`examples/jack` bounds its conversation memory.** A session re-sends its whole history every
+  turn, and tool results here are documentation pages, one of which is 30 KB. Fifteen turns
+  reached a 320 KB request and the endpoint then rejected every later turn in that session
+  permanently. `jack.session.BoundedSessions` is a `Deck(session_factory=...)` that keeps only the
+  most recent whole exchanges, cutting at user-message boundaries so a tool call is never
+  separated from its result.
+- **`examples/jack` can trace itself.** Setting `AGENTDECK_LANGFUSE_PUBLIC_KEY` attaches the
+  packaged `Langfuse` observer, and setting `AGENTDECK_EVENTS` to a `sqlite://` URL makes the run
+  log durable. Both are off by default, so a clone still runs with no backend. Both store what
+  callers typed; the example's README says what that means for a public endpoint.
+
+### Fixed
+
+- **Three documentation pages stated things the code does not do.** `runs-and-control/lifecycle-and-control`
+  listed a `QUEUED` state and uppercase names; the six real values are `running`, `paused`,
+  `waiting_answer`, `completed`, `failed` and `cancelled`. `reference/events` listed
+  `message.delta`, `tool.call` and `tool.result`, none of which exist, and omitted 14 kinds that
+  do; it now covers all 21 with their payloads. The Quickstart printed an invented transcript,
+  read `run.status` as a property when it is a coroutine, and iterated `run.events()` without
+  `follow=True`, which returns only what the log already holds.
+
+## [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.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentdeck-sdk
-Version: 4.0.2
+Version: 4.0.4
 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.4}/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