@athenaintel/react 0.18.0 → 0.20.0

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":"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"}

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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"}