@athenaintel/react 0.41.3 → 0.42.2

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

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function extrasOf(state) {
+  const extras = state.extras;
+  return extras && typeof extras === "object" ? extras : null;
+}
+function idsOf(list, into) {
+  if (!Array.isArray(list)) return;
+  for (const item of list) {
+    const id = item == null ? void 0 : item.id;
+    if (typeof id === "string") into.add(id);
+  }
+}
+function chatOutboxHeldIds(state) {
+  var _a, _b;
+  const held = /* @__PURE__ */ new Set();
+  for (const message of state.messages ?? []) held.add(message.id);
+  const runs = (_a = extrasOf(state)) == null ? void 0 : _a.runs;
+  if (runs) {
+    idsOf(runs.queue, held);
+    idsOf(runs.steerQueue, held);
+    idsOf(runs.failed, held);
+    idsOf((_b = runs.dispatching) == null ? void 0 : _b.messages, held);
+  }
+  return held;
+}
+function chatOutboxReadiness(connection) {
+  if (!connection) return "connecting";
+  switch (connection.status) {
+    case "connected":
+      return "ready";
+    case "standby":
+      return connection.reason === "deferred" && typeof connection.message === "string" ? "refused" : "ready";
+    case "stopped":
+      return "refused";
+    default:
+      return "connecting";
+  }
+}
+function chatOutboxWireAnchorId(wireMessages) {
+  let fallback = null;
+  for (let index = wireMessages.length - 1; index >= 0; index -= 1) {
+    const message = wireMessages[index];
+    if (!message || typeof message.id !== "string" || message.id.length === 0) continue;
+    fallback ?? (fallback = message.id);
+    if (!message.ephemeral) return message.id;
+  }
+  return fallback;
+}
+function viewedLeafId(messages) {
+  var _a;
+  for (let index = messages.length - 1; index >= 0; index -= 1) {
+    const message = messages[index];
+    if (message && ((_a = message.status) == null ? void 0 : _a.type) !== "running") return message.id;
+  }
+  return null;
+}
+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 chatOutboxWireMessage(entry) {
+  const files = (entry.files ?? []).map((file) => ({
+    type: "file",
+    mediaType: file.mediaType,
+    url: file.url,
+    ...file.filename !== void 0 && { filename: file.filename }
+  }));
+  return {
+    id: entry.id,
+    role: "user",
+    parts: [...files, ...entry.text.length > 0 ? [{ type: "text", text: entry.text }] : []]
+  };
+}
+function buildChatOutboxSendCommand({
+  entry,
+  messages,
+  wireMessages,
+  runId,
+  isRunning
+}) {
+  const message = chatOutboxWireMessage(entry);
+  if (isRunning && runId !== null) return { type: "run/enqueue", runId, message };
+  if (runId !== null) return { type: "run/steer", runId, message };
+  const runAnchorMessageId = wireMessages && wireMessages.length > 0 ? chatOutboxWireAnchorId(wireMessages) : viewedLeafId(messages);
+  return { type: "run/steer", runId: newRunId(), message, runAnchorMessageId };
+}
+function createStatewireChatOutboxPort({
+  client
+}) {
+  const state = () => {
+    var _a;
+    return ((_a = client()) == null ? void 0 : _a.thread().getState()) ?? null;
+  };
+  return {
+    readiness() {
+      var _a;
+      const current = state();
+      return current ? chatOutboxReadiness((_a = extrasOf(current)) == null ? void 0 : _a.connection) : "connecting";
+    },
+    heldIds() {
+      const current = state();
+      return current ? chatOutboxHeldIds(current) : /* @__PURE__ */ new Set();
+    },
+    send(entry) {
+      var _a, _b;
+      const current = state();
+      const extras = current ? extrasOf(current) : null;
+      if (!current || typeof (extras == null ? void 0 : extras.sendCommand) !== "function") {
+        return Promise.reject(new Error("The conversation is not ready to send."));
+      }
+      const runId = typeof ((_a = extras.runs) == null ? void 0 : _a.runId) === "string" ? extras.runs.runId : null;
+      const wireMessages = (_b = extras.state) == null ? void 0 : _b.messages;
+      const command = buildChatOutboxSendCommand({
+        entry,
+        messages: current.messages ?? [],
+        wireMessages: Array.isArray(wireMessages) ? wireMessages : null,
+        runId,
+        isRunning: extras.status === "running"
+      });
+      return extras.sendCommand(command, { preparedMetadata: Promise.resolve(entry.metadata) });
+    },
+    subscribe(listener) {
+      const current = client();
+      return current ? current.subscribe(listener) : () => void 0;
+    }
+  };
+}
+exports.buildChatOutboxSendCommand = buildChatOutboxSendCommand;
+exports.chatOutboxHeldIds = chatOutboxHeldIds;
+exports.chatOutboxReadiness = chatOutboxReadiness;
+exports.chatOutboxWireAnchorId = chatOutboxWireAnchorId;
+exports.chatOutboxWireMessage = chatOutboxWireMessage;
+exports.createStatewireChatOutboxPort = createStatewireChatOutboxPort;
+//# sourceMappingURL=chat-outbox-thread.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-outbox-thread.cjs","sources":["../../../../agent-runtime/src/chat-outbox-thread.ts"],"sourcesContent":["import type { ChatOutboxEntry } from \"./chat-outbox-store\";\nimport type { ChatOutboxThreadPort, ChatOutboxThreadReadiness } from \"./chat-outbox\";\n\n/**\n * The chat outbox's view of a statewire deep-agent thread (`chat-outbox.ts`): which message ids it\n * holds, whether a hand-off reaches it now, and the hand-off itself — the same `run/*` statement\n * the composer's own send makes, under the id the message was minted with when it was typed.\n */\n\n/** The imperative slice of an assistant-ui client the port reads (web and native `useAui` alike). */\nexport interface ChatOutboxClientHost {\n  thread: () => {\n    getState: () => {\n      extras?: unknown;\n      messages?: readonly { id: string; status?: { type: string } }[];\n    };\n  };\n  subscribe: (listener: () => void) => () => void;\n}\n\ntype WireFilePart = { type: \"file\"; mediaType: string; url: string; filename?: string };\ntype WireTextPart = { type: \"text\"; text: string };\n\n/** The wire message an outbox entry is sent as (react-statewire's `UserMessage`, structurally). */\nexport interface ChatOutboxWireMessage {\n  id: string;\n  role: \"user\";\n  parts: (WireFilePart | WireTextPart)[];\n  metadata?: Record<string, unknown>;\n}\n\nexport type ChatOutboxSendCommand =\n  | { type: \"run/enqueue\"; runId: string; message: ChatOutboxWireMessage }\n  | {\n      type: \"run/steer\";\n      runId: string;\n      message: ChatOutboxWireMessage;\n      runAnchorMessageId?: string | null;\n    };\n\ninterface RunsView {\n  runId?: unknown;\n  queue?: unknown;\n  steerQueue?: unknown;\n  failed?: unknown;\n  dispatching?: { messages?: unknown } | null;\n}\n\ninterface StatewireExtrasView {\n  runs?: RunsView;\n  /** The composed thread state: its `messages` are the raw wire messages of the loaded window. */\n  state?: { messages?: unknown } | null;\n  status?: unknown;\n  connection?: { status?: unknown; reason?: unknown; message?: unknown } | null;\n  sendCommand?: (command: unknown, options?: { preparedMetadata?: Promise<unknown> }) => Promise<unknown>;\n}\n\nfunction extrasOf(state: { extras?: unknown }): StatewireExtrasView | null {\n  const extras = state.extras;\n  return extras && typeof extras === \"object\" ? (extras as StatewireExtrasView) : null;\n}\n\nfunction idsOf(list: unknown, into: Set<string>): void {\n  if (!Array.isArray(list)) return;\n  for (const item of list) {\n    const id = (item as { id?: unknown } | null)?.id;\n    if (typeof id === \"string\") into.add(id);\n  }\n}\n\n/** The ids a statewire thread shows: transcript, lanes, the run being dispatched, failed sends. */\nexport function chatOutboxHeldIds(state: {\n  extras?: unknown;\n  messages?: readonly { id: string }[];\n}): Set<string> {\n  const held = new Set<string>();\n  for (const message of state.messages ?? []) held.add(message.id);\n  const runs = extrasOf(state)?.runs;\n  if (runs) {\n    idsOf(runs.queue, held);\n    idsOf(runs.steerQueue, held);\n    idsOf(runs.failed, held);\n    idsOf(runs.dispatching?.messages, held);\n  }\n  return held;\n}\n\n/** Whether a hand-off reaches the thread now, from its statewire connection. */\nexport function chatOutboxReadiness(connection: StatewireExtrasView[\"connection\"]): ChatOutboxThreadReadiness {\n  if (!connection) return \"connecting\";\n  switch (connection.status) {\n    case \"connected\":\n      return \"ready\";\n    case \"standby\":\n      // A never-started chat parks until its first send, and an idle channel reattaches on\n      // demand; a park with a stated reason is the suspended transport (an authorization denial,\n      // a host suspension), which never dials.\n      return connection.reason === \"deferred\" && typeof connection.message === \"string\"\n        ? \"refused\"\n        : \"ready\";\n    case \"stopped\":\n      return \"refused\";\n    default:\n      return \"connecting\";\n  }\n}\n\n/**\n * The anchor of a run a send mints, read from the raw wire messages the way the host computes its\n * own (`run_anchor_message_id`): the last durable message, else the trailing ephemeral one, else\n * none (an empty thread). The rendered messages do not line up with the host's transcript (an\n * assistant turn and its tool messages render as one message under the turn's first id, hidden\n * entries are dropped), so the raw list is what names the host's tail.\n */\nexport function chatOutboxWireAnchorId(wireMessages: readonly unknown[]): string | null {\n  let fallback: string | null = null;\n  for (let index = wireMessages.length - 1; index >= 0; index -= 1) {\n    const message = wireMessages[index] as { id?: unknown; ephemeral?: unknown } | null | undefined;\n    if (!message || typeof message.id !== \"string\" || message.id.length === 0) continue;\n    fallback ??= message.id;\n    if (!message.ephemeral) return message.id;\n  }\n  return fallback;\n}\n\n/** The last rendered message that is committed history (not a streaming answer). */\nfunction viewedLeafId(messages: readonly { id: string; status?: { type: string } }[]): string | null {\n  for (let index = messages.length - 1; index >= 0; index -= 1) {\n    const message = messages[index];\n    if (message && message.status?.type !== \"running\") return message.id;\n  }\n  return null;\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/** The wire message for an outbox entry: its files first, then one text part (react-statewire's shape). */\nexport function chatOutboxWireMessage(entry: ChatOutboxEntry): ChatOutboxWireMessage {\n  const files: WireFilePart[] = (entry.files ?? []).map((file) => ({\n    type: \"file\",\n    mediaType: file.mediaType,\n    url: file.url,\n    ...(file.filename !== undefined && { filename: file.filename }),\n  }));\n  return {\n    id: entry.id,\n    role: \"user\",\n    parts: [...files, ...(entry.text.length > 0 ? [{ type: \"text\" as const, text: entry.text }] : [])],\n  };\n}\n\n/**\n * The statement the composer's own send would make now (`composer.send({ steer: false })`): a\n * queued follow-up behind a live run, otherwise a send that starts a run, anchored at the host's\n * tail as the raw wire messages name it ({@link chatOutboxWireAnchorId}); without them (a surface\n * whose state is not replicated yet), at the last rendered message, as the composer anchors.\n */\nexport function buildChatOutboxSendCommand({\n  entry,\n  messages,\n  wireMessages,\n  runId,\n  isRunning,\n}: {\n  entry: ChatOutboxEntry;\n  messages: readonly { id: string; status?: { type: string } }[];\n  /** The raw wire messages of the loaded window (`extras.state.messages`), when replicated. */\n  wireMessages?: readonly unknown[] | null;\n  runId: string | null;\n  isRunning: boolean;\n}): ChatOutboxSendCommand {\n  const message = chatOutboxWireMessage(entry);\n  if (isRunning && runId !== null) return { type: \"run/enqueue\", runId, message };\n  if (runId !== null) return { type: \"run/steer\", runId, message };\n  const runAnchorMessageId =\n    wireMessages && wireMessages.length > 0 ? chatOutboxWireAnchorId(wireMessages) : viewedLeafId(messages);\n  return { type: \"run/steer\", runId: newRunId(), message, runAnchorMessageId };\n}\n\n/** A statewire thread, as the chat outbox's port. */\nexport function createStatewireChatOutboxPort({\n  client,\n}: {\n  /** Read on every call, so the port follows the host's current client. */\n  client: () => ChatOutboxClientHost | null;\n}): ChatOutboxThreadPort {\n  const state = () => client()?.thread().getState() ?? null;\n  return {\n    readiness() {\n      const current = state();\n      return current ? chatOutboxReadiness(extrasOf(current)?.connection) : \"connecting\";\n    },\n    heldIds() {\n      const current = state();\n      return current ? chatOutboxHeldIds(current) : new Set<string>();\n    },\n    send(entry) {\n      const current = state();\n      const extras = current ? extrasOf(current) : null;\n      if (!current || typeof extras?.sendCommand !== \"function\") {\n        return Promise.reject(new Error(\"The conversation is not ready to send.\"));\n      }\n      const runId = typeof extras.runs?.runId === \"string\" ? extras.runs.runId : null;\n      const wireMessages = extras.state?.messages;\n      const command = buildChatOutboxSendCommand({\n        entry,\n        messages: current.messages ?? [],\n        wireMessages: Array.isArray(wireMessages) ? wireMessages : null,\n        runId,\n        isRunning: extras.status === \"running\",\n      });\n      // The metadata frozen when the message was typed rides as prepared metadata, so the\n      // runtime's own capture (which reads what the composer staged for its next send) is not\n      // consumed by a message typed earlier.\n      return extras.sendCommand(command, { preparedMetadata: Promise.resolve(entry.metadata) });\n    },\n    subscribe(listener) {\n      const current = client();\n      return current ? current.subscribe(listener) : () => undefined;\n    },\n  };\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,118 @@
+import type { ChatOutboxEntry } from "./chat-outbox-store";
+import type { ChatOutboxThreadPort, ChatOutboxThreadReadiness } from "./chat-outbox";
+/**
+ * The chat outbox's view of a statewire deep-agent thread (`chat-outbox.ts`): which message ids it
+ * holds, whether a hand-off reaches it now, and the hand-off itself — the same `run/*` statement
+ * the composer's own send makes, under the id the message was minted with when it was typed.
+ */
+/** The imperative slice of an assistant-ui client the port reads (web and native `useAui` alike). */
+export interface ChatOutboxClientHost {
+    thread: () => {
+        getState: () => {
+            extras?: unknown;
+            messages?: readonly {
+                id: string;
+                status?: {
+                    type: string;
+                };
+            }[];
+        };
+    };
+    subscribe: (listener: () => void) => () => void;
+}
+type WireFilePart = {
+    type: "file";
+    mediaType: string;
+    url: string;
+    filename?: string;
+};
+type WireTextPart = {
+    type: "text";
+    text: string;
+};
+/** The wire message an outbox entry is sent as (react-statewire's `UserMessage`, structurally). */
+export interface ChatOutboxWireMessage {
+    id: string;
+    role: "user";
+    parts: (WireFilePart | WireTextPart)[];
+    metadata?: Record<string, unknown>;
+}
+export type ChatOutboxSendCommand = {
+    type: "run/enqueue";
+    runId: string;
+    message: ChatOutboxWireMessage;
+} | {
+    type: "run/steer";
+    runId: string;
+    message: ChatOutboxWireMessage;
+    runAnchorMessageId?: string | null;
+};
+interface RunsView {
+    runId?: unknown;
+    queue?: unknown;
+    steerQueue?: unknown;
+    failed?: unknown;
+    dispatching?: {
+        messages?: unknown;
+    } | null;
+}
+interface StatewireExtrasView {
+    runs?: RunsView;
+    /** The composed thread state: its `messages` are the raw wire messages of the loaded window. */
+    state?: {
+        messages?: unknown;
+    } | null;
+    status?: unknown;
+    connection?: {
+        status?: unknown;
+        reason?: unknown;
+        message?: unknown;
+    } | null;
+    sendCommand?: (command: unknown, options?: {
+        preparedMetadata?: Promise<unknown>;
+    }) => Promise<unknown>;
+}
+/** The ids a statewire thread shows: transcript, lanes, the run being dispatched, failed sends. */
+export declare function chatOutboxHeldIds(state: {
+    extras?: unknown;
+    messages?: readonly {
+        id: string;
+    }[];
+}): Set<string>;
+/** Whether a hand-off reaches the thread now, from its statewire connection. */
+export declare function chatOutboxReadiness(connection: StatewireExtrasView["connection"]): ChatOutboxThreadReadiness;
+/**
+ * The anchor of a run a send mints, read from the raw wire messages the way the host computes its
+ * own (`run_anchor_message_id`): the last durable message, else the trailing ephemeral one, else
+ * none (an empty thread). The rendered messages do not line up with the host's transcript (an
+ * assistant turn and its tool messages render as one message under the turn's first id, hidden
+ * entries are dropped), so the raw list is what names the host's tail.
+ */
+export declare function chatOutboxWireAnchorId(wireMessages: readonly unknown[]): string | null;
+/** The wire message for an outbox entry: its files first, then one text part (react-statewire's shape). */
+export declare function chatOutboxWireMessage(entry: ChatOutboxEntry): ChatOutboxWireMessage;
+/**
+ * The statement the composer's own send would make now (`composer.send({ steer: false })`): a
+ * queued follow-up behind a live run, otherwise a send that starts a run, anchored at the host's
+ * tail as the raw wire messages name it ({@link chatOutboxWireAnchorId}); without them (a surface
+ * whose state is not replicated yet), at the last rendered message, as the composer anchors.
+ */
+export declare function buildChatOutboxSendCommand({ entry, messages, wireMessages, runId, isRunning, }: {
+    entry: ChatOutboxEntry;
+    messages: readonly {
+        id: string;
+        status?: {
+            type: string;
+        };
+    }[];
+    /** The raw wire messages of the loaded window (`extras.state.messages`), when replicated. */
+    wireMessages?: readonly unknown[] | null;
+    runId: string | null;
+    isRunning: boolean;
+}): ChatOutboxSendCommand;
+/** A statewire thread, as the chat outbox's port. */
+export declare function createStatewireChatOutboxPort({ client, }: {
+    /** Read on every call, so the port follows the host's current client. */
+    client: () => ChatOutboxClientHost | null;
+}): ChatOutboxThreadPort;
+export {};

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

@@ -0,0 +1,136 @@
+function extrasOf(state) {
+  const extras = state.extras;
+  return extras && typeof extras === "object" ? extras : null;
+}
+function idsOf(list, into) {
+  if (!Array.isArray(list)) return;
+  for (const item of list) {
+    const id = item == null ? void 0 : item.id;
+    if (typeof id === "string") into.add(id);
+  }
+}
+function chatOutboxHeldIds(state) {
+  var _a, _b;
+  const held = /* @__PURE__ */ new Set();
+  for (const message of state.messages ?? []) held.add(message.id);
+  const runs = (_a = extrasOf(state)) == null ? void 0 : _a.runs;
+  if (runs) {
+    idsOf(runs.queue, held);
+    idsOf(runs.steerQueue, held);
+    idsOf(runs.failed, held);
+    idsOf((_b = runs.dispatching) == null ? void 0 : _b.messages, held);
+  }
+  return held;
+}
+function chatOutboxReadiness(connection) {
+  if (!connection) return "connecting";
+  switch (connection.status) {
+    case "connected":
+      return "ready";
+    case "standby":
+      return connection.reason === "deferred" && typeof connection.message === "string" ? "refused" : "ready";
+    case "stopped":
+      return "refused";
+    default:
+      return "connecting";
+  }
+}
+function chatOutboxWireAnchorId(wireMessages) {
+  let fallback = null;
+  for (let index = wireMessages.length - 1; index >= 0; index -= 1) {
+    const message = wireMessages[index];
+    if (!message || typeof message.id !== "string" || message.id.length === 0) continue;
+    fallback ?? (fallback = message.id);
+    if (!message.ephemeral) return message.id;
+  }
+  return fallback;
+}
+function viewedLeafId(messages) {
+  var _a;
+  for (let index = messages.length - 1; index >= 0; index -= 1) {
+    const message = messages[index];
+    if (message && ((_a = message.status) == null ? void 0 : _a.type) !== "running") return message.id;
+  }
+  return null;
+}
+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 chatOutboxWireMessage(entry) {
+  const files = (entry.files ?? []).map((file) => ({
+    type: "file",
+    mediaType: file.mediaType,
+    url: file.url,
+    ...file.filename !== void 0 && { filename: file.filename }
+  }));
+  return {
+    id: entry.id,
+    role: "user",
+    parts: [...files, ...entry.text.length > 0 ? [{ type: "text", text: entry.text }] : []]
+  };
+}
+function buildChatOutboxSendCommand({
+  entry,
+  messages,
+  wireMessages,
+  runId,
+  isRunning
+}) {
+  const message = chatOutboxWireMessage(entry);
+  if (isRunning && runId !== null) return { type: "run/enqueue", runId, message };
+  if (runId !== null) return { type: "run/steer", runId, message };
+  const runAnchorMessageId = wireMessages && wireMessages.length > 0 ? chatOutboxWireAnchorId(wireMessages) : viewedLeafId(messages);
+  return { type: "run/steer", runId: newRunId(), message, runAnchorMessageId };
+}
+function createStatewireChatOutboxPort({
+  client
+}) {
+  const state = () => {
+    var _a;
+    return ((_a = client()) == null ? void 0 : _a.thread().getState()) ?? null;
+  };
+  return {
+    readiness() {
+      var _a;
+      const current = state();
+      return current ? chatOutboxReadiness((_a = extrasOf(current)) == null ? void 0 : _a.connection) : "connecting";
+    },
+    heldIds() {
+      const current = state();
+      return current ? chatOutboxHeldIds(current) : /* @__PURE__ */ new Set();
+    },
+    send(entry) {
+      var _a, _b;
+      const current = state();
+      const extras = current ? extrasOf(current) : null;
+      if (!current || typeof (extras == null ? void 0 : extras.sendCommand) !== "function") {
+        return Promise.reject(new Error("The conversation is not ready to send."));
+      }
+      const runId = typeof ((_a = extras.runs) == null ? void 0 : _a.runId) === "string" ? extras.runs.runId : null;
+      const wireMessages = (_b = extras.state) == null ? void 0 : _b.messages;
+      const command = buildChatOutboxSendCommand({
+        entry,
+        messages: current.messages ?? [],
+        wireMessages: Array.isArray(wireMessages) ? wireMessages : null,
+        runId,
+        isRunning: extras.status === "running"
+      });
+      return extras.sendCommand(command, { preparedMetadata: Promise.resolve(entry.metadata) });
+    },
+    subscribe(listener) {
+      const current = client();
+      return current ? current.subscribe(listener) : () => void 0;
+    }
+  };
+}
+export {
+  buildChatOutboxSendCommand,
+  chatOutboxHeldIds,
+  chatOutboxReadiness,
+  chatOutboxWireAnchorId,
+  chatOutboxWireMessage,
+  createStatewireChatOutboxPort
+};
+//# sourceMappingURL=chat-outbox-thread.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-outbox-thread.js","sources":["../../../../agent-runtime/src/chat-outbox-thread.ts"],"sourcesContent":["import type { ChatOutboxEntry } from \"./chat-outbox-store\";\nimport type { ChatOutboxThreadPort, ChatOutboxThreadReadiness } from \"./chat-outbox\";\n\n/**\n * The chat outbox's view of a statewire deep-agent thread (`chat-outbox.ts`): which message ids it\n * holds, whether a hand-off reaches it now, and the hand-off itself — the same `run/*` statement\n * the composer's own send makes, under the id the message was minted with when it was typed.\n */\n\n/** The imperative slice of an assistant-ui client the port reads (web and native `useAui` alike). */\nexport interface ChatOutboxClientHost {\n  thread: () => {\n    getState: () => {\n      extras?: unknown;\n      messages?: readonly { id: string; status?: { type: string } }[];\n    };\n  };\n  subscribe: (listener: () => void) => () => void;\n}\n\ntype WireFilePart = { type: \"file\"; mediaType: string; url: string; filename?: string };\ntype WireTextPart = { type: \"text\"; text: string };\n\n/** The wire message an outbox entry is sent as (react-statewire's `UserMessage`, structurally). */\nexport interface ChatOutboxWireMessage {\n  id: string;\n  role: \"user\";\n  parts: (WireFilePart | WireTextPart)[];\n  metadata?: Record<string, unknown>;\n}\n\nexport type ChatOutboxSendCommand =\n  | { type: \"run/enqueue\"; runId: string; message: ChatOutboxWireMessage }\n  | {\n      type: \"run/steer\";\n      runId: string;\n      message: ChatOutboxWireMessage;\n      runAnchorMessageId?: string | null;\n    };\n\ninterface RunsView {\n  runId?: unknown;\n  queue?: unknown;\n  steerQueue?: unknown;\n  failed?: unknown;\n  dispatching?: { messages?: unknown } | null;\n}\n\ninterface StatewireExtrasView {\n  runs?: RunsView;\n  /** The composed thread state: its `messages` are the raw wire messages of the loaded window. */\n  state?: { messages?: unknown } | null;\n  status?: unknown;\n  connection?: { status?: unknown; reason?: unknown; message?: unknown } | null;\n  sendCommand?: (command: unknown, options?: { preparedMetadata?: Promise<unknown> }) => Promise<unknown>;\n}\n\nfunction extrasOf(state: { extras?: unknown }): StatewireExtrasView | null {\n  const extras = state.extras;\n  return extras && typeof extras === \"object\" ? (extras as StatewireExtrasView) : null;\n}\n\nfunction idsOf(list: unknown, into: Set<string>): void {\n  if (!Array.isArray(list)) return;\n  for (const item of list) {\n    const id = (item as { id?: unknown } | null)?.id;\n    if (typeof id === \"string\") into.add(id);\n  }\n}\n\n/** The ids a statewire thread shows: transcript, lanes, the run being dispatched, failed sends. */\nexport function chatOutboxHeldIds(state: {\n  extras?: unknown;\n  messages?: readonly { id: string }[];\n}): Set<string> {\n  const held = new Set<string>();\n  for (const message of state.messages ?? []) held.add(message.id);\n  const runs = extrasOf(state)?.runs;\n  if (runs) {\n    idsOf(runs.queue, held);\n    idsOf(runs.steerQueue, held);\n    idsOf(runs.failed, held);\n    idsOf(runs.dispatching?.messages, held);\n  }\n  return held;\n}\n\n/** Whether a hand-off reaches the thread now, from its statewire connection. */\nexport function chatOutboxReadiness(connection: StatewireExtrasView[\"connection\"]): ChatOutboxThreadReadiness {\n  if (!connection) return \"connecting\";\n  switch (connection.status) {\n    case \"connected\":\n      return \"ready\";\n    case \"standby\":\n      // A never-started chat parks until its first send, and an idle channel reattaches on\n      // demand; a park with a stated reason is the suspended transport (an authorization denial,\n      // a host suspension), which never dials.\n      return connection.reason === \"deferred\" && typeof connection.message === \"string\"\n        ? \"refused\"\n        : \"ready\";\n    case \"stopped\":\n      return \"refused\";\n    default:\n      return \"connecting\";\n  }\n}\n\n/**\n * The anchor of a run a send mints, read from the raw wire messages the way the host computes its\n * own (`run_anchor_message_id`): the last durable message, else the trailing ephemeral one, else\n * none (an empty thread). The rendered messages do not line up with the host's transcript (an\n * assistant turn and its tool messages render as one message under the turn's first id, hidden\n * entries are dropped), so the raw list is what names the host's tail.\n */\nexport function chatOutboxWireAnchorId(wireMessages: readonly unknown[]): string | null {\n  let fallback: string | null = null;\n  for (let index = wireMessages.length - 1; index >= 0; index -= 1) {\n    const message = wireMessages[index] as { id?: unknown; ephemeral?: unknown } | null | undefined;\n    if (!message || typeof message.id !== \"string\" || message.id.length === 0) continue;\n    fallback ??= message.id;\n    if (!message.ephemeral) return message.id;\n  }\n  return fallback;\n}\n\n/** The last rendered message that is committed history (not a streaming answer). */\nfunction viewedLeafId(messages: readonly { id: string; status?: { type: string } }[]): string | null {\n  for (let index = messages.length - 1; index >= 0; index -= 1) {\n    const message = messages[index];\n    if (message && message.status?.type !== \"running\") return message.id;\n  }\n  return null;\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/** The wire message for an outbox entry: its files first, then one text part (react-statewire's shape). */\nexport function chatOutboxWireMessage(entry: ChatOutboxEntry): ChatOutboxWireMessage {\n  const files: WireFilePart[] = (entry.files ?? []).map((file) => ({\n    type: \"file\",\n    mediaType: file.mediaType,\n    url: file.url,\n    ...(file.filename !== undefined && { filename: file.filename }),\n  }));\n  return {\n    id: entry.id,\n    role: \"user\",\n    parts: [...files, ...(entry.text.length > 0 ? [{ type: \"text\" as const, text: entry.text }] : [])],\n  };\n}\n\n/**\n * The statement the composer's own send would make now (`composer.send({ steer: false })`): a\n * queued follow-up behind a live run, otherwise a send that starts a run, anchored at the host's\n * tail as the raw wire messages name it ({@link chatOutboxWireAnchorId}); without them (a surface\n * whose state is not replicated yet), at the last rendered message, as the composer anchors.\n */\nexport function buildChatOutboxSendCommand({\n  entry,\n  messages,\n  wireMessages,\n  runId,\n  isRunning,\n}: {\n  entry: ChatOutboxEntry;\n  messages: readonly { id: string; status?: { type: string } }[];\n  /** The raw wire messages of the loaded window (`extras.state.messages`), when replicated. */\n  wireMessages?: readonly unknown[] | null;\n  runId: string | null;\n  isRunning: boolean;\n}): ChatOutboxSendCommand {\n  const message = chatOutboxWireMessage(entry);\n  if (isRunning && runId !== null) return { type: \"run/enqueue\", runId, message };\n  if (runId !== null) return { type: \"run/steer\", runId, message };\n  const runAnchorMessageId =\n    wireMessages && wireMessages.length > 0 ? chatOutboxWireAnchorId(wireMessages) : viewedLeafId(messages);\n  return { type: \"run/steer\", runId: newRunId(), message, runAnchorMessageId };\n}\n\n/** A statewire thread, as the chat outbox's port. */\nexport function createStatewireChatOutboxPort({\n  client,\n}: {\n  /** Read on every call, so the port follows the host's current client. */\n  client: () => ChatOutboxClientHost | null;\n}): ChatOutboxThreadPort {\n  const state = () => client()?.thread().getState() ?? null;\n  return {\n    readiness() {\n      const current = state();\n      return current ? chatOutboxReadiness(extrasOf(current)?.connection) : \"connecting\";\n    },\n    heldIds() {\n      const current = state();\n      return current ? chatOutboxHeldIds(current) : new Set<string>();\n    },\n    send(entry) {\n      const current = state();\n      const extras = current ? extrasOf(current) : null;\n      if (!current || typeof extras?.sendCommand !== \"function\") {\n        return Promise.reject(new Error(\"The conversation is not ready to send.\"));\n      }\n      const runId = typeof extras.runs?.runId === \"string\" ? extras.runs.runId : null;\n      const wireMessages = extras.state?.messages;\n      const command = buildChatOutboxSendCommand({\n        entry,\n        messages: current.messages ?? [],\n        wireMessages: Array.isArray(wireMessages) ? wireMessages : null,\n        runId,\n        isRunning: extras.status === \"running\",\n      });\n      // The metadata frozen when the message was typed rides as prepared metadata, so the\n      // runtime's own capture (which reads what the composer staged for its next send) is not\n      // consumed by a message typed earlier.\n      return extras.sendCommand(command, { preparedMetadata: Promise.resolve(entry.metadata) });\n    },\n    subscribe(listener) {\n      const current = client();\n      return current ? current.subscribe(listener) : () => undefined;\n    },\n  };\n}\n"],"names":[],"mappings":"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"}