@alook/cli 0.0.101 → 0.0.103

package/dist/index.js

@@ -15,7 +15,7 @@ var __export = (target, all) => {
 };
 
 // src/index.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 
 // commands/register.ts
 import { Command } from "commander";
@@ -14605,7 +14605,7 @@ var DaemonPushMessageSchema = exports_external.discriminatedUnion("type", [
   exports_external.object({ type: exports_external.literal("daemon.evict"), workspaceId: exports_external.string() }),
   exports_external.object({ type: exports_external.literal("daemon.update"), version: exports_external.string() }),
   exports_external.object({ type: exports_external.literal("daemon.rescan") }),
-  exports_external.object({ type: exports_external.literal("daemon.kill"), workspaceId: exports_external.string(), taskId: exports_external.string(), targetTaskId: exports_external.string() })
+  exports_external.object({ type: exports_external.literal("daemon.kill"), workspaceId: exports_external.string(), agentId: exports_external.string().min(1), taskId: exports_external.string(), targetTaskId: exports_external.string() })
 ]);
 var RegisterResponseSchema = exports_external.object({
   runtimes: exports_external.array(exports_external.object({ id: exports_external.string() }))
@@ -14947,13 +14947,24 @@ var StudioMemberSchema = exports_external.object({
   description: exports_external.string().optional().default(""),
   instructions: exports_external.string().optional().default(""),
   avatar_url: exports_external.string().max(2000).nullable().optional(),
-  email_handle: exports_external.string().max(30).optional()
+  email_handle: exports_external.string().max(30).optional(),
+  relationship: exports_external.object({
+    leaderSees: exports_external.string(),
+    memberSees: exports_external.string()
+  }).optional()
 });
 var CreateStudioRequestSchema = exports_external.object({
   name: exports_external.string().max(100).optional(),
   scenario: exports_external.string().max(50).optional(),
   members: exports_external.array(StudioMemberSchema).min(1).max(4)
 }).refine((v) => v.members.some((m) => m.role === "leader"), { message: "at least one member must have the leader role" });
+var RecruitAgentRequestSchema = exports_external.object({
+  instructions: exports_external.string().min(1, "instructions is required"),
+  relationship: exports_external.string().min(1, "relationship is required"),
+  name: exports_external.string().optional(),
+  description: exports_external.string().optional().default(""),
+  model: exports_external.string().max(100).optional()
+});
 // ../../node_modules/.pnpm/drizzle-orm@0.45.2_@cloudflare+workers-types@4.20260524.1_@opentelemetry+api@1.9.1_bun-types@1.3.14_kysely@0.28.17/node_modules/drizzle-orm/entity.js
 var entityKind = Symbol.for("drizzle:entityKind");
 var hasOwnEntityKind = Symbol.for("drizzle:hasOwnEntityKind");
@@ -16852,9 +16863,6 @@ var agentSkill = sqliteTable("agent_skill", {
 // ../shared/src/db/queries/task.ts
 var DEFAULT_STALE_SECONDS = Number(process.env.ALOOK_STALE_DISPATCH_TIMEOUT_S) || 20;
 var DEFAULT_STALE_RUNNING_SECONDS = Number(process.env.ALOOK_STALE_RUNNING_TIMEOUT_S) || 3600;
-// ../shared/src/db/queries/task-message.ts
-var HIDDEN_STEP_TYPES = ["status", "log", "tool-result", "text"];
-var FIXED_PARAMS = 1 + HIDDEN_STEP_TYPES.length;
 // ../shared/src/utils/email.ts
 var DOMAIN = `@${process.env.ALOOK_DOMAIN || "alook.ai"}`;
 var RESERVED_HANDLES = new Set([
@@ -18827,6 +18835,23 @@ Upload files for your owner to review in the app.
 When your task includes attachments, their local paths are listed in the prompt JSON under "attachments".
 Use your Read tool to open them. Images and PDFs are read visually.
 ---
+`;
+  content += `
+### Agent Management
+Recruit new colleague agents directly from the CLI. The server auto-generates a name and email handle.
+- Run '${cmdPrefix()} agent recruit --instructions "<SYSTEM_PROMPT>" --relationship "<DELEGATION_CRITERIA>"'
+  - '--instructions' — the new agent's system prompt (what it does, how it behaves)
+  - '--relationship' — delegation criteria shown in both agents' COLLEAGUES section
+  - '--name <name>' (optional) — preferred name; server generates one if omitted
+  - '--description <text>' (optional) — agent description
+  - '--model <model>' (optional) — model override
+  - '--instructions-file <path>' — alternative: read instructions from a file (mutually exclusive with --instructions)
+  - '--relationship-file <path>' — alternative: read relationship from a file (mutually exclusive with --relationship)
+  - '--json' — output full JSON response
+- Example: '${cmdPrefix()} agent recruit --instructions "You are a QA engineer..." --relationship "DELEGATE when: code is ready for review"'
+- Output: 'Recruited Felix (felix@alook.ai) — ag_xK9mPq2z'
+- The new agent shares your runtime, is automatically linked as your colleague, and receives a welcome task.
+---
 `;
   content += `
 ### Calendar
@@ -18916,7 +18941,7 @@ function ensureSymlinks(workDir) {
       symlinkSync(CANONICAL_FILE, aliasPath);
     } catch (err) {
       const code = err?.code;
-      if (code === "EPERM" || code === "EACCES") {
+      if (code === "EEXIST") {} else if (code === "EPERM" || code === "EACCES") {
         copyFileSync(canonicalPath, aliasPath);
       } else {
         throw err;
@@ -20338,7 +20363,7 @@ function runScan() {
       const prevHash = readCacheHash(globalCachePath(scannerConfig.daemonId, runtime));
       if (prevHash !== hash2) {
         const skillItems = skills.map((s) => ({ name: s.name, description: s.description }));
-        log8.info(`Syncing global ${runtime} — ${skills.length} skills`);
+        log8.debug(`Syncing global ${runtime} — ${skills.length} skills`);
         const daemonId = scannerConfig.daemonId;
         const syncPromises = scannerConfig.workspaces.map((ws) => clientRef.syncSkills(ws.token, {
           scope: "global",
@@ -20364,7 +20389,7 @@ function runScan() {
       const prevHash = readCacheHash(agentCachePath(target.agentId, target.runtime));
       if (prevHash !== hash2) {
         const skillItems = skills.map((s) => ({ name: s.name, description: s.description }));
-        log8.info(`Syncing ${target.agentId}:${target.runtime} — ${skills.length} agent skills`);
+        log8.debug(`Syncing ${target.agentId}:${target.runtime} — ${skills.length} agent skills`);
         clientRef.syncSkills(target.token, {
           scope: "agent",
           agent_id: target.agentId,
@@ -20884,17 +20909,17 @@ async function startDaemon(profile, serverUrl) {
         break;
       case "daemon.kill": {
         const ws = workspaceStates.find((w) => w.workspaceId === msg.workspaceId);
-        if (ws) {
+        if (ws && !activeTasks.has(msg.taskId)) {
           const killTask = fromApiTask({
             id: msg.taskId,
-            agent_id: "",
+            agent_id: msg.agentId,
             runtime_id: "",
             conversation_id: "",
             workspace_id: ws.workspaceId,
             prompt: "",
-            status: "queued",
+            status: "dispatched",
             priority: 0,
-            dispatched_at: null,
+            dispatched_at: new Date().toISOString(),
             started_at: null,
             completed_at: null,
             result: null,
@@ -21254,9 +21279,16 @@ async function handleTask(client, config2, runtimeIndex, task, token, activeTask
   child.on("close", async (code) => {
     activeTasks.delete(task.id);
     if (code !== 0) {
+      const agentBaseDir = join11(config2.workspacesRoot, task.workspaceId, task.agentId, "workdir");
+      const killIntent = readKillIntent(agentBaseDir, task.id);
+      if (killIntent) {
+        log9.info(`Task ${task.id} exited due to kill intent — skipping failTask`);
+        clearKillIntent(agentBaseDir, task.id);
+        return;
+      }
       const msg = code === null ? `session-runner killed by signal (task ${task.id})` : `session-runner crashed (exit code ${code}, task ${task.id})`;
       log9.warn(msg);
-      const timelineDir = join11(config2.workspacesRoot, task.workspaceId, task.agentId, "workdir", ".context_timeline");
+      const timelineDir = join11(agentBaseDir, ".context_timeline");
       updateEntry(timelineDir, task.id, (entry) => {
         entry.pid = null;
         entry.status = "failed";
@@ -22311,19 +22343,67 @@ function issueCommand() {
   return cmd;
 }
 
-// commands/version.ts
+// commands/agent.ts
 import { Command as Command8 } from "commander";
+import { readFileSync as readFileSync12 } from "fs";
+function readField(opts, inlineName, fileName) {
+  if (opts.inline && opts.file) {
+    console.error(`Error: --${inlineName} and --${fileName} are mutually exclusive`);
+    process.exit(1);
+  }
+  if (opts.file)
+    return readFileSync12(opts.file, "utf-8");
+  return opts.inline ?? null;
+}
+function agentCommand() {
+  const cmd = new Command8("agent").description("Manage agents");
+  cmd.command("recruit").description("Recruit a new colleague agent").option("--agent_id <id>", "Agent ID (or set ALOOK_AGENT_ID env var)").option("--instructions <text>", "Instructions for the new agent (system prompt)").option("--instructions-file <path>", "Read instructions from a file").option("--relationship <text>", "Relationship/delegation instruction for the link").option("--relationship-file <path>", "Read relationship from a file").option("--name <name>", "Preferred name for the new agent (auto-generated if omitted)").option("--description <text>", "Agent description").option("--model <model>", "Model override").option("--json", "Output as JSON").action(async (opts, command) => {
+    const instructions = readField({ inline: opts.instructions, file: opts.instructionsFile }, "instructions", "instructions-file");
+    if (!instructions) {
+      console.error("Error: --instructions or --instructions-file is required");
+      process.exit(1);
+    }
+    const relationship = readField({ inline: opts.relationship, file: opts.relationshipFile }, "relationship", "relationship-file");
+    if (!relationship) {
+      console.error("Error: --relationship or --relationship-file is required");
+      process.exit(1);
+    }
+    const agentId = resolveAgentId(opts);
+    const { serverUrl, token, workspaceId } = resolveClientOpts(command, { agentId });
+    const client = new APIClient(serverUrl, token, workspaceId);
+    const body = { instructions, relationship };
+    if (opts.name)
+      body.name = opts.name;
+    if (opts.description)
+      body.description = opts.description;
+    if (opts.model)
+      body.model = opts.model;
+    try {
+      const res = await client.postJSON(`/api/agents/recruit?agentId=${encodeURIComponent(agentId)}`, body);
+      if (opts.json)
+        return printJSON(res);
+      console.log(`Recruited ${res.agent.name} (${res.agent.email}) — ${res.agent.id}`);
+    } catch (err) {
+      console.error(`Error: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+  });
+  return cmd;
+}
+
+// commands/version.ts
+import { Command as Command9 } from "commander";
 function versionCommand() {
-  const cmd = new Command8("version").description("Show CLI version").action(() => {
+  const cmd = new Command9("version").description("Show CLI version").action(() => {
     console.log(`alook version ${getCurrentVersion()}`);
   });
   return cmd;
 }
 
 // commands/update.ts
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 function updateCommand() {
-  const cmd = new Command9("update").description("Update CLI to the latest version").action(async () => {
+  const cmd = new Command10("update").description("Update CLI to the latest version").action(async () => {
     const current = getCurrentVersion();
     console.log(`Current version: ${current}`);
     const latest = await fetchLatestVersion();
@@ -22357,18 +22437,18 @@ ${result.output}`);
 }
 
 // commands/sync.ts
-import { Command as Command10 } from "commander";
-import { readFileSync as readFileSync12 } from "fs";
+import { Command as Command11 } from "commander";
+import { readFileSync as readFileSync13 } from "fs";
 import { basename as basename3 } from "path";
 function syncCommand() {
-  const cmd = new Command10("sync").description("File sync utilities");
+  const cmd = new Command11("sync").description("File sync utilities");
   cmd.command("upload-artifact").description("Upload a file artifact to a conversation").option("--agent_id <id>", "Agent ID").requiredOption("--conversation_id <id>", "Conversation ID").requiredOption("--file <path>", "Path to file to upload").action(async (opts, command) => {
     const agentId = resolveAgentId(opts);
     const { serverUrl, token, workspaceId } = resolveClientOpts(command, { agentId });
     const client = new APIClient(serverUrl, token, workspaceId);
     let bytes;
     try {
-      bytes = readFileSync12(opts.file);
+      bytes = readFileSync13(opts.file);
     } catch (err) {
       console.error(`Error: cannot read file "${opts.file}": ${err.message}`);
       process.exit(1);
@@ -22391,7 +22471,7 @@ function syncCommand() {
 }
 
 // src/index.ts
-var program = new Command11;
+var program = new Command12;
 program.name("alook").description("Alook CLI").option("--server <url>", "Server URL").option("--profile <name>", "Profile name");
 program.addCommand(registerCommand());
 program.addCommand(statusCommand());
@@ -22399,6 +22479,7 @@ program.addCommand(daemonCommand2());
 program.addCommand(emailCommand());
 program.addCommand(calendarCommand());
 program.addCommand(issueCommand());
+program.addCommand(agentCommand());
 program.addCommand(configCommand());
 program.addCommand(versionCommand());
 program.addCommand(updateCommand());

package/dist/session-runner.js

@@ -14472,7 +14472,7 @@ var DaemonPushMessageSchema = exports_external.discriminatedUnion("type", [
   exports_external.object({ type: exports_external.literal("daemon.evict"), workspaceId: exports_external.string() }),
   exports_external.object({ type: exports_external.literal("daemon.update"), version: exports_external.string() }),
   exports_external.object({ type: exports_external.literal("daemon.rescan") }),
-  exports_external.object({ type: exports_external.literal("daemon.kill"), workspaceId: exports_external.string(), taskId: exports_external.string(), targetTaskId: exports_external.string() })
+  exports_external.object({ type: exports_external.literal("daemon.kill"), workspaceId: exports_external.string(), agentId: exports_external.string().min(1), taskId: exports_external.string(), targetTaskId: exports_external.string() })
 ]);
 var RegisterResponseSchema = exports_external.object({
   runtimes: exports_external.array(exports_external.object({ id: exports_external.string() }))
@@ -14814,13 +14814,24 @@ var StudioMemberSchema = exports_external.object({
   description: exports_external.string().optional().default(""),
   instructions: exports_external.string().optional().default(""),
   avatar_url: exports_external.string().max(2000).nullable().optional(),
-  email_handle: exports_external.string().max(30).optional()
+  email_handle: exports_external.string().max(30).optional(),
+  relationship: exports_external.object({
+    leaderSees: exports_external.string(),
+    memberSees: exports_external.string()
+  }).optional()
 });
 var CreateStudioRequestSchema = exports_external.object({
   name: exports_external.string().max(100).optional(),
   scenario: exports_external.string().max(50).optional(),
   members: exports_external.array(StudioMemberSchema).min(1).max(4)
 }).refine((v) => v.members.some((m) => m.role === "leader"), { message: "at least one member must have the leader role" });
+var RecruitAgentRequestSchema = exports_external.object({
+  instructions: exports_external.string().min(1, "instructions is required"),
+  relationship: exports_external.string().min(1, "relationship is required"),
+  name: exports_external.string().optional(),
+  description: exports_external.string().optional().default(""),
+  model: exports_external.string().max(100).optional()
+});
 // ../../node_modules/.pnpm/drizzle-orm@0.45.2_@cloudflare+workers-types@4.20260524.1_@opentelemetry+api@1.9.1_bun-types@1.3.14_kysely@0.28.17/node_modules/drizzle-orm/entity.js
 var entityKind = Symbol.for("drizzle:entityKind");
 var hasOwnEntityKind = Symbol.for("drizzle:hasOwnEntityKind");
@@ -16719,9 +16730,6 @@ var agentSkill = sqliteTable("agent_skill", {
 // ../shared/src/db/queries/task.ts
 var DEFAULT_STALE_SECONDS = Number(process.env.ALOOK_STALE_DISPATCH_TIMEOUT_S) || 20;
 var DEFAULT_STALE_RUNNING_SECONDS = Number(process.env.ALOOK_STALE_RUNNING_TIMEOUT_S) || 3600;
-// ../shared/src/db/queries/task-message.ts
-var HIDDEN_STEP_TYPES = ["status", "log", "tool-result", "text"];
-var FIXED_PARAMS = 1 + HIDDEN_STEP_TYPES.length;
 // ../shared/src/utils/email.ts
 var DOMAIN = `@${process.env.ALOOK_DOMAIN || "alook.ai"}`;
 var RESERVED_HANDLES = new Set([
@@ -18165,6 +18173,23 @@ Upload files for your owner to review in the app.
 When your task includes attachments, their local paths are listed in the prompt JSON under "attachments".
 Use your Read tool to open them. Images and PDFs are read visually.
 ---
+`;
+  content += `
+### Agent Management
+Recruit new colleague agents directly from the CLI. The server auto-generates a name and email handle.
+- Run '${cmdPrefix()} agent recruit --instructions "<SYSTEM_PROMPT>" --relationship "<DELEGATION_CRITERIA>"'
+  - '--instructions' — the new agent's system prompt (what it does, how it behaves)
+  - '--relationship' — delegation criteria shown in both agents' COLLEAGUES section
+  - '--name <name>' (optional) — preferred name; server generates one if omitted
+  - '--description <text>' (optional) — agent description
+  - '--model <model>' (optional) — model override
+  - '--instructions-file <path>' — alternative: read instructions from a file (mutually exclusive with --instructions)
+  - '--relationship-file <path>' — alternative: read relationship from a file (mutually exclusive with --relationship)
+  - '--json' — output full JSON response
+- Example: '${cmdPrefix()} agent recruit --instructions "You are a QA engineer..." --relationship "DELEGATE when: code is ready for review"'
+- Output: 'Recruited Felix (felix@alook.ai) — ag_xK9mPq2z'
+- The new agent shares your runtime, is automatically linked as your colleague, and receives a welcome task.
+---
 `;
   content += `
 ### Calendar
@@ -18254,7 +18279,7 @@ function ensureSymlinks(workDir) {
       symlinkSync(CANONICAL_FILE, aliasPath);
     } catch (err) {
       const code = err?.code;
-      if (code === "EPERM" || code === "EACCES") {
+      if (code === "EEXIST") {} else if (code === "EPERM" || code === "EACCES") {
         copyFileSync(canonicalPath, aliasPath);
       } else {
         throw err;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alook/cli",
-  "version": "0.0.101",
+  "version": "0.0.103",
   "description": "Alook CLI — Enable Your Person Colleague",
   "license": "Apache-2.0",
   "homepage": "https://github.com/alookai/alook#readme",