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

{agentdeck_sdk-4.0.1 → agentdeck_sdk-4.0.2}/.github/workflows/docs-pages.yml

@@ -49,7 +49,7 @@ jobs:
           # calling http://, which is the real reason the backend needs a tunnel rather than a
           # port forward. Never put a secret here — NEXT_PUBLIC_* is public by construction, and
           # everything under it is readable in the shipped JavaScript.
-          NEXT_PUBLIC_AGENTDECK_API_URL: ${{ vars.ASK_AGENTDECK_API_URL }}
+          NEXT_PUBLIC_AGENTDECK_API_URL: ${{ vars.JACK_API_URL }}
           # The canonical origin, baked into canonical tags, Open Graph URLs, the sitemap and
           # robots.txt. Unset, it falls back to the Pages URL. Setting this repository variable
           # is what moves the site to agentdecksdk.com — one variable, not a sweep, which is the

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

@@ -0,0 +1 @@
+{"agentdeck.authoring.tools": 1787112918.7268076, "agentdeck.adapters.telemetry.langfuse": 1787112918.7255192, "agentdeck.surfaces": 1787112918.7298076, "agentdeck.surfaces.serve.compat": 1787112918.730176, "agentdeck.adapters": 1787112918.7229855, "agentdeck.composition": 1787112918.7268076, "agentdeck.adapters.tools.mcp.transport": 1787112918.725934, "agentdeck.core.ports.control": 1787112918.727932, "agentdeck.adapters.engines.langgraph.engine": 1787112918.723521, "agentdeck.runtime.service": 1787112918.72897, "agentdeck.authoring.agent": 1787112918.7262156, "agentdeck.errors": 1787112918.727932, "agentdeck.core.events": 1787112918.7274418, "agentdeck.authoring.runners": 1787112918.7262156, "agentdeck.runtime.registry": 1787112918.72897, "agentdeck.surfaces.cli": 1787112918.7300088, "agentdeck.authoring.timers": 1787112918.7268076, "agentdeck.adapters.stores.redis.store": 1787112918.725127, "agentdeck.skills": 1787112918.72897, "agentdeck.adapters.engines.stub.engine": 1787112918.724265, "agentdeck.core.content": 1787112918.7274418, "agentdeck.authoring.web_search": 1787112918.7268076, "agentdeck.surfaces.serve.app": 1787112918.730176, "agentdeck.core.ports.lease": 1787112918.727932, "agentdeck.adapters.stores.sqlite.store": 1787112918.725316, "agentdeck.adapters.tools.mcp": 1787112918.7258077, "agentdeck.adapters.telemetry.langfuse.trace": 1787112918.7255728, "agentdeck.authoring.instructions": 1787112918.7262156, "agentdeck.adapters.engines.openai_agents.sessions": 1787112918.7238076, "agentdeck.adapters.telemetry.langfuse.sink": 1787112918.7255728, "agentdeck.authoring.runners.workflow": 1787112918.7268076, "agentdeck.observers": 1787112918.727932, "agentdeck.adapters.engines.openai_agents.runconfig": 1787112918.7238076, "agentdeck.adapters.engines.langgraph": 1787112918.7234612, "agentdeck.runtime.settings": 1787112918.72897, "agentdeck.skills.bundle": 1787112918.7298076, "agentdeck.adapters.tools": 1787112918.7255728, "agentdeck.core.ports.tools": 1787112918.727932, "agentdeck.adapters.engines.langgraph.checkpointer": 1787112918.723521, "agentdeck.cli": 1787112918.7268076, "agentdeck.adapters.leases.sqlite.port": 1787112918.7245457, "agentdeck.adapters.control.memory.port": 1787112918.7232156, "agentdeck.core.ports.sink": 1787112918.727932, "agentdeck.adapters.tools.mcp.lifecycle": 1787112918.725934, "agentdeck.serve": 1787112918.72897, "agentdeck.adapters.stores.memory": 1787112918.7246792, "agentdeck.adapters.stores.memory.store": 1787112918.7247288, "agentdeck.adapters.telemetry.langfuse.client": 1787112918.7255728, "agentdeck.deck": 1787112918.727932, "agentdeck.core.base": 1787112918.7274418, "agentdeck.authoring.runners.agent": 1787112918.7267725, "agentdeck.adapters.engines.openai_agents.engine": 1787112918.7238076, "agentdeck.authoring.injection": 1787112918.7262156, "agentdeck.adapters.leases.memory": 1787112918.7243917, "agentdeck": 1787112918.7229855, "agentdeck.adapters.control.memory": 1787112918.7231653, "agentdeck.adapters.stores": 1787112918.7245457, "agentdeck.adapters.engines.openai_agents.translate": 1787112918.7238076, "agentdeck.authoring.workflow": 1787112918.7268076, "agentdeck.core.control": 1787112918.7274418, "agentdeck.adapters.control.sqlite.port": 1787112918.7233129, "agentdeck.adapters.stores.postgres": 1787112918.7248077, "agentdeck.runtime.dispatch": 1787112918.72897, "agentdeck.adapters.leases": 1787112918.724265, "agentdeck.testing": 1787112918.730176, "agentdeck.adapters.leases.memory.port": 1787112918.7244415, "agentdeck.surfaces.cli.chat": 1787112918.7300642, "agentdeck.adapters.stores.redis": 1787112918.7248077, "agentdeck.authoring.hooks": 1787112918.7262156, "agentdeck.adapters.engines": 1787112918.7233129, "agentdeck.adapters.stores.sqlite": 1787112918.725127, "agentdeck.surfaces.serve.workflows": 1787112918.730176, "agentdeck.authoring.graphs": 1787112918.7262156, "agentdeck.core.status": 1787112918.727932, "agentdeck.adapters.stores.postgres.store": 1787112918.7248077, "agentdeck.authoring.compile": 1787112918.7262156, "agentdeck.core.invocable": 1787112918.7274418, "agentdeck.authoring.state": 1787112918.7268076, "agentdeck.authoring.nodes": 1787112918.7262156, "agentdeck.core.ports.engine": 1787112918.727932, "agentdeck.runtime": 1787112918.7288077, "agentdeck.authoring": 1787112918.725934, "agentdeck.adapters.engines.openai_agents.reconcile": 1787112918.7238076, "agentdeck.adapters.telemetry": 1787112918.725316, "agentdeck.authoring.skills": 1787112918.7268076, "agentdeck.core": 1787112918.7268076, "agentdeck.surfaces.serve": 1787112918.7300642, "agentdeck.adapters.control.sqlite": 1787112918.7232156, "agentdeck.core.reporting": 1787112918.727932, "agentdeck.adapters.tools.mcp.wiring": 1787112918.725934, "agentdeck.authoring.interrupts": 1787112918.7262156, "agentdeck.adapters.leases.sqlite": 1787112918.7244415, "agentdeck.adapters.tools.mcp.source": 1787112918.725934, "agentdeck.adapters.engines.openai_agents": 1787112918.723521, "agentdeck.runtime.discovery": 1787112918.72897, "agentdeck.core.ports.store": 1787112918.727932, "agentdeck.core.context": 1787112918.7274418, "agentdeck.core.ports": 1787112918.7278075, "agentdeck.adapters.control": 1787112918.7231023, "agentdeck.mcp": 1787112918.727932, "agentdeck.runtime.capture": 1787112918.72897, "agentdeck.adapters.engines.stub": 1787112918.7238076}

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

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

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

@@ -8,6 +8,32 @@ Fixed / Security` order  -  and are written to be attached to a release as-is.
 
 ## [Unreleased]
 
+## [4.0.2] - 2026-08-19
+
+### Changed
+
+- **`examples/jack` reads `JACK_*` environment variables.** `ASK_AGENTDECK_ORIGINS`,
+  `ASK_AGENTDECK_SESSIONS_PER_DAY` and `ASK_AGENTDECK_TURNS_PER_SESSION` are now
+  `JACK_ORIGINS`, `JACK_SESSIONS_PER_DAY` and `JACK_TURNS_PER_SESSION`, correcting 4.0.1,
+  which said they would keep their names. A deployment that sets the old names falls back to
+  the defaults silently, so rename them when you upgrade.
+- **The documentation landing page is one continuous build rather than nine chapters.** It
+  builds Jack once, from an `Agent` to a live run, and the execution tree beside the code is
+  that code's own tree.
+- **[How Jack is built](https://agentdecksdk.com/jack) is its own page**, with the decisions
+  and the alternatives they beat in
+  [Implementation notes](https://agentdecksdk.com/jack/notes). The README follows the same
+  build.
+
+### Fixed
+
+- **Jack could not be reached from the published site.** The docs build baked
+  `http://localhost:8100` as its API origin whenever `NEXT_PUBLIC_AGENTDECK_API_URL` was
+  unset, so the panel called the visitor's own machine. `docs-site/.env.production` now
+  carries the origin, and a real environment variable still wins.
+- **A second question to Jack replaced the first.** The panel keeps the transcript, so a
+  conversation reads as one.
+
 ## [4.0.1] - 2026-08-18
 
 ### Changed

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentdeck-sdk
-Version: 4.0.1
+Version: 4.0.2
 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
@@ -53,9 +53,10 @@ Description-Content-Type: text/markdown
 
 # AgentDeck SDK
 
-**Compose. Observe. Ship.**
+**Agentic software should feel like software.**
 
-The production runtime for agents you already have.
+Build agents, tools and workflows as normal software.
+AgentDeck gives them one execution model you can observe, control and extend.
 
 <!-- The blue variant, not logo.svg: that one is fill="currentColor" for inlining, and an SVG
      loaded through <img> has nothing to inherit from, so it renders black  -  invisible on
@@ -69,66 +70,143 @@ The production runtime for agents you already have.
 
 </div>
 
-**A harness for agents you have to operate.** You write agents, workflows and skills as small
-Python declarations in a `.agentdeck/` directory; AgentDeck supplies the runtime around them and
-leaves the running of a turn to the engines underneath.
-
 ```bash
 pip install agentdeck-sdk
 ```
 
+The rest of this page builds one real application, a step at a time. Its name is Jack, he
+answers questions about AgentDeck, and he is the assistant running on
+[agentdecksdk.com](https://agentdecksdk.com/) right now. Everything below is his actual source.
+
+## Let's build Jack
+
+An agent is a declaration. A Deck is where an agentic application comes together.
+
 ```python
-# .agentdeck/agents/greeter/agent.py
-from agentdeck import Agent
+from agentdeck import Agent, Deck
 
-greeter = Agent(name="Greeter", instructions="You are a friendly scheduling assistant.")
+jack = Agent(
+    name="Jack",
+    instructions="Help developers build with AgentDeck.",
+)
+
+deck = Deck(agents=[jack])
 ```
 
+## Jack needs to know things
+
+Tools do work; agents make decisions. A tool that takes a `Context` stays an ordinary function,
+because the model is offered only the arguments it can actually choose: it never sees `docs`.
+
 ```python
-# main.py  -  the directory is the registration: no catalog file, no decorator
-import asyncio
+from agentdeck import Agent, Context, Deck
+
+def search_docs(query: str, docs: Context[DocsCorpus]) -> str:
+    """Find AgentDeck documentation pages matching a query."""
+    return docs.data.search(query)
 
-from agentdeck import Deck
+def read_doc(slug: str, docs: Context[DocsCorpus]) -> str:
+    """Read one AgentDeck documentation page in full, by its slug."""
+    return docs.data.pages[slug]
 
+jack = Agent(
+    name="Jack",
+    instructions="Help developers build with AgentDeck.",
+    tools=[search_docs, read_doc],
+)
 
-async def main() -> None:
-    async with Deck.from_project() as deck:  # discovers ./.agentdeck, fails fast
-        result = await deck.run("Greeter", "hello")
-        print(result.output)
+deck = Deck(agents=[jack], context=DocsCorpus)
+```
+
+`context=DocsCorpus` is the *type*; the instance goes in per run. Declaring it makes `build()`
+check every `Context[...]` in the catalog before a question is ever asked, so the wrong type
+raises at startup rather than mid-answer.
 
-        await deck.run("Greeter", "and my name is Ada", session_id="wa-123")
-        async for event in deck.stream("Greeter", "what's my name?", session_id="wa-123"):
-            print(event.kind)  # text.delta … run.completed
+## Everything becomes one execution tree
 
+Run him, and the run is a first-class thing with an ordered event log:
 
-asyncio.run(main())
+```python
+async with deck:
+    async for event in deck.stream("Jack", "how do I pause a run?", context=corpus):
+        print(event.kind)  # run.started, tool.call.started, text.delta, run.completed
 ```
 
-**OpenAI Agents SDK × LangGraph × MCP**  -  sessions · streaming · one event log · human approval ·
-run control.
+Every managed invocation appends to that one log, whatever started it. Status is folded from
+the log rather than stored beside it, so there is no second source to disagree with.
 
-If AgentDeck is useful to you, [a star](https://github.com/agentdecksdk/agentdeck) helps other
-developers find it.
+## Execution you can steer
+
+A Run is the root execution, and control belongs to the handle rather than to a separate
+lifecycle API:
+
+```python
+run = await deck.runs.start("Jack", question, context=corpus)
 
-## Build, operate, connect
+await run.pause()
+await run.resume()
+await run.cancel()
 
-| Build | Operate | Connect |
-| --- | --- | --- |
-| `Agent` | Sessions | OpenAI Agents SDK |
-| `Workflow` | Streaming | LangGraph |
-| Tools | One event log per run | MCP servers |
-| Skills (`SKILL.md`) | Human approval (HITL) | HTTP + SSE (`agentdeck-serve`) |
-| `Context[T]` | Run control  -  pause / resume / cancel | Memory, Redis, SQLite, Postgres stores |
+await run.answer({"approved": True})   # finish a run parked at an interrupt
+```
+
+`deck.runs.get(id)` rehydrates that handle in another process, so a run paused by a web request
+can be resumed by a worker. Two handles on one run always agree: the durable store is the only
+thing either reads.
+
+## Jack is real, and you can use him now
+
+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.
+
+It 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
+
+Everything you define lives in a `.agentdeck/` directory next to where you run. The path *is*
+the registration: no catalog file, no `__init__.py`, no decorator to remember.
 
-## Why it splits that way
+```text
+.agentdeck/
+├── agents/greeter/agent.py            # an Agent(...)
+├── workflows/new_booking/workflow.py  # a Workflow(...)
+└── skills/parse-request/              # SKILL.md + optional scripts
+```
+
+```python
+async with Deck.from_project() as deck:   # discovers ./.agentdeck, fails fast
+    result = await deck.run("Greeter", "hello")
+```
+
+`Deck` discovers, compiles and validates all of it before the first turn: a missing skill, an
+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.
+
+## You build the behavior. AgentDeck manages the machinery.
+
+| You | AgentDeck |
+| --- | --- |
+| 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 |
 
 **AgentDeck owns configuration; the
 [OpenAI Agents SDK](https://github.com/openai/openai-agents-python) and
 [LangGraph](https://langchain-ai.github.io/langgraph/) own execution.** There is no agent loop
-here, no graph engine, and no reimplementation of either  -  an `Agent` compiles to an SDK agent, a
-`Workflow` compiles to a LangGraph graph, and both are run by their own engine. What AgentDeck
-adds is the part those libraries deliberately leave to you: where definitions live, how they are
-configured, and what you can see and do while a run is in flight.
+here, no graph engine, and no reimplementation of either: an `Agent` compiles to an SDK agent, a
+`Workflow` compiles to a LangGraph graph, and each is run by its own engine. You keep native
+access when you need it.
 
 ## Who it is for
 
@@ -136,7 +214,7 @@ You want this if you are putting agents somewhere they have to keep working: sev
 workflows in one project, a chat surface and a batch path over the same definitions, runs you
 need to inspect afterwards, approvals that outlive the process that asked for them.
 
-You do not want this if you are writing one script that calls one model  -  use the Agents SDK
+You do not want this if you are writing one script that calls one model. Use the Agents SDK
 directly, and come back when the wiring around it has become the work. You also do not want it
 if you have already built your own harness: AgentDeck is opinionated about project layout and
 configuration, and those opinions are the product.
@@ -161,63 +239,13 @@ pip install agentdeck-sdk              # or, with the HTTP surface: agentdeck-sd
 export OPENAI_MODEL=gpt-4.1-mini OPENAI_API_KEY=sk-...
 ```
 
-The distribution is **`agentdeck-sdk`**; the import stays `agentdeck`. `OPENAI_BASE_URL` points it at any
-OpenAI-compatible endpoint instead (a gateway, vLLM, Ollama). Extras: `serve` for the HTTP
-surface, `durability` for the Postgres checkpointer and event store (SQLite ships in base  -
-`durable=True` works out of the box), `redis` for Redis-backed sessions or event log,
+The distribution is **`agentdeck-sdk`**; the import stays `agentdeck`. `OPENAI_BASE_URL` points
+it at any OpenAI-compatible endpoint instead (a gateway, vLLM, Ollama). Extras: `serve` for the
+HTTP surface, `durability` for the Postgres checkpointer and event store (SQLite ships in base,
+so `durable=True` works out of the box), `redis` for Redis-backed sessions or event log,
 `observability` for Langfuse tracing.
 
-Contributing to agentdeck itself is a different setup  -  see
-[CONTRIBUTING.md](CONTRIBUTING.md).
-
-## The project layout
-
-Everything you define lives in a `.agentdeck/` directory next to where you run. The path *is*
-the registration: no catalog file, no `__init__.py`, no decorator to remember.
-
-```text
-.agentdeck/
-├── agents/greeter/agent.py            # an Agent(...)
-├── workflows/new_booking/workflow.py  # a Workflow(...)
-└── skills/parse-request/              # SKILL.md + optional scripts
-```
-
-`Deck` discovers, compiles and validates all of it before the first turn  -  a missing skill, an
-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 a human approval, an existing LangGraph agent wrapped without rewriting it, and the
-one below. All are built by the test suite, so none can quietly stop working.
-
-## Something built with it, that you can use right now
-
-The assistant on **[agentdecksdk.com](https://agentdecksdk.com/)**  -  the panel in the corner of
-every documentation page  -  is an AgentDeck agent. Ask it something about AgentDeck and it will
-search these docs, read the pages it finds, and cite them.
-
-Its entire source is [`examples/jack`](examples/jack/): 617 lines of Python for
-three tools over one `Context[DocsCorpus]`, streaming the run's own events to the browser over
-SSE. Not a demo written to look good in a README  -  it is the thing actually 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 is allowed to see.
-
-It is also the honest test of the pitch. If *"agents you have to operate"* meant anything, it had
-to survive being operated.
-
-## What you get around your definitions
-
-- **Sessions**  -  `session_id=` keeps a conversation across calls and across surfaces, in memory
-  or in Redis.
-- **One event log per run**  -  every turn, however it was started, appends to the same ordered
-  log: text deltas, tool calls, token usage, the result. Status is folded from it, not stored.
-- **Run control**  -  an agent or workflow run in flight can be paused, resumed or cancelled by
-  id, at documented safe points, from another process.
-- **Human approval**  -  a `durable=True` workflow node calls `interrupt()`, the run parks, and
-  `deck.runs.list(status=...)` / `Run.answer()` finish it later, possibly somewhere else.
-- **An HTTP surface**  -  `agentdeck-serve` puts chat, SSE streaming, workflows, and the approval
-  inbox behind FastAPI without any code of yours.
-- **Tools, skills and MCP**  -  SDK tools as plain functions, skills as `SKILL.md` directories,
-  and named MCP servers from a `.mcp.json` beside your project.
+Contributing to agentdeck itself is a different setup: see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Documentation
 
@@ -232,6 +260,9 @@ The full docs are at **[agentdecksdk.com](https://agentdecksdk.com/)**:
 - [Reference](https://agentdecksdk.com/reference/deck)  -  every setting and every `Deck`
   method, generated from the code
 
+If AgentDeck is useful to you, [a star](https://github.com/agentdecksdk/agentdeck) helps other
+developers find it.
+
 ## Project
 
 AgentDeck is beta software under active development; breaking changes are listed in