@athenaintel/react 0.57.1 → 0.59.0

package/dist/agent-runtime/src/addressed-agents.cjs

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const ADDRESSED_AGENTS_METADATA_KEY = "addressedAgents";
+function withAddressedAgents(metadata, agents) {
+  if (agents === void 0) return metadata === void 0 ? void 0 : { ...metadata };
+  return { ...metadata, [ADDRESSED_AGENTS_METADATA_KEY]: [...agents] };
+}
+function readAddressedAgents(metadata) {
+  if (typeof metadata !== "object" || metadata === null) return void 0;
+  const value = metadata[ADDRESSED_AGENTS_METADATA_KEY];
+  return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : void 0;
+}
+exports.ADDRESSED_AGENTS_METADATA_KEY = ADDRESSED_AGENTS_METADATA_KEY;
+exports.readAddressedAgents = readAddressedAgents;
+exports.withAddressedAgents = withAddressedAgents;
+//# sourceMappingURL=addressed-agents.cjs.map

package/dist/agent-runtime/src/addressed-agents.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressed-agents.cjs","sources":["../../../../agent-runtime/src/addressed-agents.ts"],"sourcesContent":["/**\n * The agents a message names, carried on the message itself (`message.metadata.addressedAgents`).\n *\n * agora reads a message's own list ahead of the run config's (`agent_refs.py`,\n * `ADDRESSED_AGENTS_METADATA_KEY`), so every message keeps the agents it was typed with: a send that\n * waits in the outbox, is retried, or is posted again after a reload names its own agents, never\n * those of whatever the conversation's ambient context says at the time. The list is a host's agent\n * refs (`collab_agent:<asset id>`, `assistant`, `assistant:<principal id>`), in the order they\n * answer; `[]` names none. agora checks every ref; the client never gates on them.\n */\n\n/** The message metadata key agora reads a message's agents from. */\nexport const ADDRESSED_AGENTS_METADATA_KEY = \"addressedAgents\";\n\n/** The most agents one message may name (agora's `MAX_ADDRESSED_AGENTS`). */\nexport const MAX_ADDRESSED_AGENTS = 8;\n\n/** `metadata` with the message's agents set; `agents` `undefined` leaves the key out. */\nexport function withAddressedAgents(\n  metadata: Readonly<Record<string, unknown>> | undefined,\n  agents: readonly string[] | undefined,\n): Record<string, unknown> | undefined {\n  if (agents === undefined) return metadata === undefined ? undefined : { ...metadata };\n  return { ...metadata, [ADDRESSED_AGENTS_METADATA_KEY]: [...agents] };\n}\n\n/** The agents a message's metadata names, or `undefined` when it names none of its own. */\nexport function readAddressedAgents(metadata: unknown): readonly string[] | undefined {\n  if (typeof metadata !== \"object\" || metadata === null) return undefined;\n  const value = (metadata as Record<string, unknown>)[ADDRESSED_AGENTS_METADATA_KEY];\n  return Array.isArray(value) && value.every((item) => typeof item === \"string\") ? value : undefined;\n}\n\ntype MessageMetadataGetter = () =>\n  | Record<string, unknown>\n  | undefined\n  | Promise<Record<string, unknown> | undefined>;\n\n/**\n * A runtime's `getMessageMetadata` (`useDeepAgentThread`) that puts the agents the composer names\n * on every message it submits, on top of the host's own metadata. `agents` is read synchronously\n * at submission (the composer's chips as they are when Send is pressed); `undefined` leaves the\n * message without a list of its own.\n */\nexport function withAddressedAgentsMetadata({\n  agents,\n  getMessageMetadata,\n}: {\n  agents: () => readonly string[] | undefined;\n  getMessageMetadata?: MessageMetadataGetter | undefined;\n}): MessageMetadataGetter {\n  return () => {\n    const named = agents();\n    const captured = getMessageMetadata?.();\n    if (named === undefined) return captured;\n    const merge = (host: Record<string, unknown> | undefined) => withAddressedAgents(host, named);\n    return captured instanceof Promise ? captured.then(merge) : merge(captured);\n  };\n}\n"],"names":[],"mappings":";;AAYO,MAAM,gCAAgC;AAMtC,SAAS,oBACd,UACA,QACqC;AACrC,MAAI,WAAW,OAAW,QAAO,aAAa,SAAY,SAAY,EAAE,GAAG,SAAA;AAC3E,SAAO,EAAE,GAAG,UAAU,CAAC,6BAA6B,GAAG,CAAC,GAAG,MAAM,EAAA;AACnE;AAGO,SAAS,oBAAoB,UAAkD;AACpF,MAAI,OAAO,aAAa,YAAY,aAAa,KAAM,QAAO;AAC9D,QAAM,QAAS,SAAqC,6BAA6B;AACjF,SAAO,MAAM,QAAQ,KAAK,KAAK,MAAM,MAAM,CAAC,SAAS,OAAO,SAAS,QAAQ,IAAI,QAAQ;AAC3F;;;;"}

package/dist/agent-runtime/src/addressed-agents.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The agents a message names, carried on the message itself (`message.metadata.addressedAgents`).
+ *
+ * agora reads a message's own list ahead of the run config's (`agent_refs.py`,
+ * `ADDRESSED_AGENTS_METADATA_KEY`), so every message keeps the agents it was typed with: a send that
+ * waits in the outbox, is retried, or is posted again after a reload names its own agents, never
+ * those of whatever the conversation's ambient context says at the time. The list is a host's agent
+ * refs (`collab_agent:<asset id>`, `assistant`, `assistant:<principal id>`), in the order they
+ * answer; `[]` names none. agora checks every ref; the client never gates on them.
+ */
+/** The message metadata key agora reads a message's agents from. */
+export declare const ADDRESSED_AGENTS_METADATA_KEY = "addressedAgents";
+/** The most agents one message may name (agora's `MAX_ADDRESSED_AGENTS`). */
+export declare const MAX_ADDRESSED_AGENTS = 8;
+/** `metadata` with the message's agents set; `agents` `undefined` leaves the key out. */
+export declare function withAddressedAgents(metadata: Readonly<Record<string, unknown>> | undefined, agents: readonly string[] | undefined): Record<string, unknown> | undefined;
+/** The agents a message's metadata names, or `undefined` when it names none of its own. */
+export declare function readAddressedAgents(metadata: unknown): readonly string[] | undefined;
+type MessageMetadataGetter = () => Record<string, unknown> | undefined | Promise<Record<string, unknown> | undefined>;
+/**
+ * A runtime's `getMessageMetadata` (`useDeepAgentThread`) that puts the agents the composer names
+ * on every message it submits, on top of the host's own metadata. `agents` is read synchronously
+ * at submission (the composer's chips as they are when Send is pressed); `undefined` leaves the
+ * message without a list of its own.
+ */
+export declare function withAddressedAgentsMetadata({ agents, getMessageMetadata, }: {
+    agents: () => readonly string[] | undefined;
+    getMessageMetadata?: MessageMetadataGetter | undefined;
+}): MessageMetadataGetter;
+export {};

package/dist/agent-runtime/src/addressed-agents.js

@@ -0,0 +1,16 @@
+const ADDRESSED_AGENTS_METADATA_KEY = "addressedAgents";
+function withAddressedAgents(metadata, agents) {
+  if (agents === void 0) return metadata === void 0 ? void 0 : { ...metadata };
+  return { ...metadata, [ADDRESSED_AGENTS_METADATA_KEY]: [...agents] };
+}
+function readAddressedAgents(metadata) {
+  if (typeof metadata !== "object" || metadata === null) return void 0;
+  const value = metadata[ADDRESSED_AGENTS_METADATA_KEY];
+  return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : void 0;
+}
+export {
+  ADDRESSED_AGENTS_METADATA_KEY,
+  readAddressedAgents,
+  withAddressedAgents
+};
+//# sourceMappingURL=addressed-agents.js.map

package/dist/agent-runtime/src/addressed-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressed-agents.js","sources":["../../../../agent-runtime/src/addressed-agents.ts"],"sourcesContent":["/**\n * The agents a message names, carried on the message itself (`message.metadata.addressedAgents`).\n *\n * agora reads a message's own list ahead of the run config's (`agent_refs.py`,\n * `ADDRESSED_AGENTS_METADATA_KEY`), so every message keeps the agents it was typed with: a send that\n * waits in the outbox, is retried, or is posted again after a reload names its own agents, never\n * those of whatever the conversation's ambient context says at the time. The list is a host's agent\n * refs (`collab_agent:<asset id>`, `assistant`, `assistant:<principal id>`), in the order they\n * answer; `[]` names none. agora checks every ref; the client never gates on them.\n */\n\n/** The message metadata key agora reads a message's agents from. */\nexport const ADDRESSED_AGENTS_METADATA_KEY = \"addressedAgents\";\n\n/** The most agents one message may name (agora's `MAX_ADDRESSED_AGENTS`). */\nexport const MAX_ADDRESSED_AGENTS = 8;\n\n/** `metadata` with the message's agents set; `agents` `undefined` leaves the key out. */\nexport function withAddressedAgents(\n  metadata: Readonly<Record<string, unknown>> | undefined,\n  agents: readonly string[] | undefined,\n): Record<string, unknown> | undefined {\n  if (agents === undefined) return metadata === undefined ? undefined : { ...metadata };\n  return { ...metadata, [ADDRESSED_AGENTS_METADATA_KEY]: [...agents] };\n}\n\n/** The agents a message's metadata names, or `undefined` when it names none of its own. */\nexport function readAddressedAgents(metadata: unknown): readonly string[] | undefined {\n  if (typeof metadata !== \"object\" || metadata === null) return undefined;\n  const value = (metadata as Record<string, unknown>)[ADDRESSED_AGENTS_METADATA_KEY];\n  return Array.isArray(value) && value.every((item) => typeof item === \"string\") ? value : undefined;\n}\n\ntype MessageMetadataGetter = () =>\n  | Record<string, unknown>\n  | undefined\n  | Promise<Record<string, unknown> | undefined>;\n\n/**\n * A runtime's `getMessageMetadata` (`useDeepAgentThread`) that puts the agents the composer names\n * on every message it submits, on top of the host's own metadata. `agents` is read synchronously\n * at submission (the composer's chips as they are when Send is pressed); `undefined` leaves the\n * message without a list of its own.\n */\nexport function withAddressedAgentsMetadata({\n  agents,\n  getMessageMetadata,\n}: {\n  agents: () => readonly string[] | undefined;\n  getMessageMetadata?: MessageMetadataGetter | undefined;\n}): MessageMetadataGetter {\n  return () => {\n    const named = agents();\n    const captured = getMessageMetadata?.();\n    if (named === undefined) return captured;\n    const merge = (host: Record<string, unknown> | undefined) => withAddressedAgents(host, named);\n    return captured instanceof Promise ? captured.then(merge) : merge(captured);\n  };\n}\n"],"names":[],"mappings":"AAYO,MAAM,gCAAgC;AAMtC,SAAS,oBACd,UACA,QACqC;AACrC,MAAI,WAAW,OAAW,QAAO,aAAa,SAAY,SAAY,EAAE,GAAG,SAAA;AAC3E,SAAO,EAAE,GAAG,UAAU,CAAC,6BAA6B,GAAG,CAAC,GAAG,MAAM,EAAA;AACnE;AAGO,SAAS,oBAAoB,UAAkD;AACpF,MAAI,OAAO,aAAa,YAAY,aAAa,KAAM,QAAO;AAC9D,QAAM,QAAS,SAAqC,6BAA6B;AACjF,SAAO,MAAM,QAAQ,KAAK,KAAK,MAAM,MAAM,CAAC,SAAS,OAAO,SAAS,QAAQ,IAAI,QAAQ;AAC3F;"}

package/dist/agent-runtime/src/answer-label.cjs

@@ -86,14 +86,15 @@ function showsAnswerLabel({
   answers,
   threadShowsLabels,
   viewerId,
-  labelsOtherAgents = false
+  labelsOtherAgents = false,
+  conversationAgent = null
 }) {
   if (answers.length === 0) return false;
   if (threadShowsLabels) return true;
   if (viewerId === null) return false;
   if (labelsOtherAgents) {
-    const ownAssistant = `${ASSISTANT_AGENT_PREFIX}${viewerId}`;
-    if (answers.some((answer) => answer.agent !== ownAssistant)) return true;
+    const expected = conversationAgent ?? `${ASSISTANT_AGENT_PREFIX}${viewerId}`;
+    if (answers.some((answer) => answer.agent !== expected)) return true;
   }
   return answers.some((answer) => isPersonPrincipal(answer.for_id) && answer.for_id !== viewerId);
 }

package/dist/agent-runtime/src/answer-label.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"answer-label.cjs","sources":["../../../../agent-runtime/src/answer-label.ts"],"sourcesContent":["import { getExternalStoreMessages, type ThreadMessage } from '@assistant-ui/core';\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\n\n/**\n * `metadata.custom` key naming the agent that answered an AI message and whom\n * its run worked for (identity v7 D13: \"each answer is labelled with its\n * agent, 'for <author>'\").\n *\n * The backend stamps it on every answer a deep-agent run's model produces\n * (`agora/.../conversation_agents/answer_label.py`), under the\n * `additional_kwargs.metadata` bag the converter exposes as\n * `message.metadata.custom`, and mirrors it onto the live wire once the\n * model's turn lands. Only the server writes it. Answers written before the\n * stamp existed carry none, and get no label.\n */\nexport const ATHENA_ANSWERED_BY_KEY = 'answered_by';\n\n/** The agent that answered and whom its run worked for, as the backend stamps them. */\nexport interface DeepAgentAnsweredBy {\n  /** `collab_agent:<asset id>` for a team agent, `assistant:<principal id>` for someone's own assistant. */\n  agent: string;\n  /** The collab agent's name when it answered; `null` for an assistant, which clients name. */\n  agent_name: string | null;\n  /** Whom the run worked for: a person (`user_…`), an agent's or automation's own run, or nobody (`null`). */\n  for_id: string | null;\n  /** That person's display name when it answered, else `null`. */\n  for_name: string | null;\n}\n\n/** What a label calls someone's own assistant: the managed default agent's product name. */\nexport const ATHENA_ASSISTANT_NAME = 'Athena';\n\nconst ASSISTANT_AGENT_PREFIX = 'assistant:';\nconst PERSON_PRINCIPAL_PREFIX = 'user_';\nconst UNNAMED_AGENT_NAME = 'Agent';\nconst LABEL_SEPARATOR = ' · ';\nconst NO_ANSWERS: readonly DeepAgentAnsweredBy[] = Object.freeze([]);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst optionalId = (value: unknown): string | null =>\n  typeof value === 'string' && value.length > 0 ? value : null;\n\nconst optionalName = (value: unknown): string | null => {\n  if (typeof value !== 'string') return null;\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n};\n\n/**\n * Parse an `answered_by` stamp off a wire value.\n *\n * A stamp without a string `agent` is no stamp at all; absent or malformed\n * optional fields read as `null`, so a partly malformed stamp still names its\n * agent and never names a person it can't.\n */\nexport function readAnsweredBy(value: unknown): DeepAgentAnsweredBy | null {\n  if (!isRecord(value)) return null;\n  const agent = optionalId(value.agent);\n  if (agent === null) return null;\n  return {\n    agent,\n    agent_name: optionalName(value.agent_name),\n    for_id: optionalId(value.for_id),\n    for_name: optionalName(value.for_name),\n  };\n}\n\n/**\n * The run id an answer's row carries when the deep-agent conversion split a\n * turn several answerers wrote into one row per answerer (`answer-rows.ts`):\n * one per agent and principal.\n */\nconst ANSWER_ROW_RUN_ID_PREFIX = 'answered_by:';\n\n/** The row run id of an answer by `agent` for `forId` (see `withAnswerRows`). */\nexport function answerRowRunId(agent: string, forId: string | null): string {\n  return `${ANSWER_ROW_RUN_ID_PREFIX}${agent}|${forId ?? ''}`;\n}\n\n/**\n * Whether a converted row is one of a turn the conversion split by answerer.\n * Reads `metadata` optionally, as `collectMessageAnswers` does: a message\n * another runtime (or a test) builds may carry none.\n */\nfunction isSplitAnswerRow(message: ThreadMessage): boolean {\n  const runId = message.role === 'assistant' ? message.metadata?.runId : undefined;\n  return typeof runId === 'string' && runId.startsWith(ANSWER_ROW_RUN_ID_PREFIX);\n}\n\nconst isSameAnswerer = (a: DeepAgentAnsweredBy, b: DeepAgentAnsweredBy): boolean =>\n  a.agent === b.agent && a.for_id === b.for_id;\n\nconst isPersonPrincipal = (id: string | null): id is string =>\n  id !== null && id.startsWith(PERSON_PRINCIPAL_PREFIX);\n\n/** The `answered_by` stamp an AI message as the wire carries it holds; `null` for any other message. */\nexport function readLangChainAnswer(\n  source: LangChainMessage | undefined\n): DeepAgentAnsweredBy | null {\n  if (source?.type !== 'ai') return null;\n  const bag = source.additional_kwargs?.metadata;\n  return isRecord(bag) ? readAnsweredBy(bag[ATHENA_ANSWERED_BY_KEY]) : null;\n}\n\nfunction collectMessageAnswers(message: ThreadMessage): readonly DeepAgentAnsweredBy[] {\n  if (message.role !== 'assistant') return NO_ANSWERS;\n  const sources = getExternalStoreMessages<LangChainMessage>(message);\n  if (sources.length === 0) {\n    const joined = readAnsweredBy(message.metadata?.custom?.[ATHENA_ANSWERED_BY_KEY]);\n    return joined === null ? NO_ANSWERS : [joined];\n  }\n  let answers: DeepAgentAnsweredBy[] | null = null;\n  for (const source of sources) {\n    const answer = readLangChainAnswer(source);\n    if (answer === null || answers?.some((seen) => isSameAnswerer(seen, answer))) continue;\n    answers ??= [];\n    answers.push(answer);\n  }\n  return answers ?? NO_ANSWERS;\n}\n\nconst answersByMessage = new WeakMap<ThreadMessage, readonly DeepAgentAnsweredBy[]>();\n\n/**\n * The answers one thread message holds: each agent that answered in it and\n * whom it worked for, in the order they answered, one entry per agent and\n * principal.\n *\n * Read off the message's bound source messages, not its joined\n * `metadata.custom`: assistant-ui joins consecutive AI messages into one\n * turn, and its joined metadata keeps only the last stamp. The deep-agent\n * conversion gives each agent that answers one message in turn (D13 several\n * agents, one message) a row of its own (`answer-rows.ts`), so a row\n * normally holds one answer; a conversion without that split (another\n * pipeline, a stamp that never landed) still names every agent of the row.\n * A message with no bound sources (another runtime) falls back to the joined\n * value. Cached per message object: a settled message keeps its object\n * across a streamed token, so a thread-wide scan per token reads only the\n * message that changed.\n */\nexport function readMessageAnswers(message: ThreadMessage): readonly DeepAgentAnsweredBy[] {\n  const cached = answersByMessage.get(message);\n  if (cached !== undefined) return cached;\n  const answers = collectMessageAnswers(message);\n  answersByMessage.set(message, answers);\n  return answers;\n}\n\n/**\n * The thread-wide half of the label decision: whether the transcript's\n * answers name two or more agents, or two or more principals they worked\n * for. Then every answer is labelled; a 1:1 chat with one agent working for\n * one person looks as it did before labels. Unstamped answers count for\n * nothing.\n *\n * It decides over the messages the client holds (on a windowed wire, the\n * pages loaded so far), as the human-author avatars do: a page of older\n * history that brings another agent or person turns the labels on. Each\n * label still names its own answer's stamp, so loading history never changes\n * what an answer is attributed to, only whether the line shows.\n *\n * A turn the conversion split into one row per answerer turns the labels on\n * too, before the next agent's stamp lands: while several agents answer one\n * message, the host's record already says a second agent is answering, so\n * the first agent's answer is labelled from the moment the second one's row\n * appears.\n */\nexport function threadShowsAnswerLabels(messages: readonly ThreadMessage[]): boolean {\n  let first: DeepAgentAnsweredBy | null = null;\n  for (const message of messages) {\n    if (isSplitAnswerRow(message)) return true;\n    for (const answer of readMessageAnswers(message)) {\n      if (first === null) {\n        first = answer;\n      } else if (!isSameAnswerer(first, answer)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Whether a message's answers are labelled: always once the thread's answers\n * name several agents or principals (`threadShowsLabels`), and otherwise when\n * one of them worked for a person other than the viewer. With\n * `labelsOtherAgents`, also when one of them was written by any agent other\n * than the viewer's own assistant: a surface where the person names a team\n * agent for one message (Olympus's composer chips) shows who answered it even\n * in a 1:1 chat, where the answer would otherwise read as Athena's. Without a\n * known viewer both viewer rules are off, so a 1:1 chat never flashes labels\n * while the viewer loads.\n */\nexport function showsAnswerLabel({\n  answers,\n  threadShowsLabels,\n  viewerId,\n  labelsOtherAgents = false,\n}: {\n  answers: readonly DeepAgentAnsweredBy[];\n  threadShowsLabels: boolean;\n  viewerId: string | null;\n  /** Label an answer written by any agent other than the viewer's own assistant. */\n  labelsOtherAgents?: boolean;\n}): boolean {\n  if (answers.length === 0) return false;\n  if (threadShowsLabels) return true;\n  if (viewerId === null) return false;\n  if (labelsOtherAgents) {\n    const ownAssistant = `${ASSISTANT_AGENT_PREFIX}${viewerId}`;\n    if (answers.some((answer) => answer.agent !== ownAssistant)) return true;\n  }\n  return answers.some((answer) => isPersonPrincipal(answer.for_id) && answer.for_id !== viewerId);\n}\n\nfunction answererName(answer: DeepAgentAnsweredBy): string {\n  if (answer.agent_name !== null) return answer.agent_name;\n  return answer.agent.startsWith(ASSISTANT_AGENT_PREFIX)\n    ? ATHENA_ASSISTANT_NAME\n    : UNNAMED_AGENT_NAME;\n}\n\nfunction forWhomName(answer: DeepAgentAnsweredBy, viewerId: string | null): string | null {\n  if (answer.for_id !== null && answer.for_id === viewerId) return 'you';\n  if (answer.for_name !== null && isPersonPrincipal(answer.for_id)) return answer.for_name;\n  return null;\n}\n\nfunction joinNames(names: readonly string[]): string {\n  if (names.length <= 1) return names[0] ?? '';\n  return `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`;\n}\n\n/**\n * The label's words: who answered, then whom for. \"Finance · for you\",\n * \"Athena · for Priya Shah\", \"Finance\" (a run that worked for nobody, or for\n * an agent's own run). The agent is the collab agent's name, else\n * {@link ATHENA_ASSISTANT_NAME} for someone's own assistant, else \"Agent\".\n * Several agents answering for the same principal read \"Finance and Legal ·\n * for you\"; answers for different principals are listed apart, even when the\n * people share a name (\"Finance · for Alex, Legal · for Alex\"). `null` when\n * the message holds no answers.\n */\nexport function answerLabelText({\n  answers,\n  viewerId,\n}: {\n  answers: readonly DeepAgentAnsweredBy[];\n  viewerId: string | null;\n}): string | null {\n  if (answers.length === 0) return null;\n  // One group per principal (nobody is one too), never per displayed name: two\n  // people who share a name stay two recipients.\n  const groups: { forId: string | null; names: string[]; forWhom: string | null }[] = [];\n  for (const answer of answers) {\n    const name = answererName(answer);\n    const forWhom = forWhomName(answer, viewerId);\n    const group = groups.find((candidate) => candidate.forId === answer.for_id);\n    if (group === undefined) {\n      groups.push({ forId: answer.for_id, names: [name], forWhom });\n      continue;\n    }\n    if (!group.names.includes(name)) group.names.push(name);\n    // A recipient one answer left unnamed takes the name a later answer for\n    // the same principal carries. The first name found wins: answers stamped\n    // under two names for one id (a rename between runs) read as the first.\n    group.forWhom ??= forWhom;\n  }\n  return groups\n    .map(({ names, forWhom }) =>\n      forWhom === null ? joinNames(names) : `${joinNames(names)}${LABEL_SEPARATOR}for ${forWhom}`\n    )\n    .join(', ');\n}\n"],"names":["getExternalStoreMessages"],"mappings":"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"}
+{"version":3,"file":"answer-label.cjs","sources":["../../../../agent-runtime/src/answer-label.ts"],"sourcesContent":["import { getExternalStoreMessages, type ThreadMessage } from '@assistant-ui/core';\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\n\n/**\n * `metadata.custom` key naming the agent that answered an AI message and whom\n * its run worked for (identity v7 D13: \"each answer is labelled with its\n * agent, 'for <author>'\").\n *\n * The backend stamps it on every answer a deep-agent run's model produces\n * (`agora/.../conversation_agents/answer_label.py`), under the\n * `additional_kwargs.metadata` bag the converter exposes as\n * `message.metadata.custom`, and mirrors it onto the live wire once the\n * model's turn lands. Only the server writes it. Answers written before the\n * stamp existed carry none, and get no label.\n */\nexport const ATHENA_ANSWERED_BY_KEY = 'answered_by';\n\n/** The agent that answered and whom its run worked for, as the backend stamps them. */\nexport interface DeepAgentAnsweredBy {\n  /** `collab_agent:<asset id>` for a team agent, `assistant:<principal id>` for someone's own assistant. */\n  agent: string;\n  /** The collab agent's name when it answered; `null` for an assistant, which clients name. */\n  agent_name: string | null;\n  /** Whom the run worked for: a person (`user_…`), an agent's or automation's own run, or nobody (`null`). */\n  for_id: string | null;\n  /** That person's display name when it answered, else `null`. */\n  for_name: string | null;\n}\n\n/** What a label calls someone's own assistant: the managed default agent's product name. */\nexport const ATHENA_ASSISTANT_NAME = 'Athena';\n\nconst ASSISTANT_AGENT_PREFIX = 'assistant:';\nconst PERSON_PRINCIPAL_PREFIX = 'user_';\nconst UNNAMED_AGENT_NAME = 'Agent';\nconst LABEL_SEPARATOR = ' · ';\nconst NO_ANSWERS: readonly DeepAgentAnsweredBy[] = Object.freeze([]);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst optionalId = (value: unknown): string | null =>\n  typeof value === 'string' && value.length > 0 ? value : null;\n\nconst optionalName = (value: unknown): string | null => {\n  if (typeof value !== 'string') return null;\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n};\n\n/**\n * Parse an `answered_by` stamp off a wire value.\n *\n * A stamp without a string `agent` is no stamp at all; absent or malformed\n * optional fields read as `null`, so a partly malformed stamp still names its\n * agent and never names a person it can't.\n */\nexport function readAnsweredBy(value: unknown): DeepAgentAnsweredBy | null {\n  if (!isRecord(value)) return null;\n  const agent = optionalId(value.agent);\n  if (agent === null) return null;\n  return {\n    agent,\n    agent_name: optionalName(value.agent_name),\n    for_id: optionalId(value.for_id),\n    for_name: optionalName(value.for_name),\n  };\n}\n\n/**\n * The run id an answer's row carries when the deep-agent conversion split a\n * turn several answerers wrote into one row per answerer (`answer-rows.ts`):\n * one per agent and principal.\n */\nconst ANSWER_ROW_RUN_ID_PREFIX = 'answered_by:';\n\n/** The row run id of an answer by `agent` for `forId` (see `withAnswerRows`). */\nexport function answerRowRunId(agent: string, forId: string | null): string {\n  return `${ANSWER_ROW_RUN_ID_PREFIX}${agent}|${forId ?? ''}`;\n}\n\n/**\n * Whether a converted row is one of a turn the conversion split by answerer.\n * Reads `metadata` optionally, as `collectMessageAnswers` does: a message\n * another runtime (or a test) builds may carry none.\n */\nfunction isSplitAnswerRow(message: ThreadMessage): boolean {\n  const runId = message.role === 'assistant' ? message.metadata?.runId : undefined;\n  return typeof runId === 'string' && runId.startsWith(ANSWER_ROW_RUN_ID_PREFIX);\n}\n\nconst isSameAnswerer = (a: DeepAgentAnsweredBy, b: DeepAgentAnsweredBy): boolean =>\n  a.agent === b.agent && a.for_id === b.for_id;\n\nconst isPersonPrincipal = (id: string | null): id is string =>\n  id !== null && id.startsWith(PERSON_PRINCIPAL_PREFIX);\n\n/** The `answered_by` stamp an AI message as the wire carries it holds; `null` for any other message. */\nexport function readLangChainAnswer(\n  source: LangChainMessage | undefined\n): DeepAgentAnsweredBy | null {\n  if (source?.type !== 'ai') return null;\n  const bag = source.additional_kwargs?.metadata;\n  return isRecord(bag) ? readAnsweredBy(bag[ATHENA_ANSWERED_BY_KEY]) : null;\n}\n\nfunction collectMessageAnswers(message: ThreadMessage): readonly DeepAgentAnsweredBy[] {\n  if (message.role !== 'assistant') return NO_ANSWERS;\n  const sources = getExternalStoreMessages<LangChainMessage>(message);\n  if (sources.length === 0) {\n    const joined = readAnsweredBy(message.metadata?.custom?.[ATHENA_ANSWERED_BY_KEY]);\n    return joined === null ? NO_ANSWERS : [joined];\n  }\n  let answers: DeepAgentAnsweredBy[] | null = null;\n  for (const source of sources) {\n    const answer = readLangChainAnswer(source);\n    if (answer === null || answers?.some((seen) => isSameAnswerer(seen, answer))) continue;\n    answers ??= [];\n    answers.push(answer);\n  }\n  return answers ?? NO_ANSWERS;\n}\n\nconst answersByMessage = new WeakMap<ThreadMessage, readonly DeepAgentAnsweredBy[]>();\n\n/**\n * The answers one thread message holds: each agent that answered in it and\n * whom it worked for, in the order they answered, one entry per agent and\n * principal.\n *\n * Read off the message's bound source messages, not its joined\n * `metadata.custom`: assistant-ui joins consecutive AI messages into one\n * turn, and its joined metadata keeps only the last stamp. The deep-agent\n * conversion gives each agent that answers one message in turn (D13 several\n * agents, one message) a row of its own (`answer-rows.ts`), so a row\n * normally holds one answer; a conversion without that split (another\n * pipeline, a stamp that never landed) still names every agent of the row.\n * A message with no bound sources (another runtime) falls back to the joined\n * value. Cached per message object: a settled message keeps its object\n * across a streamed token, so a thread-wide scan per token reads only the\n * message that changed.\n */\nexport function readMessageAnswers(message: ThreadMessage): readonly DeepAgentAnsweredBy[] {\n  const cached = answersByMessage.get(message);\n  if (cached !== undefined) return cached;\n  const answers = collectMessageAnswers(message);\n  answersByMessage.set(message, answers);\n  return answers;\n}\n\n/**\n * The thread-wide half of the label decision: whether the transcript's\n * answers name two or more agents, or two or more principals they worked\n * for. Then every answer is labelled; a 1:1 chat with one agent working for\n * one person looks as it did before labels. Unstamped answers count for\n * nothing.\n *\n * It decides over the messages the client holds (on a windowed wire, the\n * pages loaded so far), as the human-author avatars do: a page of older\n * history that brings another agent or person turns the labels on. Each\n * label still names its own answer's stamp, so loading history never changes\n * what an answer is attributed to, only whether the line shows.\n *\n * A turn the conversion split into one row per answerer turns the labels on\n * too, before the next agent's stamp lands: while several agents answer one\n * message, the host's record already says a second agent is answering, so\n * the first agent's answer is labelled from the moment the second one's row\n * appears.\n */\nexport function threadShowsAnswerLabels(messages: readonly ThreadMessage[]): boolean {\n  let first: DeepAgentAnsweredBy | null = null;\n  for (const message of messages) {\n    if (isSplitAnswerRow(message)) return true;\n    for (const answer of readMessageAnswers(message)) {\n      if (first === null) {\n        first = answer;\n      } else if (!isSameAnswerer(first, answer)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Whether a message's answers are labelled: always once the thread's answers\n * name several agents or principals (`threadShowsLabels`), and otherwise when\n * one of them worked for a person other than the viewer. With\n * `labelsOtherAgents`, also when one of them was written by an agent other\n * than the conversation's own (`conversationAgent`, else the viewer's own\n * assistant): a surface where the person names a team agent for one message\n * (Olympus's composer chips) shows who answered it even in a 1:1 chat, where\n * the answer would otherwise read as the conversation agent's. A 1:1 chat with\n * the conversation's agent, a collab agent included, shows nothing. Without a\n * known viewer both viewer rules are off, so a 1:1 chat never flashes labels\n * while the viewer loads.\n */\nexport function showsAnswerLabel({\n  answers,\n  threadShowsLabels,\n  viewerId,\n  labelsOtherAgents = false,\n  conversationAgent = null,\n}: {\n  answers: readonly DeepAgentAnsweredBy[];\n  threadShowsLabels: boolean;\n  viewerId: string | null;\n  /** Label an answer written by any agent other than the conversation's own. */\n  labelsOtherAgents?: boolean;\n  /**\n   * The agent key the conversation is with (`collab_agent:<asset id>`, as its\n   * header shows it); `null` (the default) for the viewer's own assistant.\n   */\n  conversationAgent?: string | null;\n}): boolean {\n  if (answers.length === 0) return false;\n  if (threadShowsLabels) return true;\n  if (viewerId === null) return false;\n  if (labelsOtherAgents) {\n    const expected = conversationAgent ?? `${ASSISTANT_AGENT_PREFIX}${viewerId}`;\n    if (answers.some((answer) => answer.agent !== expected)) return true;\n  }\n  return answers.some((answer) => isPersonPrincipal(answer.for_id) && answer.for_id !== viewerId);\n}\n\nfunction answererName(answer: DeepAgentAnsweredBy): string {\n  if (answer.agent_name !== null) return answer.agent_name;\n  return answer.agent.startsWith(ASSISTANT_AGENT_PREFIX)\n    ? ATHENA_ASSISTANT_NAME\n    : UNNAMED_AGENT_NAME;\n}\n\nfunction forWhomName(answer: DeepAgentAnsweredBy, viewerId: string | null): string | null {\n  if (answer.for_id !== null && answer.for_id === viewerId) return 'you';\n  if (answer.for_name !== null && isPersonPrincipal(answer.for_id)) return answer.for_name;\n  return null;\n}\n\nfunction joinNames(names: readonly string[]): string {\n  if (names.length <= 1) return names[0] ?? '';\n  return `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`;\n}\n\n/**\n * The label's words: who answered, then whom for. \"Finance · for you\",\n * \"Athena · for Priya Shah\", \"Finance\" (a run that worked for nobody, or for\n * an agent's own run). The agent is the collab agent's name, else\n * {@link ATHENA_ASSISTANT_NAME} for someone's own assistant, else \"Agent\".\n * Several agents answering for the same principal read \"Finance and Legal ·\n * for you\"; answers for different principals are listed apart, even when the\n * people share a name (\"Finance · for Alex, Legal · for Alex\"). `null` when\n * the message holds no answers.\n */\nexport function answerLabelText({\n  answers,\n  viewerId,\n}: {\n  answers: readonly DeepAgentAnsweredBy[];\n  viewerId: string | null;\n}): string | null {\n  if (answers.length === 0) return null;\n  // One group per principal (nobody is one too), never per displayed name: two\n  // people who share a name stay two recipients.\n  const groups: { forId: string | null; names: string[]; forWhom: string | null }[] = [];\n  for (const answer of answers) {\n    const name = answererName(answer);\n    const forWhom = forWhomName(answer, viewerId);\n    const group = groups.find((candidate) => candidate.forId === answer.for_id);\n    if (group === undefined) {\n      groups.push({ forId: answer.for_id, names: [name], forWhom });\n      continue;\n    }\n    if (!group.names.includes(name)) group.names.push(name);\n    // A recipient one answer left unnamed takes the name a later answer for\n    // the same principal carries. The first name found wins: answers stamped\n    // under two names for one id (a rename between runs) read as the first.\n    group.forWhom ??= forWhom;\n  }\n  return groups\n    .map(({ names, forWhom }) =>\n      forWhom === null ? joinNames(names) : `${joinNames(names)}${LABEL_SEPARATOR}for ${forWhom}`\n    )\n    .join(', ');\n}\n"],"names":["getExternalStoreMessages"],"mappings":"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"}

package/dist/agent-runtime/src/answer-label.d.ts

@@ -80,19 +80,26 @@ export declare function threadShowsAnswerLabels(messages: readonly ThreadMessage
  * Whether a message's answers are labelled: always once the thread's answers
  * name several agents or principals (`threadShowsLabels`), and otherwise when
  * one of them worked for a person other than the viewer. With
- * `labelsOtherAgents`, also when one of them was written by any agent other
- * than the viewer's own assistant: a surface where the person names a team
- * agent for one message (Olympus's composer chips) shows who answered it even
- * in a 1:1 chat, where the answer would otherwise read as Athena's. Without a
+ * `labelsOtherAgents`, also when one of them was written by an agent other
+ * than the conversation's own (`conversationAgent`, else the viewer's own
+ * assistant): a surface where the person names a team agent for one message
+ * (Olympus's composer chips) shows who answered it even in a 1:1 chat, where
+ * the answer would otherwise read as the conversation agent's. A 1:1 chat with
+ * the conversation's agent, a collab agent included, shows nothing. Without a
  * known viewer both viewer rules are off, so a 1:1 chat never flashes labels
  * while the viewer loads.
  */
-export declare function showsAnswerLabel({ answers, threadShowsLabels, viewerId, labelsOtherAgents, }: {
+export declare function showsAnswerLabel({ answers, threadShowsLabels, viewerId, labelsOtherAgents, conversationAgent, }: {
     answers: readonly DeepAgentAnsweredBy[];
     threadShowsLabels: boolean;
     viewerId: string | null;
-    /** Label an answer written by any agent other than the viewer's own assistant. */
+    /** Label an answer written by any agent other than the conversation's own. */
     labelsOtherAgents?: boolean;
+    /**
+     * The agent key the conversation is with (`collab_agent:<asset id>`, as its
+     * header shows it); `null` (the default) for the viewer's own assistant.
+     */
+    conversationAgent?: string | null;
 }): boolean;
 /**
  * The label's words: who answered, then whom for. "Finance · for you",

package/dist/agent-runtime/src/answer-label.js

@@ -84,14 +84,15 @@ function showsAnswerLabel({
   answers,
   threadShowsLabels,
   viewerId,
-  labelsOtherAgents = false
+  labelsOtherAgents = false,
+  conversationAgent = null
 }) {
   if (answers.length === 0) return false;
   if (threadShowsLabels) return true;
   if (viewerId === null) return false;
   if (labelsOtherAgents) {
-    const ownAssistant = `${ASSISTANT_AGENT_PREFIX}${viewerId}`;
-    if (answers.some((answer) => answer.agent !== ownAssistant)) return true;
+    const expected = conversationAgent ?? `${ASSISTANT_AGENT_PREFIX}${viewerId}`;
+    if (answers.some((answer) => answer.agent !== expected)) return true;
   }
   return answers.some((answer) => isPersonPrincipal(answer.for_id) && answer.for_id !== viewerId);
 }

package/dist/agent-runtime/src/answer-label.js.map

@@ -1 +1 @@
-{"version":3,"file":"answer-label.js","sources":["../../../../agent-runtime/src/answer-label.ts"],"sourcesContent":["import { getExternalStoreMessages, type ThreadMessage } from '@assistant-ui/core';\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\n\n/**\n * `metadata.custom` key naming the agent that answered an AI message and whom\n * its run worked for (identity v7 D13: \"each answer is labelled with its\n * agent, 'for <author>'\").\n *\n * The backend stamps it on every answer a deep-agent run's model produces\n * (`agora/.../conversation_agents/answer_label.py`), under the\n * `additional_kwargs.metadata` bag the converter exposes as\n * `message.metadata.custom`, and mirrors it onto the live wire once the\n * model's turn lands. Only the server writes it. Answers written before the\n * stamp existed carry none, and get no label.\n */\nexport const ATHENA_ANSWERED_BY_KEY = 'answered_by';\n\n/** The agent that answered and whom its run worked for, as the backend stamps them. */\nexport interface DeepAgentAnsweredBy {\n  /** `collab_agent:<asset id>` for a team agent, `assistant:<principal id>` for someone's own assistant. */\n  agent: string;\n  /** The collab agent's name when it answered; `null` for an assistant, which clients name. */\n  agent_name: string | null;\n  /** Whom the run worked for: a person (`user_…`), an agent's or automation's own run, or nobody (`null`). */\n  for_id: string | null;\n  /** That person's display name when it answered, else `null`. */\n  for_name: string | null;\n}\n\n/** What a label calls someone's own assistant: the managed default agent's product name. */\nexport const ATHENA_ASSISTANT_NAME = 'Athena';\n\nconst ASSISTANT_AGENT_PREFIX = 'assistant:';\nconst PERSON_PRINCIPAL_PREFIX = 'user_';\nconst UNNAMED_AGENT_NAME = 'Agent';\nconst LABEL_SEPARATOR = ' · ';\nconst NO_ANSWERS: readonly DeepAgentAnsweredBy[] = Object.freeze([]);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst optionalId = (value: unknown): string | null =>\n  typeof value === 'string' && value.length > 0 ? value : null;\n\nconst optionalName = (value: unknown): string | null => {\n  if (typeof value !== 'string') return null;\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n};\n\n/**\n * Parse an `answered_by` stamp off a wire value.\n *\n * A stamp without a string `agent` is no stamp at all; absent or malformed\n * optional fields read as `null`, so a partly malformed stamp still names its\n * agent and never names a person it can't.\n */\nexport function readAnsweredBy(value: unknown): DeepAgentAnsweredBy | null {\n  if (!isRecord(value)) return null;\n  const agent = optionalId(value.agent);\n  if (agent === null) return null;\n  return {\n    agent,\n    agent_name: optionalName(value.agent_name),\n    for_id: optionalId(value.for_id),\n    for_name: optionalName(value.for_name),\n  };\n}\n\n/**\n * The run id an answer's row carries when the deep-agent conversion split a\n * turn several answerers wrote into one row per answerer (`answer-rows.ts`):\n * one per agent and principal.\n */\nconst ANSWER_ROW_RUN_ID_PREFIX = 'answered_by:';\n\n/** The row run id of an answer by `agent` for `forId` (see `withAnswerRows`). */\nexport function answerRowRunId(agent: string, forId: string | null): string {\n  return `${ANSWER_ROW_RUN_ID_PREFIX}${agent}|${forId ?? ''}`;\n}\n\n/**\n * Whether a converted row is one of a turn the conversion split by answerer.\n * Reads `metadata` optionally, as `collectMessageAnswers` does: a message\n * another runtime (or a test) builds may carry none.\n */\nfunction isSplitAnswerRow(message: ThreadMessage): boolean {\n  const runId = message.role === 'assistant' ? message.metadata?.runId : undefined;\n  return typeof runId === 'string' && runId.startsWith(ANSWER_ROW_RUN_ID_PREFIX);\n}\n\nconst isSameAnswerer = (a: DeepAgentAnsweredBy, b: DeepAgentAnsweredBy): boolean =>\n  a.agent === b.agent && a.for_id === b.for_id;\n\nconst isPersonPrincipal = (id: string | null): id is string =>\n  id !== null && id.startsWith(PERSON_PRINCIPAL_PREFIX);\n\n/** The `answered_by` stamp an AI message as the wire carries it holds; `null` for any other message. */\nexport function readLangChainAnswer(\n  source: LangChainMessage | undefined\n): DeepAgentAnsweredBy | null {\n  if (source?.type !== 'ai') return null;\n  const bag = source.additional_kwargs?.metadata;\n  return isRecord(bag) ? readAnsweredBy(bag[ATHENA_ANSWERED_BY_KEY]) : null;\n}\n\nfunction collectMessageAnswers(message: ThreadMessage): readonly DeepAgentAnsweredBy[] {\n  if (message.role !== 'assistant') return NO_ANSWERS;\n  const sources = getExternalStoreMessages<LangChainMessage>(message);\n  if (sources.length === 0) {\n    const joined = readAnsweredBy(message.metadata?.custom?.[ATHENA_ANSWERED_BY_KEY]);\n    return joined === null ? NO_ANSWERS : [joined];\n  }\n  let answers: DeepAgentAnsweredBy[] | null = null;\n  for (const source of sources) {\n    const answer = readLangChainAnswer(source);\n    if (answer === null || answers?.some((seen) => isSameAnswerer(seen, answer))) continue;\n    answers ??= [];\n    answers.push(answer);\n  }\n  return answers ?? NO_ANSWERS;\n}\n\nconst answersByMessage = new WeakMap<ThreadMessage, readonly DeepAgentAnsweredBy[]>();\n\n/**\n * The answers one thread message holds: each agent that answered in it and\n * whom it worked for, in the order they answered, one entry per agent and\n * principal.\n *\n * Read off the message's bound source messages, not its joined\n * `metadata.custom`: assistant-ui joins consecutive AI messages into one\n * turn, and its joined metadata keeps only the last stamp. The deep-agent\n * conversion gives each agent that answers one message in turn (D13 several\n * agents, one message) a row of its own (`answer-rows.ts`), so a row\n * normally holds one answer; a conversion without that split (another\n * pipeline, a stamp that never landed) still names every agent of the row.\n * A message with no bound sources (another runtime) falls back to the joined\n * value. Cached per message object: a settled message keeps its object\n * across a streamed token, so a thread-wide scan per token reads only the\n * message that changed.\n */\nexport function readMessageAnswers(message: ThreadMessage): readonly DeepAgentAnsweredBy[] {\n  const cached = answersByMessage.get(message);\n  if (cached !== undefined) return cached;\n  const answers = collectMessageAnswers(message);\n  answersByMessage.set(message, answers);\n  return answers;\n}\n\n/**\n * The thread-wide half of the label decision: whether the transcript's\n * answers name two or more agents, or two or more principals they worked\n * for. Then every answer is labelled; a 1:1 chat with one agent working for\n * one person looks as it did before labels. Unstamped answers count for\n * nothing.\n *\n * It decides over the messages the client holds (on a windowed wire, the\n * pages loaded so far), as the human-author avatars do: a page of older\n * history that brings another agent or person turns the labels on. Each\n * label still names its own answer's stamp, so loading history never changes\n * what an answer is attributed to, only whether the line shows.\n *\n * A turn the conversion split into one row per answerer turns the labels on\n * too, before the next agent's stamp lands: while several agents answer one\n * message, the host's record already says a second agent is answering, so\n * the first agent's answer is labelled from the moment the second one's row\n * appears.\n */\nexport function threadShowsAnswerLabels(messages: readonly ThreadMessage[]): boolean {\n  let first: DeepAgentAnsweredBy | null = null;\n  for (const message of messages) {\n    if (isSplitAnswerRow(message)) return true;\n    for (const answer of readMessageAnswers(message)) {\n      if (first === null) {\n        first = answer;\n      } else if (!isSameAnswerer(first, answer)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Whether a message's answers are labelled: always once the thread's answers\n * name several agents or principals (`threadShowsLabels`), and otherwise when\n * one of them worked for a person other than the viewer. With\n * `labelsOtherAgents`, also when one of them was written by any agent other\n * than the viewer's own assistant: a surface where the person names a team\n * agent for one message (Olympus's composer chips) shows who answered it even\n * in a 1:1 chat, where the answer would otherwise read as Athena's. Without a\n * known viewer both viewer rules are off, so a 1:1 chat never flashes labels\n * while the viewer loads.\n */\nexport function showsAnswerLabel({\n  answers,\n  threadShowsLabels,\n  viewerId,\n  labelsOtherAgents = false,\n}: {\n  answers: readonly DeepAgentAnsweredBy[];\n  threadShowsLabels: boolean;\n  viewerId: string | null;\n  /** Label an answer written by any agent other than the viewer's own assistant. */\n  labelsOtherAgents?: boolean;\n}): boolean {\n  if (answers.length === 0) return false;\n  if (threadShowsLabels) return true;\n  if (viewerId === null) return false;\n  if (labelsOtherAgents) {\n    const ownAssistant = `${ASSISTANT_AGENT_PREFIX}${viewerId}`;\n    if (answers.some((answer) => answer.agent !== ownAssistant)) return true;\n  }\n  return answers.some((answer) => isPersonPrincipal(answer.for_id) && answer.for_id !== viewerId);\n}\n\nfunction answererName(answer: DeepAgentAnsweredBy): string {\n  if (answer.agent_name !== null) return answer.agent_name;\n  return answer.agent.startsWith(ASSISTANT_AGENT_PREFIX)\n    ? ATHENA_ASSISTANT_NAME\n    : UNNAMED_AGENT_NAME;\n}\n\nfunction forWhomName(answer: DeepAgentAnsweredBy, viewerId: string | null): string | null {\n  if (answer.for_id !== null && answer.for_id === viewerId) return 'you';\n  if (answer.for_name !== null && isPersonPrincipal(answer.for_id)) return answer.for_name;\n  return null;\n}\n\nfunction joinNames(names: readonly string[]): string {\n  if (names.length <= 1) return names[0] ?? '';\n  return `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`;\n}\n\n/**\n * The label's words: who answered, then whom for. \"Finance · for you\",\n * \"Athena · for Priya Shah\", \"Finance\" (a run that worked for nobody, or for\n * an agent's own run). The agent is the collab agent's name, else\n * {@link ATHENA_ASSISTANT_NAME} for someone's own assistant, else \"Agent\".\n * Several agents answering for the same principal read \"Finance and Legal ·\n * for you\"; answers for different principals are listed apart, even when the\n * people share a name (\"Finance · for Alex, Legal · for Alex\"). `null` when\n * the message holds no answers.\n */\nexport function answerLabelText({\n  answers,\n  viewerId,\n}: {\n  answers: readonly DeepAgentAnsweredBy[];\n  viewerId: string | null;\n}): string | null {\n  if (answers.length === 0) return null;\n  // One group per principal (nobody is one too), never per displayed name: two\n  // people who share a name stay two recipients.\n  const groups: { forId: string | null; names: string[]; forWhom: string | null }[] = [];\n  for (const answer of answers) {\n    const name = answererName(answer);\n    const forWhom = forWhomName(answer, viewerId);\n    const group = groups.find((candidate) => candidate.forId === answer.for_id);\n    if (group === undefined) {\n      groups.push({ forId: answer.for_id, names: [name], forWhom });\n      continue;\n    }\n    if (!group.names.includes(name)) group.names.push(name);\n    // A recipient one answer left unnamed takes the name a later answer for\n    // the same principal carries. The first name found wins: answers stamped\n    // under two names for one id (a rename between runs) read as the first.\n    group.forWhom ??= forWhom;\n  }\n  return groups\n    .map(({ names, forWhom }) =>\n      forWhom === null ? joinNames(names) : `${joinNames(names)}${LABEL_SEPARATOR}for ${forWhom}`\n    )\n    .join(', ');\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"answer-label.js","sources":["../../../../agent-runtime/src/answer-label.ts"],"sourcesContent":["import { getExternalStoreMessages, type ThreadMessage } from '@assistant-ui/core';\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\n\n/**\n * `metadata.custom` key naming the agent that answered an AI message and whom\n * its run worked for (identity v7 D13: \"each answer is labelled with its\n * agent, 'for <author>'\").\n *\n * The backend stamps it on every answer a deep-agent run's model produces\n * (`agora/.../conversation_agents/answer_label.py`), under the\n * `additional_kwargs.metadata` bag the converter exposes as\n * `message.metadata.custom`, and mirrors it onto the live wire once the\n * model's turn lands. Only the server writes it. Answers written before the\n * stamp existed carry none, and get no label.\n */\nexport const ATHENA_ANSWERED_BY_KEY = 'answered_by';\n\n/** The agent that answered and whom its run worked for, as the backend stamps them. */\nexport interface DeepAgentAnsweredBy {\n  /** `collab_agent:<asset id>` for a team agent, `assistant:<principal id>` for someone's own assistant. */\n  agent: string;\n  /** The collab agent's name when it answered; `null` for an assistant, which clients name. */\n  agent_name: string | null;\n  /** Whom the run worked for: a person (`user_…`), an agent's or automation's own run, or nobody (`null`). */\n  for_id: string | null;\n  /** That person's display name when it answered, else `null`. */\n  for_name: string | null;\n}\n\n/** What a label calls someone's own assistant: the managed default agent's product name. */\nexport const ATHENA_ASSISTANT_NAME = 'Athena';\n\nconst ASSISTANT_AGENT_PREFIX = 'assistant:';\nconst PERSON_PRINCIPAL_PREFIX = 'user_';\nconst UNNAMED_AGENT_NAME = 'Agent';\nconst LABEL_SEPARATOR = ' · ';\nconst NO_ANSWERS: readonly DeepAgentAnsweredBy[] = Object.freeze([]);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst optionalId = (value: unknown): string | null =>\n  typeof value === 'string' && value.length > 0 ? value : null;\n\nconst optionalName = (value: unknown): string | null => {\n  if (typeof value !== 'string') return null;\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n};\n\n/**\n * Parse an `answered_by` stamp off a wire value.\n *\n * A stamp without a string `agent` is no stamp at all; absent or malformed\n * optional fields read as `null`, so a partly malformed stamp still names its\n * agent and never names a person it can't.\n */\nexport function readAnsweredBy(value: unknown): DeepAgentAnsweredBy | null {\n  if (!isRecord(value)) return null;\n  const agent = optionalId(value.agent);\n  if (agent === null) return null;\n  return {\n    agent,\n    agent_name: optionalName(value.agent_name),\n    for_id: optionalId(value.for_id),\n    for_name: optionalName(value.for_name),\n  };\n}\n\n/**\n * The run id an answer's row carries when the deep-agent conversion split a\n * turn several answerers wrote into one row per answerer (`answer-rows.ts`):\n * one per agent and principal.\n */\nconst ANSWER_ROW_RUN_ID_PREFIX = 'answered_by:';\n\n/** The row run id of an answer by `agent` for `forId` (see `withAnswerRows`). */\nexport function answerRowRunId(agent: string, forId: string | null): string {\n  return `${ANSWER_ROW_RUN_ID_PREFIX}${agent}|${forId ?? ''}`;\n}\n\n/**\n * Whether a converted row is one of a turn the conversion split by answerer.\n * Reads `metadata` optionally, as `collectMessageAnswers` does: a message\n * another runtime (or a test) builds may carry none.\n */\nfunction isSplitAnswerRow(message: ThreadMessage): boolean {\n  const runId = message.role === 'assistant' ? message.metadata?.runId : undefined;\n  return typeof runId === 'string' && runId.startsWith(ANSWER_ROW_RUN_ID_PREFIX);\n}\n\nconst isSameAnswerer = (a: DeepAgentAnsweredBy, b: DeepAgentAnsweredBy): boolean =>\n  a.agent === b.agent && a.for_id === b.for_id;\n\nconst isPersonPrincipal = (id: string | null): id is string =>\n  id !== null && id.startsWith(PERSON_PRINCIPAL_PREFIX);\n\n/** The `answered_by` stamp an AI message as the wire carries it holds; `null` for any other message. */\nexport function readLangChainAnswer(\n  source: LangChainMessage | undefined\n): DeepAgentAnsweredBy | null {\n  if (source?.type !== 'ai') return null;\n  const bag = source.additional_kwargs?.metadata;\n  return isRecord(bag) ? readAnsweredBy(bag[ATHENA_ANSWERED_BY_KEY]) : null;\n}\n\nfunction collectMessageAnswers(message: ThreadMessage): readonly DeepAgentAnsweredBy[] {\n  if (message.role !== 'assistant') return NO_ANSWERS;\n  const sources = getExternalStoreMessages<LangChainMessage>(message);\n  if (sources.length === 0) {\n    const joined = readAnsweredBy(message.metadata?.custom?.[ATHENA_ANSWERED_BY_KEY]);\n    return joined === null ? NO_ANSWERS : [joined];\n  }\n  let answers: DeepAgentAnsweredBy[] | null = null;\n  for (const source of sources) {\n    const answer = readLangChainAnswer(source);\n    if (answer === null || answers?.some((seen) => isSameAnswerer(seen, answer))) continue;\n    answers ??= [];\n    answers.push(answer);\n  }\n  return answers ?? NO_ANSWERS;\n}\n\nconst answersByMessage = new WeakMap<ThreadMessage, readonly DeepAgentAnsweredBy[]>();\n\n/**\n * The answers one thread message holds: each agent that answered in it and\n * whom it worked for, in the order they answered, one entry per agent and\n * principal.\n *\n * Read off the message's bound source messages, not its joined\n * `metadata.custom`: assistant-ui joins consecutive AI messages into one\n * turn, and its joined metadata keeps only the last stamp. The deep-agent\n * conversion gives each agent that answers one message in turn (D13 several\n * agents, one message) a row of its own (`answer-rows.ts`), so a row\n * normally holds one answer; a conversion without that split (another\n * pipeline, a stamp that never landed) still names every agent of the row.\n * A message with no bound sources (another runtime) falls back to the joined\n * value. Cached per message object: a settled message keeps its object\n * across a streamed token, so a thread-wide scan per token reads only the\n * message that changed.\n */\nexport function readMessageAnswers(message: ThreadMessage): readonly DeepAgentAnsweredBy[] {\n  const cached = answersByMessage.get(message);\n  if (cached !== undefined) return cached;\n  const answers = collectMessageAnswers(message);\n  answersByMessage.set(message, answers);\n  return answers;\n}\n\n/**\n * The thread-wide half of the label decision: whether the transcript's\n * answers name two or more agents, or two or more principals they worked\n * for. Then every answer is labelled; a 1:1 chat with one agent working for\n * one person looks as it did before labels. Unstamped answers count for\n * nothing.\n *\n * It decides over the messages the client holds (on a windowed wire, the\n * pages loaded so far), as the human-author avatars do: a page of older\n * history that brings another agent or person turns the labels on. Each\n * label still names its own answer's stamp, so loading history never changes\n * what an answer is attributed to, only whether the line shows.\n *\n * A turn the conversion split into one row per answerer turns the labels on\n * too, before the next agent's stamp lands: while several agents answer one\n * message, the host's record already says a second agent is answering, so\n * the first agent's answer is labelled from the moment the second one's row\n * appears.\n */\nexport function threadShowsAnswerLabels(messages: readonly ThreadMessage[]): boolean {\n  let first: DeepAgentAnsweredBy | null = null;\n  for (const message of messages) {\n    if (isSplitAnswerRow(message)) return true;\n    for (const answer of readMessageAnswers(message)) {\n      if (first === null) {\n        first = answer;\n      } else if (!isSameAnswerer(first, answer)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Whether a message's answers are labelled: always once the thread's answers\n * name several agents or principals (`threadShowsLabels`), and otherwise when\n * one of them worked for a person other than the viewer. With\n * `labelsOtherAgents`, also when one of them was written by an agent other\n * than the conversation's own (`conversationAgent`, else the viewer's own\n * assistant): a surface where the person names a team agent for one message\n * (Olympus's composer chips) shows who answered it even in a 1:1 chat, where\n * the answer would otherwise read as the conversation agent's. A 1:1 chat with\n * the conversation's agent, a collab agent included, shows nothing. Without a\n * known viewer both viewer rules are off, so a 1:1 chat never flashes labels\n * while the viewer loads.\n */\nexport function showsAnswerLabel({\n  answers,\n  threadShowsLabels,\n  viewerId,\n  labelsOtherAgents = false,\n  conversationAgent = null,\n}: {\n  answers: readonly DeepAgentAnsweredBy[];\n  threadShowsLabels: boolean;\n  viewerId: string | null;\n  /** Label an answer written by any agent other than the conversation's own. */\n  labelsOtherAgents?: boolean;\n  /**\n   * The agent key the conversation is with (`collab_agent:<asset id>`, as its\n   * header shows it); `null` (the default) for the viewer's own assistant.\n   */\n  conversationAgent?: string | null;\n}): boolean {\n  if (answers.length === 0) return false;\n  if (threadShowsLabels) return true;\n  if (viewerId === null) return false;\n  if (labelsOtherAgents) {\n    const expected = conversationAgent ?? `${ASSISTANT_AGENT_PREFIX}${viewerId}`;\n    if (answers.some((answer) => answer.agent !== expected)) return true;\n  }\n  return answers.some((answer) => isPersonPrincipal(answer.for_id) && answer.for_id !== viewerId);\n}\n\nfunction answererName(answer: DeepAgentAnsweredBy): string {\n  if (answer.agent_name !== null) return answer.agent_name;\n  return answer.agent.startsWith(ASSISTANT_AGENT_PREFIX)\n    ? ATHENA_ASSISTANT_NAME\n    : UNNAMED_AGENT_NAME;\n}\n\nfunction forWhomName(answer: DeepAgentAnsweredBy, viewerId: string | null): string | null {\n  if (answer.for_id !== null && answer.for_id === viewerId) return 'you';\n  if (answer.for_name !== null && isPersonPrincipal(answer.for_id)) return answer.for_name;\n  return null;\n}\n\nfunction joinNames(names: readonly string[]): string {\n  if (names.length <= 1) return names[0] ?? '';\n  return `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`;\n}\n\n/**\n * The label's words: who answered, then whom for. \"Finance · for you\",\n * \"Athena · for Priya Shah\", \"Finance\" (a run that worked for nobody, or for\n * an agent's own run). The agent is the collab agent's name, else\n * {@link ATHENA_ASSISTANT_NAME} for someone's own assistant, else \"Agent\".\n * Several agents answering for the same principal read \"Finance and Legal ·\n * for you\"; answers for different principals are listed apart, even when the\n * people share a name (\"Finance · for Alex, Legal · for Alex\"). `null` when\n * the message holds no answers.\n */\nexport function answerLabelText({\n  answers,\n  viewerId,\n}: {\n  answers: readonly DeepAgentAnsweredBy[];\n  viewerId: string | null;\n}): string | null {\n  if (answers.length === 0) return null;\n  // One group per principal (nobody is one too), never per displayed name: two\n  // people who share a name stay two recipients.\n  const groups: { forId: string | null; names: string[]; forWhom: string | null }[] = [];\n  for (const answer of answers) {\n    const name = answererName(answer);\n    const forWhom = forWhomName(answer, viewerId);\n    const group = groups.find((candidate) => candidate.forId === answer.for_id);\n    if (group === undefined) {\n      groups.push({ forId: answer.for_id, names: [name], forWhom });\n      continue;\n    }\n    if (!group.names.includes(name)) group.names.push(name);\n    // A recipient one answer left unnamed takes the name a later answer for\n    // the same principal carries. The first name found wins: answers stamped\n    // under two names for one id (a rename between runs) read as the first.\n    group.forWhom ??= forWhom;\n  }\n  return groups\n    .map(({ names, forWhom }) =>\n      forWhom === null ? joinNames(names) : `${joinNames(names)}${LABEL_SEPARATOR}for ${forWhom}`\n    )\n    .join(', ');\n}\n"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"chat-outbox-attachments.cjs","sources":["../../../../agent-runtime/src/chat-outbox-attachments.ts"],"sourcesContent":["import type { ChatOutboxAttachment } from \"./chat-outbox-store\";\n\n/**\n * Whether a waiting message's attachments can still be opened, asked of Athena right before the\n * message goes (`chat-outbox.ts`). A held message carries only files that had finished uploading\n * before Athena went out of reach, but one may be deleted, or stop being shared with the person,\n * while it waits: the message must not go with a reference Athena no longer lets them open.\n *\n * Each file is read through agora's permission-checked `GET /api/v0/assets/{id}`\n * (`get_asset_access_context_or_http`: `get_asset_with_permission_check` in the asset's workspace)\n * as the signed-in person. Nothing here grants anything: the run reads every attachment through\n * the same gates again when it uses it.\n */\n\n/** What Athena answered about a waiting message's attachments. */\nexport type ChatOutboxAttachmentVerdict =\n  /** Every one is still there and still the person's to open. */\n  | \"ok\"\n  /** At least one is gone (deleted, or in the trash) or no longer the person's to open. */\n  | \"refused\"\n  /** Athena could not say: a read failed, timed out, or its credential was refused. */\n  | \"unknown\";\n\n/** Asks Athena about a waiting message's attachments. */\nexport type ChatOutboxAttachmentCheck = (\n  attachments: readonly ChatOutboxAttachment[],\n) => Promise<ChatOutboxAttachmentVerdict>;\n\n/** agora's permission-checked read of one asset, relative to its API base. */\nexport function chatOutboxAttachmentPath(assetId: string): string {\n  return `/api/v0/assets/${encodeURIComponent(assetId)}`;\n}\n\n/** As much of a `fetch` response as the check reads. */\nexport interface ChatOutboxAssetReadResponse {\n  status: number;\n  json(): Promise<unknown>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nasync function verdictOf(response: ChatOutboxAssetReadResponse): Promise<ChatOutboxAttachmentVerdict> {\n  // 404: the asset is gone (or never was); 403: it is no longer the person's to open.\n  if (response.status === 403 || response.status === 404) return \"refused\";\n  if (response.status < 200 || response.status >= 300) return \"unknown\";\n  // A body that does not read (cut off, or not agora's JSON) never says whether the file is in\n  // the trash: that is no answer.\n  let body: unknown;\n  try {\n    body = await response.json();\n  } catch {\n    return \"unknown\";\n  }\n  if (!isRecord(body)) return \"unknown\";\n  // An archived asset is in the trash: deleted, as far as a message is concerned.\n  return body.is_archived === true ? \"refused\" : \"ok\";\n}\n\n/**\n * The check a host hands its chat outbox: each attachment read once, in turn, through `readAsset`\n * (`GET {agora}{chatOutboxAttachmentPath(id)}` with the person's credential, renewed once on a\n * refused token where the host can, under the host's own request timeout). `refused` as soon as\n * one is refused; `unknown` when none was refused but one could not be read; else `ok`.\n */\nexport function createChatOutboxAttachmentCheck({\n  readAsset,\n}: {\n  readAsset: (assetId: string) => Promise<ChatOutboxAssetReadResponse>;\n}): ChatOutboxAttachmentCheck {\n  return async (attachments) => {\n    let unknown = false;\n    for (const assetId of new Set(attachments.map((attachment) => attachment.assetId))) {\n      let verdict: ChatOutboxAttachmentVerdict;\n      try {\n        verdict = await verdictOf(await readAsset(assetId));\n      } catch {\n        verdict = \"unknown\";\n      }\n      if (verdict === \"refused\") return \"refused\";\n      if (verdict === \"unknown\") unknown = true;\n    }\n    return unknown ? \"unknown\" : \"ok\";\n  };\n}\n"],"names":[],"mappings":";;AA6BO,SAAS,yBAAyB,SAAyB;AAChE,SAAO,kBAAkB,mBAAmB,OAAO,CAAC;AACtD;AAQA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,eAAe,UAAU,UAA6E;AAEpG,MAAI,SAAS,WAAW,OAAO,SAAS,WAAW,IAAK,QAAO;AAC/D,MAAI,SAAS,SAAS,OAAO,SAAS,UAAU,IAAK,QAAO;AAG5D,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,SAAS,KAAA;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,CAAC,SAAS,IAAI,EAAG,QAAO;AAE5B,SAAO,KAAK,gBAAgB,OAAO,YAAY;AACjD;AAQO,SAAS,gCAAgC;AAAA,EAC9C;AACF,GAE8B;AAC5B,SAAO,OAAO,gBAAgB;AAC5B,QAAI,UAAU;AACd,eAAW,WAAW,IAAI,IAAI,YAAY,IAAI,CAAC,eAAe,WAAW,OAAO,CAAC,GAAG;AAClF,UAAI;AACJ,UAAI;AACF,kBAAU,MAAM,UAAU,MAAM,UAAU,OAAO,CAAC;AAAA,MACpD,QAAQ;AACN,kBAAU;AAAA,MACZ;AACA,UAAI,YAAY,UAAW,QAAO;AAClC,UAAI,YAAY,UAAW,WAAU;AAAA,IACvC;AACA,WAAO,UAAU,YAAY;AAAA,EAC/B;AACF;;;"}
+{"version":3,"file":"chat-outbox-attachments.cjs","sources":["../../../../agent-runtime/src/chat-outbox-attachments.ts"],"sourcesContent":["import type { ChatOutboxAttachment } from \"./chat-outbox-entry\";\n\n/**\n * Whether a waiting message's attachments can still be opened, asked of Athena right before the\n * message goes (`chat-outbox.ts`). A held message carries only files that had finished uploading\n * before Athena went out of reach, but one may be deleted, or stop being shared with the person,\n * while it waits: the message must not go with a reference Athena no longer lets them open.\n *\n * Each file is read through agora's permission-checked `GET /api/v0/assets/{id}`\n * (`get_asset_access_context_or_http`: `get_asset_with_permission_check` in the asset's workspace)\n * as the signed-in person. Nothing here grants anything: the run reads every attachment through\n * the same gates again when it uses it.\n */\n\n/** What Athena answered about a waiting message's attachments. */\nexport type ChatOutboxAttachmentVerdict =\n  /** Every one is still there and still the person's to open. */\n  | \"ok\"\n  /** At least one is gone (deleted, or in the trash) or no longer the person's to open. */\n  | \"refused\"\n  /** Athena could not say: a read failed, timed out, or its credential was refused. */\n  | \"unknown\";\n\n/** Asks Athena about a waiting message's attachments. */\nexport type ChatOutboxAttachmentCheck = (\n  attachments: readonly ChatOutboxAttachment[],\n) => Promise<ChatOutboxAttachmentVerdict>;\n\n/** agora's permission-checked read of one asset, relative to its API base. */\nexport function chatOutboxAttachmentPath(assetId: string): string {\n  return `/api/v0/assets/${encodeURIComponent(assetId)}`;\n}\n\n/** As much of a `fetch` response as the check reads. */\nexport interface ChatOutboxAssetReadResponse {\n  status: number;\n  json(): Promise<unknown>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nasync function verdictOf(response: ChatOutboxAssetReadResponse): Promise<ChatOutboxAttachmentVerdict> {\n  // 404: the asset is gone (or never was); 403: it is no longer the person's to open.\n  if (response.status === 403 || response.status === 404) return \"refused\";\n  if (response.status < 200 || response.status >= 300) return \"unknown\";\n  // A body that does not read (cut off, or not agora's JSON) never says whether the file is in\n  // the trash: that is no answer.\n  let body: unknown;\n  try {\n    body = await response.json();\n  } catch {\n    return \"unknown\";\n  }\n  if (!isRecord(body)) return \"unknown\";\n  // An archived asset is in the trash: deleted, as far as a message is concerned.\n  return body.is_archived === true ? \"refused\" : \"ok\";\n}\n\n/**\n * The check a host hands its chat outbox: each attachment read once, in turn, through `readAsset`\n * (`GET {agora}{chatOutboxAttachmentPath(id)}` with the person's credential, renewed once on a\n * refused token where the host can, under the host's own request timeout). `refused` as soon as\n * one is refused; `unknown` when none was refused but one could not be read; else `ok`.\n */\nexport function createChatOutboxAttachmentCheck({\n  readAsset,\n}: {\n  readAsset: (assetId: string) => Promise<ChatOutboxAssetReadResponse>;\n}): ChatOutboxAttachmentCheck {\n  return async (attachments) => {\n    let unknown = false;\n    for (const assetId of new Set(attachments.map((attachment) => attachment.assetId))) {\n      let verdict: ChatOutboxAttachmentVerdict;\n      try {\n        verdict = await verdictOf(await readAsset(assetId));\n      } catch {\n        verdict = \"unknown\";\n      }\n      if (verdict === \"refused\") return \"refused\";\n      if (verdict === \"unknown\") unknown = true;\n    }\n    return unknown ? \"unknown\" : \"ok\";\n  };\n}\n"],"names":[],"mappings":";;AA6BO,SAAS,yBAAyB,SAAyB;AAChE,SAAO,kBAAkB,mBAAmB,OAAO,CAAC;AACtD;AAQA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,eAAe,UAAU,UAA6E;AAEpG,MAAI,SAAS,WAAW,OAAO,SAAS,WAAW,IAAK,QAAO;AAC/D,MAAI,SAAS,SAAS,OAAO,SAAS,UAAU,IAAK,QAAO;AAG5D,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,SAAS,KAAA;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,CAAC,SAAS,IAAI,EAAG,QAAO;AAE5B,SAAO,KAAK,gBAAgB,OAAO,YAAY;AACjD;AAQO,SAAS,gCAAgC;AAAA,EAC9C;AACF,GAE8B;AAC5B,SAAO,OAAO,gBAAgB;AAC5B,QAAI,UAAU;AACd,eAAW,WAAW,IAAI,IAAI,YAAY,IAAI,CAAC,eAAe,WAAW,OAAO,CAAC,GAAG;AAClF,UAAI;AACJ,UAAI;AACF,kBAAU,MAAM,UAAU,MAAM,UAAU,OAAO,CAAC;AAAA,MACpD,QAAQ;AACN,kBAAU;AAAA,MACZ;AACA,UAAI,YAAY,UAAW,QAAO;AAClC,UAAI,YAAY,UAAW,WAAU;AAAA,IACvC;AACA,WAAO,UAAU,YAAY;AAAA,EAC/B;AACF;;;"}

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

@@ -1,4 +1,4 @@
-import type { ChatOutboxAttachment } from "./chat-outbox-store";
+import type { ChatOutboxAttachment } from "./chat-outbox-entry";
 /**
  * Whether a waiting message's attachments can still be opened, asked of Athena right before the
  * message goes (`chat-outbox.ts`). A held message carries only files that had finished uploading

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

@@ -1 +1 @@
-{"version":3,"file":"chat-outbox-attachments.js","sources":["../../../../agent-runtime/src/chat-outbox-attachments.ts"],"sourcesContent":["import type { ChatOutboxAttachment } from \"./chat-outbox-store\";\n\n/**\n * Whether a waiting message's attachments can still be opened, asked of Athena right before the\n * message goes (`chat-outbox.ts`). A held message carries only files that had finished uploading\n * before Athena went out of reach, but one may be deleted, or stop being shared with the person,\n * while it waits: the message must not go with a reference Athena no longer lets them open.\n *\n * Each file is read through agora's permission-checked `GET /api/v0/assets/{id}`\n * (`get_asset_access_context_or_http`: `get_asset_with_permission_check` in the asset's workspace)\n * as the signed-in person. Nothing here grants anything: the run reads every attachment through\n * the same gates again when it uses it.\n */\n\n/** What Athena answered about a waiting message's attachments. */\nexport type ChatOutboxAttachmentVerdict =\n  /** Every one is still there and still the person's to open. */\n  | \"ok\"\n  /** At least one is gone (deleted, or in the trash) or no longer the person's to open. */\n  | \"refused\"\n  /** Athena could not say: a read failed, timed out, or its credential was refused. */\n  | \"unknown\";\n\n/** Asks Athena about a waiting message's attachments. */\nexport type ChatOutboxAttachmentCheck = (\n  attachments: readonly ChatOutboxAttachment[],\n) => Promise<ChatOutboxAttachmentVerdict>;\n\n/** agora's permission-checked read of one asset, relative to its API base. */\nexport function chatOutboxAttachmentPath(assetId: string): string {\n  return `/api/v0/assets/${encodeURIComponent(assetId)}`;\n}\n\n/** As much of a `fetch` response as the check reads. */\nexport interface ChatOutboxAssetReadResponse {\n  status: number;\n  json(): Promise<unknown>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nasync function verdictOf(response: ChatOutboxAssetReadResponse): Promise<ChatOutboxAttachmentVerdict> {\n  // 404: the asset is gone (or never was); 403: it is no longer the person's to open.\n  if (response.status === 403 || response.status === 404) return \"refused\";\n  if (response.status < 200 || response.status >= 300) return \"unknown\";\n  // A body that does not read (cut off, or not agora's JSON) never says whether the file is in\n  // the trash: that is no answer.\n  let body: unknown;\n  try {\n    body = await response.json();\n  } catch {\n    return \"unknown\";\n  }\n  if (!isRecord(body)) return \"unknown\";\n  // An archived asset is in the trash: deleted, as far as a message is concerned.\n  return body.is_archived === true ? \"refused\" : \"ok\";\n}\n\n/**\n * The check a host hands its chat outbox: each attachment read once, in turn, through `readAsset`\n * (`GET {agora}{chatOutboxAttachmentPath(id)}` with the person's credential, renewed once on a\n * refused token where the host can, under the host's own request timeout). `refused` as soon as\n * one is refused; `unknown` when none was refused but one could not be read; else `ok`.\n */\nexport function createChatOutboxAttachmentCheck({\n  readAsset,\n}: {\n  readAsset: (assetId: string) => Promise<ChatOutboxAssetReadResponse>;\n}): ChatOutboxAttachmentCheck {\n  return async (attachments) => {\n    let unknown = false;\n    for (const assetId of new Set(attachments.map((attachment) => attachment.assetId))) {\n      let verdict: ChatOutboxAttachmentVerdict;\n      try {\n        verdict = await verdictOf(await readAsset(assetId));\n      } catch {\n        verdict = \"unknown\";\n      }\n      if (verdict === \"refused\") return \"refused\";\n      if (verdict === \"unknown\") unknown = true;\n    }\n    return unknown ? \"unknown\" : \"ok\";\n  };\n}\n"],"names":[],"mappings":"AA6BO,SAAS,yBAAyB,SAAyB;AAChE,SAAO,kBAAkB,mBAAmB,OAAO,CAAC;AACtD;AAQA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,eAAe,UAAU,UAA6E;AAEpG,MAAI,SAAS,WAAW,OAAO,SAAS,WAAW,IAAK,QAAO;AAC/D,MAAI,SAAS,SAAS,OAAO,SAAS,UAAU,IAAK,QAAO;AAG5D,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,SAAS,KAAA;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,CAAC,SAAS,IAAI,EAAG,QAAO;AAE5B,SAAO,KAAK,gBAAgB,OAAO,YAAY;AACjD;AAQO,SAAS,gCAAgC;AAAA,EAC9C;AACF,GAE8B;AAC5B,SAAO,OAAO,gBAAgB;AAC5B,QAAI,UAAU;AACd,eAAW,WAAW,IAAI,IAAI,YAAY,IAAI,CAAC,eAAe,WAAW,OAAO,CAAC,GAAG;AAClF,UAAI;AACJ,UAAI;AACF,kBAAU,MAAM,UAAU,MAAM,UAAU,OAAO,CAAC;AAAA,MACpD,QAAQ;AACN,kBAAU;AAAA,MACZ;AACA,UAAI,YAAY,UAAW,QAAO;AAClC,UAAI,YAAY,UAAW,WAAU;AAAA,IACvC;AACA,WAAO,UAAU,YAAY;AAAA,EAC/B;AACF;"}
+{"version":3,"file":"chat-outbox-attachments.js","sources":["../../../../agent-runtime/src/chat-outbox-attachments.ts"],"sourcesContent":["import type { ChatOutboxAttachment } from \"./chat-outbox-entry\";\n\n/**\n * Whether a waiting message's attachments can still be opened, asked of Athena right before the\n * message goes (`chat-outbox.ts`). A held message carries only files that had finished uploading\n * before Athena went out of reach, but one may be deleted, or stop being shared with the person,\n * while it waits: the message must not go with a reference Athena no longer lets them open.\n *\n * Each file is read through agora's permission-checked `GET /api/v0/assets/{id}`\n * (`get_asset_access_context_or_http`: `get_asset_with_permission_check` in the asset's workspace)\n * as the signed-in person. Nothing here grants anything: the run reads every attachment through\n * the same gates again when it uses it.\n */\n\n/** What Athena answered about a waiting message's attachments. */\nexport type ChatOutboxAttachmentVerdict =\n  /** Every one is still there and still the person's to open. */\n  | \"ok\"\n  /** At least one is gone (deleted, or in the trash) or no longer the person's to open. */\n  | \"refused\"\n  /** Athena could not say: a read failed, timed out, or its credential was refused. */\n  | \"unknown\";\n\n/** Asks Athena about a waiting message's attachments. */\nexport type ChatOutboxAttachmentCheck = (\n  attachments: readonly ChatOutboxAttachment[],\n) => Promise<ChatOutboxAttachmentVerdict>;\n\n/** agora's permission-checked read of one asset, relative to its API base. */\nexport function chatOutboxAttachmentPath(assetId: string): string {\n  return `/api/v0/assets/${encodeURIComponent(assetId)}`;\n}\n\n/** As much of a `fetch` response as the check reads. */\nexport interface ChatOutboxAssetReadResponse {\n  status: number;\n  json(): Promise<unknown>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nasync function verdictOf(response: ChatOutboxAssetReadResponse): Promise<ChatOutboxAttachmentVerdict> {\n  // 404: the asset is gone (or never was); 403: it is no longer the person's to open.\n  if (response.status === 403 || response.status === 404) return \"refused\";\n  if (response.status < 200 || response.status >= 300) return \"unknown\";\n  // A body that does not read (cut off, or not agora's JSON) never says whether the file is in\n  // the trash: that is no answer.\n  let body: unknown;\n  try {\n    body = await response.json();\n  } catch {\n    return \"unknown\";\n  }\n  if (!isRecord(body)) return \"unknown\";\n  // An archived asset is in the trash: deleted, as far as a message is concerned.\n  return body.is_archived === true ? \"refused\" : \"ok\";\n}\n\n/**\n * The check a host hands its chat outbox: each attachment read once, in turn, through `readAsset`\n * (`GET {agora}{chatOutboxAttachmentPath(id)}` with the person's credential, renewed once on a\n * refused token where the host can, under the host's own request timeout). `refused` as soon as\n * one is refused; `unknown` when none was refused but one could not be read; else `ok`.\n */\nexport function createChatOutboxAttachmentCheck({\n  readAsset,\n}: {\n  readAsset: (assetId: string) => Promise<ChatOutboxAssetReadResponse>;\n}): ChatOutboxAttachmentCheck {\n  return async (attachments) => {\n    let unknown = false;\n    for (const assetId of new Set(attachments.map((attachment) => attachment.assetId))) {\n      let verdict: ChatOutboxAttachmentVerdict;\n      try {\n        verdict = await verdictOf(await readAsset(assetId));\n      } catch {\n        verdict = \"unknown\";\n      }\n      if (verdict === \"refused\") return \"refused\";\n      if (verdict === \"unknown\") unknown = true;\n    }\n    return unknown ? \"unknown\" : \"ok\";\n  };\n}\n"],"names":[],"mappings":"AA6BO,SAAS,yBAAyB,SAAyB;AAChE,SAAO,kBAAkB,mBAAmB,OAAO,CAAC;AACtD;AAQA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,eAAe,UAAU,UAA6E;AAEpG,MAAI,SAAS,WAAW,OAAO,SAAS,WAAW,IAAK,QAAO;AAC/D,MAAI,SAAS,SAAS,OAAO,SAAS,UAAU,IAAK,QAAO;AAG5D,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,SAAS,KAAA;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,CAAC,SAAS,IAAI,EAAG,QAAO;AAE5B,SAAO,KAAK,gBAAgB,OAAO,YAAY;AACjD;AAQO,SAAS,gCAAgC;AAAA,EAC9C;AACF,GAE8B;AAC5B,SAAO,OAAO,gBAAgB;AAC5B,QAAI,UAAU;AACd,eAAW,WAAW,IAAI,IAAI,YAAY,IAAI,CAAC,eAAe,WAAW,OAAO,CAAC,GAAG;AAClF,UAAI;AACJ,UAAI;AACF,kBAAU,MAAM,UAAU,MAAM,UAAU,OAAO,CAAC;AAAA,MACpD,QAAQ;AACN,kBAAU;AAAA,MACZ;AACA,UAAI,YAAY,UAAW,QAAO;AAClC,UAAI,YAAY,UAAW,WAAU;AAAA,IACvC;AACA,WAAO,UAAU,YAAY;AAAA,EAC/B;AACF;"}

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

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const chatOutboxPolicy = require("./chat-outbox-policy.cjs");
+const statewireHeldSends = require("./statewire-held-sends.cjs");
+const CHAT_OUTBOX_LOCAL_META_KIND = "athena-chat-outbox";
+const LEGACY_CHAT_OUTBOX_SOURCE = "athena-chat-outbox:v1";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readChatOutboxLocalMeta(localMeta) {
+  if (!isRecord(localMeta)) return {};
+  const meta = {};
+  if (localMeta.kind === CHAT_OUTBOX_LOCAL_META_KIND) meta.kind = CHAT_OUTBOX_LOCAL_META_KIND;
+  if (typeof localMeta.threadId === "string") meta.threadId = localMeta.threadId;
+  if (typeof localMeta.queuedAt === "number" && Number.isFinite(localMeta.queuedAt)) meta.queuedAt = localMeta.queuedAt;
+  if (typeof localMeta.newChat === "boolean") meta.newChat = localMeta.newChat;
+  if (typeof localMeta.composerMarkdown === "string") meta.composerMarkdown = localMeta.composerMarkdown;
+  if (typeof localMeta.composerHtml === "string") meta.composerHtml = localMeta.composerHtml;
+  const attachments = readAttachments(localMeta.attachments);
+  if (attachments) meta.attachments = attachments;
+  if (typeof localMeta.countdownEndsAt === "number") meta.countdownEndsAt = localMeta.countdownEndsAt;
+  if (typeof localMeta.countdownFrom === "number") meta.countdownFrom = localMeta.countdownFrom;
+  if (localMeta.migratedFrom === LEGACY_CHAT_OUTBOX_SOURCE) meta.migratedFrom = LEGACY_CHAT_OUTBOX_SOURCE;
+  if (typeof localMeta.legacyId === "string") meta.legacyId = localMeta.legacyId;
+  const error = statewireHeldSends.heldSendFailure(localMeta);
+  if (error) meta.error = error;
+  return meta;
+}
+function withoutTransientLocalMeta(localMeta) {
+  if (!isRecord(localMeta)) return localMeta;
+  const { countdownEndsAt: _ends, countdownFrom: _from, error: _error, ...rest } = localMeta;
+  return Object.keys(rest).length > 0 ? rest : void 0;
+}
+function readAttachments(value) {
+  if (!Array.isArray(value)) return void 0;
+  const attachments = [];
+  for (const attachment of value) {
+    if (!isRecord(attachment) || typeof attachment.assetId !== "string" || attachment.assetId.length === 0) continue;
+    attachments.push({
+      assetId: attachment.assetId,
+      title: typeof attachment.title === "string" ? attachment.title : "",
+      ...typeof attachment.mediaType === "string" && { mediaType: attachment.mediaType }
+    });
+  }
+  return attachments.length > 0 ? attachments : void 0;
+}
+function readFiles(value) {
+  if (!Array.isArray(value)) return void 0;
+  const files = [];
+  for (const file of value) {
+    if (!isRecord(file) || typeof file.url !== "string" || typeof file.mediaType !== "string") continue;
+    files.push({
+      url: file.url,
+      mediaType: file.mediaType,
+      ...typeof file.filename === "string" && { filename: file.filename }
+    });
+  }
+  return files.length > 0 ? files : void 0;
+}
+function runSendMessage(command) {
+  if (!chatOutboxPolicy.isMessageRunCommand(command)) return null;
+  const params = command.params[0];
+  if (!isRecord(params) || !isRecord(params.message)) return null;
+  const { id, parts, metadata } = params.message;
+  if (typeof id !== "string") return null;
+  return {
+    id,
+    parts: Array.isArray(parts) ? parts : [],
+    ...isRecord(metadata) && { metadata }
+  };
+}
+function chatOutboxEntryOf(entry, threadId) {
+  const message = runSendMessage(entry.command);
+  if (message === null) return null;
+  const meta = readChatOutboxLocalMeta(entry.localMeta);
+  const text = message.parts.flatMap((part) => isRecord(part) && part.type === "text" && typeof part.text === "string" ? [part.text] : []).join("\n\n");
+  const files = readFiles(message.parts.filter((part) => isRecord(part) && part.type === "file"));
+  return {
+    id: message.id,
+    outboxId: entry.id,
+    threadId: meta.threadId ?? threadId,
+    text,
+    queuedAt: meta.queuedAt ?? entry.ts,
+    newChat: meta.newChat ?? false,
+    durable: entry.durable,
+    ...meta.composerMarkdown !== void 0 && { composerMarkdown: meta.composerMarkdown },
+    ...meta.composerHtml !== void 0 && { composerHtml: meta.composerHtml },
+    ...message.metadata !== void 0 && { metadata: message.metadata },
+    ...files && { files },
+    ...meta.attachments && { attachments: meta.attachments }
+  };
+}
+exports.CHAT_OUTBOX_LOCAL_META_KIND = CHAT_OUTBOX_LOCAL_META_KIND;
+exports.LEGACY_CHAT_OUTBOX_SOURCE = LEGACY_CHAT_OUTBOX_SOURCE;
+exports.chatOutboxEntryOf = chatOutboxEntryOf;
+exports.readAttachments = readAttachments;
+exports.readChatOutboxLocalMeta = readChatOutboxLocalMeta;
+exports.readFiles = readFiles;
+exports.runSendMessage = runSendMessage;
+exports.withoutTransientLocalMeta = withoutTransientLocalMeta;
+//# sourceMappingURL=chat-outbox-entry.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-outbox-entry.cjs","sources":["../../../../agent-runtime/src/chat-outbox-entry.ts"],"sourcesContent":["import type { StatewireClient } from \"statewire\";\nimport { isMessageRunCommand } from \"./chat-outbox-policy\";\nimport { heldSendFailure } from \"./statewire-held-sends\";\n\n/**\n * A chat message waiting in statewire's outbox, as the chat outbox shows it.\n *\n * The outbox entry is the record: its command is the `run/*` send that carries the message (text and\n * files in `message.parts`, metadata on `message.metadata`), and its client-only `localMeta` keeps\n * what the person's device needs and the server never sees ({@link ChatOutboxLocalMeta}). Both are\n * persisted with the thread's statewire session (sealed on the device where the host keeps copies).\n */\n\n/** An already-uploaded file a waiting message refers to (never a file picked while offline). */\nexport interface ChatOutboxFile {\n  /** A server-backed URL (an asset's image route); never a `blob:` or `data:` URL. */\n  url: string;\n  mediaType: string;\n  filename?: string;\n}\n\n/**\n * A file already in Athena that a waiting message carries: an upload that finished before Athena\n * went out of reach. Its reference rides the message's text, as a sent message's does; this copy\n * names it so the outbox can ask Athena, right before the message goes, that the file is still there\n * and still the person's to open (`ChatOutboxOptions.checkAttachments`).\n */\nexport interface ChatOutboxAttachment {\n  assetId: string;\n  /** Its name, as the composer showed it. */\n  title: string;\n  mediaType?: string;\n}\n\n/** Marks a `localMeta` written by the chat outbox. */\nexport const CHAT_OUTBOX_LOCAL_META_KIND = \"athena-chat-outbox\";\n\n/** The legacy store a migrated entry came from (`chat-outbox-legacy.ts`). */\nexport const LEGACY_CHAT_OUTBOX_SOURCE = \"athena-chat-outbox:v1\";\n\n/** What an outbox entry of a chat message keeps on the device (`OutboxEntry.localMeta`). */\nexport interface ChatOutboxLocalMeta {\n  kind?: typeof CHAT_OUTBOX_LOCAL_META_KIND;\n  threadId?: string;\n  /** When it was typed (epoch ms): a message that waited more than a day asks before it goes. */\n  queuedAt?: number;\n  /** Typed into a chat that had never started: reopening that chat finds it again. */\n  newChat?: boolean;\n  /** The composer draft the text was serialized from, for giving it back exactly as typed. */\n  composerMarkdown?: string;\n  /** The draft as an HTML composer holds it (the phone's), given back exactly on Cancel or Edit. */\n  composerHtml?: string;\n  /** The files already in Athena the message carries, asked about right before it goes. */\n  attachments?: ChatOutboxAttachment[];\n  /** When the running countdown sends it (epoch ms). */\n  countdownEndsAt?: number;\n  /** When that countdown started (epoch ms): a tab coming to the front starts an older one over. */\n  countdownFrom?: number;\n  /** The legacy store it was migrated from, and its id there. */\n  migratedFrom?: typeof LEGACY_CHAT_OUTBOX_SOURCE;\n  legacyId?: string;\n  /** Why it could not be sent (`statewire-held-sends.ts`); set, the row says \"Couldn't send\". */\n  error?: StatewireClient.SendFailure;\n}\n\nexport interface ChatOutboxEntry {\n  /**\n   * The message id, minted when the message was typed. It is sent under it, so a send whose answer\n   * was lost never posts twice: the thread's host refuses an id it already holds.\n   */\n  id: string;\n  /** The statewire outbox entry that carries it (`undefined` while the session is still loading). */\n  outboxId?: string;\n  threadId: string;\n  /** The text exactly as it will be sent (what the model reads). */\n  text: string;\n  composerMarkdown?: string;\n  composerHtml?: string;\n  /** The message metadata frozen when it was typed (its composer markdown, the agents it names, …). */\n  metadata?: Record<string, unknown>;\n  files?: ChatOutboxFile[];\n  attachments?: ChatOutboxAttachment[];\n  /** When it was typed (epoch ms). */\n  queuedAt: number;\n  newChat: boolean;\n  /** Kept on the device (`false`: in page memory only, gone if the page closes). */\n  durable: boolean;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** The chat outbox's view of an entry's `localMeta` (fields of the wrong type are dropped). */\nexport function readChatOutboxLocalMeta(localMeta: unknown): ChatOutboxLocalMeta {\n  if (!isRecord(localMeta)) return {};\n  const meta: ChatOutboxLocalMeta = {};\n  if (localMeta.kind === CHAT_OUTBOX_LOCAL_META_KIND) meta.kind = CHAT_OUTBOX_LOCAL_META_KIND;\n  if (typeof localMeta.threadId === \"string\") meta.threadId = localMeta.threadId;\n  if (typeof localMeta.queuedAt === \"number\" && Number.isFinite(localMeta.queuedAt)) meta.queuedAt = localMeta.queuedAt;\n  if (typeof localMeta.newChat === \"boolean\") meta.newChat = localMeta.newChat;\n  if (typeof localMeta.composerMarkdown === \"string\") meta.composerMarkdown = localMeta.composerMarkdown;\n  if (typeof localMeta.composerHtml === \"string\") meta.composerHtml = localMeta.composerHtml;\n  const attachments = readAttachments(localMeta.attachments);\n  if (attachments) meta.attachments = attachments;\n  if (typeof localMeta.countdownEndsAt === \"number\") meta.countdownEndsAt = localMeta.countdownEndsAt;\n  if (typeof localMeta.countdownFrom === \"number\") meta.countdownFrom = localMeta.countdownFrom;\n  if (localMeta.migratedFrom === LEGACY_CHAT_OUTBOX_SOURCE) meta.migratedFrom = LEGACY_CHAT_OUTBOX_SOURCE;\n  if (typeof localMeta.legacyId === \"string\") meta.legacyId = localMeta.legacyId;\n  const error = heldSendFailure(localMeta);\n  if (error) meta.error = error;\n  return meta;\n}\n\n/** `localMeta` without the countdown and the failure: what a send that goes again carries. */\nexport function withoutTransientLocalMeta(localMeta: unknown): unknown {\n  if (!isRecord(localMeta)) return localMeta;\n  const { countdownEndsAt: _ends, countdownFrom: _from, error: _error, ...rest } = localMeta;\n  return Object.keys(rest).length > 0 ? rest : undefined;\n}\n\nexport function readAttachments(value: unknown): ChatOutboxAttachment[] | undefined {\n  if (!Array.isArray(value)) return undefined;\n  const attachments: ChatOutboxAttachment[] = [];\n  for (const attachment of value) {\n    if (!isRecord(attachment) || typeof attachment.assetId !== \"string\" || attachment.assetId.length === 0) continue;\n    attachments.push({\n      assetId: attachment.assetId,\n      title: typeof attachment.title === \"string\" ? attachment.title : \"\",\n      ...(typeof attachment.mediaType === \"string\" && { mediaType: attachment.mediaType }),\n    });\n  }\n  return attachments.length > 0 ? attachments : undefined;\n}\n\nexport function readFiles(value: unknown): ChatOutboxFile[] | undefined {\n  if (!Array.isArray(value)) return undefined;\n  const files: ChatOutboxFile[] = [];\n  for (const file of value) {\n    if (!isRecord(file) || typeof file.url !== \"string\" || typeof file.mediaType !== \"string\") continue;\n    files.push({\n      url: file.url,\n      mediaType: file.mediaType,\n      ...(typeof file.filename === \"string\" && { filename: file.filename }),\n    });\n  }\n  return files.length > 0 ? files : undefined;\n}\n\n/** The user message a message-carrying run send carries (`params[0].message`). */\nexport function runSendMessage(\n  command: { method: string; params: readonly unknown[] },\n): { id: string; parts: unknown[]; metadata?: Record<string, unknown> } | null {\n  if (!isMessageRunCommand(command)) return null;\n  const params = command.params[0];\n  if (!isRecord(params) || !isRecord(params.message)) return null;\n  const { id, parts, metadata } = params.message;\n  if (typeof id !== \"string\") return null;\n  return {\n    id,\n    parts: Array.isArray(parts) ? parts : [],\n    ...(isRecord(metadata) && { metadata }),\n  };\n}\n\n/**\n * The chat message an outbox entry carries, or `null` when it carries none (not a\n * message-carrying run send). `threadId` names the thread whose session holds it.\n */\nexport function chatOutboxEntryOf(entry: StatewireClient.OutboxEntry, threadId: string): ChatOutboxEntry | null {\n  const message = runSendMessage(entry.command);\n  if (message === null) return null;\n  const meta = readChatOutboxLocalMeta(entry.localMeta);\n  const text = message.parts\n    .flatMap((part) => (isRecord(part) && part.type === \"text\" && typeof part.text === \"string\" ? [part.text] : []))\n    .join(\"\\n\\n\");\n  const files = readFiles(message.parts.filter((part) => isRecord(part) && part.type === \"file\"));\n  return {\n    id: message.id,\n    outboxId: entry.id,\n    threadId: meta.threadId ?? threadId,\n    text,\n    queuedAt: meta.queuedAt ?? entry.ts,\n    newChat: meta.newChat ?? false,\n    durable: entry.durable,\n    ...(meta.composerMarkdown !== undefined && { composerMarkdown: meta.composerMarkdown }),\n    ...(meta.composerHtml !== undefined && { composerHtml: meta.composerHtml }),\n    ...(message.metadata !== undefined && { metadata: message.metadata }),\n    ...(files && { files }),\n    ...(meta.attachments && { attachments: meta.attachments }),\n  };\n}\n"],"names":["heldSendFailure","isMessageRunCommand"],"mappings":"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"}

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

@@ -0,0 +1,99 @@
+import type { StatewireClient } from "statewire";
+/**
+ * A chat message waiting in statewire's outbox, as the chat outbox shows it.
+ *
+ * The outbox entry is the record: its command is the `run/*` send that carries the message (text and
+ * files in `message.parts`, metadata on `message.metadata`), and its client-only `localMeta` keeps
+ * what the person's device needs and the server never sees ({@link ChatOutboxLocalMeta}). Both are
+ * persisted with the thread's statewire session (sealed on the device where the host keeps copies).
+ */
+/** An already-uploaded file a waiting message refers to (never a file picked while offline). */
+export interface ChatOutboxFile {
+    /** A server-backed URL (an asset's image route); never a `blob:` or `data:` URL. */
+    url: string;
+    mediaType: string;
+    filename?: string;
+}
+/**
+ * A file already in Athena that a waiting message carries: an upload that finished before Athena
+ * went out of reach. Its reference rides the message's text, as a sent message's does; this copy
+ * names it so the outbox can ask Athena, right before the message goes, that the file is still there
+ * and still the person's to open (`ChatOutboxOptions.checkAttachments`).
+ */
+export interface ChatOutboxAttachment {
+    assetId: string;
+    /** Its name, as the composer showed it. */
+    title: string;
+    mediaType?: string;
+}
+/** Marks a `localMeta` written by the chat outbox. */
+export declare const CHAT_OUTBOX_LOCAL_META_KIND = "athena-chat-outbox";
+/** The legacy store a migrated entry came from (`chat-outbox-legacy.ts`). */
+export declare const LEGACY_CHAT_OUTBOX_SOURCE = "athena-chat-outbox:v1";
+/** What an outbox entry of a chat message keeps on the device (`OutboxEntry.localMeta`). */
+export interface ChatOutboxLocalMeta {
+    kind?: typeof CHAT_OUTBOX_LOCAL_META_KIND;
+    threadId?: string;
+    /** When it was typed (epoch ms): a message that waited more than a day asks before it goes. */
+    queuedAt?: number;
+    /** Typed into a chat that had never started: reopening that chat finds it again. */
+    newChat?: boolean;
+    /** The composer draft the text was serialized from, for giving it back exactly as typed. */
+    composerMarkdown?: string;
+    /** The draft as an HTML composer holds it (the phone's), given back exactly on Cancel or Edit. */
+    composerHtml?: string;
+    /** The files already in Athena the message carries, asked about right before it goes. */
+    attachments?: ChatOutboxAttachment[];
+    /** When the running countdown sends it (epoch ms). */
+    countdownEndsAt?: number;
+    /** When that countdown started (epoch ms): a tab coming to the front starts an older one over. */
+    countdownFrom?: number;
+    /** The legacy store it was migrated from, and its id there. */
+    migratedFrom?: typeof LEGACY_CHAT_OUTBOX_SOURCE;
+    legacyId?: string;
+    /** Why it could not be sent (`statewire-held-sends.ts`); set, the row says "Couldn't send". */
+    error?: StatewireClient.SendFailure;
+}
+export interface ChatOutboxEntry {
+    /**
+     * The message id, minted when the message was typed. It is sent under it, so a send whose answer
+     * was lost never posts twice: the thread's host refuses an id it already holds.
+     */
+    id: string;
+    /** The statewire outbox entry that carries it (`undefined` while the session is still loading). */
+    outboxId?: string;
+    threadId: string;
+    /** The text exactly as it will be sent (what the model reads). */
+    text: string;
+    composerMarkdown?: string;
+    composerHtml?: string;
+    /** The message metadata frozen when it was typed (its composer markdown, the agents it names, …). */
+    metadata?: Record<string, unknown>;
+    files?: ChatOutboxFile[];
+    attachments?: ChatOutboxAttachment[];
+    /** When it was typed (epoch ms). */
+    queuedAt: number;
+    newChat: boolean;
+    /** Kept on the device (`false`: in page memory only, gone if the page closes). */
+    durable: boolean;
+}
+/** The chat outbox's view of an entry's `localMeta` (fields of the wrong type are dropped). */
+export declare function readChatOutboxLocalMeta(localMeta: unknown): ChatOutboxLocalMeta;
+/** `localMeta` without the countdown and the failure: what a send that goes again carries. */
+export declare function withoutTransientLocalMeta(localMeta: unknown): unknown;
+export declare function readAttachments(value: unknown): ChatOutboxAttachment[] | undefined;
+export declare function readFiles(value: unknown): ChatOutboxFile[] | undefined;
+/** The user message a message-carrying run send carries (`params[0].message`). */
+export declare function runSendMessage(command: {
+    method: string;
+    params: readonly unknown[];
+}): {
+    id: string;
+    parts: unknown[];
+    metadata?: Record<string, unknown>;
+} | null;
+/**
+ * The chat message an outbox entry carries, or `null` when it carries none (not a
+ * message-carrying run send). `threadId` names the thread whose session holds it.
+ */
+export declare function chatOutboxEntryOf(entry: StatewireClient.OutboxEntry, threadId: string): ChatOutboxEntry | null;