syntaur 0.40.0 → 0.41.2

package/dist/launch/index.d.ts

@@ -26,6 +26,14 @@ interface ParsedOpenUrl {
      * process may still be writing the transcript.
      */
     mode?: SessionMode;
+    /**
+     * Optional agent id to launch with (the `agent=` query param). Lets the
+     * dashboard's "Open in agent" picker launch a specific runner profile instead
+     * of the configured default. Only honored for `kind === 'assignment'`; for
+     * sessions the agent is pinned by the session record, so the value is
+     * parsed-but-ignored rather than rejected (keeps the parser simple).
+     */
+    agent?: string;
 }
 /**
  * Parse a `syntaur://open?assignment=<id>` or `syntaur://open?session=<id>` URL.
@@ -69,6 +77,20 @@ interface AgentConfig {
     resolveFromShellAliases?: boolean;
     resume?: SessionInvocation;
     fork?: SessionInvocation;
+    /**
+     * Optional LLM model for this runner profile, injected into the launched CLI
+     * as a generic `--model <value>` flag (see `modelFlagArgs`). Blank/undefined
+     * omits the flag entirely (today's behavior). Works for agents whose CLI
+     * accepts `--model` (claude, codex); leave blank for agents that don't.
+     */
+    model?: string;
+    /**
+     * Optional playbook slug for this runner profile. When set, a fresh "Open in
+     * agent" launch seeds a prompt that grabs the assignment AND runs this
+     * playbook end-to-end (see `INITIAL_PROMPT`). Blank/undefined keeps the plain
+     * `/grab-assignment` seed.
+     */
+    playbook?: string;
 }
 
 interface WorkspaceVisibilityConfig {
@@ -208,6 +230,14 @@ interface ResolveLaunchPlanInput {
      * dialog can confirm a different terminal without mutating user config.
      */
     terminalOverride?: TerminalChoice;
+    /**
+     * Only consulted when `kind === 'assignment'`. The agent id to launch with,
+     * wired from `?agent=<id>` on the incoming `syntaur://` URL so the dashboard's
+     * "Open in agent" picker can launch a specific runner profile. When unset,
+     * falls back to `pickAgent(config)` (the default agent). An unknown id throws
+     * `LaunchError('agent-not-configured')`.
+     */
+    agentId?: string;
 }
 /**
  * Pick the agent the "Open in agent" flow should use. Order of preference:

package/dist/launch/index.js

@@ -696,6 +696,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"() {
@@ -750,6 +772,16 @@ var init_agents_schema = __esm({
   }
 });
 
+// src/utils/slug.ts
+function isValidSlug(slug) {
+  return /^[a-z0-9]+(-[a-z0-9]+)*$/.test(slug);
+}
+var init_slug = __esm({
+  "src/utils/slug.ts"() {
+    "use strict";
+  }
+});
+
 // src/utils/workspace-visibility-schema.ts
 function normalizeHiddenList(input) {
   if (!Array.isArray(input)) return [];
@@ -818,6 +850,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++;
@@ -1195,6 +1237,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 } : {}
     });
@@ -1377,6 +1421,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;
   }
 }
 async function readConfig() {
@@ -1511,6 +1561,7 @@ var init_config2 = __esm({
     init_lifecycle();
     init_hotkeysCatalog();
     init_agents_schema();
+    init_slug();
     init_terminal_schema();
     init_workspace_visibility_schema();
     DEFAULT_CONFIG = {
@@ -1560,7 +1611,9 @@ var init_config2 = __esm({
       "command",
       "promptArgPosition",
       "default",
-      "resolveFromShellAliases"
+      "resolveFromShellAliases",
+      "model",
+      "playbook"
     ]);
     migratedConfigPaths = /* @__PURE__ */ new Set();
     TerminalConfigError = class extends Error {
@@ -1645,13 +1698,6 @@ var init_assignment_resolver = __esm({
   }
 });
 
-// src/utils/slug.ts
-var init_slug = __esm({
-  "src/utils/slug.ts"() {
-    "use strict";
-  }
-});
-
 // src/utils/playbooks.ts
 import { resolve as resolve8 } from "path";
 import { readdir as readdir4, readFile as readFile7, unlink } from "fs/promises";
@@ -2832,6 +2878,17 @@ function parseOpenUrl(input) {
     }
     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() === "") {
@@ -2840,7 +2897,12 @@ function parseOpenUrl(input) {
         "`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];
@@ -2865,7 +2927,13 @@ function parseOpenUrl(input) {
       }
       mode = raw;
     }
-    return { kind: "session", id, mode, ...terminal ? { terminal } : {} };
+    return {
+      kind: "session",
+      id,
+      mode,
+      ...terminal ? { terminal } : {},
+      ...agent ? { agent } : {}
+    };
   }
   throw new OpenUrlError(
     "missing-id",
@@ -2880,6 +2948,7 @@ init_api();
 
 // src/tui/launch.ts
 init_api();
+init_agents_schema();
 import { spawn } from "child_process";
 import { mkdir as mkdir2, writeFile as writeFile4 } from "fs/promises";
 import { isAbsolute as isAbsolute3, resolve as resolve12 } from "path";
@@ -2927,13 +2996,18 @@ function formatFallbackCwdWarning(opts) {
 
 // src/tui/launch.ts
 var INITIAL_PROMPT = (params) => {
-  if (params.projectSlug) {
-    return `/grab-assignment ${params.projectSlug} ${params.assignmentSlug}`;
-  }
-  if (params.id) {
-    return `/grab-assignment --id ${params.id}`;
+  const playbook = params.playbook?.trim();
+  if (!playbook) {
+    if (params.projectSlug) {
+      return `/grab-assignment ${params.projectSlug} ${params.assignmentSlug}`;
+    }
+    if (params.id) {
+      return `/grab-assignment --id ${params.id}`;
+    }
+    return `/grab-assignment ${params.assignmentSlug}`;
   }
-  return `/grab-assignment ${params.assignmentSlug}`;
+  const grabClause = params.projectSlug ? `the assignment \`${params.projectSlug}/${params.assignmentSlug}\` using the /grab-assignment skill` : params.id ? `the assignment id \`${params.id}\` using /grab-assignment --id ${params.id}` : `the assignment \`${params.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.`;
 };
 function shellQuote(arg) {
   if (arg === "") return "''";
@@ -2941,7 +3015,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;
@@ -2967,6 +3041,7 @@ function buildAgentArgv(agent, prompt, env = process.env) {
 init_agent_sessions();
 
 // src/launch/argv.ts
+init_agents_schema();
 import { isAbsolute as isAbsolute4 } from "path";
 var buildFreshArgv = buildAgentArgv;
 function buildSessionArgv(agent, sessionId, mode, env = process.env) {
@@ -2981,7 +3056,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;
@@ -3062,13 +3137,26 @@ async function resolveAssignmentPlan(input, terminal) {
   }
   const cwd = picked.cwd;
   const fallbackWarning = picked.fallbackWarning;
-  const agent = pickAgent(input.config);
+  let agent;
+  if (input.agentId) {
+    const found = getAgents(input.config).find((a) => a.id === input.agentId);
+    if (!found) {
+      throw new LaunchError(
+        "agent-not-configured",
+        `Agent "${input.agentId}" requested in the open URL is not in your agents list.`
+      );
+    }
+    agent = found;
+  } else {
+    agent = pickAgent(input.config);
+  }
   const { argv, shellFallbackWarning } = buildFreshArgv(
     agent,
     INITIAL_PROMPT({
       projectSlug: resolved.projectSlug,
       assignmentSlug: resolved.assignmentSlug,
-      id: resolved.id
+      id: resolved.id,
+      playbook: agent.playbook
     })
   );
   return {