{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "approval-card",
  "title": "Approval Card",
  "author": "Diogo Esteves <https://github.com/dgesteves>",
  "description": "Approve or deny a tool call once, for the session or always, by tool and argument pattern: an args preview, editable arguments, risk levels, a denial reason, a key per choice, approve all pending.",
  "dependencies": [
    "@radix-ui/react-collapsible@^1.2.1",
    "ai",
    "clsx@^2.1.1",
    "tailwind-merge@^3.7.0"
  ],
  "files": [
    {
      "path": "packages/signoff-ui/src/approval-card.tsx",
      "content": "'use client';\n\nimport {\n  useCallback,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n  type ComponentPropsWithoutRef,\n  type KeyboardEvent,\n  type MouseEvent,\n  type ReactNode,\n  type RefObject,\n} from 'react';\nimport {\n  getApprovalRequestReason,\n  getApprovalStatus,\n  getToolPartName,\n  isAutomaticApproval,\n  type ApprovalStatus,\n  type ToolPart,\n} from './lib/ai';\nimport { humanizeToolName, safeStringify } from './lib/format';\nimport {\n  approvalCardLabels,\n  commonLabels,\n  untrustedLabels,\n  type SignoffLabels,\n  type SignoffLabelsInput,\n} from './lib/labels';\nimport { evaluateRules, suggestArgs, type ApprovalDecision, type ApprovalRequest } from './lib/policy';\nimport { useScrollRegion } from './lib/scroll-region';\nimport { Revealed } from './lib/revealed';\nimport { revealText } from './lib/untrusted';\nimport { BanIcon, CheckIcon, ShieldIcon, TerminalIcon } from './lib/icons';\nimport { JsonView, Kbd, LiveRegion } from './lib/primitives';\nimport { useIsMac } from './lib/hooks';\nimport { cn, fromSlot, hasModifier, isPromiseLike, isTypingTarget, type HeadingLevel } from './lib/utils';\nimport type { RiskLevel, ToolMeta } from './tool-call-timeline';\nimport type { ApprovalOutcome, ApprovalPolicy } from './use-approval-policy';\nimport { useLabels, WithLabels } from './labels';\n\n/** The labels' sections this module reads. */\nconst LABELS = { approvalCard: approvalCardLabels, common: commonLabels, untrusted: untrustedLabels };\n\nexport type { ApprovalStatus, RiskLevel };\nexport type { ApprovalDecision } from './lib/policy';\n\n/** A decision as the card makes it: what was chosen, and what goes with it. */\nexport interface ApprovalChoice {\n  /**\n   * What was chosen, and how long it holds: `allow-once`, `allow-session`, `allow-always`,\n   * `deny-once` or `deny-always`.\n   */\n  decision: ApprovalDecision;\n  /** The denial's reason, when the person gave one. */\n  reason?: string | undefined;\n  /** The arguments to run with, when the person edited them (`editable`). */\n  input?: unknown;\n  /**\n   * For a session or always decision: the argument patterns its rule covers, or `undefined` for\n   * every call of the tool (\"Any arguments\").\n   */\n  args?: Record<string, string> | undefined;\n}\n\nexport interface ApprovalCardProps extends Omit<ComponentPropsWithoutRef<'section'>, 'title' | 'children' | 'part'> {\n  /** Name of the tool or action that needs approval. */\n  toolName: string;\n  /** Heading. Defaults to the humanized tool name. */\n  title?: ReactNode;\n  /** Why the agent wants to do this, e.g. the SDK's `approval.requestReason`. */\n  description?: ReactNode;\n  /** Arguments the action will run with. */\n  input?: unknown;\n  /** How risky the action is, shown as a badge. Without it the card shows no risk level. */\n  risk?: RiskLevel | undefined;\n  /**\n   * Custom arguments preview. Defaults to a command line for `{ command }` inputs, with any other\n   * arguments as JSON below it, else JSON.\n   * Your content, like `AgentMessage`'s `renderTool`: keys pressed in it, or in a menu it opens in\n   * a portal, are yours, not the card's shortcuts. Once the person edits the arguments (`editable`),\n   * the card shows the edited ones in its default preview instead.\n   */\n  preview?: ReactNode;\n  /**\n   * Where the approval stands: the card offers the choices while `pending`, and shows the outcome you\n   * pass back. Approve and deny fire once: further presses (a double click, Y then N) are ignored\n   * until `status` changes, the promise the handler returned settles, or the handler throws.\n   * @default 'pending'\n   */\n  status?: ApprovalStatus;\n  /** Reason recorded with the decision, shown once resolved. */\n  reason?: string | undefined;\n  /**\n   * A policy, not a person, made the decision (the SDK's `approval.isAutomatic`): once resolved,\n   * the card reads \"Auto-approved\" or \"Blocked by policy\" instead of \"Approved\" or \"Denied\".\n   * @default false\n   */\n  automatic?: boolean;\n  /**\n   * How the resolved decision was made, to say so: `allow-session` reads \"Approved for this\n   * session\", `deny-always` \"Always denied\", and so on.\n   */\n  decision?: ApprovalDecision | undefined;\n  /** The rule that decided, in words, shown once resolved: \"Allowed by your rule: …\". */\n  decidedByRule?: string | undefined;\n  /**\n   * The choices to offer, from `allow-once`, `allow-session`, `allow-always`, `deny-once` and\n   * `deny-always`. Session and always decisions come to `onDecide` with the arguments their rule\n   * covers.\n   * @default ['allow-once', 'deny-once']\n   */\n  decisions?: readonly ApprovalDecision[] | undefined;\n  /**\n   * Every decision with what goes with it: its scope, the reason, edited arguments and the rule's\n   * argument patterns. When you pass it, `onApprove` and `onDeny` are not called. May return a promise.\n   */\n  onDecide?: ((choice: ApprovalChoice) => void | PromiseLike<void>) | undefined;\n  /** Fires once per decision: see `status`. May return a promise. Not called with `onDecide`. */\n  onApprove?: () => void | PromiseLike<void>;\n  /** Fires once per decision: see `status`. May return a promise. Not called with `onDecide`. */\n  onDeny?: (reason?: string) => void | PromiseLike<void>;\n  /**\n   * Let the person edit the arguments before approving: a form for an object of strings, numbers\n   * and booleans, JSON otherwise. The edited input comes to `onDecide`: \"Done editing\" closes the\n   * editor and keeps the edit, \"Undo edits\" drops it. An edit is for the `input` it was made\n   * against: new `input`, or a new `status`, drops it.\n   * @default false\n   */\n  editable?: boolean;\n  /** The argument patterns a session or always rule starts with. Default: from the input. */\n  ruleArgs?: Record<string, string> | undefined;\n  /**\n   * Show which calls a session or always decision covers, editable. Pass `false` when the agent\n   * keeps what \"always\" means, as with ACP's `allow_always`: the card then shows no argument\n   * patterns, and the decision comes without `args`.\n   * @default true\n   */\n  ruleScope?: boolean;\n  /**\n   * Y / N shortcuts while focus is inside the card (and S, A, Shift+N when offered), but not in a\n   * custom `preview`.\n   * @default true\n   */\n  shortcuts?: boolean;\n  /**\n   * Also approve with ⌘/Ctrl+Enter from anywhere on the page while pending, except a text field,\n   * where the keys are the field's (a chat composer's send, say). With several cards pending, one\n   * answers: the card the keys are pressed in, else the latest to ask. A critical press armed from\n   * outside the card ends when focus or a click goes anywhere but the card.\n   * @default false\n   */\n  globalShortcut?: boolean;\n  /**\n   * Move focus to the card when it mounts in the pending state, unless focus is in a text field:\n   * the person's next keys would land on the card as shortcuts.\n   * @default false\n   */\n  autoFocus?: boolean;\n  /**\n   * Offer an optional free-text reason when denying.\n   * @default true\n   */\n  allowReason?: boolean;\n  /**\n   * Placeholder of the reason field. Without one, the card uses `labels.approvalCard.reasonPlaceholder`.\n   * @default 'What should the agent do instead?'\n   */\n  reasonPlaceholder?: string;\n  /**\n   * The approve button's text. Without one, the card uses `labels.approvalCard.approve`.\n   * @default 'Approve'\n   */\n  approveLabel?: string;\n  /**\n   * The deny button's text. Without one, the card uses `labels.approvalCard.deny`.\n   * @default 'Deny'\n   */\n  denyLabel?: string;\n  /**\n   * Heading level for the title, to fit your document outline.\n   * @default 3\n   */\n  headingLevel?: HeadingLevel;\n  /** Words to use instead of the English defaults: see `SignoffLabelsProvider`. */\n  labels?: SignoffLabelsInput | undefined;\n}\n\n/** No risk given: no badge, and the card's neutral colors. */\nconst UNRATED = { card: 'border-signoff-border', icon: 'bg-signoff-surface-2 text-signoff-fg-muted' };\n\nconst RISK: Record<RiskLevel, { badge: string; card: string; icon: string }> = {\n  low: {\n    badge: 'border-signoff-border-strong text-signoff-fg-muted',\n    card: 'border-signoff-border',\n    icon: 'bg-signoff-surface-2 text-signoff-fg-muted',\n  },\n  medium: {\n    badge: 'border-signoff-warn/40 bg-signoff-warn/10 text-signoff-warn-fg',\n    card: 'border-signoff-warn/30',\n    icon: 'bg-signoff-warn/10 text-signoff-warn-fg',\n  },\n  high: {\n    badge: 'border-signoff-hot/45 bg-signoff-hot/10 text-signoff-hot-fg',\n    card: 'border-signoff-hot/40',\n    icon: 'bg-signoff-hot/12 text-signoff-hot-fg',\n  },\n  critical: {\n    badge: 'border-signoff-hot bg-signoff-hot text-signoff-on-hot',\n    card: 'border-signoff-hot/70 shadow-[0_0_0_3px_color-mix(in_oklab,var(--signoff-hot)_14%,transparent)]',\n    icon: 'bg-signoff-hot/15 text-signoff-hot-fg',\n  },\n};\n\n/** The key for each decision, as printed and as `aria-keyshortcuts` names it. */\nconst CHOICE: Record<ApprovalDecision, { key: string; keys: string }> = {\n  'allow-once': { key: 'Y', keys: 'Y' },\n  'allow-session': { key: 'S', keys: 'S' },\n  'allow-always': { key: 'A', keys: 'A' },\n  'deny-once': { key: 'N', keys: 'N' },\n  'deny-always': { key: '⇧N', keys: 'Shift+N' },\n};\n\n/** Styling hooks for the buttons; the once buttons keep the names they always had. */\nconst SLOT: Record<ApprovalDecision, string> = {\n  'allow-once': 'signoff-approval-approve',\n  'allow-session': 'signoff-approval-session',\n  'allow-always': 'signoff-approval-always',\n  'deny-once': 'signoff-approval-deny',\n  'deny-always': 'signoff-approval-deny-always',\n};\n\n/**\n * A command wraps, so no part of it sits out of view to the side, whatever comes before it; a long\n * run of spaces or of blank lines shows as its count, so blank lines cannot push the rest out of view\n * below either, and what does not show shows as a mark (`Revealed`). Should something still be\n * wider than the box, such as a mark in a very narrow one, it scrolls sideways, and while it does,\n * the keyboard can reach it.\n */\nfunction CommandPreview({ command, cwd, label }: { command: string; cwd: string | undefined; label: string }) {\n  const scrollRef = useScrollRegion<HTMLDivElement>(label);\n  return (\n    // Left to right in a right-to-left page too, so bidi cannot reorder what runs: `~/app` stays `~/app`.\n    <div\n      ref={scrollRef}\n      dir=\"ltr\"\n      data-slot=\"signoff-approval-command\"\n      className=\"border-signoff-border bg-signoff-bg/70 font-signoff-mono focus-visible:outline-signoff-ring overflow-x-auto rounded-lg border px-3 py-2.5 text-[13px] leading-5 focus-visible:outline-2 focus-visible:outline-offset-1\"\n    >\n      {cwd && (\n        <div className=\"text-signoff-fg-subtle mb-0.5 text-[11px] [overflow-wrap:anywhere] whitespace-pre-wrap\">\n          <Revealed text={cwd} blanks />\n        </div>\n      )}\n      <div className=\"text-signoff-fg [overflow-wrap:anywhere] whitespace-pre-wrap\">\n        <span aria-hidden=\"true\" className=\"text-signoff-accent-fg mr-2 select-none\">\n          $\n        </span>\n        <Revealed text={command} blanks />\n      </div>\n    </div>\n  );\n}\n\n/**\n * The command a call runs, where, and the arguments that go with it: from `{ command, cwd, … }`\n * arguments. `rest` holds every other argument, a `cwd` that is not text among them, since each\n * can change what runs (`{ command: 'npm test', env: { … } }`); `undefined` when there are none.\n */\nfunction commandOf(input: unknown) {\n  if (input && typeof input === 'object' && 'command' in input && typeof input.command === 'string') {\n    const others: Record<string, unknown> = { ...input };\n    delete others.command;\n    const cwd = typeof others.cwd === 'string' ? others.cwd : undefined;\n    if (cwd !== undefined) delete others.cwd;\n    // A key set to `undefined` is no argument (`{ cwd: undefined }`): JSON leaves it out as well.\n    for (const key of Object.keys(others)) if (others[key] === undefined) delete others[key];\n    return { command: input.command, cwd, rest: Object.keys(others).length > 0 ? others : undefined };\n  }\n}\n\nfunction DefaultPreview({ input, L }: { input: unknown; L: SignoffLabels['approvalCard'] }) {\n  const run = commandOf(input);\n  if (run && !run.rest) return <CommandPreview command={run.command} cwd={run.cwd} label={L.command} />;\n  if (run)\n    return (\n      <div className=\"flex flex-col gap-2\">\n        <CommandPreview command={run.command} cwd={run.cwd} label={L.command} />\n        {/* What else the call runs with, below what it runs: nothing it is given goes unseen. */}\n        <div dir=\"ltr\">\n          <JsonView value={run.rest} label={L.arguments} collapseAfter={14} />\n        </div>\n      </div>\n    );\n  if (input === undefined) return null;\n  return (\n    <div dir=\"ltr\">\n      <JsonView value={input} label={L.arguments} collapseAfter={14} />\n    </div>\n  );\n}\n\n/** Text from the agent as a screen reader hears it, what does not show named as `Revealed` names it. */\nfunction spoken(text: string, L: SignoffLabels['untrusted']) {\n  return revealText(text, { blanks: true })\n    .map((part) =>\n      typeof part === 'string'\n        ? part\n        : ` ${part.kind === 'blank' ? L.blank(part.count, part.lines) : L.invisible(part.count, part.codes)} `,\n    )\n    .join('');\n}\n\n/** An object of strings, numbers and booleans, edited as a form; anything else is edited as JSON. */\nfunction isFlatRecord(value: unknown): value is Record<string, string | number | boolean> {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return false;\n  const entries = Object.entries(value);\n  return (\n    entries.length > 0 &&\n    entries.length <= 12 &&\n    entries.every(([, v]) => typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean')\n  );\n}\n\nconst sameValue = (a: unknown, b: unknown) => safeStringify(a) === safeStringify(b);\n\n/** On a touch screen a text field is 16px or more: iOS zooms the page into a smaller one it focuses. */\nconst field =\n  'border-signoff-border-strong bg-signoff-bg text-signoff-fg placeholder:text-signoff-fg-subtle focus-visible:outline-signoff-ring w-full rounded-lg border px-3 py-2 text-[13px] focus-visible:outline-2 focus-visible:outline-offset-0 pointer-coarse:text-[length:max(16px,1rem)]';\n\n/** The arguments, editable: a field per argument for a flat object, JSON for anything else. */\nfunction ArgumentsEditor({\n  original,\n  value,\n  onChange,\n  idPrefix,\n  L,\n}: {\n  original: unknown;\n  value: EditorValue;\n  onChange: (value: EditorValue) => void;\n  idPrefix: string;\n  L: SignoffLabels['approvalCard'];\n}) {\n  if (value.kind === 'form') {\n    const record = value.record;\n    return (\n      <fieldset className=\"flex flex-col gap-2.5\">\n        <legend className=\"text-signoff-fg-muted mb-1 text-xs font-medium\">{L.arguments}</legend>\n        {Object.entries(record).map(([key, v]) => {\n          const id = `${idPrefix}-arg-${key}`;\n          const kind = typeof (original as Record<string, unknown>)[key];\n          if (kind === 'boolean') {\n            return (\n              <label key={key} htmlFor={id} className=\"text-signoff-fg flex items-center gap-2 text-[13px]\">\n                <input\n                  id={id}\n                  type=\"checkbox\"\n                  checked={v === true}\n                  onChange={(e) => onChange({ kind: 'form', record: { ...record, [key]: e.target.checked } })}\n                  className=\"accent-signoff-accent focus-visible:outline-signoff-ring size-3.5 focus-visible:outline-2 focus-visible:outline-offset-2\"\n                />\n                <span className=\"font-signoff-mono\">{key}</span>\n              </label>\n            );\n          }\n          const text = String(v);\n          const long = kind === 'string' && (text.includes('\\n') || text.length > 80);\n          return (\n            <div key={key} className=\"flex flex-col gap-1\">\n              <label htmlFor={id} className=\"font-signoff-mono text-signoff-fg-muted text-[11px]\">\n                {key}\n              </label>\n              {long ? (\n                <textarea\n                  id={id}\n                  dir=\"auto\"\n                  rows={3}\n                  value={text}\n                  onChange={(e) => onChange({ kind: 'form', record: { ...record, [key]: e.target.value } })}\n                  className={cn(field, 'font-signoff-mono resize-y')}\n                />\n              ) : (\n                <input\n                  id={id}\n                  dir=\"auto\"\n                  type={kind === 'number' ? 'number' : 'text'}\n                  value={text}\n                  onChange={(e) =>\n                    onChange({\n                      kind: 'form',\n                      record: { ...record, [key]: kind === 'number' ? Number(e.target.value) : e.target.value },\n                    })\n                  }\n                  className={cn(field, 'font-signoff-mono')}\n                />\n              )}\n            </div>\n          );\n        })}\n      </fieldset>\n    );\n  }\n  const errorId = `${idPrefix}-json-error`;\n  return (\n    <div className=\"flex flex-col gap-1\">\n      <label htmlFor={`${idPrefix}-json`} className=\"text-signoff-fg-muted text-xs font-medium\">\n        {L.argumentsJson}\n      </label>\n      <textarea\n        id={`${idPrefix}-json`}\n        dir=\"ltr\"\n        rows={Math.min(14, Math.max(4, value.text.split('\\n').length))}\n        value={value.text}\n        spellCheck={false}\n        aria-invalid={value.error ? true : undefined}\n        aria-describedby={value.error ? errorId : undefined}\n        onChange={(e) => onChange(parseJson(e.target.value))}\n        className={cn(field, 'font-signoff-mono resize-y text-xs leading-5')}\n      />\n      {value.error && (\n        <p id={errorId} className=\"text-signoff-hot-fg text-xs\">\n          {L.notValidJson(value.error)}\n        </p>\n      )}\n    </div>\n  );\n}\n\ntype EditorValue =\n  | { kind: 'form'; record: Record<string, string | number | boolean> }\n  | { kind: 'json'; text: string; parsed?: unknown; error?: string | undefined };\n\nfunction parseJson(text: string): EditorValue {\n  try {\n    return { kind: 'json', text, parsed: JSON.parse(text) as unknown };\n  } catch (error) {\n    return { kind: 'json', text, error: error instanceof Error ? error.message : String(error) };\n  }\n}\n\nfunction editorFor(input: unknown): EditorValue {\n  return isFlatRecord(input) ? { kind: 'form', record: { ...input } } : parseJson(safeStringify(input ?? {}));\n}\n\n/** The editor's arguments, or `undefined` while the JSON does not parse. */\nfunction editorInput(value: EditorValue): { ok: true; input: unknown } | { ok: false } {\n  if (value.kind === 'form') return { ok: true, input: value.record };\n  return value.error ? { ok: false } : { ok: true, input: value.parsed };\n}\n\n/** How long a decision stays in the live region: long enough to be read, then gone from the card. */\nconst ANNOUNCEMENT_MS = 3000;\n\n/** A pending card with `globalShortcut`: its element, and what it does when a newer card joins. */\ninterface GlobalCard {\n  ref: RefObject<HTMLElement | null>;\n  displaced: () => void;\n}\n\n/**\n * The pending cards with `globalShortcut`, oldest first. ⌘/Ctrl+Enter outside them answers only\n * the last, the latest to ask (the last of parallel calls), not each card or the first to mount.\n */\nconst globalCards: GlobalCard[] = [];\n\n/**\n * What a critical action's first press armed. It holds until the second press, Escape, or focus\n * or a click going outside `ref`'s element, with no timer to beat: the person confirms at their\n * own pace, after a screen reader has read the request (WCAG 2.2.1). It belongs to the `call` it\n * was armed on, so new arguments, or new calls waiting, start disarmed. `onCancel` hears of a\n * press let go (`disarm`), to say so: the button only reads as it did before.\n */\nfunction useArmed<T>(ref: RefObject<HTMLElement | null>, call: unknown, onCancel: () => void) {\n  const [armed, setArmed] = useState<{ value: T; call: unknown }>();\n  const stale = armed !== undefined && !sameValue(armed.call, call);\n  // Adjusting state during render, not in an effect, as for a stale edit.\n  if (stale) setArmed(undefined);\n  // What `disarm` reads: whether a press is armed now, and the latest `onCancel`.\n  const live = useRef({ armed: false, onCancel });\n  useEffect(() => {\n    live.current = { armed: armed !== undefined && !stale, onCancel };\n  });\n  // The same function on every render, so an effect can hold it without running again. Escape and\n  // focus leaving can both fire for one move: the first lets the press go and says so, once.\n  const disarm = useCallback(() => {\n    if (live.current.armed) {\n      live.current.armed = false;\n      live.current.onCancel();\n    }\n    setArmed(undefined);\n  }, []);\n  useEffect(() => {\n    if (armed === undefined) return;\n    const element = ref.current;\n    // Anywhere on the page, as ⌘/Ctrl+Enter may have armed it from there; not an Escape a field or\n    // a menu took for itself, such as the one that closes the reason field.\n    const onKey = (event: globalThis.KeyboardEvent) => {\n      if (event.key === 'Escape' && !event.defaultPrevented) disarm();\n    };\n    // Focus moving between the element's own controls keeps it.\n    const onFocusOut = (event: globalThis.FocusEvent) => {\n      if (!element?.contains(event.relatedTarget as Node | null)) disarm();\n    };\n    // Armed by ⌘/Ctrl+Enter from outside, focus was never in here to leave: focus or a click going\n    // anywhere else ends it, so typing in a composer and sending doesn't leave one press to go.\n    // The click is for Safari, where a click on a button doesn't focus it. The path, not the\n    // target, as the target out here of a card in a shadow root is its host.\n    const onOutside = (event: Event) => {\n      if (!(element && event.composedPath().includes(element))) disarm();\n    };\n    window.addEventListener('keydown', onKey);\n    element?.addEventListener('focusout', onFocusOut);\n    // Capturing, so a handler that stops the event on its way doesn't keep the press armed.\n    document.addEventListener('focusin', onOutside, true);\n    document.addEventListener('pointerdown', onOutside, true);\n    return () => {\n      window.removeEventListener('keydown', onKey);\n      element?.removeEventListener('focusout', onFocusOut);\n      document.removeEventListener('focusin', onOutside, true);\n      document.removeEventListener('pointerdown', onOutside, true);\n    };\n  }, [armed, ref, disarm]);\n  const arm = (value: T | undefined) => {\n    // Let go by a decision, not cancelled: Chrome's focusout as the decided bar leaves says nothing.\n    if (value === undefined) live.current.armed = false;\n    setArmed(value === undefined ? undefined : { value, call });\n  };\n  return [stale ? undefined : armed?.value, arm, disarm] as const;\n}\n\n/** The focused element, inside open shadow roots too: in a web component, the document sees only its host. */\nfunction focusedElement(): Element | null {\n  let active = document.activeElement;\n  while (active?.shadowRoot?.activeElement) active = active.shadowRoot.activeElement;\n  return active;\n}\n\n/**\n * Human-in-the-loop approval for a pending agent action. Shows what will run,\n * how risky it is, and lets the user approve or deny by mouse or keyboard, once,\n * for the session or always, with the arguments edited first when `editable`.\n * Critical actions require a second confirming press: the first stays armed, with no time limit,\n * until Escape, or focus or a click goes outside the card.\n *\n * The card is a group named by its title, not a landmark, so a run with many approvals doesn't\n * fill landmark navigation; pass `role=\"region\"` to make it one.\n */\nexport function ApprovalCard({\n  toolName,\n  title,\n  description,\n  input,\n  risk,\n  preview,\n  status = 'pending',\n  reason,\n  automatic = false,\n  decision: resolvedDecision,\n  decidedByRule,\n  decisions: offered = DEFAULT_DECISIONS,\n  onDecide,\n  onApprove,\n  onDeny,\n  editable = false,\n  ruleArgs,\n  ruleScope = true,\n  shortcuts = true,\n  globalShortcut = false,\n  autoFocus = false,\n  allowReason = true,\n  reasonPlaceholder,\n  approveLabel,\n  denyLabel,\n  headingLevel = 3,\n  labels,\n  className,\n  ...props\n}: ApprovalCardProps) {\n  const all = useLabels(LABELS, labels);\n  const L = all.approvalCard;\n  const Heading = `h${headingLevel}` as const;\n  const ids = useId();\n  const titleId = `${ids}-title`;\n  const descId = `${ids}-desc`;\n  const summaryId = `${ids}-summary`;\n  const hintId = `${ids}-hint`;\n  const reasonId = `${ids}-reason`;\n  const cardRef = useRef<HTMLElement>(null);\n  const reasonRef = useRef<HTMLTextAreaElement>(null);\n  const [reasonOpen, setReasonOpen] = useState(false);\n  const [reasonText, setReasonText] = useState('');\n  const [announcement, setAnnouncement] = useState('');\n  const [editing, setEditing] = useState(false);\n  // The person's edit and the arguments it was made against, kept when the editor closes;\n  // `undefined` until they change something.\n  const [edit, setEdit] = useState<{ base: unknown; value: EditorValue }>();\n  // An edit counts only for the arguments it was made against: new `input` is a new call.\n  const stale = edit !== undefined && !sameValue(edit.base, input);\n  // It also belongs to the pending period it was made in, so a card that asks again does not carry\n  // the last answer's edit. Either drops it, adjusting state during render, not in an effect.\n  const [period, setPeriod] = useState(status);\n  if (period !== status) {\n    setPeriod(status);\n    setEdit(undefined);\n    setEditing(false);\n  } else if (stale) {\n    setEdit(undefined);\n  }\n  const edited = stale ? undefined : edit?.value;\n  const editToggleRef = useRef<HTMLButtonElement>(null);\n  const pending = status === 'pending';\n  const r = risk ? RISK[risk] : UNRATED;\n  const heading = title ?? humanizeToolName(toolName);\n  const mac = useIsMac();\n  const mod = all.common.modKey(mac);\n  const has = (d: ApprovalDecision) => offered.includes(d);\n  const remembers = ruleScope && (has('allow-session') || has('allow-always') || has('deny-always'));\n\n  // The arguments a decision runs with: the edited ones, once valid and different, editor open or not.\n  const editedInput = editable && edited ? editorInput(edited) : undefined;\n  const invalid = editedInput?.ok === false;\n  const finalInput = editedInput?.ok && !sameValue(editedInput.input, input) ? editedInput.input : undefined;\n  // `null` is an edit like any other (JSON edited to `null`), so not `finalInput ?? input`.\n  const runInput = finalInput !== undefined ? finalInput : input;\n  // A critical press is for the arguments it would approve, in this pending period: new ones from\n  // the agent, an edit made after it, or a card that asks again start disarmed.\n  const [confirming, setConfirming, disarm] = useArmed<ApprovalDecision>(cardRef, [status, input, runInput], () =>\n    setAnnouncement(L.confirmCancelled),\n  );\n\n  // The rule's scope, suggested from the arguments the call will run with.\n  const suggested = useMemo(() => ruleArgs ?? suggestArgs(runInput), [ruleArgs, runInput]);\n  const [scope, setScope] = useState<{ any: boolean; args: Record<string, string> } | undefined>();\n  const scopeArgs = scope ?? { any: !suggested, args: suggested ?? {} };\n  // The calls a lasting decision covers, in words.\n  const rule = remembers\n    ? L.describeRule({ tool: toolName, args: scopeArgs.any ? undefined : scopeArgs.args })\n    : undefined;\n\n  // One decision per pending period, so a double click cannot send two (see `status`).\n  const decided = useRef(false);\n  useEffect(() => {\n    decided.current = false;\n  }, [status]);\n  const decide = (handler: () => unknown) => {\n    decided.current = true;\n    let result: unknown;\n    try {\n      result = handler();\n    } catch (error) {\n      // A failed handler sent nothing: let the user try again.\n      decided.current = false;\n      throw error;\n    }\n    if (isPromiseLike(result)) {\n      // Released when it settles either way; a rejection stays unhandled, as it would without the card.\n      void Promise.resolve(result).finally(() => {\n        decided.current = false;\n      });\n    }\n  };\n\n  const choose = (decision: ApprovalDecision, withReason?: string) => {\n    if (!pending || decided.current || !has(decision)) return;\n    const approving = decision.startsWith('allow');\n    if (approving && invalid) {\n      setAnnouncement(L.invalidJson);\n      return;\n    }\n    if (approving && risk === 'critical' && confirming !== decision) {\n      setConfirming(decision);\n      setAnnouncement(L.critical);\n      return;\n    }\n    const lasting = decision !== 'allow-once' && decision !== 'deny-once';\n    setConfirming(undefined);\n    setAnnouncement(lasting && rule ? L.resolvedFor(L.resolved[decision], rule) : L.resolved[decision]);\n    cardRef.current?.focus();\n    const why = withReason?.trim() ? withReason.trim() : undefined;\n    const choice: ApprovalChoice = {\n      decision,\n      ...(why ? { reason: why } : {}),\n      ...(approving && finalInput !== undefined ? { input: finalInput } : {}),\n      ...(lasting && remembers && !scopeArgs.any ? { args: { ...scopeArgs.args } } : {}),\n    };\n    decide(() => (onDecide ? onDecide(choice) : approving ? onApprove?.() : onDeny?.(why)));\n  };\n  const approve = () => choose('allow-once');\n  const deny = (withReason?: string) => choose('deny-once', withReason);\n\n  const openReason = () => setReasonOpen(true);\n  useEffect(() => {\n    if (reasonOpen) reasonRef.current?.focus();\n  }, [reasonOpen]);\n\n  // Once read, clear the announcement: left in place, a decided card reads \"Approved, Approved\".\n  useEffect(() => {\n    if (!announcement) return;\n    const id = setTimeout(() => setAnnouncement(''), ANNOUNCEMENT_MS);\n    return () => clearTimeout(id);\n  }, [announcement]);\n\n  useEffect(() => {\n    // Not out of a text field: the next letter the person types there would land on the card as a shortcut.\n    if (autoFocus && pending && !isTypingTarget(focusedElement())) cardRef.current?.focus();\n    // Only on mount: re-focusing on every render would steal focus.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  const approveRef = useRef(approve);\n  useEffect(() => {\n    approveRef.current = approve;\n  });\n  useEffect(() => {\n    if (!globalShortcut || !pending) return;\n    const entry: GlobalCard = {\n      ref: cardRef,\n      // Keys pressed outside the cards are now the new card's. A press they armed here would\n      // otherwise wait, out of sight, and the next one, once that card is answered, would confirm\n      // it. One armed with focus in here stays: the keys pressed in here are still this card's.\n      displaced: () => {\n        if (!cardRef.current?.matches(':focus-within')) disarm();\n      },\n    };\n    for (const card of globalCards) card.displaced();\n    globalCards.push(entry);\n    const onKey = (event: globalThis.KeyboardEvent) => {\n      if (event.key === 'Enter' && (event.metaKey || event.ctrlKey) && !event.defaultPrevented) {\n        const path = event.composedPath();\n        // In a text field, the card's own included, ⌘/Ctrl+Enter is the field's: a composer's send.\n        // Out here a web component's field shows as its host, so ask the path where the key began.\n        if (isTypingTarget(path[0] ?? event.target)) return;\n        // One card answers: the one the keys were pressed in (its custom preview, say), else the\n        // latest to ask, wherever focus is.\n        const owner =\n          globalCards.find((card) => card.ref.current && path.includes(card.ref.current)) ?? globalCards.at(-1);\n        if (owner !== entry) return;\n        event.preventDefault();\n        // A held key repeats its keydown: one press, one decision.\n        if (!event.repeat) approveRef.current();\n      }\n    };\n    window.addEventListener('keydown', onKey);\n    return () => {\n      window.removeEventListener('keydown', onKey);\n      const index = globalCards.indexOf(entry);\n      if (index !== -1) globalCards.splice(index, 1);\n    };\n  }, [globalShortcut, pending, disarm]);\n\n  const onKeyDown = (event: KeyboardEvent<HTMLElement>) => {\n    // Keys on your controls in `preview`, or in a menu it opens in a portal, are theirs.\n    if (!pending || fromSlot(event)) return;\n    // A held key repeats its keydown, and a repeated Enter clicks the focused button again: one press\n    // makes one decision, so holding a key cannot confirm a critical action or answer twice.\n    if (event.repeat && event.key === 'Enter' && !isTypingTarget(event.target)) {\n      event.preventDefault();\n      return;\n    }\n    if (!shortcuts) return;\n    if (event.key === 'Enter' && (event.metaKey || event.ctrlKey)) {\n      if (isTypingTarget(event.target)) return;\n      event.preventDefault();\n      approve();\n      return;\n    }\n    if (isTypingTarget(event.target) || hasModifier(event)) return;\n    const key = event.key.toLowerCase();\n    if (event.shiftKey) {\n      if (key === 'n' && has('deny-always')) {\n        event.preventDefault();\n        if (!event.repeat) choose('deny-always', reasonOpen ? reasonText : undefined);\n      }\n      return;\n    }\n    const byKey: Record<string, ApprovalDecision> = {\n      y: 'allow-once',\n      s: 'allow-session',\n      a: 'allow-always',\n      n: 'deny-once',\n    };\n    const decision = byKey[key];\n    if (decision && has(decision)) {\n      event.preventDefault();\n      if (!event.repeat) choose(decision);\n    }\n  };\n\n  // Focus on the card reads its title, then this: the risk, what runs, and what S or A would remember.\n  const run = commandOf(runInput);\n  // With a command, the arguments besides it and its cwd: they change what runs as well.\n  const named = run ? run.rest : runInput;\n  const summary = L.summary({\n    risk: risk && L.risk[risk],\n    // Whole, however long, unlike the arguments below: what runs is never cut in what is announced.\n    command: run && spoken(run.command, all.untrusted),\n    cwd: run?.cwd && spoken(run.cwd, all.untrusted),\n    args:\n      named && typeof named === 'object' && !Array.isArray(named)\n        ? Object.entries(named)\n            .slice(0, 3)\n            .map(([name, value]) => {\n              const text = spoken(typeof value === 'string' ? value : safeStringify(value, 0), all.untrusted);\n              return [name, text.length > 80 ? `${text.slice(0, 79)}…` : text] as const;\n            })\n        : [],\n    rule,\n  });\n\n  const keyHint = L.keyboardHint(\n    {\n      approve: has('allow-once'),\n      session: has('allow-session'),\n      always: has('allow-always'),\n      deny: has('deny-once'),\n      alwaysDeny: has('deny-always'),\n    },\n    mod,\n  );\n\n  const resolvedText = decidedByRule\n    ? status === 'approved'\n      ? L.allowedByRule\n      : L.deniedByRule\n    : automatic\n      ? status === 'approved'\n        ? L.autoApproved\n        : L.blockedByPolicy\n      : resolvedDecision && resolvedDecision.startsWith(status === 'approved' ? 'allow' : 'deny')\n        ? L.resolved[resolvedDecision]\n        : status === 'approved'\n          ? L.approved\n          : L.denied;\n\n  // Four or five choices wrap unevenly in a narrow card, Approve alone on the last row: under 40rem,\n  // they form two columns as wide as their labels need, the last taking its row when it would be\n  // alone, and one column under 16rem. In the DOM's order, so the tab order is what the eye reads.\n  const choiceGroup =\n    'flex flex-wrap items-center justify-end gap-2 @max-[40rem]:has-[>:nth-child(4)]:grid @max-[40rem]:has-[>:nth-child(4)]:w-full @max-[40rem]:has-[>:nth-child(4)]:grid-cols-[repeat(2,minmax(min-content,1fr))] @max-[16rem]:has-[>:nth-child(4)]:grid-cols-1 @max-[40rem]:[&>*]:justify-center @max-[40rem]:[&>:last-child:nth-child(odd)]:col-span-full';\n  const secondary =\n    'border-signoff-border-strong bg-signoff-surface-2 text-signoff-fg hover:border-signoff-fg-subtle hover:bg-signoff-bg focus-visible:outline-signoff-ring inline-flex h-8 cursor-pointer items-center gap-2 rounded-lg border px-3 text-[13px] font-medium whitespace-nowrap transition-colors focus-visible:outline-2 focus-visible:outline-offset-2 aria-disabled:cursor-not-allowed aria-disabled:opacity-60';\n  const primary = (armed: boolean) =>\n    cn(\n      'focus-visible:outline-signoff-ring inline-flex h-8 cursor-pointer items-center gap-2 rounded-lg px-3 text-[13px] font-semibold whitespace-nowrap transition-[background-color,box-shadow] focus-visible:outline-2 focus-visible:outline-offset-2 aria-disabled:cursor-not-allowed aria-disabled:opacity-60 forced-colors:border',\n      armed\n        ? 'bg-signoff-hot text-signoff-on-hot hover:bg-signoff-hot/90'\n        : 'bg-signoff-accent text-signoff-on-accent hover:bg-signoff-accent/90 shadow-[0_0_0_1px_color-mix(in_oklab,var(--signoff-accent)_40%,transparent),0_6px_20px_-8px_var(--signoff-accent)]',\n    );\n  const choiceButton = (decision: ApprovalDecision, label: string, className: string) => (\n    <button\n      key={decision}\n      type=\"button\"\n      data-slot={SLOT[decision]}\n      data-decision={decision}\n      aria-keyshortcuts={\n        shortcuts\n          ? decision === 'allow-once'\n            ? `Y ${mac ? 'Meta' : 'Control'}+Enter`\n            : CHOICE[decision].keys\n          : undefined\n      }\n      aria-disabled={decision.startsWith('allow') && invalid ? true : undefined}\n      onClick={(event) => {\n        // The second click of a double click is the same press: it does not confirm a critical action.\n        if (event.detail > 1) return;\n        choose(decision, decision.startsWith('deny') && reasonOpen ? reasonText : undefined);\n      }}\n      className={className}\n    >\n      {confirming === decision ? L.confirm : label}\n      {shortcuts && (\n        <Kbd\n          aria-hidden=\"true\"\n          className={cn(\n            'pointer-coarse:hidden',\n            decision === 'allow-once' && 'border-current/25 bg-transparent text-current/80',\n          )}\n        >\n          {CHOICE[decision].key}\n        </Kbd>\n      )}\n    </button>\n  );\n\n  return (\n    // Shortcuts are scoped to focus within the card (WCAG 2.1.4); the actions themselves are real buttons.\n    <WithLabels labels={labels}>\n      <section\n        ref={cardRef}\n        data-signoff\n        data-slot=\"signoff-approval-card\"\n        data-status={status}\n        data-risk={risk}\n        role=\"group\"\n        tabIndex={-1}\n        aria-labelledby={titleId}\n        aria-describedby={\n          pending\n            ? [description ? descId : '', summary ? summaryId : '', shortcuts ? hintId : '']\n                .filter(Boolean)\n                .join(' ') || undefined\n            : undefined\n        }\n        onKeyDown={onKeyDown}\n        className={cn(\n          // outline-none sets no style for the ring to draw with: focus-visible sets one back.\n          'rounded-signoff bg-signoff-surface font-signoff-sans text-signoff-fg focus-visible:outline-signoff-ring relative overflow-hidden border outline-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-solid',\n          pending ? r.card : 'border-signoff-border bg-signoff-surface/60',\n          pending && 'motion-safe:animate-signoff-enter',\n          className,\n        )}\n        {...props}\n      >\n        <LiveRegion>{announcement}</LiveRegion>\n        {pending ? (\n          <>\n            {(risk === 'high' || risk === 'critical') && (\n              <div\n                aria-hidden=\"true\"\n                className=\"via-signoff-hot h-px w-full bg-gradient-to-r from-transparent to-transparent\"\n              />\n            )}\n            <div className=\"flex flex-col gap-3.5 p-4\">\n              <div className=\"flex items-start gap-3\">\n                <span\n                  aria-hidden=\"true\"\n                  className={cn('flex size-8 shrink-0 items-center justify-center rounded-lg', r.icon)}\n                >\n                  {input && typeof input === 'object' && 'command' in input ? (\n                    <TerminalIcon size={16} />\n                  ) : (\n                    <ShieldIcon size={16} />\n                  )}\n                </span>\n                <div className=\"min-w-0 flex-1\">\n                  <div className=\"flex items-start justify-between gap-2\">\n                    <p className=\"font-signoff-mono text-signoff-hot-fg pt-0.5 text-[10.5px] font-medium tracking-[0.08em] uppercase\">\n                      {L.required}\n                    </p>\n                    {risk && (\n                      <span\n                        data-slot=\"signoff-approval-risk\"\n                        className={cn(\n                          'shrink-0 rounded-full border px-2 py-0.5 text-[11px] font-semibold whitespace-nowrap',\n                          RISK[risk].badge,\n                        )}\n                      >\n                        {L.risk[risk]}\n                      </span>\n                    )}\n                  </div>\n                  <Heading id={titleId} className=\"text-signoff-fg -mt-0.5 text-[15px] leading-snug font-semibold\">\n                    {heading}\n                  </Heading>\n                  {description && (\n                    <p id={descId} className=\"text-signoff-fg-muted mt-1 text-[13px] leading-relaxed\">\n                      {description}\n                    </p>\n                  )}\n                  {/* Read as the card's description only: the badge and the preview show it. */}\n                  {summary && (\n                    <p id={summaryId} hidden>\n                      {summary}\n                    </p>\n                  )}\n                </div>\n              </div>\n\n              {editing ? (\n                <ArgumentsEditor\n                  original={input}\n                  value={edited ?? editorFor(input)}\n                  onChange={(value) => setEdit({ base: input, value })}\n                  idPrefix={ids}\n                  L={L}\n                />\n              ) : finalInput !== undefined || preview === undefined || preview === null ? (\n                // An edit shows as what will run, in place of a custom preview of the agent's arguments.\n                <DefaultPreview input={runInput} L={L} />\n              ) : (\n                <div data-signoff-slot className=\"contents\">\n                  {preview}\n                </div>\n              )}\n              {editable && input !== undefined && (\n                <div className=\"-mt-1.5 flex items-center gap-2\">\n                  <button\n                    ref={editToggleRef}\n                    type=\"button\"\n                    aria-expanded={editing}\n                    onClick={() => {\n                      // Done editing keeps the edit; JSON that does not parse keeps the editor and its error open.\n                      if (editing && invalid) setAnnouncement(L.invalidJson);\n                      else setEditing((open) => !open);\n                    }}\n                    className=\"text-signoff-fg-muted hover:text-signoff-fg focus-visible:outline-signoff-ring cursor-pointer rounded-md px-1 py-0.5 text-xs underline-offset-2 hover:underline focus-visible:outline-2 focus-visible:outline-offset-1\"\n                  >\n                    {editing ? L.doneEditing : L.editArguments}\n                  </button>\n                  {(finalInput !== undefined || invalid) && (\n                    <button\n                      type=\"button\"\n                      onClick={() => {\n                        setEdit(undefined);\n                        // This button goes with the edit: keep focus in the card.\n                        editToggleRef.current?.focus();\n                      }}\n                      className=\"text-signoff-fg-muted hover:text-signoff-fg focus-visible:outline-signoff-ring cursor-pointer rounded-md px-1 py-0.5 text-xs underline-offset-2 hover:underline focus-visible:outline-2 focus-visible:outline-offset-1\"\n                    >\n                      {L.undoEdits}\n                    </button>\n                  )}\n                  {finalInput !== undefined && <span className=\"text-signoff-warn-fg text-xs\">{L.edited}</span>}\n                </div>\n              )}\n\n              {remembers && (\n                <RuleScope\n                  toolName={toolName}\n                  scope={scopeArgs}\n                  onChange={setScope}\n                  idPrefix={ids}\n                  // Arguments the call has, to narrow the rule to.\n                  available={suggested}\n                  L={L}\n                />\n              )}\n\n              {reasonOpen && (\n                <div className=\"flex flex-col gap-1.5\">\n                  <label htmlFor={reasonId} className=\"text-signoff-fg-muted text-xs font-medium\">\n                    {L.reasonLabel}\n                  </label>\n                  <textarea\n                    ref={reasonRef}\n                    id={reasonId}\n                    rows={2}\n                    value={reasonText}\n                    onChange={(e) => setReasonText(e.target.value)}\n                    onKeyDown={(e) => {\n                      // The Enter that commits an IME composition (Japanese, Chinese, Korean…) is not a submit.\n                      if (e.nativeEvent.isComposing || e.keyCode === 229) return;\n                      if (e.key === 'Enter' && !e.shiftKey) {\n                        e.preventDefault();\n                        // Not a held Enter's repeat, such as the one that opened this field.\n                        if (!e.repeat) deny(reasonText);\n                      } else if (e.key === 'Escape') {\n                        e.preventDefault();\n                        setReasonOpen(false);\n                        cardRef.current?.focus();\n                      }\n                    }}\n                    placeholder={reasonPlaceholder ?? L.reasonPlaceholder}\n                    className={cn(field, 'resize-none')}\n                  />\n                </div>\n              )}\n\n              <div className=\"@container flex flex-wrap items-center gap-2\">\n                {shortcuts && (\n                  <p\n                    id={hintId}\n                    className=\"text-signoff-fg-subtle mr-auto hidden items-center gap-1.5 text-xs sm:flex pointer-coarse:hidden\"\n                  >\n                    <span className=\"sr-only\">{keyHint}</span>\n                    <span aria-hidden=\"true\" className=\"flex items-center gap-1.5\">\n                      <Kbd>{mod}</Kbd>\n                      <Kbd>↵</Kbd>\n                      <span>{L.approveHint}</span>\n                    </span>\n                  </p>\n                )}\n                <div className=\"ml-auto flex flex-wrap items-center justify-end gap-2 @max-[40rem]:has-[>div>:nth-child(4)]:w-full\">\n                  {allowReason && !reasonOpen && (\n                    <button\n                      type=\"button\"\n                      onClick={openReason}\n                      className=\"text-signoff-fg-muted hover:text-signoff-fg focus-visible:outline-signoff-ring cursor-pointer rounded-md px-2 py-1.5 text-xs underline-offset-2 hover:underline focus-visible:outline-2 focus-visible:outline-offset-1\"\n                    >\n                      {L.denyWithFeedback}\n                    </button>\n                  )}\n                  <div className={choiceGroup}>\n                    {has('deny-always') && choiceButton('deny-always', L.alwaysDeny, secondary)}\n                    {has('deny-once') &&\n                      choiceButton('deny-once', reasonOpen ? L.sendDenial : (denyLabel ?? L.deny), secondary)}\n                    {has('allow-session') &&\n                      choiceButton(\n                        'allow-session',\n                        L.session,\n                        confirming === 'allow-session' ? primary(true) : secondary,\n                      )}\n                    {has('allow-always') &&\n                      choiceButton('allow-always', L.always, confirming === 'allow-always' ? primary(true) : secondary)}\n                    {has('allow-once') &&\n                      choiceButton('allow-once', approveLabel ?? L.approve, primary(confirming === 'allow-once'))}\n                  </div>\n                </div>\n              </div>\n            </div>\n          </>\n        ) : (\n          <div className=\"flex flex-wrap items-center gap-x-2.5 gap-y-1 px-3.5 py-2.5 text-[13px]\">\n            {status === 'approved' ? (\n              <CheckIcon size={15} className=\"text-signoff-accent-fg shrink-0\" />\n            ) : (\n              <BanIcon size={15} className=\"text-signoff-hot-fg shrink-0\" />\n            )}\n            <span className=\"text-signoff-fg font-semibold\">{resolvedText}</span>\n            <Heading id={titleId} className=\"text-signoff-fg-muted min-w-0 truncate\">\n              {heading}\n            </Heading>\n            {decidedByRule && <span className=\"text-signoff-fg-subtle min-w-0 truncate\">· {decidedByRule}</span>}\n            {reason && <span className=\"text-signoff-fg-subtle min-w-0 truncate\">· {reason}</span>}\n          </div>\n        )}\n      </section>\n    </WithLabels>\n  );\n}\n\nconst DEFAULT_DECISIONS: readonly ApprovalDecision[] = ['allow-once', 'deny-once'];\n\n/** Which calls a session or always decision covers: the tool, narrowed to argument patterns or not. */\nfunction RuleScope({\n  toolName,\n  scope,\n  onChange,\n  available,\n  idPrefix,\n  L,\n}: {\n  toolName: string;\n  scope: { any: boolean; args: Record<string, string> };\n  onChange: (scope: { any: boolean; args: Record<string, string> }) => void;\n  available: Record<string, string> | undefined;\n  idPrefix: string;\n  L: SignoffLabels['approvalCard'];\n}) {\n  const names = Object.keys(available ?? scope.args);\n  const remembered = L.rememberedFor(scope.any);\n  return (\n    <fieldset className=\"border-signoff-border bg-signoff-bg/40 flex flex-col gap-2 rounded-lg border px-3 py-2.5\">\n      <legend className=\"sr-only\">{L.ruleLegend}</legend>\n      <p className=\"text-signoff-fg-muted text-xs\">\n        {remembered.before}\n        <span dir=\"ltr\" className=\"font-signoff-mono text-signoff-fg\">\n          {toolName}\n        </span>\n        {remembered.after}\n      </p>\n      {!scope.any &&\n        names.map((name) => {\n          const id = `${idPrefix}-rule-${name}`;\n          return (\n            <div key={name} className=\"flex items-center gap-2\">\n              <label htmlFor={id} className=\"font-signoff-mono text-signoff-fg-muted shrink-0 text-[11px]\">\n                {L.argumentMatches(name)}\n              </label>\n              <input\n                id={id}\n                type=\"text\"\n                dir=\"ltr\"\n                value={scope.args[name] ?? ''}\n                onChange={(e) => onChange({ ...scope, args: { ...scope.args, [name]: e.target.value } })}\n                className={cn(field, 'font-signoff-mono py-1 text-xs')}\n              />\n            </div>\n          );\n        })}\n      {names.length > 0 && (\n        <label className=\"text-signoff-fg-muted flex items-center gap-2 text-xs\">\n          <input\n            type=\"checkbox\"\n            checked={scope.any}\n            onChange={(e) => onChange({ ...scope, any: e.target.checked })}\n            className=\"accent-signoff-accent focus-visible:outline-signoff-ring size-3.5 focus-visible:outline-2 focus-visible:outline-offset-2\"\n          />\n          {L.anyArguments}\n        </label>\n      )}\n      {!scope.any && <p className=\"text-signoff-fg-subtle text-[11px]\">{L.globHelp}</p>}\n    </fieldset>\n  );\n}\n\n/** The answer to one approval request, as the AI SDK's `addToolApprovalResponse` takes it. */\nexport interface ToolApprovalResponse {\n  /** The approval request's id, `part.approval.id`: not the tool call's id. */\n  id: string;\n  /** `true` to run the call, `false` to deny it. */\n  approved: boolean;\n  /** The reason given with the decision, such as the one the person typed when denying. */\n  reason?: string;\n}\n\nexport interface ToolApprovalCardProps extends Omit<\n  ApprovalCardProps,\n  | 'toolName'\n  | 'input'\n  | 'status'\n  | 'onApprove'\n  | 'onDeny'\n  | 'onDecide'\n  | 'reason'\n  | 'automatic'\n  | 'decision'\n  | 'decidedByRule'\n  | 'decisions'\n  | 'editable'\n> {\n  /**\n   * The AI SDK tool part to answer, from `message.parts` (`isToolPart` finds them). The card reads\n   * the tool's name, input, approval request and outcome from it, and renders nothing for a part\n   * with no approval request.\n   */\n  part: ToolPart;\n  /** Matches `useChat().addToolApprovalResponse`, so you can pass it directly. */\n  onRespond: (response: ToolApprovalResponse) => void | PromiseLike<void>;\n  /**\n   * How to show this tool, as in `AgentMessage`'s `tools`: without `title`, the card takes its\n   * `label` (after the part's own `title`), and without `risk`, its `risk`, a level or a function\n   * of the input.\n   */\n  meta?: ToolMeta | undefined;\n  /**\n   * Approval rules from `useApprovalPolicy`. The card then offers once, this session and always\n   * (unless `decisions` says otherwise), answers a request a rule already decides without asking,\n   * and records every decision.\n   */\n  policy?: ApprovalPolicy | undefined;\n  /**\n   * The choices to offer, from `allow-once`, `allow-session`, `allow-always`, `deny-once` and\n   * `deny-always`. Without it, all five with a `policy`, else `allow-once` and `deny-once`.\n   */\n  decisions?: readonly ApprovalDecision[] | undefined;\n  /**\n   * Apply edited arguments before the approval goes out; the card offers editing only with it.\n   * With AI SDK 7: `(id, input) => setMessages((m) => setToolInput(m, id, input))`. With\n   * `useAgUiAgent`: its `editInput`.\n   */\n  onEditInput?: ((toolCallId: string, input: unknown) => void) | undefined;\n  /**\n   * Let the person edit the arguments before approving, as on `ApprovalCard`. Only with\n   * `onEditInput`, which applies the edit: without it the card never offers editing, and with it\n   * `false` turns editing off.\n   * @default true\n   */\n  editable?: boolean;\n}\n\nconst ALL_DECISIONS: readonly ApprovalDecision[] = [\n  'allow-once',\n  'allow-session',\n  'allow-always',\n  'deny-once',\n  'deny-always',\n];\n\n/** The request a tool part makes, for a policy. */\nexport function approvalRequestOf(part: ToolPart): ApprovalRequest | undefined {\n  if (!part.approval) return undefined;\n  return { id: part.approval.id, toolName: getToolPartName(part), input: part.input, toolCallId: part.toolCallId };\n}\n\n/**\n * `ApprovalCard` bound to an AI SDK tool part in the approval flow. Renders nothing for parts without\n * one, or while a policy's automatic decision is still arriving: nobody needs to act on it.\n */\nexport function ToolApprovalCard({\n  part,\n  onRespond,\n  meta,\n  risk,\n  description,\n  title,\n  policy,\n  onEditInput,\n  decisions,\n  editable,\n  ...props\n}: ToolApprovalCardProps) {\n  const L = useLabels(LABELS, props.labels).approvalCard;\n  const status = getApprovalStatus(part);\n  const request = approvalRequestOf(part);\n  // The SDK's policy decided it (`toolApproval`): its response follows the request in the stream.\n  const automatic = isAutomaticApproval(part.approval);\n  // A rule decides this request: answer it from the policy, once, without asking anyone. Not one the\n  // SDK decided: answering it too would send a second response, and label the SDK's decision as ours.\n  const ruled =\n    !!policy &&\n    status === 'pending' &&\n    !automatic &&\n    !!request &&\n    !!evaluateRules(policy.rules, request.toolName, request.input);\n  const answered = useRef<string | undefined>(undefined);\n  useEffect(() => {\n    if (!ruled || !request || !policy?.ready || answered.current === request.id) return;\n    const outcome = policy.answer(request);\n    if (!outcome) return;\n    answered.current = request.id;\n    void onRespond(toResponse(outcome));\n  });\n  if (!status || !part.approval || !request) return null;\n  if (automatic && status === 'pending') return null;\n  if (ruled) return null;\n  const approvalId = part.approval.id;\n  const resolvedRisk = risk ?? (typeof meta?.risk === 'function' ? meta.risk(part.input) : meta?.risk);\n  const outcome = status === 'pending' ? undefined : policy?.outcomeOf(approvalId);\n  const send = (choice: ApprovalChoice) => {\n    if (choice.input !== undefined) onEditInput?.(part.toolCallId, choice.input);\n    // Answered by a person: the rule this decision adds must not answer it again while it reads pending.\n    answered.current = approvalId;\n    if (policy) {\n      const recorded = policy.decide(request, choice.decision, {\n        reason: choice.reason,\n        input: choice.input,\n        args: choice.args,\n      });\n      return onRespond(toResponse(recorded));\n    }\n    const approved = choice.decision.startsWith('allow');\n    return onRespond(\n      choice.reason ? { id: approvalId, approved, reason: choice.reason } : { id: approvalId, approved },\n    );\n  };\n  return (\n    <ApprovalCard\n      toolName={getToolPartName(part)}\n      title={title ?? part.title ?? meta?.label}\n      description={description ?? getApprovalRequestReason(part.approval)}\n      input={part.input}\n      risk={resolvedRisk}\n      status={status}\n      reason={part.approval.reason}\n      automatic={automatic}\n      decision={outcome?.decision}\n      decidedByRule={outcome?.by === 'rule' && outcome.rule ? L.describeRule(outcome.rule) : undefined}\n      decisions={decisions ?? (policy ? ALL_DECISIONS : undefined)}\n      // Editing only where an edit can be applied: never silently dropped on the way to the agent.\n      editable={!!onEditInput && (editable ?? true)}\n      onDecide={send}\n      data-approval-id={approvalId}\n      {...props}\n    />\n  );\n}\n\nfunction toResponse(outcome: ApprovalOutcome): ToolApprovalResponse {\n  return outcome.reason\n    ? { id: outcome.id, approved: outcome.approved, reason: outcome.reason }\n    : { id: outcome.id, approved: outcome.approved };\n}\n\nexport interface ToolApprovalBatchProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {\n  /** Tool parts; those waiting on a person count. */\n  parts: readonly ToolPart[];\n  /**\n   * Called once for each waiting call when Approve all or Deny all answers them. Matches\n   * `useChat().addToolApprovalResponse`, so you can pass it directly.\n   */\n  onRespond: (response: ToolApprovalResponse) => void | PromiseLike<void>;\n  /**\n   * Approval rules from `useApprovalPolicy`, the ones the cards get: a call a rule decides isn't\n   * waiting on a person, and each answer is recorded as a once decision.\n   */\n  policy?: ApprovalPolicy | undefined;\n  /**\n   * The tools' `ToolMeta`, by tool name, as in `AgentMessage`'s `tools`. Their `risk` counts: with a\n   * critical call waiting, Approve all asks for a second press.\n   */\n  tools?: Record<string, ToolMeta> | undefined;\n  /**\n   * Shown from this many waiting approvals.\n   * @default 2\n   */\n  min?: number;\n  /** Words to use instead of the English defaults: see `SignoffLabelsProvider`. */\n  labels?: SignoffLabelsInput | undefined;\n}\n\n/**\n * \"Approve all\" and \"Deny all\" for the approvals a run is waiting on together, such as parallel\n * calls. Each is answered once, as Approve or Deny on its own card would; with a critical one among\n * them, Approve all asks for a second press. Approve all runs each call with the agent's arguments:\n * it does not see an edit made on a card (`editable`), so approve an edited call on its own card.\n *\n * Once the answers reach the parts, the bar goes. What it did is still announced, and focus, which\n * was on its button, moves to the first of their `ToolApprovalCard`s, as deciding on a card keeps\n * focus on that card.\n */\nexport function ToolApprovalBatch({\n  parts,\n  onRespond,\n  policy,\n  tools,\n  min = 2,\n  labels,\n  className,\n  ...props\n}: ToolApprovalBatchProps) {\n  const A = useLabels(LABELS, labels).approvalCard;\n  const B = A.batch;\n  const [announcement, setAnnouncement] = useState('');\n  const groupRef = useRef<HTMLDivElement>(null);\n  const statusRef = useRef<HTMLDivElement>(null);\n  /** The requests Approve all or Deny all answered, until they leave `waiting`. */\n  const answered = useRef<string[]>(undefined);\n  const waiting = parts.filter((part) => {\n    const request = approvalRequestOf(part);\n    return (\n      request &&\n      getApprovalStatus(part) === 'pending' &&\n      !isAutomaticApproval(part.approval) &&\n      !(policy && evaluateRules(policy.rules, request.toolName, request.input))\n    );\n  });\n  // Armed for these calls and their arguments: one more arriving, one answered on its card, or new\n  // arguments need a new first press.\n  const [confirming, setConfirming] = useArmed<true>(\n    groupRef,\n    waiting.map((part) => [part.toolCallId, part.input]),\n    () => setAnnouncement(A.confirmCancelled),\n  );\n  useEffect(() => {\n    if (!announcement) return;\n    const id = setTimeout(() => setAnnouncement(''), ANNOUNCEMENT_MS);\n    return () => clearTimeout(id);\n  }, [announcement]);\n  // The answers have reached the parts: the bar has gone, and focus with it, from its button to\n  // <body>. Move it to the first card answered, unless the person has moved it already.\n  useEffect(() => {\n    const ids = answered.current;\n    if (!ids || waiting.some((part) => ids.includes(part.approval!.id))) return;\n    answered.current = undefined;\n    const focused = focusedElement();\n    if (focused && focused !== document.body) return;\n    const root = (statusRef.current?.getRootNode() ?? document) as Document | ShadowRoot;\n    [...root.querySelectorAll<HTMLElement>('[data-slot=\"signoff-approval-card\"][data-approval-id]')]\n      .find((card) => ids.includes(card.dataset.approvalId!))\n      ?.focus();\n  });\n  const shown = waiting.length >= min;\n  // The announcement outlives the bar: answering removes the bar in the commit that announces it.\n  const status = (shown || announcement !== '') && (\n    <div\n      ref={statusRef}\n      data-signoff\n      data-slot=\"signoff-approval-batch-status\"\n      className=\"sr-only\"\n      role=\"status\"\n      aria-live=\"polite\"\n      aria-atomic=\"true\"\n    >\n      {announcement}\n    </div>\n  );\n  if (!shown) return status || null;\n  // A held Enter clicks the focused button on every repeat: one press, one answer.\n  const ignoreRepeat = (event: KeyboardEvent<HTMLButtonElement>) => {\n    if (event.repeat && event.key === 'Enter') event.preventDefault();\n  };\n  const critical = waiting.some((part) => {\n    const meta = tools?.[getToolPartName(part)];\n    return (typeof meta?.risk === 'function' ? meta.risk(part.input) : meta?.risk) === 'critical';\n  });\n  const answerAll = (decision: 'allow-once' | 'deny-once') => {\n    if (decision === 'allow-once' && critical && !confirming) {\n      setConfirming(true);\n      setAnnouncement(B.critical);\n      return;\n    }\n    setConfirming(undefined);\n    answered.current = waiting.map((part) => part.approval!.id);\n    for (const part of waiting) {\n      const request = approvalRequestOf(part)!;\n      const outcome = policy?.decide(request, decision);\n      void onRespond(outcome ? toResponse(outcome) : { id: request.id, approved: decision === 'allow-once' });\n    }\n    setAnnouncement(B.answered(waiting.length, decision === 'allow-once'));\n  };\n  // The second click of a double click is the same press: it does not confirm Approve all.\n  const press = (decision: 'allow-once' | 'deny-once', event: MouseEvent) => {\n    if (event.detail <= 1) answerAll(decision);\n  };\n  return (\n    <>\n      {status}\n      <div\n        ref={groupRef}\n        data-signoff\n        data-slot=\"signoff-approval-batch\"\n        role=\"group\"\n        // A click focuses the group where it doesn't focus the button (Safari), so focus leaving it\n        // can disarm Approve all there too. Not in the tab order: its buttons are.\n        tabIndex={-1}\n        aria-label={B.group}\n        className={cn(\n          'rounded-signoff border-signoff-warn/40 bg-signoff-surface font-signoff-sans text-signoff-fg flex flex-wrap items-center gap-x-3 gap-y-2 border px-3.5 py-2.5 text-[13px] outline-none',\n          className,\n        )}\n        {...props}\n      >\n        <ShieldIcon size={15} className=\"text-signoff-warn-fg shrink-0\" />\n        <span className=\"text-signoff-fg font-medium\">{B.waiting(waiting.length)}</span>\n        <span className=\"ml-auto flex items-center gap-2\">\n          <button\n            type=\"button\"\n            onKeyDown={ignoreRepeat}\n            onClick={(event) => press('deny-once', event)}\n            className=\"border-signoff-border-strong text-signoff-fg hover:bg-signoff-surface-2 focus-visible:outline-signoff-ring inline-flex h-7 cursor-pointer items-center rounded-lg border px-2.5 text-xs font-medium focus-visible:outline-2 focus-visible:outline-offset-2\"\n          >\n            {B.denyAll}\n          </button>\n          <button\n            type=\"button\"\n            onKeyDown={ignoreRepeat}\n            onClick={(event) => press('allow-once', event)}\n            className={cn(\n              'focus-visible:outline-signoff-ring inline-flex h-7 cursor-pointer items-center rounded-lg px-2.5 text-xs font-semibold focus-visible:outline-2 focus-visible:outline-offset-2 forced-colors:border',\n              confirming\n                ? 'bg-signoff-hot text-signoff-on-hot hover:bg-signoff-hot/90'\n                : 'bg-signoff-accent text-signoff-on-accent hover:bg-signoff-accent/90',\n            )}\n          >\n            {confirming ? B.confirm : B.approveAll}\n          </button>\n        </span>\n      </div>\n    </>\n  );\n}\n",
      "type": "registry:component",
      "target": "components/signoff-ui/approval-card.tsx"
    },
    {
      "path": "packages/signoff-ui/src/labels.tsx",
      "content": "'use client';\n\nimport { createContext, useContext, useMemo, type ReactNode } from 'react';\nimport { defaultLabels, mergeLabels, type SignoffLabels, type SignoffLabelsInput } from './lib/labels';\n\n/** What the providers above give: their labels merged, the nearest winning. Empty without one. */\nconst LabelsContext = createContext<SignoffLabelsInput>({});\n\n/**\n * Labels for every component inside: a translation of `defaultLabels`, whole or in part. Providers\n * nest, the inner one winning key by key. Labels hold functions, so render the provider from a\n * Client Component (a module with 'use client') and keep the object stable: at module scope, or memoized.\n */\nexport function SignoffLabelsProvider({ labels, children }: { labels: SignoffLabelsInput; children: ReactNode }) {\n  const parent = useContext(LabelsContext);\n  const value = useMemo(() => mergeLabels(parent, labels), [parent, labels]);\n  return <LabelsContext.Provider value={value}>{children}</LabelsContext.Provider>;\n}\n\n/** A component's own `labels`, for what it renders inside too; nothing extra without them. */\nexport function WithLabels({ labels, children }: { labels: SignoffLabelsInput | undefined; children: ReactNode }) {\n  return labels ? <SignoffLabelsProvider labels={labels}>{children}</SignoffLabelsProvider> : children;\n}\n\n/** Every label in effect here: the English, the providers' over it, and `overrides` over both. */\nexport function useSignoffLabels(overrides?: SignoffLabelsInput): SignoffLabels {\n  const context = useContext(LabelsContext);\n  return useMemo(() => mergeLabels(defaultLabels, context, overrides), [context, overrides]);\n}\n\n/**\n * The sections a component reads, from their English defaults (a module-level object, such as\n * `{ sources: sourcesLabels }`), with the providers' labels and the component's own over them.\n * Only those sections' defaults end up in the component's bundle.\n */\nexport function useLabels<T extends Partial<SignoffLabels>>(defaults: T, overrides?: SignoffLabelsInput): T {\n  const context = useContext(LabelsContext);\n  return useMemo(() => {\n    const keys = Object.keys(defaults) as (keyof T & keyof SignoffLabelsInput)[];\n    if (!overrides && keys.every((key) => context[key] === undefined)) return defaults;\n    const own: SignoffLabelsInput = {};\n    const theirs: SignoffLabelsInput = {};\n    for (const key of keys) {\n      if (context[key] !== undefined) Object.assign(theirs, { [key]: context[key] });\n      if (overrides?.[key] !== undefined) Object.assign(own, { [key]: overrides[key] });\n    }\n    return mergeLabels(defaults as SignoffLabelsInput, theirs, own) as T;\n  }, [defaults, context, overrides]);\n}\n",
      "type": "registry:component",
      "target": "components/signoff-ui/labels.tsx"
    },
    {
      "path": "packages/signoff-ui/src/lib/ai.ts",
      "content": "/**\n * Thin, dependency-free helpers over AI SDK v7 `UIMessage` parts.\n * Only types are imported from `ai`, so nothing from the SDK runtime ends up in the bundle.\n */\nimport type {\n  ChatStatus,\n  DynamicToolUIPart,\n  LanguageModelUsage,\n  ReasoningUIPart,\n  SourceDocumentUIPart,\n  SourceUrlUIPart,\n  TextUIPart,\n  ToolUIPart,\n  UIMessage,\n  UITools,\n} from 'ai';\n\n/**\n * Fields AI SDK 7 added to a tool part's `approval`: whether a `toolApproval` policy decided it,\n * and why the tool asked. AI SDK 6 has neither, so they are read defensively.\n */\ntype ApprovalExtras = { isAutomatic?: unknown; requestReason?: unknown } | undefined;\n\n/** Whether a policy decided the approval rather than a person. Always false on AI SDK 6. */\nexport function isAutomaticApproval(approval: object | undefined): boolean {\n  return (approval as ApprovalExtras)?.isAutomatic === true;\n}\n\n/**\n * Denied after a person approved it, by a check on the server: AI SDK 7 checks edited arguments\n * against `toolApproval` again. That denial streams with no reason, and the part keeps the approval.\n */\nexport function isDeniedAfterApproval(part: { state: string; approval?: object | undefined }): boolean {\n  return part.state === 'output-denied' && (part.approval as { approved?: unknown } | undefined)?.approved === true;\n}\n\n/** The reason the tool gave for asking (AI SDK 7's `requestReason`), if any. */\nexport function getApprovalRequestReason(approval: object | undefined): string | undefined {\n  const reason = (approval as ApprovalExtras)?.requestReason;\n  return typeof reason === 'string' ? reason : undefined;\n}\n\nexport type { ChatStatus, UIMessage };\n\n/** Any part of any `UIMessage`. */\nexport type AnyUIPart = UIMessage['parts'][number];\n/** A static (`tool-${name}`) or dynamic tool part. */\nexport type ToolPart = ToolUIPart<UITools> | DynamicToolUIPart;\n/** The AI SDK v7 tool part states. */\nexport type ToolState = ToolPart['state'];\nexport type SourcePart = SourceUrlUIPart | SourceDocumentUIPart;\nexport type { ReasoningUIPart, SourceDocumentUIPart, SourceUrlUIPart, TextUIPart };\n\n/** Token usage, compatible with the AI SDK `LanguageModelUsage` shape. */\nexport type RunUsage = {\n  inputTokens?: number | undefined;\n  outputTokens?: number | undefined;\n  totalTokens?: number | undefined;\n  inputTokenDetails?: Partial<LanguageModelUsage['inputTokenDetails']> | undefined;\n  outputTokenDetails?: Partial<LanguageModelUsage['outputTokenDetails']> | undefined;\n};\n\nexport const TOOL_STATES = [\n  'input-streaming',\n  'input-available',\n  'approval-requested',\n  'approval-responded',\n  'output-available',\n  'output-error',\n  'output-denied',\n] as const satisfies readonly ToolState[];\n\nexport function isToolPart(part: { type: string }): part is ToolPart {\n  return part.type === 'dynamic-tool' || part.type.startsWith('tool-');\n}\n\nexport function isSourcePart(part: { type: string }): part is SourcePart {\n  return part.type === 'source-url' || part.type === 'source-document';\n}\n\n/** Same semantics as the SDK's `getToolName`, without the runtime import. */\nexport function getToolPartName(part: ToolPart): string {\n  return part.type === 'dynamic-tool' ? part.toolName : part.type.slice('tool-'.length);\n}\n\n/**\n * A UI-level phase derived from the SDK tool state. Several SDK states collapse\n * into one visual phase (e.g. an approved call that has not returned yet is \"running\").\n */\nexport type ToolPhase = 'streaming' | 'running' | 'awaiting-approval' | 'success' | 'error' | 'denied';\n\nexport function getToolPhase(\n  part: Pick<ToolPart, 'state'> & {\n    approval?: { approved?: boolean; isAutomatic?: boolean } | undefined;\n    preliminary?: boolean | undefined;\n  },\n): ToolPhase {\n  switch (part.state) {\n    case 'input-streaming':\n      return 'streaming';\n    case 'input-available':\n      return 'running';\n    case 'approval-requested':\n      // A policy decision (`isAutomatic`) streams as a request immediately followed by its response.\n      return part.approval?.isAutomatic ? 'running' : 'awaiting-approval';\n    case 'approval-responded':\n      return part.approval?.approved ? 'running' : 'denied';\n    case 'output-available':\n      return part.preliminary ? 'running' : 'success';\n    case 'output-error':\n      return 'error';\n    case 'output-denied':\n      return 'denied';\n  }\n}\n\n/** The English phase names. The timeline reads them from `labels.toolCallTimeline.phases`. */\nexport const TOOL_PHASE_LABEL: Record<ToolPhase, string> = {\n  streaming: 'Preparing',\n  running: 'Running',\n  'awaiting-approval': 'Needs approval',\n  success: 'Done',\n  error: 'Failed',\n  denied: 'Denied',\n};\n\nexport function isSettledPhase(phase: ToolPhase): boolean {\n  return phase === 'success' || phase === 'error' || phase === 'denied';\n}\n\nexport function getToolParts(parts: readonly AnyUIPart[]): ToolPart[] {\n  return parts.filter(isToolPart);\n}\n\n/** Where a sub-agent is: working, finished, failed, or paused until a later run (AG-UI's `suspended`). */\nexport type SubagentStatus = 'running' | 'done' | 'error' | 'suspended';\n\n/** A sub-agent's run, as the `data` of a `data-signoff-subagent` part. */\nexport interface SubagentData {\n  subagentRunId: string;\n  /** The tool call that started it: the timeline nests the sub-agent under that call. */\n  parentToolCallId?: string | undefined;\n  name?: string | undefined;\n  status: SubagentStatus;\n  /** What went wrong, when `status` is `error`. */\n  errorText?: string | undefined;\n  /** Its tool calls and text, as message parts. A sub-agent it started is a part here too. */\n  parts: AnyUIPart[];\n}\n\n/** A sub-agent's work, in its parent's message: the AG-UI adapter makes one, and you can stream your own. */\nexport interface SubagentPart {\n  type: 'data-signoff-subagent';\n  id?: string | undefined;\n  data: SubagentData;\n}\n\nexport function isSubagentPart(part: { type: string }): part is SubagentPart {\n  return part.type === 'data-signoff-subagent' && Array.isArray((part as SubagentPart).data?.parts);\n}\n\n/** Every tool call in `parts`, with those of its sub-agents, at any depth. */\nexport function getAllToolParts(parts: readonly AnyUIPart[]): ToolPart[] {\n  const out: ToolPart[] = [];\n  for (const part of parts) {\n    if (isToolPart(part)) out.push(part);\n    else if (isSubagentPart(part)) out.push(...getAllToolParts(part.data.parts));\n  }\n  return out;\n}\n\n/**\n * Calls that only the model or a tool can still finish: input still streaming, running, or partial\n * output. Once the run has ended, these were cut off. An approved call waiting for the app to send\n * the continuation (`approval-responded`) is not one: `useChat` sends it after a render. Once that\n * request has `failed`, it is: its result will not come.\n */\nexport function isInterruptibleToolPart(part: ToolPart, failed = false): boolean {\n  return (\n    part.state === 'input-streaming' ||\n    part.state === 'input-available' ||\n    (part.state === 'output-available' && part.preliminary === true) ||\n    (failed && part.state === 'approval-responded' && part.approval.approved === true)\n  );\n}\n\nexport type ApprovalStatus = 'pending' | 'approved' | 'denied';\n\n/** The approval state of a tool part, or `undefined` for parts outside the approval flow. */\nexport function getApprovalStatus(part: ToolPart): ApprovalStatus | undefined {\n  if (!part.approval) return undefined;\n  if (part.state === 'approval-requested') return 'pending';\n  if (part.state === 'output-denied') return 'denied';\n  return part.approval.approved ? 'approved' : part.approval.approved === false ? 'denied' : 'pending';\n}\n\nexport interface ToolTiming {\n  /** First time the call was observed (input started streaming). */\n  startedAt?: number | undefined;\n  /** When execution began: input complete, or approval granted. Unset while the call waits for approval. */\n  runningAt?: number | undefined;\n  /** When the call settled (output, error or denial). */\n  endedAt?: number | undefined;\n}\n\nexport type ToolTimings = Readonly<Record<string, ToolTiming>>;\n\n/** Pure reducer behind `useToolTimings`, exported for tests and custom stores. */\nexport function observeToolTimings(prev: ToolTimings, tools: readonly ToolPart[], now: number): ToolTimings {\n  let next: Record<string, ToolTiming> | undefined;\n  const write = (id: string, value: ToolTiming) => {\n    next ??= { ...prev };\n    next[id] = value;\n  };\n  for (const tool of tools) {\n    const phase = getToolPhase(tool);\n    const current = (next ?? prev)[tool.toolCallId];\n    if (!current) {\n      if (isSettledPhase(phase)) write(tool.toolCallId, {});\n      else write(tool.toolCallId, { startedAt: now, runningAt: phase === 'running' ? now : undefined });\n      continue;\n    }\n    if (current.startedAt === undefined || current.endedAt !== undefined) continue;\n    if (phase === 'running' && current.runningAt === undefined) write(tool.toolCallId, { ...current, runningAt: now });\n    // A call can look running before its approval request arrives (AI SDK 6 renders `input-available`\n    // first; AG-UI does between TOOL_CALL_END and the interrupt). Its run starts again once approved.\n    else if (phase === 'awaiting-approval' && current.runningAt !== undefined)\n      write(tool.toolCallId, { ...current, runningAt: undefined });\n    else if (isSettledPhase(phase))\n      write(tool.toolCallId, { ...current, runningAt: current.runningAt ?? now, endedAt: now });\n  }\n  return next ?? prev;\n}\n\n/** Collect sources, de-duplicated by URL (or source id for documents). */\nexport function getSourceParts(parts: readonly AnyUIPart[]): SourcePart[] {\n  const seen = new Set<string>();\n  const out: SourcePart[] = [];\n  for (const part of parts) {\n    if (!isSourcePart(part)) continue;\n    const key = part.type === 'source-url' ? part.url : `doc:${part.sourceId}`;\n    if (seen.has(key)) continue;\n    seen.add(key);\n    out.push(part);\n  }\n  return out;\n}\n\n/** A source in app-level shape. AI SDK `source-url` / `source-document` parts are accepted too. */\nexport interface SourceItem {\n  id: string;\n  url?: string | undefined;\n  title?: string | undefined;\n  /** Optional snippet shown in the cards variant. */\n  description?: string | undefined;\n  /** For documents. */\n  filename?: string | undefined;\n  mediaType?: string | undefined;\n}\n\nexport function toSourceItem(source: SourcePart | SourceItem): SourceItem {\n  if ('type' in source && isSourcePart(source as SourcePart)) {\n    const part = source as SourcePart;\n    return part.type === 'source-url'\n      ? { id: part.sourceId, url: part.url, title: part.title }\n      : { id: part.sourceId, title: part.title, filename: part.filename, mediaType: part.mediaType };\n  }\n  return source as SourceItem;\n}\n\nexport type AgentState = 'idle' | 'thinking' | 'working' | 'awaiting-approval' | 'done' | 'stopped' | 'error';\n\n/** The English state names. `AgentStatus` reads them from `labels.agentStatus.states`. */\nexport const AGENT_STATE_LABEL: Record<AgentState, string> = {\n  idle: 'Idle',\n  thinking: 'Thinking',\n  working: 'Working',\n  'awaiting-approval': 'Waiting for approval',\n  done: 'Done',\n  stopped: 'Stopped',\n  error: 'Error',\n};\n\nexport interface DerivedAgentState {\n  state: AgentState;\n  /** Short human detail, e.g. \"read_file\" or \"Writing response\". */\n  detail?: string | undefined;\n}\n\n/**\n * Map `useChat` status plus the latest assistant message to a single agent state.\n * Human-in-the-loop waits (approvals, client-side tools awaiting output) take\n * precedence over transport status, because the run cannot progress without the user.\n *\n * A run that ended (`ready`) with work still unfinished in the message is `stopped`, not `done`:\n * text or reasoning still streaming, a tool call still preparing, running or partial, or a\n * sub-agent still running. That is what `stop()` leaves behind, and what an AG-UI run cancelled or\n * aborted mid-way does. A client-side tool the app runs itself is the exception: name it in\n * `clientTools`.\n */\nexport function deriveAgentState({\n  status,\n  message,\n  pendingClientTools = [],\n  clientTools = [],\n  writingResponse = 'Writing response',\n}: {\n  status: ChatStatus;\n  message?: Pick<UIMessage, 'role' | 'parts'> | undefined;\n  /**\n   * Names of client-side tools whose `input-available` state means \"waiting for the user\". Pass the\n   * same names to `AgentMessage`, so their calls show no duration: the time is the person's.\n   */\n  pendingClientTools?: readonly string[];\n  /**\n   * Names of client-side tools the app runs itself (`onToolCall`, then `addToolOutput`). `useChat`\n   * is `ready` while one runs: its `input-available` call then reads `working` with the tool's name\n   * as the detail, not `stopped`, until the output lands and the run continues.\n   */\n  clientTools?: readonly string[];\n  /** The detail while the model writes its answer. Default \"Writing response\": pass `labels.agentStatus.writingResponse`. */\n  writingResponse?: string;\n}): DerivedAgentState {\n  if (status === 'error') return { state: 'error' };\n  const parts = message?.role === 'assistant' ? message.parts : [];\n  // A sub-agent's calls count as the message's own: one waiting on approval holds up the run.\n  const tools = getAllToolParts(parts);\n  const approval = tools.find((t) => t.state === 'approval-requested' && !isAutomaticApproval(t.approval));\n  if (approval) return { state: 'awaiting-approval', detail: getToolPartName(approval) };\n  const clientWait = tools.find(\n    (t) => t.state === 'input-available' && pendingClientTools.includes(getToolPartName(t)),\n  );\n  if (clientWait && status !== 'submitted') return { state: 'awaiting-approval', detail: getToolPartName(clientWait) };\n  if (status === 'submitted') return { state: 'thinking' };\n  if (status === 'streaming') {\n    let last = parts.at(-1);\n    if (!last || last.type === 'step-start' || last.type === 'reasoning') return { state: 'thinking' };\n    // A settled call (done, failed or denied) or a sub-agent that has finished is not work: the model\n    // is answering it. Parallel calls settle in any order, so a call or sub-agent of this step still\n    // running before it is. Calls of earlier steps had all settled when this one started.\n    if (isSettledWork(last)) {\n      const step = parts.slice(parts.findLastIndex((p) => p.type === 'step-start') + 1);\n      last = step.findLast((p) => (isToolPart(p) || isSubagentPart(p)) && !isSettledWork(p));\n      if (!last) return { state: 'thinking' };\n    }\n    if (isToolPart(last)) return { state: 'working', detail: getToolPartName(last) };\n    if (isSubagentPart(last)) {\n      // Its call still going, or the sub-agent itself while it thinks between calls.\n      const call = getAllToolParts([last]).findLast((t) => !isSettledPhase(getToolPhase(t)));\n      return { state: 'working', detail: call ? getToolPartName(call) : last.data.name };\n    }\n    if (last.type === 'text') return { state: 'working', detail: writingResponse };\n    return { state: 'working' };\n  }\n  if (status === 'ready') {\n    const running = tools.find((t) => t.state === 'input-available' && clientTools.includes(getToolPartName(t)));\n    if (running) return { state: 'working', detail: getToolPartName(running) };\n    if (parts.some(isUnfinishedPart)) return { state: 'stopped' };\n  }\n  return parts.length > 0 ? { state: 'done' } : { state: 'idle' };\n}\n\n/** A call that has settled (done, failed or denied), or a sub-agent no longer running. */\nfunction isSettledWork(part: AnyUIPart): boolean {\n  if (isToolPart(part)) return isSettledPhase(getToolPhase(part));\n  return isSubagentPart(part) && part.data.status !== 'running';\n}\n\n/**\n * A part the run left unfinished: text or reasoning still streaming, an interrupted tool call, or a\n * sub-agent still running (the run ended between its steps, with its calls settled).\n */\nfunction isUnfinishedPart(part: AnyUIPart): boolean {\n  if (part.type === 'text' || part.type === 'reasoning') return part.state === 'streaming';\n  if (isSubagentPart(part)) return part.data.status === 'running' || part.data.parts.some(isUnfinishedPart);\n  return isToolPart(part) && isInterruptibleToolPart(part);\n}\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/ai.ts"
    },
    {
      "path": "packages/signoff-ui/src/lib/format.ts",
      "content": "/** Formatting helpers shared by the components. All output is locale-stable. */\n\n/*\n * Each unit is chosen by the value as it will be printed, not the raw value: otherwise rounding\n * produces \"1000ms\", \"60.0s\" or \"1000.0k\" instead of moving up to the next unit.\n */\n\nexport function formatDuration(ms: number | undefined | null): string {\n  if (ms == null || !Number.isFinite(ms) || ms < 0) return '–';\n  if (Math.round(ms) < 1000) return `${Math.round(ms)}ms`;\n  const centis = (ms / 1000).toFixed(2);\n  if (Number(centis) < 10) return `${centis}s`;\n  const tenths = (ms / 1000).toFixed(1);\n  if (Number(tenths) < 60) return `${tenths}s`;\n  const seconds = Math.round(ms / 1000);\n  return `${Math.floor(seconds / 60)}m ${String(seconds % 60).padStart(2, '0')}s`;\n}\n\n/** Spoken form for screen readers, e.g. \"1.2 seconds\". */\nexport function formatDurationLong(ms: number | undefined | null): string {\n  if (ms == null || !Number.isFinite(ms) || ms < 0) return 'unknown duration';\n  if (Math.round(ms) < 1000) return `${Math.round(ms)} milliseconds`;\n  const tenths = (ms / 1000).toFixed(1);\n  if (Number(tenths) < 60) return `${tenths} seconds`;\n  const total = Math.round(ms / 1000);\n  const minutes = Math.floor(total / 60);\n  const rest = total % 60;\n  return `${minutes} minute${minutes === 1 ? '' : 's'} ${rest} second${rest === 1 ? '' : 's'}`;\n}\n\nexport function formatTokens(n: number | undefined | null): string {\n  if (n == null || !Number.isFinite(n)) return '–';\n  if (Math.abs(Math.round(n)) < 1000) return String(Math.round(n));\n  const hundredths = (n / 1000).toFixed(2);\n  if (Math.abs(Number(hundredths)) < 10) return `${hundredths}k`;\n  const tenths = (n / 1000).toFixed(1);\n  if (Math.abs(Number(tenths)) < 1000) return `${tenths}k`;\n  return `${(n / 1_000_000).toFixed(2)}M`;\n}\n\nexport function formatCost(usd: number | undefined | null): string {\n  if (usd == null || !Number.isFinite(usd)) return '–';\n  if (usd === 0) return '$0.00';\n  const four = usd.toFixed(4);\n  if (Math.abs(Number(four)) < 0.01) return `$${four}`;\n  const three = usd.toFixed(3);\n  if (Math.abs(Number(three)) < 1) return `$${three}`;\n  return `$${usd.toFixed(2)}`;\n}\n\n/** `read_file` / `readFile` / `read-file` → \"Read file\". */\nexport function humanizeToolName(name: string): string {\n  const spaced = name\n    .replace(/[_-]+/g, ' ')\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .trim()\n    .toLowerCase();\n  return spaced.charAt(0).toUpperCase() + spaced.slice(1);\n}\n\nexport function getHostname(url: string): string {\n  try {\n    return new URL(url).hostname.replace(/^www\\./, '');\n  } catch {\n    return url;\n  }\n}\n\n/** Compact one-line preview of an arbitrary tool input. */\nexport function summarizeValue(value: unknown, max = 72): string | undefined {\n  if (value == null) return undefined;\n  let text: string;\n  if (typeof value === 'string') text = value;\n  else if (typeof value === 'number' || typeof value === 'boolean') text = String(value);\n  else if (typeof value === 'object') {\n    const entries = Object.entries(value as Record<string, unknown>);\n    if (entries.length === 0) return undefined;\n    // Prefer the first string-ish field: it is usually the most descriptive (query, path, command).\n    const primary = entries.find(([, v]) => typeof v === 'string');\n    text = primary\n      ? String(primary[1])\n      : entries.map(([k, v]) => `${k}: ${typeof v === 'object' ? '…' : String(v)}`).join(', ');\n  } else return undefined;\n  text = text.replace(/\\s+/g, ' ').trim();\n  return text.length > max ? `${text.slice(0, max - 1)}…` : text;\n}\n\n/**\n * A value as JSON, for showing it: a bigint as `10n`, and an object inside itself as `[Circular]`.\n * Only a cycle is: an object that comes twice, side by side (`{ a: env, b: env }`), is written out\n * each time, as the call that receives it reads it.\n */\nexport function safeStringify(value: unknown, space = 2): string {\n  if (value === undefined) return 'undefined';\n  if (typeof value === 'string') return JSON.stringify(value);\n  // The objects from the root down to the one being written, which only a cycle comes back to.\n  const path: object[] = [];\n  try {\n    return (\n      JSON.stringify(\n        value,\n        function (this: unknown, _key, v: unknown) {\n          if (typeof v === 'bigint') return `${v.toString()}n`;\n          if (typeof v === 'object' && v !== null) {\n            // `this` holds `v`: what is below it on the path was written, and is not around `v`.\n            while (path.length > 0 && path.at(-1) !== this) path.pop();\n            if (path.includes(v)) return '[Circular]';\n            path.push(v);\n          }\n          return v;\n        },\n        space,\n      ) ?? String(value)\n    );\n  } catch {\n    return String(value);\n  }\n}\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/format.ts"
    },
    {
      "path": "packages/signoff-ui/src/lib/highlight.ts",
      "content": "/**\n * A deliberately small, line-oriented syntax tokenizer. It covers the languages\n * agents edit most (TS/JS/JSON/CSS/shell/YAML/Python) well enough for review UI\n * without shipping a grammar engine. Multi-line constructs are tokenized per line.\n */\nexport type TokenKind = 'plain' | 'keyword' | 'string' | 'number' | 'comment' | 'punctuation' | 'property';\n\nexport interface Token {\n  text: string;\n  kind: TokenKind;\n}\n\nconst JS_KEYWORDS = new Set(\n  (\n    'abstract as async await break case catch class const continue debugger declare default delete do else enum export extends ' +\n    'false finally for from function get if implements import in instanceof interface let new null of private protected public ' +\n    'readonly return satisfies set static super switch this throw true try type typeof undefined var void while with yield'\n  ).split(' '),\n);\nconst PY_KEYWORDS = new Set(\n  'and as assert async await break class continue def del elif else except False finally for from global if import in is lambda None nonlocal not or pass raise return True try while with yield'.split(\n    ' ',\n  ),\n);\nconst SH_KEYWORDS = new Set(\n  'if then else elif fi for in do done while case esac function export local return'.split(' '),\n);\nconst LITERALS = new Set(['true', 'false', 'null']);\n\nconst HASH_COMMENT = new Set(['sh', 'py', 'yaml']);\n\nconst RULES: Array<[RegExp, TokenKind | 'word']> = [\n  [/^\\/\\/.*/, 'comment'],\n  [/^\\/\\*.*?(\\*\\/|$)/, 'comment'],\n  [/^\"(?:[^\"\\\\]|\\\\.)*\"?/, 'string'],\n  [/^'(?:[^'\\\\]|\\\\.)*'?/, 'string'],\n  [/^`(?:[^`\\\\]|\\\\.)*`?/, 'string'],\n  [/^-?(?:0x[\\da-f]+|\\d[\\d_]*(?:\\.\\d+)?(?:e[+-]?\\d+)?)\\b/i, 'number'],\n  [/^[A-Za-z_$][\\w$-]*/, 'word'],\n  [/^\\s+/, 'plain'],\n  [/^[{}()[\\];,.<>/=+\\-*!?:&|%^~@#]/, 'punctuation'],\n];\n\nexport function tokenizeLine(line: string, language = 'text'): Token[] {\n  if (language === 'text' || language === 'md' || !line) return [{ text: line, kind: 'plain' }];\n  const tokens: Token[] = [];\n  const keywords = language === 'py' ? PY_KEYWORDS : language === 'sh' ? SH_KEYWORDS : JS_KEYWORDS;\n  let rest = line;\n  while (rest.length > 0) {\n    if (HASH_COMMENT.has(language) && rest.startsWith('#')) {\n      tokens.push({ text: rest, kind: 'comment' });\n      break;\n    }\n    let matched = false;\n    for (const [re, kind] of RULES) {\n      if (\n        (kind === 'comment' && HASH_COMMENT.has(language)) ||\n        (language === 'css' && kind === 'comment' && re.source.startsWith('^\\\\/\\\\/'))\n      )\n        continue;\n      const m = re.exec(rest);\n      if (!m) continue;\n      const text = m[0];\n      let resolved: TokenKind;\n      if (kind === 'word') {\n        if (language === 'json') resolved = LITERALS.has(text) ? 'keyword' : 'plain';\n        else if (language === 'css') resolved = /^\\s*:/.test(rest.slice(text.length)) ? 'property' : 'plain';\n        else if (language === 'yaml')\n          resolved = /^\\s*:/.test(rest.slice(text.length)) ? 'property' : LITERALS.has(text) ? 'keyword' : 'plain';\n        else resolved = keywords.has(text) ? 'keyword' : 'plain';\n        // Identifiers may not contain '-' outside CSS/YAML/shell; give the dash back.\n        if (text.includes('-') && !['css', 'yaml', 'sh'].includes(language)) {\n          const word = text.slice(0, text.indexOf('-'));\n          tokens.push({ text: word, kind: keywords.has(word) ? 'keyword' : 'plain' });\n          rest = rest.slice(word.length);\n          matched = true;\n          break;\n        }\n      } else if (\n        kind === 'string' &&\n        (language === 'json' || language === 'yaml') &&\n        /^\\s*:/.test(rest.slice(text.length))\n      ) {\n        resolved = 'property';\n      } else {\n        resolved = kind;\n      }\n      pushToken(tokens, text, resolved);\n      rest = rest.slice(text.length);\n      matched = true;\n      break;\n    }\n    if (!matched) {\n      pushToken(tokens, rest[0]!, 'plain');\n      rest = rest.slice(1);\n    }\n  }\n  return tokens;\n}\n\nfunction pushToken(tokens: Token[], text: string, kind: TokenKind) {\n  const prev = tokens.at(-1);\n  if (prev && prev.kind === kind) prev.text += text;\n  else tokens.push({ text, kind });\n}\n\nexport interface HighlightedPiece extends Token {\n  changed: boolean;\n}\n\n/** Split syntax tokens along word-diff boundaries so both can be rendered at once. */\nexport function mergeTokensWithSegments(\n  tokens: readonly Token[],\n  segments: ReadonlyArray<{ text: string; changed: boolean }> | undefined,\n): HighlightedPiece[] {\n  if (!segments || segments.length === 0) return tokens.map((t) => ({ ...t, changed: false }));\n  const out: HighlightedPiece[] = [];\n  let ti = 0;\n  let tOffset = 0;\n  for (const seg of segments) {\n    let remaining = seg.text.length;\n    while (remaining > 0 && ti < tokens.length) {\n      const token = tokens[ti]!;\n      const available = token.text.length - tOffset;\n      const take = Math.min(available, remaining);\n      out.push({ text: token.text.slice(tOffset, tOffset + take), kind: token.kind, changed: seg.changed });\n      remaining -= take;\n      tOffset += take;\n      if (tOffset >= token.text.length) {\n        ti++;\n        tOffset = 0;\n      }\n    }\n  }\n  return out;\n}\n\nexport const TOKEN_CLASS: Record<TokenKind, string> = {\n  plain: '',\n  keyword: 'text-signoff-code-keyword',\n  string: 'text-signoff-code-string',\n  number: 'text-signoff-code-number',\n  comment: 'text-signoff-code-comment italic',\n  punctuation: 'text-signoff-code-punctuation',\n  property: 'text-signoff-code-keyword',\n};\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/highlight.ts"
    },
    {
      "path": "packages/signoff-ui/src/lib/hooks.ts",
      "content": "'use client';\n\nimport { useEffect, useLayoutEffect, useRef, useState, useSyncExternalStore } from 'react';\nimport { getAllToolParts, observeToolTimings, type AnyUIPart, type ChatStatus, type ToolTimings } from './ai';\n\nexport type { ToolTiming, ToolTimings } from './ai';\n\nconst useIsoLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;\n\nconst REDUCED_MOTION = '(prefers-reduced-motion: reduce)';\n\nfunction subscribeReducedMotion(callback: () => void) {\n  if (typeof window === 'undefined' || !window.matchMedia) return () => {};\n  const mql = window.matchMedia(REDUCED_MOTION);\n  mql.addEventListener('change', callback);\n  return () => mql.removeEventListener('change', callback);\n}\n\n/** Tracks the user's `prefers-reduced-motion` setting. */\nexport function usePrefersReducedMotion(): boolean {\n  return useSyncExternalStore(\n    subscribeReducedMotion,\n    () => (typeof window !== 'undefined' && window.matchMedia ? window.matchMedia(REDUCED_MOTION).matches : false),\n    () => false,\n  );\n}\n\n/**\n * Current time in ms, re-rendering on an interval while `active`.\n * The value can lag by up to one interval; clamp derived durations at 0.\n *\n * 0 on the server: reading the clock there makes the render impure (Next.js `cacheComponents`\n * fails the build on it), and clock-derived output waits for hydration anyway (`useHydrated`).\n */\nexport function useNow(active: boolean, intervalMs = 100): number {\n  const [now, setNow] = useState(() => (typeof window === 'undefined' ? 0 : Date.now()));\n  useEffect(() => {\n    if (!active) return;\n    const tick = () => setNow(Date.now());\n    const first = setTimeout(tick, 0);\n    const id = setInterval(tick, intervalMs);\n    return () => {\n      clearTimeout(first);\n      clearInterval(id);\n    };\n  }, [active, intervalMs]);\n  return now;\n}\n\n/** A tiny external store: subscribe/getSnapshot plus an `update` that only notifies on change. */\nfunction createStore<T>(initial: T) {\n  let state = initial;\n  const listeners = new Set<() => void>();\n  return {\n    get: () => state,\n    set(next: T) {\n      if (next === state) return;\n      state = next;\n      listeners.forEach((l) => l());\n    },\n    subscribe(listener: () => void) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n  };\n}\n\n/**\n * Measures tool-call timings client-side by watching AI SDK state transitions, a sub-agent's calls\n * included. Calls that are already settled when first observed (e.g. restored history)\n * get no timing rather than a misleading zero.\n */\nexport function useToolTimings(parts: readonly AnyUIPart[]): ToolTimings {\n  const [store] = useState(() => createStore<ToolTimings>({}));\n  const snapshot = useSyncExternalStore(store.subscribe, store.get, store.get);\n  useIsoLayoutEffect(() => {\n    store.set(observeToolTimings(store.get(), getAllToolParts(parts), Date.now()));\n  }, [parts, store]);\n  return snapshot;\n}\n\nexport interface RunTiming {\n  /** When the run was first seen in flight: its first request, or later if it was already running. */\n  startedAt?: number | undefined;\n  /** When the run's first response arrived. Undefined while unknown, as `ttftMs`. */\n  firstTokenAt?: number | undefined;\n  /** Milliseconds the agent spent working, excluding time waiting on the user. */\n  activeMs: number;\n  /**\n   * Time to first token of the run: from submitting its first request to the first streamed status.\n   * A first request that ends without a `streaming` status (its response arrived in one burst) counts\n   * its end as the first token. Undefined until then, and when it cannot be known: the run was already\n   * streaming when first seen, its first request failed, or (given the messages) it ended with no reply.\n   */\n  ttftMs?: number | undefined;\n  isRunning: boolean;\n}\n\n/** What `useRunTiming` reads of a message. AI SDK `UIMessage`s and `useAgUiAgent`'s messages fit. */\nexport interface RunTimingMessage {\n  id: string;\n  role: string;\n}\n\ninterface RunTimingState {\n  /** The run's key, and the last status seen. */\n  key?: unknown;\n  status?: ChatStatus | undefined;\n  startedAt?: number | undefined;\n  /** When the run's first request was submitted, while its first token can still be timed. */\n  submittedAt?: number | undefined;\n  firstTokenAt?: number | undefined;\n  accumulatedMs: number;\n  segmentStart?: number | undefined;\n}\n\ninterface RunTimingInput {\n  status: ChatStatus;\n  now: number;\n  /** A new run starts when it changes. */\n  key: unknown;\n  /** Whether a request submitted after the last one ended starts a new run. */\n  newRunOnSubmit: boolean;\n  /** Whether a message follows the last user message. Undefined without the messages. */\n  replied: boolean | undefined;\n}\n\n/**\n * Derives run latency from `useChat` status transitions: time to first token, and active time. A run\n * can span several requests (e.g. continuing after an approval); time spent waiting on the human\n * between requests is excluded from `activeMs`.\n *\n * Pass the chat's `messages` (`useChat().messages`, or `useAgUiAgent`'s): a run then starts with each\n * user message (or a regenerated reply) and spans its approval round trips. Without them, each request\n * submitted after the last one ended starts a new run, so a turn that pauses for approval is timed per\n * request. A key of your own instead (any value but an array) starts a new run only when it changes.\n */\nexport function useRunTiming(status: ChatStatus, messages?: readonly RunTimingMessage[]): RunTiming;\nexport function useRunTiming(status: ChatStatus, resetKey: unknown): RunTiming;\nexport function useRunTiming(status: ChatStatus, messagesOrKey?: unknown): RunTiming {\n  const [store] = useState(() => createStore<RunTimingState>({ accumulatedMs: 0 }));\n  const state = useSyncExternalStore(store.subscribe, store.get, store.get);\n  let key = messagesOrKey;\n  let replied: boolean | undefined;\n  if (Array.isArray(messagesOrKey)) {\n    const messages = messagesOrKey as readonly RunTimingMessage[];\n    let lastUser = messages.length - 1;\n    while (lastUser >= 0 && messages[lastUser]?.role !== 'user') lastUser--;\n    key = messages[lastUser]?.id;\n    replied = lastUser < messages.length - 1;\n  }\n  // With the messages, a request submitted with no reply after the last user message is a new turn\n  // (or a regenerated reply); one that continues a reply, after an approval, is the same run.\n  const newRunOnSubmit = messagesOrKey === undefined || replied === false;\n  useIsoLayoutEffect(() => {\n    store.set(reduceRunTiming(store.get(), { status, now: Date.now(), key, newRunOnSubmit, replied }));\n  }, [status, key, newRunOnSubmit, replied, store]);\n  const isRunning = state.segmentStart !== undefined;\n  const now = useNow(isRunning, 100);\n  return {\n    startedAt: state.startedAt,\n    firstTokenAt: state.firstTokenAt,\n    activeMs: state.accumulatedMs + (state.segmentStart !== undefined ? Math.max(0, now - state.segmentStart) : 0),\n    ttftMs:\n      state.submittedAt !== undefined && state.firstTokenAt !== undefined\n        ? state.firstTokenAt - state.submittedAt\n        : undefined,\n    isRunning,\n  };\n}\n\nconst isInFlight = (status: ChatStatus | undefined) => status === 'submitted' || status === 'streaming';\n\nfunction reduceRunTiming(prev: RunTimingState, input: RunTimingInput): RunTimingState {\n  const { status, now, key, newRunOnSubmit, replied } = input;\n  const submitted = status === 'submitted' && !isInFlight(prev.status);\n  const s: RunTimingState =\n    !Object.is(key, prev.key) || (submitted && newRunOnSubmit) ? { key, accumulatedMs: 0 } : prev;\n  if (isInFlight(status)) {\n    const startedAt = s.startedAt ?? now;\n    // The first token is timed only from the run's first request, seen from its submission: a run\n    // first seen already streaming has an unknown time to first token, not 0.\n    const submittedAt = s.startedAt === undefined ? (status === 'submitted' ? now : undefined) : s.submittedAt;\n    const segmentStart = s.segmentStart ?? now;\n    const firstTokenAt = status === 'streaming' && submittedAt !== undefined ? (s.firstTokenAt ?? now) : s.firstTokenAt;\n    if (\n      s === prev &&\n      status === s.status &&\n      startedAt === s.startedAt &&\n      submittedAt === s.submittedAt &&\n      segmentStart === s.segmentStart &&\n      firstTokenAt === s.firstTokenAt\n    )\n      return s;\n    return { ...s, status, startedAt, submittedAt, segmentStart, firstTokenAt };\n  }\n  if (s.segmentStart === undefined) return status === s.status && s === prev ? s : { ...s, status };\n  // useChat can go straight from submitted to ready when a response arrives in one burst; then the\n  // response is the first token, unless the messages show that none arrived (it was stopped).\n  const burst = s.firstTokenAt === undefined && s.submittedAt !== undefined && status === 'ready' && replied !== false;\n  const firstTokenAt = burst ? now : s.firstTokenAt;\n  return {\n    ...s,\n    status,\n    firstTokenAt,\n    // Once the first request has ended, a later one (after an approval wait) is not the first token.\n    submittedAt: firstTokenAt === undefined ? undefined : s.submittedAt,\n    accumulatedMs: s.accumulatedMs + (now - s.segmentStart),\n    segmentStart: undefined,\n  };\n}\n\n/** Eases a number toward its target; jumps immediately under reduced motion. */\nexport function useAnimatedNumber(value: number, durationMs = 450): number {\n  const reduced = usePrefersReducedMotion();\n  const [display, setDisplay] = useState(value);\n  const displayRef = useRef(value);\n  useEffect(() => {\n    if (reduced || typeof requestAnimationFrame === 'undefined') {\n      displayRef.current = value;\n      return;\n    }\n    const from = displayRef.current;\n    if (from === value) return;\n    const start = performance.now();\n    let frame = 0;\n    const tick = (t: number) => {\n      // A frame's timestamp is when the frame began, which can be before `start`: not below 0.\n      const p = Math.max(0, Math.min(1, (t - start) / durationMs));\n      const eased = 1 - Math.pow(1 - p, 3);\n      const v = from + (value - from) * eased;\n      displayRef.current = v;\n      setDisplay(v);\n      if (p < 1) frame = requestAnimationFrame(tick);\n    };\n    frame = requestAnimationFrame(tick);\n    return () => cancelAnimationFrame(frame);\n  }, [value, durationMs, reduced]);\n  return reduced || typeof requestAnimationFrame === 'undefined' ? value : display;\n}\n\nexport interface ActivityWindow {\n  startedAt?: number | undefined;\n  endedAt?: number | undefined;\n}\n\n/** Records when `active` last turned on and off. Restarts when it turns on again. */\nexport function useActivityWindow(active: boolean): ActivityWindow {\n  const [store] = useState(() => createStore<ActivityWindow>({}));\n  const state = useSyncExternalStore(store.subscribe, store.get, store.get);\n  useIsoLayoutEffect(() => {\n    const cur = store.get();\n    const now = Date.now();\n    if (active && (cur.startedAt === undefined || cur.endedAt !== undefined)) store.set({ startedAt: now });\n    else if (!active && cur.startedAt !== undefined && cur.endedAt === undefined) store.set({ ...cur, endedAt: now });\n  }, [active, store]);\n  return state;\n}\n\nconst noopSubscribe = () => () => {};\nconst detectMac = () =>\n  typeof navigator !== 'undefined' && /Mac|iPhone|iPad|iPod/.test(navigator.platform || navigator.userAgent);\n\n/** Platform check that is safe to use during hydration (server renders the non-Mac variant). */\nexport function useIsMac(): boolean {\n  return useSyncExternalStore(noopSubscribe, detectMac, () => false);\n}\n\nconst hydratedSnapshot = () => true;\nconst serverSnapshot = () => false;\n\n/**\n * False during SSR and hydration, true afterwards. Clock-derived values (live\n * durations, waterfall widths) render only once hydrated so server and client markup match.\n */\nexport function useHydrated(): boolean {\n  return useSyncExternalStore(noopSubscribe, hydratedSnapshot, serverSnapshot);\n}\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/hooks.ts"
    },
    {
      "path": "packages/signoff-ui/src/lib/icons.tsx",
      "content": "import type { SVGProps } from 'react';\n\ntype IconProps = SVGProps<SVGSVGElement> & { size?: number };\n\nfunction Svg({ size = 16, children, ...props }: IconProps) {\n  return (\n    <svg\n      width={size}\n      height={size}\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth={2}\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      aria-hidden=\"true\"\n      focusable=\"false\"\n      {...props}\n    >\n      {children}\n    </svg>\n  );\n}\n\nexport const CheckIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M5 12.5 9.5 17 19 7.5\" />\n  </Svg>\n);\nexport const XIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M6.5 6.5l11 11M17.5 6.5l-11 11\" />\n  </Svg>\n);\nexport const ChevronIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M9 6l6 6-6 6\" />\n  </Svg>\n);\nexport const BanIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <circle cx=\"12\" cy=\"12\" r=\"8.5\" />\n    <path d=\"M6 6l12 12\" />\n  </Svg>\n);\nexport const AlertIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M12 3.5 21.5 20h-19L12 3.5Z\" />\n    <path d=\"M12 10v4.5M12 17.25v.25\" />\n  </Svg>\n);\nexport const ShieldIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M12 3 19.5 6v5.5c0 4.6-3.1 8-7.5 9.5-4.4-1.5-7.5-4.9-7.5-9.5V6L12 3Z\" />\n    <path d=\"M12 8.5v4M12 15.5v.25\" />\n  </Svg>\n);\nexport const SparkIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M12 3.5c.6 4.4 2.6 6.9 7.5 8.5-4.9 1.6-6.9 4.1-7.5 8.5-.6-4.4-2.6-6.9-7.5-8.5 4.9-1.6 6.9-4.1 7.5-8.5Z\" />\n  </Svg>\n);\nexport const CopyIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <rect x=\"8.5\" y=\"8.5\" width=\"12\" height=\"12\" rx=\"2.5\" />\n    <path d=\"M15.5 5.5v-.5a2 2 0 0 0-2-2H5.5a2 2 0 0 0-2 2v8a2 2 0 0 0 2 2h.5\" />\n  </Svg>\n);\nexport const ExternalIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M14 4h6v6M20 4l-9 9\" />\n    <path d=\"M18 14v4.5a1.5 1.5 0 0 1-1.5 1.5h-11A1.5 1.5 0 0 1 4 18.5v-11A1.5 1.5 0 0 1 5.5 6H10\" />\n  </Svg>\n);\nexport const FileIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M14 3.5H7A1.5 1.5 0 0 0 5.5 5v14A1.5 1.5 0 0 0 7 20.5h10a1.5 1.5 0 0 0 1.5-1.5V8L14 3.5Z\" />\n    <path d=\"M14 3.5V8h4.5\" />\n  </Svg>\n);\nexport const ImageIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <rect x=\"3\" y=\"3\" width=\"18\" height=\"18\" rx=\"2\" />\n    <circle cx=\"9\" cy=\"9\" r=\"2\" />\n    <path d=\"m21 15-3.1-3.1a2 2 0 0 0-2.8 0L6 21\" />\n  </Svg>\n);\nexport const ToolIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M13 3 5.5 13.5h6L10.5 21 18.5 10.5h-6L13 3Z\" />\n  </Svg>\n);\nexport const TerminalIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <rect x=\"3\" y=\"4.5\" width=\"18\" height=\"15\" rx=\"2.5\" />\n    <path d=\"M7.5 9.5 10.5 12l-3 2.5M12.5 15h4\" />\n  </Svg>\n);\nexport const ClockIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <circle cx=\"12\" cy=\"12\" r=\"8.5\" />\n    <path d=\"M12 7.5V12l3 2\" />\n  </Svg>\n);\nexport const ArrowUpIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M12 19V5M6 11l6-6 6 6\" />\n  </Svg>\n);\nexport const ArrowDownIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M12 5v14M6 13l6 6 6-6\" />\n  </Svg>\n);\nexport const CommentIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M5 5h14a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1h-8l-4 3.5V16H5a1 1 0 0 1-1-1V6a1 1 0 0 1 1-1Z\" />\n  </Svg>\n);\nexport const UndoIcon = (p: IconProps) => (\n  <Svg {...p}>\n    <path d=\"M9 14 4 9l5-5\" />\n    <path d=\"M4 9h10.5a5.5 5.5 0 0 1 0 11H11\" />\n  </Svg>\n);\n\n/** Indeterminate spinner: a quarter arc on a faint track. */\nexport const SpinnerIcon = ({ className, ...p }: IconProps) => (\n  <Svg {...p} className={className}>\n    <circle cx=\"12\" cy=\"12\" r=\"8.5\" opacity=\"0.25\" />\n    <path d=\"M12 3.5a8.5 8.5 0 0 1 8.5 8.5\" />\n  </Svg>\n);\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/icons.tsx"
    },
    {
      "path": "packages/signoff-ui/src/lib/labels.ts",
      "content": "/**\n * Every word the components show or announce, in one object: pass a translation of it to\n * `SignoffLabelsProvider`, or part of one to a component's `labels`. Strings are fixed text;\n * functions build text from values (counts, names, line numbers), so a translation can get its\n * plurals and word order right. The English here is the default.\n */\nimport { formatCost, formatDuration, formatDurationLong, formatTokens } from './format';\n\n/*\n * The states the labels name, spelled out here so this module imports nothing but the formatters:\n * a copied registry item that only shows sources does not need the diff engine. They are the same\n * unions as `AgentState`, `ToolPhase`, `FileStatus`, `HunkDecision` and `ApprovalDecision`, which\n * test/labels-types.test.ts checks.\n */\ntype AgentState = 'idle' | 'thinking' | 'working' | 'awaiting-approval' | 'done' | 'stopped' | 'error';\ntype ToolPhase = 'streaming' | 'running' | 'awaiting-approval' | 'success' | 'error' | 'denied';\ntype FileStatus = 'added' | 'deleted' | 'modified' | 'renamed';\ntype HunkDecision = 'pending' | 'accepted' | 'rejected';\ntype ApprovalDecision = 'allow-once' | 'allow-session' | 'allow-always' | 'deny-once' | 'deny-always';\ntype CommentSide = 'new' | 'old';\n\nexport type RiskLevel = 'low' | 'medium' | 'high' | 'critical';\n\n/** A rule, as its description needs it: the tool and the argument patterns. */\nexport interface RuleLabel {\n  tool: string;\n  args?: Readonly<Record<string, string>> | undefined;\n}\n\n/** Where a comment is, as its description needs it. */\nexport interface CommentLabel {\n  target: 'lines' | 'hunk' | 'file';\n  side?: CommentSide | undefined;\n  startLine?: number | undefined;\n  endLine?: number | undefined;\n}\n\n/** Which choices an approval card offers, for its keyboard hint. */\nexport interface OfferedChoices {\n  approve: boolean;\n  session: boolean;\n  always: boolean;\n  deny: boolean;\n  alwaysDeny: boolean;\n}\n\n/** Lines of a hunk, as a range in one of the files. */\nexport interface RangeLabel {\n  side: CommentSide;\n  startLine: number;\n  endLine: number;\n}\n\nexport interface SignoffLabels {\n  /** How values read. Swap these for your locale's number formats. */\n  format: {\n    /** \"120ms\", \"1.20s\", \"2m 05s\". */\n    duration: (ms: number | undefined | null) => string;\n    /** For screen readers: \"1.2 seconds\". */\n    durationLong: (ms: number | undefined | null) => string;\n    /** \"980\", \"1.20k\", \"1.25M\". */\n    tokens: (n: number | undefined | null) => string;\n    /** \"$0.0123\". */\n    cost: (usd: number | undefined | null) => string;\n    /** \"42%\", from a fraction. */\n    percent: (fraction: number) => string;\n  };\n  common: {\n    /** A copy button's name for a moment after it copied. */\n    copied: string;\n    /** A copy button for something named: \"Copy arguments\". */\n    copyThe: (what: string) => string;\n    showAllLines: (count: number) => string;\n    showLess: string;\n    /** After a link that opens a new tab, for screen readers. */\n    opensInNewTab: string;\n    /** The modifier key as printed on the keyboard: ⌘ on a Mac, Ctrl elsewhere. */\n    modKey: (mac: boolean) => string;\n  };\n  agentStatus: {\n    states: Record<AgentState, string>;\n    /** What a pill says along with its state and detail, for screen readers. */\n    spoken: (state: string, detail: string | undefined) => string;\n    /** `deriveAgentState`'s detail while the model writes. */\n    writingResponse: string;\n  };\n  toolCallTimeline: {\n    list: string;\n    phases: Record<ToolPhase, string>;\n    stopped: string;\n    finished: (name: string, durationLong: string) => string;\n    failed: (name: string, error: string | undefined) => string;\n    blockedByPolicy: (name: string) => string;\n    denied: (name: string) => string;\n    input: string;\n    inputStreaming: string;\n    output: string;\n    outputPartial: string;\n    error: string;\n    deniedBy: (automatic: boolean) => string;\n    waitingForInput: string;\n    /** A sub-agent nested under the call that started it. */\n    subagent: {\n      /** Its name, when the agent gave none. */\n      name: string;\n      /** How many tool calls it made. */\n      calls: (count: number) => string;\n      /** The name of the list of its calls. */\n      list: (name: string) => string;\n      /** Paused until a later run (AG-UI's `suspended`). */\n      paused: string;\n    };\n  };\n  approvalCard: {\n    required: string;\n    risk: Record<RiskLevel, string>;\n    /** What a pending card's preview of a command is called, while it scrolls sideways. */\n    command: string;\n    arguments: string;\n    approve: string;\n    session: string;\n    always: string;\n    deny: string;\n    alwaysDeny: string;\n    sendDenial: string;\n    confirm: string;\n    denyWithFeedback: string;\n    reasonLabel: string;\n    reasonPlaceholder: string;\n    approveHint: string;\n    keyboardHint: (offered: OfferedChoices, mod: string) => string;\n    /**\n     * What a pending card says after its reason, for screen readers: the risk, what will run (the\n     * arguments' `command` and `cwd`), the first names and values of the arguments besides those\n     * (of all of them when there is no command), and the calls a lasting decision covers, as\n     * `describeRule` words them. Each is `undefined` or empty when the card has none.\n     */\n    summary: (card: {\n      risk: string | undefined;\n      command: string | undefined;\n      cwd: string | undefined;\n      args: readonly (readonly [name: string, value: string])[];\n      rule: string | undefined;\n    }) => string;\n    /** What a resolved card says of a person's decision. */\n    resolved: Record<ApprovalDecision, string>;\n    /** A lasting decision, announced with the calls its rule covers: `resolved`'s text and `describeRule`'s. */\n    resolvedFor: (resolved: string, rule: string) => string;\n    approved: string;\n    denied: string;\n    autoApproved: string;\n    blockedByPolicy: string;\n    allowedByRule: string;\n    deniedByRule: string;\n    /** A rule in words: \"run_command with command npm test*\". */\n    describeRule: (rule: RuleLabel) => string;\n    critical: string;\n    /** Announced when a critical action's first press is let go: Escape, or focus going elsewhere. */\n    confirmCancelled: string;\n    invalidJson: string;\n    editArguments: string;\n    doneEditing: string;\n    undoEdits: string;\n    edited: string;\n    argumentsJson: string;\n    notValidJson: (error: string) => string;\n    ruleLegend: string;\n    /** Around the tool's name: \"Remembered for \", run_command, \" calls where:\". */\n    rememberedFor: (anyArguments: boolean) => { before: string; after: string };\n    argumentMatches: (name: string) => string;\n    anyArguments: string;\n    globHelp: string;\n    batch: {\n      group: string;\n      waiting: (count: number) => string;\n      approveAll: string;\n      denyAll: string;\n      confirm: string;\n      critical: string;\n      answered: (count: number, approved: boolean) => string;\n    };\n  };\n  diffReview: {\n    title: string;\n    layout: string;\n    views: { unified: string; split: string };\n    files: (count: number) => string;\n    hunks: (count: number, comparing: boolean) => string;\n    status: Record<FileStatus, { letter: string; name: string }>;\n    navigator: string;\n    /** A file in the navigator, after its path, for screen readers. */\n    navigatorState: (decided: number, total: number, viewed: boolean) => string;\n    comparingShort: string;\n    /** Between a renamed file's old and new path, for screen readers (the screen shows an arrow). */\n    renamedTo: string;\n    toggleFile: (collapsed: boolean, path: string) => string;\n    viewed: string;\n    rejectFile: string;\n    acceptFile: string;\n    comparing: string;\n    fallback: string;\n    noChanges: string;\n    /** A whole file, decided as one: what the card in its place says. */\n    wholeFile: (status: FileStatus, binary: boolean, oldPath: string | undefined) => string;\n    accept: string;\n    reject: string;\n    /** \"hunk 2\" or \"change 5\", in the decision buttons' names. */\n    itemName: (kind: 'hunk' | 'file', n: number) => string;\n    acceptItem: (item: string) => string;\n    rejectItem: (item: string) => string;\n    resetItem: (item: string) => string;\n    commentOn: (what: string) => string;\n    /** The badge on a decided hunk. */\n    badge: Record<Exclude<HunkDecision, 'pending'>, string>;\n    /** A hunk's name: where it is and how it was decided. */\n    hunk: (n: number, total: number, path: string, from: number, to: number, decision: HunkDecision) => string;\n    /** A whole-file item's name; `what` is `describeFile`'s. */\n    fileItem: (n: number, total: number, path: string, what: string, decision: HunkDecision) => string;\n    describeFile: (status: FileStatus, binary: boolean, oldPath: string | undefined) => string;\n    hunkCode: (n: number, path: string) => string;\n    added: string;\n    removed: string;\n    decided: (kind: 'hunk' | 'file', n: number, total: number, decision: HunkDecision, remaining: number) => string;\n    decidedAll: (total: number, decision: Exclude<HunkDecision, 'pending'>) => string;\n    decidedFile: (count: number, path: string, decision: Exclude<HunkDecision, 'pending'>) => string;\n    viewedAnnouncement: (path: string, viewed: number, total: number) => string;\n    notViewedAnnouncement: (path: string) => string;\n    lines: (range: RangeLabel) => string;\n    selected: (line: string, range: RangeLabel) => string;\n    where: (comment: CommentLabel) => string;\n    /** Over a comment: what it is on, and before that, for screen readers only, what it is. */\n    commentHeading: (where: string) => { hidden: string; visible: string };\n    commentField: (where: string) => string;\n    commentPlaceholder: string;\n    editComment: (where: string) => string;\n    deleteComment: (where: string) => string;\n    edit: string;\n    delete: string;\n    cancel: string;\n    saveComment: string;\n    addComment: string;\n    commentAdded: (where: string, path: string) => string;\n    commentUpdated: string;\n    commentDeleted: string;\n    unchangedLines: (count: number) => string;\n    /** The gap buttons: what shows, then what only screen readers hear after it. */\n    moreAfter: (count: number, hunk: number) => { visible: string; hidden: string };\n    moreBefore: (count: number, hunk: number) => { visible: string; hidden: string };\n    showAll: (count: number) => { visible: string; hidden: string };\n    expanded: (count: number) => string;\n    /** After \"3/5\". */\n    reviewed: string;\n    filesViewed: (viewed: number, total: number) => string;\n    comments: (count: number) => string;\n    comparingFiles: string;\n    skipped: string;\n    apply: (accepted: number, total: number) => string;\n    /** Announced when the review is sent: items accepted of all, and the comments sent with them. */\n    submitted: (accepted: number, total: number, comments: number) => string;\n    acceptAll: string;\n    rejectAll: string;\n    keyHints: { move: string; accept: string; reject: string; comment: string; apply: string };\n    keyboardHelp: (mod: string) => string;\n  };\n  markdown: {\n    code: (language: string | undefined) => string;\n    /** The badge on a code block with no language. */\n    codeBadge: string;\n    copyCode: string;\n    table: string;\n    image: string;\n    imageFallback: string;\n    citation: (n: number | string) => string;\n    /** The name of a task list's checkbox (`- [x] done`), read with its state. */\n    task: string;\n  };\n  reasoning: {\n    thinking: string;\n    thoughtFor: (duration: string) => string;\n    reasoning: string;\n  };\n  runMeter: {\n    title: string;\n    metrics: (live: boolean) => string;\n    summary: (values: {\n      input: string;\n      output: string;\n      cost: string | undefined;\n      ttft: string | undefined;\n      total: string | undefined;\n    }) => string;\n    inputTokens: string;\n    outputTokens: string;\n    estimatedCost: string;\n    timeToFirstToken: string;\n    totalTime: string;\n    ttft: string;\n    live: string;\n    tokens: string;\n    estCost: string;\n    breakdown: string;\n    split: (input: string, output: string) => string;\n    input: string;\n    output: string;\n    cached: (n: string) => string;\n    reasoningTokens: (n: string) => string;\n    total: string;\n    cacheHit: string;\n    costSplit: (input: string, output: string) => string;\n    rates: (input: number, output: number) => string;\n  };\n  approvalPolicy: {\n    /** The reason a deny rule sends the agent when it has none of its own; resolved cards show it. */\n    ruleDenial: string;\n  };\n  sources: { label: string; document: string };\n  agentMessage: { attachedImage: string };\n  /** The marks on text from the agent, where it could read as something it is not. */\n  untrusted: {\n    /** A mark in place of characters that do not show, such as a bidi control or a zero-width space; `codes` lists each once. */\n    invisible: (count: number, codes: readonly string[]) => string;\n    /**\n     * A mark in place of a long run of spaces and tabs, or of blank lines, in a command or a path:\n     * `lines` is how many line breaks a run of blank lines has, which its mark shows, and 0 for spaces.\n     */\n    blank: (count: number, lines: number) => string;\n    /** Beside a link whose text names another host than the one it goes to. */\n    linksTo: (host: string) => string;\n  };\n}\n\nconst plural = (n: number, one: string, many = `${one}s`) => (n === 1 ? one : many);\n\nconst lines = (range: RangeLabel) =>\n  `${range.startLine === range.endLine ? `line ${range.startLine}` : `lines ${range.startLine} to ${range.endLine}`}${range.side === 'old' ? ' of the original' : ''}`;\n\nconst DECISION: Record<HunkDecision, string> = { pending: 'not reviewed', accepted: 'accepted', rejected: 'rejected' };\n\n/*\n * Each section on its own, so a component's bundle keeps the sections it reads and no others.\n */\nexport const formatLabels: SignoffLabels['format'] = {\n  duration: formatDuration,\n  durationLong: formatDurationLong,\n  tokens: formatTokens,\n  cost: formatCost,\n  percent: (fraction) => `${Math.round(fraction * 100)}%`,\n};\n\nexport const commonLabels: SignoffLabels['common'] = {\n  copied: 'Copied',\n  copyThe: (what) => `Copy ${what.toLowerCase()}`,\n  showAllLines: (count) => `Show all ${count} lines`,\n  showLess: 'Show less',\n  opensInNewTab: '(opens in a new tab)',\n  modKey: (mac) => (mac ? '⌘' : 'Ctrl'),\n};\n\nexport const agentStatusLabels: SignoffLabels['agentStatus'] = {\n  states: {\n    idle: 'Idle',\n    thinking: 'Thinking',\n    working: 'Working',\n    'awaiting-approval': 'Waiting for approval',\n    done: 'Done',\n    stopped: 'Stopped',\n    error: 'Error',\n  },\n  spoken: (state, detail) => (detail ? `${state}: ${detail}` : state),\n  writingResponse: 'Writing response',\n};\n\nexport const toolCallTimelineLabels: SignoffLabels['toolCallTimeline'] = {\n  list: 'Tool calls',\n  phases: {\n    streaming: 'Preparing',\n    running: 'Running',\n    'awaiting-approval': 'Needs approval',\n    success: 'Done',\n    error: 'Failed',\n    denied: 'Denied',\n  },\n  stopped: 'Stopped',\n  finished: (name, duration) => `${name} finished in ${duration}`,\n  failed: (name, error) => `${name} failed: ${error ?? 'unknown error'}`,\n  blockedByPolicy: (name) => `${name} was blocked by policy`,\n  denied: (name) => `${name} was denied`,\n  input: 'Input',\n  inputStreaming: 'Input (streaming)',\n  output: 'Output',\n  outputPartial: 'Output (partial)',\n  error: 'Error',\n  deniedBy: (automatic) => (automatic ? 'Blocked by policy' : 'Denied by user'),\n  waitingForInput: 'Waiting for input…',\n  subagent: {\n    name: 'Sub-agent',\n    calls: (count) => `${count} ${count === 1 ? 'call' : 'calls'}`,\n    list: (name) => `${name}’s tool calls`,\n    paused: 'Paused',\n  },\n};\n\nexport const approvalCardLabels: SignoffLabels['approvalCard'] = {\n  required: 'Approval required',\n  risk: { low: 'Low risk', medium: 'Medium risk', high: 'High risk', critical: 'Critical' },\n  command: 'Command',\n  arguments: 'Arguments',\n  approve: 'Approve',\n  session: 'For this session',\n  always: 'Always',\n  deny: 'Deny',\n  alwaysDeny: 'Always deny',\n  sendDenial: 'Send denial',\n  confirm: 'Confirm approval',\n  denyWithFeedback: 'Deny with feedback',\n  reasonLabel: 'Tell the agent why (optional)',\n  reasonPlaceholder: 'What should the agent do instead?',\n  approveHint: 'approve',\n  keyboardHint: (offered, mod) =>\n    `Keyboard: press ${[\n      offered.approve && 'Y to approve',\n      offered.session && 'S to approve for this session',\n      offered.always && 'A to always approve',\n      offered.deny && 'N to deny',\n      offered.alwaysDeny && 'Shift N to always deny',\n    ]\n      .filter(Boolean)\n      .join(', ')}, or ${mod} Enter to approve.`,\n  summary: ({ risk, command, cwd, args, rule }) =>\n    [\n      risk && `${risk}.`,\n      command !== undefined && `Runs ${command}${cwd ? ` in ${cwd}` : ''}.`,\n      args.length > 0 &&\n        `${command !== undefined ? 'With' : 'Arguments:'} ${args.map((arg) => arg.join(' ')).join(', ')}.`,\n      rule && `A lasting decision covers ${rule}.`,\n    ]\n      .filter(Boolean)\n      .join(' '),\n  resolved: {\n    'allow-once': 'Approved',\n    'allow-session': 'Approved for this session',\n    'allow-always': 'Always approved',\n    'deny-once': 'Denied',\n    'deny-always': 'Always denied',\n  },\n  resolvedFor: (resolved, rule) => `${resolved}: ${rule}.`,\n  approved: 'Approved',\n  denied: 'Denied',\n  autoApproved: 'Auto-approved',\n  blockedByPolicy: 'Blocked by policy',\n  allowedByRule: 'Allowed by your rule',\n  deniedByRule: 'Denied by your rule',\n  describeRule: (rule) => {\n    const args = Object.entries(rule.args ?? {});\n    const tool = rule.tool === '*' ? 'any tool' : rule.tool.replace(/\\\\(.)/g, '$1');\n    return args.length === 0\n      ? `${tool}, any arguments`\n      : `${tool} with ${args.map(([name, pattern]) => `${name} ${pattern}`).join(', ')}`;\n  },\n  critical: 'Critical action. Press approve again to confirm.',\n  confirmCancelled: 'Confirmation cancelled.',\n  invalidJson: 'The arguments are not valid JSON.',\n  editArguments: 'Edit arguments',\n  doneEditing: 'Done editing',\n  undoEdits: 'Undo edits',\n  edited: 'Edited: approving runs the new arguments.',\n  argumentsJson: 'Arguments, as JSON',\n  notValidJson: (error) => `Not valid JSON: ${error}`,\n  ruleLegend: 'Calls a lasting decision covers',\n  rememberedFor: (any) => ({ before: 'Remembered for ', after: any ? ' with any arguments.' : ' calls where:' }),\n  argumentMatches: (name) => `${name} matches`,\n  anyArguments: 'Any arguments',\n  globHelp: '* matches any text but shell operators (; & | > < and backticks); ** matches anything.',\n  batch: {\n    group: 'Approvals waiting',\n    waiting: (count) => `${count} approvals are waiting.`,\n    approveAll: 'Approve all',\n    denyAll: 'Deny all',\n    confirm: 'Confirm approve all',\n    critical: 'One of them is critical. Press Approve all again to confirm.',\n    answered: (count, approved) => `${count} approvals ${approved ? 'approved' : 'denied'}.`,\n  },\n};\n\nexport const diffReviewLabels: SignoffLabels['diffReview'] = {\n  title: 'Review changes',\n  layout: 'Diff layout',\n  views: { unified: 'Unified', split: 'Split' },\n  files: (count) => `${count} ${plural(count, 'file')}`,\n  hunks: (count, comparing) => `${count} ${plural(count, 'hunk')}${comparing ? ' so far' : ''}`,\n  status: {\n    modified: { letter: 'M', name: 'Modified' },\n    added: { letter: 'A', name: 'Added' },\n    deleted: { letter: 'D', name: 'Deleted' },\n    renamed: { letter: 'R', name: 'Renamed' },\n  },\n  navigator: 'Files in this review',\n  navigatorState: (decided, total, viewed) => `, ${decided} of ${total} decided${viewed ? ', viewed' : ''}`,\n  comparingShort: 'comparing…',\n  renamedTo: 'to',\n  toggleFile: (collapsed, path) => `${collapsed ? 'Show' : 'Hide'} ${path}`,\n  viewed: 'Viewed',\n  rejectFile: 'Reject file',\n  acceptFile: 'Accept file',\n  comparing: 'Comparing changes…',\n  fallback: 'Too many changes to compare line by line: the changed lines are shown as one hunk that replaces them.',\n  noChanges: 'No textual changes.',\n  wholeFile: (status, binary, oldPath) =>\n    binary\n      ? 'Binary file, not shown.'\n      : status === 'renamed'\n        ? `Renamed from ${oldPath}, without changes.`\n        : status === 'deleted'\n          ? 'Empty file, deleted.'\n          : 'New empty file.',\n  accept: 'Accept',\n  reject: 'Reject',\n  itemName: (kind, n) => `${kind === 'hunk' ? 'hunk' : 'change'} ${n}`,\n  acceptItem: (item) => `Accept ${item}`,\n  rejectItem: (item) => `Reject ${item}`,\n  resetItem: (item) => `Reset ${item}`,\n  commentOn: (what) => `Comment on ${what}`,\n  badge: { accepted: 'accepted', rejected: 'rejected' },\n  hunk: (n, total, path, from, to, decision) =>\n    `Hunk ${n} of ${total}, ${path}, lines ${from} to ${to}, ${DECISION[decision]}`,\n  fileItem: (n, total, path, what, decision) => `Change ${n} of ${total}, ${path}, ${what}, ${DECISION[decision]}`,\n  describeFile: (status, binary, oldPath) =>\n    binary\n      ? 'binary file'\n      : status === 'renamed'\n        ? `renamed from ${oldPath}`\n        : status === 'deleted'\n          ? 'deleted empty file'\n          : 'new empty file',\n  hunkCode: (n, path) => `Hunk ${n} code, ${path}`,\n  added: 'Added: ',\n  removed: 'Removed: ',\n  decided: (kind, n, total, decision, remaining) =>\n    `${kind === 'hunk' ? 'Hunk' : 'Change'} ${n} of ${total} ${decision === 'pending' ? 'reset' : decision}. ${\n      remaining === 0 ? 'All hunks reviewed.' : `${remaining} remaining.`\n    }`,\n  decidedAll: (total, decision) => `All ${total} hunks ${decision}.`,\n  decidedFile: (count, path, decision) => `${count === 1 ? 'The hunk' : `All ${count} hunks`} in ${path} ${decision}.`,\n  viewedAnnouncement: (path, viewed, total) => `${path} viewed. ${viewed} of ${total} files viewed.`,\n  notViewedAnnouncement: (path) => `${path} no longer viewed.`,\n  lines,\n  selected: (line, range) => {\n    const text = lines(range);\n    return `${line}. ${text.charAt(0).toUpperCase()}${text.slice(1)} selected.`;\n  },\n  where: (comment) =>\n    comment.target === 'file'\n      ? 'the file'\n      : comment.target === 'hunk'\n        ? 'the hunk'\n        : lines({ side: comment.side ?? 'new', startLine: comment.startLine ?? 0, endLine: comment.endLine ?? 0 }),\n  commentHeading: (where) => ({ hidden: 'Comment ', visible: `On ${where}` }),\n  commentField: (where) => `Comment on ${where}, for the agent`,\n  commentPlaceholder: 'What should change here?',\n  editComment: (where) => `Edit comment on ${where}`,\n  deleteComment: (where) => `Delete comment on ${where}`,\n  edit: 'Edit',\n  delete: 'Delete',\n  cancel: 'Cancel',\n  saveComment: 'Save comment',\n  addComment: 'Comment',\n  commentAdded: (where, path) => `Comment added on ${where} of ${path}.`,\n  commentUpdated: 'Comment updated.',\n  commentDeleted: 'Comment deleted.',\n  unchangedLines: (count) => `${count} unchanged ${plural(count, 'line')}`,\n  moreAfter: (count, hunk) => ({\n    visible: `${count} more`,\n    hidden: ` unchanged ${plural(count, 'line')} after hunk ${hunk}`,\n  }),\n  moreBefore: (count, hunk) => ({\n    visible: `${count} more`,\n    hidden: ` unchanged ${plural(count, 'line')} before hunk ${hunk}`,\n  }),\n  showAll: (count) => ({ visible: 'Show all', hidden: ` ${count} unchanged ${plural(count, 'line')}` }),\n  expanded: (count) => `Showing ${count} more unchanged ${plural(count, 'line')}.`,\n  reviewed: 'reviewed',\n  filesViewed: (viewed, total) => `${viewed} of ${total} files viewed`,\n  comments: (count) => `${count} ${plural(count, 'comment')}`,\n  comparingFiles: 'comparing files…',\n  skipped: 'unreviewed hunks are skipped',\n  apply: (accepted, total) => (accepted > 0 ? `Apply ${accepted} of ${total}` : 'Apply changes'),\n  submitted: (accepted, total, comments) =>\n    `Review sent: ${accepted} of ${total} accepted${comments > 0 ? `, ${comments} ${plural(comments, 'comment')}` : ''}.`,\n  acceptAll: 'Accept all',\n  rejectAll: 'Reject all',\n  keyHints: { move: 'move', accept: 'accept', reject: 'reject', comment: 'comment', apply: 'apply' },\n  keyboardHelp: (mod) =>\n    `Keyboard: J or K to move between hunks, Shift J or Shift K between files, A to accept, R to reject, U to reset, Alt A or Alt R for the whole file, Shift A or Shift R for every hunk, Shift with the up or down arrow to select lines, C to comment on them or on the hunk, E to show more unchanged lines, V to mark the file viewed, ${mod} Enter to apply.`,\n};\n\nexport const markdownLabels: SignoffLabels['markdown'] = {\n  code: (language) => (language && language !== 'text' ? `Code, ${language}` : 'Code'),\n  codeBadge: 'code',\n  copyCode: 'Copy code',\n  table: 'Table',\n  image: 'Image:',\n  imageFallback: 'image',\n  citation: (n) => `Source ${n}`,\n  task: 'Task',\n};\n\nexport const reasoningLabels: SignoffLabels['reasoning'] = {\n  thinking: 'Thinking',\n  thoughtFor: (duration) => `Thought for ${duration}`,\n  reasoning: 'Reasoning',\n};\n\nexport const runMeterLabels: SignoffLabels['runMeter'] = {\n  title: 'Run',\n  metrics: (live) => `Run metrics${live ? ' (live)' : ''}`,\n  summary: ({ input, output, cost, ttft, total }) =>\n    [\n      `${input} input tokens`,\n      `${output} output tokens`,\n      cost !== undefined ? `estimated cost ${cost}` : undefined,\n      ttft !== undefined ? `time to first token ${ttft}` : undefined,\n      total !== undefined ? `total ${total}` : undefined,\n    ]\n      .filter(Boolean)\n      .join(', '),\n  inputTokens: 'Input tokens',\n  outputTokens: 'Output tokens',\n  estimatedCost: 'Estimated cost',\n  timeToFirstToken: 'Time to first token',\n  totalTime: 'Total time',\n  ttft: 'TTFT',\n  live: 'Live',\n  tokens: 'Tokens',\n  estCost: 'Est. cost',\n  breakdown: 'Token breakdown',\n  split: (input, output) => `Input ${input} · Output ${output}`,\n  input: 'Input',\n  output: 'Output',\n  cached: (n) => `(${n} cached)`,\n  reasoningTokens: (n) => `(${n} reasoning)`,\n  total: 'Total',\n  cacheHit: 'Cache hit',\n  costSplit: (input, output) => `${input} input · ${output} output`,\n  rates: (input, output) => `$${input}/$${output} per 1M`,\n};\n\nexport const approvalPolicyLabels: SignoffLabels['approvalPolicy'] = { ruleDenial: 'Denied by a rule' };\n\nexport const sourcesLabels: SignoffLabels['sources'] = { label: 'Sources', document: 'Document' };\n\nexport const agentMessageLabels: SignoffLabels['agentMessage'] = { attachedImage: 'Attached image' };\n\nexport const untrustedLabels: SignoffLabels['untrusted'] = {\n  invisible: (count, codes) =>\n    count === 1 ? `Invisible character ${codes[0]}` : `${count} invisible characters: ${codes.join(', ')}`,\n  blank: (count, lines) => (lines ? `${lines} line breaks` : `${count} blank characters`),\n  linksTo: (host) => `Links to ${host}`,\n};\n\n/** The English labels, as the components read without any. */\nexport const defaultLabels: SignoffLabels = {\n  format: formatLabels,\n  common: commonLabels,\n  agentStatus: agentStatusLabels,\n  toolCallTimeline: toolCallTimelineLabels,\n  approvalCard: approvalCardLabels,\n  diffReview: diffReviewLabels,\n  markdown: markdownLabels,\n  reasoning: reasoningLabels,\n  runMeter: runMeterLabels,\n  approvalPolicy: approvalPolicyLabels,\n  sources: sourcesLabels,\n  agentMessage: agentMessageLabels,\n  untrusted: untrustedLabels,\n};\n\n/** A part of the labels: any section, any key, at any depth. */\nexport type SignoffLabelsInput = {\n  [K in keyof SignoffLabels]?: DeepPartial<SignoffLabels[K]>;\n};\n\ntype DeepPartial<T> = T extends (...args: never[]) => unknown\n  ? T\n  : T extends object\n    ? { [K in keyof T]?: DeepPartial<T[K]> }\n    : T;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/** Labels with some replaced: plain objects merge key by key, strings and functions replace. */\nexport function mergeLabels<T extends SignoffLabelsInput>(\n  base: T,\n  ...overrides: (SignoffLabelsInput | undefined)[]\n): T {\n  const merge = (a: unknown, b: unknown): unknown => {\n    if (b === undefined) return a;\n    if (!isRecord(a) || !isRecord(b)) return b;\n    const out: Record<string, unknown> = { ...a };\n    for (const [key, value] of Object.entries(b)) out[key] = merge(a[key], value);\n    return out;\n  };\n  return overrides.reduce<T>((labels, next) => merge(labels, next) as T, base);\n}\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/labels.ts"
    },
    {
      "path": "packages/signoff-ui/src/lib/policy.ts",
      "content": "/**\n * Approval rules: what a person decided once, applied to the calls that follow. Pure, with no React,\n * so the same rules decide on the client (answering a request before anyone is asked) and on the\n * server (`toToolApproval`, for AI SDK 7's `toolApproval`).\n */\n\n/** What a person can decide about a tool call, and for how long it holds. */\nexport type ApprovalDecision = 'allow-once' | 'allow-session' | 'allow-always' | 'deny-once' | 'deny-always';\n\nexport const APPROVAL_DECISIONS: readonly ApprovalDecision[] = [\n  'allow-once',\n  'allow-session',\n  'allow-always',\n  'deny-once',\n  'deny-always',\n];\n\n/** A standing decision about a tool's calls: allowed or denied, for the session or always. */\nexport interface ApprovalRule {\n  /** Unique among the rules. */\n  id: string;\n  /**\n   * The tool's name, or a glob over names: `*` for every tool, `mcp_github_*` for a family. In a\n   * deny rule `*` and `?` match any character of a name; in an allow rule they stop at a shell\n   * operator, as in `args`.\n   */\n  tool: string;\n  /**\n   * Globs by argument name, which must all match: `{ command: 'npm test*' }`. A dotted name reads\n   * a nested argument (`'options.cwd'`), and a key of that name too. A deny rule's globs also match\n   * each command of a shell line (see `ruleMatches`). Absent: any arguments.\n   */\n  args?: Readonly<Record<string, string>> | undefined;\n  /** A test of your own on the input, on top of `args`. Code, so storage does not keep the rule. */\n  when?: ((input: unknown) => boolean) | undefined;\n  /** Whether the calls it covers run without asking, or are refused. A deny rule wins over an allow rule. */\n  effect: 'allow' | 'deny';\n  /** `session`: until the page reloads or the session is cleared. `always`: kept by the storage. */\n  scope: 'session' | 'always';\n  /** When it was made, in milliseconds since the epoch. */\n  createdAt?: number | undefined;\n  /** Why it was made, e.g. the reason a person gave when denying. */\n  reason?: string | undefined;\n}\n\n/** A tool call that needs a decision. */\nexport interface ApprovalRequest {\n  /**\n   * The id a response answers: AI SDK's `approval.id`, an AG-UI interrupt's id, or for ACP the\n   * tool call's id.\n   */\n  id: string;\n  /** The tool's name, which a rule's `tool` matches. */\n  toolName: string;\n  /** The call's arguments, which a rule's `args` and `when` match. */\n  input: unknown;\n  /** The tool call's own id, when the request has one apart from `id`, as AI SDK's approvals do. */\n  toolCallId?: string | undefined;\n}\n\n/** The rule that decides a call. */\nexport interface RuleMatch {\n  effect: 'allow' | 'deny';\n  rule: ApprovalRule;\n  /**\n   * The rule is a deny rule that ran out of steps before it could tell whether it covers the call,\n   * the arguments being too long for its patterns, and no other deny rule covers it: the call is\n   * denied, and the rule's own `reason` doesn't apply.\n   */\n  unchecked?: boolean | undefined;\n}\n\n/**\n * Characters a single `*` or `?` never matches: what chains, pipes, substitutes or redirects a\n * shell command. So `npm test*` allows `npm test -- --watch` but not `npm test && rm -rf ~`.\n */\nconst SHELL_CONTROL = ';&|`<>\\r\\n';\n\nfunction escapeRegExp(text: string) {\n  return text.replace(/[.*+?^${}()|[\\]\\\\/]/g, '\\\\$&');\n}\n\n/* A glob's parts: a character, as its code, or one of these. */\nconst ONE = -1; // ?\nconst STAR = -2; // *\nconst ANY = -3; // ** (or more)\nconst END = 0x10000; // past the last part, in `globMatch`: no character's code\n\n/** A pattern in parts: `\\` and the character it makes literal, a run of `*`, or one character. */\nconst globParts = (pattern: string) =>\n  (pattern.match(/\\\\[\\s\\S]|\\*+|[\\s\\S]/g) ?? []).map((part) =>\n    part[0] === '\\\\' && part[1]\n      ? part.charCodeAt(1)\n      : part[1]\n        ? ANY\n        : part === '*'\n          ? STAR\n          : part === '?'\n            ? ONE\n            : part.charCodeAt(0),\n  );\n\n/**\n * A glob as a regular expression over the whole value:\n * - `*` matches any run of characters but shell control characters (`;`, `&`, `|`, `` ` ``, `<`,\n *   `>`, line breaks) and `$(`;\n * - `?` matches one such character;\n * - `**` matches any run of characters at all;\n * - `\\` makes the next character literal; everything else is literal.\n *\n * The expression backtracks: with a few `*` and a long value it doesn't match, a test can take\n * seconds. `matchesGlob` gives the same answers without backtracking.\n */\nexport function globToRegExp(pattern: string): RegExp {\n  const safe = `(?:(?!\\\\$\\\\()[^${escapeRegExp(SHELL_CONTROL)}])`;\n  const source = globParts(pattern).map((part) =>\n    part === ANY\n      ? '[\\\\s\\\\S]*'\n      : part === STAR\n        ? `${safe}*`\n        : part === ONE\n          ? safe\n          : escapeRegExp(String.fromCharCode(part)),\n  );\n  return new RegExp(`^${source.join('')}$`);\n}\n\n/**\n * Matching work a rule has left for a call, in steps. Each character it reads costs the places in\n * the pattern that match so far, plus one, and earns `STEPS_PER_CHARACTER`. An empty value, such as\n * an array's item, counts as one character.\n */\ninterface Budget {\n  left: number;\n}\n\n/**\n * The steps a rule starts with, for the tool's name and again for its arguments: enough for any\n * pattern on a short argument. Each character it reads earns it `STEPS_PER_CHARACTER` more, several\n * times what a common pattern takes, so a rule such as `**PRIVATE KEY**` never runs out, however\n * long the argument. A pattern that takes more for each character, such as 500 characters of `a`\n * against an argument of `a`s, stops after a few hundred: each rule's work grows with what it reads,\n * and no more.\n */\nconst RULE_STEPS = 20_000;\nconst STEPS_PER_CHARACTER = 30;\n\n/** A value to match, and where in it a match may start, ascending. */\ntype Candidate = readonly [value: string, starts: readonly number[]];\n\nconst FROM_START: readonly number[] = [0];\n\n/**\n * Whether a glob's parts match one of the values from one of its starts to its end, or `undefined`\n * once `budget` runs out. It reads each value once, keeping the places in the pattern that match so\n * far, each once, so its time grows with the values' length times the pattern's, and no more. With\n * `loose`, `*` and `?` match any character, as they do in a deny rule's tool pattern.\n */\nfunction globMatch(\n  values: readonly Candidate[],\n  parts: readonly number[],\n  loose: boolean,\n  budget: Budget,\n): boolean | undefined {\n  const end = parts.length;\n  // The parts, and past the last one a part no character matches: the loops never read past them.\n  const pattern = Int32Array.from([...parts, END]);\n  // Whether a single `*` or `?` must stop at a shell operator: none in the pattern, nothing to check.\n  const narrow = !loose && parts.some((part) => part === STAR || part === ONE);\n  // The places in the pattern that match so far, `count` of them, and those after the next character.\n  let places = new Int32Array(end + 1);\n  let next = new Int32Array(end + 1);\n  // The step at which each place was last reached, so a place joins a step's list once. Steps count\n  // on from one value to the next, so no mark carries over.\n  const seen = new Int32Array(end + 1).fill(-1);\n  let step = 0;\n  for (const [value, starts] of values) {\n    let count = 0;\n    for (let i = 0, s = 0; ; i++, step++) {\n      if (s < starts.length && starts[s] === i && seen[0] !== step) {\n        seen[0] = step;\n        places[count++] = 0;\n      }\n      while (s < starts.length && starts[s]! <= i) s++;\n      // A `*` or `**` can match nothing, so the place after it is reached too (the loop visits what it adds).\n      for (let k = 0; k < count; k++) {\n        const after = places[k]! + 1;\n        if (pattern[after - 1]! < ONE && seen[after] !== step) {\n          seen[after] = step;\n          places[count++] = after;\n        }\n      }\n      if (i === value.length) {\n        if (seen[end] === step) return true;\n        // An empty value reads no character, and counts as one: so the steps grow with the values read.\n        if (!i && (budget.left += STEPS_PER_CHARACTER - count - 1) < 0) return undefined;\n        break;\n      }\n      if (!count && s === starts.length) break;\n      if ((budget.left += STEPS_PER_CHARACTER - count - 1) < 0) return undefined;\n      const code = value.charCodeAt(i);\n      // What a single `*` or `?` may match: no shell control character, and no `$` that starts `$(`.\n      const safe = !narrow || (!SHELL_CONTROL.includes(value[i]!) && !(code === 36 && value.charCodeAt(i + 1) === 40));\n      let reached = 0;\n      for (let k = 0; k < count; k++) {\n        const place = places[k]!;\n        const part = pattern[place]!;\n        const to =\n          part === ANY || (part === STAR && safe) ? place : part === code || (part === ONE && safe) ? place + 1 : -1;\n        if (to >= 0 && seen[to] !== step + 1) {\n          seen[to] = step + 1;\n          next[reached++] = to;\n        }\n      }\n      const read = places;\n      places = next;\n      next = read;\n      count = reached;\n    }\n    step++;\n  }\n  return false;\n}\n\n/**\n * Whether a whole value matches a glob (see `globToRegExp`). It reads the value once, keeping the\n * places in the pattern that match so far, so its time grows with the value's length times the\n * pattern's, and no more: a long argument written by a model can't hold up the server or the page.\n */\nexport function matchesGlob(value: string, pattern: string): boolean {\n  return globMatch([[value, FROM_START]], globParts(pattern), false, { left: Infinity }) === true;\n}\n\n/** Where a shell line splits into commands, inside quotes too: its operators, `$(`, and a subshell's parentheses. */\nconst COMMAND_BREAK = ';&|`\\r\\n()';\n/** Space between words; line breaks are in `COMMAND_BREAK`. */\nconst SPACE = /\\s/;\n/** A stretch of a line with nothing in it for `pieces` to do: no space, quote, `\\`, redirect or break. */\nconst PLAIN = /[^\\s\"'\\\\<>;&|`()]+/y;\n/** Words that run the next one, past options of their own: `nohup git push`, `if git push; then`. */\nconst RUNS_NEXT = /^(?:[!{]|if|then|else|elif|do|while|until|time|command|exec|builtin|nohup)$/;\n/** Programs that run a command among their arguments: `sudo -u root git push`, `sh -c \"git push\"`. */\nconst RUNS_LATER = /^(?:sudo|doas|env|nice|xargs|timeout|watch|eval|(?:ba|da|k|z)?sh)$/;\n/** `find`'s options that run the words after them: `find . -exec rm {} \\;`. */\nconst RUNS_AFTER = /^-(?:exec|execdir|ok|okdir)$/;\n\n/** A command of a shell line: its words, each as its runs of non-space characters. */\ninterface Piece {\n  words: string[][];\n  /** It starts inside a quote, so its first word began in the piece before. */\n  continued: boolean;\n}\n\n/**\n * A shell line in pieces, split at each character of `COMMAND_BREAK`, inside quotes too, and inside\n * quotes at `<` and `>` as well, since a quoted line may be one a shell runs (`sh -c \"git push 2>&1\"`).\n * Each piece holds its words as a shell splits them, quotes and `\\` taken off. Outside quotes, a\n * redirect goes with the word it names (`>out`, `2>/dev/null`, `>&2`, `<<'EOF'`), so the words on\n * either side of it are one command, as a shell runs them, and a `\\` before a line break joins the\n * lines. It reads the line once.\n */\nfunction pieces(line: string): Piece[] {\n  const out: Piece[] = [];\n  let words: string[][] = [];\n  // The word being read, as its runs so far, and the run being read.\n  let word: string[] | undefined;\n  let run = '';\n  // The quote the line is in, a quote inside it, and whether the word being read is the one a\n  // redirect names.\n  let quote = '';\n  let inner = '';\n  let target = false;\n  let continued = false;\n  const endRun = () => {\n    if (run) (word ??= []).push(run);\n    run = '';\n  };\n  const endWord = () => {\n    endRun();\n    if (word?.length && !target) words.push(word);\n    word = undefined;\n    target = false;\n  };\n  const endPiece = () => {\n    endWord();\n    out.push({ words, continued });\n    words = [];\n    inner = '';\n    continued = quote !== '';\n    if (continued) word = [];\n  };\n  // A plain stretch from `i`, added to the run at once, and where it ends.\n  const plain = (i: number) => {\n    PLAIN.lastIndex = i;\n    PLAIN.test(line);\n    run += line.slice(i, PLAIN.lastIndex);\n    return PLAIN.lastIndex - 1;\n  };\n  for (let i = 0; i < line.length; i++) {\n    const c = line[i]!;\n    const next = line[i + 1];\n    if (c === '\\\\' && quote !== \"'\") {\n      // Before a line break, `\\` joins the lines. Before a break, it leaves the break to split the\n      // line, as a quote does. In double quotes, `\\\"` is a quote to the shell the line is given to.\n      // Any other character it makes literal.\n      if (next === '\\n') i++;\n      else if (quote && next === '\"') {\n        inner = inner ? '' : next;\n        i++;\n      } else if (next !== undefined && !COMMAND_BREAK.includes(next) && !(quote && (next === '<' || next === '>'))) {\n        run += next;\n        i++;\n      }\n    } else if (quote) {\n      // A quoted line may be one a shell runs, which reads its quotes in turn: `inner`, the other\n      // quote, keeps its spaces in the run, from where it opens in the piece.\n      if (c === quote) quote = inner = '';\n      else if (c === '\"' || c === \"'\") inner = inner ? '' : c;\n      else if (COMMAND_BREAK.includes(c) || c === '<' || c === '>') endPiece();\n      else if (SPACE.test(c)) {\n        if (inner) run += c;\n        else endRun();\n      } else if (c === '\\\\') run += c;\n      else i = plain(i);\n    } else if (c === '\"' || c === \"'\") {\n      quote = c;\n      word ??= [];\n    } else if (COMMAND_BREAK.includes(c) || ((c === '<' || c === '>') && next === '(')) {\n      // `<(` and `>(` run a command of their own: the next piece.\n      endPiece();\n    } else if (c === '<' || c === '>') {\n      // A redirect. A number written against it is the descriptor it redirects, not a word.\n      if (!word && /^\\d+$/.test(run)) run = '';\n      endWord();\n      // `>>`, `<>`, `>&`, `<&`, `>|`, then `<<`, `<<<` and `<<-`.\n      if (next === '&' || next === '>' || (c === '>' && next === '|')) i++;\n      else if (c === '<' && next === '<') {\n        i++;\n        if (line[i + 1] === '<' || line[i + 1] === '-') i++;\n      }\n      while (line[i + 1] === ' ' || line[i + 1] === '\\t') i++;\n      target = true;\n    } else if (SPACE.test(c)) endWord();\n    else i = plain(i);\n  }\n  endPiece();\n  return out;\n}\n\n/**\n * Each command of a shell line (`pieces`), as its words joined by one space, with where in it the\n * command may start: its first word past `NAME=value` settings, that word without its path\n * (`/usr/bin/git` as `git`), the word after one in `RUNS_NEXT` or `RUNS_AFTER`, and every word after\n * one in `RUNS_LATER`. A quoted word a command may start at is a line a shell may run, read the same\n * way (`sh -c \"FOO=1 git push\"`), and so is the first word of a piece that starts inside a quote,\n * where the words after it may start a command too (`FOO=\"a;b\" git push`).\n */\nfunction commands(line: string): Candidate[] {\n  return pieces(line).map(({ words, continued }) => {\n    const runs = words.flat();\n    // Each run's offset in the runs joined by spaces, and each word's first run.\n    const at: number[] = [];\n    for (let k = 0, offset = 0; k < runs.length; offset += runs[k++]!.length + 1) at.push(offset);\n    const first: number[] = [];\n    for (let k = 0, run = 0; k < words.length; run += words[k++]!.length) first.push(run);\n    const texts = words.map((word) => word.join(' '));\n    const starts: number[] = [];\n    /**\n     * Where a command may start among items `k` to `end` (words, or a quoted word's runs), in one\n     * pass: the offset of each, and past its path, the program as a shell finds it.\n     */\n    const read = (\n      items: readonly string[],\n      offset: (k: number) => number,\n      nest: (k: number) => void,\n      k: number,\n      end: number,\n    ) => {\n      // Looking for the command, among its arguments, or past a program that runs any of them.\n      let state: 'command' | 'arguments' | 'any' = 'command';\n      let options = false;\n      for (; k < end; k++) {\n        const item = items[k]!;\n        if (state === 'arguments') {\n          if (RUNS_AFTER.test(item)) {\n            state = 'command';\n            options = false;\n          }\n          continue;\n        }\n        if (state === 'command' && (/^[A-Za-z_]\\w*=/.test(item) || (options && item.startsWith('-')))) continue;\n        const path = item.lastIndexOf('/') + 1;\n        starts.push(offset(k), offset(k) + path);\n        nest(k);\n        if (state === 'any') continue;\n        const name = item.slice(path);\n        if (RUNS_LATER.test(name)) state = 'any';\n        else if (RUNS_NEXT.test(name)) options = true;\n        else state = 'arguments';\n      }\n    };\n    const none = () => {};\n    const inRuns = (k: number) => read(runs, (j) => at[j]!, none, first[k]!, first[k]! + words[k]!.length);\n    const nest = (j: number) => {\n      if (words[j]!.length > 1) inRuns(j);\n    };\n    const inWords = (k: number) => read(texts, (j) => at[first[j]!]!, nest, k, words.length);\n    if (continued && words.length) {\n      inRuns(0);\n      inWords(1);\n    } else inWords(0);\n    return [runs.join(' '), starts.sort((a, b) => a - b)] as const;\n  });\n}\n\n/**\n * A text's commands (`commands`), less the matches its whole already tried: from the start of a\n * command that is the whole text, as `a`s or `npm test` are.\n */\nfunction commandsOf(text: string): Candidate[] {\n  const list: Candidate[] = [];\n  for (const [command, starts] of commands(text)) {\n    const from = command === text ? starts.filter((start) => start > 0) : starts;\n    if (from.length) list.push([command, from]);\n  }\n  return list;\n}\n\n/**\n * What a deny rule matches of some texts: each whole from its start, and then each of their\n * commands, split the first time a rule needs them.\n */\ninterface Reading {\n  whole: Candidate[];\n  commands?: Candidate[] | undefined;\n}\n\n/** Each argument as deny rules read it (`readingsOf`), worked out once for all the rules of a call. */\ntype Readings = Map<unknown, Reading[] | undefined>;\n\n/** Some texts as a deny rule reads them, each text once however often it comes. */\nconst reading = (texts: readonly string[]): Reading => ({\n  whole: [...new Set(texts)].map((text) => [text, FROM_START] as const),\n});\n\n/**\n * What a deny rule reads of an argument: a text, or an array's items and then the items joined by\n * spaces; `undefined` for one it can't read: an object, or an array with an item that isn't text.\n * Worked out once for all the rules of a call, in `readings`.\n */\nfunction readingsOf(value: unknown, readings: Readings): Reading[] | undefined {\n  if (readings.has(value)) return readings.get(value);\n  const text = argumentText(value);\n  const items = text === undefined && Array.isArray(value) ? value.map(argumentText) : [text];\n  const read = items.includes(undefined)\n    ? undefined\n    : text === undefined\n      ? [reading(items as string[]), reading([items.join(' ')])]\n      : [reading([text])];\n  readings.set(value, read);\n  return read;\n}\n\n/**\n * Whether a deny rule's pattern covers one of a reading's texts: the whole of it, as an allow rule\n * reads it, or any of its commands from where one may start (`commands`), so `git push*` denies\n * `git status && git push`. All the texts go in one pass each way, so an array's items cost what\n * their characters do, not the pattern's length each.\n */\nfunction denyMatch(texts: Reading, parts: readonly number[], budget: Budget): boolean | undefined {\n  const whole = globMatch(texts.whole, parts, false, budget);\n  if (whole !== false) return whole;\n  texts.commands ??= texts.whole.flatMap(([text]) => commandsOf(text));\n  return globMatch(texts.commands, parts, false, budget);\n}\n\nconst own = (value: object, key: string) => Object.prototype.hasOwnProperty.call(value, key);\n\n/**\n * An argument by name, as each reading of it present: the key itself, and for a dotted name the\n * nested argument too (`'options.cwd'`), since a call may carry both.\n */\nfunction argumentValues(input: unknown, name: string): unknown[] {\n  if (input === null || typeof input !== 'object') return [];\n  const values = own(input, name) ? [(input as Record<string, unknown>)[name]] : [];\n  if (!name.includes('.')) return values;\n  let value: unknown = input;\n  for (const key of name.split('.')) {\n    if (value === null || typeof value !== 'object' || !own(value, key)) return values;\n    value = (value as Record<string, unknown>)[key];\n  }\n  return [...values, value];\n}\n\n/** A string, number or boolean argument as text; anything else matches no allow pattern. */\nfunction argumentText(value: unknown): string | undefined {\n  if (typeof value === 'string') return value;\n  if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') return String(value);\n  return undefined;\n}\n\n/**\n * Whether an argument matches a pattern, or `undefined` once `budget` runs out: as text for an allow\n * rule. A deny rule reads a text's commands too, an array by its items, all in one pass, and by the\n * items joined with spaces (`readingsOf`), and covers any other object, which it can't read: it\n * fails closed.\n */\nfunction argumentMatches(\n  value: unknown,\n  parts: readonly number[],\n  deny: boolean,\n  budget: Budget,\n  readings: Readings,\n): boolean | undefined {\n  if (!deny) {\n    const text = argumentText(value);\n    return text !== undefined && globMatch([[text, FROM_START]], parts, false, budget);\n  }\n  if (value == null) return false;\n  const read = readingsOf(value, readings);\n  if (!read) return true;\n  let result: boolean | undefined = false;\n  for (const texts of read) {\n    const matched = denyMatch(texts, parts, budget);\n    if (matched) return true;\n    if (matched === undefined) result = undefined;\n  }\n  return result;\n}\n\n/**\n * Whether a rule covers a call: `true`, `false`, or `undefined` when it ran out of steps before it\n * could tell. The tool's name is read first, on steps of its own, which a name of usual length never\n * runs out of: a rule on another tool doesn't count against the call. A deny rule counts what it\n * can't read as covered: an object argument, or a `when` that throws.\n */\nfunction covers(rule: ApprovalRule, toolName: string, input: unknown, readings: Readings): boolean | undefined {\n  const deny = rule.effect !== 'allow';\n  // A tool's name is no shell command: in a deny rule, `*` and `?` match any character of it, so `*`\n  // covers every tool. An allow rule's tool pattern reads a name as its argument patterns read text.\n  const tool = globMatch([[toolName, FROM_START]], globParts(rule.tool), deny, { left: RULE_STEPS });\n  if (tool !== true) return tool;\n  const budget: Budget = { left: RULE_STEPS };\n  let result: boolean | undefined = true;\n  for (const [name, pattern] of Object.entries(rule.args ?? {})) {\n    const parts = globParts(pattern);\n    // Each reading of the argument must match for an allow rule; one does for a deny rule.\n    let matched: boolean | undefined = false;\n    for (const value of argumentValues(input, name)) {\n      const one = argumentMatches(value, parts, deny, budget, readings);\n      if (!deny && one !== true) return one;\n      if (one !== false) matched = one;\n      if (deny && one) break;\n    }\n    if (matched === false) return false;\n    if (matched === undefined) result = undefined;\n  }\n  if (rule.when) {\n    let test: boolean;\n    try {\n      test = !!rule.when(input);\n    } catch {\n      test = deny;\n    }\n    if (!test) return false;\n  }\n  return result;\n}\n\n/**\n * Whether a rule applies to a call: its tool, every argument pattern, and its own test. A deny rule\n * reads more than an allow rule, to hold when a command is written another way: each command of a\n * shell line, from its first word past `NAME=value` settings, a path and a redirect, or after `sudo`,\n * `env`, `sh -c`, `find -exec`… (see `commands`); an array by its items; and an object, or a `when`\n * that throws, as covered. Matching takes a bounded amount of work (see `evaluateRules`), and what\n * it can't finish counts against the call: an allow rule doesn't apply, a deny rule does.\n */\nexport function ruleMatches(rule: ApprovalRule, toolName: string, input: unknown): boolean {\n  return covers(rule, toolName, input, new Map()) ?? rule.effect !== 'allow';\n}\n\n/** How narrow a rule is, to report the most specific of several that match. */\nconst specificity = (rule: ApprovalRule) =>\n  (rule.tool.includes('*') || rule.tool.includes('?') ? 0 : 100) +\n  Object.keys(rule.args ?? {}).length * 10 +\n  (rule.when ? 5 : 0);\n\n/**\n * The rule that decides a call, if any. A deny rule wins over an allow rule, whatever their\n * order; among rules of the same effect the most specific is the one reported. Each rule's matching\n * takes a bounded amount of work, in proportion to the arguments it reads, an array's item counting\n * as one character at least: far more than common patterns need, however long the arguments. The\n * bound is each rule's, so a call's work grows with the number of rules times the arguments' length,\n * and a deny rule reads a string up to twice (whole, then by command) and an array up to four times\n * (all its items in one pass, each once however often it comes, then the items joined, each both\n * ways): cap the arguments where a client sends rules. A rule that runs out before it can tell\n * counts against the call: an allow rule allows nothing, and a deny rule denies, reported as\n * `unchecked` when no other deny rule covers the call.\n */\nexport function evaluateRules(rules: readonly ApprovalRule[], toolName: string, input: unknown): RuleMatch | undefined {\n  // Each argument as deny rules read it, worked out once for all the rules.\n  const readings: Readings = new Map();\n  let best: ApprovalRule | undefined;\n  let unchecked: ApprovalRule | undefined;\n  // Deny rules first: one that covers the call wins, and then no allow rule is read. A rule that\n  // can't beat the best so far by specificity isn't read either.\n  for (const rule of rules) {\n    if (rule.effect === 'allow' || (best && specificity(rule) <= specificity(best))) continue;\n    const covered = covers(rule, toolName, input, readings);\n    if (covered) best = rule;\n    else if (covered === undefined && (!unchecked || specificity(rule) > specificity(unchecked))) unchecked = rule;\n  }\n  if (best) return { effect: 'deny', rule: best };\n  if (unchecked) return { effect: 'deny', rule: unchecked, unchecked: true };\n  for (const rule of rules) {\n    if (rule.effect !== 'allow' || (best && specificity(rule) <= specificity(best))) continue;\n    if (covers(rule, toolName, input, readings) === true) best = rule;\n  }\n  return best && { effect: 'allow', rule: best };\n}\n\n/** What a decision does now, and the rule it leaves, if any. */\nexport function decisionEffect(decision: ApprovalDecision): {\n  approved: boolean;\n  scope: 'once' | 'session' | 'always';\n} {\n  const approved = decision.startsWith('allow');\n  const scope = decision.endsWith('session') ? 'session' : decision.endsWith('always') ? 'always' : 'once';\n  return { approved, scope };\n}\n\n/** Program and subcommand words of a shell command, before the first option or operator. */\nfunction commandPrefix(command: string) {\n  const words: string[] = [];\n  for (const word of command.trim().split(/\\s+/)) {\n    if (!word || word.startsWith('-') || /[;&|`<>$'\"\\\\*?]/.test(word) || words.length === 2) break;\n    words.push(word);\n  }\n  return words;\n}\n\n/**\n * Programs that run what their arguments say, by name or path: shells, interpreters, `npx`, and\n * commands that run or fetch another. Their program-and-next-word pattern would cover any code:\n * `sudo rm*` allows `sudo rm -rf /`, and `npx prettier*` allows `npx prettier-evil`.\n */\nconst RUNS_ARGUMENTS = /^(?:.*\\/)?(?:(?:ba|z)?sh|node|python[\\d.]*|sudo|env|npx|xargs|curl|wget)$/;\n\n/**\n * The argument patterns a rule made from this call would start with: for a shell command, its\n * program and subcommand (`npm test*`), or the whole command when it has no subcommand or runs what\n * its arguments say (`rm -rf build`, `node -e \"…\"`), since `rm*` would allow `rm -rf ~`; otherwise\n * each string, number and boolean argument as it is. Globs are escaped. The person can widen them\n * before saving.\n */\nexport function suggestArgs(input: unknown): Record<string, string> | undefined {\n  if (input === null || typeof input !== 'object' || Array.isArray(input)) return undefined;\n  const record = input as Record<string, unknown>;\n  if (typeof record.command === 'string') {\n    // The prefix's words have no glob characters to escape.\n    const words = commandPrefix(record.command);\n    return {\n      command:\n        words[1] && !words.some((word) => RUNS_ARGUMENTS.test(word))\n          ? `${words.join(' ')}*`\n          : record.command.replace(/[\\\\*?]/g, '\\\\$&'),\n    };\n  }\n  const out: Record<string, string> = {};\n  for (const [name, value] of Object.entries(record)) {\n    const text = argumentText(value);\n    if (text !== undefined) out[name] = text.replace(/[\\\\*?]/g, '\\\\$&');\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\nlet ruleIds = 0;\n\n/**\n * The rule a decision leaves: none for `allow-once` and `deny-once`. `args` narrows it to some\n * arguments; without it, it covers every call of the tool.\n */\nexport function ruleFromDecision(\n  decision: ApprovalDecision,\n  request: Pick<ApprovalRequest, 'toolName'>,\n  {\n    args,\n    reason,\n    id,\n    now,\n  }: { args?: Record<string, string> | undefined; reason?: string; id?: string; now?: number } = {},\n): ApprovalRule | undefined {\n  const { approved, scope } = decisionEffect(decision);\n  if (scope === 'once') return undefined;\n  return {\n    id: id ?? `rule-${Date.now().toString(36)}-${++ruleIds}`,\n    tool: request.toolName.replace(/[\\\\*?]/g, '\\\\$&'),\n    ...(args && Object.keys(args).length > 0 ? { args: { ...args } } : {}),\n    effect: approved ? 'allow' : 'deny',\n    scope: scope === 'session' ? 'session' : 'always',\n    createdAt: now ?? Date.now(),\n    ...(reason ? { reason } : {}),\n  };\n}\n\n/** A rule in words: \"run_command with command npm test*\". */\nexport function describeRule(rule: Pick<ApprovalRule, 'tool' | 'args'>): string {\n  const args = Object.entries(rule.args ?? {});\n  const tool = rule.tool === '*' ? 'any tool' : rule.tool.replace(/\\\\(.)/g, '$1');\n  return args.length === 0 ? `${tool}, any arguments` : `${tool} with ${args.map(([k, v]) => `${k} ${v}`).join(', ')}`;\n}\n\n/* AI SDK 7: the same rules on the server, for `streamText({ toolApproval })`. */\n\n/** AI SDK 7's `ToolApprovalStatus`, as `toToolApproval` returns it. */\nexport type ToolApprovalStatusLike =\n  | 'not-applicable'\n  | 'approved'\n  | 'denied'\n  | 'user-approval'\n  | { type: 'approved' | 'denied' | 'user-approval'; reason?: string };\n\n/** How `toToolApproval` answers: for the calls no rule covers, and in the reason a rule gives. */\nexport interface ToToolApprovalOptions {\n  /**\n   * What a call no rule covers gets. Default `'user-approval'`: a person decides.\n   * `'not-applicable'` leaves the call to another `toolApproval`, such as a second set of rules.\n   */\n  otherwise?: ToolApprovalStatusLike | undefined;\n  /**\n   * The reason for a call a rule decides, which the approval keeps as `approval.reason`: say whose\n   * rules these are, so a page can tell the server's from the person's. Default: \"Allowed by a\n   * rule: …\" or \"Denied by a rule: …\", the rule in words (`describeRule`), then its own reason; for\n   * an `unchecked` match, \"Denied: the arguments are too long to check against a rule: …\".\n   */\n  reason?: ((match: RuleMatch) => string) | undefined;\n}\n\n/**\n * The reason `toToolApproval` gives unless told otherwise: \"Denied by a rule: rm * (No deletes)\", or\n * for an `unchecked` rule \"Denied: the arguments are too long to check against a rule: …\".\n */\nfunction ruleReason({ effect, rule, unchecked }: RuleMatch) {\n  if (unchecked) return `Denied: the arguments are too long to check against a rule: ${describeRule(rule)}`;\n  return `${effect === 'allow' ? 'Allowed' : 'Denied'} by a rule: ${describeRule(rule)}${\n    rule.reason ? ` (${rule.reason})` : ''\n  }`;\n}\n\n/**\n * Rules as AI SDK 7's generic `toolApproval` function: a matching rule approves or denies the call\n * on the server, with the rule in the reason (`reason` words it), and any other call gets\n * `otherwise` (by default `'user-approval'`, a person decides). The SDK checks it again on the\n * approved call before it runs, edited arguments included.\n *\n * Rules a client sends are the choices of the person using it: take them for that person's own\n * runs only, and keep rules that protect others on the server.\n */\nexport function toToolApproval(\n  rules: readonly ApprovalRule[] | (() => readonly ApprovalRule[]),\n  { otherwise = 'user-approval', reason = ruleReason }: ToToolApprovalOptions = {},\n): (options: { toolCall: { toolName: string; input: unknown } }) => ToolApprovalStatusLike {\n  return ({ toolCall }) => {\n    const match = evaluateRules(typeof rules === 'function' ? rules() : rules, toolCall.toolName, toolCall.input);\n    if (!match) return otherwise;\n    return { type: match.effect === 'allow' ? 'approved' : 'denied', reason: reason(match) };\n  };\n}\n\n/** A decision as the response `addToolApprovalResponse` (from `useChat`) takes. */\nexport function toToolApprovalResponse(\n  id: string,\n  decision: ApprovalDecision,\n  reason?: string,\n): { id: string; approved: boolean; reason?: string } {\n  const { approved } = decisionEffect(decision);\n  return reason ? { id, approved, reason } : { id, approved };\n}\n\n/**\n * Messages with one tool call's input replaced, for approving edited arguments with AI SDK 7: set\n * them with `setMessages` (from `useChat`), then answer the approval. The server runs the call with the\n * input in the messages, after checking it against the tool's schema and `toolApproval` again.\n * When the tool's schema changed what the model sent (a default filled in, a value coerced, a key\n * dropped), the approval keeps what the model sent as `inputSchemaInput`, and the server checks the\n * call against it, so it gets the edit too. The server runs only an edit that comes out of the\n * schema unchanged, and out of `experimental_refineToolInput` too when that is set: keep the fields\n * the schema fills in (the card starts an edit from the input it shows, defaults included), and use\n * transforms that give the same result when run twice.\n * With `experimental_toolApprovalSecret` set, the server signs the input it asked about and refuses\n * any other, so edits fail there by design.\n */\nexport function setToolInput<M extends { parts: readonly unknown[] }>(\n  messages: readonly M[],\n  toolCallId: string,\n  input: unknown,\n): M[] {\n  return messages.map((message) => {\n    const index = message.parts.findIndex(\n      (part) =>\n        typeof part === 'object' &&\n        part !== null &&\n        (part as { toolCallId?: unknown }).toolCallId === toolCallId &&\n        'input' in part,\n    );\n    if (index === -1) return message;\n    const parts = [...message.parts];\n    const part = parts[index] as { approval?: unknown };\n    const { approval } = part;\n    parts[index] =\n      typeof approval === 'object' && approval !== null && 'inputSchemaInput' in approval\n        ? { ...part, input, approval: { ...approval, inputSchemaInput: input } }\n        : { ...part, input };\n    return { ...message, parts };\n  });\n}\n\n/* A person's rules with each request: plain data from the page, checked again on the server. */\n\n/**\n * A tool pattern's literal start, and its literal end backwards: what comes before its first\n * wildcard, and after its last. A `\\` escape counts as a wildcard too, which can only make the\n * pattern seem to match more. Each has a `\\uffff` where the pattern starts or ends, so one with no\n * wildcard can't meet a pattern that needs more characters than it has.\n */\nfunction ends(tool: string): string[] {\n  const runs = `\\uffff${tool}\\uffff`.split(/\\\\[\\s\\S]|[*?]/);\n  return [runs[0]!, runs.at(-1)!.split('').reverse().join('')];\n}\n\n/**\n * Whether two tool patterns, as `ends`, could match one name: of their literal starts one starts\n * the other, and so it is with their ends. It can say yes for two that never meet, never no for\n * two that do.\n */\nconst mayOverlap = (x: string[], y: string[]) =>\n  x.every((end, i) => end.slice(0, y[i]!.length) === y[i]!.slice(0, end.length));\n\n/**\n * The rules less the allow rules that left-out deny rules would overrule: those on a tool one of\n * them could name. The calls they cover then go to the page, which has every rule.\n */\nfunction withoutOverruled(rules: ApprovalRule[], leftOut: string[]): ApprovalRule[] {\n  // Each pattern's ends once: a pair then costs only the two compares in `mayOverlap`.\n  const denied = leftOut.map(ends);\n  return rules.filter((rule) => {\n    const tool = rule.effect === 'allow' && ends(rule.tool);\n    return !tool || !denied.some((other) => mayOverlap(tool, other));\n  });\n}\n\n/**\n * Rules as plain data, to send with a request: copies, as JSON carries them. A rule with a `when`\n * is left out, since `when` is code and without it the rule would cover more calls than it does on\n * the page. For a deny rule with a `when`, so are the allow rules on the tools it covers, which it\n * would overrule on the page: the server asks about those calls, and the page answers them with\n * every rule.\n */\nexport function toPlainRules(rules: readonly ApprovalRule[]): ApprovalRule[] {\n  const sent = rules.filter((rule) => !rule.when);\n  const leftOut = rules.filter((rule) => rule.when && rule.effect === 'deny').map((rule) => rule.tool);\n  return JSON.parse(JSON.stringify(withoutOverruled(sent, leftOut))) as ApprovalRule[];\n}\n\n/** What `parseApprovalRules` accepts from a client. */\nexport interface ApprovalRuleLimits {\n  /** How many rules are read: those after the first `maxRules` are left out. Default 100. */\n  maxRules?: number | undefined;\n  /** Argument patterns in one rule. Default 20. */\n  maxArgs?: number | undefined;\n  /** Characters in one string: an id, a tool, an argument's name or pattern, a reason. Default 500. */\n  maxLength?: number | undefined;\n  /**\n   * `*` wildcards in one pattern, `**` counting as one. Default 3, enough for a rule on what a\n   * command contains (`git push*--force*`). Matching takes the argument's length times the\n   * pattern's, whatever the number of `*`; `evaluateRules` bounds what each rule takes.\n   */\n  maxWildcards?: number | undefined;\n}\n\n/** The `*` wildcards in a pattern: a run of them counts once, an escaped one not at all. */\nfunction wildcards(pattern: string) {\n  let count = 0;\n  for (let i = 0; i < pattern.length; i++) {\n    if (pattern[i] === '\\\\') i++;\n    else if (pattern[i] === '*') {\n      count++;\n      while (pattern[i + 1] === '*') i++;\n    }\n  }\n  return count;\n}\n\n/** Tools named by the deny rules `parseApprovalRules` leaves out: past this many, it keeps no allow rule. */\nconst MAX_LEFT_OUT_TOOLS = 10;\n\n/**\n * The rules a client sent, such as a request body's `rules`, checked on the server: each field of\n * the right type and within `limits`, other fields dropped. A rule that fails a check is left out,\n * and so is everything when `value` is not an array. A deny rule left out takes with it the allow\n * rules it could overrule: those on a tool it names, or all of them when its tool is missing, not\n * a string or too long, when it comes after the first `maxRules`, or when the deny rules left out\n * name more than 10 tools. A rule left out still holds on the page, which answers the call when the\n * server asks.\n */\nexport function parseApprovalRules(\n  value: unknown,\n  { maxRules = 100, maxArgs = 20, maxLength = 500, maxWildcards = 3 }: ApprovalRuleLimits = {},\n): ApprovalRule[] {\n  if (!Array.isArray(value)) return [];\n  const text = (v: unknown): v is string => typeof v === 'string' && v.length <= maxLength;\n  const pattern = (v: unknown): v is string => text(v) && wildcards(v) <= maxWildcards;\n  const rules: ApprovalRule[] = [];\n  // The tool of each deny rule left out: `undefined` when it can't bound the calls the rule covers.\n  const leftOut: Array<string | undefined> = [];\n  for (const item of value.slice(0, maxRules)) {\n    if (!item || typeof item !== 'object' || Array.isArray(item)) continue;\n    const { id, tool, args, effect, scope, createdAt, reason } = item as Record<string, unknown>;\n    // A deny rule counts as left out until it passes every check.\n    if (effect === 'deny') leftOut.push(text(tool) ? tool : undefined);\n    if (!text(id) || !pattern(tool)) continue;\n    if ((effect !== 'allow' && effect !== 'deny') || (scope !== 'session' && scope !== 'always')) continue;\n    if ((createdAt !== undefined && !Number.isFinite(createdAt)) || (reason !== undefined && !text(reason))) continue;\n    let checked: Record<string, string> | undefined;\n    if (args !== undefined) {\n      if (!args || typeof args !== 'object' || Array.isArray(args)) continue;\n      const entries = Object.entries(args);\n      if (entries.length > maxArgs || !entries.every(([name, glob]) => text(name) && pattern(glob))) continue;\n      checked = Object.fromEntries(entries) as Record<string, string>;\n    }\n    if (effect === 'deny') leftOut.pop();\n    rules.push({\n      id,\n      tool,\n      ...(checked ? { args: checked } : {}),\n      effect,\n      scope,\n      ...(createdAt !== undefined ? { createdAt: createdAt as number } : {}),\n      ...(reason !== undefined ? { reason } : {}),\n    });\n  }\n  const tools = new Set(leftOut);\n  // A deny rule whose tool can't be read, or one past `maxRules`, could be on any tool. Past a few\n  // tools, no allow rule stays either: each one is checked against each tool, so the check grows\n  // with the number of rules, not its square.\n  const anyTool =\n    tools.has(undefined) ||\n    tools.size > MAX_LEFT_OUT_TOOLS ||\n    value.slice(maxRules).some((item) => item?.effect === 'deny');\n  if (anyTool) return rules.filter((rule) => rule.effect === 'deny');\n  return tools.size ? withoutOverruled(rules, [...tools] as string[]) : rules;\n}\n\n/* Agent Client Protocol: `session/request_permission`, typed here so nothing new is installed. */\n\n/** ACP `PermissionOptionKind`. */\nexport type AcpPermissionOptionKind = 'allow_once' | 'allow_always' | 'reject_once' | 'reject_always';\n\n/** ACP `PermissionOption`: a choice the agent offers. */\nexport interface AcpPermissionOption {\n  optionId: string;\n  name: string;\n  kind: AcpPermissionOptionKind;\n}\n\n/** What `toAcpPermissionResponse` reads of ACP's `RequestPermissionRequest`. */\nexport interface AcpRequestPermissionRequest {\n  sessionId: string;\n  toolCall: {\n    toolCallId: string;\n    title?: string | null | undefined;\n    /** The tool's programmatic name, when the agent sends one (ACP 1.8). */\n    name?: string | null | undefined;\n    kind?: string | null | undefined;\n    rawInput?: unknown;\n  };\n  options: readonly AcpPermissionOption[];\n}\n\n/** ACP `RequestPermissionResponse`. */\nexport interface AcpRequestPermissionResponse {\n  outcome: { outcome: 'cancelled' } | { outcome: 'selected'; optionId: string };\n}\n\nconst ACP_KIND: Record<AcpPermissionOptionKind, ApprovalDecision> = {\n  allow_once: 'allow-once',\n  allow_always: 'allow-always',\n  reject_once: 'deny-once',\n  reject_always: 'deny-always',\n};\n\n/**\n * The tool name rules and cards use for an ACP tool call: its programmatic `name` when the agent\n * sends one, else its `kind` (`edit`, `execute`…), else its `title`.\n */\nexport function acpToolName(toolCall: {\n  name?: string | null | undefined;\n  kind?: string | null | undefined;\n  title?: string | null | undefined;\n}): string {\n  return toolCall.name || toolCall.kind || toolCall.title || 'tool';\n}\n\n/** An ACP permission request as the card's request: the tool call's id, name, and raw input. */\nexport function fromAcpPermissionRequest(request: AcpRequestPermissionRequest): ApprovalRequest & { title?: string } {\n  const { toolCall } = request;\n  return {\n    id: toolCall.toolCallId,\n    toolCallId: toolCall.toolCallId,\n    toolName: acpToolName(toolCall),\n    input: toolCall.rawInput,\n    ...(toolCall.title ? { title: toolCall.title } : {}),\n  };\n}\n\n/**\n * The option a decision answers: the agent's only option of that kind, `allow_once` for\n * `allow-session`. None when the agent sent several, as they grant different things. `deny-once`\n * takes the agent's first `reject_once` even then: a \"no\" grants nothing, and the card can always\n * decline.\n */\nfunction acpOption(decision: ApprovalDecision, options: readonly AcpPermissionOption[]) {\n  const want = decision === 'allow-session' ? 'allow-once' : decision;\n  const matching = options.filter((o) => ACP_KIND[o.kind] === want);\n  return matching.length === 1 || want === 'deny-once' ? matching[0] : undefined;\n}\n\n/**\n * The decisions to offer for an ACP request: one per kind of option the agent sent, plus\n * `allow-session`, which the client keeps as a rule of its own (ACP has no session option). A kind\n * the agent sent several options of is left out, since a button can't say which one it picks:\n * Claude Code's ExitPlanMode sends up to three `allow_always` options, one of them clearing the\n * context and switching to auto mode, so it gets Approve and Deny but no Always. Deny stays\n * whenever the agent sent a `reject_once`, and answers its first one.\n */\nexport function decisionsFromAcpOptions(options: readonly AcpPermissionOption[]): ApprovalDecision[] {\n  return APPROVAL_DECISIONS.filter((d) => acpOption(d, options));\n}\n\n/**\n * A decision as ACP's response: the agent's one option of the same kind. `allow-session` selects\n * `allow_once`: the session rule stays on the client, so it never grants more than the agent's\n * \"once\". With no option of that kind, or several, the request is cancelled, as ACP asks of a\n * client that can't answer: it never picks one of several grants for the person. `deny-once`\n * answers the first of several `reject_once` options, since a denial grants nothing.\n */\nexport function toAcpPermissionResponse(\n  decision: ApprovalDecision,\n  options: readonly AcpPermissionOption[],\n): AcpRequestPermissionResponse {\n  const option = acpOption(decision, options);\n  return option\n    ? { outcome: { outcome: 'selected', optionId: option.optionId } }\n    : { outcome: { outcome: 'cancelled' } };\n}\n\n/** An ACP response as the decision it records, or `cancelled`. */\nexport function fromAcpPermissionResponse(\n  response: AcpRequestPermissionResponse,\n  options: readonly AcpPermissionOption[],\n): ApprovalDecision | 'cancelled' {\n  if (response.outcome.outcome === 'cancelled') return 'cancelled';\n  const { optionId } = response.outcome;\n  const option = options.find((o) => o.optionId === optionId);\n  return option ? ACP_KIND[option.kind] : 'cancelled';\n}\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/policy.ts"
    },
    {
      "path": "packages/signoff-ui/src/lib/primitives.tsx",
      "content": "'use client';\n\nimport {\n  createElement,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ComponentPropsWithoutRef,\n  type ReactNode,\n} from 'react';\nimport { CheckIcon, CopyIcon } from './icons';\nimport { safeStringify } from './format';\nimport { TOKEN_CLASS, tokenizeLine } from './highlight';\nimport { cn } from './utils';\nimport { commonLabels, type SignoffLabelsInput } from './labels';\nimport { useLabels, WithLabels } from '../labels';\n\n/** The labels' sections this module reads. */\nconst LABELS = { common: commonLabels };\n\n/**\n * An <img> for images from messages, written without JSX. Next.js' `no-img-element` lint rule\n * flags the element and suggests next/image, which cannot load these URLs without every host\n * configured; a comment disabling that rule would itself be an error where ESLint has no Next.js\n * plugin. The repository's ESLint config checks `Img` for alt text like an <img>.\n */\nexport function Img({ alt, ...props }: ComponentPropsWithoutRef<'img'> & { alt: string }) {\n  return createElement('img', { alt, ...props });\n}\n\n/**\n * Keyboard key hint. Purely visual: shortcuts are also described in text for assistive tech. Left to\n * right in a right-to-left page too, so `⇧N` does not show as `N⇧`.\n */\nexport function Kbd({ className, ...props }: ComponentPropsWithoutRef<'kbd'>) {\n  return (\n    <kbd\n      dir=\"ltr\"\n      className={cn(\n        'border-signoff-border-strong bg-signoff-bg/40 font-signoff-mono text-signoff-fg-muted inline-flex h-5 min-w-5 items-center justify-center rounded-[5px] border px-1 text-[11px] leading-none font-medium',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n/** A visually hidden live region. Render it unconditionally so updates are announced. */\nexport function LiveRegion({\n  children,\n  politeness = 'polite',\n}: {\n  children?: ReactNode;\n  politeness?: 'polite' | 'assertive';\n}) {\n  return (\n    <div\n      className=\"sr-only\"\n      role={politeness === 'assertive' ? 'alert' : 'status'}\n      aria-live={politeness}\n      aria-atomic=\"true\"\n    >\n      {children}\n    </div>\n  );\n}\n\n/** Returns `value` after it has been stable for `delayMs`. */\nexport function useDebouncedValue<T>(value: T, delayMs: number): T {\n  const [debounced, setDebounced] = useState(value);\n  useEffect(() => {\n    const id = setTimeout(() => setDebounced(value), delayMs);\n    return () => clearTimeout(id);\n  }, [value, delayMs]);\n  return debounced;\n}\n\nexport function CopyButton({ text, label, className }: { text: string; label: string; className?: string }) {\n  const L = useLabels(LABELS);\n  const [copied, setCopied] = useState(false);\n  const timer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n  useEffect(() => () => clearTimeout(timer.current), []);\n  return (\n    <button\n      type=\"button\"\n      onClick={async () => {\n        try {\n          await navigator.clipboard.writeText(text);\n          setCopied(true);\n          clearTimeout(timer.current);\n          timer.current = setTimeout(() => setCopied(false), 1500);\n        } catch {\n          // Clipboard can be unavailable (permissions, insecure context); fail quietly.\n        }\n      }}\n      aria-label={copied ? L.common.copied : label}\n      className={cn(\n        'text-signoff-fg-subtle hover:bg-signoff-surface-2 hover:text-signoff-fg focus-visible:outline-signoff-ring inline-flex size-7 cursor-pointer items-center justify-center rounded-md transition-colors focus-visible:outline-2 focus-visible:outline-offset-1',\n        className,\n      )}\n    >\n      {copied ? <CheckIcon size={14} className=\"text-signoff-accent-fg\" /> : <CopyIcon size={14} />}\n    </button>\n  );\n}\n\n/** Syntax-tinted, line-tokenized code. */\nexport function CodeLines({ code, language }: { code: string; language: string }) {\n  const lines = useMemo(() => code.split('\\n'), [code]);\n  return (\n    <code>\n      {lines.map((line, i) => (\n        <span key={i} className=\"block min-h-[1lh]\">\n          {tokenizeLine(line, language).map((t, j) => (\n            <span key={j} className={TOKEN_CLASS[t.kind] || undefined}>\n              {t.text}\n            </span>\n          ))}\n        </span>\n      ))}\n    </code>\n  );\n}\n\nexport interface JsonViewProps {\n  value: unknown;\n  /** Accessible name for the code block, e.g. \"Input\". */\n  label: string;\n  /** Lines shown before \"Show all\" collapses the rest. */\n  collapseAfter?: number;\n  className?: string;\n  /** Words to use instead of the English defaults: see `SignoffLabelsProvider`. */\n  labels?: SignoffLabelsInput | undefined;\n}\n\n/** Read-only JSON with light syntax tinting, a copy button and long-output folding. */\nexport function JsonView({ value, label, collapseAfter = 24, className, labels }: JsonViewProps) {\n  const L = useLabels(LABELS, labels);\n  const text = useMemo(() => (typeof value === 'string' ? value : safeStringify(value)), [value]);\n  const language = typeof value === 'string' ? 'text' : 'json';\n  const lineCount = useMemo(() => text.split('\\n').length, [text]);\n  const [showAll, setShowAll] = useState(false);\n  const folded = !showAll && lineCount > collapseAfter;\n  const shown = folded ? text.split('\\n').slice(0, collapseAfter).join('\\n') : text;\n  return (\n    <div data-signoff data-slot=\"signoff-json-view\" className={cn('group/json relative', className)}>\n      {/* The code keeps the kit's font: Tailwind v3's preflight `code` rule outranks the kit's reset. */}\n      <pre\n        role=\"group\"\n        aria-label={label}\n        tabIndex={0}\n        className=\"border-signoff-border bg-signoff-bg/60 font-signoff-mono text-signoff-fg focus-visible:outline-signoff-ring [&>code]:font-signoff-mono max-h-80 overflow-auto rounded-lg border px-3 py-2.5 text-xs leading-5 whitespace-pre focus-visible:outline-2 focus-visible:outline-offset-1\"\n      >\n        <CodeLines code={shown} language={language} />\n      </pre>\n      <div className=\"absolute top-1.5 right-1.5 opacity-0 transition-opacity group-focus-within/json:opacity-100 group-hover/json:opacity-100 [@media(hover:none)]:opacity-100\">\n        <WithLabels labels={labels}>\n          <CopyButton text={text} label={L.common.copyThe(label)} />\n        </WithLabels>\n      </div>\n      {lineCount > collapseAfter && (\n        <button\n          type=\"button\"\n          onClick={() => setShowAll((v) => !v)}\n          className=\"font-signoff-mono text-signoff-fg-subtle hover:text-signoff-fg focus-visible:outline-signoff-ring mt-1.5 cursor-pointer rounded text-[11px] underline-offset-2 hover:underline focus-visible:outline-2 focus-visible:outline-offset-1\"\n        >\n          {showAll ? L.common.showLess : L.common.showAllLines(lineCount)}\n        </button>\n      )}\n    </div>\n  );\n}\n\nexport const focusRing = 'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-signoff-ring';\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/primitives.tsx"
    },
    {
      "path": "packages/signoff-ui/src/lib/revealed.tsx",
      "content": "'use client';\n\nimport { useLabels } from '../labels';\nimport { untrustedLabels } from './labels';\nimport { MARK_CLASS, revealText } from './untrusted';\n\n/** The labels' sections this module reads. */\nconst LABELS = { untrusted: untrustedLabels };\n\n/**\n * Text from the agent, with marks in place of what does not show, so a command, a path or a line\n * reads as what it is: see `revealText`. `blanks` marks long runs of spaces and of blank lines too,\n * for a command or a path; not for code, which lines up with spaces.\n */\nexport function Revealed({ text, blanks = false }: { text: string; blanks?: boolean }) {\n  const L = useLabels(LABELS).untrusted;\n  return (\n    <>\n      {revealText(text, { blanks }).map((part, i) => {\n        if (typeof part === 'string') return part;\n        const name = part.kind === 'blank' ? L.blank(part.count, part.lines) : L.invisible(part.count, part.codes);\n        return (\n          <span key={i} data-slot=\"signoff-untrusted\" data-kind={part.kind} title={name} className={MARK_CLASS}>\n            <span aria-hidden=\"true\">{part.shown}</span>\n            <span className=\"sr-only\">{name}</span>\n          </span>\n        );\n      })}\n    </>\n  );\n}\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/revealed.tsx"
    },
    {
      "path": "packages/signoff-ui/src/lib/scroll-region.ts",
      "content": "'use client';\n\nimport { useCallback, useEffect, useLayoutEffect, useRef } from 'react';\n\nconst useIsoLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;\n\n/**\n * Keyboard access to a horizontal scroller (WCAG 2.1.1). While its content is wider than it is, it\n * joins the tab order and, given a `label`, becomes a named group, so the arrow keys scroll it\n * natively; once everything fits it leaves the tab order again and adds no tab stop. Measured after\n * every render (streamed content widens it) and whenever it or its content resizes.\n *\n * A group rather than a region, as `JsonView` does: a long conversation with many code blocks\n * would otherwise flood landmark navigation, with several landmarks named \"Code, ts\".\n *\n * The attributes are set on the element directly rather than through state: measuring needs\n * layout, and a re-render on every resize would re-render the content inside too.\n */\nexport function useScrollRegion<T extends HTMLElement>(label?: string) {\n  const ref = useRef<T>(null);\n  const sync = useCallback(() => {\n    const el = ref.current;\n    if (!el) return;\n    if (el.scrollWidth > el.clientWidth + 1) {\n      el.tabIndex = 0;\n      if (label) {\n        el.setAttribute('role', 'group');\n        el.setAttribute('aria-label', label);\n      }\n    } else {\n      el.removeAttribute('tabindex');\n      if (label) {\n        el.removeAttribute('role');\n        el.removeAttribute('aria-label');\n      }\n    }\n  }, [label]);\n\n  useIsoLayoutEffect(() => {\n    sync();\n  });\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el || typeof ResizeObserver === 'undefined') return;\n    const observer = new ResizeObserver(sync);\n    observer.observe(el);\n    for (const child of el.children) observer.observe(child);\n    return () => observer.disconnect();\n  }, [sync]);\n\n  return ref;\n}\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/scroll-region.ts"
    },
    {
      "path": "packages/signoff-ui/src/lib/untrusted.ts",
      "content": "/**\n * Text and URLs from the agent, shown to the person who decides on them. A prompt injection can\n * write them too, so the components show what would make them read as something other than what\n * runs or opens: characters that do not show, a long run of spaces or of blank lines, and a link\n * whose text names another host. No React here, so servers can call these too.\n */\n\n/**\n * Characters that do not show: format characters (Default_Ignorable_Code_Point: bidi controls,\n * zero-width spaces and joiners, Unicode tags, variation selectors, fillers), the interlinear\n * annotation characters, control characters, and the line and paragraph separators. Tab, newline\n * and a carriage return that ends a line show as what they are, and are left out in `invisible` below.\n */\nconst INVISIBLE = /[\\p{Default_Ignorable_Code_Point}\\p{Cc}\\p{Zl}\\p{Zp}\\uFFF9-\\uFFFB]/u;\n/** The quick test: text with none of these has nothing to show. */\nconst ANY_INVISIBLE = /(?![\\t\\n\\r])[\\p{Cc}\\p{Default_Ignorable_Code_Point}\\p{Zl}\\p{Zp}\\uFFF9-\\uFFFB]|\\r(?!\\n|$)/u;\n/** Spaces other than U+0020, and the blank braille pattern: they look like a space and are not one. */\nconst OTHER_SPACE = /[\\u00A0\\u1680\\u2000-\\u200A\\u202F\\u205F\\u3000\\u2800]/u;\nconst ANY_BLANK = /[ \\t]{2}|[\\u00A0\\u1680\\u2000-\\u200A\\u202F\\u205F\\u3000\\u2800]|\\n(?:[ \\t\\r]*\\n){3}/u;\nconst PICTOGRAPH = /\\p{Extended_Pictographic}/u;\n/** A character that can be an emoji, which a variation selector after it shows as one or as text. */\nconst EMOJI = /\\p{Emoji}/u;\nconst IN_EMOJI = /[\\p{Extended_Pictographic}\\p{Emoji_Modifier}\\uFE0F]/u;\n/** A run of spaces and tabs this wide, a tab counting 8, shows as a mark: about a third of a narrow card. */\nconst BLANK_RUN = 16;\n/**\n * A run of blank characters with this many blank lines in it or more, so 4 line breaks, shows as a\n * mark: blank lines push what follows down, out of view below. Code has up to 2 in a row (PEP 8\n * between definitions), and keeps them.\n */\nconst BLANK_LINES = 3;\n\nexport interface RevealTextOptions {\n  /**\n   * Also mark spaces: a run of spaces and tabs 16 columns wide or more, as its count, a run of 3\n   * blank lines or more, as its count too, and spaces other than U+0020, as their code points. For a\n   * command or a path; not for code, which lines up with spaces.\n   */\n  blanks?: boolean | undefined;\n}\n\n/** A run of characters to show as a mark, in place of the characters. */\nexport interface RevealedMark {\n  /** `invisible`: characters that do not show. `blank`: a long run of spaces and tabs, or of blank lines. */\n  kind: 'invisible' | 'blank';\n  /** The characters. */\n  text: string;\n  /** How many characters there are. */\n  count: number;\n  /** For a run of blank lines, how many line breaks it has, which the mark shows (`↵ ×60`); 0 for any other mark. */\n  lines: number;\n  /** Their code points, each once, in order (`U+202E`); empty for a blank run. */\n  codes: string[];\n  /** What the mark shows: `U+202E`, `U+200B ×240`, `␣ ×240`, and `↵ ×60` for a run of 60 line breaks. */\n  shown: string;\n}\n\n/** A part of the text: as it is, or a mark. */\nexport type RevealedPart = string | RevealedMark;\n\nconst codeOf = (char: string) => `U+${char.codePointAt(0)!.toString(16).toUpperCase().padStart(4, '0')}`;\n\n/**\n * The quick test: false when `revealText` would mark nothing in the text. True does not always mean\n * it marks something: the joiner in an emoji, or a run of 2 spaces, is left as it is.\n */\nexport function hasHidden(text: string, options: RevealTextOptions = {}): boolean {\n  return ANY_INVISIBLE.test(text) || (!!options.blanks && ANY_BLANK.test(text));\n}\n\n/**\n * The text in parts, with marks in place of what would make it read as something it is not:\n * characters that do not show, such as a bidi override (`U+202E`), which shows the text after it\n * reversed, or a zero-width space, and with `blanks`, long runs of spaces or of blank lines. Text\n * with none of them is one part, the text itself. The joiners and variation selectors in an emoji\n * are left as they are.\n */\nexport function revealText(text: string, options: RevealTextOptions = {}): RevealedPart[] {\n  if (!hasHidden(text, options)) return [text];\n  const chars = Array.from(text);\n  const parts: RevealedPart[] = [];\n  let plain = '';\n  let mark: RevealedMark | undefined;\n  /** The spaces, tabs and line breaks since the last other character, which may make a long run. */\n  let run = '';\n  const blank = (blanks: string, lines: number) => {\n    if (plain) parts.push(plain);\n    plain = '';\n    const count = blanks.length;\n    // A run of blank lines shows how many lines it pushes down, not its characters: the spaces on\n    // those lines and the carriage returns of CRLF count in `count` only.\n    const shown = lines ? `↵ ×${lines}` : `␣ ×${count}`;\n    parts.push({ kind: 'blank', text: blanks, count, lines, codes: [], shown });\n  };\n  const flushRun = () => {\n    const lines = run.split('\\n').length - 1;\n    // Enough blank lines to push what follows out of view below are one mark, line breaks and all.\n    if (lines > BLANK_LINES) blank(run, lines);\n    else {\n      // Otherwise each line's spaces count on their own, and the line breaks stay as they are.\n      for (const piece of run.split(/(\\r?\\n)/)) {\n        let width = 0;\n        for (const char of piece) width += char === '\\t' ? 8 : char === ' ' ? 1 : 0;\n        if (width >= BLANK_RUN) blank(piece, 0);\n        else plain += piece;\n      }\n    }\n    run = '';\n  };\n  const invisible = (char: string, i: number) => {\n    if (char === '\\t' || char === '\\n') return false;\n    if (char === '\\r') return i < chars.length - 1 && chars[i + 1] !== '\\n';\n    // The joiner between two emoji that make one (woman, joiner, laptop), and a variation selector\n    // after a character that can be an emoji, such as the one that makes a heart an emoji; after a\n    // digit, `#` or `*`, only in a keycap (1, U+FE0F, U+20E3). After a letter one shows nothing, and\n    // would hide in a word or a host: `git` U+FE0F `hub.com`. Compared by code point: a bundler may\n    // print the escape in a string as the character itself, which does not show.\n    const code = char.codePointAt(0);\n    if (code === 0x200d) return !(IN_EMOJI.test(chars[i - 1] ?? '') && PICTOGRAPH.test(chars[i + 1] ?? ''));\n    if (code === 0xfe0e || code === 0xfe0f) {\n      const before = chars[i - 1];\n      if (before === undefined || !EMOJI.test(before)) return true;\n      return /^[\\d#*]$/.test(before) && chars[i + 1]?.codePointAt(0) !== 0x20e3;\n    }\n    return INVISIBLE.test(char) || (!!options.blanks && OTHER_SPACE.test(char));\n  };\n  chars.forEach((char, i) => {\n    if (invisible(char, i)) {\n      if (run) flushRun();\n      if (!mark) {\n        if (plain) parts.push(plain);\n        plain = '';\n        mark = { kind: 'invisible', text: '', count: 0, lines: 0, codes: [], shown: '' };\n        parts.push(mark);\n      }\n      mark.text += char;\n      mark.count++;\n      const code = codeOf(char);\n      if (!mark.codes.includes(code)) mark.codes.push(code);\n      return;\n    }\n    mark = undefined;\n    // A carriage return here ends a line: one inside a line is a mark, above.\n    if (options.blanks && (char === ' ' || char === '\\t' || char === '\\n' || char === '\\r')) {\n      run += char;\n      return;\n    }\n    if (run) flushRun();\n    plain += char;\n  });\n  if (run) flushRun();\n  if (plain) parts.push(plain);\n  for (const part of parts) {\n    if (typeof part === 'string' || part.kind === 'blank') continue;\n    const { codes, count } = part;\n    part.shown =\n      codes.length <= 2 && count === codes.length\n        ? codes.join(' ')\n        : `${codes[0]}${codes.length > 1 ? ' …' : ''} ×${count}`;\n  }\n  return parts;\n}\n\n/** The classes of a mark: a small badge in the warning color, on one line with the text. */\nexport const MARK_CLASS =\n  'bg-signoff-warn/12 font-signoff-mono text-signoff-warn-fg ring-signoff-warn/40 mx-px inline-block rounded-[3px] px-0.5 text-[0.85em] leading-none whitespace-pre ring-1 ring-inset';\n\nexport interface SafeUrlOptions {\n  /** Also allow `data:` and `blob:` URLs, which an attached file or an image can have. */\n  files?: boolean | undefined;\n}\n\n/**\n * The URL when a link may use it: http, https, mailto, a relative URL, and with `files`, `data:`\n * and `blob:`. Anything else, `javascript:` first, is `undefined`, to render as text instead: React\n * 18 renders a `javascript:` link as it is, and React 19 only replaces it with one that throws.\n */\nexport function safeUrl(url: string | null | undefined, options: SafeUrlOptions = {}): string | undefined {\n  if (!url) return undefined;\n  // A scheme ends at the first colon, before any slash, question mark or hash; without one, the URL\n  // is relative. Browsers skip leading spaces and control characters, so this does too, after\n  // reading the scheme: a regex that skips them first reads a long run of them with no colon again\n  // from each of its characters.\n  const scheme = /^([^:/?#]*):/u\n    .exec(url)?.[1]\n    ?.replace(/^[\\p{Cc} ]+/u, '')\n    .toLowerCase();\n  if (scheme === undefined || scheme === 'http' || scheme === 'https' || scheme === 'mailto') return url;\n  return options.files && (scheme === 'data' || scheme === 'blob') ? url : undefined;\n}\n\n/**\n * Each host link text names, anywhere in it. Group 3: in a URL (`https://github.com/x`), after\n * `www.`, or in an email address, read with the rest of the URL; the name before its `@` is group\n * 1 in a URL (`https://github.com@evil.example`) and group 2 in an email address. Group 4: a word\n * that reads as a domain (`Visit github.com →`, `/github.com`) or an IP address (`8.8.8.8`), read\n * with its path, if any, as group 5; not the name before an `@` (`first.last@`). Each starts only\n * where a word does, so that long text is read once, not once from each of its characters.\n */\nconst NAMED_HOST =\n  /(?:(?<![a-z\\d+.-])[a-z\\d+.-]*:\\/\\/(?:([^\\s/?#@]*)@)?|\\bwww\\.|(?<![^\\s@<>()[\\]/])([^\\s@<>()[\\]/]+)@)([\\p{L}\\p{N}-]+(?:\\.[\\p{L}\\p{N}-]+)*)\\S*|(?<![\\p{L}\\p{M}\\p{N}-]|[\\p{L}\\p{M}\\p{N}-]\\.)((?:[\\p{L}\\p{M}\\p{N}-]+\\.)+\\p{L}[\\p{L}\\p{M}\\p{N}-]+|(?:(?:25[0-5]|2[0-4]\\d|1?\\d?\\d)\\.){3}(?:25[0-5]|2[0-4]\\d|1?\\d?\\d))(?![\\p{L}\\p{M}\\p{N}-]|[.@][\\p{L}\\p{M}\\p{N}-])\\.?([/?#:]\\S*)?/giu;\n/** A whole word that reads as a domain or an IP address, as group 4 of `NAMED_HOST` does. */\nconst DOMAIN =\n  /^(?:(?:[\\p{L}\\p{M}\\p{N}-]+\\.)+\\p{L}[\\p{L}\\p{M}\\p{N}-]+|(?:(?:25[0-5]|2[0-4]\\d|1?\\d?\\d)\\.){3}(?:25[0-5]|2[0-4]\\d|1?\\d?\\d))$/u;\n/**\n * Characters a person reads as a dot, which read as one here: the full stops a URL reads as dots,\n * ideographic (U+3002), full-width (U+FF0E) and halfwidth ideographic (U+FF61), so `github` U+3002\n * `com` goes to github.com; and the stops that only look like one, the one dot leader (U+2024), the\n * small full stop (U+FE52), the raised and middle dots (U+2E33, U+00B7), and the Syriac and Vai full\n * stops (U+0701, U+0702, U+A60E). Only between letters or digits, not beside Chinese, Japanese,\n * Korean, Syriac or Vai, where such a stop ends a sentence, and a middle dot not between two l's,\n * as in Catalan (`col\\u00B7legi`). The Arabic zeros (U+0660, U+06F0) and the Lisu tone mark U+A4F8, which\n * are a digit and a letter, only between Latin letters.\n */\nconst OTHER_DOT =\n  /(?<=[\\p{L}\\p{N}])(?<![\\p{scx=Han}\\p{scx=Hiragana}\\p{scx=Katakana}\\p{scx=Hangul}\\p{scx=Syriac}\\p{scx=Vai}])(?:[\\u3002\\uFF0E\\uFF61\\u2024\\uFE52\\u2E33\\u0701\\u0702\\uA60E]|(?<![lL])\\u00B7|\\u00B7(?![lL]))(?=[\\p{L}\\p{N}])(?![\\p{scx=Han}\\p{scx=Hiragana}\\p{scx=Katakana}\\p{scx=Hangul}\\p{scx=Syriac}\\p{scx=Vai}])|(?<=\\p{scx=Latin})[\\u0660\\u06F0\\uA4F8](?=\\p{scx=Latin})/gu;\n/** A file's or a product's name, which reads like a domain and is not one: `README.md`, `Next.js`. */\nconst FILE_NAME =\n  /\\.(?:[cm]?[jt]sx?|json|mdx?|s?css|html?|py|rb|go|rs|sh|txt|ya?ml|toml|lock|vue|svelte|php|java|kt|swift|cpp|cs|sql|xml|csv|log|zip|pdf|png|jpe?g|gif|svg|webp)$/i;\n/** Of those, the extensions that are top-level domains too: `docs.rs`, `bun.sh`, `get.zip`. */\nconst TLD_EXTENSION = /\\.(?:md|py|rs|sh|zip)$/i;\n\n/** A host as the browser resolves it (lowercase, look-alike letters in punycode), without `www.`. */\nfunction normalHost(host: string): string | undefined {\n  try {\n    return new URL(`http://${host}`).hostname.replace(/^www\\./, '').replace(/\\.$/, '');\n  } catch {\n    return undefined;\n  }\n}\n\n/** Whether a word in a name, such as the one before an `@`, reads as a domain other than `target`. */\nfunction namesOtherDomain(name: string, target: string): boolean {\n  return name.split(/[^\\p{L}\\p{M}\\p{N}.-]/u).some((word) => {\n    const domain = word.replace(/^\\.+|\\.+$/g, '');\n    return DOMAIN.test(domain) && normalHost(domain) !== target;\n  });\n}\n\n/** The last segment of a URL's path, decoded and in lowercase: `readme.md` for `/a/b/README.md`. */\nfunction lastSegment(url: URL): string {\n  const segment = url.pathname.split('/').pop() ?? '';\n  try {\n    return decodeURIComponent(segment).toLowerCase();\n  } catch {\n    return segment.toLowerCase();\n  }\n}\n\n/**\n * The host a link goes to, when its text could make a person think it goes elsewhere: the text\n * names another host anywhere in it (`Visit github.com →`), counting any word that reads as a\n * domain or an IP address and is not a file's name, or a domain before an `@`\n * (`github.com@evil.example`), or names one in look-alike letters (the host is in punycode,\n * `xn--`), or has characters that do not show, or the URL puts a name before the host\n * (`https://github.com@evil.example`). Otherwise `undefined`, and the link needs nothing beside it.\n */\nexport function linkHostMismatch(text: string, href: string): string | undefined {\n  let url: URL;\n  let target: string | undefined;\n  try {\n    // Against a base of its own, so that a relative URL, which stays on the page's site, has no host\n    // to show, and `//evil.example/x` has evil.example.\n    url = new URL(href, 'https://self.invalid');\n    if (url.host === 'self.invalid') return undefined;\n    if (url.protocol === 'http:' || url.protocol === 'https:') target = normalHost(url.hostname);\n    else if (url.protocol === 'mailto:') target = normalHost(url.pathname.split('@').pop() ?? '');\n  } catch {\n    return undefined;\n  }\n  if (!target) return undefined;\n  // What comes before an @ reads as the host, and is only a user name: whatever the text says.\n  if (url.username || url.password) return target;\n  const trimmed = text.trim();\n  // Characters that do not show, as `revealText` marks them: not the joiner or the variation\n  // selector inside an emoji, as in a red heart or a woman at a laptop.\n  if (revealText(trimmed).some((part) => typeof part !== 'string')) return target;\n  // Those left are an emoji's, and split no name: read without them, so that one after a host does\n  // not keep the text from naming it. Characters that read as a dot read as one.\n  const shown = trimmed.replace(/\\u200D|\\uFE0E|\\uFE0F/gu, '').replace(OTHER_DOT, '.');\n  const mailto = url.protocol === 'mailto:';\n  let named = false;\n  for (const [, user, local, host, domain, path] of shown.matchAll(NAMED_HOST)) {\n    // A domain before an @ reads as the host, as in the URL: `https://github.com@evil.example`, and\n    // `github.com@evil.example`, unless that is the email address a mailto link writes to.\n    const before = user ?? (mailto ? undefined : local);\n    if (before && namesOtherDomain(before, target)) return target;\n    // A name such as `README.md` is a file's, unless its extension is a top-level domain too, as in\n    // `docs.rs`: then only when the link goes to that file.\n    if (\n      domain &&\n      FILE_NAME.test(domain) &&\n      (!TLD_EXTENSION.test(domain) || (!path && lastSegment(url) === domain.toLowerCase()))\n    )\n      continue;\n    if (normalHost(host ?? domain!) !== target) return target;\n    named = true;\n  }\n  // The text names only the host it goes to: still shown when that host is in look-alike letters.\n  return named && target.split('.').some((label) => label.startsWith('xn--')) ? target : undefined;\n}\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/untrusted.ts"
    },
    {
      "path": "packages/signoff-ui/src/lib/utils.ts",
      "content": "import { clsx, type ClassValue } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\n/** Merge class names, resolving Tailwind utility conflicts (last one wins). */\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n\n/** True when a keyboard event originates from a text-entry control. */\nexport function isTypingTarget(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  if (target.isContentEditable) return true;\n  const tag = target.tagName;\n  if (tag === 'TEXTAREA' || tag === 'SELECT') return true;\n  if (tag === 'INPUT') {\n    const type = (target as HTMLInputElement).type;\n    return !['button', 'checkbox', 'radio', 'submit', 'reset'].includes(type);\n  }\n  return false;\n}\n\n/**\n * True for a key pressed on the app's own content inside a component: an element in a\n * `data-signoff-slot` within it (such as `ApprovalCard`'s `preview`), or a portal rendered from\n * there, such as a menu, whose keys reach the component through React but come from outside its\n * element. A component that is itself in another component's slot still gets its keys, since that\n * slot is outside it.\n */\nexport function fromSlot(event: { target: EventTarget | null; currentTarget: Element }): boolean {\n  const { target, currentTarget } = event;\n  if (!(target instanceof Element)) return false;\n  if (!currentTarget.contains(target)) return true;\n  const slot = target.closest('[data-signoff-slot]');\n  return slot !== null && currentTarget.contains(slot);\n}\n\n/** True for a promise or any other thenable, e.g. what an async event handler returns. */\nexport function isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return (\n    value !== null &&\n    (typeof value === 'object' || typeof value === 'function') &&\n    typeof (value as { then?: unknown }).then === 'function'\n  );\n}\n\n/** True when a key event carries a modifier we should not intercept. */\nexport function hasModifier(event: { altKey: boolean; ctrlKey: boolean; metaKey: boolean }) {\n  return event.altKey || event.ctrlKey || event.metaKey;\n}\n\n/** Heading levels a component title can render as. */\nexport type HeadingLevel = 2 | 3 | 4 | 5 | 6;\n",
      "type": "registry:lib",
      "target": "components/signoff-ui/lib/utils.ts"
    },
    {
      "path": "packages/signoff-ui/src/tool-call-timeline.tsx",
      "content": "'use client';\n\nimport * as Collapsible from '@radix-ui/react-collapsible';\nimport {\n  memo,\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ComponentPropsWithoutRef,\n  type CSSProperties,\n  type KeyboardEvent,\n  type ReactNode,\n} from 'react';\nimport {\n  getAllToolParts,\n  getToolPartName,\n  getToolPhase,\n  isAutomaticApproval,\n  isDeniedAfterApproval,\n  isInterruptibleToolPart,\n  isSettledPhase,\n  isSubagentPart,\n  isToolPart,\n  type AnyUIPart,\n  type SubagentPart,\n  type ToolPart,\n  type ToolPhase,\n} from './lib/ai';\nimport { humanizeToolName, summarizeValue } from './lib/format';\nimport { toolCallTimelineLabels, formatLabels, type RiskLevel, type SignoffLabelsInput } from './lib/labels';\nimport { useLabels, WithLabels } from './labels';\nimport { useActivityWindow, useHydrated, useNow, useToolTimings, type ToolTiming, type ToolTimings } from './lib/hooks';\nimport { BanIcon, CheckIcon, ChevronIcon, SpinnerIcon, XIcon } from './lib/icons';\nimport { JsonView, LiveRegion } from './lib/primitives';\nimport { cn } from './lib/utils';\n\n/** The labels' sections this module reads. */\nconst LABELS = { toolCallTimeline: toolCallTimelineLabels, format: formatLabels };\n\nexport type { RiskLevel };\n\n/** Per-tool presentation. Every field is optional. */\nexport interface ToolMeta {\n  /** Display label. Defaults to the humanized tool name. */\n  label?: string;\n  icon?: ReactNode;\n  /**\n   * One-line summary shown next to the label. Defaults to the most descriptive input field.\n   * Not called before any input has arrived; while the input streams it can be partial.\n   */\n  summary?: (input: unknown, part: ToolPart) => ReactNode;\n  /** Replace the default JSON output view. Your content, like `AgentMessage`'s `renderTool`. */\n  renderOutput?: (output: unknown, part: ToolPart) => ReactNode;\n  /** Risk shown on approval requests for this tool. */\n  risk?: RiskLevel | ((input: unknown) => RiskLevel);\n}\n\nexport interface ToolCallTimelineProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {\n  /**\n   * Tool parts, or every part of a message: other parts are ignored, except a sub-agent's\n   * (`data-signoff-subagent`), whose calls nest under the call that started it.\n   */\n  parts: readonly AnyUIPart[];\n  tools?: Record<string, ToolMeta> | undefined;\n  /** Externally measured timings by `toolCallId`. Measured client-side when omitted. */\n  timings?: ToolTimings | undefined;\n  /** Controlled set of expanded `toolCallId`s. */\n  expanded?: readonly string[] | undefined;\n  defaultExpanded?: readonly string[] | undefined;\n  onExpandedChange?: ((expanded: string[]) => void) | undefined;\n  /**\n   * Expand calls automatically when they fail. Default `false`: the error\n   * message is always shown inline under a failed call, with details on demand.\n   */\n  expandErrors?: boolean;\n  /** Show a per-call waterfall bar relative to the whole timeline. Default `true`. */\n  waterfall?: boolean;\n  /**\n   * Announce completions and failures to screen readers. Default `true`. Calls that settle within\n   * moments of each other, such as parallel calls, are announced together.\n   */\n  announce?: boolean;\n  /** Extra content under a call, e.g. an approval card. Your content, like `renderOutput`'s. */\n  renderExtra?: ((part: ToolPart) => ReactNode) | undefined;\n  /** Accessible name for the list. Default \"Tool calls\" (`labels.toolCallTimeline.list`). */\n  label?: string;\n  /**\n   * Whether the run can still make progress. Default `true`. Pass `false` once it has ended\n   * (stopped, failed, or restored from history): calls still streaming their input or running\n   * then read \"Stopped\" and their clocks stop, instead of counting up forever.\n   */\n  active?: boolean;\n  /**\n   * The run ended in an error (`useChat`'s `status === 'error'`). Default `false`. With `active={false}`,\n   * approved calls whose result never came back then read \"Stopped\" too: the request that would\n   * have run them failed. Pass it as well for a run restored from history that ended in an error.\n   */\n  failed?: boolean;\n  /**\n   * Client-side tools a person answers, such as a review: the names `deriveAgentState` takes as\n   * `pendingClientTools`. Their calls show no duration, since the time is the person's, and read as\n   * waiting on them until answered.\n   */\n  pendingClientTools?: readonly string[] | undefined;\n  /** Words to use instead of the English defaults: see `SignoffLabelsProvider`. */\n  labels?: SignoffLabelsInput | undefined;\n}\n\nconst PHASE_TEXT: Record<ToolPhase, string> = {\n  streaming: 'text-signoff-fg-muted',\n  running: 'text-signoff-accent-fg',\n  'awaiting-approval': 'text-signoff-hot-fg',\n  success: 'text-signoff-fg-subtle',\n  error: 'text-signoff-hot-fg',\n  denied: 'text-signoff-fg-subtle',\n};\n\n/** Shared by calls and sub-agents. */\nconst TRIGGER =\n  'group/trigger hover:bg-signoff-surface-2/70 focus-visible:outline-signoff-ring flex w-full min-w-0 cursor-pointer items-center gap-2.5 rounded-lg px-2 py-1.5 text-left transition-colors focus-visible:outline-2 focus-visible:outline-offset-0';\nconst CHEVRON =\n  'text-signoff-fg-subtle transition-transform duration-200 group-data-[state=open]/trigger:rotate-90 motion-reduce:transition-none';\nconst ERROR_LINE = 'font-signoff-mono text-signoff-hot-fg mt-0.5 mb-1 line-clamp-2 px-2 text-xs leading-5 break-words';\nconst CONTENT =\n  'data-[state=closed]:motion-safe:animate-signoff-collapse data-[state=open]:motion-safe:animate-signoff-expand overflow-hidden';\nconst NAME = 'text-signoff-fg min-w-0 truncate text-[13px] font-medium';\n\nfunction StatusNode({ phase, interrupted }: { phase: ToolPhase; interrupted: boolean }) {\n  const base = 'relative z-10 flex size-6 items-center justify-center rounded-full border';\n  if (interrupted) {\n    return (\n      <span className={cn(base, 'border-signoff-border-strong bg-signoff-surface-2')}>\n        <span className=\"bg-signoff-fg-subtle size-2 rounded-[2px]\" />\n      </span>\n    );\n  }\n  switch (phase) {\n    case 'streaming':\n      return (\n        <span className={cn(base, 'border-signoff-accent/60 bg-signoff-bg border-dashed')}>\n          <span className=\"bg-signoff-accent size-1.5 rounded-full motion-safe:animate-pulse\" />\n        </span>\n      );\n    case 'running':\n      return (\n        <span className={cn(base, 'border-signoff-accent/40 bg-signoff-bg text-signoff-accent')}>\n          <SpinnerIcon size={14} className=\"motion-safe:animate-signoff-spin\" />\n        </span>\n      );\n    case 'awaiting-approval':\n      return (\n        <span className={cn(base, 'border-signoff-hot/60 bg-signoff-bg')}>\n          <span className=\"border-signoff-hot motion-safe:animate-signoff-ping absolute inset-0 rounded-full border\" />\n          <span className=\"font-signoff-mono text-signoff-hot-fg text-[11px] leading-none font-bold\">!</span>\n        </span>\n      );\n    case 'success':\n      return (\n        <span className={cn(base, 'border-signoff-accent/35 bg-signoff-accent/15 text-signoff-accent-fg')}>\n          <CheckIcon size={13} strokeWidth={2.5} />\n        </span>\n      );\n    case 'error':\n      return (\n        <span className={cn(base, 'border-signoff-hot/45 bg-signoff-hot/15 text-signoff-hot-fg')}>\n          <XIcon size={12} strokeWidth={2.5} />\n        </span>\n      );\n    case 'denied':\n      return (\n        <span className={cn(base, 'border-signoff-border-strong bg-signoff-surface-2 text-signoff-fg-subtle')}>\n          <BanIcon size={12} />\n        </span>\n      );\n  }\n}\n\nfunction getDuration(t: ToolTiming | undefined, now: number): number | undefined {\n  if (!t?.startedAt) return undefined;\n  const from = t.runningAt ?? t.startedAt;\n  return Math.max(0, (t.endedAt ?? now) - from);\n}\n\nconst useIsoLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;\n\n/*\n * A long run renders only the calls near the screen. Its calls are cut into chunks; a chunk away\n * from the viewport is one empty item, hidden from assistive tech, with the height it had (or an\n * estimate until it has rendered). The calls that render give their place in the whole list\n * (aria-posinset, aria-setsize); the arrow keys, Home and End move by index and bring a call that\n * is not rendered into view; announcements come from the calls' data, not from what is rendered.\n * A chunk holding an open call, a call still going, or focus stays rendered.\n */\n/** Timelines with more calls than this render only the chunks near the screen. */\nconst VIRTUALIZE_CALLS = 150;\nconst CHUNK_CALLS = 25;\n/** How far beyond the viewport chunks render, so scrolling rarely meets an empty one. */\nconst NEAR_MARGIN = '800px 0px';\n/** A collapsed call's height, until one is measured. */\nconst CALL_HEIGHT = 40;\n\n/** Which chunks of a long timeline are near the viewport: one observer for all their elements. */\ninterface CallObserver {\n  /** Calls `listener` when the chunk comes near the viewport or leaves it; returns an unsubscribe. */\n  listen(chunk: number, listener: (near: boolean) => void): () => void;\n  /** Watches one of the chunk's elements (its calls, or its placeholder); returns an unwatch. */\n  observe(el: Element, chunk: number): () => void;\n  /** From the top of the chunk's first element to the bottom of its last, or 0. */\n  measure(chunk: number): number;\n}\n\nfunction createCallObserver(): CallObserver {\n  let observer: IntersectionObserver | undefined;\n  const chunkOf = new Map<Element, number>();\n  const nearOnes = new Map<number, Set<Element>>();\n  const listeners = new Map<number, (near: boolean) => void>();\n  return {\n    listen(chunk, listener) {\n      listeners.set(chunk, listener);\n      return () => {\n        if (listeners.get(chunk) === listener) listeners.delete(chunk);\n      };\n    },\n    observe(el, chunk) {\n      // Without IntersectionObserver (old browsers, jsdom), every chunk renders: see CallChunk.\n      if (typeof IntersectionObserver === 'undefined') return () => {};\n      observer ??= new IntersectionObserver(\n        (entries) => {\n          const changed = new Set<number>();\n          for (const entry of entries) {\n            const at = chunkOf.get(entry.target);\n            if (at === undefined) continue;\n            const near = nearOnes.get(at) ?? new Set();\n            nearOnes.set(at, near);\n            if (entry.isIntersecting) near.add(entry.target);\n            else near.delete(entry.target);\n            changed.add(at);\n          }\n          for (const at of changed) listeners.get(at)?.((nearOnes.get(at)?.size ?? 0) > 0);\n        },\n        // `scrollMargin` extends the margin into scrolling containers, such as a chat panel, where supported.\n        { rootMargin: NEAR_MARGIN, scrollMargin: NEAR_MARGIN } as IntersectionObserverInit,\n      );\n      chunkOf.set(el, chunk);\n      observer.observe(el);\n      return () => {\n        chunkOf.delete(el);\n        nearOnes.get(chunk)?.delete(el);\n        observer?.unobserve(el);\n      };\n    },\n    measure(chunk) {\n      let top = Infinity;\n      let bottom = -Infinity;\n      for (const [el, at] of chunkOf) {\n        if (at !== chunk) continue;\n        const rect = el.getBoundingClientRect();\n        top = Math.min(top, rect.top);\n        bottom = Math.max(bottom, rect.bottom);\n      }\n      return bottom > top ? bottom - top : 0;\n    },\n  };\n}\n\n/** Calls that settle within this window are announced together, once it has passed. */\nconst ANNOUNCE_DELAY_MS = 300;\n\n/** One level of a timeline: its calls, and the sub-agents each call started. */\ninterface Level {\n  calls: ToolPart[];\n  subagents: Map<string, SubagentPart[]>;\n}\n\n/**\n * The calls in `parts`, with each sub-agent under the call that started it. A sub-agent whose call is\n * not among them (it gave none, or it is not in this timeline) has its calls shown in its place.\n */\nfunction collectCalls(parts: readonly AnyUIPart[]): Level {\n  const level: Level = { calls: [], subagents: new Map() };\n  const ids = new Set(parts.filter(isToolPart).map((part) => part.toolCallId));\n  const under = (id: string, subagents: SubagentPart[]) =>\n    level.subagents.set(id, [...(level.subagents.get(id) ?? []), ...subagents]);\n  for (const part of parts) {\n    if (isToolPart(part)) level.calls.push(part);\n    else if (!isSubagentPart(part)) continue;\n    else if (ids.has(part.data.parentToolCallId!)) under(part.data.parentToolCallId!, [part]);\n    else {\n      const inner = collectCalls(part.data.parts);\n      level.calls.push(...inner.calls);\n      for (const [id, subagents] of inner.subagents) under(id, subagents);\n    }\n  }\n  return level;\n}\n\n/** Which of a timeline's sub-agents are open, and which a person closed. */\ninterface SubagentsOpen {\n  open: ReadonlySet<string>;\n  closed: ReadonlySet<string>;\n}\n\nconst TRIGGERS = '[data-slot=\"signoff-tool-call-trigger\"], [data-slot=\"signoff-subagent-trigger\"]';\nconst CALL = '[data-slot=\"signoff-tool-call\"]';\n\n/** When the last of these calls settled, or -Infinity. */\nfunction lastEnd(parts: readonly ToolPart[], timings: ToolTimings): number {\n  let last = -Infinity;\n  for (const part of parts) last = Math.max(last, timings[part.toolCallId]?.endedAt ?? -Infinity);\n  return last;\n}\n\n/**\n * A vertical timeline of tool calls with live states, durations, a waterfall,\n * and expandable input/output. Follows the WAI-ARIA disclosure pattern; Arrow\n * Up/Down, Home and End move between calls. A sub-agent's calls nest, collapsed,\n * under the call that started it.\n */\nexport function ToolCallTimeline({\n  parts,\n  tools,\n  timings: timingsProp,\n  expanded: expandedProp,\n  defaultExpanded,\n  onExpandedChange,\n  expandErrors = false,\n  waterfall = true,\n  announce = true,\n  renderExtra,\n  label,\n  active = true,\n  failed = false,\n  pendingClientTools,\n  labels,\n  className,\n  ...props\n}: ToolCallTimelineProps) {\n  const L = useLabels(LABELS, labels);\n  const T = L.toolCallTimeline;\n  const level = useMemo(() => collectCalls(parts), [parts]);\n  const toolParts = level.calls;\n  // Every call, its sub-agents' included: their timings, the waterfall and the announcements.\n  const allParts = useMemo(() => getAllToolParts(parts), [parts]);\n  const measured = useToolTimings(parts);\n  const timings = timingsProp ?? measured;\n  const byPerson = (part: ToolPart) => pendingClientTools?.includes(getToolPartName(part)) ?? false;\n  const anyActive =\n    active &&\n    allParts.some((p) => {\n      const phase = phaseOf(p, byPerson(p));\n      return !isSettledPhase(phase) && phase !== 'awaiting-approval';\n    });\n  const now = useNow(anyActive, 100);\n  const hydrated = useHydrated();\n  // Unsettled calls freeze when the run stops; restored history (never active here) has no end time.\n  const stoppedAt = useActivityWindow(active).endedAt;\n  const clock = active ? now : stoppedAt;\n\n  const [uncontrolled, setUncontrolled] = useState<readonly string[]>(defaultExpanded ?? []);\n  const userExpanded = expandedProp ?? uncontrolled;\n  // Failed calls open automatically unless the user explicitly collapsed them.\n  const [collapsedErrors, setCollapsedErrors] = useState<ReadonlySet<string>>(() => new Set());\n  const isOpen = useCallback(\n    (part: ToolPart) =>\n      userExpanded.includes(part.toolCallId) ||\n      (expandErrors && part.state === 'output-error' && !collapsedErrors.has(part.toolCallId)),\n    [userExpanded, expandErrors, collapsedErrors],\n  );\n  const setOpen = (part: ToolPart, open: boolean) => {\n    const id = part.toolCallId;\n    if (!open && part.state === 'output-error') setCollapsedErrors((s) => new Set(s).add(id));\n    const next = open ? [...userExpanded.filter((x) => x !== id), id] : userExpanded.filter((x) => x !== id);\n    if (expandedProp === undefined) setUncontrolled(next);\n    onExpandedChange?.(next);\n  };\n  // One function for every call, reaching the latest render: calls are memoized, and in a long run\n  // only those that change render again.\n  const latestSetOpen = useRef(setOpen);\n  useIsoLayoutEffect(() => {\n    latestSetOpen.current = setOpen;\n  });\n  const [onOpenChange] = useState(() => (part: ToolPart, open: boolean) => latestSetOpen.current(part, open));\n\n  // Sub-agents start collapsed. One with a call waiting on a person (an approval, or a call they answer)\n  // opens, unless the person closed it.\n  const [subagentsOpen, setSubagentsOpen] = useState<SubagentsOpen>(() => ({ open: new Set(), closed: new Set() }));\n  const isSubagentOpen = (part: SubagentPart) => {\n    const id = part.data.subagentRunId;\n    if (subagentsOpen.open.has(id)) return true;\n    return (\n      !subagentsOpen.closed.has(id) &&\n      getAllToolParts([part]).some((p) => phaseOf(p, byPerson(p)) === 'awaiting-approval')\n    );\n  };\n  const setSubagentOpen = (id: string, open: boolean) =>\n    setSubagentsOpen(({ open: opened, closed }) => {\n      const [nextOpen, nextClosed] = [new Set(opened), new Set(closed)];\n      (open ? nextOpen : nextClosed).add(id);\n      (open ? nextClosed : nextOpen).delete(id);\n      return { open: nextOpen, closed: nextClosed };\n    });\n\n  // Waterfall bounds span every call that has timing information, but one a person answers: its time\n  // is theirs, and it has no bar. Each call places its bar from its own times and the span set on the\n  // list, so while a call runs and the span grows, the others do not render again.\n  const bounds = useMemo(() => {\n    let min = Infinity;\n    let max = -Infinity;\n    for (const part of allParts) {\n      if (pendingClientTools?.includes(getToolPartName(part))) continue;\n      const t = timings[part.toolCallId];\n      const end = t?.endedAt ?? clock;\n      if (!t?.startedAt || end === undefined) continue;\n      min = Math.min(min, t.startedAt);\n      max = Math.max(max, end);\n    }\n    return Number.isFinite(min) && max > min ? { min, span: max - min } : undefined;\n  }, [allParts, timings, pendingClientTools, clock]);\n\n  // Calls that settled since the last announcement, in the order they settled. Calls settled before\n  // the timeline mounted (restored history) are never announced.\n  const [announced, setAnnounced] = useState(() => ({ text: '', through: lastEnd(allParts, timings) }));\n  const announcedThrough = announced.through;\n  const pending = useMemo(() => {\n    const settled: Array<{ part: ToolPart; at: number }> = [];\n    for (const part of allParts) {\n      const at = timings[part.toolCallId]?.endedAt;\n      if (at !== undefined && at > announcedThrough) settled.push({ part, at });\n    }\n    settled.sort((a, b) => a.at - b.at);\n    const sentences = settled.flatMap(({ part, at }) => {\n      const name = tools?.[getToolPartName(part)]?.label ?? humanizeToolName(getToolPartName(part));\n      const phase = getToolPhase(part);\n      if (phase === 'error') return [T.failed(name, part.errorText)];\n      if (phase === 'denied') return [deniedByPolicy(part) ? T.blockedByPolicy(name) : T.denied(name)];\n      // The person just answered it, and its time was theirs: no \"finished in\" for it.\n      if (pendingClientTools?.includes(getToolPartName(part))) return [];\n      return [T.finished(name, L.format.durationLong(getDuration(timings[part.toolCallId], at)))];\n    });\n    const text =\n      sentences.length > 1 ? sentences.map((s) => (/[.!?]$/.test(s) ? s : `${s}.`)).join(' ') : (sentences[0] ?? '');\n    return { text, through: settled.at(-1)?.at ?? announcedThrough };\n  }, [allParts, timings, tools, pendingClientTools, announcedThrough, T, L.format]);\n  // Wait a moment, so that calls finishing together (parallel calls) are read out as one.\n  const { text: pendingText, through: pendingThrough } = pending;\n  useEffect(() => {\n    if (!pendingText) return;\n    const id = setTimeout(() => setAnnounced({ text: pendingText, through: pendingThrough }), ANNOUNCE_DELAY_MS);\n    return () => clearTimeout(id);\n  }, [pendingText, pendingThrough]);\n\n  const listRef = useRef<HTMLOListElement>(null);\n  const count = toolParts.length;\n  const virtualized = count > VIRTUALIZE_CALLS;\n  const [observer] = useState(createCallObserver);\n  // Of the chunks there at the first render, the first and the last render and the rest wait for the\n  // viewport; all render where the timeline starts short. A chunk added later renders, then sees\n  // where it is.\n  const [initial] = useState(() => ({ virtualized, chunks: Math.ceil(count / CHUNK_CALLS) }));\n  const [callHeight, setCallHeight] = useState(CALL_HEIGHT);\n  // A call slides in when it is new: at the first render, or arriving after it. Not when a chunk that\n  // has scrolled back near the screen renders its calls again, or a sub-agent opens.\n  const [entering] = useState(() => createEntering(allParts.map((part) => part.toolCallId)));\n  useEffect(() => entering.mounted(), [entering]);\n  // The chunk holding focus stays rendered; a call the keyboard moves to renders, then takes focus.\n  const [focusChunk, setFocusChunk] = useState<number>();\n  const [focusTarget, setFocusTarget] = useState<{ index: number; last: boolean }>();\n  /** The top-level calls rendered, as list items. */\n  const callItems = () =>\n    Array.from(listRef.current?.children ?? []).filter((el): el is HTMLElement => el.matches(CALL));\n  const callAt = (index: number) =>\n    virtualized ? callItems().find((el) => el.getAttribute('aria-posinset') === String(index + 1)) : callItems()[index];\n  const reveal = (trigger: HTMLElement | undefined) => {\n    if (!trigger) return;\n    // In a long timeline the call may be off screen; a short one is all on the page, as it scrolls.\n    if (virtualized) trigger.scrollIntoView?.({ block: 'nearest' });\n    trigger.focus({ preventScroll: virtualized });\n  };\n  /** A call's first trigger, or its last: a sub-agent's, or a call in an open sub-agent. */\n  const triggerIn = (item: Element, last: boolean) => {\n    const triggers = item.querySelectorAll<HTMLElement>(TRIGGERS);\n    return last ? triggers[triggers.length - 1] : triggers[0];\n  };\n  // Arrow keys move through what is on screen: each call's trigger, then those of its sub-agents and\n  // of their calls while open. In a long timeline they go from call to call by index, rendering the\n  // one they reach.\n  const onKeyDown = (event: KeyboardEvent<HTMLOListElement>) => {\n    if (!['ArrowDown', 'ArrowUp', 'Home', 'End'].includes(event.key)) return;\n    const list = listRef.current;\n    const focused = document.activeElement;\n    if (!list || !(focused instanceof HTMLElement) || !focused.matches(TRIGGERS)) return;\n    let item = focused.closest(CALL);\n    while (item && item.parentElement !== list) item = item.parentElement!.closest(CALL);\n    if (!item) return;\n    event.preventDefault();\n    const triggers = Array.from(item.querySelectorAll<HTMLElement>(TRIGGERS));\n    const at = triggers.indexOf(focused);\n    if (event.key === 'ArrowDown' && at < triggers.length - 1) return reveal(triggers[at + 1]);\n    if (event.key === 'ArrowUp' && at > 0) return reveal(triggers[at - 1]);\n    const from = virtualized\n      ? Number(item.getAttribute('aria-posinset')) - 1\n      : callItems().indexOf(item as HTMLElement);\n    const [index, last] =\n      event.key === 'Home'\n        ? [0, false]\n        : event.key === 'End'\n          ? [count - 1, true]\n          : event.key === 'ArrowDown'\n            ? [(from + 1) % count, false]\n            : [(from - 1 + count) % count, true];\n    const target = callAt(index);\n    if (target) reveal(triggerIn(target, last));\n    else {\n      // A call that is not rendered renders first, then takes focus (the effect below).\n      setFocusChunk(Math.floor(index / CHUNK_CALLS));\n      setFocusTarget({ index, last });\n    }\n  };\n  useIsoLayoutEffect(() => {\n    if (focusTarget === undefined) return;\n    const target = callAt(focusTarget.index);\n    if (target) reveal(triggerIn(target, focusTarget.last));\n    setFocusTarget(undefined);\n  }, [focusTarget]);\n  useEffect(() => {\n    const list = listRef.current;\n    if (!list || !virtualized) return;\n    const onFocusIn = (event: FocusEvent) => {\n      // The top-level call, also for a trigger in one of its sub-agents.\n      const at = (event.target as Element).closest(`${CALL}[aria-posinset]`)?.getAttribute('aria-posinset');\n      if (at) setFocusChunk(Math.floor((Number(at) - 1) / CHUNK_CALLS));\n    };\n    // Only once focus has gone elsewhere on the page, not while the window is in the background.\n    const onFocusOut = (event: FocusEvent) => {\n      if (event.relatedTarget instanceof Node && !list.contains(event.relatedTarget)) setFocusChunk(undefined);\n    };\n    list.addEventListener('focusin', onFocusIn);\n    list.addEventListener('focusout', onFocusOut);\n    return () => {\n      list.removeEventListener('focusin', onFocusIn);\n      list.removeEventListener('focusout', onFocusOut);\n    };\n  }, [virtualized]);\n  // Until a call has rendered, a chunk that has not is as tall as this estimate allows.\n  useIsoLayoutEffect(() => {\n    if (!virtualized) return;\n    const height = observer.measure(0) / Math.min(CHUNK_CALLS, count);\n    if (height > 0 && Math.abs(height - callHeight) > 0.5) setCallHeight(height);\n    // Once, when a timeline becomes long: its first chunk's calls are rendered then.\n  }, [virtualized]);\n\n  const bars = waterfall && hydrated ? bounds : undefined;\n  // The waterfall's span reaches each rendered bar here rather than through the calls' props, or as a\n  // variable inherited from the list: either way, every time it grows (each tick of a running call)\n  // every call would render or restyle again. A long timeline's size reaches its rendered calls the\n  // same way, as it grows with each call. Written on every commit, so a call that just rendered has both.\n  useIsoLayoutEffect(() => {\n    const list = listRef.current;\n    if (!list) return;\n    const span = bars ? String(bars.span) : '';\n    for (const track of list.querySelectorAll<HTMLElement>(`[data-slot=\"${WATERFALL}\"]`))\n      if (track.style.getPropertyValue(SPAN) !== span) track.style.setProperty(SPAN, span);\n    const size = String(count);\n    for (const call of callItems()) {\n      if (!virtualized) call.removeAttribute('aria-setsize');\n      else if (call.getAttribute('aria-setsize') !== size) call.setAttribute('aria-setsize', size);\n    }\n  });\n\n  if (count === 0) return null;\n  const chunks: Array<[number, number]> = [];\n  for (let start = 0; start < count; start += CHUNK_CALLS) chunks.push([start, Math.min(count, start + CHUNK_CALLS)]);\n  const keepRendered = (part: ToolPart) =>\n    isOpen(part) ||\n    !isSettledPhase(getToolPhase(part)) ||\n    (level.subagents.get(part.toolCallId)?.some(isSubagentOpen) ?? false);\n\n  /** A call, and the sub-agents it started; `at` places a top-level call in a long timeline. */\n  const renderCall = (\n    part: ToolPart,\n    isLast: boolean,\n    subagents: Level['subagents'],\n    at?: { index: number; chunk: number },\n  ) => {\n    const timing = timings[part.toolCallId];\n    return (\n      <TimelineItem\n        key={part.toolCallId}\n        part={part}\n        meta={tools?.[getToolPartName(part)]}\n        byPerson={byPerson(part)}\n        timing={timing}\n        // Only a call still going reads the clock: the others keep their props, and their render.\n        clock={timing?.startedAt !== undefined && timing.endedAt === undefined ? clock : undefined}\n        interrupted={!active && isInterruptibleToolPart(part, failed)}\n        barsFrom={bars?.min}\n        hydrated={hydrated}\n        isLast={isLast}\n        open={isOpen(part)}\n        onOpenChange={onOpenChange}\n        extra={renderExtra?.(part)}\n        posInSet={virtualized && at ? at.index + 1 : undefined}\n        chunk={at?.chunk ?? 0}\n        observer={virtualized && at ? observer : undefined}\n        entering={entering}\n        subagents={subagents.get(part.toolCallId)?.map((subagent) => {\n          const open = isSubagentOpen(subagent);\n          const inner = open ? collectCalls(subagent.data.parts) : undefined;\n          return (\n            <SubagentGroup\n              key={subagent.data.subagentRunId}\n              part={subagent}\n              open={open}\n              onOpenChange={setSubagentOpen}\n              active={active}\n            >\n              {inner?.calls.map((call, i) => renderCall(call, i === inner.calls.length - 1, inner.subagents))}\n            </SubagentGroup>\n          );\n        })}\n      />\n    );\n  };\n\n  return (\n    <WithLabels labels={labels}>\n      <div\n        data-signoff\n        data-slot=\"signoff-tool-call-timeline\"\n        className={cn('font-signoff-sans text-signoff-fg @container', className)}\n        {...props}\n      >\n        {/* Arrow-key navigation between the disclosure buttons, as in the WAI-ARIA accordion pattern. */}\n        <ol ref={listRef} aria-label={label ?? T.list} onKeyDown={onKeyDown} className=\"relative flex flex-col\">\n          {chunks.map(([start, end], chunk) => (\n            <CallChunk\n              key={chunk}\n              chunk={chunk}\n              calls={end - start}\n              observer={virtualized ? observer : undefined}\n              initiallyNear={!initial.virtualized || chunk === 0 || chunk >= initial.chunks - 1}\n              pinned={chunk === focusChunk || toolParts.slice(start, end).some(keepRendered)}\n              callHeight={callHeight}\n            >\n              {() =>\n                toolParts\n                  .slice(start, end)\n                  .map((part, i) =>\n                    renderCall(part, start + i === count - 1, level.subagents, { index: start + i, chunk }),\n                  )\n              }\n            </CallChunk>\n          ))}\n        </ol>\n        {announce && <LiveRegion>{announced.text}</LiveRegion>}\n      </div>\n    </WithLabels>\n  );\n}\n\n/** A call waiting on a person's approval. */\nconst isWaiting = (part: ToolPart) => getToolPhase(part) === 'awaiting-approval';\n\n/** A call's phase as the timeline shows it: one a person answers waits on them, not on a tool. */\nconst phaseOf = (part: ToolPart, byPerson: boolean): ToolPhase =>\n  byPerson && part.state === 'input-available' ? 'awaiting-approval' : getToolPhase(part);\n\n/** Decided by a policy: without asking, or on the server's check after a person approved it. */\nconst deniedByPolicy = (part: ToolPart) => isAutomaticApproval(part.approval) || isDeniedAfterApproval(part);\n\n/** A call's waterfall bar; the list sets the waterfall's span in ms on each. */\nconst WATERFALL = 'signoff-tool-call-waterfall';\nconst SPAN = '--signoff-waterfall-span';\nconst START = '--signoff-call-start';\nconst END = '--signoff-call-end';\n/** Where a bar starts, as a percentage of the span; it is at least 2% wide, and stops at the end. */\nconst BAR_LEFT = `calc(var(${START}) / var(${SPAN}) * 100%)`;\nconst BAR_STYLE = {\n  left: BAR_LEFT,\n  width: `min(max(2%, calc((var(${END}) - var(${START})) / var(${SPAN}) * 100%)), calc(100% - ${BAR_LEFT}))`,\n};\n\n/**\n * A chunk of a timeline's calls: rendered near the viewport, pinned, or in a short timeline;\n * otherwise one empty item as tall as the calls were (or are estimated to be).\n */\nfunction CallChunk({\n  chunk,\n  calls,\n  observer,\n  initiallyNear,\n  pinned,\n  callHeight,\n  children,\n}: {\n  chunk: number;\n  calls: number;\n  /** Set when the timeline is long enough to render only what is near the screen. */\n  observer: CallObserver | undefined;\n  initiallyNear: boolean;\n  pinned: boolean;\n  callHeight: number;\n  children: () => ReactNode;\n}) {\n  const [nearState, setNear] = useState(initiallyNear);\n  const [height, setHeight] = useState<number>();\n  useIsoLayoutEffect(() => {\n    if (!observer) return;\n    if (typeof IntersectionObserver === 'undefined') {\n      setNear(true);\n      return;\n    }\n    return observer.listen(chunk, (near) => {\n      // Leaving: keep the height the calls had, for the empty item that stands in for them.\n      if (!near) {\n        const measured = observer.measure(chunk);\n        if (measured > 0) setHeight(measured);\n      }\n      setNear(near);\n    });\n  }, [observer, chunk]);\n  if (!observer || nearState || pinned) return children();\n  return <ChunkPlaceholder chunk={chunk} observer={observer} height={height ?? calls * callHeight} />;\n}\n\nfunction ChunkPlaceholder({ chunk, observer, height }: { chunk: number; observer: CallObserver; height: number }) {\n  const ref = useRef<HTMLLIElement>(null);\n  useIsoLayoutEffect(() => observer.observe(ref.current!, chunk), [observer, chunk]);\n  return <li ref={ref} aria-hidden=\"true\" data-slot=\"signoff-tool-call-chunk\" style={{ height }} />;\n}\n\n/** Which calls have rendered, for whether a call slides in when it renders. */\ntype Entering = ReturnType<typeof createEntering>;\n\nfunction createEntering(first: readonly string[]) {\n  let mounted = false;\n  const initial = new Set(first);\n  const seen = new Set<string>();\n  return {\n    /** The timeline's first render is done. */\n    mounted() {\n      mounted = true;\n    },\n    /** A call rendering now is new: at the first render or arriving after it, and not rendered before. */\n    isNew: (id: string) => !seen.has(id) && (!mounted || !initial.has(id)),\n    rendered(id: string) {\n      seen.add(id);\n    },\n  };\n}\n\ninterface TimelineItemProps {\n  part: ToolPart;\n  meta: ToolMeta | undefined;\n  /** A person answers the call (`pendingClientTools`): its time is theirs, so it shows none. */\n  byPerson: boolean;\n  timing: ToolTiming | undefined;\n  /**\n   * Current time while the run is active, when it stopped once inactive (undefined if unknown).\n   * Only for a call that has started and not ended: no other call reads it.\n   */\n  clock: number | undefined;\n  /** The run ended while this call was still preparing or running. */\n  interrupted: boolean;\n  /** The waterfall's start, when it shows: bars are placed from it. */\n  barsFrom: number | undefined;\n  isLast: boolean;\n  hydrated: boolean;\n  open: boolean;\n  onOpenChange: (part: ToolPart, open: boolean) => void;\n  extra: ReactNode;\n  /** In a long timeline: the call's place in the whole list (the list sets `aria-setsize`). */\n  posInSet: number | undefined;\n  chunk: number;\n  /** In a long timeline: what tells its chunk whether it is near the viewport. */\n  observer: CallObserver | undefined;\n  entering: Entering;\n  /** The sub-agents this call started, each a `SubagentGroup`. */\n  subagents?: ReactNode;\n}\n\n/** Memoized: in a long run, a new call or a running call's clock renders only the calls they change. */\nconst TimelineItem = memo(function TimelineItem({\n  part,\n  meta,\n  byPerson,\n  timing,\n  clock,\n  interrupted,\n  barsFrom,\n  isLast,\n  hydrated,\n  open,\n  onOpenChange,\n  extra,\n  posInSet,\n  chunk,\n  observer,\n  entering,\n  subagents,\n}: TimelineItemProps) {\n  const L = useLabels(LABELS);\n  const ref = useRef<HTMLLIElement>(null);\n  useIsoLayoutEffect(() => observer?.observe(ref.current!, chunk), [observer, chunk]);\n  const id = part.toolCallId;\n  const [enter] = useState(() => entering.isNew(id));\n  useEffect(() => entering.rendered(id), [entering, id]);\n  const name = getToolPartName(part);\n  const phase = phaseOf(part, byPerson);\n  const label = meta?.label ?? part.title ?? humanizeToolName(name);\n  // The SDK sets `input: undefined` until the first input delta arrives.\n  const summary =\n    part.input === undefined ? undefined : meta?.summary ? meta.summary(part.input, part) : summarizeValue(part.input);\n  const settled = isSettledPhase(phase) || interrupted;\n  // Live durations depend on the clock: render them only after hydration.\n  const end = timing?.endedAt ?? clock;\n  const duration = !byPerson && (settled || hydrated) && end !== undefined ? getDuration(timing, end) : undefined;\n\n  // Times from the waterfall's start, to keep the numbers small: some browsers compute CSS in floats.\n  // A call a person answers has none: its time is theirs.\n  const bar =\n    !byPerson && barsFrom !== undefined && timing?.startedAt && end !== undefined\n      ? ({ [START]: timing.startedAt - barsFrom, [END]: end - barsFrom } as CSSProperties)\n      : undefined;\n\n  return (\n    <li\n      ref={ref}\n      data-slot=\"signoff-tool-call\"\n      aria-posinset={posInSet}\n      data-phase={phase}\n      data-state={part.state}\n      data-interrupted={interrupted || undefined}\n      className={cn(\n        'group/item relative grid grid-cols-[1.5rem_minmax(0,1fr)] gap-x-3',\n        enter && 'motion-safe:animate-signoff-enter',\n      )}\n    >\n      {!isLast && (\n        <span\n          aria-hidden=\"true\"\n          className={cn(\n            'absolute top-7 bottom-0 left-[11.5px] w-px',\n            settled ? 'bg-signoff-border-strong' : 'from-signoff-accent/50 to-signoff-border bg-gradient-to-b',\n          )}\n        />\n      )}\n      {/* Decorative: the trigger spells out the state (\"Needs approval\"), so the node's \"!\" is not read. */}\n      <div aria-hidden=\"true\" className=\"pt-1.5\">\n        <StatusNode phase={phase} interrupted={interrupted} />\n      </div>\n      <Collapsible.Root\n        open={open}\n        onOpenChange={(next) => onOpenChange(part, next)}\n        className={cn('min-w-0', isLast ? 'pb-0' : 'pb-2')}\n      >\n        <Collapsible.Trigger data-slot=\"signoff-tool-call-trigger\" className={TRIGGER}>\n          {meta?.icon && (\n            <span aria-hidden=\"true\" className=\"text-signoff-fg-subtle flex shrink-0 [&_svg]:size-3.5\">\n              {meta.icon}\n            </span>\n          )}\n          {/* Truncates rather than pushing the row past a narrow container; the full name stays in the button's. */}\n          <span className={NAME}>{label}</span>\n          {summary !== undefined && summary !== null && summary !== '' && (\n            // In narrow containers the summary is visually hidden but stays in the button's accessible name.\n            <span className=\"font-signoff-mono text-signoff-fg-muted sr-only min-w-0 text-xs @md:not-sr-only @md:truncate\">\n              {summary}\n            </span>\n          )}\n          <span className=\"ml-auto flex shrink-0 items-center gap-2.5 pl-2\">\n            <span\n              className={cn(\n                'text-xs font-medium',\n                interrupted ? 'text-signoff-fg-subtle' : PHASE_TEXT[phase],\n                phase === 'success' && 'sr-only',\n              )}\n            >\n              {interrupted ? L.toolCallTimeline.stopped : L.toolCallTimeline.phases[phase]}\n            </span>\n            {bar && (\n              <span\n                aria-hidden=\"true\"\n                data-slot={WATERFALL}\n                className=\"bg-signoff-surface-2 relative hidden h-1 w-16 overflow-hidden rounded-full @sm:block\"\n                style={bar}\n              >\n                <span\n                  className={cn(\n                    'absolute inset-y-0 rounded-full',\n                    phase === 'error' || phase === 'awaiting-approval'\n                      ? 'bg-signoff-hot'\n                      : settled\n                        ? 'bg-signoff-fg-subtle/70'\n                        : 'bg-signoff-accent',\n                  )}\n                  style={BAR_STYLE}\n                />\n              </span>\n            )}\n            <span className=\"font-signoff-mono text-signoff-fg-subtle w-12 text-right text-[11px] tabular-nums\">\n              {duration !== undefined && phase !== 'awaiting-approval' ? L.format.duration(duration) : ''}\n            </span>\n            <ChevronIcon size={14} className={CHEVRON} />\n          </span>\n        </Collapsible.Trigger>\n        {part.state === 'output-error' && !open && <p className={ERROR_LINE}>{part.errorText}</p>}\n        <Collapsible.Content className={CONTENT}>\n          <ToolCallDetails part={part} meta={meta} />\n        </Collapsible.Content>\n        {extra && (\n          <div className=\"mt-2 mb-1 pl-2\" data-signoff-slot>\n            {extra}\n          </div>\n        )}\n        {subagents}\n      </Collapsible.Root>\n    </li>\n  );\n});\n\n/**\n * A sub-agent under the call that started it: its name, how many calls it made and where it is, as\n * a disclosure button that shows its calls. Collapsed until opened; with no calls, just the row.\n */\nfunction SubagentGroup({\n  part,\n  open,\n  onOpenChange,\n  active,\n  children,\n}: {\n  part: SubagentPart;\n  open: boolean;\n  onOpenChange: (id: string, open: boolean) => void;\n  active: boolean;\n  children: ReactNode;\n}) {\n  const T = useLabels(LABELS).toolCallTimeline;\n  const { subagentRunId: id, name, status, errorText } = part.data;\n  const calls = getAllToolParts(part.data.parts);\n  const count = collectCalls(part.data.parts).calls.length;\n  const waiting = calls.some(isWaiting);\n  // A run that ended while it worked stopped it, as it stops a running call.\n  const stopped = !waiting && status === 'running' && !active;\n  const still = stopped || (!waiting && status === 'suspended');\n  const phase: ToolPhase = waiting\n    ? 'awaiting-approval'\n    : status === 'done'\n      ? 'success'\n      : status === 'error'\n        ? 'error'\n        : 'running';\n  const label = name || T.subagent.name;\n  const row = (\n    <>\n      <span className={NAME}>{label}</span>\n      <span className=\"font-signoff-mono text-signoff-fg-muted shrink-0 text-xs\">{T.subagent.calls(count)}</span>\n      <span className=\"ml-auto flex shrink-0 items-center gap-2.5 pl-2\">\n        <span\n          className={cn(\n            'text-xs font-medium',\n            still ? 'text-signoff-fg-subtle' : PHASE_TEXT[phase],\n            phase === 'success' && 'sr-only',\n          )}\n        >\n          {stopped ? T.stopped : still ? T.subagent.paused : T.phases[phase]}\n        </span>\n        {count > 0 && <ChevronIcon size={14} className={CHEVRON} />}\n      </span>\n    </>\n  );\n  const error = status === 'error' && errorText && <p className={ERROR_LINE}>{errorText}</p>;\n  return (\n    <div\n      data-slot=\"signoff-subagent\"\n      data-status={status}\n      data-interrupted={stopped || undefined}\n      className=\"mt-1 grid grid-cols-[1.5rem_minmax(0,1fr)] gap-x-3\"\n    >\n      {/* Decorative, as a call's: the row says the state. */}\n      <div aria-hidden=\"true\" className=\"pt-1.5\">\n        <StatusNode phase={phase} interrupted={still} />\n      </div>\n      {count === 0 ? (\n        <div className=\"min-w-0\">\n          <div className=\"flex min-w-0 items-center gap-2.5 px-2 py-1.5\">{row}</div>\n          {error}\n        </div>\n      ) : (\n        <Collapsible.Root open={open} onOpenChange={(next) => onOpenChange(id, next)} className=\"min-w-0\">\n          <Collapsible.Trigger data-slot=\"signoff-subagent-trigger\" className={TRIGGER}>\n            {row}\n          </Collapsible.Trigger>\n          {error}\n          <Collapsible.Content className={CONTENT}>\n            <ol aria-label={T.subagent.list(label)} className=\"relative mt-1 flex flex-col\">\n              {children}\n            </ol>\n          </Collapsible.Content>\n        </Collapsible.Root>\n      )}\n    </div>\n  );\n}\n\n/** The expanded body of a tool call: input, output or error, and approval outcome. */\nexport function ToolCallDetails({\n  part,\n  meta,\n  labels,\n}: {\n  part: ToolPart;\n  meta?: ToolMeta | undefined;\n  /** Words to use instead of the English defaults: see `SignoffLabelsProvider`. */\n  labels?: SignoffLabelsInput | undefined;\n}) {\n  const T = useLabels(LABELS, labels).toolCallTimeline;\n  const hasInput = part.input !== undefined;\n  const sectionLabel =\n    'mb-1.5 font-signoff-mono text-[10.5px] font-medium tracking-[0.08em] text-signoff-fg-subtle uppercase';\n  return (\n    <div data-signoff data-slot=\"signoff-tool-call-details\" className=\"flex flex-col gap-3 px-2 pt-1.5 pb-3\">\n      {hasInput && (\n        <div>\n          <div className={sectionLabel}>{part.state === 'input-streaming' ? T.inputStreaming : T.input}</div>\n          <JsonView value={part.input} label={T.input} />\n        </div>\n      )}\n      {part.state === 'output-available' && (\n        <div>\n          <div className={sectionLabel}>{part.preliminary ? T.outputPartial : T.output}</div>\n          {meta?.renderOutput ? (\n            <div data-signoff-slot>{meta.renderOutput(part.output, part)}</div>\n          ) : (\n            <JsonView value={part.output} label={T.output} />\n          )}\n        </div>\n      )}\n      {part.state === 'output-error' && (\n        <div>\n          <div className={sectionLabel}>{T.error}</div>\n          <p className=\"border-signoff-hot/35 bg-signoff-hot/[0.07] font-signoff-mono text-signoff-fg rounded-lg border px-3 py-2 text-xs leading-5 break-words whitespace-pre-wrap\">\n            {part.errorText}\n          </p>\n        </div>\n      )}\n      {(part.state === 'output-denied' || (part.state === 'approval-responded' && !part.approval.approved)) && (\n        <p className=\"text-signoff-fg-muted text-xs\">\n          {T.deniedBy(deniedByPolicy(part))}\n          {part.approval.reason ? (\n            <>\n              : <span className=\"text-signoff-fg\">{part.approval.reason}</span>\n            </>\n          ) : (\n            '.'\n          )}\n        </p>\n      )}\n      {!hasInput && part.state === 'input-streaming' && (\n        <p className=\"text-signoff-fg-subtle text-xs\">{T.waitingForInput}</p>\n      )}\n    </div>\n  );\n}\n",
      "type": "registry:component",
      "target": "components/signoff-ui/tool-call-timeline.tsx"
    },
    {
      "path": "packages/signoff-ui/src/use-approval-policy.ts",
      "content": "'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport {\n  decisionEffect,\n  evaluateRules,\n  ruleFromDecision,\n  toPlainRules,\n  type ApprovalDecision,\n  type ApprovalRequest,\n  type ApprovalRule,\n  type RuleMatch,\n} from './lib/policy';\nimport { approvalPolicyLabels, type SignoffLabelsInput } from './lib/labels';\nimport { useLabels } from './labels';\n\n/** The labels' sections this module reads. */\nconst LABELS = { approvalPolicy: approvalPolicyLabels };\n\nexport type { ApprovalDecision, ApprovalRequest, ApprovalRule, RuleMatch } from './lib/policy';\n\n/**\n * Where `always` rules are kept between visits. Session rules are never saved, and nor is a rule\n * with a `when`: `when` is code, and without it the rule would cover more calls than it does.\n */\nexport interface ApprovalRuleStorage {\n  /** The saved rules, read once, after the first render. It may return a promise. */\n  load(): readonly ApprovalRule[] | PromiseLike<readonly ApprovalRule[]>;\n  /**\n   * Keep these rules, in place of the ones saved before: the `always` rules without a `when`, after\n   * each change. It may return a promise, which nothing waits for.\n   */\n  save(rules: readonly ApprovalRule[]): void | PromiseLike<void>;\n  /**\n   * The ids of `always` default rules the person removed, so they stay removed on the next load.\n   * Optional: without this and `saveRemovedDefaults`, a removed default comes back on each load.\n   */\n  loadRemovedDefaults?(): readonly string[] | PromiseLike<readonly string[]>;\n  /**\n   * Keep the ids of the `always` defaults the person removed, after a change to them. Optional, with\n   * `loadRemovedDefaults`.\n   */\n  saveRemovedDefaults?(ids: readonly string[]): void | PromiseLike<void>;\n}\n\n/** Rules kept in memory, for this page only: the default. */\nexport function memoryRuleStorage(initial: readonly ApprovalRule[] = []): ApprovalRuleStorage {\n  let rules = [...initial];\n  let removed: string[] = [];\n  return {\n    load: () => rules,\n    save: (next) => {\n      rules = [...next];\n    },\n    loadRemovedDefaults: () => removed,\n    saveRemovedDefaults: (ids) => {\n      removed = [...ids];\n    },\n  };\n}\n\n/**\n * Rules kept in `localStorage` (or another `Storage`) as JSON under `key`, and the ids of default\n * rules the person removed under `<key>:removed-defaults`. A rule with a `when` is not kept: JSON\n * can't hold the code. Nothing is read or written on the server.\n */\nexport function webStorageRules(\n  key = 'signoff-ui:approval-rules',\n  storage: () => Storage | undefined = () => (typeof window === 'undefined' ? undefined : window.localStorage),\n): ApprovalRuleStorage {\n  const read = (name: string): unknown[] => {\n    try {\n      const text = storage()?.getItem(name);\n      const parsed: unknown = text ? JSON.parse(text) : [];\n      return Array.isArray(parsed) ? parsed : [];\n    } catch {\n      return [];\n    }\n  };\n  const write = (name: string, value: unknown) => {\n    try {\n      storage()?.setItem(name, JSON.stringify(value));\n    } catch {\n      // Full or blocked storage: the rules still hold for this page.\n    }\n  };\n  const removedKey = `${key}:removed-defaults`;\n  return {\n    load: () => read(key).filter(isRule),\n    // Not a rule with a `when`: JSON would keep it without the `when`, covering more calls.\n    save: (rules) =>\n      write(\n        key,\n        rules.filter((rule) => !rule.when),\n      ),\n    loadRemovedDefaults: () => read(removedKey).filter((id): id is string => typeof id === 'string'),\n    saveRemovedDefaults: (ids) => write(removedKey, ids),\n  };\n}\n\nfunction isRule(value: unknown): value is ApprovalRule {\n  if (!value || typeof value !== 'object') return false;\n  const rule = value as Partial<ApprovalRule>;\n  return (\n    typeof rule.id === 'string' &&\n    typeof rule.tool === 'string' &&\n    (rule.effect === 'allow' || rule.effect === 'deny') &&\n    (rule.scope === 'session' || rule.scope === 'always') &&\n    (rule.args === undefined ||\n      (!!rule.args &&\n        typeof rule.args === 'object' &&\n        !Array.isArray(rule.args) &&\n        Object.values(rule.args).every((v) => typeof v === 'string')))\n  );\n}\n\n/** Everything the policy did, for an audit trail. */\nexport type ApprovalAuditEvent =\n  | {\n      type: 'decision';\n      at: number;\n      request: ApprovalRequest;\n      decision: ApprovalDecision;\n      /** A person decided, or one of the rules did. */\n      by: 'user' | 'rule';\n      /** The rule that decided, or the one this decision made. */\n      rule?: ApprovalRule | undefined;\n      reason?: string | undefined;\n      /** The arguments as approved, when the person edited them. */\n      input?: unknown;\n    }\n  | { type: 'rule-added' | 'rule-removed'; at: number; rule: ApprovalRule }\n  | { type: 'session-cleared'; at: number; rules: ApprovalRule[] };\n\n/** A decision, ready to send: `approved` and `reason` for the agent, the rest for your app. */\nexport interface ApprovalOutcome {\n  /** The request's `id`: the approval this answers. */\n  id: string;\n  /** Whether the call may run. */\n  approved: boolean;\n  /**\n   * Why, for the agent: the reason the person gave, or for a deny rule its own `reason`, else\n   * `labels.approvalPolicy.ruleDenial`.\n   */\n  reason?: string | undefined;\n  /** The arguments to run with, when the person edited them. */\n  input?: unknown;\n  /**\n   * What was decided, and for how long. A rule's answer is `allow-session` or `allow-always`, after\n   * the rule's scope, or `deny-always`.\n   */\n  decision: ApprovalDecision;\n  /** Who decided: the person (`user`) or one of the rules (`rule`). */\n  by: 'user' | 'rule';\n  /** The rule that decided, or the one the person's session or always decision made. */\n  rule?: ApprovalRule | undefined;\n}\n\n/** What `useApprovalPolicy` takes: the rules, where they are kept, and what to call as they change. */\nexport interface UseApprovalPolicyOptions {\n  /**\n   * Controlled rules: the policy decides with these, and hands every change to `onRulesChange` for\n   * you to pass back. Without them, it keeps its own.\n   */\n  rules?: readonly ApprovalRule[] | undefined;\n  /**\n   * Rules to start with, before any the storage loads. An `always` default the person removes stays\n   * removed on later loads, with a storage that keeps removed defaults (`webStorageRules` and\n   * `memoryRuleStorage` do). A default you add later appears, removed ones aside.\n   * @default []\n   */\n  defaultRules?: readonly ApprovalRule[] | undefined;\n  /**\n   * The rules after each change: a session or always decision, `addRule`, `removeRule` or\n   * `clearSession`, not the storage loading. With `rules`, set them from it.\n   */\n  onRulesChange?: ((rules: ApprovalRule[]) => void) | undefined;\n  /** Where `always` rules are loaded from and saved to. Default: memory, for this page. */\n  storage?: ApprovalRuleStorage | undefined;\n  /** Every decision, rule added or removed, and session cleared, as it happens. */\n  onAudit?: ((event: ApprovalAuditEvent) => void) | undefined;\n  /**\n   * Words to use instead of the English defaults: the reason a deny rule without one of its own\n   * sends (`labels.approvalPolicy.ruleDenial`). See `SignoffLabelsProvider`.\n   */\n  labels?: SignoffLabelsInput | undefined;\n}\n\n/**\n * What `useApprovalPolicy` returns: the rules, and what records a decision or answers a call from\n * them. Pass it to `ToolApprovalCard`, `AgentMessage` or `ToolApprovalBatch` as their policy.\n */\nexport interface ApprovalPolicy {\n  /**\n   * The rules as of this render: `rules` when you control them, else the defaults, the rules the\n   * storage loaded and the ones added since.\n   */\n  rules: readonly ApprovalRule[];\n  /**\n   * The rules as they are now, as plain data to send with a request (see `toPlainRules`: a rule\n   * with a `when` stays on the page, and a deny one keeps back the allow rules it would overrule,\n   * so the server asks about those calls). The same function for the policy's life, so a transport\n   * made once can call it in `body`, and it has a rule a decision just made before the page re-renders.\n   */\n  getRules(): ApprovalRule[];\n  /** The storage has loaded: after the first render, or once an async storage's promise settles. */\n  ready: boolean;\n  /** The rule that decides a call, if one does. */\n  match(toolName: string, input: unknown): RuleMatch | undefined;\n  /**\n   * Record a person's decision and the rule it leaves (for session and always decisions, over the\n   * call's `args` when given, else every call of the tool), and return it ready to send.\n   */\n  decide(\n    request: ApprovalRequest,\n    decision: ApprovalDecision,\n    options?: { reason?: string | undefined; input?: unknown; args?: Record<string, string> | undefined },\n  ): ApprovalOutcome;\n  /**\n   * Answer a request from the rules, if one matches, recorded as decided by that rule. A request it\n   * answered before, or a person decided, gets the same outcome while its tool and input are the\n   * ones answered (or the edit the person approved); another call with that id is decided again.\n   */\n  answer(request: ApprovalRequest): ApprovalOutcome | undefined;\n  /** How an answered request was decided, by its id: by a person or by which rule. */\n  outcomeOf(id: string): ApprovalOutcome | undefined;\n  /**\n   * Add a rule, in place of one with the same id, and save it if it is an `always` rule without a\n   * `when`. A removed default's id brings that default back, as a \"Reset\" button would.\n   */\n  addRule(rule: ApprovalRule): void;\n  /**\n   * Remove the rule with this id. An `always` default stays removed on later loads, with a storage\n   * that keeps removed defaults.\n   */\n  removeRule(id: string): void;\n  /** Forget the session rules. */\n  clearSession(): void;\n}\n\n/**\n * Approval rules, held for the page: once, for the session or always, scoped by tool and by\n * argument patterns, deny winning over allow. Pass the policy to `ToolApprovalCard`, `AgentMessage`\n * or `ToolApprovalBatch`, and they offer the choices, answer what a rule already decides, and record\n * the rest. Persistence is pluggable: `always` rules go to `storage`, session rules stay in memory.\n */\nexport function useApprovalPolicy({\n  rules: rulesProp,\n  defaultRules = [],\n  onRulesChange,\n  storage: storageProp,\n  onAudit,\n  labels,\n}: UseApprovalPolicyOptions = {}): ApprovalPolicy {\n  const ruleDenial = useLabels(LABELS, labels).approvalPolicy.ruleDenial;\n  const [fallbackStorage] = useState(() => memoryRuleStorage());\n  const storage = storageProp ?? fallbackStorage;\n  // The storage is read after the first render, on the client: a server render and the hydrating\n  // client then agree, whatever is stored.\n  const [own, setOwn] = useState<readonly ApprovalRule[]>(defaultRules);\n  const [ready, setReady] = useState(false);\n  const rules = rulesProp ?? own;\n  // The latest rules for handlers that run before a re-render, such as two answers in one tick, or\n  // effects that run before this hook's own, as a child's do. Each change sets them as it happens, so\n  // a render never sets them back; rules passed in replace them when they change.\n  const latest = useRef(rules);\n  const controlled = useRef(rulesProp !== undefined);\n  useEffect(() => {\n    controlled.current = rulesProp !== undefined;\n    if (rulesProp !== undefined) latest.current = rulesProp;\n  }, [rulesProp]);\n  const outcomes = useRef(new Map<string, ApprovalOutcome>());\n  // The call each outcome answers, by id: its tool, and the input asked about and the one approved.\n  const calls = useRef(new Map<string, { toolName: string; inputs: unknown[] }>());\n  // The ids of `always` defaults the person removed, as last loaded or saved.\n  const removedDefaults = useRef<readonly string[]>([]);\n  // Until the storage has loaded, the rules changed meanwhile, by id (`undefined`: removed). Saving\n  // them then would replace the rules it holds, so they go over the rules it loads, and are saved\n  // with them.\n  const early = useRef<Map<string, ApprovalRule | undefined> | undefined>(new Map());\n  const flush = useRef(false);\n\n  const save = (next: readonly ApprovalRule[]) => {\n    // A rule with a `when` stays in memory: saved, it would load without it.\n    void storage.save(next.filter((r) => r.scope === 'always' && !r.when));\n    if (storage.saveRemovedDefaults) {\n      // An `always` default missing from the rules was removed; one that is back was restored.\n      const kept = new Set(next.map((r) => r.id));\n      const defaults = defaultRules.filter((r) => r.scope === 'always').map((r) => r.id);\n      const removed = [...new Set([...removedDefaults.current, ...defaults])].filter((id) => !kept.has(id));\n      if (removed.join('\\n') !== removedDefaults.current.join('\\n')) {\n        removedDefaults.current = removed;\n        void storage.saveRemovedDefaults(removed);\n      }\n    }\n  };\n\n  // Loaded once, from the storage the policy started with: an inline storage object (a new one on\n  // every render) does not reload it. Saves go to the current one.\n  const [loadFrom] = useState(storage);\n  useEffect(() => {\n    // Run again once it has loaded, as StrictMode does: loading again would put the saved rules back\n    // over the changes made before, and drop their save.\n    if (!early.current) return;\n    let live = true;\n    const apply = ([loaded, removed]: readonly [readonly ApprovalRule[], readonly string[]]) => {\n      if (!live) return;\n      removedDefaults.current = removed;\n      const changes = early.current ?? new Map<string, ApprovalRule | undefined>();\n      early.current = undefined;\n      flush.current = changes.size > 0;\n      // The defaults, less the ones the person removed, then the saved rules, which win, then the\n      // changes made before they loaded. In `latest` now: a change made in the effects of the render\n      // this causes, such as a child's waiting for `ready`, builds on them.\n      const gone = new Set(removed);\n      const current = latest.current;\n      const next = over(merge(gone.size ? current.filter((r) => !gone.has(r.id)) : current, loaded), changes);\n      if (!controlled.current) latest.current = next;\n      setOwn(next);\n      setReady(true);\n    };\n    const loaded = loadFrom.load();\n    const removed = loadFrom.loadRemovedDefaults?.() ?? [];\n    if (isThenable(loaded) || isThenable(removed)) {\n      // Removed defaults that fail to load leave the defaults as they are; the saved rules still load.\n      const removedOrNone = Promise.resolve(removed).then(undefined, () => []);\n      Promise.all([loaded, removedOrNone]).then(apply, () => apply([[], []]));\n    } else apply([loaded, removed]);\n    return () => {\n      live = false;\n    };\n  }, [loadFrom]);\n  // The changes made before the storage loaded, saved with the rules it loaded once they have\n  // rendered, to the storage of that render.\n  useEffect(() => {\n    if (!flush.current || !ready) return;\n    flush.current = false;\n    save(latest.current);\n  });\n\n  const audit = (event: ApprovalAuditEvent) => onAudit?.(event);\n  const setRules = (next: ApprovalRule[]) => {\n    const changes = early.current;\n    if (changes) {\n      const kept = new Set(next.map((r) => r.id));\n      for (const rule of latest.current) if (!kept.has(rule.id)) changes.set(rule.id, undefined);\n      for (const rule of next) if (!latest.current.includes(rule)) changes.set(rule.id, rule);\n    }\n    latest.current = next;\n    if (rulesProp === undefined) setOwn(next);\n    onRulesChange?.(next);\n    if (!changes) save(next);\n  };\n\n  const record = (outcome: ApprovalOutcome) => {\n    outcomes.current.set(outcome.id, outcome);\n    return outcome;\n  };\n  const answers = ({ id, toolName, input }: ApprovalRequest, edited?: unknown) =>\n    calls.current.set(id, { toolName, inputs: edited === undefined ? [input] : [input, edited] });\n  const getRules = useCallback(() => toPlainRules(latest.current), []);\n\n  return {\n    rules,\n    getRules,\n    ready,\n    match: (toolName, input) => evaluateRules(latest.current, toolName, input),\n    decide(request, decision, { reason, input, args } = {}) {\n      const rule = ruleFromDecision(decision, request, { args, reason });\n      if (rule) {\n        setRules([...latest.current, rule]);\n        audit({ type: 'rule-added', at: Date.now(), rule });\n      }\n      const { approved } = decisionEffect(decision);\n      audit({\n        type: 'decision',\n        at: Date.now(),\n        request,\n        decision,\n        by: 'user',\n        rule,\n        ...(reason ? { reason } : {}),\n        ...(input !== undefined ? { input } : {}),\n      });\n      answers(request, input);\n      return record({\n        id: request.id,\n        approved,\n        ...(reason ? { reason } : {}),\n        ...(input !== undefined ? { input } : {}),\n        decision,\n        by: 'user',\n        rule,\n      });\n    },\n    answer(request) {\n      const known = outcomes.current.get(request.id);\n      const call = calls.current.get(request.id);\n      // The outcome it gave, for the call it answered: another call with the same id is decided again.\n      if (known && call?.toolName === request.toolName && call.inputs.some((input) => sameInput(input, request.input)))\n        return known;\n      const match = evaluateRules(latest.current, request.toolName, request.input);\n      if (!match) return undefined;\n      const decision: ApprovalDecision =\n        match.effect === 'allow' ? (match.rule.scope === 'session' ? 'allow-session' : 'allow-always') : 'deny-always';\n      // A rule that ran out before it could tell (`unchecked`) didn't find what its reason is about.\n      const reason =\n        match.effect === 'deny' ? ((match.unchecked ? undefined : match.rule.reason) ?? ruleDenial) : undefined;\n      audit({ type: 'decision', at: Date.now(), request, decision, by: 'rule', rule: match.rule, reason });\n      answers(request);\n      return record({\n        id: request.id,\n        approved: match.effect === 'allow',\n        ...(reason ? { reason } : {}),\n        decision,\n        by: 'rule',\n        rule: match.rule,\n      });\n    },\n    outcomeOf: (id) => outcomes.current.get(id),\n    addRule(rule) {\n      setRules([...latest.current.filter((r) => r.id !== rule.id), rule]);\n      audit({ type: 'rule-added', at: Date.now(), rule });\n    },\n    removeRule(id) {\n      const rule = latest.current.find((r) => r.id === id);\n      if (!rule) return;\n      setRules(latest.current.filter((r) => r.id !== id));\n      audit({ type: 'rule-removed', at: Date.now(), rule });\n    },\n    clearSession() {\n      const session = latest.current.filter((r) => r.scope === 'session');\n      if (session.length === 0) return;\n      setRules(latest.current.filter((r) => r.scope !== 'session'));\n      audit({ type: 'session-cleared', at: Date.now(), rules: session });\n    },\n  };\n}\n\nfunction isThenable(value: unknown): value is PromiseLike<unknown> {\n  return !!value && typeof (value as { then?: unknown }).then === 'function';\n}\n\n/**\n * Whether two inputs are one call's: the same value, or the same as JSON. The policy keeps the\n * inputs it answered, not a copy of each as text. Input JSON can't write, such as a cycle, is the\n * same only as itself.\n */\nfunction sameInput(answered: unknown, input: unknown): boolean {\n  if (answered === input) return true;\n  try {\n    const text = JSON.stringify(answered);\n    return text !== undefined && text === JSON.stringify(input);\n  } catch {\n    return false;\n  }\n}\n\n/** Rules with changes by id over them: a rule in place of the one with its id, or after them; `undefined` removes it. */\nfunction over(rules: ApprovalRule[], changes: ReadonlyMap<string, ApprovalRule | undefined>): ApprovalRule[] {\n  if (!changes.size) return rules;\n  const byId = new Map(rules.map((r) => [r.id, r]));\n  for (const [id, rule] of changes) {\n    if (rule) byId.set(id, rule);\n    else byId.delete(id);\n  }\n  return [...byId.values()];\n}\n\n/**\n * Rules from both lists, the later one winning for an id that repeats, but not over a rule with a\n * `when`: an earlier version saved such a rule without it.\n */\nfunction merge(first: readonly ApprovalRule[], second: readonly ApprovalRule[]): ApprovalRule[] {\n  const byId = new Map(first.map((r) => [r.id, r]));\n  for (const rule of second) if (!byId.get(rule.id)?.when) byId.set(rule.id, rule);\n  return [...byId.values()];\n}\n",
      "type": "registry:component",
      "target": "components/signoff-ui/use-approval-policy.ts"
    }
  ],
  "cssVars": {
    "theme": {
      "color-signoff-bg": "var(--signoff-bg)",
      "color-signoff-surface": "var(--signoff-surface)",
      "color-signoff-surface-2": "var(--signoff-surface-2)",
      "color-signoff-border": "var(--signoff-border)",
      "color-signoff-border-strong": "var(--signoff-border-strong)",
      "color-signoff-fg": "var(--signoff-fg)",
      "color-signoff-fg-muted": "var(--signoff-fg-muted)",
      "color-signoff-fg-subtle": "var(--signoff-fg-subtle)",
      "color-signoff-accent": "var(--signoff-accent)",
      "color-signoff-accent-fg": "var(--signoff-accent-fg)",
      "color-signoff-on-accent": "var(--signoff-on-accent)",
      "color-signoff-hot": "var(--signoff-hot)",
      "color-signoff-hot-fg": "var(--signoff-hot-fg)",
      "color-signoff-on-hot": "var(--signoff-on-hot)",
      "color-signoff-warn": "var(--signoff-warn)",
      "color-signoff-warn-fg": "var(--signoff-warn-fg)",
      "color-signoff-ring": "var(--signoff-ring)",
      "color-signoff-add": "var(--signoff-add-bg)",
      "color-signoff-add-strong": "var(--signoff-add-strong)",
      "color-signoff-del": "var(--signoff-del-bg)",
      "color-signoff-del-strong": "var(--signoff-del-strong)",
      "color-signoff-chart-input": "var(--signoff-chart-input)",
      "color-signoff-chart-output": "var(--signoff-chart-output)",
      "color-signoff-code-keyword": "var(--signoff-code-keyword)",
      "color-signoff-code-string": "var(--signoff-code-string)",
      "color-signoff-code-number": "var(--signoff-code-number)",
      "color-signoff-code-comment": "var(--signoff-code-comment)",
      "color-signoff-code-punctuation": "var(--signoff-code-punctuation)",
      "radius-signoff": "var(--signoff-radius)",
      "font-signoff-sans": "var(--signoff-font-sans)",
      "font-signoff-mono": "var(--signoff-font-mono)",
      "animate-signoff-shimmer": "signoff-shimmer 2.2s linear infinite",
      "animate-signoff-ping": "signoff-ping 1.6s cubic-bezier(0, 0, 0.2, 1) infinite",
      "animate-signoff-spin": "signoff-spin 0.9s linear infinite",
      "animate-signoff-blink": "signoff-blink 1.1s steps(2, start) infinite",
      "animate-signoff-enter": "signoff-enter 0.32s cubic-bezier(0.2, 0.7, 0.2, 1) backwards",
      "animate-signoff-indeterminate": "signoff-indeterminate 1.4s ease-in-out infinite",
      "animate-signoff-expand": "signoff-expand 0.22s cubic-bezier(0.2, 0.7, 0.2, 1)",
      "animate-signoff-collapse": "signoff-collapse 0.18s ease-in"
    },
    "light": {
      "signoff-bg": "#ffffff",
      "signoff-surface": "#f6f7f9",
      "signoff-surface-2": "#eef0f3",
      "signoff-border": "#e2e5ea",
      "signoff-border-strong": "#cdd2d9",
      "signoff-fg": "#0d0f12",
      "signoff-fg-muted": "#4b5563",
      "signoff-fg-subtle": "#5f6875",
      "signoff-accent": "#0e7490",
      "signoff-accent-fg": "#155e75",
      "signoff-on-accent": "#ffffff",
      "signoff-hot": "#be185d",
      "signoff-hot-fg": "#9d174d",
      "signoff-on-hot": "#ffffff",
      "signoff-warn": "#b45309",
      "signoff-warn-fg": "#92400e",
      "signoff-ring": "#0e7490",
      "signoff-add-bg": "rgb(8 145 178 / 0.08)",
      "signoff-add-strong": "rgb(8 145 178 / 0.16)",
      "signoff-del-bg": "rgb(190 24 93 / 0.07)",
      "signoff-del-strong": "rgb(190 24 93 / 0.14)",
      "signoff-chart-input": "#0891b2",
      "signoff-chart-output": "#db2777",
      "signoff-code-keyword": "#155e75",
      "signoff-code-string": "#9a3412",
      "signoff-code-number": "#9d174d",
      "signoff-code-comment": "#525b67",
      "signoff-code-punctuation": "#4b5563",
      "signoff-radius": "0.75rem",
      "signoff-font-sans": "var(--font-sans, var(--font-geist-sans, ui-sans-serif, system-ui, sans-serif))",
      "signoff-font-mono": "var(--font-mono, var(--font-geist-mono, ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace))"
    },
    "dark": {
      "signoff-bg": "#0d0f12",
      "signoff-surface": "#181c22",
      "signoff-surface-2": "#1e232a",
      "signoff-border": "#262b33",
      "signoff-border-strong": "#353c47",
      "signoff-fg": "#e8eaed",
      "signoff-fg-muted": "#a1a9b4",
      "signoff-fg-subtle": "#8b94a0",
      "signoff-accent": "#22d3ee",
      "signoff-accent-fg": "#67e8f9",
      "signoff-on-accent": "#0d0f12",
      "signoff-hot": "#f0468a",
      "signoff-hot-fg": "#f472a8",
      "signoff-on-hot": "#0d0f12",
      "signoff-warn": "#fbbf24",
      "signoff-warn-fg": "#fcd34d",
      "signoff-ring": "#67e8f9",
      "signoff-add-bg": "rgb(34 211 238 / 0.08)",
      "signoff-add-strong": "rgb(34 211 238 / 0.14)",
      "signoff-del-bg": "rgb(240 70 138 / 0.08)",
      "signoff-del-strong": "rgb(240 70 138 / 0.26)",
      "signoff-chart-input": "#11a2bc",
      "signoff-chart-output": "#f0468a",
      "signoff-code-keyword": "#67e8f9",
      "signoff-code-string": "#f5c27a",
      "signoff-code-number": "#f9a8d4",
      "signoff-code-comment": "#a1a9b4",
      "signoff-code-punctuation": "#a1a9b4"
    }
  },
  "css": {
    "@keyframes signoff-shimmer": {
      "from": {
        "background-position": "200% 0"
      },
      "to": {
        "background-position": "-200% 0"
      }
    },
    "@keyframes signoff-ping": {
      "0%": {
        "transform": "scale(1)",
        "opacity": "0.7"
      },
      "80%, 100%": {
        "transform": "scale(2.2)",
        "opacity": "0"
      }
    },
    "@keyframes signoff-spin": {
      "to": {
        "transform": "rotate(360deg)"
      }
    },
    "@keyframes signoff-blink": {
      "to": {
        "visibility": "hidden"
      }
    },
    "@keyframes signoff-enter": {
      "from": {
        "opacity": "0",
        "transform": "translateY(4px)"
      },
      "to": {
        "opacity": "1",
        "transform": "none"
      }
    },
    "@keyframes signoff-expand": {
      "from": {
        "height": "0",
        "opacity": "0"
      },
      "to": {
        "height": "var(--radix-collapsible-content-height)",
        "opacity": "1"
      }
    },
    "@keyframes signoff-collapse": {
      "from": {
        "height": "var(--radix-collapsible-content-height)",
        "opacity": "1"
      },
      "to": {
        "height": "0",
        "opacity": "0"
      }
    },
    "@keyframes signoff-indeterminate": {
      "0%": {
        "transform": "translateX(-100%)"
      },
      "100%": {
        "transform": "translateX(250%)"
      }
    }
  },
  "type": "registry:component",
  "meta": {
    "version": "0.14.1",
    "unreleasedChanges": false
  }
}
