@anhlp/alp 0.0.1-beta.4 → 0.0.1-beta.7

package/packages/cli/dist/web-service.js

@@ -1,119 +0,0 @@
-// packages/cli/src/web-service.js
-import { execFile } from "node:child_process";
-import { existsSync } from "node:fs";
-import { lstat, readFile } from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { promisify } from "node:util";
-import { bootTime, readLock } from "@anhlp/alp-client/index";
-import { distributionEntry } from "./paths.js";
-var execFileAsync = promisify(execFile);
-var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-function alpWebEntry() {
-  const entry = fileURLToPath(distributionEntry("alp-web.js"));
-  if (!existsSync(entry)) throw new Error(`alp web is not built: ${entry} is missing. Build the CLI (npm run build in the ALP checkout) or reinstall ALP.`);
-  return entry;
-}
-var readJson = async (file) => JSON.parse(await readFile(file, "utf8"));
-async function processStart(pid) {
-  try {
-    const { stdout } = await execFileAsync("ps", ["-o", "etime=", "-p", String(pid)], { encoding: "utf8", timeout: 5e3 });
-    const match = /^\s*(?:(\d+)-)?(?:(\d+):)?(\d+):(\d+)\s*$/.exec(stdout);
-    if (!match) return void 0;
-    const [, days = "0", hours = "0", minutes, seconds] = match;
-    const elapsed = ((Number(days) * 24 + Number(hours)) * 60 + Number(minutes)) * 60 + Number(seconds);
-    return Date.now() - elapsed * 1e3;
-  } catch {
-    return void 0;
-  }
-}
-async function webOwner(home) {
-  const lockFile = path.join(home, "integrations", "web.lock");
-  const infoFile = path.join(home, "web.json");
-  let lock, lockInfo;
-  try {
-    lockInfo = await lstat(lockFile);
-    lock = await readJson(lockFile);
-  } catch {
-    return { reason: `${lockFile} is missing or unreadable`, alive: false };
-  }
-  if (!lockInfo.isFile() || !Number.isSafeInteger(lock?.pid) || lock.pid <= 0 || typeof lock.bootTime !== "number" || !Number.isFinite(Date.parse(lock.startedAt))) {
-    return { reason: `${lockFile} is not a complete integration lock`, alive: false };
-  }
-  const { pid } = lock;
-  try {
-    process.kill(pid, 0);
-  } catch (error) {
-    if (error?.code === "ESRCH") return { reason: `its pid ${pid} has exited`, alive: false };
-    if (error?.code === "EPERM") return { reason: `pid ${pid} belongs to another user`, alive: true, kind: "foreign" };
-    return { reason: `pid ${pid} cannot be signalled (${error?.code ?? error})`, alive: true, kind: "unknown" };
-  }
-  const refuse = (reason, kind) => ({ reason, alive: true, kind });
-  if (process.platform === "win32") return refuse("alp does not stop it on Windows", "unknown");
-  const uid = process.getuid?.();
-  if (lockInfo.uid !== uid) return refuse("its lock is not yours", "foreign");
-  if (Math.abs(lock.bootTime - bootTime()) > 30) return refuse("its lock is from another boot", "foreign");
-  if (pid === process.pid || pid === (await readLock(home).catch(() => void 0))?.pid) return refuse(`pid ${pid} is not an integration`, "foreign");
-  const started = await processStart(pid);
-  if (started === void 0) return refuse(`the start time of pid ${pid} is unknown`, "unknown");
-  if (started > Date.parse(lock.startedAt) + 2e3) return refuse(`pid ${pid} started after the lock was written (a reused pid)`, "foreign");
-  let info, infoStat;
-  try {
-    infoStat = await lstat(infoFile);
-    info = await readJson(infoFile);
-  } catch {
-    return refuse(`${infoFile} is missing or unreadable`, "transient");
-  }
-  if (info?.pid !== pid) return refuse(`${infoFile} names another process than the lock`, "transient");
-  if (!infoStat.isFile() || infoStat.uid !== uid) return refuse(`${infoFile} is not yours`, "foreign");
-  return { pid, app: info.app };
-}
-async function terminate(pid, what, timeoutMs = 2e4) {
-  try {
-    process.kill(pid, "SIGTERM");
-  } catch (error) {
-    if (error?.code === "ESRCH") return;
-    throw error;
-  }
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    try {
-      process.kill(pid, 0);
-    } catch (error) {
-      if (error?.code === "ESRCH") return;
-    }
-    await sleep(100);
-  }
-  throw new Error(`${what} (pid ${pid}) did not stop within ${timeoutMs / 1e3} s of SIGTERM; stop it, then run the command again`);
-}
-var isAlpWeb = (app) => app === "alp-web";
-var PASEO_BEFORE_RENAME = "The Paseo integration from before its rename";
-async function stopPreRenamePaseo(home) {
-  const owner = await webOwner(home);
-  if (!("pid" in owner) || isAlpWeb(owner.app)) return void 0;
-  await terminate(owner.pid, PASEO_BEFORE_RENAME);
-  return owner.pid;
-}
-async function stopWebService(home, timeoutMs = 3e4) {
-  const deadline = Date.now() + timeoutMs;
-  for (; ; ) {
-    const owner = await webOwner(home);
-    if ("pid" in owner) {
-      await terminate(owner.pid, isAlpWeb(owner.app) ? "alp web" : PASEO_BEFORE_RENAME);
-      return owner.pid;
-    }
-    if (!owner.alive) return void 0;
-    if (owner.kind !== "transient" || Date.now() >= deadline) throw new Error(`${refusal(home)} (${owner.reason}); stop it, then run the command again`);
-    await sleep(200);
-  }
-}
-function refusal(home) {
-  return `${path.join(home, "integrations", "web.lock")} is held by a process that alp cannot prove is alp web or the Paseo integration from before its rename, so it was left running`;
-}
-export {
-  alpWebEntry,
-  refusal,
-  stopPreRenamePaseo,
-  stopWebService,
-  webOwner
-};

package/packages/client/README.md

@@ -1,29 +0,0 @@
-# @anhlp/alp-client
-
-The ALP RPC client: a portable JSON-RPC engine for Node, browsers and React Native, its
-WebSocket and Node IPC transports, and the Node-only daemon discovery, supervision, services
-and setup helpers.
-
-- `@anhlp/alp-client/portable`: `AlpRpcClient`, errors, `hello`, `createReconnectingClient`,
-  NDJSON framing. No Node built-ins, `process` or `Buffer`; needs no polyfills.
-- `@anhlp/alp-client/websocket`: `connectWebSocket` over the browser's, React Native's or an
-  injected WebSocket. Authentication is the caller's (the gateway's) business.
-- `@anhlp/alp-client` (Node): everything above plus `connect`, `AlpClient`, `connectSocket`,
-  `ensureDaemon`, the private-socket checks and lock helpers, unchanged for existing callers.
-- `@anhlp/alp-client/ipc` (Node): `createSocketTransport` for a Unix socket or named pipe.
-- `@anhlp/alp-client/integration-lock` (Node): `createIntegrationLock(home, name)`, the single-owner
-  lock of one integration service at `<home>/integrations/<name>.lock`, serialized by the exclusive
-  guard directory `<name>.lock.reclaim`. Each instance is single-use (`acquire`, then `setReady` and
-  `release` while it owns the lock); its recovery rules are in
-  [docs/modular-monorepo.md](../../docs/modular-monorepo.md).
-
-Timeouts and aborts end only the caller's wait, and nothing is ever resent after a disconnect.
-See [docs/alp/client-sdk.md](../../docs/alp/client-sdk.md) for the transport contract, the
-request lifecycle, the old-to-new API table and what still waits on the protocol (Task 06) and
-the gateway (Task 08).
-
-`startIntegration({ name, entry, home, args })` (or `startIntegration(name)`; `name` defaults to `web`) discovers an optional integration's descriptor and starts it detached with `--service` and then `args`, so the entry writes its own log; discovery and the selected `ALP_HOME` are pinned by tests. `name` is a single lowercase path segment (`assertIntegrationName`). With `entry`, that script runs with the current Node and no descriptor, environment or PATH discovery happens; a missing entry is an error even when a live owner would be reused. `web` is alp-web, the service of the ALP CLI (`alp web`): it is never discovered, so it needs its `entry`, and `"web": { "enabled": false }` in the home's settings refuses it and no other integration. Everything once registered under `web` (`integrations/web.json`, the `alp-web-integration` binary, `ALP_WEB_INTEGRATION`) is the Paseo integration from before its rename; `discoverIntegration('paseo')` reads `ALP_PASEO_INTEGRATION`, then `ALP_WEB_INTEGRATION` for one release, then `ALP_INTEGRATION_ENTRY`. Errors name the integration, the entry and its log under `<home>/logs/integrations`. Either way a live owner of `integrations/<name>.lock` is reused, and the call resolves once that lock is ready and `<home>/<name>.json` names the same pid. Restarting is non-destructive: a daemon left running by an older install is reported as older than the current CLI and is never killed in place.
-
-Build: `npm run build --workspace=@anhlp/alp-client`. Test: `npm run test --workspace=@anhlp/alp-client`.
-
-Public imports use the package root and its explicitly exported subpaths. See [architecture, provider extension, compatibility and release instructions](../../docs/modular-monorepo.md).

package/packages/client/dist/acp-probe.d.ts

@@ -1,44 +0,0 @@
-/**
- * Starts an ACP provider once and runs initialize (ALPD §46), for `alp provider test`
- * and the settings screen. It reports who the agent says it is and what it supports;
- * a provider that needs a login usually says so here, in authMethods. With `discover`,
- * it also opens a session in `cwd`, as Paseo does, to read the models and modes the agent
- * offers (ALPD §65); an agent that offers none leaves them out.
- * @param {{ command: string, args?: string[], env?: Record<string, string>, label?: string, id?: string }} provider
- * @param {{ cwd?: string, timeoutMs?: number, discover?: boolean }} [options]
- * @returns {Promise<{ protocolVersion: number, agent?: { name?: string, title?: string, version?: string }, loadSession: boolean, mcpHttp: boolean, authMethods: string[],
- *   models?: Array<{ id: string, label: string, description?: string }>, currentModel?: string, modes?: Array<{ id: string, label: string, description?: string }>, currentMode?: string }>}
- */
-export function probeAcp(provider: {
-    command: string;
-    args?: string[];
-    env?: Record<string, string>;
-    label?: string;
-    id?: string;
-}, { cwd, timeoutMs, discover }?: {
-    cwd?: string;
-    timeoutMs?: number;
-    discover?: boolean;
-}): Promise<{
-    protocolVersion: number;
-    agent?: {
-        name?: string;
-        title?: string;
-        version?: string;
-    };
-    loadSession: boolean;
-    mcpHttp: boolean;
-    authMethods: string[];
-    models?: Array<{
-        id: string;
-        label: string;
-        description?: string;
-    }>;
-    currentModel?: string;
-    modes?: Array<{
-        id: string;
-        label: string;
-        description?: string;
-    }>;
-    currentMode?: string;
-}>;

package/packages/client/dist/acp-probe.js

@@ -1,37 +0,0 @@
-// packages/client/src/acp-probe.js
-import { stdioSession } from "./mcp-probe.js";
-async function probeAcp(provider, { cwd, timeoutMs = 2e4, discover = false } = {}) {
-  const session = stdioSession({ command: provider.command, args: provider.args ?? [], env: provider.env ?? {} }, cwd, timeoutMs);
-  try {
-    const result = await session.request("initialize", {
-      protocolVersion: 1,
-      clientCapabilities: { fs: { readTextFile: false, writeTextFile: false }, terminal: false },
-      clientInfo: { name: "alp", title: "ALP", version: "1" }
-    });
-    if (result.protocolVersion !== 1) throw new Error(`${provider.label ?? provider.id} speaks ACP version ${result.protocolVersion}; ALP speaks version 1`);
-    const info = result.agentInfo;
-    const offered = discover ? await session.request("session/new", { cwd, mcpServers: [] }) : void 0;
-    const choices = (list) => Array.isArray(list) ? list.filter((item) => typeof (item?.modelId ?? item?.id) === "string").map((item) => ({ id: item.modelId ?? item.id, label: typeof item.name === "string" && item.name ? item.name : item.modelId ?? item.id, ...typeof item.description === "string" && item.description ? { description: item.description } : {} })) : void 0;
-    const config = offered?.configOptions?.find((option) => option.category === "model" && option.type === "select");
-    const modeConfig = offered?.configOptions?.find((option) => option.category === "mode" && option.type === "select");
-    const flatten = (options) => options?.flatMap((option) => option.options ?? [option]).map((option) => ({ ...option, id: option.value }));
-    const modelState = offered?.models ?? (config ? { availableModels: flatten(config.options), currentModelId: config.currentValue } : void 0);
-    const modeState = offered?.modes ?? (modeConfig ? { availableModes: flatten(modeConfig.options), currentModeId: modeConfig.currentValue } : void 0);
-    const models = choices(modelState?.availableModels);
-    const modes = choices(modeState?.availableModes);
-    return {
-      ...models ? { models, ...typeof modelState.currentModelId === "string" ? { currentModel: modelState.currentModelId } : {} } : {},
-      ...modes ? { modes, ...typeof modeState.currentModeId === "string" ? { currentMode: modeState.currentModeId } : {} } : {},
-      protocolVersion: result.protocolVersion,
-      ...info ? { agent: { ...info.name ? { name: info.name } : {}, ...info.title ? { title: info.title } : {}, ...info.version ? { version: info.version } : {} } } : {},
-      loadSession: Boolean(result.agentCapabilities?.loadSession),
-      mcpHttp: Boolean(result.agentCapabilities?.mcpCapabilities?.http),
-      authMethods: (result.authMethods ?? []).map((method) => method?.name ?? method?.id).filter(Boolean)
-    };
-  } finally {
-    await session.close();
-  }
-}
-export {
-  probeAcp
-};

package/packages/client/dist/antigravity-probe.d.ts

@@ -1,34 +0,0 @@
-/**
- * Probes Antigravity CLI for version, status and available models.
- * @param {{ command?: string, args?: string[], env?: Record<string, string>, label?: string, id?: string, readOnlyMode?: 'instructions' | 'reject' }} [provider]
- * @param {{ cwd?: string, timeoutMs?: number }} [options]
- */
-export function probeAntigravity(provider?: {
-    command?: string;
-    args?: string[];
-    env?: Record<string, string>;
-    label?: string;
-    id?: string;
-    readOnlyMode?: "instructions" | "reject";
-}, { cwd, timeoutMs }?: {
-    cwd?: string;
-    timeoutMs?: number;
-}): Promise<{
-    version: string;
-    agent: {
-        name: string;
-        title: string;
-        version: string;
-    };
-    models: {
-        id: any;
-        label: any;
-    }[];
-    currentModel: any;
-    modes: {
-        id: string;
-        label: string;
-        description: string;
-    }[];
-    currentMode: string;
-}>;

package/packages/client/dist/antigravity-probe.js

@@ -1,95 +0,0 @@
-// packages/client/src/antigravity-probe.js
-import { spawn } from "node:child_process";
-var DEFAULT_ANTIGRAVITY_MODELS = [
-  { id: "gemini-3.8-flash-high", label: "Gemini 3.8 Flash (High)" },
-  { id: "gemini-3.8-flash-medium", label: "Gemini 3.8 Flash (Medium)" },
-  { id: "gemini-3.8-flash-low", label: "Gemini 3.8 Flash (Low)" },
-  { id: "gemini-2.5-pro", label: "Gemini 2.5 Pro" },
-  { id: "gemini-2.5-flash", label: "Gemini 2.5 Flash" },
-  { id: "claude-sonnet-4-6", label: "Claude Sonnet 4.6 (Thinking)" },
-  { id: "claude-opus-4-6-thinking", label: "Claude Opus 4.6 (Thinking)" },
-  { id: "gpt-oss-120b-medium", label: "GPT-OSS 120B (Medium)" }
-];
-var ANTIGRAVITY_MODES = [
-  {
-    id: "full-access",
-    label: "Full access",
-    description: "Antigravity runs with full access (--dangerously-skip-permissions)."
-  }
-];
-function runCommand(command, args, { env = process.env, cwd, timeoutMs = 2e4 } = {}) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(command, args, {
-      cwd,
-      env,
-      stdio: ["ignore", "pipe", "pipe"],
-      windowsHide: true
-    });
-    let stdout = "";
-    let stderr = "";
-    const timer = setTimeout(() => {
-      child.kill("SIGKILL");
-      reject(new Error(`${command} ${args.join(" ")} timed out after ${timeoutMs / 1e3}s`));
-    }, timeoutMs);
-    child.stdout.on("data", (chunk) => {
-      stdout += chunk.toString();
-    });
-    child.stderr.on("data", (chunk) => {
-      stderr += chunk.toString();
-    });
-    child.on("error", (error) => {
-      clearTimeout(timer);
-      reject(error);
-    });
-    child.on("close", (code) => {
-      clearTimeout(timer);
-      if (code === 0) resolve({ stdout, stderr });
-      else reject(new Error(`${command} exited with code ${code}: ${stderr.trim() || stdout.trim()}`));
-    });
-  });
-}
-async function probeAntigravity(provider = {}, { cwd, timeoutMs = 2e4 } = {}) {
-  const command = provider.command || "agy";
-  const args = provider.args ?? [];
-  const env = { ...process.env, ...provider.env ?? {} };
-  let version = "";
-  try {
-    const res = await runCommand(command, [...args, "--version"], { env, cwd, timeoutMs: Math.min(timeoutMs, 5e3) });
-    version = res.stdout.trim().split("\n")[0] ?? "";
-  } catch (error) {
-    throw new Error(`Antigravity command '${command}' is not available: ${error.message}`);
-  }
-  let models = [];
-  try {
-    const res = await runCommand(command, [...args, "models"], { env, cwd, timeoutMs });
-    for (const line of res.stdout.trim().split(/\r?\n/)) {
-      if (!line.trim()) continue;
-      const [id, label] = line.split("	");
-      if (id && label) {
-        models.push({ id: id.trim(), label: label.trim() });
-      } else if (id) {
-        models.push({ id: id.trim(), label: id.trim() });
-      }
-    }
-  } catch {
-    models = [...DEFAULT_ANTIGRAVITY_MODELS];
-  }
-  if (!models.length) {
-    models = [...DEFAULT_ANTIGRAVITY_MODELS];
-  }
-  return {
-    version,
-    agent: { name: "antigravity", title: "Antigravity", version },
-    models,
-    currentModel: models[0]?.id,
-    modes: provider.readOnlyMode === "instructions" ? [...ANTIGRAVITY_MODES, {
-      id: "read-only",
-      label: "Read only (instructions)",
-      description: "For new sessions: prompt-only read-only behavior. agy still runs with full access; no OS sandbox enforces this mode."
-    }] : ANTIGRAVITY_MODES,
-    currentMode: "full-access"
-  };
-}
-export {
-  probeAntigravity
-};

package/packages/client/dist/command.d.ts

@@ -1,5 +0,0 @@
-/** Runs a command; resolves with its exit code and output, never rejects. */
-export function runCommand(command: any, args: any, { cwd, env, timeoutMs }?: {
-    env?: NodeJS.ProcessEnv | undefined;
-    timeoutMs?: number | undefined;
-}): Promise<any>;

package/packages/client/dist/command.js

@@ -1,33 +0,0 @@
-// packages/client/src/command.js
-import { spawn } from "node:child_process";
-function runCommand(command, args, { cwd, env = process.env, timeoutMs = 15e3 } = {}) {
-  return new Promise((resolve) => {
-    let child;
-    const script = process.platform === "win32" && /\.[cm]?js$/i.test(command);
-    try {
-      child = spawn(script ? process.execPath : command, script ? [command, ...args] : args, { cwd, env, stdio: ["ignore", "pipe", "pipe"] });
-    } catch (error) {
-      resolve({ code: -1, stdout: "", stderr: error.message });
-      return;
-    }
-    let stdout = "", stderr = "";
-    child.stdout.on("data", (chunk) => {
-      stdout += chunk;
-    });
-    child.stderr.on("data", (chunk) => {
-      stderr += chunk;
-    });
-    const timer = setTimeout(() => child.kill("SIGKILL"), timeoutMs);
-    child.on("error", (error) => {
-      clearTimeout(timer);
-      resolve({ code: -1, stdout, stderr: error.message });
-    });
-    child.on("close", (code) => {
-      clearTimeout(timer);
-      resolve({ code: code ?? -1, stdout, stderr });
-    });
-  });
-}
-export {
-  runCommand
-};

package/packages/client/dist/doctor.d.ts

@@ -1,13 +0,0 @@
-export type DoctorCheck = {
-  id: string;
-  status: 'ok' | 'info' | 'warn' | 'fail';
-  summary: string;
-  details?: string[];
-  hint?: string;
-  fix?: { describe: string; apply(): Promise<string> };
-};
-export type CommandResult = { code: number; stdout: string; stderr: string };
-export type CommandRunner = (command: string, args: string[], options?: { cwd?: string; env?: NodeJS.ProcessEnv; timeoutMs?: number }) => Promise<CommandResult>;
-export const runCommand: CommandRunner;
-export function diagnose(options?: { home?: string; project?: string; env?: NodeJS.ProcessEnv; run?: CommandRunner; sandbox?: boolean; daemonEntry?: string; timeoutMs?: number }): Promise<DoctorCheck[]>;
-export function repair(checks: DoctorCheck[]): Promise<Array<{ id: string; result: string }>>;