@athenaintel/react 0.22.4 → 0.23.1

package/dist/packages/agent-runtime/src/github-wake-event.js

@@ -0,0 +1,86 @@
+const GITHUB_EVENT_SOURCE_KEY = "github_event_source";
+const REPO_FULL_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*\/[A-Za-z0-9._-]+$/;
+const GITHUB_HOSTS = /* @__PURE__ */ new Set(["github.com", "www.github.com"]);
+function readString(record, key) {
+  const value = record[key];
+  return typeof value === "string" && value.trim().length > 0 ? value : null;
+}
+function readNumber(record, key) {
+  const value = record[key];
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string" && /^\d+$/.test(value.trim())) return Number(value.trim());
+  return null;
+}
+function githubWakeEventUrl(repo, url) {
+  if (url === null) return null;
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return null;
+  }
+  if (parsed.protocol !== "https:" || !GITHUB_HOSTS.has(parsed.hostname.toLowerCase())) {
+    return null;
+  }
+  const path = parsed.pathname.toLowerCase();
+  const prefix = `/${repo.toLowerCase()}`;
+  return path === prefix || path.startsWith(`${prefix}/`) ? parsed.toString() : null;
+}
+function readGithubWakeEvent(custom) {
+  const raw = custom == null ? void 0 : custom[GITHUB_EVENT_SOURCE_KEY];
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return void 0;
+  const record = raw;
+  const repo = readString(record, "repo");
+  if (repo === null || !REPO_FULL_NAME.test(repo)) return void 0;
+  return {
+    repo,
+    number: readNumber(record, "number"),
+    githubEvent: readString(record, "github_event"),
+    action: readString(record, "action"),
+    sender: readString(record, "sender"),
+    title: readString(record, "title"),
+    url: githubWakeEventUrl(repo, readString(record, "url")),
+    reviewState: readString(record, "review_state"),
+    checkName: readString(record, "check_name"),
+    checkConclusion: readString(record, "check_conclusion"),
+    bodyExcerpt: readString(record, "body_excerpt"),
+    receivedAt: readString(record, "received_at")
+  };
+}
+function isGithubWakeMessage(custom) {
+  return readGithubWakeEvent(custom) !== void 0;
+}
+function humanize(value) {
+  return value.replace(/[._]/g, " ").trim();
+}
+function githubWakeEventLabel(event) {
+  const name = event.githubEvent ?? "";
+  if (name.includes("review_comment")) return "review comment";
+  if (name.includes("review")) {
+    return event.reviewState ? `review: ${humanize(event.reviewState)}` : "review";
+  }
+  if (name.includes("comment")) return "comment";
+  if (name.includes("check")) {
+    const check = event.checkName ? `check ${event.checkName}` : "check";
+    return event.checkConclusion ? `${check}: ${humanize(event.checkConclusion)}` : check;
+  }
+  if (event.action) return `${humanize(name) || "event"} ${humanize(event.action)}`.trim();
+  return humanize(name) || "GitHub event";
+}
+function githubWakeReference(event) {
+  return event.number !== null ? `${event.repo}#${event.number}` : event.repo;
+}
+function githubWakeMarkerText(event) {
+  const target = event.number !== null ? `#${event.number}` : event.repo;
+  return `Woke: ${githubWakeEventLabel(event)} on ${target}`;
+}
+export {
+  GITHUB_EVENT_SOURCE_KEY,
+  githubWakeEventLabel,
+  githubWakeEventUrl,
+  githubWakeMarkerText,
+  githubWakeReference,
+  isGithubWakeMessage,
+  readGithubWakeEvent
+};
+//# sourceMappingURL=github-wake-event.js.map

package/dist/packages/agent-runtime/src/github-wake-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-wake-event.js","sources":["../../../../../agent-runtime/src/github-wake-event.ts"],"sourcesContent":["/**\n * The GitHub event that woke a resting session, read from the user turn the\n * wake injected.\n *\n * When a GitHub webhook wakes a linked session (agora\n * `trigger_engine/actions/handlers/github_thread_wake.py`), the injected user\n * turn carries a provenance envelope under `github_event_source` in its\n * message metadata (`services/channels/github_event_source.py`). The shipped\n * converter exposes that metadata as the thread message's `metadata.custom`,\n * so every surface reads the envelope from there and renders the turn as a\n * compact runtime marker (\"Woke: review comment on #36337\") instead of a user\n * bubble quoting the whole wake text. The envelope is provenance for RENDERING\n * only: the model still receives the full composed text, so a surface that\n * ignores it degrades to a plain bubble, never to a lost instruction.\n */\n\n/** `metadata.custom` key the wake handler stamps on the injected user turn. */\nexport const GITHUB_EVENT_SOURCE_KEY = 'github_event_source';\n\n/**\n * `owner/name`, the only repository shape the wake handler stamps. The\n * envelope is message metadata, which a collaborator with write access to\n * the thread can also author, so a marker is only rendered for an envelope\n * of the real shape and only links back into the named repository on\n * github.com (see {@link githubWakeEventUrl}) — a forged envelope can at\n * most point at its own repository, never at an arbitrary host.\n */\nconst REPO_FULL_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*\\/[A-Za-z0-9._-]+$/;\n\nconst GITHUB_HOSTS: ReadonlySet<string> = new Set(['github.com', 'www.github.com']);\n\nexport interface GithubWakeEvent {\n  /** `owner/repo` the event came from. */\n  repo: string;\n  /** The pull request number, when the event names one. */\n  number: number | null;\n  /** The webhook event name (`pull_request_review_comment`, `check_run`, …). */\n  githubEvent: string | null;\n  /** The event's `action` (`created`, `submitted`, `completed`, …). */\n  action: string | null;\n  /** GitHub login of who caused the event. */\n  sender: string | null;\n  /** The pull request title, when the payload carried one. */\n  title: string | null;\n  /**\n   * Link to the pull request (or the repository for repo-level events),\n   * kept only when it points into `repo` on github.com\n   * ({@link githubWakeEventUrl}); any other value reads as `null`.\n   */\n  url: string | null;\n  /** A review's state (`approved`, `changes_requested`, `commented`). */\n  reviewState: string | null;\n  /** A check's name and conclusion, for check events. */\n  checkName: string | null;\n  checkConclusion: string | null;\n  /** The comment or review body, cut to the card budget by the backend. */\n  bodyExcerpt: string | null;\n  /** ISO 8601 receipt time stamped by the backend. */\n  receivedAt: string | null;\n}\n\nfunction readString(record: Record<string, unknown>, key: string): string | null {\n  const value = record[key];\n  return typeof value === 'string' && value.trim().length > 0 ? value : null;\n}\n\nfunction readNumber(record: Record<string, unknown>, key: string): number | null {\n  const value = record[key];\n  if (typeof value === 'number' && Number.isFinite(value)) return value;\n  if (typeof value === 'string' && /^\\d+$/.test(value.trim())) return Number(value.trim());\n  return null;\n}\n\n/**\n * The envelope's link when it is an `https://github.com/<repo>/…` URL for the\n * envelope's own repository, else `null`. The marker never renders a link\n * that could lead anywhere else, whatever the metadata claims.\n */\nexport function githubWakeEventUrl(repo: string, url: string | null): string | null {\n  if (url === null) return null;\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    return null;\n  }\n  if (parsed.protocol !== 'https:' || !GITHUB_HOSTS.has(parsed.hostname.toLowerCase())) {\n    return null;\n  }\n  const path = parsed.pathname.toLowerCase();\n  const prefix = `/${repo.toLowerCase()}`;\n  return path === prefix || path.startsWith(`${prefix}/`) ? parsed.toString() : null;\n}\n\n/**\n * The wake envelope behind a thread message's `metadata.custom`, or\n * `undefined` when the message is an ordinary user turn (or the envelope is\n * not of the shape the wake handler stamps — a missing or malformed\n * repository is not a wake worth rendering).\n */\nexport function readGithubWakeEvent(\n  custom: Record<string, unknown> | null | undefined\n): GithubWakeEvent | undefined {\n  const raw = custom?.[GITHUB_EVENT_SOURCE_KEY];\n  if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) return undefined;\n  const record = raw as Record<string, unknown>;\n  const repo = readString(record, 'repo');\n  if (repo === null || !REPO_FULL_NAME.test(repo)) return undefined;\n  return {\n    repo,\n    number: readNumber(record, 'number'),\n    githubEvent: readString(record, 'github_event'),\n    action: readString(record, 'action'),\n    sender: readString(record, 'sender'),\n    title: readString(record, 'title'),\n    url: githubWakeEventUrl(repo, readString(record, 'url')),\n    reviewState: readString(record, 'review_state'),\n    checkName: readString(record, 'check_name'),\n    checkConclusion: readString(record, 'check_conclusion'),\n    bodyExcerpt: readString(record, 'body_excerpt'),\n    receivedAt: readString(record, 'received_at'),\n  };\n}\n\n/**\n * Whether a thread message is a GitHub wake turn. Returns a primitive, so it\n * is safe as a `useAuiState` selector (the reader above builds a fresh object\n * per call; an object snapshot would loop the render under `Object.is`).\n */\nexport function isGithubWakeMessage(custom: Record<string, unknown> | null | undefined): boolean {\n  return readGithubWakeEvent(custom) !== undefined;\n}\n\nfunction humanize(value: string): string {\n  return value.replace(/[._]/g, ' ').trim();\n}\n\n/**\n * The event in a few words, in sentence position (\"review comment\",\n * \"review: changes requested\", \"check CI: failure\", \"pull request opened\").\n */\nexport function githubWakeEventLabel(event: GithubWakeEvent): string {\n  const name = event.githubEvent ?? '';\n  if (name.includes('review_comment')) return 'review comment';\n  if (name.includes('review')) {\n    return event.reviewState ? `review: ${humanize(event.reviewState)}` : 'review';\n  }\n  if (name.includes('comment')) return 'comment';\n  if (name.includes('check')) {\n    const check = event.checkName ? `check ${event.checkName}` : 'check';\n    return event.checkConclusion ? `${check}: ${humanize(event.checkConclusion)}` : check;\n  }\n  if (event.action) return `${humanize(name) || 'event'} ${humanize(event.action)}`.trim();\n  return humanize(name) || 'GitHub event';\n}\n\n/** `owner/repo#123`, or `owner/repo` for a repository-level event. */\nexport function githubWakeReference(event: GithubWakeEvent): string {\n  return event.number !== null ? `${event.repo}#${event.number}` : event.repo;\n}\n\n/**\n * The marker line every surface renders for a wake turn:\n * \"Woke: review comment on #36337\" (the repository when there is no number).\n */\nexport function githubWakeMarkerText(event: GithubWakeEvent): string {\n  const target = event.number !== null ? `#${event.number}` : event.repo;\n  return `Woke: ${githubWakeEventLabel(event)} on ${target}`;\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,52 +1,155 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const runconfigContract = require("./generated/runconfig-contract.cjs");
+const statewireTransport = require("./statewire-transport.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 };
+function clampMessageWindowSize(size) {
+  if (size === void 0 || !Number.isFinite(size)) return runconfigContract.DEEP_AGENT_DEFAULT_MESSAGE_WINDOW;
+  return Math.max(
+    runconfigContract.DEEP_AGENT_MIN_MESSAGE_WINDOW,
+    Math.min(runconfigContract.DEEP_AGENT_MAX_MESSAGE_WINDOW, Math.trunc(size))
+  );
+}
+function headInterestRequest(size) {
+  return { ns: runconfigContract.DEEP_AGENT_MAIN_NS, before: clampMessageWindowSize(size) };
+}
+function pageInterestRequest(at, size) {
+  return { ns: runconfigContract.DEEP_AGENT_MAIN_NS, before: clampMessageWindowSize(size), at };
 }
-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;
+  if (runconfigContract.DEEP_AGENT_MESSAGE_WINDOW_HEADER in headers) return headers;
+  return {
+    ...headers,
+    [runconfigContract.DEEP_AGENT_MESSAGE_WINDOW_HEADER]: String(clampMessageWindowSize(declaration.size))
+  };
 }
-function buildHistoryLoadCommand({
-  window,
-  limit
-}) {
-  if (window.start <= 0) return null;
-  const requested = limit ?? window.size;
+function readDeepAgentInterestResolution(value) {
+  if (typeof value !== "object" || value === null) return null;
+  const { ns, before, at, after, chain, more } = value;
+  if (ns !== runconfigContract.DEEP_AGENT_MAIN_NS || !isIndex(before) || !Array.isArray(chain)) return null;
+  if (at !== void 0 && typeof at !== "string") return null;
+  if (after !== void 0 && !isIndex(after)) return null;
+  if (typeof more !== "object" || more === null) return null;
+  const { before: moreBefore, after: moreAfter } = more;
+  if (typeof moreBefore !== "boolean" || typeof moreAfter !== "boolean") return null;
+  const entries = [];
+  for (const entry of chain) {
+    const { id, siblings } = entry ?? {};
+    if (typeof id !== "string") return null;
+    entries.push({
+      id,
+      siblings: Array.isArray(siblings) ? siblings.filter((s) => typeof s === "string") : [id]
+    });
+  }
   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)))
+    ns: runconfigContract.DEEP_AGENT_MAIN_NS,
+    before,
+    ...at !== void 0 && { at },
+    ...after !== void 0 && { after },
+    chain: entries,
+    more: { before: moreBefore, after: moreAfter }
   };
 }
-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 readDeepAgentInterestDocument(value) {
+  if (typeof value !== "object" || value === null) return null;
+  const { windows } = value;
+  if (!Array.isArray(windows)) return null;
+  const resolutions = [];
+  for (const window of windows) {
+    const resolution = readDeepAgentInterestResolution(window);
+    if (resolution === null) return null;
+    resolutions.push(resolution);
+  }
+  return { windows: resolutions };
+}
+const interestRequest = ({ ns, before, at, after }) => ({
+  ns,
+  before,
+  ...at !== void 0 && { at },
+  ...after !== void 0 && { after }
+});
+function coalescedInterestRequests(chain, grow) {
+  const loaded = chain.length;
+  const requests = [
+    { ns: runconfigContract.DEEP_AGENT_MAIN_NS, before: Math.min(runconfigContract.DEEP_AGENT_MAX_MESSAGE_WINDOW, loaded) }
+  ];
+  let low = loaded - requests[0].before;
+  while (low > 0) {
+    const before = Math.min(runconfigContract.DEEP_AGENT_MAX_MESSAGE_WINDOW, low + 1);
+    requests.push({
+      ns: runconfigContract.DEEP_AGENT_MAIN_NS,
+      before,
+      at: chain[low].id
+    });
+    low = low + 1 - before;
+  }
+  const last = requests[requests.length - 1];
+  if (last.before + grow <= runconfigContract.DEEP_AGENT_MAX_MESSAGE_WINDOW) {
+    requests[requests.length - 1] = { ...last, before: last.before + grow };
+  } else {
+    requests.push({
+      ns: runconfigContract.DEEP_AGENT_MAIN_NS,
+      before: grow + 1,
+      at: chain[0].id
+    });
+  }
+  return requests.length > runconfigContract.DEEP_AGENT_MAX_INTERESTS ? null : requests;
+}
+function pageInterestRequests(window, size) {
+  var _a;
+  const anchor = (_a = window.chain[0]) == null ? void 0 : _a.id;
+  if (anchor === void 0 || !window.hasOlder) return null;
+  const page = pageInterestRequest(anchor, size);
+  const appended = [...window.requests, page];
+  if (appended.length <= runconfigContract.DEEP_AGENT_MAX_INTERESTS) return appended;
+  return coalescedInterestRequests(window.chain, page.before - 1);
+}
+function interestsCovered(carried, stated) {
+  return stated.every(
+    (request) => carried.some((have) => have.at === request.at && have.before >= request.before)
+  );
+}
+function readDeepAgentMessageWindow(mounted) {
+  var _a, _b, _c;
+  if (mounted === void 0) return null;
+  let windows;
+  const documents = /* @__PURE__ */ new Map();
+  for (const document of mounted.values()) {
+    const key = document.key;
+    if (document.protocol === runconfigContract.DEEP_AGENT_INTEREST_PROTOCOL && document.main === true) {
+      windows = (_a = readDeepAgentInterestDocument(document.value)) == null ? void 0 : _a.windows;
+    } else if (document.protocol === statewireTransport.DEEP_AGENT_STATEWIRE_PROTOCOL && key !== null && key.length === 3 && key[1] === runconfigContract.DEEP_AGENT_MAIN_NS) {
+      documents.set(key[2], document.value);
+    }
+  }
+  const head = windows == null ? void 0 : windows[0];
+  if (windows === void 0 || head === void 0) return null;
+  let chain = head.chain;
+  let hasOlder = head.more.before;
+  const requests = [interestRequest(head)];
+  const loaded = new Set(chain.map((entry) => entry.id));
+  let pages = 0;
+  for (const page of windows.slice(1)) {
+    if (page.at === void 0 || !loaded.has(page.at)) continue;
+    const anchorAt = page.chain.findIndex((entry) => entry.id === page.at);
+    if (anchorAt < 0) continue;
+    const fresh = page.chain.slice(0, anchorAt).filter((entry) => !loaded.has(entry.id));
+    if (fresh.length === 0) {
+      if (((_b = page.chain[0]) == null ? void 0 : _b.id) === ((_c = chain[0]) == null ? void 0 : _c.id)) hasOlder = page.more.before;
+      continue;
+    }
+    chain = [...fresh, ...chain];
+    for (const entry of fresh) loaded.add(entry.id);
+    hasOlder = page.more.before;
+    requests.push(interestRequest(page));
+    pages += 1;
+  }
+  const messages = [];
+  for (const entry of chain) {
+    const message = documents.get(entry.id);
+    if (message !== void 0) messages.push(message);
+  }
+  return { requests, chain, messages, hasOlder, pages };
 }
 function buildToolOutputCommand({ messageId }) {
   return { type: runconfigContract.DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND, messageId };
@@ -74,10 +177,15 @@ function readTruncatedToolOutputArtifact(artifact) {
   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.clampMessageWindowSize = clampMessageWindowSize;
+exports.headInterestRequest = headInterestRequest;
+exports.interestsCovered = interestsCovered;
+exports.pageInterestRequest = pageInterestRequest;
+exports.pageInterestRequests = pageInterestRequests;
+exports.readDeepAgentInterestDocument = readDeepAgentInterestDocument;
+exports.readDeepAgentInterestResolution = readDeepAgentInterestResolution;
+exports.readDeepAgentMessageWindow = readDeepAgentMessageWindow;
 exports.readToolOutputResult = readToolOutputResult;
 exports.readTruncatedToolContent = readTruncatedToolContent;
 exports.readTruncatedToolOutputArtifact = readTruncatedToolOutputArtifact;

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

@@ -1 +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;;;;;;;;;;"}
+{"version":3,"file":"message-window.cjs","sources":["../../../../../agent-runtime/src/message-window.ts"],"sourcesContent":["import type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport type { StatewireDocuments } from 'statewire';\nimport {\n  DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n  DEEP_AGENT_HISTORY_MESSAGE_COMMAND,\n  DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND,\n  DEEP_AGENT_INTEREST_PROTOCOL,\n  DEEP_AGENT_MAIN_NS,\n  DEEP_AGENT_MAX_INTERESTS,\n  DEEP_AGENT_MAX_MESSAGE_WINDOW,\n  DEEP_AGENT_MESSAGE_WINDOW_HEADER,\n  DEEP_AGENT_MIN_MESSAGE_WINDOW,\n  DEEP_AGENT_TRUNCATED_CONTENT_KEY,\n} from './generated/runconfig-contract';\nimport { DEEP_AGENT_STATEWIRE_PROTOCOL } from './statewire-transport';\n\n/**\n * The interest window — the client half of agora's\n * `agora/graphs/athena_deep_agent/message_window.py`.\n *\n * The wire main document carries no `messages`. A client states its interests\n * on the `athena/interest` lane as one array (`set(requests)`): the first is\n * the head (the newest `before` messages of the `main` namespace), the rest\n * are pages anchored `at` the first message of the window they extend. The\n * host holds one ephemeral main document per attach, `{ windows }`, one\n * resolution per request in order (the request echoed plus the covered\n * `chain` and `more` flags; an anchor that vanished leaves an empty window in\n * place), and one shared `athena` document per covered message, keyed\n * `[threadId, \"main\", messageId]`. {@link readDeepAgentMessageWindow} joins\n * them into the transcript the converter renders.\n *\n * Two host rules shape the client half. The head window never drops below\n * the oldest message it has carried on an attach (a run's appends grow the\n * view, nothing loaded slides out), so a page stays anchored at the head's\n * first message while the transcript grows; and the host remembers a client\n * id's interests across its attaches, so a reconnect's hello carries the\n * view the client held. A fresh client's hello carries the head it declared\n * on the attach headers ({@link withDeclaredMessageWindow}) — a statement\n * cannot ride the first attach, the hello negotiates the lanes.\n *\n * Pages are appended one per load until the host's interest cap, then the\n * loaded range is restated in as few maximal requests as it takes\n * ({@link pageInterestRequests}); the whole transcript stays reachable up to\n * `MAX_INTERESTS × MAX_MESSAGE_WINDOW` messages. A truncated tool output\n * comes back whole through `history/tool_output` ({@link buildToolOutputCommand});\n * a message's stored form — provenance blobs and all — through\n * `history/message` ({@link buildHistoryMessageCommand}).\n */\n\nconst isIndex = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isInteger(value) && value >= 0;\n\n/** What a surface declares for its window: the interest size (the host clamps to its bounds). */\nexport interface DeepAgentMessageWindowDeclaration {\n  size?: number;\n}\n\nexport function clampMessageWindowSize(size?: number): number {\n  if (size === undefined || !Number.isFinite(size)) return DEEP_AGENT_DEFAULT_MESSAGE_WINDOW;\n  return Math.max(\n    DEEP_AGENT_MIN_MESSAGE_WINDOW,\n    Math.min(DEEP_AGENT_MAX_MESSAGE_WINDOW, Math.trunc(size))\n  );\n}\n\n/** An `athena/interest` request over the linear transcript. */\nexport interface DeepAgentInterestRequest {\n  readonly ns: typeof DEEP_AGENT_MAIN_NS;\n  /** Messages ending at the anchor (the tail without `at`). */\n  readonly before: number;\n  /** Anchor message id; a page's is the first message of the window it extends. */\n  readonly at?: string;\n  /** Messages past the anchor (requires `at`). */\n  readonly after?: number;\n}\n\nexport function headInterestRequest(size?: number): DeepAgentInterestRequest {\n  return { ns: DEEP_AGENT_MAIN_NS, before: clampMessageWindowSize(size) };\n}\n\nexport function pageInterestRequest(at: string, size?: number): DeepAgentInterestRequest {\n  return { ns: DEEP_AGENT_MAIN_NS, before: clampMessageWindowSize(size), at };\n}\n\n/**\n * Attach headers with the head window declared (`x-athena-deep-agent-window`):\n * the hello of a client the host does not remember carries the newest `size`\n * messages. Part of the one attach recipe, so a pooled dial asks for the shape\n * the thread's own attach would. An explicit entry (tests, overrides) wins.\n */\nexport function withDeclaredMessageWindow(\n  headers: Record<string, string>,\n  declaration: DeepAgentMessageWindowDeclaration = {}\n): Record<string, string> {\n  if (DEEP_AGENT_MESSAGE_WINDOW_HEADER in headers) return headers;\n  return {\n    ...headers,\n    [DEEP_AGENT_MESSAGE_WINDOW_HEADER]: String(clampMessageWindowSize(declaration.size)),\n  };\n}\n\nexport interface DeepAgentInterestChainEntry {\n  id: string;\n  siblings: string[];\n}\n\n/** The host's resolution document of one interest: the request echoed plus its coverage. */\nexport interface DeepAgentInterestResolution extends DeepAgentInterestRequest {\n  /** Covered message ids, oldest first (a page ends at its anchor). */\n  chain: DeepAgentInterestChainEntry[];\n  more: { before: boolean; after: boolean };\n}\n\nexport function readDeepAgentInterestResolution(value: unknown): DeepAgentInterestResolution | null {\n  if (typeof value !== 'object' || value === null) return null;\n  const { ns, before, at, after, chain, more } = value as Record<string, unknown>;\n  if (ns !== DEEP_AGENT_MAIN_NS || !isIndex(before) || !Array.isArray(chain)) return null;\n  if (at !== undefined && typeof at !== 'string') return null;\n  if (after !== undefined && !isIndex(after)) return null;\n  if (typeof more !== 'object' || more === null) return null;\n  const { before: moreBefore, after: moreAfter } = more as Record<string, unknown>;\n  if (typeof moreBefore !== 'boolean' || typeof moreAfter !== 'boolean') return null;\n  const entries: DeepAgentInterestChainEntry[] = [];\n  for (const entry of chain) {\n    const { id, siblings } = (entry ?? {}) as Record<string, unknown>;\n    if (typeof id !== 'string') return null;\n    entries.push({\n      id,\n      siblings: Array.isArray(siblings) ? siblings.filter((s) => typeof s === 'string') : [id],\n    });\n  }\n  return {\n    ns: DEEP_AGENT_MAIN_NS,\n    before,\n    ...(at !== undefined && { at }),\n    ...(after !== undefined && { after }),\n    chain: entries,\n    more: { before: moreBefore, after: moreAfter },\n  };\n}\n\n/** The attach's interest document: one resolution per stated request, in order. */\nexport interface DeepAgentInterestDocument {\n  windows: DeepAgentInterestResolution[];\n}\n\nexport function readDeepAgentInterestDocument(value: unknown): DeepAgentInterestDocument | null {\n  if (typeof value !== 'object' || value === null) return null;\n  const { windows } = value as Record<string, unknown>;\n  if (!Array.isArray(windows)) return null;\n  const resolutions: DeepAgentInterestResolution[] = [];\n  for (const window of windows) {\n    const resolution = readDeepAgentInterestResolution(window);\n    if (resolution === null) return null;\n    resolutions.push(resolution);\n  }\n  return { windows: resolutions };\n}\n\nconst interestRequest = ({ ns, before, at, after }: DeepAgentInterestRequest): DeepAgentInterestRequest => ({\n  ns,\n  before,\n  ...(at !== undefined && { at }),\n  ...(after !== undefined && { after }),\n});\n\n/** The loaded transcript window, joined from the head interest and its anchored pages. */\nexport interface DeepAgentMessageWindow {\n  /** The requests the joined view stands on, in order (the head first): what a `set` restates. A stale page (its anchor gone) or one the head already covers is left out. */\n  requests: DeepAgentInterestRequest[];\n  /** Covered chain, oldest first. */\n  chain: DeepAgentInterestChainEntry[];\n  /** The chain's message documents, in chain order (an unmounted one is skipped). */\n  messages: LangChainMessage[];\n  /** Whether the host holds messages older than the window. */\n  hasOlder: boolean;\n  /** Pages joined onto the head. */\n  pages: number;\n}\n\n/**\n * The loaded chain plus `grow` older messages, restated in as few requests as\n * it takes: a maximal head, then maximal pages each anchored at the first\n * message of the window above it. `null` once even that exceeds the host's\n * interest cap — the reachable depth is `MAX_INTERESTS × MAX_MESSAGE_WINDOW`.\n */\nfunction coalescedInterestRequests(\n  chain: readonly DeepAgentInterestChainEntry[],\n  grow: number\n): DeepAgentInterestRequest[] | null {\n  const loaded = chain.length;\n  const requests: DeepAgentInterestRequest[] = [\n    { ns: DEEP_AGENT_MAIN_NS, before: Math.min(DEEP_AGENT_MAX_MESSAGE_WINDOW, loaded) },\n  ];\n  // `low` is the chain index of the lowest message the plan covers so far.\n  let low = loaded - (requests[0] as DeepAgentInterestRequest).before;\n  while (low > 0) {\n    const before = Math.min(DEEP_AGENT_MAX_MESSAGE_WINDOW, low + 1);\n    requests.push({\n      ns: DEEP_AGENT_MAIN_NS,\n      before,\n      at: (chain[low] as DeepAgentInterestChainEntry).id,\n    });\n    low = low + 1 - before;\n  }\n  // The plan covers the chain; the new messages extend its lowest request\n  // when that stays within one window, else they are a page of their own.\n  const last = requests[requests.length - 1] as DeepAgentInterestRequest;\n  if (last.before + grow <= DEEP_AGENT_MAX_MESSAGE_WINDOW) {\n    requests[requests.length - 1] = { ...last, before: last.before + grow };\n  } else {\n    requests.push({\n      ns: DEEP_AGENT_MAIN_NS,\n      before: grow + 1,\n      at: (chain[0] as DeepAgentInterestChainEntry).id,\n    });\n  }\n  return requests.length > DEEP_AGENT_MAX_INTERESTS ? null : requests;\n}\n\n/**\n * The requests to state for one more page of older history, or `null` when\n * there is nothing to load (no anchor, the beginning reached) or the host's\n * interest cap is spent. One page is appended, anchored at the window's first\n * message, while the cap allows; at the cap the loaded range is coalesced\n * into maximal requests first (see {@link coalescedInterestRequests}).\n */\nexport function pageInterestRequests(\n  window: DeepAgentMessageWindow,\n  size?: number\n): DeepAgentInterestRequest[] | null {\n  const anchor = window.chain[0]?.id;\n  if (anchor === undefined || !window.hasOlder) return null;\n  const page = pageInterestRequest(anchor, size);\n  const appended = [...window.requests, page];\n  if (appended.length <= DEEP_AGENT_MAX_INTERESTS) return appended;\n  // A page's `before` counts its anchor: it adds `before - 1` older messages.\n  return coalescedInterestRequests(window.chain, page.before - 1);\n}\n\n/**\n * Whether every `stated` request is carried by `carried` (the same anchor, at\n * least as wide): a reconnect's hello that carries what the client last\n * stated — the host remembers a client id's interests — needs no restatement.\n */\nexport function interestsCovered(\n  carried: readonly DeepAgentInterestRequest[],\n  stated: readonly DeepAgentInterestRequest[]\n): boolean {\n  return stated.every((request) =>\n    carried.some((have) => have.at === request.at && have.before >= request.before)\n  );\n}\n\n/**\n * The window off the mounted documents, or `null` while the head interest has\n * not resolved (pre-attach, before the first `set` answer, a wire without\n * documents). A page joins wherever its anchor sits in the chain so far — at\n * the first message it extends the view, inside the head (the head widened\n * past it) it adds nothing and is left out of `requests`; a page whose anchor\n * left the transcript (a rewind emptied it in place) is left out too. A\n * malformed document reads as absent.\n */\nexport function readDeepAgentMessageWindow(\n  mounted: ReadonlyMap<number, StatewireDocuments.Document> | undefined\n): DeepAgentMessageWindow | null {\n  if (mounted === undefined) return null;\n  let windows: DeepAgentInterestResolution[] | undefined;\n  const documents = new Map<string, LangChainMessage>();\n  for (const document of mounted.values()) {\n    const key = document.key;\n    if (document.protocol === DEEP_AGENT_INTEREST_PROTOCOL && document.main === true) {\n      windows = readDeepAgentInterestDocument(document.value)?.windows;\n    } else if (\n      document.protocol === DEEP_AGENT_STATEWIRE_PROTOCOL &&\n      key !== null &&\n      key.length === 3 &&\n      key[1] === DEEP_AGENT_MAIN_NS\n    ) {\n      documents.set(key[2] as string, document.value as LangChainMessage);\n    }\n  }\n  const head = windows?.[0];\n  if (windows === undefined || head === undefined) return null;\n  let chain = head.chain;\n  let hasOlder = head.more.before;\n  const requests = [interestRequest(head)];\n  const loaded = new Set(chain.map((entry) => entry.id));\n  let pages = 0;\n  for (const page of windows.slice(1)) {\n    if (page.at === undefined || !loaded.has(page.at)) continue;\n    const anchorAt = page.chain.findIndex((entry) => entry.id === page.at);\n    if (anchorAt < 0) continue;\n    // Both windows are ranges of one linear transcript sharing the anchor:\n    // what the page holds below it and the chain does not is a prefix.\n    const fresh = page.chain.slice(0, anchorAt).filter((entry) => !loaded.has(entry.id));\n    if (fresh.length === 0) {\n      // Nothing new, but a page that starts where the loaded chain starts\n      // has looked below it: its `more.before` is the answer for the edge.\n      if (page.chain[0]?.id === chain[0]?.id) hasOlder = page.more.before;\n      continue;\n    }\n    chain = [...fresh, ...chain];\n    for (const entry of fresh) loaded.add(entry.id);\n    hasOlder = page.more.before;\n    requests.push(interestRequest(page));\n    pages += 1;\n  }\n  const messages: LangChainMessage[] = [];\n  for (const entry of chain) {\n    const message = documents.get(entry.id);\n    if (message !== undefined) messages.push(message);\n  }\n  return { requests, chain, messages, hasOlder, pages };\n}\n\n/**\n * The windowed wire's read command on the statewire command union, so\n * `sendCommand({ type: 'history/tool_output', … })` typechecks wherever the\n * deep-agent host is driven (`DeepAgentThread.history_tool_output`, an\n * attach-ACL read).\n */\ndeclare module '@assistant-ui/core' {\n  namespace Assistant {\n    interface Commands {\n      /** A tool output the windowed wire carried cut, whole. */\n      historyToolOutput: ToolOutputCommand;\n      /** One stored message whole — the per-client shape, by command. */\n      historyMessage: HistoryMessageCommand;\n    }\n  }\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/**\n * The `history/message` command: a message as the host stores it — the\n * model-provenance blobs the wire strips and an untruncated tool output\n * included. Every client receives one projected wire form; this is the one\n * per-client shape, fetched on demand like `history/tool_output`.\n */\nexport interface HistoryMessageCommand {\n  readonly type: typeof DEEP_AGENT_HISTORY_MESSAGE_COMMAND;\n  readonly messageId: string;\n}\n\nexport function buildHistoryMessageCommand({\n  messageId,\n}: {\n  messageId: string;\n}): HistoryMessageCommand {\n  return { type: DEEP_AGENT_HISTORY_MESSAGE_COMMAND, messageId };\n}\n\nexport interface HistoryMessageResult {\n  messageId: string;\n  message: LangChainMessage;\n}\n\nexport function readHistoryMessageResult(payload: unknown): HistoryMessageResult | null {\n  if (typeof payload !== 'object' || payload === null) return null;\n  const { messageId, message } = payload as Record<string, unknown>;\n  if (typeof messageId !== 'string' || !messageId) return null;\n  if (typeof message !== 'object' || message === null) return null;\n  return { messageId, message: message as LangChainMessage };\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_DEFAULT_MESSAGE_WINDOW","DEEP_AGENT_MIN_MESSAGE_WINDOW","DEEP_AGENT_MAX_MESSAGE_WINDOW","DEEP_AGENT_MAIN_NS","DEEP_AGENT_MESSAGE_WINDOW_HEADER","DEEP_AGENT_MAX_INTERESTS","DEEP_AGENT_INTEREST_PROTOCOL","DEEP_AGENT_STATEWIRE_PROTOCOL","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

@@ -1,50 +1,153 @@
-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";
+import { DEEP_AGENT_MAX_INTERESTS, DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND, DEEP_AGENT_INTEREST_PROTOCOL, DEEP_AGENT_MAIN_NS, DEEP_AGENT_MAX_MESSAGE_WINDOW, DEEP_AGENT_DEFAULT_MESSAGE_WINDOW, DEEP_AGENT_MIN_MESSAGE_WINDOW, DEEP_AGENT_MESSAGE_WINDOW_HEADER, DEEP_AGENT_TRUNCATED_CONTENT_KEY } from "./generated/runconfig-contract.js";
+import { DEEP_AGENT_STATEWIRE_PROTOCOL } from "./statewire-transport.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 };
+function clampMessageWindowSize(size) {
+  if (size === void 0 || !Number.isFinite(size)) return DEEP_AGENT_DEFAULT_MESSAGE_WINDOW;
+  return Math.max(
+    DEEP_AGENT_MIN_MESSAGE_WINDOW,
+    Math.min(DEEP_AGENT_MAX_MESSAGE_WINDOW, Math.trunc(size))
+  );
+}
+function headInterestRequest(size) {
+  return { ns: DEEP_AGENT_MAIN_NS, before: clampMessageWindowSize(size) };
+}
+function pageInterestRequest(at, size) {
+  return { ns: DEEP_AGENT_MAIN_NS, before: clampMessageWindowSize(size), at };
 }
-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;
+  if (DEEP_AGENT_MESSAGE_WINDOW_HEADER in headers) return headers;
+  return {
+    ...headers,
+    [DEEP_AGENT_MESSAGE_WINDOW_HEADER]: String(clampMessageWindowSize(declaration.size))
+  };
 }
-function buildHistoryLoadCommand({
-  window,
-  limit
-}) {
-  if (window.start <= 0) return null;
-  const requested = limit ?? window.size;
+function readDeepAgentInterestResolution(value) {
+  if (typeof value !== "object" || value === null) return null;
+  const { ns, before, at, after, chain, more } = value;
+  if (ns !== DEEP_AGENT_MAIN_NS || !isIndex(before) || !Array.isArray(chain)) return null;
+  if (at !== void 0 && typeof at !== "string") return null;
+  if (after !== void 0 && !isIndex(after)) return null;
+  if (typeof more !== "object" || more === null) return null;
+  const { before: moreBefore, after: moreAfter } = more;
+  if (typeof moreBefore !== "boolean" || typeof moreAfter !== "boolean") return null;
+  const entries = [];
+  for (const entry of chain) {
+    const { id, siblings } = entry ?? {};
+    if (typeof id !== "string") return null;
+    entries.push({
+      id,
+      siblings: Array.isArray(siblings) ? siblings.filter((s) => typeof s === "string") : [id]
+    });
+  }
   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)))
+    ns: DEEP_AGENT_MAIN_NS,
+    before,
+    ...at !== void 0 && { at },
+    ...after !== void 0 && { after },
+    chain: entries,
+    more: { before: moreBefore, after: moreAfter }
   };
 }
-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 readDeepAgentInterestDocument(value) {
+  if (typeof value !== "object" || value === null) return null;
+  const { windows } = value;
+  if (!Array.isArray(windows)) return null;
+  const resolutions = [];
+  for (const window of windows) {
+    const resolution = readDeepAgentInterestResolution(window);
+    if (resolution === null) return null;
+    resolutions.push(resolution);
+  }
+  return { windows: resolutions };
+}
+const interestRequest = ({ ns, before, at, after }) => ({
+  ns,
+  before,
+  ...at !== void 0 && { at },
+  ...after !== void 0 && { after }
+});
+function coalescedInterestRequests(chain, grow) {
+  const loaded = chain.length;
+  const requests = [
+    { ns: DEEP_AGENT_MAIN_NS, before: Math.min(DEEP_AGENT_MAX_MESSAGE_WINDOW, loaded) }
+  ];
+  let low = loaded - requests[0].before;
+  while (low > 0) {
+    const before = Math.min(DEEP_AGENT_MAX_MESSAGE_WINDOW, low + 1);
+    requests.push({
+      ns: DEEP_AGENT_MAIN_NS,
+      before,
+      at: chain[low].id
+    });
+    low = low + 1 - before;
+  }
+  const last = requests[requests.length - 1];
+  if (last.before + grow <= DEEP_AGENT_MAX_MESSAGE_WINDOW) {
+    requests[requests.length - 1] = { ...last, before: last.before + grow };
+  } else {
+    requests.push({
+      ns: DEEP_AGENT_MAIN_NS,
+      before: grow + 1,
+      at: chain[0].id
+    });
+  }
+  return requests.length > DEEP_AGENT_MAX_INTERESTS ? null : requests;
+}
+function pageInterestRequests(window, size) {
+  var _a;
+  const anchor = (_a = window.chain[0]) == null ? void 0 : _a.id;
+  if (anchor === void 0 || !window.hasOlder) return null;
+  const page = pageInterestRequest(anchor, size);
+  const appended = [...window.requests, page];
+  if (appended.length <= DEEP_AGENT_MAX_INTERESTS) return appended;
+  return coalescedInterestRequests(window.chain, page.before - 1);
+}
+function interestsCovered(carried, stated) {
+  return stated.every(
+    (request) => carried.some((have) => have.at === request.at && have.before >= request.before)
+  );
+}
+function readDeepAgentMessageWindow(mounted) {
+  var _a, _b, _c;
+  if (mounted === void 0) return null;
+  let windows;
+  const documents = /* @__PURE__ */ new Map();
+  for (const document of mounted.values()) {
+    const key = document.key;
+    if (document.protocol === DEEP_AGENT_INTEREST_PROTOCOL && document.main === true) {
+      windows = (_a = readDeepAgentInterestDocument(document.value)) == null ? void 0 : _a.windows;
+    } else if (document.protocol === DEEP_AGENT_STATEWIRE_PROTOCOL && key !== null && key.length === 3 && key[1] === DEEP_AGENT_MAIN_NS) {
+      documents.set(key[2], document.value);
+    }
+  }
+  const head = windows == null ? void 0 : windows[0];
+  if (windows === void 0 || head === void 0) return null;
+  let chain = head.chain;
+  let hasOlder = head.more.before;
+  const requests = [interestRequest(head)];
+  const loaded = new Set(chain.map((entry) => entry.id));
+  let pages = 0;
+  for (const page of windows.slice(1)) {
+    if (page.at === void 0 || !loaded.has(page.at)) continue;
+    const anchorAt = page.chain.findIndex((entry) => entry.id === page.at);
+    if (anchorAt < 0) continue;
+    const fresh = page.chain.slice(0, anchorAt).filter((entry) => !loaded.has(entry.id));
+    if (fresh.length === 0) {
+      if (((_b = page.chain[0]) == null ? void 0 : _b.id) === ((_c = chain[0]) == null ? void 0 : _c.id)) hasOlder = page.more.before;
+      continue;
+    }
+    chain = [...fresh, ...chain];
+    for (const entry of fresh) loaded.add(entry.id);
+    hasOlder = page.more.before;
+    requests.push(interestRequest(page));
+    pages += 1;
+  }
+  const messages = [];
+  for (const entry of chain) {
+    const message = documents.get(entry.id);
+    if (message !== void 0) messages.push(message);
+  }
+  return { requests, chain, messages, hasOlder, pages };
 }
 function buildToolOutputCommand({ messageId }) {
   return { type: DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND, messageId };
@@ -73,10 +176,15 @@ function readTruncatedToolOutputArtifact(artifact) {
 }
 export {
   ATHENA_TRUNCATED_TOOL_OUTPUT_ARTIFACT_KEY,
-  buildHistoryLoadCommand,
   buildToolOutputCommand,
-  readDeepAgentMessagesWindow,
-  readHistoryLoadResult,
+  clampMessageWindowSize,
+  headInterestRequest,
+  interestsCovered,
+  pageInterestRequest,
+  pageInterestRequests,
+  readDeepAgentInterestDocument,
+  readDeepAgentInterestResolution,
+  readDeepAgentMessageWindow,
   readToolOutputResult,
   readTruncatedToolContent,
   readTruncatedToolOutputArtifact,