opencandle 0.11.0 → 0.12.0

package/src/cli-main.ts

@@ -1,510 +0,0 @@
-import { spawn } from "node:child_process";
-import { randomUUID } from "node:crypto";
-import { createRequire } from "node:module";
-import { dirname, resolve } from "node:path";
-import { createInterface } from "node:readline/promises";
-import { fileURLToPath } from "node:url";
-import {
-  AuthStorage,
-  createAgentSessionRuntime,
-  createAgentSessionServices,
-  DefaultPackageManager,
-  getAgentDir,
-  InteractiveMode,
-  initTheme,
-  ModelRegistry,
-  SessionManager,
-  SettingsManager,
-} from "@earendil-works/pi-coding-agent";
-import { loadEnv } from "./config.js";
-import { handleDoctorCommand } from "./doctor/cli-command.js";
-import { createOpenCandleSession } from "./pi/session.js";
-import { continueOpenCandleSession } from "./pi/session-storage.js";
-import {
-  acquireSessionWriterLock,
-  migrateWriterLockScope,
-  refreshSessionWriterLock,
-  releaseSessionWriterLock,
-  type WriterLock,
-  writerLockScopeForSession,
-} from "./pi/session-writer-lock.js";
-import { startTuiSessionCoordinatorServer } from "./pi/tui-session-coordinator.js";
-
-const require = createRequire(import.meta.url);
-const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-
-async function handlePackageCommand(
-  args: string[],
-  cwd: string,
-  agentDir: string,
-): Promise<boolean> {
-  const [command, ...rest] = args;
-  if (!command || !["install", "remove", "uninstall", "list", "update"].includes(command)) {
-    return false;
-  }
-
-  const settingsManager = SettingsManager.create(cwd, agentDir);
-  const packageManager = new DefaultPackageManager({
-    cwd,
-    agentDir,
-    settingsManager,
-  });
-  packageManager.setProgressCallback((event) => {
-    if (event.type === "start" || event.type === "progress") {
-      process.stdout.write(`${event.message}\n`);
-    }
-  });
-
-  const source = rest.find((a) => !a.startsWith("-"));
-  const local = rest.includes("-l") || rest.includes("--local");
-
-  switch (command === "uninstall" ? "remove" : command) {
-    case "install": {
-      if (!source) {
-        console.error("Usage: opencandle install <source> [-l]");
-        process.exitCode = 1;
-        return true;
-      }
-      await packageManager.install(source, { local });
-      packageManager.addSourceToSettings(source, { local });
-      console.log(`Installed ${source}`);
-      return true;
-    }
-    case "remove": {
-      if (!source) {
-        console.error("Usage: opencandle remove <source> [-l]");
-        process.exitCode = 1;
-        return true;
-      }
-      await packageManager.remove(source, { local });
-      const removed = packageManager.removeSourceFromSettings(source, {
-        local,
-      });
-      if (!removed) {
-        console.error(`No matching package found for ${source}`);
-        process.exitCode = 1;
-      } else {
-        console.log(`Removed ${source}`);
-      }
-      return true;
-    }
-    case "list": {
-      const globalPkgs = settingsManager.getGlobalSettings().packages ?? [];
-      const projectPkgs = settingsManager.getProjectSettings().packages ?? [];
-      if (globalPkgs.length === 0 && projectPkgs.length === 0) {
-        console.log("No packages installed.");
-        return true;
-      }
-      if (globalPkgs.length > 0) {
-        console.log("User packages:");
-        for (const pkg of globalPkgs) {
-          const s = typeof pkg === "string" ? pkg : pkg.source;
-          const path = packageManager.getInstalledPath(s, "user");
-          console.log(`  ${s}${path ? `\n    ${path}` : ""}`);
-        }
-      }
-      if (projectPkgs.length > 0) {
-        console.log("Project packages:");
-        for (const pkg of projectPkgs) {
-          const s = typeof pkg === "string" ? pkg : pkg.source;
-          const path = packageManager.getInstalledPath(s, "project");
-          console.log(`  ${s}${path ? `\n    ${path}` : ""}`);
-        }
-      }
-      return true;
-    }
-    case "update": {
-      await packageManager.update(source);
-      console.log(source ? `Updated ${source}` : "All packages updated.");
-      return true;
-    }
-  }
-  return false;
-}
-
-async function handleGuiCommand(args: string[], cwd: string): Promise<boolean> {
-  if (args[0] !== "gui") return false;
-
-  const tsxCli = require.resolve("tsx/cli");
-  const serverPath = resolve(packageRoot, "gui/server/server.ts");
-  const child = spawn(process.execPath, [tsxCli, serverPath, ...args.slice(1)], {
-    cwd,
-    env: process.env,
-    stdio: "inherit",
-  });
-
-  const exitCode = await new Promise<number>((resolveExit) => {
-    child.on("close", (code, signal) => {
-      if (signal) {
-        resolveExit(1);
-      } else {
-        resolveExit(code ?? 0);
-      }
-    });
-  });
-  process.exitCode = exitCode;
-  return true;
-}
-
-async function handleMonitorCommand(args: string[], cwd: string): Promise<boolean> {
-  if (args[0] !== "monitor") return false;
-
-  const tsxCli = require.resolve("tsx/cli");
-  const monitorPath = resolve(packageRoot, "src/monitor.ts");
-  const child = spawn(process.execPath, [tsxCli, monitorPath, ...args.slice(1)], {
-    cwd,
-    env: process.env,
-    stdio: "inherit",
-  });
-
-  const exitCode = await new Promise<number>((resolveExit) => {
-    child.on("close", (code, signal) => {
-      if (signal) {
-        resolveExit(1);
-      } else {
-        resolveExit(code ?? 0);
-      }
-    });
-  });
-  process.exitCode = exitCode;
-  return true;
-}
-
-async function main(): Promise<void> {
-  const rawArgs = process.argv.slice(2);
-  const cwd = process.cwd();
-  const agentDir = getAgentDir();
-
-  loadEnv();
-
-  if (await handleGuiCommand(rawArgs, cwd)) {
-    return;
-  }
-
-  if (await handleMonitorCommand(rawArgs, cwd)) {
-    return;
-  }
-
-  if (await handleDoctorCommand(rawArgs, cwd, agentDir)) {
-    return;
-  }
-
-  if (await handlePackageCommand(rawArgs, cwd, agentDir)) {
-    return;
-  }
-
-  // Default: start the OpenCandle interactive agent
-  const settingsManager = SettingsManager.create(cwd, agentDir);
-  const authStorage = AuthStorage.create();
-  const modelRegistry = ModelRegistry.create(authStorage);
-  const shouldSuppressFallbackMessage = modelRegistry.getAvailable().length === 0;
-
-  initTheme(settingsManager.getTheme(), true);
-
-  const sessionManager = continueOpenCandleSession(cwd);
-  let activeSessionManager = sessionManager;
-  const sessionWriterLockScope = writerLockScopeForSession(sessionManager);
-  let runtime: Awaited<ReturnType<typeof createAgentSessionRuntime>> | undefined;
-  const tuiCoordinator = await startTuiSessionCoordinatorServer({
-    getSession: () => {
-      if (!runtime) throw new Error("OpenCandle is still starting this session.");
-      return runtime.session;
-    },
-    getSessionManager: () => activeSessionManager,
-    getModelUnavailableMessage: () => {
-      if (!runtime) return "OpenCandle is still starting this session.";
-      const session = runtime.session;
-      const model = session.model;
-      if (!model) {
-        return "Connect an AI model before chat can run. Paste a Google Gemini, OpenAI, or Anthropic API key in the setup panel.";
-      }
-      if (!session.modelRegistry.hasConfiguredAuth(model)) {
-        return "Connect an AI model before chat can run. Paste a Google Gemini, OpenAI, or Anthropic API key in the setup panel.";
-      }
-      return null;
-    },
-    syncWriterLockScope: () => syncActiveSessionWriterLockScope(),
-  });
-  const sessionWriterLock = await acquireSessionWriterLock(sessionWriterLockScope, "tui", {
-    coordinatorEndpoint: tuiCoordinator.endpoint,
-    coordinatorSecret: tuiCoordinator.secret,
-  });
-  if (sessionWriterLock.role !== "writer") {
-    await tuiCoordinator.close();
-    if (await runFollowerTuiProxy(sessionWriterLock.lock, sessionManager, cwd)) return;
-    console.error("OpenCandle is syncing this session in another window. Try again shortly.");
-    process.exitCode = 1;
-    return;
-  }
-  let activeSessionWriterLockScope = sessionWriterLockScope;
-  let activeSessionWriterLockLost = false;
-  function syncActiveSessionWriterLockScope(): void {
-    if (activeSessionWriterLockLost) throw new Error("OpenCandle is reconnecting to this session.");
-    const nextScope = writerLockScopeForSession(activeSessionManager);
-    if (nextScope === activeSessionWriterLockScope) return;
-    if (migrateWriterLockScope(activeSessionWriterLockScope, nextScope)) {
-      activeSessionWriterLockScope = nextScope;
-    } else {
-      activeSessionWriterLockLost = true;
-      throw new Error("OpenCandle is reconnecting to this session.");
-    }
-  }
-  const writerLockHeartbeat = setInterval(() => {
-    try {
-      syncActiveSessionWriterLockScope();
-      refreshSessionWriterLock(activeSessionWriterLockScope);
-    } catch {
-      clearInterval(writerLockHeartbeat);
-    }
-  }, 5000);
-
-  try {
-    runtime = await createAgentSessionRuntime(
-      async (opts) => {
-        const services = await createAgentSessionServices({
-          cwd: opts.cwd,
-          agentDir: opts.agentDir,
-          authStorage,
-          settingsManager,
-          modelRegistry,
-        });
-        const result = await createOpenCandleSession({
-          cwd: opts.cwd,
-          agentDir: opts.agentDir,
-          settingsManager,
-          authStorage,
-          modelRegistry,
-          sessionManager: opts.sessionManager,
-          bindExtensions: false,
-        });
-        return {
-          ...result,
-          services,
-          diagnostics: services.diagnostics,
-        };
-      },
-      { cwd, agentDir, sessionManager },
-    );
-    syncActiveSessionWriterLockScope();
-    runtime.setRebindSession(async (nextSession) => {
-      const nextSessionWriterLockScope = writerLockScopeForSession(nextSession.sessionManager);
-      if (nextSessionWriterLockScope === activeSessionWriterLockScope) {
-        activeSessionManager = nextSession.sessionManager;
-        syncActiveSessionWriterLockScope();
-        return;
-      }
-      const nextSessionWriterLock = await acquireSessionWriterLock(
-        nextSessionWriterLockScope,
-        "tui",
-        {
-          coordinatorEndpoint: tuiCoordinator.endpoint,
-          coordinatorSecret: tuiCoordinator.secret,
-        },
-      );
-      if (nextSessionWriterLock.role !== "writer") {
-        throw new Error("OpenCandle is syncing this session in another window. Try again shortly.");
-      }
-      releaseSessionWriterLock(activeSessionWriterLockScope);
-      activeSessionWriterLockScope = nextSessionWriterLockScope;
-      activeSessionManager = nextSession.sessionManager;
-    });
-    const interactiveMode = new InteractiveMode(runtime, {
-      modelFallbackMessage: shouldSuppressFallbackMessage
-        ? undefined
-        : runtime.modelFallbackMessage,
-    });
-    await interactiveMode.run();
-  } finally {
-    clearInterval(writerLockHeartbeat);
-    releaseSessionWriterLock(activeSessionWriterLockScope);
-    await tuiCoordinator.close();
-    await runtime?.dispose();
-  }
-}
-
-async function runFollowerTuiProxy(
-  lock: WriterLock,
-  sessionManager: ReturnType<typeof continueOpenCandleSession>,
-  cwd: string,
-): Promise<boolean> {
-  if (!lock.coordinatorEndpoint || !lock.coordinatorSecret) return false;
-  if (!process.stdin.isTTY) return false;
-
-  const input = createInterface({ input: process.stdin, output: process.stdout });
-  const follower = startFollowerTranscriptPrinter(sessionManager, cwd);
-  try {
-    console.log("Connected to the active OpenCandle session. Type /exit to close.");
-    while (true) {
-      const prompt = (await input.question("> ")).trim();
-      if (!prompt) continue;
-      if (prompt === "/exit" || prompt === "/quit") break;
-      await forwardTuiPrompt(lock, sessionManager.getSessionId(), prompt);
-      follower.markSeen();
-    }
-  } finally {
-    follower.stop();
-    input.close();
-  }
-  return true;
-}
-
-function startFollowerTranscriptPrinter(
-  sessionManager: ReturnType<typeof continueOpenCandleSession>,
-  cwd: string,
-): { stop: () => void; markSeen: () => void } {
-  const sessionFile = sessionManager.getSessionFile();
-  if (!sessionFile) return { stop: () => {}, markSeen: () => {} };
-  const seenEntryIds = new Set(
-    sessionManager
-      .getEntries()
-      .map((entry) => entryId(entry))
-      .filter((id): id is string => Boolean(id)),
-  );
-  const openFreshSession = () =>
-    SessionManager.open(sessionFile, sessionManager.getSessionDir(), cwd);
-  const markSeen = () => {
-    try {
-      for (const entry of openFreshSession().getEntries()) {
-        const id = entryId(entry);
-        if (id) seenEntryIds.add(id);
-      }
-    } catch {
-      // The owner may be rotating the session file; the next poll will catch up.
-    }
-  };
-  let polling = false;
-  const poll = () => {
-    if (polling) return;
-    polling = true;
-    try {
-      for (const entry of openFreshSession().getEntries()) {
-        const id = entryId(entry);
-        if (!id || seenEntryIds.has(id)) continue;
-        seenEntryIds.add(id);
-        const text = followerEntryText(entry);
-        if (text) process.stdout.write(`\n${text}\n`);
-      }
-    } catch {
-      // The owner may be rotating the session file; the next poll will catch up.
-    } finally {
-      polling = false;
-    }
-  };
-  const interval = setInterval(poll, 1000);
-  return { stop: () => clearInterval(interval), markSeen };
-}
-
-function entryId(entry: unknown): string | null {
-  const record = asRecord(entry);
-  return typeof record.id === "string" ? record.id : null;
-}
-
-function followerEntryText(entry: unknown): string {
-  const record = asRecord(entry);
-  if (record.type === "message") {
-    const message = asRecord(record.message);
-    const role = typeof message.role === "string" ? message.role : "message";
-    const text = contentText(message.content);
-    return text ? `${role}: ${text}` : "";
-  }
-  if (record.type === "custom") {
-    const text = contentText(record.message ?? record.text ?? record.content);
-    return text ? `system: ${text}` : "";
-  }
-  return "";
-}
-
-async function forwardTuiPrompt(
-  lock: WriterLock,
-  sessionId: string,
-  prompt: string,
-): Promise<void> {
-  if (!lock.coordinatorEndpoint || !lock.coordinatorSecret) return;
-  const response = await fetch(
-    new URL("/api/local-coordinator/chat-run", lock.coordinatorEndpoint),
-    {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        "x-opencandle-coordinator-secret": lock.coordinatorSecret,
-      },
-      body: JSON.stringify({
-        prompt,
-        sessionId,
-        actionId: `tui-proxy-${randomUUID()}`,
-      }),
-    },
-  );
-  if (!response.ok) {
-    const body = (await response.json().catch(() => ({}))) as { error?: string };
-    console.error(body.error || response.statusText);
-    return;
-  }
-  await printSseResponse(response);
-}
-
-async function printSseResponse(response: Response): Promise<void> {
-  const reader = response.body?.getReader();
-  if (!reader) return;
-  const decoder = new TextDecoder();
-  let buffer = "";
-  while (true) {
-    const { value, done } = await reader.read();
-    if (done) break;
-    buffer += decoder.decode(value, { stream: true });
-    let index = buffer.indexOf("\n\n");
-    while (index !== -1) {
-      const block = buffer.slice(0, index);
-      buffer = buffer.slice(index + 2);
-      printSseBlock(block);
-      index = buffer.indexOf("\n\n");
-    }
-  }
-}
-
-function printSseBlock(block: string): void {
-  const data = block
-    .split("\n")
-    .filter((line) => line.startsWith("data:"))
-    .map((line) => line.slice(5).trim())
-    .join("\n");
-  if (!data) return;
-  const event = JSON.parse(data) as {
-    type?: string;
-    role?: string;
-    text?: string;
-    content?: Array<{ type?: string; text?: string }>;
-    error?: { message?: string };
-  };
-  const text = sseEventText(event);
-  if (event.type === "message.completed" && text) {
-    process.stdout.write(`${text}\n`);
-  } else if (event.type === "run.failed") {
-    process.stderr.write(`${event.error?.message || "Run failed"}\n`);
-  }
-}
-
-function sseEventText(event: {
-  text?: string;
-  content?: Array<{ type?: string; text?: string }>;
-}): string {
-  if (event.text) return event.text;
-  return contentText(event.content);
-}
-
-function contentText(content: unknown): string {
-  if (typeof content === "string") return content;
-  if (!Array.isArray(content)) return "";
-  return content
-    .filter((part) => part.type === "text" && part.text)
-    .map((part) => part.text)
-    .join("");
-}
-
-function asRecord(value: unknown): Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value)
-    ? (value as Record<string, unknown>)
-    : {};
-}
-
-await main();

package/src/cli.ts

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-import { ensureOpenCandleNativeDependencies } from "./infra/native-dependencies.js";
-import { assertSupportedNodeVersion } from "./infra/node-version.js";
-
-if (process.argv[2] === "doctor") {
-  const [{ loadEnv }, { handleDoctorCommand }, { getAgentDir }] = await Promise.all([
-    import("./config.js"),
-    import("./doctor/cli-command.js"),
-    import("@earendil-works/pi-coding-agent"),
-  ]);
-  loadEnv();
-  await handleDoctorCommand(process.argv.slice(2), process.cwd(), getAgentDir());
-} else {
-  assertSupportedNodeVersion();
-  await ensureOpenCandleNativeDependencies();
-  await import("./cli-main.js");
-}