@tryglen/cli 0.24.10 → 0.26.0

package/dist/commands/takeover/_utils/write-cursor-session.js

@@ -0,0 +1,174 @@
+import { randomUUID } from "node:crypto";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { cliErr } from "../../../_utils/cli-error.js";
+import { findBin, isExecutable } from "../../../_utils/find-bin.js";
+import { parseCursorDb } from "../../../_utils/parse-cursor-db.js";
+import { err, ok } from "../../../_utils/result.js";
+import { cursorStore } from "./cursor-store.js";
+import { nativeFile } from "./native-file.js";
+import { probeAgent } from "./probe-agent.js";
+import { provenanceContext } from "./provenance-context.js";
+const cursorBinary = () => {
+    if (process.env.GLEN_CURSOR_BIN)
+        return process.env.GLEN_CURSOR_BIN;
+    const found = findBin("cursor");
+    if (found)
+        return found;
+    const mac = "/Applications/Cursor.app/Contents/Resources/app/bin/cursor";
+    return isExecutable(mac) ? mac : undefined;
+};
+const writeCursorSession = (payload, workspace) => {
+    const locate = () => cursorStore.locate(workspace);
+    const probe = async () => {
+        const paths = await locate();
+        if (!paths.ok)
+            return paths;
+        const store = await cursorStore.probe(paths.value);
+        if (!store.ok)
+            return store;
+        const binary = cursorBinary();
+        return probeAgent({
+            displayName: "Cursor",
+            binName: "cursor",
+            ...(binary ? { binaryOverride: binary } : {}),
+            versionPattern: /^3\.9\./,
+            model: "cursor-auto",
+            contextWindowTokens: 128_000,
+            startupReserveTokens: 16_384,
+            responseReserveTokens: 32_768,
+        });
+    };
+    const stage = async () => {
+        const paths = await locate();
+        if (!paths.ok)
+            return paths;
+        const now = Date.now();
+        const bubbles = [
+            {
+                bubbleId: randomUUID(),
+                type: 2,
+                text: provenanceContext(payload.provenance),
+                createdAt: now,
+                glenTakeoverProvenance: true,
+            },
+            ...payload.messages.map((message, index) => ({
+                bubbleId: randomUUID(),
+                type: message.role === "user" ? 1 : 2,
+                text: message.content,
+                createdAt: now + index + 1,
+            })),
+        ];
+        const headers = bubbles.map(({ bubbleId, type }) => ({ bubbleId, type }));
+        const workspaceIdentifier = {
+            id: paths.value.workspaceId,
+            uri: {
+                $mid: 1,
+                fsPath: workspace,
+                external: pathToFileURL(workspace).href,
+                path: workspace,
+                scheme: "file",
+            },
+        };
+        const composer = JSON.stringify({
+            _v: 1,
+            composerId: payload.destinationSessionId,
+            createdAt: now,
+            status: "completed",
+            conversationState: "completed",
+            unifiedMode: "agent",
+            forceMode: "edit",
+            isAgentic: true,
+            isDraft: false,
+            hasLoaded: true,
+            fullConversationHeadersOnly: headers,
+            context: {},
+            modelConfig: { modelName: "auto" },
+            text: "",
+            richText: "",
+            queueItems: [],
+            todos: [],
+            glenTakeover: { sourceEntityId: payload.provenance.sourceEntityId },
+        });
+        const header = JSON.stringify({
+            composerId: payload.destinationSessionId,
+            createdAt: now,
+            lastUpdatedAt: now,
+            type: "head",
+            unifiedMode: "agent",
+            forceMode: "edit",
+            isArchived: false,
+            isDraft: false,
+            isProject: false,
+            isSpec: false,
+            isWorktree: false,
+            isBestOfNSubcomposer: false,
+            hasUnreadMessages: false,
+            hasBeenInSidebar: true,
+            numSubComposers: 0,
+            totalLinesAdded: 0,
+            totalLinesRemoved: 0,
+            workspaceIdentifier,
+            trackedGitRepos: [],
+            referencedPlans: [],
+            worktreeStartedReadOnly: false,
+        });
+        const staged = await cursorStore.stage(paths.value, {
+            sessionId: payload.destinationSessionId,
+            workspaceId: paths.value.workspaceId,
+            composer,
+            header,
+            bubbles: bubbles.map((bubble) => ({
+                key: `bubbleId:${payload.destinationSessionId}:${bubble.bubbleId}`,
+                value: JSON.stringify(bubble),
+            })),
+            workspaceIndex: "",
+            now,
+        });
+        return staged.ok
+            ? ok({
+                path: staged.value.path,
+                recoveryCommand: `cursor ${JSON.stringify(workspace)}`,
+            })
+            : staged;
+    };
+    const parse = async (staged) => {
+        const parsed = await parseCursorDb(join(staged.path, "global.vscdb"));
+        if (!parsed.ok)
+            return parsed;
+        const transcript = parsed.value.find((candidate) => candidate.sessionId === payload.destinationSessionId);
+        return transcript
+            ? ok(transcript.messages.map(({ role, text }) => ({
+                role,
+                content: text,
+            })))
+            : err(cliErr({
+                what: "Cursor could not parse the staged takeover conversation",
+                path: staged.path,
+                remedy: "update Glen and Cursor, then retry",
+            }));
+    };
+    return {
+        probe,
+        stage,
+        parse,
+        install: async (staged) => {
+            const paths = await locate();
+            if (!paths.ok)
+                return paths;
+            const installed = await cursorStore.install(paths.value, staged.path, payload.destinationSessionId);
+            return installed.ok
+                ? ok({ recoveryCommand: staged.recoveryCommand })
+                : installed;
+        },
+        launch: async () => {
+            const checked = await probe();
+            if (!checked.ok)
+                return checked;
+            return nativeFile.launch(checked.value.binary, [workspace], workspace);
+        },
+        cleanup: (staged) => cursorStore.cleanup(staged.path),
+    };
+};
+export { writeCursorSession };
+//# sourceMappingURL=write-cursor-session.js.map

package/dist/commands/takeover/_utils/write-cursor-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-cursor-session.js","sourceRoot":"","sources":["../../../../src/commands/takeover/_utils/write-cursor-session.ts"],"names":[],"mappings":"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"}

package/dist/commands/takeover/_utils/write-pi-session.d.ts

@@ -0,0 +1,52 @@
+import { type CliError } from "../../../_utils/cli-error.js";
+import { provenanceContext } from "./provenance-context.js";
+declare const writePiSession: (payload: {
+    readonly destinationSessionId: string;
+    readonly messages: readonly {
+        role: "user" | "assistant";
+        content: string;
+    }[];
+    readonly provenance: Parameters<typeof provenanceContext>[0];
+}, workspace: string) => {
+    probe: () => Promise<import("../../../_utils/result.js").Result<{
+        binary: string;
+        model: string;
+        version: string;
+        contextWindowTokens: number;
+        startupReserveTokens: number;
+        responseReserveTokens: number;
+    }, CliError>>;
+    stage: () => Promise<{
+        readonly ok: false;
+        readonly error: CliError;
+    } | {
+        readonly ok: true;
+        readonly value: {
+            recoveryCommand: string;
+            path: string;
+        };
+    }>;
+    parse: (staged: {
+        path: string;
+    }) => Promise<{
+        readonly ok: false;
+        readonly error: CliError;
+    } | {
+        readonly ok: true;
+        readonly value: {
+            role: "user" | "assistant";
+            content: string;
+        }[];
+    }>;
+    install: (staged: {
+        path: string;
+        recoveryCommand: string;
+    }) => Promise<import("../../../_utils/result.js").Result<{
+        recoveryCommand: string;
+    }, CliError>>;
+    launch: () => Promise<import("../../../_utils/result.js").Result<void, CliError>>;
+    cleanup: (staged: {
+        path: string;
+    }) => Promise<void>;
+};
+export { writePiSession };

package/dist/commands/takeover/_utils/write-pi-session.js

@@ -0,0 +1,173 @@
+import { randomBytes } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { causeOf, cliErr } from "../../../_utils/cli-error.js";
+import { parsePiTranscript } from "../../../_utils/parse-pi-transcript.js";
+import { err, fromPromise, ok } from "../../../_utils/result.js";
+import { agentPaths } from "./agent-paths.js";
+import { nativeFile } from "./native-file.js";
+import { probeAgent } from "./probe-agent.js";
+import { provenanceContext } from "./provenance-context.js";
+const readSettings = (path) => {
+    try {
+        const value = JSON.parse(readFileSync(path, "utf8"));
+        return value !== null && typeof value === "object" && !Array.isArray(value)
+            ? value
+            : {};
+    }
+    catch {
+        return {};
+    }
+};
+const piModel = (workspace) => {
+    const agentDirectory = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
+    const global = readSettings(join(agentDirectory, "settings.json"));
+    const project = readSettings(join(workspace, ".pi", "settings.json"));
+    const provider = typeof project.defaultProvider === "string"
+        ? project.defaultProvider
+        : typeof global.defaultProvider === "string"
+            ? global.defaultProvider
+            : "";
+    const model = typeof project.defaultModel === "string"
+        ? project.defaultModel
+        : typeof global.defaultModel === "string"
+            ? global.defaultModel
+            : "";
+    const normalized = `${provider}/${model}`;
+    const contextWindowTokens = /claude/i.test(model)
+        ? 200_000
+        : /gpt-5|gpt-4\.1|gpt-4o|gemini-(2\.5|3)/i.test(model)
+            ? 128_000
+            : 0;
+    const api = provider === "anthropic"
+        ? "anthropic-messages"
+        : provider === "openai"
+            ? "openai-responses"
+            : provider === "google"
+                ? "google-generative-ai"
+                : provider;
+    return { provider, model, normalized, contextWindowTokens, api };
+};
+const writePiSession = (payload, workspace) => {
+    const createdAt = new Date();
+    const targetPath = agentPaths.pi(workspace, payload.destinationSessionId, createdAt);
+    const model = piModel(workspace);
+    const probe = async () => probeAgent({
+        displayName: "Pi",
+        binName: "pi",
+        ...(process.env.GLEN_PI_BIN
+            ? { binaryOverride: process.env.GLEN_PI_BIN }
+            : {}),
+        versionPattern: /\d+\.\d+\.\d+/,
+        model: model.normalized,
+        contextWindowTokens: model.contextWindowTokens,
+        startupReserveTokens: 16_384,
+        responseReserveTokens: 32_768,
+    });
+    const stage = async () => {
+        const entryId = () => randomBytes(4).toString("hex");
+        const provenanceId = entryId();
+        const initial = [
+            {
+                type: "session",
+                version: 3,
+                id: payload.destinationSessionId,
+                timestamp: createdAt.toISOString(),
+                cwd: workspace,
+            },
+            {
+                type: "custom_message",
+                id: provenanceId,
+                parentId: null,
+                timestamp: new Date(createdAt.getTime() + 1).toISOString(),
+                customType: "glen-takeover",
+                content: provenanceContext(payload.provenance),
+                display: true,
+            },
+        ];
+        const lines = payload.messages.reduce((state, message, index) => {
+            const id = entryId();
+            const timestamp = createdAt.getTime() + index + 2;
+            const body = message.role === "user"
+                ? { role: "user", content: message.content, timestamp }
+                : {
+                    role: "assistant",
+                    content: [{ type: "text", text: message.content }],
+                    api: model.api,
+                    provider: model.provider,
+                    model: model.model,
+                    usage: {
+                        input: 0,
+                        output: 0,
+                        cacheRead: 0,
+                        cacheWrite: 0,
+                        totalTokens: 0,
+                        cost: {
+                            input: 0,
+                            output: 0,
+                            cacheRead: 0,
+                            cacheWrite: 0,
+                            total: 0,
+                        },
+                    },
+                    stopReason: "stop",
+                    timestamp,
+                };
+            return {
+                entries: [
+                    ...state.entries,
+                    {
+                        type: "message",
+                        id,
+                        parentId: state.parentId,
+                        timestamp: new Date(timestamp).toISOString(),
+                        message: body,
+                    },
+                ],
+                parentId: id,
+            };
+        }, { entries: initial, parentId: provenanceId }).entries;
+        const staged = await nativeFile.stage("glen-pi-takeover-", lines);
+        return staged.ok
+            ? ok({
+                ...staged.value,
+                recoveryCommand: `pi --session ${payload.destinationSessionId}`,
+            })
+            : staged;
+    };
+    const parse = async (staged) => {
+        const raw = await fromPromise(readFile(staged.path, "utf8"));
+        if (!raw.ok)
+            return err(cliErr({
+                what: "could not re-read the staged Pi session",
+                why: causeOf(raw.error),
+                path: staged.path,
+                remedy: "retry the takeover command",
+            }));
+        const parsed = parsePiTranscript(raw.value.split(/\r?\n/).filter(Boolean), payload.destinationSessionId);
+        if (!parsed)
+            return err(cliErr({
+                what: "Pi could not parse the staged transcript",
+                path: staged.path,
+                remedy: "update Glen and Pi, then retry",
+            }));
+        return ok(parsed.messages.map(({ role, text }) => ({ role, content: text })));
+    };
+    return {
+        probe,
+        stage,
+        parse,
+        install: (staged) => nativeFile.install(staged.path, targetPath, staged.recoveryCommand),
+        launch: async () => {
+            const checked = await probe();
+            if (!checked.ok)
+                return checked;
+            return nativeFile.launch(checked.value.binary, ["--session", payload.destinationSessionId], workspace);
+        },
+        cleanup: (staged) => nativeFile.cleanup(staged.path),
+    };
+};
+export { writePiSession };
+//# sourceMappingURL=write-pi-session.js.map

package/dist/commands/takeover/_utils/write-pi-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-pi-session.js","sourceRoot":"","sources":["../../../../src/commands/takeover/_utils/write-pi-session.ts"],"names":[],"mappings":"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"}

package/dist/commands/takeover/index.d.ts

@@ -0,0 +1,21 @@
+import { type CliError } from "../../_utils/cli-error.js";
+import { readCredentials } from "../../_utils/credentials.js";
+import { httpJson } from "../../_utils/http.js";
+import { type Result } from "../../_utils/result.js";
+import { readState } from "../../_utils/state.js";
+import { stagedSession } from "./_utils/staged-session.js";
+import { takeoverPayload } from "./takeover.schema.js";
+type Prepared = Extract<ReturnType<typeof takeoverPayload.parsePrepare>, {
+    ok: true;
+}>["value"];
+type AdapterResult = Awaited<ReturnType<typeof stagedSession.forTarget>>;
+type Dependencies = {
+    readonly readCredentials: typeof readCredentials;
+    readonly readState: typeof readState;
+    readonly httpJson: typeof httpJson;
+    readonly adapterFor: (target: Prepared["targetAgent"], payload: Prepared, workspace: string) => Promise<AdapterResult>;
+    readonly cwd: () => string;
+    readonly launchOutput: (message: string) => void;
+};
+declare const takeover: (code: string, overrides?: Partial<Dependencies>) => Promise<Result<void, CliError>>;
+export { takeover };

package/dist/commands/takeover/index.js

@@ -0,0 +1,201 @@
+import { cliErr } from "../../_utils/cli-error.js";
+import { config } from "../../_utils/config.js";
+import { readCredentials } from "../../_utils/credentials.js";
+import { buildGlenHeaders } from "../../_utils/glen-headers.js";
+import { httpJson, networkRemedy } from "../../_utils/http.js";
+import { err, ok } from "../../_utils/result.js";
+import { readState } from "../../_utils/state.js";
+import { handle426AndReexec, maybeSpawnBackgroundUpdate, } from "../../_utils/update.js";
+import { cliVersion } from "../../_utils/version.js";
+import { canonicalDigest } from "./_utils/canonical-digest.js";
+import { contextFit } from "./_utils/context-fit.js";
+import { stagedSession } from "./_utils/staged-session.js";
+import { takeoverPayload } from "./takeover.schema.js";
+const defaults = {
+    readCredentials,
+    readState,
+    httpJson,
+    adapterFor: (target, payload, workspace) => stagedSession.forTarget(target, payload, workspace),
+    cwd: () => process.cwd(),
+    launchOutput: (message) => process.stdout.write(message),
+};
+const post = async (dependencies, url, body, headers, action) => {
+    const response = await dependencies.httpJson(url, {
+        method: "POST",
+        headers: { "content-type": "application/json", ...headers },
+        body: JSON.stringify(body),
+        timeoutMs: config.takeoverTimeoutMs,
+    });
+    if (!response.ok)
+        return err(cliErr({
+            what: `${action} failed`,
+            why: response.error.detail,
+            remedy: networkRemedy(response.error),
+        }));
+    if (response.value.status === 426) {
+        handle426AndReexec(process.argv.slice(2));
+        return err(cliErr({
+            what: "Glen must be updated before this takeover",
+            remedy: "run `glen update`, then retry",
+        }));
+    }
+    if (response.value.status === 401 || response.value.status === 403) {
+        if (response.value.rawText.includes("no active organization"))
+            return err(cliErr({
+                what: "no active organization",
+                remedy: "run `glen org switch`, then retry",
+            }));
+        return err(cliErr({
+            what: "this takeover is not available to the connected user",
+            httpStatus: response.value.status,
+            ...(response.value.rawText
+                ? { why: response.value.rawText.slice(0, 200) }
+                : {}),
+            remedy: "confirm you are signed in as the recipient and ask the sender for a new takeover command",
+        }));
+    }
+    if (!response.value.isOk)
+        return err(cliErr({
+            what: `${action} failed (HTTP ${response.value.status})`,
+            httpStatus: response.value.status,
+            ...(response.value.rawText
+                ? { why: response.value.rawText.slice(0, 200) }
+                : {}),
+            remedy: "fix the reported problem and retry the same command; no transcript content was truncated",
+        }));
+    return ok(response.value.json);
+};
+const takeover = async (code, overrides = {}) => {
+    void maybeSpawnBackgroundUpdate();
+    if (code.trim() === "")
+        return err(cliErr({
+            what: "missing takeover code",
+            remedy: "paste the complete `glen takeover …` command you received",
+        }));
+    const dependencies = { ...defaults, ...overrides };
+    const credentials = await dependencies.readCredentials();
+    if (!credentials)
+        return err(cliErr({ what: "not connected", remedy: "run `glen login` first" }));
+    const state = await dependencies.readState();
+    const headers = buildGlenHeaders({
+        key: credentials.key,
+        state: state ? { ...state, mode: "on" } : null,
+        version: cliVersion,
+    });
+    const preparedResponse = await post(dependencies, config.prepareTakeoverUrl, { code }, headers, "takeover preparation");
+    if (!preparedResponse.ok)
+        return preparedResponse;
+    const parsed = takeoverPayload.parsePrepare(preparedResponse.value);
+    if (!parsed.ok)
+        return parsed;
+    const prepared = parsed.value;
+    if (canonicalDigest(prepared.messages) !== prepared.canonicalDigest)
+        return err(cliErr({
+            what: "the prepared transcript failed its integrity check",
+            remedy: "retry once, then ask the sender for a new takeover command; no session was created",
+        }));
+    const selected = await dependencies.adapterFor(prepared.targetAgent, prepared, dependencies.cwd());
+    if (!selected.ok)
+        return selected;
+    const adapter = selected.value;
+    const probe = await adapter.probe();
+    if (!probe.ok)
+        return probe;
+    if (prepared.completed && prepared.targetAgent === "codex-desktop") {
+        const settled = adapter.settleRecovery
+            ? await adapter.settleRecovery(prepared.destinationSessionId)
+            : ok(undefined);
+        const url = `codex://threads/${encodeURIComponent(prepared.destinationSessionId)}`;
+        const reopened = await adapter.launch({
+            destinationSessionId: prepared.destinationSessionId,
+            recoveryCommand: `open ${JSON.stringify(url)}`,
+        });
+        if (!reopened.ok)
+            return err(cliErr({
+                what: "the completed Codex Desktop takeover did not reopen",
+                why: reopened.error.why ?? reopened.error.what,
+                remedy: `continue it with \`open ${JSON.stringify(url)}\``,
+            }));
+        if (!settled.ok)
+            return settled;
+        dependencies.launchOutput("Takeover already complete — reopened the existing Codex Desktop task.\n");
+        return ok(undefined);
+    }
+    const fit = contextFit({ ...probe.value, messages: prepared.messages });
+    if (!fit.ok)
+        return fit;
+    const recovered = adapter.recover ? await adapter.recover() : ok(null);
+    if (!recovered.ok)
+        return recovered;
+    const installed = recovered.value
+        ? ok(recovered.value)
+        : await (async () => {
+            const staged = await adapter.stage();
+            if (!staged.ok)
+                return staged;
+            const stagedMessages = await adapter.parse(staged.value);
+            if (!stagedMessages.ok) {
+                await adapter.cleanup(staged.value);
+                return stagedMessages;
+            }
+            if (canonicalDigest(stagedMessages.value) !== prepared.canonicalDigest) {
+                await adapter.cleanup(staged.value);
+                return err(cliErr({
+                    what: "the staged native session did not round-trip exactly",
+                    path: staged.value.path,
+                    remedy: "update Glen and the target agent, then retry; the staged session was removed and nothing was installed",
+                }));
+            }
+            const next = await adapter.install(staged.value);
+            await adapter.cleanup(staged.value);
+            return next;
+        })();
+    if (!installed.ok)
+        return installed;
+    const completed = await post(dependencies, config.completeTakeoverUrl, {
+        takeoverId: prepared.takeoverId,
+        destinationSessionId: installed.value.destinationSessionId ?? prepared.destinationSessionId,
+        canonicalDigest: prepared.canonicalDigest,
+        cliVersion,
+        agentVersion: probe.value.version,
+        targetModel: probe.value.model,
+    }, headers, "takeover completion");
+    if (!completed.ok) {
+        const definitivelyRejected = completed.error.httpStatus !== undefined &&
+            completed.error.httpStatus >= 400 &&
+            completed.error.httpStatus < 500 &&
+            completed.error.httpStatus !== 426;
+        const rolledBack = definitivelyRejected && adapter.rollback
+            ? await adapter.rollback(installed.value)
+            : ok(null);
+        if (!rolledBack.ok)
+            return rolledBack;
+        const rejectedDesktopTaskArchived = definitivelyRejected && adapter.rollback !== undefined;
+        return err(cliErr({
+            what: completed.error.what,
+            ...(completed.error.httpStatus !== undefined
+                ? { httpStatus: completed.error.httpStatus }
+                : {}),
+            ...(completed.error.why ? { why: completed.error.why } : {}),
+            remedy: rejectedDesktopTaskArchived
+                ? "the rejected Desktop task was archived; retry the same takeover command to reopen the winning task"
+                : `the native session is saved for reuse; retry the same takeover command or continue with \`${installed.value.recoveryCommand}\``,
+        }));
+    }
+    const launched = await adapter.launch(installed.value);
+    if (!launched.ok)
+        return err(cliErr({
+            what: "the takeover session was created but the agent did not launch",
+            why: launched.error.why ?? launched.error.what,
+            remedy: `continue it with \`${installed.value.recoveryCommand}\``,
+        }));
+    const settled = adapter.settleRecovery
+        ? await adapter.settleRecovery(installed.value.destinationSessionId ?? prepared.destinationSessionId)
+        : ok(undefined);
+    if (!settled.ok)
+        return settled;
+    dependencies.launchOutput(`Takeover complete — continuing in a fresh ${prepared.targetAgent} session.\n`);
+    return ok(undefined);
+};
+export { takeover };
+//# sourceMappingURL=index.js.map

package/dist/commands/takeover/index.js.map

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