@athenaintel/react 0.57.1 → 0.59.0

package/dist/agent-runtime/src/chat-outbox-legacy.js

@@ -0,0 +1,252 @@
+import { LEGACY_CHAT_OUTBOX_SOURCE, readFiles, readAttachments, readChatOutboxLocalMeta, runSendMessage, CHAT_OUTBOX_LOCAL_META_KIND } from "./chat-outbox-entry.js";
+import { requestToPromise, transactionDone, sha256Hex, idbGlobals, lazySealedDatabase, openJson } from "./sealed-idb.js";
+import { DEEP_AGENT_STATEWIRE_PROTOCOL } from "./statewire-transport.js";
+const LEGACY_CHAT_OUTBOX_DATABASE = LEGACY_CHAT_OUTBOX_SOURCE;
+const LEGACY_FORMAT = 1;
+const DATABASE_VERSION = 1;
+const ENTRIES_STORE = "entries";
+const BY_OWNER = "byOwner";
+const BY_OWNER_THREAD = "byOwnerThread";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readLegacyChatOutboxFailure(value) {
+  if (!isRecord(value) || typeof value.at !== "number") return void 0;
+  return { reason: typeof value.reason === "string" && value.reason.length > 0 ? value.reason : "error", at: value.at };
+}
+function parseLegacyChatOutboxMessage(value) {
+  if (!isRecord(value)) return null;
+  const { id, threadId, text, queuedAt } = value;
+  if (typeof id !== "string" || typeof threadId !== "string" || typeof text !== "string") return null;
+  if (typeof queuedAt !== "number" || !Number.isFinite(queuedAt)) return null;
+  const files = readFiles(value.files);
+  const attachments = readAttachments(value.attachments);
+  return {
+    id,
+    threadId,
+    text,
+    queuedAt,
+    newChat: value.newChat === true,
+    ...typeof value.composerMarkdown === "string" && { composerMarkdown: value.composerMarkdown },
+    ...typeof value.composerHtml === "string" && { composerHtml: value.composerHtml },
+    ...isRecord(value.metadata) && { metadata: value.metadata },
+    ...isRecord(value.sendContext) && { sendContext: value.sendContext },
+    ...files && { files },
+    ...attachments && { attachments }
+  };
+}
+function withFailure(message, value) {
+  const failure = readLegacyChatOutboxFailure(value);
+  return failure ? { ...message, failure } : message;
+}
+function upgrade(db) {
+  if (!db.objectStoreNames.contains(ENTRIES_STORE)) {
+    const store = db.createObjectStore(ENTRIES_STORE, { keyPath: "key" });
+    store.createIndex(BY_OWNER, "owner", { unique: false });
+    store.createIndex(BY_OWNER_THREAD, ["owner", "thread"], { unique: false });
+  }
+}
+function createLegacyChatOutboxReader({
+  ownerId,
+  getKey,
+  factory = idbGlobals.indexedDB,
+  databaseName = LEGACY_CHAT_OUTBOX_DATABASE
+}) {
+  const database = lazySealedDatabase({ factory, name: databaseName, version: DATABASE_VERSION, upgrade });
+  const ownerHash = () => sha256Hex(ownerId);
+  const recordKey = (threadId, id) => sha256Hex(`${ownerId}|${threadId}|${id}`);
+  const aadOf = (record) => `athena-chat-outbox|${LEGACY_FORMAT}|${record.owner}|${record.thread}|${record.key}`;
+  const open = async (records) => {
+    if (records.length === 0) return [];
+    let key = null;
+    try {
+      key = await getKey();
+    } catch {
+      key = null;
+    }
+    if (!key) return [];
+    const opened = [];
+    for (const record of records) {
+      if (!record || record.format > LEGACY_FORMAT) continue;
+      try {
+        const message = parseLegacyChatOutboxMessage(await openJson({ key, sealed: record.sealed, aad: aadOf(record) }));
+        if (message) opened.push(withFailure(message, record.failure));
+      } catch {
+      }
+    }
+    return opened.sort((a, b) => a.queuedAt - b.queuedAt);
+  };
+  const readIndex = async (index, query) => {
+    const db = await database();
+    if (!db) return [];
+    return await requestToPromise(
+      db.transaction(ENTRIES_STORE, "readonly").objectStore(ENTRIES_STORE).index(index).getAll(query)
+    );
+  };
+  return {
+    async listAll() {
+      try {
+        return await open(await readIndex(BY_OWNER, await ownerHash()));
+      } catch {
+        return [];
+      }
+    },
+    async list(threadId) {
+      try {
+        const thread = await sha256Hex(`${ownerId}|${threadId}`);
+        return await open(await readIndex(BY_OWNER_THREAD, [await ownerHash(), thread]));
+      } catch {
+        return [];
+      }
+    },
+    async count() {
+      const db = await database();
+      if (!db) return 0;
+      const owner = await ownerHash();
+      const keys = await requestToPromise(
+        db.transaction(ENTRIES_STORE, "readonly").objectStore(ENTRIES_STORE).index(BY_OWNER).getAllKeys(owner)
+      );
+      return keys.length;
+    },
+    async remove(threadId, id) {
+      const db = await database();
+      if (!db) return;
+      const key = await recordKey(threadId, id);
+      const tx = db.transaction(ENTRIES_STORE, "readwrite");
+      const store = tx.objectStore(ENTRIES_STORE);
+      const existing = await requestToPromise(store.get(key));
+      if (!isRecord(existing) || typeof existing.format !== "number" || existing.format <= LEGACY_FORMAT) {
+        store.delete(key);
+      }
+      await transactionDone(tx);
+    },
+    async clear() {
+      const db = await database();
+      if (!db) return;
+      const owner = await ownerHash();
+      const tx = db.transaction(ENTRIES_STORE, "readwrite");
+      const store = tx.objectStore(ENTRIES_STORE);
+      const keys = await requestToPromise(store.index(BY_OWNER).getAllKeys(owner));
+      for (const key of keys) store.delete(key);
+      await transactionDone(tx);
+    }
+  };
+}
+function newRunId() {
+  var _a, _b;
+  const host = globalThis;
+  return ((_b = (_a = host.crypto) == null ? void 0 : _a.randomUUID) == null ? void 0 : _b.call(_a)) ?? `run-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+function legacyAgents(message) {
+  var _a;
+  if (message.metadata && "addressedAgents" in message.metadata) return void 0;
+  const named = (_a = message.sendContext) == null ? void 0 : _a.namedAgents;
+  if (!Array.isArray(named)) return void 0;
+  const refs = named.flatMap(
+    (agent) => isRecord(agent) && typeof agent.ref === "string" && agent.ref.length > 0 ? [agent.ref] : []
+  );
+  return refs.length > 0 ? refs : void 0;
+}
+const LEGACY_ATTACHMENT_REFUSED_CODE = "attachment-unavailable";
+function legacyChatOutboxSendFailure(failure) {
+  return {
+    fate: "rejected",
+    cause: "server",
+    code: failure.reason === "attachment" ? LEGACY_ATTACHMENT_REFUSED_CODE : `legacy-${failure.reason}`
+  };
+}
+function legacyChatOutboxInsert(message) {
+  const agents = legacyAgents(message);
+  const metadata = agents === void 0 && message.metadata === void 0 ? void 0 : { ...message.metadata, ...agents !== void 0 && { addressedAgents: agents } };
+  const parts = [
+    ...(message.files ?? []).map((file) => ({
+      type: "file",
+      mediaType: file.mediaType,
+      url: file.url,
+      ...file.filename !== void 0 && { filename: file.filename }
+    })),
+    ...message.text.length > 0 ? [{ type: "text", text: message.text }] : []
+  ];
+  const localMeta = {
+    kind: CHAT_OUTBOX_LOCAL_META_KIND,
+    threadId: message.threadId,
+    queuedAt: message.queuedAt,
+    newChat: message.newChat,
+    migratedFrom: LEGACY_CHAT_OUTBOX_SOURCE,
+    legacyId: message.id,
+    ...message.composerMarkdown !== void 0 && { composerMarkdown: message.composerMarkdown },
+    ...message.composerHtml !== void 0 && { composerHtml: message.composerHtml },
+    ...message.attachments !== void 0 && { attachments: message.attachments },
+    ...message.failure !== void 0 && { error: legacyChatOutboxSendFailure(message.failure) }
+  };
+  return {
+    protocol: DEEP_AGENT_STATEWIRE_PROTOCOL,
+    command: {
+      method: "run/send",
+      params: [
+        {
+          type: "run/send",
+          behavior: "auto",
+          runId: newRunId(),
+          message: { id: message.id, role: "user", parts, ...metadata !== void 0 && { metadata } }
+        }
+      ]
+    },
+    held: true,
+    localMeta
+  };
+}
+function holdsLegacy(outbox, message) {
+  return outbox.entries.some((entry) => {
+    var _a;
+    const meta = readChatOutboxLocalMeta(entry.localMeta);
+    return meta.legacyId === message.id || ((_a = runSendMessage(entry.command)) == null ? void 0 : _a.id) === message.id;
+  });
+}
+async function migrateLegacyChatOutbox({
+  threadId,
+  reader,
+  outbox,
+  isKept,
+  messageIdsShown
+}) {
+  const result = { inserted: 0, removed: 0, kept: 0 };
+  const messages = await reader.list(threadId);
+  for (const message of messages) {
+    if (message.threadId !== threadId) continue;
+    const delivered = (messageIdsShown == null ? void 0 : messageIdsShown().has(message.id)) ?? false;
+    if (!delivered && !holdsLegacy(outbox, message)) {
+      outbox.insert(legacyChatOutboxInsert(message));
+      result.inserted += 1;
+    }
+    let kept = delivered;
+    if (!kept) {
+      try {
+        kept = await isKept(message.id);
+      } catch {
+        kept = false;
+      }
+    }
+    if (!kept) {
+      result.kept += 1;
+      continue;
+    }
+    try {
+      await reader.remove(threadId, message.id);
+      result.removed += 1;
+    } catch {
+      result.kept += 1;
+    }
+  }
+  return result;
+}
+export {
+  LEGACY_CHAT_OUTBOX_DATABASE,
+  createLegacyChatOutboxReader,
+  legacyChatOutboxInsert,
+  legacyChatOutboxSendFailure,
+  migrateLegacyChatOutbox,
+  parseLegacyChatOutboxMessage,
+  readLegacyChatOutboxFailure
+};
+//# sourceMappingURL=chat-outbox-legacy.js.map

package/dist/agent-runtime/src/chat-outbox-legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-outbox-legacy.js","sources":["../../../../agent-runtime/src/chat-outbox-legacy.ts"],"sourcesContent":["import type { StatewireClient } from \"statewire\";\nimport {\n  CHAT_OUTBOX_LOCAL_META_KIND,\n  type ChatOutboxAttachment,\n  type ChatOutboxFile,\n  type ChatOutboxLocalMeta,\n  LEGACY_CHAT_OUTBOX_SOURCE,\n  readAttachments,\n  readChatOutboxLocalMeta,\n  readFiles,\n  runSendMessage,\n} from \"./chat-outbox-entry\";\nimport {\n  type IdbDatabase,\n  idbGlobals,\n  lazySealedDatabase,\n  openJson,\n  requestToPromise,\n  sha256Hex,\n  transactionDone,\n} from \"./sealed-idb\";\nimport { DEEP_AGENT_STATEWIRE_PROTOCOL } from \"./statewire-transport\";\n\n/**\n * The chat outbox's previous store (`athena-chat-outbox:v1`, one IndexedDB database per browser,\n * records sealed with AES-GCM under the person's key), read once to move each waiting message into\n * its thread's statewire outbox ({@link migrateLegacyChatOutbox}). Nothing new is ever written\n * here: a record is deleted only once its message is held in the thread's outbox on the device.\n */\n\nexport const LEGACY_CHAT_OUTBOX_DATABASE = LEGACY_CHAT_OUTBOX_SOURCE;\nconst LEGACY_FORMAT = 1;\nconst DATABASE_VERSION = 1;\nconst ENTRIES_STORE = \"entries\";\nconst BY_OWNER = \"byOwner\";\nconst BY_OWNER_THREAD = \"byOwnerThread\";\n\n/**\n * A hand-off the legacy store recorded as failed (`refused`, `error`, `prepare`, `attachment`):\n * the message waited for the person's Retry, Edit or Discard, and still does once migrated.\n */\nexport interface LegacyChatOutboxFailure {\n  reason: string;\n  at: number;\n}\n\n/** A message the legacy store kept. */\nexport interface LegacyChatOutboxMessage {\n  id: string;\n  threadId: string;\n  text: string;\n  queuedAt: number;\n  newChat: boolean;\n  composerMarkdown?: string;\n  composerHtml?: string;\n  metadata?: Record<string, unknown>;\n  /** The per-send settings it was typed with (Olympus: `{ namedAgents }`, the agents it named). */\n  sendContext?: Record<string, unknown>;\n  files?: ChatOutboxFile[];\n  attachments?: ChatOutboxAttachment[];\n  /** Its last hand-off failed: it never goes on its own. */\n  failure?: LegacyChatOutboxFailure;\n}\n\ninterface StoredRecord {\n  key: string;\n  owner: string;\n  thread: string;\n  format: number;\n  sealed: Uint8Array;\n  failure?: unknown;\n}\n\nexport interface LegacyChatOutboxReader {\n  /** Every message kept for this person (records that do not open are skipped and left). */\n  listAll(): Promise<LegacyChatOutboxMessage[]>;\n  list(threadId: string): Promise<LegacyChatOutboxMessage[]>;\n  /** How many records are kept for this person, opened or not. */\n  count(): Promise<number>;\n  remove(threadId: string, id: string): Promise<void>;\n  /** Every record of this person, gone (a sign-out the person chose). */\n  clear(): Promise<void>;\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 legacy record's failure read back; any failure with a time counts, its reason defaulting to `error`. */\nexport function readLegacyChatOutboxFailure(value: unknown): LegacyChatOutboxFailure | undefined {\n  if (!isRecord(value) || typeof value.at !== \"number\") return undefined;\n  return { reason: typeof value.reason === \"string\" && value.reason.length > 0 ? value.reason : \"error\", at: value.at };\n}\n\n/** A sealed v1 entry read back, or `null` when it is not one. */\nexport function parseLegacyChatOutboxMessage(value: unknown): LegacyChatOutboxMessage | null {\n  if (!isRecord(value)) return null;\n  const { id, threadId, text, queuedAt } = value;\n  if (typeof id !== \"string\" || typeof threadId !== \"string\" || typeof text !== \"string\") return null;\n  if (typeof queuedAt !== \"number\" || !Number.isFinite(queuedAt)) return null;\n  const files = readFiles(value.files);\n  const attachments = readAttachments(value.attachments);\n  return {\n    id,\n    threadId,\n    text,\n    queuedAt,\n    newChat: value.newChat === true,\n    ...(typeof value.composerMarkdown === \"string\" && { composerMarkdown: value.composerMarkdown }),\n    ...(typeof value.composerHtml === \"string\" && { composerHtml: value.composerHtml }),\n    ...(isRecord(value.metadata) && { metadata: value.metadata }),\n    ...(isRecord(value.sendContext) && { sendContext: value.sendContext }),\n    ...(files && { files }),\n    ...(attachments && { attachments }),\n  };\n}\n\nfunction withFailure(message: LegacyChatOutboxMessage, value: unknown): LegacyChatOutboxMessage {\n  const failure = readLegacyChatOutboxFailure(value);\n  return failure ? { ...message, failure } : message;\n}\n\nfunction upgrade(db: IdbDatabase): void {\n  if (!db.objectStoreNames.contains(ENTRIES_STORE)) {\n    const store = db.createObjectStore(ENTRIES_STORE, { keyPath: \"key\" });\n    store.createIndex(BY_OWNER, \"owner\", { unique: false });\n    store.createIndex(BY_OWNER_THREAD, [\"owner\", \"thread\"], { unique: false });\n  }\n}\n\n/**\n * The legacy store, read-only but for deletes. `getKey` is the person's AES-GCM key for reading\n * (`null`: nothing opens). `factory` is an `IDBFactory` (the browser's by default).\n */\nexport function createLegacyChatOutboxReader({\n  ownerId,\n  getKey,\n  factory = idbGlobals.indexedDB,\n  databaseName = LEGACY_CHAT_OUTBOX_DATABASE,\n}: {\n  ownerId: string;\n  getKey: () => Promise<CryptoKey | null>;\n  factory?: object | undefined;\n  databaseName?: string;\n}): LegacyChatOutboxReader {\n  const database = lazySealedDatabase({ factory, name: databaseName, version: DATABASE_VERSION, upgrade });\n  const ownerHash = () => sha256Hex(ownerId);\n  const recordKey = (threadId: string, id: string) => sha256Hex(`${ownerId}|${threadId}|${id}`);\n  const aadOf = (record: StoredRecord) =>\n    `athena-chat-outbox|${LEGACY_FORMAT}|${record.owner}|${record.thread}|${record.key}`;\n\n  const open = async (records: StoredRecord[]): Promise<LegacyChatOutboxMessage[]> => {\n    if (records.length === 0) return [];\n    let key: CryptoKey | null = null;\n    try {\n      key = await getKey();\n    } catch {\n      key = null;\n    }\n    if (!key) return [];\n    const opened: LegacyChatOutboxMessage[] = [];\n    for (const record of records) {\n      if (!record || record.format > LEGACY_FORMAT) continue;\n      try {\n        const message = parseLegacyChatOutboxMessage(await openJson({ key, sealed: record.sealed, aad: aadOf(record) }));\n        if (message) opened.push(withFailure(message, record.failure));\n      } catch {\n        // Not readable with this key: left as it is (it may be the only copy of someone's work).\n      }\n    }\n    return opened.sort((a, b) => a.queuedAt - b.queuedAt);\n  };\n\n  const readIndex = async (index: string, query: unknown): Promise<StoredRecord[]> => {\n    const db = await database();\n    if (!db) return [];\n    return (await requestToPromise(\n      db.transaction(ENTRIES_STORE, \"readonly\").objectStore(ENTRIES_STORE).index(index).getAll(query),\n    )) as StoredRecord[];\n  };\n\n  return {\n    async listAll() {\n      try {\n        return await open(await readIndex(BY_OWNER, await ownerHash()));\n      } catch {\n        return [];\n      }\n    },\n    async list(threadId) {\n      try {\n        const thread = await sha256Hex(`${ownerId}|${threadId}`);\n        return await open(await readIndex(BY_OWNER_THREAD, [await ownerHash(), thread]));\n      } catch {\n        return [];\n      }\n    },\n    async count() {\n      const db = await database();\n      if (!db) return 0;\n      // Hashed before the transaction opens: an await on anything but its own requests ends it.\n      const owner = await ownerHash();\n      const keys = await requestToPromise(\n        db.transaction(ENTRIES_STORE, \"readonly\").objectStore(ENTRIES_STORE).index(BY_OWNER).getAllKeys(owner),\n      );\n      return keys.length;\n    },\n    async remove(threadId, id) {\n      const db = await database();\n      if (!db) return;\n      const key = await recordKey(threadId, id);\n      const tx = db.transaction(ENTRIES_STORE, \"readwrite\");\n      const store = tx.objectStore(ENTRIES_STORE);\n      const existing = await requestToPromise(store.get(key));\n      // A newer build's record of the same message stays as that build wrote it.\n      if (!isRecord(existing) || typeof existing.format !== \"number\" || existing.format <= LEGACY_FORMAT) {\n        store.delete(key);\n      }\n      await transactionDone(tx);\n    },\n    async clear() {\n      const db = await database();\n      if (!db) return;\n      const owner = await ownerHash();\n      const tx = db.transaction(ENTRIES_STORE, \"readwrite\");\n      const store = tx.objectStore(ENTRIES_STORE);\n      const keys = await requestToPromise(store.index(BY_OWNER).getAllKeys(owner));\n      for (const key of keys) store.delete(key);\n      await transactionDone(tx);\n    },\n  };\n}\n\nfunction newRunId(): string {\n  const host = globalThis as { crypto?: { randomUUID?: () => string } };\n  return host.crypto?.randomUUID?.() ?? `run-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;\n}\n\n/**\n * The agents a legacy message named: Olympus kept them as `sendContext.namedAgents`\n * (`[{ ref, name, assetId }]`). A message whose metadata already names its own keeps those.\n */\nfunction legacyAgents(message: LegacyChatOutboxMessage): string[] | undefined {\n  if (message.metadata && \"addressedAgents\" in message.metadata) return undefined;\n  const named = message.sendContext?.namedAgents;\n  if (!Array.isArray(named)) return undefined;\n  const refs = named.flatMap((agent) =>\n    isRecord(agent) && typeof agent.ref === \"string\" && agent.ref.length > 0 ? [agent.ref] : [],\n  );\n  return refs.length > 0 ? refs : undefined;\n}\n\n/** The failure code of a legacy attachment refusal (`CHAT_OUTBOX_ATTACHMENT_REFUSED_CODE`). */\nconst LEGACY_ATTACHMENT_REFUSED_CODE = \"attachment-unavailable\";\n\n/** The `localMeta.error` a legacy failure becomes: the row shows \"Couldn't send\" and never goes on its own. */\nexport function legacyChatOutboxSendFailure(failure: LegacyChatOutboxFailure): StatewireClient.SendFailure {\n  return {\n    fate: \"rejected\",\n    cause: \"server\",\n    code: failure.reason === \"attachment\" ? LEGACY_ATTACHMENT_REFUSED_CODE : `legacy-${failure.reason}`,\n  };\n}\n\n/**\n * The held `run/send` a legacy message becomes (re-anchored when it is released). A message\n * whose hand-off had failed keeps its failure (`localMeta.error`): it waits for Retry, Edit or Discard.\n */\nexport function legacyChatOutboxInsert(message: LegacyChatOutboxMessage): StatewireClient.OutboxInsert {\n  const agents = legacyAgents(message);\n  const metadata =\n    agents === undefined && message.metadata === undefined\n      ? undefined\n      : { ...message.metadata, ...(agents !== undefined && { addressedAgents: agents }) };\n  const parts = [\n    ...(message.files ?? []).map((file) => ({\n      type: \"file\" as const,\n      mediaType: file.mediaType,\n      url: file.url,\n      ...(file.filename !== undefined && { filename: file.filename }),\n    })),\n    ...(message.text.length > 0 ? [{ type: \"text\" as const, text: message.text }] : []),\n  ];\n  const localMeta: ChatOutboxLocalMeta = {\n    kind: CHAT_OUTBOX_LOCAL_META_KIND,\n    threadId: message.threadId,\n    queuedAt: message.queuedAt,\n    newChat: message.newChat,\n    migratedFrom: LEGACY_CHAT_OUTBOX_SOURCE,\n    legacyId: message.id,\n    ...(message.composerMarkdown !== undefined && { composerMarkdown: message.composerMarkdown }),\n    ...(message.composerHtml !== undefined && { composerHtml: message.composerHtml }),\n    ...(message.attachments !== undefined && { attachments: message.attachments }),\n    ...(message.failure !== undefined && { error: legacyChatOutboxSendFailure(message.failure) }),\n  };\n  return {\n    protocol: DEEP_AGENT_STATEWIRE_PROTOCOL,\n    command: {\n      method: \"run/send\",\n      params: [\n        {\n          type: \"run/send\",\n          behavior: \"auto\",\n          runId: newRunId(),\n          message: { id: message.id, role: \"user\", parts, ...(metadata !== undefined && { metadata }) },\n        },\n      ],\n    },\n    held: true,\n    localMeta,\n  };\n}\n\n/** The outbox verbs a migration uses (`StatewireClient.Outbox`, structurally). */\nexport interface LegacyMigrationOutbox {\n  readonly entries: readonly StatewireClient.OutboxEntry[];\n  insert(entry: StatewireClient.OutboxInsert): string;\n}\n\n/** Whether the outbox already holds the legacy message (inserted by an earlier, interrupted run). */\nfunction holdsLegacy(outbox: LegacyMigrationOutbox, message: LegacyChatOutboxMessage): boolean {\n  return outbox.entries.some((entry) => {\n    const meta = readChatOutboxLocalMeta(entry.localMeta);\n    return meta.legacyId === message.id || runSendMessage(entry.command)?.id === message.id;\n  });\n}\n\nexport interface MigrateLegacyChatOutboxResult {\n  /** Inserted into the thread's outbox by this run. */\n  inserted: number;\n  /** Legacy records deleted (their message is held on the device). */\n  removed: number;\n  /** Left in the legacy store: not yet confirmed kept on the device, or a delete that failed. */\n  kept: number;\n}\n\n/**\n * Moves the thread's legacy records into its statewire outbox: each becomes a held entry\n * (`insert({ protocol, command, held: true, localMeta: { migratedFrom, legacyId, queuedAt, … } })`)\n * and its record is deleted only once `isKept` confirms the entry is stored on the device (read\n * back from storage, e.g. through `readOutboxes`). Idempotent: an entry already holding the\n * message (an interrupted earlier run, another tab) is not inserted again, and its record is\n * deleted once confirmed. A session kept in page memory only never confirms, so its legacy records\n * stay until the message is sent or discarded ({@link ChatOutboxOptions.legacy}).\n */\nexport async function migrateLegacyChatOutbox({\n  threadId,\n  reader,\n  outbox,\n  isKept,\n  messageIdsShown,\n}: {\n  threadId: string;\n  reader: LegacyChatOutboxReader;\n  outbox: LegacyMigrationOutbox;\n  /** Resolves `true` once the entry carrying `messageId` is stored on the device. */\n  isKept: (messageId: string) => Promise<boolean>;\n  /** Message ids the thread already shows (delivered before the migration): their records just go. */\n  messageIdsShown?: () => ReadonlySet<string>;\n}): Promise<MigrateLegacyChatOutboxResult> {\n  const result: MigrateLegacyChatOutboxResult = { inserted: 0, removed: 0, kept: 0 };\n  const messages = await reader.list(threadId);\n  for (const message of messages) {\n    if (message.threadId !== threadId) continue;\n    const delivered = messageIdsShown?.().has(message.id) ?? false;\n    if (!delivered && !holdsLegacy(outbox, message)) {\n      outbox.insert(legacyChatOutboxInsert(message));\n      result.inserted += 1;\n    }\n    let kept = delivered;\n    if (!kept) {\n      try {\n        kept = await isKept(message.id);\n      } catch {\n        kept = false;\n      }\n    }\n    if (!kept) {\n      result.kept += 1;\n      continue;\n    }\n    try {\n      await reader.remove(threadId, message.id);\n      result.removed += 1;\n    } catch {\n      result.kept += 1;\n    }\n  }\n  return result;\n}\n"],"names":[],"mappings":";;;AA8BO,MAAM,8BAA8B;AAC3C,MAAM,gBAAgB;AACtB,MAAM,mBAAmB;AACzB,MAAM,gBAAgB;AACtB,MAAM,WAAW;AACjB,MAAM,kBAAkB;AAiDxB,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAGO,SAAS,4BAA4B,OAAqD;AAC/F,MAAI,CAAC,SAAS,KAAK,KAAK,OAAO,MAAM,OAAO,SAAU,QAAO;AAC7D,SAAO,EAAE,QAAQ,OAAO,MAAM,WAAW,YAAY,MAAM,OAAO,SAAS,IAAI,MAAM,SAAS,SAAS,IAAI,MAAM,GAAA;AACnH;AAGO,SAAS,6BAA6B,OAAgD;AAC3F,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,EAAE,IAAI,UAAU,MAAM,aAAa;AACzC,MAAI,OAAO,OAAO,YAAY,OAAO,aAAa,YAAY,OAAO,SAAS,SAAU,QAAO;AAC/F,MAAI,OAAO,aAAa,YAAY,CAAC,OAAO,SAAS,QAAQ,EAAG,QAAO;AACvE,QAAM,QAAQ,UAAU,MAAM,KAAK;AACnC,QAAM,cAAc,gBAAgB,MAAM,WAAW;AACrD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,MAAM,YAAY;AAAA,IAC3B,GAAI,OAAO,MAAM,qBAAqB,YAAY,EAAE,kBAAkB,MAAM,iBAAA;AAAA,IAC5E,GAAI,OAAO,MAAM,iBAAiB,YAAY,EAAE,cAAc,MAAM,aAAA;AAAA,IACpE,GAAI,SAAS,MAAM,QAAQ,KAAK,EAAE,UAAU,MAAM,SAAA;AAAA,IAClD,GAAI,SAAS,MAAM,WAAW,KAAK,EAAE,aAAa,MAAM,YAAA;AAAA,IACxD,GAAI,SAAS,EAAE,MAAA;AAAA,IACf,GAAI,eAAe,EAAE,YAAA;AAAA,EAAY;AAErC;AAEA,SAAS,YAAY,SAAkC,OAAyC;AAC9F,QAAM,UAAU,4BAA4B,KAAK;AACjD,SAAO,UAAU,EAAE,GAAG,SAAS,YAAY;AAC7C;AAEA,SAAS,QAAQ,IAAuB;AACtC,MAAI,CAAC,GAAG,iBAAiB,SAAS,aAAa,GAAG;AAChD,UAAM,QAAQ,GAAG,kBAAkB,eAAe,EAAE,SAAS,OAAO;AACpE,UAAM,YAAY,UAAU,SAAS,EAAE,QAAQ,OAAO;AACtD,UAAM,YAAY,iBAAiB,CAAC,SAAS,QAAQ,GAAG,EAAE,QAAQ,OAAO;AAAA,EAC3E;AACF;AAMO,SAAS,6BAA6B;AAAA,EAC3C;AAAA,EACA;AAAA,EACA,UAAU,WAAW;AAAA,EACrB,eAAe;AACjB,GAK2B;AACzB,QAAM,WAAW,mBAAmB,EAAE,SAAS,MAAM,cAAc,SAAS,kBAAkB,SAAS;AACvG,QAAM,YAAY,MAAM,UAAU,OAAO;AACzC,QAAM,YAAY,CAAC,UAAkB,OAAe,UAAU,GAAG,OAAO,IAAI,QAAQ,IAAI,EAAE,EAAE;AAC5F,QAAM,QAAQ,CAAC,WACb,sBAAsB,aAAa,IAAI,OAAO,KAAK,IAAI,OAAO,MAAM,IAAI,OAAO,GAAG;AAEpF,QAAM,OAAO,OAAO,YAAgE;AAClF,QAAI,QAAQ,WAAW,EAAG,QAAO,CAAA;AACjC,QAAI,MAAwB;AAC5B,QAAI;AACF,YAAM,MAAM,OAAA;AAAA,IACd,QAAQ;AACN,YAAM;AAAA,IACR;AACA,QAAI,CAAC,IAAK,QAAO,CAAA;AACjB,UAAM,SAAoC,CAAA;AAC1C,eAAW,UAAU,SAAS;AAC5B,UAAI,CAAC,UAAU,OAAO,SAAS,cAAe;AAC9C,UAAI;AACF,cAAM,UAAU,6BAA6B,MAAM,SAAS,EAAE,KAAK,QAAQ,OAAO,QAAQ,KAAK,MAAM,MAAM,EAAA,CAAG,CAAC;AAC/G,YAAI,QAAS,QAAO,KAAK,YAAY,SAAS,OAAO,OAAO,CAAC;AAAA,MAC/D,QAAQ;AAAA,MAER;AAAA,IACF;AACA,WAAO,OAAO,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AAAA,EACtD;AAEA,QAAM,YAAY,OAAO,OAAe,UAA4C;AAClF,UAAM,KAAK,MAAM,SAAA;AACjB,QAAI,CAAC,GAAI,QAAO,CAAA;AAChB,WAAQ,MAAM;AAAA,MACZ,GAAG,YAAY,eAAe,UAAU,EAAE,YAAY,aAAa,EAAE,MAAM,KAAK,EAAE,OAAO,KAAK;AAAA,IAAA;AAAA,EAElG;AAEA,SAAO;AAAA,IACL,MAAM,UAAU;AACd,UAAI;AACF,eAAO,MAAM,KAAK,MAAM,UAAU,UAAU,MAAM,UAAA,CAAW,CAAC;AAAA,MAChE,QAAQ;AACN,eAAO,CAAA;AAAA,MACT;AAAA,IACF;AAAA,IACA,MAAM,KAAK,UAAU;AACnB,UAAI;AACF,cAAM,SAAS,MAAM,UAAU,GAAG,OAAO,IAAI,QAAQ,EAAE;AACvD,eAAO,MAAM,KAAK,MAAM,UAAU,iBAAiB,CAAC,MAAM,UAAA,GAAa,MAAM,CAAC,CAAC;AAAA,MACjF,QAAQ;AACN,eAAO,CAAA;AAAA,MACT;AAAA,IACF;AAAA,IACA,MAAM,QAAQ;AACZ,YAAM,KAAK,MAAM,SAAA;AACjB,UAAI,CAAC,GAAI,QAAO;AAEhB,YAAM,QAAQ,MAAM,UAAA;AACpB,YAAM,OAAO,MAAM;AAAA,QACjB,GAAG,YAAY,eAAe,UAAU,EAAE,YAAY,aAAa,EAAE,MAAM,QAAQ,EAAE,WAAW,KAAK;AAAA,MAAA;AAEvG,aAAO,KAAK;AAAA,IACd;AAAA,IACA,MAAM,OAAO,UAAU,IAAI;AACzB,YAAM,KAAK,MAAM,SAAA;AACjB,UAAI,CAAC,GAAI;AACT,YAAM,MAAM,MAAM,UAAU,UAAU,EAAE;AACxC,YAAM,KAAK,GAAG,YAAY,eAAe,WAAW;AACpD,YAAM,QAAQ,GAAG,YAAY,aAAa;AAC1C,YAAM,WAAW,MAAM,iBAAiB,MAAM,IAAI,GAAG,CAAC;AAEtD,UAAI,CAAC,SAAS,QAAQ,KAAK,OAAO,SAAS,WAAW,YAAY,SAAS,UAAU,eAAe;AAClG,cAAM,OAAO,GAAG;AAAA,MAClB;AACA,YAAM,gBAAgB,EAAE;AAAA,IAC1B;AAAA,IACA,MAAM,QAAQ;AACZ,YAAM,KAAK,MAAM,SAAA;AACjB,UAAI,CAAC,GAAI;AACT,YAAM,QAAQ,MAAM,UAAA;AACpB,YAAM,KAAK,GAAG,YAAY,eAAe,WAAW;AACpD,YAAM,QAAQ,GAAG,YAAY,aAAa;AAC1C,YAAM,OAAO,MAAM,iBAAiB,MAAM,MAAM,QAAQ,EAAE,WAAW,KAAK,CAAC;AAC3E,iBAAW,OAAO,KAAM,OAAM,OAAO,GAAG;AACxC,YAAM,gBAAgB,EAAE;AAAA,IAC1B;AAAA,EAAA;AAEJ;AAEA,SAAS,WAAmB;;AAC1B,QAAM,OAAO;AACb,WAAO,gBAAK,WAAL,mBAAa,eAAb,gCAA+B,OAAO,KAAK,IAAA,EAAM,SAAS,EAAE,CAAC,IAAI,KAAK,SAAS,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAC7G;AAMA,SAAS,aAAa,SAAwD;;AAC5E,MAAI,QAAQ,YAAY,qBAAqB,QAAQ,SAAU,QAAO;AACtE,QAAM,SAAQ,aAAQ,gBAAR,mBAAqB;AACnC,MAAI,CAAC,MAAM,QAAQ,KAAK,EAAG,QAAO;AAClC,QAAM,OAAO,MAAM;AAAA,IAAQ,CAAC,UAC1B,SAAS,KAAK,KAAK,OAAO,MAAM,QAAQ,YAAY,MAAM,IAAI,SAAS,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;AAAA,EAAC;AAE5F,SAAO,KAAK,SAAS,IAAI,OAAO;AAClC;AAGA,MAAM,iCAAiC;AAGhC,SAAS,4BAA4B,SAA+D;AACzG,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM,QAAQ,WAAW,eAAe,iCAAiC,UAAU,QAAQ,MAAM;AAAA,EAAA;AAErG;AAMO,SAAS,uBAAuB,SAAgE;AACrG,QAAM,SAAS,aAAa,OAAO;AACnC,QAAM,WACJ,WAAW,UAAa,QAAQ,aAAa,SACzC,SACA,EAAE,GAAG,QAAQ,UAAU,GAAI,WAAW,UAAa,EAAE,iBAAiB,SAAO;AACnF,QAAM,QAAQ;AAAA,IACZ,IAAI,QAAQ,SAAS,CAAA,GAAI,IAAI,CAAC,UAAU;AAAA,MACtC,MAAM;AAAA,MACN,WAAW,KAAK;AAAA,MAChB,KAAK,KAAK;AAAA,MACV,GAAI,KAAK,aAAa,UAAa,EAAE,UAAU,KAAK,SAAA;AAAA,IAAS,EAC7D;AAAA,IACF,GAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,EAAE,MAAM,QAAiB,MAAM,QAAQ,KAAA,CAAM,IAAI,CAAA;AAAA,EAAC;AAEnF,QAAM,YAAiC;AAAA,IACrC,MAAM;AAAA,IACN,UAAU,QAAQ;AAAA,IAClB,UAAU,QAAQ;AAAA,IAClB,SAAS,QAAQ;AAAA,IACjB,cAAc;AAAA,IACd,UAAU,QAAQ;AAAA,IAClB,GAAI,QAAQ,qBAAqB,UAAa,EAAE,kBAAkB,QAAQ,iBAAA;AAAA,IAC1E,GAAI,QAAQ,iBAAiB,UAAa,EAAE,cAAc,QAAQ,aAAA;AAAA,IAClE,GAAI,QAAQ,gBAAgB,UAAa,EAAE,aAAa,QAAQ,YAAA;AAAA,IAChE,GAAI,QAAQ,YAAY,UAAa,EAAE,OAAO,4BAA4B,QAAQ,OAAO,EAAA;AAAA,EAAE;AAE7F,SAAO;AAAA,IACL,UAAU;AAAA,IACV,SAAS;AAAA,MACP,QAAQ;AAAA,MACR,QAAQ;AAAA,QACN;AAAA,UACE,MAAM;AAAA,UACN,UAAU;AAAA,UACV,OAAO,SAAA;AAAA,UACP,SAAS,EAAE,IAAI,QAAQ,IAAI,MAAM,QAAQ,OAAO,GAAI,aAAa,UAAa,EAAE,WAAS;AAAA,QAAG;AAAA,MAC9F;AAAA,IACF;AAAA,IAEF,MAAM;AAAA,IACN;AAAA,EAAA;AAEJ;AASA,SAAS,YAAY,QAA+B,SAA2C;AAC7F,SAAO,OAAO,QAAQ,KAAK,CAAC,UAAU;;AACpC,UAAM,OAAO,wBAAwB,MAAM,SAAS;AACpD,WAAO,KAAK,aAAa,QAAQ,QAAM,oBAAe,MAAM,OAAO,MAA5B,mBAA+B,QAAO,QAAQ;AAAA,EACvF,CAAC;AACH;AAoBA,eAAsB,wBAAwB;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAQ2C;AACzC,QAAM,SAAwC,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,EAAA;AAC/E,QAAM,WAAW,MAAM,OAAO,KAAK,QAAQ;AAC3C,aAAW,WAAW,UAAU;AAC9B,QAAI,QAAQ,aAAa,SAAU;AACnC,UAAM,aAAY,qDAAoB,IAAI,QAAQ,QAAO;AACzD,QAAI,CAAC,aAAa,CAAC,YAAY,QAAQ,OAAO,GAAG;AAC/C,aAAO,OAAO,uBAAuB,OAAO,CAAC;AAC7C,aAAO,YAAY;AAAA,IACrB;AACA,QAAI,OAAO;AACX,QAAI,CAAC,MAAM;AACT,UAAI;AACF,eAAO,MAAM,OAAO,QAAQ,EAAE;AAAA,MAChC,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AACA,QAAI,CAAC,MAAM;AACT,aAAO,QAAQ;AACf;AAAA,IACF;AACA,QAAI;AACF,YAAM,OAAO,OAAO,UAAU,QAAQ,EAAE;AACxC,aAAO,WAAW;AAAA,IACpB,QAAQ;AACN,aAAO,QAAQ;AAAA,IACjB;AAAA,EACF;AACA,SAAO;AACT;"}

package/dist/agent-runtime/src/chat-outbox-policy.cjs

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const runSend = require("./run-send.cjs");
+function isMessageRunCommand(command) {
+  return runSend.MESSAGE_RUN_METHODS.has(command.method) || command.method in runSend.LEGACY_RUN_SEND_BEHAVIORS;
+}
+const IN_LINE_METHODS = /* @__PURE__ */ new Set([...runSend.MESSAGE_RUN_METHODS, "run/reload", "run/continue"]);
+const athenaCanOvertake = (entry) => !IN_LINE_METHODS.has(entry.command.method);
+function createChatOutboxFlushPolicy({
+  foreground,
+  outbox
+}) {
+  return ({ commands, reason }) => {
+    if (reason !== "reload" || foreground()) return;
+    const target = outbox();
+    if (!target) return;
+    for (const entry of commands) {
+      if (!isMessageRunCommand(entry.command)) continue;
+      try {
+        target.hold(entry.id);
+      } catch {
+      }
+    }
+  };
+}
+exports.MESSAGE_RUN_METHODS = runSend.MESSAGE_RUN_METHODS;
+exports.athenaCanOvertake = athenaCanOvertake;
+exports.createChatOutboxFlushPolicy = createChatOutboxFlushPolicy;
+exports.isMessageRunCommand = isMessageRunCommand;
+//# sourceMappingURL=chat-outbox-policy.cjs.map

package/dist/agent-runtime/src/chat-outbox-policy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-outbox-policy.cjs","sources":["../../../../agent-runtime/src/chat-outbox-policy.ts"],"sourcesContent":["import type { StatewireClient } from \"statewire\";\nimport { LEGACY_RUN_SEND_BEHAVIORS, MESSAGE_RUN_METHODS } from \"./run-send\";\n\n/**\n * How Athena's `athena` lane orders and flushes its outbox (statewire 0.24).\n *\n * - **Ordering** ({@link athenaCanOvertake}): a command that carries a user message (`run/send`,\n *   `run/edit`) or starts a turn from the transcript (`run/reload`, `run/continue`)\n *   never moves ahead of a held or waiting entry, so nothing typed after a message that waits (to\n *   be sent after a countdown, to be asked about, or to be retried) is delivered before it. Every\n *   other command (`run/stop`, a tool result, an input reply, a dequeue) passes everything: the\n *   person can stop a run or answer it while messages wait.\n * - **Flushing** ({@link createChatOutboxFlushPolicy}): a tab that is not in front never sends a\n *   backlog. Message sends a flush offers with reason `\"reload\"` (queued before this page mounted)\n *   are held instead; the visible tab's chat outbox counts them down and sends them.\n */\n\nexport { MESSAGE_RUN_METHODS };\n\n/**\n * Whether an outbox entry's command carries a user message, in either contract: a record an\n * earlier build stored still holds `run/enqueue` / `run/steer` until it is next mounted.\n */\nexport function isMessageRunCommand(command: { method: string }): boolean {\n  return MESSAGE_RUN_METHODS.has(command.method) || command.method in LEGACY_RUN_SEND_BEHAVIORS;\n}\n\n/** The commands that keep their place in line behind a held or waiting entry. */\nconst IN_LINE_METHODS: ReadonlySet<string> = new Set([...MESSAGE_RUN_METHODS, \"run/reload\", \"run/continue\"]);\n\n/**\n * `canOvertake` for the `athena` protocol: messages (and the turns that re-run the transcript)\n * never pass anything held or waiting; every other command passes everything.\n */\nexport const athenaCanOvertake: StatewireClient.CanOvertake = (entry) => !IN_LINE_METHODS.has(entry.command.method);\n\n/** The outbox verbs the flush policy uses. */\nexport interface ChatOutboxFlushTarget {\n  hold(id: string): void;\n}\n\n/**\n * An `onFlush` that holds message sends offered with reason `\"reload\"` while `foreground()` says\n * the app is not in front. Verbs called inside `onFlush` apply before stamping, so a held entry is\n * never sent by this flush. `outbox` is read per flush (the thread's `extras.outbox`, or the\n * client's `outbox`); while it is unavailable nothing is held.\n */\nexport function createChatOutboxFlushPolicy({\n  foreground,\n  outbox,\n}: {\n  foreground: () => boolean;\n  outbox: () => ChatOutboxFlushTarget | null | undefined;\n}): StatewireClient.OnFlush {\n  return ({ commands, reason }) => {\n    if (reason !== \"reload\" || foreground()) return;\n    const target = outbox();\n    if (!target) return;\n    for (const entry of commands) {\n      if (!isMessageRunCommand(entry.command)) continue;\n      try {\n        target.hold(entry.id);\n      } catch {\n        // An entry another sharer stamped meanwhile is no longer this flush's to hold.\n      }\n    }\n  };\n}\n"],"names":["MESSAGE_RUN_METHODS","LEGACY_RUN_SEND_BEHAVIORS"],"mappings":";;;AAuBO,SAAS,oBAAoB,SAAsC;AACxE,SAAOA,QAAAA,oBAAoB,IAAI,QAAQ,MAAM,KAAK,QAAQ,UAAUC,QAAAA;AACtE;AAGA,MAAM,sCAA2C,IAAI,CAAC,GAAGD,QAAAA,qBAAqB,cAAc,cAAc,CAAC;AAMpG,MAAM,oBAAiD,CAAC,UAAU,CAAC,gBAAgB,IAAI,MAAM,QAAQ,MAAM;AAa3G,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AACF,GAG4B;AAC1B,SAAO,CAAC,EAAE,UAAU,aAAa;AAC/B,QAAI,WAAW,YAAY,aAAc;AACzC,UAAM,SAAS,OAAA;AACf,QAAI,CAAC,OAAQ;AACb,eAAW,SAAS,UAAU;AAC5B,UAAI,CAAC,oBAAoB,MAAM,OAAO,EAAG;AACzC,UAAI;AACF,eAAO,KAAK,MAAM,EAAE;AAAA,MACtB,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;;;;;"}

package/dist/agent-runtime/src/chat-outbox-policy.d.ts

@@ -0,0 +1,42 @@
+import type { StatewireClient } from "statewire";
+import { MESSAGE_RUN_METHODS } from "./run-send";
+/**
+ * How Athena's `athena` lane orders and flushes its outbox (statewire 0.24).
+ *
+ * - **Ordering** ({@link athenaCanOvertake}): a command that carries a user message (`run/send`,
+ *   `run/edit`) or starts a turn from the transcript (`run/reload`, `run/continue`)
+ *   never moves ahead of a held or waiting entry, so nothing typed after a message that waits (to
+ *   be sent after a countdown, to be asked about, or to be retried) is delivered before it. Every
+ *   other command (`run/stop`, a tool result, an input reply, a dequeue) passes everything: the
+ *   person can stop a run or answer it while messages wait.
+ * - **Flushing** ({@link createChatOutboxFlushPolicy}): a tab that is not in front never sends a
+ *   backlog. Message sends a flush offers with reason `"reload"` (queued before this page mounted)
+ *   are held instead; the visible tab's chat outbox counts them down and sends them.
+ */
+export { MESSAGE_RUN_METHODS };
+/**
+ * Whether an outbox entry's command carries a user message, in either contract: a record an
+ * earlier build stored still holds `run/enqueue` / `run/steer` until it is next mounted.
+ */
+export declare function isMessageRunCommand(command: {
+    method: string;
+}): boolean;
+/**
+ * `canOvertake` for the `athena` protocol: messages (and the turns that re-run the transcript)
+ * never pass anything held or waiting; every other command passes everything.
+ */
+export declare const athenaCanOvertake: StatewireClient.CanOvertake;
+/** The outbox verbs the flush policy uses. */
+export interface ChatOutboxFlushTarget {
+    hold(id: string): void;
+}
+/**
+ * An `onFlush` that holds message sends offered with reason `"reload"` while `foreground()` says
+ * the app is not in front. Verbs called inside `onFlush` apply before stamping, so a held entry is
+ * never sent by this flush. `outbox` is read per flush (the thread's `extras.outbox`, or the
+ * client's `outbox`); while it is unavailable nothing is held.
+ */
+export declare function createChatOutboxFlushPolicy({ foreground, outbox, }: {
+    foreground: () => boolean;
+    outbox: () => ChatOutboxFlushTarget | null | undefined;
+}): StatewireClient.OnFlush;

package/dist/agent-runtime/src/chat-outbox-policy.js

@@ -0,0 +1,30 @@
+import { LEGACY_RUN_SEND_BEHAVIORS, MESSAGE_RUN_METHODS } from "./run-send.js";
+function isMessageRunCommand(command) {
+  return MESSAGE_RUN_METHODS.has(command.method) || command.method in LEGACY_RUN_SEND_BEHAVIORS;
+}
+const IN_LINE_METHODS = /* @__PURE__ */ new Set([...MESSAGE_RUN_METHODS, "run/reload", "run/continue"]);
+const athenaCanOvertake = (entry) => !IN_LINE_METHODS.has(entry.command.method);
+function createChatOutboxFlushPolicy({
+  foreground,
+  outbox
+}) {
+  return ({ commands, reason }) => {
+    if (reason !== "reload" || foreground()) return;
+    const target = outbox();
+    if (!target) return;
+    for (const entry of commands) {
+      if (!isMessageRunCommand(entry.command)) continue;
+      try {
+        target.hold(entry.id);
+      } catch {
+      }
+    }
+  };
+}
+export {
+  MESSAGE_RUN_METHODS,
+  athenaCanOvertake,
+  createChatOutboxFlushPolicy,
+  isMessageRunCommand
+};
+//# sourceMappingURL=chat-outbox-policy.js.map

package/dist/agent-runtime/src/chat-outbox-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-outbox-policy.js","sources":["../../../../agent-runtime/src/chat-outbox-policy.ts"],"sourcesContent":["import type { StatewireClient } from \"statewire\";\nimport { LEGACY_RUN_SEND_BEHAVIORS, MESSAGE_RUN_METHODS } from \"./run-send\";\n\n/**\n * How Athena's `athena` lane orders and flushes its outbox (statewire 0.24).\n *\n * - **Ordering** ({@link athenaCanOvertake}): a command that carries a user message (`run/send`,\n *   `run/edit`) or starts a turn from the transcript (`run/reload`, `run/continue`)\n *   never moves ahead of a held or waiting entry, so nothing typed after a message that waits (to\n *   be sent after a countdown, to be asked about, or to be retried) is delivered before it. Every\n *   other command (`run/stop`, a tool result, an input reply, a dequeue) passes everything: the\n *   person can stop a run or answer it while messages wait.\n * - **Flushing** ({@link createChatOutboxFlushPolicy}): a tab that is not in front never sends a\n *   backlog. Message sends a flush offers with reason `\"reload\"` (queued before this page mounted)\n *   are held instead; the visible tab's chat outbox counts them down and sends them.\n */\n\nexport { MESSAGE_RUN_METHODS };\n\n/**\n * Whether an outbox entry's command carries a user message, in either contract: a record an\n * earlier build stored still holds `run/enqueue` / `run/steer` until it is next mounted.\n */\nexport function isMessageRunCommand(command: { method: string }): boolean {\n  return MESSAGE_RUN_METHODS.has(command.method) || command.method in LEGACY_RUN_SEND_BEHAVIORS;\n}\n\n/** The commands that keep their place in line behind a held or waiting entry. */\nconst IN_LINE_METHODS: ReadonlySet<string> = new Set([...MESSAGE_RUN_METHODS, \"run/reload\", \"run/continue\"]);\n\n/**\n * `canOvertake` for the `athena` protocol: messages (and the turns that re-run the transcript)\n * never pass anything held or waiting; every other command passes everything.\n */\nexport const athenaCanOvertake: StatewireClient.CanOvertake = (entry) => !IN_LINE_METHODS.has(entry.command.method);\n\n/** The outbox verbs the flush policy uses. */\nexport interface ChatOutboxFlushTarget {\n  hold(id: string): void;\n}\n\n/**\n * An `onFlush` that holds message sends offered with reason `\"reload\"` while `foreground()` says\n * the app is not in front. Verbs called inside `onFlush` apply before stamping, so a held entry is\n * never sent by this flush. `outbox` is read per flush (the thread's `extras.outbox`, or the\n * client's `outbox`); while it is unavailable nothing is held.\n */\nexport function createChatOutboxFlushPolicy({\n  foreground,\n  outbox,\n}: {\n  foreground: () => boolean;\n  outbox: () => ChatOutboxFlushTarget | null | undefined;\n}): StatewireClient.OnFlush {\n  return ({ commands, reason }) => {\n    if (reason !== \"reload\" || foreground()) return;\n    const target = outbox();\n    if (!target) return;\n    for (const entry of commands) {\n      if (!isMessageRunCommand(entry.command)) continue;\n      try {\n        target.hold(entry.id);\n      } catch {\n        // An entry another sharer stamped meanwhile is no longer this flush's to hold.\n      }\n    }\n  };\n}\n"],"names":[],"mappings":";AAuBO,SAAS,oBAAoB,SAAsC;AACxE,SAAO,oBAAoB,IAAI,QAAQ,MAAM,KAAK,QAAQ,UAAU;AACtE;AAGA,MAAM,sCAA2C,IAAI,CAAC,GAAG,qBAAqB,cAAc,cAAc,CAAC;AAMpG,MAAM,oBAAiD,CAAC,UAAU,CAAC,gBAAgB,IAAI,MAAM,QAAQ,MAAM;AAa3G,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AACF,GAG4B;AAC1B,SAAO,CAAC,EAAE,UAAU,aAAa;AAC/B,QAAI,WAAW,YAAY,aAAc;AACzC,UAAM,SAAS,OAAA;AACf,QAAI,CAAC,OAAQ;AACb,eAAW,SAAS,UAAU;AAC5B,UAAI,CAAC,oBAAoB,MAAM,OAAO,EAAG;AACzC,UAAI;AACF,eAAO,KAAK,MAAM,EAAE;AAAA,MACtB,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;"}