@agentskit/chat-protocol 0.1.0

package/dist/fixtures.js

@@ -0,0 +1,346 @@
+// src/fixtures.ts
+var base = {
+  protocol: "agentskit.chat.turn",
+  version: 1,
+  sessionId: "session-conformance",
+  turnId: "turn-conformance",
+  emittedAt: "2026-07-11T03:00:00.000Z"
+};
+var validTurnEventFixtures = [
+  {
+    name: "submit",
+    event: {
+      ...base,
+      eventId: "event-submit",
+      sequence: 0,
+      event: "client.turn.submit",
+      payload: { input: "hello" }
+    }
+  },
+  {
+    name: "idle snapshot",
+    event: {
+      ...base,
+      eventId: "event-idle",
+      sequence: 1,
+      event: "server.turn.snapshot",
+      payload: {
+        status: "idle",
+        usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+        messages: []
+      }
+    }
+  },
+  {
+    name: "streaming snapshot",
+    event: {
+      ...base,
+      eventId: "event-streaming",
+      sequence: 2,
+      event: "server.turn.snapshot",
+      payload: {
+        status: "streaming",
+        lineage: { operation: "submit" },
+        usage: { promptTokens: 2, completionTokens: 1, totalTokens: 3 },
+        messages: [{
+          id: "message-assistant",
+          role: "assistant",
+          content: "AgentsKit",
+          status: "streaming",
+          createdAt: "2026-07-11T03:00:00.000Z"
+        }]
+      }
+    }
+  },
+  {
+    name: "complete snapshot with tool call",
+    event: {
+      ...base,
+      eventId: "event-complete",
+      sequence: 3,
+      event: "server.turn.snapshot",
+      payload: {
+        status: "complete",
+        lineage: { operation: "regenerate", parentTurnId: "turn-previous", sourceMessageId: "message-assistant" },
+        usage: { promptTokens: 2, completionTokens: 3, totalTokens: 5 },
+        messages: [{
+          id: "message-assistant",
+          role: "assistant",
+          content: "AgentsKit received: hello",
+          status: "complete",
+          toolCalls: [{
+            id: "tool-call-1",
+            name: "lookup",
+            args: { query: "hello" },
+            result: "found",
+            status: "complete"
+          }],
+          createdAt: "2026-07-11T03:00:01.000Z"
+        }]
+      }
+    }
+  },
+  {
+    name: "diagnostic",
+    event: {
+      ...base,
+      eventId: "event-diagnostic",
+      sequence: 4,
+      event: "server.turn.diagnostic",
+      payload: {
+        version: 1,
+        code: "ADAPTER_FAILED",
+        message: "The adapter failed.",
+        retryable: false
+      }
+    }
+  },
+  {
+    name: "error snapshot",
+    event: {
+      ...base,
+      eventId: "event-error",
+      sequence: 5,
+      event: "server.turn.snapshot",
+      payload: {
+        status: "error",
+        usage: { promptTokens: 2, completionTokens: 0, totalTokens: 2 },
+        messages: [],
+        error: {
+          version: 1,
+          code: "ADAPTER_FAILED",
+          message: "The adapter failed.",
+          retryable: false
+        }
+      }
+    }
+  }
+];
+var invalidTurnEventFixtures = [
+  {
+    name: "invalid payload",
+    event: null,
+    code: "PROTOCOL_INVALID_PAYLOAD"
+  },
+  {
+    name: "unknown version",
+    event: { ...base, eventId: "future", version: 2, sequence: 0, event: "client.turn.submit", payload: { input: "hello" } },
+    code: "PROTOCOL_UNSUPPORTED_VERSION"
+  },
+  {
+    name: "unknown event",
+    event: { ...base, eventId: "unknown", sequence: 0, event: "server.turn.future", payload: {} },
+    code: "PROTOCOL_UNKNOWN_EVENT"
+  },
+  {
+    name: "blank input",
+    event: { ...base, eventId: "blank", sequence: 0, event: "client.turn.submit", payload: { input: "   " } },
+    code: "PROTOCOL_INVALID_PAYLOAD"
+  }
+];
+var validChoiceListFrame = {
+  protocol: "agentskit.chat.component",
+  version: 1,
+  type: "render",
+  componentKey: "choice-list",
+  instanceId: "destination-choice",
+  props: {
+    prompt: "Where should we go?",
+    choices: [
+      { id: "docs", label: "Documentation", description: "Read the component guide." },
+      { id: "demo", label: "Demo" }
+    ]
+  },
+  fallback: { kind: "choice-list", summary: "Choose Documentation or Demo." }
+};
+var catalogFrame = (componentKey, props, summary) => ({
+  protocol: "agentskit.chat.component",
+  version: 1,
+  type: "render",
+  componentKey,
+  instanceId: `${componentKey}-fixture`,
+  props,
+  fallback: { kind: componentKey, summary }
+});
+var standardComponentFrameFixtures = [
+  catalogFrame("button-group", { label: "Actions", buttons: [{ id: "save", label: "Save" }] }, "Choose Save."),
+  validChoiceListFrame,
+  catalogFrame("form", { title: "Contact", fields: [{ id: "email", label: "Email", type: "email", required: true }], submitLabel: "Send" }, "Contact form."),
+  catalogFrame("confirmation", { title: "Delete?", message: "This cannot be undone.", confirmLabel: "Delete", cancelLabel: "Cancel" }, "Confirm deletion."),
+  catalogFrame("progress", { label: "Upload", value: 42, status: "Uploading" }, "Upload is 42% complete."),
+  catalogFrame("source-list", { label: "Sources", sources: [{ id: "docs", title: "Documentation", url: "/docs" }] }, "Sources: Documentation."),
+  catalogFrame("link-card", { title: "Guide", description: "Read the guide.", href: "https://example.com/guide" }, "Guide link."),
+  catalogFrame("error-notice", { title: "Failed", message: "Try again.", code: "E_TEST", retryLabel: "Retry" }, "Failed: Try again."),
+  catalogFrame("tool-call", { name: "Search", status: "complete", arguments: { q: "AgentsKit" }, result: "Found" }, "Search completed."),
+  catalogFrame("approval-request", { title: "Approve send?", description: "Send the email.", approveLabel: "Approve", denyLabel: "Deny" }, "Approval required."),
+  catalogFrame("table", { caption: "Users", columns: [{ key: "name", label: "Name" }], rows: [{ name: "Ada" }] }, "Users table with one row."),
+  catalogFrame("file-attachment", { name: "report.pdf", mimeType: "application/pdf", sizeBytes: 1024, url: "/report.pdf" }, "Attached report.pdf.")
+];
+var invalidChoiceListPropsFrame = {
+  ...validChoiceListFrame,
+  props: { prompt: "", choices: [] }
+};
+var unknownComponentFrame = {
+  ...validChoiceListFrame,
+  componentKey: "future-component"
+};
+var invalidComponentFrameFixtures = [
+  { name: "invalid frame", frame: null, code: "COMPONENT_INVALID_FRAME" },
+  { name: "unsupported version", frame: { ...validChoiceListFrame, version: 2 }, code: "COMPONENT_UNSUPPORTED_VERSION" },
+  { name: "unknown type", frame: { ...validChoiceListFrame, type: "future" }, code: "COMPONENT_UNKNOWN_TYPE" }
+];
+var persistentSessionFixture = {
+  protocol: "agentskit.chat.session",
+  version: 1,
+  sessionId: "cross-client",
+  definitionId: "protocol-session",
+  definitionRevision: 1,
+  updatedAt: "2026-07-11T00:00:00.000Z",
+  cursor: 1,
+  conversation: { state: "complete", decisions: [] },
+  confirmations: []
+};
+var deterministicContentHashFixture = "sha256:d1b98e69dcb00985dc5fdad4a8475f926168e6485e85716758ad5e0f35cd4906";
+var deterministicSiteConfigFixture = {
+  protocol: "agentskit.chat.site",
+  version: 1,
+  siteId: "agentskit-docs",
+  artifact: { href: "/agentskit-chat.knowledge.json", contentHash: deterministicContentHashFixture },
+  fallback: { mode: "backend" }
+};
+var localKnowledgeArtifactFixture = {
+  protocol: "agentskit.chat.knowledge",
+  version: 1,
+  artifactId: "agentskit-docs-2026-07-13",
+  siteId: "agentskit-docs",
+  contentHash: deterministicContentHashFixture,
+  generatedAt: "2026-07-13T00:00:00.000Z",
+  expiresAt: "2026-07-14T00:00:00.000Z",
+  entries: [
+    {
+      id: "install-cli",
+      kind: "command",
+      label: "Install the CLI",
+      match: { type: "exact", values: ["install cli", "npm install agentskit"] },
+      answer: { markdown: "Run `npm install agentskit`.", citations: [{ id: "quickstart", title: "Quickstart", href: "/docs/quickstart" }] }
+    },
+    {
+      id: "docs-agentskit",
+      kind: "document",
+      label: "AgentsKit documentation",
+      match: { type: "exact", values: ["docs", "agentskit docs"] },
+      answer: { markdown: "Open the AgentsKit documentation.", citations: [{ id: "agentskit-docs", title: "AgentsKit docs", href: "https://agentskit.io/docs" }] }
+    },
+    {
+      id: "docs-registry",
+      kind: "document",
+      label: "Registry documentation",
+      match: { type: "exact", values: ["docs", "registry docs"] },
+      answer: { markdown: "Open the Registry documentation.", citations: [{ id: "registry-docs", title: "Registry docs", href: "https://registry.agentskit.io" }] }
+    }
+  ]
+};
+var staleLocalKnowledgeArtifactFixture = {
+  ...localKnowledgeArtifactFixture,
+  artifactId: "agentskit-docs-stale",
+  contentHash: "sha256:c48a310e9497d1588e408bf7eb72ca64c04f25431ef8d17cd351b1d3bab3a3e9",
+  generatedAt: "2026-07-11T00:00:00.000Z",
+  expiresAt: "2026-07-12T00:00:00.000Z"
+};
+var deterministicAnswerFixtures = {
+  local: {
+    protocol: "agentskit.chat.answer",
+    version: 1,
+    outcome: "answer",
+    query: "Install CLI",
+    normalizedQuery: "install cli",
+    answer: localKnowledgeArtifactFixture.entries[0].answer,
+    provenance: { source: "local", artifactId: localKnowledgeArtifactFixture.artifactId, contentHash: deterministicContentHashFixture, entryIds: ["install-cli"] },
+    confidence: { level: "high", basis: "exact" }
+  },
+  backend: {
+    protocol: "agentskit.chat.answer",
+    version: 1,
+    outcome: "answer",
+    query: "Compare runtimes",
+    normalizedQuery: "compare runtimes",
+    answer: { markdown: "The backend can answer open-ended comparisons.", citations: [] },
+    provenance: { source: "backend", provider: "ask", model: "configured-by-host" },
+    confidence: { level: "high", basis: "backend" }
+  },
+  ambiguous: {
+    protocol: "agentskit.chat.answer",
+    version: 1,
+    outcome: "choices",
+    query: "docs",
+    normalizedQuery: "docs",
+    message: "More than one exact local answer matches. Choose one to continue.",
+    suggestions: [
+      { id: "docs-agentskit", label: "AgentsKit documentation", value: "agentskit docs" },
+      { id: "docs-registry", label: "Registry documentation", value: "registry docs" }
+    ],
+    provenance: { source: "local", artifactId: localKnowledgeArtifactFixture.artifactId, contentHash: deterministicContentHashFixture, entryIds: ["docs-agentskit", "docs-registry"] },
+    confidence: { level: "medium", basis: "ambiguous" }
+  },
+  miss: {
+    protocol: "agentskit.chat.answer",
+    version: 1,
+    outcome: "escalation",
+    query: "Why?",
+    normalizedQuery: "why?",
+    message: "No exact local answer was found. A backend answer is required.",
+    reason: "miss",
+    confidence: { level: "low", basis: "miss" }
+  },
+  stale: {
+    protocol: "agentskit.chat.answer",
+    version: 1,
+    outcome: "escalation",
+    query: "install cli",
+    normalizedQuery: "install cli",
+    message: "Local knowledge is stale. A backend answer is required.",
+    reason: "stale",
+    confidence: { level: "low", basis: "stale" }
+  },
+  corrupt: {
+    protocol: "agentskit.chat.answer",
+    version: 1,
+    outcome: "escalation",
+    query: "install cli",
+    normalizedQuery: "install cli",
+    message: "Local knowledge is corrupt. A backend answer is required.",
+    reason: "corrupt",
+    confidence: { level: "low", basis: "corrupt" }
+  },
+  offline: {
+    protocol: "agentskit.chat.answer",
+    version: 1,
+    outcome: "escalation",
+    query: "Why?",
+    normalizedQuery: "why?",
+    message: "This question needs the backend, which is not available.",
+    reason: "offline",
+    confidence: { level: "low", basis: "offline" }
+  }
+};
+var invalidDeterministicArtifactFixtures = [
+  { name: "unsupported version", artifact: { ...localKnowledgeArtifactFixture, version: 2 }, code: "DETERMINISTIC_UNSUPPORTED_VERSION" },
+  { name: "corrupt artifact", artifact: { ...localKnowledgeArtifactFixture, entries: [{ unexpected: true }] }, code: "DETERMINISTIC_INVALID_PAYLOAD" },
+  { name: "hash mismatch", artifact: localKnowledgeArtifactFixture, expectedContentHash: `sha256:${"b".repeat(64)}`, code: "DETERMINISTIC_HASH_MISMATCH" }
+];
+export {
+  deterministicAnswerFixtures,
+  deterministicContentHashFixture,
+  deterministicSiteConfigFixture,
+  invalidChoiceListPropsFrame,
+  invalidComponentFrameFixtures,
+  invalidDeterministicArtifactFixtures,
+  invalidTurnEventFixtures,
+  localKnowledgeArtifactFixture,
+  persistentSessionFixture,
+  staleLocalKnowledgeArtifactFixture,
+  standardComponentFrameFixtures,
+  unknownComponentFrame,
+  validChoiceListFrame,
+  validTurnEventFixtures
+};