@agentskit/chat-protocol 0.1.0

package/dist/fixtures.d.cts

@@ -0,0 +1,884 @@
+import { ProtocolDecodeCode, TurnEvent } from './index.cjs';
+import '@agentskit/core';
+import 'zod';
+
+interface TurnEventFixture {
+    readonly name: string;
+    readonly event: TurnEvent;
+}
+interface InvalidTurnEventFixture {
+    readonly name: string;
+    readonly event: unknown;
+    readonly code: ProtocolDecodeCode;
+}
+declare const validTurnEventFixtures: readonly [{
+    readonly name: "submit";
+    readonly event: {
+        readonly eventId: "event-submit";
+        readonly sequence: 0;
+        readonly event: "client.turn.submit";
+        readonly payload: {
+            readonly input: "hello";
+        };
+        readonly protocol: "agentskit.chat.turn";
+        readonly version: 1;
+        readonly sessionId: "session-conformance";
+        readonly turnId: "turn-conformance";
+        readonly emittedAt: "2026-07-11T03:00:00.000Z";
+    };
+}, {
+    readonly name: "idle snapshot";
+    readonly event: {
+        readonly eventId: "event-idle";
+        readonly sequence: 1;
+        readonly event: "server.turn.snapshot";
+        readonly payload: {
+            readonly status: "idle";
+            readonly usage: {
+                readonly promptTokens: 0;
+                readonly completionTokens: 0;
+                readonly totalTokens: 0;
+            };
+            readonly messages: [];
+        };
+        readonly protocol: "agentskit.chat.turn";
+        readonly version: 1;
+        readonly sessionId: "session-conformance";
+        readonly turnId: "turn-conformance";
+        readonly emittedAt: "2026-07-11T03:00:00.000Z";
+    };
+}, {
+    readonly name: "streaming snapshot";
+    readonly event: {
+        readonly eventId: "event-streaming";
+        readonly sequence: 2;
+        readonly event: "server.turn.snapshot";
+        readonly payload: {
+            readonly status: "streaming";
+            readonly lineage: {
+                readonly operation: "submit";
+            };
+            readonly usage: {
+                readonly promptTokens: 2;
+                readonly completionTokens: 1;
+                readonly totalTokens: 3;
+            };
+            readonly messages: [{
+                readonly id: "message-assistant";
+                readonly role: "assistant";
+                readonly content: "AgentsKit";
+                readonly status: "streaming";
+                readonly createdAt: "2026-07-11T03:00:00.000Z";
+            }];
+        };
+        readonly protocol: "agentskit.chat.turn";
+        readonly version: 1;
+        readonly sessionId: "session-conformance";
+        readonly turnId: "turn-conformance";
+        readonly emittedAt: "2026-07-11T03:00:00.000Z";
+    };
+}, {
+    readonly name: "complete snapshot with tool call";
+    readonly event: {
+        readonly eventId: "event-complete";
+        readonly sequence: 3;
+        readonly event: "server.turn.snapshot";
+        readonly payload: {
+            readonly status: "complete";
+            readonly lineage: {
+                readonly operation: "regenerate";
+                readonly parentTurnId: "turn-previous";
+                readonly sourceMessageId: "message-assistant";
+            };
+            readonly usage: {
+                readonly promptTokens: 2;
+                readonly completionTokens: 3;
+                readonly totalTokens: 5;
+            };
+            readonly messages: [{
+                readonly id: "message-assistant";
+                readonly role: "assistant";
+                readonly content: "AgentsKit received: hello";
+                readonly status: "complete";
+                readonly toolCalls: [{
+                    readonly id: "tool-call-1";
+                    readonly name: "lookup";
+                    readonly args: {
+                        readonly query: "hello";
+                    };
+                    readonly result: "found";
+                    readonly status: "complete";
+                }];
+                readonly createdAt: "2026-07-11T03:00:01.000Z";
+            }];
+        };
+        readonly protocol: "agentskit.chat.turn";
+        readonly version: 1;
+        readonly sessionId: "session-conformance";
+        readonly turnId: "turn-conformance";
+        readonly emittedAt: "2026-07-11T03:00:00.000Z";
+    };
+}, {
+    readonly name: "diagnostic";
+    readonly event: {
+        readonly eventId: "event-diagnostic";
+        readonly sequence: 4;
+        readonly event: "server.turn.diagnostic";
+        readonly payload: {
+            readonly version: 1;
+            readonly code: "ADAPTER_FAILED";
+            readonly message: "The adapter failed.";
+            readonly retryable: false;
+        };
+        readonly protocol: "agentskit.chat.turn";
+        readonly version: 1;
+        readonly sessionId: "session-conformance";
+        readonly turnId: "turn-conformance";
+        readonly emittedAt: "2026-07-11T03:00:00.000Z";
+    };
+}, {
+    readonly name: "error snapshot";
+    readonly event: {
+        readonly eventId: "event-error";
+        readonly sequence: 5;
+        readonly event: "server.turn.snapshot";
+        readonly payload: {
+            readonly status: "error";
+            readonly usage: {
+                readonly promptTokens: 2;
+                readonly completionTokens: 0;
+                readonly totalTokens: 2;
+            };
+            readonly messages: [];
+            readonly error: {
+                readonly version: 1;
+                readonly code: "ADAPTER_FAILED";
+                readonly message: "The adapter failed.";
+                readonly retryable: false;
+            };
+        };
+        readonly protocol: "agentskit.chat.turn";
+        readonly version: 1;
+        readonly sessionId: "session-conformance";
+        readonly turnId: "turn-conformance";
+        readonly emittedAt: "2026-07-11T03:00:00.000Z";
+    };
+}];
+declare const invalidTurnEventFixtures: readonly [{
+    readonly name: "invalid payload";
+    readonly event: null;
+    readonly code: "PROTOCOL_INVALID_PAYLOAD";
+}, {
+    readonly name: "unknown version";
+    readonly event: {
+        readonly eventId: "future";
+        readonly version: 2;
+        readonly sequence: 0;
+        readonly event: "client.turn.submit";
+        readonly payload: {
+            readonly input: "hello";
+        };
+        readonly protocol: "agentskit.chat.turn";
+        readonly sessionId: "session-conformance";
+        readonly turnId: "turn-conformance";
+        readonly emittedAt: "2026-07-11T03:00:00.000Z";
+    };
+    readonly code: "PROTOCOL_UNSUPPORTED_VERSION";
+}, {
+    readonly name: "unknown event";
+    readonly event: {
+        readonly eventId: "unknown";
+        readonly sequence: 0;
+        readonly event: "server.turn.future";
+        readonly payload: {};
+        readonly protocol: "agentskit.chat.turn";
+        readonly version: 1;
+        readonly sessionId: "session-conformance";
+        readonly turnId: "turn-conformance";
+        readonly emittedAt: "2026-07-11T03:00:00.000Z";
+    };
+    readonly code: "PROTOCOL_UNKNOWN_EVENT";
+}, {
+    readonly name: "blank input";
+    readonly event: {
+        readonly eventId: "blank";
+        readonly sequence: 0;
+        readonly event: "client.turn.submit";
+        readonly payload: {
+            readonly input: "   ";
+        };
+        readonly protocol: "agentskit.chat.turn";
+        readonly version: 1;
+        readonly sessionId: "session-conformance";
+        readonly turnId: "turn-conformance";
+        readonly emittedAt: "2026-07-11T03:00:00.000Z";
+    };
+    readonly code: "PROTOCOL_INVALID_PAYLOAD";
+}];
+declare const validChoiceListFrame: {
+    readonly protocol: "agentskit.chat.component";
+    readonly version: 1;
+    readonly type: "render";
+    readonly componentKey: "choice-list";
+    readonly instanceId: "destination-choice";
+    readonly props: {
+        readonly prompt: "Where should we go?";
+        readonly choices: readonly [{
+            readonly id: "docs";
+            readonly label: "Documentation";
+            readonly description: "Read the component guide.";
+        }, {
+            readonly id: "demo";
+            readonly label: "Demo";
+        }];
+    };
+    readonly fallback: {
+        readonly kind: "choice-list";
+        readonly summary: "Choose Documentation or Demo.";
+    };
+};
+declare const standardComponentFrameFixtures: readonly [Readonly<{
+    protocol: "agentskit.chat.component";
+    version: 1;
+    type: "render";
+    componentKey: string;
+    instanceId: string;
+    props: unknown;
+    fallback: Readonly<{
+        kind: string;
+        summary: string;
+    }>;
+}>, {
+    readonly protocol: "agentskit.chat.component";
+    readonly version: 1;
+    readonly type: "render";
+    readonly componentKey: "choice-list";
+    readonly instanceId: "destination-choice";
+    readonly props: {
+        readonly prompt: "Where should we go?";
+        readonly choices: readonly [{
+            readonly id: "docs";
+            readonly label: "Documentation";
+            readonly description: "Read the component guide.";
+        }, {
+            readonly id: "demo";
+            readonly label: "Demo";
+        }];
+    };
+    readonly fallback: {
+        readonly kind: "choice-list";
+        readonly summary: "Choose Documentation or Demo.";
+    };
+}, Readonly<{
+    protocol: "agentskit.chat.component";
+    version: 1;
+    type: "render";
+    componentKey: string;
+    instanceId: string;
+    props: unknown;
+    fallback: Readonly<{
+        kind: string;
+        summary: string;
+    }>;
+}>, Readonly<{
+    protocol: "agentskit.chat.component";
+    version: 1;
+    type: "render";
+    componentKey: string;
+    instanceId: string;
+    props: unknown;
+    fallback: Readonly<{
+        kind: string;
+        summary: string;
+    }>;
+}>, Readonly<{
+    protocol: "agentskit.chat.component";
+    version: 1;
+    type: "render";
+    componentKey: string;
+    instanceId: string;
+    props: unknown;
+    fallback: Readonly<{
+        kind: string;
+        summary: string;
+    }>;
+}>, Readonly<{
+    protocol: "agentskit.chat.component";
+    version: 1;
+    type: "render";
+    componentKey: string;
+    instanceId: string;
+    props: unknown;
+    fallback: Readonly<{
+        kind: string;
+        summary: string;
+    }>;
+}>, Readonly<{
+    protocol: "agentskit.chat.component";
+    version: 1;
+    type: "render";
+    componentKey: string;
+    instanceId: string;
+    props: unknown;
+    fallback: Readonly<{
+        kind: string;
+        summary: string;
+    }>;
+}>, Readonly<{
+    protocol: "agentskit.chat.component";
+    version: 1;
+    type: "render";
+    componentKey: string;
+    instanceId: string;
+    props: unknown;
+    fallback: Readonly<{
+        kind: string;
+        summary: string;
+    }>;
+}>, Readonly<{
+    protocol: "agentskit.chat.component";
+    version: 1;
+    type: "render";
+    componentKey: string;
+    instanceId: string;
+    props: unknown;
+    fallback: Readonly<{
+        kind: string;
+        summary: string;
+    }>;
+}>, Readonly<{
+    protocol: "agentskit.chat.component";
+    version: 1;
+    type: "render";
+    componentKey: string;
+    instanceId: string;
+    props: unknown;
+    fallback: Readonly<{
+        kind: string;
+        summary: string;
+    }>;
+}>, Readonly<{
+    protocol: "agentskit.chat.component";
+    version: 1;
+    type: "render";
+    componentKey: string;
+    instanceId: string;
+    props: unknown;
+    fallback: Readonly<{
+        kind: string;
+        summary: string;
+    }>;
+}>, Readonly<{
+    protocol: "agentskit.chat.component";
+    version: 1;
+    type: "render";
+    componentKey: string;
+    instanceId: string;
+    props: unknown;
+    fallback: Readonly<{
+        kind: string;
+        summary: string;
+    }>;
+}>];
+declare const invalidChoiceListPropsFrame: {
+    readonly props: {
+        readonly prompt: "";
+        readonly choices: readonly [];
+    };
+    readonly protocol: "agentskit.chat.component";
+    readonly version: 1;
+    readonly type: "render";
+    readonly componentKey: "choice-list";
+    readonly instanceId: "destination-choice";
+    readonly fallback: {
+        readonly kind: "choice-list";
+        readonly summary: "Choose Documentation or Demo.";
+    };
+};
+declare const unknownComponentFrame: {
+    readonly componentKey: "future-component";
+    readonly protocol: "agentskit.chat.component";
+    readonly version: 1;
+    readonly type: "render";
+    readonly instanceId: "destination-choice";
+    readonly props: {
+        readonly prompt: "Where should we go?";
+        readonly choices: readonly [{
+            readonly id: "docs";
+            readonly label: "Documentation";
+            readonly description: "Read the component guide.";
+        }, {
+            readonly id: "demo";
+            readonly label: "Demo";
+        }];
+    };
+    readonly fallback: {
+        readonly kind: "choice-list";
+        readonly summary: "Choose Documentation or Demo.";
+    };
+};
+declare const invalidComponentFrameFixtures: readonly [{
+    readonly name: "invalid frame";
+    readonly frame: null;
+    readonly code: "COMPONENT_INVALID_FRAME";
+}, {
+    readonly name: "unsupported version";
+    readonly frame: {
+        readonly version: 2;
+        readonly protocol: "agentskit.chat.component";
+        readonly type: "render";
+        readonly componentKey: "choice-list";
+        readonly instanceId: "destination-choice";
+        readonly props: {
+            readonly prompt: "Where should we go?";
+            readonly choices: readonly [{
+                readonly id: "docs";
+                readonly label: "Documentation";
+                readonly description: "Read the component guide.";
+            }, {
+                readonly id: "demo";
+                readonly label: "Demo";
+            }];
+        };
+        readonly fallback: {
+            readonly kind: "choice-list";
+            readonly summary: "Choose Documentation or Demo.";
+        };
+    };
+    readonly code: "COMPONENT_UNSUPPORTED_VERSION";
+}, {
+    readonly name: "unknown type";
+    readonly frame: {
+        readonly type: "future";
+        readonly protocol: "agentskit.chat.component";
+        readonly version: 1;
+        readonly componentKey: "choice-list";
+        readonly instanceId: "destination-choice";
+        readonly props: {
+            readonly prompt: "Where should we go?";
+            readonly choices: readonly [{
+                readonly id: "docs";
+                readonly label: "Documentation";
+                readonly description: "Read the component guide.";
+            }, {
+                readonly id: "demo";
+                readonly label: "Demo";
+            }];
+        };
+        readonly fallback: {
+            readonly kind: "choice-list";
+            readonly summary: "Choose Documentation or Demo.";
+        };
+    };
+    readonly code: "COMPONENT_UNKNOWN_TYPE";
+}];
+declare const persistentSessionFixture: {
+    readonly protocol: "agentskit.chat.session";
+    readonly version: 1;
+    readonly sessionId: "cross-client";
+    readonly definitionId: "protocol-session";
+    readonly definitionRevision: 1;
+    readonly updatedAt: "2026-07-11T00:00:00.000Z";
+    readonly cursor: 1;
+    readonly conversation: {
+        readonly state: "complete";
+        readonly decisions: [];
+    };
+    readonly confirmations: [];
+};
+declare const deterministicContentHashFixture: "sha256:d1b98e69dcb00985dc5fdad4a8475f926168e6485e85716758ad5e0f35cd4906";
+declare const deterministicSiteConfigFixture: {
+    readonly protocol: "agentskit.chat.site";
+    readonly version: 1;
+    readonly siteId: "agentskit-docs";
+    readonly artifact: {
+        readonly href: "/agentskit-chat.knowledge.json";
+        readonly contentHash: "sha256:d1b98e69dcb00985dc5fdad4a8475f926168e6485e85716758ad5e0f35cd4906";
+    };
+    readonly fallback: {
+        readonly mode: "backend";
+    };
+};
+declare const localKnowledgeArtifactFixture: {
+    readonly protocol: "agentskit.chat.knowledge";
+    readonly version: 1;
+    readonly artifactId: "agentskit-docs-2026-07-13";
+    readonly siteId: "agentskit-docs";
+    readonly contentHash: "sha256:d1b98e69dcb00985dc5fdad4a8475f926168e6485e85716758ad5e0f35cd4906";
+    readonly generatedAt: "2026-07-13T00:00:00.000Z";
+    readonly expiresAt: "2026-07-14T00:00:00.000Z";
+    readonly entries: readonly [{
+        readonly id: "install-cli";
+        readonly kind: "command";
+        readonly label: "Install the CLI";
+        readonly match: {
+            readonly type: "exact";
+            readonly values: readonly ["install cli", "npm install agentskit"];
+        };
+        readonly answer: {
+            readonly markdown: "Run `npm install agentskit`.";
+            readonly citations: readonly [{
+                readonly id: "quickstart";
+                readonly title: "Quickstart";
+                readonly href: "/docs/quickstart";
+            }];
+        };
+    }, {
+        readonly id: "docs-agentskit";
+        readonly kind: "document";
+        readonly label: "AgentsKit documentation";
+        readonly match: {
+            readonly type: "exact";
+            readonly values: readonly ["docs", "agentskit docs"];
+        };
+        readonly answer: {
+            readonly markdown: "Open the AgentsKit documentation.";
+            readonly citations: readonly [{
+                readonly id: "agentskit-docs";
+                readonly title: "AgentsKit docs";
+                readonly href: "https://agentskit.io/docs";
+            }];
+        };
+    }, {
+        readonly id: "docs-registry";
+        readonly kind: "document";
+        readonly label: "Registry documentation";
+        readonly match: {
+            readonly type: "exact";
+            readonly values: readonly ["docs", "registry docs"];
+        };
+        readonly answer: {
+            readonly markdown: "Open the Registry documentation.";
+            readonly citations: readonly [{
+                readonly id: "registry-docs";
+                readonly title: "Registry docs";
+                readonly href: "https://registry.agentskit.io";
+            }];
+        };
+    }];
+};
+declare const staleLocalKnowledgeArtifactFixture: {
+    readonly artifactId: "agentskit-docs-stale";
+    readonly contentHash: "sha256:c48a310e9497d1588e408bf7eb72ca64c04f25431ef8d17cd351b1d3bab3a3e9";
+    readonly generatedAt: "2026-07-11T00:00:00.000Z";
+    readonly expiresAt: "2026-07-12T00:00:00.000Z";
+    readonly protocol: "agentskit.chat.knowledge";
+    readonly version: 1;
+    readonly siteId: "agentskit-docs";
+    readonly entries: readonly [{
+        readonly id: "install-cli";
+        readonly kind: "command";
+        readonly label: "Install the CLI";
+        readonly match: {
+            readonly type: "exact";
+            readonly values: readonly ["install cli", "npm install agentskit"];
+        };
+        readonly answer: {
+            readonly markdown: "Run `npm install agentskit`.";
+            readonly citations: readonly [{
+                readonly id: "quickstart";
+                readonly title: "Quickstart";
+                readonly href: "/docs/quickstart";
+            }];
+        };
+    }, {
+        readonly id: "docs-agentskit";
+        readonly kind: "document";
+        readonly label: "AgentsKit documentation";
+        readonly match: {
+            readonly type: "exact";
+            readonly values: readonly ["docs", "agentskit docs"];
+        };
+        readonly answer: {
+            readonly markdown: "Open the AgentsKit documentation.";
+            readonly citations: readonly [{
+                readonly id: "agentskit-docs";
+                readonly title: "AgentsKit docs";
+                readonly href: "https://agentskit.io/docs";
+            }];
+        };
+    }, {
+        readonly id: "docs-registry";
+        readonly kind: "document";
+        readonly label: "Registry documentation";
+        readonly match: {
+            readonly type: "exact";
+            readonly values: readonly ["docs", "registry docs"];
+        };
+        readonly answer: {
+            readonly markdown: "Open the Registry documentation.";
+            readonly citations: readonly [{
+                readonly id: "registry-docs";
+                readonly title: "Registry docs";
+                readonly href: "https://registry.agentskit.io";
+            }];
+        };
+    }];
+};
+declare const deterministicAnswerFixtures: {
+    readonly local: {
+        readonly protocol: "agentskit.chat.answer";
+        readonly version: 1;
+        readonly outcome: "answer";
+        readonly query: "Install CLI";
+        readonly normalizedQuery: "install cli";
+        readonly answer: {
+            readonly markdown: "Run `npm install agentskit`.";
+            readonly citations: readonly [{
+                readonly id: "quickstart";
+                readonly title: "Quickstart";
+                readonly href: "/docs/quickstart";
+            }];
+        };
+        readonly provenance: {
+            readonly source: "local";
+            readonly artifactId: "agentskit-docs-2026-07-13";
+            readonly contentHash: "sha256:d1b98e69dcb00985dc5fdad4a8475f926168e6485e85716758ad5e0f35cd4906";
+            readonly entryIds: readonly ["install-cli"];
+        };
+        readonly confidence: {
+            readonly level: "high";
+            readonly basis: "exact";
+        };
+    };
+    readonly backend: {
+        readonly protocol: "agentskit.chat.answer";
+        readonly version: 1;
+        readonly outcome: "answer";
+        readonly query: "Compare runtimes";
+        readonly normalizedQuery: "compare runtimes";
+        readonly answer: {
+            readonly markdown: "The backend can answer open-ended comparisons.";
+            readonly citations: readonly [];
+        };
+        readonly provenance: {
+            readonly source: "backend";
+            readonly provider: "ask";
+            readonly model: "configured-by-host";
+        };
+        readonly confidence: {
+            readonly level: "high";
+            readonly basis: "backend";
+        };
+    };
+    readonly ambiguous: {
+        readonly protocol: "agentskit.chat.answer";
+        readonly version: 1;
+        readonly outcome: "choices";
+        readonly query: "docs";
+        readonly normalizedQuery: "docs";
+        readonly message: "More than one exact local answer matches. Choose one to continue.";
+        readonly suggestions: readonly [{
+            readonly id: "docs-agentskit";
+            readonly label: "AgentsKit documentation";
+            readonly value: "agentskit docs";
+        }, {
+            readonly id: "docs-registry";
+            readonly label: "Registry documentation";
+            readonly value: "registry docs";
+        }];
+        readonly provenance: {
+            readonly source: "local";
+            readonly artifactId: "agentskit-docs-2026-07-13";
+            readonly contentHash: "sha256:d1b98e69dcb00985dc5fdad4a8475f926168e6485e85716758ad5e0f35cd4906";
+            readonly entryIds: readonly ["docs-agentskit", "docs-registry"];
+        };
+        readonly confidence: {
+            readonly level: "medium";
+            readonly basis: "ambiguous";
+        };
+    };
+    readonly miss: {
+        readonly protocol: "agentskit.chat.answer";
+        readonly version: 1;
+        readonly outcome: "escalation";
+        readonly query: "Why?";
+        readonly normalizedQuery: "why?";
+        readonly message: "No exact local answer was found. A backend answer is required.";
+        readonly reason: "miss";
+        readonly confidence: {
+            readonly level: "low";
+            readonly basis: "miss";
+        };
+    };
+    readonly stale: {
+        readonly protocol: "agentskit.chat.answer";
+        readonly version: 1;
+        readonly outcome: "escalation";
+        readonly query: "install cli";
+        readonly normalizedQuery: "install cli";
+        readonly message: "Local knowledge is stale. A backend answer is required.";
+        readonly reason: "stale";
+        readonly confidence: {
+            readonly level: "low";
+            readonly basis: "stale";
+        };
+    };
+    readonly corrupt: {
+        readonly protocol: "agentskit.chat.answer";
+        readonly version: 1;
+        readonly outcome: "escalation";
+        readonly query: "install cli";
+        readonly normalizedQuery: "install cli";
+        readonly message: "Local knowledge is corrupt. A backend answer is required.";
+        readonly reason: "corrupt";
+        readonly confidence: {
+            readonly level: "low";
+            readonly basis: "corrupt";
+        };
+    };
+    readonly offline: {
+        readonly protocol: "agentskit.chat.answer";
+        readonly version: 1;
+        readonly outcome: "escalation";
+        readonly query: "Why?";
+        readonly normalizedQuery: "why?";
+        readonly message: "This question needs the backend, which is not available.";
+        readonly reason: "offline";
+        readonly confidence: {
+            readonly level: "low";
+            readonly basis: "offline";
+        };
+    };
+};
+declare const invalidDeterministicArtifactFixtures: readonly [{
+    readonly name: "unsupported version";
+    readonly artifact: {
+        readonly version: 2;
+        readonly protocol: "agentskit.chat.knowledge";
+        readonly artifactId: "agentskit-docs-2026-07-13";
+        readonly siteId: "agentskit-docs";
+        readonly contentHash: "sha256:d1b98e69dcb00985dc5fdad4a8475f926168e6485e85716758ad5e0f35cd4906";
+        readonly generatedAt: "2026-07-13T00:00:00.000Z";
+        readonly expiresAt: "2026-07-14T00:00:00.000Z";
+        readonly entries: readonly [{
+            readonly id: "install-cli";
+            readonly kind: "command";
+            readonly label: "Install the CLI";
+            readonly match: {
+                readonly type: "exact";
+                readonly values: readonly ["install cli", "npm install agentskit"];
+            };
+            readonly answer: {
+                readonly markdown: "Run `npm install agentskit`.";
+                readonly citations: readonly [{
+                    readonly id: "quickstart";
+                    readonly title: "Quickstart";
+                    readonly href: "/docs/quickstart";
+                }];
+            };
+        }, {
+            readonly id: "docs-agentskit";
+            readonly kind: "document";
+            readonly label: "AgentsKit documentation";
+            readonly match: {
+                readonly type: "exact";
+                readonly values: readonly ["docs", "agentskit docs"];
+            };
+            readonly answer: {
+                readonly markdown: "Open the AgentsKit documentation.";
+                readonly citations: readonly [{
+                    readonly id: "agentskit-docs";
+                    readonly title: "AgentsKit docs";
+                    readonly href: "https://agentskit.io/docs";
+                }];
+            };
+        }, {
+            readonly id: "docs-registry";
+            readonly kind: "document";
+            readonly label: "Registry documentation";
+            readonly match: {
+                readonly type: "exact";
+                readonly values: readonly ["docs", "registry docs"];
+            };
+            readonly answer: {
+                readonly markdown: "Open the Registry documentation.";
+                readonly citations: readonly [{
+                    readonly id: "registry-docs";
+                    readonly title: "Registry docs";
+                    readonly href: "https://registry.agentskit.io";
+                }];
+            };
+        }];
+    };
+    readonly code: "DETERMINISTIC_UNSUPPORTED_VERSION";
+}, {
+    readonly name: "corrupt artifact";
+    readonly artifact: {
+        readonly entries: readonly [{
+            readonly unexpected: true;
+        }];
+        readonly protocol: "agentskit.chat.knowledge";
+        readonly version: 1;
+        readonly artifactId: "agentskit-docs-2026-07-13";
+        readonly siteId: "agentskit-docs";
+        readonly contentHash: "sha256:d1b98e69dcb00985dc5fdad4a8475f926168e6485e85716758ad5e0f35cd4906";
+        readonly generatedAt: "2026-07-13T00:00:00.000Z";
+        readonly expiresAt: "2026-07-14T00:00:00.000Z";
+    };
+    readonly code: "DETERMINISTIC_INVALID_PAYLOAD";
+}, {
+    readonly name: "hash mismatch";
+    readonly artifact: {
+        readonly protocol: "agentskit.chat.knowledge";
+        readonly version: 1;
+        readonly artifactId: "agentskit-docs-2026-07-13";
+        readonly siteId: "agentskit-docs";
+        readonly contentHash: "sha256:d1b98e69dcb00985dc5fdad4a8475f926168e6485e85716758ad5e0f35cd4906";
+        readonly generatedAt: "2026-07-13T00:00:00.000Z";
+        readonly expiresAt: "2026-07-14T00:00:00.000Z";
+        readonly entries: readonly [{
+            readonly id: "install-cli";
+            readonly kind: "command";
+            readonly label: "Install the CLI";
+            readonly match: {
+                readonly type: "exact";
+                readonly values: readonly ["install cli", "npm install agentskit"];
+            };
+            readonly answer: {
+                readonly markdown: "Run `npm install agentskit`.";
+                readonly citations: readonly [{
+                    readonly id: "quickstart";
+                    readonly title: "Quickstart";
+                    readonly href: "/docs/quickstart";
+                }];
+            };
+        }, {
+            readonly id: "docs-agentskit";
+            readonly kind: "document";
+            readonly label: "AgentsKit documentation";
+            readonly match: {
+                readonly type: "exact";
+                readonly values: readonly ["docs", "agentskit docs"];
+            };
+            readonly answer: {
+                readonly markdown: "Open the AgentsKit documentation.";
+                readonly citations: readonly [{
+                    readonly id: "agentskit-docs";
+                    readonly title: "AgentsKit docs";
+                    readonly href: "https://agentskit.io/docs";
+                }];
+            };
+        }, {
+            readonly id: "docs-registry";
+            readonly kind: "document";
+            readonly label: "Registry documentation";
+            readonly match: {
+                readonly type: "exact";
+                readonly values: readonly ["docs", "registry docs"];
+            };
+            readonly answer: {
+                readonly markdown: "Open the Registry documentation.";
+                readonly citations: readonly [{
+                    readonly id: "registry-docs";
+                    readonly title: "Registry docs";
+                    readonly href: "https://registry.agentskit.io";
+                }];
+            };
+        }];
+    };
+    readonly expectedContentHash: `sha256:${string}`;
+    readonly code: "DETERMINISTIC_HASH_MISMATCH";
+}];
+
+export { type InvalidTurnEventFixture, type TurnEventFixture, deterministicAnswerFixtures, deterministicContentHashFixture, deterministicSiteConfigFixture, invalidChoiceListPropsFrame, invalidComponentFrameFixtures, invalidDeterministicArtifactFixtures, invalidTurnEventFixtures, localKnowledgeArtifactFixture, persistentSessionFixture, staleLocalKnowledgeArtifactFixture, standardComponentFrameFixtures, unknownComponentFrame, validChoiceListFrame, validTurnEventFixtures };