taskflow-hosts 0.1.8 → 0.2.1

package/dist/codex-runner.js

@@ -28,8 +28,9 @@
  * error sanitization) is delegated to the shared `runSubagentProcess` in
  * taskflow-core, so behavior is uniform across hosts.
  */
-import { runSubagentProcess, num, unknownAgentResult, } from "taskflow-core";
+import { runSubagentProcess, sanitizeErrorMessage, num, unknownAgentResult, } from "taskflow-core";
 import { emptyUsage } from "taskflow-core";
+import { filteredChildEnv } from "./child-env.js";
 /** Benign codex `error` items that are warnings, not failures. Matched as a
  *  prefix/substring so version drift in the message tail still classifies. */
 const BENIGN_ERROR_MARKERS = [
@@ -63,16 +64,26 @@ export function foldCodexEventLine(acc, line) {
         return null;
     }
     let activity = "";
-    if (event.type === "turn.completed" && event.usage) {
+    if (event.type === "turn.completed") {
+        acc.terminalSeen = true;
         const u = event.usage;
-        acc.usage.turns++;
-        acc.usage.input += num(u.input_tokens);
-        acc.usage.output += num(u.output_tokens) + num(u.reasoning_output_tokens);
-        acc.usage.cacheRead += num(u.cached_input_tokens);
-        // contextTokens is a host-specific point-in-time gauge (NOT additive — excluded from aggregateUsage):
-        // each host's formula differs because each accounts for cache differently. Codex's input_tokens
-        // already includes cached tokens, so input+output = full last-turn context.
-        acc.usage.contextTokens = num(u.input_tokens) + num(u.output_tokens);
+        if (u) {
+            acc.usage.turns++;
+            acc.usage.input += num(u.input_tokens);
+            acc.usage.output += num(u.output_tokens) + num(u.reasoning_output_tokens);
+            acc.usage.cacheRead += num(u.cached_input_tokens);
+            // contextTokens is a host-specific point-in-time gauge (NOT additive — excluded from aggregateUsage):
+            // each host's formula differs because each accounts for cache differently. Codex's input_tokens
+            // already includes cached tokens, so input+output = full last-turn context.
+            acc.usage.contextTokens = num(u.input_tokens) + num(u.output_tokens);
+        }
+    }
+    else if (event.type === "turn.failed" || event.type === "error") {
+        const message = (typeof event.error?.message === "string" && event.error.message) ||
+            (typeof event.message === "string" && event.message) ||
+            "codex turn failed";
+        acc.fatalError = message;
+        activity = `error: ${message}`;
     }
     else if (event.type === "item.completed" || event.type === "item.started") {
         const item = event.item;
@@ -113,6 +124,9 @@ export function foldCodexEventLine(acc, line) {
 export function codexBin() {
     return process.env.PI_TASKFLOW_CODEX_BIN || "codex";
 }
+export function codexChildEnv(source = process.env) {
+    return filteredChildEnv(source, ["CODEX_HOME"], ["CODEX_", "OPENAI_", "AZURE_OPENAI_"]);
+}
 /**
  * Map a phase's tool whitelist to a codex sandbox mode. Codex has no per-tool
  * whitelist; it has sandbox policies. The conservative mapping: a phase that
@@ -141,22 +155,50 @@ export function resolveCodexModel(model) {
         return undefined;
     return model;
 }
+/** Map Taskflow/Pi thinking levels to Codex's model_reasoning_effort config. */
+export function resolveCodexThinking(thinking) {
+    if (!thinking)
+        return undefined;
+    const normalized = thinking.trim().toLowerCase();
+    if (normalized === "off" || normalized === "none" || normalized === "minimal")
+        return "none";
+    if (normalized === "max" || normalized === "ultra")
+        return "xhigh";
+    if (["low", "medium", "high", "xhigh"].includes(normalized))
+        return normalized;
+    throw new Error(`Unsupported Codex thinking level '${thinking}'. Use off, none, minimal, low, medium, high, xhigh, max, or ultra.`);
+}
 /**
  * Build the full `codex exec` argv from a phase's resolved context — PURE
  * (no process.env, no spawn). Extracted from `runCodexAgentTask` so the host's
  * CLI flag contract is unit-testable in CI without a live codex session.
  *
- *   codex exec --json --skip-git-repo-check -s <sandbox> [-m model] [-C cwd] <prompt>
+ *   codex exec --json --skip-git-repo-check -s <sandbox>
+ *        [-m model] [-c model_reasoning_effort=level] [-C cwd] <prompt>
  */
 export function buildCodexArgs(ctx) {
     const sandbox = sandboxForTools(ctx.tools);
     const codexModel = resolveCodexModel(ctx.model);
+    const codexThinking = resolveCodexThinking(ctx.thinking);
     const fullPrompt = ctx.systemPrompt.trim()
         ? `${ctx.systemPrompt.trim()}\n\n---\n\nTask: ${ctx.task}`
         : `Task: ${ctx.task}`;
-    const args = ["exec", "--json", "--skip-git-repo-check", "-s", sandbox];
+    const args = [
+        "exec",
+        "--json",
+        "--ephemeral",
+        "--ignore-user-config",
+        "--ignore-rules",
+        "--skip-git-repo-check",
+        "-c",
+        "mcp_servers={}",
+        "-s",
+        sandbox,
+    ];
     if (codexModel)
         args.push("-m", codexModel);
+    if (codexThinking)
+        args.push("-c", `model_reasoning_effort=${codexThinking}`);
     if (ctx.cwd)
         args.push("-C", ctx.cwd);
     args.push(fullPrompt);
@@ -172,27 +214,48 @@ export async function runCodexAgentTask(defaultCwd, agents, agentName, task, opt
         return unknownAgentResult(agentName, task, agents);
     const model = opts.model ?? agent.model;
     const tools = opts.tools ?? agent.tools;
-    void globalThinking; // codex has no thinking-level flag on exec; reserved.
+    const thinking = opts.thinking ?? agent.thinking ?? globalThinking;
     const cwd = opts.cwd ?? defaultCwd;
-    const args = buildCodexArgs({
-        systemPrompt: agent.systemPrompt,
-        task,
-        model,
-        tools,
-        cwd,
-    });
+    let args;
+    try {
+        args = buildCodexArgs({
+            systemPrompt: agent.systemPrompt,
+            task,
+            model,
+            thinking,
+            tools,
+            cwd,
+        });
+    }
+    catch (error) {
+        const message = sanitizeErrorMessage(error instanceof Error ? error.message : String(error));
+        return {
+            agent: agentName,
+            task,
+            exitCode: 1,
+            output: "",
+            stderr: message,
+            usage: emptyUsage(),
+            model,
+            stopReason: "error",
+            errorMessage: message,
+        };
+    }
     return runSubagentProcess({
         agent: agentName,
         task,
         model,
         bin: codexBin(),
         args,
+        env: codexChildEnv(),
         cwd,
         idleTimeoutMs: opts.idleTimeoutMs,
         signal: opts.signal,
         onLive: opts.onLive,
         acc: newCodexAccumulator(model),
         foldLine: foldCodexEventLine,
+        requireTerminalEvent: true,
+        terminalEventLabel: "Codex turn.completed",
     });
 }
 /**
@@ -201,5 +264,7 @@ export async function runCodexAgentTask(defaultCwd, agents, agentName, task, opt
  */
 export const codexSubagentRunner = {
     runTask: runCodexAgentTask,
+    usageAccounting: "tokens-only",
 };
+runCodexAgentTask.usageAccounting = "tokens-only";
 //# sourceMappingURL=codex-runner.js.map

package/dist/codex-runner.js.map

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

package/dist/grok-runner.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Grok Build subagent runner — the Grok host's `SubagentRunner` implementation.
+ *
+ * Spawns an isolated `grok -p --output-format streaming-json` process per task
+ * and folds its NDJSON event stream into the same host-neutral `RunResult` the
+ * pi/codex/claude/opencode runners produce, so the engine (runtime.ts) treats a
+ * Grok subagent identically.
+ *
+ * Official headless streaming-json schema (docs.x.ai / ~/.grok/docs/user-guide/14-headless-mode.md):
+ *   {"type":"text","data":"…"}                         ← response text chunk
+ *   {"type":"thought","data":"…"}                      ← reasoning (not answer)
+ *   {"type":"end","stopReason":"EndTurn","sessionId":"…","requestId":"…"}
+ *   {"type":"error","message":"…"}                     ← fatal
+ *   (also non-exhaustive: max_turns_reached, auto_compact_*, …)
+ *
+ * Mapping to the host-neutral contract:
+ *   - output       = concatenated `text` event data (final answer)
+ *   - lastActivity = latest text/thought chunk or end/error summary
+ *   - usage        = zeros today because Grok 0.2.93 streaming-json does not
+ *                    emit token/cost fields. The runner advertises that fact
+ *                    so budgeted MCP runs are rejected instead of silently
+ *                    running without a ceiling.
+ *   - failure      = an `error` event, or a non-zero process exit
+ *
+ * Permission mapping (codex `sandboxForTools` analogue):
+ *   - read-only whitelist → an operator-configured custom profile extending
+ *     `read-only`, a known-good `--tools` allowlist, and mutator deny rules
+ *   - mutating / no whitelist → an operator-configured custom sandbox plus
+ *     `--always-approve`. Grok's built-in profiles can warn and continue
+ *     unsandboxed on unsupported hosts; explicit custom profiles fail closed.
+ *
+ * Process handling (idle watchdog, abort, signal-kill, stderr cap, sanitize)
+ * is delegated to shared `runSubagentProcess` in taskflow-core.
+ *
+ * @see https://docs.x.ai/build/overview
+ * @see ~/.grok/docs/user-guide/14-headless-mode.md
+ * @see ~/.grok/docs/user-guide/07-mcp-servers.md
+ * @see ~/.grok/docs/user-guide/09-plugins.md
+ */
+import { type AgentConfig, type LiveUpdate, type RunOptions, type RunResult, type SubagentRunner, type UsageStats } from "taskflow-core";
+/** Custom sandbox profile required for mutating Grok phases. Built-in profiles
+ * may warn and continue without enforcement when the host cannot apply them;
+ * Grok documents explicitly requested custom profiles as fail-closed. */
+export declare const GROK_MUTATING_SANDBOX_PROFILE_ENV = "PI_TASKFLOW_GROK_MUTATING_SANDBOX_PROFILE";
+export declare const GROK_READONLY_SANDBOX_PROFILE_ENV = "PI_TASKFLOW_GROK_READONLY_SANDBOX_PROFILE";
+/** Accumulated state folded from a Grok streaming-json event stream. */
+export interface GrokAccumulator {
+    usage: UsageStats;
+    model?: string;
+    /** Final answer = concatenation of all `text` event `data` chunks. */
+    finalText: string;
+    lastActivity: string;
+    /** Set when the stream reported a fatal `error` event. */
+    fatalError?: string;
+    /** stopReason from the terminal `end` event, if any. */
+    stopReason?: string;
+    /** sessionId from the terminal `end` event (useful for resume diagnostics). */
+    sessionId?: string;
+    terminalSeen?: boolean;
+}
+export declare function newGrokAccumulator(model?: string): GrokAccumulator;
+/**
+ * Fold one Grok streaming-json NDJSON line into the accumulator. Returns a
+ * LiveUpdate when the stream produced new activity, else null. Empty/malformed
+ * lines are ignored — robust to partial buffers and noise, unit-testable
+ * without spawning a process.
+ */
+export declare function foldGrokEventLine(acc: GrokAccumulator, line: string): LiveUpdate | null;
+/** Override the grok binary (tests / unusual installs). */
+export declare function grokBin(): string;
+export declare function grokChildEnv(source?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/**
+ * Map a phase's tool whitelist to Grok headless permission flags.
+ *
+ * - no whitelist / mutating tools → an operator-configured fail-closed custom
+ *   sandbox plus `--always-approve`
+ * - read-only whitelist → a fail-closed custom read-only sandbox plus a narrow
+ *   allowlist and independent deny rules (still pairs with `--always-approve`
+ *   so the remaining safe tools never block on confirm)
+ */
+export declare function resolveGrokMutatingSandboxProfile(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function resolveGrokReadOnlySandboxProfile(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function permissionArgsForGrokTools(tools: string[] | undefined, mutatingSandboxProfile?: string, readOnlySandboxProfile?: string): string[];
+/** Map Taskflow/Pi thinking levels to Grok's --reasoning-effort contract. */
+export declare function resolveGrokThinking(thinking: string | undefined): string | undefined;
+/**
+ * Resolve a modelRoles/pi model id for `grok -m`, or `undefined` to let Grok
+ * use its configured default. Drop pi-provider paths (contain `/` with more
+ * than one segment is rare for grok; a single slash may be a custom model id
+ * from config.toml `[model.x]`) and unresolved `{{placeholder}}`s.
+ *
+ * Grok custom models are flat keys in `~/.grok/config.toml` (e.g. `my-model`,
+ * `grok-build`); pi-style `provider/model` paths are not valid Grok model ids
+ * unless the user defined them literally.
+ */
+export declare function resolveGrokModel(model: string | undefined): string | undefined;
+/** Context for {@link buildGrokArgs} — pure inputs to argv construction. */
+export interface GrokArgsCtx {
+    systemPrompt: string;
+    task: string;
+    /** Already-resolved model (opts.model ?? agent.model). */
+    model?: string;
+    thinking?: string;
+    tools?: string[];
+    cwd?: string;
+    /** Explicit custom sandbox profile used for mutating/default-capable phases. */
+    mutatingSandboxProfile?: string;
+    /** Explicit custom sandbox profile used for read-only phases. */
+    readOnlySandboxProfile?: string;
+}
+/**
+ * Build the full `grok -p` argv from a phase's resolved context — PURE
+ * (no process.env, no spawn). Extracted so the host's CLI flag contract is
+ * unit-testable in CI without a live Grok session.
+ *
+ *   grok -p <task> --output-format streaming-json
+ *        [--sandbox <custom-mutating> --always-approve |
+ *         --sandbox <custom-read-only> --tools … --always-approve]
+ *        [--model m] [--reasoning-effort level] [--cwd dir] [--rules systemPrompt]
+ */
+export declare function buildGrokArgs(ctx: GrokArgsCtx): string[];
+/**
+ * Run a single subagent task via `grok -p --output-format streaming-json`.
+ * Resolves the agent from `agents` by name; returns the same structured
+ * `RunResult` the other host runners do.
+ */
+export declare function runGrokAgentTask(defaultCwd: string, agents: AgentConfig[], agentName: string, task: string, opts: RunOptions, globalThinking?: string): Promise<RunResult>;
+/**
+ * The Grok host's `SubagentRunner`. Drops into `RuntimeDeps.runTask` exactly
+ * like the other host runners, so the engine runs unchanged on Grok Build.
+ */
+export declare const grokSubagentRunner: SubagentRunner<AgentConfig>;
+//# sourceMappingURL=grok-runner.d.ts.map

package/dist/grok-runner.d.ts.map

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