@agentskit/chat 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,618 @@
+import * as _agentskit_chat_protocol from '@agentskit/chat-protocol';
+import { AskToolEvent, ComponentRenderFrame, AskEvent, VerifiedLocalKnowledgeArtifact, DeterministicSiteConfig, AnswerResponse, SessionConfirmation, SessionSnapshot, ComponentInteractionEvent, ComponentSelectionEvent } from '@agentskit/chat-protocol';
+export { AskEvent, AskEventSchema, AskToolEvent, decodeAskEvents } from '@agentskit/chat-protocol';
+import { AdapterFactory, ChatMemory, Message, AdapterRequest, StreamSource, ChatReturn, ToolAuthorizer, ChatConfig } from '@agentskit/core';
+import { z } from 'zod';
+import { WebStorageLike } from '@agentskit/memory/web-storage';
+
+declare const CHOICE_LIST_COMPONENT_KEY: "choice-list";
+interface ComponentEventDefinition {
+    readonly name: string;
+    readonly value: 'none' | 'id' | 'form' | 'url';
+}
+interface ComponentAccessibilityDefinition {
+    readonly role: string;
+    readonly keyboard: boolean;
+    readonly live: 'none' | 'polite' | 'assertive';
+}
+type ComponentCapability = 'display' | 'selection' | 'input' | 'action' | 'navigation' | 'progress' | 'download';
+interface ComponentDefinition<T> {
+    readonly key: string;
+    readonly propsSchema: z.ZodType<T>;
+    readonly events?: readonly ComponentEventDefinition[];
+    readonly accessibility?: ComponentAccessibilityDefinition;
+    readonly capabilities?: readonly ComponentCapability[];
+    fallback?(props: T): string;
+}
+declare const ChoiceListPropsSchema: z.ZodReadonly<z.ZodObject<{
+    prompt: z.ZodString;
+    choices: z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        action: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+            name: z.ZodString;
+            input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>>;
+declare const ButtonGroupPropsSchema: z.ZodReadonly<z.ZodObject<{
+    label: z.ZodString;
+    buttons: z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        variant: z.ZodOptional<z.ZodEnum<{
+            danger: "danger";
+            primary: "primary";
+            secondary: "secondary";
+        }>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>>;
+declare const FormPropsSchema: z.ZodReadonly<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    fields: z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            text: "text";
+            select: "select";
+            email: "email";
+            checkbox: "checkbox";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>>>;
+    }, z.core.$strict>>>;
+    submitLabel: z.ZodString;
+}, z.core.$strict>>;
+declare const ConfirmationPropsSchema: z.ZodReadonly<z.ZodObject<{
+    title: z.ZodString;
+    message: z.ZodString;
+    confirmLabel: z.ZodString;
+    cancelLabel: z.ZodString;
+}, z.core.$strict>>;
+declare const ProgressPropsSchema: z.ZodReadonly<z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodNumber;
+    status: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+declare const SourceListPropsSchema: z.ZodReadonly<z.ZodObject<{
+    label: z.ZodString;
+    sources: z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        snippet: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>>;
+declare const LinkCardPropsSchema: z.ZodReadonly<z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    href: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+declare const ErrorNoticePropsSchema: z.ZodReadonly<z.ZodObject<{
+    title: z.ZodString;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+    retryLabel: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+declare const ToolCallPropsSchema: z.ZodReadonly<z.ZodObject<{
+    name: z.ZodString;
+    status: z.ZodEnum<{
+        error: "error";
+        pending: "pending";
+        running: "running";
+        complete: "complete";
+    }>;
+    arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    result: z.ZodOptional<z.ZodJSONSchema>;
+}, z.core.$strict>>;
+declare const ApprovalRequestPropsSchema: z.ZodReadonly<z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodString;
+    approveLabel: z.ZodString;
+    denyLabel: z.ZodString;
+}, z.core.$strict>>;
+declare const TablePropsSchema: z.ZodReadonly<z.ZodObject<{
+    caption: z.ZodString;
+    columns: z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strict>>>;
+    rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+}, z.core.$strict>>;
+declare const FileAttachmentPropsSchema: z.ZodReadonly<z.ZodObject<{
+    name: z.ZodString;
+    mimeType: z.ZodString;
+    sizeBytes: z.ZodOptional<z.ZodNumber>;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+type ChoiceListProps = z.infer<typeof ChoiceListPropsSchema>;
+type ChoiceAction = NonNullable<ChoiceListProps['choices'][number]['action']>;
+declare const ChoiceListComponent: ComponentDefinition<Readonly<{
+    prompt: string;
+    choices: Readonly<{
+        id: string;
+        label: string;
+        description?: string | undefined;
+        action?: Readonly<{
+            name: string;
+            input: Record<string, z.core.util.JSONType>;
+        }> | undefined;
+    }>[];
+}>>;
+declare const ButtonGroupComponent: ComponentDefinition<Readonly<{
+    label: string;
+    buttons: Readonly<{
+        id: string;
+        label: string;
+        disabled?: boolean | undefined;
+        variant?: "danger" | "primary" | "secondary" | undefined;
+    }>[];
+}>>;
+declare const FormComponent: ComponentDefinition<Readonly<{
+    fields: Readonly<{
+        id: string;
+        label: string;
+        type: "number" | "text" | "select" | "email" | "checkbox";
+        required?: boolean | undefined;
+        placeholder?: string | undefined;
+        options?: Readonly<{
+            id: string;
+            label: string;
+        }>[] | undefined;
+    }>[];
+    submitLabel: string;
+    title?: string | undefined;
+}>>;
+declare const ConfirmationComponent: ComponentDefinition<Readonly<{
+    title: string;
+    message: string;
+    confirmLabel: string;
+    cancelLabel: string;
+}>>;
+declare const ProgressComponent: ComponentDefinition<Readonly<{
+    label: string;
+    value: number;
+    status?: string | undefined;
+}>>;
+declare const SourceListComponent: ComponentDefinition<Readonly<{
+    label: string;
+    sources: Readonly<{
+        id: string;
+        title: string;
+        url?: string | undefined;
+        snippet?: string | undefined;
+    }>[];
+}>>;
+declare const LinkCardComponent: ComponentDefinition<Readonly<{
+    title: string;
+    href: string;
+    description?: string | undefined;
+    label?: string | undefined;
+}>>;
+declare const ErrorNoticeComponent: ComponentDefinition<Readonly<{
+    title: string;
+    message: string;
+    code?: string | undefined;
+    retryLabel?: string | undefined;
+}>>;
+declare const ToolCallComponent: ComponentDefinition<Readonly<{
+    name: string;
+    status: "error" | "pending" | "running" | "complete";
+    arguments?: Record<string, z.core.util.JSONType> | undefined;
+    result?: z.core.util.JSONType | undefined;
+}>>;
+declare const ApprovalRequestComponent: ComponentDefinition<Readonly<{
+    title: string;
+    description: string;
+    approveLabel: string;
+    denyLabel: string;
+}>>;
+declare const TableComponent: ComponentDefinition<Readonly<{
+    caption: string;
+    columns: Readonly<{
+        key: string;
+        label: string;
+    }>[];
+    rows: Record<string, string | number | boolean | null>[];
+}>>;
+declare const FileAttachmentComponent: ComponentDefinition<Readonly<{
+    name: string;
+    mimeType: string;
+    sizeBytes?: number | undefined;
+    url?: string | undefined;
+}>>;
+declare const StandardComponentCatalog: readonly [ComponentDefinition<Readonly<{
+    label: string;
+    buttons: Readonly<{
+        id: string;
+        label: string;
+        disabled?: boolean | undefined;
+        variant?: "danger" | "primary" | "secondary" | undefined;
+    }>[];
+}>>, ComponentDefinition<Readonly<{
+    prompt: string;
+    choices: Readonly<{
+        id: string;
+        label: string;
+        description?: string | undefined;
+        action?: Readonly<{
+            name: string;
+            input: Record<string, z.core.util.JSONType>;
+        }> | undefined;
+    }>[];
+}>>, ComponentDefinition<Readonly<{
+    fields: Readonly<{
+        id: string;
+        label: string;
+        type: "number" | "text" | "select" | "email" | "checkbox";
+        required?: boolean | undefined;
+        placeholder?: string | undefined;
+        options?: Readonly<{
+            id: string;
+            label: string;
+        }>[] | undefined;
+    }>[];
+    submitLabel: string;
+    title?: string | undefined;
+}>>, ComponentDefinition<Readonly<{
+    title: string;
+    message: string;
+    confirmLabel: string;
+    cancelLabel: string;
+}>>, ComponentDefinition<Readonly<{
+    label: string;
+    value: number;
+    status?: string | undefined;
+}>>, ComponentDefinition<Readonly<{
+    label: string;
+    sources: Readonly<{
+        id: string;
+        title: string;
+        url?: string | undefined;
+        snippet?: string | undefined;
+    }>[];
+}>>, ComponentDefinition<Readonly<{
+    title: string;
+    href: string;
+    description?: string | undefined;
+    label?: string | undefined;
+}>>, ComponentDefinition<Readonly<{
+    title: string;
+    message: string;
+    code?: string | undefined;
+    retryLabel?: string | undefined;
+}>>, ComponentDefinition<Readonly<{
+    name: string;
+    status: "error" | "pending" | "running" | "complete";
+    arguments?: Record<string, z.core.util.JSONType> | undefined;
+    result?: z.core.util.JSONType | undefined;
+}>>, ComponentDefinition<Readonly<{
+    title: string;
+    description: string;
+    approveLabel: string;
+    denyLabel: string;
+}>>, ComponentDefinition<Readonly<{
+    caption: string;
+    columns: Readonly<{
+        key: string;
+        label: string;
+    }>[];
+    rows: Record<string, string | number | boolean | null>[];
+}>>, ComponentDefinition<Readonly<{
+    name: string;
+    mimeType: string;
+    sizeBytes?: number | undefined;
+    url?: string | undefined;
+}>>];
+declare const STANDARD_COMPONENT_KEYS: readonly string[];
+declare const validateStandardComponentInteraction: (componentKey: string, props: unknown, event: string, value?: unknown) => boolean;
+
+type AskToolProjector = (event: AskToolEvent) => ComponentRenderFrame | undefined;
+type AskProjection = {
+    readonly kind: 'text';
+    readonly text: string;
+} | {
+    readonly kind: 'component';
+    readonly frame: ComponentRenderFrame;
+} | {
+    readonly kind: 'error';
+    readonly message: string;
+} | {
+    readonly kind: 'done';
+};
+interface AskAdapterOptions {
+    readonly endpoint?: string;
+    readonly corpus?: string;
+    readonly persona?: string;
+    readonly projectTool?: AskToolProjector;
+}
+interface AskMemoryOptions {
+    readonly key: string;
+    readonly legacyKeys?: readonly string[];
+    readonly maxMessages?: number;
+    readonly maxRecordBytes?: number;
+    readonly getStorage?: () => WebStorageLike | undefined;
+    readonly projectTool?: AskToolProjector;
+}
+
+/** Projects a validated Ask wire event into canonical ordered assistant content. */
+declare function projectAskEvent(event: AskEvent, projectTool?: AskToolProjector): AskProjection | undefined;
+declare function projectAskMessages(messages: readonly Message[]): Array<{
+    readonly role: 'user' | 'assistant';
+    readonly content: string;
+}>;
+/** Creates the shared Ask adapter without replacing the AgentsKit controller or message model. */
+declare function createAskAdapter(options?: AskAdapterOptions): AdapterFactory;
+/** Composes Ask legacy migration over the released, validated Web Storage ChatMemory. */
+declare function createAskSessionMemory({ key, legacyKeys, maxMessages, maxRecordBytes, getStorage, projectTool, }: AskMemoryOptions): ChatMemory;
+
+declare const normalizeDeterministicQuery: (value: string) => string;
+interface DeterministicAnswerResolver {
+    readonly resolve: (query: string) => AnswerResponse;
+    readonly resolveChoice: (choiceId: string, query: string) => AnswerResponse;
+}
+interface DeterministicAnswerResolverOptions {
+    readonly now?: () => number;
+    readonly expectedContentHash: string;
+    readonly expectedSiteId: string;
+}
+/** Builds a bounded exact-match index once; no semantic or probabilistic matching is performed. */
+declare const createDeterministicAnswerResolver: (artifactInput: VerifiedLocalKnowledgeArtifact | null, options: DeterministicAnswerResolverOptions) => DeterministicAnswerResolver;
+interface DeterministicAnswerAdapterOptions extends DeterministicAnswerResolverOptions {
+    readonly artifact: VerifiedLocalKnowledgeArtifact | null;
+    readonly fallbackMode: DeterministicSiteConfig['fallback']['mode'];
+    readonly fallback?: AdapterFactory;
+    readonly backend?: {
+        readonly provider?: string;
+        readonly model?: string;
+    };
+    readonly onDecision?: (decision: AnswerResponse) => void | Promise<void>;
+}
+interface DeterministicAnswerAdapter extends AdapterFactory {
+    readonly createSourceForSession: (request: AdapterRequest, sessionId: string) => StreamSource;
+    readonly releaseChoiceSession: (sessionId: string) => void;
+    readonly resolveChoiceSubmission: (frame: ComponentRenderFrame, choiceId: string, context: {
+        readonly sessionId: string;
+    }) => ChoiceSubmissionReservation | ChoiceSubmissionUnavailable | undefined;
+}
+/** Composes the local answer plane in front of an existing AgentsKit adapter. */
+declare const createDeterministicAnswerAdapter: (options: DeterministicAnswerAdapterOptions) => DeterministicAnswerAdapter;
+
+type ChatMessagePresentation = {
+    readonly kind: 'message';
+    readonly message: Message;
+} | {
+    readonly kind: 'component';
+    readonly frame: ComponentRenderFrame;
+} | {
+    readonly kind: 'diagnostic';
+    readonly code: string;
+    readonly message: string;
+};
+/** Decodes ordered assistant content and legacy direct component frames for every renderer. */
+declare const presentChatMessage: (message: Message) => readonly ChatMessagePresentation[];
+
+declare const ChatThemeSchema: z.ZodReadonly<z.ZodObject<{
+    colors: z.ZodReadonly<z.ZodObject<{
+        background: z.ZodString;
+        surface: z.ZodString;
+        border: z.ZodString;
+        text: z.ZodString;
+        muted: z.ZodString;
+        accent: z.ZodString;
+        onAccent: z.ZodString;
+        danger: z.ZodString;
+    }, z.core.$strict>>;
+    spacing: z.ZodReadonly<z.ZodObject<{
+        small: z.ZodNumber;
+        medium: z.ZodNumber;
+        large: z.ZodNumber;
+    }, z.core.$strict>>;
+    radius: z.ZodReadonly<z.ZodObject<{
+        medium: z.ZodNumber;
+        large: z.ZodNumber;
+    }, z.core.$strict>>;
+    fontFamily: z.ZodString;
+}, z.core.$strict>>;
+type ChatTheme = z.infer<typeof ChatThemeSchema>;
+type ChatThemeInput = {
+    readonly colors?: Partial<ChatTheme['colors']>;
+    readonly spacing?: Partial<ChatTheme['spacing']>;
+    readonly radius?: Partial<ChatTheme['radius']>;
+    readonly fontFamily?: string;
+};
+declare const defaultChatTheme: ChatTheme;
+declare const resolveChatTheme: (input?: unknown) => ChatTheme;
+declare const getLifecycleTargets: (messages: readonly Message[]) => {
+    readonly userId: string | undefined;
+    readonly assistantId: string | undefined;
+};
+interface TrustedActionContext {
+    readonly sessionId: string;
+    readonly capabilities: readonly string[];
+}
+type ActionPolicyReason = 'allowed' | 'missing-context' | 'session-mismatch' | 'action-unregistered' | 'missing-capability' | 'composed-policy-denied' | 'policy-failure';
+interface ActionPolicyTrace {
+    readonly id: string;
+    readonly toolCallId: string;
+    readonly action: string;
+    readonly phase: 'propose' | 'execute';
+    readonly decision: 'allow' | 'deny';
+    readonly reason: ActionPolicyReason;
+    readonly requiredCapabilities: readonly string[];
+    readonly timestamp: number;
+}
+interface ActionPolicy {
+    readonly authorizeToolCall: ToolAuthorizer;
+    readonly compose: (authorizer?: ToolAuthorizer) => ToolAuthorizer;
+    readonly getTrace: () => readonly ActionPolicyTrace[];
+}
+interface CapabilityPolicyOptions {
+    readonly sessionId: string;
+    readonly getContext: () => TrustedActionContext | undefined;
+    readonly requirements: Readonly<Record<string, readonly string[]>>;
+    readonly onTrace?: (trace: ActionPolicyTrace) => void | Promise<void>;
+    readonly now?: () => number;
+}
+declare const createCapabilityPolicy: ({ sessionId, getContext, requirements, onTrace, now }: CapabilityPolicyOptions) => ActionPolicy;
+declare const withActionPolicy: (chat: ChatConfig, policy: ActionPolicy) => ChatConfig;
+declare const resolveChoiceAction: (frame: ComponentRenderFrame, choiceId: string) => ChoiceAction | undefined;
+type ActionConfirmationStatus = 'pending' | 'approving' | 'rejecting' | 'expiring' | 'approved' | 'rejected' | 'expired';
+interface ActionConfirmation {
+    readonly token: string;
+    readonly sessionId: string;
+    readonly action: string;
+    readonly input: Readonly<Record<string, unknown>>;
+    readonly toolCallId: string;
+    readonly expiresAt: number;
+    readonly status: ActionConfirmationStatus;
+}
+interface ActionConfirmationCoordinator {
+    readonly propose: (action: ChoiceAction) => Promise<ActionConfirmation>;
+    readonly approve: (token: string, sessionId: string) => Promise<ActionConfirmation>;
+    readonly reject: (token: string, sessionId: string, reason?: string) => Promise<ActionConfirmation>;
+    readonly getByToolCall: (toolCallId: string) => ActionConfirmation | undefined;
+    readonly getSnapshot: () => readonly ActionConfirmation[];
+}
+interface ActionConfirmationOptions {
+    readonly sessionId: string;
+    readonly chat: Pick<ChatReturn, 'proposeToolCall' | 'approve' | 'deny'>;
+    readonly ttlMs?: number;
+    readonly now?: () => number;
+    readonly createId?: () => string;
+    readonly initialRecords?: readonly SessionConfirmation[];
+    readonly onChange?: (records: readonly ActionConfirmation[]) => void | Promise<void>;
+    readonly claimStatus?: (record: ActionConfirmation, status: Exclude<ActionConfirmationStatus, 'pending'>) => boolean | Promise<boolean>;
+}
+declare const createActionConfirmation: ({ sessionId, chat, ttlMs, now, createId, initialRecords, onChange, claimStatus, }: ActionConfirmationOptions) => ActionConfirmationCoordinator;
+type ComponentManifest = Readonly<Record<string, ComponentDefinition<unknown>>>;
+declare const defineComponentManifest: (components: readonly ComponentDefinition<unknown>[]) => ComponentManifest;
+type ResolveComponentFrameResult<T = unknown> = {
+    readonly ok: true;
+    readonly frame: ComponentRenderFrame;
+    readonly props: T;
+} | {
+    readonly ok: false;
+    readonly diagnostic: {
+        readonly code: 'COMPONENT_UNKNOWN' | 'COMPONENT_INVALID_PROPS' | _agentskit_chat_protocol.ComponentDecodeCode;
+        readonly message: string;
+        readonly retryable: false;
+    };
+};
+declare const resolveComponentFrame: (input: unknown, manifest: ComponentManifest) => ResolveComponentFrameResult;
+declare const createComponentInteraction: (frame: ComponentRenderFrame, manifest: ComponentManifest, event: string, value?: unknown) => ComponentInteractionEvent;
+declare const resolveComponentFallback: (input: unknown, manifest: ComponentManifest) => string | undefined;
+type ResolveChoiceListFrameResult = ResolveComponentFrameResult<ChoiceListProps>;
+declare const resolveChoiceListFrame: (input: unknown, manifest: ComponentManifest) => ResolveChoiceListFrameResult;
+declare const selectChoice: (frame: ComponentRenderFrame, choiceId: string) => ComponentSelectionEvent;
+type TurnTraceKind = 'deterministic' | 'agentic' | 'repaired' | 'fallback';
+interface TurnTrace {
+    readonly kind: TurnTraceKind;
+    readonly routeId?: string;
+    readonly fromState: string;
+    readonly toState: string;
+}
+interface ConversationStateDefinition {
+    readonly on?: Readonly<Record<string, string>>;
+    readonly actions?: readonly string[];
+}
+interface DeterministicRoute {
+    readonly id: string;
+    readonly event: string;
+    readonly states?: readonly string[];
+    readonly match: (input: string) => boolean;
+    readonly response: (input: string, context: DeterministicRouteContext) => string;
+    readonly traceKind?: Exclude<TurnTraceKind, 'agentic'>;
+}
+interface DeterministicRouteContext {
+    readonly sessionId: string;
+    readonly messageId?: string;
+}
+interface ConversationDefinition {
+    readonly initial: string;
+    readonly states: Readonly<Record<string, ConversationStateDefinition>>;
+    readonly routes: readonly DeterministicRoute[];
+    readonly onTrace?: (trace: TurnTrace) => void | Promise<void>;
+}
+interface ChatDefinition {
+    readonly id: string;
+    readonly revision?: number;
+    readonly chat: ChatConfig;
+    readonly conversation?: ConversationDefinition;
+    readonly components?: ComponentManifest;
+    readonly choiceSubmission?: (frame: ComponentRenderFrame, choiceId: string, context: {
+        readonly sessionId: string;
+    }) => ChoiceSubmissionReservation | ChoiceSubmissionUnavailable | undefined;
+}
+interface ChoiceSubmissionReservation {
+    readonly value: string;
+    readonly commit: () => void;
+    readonly release: () => void;
+}
+interface ChoiceSubmissionUnavailable {
+    readonly unavailable: true;
+}
+declare const defineChat: <const T extends ChatDefinition>(definition: T) => T;
+interface ConversationSnapshot {
+    readonly state: string;
+    readonly events: readonly string[];
+    readonly actions: readonly string[];
+}
+interface ChatSession {
+    readonly sessionId: string;
+    readonly definitionId: string;
+    readonly definitionRevision: number;
+    readonly chat: ChatConfig;
+    readonly updateChat: (chat: ChatConfig) => ChatConfig;
+    readonly getConversationSnapshot: () => ConversationSnapshot | undefined;
+    readonly createConfirmation: (options: Omit<ActionConfirmationOptions, 'sessionId' | 'initialRecords' | 'onChange' | 'claimStatus'>) => ActionConfirmationCoordinator;
+    readonly persist: (signal?: AbortSignal) => Promise<void>;
+    readonly getCursor: () => number;
+    readonly claimTurn: (turnId: string, leaseMs: number, signal?: AbortSignal) => Promise<boolean>;
+    readonly releaseTurn: (turnId: string, outcome: 'completed' | 'indeterminate', signal?: AbortSignal) => Promise<void>;
+}
+interface SessionStorage {
+    readonly load: (sessionId: string, signal?: AbortSignal) => unknown | Promise<unknown>;
+    readonly save: (snapshot: SessionSnapshot, expectedCursor: number | undefined, signal?: AbortSignal) => boolean | Promise<boolean>;
+    readonly delete?: (sessionId: string, signal?: AbortSignal) => void | Promise<void>;
+}
+interface ChatSessionOptions {
+    readonly sessionId?: string;
+    readonly snapshot?: SessionSnapshot;
+    readonly storage?: SessionStorage;
+    readonly now?: () => Date;
+    readonly signal?: AbortSignal;
+    readonly onConfirmationChange?: (records: readonly ActionConfirmation[]) => void | Promise<void>;
+}
+interface ResumeChatSessionOptions {
+    readonly sessionId: string;
+    readonly storage: SessionStorage;
+    readonly now?: () => Date;
+    readonly signal?: AbortSignal;
+}
+declare class SessionConflictError extends Error {
+    constructor();
+}
+declare const createChatSession: (definition: ChatDefinition, options?: ChatSessionOptions) => ChatSession;
+declare const resumeChatSession: (definition: ChatDefinition, options: ResumeChatSessionOptions) => Promise<ChatSession>;
+declare const resolveChatSession: (definition: ChatDefinition, session?: ChatSession) => ChatSession;
+declare const commandRoute: (options: Omit<DeterministicRoute, "match"> & {
+    readonly command: string;
+}) => DeterministicRoute;
+declare const SemanticFallbackSchema: z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodString;
+    summary: z.ZodString;
+}, z.core.$strip>>;
+type SemanticFallback = z.infer<typeof SemanticFallbackSchema>;
+declare const parseSemanticFallback: (input: unknown) => SemanticFallback;
+declare const formatSemanticFallback: (fallback: SemanticFallback) => string;
+
+export { type ActionConfirmation, type ActionConfirmationCoordinator, type ActionConfirmationOptions, type ActionConfirmationStatus, type ActionPolicy, type ActionPolicyReason, type ActionPolicyTrace, ApprovalRequestComponent, ApprovalRequestPropsSchema, type AskAdapterOptions, type AskMemoryOptions, type AskProjection, type AskToolProjector, ButtonGroupComponent, ButtonGroupPropsSchema, CHOICE_LIST_COMPONENT_KEY, type CapabilityPolicyOptions, type ChatDefinition, type ChatMessagePresentation, type ChatSession, type ChatSessionOptions, type ChatTheme, type ChatThemeInput, ChatThemeSchema, type ChoiceAction, ChoiceListComponent, type ChoiceListProps, ChoiceListPropsSchema, type ChoiceSubmissionReservation, type ChoiceSubmissionUnavailable, type ComponentAccessibilityDefinition, type ComponentCapability, type ComponentDefinition, type ComponentEventDefinition, type ComponentManifest, ConfirmationComponent, ConfirmationPropsSchema, type ConversationDefinition, type ConversationSnapshot, type ConversationStateDefinition, type DeterministicAnswerAdapter, type DeterministicAnswerAdapterOptions, type DeterministicAnswerResolver, type DeterministicAnswerResolverOptions, type DeterministicRoute, type DeterministicRouteContext, ErrorNoticeComponent, ErrorNoticePropsSchema, FileAttachmentComponent, FileAttachmentPropsSchema, FormComponent, FormPropsSchema, LinkCardComponent, LinkCardPropsSchema, ProgressComponent, ProgressPropsSchema, type ResolveChoiceListFrameResult, type ResolveComponentFrameResult, type ResumeChatSessionOptions, STANDARD_COMPONENT_KEYS, type SemanticFallback, SemanticFallbackSchema, SessionConflictError, type SessionStorage, SourceListComponent, SourceListPropsSchema, StandardComponentCatalog, TableComponent, TablePropsSchema, ToolCallComponent, ToolCallPropsSchema, type TrustedActionContext, type TurnTrace, type TurnTraceKind, commandRoute, createActionConfirmation, createAskAdapter, createAskSessionMemory, createCapabilityPolicy, createChatSession, createComponentInteraction, createDeterministicAnswerAdapter, createDeterministicAnswerResolver, defaultChatTheme, defineChat, defineComponentManifest, formatSemanticFallback, getLifecycleTargets, normalizeDeterministicQuery, parseSemanticFallback, presentChatMessage, projectAskEvent, projectAskMessages, resolveChatSession, resolveChatTheme, resolveChoiceAction, resolveChoiceListFrame, resolveComponentFallback, resolveComponentFrame, resumeChatSession, selectChoice, validateStandardComponentInteraction, withActionPolicy };