@yaklabs-ai/plugin-sdk 0.15.3 → 0.27.0

package/dist/canonical-transcript.js

@@ -14,10 +14,12 @@ var BACKGROUND_TASK_RESULT_CUSTOM_TYPE = "background_task_result";
 
 // packages/herd-transcript/dist/run-failure-reason.js
 var RUN_FAILURE_REASONS = [
+  "account_unreachable",
   "auth",
   "cancelled",
   "content_blocked",
   "context_overflow",
+  "final_output_missing",
   "invalid_request",
   "model_disabled",
   "model_unavailable",
@@ -402,15 +404,16 @@ var HerdSessionProjection = z4.discriminatedUnion("type", [
   z4.strictObject({
     type: z4.literal("herd.custom.entry.appended"),
     customType: z4.string().min(1),
-    data: z4.json()
+    data: z4.json(),
+    entryId: z4.string().min(1).optional()
   }),
   z4.strictObject({
     type: z4.literal("herd.context.window.updated"),
     snapshot: HerdContextWindowSnapshot,
     /**
-     * Why this snapshot was taken. `provider_request` — emitted synchronously
+     * Why this snapshot was taken. `provider_request` - emitted synchronously
      * from the model-boundary context hook (every LLM request boundary);
-     * `refresh` — emitted on all other paths (post-compaction rebuild, model
+     * `refresh` - emitted on all other paths (post-compaction rebuild, model
      * change, post-run settlement). Absent on legacy stored projections.
      */
     cause: z4.enum(["provider_request", "refresh"]).optional(),
@@ -419,7 +422,7 @@ var HerdSessionProjection = z4.discriminatedUnion("type", [
      * projection whose pass actually elided something. Absent means the pass was a no-op for
      * that request, never "unknown". `reclaimedTokens` is CARRIED (re-counted on every later
      * request the elision keeps content off the wire), and `firstRequestAfterBoundary` is the cold/warm
-     * discriminator any pricing MUST split on — see `ContextElisionStats` in herd's
+     * discriminator any pricing MUST split on - see `ContextElisionStats` in herd's
      * context-projection module for the full read rules.
      */
     elision: z4.strictObject({
@@ -464,7 +467,7 @@ function finalOutputCaptureFromDetails(toolCallId, details) {
     toolCallId,
     ...typeof value.terminatesRun === "boolean" ? { terminatesRun: value.terminatesRun } : {},
     // Legacy transcripts carry the duplicated reply prose; new entries do
-    // not. Read it only when it is actually a string — durable data.
+    // not. Read it only when it is actually a string - durable data.
     ...typeof value.message === "string" ? { message: value.message } : {},
     result: value.result,
     // Re-checked on the way out of durable storage, not trusted from it: a
@@ -540,6 +543,11 @@ function isKernelMessageRole(role) {
   return Object.hasOwn(KERNEL_MESSAGE_ROLES, role);
 }
 
+// packages/herd-transcript/dist/is-object.js
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // packages/herd-transcript/dist/run-failure-classifier.js
 var MAX_FAILURE_TEXT_CHARS = 2e3;
 function boundedFailureText(text) {
@@ -617,13 +625,6 @@ function parsePresentationAnchor(value) {
 
 // packages/herd-transcript/dist/tool-call-failure.js
 import { z as z5 } from "zod";
-
-// packages/herd-transcript/dist/is-object.js
-function isObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-// packages/herd-transcript/dist/tool-call-failure.js
 var TOOL_CALL_FAILURE_DETAILS_KEY = "toolCallFailure";
 var TOOL_CALL_FAILURE_DOMAIN = "tool-call";
 var TOOL_CALL_FAILURE_CATEGORIES = [
@@ -636,6 +637,7 @@ var TOOL_CALL_FAILURE_CATEGORIES = [
   "timeout",
   "unavailable",
   "cancelled",
+  "waiting",
   "unknown"
 ];
 var TOOL_CALL_FAILURE_ACTIONS = [
@@ -643,6 +645,7 @@ var TOOL_CALL_FAILURE_ACTIONS = [
   "connect",
   "retry",
   "none",
+  "wait",
   "unknown"
 ];
 var TOOL_CALL_FAILURE_CODES = [
@@ -653,6 +656,8 @@ var TOOL_CALL_FAILURE_CODES = [
   "tool.not_found",
   "tool.unavailable",
   "tool.execution_failed",
+  "tool.auth_unavailable",
+  "tool.replies_owed",
   "provider.http",
   "provider.api",
   "provider.transport",
@@ -673,7 +678,7 @@ var toolCallFailureDetailsSchema = z5.strictObject({
   moduleId: z5.string().optional(),
   /**
    * [#5042] The registration that owns the FAILING TOOL, host-stamped from the
-   * session's own tool source index — `herd.core` for a kernel tool,
+   * session's own tool source index - `herd.core` for a kernel tool,
    * `kay.task-introspection` for a daemon app-extension's, a plugin's id for a
    * plugin's, and the bare layer sentinel (`builtin`, `host`, `extension`) when
    * a registration named no owner.
@@ -681,7 +686,7 @@ var toolCallFailureDetailsSchema = z5.strictObject({
    * Distinct from {@link moduleId}, which names a URI MODULE and is stamped
    * only by a URI verb dispatch (#4954). Every failure has an owning tool; only
    * a URI dispatch has a module. Read together they answer "who failed" for
-   * every tool call rather than only the URI ones — the fall-through #4954 left
+   * every tool call rather than only the URI ones - the fall-through #4954 left
    * open, where a `task`-kind tool throwing a plain `Error` reached the
    * classifier's terminal branch with nothing to attribute it to.
    *
@@ -692,7 +697,16 @@ var toolCallFailureDetailsSchema = z5.strictObject({
   operation: z5.string().optional(),
   uri: z5.string().optional(),
   path: z5.string().optional(),
-  validationField: z5.string().optional(),
+  /**
+   * The dotted path of the first argument the tool's schema rejected
+   * (`result.status`, `root` for the whole object), and the rule it broke
+   * ("must have required property 'summary'"). Both come from the schema, so
+   * they are exportable; neither ever carries the rejected value. One
+   * exception to "from the schema": a free-form map puts its own keys in the
+   * path, so both are capped.
+   */
+  validationField: z5.string().max(200).optional(),
+  validationRule: z5.string().max(200).optional(),
   errorName: z5.string().optional(),
   errorCode: z5.string().optional(),
   providerCode: z5.string().optional(),
@@ -1047,9 +1061,10 @@ function reduceMessageStart(state, event, replay) {
 }
 function reduceMessageUpdate(state, event, replay) {
   const messageId = getMessageId(event) ?? state.streamingAssistantId;
-  const current = messageId !== void 0 ? findMessageItem(state, messageId, replay) : void 0;
+  const liveIndex = messageId === void 0 || replay !== void 0 ? -1 : lastMessageIndex(state.items, messageId);
+  const current = replay !== void 0 ? messageId === void 0 ? void 0 : findMessageItem(state, messageId, replay) : liveIndex === -1 ? void 0 : state.items[liveIndex];
   const updated = current === void 0 ? void 0 : mergeMessageUpdate(current, event);
-  const baseState = updated !== void 0 ? replaceMessageItem(state, updated, replay) : reduceMessageStart(state, {
+  const baseState = updated !== void 0 ? replay === void 0 ? replaceItemAt(state, liveIndex, updated) : replaceMessageItem(state, updated, replay) : reduceMessageStart(state, {
     ...event,
     role: "assistant"
   }, replay);
@@ -1098,7 +1113,7 @@ function mergeMessageContent(item, event, status) {
     // The terminal merge (message_end) stamps completion; `startedAt` was
     // stamped at message_start and is never overwritten by later events.
     ...status === "streaming" || item.completedAt !== void 0 ? {} : stringField("completedAt", getTimestamp(event)),
-    ...messageMetadata(event, textPhaseFor(event, effectiveParts), effectiveParts)
+    ...messageMetadata(event, textPhaseFor(event, effectiveParts, item.parts), effectiveParts)
   };
 }
 function mergeMessageDelta(item, event) {
@@ -1248,12 +1263,12 @@ function messageFailureReason(event) {
     ...errorText === void 0 ? {} : { failureText: readableFailureText(errorText) }
   };
 }
-function textPhaseFor(event, parts) {
+function textPhaseFor(event, parts, streamedParts = []) {
   if (event.type !== "message_end")
     return "provisional";
+  const isCall = (part) => part.type === "tool_call";
+  const callsTool = parts.some(isCall) || streamedParts.some(isCall);
   switch (finishReasonFor(event, parts)) {
-    case "tool_use":
-      return "narration";
     case "complete":
       return "final";
     case "interrupted":
@@ -1261,8 +1276,11 @@ function textPhaseFor(event, parts) {
       return "interrupted";
     case "error":
       return "error";
+    // Text is narration only beside a call it leads into. A provider can report `tool_use`
+    // with no call in the message; that text is the reply, as a stop's would be.
+    case "tool_use":
     case "unknown":
-      return parts.some((part) => part.type === "tool_call") ? "narration" : "final";
+      return callsTool ? "narration" : "final";
     case void 0:
       return "final";
   }
@@ -1693,6 +1711,14 @@ function upsertMessageItem(state, item, replay) {
   }
   return replaceMessageItem(state, item, replay);
 }
+function lastMessageIndex(items, messageId) {
+  return items.findLastIndex((candidate) => candidate.type === "message" && candidate.id === messageId);
+}
+function replaceItemAt(state, index, item) {
+  const items = state.items.slice();
+  items[index] = item;
+  return { ...state, items };
+}
 function replaceMessageItem(state, item, replay) {
   if (replay !== void 0) {
     const itemIndex = replay.messageIndexById.get(item.id);
@@ -1762,7 +1788,9 @@ function upsertToolCall(state, update, options = {}, replay) {
   };
   let items;
   if (replay === void 0) {
-    items = previous === void 0 ? [...state.items, nextItem] : state.items.map((candidate) => candidate.type === "tool" && candidate.id === itemId ? nextItem : candidate);
+    items = liveToolItems(state, previous, nextItem);
+    if (items === state.items)
+      return state;
   } else if (previous === void 0) {
     const index = replay.items.length;
     replay.items.push(nextItem);
@@ -1795,6 +1823,21 @@ function upsertToolCall(state, update, options = {}, replay) {
     nextItemIndex: previous === void 0 ? nextItemIndexAfter(state, itemId) : state.nextItemIndex
   };
 }
+function liveToolItems(state, previous, next) {
+  if (previous === void 0)
+    return [...state.items, next];
+  const pending = state.pendingToolsByCallId[next.toolCallId];
+  const pendingUnchanged = isTerminalToolStatus(next.status) ? pending === void 0 : pending === next.id;
+  if (pendingUnchanged && sameToolCall(previous, next))
+    return state.items;
+  const copy = state.items.slice();
+  copy[lastToolIndex(state.items, next.id)] = next;
+  return copy;
+}
+function sameToolCall(a, b) {
+  const keys = Object.keys(a);
+  return keys.length === Object.keys(b).length && keys.every((key) => Object.hasOwn(b, key) && a[key] === b[key]);
+}
 function isEmptyStructuredArguments(value) {
   const trimmed = value?.trim();
   return trimmed === "{}" || trimmed === "[]";
@@ -1805,7 +1848,7 @@ function findToolItemByAttemptId(state, attemptId, replay) {
     const item = replayIndex === void 0 ? void 0 : replay.items[replayIndex];
     return item?.type === "tool" ? item : void 0;
   }
-  return state.items.find((candidate) => candidate.type === "tool" && candidate.attemptId === attemptId);
+  return state.items.findLast((candidate) => candidate.type === "tool" && candidate.attemptId === attemptId);
 }
 function nextAttemptGeneration(state, toolCallId, replay) {
   if (replay !== void 0) {
@@ -1836,7 +1879,11 @@ function findToolItem(state, itemId, replay) {
     const item = replayIndex === void 0 ? void 0 : replay.items[replayIndex];
     return item?.type === "tool" ? item : void 0;
   }
-  return state.items.find((candidate) => candidate.type === "tool" && candidate.id === itemId);
+  const index = lastToolIndex(state.items, itemId);
+  return index === -1 ? void 0 : state.items[index];
+}
+function lastToolIndex(items, itemId) {
+  return items.findLastIndex((candidate) => candidate.type === "tool" && candidate.id === itemId);
 }
 function findToolItemByCallId(state, toolCallId, replay) {
   if (replay !== void 0) {
@@ -3053,12 +3100,42 @@ function projectCanonicalTranscript(state, placements) {
   const latestSegment = segments[segments.length - 1];
   const transcriptEndsWithAgentSegment = turns[turns.length - 1] === void 0;
   for (const segment of segments) {
-    turns[segment.slot] = projectAgentTurn(segment.items, segment.causedByUserMessageId, segment.causeItem, transcriptEndsWithAgentSegment && segment === latestSegment, projectedState, anchorIndex, placements);
+    const isLatestTurn = transcriptEndsWithAgentSegment && segment === latestSegment;
+    turns[segment.slot] = isLatestTurn ? projectAgentTurn(segment.items, segment.causedByUserMessageId, segment.causeItem, true, projectedState, anchorIndex, placements) : projectSettledAgentTurn(segment, anchorIndex, projectedState, placements);
   }
   return {
     turns: withRecoveryFlags(turns.filter((turn) => turn !== void 0))
   };
 }
+var settledTurnProjections = /* @__PURE__ */ new WeakMap();
+function projectSettledAgentTurn(segment, anchorIndex, state, placements) {
+  const { items, causedByUserMessageId, causeItem } = segment;
+  const ranks = items.map((item) => anchorIndex?.firstRankByTypeAndId.get(item.type)?.get(item.id));
+  const first = items[0];
+  const previous = settledTurnProjections.get(first);
+  if (previous !== void 0 && previous.causedByUserMessageId === causedByUserMessageId && previous.causeItem === causeItem && previous.placements === placements && sameElements(previous.items, items) && sameElements(previous.ranks, ranks)) {
+    return previous.turn;
+  }
+  const turn = projectAgentTurn(items, causedByUserMessageId, causeItem, false, state, anchorIndex, placements);
+  settledTurnProjections.set(first, {
+    items,
+    causedByUserMessageId,
+    causeItem,
+    placements,
+    ranks,
+    turn
+  });
+  return turn;
+}
+function sameElements(a, b) {
+  if (a.length !== b.length)
+    return false;
+  for (let index = 0; index < a.length; index += 1) {
+    if (a[index] !== b[index])
+      return false;
+  }
+  return true;
+}
 function dropRepeatedDeliveries(items) {
   const seen = /* @__PURE__ */ new Set();
   let dropped = false;
@@ -3738,6 +3815,19 @@ function optional(key, value) {
   return value === void 0 ? {} : { [key]: value };
 }
 
+// packages/herd-transcript/dist/interactive/stored-run-state.js
+var RUN_TERMINAL_CUSTOM_TYPE = "session_run_state";
+function storedRunOutcome(value) {
+  return value === "interrupted" || value === "cancelled" || value === "failed" || value === "completed" ? value : void 0;
+}
+function storedRunOutcomeOfRecord(data) {
+  const runState = storedRunOutcome(data["runState"]);
+  if (runState === "cancelled" && data["stop"] === void 0) {
+    return "interrupted";
+  }
+  return runState;
+}
+
 // packages/herd-transcript/dist/interactive/reconstruct.js
 function eventsForEntry(entry) {
   if (entry.type === "compaction") {
@@ -3796,27 +3886,12 @@ function reconstructInteractiveState(entries) {
   return reduceInteractiveModeEventsForReplay(replayEvents());
 }
 function runBoundaryReplayEvent(entry) {
-  if (entry.type !== "custom" || entry.customType !== "session_run_state") {
+  if (entry.type !== "custom" || entry.customType !== RUN_TERMINAL_CUSTOM_TYPE) {
     return void 0;
   }
   const data = asRecord3(entry.data);
-  const runState = data?.["runState"];
-  switch (runState) {
-    case "completed":
-    case "failed":
-    case "interrupted":
-    case "cancelled":
-      return {
-        type: "host_run_status",
-        run: {
-          status: "settled",
-          // Bare cancelled entries predate the interrupt/cancel split.
-          outcome: runState === "cancelled" && data?.["stop"] === void 0 ? "interrupted" : runState
-        }
-      };
-    default:
-      return void 0;
-  }
+  const outcome = data === void 0 ? void 0 : storedRunOutcomeOfRecord(data);
+  return outcome === void 0 ? void 0 : { type: "host_run_status", run: { status: "settled", outcome } };
 }
 function contentText(content) {
   if (typeof content === "string")