pi-landstrip 0.17.39 → 0.17.41

package/README.md

@@ -111,8 +111,10 @@ global or trusted-project concurrency limit.
 
 The `/agents` selector provides OpenCode-compatible `build` and `plan` roles by
 default. Build has normal development access; plan asks before shell commands
-and file changes. The selection controls the root system prompt and permissions
-and is restored with the session.
+and file changes. Built-in colors match OpenCode's agent palette (`#034cff` for
+build, `#a753ae` for plan) and appear in the status line and agent selectors.
+The selection controls the root system prompt and permissions and is restored
+with the session.
 
 ## Subagents
 
@@ -216,14 +218,15 @@ Sandbox policy remains in `~/.pi/agent/sandbox.json` and `.pi/sandbox.json`. Pi'
 }
 ```
 
-Optional OpenCode import flags live in `subagents.json` as top-level `opencode`:
+OpenCode Markdown agent import flags live in `subagents.json` as top-level
+`opencode` (both default to `true`):
 
 ```json
 {
   "maxSubagents": 0,
   "opencode": {
-    "showGlobalAgents": false,
-    "showLocalAgents": false
+    "showGlobalAgents": true,
+    "showLocalAgents": true
   },
   "subagents": {
     "agent": {}
@@ -231,18 +234,17 @@ Optional OpenCode import flags live in `subagents.json` as top-level `opencode`:
 }
 ```
 
-Both flags default to `false`. When enabled:
-
 - `showGlobalAgents` imports Markdown agents from the OpenCode global config
   directory (`$OPENCODE_CONFIG_DIR`, or `$XDG_CONFIG_HOME/opencode`, or
   `~/.config/opencode`) under `agent/` and `agents/`.
 - `showLocalAgents` imports Markdown agents from the trusted project's
   `.opencode/agent/` and `.opencode/agents/` directories.
 
-OpenCode local agents override OpenCode global agents. Pi agent definitions
-from `subagents.json` (built-in, global, and local) take precedence over OpenCode
-imports with the same name; conflicts are silent. Local OpenCode agents are
-skipped when the project is untrusted, regardless of the flag.
+Set a flag to `false` to disable that source. OpenCode local agents override
+OpenCode global agents. Pi agent definitions from `subagents.json` (built-in,
+global, and local) take precedence over OpenCode imports with the same name;
+conflicts are silent. Local OpenCode agents are skipped when the project is
+untrusted, regardless of the flag.
 
 `subagents.json` accepts top-level `maxSubagents`, `opencode`, and `subagents`;
 sandbox fields belong in `sandbox.json`.
@@ -320,13 +322,18 @@ The packaged default is 0, which removes the `task` tool while retaining primary
 roles. There is no separate subagent enable switch. The Settings tab in
 `/agents` edits this limit for global and trusted-project configuration.
 
-Agent modes, hidden/disabled agents, prompts, and ordered `allow`/`ask`/`deny`
-permissions apply to primary agents and subagents. Subagent workers also honor
-model selection, supported Pi thinking-level variants, and step limits. Primary
-agent activation currently changes the prompt and permissions only. Later
-matching permission rules win. Put provider-specific values under `options`;
-unknown agent fields are rejected. Agent permissions cannot weaken an enabled
-OS sandbox, grant filesystem access, or grant network access.
+Agent modes, hidden/disabled agents, prompts, colors, and ordered
+`allow`/`ask`/`deny` permissions apply to primary agents and subagents. Prompt
+strings may include OpenCode-style `{file:path}` tokens; relative paths resolve
+against the `subagents.json` file that defines them. `color` accepts `#RRGGBB`
+or OpenCode theme names (`primary`, `secondary`, `accent`, `success`, `warning`,
+`error`, `info`). `hidden` only hides an agent from user-facing primary pickers;
+the model can still invoke a hidden subagent via `task`. Subagent workers also
+honor model selection, supported Pi thinking-level variants, and step limits.
+Primary agent activation currently changes the prompt and permissions only.
+Later matching permission rules win. Put provider-specific values under
+`options`; unknown agent fields are rejected. Agent permissions cannot weaken an
+enabled OS sandbox, grant filesystem access, or grant network access.
 
 ## Configuration migration
 

package/dist/index.ts

@@ -6,7 +6,7 @@ import {
   existsSync as existsSync5,
   mkdirSync as mkdirSync3,
   mkdtempSync as mkdtempSync2,
-  readFileSync as readFileSync5,
+  readFileSync as readFileSync6,
   realpathSync as realpathSync2,
   rmSync as rmSync2,
   writeFileSync as writeFileSync3
@@ -19,7 +19,7 @@ import {
   Socket as NetSocket
 } from "node:net";
 import { homedir as homedir4, tmpdir as tmpdir2 } from "node:os";
-import { basename as basename3, dirname as dirname3, isAbsolute as isAbsolute2, join as join6, parse, resolve as resolve2 } from "node:path";
+import { basename as basename3, dirname as dirname3, isAbsolute as isAbsolute3, join as join6, parse, resolve as resolve3 } from "node:path";
 import { StringDecoder as StringDecoder2 } from "node:string_decoder";
 import { fileURLToPath as fileURLToPath3, URL } from "node:url";
 import {
@@ -74,14 +74,14 @@ import {
   lstatSync,
   mkdirSync as mkdirSync2,
   mkdtempSync,
-  readFileSync as readFileSync4,
+  readFileSync as readFileSync5,
   readlinkSync,
   realpathSync,
   rmSync,
   writeFileSync as writeFileSync2
 } from "node:fs";
 import { homedir as homedir3, tmpdir } from "node:os";
-import { basename as basename2, dirname as dirname2, isAbsolute, join as join5, relative as relative2, resolve, sep as sep2 } from "node:path";
+import { basename as basename2, dirname as dirname2, isAbsolute as isAbsolute2, join as join5, relative as relative2, resolve as resolve2, sep as sep2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import {
   getAgentDir as getAgentDir3,
@@ -92,20 +92,21 @@ import { matchesKey, Text, truncateToWidth as truncateToWidth2 } from "@earendil
 import { Type } from "typebox";
 
 // agents.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
+import { existsSync as existsSync3, readFileSync as readFileSync4 } from "node:fs";
 import { join as join4 } from "node:path";
 import { minimatch } from "minimatch";
 import { getAgentDir as getAgentDir2 } from "@earendil-works/pi-coding-agent";
 
 // config.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "node:fs";
 import { dirname, join as join2 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { getAgentDir, withFileMutationQueue } from "@earendil-works/pi-coding-agent";
 
 // util.ts
+import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { isAbsolute, join, resolve } from "node:path";
 function expandHomePath(path) {
   if (path === "~" || path === "$HOME")
     return homedir();
@@ -115,20 +116,85 @@ function expandHomePath(path) {
     return join(homedir(), path.slice(6));
   return path;
 }
+function expandFileReferences(text, baseDir) {
+  if (!text.includes("{file:"))
+    return text;
+  const matches = Array.from(text.matchAll(/\{file:[^}]+\}/g));
+  if (matches.length === 0)
+    return text;
+  let out = "";
+  let cursor = 0;
+  for (const match of matches) {
+    const token = match[0];
+    const index = match.index ?? 0;
+    out += text.slice(cursor, index);
+    let filePath = token.slice("{file:".length, -1);
+    if (filePath.startsWith("~/"))
+      filePath = join(homedir(), filePath.slice(2));
+    const resolved = isAbsolute(filePath) ? filePath : resolve(baseDir, filePath);
+    try {
+      out += readFileSync(resolved, "utf8").trim();
+    } catch (error) {
+      const detail = error instanceof Error && "code" in error && error.code === "ENOENT" ? `${resolved} does not exist` : error instanceof Error ? error.message : String(error);
+      throw new Error(`bad file reference: "${token}" ${detail}`);
+    }
+    cursor = index + token.length;
+  }
+  out += text.slice(cursor);
+  return out;
+}
 function formatError(error) {
   return error instanceof Error ? error.message : String(error);
 }
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+var OPENCODE_THEME_COLORS = new Set([
+  "primary",
+  "secondary",
+  "accent",
+  "success",
+  "warning",
+  "error",
+  "info"
+]);
+var THEME_COLOR_ALIASES = {
+  primary: "accent",
+  secondary: "muted",
+  accent: "accent",
+  success: "success",
+  warning: "warning",
+  error: "error",
+  info: "accent"
+};
+function isAgentColor(value) {
+  if (/^#[0-9a-fA-F]{6}$/.test(value))
+    return true;
+  return OPENCODE_THEME_COLORS.has(value);
+}
+function hexFg(hex, text) {
+  const r = Number.parseInt(hex.slice(1, 3), 16);
+  const g = Number.parseInt(hex.slice(3, 5), 16);
+  const b = Number.parseInt(hex.slice(5, 7), 16);
+  return `\x1B[38;2;${r};${g};${b}m${text}\x1B[39m`;
+}
+function colorizeAgentText(color, text, themeFg, fallback = "accent") {
+  if (!color)
+    return themeFg ? themeFg(fallback, text) : text;
+  if (color.startsWith("#"))
+    return hexFg(color, text);
+  if (!themeFg)
+    return text;
+  return themeFg(THEME_COLOR_ALIASES[color] ?? fallback, text);
+}
 
 class AsyncQueue {
   tail = Promise.resolve();
   async acquire(signal, cancellationMessage = "Request cancelled") {
     let release;
     const previous = this.tail;
-    this.tail = new Promise((resolve) => {
-      release = resolve;
+    this.tail = new Promise((resolve2) => {
+      release = resolve2;
     });
     if (!signal) {
       await previous;
@@ -161,8 +227,8 @@ class AsyncQueue {
 var MAX_SUBAGENTS = 16;
 var packageDir = dirname(fileURLToPath(import.meta.url));
 var DEFAULT_OPENCODE = {
-  showGlobalAgents: false,
-  showLocalAgents: false
+  showGlobalAgents: true,
+  showLocalAgents: true
 };
 var OPENCODE_KEYS = new Set(["showGlobalAgents", "showLocalAgents"]);
 function readBooleanField(section, key, path) {
@@ -192,12 +258,28 @@ function normalizeOpenCode(value, path) {
     result.showLocalAgents = showLocalAgents;
   return result;
 }
+function expandAgentPromptReferences(config, path) {
+  if (!isRecord2(config.subagents) || !isRecord2(config.subagents.agent))
+    return;
+  const baseDir = dirname(path);
+  for (const [name, value] of Object.entries(config.subagents.agent)) {
+    if (!isRecord2(value) || typeof value.prompt !== "string")
+      continue;
+    if (!value.prompt.includes("{file:"))
+      continue;
+    try {
+      value.prompt = expandFileReferences(value.prompt, baseDir);
+    } catch (error) {
+      throw new Error(`${path}: agent ${name}: ${formatError(error)}`);
+    }
+  }
+}
 function readConfig(path, isGlobal = false) {
   if (!existsSync(path))
     return {};
   let value;
   try {
-    value = JSON.parse(readFileSync(path, "utf8"));
+    value = JSON.parse(readFileSync2(path, "utf8"));
   } catch (error) {
     const message = formatError(error);
     throw new Error(`${path}: ${message}`);
@@ -233,6 +315,7 @@ function readConfig(path, isGlobal = false) {
   if ("opencode" in value) {
     config.opencode = normalizeOpenCode(value.opencode, `${path}: opencode`);
   }
+  expandAgentPromptReferences(config, path);
   return config;
 }
 function mergeValue(base, override) {
@@ -306,7 +389,7 @@ function loadLandstripConfig(cwd, includeProject = true, agentDir = getAgentDir(
 }
 
 // opencode-agents.ts
-import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2, statSync } from "node:fs";
+import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync3, statSync } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { basename, extname, join as join3, relative, sep } from "node:path";
 import { parse as parseYaml } from "yaml";
@@ -449,7 +532,7 @@ function loadAgentsFromDir(dir, source, agents, diagnostics) {
     const root = join3(dir, subdir);
     for (const filePath of listMarkdownFiles(root)) {
       try {
-        const content = readFileSync2(filePath, "utf8");
+        const content = readFileSync3(filePath, "utf8");
         const { data, body } = parseFrontmatter(content);
         const name = agentNameFromPath(dir, filePath);
         if (!name) {
@@ -528,7 +611,7 @@ function legacyConfigWarnings(piAgentDir) {
   if (!existsSync3(path))
     return [];
   try {
-    const value = JSON.parse(readFileSync3(path, "utf8"));
+    const value = JSON.parse(readFileSync4(path, "utf8"));
     if (!isRecord2(value))
       return [];
     const fields = ["agent", "permission", "subagents", "maxSubagents", "landstrip"].filter((field) => value[field] !== undefined);
@@ -542,11 +625,14 @@ function legacyConfigWarnings(piAgentDir) {
   }
 }
 function normalizeAgent(name, raw, source) {
-  for (const field of ["description", "prompt", "model", "variant"]) {
+  for (const field of ["description", "prompt", "model", "variant", "color"]) {
     if (raw[field] !== undefined && typeof raw[field] !== "string") {
       throw new Error(`agent ${name} ${field} must be a string`);
     }
   }
+  if (typeof raw.color === "string" && !isAgentColor(raw.color)) {
+    throw new Error(`agent ${name} color must be #RRGGBB or one of primary, secondary, accent, success, warning, error, info`);
+  }
   for (const field of ["hidden", "disable"]) {
     if (raw[field] !== undefined && typeof raw[field] !== "boolean") {
       throw new Error(`agent ${name} ${field} must be a boolean`);
@@ -586,6 +672,7 @@ function normalizeAgent(name, raw, source) {
     model: typeof raw.model === "string" ? raw.model : undefined,
     variant: typeof raw.variant === "string" ? raw.variant : undefined,
     hidden: raw.hidden === true,
+    color: typeof raw.color === "string" ? raw.color : undefined,
     steps: typeof raw.steps === "number" ? raw.steps : undefined,
     permissions: normalizePermissions(raw.permission),
     providerOptions
@@ -721,7 +808,7 @@ function defaultSpawn(command, args, options) {
   return spawn(command, [...args], options);
 }
 function delay(milliseconds) {
-  return new Promise((resolve) => setTimeout(resolve, milliseconds));
+  return new Promise((resolve2) => setTimeout(resolve2, milliseconds));
 }
 
 class RpcProcess {
@@ -774,19 +861,19 @@ class RpcProcess {
     });
     child.stdin.on("error", (error) => this.handleChildError(child, error, "RPC stdin error"));
     child.on("error", (error) => this.handleChildError(child, error, "RPC process error"));
-    this.exitPromise = new Promise((resolve) => {
+    this.exitPromise = new Promise((resolve2) => {
       child.once("exit", (code, signal) => {
         if (this.child === child) {
           this.child = null;
           this.failAll(new Error(this.exitMessage(code, signal)));
         }
-        resolve();
+        resolve2();
       });
     });
-    await new Promise((resolve, reject) => {
+    await new Promise((resolve2, reject) => {
       const onSpawn = () => {
         cleanup();
-        resolve();
+        resolve2();
       };
       const onError = (error) => {
         cleanup();
@@ -830,12 +917,12 @@ class RpcProcess {
     if (this.fatalError)
       throw this.fatalError;
     const id = `rpc-${++this.nextRequestId}`;
-    const response = await new Promise((resolve, reject) => {
+    const response = await new Promise((resolve2, reject) => {
       const timer = setTimeout(() => {
         this.pending.delete(id);
         reject(this.withStderr(`Timed out waiting for ${type} response`));
       }, this.options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS);
-      this.pending.set(id, { command: type, resolve, reject, timer });
+      this.pending.set(id, { command: type, resolve: resolve2, reject, timer });
       this.write({ ...fields, id, type }, (error) => {
         if (!error)
           return;
@@ -1035,12 +1122,12 @@ class RpcProcess {
   }
   waitForAgentSettled() {
     let waiter;
-    const promise = new Promise((resolve, reject) => {
+    const promise = new Promise((resolve2, reject) => {
       const timer = setTimeout(() => {
         this.settledWaiters.delete(waiter);
         reject(this.withStderr("Timed out waiting for agent_settled"));
       }, this.options.settleTimeoutMs ?? DEFAULT_SETTLE_TIMEOUT_MS);
-      waiter = { resolve, reject, timer };
+      waiter = { resolve: resolve2, reject, timer };
       this.settledWaiters.add(waiter);
     });
     return {
@@ -1186,7 +1273,7 @@ function resolvePiPackage() {
 }
 function readPiPackage(pkgPath) {
   try {
-    const value = JSON.parse(readFileSync4(pkgPath, "utf8"));
+    const value = JSON.parse(readFileSync5(pkgPath, "utf8"));
     if (!isRecord2(value) || value.name !== "@earendil-works/pi-coding-agent" || typeof value.version !== "string") {
       return;
     }
@@ -1350,7 +1437,7 @@ class Semaphore {
       this.active += 1;
       return () => this.release();
     }
-    await new Promise((resolve2, reject) => {
+    await new Promise((resolve3, reject) => {
       const abort = () => {
         const index = this.waiters.indexOf(start);
         if (index >= 0)
@@ -1360,7 +1447,7 @@ class Semaphore {
       const start = () => {
         signal?.removeEventListener("abort", abort);
         this.active += 1;
-        resolve2();
+        resolve3();
       };
       this.waiters.push(start);
       signal?.addEventListener("abort", abort, { once: true });
@@ -1508,7 +1595,7 @@ function canonicalPermissionPath(path, seen = new Set) {
         if (seen.has(existing))
           return path;
         seen.add(existing);
-        const target = resolve(dirname2(existing), readlinkSync(existing), ...missing);
+        const target = resolve2(dirname2(existing), readlinkSync(existing), ...missing);
         return canonicalPermissionPath(target, seen);
       }
       break;
@@ -1521,7 +1608,7 @@ function canonicalPermissionPath(path, seen = new Set) {
     }
   }
   try {
-    return resolve(realpathSync(existing), ...missing);
+    return resolve2(realpathSync(existing), ...missing);
   } catch {
     return path;
   }
@@ -1536,10 +1623,10 @@ function permissionResource(tool, input, cwd) {
   }
   if (typeof input.path !== "string")
     return "*";
-  const projectRoot = canonicalPermissionPath(resolve(cwd));
-  const absolutePath = canonicalPermissionPath(resolve(cwd, input.path));
+  const projectRoot = canonicalPermissionPath(resolve2(cwd));
+  const absolutePath = canonicalPermissionPath(resolve2(cwd, input.path));
   const projectPath = relative2(projectRoot, absolutePath);
-  if (projectPath && !isAbsolute(projectPath) && !projectPath.startsWith(`..${sep2}`) && projectPath !== "..") {
+  if (projectPath && !isAbsolute2(projectPath) && !projectPath.startsWith(`..${sep2}`) && projectPath !== "..") {
     return projectPath.split(sep2).join("/");
   }
   return absolutePath.split(sep2).join("/");
@@ -1801,7 +1888,7 @@ ${this.primaryAgent.prompt}` };
             const cursor = index === selectedAgent ? theme.fg("accent", "›") : " ";
             const name = `@${agent.name}`.padEnd(nameWidth);
             const description = `${agent.description ?? "No description"}${agent.hidden ? " [hidden]" : ""}`;
-            lines2.push(`${cursor} ${theme.fg("accent", name)} ${theme.fg("dim", agent.source.padEnd(8))} ${theme.fg("text", description)}`);
+            lines2.push(`${cursor} ${colorizeAgentText(agent.color, name, (c, t) => theme.fg(c, t))} ${theme.fg("dim", agent.source.padEnd(8))} ${theme.fg("text", description)}`);
           }
           if (agents.length === 0)
             lines2.push("  No subagent types are configured.");
@@ -1950,7 +2037,7 @@ ${this.primaryAgent.prompt}` };
   createTaskTool(parentTask, callerRules, boundCtx) {
     const cwd = boundCtx?.cwd ?? process.cwd();
     const catalog = this.loadCatalog(cwd, getAgentDir3(), boundCtx ? isProjectTrusted(boundCtx) : false);
-    const agents = availableSubagents(catalog).filter((agent) => !agent.hidden && permissionDecision(callerRules ?? catalog.permissions, "task", agent.name) !== "deny");
+    const agents = availableSubagents(catalog).filter((agent) => permissionDecision(callerRules ?? catalog.permissions, "task", agent.name) !== "deny");
     const descriptions = agents.map((agent) => `${agent.name}: ${agent.description ?? "No description"}`).join(`
 `);
     return {
@@ -2772,7 +2859,7 @@ ${renderTaskResult(task.id, failed ? "error" : "completed", value)}`;
     if (persist)
       this.pi.appendEntry(PRIMARY_AGENT_ENTRY, { name: agent.name });
     if (ctx.hasUI) {
-      ctx.ui.setStatus("landstrip-agent", `@${agent.name}`);
+      ctx.ui.setStatus("landstrip-agent", colorizeAgentText(agent.color, `@${agent.name}`));
       if (persist)
         ctx.ui.notify(`Primary agent: ${agent.name}`, "info");
     }
@@ -2896,18 +2983,18 @@ function loadSandboxConfig(cwd, includeProject) {
   if (!existsSync5(globalConfigPath)) {
     const templatePath = join6(packageDir3, "sandbox.json");
     mkdirSync3(dirname3(globalConfigPath), { recursive: true });
-    writeFileSync3(globalConfigPath, readFileSync5(templatePath, "utf-8"), "utf-8");
+    writeFileSync3(globalConfigPath, readFileSync6(templatePath, "utf-8"), "utf-8");
   }
-  let globalConfig = JSON.parse(readFileSync5(join6(packageDir3, "sandbox.json"), "utf-8"));
+  let globalConfig = JSON.parse(readFileSync6(join6(packageDir3, "sandbox.json"), "utf-8"));
   try {
-    const override = JSON.parse(readFileSync5(globalConfigPath, "utf-8"));
+    const override = JSON.parse(readFileSync6(globalConfigPath, "utf-8"));
     globalConfig = deepMerge(globalConfig, override);
   } catch (error) {
     console.error(`Warning: Could not parse ${globalConfigPath}: ${error}`);
   }
   if (includeProject && existsSync5(projectConfigPath)) {
     try {
-      const projectConfig = JSON.parse(readFileSync5(projectConfigPath, "utf-8"));
+      const projectConfig = JSON.parse(readFileSync6(projectConfigPath, "utf-8"));
       const merged = deepMerge(globalConfig, projectConfig);
       merged.windows.backend = globalConfig.windows.backend;
       return merged;
@@ -2985,7 +3072,7 @@ function readOrEmptyConfig(configPath) {
   if (!existsSync5(configPath))
     return {};
   try {
-    return JSON.parse(readFileSync5(configPath, "utf-8"));
+    return JSON.parse(readFileSync6(configPath, "utf-8"));
   } catch {
     return {};
   }
@@ -3064,7 +3151,7 @@ function shouldPromptForWrite(path, allowWrite, cwd) {
   return allowWrite.length === 0 || !matchesPattern(path, allowWrite, cwd);
 }
 function expandPath(filePath, cwd) {
-  return resolve2(cwd, expandHomePath(filePath));
+  return resolve3(cwd, expandHomePath(filePath));
 }
 function canonicalizePath(filePath, cwd) {
   const abs = expandPath(filePath, cwd);
@@ -3081,7 +3168,7 @@ function canonicalizePath(filePath, cwd) {
       probe = parent;
     }
     try {
-      return resolve2(realpathSync2.native(probe), ...tail);
+      return resolve3(realpathSync2.native(probe), ...tail);
     } catch {
       return abs;
     }
@@ -3104,7 +3191,7 @@ function matchesPattern(filePath, patterns, cwd) {
 }
 function normalizeBlockedPath(path, cwd) {
   const nativePath = process.platform === "win32" && /^\/[a-zA-Z](?:\/|$)/.test(path) ? `${path[1]}:${path.slice(2)}` : path;
-  return canonicalizePath(isAbsolute2(nativePath) ? nativePath : join6(cwd, nativePath), cwd);
+  return canonicalizePath(isAbsolute3(nativePath) ? nativePath : join6(cwd, nativePath), cwd);
 }
 function pathUnderDirectory(filePath, dir) {
   const normalizedFilePath = normalizePathSeparators(filePath);
@@ -3326,13 +3413,13 @@ async function stopPreparedChild(child) {
   child.kill("SIGKILL");
   if (child.exitCode !== null || child.signalCode !== null)
     return;
-  await new Promise((resolve3) => {
+  await new Promise((resolve4) => {
     let settleTimer;
     const done = () => {
       if (settleTimer)
         clearTimeout(settleTimer);
       child.removeListener("exit", done);
-      resolve3();
+      resolve4();
     };
     child.once("exit", done);
     settleTimer = setTimeout(done, 1000);
@@ -3545,7 +3632,7 @@ function createLandstripIntegration(options = {}) {
     if (!id)
       throw new Error("Worker extension id must not be empty");
     const requestedEntry = extension.entry.startsWith("file:") ? fileURLToPath3(extension.entry) : extension.entry;
-    if (!isAbsolute2(requestedEntry)) {
+    if (!isAbsolute3(requestedEntry)) {
       throw new Error("Worker extension entry must be an absolute path or file URL");
     }
     if (!existsSync5(requestedEntry)) {
@@ -3599,11 +3686,11 @@ function createLandstripIntegration(options = {}) {
   function getEffectiveDenyRead(config, cwd) {
     if (process.platform !== "win32")
       return config.filesystem.denyRead;
-    const volumeRoot = parse(resolve2(cwd)).root;
+    const volumeRoot = parse(resolve3(cwd)).root;
     return [...new Set([...config.filesystem.denyRead, volumeRoot])];
   }
   function hasBaselineWindowsApplicationAccess(filePath) {
-    const normalizedPath = normalizePathSeparators(resolve2(filePath)).toLowerCase();
+    const normalizedPath = normalizePathSeparators(resolve3(filePath)).toLowerCase();
     const systemRoots = [
       process.env.ProgramFiles,
       process.env["ProgramFiles(x86)"],
@@ -3613,13 +3700,13 @@ function createLandstripIntegration(options = {}) {
     return systemRoots.some((root) => {
       if (!root)
         return false;
-      return pathUnderDirectory(normalizedPath, normalizePathSeparators(resolve2(root)).toLowerCase());
+      return pathUnderDirectory(normalizedPath, normalizePathSeparators(resolve3(root)).toLowerCase());
     });
   }
   function withWindowsProcessReadAccess(allowances, command, cwd, additionalPaths = []) {
     if (process.platform !== "win32")
       return allowances;
-    const executable = resolve2(cwd, command);
+    const executable = resolve3(cwd, command);
     const executablePaths = hasBaselineWindowsApplicationAccess(executable) ? [] : [executable];
     return {
       ...allowances,
@@ -3833,7 +3920,7 @@ function createLandstripIntegration(options = {}) {
     }
     const server = createServer(handleClient);
     let stopped = false;
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       const listen = (port) => {
         server.once("error", (error) => {
           if (error.code === "EADDRINUSE" && portRange && port < portRange.high) {
@@ -3845,7 +3932,7 @@ function createLandstripIntegration(options = {}) {
         server.listen(port, "127.0.0.1", () => {
           server.removeAllListeners("error");
           const address = server.address();
-          resolve3({
+          resolve4({
             port: address.port,
             stop: () => new Promise((done) => {
               if (stopped) {
@@ -3864,7 +3951,7 @@ function createLandstripIntegration(options = {}) {
     });
   }
   function createSocketPair() {
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       const server = createServer();
       server.on("error", reject);
       let client = null;
@@ -3873,7 +3960,7 @@ function createLandstripIntegration(options = {}) {
         server.close();
         if (client) {
           client.removeListener("error", reject);
-          resolve3([client, serverEnd]);
+          resolve4([client, serverEnd]);
         }
       });
       server.listen(0, "127.0.0.1", () => {
@@ -4147,7 +4234,7 @@ function createLandstripIntegration(options = {}) {
         };
         let landstripArgs;
         try {
-          envFile = writeEnvFile({ ...process.env, ...env, PWD: resolve2(cwd) }, proxy?.port ?? null, proxy ? proxyToken : undefined);
+          envFile = writeEnvFile({ ...process.env, ...env, PWD: resolve3(cwd) }, proxy?.port ?? null, proxy ? proxyToken : undefined);
           processAllowances = withWindowsProcessReadAccess(allowances, shell, cwd, [envFile.path]);
           policy = writePolicyFile(cwd, proxy?.port ?? null, processAllowances);
           const wrappedCommand = `source '${envFile.path}' && ${command}`;
@@ -4771,7 +4858,7 @@ ${message}
                   const selected = index === selectedAgent;
                   const cursor = selected ? accent("›") : " ";
                   const active = agent.name === activeAgent ? theme.fg("success", "●") : dim("○");
-                  const name = selected ? accent(agent.name) : text(agent.name);
+                  const name = colorizeAgentText(agent.color, agent.name, (c, t) => theme.fg(c, t), selected ? "accent" : "text");
                   const model = dim(`  ${agent.model ?? "current model"}`);
                   const description = agent.description ? dim(`  ${agent.description}`) : "";
                   lines.push(row(`${cursor} ${active} ${name}${model}${description}`));
@@ -4787,7 +4874,7 @@ ${message}
                   const index = start + offset;
                   const selected = index === selectedSubagent;
                   const cursor = selected ? accent("›") : " ";
-                  const name = selected ? accent(`@${agent2.name}`) : text(`@${agent2.name}`);
+                  const name = colorizeAgentText(agent2.color, `@${agent2.name}`, (c, t) => theme.fg(c, t), selected ? "accent" : "text");
                   const flags = [agent2.model ?? "current model", agent2.mode];
                   if (agent2.hidden)
                     flags.push("hidden");

package/dist/subagents.json

@@ -4,11 +4,13 @@
       "build": {
         "description": "Default primary agent with full development access",
         "mode": "primary",
+        "color": "#034cff",
         "prompt": "Work in build mode. Implement, test, and complete the requested changes."
       },
       "plan": {
         "description": "Planning agent that asks before commands or file changes",
         "mode": "primary",
+        "color": "#a753ae",
         "prompt": "Work in plan mode. Analyze the problem and produce a clear plan before making changes.",
         "permission": { "edit": "ask", "bash": "ask", "task": "ask" }
       },
@@ -36,9 +38,9 @@
         }
       },
       "explore": {
-        "description": "Fast read-focused agent for exploring codebases",
+        "description": "Fast agent specialized for exploring codebases",
         "mode": "subagent",
-        "prompt": "Explore the codebase without modifying it. Report findings with file references.",
+        "prompt": "Explore the codebase without modifying it. Report findings with file references. Use bash and network fetch tools when needed for git, PR metadata, or remote docs; do not edit files.",
         "permission": {
           "*": "deny",
           "read": {
@@ -49,7 +51,10 @@
           },
           "glob": "allow",
           "grep": "allow",
-          "list": "allow"
+          "list": "allow",
+          "bash": "allow",
+          "webfetch": "allow",
+          "websearch": "allow"
         }
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-landstrip",
-  "version": "0.17.39",
+  "version": "0.17.41",
   "description": "Sandbox-aware Pi subagents and interactive command permissions",
   "keywords": [
     "landstrip",
@@ -40,7 +40,7 @@
     "ci:test": "npm run test"
   },
   "dependencies": {
-    "@landstrip/landstrip": "^0.17.39",
+    "@landstrip/landstrip": "^0.17.41",
     "minimatch": "^10.2.5",
     "yaml": "^2.9.0"
   },

package/subagents.json

@@ -4,11 +4,13 @@
       "build": {
         "description": "Default primary agent with full development access",
         "mode": "primary",
+        "color": "#034cff",
         "prompt": "Work in build mode. Implement, test, and complete the requested changes."
       },
       "plan": {
         "description": "Planning agent that asks before commands or file changes",
         "mode": "primary",
+        "color": "#a753ae",
         "prompt": "Work in plan mode. Analyze the problem and produce a clear plan before making changes.",
         "permission": { "edit": "ask", "bash": "ask", "task": "ask" }
       },
@@ -36,9 +38,9 @@
         }
       },
       "explore": {
-        "description": "Fast read-focused agent for exploring codebases",
+        "description": "Fast agent specialized for exploring codebases",
         "mode": "subagent",
-        "prompt": "Explore the codebase without modifying it. Report findings with file references.",
+        "prompt": "Explore the codebase without modifying it. Report findings with file references. Use bash and network fetch tools when needed for git, PR metadata, or remote docs; do not edit files.",
         "permission": {
           "*": "deny",
           "read": {
@@ -49,7 +51,10 @@
           },
           "glob": "allow",
           "grep": "allow",
-          "list": "allow"
+          "list": "allow",
+          "bash": "allow",
+          "webfetch": "allow",
+          "websearch": "allow"
         }
       }
     },