@anhlp/alp 0.0.0-beta.1 → 0.0.0-beta.2

package/README.md

@@ -4,11 +4,13 @@ Provider-neutral filesystem agent resolution with a server-side Paseo provider.
 
 ## Install
 
-The current release is the beta `0.0.0-beta.1` (not published yet): see the
+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
 [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.1`); a plain `npm install -g @anhlp/alp`
-installs the older `0.10.0`.
+beta when you install (`@beta`, or exactly `@0.0.0-beta.2`); 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.
 
 Supported: Linux or macOS, Node.js 22 (22.12 or later) or 24, and a signed-in Codex CLI or
 Claude Code on PATH. Windows and Node.js 26 are experimental; Node.js 20 is not supported.
@@ -332,7 +334,7 @@ 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`. 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 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.
 
 **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)).
 

package/dist/acp.js

@@ -18552,8 +18552,10 @@ 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" });
-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", "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"]);
+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 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 });
 
 // packages/client/src/rpc/errors.js
 var BRAND = Symbol.for("@anhlp/alp-client/AlpClientError");
@@ -19323,6 +19325,7 @@ async function startDaemon({ home, entry, env = process.env, timeoutMs = 15e3 })
 // packages/cli/src/acp/agent.ts
 import { randomUUID } 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 = [
   { id: "read-only", name: "Read only", description: "Agents read and search; nothing is changed" },
   { id: "workspace-write", name: "Workspace write", description: "Agents change files and run commands inside the project" },
@@ -19364,34 +19367,120 @@ ${resource.text}
   }
   return text.trim();
 }
+function shown(file2, cwd) {
+  if (!cwd || !path4.isAbsolute(file2)) return file2;
+  const relative = path4.relative(cwd, file2);
+  return relative && !relative.startsWith("..") && !path4.isAbsolute(relative) ? relative : file2;
+}
 function toolKind(item) {
-  const word = item.detail.type === "shell" ? String(item.detail.command ?? "").trim().split(/[\s{(]/)[0] : item.name;
+  const detail = item.detail;
+  switch (detail.type) {
+    case "read":
+      return "read";
+    case "edit":
+    case "write":
+      return "edit";
+    case "search":
+      return detail.toolName === "web_search" ? "fetch" : "search";
+    case "fetch":
+      return "fetch";
+    case "plan":
+      return "think";
+    case "sub_agent":
+    case "plain_text":
+      return "other";
+  }
+  const word = detail.type === "shell" ? String(detail.command ?? "").trim().split(/[\s{(]/)[0] : item.name;
   if (/^(Read|NotebookRead|LS)$/.test(word)) return "read";
   if (/^(Edit|MultiEdit|Write|NotebookEdit)$/.test(word)) return "edit";
   if (/^(Grep|Glob)$/.test(word)) return "search";
   if (/^(WebFetch|WebSearch)$/.test(word)) return "fetch";
   if (/^(Skill|Task|TodoWrite)$/.test(word) || item.name.startsWith("alp_")) return "other";
-  return item.detail.type === "shell" ? "execute" : "other";
-}
-function toolTitle(item) {
-  if (item.detail.type === "shell") return clip(String(item.detail.command ?? "").split("\n")[0], 160);
-  const input = item.detail.input ?? {};
+  return detail.type === "shell" ? "execute" : "other";
+}
+function toolTitle(item, cwd) {
+  const detail = item.detail;
+  switch (detail.type) {
+    case "shell":
+      return clip(String(detail.command ?? "").split("\n")[0], 160);
+    case "read":
+      return clip(`Read ${shown(detail.filePath, cwd)}`, 160);
+    case "edit":
+      return clip(`Edit ${shown(detail.filePath, cwd)}`, 160);
+    case "write":
+      return clip(`Write ${shown(detail.filePath, cwd)}`, 160);
+    case "search":
+      return clip(`${detail.toolName === "web_search" ? "Search the web" : "Search"} ${detail.query}`, 160);
+    case "fetch":
+      return clip(`Fetch ${detail.url}`, 160);
+    case "sub_agent":
+      return clip(`${detail.subAgentType ?? "Sub-agent"}${detail.description ? `: ${detail.description.split("\n")[0]}` : ""}`, 160);
+    case "plan":
+      return "Plan";
+    case "plain_text":
+      return clip(`${item.name}${detail.label ? `: ${detail.label}` : ""}`, 160);
+  }
+  const input = detail.input ?? {};
   if (item.name === "alp_delegate") return clip(`Delegate to ${input.agent ?? "an agent"}: ${String(input.task ?? "").split("\n")[0]}`, 160);
   return clip(`${item.name} ${JSON.stringify(input)}`, 160);
 }
+var bounded = (text) => text.length > OUTPUT_CHARS ? `${text.slice(0, OUTPUT_CHARS)}
+\u2026 (${text.length - OUTPUT_CHARS} more characters)` : text;
 function toolOutput(item) {
+  const detail = item.detail;
+  const parts = [];
   let text = "";
-  if (item.detail.type === "shell") text = item.detail.output ?? "";
-  else {
-    const output = item.detail.output;
-    text = Array.isArray(output) ? output.map((part) => typeof part?.text === "string" ? part.text : JSON.stringify(part)).join("\n") : output == null ? "" : typeof output === "string" ? output : JSON.stringify(output, null, 2);
+  switch (detail.type) {
+    case "shell":
+      text = detail.output ?? "";
+      break;
+    case "read":
+      text = detail.content ?? "";
+      break;
+    case "edit":
+      if (detail.newString !== void 0 || detail.oldString !== void 0) parts.push({ type: "diff", path: detail.filePath, oldText: detail.oldString ?? null, newText: detail.newString ?? "" });
+      else if (detail.unifiedDiff) text = "```diff\n" + detail.unifiedDiff + (detail.unifiedDiff.endsWith("\n") ? "" : "\n") + "```";
+      break;
+    case "write":
+      if (detail.content !== void 0) parts.push({ type: "diff", path: detail.filePath, oldText: null, newText: detail.content });
+      break;
+    case "search":
+      text = detail.content ?? [...detail.filePaths ?? [], ...(detail.webResults ?? []).map((hit) => `${hit.title} \u2014 ${hit.url}`)].join("\n");
+      break;
+    case "fetch":
+      text = detail.result ?? "";
+      break;
+    case "sub_agent":
+      text = detail.log || detail.description || "";
+      break;
+    case "plan":
+      text = detail.text;
+      break;
+    case "plain_text":
+      text = detail.text ?? "";
+      break;
+    default: {
+      const output = detail.output;
+      text = Array.isArray(output) ? output.map((part) => typeof part?.text === "string" ? part.text : JSON.stringify(part)).join("\n") : output == null ? "" : typeof output === "string" ? output : JSON.stringify(output, null, 2);
+    }
   }
   if (item.error) text = text ? `${text}
 ${item.error}` : item.error;
-  if (!text) return [];
-  if (text.length > OUTPUT_CHARS) text = `${text.slice(0, OUTPUT_CHARS)}
-\u2026 (${text.length - OUTPUT_CHARS} more characters)`;
-  return [{ type: "content", content: { type: "text", text } }];
+  if (text) parts.push({ type: "content", content: { type: "text", text: bounded(text) } });
+  return parts.map((part) => part.type === "diff" ? { ...part, newText: bounded(part.newText), ...part.oldText ? { oldText: bounded(part.oldText) } : {} } : part);
+}
+function toolInput(item) {
+  const detail = item.detail;
+  if (detail.type === "shell") return { command: detail.command, cwd: detail.cwd };
+  if (detail.type === "unknown" || !["read", "edit", "write", "search", "fetch", "sub_agent", "plan", "plain_text"].includes(detail.type)) return detail.input;
+  const { type: _type, content: _content, oldString: _old, newString: _new, unifiedDiff: _diff, result: _result, log: _log, text: _text, filePaths: _paths, webResults: _hits, ...rest } = detail;
+  return rest;
+}
+function toolLocations(item) {
+  const detail = item.detail;
+  if (detail.type !== "read" && detail.type !== "edit" && detail.type !== "write") return void 0;
+  const filePath = String(detail.filePath);
+  return [{ path: filePath, ...detail.type === "read" && typeof detail.offset === "number" ? { line: detail.offset } : {} }];
 }
 var clip = (text, chars) => text.length > chars ? `${text.slice(0, chars - 1)}\u2026` : text;
 var status = (state) => state === "running" ? "in_progress" : state;
@@ -19430,7 +19519,7 @@ function createAcpAgent(options) {
   }
   const say = (session, text) => send(session, { sessionUpdate: "agent_message_chunk", content: { type: "text", text } });
   function configOptions(session) {
-    const teams = session.opened ? session.preview.teams.filter((team) => team.id === session.preview.team) : session.preview.teams;
+    const teams = session.opened ? choices(session).filter((team) => team.id === session.preview.team) : choices(session);
     return [
       {
         id: "team",
@@ -19439,14 +19528,21 @@ function createAcpAgent(options) {
         type: "select",
         currentValue: session.preview.team,
         description: session.opened ? "A session keeps its team; start a new one for another team" : "The team that works on this session",
-        options: (teams.length ? teams : [{ id: session.preview.team, label: session.preview.teamLabel ?? session.preview.team }]).map((team) => ({ value: team.id, name: team.label, ...team.description ? { description: team.description } : {} }))
+        options: teams.map((team) => ({ value: team.id, name: team.label, ...team.description ? { description: team.description } : {} }))
       },
       { id: "mode", name: "Permissions", category: "mode", type: "select", currentValue: session.preview.mode, options: MODES.map((mode) => ({ value: mode.id, name: mode.name, description: mode.description })) }
     ];
   }
+  function choices(session) {
+    const { teams, team } = session.preview;
+    const own2 = unlistedOf(session.preview);
+    const first = session.unlisted && session.unlisted.id !== team && !teams.some((entry) => entry.id === session.unlisted.id) ? [session.unlisted] : [];
+    return [...first, ...own2 ? [own2] : [], ...teams];
+  }
   const modeState = (session) => ({ currentModeId: session.preview.mode, availableModes: MODES });
   function track(id, cwd, mcpServers, preview2, opened) {
-    const session = { id, cwd, mcpServers, preview: preview2, opened, ours: /* @__PURE__ */ new Set(), texts: /* @__PURE__ */ new Map(), tools: /* @__PURE__ */ new Set(), questions: /* @__PURE__ */ new Map(), queue: Promise.resolve() };
+    const unlisted = unlistedOf(preview2);
+    const session = { id, cwd, mcpServers, preview: preview2, opened, ...unlisted ? { unlisted } : {}, ours: /* @__PURE__ */ new Set(), texts: /* @__PURE__ */ new Map(), tools: /* @__PURE__ */ new Set(), questions: /* @__PURE__ */ new Map(), queue: Promise.resolve() };
     sessions.set(id, session);
     return session;
   }
@@ -19544,7 +19640,8 @@ ${item2.text}`;
         send(session, { sessionUpdate: "plan", entries: item2.items.map((entry) => ({ content: entry.text, priority: "medium", status: entry.status })) });
         return;
       case "tool_call": {
-        const fields = { title: toolTitle(item2), kind: toolKind(item2), status: status(item2.status), content: toolOutput(item2), rawInput: item2.detail.type === "shell" ? { command: item2.detail.command, cwd: item2.detail.cwd } : item2.detail.input };
+        const locations = toolLocations(item2);
+        const fields = { title: toolTitle(item2, session.cwd), kind: toolKind(item2), status: status(item2.status), content: toolOutput(item2), rawInput: toolInput(item2), ...locations ? { locations } : {} };
         if (session.tools.has(item2.id)) send(session, { sessionUpdate: "tool_call_update", toolCallId: item2.id, ...fields });
         else {
           session.tools.add(item2.id);
@@ -19677,7 +19774,7 @@ ${item2.text}`;
     if (params.configId === "mode") await setMode(session, value);
     else if (params.configId === "team") {
       if (session.opened && value !== session.preview.team) throw RequestError.invalidParams(void 0, "A session keeps its team; start a new one for another team");
-      if (!session.preview.teams.some((team) => team.id === value)) throw RequestError.invalidParams(void 0, `Unknown team ${value}`);
+      if (!choices(session).some((team) => team.id === value)) throw RequestError.invalidParams(void 0, `Unknown team ${value}`);
       session.preview = { ...await preview(session.cwd, session.mcpServers, value), mode: session.preview.mode };
     } else throw RequestError.invalidParams(void 0, `Unknown option ${params.configId}`);
     return { configOptions: configOptions(session) };
@@ -19706,7 +19803,7 @@ ${item2.text}`;
 
 // packages/cli/src/acp/main.ts
 async function runAcp({ daemonEntry }) {
-  const version2 = true ? "0.0.0-beta.1" : "0.0.0";
+  const version2 = true ? "0.0.0-beta.2" : "0.0.0";
   const logger = createLogger({ component: "acp" });
   const log = (message, fields) => logger.warn(message, fields);
   const app = createAcpAgent({