@syntrologie/adapt-chatbot 2.8.0-canary.593 → 2.8.0-canary.595

package/dist/hostAgentController.d.ts

@@ -21,7 +21,24 @@ export interface HostToolResults {
      * already has. What the missing-result check stands down on.
      */
     subscribeToolActivity?(listener: () => void): () => void;
+    /**
+     * Where the tool call this card was drawn for stands, the latest replayed
+     * on subscribe. Its input names the session the conversation is in.
+     */
+    subscribeToolCall?(listener: (call: {
+        phase: 'input';
+        arguments: Record<string, unknown>;
+    } | {
+        phase: 'result';
+    } | {
+        phase: 'cancelled';
+    }) => void): () => void;
 }
+/**
+ * How long a card says its answer is on its way when neither the answer nor a
+ * cancellation ever comes (a host that stops a turn without saying so).
+ */
+export declare const PENDING_MAX_MS = 120000;
 export interface HostAgentControllerOptions {
     /** How long a card that has heard nothing waits before reporting it. */
     missingResultMs?: number;
@@ -32,7 +49,9 @@ interface HostUiInitialization {
 /** One host conversation owns one store; host delivery may synchronously replay. */
 export declare function activateHostAgentController(runtime: ChatbotWidgetRuntime, bridge: HostToolResults, hostUi?: HostUiInitialization, options?: HostAgentControllerOptions): {
     acceptHostUi: (payload: unknown) => void;
-    consumeToolResult: (result: unknown) => Promise<void>;
+    consumeToolResult: (result: unknown, { earlyRead }?: {
+        earlyRead?: boolean;
+    }) => Promise<void>;
     whenIdle: () => Promise<void>;
     dispose(): void;
 };

package/dist/hostAgentController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hostAgentController.d.ts","sourceRoot":"","sources":["../src/hostAgentController.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,uFAAuF;AACvF,MAAM,WAAW,eAAe;IAC9B,oBAAoB,CAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EACnC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,MAAM,IAAI,CAAC;IACd;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjG;;;;OAIG;IACH,qBAAqB,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC1D;AAeD,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAwJD,UAAU,oBAAoB;IAC5B,cAAc,CAAC,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7C;AAsJD,oFAAoF;AACpF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,oBAAoB,EAC7B,OAAO,GAAE,0BAA+B;4BAuZT,OAAO,KAAG,IAAI;gCAgGJ,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;;;EAoHjE;AA0BD,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CA4D5E;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAC1B,OAAO,EAAE;IAAE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,EACtD,OAAO,EAAE,OAAO,GACf,IAAI,CAEN"}
+{"version":3,"file":"hostAgentController.d.ts","sourceRoot":"","sources":["../src/hostAgentController.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,uFAAuF;AACvF,MAAM,WAAW,eAAe;IAC9B,oBAAoB,CAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EACnC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,MAAM,IAAI,CAAC;IACd;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjG;;;;OAIG;IACH,qBAAqB,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACzD;;;OAGG;IACH,iBAAiB,CAAC,CAChB,QAAQ,EAAE,CACR,IAAI,EACA;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACtD;QAAE,KAAK,EAAE,QAAQ,CAAA;KAAE,GACnB;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,KACvB,IAAI,GACR,MAAM,IAAI,CAAC;CACf;AAYD;;;GAGG;AACH,eAAO,MAAM,cAAc,SAAU,CAAC;AAKtC,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAwJD,UAAU,oBAAoB;IAC5B,cAAc,CAAC,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7C;AAsJD,oFAAoF;AACpF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,oBAAoB,EAC7B,OAAO,GAAE,0BAA+B;4BAwaT,OAAO,KAAG,IAAI;gCAiGnC,OAAO,kBACQ;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KAC7C,OAAO,CAAC,IAAI,CAAC;;;EAkKjB;AA0BD,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CA4D5E;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAC1B,OAAO,EAAE;IAAE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,EACtD,OAAO,EAAE,OAAO,GACf,IAAI,CAEN"}

package/dist/runtime.js

@@ -3481,6 +3481,7 @@ var AdaptiveChipsStripMountable = {
 // src/hostAgentController.ts
 var READ_TOOL = "read_brand_view";
 var MISSING_RESULT_MS = 8e3;
+var PENDING_MAX_MS = 12e4;
 var AGENT_TURN_KEY = "syntro/agent-turn";
 var CARD_HEARTBEAT_PREFIX = "syntro:mcp-card:";
 var heartbeatPrefix = (sessionRef) => `${CARD_HEARTBEAT_PREFIX}${sessionRef}:`;
@@ -3609,6 +3610,7 @@ function activateHostAgentController(runtime2, bridge, hostUi, options = {}) {
   let heartbeatTimer;
   let popOutDecided = false;
   let born;
+  let showingEarlyRead = false;
   let answerIssuedAt;
   let heartbeatSession;
   let folded = false;
@@ -3802,33 +3804,41 @@ function activateHostAgentController(runtime2, bridge, hostUi, options = {}) {
       }
     });
   }
-  function scheduleHostRead(sessionRef) {
+  function scheduleHostRead(sessionRef, why = "reload") {
     if (disposed || readRequested || typeof bridge.callServerTool !== "function") return;
     const call = bridge.callServerTool.bind(bridge);
     readRequested = true;
     const expected = generation;
+    const readAgain = () => {
+      if (disposed || why !== "turn_started") return;
+      readRequested = false;
+      if (session) scheduleHostRead(session.session_ref);
+    };
     void Promise.resolve().then(() => {
-      if (disposed || expected !== generation) return;
+      if (disposed) return;
+      if (expected !== generation) return readAgain();
       queue(async () => {
         const appliedAtIssue = applied;
-        reportCardStage("read_brand_view_called", { why: "reload" });
+        reportCardStage("read_brand_view_called", { why });
         void call({ name: READ_TOOL, arguments: { sessionRef } }).then((result) => {
-          reportReadAnswer("reload", result);
-          if (disposed || expected !== generation) return;
+          reportReadAnswer(why, result);
+          if (disposed) return;
+          if (expected !== generation) return readAgain();
           if (applied !== appliedAtIssue) {
             reportCardStage("tool_result_rejected", { reason: "stale" });
             return;
           }
-          return consumeToolResult(result);
+          return consumeToolResult(result, { earlyRead: why === "turn_started" });
         }).catch((error) => {
           reportCardStage("read_brand_view_answered", {
-            why: "reload",
+            why,
             ok: false,
             withAgentTurn: false,
             // The host's own words for the refusal: a read that never
             // reaches the connector leaves no other record of why.
             reason: readFailureReason(error instanceof Error ? error.message : String(error))
           });
+          if (why === "turn_started") return readAgain();
           if (!disposed && expected === generation)
             runtime2.events.publish("host.ui_error", { reason: "refresh_required" });
         });
@@ -3921,7 +3931,7 @@ function activateHostAgentController(runtime2, bridge, hostUi, options = {}) {
           result_id: outcome.resultId,
           tiles: tiles.length
         });
-        if (born === void 0 && tiles.length > 0) {
+        if (born === void 0 && tiles.length > 0 && !showingEarlyRead) {
           born = answerIssuedAt ?? Date.now();
           writeHeartbeat();
         }
@@ -3929,7 +3939,7 @@ function activateHostAgentController(runtime2, bridge, hostUi, options = {}) {
       }
     });
   }
-  async function consumeToolResult(result) {
+  async function consumeToolResult(result, { earlyRead = false } = {}) {
     if (disposed) return;
     const turn = decodeAgentTurn(result);
     if (!turn) {
@@ -3937,8 +3947,11 @@ function activateHostAgentController(runtime2, bridge, hostUi, options = {}) {
         reportCardStage("tool_result_rejected", { reason: "decode_failed" });
       return;
     }
-    answerIssuedAt ?? (answerIssuedAt = turn.issuedAt ?? Date.now());
-    considerPopOut(turn.session.session_ref);
+    showingEarlyRead = earlyRead;
+    if (!earlyRead) {
+      answerIssuedAt ?? (answerIssuedAt = turn.issuedAt ?? Date.now());
+      considerPopOut(turn.session.session_ref);
+    }
     acceptHostUi2({ kind: "session", session: turn.session });
     acceptHostUi2({ kind: "frame", frame: turn.frame });
     startHeartbeat(turn.session.session_ref);
@@ -3996,6 +4009,32 @@ function activateHostAgentController(runtime2, bridge, hostUi, options = {}) {
     void consumeToolResult(result);
   };
   const stopActivity = bridge.subscribeToolActivity?.(standDown);
+  let turnPending;
+  let pendingTimer;
+  function publishTurnPending(value) {
+    if (disposed || turnPending === value) return;
+    turnPending = value;
+    if (pendingTimer !== void 0) clearTimeout(pendingTimer);
+    pendingTimer = value ? setTimeout(() => publishTurnPending(false), PENDING_MAX_MS) : void 0;
+    runtime2.events.publish("host.turn_pending", { pending: value });
+  }
+  const stopPendingRequests = runtime2.events.subscribe?.(
+    { names: ["canvas:turn-pending-request"] },
+    () => {
+      if (!disposed && turnPending !== void 0)
+        runtime2.events.publish("host.turn_pending", { pending: turnPending });
+    }
+  );
+  const stopToolCall = bridge.subscribeToolCall?.((call) => {
+    if (disposed) return;
+    if (call.phase === "input") {
+      publishTurnPending(true);
+      const sessionRef = call.arguments.sessionRef;
+      if (nonempty(sessionRef) && !session) scheduleHostRead(sessionRef, "turn_started");
+      return;
+    }
+    void Promise.resolve().then(() => queue(async () => publishTurnPending(false)));
+  });
   const unsubscribe = bridge.subscribeToolResults(deliver, {
     metadataKey: AGENT_TURN_KEY
   });
@@ -4013,6 +4052,9 @@ function activateHostAgentController(runtime2, bridge, hostUi, options = {}) {
       if (missingTimer !== void 0) clearTimeout(missingTimer);
       missingTimer = void 0;
       stopActivity?.();
+      stopToolCall?.();
+      stopPendingRequests?.();
+      if (pendingTimer !== void 0) clearTimeout(pendingTimer);
       stopStarRequests?.();
       stopHeartbeat();
       stopObserver?.();