# Public Export Index

This index covers the root package's `__all__`. A root export is not necessarily
a high-level constructor: event unions and protocol aliases describe contracts,
while runtime and artifact handles are advanced integration surfaces.

| Exports | Contract and detailed reference |
| --- | --- |
| `__version__` | Installed Kedi version string; not the provider or grammar revision |
| `query`, `bind` | Decorators preserving sync/async call shape; execute docstring/file Kedi, not the Python stub. [Query](query.md), [Bind](bind.md) |
| `configure`, `context`, `reset_config`, `parallel`, `interactive` | Configuration replacement, scoped overlay, reset, concurrent override and incremental construction. [Parameters](public-parameters.md) |
| `AdapterLike`, `AgentName`, `FrameworkAdapterName` | Selection aliases; framework and harness selectors are not interchangeable. [Selection](configuration-and-context.md#framework-and-harness-selection) |
| `type`, `tool`, `Constraints` | Class registration, callable metadata/retries/risk, validation-only field metadata. [Types and Tools](types-and-tools.md) |
| `approval`, `ApprovalPolicy`, `ApprovalMode`, `ApprovalHandler`, `ApprovalRequest`, `ApprovalDecision`, `ApprovalCancelled` | Policy registration, static/dynamic policy types, immutable request and allow/deny/edit results; cancellation is not denial. [Approvals](approvals-mcp-and-skills.md) |
| `McpServerSpec`, `SkillsSettings` | Normalized server transport specification and scoped skill-discovery policy. [MCP](mcp.md), [Skills](skills.md) |
| `CodeModeSettings` | Enabled/discovery-result limits for the scoped tool catalog. [CodeMode](../agentic-engineering/codemode.md) |
| `on`, `HookSettings`, `HookHandler`, `HookEvent`, `HookEventName`, `HookDecisionKind` | Registration and event/decision aliases, not arbitrary provider callbacks. [Hooks](../agentic-engineering/hooks.md) |
| `HookContext`, `ToolHookContext`, `ToolOrigin` | Run lineage and tool-origin metadata supplied by runtime; do not infer authorization from origin. [Hooks](../agentic-engineering/hooks.md) |
| `UserPromptSubmitRequest`, `UserPromptSubmitDecision`, `PreToolUseRequest`, `PreToolUseDecision`, `PostToolUseEvent`, `PostToolUseFailureEvent` | Typed hook payloads; only pre-operation decisions can edit/deny, post events cannot undo effects. [Hook payloads](../agentic-engineering/hooks.md) |
| `HookDeniedError`, `HookExecutionError`, `HookTimeoutError` | Denial, handler failure, and timeout remain distinct failure paths. [Hooks](../agentic-engineering/hooks.md) |
| `AgentMessageEvent`, `AgentMessagePhase`, `AgentRunState`, `AgentRunStateEvent`, `AgentStreamEvent` | Semantic message/run-state events and discriminants, not token streams. [Stream Events](../agentic-engineering/stream-events.md) |
| `AsyncAgentEventQueue`, `observe_agent_events`, `bind_agent_event_dispatcher` | Async queue and scoped event observer/dispatcher; own and join producer tasks explicitly. [Stream Events](../agentic-engineering/stream-events.md) |
| `SubagentExecutionContext`, `SubagentUsageLimits`, `current_subagent_execution` | Current child lineage (or `None` outside a child) and request/tool/token ceilings. [Python Embedding](../agentic-engineering/subagent-python.md) |
| `ConversationState`, `session` | Model history and artifact ownership, not incremental variable scope. [Sessions](artifacts-and-sessions.md) |
| `ArtifactPolicy`, `ArtifactRef`, `ArtifactChunk`, `ArtifactSearchResult`, `ArtifactReleaseResult`, `ArtifactHandle`, `ArtifactStream` | Policy, bounded transport/results, internal native handle, explicit single-use stream. [Artifacts](../runtime/tool-artifacts.md), [Retrieval](../runtime/artifact-retrieval.md), [Lifetime](../runtime/artifact-lifecycle.md) |
| `DecisionCapture`, `DecisionInfo`, `DecisionSource`, `capture_decisions`, `decision_info` | Historical evaluation metadata, capture scope, and binding lookup; no extra model requests. [Decisions](decisions.md) |
| `CodexModel`, `CodexModelAdapter`, `CodexResponsesConnection`, `CodexResponsesFallback`, `codex_responses_model` | Model factory/result aliases, framework choice, HTTP/WebSocket and explicit fallback policy. [Codex Models](../agent-adapters/codex-models.md) |
| `CacheInfo`, `cache_info`, `clear_cache` | Process-memory cache counts and invalidation; no provider cache control. [Cache Control](cache-control.md) |
| `KediRuntime`, `AgentSurface`, `i`, `o`, `c` | Compiled container, bound agent lifecycle, and input/output/call expression constructors. [Embedding](embedding.md), [Runtime](caching-runtime-and-executors.md) |
| `KediPromise`, `KediPromiseLeak`, `force` | Deferred value, erroneous concrete use and explicit resolution. [Promises](concurrency-and-promises.md) |
| `InteractiveSession`, `dump_session`, `load_session`, `SessionPersistenceError`, `SessionDumpError`, `SessionLoadError` | Incremental execution and strict snapshot serialization/errors. [Incremental Execution](../runtime/interactive-execution.md) |
| `LoopIterationLimitError` | Conditional-loop guard exceeded, not normal completion. [Loops](../core-language/loops-and-map.md) |
| `Executor`, `DefaultExecutor`, `ExecutorDebugEvent`, `ExecutorDebugExporter`, `MarkdownDebugExporter`, `default_debug_export_path` | Python execution protocol and diagnostic exports; default execution is unsandboxed and exports are not secret-redacted. [Executors](executors.md) |

Optional `kedi.typesafe` exports are separate from this root index. Importing
that module requires `kedi-typesafe`; see [Jev Criteria](../agent-adapters/jev-criteria.md).