@noodleseed/assistant 1.19.0 → 1.21.0

package/dist/{client-BQ30Fq-c.d.cts → client-BZ7xPwfW.d.cts}

@@ -58,14 +58,16 @@ interface AssistantToolProposedDetail extends TurnDetail {
     readonly requiresConfirmation?: true;
 }
 /**
- * A capability the visitor must sign in to reach (ADR 0201, 5.6b). `continuation` is the value the host
- * page hands to its **own** backend, which spends it with its own client credentials; on its own it names
- * a conversation and nothing more.
+ * A capability the visitor must sign in to reach (ADR 0201, 5.6b). `signInTicket` is the value the host
+ * page hands to its **own** backend, which spends it with its own client credentials
+ * (`createAssistantSession({ signInTicket })`); on its own it names a conversation and nothing more.
+ * It is deliberately not called a continuation: the server-held interaction continuation must never
+ * reach browser code, and this value's whole job is to travel through the browser.
  */
 interface AssistantAuthRequestedDetail extends TurnDetail {
     readonly id: string;
     readonly tool: string;
-    readonly continuation: string;
+    readonly signInTicket: string;
     readonly expiresAt: string;
 }
 interface AssistantInputRequestedDetail extends TurnDetail {
@@ -131,7 +133,9 @@ type AssistantClientLifecycleEvent = NamedEvent<'session_started', {
     readonly modelContext: AssistantModelContextUpdate;
 }> | NamedEvent<'message_started', {
     readonly message: string;
-}> | NamedEvent<'message_completed', Readonly<Record<string, never>>> | NamedEvent<'interaction_started', {
+}> | NamedEvent<'message_completed', Readonly<Record<string, never>>> | NamedEvent<'resume_started', {
+    readonly tool: string;
+}> | NamedEvent<'interaction_started', {
     readonly id: string;
     readonly action: 'accept' | 'decline' | 'cancel';
 }> | NamedEvent<'interaction_completed', {
@@ -199,6 +203,11 @@ type AssistantSessionSourceOptions = {
     readonly sessionEndpoint?: undefined;
 };
 
+declare class AssistantClientError extends Error {
+    readonly detail: AssistantErrorDetail;
+    constructor(detail: AssistantErrorDetail, message: string, options?: ErrorOptions);
+}
+
 type AssistantContextValue = string | number | boolean | null;
 type AssistantContext = Readonly<Record<string, AssistantContextValue>>;
 interface AssistantClientContext {
@@ -224,6 +233,10 @@ interface AssistantSessionResponse {
         readonly sandbox?: string;
     };
     readonly configuration?: AssistantConfiguration;
+    /** Armed post-sign-in resume hint: present only on an elevation exchange (issue #1177). */
+    readonly resume?: {
+        readonly tool: string;
+    };
 }
 
 interface AssistantClientBehaviorOptions<TPageContext extends AssistantPageContext = AssistantContext> {
@@ -251,6 +264,8 @@ interface AssistantClient<TPageContext extends AssistantPageContext = AssistantC
     getChatState(): AssistantChatState;
     connect(): Promise<void>;
     hasSession(): boolean;
+    /** A request holds the single-flight slot. Optional so external implementations stay valid. */
+    isBusy?(): boolean;
     sendMessage(message: string): Promise<void>;
     respond(id: string, response: AssistantInteractionResponse): Promise<void>;
     updateContext(context: AssistantContext): void;
@@ -265,10 +280,6 @@ interface AssistantClient<TPageContext extends AssistantPageContext = AssistantC
     resetSession(): void;
     abort(): void;
 }
-declare class AssistantClientError extends Error {
-    readonly detail: AssistantErrorDetail;
-    constructor(detail: AssistantErrorDetail, message: string, options?: ErrorOptions);
-}
 declare function createAssistantClient<TPageContext extends AssistantPageContext = AssistantContext>(options: CreateAssistantClientOptions<TPageContext>): AssistantClient<TPageContext>;
 
 export { type AssistantPageContext as A, type AssistantInteractionStatus as B, type CreateAssistantClientOptions as C, type AssistantJsonValue as D, type AssistantSessionResponse as E, type AssistantToolCompletedDetail as F, type AssistantToolCompletedEvent as G, type AssistantToolProposedDetail as H, type AssistantToolProposedEvent as I, type AssistantToolResultData as J, type AssistantToolStartedDetail as K, type AssistantToolStartedEvent as L, type AssistantUIDataTypes as M, type AssistantUIMessage as N, type AssistantUnrecognizedEvent as O, type AssistantViewData as P, createAssistantClient as Q, type AssistantContext as a, type AssistantChatState as b, type AssistantClient as c, type AssistantViewAvailableDetail as d, type AssistantModelContextUpdate as e, type AssistantClientEvent as f, type AssistantErrorDetail as g, type AssistantInteractionResponse as h, type AssistantEvent as i, type AssistantViewAvailableEvent as j, type AssistantChatError as k, type AssistantClientContext as l, AssistantClientError as m, type AssistantClientLifecycleEvent as n, type AssistantConfirmationData as o, type AssistantContentDetail as p, type AssistantContentEvent as q, type AssistantContextValue as r, type AssistantDoneEvent as s, type AssistantErrorEvent as t, type AssistantErrorEventDetail as u, type AssistantInputRequestData as v, type AssistantInputRequestedDetail as w, type AssistantInputRequestedEvent as x, type AssistantInteractionResolvedDetail as y, type AssistantInteractionResolvedEvent as z };

package/dist/{client-B6pnBmF8.d.ts → client-BkJlpN5N.d.ts}

@@ -58,14 +58,16 @@ interface AssistantToolProposedDetail extends TurnDetail {
     readonly requiresConfirmation?: true;
 }
 /**
- * A capability the visitor must sign in to reach (ADR 0201, 5.6b). `continuation` is the value the host
- * page hands to its **own** backend, which spends it with its own client credentials; on its own it names
- * a conversation and nothing more.
+ * A capability the visitor must sign in to reach (ADR 0201, 5.6b). `signInTicket` is the value the host
+ * page hands to its **own** backend, which spends it with its own client credentials
+ * (`createAssistantSession({ signInTicket })`); on its own it names a conversation and nothing more.
+ * It is deliberately not called a continuation: the server-held interaction continuation must never
+ * reach browser code, and this value's whole job is to travel through the browser.
  */
 interface AssistantAuthRequestedDetail extends TurnDetail {
     readonly id: string;
     readonly tool: string;
-    readonly continuation: string;
+    readonly signInTicket: string;
     readonly expiresAt: string;
 }
 interface AssistantInputRequestedDetail extends TurnDetail {
@@ -131,7 +133,9 @@ type AssistantClientLifecycleEvent = NamedEvent<'session_started', {
     readonly modelContext: AssistantModelContextUpdate;
 }> | NamedEvent<'message_started', {
     readonly message: string;
-}> | NamedEvent<'message_completed', Readonly<Record<string, never>>> | NamedEvent<'interaction_started', {
+}> | NamedEvent<'message_completed', Readonly<Record<string, never>>> | NamedEvent<'resume_started', {
+    readonly tool: string;
+}> | NamedEvent<'interaction_started', {
     readonly id: string;
     readonly action: 'accept' | 'decline' | 'cancel';
 }> | NamedEvent<'interaction_completed', {
@@ -199,6 +203,11 @@ type AssistantSessionSourceOptions = {
     readonly sessionEndpoint?: undefined;
 };
 
+declare class AssistantClientError extends Error {
+    readonly detail: AssistantErrorDetail;
+    constructor(detail: AssistantErrorDetail, message: string, options?: ErrorOptions);
+}
+
 type AssistantContextValue = string | number | boolean | null;
 type AssistantContext = Readonly<Record<string, AssistantContextValue>>;
 interface AssistantClientContext {
@@ -224,6 +233,10 @@ interface AssistantSessionResponse {
         readonly sandbox?: string;
     };
     readonly configuration?: AssistantConfiguration;
+    /** Armed post-sign-in resume hint: present only on an elevation exchange (issue #1177). */
+    readonly resume?: {
+        readonly tool: string;
+    };
 }
 
 interface AssistantClientBehaviorOptions<TPageContext extends AssistantPageContext = AssistantContext> {
@@ -251,6 +264,8 @@ interface AssistantClient<TPageContext extends AssistantPageContext = AssistantC
     getChatState(): AssistantChatState;
     connect(): Promise<void>;
     hasSession(): boolean;
+    /** A request holds the single-flight slot. Optional so external implementations stay valid. */
+    isBusy?(): boolean;
     sendMessage(message: string): Promise<void>;
     respond(id: string, response: AssistantInteractionResponse): Promise<void>;
     updateContext(context: AssistantContext): void;
@@ -265,10 +280,6 @@ interface AssistantClient<TPageContext extends AssistantPageContext = AssistantC
     resetSession(): void;
     abort(): void;
 }
-declare class AssistantClientError extends Error {
-    readonly detail: AssistantErrorDetail;
-    constructor(detail: AssistantErrorDetail, message: string, options?: ErrorOptions);
-}
 declare function createAssistantClient<TPageContext extends AssistantPageContext = AssistantContext>(options: CreateAssistantClientOptions<TPageContext>): AssistantClient<TPageContext>;
 
 export { type AssistantPageContext as A, type AssistantInteractionStatus as B, type CreateAssistantClientOptions as C, type AssistantJsonValue as D, type AssistantSessionResponse as E, type AssistantToolCompletedDetail as F, type AssistantToolCompletedEvent as G, type AssistantToolProposedDetail as H, type AssistantToolProposedEvent as I, type AssistantToolResultData as J, type AssistantToolStartedDetail as K, type AssistantToolStartedEvent as L, type AssistantUIDataTypes as M, type AssistantUIMessage as N, type AssistantUnrecognizedEvent as O, type AssistantViewData as P, createAssistantClient as Q, type AssistantContext as a, type AssistantChatState as b, type AssistantClient as c, type AssistantViewAvailableDetail as d, type AssistantModelContextUpdate as e, type AssistantClientEvent as f, type AssistantErrorDetail as g, type AssistantInteractionResponse as h, type AssistantEvent as i, type AssistantViewAvailableEvent as j, type AssistantChatError as k, type AssistantClientContext as l, AssistantClientError as m, type AssistantClientLifecycleEvent as n, type AssistantConfirmationData as o, type AssistantContentDetail as p, type AssistantContentEvent as q, type AssistantContextValue as r, type AssistantDoneEvent as s, type AssistantErrorEvent as t, type AssistantErrorEventDetail as u, type AssistantInputRequestData as v, type AssistantInputRequestedDetail as w, type AssistantInputRequestedEvent as x, type AssistantInteractionResolvedDetail as y, type AssistantInteractionResolvedEvent as z };

package/dist/client.cjs

@@ -22639,6 +22639,12 @@ var AssistantChatStateStore = class {
       case "interaction_started":
         this.#beginInteraction(event.data.id);
         return;
+      case "resume_started":
+        this.#status = "submitted";
+        this.#error = void 0;
+        this.#startOperation();
+        this.#notify();
+        return;
       case "content":
         this.#writeText(event.data.delta);
         return;
@@ -22894,6 +22900,78 @@ function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
+// src/client-errors.ts
+async function refusalCode(response) {
+  try {
+    const body = await response.clone().json();
+    const code = body.code;
+    return typeof code === "string" ? code : void 0;
+  } catch {
+    return void 0;
+  }
+}
+var UNRETRYABLE_SERVICE_CODES = /* @__PURE__ */ new Set([
+  "daily_turn_budget_exhausted",
+  "daily_session_budget_exhausted"
+]);
+var AssistantClientError = class extends Error {
+  detail;
+  constructor(detail, message, options) {
+    super(message, options);
+    this.name = "AssistantClientError";
+    this.detail = detail;
+  }
+};
+function parseSession(value) {
+  if (!isRecord2(value) || !isRecord2(value.endpoints)) {
+    throw clientError("session_failed", "Assistant session response is invalid", true);
+  }
+  const interactions = value.endpoints.interactions;
+  const apps = value.endpoints.apps;
+  const sandbox = value.endpoints.sandbox;
+  if (typeof value.token !== "string" || typeof value.expiresAt !== "string" || typeof value.endpoints.turns !== "string" || typeof value.endpoints.toolConfirmations !== "string" || interactions !== void 0 && typeof interactions !== "string" || apps !== void 0 && typeof apps !== "string" || sandbox !== void 0 && typeof sandbox !== "string") {
+    throw clientError("session_failed", "Assistant session response is invalid", true);
+  }
+  return {
+    token: value.token,
+    expiresAt: value.expiresAt,
+    endpoints: {
+      turns: value.endpoints.turns,
+      toolConfirmations: value.endpoints.toolConfirmations,
+      ...typeof interactions === "string" ? { interactions } : {},
+      ...typeof apps === "string" ? { apps } : {},
+      ...typeof sandbox === "string" ? { sandbox } : {}
+    },
+    ...isRecord2(value.configuration) ? { configuration: value.configuration } : {},
+    ...isRecord2(value.resume) && typeof value.resume.tool === "string" ? { resume: { tool: value.resume.tool } } : {}
+  };
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function readStableErrorCode(response) {
+  let value;
+  try {
+    value = await response.json();
+  } catch {
+    return void 0;
+  }
+  if (!isRecord2(value) || typeof value.code !== "string") return void 0;
+  return /^[A-Za-z0-9_.-]{1,64}$/.test(value.code) ? value.code : void 0;
+}
+function clientError(code, message, retryable, status, options, serviceCode) {
+  return new AssistantClientError(
+    {
+      code,
+      ...status === void 0 ? {} : { status },
+      retryable,
+      ...serviceCode === void 0 ? {} : { serviceCode }
+    },
+    message,
+    options
+  );
+}
+
 // src/events.ts
 function toAssistantClientEvent(event) {
   const value = event.data;
@@ -22909,20 +22987,25 @@ function toAssistantClientEvent(event) {
       }
       break;
     case "tool_proposed":
-      if (hasString(value, "id") && hasString(value, "tool") && hasOptionalString(value.title) && hasOptionalString(value.description) && hasOptionalJson(value.arguments) && (value.reviewSchema === void 0 || isRecord2(value.reviewSchema)) && hasOptionalString(value.expiresAt) && (value.requiresConfirmation === void 0 || value.requiresConfirmation === true) && hasOptionalTurnId(value)) {
+      if (hasString(value, "id") && hasString(value, "tool") && hasOptionalString(value.title) && hasOptionalString(value.description) && hasOptionalJson(value.arguments) && (value.reviewSchema === void 0 || isRecord3(value.reviewSchema)) && hasOptionalString(value.expiresAt) && (value.requiresConfirmation === void 0 || value.requiresConfirmation === true) && hasOptionalTurnId(value)) {
         return event;
       }
       break;
     case "input_requested":
-      if (hasString(value, "id") && hasString(value, "message") && isRecord2(value.requestedSchema) && hasString(value, "expiresAt") && hasOptionalTurnId(value)) {
+      if (hasString(value, "id") && hasString(value, "message") && isRecord3(value.requestedSchema) && hasString(value, "expiresAt") && hasOptionalTurnId(value)) {
         return event;
       }
       break;
-    case "auth_requested":
-      if (hasString(value, "id") && hasString(value, "tool") && hasString(value, "continuation") && hasString(value, "expiresAt") && hasOptionalTurnId(value)) {
-        return event;
+    case "auth_requested": {
+      const signInTicket = typeof value.signInTicket === "string" ? value.signInTicket : typeof value.continuation === "string" ? value.continuation : void 0;
+      if (hasString(value, "id") && hasString(value, "tool") && signInTicket !== void 0 && hasString(value, "expiresAt") && hasOptionalTurnId(value)) {
+        return {
+          event: "auth_requested",
+          data: { ...value, signInTicket }
+        };
       }
       break;
+    }
     case "interaction_resolved":
       if (hasString(value, "id") && (value.action === void 0 || isInteractionAction(value.action)) && hasOptionalTurnId(value)) {
         return event;
@@ -22953,7 +23036,7 @@ function toAssistantClientEvent(event) {
   return { event: "unrecognized", data: { name: event.event, payload: value } };
 }
 function isViewAvailableDetail(value) {
-  return hasString(value, "id") && hasString(value, "tool") && typeof value.resourceUri === "string" && value.resourceUri.startsWith("ui://") && hasOptionalString(value.title) && (value.replayed === void 0 || value.replayed === true) && isJsonValue(value.result, 0) && hasOptionalJson(value.arguments) && hasOptionalString(value.html) && (value.resourceMeta === void 0 || isRecord2(value.resourceMeta)) && (value.allowedOpenDomains === void 0 || Array.isArray(value.allowedOpenDomains) && value.allowedOpenDomains.every(isHttpsUrl)) && hasOptionalTurnId(value);
+  return hasString(value, "id") && hasString(value, "tool") && typeof value.resourceUri === "string" && value.resourceUri.startsWith("ui://") && hasOptionalString(value.title) && (value.replayed === void 0 || value.replayed === true) && isJsonValue(value.result, 0) && hasOptionalJson(value.arguments) && hasOptionalString(value.html) && (value.resourceMeta === void 0 || isRecord3(value.resourceMeta)) && (value.allowedOpenDomains === void 0 || Array.isArray(value.allowedOpenDomains) && value.allowedOpenDomains.every(isHttpsUrl)) && hasOptionalTurnId(value);
 }
 function isHttpsUrl(value) {
   if (typeof value !== "string") return false;
@@ -22986,11 +23069,11 @@ function isJsonValue(value, depth) {
   if (Array.isArray(value)) {
     return value.length <= 256 && value.every((entry) => isJsonValue(entry, depth + 1));
   }
-  if (!isRecord2(value)) return false;
+  if (!isRecord3(value)) return false;
   const entries = Object.entries(value);
   return entries.length <= 256 && entries.every(([, entry]) => isJsonValue(entry, depth + 1));
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -23230,15 +23313,15 @@ function parseFrame(frame) {
   if (event === "done" && !isValidDonePayload(parsed)) {
     throw invalidStream("assistant event stream contained an invalid done event");
   }
-  return { event, data: isRecord3(parsed) ? parsed : { value: parsed } };
+  return { event, data: isRecord4(parsed) ? parsed : { value: parsed } };
 }
 function normalizeLineEndings(input) {
   return input.replaceAll("\r\n", "\n").replaceAll("\r", "\n");
 }
 function isValidDonePayload(value) {
-  return isRecord3(value) && (value.turnId === void 0 || typeof value.turnId === "string" && value.turnId.length > 0);
+  return isRecord4(value) && (value.turnId === void 0 || typeof value.turnId === "string" && value.turnId.length > 0);
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function invalidStream(message, cause) {
@@ -23249,27 +23332,6 @@ function isAbortError2(error51) {
 }
 
 // src/client.ts
-async function refusalCode(response) {
-  try {
-    const body = await response.clone().json();
-    const code = body.code;
-    return typeof code === "string" ? code : void 0;
-  } catch {
-    return void 0;
-  }
-}
-var UNRETRYABLE_SERVICE_CODES = /* @__PURE__ */ new Set([
-  "daily_turn_budget_exhausted",
-  "daily_session_budget_exhausted"
-]);
-var AssistantClientError = class extends Error {
-  detail;
-  constructor(detail, message, options) {
-    super(message, options);
-    this.name = "AssistantClientError";
-    this.detail = detail;
-  }
-};
 var DefaultAssistantClient = class {
   #source;
   #fetch;
@@ -23304,12 +23366,50 @@ var DefaultAssistantClient = class {
   hasSession() {
     return this.#session !== void 0;
   }
+  /** Whether a request holds the single-flight slot, so callers can refuse before mutating UI. */
+  isBusy() {
+    return this.#active !== void 0;
+  }
   async connect() {
     if (this.#session) return;
     await this.#singleFlight(async (signal) => {
-      if (!this.#session) await this.#createSession(signal);
+      if (this.#session) return;
+      const session = await this.#createSession(signal);
+      if (session.resume) {
+        try {
+          await this.#runChatOperation(signal, () => this.#resumeTurn(session, signal));
+        } catch {
+        }
+      }
     });
   }
+  /** POST the one-shot resume trigger; a 409 means nothing was pending, which renders as silence. */
+  async #resumeTurn(session, signal) {
+    const response = await this.#request(
+      session.endpoints.turns,
+      {
+        method: "POST",
+        headers: authorizedHeaders(session.token, "text/event-stream"),
+        body: JSON.stringify({ resume: true }),
+        signal
+      },
+      "turn_failed"
+    );
+    if (response.status === 409) return;
+    if (!response.ok) {
+      throw clientError(
+        "turn_failed",
+        `Assistant turn failed (${response.status})`,
+        false,
+        response.status,
+        void 0,
+        await refusalCode(response)
+      );
+    }
+    this.#emit({ event: "resume_started", data: { tool: session.resume?.tool ?? "" } });
+    await this.#consume(response);
+    this.#emit({ event: "message_completed", data: {} });
+  }
   async sendMessage(text2) {
     const message = text2.trim();
     if (!message) return;
@@ -23714,10 +23814,10 @@ function authorizedHeaders(token, accept) {
   };
 }
 function parseAppInteraction(value) {
-  if (!isRecord4(value) || !isRecord4(value.interaction)) return void 0;
+  if (!isRecord2(value) || !isRecord2(value.interaction)) return void 0;
   const event = value.interaction.event;
   const data = value.interaction.data;
-  if (event !== "tool_proposed" && event !== "input_requested" || !isRecord4(data)) {
+  if (event !== "tool_proposed" && event !== "input_requested" || !isRecord2(data)) {
     return void 0;
   }
   const parsed = toAssistantClientEvent({ event, data });
@@ -23737,54 +23837,6 @@ function appInteractionStopped(action) {
     isError: true
   };
 }
-function parseSession(value) {
-  if (!isRecord4(value) || !isRecord4(value.endpoints)) {
-    throw clientError("session_failed", "Assistant session response is invalid", true);
-  }
-  const interactions = value.endpoints.interactions;
-  const apps = value.endpoints.apps;
-  const sandbox = value.endpoints.sandbox;
-  if (typeof value.token !== "string" || typeof value.expiresAt !== "string" || typeof value.endpoints.turns !== "string" || typeof value.endpoints.toolConfirmations !== "string" || interactions !== void 0 && typeof interactions !== "string" || apps !== void 0 && typeof apps !== "string" || sandbox !== void 0 && typeof sandbox !== "string") {
-    throw clientError("session_failed", "Assistant session response is invalid", true);
-  }
-  return {
-    token: value.token,
-    expiresAt: value.expiresAt,
-    endpoints: {
-      turns: value.endpoints.turns,
-      toolConfirmations: value.endpoints.toolConfirmations,
-      ...typeof interactions === "string" ? { interactions } : {},
-      ...typeof apps === "string" ? { apps } : {},
-      ...typeof sandbox === "string" ? { sandbox } : {}
-    },
-    ...isRecord4(value.configuration) ? { configuration: value.configuration } : {}
-  };
-}
-function isRecord4(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-async function readStableErrorCode(response) {
-  let value;
-  try {
-    value = await response.json();
-  } catch {
-    return void 0;
-  }
-  if (!isRecord4(value) || typeof value.code !== "string") return void 0;
-  return /^[A-Za-z0-9_.-]{1,64}$/.test(value.code) ? value.code : void 0;
-}
-function clientError(code, message, retryable, status, options, serviceCode) {
-  return new AssistantClientError(
-    {
-      code,
-      ...status === void 0 ? {} : { status },
-      retryable,
-      ...serviceCode === void 0 ? {} : { serviceCode }
-    },
-    message,
-    options
-  );
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AssistantClientError,