@agentskit/chat-protocol 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,697 @@
+import { Message, TokenUsage, MemoryRecord } from '@agentskit/core';
+import { z } from 'zod';
+
+declare const ASK_EVENT_MAX_BYTES = 1048576;
+declare const ASK_EVENT_MAX_RECORDS = 4096;
+declare const ASK_SERVICE_PROTOCOL_VERSION: 1;
+declare const AskEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    delta: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"tool">;
+    id: z.ZodString;
+    name: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    message: z.ZodString;
+}, z.core.$strict>], "type">;
+type AskEvent = z.infer<typeof AskEventSchema>;
+type AskToolEvent = Extract<AskEvent, {
+    readonly type: 'tool';
+}>;
+interface AskEventDecodeResult {
+    readonly events: readonly AskEvent[];
+    readonly rest: string;
+    readonly discardedPartial: boolean;
+}
+/** Decodes bounded complete v1 Ask NDJSON records and retains one bounded partial line. */
+declare function decodeAskEvents(buffer: string): AskEventDecodeResult;
+
+declare const DETERMINISTIC_SITE_PROTOCOL: "agentskit.chat.site";
+declare const DETERMINISTIC_SITE_PROTOCOL_VERSION: 1;
+declare const DETERMINISTIC_KNOWLEDGE_PROTOCOL: "agentskit.chat.knowledge";
+declare const DETERMINISTIC_KNOWLEDGE_PROTOCOL_VERSION: 1;
+declare const ANSWER_PROTOCOL: "agentskit.chat.answer";
+declare const ANSWER_PROTOCOL_VERSION: 1;
+declare const DETERMINISTIC_ARTIFACT_MAX_BYTES = 524288;
+declare const DETERMINISTIC_ARTIFACT_MAX_ENTRIES = 1024;
+declare const DETERMINISTIC_MATCH_MAX_VALUES = 16;
+declare const DETERMINISTIC_QUERY_MAX_CHARS = 512;
+declare const ANSWER_MAX_CITATIONS = 8;
+declare const ANSWER_MAX_SUGGESTIONS = 8;
+/** The canonical equality rule used by artifact producers and deterministic clients. */
+declare const normalizeKnowledgeKey: (value: string) => string;
+declare const DeterministicSiteConfigSchema: z.ZodReadonly<z.ZodObject<{
+    protocol: z.ZodLiteral<"agentskit.chat.site">;
+    version: z.ZodLiteral<1>;
+    siteId: z.ZodString;
+    artifact: z.ZodReadonly<z.ZodObject<{
+        href: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strip>>;
+    fallback: z.ZodReadonly<z.ZodObject<{
+        mode: z.ZodEnum<{
+            backend: "backend";
+            disabled: "disabled";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+declare const AnswerCitationSchema: z.ZodReadonly<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    href: z.ZodString;
+}, z.core.$strip>>;
+declare const DeterministicKnowledgeEntrySchema: z.ZodReadonly<z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        command: "command";
+        package: "package";
+        navigation: "navigation";
+        contribution: "contribution";
+        ecosystem: "ecosystem";
+        "restricted-faq": "restricted-faq";
+        document: "document";
+    }>;
+    label: z.ZodString;
+    match: z.ZodReadonly<z.ZodObject<{
+        type: z.ZodLiteral<"exact">;
+        values: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    answer: z.ZodReadonly<z.ZodObject<{
+        markdown: z.ZodString;
+        citations: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            href: z.ZodString;
+        }, z.core.$strip>>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+declare const LocalKnowledgeArtifactSchema: z.ZodReadonly<z.ZodObject<{
+    protocol: z.ZodLiteral<"agentskit.chat.knowledge">;
+    version: z.ZodLiteral<1>;
+    artifactId: z.ZodString;
+    siteId: z.ZodString;
+    contentHash: z.ZodString;
+    generatedAt: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    entries: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            command: "command";
+            package: "package";
+            navigation: "navigation";
+            contribution: "contribution";
+            ecosystem: "ecosystem";
+            "restricted-faq": "restricted-faq";
+            document: "document";
+        }>;
+        label: z.ZodString;
+        match: z.ZodReadonly<z.ZodObject<{
+            type: z.ZodLiteral<"exact">;
+            values: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        answer: z.ZodReadonly<z.ZodObject<{
+            markdown: z.ZodString;
+            citations: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                href: z.ZodString;
+            }, z.core.$strip>>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>>;
+declare const AnswerConfidenceSchema: z.ZodReadonly<z.ZodObject<{
+    level: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>;
+    basis: z.ZodEnum<{
+        exact: "exact";
+        backend: "backend";
+        ambiguous: "ambiguous";
+        miss: "miss";
+        stale: "stale";
+        corrupt: "corrupt";
+        offline: "offline";
+    }>;
+}, z.core.$strip>>;
+declare const AnswerSuggestionSchema: z.ZodReadonly<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>>;
+declare const AnswerResponseSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+    protocol: z.ZodLiteral<"agentskit.chat.answer">;
+    version: z.ZodLiteral<1>;
+    outcome: z.ZodLiteral<"answer">;
+    query: z.ZodString;
+    normalizedQuery: z.ZodString;
+    answer: z.ZodReadonly<z.ZodObject<{
+        markdown: z.ZodString;
+        citations: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            href: z.ZodString;
+        }, z.core.$strip>>>>;
+    }, z.core.$strip>>;
+    provenance: z.ZodUnion<readonly [z.ZodReadonly<z.ZodObject<{
+        source: z.ZodLiteral<"local">;
+        artifactId: z.ZodString;
+        contentHash: z.ZodString;
+        entryIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+        source: z.ZodLiteral<"backend">;
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>]>;
+    confidence: z.ZodReadonly<z.ZodObject<{
+        level: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        basis: z.ZodEnum<{
+            exact: "exact";
+            backend: "backend";
+            ambiguous: "ambiguous";
+            miss: "miss";
+            stale: "stale";
+            corrupt: "corrupt";
+            offline: "offline";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+    protocol: z.ZodLiteral<"agentskit.chat.answer">;
+    version: z.ZodLiteral<1>;
+    outcome: z.ZodLiteral<"choices">;
+    query: z.ZodString;
+    normalizedQuery: z.ZodString;
+    message: z.ZodString;
+    suggestions: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>>;
+    provenance: z.ZodReadonly<z.ZodObject<{
+        source: z.ZodLiteral<"local">;
+        artifactId: z.ZodString;
+        contentHash: z.ZodString;
+        entryIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    confidence: z.ZodReadonly<z.ZodObject<{
+        level: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        basis: z.ZodEnum<{
+            exact: "exact";
+            backend: "backend";
+            ambiguous: "ambiguous";
+            miss: "miss";
+            stale: "stale";
+            corrupt: "corrupt";
+            offline: "offline";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+    protocol: z.ZodLiteral<"agentskit.chat.answer">;
+    version: z.ZodLiteral<1>;
+    outcome: z.ZodLiteral<"escalation">;
+    query: z.ZodString;
+    normalizedQuery: z.ZodString;
+    message: z.ZodString;
+    reason: z.ZodEnum<{
+        miss: "miss";
+        stale: "stale";
+        corrupt: "corrupt";
+        offline: "offline";
+    }>;
+    candidateEntryIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    confidence: z.ZodReadonly<z.ZodObject<{
+        level: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        basis: z.ZodEnum<{
+            exact: "exact";
+            backend: "backend";
+            ambiguous: "ambiguous";
+            miss: "miss";
+            stale: "stale";
+            corrupt: "corrupt";
+            offline: "offline";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>], "outcome">;
+type DeterministicSiteConfig = z.infer<typeof DeterministicSiteConfigSchema>;
+type DeterministicKnowledgeEntry = z.infer<typeof DeterministicKnowledgeEntrySchema>;
+type LocalKnowledgeArtifact = z.infer<typeof LocalKnowledgeArtifactSchema>;
+type AnswerCitation = z.infer<typeof AnswerCitationSchema>;
+type AnswerResponse = z.infer<typeof AnswerResponseSchema>;
+type DeterministicDecodeCode = 'DETERMINISTIC_INVALID_PAYLOAD' | 'DETERMINISTIC_UNSUPPORTED_VERSION' | 'DETERMINISTIC_LIMIT_EXCEEDED' | 'DETERMINISTIC_HASH_MISMATCH';
+type DeterministicDecodeResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly diagnostic: {
+        readonly code: DeterministicDecodeCode;
+        readonly message: string;
+        readonly retryable: false;
+    };
+};
+declare const decodeDeterministicSiteConfig: (input: unknown) => DeterministicDecodeResult<DeterministicSiteConfig>;
+interface DecodeLocalKnowledgeArtifactOptions {
+    readonly expectedContentHash?: string;
+    readonly expectedSiteId?: string;
+}
+declare const decodeLocalKnowledgeArtifact: (input: unknown, options?: DecodeLocalKnowledgeArtifactOptions) => DeterministicDecodeResult<LocalKnowledgeArtifact>;
+declare const verifiedArtifact: unique symbol;
+type VerifiedLocalKnowledgeArtifact = LocalKnowledgeArtifact & {
+    readonly [verifiedArtifact]: true;
+};
+type LocalKnowledgeArtifactHashInput = Omit<LocalKnowledgeArtifact, 'contentHash'> & {
+    readonly contentHash?: string;
+};
+/** Serializes the accepted v1 fields in a fixed order; contentHash is excluded to avoid self-reference. */
+declare const canonicalizeLocalKnowledgeArtifact: (artifact: LocalKnowledgeArtifactHashInput) => string;
+declare const computeLocalKnowledgeArtifactContentHash: (artifactInput: LocalKnowledgeArtifactHashInput) => Promise<string>;
+interface VerifyLocalKnowledgeArtifactOptions extends DecodeLocalKnowledgeArtifactOptions {
+    readonly expectedContentHash: string;
+    readonly expectedSiteId: string;
+}
+declare const verifyLocalKnowledgeArtifactSync: (input: unknown, options: VerifyLocalKnowledgeArtifactOptions) => DeterministicDecodeResult<VerifiedLocalKnowledgeArtifact>;
+/** Validates bounds/schema/site and verifies both trusted and self-declared SHA-256 values. */
+declare const verifyLocalKnowledgeArtifact: (input: unknown, options: VerifyLocalKnowledgeArtifactOptions) => Promise<DeterministicDecodeResult<VerifiedLocalKnowledgeArtifact>>;
+declare const decodeAnswerResponse: (input: unknown) => DeterministicDecodeResult<AnswerResponse>;
+
+declare const TURN_PROTOCOL: "agentskit.chat.turn";
+declare const TURN_PROTOCOL_VERSION: 1;
+declare const COMPONENT_PROTOCOL: "agentskit.chat.component";
+declare const COMPONENT_PROTOCOL_VERSION: 1;
+declare const ASSISTANT_CONTENT_PROTOCOL: "agentskit.chat.content";
+declare const ASSISTANT_CONTENT_PROTOCOL_VERSION: 1;
+declare const ASSISTANT_CONTENT_PREFIX: "\u001Eagentskit.chat.content/1\n";
+declare const ASSISTANT_CONTENT_MAX_BYTES = 262144;
+declare const ASSISTANT_CONTENT_MAX_RECORDS = 512;
+declare const ComponentKeySchema: z.ZodString;
+declare const ComponentFallbackSchema: z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodString;
+    summary: z.ZodString;
+}, z.core.$strip>>;
+declare const ComponentRenderFrameSchema: z.ZodReadonly<z.ZodObject<{
+    protocol: z.ZodLiteral<"agentskit.chat.component">;
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"render">;
+    componentKey: z.ZodString;
+    instanceId: z.ZodString;
+    props: z.ZodUnknown;
+    fallback: z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodString;
+        summary: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+declare const ComponentSelectionEventSchema: z.ZodReadonly<z.ZodObject<{
+    protocol: z.ZodLiteral<"agentskit.chat.component">;
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"select">;
+    componentKey: z.ZodString;
+    instanceId: z.ZodString;
+    choiceId: z.ZodString;
+}, z.core.$strip>>;
+declare const ComponentInteractionEventSchema: z.ZodReadonly<z.ZodObject<{
+    protocol: z.ZodLiteral<"agentskit.chat.component">;
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"interact">;
+    componentKey: z.ZodString;
+    instanceId: z.ZodString;
+    event: z.ZodString;
+    value: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>>;
+type ComponentFallback = z.infer<typeof ComponentFallbackSchema>;
+type ComponentRenderFrame = z.infer<typeof ComponentRenderFrameSchema>;
+type ComponentSelectionEvent = z.infer<typeof ComponentSelectionEventSchema>;
+type ComponentInteractionEvent = z.infer<typeof ComponentInteractionEventSchema>;
+declare const AssistantTextPartSchema: z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strip>>;
+declare const AssistantComponentPartSchema: z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"component">;
+    frame: z.ZodReadonly<z.ZodObject<{
+        protocol: z.ZodLiteral<"agentskit.chat.component">;
+        version: z.ZodLiteral<1>;
+        type: z.ZodLiteral<"render">;
+        componentKey: z.ZodString;
+        instanceId: z.ZodString;
+        props: z.ZodUnknown;
+        fallback: z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodString;
+            summary: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+declare const AssistantContentPartSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strip>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"component">;
+    frame: z.ZodReadonly<z.ZodObject<{
+        protocol: z.ZodLiteral<"agentskit.chat.component">;
+        version: z.ZodLiteral<1>;
+        type: z.ZodLiteral<"render">;
+        componentKey: z.ZodString;
+        instanceId: z.ZodString;
+        props: z.ZodUnknown;
+        fallback: z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodString;
+            summary: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>], "kind">;
+type AssistantTextPart = z.infer<typeof AssistantTextPartSchema>;
+type AssistantComponentPart = z.infer<typeof AssistantComponentPartSchema>;
+type AssistantContentPart = z.infer<typeof AssistantContentPartSchema>;
+interface AssistantContentEncoder {
+    readonly encode: (part: AssistantContentPart) => string;
+}
+declare const createAssistantContentEncoder: () => AssistantContentEncoder;
+type AssistantContentDecodeCode = 'ASSISTANT_CONTENT_UNSUPPORTED_VERSION' | 'ASSISTANT_CONTENT_INVALID_RECORD' | 'ASSISTANT_CONTENT_LIMIT_EXCEEDED';
+type DecodeAssistantContentResult = {
+    readonly ok: true;
+    readonly parts: readonly AssistantContentPart[];
+    readonly complete: boolean;
+} | {
+    readonly ok: false;
+    readonly diagnostic: {
+        readonly code: AssistantContentDecodeCode;
+        readonly message: string;
+        readonly retryable: false;
+    };
+};
+declare const isAssistantContentCandidate: (input: unknown) => input is string;
+declare const decodeAssistantContent: (input: unknown) => DecodeAssistantContentResult;
+type ComponentDecodeCode = 'COMPONENT_UNSUPPORTED_VERSION' | 'COMPONENT_UNKNOWN_TYPE' | 'COMPONENT_INVALID_FRAME';
+type DecodeComponentFrameResult = {
+    readonly ok: true;
+    readonly frame: ComponentRenderFrame;
+} | {
+    readonly ok: false;
+    readonly diagnostic: {
+        readonly code: ComponentDecodeCode;
+        readonly message: string;
+        readonly retryable: false;
+    };
+};
+declare const decodeComponentFrame: (input: unknown) => DecodeComponentFrameResult;
+declare const isComponentFrameCandidate: (input: unknown) => boolean;
+declare const createSelectionEvent: (frame: ComponentRenderFrame, choiceId: string) => ComponentSelectionEvent;
+declare const createInteractionEvent: (frame: ComponentRenderFrame, event: string, value?: unknown) => ComponentInteractionEvent;
+declare const TokenUsageSchema: z.ZodObject<{
+    promptTokens: z.ZodNumber;
+    completionTokens: z.ZodNumber;
+    totalTokens: z.ZodNumber;
+}, z.core.$strip>;
+declare const TurnDiagnosticSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    code: z.ZodString;
+    message: z.ZodString;
+    retryable: z.ZodBoolean;
+}, z.core.$strip>;
+type TurnDiagnostic = z.infer<typeof TurnDiagnosticSchema>;
+declare const SubmitEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"client.turn.submit">;
+    payload: z.ZodObject<{
+        input: z.ZodString;
+    }, z.core.$strip>;
+    protocol: z.ZodLiteral<"agentskit.chat.turn">;
+    version: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+    sequence: z.ZodNumber;
+    emittedAt: z.ZodString;
+}, z.core.$strip>;
+declare const SnapshotEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"server.turn.snapshot">;
+    payload: z.ZodObject<{
+        messages: z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<(Omit<Message, "createdAt"> & {
+            createdAt: string;
+        })[], unknown[]>>;
+        status: z.ZodEnum<{
+            error: "error";
+            idle: "idle";
+            streaming: "streaming";
+            complete: "complete";
+        }>;
+        usage: z.ZodObject<{
+            promptTokens: z.ZodNumber;
+            completionTokens: z.ZodNumber;
+            totalTokens: z.ZodNumber;
+        }, z.core.$strip>;
+        error: z.ZodOptional<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            code: z.ZodString;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+        }, z.core.$strip>>;
+        lineage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            operation: z.ZodLiteral<"submit">;
+        }, z.core.$strip>, z.ZodObject<{
+            operation: z.ZodEnum<{
+                retry: "retry";
+                edit: "edit";
+                regenerate: "regenerate";
+            }>;
+            parentTurnId: z.ZodString;
+            sourceMessageId: z.ZodString;
+        }, z.core.$strip>], "operation">>;
+    }, z.core.$strip>;
+    protocol: z.ZodLiteral<"agentskit.chat.turn">;
+    version: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+    sequence: z.ZodNumber;
+    emittedAt: z.ZodString;
+}, z.core.$strip>;
+declare const DiagnosticEventSchema: z.ZodObject<{
+    event: z.ZodLiteral<"server.turn.diagnostic">;
+    payload: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        code: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+    }, z.core.$strip>;
+    protocol: z.ZodLiteral<"agentskit.chat.turn">;
+    version: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+    sequence: z.ZodNumber;
+    emittedAt: z.ZodString;
+}, z.core.$strip>;
+declare const TurnEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    event: z.ZodLiteral<"client.turn.submit">;
+    payload: z.ZodObject<{
+        input: z.ZodString;
+    }, z.core.$strip>;
+    protocol: z.ZodLiteral<"agentskit.chat.turn">;
+    version: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+    sequence: z.ZodNumber;
+    emittedAt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: z.ZodLiteral<"server.turn.snapshot">;
+    payload: z.ZodObject<{
+        messages: z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<(Omit<Message, "createdAt"> & {
+            createdAt: string;
+        })[], unknown[]>>;
+        status: z.ZodEnum<{
+            error: "error";
+            idle: "idle";
+            streaming: "streaming";
+            complete: "complete";
+        }>;
+        usage: z.ZodObject<{
+            promptTokens: z.ZodNumber;
+            completionTokens: z.ZodNumber;
+            totalTokens: z.ZodNumber;
+        }, z.core.$strip>;
+        error: z.ZodOptional<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            code: z.ZodString;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+        }, z.core.$strip>>;
+        lineage: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            operation: z.ZodLiteral<"submit">;
+        }, z.core.$strip>, z.ZodObject<{
+            operation: z.ZodEnum<{
+                retry: "retry";
+                edit: "edit";
+                regenerate: "regenerate";
+            }>;
+            parentTurnId: z.ZodString;
+            sourceMessageId: z.ZodString;
+        }, z.core.$strip>], "operation">>;
+    }, z.core.$strip>;
+    protocol: z.ZodLiteral<"agentskit.chat.turn">;
+    version: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+    sequence: z.ZodNumber;
+    emittedAt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event: z.ZodLiteral<"server.turn.diagnostic">;
+    payload: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        code: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+    }, z.core.$strip>;
+    protocol: z.ZodLiteral<"agentskit.chat.turn">;
+    version: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+    sequence: z.ZodNumber;
+    emittedAt: z.ZodString;
+}, z.core.$strip>], "event">;
+type TurnEvent = z.infer<typeof TurnEventSchema>;
+type WireMessage = MemoryRecord['messages'][number];
+type SubmitTurnEvent = z.infer<typeof SubmitEventSchema>;
+type SnapshotTurnEvent = z.infer<typeof SnapshotEventSchema>;
+type DiagnosticTurnEvent = z.infer<typeof DiagnosticEventSchema>;
+type TurnLineage = NonNullable<SnapshotTurnEvent['payload']['lineage']>;
+interface TurnSnapshotCursor {
+    readonly apply: (event: unknown) => boolean;
+    readonly getSnapshot: () => SnapshotTurnEvent | undefined;
+}
+interface CreateSnapshotEventOptions {
+    readonly eventId: string;
+    readonly sessionId: string;
+    readonly turnId: string;
+    readonly sequence: number;
+    readonly emittedAt: string;
+    readonly messages: readonly Message[];
+    readonly status: SnapshotTurnEvent['payload']['status'];
+    readonly usage: TokenUsage;
+    readonly lineage?: TurnLineage;
+    readonly error?: TurnDiagnostic;
+}
+declare const createSnapshotEvent: (options: CreateSnapshotEventOptions) => SnapshotTurnEvent;
+declare const createTurnSnapshotCursor: (sessionId: string) => TurnSnapshotCursor;
+type ProtocolDecodeCode = 'PROTOCOL_UNSUPPORTED_VERSION' | 'PROTOCOL_UNKNOWN_EVENT' | 'PROTOCOL_INVALID_PAYLOAD';
+interface ProtocolDecodeDiagnostic {
+    readonly code: ProtocolDecodeCode;
+    readonly message: string;
+    readonly retryable: false;
+    readonly eventId?: string;
+}
+type DecodeTurnEventResult = {
+    readonly ok: true;
+    readonly event: TurnEvent;
+} | {
+    readonly ok: false;
+    readonly diagnostic: ProtocolDecodeDiagnostic;
+};
+declare const decodeTurnEvent: (input: unknown) => DecodeTurnEventResult;
+declare const encodeTurnEvent: (event: TurnEvent) => string;
+declare const snapshotMessages: (event: unknown) => Message[];
+declare const SESSION_PROTOCOL: "agentskit.chat.session";
+declare const SESSION_PROTOCOL_VERSION: 1;
+declare const SessionConfirmationSchema: z.ZodReadonly<z.ZodObject<{
+    token: z.ZodString;
+    action: z.ZodString;
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    toolCallId: z.ZodString;
+    expiresAt: z.ZodNumber;
+    status: z.ZodEnum<{
+        pending: "pending";
+        approving: "approving";
+        rejecting: "rejecting";
+        expiring: "expiring";
+        approved: "approved";
+        rejected: "rejected";
+        expired: "expired";
+    }>;
+}, z.core.$strip>>;
+declare const SessionSnapshotSchema: z.ZodReadonly<z.ZodObject<{
+    protocol: z.ZodLiteral<"agentskit.chat.session">;
+    version: z.ZodLiteral<1>;
+    sessionId: z.ZodString;
+    definitionId: z.ZodString;
+    definitionRevision: z.ZodNumber;
+    updatedAt: z.ZodString;
+    cursor: z.ZodNumber;
+    activeTurn: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        turnId: z.ZodString;
+        expiresAt: z.ZodNumber;
+    }, z.core.$strip>>>;
+    terminalTurns: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        turnId: z.ZodString;
+        outcome: z.ZodEnum<{
+            completed: "completed";
+            indeterminate: "indeterminate";
+        }>;
+    }, z.core.$strip>>>>>;
+    conversation: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        state: z.ZodString;
+        decisions: z.ZodArray<z.ZodReadonly<z.ZodObject<{
+            messageId: z.ZodString;
+            input: z.ZodString;
+            routeId: z.ZodString;
+            kind: z.ZodEnum<{
+                fallback: "fallback";
+                deterministic: "deterministic";
+                repaired: "repaired";
+            }>;
+            content: z.ZodString;
+            fromState: z.ZodString;
+            toState: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    confirmations: z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        token: z.ZodString;
+        action: z.ZodString;
+        input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        toolCallId: z.ZodString;
+        expiresAt: z.ZodNumber;
+        status: z.ZodEnum<{
+            pending: "pending";
+            approving: "approving";
+            rejecting: "rejecting";
+            expiring: "expiring";
+            approved: "approved";
+            rejected: "rejected";
+            expired: "expired";
+        }>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>>;
+type SessionSnapshot = z.infer<typeof SessionSnapshotSchema>;
+type SessionConfirmation = z.infer<typeof SessionConfirmationSchema>;
+type DecodeSessionSnapshotResult = {
+    readonly ok: true;
+    readonly snapshot: SessionSnapshot;
+} | {
+    readonly ok: false;
+    readonly diagnostic: {
+        readonly code: 'SESSION_INVALID_SNAPSHOT' | 'SESSION_UNSUPPORTED_VERSION';
+        readonly message: string;
+        readonly retryable: false;
+    };
+};
+declare const decodeSessionSnapshot: (input: unknown) => DecodeSessionSnapshotResult;
+
+export { ANSWER_MAX_CITATIONS, ANSWER_MAX_SUGGESTIONS, ANSWER_PROTOCOL, ANSWER_PROTOCOL_VERSION, ASK_EVENT_MAX_BYTES, ASK_EVENT_MAX_RECORDS, ASK_SERVICE_PROTOCOL_VERSION, ASSISTANT_CONTENT_MAX_BYTES, ASSISTANT_CONTENT_MAX_RECORDS, ASSISTANT_CONTENT_PREFIX, ASSISTANT_CONTENT_PROTOCOL, ASSISTANT_CONTENT_PROTOCOL_VERSION, type AnswerCitation, AnswerCitationSchema, AnswerConfidenceSchema, type AnswerResponse, AnswerResponseSchema, AnswerSuggestionSchema, type AskEvent, type AskEventDecodeResult, AskEventSchema, type AskToolEvent, type AssistantComponentPart, AssistantComponentPartSchema, type AssistantContentDecodeCode, type AssistantContentEncoder, type AssistantContentPart, AssistantContentPartSchema, type AssistantTextPart, AssistantTextPartSchema, COMPONENT_PROTOCOL, COMPONENT_PROTOCOL_VERSION, type ComponentDecodeCode, type ComponentFallback, ComponentFallbackSchema, type ComponentInteractionEvent, ComponentInteractionEventSchema, ComponentKeySchema, type ComponentRenderFrame, ComponentRenderFrameSchema, type ComponentSelectionEvent, ComponentSelectionEventSchema, type CreateSnapshotEventOptions, DETERMINISTIC_ARTIFACT_MAX_BYTES, DETERMINISTIC_ARTIFACT_MAX_ENTRIES, DETERMINISTIC_KNOWLEDGE_PROTOCOL, DETERMINISTIC_KNOWLEDGE_PROTOCOL_VERSION, DETERMINISTIC_MATCH_MAX_VALUES, DETERMINISTIC_QUERY_MAX_CHARS, DETERMINISTIC_SITE_PROTOCOL, DETERMINISTIC_SITE_PROTOCOL_VERSION, type DecodeAssistantContentResult, type DecodeComponentFrameResult, type DecodeLocalKnowledgeArtifactOptions, type DecodeSessionSnapshotResult, type DecodeTurnEventResult, type DeterministicDecodeCode, type DeterministicDecodeResult, type DeterministicKnowledgeEntry, DeterministicKnowledgeEntrySchema, type DeterministicSiteConfig, DeterministicSiteConfigSchema, type DiagnosticTurnEvent, type LocalKnowledgeArtifact, type LocalKnowledgeArtifactHashInput, LocalKnowledgeArtifactSchema, type ProtocolDecodeCode, type ProtocolDecodeDiagnostic, SESSION_PROTOCOL, SESSION_PROTOCOL_VERSION, type SessionConfirmation, SessionConfirmationSchema, type SessionSnapshot, SessionSnapshotSchema, type SnapshotTurnEvent, type SubmitTurnEvent, TURN_PROTOCOL, TURN_PROTOCOL_VERSION, TokenUsageSchema, type TurnDiagnostic, TurnDiagnosticSchema, type TurnEvent, TurnEventSchema, type TurnLineage, type TurnSnapshotCursor, type VerifiedLocalKnowledgeArtifact, type VerifyLocalKnowledgeArtifactOptions, type WireMessage, canonicalizeLocalKnowledgeArtifact, computeLocalKnowledgeArtifactContentHash, createAssistantContentEncoder, createInteractionEvent, createSelectionEvent, createSnapshotEvent, createTurnSnapshotCursor, decodeAnswerResponse, decodeAskEvents, decodeAssistantContent, decodeComponentFrame, decodeDeterministicSiteConfig, decodeLocalKnowledgeArtifact, decodeSessionSnapshot, decodeTurnEvent, encodeTurnEvent, isAssistantContentCandidate, isComponentFrameCandidate, normalizeKnowledgeKey, snapshotMessages, verifyLocalKnowledgeArtifact, verifyLocalKnowledgeArtifactSync };