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

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.3 → agentdeck_sdk-4.0.4}/CHANGELOG.md

@@ -8,6 +8,31 @@ 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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentdeck-sdk
-Version: 4.0.3
+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

{agentdeck_sdk-4.0.3 → agentdeck_sdk-4.0.4}/docs-site/app/landing-components.tsx

@@ -17,7 +17,7 @@ import { Hero } from './hero'
 
 export { Hero }
 
-const RELEASE = '4.0.3'
+const RELEASE = '4.0.4'
 const REPO = 'https://github.com/agentdecksdk/agentdeck'
 const JACK_SOURCE = `${REPO}/tree/dev/examples/jack`
 

{agentdeck_sdk-4.0.3 → agentdeck_sdk-4.0.4}/docs-site/content/meet-agentdeck/quickstart.mdx

@@ -37,26 +37,36 @@ Execute the agent within the Deck's runtime context:
 async def main():
     async with deck:
         run = await deck.runs.start("assistant", input="Hello!")
-        async for event in run.events():
+        async for event in run.events(follow=True):
             print(event.kind)
         result = await run
-        print("Status:", run.status)
-        print("Result:", result)
+        print("Status:", await run.status())
+        print("Result:", result.output)
 ```
 
+`follow=True` streams until the run reaches a terminal event. Without it you get only what the
+log already holds, which for a run this young is one event. `run.status()` is a coroutine, not a
+property.
+
 ## ◆ 04 : WATCH WHAT HAPPENED
 
 Running the script emits an ordered sequence of lifecycle and content events:
 
 ```text
 run.started
-agent.message
+text.delta
+usage.reported
+message.completed
 run.completed
 
-Status: COMPLETED
-Result: Hello! How can I help you today?
+Status: completed
+Result: Hello!
 ```
 
+`text.delta` is one streamed fragment and there is usually more than one; `message.completed`
+carries the finished text. Every kind a run can emit is listed in the
+[events reference](/reference/events).
+
 ## What you just used
 
 - **Agent**: Your executable component.

agentdeck_sdk-4.0.4/docs-site/content/reference/events.mdx

@@ -0,0 +1,100 @@
+---
+title: Events
+description: Every event kind a run can emit, with its payload fields.
+---
+
+# Events Reference
+
+One ordered log per run. Every managed invocation appends to it, whatever started the run, and
+status is folded from it rather than stored beside it.
+
+## The envelope
+
+Every event carries the same envelope, whatever its kind:
+
+| Field | Meaning |
+|---|---|
+| `v` | Schema version |
+| `kind` | One of the kinds below |
+| `seq` | Position in this run's log, monotonic from 1 |
+| `run_id` | The run this belongs to |
+| `session_id` | The session, when the run has one |
+| `namespace` | The run's namespace label |
+| `origin` | Which invocable emitted it |
+| `ts` | When the store recorded it |
+| `payload` | The kind-specific body, below |
+
+`seq` and `ts` are assigned by the store, not the producer, so ordering is the store's to
+guarantee rather than a caller's to get right.
+
+## Lifecycle
+
+Each of these sets the run's status. See [Lifecycle & Control](/runs-and-control/lifecycle-and-control).
+
+| Kind | Payload | Notes |
+|---|---|---|
+| `run.started` | `invocable`, `kind_of_invocable`, `input` | Opens the run |
+| `run.completed` | `output`, `usage` | Terminal. `usage` is the authoritative total |
+| `run.failed` | `error_code`, `message`, `retryable` | Terminal. `error_code` is closed, so branch on it rather than parsing the message |
+| `run.paused` | `reason` | Not terminal, and not waiting on an answer |
+| `run.resumed` | `reason`, `value` | Same `run_id`, `seq` keeps counting |
+| `run.cancelled` | `reason` | Terminal |
+| `run.interrupted` | `interrupt_id`, `reason`, `payload`, `thread_id`, `expected_resume` | Waiting on an answer. Not terminal |
+
+## Control
+
+| Kind | Payload | Notes |
+|---|---|---|
+| `control.requested` | `verb`, `reason` | The signal was recorded, not that the run has acted on it |
+| `control.observed` | `verb`, `safe_point` | The run reached a safe point and is acting on it |
+
+## Content
+
+| Kind | Payload | Notes |
+|---|---|---|
+| `text.delta` | `message_id`, `text` | One streamed fragment |
+| `thought.delta` | `message_id`, `text` | Reasoning fragment, a separate channel |
+| `message.completed` | `message_id`, `text` | The record. Deltas are streaming UX |
+| `artifact.created` | `artifact_id`, `media_type`, `uri`, `size` | A reference to bytes stored elsewhere |
+
+## Tools and nodes
+
+| Kind | Payload | Notes |
+|---|---|---|
+| `tool.call.started` | `call_id`, `tool`, `args` | Paired with the completion by `call_id` |
+| `tool.call.completed` | `call_id`, `tool`, `result_preview`, `result_size`, `result_sha256`, `artifacts` | A capped preview plus size and hash, never the result itself |
+| `node.updated` | `node`, `state_patch` | `state_patch` shallow-merges: top-level keys replace |
+
+## Reporting
+
+Advisory. These describe progress; they never change status.
+
+| Kind | Payload | Notes |
+|---|---|---|
+| `status.reported` | `message` | What the run is doing now, in words a person can read |
+| `progress.reported` | `step`, `current`, `total` | Which named stage, optionally counted |
+| `usage.reported` | `model`, `usage` | One model call. The total on `run.completed` wins |
+
+## Other
+
+| Kind | Payload | Notes |
+|---|---|---|
+| `input.appended` | `input`, `source` | Mid-turn steering |
+| `custom` | `name`, `data` | Engine-specific. `name` must be namespaced |
+
+## Reading them
+
+```python
+async for event in run.events(from_seq=0, follow=True):
+    print(event.seq, event.kind)
+```
+
+An unknown kind is carried rather than rejected, so a reader written today does not break against
+a log written by a newer release.
+
+```python
+from agentdeck.core.events import KNOWN_KINDS, TERMINAL_KINDS
+```
+
+`KNOWN_KINDS` is the set above. `TERMINAL_KINDS` is `run.completed`, `run.failed` and
+`run.cancelled`: seeing one of those means no further events will arrive for that run.

{agentdeck_sdk-4.0.3 → agentdeck_sdk-4.0.4}/docs-site/content/resources/changelog.mdx

@@ -10,39 +10,40 @@ description: What changed in each release of AgentDeck, and what to do about it
 Rendered from the repository's own `CHANGELOG.md`, so this page cannot drift from it. Entries
 are written for someone using the package: what changed, and what to do about it.
 
-The current release is **v4.0.3**. Earlier releases are listed at the bottom.
+The current release is **v4.0.4**. Earlier releases are listed at the bottom.
 
-## v4.0.3
+## v4.0.4
 
 *Released 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.
+- **`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
 
-- **The landing page's release chip said 4.0.1 on a 4.0.2 site.** It now tracks the release it
-  ships in.
+- **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.
 
 ## Earlier releases
 
 | Version | Date | Notes |
 |---|---|---|
+| [v4.0.3](https://github.com/agentdecksdk/agentdeck/releases/tag/v4.0.3) | 2026-08-19 | [release notes](https://github.com/agentdecksdk/agentdeck/releases/tag/v4.0.3) |
 | [v4.0.2](https://github.com/agentdecksdk/agentdeck/releases/tag/v4.0.2) | 2026-08-19 | [release notes](https://github.com/agentdecksdk/agentdeck/releases/tag/v4.0.2) |
 | [v4.0.1](https://github.com/agentdecksdk/agentdeck/releases/tag/v4.0.1) | 2026-08-18 | [release notes](https://github.com/agentdecksdk/agentdeck/releases/tag/v4.0.1) |
 | [v4.0.0](https://github.com/agentdecksdk/agentdeck/releases/tag/v4.0.0) | 2026-08-16 | [release notes](https://github.com/agentdecksdk/agentdeck/releases/tag/v4.0.0) |

agentdeck_sdk-4.0.4/docs-site/content/runs-and-control/lifecycle-and-control.mdx

@@ -0,0 +1,73 @@
+---
+title: Lifecycle & Control
+description: The six states a run can be in, what moves it between them, and which ones you can act on.
+---
+
+# Lifecycle & Control
+
+A run is in exactly one of six states. Status is folded from the event log rather than stored
+beside it, so there is no second source that can disagree with what happened.
+
+## The states
+
+| Status | Meaning | Terminal |
+|---|---|---|
+| `running` | Executing now | no |
+| `paused` | Stopped cooperatively at a safe point | no |
+| `waiting_answer` | Parked on an interrupt, waiting for input | no |
+| `completed` | Finished, with a result | yes |
+| `failed` | Finished, with an error | yes |
+| `cancelled` | Stopped and will not continue | yes |
+
+There is no queued state. A run is `running` from the moment it starts.
+
+```python
+from agentdeck.core.status import RunStatus
+
+RunStatus.RUNNING, RunStatus.PAUSED, RunStatus.WAITING_ANSWER
+RunStatus.COMPLETED, RunStatus.FAILED, RunStatus.CANCELLED
+```
+
+## What moves a run between them
+
+Each lifecycle event sets exactly one status, which is why the log and the status can never
+disagree.
+
+| Event | Resulting status |
+|---|---|
+| `run.started` | `running` |
+| `run.paused` | `paused` |
+| `run.interrupted` | `waiting_answer` |
+| `run.resumed` | `running` |
+| `run.completed` | `completed` |
+| `run.failed` | `failed` |
+| `run.cancelled` | `cancelled` |
+
+## What you can act on
+
+`paused` and `waiting_answer` are the two resumable states. The three terminal states accept
+nothing: a completed run cannot be paused, and a cancelled run cannot be resumed.
+
+```python
+run = await deck.runs.start("Jack", question)
+
+await run.pause()          # running -> paused, at the next safe point
+await run.resume()         # paused -> running
+await run.cancel()         # -> cancelled
+await run.answer(value)    # waiting_answer -> running
+
+status = await run.status()   # a coroutine, not a property
+```
+
+`pause` and `cancel` are requests, not interrupts. The run records the signal, then acts on it
+when it next reaches a safe point: between stream items, before dispatching a tool, or at a node
+boundary. Two events make that visible, `control.requested` when the signal is recorded and
+`control.observed` when the run picks it up, so a control that has not taken effect yet is
+distinguishable from one that was never seen.
+
+## Related
+
+- [Runs](/runs-and-control/runs) - starting a run and getting the handle back
+- [Pause / Resume](/runs-and-control/pause-resume) - safe points in more detail
+- [Human Input](/runs-and-control/human-input) - answering a run parked at an interrupt
+- [Events](/reference/events) - every event kind and its payload