syntaur 0.40.0 → 0.41.2

package/dist/index.js

@@ -1794,6 +1794,28 @@ var init_hotkeysCatalog = __esm({
 });
 
 // src/utils/agents-schema.ts
+function modelFlagArgs(agent) {
+  const m = agent.model?.trim();
+  return m ? ["--model", m] : [];
+}
+function stripModelFlags(args) {
+  const out = [];
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === "--model" || a === "-m") {
+      i++;
+      continue;
+    }
+    if (a.startsWith("--model=") || a.startsWith("-m=")) continue;
+    out.push(a);
+  }
+  return out;
+}
+function applyModelFlag(agent, baseArgs) {
+  const flag = modelFlagArgs(agent);
+  if (flag.length === 0) return baseArgs;
+  return [...stripModelFlags(baseArgs), ...flag];
+}
 var BUILTIN_AGENTS, AGENT_ID_PATTERN, PROMPT_ARG_POSITIONS;
 var init_agents_schema = __esm({
   "src/utils/agents-schema.ts"() {
@@ -1848,6 +1870,19 @@ var init_agents_schema = __esm({
   }
 });
 
+// src/utils/slug.ts
+function slugify(title) {
+  return title.toLowerCase().trim().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function isValidSlug(slug) {
+  return /^[a-z0-9]+(-[a-z0-9]+)*$/.test(slug);
+}
+var init_slug = __esm({
+  "src/utils/slug.ts"() {
+    "use strict";
+  }
+});
+
 // src/utils/terminal-schema.ts
 var TERMINAL_CHOICES;
 var init_terminal_schema = __esm({
@@ -1972,6 +2007,16 @@ function validateAgentList(agents) {
         `agent "${agent.id}" has invalid promptArgPosition "${agent.promptArgPosition}" \u2014 expected first|last|none`
       );
     }
+    if (agent.model !== void 0 && /[\r\n]/.test(agent.model)) {
+      throw new AgentConfigError(
+        `agent "${agent.id}" has invalid model \u2014 must be a single line (no newlines)`
+      );
+    }
+    if (agent.playbook !== void 0 && agent.playbook.trim() !== "" && !isValidSlug(agent.playbook)) {
+      throw new AgentConfigError(
+        `agent "${agent.id}" has invalid playbook "${agent.playbook}" \u2014 must be a valid playbook slug`
+      );
+    }
     validateSessionInvocation(agent, "resume", agent.resume);
     validateSessionInvocation(agent, "fork", agent.fork);
     if (agent.default) defaults++;
@@ -2676,6 +2721,8 @@ function parseAgentsConfig(content) {
       ...current.promptArgPosition ? { promptArgPosition: current.promptArgPosition } : {},
       ...current.default ? { default: true } : {},
       ...current.resolveFromShellAliases ? { resolveFromShellAliases: true } : {},
+      ...current.model ? { model: current.model } : {},
+      ...current.playbook ? { playbook: current.playbook } : {},
       ...current.resume ? { resume: current.resume } : {},
       ...current.fork ? { fork: current.fork } : {}
     });
@@ -2858,6 +2905,12 @@ function assignAgentField(target, key, rawValue) {
     case "resolveFromShellAliases":
       target.resolveFromShellAliases = value === "true";
       break;
+    case "model":
+      target.model = value;
+      break;
+    case "playbook":
+      target.playbook = value;
+      break;
   }
 }
 function yamlQuoteScalar(value) {
@@ -2878,6 +2931,12 @@ function serializeAgentsConfig(agents) {
     lines.push(`  - id: ${yamlQuoteScalar(a.id)}`);
     lines.push(`    label: ${yamlQuoteScalar(a.label)}`);
     lines.push(`    command: ${yamlQuoteScalar(a.command)}`);
+    if (a.model) {
+      lines.push(`    model: ${yamlQuoteScalar(a.model)}`);
+    }
+    if (a.playbook) {
+      lines.push(`    playbook: ${yamlQuoteScalar(a.playbook)}`);
+    }
     if (a.args && a.args.length > 0) {
       lines.push(`    args:`);
       for (const arg of a.args) {
@@ -3260,6 +3319,7 @@ var init_config2 = __esm({
     init_lifecycle();
     init_hotkeysCatalog();
     init_agents_schema();
+    init_slug();
     init_terminal_schema();
     init_workspace_visibility_schema();
     DEFAULT_ASSIGNMENT_TYPES = {
@@ -3319,7 +3379,9 @@ var init_config2 = __esm({
       "command",
       "promptArgPosition",
       "default",
-      "resolveFromShellAliases"
+      "resolveFromShellAliases",
+      "model",
+      "playbook"
     ]);
     migratedConfigPaths = /* @__PURE__ */ new Set();
     TerminalConfigError = class extends Error {
@@ -3327,19 +3389,6 @@ var init_config2 = __esm({
   }
 });
 
-// src/utils/slug.ts
-function slugify(title) {
-  return title.toLowerCase().trim().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
-}
-function isValidSlug(slug) {
-  return /^[a-z0-9]+(-[a-z0-9]+)*$/.test(slug);
-}
-var init_slug = __esm({
-  "src/utils/slug.ts"() {
-    "use strict";
-  }
-});
-
 // src/utils/playbooks.ts
 import { resolve as resolve7 } from "path";
 import { readdir as readdir3, readFile as readFile6, unlink } from "fs/promises";
@@ -8501,7 +8550,7 @@ function shellQuote(arg) {
 }
 function buildAgentArgv(agent, prompt, env = process.env) {
   const position = agent.promptArgPosition ?? "first";
-  const baseArgs = [...agent.args ?? []];
+  const baseArgs = applyModelFlag(agent, [...agent.args ?? []]);
   const agentArgs = position === "first" ? [prompt, ...baseArgs] : position === "last" ? [...baseArgs, prompt] : baseArgs;
   if (agent.resolveFromShellAliases) {
     const requested = env.SHELL;
@@ -8581,7 +8630,7 @@ async function launchAgent(options) {
   );
   const { argv, shellFallbackWarning } = buildAgentArgv(
     agent,
-    INITIAL_PROMPT({ projectSlug, assignmentSlug })
+    INITIAL_PROMPT({ projectSlug, assignmentSlug, playbook: agent.playbook })
   );
   if (shellFallbackWarning) {
     console.warn(shellFallbackWarning);
@@ -8621,16 +8670,22 @@ var init_launch = __esm({
   "src/tui/launch.ts"() {
     "use strict";
     init_api();
+    init_agents_schema();
     init_cwd();
     init_cwd();
     INITIAL_PROMPT = (params2) => {
-      if (params2.projectSlug) {
-        return `/grab-assignment ${params2.projectSlug} ${params2.assignmentSlug}`;
-      }
-      if (params2.id) {
-        return `/grab-assignment --id ${params2.id}`;
+      const playbook = params2.playbook?.trim();
+      if (!playbook) {
+        if (params2.projectSlug) {
+          return `/grab-assignment ${params2.projectSlug} ${params2.assignmentSlug}`;
+        }
+        if (params2.id) {
+          return `/grab-assignment --id ${params2.id}`;
+        }
+        return `/grab-assignment ${params2.assignmentSlug}`;
       }
-      return `/grab-assignment ${params2.assignmentSlug}`;
+      const grabClause = params2.projectSlug ? `the assignment \`${params2.projectSlug}/${params2.assignmentSlug}\` using the /grab-assignment skill` : params2.id ? `the assignment id \`${params2.id}\` using /grab-assignment --id ${params2.id}` : `the assignment \`${params2.assignmentSlug}\` using the /grab-assignment skill`;
+      return `Grab ${grabClause}, then load and run the \`${playbook}\` playbook using the /run-playbook skill and carry it out end-to-end.`;
     };
   }
 });
@@ -14133,6 +14188,24 @@ function mapAgentErrorToFieldErrors(err2) {
       fieldErrors: [{ field: "default", message: "only one agent may be default" }]
     };
   }
+  match = message.match(/^agent "([^"]+)" has invalid playbook/);
+  if (match) {
+    return {
+      error: message,
+      fieldErrors: [
+        { id: match[1], field: "playbook", message: "must be a valid playbook slug" }
+      ]
+    };
+  }
+  match = message.match(/^agent "([^"]+)" has invalid model/);
+  if (match) {
+    return {
+      error: message,
+      fieldErrors: [
+        { id: match[1], field: "model", message: "must be a single line" }
+      ]
+    };
+  }
   return { error: message };
 }
 function coerceAgentRow(raw2, index) {
@@ -14239,6 +14312,34 @@ function coerceAgentRow(raw2, index) {
     }
     cleaned.default = entry.default;
   }
+  if (entry.model !== void 0) {
+    if (typeof entry.model !== "string") {
+      return {
+        ok: false,
+        status: 400,
+        body: {
+          error: `agents[${index}].model must be a string`,
+          fieldErrors: [{ id, field: "model", message: "model must be a string" }]
+        }
+      };
+    }
+    const model = entry.model.trim();
+    if (model) cleaned.model = model;
+  }
+  if (entry.playbook !== void 0) {
+    if (typeof entry.playbook !== "string") {
+      return {
+        ok: false,
+        status: 400,
+        body: {
+          error: `agents[${index}].playbook must be a string`,
+          fieldErrors: [{ id, field: "playbook", message: "playbook must be a string" }]
+        }
+      };
+    }
+    const playbook = entry.playbook.trim();
+    if (playbook) cleaned.playbook = playbook;
+  }
   return { ok: true, value: cleaned };
 }
 function createAgentsRouter() {
@@ -14477,6 +14578,17 @@ function parseOpenUrl(input4) {
     }
     terminal = candidate;
   }
+  const agentVals = url.searchParams.getAll("agent");
+  if (agentVals.length > 1) {
+    throw new OpenUrlError(
+      "duplicate-param",
+      "URL has more than one `agent` query param"
+    );
+  }
+  let agent;
+  if (agentVals.length === 1 && agentVals[0].trim() !== "") {
+    agent = agentVals[0];
+  }
   if (assignmentVals.length === 1) {
     const id = assignmentVals[0];
     if (id.trim() === "") {
@@ -14485,7 +14597,12 @@ function parseOpenUrl(input4) {
         "`assignment` query param is empty"
       );
     }
-    return { kind: "assignment", id, ...terminal ? { terminal } : {} };
+    return {
+      kind: "assignment",
+      id,
+      ...terminal ? { terminal } : {},
+      ...agent ? { agent } : {}
+    };
   }
   if (sessionVals.length === 1) {
     const id = sessionVals[0];
@@ -14510,7 +14627,13 @@ function parseOpenUrl(input4) {
       }
       mode = raw2;
     }
-    return { kind: "session", id, mode, ...terminal ? { terminal } : {} };
+    return {
+      kind: "session",
+      id,
+      mode,
+      ...terminal ? { terminal } : {},
+      ...agent ? { agent } : {}
+    };
   }
   throw new OpenUrlError(
     "missing-id",
@@ -14527,6 +14650,7 @@ init_cwd();
 init_agent_sessions();
 
 // src/launch/argv.ts
+init_agents_schema();
 init_launch();
 import { isAbsolute as isAbsolute6 } from "path";
 var buildFreshArgv = buildAgentArgv;
@@ -14542,7 +14666,7 @@ function buildSessionArgv(agent, sessionId, mode, env = process.env) {
     (a) => a === "{id}" ? sessionId : a
   );
   const command = invocation.command ?? agent.command;
-  const agentArgs = [...agent.args ?? [], ...substituted];
+  const agentArgs = [...applyModelFlag(agent, [...agent.args ?? []]), ...substituted];
   if (agent.resolveFromShellAliases) {
     const requested = env.SHELL;
     let shell = requested;
@@ -14623,13 +14747,26 @@ async function resolveAssignmentPlan(input4, terminal) {
   }
   const cwd = picked.cwd;
   const fallbackWarning = picked.fallbackWarning;
-  const agent = pickAgent(input4.config);
+  let agent;
+  if (input4.agentId) {
+    const found = getAgents(input4.config).find((a) => a.id === input4.agentId);
+    if (!found) {
+      throw new LaunchError(
+        "agent-not-configured",
+        `Agent "${input4.agentId}" requested in the open URL is not in your agents list.`
+      );
+    }
+    agent = found;
+  } else {
+    agent = pickAgent(input4.config);
+  }
   const { argv, shellFallbackWarning } = buildFreshArgv(
     agent,
     INITIAL_PROMPT({
       projectSlug: resolved.projectSlug,
       assignmentSlug: resolved.assignmentSlug,
-      id: resolved.id
+      id: resolved.id,
+      playbook: agent.playbook
     })
   );
   return {
@@ -24502,7 +24639,8 @@ async function urlCommand(input4, options = {}) {
     config,
     projectsDir: projectsDir2,
     assignmentsDir: assignmentsDir(),
-    terminalOverride: parsed.terminal
+    terminalOverride: parsed.terminal,
+    agentId: parsed.kind === "assignment" ? parsed.agent : void 0
   });
   if (plan.fallbackWarning) {
     console.error(plan.fallbackWarning);
@@ -29254,6 +29392,8 @@ agentsCommand.command("list").description("List configured agents (or built-in d
       if (agent.default) flags.push("default");
       if (agent.resolveFromShellAliases) flags.push("shell-alias");
       if (agent.promptArgPosition) flags.push(`prompt=${agent.promptArgPosition}`);
+      if (agent.model) flags.push(`model=${agent.model}`);
+      if (agent.playbook) flags.push(`playbook=${agent.playbook}`);
       const flagStr = flags.length > 0 ? ` [${flags.join(", ")}]` : "";
       const args = agent.args && agent.args.length > 0 ? ` ${agent.args.join(" ")}` : "";
       console.log(`  ${agent.id.padEnd(12)} ${agent.label.padEnd(20)} ${agent.command}${args}${flagStr}`);
@@ -29262,7 +29402,7 @@ agentsCommand.command("list").description("List configured agents (or built-in d
     reportAndExit(error);
   }
 });
-agentsCommand.command("add").description("Add a new agent to ~/.syntaur/config.md").requiredOption("--id <id>", "Agent id (slug)").requiredOption("--label <label>", "Display label").requiredOption("--command <command>", "Absolute path or bare binary name").option("--args <csv>", "Comma-separated default args").option("--prompt-arg-position <position>", "first | last | none").option("--default", "Mark this agent as the default launch target").option("--resolve-from-shell-aliases", "Run via $SHELL -i -c (for shell aliases)").option("--dry-run", "Validate and print the proposed config without writing").action(async (options) => {
+agentsCommand.command("add").description("Add a new agent to ~/.syntaur/config.md").requiredOption("--id <id>", "Agent id (slug)").requiredOption("--label <label>", "Display label").requiredOption("--command <command>", "Absolute path or bare binary name").option("--args <csv>", "Comma-separated default args").option("--prompt-arg-position <position>", "first | last | none").option("--default", "Mark this agent as the default launch target").option("--resolve-from-shell-aliases", "Run via $SHELL -i -c (for shell aliases)").option("--model <model>", "LLM model injected as --model <value> at launch").option("--playbook <slug>", "Playbook slug to run end-to-end on a fresh launch").option("--dry-run", "Validate and print the proposed config without writing").action(async (options) => {
   try {
     const agent = buildAgentFromOptions(options, null);
     const mutation = {
@@ -29302,7 +29442,7 @@ agentsCommand.command("remove <id>").description("Remove an agent from ~/.syntau
     reportAndExit(error);
   }
 });
-agentsCommand.command("set <id>").description("Update one or more fields on an existing agent").option("--label <label>", "Display label").option("--command <command>", "Absolute path or bare binary name").option("--args <csv>", "Comma-separated default args").option("--prompt-arg-position <position>", "first | last | none").option("--default", "Mark this agent as the default (clears any prior default)").option("--no-default", "Unset the default flag on this agent").option("--resolve-from-shell-aliases", "Run via $SHELL -i -c (for shell aliases)").option("--no-resolve-from-shell-aliases", "Disable shell-alias resolution for this agent").option("--dry-run", "Validate and print the proposed config without writing").action(async (id, options) => {
+agentsCommand.command("set <id>").description("Update one or more fields on an existing agent").option("--label <label>", "Display label").option("--command <command>", "Absolute path or bare binary name").option("--args <csv>", "Comma-separated default args").option("--prompt-arg-position <position>", "first | last | none").option("--default", "Mark this agent as the default (clears any prior default)").option("--no-default", "Unset the default flag on this agent").option("--resolve-from-shell-aliases", "Run via $SHELL -i -c (for shell aliases)").option("--no-resolve-from-shell-aliases", "Disable shell-alias resolution for this agent").option("--model <model>", "LLM model injected as --model <value> (empty string clears)").option("--playbook <slug>", "Playbook slug to run on a fresh launch (empty string clears)").option("--dry-run", "Validate and print the proposed config without writing").action(async (id, options) => {
   try {
     const mutation = {
       kind: "set",
@@ -29376,6 +29516,8 @@ function buildAgentFromOptions(options, existing) {
   }
   if (options.default) agent.default = true;
   if (options.resolveFromShellAliases) agent.resolveFromShellAliases = true;
+  if (options.model && options.model.trim()) agent.model = options.model.trim();
+  if (options.playbook && options.playbook.trim()) agent.playbook = options.playbook.trim();
   validateAgentList([...existing ? [] : [], agent]);
   return agent;
 }
@@ -29397,6 +29539,16 @@ function mergeOptionsIntoAgent(existing, options) {
   if (options.default === false) delete merged.default;
   if (options.resolveFromShellAliases === true) merged.resolveFromShellAliases = true;
   if (options.resolveFromShellAliases === false) delete merged.resolveFromShellAliases;
+  if (options.model !== void 0) {
+    const model = options.model.trim();
+    if (model) merged.model = model;
+    else delete merged.model;
+  }
+  if (options.playbook !== void 0) {
+    const playbook = options.playbook.trim();
+    if (playbook) merged.playbook = playbook;
+    else delete merged.playbook;
+  }
   return merged;
 }
 function parseArgsCsv(csv) {
@@ -29434,6 +29586,8 @@ function formatAgentLine(a) {
   if (a.default) flags.push("default");
   if (a.resolveFromShellAliases) flags.push("shell-alias");
   if (a.promptArgPosition) flags.push(`prompt=${a.promptArgPosition}`);
+  if (a.model) flags.push(`model=${a.model}`);
+  if (a.playbook) flags.push(`playbook=${a.playbook}`);
   if (a.args && a.args.length > 0) flags.push(`args=[${a.args.join(", ")}]`);
   const suffix = flags.length > 0 ? ` (${flags.join(", ")})` : "";
   return `${a.id}: ${a.label} \u2192 ${a.command}${suffix}`;