@vybestack/llxprt-code-core 0.10.0 → 0.11.0-nightly.260728.ffaa8d5d7

package/dist/src/recording/replay-test-helpers.js

@@ -143,6 +143,19 @@ export function _directoriesChangedLine(seq, directories) {
         payload: { directories },
     });
 }
+/**
+ * Build a valid JSONL line for a session_metadata event (issue #1611).
+ * The title is either a concrete string or explicit null.
+ */
+export function sessionMetadataLine(seq, title) {
+    return JSON.stringify({
+        v: 1,
+        seq,
+        ts: new Date().toISOString(),
+        type: 'session_metadata',
+        payload: { title },
+    });
+}
 /**
  * Write raw JSONL lines to a file.
  */

package/dist/src/recording/replay-test-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"replay-test-helpers.js","sourceRoot":"","sources":["../../../src/recording/replay-test-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"replay-test-helpers.js","sourceRoot":"","sources":["../../../src/recording/replay-test-helpers.ts"],"names":[],"mappings":"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"}

package/dist/src/recording/resumeNotFoundMessages.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The "session not found"-style messages the resume/discovery flow emits, as
+ * shared constants so downstream classifiers (e.g. the Zed ACP loadSession
+ * error mapper) can match them WITHOUT string-literal coupling that would
+ * silently break if the wording changed. The emitting sites
+ * (resumeSession.ts, SessionDiscovery.ts) and every matcher must reference
+ * these — never inline copies of the sentences.
+ */
+/** Emitted by resumeSession when the project has no recorded sessions at all. */
+export declare const RESUME_NO_SESSIONS_FOUND = "No sessions found for this project";
+/**
+ * Prefix (including the trailing colon) of the
+ * SessionDiscovery.resolveSessionRef message for an unknown session reference;
+ * the full message appends ` <ref>` (space + ref) after it — see
+ * {@link resumeSessionNotFoundMessage}.
+ */
+export declare const RESUME_SESSION_NOT_FOUND_PREFIX = "Session not found for this project:";
+/**
+ * Builds the full SessionDiscovery.resolveSessionRef not-found message for a
+ * specific reference.
+ */
+export declare function resumeSessionNotFoundMessage(ref: string): string;
+/**
+ * Prefix of the SessionDiscovery.resolveSessionRef message for a numeric
+ * session index outside the listing range; the full message is
+ * `Session index <n> out of range (1-<m>)`.
+ */
+export declare const RESUME_SESSION_INDEX_OUT_OF_RANGE_PREFIX = "Session index ";
+/**
+ * Builds the full SessionDiscovery.resolveSessionRef out-of-range message for
+ * a specific index and session count. `ref` must render as digits (a number,
+ * or the digit-only string the caller already validated with /^\d+$/) so the
+ * produced message stays matchable by
+ * {@link RESUME_SESSION_INDEX_OUT_OF_RANGE_RE}.
+ */
+export declare function resumeSessionIndexOutOfRangeMessage(ref: number | `${number}`, count: number): string;
+/**
+ * Matches the out-of-range message shape for classifiers that only have the
+ * final (envelope-wrapped) detail string to inspect.
+ */
+export declare const RESUME_SESSION_INDEX_OUT_OF_RANGE_RE: RegExp;

package/dist/src/recording/resumeNotFoundMessages.js

@@ -0,0 +1,64 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The "session not found"-style messages the resume/discovery flow emits, as
+ * shared constants so downstream classifiers (e.g. the Zed ACP loadSession
+ * error mapper) can match them WITHOUT string-literal coupling that would
+ * silently break if the wording changed. The emitting sites
+ * (resumeSession.ts, SessionDiscovery.ts) and every matcher must reference
+ * these — never inline copies of the sentences.
+ */
+/** Emitted by resumeSession when the project has no recorded sessions at all. */
+export const RESUME_NO_SESSIONS_FOUND = 'No sessions found for this project';
+/**
+ * Prefix (including the trailing colon) of the
+ * SessionDiscovery.resolveSessionRef message for an unknown session reference;
+ * the full message appends ` <ref>` (space + ref) after it — see
+ * {@link resumeSessionNotFoundMessage}.
+ */
+export const RESUME_SESSION_NOT_FOUND_PREFIX = 'Session not found for this project:';
+/**
+ * Builds the full SessionDiscovery.resolveSessionRef not-found message for a
+ * specific reference.
+ */
+export function resumeSessionNotFoundMessage(ref) {
+    return `${RESUME_SESSION_NOT_FOUND_PREFIX} ${ref}`;
+}
+/**
+ * Prefix of the SessionDiscovery.resolveSessionRef message for a numeric
+ * session index outside the listing range; the full message is
+ * `Session index <n> out of range (1-<m>)`.
+ */
+export const RESUME_SESSION_INDEX_OUT_OF_RANGE_PREFIX = 'Session index ';
+/**
+ * Builds the full SessionDiscovery.resolveSessionRef out-of-range message for
+ * a specific index and session count. `ref` must render as digits (a number,
+ * or the digit-only string the caller already validated with /^\d+$/) so the
+ * produced message stays matchable by
+ * {@link RESUME_SESSION_INDEX_OUT_OF_RANGE_RE}.
+ */
+export function resumeSessionIndexOutOfRangeMessage(ref, count) {
+    if (count <= 0) {
+        return RESUME_NO_SESSIONS_FOUND;
+    }
+    return `${RESUME_SESSION_INDEX_OUT_OF_RANGE_PREFIX}${ref} out of range (1-${count})`;
+}
+/**
+ * Matches the out-of-range message shape for classifiers that only have the
+ * final (envelope-wrapped) detail string to inspect.
+ */
+export const RESUME_SESSION_INDEX_OUT_OF_RANGE_RE = /^(?:Failed to resume session: )?Session index \d+ out of range \(1-\d+\)$/;
+//# sourceMappingURL=resumeNotFoundMessages.js.map

package/dist/src/recording/resumeNotFoundMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumeNotFoundMessages.js","sourceRoot":"","sources":["../../../src/recording/resumeNotFoundMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AAEH,iFAAiF;AACjF,MAAM,CAAC,MAAM,wBAAwB,GAAG,oCAAoC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAC1C,qCAAqC,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,GAAW;IACtD,OAAO,GAAG,+BAA+B,IAAI,GAAG,EAAE,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAG,gBAAgB,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC,CACjD,GAAyB,EACzB,KAAa;IAEb,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,wBAAwB,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,wCAAwC,GAAG,GAAG,oBAAoB,KAAK,GAAG,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAC/C,2EAA2E,CAAC"}

package/dist/src/recording/resumeSession.js

@@ -26,6 +26,7 @@ import { SessionRecordingService } from './SessionRecordingService.js';
 import { SessionDiscovery } from './SessionDiscovery.js';
 import { SessionLockManager } from './SessionLockManager.js';
 import { replaySession } from './ReplayEngine.js';
+import { RESUME_NO_SESSIONS_FOUND } from './resumeNotFoundMessages.js';
 /**
  * Sentinel constant for "resume most recent session".
  */
@@ -74,7 +75,7 @@ function initializeRecordingForResume(lockedSession, request, replayResult) {
         provider: request.currentProvider,
         model: request.currentModel,
     });
-    recording.initializeForResume(lockedSession.targetFilePath, replayResult.lastSeq);
+    recording.initializeForResume(lockedSession.targetFilePath, replayResult.lastSeq, replayResult.metadata.title);
     if (request.currentProvider !== replayResult.metadata.provider ||
         request.currentModel !== replayResult.metadata.model) {
         recording.recordSessionEvent('warning', `Provider/model changed from ${replayResult.metadata.provider}/${replayResult.metadata.model} to ${request.currentProvider}/${request.currentModel}`);
@@ -95,7 +96,7 @@ export async function resumeSession(request) {
     // Step 1: Discover sessions
     const sessions = await SessionDiscovery.listSessions(request.chatsDir, request.projectHash);
     if (sessions.length === 0) {
-        return { ok: false, error: 'No sessions found for this project' };
+        return { ok: false, error: RESUME_NO_SESSIONS_FOUND };
     }
     // Step 2: Resolve which session to resume
     let lockedSession = null;

package/dist/src/recording/resumeSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"resumeSession.js","sourceRoot":"","sources":["../../../src/recording/resumeSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAmB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,qBAA8B,CAAC;AAyC9D;;;GAGG;AACH,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,qBAAqB,CAClC,OAAsB,EACtB,QAA0B;IAE1B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,iBAAiB,CACjD,OAAO,CAAC,WAAW,EACnB,QAAQ,CACT,CAAC;IACF,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,OAAO,CACjD,OAAO,CAAC,QAAQ,EAChB,MAAM,CACP,CAAC;QACF,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;IACtE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,4BAA4B,CACnC,aAA4B,EAC5B,OAAsB,EACtB,YAA4D;IAE5D,MAAM,SAAS,GAAG,IAAI,uBAAuB,CAAC;QAC5C,SAAS,EAAE,YAAY,CAAC,QAAQ,CAAC,SAAS;QAC1C,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,QAAQ,EAAE,OAAO,CAAC,eAAe;QACjC,KAAK,EAAE,OAAO,CAAC,YAAY;KAC5B,CAAC,CAAC;IACH,SAAS,CAAC,mBAAmB,CAC3B,aAAa,CAAC,cAAc,EAC5B,YAAY,CAAC,OAAO,CACrB,CAAC;IAEF,IACE,OAAO,CAAC,eAAe,KAAK,YAAY,CAAC,QAAQ,CAAC,QAAQ;QAC1D,OAAO,CAAC,YAAY,KAAK,YAAY,CAAC,QAAQ,CAAC,KAAK,EACpD,CAAC;QACD,SAAS,CAAC,kBAAkB,CAC1B,SAAS,EACT,+BAA+B,YAAY,CAAC,QAAQ,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,OAAO,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,YAAY,EAAE,CACrJ,CAAC;QACF,SAAS,CAAC,oBAAoB,CAC5B,OAAO,CAAC,eAAe,EACvB,OAAO,CAAC,YAAY,CACrB,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,kBAAkB,CAC1B,MAAM,EACN,uCAAuC,YAAY,CAAC,QAAQ,CAAC,SAAS,GAAG,CAC1E,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAsB;IAEtB,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,YAAY,CAClD,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,WAAW,CACpB,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;IACpE,CAAC;IAED,0CAA0C;IAC1C,IAAI,aAAa,GAAyB,IAAI,CAAC;IAE/C,IAAI,OAAO,CAAC,WAAW,KAAK,eAAe,EAAE,CAAC;QAC5C,aAAa,GAAG,MAAM,wBAAwB,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAE3E,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,0CAA0C;aAClD,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,CAAC,gBAAgB,IAAI,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACjD,aAAa,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,yBAAyB;IACzB,MAAM,YAAY,GAAG,MAAM,aAAa,CACtC,aAAa,CAAC,cAAc,EAC5B,OAAO,CAAC,WAAW,CACpB,CAAC;IACF,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;QACrB,MAAM,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACzC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,6BAA6B,YAAY,CAAC,KAAK,EAAE;SACzD,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,MAAM,SAAS,GAAG,4BAA4B,CAC5C,aAAa,EACb,OAAO,EACP,YAAY,CACb,CAAC;IAEF,wBAAwB;IACxB,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,SAAS;QACT,UAAU,EAAE,aAAa,CAAC,UAAU;QACpC,QAAQ,EAAE,YAAY,CAAC,QAAQ;KAChC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,cAAc,CAC3B,QAAgB,EAChB,MAAc;IAEd,IAAI,CAAC;QACH,OAAO,MAAM,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,wBAAwB,CACrC,QAAgB,EAChB,QAA0B;IAE1B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnE,IAAI,MAAM;YAAE,SAAS;QAErB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"resumeSession.js","sourceRoot":"","sources":["../../../src/recording/resumeSession.ts"],"names":[],"mappings":"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"}

package/dist/src/recording/sessionManagement.d.ts

@@ -55,3 +55,6 @@ export declare function listSessions(chatsDir: string, projectHash: string): Pro
  * @pseudocode session-management.md lines 105-150
  */
 export declare function deleteSession(ref: string, chatsDir: string, projectHash: string): Promise<DeleteSessionResult | DeleteSessionError>;
+export declare const SESSION_NOT_FOUND_PREFIX = "Session not found:";
+/** Delete a session only when the supplied identifier is an exact match. */
+export declare function deleteSessionById(sessionId: string, chatsDir: string, projectHash: string): Promise<DeleteSessionResult | DeleteSessionError>;

package/dist/src/recording/sessionManagement.js

@@ -14,7 +14,8 @@
  * limitations under the License.
  */
 import { SessionDiscovery } from './SessionDiscovery.js';
-import { SessionLockManager } from './SessionLockManager.js';
+import { SessionLockManager, SessionLockedError, } from './SessionLockManager.js';
+import { RESUME_NO_SESSIONS_FOUND } from './resumeNotFoundMessages.js';
 /**
  * List all sessions matching the given project hash, sorted newest-first.
  *
@@ -33,43 +34,61 @@ export async function listSessions(chatsDir, projectHash) {
 export async function deleteSession(ref, chatsDir, projectHash) {
     const sessions = await SessionDiscovery.listSessions(chatsDir, projectHash);
     if (sessions.length === 0) {
-        return { ok: false, error: 'No sessions found for this project' };
+        return { ok: false, error: RESUME_NO_SESSIONS_FOUND };
     }
     const resolved = SessionDiscovery.resolveSessionRef(ref, sessions);
     if ('error' in resolved) {
         return { ok: false, error: resolved.error };
     }
-    const target = resolved.session;
-    const locked = await SessionLockManager.isLocked(chatsDir, target.sessionId);
-    if (locked) {
-        const stale = await SessionLockManager.isStale(chatsDir, target.sessionId);
-        if (stale) {
-            await SessionLockManager.removeStaleLock(chatsDir, target.sessionId);
-        }
-        else {
+    return deleteResolvedSession(resolved.session, chatsDir);
+}
+export const SESSION_NOT_FOUND_PREFIX = 'Session not found:';
+/** Delete a session only when the supplied identifier is an exact match. */
+export async function deleteSessionById(sessionId, chatsDir, projectHash) {
+    const sessions = await SessionDiscovery.listSessions(chatsDir, projectHash);
+    const target = sessions.find((session) => session.sessionId === sessionId);
+    if (target === undefined) {
+        return {
+            ok: false,
+            error: `${SESSION_NOT_FOUND_PREFIX} ${sessionId}`,
+        };
+    }
+    return deleteResolvedSession(target, chatsDir);
+}
+async function deleteResolvedSession(target, chatsDir) {
+    let lock;
+    try {
+        lock = await SessionLockManager.acquire(chatsDir, target.sessionId);
+    }
+    catch (error) {
+        if (error instanceof SessionLockedError) {
             return {
                 ok: false,
                 error: 'Cannot delete: session is in use by another process',
             };
         }
+        const detail = error instanceof Error ? error.message : String(error);
+        return {
+            ok: false,
+            error: `Failed to lock session for deletion: ${detail}`,
+        };
     }
     const { unlink } = await import('node:fs/promises');
+    let result;
     try {
         await unlink(target.filePath);
+        result = { ok: true, deletedSessionId: target.sessionId };
     }
     catch (error) {
-        return {
+        const detail = error instanceof Error ? error.message : String(error);
+        result = {
             ok: false,
-            error: `Failed to delete session: ${error.message}`,
+            error: `Failed to delete session: ${detail}`,
         };
     }
-    const lockPath = SessionLockManager.getLockPath(chatsDir, target.sessionId);
-    try {
-        await unlink(lockPath);
-    }
-    catch {
-        // Lock file may not exist
+    finally {
+        await lock.release().catch(() => undefined);
     }
-    return { ok: true, deletedSessionId: target.sessionId };
+    return result;
 }
 //# sourceMappingURL=sessionManagement.js.map

package/dist/src/recording/sessionManagement.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessionManagement.js","sourceRoot":"","sources":["../../../src/recording/sessionManagement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAyB7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC5E,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,QAAgB,EAChB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAE5E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnE,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC;IAEhC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7E,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3E,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,kBAAkB,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,qDAAqD;aAC7D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAEpD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,6BAA8B,KAAe,CAAC,OAAO,EAAE;SAC/D,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5E,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"sessionManagement.js","sourceRoot":"","sources":["../../../src/recording/sessionManagement.ts"],"names":[],"mappings":"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"}

package/dist/src/recording/types.d.ts

@@ -22,10 +22,11 @@
  * management.
  */
 import { type IContent } from '../services/history/IContent.js';
+export declare const SESSION_TITLE_MAX_LENGTH = 120;
 /**
- * The seven event types that can appear in a session JSONL file.
+ * The event types that can appear in a session JSONL file.
  */
-export type SessionEventType = 'session_start' | 'content' | 'compressed' | 'rewind' | 'provider_switch' | 'session_event' | 'directories_changed';
+export type SessionEventType = 'session_start' | 'content' | 'compressed' | 'rewind' | 'provider_switch' | 'session_event' | 'session_metadata' | 'directories_changed';
 /**
  * Every line in a session JSONL file follows this envelope format.
  * The `v` field is the sole schema version indicator.
@@ -50,6 +51,8 @@ export interface SessionStartPayload {
     sessionId: string;
     projectHash: string;
     workspaceDirs: string[];
+    /** Effective absolute working directory, when recorded by newer clients. */
+    cwd?: string;
     provider: string;
     model: string;
     /** ISO-8601 timestamp of when the session started. */
@@ -92,6 +95,18 @@ export interface SessionEventPayload {
     severity: 'info' | 'warning' | 'error';
     message: string;
 }
+/**
+ * Payload for the `session_metadata` event — session-level metadata updates
+ * (currently only the human-readable title). The title is tri-state:
+ * - `undefined` (field absent): legacy event, no title assertion.
+ * - `null`: explicit untitled (the caller asserts there is no meaningful title).
+ * - `string`: a concrete title.
+ *
+ * This is a typed first-class recording event, NOT a `session_event` sentinel.
+ */
+export interface SessionMetadataPayload {
+    readonly title?: string | null;
+}
 /**
  * Payload for the `directories_changed` event.
  */
@@ -106,12 +121,21 @@ export interface SessionRecordingServiceConfig {
     projectHash: string;
     chatsDir: string;
     workspaceDirs: string[];
+    /** Effective absolute working directory for lifecycle discovery. */
+    cwd?: string;
     provider: string;
     model: string;
 }
 /**
  * Metadata extracted from a session's `session_start` event and updated
- * by subsequent `provider_switch` / `directories_changed` events.
+ * by subsequent `provider_switch` / `directories_changed` / `session_metadata`
+ * events.
+ *
+ * The title is tri-state:
+ * - `undefined`: no `session_metadata` event seen (legacy file). Callers fall
+ *   back to first-human-text heuristics.
+ * - `null`: explicit untitled (`session_metadata` asserted no title).
+ * - `string`: a concrete title.
  */
 export interface SessionMetadata {
     sessionId: string;
@@ -119,7 +143,9 @@ export interface SessionMetadata {
     provider: string;
     model: string;
     workspaceDirs: string[];
+    cwd?: string;
     startTime: string;
+    title?: string | null;
 }
 /**
  * Discriminated union result from the replay engine.
@@ -151,4 +177,17 @@ export interface SessionSummary {
     fileSize: number;
     provider: string;
     model: string;
+    cwd?: string;
+    /**
+     * Tri-state title from a persisted `session_metadata` event:
+     * - `undefined`: no `session_metadata` event seen (legacy fallback).
+     * - `null`: explicit untitled.
+     * - `string`: a concrete title.
+     */
+    title?: string | null;
+    /**
+     * Immutable creation timestamp extracted from `session_start.startTime`.
+     * Used for stable ordering independent of file `lastModified` mutations.
+     */
+    createdAt?: string;
 }

package/dist/src/recording/types.js

@@ -13,5 +13,5 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export {};
+export const SESSION_TITLE_MAX_LENGTH = 120;
 //# sourceMappingURL=types.js.map

package/dist/src/recording/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/recording/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/recording/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC"}

package/dist/src/runtime/AgentRuntimeLoader.js

@@ -36,6 +36,7 @@ function buildToolGovernance(profile) {
     const excludedRaw = profile.config.getExcludeTools() ?? [];
     return {
         allowed: new Set((allowedRaw ?? []).map((tool) => normalizeToolName(tool) ?? tool)),
+        allowedExplicit: allowedRaw !== undefined,
         disabled: new Set((disabledRaw ?? []).map((tool) => normalizeToolName(tool) ?? tool)),
         excluded: new Set(excludedRaw.map((tool) => normalizeToolName(tool) ?? tool)),
     };
@@ -48,7 +49,7 @@ function isToolPermitted(toolName, governance) {
     if (governance.disabled.has(canonical)) {
         return false;
     }
-    if (governance.allowed.size > 0 && !governance.allowed.has(canonical)) {
+    if (governance.allowedExplicit && !governance.allowed.has(canonical)) {
         return false;
     }
     return true;

package/dist/src/runtime/AgentRuntimeLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentRuntimeLoader.js","sourceRoot":"","sources":["../../../src/runtime/AgentRuntimeLoader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgentRuntimeLoader.js","sourceRoot":"","sources":["../../../src/runtime/AgentRuntimeLoader.ts"],"names":[],"mappings":"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"}

package/dist/src/scheduler/liveOutput.d.ts

@@ -3,28 +3,19 @@
  * Copyright 2025 Vybestack LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { AnsiOutput } from '../utils/terminalSerializer.js';
+import type { AnsiOutput, LiveOutputUpdate } from '../utils/terminalSerializer.js';
 /**
- * Accumulates a live-output chunk onto an existing value.
+ * Accumulates a live-output update onto an existing accumulated value using
+ * the explicit tagged {@link LiveOutputUpdate} protocol.
  *
- * Tools that stream via `canUpdateOutput` deliver chunks in one of two
- * semantics:
- *
- * - **`AnsiOutput`** (e.g. the shell tool) — a full terminal-buffer snapshot.
- *   Each chunk supersedes the previous one, so the latest snapshot replaces
- *   the old value.
- * - **`string`** (e.g. the task tool streaming subagent text) — an incremental
- *   delta.  Each chunk must be appended to the existing text so the display
- *   grows rather than showing only the latest token.
+ * - **`append`** (text deltas) — concatenated onto the existing value when it
+ *   is a string; otherwise the prior non-string value is dropped and the
+ *   delta starts a fresh string.
+ * - **`replace`** (terminal-buffer snapshots) — supersedes any prior value.
  *
  * The `existing` parameter is typed `unknown` because callers may pass values
  * drawn from a broader display union (e.g. `ToolResultDisplay`, which also
- * includes `FileDiff` / `FileRead`).  The function only ever appends when both
- * values are strings; any other combination replaces with the incoming chunk.
- *
- * Note: the append-vs-replace distinction is currently inferred from the
- * payload type.  Migrating to an explicit tagged update protocol (e.g.
- * `{ mode: 'append'; data: string } | { mode: 'replace'; data: AnsiOutput }`)
- * is tracked in follow-up #2586.
+ * includes `FileDiff` / `FileRead`). The returned type is the narrow
+ * `string | AnsiOutput` union the live-output channel actually produces.
  */
-export declare function accumulateLiveOutput(existing: unknown, chunk: string | AnsiOutput): string | AnsiOutput;
+export declare function accumulateLiveOutput(existing: unknown, update: LiveOutputUpdate): string | AnsiOutput;

package/dist/src/scheduler/liveOutput.js

@@ -4,31 +4,31 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 /**
- * Accumulates a live-output chunk onto an existing value.
+ * Accumulates a live-output update onto an existing accumulated value using
+ * the explicit tagged {@link LiveOutputUpdate} protocol.
  *
- * Tools that stream via `canUpdateOutput` deliver chunks in one of two
- * semantics:
- *
- * - **`AnsiOutput`** (e.g. the shell tool) — a full terminal-buffer snapshot.
- *   Each chunk supersedes the previous one, so the latest snapshot replaces
- *   the old value.
- * - **`string`** (e.g. the task tool streaming subagent text) — an incremental
- *   delta.  Each chunk must be appended to the existing text so the display
- *   grows rather than showing only the latest token.
+ * - **`append`** (text deltas) — concatenated onto the existing value when it
+ *   is a string; otherwise the prior non-string value is dropped and the
+ *   delta starts a fresh string.
+ * - **`replace`** (terminal-buffer snapshots) — supersedes any prior value.
  *
  * The `existing` parameter is typed `unknown` because callers may pass values
  * drawn from a broader display union (e.g. `ToolResultDisplay`, which also
- * includes `FileDiff` / `FileRead`).  The function only ever appends when both
- * values are strings; any other combination replaces with the incoming chunk.
- *
- * Note: the append-vs-replace distinction is currently inferred from the
- * payload type.  Migrating to an explicit tagged update protocol (e.g.
- * `{ mode: 'append'; data: string } | { mode: 'replace'; data: AnsiOutput }`)
- * is tracked in follow-up #2586.
+ * includes `FileDiff` / `FileRead`). The returned type is the narrow
+ * `string | AnsiOutput` union the live-output channel actually produces.
  */
-export function accumulateLiveOutput(existing, chunk) {
-    return typeof chunk === 'string' && typeof existing === 'string'
-        ? existing + chunk
-        : chunk;
+export function accumulateLiveOutput(existing, update) {
+    switch (update.mode) {
+        case 'append':
+            return typeof existing === 'string'
+                ? existing + update.data
+                : update.data;
+        case 'replace':
+            return update.data;
+        default: {
+            const _exhaustive = update;
+            return _exhaustive;
+        }
+    }
 }
 //# sourceMappingURL=liveOutput.js.map

package/dist/src/scheduler/liveOutput.js.map

@@ -1 +1 @@
-{"version":3,"file":"liveOutput.js","sourceRoot":"","sources":["../../../src/scheduler/liveOutput.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAiB,EACjB,KAA0B;IAE1B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAC9D,CAAC,CAAC,QAAQ,GAAG,KAAK;QAClB,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC"}
+{"version":3,"file":"liveOutput.js","sourceRoot":"","sources":["../../../src/scheduler/liveOutput.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAiB,EACjB,MAAwB;IAExB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,OAAO,QAAQ,KAAK,QAAQ;gBACjC,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI;gBACxB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,MAAM,CAAC;YAClC,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/scheduler/types.d.ts

@@ -13,7 +13,7 @@
 import type { AnyDeclarativeTool, AnyToolInvocation, ToolCallConfirmationDetails } from '@vybestack/llxprt-code-tools';
 import type { ToolCallRequestInfo, ToolCallResponseInfo } from '../core/turn.js';
 import type { ToolConfirmationOutcome } from '@vybestack/llxprt-code-tools';
-import type { AnsiOutput } from '../utils/terminalSerializer.js';
+import type { AnsiOutput, LiveOutputUpdate } from '../utils/terminalSerializer.js';
 import type { SerializableConfirmationDetails } from '../confirmation-bus/types.js';
 /**
  * @requirement TS-TYPE-001
@@ -101,7 +101,7 @@ export type Status = ToolCall['status'];
  * Handler Types - Callback function signatures for tool execution events
  */
 export type ConfirmHandler = (toolCall: WaitingToolCall) => Promise<ToolConfirmationOutcome>;
-export type OutputUpdateHandler = (toolCallId: string, outputChunk: string | AnsiOutput) => void;
+export type OutputUpdateHandler = (toolCallId: string, update: LiveOutputUpdate) => void;
 export type AllToolCallsCompleteHandler = (completedToolCalls: CompletedToolCall[]) => Promise<void>;
 export type ToolCallsUpdateHandler = (toolCalls: ToolCall[]) => void;
 /**

package/dist/src/services/history/ContentConverters.d.ts

@@ -24,6 +24,10 @@ export declare class ContentConverters {
     private static hasLegacyTruthyValue;
     /** Resolve the Gemini role from an IContent speaker. */
     private static resolveRole;
+    private static toolCallBlockToPart;
+    private static toolResponseBlockToPart;
+    private static thinkingBlockToPart;
+    private static codeBlockToPart;
     /** Convert a single IContent block to a Gemini Part. */
     private static blockToPart;
     /**