@athenaintel/react 0.56.0 → 0.57.0

package/README.md

@@ -567,6 +567,35 @@ only when it is an `https://github.com/<repo>/…` URL for that repository
 The full message text always reaches the model; the marker is provenance for
 rendering only.
 
+### Messages from Slack, email, texts and Teams
+
+A message that reached an agent over a channel arrives with two things from
+agora's channel routers: the `inbound_channel` envelope in
+`metadata.custom` (the channel, the sender's name and address or number, an
+email's subject), and a routing block at the start of its text
+(`<inbound-message-context>` … `</inbound-message-context>`: the Slack ids, the
+numbers a text went between, how a reply is delivered), which is how the model
+knows where the message came from.
+
+`AthenaChat`'s user message and the `chat-ui` `UserMessage` show the words that
+were sent, without the block, under one line: the channel's mark (Slack's and
+Teams' logos; a mail, text, API or voice-memo glyph), the sender's name and
+their address or number. Hovering the line shows the channel, the place (a
+DM, `#launch`, a group text) and the sender in full; clicking it opens what
+the agent received, every fact of the block labelled, with the Slack thread a
+mention came in. An email's subject is the bubble's first line. A typed
+message is unchanged.
+
+Only a message carrying the envelope is drawn this way. Tags someone types at
+the start of an ordinary chat message show as typed.
+
+A host with its own user message composes the same pieces:
+`InboundChannelLine` (the line, for the message in scope),
+`InboundChannelSubject`, and `withInboundMessageBody(Text)` (or
+`UserMessageText`, which already shows the words without the block).
+`isInboundChannelMessage(custom)` and `inboundMessageBody({ custom, text })`
+read a message without React.
+
 ## Sessions page and inbox
 
 A full-page, Devin-style session list and a notifications inbox, both on top
@@ -951,6 +980,19 @@ Both use the same bearer / API key as session creation. The full recipe
 template skill `voice-session-guide.md`. `createAthenaVoiceSession` is also
 exported if you hold the bridge state yourself.
 
+## What's new in 0.57.0
+
+**Messages from Slack, email, texts and Teams read as what was sent.** A message that reached the agent over a channel used to show, above its words, the routing block the channel writes for the agent: `<inbound-message-context>`, the Slack workspace and channel ids, the numbers a text went between, how a reply is delivered. `AthenaChat` and chat-ui's `UserMessage` now show:
+- **The words that were sent.** The block leaves the bubble, and so does what a channel puts ahead of the words for the agent: the Slack thread a mention came in, a group text's "<name> said:" line. An email's subject is the bubble's first line.
+- **Who sent it, from where.** A line above the bubble carries the channel's mark (Slack's and Teams' logos, a mail, text, API or voice-memo glyph), the sender's name and their email address or phone number. Hovering it shows the channel, the place (a DM, `#launch`, a group text) and the sender in full.
+- **What the agent received.** Clicking the line opens every fact the agent read with the message, labelled, and the thread it quoted.
+
+Nothing to change in your app. A message without the channel's envelope (tags someone typed) shows as typed. The hover card is plain CSS and the glyphs are icons the chat already draws, so the line adds no tooltip library to your bundle. Hosts with their own user message compose the same pieces (**Messages from Slack, email, texts and Teams**, above).
+
+Also in this release:
+- A session that ends under an open page signs back in instead of stranding the app on a sign-in screen (**When a session ends while the page is open**).
+- "Approve for this session" on a send (an email, a text) covers only the recipients the approval card named, and the card says so.
+
 ## What's new in 0.56.0
 
 **One history store per conversation, shared by every reader.** Older history read with `history/page` now lives in a per-conversation store that the thread, the history edge, edits and reveals all join. It no longer sits in a store `AthenaProvider` hands around. The store keeps each message by its parent, not its position:
@@ -2012,7 +2054,35 @@ If you need full control, `ssoUserInfoUrl`, `ssoLoginUrl`, and `ssoLogoutUrl` re
 - A transient failure (5xx, 408, 429, a network error, a timeout) is retried within the read, about 0.5 s, 1 s and 2 s apart, before `displayOnError` shows.
 - Only `unauthenticated` means the person has no session. `request_failed` means the endpoint did not answer usably; the person may well be signed in, so offer `retry` rather than sign-in.
 - `onError` receives the typed `auth_sso_failed` error of a read that gave up.
-- Without `displayOnError`, a person with no session is sent to `ssoLoginUrl`.
+- Without `displayOnError`, a person with no session is sent to `ssoLoginUrl`, with `return_to` set to the page.
+
+### When a session ends while the page is open
+
+A deployed app's session can end under an open tab: the person signs out of Athena elsewhere (the web app, the desktop app or the phone), or the host's session for the app expires. The tab finds out on its next credential read, a 401 from `/api/sso/userinfo` or `/_athena/auth`. The SDK then sends the page through sign-in once, with `return_to` set to the page, instead of showing a sign-in screen. A person still signed in to Athena in that browser comes straight back to the same page, signed in again, in a second or two. One who is not sees Athena's sign-in page first.
+
+A 403 there is the host refusing this person the app (Marathon's `not_authorized` or `unknown_asset`). Signing in again cannot change that, so a 403 never starts a trip.
+
+- **`AthenaSSOProvider`** does this for a session it served on this page (`signBackInOnSessionEnd`, default `true`). The app stays on screen until the page leaves. These show `displayOnError` as before:
+  - a 403;
+  - a first read with no session;
+  - a sign-out through `logout()`;
+  - `signBackInOnSessionEnd={false}`.
+- **`AthenaProvider`** does it through the Marathon bridge, but only when the bridge's token is the chat's credential. That means no sign-in provider above it, and no `token`, `getToken` or `apiKey` of the host's own, since those keep working when the bridge's session ends.
+  - The bridge goes to `/api/sso/initiate` when `/_athena/auth` refuses, with a 401, a renewal of a credential the page already minted.
+  - Never on the first mint: a page served on a preview grant alone has no session.
+  - Never on a 403, and never on a transient failure.
+  - The typed `auth_bridge_failed` error still reaches `onError` first.
+- **At most once per tab every two minutes** (`sessionStorage`). A second ending within that time, or a tab without `sessionStorage`, shows the sign-in state instead, so a trip that did not help never loops.
+  - `AthenaSSOProvider` without `displayOnError` keeps the same guard for its own redirect to `ssoLoginUrl`.
+  - Within two minutes of a trip, that provider renders nothing and logs a console warning instead of sending the page again.
+- **Hash routes come back.** Marathon returns to `return_to` without its URL fragment. The SDK keeps the fragment in the tab and puts it back (`location.replace`) when the page returns to the same path within ten minutes, so a hash-routed app (`/#/chat/123`) lands on the same route.
+- **The composer's draft comes back.** `AthenaProvider` keeps the draft right before the page leaves and puts it back when the page returns.
+  - Only for the same person (a sign-in provider names them), and within ten minutes. A draft kept for someone else is deleted unread.
+  - It returns into the conversation it was typed in. A draft typed in a new chat goes into the new chat the page comes back to.
+  - A page that comes back to a different conversation shows the draft when the person opens the original one. For example, a thread-list app that does not keep the open conversation in its URL (`threadId` or `initialThreadId`) comes back to a new chat.
+  - Text only: attachments are not carried.
+- **Your own state.** `ATHENA_SIGN_BACK_IN_EVENT` (from `@athenaintel/react/auth`) is dispatched on `window` right before the page leaves, while the app is still mounted.
+- **Diagnostics.** Each ending emits `auth.session.ended` with `{ source: 'sso' | 'bridge', status, sign_back_in }`.
 
 ## Mentions and citations
 

package/dist/agent-runtime/src/inbound-channel.cjs

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const INBOUND_CHANNEL_KEY = "inbound_channel";
+const INBOUND_CONTEXT_OPEN = "<inbound-message-context>";
+const LEADING_CONTEXT = /^<inbound-message-context>([\s\S]*?)<\/inbound-message-context>\n*/;
+const SLACK_QUOTED_THREAD_OPEN = "Earlier messages in this Slack thread (oldest first):";
+const SLACK_QUOTED_THREAD_MESSAGE = "The message that mentioned you:";
+const GROUP_TEXT_SOURCE = "Group SMS text message";
+function leadingInboundContext(text) {
+  if (!text.startsWith(INBOUND_CONTEXT_OPEN)) return null;
+  const match = LEADING_CONTEXT.exec(text);
+  if (match === null) return null;
+  return {
+    raw: match[0].trimEnd(),
+    lines: match[1] ?? "",
+    rest: text.slice(match[0].length).trimStart()
+  };
+}
+function inboundContextValue(lines, key) {
+  for (const line of lines.split("\n")) {
+    const separator = line.indexOf(":");
+    if (separator > 0 && line.slice(0, separator).trim() === key) {
+      return line.slice(separator + 1).trim() || null;
+    }
+  }
+  return null;
+}
+function stripInboundContext(text) {
+  var _a;
+  return ((_a = leadingInboundContext(text)) == null ? void 0 : _a.rest) ?? text;
+}
+function splitInboundBody(context) {
+  const { lines, rest } = context;
+  const source = inboundContextValue(lines, "source");
+  if (source === "Slack" && rest.startsWith(`${SLACK_QUOTED_THREAD_OPEN}
+`)) {
+    const marker = `
+
+${SLACK_QUOTED_THREAD_MESSAGE}`;
+    const at = rest.indexOf(marker);
+    if (at !== -1) {
+      const quoted = rest.slice(SLACK_QUOTED_THREAD_OPEN.length, at).trim();
+      return { body: rest.slice(at + marker.length).trimStart(), quoted: quoted || null };
+    }
+  }
+  if (source === GROUP_TEXT_SOURCE) {
+    const sender = inboundContextValue(lines, "sender_name");
+    const newline = rest.indexOf("\n");
+    const firstLine = newline === -1 ? rest : rest.slice(0, newline);
+    if (sender && firstLine.endsWith(GROUP_TEXT_SAID) && collapseWhitespace(firstLine.slice(0, -GROUP_TEXT_SAID.length)) === sender) {
+      return { body: newline === -1 ? "" : rest.slice(newline + 1), quoted: null };
+    }
+  }
+  return { body: rest, quoted: null };
+}
+const GROUP_TEXT_SAID = " said:";
+function collapseWhitespace(value) {
+  return value.split(/\s+/).filter((word) => word.length > 0).join(" ");
+}
+function envelopeOf(custom) {
+  const raw = custom == null ? void 0 : custom[INBOUND_CHANNEL_KEY];
+  return typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : null;
+}
+function envelopeString(envelope, key) {
+  const value = envelope[key];
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function isInboundChannelMessage(custom) {
+  const envelope = envelopeOf(custom);
+  return envelope !== null && envelopeString(envelope, "channel") !== null;
+}
+function inboundMessageBody({
+  custom,
+  text
+}) {
+  if (!isInboundChannelMessage(custom)) return text;
+  const context = leadingInboundContext(text);
+  return context === null ? text : splitInboundBody(context).body;
+}
+function inboundEmailSubject(custom) {
+  const envelope = envelopeOf(custom);
+  if (envelope === null) return null;
+  const channel = envelopeString(envelope, "channel");
+  return channel === "email" || channel === "agent_email" ? envelopeString(envelope, "subject") : null;
+}
+exports.GROUP_TEXT_SOURCE = GROUP_TEXT_SOURCE;
+exports.INBOUND_CHANNEL_KEY = INBOUND_CHANNEL_KEY;
+exports.INBOUND_CONTEXT_OPEN = INBOUND_CONTEXT_OPEN;
+exports.inboundContextValue = inboundContextValue;
+exports.inboundEmailSubject = inboundEmailSubject;
+exports.inboundMessageBody = inboundMessageBody;
+exports.isInboundChannelMessage = isInboundChannelMessage;
+exports.leadingInboundContext = leadingInboundContext;
+exports.splitInboundBody = splitInboundBody;
+exports.stripInboundContext = stripInboundContext;
+//# sourceMappingURL=inbound-channel.cjs.map

package/dist/agent-runtime/src/inbound-channel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-channel.cjs","sources":["../../../../agent-runtime/src/inbound-channel.ts"],"sourcesContent":["/**\n * A user turn that reached the agent through a channel (Slack, email, a\n * text, Microsoft Teams, the Programmatic API, a voice memo): the reading\n * every client needs on every user bubble, kept small.\n *\n * Two things arrive with such a turn (agora\n * `services/channels/inbound_channel.py`):\n *\n * - The `inbound_channel` envelope in its message metadata, which the shipped\n *   converter exposes as `metadata.custom.inbound_channel`: the channel, who\n *   sent it (a name and an address or number), an email's subject and the\n *   files the channel imported. Metadata never reaches the model.\n * - A routing block at the very start of its text, between\n *   `<inbound-message-context>` tags: one `key: value` line per fact the agent\n *   is told (the Slack channel and ids, the numbers a text went between, an\n *   email's recipients, how a reply is delivered). Text is the model's only\n *   way to know where a message came from, so the block stays in it.\n *\n * A person reads the words that were sent ({@link inboundMessageBody}), marked\n * with the channel and the sender; what the agent read is there on request\n * (the SDK's channel line, which loads its full reading only when a channel\n * message is shown). A message is a channel message only when it carries the\n * envelope: anyone can type the tags at the start of a chat message, and\n * their words then show as typed.\n */\n\n/** `metadata.custom` key the channel routers stamp on an inbound user turn. */\nexport const INBOUND_CHANNEL_KEY = 'inbound_channel';\n\n/** The routing block's tags (agora `INBOUND_CONTEXT_OPEN` / `INBOUND_CONTEXT_CLOSE`). */\nexport const INBOUND_CONTEXT_OPEN = '<inbound-message-context>';\nexport const INBOUND_CONTEXT_CLOSE = '</inbound-message-context>';\n\n/**\n * Anchored to the start: routers only ever prepend the block, so a sender who\n * types the tags inside their own words keeps that text (agora\n * `_LEADING_CONTEXT_RE`, Olympus `stripInboundContext`).\n */\nconst LEADING_CONTEXT = /^<inbound-message-context>([\\s\\S]*?)<\\/inbound-message-context>\\n*/;\n\n/**\n * The lines the Slack router puts around the thread a mention came in, when\n * the mention starts a conversation (agora `slack_router._build_message_text`).\n */\nconst SLACK_QUOTED_THREAD_OPEN = 'Earlier messages in this Slack thread (oldest first):';\nconst SLACK_QUOTED_THREAD_MESSAGE = 'The message that mentioned you:';\n\n/** The `source:` a group text's block names (agora `sms_group_router`). */\nexport const GROUP_TEXT_SOURCE = 'Group SMS text message';\n\n/** The routing block at the start of a message's text, as read without labels. */\nexport interface LeadingInboundContext {\n  /** The block exactly as the agent read it, tags included. */\n  readonly raw: string;\n  /** The `key: value` lines between the tags. */\n  readonly lines: string;\n  /** The text after the block. */\n  readonly rest: string;\n}\n\n/** The routing block at the start of `text`, or `null` when the text does not start with one. */\nexport function leadingInboundContext(text: string): LeadingInboundContext | null {\n  if (!text.startsWith(INBOUND_CONTEXT_OPEN)) return null;\n  const match = LEADING_CONTEXT.exec(text);\n  if (match === null) return null;\n  return {\n    raw: match[0].trimEnd(),\n    lines: match[1] ?? '',\n    rest: text.slice(match[0].length).trimStart(),\n  };\n}\n\n/** The block's value for `key` (its first `key: value` line), or `null`. */\nexport function inboundContextValue(lines: string, key: string): string | null {\n  for (const line of lines.split('\\n')) {\n    const separator = line.indexOf(':');\n    if (separator > 0 && line.slice(0, separator).trim() === key) {\n      return line.slice(separator + 1).trim() || null;\n    }\n  }\n  return null;\n}\n\n/** The text with a leading routing block removed (agora `strip_inbound_context`). */\nexport function stripInboundContext(text: string): string {\n  return leadingInboundContext(text)?.rest ?? text;\n}\n\n/**\n * The words after the block, without what a channel put ahead of them for\n * the agent: the Slack thread a mention came in (returned as `quoted`), a\n * group text's \"<name> said:\" line.\n */\nexport function splitInboundBody(context: LeadingInboundContext): {\n  readonly body: string;\n  readonly quoted: string | null;\n} {\n  const { lines, rest } = context;\n  const source = inboundContextValue(lines, 'source');\n  if (source === 'Slack' && rest.startsWith(`${SLACK_QUOTED_THREAD_OPEN}\\n`)) {\n    const marker = `\\n\\n${SLACK_QUOTED_THREAD_MESSAGE}`;\n    const at = rest.indexOf(marker);\n    if (at !== -1) {\n      const quoted = rest.slice(SLACK_QUOTED_THREAD_OPEN.length, at).trim();\n      return { body: rest.slice(at + marker.length).trimStart(), quoted: quoted || null };\n    }\n  }\n  if (source === GROUP_TEXT_SOURCE) {\n    // The block's values have their whitespace collapsed (agora\n    // `build_inbound_context_block`); the \"<name> said:\" line keeps the name\n    // as saved, so the two compare collapsed.\n    const sender = inboundContextValue(lines, 'sender_name');\n    const newline = rest.indexOf('\\n');\n    const firstLine = newline === -1 ? rest : rest.slice(0, newline);\n    if (sender && firstLine.endsWith(GROUP_TEXT_SAID) && collapseWhitespace(firstLine.slice(0, -GROUP_TEXT_SAID.length)) === sender) {\n      return { body: newline === -1 ? '' : rest.slice(newline + 1), quoted: null };\n    }\n  }\n  return { body: rest, quoted: null };\n}\n\n/** What follows the sender's name on a group text's first line (agora `_build_group_message_text`). */\nconst GROUP_TEXT_SAID = ' said:';\n\nfunction collapseWhitespace(value: string): string {\n  return value.split(/\\s+/).filter((word) => word.length > 0).join(' ');\n}\n\nfunction envelopeOf(custom: Record<string, unknown> | null | undefined): Record<string, unknown> | null {\n  const raw = custom?.[INBOUND_CHANNEL_KEY];\n  return typeof raw === 'object' && raw !== null && !Array.isArray(raw)\n    ? (raw as Record<string, unknown>)\n    : null;\n}\n\nfunction envelopeString(envelope: Record<string, unknown>, key: string): string | null {\n  const value = envelope[key];\n  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null;\n}\n\n/**\n * Whether a thread message came in over a channel: it carries the\n * `inbound_channel` envelope with a channel. A primitive, so safe as a\n * `useAuiState` selector.\n */\nexport function isInboundChannelMessage(custom: Record<string, unknown> | null | undefined): boolean {\n  const envelope = envelopeOf(custom);\n  return envelope !== null && envelopeString(envelope, 'channel') !== null;\n}\n\n/**\n * What the person wrote: a channel message's `text` without its leading\n * routing block and what the channel quoted ahead of the words. Any other\n * text comes back unchanged: a message without the envelope (tags someone\n * typed stay as typed), and text without a block. Safe on every user turn and\n * on its own output.\n */\nexport function inboundMessageBody({\n  custom,\n  text,\n}: {\n  custom: Record<string, unknown> | null | undefined;\n  text: string;\n}): string {\n  if (!isInboundChannelMessage(custom)) return text;\n  const context = leadingInboundContext(text);\n  return context === null ? text : splitInboundBody(context).body;\n}\n\n/** An email's subject, from the envelope; `null` for any other message. */\nexport function inboundEmailSubject(custom: Record<string, unknown> | null | undefined): string | null {\n  const envelope = envelopeOf(custom);\n  if (envelope === null) return null;\n  const channel = envelopeString(envelope, 'channel');\n  return channel === 'email' || channel === 'agent_email' ? envelopeString(envelope, 'subject') : null;\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/inbound-channel.d.ts

@@ -0,0 +1,75 @@
+/**
+ * A user turn that reached the agent through a channel (Slack, email, a
+ * text, Microsoft Teams, the Programmatic API, a voice memo): the reading
+ * every client needs on every user bubble, kept small.
+ *
+ * Two things arrive with such a turn (agora
+ * `services/channels/inbound_channel.py`):
+ *
+ * - The `inbound_channel` envelope in its message metadata, which the shipped
+ *   converter exposes as `metadata.custom.inbound_channel`: the channel, who
+ *   sent it (a name and an address or number), an email's subject and the
+ *   files the channel imported. Metadata never reaches the model.
+ * - A routing block at the very start of its text, between
+ *   `<inbound-message-context>` tags: one `key: value` line per fact the agent
+ *   is told (the Slack channel and ids, the numbers a text went between, an
+ *   email's recipients, how a reply is delivered). Text is the model's only
+ *   way to know where a message came from, so the block stays in it.
+ *
+ * A person reads the words that were sent ({@link inboundMessageBody}), marked
+ * with the channel and the sender; what the agent read is there on request
+ * (the SDK's channel line, which loads its full reading only when a channel
+ * message is shown). A message is a channel message only when it carries the
+ * envelope: anyone can type the tags at the start of a chat message, and
+ * their words then show as typed.
+ */
+/** `metadata.custom` key the channel routers stamp on an inbound user turn. */
+export declare const INBOUND_CHANNEL_KEY = "inbound_channel";
+/** The routing block's tags (agora `INBOUND_CONTEXT_OPEN` / `INBOUND_CONTEXT_CLOSE`). */
+export declare const INBOUND_CONTEXT_OPEN = "<inbound-message-context>";
+export declare const INBOUND_CONTEXT_CLOSE = "</inbound-message-context>";
+/** The `source:` a group text's block names (agora `sms_group_router`). */
+export declare const GROUP_TEXT_SOURCE = "Group SMS text message";
+/** The routing block at the start of a message's text, as read without labels. */
+export interface LeadingInboundContext {
+    /** The block exactly as the agent read it, tags included. */
+    readonly raw: string;
+    /** The `key: value` lines between the tags. */
+    readonly lines: string;
+    /** The text after the block. */
+    readonly rest: string;
+}
+/** The routing block at the start of `text`, or `null` when the text does not start with one. */
+export declare function leadingInboundContext(text: string): LeadingInboundContext | null;
+/** The block's value for `key` (its first `key: value` line), or `null`. */
+export declare function inboundContextValue(lines: string, key: string): string | null;
+/** The text with a leading routing block removed (agora `strip_inbound_context`). */
+export declare function stripInboundContext(text: string): string;
+/**
+ * The words after the block, without what a channel put ahead of them for
+ * the agent: the Slack thread a mention came in (returned as `quoted`), a
+ * group text's "<name> said:" line.
+ */
+export declare function splitInboundBody(context: LeadingInboundContext): {
+    readonly body: string;
+    readonly quoted: string | null;
+};
+/**
+ * Whether a thread message came in over a channel: it carries the
+ * `inbound_channel` envelope with a channel. A primitive, so safe as a
+ * `useAuiState` selector.
+ */
+export declare function isInboundChannelMessage(custom: Record<string, unknown> | null | undefined): boolean;
+/**
+ * What the person wrote: a channel message's `text` without its leading
+ * routing block and what the channel quoted ahead of the words. Any other
+ * text comes back unchanged: a message without the envelope (tags someone
+ * typed stay as typed), and text without a block. Safe on every user turn and
+ * on its own output.
+ */
+export declare function inboundMessageBody({ custom, text, }: {
+    custom: Record<string, unknown> | null | undefined;
+    text: string;
+}): string;
+/** An email's subject, from the envelope; `null` for any other message. */
+export declare function inboundEmailSubject(custom: Record<string, unknown> | null | undefined): string | null;

package/dist/agent-runtime/src/inbound-channel.js

@@ -0,0 +1,96 @@
+const INBOUND_CHANNEL_KEY = "inbound_channel";
+const INBOUND_CONTEXT_OPEN = "<inbound-message-context>";
+const LEADING_CONTEXT = /^<inbound-message-context>([\s\S]*?)<\/inbound-message-context>\n*/;
+const SLACK_QUOTED_THREAD_OPEN = "Earlier messages in this Slack thread (oldest first):";
+const SLACK_QUOTED_THREAD_MESSAGE = "The message that mentioned you:";
+const GROUP_TEXT_SOURCE = "Group SMS text message";
+function leadingInboundContext(text) {
+  if (!text.startsWith(INBOUND_CONTEXT_OPEN)) return null;
+  const match = LEADING_CONTEXT.exec(text);
+  if (match === null) return null;
+  return {
+    raw: match[0].trimEnd(),
+    lines: match[1] ?? "",
+    rest: text.slice(match[0].length).trimStart()
+  };
+}
+function inboundContextValue(lines, key) {
+  for (const line of lines.split("\n")) {
+    const separator = line.indexOf(":");
+    if (separator > 0 && line.slice(0, separator).trim() === key) {
+      return line.slice(separator + 1).trim() || null;
+    }
+  }
+  return null;
+}
+function stripInboundContext(text) {
+  var _a;
+  return ((_a = leadingInboundContext(text)) == null ? void 0 : _a.rest) ?? text;
+}
+function splitInboundBody(context) {
+  const { lines, rest } = context;
+  const source = inboundContextValue(lines, "source");
+  if (source === "Slack" && rest.startsWith(`${SLACK_QUOTED_THREAD_OPEN}
+`)) {
+    const marker = `
+
+${SLACK_QUOTED_THREAD_MESSAGE}`;
+    const at = rest.indexOf(marker);
+    if (at !== -1) {
+      const quoted = rest.slice(SLACK_QUOTED_THREAD_OPEN.length, at).trim();
+      return { body: rest.slice(at + marker.length).trimStart(), quoted: quoted || null };
+    }
+  }
+  if (source === GROUP_TEXT_SOURCE) {
+    const sender = inboundContextValue(lines, "sender_name");
+    const newline = rest.indexOf("\n");
+    const firstLine = newline === -1 ? rest : rest.slice(0, newline);
+    if (sender && firstLine.endsWith(GROUP_TEXT_SAID) && collapseWhitespace(firstLine.slice(0, -GROUP_TEXT_SAID.length)) === sender) {
+      return { body: newline === -1 ? "" : rest.slice(newline + 1), quoted: null };
+    }
+  }
+  return { body: rest, quoted: null };
+}
+const GROUP_TEXT_SAID = " said:";
+function collapseWhitespace(value) {
+  return value.split(/\s+/).filter((word) => word.length > 0).join(" ");
+}
+function envelopeOf(custom) {
+  const raw = custom == null ? void 0 : custom[INBOUND_CHANNEL_KEY];
+  return typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : null;
+}
+function envelopeString(envelope, key) {
+  const value = envelope[key];
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function isInboundChannelMessage(custom) {
+  const envelope = envelopeOf(custom);
+  return envelope !== null && envelopeString(envelope, "channel") !== null;
+}
+function inboundMessageBody({
+  custom,
+  text
+}) {
+  if (!isInboundChannelMessage(custom)) return text;
+  const context = leadingInboundContext(text);
+  return context === null ? text : splitInboundBody(context).body;
+}
+function inboundEmailSubject(custom) {
+  const envelope = envelopeOf(custom);
+  if (envelope === null) return null;
+  const channel = envelopeString(envelope, "channel");
+  return channel === "email" || channel === "agent_email" ? envelopeString(envelope, "subject") : null;
+}
+export {
+  GROUP_TEXT_SOURCE,
+  INBOUND_CHANNEL_KEY,
+  INBOUND_CONTEXT_OPEN,
+  inboundContextValue,
+  inboundEmailSubject,
+  inboundMessageBody,
+  isInboundChannelMessage,
+  leadingInboundContext,
+  splitInboundBody,
+  stripInboundContext
+};
+//# sourceMappingURL=inbound-channel.js.map

package/dist/agent-runtime/src/inbound-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-channel.js","sources":["../../../../agent-runtime/src/inbound-channel.ts"],"sourcesContent":["/**\n * A user turn that reached the agent through a channel (Slack, email, a\n * text, Microsoft Teams, the Programmatic API, a voice memo): the reading\n * every client needs on every user bubble, kept small.\n *\n * Two things arrive with such a turn (agora\n * `services/channels/inbound_channel.py`):\n *\n * - The `inbound_channel` envelope in its message metadata, which the shipped\n *   converter exposes as `metadata.custom.inbound_channel`: the channel, who\n *   sent it (a name and an address or number), an email's subject and the\n *   files the channel imported. Metadata never reaches the model.\n * - A routing block at the very start of its text, between\n *   `<inbound-message-context>` tags: one `key: value` line per fact the agent\n *   is told (the Slack channel and ids, the numbers a text went between, an\n *   email's recipients, how a reply is delivered). Text is the model's only\n *   way to know where a message came from, so the block stays in it.\n *\n * A person reads the words that were sent ({@link inboundMessageBody}), marked\n * with the channel and the sender; what the agent read is there on request\n * (the SDK's channel line, which loads its full reading only when a channel\n * message is shown). A message is a channel message only when it carries the\n * envelope: anyone can type the tags at the start of a chat message, and\n * their words then show as typed.\n */\n\n/** `metadata.custom` key the channel routers stamp on an inbound user turn. */\nexport const INBOUND_CHANNEL_KEY = 'inbound_channel';\n\n/** The routing block's tags (agora `INBOUND_CONTEXT_OPEN` / `INBOUND_CONTEXT_CLOSE`). */\nexport const INBOUND_CONTEXT_OPEN = '<inbound-message-context>';\nexport const INBOUND_CONTEXT_CLOSE = '</inbound-message-context>';\n\n/**\n * Anchored to the start: routers only ever prepend the block, so a sender who\n * types the tags inside their own words keeps that text (agora\n * `_LEADING_CONTEXT_RE`, Olympus `stripInboundContext`).\n */\nconst LEADING_CONTEXT = /^<inbound-message-context>([\\s\\S]*?)<\\/inbound-message-context>\\n*/;\n\n/**\n * The lines the Slack router puts around the thread a mention came in, when\n * the mention starts a conversation (agora `slack_router._build_message_text`).\n */\nconst SLACK_QUOTED_THREAD_OPEN = 'Earlier messages in this Slack thread (oldest first):';\nconst SLACK_QUOTED_THREAD_MESSAGE = 'The message that mentioned you:';\n\n/** The `source:` a group text's block names (agora `sms_group_router`). */\nexport const GROUP_TEXT_SOURCE = 'Group SMS text message';\n\n/** The routing block at the start of a message's text, as read without labels. */\nexport interface LeadingInboundContext {\n  /** The block exactly as the agent read it, tags included. */\n  readonly raw: string;\n  /** The `key: value` lines between the tags. */\n  readonly lines: string;\n  /** The text after the block. */\n  readonly rest: string;\n}\n\n/** The routing block at the start of `text`, or `null` when the text does not start with one. */\nexport function leadingInboundContext(text: string): LeadingInboundContext | null {\n  if (!text.startsWith(INBOUND_CONTEXT_OPEN)) return null;\n  const match = LEADING_CONTEXT.exec(text);\n  if (match === null) return null;\n  return {\n    raw: match[0].trimEnd(),\n    lines: match[1] ?? '',\n    rest: text.slice(match[0].length).trimStart(),\n  };\n}\n\n/** The block's value for `key` (its first `key: value` line), or `null`. */\nexport function inboundContextValue(lines: string, key: string): string | null {\n  for (const line of lines.split('\\n')) {\n    const separator = line.indexOf(':');\n    if (separator > 0 && line.slice(0, separator).trim() === key) {\n      return line.slice(separator + 1).trim() || null;\n    }\n  }\n  return null;\n}\n\n/** The text with a leading routing block removed (agora `strip_inbound_context`). */\nexport function stripInboundContext(text: string): string {\n  return leadingInboundContext(text)?.rest ?? text;\n}\n\n/**\n * The words after the block, without what a channel put ahead of them for\n * the agent: the Slack thread a mention came in (returned as `quoted`), a\n * group text's \"<name> said:\" line.\n */\nexport function splitInboundBody(context: LeadingInboundContext): {\n  readonly body: string;\n  readonly quoted: string | null;\n} {\n  const { lines, rest } = context;\n  const source = inboundContextValue(lines, 'source');\n  if (source === 'Slack' && rest.startsWith(`${SLACK_QUOTED_THREAD_OPEN}\\n`)) {\n    const marker = `\\n\\n${SLACK_QUOTED_THREAD_MESSAGE}`;\n    const at = rest.indexOf(marker);\n    if (at !== -1) {\n      const quoted = rest.slice(SLACK_QUOTED_THREAD_OPEN.length, at).trim();\n      return { body: rest.slice(at + marker.length).trimStart(), quoted: quoted || null };\n    }\n  }\n  if (source === GROUP_TEXT_SOURCE) {\n    // The block's values have their whitespace collapsed (agora\n    // `build_inbound_context_block`); the \"<name> said:\" line keeps the name\n    // as saved, so the two compare collapsed.\n    const sender = inboundContextValue(lines, 'sender_name');\n    const newline = rest.indexOf('\\n');\n    const firstLine = newline === -1 ? rest : rest.slice(0, newline);\n    if (sender && firstLine.endsWith(GROUP_TEXT_SAID) && collapseWhitespace(firstLine.slice(0, -GROUP_TEXT_SAID.length)) === sender) {\n      return { body: newline === -1 ? '' : rest.slice(newline + 1), quoted: null };\n    }\n  }\n  return { body: rest, quoted: null };\n}\n\n/** What follows the sender's name on a group text's first line (agora `_build_group_message_text`). */\nconst GROUP_TEXT_SAID = ' said:';\n\nfunction collapseWhitespace(value: string): string {\n  return value.split(/\\s+/).filter((word) => word.length > 0).join(' ');\n}\n\nfunction envelopeOf(custom: Record<string, unknown> | null | undefined): Record<string, unknown> | null {\n  const raw = custom?.[INBOUND_CHANNEL_KEY];\n  return typeof raw === 'object' && raw !== null && !Array.isArray(raw)\n    ? (raw as Record<string, unknown>)\n    : null;\n}\n\nfunction envelopeString(envelope: Record<string, unknown>, key: string): string | null {\n  const value = envelope[key];\n  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null;\n}\n\n/**\n * Whether a thread message came in over a channel: it carries the\n * `inbound_channel` envelope with a channel. A primitive, so safe as a\n * `useAuiState` selector.\n */\nexport function isInboundChannelMessage(custom: Record<string, unknown> | null | undefined): boolean {\n  const envelope = envelopeOf(custom);\n  return envelope !== null && envelopeString(envelope, 'channel') !== null;\n}\n\n/**\n * What the person wrote: a channel message's `text` without its leading\n * routing block and what the channel quoted ahead of the words. Any other\n * text comes back unchanged: a message without the envelope (tags someone\n * typed stay as typed), and text without a block. Safe on every user turn and\n * on its own output.\n */\nexport function inboundMessageBody({\n  custom,\n  text,\n}: {\n  custom: Record<string, unknown> | null | undefined;\n  text: string;\n}): string {\n  if (!isInboundChannelMessage(custom)) return text;\n  const context = leadingInboundContext(text);\n  return context === null ? text : splitInboundBody(context).body;\n}\n\n/** An email's subject, from the envelope; `null` for any other message. */\nexport function inboundEmailSubject(custom: Record<string, unknown> | null | undefined): string | null {\n  const envelope = envelopeOf(custom);\n  if (envelope === null) return null;\n  const channel = envelopeString(envelope, 'channel');\n  return channel === 'email' || channel === 'agent_email' ? envelopeString(envelope, 'subject') : null;\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/index.d.ts

@@ -11,7 +11,7 @@ export { type ConversationListController, useConversationList, type UseConversat
 export { CLIENT_TOOL_RESULT_STATUS_ERROR, CLIENT_TOOL_RESULT_STATUS_SUCCESS, CLIENT_TOOL_RESULT_STATUSES, type ClientToolResultEnvelopeContract, type ClientToolResultStatus, DEEP_AGENT_CONTEXT_PROTOCOL, DEEP_AGENT_CUT_LANE_DOCUMENT, DEEP_AGENT_DEFAULT_MESSAGE_WINDOW, DEEP_AGENT_FOLLOW_TOOL_CALL_ID_KEY, DEEP_AGENT_INTEREST_PROTOCOL, DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION, DEEP_AGENT_LANE_FOLLOW_PROTOCOL_VERSION, DEEP_AGENT_MAIN_NS, DEEP_AGENT_MAX_FOLLOWED_STEPS, DEEP_AGENT_MAX_LANE_PAGE, DEEP_AGENT_HISTORY_IMAGE_COMMAND, DEEP_AGENT_HISTORY_LANE_COMMAND, DEEP_AGENT_HISTORY_LANE_IMAGE_COMMAND, DEEP_AGENT_HISTORY_LANE_PAGE_CHARS, DEEP_AGENT_HISTORY_MESSAGE_COMMAND, DEEP_AGENT_HISTORY_PAGE_COMMAND, DEEP_AGENT_HISTORY_PAGE_PROTOCOL_VERSION, DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND, DEEP_AGENT_INLINE_IMAGE_WIRE_BUDGET, DEEP_AGENT_MAX_HELD_HEAD, DEEP_AGENT_MAX_HISTORY_PAGE_STEPS, DEEP_AGENT_MAX_HISTORY_PAGE_TURNS, DEEP_AGENT_MESSAGE_HISTORY_HEADER, DEEP_AGENT_MESSAGE_HISTORY_PAGED, DEEP_AGENT_MAX_INTERESTS, DEEP_AGENT_MAX_MESSAGE_WINDOW, DEEP_AGENT_MESSAGE_WINDOW_HEADER, DEEP_AGENT_MIN_MESSAGE_WINDOW, DEEP_AGENT_OMITTED_IMAGE_KEY, DEEP_AGENT_OMITTED_IMAGE_PLACEHOLDER_URL, DEEP_AGENT_PROTOCOL_STATE_KEY, DEEP_AGENT_PROTOCOL_VERSION, DEEP_AGENT_PROTOCOL_VERSION_HEADER, DEEP_AGENT_REPEATS_RESULT_KEY, DEEP_AGENT_RUNNING_LANE_WIRE_MESSAGES, DEEP_AGENT_RUNTIME_MARKER, DEEP_AGENT_TRUNCATED_CONTENT_KEY, DEEP_AGENT_TRUNCATED_LANE_KEY, KNOWN_START_CHANNEL_SET, KNOWN_START_CHANNELS, type KnownStartChannel, RUN_CONFIG_COMPANION_CUSTOM_KEYS, RUN_CONFIG_CUSTOM_KEY_SET, RUN_CONFIG_CUSTOM_KEYS, RUN_CONFIG_PARSED_CUSTOM_KEYS, RUN_CONFIG_PER_SEND_CUSTOM_KEY_SET, RUN_CONFIG_PER_SEND_CUSTOM_KEYS, type RunConfigCustomKey, type RunConfigPerSendCustomKey, DEEP_AGENT_CONFIG_COMMANDS, DEEP_AGENT_CONFIG_STATE_KEY, THREAD_CONFIG_CUSTOM_KEY_SET, THREAD_CONFIG_CUSTOM_KEYS, type ThreadConfigCustomKey, } from "./generated/runconfig-contract";
 export { COLLAB_AGENT_CHANNEL_SESSION_MISMATCH, CONVERSATION_ARCHIVED, CONVERSATION_ARCHIVED_MESSAGE, isConversationArchivedRejection, isLegacyThreadReadOnlyRejection, isStatewireChannelTeardown, isStatewireCommandAuthContextExpired, isStatewireExpiredVerdict, isStatewireRewindAnchorRejection, projectDeepAgentConnection, readRetryableCommandRejection, readRetryableRunRefusal, readRunStartRefusal, type RetryableCommandRejection, type RetryableRunRefusal, type RunStartRefusal, STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED, statewireRejectionCode, isVoiceCommandRejection, statewireRejectionDetailMessage, statewireRejectionPayload, type StatewireRejectionPayload, statewireTransportOutcome, } from "./errors";
 export { type ParsedExecuteOutput, parseExecuteOutput, type ShellCommandSummary, summarizeShellCommand, } from "./execute-output";
-export { type AbandonedInputRequest, type ApprovalResumeLock, asHitlApproval, canApproveForSession, DEFAULT_INTERRUPT_PAUSED_MESSAGE, fanLaneDecision, findAbandonedInterrupt, HITL_PENDING_RESUME_GRACE_MS, HITL_REJECT_REASON, HITL_RESUME_TRANSPORT_RETRIES, type HitlActionDecision, type HitlApprovalPayload, actionRequestToolCallIds, hitlResumeActionDecisions, hitlResumeApprove, hitlResumeApproveForSession, INTERRUPT_DECLINE_REASON, interruptMirrorPayload, interruptResumeDecline, hitlResumeReject, isApprovalCardInterrupt, isPendingInterrupt, isResumeTransportLoss, isSystemPauseInterrupt, laneInterruptIds, type PendingActionRequest, type PendingApprovalContext, type PendingApprovalFact, type PendingApprovalTitle, type PendingApprovalWarning, parsePendingApprovalContext, pendingActionRequests, pendingApprovalTitle, readAbandonedInputRequests, readInterruptMessage, readInterruptMirror, readQueuedLaneDecisions, type ResumeExtras, resumeValueApproves, toolCallIdsAwaitingApproval, useApprovalResumeLock, type UseApprovalResumeLockOptions, } from "./interrupts";
+export { type AbandonedInputRequest, type ApprovalResumeLock, asHitlApproval, canApproveForSession, DEFAULT_INTERRUPT_PAUSED_MESSAGE, fanLaneDecision, findAbandonedInterrupt, HITL_PENDING_RESUME_GRACE_MS, HITL_REJECT_REASON, HITL_RESUME_TRANSPORT_RETRIES, type HitlActionDecision, type HitlApprovalPayload, actionRequestToolCallIds, hitlResumeActionDecisions, hitlResumeApprove, hitlResumeApproveForSession, INTERRUPT_DECLINE_REASON, interruptMirrorPayload, interruptResumeDecline, hitlResumeReject, isApprovalCardInterrupt, isPendingInterrupt, isResumeTransportLoss, isSystemPauseInterrupt, laneInterruptIds, type PendingActionRequest, type PendingApprovalContext, type PendingApprovalFact, type PendingApprovalTitle, type PendingApprovalWarning, parsePendingApprovalContext, pendingActionRequests, pendingApprovalTitle, readAbandonedInputRequests, readInterruptMessage, readInterruptMirror, readQueuedLaneDecisions, type ResumeExtras, resumeValueApproves, type SessionApprovalOffer, sessionApprovalLabel, sessionApprovalOffer, toolCallIdsAwaitingApproval, useApprovalResumeLock, type UseApprovalResumeLockOptions, visibleText, } from "./interrupts";
 export { type AgoraFetch, bareDecisionThreadId, type BrowserDecisionCheckOutcome, DECISION_CHECK_HEADER, type DecisionCheckClient, type DecisionCheckClientKind, type DecisionCheckDescriptor, DecisionCheckKind, MAX_DECISIONS_PER_CHECK, type PendingBrowserDecisionCheck, respondDecisionDescriptor, type RunBrowserDecisionCheckOptions, runBrowserDecisionCheck, type StatewireAnswerForCheck, statewireAnswerDescriptors, } from "./decision-checks";
 export { buildQueueEditCommand, buildStatewireQueueRows, describeQueueSendFailure, isFailedSendEntryRace, isQueueEntryUnsettled, QUEUE_AUTO_CONTINUE_DELAY_MS, type QueueEditCommand, queueEntryText, queueLaneFlags, type QueueLaneFlags, readPrioritizedQueueIds, showQueueRowSendNow, showQueueRowSteer, type StatewireQueueRow, userStopBlocksQueueAutoContinue, } from "./queue";
 export { createDeepAgentSendRecovery, type DeepAgentSendRecovery, type DeepAgentSendRecoveryOptions, shouldAutoRetryFailedSend, } from "./send-recovery";
@@ -74,6 +74,7 @@ export { CALL_RECAP_APPROVAL_LABEL, CALL_RECAP_TITLE, type CallRecap, type CallR
 export { canPersistDeepAgentSession, type DeepAgentPendingSession, type DeepAgentRunConfigRegistration, type DeepAgentSessionPersistence, type DeepAgentThreadElement, type DeepAgentThreadStateClientHost, logUnhandledStatewireError, useDeepAgentRuntime, type UseDeepAgentRuntimeOptions, } from "./use-deep-agent-runtime";
 export { type DeepAgentAttachSource, type DeepAgentHeadersResolver, readSessionPersisted, type RunningSnapshot, shouldNotifyRunningChange, useDeepAgentThread, type UseDeepAgentThreadOptions, } from "./use-deep-agent-thread";
 export { GITHUB_EVENT_SOURCE_KEY, type GithubWakeEvent, githubWakeEventLabel, githubWakeEventUrl, githubWakeMarkerText, githubWakeReference, isGithubWakeMessage, readGithubWakeEvent, } from "./github-wake-event";
+export { GROUP_TEXT_SOURCE, INBOUND_CHANNEL_KEY, INBOUND_CONTEXT_CLOSE, INBOUND_CONTEXT_OPEN, inboundContextValue, inboundEmailSubject, inboundMessageBody, isInboundChannelMessage, type LeadingInboundContext, leadingInboundContext, splitInboundBody, stripInboundContext, } from "./inbound-channel";
 export { githubSubscriptionHeadline, isSubscriptionWakeMessage, readSubscriptionWakeEvent, SUBSCRIPTION_EVENT_KEY, type SubscriptionWakeChange, type SubscriptionWakeEvent, type SubscriptionWakeGithub, subscriptionPlaceWords, subscriptionWakeDetail, subscriptionWakeGithub, subscriptionWakeHeadline, } from "./subscription-wake-event";
 export { describeTerminationReason, readRuntimeMessageFromSourceMessages, readSoleRuntimeMessageKind, readTerminationReason, runtimeMessageMarkerText, TERMINATION_REASONS, type AthenaRuntimeMessage, type AthenaRuntimeMessageKind, type AthenaRuntimeMessageSeverity, type AthenaTerminationReason, type TerminationDescription, } from "./runtime-messages";
 export { buildHandoffQrSvg, buildMobileHandoffSchemeUrl, classifyHandoffTransportError, type CreateThreadHandoffInput, type CreateThreadHandoffResponse, createThreadHandoffResponseSchema, describeHandoffTransportError, type DestinationReadiness, HANDOFF_DESTINATION_LABELS, HANDOFF_DESTINATIONS, HANDOFF_EXPIRY_GRACE_MS, HANDOFF_TICKET_LIFETIME_MS, HANDOFF_URL_PARAM, type HandoffDestination, type HandoffDestinationPresentation, type HandoffEnvironment, HandoffGoneError, type HandoffLaunch, type HandoffOutcome, HandoffPermanentError, type HandoffReadinessResponse, type HandoffReadinessState, type HandoffSource, type HandoffState, type HandoffTransportErrorKind, handoffHttpError, handoffReadinessResponseSchema, handoffStateSchema, handoffTicketLifetimeMs, isHandoffGoneError, isHandoffPermanentError, isRetryableHandoffHttpStatus, isOfficeHandoffDestination, isServerHandoffDestination, isTerminalHandoffState, type MobileHandoffLaunch, type MobileLaunchMode, mobileHandoffLaunchSchema, OFFICE_HANDOFF_DESTINATIONS, type OfficeHandoffDestination, type OfficeHandoffLaunch, officeHandoffLaunchSchema, type OfficeInvitationLaunch, officeInvitationLaunchSchema, type OfficeLaunchMode, officeLaunchModeSchema, threadHandoffCreateBody, parseHandoffIdParam, presentHandoffDestination, readinessByDestination, SERVER_HANDOFF_DESTINATIONS, type ServerHandoffDestination, selectMobileLaunchMode, supportsDesktopHandoffSource, type ThreadHandoffTransport, type ThreadHandoffView, threadHandoffViewSchema, waitForHandoffOutcome, type WaitForHandoffOutcomeOptions, type ClaimThreadHandoffResponse, claimThreadHandoffResponseSchema, clampHandoffDraft, handoffDraftToCarry, continuedFromLabel, pickUpFromLabel, pickUpOfferLabel, type DesktopThreadHandoffLaunch, desktopThreadHandoffLaunchSchema, driverSurfaceForChannel, drivingOnLabel, type HandoffLanding, handoffLandingFromView, isPickupSurface, MAX_HANDOFF_DRAFT_LENGTH, nextHandoffLaunchSchema, parseThreadHandoffCreateResponse, pendingThreadHandoffResponseSchema, pickedUpOnLabel, PICKUP_SURFACES, type PickupSurface, shouldOfferPendingHandoff, IMPLICIT_PICKUP_ACTIVATION_WINDOW_MS, IMPLICIT_PICKUP_DECLINE_HOLD_MS, type ImplicitPickupAnswer, type ImplicitPickupContext, implicitPickupAllowed, isImplicitHandoff, nextImplicitPickupAnswer, SPACES_HANDOFF_URL_PARAM, type SpacesHandoffLaunch, spacesHandoffLaunchSchema, SURFACE_HANDOFF_DESTINATIONS, type SurfaceHandoffDestination, supportsSurfaceHandoffDestinations, THREAD_HANDOFF_DESTINATION_LABELS, THREAD_HANDOFF_DESTINATIONS, threadHandoffClaimBody, threadHandoffCreateRequest, type ThreadHandoffDestination, type ThreadHandoffReceiverTransport, MAX_PENDING_EXCLUDE, handoffDeclineKey, pendingExcludeIds, pickupExcludeIds, pendingHandoffPath, type HandoffMode, handoffModeSchema, isVoiceHandoffDestination, MAX_HANDOFF_CURSOR_LENGTH, parseHandoffCursor, supportsHandoffCursor, livenessAgo, presentSurfaceLiveness, type SurfaceLiveness, type SurfaceLivenessBasis, surfaceLivenessBasisSchema, surfaceLivenessBySurface, type SurfaceLivenessPresentation, surfaceLivenessSchema, type SurfaceLivenessState, surfaceLivenessStateSchema, type SurfaceLivenessTone, supportsSurfaceLiveness, } from "./thread-handoff";

package/dist/agent-runtime/src/interrupts.cjs

@@ -87,12 +87,16 @@ function pendingActionRequests(hitl) {
   const requests = Array.isArray(context.action_requests) ? context.action_requests.filter(isRecord) : context.tool_name && context.tool_args ? [{ name: context.tool_name, args: context.tool_args, tool_call_id: context.tool_call_id }] : [];
   return requests.map((request) => {
     const approvalContext = parsePendingApprovalContext(request.approval_context);
+    const sessionApprovalRecipients = parseSessionApprovalRecipients(
+      request.session_approval_recipients
+    );
     return {
       name: typeof request.name === "string" ? request.name : "tool",
       args: isRecord(request.args) ? request.args : {},
       ...typeof request.tool_call_id === "string" && { toolCallId: request.tool_call_id },
       ...typeof request.interrupt_id === "string" && { interruptId: request.interrupt_id },
       ...request.session_approval_allowed === true && { sessionApprovalAllowed: true },
+      ...sessionApprovalRecipients && { sessionApprovalRecipients },
       ...Array.isArray(request.allowed_decisions) && request.allowed_decisions.includes("edit") && { editAllowed: true },
       ...approvalContext && { approvalContext }
     };
@@ -111,8 +115,44 @@ function pendingApprovalTitle({
   if ((envelope == null ? void 0 : envelope.headline) === void 0) return void 0;
   return envelope.summary === void 0 ? { headline: envelope.headline } : { headline: envelope.headline, summary: envelope.summary };
 }
-function canApproveForSession(actionRequests) {
-  return actionRequests.length > 0 && actionRequests.every((request) => request.sessionApprovalAllowed === true);
+function visibleText(text) {
+  return text.replace(
+    /[\p{C}\p{Z}]/gu,
+    (character) => character === " " ? character : `<U+${(character.codePointAt(0) ?? 0).toString(16).toUpperCase().padStart(4, "0")}>`
+  );
+}
+function parseSessionApprovalRecipients(value) {
+  if (!Array.isArray(value) || value.length === 0) return void 0;
+  const names = [];
+  for (const name of value) {
+    if (typeof name !== "string" || name.trim() === "") return void 0;
+    names.push(visibleText(name));
+  }
+  return names;
+}
+function sessionApprovalOffer(actionRequests) {
+  if (actionRequests.length === 0) return void 0;
+  if (actionRequests.every(
+    (request) => request.sessionApprovalAllowed === true && request.sessionApprovalRecipients === void 0
+  )) {
+    return { kind: "tools" };
+  }
+  const recipients = [];
+  for (const request of actionRequests) {
+    if (request.sessionApprovalRecipients === void 0) return void 0;
+    for (const name of request.sessionApprovalRecipients) {
+      if (!recipients.includes(name)) recipients.push(name);
+    }
+  }
+  return { kind: "recipients", recipients };
+}
+function namesInProse(names) {
+  if (names.length <= 1) return names.join("");
+  return `${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}`;
+}
+function sessionApprovalLabel(offer) {
+  if (offer.kind === "tools") return "Approve all for this session";
+  return `Approve for this session: only ${namesInProse(offer.recipients)}`;
 }
 function readAbandonedInputRequests(state) {
   const abandoned = statewireState.readDeepAgentStreamValues(state).abandonedInputRequests;
@@ -332,7 +372,6 @@ exports.HITL_RESUME_TRANSPORT_RETRIES = HITL_RESUME_TRANSPORT_RETRIES;
 exports.INTERRUPT_DECLINE_REASON = INTERRUPT_DECLINE_REASON;
 exports.actionRequestToolCallIds = actionRequestToolCallIds;
 exports.asHitlApproval = asHitlApproval;
-exports.canApproveForSession = canApproveForSession;
 exports.fanLaneDecision = fanLaneDecision;
 exports.findAbandonedInterrupt = findAbandonedInterrupt;
 exports.hitlResumeActionDecisions = hitlResumeActionDecisions;
@@ -354,6 +393,9 @@ exports.readInterruptMessage = readInterruptMessage;
 exports.readInterruptMirror = readInterruptMirror;
 exports.readQueuedLaneDecisions = readQueuedLaneDecisions;
 exports.resumeValueApproves = resumeValueApproves;
+exports.sessionApprovalLabel = sessionApprovalLabel;
+exports.sessionApprovalOffer = sessionApprovalOffer;
 exports.toolCallIdsAwaitingApproval = toolCallIdsAwaitingApproval;
 exports.useApprovalResumeLock = useApprovalResumeLock;
+exports.visibleText = visibleText;
 //# sourceMappingURL=interrupts.cjs.map