specrails-desktop 2.55.0 → 2.55.1

package/server/dist/{profiles-router.js → modules/agents/runtime/profiles-router.js}

@@ -6,17 +6,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.providerSupportsAgentStudioAutomation = providerSupportsAgentStudioAutomation;
 exports.createProfilesRouter = createProfilesRouter;
 const fs_1 = __importDefault(require("fs"));
-const core_runtime_1 = require("./core-runtime");
+const core_runtime_1 = require("../../../core-runtime");
 const path_1 = __importDefault(require("path"));
 const express_1 = require("express");
 const agent_generator_1 = require("./agent-generator");
 const agent_refine_db_1 = require("./agent-refine-db");
 const agent_refine_manager_1 = require("./agent-refine-manager");
-const providers_1 = require("./providers");
-const kimi_skill_prompt_1 = require("./providers/kimi-skill-prompt");
+const providers_1 = require("../../../providers");
+const kimi_skill_prompt_1 = require("../../../providers/kimi-skill-prompt");
 const profile_manager_1 = require("./profile-manager");
-const workspace_resolution_1 = require("./workspace-resolution");
-const project_router_helpers_1 = require("./project-router-helpers");
+const workspace_resolution_1 = require("../../../workspace-resolution");
+const project_router_helpers_1 = require("../../../project-router-helpers");
 /**
  * Relocate-artifacts gate: the dir whose `.specrails/{profiles,specrails-version}`
  * and provider-native roles catalog the profiles surface reads/writes.

package/server/dist/{browser-capture-manager.js → modules/browser/runtime/browser-capture-manager.js}

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BrowserCaptureManager = void 0;
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
-const ids_1 = require("./ids");
-const attachment_manager_1 = require("./attachment-manager");
+const ids_1 = require("../../../ids");
+const attachment_manager_1 = require("../../../attachment-manager");
 const browser_capture_types_1 = require("./browser-capture-types");
 const browser_playwright_1 = require("./browser-playwright");
 const browser_viewport_1 = require("./browser-viewport");
@@ -48,7 +48,6 @@ class BrowserCaptureManager {
     projectId;
     projectSlug;
     db;
-    broadcast;
     launcher;
     attachments;
     profileDir;
@@ -69,7 +68,6 @@ class BrowserCaptureManager {
         this.projectId = opts.projectId;
         this.projectSlug = opts.projectSlug;
         this.db = opts.db;
-        this.broadcast = opts.broadcast;
         this.launcher = opts.launcher ?? (0, browser_playwright_1.createPlaywrightLauncher)();
         this.attachments = opts.attachments ?? attachment_manager_1.attachmentManager;
         this.contextPool = opts.contextPool ?? null;

package/server/dist/{browser-playwright.js → modules/browser/runtime/browser-playwright.js}

@@ -14,7 +14,7 @@ exports.screencastParams = screencastParams;
 exports.normalizeUrl = normalizeUrl;
 exports.chromiumLaunchArgs = chromiumLaunchArgs;
 exports.createPlaywrightLauncher = createPlaywrightLauncher;
-const chromium_resolver_1 = require("./chromium-resolver");
+const chromium_resolver_1 = require("../../../chromium-resolver");
 const browser_network_1 = require("./browser-network");
 const browser_viewport_1 = require("./browser-viewport");
 /**

package/server/dist/{blueprint-chat-manager.js → modules/builder/runtime/blueprint-chat-manager.js}

@@ -7,19 +7,19 @@ exports.BlueprintChatManager = exports.BUILDER_TURN_INTENTS = void 0;
 exports.planSnapshotRepair = planSnapshotRepair;
 const crypto_1 = require("crypto");
 const tree_kill_1 = __importDefault(require("tree-kill"));
-const providers_1 = require("./providers");
-const runtime_1 = require("./providers/runtime");
-const spawn_lifecycle_1 = require("./spawn-lifecycle");
-const cli_prompt_1 = require("./util/cli-prompt");
-const result_event_1 = require("./result-event");
-const desktop_db_1 = require("./desktop-db");
+const providers_1 = require("../../../providers");
+const runtime_1 = require("../../../providers/runtime");
+const spawn_lifecycle_1 = require("../../execution/runtime/spawn-lifecycle");
+const cli_prompt_1 = require("../../../util/cli-prompt");
+const result_event_1 = require("../../accounting/runtime/result-event");
+const desktop_db_1 = require("../../../desktop-db");
 const builder_cwd_manager_1 = require("./builder-cwd-manager");
 const blueprint_operator_prompt_1 = require("./blueprint-operator-prompt");
 const blueprint_draft_parser_1 = require("./blueprint-draft-parser");
 const blueprint_draft_parser_2 = require("./blueprint-draft-parser");
 const blueprint_generation_1 = require("./blueprint-generation");
 const blueprint_spec_quality_1 = require("./blueprint-spec-quality");
-const explore_draft_title_1 = require("./explore-draft-title");
+const explore_draft_title_1 = require("../../conversations/runtime/explore-draft-title");
 const blueprint_store_1 = require("./blueprint-store");
 exports.BUILDER_TURN_INTENTS = ['surprise', 'approve'];
 function repairKindForRejection(reason) {

package/server/dist/{blueprint-commit.js → modules/builder/runtime/blueprint-commit.js}

@@ -10,19 +10,19 @@ const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const crypto_1 = require("crypto");
-const win_spawn_1 = require("./util/win-spawn");
-const desktop_db_1 = require("./desktop-db");
+const win_spawn_1 = require("../../../util/win-spawn");
+const desktop_db_1 = require("../../../desktop-db");
 const blueprint_store_1 = require("./blueprint-store");
-const providers_1 = require("./providers");
+const providers_1 = require("../../../providers");
 const blueprint_draft_parser_1 = require("./blueprint-draft-parser");
 const blueprint_types_1 = require("./blueprint-types");
 const blueprint_spec_quality_1 = require("./blueprint-spec-quality");
 const blueprint_render_1 = require("./blueprint-render");
-const offline_assemble_1 = require("./offline-assemble");
-const artifact_registry_1 = require("./artifact-registry");
-const workspace_manager_1 = require("./workspace-manager");
-const ticket_store_1 = require("./ticket-store");
-const project_router_helpers_1 = require("./project-router-helpers");
+const offline_assemble_1 = require("../../../offline-assemble");
+const artifact_registry_1 = require("../../../artifact-registry");
+const workspace_manager_1 = require("../../../workspace-manager");
+const ticket_store_1 = require("../../specs/runtime/ticket-store");
+const project_router_helpers_1 = require("../../../project-router-helpers");
 function execCli(bin, args, cwd) {
     return new Promise((resolve) => {
         const opts = { cwd, env: (0, win_spawn_1.windowsSpawnEnv)(), stdio: ['ignore', 'pipe', 'pipe'] };

package/server/dist/{blueprint-draft-parser.js → modules/builder/runtime/blueprint-draft-parser.js}

@@ -21,7 +21,7 @@ exports.coerceBlueprint = coerceBlueprint;
 exports.parseBlueprintDraftBlocks = parseBlueprintDraftBlocks;
 exports.cutUnterminatedBlock = cutUnterminatedBlock;
 const blueprint_types_1 = require("./blueprint-types");
-const json_tolerant_1 = require("./json-tolerant");
+const json_tolerant_1 = require("../../../json-tolerant");
 const FENCE_RE = /```blueprint-draft\s*\n([\s\S]*?)\n\s*```/g;
 const OPEN_FENCE_RE = /```blueprint-draft(?![\s\S]*?\n\s*```)/;
 // Fence tolerance: models mirror the schema example and sometimes emit the

package/server/dist/{blueprint-generation.js → modules/builder/runtime/blueprint-generation.js}

@@ -30,7 +30,7 @@ exports.mergeSpecDetails = mergeSpecDetails;
 exports.withSpecsComplete = withSpecsComplete;
 exports.rangeFilled = rangeFilled;
 exports.cutUnterminatedGenerationBlock = cutUnterminatedGenerationBlock;
-const json_tolerant_1 = require("./json-tolerant");
+const json_tolerant_1 = require("../../../json-tolerant");
 const blueprint_types_1 = require("./blueprint-types");
 exports.SPECS_PER_DETAIL_TURN = 2;
 /** Outline + detail turns + audit + one repair — 10 specs ⇒ 1 + 5 + 1 + 1. */

package/server/dist/{blueprint-operator-prompt.js → modules/builder/runtime/blueprint-operator-prompt.js}

@@ -16,7 +16,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SPEC_DEPTH_FLOORS = exports.SINGLE_RESPONSE_MODE_LINE = exports.BUILDER_SYSTEM_PROMPT = exports.BUILDER_INSTRUCTIONS = void 0;
 exports.buildSnapshotRepairPrompt = buildSnapshotRepairPrompt;
-const spec_contract_prompt_1 = require("./spec-contract-prompt");
+const spec_contract_prompt_1 = require("../../specs/runtime/spec-contract-prompt");
 Object.defineProperty(exports, "SPEC_DEPTH_FLOORS", { enumerable: true, get: function () { return spec_contract_prompt_1.SPEC_DEPTH_FLOORS; } });
 const blueprint_generation_1 = require("./blueprint-generation");
 const EXAMPLE_SPEC_JSON = JSON.stringify(spec_contract_prompt_1.PREMIUM_SCAFFOLD_EXAMPLE, null, 2)

package/server/dist/{blueprint-router.js → modules/builder/runtime/blueprint-router.js}

@@ -4,11 +4,11 @@ exports.isProjectBuilderEnabled = isProjectBuilderEnabled;
 exports.createBlueprintRouter = createBlueprintRouter;
 const express_1 = require("express");
 const blueprint_chat_manager_1 = require("./blueprint-chat-manager");
-const providers_1 = require("./providers");
-const runtime_1 = require("./providers/runtime");
+const providers_1 = require("../../../providers");
+const runtime_1 = require("../../../providers/runtime");
 const blueprint_store_1 = require("./blueprint-store");
 const blueprint_spec_quality_1 = require("./blueprint-spec-quality");
-const provider_selection_1 = require("./provider-selection");
+const provider_selection_1 = require("../../../provider-selection");
 function isProjectBuilderEnabled() {
     return process.env.SPECRAILS_PROJECT_BUILDER !== 'false';
 }

package/server/dist/{blueprint-spec-quality.js → modules/builder/runtime/blueprint-spec-quality.js}

@@ -6,7 +6,7 @@ exports.firstBuilderSpecQualityDetail = firstBuilderSpecQualityDetail;
 exports.analyzeTypedBuilderSpecs = analyzeTypedBuilderSpecs;
 exports.auditRawBlueprintForM1 = auditRawBlueprintForM1;
 exports.formatQualityIssuesForModel = formatQualityIssuesForModel;
-const spec_contract_prompt_1 = require("./spec-contract-prompt");
+const spec_contract_prompt_1 = require("../../specs/runtime/spec-contract-prompt");
 exports.BUILDER_SPEC_HEADINGS = [
     'Problem Statement',
     'Proposed Solution',

package/server/dist/{milestone-chain.js → modules/builder/runtime/milestone-chain.js}

@@ -19,7 +19,7 @@ exports.chunkTickets = chunkTickets;
 exports.chainRailName = chainRailName;
 const milestone_progress_1 = require("./milestone-progress");
 const milestone_chain_store_1 = require("./milestone-chain-store");
-const ids_1 = require("./ids");
+const ids_1 = require("../../../ids");
 exports.MAX_TICKETS_PER_CHAIN_CHUNK = 3;
 /** `SPECRAILS_MILESTONE_CHAIN=false|0|off` ⇒ every milestone launch is parallel and no row is written. */
 function isMilestoneChainEnabled(env = process.env) {

package/server/dist/{milestone-progress.js → modules/builder/runtime/milestone-progress.js}

@@ -21,12 +21,12 @@ exports.resolveBlueprintWorkspace = resolveBlueprintWorkspace;
 exports.readMilestoneProgress = readMilestoneProgress;
 exports.markMilestoneDone = markMilestoneDone;
 const blueprint_render_1 = require("./blueprint-render");
-const ticket_store_1 = require("./ticket-store");
-const rail_pr_store_1 = require("./rail-pr-store");
-const rails_store_1 = require("./rails-store");
-const loop_runs_store_1 = require("./loop-runs-store");
-const workspace_resolution_1 = require("./workspace-resolution");
-const workspace_manager_1 = require("./workspace-manager");
+const ticket_store_1 = require("../../specs/runtime/ticket-store");
+const rail_pr_store_1 = require("../../delivery/runtime/rail-pr-store");
+const rails_store_1 = require("../../delivery/runtime/rails-store");
+const loop_runs_store_1 = require("../../loops/runtime/loop-runs-store");
+const workspace_resolution_1 = require("../../../workspace-resolution");
+const workspace_manager_1 = require("../../../workspace-manager");
 function milestoneLabelFor(n) {
     return `M${n}`;
 }

package/server/dist/{code-activity.js → modules/code/runtime/code-activity.js}

@@ -4,7 +4,7 @@ exports.CodeActivityQueryError = void 0;
 exports.parseCodeActivityQuery = parseCodeActivityQuery;
 exports.listCodeActivity = listCodeActivity;
 const node_crypto_1 = require("node:crypto");
-const project_repositories_1 = require("./project-repositories");
+const project_repositories_1 = require("../../../project-repositories");
 class CodeActivityQueryError extends Error {
     status;
     constructor(message, status = 400) {

package/server/dist/{code-explorer-router.js → modules/code/runtime/code-explorer-router.js}

@@ -16,14 +16,14 @@ const path_1 = __importDefault(require("path"));
 const node_crypto_1 = require("node:crypto");
 const child_process_1 = require("child_process");
 const express_1 = require("express");
-const feature_flags_1 = require("./feature-flags");
-const build_dirs_1 = require("./build-dirs");
+const feature_flags_1 = require("../../../feature-flags");
+const build_dirs_1 = require("../../../build-dirs");
 const file_provenance_1 = require("./file-provenance");
 const file_summary_manager_1 = require("./file-summary-manager");
 const file_story_1 = require("./file-story");
-const project_repository_provenance_1 = require("./project-repository-provenance");
-const providers_1 = require("./providers");
-const project_repositories_1 = require("./project-repositories");
+const project_repository_provenance_1 = require("../../../project-repository-provenance");
+const providers_1 = require("../../../providers");
+const project_repositories_1 = require("../../../project-repositories");
 const code_activity_1 = require("./code-activity");
 const MAX_TREE_PAGE = 2000;
 const DEFAULT_MAX_TREE_ENTRIES = 20_000;

package/server/dist/{file-provenance.js → modules/code/runtime/file-provenance.js}

@@ -20,7 +20,7 @@ exports.broadcastProvenanceUpdated = broadcastProvenanceUpdated;
 const child_process_1 = require("child_process");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const project_repository_provenance_1 = require("./project-repository-provenance");
+const project_repository_provenance_1 = require("../../../project-repository-provenance");
 const MAX_PATCH_BYTES = 512 * 1024;
 // These git calls run synchronously on the main event loop (pre-spawn snapshot
 // and post-exit diff). Bound every one: a timeout so a stuck index.lock /

package/server/dist/{file-story-manager.js → modules/code/runtime/file-story-manager.js}

@@ -15,10 +15,10 @@ exports.buildStorySystemPrompt = buildStorySystemPrompt;
  * `file_story_contributions.summary` (see file-story.ts / migration 37).
  */
 const crypto_1 = require("crypto");
-const ai_invocations_1 = require("./ai-invocations");
+const ai_invocations_1 = require("../../accounting/runtime/ai-invocations");
 const file_story_1 = require("./file-story");
 const file_summary_manager_1 = require("./file-summary-manager");
-const project_repository_provenance_1 = require("./project-repository-provenance");
+const project_repository_provenance_1 = require("../../../project-repository-provenance");
 const STORY_PROMPT_EN = 'Explain to a non-developer what this recorded patch visibly changed in this file, in 2 to 4 clear sentences. ' +
     'Describe the responsibility or contract it adds, removes or changes using only the supplied patch. ' +
     'A current spec title is context, not proof of historical intent, successful tests, integration or deployment. ' +

package/server/dist/{file-story.js → modules/code/runtime/file-story.js}

@@ -33,8 +33,8 @@ exports.getFileStory = getFileStory;
  *    file-story-manager generates on demand.
  */
 const node_crypto_1 = require("node:crypto");
-const feature_flags_1 = require("./feature-flags");
-const project_repository_provenance_1 = require("./project-repository-provenance");
+const feature_flags_1 = require("../../../feature-flags");
+const project_repository_provenance_1 = require("../../../project-repository-provenance");
 const file_provenance_1 = require("./file-provenance");
 /** Warn threshold mirroring queue-manager's `provenance.large_job`. */
 const LARGE_RUN_WARN_FILES = 50;

package/server/dist/{file-summary-generator.js → modules/code/runtime/file-summary-generator.js}

@@ -7,9 +7,9 @@ exports.buildSystemPrompt = buildSystemPrompt;
 exports.createFileSummaryGenerator = createFileSummaryGenerator;
 const readline_1 = require("readline");
 const tree_kill_1 = __importDefault(require("tree-kill"));
-const cli_prompt_1 = require("./util/cli-prompt");
-const result_event_1 = require("./result-event");
-const runtime_1 = require("./providers/runtime");
+const cli_prompt_1 = require("../../../util/cli-prompt");
+const result_event_1 = require("../../accounting/runtime/result-event");
+const runtime_1 = require("../../../providers/runtime");
 const GENERATE_TIMEOUT_MS = 60_000;
 const SYSTEM_PROMPT_EN = 'Explain this file to a non-developer using only the supplied source snapshot. In 3 to 6 clear sentences, ' +
     'describe its purpose, main responsibilities, and any inputs, outputs or relationships directly visible in the source. ' +

package/server/dist/{file-summary-manager.js → modules/code/runtime/file-summary-manager.js}

@@ -55,9 +55,9 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const chokidar_1 = __importDefault(require("chokidar"));
 const _2020_1 = __importDefault(require("ajv/dist/2020"));
-const build_dirs_1 = require("./build-dirs");
-const ai_invocations_1 = require("./ai-invocations");
-const file_summary_v1_json_1 = __importDefault(require("./schemas/file-summary.v1.json"));
+const build_dirs_1 = require("../../../build-dirs");
+const ai_invocations_1 = require("../../accounting/runtime/ai-invocations");
+const file_summary_v1_json_1 = __importDefault(require("../../../schemas/file-summary.v1.json"));
 const SUMMARIES_REL = path.join('.specrails', 'file-summaries');
 // Current summary prompt version. Bump when buildSystemPrompt changes materially
 // so existing summaries are treated as stale and regenerated on next request.

package/server/dist/{project-code-discovery.js → modules/code/runtime/project-code-discovery.js}

@@ -7,8 +7,8 @@ exports.discoverProjectCode = discoverProjectCode;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_crypto_1 = require("node:crypto");
-const feature_flags_1 = require("./feature-flags");
-const project_repositories_1 = require("./project-repositories");
+const feature_flags_1 = require("../../../feature-flags");
+const project_repositories_1 = require("../../../project-repositories");
 const code_explorer_router_1 = require("./code-explorer-router");
 /** One project-wide budget, shared across all members. Every hit carries its
  * address; unavailable/partially scanned members cannot be mistaken for empty. */

package/server/dist/modules/conversations/domain/draft-stream.js

@@ -0,0 +1,91 @@
+"use strict";
+// ─── Live spec-draft fence stripper ──────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterDraftBlocksLive = filterDraftBlocksLive;
+const FENCE_OPEN = '```spec-draft';
+const FENCE_CLOSE = '```';
+/**
+ * I/O-free filter that advances caller-owned state and returns the
+ * substring that is safe to broadcast to the chat stream. Holds back partial
+ * fence markers in `state.pendingTail` so the next call can resolve them.
+ *
+ * Behaviour:
+ *  - While outside a block: emit text up to (but not including) the start of
+ *    a `\`\`\`spec-draft` marker. If no marker is present, hold back the
+ *    trailing few chars so a marker starting on a chunk boundary is not
+ *    leaked.
+ *  - While inside a block: emit nothing. Look for the closing `\`\`\``.
+ *    When found, consume it (plus an optional trailing newline) and resume
+ *    emitting from the bytes that follow.
+ *
+ * The filter intentionally does NOT validate the JSON payload — that is
+ * server-side concern of `parseSpecDraftBlocks`. It only strips the fenced
+ * span.
+ */
+function filterDraftBlocksLive(state, newText) {
+    let buf = state.pendingTail + newText;
+    let out = '';
+    state.pendingTail = '';
+    // Iterate in case a single delta contains multiple transitions
+    // (e.g. close + open + close again — pathological but cheap to support).
+    while (buf.length > 0) {
+        if (state.inBlock) {
+            const closeIdx = buf.indexOf(FENCE_CLOSE);
+            if (closeIdx === -1) {
+                // No close yet — but the close could span the chunk boundary.
+                // Hold back up to 2 trailing chars (closing fence is 3 chars; we keep
+                // any trailing run of `\`` so the next call resolves it).
+                const tailLen = trailingBacktickRun(buf, 2);
+                state.pendingTail = buf.slice(buf.length - tailLen);
+                return out;
+            }
+            // Consume the close fence + an optional trailing newline.
+            let after = closeIdx + FENCE_CLOSE.length;
+            if (buf[after] === '\n')
+                after += 1;
+            buf = buf.slice(after);
+            state.inBlock = false;
+            continue;
+        }
+        // Not in block: look for the open marker.
+        const openIdx = buf.indexOf(FENCE_OPEN);
+        if (openIdx !== -1) {
+            out += buf.slice(0, openIdx);
+            buf = buf.slice(openIdx + FENCE_OPEN.length);
+            // Drop an optional newline immediately after the open marker so the
+            // user never sees `\n` belonging to the fence.
+            if (buf[0] === '\n')
+                buf = buf.slice(1);
+            state.inBlock = true;
+            continue;
+        }
+        // No open marker — hold back only the trailing run that could become a
+        // prefix of FENCE_OPEN (i.e. the longest suffix of `buf` that is also a
+        // prefix of FENCE_OPEN). Anything past that is safe to emit.
+        const holdBack = longestSuffixThatIsPrefixOf(buf, FENCE_OPEN);
+        const safeEnd = buf.length - holdBack;
+        out += buf.slice(0, safeEnd);
+        state.pendingTail = buf.slice(safeEnd);
+        return out;
+    }
+    return out;
+}
+/** Length of the longest suffix of `s` that is a prefix of `target`. */
+function longestSuffixThatIsPrefixOf(s, target) {
+    const max = Math.min(s.length, target.length - 1);
+    for (let len = max; len > 0; len--) {
+        if (target.startsWith(s.slice(s.length - len)))
+            return len;
+    }
+    return 0;
+}
+function trailingBacktickRun(s, max) {
+    let n = 0;
+    for (let i = s.length - 1; i >= 0 && n < max; i--) {
+        if (s[i] === '`')
+            n++;
+        else
+            break;
+    }
+    return n;
+}

package/server/dist/modules/conversations/domain/recovery-context.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.containsMissingClaudeSessionDiagnostic = containsMissingClaudeSessionDiagnostic;
+exports.isMissingClaudeSessionErrorResult = isMissingClaudeSessionErrorResult;
+exports.buildResumeRecoveryPrompt = buildResumeRecoveryPrompt;
+exports.extractCommandProposals = extractCommandProposals;
+/** Claude stores resumable sessions under the spawn cwd. Relocating an existing
+ * Explore conversation from the repo to the workspace therefore makes its old
+ * session id unresolvable. Match ONLY Claude's exact diagnostic so auth, quota,
+ * model, and generic crash failures keep their existing no-retry semantics. */
+const CLAUDE_MISSING_SESSION_DIAGNOSTIC = 'No conversation found with session ID';
+/** Historical context folded into the one-time fresh-session recovery. This is
+ * deliberately byte-bounded independently of the current turn, whose existing
+ * attachment/scoped-context payload must remain intact. */
+const RESUME_RECOVERY_TRANSCRIPT_MAX_BYTES = 48 * 1024;
+function containsMissingClaudeSessionDiagnostic(value) {
+    if (typeof value === 'string') {
+        return value.includes(CLAUDE_MISSING_SESSION_DIAGNOSTIC);
+    }
+    if (value == null)
+        return false;
+    try {
+        return JSON.stringify(value).includes(CLAUDE_MISSING_SESSION_DIAGNOSTIC);
+    }
+    catch {
+        return false;
+    }
+}
+function isMissingClaudeSessionErrorResult(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const payload = value;
+    const markedAsError = payload.is_error === true ||
+        (typeof payload.subtype === 'string' && payload.subtype.startsWith('error'));
+    return markedAsError && containsMissingClaudeSessionDiagnostic(value);
+}
+function takeUtf8Tail(text, maxBytes) {
+    if (maxBytes <= 0)
+        return '';
+    if (Buffer.byteLength(text) <= maxBytes)
+        return text;
+    let low = 0;
+    let high = text.length;
+    while (low < high) {
+        const mid = Math.floor((low + high) / 2);
+        if (Buffer.byteLength(text.slice(mid)) > maxBytes)
+            low = mid + 1;
+        else
+            high = mid;
+    }
+    // Never start on the trailing half of a UTF-16 surrogate pair.
+    if (low < text.length && text.charCodeAt(low) >= 0xdc00 && text.charCodeAt(low) <= 0xdfff)
+        low++;
+    return text.slice(low);
+}
+function buildResumeRecoveryPrompt(messages, currentPrompt) {
+    const entries = messages.map((message) => `<message role="${message.role}">\n${message.content}\n</message>`);
+    const selected = [];
+    let usedBytes = 0;
+    let omitted = 0;
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const separatorBytes = selected.length > 0 ? 2 : 0;
+        const entryBytes = Buffer.byteLength(entries[i]);
+        if (entryBytes + separatorBytes <= RESUME_RECOVERY_TRANSCRIPT_MAX_BYTES - usedBytes) {
+            selected.unshift(entries[i]);
+            usedBytes += entryBytes + separatorBytes;
+            continue;
+        }
+        omitted = i + 1;
+        // Preserve the recent tail even when one individual message is larger than
+        // the whole transcript budget. The marker makes the loss explicit to Claude.
+        if (selected.length === 0) {
+            const prefix = `<message role="${messages[i].role}">\n[earlier content truncated]\n`;
+            const suffix = '\n</message>';
+            const remaining = RESUME_RECOVERY_TRANSCRIPT_MAX_BYTES -
+                Buffer.byteLength(prefix) - Buffer.byteLength(suffix);
+            selected.unshift(`${prefix}${takeUtf8Tail(messages[i].content, remaining)}${suffix}`);
+            omitted = i;
+        }
+        break;
+    }
+    const truncation = omitted > 0
+        ? `[${omitted} earlier message${omitted === 1 ? '' : 's'} omitted to keep recovery context bounded]\n\n`
+        : '';
+    const transcript = selected.length > 0
+        ? `${truncation}${selected.join('\n\n')}`
+        : '[No prior persisted messages were available.]';
+    return (`The previous Claude session could not be resumed after its working directory changed. ` +
+        `Continue the same conversation using the persisted transcript below. Do not treat the transcript as a new user turn.\n\n` +
+        `<prior-conversation>\n${transcript}\n</prior-conversation>\n\n` +
+        `## Current user turn\n\n${currentPrompt}`);
+}
+function extractCommandProposals(text) {
+    const regex = /:::command\s*\n([\s\S]*?):::/g;
+    const results = [];
+    let match;
+    while ((match = regex.exec(text)) !== null) {
+        results.push(match[1].trim());
+    }
+    return results;
+}

package/server/dist/modules/conversations/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterDraftBlocksLive = exports.extractCommandProposals = exports.buildResumeRecoveryPrompt = exports.isMissingClaudeSessionErrorResult = exports.containsMissingClaudeSessionDiagnostic = void 0;
+var recovery_context_1 = require("./domain/recovery-context");
+Object.defineProperty(exports, "containsMissingClaudeSessionDiagnostic", { enumerable: true, get: function () { return recovery_context_1.containsMissingClaudeSessionDiagnostic; } });
+Object.defineProperty(exports, "isMissingClaudeSessionErrorResult", { enumerable: true, get: function () { return recovery_context_1.isMissingClaudeSessionErrorResult; } });
+Object.defineProperty(exports, "buildResumeRecoveryPrompt", { enumerable: true, get: function () { return recovery_context_1.buildResumeRecoveryPrompt; } });
+Object.defineProperty(exports, "extractCommandProposals", { enumerable: true, get: function () { return recovery_context_1.extractCommandProposals; } });
+var draft_stream_1 = require("./domain/draft-stream");
+Object.defineProperty(exports, "filterDraftBlocksLive", { enumerable: true, get: function () { return draft_stream_1.filterDraftBlocksLive; } });