agentplane 0.3.7 → 0.3.8

package/dist/commands/task/run-resume.command.js

@@ -0,0 +1,55 @@
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { createCliEmitter, infoMessage } from "../../cli/output.js";
+import { loadCommandContext } from "../shared/task-backend.js";
+import { CliError } from "../../shared/errors.js";
+import { resumeTaskRunnerExecution } from "../../runner/usecases/task-run-lifecycle.js";
+export { taskRunResumeSpec } from "./run-resume.spec.js";
+const emitter = createCliEmitter();
+export const runTaskRunResume = async (ctx, parsed) => {
+    try {
+        const commandCtx = await loadCommandContext({
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+        });
+        const resumed = await resumeTaskRunnerExecution({
+            ctx: commandCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+            task_id: parsed.taskId,
+            run_id: parsed.runId,
+        });
+        const entries = [
+            { label: "run_id", value: parsed.runId },
+            { label: "previous_status", value: resumed.previous_status },
+            { label: "adapter", value: resumed.invocation.adapter_id },
+            { label: "state", value: resumed.invocation.state_path },
+            { label: "events", value: resumed.invocation.events_path },
+            { label: "status", value: resumed.result.status },
+            { label: "runner_exit_code", value: resumed.result.exit_code ?? "null" },
+        ];
+        if (resumed.result.stdout_summary) {
+            entries.push({ label: "stdout", value: resumed.result.stdout_summary });
+        }
+        emitter.report(entries, {
+            header: infoMessage(`task run resumed: ${parsed.taskId}`),
+        });
+        if (resumed.result.stderr_summary) {
+            emitter.report([{ label: "stderr", value: resumed.result.stderr_summary }], {
+                stream: "stderr",
+            });
+        }
+        return resumed.result.status === "success"
+            ? 0
+            : (resumed.result.exit_code ?? exitCodeForError("E_RUNTIME"));
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, {
+            command: "task run resume",
+            task_id: parsed.taskId,
+            run_id: parsed.runId,
+        });
+    }
+};

package/dist/commands/task/run-resume.spec.d.ts

@@ -0,0 +1,7 @@
+import type { CommandSpec } from "../../cli/spec/spec.js";
+export type TaskRunResumeParsed = {
+    taskId: string;
+    runId: string;
+};
+export declare const taskRunResumeSpec: CommandSpec<TaskRunResumeParsed>;
+//# sourceMappingURL=run-resume.spec.d.ts.map

package/dist/commands/task/run-resume.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-resume.spec.d.ts","sourceRoot":"","sources":["../../../src/commands/task/run-resume.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,MAAM,mBAAmB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,mBAAmB,CAoB9D,CAAC"}

package/dist/commands/task/run-resume.spec.js

@@ -0,0 +1,20 @@
+export const taskRunResumeSpec = {
+    id: ["task", "run", "resume"],
+    group: "Task",
+    summary: "Resume an existing execute-mode runner run in place.",
+    description: "Loads an existing execute-mode runner run from its artifacts and re-executes the configured adapter against the same bundle and run directory.",
+    args: [
+        { name: "task-id", required: true, valueHint: "<task-id>" },
+        { name: "run-id", required: true, valueHint: "<run-id>" },
+    ],
+    examples: [
+        {
+            cmd: "agentplane task run resume 202602030608-F1Q8AB run_20260323_abc123",
+            why: "Resume or re-execute a prepared/failed/cancelled run in place.",
+        },
+    ],
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        runId: String(raw.args["run-id"]),
+    }),
+};

package/dist/commands/task/run-retry.command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler } from "../../cli/spec/spec.js";
+import type { TaskRunRetryParsed } from "./run-retry.spec.js";
+export { taskRunRetrySpec } from "./run-retry.spec.js";
+export type { TaskRunRetryParsed } from "./run-retry.spec.js";
+export declare const runTaskRunRetry: CommandHandler<TaskRunRetryParsed>;
+//# sourceMappingURL=run-retry.command.d.ts.map

package/dist/commands/task/run-retry.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-retry.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/run-retry.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAUzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI9D,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAgD9D,CAAC"}

package/dist/commands/task/run-retry.command.js

@@ -0,0 +1,56 @@
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { createCliEmitter, infoMessage } from "../../cli/output.js";
+import { loadCommandContext } from "../shared/task-backend.js";
+import { CliError } from "../../shared/errors.js";
+import { retryTaskRunnerExecution } from "../../runner/usecases/task-run-lifecycle.js";
+export { taskRunRetrySpec } from "./run-retry.spec.js";
+const emitter = createCliEmitter();
+export const runTaskRunRetry = async (ctx, parsed) => {
+    try {
+        const commandCtx = await loadCommandContext({
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+        });
+        const retried = await retryTaskRunnerExecution({
+            ctx: commandCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+            task_id: parsed.taskId,
+            run_id: parsed.runId,
+        });
+        const entries = [
+            { label: "source_run_id", value: retried.source_run_id },
+            { label: "previous_status", value: retried.source_status },
+            { label: "run_id", value: retried.invocation.run_id },
+            { label: "adapter", value: retried.invocation.adapter_id },
+            { label: "state", value: retried.invocation.state_path },
+            { label: "events", value: retried.invocation.events_path },
+            { label: "status", value: retried.result.status },
+            { label: "runner_exit_code", value: retried.result.exit_code ?? "null" },
+        ];
+        if (retried.result.stdout_summary) {
+            entries.push({ label: "stdout", value: retried.result.stdout_summary });
+        }
+        emitter.report(entries, {
+            header: infoMessage(`task run retried: ${parsed.taskId}`),
+        });
+        if (retried.result.stderr_summary) {
+            emitter.report([{ label: "stderr", value: retried.result.stderr_summary }], {
+                stream: "stderr",
+            });
+        }
+        return retried.result.status === "success"
+            ? 0
+            : (retried.result.exit_code ?? exitCodeForError("E_RUNTIME"));
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, {
+            command: "task run retry",
+            task_id: parsed.taskId,
+            run_id: parsed.runId,
+        });
+    }
+};

package/dist/commands/task/run-retry.spec.d.ts

@@ -0,0 +1,7 @@
+import type { CommandSpec } from "../../cli/spec/spec.js";
+export type TaskRunRetryParsed = {
+    taskId: string;
+    runId: string;
+};
+export declare const taskRunRetrySpec: CommandSpec<TaskRunRetryParsed>;
+//# sourceMappingURL=run-retry.spec.d.ts.map

package/dist/commands/task/run-retry.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-retry.spec.d.ts","sourceRoot":"","sources":["../../../src/commands/task/run-retry.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAoB5D,CAAC"}

package/dist/commands/task/run-retry.spec.js

@@ -0,0 +1,20 @@
+export const taskRunRetrySpec = {
+    id: ["task", "run", "retry"],
+    group: "Task",
+    summary: "Retry an existing execute-mode runner run into a new run id.",
+    description: "Loads an existing runner run, snapshots its bundle into a new run id, and executes the configured adapter against the new run directory while retaining the source run for traceability.",
+    args: [
+        { name: "task-id", required: true, valueHint: "<task-id>" },
+        { name: "run-id", required: true, valueHint: "<run-id>" },
+    ],
+    examples: [
+        {
+            cmd: "agentplane task run retry 202602030608-F1Q8AB run_20260323_abc123",
+            why: "Create a new run from a failed/cancelled run snapshot and execute it.",
+        },
+    ],
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        runId: String(raw.args["run-id"]),
+    }),
+};

package/dist/commands/task/run-show.command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler } from "../../cli/spec/spec.js";
+import type { TaskRunShowParsed } from "./run-show.spec.js";
+export { taskRunShowSpec } from "./run-show.spec.js";
+export type { TaskRunShowParsed } from "./run-show.spec.js";
+export declare const runTaskRunShow: CommandHandler<TaskRunShowParsed>;
+//# sourceMappingURL=run-show.command.d.ts.map

package/dist/commands/task/run-show.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-show.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/run-show.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAYzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAqE5D,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,iBAAiB,CA6F5D,CAAC"}

package/dist/commands/task/run-show.command.js

@@ -0,0 +1,133 @@
+import { mapBackendError } from "../../cli/error-map.js";
+import { createCliEmitter, infoMessage } from "../../cli/output.js";
+import { CliError } from "../../shared/errors.js";
+import { formatRunnerCapabilitySummaryLines, formatRunnerPolicyFieldSummaryLines, } from "../../runner/policy-display.js";
+import { loadTaskRunnerInspection } from "../../runner/usecases/task-run-inspect.js";
+export { taskRunShowSpec } from "./run-show.spec.js";
+const emitter = createCliEmitter();
+function formatTarget(target) {
+    if (target.kind === "task")
+        return `task ${target.task_id ?? "<unknown>"}`;
+    return (`recipe ${target.recipe_id ?? "<unknown>"}:${target.scenario_id ?? "<unknown>"}` +
+        (target.task_id ? ` -> task ${target.task_id}` : ""));
+}
+function formatArtifacts(artifacts) {
+    if (!artifacts?.length)
+        return null;
+    return artifacts
+        .map((artifact) => (artifact.label ? `${artifact.label}=${artifact.path}` : artifact.path))
+        .join(", ");
+}
+function formatMetrics(metrics) {
+    if (!metrics)
+        return null;
+    const parts = [];
+    if (typeof metrics.duration_ms === "number")
+        parts.push(`duration_ms=${metrics.duration_ms}`);
+    if (typeof metrics.stdout_bytes === "number")
+        parts.push(`stdout_bytes=${metrics.stdout_bytes}`);
+    if (typeof metrics.stderr_bytes === "number")
+        parts.push(`stderr_bytes=${metrics.stderr_bytes}`);
+    if (metrics.output_last_message_bytes === null ||
+        typeof metrics.output_last_message_bytes === "number") {
+        parts.push(`output_last_message_bytes=${metrics.output_last_message_bytes ?? "null"}`);
+    }
+    return parts.length > 0 ? parts.join(", ") : null;
+}
+function buildRunShowJson(inspection) {
+    return {
+        task_id: inspection.task_id,
+        run_id: inspection.run_id,
+        selection: inspection.selection,
+        paths: inspection.paths,
+        bundle: inspection.bundle,
+        state: inspection.state,
+        events: inspection.events,
+        events_count: inspection.events.length,
+        last_event: inspection.events.at(-1) ?? null,
+    };
+}
+export const runTaskRunShow = async (ctx, parsed) => {
+    try {
+        const inspection = await loadTaskRunnerInspection({
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+            task_id: parsed.taskId,
+            run_id: parsed.runId,
+        });
+        if (parsed.json) {
+            emitter.json(buildRunShowJson(inspection));
+            return 0;
+        }
+        const entries = [
+            { label: "selection", value: inspection.selection },
+            { label: "run_id", value: inspection.run_id },
+            { label: "status", value: inspection.state.status },
+            { label: "adapter", value: inspection.state.adapter_id },
+            { label: "mode", value: inspection.state.mode },
+            { label: "target", value: formatTarget(inspection.state.target) },
+            { label: "created_at", value: inspection.state.created_at },
+            { label: "updated_at", value: inspection.state.updated_at },
+            { label: "bundle", value: inspection.paths.bundle_path },
+            { label: "result", value: inspection.paths.result_path },
+            { label: "state", value: inspection.paths.state_path },
+            { label: "events", value: inspection.paths.events_path },
+            { label: "trace", value: inspection.paths.trace_path },
+            { label: "stderr", value: inspection.paths.stderr_path },
+            { label: "events_count", value: inspection.events.length },
+        ];
+        if (inspection.events.length > 0) {
+            const lastEvent = inspection.events.at(-1);
+            entries.push({ label: "last_event", value: lastEvent?.type ?? "unknown" });
+        }
+        const capabilities = inspection.bundle.execution.adapter_capabilities ??
+            inspection.state.prepared_metadata?.adapter_capabilities ??
+            null;
+        entries.push({ label: "capabilities", value: JSON.stringify(capabilities) }, ...formatRunnerCapabilitySummaryLines(capabilities ?? undefined), {
+            label: "policy_requested",
+            value: JSON.stringify(inspection.state.policy_decision?.requested ?? {}),
+        }, {
+            label: "policy_effective",
+            value: JSON.stringify(inspection.state.policy_decision?.effective ?? {}),
+        }, {
+            label: "policy_fields",
+            value: JSON.stringify(inspection.state.policy_decision?.fields ?? {}),
+        }, {
+            label: "policy_refusal",
+            value: JSON.stringify(inspection.state.policy_decision?.refusal_reason ?? null),
+        }, ...formatRunnerPolicyFieldSummaryLines(inspection.state.policy_decision));
+        if (inspection.state.result?.summary) {
+            entries.push({ label: "summary", value: inspection.state.result.summary });
+        }
+        if (inspection.state.result?.stdout_summary) {
+            entries.push({ label: "stdout_summary", value: inspection.state.result.stdout_summary });
+        }
+        if (inspection.state.result?.stderr_summary) {
+            entries.push({ label: "stderr_summary", value: inspection.state.result.stderr_summary });
+        }
+        if (inspection.state.result?.timeout_reason) {
+            entries.push({ label: "timeout_reason", value: inspection.state.result.timeout_reason });
+        }
+        const metrics = formatMetrics(inspection.state.result?.metrics);
+        if (metrics) {
+            entries.push({ label: "metrics", value: metrics });
+        }
+        const artifacts = formatArtifacts(inspection.state.result?.artifacts);
+        if (artifacts) {
+            entries.push({ label: "artifacts", value: artifacts });
+        }
+        emitter.report(entries, {
+            header: infoMessage(`task run show: ${parsed.taskId}`),
+        });
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, {
+            command: "task run show",
+            task_id: parsed.taskId,
+            run_id: parsed.runId ?? null,
+        });
+    }
+};

package/dist/commands/task/run-show.spec.d.ts

@@ -0,0 +1,8 @@
+import type { CommandSpec } from "../../cli/spec/spec.js";
+export type TaskRunShowParsed = {
+    taskId: string;
+    runId?: string;
+    json: boolean;
+};
+export declare const taskRunShowSpec: CommandSpec<TaskRunShowParsed>;
+//# sourceMappingURL=run-show.spec.d.ts.map

package/dist/commands/task/run-show.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-show.spec.d.ts","sourceRoot":"","sources":["../../../src/commands/task/run-show.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,MAAM,MAAM,iBAAiB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAElF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CA2C1D,CAAC"}

package/dist/commands/task/run-show.spec.js

@@ -0,0 +1,44 @@
+import { usageError } from "../../cli/spec/errors.js";
+export const taskRunShowSpec = {
+    id: ["task", "run", "show"],
+    group: "Task",
+    summary: "Inspect persisted runner state and result artifacts for an existing run.",
+    description: "Loads an existing runner run from its artifacts and prints a structured summary of run-state, result metadata, and event counters. When run-id is omitted, the latest run for the task is selected.",
+    args: [
+        { name: "task-id", required: true, valueHint: "<task-id>" },
+        { name: "run-id", required: false, valueHint: "[run-id]" },
+    ],
+    options: [
+        {
+            kind: "boolean",
+            name: "json",
+            default: false,
+            description: "Emit machine-readable runner inspection JSON.",
+        },
+    ],
+    examples: [
+        {
+            cmd: "agentplane task run show 202602030608-F1Q8AB",
+            why: "Inspect the latest persisted runner run for a task.",
+        },
+        {
+            cmd: "agentplane task run show 202602030608-F1Q8AB run_20260323_abc123",
+            why: "Inspect a specific run by run id.",
+        },
+        {
+            cmd: "agentplane task run show 202602030608-F1Q8AB --json",
+            why: "Inspect the latest run in machine-readable JSON form.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const runId = raw.args["run-id"];
+        if (typeof runId === "string" && runId.trim() === "") {
+            throw usageError({ spec: taskRunShowSpec, message: "Invalid run-id: empty." });
+        }
+    },
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        runId: typeof raw.args["run-id"] === "string" ? raw.args["run-id"] : undefined,
+        json: raw.opts.json === true,
+    }),
+};

package/dist/commands/task/run-tail.command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler } from "../../cli/spec/spec.js";
+import type { TaskRunTailParsed } from "./run-tail.spec.js";
+export { taskRunTailSpec } from "./run-tail.spec.js";
+export type { TaskRunTailParsed } from "./run-tail.spec.js";
+export declare const runTaskRunTail: CommandHandler<TaskRunTailParsed>;
+//# sourceMappingURL=run-tail.command.d.ts.map

package/dist/commands/task/run-tail.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tail.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/run-tail.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAMzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,iBAAiB,CAsB5D,CAAC"}

package/dist/commands/task/run-tail.command.js

@@ -0,0 +1,26 @@
+import { mapBackendError } from "../../cli/error-map.js";
+import { CliError } from "../../shared/errors.js";
+import { readTaskRunnerTraceTail } from "../../runner/usecases/task-run-inspect.js";
+export { taskRunTailSpec } from "./run-tail.spec.js";
+export const runTaskRunTail = async (ctx, parsed) => {
+    try {
+        const tailed = await readTaskRunnerTraceTail({
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+            task_id: parsed.taskId,
+            run_id: parsed.runId,
+            lines: parsed.lines,
+        });
+        process.stdout.write(tailed.tail_text);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, {
+            command: "task run tail",
+            task_id: parsed.taskId,
+            run_id: parsed.runId ?? null,
+        });
+    }
+};

package/dist/commands/task/run-tail.spec.d.ts

@@ -0,0 +1,8 @@
+import type { CommandSpec } from "../../cli/spec/spec.js";
+export type TaskRunTailParsed = {
+    taskId: string;
+    runId?: string;
+    lines: number;
+};
+export declare const taskRunTailSpec: CommandSpec<TaskRunTailParsed>;
+//# sourceMappingURL=run-tail.spec.d.ts.map

package/dist/commands/task/run-tail.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tail.spec.d.ts","sourceRoot":"","sources":["../../../src/commands/task/run-tail.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,MAAM,MAAM,iBAAiB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAkD1D,CAAC"}

package/dist/commands/task/run-tail.spec.js

@@ -0,0 +1,51 @@
+import { usageError } from "../../cli/spec/errors.js";
+export const taskRunTailSpec = {
+    id: ["task", "run", "tail"],
+    group: "Task",
+    summary: "Print the last N lines from the raw agent trace artifact for an existing runner run.",
+    description: "Reads agent-trace.jsonl for an existing runner run and prints the last N lines. When run-id is omitted, the latest run for the task is selected.",
+    args: [
+        { name: "task-id", required: true, valueHint: "<task-id>" },
+        { name: "run-id", required: false, valueHint: "[run-id]" },
+    ],
+    options: [
+        {
+            kind: "string",
+            name: "lines",
+            valueHint: "<n>",
+            description: "Optional. Number of trace lines to print from the end (default: 40).",
+        },
+    ],
+    examples: [
+        {
+            cmd: "agentplane task run tail 202602030608-F1Q8AB",
+            why: "Print the last 40 trace lines for the latest task run.",
+        },
+        {
+            cmd: "agentplane task run tail 202602030608-F1Q8AB run_20260323_abc123 --lines 10",
+            why: "Print the last 10 trace lines for a specific run.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const runId = raw.args["run-id"];
+        if (typeof runId === "string" && runId.trim() === "") {
+            throw usageError({ spec: taskRunTailSpec, message: "Invalid run-id: empty." });
+        }
+        const linesRaw = typeof raw.opts.lines === "string" ? raw.opts.lines.trim() : "";
+        if (!linesRaw)
+            return;
+        if (!/^[1-9]\d*$/u.test(linesRaw)) {
+            throw usageError({
+                spec: taskRunTailSpec,
+                message: `Invalid value for --lines: ${JSON.stringify(raw.opts.lines)}`,
+            });
+        }
+    },
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        runId: typeof raw.args["run-id"] === "string" ? raw.args["run-id"] : undefined,
+        lines: typeof raw.opts.lines === "string" && raw.opts.lines.trim().length > 0
+            ? Number(raw.opts.lines)
+            : 40,
+    }),
+};

package/dist/commands/task/run-trace.command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler } from "../../cli/spec/spec.js";
+import type { TaskRunTraceParsed } from "./run-trace.spec.js";
+export { taskRunTraceSpec } from "./run-trace.spec.js";
+export type { TaskRunTraceParsed } from "./run-trace.spec.js";
+export declare const runTaskRunTrace: CommandHandler<TaskRunTraceParsed>;
+//# sourceMappingURL=run-trace.command.d.ts.map

package/dist/commands/task/run-trace.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-trace.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/run-trace.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAMzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,kBAAkB,CAqB9D,CAAC"}

package/dist/commands/task/run-trace.command.js

@@ -0,0 +1,25 @@
+import { mapBackendError } from "../../cli/error-map.js";
+import { CliError } from "../../shared/errors.js";
+import { readTaskRunnerTraceArtifact } from "../../runner/usecases/task-run-inspect.js";
+export { taskRunTraceSpec } from "./run-trace.spec.js";
+export const runTaskRunTrace = async (ctx, parsed) => {
+    try {
+        const traced = await readTaskRunnerTraceArtifact({
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+            task_id: parsed.taskId,
+            run_id: parsed.runId,
+        });
+        process.stdout.write(traced.trace_text);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, {
+            command: "task run trace",
+            task_id: parsed.taskId,
+            run_id: parsed.runId ?? null,
+        });
+    }
+};

package/dist/commands/task/run-trace.spec.d.ts

@@ -0,0 +1,7 @@
+import type { CommandSpec } from "../../cli/spec/spec.js";
+export type TaskRunTraceParsed = {
+    taskId: string;
+    runId?: string;
+};
+export declare const taskRunTraceSpec: CommandSpec<TaskRunTraceParsed>;
+//# sourceMappingURL=run-trace.spec.d.ts.map

package/dist/commands/task/run-trace.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-trace.spec.d.ts","sourceRoot":"","sources":["../../../src/commands/task/run-trace.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,MAAM,MAAM,kBAAkB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CA8B5D,CAAC"}

package/dist/commands/task/run-trace.spec.js

@@ -0,0 +1,31 @@
+import { usageError } from "../../cli/spec/errors.js";
+export const taskRunTraceSpec = {
+    id: ["task", "run", "trace"],
+    group: "Task",
+    summary: "Print the raw agent trace artifact for an existing runner run.",
+    description: "Reads agent-trace.jsonl for an existing runner run and writes it to stdout unchanged. When run-id is omitted, the latest run for the task is selected.",
+    args: [
+        { name: "task-id", required: true, valueHint: "<task-id>" },
+        { name: "run-id", required: false, valueHint: "[run-id]" },
+    ],
+    examples: [
+        {
+            cmd: "agentplane task run trace 202602030608-F1Q8AB",
+            why: "Print the raw trace for the latest run of a task.",
+        },
+        {
+            cmd: "agentplane task run trace 202602030608-F1Q8AB run_20260323_abc123",
+            why: "Print the raw trace for a specific run.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const runId = raw.args["run-id"];
+        if (typeof runId === "string" && runId.trim() === "") {
+            throw usageError({ spec: taskRunTraceSpec, message: "Invalid run-id: empty." });
+        }
+    },
+    parse: (raw) => ({
+        taskId: String(raw.args["task-id"]),
+        runId: typeof raw.args["run-id"] === "string" ? raw.args["run-id"] : undefined,
+    }),
+};

package/dist/commands/task/run.command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandHandler } from "../../cli/spec/spec.js";
+import type { TaskRunParsed } from "./run.spec.js";
+export { taskRunSpec } from "./run.spec.js";
+export type { TaskRunParsed } from "./run.spec.js";
+export declare const runTaskRun: CommandHandler<TaskRunParsed>;
+//# sourceMappingURL=run.command.d.ts.map

package/dist/commands/task/run.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/run.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAgBzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CAiFpD,CAAC"}