syntaur 0.76.0 → 0.77.0

package/dist/launch/index.d.ts

@@ -70,6 +70,10 @@ declare function parseOpenUrl(input: string): ParsedOpenUrl;
 type BindableActionKind = 'new-workspace' | 'new-project' | 'new-todo' | 'new-assignment';
 
 type PromptArgPosition = 'first' | 'last' | 'none';
+/** Runner family an agent belongs to — the intrinsic "type badge". */
+type RunnerKind = 'claude' | 'pi' | 'codex';
+/** Which discovery source a registered agent's on-disk def was adopted from. */
+type AgentSourceKind = 'claude-global' | 'claude-project' | 'directory';
 /**
  * Per-agent argv recipe for continuing a recorded session in a specific mode.
  *
@@ -135,6 +139,27 @@ interface AgentConfig {
      * `agentName`. Existence is validated at launch time, not at config-write time.
      */
     workdir?: string;
+    /**
+     * Intrinsic runner family — the type badge shown in the unified agent list
+     * (claude / pi / codex). Authoritative when set; `resolveRunner` infers it for
+     * legacy rows. Never a user-toggled "mode". When set explicitly it constrains
+     * the identity field: a `claude` runner uses `agentName` (not `workdir`); a
+     * `pi`/`codex` runner uses `workdir` (not `agentName`) — enforced in
+     * `validateAgentList`.
+     */
+    runner?: RunnerKind;
+    /**
+     * Source pointer (flat scalars, NOT a nested object — so they ride the scalar
+     * config-field machinery) to the on-disk def a registered agent was adopted
+     * from. The def stays the source of truth for identity content; these exist for
+     * display, dedupe ("already registered"), and refresh. `sourcePath` is the
+     * `.md` file for a claude agent or the directory for a directory agent (===
+     * `workdir`). `sourceRepo` is the repo root for a `claude-project` def (used to
+     * reason about cross-repo `--agent` resolution).
+     */
+    sourceKind?: AgentSourceKind;
+    sourcePath?: string;
+    sourceRepo?: string;
 }
 
 /**
@@ -322,6 +347,18 @@ interface HotkeyBindingsConfig {
  * - `off`: no automatic DB writes (manual `track-session` still works).
  */
 type SessionAutoTrack = 'all' | 'workspaces-only' | 'off';
+/**
+ * Multi-source agent discovery settings. Sources are individually toggleable;
+ * `roots` is the depth-1 directory-scan root list (default `~`). Persisted as an
+ * `agentDiscovery:` block whose one-level keys read back as dotted `fm` keys
+ * (roots is a `:`-separated scalar to avoid list-parsing in the top-level map).
+ */
+interface AgentDiscoveryConfig {
+    claudeGlobal: boolean;
+    claudeProject: boolean;
+    directory: boolean;
+    roots: string[];
+}
 interface SyntaurConfig {
     version: string;
     defaultProjectDir: string;
@@ -350,6 +387,10 @@ interface SyntaurConfig {
     /** Opt-in: run the read-only staleness watchdog on the dashboard loop (emits
      * staleness-detected/cleared audit events; never mutates status). Off by default. */
     stalenessWatchdog: boolean;
+    /** Default cwd for a standalone claude-agent launch (null → home at launch). */
+    standaloneDefaultCwd: string | null;
+    /** Multi-source agent discovery settings (sources on/off + scan roots). */
+    agentDiscovery: AgentDiscoveryConfig;
 }
 
 /**

package/dist/launch/index.js

@@ -1239,6 +1239,14 @@ function agentNameArgs(agent) {
   const n = agent.agentName?.trim();
   return n ? ["--agent", n] : [];
 }
+function resolveRunner(agent) {
+  if (agent.runner) return agent.runner;
+  if (agent.agentName && agent.agentName.trim() !== "") return "claude";
+  const cmd = agent.command ?? "";
+  if (/claude/i.test(cmd) || agent.id === "claude") return "claude";
+  if (/codex/i.test(cmd) || agent.id === "codex") return "codex";
+  return "pi";
+}
 function stripModelFlags(args) {
   const out = [];
   for (let i = 0; i < args.length; i++) {
@@ -2451,6 +2459,7 @@ __export(config_exports, {
   parseStatusConfig: () => parseStatusConfig,
   parseTerminalConfig: () => parseTerminalConfig,
   readConfig: () => readConfig,
+  serializeAgentDiscoveryConfig: () => serializeAgentDiscoveryConfig,
   serializeSearchConfig: () => serializeSearchConfig,
   serializeStatusConfig: () => serializeStatusConfig,
   toTitleCase: () => toTitleCase,
@@ -2464,6 +2473,7 @@ __export(config_exports, {
   validateDeriveShape: () => validateDeriveShape,
   validateFactDeclarations: () => validateFactDeclarations,
   validateStalenessConfig: () => validateStalenessConfig,
+  writeAgentDiscoveryConfig: () => writeAgentDiscoveryConfig,
   writeAgentsConfig: () => writeAgentsConfig,
   writeHotkeyBindingsConfig: () => writeHotkeyBindingsConfig,
   writeSearchConfig: () => writeSearchConfig,
@@ -2556,6 +2566,50 @@ function validateAgentList(agents) {
         `agent "${agent.id}" sets both agentName and model \u2014 the agent definition's own model is authoritative; remove the profile model`
       );
     }
+    if (agent.runner !== void 0 && !RUNNER_KINDS.includes(agent.runner)) {
+      throw new AgentConfigError(
+        `agent "${agent.id}" has invalid runner "${agent.runner}" \u2014 must be one of ${RUNNER_KINDS.join(", ")}`
+      );
+    }
+    if (agent.sourceKind !== void 0 && !AGENT_SOURCE_KINDS.includes(agent.sourceKind)) {
+      throw new AgentConfigError(
+        `agent "${agent.id}" has invalid sourceKind "${agent.sourceKind}" \u2014 must be one of ${AGENT_SOURCE_KINDS.join(", ")}`
+      );
+    }
+    if (agent.sourcePath !== void 0 && /[\r\n]/.test(agent.sourcePath)) {
+      throw new AgentConfigError(
+        `agent "${agent.id}" has invalid sourcePath \u2014 must be a single line (no newlines)`
+      );
+    }
+    if (agent.sourceRepo !== void 0 && /[\r\n]/.test(agent.sourceRepo)) {
+      throw new AgentConfigError(
+        `agent "${agent.id}" has invalid sourceRepo \u2014 must be a single line (no newlines)`
+      );
+    }
+    if (agent.runner === "claude" && agent.workdir !== void 0 && agent.workdir.trim() !== "") {
+      throw new AgentConfigError(
+        `agent "${agent.id}" has runner "claude" but sets workdir \u2014 a claude agent uses agentName, not workdir`
+      );
+    }
+    if ((agent.runner === "pi" || agent.runner === "codex") && agent.agentName !== void 0 && agent.agentName.trim() !== "") {
+      throw new AgentConfigError(
+        `agent "${agent.id}" has runner "${agent.runner}" but sets agentName \u2014 a directory agent uses workdir, not agentName`
+      );
+    }
+    if (agent.runner !== void 0 && agent.sourceKind !== void 0) {
+      const directorySource = agent.sourceKind === "directory";
+      const claudeRunner = agent.runner === "claude";
+      if (directorySource && claudeRunner) {
+        throw new AgentConfigError(
+          `agent "${agent.id}" has sourceKind "directory" but runner "claude" \u2014 a directory source is a pi/codex agent`
+        );
+      }
+      if (!directorySource && !claudeRunner) {
+        throw new AgentConfigError(
+          `agent "${agent.id}" has sourceKind "${agent.sourceKind}" but runner "${agent.runner}" \u2014 a ${agent.sourceKind} source is a claude agent`
+        );
+      }
+    }
     validateSessionInvocation(agent, "resume", agent.resume);
     validateSessionInvocation(agent, "fork", agent.fork);
     if (agent.default) defaults++;
@@ -2658,6 +2712,21 @@ function parseInstalledAgents(fm) {
   }
   return Object.keys(installedAgents).length > 0 ? { installedAgents } : {};
 }
+function parseAgentDiscoveryFromFm(fm) {
+  const flag = (key, def) => {
+    const v = fm[key];
+    if (v === void 0) return def;
+    return String(v).toLowerCase() === "true";
+  };
+  const rootsRaw = fm["agentDiscovery.roots"];
+  const roots = rootsRaw !== void 0 && String(rootsRaw).trim() !== "" ? String(rootsRaw).split(":").map((r) => r.trim()).filter((r) => r.length > 0) : [];
+  return {
+    claudeGlobal: flag("agentDiscovery.claudeGlobal", true),
+    claudeProject: flag("agentDiscovery.claudeProject", true),
+    directory: flag("agentDiscovery.directory", true),
+    roots: roots.length > 0 ? roots : DEFAULT_CONFIG.agentDiscovery.roots.slice()
+  };
+}
 function parseStatusConfig(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
   if (!match) return null;
@@ -3166,6 +3235,43 @@ ${cleanedFm}
 ---${afterFrontmatter}`;
   await writeFileForce(configPath, newContent);
 }
+function serializeAgentDiscoveryConfig(cfg) {
+  return [
+    "agentDiscovery:",
+    `  claudeGlobal: ${cfg.claudeGlobal}`,
+    `  claudeProject: ${cfg.claudeProject}`,
+    `  directory: ${cfg.directory}`,
+    `  roots: ${cfg.roots.join(":")}`
+  ].join("\n");
+}
+async function writeAgentDiscoveryConfig(cfg, standaloneDefaultCwd) {
+  const configPath = resolve7(syntaurRoot(), "config.md");
+  const block = serializeAgentDiscoveryConfig(cfg);
+  const scalarLine = standaloneDefaultCwd ? `standaloneDefaultCwd: ${standaloneDefaultCwd}` : "";
+  const additions = [block, scalarLine].filter(Boolean).join("\n");
+  const existing = await fileExists(configPath) ? await readFile5(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
+  if (!fmMatch) {
+    const content = `---
+version: "2.0"
+defaultProjectDir: ${defaultProjectDir()}
+${additions}
+---
+${existing}`;
+    await writeFileForce(configPath, content);
+    return;
+  }
+  const fmBlock = fmMatch[2];
+  const afterFrontmatter = existing.slice(fmMatch[0].length);
+  let cleanedFm = stripTopLevelBlock(fmBlock, "agentDiscovery");
+  cleanedFm = stripTopLevelScalar(cleanedFm, "standaloneDefaultCwd");
+  const newFm = `${cleanedFm}
+${additions}`.replace(/^\n+/, "").replace(/\n+$/, "");
+  const newContent = `---
+${newFm}
+---${afterFrontmatter}`;
+  await writeFileForce(configPath, newContent);
+}
 function stripTopLevelScalar(fmBlock, key) {
   const lines = fmBlock.split("\n");
   const keyRegex = new RegExp(`^${key}:\\s*\\S`);
@@ -3378,6 +3484,10 @@ function parseAgentsConfig(content) {
       ...current.launchPrompt ? { launchPrompt: current.launchPrompt } : {},
       ...current.agentName ? { agentName: current.agentName } : {},
       ...current.workdir ? { workdir: current.workdir } : {},
+      ...current.runner ? { runner: current.runner } : {},
+      ...current.sourceKind ? { sourceKind: current.sourceKind } : {},
+      ...current.sourcePath ? { sourcePath: current.sourcePath } : {},
+      ...current.sourceRepo ? { sourceRepo: current.sourceRepo } : {},
       ...current.resume ? { resume: current.resume } : {},
       ...current.fork ? { fork: current.fork } : {}
     });
@@ -3575,6 +3685,18 @@ function assignAgentField(target, key, rawValue) {
     case "workdir":
       target.workdir = value;
       break;
+    case "runner":
+      target.runner = value;
+      break;
+    case "sourceKind":
+      target.sourceKind = value;
+      break;
+    case "sourcePath":
+      target.sourcePath = value;
+      break;
+    case "sourceRepo":
+      target.sourceRepo = value;
+      break;
   }
 }
 function yamlQuoteScalar(value) {
@@ -3610,6 +3732,18 @@ function serializeAgentsConfig(agents) {
     if (a.workdir) {
       lines.push(`    workdir: ${yamlQuoteScalar(a.workdir)}`);
     }
+    if (a.runner) {
+      lines.push(`    runner: ${yamlQuoteScalar(a.runner)}`);
+    }
+    if (a.sourceKind) {
+      lines.push(`    sourceKind: ${yamlQuoteScalar(a.sourceKind)}`);
+    }
+    if (a.sourcePath) {
+      lines.push(`    sourcePath: ${yamlQuoteScalar(a.sourcePath)}`);
+    }
+    if (a.sourceRepo) {
+      lines.push(`    sourceRepo: ${yamlQuoteScalar(a.sourceRepo)}`);
+    }
     if (a.args && a.args.length > 0) {
       lines.push(`    args:`);
       for (const arg of a.args) {
@@ -4095,7 +4229,12 @@ async function readConfig() {
     searchConfig: parseSearchConfig(content),
     workspaceVisibility: parseWorkspaceVisibilityConfig(fmBlock),
     staleness: parseStalenessConfig(content),
-    stalenessWatchdog: String(fm["stalenessWatchdog"]).toLowerCase() === "true"
+    stalenessWatchdog: String(fm["stalenessWatchdog"]).toLowerCase() === "true",
+    standaloneDefaultCwd: parseOptionalAbsolutePath(
+      fm["standaloneDefaultCwd"],
+      "standaloneDefaultCwd"
+    ),
+    agentDiscovery: parseAgentDiscoveryFromFm(fm)
   };
 }
 function getAssignmentTypes(config) {
@@ -4158,7 +4297,7 @@ async function updateAgentsConfig(mutation, options = {}) {
   await writeAgentsConfig(next);
   return { previous, next, written: true };
 }
-var STALENESS_KEY_TO_FIELD, DURATION_RE, DURATION_UNIT_MS, DEFAULT_ASSIGNMENT_TYPES, DEFAULT_CONFIG, AUTO_CREATE_WORKTREE_VALUES, SESSION_AUTO_TRACK_VALUES, AgentConfigError, DEFAULT_STATUS_COLORS, KNOWN_AGENT_SCALAR_FIELDS, migratedConfigPaths, TerminalConfigError;
+var STALENESS_KEY_TO_FIELD, DURATION_RE, DURATION_UNIT_MS, DEFAULT_ASSIGNMENT_TYPES, DEFAULT_CONFIG, AUTO_CREATE_WORKTREE_VALUES, SESSION_AUTO_TRACK_VALUES, RUNNER_KINDS, AGENT_SOURCE_KINDS, AgentConfigError, DEFAULT_STATUS_COLORS, KNOWN_AGENT_SCALAR_FIELDS, migratedConfigPaths, TerminalConfigError;
 var init_config2 = __esm({
   "src/utils/config.ts"() {
     "use strict";
@@ -4234,10 +4373,23 @@ var init_config2 = __esm({
         hidden: []
       },
       staleness: null,
-      stalenessWatchdog: false
+      stalenessWatchdog: false,
+      standaloneDefaultCwd: null,
+      agentDiscovery: {
+        claudeGlobal: true,
+        claudeProject: true,
+        directory: true,
+        roots: ["~"]
+      }
     };
     AUTO_CREATE_WORKTREE_VALUES = ["skip", "ask", "always"];
     SESSION_AUTO_TRACK_VALUES = ["all", "workspaces-only", "off"];
+    RUNNER_KINDS = ["claude", "pi", "codex"];
+    AGENT_SOURCE_KINDS = [
+      "claude-global",
+      "claude-project",
+      "directory"
+    ];
     AgentConfigError = class extends Error {
     };
     DEFAULT_STATUS_COLORS = {
@@ -4259,7 +4411,11 @@ var init_config2 = __esm({
       "playbook",
       "launchPrompt",
       "agentName",
-      "workdir"
+      "workdir",
+      "runner",
+      "sourceKind",
+      "sourcePath",
+      "sourceRepo"
     ]);
     migratedConfigPaths = /* @__PURE__ */ new Set();
     TerminalConfigError = class extends Error {
@@ -4473,6 +4629,7 @@ var init_playbooks = __esm({
 
 // src/launch/cwd.ts
 import { existsSync, statSync } from "fs";
+import { homedir as homedir2 } from "os";
 import { isAbsolute as isAbsolute2 } from "path";
 function isExistingDir(p) {
   if (!p || !isAbsolute2(p)) return false;
@@ -4518,6 +4675,31 @@ function resolveLaunchCwd(agent, worktreeCwd) {
   }
   return { spawnCwd: worktreeCwd, worktreePath: worktreeCwd, invalidReason: null };
 }
+function resolveStandaloneCwd(agent, standaloneDefaultCwd) {
+  const wd = agent.workdir?.trim();
+  if (wd) {
+    const expanded = expandHome(wd);
+    if (!isExistingDir(expanded)) {
+      return {
+        cwd: null,
+        invalidReason: `agent "${agent.id}" workdir ${agent.workdir} (resolved ${expanded}) is not an existing directory \u2014 a standalone launch requires a valid workdir.`
+      };
+    }
+    return { cwd: expanded, invalidReason: null };
+  }
+  if (resolveRunner(agent) === "claude") {
+    const configured = standaloneDefaultCwd?.trim();
+    if (configured) {
+      const expanded = expandHome(configured);
+      if (isExistingDir(expanded)) return { cwd: expanded, invalidReason: null };
+    }
+    return { cwd: homedir2(), invalidReason: null };
+  }
+  return {
+    cwd: null,
+    invalidReason: `agent "${agent.id}" has no workdir \u2014 a standalone launch of a ${resolveRunner(agent)} agent requires a valid workdir.`
+  };
+}
 function formatFallbackCwdWarning(opts) {
   const missing = [];
   if (!opts.worktreePath) missing.push("worktreePath");
@@ -4529,6 +4711,7 @@ function formatFallbackCwdWarning(opts) {
 var init_cwd = __esm({
   "src/launch/cwd.ts"() {
     "use strict";
+    init_agents_schema();
     init_paths();
   }
 });
@@ -7435,18 +7618,14 @@ async function resolveStandalonePlan(input, terminal) {
       `Agent "${agentId}" requested for a standalone launch is not in your agents list.`
     );
   }
-  const wd = agent.workdir?.trim();
-  if (!wd) {
-    throw new LaunchError(
-      "workspace-path-invalid",
-      `Agent "${agent.id}" has no workdir \u2014 a standalone launch requires a valid workdir.`
-    );
-  }
-  const expanded = expandHome(wd);
-  if (!isExistingDir(expanded)) {
+  const { cwd: spawnCwd, invalidReason } = resolveStandaloneCwd(
+    agent,
+    input.config.standaloneDefaultCwd
+  );
+  if (spawnCwd === null) {
     throw new LaunchError(
       "workspace-path-invalid",
-      `Agent "${agent.id}" workdir ${agent.workdir} (resolved ${expanded}) is not an existing directory \u2014 a standalone launch requires a valid workdir.`
+      invalidReason ?? `Agent "${agent.id}" has no valid standalone launch directory.`
     );
   }
   const knownPlaybookSlugs = await listPlaybookSlugs(playbooksDir());
@@ -7460,7 +7639,7 @@ async function resolveStandalonePlan(input, terminal) {
   const { argv, shellFallbackWarning } = buildFreshArgv(agent, prompt);
   return {
     terminal,
-    cwd: expanded,
+    cwd: spawnCwd,
     argv,
     env: process.env,
     agentId: agent.id,
@@ -7627,13 +7806,13 @@ async function resolveSessionPlan(input, terminal) {
 
 // src/launch/execute.ts
 import { spawn as spawn3 } from "child_process";
-import { homedir as homedir5 } from "os";
+import { homedir as homedir6 } from "os";
 import { basename as basename2, join as join6, resolve as resolve18 } from "path";
 
 // src/utils/terminal-probe.ts
 import { spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync2 } from "fs";
-import { homedir as homedir2 } from "os";
+import { homedir as homedir3 } from "os";
 import { join as join3 } from "path";
 var APP_BUNDLE_NAMES = {
   iterm: "iTerm.app",
@@ -7645,7 +7824,7 @@ var APP_FIXED_PATHS = {
   "terminal-app": "/System/Applications/Utilities/Terminal.app"
 };
 function defaultApplicationsDirs() {
-  return ["/Applications", join3(homedir2(), "Applications")];
+  return ["/Applications", join3(homedir3(), "Applications")];
 }
 function findAppBundle(terminal, dirs = defaultApplicationsDirs()) {
   const fixed = APP_FIXED_PATHS[terminal];
@@ -7707,7 +7886,7 @@ init_config2();
 // src/utils/session-id.ts
 import { execFileSync as execFileSync2 } from "child_process";
 import { mkdirSync, readFileSync as readFileSync2, statSync as statSync3, writeFileSync } from "fs";
-import { homedir as homedir4 } from "os";
+import { homedir as homedir5 } from "os";
 import { dirname as dirname3, join as join5 } from "path";
 
 // src/utils/process-info.ts
@@ -7730,7 +7909,7 @@ function captureProcessStartedAt(pid) {
 init_paths();
 import { open as open2, readdir as readdir10, stat as stat3 } from "fs/promises";
 import { join as join4 } from "path";
-import { homedir as homedir3 } from "os";
+import { homedir as homedir4 } from "os";
 
 // src/utils/transcript.ts
 import { open } from "fs/promises";
@@ -7848,7 +8027,7 @@ async function registerLaunchAtBirth(plan, child) {
     const sessionId = plan.session?.sessionId ?? null;
     const procStart = captureProcessStartedAt(pid);
     const envDir = process.env.SYNTAUR_RUNTIME_SESSIONS_DIR;
-    const markerDir = envDir && envDir.length > 0 ? envDir : join6(homedir5(), ".syntaur", "runtime", "sessions");
+    const markerDir = envDir && envDir.length > 0 ? envDir : join6(homedir6(), ".syntaur", "runtime", "sessions");
     writeRuntimeMarker(
       pid,
       {