0.34.0

​

Upgrading

bunx smthrs update        # upgrade the CLI
bunx smthrs upgrade       # agent-assisted: applies what your project needs
bunx smthrs packs update  # refresh installed workflow packs

​

Live workflow supervision: steer, hijack, and a terminal cockpit

​

Agent file edits are one contract, and the UI renders them as diffs

type AgentFileChange = {
  path: string;
  kind: "created" | "modified" | "deleted" | "renamed";
  oldPath?: string;                     // set when kind is "renamed"
  unifiedDiff?: string;                 // full patch, when the harness allows one
  source: "reported" | "reconstructed"; // vendor-supplied, or built from tool input
};

• A change with a diff is an expandable row that opens the hunks inline.
• A paths-only change renders as a plain row labelled diff unavailable rather than a focusable button that does nothing when you click it.
• A started edit stays hidden until the tool result confirms it, so a denied or failed edit no longer looks applied.
• Claude’s Write reconstructs a full-creation diff only once the result confirms the file was new. Over an existing file it stays paths-only instead of fabricating an empty old side, and NotebookEdit reconstructs inserts only.
• Kimi’s WriteFile keeps its file-change kind through tool-result completion, so the pending change finalizes instead of collapsing into a generic tool row.

​

Diffs while the run is still executing

​

One account’s rate limit no longer stalls a run

import { fallbackAgents } from "smthrs";

// One rung per registered Claude/Codex seat, stable order for this run,
// a stock Claude Code agent as the final rung.
const agent = fallbackAgents({ seed: ctx.runId });

​

Register every subscription you own, browser login included

bunx smthrs agents add            # wizard; offers the tmux flow when available
bunx smthrs agents add --tmux     # detached tmux browser login, then register

​

Subscription headroom across every registered seat

​

ForkFanOut: end-of-run chores on a fork of the finished session

<ForkFanOut
  fork="implement"
  agent={chores}
  tasks={[
    { id: "lint", prompt: "Run the linters and fix what they flag." },
    { id: "memory", prompt: "Record what this run learned to memory." },
  ]}
/>

​

Resume and retry work again

bunx smthrs retry-task RUN_ID TASK_ID   # survives the launching terminal closing
bunx smthrs up --resume RUN_ID          # no workflow path needed anymore

• An approved detached run with a null workflowHash can resume again (#1489).
• up --resume RUN_ID no longer demands a workflow path, matching its help text: the run’s stored workflow is relaunched (#1475).

​

Fallback chains recover instead of failing the run

• Session-loss errors are now classified, so the chain retries or falls through to the next seat (#1480).
• A mixed agent-chain failure parks the run as waiting-quota with preflight context attached, resuming when capacity returns (#1482).
• Codex preflight accepts valid ChatGPT auth even when auth.json also contains an OPENAI_API_KEY (#1447).
• Both behaviors are pinned by new quota-chain-failover and session-loss-chain-failover e2e suites.

​

The Gateway finds your UI, and stays responsive while it does

bunx smthrs up ./anywhere/my-workflow.tsx -d
bunx smthrs ui RUN_ID    # now finds the <UI> declaration

​

A finished run tells the truth, and no agent outlives its engine

bunx smthrs status RUN_ID   # verdict: degraded, naming the loop that never converged
bunx smthrs why RUN_ID      # names the loop and its unmet until condition

​

ctx.outputs stops returning a plausible empty array

const rows = ctx.outputs(outputs.probe); // real rows; an unresolvable ref now throws

• Regression tests pin the callable form to the same rows as the string name.

​

upgrade-dependents: open rename PRs downstream

bunx smthrs up upgrade-dependents

​

Per-run token usage in one query

​

Durable agent checkpoints

​

Nanocodex: a pinned-source sandboxed agent backend

​

A theme registry for the UI kit

​

stereOS in the browser, and three new sites

• custom-sandbox.smithers.sh, published at the time as stereos.smithers.sh, ran the stereOS demo entirely in your browser inside a WebContainer, so the sandbox-provider demo needed no local checkout.
• patterns.smithers.sh is a field guide to orchestration patterns.
• research.smithers.sh hosts the persuasion-gap paper.
• status.smithers.sh gained Smithers Code and Smithers Cloud API components, each verified live before listing, and a missing feed now answers a real 404 instead of an HTML page labelled as status.

​

Other improvements

• The bug-triage-train workflow ships in the pack with a live UI: file a batch of bug reports through triage, reproduction, and fix lanes.
• CodexAgent emits --sandbox workspace-write now that codex-cli 0.147 removed --full-auto, so full-auto-configured workflows keep launching on current codex installs.
• Queued steers expire inside the terminal cancel transaction, and steer enqueue is fenced against terminal runs, so an instruction can no longer land on a run that is already ending.
• Detached built-in runs resume correctly after approval decisions.
• A Codex agent configured through the array form keeps its reasoning effort instead of silently dropping it.
• bunx smthrs tail --format jsonl emits raw event JSON per line and nothing else, so scripted consumers stop parsing banner noise.
• bunx smthrs bug --run RUN_ID attaches the run’s lifecycle events instead of a ~25 second window of TaskHeartbeat noise, and generates a correct report title (#1484).
• Panel moderators inside a Ralph loop no longer deadlock over Ralph’s iteration-suffixed dependency names (#1487).
• bunx smthrs hijack re-emits the agent’s launch flags. --resume restores conversation state only, so a hijacked session lost the model, permission mode, and config dir the workflow agent ran with. Those are recorded on the hand-off now and replayed onto the CLI invocation.
• reconstructUnifiedDiff bounds its LCS grid by bytes instead of cells. The old n * m cell guard allocated one typed array per old line, so a lopsided payload passed the check and still allocated about a gigabyte; one flat Uint32Array makes the cell bound a real byte bound.
• The live node diff path enforces the payload cap it previously bypassed, so an oversized working-copy diff raises DiffTooLarge instead of serializing uncapped.
• The gateway UI keys its live diff refresh on the last event’s seq rather than the event ring’s length, which stops changing once the 200-event ring fills and froze the live diff on long runs.
• The review workflow UI renders reviewer feedback, synthesis, and issue descriptions as formatted Markdown through the shared Markdown primitive instead of one raw paragraph, and a mid-run rejection no longer shows a final Blocked badge next to RUNNING: verdicts only go final once the run is terminal.
• EmptyState and SectionHeader accept element titles again. Both extended ComponentProps<"div">, whose intrinsic title?: string intersected with their own title?: ReactNode slot and collapsed it to string & ReactNode.
• scheduler and devtools re-emitted their stale committed declarations from tsup --dts-only, which made check:dts false-green on type changes. Both configs now clean the emitted index.d.ts first.
• Hermes and OpenClaw are listed in the README harness table and the npm package description alongside the other CLI harnesses.
• The detached launch admission wait is configurable, and a live engine child is no longer killed at the deadline. bunx smthrs up -d waited a fixed 30 seconds for the engine child to prove it persisted the run row, which a heavily loaded machine can miss on module parse alone; the launcher then terminated the healthy child and reported an empty log. A child that is still alive at the deadline now gets a grace window of four times the timeout, with a progress note on stderr, and the final failure names the live pid instead of “(empty)”. Set SMITHERS_DETACHED_ADMISSION_TIMEOUT_MS to raise or lower the base window. The default is still 30 seconds, and a value below 1000ms falls back to it.
• The Trellis benchmark lab pin now carries the validated v2 authoring ladder: kit-only scripts, static validation, fuel accounting, evidence-bound settlement, mission CLI, and hardened batched ARC evaluation planning. It is internal benchmarking infrastructure, not part of any published package.
• Test scratch directories now go through a tracked cleanup helper, preventing abandoned SQLite, PGlite, sandbox, and workflow workspaces from accumulating under $TMPDIR after suites finish or throw.
• The TUI node inspector’s empty Logs tab again renders the parenthesized (no log events for this node) placeholder, with a headless regression test that runs even when the optional zmux PTY suite is unavailable.
• Claude Code OAuth credentials stored in the macOS Keychain are found everywhere they matter. bunx smthrs usage and the agent availability probe now read the per-config-dir Keychain item for isolated accounts (Claude Code-credentials-<hash of the config dir>), with no fallback to the default install’s item, so a validly logged-in account stops reporting NO_USABLE_AGENTS when the claude auth status probe times out, and one account’s token is never attributed to another.
• <Task fork> authored inside a Subflow or Sandbox child workflow keeps its fork edge; the dom extraction variant used for child workflows dropped the prop and the fork was silently lost.
• Asking oneshot for a codex agent while the codex-paused marker is set now names the pause itself, its until/reason, and how to clear it (SMITHERS_CODEX_PAUSED=0 or delete the marker) instead of the generic “not enough availability signals” that pointed at healthy auth.
• effect and the @effect/* packages are aligned at 4.0.0-beta.105. Keeping the family on one beta prevents npm from satisfying caret peer ranges with multiple effect runtimes in an end-user install.
• The smthrs umbrella is guarded against type-vs-runtime export drift: a new test imports every documented agent export and asserts it exists at runtime, the exact shape of the bug where fallbackAgents typechecked but threw “Export named ‘fallbackAgents’ not found” on import. The facade’s committed index.d.ts was regenerated against the release base.
• The gateway PTY resize test polls for the new terminal geometry instead of reading it once after a fixed half-second sleep, so a loaded CI runner no longer reds the packages/server shard over a resize frame that merely arrived late.

​

Upgrade notes

• No breaking changes at runtime. All 0.33.0 rename guidance still applies.
• If a package manifest overrides Effect prereleases, update the whole effect and @effect/* family to beta.105 together.
• AgentCapabilityRegistry gains a fileChanges: { supportsFileChanges, supportsUnifiedDiff } field. Registries are normalized with both flags false when absent, so existing agents keep working; a custom agent typed against the exported TypeScript type needs the field added.
• getRunDiff and getNodeDiff return a diff for a non-terminal run now instead of refusing. Bundles computed from a live working copy carry live: true; treat the terminal bundle as the authoritative snapshot.
• A mixed agent-chain failure now parks the run as waiting-quota instead of failing it. Check bunx smthrs ps for parked runs before concluding a run died.
• bunx smthrs up --resume RUN_ID without a workflow path is now valid; the stored workflow is relaunched.
• This release adds several store migrations: the _smithers_attempts.effort column, the _smithers_steers table, _smithers_ralph.exhausted, the _smithers_agent_processes table, agent checkpoints, the _smithers_run_usage table, and the Herdr supervision tables. They apply on first open, so no manual step is needed, but an older CLI pointed at a migrated database will not read the new columns.
• The herdr client pins wire protocol 19 (herdr 0.8.0). Explicit bunx smthrs herdr commands against another protocol fail closed with HERDR_PROTOCOL_MISMATCH before any mutating call; the optional mirror paths log and continue. herdr remains fully optional.
• CodexAgent maps full-auto to --sandbox workspace-write instead of the removed --full-auto flag. codex-cli releases that predate --sandbox need an upgrade before Codex tasks will launch.
• 0.33.1 was tagged but never published to npm. If you tracked its changelog, every entry ships in 0.34.0; there is no npm artifact to migrate through.
• bunx smthrs status can now return the verdict degraded for a finished run whose loop never satisfied its until condition. The run row status stays finished and RunState stays succeeded, so scripts that key off the run status are unaffected; scripts that assert verdict === "done" should accept degraded or treat it as the non-convergence signal it is.
• Every CLI invocation now sweeps _smithers_agent_processes and group-kills agent processes whose engine is gone. Set SMITHERS_NO_ORPHAN_REAPER=1 if you deliberately keep agent processes alive past their engine.

​

The full changelog