@agentskit/chat 0.1.0 → 0.2.0

package/README.md

@@ -26,6 +26,6 @@ formatSemanticFallback(fallback)
 
 Custom application UI is declared through `defineComponentManifest`. The first schema-backed component is `ChoiceListComponent`; untrusted frames must pass `resolveComponentFrame` before rendering.
 
-Shared Ask-service hosts use `createAskAdapter` and `createAskSessionMemory`. The adapter owns the validated NDJSON boundary and ordered text/source projection; memory composes `@agentskit/memory/web-storage` rather than implementing another message store. See [`docs/protocol/ask-service.md`](../../docs/protocol/ask-service.md).
+Shared Ask-service hosts use `createAskAdapter` and `createAskSessionMemory`. The adapter owns the validated NDJSON boundary and ordered text/source projection; memory composes `@agentskit/memory/web-storage` rather than implementing another message store. A resumed application session is forwarded through the additive Ask request, and deterministic escalations contribute bounded low-confidence context. Trusted site/corpus authority remains server-side. See [`docs/protocol/ask-service.md`](../../docs/protocol/ask-service.md).
 
 To answer exact local facts before Ask or another backend, verify the artifact and compose `createDeterministicAnswerAdapter({ artifact, expectedContentHash, expectedSiteId, fallbackMode, fallback })`. Wire its `resolveChoiceSubmission` into `definition.choiceSubmission` so only adapter-projected, single-use choices can submit their visible alias. One exact match renders locally, ambiguity exposes visible unique choices across all seven renderers, disabled fallback never calls the backend, and bounded successful backend streams receive the same answer envelope on completion. The contract is accepted in ADR-0024; see [`docs/protocol/deterministic-answers.md`](../../docs/protocol/deterministic-answers.md).

package/dist/index.cjs

@@ -340,101 +340,111 @@ var encodeText = function* (encode, text) {
   }
 };
 function createAskAdapter(options = {}) {
-  return {
-    capabilities: { streaming: true, structuredOutput: true },
-    createSource(request) {
-      const controller = new AbortController();
-      return {
-        abort: () => controller.abort(),
-        async *stream() {
-          const encode = createBoundedAssistantEncoder();
+  const createSourceForSession = (request, sessionId) => {
+    const controller = new AbortController();
+    const escalation2 = import_chat_protocol.AnswerResponseSchema.safeParse(request.context?.metadata?.["agentskit.chat.escalation"]);
+    const deterministic = escalation2.success && escalation2.data.outcome === "escalation" ? escalation2.data : void 0;
+    return {
+      abort: () => controller.abort(),
+      async *stream() {
+        const encode = createBoundedAssistantEncoder();
+        try {
+          const connection = new AbortController();
+          const timeout = setTimeout(() => connection.abort(), DEFAULT_CONNECTION_TIMEOUT_MS);
+          let response;
           try {
-            const connection = new AbortController();
-            const timeout = setTimeout(() => connection.abort(), DEFAULT_CONNECTION_TIMEOUT_MS);
-            let response;
-            try {
-              response = await fetch(endpointWithParams(options), {
-                method: "POST",
-                signal: AbortSignal.any([controller.signal, connection.signal]),
-                headers: { "content-type": "application/json" },
-                body: JSON.stringify({ messages: projectAskMessages(request.messages) })
-              });
-            } finally {
-              clearTimeout(timeout);
-            }
-            if (!response.ok || response.body === null) throw new Error(`Ask request failed (${response.status}).`);
-            const reader = response.body.getReader();
-            const decoder = new TextDecoder();
-            let buffer = "";
-            const contentType = response.headers.get("content-type")?.toLowerCase() ?? "";
-            let mode = contentType.includes("text/plain") ? "text" : contentType.includes("ndjson") ? "ndjson" : "unknown";
-            let discardingOversizedLine = false;
-            while (true) {
-              const result = await reader.read();
-              let incoming = decoder.decode(result.value, { stream: !result.done });
-              if (discardingOversizedLine) {
-                const lineEnd = incoming.indexOf("\n");
-                if (lineEnd < 0) {
-                  if (result.done) break;
-                  continue;
-                }
-                incoming = incoming.slice(lineEnd + 1);
-                discardingOversizedLine = false;
-              }
-              buffer += incoming;
-              if (mode === "unknown" && buffer.trimStart() !== "") {
-                if (!buffer.trimStart().startsWith("{")) mode = "text";
-                else {
-                  const lineEnd = buffer.indexOf("\n");
-                  if (lineEnd >= 0 || result.done) {
-                    const firstLine = lineEnd >= 0 ? buffer.slice(0, lineEnd + 1) : `${buffer}
-`;
-                    mode = (0, import_chat_protocol.decodeAskEvents)(firstLine).events.length > 0 ? "ndjson" : "text";
-                  } else if (new TextEncoder().encode(buffer).byteLength > import_chat_protocol.ASK_EVENT_MAX_BYTES) {
-                    buffer = "";
-                    discardingOversizedLine = true;
-                  }
-                }
-              }
-              if (mode === "unknown" && !result.done) continue;
-              if (mode === "text") {
-                yield* encodeText(encode, buffer);
-                buffer = "";
+            response = await fetch(endpointWithParams(options), {
+              method: "POST",
+              signal: AbortSignal.any([controller.signal, connection.signal]),
+              headers: { "content-type": "application/json" },
+              body: JSON.stringify({
+                protocol: "agentskit.chat.ask",
+                version: 1,
+                ...sessionId === "unscoped" ? {} : { sessionId },
+                messages: projectAskMessages(request.messages),
+                ...deterministic === void 0 ? {} : { deterministic }
+              })
+            });
+          } finally {
+            clearTimeout(timeout);
+          }
+          if (!response.ok || response.body === null) throw new Error(`Ask request failed (${response.status}).`);
+          const reader = response.body.getReader();
+          const decoder = new TextDecoder();
+          let buffer = "";
+          const contentType = response.headers.get("content-type")?.toLowerCase() ?? "";
+          let mode = contentType.includes("ndjson") ? "ndjson" : "unknown";
+          let discardingOversizedLine = false;
+          while (true) {
+            const result = await reader.read();
+            let incoming = decoder.decode(result.value, { stream: !result.done });
+            if (discardingOversizedLine) {
+              const lineEnd = incoming.indexOf("\n");
+              if (lineEnd < 0) {
                 if (result.done) break;
                 continue;
               }
-              const decoded = (0, import_chat_protocol.decodeAskEvents)(result.done ? `${buffer}
-` : buffer);
-              buffer = decoded.rest;
-              discardingOversizedLine = decoded.discardedPartial;
-              for (const event of decoded.events) {
-                const projected = projectAskEvent(event, options.projectTool);
-                if (projected?.kind === "error") {
-                  void reader.cancel().catch(() => void 0);
-                  yield { type: "error", content: projected.message };
-                  return;
-                }
-                if (projected?.kind === "done") {
-                  void reader.cancel().catch(() => void 0);
-                  yield { type: "done" };
-                  return;
-                }
-                if (projected?.kind === "text") yield* encodeText(encode, projected.text);
-                if (projected?.kind === "component") {
-                  yield { type: "text", content: encode({ kind: "component", frame: projected.frame }) };
+              incoming = incoming.slice(lineEnd + 1);
+              discardingOversizedLine = false;
+            }
+            buffer += incoming;
+            if (mode === "unknown" && buffer.trimStart() !== "") {
+              if (!buffer.trimStart().startsWith("{")) mode = "text";
+              else {
+                const lineEnd = buffer.indexOf("\n");
+                if (lineEnd >= 0 || result.done) {
+                  const firstLine = lineEnd >= 0 ? buffer.slice(0, lineEnd + 1) : `${buffer}
+`;
+                  mode = (0, import_chat_protocol.decodeAskEvents)(firstLine).events.length > 0 ? "ndjson" : "text";
+                } else if (new TextEncoder().encode(buffer).byteLength > import_chat_protocol.ASK_EVENT_MAX_BYTES) {
+                  buffer = "";
+                  discardingOversizedLine = true;
                 }
               }
+            }
+            if (mode === "unknown" && !result.done) continue;
+            if (mode === "text") {
+              yield* encodeText(encode, buffer);
+              buffer = "";
               if (result.done) break;
+              continue;
             }
-            yield { type: "done" };
-          } catch (cause) {
-            if (!controller.signal.aborted) {
-              yield { type: "error", content: cause instanceof Error ? cause.message : "Ask request failed." };
+            const decoded = (0, import_chat_protocol.decodeAskEvents)(result.done ? `${buffer}
+` : buffer);
+            buffer = decoded.rest;
+            discardingOversizedLine = decoded.discardedPartial;
+            for (const event of decoded.events) {
+              const projected = projectAskEvent(event, options.projectTool);
+              if (projected?.kind === "error") {
+                void reader.cancel().catch(() => void 0);
+                yield { type: "error", content: projected.message };
+                return;
+              }
+              if (projected?.kind === "done") {
+                void reader.cancel().catch(() => void 0);
+                yield { type: "done" };
+                return;
+              }
+              if (projected?.kind === "text") yield* encodeText(encode, projected.text);
+              if (projected?.kind === "component") {
+                yield { type: "text", content: encode({ kind: "component", frame: projected.frame }) };
+              }
             }
+            if (result.done) break;
+          }
+          yield { type: "done" };
+        } catch (cause) {
+          if (!controller.signal.aborted) {
+            yield { type: "error", content: cause instanceof Error ? cause.message : "Ask request failed." };
           }
         }
-      };
-    }
+      }
+    };
+  };
+  return {
+    capabilities: { streaming: true, structuredOutput: true },
+    createSource: (request) => createSourceForSession(request, "unscoped"),
+    createSourceForSession
   };
 }
 var legacyContent = (record, projectTool) => {

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 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 { AdapterFactory, AdapterRequest, StreamSource, ChatMemory, Message, ChatReturn, ToolAuthorizer, ChatConfig } from '@agentskit/core';
 import { z } from 'zod';
 import { WebStorageLike } from '@agentskit/memory/web-storage';
 
@@ -342,6 +342,9 @@ interface AskMemoryOptions {
     readonly getStorage?: () => WebStorageLike | undefined;
     readonly projectTool?: AskToolProjector;
 }
+interface AskAdapter extends AdapterFactory {
+    readonly createSourceForSession: (request: AdapterRequest, sessionId: string) => StreamSource;
+}
 
 /** Projects a validated Ask wire event into canonical ordered assistant content. */
 declare function projectAskEvent(event: AskEvent, projectTool?: AskToolProjector): AskProjection | undefined;
@@ -350,7 +353,7 @@ declare function projectAskMessages(messages: readonly Message[]): Array<{
     readonly content: string;
 }>;
 /** Creates the shared Ask adapter without replacing the AgentsKit controller or message model. */
-declare function createAskAdapter(options?: AskAdapterOptions): AdapterFactory;
+declare function createAskAdapter(options?: AskAdapterOptions): AskAdapter;
 /** Composes Ask legacy migration over the released, validated Web Storage ChatMemory. */
 declare function createAskSessionMemory({ key, legacyKeys, maxMessages, maxRecordBytes, getStorage, projectTool, }: AskMemoryOptions): ChatMemory;
 
@@ -615,4 +618,4 @@ 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 };
+export { type ActionConfirmation, type ActionConfirmationCoordinator, type ActionConfirmationOptions, type ActionConfirmationStatus, type ActionPolicy, type ActionPolicyReason, type ActionPolicyTrace, ApprovalRequestComponent, ApprovalRequestPropsSchema, type AskAdapter, 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 };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 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 { AdapterFactory, AdapterRequest, StreamSource, ChatMemory, Message, ChatReturn, ToolAuthorizer, ChatConfig } from '@agentskit/core';
 import { z } from 'zod';
 import { WebStorageLike } from '@agentskit/memory/web-storage';
 
@@ -342,6 +342,9 @@ interface AskMemoryOptions {
     readonly getStorage?: () => WebStorageLike | undefined;
     readonly projectTool?: AskToolProjector;
 }
+interface AskAdapter extends AdapterFactory {
+    readonly createSourceForSession: (request: AdapterRequest, sessionId: string) => StreamSource;
+}
 
 /** Projects a validated Ask wire event into canonical ordered assistant content. */
 declare function projectAskEvent(event: AskEvent, projectTool?: AskToolProjector): AskProjection | undefined;
@@ -350,7 +353,7 @@ declare function projectAskMessages(messages: readonly Message[]): Array<{
     readonly content: string;
 }>;
 /** Creates the shared Ask adapter without replacing the AgentsKit controller or message model. */
-declare function createAskAdapter(options?: AskAdapterOptions): AdapterFactory;
+declare function createAskAdapter(options?: AskAdapterOptions): AskAdapter;
 /** Composes Ask legacy migration over the released, validated Web Storage ChatMemory. */
 declare function createAskSessionMemory({ key, legacyKeys, maxMessages, maxRecordBytes, getStorage, projectTool, }: AskMemoryOptions): ChatMemory;
 
@@ -615,4 +618,4 @@ 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 };
+export { type ActionConfirmation, type ActionConfirmationCoordinator, type ActionConfirmationOptions, type ActionConfirmationStatus, type ActionPolicy, type ActionPolicyReason, type ActionPolicyTrace, ApprovalRequestComponent, ApprovalRequestPropsSchema, type AskAdapter, 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 };

package/dist/index.js

@@ -155,6 +155,7 @@ var validateStandardComponentInteraction = (componentKey, props, event, value) =
 import { createWebStorageMemory } from "@agentskit/memory/web-storage";
 import {
   ASK_EVENT_MAX_BYTES,
+  AnswerResponseSchema,
   ASSISTANT_CONTENT_MAX_BYTES,
   ASSISTANT_CONTENT_MAX_RECORDS,
   ComponentRenderFrameSchema,
@@ -274,101 +275,111 @@ var encodeText = function* (encode, text) {
   }
 };
 function createAskAdapter(options = {}) {
-  return {
-    capabilities: { streaming: true, structuredOutput: true },
-    createSource(request) {
-      const controller = new AbortController();
-      return {
-        abort: () => controller.abort(),
-        async *stream() {
-          const encode = createBoundedAssistantEncoder();
+  const createSourceForSession = (request, sessionId) => {
+    const controller = new AbortController();
+    const escalation2 = AnswerResponseSchema.safeParse(request.context?.metadata?.["agentskit.chat.escalation"]);
+    const deterministic = escalation2.success && escalation2.data.outcome === "escalation" ? escalation2.data : void 0;
+    return {
+      abort: () => controller.abort(),
+      async *stream() {
+        const encode = createBoundedAssistantEncoder();
+        try {
+          const connection = new AbortController();
+          const timeout = setTimeout(() => connection.abort(), DEFAULT_CONNECTION_TIMEOUT_MS);
+          let response;
           try {
-            const connection = new AbortController();
-            const timeout = setTimeout(() => connection.abort(), DEFAULT_CONNECTION_TIMEOUT_MS);
-            let response;
-            try {
-              response = await fetch(endpointWithParams(options), {
-                method: "POST",
-                signal: AbortSignal.any([controller.signal, connection.signal]),
-                headers: { "content-type": "application/json" },
-                body: JSON.stringify({ messages: projectAskMessages(request.messages) })
-              });
-            } finally {
-              clearTimeout(timeout);
-            }
-            if (!response.ok || response.body === null) throw new Error(`Ask request failed (${response.status}).`);
-            const reader = response.body.getReader();
-            const decoder = new TextDecoder();
-            let buffer = "";
-            const contentType = response.headers.get("content-type")?.toLowerCase() ?? "";
-            let mode = contentType.includes("text/plain") ? "text" : contentType.includes("ndjson") ? "ndjson" : "unknown";
-            let discardingOversizedLine = false;
-            while (true) {
-              const result = await reader.read();
-              let incoming = decoder.decode(result.value, { stream: !result.done });
-              if (discardingOversizedLine) {
-                const lineEnd = incoming.indexOf("\n");
-                if (lineEnd < 0) {
-                  if (result.done) break;
-                  continue;
-                }
-                incoming = incoming.slice(lineEnd + 1);
-                discardingOversizedLine = false;
-              }
-              buffer += incoming;
-              if (mode === "unknown" && buffer.trimStart() !== "") {
-                if (!buffer.trimStart().startsWith("{")) mode = "text";
-                else {
-                  const lineEnd = buffer.indexOf("\n");
-                  if (lineEnd >= 0 || result.done) {
-                    const firstLine = lineEnd >= 0 ? buffer.slice(0, lineEnd + 1) : `${buffer}
-`;
-                    mode = decodeAskEvents(firstLine).events.length > 0 ? "ndjson" : "text";
-                  } else if (new TextEncoder().encode(buffer).byteLength > ASK_EVENT_MAX_BYTES) {
-                    buffer = "";
-                    discardingOversizedLine = true;
-                  }
-                }
-              }
-              if (mode === "unknown" && !result.done) continue;
-              if (mode === "text") {
-                yield* encodeText(encode, buffer);
-                buffer = "";
+            response = await fetch(endpointWithParams(options), {
+              method: "POST",
+              signal: AbortSignal.any([controller.signal, connection.signal]),
+              headers: { "content-type": "application/json" },
+              body: JSON.stringify({
+                protocol: "agentskit.chat.ask",
+                version: 1,
+                ...sessionId === "unscoped" ? {} : { sessionId },
+                messages: projectAskMessages(request.messages),
+                ...deterministic === void 0 ? {} : { deterministic }
+              })
+            });
+          } finally {
+            clearTimeout(timeout);
+          }
+          if (!response.ok || response.body === null) throw new Error(`Ask request failed (${response.status}).`);
+          const reader = response.body.getReader();
+          const decoder = new TextDecoder();
+          let buffer = "";
+          const contentType = response.headers.get("content-type")?.toLowerCase() ?? "";
+          let mode = contentType.includes("ndjson") ? "ndjson" : "unknown";
+          let discardingOversizedLine = false;
+          while (true) {
+            const result = await reader.read();
+            let incoming = decoder.decode(result.value, { stream: !result.done });
+            if (discardingOversizedLine) {
+              const lineEnd = incoming.indexOf("\n");
+              if (lineEnd < 0) {
                 if (result.done) break;
                 continue;
               }
-              const decoded = decodeAskEvents(result.done ? `${buffer}
-` : buffer);
-              buffer = decoded.rest;
-              discardingOversizedLine = decoded.discardedPartial;
-              for (const event of decoded.events) {
-                const projected = projectAskEvent(event, options.projectTool);
-                if (projected?.kind === "error") {
-                  void reader.cancel().catch(() => void 0);
-                  yield { type: "error", content: projected.message };
-                  return;
-                }
-                if (projected?.kind === "done") {
-                  void reader.cancel().catch(() => void 0);
-                  yield { type: "done" };
-                  return;
-                }
-                if (projected?.kind === "text") yield* encodeText(encode, projected.text);
-                if (projected?.kind === "component") {
-                  yield { type: "text", content: encode({ kind: "component", frame: projected.frame }) };
+              incoming = incoming.slice(lineEnd + 1);
+              discardingOversizedLine = false;
+            }
+            buffer += incoming;
+            if (mode === "unknown" && buffer.trimStart() !== "") {
+              if (!buffer.trimStart().startsWith("{")) mode = "text";
+              else {
+                const lineEnd = buffer.indexOf("\n");
+                if (lineEnd >= 0 || result.done) {
+                  const firstLine = lineEnd >= 0 ? buffer.slice(0, lineEnd + 1) : `${buffer}
+`;
+                  mode = decodeAskEvents(firstLine).events.length > 0 ? "ndjson" : "text";
+                } else if (new TextEncoder().encode(buffer).byteLength > ASK_EVENT_MAX_BYTES) {
+                  buffer = "";
+                  discardingOversizedLine = true;
                 }
               }
+            }
+            if (mode === "unknown" && !result.done) continue;
+            if (mode === "text") {
+              yield* encodeText(encode, buffer);
+              buffer = "";
               if (result.done) break;
+              continue;
             }
-            yield { type: "done" };
-          } catch (cause) {
-            if (!controller.signal.aborted) {
-              yield { type: "error", content: cause instanceof Error ? cause.message : "Ask request failed." };
+            const decoded = decodeAskEvents(result.done ? `${buffer}
+` : buffer);
+            buffer = decoded.rest;
+            discardingOversizedLine = decoded.discardedPartial;
+            for (const event of decoded.events) {
+              const projected = projectAskEvent(event, options.projectTool);
+              if (projected?.kind === "error") {
+                void reader.cancel().catch(() => void 0);
+                yield { type: "error", content: projected.message };
+                return;
+              }
+              if (projected?.kind === "done") {
+                void reader.cancel().catch(() => void 0);
+                yield { type: "done" };
+                return;
+              }
+              if (projected?.kind === "text") yield* encodeText(encode, projected.text);
+              if (projected?.kind === "component") {
+                yield { type: "text", content: encode({ kind: "component", frame: projected.frame }) };
+              }
             }
+            if (result.done) break;
+          }
+          yield { type: "done" };
+        } catch (cause) {
+          if (!controller.signal.aborted) {
+            yield { type: "error", content: cause instanceof Error ? cause.message : "Ask request failed." };
           }
         }
-      };
-    }
+      }
+    };
+  };
+  return {
+    capabilities: { streaming: true, structuredOutput: true },
+    createSource: (request) => createSourceForSession(request, "unscoped"),
+    createSourceForSession
   };
 }
 var legacyContent = (record, projectTool) => {
@@ -465,7 +476,7 @@ import {
   ANSWER_PROTOCOL,
   ANSWER_PROTOCOL_VERSION,
   AnswerCitationSchema,
-  AnswerResponseSchema,
+  AnswerResponseSchema as AnswerResponseSchema2,
   COMPONENT_PROTOCOL,
   COMPONENT_PROTOCOL_VERSION,
   createAssistantContentEncoder as createAssistantContentEncoder2,
@@ -481,7 +492,7 @@ var baseResponse = (query) => ({
   query: query.slice(0, 512),
   normalizedQuery: normalizeDeterministicQuery(query.slice(0, 512)).slice(0, 512)
 });
-var escalation = (query, reason, message) => AnswerResponseSchema.parse({
+var escalation = (query, reason, message) => AnswerResponseSchema2.parse({
   ...baseResponse(query),
   outcome: "escalation",
   message,
@@ -507,7 +518,7 @@ var createDeterministicAnswerResolver = (artifactInput, options) => {
   }
   const now = options.now ?? Date.now;
   const isStale = () => artifact.expiresAt !== void 0 && Date.parse(artifact.expiresAt) <= now();
-  const answerForEntry = (entry, query) => AnswerResponseSchema.parse({
+  const answerForEntry = (entry, query) => AnswerResponseSchema2.parse({
     ...baseResponse(query),
     outcome: "answer",
     answer: entry.answer,
@@ -529,7 +540,7 @@ var createDeterministicAnswerResolver = (artifactInput, options) => {
       const entries = index.get(base.normalizedQuery) ?? [];
       if (entries.length === 0) return escalation(query, "miss", "No exact local answer was found. A backend answer is required.");
       if (entries.length > 1) {
-        return AnswerResponseSchema.parse({
+        return AnswerResponseSchema2.parse({
           ...base,
           outcome: "choices",
           message: "More than one exact local answer matches. Choose one to continue.",
@@ -644,7 +655,7 @@ var backendAnswer = (query, content, backend) => {
       return citation.success ? [citation.data] : [];
     });
   }).slice(0, 8) : [];
-  return AnswerResponseSchema.parse({
+  return AnswerResponseSchema2.parse({
     ...baseResponse(query),
     outcome: "answer",
     answer: { markdown, citations },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskit/chat",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Cross-framework application definitions for AgentsKit Chat.",
   "license": "MIT",
   "repository": {
@@ -33,7 +33,7 @@
     "@agentskit/memory": "^0.11.0",
     "@agentskit/statechart": "^0.2.0",
     "zod": "^4.3.6",
-    "@agentskit/chat-protocol": "0.1.0"
+    "@agentskit/chat-protocol": "0.2.0"
   },
   "devDependencies": {
     "@agentskit/core": "^1.12.3",