@m4ike1/ion-coding-agent 0.1.0

package/dist/core/sdk.js

@@ -0,0 +1,285 @@
+import { join } from "node:path";
+import { Agent, setDefaultStreamFn } from "@m4ike1/ion-agent-core";
+import { clampThinkingLevel, streamSimple } from "@m4ike1/ion-ai/compat";
+import { getConfigDir } from "../config.js";
+import { resolvePath } from "../utils/paths.js";
+import { AgentSession } from "./agent-session.js";
+import { formatNoModelsAvailableMessage } from "./auth-guidance.js";
+import { DEFAULT_THINKING_LEVEL } from "./defaults.js";
+import { convertToLlm } from "./messages.js";
+import { findInitialModel } from "./model-resolver.js";
+import { ModelRuntime } from "./model-runtime.js";
+import { mergeProviderAttributionHeaders } from "./provider-attribution.js";
+import { DefaultResourceLoader } from "./resource-loader.js";
+import { getDefaultSessionDir, SessionManager } from "./session-manager.js";
+import { SettingsManager } from "./settings-manager.js";
+import { time } from "./timings.js";
+import { createBashTool, createCodingTools, createEditTool, createFindTool, createGrepTool, createLsTool, createPowerShellTool, createReadOnlyTools, createReadTool, createWebextractTool, createWebfetchTool, createWriteTool, withFileMutationQueue, } from "./tools/index.js";
+// Preserve the pre-0.81 fallback for extensions that construct Agent instances
+// or invoke low-level agent loops without supplying streamFn. Agent core remains
+// provider-agnostic and does not import ion-ai/compat itself.
+setDefaultStreamFn(streamSimple);
+// Re-exports
+export * from "./agent-session-runtime.js";
+export { withFileMutationQueue, 
+// Tool factories (for custom cwd)
+createCodingTools, createReadOnlyTools, createReadTool, createBashTool, createEditTool, createWriteTool, createGrepTool, createFindTool, createLsTool, createPowerShellTool, createWebfetchTool, createWebextractTool, };
+// Helper Functions
+function getDefaultAgentDir() {
+    return getConfigDir();
+}
+/**
+ * Create an AgentSession with the specified options.
+ *
+ * @example
+ * ```typescript
+ * // Minimal - uses defaults
+ * const { session } = await createAgentSession();
+ *
+ * // With explicit model
+ * import { getModel } from '@m4ike1/ion-ai';
+ * const { session } = await createAgentSession({
+ *   model: getModel('anthropic', 'claude-opus-4-5'),
+ *   thinkingLevel: 'high',
+ * });
+ *
+ * // Continue previous session
+ * const { session, modelFallbackMessage } = await createAgentSession({
+ *   continueSession: true,
+ * });
+ *
+ * // Full control
+ * const loader = new DefaultResourceLoader({
+ *   cwd: process.cwd(),
+ *   agentDir: getAgentDir(),
+ *   settingsManager: SettingsManager.create(),
+ * });
+ * await loader.reload();
+ * const { session } = await createAgentSession({
+ *   model: myModel,
+ *   tools: ["read", "bash"],
+ *   resourceLoader: loader,
+ *   sessionManager: SessionManager.inMemory(),
+ * });
+ * ```
+ */
+export async function createAgentSession(options = {}) {
+    const cwd = resolvePath(options.cwd ?? options.sessionManager?.getCwd() ?? process.cwd());
+    const agentDir = options.agentDir ? resolvePath(options.agentDir) : getDefaultAgentDir();
+    let resourceLoader = options.resourceLoader;
+    const authPath = options.agentDir ? join(agentDir, "auth.json") : undefined;
+    const modelsPath = options.agentDir ? join(agentDir, "models.json") : undefined;
+    const modelRuntime = options.modelRuntime ?? (await ModelRuntime.create({ authPath, modelsPath }));
+    const settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);
+    const sessionManager = options.sessionManager ??
+        SessionManager.create(cwd, options.agentDir ? getDefaultSessionDir(cwd, agentDir) : getDefaultSessionDir(cwd));
+    if (!resourceLoader) {
+        resourceLoader = new DefaultResourceLoader({ cwd, agentDir, settingsManager });
+        await resourceLoader.reload();
+        time("resourceLoader.reload");
+    }
+    // Check if session has existing data to restore
+    const existingSession = sessionManager.buildSessionContext();
+    const hasExistingSession = existingSession.messages.length > 0;
+    const hasThinkingEntry = sessionManager.getBranch().some((entry) => entry.type === "thinking_level_change");
+    let model = options.model;
+    let modelFallbackMessage;
+    // If session has data, try to restore model from it
+    if (!model && hasExistingSession && existingSession.model) {
+        const restoredModel = modelRuntime.getModel(existingSession.model.provider, existingSession.model.modelId);
+        if (restoredModel && modelRuntime.hasConfiguredAuth(restoredModel.provider)) {
+            model = restoredModel;
+        }
+        if (!model) {
+            modelFallbackMessage = `Could not restore model ${existingSession.model.provider}/${existingSession.model.modelId}`;
+        }
+    }
+    // If still no model, use findInitialModel (checks settings default, then provider defaults)
+    if (!model) {
+        const result = await findInitialModel({
+            scopedModels: [],
+            isContinuing: hasExistingSession,
+            defaultProvider: settingsManager.getDefaultProvider(),
+            defaultModelId: settingsManager.getDefaultModel(),
+            defaultThinkingLevel: settingsManager.getDefaultThinkingLevel(),
+            modelThinkingLevels: settingsManager.getAllModelThinkingLevels(),
+            modelRuntime,
+        });
+        model = result.model;
+        if (!model) {
+            modelFallbackMessage = formatNoModelsAvailableMessage();
+        }
+        else if (modelFallbackMessage) {
+            modelFallbackMessage += `. Using ${model.provider}/${model.id}`;
+        }
+    }
+    let thinkingLevel = options.thinkingLevel;
+    // If session has data, restore thinking level from it
+    if (thinkingLevel === undefined && hasExistingSession) {
+        thinkingLevel = hasThinkingEntry
+            ? existingSession.thinkingLevel
+            : (settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);
+    }
+    // Fall back to per-model override, then global default
+    if (thinkingLevel === undefined && model) {
+        const perModel = settingsManager.getModelThinkingLevel(model.provider, model.id);
+        if (perModel) {
+            thinkingLevel = perModel;
+        }
+    }
+    if (thinkingLevel === undefined) {
+        thinkingLevel = settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;
+    }
+    // Clamp to model capabilities
+    if (!model) {
+        thinkingLevel = "off";
+    }
+    else {
+        thinkingLevel = clampThinkingLevel(model, thinkingLevel);
+    }
+    const defaultActiveToolNames = ["read", "bash", "edit", "write", "grep"];
+    const configuredDefaultToolNames = settingsManager.getDefaultTools();
+    const allowedToolNames = options.tools ?? (options.noTools === "all" ? [] : undefined);
+    const excludedToolNames = options.excludeTools;
+    const excludedToolNameSet = excludedToolNames ? new Set(excludedToolNames) : undefined;
+    const initialActiveToolNames = (options.tools ?? (options.noTools ? [] : (configuredDefaultToolNames ?? defaultActiveToolNames))).filter((name) => !excludedToolNameSet?.has(name));
+    // The webTools setting is an explicit opt-in layer on top of the selected tool set.
+    // An explicit tools/noTools contract from the caller still wins.
+    if (options.tools === undefined && !options.noTools) {
+        for (const name of settingsManager.getEnabledWebToolNames()) {
+            if (!excludedToolNameSet?.has(name) && !initialActiveToolNames.includes(name)) {
+                initialActiveToolNames.push(name);
+            }
+        }
+    }
+    let agent;
+    // Create convertToLlm wrapper that filters images if blockImages is enabled (defense-in-depth)
+    const convertToLlmWithBlockImages = (messages) => {
+        const converted = convertToLlm(messages);
+        // Check setting dynamically so mid-session changes take effect
+        if (!settingsManager.getBlockImages()) {
+            return converted;
+        }
+        // Filter out ImageContent from all messages, replacing with text placeholder
+        return converted.map((msg) => {
+            if (msg.role === "user" || msg.role === "toolResult") {
+                const content = msg.content;
+                if (Array.isArray(content)) {
+                    const hasImages = content.some((c) => c.type === "image");
+                    if (hasImages) {
+                        const filteredContent = content
+                            .map((c) => c.type === "image" ? { type: "text", text: "Image reading is disabled." } : c)
+                            .filter((c, i, arr) => 
+                        // Dedupe consecutive "Image reading is disabled." texts
+                        !(c.type === "text" &&
+                            c.text === "Image reading is disabled." &&
+                            i > 0 &&
+                            arr[i - 1].type === "text" &&
+                            arr[i - 1].text === "Image reading is disabled."));
+                        return { ...msg, content: filteredContent };
+                    }
+                }
+            }
+            return msg;
+        });
+    };
+    const extensionRunnerRef = {};
+    agent = new Agent({
+        initialState: {
+            systemPrompt: "",
+            model,
+            thinkingLevel,
+            tools: [],
+        },
+        convertToLlm: convertToLlmWithBlockImages,
+        streamFn: async (model, context, options) => {
+            const providerRetrySettings = settingsManager.getProviderRetrySettings();
+            const httpIdleTimeoutMs = settingsManager.getHttpIdleTimeoutMs();
+            // SDKs treat timeout=0 as 0ms (immediate timeout), not "no timeout".
+            // Use max int32 to effectively disable the timeout.
+            const effectiveTimeoutMs = httpIdleTimeoutMs === 0 ? 2147483647 : httpIdleTimeoutMs;
+            const timeoutMs = options?.timeoutMs ?? providerRetrySettings.timeoutMs ?? effectiveTimeoutMs;
+            const websocketConnectTimeoutMs = options?.websocketConnectTimeoutMs ?? settingsManager.getWebSocketConnectTimeoutMs();
+            const headerRunner = extensionRunnerRef.current;
+            return modelRuntime.streamSimple(model, context, {
+                ...options,
+                timeoutMs,
+                websocketConnectTimeoutMs,
+                maxRetries: options?.maxRetries ?? providerRetrySettings.maxRetries,
+                maxRetryDelayMs: options?.maxRetryDelayMs ?? providerRetrySettings.maxRetryDelayMs,
+                transformHeaders: async (requestHeaders) => {
+                    const headers = mergeProviderAttributionHeaders(model, settingsManager, options?.sessionId, requestHeaders);
+                    return headerRunner?.hasHandlers("before_provider_headers")
+                        ? headerRunner.emitBeforeProviderHeaders(headers ?? {})
+                        : (headers ?? {});
+                },
+            });
+        },
+        onPayload: async (payload, _model) => {
+            const runner = extensionRunnerRef.current;
+            if (!runner?.hasHandlers("before_provider_request")) {
+                return payload;
+            }
+            return runner.emitBeforeProviderRequest(payload);
+        },
+        onResponse: async (response, _model) => {
+            const runner = extensionRunnerRef.current;
+            if (!runner?.hasHandlers("after_provider_response")) {
+                return;
+            }
+            await runner.emit({
+                type: "after_provider_response",
+                status: response.status,
+                headers: response.headers,
+            });
+        },
+        sessionId: sessionManager.getSessionId(),
+        transformContext: async (messages) => {
+            const runner = extensionRunnerRef.current;
+            if (!runner)
+                return messages;
+            return runner.emitContext(messages);
+        },
+        steeringMode: settingsManager.getSteeringMode(),
+        followUpMode: settingsManager.getFollowUpMode(),
+        transport: settingsManager.getTransport(),
+        thinkingBudgets: settingsManager.getThinkingBudgets(),
+        maxRetryDelayMs: settingsManager.getProviderRetrySettings().maxRetryDelayMs,
+    });
+    // Restore messages if session has existing data
+    if (hasExistingSession) {
+        agent.state.messages = existingSession.messages;
+        if (!hasThinkingEntry) {
+            sessionManager.appendThinkingLevelChange(thinkingLevel);
+        }
+    }
+    else {
+        // Save initial model and thinking level for new sessions so they can be restored on resume
+        if (model) {
+            sessionManager.appendModelChange(model.provider, model.id);
+        }
+        sessionManager.appendThinkingLevelChange(thinkingLevel);
+    }
+    const session = new AgentSession({
+        agent,
+        sessionManager,
+        settingsManager,
+        cwd,
+        scopedModels: options.scopedModels,
+        resourceLoader,
+        customTools: options.customTools,
+        modelRuntime,
+        initialActiveToolNames,
+        allowedToolNames,
+        excludedToolNames,
+        extensionRunnerRef,
+        sessionStartEvent: options.sessionStartEvent,
+    });
+    const extensionsResult = resourceLoader.getExtensions();
+    return {
+        session,
+        extensionsResult,
+        modelFallbackMessage,
+    };
+}
+//# sourceMappingURL=sdk.js.map

package/dist/core/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport { Agent, type AgentMessage, setDefaultStreamFn, type ThinkingLevel } from \"@m4ike1/ion-agent-core\";\nimport { clampThinkingLevel, type Message, type Model, streamSimple } from \"@m4ike1/ion-ai/compat\";\nimport { getConfigDir } from \"../config.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { AgentSession } from \"./agent-session.ts\";\nimport { formatNoModelsAvailableMessage } from \"./auth-guidance.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type { ExtensionRunner, LoadExtensionsResult, SessionStartEvent, ToolDefinition } from \"./extensions/index.ts\";\nimport { convertToLlm } from \"./messages.ts\";\nimport { findInitialModel } from \"./model-resolver.ts\";\nimport { ModelRuntime } from \"./model-runtime.ts\";\nimport { mergeProviderAttributionHeaders } from \"./provider-attribution.ts\";\nimport type { ResourceLoader } from \"./resource-loader.ts\";\nimport { DefaultResourceLoader } from \"./resource-loader.ts\";\nimport { getDefaultSessionDir, SessionManager } from \"./session-manager.ts\";\nimport { SettingsManager } from \"./settings-manager.ts\";\nimport { time } from \"./timings.ts\";\nimport {\n\tcreateBashTool,\n\tcreateCodingTools,\n\tcreateEditTool,\n\tcreateFindTool,\n\tcreateGrepTool,\n\tcreateLsTool,\n\tcreatePowerShellTool,\n\tcreateReadOnlyTools,\n\tcreateReadTool,\n\tcreateWebextractTool,\n\tcreateWebfetchTool,\n\tcreateWriteTool,\n\ttype ToolName,\n\twithFileMutationQueue,\n} from \"./tools/index.ts\";\n\n// Preserve the pre-0.81 fallback for extensions that construct Agent instances\n// or invoke low-level agent loops without supplying streamFn. Agent core remains\n// provider-agnostic and does not import ion-ai/compat itself.\nsetDefaultStreamFn(streamSimple);\n\nexport interface CreateAgentSessionOptions {\n\t/** Working directory for project-local discovery. Default: process.cwd() */\n\tcwd?: string;\n\t/** Global config directory. Default: ~/.ion/agent */\n\tagentDir?: string;\n\n\t/** Canonical model/auth runtime. Defaults to a runtime using agentDir/auth.json and models.json. */\n\tmodelRuntime?: ModelRuntime;\n\n\t/** Model to use. Default: from settings, else first available */\n\tmodel?: Model<any>;\n\t/** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */\n\tthinkingLevel?: ThinkingLevel;\n\t/** Models available for cycling (Ctrl+P in interactive mode) */\n\tscopedModels?: Array<{ model: Model<any>; thinkingLevel?: ThinkingLevel }>;\n\n\t/**\n\t * Optional default tool suppression mode when no explicit allowlist is provided.\n\t *\n\t * - \"all\": start with no tools enabled\n\t * - \"builtin\": disable the default built-in tools (read, bash, edit, write)\n\t *   but keep extension/custom tools enabled\n\t */\n\tnoTools?: \"all\" | \"builtin\";\n\t/**\n\t * Optional allowlist of tool names.\n\t *\n\t * When omitted, ion uses the `defaultTools` setting for the initial built-in\n\t * selection when configured. Otherwise it enables the default built-in tools\n\t * (read, bash, edit, write). Extension/custom tools remain enabled unless\n\t * `noTools` changes that default. When provided, only the listed tool names are\n\t * enabled.\n\t */\n\ttools?: string[];\n\t/** Optional denylist of tool names to disable. Applies after `tools` when both are provided. */\n\texcludeTools?: string[];\n\t/** Custom tools to register (in addition to built-in tools). */\n\tcustomTools?: ToolDefinition[];\n\n\t/** Resource loader. When omitted, DefaultResourceLoader is used. */\n\tresourceLoader?: ResourceLoader;\n\n\t/** Session manager. Default: SessionManager.create(cwd) */\n\tsessionManager?: SessionManager;\n\n\t/** Settings manager. Default: SettingsManager.create(cwd, agentDir) */\n\tsettingsManager?: SettingsManager;\n\t/** Session start event metadata for extension runtime startup. */\n\tsessionStartEvent?: SessionStartEvent;\n}\n\n/** Result from createAgentSession */\nexport interface CreateAgentSessionResult {\n\t/** The created session */\n\tsession: AgentSession;\n\t/** Extensions result (for UI context setup in interactive mode) */\n\textensionsResult: LoadExtensionsResult;\n\t/** Warning if session was restored with a different model than saved */\n\tmodelFallbackMessage?: string;\n}\n\n// Re-exports\n\nexport * from \"./agent-session-runtime.ts\";\nexport type {\n\tExtensionAPI,\n\tExtensionCommandContext,\n\tExtensionContext,\n\tExtensionFactory,\n\tInlineExtension,\n\tSlashCommandInfo,\n\tSlashCommandSource,\n\tToolDefinition,\n} from \"./extensions/index.ts\";\nexport type { PromptTemplate } from \"./prompt-templates.ts\";\nexport type { Skill } from \"./skills.ts\";\nexport type { Tool } from \"./tools/index.ts\";\n\nexport {\n\twithFileMutationQueue,\n\t// Tool factories (for custom cwd)\n\tcreateCodingTools,\n\tcreateReadOnlyTools,\n\tcreateReadTool,\n\tcreateBashTool,\n\tcreateEditTool,\n\tcreateWriteTool,\n\tcreateGrepTool,\n\tcreateFindTool,\n\tcreateLsTool,\n\tcreatePowerShellTool,\n\tcreateWebfetchTool,\n\tcreateWebextractTool,\n};\n\n// Helper Functions\n\nfunction getDefaultAgentDir(): string {\n\treturn getConfigDir();\n}\n\n/**\n * Create an AgentSession with the specified options.\n *\n * @example\n * ```typescript\n * // Minimal - uses defaults\n * const { session } = await createAgentSession();\n *\n * // With explicit model\n * import { getModel } from '@m4ike1/ion-ai';\n * const { session } = await createAgentSession({\n *   model: getModel('anthropic', 'claude-opus-4-5'),\n *   thinkingLevel: 'high',\n * });\n *\n * // Continue previous session\n * const { session, modelFallbackMessage } = await createAgentSession({\n *   continueSession: true,\n * });\n *\n * // Full control\n * const loader = new DefaultResourceLoader({\n *   cwd: process.cwd(),\n *   agentDir: getAgentDir(),\n *   settingsManager: SettingsManager.create(),\n * });\n * await loader.reload();\n * const { session } = await createAgentSession({\n *   model: myModel,\n *   tools: [\"read\", \"bash\"],\n *   resourceLoader: loader,\n *   sessionManager: SessionManager.inMemory(),\n * });\n * ```\n */\nexport async function createAgentSession(options: CreateAgentSessionOptions = {}): Promise<CreateAgentSessionResult> {\n\tconst cwd = resolvePath(options.cwd ?? options.sessionManager?.getCwd() ?? process.cwd());\n\tconst agentDir = options.agentDir ? resolvePath(options.agentDir) : getDefaultAgentDir();\n\tlet resourceLoader = options.resourceLoader;\n\n\tconst authPath = options.agentDir ? join(agentDir, \"auth.json\") : undefined;\n\tconst modelsPath = options.agentDir ? join(agentDir, \"models.json\") : undefined;\n\tconst modelRuntime = options.modelRuntime ?? (await ModelRuntime.create({ authPath, modelsPath }));\n\n\tconst settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n\tconst sessionManager =\n\t\toptions.sessionManager ??\n\t\tSessionManager.create(cwd, options.agentDir ? getDefaultSessionDir(cwd, agentDir) : getDefaultSessionDir(cwd));\n\n\tif (!resourceLoader) {\n\t\tresourceLoader = new DefaultResourceLoader({ cwd, agentDir, settingsManager });\n\t\tawait resourceLoader.reload();\n\t\ttime(\"resourceLoader.reload\");\n\t}\n\n\t// Check if session has existing data to restore\n\tconst existingSession = sessionManager.buildSessionContext();\n\tconst hasExistingSession = existingSession.messages.length > 0;\n\tconst hasThinkingEntry = sessionManager.getBranch().some((entry) => entry.type === \"thinking_level_change\");\n\n\tlet model = options.model;\n\tlet modelFallbackMessage: string | undefined;\n\n\t// If session has data, try to restore model from it\n\tif (!model && hasExistingSession && existingSession.model) {\n\t\tconst restoredModel = modelRuntime.getModel(existingSession.model.provider, existingSession.model.modelId);\n\t\tif (restoredModel && modelRuntime.hasConfiguredAuth(restoredModel.provider)) {\n\t\t\tmodel = restoredModel;\n\t\t}\n\t\tif (!model) {\n\t\t\tmodelFallbackMessage = `Could not restore model ${existingSession.model.provider}/${existingSession.model.modelId}`;\n\t\t}\n\t}\n\n\t// If still no model, use findInitialModel (checks settings default, then provider defaults)\n\tif (!model) {\n\t\tconst result = await findInitialModel({\n\t\t\tscopedModels: [],\n\t\t\tisContinuing: hasExistingSession,\n\t\t\tdefaultProvider: settingsManager.getDefaultProvider(),\n\t\t\tdefaultModelId: settingsManager.getDefaultModel(),\n\t\t\tdefaultThinkingLevel: settingsManager.getDefaultThinkingLevel(),\n\t\t\tmodelThinkingLevels: settingsManager.getAllModelThinkingLevels(),\n\t\t\tmodelRuntime,\n\t\t});\n\t\tmodel = result.model;\n\t\tif (!model) {\n\t\t\tmodelFallbackMessage = formatNoModelsAvailableMessage();\n\t\t} else if (modelFallbackMessage) {\n\t\t\tmodelFallbackMessage += `. Using ${model.provider}/${model.id}`;\n\t\t}\n\t}\n\n\tlet thinkingLevel = options.thinkingLevel;\n\n\t// If session has data, restore thinking level from it\n\tif (thinkingLevel === undefined && hasExistingSession) {\n\t\tthinkingLevel = hasThinkingEntry\n\t\t\t? (existingSession.thinkingLevel as ThinkingLevel)\n\t\t\t: (settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);\n\t}\n\n\t// Fall back to per-model override, then global default\n\tif (thinkingLevel === undefined && model) {\n\t\tconst perModel = settingsManager.getModelThinkingLevel(model.provider, model.id);\n\t\tif (perModel) {\n\t\t\tthinkingLevel = perModel;\n\t\t}\n\t}\n\tif (thinkingLevel === undefined) {\n\t\tthinkingLevel = settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;\n\t}\n\n\t// Clamp to model capabilities\n\tif (!model) {\n\t\tthinkingLevel = \"off\";\n\t} else {\n\t\tthinkingLevel = clampThinkingLevel(model, thinkingLevel) as ThinkingLevel;\n\t}\n\n\tconst defaultActiveToolNames: ToolName[] = [\"read\", \"bash\", \"edit\", \"write\", \"grep\"];\n\tconst configuredDefaultToolNames = settingsManager.getDefaultTools();\n\tconst allowedToolNames = options.tools ?? (options.noTools === \"all\" ? [] : undefined);\n\tconst excludedToolNames = options.excludeTools;\n\tconst excludedToolNameSet = excludedToolNames ? new Set(excludedToolNames) : undefined;\n\tconst initialActiveToolNames = (\n\t\toptions.tools ?? (options.noTools ? [] : (configuredDefaultToolNames ?? defaultActiveToolNames))\n\t).filter((name) => !excludedToolNameSet?.has(name));\n\t// The webTools setting is an explicit opt-in layer on top of the selected tool set.\n\t// An explicit tools/noTools contract from the caller still wins.\n\tif (options.tools === undefined && !options.noTools) {\n\t\tfor (const name of settingsManager.getEnabledWebToolNames()) {\n\t\t\tif (!excludedToolNameSet?.has(name) && !initialActiveToolNames.includes(name)) {\n\t\t\t\tinitialActiveToolNames.push(name);\n\t\t\t}\n\t\t}\n\t}\n\n\tlet agent: Agent;\n\n\t// Create convertToLlm wrapper that filters images if blockImages is enabled (defense-in-depth)\n\tconst convertToLlmWithBlockImages = (messages: AgentMessage[]): Message[] => {\n\t\tconst converted = convertToLlm(messages);\n\t\t// Check setting dynamically so mid-session changes take effect\n\t\tif (!settingsManager.getBlockImages()) {\n\t\t\treturn converted;\n\t\t}\n\t\t// Filter out ImageContent from all messages, replacing with text placeholder\n\t\treturn converted.map((msg) => {\n\t\t\tif (msg.role === \"user\" || msg.role === \"toolResult\") {\n\t\t\t\tconst content = msg.content;\n\t\t\t\tif (Array.isArray(content)) {\n\t\t\t\t\tconst hasImages = content.some((c) => c.type === \"image\");\n\t\t\t\t\tif (hasImages) {\n\t\t\t\t\t\tconst filteredContent = content\n\t\t\t\t\t\t\t.map((c) =>\n\t\t\t\t\t\t\t\tc.type === \"image\" ? { type: \"text\" as const, text: \"Image reading is disabled.\" } : c,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t.filter(\n\t\t\t\t\t\t\t\t(c, i, arr) =>\n\t\t\t\t\t\t\t\t\t// Dedupe consecutive \"Image reading is disabled.\" texts\n\t\t\t\t\t\t\t\t\t!(\n\t\t\t\t\t\t\t\t\t\tc.type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\tc.text === \"Image reading is disabled.\" &&\n\t\t\t\t\t\t\t\t\t\ti > 0 &&\n\t\t\t\t\t\t\t\t\t\tarr[i - 1].type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\t(arr[i - 1] as { type: \"text\"; text: string }).text === \"Image reading is disabled.\"\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\treturn { ...msg, content: filteredContent };\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn msg;\n\t\t});\n\t};\n\n\tconst extensionRunnerRef: { current?: ExtensionRunner } = {};\n\n\tagent = new Agent({\n\t\tinitialState: {\n\t\t\tsystemPrompt: \"\",\n\t\t\tmodel,\n\t\t\tthinkingLevel,\n\t\t\ttools: [],\n\t\t},\n\t\tconvertToLlm: convertToLlmWithBlockImages,\n\t\tstreamFn: async (model, context, options) => {\n\t\t\tconst providerRetrySettings = settingsManager.getProviderRetrySettings();\n\t\t\tconst httpIdleTimeoutMs = settingsManager.getHttpIdleTimeoutMs();\n\t\t\t// SDKs treat timeout=0 as 0ms (immediate timeout), not \"no timeout\".\n\t\t\t// Use max int32 to effectively disable the timeout.\n\t\t\tconst effectiveTimeoutMs = httpIdleTimeoutMs === 0 ? 2147483647 : httpIdleTimeoutMs;\n\t\t\tconst timeoutMs = options?.timeoutMs ?? providerRetrySettings.timeoutMs ?? effectiveTimeoutMs;\n\t\t\tconst websocketConnectTimeoutMs =\n\t\t\t\toptions?.websocketConnectTimeoutMs ?? settingsManager.getWebSocketConnectTimeoutMs();\n\t\t\tconst headerRunner = extensionRunnerRef.current;\n\t\t\treturn modelRuntime.streamSimple(model, context, {\n\t\t\t\t...options,\n\t\t\t\ttimeoutMs,\n\t\t\t\twebsocketConnectTimeoutMs,\n\t\t\t\tmaxRetries: options?.maxRetries ?? providerRetrySettings.maxRetries,\n\t\t\t\tmaxRetryDelayMs: options?.maxRetryDelayMs ?? providerRetrySettings.maxRetryDelayMs,\n\t\t\t\ttransformHeaders: async (requestHeaders) => {\n\t\t\t\t\tconst headers = mergeProviderAttributionHeaders(\n\t\t\t\t\t\tmodel,\n\t\t\t\t\t\tsettingsManager,\n\t\t\t\t\t\toptions?.sessionId,\n\t\t\t\t\t\trequestHeaders,\n\t\t\t\t\t);\n\t\t\t\t\treturn headerRunner?.hasHandlers(\"before_provider_headers\")\n\t\t\t\t\t\t? headerRunner.emitBeforeProviderHeaders(headers ?? {})\n\t\t\t\t\t\t: (headers ?? {});\n\t\t\t\t},\n\t\t\t});\n\t\t},\n\t\tonPayload: async (payload, _model) => {\n\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\tif (!runner?.hasHandlers(\"before_provider_request\")) {\n\t\t\t\treturn payload;\n\t\t\t}\n\t\t\treturn runner.emitBeforeProviderRequest(payload);\n\t\t},\n\t\tonResponse: async (response, _model) => {\n\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\tif (!runner?.hasHandlers(\"after_provider_response\")) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tawait runner.emit({\n\t\t\t\ttype: \"after_provider_response\",\n\t\t\t\tstatus: response.status,\n\t\t\t\theaders: response.headers,\n\t\t\t});\n\t\t},\n\t\tsessionId: sessionManager.getSessionId(),\n\t\ttransformContext: async (messages) => {\n\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\tif (!runner) return messages;\n\t\t\treturn runner.emitContext(messages);\n\t\t},\n\t\tsteeringMode: settingsManager.getSteeringMode(),\n\t\tfollowUpMode: settingsManager.getFollowUpMode(),\n\t\ttransport: settingsManager.getTransport(),\n\t\tthinkingBudgets: settingsManager.getThinkingBudgets(),\n\t\tmaxRetryDelayMs: settingsManager.getProviderRetrySettings().maxRetryDelayMs,\n\t});\n\n\t// Restore messages if session has existing data\n\tif (hasExistingSession) {\n\t\tagent.state.messages = existingSession.messages;\n\t\tif (!hasThinkingEntry) {\n\t\t\tsessionManager.appendThinkingLevelChange(thinkingLevel);\n\t\t}\n\t} else {\n\t\t// Save initial model and thinking level for new sessions so they can be restored on resume\n\t\tif (model) {\n\t\t\tsessionManager.appendModelChange(model.provider, model.id);\n\t\t}\n\t\tsessionManager.appendThinkingLevelChange(thinkingLevel);\n\t}\n\n\tconst session = new AgentSession({\n\t\tagent,\n\t\tsessionManager,\n\t\tsettingsManager,\n\t\tcwd,\n\t\tscopedModels: options.scopedModels,\n\t\tresourceLoader,\n\t\tcustomTools: options.customTools,\n\t\tmodelRuntime,\n\t\tinitialActiveToolNames,\n\t\tallowedToolNames,\n\t\texcludedToolNames,\n\t\textensionRunnerRef,\n\t\tsessionStartEvent: options.sessionStartEvent,\n\t});\n\tconst extensionsResult = resourceLoader.getExtensions();\n\n\treturn {\n\t\tsession,\n\t\textensionsResult,\n\t\tmodelFallbackMessage,\n\t};\n}\n"]}

package/dist/core/session-cwd.d.ts

@@ -0,0 +1,19 @@
+export interface SessionCwdIssue {
+    sessionFile?: string;
+    sessionCwd: string;
+    fallbackCwd: string;
+}
+interface SessionCwdSource {
+    getCwd(): string;
+    getSessionFile(): string | undefined;
+}
+export declare function getMissingSessionCwdIssue(sessionManager: SessionCwdSource, fallbackCwd: string): SessionCwdIssue | undefined;
+export declare function formatMissingSessionCwdError(issue: SessionCwdIssue): string;
+export declare function formatMissingSessionCwdPrompt(issue: SessionCwdIssue): string;
+export declare class MissingSessionCwdError extends Error {
+    readonly issue: SessionCwdIssue;
+    constructor(issue: SessionCwdIssue);
+}
+export declare function assertSessionCwdExists(sessionManager: SessionCwdSource, fallbackCwd: string): void;
+export {};
+//# sourceMappingURL=session-cwd.d.ts.map

package/dist/core/session-cwd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cwd.d.ts","sourceRoot":"","sources":["../../src/core/session-cwd.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,gBAAgB;IACzB,MAAM,IAAI,MAAM,CAAC;IACjB,cAAc,IAAI,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,wBAAgB,yBAAyB,CACxC,cAAc,EAAE,gBAAgB,EAChC,WAAW,EAAE,MAAM,GACjB,eAAe,GAAG,SAAS,CAgB7B;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAG3E;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAE5E;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAEhC,YAAY,KAAK,EAAE,eAAe,EAIjC;CACD;AAED,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAKlG","sourcesContent":["import { existsSync } from \"node:fs\";\n\nexport interface SessionCwdIssue {\n\tsessionFile?: string;\n\tsessionCwd: string;\n\tfallbackCwd: string;\n}\n\ninterface SessionCwdSource {\n\tgetCwd(): string;\n\tgetSessionFile(): string | undefined;\n}\n\nexport function getMissingSessionCwdIssue(\n\tsessionManager: SessionCwdSource,\n\tfallbackCwd: string,\n): SessionCwdIssue | undefined {\n\tconst sessionFile = sessionManager.getSessionFile();\n\tif (!sessionFile) {\n\t\treturn undefined;\n\t}\n\n\tconst sessionCwd = sessionManager.getCwd();\n\tif (!sessionCwd || existsSync(sessionCwd)) {\n\t\treturn undefined;\n\t}\n\n\treturn {\n\t\tsessionFile,\n\t\tsessionCwd,\n\t\tfallbackCwd,\n\t};\n}\n\nexport function formatMissingSessionCwdError(issue: SessionCwdIssue): string {\n\tconst sessionFile = issue.sessionFile ? `\\nSession file: ${issue.sessionFile}` : \"\";\n\treturn `Stored session working directory does not exist: ${issue.sessionCwd}${sessionFile}\\nCurrent working directory: ${issue.fallbackCwd}`;\n}\n\nexport function formatMissingSessionCwdPrompt(issue: SessionCwdIssue): string {\n\treturn `cwd from session file does not exist\\n${issue.sessionCwd}\\n\\ncontinue in current cwd\\n${issue.fallbackCwd}`;\n}\n\nexport class MissingSessionCwdError extends Error {\n\treadonly issue: SessionCwdIssue;\n\n\tconstructor(issue: SessionCwdIssue) {\n\t\tsuper(formatMissingSessionCwdError(issue));\n\t\tthis.name = \"MissingSessionCwdError\";\n\t\tthis.issue = issue;\n\t}\n}\n\nexport function assertSessionCwdExists(sessionManager: SessionCwdSource, fallbackCwd: string): void {\n\tconst issue = getMissingSessionCwdIssue(sessionManager, fallbackCwd);\n\tif (issue) {\n\t\tthrow new MissingSessionCwdError(issue);\n\t}\n}\n"]}

package/dist/core/session-cwd.js

@@ -0,0 +1,38 @@
+import { existsSync } from "node:fs";
+export function getMissingSessionCwdIssue(sessionManager, fallbackCwd) {
+    const sessionFile = sessionManager.getSessionFile();
+    if (!sessionFile) {
+        return undefined;
+    }
+    const sessionCwd = sessionManager.getCwd();
+    if (!sessionCwd || existsSync(sessionCwd)) {
+        return undefined;
+    }
+    return {
+        sessionFile,
+        sessionCwd,
+        fallbackCwd,
+    };
+}
+export function formatMissingSessionCwdError(issue) {
+    const sessionFile = issue.sessionFile ? `\nSession file: ${issue.sessionFile}` : "";
+    return `Stored session working directory does not exist: ${issue.sessionCwd}${sessionFile}\nCurrent working directory: ${issue.fallbackCwd}`;
+}
+export function formatMissingSessionCwdPrompt(issue) {
+    return `cwd from session file does not exist\n${issue.sessionCwd}\n\ncontinue in current cwd\n${issue.fallbackCwd}`;
+}
+export class MissingSessionCwdError extends Error {
+    issue;
+    constructor(issue) {
+        super(formatMissingSessionCwdError(issue));
+        this.name = "MissingSessionCwdError";
+        this.issue = issue;
+    }
+}
+export function assertSessionCwdExists(sessionManager, fallbackCwd) {
+    const issue = getMissingSessionCwdIssue(sessionManager, fallbackCwd);
+    if (issue) {
+        throw new MissingSessionCwdError(issue);
+    }
+}
+//# sourceMappingURL=session-cwd.js.map

package/dist/core/session-cwd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cwd.js","sourceRoot":"","sources":["../../src/core/session-cwd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAarC,MAAM,UAAU,yBAAyB,CACxC,cAAgC,EAChC,WAAmB,EACW;IAC9B,MAAM,WAAW,GAAG,cAAc,CAAC,cAAc,EAAE,CAAC;IACpD,IAAI,CAAC,WAAW,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC;IAC3C,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO;QACN,WAAW;QACX,UAAU;QACV,WAAW;KACX,CAAC;AAAA,CACF;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAsB,EAAU;IAC5E,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,mBAAmB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,OAAO,oDAAoD,KAAK,CAAC,UAAU,GAAG,WAAW,gCAAgC,KAAK,CAAC,WAAW,EAAE,CAAC;AAAA,CAC7I;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAsB,EAAU;IAC7E,OAAO,yCAAyC,KAAK,CAAC,UAAU,gCAAgC,KAAK,CAAC,WAAW,EAAE,CAAC;AAAA,CACpH;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACvC,KAAK,CAAkB;IAEhC,YAAY,KAAsB,EAAE;QACnC,KAAK,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAAA,CACnB;CACD;AAED,MAAM,UAAU,sBAAsB,CAAC,cAAgC,EAAE,WAAmB,EAAQ;IACnG,MAAM,KAAK,GAAG,yBAAyB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACrE,IAAI,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;AAAA,CACD","sourcesContent":["import { existsSync } from \"node:fs\";\n\nexport interface SessionCwdIssue {\n\tsessionFile?: string;\n\tsessionCwd: string;\n\tfallbackCwd: string;\n}\n\ninterface SessionCwdSource {\n\tgetCwd(): string;\n\tgetSessionFile(): string | undefined;\n}\n\nexport function getMissingSessionCwdIssue(\n\tsessionManager: SessionCwdSource,\n\tfallbackCwd: string,\n): SessionCwdIssue | undefined {\n\tconst sessionFile = sessionManager.getSessionFile();\n\tif (!sessionFile) {\n\t\treturn undefined;\n\t}\n\n\tconst sessionCwd = sessionManager.getCwd();\n\tif (!sessionCwd || existsSync(sessionCwd)) {\n\t\treturn undefined;\n\t}\n\n\treturn {\n\t\tsessionFile,\n\t\tsessionCwd,\n\t\tfallbackCwd,\n\t};\n}\n\nexport function formatMissingSessionCwdError(issue: SessionCwdIssue): string {\n\tconst sessionFile = issue.sessionFile ? `\\nSession file: ${issue.sessionFile}` : \"\";\n\treturn `Stored session working directory does not exist: ${issue.sessionCwd}${sessionFile}\\nCurrent working directory: ${issue.fallbackCwd}`;\n}\n\nexport function formatMissingSessionCwdPrompt(issue: SessionCwdIssue): string {\n\treturn `cwd from session file does not exist\\n${issue.sessionCwd}\\n\\ncontinue in current cwd\\n${issue.fallbackCwd}`;\n}\n\nexport class MissingSessionCwdError extends Error {\n\treadonly issue: SessionCwdIssue;\n\n\tconstructor(issue: SessionCwdIssue) {\n\t\tsuper(formatMissingSessionCwdError(issue));\n\t\tthis.name = \"MissingSessionCwdError\";\n\t\tthis.issue = issue;\n\t}\n}\n\nexport function assertSessionCwdExists(sessionManager: SessionCwdSource, fallbackCwd: string): void {\n\tconst issue = getMissingSessionCwdIssue(sessionManager, fallbackCwd);\n\tif (issue) {\n\t\tthrow new MissingSessionCwdError(issue);\n\t}\n}\n"]}

package/dist/core/session-export.d.ts

@@ -0,0 +1,4 @@
+import { type SessionManager } from "./session-manager.ts";
+/** Write the current session branch and optional trailing export-only entries as JSONL. */
+export declare function exportSessionToJsonl(sessionManager: SessionManager, outputPath?: string, createTrailingEntries?: (parentId: string | null, timestamp: string) => readonly object[]): string;
+//# sourceMappingURL=session-export.d.ts.map

package/dist/core/session-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-export.d.ts","sourceRoot":"","sources":["../../src/core/session-export.ts"],"names":[],"mappings":"AAGA,OAAO,EAA+C,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAExG,2FAA2F;AAC3F,wBAAgB,oBAAoB,CACnC,cAAc,EAAE,cAAc,EAC9B,UAAU,CAAC,EAAE,MAAM,EACnB,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,GACvF,MAAM,CA+BR","sourcesContent":["import { existsSync, mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { CURRENT_SESSION_VERSION, type SessionHeader, type SessionManager } from \"./session-manager.ts\";\n\n/** Write the current session branch and optional trailing export-only entries as JSONL. */\nexport function exportSessionToJsonl(\n\tsessionManager: SessionManager,\n\toutputPath?: string,\n\tcreateTrailingEntries?: (parentId: string | null, timestamp: string) => readonly object[],\n): string {\n\tconst filePath = resolvePath(\n\t\toutputPath ?? `session-${new Date().toISOString().replace(/[:.]/g, \"-\")}.jsonl`,\n\t\tprocess.cwd(),\n\t);\n\tconst dir = dirname(filePath);\n\tif (!existsSync(dir)) {\n\t\tmkdirSync(dir, { recursive: true });\n\t}\n\n\tconst timestamp = new Date().toISOString();\n\tconst header: SessionHeader = {\n\t\ttype: \"session\",\n\t\tversion: CURRENT_SESSION_VERSION,\n\t\tid: sessionManager.getSessionId(),\n\t\ttimestamp,\n\t\tcwd: sessionManager.getCwd(),\n\t};\n\tconst lines = [JSON.stringify(header)];\n\n\tlet parentId: string | null = null;\n\tfor (const entry of sessionManager.getBranch()) {\n\t\tlines.push(JSON.stringify({ ...entry, parentId }));\n\t\tparentId = entry.id;\n\t}\n\tfor (const entry of createTrailingEntries?.(parentId, timestamp) ?? []) {\n\t\tlines.push(JSON.stringify(entry));\n\t}\n\n\twriteFileSync(filePath, `${lines.join(\"\\n\")}\\n`);\n\treturn filePath;\n}\n"]}

package/dist/core/session-export.js

@@ -0,0 +1,32 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { resolvePath } from "../utils/paths.js";
+import { CURRENT_SESSION_VERSION } from "./session-manager.js";
+/** Write the current session branch and optional trailing export-only entries as JSONL. */
+export function exportSessionToJsonl(sessionManager, outputPath, createTrailingEntries) {
+    const filePath = resolvePath(outputPath ?? `session-${new Date().toISOString().replace(/[:.]/g, "-")}.jsonl`, process.cwd());
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const timestamp = new Date().toISOString();
+    const header = {
+        type: "session",
+        version: CURRENT_SESSION_VERSION,
+        id: sessionManager.getSessionId(),
+        timestamp,
+        cwd: sessionManager.getCwd(),
+    };
+    const lines = [JSON.stringify(header)];
+    let parentId = null;
+    for (const entry of sessionManager.getBranch()) {
+        lines.push(JSON.stringify({ ...entry, parentId }));
+        parentId = entry.id;
+    }
+    for (const entry of createTrailingEntries?.(parentId, timestamp) ?? []) {
+        lines.push(JSON.stringify(entry));
+    }
+    writeFileSync(filePath, `${lines.join("\n")}\n`);
+    return filePath;
+}
+//# sourceMappingURL=session-export.js.map

package/dist/core/session-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-export.js","sourceRoot":"","sources":["../../src/core/session-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAA2C,MAAM,sBAAsB,CAAC;AAExG,2FAA2F;AAC3F,MAAM,UAAU,oBAAoB,CACnC,cAA8B,EAC9B,UAAmB,EACnB,qBAAyF,EAChF;IACT,MAAM,QAAQ,GAAG,WAAW,CAC3B,UAAU,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,EAC/E,OAAO,CAAC,GAAG,EAAE,CACb,CAAC;IACF,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAkB;QAC7B,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,uBAAuB;QAChC,EAAE,EAAE,cAAc,CAAC,YAAY,EAAE;QACjC,SAAS;QACT,GAAG,EAAE,cAAc,CAAC,MAAM,EAAE;KAC5B,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvC,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACnD,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC;IACrB,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,qBAAqB,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,aAAa,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,QAAQ,CAAC;AAAA,CAChB","sourcesContent":["import { existsSync, mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { CURRENT_SESSION_VERSION, type SessionHeader, type SessionManager } from \"./session-manager.ts\";\n\n/** Write the current session branch and optional trailing export-only entries as JSONL. */\nexport function exportSessionToJsonl(\n\tsessionManager: SessionManager,\n\toutputPath?: string,\n\tcreateTrailingEntries?: (parentId: string | null, timestamp: string) => readonly object[],\n): string {\n\tconst filePath = resolvePath(\n\t\toutputPath ?? `session-${new Date().toISOString().replace(/[:.]/g, \"-\")}.jsonl`,\n\t\tprocess.cwd(),\n\t);\n\tconst dir = dirname(filePath);\n\tif (!existsSync(dir)) {\n\t\tmkdirSync(dir, { recursive: true });\n\t}\n\n\tconst timestamp = new Date().toISOString();\n\tconst header: SessionHeader = {\n\t\ttype: \"session\",\n\t\tversion: CURRENT_SESSION_VERSION,\n\t\tid: sessionManager.getSessionId(),\n\t\ttimestamp,\n\t\tcwd: sessionManager.getCwd(),\n\t};\n\tconst lines = [JSON.stringify(header)];\n\n\tlet parentId: string | null = null;\n\tfor (const entry of sessionManager.getBranch()) {\n\t\tlines.push(JSON.stringify({ ...entry, parentId }));\n\t\tparentId = entry.id;\n\t}\n\tfor (const entry of createTrailingEntries?.(parentId, timestamp) ?? []) {\n\t\tlines.push(JSON.stringify(entry));\n\t}\n\n\twriteFileSync(filePath, `${lines.join(\"\\n\")}\\n`);\n\treturn filePath;\n}\n"]}

package/dist/core/session-index.d.ts

@@ -0,0 +1,67 @@
+export interface SessionIndexInfo {
+    path: string;
+    sessionId: string;
+    cwd: string;
+    name: string | undefined;
+    parentSessionPath: string | undefined;
+    createdMs: number;
+    modifiedMs: number;
+    messageCount: number;
+    firstMessage: string;
+    searchText: string;
+}
+export interface SessionSearchResult {
+    path: string;
+    sessionId: string;
+    sessionName: string | undefined;
+    snippet: string;
+    role: string;
+    timestampMs: number;
+}
+/**
+ * Disposable SQLite sidecar index over the session JSONL files. The JSONL
+ * files stay the source of truth; losing or deleting the index never loses
+ * session data — a rebuild reconstructs everything from the files.
+ */
+export declare class SessionIndex {
+    private readonly db;
+    private constructor();
+    /**
+     * Open (and initialize) the index database. Returns null when indexing is
+     * unavailable — disabled by env, module load failure, or open failure — in
+     * which case callers fall back to the JSONL scan.
+     */
+    static open(dbPath?: string): SessionIndex | null;
+    /** Whether the file is indexed and its indexed stat values are still current. */
+    isFresh(path: string, size: number, mtimeMs: number): boolean;
+    getSession(path: string): SessionIndexInfo | undefined;
+    /** Row for a file whose indexed stat values still match; undefined otherwise. */
+    getFreshSession(path: string, size: number, mtimeMs: number): SessionIndexInfo | undefined;
+    listSessions(): SessionIndexInfo[];
+    /**
+     * Index a session file. Full parse on first sight or after shrinks/rewrites;
+     * when the file grew by appended bytes with an unchanged header, only the
+     * new bytes are parsed. Metadata is always refreshed so staleness checks
+     * pass afterwards.
+     */
+    indexFile(filePath: string, stats: {
+        size: number;
+        mtimeMs: number;
+    }, meta: {
+        sessionId: string;
+        cwd: string;
+        name: string | undefined;
+        parentSessionPath: string | undefined;
+        createdMs: number;
+        modifiedMs: number;
+        messageCount: number;
+        firstMessage: string;
+        searchText: string;
+    }): void;
+    removeFile(path: string): void;
+    /** Drop rows whose files no longer exist on disk. */
+    prune(existingPaths: Set<string>): void;
+    rebuild(): void;
+    search(query: string, limit?: number): SessionSearchResult[];
+}
+//# sourceMappingURL=session-index.d.ts.map

package/dist/core/session-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-index.d.ts","sourceRoot":"","sources":["../../src/core/session-index.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;IAElC,OAAO,eAEN;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA6ChD;IAED,iFAAiF;IACjF,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAS5D;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAYrD;IAED,iFAAiF;IACjF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAYzF;IAED,YAAY,IAAI,gBAAgB,EAAE,CAWjC;IAED;;;;;OAKG;IACH,SAAS,CACR,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACxC,IAAI,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QACzB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACnB,GACC,IAAI,CA8DN;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO7B;IAED,qDAAqD;IACrD,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAStC;IAED,OAAO,IAAI,IAAI,CAMd;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,mBAAmB,EAAE,CA8BvD;CACD","sourcesContent":["import { DatabaseSync } from \"node:sqlite\";\nimport { createHash } from \"crypto\";\nimport { closeSync, existsSync, openSync, readSync, statSync } from \"fs\";\nimport { join } from \"path\";\nimport { getCacheDir } from \"../config.ts\";\nimport { extractTextContent, parseSessionEntryLine } from \"./session-manager.ts\";\n\nconst INDEX_SCHEMA_VERSION = \"1\";\nconst CHUNK_SIZE = 256 * 1024;\n\nexport interface SessionIndexInfo {\n\tpath: string;\n\tsessionId: string;\n\tcwd: string;\n\tname: string | undefined;\n\tparentSessionPath: string | undefined;\n\tcreatedMs: number;\n\tmodifiedMs: number;\n\tmessageCount: number;\n\tfirstMessage: string;\n\tsearchText: string;\n}\n\nexport interface SessionSearchResult {\n\tpath: string;\n\tsessionId: string;\n\tsessionName: string | undefined;\n\tsnippet: string;\n\trole: string;\n\ttimestampMs: number;\n}\n\n/**\n * Disposable SQLite sidecar index over the session JSONL files. The JSONL\n * files stay the source of truth; losing or deleting the index never loses\n * session data — a rebuild reconstructs everything from the files.\n */\nexport class SessionIndex {\n\tprivate readonly db: DatabaseSync;\n\n\tprivate constructor(db: DatabaseSync) {\n\t\tthis.db = db;\n\t}\n\n\t/**\n\t * Open (and initialize) the index database. Returns null when indexing is\n\t * unavailable — disabled by env, module load failure, or open failure — in\n\t * which case callers fall back to the JSONL scan.\n\t */\n\tstatic open(dbPath?: string): SessionIndex | null {\n\t\tif (process.env.ION_DISABLE_SESSION_INDEX === \"1\") return null;\n\t\ttry {\n\t\t\tconst resolved = dbPath ?? join(getCacheDir(), \"index.db\");\n\t\t\tconst db = new DatabaseSync(resolved);\n\t\t\tdb.exec(\"PRAGMA journal_mode = WAL;\");\n\t\t\tdb.exec(\"PRAGMA busy_timeout = 3000;\");\n\t\t\tdb.exec(`\n\t\t\t\tCREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT);\n\t\t\t\tCREATE TABLE IF NOT EXISTS sessions (\n\t\t\t\t\tpath TEXT PRIMARY KEY,\n\t\t\t\t\tsession_id TEXT NOT NULL,\n\t\t\t\t\tcwd TEXT NOT NULL,\n\t\t\t\t\tname TEXT,\n\t\t\t\t\tparent_session TEXT,\n\t\t\t\t\tcreated_ms INTEGER NOT NULL,\n\t\t\t\t\tmodified_ms INTEGER NOT NULL,\n\t\t\t\t\tmessage_count INTEGER NOT NULL,\n\t\t\t\t\tfirst_message TEXT NOT NULL,\n\t\t\t\t\tsearch_text TEXT NOT NULL,\n\t\t\t\t\tsize INTEGER NOT NULL,\n\t\t\t\t\tmtime_ms INTEGER NOT NULL,\n\t\t\t\t\tbyte_offset INTEGER NOT NULL,\n\t\t\t\t\theader_hash TEXT NOT NULL\n\t\t\t\t);\n\t\t\t\tCREATE VIRTUAL TABLE IF NOT EXISTS messages_fts USING fts5(\n\t\t\t\t\ttext,\n\t\t\t\t\tpath UNINDEXED, line UNINDEXED, entry_id UNINDEXED,\n\t\t\t\t\trole UNINDEXED, timestamp_ms UNINDEXED\n\t\t\t\t);\n\t\t\t`);\n\t\t\tconst version = db.prepare(\"SELECT value FROM meta WHERE key = 'schema_version'\").get() as\n\t\t\t\t| { value: string }\n\t\t\t\t| undefined;\n\t\t\tif (version?.value !== INDEX_SCHEMA_VERSION) {\n\t\t\t\t// Unrecognized (older or newer) index: discard and rebuild from scratch.\n\t\t\t\tdb.exec(\"DELETE FROM sessions; DELETE FROM messages_fts;\");\n\t\t\t\tdb.prepare(\"INSERT OR REPLACE INTO meta (key, value) VALUES ('schema_version', ?)\").run(\n\t\t\t\t\tINDEX_SCHEMA_VERSION,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn new SessionIndex(db);\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t/** Whether the file is indexed and its indexed stat values are still current. */\n\tisFresh(path: string, size: number, mtimeMs: number): boolean {\n\t\ttry {\n\t\t\tconst row = this.db.prepare(\"SELECT size, mtime_ms FROM sessions WHERE path = ?\").get(path) as\n\t\t\t\t| { size: number; mtime_ms: number }\n\t\t\t\t| undefined;\n\t\t\treturn row !== undefined && row.size === size && row.mtime_ms === mtimeMs;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tgetSession(path: string): SessionIndexInfo | undefined {\n\t\ttry {\n\t\t\tconst row = this.db\n\t\t\t\t.prepare(\n\t\t\t\t\t\"SELECT path, session_id, cwd, name, created_ms, modified_ms, message_count, first_message FROM sessions WHERE path = ?\",\n\t\t\t\t)\n\t\t\t\t.get(path) as Record<string, unknown> | undefined;\n\t\t\tif (!row) return undefined;\n\t\t\treturn rowToInfo(row);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\t/** Row for a file whose indexed stat values still match; undefined otherwise. */\n\tgetFreshSession(path: string, size: number, mtimeMs: number): SessionIndexInfo | undefined {\n\t\ttry {\n\t\t\tconst row = this.db\n\t\t\t\t.prepare(\n\t\t\t\t\t\"SELECT path, session_id, cwd, name, parent_session, created_ms, modified_ms, message_count, first_message, search_text FROM sessions WHERE path = ? AND size = ? AND mtime_ms = ?\",\n\t\t\t\t)\n\t\t\t\t.get(path, size, mtimeMs) as Record<string, unknown> | undefined;\n\t\t\tif (!row) return undefined;\n\t\t\treturn rowToInfo(row);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tlistSessions(): SessionIndexInfo[] {\n\t\ttry {\n\t\t\tconst rows = this.db\n\t\t\t\t.prepare(\n\t\t\t\t\t\"SELECT path, session_id, cwd, name, parent_session, created_ms, modified_ms, message_count, first_message, search_text FROM sessions\",\n\t\t\t\t)\n\t\t\t\t.all() as Array<Record<string, unknown>>;\n\t\t\treturn rows.map(rowToInfo);\n\t\t} catch {\n\t\t\treturn [];\n\t\t}\n\t}\n\n\t/**\n\t * Index a session file. Full parse on first sight or after shrinks/rewrites;\n\t * when the file grew by appended bytes with an unchanged header, only the\n\t * new bytes are parsed. Metadata is always refreshed so staleness checks\n\t * pass afterwards.\n\t */\n\tindexFile(\n\t\tfilePath: string,\n\t\tstats: { size: number; mtimeMs: number },\n\t\tmeta: {\n\t\t\tsessionId: string;\n\t\t\tcwd: string;\n\t\t\tname: string | undefined;\n\t\t\tparentSessionPath: string | undefined;\n\t\t\tcreatedMs: number;\n\t\t\tmodifiedMs: number;\n\t\t\tmessageCount: number;\n\t\t\tfirstMessage: string;\n\t\t\tsearchText: string;\n\t\t},\n\t): void {\n\t\ttry {\n\t\t\tconst existing = this.db\n\t\t\t\t.prepare(\"SELECT size, byte_offset, header_hash FROM sessions WHERE path = ?\")\n\t\t\t\t.get(filePath) as { size: number; byte_offset: number; header_hash: string } | undefined;\n\n\t\t\tlet fromOffset = 0;\n\t\t\tlet searchText = meta.searchText;\n\t\t\tif (existing && stats.size > existing.size && existing.byte_offset > 0) {\n\t\t\t\tconst headerHash = hashHeaderLine(filePath);\n\t\t\t\tif (headerHash === existing.header_hash) {\n\t\t\t\t\tfromOffset = existing.byte_offset;\n\t\t\t\t\t// Incremental appends keep the stored head-of-transcript search\n\t\t\t\t\t// text: the cap means appended tail bytes rarely change it.\n\t\t\t\t\tconst row = this.db.prepare(\"SELECT search_text FROM sessions WHERE path = ?\").get(filePath) as\n\t\t\t\t\t\t| { search_text: string }\n\t\t\t\t\t\t| undefined;\n\t\t\t\t\tif (row) searchText = row.search_text;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst parsed = parseEntriesFromOffset(filePath, fromOffset);\n\t\t\tconst tx = this.db;\n\t\t\ttx.exec(\"BEGIN\");\n\t\t\ttry {\n\t\t\t\tif (fromOffset === 0) {\n\t\t\t\t\ttx.prepare(\"DELETE FROM messages_fts WHERE path = ?\").run(filePath);\n\t\t\t\t}\n\t\t\t\tconst insert = tx.prepare(\n\t\t\t\t\t\"INSERT INTO messages_fts (text, path, line, entry_id, role, timestamp_ms) VALUES (?, ?, ?, ?, ?, ?)\",\n\t\t\t\t);\n\t\t\t\tfor (const message of parsed.messages) {\n\t\t\t\t\tinsert.run(message.text, filePath, message.line, message.entryId, message.role, message.timestampMs);\n\t\t\t\t}\n\t\t\t\ttx.prepare(\n\t\t\t\t\t`INSERT OR REPLACE INTO sessions\n\t\t\t\t\t (path, session_id, cwd, name, parent_session, created_ms, modified_ms, message_count, first_message, search_text, size, mtime_ms, byte_offset, header_hash)\n\t\t\t\t\t VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n\t\t\t\t).run(\n\t\t\t\t\tfilePath,\n\t\t\t\t\tmeta.sessionId,\n\t\t\t\t\tmeta.cwd,\n\t\t\t\t\tmeta.name ?? null,\n\t\t\t\t\tmeta.parentSessionPath ?? null,\n\t\t\t\t\tmeta.createdMs,\n\t\t\t\t\tmeta.modifiedMs,\n\t\t\t\t\tmeta.messageCount,\n\t\t\t\t\tmeta.firstMessage,\n\t\t\t\t\tsearchText,\n\t\t\t\t\tstats.size,\n\t\t\t\t\tstats.mtimeMs,\n\t\t\t\t\tparsed.byteOffset,\n\t\t\t\t\thashHeaderLine(filePath),\n\t\t\t\t);\n\t\t\t\ttx.exec(\"COMMIT\");\n\t\t\t} catch (error) {\n\t\t\t\ttx.exec(\"ROLLBACK\");\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t} catch {\n\t\t\t// Index write failures are non-fatal; the JSONL scan remains correct.\n\t\t}\n\t}\n\n\tremoveFile(path: string): void {\n\t\ttry {\n\t\t\tthis.db.prepare(\"DELETE FROM messages_fts WHERE path = ?\").run(path);\n\t\t\tthis.db.prepare(\"DELETE FROM sessions WHERE path = ?\").run(path);\n\t\t} catch {\n\t\t\t// Non-fatal.\n\t\t}\n\t}\n\n\t/** Drop rows whose files no longer exist on disk. */\n\tprune(existingPaths: Set<string>): void {\n\t\ttry {\n\t\t\tconst rows = this.db.prepare(\"SELECT path FROM sessions\").all() as Array<{ path: string }>;\n\t\t\tfor (const row of rows) {\n\t\t\t\tif (!existingPaths.has(row.path)) this.removeFile(row.path);\n\t\t\t}\n\t\t} catch {\n\t\t\t// Non-fatal.\n\t\t}\n\t}\n\n\trebuild(): void {\n\t\ttry {\n\t\t\tthis.db.exec(\"DELETE FROM sessions; DELETE FROM messages_fts;\");\n\t\t} catch {\n\t\t\t// Non-fatal.\n\t\t}\n\t}\n\n\tsearch(query: string, limit = 50): SessionSearchResult[] {\n\t\tconst escaped = escapeFtsQuery(query);\n\t\tif (!escaped) return [];\n\t\ttry {\n\t\t\tconst statement = this.db.prepare(\n\t\t\t\t`SELECT path, entry_id, role, timestamp_ms,\n\t\t\t        snippet(messages_fts, 0, '', '', ' … ', 12) AS snippet,\n\t\t\t        bm25(messages_fts) AS rank\n\t\t\t FROM messages_fts WHERE messages_fts MATCH ?\n\t\t\t ORDER BY rank LIMIT ?`,\n\t\t\t);\n\t\t\tconst parameters: [string, number] = [escaped, limit];\n\t\t\tconst rows = statement.all(...parameters) as Array<Record<string, unknown>>;\n\t\t\tconst results: SessionSearchResult[] = [];\n\t\t\tconst getSession = this.db.prepare(\"SELECT session_id, name FROM sessions WHERE path = ?\");\n\t\t\tfor (const row of rows) {\n\t\t\t\tconst session = getSession.get(String(row.path)) as { session_id: string; name: string | null } | undefined;\n\t\t\t\tresults.push({\n\t\t\t\t\tpath: String(row.path),\n\t\t\t\t\tsessionId: session?.session_id ?? \"\",\n\t\t\t\t\tsessionName: session?.name ?? undefined,\n\t\t\t\t\tsnippet: typeof row.snippet === \"string\" ? row.snippet : String(row.text ?? \"\"),\n\t\t\t\t\trole: String(row.role),\n\t\t\t\t\ttimestampMs: Number(row.timestamp_ms),\n\t\t\t\t});\n\t\t\t}\n\t\t\treturn results;\n\t\t} catch {\n\t\t\treturn [];\n\t\t}\n\t}\n}\n\nfunction rowToInfo(row: Record<string, unknown>): SessionIndexInfo {\n\treturn {\n\t\tpath: String(row.path),\n\t\tsessionId: String(row.session_id),\n\t\tcwd: String(row.cwd),\n\t\tname: typeof row.name === \"string\" && row.name.length > 0 ? row.name : undefined,\n\t\tparentSessionPath:\n\t\t\ttypeof row.parent_session === \"string\" && row.parent_session.length > 0 ? row.parent_session : undefined,\n\t\tcreatedMs: Number(row.created_ms),\n\t\tmodifiedMs: Number(row.modified_ms),\n\t\tmessageCount: Number(row.message_count),\n\t\tfirstMessage: String(row.first_message),\n\t\tsearchText: String(row.search_text ?? \"\"),\n\t};\n}\n\nfunction hashHeaderLine(filePath: string): string {\n\tif (!existsSync(filePath)) return \"\";\n\tconst fd = openSync(filePath, \"r\");\n\ttry {\n\t\tconst buffer = Buffer.alloc(4096);\n\t\tconst read = readSync(fd, buffer, 0, 4096, 0);\n\t\tconst firstLineEnd = buffer.subarray(0, read).indexOf(0x0a);\n\t\tconst headerLine = firstLineEnd === -1 ? buffer.subarray(0, read) : buffer.subarray(0, firstLineEnd);\n\t\treturn createHash(\"sha1\").update(headerLine).digest(\"hex\");\n\t} finally {\n\t\tcloseSync(fd);\n\t}\n}\n\ninterface ParsedIndexMessage {\n\ttext: string;\n\tline: number;\n\tentryId: string;\n\trole: string;\n\ttimestampMs: number;\n}\n\n/**\n * Parse a session file from a byte offset (0 for a full parse). Returns the\n * indexable user/assistant text messages with their absolute line numbers and\n * the safe byte offset to resume from next time (end of the last complete,\n * well-formed line).\n */\nfunction parseEntriesFromOffset(\n\tfilePath: string,\n\tfromOffset: number,\n): { messages: ParsedIndexMessage[]; byteOffset: number } {\n\tconst messages: ParsedIndexMessage[] = [];\n\tif (!existsSync(filePath)) return { messages, byteOffset: fromOffset };\n\n\tconst size = statSync(filePath).size;\n\tif (size <= fromOffset) return { messages, byteOffset: fromOffset };\n\n\tconst fd = openSync(filePath, \"r\");\n\ttry {\n\t\tconst buffer = Buffer.alloc(CHUNK_SIZE);\n\t\tlet offset = fromOffset;\n\t\tlet lineStart = fromOffset;\n\t\tlet lineBuffer = \"\";\n\t\tlet lineNumber = countCompleteLinesBefore(filePath, fromOffset);\n\t\tlet safeOffset = fromOffset;\n\n\t\tconst handleLine = (line: string): void => {\n\t\t\tlineNumber += 1;\n\t\t\tconst entry = parseSessionEntryLine(line);\n\t\t\tif (!entry || entry.type !== \"message\") return;\n\t\t\tconst message = entry.message;\n\t\t\tconst role = message?.role;\n\t\t\tif (role !== \"user\" && role !== \"assistant\") return;\n\t\t\tconst text = extractTextContent(message);\n\t\t\tif (!text) return;\n\t\t\tmessages.push({\n\t\t\t\ttext,\n\t\t\t\tline: lineNumber,\n\t\t\t\tentryId: entry.id,\n\t\t\t\trole,\n\t\t\t\ttimestampMs: new Date(entry.timestamp).getTime() || 0,\n\t\t\t});\n\t\t};\n\n\t\twhile (offset < size) {\n\t\t\tconst read = readSync(fd, buffer, 0, CHUNK_SIZE, offset);\n\t\t\tif (read === 0) break;\n\t\t\tlet chunkStart = 0;\n\t\t\tfor (let i = 0; i < read; i++) {\n\t\t\t\tif (buffer[i] === 0x0a) {\n\t\t\t\t\tlineBuffer += buffer.toString(\"utf8\", chunkStart, i);\n\t\t\t\t\thandleLine(lineBuffer);\n\t\t\t\t\tlineBuffer = \"\";\n\t\t\t\t\tchunkStart = i + 1;\n\t\t\t\t\tlineStart = offset + i + 1;\n\t\t\t\t\tsafeOffset = lineStart;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (chunkStart < read) {\n\t\t\t\tlineBuffer += buffer.toString(\"utf8\", chunkStart, read);\n\t\t\t}\n\t\t\toffset += read;\n\t\t}\n\n\t\t// Trailing bytes without a newline: parse them opportunistically.\n\t\t// A partial line from a mid-write crash will fail JSON.parse and be\n\t\t// skipped; the next incremental read starts past it regardless.\n\t\tif (lineBuffer.trim()) {\n\t\t\thandleLine(lineBuffer);\n\t\t}\n\t\tsafeOffset = size;\n\n\t\treturn { messages, byteOffset: Math.max(safeOffset, fromOffset) };\n\t} catch {\n\t\treturn { messages, byteOffset: fromOffset };\n\t} finally {\n\t\tcloseSync(fd);\n\t}\n}\n\n/** Count '\\n' bytes in the file prefix [0, offset) so absolute line numbers stay correct. */\nfunction countCompleteLinesBefore(filePath: string, offset: number): number {\n\tif (offset <= 0) return 0;\n\tconst fd = openSync(filePath, \"r\");\n\ttry {\n\t\tconst buffer = Buffer.alloc(CHUNK_SIZE);\n\t\tlet position = 0;\n\t\tlet count = 0;\n\t\twhile (position < offset) {\n\t\t\tconst read = readSync(fd, buffer, 0, Math.min(CHUNK_SIZE, offset - position), position);\n\t\t\tif (read === 0) break;\n\t\t\tfor (let i = 0; i < read; i++) {\n\t\t\t\tif (buffer[i] === 0x0a) count += 1;\n\t\t\t}\n\t\t\tposition += read;\n\t\t}\n\t\treturn count;\n\t} catch {\n\t\treturn 0;\n\t} finally {\n\t\tcloseSync(fd);\n\t}\n}\n\n/**\n * Escape user input into a safe FTS5 query: split on whitespace, quote each\n * term, and neutralize embedded double quotes so user text is treated as\n * search terms, never as index grammar.\n */\nfunction escapeFtsQuery(query: string): string {\n\tconst terms = query\n\t\t.trim()\n\t\t.split(/\\s+/)\n\t\t.map((term) => term.replace(/\"/g, '\"\"'))\n\t\t.filter((term) => term.length > 0);\n\tif (terms.length === 0) return \"\";\n\treturn `\"${terms.join('\" \"')}\"`;\n}\n"]}