@anhlp/alp 0.0.0-beta.2 → 0.0.1-beta.3

package/README.md

@@ -4,11 +4,11 @@ Provider-neutral filesystem agent resolution with a server-side Paseo provider.
 
 ## Install
 
-The current release is the beta `0.0.0-beta.2` (until it is on npm, `@beta` installs
-`0.0.0-beta.1`; check with `npm view @anhlp/alp dist-tags`): see the
+The current release is the beta `0.0.1-beta.3` (until it is on npm, `@beta` installs
+`0.0.0-beta.2`; check with `npm view @anhlp/alp dist-tags`): see the
 [release notes](docs/alp/beta-release-notes.md) for what it includes and its known issues, and
 [installing, upgrading and removing the beta](docs/alp/beta-install.md) for every step. Name the
-beta when you install (`@beta`, or exactly `@0.0.0-beta.2`); a plain `npm install -g @anhlp/alp`
+beta when you install (`@beta`, or exactly `@0.0.1-beta.3`); a plain `npm install -g @anhlp/alp`
 installs whatever npm's `latest` tag points at, which moves to a new beta only after that
 beta's post-publish checks.
 
@@ -334,13 +334,13 @@ Details: [ALPD §60](plans/reference/ALPD.md#60-alp-as-an-acp-agent-2026-10-10).
 
 ## Paseo
 
-To use the published plugin, follow [the plugin's README](integrations/paseo/README.md) or [beta-install.md](docs/alp/beta-install.md#paseo-plugin): `paseo plugin add npm:@anhlp/alp-paseo@beta` (from `0.0.0-beta.2`; in beta.1 the `npm:` source fails, [#111](https://github.com/phucanh08/alp/issues/111), so there run `npm install -g @anhlp/alp-paseo@beta`, then `paseo plugin add "$(npm root -g)/@anhlp/alp-paseo"`). The beta supports Paseo `>=0.11.1 <0.12.0`. See [installation and runtime behavior](docs/alp/paseo-plugin.md) and the historical [phase acceptance evidence](docs/alp/phase-2-5-results.md). The plugin was verified with Paseo 0.11.1 and live Codex and Claude Code permission changes before the beta; the beta's own runs are in [beta-scope.md](docs/alp/beta-scope.md) §6.
+To use the published plugin, follow [the plugin's README](integrations/paseo/README.md) or [beta-install.md](docs/alp/beta-install.md#paseo-plugin): `paseo plugin add npm:@anhlp/alp-paseo@beta` (from `0.0.0-beta.2`; in beta.1 the `npm:` source fails, [#111](https://github.com/phucanh08/alp/issues/111), so there run `npm install -g @anhlp/alp-paseo@beta`, then `paseo plugin add "$(npm root -g)/@anhlp/alp-paseo"`). The plugin supports Paseo `>=0.11.1 <0.13.0` (`0.0.0-beta.2` and earlier: `<0.12.0`, so Paseo 0.12 needs `0.0.1-beta.3` or later). See [installation and runtime behavior](docs/alp/paseo-plugin.md) and the historical [phase acceptance evidence](docs/alp/phase-2-5-results.md). The plugin was verified with Paseo 0.11.1 and live Codex and Claude Code permission changes before the beta; the beta's own runs are in [beta-scope.md](docs/alp/beta-scope.md) §6.
 
 **Settings → ALP** manages your library of teams, agents, skills, MCP servers, hooks and ACP providers, and the **ALP project** workspace panel manages a project's overrides ([settings screen](docs/alp/paseo-plugin.md#alp-settings-and-the-project-panel)).
 
 ### Build and add the plugin to Paseo
 
-This section builds the plugin from a checkout of this repository. Prerequisites: Node.js 22 (22.12 or later) or 24, Paseo 0.11.1 or a later 0.11 release (the Tasks panel needs its plugin client API), and a logged-in Codex CLI and/or Claude Code installation. Set `ALP_CODEX_BIN` or `ALP_CLAUDE_BIN` to an absolute native executable path when it is not available on `PATH`.
+This section builds the plugin from a checkout of this repository. Prerequisites: Node.js 22 (22.12 or later) or 24, Paseo 0.11.1 or later, up to 0.12.x (the Tasks panel needs the 0.11.1 plugin client API), and a logged-in Codex CLI and/or Claude Code installation. Set `ALP_CODEX_BIN` or `ALP_CLAUDE_BIN` to an absolute native executable path when it is not available on `PATH`.
 
 Install dependencies, type-check the plugin, and build its server bundle:
 

package/dist/acp.js

@@ -18419,8 +18419,8 @@ import { Readable, Writable } from "node:stream";
 
 // packages/client/src/index.js
 import { spawn } from "node:child_process";
-import { createHash } from "node:crypto";
-import { open, readFile, realpath, stat, lstat, mkdir, readlink, unlink } from "node:fs/promises";
+import { createHash, randomUUID } from "node:crypto";
+import { open, readFile, writeFile, realpath, stat, lstat, mkdir, readlink, unlink, readdir, rename, rmdir, link } from "node:fs/promises";
 import net from "node:net";
 import os from "node:os";
 import path from "node:path";
@@ -18552,7 +18552,7 @@ var AlpRpcError = class extends Error {
 };
 var ERROR = Object.freeze({ failed: 1e3, notFound: 1001, forbidden: 1003, conflict: 1004, unavailable: 1005, protocol: 1006 });
 var RPC_ERROR = Object.freeze({ parseError: -32700, invalidRequest: -32600, methodNotFound: -32601, invalidParams: -32602 });
-var CAPABILITY = Object.freeze({ attachAfter: "attach.after", promptReceipts: "prompt.receipts", extensionMethods: "extension.methods", team: "team", task: "task", library: "library", settingsLanguage: "settings.language", sessionListPage: "session.list.page", questionWatch: "question.watch", questionWatchTurns: "question.watch.turns", workspaceFiles: "workspace.files", workspaceFilesRead: "workspace.files.read", promptImages: "prompt.images" });
+var CAPABILITY = Object.freeze({ attachAfter: "attach.after", promptReceipts: "prompt.receipts", extensionMethods: "extension.methods", team: "team", task: "task", library: "library", libraryProjectWrite: "library.project.write", settingsLanguage: "settings.language", sessionListPage: "session.list.page", questionWatch: "question.watch", questionWatchTurns: "question.watch.turns", workspaceFiles: "workspace.files", workspaceFilesRead: "workspace.files.read", promptImages: "prompt.images" });
 var PROMPT_IMAGES = Object.freeze({ mimeTypes: Object.freeze(["image/png", "image/jpeg", "image/gif", "image/webp"]), maxCount: 8, maxBytes: 5 * 1024 * 1024, maxTotalBytes: 11 * 1024 * 1024 });
 var RPC_METHODS = Object.freeze(["assignment.recall", "board.list", "catalog.get", "daemon.hello", "daemon.pause", "daemon.pauses", "daemon.resume", "daemon.shutdown", "daemon.status", "daemon.usage", "extension.register", "extension.unregister", "library.delete", "library.duplicate", "library.get", "library.list", "library.models", "library.rename", "library.save", "library.skills.set", "question.answer", "question.list", "question.watch", "session.archive", "session.attach", "session.close", "session.configure", "session.create", "session.get", "session.interrupt", "session.list", "session.log", "session.message", "session.preview", "session.prompt", "session.release", "session.rename", "session.status", "settings.language.get", "settings.language.set", "task.create", "task.gate.resolve", "task.list", "task.update", "team.list", "workspace.files.list", "workspace.files.read", "workspace.files.search"]);
 var WORKSPACE_FILES = Object.freeze({ maxReadBytes: 1024 * 1024, maxListEntries: 1e3, maxPathLength: 4096 });
@@ -19158,10 +19158,86 @@ async function tail(file2, lines = 30) {
     return "";
   }
 }
+async function lifecycleOwners(home) {
+  const directory = path.join(home, "state", "alpd.starting");
+  const names = await readdir(directory).catch((error51) => {
+    if (error51.code === "ENOENT") return [];
+    throw error51;
+  });
+  return names.map((token) => {
+    const match = /^owner-(\d+)-(\d+)-(start|stop)-[a-f0-9-]+$/.exec(token);
+    if (!match) throw new Error("Invalid alpd startup admission owner");
+    return { token, pid: Number(match[1]), bootTime: Number(match[2]), action: match[3] };
+  });
+}
+async function readDaemonLifecycle(home) {
+  return (await lifecycleOwners(home)).find((owner) => lockAlive(owner));
+}
+async function withDaemonLifecycle(home, action, run, { joinStart = false } = {}) {
+  try {
+    await assertPrivateDirectory(home, { create: true });
+  } catch (cause) {
+    throw Object.assign(new Error(`ALP_HOME_UNUSABLE, alpd failed to start while preparing its home: ${cause.message}`, { cause }), { code: "ALP_HOME_UNUSABLE" });
+  }
+  const state = path.join(home, "state");
+  await assertPrivateDirectory(state, { create: true });
+  const directory = path.join(state, "alpd.starting");
+  const token = `owner-${process.pid}-${bootTime()}-${action}-${randomUUID()}`;
+  const candidate = path.join(state, `alpd.starting-${token}`);
+  await mkdir(candidate, { mode: 448 });
+  await writeFile(path.join(candidate, token), JSON.stringify({ pid: process.pid, bootTime: bootTime(), action }), { mode: 384 });
+  try {
+    let joined = false;
+    if (joinStart) {
+      const owner = await readDaemonLifecycle(home);
+      if (owner?.action === "start") {
+        try {
+          await link(path.join(directory, owner.token), path.join(directory, token));
+          joined = true;
+        } catch (error51) {
+          if (error51.code !== "ENOENT") throw error51;
+        }
+      }
+    }
+    while (!joined) {
+      try {
+        await rename(candidate, directory);
+        break;
+      } catch (error51) {
+        if (!["EEXIST", "ENOTEMPTY", "EPERM", "EACCES"].includes(error51.code)) throw error51;
+        for (const owner of await lifecycleOwners(home)) {
+          if (!lockAlive(owner)) await unlink(path.join(directory, owner.token)).catch((error52) => {
+            if (error52.code !== "ENOENT") throw error52;
+          });
+        }
+        await rmdir(directory).catch((error52) => {
+          if (!["ENOENT", "ENOTEMPTY", "EEXIST"].includes(error52.code)) throw error52;
+        });
+        await new Promise((resolve) => setTimeout(resolve, 25));
+      }
+    }
+    try {
+      return await run();
+    } finally {
+      await unlink(path.join(directory, token));
+      await rmdir(directory).catch((error51) => {
+        if (!["ENOENT", "ENOTEMPTY", "EEXIST"].includes(error51.code)) throw error51;
+      });
+    }
+  } finally {
+    await unlink(path.join(candidate, token)).catch((error51) => {
+      if (error51.code !== "ENOENT") throw error51;
+    });
+    await rmdir(candidate).catch((error51) => {
+      if (error51.code !== "ENOENT") throw error51;
+    });
+  }
+}
 async function ensureDaemon({ home = alpHome(), entry = (
   /** @type {string | undefined} */
   void 0
-), env = process.env, execPath = process.execPath, timeoutMs = 15e3 } = {}) {
+), env = process.env, execPath = process.execPath, timeoutMs = 15e3, lifecycleLocked = false } = {}) {
+  if (!lifecycleLocked) return withDaemonLifecycle(home, "start", () => ensureDaemon({ home, entry, env, execPath, timeoutMs, lifecycleLocked: true }));
   const ready = async () => {
     const lock = await readLock(home);
     return lockAlive(lock) && lock.ready ? lock.socket : void 0;
@@ -19174,7 +19250,7 @@ async function ensureDaemon({ home = alpHome(), entry = (
     entry ??= await findDaemonEntry({ home, env });
     if (!entry) throw new Error("ALP daemon is not running and alpd.js was not found. Install the ALP CLI and run `alp daemon start`, or set ALP_DAEMON_ENTRY to alpd.js");
     await new Promise((resolve, reject) => {
-      const launcher = spawn(execPath, [entry, "--detach"], {
+      const launcher = spawn(execPath, [entry, "--detach", `--startup-timeout=${timeoutMs}`], {
         env: { ...env, ALP_HOME: home, ELECTRON_RUN_AS_NODE: "1" },
         stdio: ["ignore", "ignore", "pipe"],
         windowsHide: true
@@ -19199,12 +19275,12 @@ ${log}` : ""}`);
 }
 
 // packages/client/src/supervise.js
-import { mkdir as mkdir3, unlink as unlink3, writeFile as writeFile2, stat as stat2 } from "node:fs/promises";
+import { mkdir as mkdir3, unlink as unlink3, writeFile as writeFile3, stat as stat2 } from "node:fs/promises";
 import path3 from "node:path";
 
 // packages/client/src/service.js
 import { createHash as createHash2 } from "node:crypto";
-import { mkdir as mkdir2, readFile as readFile2, unlink as unlink2, writeFile } from "node:fs/promises";
+import { mkdir as mkdir2, readFile as readFile2, unlink as unlink2, writeFile as writeFile2 } from "node:fs/promises";
 import os2 from "node:os";
 import path2 from "node:path";
 
@@ -19301,6 +19377,9 @@ async function releaseHold(home) {
   await unlink3(holdFile(home)).catch(() => {
   });
 }
+async function daemonHeld(home) {
+  return stat2(holdFile(home)).then(() => true, () => false);
+}
 async function whenReady(home, timeoutMs) {
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
@@ -19310,20 +19389,24 @@ async function whenReady(home, timeoutMs) {
   }
   throw new Error(`alpd did not become ready within ${timeoutMs / 1e3} s; see ${path3.join(home, "logs")}`);
 }
-async function startDaemon({ home, entry, env = process.env, timeoutMs = 15e3 }) {
-  await releaseHold(home);
-  const lock = await readLock(home);
-  if (lockAlive(lock)) return lock.ready ? lock.socket : whenReady(home, timeoutMs);
-  const service = serviceFor({ home, env });
-  if (service && await installedProgram(service)) {
-    await startService(service);
-    return whenReady(home, timeoutMs);
-  }
-  return ensureDaemon({ home, entry, env, timeoutMs });
+async function startDaemon({ home, entry, env = process.env, timeoutMs = 15e3, automatic = false }) {
+  return withDaemonLifecycle(home, "start", async () => {
+    if (automatic) {
+      if (await daemonHeld(home)) return;
+    } else await releaseHold(home);
+    const lock = await readLock(home);
+    if (lockAlive(lock)) return lock.ready ? lock.socket : whenReady(home, timeoutMs);
+    const service = serviceFor({ home, env });
+    if (service && await installedProgram(service)) {
+      await startService(service);
+      return whenReady(home, timeoutMs);
+    }
+    return ensureDaemon({ home, entry, env, timeoutMs, lifecycleLocked: true });
+  });
 }
 
 // packages/cli/src/acp/agent.ts
-import { randomUUID } from "node:crypto";
+import { randomUUID as randomUUID2 } from "node:crypto";
 import path4 from "node:path";
 var unlistedOf = ({ teams, team, teamLabel }) => teams.some((entry) => entry.id === team) ? void 0 : { id: team, label: teamLabel ?? (team === "custom" ? "Custom" : team) };
 var MODES = [
@@ -19681,7 +19764,7 @@ ${item2.text}`;
       send(session, { sessionUpdate: "config_option_update", configOptions: configOptions(session) });
     }
     if (session.waiting) throw RequestError.invalidRequest(void 0, "A prompt is already running in this session");
-    const clientMessageId = randomUUID();
+    const clientMessageId = randomUUID2();
     session.ours.add(clientMessageId);
     let done;
     const ended = new Promise((resolve) => {
@@ -19726,7 +19809,7 @@ ${item2.text}`;
   })).onRequest("authenticate", () => ({})).onRequest("session/new", async ({ params }) => {
     const cwd = absolute(params.cwd);
     const mcpServers = hostServers(params.mcpServers);
-    const session = track(`acp-${randomUUID()}`, cwd, mcpServers, await preview(cwd, mcpServers), false);
+    const session = track(`acp-${randomUUID2()}`, cwd, mcpServers, await preview(cwd, mcpServers), false);
     queueMicrotask(() => send(session, { sessionUpdate: "available_commands_update", availableCommands: COMMANDS }));
     return { sessionId: session.id, configOptions: configOptions(session), modes: modeState(session) };
   }).onRequest("session/load", async ({ params }) => {
@@ -19803,7 +19886,7 @@ ${item2.text}`;
 
 // packages/cli/src/acp/main.ts
 async function runAcp({ daemonEntry }) {
-  const version2 = true ? "0.0.0-beta.2" : "0.0.0";
+  const version2 = true ? "0.0.1-beta.3" : "0.0.0";
   const logger = createLogger({ component: "acp" });
   const log = (message, fields) => logger.warn(message, fields);
   const app = createAcpAgent({