@companyhelm/cli 0.0.2

package/dist/service/thread_runtime.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureThreadRuntimeReady = ensureThreadRuntimeReady;
+const thread_lifecycle_js_1 = require("./thread_lifecycle.js");
+async function ensureThreadRuntimeReady(options) {
+    const containerService = options.containerService ?? new thread_lifecycle_js_1.ThreadContainerService();
+    if (typeof options.dindContainer === "string" && options.dindContainer.trim().length > 0) {
+        await containerService.ensureContainerRunning(options.dindContainer);
+    }
+    await containerService.ensureContainerRunning(options.runtimeContainer);
+    await containerService.ensureRuntimeContainerIdentity(options.runtimeContainer, options.user);
+    await containerService.ensureRuntimeContainerBashrc(options.runtimeContainer, options.user);
+    await containerService.ensureRuntimeContainerGitConfig(options.runtimeContainer, options.user, options.gitUserName, options.gitUserEmail);
+    await containerService.ensureRuntimeContainerTooling(options.runtimeContainer, options.user);
+}

package/dist/service/thread_turn_state.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadThreadMessageExecutionState = loadThreadMessageExecutionState;
+exports.updateThreadTurnState = updateThreadTurnState;
+const drizzle_orm_1 = require("drizzle-orm");
+const db_js_1 = require("../state/db.js");
+const schema_js_1 = require("../state/schema.js");
+async function loadThreadMessageExecutionState(stateDbPath, threadId) {
+    const { db, client } = await (0, db_js_1.initDb)(stateDbPath);
+    try {
+        return await db
+            .select({
+            id: schema_js_1.threads.id,
+            workspace: schema_js_1.threads.workspace,
+            sdkThreadId: schema_js_1.threads.sdkThreadId,
+            model: schema_js_1.threads.model,
+            reasoningLevel: schema_js_1.threads.reasoningLevel,
+            additionalModelInstructions: schema_js_1.threads.additionalModelInstructions,
+            currentSdkTurnId: schema_js_1.threads.currentSdkTurnId,
+            isCurrentTurnRunning: schema_js_1.threads.isCurrentTurnRunning,
+            runtimeContainer: schema_js_1.threads.runtimeContainer,
+            dindContainer: schema_js_1.threads.dindContainer,
+            homeDirectory: schema_js_1.threads.homeDirectory,
+            uid: schema_js_1.threads.uid,
+            gid: schema_js_1.threads.gid,
+        })
+            .from(schema_js_1.threads)
+            .where((0, drizzle_orm_1.eq)(schema_js_1.threads.id, threadId))
+            .get();
+    }
+    finally {
+        client.close();
+    }
+}
+async function updateThreadTurnState(stateDbPath, threadId, update) {
+    const { db, client } = await (0, db_js_1.initDb)(stateDbPath);
+    try {
+        await db
+            .update(schema_js_1.threads)
+            .set(update)
+            .where((0, drizzle_orm_1.eq)(schema_js_1.threads.id, threadId));
+    }
+    finally {
+        client.close();
+    }
+}

package/dist/service/thread_user_message_request_store.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enqueuePendingUserMessageRequestIdForTurn = enqueuePendingUserMessageRequestIdForTurn;
+exports.removePendingUserMessageRequestIdForTurn = removePendingUserMessageRequestIdForTurn;
+exports.assignPendingUserMessageRequestIdForItem = assignPendingUserMessageRequestIdForItem;
+exports.consumePendingUserMessageRequestIdForItem = consumePendingUserMessageRequestIdForItem;
+exports.clearPendingUserMessageRequestIdsForTurn = clearPendingUserMessageRequestIdsForTurn;
+const drizzle_orm_1 = require("drizzle-orm");
+const db_js_1 = require("../state/db.js");
+const schema_js_1 = require("../state/schema.js");
+async function enqueuePendingUserMessageRequestIdForTurn(stateDbPath, threadId, sdkTurnId, requestId) {
+    if (!requestId) {
+        return;
+    }
+    const { db, client } = await (0, db_js_1.initDb)(stateDbPath);
+    try {
+        await db.insert(schema_js_1.threadUserMessageRequestStore).values({
+            threadId,
+            sdkTurnId,
+            requestId,
+            sdkItemId: null,
+        });
+    }
+    finally {
+        client.close();
+    }
+}
+async function removePendingUserMessageRequestIdForTurn(stateDbPath, threadId, sdkTurnId, requestId) {
+    if (!requestId) {
+        return;
+    }
+    const { db, client } = await (0, db_js_1.initDb)(stateDbPath);
+    try {
+        await db
+            .delete(schema_js_1.threadUserMessageRequestStore)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.threadId, threadId), (0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.sdkTurnId, sdkTurnId), (0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.requestId, requestId)));
+    }
+    finally {
+        client.close();
+    }
+}
+async function assignPendingUserMessageRequestIdForItem(stateDbPath, threadId, sdkTurnId, sdkItemId) {
+    const { db, client } = await (0, db_js_1.initDb)(stateDbPath);
+    try {
+        const [existingByItem] = await db
+            .select({
+            requestId: schema_js_1.threadUserMessageRequestStore.requestId,
+        })
+            .from(schema_js_1.threadUserMessageRequestStore)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.threadId, threadId), (0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.sdkTurnId, sdkTurnId), (0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.sdkItemId, sdkItemId)))
+            .limit(1);
+        if (existingByItem) {
+            return existingByItem.requestId;
+        }
+        const [nextPending] = await db
+            .select({
+            id: schema_js_1.threadUserMessageRequestStore.id,
+            requestId: schema_js_1.threadUserMessageRequestStore.requestId,
+        })
+            .from(schema_js_1.threadUserMessageRequestStore)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.threadId, threadId), (0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.sdkTurnId, sdkTurnId), (0, drizzle_orm_1.isNull)(schema_js_1.threadUserMessageRequestStore.sdkItemId)))
+            .orderBy((0, drizzle_orm_1.asc)(schema_js_1.threadUserMessageRequestStore.id))
+            .limit(1);
+        if (!nextPending) {
+            return undefined;
+        }
+        const [assigned] = await db
+            .update(schema_js_1.threadUserMessageRequestStore)
+            .set({
+            sdkItemId,
+        })
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.id, nextPending.id), (0, drizzle_orm_1.isNull)(schema_js_1.threadUserMessageRequestStore.sdkItemId)))
+            .returning({
+            requestId: schema_js_1.threadUserMessageRequestStore.requestId,
+        });
+        if (assigned) {
+            return assigned.requestId;
+        }
+        const [racedAssignment] = await db
+            .select({
+            requestId: schema_js_1.threadUserMessageRequestStore.requestId,
+        })
+            .from(schema_js_1.threadUserMessageRequestStore)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.threadId, threadId), (0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.sdkTurnId, sdkTurnId), (0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.sdkItemId, sdkItemId)))
+            .limit(1);
+        return racedAssignment?.requestId;
+    }
+    finally {
+        client.close();
+    }
+}
+async function consumePendingUserMessageRequestIdForItem(stateDbPath, threadId, sdkTurnId, sdkItemId) {
+    const { db, client } = await (0, db_js_1.initDb)(stateDbPath);
+    try {
+        const [existingByItem] = await db
+            .select({
+            id: schema_js_1.threadUserMessageRequestStore.id,
+            requestId: schema_js_1.threadUserMessageRequestStore.requestId,
+        })
+            .from(schema_js_1.threadUserMessageRequestStore)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.threadId, threadId), (0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.sdkTurnId, sdkTurnId), (0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.sdkItemId, sdkItemId)))
+            .limit(1);
+        if (existingByItem) {
+            await db.delete(schema_js_1.threadUserMessageRequestStore).where((0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.id, existingByItem.id));
+            return existingByItem.requestId;
+        }
+        const [nextPending] = await db
+            .select({
+            id: schema_js_1.threadUserMessageRequestStore.id,
+            requestId: schema_js_1.threadUserMessageRequestStore.requestId,
+        })
+            .from(schema_js_1.threadUserMessageRequestStore)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.threadId, threadId), (0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.sdkTurnId, sdkTurnId), (0, drizzle_orm_1.isNull)(schema_js_1.threadUserMessageRequestStore.sdkItemId)))
+            .orderBy((0, drizzle_orm_1.asc)(schema_js_1.threadUserMessageRequestStore.id))
+            .limit(1);
+        if (!nextPending) {
+            return undefined;
+        }
+        await db.delete(schema_js_1.threadUserMessageRequestStore).where((0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.id, nextPending.id));
+        return nextPending.requestId;
+    }
+    finally {
+        client.close();
+    }
+}
+async function clearPendingUserMessageRequestIdsForTurn(stateDbPath, threadId, sdkTurnId) {
+    const { db, client } = await (0, db_js_1.initDb)(stateDbPath);
+    try {
+        await db
+            .delete(schema_js_1.threadUserMessageRequestStore)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.threadId, threadId), (0, drizzle_orm_1.eq)(schema_js_1.threadUserMessageRequestStore.sdkTurnId, sdkTurnId)));
+    }
+    finally {
+        client.close();
+    }
+}

package/dist/service/workspace_agents.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderRuntimeAgentsMd = renderRuntimeAgentsMd;
+exports.ensureWorkspaceAgentsMd = ensureWorkspaceAgentsMd;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const RUNTIME_AGENTS_TEMPLATE_PATH = "templates/runtime_agents.md.j2";
+const DEFAULT_HOME_DIRECTORY = "/home/agent";
+function renderJinjaTemplate(template, context) {
+    return template.replace(/{{\s*([a-zA-Z0-9_]+)\s*}}/g, (_match, key) => {
+        const value = context[key];
+        if (value === undefined) {
+            throw new Error(`Missing template value for key '${key}'`);
+        }
+        return value;
+    });
+}
+function resolveTemplatePath() {
+    const distRelativePath = (0, node_path_1.join)(__dirname, "..", RUNTIME_AGENTS_TEMPLATE_PATH);
+    if ((0, node_fs_1.existsSync)(distRelativePath)) {
+        return distRelativePath;
+    }
+    const sourceRelativePath = (0, node_path_1.join)(__dirname, "..", "..", "src", RUNTIME_AGENTS_TEMPLATE_PATH);
+    if ((0, node_fs_1.existsSync)(sourceRelativePath)) {
+        return sourceRelativePath;
+    }
+    throw new Error(`Runtime AGENTS template was not found at ${distRelativePath} or ${sourceRelativePath}`);
+}
+function extractTopLevelSections(markdown) {
+    const sections = [];
+    const headingRegex = /^## .+$/gm;
+    const matches = [...markdown.matchAll(headingRegex)];
+    for (let index = 0; index < matches.length; index += 1) {
+        const match = matches[index];
+        const marker = match[0].trim();
+        const start = match.index ?? 0;
+        const end = index + 1 < matches.length ? (matches[index + 1].index ?? markdown.length) : markdown.length;
+        const content = markdown.slice(start, end).trimEnd();
+        sections.push({ marker, content });
+    }
+    return sections;
+}
+function renderRuntimeAgentsMd(homeDirectory = DEFAULT_HOME_DIRECTORY) {
+    const template = (0, node_fs_1.readFileSync)(resolveTemplatePath(), "utf8");
+    return renderJinjaTemplate(template, {
+        home_directory: homeDirectory,
+    }).trim() + "\n";
+}
+function ensureWorkspaceAgentsMd(workspaceDirectory, homeDirectory = DEFAULT_HOME_DIRECTORY) {
+    (0, node_fs_1.mkdirSync)(workspaceDirectory, { recursive: true });
+    const agentsPath = (0, node_path_1.join)(workspaceDirectory, "AGENTS.md");
+    let existing = "";
+    try {
+        existing = (0, node_fs_1.readFileSync)(agentsPath, "utf8");
+    }
+    catch {
+        existing = "";
+    }
+    let rendered = "";
+    try {
+        rendered = renderRuntimeAgentsMd(homeDirectory);
+    }
+    catch {
+        return;
+    }
+    const templateSections = extractTopLevelSections(rendered);
+    const pendingSections = templateSections
+        .filter((section) => !existing.includes(section.marker))
+        .map((section) => section.content);
+    if (pendingSections.length === 0) {
+        return;
+    }
+    const updated = existing.trim()
+        ? `${existing.trimEnd()}\n\n${pendingSections.join("\n\n")}\n`
+        : rendered;
+    try {
+        (0, node_fs_1.writeFileSync)(agentsPath, updated, "utf8");
+    }
+    catch {
+        // Best-effort workspace instruction file.
+    }
+}

package/dist/startup.js

@@ -0,0 +1,166 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startup = startup;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_child_process_1 = require("node:child_process");
+const p = __importStar(require("@clack/prompts"));
+const figlet_1 = __importDefault(require("figlet"));
+const config_js_1 = require("./config.js");
+const db_js_1 = require("./state/db.js");
+const schema_js_1 = require("./state/schema.js");
+const host_js_1 = require("./service/host.js");
+const path_js_1 = require("./utils/path.js");
+function banner() {
+    console.log();
+    console.log(figlet_1.default.textSync("CompanyHelm", { font: "Small" }));
+    console.log();
+}
+async function dedicatedAuth(cfg, db) {
+    const port = cfg.codex.codex_auth_port;
+    const socatPort = port + 1; // socat listens on a separate port to avoid conflicting with codex
+    const containerName = `companyhelm-codex-auth-${Date.now()}`;
+    p.log.info("Starting Codex login inside a container...");
+    p.log.info("A browser URL will appear -- open it to complete authentication.");
+    const configDir = (0, path_js_1.expandHome)(cfg.config_directory);
+    if (!(0, node_fs_1.existsSync)(configDir)) {
+        (0, node_fs_1.mkdirSync)(configDir, { recursive: true });
+    }
+    const destPath = (0, node_path_1.join)(configDir, cfg.codex.codex_auth_file_path);
+    // Start codex interactively (full TTY passthrough so user can interact)
+    // Host:port → container:socatPort (socat) → container:127.0.0.1:port (codex)
+    const child = (0, node_child_process_1.spawn)("docker", [
+        "run",
+        "-it",
+        "--name", containerName,
+        "-p", `${port}:${socatPort}`,
+        "--entrypoint", "bash",
+        cfg.runtime_image,
+        "-c",
+        `source "$NVM_DIR/nvm.sh"; socat TCP-LISTEN:${socatPort},fork,bind=0.0.0.0,reuseaddr TCP:127.0.0.1:${port} 2>/dev/null & codex`,
+    ], { stdio: "inherit" });
+    // Poll for auth file inside the container — once it exists, login succeeded
+    let authCopied = false;
+    await new Promise((resolve, reject) => {
+        const poll = setInterval(() => {
+            // Use sh -c so ~ is expanded by the container's shell
+            const check = (0, node_child_process_1.spawnSync)("docker", ["exec", containerName, "sh", "-c", `test -f ${cfg.codex.codex_auth_path}`], { stdio: "ignore" });
+            if (check.status === 0) {
+                clearInterval(poll);
+                // Resolve ~ inside the container to get the absolute path for docker cp
+                const resolveResult = (0, node_child_process_1.spawnSync)("docker", ["exec", containerName, "sh", "-c", `echo ${cfg.codex.codex_auth_path}`], { encoding: "utf-8" });
+                const containerAuthAbsPath = resolveResult.stdout.trim();
+                // Copy auth file from container to host
+                const cpResult = (0, node_child_process_1.spawnSync)("docker", ["cp", `${containerName}:${containerAuthAbsPath}`, destPath], { stdio: "ignore" });
+                if (cpResult.status !== 0) {
+                    (0, node_child_process_1.spawnSync)("docker", ["rm", "-f", containerName], { stdio: "ignore" });
+                    reject(new Error("Failed to extract auth file from container."));
+                    return;
+                }
+                // Mark success before killing container to avoid race with exit handler
+                authCopied = true;
+                (0, node_child_process_1.spawnSync)("docker", ["rm", "-f", containerName], { stdio: "ignore" });
+                resolve();
+            }
+        }, 1000);
+        // If codex exits before auth file appeared, user cancelled
+        child.on("exit", () => {
+            clearInterval(poll);
+            if (!authCopied) {
+                (0, node_child_process_1.spawnSync)("docker", ["rm", "-f", containerName], { stdio: "ignore" });
+                reject(new Error("Codex login failed or was cancelled."));
+            }
+        });
+    });
+    await db.insert(schema_js_1.agentSdks).values({ name: "codex", authentication: "dedicated" });
+    p.log.success(`Codex auth saved to ${destPath}`);
+}
+async function startup() {
+    banner();
+    const cfg = config_js_1.config.parse({});
+    const s = p.spinner();
+    s.start("Initializing state database");
+    const { db } = await (0, db_js_1.initDb)(cfg.state_db_path);
+    s.stop("State database ready.");
+    // Check if any agent SDK is configured
+    const sdks = await db.select().from(schema_js_1.agentSdks).all();
+    if (sdks.length > 0) {
+        p.log.success(`Agent SDK configured: ${sdks.map((s) => s.name).join(", ")}`);
+        return;
+    }
+    // No SDK configured -- offer auth options
+    p.intro("No agent SDK configured. Let's set up Codex authentication.");
+    const hostInfo = (0, host_js_1.getHostInfo)(cfg.codex.codex_auth_path);
+    const options = [
+        {
+            value: "dedicated",
+            label: "Dedicated",
+            hint: "recommended -- runs Codex login inside a container",
+        },
+    ];
+    if (hostInfo.codexAuthExists) {
+        options.push({
+            value: "host",
+            label: "Host",
+            hint: `reuse existing credentials from ${cfg.codex.codex_auth_path}`,
+        });
+    }
+    const authMode = await p.select({
+        message: "How would you like to authenticate Codex?",
+        options,
+    });
+    if (p.isCancel(authMode)) {
+        p.cancel("Setup cancelled.");
+        process.exit(0);
+    }
+    if (authMode === "host") {
+        await db.insert(schema_js_1.agentSdks).values({ name: "codex", authentication: "host" });
+        p.outro("Codex SDK configured with host authentication.");
+        return;
+    }
+    // Dedicated auth flow
+    try {
+        await dedicatedAuth(cfg, db);
+        p.outro("Codex login successful!");
+    }
+    catch (err) {
+        p.cancel(err.message ?? "Codex login failed or was cancelled.");
+        process.exit(1);
+    }
+}

package/dist/state/db.js

@@ -0,0 +1,63 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initDb = initDb;
+const client_1 = require("@libsql/client");
+const libsql_1 = require("drizzle-orm/libsql");
+const migrator_1 = require("drizzle-orm/libsql/migrator");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_path_2 = require("node:path");
+const schema = __importStar(require("./schema.js"));
+const path_js_1 = require("../utils/path.js");
+async function reconcileLegacyThreadsSchema(client) {
+    const pragmaResult = await client.execute("PRAGMA table_info('threads')");
+    const columnNames = new Set(pragmaResult.rows.map((row) => String(row.name ?? "")));
+    if (columnNames.has("sdk_id") && !columnNames.has("sdk_thread_id")) {
+        await client.execute("ALTER TABLE threads RENAME COLUMN sdk_id TO sdk_thread_id");
+    }
+}
+async function initDb(stateDbPath) {
+    const resolved = (0, path_js_1.expandHome)(stateDbPath);
+    const dir = (0, node_path_1.dirname)(resolved);
+    if (!(0, node_fs_1.existsSync)(dir)) {
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    const client = (0, client_1.createClient)({ url: `file:${resolved}` });
+    const db = (0, libsql_1.drizzle)(client, { schema });
+    await (0, migrator_1.migrate)(db, { migrationsFolder: (0, node_path_2.join)(__dirname, "..", "..", "drizzle") });
+    await reconcileLegacyThreadsSchema(client);
+    return { db, client };
+}

package/dist/state/schema.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.threadUserMessageRequestStore = exports.threads = exports.llmModels = exports.agentSdks = void 0;
+const sqlite_core_1 = require("drizzle-orm/sqlite-core");
+// ── agent_sdks ──────────────────────────────────────────────────────────────
+exports.agentSdks = (0, sqlite_core_1.sqliteTable)("agent_sdks", {
+    name: (0, sqlite_core_1.text)("name").primaryKey(),
+    authentication: (0, sqlite_core_1.text)("authentication", {
+        enum: ["unauthenticated", "host", "dedicated", "api-key"],
+    }).notNull(),
+});
+// ── llm_models ──────────────────────────────────────────────────────────────
+exports.llmModels = (0, sqlite_core_1.sqliteTable)("llm_models", {
+    name: (0, sqlite_core_1.text)("name").primaryKey(),
+    sdkName: (0, sqlite_core_1.text)("sdk_name")
+        .notNull()
+        .references(() => exports.agentSdks.name, { onDelete: "cascade" }),
+    reasoningLevels: (0, sqlite_core_1.text)("reasoning_levels", { mode: "json" })
+        .$type(),
+});
+// -- threads ──────────────────────────────────────────────────────────────────
+exports.threads = (0, sqlite_core_1.sqliteTable)("threads", {
+    id: (0, sqlite_core_1.text)("id").primaryKey(),
+    sdkThreadId: (0, sqlite_core_1.text)("sdk_thread_id"),
+    cliSecret: (0, sqlite_core_1.text)("cli_secret"),
+    model: (0, sqlite_core_1.text)("model").notNull(),
+    reasoningLevel: (0, sqlite_core_1.text)("reasoning_level").notNull(),
+    additionalModelInstructions: (0, sqlite_core_1.text)("additional_model_instructions"),
+    status: (0, sqlite_core_1.text)("status", { enum: ["pending", "ready", "deleting"] }).notNull(),
+    currentSdkTurnId: (0, sqlite_core_1.text)("current_sdk_turn_id"),
+    isCurrentTurnRunning: (0, sqlite_core_1.integer)("is_current_turn_running", { mode: "boolean" }).notNull(),
+    workspace: (0, sqlite_core_1.text)("workspace").notNull(),
+    runtimeContainer: (0, sqlite_core_1.text)("runtime_container").notNull(),
+    dindContainer: (0, sqlite_core_1.text)("dind_container"),
+    // home directory within the container
+    homeDirectory: (0, sqlite_core_1.text)("home_directory").notNull(),
+    // uid of the user within the container
+    uid: (0, sqlite_core_1.integer)("uid").notNull(),
+    // gid of the user within the container
+    gid: (0, sqlite_core_1.integer)("gid").notNull(),
+});
+// -- thread_user_message_request_store ----------------------------------------
+exports.threadUserMessageRequestStore = (0, sqlite_core_1.sqliteTable)("thread_user_message_request_store", {
+    id: (0, sqlite_core_1.integer)("id").primaryKey({ autoIncrement: true }),
+    threadId: (0, sqlite_core_1.text)("thread_id")
+        .notNull()
+        .references(() => exports.threads.id, { onDelete: "cascade" }),
+    sdkTurnId: (0, sqlite_core_1.text)("sdk_turn_id").notNull(),
+    requestId: (0, sqlite_core_1.text)("request_id").notNull(),
+    sdkItemId: (0, sqlite_core_1.text)("sdk_item_id"),
+});