@athenaintel/react 0.28.0 → 0.30.0

package/dist/agent-runtime/src/subscription-wake-event.js

@@ -0,0 +1,252 @@
+const SUBSCRIPTION_EVENT_KEY = "athena_subscription_event";
+const MAX_SHOWN_PLACES = 3;
+const MAX_VALUE_CHARS = 40;
+const CONTENT_CHANGED = "asset.content.changed";
+const COMMENT_CREATED = "asset.comment.created";
+const COMMENT_REPLIED = "asset.comment.replied";
+const COMMENT_RESOLVED = "asset.comment.resolved";
+const PRESENCE_JOINED = "asset.presence.joined";
+const SLACK_PREFIX = "user_slack.";
+const COMMENT_EVENTS = /* @__PURE__ */ new Set([
+  COMMENT_CREATED,
+  COMMENT_REPLIED,
+  COMMENT_RESOLVED
+]);
+const SLACK_WORDS = {
+  "user_slack.dm.received": "sent you a Slack direct message",
+  "user_slack.mention.received": "mentioned you in Slack",
+  "user_slack.thread_reply.received": "replied in your Slack thread",
+  "user_slack.channel_message.posted": "posted in a Slack channel",
+  "user_slack.reaction.added": "reacted to a Slack message",
+  "user_slack.message.saved": "saved a Slack message",
+  "user_slack.pin.added": "pinned a Slack message"
+};
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringOf(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value : null;
+}
+function numberOf(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function sheetQualifier(sheet) {
+  return /^[A-Za-z_][A-Za-z0-9_.]*$/.test(sheet) ? sheet : `'${sheet.replaceAll("'", "''")}'`;
+}
+function subscriptionPlaceWords(anchor) {
+  if (!isRecord(anchor)) return null;
+  const sheet = stringOf(anchor.sheet) ?? stringOf(anchor.sheet_name);
+  const range = stringOf(anchor.range) ?? stringOf(anchor.cell);
+  if (range) return sheet ? `${sheetQualifier(sheet)}!${range}` : range;
+  const page = numberOf(anchor.page);
+  if (page !== null) return `page ${page}`;
+  const slide = numberOf(anchor.slide_index);
+  if (slide !== null) return `slide ${slide}`;
+  return null;
+}
+function actorWords(envelope) {
+  const actor = isRecord(envelope.actor) ? envelope.actor : {};
+  const name = stringOf(actor.name);
+  let who;
+  switch (actor.kind) {
+    case "self":
+      who = "You";
+      break;
+    case "agent":
+      who = name ?? "An agent";
+      break;
+    case "system":
+      who = name ?? "Athena";
+      break;
+    default:
+      who = name ?? "Someone";
+  }
+  const more = numberOf(envelope.more_actors) ?? 0;
+  if (more <= 0) return who;
+  return `${who} and ${more} ${more === 1 ? "other" : "others"}`;
+}
+function readChanges(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    if (!isRecord(entry)) return [];
+    const raw = entry.value;
+    const scalar = typeof raw === "string" || typeof raw === "number" || typeof raw === "boolean" ? String(raw) : null;
+    return [{ place: subscriptionPlaceWords(entry.anchor), value: scalar }];
+  });
+}
+function readSubscriptionWakeEvent(custom) {
+  const envelope = custom == null ? void 0 : custom[SUBSCRIPTION_EVENT_KEY];
+  if (!isRecord(envelope)) return void 0;
+  const subscriptionId = stringOf(envelope.subscription_id);
+  if (subscriptionId === null) return void 0;
+  const comment = isRecord(envelope.comment) ? envelope.comment : null;
+  const schedule = isRecord(envelope.schedule) ? envelope.schedule : null;
+  const eventTypes = Array.isArray(envelope.event_types) ? envelope.event_types.filter((type) => typeof type === "string") : [];
+  const subscribed = Array.isArray(envelope.subscribed) ? envelope.subscribed.flatMap((anchor) => {
+    const words = subscriptionPlaceWords(anchor);
+    return words ? [words] : [];
+  }) : [];
+  return {
+    subscriptionId,
+    kind: envelope.kind === "schedule" ? "schedule" : "event",
+    assetTitle: stringOf(envelope.asset_title),
+    eventTypes,
+    eventCount: numberOf(envelope.event_count),
+    actor: actorWords(envelope),
+    changes: readChanges(envelope.changes),
+    moreChanges: Math.max(0, numberOf(envelope.more_changes) ?? 0),
+    subscribed,
+    commentPlace: comment ? subscriptionPlaceWords(comment.anchor) : null,
+    commentResolved: typeof (comment == null ? void 0 : comment.resolved) === "boolean" ? comment.resolved : null,
+    scheduleSetAt: schedule ? stringOf(schedule.set_at) : null,
+    note: stringOf(envelope.note),
+    runsLeft: numberOf(envelope.runs_left),
+    deliveredAt: stringOf(envelope.delivered_at)
+  };
+}
+function isSubscriptionWakeMessage(custom) {
+  return readSubscriptionWakeEvent(custom) !== void 0;
+}
+function valueWords(value) {
+  const folded = value.replace(/\s+/g, " ").trim();
+  if (folded === "") return "“ ”";
+  return folded.length > MAX_VALUE_CHARS ? `${folded.slice(0, MAX_VALUE_CHARS - 1).trimEnd()}…` : folded;
+}
+function joinList({ items, last }) {
+  if (items.length <= 1) return items.join("");
+  return `${items.slice(0, -1).join(", ")}${last}${items.at(-1)}`;
+}
+function joinClauses(clauses) {
+  const itemLast = clauses.length === 1 ? " and " : ", ";
+  return joinList({
+    items: clauses.map(({ lead, items }) => `${lead}${joinList({ items, last: itemLast })}`),
+    last: " and "
+  });
+}
+function changeClauses({
+  changes,
+  moreChanges
+}) {
+  const located = changes.filter(
+    (change) => change.place !== null
+  );
+  const shown = located.slice(0, MAX_SHOWN_PLACES);
+  if (shown.length === 0) return [];
+  const hidden = located.length - shown.length + moreChanges;
+  const set = shown.filter((change) => change.value !== null && change.value !== "");
+  const cleared = shown.filter((change) => change.value === "");
+  const changed = shown.filter((change) => change.value === null);
+  const clauses = [];
+  if (set.length > 0) {
+    clauses.push({
+      lead: "set ",
+      items: set.map((change) => `${change.place} to ${valueWords(change.value ?? "")}`)
+    });
+  }
+  if (cleared.length > 0) {
+    clauses.push({ lead: "cleared ", items: cleared.map((change) => change.place) });
+  }
+  if (changed.length > 0) {
+    clauses.push({ lead: "changed ", items: changed.map((change) => change.place) });
+  }
+  if (hidden > 0) clauses.push({ lead: `${hidden} more`, items: [] });
+  return clauses;
+}
+function commentLead({ type, resolved }) {
+  if (type === COMMENT_CREATED) return "commented on ";
+  if (type === COMMENT_REPLIED) return "replied to a comment on ";
+  const verb = resolved === true ? "resolved" : resolved === false ? "reopened" : "updated";
+  return `${verb} a comment on `;
+}
+function eventLabel(type) {
+  const words = type.replace(/^asset\./, "").replace(/[.\s_-]+/g, " ").trim().toLowerCase();
+  return words ? `${words.charAt(0).toUpperCase()}${words.slice(1)}` : "—";
+}
+function eventClauses(event) {
+  const asset = event.assetTitle ?? "the asset";
+  const changes = changeClauses({ changes: event.changes, moreChanges: event.moreChanges });
+  const listed = event.eventTypes;
+  const types = [
+    ...new Set(
+      listed.length === 0 || changes.length > 0 && !listed.includes(CONTENT_CHANGED) ? [CONTENT_CHANGED, ...listed] : listed
+    )
+  ];
+  const firstComment = types.find((type) => COMMENT_EVENTS.has(type));
+  const clauses = types.flatMap((type) => {
+    if (type === CONTENT_CHANGED) {
+      return changes.length > 0 ? changes : [{ lead: "edited ", items: [asset] }];
+    }
+    if (COMMENT_EVENTS.has(type)) {
+      const where = type === firstComment && event.commentPlace ? event.commentPlace : asset;
+      return [{ lead: commentLead({ type, resolved: event.commentResolved }), items: [where] }];
+    }
+    if (type === PRESENCE_JOINED) return [{ lead: "opened ", items: [asset] }];
+    if (type.startsWith(SLACK_PREFIX)) {
+      return [{ lead: SLACK_WORDS[type] ?? "had Slack activity", items: [] }];
+    }
+    return [{ lead: `triggered “${eventLabel(type)}” on `, items: [asset] }];
+  });
+  const said = /* @__PURE__ */ new Set();
+  return clauses.filter((clause) => {
+    if (clause.items.length > 0) return true;
+    if (said.has(clause.lead)) return false;
+    said.add(clause.lead);
+    return true;
+  });
+}
+function setOnWords({ setAt, now }) {
+  const date = new Date(setAt);
+  if (Number.isNaN(date.getTime())) return null;
+  const midnight = (day) => new Date(day.getFullYear(), day.getMonth(), day.getDate()).getTime();
+  const days = Math.round((midnight(now) - midnight(date)) / (24 * 60 * 60 * 1e3));
+  if (days === 0) return "today";
+  if (days === 1) return "yesterday";
+  const sameYear = date.getFullYear() === now.getFullYear();
+  return `on ${date.toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    ...sameYear ? {} : { year: "numeric" }
+  })}`;
+}
+function subscriptionWakeHeadline({
+  event,
+  now = /* @__PURE__ */ new Date()
+}) {
+  if (event.kind === "schedule") {
+    const when = event.scheduleSetAt ? setOnWords({ setAt: event.scheduleSetAt, now }) : null;
+    return when ? `Scheduled check-in you set ${when}` : "Scheduled check-in";
+  }
+  return `${event.actor} ${joinClauses(eventClauses(event))}`;
+}
+function runsLeftWords(runsLeft) {
+  if (runsLeft <= 0) return "No runs left";
+  return `${runsLeft} ${runsLeft === 1 ? "run" : "runs"} left`;
+}
+function subscriptionWakeDetail(event) {
+  if (event.kind === "schedule") {
+    const parts2 = [
+      event.note,
+      event.runsLeft !== null && event.runsLeft > 0 ? runsLeftWords(event.runsLeft) : null
+    ].filter((part) => part !== null);
+    return parts2.length > 0 ? parts2.join(" · ") : null;
+  }
+  const shown = event.subscribed.slice(0, MAX_SHOWN_PLACES);
+  const hidden = event.subscribed.length - shown.length;
+  const subscribed = shown.length > 0 ? `subscribed to ${shown.join(", ")}${hidden > 0 ? ` and ${hidden} more` : ""}` : null;
+  const parts = [
+    event.assetTitle,
+    subscribed,
+    event.runsLeft !== null ? runsLeftWords(event.runsLeft) : null,
+    event.eventCount !== null && event.eventCount > 1 ? `${event.eventCount} events` : null
+  ].filter((part) => part !== null);
+  return parts.length > 0 ? parts.join(" · ") : null;
+}
+export {
+  SUBSCRIPTION_EVENT_KEY,
+  isSubscriptionWakeMessage,
+  readSubscriptionWakeEvent,
+  subscriptionPlaceWords,
+  subscriptionWakeDetail,
+  subscriptionWakeHeadline
+};
+//# sourceMappingURL=subscription-wake-event.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-wake-event.js","sources":["../../../../agent-runtime/src/subscription-wake-event.ts"],"sourcesContent":["/**\n * The asset-subscription delivery that woke a conversation, read from the user\n * turn the delivery started.\n *\n * When an asset subscription fires, agora starts a turn on its conversation\n * with the delivery text the model reads (`render_delivery`), and stamps the\n * facts a person needs beside it under `athena_subscription_event` in the\n * message metadata — server-authoritative like `author`, never sent to the\n * model. The shipped converter exposes that metadata as the thread message's\n * `metadata.custom`, so a surface renders the turn as a compact marker\n * (\"Brendon Geils set B4 to Target\") instead of a user bubble quoting the\n * delivery text. Olympus draws the same facts as its event card with citation\n * chips; this is the text every other surface shows. The envelope is for\n * RENDERING only: a surface that ignores it degrades to a plain bubble, never\n * to a lost instruction.\n */\n\n/** `metadata.custom` key agora stamps on a subscription's delivery turn. */\nexport const SUBSCRIPTION_EVENT_KEY = 'athena_subscription_event';\n\n/** A changed cell or range, and its value now when agora read it. */\nexport interface SubscriptionWakeChange {\n  /** Where: \"B4\", \"Sheet1!B2:B11\", \"page 5\"; `null` for a place the marker has no words for. */\n  place: string | null;\n  /** The value now; `null` when agora read none (a busy run's tray, a failed or capped read). */\n  value: string | null;\n}\n\nexport interface SubscriptionWakeEvent {\n  subscriptionId: string;\n  /** `event`: something happened on an asset. `schedule`: a check-in the person set. */\n  kind: 'event' | 'schedule';\n  assetTitle: string | null;\n  eventTypes: string[];\n  eventCount: number | null;\n  /** Who did it, in words: their name, \"You\", \"An agent\", \"Athena\", \"Someone\", with others counted. */\n  actor: string;\n  changes: SubscriptionWakeChange[];\n  /** Changed places past the ones `changes` lists (agora caps the list): counted, never named. */\n  moreChanges: number;\n  /** The ranges the subscription names (\"B2:B11\"); empty for the whole asset. */\n  subscribed: string[];\n  /** Where a comment event's thread sits, when its anchor names a place. */\n  commentPlace: string | null;\n  /** Whether a comment-resolved event resolved (true) or reopened (false); `null` when unsaid. */\n  commentResolved: boolean | null;\n  /** When the person set a scheduled check-in. */\n  scheduleSetAt: string | null;\n  /** A scheduled check-in's own words. */\n  note: string | null;\n  runsLeft: number | null;\n  deliveredAt: string | null;\n}\n\n/** Changed places and subscribed ranges named in one line; the rest are counted. */\nconst MAX_SHOWN_PLACES = 3;\n/** A changed value longer than this is cut in the marker. */\nconst MAX_VALUE_CHARS = 40;\n\nconst CONTENT_CHANGED = 'asset.content.changed';\nconst COMMENT_CREATED = 'asset.comment.created';\nconst COMMENT_REPLIED = 'asset.comment.replied';\nconst COMMENT_RESOLVED = 'asset.comment.resolved';\nconst PRESENCE_JOINED = 'asset.presence.joined';\nconst SLACK_PREFIX = 'user_slack.';\nconst COMMENT_EVENTS: ReadonlySet<string> = new Set([\n  COMMENT_CREATED,\n  COMMENT_REPLIED,\n  COMMENT_RESOLVED,\n]);\n\nconst SLACK_WORDS: Readonly<Record<string, string>> = {\n  'user_slack.dm.received': 'sent you a Slack direct message',\n  'user_slack.mention.received': 'mentioned you in Slack',\n  'user_slack.thread_reply.received': 'replied in your Slack thread',\n  'user_slack.channel_message.posted': 'posted in a Slack channel',\n  'user_slack.reaction.added': 'reacted to a Slack message',\n  'user_slack.message.saved': 'saved a Slack message',\n  'user_slack.pin.added': 'pinned a Slack message',\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** A string with something in it, else `null`. */\nfunction stringOf(value: unknown): string | null {\n  return typeof value === 'string' && value.trim().length > 0 ? value : null;\n}\n\n/** A finite number, else `null`. */\nfunction numberOf(value: unknown): number | null {\n  return typeof value === 'number' && Number.isFinite(value) ? value : null;\n}\n\n/** A sheet name as an A1 qualifier: quoted when it is not a bare word. */\nfunction sheetQualifier(sheet: string): string {\n  return /^[A-Za-z_][A-Za-z0-9_.]*$/.test(sheet) ? sheet : `'${sheet.replaceAll(\"'\", \"''\")}'`;\n}\n\n/**\n * Where a reference-standard anchor in agora's wire form points, in words:\n * a range or cell (with its sheet when the anchor names one), a page, a\n * slide; `null` for any other place.\n */\nexport function subscriptionPlaceWords(anchor: unknown): string | null {\n  if (!isRecord(anchor)) return null;\n  const sheet = stringOf(anchor.sheet) ?? stringOf(anchor.sheet_name);\n  const range = stringOf(anchor.range) ?? stringOf(anchor.cell);\n  if (range) return sheet ? `${sheetQualifier(sheet)}!${range}` : range;\n  const page = numberOf(anchor.page);\n  if (page !== null) return `page ${page}`;\n  const slide = numberOf(anchor.slide_index);\n  if (slide !== null) return `slide ${slide}`;\n  return null;\n}\n\nfunction actorWords(envelope: Record<string, unknown>): string {\n  const actor = isRecord(envelope.actor) ? envelope.actor : {};\n  const name = stringOf(actor.name);\n  let who: string;\n  switch (actor.kind) {\n    case 'self':\n      who = 'You';\n      break;\n    case 'agent':\n      who = name ?? 'An agent';\n      break;\n    case 'system':\n      who = name ?? 'Athena';\n      break;\n    default:\n      who = name ?? 'Someone';\n  }\n  const more = numberOf(envelope.more_actors) ?? 0;\n  if (more <= 0) return who;\n  return `${who} and ${more} ${more === 1 ? 'other' : 'others'}`;\n}\n\nfunction readChanges(value: unknown): SubscriptionWakeChange[] {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    if (!isRecord(entry)) return [];\n    const raw = entry.value;\n    const scalar =\n      typeof raw === 'string' || typeof raw === 'number' || typeof raw === 'boolean'\n        ? String(raw)\n        : null;\n    return [{ place: subscriptionPlaceWords(entry.anchor), value: scalar }];\n  });\n}\n\n/**\n * The delivery behind a thread message's `metadata.custom`, or `undefined`\n * when the message is not a subscription's delivery (or carries no\n * subscription id). Every other field is read leniently: a field of the wrong\n * shape reads as absent.\n */\nexport function readSubscriptionWakeEvent(\n  custom: Record<string, unknown> | null | undefined\n): SubscriptionWakeEvent | undefined {\n  const envelope = custom?.[SUBSCRIPTION_EVENT_KEY];\n  if (!isRecord(envelope)) return undefined;\n  const subscriptionId = stringOf(envelope.subscription_id);\n  if (subscriptionId === null) return undefined;\n  const comment = isRecord(envelope.comment) ? envelope.comment : null;\n  const schedule = isRecord(envelope.schedule) ? envelope.schedule : null;\n  const eventTypes = Array.isArray(envelope.event_types)\n    ? envelope.event_types.filter((type): type is string => typeof type === 'string')\n    : [];\n  const subscribed = Array.isArray(envelope.subscribed)\n    ? envelope.subscribed.flatMap((anchor) => {\n        const words = subscriptionPlaceWords(anchor);\n        return words ? [words] : [];\n      })\n    : [];\n  return {\n    subscriptionId,\n    kind: envelope.kind === 'schedule' ? 'schedule' : 'event',\n    assetTitle: stringOf(envelope.asset_title),\n    eventTypes,\n    eventCount: numberOf(envelope.event_count),\n    actor: actorWords(envelope),\n    changes: readChanges(envelope.changes),\n    moreChanges: Math.max(0, numberOf(envelope.more_changes) ?? 0),\n    subscribed,\n    commentPlace: comment ? subscriptionPlaceWords(comment.anchor) : null,\n    commentResolved: typeof comment?.resolved === 'boolean' ? comment.resolved : null,\n    scheduleSetAt: schedule ? stringOf(schedule.set_at) : null,\n    note: stringOf(envelope.note),\n    runsLeft: numberOf(envelope.runs_left),\n    deliveredAt: stringOf(envelope.delivered_at),\n  };\n}\n\n/**\n * Whether a thread message is a subscription's delivery. Returns a primitive,\n * so it is safe as a `useAuiState` selector.\n */\nexport function isSubscriptionWakeMessage(\n  custom: Record<string, unknown> | null | undefined\n): boolean {\n  return readSubscriptionWakeEvent(custom) !== undefined;\n}\n\n/**\n * A value as the marker shows it: whitespace folded, cut at\n * {@link MAX_VALUE_CHARS}. A value of only whitespace is not empty (an empty\n * one is \"cleared\"), so it reads as a quoted space rather than as nothing.\n */\nfunction valueWords(value: string): string {\n  const folded = value.replace(/\\s+/g, ' ').trim();\n  if (folded === '') return '“ ”';\n  return folded.length > MAX_VALUE_CHARS\n    ? `${folded.slice(0, MAX_VALUE_CHARS - 1).trimEnd()}…`\n    : folded;\n}\n\n/** \"a, b and c\" — items joined the way a sentence lists them, `last` before the last. */\nfunction joinList({ items, last }: { items: string[]; last: string }): string {\n  if (items.length <= 1) return items.join('');\n  return `${items.slice(0, -1).join(', ')}${last}${items.at(-1)}`;\n}\n\n/** One clause of the marker's line: its leading words, then the places it lists. */\ninterface Clause {\n  lead: string;\n  items: string[];\n}\n\n/**\n * The clauses after who did it, as one predicate: \"set B4 to Target and\n * commented on B7\". The clauses are listed \"a, b and c\". A lone clause lists\n * its own items the same way (\"changed B4 and B7\"); with several, each lists\n * its items with commas only, so the clauses' \"and\" is the only one.\n */\nfunction joinClauses(clauses: Clause[]): string {\n  const itemLast = clauses.length === 1 ? ' and ' : ', ';\n  return joinList({\n    items: clauses.map(({ lead, items }) => `${lead}${joinList({ items, last: itemLast })}`),\n    last: ' and ',\n  });\n}\n\n/**\n * The changed places as clauses: \"set B4 to Target\", \"cleared B9\", \"changed\n * B7\" (no value read). At most three places are named; the others — and the\n * ones agora counted past what it sent — are one more clause, \"2 more\".\n */\nfunction changeClauses({\n  changes,\n  moreChanges,\n}: {\n  changes: SubscriptionWakeChange[];\n  moreChanges: number;\n}): Clause[] {\n  const located = changes.filter(\n    (change): change is { place: string; value: string | null } => change.place !== null\n  );\n  const shown = located.slice(0, MAX_SHOWN_PLACES);\n  if (shown.length === 0) return [];\n  const hidden = located.length - shown.length + moreChanges;\n  const set = shown.filter((change) => change.value !== null && change.value !== '');\n  const cleared = shown.filter((change) => change.value === '');\n  const changed = shown.filter((change) => change.value === null);\n  const clauses: Clause[] = [];\n  if (set.length > 0) {\n    clauses.push({\n      lead: 'set ',\n      items: set.map((change) => `${change.place} to ${valueWords(change.value ?? '')}`),\n    });\n  }\n  if (cleared.length > 0) {\n    clauses.push({ lead: 'cleared ', items: cleared.map((change) => change.place) });\n  }\n  if (changed.length > 0) {\n    clauses.push({ lead: 'changed ', items: changed.map((change) => change.place) });\n  }\n  if (hidden > 0) clauses.push({ lead: `${hidden} more`, items: [] });\n  return clauses;\n}\n\nfunction commentLead({ type, resolved }: { type: string; resolved: boolean | null }): string {\n  if (type === COMMENT_CREATED) return 'commented on ';\n  if (type === COMMENT_REPLIED) return 'replied to a comment on ';\n  const verb = resolved === true ? 'resolved' : resolved === false ? 'reopened' : 'updated';\n  return `${verb} a comment on `;\n}\n\n/** An event type without words of its own, in words: `asset.version.created` → \"Version created\". */\nfunction eventLabel(type: string): string {\n  const words = type\n    .replace(/^asset\\./, '')\n    .replace(/[.\\s_-]+/g, ' ')\n    .trim()\n    .toLowerCase();\n  return words ? `${words.charAt(0).toUpperCase()}${words.slice(1)}` : '—';\n}\n\n/**\n * One clause per kind of event the delivery carries, in the order agora lists\n * them (first seen first), so a batch that both changed cells and brought a\n * comment says both. A content change is its changed places, or \"edited\n * <asset>\" when none were located; changes count as one even when the types\n * leave the content change out. The envelope's comment is the batch's first\n * comment event's, so only the first comment clause names its place.\n */\nfunction eventClauses(event: SubscriptionWakeEvent): Clause[] {\n  const asset = event.assetTitle ?? 'the asset';\n  const changes = changeClauses({ changes: event.changes, moreChanges: event.moreChanges });\n  const listed = event.eventTypes;\n  const types = [\n    ...new Set(\n      listed.length === 0 || (changes.length > 0 && !listed.includes(CONTENT_CHANGED))\n        ? [CONTENT_CHANGED, ...listed]\n        : listed\n    ),\n  ];\n  const firstComment = types.find((type) => COMMENT_EVENTS.has(type));\n  const clauses = types.flatMap((type): Clause[] => {\n    if (type === CONTENT_CHANGED) {\n      return changes.length > 0 ? changes : [{ lead: 'edited ', items: [asset] }];\n    }\n    if (COMMENT_EVENTS.has(type)) {\n      const where = type === firstComment && event.commentPlace ? event.commentPlace : asset;\n      return [{ lead: commentLead({ type, resolved: event.commentResolved }), items: [where] }];\n    }\n    if (type === PRESENCE_JOINED) return [{ lead: 'opened ', items: [asset] }];\n    if (type.startsWith(SLACK_PREFIX)) {\n      return [{ lead: SLACK_WORDS[type] ?? 'had Slack activity', items: [] }];\n    }\n    return [{ lead: `triggered “${eventLabel(type)}” on `, items: [asset] }];\n  });\n  // Two Slack events of kinds without words of their own say the same thing once.\n  const said = new Set<string>();\n  return clauses.filter((clause) => {\n    if (clause.items.length > 0) return true;\n    if (said.has(clause.lead)) return false;\n    said.add(clause.lead);\n    return true;\n  });\n}\n\n/** The day a check-in was set, as a person says it: \"today\", \"yesterday\", \"on Oct 8\". */\nfunction setOnWords({ setAt, now }: { setAt: string; now: Date }): string | null {\n  const date = new Date(setAt);\n  if (Number.isNaN(date.getTime())) return null;\n  const midnight = (day: Date) => new Date(day.getFullYear(), day.getMonth(), day.getDate()).getTime();\n  const days = Math.round((midnight(now) - midnight(date)) / (24 * 60 * 60 * 1000));\n  if (days === 0) return 'today';\n  if (days === 1) return 'yesterday';\n  const sameYear = date.getFullYear() === now.getFullYear();\n  return `on ${date.toLocaleDateString('en-US', {\n    month: 'short',\n    day: 'numeric',\n    ...(sameYear ? {} : { year: 'numeric' as const }),\n  })}`;\n}\n\n/**\n * The marker's line: who did what, where — \"Brendon Geils set B4 to Target\",\n * \"Brendon Geils changed B4\" when agora read no value, \"Ana Lopez commented\n * on B7\", \"Brendon Geils set B4 to Target and commented on B7\" for a batch\n * that carried both — or, for a schedule, \"Scheduled check-in you set on\n * Oct 8\" (`now` decides \"today\" and \"yesterday\").\n */\nexport function subscriptionWakeHeadline({\n  event,\n  now = new Date(),\n}: {\n  event: SubscriptionWakeEvent;\n  now?: Date;\n}): string {\n  if (event.kind === 'schedule') {\n    const when = event.scheduleSetAt ? setOnWords({ setAt: event.scheduleSetAt, now }) : null;\n    return when ? `Scheduled check-in you set ${when}` : 'Scheduled check-in';\n  }\n  return `${event.actor} ${joinClauses(eventClauses(event))}`;\n}\n\n/** \"99 runs left\", \"1 run left\", \"No runs left\". */\nfunction runsLeftWords(runsLeft: number): string {\n  if (runsLeft <= 0) return 'No runs left';\n  return `${runsLeft} ${runsLeft === 1 ? 'run' : 'runs'} left`;\n}\n\n/**\n * The line under it: \"Series A Investors · subscribed to B2:B11 · 99 runs\n * left · 3 events\" for an asset event; a check-in's note for a schedule.\n * `null` when there is nothing to add.\n */\nexport function subscriptionWakeDetail(event: SubscriptionWakeEvent): string | null {\n  if (event.kind === 'schedule') {\n    const parts = [\n      event.note,\n      event.runsLeft !== null && event.runsLeft > 0 ? runsLeftWords(event.runsLeft) : null,\n    ].filter((part): part is string => part !== null);\n    return parts.length > 0 ? parts.join(' · ') : null;\n  }\n  const shown = event.subscribed.slice(0, MAX_SHOWN_PLACES);\n  const hidden = event.subscribed.length - shown.length;\n  const subscribed =\n    shown.length > 0\n      ? `subscribed to ${shown.join(', ')}${hidden > 0 ? ` and ${hidden} more` : ''}`\n      : null;\n  const parts = [\n    event.assetTitle,\n    subscribed,\n    event.runsLeft !== null ? runsLeftWords(event.runsLeft) : null,\n    event.eventCount !== null && event.eventCount > 1 ? `${event.eventCount} events` : null,\n  ].filter((part): part is string => part !== null);\n  return parts.length > 0 ? parts.join(' · ') : null;\n}\n"],"names":["parts"],"mappings":"AAkBO,MAAM,yBAAyB;AAqCtC,MAAM,mBAAmB;AAEzB,MAAM,kBAAkB;AAExB,MAAM,kBAAkB;AACxB,MAAM,kBAAkB;AACxB,MAAM,kBAAkB;AACxB,MAAM,mBAAmB;AACzB,MAAM,kBAAkB;AACxB,MAAM,eAAe;AACrB,MAAM,qCAA0C,IAAI;AAAA,EAClD;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,MAAM,cAAgD;AAAA,EACpD,0BAA0B;AAAA,EAC1B,+BAA+B;AAAA,EAC/B,oCAAoC;AAAA,EACpC,qCAAqC;AAAA,EACrC,6BAA6B;AAAA,EAC7B,4BAA4B;AAAA,EAC5B,wBAAwB;AAC1B;AAEA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAGA,SAAS,SAAS,OAA+B;AAC/C,SAAO,OAAO,UAAU,YAAY,MAAM,OAAO,SAAS,IAAI,QAAQ;AACxE;AAGA,SAAS,SAAS,OAA+B;AAC/C,SAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,IAAI,QAAQ;AACvE;AAGA,SAAS,eAAe,OAAuB;AAC7C,SAAO,4BAA4B,KAAK,KAAK,IAAI,QAAQ,IAAI,MAAM,WAAW,KAAK,IAAI,CAAC;AAC1F;AAOO,SAAS,uBAAuB,QAAgC;AACrE,MAAI,CAAC,SAAS,MAAM,EAAG,QAAO;AAC9B,QAAM,QAAQ,SAAS,OAAO,KAAK,KAAK,SAAS,OAAO,UAAU;AAClE,QAAM,QAAQ,SAAS,OAAO,KAAK,KAAK,SAAS,OAAO,IAAI;AAC5D,MAAI,cAAc,QAAQ,GAAG,eAAe,KAAK,CAAC,IAAI,KAAK,KAAK;AAChE,QAAM,OAAO,SAAS,OAAO,IAAI;AACjC,MAAI,SAAS,KAAM,QAAO,QAAQ,IAAI;AACtC,QAAM,QAAQ,SAAS,OAAO,WAAW;AACzC,MAAI,UAAU,KAAM,QAAO,SAAS,KAAK;AACzC,SAAO;AACT;AAEA,SAAS,WAAW,UAA2C;AAC7D,QAAM,QAAQ,SAAS,SAAS,KAAK,IAAI,SAAS,QAAQ,CAAA;AAC1D,QAAM,OAAO,SAAS,MAAM,IAAI;AAChC,MAAI;AACJ,UAAQ,MAAM,MAAA;AAAA,IACZ,KAAK;AACH,YAAM;AACN;AAAA,IACF,KAAK;AACH,YAAM,QAAQ;AACd;AAAA,IACF,KAAK;AACH,YAAM,QAAQ;AACd;AAAA,IACF;AACE,YAAM,QAAQ;AAAA,EAAA;AAElB,QAAM,OAAO,SAAS,SAAS,WAAW,KAAK;AAC/C,MAAI,QAAQ,EAAG,QAAO;AACtB,SAAO,GAAG,GAAG,QAAQ,IAAI,IAAI,SAAS,IAAI,UAAU,QAAQ;AAC9D;AAEA,SAAS,YAAY,OAA0C;AAC7D,MAAI,CAAC,MAAM,QAAQ,KAAK,UAAU,CAAA;AAClC,SAAO,MAAM,QAAQ,CAAC,UAAU;AAC9B,QAAI,CAAC,SAAS,KAAK,UAAU,CAAA;AAC7B,UAAM,MAAM,MAAM;AAClB,UAAM,SACJ,OAAO,QAAQ,YAAY,OAAO,QAAQ,YAAY,OAAO,QAAQ,YACjE,OAAO,GAAG,IACV;AACN,WAAO,CAAC,EAAE,OAAO,uBAAuB,MAAM,MAAM,GAAG,OAAO,QAAQ;AAAA,EACxE,CAAC;AACH;AAQO,SAAS,0BACd,QACmC;AACnC,QAAM,WAAW,iCAAS;AAC1B,MAAI,CAAC,SAAS,QAAQ,EAAG,QAAO;AAChC,QAAM,iBAAiB,SAAS,SAAS,eAAe;AACxD,MAAI,mBAAmB,KAAM,QAAO;AACpC,QAAM,UAAU,SAAS,SAAS,OAAO,IAAI,SAAS,UAAU;AAChE,QAAM,WAAW,SAAS,SAAS,QAAQ,IAAI,SAAS,WAAW;AACnE,QAAM,aAAa,MAAM,QAAQ,SAAS,WAAW,IACjD,SAAS,YAAY,OAAO,CAAC,SAAyB,OAAO,SAAS,QAAQ,IAC9E,CAAA;AACJ,QAAM,aAAa,MAAM,QAAQ,SAAS,UAAU,IAChD,SAAS,WAAW,QAAQ,CAAC,WAAW;AACtC,UAAM,QAAQ,uBAAuB,MAAM;AAC3C,WAAO,QAAQ,CAAC,KAAK,IAAI,CAAA;AAAA,EAC3B,CAAC,IACD,CAAA;AACJ,SAAO;AAAA,IACL;AAAA,IACA,MAAM,SAAS,SAAS,aAAa,aAAa;AAAA,IAClD,YAAY,SAAS,SAAS,WAAW;AAAA,IACzC;AAAA,IACA,YAAY,SAAS,SAAS,WAAW;AAAA,IACzC,OAAO,WAAW,QAAQ;AAAA,IAC1B,SAAS,YAAY,SAAS,OAAO;AAAA,IACrC,aAAa,KAAK,IAAI,GAAG,SAAS,SAAS,YAAY,KAAK,CAAC;AAAA,IAC7D;AAAA,IACA,cAAc,UAAU,uBAAuB,QAAQ,MAAM,IAAI;AAAA,IACjE,iBAAiB,QAAO,mCAAS,cAAa,YAAY,QAAQ,WAAW;AAAA,IAC7E,eAAe,WAAW,SAAS,SAAS,MAAM,IAAI;AAAA,IACtD,MAAM,SAAS,SAAS,IAAI;AAAA,IAC5B,UAAU,SAAS,SAAS,SAAS;AAAA,IACrC,aAAa,SAAS,SAAS,YAAY;AAAA,EAAA;AAE/C;AAMO,SAAS,0BACd,QACS;AACT,SAAO,0BAA0B,MAAM,MAAM;AAC/C;AAOA,SAAS,WAAW,OAAuB;AACzC,QAAM,SAAS,MAAM,QAAQ,QAAQ,GAAG,EAAE,KAAA;AAC1C,MAAI,WAAW,GAAI,QAAO;AAC1B,SAAO,OAAO,SAAS,kBACnB,GAAG,OAAO,MAAM,GAAG,kBAAkB,CAAC,EAAE,QAAA,CAAS,MACjD;AACN;AAGA,SAAS,SAAS,EAAE,OAAO,QAAmD;AAC5E,MAAI,MAAM,UAAU,EAAG,QAAO,MAAM,KAAK,EAAE;AAC3C,SAAO,GAAG,MAAM,MAAM,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,EAAE,CAAC;AAC/D;AAcA,SAAS,YAAY,SAA2B;AAC9C,QAAM,WAAW,QAAQ,WAAW,IAAI,UAAU;AAClD,SAAO,SAAS;AAAA,IACd,OAAO,QAAQ,IAAI,CAAC,EAAE,MAAM,YAAY,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,MAAM,SAAA,CAAU,CAAC,EAAE;AAAA,IACvF,MAAM;AAAA,EAAA,CACP;AACH;AAOA,SAAS,cAAc;AAAA,EACrB;AAAA,EACA;AACF,GAGa;AACX,QAAM,UAAU,QAAQ;AAAA,IACtB,CAAC,WAA8D,OAAO,UAAU;AAAA,EAAA;AAElF,QAAM,QAAQ,QAAQ,MAAM,GAAG,gBAAgB;AAC/C,MAAI,MAAM,WAAW,EAAG,QAAO,CAAA;AAC/B,QAAM,SAAS,QAAQ,SAAS,MAAM,SAAS;AAC/C,QAAM,MAAM,MAAM,OAAO,CAAC,WAAW,OAAO,UAAU,QAAQ,OAAO,UAAU,EAAE;AACjF,QAAM,UAAU,MAAM,OAAO,CAAC,WAAW,OAAO,UAAU,EAAE;AAC5D,QAAM,UAAU,MAAM,OAAO,CAAC,WAAW,OAAO,UAAU,IAAI;AAC9D,QAAM,UAAoB,CAAA;AAC1B,MAAI,IAAI,SAAS,GAAG;AAClB,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,OAAO,IAAI,IAAI,CAAC,WAAW,GAAG,OAAO,KAAK,OAAO,WAAW,OAAO,SAAS,EAAE,CAAC,EAAE;AAAA,IAAA,CAClF;AAAA,EACH;AACA,MAAI,QAAQ,SAAS,GAAG;AACtB,YAAQ,KAAK,EAAE,MAAM,YAAY,OAAO,QAAQ,IAAI,CAAC,WAAW,OAAO,KAAK,EAAA,CAAG;AAAA,EACjF;AACA,MAAI,QAAQ,SAAS,GAAG;AACtB,YAAQ,KAAK,EAAE,MAAM,YAAY,OAAO,QAAQ,IAAI,CAAC,WAAW,OAAO,KAAK,EAAA,CAAG;AAAA,EACjF;AACA,MAAI,SAAS,EAAG,SAAQ,KAAK,EAAE,MAAM,GAAG,MAAM,SAAS,OAAO,CAAA,EAAC,CAAG;AAClE,SAAO;AACT;AAEA,SAAS,YAAY,EAAE,MAAM,YAAgE;AAC3F,MAAI,SAAS,gBAAiB,QAAO;AACrC,MAAI,SAAS,gBAAiB,QAAO;AACrC,QAAM,OAAO,aAAa,OAAO,aAAa,aAAa,QAAQ,aAAa;AAChF,SAAO,GAAG,IAAI;AAChB;AAGA,SAAS,WAAW,MAAsB;AACxC,QAAM,QAAQ,KACX,QAAQ,YAAY,EAAE,EACtB,QAAQ,aAAa,GAAG,EACxB,KAAA,EACA,YAAA;AACH,SAAO,QAAQ,GAAG,MAAM,OAAO,CAAC,EAAE,YAAA,CAAa,GAAG,MAAM,MAAM,CAAC,CAAC,KAAK;AACvE;AAUA,SAAS,aAAa,OAAwC;AAC5D,QAAM,QAAQ,MAAM,cAAc;AAClC,QAAM,UAAU,cAAc,EAAE,SAAS,MAAM,SAAS,aAAa,MAAM,aAAa;AACxF,QAAM,SAAS,MAAM;AACrB,QAAM,QAAQ;AAAA,IACZ,GAAG,IAAI;AAAA,MACL,OAAO,WAAW,KAAM,QAAQ,SAAS,KAAK,CAAC,OAAO,SAAS,eAAe,IAC1E,CAAC,iBAAiB,GAAG,MAAM,IAC3B;AAAA,IAAA;AAAA,EACN;AAEF,QAAM,eAAe,MAAM,KAAK,CAAC,SAAS,eAAe,IAAI,IAAI,CAAC;AAClE,QAAM,UAAU,MAAM,QAAQ,CAAC,SAAmB;AAChD,QAAI,SAAS,iBAAiB;AAC5B,aAAO,QAAQ,SAAS,IAAI,UAAU,CAAC,EAAE,MAAM,WAAW,OAAO,CAAC,KAAK,EAAA,CAAG;AAAA,IAC5E;AACA,QAAI,eAAe,IAAI,IAAI,GAAG;AAC5B,YAAM,QAAQ,SAAS,gBAAgB,MAAM,eAAe,MAAM,eAAe;AACjF,aAAO,CAAC,EAAE,MAAM,YAAY,EAAE,MAAM,UAAU,MAAM,gBAAA,CAAiB,GAAG,OAAO,CAAC,KAAK,GAAG;AAAA,IAC1F;AACA,QAAI,SAAS,gBAAiB,QAAO,CAAC,EAAE,MAAM,WAAW,OAAO,CAAC,KAAK,GAAG;AACzE,QAAI,KAAK,WAAW,YAAY,GAAG;AACjC,aAAO,CAAC,EAAE,MAAM,YAAY,IAAI,KAAK,sBAAsB,OAAO,CAAA,GAAI;AAAA,IACxE;AACA,WAAO,CAAC,EAAE,MAAM,cAAc,WAAW,IAAI,CAAC,SAAS,OAAO,CAAC,KAAK,EAAA,CAAG;AAAA,EACzE,CAAC;AAED,QAAM,2BAAW,IAAA;AACjB,SAAO,QAAQ,OAAO,CAAC,WAAW;AAChC,QAAI,OAAO,MAAM,SAAS,EAAG,QAAO;AACpC,QAAI,KAAK,IAAI,OAAO,IAAI,EAAG,QAAO;AAClC,SAAK,IAAI,OAAO,IAAI;AACpB,WAAO;AAAA,EACT,CAAC;AACH;AAGA,SAAS,WAAW,EAAE,OAAO,OAAoD;AAC/E,QAAM,OAAO,IAAI,KAAK,KAAK;AAC3B,MAAI,OAAO,MAAM,KAAK,QAAA,CAAS,EAAG,QAAO;AACzC,QAAM,WAAW,CAAC,QAAc,IAAI,KAAK,IAAI,YAAA,GAAe,IAAI,YAAY,IAAI,QAAA,CAAS,EAAE,QAAA;AAC3F,QAAM,OAAO,KAAK,OAAO,SAAS,GAAG,IAAI,SAAS,IAAI,MAAM,KAAK,KAAK,KAAK,IAAK;AAChF,MAAI,SAAS,EAAG,QAAO;AACvB,MAAI,SAAS,EAAG,QAAO;AACvB,QAAM,WAAW,KAAK,YAAA,MAAkB,IAAI,YAAA;AAC5C,SAAO,MAAM,KAAK,mBAAmB,SAAS;AAAA,IAC5C,OAAO;AAAA,IACP,KAAK;AAAA,IACL,GAAI,WAAW,CAAA,IAAK,EAAE,MAAM,UAAA;AAAA,EAAmB,CAChD,CAAC;AACJ;AASO,SAAS,yBAAyB;AAAA,EACvC;AAAA,EACA,0BAAU,KAAA;AACZ,GAGW;AACT,MAAI,MAAM,SAAS,YAAY;AAC7B,UAAM,OAAO,MAAM,gBAAgB,WAAW,EAAE,OAAO,MAAM,eAAe,IAAA,CAAK,IAAI;AACrF,WAAO,OAAO,8BAA8B,IAAI,KAAK;AAAA,EACvD;AACA,SAAO,GAAG,MAAM,KAAK,IAAI,YAAY,aAAa,KAAK,CAAC,CAAC;AAC3D;AAGA,SAAS,cAAc,UAA0B;AAC/C,MAAI,YAAY,EAAG,QAAO;AAC1B,SAAO,GAAG,QAAQ,IAAI,aAAa,IAAI,QAAQ,MAAM;AACvD;AAOO,SAAS,uBAAuB,OAA6C;AAClF,MAAI,MAAM,SAAS,YAAY;AAC7B,UAAMA,SAAQ;AAAA,MACZ,MAAM;AAAA,MACN,MAAM,aAAa,QAAQ,MAAM,WAAW,IAAI,cAAc,MAAM,QAAQ,IAAI;AAAA,IAAA,EAChF,OAAO,CAAC,SAAyB,SAAS,IAAI;AAChD,WAAOA,OAAM,SAAS,IAAIA,OAAM,KAAK,KAAK,IAAI;AAAA,EAChD;AACA,QAAM,QAAQ,MAAM,WAAW,MAAM,GAAG,gBAAgB;AACxD,QAAM,SAAS,MAAM,WAAW,SAAS,MAAM;AAC/C,QAAM,aACJ,MAAM,SAAS,IACX,iBAAiB,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,IAAI,QAAQ,MAAM,UAAU,EAAE,KAC3E;AACN,QAAM,QAAQ;AAAA,IACZ,MAAM;AAAA,IACN;AAAA,IACA,MAAM,aAAa,OAAO,cAAc,MAAM,QAAQ,IAAI;AAAA,IAC1D,MAAM,eAAe,QAAQ,MAAM,aAAa,IAAI,GAAG,MAAM,UAAU,YAAY;AAAA,EAAA,EACnF,OAAO,CAAC,SAAyB,SAAS,IAAI;AAChD,SAAO,MAAM,SAAS,IAAI,MAAM,KAAK,KAAK,IAAI;AAChD;"}

package/dist/agent-runtime/src/thread-extras.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-extras.cjs","sources":["../../../../agent-runtime/src/thread-extras.ts"],"sourcesContent":["/**\n * The statewire hooks read the NEAREST aui thread's extras and throw when those\n * aren't statewire extras — which is the case inside nested read-only runtimes\n * (e.g. a transcript drawer) and on legacy (non-statewire) threads. Duck-type\n * the pieces the statewire components actually consume; a wider shape check\n * would silently hide live affordances if the library ever drops an unrelated\n * field.\n */\nexport function hasStatewireThreadExtras(extras: unknown): boolean {\n  if (!extras || typeof extras !== 'object') return false;\n  const candidate = extras as Record<string, unknown>;\n  return (\n    typeof candidate.sendCommand === 'function' &&\n    Array.isArray(candidate.inputRequests) &&\n    typeof candidate.runs === 'object' &&\n    candidate.runs !== null\n  );\n}\n\nexport interface StatewireFailedActions {\n  retryFailed: (messageId: string) => void;\n  discardFailed: (messageId: string) => void;\n}\n\n/** One projected failed run send: the message id plus the failure that\n * retained it (`runs.failed` entry, structurally). */\nexport interface StatewireFailedSendEntry {\n  id: string;\n  sendFailure: {\n    fate: string;\n    /**\n     * Set on an `aborted` send that was never attempted because an earlier\n     * send in the same detach batch WAS attempted and settled `lost`: the\n     * library cannot know whether that predecessor ran, so the successor\n     * must not be re-dispatched ahead of it (`StatewireClient.SendFailure`).\n     */\n    predecessorLost?: boolean;\n  };\n}\n\n/** The failed-send lane surface the send-recovery controller consumes. */\nexport interface StatewireFailedSendLane {\n  failed: readonly StatewireFailedSendEntry[];\n  /** Re-dispatches the entry against the current thread — same message id,\n   * re-anchored — and removes it from the lane. Throws for unknown ids. */\n  retryFailed: (messageId: string) => void;\n}\n\nfunction isFailedSendEntry(value: unknown): value is StatewireFailedSendEntry {\n  if (!value || typeof value !== 'object') return false;\n  const entry = value as { id?: unknown; sendFailure?: { fate?: unknown } };\n  return typeof entry.id === 'string' && typeof entry.sendFailure?.fate === 'string';\n}\n\n/**\n * The failed-send lane off a statewire thread's extras, or `null` when the\n * extras are not a statewire thread's (nested read-only runtimes, legacy\n * threads) — same duck-typing posture as {@link hasStatewireThreadExtras}.\n */\nexport function readStatewireFailedSendLane(extras: unknown): StatewireFailedSendLane | null {\n  if (!extras || typeof extras !== 'object') return null;\n  const candidate = extras as {\n    runs?: { failed?: unknown };\n    retryFailed?: unknown;\n  };\n  const failed = candidate.runs?.failed;\n  if (!Array.isArray(failed) || typeof candidate.retryFailed !== 'function') return null;\n  return {\n    failed: failed.filter(isFailedSendEntry),\n    retryFailed: candidate.retryFailed as StatewireFailedSendLane['retryFailed'],\n  };\n}\n\n/** The failed-send lane actions off a statewire thread's extras, or throw. */\nexport function requireStatewireFailedActions(extras: unknown): StatewireFailedActions {\n  if (!extras || typeof extras !== 'object') {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  const candidate = extras as Record<string, unknown>;\n  if (\n    typeof candidate.retryFailed !== 'function' ||\n    typeof candidate.discardFailed !== 'function'\n  ) {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  return candidate as unknown as StatewireFailedActions;\n}\n"],"names":[],"mappings":";;AAQO,SAAS,yBAAyB,QAA0B;AACjE,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,gBAAgB,cACjC,MAAM,QAAQ,UAAU,aAAa,KACrC,OAAO,UAAU,SAAS,YAC1B,UAAU,SAAS;AAEvB;AA+BA,SAAS,kBAAkB,OAAmD;;AAC5E,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,QAAQ;AACd,SAAO,OAAO,MAAM,OAAO,YAAY,SAAO,WAAM,gBAAN,mBAAmB,UAAS;AAC5E;AAOO,SAAS,4BAA4B,QAAiD;;AAC3F,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAIlB,QAAM,UAAS,eAAU,SAAV,mBAAgB;AAC/B,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,UAAU,gBAAgB,WAAY,QAAO;AAClF,SAAO;AAAA,IACL,QAAQ,OAAO,OAAO,iBAAiB;AAAA,IACvC,aAAa,UAAU;AAAA,EAAA;AAE3B;AAGO,SAAS,8BAA8B,QAAyC;AACrF,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,QAAM,YAAY;AAClB,MACE,OAAO,UAAU,gBAAgB,cACjC,OAAO,UAAU,kBAAkB,YACnC;AACA,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,SAAO;AACT;;;;"}

package/dist/agent-runtime/src/thread-extras.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-extras.js","sources":["../../../../agent-runtime/src/thread-extras.ts"],"sourcesContent":["/**\n * The statewire hooks read the NEAREST aui thread's extras and throw when those\n * aren't statewire extras — which is the case inside nested read-only runtimes\n * (e.g. a transcript drawer) and on legacy (non-statewire) threads. Duck-type\n * the pieces the statewire components actually consume; a wider shape check\n * would silently hide live affordances if the library ever drops an unrelated\n * field.\n */\nexport function hasStatewireThreadExtras(extras: unknown): boolean {\n  if (!extras || typeof extras !== 'object') return false;\n  const candidate = extras as Record<string, unknown>;\n  return (\n    typeof candidate.sendCommand === 'function' &&\n    Array.isArray(candidate.inputRequests) &&\n    typeof candidate.runs === 'object' &&\n    candidate.runs !== null\n  );\n}\n\nexport interface StatewireFailedActions {\n  retryFailed: (messageId: string) => void;\n  discardFailed: (messageId: string) => void;\n}\n\n/** One projected failed run send: the message id plus the failure that\n * retained it (`runs.failed` entry, structurally). */\nexport interface StatewireFailedSendEntry {\n  id: string;\n  sendFailure: {\n    fate: string;\n    /**\n     * Set on an `aborted` send that was never attempted because an earlier\n     * send in the same detach batch WAS attempted and settled `lost`: the\n     * library cannot know whether that predecessor ran, so the successor\n     * must not be re-dispatched ahead of it (`StatewireClient.SendFailure`).\n     */\n    predecessorLost?: boolean;\n  };\n}\n\n/** The failed-send lane surface the send-recovery controller consumes. */\nexport interface StatewireFailedSendLane {\n  failed: readonly StatewireFailedSendEntry[];\n  /** Re-dispatches the entry against the current thread — same message id,\n   * re-anchored — and removes it from the lane. Throws for unknown ids. */\n  retryFailed: (messageId: string) => void;\n}\n\nfunction isFailedSendEntry(value: unknown): value is StatewireFailedSendEntry {\n  if (!value || typeof value !== 'object') return false;\n  const entry = value as { id?: unknown; sendFailure?: { fate?: unknown } };\n  return typeof entry.id === 'string' && typeof entry.sendFailure?.fate === 'string';\n}\n\n/**\n * The failed-send lane off a statewire thread's extras, or `null` when the\n * extras are not a statewire thread's (nested read-only runtimes, legacy\n * threads) — same duck-typing posture as {@link hasStatewireThreadExtras}.\n */\nexport function readStatewireFailedSendLane(extras: unknown): StatewireFailedSendLane | null {\n  if (!extras || typeof extras !== 'object') return null;\n  const candidate = extras as {\n    runs?: { failed?: unknown };\n    retryFailed?: unknown;\n  };\n  const failed = candidate.runs?.failed;\n  if (!Array.isArray(failed) || typeof candidate.retryFailed !== 'function') return null;\n  return {\n    failed: failed.filter(isFailedSendEntry),\n    retryFailed: candidate.retryFailed as StatewireFailedSendLane['retryFailed'],\n  };\n}\n\n/** The failed-send lane actions off a statewire thread's extras, or throw. */\nexport function requireStatewireFailedActions(extras: unknown): StatewireFailedActions {\n  if (!extras || typeof extras !== 'object') {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  const candidate = extras as Record<string, unknown>;\n  if (\n    typeof candidate.retryFailed !== 'function' ||\n    typeof candidate.discardFailed !== 'function'\n  ) {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  return candidate as unknown as StatewireFailedActions;\n}\n"],"names":[],"mappings":"AAQO,SAAS,yBAAyB,QAA0B;AACjE,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,gBAAgB,cACjC,MAAM,QAAQ,UAAU,aAAa,KACrC,OAAO,UAAU,SAAS,YAC1B,UAAU,SAAS;AAEvB;AA+BA,SAAS,kBAAkB,OAAmD;AAxCvE;AAyCL,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,QAAQ;AACd,SAAO,OAAO,MAAM,OAAO,YAAY,SAAO,WAAM,gBAAN,mBAAmB,UAAS;AAC5E;AAOO,SAAS,4BAA4B,QAAiD;AAnDtF;AAoDL,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAIlB,QAAM,UAAS,eAAU,SAAV,mBAAgB;AAC/B,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,UAAU,gBAAgB,WAAY,QAAO;AAClF,SAAO;AAAA,IACL,QAAQ,OAAO,OAAO,iBAAiB;AAAA,IACvC,aAAa,UAAU;AAAA,EAAA;AAE3B;AAGO,SAAS,8BAA8B,QAAyC;AACrF,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,QAAM,YAAY;AAClB,MACE,OAAO,UAAU,gBAAgB,cACjC,OAAO,UAAU,kBAAkB,YACnC;AACA,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,SAAO;AACT;"}

package/dist/agent-runtime/src/thread-snapshot-cache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-snapshot-cache.cjs","sources":["../../../../agent-runtime/src/thread-snapshot-cache.ts"],"sourcesContent":["import type { DeepAgentStreamValues } from './types';\n\n/**\n * Per-tab LRU of the last wire state seen per thread, so a switch back to a\n * recently-visited thread can mount with that snapshot instead of an empty\n * \"loading\" state (see `UseDeepAgentThreadOptions.snapshotCache`). Entries are\n * references into states the wire already produced — remembering is O(1) and\n * copies nothing; the bound is `maxThreads` retained states.\n */\nexport interface DeepAgentThreadSnapshotCache {\n  /** Record the latest hydrated wire state for a thread. */\n  remember(threadId: string, state: DeepAgentStreamValues): void;\n  /** The freshest remembered state for a thread, or `undefined` when none is\n   * held or the entry aged out. */\n  take(threadId: string): DeepAgentStreamValues | undefined;\n  /**\n   * Drop a single thread's entry. Called when the server refuses\n   * authorization for the thread — a refused thread must not warm-paint on\n   * its next mount.\n   */\n  forget(threadId: string): void;\n  /**\n   * Drop every entry. Called when the acting identity changes — a snapshot\n   * captured under one account must never seed a mount under another.\n   */\n  clear(): void;\n  /**\n   * Whether a fresh entry is held for the thread, without consuming or\n   * touching it. Hosts read it at selection time to decide whether the switch\n   * can paint from a seed (no loading treatment) or must cover the attach\n   * wait. Optional so hand-rolled caches keep type-checking; the built-in\n   * cache implements it.\n   */\n  peek?(threadId: string): boolean;\n}\n\n/** A write observed on the cache — the durable-mirror seam (see `onChange`). */\nexport type DeepAgentThreadSnapshotCacheChange =\n  | { type: 'remember'; threadId: string; state: DeepAgentStreamValues; at: number }\n  | { type: 'forget'; threadId: string }\n  | { type: 'clear' };\n\nexport interface DeepAgentThreadSnapshotCacheOptions {\n  /** Threads retained; the least-recently written entry evicts beyond this. */\n  maxThreads?: number;\n  /**\n   * Entries older than this are dropped at read time. The seed's value is\n   * \"the thread you just left\" — a snapshot from long ago is more likely to\n   * flash content the server has since rewritten than to save a paint.\n   */\n  maxAgeMs?: number;\n  /**\n   * Observer of every write (`remember`, `forget`, `clear`). Hosts mirror\n   * entries into durable storage from here so a reload can seed too; the\n   * observer is never invoked for `restore`, which re-admits mirrored entries.\n   * Exceptions are swallowed — a mirror fault must not break the wire path.\n   */\n  onChange?: (change: DeepAgentThreadSnapshotCacheChange) => void;\n  /** Injectable clock (tests). */\n  now?: () => number;\n}\n\n/** The built-in cache: the host contract plus the durable-mirror re-admission. */\nexport interface CreatedDeepAgentThreadSnapshotCache extends DeepAgentThreadSnapshotCache {\n  peek(threadId: string): boolean;\n  /**\n   * Re-admit an entry captured earlier — a mirrored snapshot after a reload —\n   * under its ORIGINAL capture time, so the age bound still applies. Never\n   * displaces a fresher in-memory entry and never notifies `onChange`.\n   */\n  restore(threadId: string, state: DeepAgentStreamValues, at: number): void;\n}\n\nconst DEFAULT_MAX_THREADS = 30;\nconst DEFAULT_MAX_AGE_MS = 60 * 60 * 1000;\n\nexport function createDeepAgentThreadSnapshotCache(\n  options: DeepAgentThreadSnapshotCacheOptions = {}\n): CreatedDeepAgentThreadSnapshotCache {\n  const maxThreads = options.maxThreads ?? DEFAULT_MAX_THREADS;\n  const maxAgeMs = options.maxAgeMs ?? DEFAULT_MAX_AGE_MS;\n  const now = options.now ?? (() => Date.now());\n  const notify = (change: DeepAgentThreadSnapshotCacheChange): void => {\n    try {\n      options.onChange?.(change);\n    } catch {\n      // The mirror is best-effort; the in-memory cache stays authoritative.\n    }\n  };\n  // Map iteration order is insertion order; delete-then-set on every write\n  // keeps the first key the least-recently written.\n  const entries = new Map<string, { state: DeepAgentStreamValues; at: number }>();\n  const evict = (): void => {\n    while (entries.size > maxThreads) {\n      const oldest = entries.keys().next().value;\n      if (oldest === undefined) break;\n      entries.delete(oldest);\n    }\n  };\n  const fresh = (threadId: string): { state: DeepAgentStreamValues; at: number } | undefined => {\n    const entry = entries.get(threadId);\n    if (!entry) return undefined;\n    if (now() - entry.at > maxAgeMs) {\n      entries.delete(threadId);\n      return undefined;\n    }\n    return entry;\n  };\n  return {\n    remember(threadId, state) {\n      const at = now();\n      entries.delete(threadId);\n      entries.set(threadId, { state, at });\n      evict();\n      notify({ type: 'remember', threadId, state, at });\n    },\n    take(threadId) {\n      return fresh(threadId)?.state;\n    },\n    peek(threadId) {\n      return fresh(threadId) !== undefined;\n    },\n    restore(threadId, state, at) {\n      if (now() - at > maxAgeMs) return;\n      const existing = entries.get(threadId);\n      if (existing && existing.at >= at) return;\n      entries.delete(threadId);\n      entries.set(threadId, { state, at });\n      evict();\n    },\n    forget(threadId) {\n      entries.delete(threadId);\n      notify({ type: 'forget', threadId });\n    },\n    clear() {\n      entries.clear();\n      notify({ type: 'clear' });\n    },\n  };\n}\n\n/**\n * Shape a remembered wire state for use as a mount's `initialState`.\n *\n * Messages/todos and the other app-owned keys seed as captured. The run lane\n * seeds by what the user left: a thread whose run was `running` when the\n * snapshot was taken seeds a running entry (see {@link seedRunsLane}) so the\n * switch back reads Running with a Stop control on its first frame — the same\n * frame `runs: []` would render as \"ready\" with a Send button over a thread the\n * server is still mid-run on. Every other live-lifecycle lane normalizes to\n * resting: a seeded input request could collect a decision the server may have\n * already resolved, so an `input-required` entry seeds as no run at all.\n * `__interrupt__` is dropped for the same reason, and so are `ptc_subagents`\n * (the live in-eval dispatch lane — a seeded \"running\" dispatch card under a\n * resting thread would render active with no eval behind it) and\n * `outOfBandRunActive` (the host's out-of-band-run-in-progress flag — seeding a\n * finished run's `true` would hide the composer until the attach corrected\n * it). Durable thread properties (`runConfig`, `sessionPersisted`, …) seed as\n * captured; the attach snapshot then replaces the whole seed.\n */\nexport function toThreadSnapshotSeed(state: DeepAgentStreamValues): DeepAgentStreamValues {\n  const {\n    __interrupt__: _interrupt,\n    ptc_subagents: _ptcSubagents,\n    outOfBandRunActive: _outOfBandRunActive,\n    ...rest\n  } = state;\n  return { ...rest, runs: seedRunsLane(state.runs) };\n}\n\n/**\n * The run entries a seed carries.\n *\n * Only a `running` entry survives, and only its replicated identity and its\n * durable lanes: `runId` (the target of a Stop sent during the attach\n * round-trip — the live run's id if it is still running, and a refused stop\n * if it finished meanwhile), `epoch` (rides that Stop so a replayed stop cannot\n * end a later leg) and the `queue`/`steerQueue` entries (server lanes the tray\n * renders). The in-flight records rest until the snapshot: `dispatching` and\n * `nextDispatch` are batches the materializer would re-apply onto messages\n * that already contain them, `stopping` is a rewind the host may have\n * finished, `inputRequests` is a parked decision, and `error` is a failure the\n * next user run clears. An entry in any other status — `stopped`, `error`,\n * `input-required` — seeds as no run.\n */\nfunction seedRunsLane(\n  runs: DeepAgentStreamValues['runs']\n): NonNullable<DeepAgentStreamValues['runs']> {\n  const live = runs?.[0];\n  if (live === undefined || live.status !== 'running') return [];\n  return [\n    {\n      runId: live.runId,\n      status: 'running',\n      queue: live.queue,\n      steerQueue: live.steerQueue,\n      ...(live.epoch !== undefined && { epoch: live.epoch }),\n    },\n  ];\n}\n"],"names":[],"mappings":";;AAyEA,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB,KAAK,KAAK;AAE9B,SAAS,mCACd,UAA+C,IACV;AACrC,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,WAAW,QAAQ,YAAY;AACrC,QAAM,MAAM,QAAQ,QAAQ,MAAM,KAAK,IAAA;AACvC,QAAM,SAAS,CAAC,WAAqD;;AACnE,QAAI;AACF,oBAAQ,aAAR,iCAAmB;AAAA,IACrB,QAAQ;AAAA,IAER;AAAA,EACF;AAGA,QAAM,8BAAc,IAAA;AACpB,QAAM,QAAQ,MAAY;AACxB,WAAO,QAAQ,OAAO,YAAY;AAChC,YAAM,SAAS,QAAQ,KAAA,EAAO,OAAO;AACrC,UAAI,WAAW,OAAW;AAC1B,cAAQ,OAAO,MAAM;AAAA,IACvB;AAAA,EACF;AACA,QAAM,QAAQ,CAAC,aAA+E;AAC5F,UAAM,QAAQ,QAAQ,IAAI,QAAQ;AAClC,QAAI,CAAC,MAAO,QAAO;AACnB,QAAI,IAAA,IAAQ,MAAM,KAAK,UAAU;AAC/B,cAAQ,OAAO,QAAQ;AACvB,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,SAAS,UAAU,OAAO;AACxB,YAAM,KAAK,IAAA;AACX,cAAQ,OAAO,QAAQ;AACvB,cAAQ,IAAI,UAAU,EAAE,OAAO,IAAI;AACnC,YAAA;AACA,aAAO,EAAE,MAAM,YAAY,UAAU,OAAO,IAAI;AAAA,IAClD;AAAA,IACA,KAAK,UAAU;;AACb,cAAO,WAAM,QAAQ,MAAd,mBAAiB;AAAA,IAC1B;AAAA,IACA,KAAK,UAAU;AACb,aAAO,MAAM,QAAQ,MAAM;AAAA,IAC7B;AAAA,IACA,QAAQ,UAAU,OAAO,IAAI;AAC3B,UAAI,IAAA,IAAQ,KAAK,SAAU;AAC3B,YAAM,WAAW,QAAQ,IAAI,QAAQ;AACrC,UAAI,YAAY,SAAS,MAAM,GAAI;AACnC,cAAQ,OAAO,QAAQ;AACvB,cAAQ,IAAI,UAAU,EAAE,OAAO,IAAI;AACnC,YAAA;AAAA,IACF;AAAA,IACA,OAAO,UAAU;AACf,cAAQ,OAAO,QAAQ;AACvB,aAAO,EAAE,MAAM,UAAU,SAAA,CAAU;AAAA,IACrC;AAAA,IACA,QAAQ;AACN,cAAQ,MAAA;AACR,aAAO,EAAE,MAAM,SAAS;AAAA,IAC1B;AAAA,EAAA;AAEJ;AAqBO,SAAS,qBAAqB,OAAqD;AACxF,QAAM;AAAA,IACJ,eAAe;AAAA,IACf,eAAe;AAAA,IACf,oBAAoB;AAAA,IACpB,GAAG;AAAA,EAAA,IACD;AACJ,SAAO,EAAE,GAAG,MAAM,MAAM,aAAa,MAAM,IAAI,EAAA;AACjD;AAiBA,SAAS,aACP,MAC4C;AAC5C,QAAM,OAAO,6BAAO;AACpB,MAAI,SAAS,UAAa,KAAK,WAAW,kBAAkB,CAAA;AAC5D,SAAO;AAAA,IACL;AAAA,MACE,OAAO,KAAK;AAAA,MACZ,QAAQ;AAAA,MACR,OAAO,KAAK;AAAA,MACZ,YAAY,KAAK;AAAA,MACjB,GAAI,KAAK,UAAU,UAAa,EAAE,OAAO,KAAK,MAAA;AAAA,IAAM;AAAA,EACtD;AAEJ;;;"}

package/dist/agent-runtime/src/thread-snapshot-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-snapshot-cache.js","sources":["../../../../agent-runtime/src/thread-snapshot-cache.ts"],"sourcesContent":["import type { DeepAgentStreamValues } from './types';\n\n/**\n * Per-tab LRU of the last wire state seen per thread, so a switch back to a\n * recently-visited thread can mount with that snapshot instead of an empty\n * \"loading\" state (see `UseDeepAgentThreadOptions.snapshotCache`). Entries are\n * references into states the wire already produced — remembering is O(1) and\n * copies nothing; the bound is `maxThreads` retained states.\n */\nexport interface DeepAgentThreadSnapshotCache {\n  /** Record the latest hydrated wire state for a thread. */\n  remember(threadId: string, state: DeepAgentStreamValues): void;\n  /** The freshest remembered state for a thread, or `undefined` when none is\n   * held or the entry aged out. */\n  take(threadId: string): DeepAgentStreamValues | undefined;\n  /**\n   * Drop a single thread's entry. Called when the server refuses\n   * authorization for the thread — a refused thread must not warm-paint on\n   * its next mount.\n   */\n  forget(threadId: string): void;\n  /**\n   * Drop every entry. Called when the acting identity changes — a snapshot\n   * captured under one account must never seed a mount under another.\n   */\n  clear(): void;\n  /**\n   * Whether a fresh entry is held for the thread, without consuming or\n   * touching it. Hosts read it at selection time to decide whether the switch\n   * can paint from a seed (no loading treatment) or must cover the attach\n   * wait. Optional so hand-rolled caches keep type-checking; the built-in\n   * cache implements it.\n   */\n  peek?(threadId: string): boolean;\n}\n\n/** A write observed on the cache — the durable-mirror seam (see `onChange`). */\nexport type DeepAgentThreadSnapshotCacheChange =\n  | { type: 'remember'; threadId: string; state: DeepAgentStreamValues; at: number }\n  | { type: 'forget'; threadId: string }\n  | { type: 'clear' };\n\nexport interface DeepAgentThreadSnapshotCacheOptions {\n  /** Threads retained; the least-recently written entry evicts beyond this. */\n  maxThreads?: number;\n  /**\n   * Entries older than this are dropped at read time. The seed's value is\n   * \"the thread you just left\" — a snapshot from long ago is more likely to\n   * flash content the server has since rewritten than to save a paint.\n   */\n  maxAgeMs?: number;\n  /**\n   * Observer of every write (`remember`, `forget`, `clear`). Hosts mirror\n   * entries into durable storage from here so a reload can seed too; the\n   * observer is never invoked for `restore`, which re-admits mirrored entries.\n   * Exceptions are swallowed — a mirror fault must not break the wire path.\n   */\n  onChange?: (change: DeepAgentThreadSnapshotCacheChange) => void;\n  /** Injectable clock (tests). */\n  now?: () => number;\n}\n\n/** The built-in cache: the host contract plus the durable-mirror re-admission. */\nexport interface CreatedDeepAgentThreadSnapshotCache extends DeepAgentThreadSnapshotCache {\n  peek(threadId: string): boolean;\n  /**\n   * Re-admit an entry captured earlier — a mirrored snapshot after a reload —\n   * under its ORIGINAL capture time, so the age bound still applies. Never\n   * displaces a fresher in-memory entry and never notifies `onChange`.\n   */\n  restore(threadId: string, state: DeepAgentStreamValues, at: number): void;\n}\n\nconst DEFAULT_MAX_THREADS = 30;\nconst DEFAULT_MAX_AGE_MS = 60 * 60 * 1000;\n\nexport function createDeepAgentThreadSnapshotCache(\n  options: DeepAgentThreadSnapshotCacheOptions = {}\n): CreatedDeepAgentThreadSnapshotCache {\n  const maxThreads = options.maxThreads ?? DEFAULT_MAX_THREADS;\n  const maxAgeMs = options.maxAgeMs ?? DEFAULT_MAX_AGE_MS;\n  const now = options.now ?? (() => Date.now());\n  const notify = (change: DeepAgentThreadSnapshotCacheChange): void => {\n    try {\n      options.onChange?.(change);\n    } catch {\n      // The mirror is best-effort; the in-memory cache stays authoritative.\n    }\n  };\n  // Map iteration order is insertion order; delete-then-set on every write\n  // keeps the first key the least-recently written.\n  const entries = new Map<string, { state: DeepAgentStreamValues; at: number }>();\n  const evict = (): void => {\n    while (entries.size > maxThreads) {\n      const oldest = entries.keys().next().value;\n      if (oldest === undefined) break;\n      entries.delete(oldest);\n    }\n  };\n  const fresh = (threadId: string): { state: DeepAgentStreamValues; at: number } | undefined => {\n    const entry = entries.get(threadId);\n    if (!entry) return undefined;\n    if (now() - entry.at > maxAgeMs) {\n      entries.delete(threadId);\n      return undefined;\n    }\n    return entry;\n  };\n  return {\n    remember(threadId, state) {\n      const at = now();\n      entries.delete(threadId);\n      entries.set(threadId, { state, at });\n      evict();\n      notify({ type: 'remember', threadId, state, at });\n    },\n    take(threadId) {\n      return fresh(threadId)?.state;\n    },\n    peek(threadId) {\n      return fresh(threadId) !== undefined;\n    },\n    restore(threadId, state, at) {\n      if (now() - at > maxAgeMs) return;\n      const existing = entries.get(threadId);\n      if (existing && existing.at >= at) return;\n      entries.delete(threadId);\n      entries.set(threadId, { state, at });\n      evict();\n    },\n    forget(threadId) {\n      entries.delete(threadId);\n      notify({ type: 'forget', threadId });\n    },\n    clear() {\n      entries.clear();\n      notify({ type: 'clear' });\n    },\n  };\n}\n\n/**\n * Shape a remembered wire state for use as a mount's `initialState`.\n *\n * Messages/todos and the other app-owned keys seed as captured. The run lane\n * seeds by what the user left: a thread whose run was `running` when the\n * snapshot was taken seeds a running entry (see {@link seedRunsLane}) so the\n * switch back reads Running with a Stop control on its first frame — the same\n * frame `runs: []` would render as \"ready\" with a Send button over a thread the\n * server is still mid-run on. Every other live-lifecycle lane normalizes to\n * resting: a seeded input request could collect a decision the server may have\n * already resolved, so an `input-required` entry seeds as no run at all.\n * `__interrupt__` is dropped for the same reason, and so are `ptc_subagents`\n * (the live in-eval dispatch lane — a seeded \"running\" dispatch card under a\n * resting thread would render active with no eval behind it) and\n * `outOfBandRunActive` (the host's out-of-band-run-in-progress flag — seeding a\n * finished run's `true` would hide the composer until the attach corrected\n * it). Durable thread properties (`runConfig`, `sessionPersisted`, …) seed as\n * captured; the attach snapshot then replaces the whole seed.\n */\nexport function toThreadSnapshotSeed(state: DeepAgentStreamValues): DeepAgentStreamValues {\n  const {\n    __interrupt__: _interrupt,\n    ptc_subagents: _ptcSubagents,\n    outOfBandRunActive: _outOfBandRunActive,\n    ...rest\n  } = state;\n  return { ...rest, runs: seedRunsLane(state.runs) };\n}\n\n/**\n * The run entries a seed carries.\n *\n * Only a `running` entry survives, and only its replicated identity and its\n * durable lanes: `runId` (the target of a Stop sent during the attach\n * round-trip — the live run's id if it is still running, and a refused stop\n * if it finished meanwhile), `epoch` (rides that Stop so a replayed stop cannot\n * end a later leg) and the `queue`/`steerQueue` entries (server lanes the tray\n * renders). The in-flight records rest until the snapshot: `dispatching` and\n * `nextDispatch` are batches the materializer would re-apply onto messages\n * that already contain them, `stopping` is a rewind the host may have\n * finished, `inputRequests` is a parked decision, and `error` is a failure the\n * next user run clears. An entry in any other status — `stopped`, `error`,\n * `input-required` — seeds as no run.\n */\nfunction seedRunsLane(\n  runs: DeepAgentStreamValues['runs']\n): NonNullable<DeepAgentStreamValues['runs']> {\n  const live = runs?.[0];\n  if (live === undefined || live.status !== 'running') return [];\n  return [\n    {\n      runId: live.runId,\n      status: 'running',\n      queue: live.queue,\n      steerQueue: live.steerQueue,\n      ...(live.epoch !== undefined && { epoch: live.epoch }),\n    },\n  ];\n}\n"],"names":[],"mappings":"AAyEA,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB,KAAK,KAAK;AAE9B,SAAS,mCACd,UAA+C,IACV;AACrC,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,WAAW,QAAQ,YAAY;AACrC,QAAM,MAAM,QAAQ,QAAQ,MAAM,KAAK,IAAA;AACvC,QAAM,SAAS,CAAC,WAAqD;AATvE;AAUI,QAAI;AACF,oBAAQ,aAAR,iCAAmB;AAAA,IACrB,QAAQ;AAAA,IAER;AAAA,EACF;AAGA,QAAM,8BAAc,IAAA;AACpB,QAAM,QAAQ,MAAY;AACxB,WAAO,QAAQ,OAAO,YAAY;AAChC,YAAM,SAAS,QAAQ,KAAA,EAAO,OAAO;AACrC,UAAI,WAAW,OAAW;AAC1B,cAAQ,OAAO,MAAM;AAAA,IACvB;AAAA,EACF;AACA,QAAM,QAAQ,CAAC,aAA+E;AAC5F,UAAM,QAAQ,QAAQ,IAAI,QAAQ;AAClC,QAAI,CAAC,MAAO,QAAO;AACnB,QAAI,IAAA,IAAQ,MAAM,KAAK,UAAU;AAC/B,cAAQ,OAAO,QAAQ;AACvB,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,SAAS,UAAU,OAAO;AACxB,YAAM,KAAK,IAAA;AACX,cAAQ,OAAO,QAAQ;AACvB,cAAQ,IAAI,UAAU,EAAE,OAAO,IAAI;AACnC,YAAA;AACA,aAAO,EAAE,MAAM,YAAY,UAAU,OAAO,IAAI;AAAA,IAClD;AAAA,IACA,KAAK,UAAU;AA3CnB;AA4CM,cAAO,WAAM,QAAQ,MAAd,mBAAiB;AAAA,IAC1B;AAAA,IACA,KAAK,UAAU;AACb,aAAO,MAAM,QAAQ,MAAM;AAAA,IAC7B;AAAA,IACA,QAAQ,UAAU,OAAO,IAAI;AAC3B,UAAI,IAAA,IAAQ,KAAK,SAAU;AAC3B,YAAM,WAAW,QAAQ,IAAI,QAAQ;AACrC,UAAI,YAAY,SAAS,MAAM,GAAI;AACnC,cAAQ,OAAO,QAAQ;AACvB,cAAQ,IAAI,UAAU,EAAE,OAAO,IAAI;AACnC,YAAA;AAAA,IACF;AAAA,IACA,OAAO,UAAU;AACf,cAAQ,OAAO,QAAQ;AACvB,aAAO,EAAE,MAAM,UAAU,SAAA,CAAU;AAAA,IACrC;AAAA,IACA,QAAQ;AACN,cAAQ,MAAA;AACR,aAAO,EAAE,MAAM,SAAS;AAAA,IAC1B;AAAA,EAAA;AAEJ;AAqBO,SAAS,qBAAqB,OAAqD;AACxF,QAAM;AAAA,IACJ,eAAe;AAAA,IACf,eAAe;AAAA,IACf,oBAAoB;AAAA,IACpB,GAAG;AAAA,EAAA,IACD;AACJ,SAAO,EAAE,GAAG,MAAM,MAAM,aAAa,MAAM,IAAI,EAAA;AACjD;AAiBA,SAAS,aACP,MAC4C;AAC5C,QAAM,OAAO,6BAAO;AACpB,MAAI,SAAS,UAAa,KAAK,WAAW,kBAAkB,CAAA;AAC5D,SAAO;AAAA,IACL;AAAA,MACE,OAAO,KAAK;AAAA,MACZ,QAAQ;AAAA,MACR,OAAO,KAAK;AAAA,MACZ,YAAY,KAAK;AAAA,MACjB,GAAI,KAAK,UAAU,UAAa,EAAE,OAAO,KAAK,MAAA;AAAA,IAAM;AAAA,EACtD;AAEJ;"}

package/dist/agent-runtime/src/thread-status.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-status.cjs","sources":["../../../../agent-runtime/src/thread-status.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { createContext, useContext } from 'react';\nimport type { DeepAgentConnectionState } from './types';\n\nexport type DeepAgentThreadStatus = StatewireThread.ThreadStatus;\n\n/**\n * Runtime-scoped thread status, as the library presents it: `\"loading\"` /\n * `\"ready\"` / the run's status replicated by the host, with a mid-run\n * connection loss presented as `\"evicted\"` (server-update pod drain) or\n * `\"disconnected\"` instead of `\"running\"`. Throws outside a statewire aui\n * provider, matching react-statewire 0.13's removed `useStatewireThreadStatus`.\n */\nexport function useDeepAgentThreadStatus(): DeepAgentThreadStatus {\n  return useAuiState((s) => {\n    const status = (s.thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n    if (status === undefined) {\n      throw new Error('useDeepAgentThreadStatus requires a statewire thread');\n    }\n    return status;\n  });\n}\n\n/** The two presented statuses that hide a live run behind a channel problem. */\nexport type DeepAgentStaleRunReason = Extract<DeepAgentThreadStatus, 'disconnected' | 'evicted'>;\n\n/** A first connection attempt can present an optimistic run without a stale warning. */\nexport function resolveStaleRunReason({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): DeepAgentStaleRunReason | null {\n  if (status === 'evicted') return 'evicted';\n  if (status !== 'disconnected') return null;\n  if (connection?.status === 'connecting') {\n    return null;\n  }\n  return 'disconnected';\n}\n\n/**\n * Whether the thread has a live run to present — the composer's Running bar\n * and its Stop/Queue slot.\n *\n * The library derives `thread.isRunning` from the PRESENTED status, so a run\n * that is live on the host but sits behind a channel that has not connected\n * yet reads as not running. Behind a first dial that is exactly the run the\n * client just seeded — switching back to a thread that was running when you\n * left, or a brand-new chat's optimistic first send — and nothing is stale:\n * the channel is still attaching. Hiding the run for that round-trip flashes\n * Ready and a Send button before Running comes back. A run behind a reconnect\n * or an eviction is presented by the stale treatment (`resolveStaleRunReason`),\n * never as live.\n */\nexport function resolveRunLive({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): boolean {\n  if (status === 'running') return true;\n  if (status !== 'disconnected') return false;\n  return resolveStaleRunReason({ status, connection }) === null;\n}\n\n/**\n * `thread.isRunning` for a `useAuiState` selector, folded through\n * `resolveRunLive` when the thread is a statewire thread. A thread without a\n * statewire status (another runtime, a test stub) keeps the library's answer.\n */\nexport function readRunLive(\n  thread: { isRunning: boolean; extras?: unknown },\n  connection: DeepAgentConnectionState | null,\n): boolean {\n  const status = (thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n  return status === undefined ? thread.isRunning : resolveRunLive({ status, connection });\n}\n\n/**\n * The active thread's channel, for `readRunLive`'s first-dial verdict. Each\n * host provides it from its own lifecycle state (`AthenaProvider`, the\n * Chrome extension's lifecycle provider); `null` means \"no channel known\",\n * which folds a `disconnected` status as stale.\n */\nexport const DeepAgentConnectionContext = createContext<DeepAgentConnectionState | null>(null);\n\nexport function useDeepAgentConnection(): DeepAgentConnectionState | null {\n  return useContext(DeepAgentConnectionContext);\n}\n"],"names":["useAuiState","createContext","useContext"],"mappings":";;;;AAcO,SAAS,2BAAkD;AAChE,SAAOA,MAAAA,YAAY,CAAC,MAAM;;AACxB,UAAM,UAAU,OAAE,OAAO,WAAT,mBAAiE;AACjF,QAAI,WAAW,QAAW;AACxB,YAAM,IAAI,MAAM,sDAAsD;AAAA,IACxE;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAMO,SAAS,sBAAsB;AAAA,EACpC;AAAA,EACA;AACF,GAGmC;AACjC,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,OAAI,yCAAY,YAAW,cAAc;AACvC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAgBO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AACF,GAGY;AACV,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,SAAO,sBAAsB,EAAE,QAAQ,WAAA,CAAY,MAAM;AAC3D;AAOO,SAAS,YACd,QACA,YACS;;AACT,QAAM,UAAU,YAAO,WAAP,mBAA+D;AAC/E,SAAO,WAAW,SAAY,OAAO,YAAY,eAAe,EAAE,QAAQ,YAAY;AACxF;AAQO,MAAM,6BAA6BC,MAAAA,cAA+C,IAAI;AAEtF,SAAS,yBAA0D;AACxE,SAAOC,MAAAA,WAAW,0BAA0B;AAC9C;;;;;;;"}

package/dist/agent-runtime/src/thread-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-status.js","sources":["../../../../agent-runtime/src/thread-status.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { createContext, useContext } from 'react';\nimport type { DeepAgentConnectionState } from './types';\n\nexport type DeepAgentThreadStatus = StatewireThread.ThreadStatus;\n\n/**\n * Runtime-scoped thread status, as the library presents it: `\"loading\"` /\n * `\"ready\"` / the run's status replicated by the host, with a mid-run\n * connection loss presented as `\"evicted\"` (server-update pod drain) or\n * `\"disconnected\"` instead of `\"running\"`. Throws outside a statewire aui\n * provider, matching react-statewire 0.13's removed `useStatewireThreadStatus`.\n */\nexport function useDeepAgentThreadStatus(): DeepAgentThreadStatus {\n  return useAuiState((s) => {\n    const status = (s.thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n    if (status === undefined) {\n      throw new Error('useDeepAgentThreadStatus requires a statewire thread');\n    }\n    return status;\n  });\n}\n\n/** The two presented statuses that hide a live run behind a channel problem. */\nexport type DeepAgentStaleRunReason = Extract<DeepAgentThreadStatus, 'disconnected' | 'evicted'>;\n\n/** A first connection attempt can present an optimistic run without a stale warning. */\nexport function resolveStaleRunReason({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): DeepAgentStaleRunReason | null {\n  if (status === 'evicted') return 'evicted';\n  if (status !== 'disconnected') return null;\n  if (connection?.status === 'connecting') {\n    return null;\n  }\n  return 'disconnected';\n}\n\n/**\n * Whether the thread has a live run to present — the composer's Running bar\n * and its Stop/Queue slot.\n *\n * The library derives `thread.isRunning` from the PRESENTED status, so a run\n * that is live on the host but sits behind a channel that has not connected\n * yet reads as not running. Behind a first dial that is exactly the run the\n * client just seeded — switching back to a thread that was running when you\n * left, or a brand-new chat's optimistic first send — and nothing is stale:\n * the channel is still attaching. Hiding the run for that round-trip flashes\n * Ready and a Send button before Running comes back. A run behind a reconnect\n * or an eviction is presented by the stale treatment (`resolveStaleRunReason`),\n * never as live.\n */\nexport function resolveRunLive({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): boolean {\n  if (status === 'running') return true;\n  if (status !== 'disconnected') return false;\n  return resolveStaleRunReason({ status, connection }) === null;\n}\n\n/**\n * `thread.isRunning` for a `useAuiState` selector, folded through\n * `resolveRunLive` when the thread is a statewire thread. A thread without a\n * statewire status (another runtime, a test stub) keeps the library's answer.\n */\nexport function readRunLive(\n  thread: { isRunning: boolean; extras?: unknown },\n  connection: DeepAgentConnectionState | null,\n): boolean {\n  const status = (thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n  return status === undefined ? thread.isRunning : resolveRunLive({ status, connection });\n}\n\n/**\n * The active thread's channel, for `readRunLive`'s first-dial verdict. Each\n * host provides it from its own lifecycle state (`AthenaProvider`, the\n * Chrome extension's lifecycle provider); `null` means \"no channel known\",\n * which folds a `disconnected` status as stale.\n */\nexport const DeepAgentConnectionContext = createContext<DeepAgentConnectionState | null>(null);\n\nexport function useDeepAgentConnection(): DeepAgentConnectionState | null {\n  return useContext(DeepAgentConnectionContext);\n}\n"],"names":[],"mappings":";;AAcO,SAAS,2BAAkD;AAChE,SAAO,YAAY,CAAC,MAAM;;AACxB,UAAM,UAAU,OAAE,OAAO,WAAT,mBAAiE;AACjF,QAAI,WAAW,QAAW;AACxB,YAAM,IAAI,MAAM,sDAAsD;AAAA,IACxE;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAMO,SAAS,sBAAsB;AAAA,EACpC;AAAA,EACA;AACF,GAGmC;AACjC,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,OAAI,yCAAY,YAAW,cAAc;AACvC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAgBO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AACF,GAGY;AACV,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,SAAO,sBAAsB,EAAE,QAAQ,WAAA,CAAY,MAAM;AAC3D;AAOO,SAAS,YACd,QACA,YACS;;AACT,QAAM,UAAU,YAAO,WAAP,mBAA+D;AAC/E,SAAO,WAAW,SAAY,OAAO,YAAY,eAAe,EAAE,QAAQ,YAAY;AACxF;AAQO,MAAM,6BAA6B,cAA+C,IAAI;AAEtF,SAAS,yBAA0D;AACxE,SAAO,WAAW,0BAA0B;AAC9C;"}