@smithers-orchestrator/cli 0.16.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 William Cory
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@smithers-orchestrator/cli",
+  "version": "0.16.0",
+  "description": "Smithers command-line interface, TUI, MCP server, and local workflow tools",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "default": "./src/index.js"
+    },
+    "./*": {
+      "types": "./src/index.d.ts",
+      "import": "./src/*.js",
+      "default": "./src/*.js"
+    }
+  },
+  "files": [
+    "src/"
+  ],
+  "bin": {
+    "smithers": "./src/index.js"
+  },
+  "dependencies": {
+    "@effect/workflow": "^0.18.0",
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "@opentui/core": "^0.1.92",
+    "@opentui/react": "^0.1.92",
+    "effect": "^3.21.0",
+    "incur": "^0.3.3",
+    "picocolors": "^1.1.1",
+    "react": "^18.3.0 || ^19.0.0",
+    "zod": "^4.3.6",
+    "@smithers-orchestrator/agents": "0.16.0",
+    "@smithers-orchestrator/components": "0.16.0",
+    "@smithers-orchestrator/db": "0.16.0",
+    "@smithers-orchestrator/driver": "0.16.0",
+    "@smithers-orchestrator/errors": "0.16.0",
+    "@smithers-orchestrator/observability": "0.16.0",
+    "@smithers-orchestrator/scheduler": "0.16.0",
+    "@smithers-orchestrator/time-travel": "0.16.0",
+    "@smithers-orchestrator/server": "0.16.0",
+    "smithers-orchestrator": "0.16.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "~5.9.3"
+  },
+  "scripts": {
+    "test": "bun test tests",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "tsup --dts-only"
+  }
+}

package/src/AgentAvailability.ts

@@ -0,0 +1,13 @@
+import type { AgentAvailabilityStatus } from "./AgentAvailabilityStatus.ts";
+
+export type AgentAvailability = {
+    id: "claude" | "codex" | "gemini" | "pi" | "kimi" | "amp";
+    binary: string;
+    hasBinary: boolean;
+    hasAuthSignal: boolean;
+    hasApiKeySignal: boolean;
+    status: AgentAvailabilityStatus;
+    score: number;
+    usable: boolean;
+    checks: string[];
+};

package/src/AgentAvailabilityStatus.ts

@@ -0,0 +1,5 @@
+export type AgentAvailabilityStatus =
+    | "likely-subscription"
+    | "api-key"
+    | "binary-only"
+    | "unavailable";

package/src/AggregateNodeDetailParams.ts

@@ -0,0 +1,5 @@
+export type AggregateNodeDetailParams = {
+    runId: string;
+    nodeId: string;
+    iteration?: number;
+};

package/src/AskOptions.ts

@@ -0,0 +1,12 @@
+import type { SmithersToolSurface } from "@smithers-orchestrator/agents/agent-contract";
+
+export type AskAgentId = "claude" | "codex" | "kimi" | "gemini" | "pi";
+
+export type AskOptions = {
+    agent?: AskAgentId;
+    listAgents?: boolean;
+    dumpPrompt?: boolean;
+    toolSurface?: SmithersToolSurface;
+    noMcp?: boolean;
+    printBootstrap?: boolean;
+};

package/src/ChatAttemptMeta.ts

@@ -0,0 +1,7 @@
+export type ChatAttemptMeta = {
+    kind?: string | null;
+    prompt?: string | null;
+    label?: string | null;
+    agentId?: string | null;
+    agentModel?: string | null;
+};

package/src/ChatAttemptRow.ts

@@ -0,0 +1,12 @@
+export type ChatAttemptRow = {
+    runId: string;
+    nodeId: string;
+    iteration: number;
+    attempt: number;
+    state: string;
+    startedAtMs: number;
+    finishedAtMs?: number | null;
+    cached?: boolean | null;
+    metaJson?: string | null;
+    responseText?: string | null;
+};

package/src/ChatOutputEvent.ts

@@ -0,0 +1,6 @@
+export type ChatOutputEvent = {
+    seq: number;
+    timestampMs: number;
+    type: string;
+    payloadJson: string;
+};

package/src/DiffBundleLike.ts

@@ -0,0 +1,6 @@
+export type DiffBundleLike = {
+    patches: Array<{
+        path?: string;
+        diff?: string;
+    }>;
+};

package/src/DiscoveredWorkflow.ts

@@ -0,0 +1,9 @@
+import type { WorkflowSourceType } from "./WorkflowSourceType.ts";
+
+export type DiscoveredWorkflow = {
+    id: string;
+    displayName: string;
+    sourceType: WorkflowSourceType;
+    entryFile: string;
+    path: string;
+};

package/src/EnrichedNodeDetail.ts

@@ -0,0 +1,60 @@
+import type { NodeDetailAttempt } from "./NodeDetailAttempt.ts";
+import type { NodeDetailToolCall } from "./NodeDetailToolCall.ts";
+import type { NodeDetailTokenUsage } from "./NodeDetailTokenUsage.ts";
+
+type AttemptSummary = {
+    total: number;
+    failed: number;
+    cancelled: number;
+    succeeded: number;
+    waiting: number;
+};
+
+export type EnrichedNodeDetail = {
+    node: {
+        runId: string;
+        nodeId: string;
+        iteration: number;
+        state: string;
+        lastAttempt: number | null;
+        updatedAtMs: number | null;
+        outputTable: string | null;
+        label: string | null;
+    };
+    status: string;
+    durationMs: number | null;
+    attemptsSummary: AttemptSummary;
+    attempts: NodeDetailAttempt[];
+    toolCalls: NodeDetailToolCall[];
+    tokenUsage: NodeDetailTokenUsage & {
+        byAttempt: Array<{
+            attempt: number;
+            usage: NodeDetailTokenUsage;
+        }>;
+    };
+    scorers: Array<{
+        id: string;
+        attempt: number;
+        scorerId: string;
+        scorerName: string;
+        source: string;
+        score: number;
+        reason: string | null;
+        latencyMs: number | null;
+        durationMs: number | null;
+        scoredAtMs: number;
+        meta: unknown | null;
+        input: unknown | null;
+        output: unknown | null;
+    }>;
+    output: {
+        validated: unknown | null;
+        raw: unknown | null;
+        source: "cache" | "output-table" | "none";
+        cacheKey: string | null;
+    };
+    limits: {
+        toolPayloadBytesHuman: number;
+        validatedOutputBytesHuman: number;
+    };
+};

package/src/EventCategory.ts

@@ -0,0 +1,18 @@
+export type EventCategory =
+    | "agent"
+    | "approval"
+    | "frame"
+    | "memory"
+    | "node"
+    | "openapi"
+    | "output"
+    | "revert"
+    | "run"
+    | "sandbox"
+    | "scorer"
+    | "snapshot"
+    | "supervisor"
+    | "timer"
+    | "token"
+    | "tool-call"
+    | "workflow";

package/src/FindDbWaitOptions.ts

@@ -0,0 +1,4 @@
+export type FindDbWaitOptions = {
+    timeoutMs?: number;
+    intervalMs?: number;
+};

package/src/FormatEventLineOptions.ts

@@ -0,0 +1,4 @@
+export type FormatEventLineOptions = {
+    includeTimestamp?: boolean;
+    truncatePayloadAt?: number;
+};

package/src/HijackCandidate.ts

@@ -0,0 +1,11 @@
+export type HijackCandidate = {
+    runId: string;
+    nodeId: string;
+    iteration: number;
+    attempt: number;
+    engine: string;
+    mode: "native-cli" | "conversation";
+    resume?: string;
+    messages?: unknown[];
+    cwd: string;
+};

package/src/HijackLaunchSpec.ts

@@ -0,0 +1,6 @@
+export type HijackLaunchSpec = {
+    command: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+};

package/src/InitWorkflowPackOptions.ts

@@ -0,0 +1,4 @@
+export type InitWorkflowPackOptions = {
+    force?: boolean;
+    rootDir?: string;
+};

package/src/InitWorkflowPackResult.ts

@@ -0,0 +1,6 @@
+export type InitWorkflowPackResult = {
+    rootDir: string;
+    writtenFiles: string[];
+    skippedFiles: string[];
+    preservedPaths: string[];
+};

package/src/NativeHijackEngine.ts

@@ -0,0 +1,8 @@
+export type NativeHijackEngine =
+    | "claude-code"
+    | "codex"
+    | "gemini"
+    | "pi"
+    | "kimi"
+    | "forge"
+    | "amp";

package/src/NodeDetailAttempt.ts

@@ -0,0 +1,22 @@
+import type { NodeDetailToolCall } from "./NodeDetailToolCall.ts";
+import type { NodeDetailTokenUsage } from "./NodeDetailTokenUsage.ts";
+
+export type NodeDetailAttempt = {
+    runId: string;
+    nodeId: string;
+    iteration: number;
+    attempt: number;
+    state: string;
+    startedAtMs: number;
+    finishedAtMs: number | null;
+    durationMs: number | null;
+    error: string | null;
+    errorDetail: unknown | null;
+    tokenUsage: NodeDetailTokenUsage;
+    toolCalls: NodeDetailToolCall[];
+    meta: unknown | null;
+    responseText: string | null;
+    cached: boolean;
+    jjPointer: string | null;
+    jjCwd: string | null;
+};

package/src/NodeDetailTokenUsage.ts

@@ -0,0 +1,11 @@
+export type NodeDetailTokenUsage = {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    reasoningTokens: number;
+    costUsd: number | null;
+    eventCount: number;
+    models: string[];
+    agents: string[];
+};

package/src/NodeDetailToolCall.ts

@@ -0,0 +1,12 @@
+export type NodeDetailToolCall = {
+    attempt: number;
+    seq: number;
+    name: string;
+    status: string;
+    startedAtMs: number;
+    finishedAtMs: number | null;
+    durationMs: number | null;
+    input: unknown | null;
+    output: unknown | null;
+    error: string | null;
+};

package/src/ParsedNodeOutputEvent.ts

@@ -0,0 +1,9 @@
+export type ParsedNodeOutputEvent = {
+    seq: number;
+    timestampMs: number;
+    nodeId: string;
+    iteration: number;
+    attempt: number;
+    stream: "stdout" | "stderr";
+    text: string;
+};

package/src/RenderNodeDetailOptions.ts

@@ -0,0 +1,4 @@
+export type RenderNodeDetailOptions = {
+    expandAttempts: boolean;
+    expandTools: boolean;
+};

package/src/RunAutoResumeSkipReason.ts

@@ -0,0 +1,4 @@
+export type RunAutoResumeSkipReason =
+    | "pid-alive"
+    | "missing-workflow"
+    | "rate-limited";

package/src/RunDiffCommandInput.ts

@@ -0,0 +1,13 @@
+import type { SmithersDb } from "@smithers-orchestrator/db/adapter";
+
+export type RunDiffCommandInput = {
+    adapter: SmithersDb;
+    runId: string;
+    nodeId: string;
+    iteration?: number;
+    stat?: boolean;
+    json?: boolean;
+    color?: boolean;
+    stdout: NodeJS.WritableStream;
+    stderr: NodeJS.WritableStream;
+};

package/src/RunDiffCommandResult.ts

@@ -0,0 +1,3 @@
+export type RunDiffCommandResult = {
+    exitCode: number;
+};

package/src/RunOutputCommandInput.ts

@@ -0,0 +1,12 @@
+import type { SmithersDb } from "@smithers-orchestrator/db/adapter";
+
+export type RunOutputCommandInput = {
+    adapter: SmithersDb;
+    runId: string;
+    nodeId: string;
+    iteration?: number;
+    pretty?: boolean;
+    workflow?: unknown;
+    stdout: NodeJS.WritableStream;
+    stderr: NodeJS.WritableStream;
+};

package/src/RunOutputCommandResult.ts

@@ -0,0 +1,3 @@
+export type RunOutputCommandResult = {
+    exitCode: number;
+};

package/src/RunRewindCommandInput.ts

@@ -0,0 +1,14 @@
+import type { SmithersDb } from "@smithers-orchestrator/db/adapter";
+
+export type RunRewindCommandInput = {
+    adapter: SmithersDb;
+    runId: string;
+    frameNo: number;
+    yes?: boolean;
+    json?: boolean;
+    confirm?: () => Promise<boolean>;
+    onResult?: (result: unknown) => void;
+    stdin: NodeJS.ReadStream;
+    stdout: NodeJS.WritableStream;
+    stderr: NodeJS.WritableStream;
+};

package/src/RunRewindCommandResult.ts

@@ -0,0 +1,3 @@
+export type RunRewindCommandResult = {
+    exitCode: number;
+};

package/src/RunTreeCommandInput.ts

@@ -0,0 +1,14 @@
+import type { SmithersDb } from "@smithers-orchestrator/db/adapter";
+
+export type RunTreeCommandInput = {
+    adapter: SmithersDb;
+    runId: string;
+    frameNo?: number;
+    depth?: number;
+    node?: string;
+    color?: boolean;
+    json?: boolean;
+    abortSignal?: AbortSignal;
+    stdout: NodeJS.WritableStream;
+    stderr: NodeJS.WritableStream;
+};

package/src/RunTreeCommandResult.ts

@@ -0,0 +1,3 @@
+export type RunTreeCommandResult = {
+    exitCode: number;
+};

package/src/SmithersEventType.ts

@@ -0,0 +1,3 @@
+import type { SmithersEvent } from "@smithers-orchestrator/observability/SmithersEvent";
+
+export type SmithersEventType = SmithersEvent["type"];

package/src/SupervisorOptions.ts

@@ -0,0 +1,33 @@
+import type { SmithersDb } from "@smithers-orchestrator/db/adapter";
+
+export type SupervisorSpawnClaim = {
+    claimOwnerId: string;
+    claimHeartbeatAtMs: number;
+    restoreRuntimeOwnerId?: string | null;
+    restoreHeartbeatAtMs?: number | null;
+};
+
+export type SupervisorDeps = {
+    now: () => number;
+    workflowExists: (workflowPath: string) => boolean;
+    parseRuntimeOwnerPid: (
+        runtimeOwnerId: string | null | undefined,
+    ) => number | null;
+    isPidAlive: (pid: number) => boolean;
+    spawnResumeDetached: (
+        workflowPath: string,
+        runId: string,
+        claim?: SupervisorSpawnClaim,
+    ) => number | null;
+};
+
+export type SupervisorOptions = {
+    adapter: SmithersDb;
+    pollIntervalMs?: number;
+    staleThresholdMs?: number;
+    maxConcurrent?: number;
+    dryRun?: boolean;
+    supervisorId?: string;
+    supervisorRunId?: string;
+    deps?: Partial<SupervisorDeps>;
+};

package/src/SupervisorPollSummary.ts

@@ -0,0 +1,6 @@
+export type SupervisorPollSummary = {
+    staleCount: number;
+    resumedCount: number;
+    skippedCount: number;
+    durationMs: number;
+};

package/src/TreeRenderOptions.ts

@@ -0,0 +1,5 @@
+export type TreeRenderOptions = {
+    depth?: number;
+    nodeId?: string;
+    color?: boolean;
+};

package/src/WatchLoopOptions.ts

@@ -0,0 +1,9 @@
+import type { WatchRenderContext } from "./WatchRenderContext.ts";
+
+export type WatchLoopOptions<T> = {
+    intervalSeconds: number;
+    clearScreen?: boolean;
+    fetch: () => Promise<T>;
+    render: (snapshot: T, context: WatchRenderContext) => Promise<void> | void;
+    isTerminal?: (snapshot: T) => boolean;
+};

package/src/WatchLoopResult.ts

@@ -0,0 +1,8 @@
+export type WatchLoopResult<T> = {
+    intervalMs: number;
+    tickCount: number;
+    stoppedBySignal: boolean;
+    reachedTerminal: boolean;
+    signal?: NodeJS.Signals;
+    lastData: T;
+};

package/src/WatchRenderContext.ts

@@ -0,0 +1,4 @@
+export type WatchRenderContext = {
+    tickCount: number;
+    initial: boolean;
+};

package/src/WhyBlocker.ts

@@ -0,0 +1,17 @@
+import type { WhyBlockerKind } from "./WhyBlockerKind.ts";
+
+export type WhyBlocker = {
+    kind: WhyBlockerKind;
+    nodeId: string;
+    iteration: number | null;
+    reason: string;
+    waitingSince: number;
+    unblocker: string;
+    context?: string;
+    signalName?: string | null;
+    dependencyNodeId?: string | null;
+    firesAtMs?: number | null;
+    remainingMs?: number | null;
+    attempt?: number | null;
+    maxAttempts?: number | null;
+};

package/src/WhyBlockerKind.ts

@@ -0,0 +1,9 @@
+export type WhyBlockerKind =
+    | "waiting-approval"
+    | "waiting-event"
+    | "waiting-timer"
+    | "stale-task-heartbeat"
+    | "retry-backoff"
+    | "retries-exhausted"
+    | "stale-heartbeat"
+    | "dependency-failed";

package/src/WhyDiagnosis.ts

@@ -0,0 +1,10 @@
+import type { WhyBlocker } from "./WhyBlocker.ts";
+
+export type WhyDiagnosis = {
+    runId: string;
+    status: string;
+    summary: string;
+    generatedAtMs: number;
+    blockers: WhyBlocker[];
+    currentNodeId: string | null;
+};

package/src/WorkflowCta.ts

@@ -0,0 +1,4 @@
+export type WorkflowCta = {
+    command: string;
+    description: string;
+};

package/src/WorkflowSourceType.ts

@@ -0,0 +1 @@
+export type WorkflowSourceType = "user" | "seeded" | "generated" | (string & {});