@athenaintel/react 0.28.1 → 0.32.0

package/dist/agent-runtime/src/streaming-markdown.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-markdown.cjs","sources":["../../../../agent-runtime/src/streaming-markdown.ts"],"sourcesContent":["/**\n * Hide a markdown link the stream has not finished writing.\n *\n * The agent mentions and cites assets as markdown links —\n * `[@Considerations/Notes](https://…/dashboard/spaces/?asset_ids=asset_…&type=document&anchor=pm_node&node_id=…&excerpt=…)`\n * — which every chat surface renders as a mention chip once the link is\n * complete. While it is still arriving, a markdown parser sees a bracketed\n * label followed by a bare URL: the label shows as raw text and the half URL\n * linkifies into a live link whose target changes with every batch, for as\n * long as the destination takes to stream (an `excerpt` parameter can run to\n * hundreds of characters). Then the closing `)` lands and the run is rebuilt\n * as a chip.\n *\n * While a part is streaming, cut the text at the start of a trailing link\n * whose `)` has not arrived; it reappears whole, as a chip, in the batch that\n * closes it. Every link and image destination is held — a web citation\n * flickers the same way — and so is every bracket still undecided on the\n * line: an unfinished `[label`, and a closed `[label]` at the very end of the\n * text, which waits one batch for its `(`. Holding the label too is what\n * makes the visible text only ever grow — a link never shows as a label and\n * then retracts when its destination starts — and that append-only property\n * is what keeps Olympus's incremental streaming apply on its cheap path.\n * Brackets match innermost-first, as CommonMark does, and the hold starts at\n * the outermost undecided bracket the size bound allows, so an unmatched\n * bracket in prose hides at most a phrase, briefly, and never masks a later\n * mention. A construct that crosses a line break or runs past its bound is\n * released so a malformed link cannot hide the rest of the message; fenced\n * code (including fences inside blockquotes), indented code and inline code\n * are left untouched; and settled text is never passed through this\n * function, so a link the model genuinely left open shows raw once the part\n * completes.\n *\n * Shared by every chat surface (Olympus, the React SDK hosts, mobile) so the\n * hold behaves identically wherever a transcript streams. Pure string work,\n * linear in the text.\n */\n\n/** An open bracket further back than this is prose, not a label being streamed. */\nexport const UNTERMINATED_LABEL_HOLD_LIMIT = 200;\n/** A link (label and destination) longer than this is broken, not streaming. */\nexport const UNTERMINATED_LINK_HOLD_LIMIT = 1500;\n\n/** Opening or closing code fence: three or more backticks or tildes, then the info string. */\nconst FENCE_LINE = /^\\s*(`{3,}|~{3,})(.*)$/;\n/** Leading blockquote markers (`> `, `>>`, each indented at most three spaces). */\nconst BLOCKQUOTE_PREFIX = /^(?: {0,3}>[ \\t]?)+/;\n/** Bullet or ordered list marker at the start of a line, with the spaces that follow it. */\nconst LIST_MARKER = /^([ \\t]*)([-*+]|\\d{1,9}[.)])([ \\t]+)/;\n\n/**\n * The streamed text with a trailing, still-undecided markdown link or image\n * removed. Text without such a construct is returned as is, and the result is\n * always a prefix of `text`.\n */\nexport function hideUnterminatedMarkdownLink(text: string): string {\n  if (!text.includes(\"[\")) return text;\n\n  const start = scanTrailingLink(text);\n  return start === null ? text : text.slice(0, start);\n}\n\n/** Length of the run of `char` starting at `index`. */\nfunction runLength(text: string, index: number, char: string): number {\n  let end = index;\n  while (end < text.length && text[end] === char) end += 1;\n  return end - index;\n}\n\n/**\n * Index just past the backtick run of exactly `length` that closes a code\n * span opened before `from`, or -1 when none arrives before the paragraph\n * ends (a blank line) — an open span runs to the end of the text.\n */\nfunction codeSpanEnd(text: string, from: number, length: number): number {\n  const blankLine = text.indexOf(\"\\n\\n\", from);\n  const paragraphEnd = blankLine === -1 ? text.length : blankLine;\n  let cursor = from;\n  while (cursor < paragraphEnd) {\n    const next = text.indexOf(\"`\", cursor);\n    if (next === -1 || next >= paragraphEnd) return -1;\n    const run = runLength(text, next, \"`\");\n    if (run === length) return next + run;\n    cursor = next + run;\n  }\n  return -1;\n}\n\n/**\n * The fence run a line opens or closes, or null. A backtick fence's info\n * string cannot contain a backtick (that is inline code, not a fence).\n */\nfunction fenceRun(line: string): string | null {\n  const match = FENCE_LINE.exec(line);\n  if (!match) return null;\n  if (match[1][0] === \"`\" && match[2].includes(\"`\")) return null;\n  return match[1];\n}\n\n/** Columns of leading whitespace on a line; a tab counts as four. */\nfunction leadingIndent(line: string): number {\n  let indent = 0;\n  for (const char of line) {\n    if (char === \" \") indent += 1;\n    else if (char === \"\\t\") indent += 4;\n    else break;\n  }\n  return indent;\n}\n\n/**\n * Tracks the block structure the inline scan must not read: fenced code\n * (also inside blockquotes), indented code, and the list nesting that decides\n * how deep an indent has to be before it is code rather than a nested item\n * or a continuation paragraph. Fed one line at a time, in order.\n */\nfunction createBlockTracker() {\n  let fence: string | null = null;\n  let indentedCode = false;\n  let previousBlank = true;\n  /** Content indents of the open list items, outermost first. */\n  const listContentIndents: number[] = [];\n\n  /** Whether `line` is prose the inline scan should read. */\n  return (line: string): boolean => {\n    const content = line.replace(BLOCKQUOTE_PREFIX, \"\");\n    const blank = content.trim() === \"\";\n    try {\n      const run = fenceRun(content);\n      if (fence !== null) {\n        // Code: a run of the same character at least as long as the opener\n        // closes the block; everything else on the line is content.\n        if (run !== null && run[0] === fence[0] && run.length >= fence.length) fence = null;\n        return false;\n      }\n      if (run !== null) {\n        fence = run;\n        indentedCode = false;\n        return false;\n      }\n\n      // Indented code needs four columns beyond the innermost open list\n      // item's content — less than that is a nested item or a continuation\n      // paragraph — and cannot interrupt a paragraph.\n      const indent = leadingIndent(line);\n      const codeIndent = (listContentIndents.at(-1) ?? 0) + 4;\n      if (indentedCode) {\n        if (blank || indent >= codeIndent) return false;\n        indentedCode = false;\n      } else if (!blank && previousBlank && indent >= codeIndent) {\n        indentedCode = true;\n        return false;\n      }\n      if (blank) return true;\n\n      const marker = LIST_MARKER.exec(line);\n      if (marker) {\n        const markerIndent = leadingIndent(marker[1]);\n        while ((listContentIndents.at(-1) ?? -1) > markerIndent) listContentIndents.pop();\n        // Five or more spaces after the marker start an indented code block\n        // inside the item, so the content column is one past the marker.\n        const gap = marker[3].length;\n        const width = marker[2].length;\n        listContentIndents.push(markerIndent + width + (gap > 4 ? 1 : gap));\n      } else {\n        while (listContentIndents.length > 0 && indent < (listContentIndents.at(-1) ?? 0)) {\n          listContentIndents.pop();\n        }\n      }\n      return true;\n    } finally {\n      previousBlank = blank;\n    }\n  };\n}\n\n/**\n * The CommonMark link-destination grammar after `](`: optional whitespace,\n * then either `<…>` or a bare destination whose parentheses must balance,\n * then optional whitespace and a `\"…\"`, `'…'` or `(…)` title, then `)`.\n */\ninterface Destination {\n  start: number;\n  phase: \"start\" | \"angle\" | \"bare\" | \"after-destination\" | \"title\" | \"after-title\";\n  depth: number;\n  titleClose: string;\n}\n\nfunction advanceDestination(\n  destination: Destination,\n  char: string,\n): \"open\" | \"closed\" | \"invalid\" {\n  const space = char === \" \" || char === \"\\t\";\n  switch (destination.phase) {\n    case \"start\":\n      if (space) return \"open\";\n      if (char === \")\") return \"closed\";\n      if (char === \"<\") {\n        destination.phase = \"angle\";\n        return \"open\";\n      }\n      destination.phase = \"bare\";\n      return advanceDestination(destination, char);\n    case \"angle\":\n      if (char === \">\") destination.phase = \"after-destination\";\n      return \"open\";\n    case \"bare\":\n      if (char === \"(\") {\n        destination.depth += 1;\n        return \"open\";\n      }\n      if (char === \")\") {\n        if (destination.depth === 0) return \"closed\";\n        destination.depth -= 1;\n        return \"open\";\n      }\n      if (space) destination.phase = \"after-destination\";\n      return \"open\";\n    case \"after-destination\":\n      if (space) return \"open\";\n      if (char === \")\") return \"closed\";\n      if (char === '\"' || char === \"'\" || char === \"(\") {\n        destination.phase = \"title\";\n        destination.titleClose = char === \"(\" ? \")\" : char;\n        return \"open\";\n      }\n      return \"invalid\";\n    case \"title\":\n      if (char === destination.titleClose) destination.phase = \"after-title\";\n      return \"open\";\n    case \"after-title\":\n      if (space) return \"open\";\n      return char === \")\" ? \"closed\" : \"invalid\";\n  }\n}\n\n/**\n * Where the text should be cut for the link construct still undecided at its\n * very end, or null when nothing is open: the outermost unclosed `[` within\n * the label bound, else the `[` of a closed label or open destination that\n * is still within its own bound.\n */\nfunction scanTrailingLink(text: string): number | null {\n  /** Positions of the `[` not yet closed on this line, outermost first. */\n  let labelStarts: number[] = [];\n  /** The `[` whose `]` is the last character of the text — `(` may be next. */\n  let closedAtEnd: number | null = null;\n  let destination: Destination | null = null;\n  const isProseLine = createBlockTracker();\n  let index = 0;\n  let lineStart = true;\n\n  const resetInline = (): void => {\n    labelStarts = [];\n    closedAtEnd = null;\n    destination = null;\n  };\n  const result = (): number | null => {\n    // Every bracket still open on the line may yet become a link, so hold\n    // from the outermost one the bound allows: the visible text then only\n    // ever grows, even as an inner link opens and closes.\n    for (const start of labelStarts) {\n      if (text.length - start <= UNTERMINATED_LABEL_HOLD_LIMIT) return start;\n    }\n    if (destination !== null) {\n      return text.length - destination.start <= UNTERMINATED_LINK_HOLD_LIMIT\n        ? destination.start\n        : null;\n    }\n    if (closedAtEnd !== null && text.length - closedAtEnd <= UNTERMINATED_LABEL_HOLD_LIMIT) {\n      return closedAtEnd;\n    }\n    return null;\n  };\n\n  while (index < text.length) {\n    if (lineStart) {\n      lineStart = false;\n      let lineEnd = text.indexOf(\"\\n\", index);\n      if (lineEnd === -1) lineEnd = text.length;\n      if (!isProseLine(text.slice(index, lineEnd))) {\n        // A block boundary or a code line: no inline construct survives it.\n        resetInline();\n        index = lineEnd + 1;\n        lineStart = true;\n        continue;\n      }\n    }\n\n    const char = text[index];\n    if (char === \"\\n\") {\n      // Labels and destinations do not span lines in a streamed message.\n      resetInline();\n      lineStart = true;\n      index += 1;\n      continue;\n    }\n    if (char === \"\\\\\") {\n      index += 2;\n      continue;\n    }\n    if (char === \"`\") {\n      const length = runLength(text, index, \"`\");\n      const end = codeSpanEnd(text, index + length, length);\n      // An open code span runs to the end of the text: nothing after it is\n      // markdown, and a construct opened before it is still being written.\n      if (end === -1) return result();\n      index = end;\n      continue;\n    }\n\n    if (destination !== null) {\n      const verdict = advanceDestination(destination, char);\n      if (verdict !== \"open\") destination = null;\n    } else if (char === \"[\") {\n      // An image's `!` stays visible: cutting before it would take back a\n      // character already shown, and the renderer consumes it at completion.\n      labelStarts.push(index);\n    } else if (char === \"]\") {\n      // Innermost-first, as CommonMark matches brackets: the `]` closes the\n      // most recent `[`, and only that pair can become a link.\n      const start = labelStarts.pop();\n      if (start !== undefined) {\n        if (index + 1 >= text.length) {\n          closedAtEnd = start;\n        } else if (text[index + 1] === \"(\") {\n          destination = { start, phase: \"start\", depth: 0, titleClose: \"\" };\n          index += 1;\n        }\n      }\n    }\n    index += 1;\n  }\n\n  return result();\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/streaming-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-markdown.js","sources":["../../../../agent-runtime/src/streaming-markdown.ts"],"sourcesContent":["/**\n * Hide a markdown link the stream has not finished writing.\n *\n * The agent mentions and cites assets as markdown links —\n * `[@Considerations/Notes](https://…/dashboard/spaces/?asset_ids=asset_…&type=document&anchor=pm_node&node_id=…&excerpt=…)`\n * — which every chat surface renders as a mention chip once the link is\n * complete. While it is still arriving, a markdown parser sees a bracketed\n * label followed by a bare URL: the label shows as raw text and the half URL\n * linkifies into a live link whose target changes with every batch, for as\n * long as the destination takes to stream (an `excerpt` parameter can run to\n * hundreds of characters). Then the closing `)` lands and the run is rebuilt\n * as a chip.\n *\n * While a part is streaming, cut the text at the start of a trailing link\n * whose `)` has not arrived; it reappears whole, as a chip, in the batch that\n * closes it. Every link and image destination is held — a web citation\n * flickers the same way — and so is every bracket still undecided on the\n * line: an unfinished `[label`, and a closed `[label]` at the very end of the\n * text, which waits one batch for its `(`. Holding the label too is what\n * makes the visible text only ever grow — a link never shows as a label and\n * then retracts when its destination starts — and that append-only property\n * is what keeps Olympus's incremental streaming apply on its cheap path.\n * Brackets match innermost-first, as CommonMark does, and the hold starts at\n * the outermost undecided bracket the size bound allows, so an unmatched\n * bracket in prose hides at most a phrase, briefly, and never masks a later\n * mention. A construct that crosses a line break or runs past its bound is\n * released so a malformed link cannot hide the rest of the message; fenced\n * code (including fences inside blockquotes), indented code and inline code\n * are left untouched; and settled text is never passed through this\n * function, so a link the model genuinely left open shows raw once the part\n * completes.\n *\n * Shared by every chat surface (Olympus, the React SDK hosts, mobile) so the\n * hold behaves identically wherever a transcript streams. Pure string work,\n * linear in the text.\n */\n\n/** An open bracket further back than this is prose, not a label being streamed. */\nexport const UNTERMINATED_LABEL_HOLD_LIMIT = 200;\n/** A link (label and destination) longer than this is broken, not streaming. */\nexport const UNTERMINATED_LINK_HOLD_LIMIT = 1500;\n\n/** Opening or closing code fence: three or more backticks or tildes, then the info string. */\nconst FENCE_LINE = /^\\s*(`{3,}|~{3,})(.*)$/;\n/** Leading blockquote markers (`> `, `>>`, each indented at most three spaces). */\nconst BLOCKQUOTE_PREFIX = /^(?: {0,3}>[ \\t]?)+/;\n/** Bullet or ordered list marker at the start of a line, with the spaces that follow it. */\nconst LIST_MARKER = /^([ \\t]*)([-*+]|\\d{1,9}[.)])([ \\t]+)/;\n\n/**\n * The streamed text with a trailing, still-undecided markdown link or image\n * removed. Text without such a construct is returned as is, and the result is\n * always a prefix of `text`.\n */\nexport function hideUnterminatedMarkdownLink(text: string): string {\n  if (!text.includes(\"[\")) return text;\n\n  const start = scanTrailingLink(text);\n  return start === null ? text : text.slice(0, start);\n}\n\n/** Length of the run of `char` starting at `index`. */\nfunction runLength(text: string, index: number, char: string): number {\n  let end = index;\n  while (end < text.length && text[end] === char) end += 1;\n  return end - index;\n}\n\n/**\n * Index just past the backtick run of exactly `length` that closes a code\n * span opened before `from`, or -1 when none arrives before the paragraph\n * ends (a blank line) — an open span runs to the end of the text.\n */\nfunction codeSpanEnd(text: string, from: number, length: number): number {\n  const blankLine = text.indexOf(\"\\n\\n\", from);\n  const paragraphEnd = blankLine === -1 ? text.length : blankLine;\n  let cursor = from;\n  while (cursor < paragraphEnd) {\n    const next = text.indexOf(\"`\", cursor);\n    if (next === -1 || next >= paragraphEnd) return -1;\n    const run = runLength(text, next, \"`\");\n    if (run === length) return next + run;\n    cursor = next + run;\n  }\n  return -1;\n}\n\n/**\n * The fence run a line opens or closes, or null. A backtick fence's info\n * string cannot contain a backtick (that is inline code, not a fence).\n */\nfunction fenceRun(line: string): string | null {\n  const match = FENCE_LINE.exec(line);\n  if (!match) return null;\n  if (match[1][0] === \"`\" && match[2].includes(\"`\")) return null;\n  return match[1];\n}\n\n/** Columns of leading whitespace on a line; a tab counts as four. */\nfunction leadingIndent(line: string): number {\n  let indent = 0;\n  for (const char of line) {\n    if (char === \" \") indent += 1;\n    else if (char === \"\\t\") indent += 4;\n    else break;\n  }\n  return indent;\n}\n\n/**\n * Tracks the block structure the inline scan must not read: fenced code\n * (also inside blockquotes), indented code, and the list nesting that decides\n * how deep an indent has to be before it is code rather than a nested item\n * or a continuation paragraph. Fed one line at a time, in order.\n */\nfunction createBlockTracker() {\n  let fence: string | null = null;\n  let indentedCode = false;\n  let previousBlank = true;\n  /** Content indents of the open list items, outermost first. */\n  const listContentIndents: number[] = [];\n\n  /** Whether `line` is prose the inline scan should read. */\n  return (line: string): boolean => {\n    const content = line.replace(BLOCKQUOTE_PREFIX, \"\");\n    const blank = content.trim() === \"\";\n    try {\n      const run = fenceRun(content);\n      if (fence !== null) {\n        // Code: a run of the same character at least as long as the opener\n        // closes the block; everything else on the line is content.\n        if (run !== null && run[0] === fence[0] && run.length >= fence.length) fence = null;\n        return false;\n      }\n      if (run !== null) {\n        fence = run;\n        indentedCode = false;\n        return false;\n      }\n\n      // Indented code needs four columns beyond the innermost open list\n      // item's content — less than that is a nested item or a continuation\n      // paragraph — and cannot interrupt a paragraph.\n      const indent = leadingIndent(line);\n      const codeIndent = (listContentIndents.at(-1) ?? 0) + 4;\n      if (indentedCode) {\n        if (blank || indent >= codeIndent) return false;\n        indentedCode = false;\n      } else if (!blank && previousBlank && indent >= codeIndent) {\n        indentedCode = true;\n        return false;\n      }\n      if (blank) return true;\n\n      const marker = LIST_MARKER.exec(line);\n      if (marker) {\n        const markerIndent = leadingIndent(marker[1]);\n        while ((listContentIndents.at(-1) ?? -1) > markerIndent) listContentIndents.pop();\n        // Five or more spaces after the marker start an indented code block\n        // inside the item, so the content column is one past the marker.\n        const gap = marker[3].length;\n        const width = marker[2].length;\n        listContentIndents.push(markerIndent + width + (gap > 4 ? 1 : gap));\n      } else {\n        while (listContentIndents.length > 0 && indent < (listContentIndents.at(-1) ?? 0)) {\n          listContentIndents.pop();\n        }\n      }\n      return true;\n    } finally {\n      previousBlank = blank;\n    }\n  };\n}\n\n/**\n * The CommonMark link-destination grammar after `](`: optional whitespace,\n * then either `<…>` or a bare destination whose parentheses must balance,\n * then optional whitespace and a `\"…\"`, `'…'` or `(…)` title, then `)`.\n */\ninterface Destination {\n  start: number;\n  phase: \"start\" | \"angle\" | \"bare\" | \"after-destination\" | \"title\" | \"after-title\";\n  depth: number;\n  titleClose: string;\n}\n\nfunction advanceDestination(\n  destination: Destination,\n  char: string,\n): \"open\" | \"closed\" | \"invalid\" {\n  const space = char === \" \" || char === \"\\t\";\n  switch (destination.phase) {\n    case \"start\":\n      if (space) return \"open\";\n      if (char === \")\") return \"closed\";\n      if (char === \"<\") {\n        destination.phase = \"angle\";\n        return \"open\";\n      }\n      destination.phase = \"bare\";\n      return advanceDestination(destination, char);\n    case \"angle\":\n      if (char === \">\") destination.phase = \"after-destination\";\n      return \"open\";\n    case \"bare\":\n      if (char === \"(\") {\n        destination.depth += 1;\n        return \"open\";\n      }\n      if (char === \")\") {\n        if (destination.depth === 0) return \"closed\";\n        destination.depth -= 1;\n        return \"open\";\n      }\n      if (space) destination.phase = \"after-destination\";\n      return \"open\";\n    case \"after-destination\":\n      if (space) return \"open\";\n      if (char === \")\") return \"closed\";\n      if (char === '\"' || char === \"'\" || char === \"(\") {\n        destination.phase = \"title\";\n        destination.titleClose = char === \"(\" ? \")\" : char;\n        return \"open\";\n      }\n      return \"invalid\";\n    case \"title\":\n      if (char === destination.titleClose) destination.phase = \"after-title\";\n      return \"open\";\n    case \"after-title\":\n      if (space) return \"open\";\n      return char === \")\" ? \"closed\" : \"invalid\";\n  }\n}\n\n/**\n * Where the text should be cut for the link construct still undecided at its\n * very end, or null when nothing is open: the outermost unclosed `[` within\n * the label bound, else the `[` of a closed label or open destination that\n * is still within its own bound.\n */\nfunction scanTrailingLink(text: string): number | null {\n  /** Positions of the `[` not yet closed on this line, outermost first. */\n  let labelStarts: number[] = [];\n  /** The `[` whose `]` is the last character of the text — `(` may be next. */\n  let closedAtEnd: number | null = null;\n  let destination: Destination | null = null;\n  const isProseLine = createBlockTracker();\n  let index = 0;\n  let lineStart = true;\n\n  const resetInline = (): void => {\n    labelStarts = [];\n    closedAtEnd = null;\n    destination = null;\n  };\n  const result = (): number | null => {\n    // Every bracket still open on the line may yet become a link, so hold\n    // from the outermost one the bound allows: the visible text then only\n    // ever grows, even as an inner link opens and closes.\n    for (const start of labelStarts) {\n      if (text.length - start <= UNTERMINATED_LABEL_HOLD_LIMIT) return start;\n    }\n    if (destination !== null) {\n      return text.length - destination.start <= UNTERMINATED_LINK_HOLD_LIMIT\n        ? destination.start\n        : null;\n    }\n    if (closedAtEnd !== null && text.length - closedAtEnd <= UNTERMINATED_LABEL_HOLD_LIMIT) {\n      return closedAtEnd;\n    }\n    return null;\n  };\n\n  while (index < text.length) {\n    if (lineStart) {\n      lineStart = false;\n      let lineEnd = text.indexOf(\"\\n\", index);\n      if (lineEnd === -1) lineEnd = text.length;\n      if (!isProseLine(text.slice(index, lineEnd))) {\n        // A block boundary or a code line: no inline construct survives it.\n        resetInline();\n        index = lineEnd + 1;\n        lineStart = true;\n        continue;\n      }\n    }\n\n    const char = text[index];\n    if (char === \"\\n\") {\n      // Labels and destinations do not span lines in a streamed message.\n      resetInline();\n      lineStart = true;\n      index += 1;\n      continue;\n    }\n    if (char === \"\\\\\") {\n      index += 2;\n      continue;\n    }\n    if (char === \"`\") {\n      const length = runLength(text, index, \"`\");\n      const end = codeSpanEnd(text, index + length, length);\n      // An open code span runs to the end of the text: nothing after it is\n      // markdown, and a construct opened before it is still being written.\n      if (end === -1) return result();\n      index = end;\n      continue;\n    }\n\n    if (destination !== null) {\n      const verdict = advanceDestination(destination, char);\n      if (verdict !== \"open\") destination = null;\n    } else if (char === \"[\") {\n      // An image's `!` stays visible: cutting before it would take back a\n      // character already shown, and the renderer consumes it at completion.\n      labelStarts.push(index);\n    } else if (char === \"]\") {\n      // Innermost-first, as CommonMark matches brackets: the `]` closes the\n      // most recent `[`, and only that pair can become a link.\n      const start = labelStarts.pop();\n      if (start !== undefined) {\n        if (index + 1 >= text.length) {\n          closedAtEnd = start;\n        } else if (text[index + 1] === \"(\") {\n          destination = { start, phase: \"start\", depth: 0, titleClose: \"\" };\n          index += 1;\n        }\n      }\n    }\n    index += 1;\n  }\n\n  return result();\n}\n"],"names":[],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-wake-event.cjs","sources":["../../../../agent-runtime/src/subscription-wake-event.ts"],"sourcesContent":["/**\n * The asset-subscription delivery that woke a conversation, read from the user\n * turn the delivery started.\n *\n * When an asset subscription fires, agora starts a turn on its conversation\n * with the delivery text the model reads (`render_delivery`), and stamps the\n * facts a person needs beside it under `athena_subscription_event` in the\n * message metadata — server-authoritative like `author`, never sent to the\n * model. The shipped converter exposes that metadata as the thread message's\n * `metadata.custom`, so a surface renders the turn as a compact marker\n * (\"Brendon Geils set B4 to Target\") instead of a user bubble quoting the\n * delivery text. Olympus draws the same facts as its event card with citation\n * chips; this is the text every other surface shows. The envelope is for\n * RENDERING only: a surface that ignores it degrades to a plain bubble, never\n * to a lost instruction.\n */\n\n/** `metadata.custom` key agora stamps on a subscription's delivery turn. */\nexport const SUBSCRIPTION_EVENT_KEY = 'athena_subscription_event';\n\n/** A changed cell or range, and its value now when agora read it. */\nexport interface SubscriptionWakeChange {\n  /** Where: \"B4\", \"Sheet1!B2:B11\", \"page 5\"; `null` for a place the marker has no words for. */\n  place: string | null;\n  /** The value now; `null` when agora read none (a busy run's tray, a failed or capped read). */\n  value: string | null;\n}\n\nexport interface SubscriptionWakeEvent {\n  subscriptionId: string;\n  /** `event`: something happened on an asset. `schedule`: a check-in the person set. */\n  kind: 'event' | 'schedule';\n  assetTitle: string | null;\n  eventTypes: string[];\n  eventCount: number | null;\n  /** Who did it, in words: their name, \"You\", \"An agent\", \"Athena\", \"Someone\", with others counted. */\n  actor: string;\n  changes: SubscriptionWakeChange[];\n  /** Changed places past the ones `changes` lists (agora caps the list): counted, never named. */\n  moreChanges: number;\n  /** The ranges the subscription names (\"B2:B11\"); empty for the whole asset. */\n  subscribed: string[];\n  /** Where a comment event's thread sits, when its anchor names a place. */\n  commentPlace: string | null;\n  /** Whether a comment-resolved event resolved (true) or reopened (false); `null` when unsaid. */\n  commentResolved: boolean | null;\n  /** When the person set a scheduled check-in. */\n  scheduleSetAt: string | null;\n  /** A scheduled check-in's own words. */\n  note: string | null;\n  runsLeft: number | null;\n  deliveredAt: string | null;\n}\n\n/** Changed places and subscribed ranges named in one line; the rest are counted. */\nconst MAX_SHOWN_PLACES = 3;\n/** A changed value longer than this is cut in the marker. */\nconst MAX_VALUE_CHARS = 40;\n\nconst CONTENT_CHANGED = 'asset.content.changed';\nconst COMMENT_CREATED = 'asset.comment.created';\nconst COMMENT_REPLIED = 'asset.comment.replied';\nconst COMMENT_RESOLVED = 'asset.comment.resolved';\nconst PRESENCE_JOINED = 'asset.presence.joined';\nconst SLACK_PREFIX = 'user_slack.';\nconst COMMENT_EVENTS: ReadonlySet<string> = new Set([\n  COMMENT_CREATED,\n  COMMENT_REPLIED,\n  COMMENT_RESOLVED,\n]);\n\nconst SLACK_WORDS: Readonly<Record<string, string>> = {\n  'user_slack.dm.received': 'sent you a Slack direct message',\n  'user_slack.mention.received': 'mentioned you in Slack',\n  'user_slack.thread_reply.received': 'replied in your Slack thread',\n  'user_slack.channel_message.posted': 'posted in a Slack channel',\n  'user_slack.reaction.added': 'reacted to a Slack message',\n  'user_slack.message.saved': 'saved a Slack message',\n  'user_slack.pin.added': 'pinned a Slack message',\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** A string with something in it, else `null`. */\nfunction stringOf(value: unknown): string | null {\n  return typeof value === 'string' && value.trim().length > 0 ? value : null;\n}\n\n/** A finite number, else `null`. */\nfunction numberOf(value: unknown): number | null {\n  return typeof value === 'number' && Number.isFinite(value) ? value : null;\n}\n\n/** A sheet name as an A1 qualifier: quoted when it is not a bare word. */\nfunction sheetQualifier(sheet: string): string {\n  return /^[A-Za-z_][A-Za-z0-9_.]*$/.test(sheet) ? sheet : `'${sheet.replaceAll(\"'\", \"''\")}'`;\n}\n\n/**\n * Where a reference-standard anchor in agora's wire form points, in words:\n * a range or cell (with its sheet when the anchor names one), a page, a\n * slide; `null` for any other place.\n */\nexport function subscriptionPlaceWords(anchor: unknown): string | null {\n  if (!isRecord(anchor)) return null;\n  const sheet = stringOf(anchor.sheet) ?? stringOf(anchor.sheet_name);\n  const range = stringOf(anchor.range) ?? stringOf(anchor.cell);\n  if (range) return sheet ? `${sheetQualifier(sheet)}!${range}` : range;\n  const page = numberOf(anchor.page);\n  if (page !== null) return `page ${page}`;\n  const slide = numberOf(anchor.slide_index);\n  if (slide !== null) return `slide ${slide}`;\n  return null;\n}\n\nfunction actorWords(envelope: Record<string, unknown>): string {\n  const actor = isRecord(envelope.actor) ? envelope.actor : {};\n  const name = stringOf(actor.name);\n  let who: string;\n  switch (actor.kind) {\n    case 'self':\n      who = 'You';\n      break;\n    case 'agent':\n      who = name ?? 'An agent';\n      break;\n    case 'system':\n      who = name ?? 'Athena';\n      break;\n    default:\n      who = name ?? 'Someone';\n  }\n  const more = numberOf(envelope.more_actors) ?? 0;\n  if (more <= 0) return who;\n  return `${who} and ${more} ${more === 1 ? 'other' : 'others'}`;\n}\n\nfunction readChanges(value: unknown): SubscriptionWakeChange[] {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    if (!isRecord(entry)) return [];\n    const raw = entry.value;\n    const scalar =\n      typeof raw === 'string' || typeof raw === 'number' || typeof raw === 'boolean'\n        ? String(raw)\n        : null;\n    return [{ place: subscriptionPlaceWords(entry.anchor), value: scalar }];\n  });\n}\n\n/**\n * The delivery behind a thread message's `metadata.custom`, or `undefined`\n * when the message is not a subscription's delivery (or carries no\n * subscription id). Every other field is read leniently: a field of the wrong\n * shape reads as absent.\n */\nexport function readSubscriptionWakeEvent(\n  custom: Record<string, unknown> | null | undefined\n): SubscriptionWakeEvent | undefined {\n  const envelope = custom?.[SUBSCRIPTION_EVENT_KEY];\n  if (!isRecord(envelope)) return undefined;\n  const subscriptionId = stringOf(envelope.subscription_id);\n  if (subscriptionId === null) return undefined;\n  const comment = isRecord(envelope.comment) ? envelope.comment : null;\n  const schedule = isRecord(envelope.schedule) ? envelope.schedule : null;\n  const eventTypes = Array.isArray(envelope.event_types)\n    ? envelope.event_types.filter((type): type is string => typeof type === 'string')\n    : [];\n  const subscribed = Array.isArray(envelope.subscribed)\n    ? envelope.subscribed.flatMap((anchor) => {\n        const words = subscriptionPlaceWords(anchor);\n        return words ? [words] : [];\n      })\n    : [];\n  return {\n    subscriptionId,\n    kind: envelope.kind === 'schedule' ? 'schedule' : 'event',\n    assetTitle: stringOf(envelope.asset_title),\n    eventTypes,\n    eventCount: numberOf(envelope.event_count),\n    actor: actorWords(envelope),\n    changes: readChanges(envelope.changes),\n    moreChanges: Math.max(0, numberOf(envelope.more_changes) ?? 0),\n    subscribed,\n    commentPlace: comment ? subscriptionPlaceWords(comment.anchor) : null,\n    commentResolved: typeof comment?.resolved === 'boolean' ? comment.resolved : null,\n    scheduleSetAt: schedule ? stringOf(schedule.set_at) : null,\n    note: stringOf(envelope.note),\n    runsLeft: numberOf(envelope.runs_left),\n    deliveredAt: stringOf(envelope.delivered_at),\n  };\n}\n\n/**\n * Whether a thread message is a subscription's delivery. Returns a primitive,\n * so it is safe as a `useAuiState` selector.\n */\nexport function isSubscriptionWakeMessage(\n  custom: Record<string, unknown> | null | undefined\n): boolean {\n  return readSubscriptionWakeEvent(custom) !== undefined;\n}\n\n/**\n * A value as the marker shows it: whitespace folded, cut at\n * {@link MAX_VALUE_CHARS}. A value of only whitespace is not empty (an empty\n * one is \"cleared\"), so it reads as a quoted space rather than as nothing.\n */\nfunction valueWords(value: string): string {\n  const folded = value.replace(/\\s+/g, ' ').trim();\n  if (folded === '') return '“ ”';\n  return folded.length > MAX_VALUE_CHARS\n    ? `${folded.slice(0, MAX_VALUE_CHARS - 1).trimEnd()}…`\n    : folded;\n}\n\n/** \"a, b and c\" — items joined the way a sentence lists them, `last` before the last. */\nfunction joinList({ items, last }: { items: string[]; last: string }): string {\n  if (items.length <= 1) return items.join('');\n  return `${items.slice(0, -1).join(', ')}${last}${items.at(-1)}`;\n}\n\n/** One clause of the marker's line: its leading words, then the places it lists. */\ninterface Clause {\n  lead: string;\n  items: string[];\n}\n\n/**\n * The clauses after who did it, as one predicate: \"set B4 to Target and\n * commented on B7\". The clauses are listed \"a, b and c\". A lone clause lists\n * its own items the same way (\"changed B4 and B7\"); with several, each lists\n * its items with commas only, so the clauses' \"and\" is the only one.\n */\nfunction joinClauses(clauses: Clause[]): string {\n  const itemLast = clauses.length === 1 ? ' and ' : ', ';\n  return joinList({\n    items: clauses.map(({ lead, items }) => `${lead}${joinList({ items, last: itemLast })}`),\n    last: ' and ',\n  });\n}\n\n/**\n * The changed places as clauses: \"set B4 to Target\", \"cleared B9\", \"changed\n * B7\" (no value read). At most three places are named; the others — and the\n * ones agora counted past what it sent — are one more clause, \"2 more\".\n */\nfunction changeClauses({\n  changes,\n  moreChanges,\n}: {\n  changes: SubscriptionWakeChange[];\n  moreChanges: number;\n}): Clause[] {\n  const located = changes.filter(\n    (change): change is { place: string; value: string | null } => change.place !== null\n  );\n  const shown = located.slice(0, MAX_SHOWN_PLACES);\n  if (shown.length === 0) return [];\n  const hidden = located.length - shown.length + moreChanges;\n  const set = shown.filter((change) => change.value !== null && change.value !== '');\n  const cleared = shown.filter((change) => change.value === '');\n  const changed = shown.filter((change) => change.value === null);\n  const clauses: Clause[] = [];\n  if (set.length > 0) {\n    clauses.push({\n      lead: 'set ',\n      items: set.map((change) => `${change.place} to ${valueWords(change.value ?? '')}`),\n    });\n  }\n  if (cleared.length > 0) {\n    clauses.push({ lead: 'cleared ', items: cleared.map((change) => change.place) });\n  }\n  if (changed.length > 0) {\n    clauses.push({ lead: 'changed ', items: changed.map((change) => change.place) });\n  }\n  if (hidden > 0) clauses.push({ lead: `${hidden} more`, items: [] });\n  return clauses;\n}\n\nfunction commentLead({ type, resolved }: { type: string; resolved: boolean | null }): string {\n  if (type === COMMENT_CREATED) return 'commented on ';\n  if (type === COMMENT_REPLIED) return 'replied to a comment on ';\n  const verb = resolved === true ? 'resolved' : resolved === false ? 'reopened' : 'updated';\n  return `${verb} a comment on `;\n}\n\n/** An event type without words of its own, in words: `asset.version.created` → \"Version created\". */\nfunction eventLabel(type: string): string {\n  const words = type\n    .replace(/^asset\\./, '')\n    .replace(/[.\\s_-]+/g, ' ')\n    .trim()\n    .toLowerCase();\n  return words ? `${words.charAt(0).toUpperCase()}${words.slice(1)}` : '—';\n}\n\n/**\n * One clause per kind of event the delivery carries, in the order agora lists\n * them (first seen first), so a batch that both changed cells and brought a\n * comment says both. A content change is its changed places, or \"edited\n * <asset>\" when none were located; changes count as one even when the types\n * leave the content change out. The envelope's comment is the batch's first\n * comment event's, so only the first comment clause names its place.\n */\nfunction eventClauses(event: SubscriptionWakeEvent): Clause[] {\n  const asset = event.assetTitle ?? 'the asset';\n  const changes = changeClauses({ changes: event.changes, moreChanges: event.moreChanges });\n  const listed = event.eventTypes;\n  const types = [\n    ...new Set(\n      listed.length === 0 || (changes.length > 0 && !listed.includes(CONTENT_CHANGED))\n        ? [CONTENT_CHANGED, ...listed]\n        : listed\n    ),\n  ];\n  const firstComment = types.find((type) => COMMENT_EVENTS.has(type));\n  const clauses = types.flatMap((type): Clause[] => {\n    if (type === CONTENT_CHANGED) {\n      return changes.length > 0 ? changes : [{ lead: 'edited ', items: [asset] }];\n    }\n    if (COMMENT_EVENTS.has(type)) {\n      const where = type === firstComment && event.commentPlace ? event.commentPlace : asset;\n      return [{ lead: commentLead({ type, resolved: event.commentResolved }), items: [where] }];\n    }\n    if (type === PRESENCE_JOINED) return [{ lead: 'opened ', items: [asset] }];\n    if (type.startsWith(SLACK_PREFIX)) {\n      return [{ lead: SLACK_WORDS[type] ?? 'had Slack activity', items: [] }];\n    }\n    return [{ lead: `triggered “${eventLabel(type)}” on `, items: [asset] }];\n  });\n  // Two Slack events of kinds without words of their own say the same thing once.\n  const said = new Set<string>();\n  return clauses.filter((clause) => {\n    if (clause.items.length > 0) return true;\n    if (said.has(clause.lead)) return false;\n    said.add(clause.lead);\n    return true;\n  });\n}\n\n/** The day a check-in was set, as a person says it: \"today\", \"yesterday\", \"on Oct 8\". */\nfunction setOnWords({ setAt, now }: { setAt: string; now: Date }): string | null {\n  const date = new Date(setAt);\n  if (Number.isNaN(date.getTime())) return null;\n  const midnight = (day: Date) => new Date(day.getFullYear(), day.getMonth(), day.getDate()).getTime();\n  const days = Math.round((midnight(now) - midnight(date)) / (24 * 60 * 60 * 1000));\n  if (days === 0) return 'today';\n  if (days === 1) return 'yesterday';\n  const sameYear = date.getFullYear() === now.getFullYear();\n  return `on ${date.toLocaleDateString('en-US', {\n    month: 'short',\n    day: 'numeric',\n    ...(sameYear ? {} : { year: 'numeric' as const }),\n  })}`;\n}\n\n/**\n * The marker's line: who did what, where — \"Brendon Geils set B4 to Target\",\n * \"Brendon Geils changed B4\" when agora read no value, \"Ana Lopez commented\n * on B7\", \"Brendon Geils set B4 to Target and commented on B7\" for a batch\n * that carried both — or, for a schedule, \"Scheduled check-in you set on\n * Oct 8\" (`now` decides \"today\" and \"yesterday\").\n */\nexport function subscriptionWakeHeadline({\n  event,\n  now = new Date(),\n}: {\n  event: SubscriptionWakeEvent;\n  now?: Date;\n}): string {\n  if (event.kind === 'schedule') {\n    const when = event.scheduleSetAt ? setOnWords({ setAt: event.scheduleSetAt, now }) : null;\n    return when ? `Scheduled check-in you set ${when}` : 'Scheduled check-in';\n  }\n  return `${event.actor} ${joinClauses(eventClauses(event))}`;\n}\n\n/** \"99 runs left\", \"1 run left\", \"No runs left\". */\nfunction runsLeftWords(runsLeft: number): string {\n  if (runsLeft <= 0) return 'No runs left';\n  return `${runsLeft} ${runsLeft === 1 ? 'run' : 'runs'} left`;\n}\n\n/**\n * The line under it: \"Series A Investors · subscribed to B2:B11 · 99 runs\n * left · 3 events\" for an asset event; a check-in's note for a schedule.\n * `null` when there is nothing to add.\n */\nexport function subscriptionWakeDetail(event: SubscriptionWakeEvent): string | null {\n  if (event.kind === 'schedule') {\n    const parts = [\n      event.note,\n      event.runsLeft !== null && event.runsLeft > 0 ? runsLeftWords(event.runsLeft) : null,\n    ].filter((part): part is string => part !== null);\n    return parts.length > 0 ? parts.join(' · ') : null;\n  }\n  const shown = event.subscribed.slice(0, MAX_SHOWN_PLACES);\n  const hidden = event.subscribed.length - shown.length;\n  const subscribed =\n    shown.length > 0\n      ? `subscribed to ${shown.join(', ')}${hidden > 0 ? ` and ${hidden} more` : ''}`\n      : null;\n  const parts = [\n    event.assetTitle,\n    subscribed,\n    event.runsLeft !== null ? runsLeftWords(event.runsLeft) : null,\n    event.eventCount !== null && event.eventCount > 1 ? `${event.eventCount} events` : null,\n  ].filter((part): part is string => part !== null);\n  return parts.length > 0 ? parts.join(' · ') : null;\n}\n"],"names":["parts"],"mappings":"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"}

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

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