@athenaintel/react 0.19.0 → 0.21.0

package/dist/packages/agent-runtime/src/interrupts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupts.js","sources":["../../../../../agent-runtime/src/interrupts.ts"],"sourcesContent":["/**\n * Human-in-the-loop interrupt primitives shared by every statewire chat\n * surface (Olympus, the React SDK, the Office add-in, the Chrome extension,\n * mobile).\n *\n * The agora deep-agent runtime parks a gated run on an `interrupt` input\n * request whose payload carries the Athena `hitl_approval` shape\n * (`athena_deep_agent/hitl_bridge.py`). A surface answers it with\n * `{ type: 'run/input', requestId, response: { type: 'resume', value } }` —\n * the exact command the backend's resume path consumes. This module holds the\n * payload contract (narrowing, resume values) and the shared resume-lock state\n * machine; rendering stays with each surface.\n *\n * Deliberately parameterized rather than self-wiring: these helpers never call\n * `useStatewireRuns`/`useAuiState` themselves. Each surface reads its own\n * statewire hooks (which its tests already mock) and passes the values in, so\n * the shared semantics cannot drift while per-surface wiring stays testable.\n */\n\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { hasClientToolInterruptSource } from './client-tools';\nimport { readDeepAgentStreamValues } from './statewire-state';\n\n/** Human-in-the-loop approval payload the agora deep-agent runtime parks a run\n *  on (shaped by `athena_deep_agent/hitl_bridge.py`). */\nexport interface HitlApprovalPayload {\n  source: string;\n  type: string;\n  message: string;\n  /** Risk headline/facts/warnings, when the host includes them. */\n  approval_context?: unknown;\n  context?: {\n    tool_name?: string;\n    tool_id?: string;\n    tool_call_id?: string;\n    tool_args?: Record<string, unknown>;\n    pending_action_count?: number;\n    approval_context?: unknown;\n    /**\n     * Every pending gated call (name + args), in decision order. Absent on\n     * older backends — fall back to the single `tool_name`/`tool_args` pair.\n     * Per-dispatch payloads also carry each lane's `tool_call_id` (the lane\n     * card key) and `interrupt_id` (the lane resume key).\n     */\n    action_requests?: {\n      name?: string;\n      args?: Record<string, unknown>;\n      tool_call_id?: string;\n      interrupt_id?: string;\n    }[];\n    /**\n     * True when each dispatch parked on its own interrupt: decisions submit\n     * per lane via `lane_decisions` and each approved lane starts immediately,\n     * instead of the legacy batch where one resume must answer every lane.\n     */\n    per_dispatch?: boolean;\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** A pending `interrupt` input request; a present `response` key marks it answered. */\nexport function isPendingInterrupt(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  return request.type === 'interrupt' && !('response' in request);\n}\n\n/**\n * Interrupt sources that were system pauses before the host stamped\n * `requires_user_action: false` on them (a background deep-research wait). Kept\n * only for the deploy skew between an older agora and a newer client; delete\n * once every deployment's raiser stamps the flag.\n */\nconst LEGACY_SYSTEM_PAUSE_INTERRUPT_SOURCES: ReadonlySet<string> = new Set(['deep_research_pending']);\n\n/**\n * A park nobody answers: the agent is still working (a background research\n * wait) and the backend resumes it itself. The raiser stamps\n * `requires_user_action: false`; older raisers are recognised by source.\n */\nexport function isSystemPauseInterrupt(payload: unknown): boolean {\n  if (!isRecord(payload)) return false;\n  if (payload.requires_user_action === false) return true;\n  return (\n    typeof payload.source === 'string' && LEGACY_SYSTEM_PAUSE_INTERRUPT_SOURCES.has(payload.source)\n  );\n}\n\n/**\n * A pending interrupt an approval card may answer. Two kinds are excluded —\n * client-tool parks (the client-tool bridge owns those, and a generic resume\n * would corrupt the parked tool call) and system pauses (nothing to answer; the\n * backend resumes them). The source checks are deliberately loose so a skewed\n * deploy can never route one here.\n */\nexport function isApprovalCardInterrupt(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  if (!isPendingInterrupt(request)) return false;\n  const payload = (request as { payload?: unknown }).payload;\n  return !hasClientToolInterruptSource(payload) && !isSystemPauseInterrupt(payload);\n}\n\n/** Narrow an interrupt payload to the Athena HITL approval shape. */\nexport function asHitlApproval(value: unknown): HitlApprovalPayload | null {\n  if (!isRecord(value)) return null;\n  return value.type === 'hitl' &&\n    value.source === 'hitl_approval' &&\n    typeof value.message === 'string'\n    ? (value as unknown as HitlApprovalPayload)\n    : null;\n}\n\n/** Default paused-run copy when an interrupt payload carries no message. */\nexport const DEFAULT_INTERRUPT_PAUSED_MESSAGE =\n  'The agent is paused and waiting for input.';\n\n/** Best-effort human-readable message from any interrupt payload. */\nexport function readInterruptMessage(\n  value: unknown,\n  fallback: string = DEFAULT_INTERRUPT_PAUSED_MESSAGE,\n): string {\n  if (isRecord(value) && typeof value.message === 'string' && value.message.length > 0) {\n    return value.message;\n  }\n  return fallback;\n}\n\nexport interface PendingActionRequest {\n  name: string;\n  args: Record<string, unknown>;\n  /** The lane's `task` tool-call id (present on per-dispatch payloads). */\n  toolCallId?: string;\n  /** The lane's langgraph interrupt id — the `lane_decisions` resume key. */\n  interruptId?: string;\n}\n\n/**\n * Every gated call this approval covers, in decision order. One resume answers\n * ALL of them, so every entry must stay reviewable somewhere. Falls back to\n * the single first-call fields on older backends without `action_requests`.\n */\nexport function pendingActionRequests(hitl: HitlApprovalPayload | null): PendingActionRequest[] {\n  const context = hitl?.context;\n  if (!context) return [];\n  // The payload crosses the wire with only its top-level shape narrowed\n  // (`asHitlApproval`), so the nested collection must be validated before any\n  // array/property access: a malformed host value must degrade to \"no\n  // reviewable entries\", never crash the approval surface.\n  const requests: Record<string, unknown>[] = Array.isArray(context.action_requests)\n    ? context.action_requests.filter(isRecord)\n    : context.tool_name && context.tool_args\n      ? [{ name: context.tool_name, args: context.tool_args }]\n      : [];\n  return requests.map((request) => ({\n    name: typeof request.name === 'string' ? request.name : 'tool',\n    args: isRecord(request.args) ? request.args : {},\n    ...(typeof request.tool_call_id === 'string' && { toolCallId: request.tool_call_id }),\n    ...(typeof request.interrupt_id === 'string' && { interruptId: request.interrupt_id }),\n  }));\n}\n\n/** An interrupt a non-resume dispatch dropped, published by the host. */\nexport interface AbandonedInputRequest {\n  id: string;\n  type: string;\n}\n\n/**\n * `useStatewireState` selector body for the host-published abandoned input\n * requests. Reads through {@link readDeepAgentStreamValues} so the selector is\n * safe on the pre-attach (`undefined`) wire state, and returns the raw array\n * reference so the subscription stays shallow-stable — derive (`.find`) on the\n * result, never inside the selector.\n */\nexport function readAbandonedInputRequests(\n  state: unknown,\n): readonly AbandonedInputRequest[] | undefined {\n  const abandoned = readDeepAgentStreamValues(state).abandonedInputRequests;\n  // Wire value: anything non-array (including a malformed host publication)\n  // reads as \"none\" rather than crashing the consuming surface. Identity-\n  // preserving for the valid case, so it stays selector-safe.\n  return Array.isArray(abandoned)\n    ? (abandoned as readonly AbandonedInputRequest[])\n    : undefined;\n}\n\n/** The abandoned `interrupt` entry, if any — the \"approval was cancelled\" notice. */\nexport function findAbandonedInterrupt(\n  abandoned: readonly AbandonedInputRequest[] | undefined,\n): AbandonedInputRequest | undefined {\n  return abandoned?.find(\n    (request) => isRecord(request) && request.type === 'interrupt' && typeof request.id === 'string',\n  );\n}\n\n/** Canonical reason string carried by a user rejection. */\nexport const HITL_REJECT_REASON = 'User rejected the action.';\n\n/**\n * Default {@link UseApprovalResumeLockOptions.pendingResumeGraceMs} for every\n * approval surface: how long a clicked decision waits for its resume run to\n * start before the actions unlock again. Covers a `run/input` the host\n * rejected or a disconnected transport swallowed before any run began — the\n * one failure neither identity-change nor observed-run recovery can detect.\n */\nexport const HITL_PENDING_RESUME_GRACE_MS = 15_000;\n\n/** `run/input` resume value approving the gated call(s). */\nexport function hitlResumeApprove(): Record<string, string> {\n  return { action: 'approve' };\n}\n\n/** `run/input` resume value rejecting the gated call(s). */\nexport function hitlResumeReject(reason: string = HITL_REJECT_REASON): Record<string, string> {\n  return { action: 'reject', reason };\n}\n\n/** Canonical reason string carried by a user declining a non-HITL park. */\nexport const INTERRUPT_DECLINE_REASON = 'User declined the request.';\n\n/**\n * `run/input` resume value declining a non-HITL park. `{ action: 'reject' }`\n * is the one value every typed raiser treats as a clean user decline\n * (`FormCancelledError` / `ToolRejectedError`); a generic `continue` would be\n * rejected by their resume schemas and surface as a tool error the agent then\n * improvises around.\n */\nexport function interruptResumeDecline(\n  reason: string = INTERRUPT_DECLINE_REASON,\n): Record<string, string> {\n  return { action: 'reject', reason };\n}\n\nexport interface UseApprovalResumeLockOptions<TValue> {\n  /** The pending interrupt's request id (`undefined` when nothing is parked). */\n  requestId: string | undefined;\n  /** The surface's thread `isRunning` read (mockable per surface). */\n  isRunning: boolean;\n  /**\n   * Dispatch the `run/input` resume for `requestId` on the surface's transport.\n   * Return the dispatch promise so a refused or lost command releases the lock\n   * at once and reaches `onResumeRejected`; a `void` return leaves the\n   * recovery paths below as the only release.\n   */\n  sendResume: (requestId: string, value: TValue) => void | Promise<unknown>;\n  /**\n   * The dispatch `sendResume` returned rejected — the host refused the\n   * `run/input` or the transport lost it. The lock is already released when\n   * this fires; the surface tells the user, since the request is back on\n   * screen with nothing else saying why.\n   */\n  onResumeRejected?: (error: unknown, requestId: string) => void;\n  /**\n   * Re-enable the actions when no resume run started within this window —\n   * covers a `run/input` that was rejected or lost before any run began, so\n   * neither reset path below can fire. Omit to keep the pre-existing surface\n   * behavior of staying locked until a resume run is observed.\n   */\n  pendingResumeGraceMs?: number;\n}\n\nexport interface ApprovalResumeLock<TValue> {\n  /** True after a resume until the request identity changes (or recovery fires). */\n  pending: boolean;\n  /**\n   * Send the resume value, locking the actions. No-op (returns `undefined`)\n   * while pending or unparked. Returns the dispatch promise when `sendResume`\n   * produced one, so a surface can hold its own state until the host settles.\n   */\n  resume: (value: TValue) => Promise<unknown> | undefined;\n}\n\n/**\n * Optimistic action lock shared by every approval surface: disable the\n * decision buttons the moment one is clicked, until the request identity\n * changes (it clears after the resume, or a fresh interrupt arrives). This\n * closes the double-click → duplicate-resume window.\n *\n * Recovery paths, in order of specificity:\n * 0. The dispatch itself rejected (a `sendResume` that returned a promise) —\n *    released at once, and reported through `onResumeRejected`.\n * 1. Identity change — the resume landed (or a new interrupt replaced the\n *    request). Reset during render via React's \"previous value\" pattern.\n * 2. A resume run was observed starting and then settling with the request\n *    still pending (failed/cancelled resume) — clear the lock so the user can\n *    answer again.\n * 3. Optional grace window ({@link UseApprovalResumeLockOptions.pendingResumeGraceMs})\n *    for a `run/input` that never started a run at all.\n */\nexport function useApprovalResumeLock<TValue = Record<string, string>>(\n  options: UseApprovalResumeLockOptions<TValue>,\n): ApprovalResumeLock<TValue> {\n  const { requestId, isRunning, sendResume, pendingResumeGraceMs, onResumeRejected } = options;\n\n  const [pending, setPending] = useState(false);\n  const prevRequestIdRef = useRef(requestId);\n  if (prevRequestIdRef.current !== requestId) {\n    prevRequestIdRef.current = requestId;\n    if (pending) setPending(false);\n  }\n\n  // Track the resume run we kicked off (isRunning observed true→false while\n  // pending) and clear `pending` when it ends with the request unresolved.\n  const sawResumeRunRef = useRef(false);\n  useEffect(() => {\n    if (!pending) {\n      sawResumeRunRef.current = false;\n      return;\n    }\n    if (isRunning) {\n      sawResumeRunRef.current = true;\n      return;\n    }\n    if (sawResumeRunRef.current) {\n      sawResumeRunRef.current = false;\n      setPending(false);\n    }\n  }, [pending, isRunning]);\n\n  // Pre-start failure recovery: re-enable after the grace window when no\n  // resume run began; answering the still-parked request again is exactly\n  // what the user needs to be able to do.\n  useEffect(() => {\n    if (!pending || pendingResumeGraceMs === undefined) return;\n    const timer = setTimeout(() => {\n      if (!sawResumeRunRef.current) setPending(false);\n    }, pendingResumeGraceMs);\n    return () => clearTimeout(timer);\n  }, [pending, requestId, pendingResumeGraceMs]);\n\n  const sendResumeRef = useRef(sendResume);\n  sendResumeRef.current = sendResume;\n  const onResumeRejectedRef = useRef(onResumeRejected);\n  onResumeRejectedRef.current = onResumeRejected;\n  const currentRequestIdRef = useRef(requestId);\n  currentRequestIdRef.current = requestId;\n  const pendingRef = useRef(pending);\n  pendingRef.current = pending;\n\n  const resume = useCallback(\n    (value: TValue): Promise<unknown> | undefined => {\n      if (requestId === undefined || pendingRef.current) return undefined;\n      setPending(true);\n      pendingRef.current = true;\n      const dispatched: unknown = sendResumeRef.current(requestId, value);\n      if (!(dispatched instanceof Promise)) return undefined;\n      dispatched.then(undefined, (error: unknown) => {\n        // A late refusal for a request the lock has since moved past (the\n        // park was re-keyed, or a newer answer is in flight) must neither\n        // release that answer's lock nor be reported as a failure of it.\n        const current = currentRequestIdRef.current;\n        if (current !== undefined && current !== requestId) return;\n        setPending(false);\n        pendingRef.current = false;\n        onResumeRejectedRef.current?.(error, requestId);\n      });\n      return dispatched;\n    },\n    [requestId],\n  );\n\n  return { pending, resume };\n}\n"],"names":[],"mappings":"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"}

package/dist/packages/agent-runtime/src/message-author.cjs

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const ATHENA_MESSAGE_AUTHOR_KEY = "author";
+const optionalString = (value) => typeof value === "string" && value.length > 0 ? value : null;
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function readMessageAuthor(value) {
+  if (!isRecord(value)) return null;
+  const userId = value.user_id;
+  if (typeof userId !== "string" || userId.length === 0) return null;
+  return {
+    user_id: userId,
+    name: optionalString(value.name),
+    email: optionalString(value.email),
+    avatar_url: optionalString(value.avatar_url)
+  };
+}
+function isSameMessageAuthor(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return false;
+  return a.user_id === b.user_id && a.name === b.name && a.email === b.email && a.avatar_url === b.avatar_url;
+}
+function laneEntryAuthor(entry, selfAuthor) {
+  if (entry.meta === void 0) return selfAuthor ?? null;
+  if (!isRecord(entry.meta)) return null;
+  return readMessageAuthor(entry.meta[ATHENA_MESSAGE_AUTHOR_KEY]);
+}
+exports.ATHENA_MESSAGE_AUTHOR_KEY = ATHENA_MESSAGE_AUTHOR_KEY;
+exports.isSameMessageAuthor = isSameMessageAuthor;
+exports.laneEntryAuthor = laneEntryAuthor;
+exports.readMessageAuthor = readMessageAuthor;
+//# sourceMappingURL=message-author.cjs.map

package/dist/packages/agent-runtime/src/message-author.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-author.cjs","sources":["../../../../../agent-runtime/src/message-author.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\n\n/**\n * `metadata.custom` key carrying who sent a human turn.\n *\n * The backend stamps it on every persisted human turn from the authenticated\n * sender (`agora/.../message_author.py`), and on the host `meta` of every\n * run-lane entry it admits (`statewire_host._op_meta`), so a queued or\n * just-sent bubble is attributable before the turn is materialised — on every\n * client on the thread, not only the sender's.\n */\nexport const ATHENA_MESSAGE_AUTHOR_KEY = 'author';\n\n/** Identity of the human who sent a message, as the backend stamps it. */\nexport interface DeepAgentMessageAuthor {\n  user_id: string;\n  name: string | null;\n  email: string | null;\n  avatar_url: string | null;\n}\n\nconst optionalString = (value: unknown): string | null =>\n  typeof value === 'string' && value.length > 0 ? value : null;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/**\n * Parse an author envelope off a wire value.\n *\n * Tolerates absent optional fields (a principal without a name or picture);\n * an envelope without a string `user_id` is no author at all — an\n * identity-less stamp would only mislead the gate that decides whether a\n * transcript has several human participants.\n */\nexport function readMessageAuthor(value: unknown): DeepAgentMessageAuthor | null {\n  if (!isRecord(value)) return null;\n  const userId = value.user_id;\n  if (typeof userId !== 'string' || userId.length === 0) return null;\n  return {\n    user_id: userId,\n    name: optionalString(value.name),\n    email: optionalString(value.email),\n    avatar_url: optionalString(value.avatar_url),\n  };\n}\n\n/** Field-wise equality, so hosts can hold a stable identity across renders. */\nexport function isSameMessageAuthor(\n  a: DeepAgentMessageAuthor | null,\n  b: DeepAgentMessageAuthor | null\n): boolean {\n  if (a === b) return true;\n  if (a === null || b === null) return false;\n  return (\n    a.user_id === b.user_id &&\n    a.name === b.name &&\n    a.email === b.email &&\n    a.avatar_url === b.avatar_url\n  );\n}\n\n/**\n * Who sent a run-lane entry, for its optimistic bubble.\n *\n * Only two sources are trusted. The host stamps `meta` on every entry it\n * admits, so `meta.author` is the server's word on the submitter and is what\n * every OTHER client on the thread renders. An entry with no `meta` at all is\n * this client's own optimistic fold — the send is still in flight — so it is\n * the viewer's (`selfAuthor`), matching what the host stamps on\n * acknowledgment. The entry's client-supplied `metadata` is never consulted:\n * a client that could set it could attribute its words to another\n * collaborator. A host-stamped entry without an author (a host predating the\n * stamp) yields none, so the surface falls back to its own attribution rule.\n */\nexport function laneEntryAuthor(\n  entry: StatewireThread.RunsQueueEntry,\n  selfAuthor: DeepAgentMessageAuthor | null | undefined\n): DeepAgentMessageAuthor | null {\n  if (entry.meta === undefined) return selfAuthor ?? null;\n  if (!isRecord(entry.meta)) return null;\n  return readMessageAuthor(entry.meta[ATHENA_MESSAGE_AUTHOR_KEY]);\n}\n"],"names":[],"mappings":";;AAWO,MAAM,4BAA4B;AAUzC,MAAM,iBAAiB,CAAC,UACtB,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AAE1D,MAAM,WAAW,CAAC,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAU9D,SAAS,kBAAkB,OAA+C;AAC/E,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,SAAS,MAAM;AACrB,MAAI,OAAO,WAAW,YAAY,OAAO,WAAW,EAAG,QAAO;AAC9D,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM,eAAe,MAAM,IAAI;AAAA,IAC/B,OAAO,eAAe,MAAM,KAAK;AAAA,IACjC,YAAY,eAAe,MAAM,UAAU;AAAA,EAAA;AAE/C;AAGO,SAAS,oBACd,GACA,GACS;AACT,MAAI,MAAM,EAAG,QAAO;AACpB,MAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AACrC,SACE,EAAE,YAAY,EAAE,WAChB,EAAE,SAAS,EAAE,QACb,EAAE,UAAU,EAAE,SACd,EAAE,eAAe,EAAE;AAEvB;AAeO,SAAS,gBACd,OACA,YAC+B;AAC/B,MAAI,MAAM,SAAS,OAAW,QAAO,cAAc;AACnD,MAAI,CAAC,SAAS,MAAM,IAAI,EAAG,QAAO;AAClC,SAAO,kBAAkB,MAAM,KAAK,yBAAyB,CAAC;AAChE;;;;;"}

package/dist/packages/agent-runtime/src/message-author.js

@@ -0,0 +1,31 @@
+const ATHENA_MESSAGE_AUTHOR_KEY = "author";
+const optionalString = (value) => typeof value === "string" && value.length > 0 ? value : null;
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function readMessageAuthor(value) {
+  if (!isRecord(value)) return null;
+  const userId = value.user_id;
+  if (typeof userId !== "string" || userId.length === 0) return null;
+  return {
+    user_id: userId,
+    name: optionalString(value.name),
+    email: optionalString(value.email),
+    avatar_url: optionalString(value.avatar_url)
+  };
+}
+function isSameMessageAuthor(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return false;
+  return a.user_id === b.user_id && a.name === b.name && a.email === b.email && a.avatar_url === b.avatar_url;
+}
+function laneEntryAuthor(entry, selfAuthor) {
+  if (entry.meta === void 0) return selfAuthor ?? null;
+  if (!isRecord(entry.meta)) return null;
+  return readMessageAuthor(entry.meta[ATHENA_MESSAGE_AUTHOR_KEY]);
+}
+export {
+  ATHENA_MESSAGE_AUTHOR_KEY,
+  isSameMessageAuthor,
+  laneEntryAuthor,
+  readMessageAuthor
+};
+//# sourceMappingURL=message-author.js.map

package/dist/packages/agent-runtime/src/message-author.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-author.js","sources":["../../../../../agent-runtime/src/message-author.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\n\n/**\n * `metadata.custom` key carrying who sent a human turn.\n *\n * The backend stamps it on every persisted human turn from the authenticated\n * sender (`agora/.../message_author.py`), and on the host `meta` of every\n * run-lane entry it admits (`statewire_host._op_meta`), so a queued or\n * just-sent bubble is attributable before the turn is materialised — on every\n * client on the thread, not only the sender's.\n */\nexport const ATHENA_MESSAGE_AUTHOR_KEY = 'author';\n\n/** Identity of the human who sent a message, as the backend stamps it. */\nexport interface DeepAgentMessageAuthor {\n  user_id: string;\n  name: string | null;\n  email: string | null;\n  avatar_url: string | null;\n}\n\nconst optionalString = (value: unknown): string | null =>\n  typeof value === 'string' && value.length > 0 ? value : null;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/**\n * Parse an author envelope off a wire value.\n *\n * Tolerates absent optional fields (a principal without a name or picture);\n * an envelope without a string `user_id` is no author at all — an\n * identity-less stamp would only mislead the gate that decides whether a\n * transcript has several human participants.\n */\nexport function readMessageAuthor(value: unknown): DeepAgentMessageAuthor | null {\n  if (!isRecord(value)) return null;\n  const userId = value.user_id;\n  if (typeof userId !== 'string' || userId.length === 0) return null;\n  return {\n    user_id: userId,\n    name: optionalString(value.name),\n    email: optionalString(value.email),\n    avatar_url: optionalString(value.avatar_url),\n  };\n}\n\n/** Field-wise equality, so hosts can hold a stable identity across renders. */\nexport function isSameMessageAuthor(\n  a: DeepAgentMessageAuthor | null,\n  b: DeepAgentMessageAuthor | null\n): boolean {\n  if (a === b) return true;\n  if (a === null || b === null) return false;\n  return (\n    a.user_id === b.user_id &&\n    a.name === b.name &&\n    a.email === b.email &&\n    a.avatar_url === b.avatar_url\n  );\n}\n\n/**\n * Who sent a run-lane entry, for its optimistic bubble.\n *\n * Only two sources are trusted. The host stamps `meta` on every entry it\n * admits, so `meta.author` is the server's word on the submitter and is what\n * every OTHER client on the thread renders. An entry with no `meta` at all is\n * this client's own optimistic fold — the send is still in flight — so it is\n * the viewer's (`selfAuthor`), matching what the host stamps on\n * acknowledgment. The entry's client-supplied `metadata` is never consulted:\n * a client that could set it could attribute its words to another\n * collaborator. A host-stamped entry without an author (a host predating the\n * stamp) yields none, so the surface falls back to its own attribution rule.\n */\nexport function laneEntryAuthor(\n  entry: StatewireThread.RunsQueueEntry,\n  selfAuthor: DeepAgentMessageAuthor | null | undefined\n): DeepAgentMessageAuthor | null {\n  if (entry.meta === undefined) return selfAuthor ?? null;\n  if (!isRecord(entry.meta)) return null;\n  return readMessageAuthor(entry.meta[ATHENA_MESSAGE_AUTHOR_KEY]);\n}\n"],"names":[],"mappings":"AAWO,MAAM,4BAA4B;AAUzC,MAAM,iBAAiB,CAAC,UACtB,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AAE1D,MAAM,WAAW,CAAC,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAU9D,SAAS,kBAAkB,OAA+C;AAC/E,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,SAAS,MAAM;AACrB,MAAI,OAAO,WAAW,YAAY,OAAO,WAAW,EAAG,QAAO;AAC9D,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM,eAAe,MAAM,IAAI;AAAA,IAC/B,OAAO,eAAe,MAAM,KAAK;AAAA,IACjC,YAAY,eAAe,MAAM,UAAU;AAAA,EAAA;AAE/C;AAGO,SAAS,oBACd,GACA,GACS;AACT,MAAI,MAAM,EAAG,QAAO;AACpB,MAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AACrC,SACE,EAAE,YAAY,EAAE,WAChB,EAAE,SAAS,EAAE,QACb,EAAE,UAAU,EAAE,SACd,EAAE,eAAe,EAAE;AAEvB;AAeO,SAAS,gBACd,OACA,YAC+B;AAC/B,MAAI,MAAM,SAAS,OAAW,QAAO,cAAc;AACnD,MAAI,CAAC,SAAS,MAAM,IAAI,EAAG,QAAO;AAClC,SAAO,kBAAkB,MAAM,KAAK,yBAAyB,CAAC;AAChE;"}

package/dist/packages/agent-runtime/src/message-window.cjs

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const runconfigContract = require("./generated/runconfig-contract.cjs");
+const isIndex = (value) => typeof value === "number" && Number.isInteger(value) && value >= 0;
+function readDeepAgentMessagesWindow(state) {
+  if (typeof state !== "object" || state === null) return null;
+  const lane = state[runconfigContract.DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY];
+  if (typeof lane !== "object" || lane === null) return null;
+  const { start, total, truncated, size, anchorBefore } = lane;
+  if (!isIndex(start) || !isIndex(total) || !isIndex(size) || typeof truncated !== "boolean") {
+    return null;
+  }
+  if (anchorBefore !== null && typeof anchorBefore !== "string") return null;
+  return { start, total, truncated, size, anchorBefore };
+}
+const clampWindowSize = (size) => Math.max(
+  runconfigContract.DEEP_AGENT_MIN_MESSAGE_WINDOW,
+  Math.min(runconfigContract.DEEP_AGENT_MAX_MESSAGE_WINDOW, Math.trunc(size))
+);
+function withDeclaredMessageWindow(headers, declaration = {}) {
+  const declared = { ...headers };
+  if (!(runconfigContract.DEEP_AGENT_MESSAGE_WINDOW_HEADER in declared)) {
+    const size = declaration.size ?? runconfigContract.DEEP_AGENT_DEFAULT_MESSAGE_WINDOW;
+    declared[runconfigContract.DEEP_AGENT_MESSAGE_WINDOW_HEADER] = String(
+      Number.isFinite(size) ? clampWindowSize(size) : runconfigContract.DEEP_AGENT_DEFAULT_MESSAGE_WINDOW
+    );
+  }
+  if (declaration.provenance === "full" && !(runconfigContract.DEEP_AGENT_PROVENANCE_HEADER in declared)) {
+    declared[runconfigContract.DEEP_AGENT_PROVENANCE_HEADER] = runconfigContract.DEEP_AGENT_PROVENANCE_FULL;
+  }
+  return declared;
+}
+function buildHistoryLoadCommand({
+  window,
+  limit
+}) {
+  if (window.start <= 0) return null;
+  const requested = limit ?? window.size;
+  return {
+    type: runconfigContract.DEEP_AGENT_HISTORY_LOAD_COMMAND,
+    beforeIndex: window.start,
+    limit: Math.max(1, Math.min(runconfigContract.DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT, Math.trunc(requested)))
+  };
+}
+function readHistoryLoadResult(payload) {
+  if (typeof payload !== "object" || payload === null) return null;
+  const { start, total, loaded, stale } = payload;
+  if (!isIndex(start) || !isIndex(total) || !isIndex(loaded)) return null;
+  return { start, total, loaded, stale: stale === true };
+}
+function buildToolOutputCommand({ messageId }) {
+  return { type: runconfigContract.DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND, messageId };
+}
+function readToolOutputResult(payload) {
+  if (typeof payload !== "object" || payload === null) return null;
+  const { messageId, content } = payload;
+  if (typeof messageId !== "string" || !messageId) return null;
+  return { messageId, content };
+}
+function readTruncatedToolContent(message) {
+  if (typeof message !== "object" || message === null) return null;
+  const marker = message[runconfigContract.DEEP_AGENT_TRUNCATED_CONTENT_KEY];
+  if (typeof marker !== "object" || marker === null) return null;
+  const chars = marker.chars;
+  return isIndex(chars) ? { chars } : null;
+}
+const ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY = "_athena_content_truncated";
+function readTruncatedToolOutputArtifact(artifact) {
+  if (typeof artifact !== "object" || artifact === null) return null;
+  const lifted = artifact[ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY];
+  if (typeof lifted !== "object" || lifted === null) return null;
+  const { chars, messageId } = lifted;
+  if (!isIndex(chars) || typeof messageId !== "string" || !messageId) return null;
+  return { chars, messageId };
+}
+exports.ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY = ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY;
+exports.buildHistoryLoadCommand = buildHistoryLoadCommand;
+exports.buildToolOutputCommand = buildToolOutputCommand;
+exports.readDeepAgentMessagesWindow = readDeepAgentMessagesWindow;
+exports.readHistoryLoadResult = readHistoryLoadResult;
+exports.readToolOutputResult = readToolOutputResult;
+exports.readTruncatedToolContent = readTruncatedToolContent;
+exports.readTruncatedToolOutputArtifact = readTruncatedToolOutputArtifact;
+exports.withDeclaredMessageWindow = withDeclaredMessageWindow;
+//# sourceMappingURL=message-window.cjs.map

package/dist/packages/agent-runtime/src/message-window.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-window.cjs","sources":["../../../../../agent-runtime/src/message-window.ts"],"sourcesContent":["import {\n  DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n  DEEP_AGENT_HISTORY_LOAD_COMMAND,\n  DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT,\n  DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND,\n  DEEP_AGENT_MAX_MESSAGE_WINDOW,\n  DEEP_AGENT_MESSAGE_WINDOW_HEADER,\n  DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY,\n  DEEP_AGENT_MIN_MESSAGE_WINDOW,\n  DEEP_AGENT_PROVENANCE_FULL,\n  DEEP_AGENT_PROVENANCE_HEADER,\n  DEEP_AGENT_TRUNCATED_CONTENT_KEY,\n} from './generated/runconfig-contract';\n\n/**\n * The windowed hello — the client half of agora's\n * `agora/graphs/athena_deep_agent/message_window.py`.\n *\n * A surface that declares a message window on its attach headers\n * ({@link withDeclaredMessageWindow}) receives a hello carrying only the last\n * N messages plus the `messagesWindow` lane, and its op stream re-addressed\n * to that window by the host — so `state.messages` is always exactly\n * `server.messages[start:]` and the ordinary converter renders it unchanged.\n * Older ranges arrive through `history/load` ({@link buildHistoryLoadCommand})\n * as ops for this client alone; a truncated tool output comes back whole\n * through `history/tool_output` ({@link buildToolOutputCommand}).\n *\n * Undeclared surfaces (no header) are untouched: full snapshot, no lane.\n * Skew-tolerant both ways — an old server ignores the header and advertises\n * no lane (read as \"everything is loaded\"), a malformed lane reads as absent.\n */\nexport interface DeepAgentMessagesWindow {\n  /** Index in the server transcript of the client's first loaded message. */\n  start: number;\n  /** Server transcript length. */\n  total: number;\n  /** Whether older messages exist that the client has not loaded (`start > 0`). */\n  truncated: boolean;\n  /** The window size the host clamped the declaration to. */\n  size: number;\n  /**\n   * Id of the message just before the window (`null` at the beginning): the\n   * host parent of the first loaded message, so an edit or reload at the\n   * window edge can assert its `runAnchorMessageId` without loading first.\n   */\n  anchorBefore: string | null;\n}\n\nconst isIndex = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isInteger(value) && value >= 0;\n\n/**\n * The window lane off a raw statewire state, or `null` when the wire is not\n * windowed (an undeclared attach, a pre-window server, pre-attach) or the lane\n * is malformed (tolerated as absent — never thrown on).\n */\nexport function readDeepAgentMessagesWindow(state: unknown): DeepAgentMessagesWindow | null {\n  if (typeof state !== 'object' || state === null) return null;\n  const lane = (state as Record<string, unknown>)[DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY];\n  if (typeof lane !== 'object' || lane === null) return null;\n  const { start, total, truncated, size, anchorBefore } = lane as Record<string, unknown>;\n  if (!isIndex(start) || !isIndex(total) || !isIndex(size) || typeof truncated !== 'boolean') {\n    return null;\n  }\n  if (anchorBefore !== null && typeof anchorBefore !== 'string') return null;\n  return { start, total, truncated, size, anchorBefore };\n}\n\n/** How many messages older than the loaded window the server still holds. */\nexport function olderMessageCount(window: DeepAgentMessagesWindow | null): number {\n  return window === null ? 0 : window.start;\n}\n\n/** What a surface declares on its attach: a window size and the provenance mode. */\nexport interface DeepAgentMessageWindowDeclaration {\n  /** Messages the hello should carry (the host clamps to its bounds). */\n  size?: number;\n  /** `'full'` keeps the model-provenance blobs on the wire; default strips them. */\n  provenance?: 'full' | 'compact';\n}\n\nconst clampWindowSize = (size: number): number =>\n  Math.max(\n    DEEP_AGENT_MIN_MESSAGE_WINDOW,\n    Math.min(DEEP_AGENT_MAX_MESSAGE_WINDOW, Math.trunc(size))\n  );\n\n/**\n * Attach headers with a message window declared. Applied by\n * `useDeepAgentThread` when a surface passes `messageWindow`; an explicit\n * entry (tests, forced overrides) wins.\n */\nexport function withDeclaredMessageWindow(\n  headers: Record<string, string>,\n  declaration: DeepAgentMessageWindowDeclaration = {}\n): Record<string, string> {\n  const declared: Record<string, string> = { ...headers };\n  if (!(DEEP_AGENT_MESSAGE_WINDOW_HEADER in declared)) {\n    const size = declaration.size ?? DEEP_AGENT_DEFAULT_MESSAGE_WINDOW;\n    declared[DEEP_AGENT_MESSAGE_WINDOW_HEADER] = String(\n      Number.isFinite(size) ? clampWindowSize(size) : DEEP_AGENT_DEFAULT_MESSAGE_WINDOW\n    );\n  }\n  if (declaration.provenance === 'full' && !(DEEP_AGENT_PROVENANCE_HEADER in declared)) {\n    declared[DEEP_AGENT_PROVENANCE_HEADER] = DEEP_AGENT_PROVENANCE_FULL;\n  }\n  return declared;\n}\n\n/**\n * The windowed wire's read commands on the statewire command union, so\n * `sendCommand({ type: 'history/load', … })` typechecks wherever the deep-agent\n * host is driven (`DeepAgentThread.history_load` / `history_tool_output`, both\n * attach-ACL reads). The augmentation is part of this module so every surface\n * that imports the builders gets the typed commands with them.\n */\ndeclare module '@assistant-ui/core' {\n  namespace Assistant {\n    interface Commands {\n      /** Prepend older messages to this client's windowed view. */\n      historyLoad: HistoryLoadCommand;\n      /** A tool output the windowed wire carried cut, whole. */\n      historyToolOutput: ToolOutputCommand;\n    }\n  }\n}\n\n/** The `history/load` command: older messages prepended to this client's view. */\nexport interface HistoryLoadCommand {\n  readonly type: typeof DEEP_AGENT_HISTORY_LOAD_COMMAND;\n  /** The `start` this load extends — the host answers `stale` for any other. */\n  readonly beforeIndex: number;\n  readonly limit: number;\n}\n\n/**\n * The next page of older history for `window`, or `null` when the beginning of\n * the transcript is already loaded. `limit` defaults to the window size and is\n * capped at the host's bound.\n */\nexport function buildHistoryLoadCommand({\n  window,\n  limit,\n}: {\n  window: DeepAgentMessagesWindow;\n  limit?: number;\n}): HistoryLoadCommand | null {\n  if (window.start <= 0) return null;\n  const requested = limit ?? window.size;\n  return {\n    type: DEEP_AGENT_HISTORY_LOAD_COMMAND,\n    beforeIndex: window.start,\n    limit: Math.max(1, Math.min(DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT, Math.trunc(requested))),\n  };\n}\n\n/** The host's answer to `history/load`. */\nexport interface HistoryLoadResult {\n  start: number;\n  total: number;\n  loaded: number;\n  /** The load named a `start` the client no longer held; nothing was loaded. */\n  stale: boolean;\n}\n\nexport function readHistoryLoadResult(payload: unknown): HistoryLoadResult | null {\n  if (typeof payload !== 'object' || payload === null) return null;\n  const { start, total, loaded, stale } = payload as Record<string, unknown>;\n  if (!isIndex(start) || !isIndex(total) || !isIndex(loaded)) return null;\n  return { start, total, loaded, stale: stale === true };\n}\n\n/** The `history/tool_output` command: a truncated tool output, whole. */\nexport interface ToolOutputCommand {\n  readonly type: typeof DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND;\n  readonly messageId: string;\n}\n\nexport function buildToolOutputCommand({ messageId }: { messageId: string }): ToolOutputCommand {\n  return { type: DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND, messageId };\n}\n\nexport interface ToolOutputResult {\n  messageId: string;\n  content: unknown;\n}\n\nexport function readToolOutputResult(payload: unknown): ToolOutputResult | null {\n  if (typeof payload !== 'object' || payload === null) return null;\n  const { messageId, content } = payload as Record<string, unknown>;\n  if (typeof messageId !== 'string' || !messageId) return null;\n  return { messageId, content };\n}\n\n/** The wire marker on a tool message whose content the host cut. */\nexport interface TruncatedToolContent {\n  /** Length of the full output, in characters. */\n  chars: number;\n}\n\n/**\n * The truncation marker off a raw wire message, or `null` when the message's\n * content is whole. Pure and selector-safe on the marker object.\n */\nexport function readTruncatedToolContent(message: unknown): TruncatedToolContent | null {\n  if (typeof message !== 'object' || message === null) return null;\n  const marker = (message as Record<string, unknown>)[DEEP_AGENT_TRUNCATED_CONTENT_KEY];\n  if (typeof marker !== 'object' || marker === null) return null;\n  const chars = (marker as Record<string, unknown>).chars;\n  return isIndex(chars) ? { chars } : null;\n}\n\n/**\n * `artifact` key the shared converter lifts a truncated tool output's marker\n * into (with the tool message id), so a tool card can ask for the full output\n * — the converter joins the ToolMessage into its tool-call part and would\n * otherwise drop the wire marker.\n */\nexport const ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY = '_athena_content_truncated';\n\nexport interface TruncatedToolOutputArtifact extends TruncatedToolContent {\n  /** The tool message to name in `history/tool_output`. */\n  messageId: string;\n}\n\n/**\n * The lifted truncation marker off a tool-call part's `artifact`, or `null`.\n */\nexport function readTruncatedToolOutputArtifact(\n  artifact: unknown\n): TruncatedToolOutputArtifact | null {\n  if (typeof artifact !== 'object' || artifact === null) return null;\n  const lifted = (artifact as Record<string, unknown>)[ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY];\n  if (typeof lifted !== 'object' || lifted === null) return null;\n  const { chars, messageId } = lifted as Record<string, unknown>;\n  if (!isIndex(chars) || typeof messageId !== 'string' || !messageId) return null;\n  return { chars, messageId };\n}\n"],"names":["DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY","DEEP_AGENT_MIN_MESSAGE_WINDOW","DEEP_AGENT_MAX_MESSAGE_WINDOW","DEEP_AGENT_MESSAGE_WINDOW_HEADER","DEEP_AGENT_DEFAULT_MESSAGE_WINDOW","DEEP_AGENT_PROVENANCE_HEADER","DEEP_AGENT_PROVENANCE_FULL","DEEP_AGENT_HISTORY_LOAD_COMMAND","DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT","DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND","DEEP_AGENT_TRUNCATED_CONTENT_KEY"],"mappings":";;;AAgDA,MAAM,UAAU,CAAC,UACf,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK,KAAK,SAAS;AAO5D,SAAS,4BAA4B,OAAgD;AAC1F,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,QAAM,OAAQ,MAAkCA,sDAAoC;AACpF,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,QAAM,EAAE,OAAO,OAAO,WAAW,MAAM,iBAAiB;AACxD,MAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,IAAI,KAAK,OAAO,cAAc,WAAW;AAC1F,WAAO;AAAA,EACT;AACA,MAAI,iBAAiB,QAAQ,OAAO,iBAAiB,SAAU,QAAO;AACtE,SAAO,EAAE,OAAO,OAAO,WAAW,MAAM,aAAA;AAC1C;AAeA,MAAM,kBAAkB,CAAC,SACvB,KAAK;AAAA,EACHC,kBAAAA;AAAAA,EACA,KAAK,IAAIC,kBAAAA,+BAA+B,KAAK,MAAM,IAAI,CAAC;AAC1D;AAOK,SAAS,0BACd,SACA,cAAiD,IACzB;AACxB,QAAM,WAAmC,EAAE,GAAG,QAAA;AAC9C,MAAI,EAAEC,kBAAAA,oCAAoC,WAAW;AACnD,UAAM,OAAO,YAAY,QAAQC,kBAAAA;AACjC,aAASD,kBAAAA,gCAAgC,IAAI;AAAA,MAC3C,OAAO,SAAS,IAAI,IAAI,gBAAgB,IAAI,IAAIC,kBAAAA;AAAAA,IAAA;AAAA,EAEpD;AACA,MAAI,YAAY,eAAe,UAAU,EAAEC,kBAAAA,gCAAgC,WAAW;AACpF,aAASA,kBAAAA,4BAA4B,IAAIC,kBAAAA;AAAAA,EAC3C;AACA,SAAO;AACT;AAiCO,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AACF,GAG8B;AAC5B,MAAI,OAAO,SAAS,EAAG,QAAO;AAC9B,QAAM,YAAY,SAAS,OAAO;AAClC,SAAO;AAAA,IACL,MAAMC,kBAAAA;AAAAA,IACN,aAAa,OAAO;AAAA,IACpB,OAAO,KAAK,IAAI,GAAG,KAAK,IAAIC,kBAAAA,mCAAmC,KAAK,MAAM,SAAS,CAAC,CAAC;AAAA,EAAA;AAEzF;AAWO,SAAS,sBAAsB,SAA4C;AAChF,MAAI,OAAO,YAAY,YAAY,YAAY,KAAM,QAAO;AAC5D,QAAM,EAAE,OAAO,OAAO,QAAQ,UAAU;AACxC,MAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,MAAM,EAAG,QAAO;AACnE,SAAO,EAAE,OAAO,OAAO,QAAQ,OAAO,UAAU,KAAA;AAClD;AAQO,SAAS,uBAAuB,EAAE,aAAuD;AAC9F,SAAO,EAAE,MAAMC,kBAAAA,wCAAwC,UAAA;AACzD;AAOO,SAAS,qBAAqB,SAA2C;AAC9E,MAAI,OAAO,YAAY,YAAY,YAAY,KAAM,QAAO;AAC5D,QAAM,EAAE,WAAW,QAAA,IAAY;AAC/B,MAAI,OAAO,cAAc,YAAY,CAAC,UAAW,QAAO;AACxD,SAAO,EAAE,WAAW,QAAA;AACtB;AAYO,SAAS,yBAAyB,SAA+C;AACtF,MAAI,OAAO,YAAY,YAAY,YAAY,KAAM,QAAO;AAC5D,QAAM,SAAU,QAAoCC,kDAAgC;AACpF,MAAI,OAAO,WAAW,YAAY,WAAW,KAAM,QAAO;AAC1D,QAAM,QAAS,OAAmC;AAClD,SAAO,QAAQ,KAAK,IAAI,EAAE,UAAU;AACtC;AAQO,MAAM,4CAA4C;AAUlD,SAAS,gCACd,UACoC;AACpC,MAAI,OAAO,aAAa,YAAY,aAAa,KAAM,QAAO;AAC9D,QAAM,SAAU,SAAqC,yCAAyC;AAC9F,MAAI,OAAO,WAAW,YAAY,WAAW,KAAM,QAAO;AAC1D,QAAM,EAAE,OAAO,UAAA,IAAc;AAC7B,MAAI,CAAC,QAAQ,KAAK,KAAK,OAAO,cAAc,YAAY,CAAC,UAAW,QAAO;AAC3E,SAAO,EAAE,OAAO,UAAA;AAClB;;;;;;;;;;"}

package/dist/packages/agent-runtime/src/message-window.js

@@ -0,0 +1,85 @@
+import { DEEP_AGENT_HISTORY_LOAD_COMMAND, DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT, DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND, DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY, DEEP_AGENT_MESSAGE_WINDOW_HEADER, DEEP_AGENT_DEFAULT_MESSAGE_WINDOW, DEEP_AGENT_PROVENANCE_HEADER, DEEP_AGENT_PROVENANCE_FULL, DEEP_AGENT_TRUNCATED_CONTENT_KEY, DEEP_AGENT_MIN_MESSAGE_WINDOW, DEEP_AGENT_MAX_MESSAGE_WINDOW } from "./generated/runconfig-contract.js";
+const isIndex = (value) => typeof value === "number" && Number.isInteger(value) && value >= 0;
+function readDeepAgentMessagesWindow(state) {
+  if (typeof state !== "object" || state === null) return null;
+  const lane = state[DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY];
+  if (typeof lane !== "object" || lane === null) return null;
+  const { start, total, truncated, size, anchorBefore } = lane;
+  if (!isIndex(start) || !isIndex(total) || !isIndex(size) || typeof truncated !== "boolean") {
+    return null;
+  }
+  if (anchorBefore !== null && typeof anchorBefore !== "string") return null;
+  return { start, total, truncated, size, anchorBefore };
+}
+const clampWindowSize = (size) => Math.max(
+  DEEP_AGENT_MIN_MESSAGE_WINDOW,
+  Math.min(DEEP_AGENT_MAX_MESSAGE_WINDOW, Math.trunc(size))
+);
+function withDeclaredMessageWindow(headers, declaration = {}) {
+  const declared = { ...headers };
+  if (!(DEEP_AGENT_MESSAGE_WINDOW_HEADER in declared)) {
+    const size = declaration.size ?? DEEP_AGENT_DEFAULT_MESSAGE_WINDOW;
+    declared[DEEP_AGENT_MESSAGE_WINDOW_HEADER] = String(
+      Number.isFinite(size) ? clampWindowSize(size) : DEEP_AGENT_DEFAULT_MESSAGE_WINDOW
+    );
+  }
+  if (declaration.provenance === "full" && !(DEEP_AGENT_PROVENANCE_HEADER in declared)) {
+    declared[DEEP_AGENT_PROVENANCE_HEADER] = DEEP_AGENT_PROVENANCE_FULL;
+  }
+  return declared;
+}
+function buildHistoryLoadCommand({
+  window,
+  limit
+}) {
+  if (window.start <= 0) return null;
+  const requested = limit ?? window.size;
+  return {
+    type: DEEP_AGENT_HISTORY_LOAD_COMMAND,
+    beforeIndex: window.start,
+    limit: Math.max(1, Math.min(DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT, Math.trunc(requested)))
+  };
+}
+function readHistoryLoadResult(payload) {
+  if (typeof payload !== "object" || payload === null) return null;
+  const { start, total, loaded, stale } = payload;
+  if (!isIndex(start) || !isIndex(total) || !isIndex(loaded)) return null;
+  return { start, total, loaded, stale: stale === true };
+}
+function buildToolOutputCommand({ messageId }) {
+  return { type: DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND, messageId };
+}
+function readToolOutputResult(payload) {
+  if (typeof payload !== "object" || payload === null) return null;
+  const { messageId, content } = payload;
+  if (typeof messageId !== "string" || !messageId) return null;
+  return { messageId, content };
+}
+function readTruncatedToolContent(message) {
+  if (typeof message !== "object" || message === null) return null;
+  const marker = message[DEEP_AGENT_TRUNCATED_CONTENT_KEY];
+  if (typeof marker !== "object" || marker === null) return null;
+  const chars = marker.chars;
+  return isIndex(chars) ? { chars } : null;
+}
+const ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY = "_athena_content_truncated";
+function readTruncatedToolOutputArtifact(artifact) {
+  if (typeof artifact !== "object" || artifact === null) return null;
+  const lifted = artifact[ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY];
+  if (typeof lifted !== "object" || lifted === null) return null;
+  const { chars, messageId } = lifted;
+  if (!isIndex(chars) || typeof messageId !== "string" || !messageId) return null;
+  return { chars, messageId };
+}
+export {
+  ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY,
+  buildHistoryLoadCommand,
+  buildToolOutputCommand,
+  readDeepAgentMessagesWindow,
+  readHistoryLoadResult,
+  readToolOutputResult,
+  readTruncatedToolContent,
+  readTruncatedToolOutputArtifact,
+  withDeclaredMessageWindow
+};
+//# sourceMappingURL=message-window.js.map

package/dist/packages/agent-runtime/src/message-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-window.js","sources":["../../../../../agent-runtime/src/message-window.ts"],"sourcesContent":["import {\n  DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n  DEEP_AGENT_HISTORY_LOAD_COMMAND,\n  DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT,\n  DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND,\n  DEEP_AGENT_MAX_MESSAGE_WINDOW,\n  DEEP_AGENT_MESSAGE_WINDOW_HEADER,\n  DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY,\n  DEEP_AGENT_MIN_MESSAGE_WINDOW,\n  DEEP_AGENT_PROVENANCE_FULL,\n  DEEP_AGENT_PROVENANCE_HEADER,\n  DEEP_AGENT_TRUNCATED_CONTENT_KEY,\n} from './generated/runconfig-contract';\n\n/**\n * The windowed hello — the client half of agora's\n * `agora/graphs/athena_deep_agent/message_window.py`.\n *\n * A surface that declares a message window on its attach headers\n * ({@link withDeclaredMessageWindow}) receives a hello carrying only the last\n * N messages plus the `messagesWindow` lane, and its op stream re-addressed\n * to that window by the host — so `state.messages` is always exactly\n * `server.messages[start:]` and the ordinary converter renders it unchanged.\n * Older ranges arrive through `history/load` ({@link buildHistoryLoadCommand})\n * as ops for this client alone; a truncated tool output comes back whole\n * through `history/tool_output` ({@link buildToolOutputCommand}).\n *\n * Undeclared surfaces (no header) are untouched: full snapshot, no lane.\n * Skew-tolerant both ways — an old server ignores the header and advertises\n * no lane (read as \"everything is loaded\"), a malformed lane reads as absent.\n */\nexport interface DeepAgentMessagesWindow {\n  /** Index in the server transcript of the client's first loaded message. */\n  start: number;\n  /** Server transcript length. */\n  total: number;\n  /** Whether older messages exist that the client has not loaded (`start > 0`). */\n  truncated: boolean;\n  /** The window size the host clamped the declaration to. */\n  size: number;\n  /**\n   * Id of the message just before the window (`null` at the beginning): the\n   * host parent of the first loaded message, so an edit or reload at the\n   * window edge can assert its `runAnchorMessageId` without loading first.\n   */\n  anchorBefore: string | null;\n}\n\nconst isIndex = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isInteger(value) && value >= 0;\n\n/**\n * The window lane off a raw statewire state, or `null` when the wire is not\n * windowed (an undeclared attach, a pre-window server, pre-attach) or the lane\n * is malformed (tolerated as absent — never thrown on).\n */\nexport function readDeepAgentMessagesWindow(state: unknown): DeepAgentMessagesWindow | null {\n  if (typeof state !== 'object' || state === null) return null;\n  const lane = (state as Record<string, unknown>)[DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY];\n  if (typeof lane !== 'object' || lane === null) return null;\n  const { start, total, truncated, size, anchorBefore } = lane as Record<string, unknown>;\n  if (!isIndex(start) || !isIndex(total) || !isIndex(size) || typeof truncated !== 'boolean') {\n    return null;\n  }\n  if (anchorBefore !== null && typeof anchorBefore !== 'string') return null;\n  return { start, total, truncated, size, anchorBefore };\n}\n\n/** How many messages older than the loaded window the server still holds. */\nexport function olderMessageCount(window: DeepAgentMessagesWindow | null): number {\n  return window === null ? 0 : window.start;\n}\n\n/** What a surface declares on its attach: a window size and the provenance mode. */\nexport interface DeepAgentMessageWindowDeclaration {\n  /** Messages the hello should carry (the host clamps to its bounds). */\n  size?: number;\n  /** `'full'` keeps the model-provenance blobs on the wire; default strips them. */\n  provenance?: 'full' | 'compact';\n}\n\nconst clampWindowSize = (size: number): number =>\n  Math.max(\n    DEEP_AGENT_MIN_MESSAGE_WINDOW,\n    Math.min(DEEP_AGENT_MAX_MESSAGE_WINDOW, Math.trunc(size))\n  );\n\n/**\n * Attach headers with a message window declared. Applied by\n * `useDeepAgentThread` when a surface passes `messageWindow`; an explicit\n * entry (tests, forced overrides) wins.\n */\nexport function withDeclaredMessageWindow(\n  headers: Record<string, string>,\n  declaration: DeepAgentMessageWindowDeclaration = {}\n): Record<string, string> {\n  const declared: Record<string, string> = { ...headers };\n  if (!(DEEP_AGENT_MESSAGE_WINDOW_HEADER in declared)) {\n    const size = declaration.size ?? DEEP_AGENT_DEFAULT_MESSAGE_WINDOW;\n    declared[DEEP_AGENT_MESSAGE_WINDOW_HEADER] = String(\n      Number.isFinite(size) ? clampWindowSize(size) : DEEP_AGENT_DEFAULT_MESSAGE_WINDOW\n    );\n  }\n  if (declaration.provenance === 'full' && !(DEEP_AGENT_PROVENANCE_HEADER in declared)) {\n    declared[DEEP_AGENT_PROVENANCE_HEADER] = DEEP_AGENT_PROVENANCE_FULL;\n  }\n  return declared;\n}\n\n/**\n * The windowed wire's read commands on the statewire command union, so\n * `sendCommand({ type: 'history/load', … })` typechecks wherever the deep-agent\n * host is driven (`DeepAgentThread.history_load` / `history_tool_output`, both\n * attach-ACL reads). The augmentation is part of this module so every surface\n * that imports the builders gets the typed commands with them.\n */\ndeclare module '@assistant-ui/core' {\n  namespace Assistant {\n    interface Commands {\n      /** Prepend older messages to this client's windowed view. */\n      historyLoad: HistoryLoadCommand;\n      /** A tool output the windowed wire carried cut, whole. */\n      historyToolOutput: ToolOutputCommand;\n    }\n  }\n}\n\n/** The `history/load` command: older messages prepended to this client's view. */\nexport interface HistoryLoadCommand {\n  readonly type: typeof DEEP_AGENT_HISTORY_LOAD_COMMAND;\n  /** The `start` this load extends — the host answers `stale` for any other. */\n  readonly beforeIndex: number;\n  readonly limit: number;\n}\n\n/**\n * The next page of older history for `window`, or `null` when the beginning of\n * the transcript is already loaded. `limit` defaults to the window size and is\n * capped at the host's bound.\n */\nexport function buildHistoryLoadCommand({\n  window,\n  limit,\n}: {\n  window: DeepAgentMessagesWindow;\n  limit?: number;\n}): HistoryLoadCommand | null {\n  if (window.start <= 0) return null;\n  const requested = limit ?? window.size;\n  return {\n    type: DEEP_AGENT_HISTORY_LOAD_COMMAND,\n    beforeIndex: window.start,\n    limit: Math.max(1, Math.min(DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT, Math.trunc(requested))),\n  };\n}\n\n/** The host's answer to `history/load`. */\nexport interface HistoryLoadResult {\n  start: number;\n  total: number;\n  loaded: number;\n  /** The load named a `start` the client no longer held; nothing was loaded. */\n  stale: boolean;\n}\n\nexport function readHistoryLoadResult(payload: unknown): HistoryLoadResult | null {\n  if (typeof payload !== 'object' || payload === null) return null;\n  const { start, total, loaded, stale } = payload as Record<string, unknown>;\n  if (!isIndex(start) || !isIndex(total) || !isIndex(loaded)) return null;\n  return { start, total, loaded, stale: stale === true };\n}\n\n/** The `history/tool_output` command: a truncated tool output, whole. */\nexport interface ToolOutputCommand {\n  readonly type: typeof DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND;\n  readonly messageId: string;\n}\n\nexport function buildToolOutputCommand({ messageId }: { messageId: string }): ToolOutputCommand {\n  return { type: DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND, messageId };\n}\n\nexport interface ToolOutputResult {\n  messageId: string;\n  content: unknown;\n}\n\nexport function readToolOutputResult(payload: unknown): ToolOutputResult | null {\n  if (typeof payload !== 'object' || payload === null) return null;\n  const { messageId, content } = payload as Record<string, unknown>;\n  if (typeof messageId !== 'string' || !messageId) return null;\n  return { messageId, content };\n}\n\n/** The wire marker on a tool message whose content the host cut. */\nexport interface TruncatedToolContent {\n  /** Length of the full output, in characters. */\n  chars: number;\n}\n\n/**\n * The truncation marker off a raw wire message, or `null` when the message's\n * content is whole. Pure and selector-safe on the marker object.\n */\nexport function readTruncatedToolContent(message: unknown): TruncatedToolContent | null {\n  if (typeof message !== 'object' || message === null) return null;\n  const marker = (message as Record<string, unknown>)[DEEP_AGENT_TRUNCATED_CONTENT_KEY];\n  if (typeof marker !== 'object' || marker === null) return null;\n  const chars = (marker as Record<string, unknown>).chars;\n  return isIndex(chars) ? { chars } : null;\n}\n\n/**\n * `artifact` key the shared converter lifts a truncated tool output's marker\n * into (with the tool message id), so a tool card can ask for the full output\n * — the converter joins the ToolMessage into its tool-call part and would\n * otherwise drop the wire marker.\n */\nexport const ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY = '_athena_content_truncated';\n\nexport interface TruncatedToolOutputArtifact extends TruncatedToolContent {\n  /** The tool message to name in `history/tool_output`. */\n  messageId: string;\n}\n\n/**\n * The lifted truncation marker off a tool-call part's `artifact`, or `null`.\n */\nexport function readTruncatedToolOutputArtifact(\n  artifact: unknown\n): TruncatedToolOutputArtifact | null {\n  if (typeof artifact !== 'object' || artifact === null) return null;\n  const lifted = (artifact as Record<string, unknown>)[ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY];\n  if (typeof lifted !== 'object' || lifted === null) return null;\n  const { chars, messageId } = lifted as Record<string, unknown>;\n  if (!isIndex(chars) || typeof messageId !== 'string' || !messageId) return null;\n  return { chars, messageId };\n}\n"],"names":[],"mappings":"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"}