@genesislcap/ai-assistant 14.498.0 → 14.499.0

package/dist/esm/components/chat-driver/chat-driver.js

@@ -179,6 +179,23 @@ export class ChatDriver extends EventTarget {
          * arrive. See {@link TurnSnapshot} for the captured shape.
          */
         this.turnSnapshots = [];
+        /**
+         * `turn` + `message` diagnostic-log entries harvested from an out-of-band source (a resolved
+         * interaction whose widget returned `InteractionResult.diagnostics` — e.g. a server-side
+         * ChatDriver's debug log). `event` entries are NOT kept here — they're folded into the session's
+         * meta-event registry via `mergeMetaEvents` (see `resolveInteraction`) so they inherit fresh host
+         * indices, and reach the log through `getMetaEvents`. Append-only; the host folds these into its
+         * debug log alongside this driver's own timeline. Not cleared here — it lives with the driver
+         * instance, like `turnSnapshots`, so a new chat (fresh driver) starts empty while a compaction
+         * (same instance) keeps it. (GENC-1461.)
+         */
+        this.externalDiagnostics = [];
+        /**
+         * Monotonic count of external-diagnostics batches harvested this driver-lifetime. Namespaces each
+         * batch's re-keyed `turn` entries so distinct server generations in one chat session can't collide
+         * on `turnIndex` in the forward-capture persister (which dedups turns by that key). (GENC-1461.)
+         */
+        this.externalDiagnosticsBatches = 0;
         /** Monotonic counter that survives agent swaps — useful for cross-referencing with history. */
         this.globalTurnIndex = 0;
         /**
@@ -606,6 +623,17 @@ export class ChatDriver extends EventTarget {
     getTurnSnapshots() {
         return this.turnSnapshots;
     }
+    /**
+     * The `turn` + `message` diagnostic-log entries harvested from resolved interactions'
+     * `InteractionResult.diagnostics` (e.g. a server-side ChatDriver's collated debug log). The host
+     * concatenates these into its own debug log so `downloadDebugLog`/the persisted diagnostics stream
+     * include external-engine logs; `event` entries are excluded here because they're merged into the
+     * session's meta-event registry instead (see `resolveInteraction`) and reach the log via
+     * `getMetaEvents`. Opaque, chronologically sorted by the host at assemble time. (GENC-1461.)
+     */
+    getExternalDiagnostics() {
+        return this.externalDiagnostics;
+    }
     /**
      * Merge a sub-agent's turn snapshots into this driver's buffer so they surface
      * as `kind:'turn'` entries in the exported debug log. The child runs as a
@@ -988,6 +1016,81 @@ export class ChatDriver extends EventTarget {
             // timeout (and a timeout firing here clears its own already-fired handle).
             if (interaction.timeoutHandle)
                 clearTimeout(interaction.timeoutHandle);
+            // Harvest any out-of-band diagnostic entries the widget collated (e.g. from a server-side
+            // ChatDriver) so the host's debug log + persisted diagnostics include them. Independent of the
+            // message `idx` below — they describe the widget's own work, not this message.
+            //
+            // The harvested entries carry the SOURCE engine's own index space (0-based turns/events), which
+            // would collide with this host's cursors in the forward-capture persister — turns dedup by
+            // `turnIndex`, events by an `index` high-water mark — so foreign entries get silently dropped
+            // from the persisted stream. Route each kind through the host's own collision-safe machinery,
+            // mirroring how a sub-agent's log is folded in (see `invokeSubAgent`):
+            //   • `event`   → `mergeMetaEvents`, which re-indexes them onto this session's monotonic event
+            //                 counter (clearing the high-water) while preserving their timestamps; they then
+            //                 reach the log via `getMetaEvents` in `buildTimelineEntries`, not this buffer.
+            //   • `turn`    → re-key `turnIndex` to the turn's local position within a per-batch namespace,
+            //                 so turns stay unique even when one interaction folds in several independent
+            //                 server runs that each number their own turns from 0 (a consolidator carries a
+            //                 consolidator-code run AND a table-code run), and never collide with the host's
+            //                 own bare-integer turn keys.
+            //   • `message` → kept as-is; the persister already keys messages by content, so they survive.
+            // TODO(GENC-1461, option 2 / streaming): expose an imperative `appendDiagnostics(entries)` on
+            // the handler context (see buildHandlerContext) that runs this same decomposition as SSE ticks
+            // arrive, so a streaming widget can surface its external engine's log live rather than only at
+            // resolve time. Batch-at-resolve (here) is the current, non-streaming path.
+            const harvestedDiagnostics = result === null || result === void 0 ? void 0 : result.diagnostics;
+            if (Array.isArray(harvestedDiagnostics) && harvestedDiagnostics.length) {
+                const batch = (this.externalDiagnosticsBatches += 1);
+                const externalEvents = [];
+                let turnCount = 0;
+                let messageCount = 0;
+                for (const raw of harvestedDiagnostics) {
+                    // The harvest is external and typed `unknown[]`, so an element could be a primitive, null,
+                    // or an object without a string `kind`. Guard before reading `.kind` so a malformed entry
+                    // can't throw here (and gets skipped rather than derailing the whole fold).
+                    if (!raw ||
+                        typeof raw !== 'object' ||
+                        typeof raw.kind !== 'string') {
+                        continue;
+                    }
+                    const entry = raw;
+                    if (entry.kind === 'event') {
+                        const { kind: _kind } = entry, event = __rest(entry, ["kind"]);
+                        externalEvents.push(event);
+                    }
+                    else if (entry.kind === 'turn') {
+                        // Local position within THIS harvest, not the source engine's own `turnIndex`: one
+                        // interaction can carry several independent server runs (a consolidator folds in its
+                        // consolidator-code run and its table-code run), each numbering its turns from 0, so
+                        // keying by the source index would collide them. The local position keeps every turn key
+                        // distinct within the batch, so the persister's per-`turnIndex` dedup keeps them all.
+                        this.externalDiagnostics.push(Object.assign(Object.assign({}, entry), { turnIndex: `server-generation.${batch}:${turnCount}` }));
+                        turnCount += 1;
+                    }
+                    else if (entry.kind === 'message') {
+                        messageCount += 1;
+                        this.externalDiagnostics.push(entry);
+                    }
+                    // Any other kind is intentionally dropped, not folded. A sibling's `buildTimelineEntries`
+                    // only ever emits message/turn/event; `meta-snapshot` is host/DOM-owned (latest-wins on
+                    // reassembly, plus its own persister dedup), so folding a foreign one would pollute this
+                    // host's timeline and meta cursor. Restricting to the three real kinds also keeps the
+                    // manifest counts accurate (nothing miscounted as a `message`).
+                }
+                if (externalEvents.length)
+                    mergeMetaEvents(this.sessionKey, externalEvents);
+                // Manifest: one provenance marker for the fold itself — records that an out-of-band engine's
+                // log crossed into this session and how much of each kind, so a regression that silently
+                // drops a generation's diagnostics (e.g. a new path that forgets to thread them across the
+                // boundary) surfaces as a zero/absent manifest rather than only by diffing a download. Also
+                // the natural seed for the streaming PR's open/close bracket. Stamped at resolve, so it
+                // closes the block on the sorted timeline. (GENC-1461.)
+                recordMetaEvent(this.sessionKey, 'external-diagnostics.folded', {
+                    interactionId,
+                    batch,
+                    counts: { turn: turnCount, event: externalEvents.length, message: messageCount },
+                });
+            }
             const idx = this.history.findIndex((m) => { var _a; return ((_a = m.interaction) === null || _a === void 0 ? void 0 : _a.interactionId) === interactionId; });
             if (idx !== -1) {
                 // Fold any widget-reported external (non-LLM) cost onto the message, so

package/dist/esm/components/chat-driver/chat-driver.test.js

@@ -1069,6 +1069,171 @@ interactionPresentation('presentation is absent when the option is omitted', ()
 }));
 interactionPresentation.run();
 // ---------------------------------------------------------------------------
+// external diagnostics harvest (GENC-1461) — a widget may return an out-of-band
+// engine's collated debug log on `InteractionResult.diagnostics` (e.g. a
+// server-side ChatDriver's). Those entries carry the SOURCE engine's own 0-based
+// index space, which would collide with this host's forward-capture cursors and
+// be dropped: the persister dedups `turn` entries by `turnIndex` and `event`
+// entries by an `index` high-water mark. So the driver decomposes the harvest by
+// kind — events fold into the session's meta-event registry (re-indexed onto the
+// host's monotonic counter), turns are re-keyed into a per-batch namespace, and
+// messages pass through unchanged (the persister already keys those by content).
+// ---------------------------------------------------------------------------
+const externalDiagnostics = createLogicSuite('ChatDriver external diagnostics harvest');
+/** A `diagnostics` payload as a headless engine would collate it — one of each kind,
+ * all carrying that engine's own 0-based indices (`turnIndex: '0'`, event `index: 0`). */
+const harvestPayload = (marker) => [
+    { kind: 'message', timestamp: '2026-07-23T10:00:00.000Z', role: 'assistant', content: marker },
+    { kind: 'turn', timestamp: '2026-07-23T10:00:01.000Z', turnIndex: '0', systemPrompt: 'sys' },
+    {
+        kind: 'event',
+        index: 0,
+        timestamp: '2026-07-23T10:00:02.000Z',
+        type: 'turn.error',
+        importance: 'high',
+        detail: { marker },
+    },
+];
+externalDiagnostics('routes harvested events to the meta-event registry (re-indexed) and keeps turns + messages', () => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    clearMetaEventRegistry();
+    const sessionKey = 'external-diag-harvest';
+    const driver = makeDriver(agent({ name: 'a' }), scriptedProvider([]), sessionKey);
+    // Requesting the interaction records a host `interaction.requested` meta-event, so the
+    // registry's index counter is already advanced when the harvested event is merged — exactly
+    // the condition that made the foreign 0-based `index` lose the persister's high-water race.
+    const pending = driver.requestInteraction('w', {});
+    const { interactionId } = driver.getHistory().at(-1).interaction;
+    const requestedIndex = getMetaEvents(sessionKey).find((e) => e.type === 'interaction.requested').index;
+    driver.resolveInteraction(interactionId, {
+        status: 'approved',
+        diagnostics: harvestPayload('m1'),
+    });
+    yield pending;
+    // The event left the external buffer and landed in the registry, re-indexed ABOVE the host's
+    // prior event (so it beats the persister's `index <= lastEventIndex` high-water), timestamp kept.
+    const external = driver.getExternalDiagnostics();
+    assert.is(external.filter((e) => e.kind === 'event').length, 0, 'events do not stay in the buffer');
+    const merged = getMetaEvents(sessionKey).find((e) => { var _a; return ((_a = e.detail) === null || _a === void 0 ? void 0 : _a.marker) === 'm1'; });
+    assert.ok(merged, 'the harvested event is folded into the session registry');
+    assert.ok(merged.index > requestedIndex, 're-indexed onto the host counter, above prior events');
+    assert.is(merged.timestamp, '2026-07-23T10:00:02.000Z', 'original timestamp preserved for ordering');
+    // The turn is kept in the buffer but re-keyed out of the host's bare-integer turn-key space,
+    // and the message passes through untouched.
+    const turn = external.find((e) => e.kind === 'turn');
+    assert.ok(turn, 'the harvested turn is kept in the external buffer');
+    assert.is(turn.turnIndex, 'server-generation.1:0', 'turnIndex namespaced per batch');
+    const message = external.find((e) => e.kind === 'message');
+    assert.ok(message, 'the harvested message is kept in the external buffer');
+    assert.is(message.content, 'm1', 'message passes through unchanged');
+    // A single manifest event records the fold's provenance — the fragile boundary this feature
+    // guards is now observable: a dropped generation shows up as a zero/absent manifest.
+    const manifest = getMetaEvents(sessionKey).find((e) => e.type === 'external-diagnostics.folded');
+    assert.ok(manifest, 'a manifest meta-event is recorded for the fold');
+    assert.is((_a = manifest.detail) === null || _a === void 0 ? void 0 : _a.interactionId, interactionId);
+    assert.equal((_b = manifest.detail) === null || _b === void 0 ? void 0 : _b.counts, { turn: 1, event: 1, message: 1 });
+}));
+externalDiagnostics('namespaces each batch so distinct server generations cannot collide on turnIndex', () => __awaiter(void 0, void 0, void 0, function* () {
+    clearMetaEventRegistry();
+    const driver = makeDriver(agent({ name: 'a' }), scriptedProvider([]), 'external-diag-batches');
+    const first = driver.requestInteraction('w', {});
+    const firstId = driver.getHistory().at(-1).interaction.interactionId;
+    driver.resolveInteraction(firstId, { status: 'approved', diagnostics: harvestPayload('a') });
+    yield first;
+    const second = driver.requestInteraction('w', {});
+    const secondId = driver.getHistory().at(-1).interaction.interactionId;
+    driver.resolveInteraction(secondId, { status: 'approved', diagnostics: harvestPayload('b') });
+    yield second;
+    // Both harvests carried `turnIndex: '0'`; the per-batch namespace keeps them distinct, so the
+    // persister's `emittedTurnKeys` can't fold the second generation's turn into the first.
+    const turnKeys = driver
+        .getExternalDiagnostics()
+        .filter((e) => e.kind === 'turn')
+        .map((e) => e.turnIndex);
+    assert.equal(turnKeys, ['server-generation.1:0', 'server-generation.2:0']);
+}));
+externalDiagnostics('keys turns by local position so several server runs in one harvest do not collide', () => __awaiter(void 0, void 0, void 0, function* () {
+    clearMetaEventRegistry();
+    const driver = makeDriver(agent({ name: 'a' }), scriptedProvider([]), 'external-diag-multirun');
+    // One interaction carrying two independent server runs (e.g. a consolidator's consolidator-code
+    // run and its table-code run) — each numbers its own turns from 0, so the harvest has two
+    // `turnIndex: '0'` entries. Keying by source index would collapse them; local position keeps
+    // both, so the persister's per-turnIndex dedup drops neither.
+    const pending = driver.requestInteraction('w', {});
+    const { interactionId } = driver.getHistory().at(-1).interaction;
+    driver.resolveInteraction(interactionId, {
+        status: 'approved',
+        diagnostics: [
+            {
+                kind: 'turn',
+                timestamp: '2026-07-23T10:00:00.000Z',
+                turnIndex: '0',
+                systemPrompt: 'run1',
+            },
+            {
+                kind: 'turn',
+                timestamp: '2026-07-23T10:00:01.000Z',
+                turnIndex: '1',
+                systemPrompt: 'run1',
+            },
+            {
+                kind: 'turn',
+                timestamp: '2026-07-23T10:00:02.000Z',
+                turnIndex: '0',
+                systemPrompt: 'run2',
+            },
+        ],
+    });
+    yield pending;
+    const turnKeys = driver
+        .getExternalDiagnostics()
+        .filter((e) => e.kind === 'turn')
+        .map((e) => e.turnIndex);
+    assert.equal(turnKeys, [
+        'server-generation.1:0',
+        'server-generation.1:1',
+        'server-generation.1:2',
+    ]);
+    // All distinct — no key repeats despite the repeated source `turnIndex: '0'`.
+    assert.is(new Set(turnKeys).size, 3, 'every harvested turn gets a distinct key');
+}));
+externalDiagnostics('tolerates malformed entries and does not fold or miscount non-standard kinds', () => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    clearMetaEventRegistry();
+    const sessionKey = 'external-diag-malformed';
+    const driver = makeDriver(agent({ name: 'a' }), scriptedProvider([]), sessionKey);
+    const pending = driver.requestInteraction('w', {});
+    const { interactionId } = driver.getHistory().at(-1).interaction;
+    // The harvest is untrusted `unknown[]`: primitives/null and an object without a string `kind`
+    // must be skipped (not throw), and a `meta-snapshot` (host-owned, never emitted by a sibling)
+    // must be dropped rather than folded or miscounted as a message.
+    driver.resolveInteraction(interactionId, {
+        status: 'approved',
+        diagnostics: [
+            null,
+            'oops',
+            42,
+            { timestamp: '2026-07-23T10:00:00.000Z' }, // no kind
+            {
+                kind: 'message',
+                timestamp: '2026-07-23T10:00:01.000Z',
+                role: 'assistant',
+                content: 'real',
+            },
+            { kind: 'meta-snapshot', timestamp: '2026-07-23T10:00:02.000Z', meta: { host: 'foreign' } },
+        ],
+    });
+    yield pending;
+    // Only the one real message survives the buffer; the meta-snapshot is not folded.
+    const external = driver.getExternalDiagnostics();
+    assert.equal(external.map((e) => e.kind), ['message']);
+    assert.is(external[0].content, 'real');
+    // Manifest counts only the three real kinds — the meta-snapshot is not miscounted as a message.
+    const manifest = getMetaEvents(sessionKey).find((e) => e.type === 'external-diagnostics.folded');
+    assert.equal((_a = manifest.detail) === null || _a === void 0 ? void 0 : _a.counts, { turn: 0, event: 0, message: 1 });
+}));
+externalDiagnostics.run();
+// ---------------------------------------------------------------------------
 // interaction context lifecycle (GENC-1390) — the driver creates a live
 // InteractionContext on requestInteraction and disposes+drops it on resolve, so
 // widget state survives element remounts but never outlives the interaction.

package/dist/esm/components/orchestrating-driver/orchestrating-driver.js

@@ -188,6 +188,10 @@ export class OrchestratingDriver extends EventTarget {
     getTurnSnapshots() {
         return this.chatDriver.getTurnSnapshots();
     }
+    /** Delegates to the inner {@link ChatDriver} — interactions resolve there, so it holds the buffer. */
+    getExternalDiagnostics() {
+        return this.chatDriver.getExternalDiagnostics();
+    }
     getSuggestions(history, prompt, count, allAgentInfo) {
         return __awaiter(this, void 0, void 0, function* () {
             // When pinned to a specialist, scope suggestions to that agent so the

package/dist/esm/main/main.js

@@ -42,6 +42,7 @@ import { AiWavesIndicator } from '../components/waves-indicator';
 import { AssistantAppSettingsProvider, } from '../provider/assistant-app-settings';
 import { recordMetaEvent, getMetaEvents, clearSession as clearMetaSession, DEBUG_LOG_README, } from '../state/debug-event-log';
 import { getOrCreateDriver, getDriver, getDriverAgentsKey, deleteDriver, } from '../state/driver-registry';
+import { buildTimelineEntries } from '../state/persistence/build-timeline-entries';
 import { assembleDebugLog } from '../state/persistence/diagnostics';
 import { deleteDiagnosticsCursorsFor, resetDiagnosticsCursorsFor, } from '../state/persistence/diagnostics-cursors';
 import { getOrCreatePersister, getPersister, deletePersister, } from '../state/persistence/persister-registry';
@@ -55,7 +56,6 @@ import { resolveExclusiveLoadingStyle } from '../utils/animation-exclusivity';
 import { collectSessionModels } from '../utils/collect-session-models';
 import { appendCostSessionRecord, clearCostSessionHistory, loadCostSessionHistory, removeCostSessionRecord, } from '../utils/cost-session-history';
 import { deriveCostSessionTitleFromMessages, resolveCostSessionTitle, } from '../utils/derive-cost-session-title';
-import { flattenSubAgentMessages } from '../utils/flatten-sub-agent-messages';
 import { logger } from '../utils/logger';
 import { filterVisibleMessages, trailingInteractionRow } from '../utils/message-partition';
 import { resolveCostHistoryConfig, } from '../utils/resolve-cost-history-config';
@@ -2399,7 +2399,7 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
      * been appended to the persisted stream.
      */
     buildDiagnosticEntries() {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
         const timestamp = new Date().toISOString().replace(/:/g, '-');
         // Snapshot the live active agent from the DRIVER — the instance whose
         // `onActivate` ran, so its `getDebugSnapshot` closure holds state.
@@ -2417,32 +2417,14 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
             ? Math.round((this.contextTokens / this.contextLimit) * 100)
             : undefined;
         const stateKey = this.getStateKey();
-        // Collapse repeated system prompts across consecutive turns. A stateful
-        // agent's prompt changes between turns, but a stable agent repeats the same
-        // (often multi-KB) prompt every turn — so replace a turn's `systemPrompt`
-        // with a sentinel when it's byte-identical to the previous turn's. The
-        // prompt is still shown in full whenever it changes, so prompt evolution
-        // stays visible.
-        let lastFullPrompt;
-        let lastFullIndex = '';
-        const turns = ((_f = (_e = (_d = this.driver) === null || _d === void 0 ? void 0 : _d.getTurnSnapshots) === null || _e === void 0 ? void 0 : _e.call(_d)) !== null && _f !== void 0 ? _f : []).map((t) => {
-            let { systemPrompt } = t;
-            if (systemPrompt != null && systemPrompt === lastFullPrompt) {
-                systemPrompt = `<repeated — identical to turn ${lastFullIndex}>`;
-            }
-            else if (systemPrompt != null) {
-                lastFullPrompt = systemPrompt;
-                lastFullIndex = t.turnIndex;
-            }
-            return Object.assign(Object.assign({ kind: 'turn' }, t), { systemPrompt });
+        // The message/turn/event timeline entries — built by the shared, pure `buildTimelineEntries`
+        // (the same helper a headless consumer uses to harvest its own log), from the driver's pull
+        // surfaces. Prefer the driver's raw history (carries sub-agent traces) over the redux projection.
+        const timelineEntries = buildTimelineEntries({
+            turnSnapshots: (_f = (_e = (_d = this.driver) === null || _d === void 0 ? void 0 : _d.getTurnSnapshots) === null || _e === void 0 ? void 0 : _e.call(_d)) !== null && _f !== void 0 ? _f : [],
+            messages: (_j = (_h = (_g = this.driver) === null || _g === void 0 ? void 0 : _g.getRawHistory) === null || _h === void 0 ? void 0 : _h.call(_g)) !== null && _j !== void 0 ? _j : this.messages,
+            metaEvents: stateKey ? getMetaEvents(stateKey) : [],
         });
-        // Sub-agent conversations are stored nested on the parent tool call's
-        // `subAgentTrace`; `flattenSubAgentMessages` hoists them to top-level
-        // `kind: 'message'` entries (breadcrumbed + correlated, the nested copy moved
-        // out — not duplicated) so the timeline reads as one chronological sequence.
-        const messages = (_j = (_h = (_g = this.driver) === null || _g === void 0 ? void 0 : _g.getRawHistory) === null || _h === void 0 ? void 0 : _h.call(_g)) !== null && _j !== void 0 ? _j : this.messages;
-        const messageEntries = flattenSubAgentMessages(messages);
-        const eventEntries = (stateKey ? getMetaEvents(stateKey) : []).map((e) => (Object.assign({ kind: 'event' }, e)));
         // The export-time `meta` block, carried on a `meta-snapshot` entry so it lives
         // in the same forward stream (the latest one wins on reassembly, and the
         // accumulated history exposes config/state evolution across the lifetime).
@@ -2509,7 +2491,15 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
             activePrimerHistory: m.activePrimerHistory,
             activeFoldStack: m.activeFoldStack,
         });
-        return [...messageEntries, ...turns, ...eventEntries, metaSnapshot];
+        // Fold in any external diagnostics harvested from an out-of-band driver (e.g. a server-side
+        // ChatDriver whose collated log an interaction widget returned on its result). They ride the
+        // same download + persisted-diagnostics path; `assembleDebugLog` sorts the whole timeline by
+        // timestamp so they interleave chronologically. (GENC-1461 unified diagnostics.)
+        return [
+            ...timelineEntries,
+            ...((_s = (_r = (_q = this.driver) === null || _q === void 0 ? void 0 : _q.getExternalDiagnostics) === null || _r === void 0 ? void 0 : _r.call(_q)) !== null && _s !== void 0 ? _s : []),
+            metaSnapshot,
+        ];
     }
     downloadDebugLog() {
         return __awaiter(this, void 0, void 0, function* () {

package/dist/esm/state/debug-event-log.js

@@ -60,6 +60,7 @@ export const META_EVENT_IMPORTANCE = {
     'provider.selected': 'normal',
     'interaction.requested': 'normal',
     'interaction.resolved': 'normal',
+    'external-diagnostics.folded': 'normal',
     'session.cleared': 'normal',
     'session.switched': 'low',
     'session.switch-deferred': 'low',

package/dist/esm/state/persistence/build-timeline-entries.js

@@ -0,0 +1,46 @@
+/**
+ * Shared, pure builder for the debug-log timeline entries (`message` / `turn` / `event`) — the
+ * common core of the host element's `buildDiagnosticEntries` and any HEADLESS consumer that drives
+ * a `ChatDriver` of its own (e.g. `ai-service` running the engine server-side) and needs to harvest
+ * that engine's debug log for the client to fold into its own download / persisted stream
+ * (GENC-1461 unified diagnostics). DOM-clean and dependency-light so it works in bare Node.
+ *
+ * It deliberately excludes the `meta-snapshot` entry: that block is host/DOM-specific (it reads
+ * `window.location.host`, the element's agent list, live context/cost), and a merged log keeps only
+ * the newest snapshot anyway — a headless source's agent/prompt/tools are already captured in its
+ * `turn` entries.
+ *
+ * @packageDocumentation
+ */
+import { flattenSubAgentMessages } from '../../utils/flatten-sub-agent-messages';
+/**
+ * Build the `message` / `turn` / `event` timeline entries from a driver's pull surfaces
+ * (`getRawHistory()` / `getTurnSnapshots()` / `getMetaEvents(sessionKey)`). Order within the array
+ * is message → turn → event; the caller (`assembleDebugLog`) sorts the whole timeline by timestamp,
+ * so this ordering only sets the co-timestamp tie-break. Pure.
+ */
+export function buildTimelineEntries(input) {
+    const { turnSnapshots, messages, metaEvents } = input;
+    // Collapse a turn's systemPrompt when byte-identical to the previous turn's — a stable agent
+    // repeats the same (often multi-KB) prompt every turn, while a stateful agent's changes. The
+    // prompt is shown in full whenever it changes, so prompt evolution stays visible.
+    let lastFullPrompt;
+    let lastFullIndex = '';
+    const turns = turnSnapshots.map((t) => {
+        let { systemPrompt } = t;
+        if (systemPrompt != null && systemPrompt === lastFullPrompt) {
+            systemPrompt = `<repeated — identical to turn ${lastFullIndex}>`;
+        }
+        else if (systemPrompt != null) {
+            lastFullPrompt = systemPrompt;
+            lastFullIndex = t.turnIndex;
+        }
+        return Object.assign(Object.assign({ kind: 'turn' }, t), { systemPrompt });
+    });
+    // Sub-agent conversations are stored nested on the parent tool call's `subAgentTrace`;
+    // `flattenSubAgentMessages` hoists them to top-level `kind: 'message'` entries (breadcrumbed +
+    // correlated, the nested copy moved out — not duplicated) so the timeline reads chronologically.
+    const messageEntries = flattenSubAgentMessages(messages);
+    const eventEntries = metaEvents.map((e) => (Object.assign({ kind: 'event' }, e)));
+    return [...messageEntries, ...turns, ...eventEntries];
+}

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/chat-driver-node.ts","../src/index.ts","../src/channel/ai-activity-bus.ts","../src/channel/ai-activity-channel.ts","../src/components/flowing-waves-indicator.ts","../src/components/halo-overlay.ts","../src/components/plasma-orb-indicator.ts","../src/components/waves-indicator.ts","../src/components/activity-halo/activity-halo.ts","../src/components/agent-picker/agent-picker.constants.ts","../src/components/agent-picker/agent-picker.styles.ts","../src/components/agent-picker/agent-picker.template.ts","../src/components/agent-picker/agent-picker.ts","../src/components/agent-picker/index.ts","../src/components/ai-driver/ai-driver.ts","../src/components/ai-driver/index.ts","../src/components/chat-bubble/chat-bubble.styles.ts","../src/components/chat-bubble/chat-bubble.template.ts","../src/components/chat-bubble/chat-bubble.ts","../src/components/chat-bubble/index.ts","../src/components/chat-driver/align-event-globals.ts","../src/components/chat-driver/chat-driver.compact.test.ts","../src/components/chat-driver/chat-driver.test.ts","../src/components/chat-driver/chat-driver.ts","../src/components/chat-driver/index.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.styles.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.template.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.test.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts","../src/components/chat-interaction-wrapper/index.ts","../src/components/chat-markdown/chat-markdown.ts","../src/components/chat-markdown/index.ts","../src/components/orchestrating-driver/index.ts","../src/components/orchestrating-driver/orchestrating-driver.pin.test.ts","../src/components/orchestrating-driver/orchestrating-driver.ts","../src/components/popout-manager/index.ts","../src/components/popout-manager/popout-manager.ts","../src/components/settings-modal/index.ts","../src/components/settings-modal/settings-modal.styles.ts","../src/components/settings-modal/settings-modal.template.ts","../src/config/config.ts","../src/config/define-stateful-agent.test.ts","../src/config/define-stateful-agent.ts","../src/config/fallback-agents.ts","../src/config/index.ts","../src/config/validate-providers.test.ts","../src/config/validate-providers.ts","../src/main/index.ts","../src/main/main.styles.ts","../src/main/main.template.ts","../src/main/main.ts","../src/main/main.types.ts","../src/main/popout-interaction-gate.test.ts","../src/provider/ai-provider-switcher.ts","../src/provider/assistant-app-settings.ts","../src/state/ai-assistant-slice.test.ts","../src/state/ai-assistant-slice.ts","../src/state/debug-event-log.test.ts","../src/state/debug-event-log.ts","../src/state/driver-registry.test.ts","../src/state/driver-registry.ts","../src/state/interaction-context.test.ts","../src/state/interaction-context.ts","../src/state/session-store.ts","../src/state/persistence/diagnostics-cursors.test.ts","../src/state/persistence/diagnostics-cursors.ts","../src/state/persistence/diagnostics.test.ts","../src/state/persistence/diagnostics.ts","../src/state/persistence/index.ts","../src/state/persistence/persister-registry.ts","../src/state/persistence/session-persistence-provider.test.ts","../src/state/persistence/session-persistence-provider.ts","../src/state/persistence/session-persistence.integration.test.ts","../src/state/persistence/session-persister.test.ts","../src/state/persistence/session-persister.ts","../src/state/persistence/session-snapshot.test.ts","../src/state/persistence/session-snapshot.ts","../src/state/persistence/stateful-restore.e2e.test.ts","../src/styles/ai-colours.ts","../src/suggestions/chat-suggestions.ts","../src/tags/index.ts","../src/types/ai-chat-widget.ts","../src/types/interaction-context.ts","../src/utils/animated-panel-toggle.ts","../src/utils/animation-exclusivity.test.ts","../src/utils/animation-exclusivity.ts","../src/utils/collect-session-models.test.ts","../src/utils/collect-session-models.ts","../src/utils/condense-history.test.ts","../src/utils/condense-history.ts","../src/utils/cost-session-history.test.ts","../src/utils/cost-session-history.ts","../src/utils/derive-cost-session-title.test.ts","../src/utils/derive-cost-session-title.ts","../src/utils/flatten-sub-agent-messages.test.ts","../src/utils/flatten-sub-agent-messages.ts","../src/utils/history-transform.test.ts","../src/utils/history-transform.ts","../src/utils/index.ts","../src/utils/logger.ts","../src/utils/message-partition.test.ts","../src/utils/message-partition.ts","../src/utils/resolve-cost-history-config.test.ts","../src/utils/resolve-cost-history-config.ts","../src/utils/resolve-preference-baseline.test.ts","../src/utils/resolve-preference-baseline.ts","../src/utils/strip-agent-handlers.test.ts","../src/utils/strip-agent-handlers.ts","../src/utils/sum-costs.test.ts","../src/utils/sum-costs.ts","../src/utils/sum-tokens.test.ts","../src/utils/sum-tokens.ts","../src/utils/tool-fold.ts","../src/utils/with-timeout.ts"],"version":"5.9.2"}
+{"root":["../src/chat-driver-node.ts","../src/index.ts","../src/channel/ai-activity-bus.ts","../src/channel/ai-activity-channel.ts","../src/components/flowing-waves-indicator.ts","../src/components/halo-overlay.ts","../src/components/plasma-orb-indicator.ts","../src/components/waves-indicator.ts","../src/components/activity-halo/activity-halo.ts","../src/components/agent-picker/agent-picker.constants.ts","../src/components/agent-picker/agent-picker.styles.ts","../src/components/agent-picker/agent-picker.template.ts","../src/components/agent-picker/agent-picker.ts","../src/components/agent-picker/index.ts","../src/components/ai-driver/ai-driver.ts","../src/components/ai-driver/index.ts","../src/components/chat-bubble/chat-bubble.styles.ts","../src/components/chat-bubble/chat-bubble.template.ts","../src/components/chat-bubble/chat-bubble.ts","../src/components/chat-bubble/index.ts","../src/components/chat-driver/align-event-globals.ts","../src/components/chat-driver/chat-driver.compact.test.ts","../src/components/chat-driver/chat-driver.test.ts","../src/components/chat-driver/chat-driver.ts","../src/components/chat-driver/index.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.styles.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.template.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.test.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts","../src/components/chat-interaction-wrapper/index.ts","../src/components/chat-markdown/chat-markdown.ts","../src/components/chat-markdown/index.ts","../src/components/orchestrating-driver/index.ts","../src/components/orchestrating-driver/orchestrating-driver.pin.test.ts","../src/components/orchestrating-driver/orchestrating-driver.ts","../src/components/popout-manager/index.ts","../src/components/popout-manager/popout-manager.ts","../src/components/settings-modal/index.ts","../src/components/settings-modal/settings-modal.styles.ts","../src/components/settings-modal/settings-modal.template.ts","../src/config/config.ts","../src/config/define-stateful-agent.test.ts","../src/config/define-stateful-agent.ts","../src/config/fallback-agents.ts","../src/config/index.ts","../src/config/validate-providers.test.ts","../src/config/validate-providers.ts","../src/main/index.ts","../src/main/main.styles.ts","../src/main/main.template.ts","../src/main/main.ts","../src/main/main.types.ts","../src/main/popout-interaction-gate.test.ts","../src/provider/ai-provider-switcher.ts","../src/provider/assistant-app-settings.ts","../src/state/ai-assistant-slice.test.ts","../src/state/ai-assistant-slice.ts","../src/state/debug-event-log.test.ts","../src/state/debug-event-log.ts","../src/state/driver-registry.test.ts","../src/state/driver-registry.ts","../src/state/interaction-context.test.ts","../src/state/interaction-context.ts","../src/state/session-store.ts","../src/state/persistence/build-timeline-entries.ts","../src/state/persistence/diagnostics-cursors.test.ts","../src/state/persistence/diagnostics-cursors.ts","../src/state/persistence/diagnostics.test.ts","../src/state/persistence/diagnostics.ts","../src/state/persistence/index.ts","../src/state/persistence/persister-registry.ts","../src/state/persistence/session-persistence-provider.test.ts","../src/state/persistence/session-persistence-provider.ts","../src/state/persistence/session-persistence.integration.test.ts","../src/state/persistence/session-persister.test.ts","../src/state/persistence/session-persister.ts","../src/state/persistence/session-snapshot.test.ts","../src/state/persistence/session-snapshot.ts","../src/state/persistence/stateful-restore.e2e.test.ts","../src/styles/ai-colours.ts","../src/suggestions/chat-suggestions.ts","../src/tags/index.ts","../src/types/ai-chat-widget.ts","../src/types/interaction-context.ts","../src/utils/animated-panel-toggle.ts","../src/utils/animation-exclusivity.test.ts","../src/utils/animation-exclusivity.ts","../src/utils/collect-session-models.test.ts","../src/utils/collect-session-models.ts","../src/utils/condense-history.test.ts","../src/utils/condense-history.ts","../src/utils/cost-session-history.test.ts","../src/utils/cost-session-history.ts","../src/utils/derive-cost-session-title.test.ts","../src/utils/derive-cost-session-title.ts","../src/utils/flatten-sub-agent-messages.test.ts","../src/utils/flatten-sub-agent-messages.ts","../src/utils/history-transform.test.ts","../src/utils/history-transform.ts","../src/utils/index.ts","../src/utils/logger.ts","../src/utils/message-partition.test.ts","../src/utils/message-partition.ts","../src/utils/resolve-cost-history-config.test.ts","../src/utils/resolve-cost-history-config.ts","../src/utils/resolve-preference-baseline.test.ts","../src/utils/resolve-preference-baseline.ts","../src/utils/strip-agent-handlers.test.ts","../src/utils/strip-agent-handlers.ts","../src/utils/sum-costs.test.ts","../src/utils/sum-costs.ts","../src/utils/sum-tokens.test.ts","../src/utils/sum-tokens.ts","../src/utils/tool-fold.ts","../src/utils/with-timeout.ts"],"version":"5.9.2"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "14.498.0",
+  "version": "14.499.0",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -73,26 +73,26 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.498.0",
-    "@genesislcap/genx": "14.498.0",
-    "@genesislcap/rollup-builder": "14.498.0",
-    "@genesislcap/ts-builder": "14.498.0",
-    "@genesislcap/uvu-playwright-builder": "14.498.0",
-    "@genesislcap/vite-builder": "14.498.0",
-    "@genesislcap/webpack-builder": "14.498.0",
+    "@genesislcap/foundation-testing": "14.499.0",
+    "@genesislcap/genx": "14.499.0",
+    "@genesislcap/rollup-builder": "14.499.0",
+    "@genesislcap/ts-builder": "14.499.0",
+    "@genesislcap/uvu-playwright-builder": "14.499.0",
+    "@genesislcap/vite-builder": "14.499.0",
+    "@genesislcap/webpack-builder": "14.499.0",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2",
     "esbuild": "0.25.12"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "14.498.0",
-    "@genesislcap/foundation-logger": "14.498.0",
-    "@genesislcap/foundation-notifications": "14.498.0",
-    "@genesislcap/foundation-redux": "14.498.0",
-    "@genesislcap/foundation-ui": "14.498.0",
-    "@genesislcap/foundation-utils": "14.498.0",
-    "@genesislcap/rapid-design-system": "14.498.0",
-    "@genesislcap/web-core": "14.498.0",
+    "@genesislcap/foundation-ai": "14.499.0",
+    "@genesislcap/foundation-logger": "14.499.0",
+    "@genesislcap/foundation-notifications": "14.499.0",
+    "@genesislcap/foundation-redux": "14.499.0",
+    "@genesislcap/foundation-ui": "14.499.0",
+    "@genesislcap/foundation-utils": "14.499.0",
+    "@genesislcap/rapid-design-system": "14.499.0",
+    "@genesislcap/web-core": "14.499.0",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
@@ -105,5 +105,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "88a07e46851fa94efc9399c50975c9eb2c21168c"
+  "gitHead": "49903bfdc57c5c5a7dd0d711d9717908df0b7ac7"
 }

package/src/chat-driver-node.ts

@@ -37,6 +37,12 @@ export {
   GeminiProvider,
   GeminiTransport,
   MutableAIProviderRegistry,
+  // Supported-model allowlists — so a headless consumer validates a configured model id against
+  // foundation-ai's REAL list instead of maintaining a parallel hardcoded copy that silently drifts
+  // as the platform adds models (a valid new model would otherwise look like a misconfiguration).
+  // GENC-1461, create PR #1644 review.
+  SUPPORTED_ANTHROPIC_MODEL_IDS,
+  SUPPORTED_GEMINI_MODEL_IDS,
   isObservableAIProviderRegistry,
 } from '@genesislcap/foundation-ai';
 export type {
@@ -52,3 +58,17 @@ export type {
   ChatToolHandlers,
   GeminiModelId,
 } from '@genesislcap/foundation-ai';
+
+// Debug-log harvesting (GENC-1461 unified diagnostics). A headless consumer collates its driver's
+// log — `buildTimelineEntries({ turnSnapshots: driver.getTurnSnapshots(), messages:
+// driver.getHistory(), metaEvents: getMetaEvents(sessionKey) })` → `DiagnosticEntry[]` — ships it to
+// the client, which folds it into the assistant's debug log via `InteractionResult.diagnostics`
+// (see `ChatDriver.getExternalDiagnostics`). `clearSession(sessionKey)` drops the per-request
+// meta-event bucket so the long-lived server process's module registry doesn't grow unbounded.
+// All three modules are DOM-clean, so the node entry stays Node-loadable.
+export { clearSession, getMetaEvents } from './state/debug-event-log';
+export type { MetaEvent } from './state/debug-event-log';
+export { buildTimelineEntries } from './state/persistence/build-timeline-entries';
+export type { TurnSnapshotLike } from './state/persistence/build-timeline-entries';
+export { assembleDebugLog } from './state/persistence/diagnostics';
+export type { DebugLog, DiagnosticEntry } from './state/persistence/diagnostics';

package/src/components/ai-driver/ai-driver.ts

@@ -5,6 +5,7 @@ import type {
   ChatToolDefinition,
 } from '@genesislcap/foundation-ai';
 import type { AgentConfig } from '../../config/config';
+import type { DiagnosticEntry } from '../../state/persistence/diagnostics';
 import type { InteractionContext } from '../../types/interaction-context';
 import type { TurnSnapshot } from '../chat-driver/chat-driver';
 
@@ -121,6 +122,14 @@ export interface AiDriver extends EventTarget {
    */
   getTurnSnapshots?(): ReadonlyArray<TurnSnapshot>;
 
+  /**
+   * Diagnostic-log entries harvested from resolved interactions (e.g. a server-side ChatDriver's
+   * collated debug log, returned on `InteractionResult.diagnostics`). The host folds these into its
+   * debug log. Optional for the same leaf/orchestrator reason as `getTurnSnapshots`.
+   * (GENC-1461 unified diagnostics.)
+   */
+  getExternalDiagnostics?(): ReadonlyArray<DiagnosticEntry>;
+
   /**
    * Name of the AI provider used on the most recent turn. Falls back to the
    * registry's default name when no turn has run yet.