@aexol/spectral 0.7.0 → 0.7.3

package/dist/pi/coding-agent/core/agent-session-runtime.js

@@ -0,0 +1,299 @@
+import { copyFileSync, existsSync, mkdirSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { resolvePath } from "../utils/paths.js";
+import { emitSessionShutdownEvent } from "./extensions/runner.js";
+import { assertSessionCwdExists } from "./session-cwd.js";
+import { SessionManager } from "./session-manager.js";
+/**
+ * Thrown when /import references a JSONL file path that does not exist.
+ */
+export class SessionImportFileNotFoundError extends Error {
+    filePath;
+    constructor(filePath) {
+        super(`File not found: ${filePath}`);
+        this.name = "SessionImportFileNotFoundError";
+        this.filePath = filePath;
+    }
+}
+function extractUserMessageText(content) {
+    if (typeof content === "string") {
+        return content;
+    }
+    return content
+        .filter((part) => part.type === "text" && typeof part.text === "string")
+        .map((part) => part.text)
+        .join("");
+}
+/**
+ * Owns the current AgentSession plus its cwd-bound services.
+ *
+ * Session replacement methods tear down the current runtime first, then create
+ * and apply the next runtime. If creation fails, the error is propagated to the
+ * caller. The caller is responsible for user-facing error handling.
+ */
+export class AgentSessionRuntime {
+    rebindSession;
+    beforeSessionInvalidate;
+    _session;
+    _services;
+    createRuntime;
+    _diagnostics;
+    _modelFallbackMessage;
+    constructor(_session, _services, createRuntime, _diagnostics = [], _modelFallbackMessage) {
+        this._session = _session;
+        this._services = _services;
+        this.createRuntime = createRuntime;
+        this._diagnostics = _diagnostics;
+        this._modelFallbackMessage = _modelFallbackMessage;
+    }
+    get services() {
+        return this._services;
+    }
+    get session() {
+        return this._session;
+    }
+    get cwd() {
+        return this._services.cwd;
+    }
+    get diagnostics() {
+        return this._diagnostics;
+    }
+    get modelFallbackMessage() {
+        return this._modelFallbackMessage;
+    }
+    setRebindSession(rebindSession) {
+        this.rebindSession = rebindSession;
+    }
+    /**
+     * Set a synchronous callback that runs after `session_shutdown` handlers finish
+     * but before the current session is invalidated.
+     *
+     * This is for host-owned UI teardown that must not yield to the event loop,
+     * such as detaching extension-provided TUI components before the old extension
+     * context becomes stale.
+     */
+    setBeforeSessionInvalidate(beforeSessionInvalidate) {
+        this.beforeSessionInvalidate = beforeSessionInvalidate;
+    }
+    async emitBeforeSwitch(reason, targetSessionFile) {
+        const runner = this.session.extensionRunner;
+        if (!runner.hasHandlers("session_before_switch")) {
+            return { cancelled: false };
+        }
+        const result = await runner.emit({
+            type: "session_before_switch",
+            reason,
+            targetSessionFile,
+        });
+        return { cancelled: result?.cancel === true };
+    }
+    async emitBeforeFork(entryId, options) {
+        const runner = this.session.extensionRunner;
+        if (!runner.hasHandlers("session_before_fork")) {
+            return { cancelled: false };
+        }
+        const result = await runner.emit({
+            type: "session_before_fork",
+            entryId,
+            ...options,
+        });
+        return { cancelled: result?.cancel === true };
+    }
+    async teardownCurrent(reason, targetSessionFile) {
+        await emitSessionShutdownEvent(this.session.extensionRunner, {
+            type: "session_shutdown",
+            reason,
+            targetSessionFile,
+        });
+        this.beforeSessionInvalidate?.();
+        this.session.dispose();
+    }
+    apply(result) {
+        this._session = result.session;
+        this._services = result.services;
+        this._diagnostics = result.diagnostics;
+        this._modelFallbackMessage = result.modelFallbackMessage;
+    }
+    async finishSessionReplacement(withSession) {
+        if (this.rebindSession) {
+            await this.rebindSession(this.session);
+        }
+        if (withSession) {
+            await withSession(this.session.createReplacedSessionContext());
+        }
+    }
+    async switchSession(sessionPath, options) {
+        const beforeResult = await this.emitBeforeSwitch("resume", sessionPath);
+        if (beforeResult.cancelled) {
+            return beforeResult;
+        }
+        const previousSessionFile = this.session.sessionFile;
+        const sessionManager = SessionManager.open(sessionPath, undefined, options?.cwdOverride);
+        assertSessionCwdExists(sessionManager, this.cwd);
+        await this.teardownCurrent("resume", sessionManager.getSessionFile());
+        this.apply(await this.createRuntime({
+            cwd: sessionManager.getCwd(),
+            agentDir: this.services.agentDir,
+            sessionManager,
+            sessionStartEvent: { type: "session_start", reason: "resume", previousSessionFile },
+        }));
+        await this.finishSessionReplacement(options?.withSession);
+        return { cancelled: false };
+    }
+    async newSession(options) {
+        const beforeResult = await this.emitBeforeSwitch("new");
+        if (beforeResult.cancelled) {
+            return beforeResult;
+        }
+        const previousSessionFile = this.session.sessionFile;
+        const sessionDir = this.session.sessionManager.getSessionDir();
+        const sessionManager = SessionManager.create(this.cwd, sessionDir);
+        if (options?.parentSession) {
+            sessionManager.newSession({ parentSession: options.parentSession });
+        }
+        await this.teardownCurrent("new", sessionManager.getSessionFile());
+        this.apply(await this.createRuntime({
+            cwd: this.cwd,
+            agentDir: this.services.agentDir,
+            sessionManager,
+            sessionStartEvent: { type: "session_start", reason: "new", previousSessionFile },
+        }));
+        if (options?.setup) {
+            await options.setup(this.session.sessionManager);
+            this.session.agent.state.messages = this.session.sessionManager.buildSessionContext().messages;
+        }
+        await this.finishSessionReplacement(options?.withSession);
+        return { cancelled: false };
+    }
+    async fork(entryId, options) {
+        const position = options?.position ?? "before";
+        const beforeResult = await this.emitBeforeFork(entryId, { position });
+        if (beforeResult.cancelled) {
+            return { cancelled: true };
+        }
+        let targetLeafId;
+        let selectedText;
+        const selectedEntry = this.session.sessionManager.getEntry(entryId);
+        if (!selectedEntry) {
+            throw new Error("Invalid entry ID for forking");
+        }
+        if (position === "at") {
+            targetLeafId = selectedEntry.id;
+        }
+        else {
+            if (selectedEntry.type !== "message" || selectedEntry.message.role !== "user") {
+                throw new Error("Invalid entry ID for forking");
+            }
+            targetLeafId = selectedEntry.parentId;
+            selectedText = extractUserMessageText(selectedEntry.message.content);
+        }
+        const previousSessionFile = this.session.sessionFile;
+        if (this.session.sessionManager.isPersisted()) {
+            const currentSessionFile = this.session.sessionFile;
+            if (!currentSessionFile) {
+                throw new Error("Persisted session is missing a session file");
+            }
+            const sessionDir = this.session.sessionManager.getSessionDir();
+            if (!targetLeafId) {
+                const sessionManager = SessionManager.create(this.cwd, sessionDir);
+                sessionManager.newSession({ parentSession: currentSessionFile });
+                await this.teardownCurrent("fork", sessionManager.getSessionFile());
+                this.apply(await this.createRuntime({
+                    cwd: this.cwd,
+                    agentDir: this.services.agentDir,
+                    sessionManager,
+                    sessionStartEvent: { type: "session_start", reason: "fork", previousSessionFile },
+                }));
+                await this.finishSessionReplacement(options?.withSession);
+                return { cancelled: false, selectedText };
+            }
+            const sessionManager = SessionManager.open(currentSessionFile, sessionDir);
+            const forkedSessionPath = sessionManager.createBranchedSession(targetLeafId);
+            if (!forkedSessionPath) {
+                throw new Error("Failed to create forked session");
+            }
+            await this.teardownCurrent("fork", sessionManager.getSessionFile());
+            this.apply(await this.createRuntime({
+                cwd: sessionManager.getCwd(),
+                agentDir: this.services.agentDir,
+                sessionManager,
+                sessionStartEvent: { type: "session_start", reason: "fork", previousSessionFile },
+            }));
+            await this.finishSessionReplacement(options?.withSession);
+            return { cancelled: false, selectedText };
+        }
+        const sessionManager = this.session.sessionManager;
+        if (!targetLeafId) {
+            sessionManager.newSession({ parentSession: this.session.sessionFile });
+        }
+        else {
+            sessionManager.createBranchedSession(targetLeafId);
+        }
+        await this.teardownCurrent("fork", sessionManager.getSessionFile());
+        this.apply(await this.createRuntime({
+            cwd: this.cwd,
+            agentDir: this.services.agentDir,
+            sessionManager,
+            sessionStartEvent: { type: "session_start", reason: "fork", previousSessionFile },
+        }));
+        await this.finishSessionReplacement(options?.withSession);
+        return { cancelled: false, selectedText };
+    }
+    /**
+     * Import a session JSONL file and switch runtime state to the imported session.
+     *
+     * @returns `{ cancelled: true }` when cancelled by `session_before_switch`, otherwise `{ cancelled: false }`.
+     * @throws {SessionImportFileNotFoundError} When the input path does not exist.
+     * @throws {MissingSessionCwdError} When the imported session cwd cannot be resolved and no override is provided.
+     */
+    async importFromJsonl(inputPath, cwdOverride) {
+        const resolvedPath = resolvePath(inputPath);
+        if (!existsSync(resolvedPath)) {
+            throw new SessionImportFileNotFoundError(resolvedPath);
+        }
+        const sessionDir = this.session.sessionManager.getSessionDir();
+        if (!existsSync(sessionDir)) {
+            mkdirSync(sessionDir, { recursive: true });
+        }
+        const destinationPath = join(sessionDir, basename(resolvedPath));
+        const beforeResult = await this.emitBeforeSwitch("resume", destinationPath);
+        if (beforeResult.cancelled) {
+            return beforeResult;
+        }
+        const previousSessionFile = this.session.sessionFile;
+        if (resolve(destinationPath) !== resolvedPath) {
+            copyFileSync(resolvedPath, destinationPath);
+        }
+        const sessionManager = SessionManager.open(destinationPath, sessionDir, cwdOverride);
+        assertSessionCwdExists(sessionManager, this.cwd);
+        await this.teardownCurrent("resume", sessionManager.getSessionFile());
+        this.apply(await this.createRuntime({
+            cwd: sessionManager.getCwd(),
+            agentDir: this.services.agentDir,
+            sessionManager,
+            sessionStartEvent: { type: "session_start", reason: "resume", previousSessionFile },
+        }));
+        await this.finishSessionReplacement();
+        return { cancelled: false };
+    }
+    async dispose() {
+        await emitSessionShutdownEvent(this.session.extensionRunner, {
+            type: "session_shutdown",
+            reason: "quit",
+        });
+        this.beforeSessionInvalidate?.();
+        this.session.dispose();
+    }
+}
+/**
+ * Create the initial runtime from a runtime factory and initial session target.
+ *
+ * The same factory is stored on the returned AgentSessionRuntime and reused for
+ * later /new, /resume, /fork, and import flows.
+ */
+export async function createAgentSessionRuntime(createRuntime, options) {
+    assertSessionCwdExists(options.sessionManager, options.cwd);
+    const result = await createRuntime(options);
+    return new AgentSessionRuntime(result.session, result.services, createRuntime, result.diagnostics, result.modelFallbackMessage);
+}
+export { createAgentSessionFromServices, createAgentSessionServices, } from "./agent-session-services.js";

package/dist/pi/coding-agent/core/agent-session-services.js

@@ -0,0 +1,117 @@
+import { join } from "node:path";
+import { getAgentDir } from "../config.js";
+import { resolvePath } from "../utils/paths.js";
+import { AuthStorage } from "./auth-storage.js";
+import { ModelRegistry } from "./model-registry.js";
+import { DefaultResourceLoader } from "./resource-loader.js";
+import { createAgentSession } from "./sdk.js";
+import { SettingsManager } from "./settings-manager.js";
+function applyExtensionFlagValues(resourceLoader, extensionFlagValues) {
+    if (!extensionFlagValues) {
+        return [];
+    }
+    const diagnostics = [];
+    const extensionsResult = resourceLoader.getExtensions();
+    const registeredFlags = new Map();
+    for (const extension of extensionsResult.extensions) {
+        for (const [name, flag] of extension.flags) {
+            registeredFlags.set(name, { type: flag.type });
+        }
+    }
+    const unknownFlags = [];
+    for (const [name, value] of extensionFlagValues) {
+        const flag = registeredFlags.get(name);
+        if (!flag) {
+            unknownFlags.push(name);
+            continue;
+        }
+        if (flag.type === "boolean") {
+            extensionsResult.runtime.flagValues.set(name, true);
+            continue;
+        }
+        if (typeof value === "string") {
+            extensionsResult.runtime.flagValues.set(name, value);
+            continue;
+        }
+        diagnostics.push({
+            type: "error",
+            message: `Extension flag "--${name}" requires a value`,
+        });
+    }
+    if (unknownFlags.length > 0) {
+        diagnostics.push({
+            type: "error",
+            message: `Unknown option${unknownFlags.length === 1 ? "" : "s"}: ${unknownFlags.map((name) => `--${name}`).join(", ")}`,
+        });
+    }
+    return diagnostics;
+}
+/**
+ * Create cwd-bound runtime services.
+ *
+ * Returns services plus diagnostics. It does not create an AgentSession.
+ */
+export async function createAgentSessionServices(options) {
+    const cwd = resolvePath(options.cwd);
+    const agentDir = options.agentDir ? resolvePath(options.agentDir) : getAgentDir();
+    const authStorage = options.authStorage ?? AuthStorage.create(join(agentDir, "auth.json"));
+    const settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);
+    const modelRegistry = options.modelRegistry ?? ModelRegistry.create(authStorage, join(agentDir, "models.json"));
+    const resourceLoader = new DefaultResourceLoader({
+        ...(options.resourceLoaderOptions ?? {}),
+        cwd,
+        agentDir,
+        settingsManager,
+    });
+    await resourceLoader.reload();
+    const diagnostics = [];
+    const extensionsResult = resourceLoader.getExtensions();
+    for (const { name, config, extensionPath } of extensionsResult.runtime.pendingProviderRegistrations) {
+        try {
+            modelRegistry.registerProvider(name, config);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            diagnostics.push({
+                type: "error",
+                message: `Extension "${extensionPath}" error: ${message}`,
+            });
+        }
+    }
+    extensionsResult.runtime.pendingProviderRegistrations = [];
+    diagnostics.push(...applyExtensionFlagValues(resourceLoader, options.extensionFlagValues));
+    return {
+        cwd,
+        agentDir,
+        authStorage,
+        settingsManager,
+        modelRegistry,
+        resourceLoader,
+        diagnostics,
+    };
+}
+/**
+ * Create an AgentSession from previously created services.
+ *
+ * This keeps session creation separate from service creation so callers can
+ * resolve model, thinking, tools, and other session inputs against the target
+ * cwd before constructing the session.
+ */
+export async function createAgentSessionFromServices(options) {
+    return createAgentSession({
+        cwd: options.services.cwd,
+        agentDir: options.services.agentDir,
+        authStorage: options.services.authStorage,
+        settingsManager: options.services.settingsManager,
+        modelRegistry: options.services.modelRegistry,
+        resourceLoader: options.services.resourceLoader,
+        sessionManager: options.sessionManager,
+        model: options.model,
+        thinkingLevel: options.thinkingLevel,
+        scopedModels: options.scopedModels,
+        tools: options.tools,
+        noTools: options.noTools,
+        customTools: options.customTools,
+        sessionStartEvent: options.sessionStartEvent,
+    });
+}