basalt-ui 1.28.0 → 1.29.1

package/configs/oxlint-plugin.test.ts

@@ -18,6 +18,7 @@ import basaltPlugin, {
   KNOWN_RULE_IDS,
   PLUGIN_RULE_ADVISORY,
   PLUGIN_RULE_GRACE,
+  RETIRED_RULE_IDS,
 } from './oxlint-plugin.js'
 import { CTL_THEME } from '../src/theme/ctl-theme'
 import { GUARD_RULES, PLUGIN_RULE_IDS } from '../src/guard/index.ts'
@@ -37,8 +38,6 @@ beforeEach(() => {
       jsPlugins: [PLUGIN_PATH],
       rules: {
         'basalt/provider-above-router': 'error',
-        'basalt/duplicate-notifications-mount': 'error',
-        'basalt/query-dual-import': 'error',
         'basalt/query-fn-unwrap': 'error',
         'basalt/deprecated-export': 'error',
         'basalt/forms-field-key': 'error',
@@ -1511,9 +1510,15 @@ describe('KNOWN_RULE_IDS', () => {
   // Deduped, because ONE id is deliberately in both registries: `in-body-page-title` is a plugin
   // rule AND a guard kind (law C8 has an AST half and a text half), so one `theme-allow
   // in-body-page-title — <why>` waives both lanes rather than needing a different word per lane.
-  it('contains nothing else — it is exactly the union of the two registries', () => {
+  // `RETIRED_RULE_IDS` adds a third component: an id that used to be a guard kind or a plugin
+  // rule, is in neither live registry, and must still parse as a (dead) waiver rather than a typo.
+  it('contains nothing else — it is exactly the union of the two registries plus retired ids', () => {
     const expected = [
-      ...new Set([...Object.keys(basaltPlugin.rules), ...Object.keys(GUARD_RULES)]),
+      ...new Set([
+        ...Object.keys(basaltPlugin.rules),
+        ...Object.keys(GUARD_RULES),
+        ...RETIRED_RULE_IDS,
+      ]),
     ].toSorted()
     expect([...KNOWN_RULE_IDS].toSorted()).toEqual(expected)
   })
@@ -1531,6 +1536,15 @@ describe('KNOWN_RULE_IDS', () => {
       expect([id, PLUGIN_RULE_IDS.has(id) || Object.hasOwn(GUARD_RULES, id)]).toEqual([id, true])
     }
   })
+
+  // A retired id has to be classifiable too, on both sides — `RETIRED_RULE_IDS` is this plugin's
+  // copy, `PLUGIN_RULE_IDS` (src/guard) is the guard's. Drift between them would mean
+  // `--audit-allows` classifies a retired id one way from `check-theme` and another from oxlint.
+  it('every retired id is in the guard’s PLUGIN_RULE_IDS too', () => {
+    for (const id of RETIRED_RULE_IDS) {
+      expect([id, PLUGIN_RULE_IDS.has(id)]).toEqual([id, true])
+    }
+  })
 })
 
 // ── theme-allow fails closed on a typo ─────────────────────────────────────────────────────────
@@ -3035,194 +3049,9 @@ describe('basalt/provider-above-router', () => {
   })
 })
 
-// ── duplicate-notifications-mount (F5) ───────────────────────────────────────
-
-describe('basalt/duplicate-notifications-mount', () => {
-  const IMPORTS =
-    `import { BasaltOverlays } from 'basalt-ui/commands'\n` +
-    `import { BasaltNotifications } from 'basalt-ui/notifications'\n`
-
-  it('flags both mounts in one file', () => {
-    const { code, rules } = run(
-      `${IMPORTS}export const App = () => (\n  <BasaltOverlays notifications>\n` +
-        `    <BasaltNotifications />\n  </BasaltOverlays>\n)\n`,
-    )
-    expect(code).toBe(1)
-    expect(rules).toContain('duplicate-notifications-mount')
-  })
-
-  // `notifications` defaults to TRUE, so the attribute being absent is the same defect.
-  it('flags when BasaltOverlays writes no notifications prop at all', () => {
-    const { code, rules } = run(
-      `${IMPORTS}export const App = () => (\n  <BasaltOverlays>\n` +
-        `    <BasaltNotifications />\n  </BasaltOverlays>\n)\n`,
-    )
-    expect(code).toBe(1)
-    expect(rules).toContain('duplicate-notifications-mount')
-  })
-
-  it('does NOT flag when BasaltOverlays disables its notifications layer', () => {
-    const { code, rules } = run(
-      `${IMPORTS}export const App = () => (\n  <BasaltOverlays notifications={false}>\n` +
-        `    <BasaltNotifications />\n  </BasaltOverlays>\n)\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('duplicate-notifications-mount')
-  })
-
-  it('does NOT flag a standalone BasaltNotifications on its own', () => {
-    const { code, rules } = run(
-      `import { BasaltNotifications } from 'basalt-ui/notifications'\n` +
-        `export const App = () => <BasaltNotifications />\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('duplicate-notifications-mount')
-  })
-
-  it("does NOT flag a consumer's own components of the same names", () => {
-    const { code, rules } = run(
-      `import { BasaltOverlays } from './overlays'\n` +
-        `import { BasaltNotifications } from './notifications'\n` +
-        `export const App = () => (\n  <BasaltOverlays>\n    <BasaltNotifications />\n` +
-        `  </BasaltOverlays>\n)\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('duplicate-notifications-mount')
-  })
-
-  it('honours a theme-allow naming the rule', () => {
-    const { code, rules } = run(
-      `${IMPORTS}export const App = () => (\n  <BasaltOverlays notifications>\n` +
-        `    {/* theme-allow duplicate-notifications-mount — two roots, never both mounted */}\n` +
-        `    <BasaltNotifications />\n  </BasaltOverlays>\n)\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('duplicate-notifications-mount')
-  })
-
-  // Two mounts WRITTEN, one mount RENDERED — the ternary is the shape a consumer reaches for while
-  // migrating from the standalone layer to the composed one, and it was never a double mount.
-  it('does NOT flag the two branches of one ternary', () => {
-    const { code, rules } = run(
-      `${IMPORTS}export const App = ({ composed }) => (\n` +
-        `  <div>{composed ? <BasaltOverlays /> : <BasaltNotifications />}</div>\n)\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('duplicate-notifications-mount')
-  })
-
-  it('does NOT flag the two operands of one logical expression', () => {
-    const { code, rules } = run(
-      `${IMPORTS}export const App = ({ composed }) => (\n` +
-        `  <div>{(composed && <BasaltOverlays />) || <BasaltNotifications />}</div>\n)\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('duplicate-notifications-mount')
-  })
-
-  // The exemption is the NEAREST common ancestor only. Two separate `&&` guards can both hold, so
-  // this stays a finding — the pair is conditional, not exclusive.
-  it('DOES flag two independently-guarded mounts under one parent', () => {
-    const { code, rules } = run(
-      `${IMPORTS}export const App = ({ a, b }) => (\n` +
-        `  <div>{a && <BasaltOverlays />}{b && <BasaltNotifications />}</div>\n)\n`,
-    )
-    expect(code).toBe(1)
-    expect(rules).toContain('duplicate-notifications-mount')
-  })
-
-  // One exclusive pair does not excuse a second, unconditional overlays mount.
-  it('DOES flag when a NON-exclusive overlays mount also exists', () => {
-    const { code, rules } = run(
-      `${IMPORTS}export const App = ({ composed }) => (\n` +
-        `  <BasaltOverlays>\n` +
-        `    {composed ? <BasaltOverlays /> : <BasaltNotifications />}\n` +
-        `  </BasaltOverlays>\n)\n`,
-    )
-    expect(code).toBe(1)
-    expect(rules).toContain('duplicate-notifications-mount')
-  })
-})
-
-// ── query-dual-import (F5) ───────────────────────────────────────────────────
-
-describe('basalt/query-dual-import', () => {
-  it('flags a file importing from both @tanstack/react-query and basalt-ui/query', () => {
-    const { code, rules, output } = run(
-      `import { useQuery } from '@tanstack/react-query'\n` +
-        `import { unwrap } from 'basalt-ui/query'\n` +
-        `export const useThing = () => useQuery({ queryKey: ['t'], queryFn: () => unwrap(get()) })\n`,
-    )
-    expect(code).toBe(1)
-    expect(rules).toContain('query-dual-import')
-    expect(output).toContain('Dual query import')
-  })
-
-  // The softer half — the one that actually catches the drift, and why the rule is `warn`.
-  it('flags a raw @tanstack/react-query import beside a basalt root import', () => {
-    const { code, rules, output } = run(
-      `import { useQuery } from '@tanstack/react-query'\n` +
-        `import { QueryState } from 'basalt-ui'\n` +
-        `export const useThing = () => useQuery({ queryKey: ['t'], queryFn: get })\n`,
-    )
-    expect(code).toBe(1)
-    expect(rules).toContain('query-dual-import')
-    expect(output).toContain('Raw @tanstack/react-query import')
-  })
-
-  it('does NOT flag basalt-ui/query on its own', () => {
-    const { code, rules } = run(
-      `import { useQuery, unwrap } from 'basalt-ui/query'\n` +
-        `export const useThing = () => useQuery({ queryKey: ['t'], queryFn: () => unwrap(get()) })\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('query-dual-import')
-  })
-
-  // `import type` is erased at compile time — there is no runtime import to route through the
-  // seam, and typing against the library's own result type is what `QueryStateLike` documents as
-  // legitimate. Same skip `agent-no-raw-usechat` and `ai-sdk-major` take.
-  it('does NOT flag a type-only @tanstack/react-query import beside basalt-ui/query', () => {
-    const { code, rules } = run(
-      `import type { UseQueryResult } from '@tanstack/react-query'\n` +
-        `import { unwrap } from 'basalt-ui/query'\n` +
-        `export const pick = (q: UseQueryResult<number>) => unwrap(q.data)\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('query-dual-import')
-  })
-
-  it('does NOT flag @tanstack/react-query in a file with no basalt import', () => {
-    const { code, rules } = run(
-      `import { useQuery } from '@tanstack/react-query'\n` +
-        `export const useThing = () => useQuery({ queryKey: ['t'], queryFn: get })\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('query-dual-import')
-  })
-
-  // The devtools package is a different package, not a subpath.
-  it('does NOT flag @tanstack/react-query-devtools', () => {
-    const { code, rules } = run(
-      `import { ReactQueryDevtools } from '@tanstack/react-query-devtools'\n` +
-        `import { unwrap } from 'basalt-ui/query'\n` +
-        `export const D = () => <ReactQueryDevtools />\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('query-dual-import')
-  })
-
-  it('honours a theme-allow naming the rule', () => {
-    const { code, rules } = run(
-      `// theme-allow query-dual-import — the persister API has no basalt re-export yet\n` +
-        `import { useQuery } from '@tanstack/react-query'\n` +
-        `import { unwrap } from 'basalt-ui/query'\n` +
-        `export const useThing = () => useQuery({ queryKey: ['t'], queryFn: () => unwrap(g()) })\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('query-dual-import')
-  })
-})
+// `basalt/query-dual-import` is RETIRED (`RETIRED_RULE_IDS`) — its own describe block was removed
+// along with the rule; see `KNOWN_RULE_IDS` below for the coverage that remains: it is still a
+// valid (dead) `theme-allow` id, never a typo.
 
 // ── query-fn-unwrap (F5) ─────────────────────────────────────────────────────
 
@@ -3295,80 +3124,8 @@ describe('basalt/query-fn-unwrap', () => {
 
 // ── deprecated-export (B4) ───────────────────────────────────────────────────
 
-describe('basalt/deprecated-export', () => {
-  it('flags a deprecated named import', () => {
-    const { code, rules, output } = run(
-      `import { field } from 'basalt-ui/forms'\nexport const f = field\n`,
-    )
-    expect(code).toBe(1)
-    expect(rules).toContain('deprecated-export')
-    expect(output).toContain('inputProps')
-  })
-
-  it('does NOT flag the replacement', () => {
-    const { code, rules } = run(
-      `import { inputProps } from 'basalt-ui/forms'\nexport const f = inputProps\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('deprecated-export')
-  })
-
-  it('does NOT flag a same-named import from somewhere else', () => {
-    const { code, rules } = run(`import { field } from 'basalt-ui/state'\nexport const f = field\n`)
-    expect(code).toBe(0)
-    expect(rules).not.toContain('deprecated-export')
-  })
-
-  it('flags each deprecated BasaltProvider connectivity prop', () => {
-    const { code, rules, output } = run(
-      `import { BasaltProvider } from 'basalt-ui'\n` +
-        `export const App = () => (\n` +
-        `  <BasaltProvider sseUrl="/e" healthUrl="/h" healthIntervalMs={5000}>{null}</BasaltProvider>\n)\n`,
-    )
-    expect(code).toBe(1)
-    expect(rules).toContain('deprecated-export')
-    expect(output).toContain('connectivity')
-  })
-
-  it('does NOT flag the connectivity object prop', () => {
-    const { code, rules } = run(
-      `import { BasaltProvider } from 'basalt-ui'\n` +
-        `export const App = () => <BasaltProvider connectivity={{ sseUrl: '/e' }}>{null}</BasaltProvider>\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('deprecated-export')
-  })
-
-  it("does NOT flag an sseUrl on a consumer's own component", () => {
-    const { code, rules } = run(
-      `import { BasaltProvider } from './provider'\n` +
-        `export const App = () => <BasaltProvider sseUrl="/e">{null}</BasaltProvider>\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('deprecated-export')
-  })
-
-  it('honours a theme-allow naming the rule', () => {
-    const { code, rules } = run(
-      `// theme-allow deprecated-export — pinned to 1.27.0 until the forms port lands\n` +
-        `import { field } from 'basalt-ui/forms'\nexport const f = field\n`,
-    )
-    expect(code).toBe(0)
-    expect(rules).not.toContain('deprecated-export')
-  })
-
-  // `field` → `inputProps` is NOT a drop-in rename any more (`inputProps` returns no `key`), so
-  // the row carries `fix: false`: the diagnostic still fires, but `--fix` must leave the import
-  // alone — the rewrite belongs to `basalt/forms-field-key`, which also inserts the key.
-  it('leaves a row with `fix: false` untouched under --fix while still reporting it', () => {
-    const source = `import { field } from 'basalt-ui/forms'\nexport const f = field\n`
-    writeFileSync(resolve(dir, 'fixture.tsx'), source)
-    Bun.spawnSync([OXLINT_BIN, '-c', '.oxlintrc.json', '--fix', 'fixture.tsx'], { cwd: dir })
-    expect(readFileSync(resolve(dir, 'fixture.tsx'), 'utf8')).toBe(source)
-    const { rules } = run(source)
-    expect(rules).toContain('deprecated-export')
-  })
-})
+// deprecated-export's behaviour tests were removed with the last ledger row in 1.29.0; the
+// ledger-shape and barrel-scan assertions below keep the mechanism honest until the next row.
 
 // ── forms-field-key ──────────────────────────────────────────────────────────
 

package/configs/oxlint.json

@@ -42,8 +42,6 @@
     "basalt/search-literal-link": "error",
     "basalt/use-search-from-literal": "error",
     "basalt/provider-above-router": "warn",
-    "basalt/duplicate-notifications-mount": "warn",
-    "basalt/query-dual-import": "warn",
     "basalt/query-fn-unwrap": "warn",
     "basalt/deprecated-export": "warn",
     "basalt/forms-field-key": "warn",

package/dist/agent/ai-sdk-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-sdk-transport.d.ts","sourceRoot":"","sources":["../../src/agent/ai-sdk-transport.ts"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,SAAS,CAAA;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAmB1D,MAAM,MAAM,qBAAqB,GAAG;IAClC,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAA;IACnD,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;IACzC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CACzC,CAAA;AAID,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,SAAS,IAAI,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG;IACvF;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CAC/E,CAAA;AAwRD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAG,SAAS,EAC9C,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAAC,KAAK,CAAC,CAkDvB"}
+{"version":3,"file":"ai-sdk-transport.d.ts","sourceRoot":"","sources":["../../src/agent/ai-sdk-transport.ts"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,SAAS,CAAA;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAmB1D,MAAM,MAAM,qBAAqB,GAAG;IAClC,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAA;IACnD,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;IACzC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CACzC,CAAA;AAID,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,SAAS,IAAI,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG;IACvF;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CAC/E,CAAA;AAwRD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAG,SAAS,EAC9C,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAAC,KAAK,CAAC,CAyDvB"}

package/dist/agent/ai-sdk-transport.js

@@ -158,14 +158,17 @@ function aiSdkTransport(options) {
       // diffPart), so a replayed run rewrites in place instead of duplicating — the literal
       // condition this assertion stands for.
       idempotentReplay: true,
-      async *stream(input, signal) {
+      async *stream(input, signal, ctx) {
         yield { id: `${chatId}#start`, type: "start", runId: chatId, resumeToken: chatId };
         const { httpTransport, readUIMessageStream: readStream } = await resolveAiSdk();
         const userMessage = {
           // This id is what AI SDK's own backend persistence/dedup keys turns hang off — the same
-          // idempotency-key cost as basalt's own ChatMessage.id (see mintMessageId's doc), so
-          // mintMessageId, not mintThreadId, is the right helper here.
-          id: mintMessageId(),
+          // idempotency-key cost as basalt's own ChatMessage.id (see mintMessageId's doc). Prefer
+          // the caller's OWN idempotency key (ctx.messageId — the id useAgentThreadRuns.start()
+          // already minted for this turn's ChatMessage) so the two never diverge for one turn; only
+          // a caller that omits ctx (useAgentStream, a hand-rolled stream() call) falls back to
+          // minting a fresh one here.
+          id: ctx?.messageId ?? mintMessageId(),
           role: "user",
           parts: [{ type: "text", text: input }]
         };

package/dist/agent/coalesce.js

@@ -1,4 +1,4 @@
-import { isDev } from "../utils/is-dev.js";
+import { isDev } from "../common/is-dev.js";
 function isTextLikeType(type) {
   return type === "text" || type === "reasoning";
 }

package/dist/agent/merge.js

@@ -1,4 +1,4 @@
-import { isDev } from "../utils/is-dev.js";
+import { isDev } from "../common/is-dev.js";
 function isTextLikeType(type) {
   return type === "text" || type === "reasoning";
 }

package/dist/agent/transport.d.ts

@@ -31,7 +31,7 @@
  */
 import type { AgentPart, AgentPartDraft } from './parts.js';
 /**
- * The injected transport seam. `stream(input, signal)` returns an async generator of parts.
+ * The injected transport seam. `stream(input, signal, ctx)` returns an async generator of parts.
  * Implement this interface for any backend — Eden, fetch-based SSE, AI SDK, or a mock.
  *
  * The default `TPart` is `AgentPartDraft` (not `AgentPart`): transports yield DRAFTS — `id`
@@ -39,6 +39,15 @@ import type { AgentPart, AgentPartDraft } from './parts.js';
  * part before it is ever accumulated. Pass an explicit `AgentPart` generic when a transport mints
  * its own ids directly (as `aiSdkTransport` does).
  *
+ * `ctx.messageId`, when present, is the id `useAgentThreadRuns.start()` already minted for this
+ * turn's user `ChatMessage` — the SAME idempotency key `appendMessage`/the backend's dedup keys off
+ * of (see `mintMessageId`'s doc). A transport that mints its OWN wire-level message id independent
+ * of that (as `aiSdkTransport` used to) forces the consumer to reconcile two ids for one turn; a
+ * transport MAY use `ctx.messageId` as its outbound message id instead of minting a fresh one. The
+ * param is optional and appended last so an existing two-arg transport keeps compiling unchanged —
+ * only `useAgentThreadRuns.start()`/`retry()` pass it; a bare `stream(input, signal)` call (e.g.
+ * `useAgentStream`, a hand-rolled caller) omits it and a transport falls back to minting its own.
+ *
  * @example
  * // Minimal mock transport for tests / playground:
  * const mockTransport: AgentTransport = {
@@ -48,7 +57,9 @@ import type { AgentPart, AgentPartDraft } from './parts.js';
  * }
  */
 export type AgentTransport<TPart = AgentPartDraft, TInput = string> = {
-    stream: (input: TInput, signal?: AbortSignal) => AsyncGenerator<TPart>;
+    stream: (input: TInput, signal?: AbortSignal, ctx?: {
+        readonly messageId: string;
+    }) => AsyncGenerator<TPart>;
     /** Optional: resume a previously-started run from its resumeToken (see StartPart). Transports that don't support resumption simply omit this. */
     resume?: (resumeToken: string, signal?: AbortSignal) => AsyncGenerator<TPart>;
 };

package/dist/agent/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/agent/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAIxD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,cAAc,EAAE,MAAM,GAAG,MAAM,IAAI;IACpE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,CAAA;IACtE,iJAAiJ;IACjJ,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,CAAA;CAC9E,CAAA;AAID;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,CAAC,KAAK,GAAG,cAAc,EAAE,MAAM,GAAG,MAAM,IAAI,cAAc,CAC3F,KAAK,EACL,MAAM,CACP,GAAG;IACF,QAAQ,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,CAAA;IACrF,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAA;CAChC,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EACvC,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GAC/B,CAAC,IAAI,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAK7C;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAG,SAAS,EAAE,MAAM,GAAG,MAAM,EAC9D,IAAI,EAAE,CACJ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,EACpE,UAAU,CAAC,EAAE,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,EACpE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAA;CAAE,GAC7C,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAsBxE"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/agent/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAIxD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,cAAc,EAAE,MAAM,GAAG,MAAM,IAAI;IACpE,MAAM,EAAE,CACN,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,EACpB,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KACjC,cAAc,CAAC,KAAK,CAAC,CAAA;IAC1B,iJAAiJ;IACjJ,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,CAAA;CAC9E,CAAA;AAID;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,CAAC,KAAK,GAAG,cAAc,EAAE,MAAM,GAAG,MAAM,IAAI,cAAc,CAC3F,KAAK,EACL,MAAM,CACP,GAAG;IACF,QAAQ,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,CAAA;IACrF,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAA;CAChC,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EACvC,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GAC/B,CAAC,IAAI,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAK7C;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAG,SAAS,EAAE,MAAM,GAAG,MAAM,EAC9D,IAAI,EAAE,CACJ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,EACpE,UAAU,CAAC,EAAE,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,EACpE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAA;CAAE,GAC7C,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAsBxE"}

package/dist/agent/use-agent-thread-runs.d.ts

@@ -42,6 +42,17 @@ export type UseAgentThreadRunsArgs<TPart = AgentPart> = {
      * Required when TPart is not the default AgentPart union.
      */
     readonly toUserParts?: (input: string) => TPart[];
+    /**
+     * Called when a turn's stream throws — never for an `AbortError` (an intentional stop()/
+     * supersede, not a failure worth surfacing). Fires from the SAME catch branch that sets
+     * `onFailureStatus` on the thread, so a caller wanting a toast/notification for a genuine
+     * transport error (a 409/503/401, argo's hermes-chat S19) no longer has to wrap every transport
+     * call in its own generator to intercept the throw — see `consumeAndFinalize`'s catch block.
+     */
+    readonly onError?: (info: {
+        readonly threadId: string;
+        readonly error: unknown;
+    }) => void;
 };
 export type UseAgentThreadRunsReturn<TPart = AgentPart> = {
     /** Live stream state per thread id, for threads with a run in progress or just completed. */
@@ -95,5 +106,5 @@ export type UseAgentThreadRunsReturn<TPart = AgentPart> = {
  * start(threadB, 'What changed in the last release?')
  * // both stream concurrently; runs.get(threadA) / runs.get(threadB) update independently
  */
-export declare function useAgentThreadRuns<TPart extends PartLike = AgentPart>({ transport, store, resolveOutcome, toUserParts, }: UseAgentThreadRunsArgs<TPart>): UseAgentThreadRunsReturn<TPart>;
+export declare function useAgentThreadRuns<TPart extends PartLike = AgentPart>({ transport, store, resolveOutcome, toUserParts, onError, }: UseAgentThreadRunsArgs<TPart>): UseAgentThreadRunsReturn<TPart>;
 //# sourceMappingURL=use-agent-thread-runs.d.ts.map

package/dist/agent/use-agent-thread-runs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent-thread-runs.d.ts","sourceRoot":"","sources":["../../src/agent/use-agent-thread-runs.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,WAAW,CAAA;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAA6B,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,SAAS,IAAI;IAC9C,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;CACxB,CAAA;AAID,MAAM,MAAM,sBAAsB,CAAC,KAAK,GAAG,SAAS,IAAI;IACtD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EACd,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GAC7B,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;IACzD,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IACnC,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC,KAAK,CAAC,CAAA;IAC/C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,EAAE,CAAA;CAClD,CAAA;AAID,MAAM,MAAM,wBAAwB,CAAC,KAAK,GAAG,SAAS,IAAI;IACxD,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAA;IACzD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACzD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,gGAAgG;IAChG,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAC7B,CAAA;AAuRD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,QAAQ,GAAG,SAAS,EAAE,EACrE,SAAS,EACT,KAAK,EACL,cAAc,EACd,WAAW,GACZ,EAAE,sBAAsB,CAAC,KAAK,CAAC,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAgSjE"}
+{"version":3,"file":"use-agent-thread-runs.d.ts","sourceRoot":"","sources":["../../src/agent/use-agent-thread-runs.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,WAAW,CAAA;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAA6B,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,SAAS,IAAI;IAC9C,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;CACxB,CAAA;AAID,MAAM,MAAM,sBAAsB,CAAC,KAAK,GAAG,SAAS,IAAI;IACtD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EACd,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GAC7B,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;IACzD,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IACnC,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC,KAAK,CAAC,CAAA;IAC/C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,EAAE,CAAA;IACjD;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAA;CAC1F,CAAA;AAID,MAAM,MAAM,wBAAwB,CAAC,KAAK,GAAG,SAAS,IAAI;IACxD,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAA;IACzD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACzD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,gGAAgG;IAChG,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAC7B,CAAA;AA0RD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,QAAQ,GAAG,SAAS,EAAE,EACrE,SAAS,EACT,KAAK,EACL,cAAc,EACd,WAAW,EACX,OAAO,GACR,EAAE,sBAAsB,CAAC,KAAK,CAAC,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAsUjE"}

package/dist/agent/use-agent-thread-runs.js

@@ -37,7 +37,8 @@ async function consumeAndFinalize(args) {
     storeRef,
     resolveOutcome,
     setRuns,
-    onFailureStatus
+    onFailureStatus,
+    onError
   } = args;
   let parts = [];
   try {
@@ -99,6 +100,7 @@ async function consumeAndFinalize(args) {
       next.delete(threadId);
       return next;
     });
+    onError?.({ threadId, error: err });
   }
 }
 async function finalizeStop(args) {
@@ -149,11 +151,14 @@ function useAgentThreadRuns({
   transport,
   store,
   resolveOutcome,
-  toUserParts
+  toUserParts,
+  onError
 }) {
   const [runs, setRuns] = useState(/* @__PURE__ */ new Map());
   const runsRef = useRef(runs);
   runsRef.current = runs;
+  const onErrorRef = useRef(onError);
+  onErrorRef.current = onError;
   const controllersRef = useRef(/* @__PURE__ */ new Map());
   const appendedRef = useRef(/* @__PURE__ */ new Map());
   const lastInputRef = useRef(/* @__PURE__ */ new Map());
@@ -194,6 +199,7 @@ function useAgentThreadRuns({
     []
   );
   useEffect(() => {
+    if (!store.hydrated) return;
     for (const thread of storeRef.current.threads) {
       const orphaned = (thread.status === "pending" || thread.status === "streaming") && !controllersRef.current.has(thread.id);
       if (!orphaned) continue;
@@ -229,10 +235,11 @@ function useAgentThreadRuns({
         storeRef,
         resolveOutcome,
         setRuns,
-        onFailureStatus: "interrupted"
+        onFailureStatus: "interrupted",
+        onError: (info) => onErrorRef.current?.(info)
       });
     }
-  }, []);
+  }, [store.hydrated]);
   const start = useCallback(
     (threadId, input) => {
       if (controllersRef.current.has(threadId)) return;
@@ -258,14 +265,21 @@ function useAgentThreadRuns({
         threadId,
         controller,
         // Namespaced by threadId — same choice, same caveat, as the mount-time resume call above.
-        generator: withPartIds(threadId, resolvedTransport.stream(input, controller.signal)),
+        // ctx.messageId is this turn's OWN idempotency key (userMessage.id, just minted above) —
+        // a transport that accepts it (aiSdkTransport) mints its wire-level message with the SAME
+        // id instead of a second, unrelated one (R1 — see AgentTransport.stream's doc).
+        generator: withPartIds(
+          threadId,
+          resolvedTransport.stream(input, controller.signal, { messageId: userMessage.id })
+        ),
         userMessage,
         controllersRef,
         appendedRef,
         storeRef,
         resolveOutcome,
         setRuns,
-        onFailureStatus: "error"
+        onFailureStatus: "error",
+        onError: (info) => onErrorRef.current?.(info)
       });
     },
     [resolveOutcome]

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

@@ -17,7 +17,7 @@ export type { ThreadFeedProps } from './thread-feed.js';
 export { ThreadFeedRow } from './thread-feed-row.js';
 export type { ThreadFeedRowProps } from './thread-feed-row.js';
 export type { MessageAffordances } from './message-affordances.js';
-export type { VirtualizeOptions, VirtualizeProps } from './virtualize.js';
+export type { RowHeightProps, VirtualizeOptions, VirtualizeProps } from './virtualize.js';
 export { ThreadOutcomeCard } from './thread-outcome-card.js';
 export type { ThreadOutcomeCardProps } from './thread-outcome-card.js';
 export { ThreadDetailPanel } from './thread-detail-panel.js';

package/dist/agent-chat/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-chat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAG9D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAO3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAGtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGnG,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAG7D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-chat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAG9D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAS3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAGtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGnG,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAG7D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA"}

package/dist/agent-chat/relative-time.js

@@ -1,4 +1,4 @@
-import { isDev } from "../utils/is-dev.js";
+import { isDev } from "../common/is-dev.js";
 const RELATIVE_TIME_FORMAT = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
 const RELATIVE_TIME_UNITS = [
   { unit: "year", ms: 31536e6 },

package/dist/agent-chat/thread-detail-panel.js

@@ -4,7 +4,7 @@ import { useReducedMotion } from "@mantine/hooks";
 import { motion } from "motion/react";
 import { BasaltStickToBottom } from "../agent/index.js";
 import { cx } from "../common/props.js";
-import { MOTION_SPRING } from "../motion/index.js";
+import { MOTION_SPRING } from "../common/motion.js";
 import { Composer } from "./composer.js";
 import { ThreadTranscript } from "./thread-message.js";
 import { VX } from "../tokens/index.js";

package/dist/agent-chat/thread-feed-row.d.ts

@@ -1,9 +1,9 @@
-import type { JSX } from 'react';
-import type { AgentThread, ForeignPart, PartRenderer, PartRenderers, StreamStatus, TranscriptPart } from '../agent/index.js';
-import type { BasaltProps } from '../common/props.js';
+import type { JSX, ReactNode } from 'react';
+import type { AgentThread, ChatMessage, ForeignPart, PartRenderer, PartRenderers, StreamStatus, TranscriptPart } from '../agent/index.js';
+import type { BasaltProps, SlotStylesProps } from '../common/props.js';
 import type { ComposerProps, ComposerSubmit } from './composer.js';
 import type { MessageAffordances } from './message-affordances.js';
-import type { VirtualizeProps } from './virtualize.js';
+import type { RowHeightProps } from './virtualize.js';
 type ThreadFeedRowBase = {
     /**
      * The thread this row projects. Typed against `AgentThread<TranscriptPart>` — not the plain,
@@ -19,6 +19,30 @@ type ThreadFeedRowBase = {
     readonly expanded: boolean;
     /** Called with the thread's id when the header is clicked/activated. */
     readonly onToggle: (id: string) => void;
+    /**
+     * Header title override. Falls back to `thread.outcome?.title ?? 'Untitled thread'` (today's
+     * behavior, unchanged) when omitted. For a server-titled thread whose title is never distilled
+     * into a basalt `AgentOutcome` (argo's hermes-chat S4 — title/summary/type/pin are server-owned
+     * and never guessed client-side), pass it directly instead of forcing an outcome shape onto data
+     * that never had one.
+     */
+    readonly title?: string;
+    /** Header summary override, same fallback rule as `title` (`thread.outcome?.summary ?? ''`). */
+    readonly summary?: string;
+    /** Rendered at the START of the header row, before the title/summary stack — a pin icon, a type
+     * badge (argo's hermes-chat S5). Absent by default; renders nothing extra when omitted. */
+    readonly headerLeft?: ReactNode;
+    /** Rendered at the END of the header row, before the timestamp and chevron — a collapsed-only
+     * streaming indicator (argo's hermes-chat S5). Absent by default; renders nothing extra when
+     * omitted. */
+    readonly headerRight?: ReactNode;
+    /**
+     * Overrides the transcript source: when provided, the row renders THESE messages instead of
+     * reading `thread.messages` directly (argo's hermes-chat S6 — the confirmed transcript is an
+     * optimistic-overlay MERGE over the store's messages, not the store's messages verbatim).
+     * Defaults to `thread.messages`.
+     */
+    readonly messages?: readonly ChatMessage<TranscriptPart>[];
     /** The live (in-flight) assistant turn's parts, when a run is streaming for this thread. */
     readonly liveParts?: readonly TranscriptPart[];
     /** The live run's status — drives the in-progress indicator on the live block. */
@@ -49,10 +73,11 @@ type ThreadFeedRowBase = {
  * `virtualize`/`height` are forwarded straight to the row's `ThreadTranscript`, carrying the same
  * union guard: an inline row holding a very long thread can window it, and doing so REQUIRES a
  * `height` (the transcript then owns a fixed-height scroll node inside the expanded body, instead
- * of the body growing to the thread's full length). Omit both and the row's transcript is
- * content-sized, as before.
+ * of the body growing to the thread's full length). `height` alone (no `virtualize`) is B3's
+ * bounded-but-not-virtualized mode — see `RowHeightProps`'s own doc. Omit both and the row's
+ * transcript is content-sized, as before.
  */
-export type ThreadFeedRowProps = ThreadFeedRowBase & VirtualizeProps & BasaltProps;
+export type ThreadFeedRowProps = ThreadFeedRowBase & RowHeightProps & SlotStylesProps<'root' | 'header' | 'body'> & BasaltProps;
 /**
  * One inline-expanding thread row: a header (title + relative timestamp) that toggles a lazily
  * mounted, kept-mounted transcript + composer body. See the module doc for the mount lifecycle