cortena-ui 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -3,6 +3,82 @@
 Notable changes per release. Versions before 1.6.0 are recorded in the git log
 and in `../../CONSUMING.md`; this file starts where the changelog does.
 
+## 1.7.0
+
+### Added
+
+- **`AgentChat` is a host-able surface** (PLATFORM-64). cortenaweb adopts the
+  shared component instead of running a second chat, and the pieces its chat
+  has that an extension's does not — a Shiki/KaTeX bubble with feedback
+  controls, a composer with attachments and agent/model selectors, a reading
+  column, the MCP App host — go in through props rather than a fork:
+  - `chat: UseAgentChatResult` — the host holds the state and the surface
+    draws it. A sidebar, a shortcut or a page that routes on the session key
+    can then read the same state the surface does. `AgentChatProps` is now
+    `AgentChatOwnedProps | AgentChatHostedProps`: with `chat` there is no
+    `client` and no `storageScope`, because the host owns both. The result
+    may come from `useAgentChat` or from a store of the host's projected onto
+    the same shape.
+  - `components?: Partial<AgentChatComponents>` — `Message`, `Streaming`,
+    `Empty`, `LoadOlder`, `Tools`, `Composer`; each replaces its region whole.
+    `Tools` receives the host's `renderToolCall` as passed, so a strip of the
+    host's own still mounts an MCP App through the one seam.
+  - `classNames?: AgentChatClassNames` for the wrappers (`header`, `scroll`,
+    `transcript`, `sentinel`, `tools`, `composer`); `transcript` replaces the
+    default spacing rather than merging with it. `hideHeader` for a host with
+    its own session list.
+  - `useAgentChat` gains `sendMcpAppAction`, `clearSession` (leave without
+    minting; the next send mints), `regenerate(messageId)`, `send(text,
+    attachments, { model, thinking })`, and options `mintSessionKey`,
+    `restoreSession` and `listSessions`. `AgentChatMessage.attachmentItems`
+    (`unknown[]`, the host's own shape) is set on the user bubble a send adds;
+    `attachments` keeps its `string[]` shape.
+  - `autoLoadOlder`: the transcript pages older history from a sentinel at the
+    top as the reader reaches it, as well as from the button. Off by default —
+    `AgentChatPopup` pages on a click — and armed only once the scroller
+    overflows, so a short transcript does not pull every page the server has.
+    Whatever asked for the page, the reader's place is held across the prepend
+    (`overflow-anchor: none` on the scroller; the surface owns the rule in every
+    browser), and a new message is followed smoothly when the reader was at the
+    bottom.
+  - `useAgentChat().loadOlder` returns `true` when a load was started and
+    `false` when it declined (no session, one in flight, no more), so a caller
+    saving scroll position knows whether a prepend is coming.
+
+### Changed (type-level)
+
+- `AgentChatProps` is now the union `AgentChatOwnedProps | AgentChatHostedProps`.
+  A wrapper that did `interface MyProps extends AgentChatProps` no longer
+  compiles — an interface cannot extend a union. Extend `AgentChatOwnedProps`
+  (you pass `client` and `storageScope`) or `AgentChatHostedProps` (you pass
+  `chat`) instead, as `AgentChatPopupProps` now does.
+- `UseAgentChatResult.loadOlder` is `() => boolean`, was `() => void`. A store
+  projected onto the shape returns whether it started a load.
+- The transcript wrapper (`role="log"`) gains `relative`, and a new first child
+  `data-slot="agent-chat-sentinel"` (`absolute inset-x-0 top-0 h-px` by
+  default, or `classNames.sentinel`). A selector on the transcript's first
+  child, or a test counting its children, sees one more element.
+- `AgentChatEmptySlotProps` is unchanged, but a host's `Empty` no longer holds
+  the region while `chat.error` is set: the transcript mounts with the error
+  banner in it instead.
+
+### Fixed
+
+- **`regenerate` asks the question once.** The user turn being asked again is
+  moved onto the new run rather than drawn a second time, so the transcript
+  reads Q then A2, not Q, Q, A2.
+- **A stale older page cannot land under another session.** `history/older`
+  is dropped for a key that is no longer the current one, the same rule
+  `history/loaded` follows.
+- **A reopened chat brings back the surfaces the agent drew.**
+  `parseHistoryMessages` reads `a2ui` content parts, folds them across a turn,
+  and strips the injected `[Dow YYYY-MM-DD HH:MM TZ]` stamp from a user turn —
+  the same three rules `cortena-shared` applies, ported.
+- **A stale history reply cannot change the session.** `history/loaded` for a
+  key that is no longer the current one — including `null`, after
+  `clearSession` — is dropped whole. Two quick resumes used to land the first
+  transcript under the second key.
+
 ## 1.6.0
 
 ### Added

package/README.md

@@ -318,6 +318,42 @@ returns replaces the default card.
 />
 ```
 
+### Hosting the surface
+
+`AgentChatPopup` owns its state. A host that already has state of its own —
+cortenaweb's shell reads the current session from a store the sidebar, the
+keyboard shortcuts and the Canvas panel all share — mounts `AgentChat` with
+`chat` instead of `client`, and no `storageScope`:
+
+```tsx
+<AgentChat
+  chat={chat}                    // a UseAgentChatResult: from useAgentChat, or a store projected onto it
+  agentName="Cortena"
+  hideHeader                     // the host has its own session list
+  components={{ Message, Streaming, Empty, LoadOlder, Tools, Composer }}
+  classNames={{ scroll: "chat-scroll", transcript: "chat-column gap-6 py-6" }}
+  renderToolCall={renderMcpApp}  // the host's MCP App frame, through the one seam
+/>
+```
+
+What stays shared is the surface: the scroller that keeps to the bottom, the
+pager that holds the reader's place across a prepend (and, with
+`autoLoadOlder`, asks for the next page from a sentinel at the top once the
+transcript overflows), the order of the regions, the progress steps and the
+tool-card seam. What each
+region looks like is the host's to replace, one component per region; a
+component given in `components` replaces its region whole, wrapper included.
+`Tools` is handed `renderToolCall` as it was passed, so a strip of the host's
+own still mounts an MCP App through the seam. `Streaming` is handed `steps`
+because the default draws them inside the live bubble; a host's bubble draws
+them itself. `classNames.transcript` replaces the default gutter rather than
+merging with it, so a reading column owns its own spacing.
+
+The hook has the matching options: `restoreSession: false` for a host whose URL
+names the session (the key is still written, so one window stays on one
+session), `listSessions: false` for a host with its own session list, and
+`mintSessionKey` for a host that binds sessions some other way.
+
 ## Charts in tests
 
 Both chart engines size themselves from the parent box, and under jsdom every

package/dist/agent-chat/session.js

@@ -1,4 +1,5 @@
 "use client";
+import { extractA2UIBlocks, foldA2UIBlocks } from "./a2ui-block.js";
 import { truncate } from "./step-label.js";
 //#region src/agent-chat/session.ts
 /**
@@ -219,11 +220,19 @@ function isToolRelatedMessage(msg) {
 	return false;
 }
 /**
-* Strip `System: [timestamp] …` lines and `[System Message]` prefixes the
-* runtime prepends to a user turn as agent context. They are not user text.
+* A leading `[Dow YYYY-MM-DD HH:MM TZ] ` stamp, as the runtime injects it
+* ahead of every message the agent is given. The date is what makes it safe
+* to remove: a user who opens with "[draft] ship it" keeps their bracket.
+* Same expression as `cortena-shared/src/stores/use-chat.ts`; keep in step.
+*/
+const INJECTED_TIMESTAMP_PREFIX = /^\[[^\]]*\d{4}-\d{2}-\d{2} \d{2}:\d{2}[^\]]*\]\s*/;
+/**
+* Strip the envelope the runtime prepends to a user turn: `System: [timestamp] …`
+* lines and `[System Message]` prefixes carrying agent context, and the
+* injected timestamp ahead of the words themselves. None of it is user text.
 */
 function stripSystemPrefixes(text) {
-	return text.split("\n").filter((line) => !/^System:\s*\[/.test(line) && !line.startsWith("[System Message]")).join("\n").replace(/^\n+/, "");
+	return text.split("\n").filter((line) => !/^System:\s*\[/.test(line) && !line.startsWith("[System Message]")).join("\n").replace(/^\n+/, "").replace(INJECTED_TIMESTAMP_PREFIX, "");
 }
 /** Lift `<thinking>…</thinking>` out of plain text. */
 function separateThinking(text) {
@@ -239,6 +248,7 @@ function separateThinking(text) {
 function parseOneHistoryMessage(raw) {
 	const msg = raw;
 	const content = msg.content;
+	const a2ui = Array.isArray(content) ? extractA2UIBlocks({ content }) : [];
 	let text = Array.isArray(content) ? content.filter((c) => c.type === "text" && c.text).map((c) => c.text).join("") : typeof msg.content === "string" ? msg.content : typeof msg.text === "string" ? msg.text : "";
 	const isToolMessage = isToolRelatedMessage(msg);
 	const role = msg.role === "user" ? "user" : "assistant";
@@ -254,7 +264,8 @@ function parseOneHistoryMessage(raw) {
 			text: mainText,
 			timestamp: msg.timestamp ?? Date.now(),
 			thinkingText: tagThinking,
-			...isToolMessage ? { isToolMessage } : {}
+			...isToolMessage ? { isToolMessage } : {},
+			...a2ui.length > 0 ? { a2ui } : {}
 		};
 	}
 	return {
@@ -263,7 +274,8 @@ function parseOneHistoryMessage(raw) {
 		text,
 		timestamp: msg.timestamp ?? Date.now(),
 		...thinkingText ? { thinkingText } : {},
-		...isToolMessage ? { isToolMessage } : {}
+		...isToolMessage ? { isToolMessage } : {},
+		...a2ui.length > 0 ? { a2ui } : {}
 	};
 }
 /**
@@ -297,9 +309,11 @@ function mergeConsecutiveAssistantMessages(messages) {
 			if (entry.text.trim()) cot.push(entry.text.trim());
 		}
 		const combined = cot.filter(Boolean).join("\n\n");
+		const blocks = foldA2UIBlocks(run.flatMap((entry) => entry.a2ui ?? []));
 		result.push({
 			...visible,
-			...combined ? { thinkingText: combined } : {}
+			...combined ? { thinkingText: combined } : {},
+			...blocks.length > 0 ? { a2ui: blocks } : {}
 		});
 		run = [];
 	};
@@ -381,7 +395,7 @@ function isHiddenMessage(message) {
 	if (message.isError) return false;
 	if (message.isToolMessage) return true;
 	if (message.role === "assistant" && !message.text.trim() && !message.thinkingText && !message.a2ui?.length) return true;
-	if (message.role === "user") return !message.text.trim() && !message.attachments?.length;
+	if (message.role === "user") return !message.text.trim() && !message.attachments?.length && !message.attachmentItems?.length;
 	const text = message.text;
 	return isToolResult(text) || isSkillContent(text) || isAgentDiagnostics(text) || isToolOutput(text);
 }

package/dist/agent-chat/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","names":[],"sources":["../../src/agent-chat/session.ts"],"sourcesContent":["/**\n * Sessions, history and the filter chain.\n *\n * Ported from `cortena-shared/src/stores/use-chat.ts` and\n * `cortenaweb/components/chat/message-bubble.tsx` (Cortena monorepo).\n * `cortena-shared` is not published, so the rules the two transports share\n * live here; keep them in step.\n *\n * The one deliberate difference is where the current session key is kept.\n * cortenaweb puts it in `localStorage`, which is shared by every tab of an\n * origin, so a second window adopted the first window's session: it inherited\n * a stream that was not its own and both windows then showed the same content.\n * Sessions here are **per window** — the key lives in `sessionStorage`, under a\n * name scoped to the extension — so opening the extension twice starts two\n * sessions. Both stay listed and either window can resume either one; two\n * windows on one session may both send, and cortenacore serialises the runs.\n */\n\nimport { truncate } from \"./step-label\";\nimport type { AgentChatMessage, AgentChatStep } from \"./types\";\n\n/* ── minting and remembering a key ───────────────────────────────────────── */\n\n/**\n * A new session key, minted client-side.\n *\n * `agent:<agentId>:new-<Date.now()>-<random36>`. cortenacore reads the\n * `agent:<id>:` prefix to bind the session to that agent's template, and the\n * key is the AG-UI `threadId` verbatim, prefix included. Minting it rather than\n * asking for one is what lets the first message go out immediately.\n */\nexport function mintSessionKey(agentId: string): string {\n  return `agent:${agentId}:new-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;\n}\n\n/** Was this key minted locally for a chat that had no session yet? */\nexport function isProvisionalSessionKey(key: string): boolean {\n  return /(^|:)new-\\d+-[a-z0-9]+$/.test(key);\n}\n\n/** Does this session belong to this agent? `sessions.list` is filtered by it. */\nexport function isSessionOfAgent(key: string, agentId: string): boolean {\n  return key.startsWith(`agent:${agentId}:`);\n}\n\n/** The `sessionStorage` name the current key is kept under, per extension. */\nexport function sessionStorageKey(scope: string): string {\n  return `cortena.agent-chat.${scope}.session`;\n}\n\n/** The `sessionStorage` name the open/collapsed state is kept under. */\nexport function viewStorageKey(scope: string): string {\n  return `cortena.agent-chat.${scope}.view`;\n}\n\n/** The `sessionStorage` name this window's progress steps are kept under. */\nexport function stepsStorageKey(scope: string): string {\n  return `cortena.agent-chat.${scope}.steps`;\n}\n\n/**\n * `sessionStorage`, or nothing.\n *\n * Absent during SSR and refused outright when a browser blocks storage for the\n * origin, and neither is a reason for the chat not to work: without it a window\n * simply forgets its session on reload.\n */\nexport function windowSessionStorage(): Storage | null {\n  try {\n    return typeof window === \"undefined\" ? null : window.sessionStorage;\n  } catch {\n    return null;\n  }\n}\n\nexport function readStoredSessionKey(scope: string): string | null {\n  try {\n    return windowSessionStorage()?.getItem(sessionStorageKey(scope)) ?? null;\n  } catch {\n    return null;\n  }\n}\n\nexport function writeStoredSessionKey(scope: string, key: string | null): void {\n  try {\n    const storage = windowSessionStorage();\n    if (!storage) {\n      return;\n    }\n    if (key === null) {\n      storage.removeItem(sessionStorageKey(scope));\n    } else {\n      storage.setItem(sessionStorageKey(scope), key);\n    }\n  } catch {\n    // A blocked storage is not a reason to lose the run in flight.\n  }\n}\n\n/* ── the progress steps of the turn ──────────────────────────────────────── */\n\n/** Most steps kept, in memory and in `sessionStorage`. A turn that long is a runaway loop. */\nexport const STEP_LIMIT = 50;\n\n/**\n * Most bytes the steps slot may occupy.\n *\n * `sessionStorage` is a few megabytes for the whole origin, shared with\n * everything else the host keeps there, and a step count alone does not bound\n * the size: fifty steps whose labels are all near the limit, with a failure\n * message on each, is a slot nobody budgeted for. Over the cap the OLDEST are\n * dropped, one at a time, because the recent ones are the ones a reload has to\n * bring back.\n */\nconst STEP_BYTE_LIMIT = 64 * 1024;\n\n/** Longest tool call id or tool name kept, in storage and on `data-tool`. */\nexport const STORED_TEXT_LIMIT = 80;\n\n/**\n * The steps of the current turn, and the session they belong to.\n *\n * They go in the per-window store beside the session key, for the same reason\n * the key does: a tab is reloaded mid-run, or a host remounts the surface on a\n * route change, and both threw the whole strip away. (Collapsing the pop-up is\n * NOT one of them — the panel is `hidden`, not unmounted, and the run streams\n * into it either way.) Messages come back from `chat.history`; steps do not\n * exist on the server, so this is the only place they can come back from.\n *\n * Scoped to a session key, and checked on read: resuming a different session\n * must not inherit the last one's steps.\n */\nexport function readStoredSteps(scope: string, sessionKey: string): AgentChatStep[] {\n  try {\n    const raw = windowSessionStorage()?.getItem(stepsStorageKey(scope));\n    if (!raw) {\n      return [];\n    }\n    const parsed = JSON.parse(raw) as { sessionKey?: unknown; steps?: unknown };\n    if (parsed?.sessionKey !== sessionKey || !Array.isArray(parsed.steps)) {\n      return [];\n    }\n    return (parsed.steps as AgentChatStep[])\n      .filter((step) => typeof step?.id === \"string\" && typeof step?.label === \"string\")\n      .map(restoreStep)\n      .slice(-STEP_LIMIT);\n  } catch {\n    // Storage refused, or somebody else wrote the slot. Neither is worth a\n    // broken chat; the strip simply starts empty.\n    return [];\n  }\n}\n\n/** Every status a step may legitimately come back with. */\nconst STEP_STATUSES: ReadonlySet<string> = new Set([\n  \"running\",\n  \"done\",\n  \"error\",\n  \"stopped\",\n  \"paused\",\n]);\n\n/**\n * A step as it comes back from storage.\n *\n * The important cases are `running` and `paused`. Neither is true any more:\n * the run that owned the call ended when the surface went away — a reload, a\n * remount on a route change; a collapsed pop-up only HIDES the strip and never\n * reaches this path — and no result will arrive for it now, so a restored\n * spinner spins until the user gives up and reloads again, which restores it.\n *\n * It comes back `stopped`, with no message. Neutral is the honest reading:\n * nothing failed, the work simply did not continue, and \"Interrupted.\" drawn in\n * the failure colour told the user their call had broken when the page had.\n *\n * An unrecognised status is treated the same way. Nothing else writes this\n * slot today, but it is per-origin `sessionStorage` and this is the only place\n * that decides what a strip is allowed to render.\n */\nfunction restoreStep(step: AgentChatStep): AgentChatStep {\n  const known = STEP_STATUSES.has(step.status);\n  if (known && step.status !== \"running\" && step.status !== \"paused\") {\n    return step;\n  }\n  const restored: AgentChatStep = {\n    ...step,\n    status: \"stopped\",\n    endedAt: step.endedAt ?? Date.now(),\n  };\n  delete restored.errorMessage;\n  return restored;\n}\n\n/**\n * The fields of a step that are safe to keep, and the only ones kept.\n *\n * `args` is deliberately absent. A tool call's arguments are the user's data —\n * what they searched for, whose record they opened, the body of what they\n * wrote — and `sessionStorage` is readable by every script on the origin,\n * survives the run, and is the sort of thing that ends up in a support bundle.\n * Nothing on screen needs them after the run: the LABEL is already derived\n * from them, and the label is what a restored strip shows.\n */\nfunction storedStep(step: AgentChatStep): AgentChatStep {\n  return {\n    // Bounded, both of them. Neither is written by this package: the id is the\n    // producer's `toolCallId` and the name is whatever the model called, so a\n    // single call carrying 9 kB of either filled the byte cap on its own and\n    // pushed every real step out of the slot.\n    id: truncate(step.id, STORED_TEXT_LIMIT),\n    toolName: truncate(step.toolName, STORED_TEXT_LIMIT),\n    label: step.label,\n    status: step.status,\n    startedAt: step.startedAt,\n    ...(step.endedAt === undefined ? {} : { endedAt: step.endedAt }),\n    ...(step.errorMessage === undefined ? {} : { errorMessage: step.errorMessage }),\n  };\n}\n\n/** The slot's contents, projected and trimmed to fit the byte cap. */\nexport function serialiseSteps(sessionKey: string, steps: readonly AgentChatStep[]): string {\n  let kept = steps.slice(-STEP_LIMIT).map(storedStep);\n  let json = JSON.stringify({ sessionKey, steps: kept });\n  while (kept.length > 1 && json.length > STEP_BYTE_LIMIT) {\n    kept = kept.slice(1);\n    json = JSON.stringify({ sessionKey, steps: kept });\n  }\n  return json;\n}\n\nexport function writeStoredSteps(\n  scope: string,\n  sessionKey: string | null,\n  steps: readonly AgentChatStep[],\n): void {\n  try {\n    const storage = windowSessionStorage();\n    if (!storage) {\n      return;\n    }\n    if (!sessionKey || steps.length === 0) {\n      storage.removeItem(stepsStorageKey(scope));\n      return;\n    }\n    storage.setItem(stepsStorageKey(scope), serialiseSteps(sessionKey, steps));\n  } catch {\n    // Blocked, or over quota. The run in flight is not worth losing over it.\n  }\n}\n\n/* ── history ─────────────────────────────────────────────────────────────── */\n\nfunction generateId(): string {\n  return `msg-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;\n}\n\nfunction isToolRelatedMessage(msg: Record<string, unknown>): boolean {\n  const role = typeof msg.role === \"string\" ? msg.role.toLowerCase() : \"\";\n  if (role === \"tool\" || role === \"toolresult\" || role === \"tool_result\") {\n    return true;\n  }\n  const content = msg.content as Array<{ type: string }> | undefined;\n  if (Array.isArray(content) && content.length > 0) {\n    const toolTypes = new Set([\n      \"tool_use\",\n      \"tool_call\",\n      \"tool_result\",\n      \"toolresult\",\n      \"server_tool_use\",\n    ]);\n    const hasText = content.some((c) => c.type === \"text\" || c.type === \"thinking\");\n    const hasToolBlocks = content.some((c) => toolTypes.has(c.type));\n    if (hasToolBlocks && !hasText) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Strip `System: [timestamp] …` lines and `[System Message]` prefixes the\n * runtime prepends to a user turn as agent context. They are not user text.\n */\nfunction stripSystemPrefixes(text: string): string {\n  return text\n    .split(\"\\n\")\n    .filter((line) => !/^System:\\s*\\[/.test(line) && !line.startsWith(\"[System Message]\"))\n    .join(\"\\n\")\n    .replace(/^\\n+/, \"\");\n}\n\n/** Lift `<thinking>…</thinking>` out of plain text. */\nexport function separateThinking(text: string): { thinkingText?: string; mainText: string } {\n  const match = text.match(/<thinking>([\\s\\S]*?)<\\/thinking>/);\n  if (!match?.[1]) {\n    return { mainText: text };\n  }\n  const thinkingText = match[1].trim();\n  const mainText = text.replace(/<thinking>[\\s\\S]*?<\\/thinking>\\s*/, \"\").trim();\n  return { ...(thinkingText ? { thinkingText } : {}), mainText };\n}\n\nfunction parseOneHistoryMessage(raw: unknown): AgentChatMessage {\n  const msg = raw as Record<string, unknown>;\n  const content = msg.content as\n    | Array<{ type: string; text?: string; thinking?: string; a2ui?: unknown }>\n    | undefined;\n  let text = Array.isArray(content)\n    ? content\n        .filter((c) => c.type === \"text\" && c.text)\n        .map((c) => c.text!)\n        .join(\"\")\n    : typeof msg.content === \"string\"\n      ? msg.content\n      : typeof msg.text === \"string\"\n        ? msg.text\n        : \"\";\n\n  const isToolMessage = isToolRelatedMessage(msg);\n  const role = ((msg.role as string) === \"user\" ? \"user\" : \"assistant\") as \"user\" | \"assistant\";\n  if (role === \"user\") {\n    text = stripSystemPrefixes(text);\n  }\n\n  let thinkingText = \"\";\n  if (typeof msg.thinking === \"string\" && msg.thinking.trim()) {\n    thinkingText = msg.thinking.trim();\n  } else if (Array.isArray(content)) {\n    thinkingText = content\n      .filter((c) => c.type === \"thinking\")\n      .map((c) => c.thinking ?? c.text ?? \"\")\n      .filter(Boolean)\n      .join(\"\\n\\n\");\n  }\n  if (!thinkingText) {\n    const { thinkingText: tagThinking, mainText } = separateThinking(text);\n    if (tagThinking) {\n      return {\n        id: typeof msg.id === \"string\" ? msg.id : generateId(),\n        role,\n        text: mainText,\n        timestamp: (msg.timestamp as number) ?? Date.now(),\n        thinkingText: tagThinking,\n        ...(isToolMessage ? { isToolMessage } : {}),\n      };\n    }\n  }\n\n  return {\n    id: typeof msg.id === \"string\" ? msg.id : generateId(),\n    role,\n    text,\n    timestamp: (msg.timestamp as number) ?? Date.now(),\n    ...(thinkingText ? { thinkingText } : {}),\n    ...(isToolMessage ? { isToolMessage } : {}),\n  };\n}\n\n/**\n * Merge an agent turn — assistant messages plus tool call and result messages —\n * into one visible message. Everything except the final substantive response is\n * folded into the chain of thought. Only a genuine user message breaks the turn.\n */\nfunction mergeConsecutiveAssistantMessages(messages: AgentChatMessage[]): AgentChatMessage[] {\n  const result: AgentChatMessage[] = [];\n  let run: AgentChatMessage[] = [];\n\n  const flush = () => {\n    const first = run[0];\n    if (!first) {\n      return;\n    }\n    if (run.length === 1) {\n      result.push(first);\n      run = [];\n      return;\n    }\n    let visibleIdx = run.length - 1;\n    while (visibleIdx > 0 && !(run[visibleIdx]?.text ?? \"\").trim()) {\n      visibleIdx--;\n    }\n    const visible = run[visibleIdx] ?? first;\n    const cot: string[] = [];\n    for (let i = 0; i < run.length; i++) {\n      const entry = run[i];\n      if (!entry) {\n        continue;\n      }\n      if (i === visibleIdx) {\n        if (visible.thinkingText) {\n          cot.push(visible.thinkingText);\n        }\n        continue;\n      }\n      if (entry.thinkingText) {\n        cot.push(entry.thinkingText);\n      }\n      if (entry.text.trim()) {\n        cot.push(entry.text.trim());\n      }\n    }\n    const combined = cot.filter(Boolean).join(\"\\n\\n\");\n    result.push({ ...visible, ...(combined ? { thinkingText: combined } : {}) });\n    run = [];\n  };\n\n  for (const msg of messages) {\n    const isRealUser = msg.role === \"user\" && !msg.isToolMessage && msg.text.trim().length > 0;\n    if (isRealUser) {\n      flush();\n      result.push(msg);\n    } else {\n      run.push(msg);\n    }\n  }\n  flush();\n  return result;\n}\n\n/** Raw transcript records to the messages the list renders. */\nexport function parseHistoryMessages(raw: readonly unknown[]): AgentChatMessage[] {\n  return mergeConsecutiveAssistantMessages(raw.map(parseOneHistoryMessage));\n}\n\n/**\n * The history shrink guard.\n *\n * A history load must not shrink the session already on screen. The first\n * message of a new chat loads history while the turn is still in flight and the\n * user's message has not been persisted yet; replacing wholesale threw that\n * message away, and the reply survived, so the symptom was a conversation with\n * the answer but not the question.\n *\n * Only the same session, and only against losing messages: a longer or equal\n * history still replaces, so an edit, a deletion made elsewhere and a compaction\n * all land normally.\n */\nexport function wouldShrinkHistory(params: {\n  currentSessionKey: string | null;\n  loadedSessionKey: string;\n  currentCount: number;\n  loadedCount: number;\n}): boolean {\n  return (\n    params.currentSessionKey === params.loadedSessionKey &&\n    params.loadedCount < params.currentCount\n  );\n}\n\n/* ── the filter chain ────────────────────────────────────────────────────── */\n\n/** A JSON blob a tool or an extension API returned, echoed as a message. */\nfunction isToolResult(text: string): boolean {\n  const trimmed = text.trim();\n  const wrapped =\n    (trimmed.startsWith(\"[\") && trimmed.endsWith(\"]\")) ||\n    (trimmed.startsWith(\"{\") && trimmed.endsWith(\"}\"));\n  if (!wrapped) {\n    return false;\n  }\n  try {\n    const parsed = JSON.parse(trimmed);\n    return typeof parsed === \"object\" && parsed !== null;\n  } catch {\n    return false;\n  }\n}\n\n/** Raw skill-file content the model echoed instead of acting on. */\nfunction isSkillContent(text: string): boolean {\n  const trimmed = text.trim();\n  return (\n    /^name:\\s*\\S+.*\\bdescription:.*\\btype:\\s*skill\\b/i.test(trimmed) ||\n    /^---\\s*\\n[\\s\\S]*?\\btype:\\s*skill\\b[\\s\\S]*?\\n---/m.test(trimmed)\n  );\n}\n\n/** Runtime diagnostics: token counters, a leaked api-key hint. */\nfunction isAgentDiagnostics(text: string): boolean {\n  const trimmed = text.trim();\n  return /Tokens:\\s*\\d+.*Cache:.*Context:/s.test(trimmed) || /\\bapi-key\\s+sk-/.test(trimmed);\n}\n\n/** Tool execution output that leaked into history as its own message. */\nfunction isToolOutput(text: string): boolean {\n  const trimmed = text.trim();\n  if (!trimmed) {\n    return false;\n  }\n  if (/^Tool\\s+\\S+\\s+not found$/i.test(trimmed)) {\n    return true;\n  }\n  if (trimmed === \"(no output)\") {\n    return true;\n  }\n  if (/^total\\s+\\d+\\s+[d-][rwx-]{9}/.test(trimmed)) {\n    return true;\n  }\n  if (/^[d-][rwx-]{9}[@+]?\\s+\\d+\\s+\\S+\\s+\\S+/.test(trimmed)) {\n    return true;\n  }\n  if (/(?:^|\\n)[A-Z_]{2,}=\\S/m.test(trimmed)) {\n    if (\n      /\\b(?:PATH|PWD|HOME|USER|INIT_CWD|PNPM_|NODE_|npm_|CORTENA_|CORTENACORE_|CORTENABOT_)/m.test(\n        trimmed,\n      )\n    ) {\n      return true;\n    }\n    if ((trimmed.match(/(?:^|\\n)[A-Z_]{3,}=\\S/gm) ?? []).length >= 3) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Should this message be hidden?\n *\n * The same chain cortenaweb's bubble applies, in the same order. It exists\n * because tool plumbing leaks into a transcript in several recognisable shapes,\n * and a chat that renders them reads as broken. Tool detail is not lost: it is\n * in the tool strip and in the chain of thought.\n *\n * A reply that is only UI the agent drew has no text at all, so an A2UI block\n * counts as content — without that, the surface the user asked for is filtered\n * away and nothing appears.\n */\nexport function isHiddenMessage(message: AgentChatMessage): boolean {\n  if (message.isError) {\n    return false;\n  }\n  if (message.isToolMessage) {\n    return true;\n  }\n  if (\n    message.role === \"assistant\" &&\n    !message.text.trim() &&\n    !message.thinkingText &&\n    !message.a2ui?.length\n  ) {\n    return true;\n  }\n  if (message.role === \"user\") {\n    return !message.text.trim() && !message.attachments?.length;\n  }\n  const text = message.text;\n  return isToolResult(text) || isSkillContent(text) || isAgentDiagnostics(text) || isToolOutput(text);\n}\n"],"mappings":"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"}
+{"version":3,"file":"session.js","names":[],"sources":["../../src/agent-chat/session.ts"],"sourcesContent":["/**\n * Sessions, history and the filter chain.\n *\n * Ported from `cortena-shared/src/stores/use-chat.ts` and\n * `cortenaweb/components/chat/message-bubble.tsx` (Cortena monorepo).\n * `cortena-shared` is not published, so the rules the two transports share\n * live here; keep them in step.\n *\n * The one deliberate difference is where the current session key is kept.\n * cortenaweb puts it in `localStorage`, which is shared by every tab of an\n * origin, so a second window adopted the first window's session: it inherited\n * a stream that was not its own and both windows then showed the same content.\n * Sessions here are **per window** — the key lives in `sessionStorage`, under a\n * name scoped to the extension — so opening the extension twice starts two\n * sessions. Both stay listed and either window can resume either one; two\n * windows on one session may both send, and cortenacore serialises the runs.\n */\n\nimport { extractA2UIBlocks, foldA2UIBlocks } from \"./a2ui-block\";\nimport { truncate } from \"./step-label\";\nimport type { AgentChatMessage, AgentChatStep } from \"./types\";\n\n/* ── minting and remembering a key ───────────────────────────────────────── */\n\n/**\n * A new session key, minted client-side.\n *\n * `agent:<agentId>:new-<Date.now()>-<random36>`. cortenacore reads the\n * `agent:<id>:` prefix to bind the session to that agent's template, and the\n * key is the AG-UI `threadId` verbatim, prefix included. Minting it rather than\n * asking for one is what lets the first message go out immediately.\n */\nexport function mintSessionKey(agentId: string): string {\n  return `agent:${agentId}:new-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;\n}\n\n/** Was this key minted locally for a chat that had no session yet? */\nexport function isProvisionalSessionKey(key: string): boolean {\n  return /(^|:)new-\\d+-[a-z0-9]+$/.test(key);\n}\n\n/** Does this session belong to this agent? `sessions.list` is filtered by it. */\nexport function isSessionOfAgent(key: string, agentId: string): boolean {\n  return key.startsWith(`agent:${agentId}:`);\n}\n\n/** The `sessionStorage` name the current key is kept under, per extension. */\nexport function sessionStorageKey(scope: string): string {\n  return `cortena.agent-chat.${scope}.session`;\n}\n\n/** The `sessionStorage` name the open/collapsed state is kept under. */\nexport function viewStorageKey(scope: string): string {\n  return `cortena.agent-chat.${scope}.view`;\n}\n\n/** The `sessionStorage` name this window's progress steps are kept under. */\nexport function stepsStorageKey(scope: string): string {\n  return `cortena.agent-chat.${scope}.steps`;\n}\n\n/**\n * `sessionStorage`, or nothing.\n *\n * Absent during SSR and refused outright when a browser blocks storage for the\n * origin, and neither is a reason for the chat not to work: without it a window\n * simply forgets its session on reload.\n */\nexport function windowSessionStorage(): Storage | null {\n  try {\n    return typeof window === \"undefined\" ? null : window.sessionStorage;\n  } catch {\n    return null;\n  }\n}\n\nexport function readStoredSessionKey(scope: string): string | null {\n  try {\n    return windowSessionStorage()?.getItem(sessionStorageKey(scope)) ?? null;\n  } catch {\n    return null;\n  }\n}\n\nexport function writeStoredSessionKey(scope: string, key: string | null): void {\n  try {\n    const storage = windowSessionStorage();\n    if (!storage) {\n      return;\n    }\n    if (key === null) {\n      storage.removeItem(sessionStorageKey(scope));\n    } else {\n      storage.setItem(sessionStorageKey(scope), key);\n    }\n  } catch {\n    // A blocked storage is not a reason to lose the run in flight.\n  }\n}\n\n/* ── the progress steps of the turn ──────────────────────────────────────── */\n\n/** Most steps kept, in memory and in `sessionStorage`. A turn that long is a runaway loop. */\nexport const STEP_LIMIT = 50;\n\n/**\n * Most bytes the steps slot may occupy.\n *\n * `sessionStorage` is a few megabytes for the whole origin, shared with\n * everything else the host keeps there, and a step count alone does not bound\n * the size: fifty steps whose labels are all near the limit, with a failure\n * message on each, is a slot nobody budgeted for. Over the cap the OLDEST are\n * dropped, one at a time, because the recent ones are the ones a reload has to\n * bring back.\n */\nconst STEP_BYTE_LIMIT = 64 * 1024;\n\n/** Longest tool call id or tool name kept, in storage and on `data-tool`. */\nexport const STORED_TEXT_LIMIT = 80;\n\n/**\n * The steps of the current turn, and the session they belong to.\n *\n * They go in the per-window store beside the session key, for the same reason\n * the key does: a tab is reloaded mid-run, or a host remounts the surface on a\n * route change, and both threw the whole strip away. (Collapsing the pop-up is\n * NOT one of them — the panel is `hidden`, not unmounted, and the run streams\n * into it either way.) Messages come back from `chat.history`; steps do not\n * exist on the server, so this is the only place they can come back from.\n *\n * Scoped to a session key, and checked on read: resuming a different session\n * must not inherit the last one's steps.\n */\nexport function readStoredSteps(scope: string, sessionKey: string): AgentChatStep[] {\n  try {\n    const raw = windowSessionStorage()?.getItem(stepsStorageKey(scope));\n    if (!raw) {\n      return [];\n    }\n    const parsed = JSON.parse(raw) as { sessionKey?: unknown; steps?: unknown };\n    if (parsed?.sessionKey !== sessionKey || !Array.isArray(parsed.steps)) {\n      return [];\n    }\n    return (parsed.steps as AgentChatStep[])\n      .filter((step) => typeof step?.id === \"string\" && typeof step?.label === \"string\")\n      .map(restoreStep)\n      .slice(-STEP_LIMIT);\n  } catch {\n    // Storage refused, or somebody else wrote the slot. Neither is worth a\n    // broken chat; the strip simply starts empty.\n    return [];\n  }\n}\n\n/** Every status a step may legitimately come back with. */\nconst STEP_STATUSES: ReadonlySet<string> = new Set([\n  \"running\",\n  \"done\",\n  \"error\",\n  \"stopped\",\n  \"paused\",\n]);\n\n/**\n * A step as it comes back from storage.\n *\n * The important cases are `running` and `paused`. Neither is true any more:\n * the run that owned the call ended when the surface went away — a reload, a\n * remount on a route change; a collapsed pop-up only HIDES the strip and never\n * reaches this path — and no result will arrive for it now, so a restored\n * spinner spins until the user gives up and reloads again, which restores it.\n *\n * It comes back `stopped`, with no message. Neutral is the honest reading:\n * nothing failed, the work simply did not continue, and \"Interrupted.\" drawn in\n * the failure colour told the user their call had broken when the page had.\n *\n * An unrecognised status is treated the same way. Nothing else writes this\n * slot today, but it is per-origin `sessionStorage` and this is the only place\n * that decides what a strip is allowed to render.\n */\nfunction restoreStep(step: AgentChatStep): AgentChatStep {\n  const known = STEP_STATUSES.has(step.status);\n  if (known && step.status !== \"running\" && step.status !== \"paused\") {\n    return step;\n  }\n  const restored: AgentChatStep = {\n    ...step,\n    status: \"stopped\",\n    endedAt: step.endedAt ?? Date.now(),\n  };\n  delete restored.errorMessage;\n  return restored;\n}\n\n/**\n * The fields of a step that are safe to keep, and the only ones kept.\n *\n * `args` is deliberately absent. A tool call's arguments are the user's data —\n * what they searched for, whose record they opened, the body of what they\n * wrote — and `sessionStorage` is readable by every script on the origin,\n * survives the run, and is the sort of thing that ends up in a support bundle.\n * Nothing on screen needs them after the run: the LABEL is already derived\n * from them, and the label is what a restored strip shows.\n */\nfunction storedStep(step: AgentChatStep): AgentChatStep {\n  return {\n    // Bounded, both of them. Neither is written by this package: the id is the\n    // producer's `toolCallId` and the name is whatever the model called, so a\n    // single call carrying 9 kB of either filled the byte cap on its own and\n    // pushed every real step out of the slot.\n    id: truncate(step.id, STORED_TEXT_LIMIT),\n    toolName: truncate(step.toolName, STORED_TEXT_LIMIT),\n    label: step.label,\n    status: step.status,\n    startedAt: step.startedAt,\n    ...(step.endedAt === undefined ? {} : { endedAt: step.endedAt }),\n    ...(step.errorMessage === undefined ? {} : { errorMessage: step.errorMessage }),\n  };\n}\n\n/** The slot's contents, projected and trimmed to fit the byte cap. */\nexport function serialiseSteps(sessionKey: string, steps: readonly AgentChatStep[]): string {\n  let kept = steps.slice(-STEP_LIMIT).map(storedStep);\n  let json = JSON.stringify({ sessionKey, steps: kept });\n  while (kept.length > 1 && json.length > STEP_BYTE_LIMIT) {\n    kept = kept.slice(1);\n    json = JSON.stringify({ sessionKey, steps: kept });\n  }\n  return json;\n}\n\nexport function writeStoredSteps(\n  scope: string,\n  sessionKey: string | null,\n  steps: readonly AgentChatStep[],\n): void {\n  try {\n    const storage = windowSessionStorage();\n    if (!storage) {\n      return;\n    }\n    if (!sessionKey || steps.length === 0) {\n      storage.removeItem(stepsStorageKey(scope));\n      return;\n    }\n    storage.setItem(stepsStorageKey(scope), serialiseSteps(sessionKey, steps));\n  } catch {\n    // Blocked, or over quota. The run in flight is not worth losing over it.\n  }\n}\n\n/* ── history ─────────────────────────────────────────────────────────────── */\n\nfunction generateId(): string {\n  return `msg-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;\n}\n\nfunction isToolRelatedMessage(msg: Record<string, unknown>): boolean {\n  const role = typeof msg.role === \"string\" ? msg.role.toLowerCase() : \"\";\n  if (role === \"tool\" || role === \"toolresult\" || role === \"tool_result\") {\n    return true;\n  }\n  const content = msg.content as Array<{ type: string }> | undefined;\n  if (Array.isArray(content) && content.length > 0) {\n    const toolTypes = new Set([\n      \"tool_use\",\n      \"tool_call\",\n      \"tool_result\",\n      \"toolresult\",\n      \"server_tool_use\",\n    ]);\n    const hasText = content.some((c) => c.type === \"text\" || c.type === \"thinking\");\n    const hasToolBlocks = content.some((c) => toolTypes.has(c.type));\n    if (hasToolBlocks && !hasText) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * A leading `[Dow YYYY-MM-DD HH:MM TZ] ` stamp, as the runtime injects it\n * ahead of every message the agent is given. The date is what makes it safe\n * to remove: a user who opens with \"[draft] ship it\" keeps their bracket.\n * Same expression as `cortena-shared/src/stores/use-chat.ts`; keep in step.\n */\nconst INJECTED_TIMESTAMP_PREFIX = /^\\[[^\\]]*\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}[^\\]]*\\]\\s*/;\n\n/**\n * Strip the envelope the runtime prepends to a user turn: `System: [timestamp] …`\n * lines and `[System Message]` prefixes carrying agent context, and the\n * injected timestamp ahead of the words themselves. None of it is user text.\n */\nfunction stripSystemPrefixes(text: string): string {\n  return text\n    .split(\"\\n\")\n    .filter((line) => !/^System:\\s*\\[/.test(line) && !line.startsWith(\"[System Message]\"))\n    .join(\"\\n\")\n    .replace(/^\\n+/, \"\")\n    .replace(INJECTED_TIMESTAMP_PREFIX, \"\");\n}\n\n/** Lift `<thinking>…</thinking>` out of plain text. */\nexport function separateThinking(text: string): { thinkingText?: string; mainText: string } {\n  const match = text.match(/<thinking>([\\s\\S]*?)<\\/thinking>/);\n  if (!match?.[1]) {\n    return { mainText: text };\n  }\n  const thinkingText = match[1].trim();\n  const mainText = text.replace(/<thinking>[\\s\\S]*?<\\/thinking>\\s*/, \"\").trim();\n  return { ...(thinkingText ? { thinkingText } : {}), mainText };\n}\n\nfunction parseOneHistoryMessage(raw: unknown): AgentChatMessage {\n  const msg = raw as Record<string, unknown>;\n  const content = msg.content as\n    | Array<{ type: string; text?: string; thinking?: string; a2ui?: unknown }>\n    | undefined;\n  // The UI the agent drew, back from the transcript. `chat.history` lifts the\n  // ```a2ui fences out of the prose and leaves them as `a2ui` content parts —\n  // the same parts a live delta carries — so a reload has a block to render\n  // rather than a fence to parse. Without this every drawn surface vanished\n  // on reopen. Ported from cortena-shared (CORTENA-44).\n  const a2ui = Array.isArray(content)\n    ? extractA2UIBlocks({ content: content as Array<Record<string, unknown>> })\n    : [];\n  let text = Array.isArray(content)\n    ? content\n        .filter((c) => c.type === \"text\" && c.text)\n        .map((c) => c.text!)\n        .join(\"\")\n    : typeof msg.content === \"string\"\n      ? msg.content\n      : typeof msg.text === \"string\"\n        ? msg.text\n        : \"\";\n\n  const isToolMessage = isToolRelatedMessage(msg);\n  const role = ((msg.role as string) === \"user\" ? \"user\" : \"assistant\") as \"user\" | \"assistant\";\n  if (role === \"user\") {\n    text = stripSystemPrefixes(text);\n  }\n\n  let thinkingText = \"\";\n  if (typeof msg.thinking === \"string\" && msg.thinking.trim()) {\n    thinkingText = msg.thinking.trim();\n  } else if (Array.isArray(content)) {\n    thinkingText = content\n      .filter((c) => c.type === \"thinking\")\n      .map((c) => c.thinking ?? c.text ?? \"\")\n      .filter(Boolean)\n      .join(\"\\n\\n\");\n  }\n  if (!thinkingText) {\n    const { thinkingText: tagThinking, mainText } = separateThinking(text);\n    if (tagThinking) {\n      return {\n        id: typeof msg.id === \"string\" ? msg.id : generateId(),\n        role,\n        text: mainText,\n        timestamp: (msg.timestamp as number) ?? Date.now(),\n        thinkingText: tagThinking,\n        ...(isToolMessage ? { isToolMessage } : {}),\n        ...(a2ui.length > 0 ? { a2ui } : {}),\n      };\n    }\n  }\n\n  return {\n    id: typeof msg.id === \"string\" ? msg.id : generateId(),\n    role,\n    text,\n    timestamp: (msg.timestamp as number) ?? Date.now(),\n    ...(thinkingText ? { thinkingText } : {}),\n    ...(isToolMessage ? { isToolMessage } : {}),\n    ...(a2ui.length > 0 ? { a2ui } : {}),\n  };\n}\n\n/**\n * Merge an agent turn — assistant messages plus tool call and result messages —\n * into one visible message. Everything except the final substantive response is\n * folded into the chain of thought. Only a genuine user message breaks the turn.\n */\nfunction mergeConsecutiveAssistantMessages(messages: AgentChatMessage[]): AgentChatMessage[] {\n  const result: AgentChatMessage[] = [];\n  let run: AgentChatMessage[] = [];\n\n  const flush = () => {\n    const first = run[0];\n    if (!first) {\n      return;\n    }\n    if (run.length === 1) {\n      result.push(first);\n      run = [];\n      return;\n    }\n    let visibleIdx = run.length - 1;\n    while (visibleIdx > 0 && !(run[visibleIdx]?.text ?? \"\").trim()) {\n      visibleIdx--;\n    }\n    const visible = run[visibleIdx] ?? first;\n    const cot: string[] = [];\n    for (let i = 0; i < run.length; i++) {\n      const entry = run[i];\n      if (!entry) {\n        continue;\n      }\n      if (i === visibleIdx) {\n        if (visible.thinkingText) {\n          cot.push(visible.thinkingText);\n        }\n        continue;\n      }\n      if (entry.thinkingText) {\n        cot.push(entry.thinkingText);\n      }\n      if (entry.text.trim()) {\n        cot.push(entry.text.trim());\n      }\n    }\n    const combined = cot.filter(Boolean).join(\"\\n\\n\");\n    // A surface the agent drew in an earlier message of the same turn belongs\n    // to the answer the turn produced; folding the run must not drop it.\n    const blocks = foldA2UIBlocks(run.flatMap((entry) => entry.a2ui ?? []));\n    result.push({\n      ...visible,\n      ...(combined ? { thinkingText: combined } : {}),\n      ...(blocks.length > 0 ? { a2ui: blocks } : {}),\n    });\n    run = [];\n  };\n\n  for (const msg of messages) {\n    const isRealUser = msg.role === \"user\" && !msg.isToolMessage && msg.text.trim().length > 0;\n    if (isRealUser) {\n      flush();\n      result.push(msg);\n    } else {\n      run.push(msg);\n    }\n  }\n  flush();\n  return result;\n}\n\n/** Raw transcript records to the messages the list renders. */\nexport function parseHistoryMessages(raw: readonly unknown[]): AgentChatMessage[] {\n  return mergeConsecutiveAssistantMessages(raw.map(parseOneHistoryMessage));\n}\n\n/**\n * The history shrink guard.\n *\n * A history load must not shrink the session already on screen. The first\n * message of a new chat loads history while the turn is still in flight and the\n * user's message has not been persisted yet; replacing wholesale threw that\n * message away, and the reply survived, so the symptom was a conversation with\n * the answer but not the question.\n *\n * Only the same session, and only against losing messages: a longer or equal\n * history still replaces, so an edit, a deletion made elsewhere and a compaction\n * all land normally.\n */\nexport function wouldShrinkHistory(params: {\n  currentSessionKey: string | null;\n  loadedSessionKey: string;\n  currentCount: number;\n  loadedCount: number;\n}): boolean {\n  return (\n    params.currentSessionKey === params.loadedSessionKey &&\n    params.loadedCount < params.currentCount\n  );\n}\n\n/* ── the filter chain ────────────────────────────────────────────────────── */\n\n/** A JSON blob a tool or an extension API returned, echoed as a message. */\nfunction isToolResult(text: string): boolean {\n  const trimmed = text.trim();\n  const wrapped =\n    (trimmed.startsWith(\"[\") && trimmed.endsWith(\"]\")) ||\n    (trimmed.startsWith(\"{\") && trimmed.endsWith(\"}\"));\n  if (!wrapped) {\n    return false;\n  }\n  try {\n    const parsed = JSON.parse(trimmed);\n    return typeof parsed === \"object\" && parsed !== null;\n  } catch {\n    return false;\n  }\n}\n\n/** Raw skill-file content the model echoed instead of acting on. */\nfunction isSkillContent(text: string): boolean {\n  const trimmed = text.trim();\n  return (\n    /^name:\\s*\\S+.*\\bdescription:.*\\btype:\\s*skill\\b/i.test(trimmed) ||\n    /^---\\s*\\n[\\s\\S]*?\\btype:\\s*skill\\b[\\s\\S]*?\\n---/m.test(trimmed)\n  );\n}\n\n/** Runtime diagnostics: token counters, a leaked api-key hint. */\nfunction isAgentDiagnostics(text: string): boolean {\n  const trimmed = text.trim();\n  return /Tokens:\\s*\\d+.*Cache:.*Context:/s.test(trimmed) || /\\bapi-key\\s+sk-/.test(trimmed);\n}\n\n/** Tool execution output that leaked into history as its own message. */\nfunction isToolOutput(text: string): boolean {\n  const trimmed = text.trim();\n  if (!trimmed) {\n    return false;\n  }\n  if (/^Tool\\s+\\S+\\s+not found$/i.test(trimmed)) {\n    return true;\n  }\n  if (trimmed === \"(no output)\") {\n    return true;\n  }\n  if (/^total\\s+\\d+\\s+[d-][rwx-]{9}/.test(trimmed)) {\n    return true;\n  }\n  if (/^[d-][rwx-]{9}[@+]?\\s+\\d+\\s+\\S+\\s+\\S+/.test(trimmed)) {\n    return true;\n  }\n  if (/(?:^|\\n)[A-Z_]{2,}=\\S/m.test(trimmed)) {\n    if (\n      /\\b(?:PATH|PWD|HOME|USER|INIT_CWD|PNPM_|NODE_|npm_|CORTENA_|CORTENACORE_|CORTENABOT_)/m.test(\n        trimmed,\n      )\n    ) {\n      return true;\n    }\n    if ((trimmed.match(/(?:^|\\n)[A-Z_]{3,}=\\S/gm) ?? []).length >= 3) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Should this message be hidden?\n *\n * The same chain cortenaweb's bubble applies, in the same order. It exists\n * because tool plumbing leaks into a transcript in several recognisable shapes,\n * and a chat that renders them reads as broken. Tool detail is not lost: it is\n * in the tool strip and in the chain of thought.\n *\n * A reply that is only UI the agent drew has no text at all, so an A2UI block\n * counts as content — without that, the surface the user asked for is filtered\n * away and nothing appears.\n */\nexport function isHiddenMessage(message: AgentChatMessage): boolean {\n  if (message.isError) {\n    return false;\n  }\n  if (message.isToolMessage) {\n    return true;\n  }\n  if (\n    message.role === \"assistant\" &&\n    !message.text.trim() &&\n    !message.thinkingText &&\n    !message.a2ui?.length\n  ) {\n    return true;\n  }\n  if (message.role === \"user\") {\n    return (\n      !message.text.trim() && !message.attachments?.length && !message.attachmentItems?.length\n    );\n  }\n  const text = message.text;\n  return isToolResult(text) || isSkillContent(text) || isAgentDiagnostics(text) || isToolOutput(text);\n}\n"],"mappings":"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"}

package/dist/agent-chat/store.d.ts

@@ -1,6 +1,6 @@
 "use client";
 import { A2UIChatBlock } from "./a2ui-block.js";
-import { AgentApprovalDecision, AgentApprovalRequest, AgentChatClient, AgentChatMessage, AgentChatStep, AgentSession, AgentToolResultMetadata } from "./types.js";
+import { AgentApprovalDecision, AgentApprovalRequest, AgentChatClient, AgentChatMessage, AgentChatSendInput, AgentChatStep, AgentSession, AgentToolResultMetadata } from "./types.js";
 //#region src/agent-chat/store.d.ts
 export interface AgentToolEntry {
   id: string;
@@ -86,17 +86,68 @@ export interface UseAgentChatOptions {
   /** Skip reading and writing `sessionStorage`; for a transient mount. */
   ephemeral?: boolean;
   thinking?: "low" | "medium" | "high";
+  /**
+   * Mint the key for a brand-new session. Defaults to `mintSessionKey(client.agentId)`,
+   * which binds the session to this client's agent template. A host whose
+   * sessions are bound some other way — cortenaweb lets the user pick an agent
+   * per chat, and a chat with no pick is bound server-side to the default —
+   * supplies its own.
+   */
+  mintSessionKey?: () => string;
+  /**
+   * Read the stored session key back on mount. Default `true`. A host whose
+   * URL names the session — `/chat/<key>` — is the source of truth itself and
+   * passes `false`: the key is still WRITTEN, so the rule "one window, one
+   * session" holds, but nothing is restored under the URL's feet and no
+   * history is fetched for a session the page is about to leave.
+   */
+  restoreSession?: boolean;
+  /**
+   * Fetch `sessions.list` on mount and after each send. Default `true`. A host
+   * with its own session list — cortenaweb's sidebar — passes `false` and the
+   * hook makes no session calls at all; `sessions` stays empty.
+   */
+  listSessions?: boolean;
+}
+/** What `send` accepts beside the text and the attachments. */
+export interface AgentChatSendOptions {
+  /** The model for this run; the composer's selector. */
+  model?: AgentChatSendInput["model"];
+  /** Overrides the hook-level `thinking` for this run. */
+  thinking?: AgentChatSendInput["thinking"];
 }
 export interface UseAgentChatResult extends AgentChatState {
-  send: (text: string, attachments?: unknown[]) => void;
+  send: (text: string, attachments?: unknown[], options?: AgentChatSendOptions) => void;
   sendAction: (action: NonNullable<Parameters<AgentChatClient["send"]>[0]["a2uiAction"]>) => void;
+  /** A click inside a rendered MCP App, as the next run's input. No user bubble. */
+  sendMcpAppAction: (action: NonNullable<AgentChatSendInput["mcpAppAction"]>) => void;
   abort: () => void;
   resolveApproval: (id: string, decision: AgentApprovalDecision) => void;
   newSession: () => void;
   resumeSession: (key: string) => void;
-  loadOlder: () => void;
+  /**
+   * Leave the session without starting another. The transcript empties, the
+   * stored key is removed and the next `send` mints a fresh key — which is
+   * what a host's "New chat" wants when the URL should not change until the
+   * first message goes out. `newSession` mints immediately; this does not.
+   */
+  clearSession: () => void;
+  /**
+   * Ask again for the message this one answered: the bubble is dropped and the
+   * user turn before it is sent again, so the new answer takes its place. Also
+   * the Retry on a failed turn. A no-op while a run is live or when nothing
+   * precedes the message.
+   */
+  regenerate: (messageId: string) => void;
+  /**
+   * Ask for the next page of older history. `true` when a load was started;
+   * `false` when there is nothing to do — no session, a load already in
+   * flight, or no more history — so a caller that saves scroll position
+   * before a prepend knows whether one is coming.
+   */
+  loadOlder: () => boolean;
   refreshSessions: () => void;
 }
-export declare function useAgentChat({ client, storageScope, ephemeral, thinking }: UseAgentChatOptions): UseAgentChatResult;
+export declare function useAgentChat({ client, storageScope, ephemeral, thinking, mintSessionKey: mintKey, restoreSession, listSessions }: UseAgentChatOptions): UseAgentChatResult;
 //#endregion
 //# sourceMappingURL=store.d.ts.map

package/dist/agent-chat/store.js

@@ -86,7 +86,10 @@ function reduce(state, action) {
 		case "send": return {
 			...state,
 			sessionKey: action.sessionKey,
-			messages: action.message ? [...state.messages, action.message] : state.messages,
+			messages: action.message ? [...state.messages, action.message] : action.reanchor ? state.messages.map((m) => m.id === action.reanchor ? {
+				...m,
+				runId: action.runId
+			} : m) : state.messages,
 			streaming: true,
 			streamText: "",
 			streamThinkingText: "",
@@ -99,6 +102,10 @@ function reduce(state, action) {
 			approvals: [],
 			error: null
 		};
+		case "message/remove": return {
+			...state,
+			messages: state.messages.filter((m) => m.id !== action.id)
+		};
 		case "send/failed": return {
 			...state,
 			streaming: false,
@@ -126,6 +133,10 @@ function reduce(state, action) {
 			loadingHistory: true
 		};
 		case "history/loaded":
+			if (action.sessionKey !== state.sessionKey) return {
+				...state,
+				loadingHistory: false
+			};
 			if (wouldShrinkHistory({
 				currentSessionKey: state.sessionKey,
 				loadedSessionKey: action.sessionKey,
@@ -150,13 +161,18 @@ function reduce(state, action) {
 				streamThinkingText: "",
 				streamA2ui: []
 			};
-		case "history/older": return {
-			...state,
-			messages: [...action.messages, ...state.messages],
-			hasMoreHistory: action.hasMore,
-			loadingHistory: false,
-			historyCount: state.historyCount + action.records
-		};
+		case "history/older":
+			if (action.sessionKey !== state.sessionKey) return {
+				...state,
+				loadingHistory: false
+			};
+			return {
+				...state,
+				messages: [...action.messages, ...state.messages],
+				hasMoreHistory: action.hasMore,
+				loadingHistory: false,
+				historyCount: state.historyCount + action.records
+			};
 		case "history/failed": return {
 			...state,
 			loadingHistory: false
@@ -621,7 +637,7 @@ function endStep(base, event) {
 }
 /** How long a burst of step changes is collapsed for before it is written. */
 const STEP_WRITE_DEBOUNCE_MS = 250;
-function useAgentChat({ client, storageScope, ephemeral, thinking }) {
+function useAgentChat({ client, storageScope, ephemeral, thinking, mintSessionKey: mintKey, restoreSession = true, listSessions = true }) {
 	const [state, dispatch] = React.useReducer(reduce, EMPTY);
 	const stateRef = React.useRef(state);
 	stateRef.current = state;
@@ -651,6 +667,7 @@ function useAgentChat({ client, storageScope, ephemeral, thinking }) {
 		};
 	}, [client]);
 	const refreshSessions = React.useCallback(() => {
+		if (!listSessions) return;
 		dispatch({ kind: "sessions/loading" });
 		client.request("sessions.list", { includeDerivedTitles: true }).then((response) => {
 			const sessions = (response?.sessions ?? []).filter((s) => isSessionOfAgent(s.key, client.agentId));
@@ -668,7 +685,7 @@ function useAgentChat({ client, storageScope, ephemeral, thinking }) {
 				message: errorText(err)
 			});
 		});
-	}, [client]);
+	}, [client, listSessions]);
 	const loadHistory = React.useCallback((sessionKey) => {
 		dispatch({ kind: "history/loading" });
 		client.request("chat.history", {
@@ -689,7 +706,7 @@ function useAgentChat({ client, storageScope, ephemeral, thinking }) {
 	React.useEffect(() => {
 		if (restored.current) return;
 		restored.current = true;
-		const stored = ephemeral ? null : readStoredSessionKey(storageScope);
+		const stored = ephemeral || !restoreSession ? null : readStoredSessionKey(storageScope);
 		const key = stored && isSessionOfAgent(stored, client.agentId) ? stored : null;
 		if (key) {
 			dispatch({
@@ -709,6 +726,7 @@ function useAgentChat({ client, storageScope, ephemeral, thinking }) {
 		ephemeral,
 		loadHistory,
 		refreshSessions,
+		restoreSession,
 		storageScope
 	]);
 	/**
@@ -759,24 +777,26 @@ function useAgentChat({ client, storageScope, ephemeral, thinking }) {
 		});
 		if (!ephemeral) writeStoredSessionKey(storageScope, key);
 	}, [ephemeral, storageScope]);
-	const run = React.useCallback((text, extra = {}) => {
+	const run = React.useCallback((text, extra = {}, reanchor) => {
 		const current = stateRef.current;
 		if (current.streaming) return;
-		const sessionKey = current.sessionKey ?? mintSessionKey(client.agentId);
+		const sessionKey = current.sessionKey ?? (mintKey ? mintKey() : mintSessionKey(client.agentId));
 		if (!current.sessionKey && !ephemeral) writeStoredSessionKey(storageScope, sessionKey);
 		const runId = generateId();
-		const message = text || !extra.a2uiAction && !extra.mcpAppAction ? {
+		const message = !reanchor && (text || !extra.a2uiAction && !extra.mcpAppAction) ? {
 			id: runId,
 			role: "user",
 			text,
 			timestamp: Date.now(),
-			runId
+			runId,
+			...extra.attachments?.length ? { attachmentItems: extra.attachments } : {}
 		} : null;
 		dispatch({
 			kind: "send",
 			message,
 			runId,
-			sessionKey
+			sessionKey,
+			...reanchor ? { reanchor } : {}
 		});
 		client.send({
 			sessionKey,
@@ -791,16 +811,44 @@ function useAgentChat({ client, storageScope, ephemeral, thinking }) {
 	}, [
 		client,
 		ephemeral,
+		mintKey,
 		refreshSessions,
 		storageScope,
 		thinking
 	]);
-	const send = React.useCallback((text, attachments) => {
-		run(text, attachments?.length ? { attachments } : {});
+	const send = React.useCallback((text, attachments, options) => {
+		run(text, {
+			...attachments?.length ? { attachments } : {},
+			...options?.model ? { model: options.model } : {},
+			...options?.thinking ? { thinking: options.thinking } : {}
+		});
 	}, [run]);
 	const sendAction = React.useCallback((a2uiAction) => {
 		run("", { a2uiAction });
 	}, [run]);
+	const sendMcpAppAction = React.useCallback((mcpAppAction) => {
+		run("", { mcpAppAction });
+	}, [run]);
+	const regenerate = React.useCallback((messageId) => {
+		const { messages, streaming } = stateRef.current;
+		if (streaming) return;
+		const index = messages.findIndex((m) => m.id === messageId);
+		if (index < 1) return;
+		let question = null;
+		for (let i = index - 1; i >= 0; i -= 1) {
+			const candidate = messages[i];
+			if (candidate?.role === "user" && !candidate.isToolMessage) {
+				question = candidate;
+				break;
+			}
+		}
+		if (question === null) return;
+		dispatch({
+			kind: "message/remove",
+			id: messageId
+		});
+		run(question.text, {}, question.id);
+	}, [run]);
 	const abort = React.useCallback(() => {
 		const { runId, sessionKey } = stateRef.current;
 		dispatch({ kind: "abort" });
@@ -831,38 +879,55 @@ function useAgentChat({ client, storageScope, ephemeral, thinking }) {
 		});
 	}, [client]);
 	const newSession = React.useCallback(() => {
-		setSession(mintSessionKey(client.agentId));
-	}, [client, setSession]);
+		setSession(mintKey ? mintKey() : mintSessionKey(client.agentId));
+	}, [
+		client,
+		mintKey,
+		setSession
+	]);
+	const clearSession = React.useCallback(() => {
+		dispatch({
+			kind: "session",
+			key: null
+		});
+		if (!ephemeral) writeStoredSessionKey(storageScope, null);
+	}, [ephemeral, storageScope]);
 	const resumeSession = React.useCallback((key) => {
 		setSession(key);
 		loadHistory(key);
 	}, [loadHistory, setSession]);
 	const loadOlder = React.useCallback(() => {
 		const current = stateRef.current;
-		if (!current.sessionKey || current.loadingHistory || !current.hasMoreHistory) return;
+		if (!current.sessionKey || current.loadingHistory || !current.hasMoreHistory) return false;
+		const sessionKey = current.sessionKey;
 		dispatch({ kind: "history/loading" });
 		client.request("chat.history", {
-			sessionKey: current.sessionKey,
+			sessionKey,
 			limit: 100,
 			offset: current.historyCount
 		}).then((response) => {
 			const records = response?.messages ?? [];
 			dispatch({
 				kind: "history/older",
+				sessionKey,
 				messages: parseHistoryMessages(records),
 				hasMore: response?.hasMore ?? false,
 				records: records.length
 			});
 		}).catch(() => dispatch({ kind: "history/failed" }));
+		return true;
 	}, [client]);
 	return {
 		...state,
 		send,
 		sendAction,
+		sendMcpAppAction,
 		abort,
 		resolveApproval,
 		newSession,
 		resumeSession,
+		clearSession,
+		regenerate,
 		loadOlder,
 		refreshSessions
 	};