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

package/packages/cli/dist/backup.js

@@ -7,7 +7,7 @@ import { acquireDaemonLock, alpHome, assertPrivateDirectory, daemonPaths, lockAl
 import { daemonHeld, holdDaemon, releaseHold } from "@anhlp/alp-client/supervise";
 import { start, stop } from "./daemon.js";
 import { UsageError } from "./usage.js";
-var VERSION = true ? "0.0.0-beta.1" : "dev";
+var VERSION = true ? "0.0.0-beta.2" : "dev";
 var BY = `alp ${VERSION}`;
 var size = (bytes) => bytes >= 1024 * 1024 ? `${(bytes / 1024 / 1024).toFixed(1)} MB` : bytes >= 1024 ? `${(bytes / 1024).toFixed(1)} KB` : `${bytes} B`;
 var stamp = () => (/* @__PURE__ */ new Date()).toISOString().replace(/[-:]/g, "").replace(/\.\d+Z$/, "Z");

package/packages/cli/dist/build-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.0-beta.1",
+  "version": "0.0.0-beta.2",
   "entries": {
     "packages/cli/dist/alpd.js": {
       "inputs": [
@@ -44,6 +44,8 @@
         "packages/core/src/validation.js",
         "packages/core/src/verify.js",
         "packages/core/src/workflow.js",
+        "packages/daemon/src/files.ts",
+        "packages/daemon/src/gitignore.ts",
         "packages/daemon/src/lock.ts",
         "packages/daemon/src/main.ts",
         "packages/daemon/src/operations.ts",
@@ -77,6 +79,7 @@
         "packages/runtime/src/runtime-context.ts",
         "packages/runtime/src/runtime.ts",
         "packages/runtime/src/session-config.ts",
+        "packages/runtime/src/tool-detail.ts",
         "packages/runtime/src/tool-results.ts",
         "packages/runtime/src/tools.ts",
         "packages/runtime/src/transport.ts",

package/packages/cli/dist/sessions.d.ts

@@ -1,3 +1,5 @@
+/** One line for a finished tool call: its command, or what a typed call touched (ALPD §4.2). */
+export function toolLine(item: any): any;
 export function printer(json: any): (envelope: any) => void;
 /** Reads answers to questions for the user from the terminal, one question at a time. */
 export function answerer(client: any): {

package/packages/cli/dist/sessions.js

@@ -9,6 +9,27 @@ import { connect } from "@anhlp/alp-client/index";
 import { UsageError } from "./usage.js";
 import { start, running, stop } from "./daemon.js";
 import { taskProject } from "./tasks.js";
+function toolLine(item) {
+  const detail = item.detail ?? {};
+  const first = (text) => String(text ?? "").split("\n")[0].slice(0, 200);
+  switch (detail.type) {
+    case "shell":
+      return detail.command;
+    case "read":
+    case "edit":
+    case "write":
+      return `${item.name} ${detail.filePath}`;
+    case "search":
+      return `${item.name} ${first(detail.query)}`;
+    case "fetch":
+      return `${item.name} ${detail.url}`;
+    case "sub_agent":
+      return `${item.name}${detail.description ? ` ${first(detail.description)}` : ""}`;
+    case "plain_text":
+      return `${item.name}${detail.label ? ` ${detail.label}` : ""}`;
+  }
+  return item.name === "alp_delegate" ? `delegate \u2192 ${detail.input?.agent}` : item.name;
+}
 function printer(json) {
   const depth = /* @__PURE__ */ new Map();
   const agents = /* @__PURE__ */ new Map();
@@ -31,7 +52,7 @@ function printer(json) {
       latest.set(item.id, { sessionId, item });
       if (item.kind === "tool_call" && item.status !== "running" && !printed.has(item.id)) {
         printed.add(item.id);
-        const detail = item.detail.type === "shell" ? item.detail.command : item.name === "alp_delegate" ? `delegate \u2192 ${item.detail.input?.agent}` : item.name;
+        const detail = toolLine(item);
         line(sessionId, `  ${item.status === "failed" ? "\u2717" : "\u2713"} ${detail}`);
       }
       if (item.kind === "notice") line(sessionId, `  ${item.level === "error" ? "\u203C" : item.level === "warning" ? "!" : "\u2139"} ${item.text}`);
@@ -421,5 +442,6 @@ export {
   resume,
   run,
   send,
+  toolLine,
   top
 };

package/packages/core/dist/init.js

@@ -5,6 +5,7 @@ import path from "node:path";
 import { randomUUID } from "node:crypto";
 import { projectProfiles, profileDefaults, syncTemplateProfiles } from "./profiles.js";
 import { validateSettings } from "./validation.js";
+import { INIT_TEAM } from "./workflow.js";
 async function initProject(projectRoot, { templateRoot, templates, library, syncProfiles = true, onlyManagedProfiles = false, teamIds } = {}) {
   const root = path.resolve(projectRoot);
   const sourceRoot = () => templateRoot ?? shippedTemplateRoot();
@@ -17,7 +18,7 @@ async function initProject(projectRoot, { templateRoot, templates, library, sync
   const team = await projectProfiles({ root, templates, library, teamIds });
   const files = {
     "ALP.md": await template("ALP.md"),
-    ".alp/settings.json": JSON.stringify({ defaultAgent: "main", workflow: { mode: "pho" }, team, templateDefaults: profileDefaults(team) }, null, 2) + "\n"
+    ".alp/settings.json": JSON.stringify({ defaultAgent: "main", workflow: { mode: INIT_TEAM }, team, templateDefaults: profileDefaults(team) }, null, 2) + "\n"
   };
   const directories = [".alp"];
   const created = [];

package/packages/core/dist/teams.d.ts

@@ -3,20 +3,31 @@ export function validateTeam(config: any, source: any): any;
 /**
  * Where each team comes from: built in, then the library, then the project. A team
  * directory counts only with a team.json. `root` may be undefined outside a project.
+ * @param {string | undefined} root
+ * @param {{ library?: string, templates?: Record<string, string> }} [options]
  * @returns {Promise<Map<string, { source: 'builtin' | 'library' | 'project', directory?: string, overrides?: 'builtin' | 'library' }>>}
  */
-export function teamSources(root: any, { library, templates }?: {}): Promise<Map<string, {
+export function teamSources(root: string | undefined, { library, templates }?: {
+    library?: string;
+    templates?: Record<string, string>;
+}): Promise<Map<string, {
     source: "builtin" | "library" | "project";
     directory?: string;
     overrides?: "builtin" | "library";
 }>>;
 /**
  * A team by id, with its house rules.
+ * @param {string | undefined} root
+ * @param {string} id
+ * @param {{ library?: string, templates?: Record<string, string> }} [options]
  * @returns {Promise<{ id: string, source: 'builtin' | 'library' | 'project', label: string, description?: string, main: string,
  *   members: Record<string, { role?: string, model?: string, thinking?: string }>, delegation: Record<string, string[]>,
  *   oracleThinking?: Record<string, string>, oracleModels?: string[], maxPeers?: number, supervisor: false | { agent: string, model?: string, thinking?: string }, houseRules: string }>}
  */
-export function resolveTeam(root: any, id: any, { library, templates }?: {}): Promise<{
+export function resolveTeam(root: string | undefined, id: string, { library, templates }?: {
+    library?: string;
+    templates?: Record<string, string>;
+}): Promise<{
     id: string;
     source: "builtin" | "library" | "project";
     label: string;

package/packages/core/dist/workflow.d.ts

@@ -1,14 +1,45 @@
 /**
- * The team a session runs in (ALPD §42): the one the caller selects, the one a resumed
- * session ran in, or settings' workflow.mode. Without any, the session is `custom`: its
- * graph is settings' delegation and no supervisor watches it.
+ * The team a session runs in when the caller selects none (ALPD §42, §60): the one a resumed
+ * session ran in, else settings' workflow.mode, else `custom` (settings' delegation graph, no
+ * supervisor). A project without .alp/settings.json gets init's settings when a session is
+ * created, so with `scaffolded` a missing file counts as naming INIT_TEAM. session.create and
+ * session.preview both resolve through here, so a preview names the team that would run.
+ * @param {Record<string, any>} settings the project's settings, `{}` when the file is missing
+ * @param {{ restored?: { mode: string }, scaffolded?: boolean }} [options]
+ */
+export function defaultTeam(settings: Record<string, any>, { restored, scaffolded }?: {
+    restored?: {
+        mode: string;
+    };
+    scaffolded?: boolean;
+}): any;
+/**
+ * The team a session runs in (ALPD §42): the one the caller selects, else defaultTeam. Without
+ * any, the session is `custom`: its graph is settings' delegation and no supervisor watches it.
+ * Selecting `custom` is refused unless it is the team that would run anyway, so a client may send
+ * back the team session.preview named.
+ * @param {string} root
+ * @param {string | undefined} selected
+ * @param {{ mode: string, maxPeers?: number, supervisor?: boolean } | undefined} restored
+ * @param {{ library?: string, templates?: Record<string, string>, scaffold?: boolean }} [options]
+ *   scaffold: a missing settings file will be written by init before the session runs (a preview).
  * @returns {Promise<{ mode: string, maxPeers: number, supervisor: boolean, team?: Awaited<ReturnType<typeof resolveTeam>> }>}
  */
-export function resolveWorkflow(root: any, selected: any, restored: any, { library, templates }?: {}): Promise<{
+export function resolveWorkflow(root: string, selected: string | undefined, restored: {
+    mode: string;
+    maxPeers?: number;
+    supervisor?: boolean;
+} | undefined, { library, templates, scaffold }?: {
+    library?: string;
+    templates?: Record<string, string>;
+    scaffold?: boolean;
+}): Promise<{
     mode: string;
     maxPeers: number;
     supervisor: boolean;
     team?: Awaited<ReturnType<typeof resolveTeam>>;
 }>;
 export { teamOf as profileOf } from "./teams.js";
+/** The team `alp init` names in a new project's settings (`init.js`). */
+export const INIT_TEAM: "pho";
 import { resolveTeam } from './teams.js';

package/packages/core/dist/workflow.js

@@ -1,16 +1,23 @@
 // packages/core/src/workflow.js
 import path from "node:path";
-import { jsonObject } from "./resolver.js";
+import { jsonObject, optionalText } from "./resolver.js";
 import { applyProfile } from "./profiles.js";
 import { validateSettings } from "./validation.js";
 import { resolveTeam, teamOf } from "./teams.js";
 import { teamOf as teamOf2 } from "./teams.js";
-async function resolveWorkflow(root, selected, restored, { library, templates } = {}) {
-  const settings = await jsonObject(path.join(root, ".alp/settings.json"), "INVALID_SETTINGS");
+var INIT_TEAM = "pho";
+function defaultTeam(settings, { restored, scaffolded = false } = {}) {
+  return teamOf(restored?.mode ?? settings.workflow?.mode ?? (scaffolded ? INIT_TEAM : "custom"));
+}
+async function resolveWorkflow(root, selected, restored, { library, templates, scaffold = false } = {}) {
+  const file = path.join(root, ".alp/settings.json");
+  const settings = await jsonObject(file, "INVALID_SETTINGS");
   validateSettings(settings, ".alp/settings.json");
+  const scaffolded = scaffold && await optionalText(file) === void 0;
+  const fallback = defaultTeam(settings, { restored, scaffolded });
   const chosen = selected === void 0 ? void 0 : teamOf(selected);
-  if (chosen === "custom") throw new Error("Choose a team, such as pho (Ph\u1EDF) or cafe (Cafe)");
-  const mode = chosen ?? teamOf(restored?.mode ?? settings.workflow?.mode ?? "custom");
+  if (chosen === "custom" && fallback !== "custom") throw new Error("Choose a team, such as pho (Ph\u1EDF) or cafe (Cafe)");
+  const mode = chosen ?? fallback;
   if (restored && mode !== teamOf(restored.mode)) throw new Error("Cannot change team in an existing session");
   const team = mode === "custom" ? void 0 : applyProfile(await resolveTeam(root, mode, { library, templates }), (settings.team ?? settings.profile)?.[mode]);
   const maxPeers = restored?.maxPeers ?? settings.workflow?.maxPeers ?? team?.maxPeers ?? 2;
@@ -19,6 +26,8 @@ async function resolveWorkflow(root, selected, restored, { library, templates }
   return { mode, maxPeers, supervisor, ...team ? { team } : {} };
 }
 export {
+  INIT_TEAM,
+  defaultTeam,
   teamOf2 as profileOf,
   resolveWorkflow
 };