@archmax-ai/harness 0.0.0

package/dist/cli/command.js

@@ -0,0 +1,97 @@
+/**
+ * The CLI's command vocabulary: the shape of a command-table entry, the two
+ * error classes an invocation can end in, strict parsing through Node's own
+ * `util.parseArgs`, help text generated from the table, and the two output
+ * primitives every command writes through (results to stdout, narration to
+ * stderr).
+ */
+import { parseArgs as parseNodeArgs } from "node:util";
+/** A failure of the invocation itself: exit 2, one line, a `--help` hint — never a usage dump. */
+export class UsageError extends Error {
+}
+/** A failure the command established after parsing: exit 1, one line. */
+export class CliError extends Error {
+}
+export const GLOBAL_OPTIONS = {
+    root: {
+        type: "string",
+        placeholder: "<dir>",
+        description: "Workspace root (default: current directory); .env is loaded from it",
+    },
+    help: { type: "boolean", short: "h", description: "Show help for this command" },
+};
+export const out = (line) => console.log(line);
+export const err = (line) => console.error(line);
+export function parseInvocation(cmd, args) {
+    const options = Object.fromEntries(Object.entries({ ...GLOBAL_OPTIONS, ...cmd.options }).map(([name, spec]) => [
+        name,
+        { type: spec.type, ...(spec.short ? { short: spec.short } : {}) },
+    ]));
+    let parsed;
+    try {
+        parsed = parseNodeArgs({ args, options, strict: true, allowPositionals: true });
+    }
+    catch (e) {
+        throw new UsageError(String(e.message).split(". ")[0] ?? "invalid arguments");
+    }
+    const values = parsed.values;
+    const root = typeof values.root === "string" ? values.root : undefined;
+    if (values.help)
+        return { positionals: parsed.positionals, values, root };
+    // A `rest` positional (the last one) absorbs the remainder of the line; a
+    // command without one refuses extra arguments rather than dropping them.
+    const positionals = [...parsed.positionals];
+    const restAt = cmd.positionals.findIndex((p) => p.rest);
+    if (restAt >= 0) {
+        const rest = positionals.splice(restAt).join(" ").trim();
+        if (rest)
+            positionals.push(rest);
+    }
+    else if (positionals.length > cmd.positionals.length) {
+        throw new UsageError(`unexpected argument '${positionals[cmd.positionals.length]}'`);
+    }
+    return { positionals, values, root };
+}
+function usageLine(cmd) {
+    const args = cmd.positionals
+        .map((p) => p.required ? `<${p.name}${p.rest ? "..." : ""}>` : `[${p.name}${p.rest ? "..." : ""}]`)
+        .join(" ");
+    return `archmax ${cmd.name}${args ? ` ${args}` : ""} [options]`;
+}
+function columns(rows) {
+    const width = Math.max(...rows.map(([left]) => left.length));
+    return rows.map(([left, right]) => `  ${left.padEnd(width)}  ${right}`).join("\n");
+}
+function optionRows(options) {
+    return Object.entries(options).map(([name, spec]) => [
+        `--${name}${spec.short ? `, -${spec.short}` : ""}${spec.placeholder ? ` ${spec.placeholder}` : ""}`,
+        spec.description,
+    ]);
+}
+export function commandHelp(cmd) {
+    const sections = [`Usage: ${usageLine(cmd)}`, "", cmd.description ?? cmd.summary];
+    if (cmd.positionals.length) {
+        sections.push("", "Arguments:", columns(cmd.positionals.map((p) => [`<${p.name}>`, p.description])));
+    }
+    sections.push("", "Options:", columns(optionRows({ ...cmd.options, ...GLOBAL_OPTIONS })));
+    return sections.join("\n");
+}
+export function topLevelHelp(commands) {
+    return [
+        "Usage: archmax <command> [arguments] [options]",
+        "",
+        "Commands:",
+        columns(commands.map((cmd) => [
+            usageLine(cmd)
+                .replace(/^archmax /, "")
+                .replace(/ \[options\]$/, ""),
+            cmd.summary,
+        ])),
+        "",
+        "Global options:",
+        columns(optionRows(GLOBAL_OPTIONS)),
+        "",
+        "Run 'archmax help <command>' for a command's arguments and options.",
+    ].join("\n");
+}
+//# sourceMappingURL=command.js.map

package/dist/cli/command.js.map

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

package/dist/cli/state-flow.d.ts

@@ -0,0 +1,46 @@
+import { type WorkflowEventInput } from "../core/events.js";
+import { type CaseResult, type SuiteSkip } from "../testing/runner.js";
+import { type Style } from "./style.js";
+export interface StateFlowWriter {
+    write(chunk: string): unknown;
+}
+export interface StateFlowRenderer {
+    /** Accepts events with or without a `level` (the renderer keys off `type`). */
+    onEvent(event: WorkflowEventInput): void;
+}
+/**
+ * Build a renderer that writes an append-only, hierarchical state flow to
+ * `stream`. Assembly-time events (`interpreter-enabled`,
+ * `hooks-summary`, `graph-topology`, `workflow-reset`) are ignored — the CLI
+ * prints its own session header. The `advance` event only renders the agent's
+ * one-sentence `reason` (the target itself is shown by the following `state-leave`).
+ */
+export declare function createStateFlowRenderer(stream: StateFlowWriter, styleOverride?: Style): StateFlowRenderer;
+export interface TestView {
+    /**
+     * Reporter hook for `RunTestsOptions.onCaseStart`: dimmed case header + fresh
+     * trail. Given the case's session id, the trail shows only that session's
+     * events (and its child sessions'), so a run that outlives its case cannot
+     * paint under the next case's heading.
+     */
+    onCaseStart(file: string, sessionId?: string): void;
+    /** Reporter hook for `RunTestsOptions.onCaseResult`: styled verdict line with details. */
+    onCaseResult(result: CaseResult): void;
+    /** Workflow event hook: forwards to the current case's state-flow renderer. */
+    onEvent(event: WorkflowEventInput): void;
+    /** Closing overview: counts plus named failed/passed/skipped lists. */
+    renderSummary(results: CaseResult[]): void;
+    /**
+     * The whole suite was skipped rather than run — a disabled workflow runs
+     * nothing. One line in place of the summary, never a failure.
+     */
+    renderSuiteSkipped(workflow: string, reason: SuiteSkip): void;
+}
+/** One line naming a case and its outcome — the same shape in the per-case verdict and the summary. */
+export declare function caseVerdictLine(s: Style, result: CaseResult): string;
+/**
+ * Build the `archmax test` view writing to `stream` (normally `process.stderr`).
+ * Each case gets its own state-flow renderer so trails from sequential cases
+ * never share state.
+ */
+export declare function createTestView(stream: StateFlowWriter, styleOverride?: Style): TestView;

package/dist/cli/state-flow.js

@@ -0,0 +1,268 @@
+/**
+ * The CLI's renderer of the typed event stream — the **state flow** — with two
+ * entry points:
+ *
+ * - {@link createStateFlowRenderer}: the live, colorized trail `archmax run`
+ *   writes to `stderr`, one line per lifecycle event, append-only.
+ * - {@link createTestView}: what `archmax test` builds on top of it — a fresh
+ *   trail per case under a dimmed case header, a styled verdict line per case,
+ *   and the closing summary.
+ *
+ * The trail uses two indentation tiers so a session reads as a hierarchy:
+ * state changes (`state-enter`, `state-leave`) sit at the outer margin, and
+ * what happened *inside* a state (hooks, tool calls, the agent's own text,
+ * quoted) is indented beneath it. Lifecycle phases are colour-coded — `before`
+ * in blue, `after` in magenta. Assembly-time and high-frequency telemetry
+ * events are dropped to keep the trail readable.
+ */
+import { isChildSessionOf } from "../sessions/scope.js";
+import { originLabel } from "../core/events.js";
+import { ADVANCE_TOOL } from "../machine/tool-names.js";
+import { exitCodeForVerdict } from "../testing/runner.js";
+import { createStyle, icons } from "./style.js";
+/** Indentation for per-state action lines (hooks, agent text). */
+const ACTION_INDENT = "    ";
+/** Deeper indentation for output nested under an action (e.g. script stdout). */
+const OUTPUT_INDENT = "      ";
+/** Indentation for failure details nested under a verdict line. */
+const DETAIL_INDENT = "      ";
+/** Indentation for the summary's named case lists. */
+const LIST_INDENT = "  ";
+/**
+ * Build a renderer that writes an append-only, hierarchical state flow to
+ * `stream`. Assembly-time events (`interpreter-enabled`,
+ * `hooks-summary`, `graph-topology`, `workflow-reset`) are ignored — the CLI
+ * prints its own session header. The `advance` event only renders the agent's
+ * one-sentence `reason` (the target itself is shown by the following `state-leave`).
+ */
+export function createStateFlowRenderer(stream, styleOverride) {
+    const s = styleOverride ?? createStyle();
+    const phaseColor = (phase) => (phase === "before" ? s.blue : s.magenta);
+    const write = (line) => stream.write(`${line}\n`);
+    const writeAgentText = (text) => {
+        for (const line of text.split("\n"))
+            write(`${ACTION_INDENT}${s.gray(icons.quote)} ${line}`);
+    };
+    return {
+        onEvent(event) {
+            // Everything a *child session* emits is folded into its dispatch lines:
+            // a sub-workflow shares its caller's event handler, so rendering its
+            // states inline would read as the parent walking into a machine it never
+            // entered. The dispatch's own start/result lines say what ran.
+            if (event.subWorkflowDispatchId) {
+                if (event.type !== "sub-workflow-start" && event.type !== "sub-workflow-result")
+                    return;
+            }
+            switch (event.type) {
+                case "state-enter":
+                    write("");
+                    write(`${s.cyan(icons.inProgress)} ${s.bold(event.state)}`);
+                    break;
+                case "state-leave":
+                    write(`${s.green(icons.check)} ${event.state} ${s.dim(icons.arrow)} ${s.cyan(event.next)}`);
+                    break;
+                case "state-error-routed":
+                    write(`${s.yellow(icons.warn)} ${event.state} ${s.dim(icons.arrow)} ${s.yellow(event.to)} ` +
+                        s.dim(`(on_error: ${event.reason})`));
+                    break;
+                case "hook-start":
+                    write(`${ACTION_INDENT}${phaseColor(event.phase)(`${icons.bullet} ${event.phase}`)} ${s.dim(event.label)}`);
+                    break;
+                case "hook-output":
+                    write(`${OUTPUT_INDENT}${s.dim(event.line)}`);
+                    break;
+                case "hook-passed":
+                    write(`${ACTION_INDENT}${s.green(icons.check)} ${s.dim(`${event.phase} passed`)}`);
+                    break;
+                case "hook-verdict": {
+                    const missing = event.missing?.length ? ` (missing: ${event.missing.join(", ")})` : "";
+                    const mark = event.verdict === "ok"
+                        ? s.green(icons.check)
+                        : event.verdict === "veto"
+                            ? s.red(icons.cross)
+                            : s.yellow(icons.inProgress);
+                    write(`${ACTION_INDENT}${mark} ${phaseColor(event.phase)(event.phase)} ` +
+                        `${s.dim(`${event.verdict} — ${event.reason}${missing}`)}`);
+                    break;
+                }
+                case "hook-rejected":
+                    write(`${ACTION_INDENT}${s.red(icons.cross)} ${s.red(`${event.phase} rejected`)} ${s.dim(event.reason)}`);
+                    break;
+                case "tool-called":
+                    // The transition tool is reported by the state lines and the advance
+                    // reason, so its call would be the same event twice.
+                    if (event.tool === ADVANCE_TOOL)
+                        break;
+                    write(`${ACTION_INDENT}${s.gray(icons.bullet)} ${s.dim(event.tool)}` +
+                        `${event.detail ? ` ${s.gray(event.detail)}` : ""}` +
+                        `${event.origin ? s.gray(` via ${originLabel(event.origin)}`) : ""}`);
+                    break;
+                case "tool-blocked":
+                    write(`${ACTION_INDENT}${s.yellow(`${icons.warn} blocked ${event.tool}`)} ` +
+                        `${s.dim(`(not allowed in ${event.state}${event.origin ? `, from a ${originLabel(event.origin)}` : ""})`)}`);
+                    break;
+                case "agent-text":
+                    writeAgentText(event.text);
+                    break;
+                case "advance":
+                    if (event.reason?.trim())
+                        write(`${ACTION_INDENT}${s.dim(`${icons.arrow} ${event.reason.trim()}`)}`);
+                    break;
+                case "parked": {
+                    // Both park channels render here; naming which one a reader is
+                    // looking at is the whole point of the channel on the event.
+                    const input = event.awaiting === "input";
+                    const label = input ? "awaiting input" : "awaiting human decision";
+                    const why = input && event.reason?.trim() ? ` — ${event.reason.trim()}` : "";
+                    const due = input && event.resumeAt ? ` (due ${event.resumeAt})` : "";
+                    write(`${ACTION_INDENT}${s.yellow(`${icons.warn} ${label}`)} ` +
+                        `${s.dim(`${input ? "in" : "at"} ${event.node}${why}${due}`)}`);
+                    break;
+                }
+                // A state's delegations render as nested activity, not as trail steps
+                // of their own: the session has not moved — one state is running whole
+                // workflows inside itself, which a reader needs to see as *depth*.
+                case "sub-workflow-start":
+                    write(`${ACTION_INDENT}${s.cyan(icons.inProgress)} ${s.dim(`sub-workflow ${event.workflow}`)}` +
+                        `${event.depth > 1 ? s.gray(` (depth ${event.depth})`) : ""}`);
+                    break;
+                case "sub-workflow-result":
+                    if (event.status === "parked") {
+                        write(`${ACTION_INDENT}${s.yellow(icons.warn)} ` +
+                            `${s.dim(`sub-workflow ${event.workflow} parked — the session suspends with it`)}`);
+                    }
+                    else if (event.status === "ok") {
+                        write(`${ACTION_INDENT}${s.green(icons.check)} ${s.dim(`sub-workflow ${event.workflow} (${event.durationMs}ms)`)}`);
+                    }
+                    else {
+                        write(`${ACTION_INDENT}${s.red(icons.cross)} ${s.red(`sub-workflow ${event.workflow} failed`)} ` +
+                            `${s.dim(event.reason ?? "")}`);
+                    }
+                    break;
+                case "decided":
+                    write(`${ACTION_INDENT}${s.green(icons.check)} ${s.dim(`decision -> ${event.to}`)}`);
+                    break;
+                // The conversation continuing while parked. Only the inbound side
+                // renders: the reply arrives as `agent-text` like anything else the
+                // model says, and showing it twice would read as two replies.
+                case "park-message":
+                    if (event.direction === "inbound") {
+                        write(`${ACTION_INDENT}${s.yellow(icons.arrow)} ${s.dim(`message to the parked session at ${event.node}`)}`);
+                        writeAgentText(event.text);
+                    }
+                    break;
+                case "delivered":
+                    write(`${ACTION_INDENT}${s.green(icons.check)} ${s.dim(`${event.trigger} delivered, resuming ${event.node}`)}`);
+                    break;
+                case "warning":
+                    write(`${s.yellow(`${icons.warn} [${event.scope}]`)} ${s.dim(event.message)}`);
+                    break;
+                case "workflow-reset":
+                case "interpreter-enabled":
+                case "hooks-summary":
+                case "graph-topology":
+                case "agent-text-delta":
+                case "tool-result":
+                case "rubric-start":
+                case "rubric-result":
+                case "model-usage":
+                case "prompt-shaping":
+                    // Lifecycle summaries and high-frequency (GUI-oriented) telemetry.
+                    break;
+            }
+        },
+    };
+}
+/** One line naming a case and its outcome — the same shape in the per-case verdict and the summary. */
+export function caseVerdictLine(s, result) {
+    const title = result.title ? ` ${s.dim(`— ${result.title}`)}` : "";
+    switch (result.verdict.status) {
+        case "passed":
+            return `${s.green(icons.check)} ${result.id}${title}`;
+        case "skipped":
+            return `${s.yellow(icons.pending)} ${result.id}${title}${result.skipReason ? ` ${s.dim(`(${result.skipReason})`)}` : ""}`;
+        case "failed":
+            return `${s.red(icons.cross)} ${result.id}${title}`;
+    }
+}
+/**
+ * Build the `archmax test` view writing to `stream` (normally `process.stderr`).
+ * Each case gets its own state-flow renderer so trails from sequential cases
+ * never share state.
+ */
+export function createTestView(stream, styleOverride) {
+    const s = styleOverride ?? createStyle();
+    const write = (line) => stream.write(`${line}\n`);
+    let stateFlow = null;
+    let currentSession;
+    return {
+        onCaseStart(file, sessionId) {
+            currentSession = sessionId;
+            stateFlow = createStateFlowRenderer(stream, s);
+            write("");
+            write(s.dim(`${icons.diamond} case ${file}`));
+        },
+        onCaseResult(result) {
+            write("");
+            write(caseVerdictLine(s, result));
+            for (const failure of result.verdict.failures)
+                write(`${DETAIL_INDENT}${s.red(icons.cross)} ${s.dim(failure)}`);
+            // A grade is otherwise invisible when it passes — only failures print —
+            // so print every graded record that ran, passing or not. An un-run one
+            // has no score, and `0 / 0.7` would read as a grade of zero; those are
+            // covered by the not-executed count below.
+            for (const graded of result.records.filter((r) => r.threshold != null && r.status !== "not-executed")) {
+                const mark = graded.status === "passed" ? s.green(icons.check) : s.yellow(icons.warn);
+                write(`${DETAIL_INDENT}${mark} ${s.dim(`${graded.kind} ${graded.score ?? 0} / ${graded.threshold}`)}`);
+            }
+            // Without this, a halted case's remaining assertions read as if they had passed.
+            const notExecuted = result.records.filter((r) => r.status === "not-executed").length;
+            if (notExecuted > 0) {
+                const line = `${notExecuted} ${notExecuted === 1 ? "assertion" : "assertions"} not executed`;
+                write(`${DETAIL_INDENT}${s.yellow(icons.pending)} ${s.dim(line)}`);
+            }
+        },
+        onEvent(event) {
+            // An event bound to another session belongs to a case that already ended
+            // (a timed-out run still winding down); it is not this case's trail.
+            const bound = event.sessionId;
+            if (currentSession &&
+                bound &&
+                bound !== currentSession &&
+                !isChildSessionOf(bound, currentSession)) {
+                return;
+            }
+            // Events can arrive before the first case (agent assembly); give them a
+            // renderer too so e.g. warnings are not dropped.
+            stateFlow ??= createStateFlowRenderer(stream, s);
+            stateFlow.onEvent(event);
+        },
+        renderSuiteSkipped(workflow, reason) {
+            const why = reason === "disabled" ? "the workflow is disabled" : reason;
+            write("");
+            write(`${s.yellow(icons.pending)} ${s.bold("suite skipped")} ${s.dim(`— ${why} (${workflow}); no case ran`)}`);
+        },
+        renderSummary(results) {
+            const skipped = results.filter((r) => r.verdict.status === "skipped");
+            // Failed-ness reuses the exit-code semantics, so the summary and the
+            // process agree by construction.
+            const failed = results.filter((r) => r.verdict.status !== "skipped" && exitCodeForVerdict(r.verdict) !== 0);
+            const passed = results.filter((r) => !skipped.includes(r) && !failed.includes(r));
+            write("");
+            write(`${s.cyan(s.bold(`${icons.diamond} summary`))} ` +
+                s.dim(`${passed.length} passed, ${failed.length} failed, ${skipped.length} skipped`));
+            if (results.length > 0 && failed.length === 0 && skipped.length === 0) {
+                write(`${LIST_INDENT}${s.green(icons.check)} all ${results.length} case(s) passed`);
+                return;
+            }
+            const name = (r) => (r.title ? `${r.id} ${s.dim(`— ${r.title}`)}` : r.id);
+            for (const r of failed)
+                write(`${LIST_INDENT}${s.red(icons.cross)} ${name(r)}`);
+            for (const r of passed)
+                write(`${LIST_INDENT}${s.green(icons.check)} ${name(r)}`);
+            for (const r of skipped)
+                write(`${LIST_INDENT}${s.yellow(icons.pending)} ${name(r)}`);
+        },
+    };
+}
+//# sourceMappingURL=state-flow.js.map

package/dist/cli/state-flow.js.map

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

package/dist/cli/style.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Zero-dependency ANSI styling shared by the CLI's own output (banner,
+ * starter message, state-flow view). Color is suppressed — falling back to
+ * plain text with icons intact — when the `NO_COLOR` convention is set or the
+ * target stream is not a TTY.
+ */
+/** Icon constants used by CLI-rendered output; these never change with color suppression. */
+export declare const icons: {
+    readonly check: "✔";
+    readonly cross: "✖";
+    readonly inProgress: "●";
+    readonly pending: "○";
+    readonly arrow: "→";
+    readonly diamond: "◆";
+    readonly bullet: "›";
+    readonly quote: "│";
+    readonly warn: "⚠";
+};
+export interface ColorContext {
+    /** Env to check for `NO_COLOR` (defaults to `process.env`). */
+    env?: NodeJS.ProcessEnv;
+    /** Whether the target stream is a TTY (defaults to `process.stderr.isTTY`). */
+    isTTY?: boolean;
+}
+/** True when ANSI color codes should be emitted for the given context. */
+export declare function shouldUseColor(ctx?: ColorContext): boolean;
+export interface Style {
+    bold(text: string): string;
+    dim(text: string): string;
+    red(text: string): string;
+    green(text: string): string;
+    yellow(text: string): string;
+    blue(text: string): string;
+    magenta(text: string): string;
+    cyan(text: string): string;
+    gray(text: string): string;
+}
+/** Build a {@link Style} whose helpers are no-op passthroughs when color is suppressed. */
+export declare function createStyle(ctx?: ColorContext): Style;
+/** Default style instance resolved against the live process env/TTY state. */
+export declare const style: Style;

package/dist/cli/style.js

@@ -0,0 +1,64 @@
+/**
+ * Zero-dependency ANSI styling shared by the CLI's own output (banner,
+ * starter message, state-flow view). Color is suppressed — falling back to
+ * plain text with icons intact — when the `NO_COLOR` convention is set or the
+ * target stream is not a TTY.
+ */
+const ESC = "\x1b[";
+const RESET = `${ESC}0m`;
+const CODES = {
+    bold: "1",
+    dim: "2",
+    red: "31",
+    green: "32",
+    yellow: "33",
+    blue: "34",
+    magenta: "35",
+    cyan: "36",
+    gray: "90",
+};
+/** Icon constants used by CLI-rendered output; these never change with color suppression. */
+export const icons = {
+    check: "✔",
+    cross: "✖",
+    inProgress: "●",
+    pending: "○",
+    arrow: "→",
+    diamond: "◆",
+    bullet: "›",
+    quote: "│",
+    warn: "⚠",
+};
+/** True when ANSI color codes should be emitted for the given context. */
+export function shouldUseColor(ctx = {}) {
+    const env = ctx.env ?? process.env;
+    const isTTY = ctx.isTTY ?? Boolean(process.stderr.isTTY);
+    if (env.NO_COLOR !== undefined && env.NO_COLOR !== "")
+        return false;
+    if (!isTTY)
+        return false;
+    return true;
+}
+function wrap(code, useColor) {
+    if (!useColor)
+        return (text) => text;
+    return (text) => `${ESC}${code}m${text}${RESET}`;
+}
+/** Build a {@link Style} whose helpers are no-op passthroughs when color is suppressed. */
+export function createStyle(ctx = {}) {
+    const useColor = shouldUseColor(ctx);
+    return {
+        bold: wrap(CODES.bold, useColor),
+        dim: wrap(CODES.dim, useColor),
+        red: wrap(CODES.red, useColor),
+        green: wrap(CODES.green, useColor),
+        yellow: wrap(CODES.yellow, useColor),
+        blue: wrap(CODES.blue, useColor),
+        magenta: wrap(CODES.magenta, useColor),
+        cyan: wrap(CODES.cyan, useColor),
+        gray: wrap(CODES.gray, useColor),
+    };
+}
+/** Default style instance resolved against the live process env/TTY state. */
+export const style = createStyle();
+//# sourceMappingURL=style.js.map

package/dist/cli/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../src/cli/style.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,GAAG,GAAG,OAAO,CAAC;AACpB,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC;AAEzB,MAAM,KAAK,GAAG;IACZ,IAAI,EAAE,GAAG;IACT,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,IAAI;IACT,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;CACF,CAAC;AAEX,6FAA6F;AAC7F,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,GAAG;IACV,UAAU,EAAE,GAAG;IACf,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,GAAG;IACZ,MAAM,EAAE,GAAG;IACX,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,GAAG;CACD,CAAC;AASX,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,MAAoB,EAAE;IACnD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzD,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,IAAI,CAAC;AACd,CAAC;AAcD,SAAS,IAAI,CAAC,IAAY,EAAE,QAAiB;IAC3C,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC;IAC7C,OAAO,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;AAC3D,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,WAAW,CAAC,MAAoB,EAAE;IAChD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;QAChC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC;QAC9B,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC;QAC9B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC;QAClC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC;QACpC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;QAChC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC;QACtC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,KAAK,GAAU,WAAW,EAAE,CAAC"}

package/dist/cli/turn.d.ts

@@ -0,0 +1,41 @@
+/**
+ * One turn on a session, as the CLI drives it, and how its outcome is reported:
+ * the reply or the park on stdout, the resume hints on stderr. `run` sends a
+ * turn through `agent.workflow.send`; `decide` / `reply` / `deliver` each
+ * resume one, and every outcome is described the same way.
+ */
+import type { Agent } from "../agent.js";
+import type { TriggerInput } from "../machine/triggers.js";
+import type { DecideOutcome, Outcome, ReplyOutcome } from "../sessions/resume.js";
+import type { WorkflowMachine } from "../machine/machine.js";
+import { type UsageTracker } from "../core/usage.js";
+import { type Style } from "./style.js";
+/** Token usage on stderr — never a row of zeros, never on stdout. */
+export declare function printUsageFooter(style: Style, usage: UsageTracker, sessionId?: string): void;
+type Transition = {
+    to: string;
+    description?: string;
+    type?: string;
+};
+/** The context a person needs to decide a parked human state, from the spec — nothing is rendered to a file. */
+export declare function printDecisionContext(machine: WorkflowMachine, state: string, transitions: Transition[], evidence?: string[], write?: (line: string) => void): void;
+export declare function printResumed(style: Style, sessionId: string, verb: string, outcome: DecideOutcome): void;
+export declare function printReply(style: Style, sessionId: string, outcome: ReplyOutcome): void;
+export interface RunTurnInput {
+    workflow: string;
+    prompt: string;
+    trigger?: TriggerInput;
+    variables?: Record<string, unknown>;
+    sessionId?: string;
+    sessionPath?: string;
+}
+/** Report a turn's {@link Outcome}: an answer, a park (with what resumes it), or a resume's result. */
+export declare function printOutcome(style: Style, machine: WorkflowMachine, sessionId: string, outcome: Outcome): void;
+/**
+ * Drive one turn: name the session the firing belongs to, send the turn through
+ * `workflow.send` — which delivers, replies or opens a turn as the session's
+ * state dictates — and report how it ended. Returns the exit code; a park is a
+ * successful outcome.
+ */
+export declare function driveTurn(agent: Agent, style: Style, usage: UsageTracker, input: RunTurnInput): Promise<number>;
+export {};