takt 0.3.7 → 0.3.9

package/README.md

@@ -78,10 +78,9 @@ If `--auto-pr` is specified, the PR is created automatically without asking.
 | Workflow | Best for |
 |----------|----------|
 | `default` | Full development tasks. Used for TAKT's own development. Multi-stage review with parallel architect + security review. |
-| `simple` | Lightweight tasks like README updates or small fixes. Reviews without fix loops. |
-| `expert` / `expert-cqrs` | Web development projects. Sequential multi-expert review with fix loops (`expert`: Architecture, Frontend, Security, QA; `expert-cqrs`: CQRS+ES, Frontend, Security, QA). |
+| `minimal` | Quick fixes and simple tasks. Minimal workflow with basic review. |
+| `review-fix-minimal` | Review and fix workflow. Focused on iterative improvements with review feedback. |
 | `research` | Research and investigation. Autonomous research without asking questions. |
-| `magi` | Fun deliberation. Three AI personas analyze and vote (Evangelion-inspired). |
 
 ## Commands
 
@@ -156,12 +155,16 @@ In pipeline mode, PRs are **not** created unless `--auto-pr` is explicitly speci
 | `--pipeline` | **Enable pipeline (non-interactive) mode** — required for CI/automation |
 | `-t, --task <text>` | Task content (as alternative to GitHub issue) |
 | `-i, --issue <N>` | GitHub issue number (equivalent to `#N` in interactive mode) |
-| `-w, --workflow <name>` | Workflow to use |
+| `-w, --workflow <name or path>` | Workflow name or path to workflow YAML file |
 | `-b, --branch <name>` | Branch name (auto-generated if omitted) |
 | `--auto-pr` | Create PR after execution (interactive: skip confirmation, pipeline: enable PR) |
 | `--skip-git` | Skip branch creation, commit, and push (pipeline mode, workflow-only) |
 | `--repo <owner/repo>` | Repository for PR creation |
 | `--create-worktree <yes\|no>` | Skip worktree confirmation prompt |
+| `-q, --quiet` | Minimal output mode: suppress AI output (for CI) |
+| `--provider <name>` | Override agent provider (claude\|codex\|mock) |
+| `--model <name>` | Override agent model |
+| `--config <path>` | Path to global config file (default: `~/.takt/config.yaml`) |
 
 ## Workflows
 
@@ -188,7 +191,7 @@ steps:
   - name: implement
     agent: ../agents/default/coder.md
     edit: true
-    permission_mode: acceptEdits
+    permission_mode: edit
     rules:
       - condition: Implementation complete
         next: review
@@ -209,6 +212,31 @@ steps:
       Review the implementation for architecture and code quality.
 ```
 
+### Agent-less Steps
+
+The `agent` field is optional. When omitted, the step executes using only the `instruction_template` without a system prompt. This is useful for simple tasks where agent behavior customization is not needed.
+
+```yaml
+  - name: summarize
+    # No agent specified — uses instruction_template only
+    edit: false
+    rules:
+      - condition: Summary complete
+        next: COMPLETE
+    instruction_template: |
+      Read the reports and provide a brief summary.
+```
+
+You can also provide an inline system prompt as the `agent` value (when the specified file does not exist):
+
+```yaml
+  - name: review
+    agent: "You are a code reviewer. Focus on readability and maintainability."
+    edit: false
+    instruction_template: |
+      Review the code for quality.
+```
+
 ### Parallel Steps
 
 Steps can execute sub-steps concurrently with aggregate evaluation:
@@ -255,12 +283,14 @@ TAKT ships with several built-in workflows:
 
 | Workflow | Description |
 |----------|-------------|
+| `minimal` | Quick workflow: plan → implement → review → supervisor. Minimal steps for fast iteration. |
 | `default` | Full development workflow: plan → implement → AI review → parallel reviewers (architect + security) → supervisor approval. Includes fix loops for each review stage. |
-| `simple` | Simplified version of default: plan → implement → architect review → AI review → supervisor. No intermediate fix steps. |
+| `review-fix-minimal` | Review-focused workflow: review → fix → supervisor. For iterative improvements based on review feedback. |
 | `research` | Research workflow: planner → digger → supervisor. Autonomously researches topics without asking questions. |
 | `expert` | Sequential review with domain experts: Architecture, Frontend, Security, QA reviews with fix loops. |
 | `expert-cqrs` | Sequential review with domain experts: CQRS+ES, Frontend, Security, QA reviews with fix loops. |
 | `magi` | Deliberation system inspired by Evangelion. Three AI personas (MELCHIOR, BALTHASAR, CASPER) analyze and vote. |
+| `review-only` | Read-only code review workflow without making any modifications. |
 
 Switch between workflows with `takt switch`.
 
@@ -416,7 +446,7 @@ steps:
   - name: implement
     agent: ~/.takt/agents/default/coder.md
     edit: true
-    permission_mode: acceptEdits
+    permission_mode: edit
     pass_previous_response: true
     rules:
       - condition: Done
@@ -451,9 +481,12 @@ TAKT supports batch task processing through task files in `.takt/tasks/`. Both `
 ```bash
 # Start AI conversation to define and add a task
 takt add
+
+# Add task from GitHub issue (issue number reflected in branch name)
+takt add #28
 ```
 
-The `takt add` command starts an AI conversation where you discuss and refine your task requirements. After confirming with `/go`, the AI summarizes the conversation and creates a YAML task file with optional worktree/branch/workflow settings.
+The `takt add` command starts an AI conversation where you discuss and refine your task requirements. After confirming with `/go`, the AI summarizes the conversation and creates a YAML task file with optional worktree/branch/workflow settings. When using `takt add #N`, the issue number is automatically reflected in the branch name (e.g., `takt/issue-28-...`).
 
 #### Task File Formats
 
@@ -585,7 +618,7 @@ Special `next` values: `COMPLETE` (success), `ABORT` (failure).
 | `allowed_tools` | - | List of tools the agent can use (Read, Glob, Grep, Edit, Write, Bash, etc.) |
 | `provider` | - | Override provider for this step (`claude` or `codex`) |
 | `model` | - | Override model for this step |
-| `permission_mode` | `default` | Permission mode: `default`, `acceptEdits`, or `bypassPermissions` |
+| `permission_mode` | - | Permission mode: `readonly`, `edit`, or `full` (provider-independent) |
 | `report` | - | Report file configuration (name, format) for auto-generated reports |
 
 ## API Usage

package/bin/takt

@@ -16,7 +16,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 // Import the actual CLI from dist
-const cliPath = join(__dirname, '..', 'dist', 'cli.js');
+const cliPath = join(__dirname, '..', 'dist', 'app', 'cli', 'index.js');
 
 try {
   await import(cliPath);

package/dist/agents/index.d.ts

@@ -1,5 +1,6 @@
 /**
  * Agents module - exports agent execution utilities
  */
-export * from './runner.js';
+export { AgentRunner, runAgent, runCustomAgent } from './runner.js';
+export type { RunAgentOptions, StreamCallback } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/agents/index.js

@@ -1,5 +1,5 @@
 /**
  * Agents module - exports agent execution utilities
  */
-export * from './runner.js';
+export { AgentRunner, runAgent, runCustomAgent } from './runner.js';
 //# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/agents/runner.d.ts

@@ -1,31 +1,34 @@
 /**
  * Agent execution runners
  */
-import { type StreamCallback, type PermissionHandler, type AskUserQuestionHandler } from '../claude/process.js';
-import type { AgentResponse, CustomAgentConfig, PermissionMode } from '../models/types.js';
-export type { StreamCallback };
-/** Common options for running agents */
-export interface RunAgentOptions {
-    cwd: string;
-    sessionId?: string;
-    model?: string;
-    provider?: 'claude' | 'codex' | 'mock';
-    /** Resolved path to agent prompt file */
-    agentPath?: string;
-    /** Allowed tools for this agent run */
-    allowedTools?: string[];
-    /** Maximum number of agentic turns */
-    maxTurns?: number;
-    /** Permission mode for tool execution (from workflow step) */
-    permissionMode?: PermissionMode;
-    onStream?: StreamCallback;
-    onPermissionRequest?: PermissionHandler;
-    onAskUserQuestion?: AskUserQuestionHandler;
-    /** Bypass all permission checks (sacrifice-my-pc mode) */
-    bypassPermissions?: boolean;
+import type { AgentResponse, CustomAgentConfig } from '../core/models/index.js';
+import type { RunAgentOptions } from './types.js';
+export type { RunAgentOptions, StreamCallback } from './types.js';
+/**
+ * Agent execution runner.
+ *
+ * Resolves agent configuration (provider, model, prompt) and
+ * delegates execution to the appropriate provider.
+ */
+export declare class AgentRunner {
+    /** Resolve provider type from options, agent config, project config, global config */
+    private static resolveProvider;
+    /** Resolve model from options, agent config, global config */
+    private static resolveModel;
+    /** Load agent prompt from file path */
+    private static loadAgentPromptFromPath;
+    /**
+     * Get agent name from path or spec.
+     * For agents in subdirectories, includes parent dir for pattern matching.
+     */
+    private static extractAgentName;
+    /** Run a custom agent */
+    runCustom(agentConfig: CustomAgentConfig, task: string, options: RunAgentOptions): Promise<AgentResponse>;
+    /** Build ProviderCallOptions from RunAgentOptions with optional systemPrompt override */
+    private static buildProviderCallOptions;
+    /** Run an agent by name, path, inline prompt string, or no agent at all */
+    run(agentSpec: string | undefined, task: string, options: RunAgentOptions): Promise<AgentResponse>;
 }
-/** Run a custom agent */
+export declare function runAgent(agentSpec: string | undefined, task: string, options: RunAgentOptions): Promise<AgentResponse>;
 export declare function runCustomAgent(agentConfig: CustomAgentConfig, task: string, options: RunAgentOptions): Promise<AgentResponse>;
-/** Run an agent by name or path */
-export declare function runAgent(agentSpec: string, task: string, options: RunAgentOptions): Promise<AgentResponse>;
 //# sourceMappingURL=runner.d.ts.map

package/dist/agents/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agents/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAKhH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAK3F,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACvC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AA8BD,yBAAyB;AACzB,wBAAsB,cAAc,CAClC,WAAW,EAAE,iBAAiB,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,aAAa,CAAC,CAyDxB;AAqCD,mCAAmC;AACnC,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,aAAa,CAAC,CAgDxB"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agents/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIlE;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,sFAAsF;IACtF,OAAO,CAAC,MAAM,CAAC,eAAe;IAkB9B,8DAA8D;IAC9D,OAAO,CAAC,MAAM,CAAC,YAAY;IAgB3B,uCAAuC;IACvC,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAOtC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAe/B,yBAAyB;IACnB,SAAS,CACb,WAAW,EAAE,iBAAiB,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,aAAa,CAAC;IA2DzB,yFAAyF;IACzF,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAmBvC,2EAA2E;IACrE,GAAG,CACP,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,aAAa,CAAC;CAwC1B;AAMD,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,aAAa,CAAC,CAExB;AAED,wBAAsB,cAAc,CAClC,WAAW,EAAE,iBAAiB,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/agents/runner.js

@@ -3,156 +3,136 @@
  */
 import { existsSync, readFileSync } from 'node:fs';
 import { basename, dirname } from 'node:path';
-import { callClaudeAgent, callClaudeSkill, } from '../claude/client.js';
-import { loadCustomAgents, loadAgentPrompt } from '../config/loader.js';
-import { loadGlobalConfig } from '../config/globalConfig.js';
-import { loadProjectConfig } from '../config/projectConfig.js';
-import { getProvider } from '../providers/index.js';
-import { createLogger } from '../utils/debug.js';
+import { callClaudeAgent, callClaudeSkill, } from '../infra/claude/index.js';
+import { loadCustomAgents, loadAgentPrompt, loadGlobalConfig, loadProjectConfig } from '../infra/config/index.js';
+import { getProvider } from '../infra/providers/index.js';
+import { createLogger } from '../shared/utils/index.js';
 const log = createLogger('runner');
-function resolveProvider(cwd, options, agentConfig) {
-    // Mock provider must be explicitly specified (no fallback)
-    if (options?.provider)
-        return options.provider;
-    if (agentConfig?.provider)
-        return agentConfig.provider;
-    const projectConfig = loadProjectConfig(cwd);
-    if (projectConfig.provider)
-        return projectConfig.provider;
-    try {
-        const globalConfig = loadGlobalConfig();
-        if (globalConfig.provider)
-            return globalConfig.provider;
-    }
-    catch {
-        // Ignore missing global config; fallback below
+/**
+ * Agent execution runner.
+ *
+ * Resolves agent configuration (provider, model, prompt) and
+ * delegates execution to the appropriate provider.
+ */
+export class AgentRunner {
+    /** Resolve provider type from options, agent config, project config, global config */
+    static resolveProvider(cwd, options, agentConfig) {
+        if (options?.provider)
+            return options.provider;
+        if (agentConfig?.provider)
+            return agentConfig.provider;
+        const projectConfig = loadProjectConfig(cwd);
+        if (projectConfig.provider)
+            return projectConfig.provider;
+        try {
+            const globalConfig = loadGlobalConfig();
+            if (globalConfig.provider)
+                return globalConfig.provider;
+        }
+        catch {
+            // Ignore missing global config; fallback below
+        }
+        return 'claude';
     }
-    return 'claude';
-}
-function resolveModel(cwd, options, agentConfig) {
-    if (options?.model)
-        return options.model;
-    if (agentConfig?.model)
-        return agentConfig.model;
-    try {
-        const globalConfig = loadGlobalConfig();
-        if (globalConfig.model)
-            return globalConfig.model;
+    /** Resolve model from options, agent config, global config */
+    static resolveModel(cwd, options, agentConfig) {
+        if (options?.model)
+            return options.model;
+        if (agentConfig?.model)
+            return agentConfig.model;
+        try {
+            const globalConfig = loadGlobalConfig();
+            if (globalConfig.model)
+                return globalConfig.model;
+        }
+        catch {
+            // Ignore missing global config
+        }
+        return undefined;
     }
-    catch {
-        // Ignore missing global config
+    /** Load agent prompt from file path */
+    static loadAgentPromptFromPath(agentPath) {
+        if (!existsSync(agentPath)) {
+            throw new Error(`Agent file not found: ${agentPath}`);
+        }
+        return readFileSync(agentPath, 'utf-8');
     }
-    return undefined;
-}
-/** Run a custom agent */
-export async function runCustomAgent(agentConfig, task, options) {
-    const allowedTools = options.allowedTools ?? agentConfig.allowedTools;
-    // If agent references a Claude Code agent
-    if (agentConfig.claudeAgent) {
-        const callOptions = {
-            cwd: options.cwd,
-            sessionId: options.sessionId,
-            allowedTools,
-            maxTurns: options.maxTurns,
-            model: resolveModel(options.cwd, options, agentConfig),
-            permissionMode: options.permissionMode,
-            onStream: options.onStream,
-            onPermissionRequest: options.onPermissionRequest,
-            onAskUserQuestion: options.onAskUserQuestion,
-            bypassPermissions: options.bypassPermissions,
-        };
-        return callClaudeAgent(agentConfig.claudeAgent, task, callOptions);
+    /**
+     * Get agent name from path or spec.
+     * For agents in subdirectories, includes parent dir for pattern matching.
+     */
+    static extractAgentName(agentSpec) {
+        if (!agentSpec.endsWith('.md')) {
+            return agentSpec;
+        }
+        const name = basename(agentSpec, '.md');
+        const dir = basename(dirname(agentSpec));
+        if (dir === 'default' || dir === 'agents' || dir === '.') {
+            return name;
+        }
+        return `${dir}/${name}`;
     }
-    // If agent references a Claude Code skill
-    if (agentConfig.claudeSkill) {
+    /** Run a custom agent */
+    async runCustom(agentConfig, task, options) {
+        const allowedTools = options.allowedTools ?? agentConfig.allowedTools;
+        // If agent references a Claude Code agent
+        if (agentConfig.claudeAgent) {
+            const callOptions = {
+                cwd: options.cwd,
+                sessionId: options.sessionId,
+                allowedTools,
+                maxTurns: options.maxTurns,
+                model: AgentRunner.resolveModel(options.cwd, options, agentConfig),
+                permissionMode: options.permissionMode,
+                onStream: options.onStream,
+                onPermissionRequest: options.onPermissionRequest,
+                onAskUserQuestion: options.onAskUserQuestion,
+                bypassPermissions: options.bypassPermissions,
+            };
+            return callClaudeAgent(agentConfig.claudeAgent, task, callOptions);
+        }
+        // If agent references a Claude Code skill
+        if (agentConfig.claudeSkill) {
+            const callOptions = {
+                cwd: options.cwd,
+                sessionId: options.sessionId,
+                allowedTools,
+                maxTurns: options.maxTurns,
+                model: AgentRunner.resolveModel(options.cwd, options, agentConfig),
+                permissionMode: options.permissionMode,
+                onStream: options.onStream,
+                onPermissionRequest: options.onPermissionRequest,
+                onAskUserQuestion: options.onAskUserQuestion,
+                bypassPermissions: options.bypassPermissions,
+            };
+            return callClaudeSkill(agentConfig.claudeSkill, task, callOptions);
+        }
+        // Custom agent with prompt
+        const systemPrompt = loadAgentPrompt(agentConfig);
+        const providerType = AgentRunner.resolveProvider(options.cwd, options, agentConfig);
+        const provider = getProvider(providerType);
         const callOptions = {
             cwd: options.cwd,
             sessionId: options.sessionId,
             allowedTools,
             maxTurns: options.maxTurns,
-            model: resolveModel(options.cwd, options, agentConfig),
+            model: AgentRunner.resolveModel(options.cwd, options, agentConfig),
             permissionMode: options.permissionMode,
             onStream: options.onStream,
             onPermissionRequest: options.onPermissionRequest,
             onAskUserQuestion: options.onAskUserQuestion,
             bypassPermissions: options.bypassPermissions,
         };
-        return callClaudeSkill(agentConfig.claudeSkill, task, callOptions);
-    }
-    // Custom agent with prompt
-    const systemPrompt = loadAgentPrompt(agentConfig);
-    const providerType = resolveProvider(options.cwd, options, agentConfig);
-    const provider = getProvider(providerType);
-    const callOptions = {
-        cwd: options.cwd,
-        sessionId: options.sessionId,
-        allowedTools,
-        maxTurns: options.maxTurns,
-        model: resolveModel(options.cwd, options, agentConfig),
-        permissionMode: options.permissionMode,
-        onStream: options.onStream,
-        onPermissionRequest: options.onPermissionRequest,
-        onAskUserQuestion: options.onAskUserQuestion,
-        bypassPermissions: options.bypassPermissions,
-    };
-    return provider.callCustom(agentConfig.name, task, systemPrompt, callOptions);
-}
-/**
- * Load agent prompt from file path.
- */
-function loadAgentPromptFromPath(agentPath) {
-    if (!existsSync(agentPath)) {
-        throw new Error(`Agent file not found: ${agentPath}`);
+        return provider.callCustom(agentConfig.name, task, systemPrompt, callOptions);
     }
-    return readFileSync(agentPath, 'utf-8');
-}
-/**
- * Get agent name from path or spec.
- * For agents in subdirectories, includes parent dir for pattern matching.
- * - "~/.takt/agents/default/coder.md" -> "coder"
- * - "~/.takt/agents/research/supervisor.md" -> "research/supervisor"
- * - "./coder.md" -> "coder"
- * - "coder" -> "coder"
- */
-function extractAgentName(agentSpec) {
-    if (!agentSpec.endsWith('.md')) {
-        return agentSpec;
-    }
-    const name = basename(agentSpec, '.md');
-    const dir = basename(dirname(agentSpec));
-    // If in 'default' directory, just use the agent name
-    // Otherwise, include the directory for disambiguation (e.g., 'research/supervisor')
-    if (dir === 'default' || dir === 'agents' || dir === '.') {
-        return name;
-    }
-    return `${dir}/${name}`;
-}
-/** Run an agent by name or path */
-export async function runAgent(agentSpec, task, options) {
-    const agentName = extractAgentName(agentSpec);
-    log.debug('Running agent', {
-        agentSpec,
-        agentName,
-        provider: options.provider,
-        model: options.model,
-        hasAgentPath: !!options.agentPath,
-        hasSession: !!options.sessionId,
-        permissionMode: options.permissionMode,
-    });
-    // If agentPath is provided (from workflow), use it to load prompt
-    if (options.agentPath) {
-        if (!existsSync(options.agentPath)) {
-            throw new Error(`Agent file not found: ${options.agentPath}`);
-        }
-        const systemPrompt = loadAgentPromptFromPath(options.agentPath);
-        const providerType = resolveProvider(options.cwd, options);
-        const provider = getProvider(providerType);
-        const callOptions = {
+    /** Build ProviderCallOptions from RunAgentOptions with optional systemPrompt override */
+    static buildProviderCallOptions(options, systemPrompt) {
+        return {
             cwd: options.cwd,
             sessionId: options.sessionId,
             allowedTools: options.allowedTools,
             maxTurns: options.maxTurns,
-            model: resolveModel(options.cwd, options),
+            model: AgentRunner.resolveModel(options.cwd, options),
             systemPrompt,
             permissionMode: options.permissionMode,
             onStream: options.onStream,
@@ -160,14 +140,51 @@ export async function runAgent(agentSpec, task, options) {
             onAskUserQuestion: options.onAskUserQuestion,
             bypassPermissions: options.bypassPermissions,
         };
-        return provider.call(agentName, task, callOptions);
     }
-    // Fallback: Look for custom agent by name
-    const customAgents = loadCustomAgents();
-    const agentConfig = customAgents.get(agentName);
-    if (agentConfig) {
-        return runCustomAgent(agentConfig, task, options);
+    /** Run an agent by name, path, inline prompt string, or no agent at all */
+    async run(agentSpec, task, options) {
+        const agentName = agentSpec ? AgentRunner.extractAgentName(agentSpec) : 'default';
+        log.debug('Running agent', {
+            agentSpec: agentSpec ?? '(none)',
+            agentName,
+            provider: options.provider,
+            model: options.model,
+            hasAgentPath: !!options.agentPath,
+            hasSession: !!options.sessionId,
+            permissionMode: options.permissionMode,
+        });
+        // 1. If agentPath is provided (resolved file exists), load prompt from file
+        if (options.agentPath) {
+            const systemPrompt = AgentRunner.loadAgentPromptFromPath(options.agentPath);
+            const providerType = AgentRunner.resolveProvider(options.cwd, options);
+            const provider = getProvider(providerType);
+            return provider.call(agentName, task, AgentRunner.buildProviderCallOptions(options, systemPrompt));
+        }
+        // 2. If agentSpec is provided but no agentPath (file not found), try custom agent first,
+        //    then use the string as inline system prompt
+        if (agentSpec) {
+            const customAgents = loadCustomAgents();
+            const agentConfig = customAgents.get(agentName);
+            if (agentConfig) {
+                return this.runCustom(agentConfig, task, options);
+            }
+            // Use agentSpec string as inline system prompt
+            const providerType = AgentRunner.resolveProvider(options.cwd, options);
+            const provider = getProvider(providerType);
+            return provider.call(agentName, task, AgentRunner.buildProviderCallOptions(options, agentSpec));
+        }
+        // 3. No agent specified — run with instruction_template only (no system prompt)
+        const providerType = AgentRunner.resolveProvider(options.cwd, options);
+        const provider = getProvider(providerType);
+        return provider.call(agentName, task, AgentRunner.buildProviderCallOptions(options));
     }
-    throw new Error(`Unknown agent: ${agentSpec}`);
+}
+// ---- Backward-compatible module-level functions ----
+const defaultRunner = new AgentRunner();
+export async function runAgent(agentSpec, task, options) {
+    return defaultRunner.run(agentSpec, task, options);
+}
+export async function runCustomAgent(agentConfig, task, options) {
+    return defaultRunner.runCustom(agentConfig, task, options);
 }
 //# sourceMappingURL=runner.js.map

package/dist/agents/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/agents/runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/agents/runner.ts"],"names":[],"mappings":"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"}

package/dist/agents/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Type definitions for agent execution
+ */
+import type { StreamCallback, PermissionHandler, AskUserQuestionHandler } from '../infra/claude/index.js';
+import type { PermissionMode } from '../core/models/index.js';
+export type { StreamCallback };
+/** Common options for running agents */
+export interface RunAgentOptions {
+    cwd: string;
+    sessionId?: string;
+    model?: string;
+    provider?: 'claude' | 'codex' | 'mock';
+    /** Resolved path to agent prompt file */
+    agentPath?: string;
+    /** Allowed tools for this agent run */
+    allowedTools?: string[];
+    /** Maximum number of agentic turns */
+    maxTurns?: number;
+    /** Permission mode for tool execution (from workflow step) */
+    permissionMode?: PermissionMode;
+    onStream?: StreamCallback;
+    onPermissionRequest?: PermissionHandler;
+    onAskUserQuestion?: AskUserQuestionHandler;
+    /** Bypass all permission checks (sacrifice-my-pc mode) */
+    bypassPermissions?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC1G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACvC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/dist/agents/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for agent execution
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}