@yaag/cli 0.5.2 → 0.6.1

package/assets/types/runtime/{agent-usage.d.ts → agent/agent-usage.d.ts}

@@ -1,4 +1,4 @@
-import type { Frame, TokenBreakdown } from "./transport.ts";
+import type { Frame, TokenBreakdown } from "../transport/index.ts";
 export interface AgentUsageSnapshot {
     readonly tokens: TokenBreakdown;
     readonly cost: number;

package/assets/types/runtime/{agent.d.ts → agent/agent.d.ts}

@@ -1,7 +1,7 @@
 import type { Static, TSchema } from "typebox";
-import type { EventSink } from "./events.ts";
-import type { AgentStats, AgentTransport } from "./transport.ts";
-import type { AskOptions, Handle, ResolvedSpawnOptions, StructuredAskOptions } from "./types.ts";
+import type { EventSink } from "../events.ts";
+import type { AgentStats, AgentTransport } from "../transport/index.ts";
+import type { AskOptions, Handle, ResolvedSpawnOptions, StructuredAskOptions } from "../types.ts";
 export interface AgentOptions {
     readonly name: string;
     readonly cwd: string;

package/assets/types/runtime/{define-agent.d.ts → agent/define-agent.d.ts}

@@ -1,6 +1,6 @@
-import type { ModelSpec, ThinkingSpec } from "./model-resolution.ts";
-import type { AskOptions } from "./types.ts";
-export type { ThinkingLevel } from "./types.ts";
+import type { ModelSpec, ThinkingSpec } from "../model/index.ts";
+import type { AskOptions } from "../types.ts";
+export type { ThinkingLevel } from "../types.ts";
 /** What `defineAgent` is given: the policy of one Agent, never its topology. */
 export interface AgentConfig {
     /** Stable identity, used in every Lifecycle Event and log line. */

package/assets/types/runtime/agent/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Public surface of the `agent/` module: the Agent handle and spawn.
+ * Files inside this directory import each other directly.
+ */
+export { Agent } from "./agent.ts";
+export { type AgentConfig, type AgentDefinition, agentDefinitionConfig, defineAgent, isAgentDefinition, } from "./define-agent.ts";
+export { makeSpawn } from "./spawn.ts";

package/assets/types/runtime/{spawn.d.ts → agent/spawn.d.ts}

@@ -1,7 +1,7 @@
+import type { EventSink } from "../events.ts";
+import type { RunContext } from "../run/index.ts";
+import type { TransportFactory } from "../transport/index.ts";
 import { Agent } from "./agent.ts";
-import type { EventSink } from "./events.ts";
-import type { RunContext } from "./run-context.ts";
-import type { TransportFactory } from "./transport.ts";
 /** Dependencies for one Run's Agent-spawn gate. */
 export interface SpawnDependencies {
     readonly factory: TransportFactory;

package/assets/types/runtime/{ask-activity.d.ts → ask/ask-activity.d.ts}

@@ -1,5 +1,5 @@
-import type { AgentActivity } from "./events.ts";
-import type { Frame } from "./transport.ts";
+import type { AgentActivity } from "../events.ts";
+import type { Frame } from "../transport/index.ts";
 /** Reports complete Ask activity transitions derived from already-observed frames. */
 export declare class AskActivityTracker {
     #private;

package/assets/types/runtime/{ask-exchange-events.d.ts → ask/ask-exchange-events.d.ts}

@@ -1,5 +1,5 @@
-import type { AgentActivity, AskOutputChannel, EventSink } from "./events.ts";
-import type { NodeSnapshot } from "./node-tracker.ts";
+import type { AgentActivity, AskOutputChannel, EventSink } from "../events.ts";
+import type { NodeSnapshot } from "../node/index.ts";
 import type { SettlementCause } from "./stall-watchdog.ts";
 /** What one finished Ask reports in its `ask_end` Lifecycle Event. */
 export interface AskEndOutcome {

package/assets/types/runtime/{ask-exchange-options.d.ts → ask/ask-exchange-options.d.ts}

@@ -1,9 +1,8 @@
+import type { ReportResultTool } from "../ask-contract/index.ts";
+import type { EventSink } from "../events.ts";
+import type { AgentTransport, Connection, Frame } from "../transport/index.ts";
+import type { ResolvedSpawnOptions } from "../types.ts";
 import type { EffectiveAskOptions } from "./ask-hash.ts";
-import type { Connection } from "./connection.ts";
-import type { EventSink } from "./events.ts";
-import type { ReportResultTool } from "./report-result.ts";
-import type { AgentTransport, Frame } from "./transport.ts";
-import type { ResolvedSpawnOptions } from "./types.ts";
 /** A frame consumer whose lifetime exceeds one Ask; the Agent's AgentUsage satisfies it. */
 export interface FrameObserver {
     observe(frame: Frame): void;

package/assets/types/runtime/{ask-hash.d.ts → ask/ask-hash.d.ts}

@@ -1,8 +1,8 @@
 import type { TSchema } from "typebox";
-import { type AskOutputContract } from "./ask-contract-identity.ts";
-import type { AskOutputExtractionPolicy } from "./ask-output.ts";
-import type { AskMarkerContext } from "./transport.ts";
-import type { AskOptions, ResolvedSpawnOptions, StructuredAskOptions } from "./types.ts";
+import type { AskOutputExtractionPolicy } from "../ask-contract/index.ts";
+import { type AskOutputContract } from "../ask-contract/index.ts";
+import type { AskMarkerContext } from "../transport/index.ts";
+import type { AskOptions, ResolvedSpawnOptions, StructuredAskOptions } from "../types.ts";
 /** The combined option shape used internally after Definition defaults merge. */
 export type EffectiveAskOptions = AskOptions | StructuredAskOptions<TSchema>;
 /** Inputs that identify an Ask in a Cassette. */

package/assets/types/runtime/{ask-output-tail.d.ts → ask/ask-output-tail.d.ts}

@@ -1,5 +1,5 @@
-import type { AskOutputChannel } from "./events.ts";
-import type { Frame } from "./transport.ts";
+import type { AskOutputChannel } from "../events.ts";
+import type { Frame } from "../transport/index.ts";
 /** The timer boundary used to test output batching without changing its wire rate. */
 export interface AskOutputTailScheduler<Handle = unknown> {
     schedule(callback: () => void): Handle;

package/assets/types/runtime/{ask-settlement.d.ts → ask/ask-settlement.d.ts}

@@ -1,4 +1,4 @@
-import { YaagError } from "./errors.ts";
+import { YaagError } from "../errors.ts";
 export interface AwaitAskSettlementOptions {
     readonly settled: Promise<void>;
     readonly closed: Promise<void>;

package/assets/types/runtime/{ask-turn.d.ts → ask/ask-turn.d.ts}

@@ -1,4 +1,4 @@
-import type { Frame } from "./transport.ts";
+import type { Frame } from "../transport/index.ts";
 /**
  * Interprets the frames of one Ask (ticket 01's 8-point contract).
  *

package/assets/types/runtime/{idle-watch.d.ts → ask/idle-watch.d.ts}

@@ -1,5 +1,5 @@
-import type { AskStalledOutcome } from "./errors.ts";
-import type { Frame } from "./transport.ts";
+import type { AskStalledOutcome } from "../errors.ts";
+import type { Frame } from "../transport/index.ts";
 /** Fixed time allowed for `agent_settled` to arrive after the idle abort. */
 export declare const IDLE_ABORT_SETTLE_MS = 5000;
 export interface IdleWatchOptions {

package/assets/types/runtime/ask/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Public surface of the `ask/` module: the live Ask exchange.
+ * Files inside this directory import each other directly.
+ */
+export { exchangeAsk } from "./ask-exchange.ts";
+export { askHash, askMarkerContext, type EffectiveAskOptions } from "./ask-hash.ts";
+export type { SettlementCause } from "./stall-watchdog.ts";

package/assets/types/runtime/{stall-watchdog.d.ts → ask/stall-watchdog.d.ts}

@@ -1,6 +1,5 @@
-import type { CommandResponse } from "./connection.ts";
-import type { AskStalledOutcome } from "./errors.ts";
-import type { Frame } from "./transport.ts";
+import type { AskStalledOutcome } from "../errors.ts";
+import type { CommandResponse, Frame } from "../transport/index.ts";
 /** Silence allowed on a live Ask before the Stall Watchdog probes the Agent. */
 export declare const DEFAULT_STALL_MS = 600000;
 /** Time allowed for the `get_state` probe to answer before yaag kills the Agent. */

package/assets/types/runtime/{ask-limit.d.ts → ask-contract/ask-limit.d.ts}

@@ -1,6 +1,6 @@
-import type { AskLimitOutcome } from "./errors.ts";
-import type { Frame } from "./transport.ts";
-import type { AskOptions } from "./types.ts";
+import type { AskLimitOutcome } from "../errors.ts";
+import type { Frame } from "../transport/index.ts";
+import type { AskOptions } from "../types.ts";
 /** The message sent when an Ask uses its allotted soft budget. */
 export declare const DEFAULT_WRAP_UP_PROMPT = "Please wrap up now and provide your final answer.";
 /** Fixed time allowed to conclude after a duration limit trips. */

package/assets/types/runtime/{ask-output.d.ts → ask-contract/ask-output.d.ts}

@@ -1,7 +1,7 @@
 import type { TSchema } from "typebox";
-import type { AskInvalidOutputOutcome } from "./errors.ts";
-import { YaagError } from "./errors.ts";
-import type { AskInvalidOutputPlayback } from "./transport.ts";
+import type { AskInvalidOutputOutcome } from "../errors.ts";
+import { YaagError } from "../errors.ts";
+import type { AskInvalidOutputPlayback } from "../transport/index.ts";
 /** Versioned extraction behavior, and part of Ask identity in a Cassette. */
 export declare const ASK_OUTPUT_EXTRACTION_POLICY = "report-result-tool/v1";
 /**

package/assets/types/runtime/ask-contract/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Public surface of the `ask-contract/` module: what an Ask declares and how it settles.
+ * Files inside this directory import each other directly.
+ */
+export { type AskOutputContract, type CanonicalJsonObject, createAskOutputContract, validateCanonicalOutputSchema, validateExtractionPolicy, } from "./ask-contract-identity.ts";
+export { AskLimit, DEFAULT_WRAP_UP_PROMPT } from "./ask-limit.ts";
+export { type AskOutputExtractionPolicy, DEFAULT_MAX_STEERS, formatAskOutputCorrection, invalidAskOutputError, LEGACY_ASK_OUTPUT_EXTRACTION_POLICY, resolvePlaybackAskOutput, validateAskOutput, } from "./ask-output.ts";
+export { isReportResultCommandFrame, REPORT_RESULT_EXTENSION_PATH, REPORT_RESULT_TOOL_NAME, type ReportedResult, ReportResultCall, ReportResultTool, reportResultCommandMessage, } from "./report-result.ts";
+export { REPORT_RESULT_CORRECTION, REPORT_RESULT_WRAP_UP, resolvePlaybackReportedResult, } from "./report-result-output.ts";
+export { ReportResultSteering } from "./report-result-steering.ts";

package/assets/types/runtime/{report-result-output.d.ts → ask-contract/report-result-output.d.ts}

@@ -1,7 +1,7 @@
 import type { TSchema } from "typebox";
+import type { AskInvalidOutputPlayback } from "../transport/index.ts";
 import type { AskOutputResult } from "./ask-output.ts";
 import type { ReportedResult } from "./report-result.ts";
-import type { AskInvalidOutputPlayback } from "./transport.ts";
 /** The one correction an Agent gets when it settles without reporting a result. */
 export declare const REPORT_RESULT_CORRECTION: string;
 /** Appended to a limit wrap-up so the Agent still ends on a reported result. */

package/assets/types/runtime/{report-result.d.ts → ask-contract/report-result.d.ts}

@@ -1,5 +1,5 @@
+import type { Frame } from "../transport/index.ts";
 import type { CanonicalJsonObject } from "./ask-contract-identity.ts";
-import type { Frame } from "./transport.ts";
 /** The internal tool a schema-bearing Ask settles from (ADR-0032). */
 export declare const REPORT_RESULT_TOOL_NAME = "report_result";
 /** The pi extension command that carries one Ask's output schema to the Agent. */

package/assets/types/runtime/{cassette-replay.d.ts → cassette/cassette-replay.d.ts}

@@ -1,5 +1,5 @@
+import type { AgentStats, AskMarker, AskPlayback, Frame } from "../transport/index.ts";
 import type { CassetteAgent } from "./cassette.ts";
-import type { AgentStats, AskMarker, AskPlayback, Frame } from "./transport.ts";
 /**
  * Replays one Cassette Agent's frame streams at the transport seam.
  *

package/assets/types/runtime/{cassette-schema.d.ts → cassette/cassette-schema.d.ts}

@@ -1,7 +1,7 @@
 import { type Static, Type } from "typebox";
-import type { CanonicalJsonObject } from "./ask-contract-identity.ts";
+import type { CanonicalJsonObject } from "../ask-contract/index.ts";
+import type { Frame } from "../transport/index.ts";
 import type { CassetteArtifact } from "./cassette.ts";
-import type { Frame } from "./transport.ts";
 /**
  * Structure gate for one Cassette artifact read from disk. `run` stays optional
  * here because version 1 predates it; the loader's presence invariant rejects a

package/assets/types/runtime/{cassette.d.ts → cassette/cassette.d.ts}

@@ -1,8 +1,8 @@
-import type { CanonicalJsonObject } from "./ask-contract-identity.ts";
-import type { AskLimitOutcome, AskStalledOutcome } from "./errors.ts";
-import type { RunOutcome } from "./events.ts";
-import type { AgentStats, AskCompletion, AskInvalidOutputPlayback, AskMarker, AskMarkerContext, Frame, OpenOptions, WorktreeResolution } from "./transport.ts";
-import type { ThinkingLevel } from "./types.ts";
+import type { CanonicalJsonObject } from "../ask-contract/index.ts";
+import type { AskLimitOutcome, AskStalledOutcome } from "../errors.ts";
+import type { RunOutcome } from "../events.ts";
+import type { AgentStats, AskCompletion, AskInvalidOutputPlayback, AskMarker, AskMarkerContext, Frame, OpenOptions, WorktreeResolution } from "../transport/index.ts";
+import type { ThinkingLevel } from "../types.ts";
 /** The Cassette format this runtime writes; the loader also reads version 1. */
 export declare const CASSETTE_VERSION: 2;
 /** Run-level settlement record; the ADR-0021 v2 block. */

package/assets/types/runtime/{checkpoint-dir.d.ts → cassette/checkpoint-dir.d.ts}

@@ -1,11 +1,18 @@
 /** A temp file left by an interrupted publication is stale after one day (ADR-0021). */
 export declare const CHECKPOINT_TEMP_MAX_AGE_MS: number;
+/**
+ * The part of the environment this module reads. It is structural on purpose:
+ * the vendored declaration tree compiles with no ambient Node globals.
+ */
+export interface CheckpointEnvironment {
+    readonly [name: string]: string | undefined;
+}
 /**
  * Resolves where a stopped Run publishes its checkpoint when `--record` set no
  * path: `YAAG_CHECKPOINT_DIR`, then an absolute `XDG_STATE_HOME`, then
  * `$HOME/.local/state`. A relative `XDG_STATE_HOME` is ignored (XDG spec).
  */
-export declare function resolveCheckpointDirectory(env?: NodeJS.ProcessEnv): string;
+export declare function resolveCheckpointDirectory(env?: CheckpointEnvironment): string;
 /**
  * Names one checkpoint file. There is no Run id below the transport seam yet, so
  * the name is a millisecond timestamp, the process id, and a full random UUID.

package/assets/types/runtime/cassette/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Public surface of the `cassette/` module: record, replay, checkpoint, and resume.
+ * Files inside this directory import each other directly.
+ */
+export { CASSETTE_VERSION, type Cassette, type CassetteAgent, type CassetteArtifact, type CassetteAsk, CassetteCollector, type CassetteGit, type CassetteRun, type CassetteSink, type CassetteSpawn, } from "./cassette.ts";
+export { assertReplayable, interruptedResumeWarning, loadCassette } from "./cassette-loader.ts";
+export { publishCassette } from "./cassette-publish.ts";
+export { checkpointFileName, cleanStaleCheckpointTemp, resolveCheckpointDirectory, } from "./checkpoint-dir.ts";
+export { createCheckpointFlusher, flushingSink } from "./checkpoint-flush.ts";
+export { recordingTransport } from "./recording-transport.ts";
+export { replayMismatch } from "./replay-divergence.ts";
+export { replayTransport } from "./replay-transport.ts";
+export { programIdentityWarning } from "./resume-identity.ts";
+export { resumeTransport } from "./resume-transport.ts";
+export { type ProgramIdentity, publishRunCheckpoint, type RunCheckpointResult, resolveRunIdentity, writeRecordingDiagnostic, } from "./run-checkpoint.ts";

package/assets/types/runtime/{recording-transport.d.ts → cassette/recording-transport.d.ts}

@@ -1,5 +1,5 @@
+import type { TransportFactory } from "../transport/index.ts";
 import type { CassetteSink } from "./cassette.ts";
-import type { TransportFactory } from "./transport.ts";
 /**
  * Wraps a transport factory and records frames at the public transport seam.
  *

package/assets/types/runtime/{replay-divergence.d.ts → cassette/replay-divergence.d.ts}

@@ -1,5 +1,5 @@
+import type { AskMarker, OpenOptions } from "../transport/index.ts";
 import type { CassetteAgent } from "./cassette.ts";
-import type { AskMarker, OpenOptions } from "./transport.ts";
 /** A pure description of the first strict replay identity mismatch. */
 export interface ReplayMismatch {
     readonly kind: "unexpected-spawn" | "spawn-options" | "changed-ask" | "extra-ask";

package/assets/types/runtime/{replay-transport.d.ts → cassette/replay-transport.d.ts}

@@ -1,5 +1,5 @@
+import type { TransportFactory } from "../transport/index.ts";
 import type { Cassette } from "./cassette.ts";
-import type { TransportFactory } from "./transport.ts";
 /**
  * Creates a strict Cassette-backed transport factory without starting pi.
  *

package/assets/types/runtime/{resume-transport.d.ts → cassette/resume-transport.d.ts}

@@ -1,5 +1,5 @@
+import type { TransportFactory } from "../transport/index.ts";
 import type { Cassette } from "./cassette.ts";
-import type { TransportFactory } from "./transport.ts";
 /**
  * Creates a Cassette-prefix transport that continues with live pi at divergence.
  *

package/assets/types/runtime/{run-checkpoint.d.ts → cassette/run-checkpoint.d.ts}

@@ -1,5 +1,5 @@
+import type { RunOutcome } from "../events.ts";
 import type { CassetteCollector, CassetteRun } from "./cassette.ts";
-import type { RunOutcome } from "./events.ts";
 /** What a resume is about to re-execute; resolved once, at Run start. */
 export type RunIdentity = Omit<CassetteRun, "outcome">;
 /**

package/assets/types/runtime/errors.d.ts

@@ -5,8 +5,8 @@ export interface AskLimitOutcome {
     readonly kind: AskLimitKind;
     readonly count: number;
 }
-import type { AgentProgress } from "./pi-state.ts";
-export type { AgentProgress } from "./pi-state.ts";
+import type { AgentProgress } from "./transport/index.ts";
+export type { AgentProgress } from "./transport/index.ts";
 /** The recorded result when yaag rejects an Ask because no frame arrived within `idleMs`. */
 export interface AskStalledOutcome {
     /** The configured silence threshold that tripped. */

package/assets/types/runtime/events.d.ts

@@ -6,9 +6,9 @@
  * activity, output, and usage observations. v0 renders them as stderr lines; the
  * dedicated fd arrives with the extension.
  */
-import type { SettlementCause } from "./stall-watchdog.ts";
-import type { TokenBreakdown, WorktreeResolution } from "./transport.ts";
-export type { SettlementCause } from "./stall-watchdog.ts";
+import type { SettlementCause } from "./ask/index.ts";
+import type { TokenBreakdown, WorktreeResolution } from "./transport/index.ts";
+export type { SettlementCause } from "./ask/index.ts";
 /**
  * A Run's outcome (ADR-0022). `paused` arrives with the pause slice.
  * `interrupted` is not terminal: only an in-flight Checkpoint carries it, and a

package/assets/types/runtime/extension/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Public surface of the `extension/` module: extension source discovery.
+ * Files inside this directory import each other directly.
+ */
+export { resolveExtensionPaths } from "./extension-paths.ts";

package/assets/types/runtime/index.d.ts

@@ -1,35 +1,19 @@
-export type { Cassette, CassetteAgent, CassetteArtifact, CassetteAsk, CassetteGit, CassetteRun, CassetteSink, CassetteSpawn, } from "./cassette.ts";
-export { CASSETTE_VERSION } from "./cassette.ts";
-export { assertReplayable, loadCassette } from "./cassette-loader.ts";
-export type { AgentConfig, AgentDefinition } from "./define-agent.ts";
-export { agentDefinitionConfig, defineAgent, isAgentDefinition } from "./define-agent.ts";
-export type { OrchestrationProgram, ProgramDefinition } from "./define-run.ts";
-export { defineRun, isOrchestrationProgram, programDefinition } from "./define-run.ts";
+export type { AgentConfig, AgentDefinition } from "./agent/index.ts";
+export { agentDefinitionConfig, defineAgent, isAgentDefinition } from "./agent/index.ts";
+export type { Cassette, CassetteAgent, CassetteArtifact, CassetteAsk, CassetteGit, CassetteRun, CassetteSink, CassetteSpawn, } from "./cassette/index.ts";
+export { assertReplayable, CASSETTE_VERSION, loadCassette, recordingTransport, replayTransport, resumeTransport, } from "./cassette/index.ts";
 export type { AskInvalidOutputOutcome, AskLimitKind, AskLimitOutcome, AskStalledOutcome, YaagErrorCode, } from "./errors.ts";
 export { isYaagError, YaagError } from "./errors.ts";
 export type { AgentActivity, AskOutputChannel, EventSink, LifecycleEvent, LifecycleEventBody, NodeState, NodeUsage, StampedEventSink, } from "./events.ts";
-export type { ModelError, ModelErrorReason, ModelResolver, ModelSelection, ModelSpec, ThinkingResolver, ThinkingSpec, } from "./model-resolution.ts";
-export type { DecodedNode, NodeDecoder } from "./node-decoder.ts";
-export { DEFAULT_NODE_DECODERS } from "./node-decoders.ts";
-export type { NodePath } from "./node-path.ts";
-export { agentAskPath, childPath, sanitizeNodeName } from "./node-path.ts";
-export type { NodeSnapshot } from "./node-tracker.ts";
-export { NodeTracker } from "./node-tracker.ts";
-export { prompt } from "./prompt.ts";
-export { promptGist } from "./prompt-gist.ts";
-export type { ReapPath, ReapTarget } from "./reap.ts";
-export { reap } from "./reap.ts";
-export { recordingTransport } from "./recording-transport.ts";
-export { replayTransport } from "./replay-transport.ts";
-export { resumeTransport } from "./resume-transport.ts";
-export type { RunOptions } from "./run.ts";
-export { executeRun } from "./run.ts";
-export type { RunContext } from "./run-context.ts";
-export type { DiscoveredSkill, SkillProbeFactory } from "./skill-probe.ts";
-export type { AgentInfo, AgentState, AskingAgentInfo, EndedRunSummary, ExitedAgentInfo, IdleAgentInfo, NodeInfo, RunningRunSummary, RunOutcome, RunState, RunSummary, } from "./summary.ts";
-export { applyEvent, initialSummary } from "./summary.ts";
-export { readSystemPromptSidecar } from "./system-prompt-recorder.ts";
-export type { AgentStats, AgentTransport, AskMarker, AskMarkerContext, AskPlayback, Frame, TokenBreakdown, TransportFactory, TransportStartup, TransportStartupObserver, WorktreeResolution, } from "./transport.ts";
+export type { ModelError, ModelErrorReason, ModelResolver, ModelSelection, ModelSpec, ThinkingResolver, ThinkingSpec, } from "./model/index.ts";
+export type { DecodedNode, NodeDecoder, NodePath, NodeSnapshot } from "./node/index.ts";
+export { agentAskPath, childPath, DEFAULT_NODE_DECODERS, NodeTracker, sanitizeNodeName, } from "./node/index.ts";
+export { prompt, promptGist } from "./prompt/index.ts";
+export type { OrchestrationProgram, ProgramDefinition, RunContext, RunOptions, } from "./run/index.ts";
+export { defineRun, executeRun, isOrchestrationProgram, programDefinition } from "./run/index.ts";
+export type { AgentInfo, AgentState, AskingAgentInfo, EndedRunSummary, ExitedAgentInfo, IdleAgentInfo, NodeInfo, RunningRunSummary, RunOutcome, RunState, RunSummary, } from "./summary/index.ts";
+export { applyEvent, initialSummary } from "./summary/index.ts";
+export type { AgentStats, AgentTransport, AskMarker, AskMarkerContext, AskPlayback, DiscoveredSkill, Frame, ReapPath, ReapTarget, SkillProbeFactory, TokenBreakdown, TransportFactory, TransportStartup, TransportStartupObserver, WorktreeResolution, } from "./transport/index.ts";
+export { readSystemPromptSidecar, reap, worktreeTransport } from "./transport/index.ts";
 export type { AskOptions, Handle, ResolvedSpawnOptions, SpawnOptions, SpawnOverrides, StructuredAskOptions, ThinkingLevel, } from "./types.ts";
 export { AGENT_NODE_TABLE_MAX, ASK_OUTPUT_FLUSH_INTERVAL_MS, ASK_OUTPUT_MAX_BYTES, ASK_OUTPUT_TRUNCATION_MARKER, NODE_GIST_MAX_CHARS, PROMPT_GIST_MAX_CHARS, TOOL_ARGS_GIST_MAX_CHARS, } from "./wire-constants.ts";
-export { worktreeTransport } from "./worktree-transport.ts";

package/assets/types/runtime/model/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public surface of the `model/` module: model resolution.
+ * Files inside this directory import each other directly.
+ */
+export { type ModelError, type ModelErrorReason, type ModelResolver, type ModelSelection, type ModelSpec, normalizeModelResolution, type ThinkingResolver, type ThinkingSpec, } from "./model-resolution.ts";
+export type { ThinkingLevel } from "./thinking-level.ts";

package/assets/types/runtime/node/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Public surface of the `node/` module: Node decode and tracking.
+ * Files inside this directory import each other directly.
+ */
+export type { DecodedNode, NodeDecoder } from "./node-decoder.ts";
+export { DEFAULT_NODE_DECODERS } from "./node-decoders.ts";
+export { agentAskPath, childPath, type NodePath, sanitizeNodeName } from "./node-path.ts";
+export { type NodeSnapshot, NodeTracker } from "./node-tracker.ts";

package/assets/types/runtime/{node-decoder.d.ts → node/node-decoder.d.ts}

@@ -1,4 +1,4 @@
-import type { NodeState, NodeUsage } from "./events.ts";
+import type { NodeState, NodeUsage } from "../events.ts";
 /** One decoded Nested Node, relative to the tool call that produced it. */
 export interface DecodedNode {
     /** Names from the tool call downwards, e.g. `["test-writer", "1", "fixture-gen"]`. */

package/assets/types/runtime/{node-details.d.ts → node/node-details.d.ts}

@@ -1,4 +1,4 @@
-import type { NodeUsage } from "./events.ts";
+import type { NodeUsage } from "../events.ts";
 /**
  * Reading untrusted nesting-tool detail payloads. Every decoder narrows from
  * `unknown` through here, so a malformed payload is skipped, never thrown on.

package/assets/types/runtime/{node-tracker.d.ts → node/node-tracker.d.ts}

@@ -1,6 +1,6 @@
-import type { NodeState, NodeUsage } from "./events.ts";
+import type { NodeState, NodeUsage } from "../events.ts";
+import type { Frame } from "../transport/index.ts";
 import type { NodeDecoder } from "./node-decoder.ts";
-import type { Frame } from "./transport.ts";
 /** One Nested Node observation, relative to the tool call that produced it. */
 export interface NodeSnapshot {
     readonly segments: readonly string[];

package/assets/types/runtime/prompt/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public surface of the `prompt/` module: the prompt template.
+ * Files inside this directory import each other directly.
+ */
+export { prompt } from "./prompt.ts";
+export { promptGist } from "./prompt-gist.ts";

package/assets/types/runtime/run/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Public surface of the `run/` module: the Run lifecycle.
+ * Files inside this directory import each other directly.
+ */
+export { defineRun, isOrchestrationProgram, type OrchestrationProgram, type ProgramDefinition, programDefinition, } from "./define-run.ts";
+export { executeRun, type RunOptions } from "./run.ts";
+export type { RunContext } from "./run-context.ts";

package/assets/types/runtime/{run-context.d.ts → run/run-context.d.ts}

@@ -1,5 +1,5 @@
-import type { AgentDefinition } from "./define-agent.ts";
-import type { Handle, SpawnOptions, SpawnOverrides } from "./types.ts";
+import type { AgentDefinition } from "../agent/index.ts";
+import type { Handle, SpawnOptions, SpawnOverrides } from "../types.ts";
 /** What an Orchestration Program is handed. */
 export interface RunContext<Args = unknown> {
     /** Program arguments, validated when the program declares a schema (ADR-0010). */

package/assets/types/runtime/{run.d.ts → run/run.d.ts}

@@ -1,8 +1,8 @@
-import { type Cassette, type CassetteSink } from "./cassette.ts";
+import { type Cassette, type CassetteSink } from "../cassette/index.ts";
+import type { StampedEventSink } from "../events.ts";
+import type { TransportFactory } from "../transport/index.ts";
+import { type SkillProbeFactory } from "../transport/index.ts";
 import { type OrchestrationProgram } from "./define-run.ts";
-import type { StampedEventSink } from "./events.ts";
-import { type SkillProbeFactory } from "./skill-probe.ts";
-import type { TransportFactory } from "./transport.ts";
 export interface RunOptions {
     /** Where Agents come from. Defaults to real `pi --mode rpc` processes. */
     readonly transport?: TransportFactory;

package/assets/types/runtime/summary/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public surface of the `summary/` module: the Summary.
+ * Files inside this directory import each other directly.
+ */
+export { applyEvent, type EndedRunSummary, initialSummary, type RunningRunSummary, type RunOutcome, type RunState, type RunSummary, } from "./summary.ts";
+export type { AgentInfo, AgentState, AskingAgentInfo, ExitedAgentInfo, IdleAgentInfo, NodeInfo, } from "./summary-agent.ts";

package/assets/types/runtime/{summary-agent.d.ts → summary/summary-agent.d.ts}

@@ -1,7 +1,7 @@
-import type { AgentActivity } from "./events.ts";
+import type { AgentActivity } from "../events.ts";
+import type { TokenBreakdown, WorktreeResolution } from "../transport/index.ts";
 import type { NodeInfo } from "./summary-nodes.ts";
-import type { TokenBreakdown, WorktreeResolution } from "./transport.ts";
-export type { AgentActivity } from "./events.ts";
+export type { AgentActivity } from "../events.ts";
 export type { NodeInfo } from "./summary-nodes.ts";
 /** The observer-facing lifecycle state of an Agent. */
 export type AgentState = "idle" | "asking" | "exited";

package/assets/types/runtime/{summary-nodes.d.ts → summary/summary-nodes.d.ts}

@@ -1,6 +1,6 @@
-import type { LifecycleEventBody, NodeState } from "./events.ts";
+import type { LifecycleEventBody, NodeState } from "../events.ts";
+import type { TokenBreakdown } from "../transport/index.ts";
 import type { AgentRecord } from "./summary-agent.ts";
-import type { TokenBreakdown } from "./transport.ts";
 /** One Nested Node's folded row in an Agent's bounded node table. */
 export interface NodeInfo {
     readonly path: string;

package/assets/types/runtime/{summary.d.ts → summary/summary.d.ts}

@@ -1,7 +1,7 @@
-import type { LifecycleEvent, LifecycleEventBody, RunOutcome } from "./events.ts";
+import type { LifecycleEvent, LifecycleEventBody, RunOutcome } from "../events.ts";
+import type { TokenBreakdown } from "../transport/index.ts";
 import type { AgentInfo } from "./summary-agent.ts";
-import type { TokenBreakdown } from "./transport.ts";
-export type { NodeState, NodeUsage, RunOutcome } from "./events.ts";
+export type { NodeState, NodeUsage, RunOutcome } from "../events.ts";
 export type { AgentActivity, AgentInfo, AgentState, AskingAgentInfo, ExitedAgentInfo, IdleAgentInfo, NodeInfo, } from "./summary-agent.ts";
 /** The observer-facing lifecycle state of a Run. */
 export type RunState = "running" | "ended";

package/assets/types/runtime/transport/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Public surface of the `transport/` module: the pi process seam and its probes.
+ * Files inside this directory import each other directly.
+ */
+export { type CommandResponse, Connection } from "./connection.ts";
+export { FakeTransport, type FakeTransportOptions, recordedFrames, reportResultFrames, } from "./fake-transport.ts";
+export { FrameGapTracker } from "./frame-gap.ts";
+export { FrameQueue } from "./frame-queue.ts";
+export { decodeFrames } from "./jsonl.ts";
+export { liveTransport } from "./live-transport.ts";
+export { type AgentProgress, piCommand, readAgentProgress } from "./pi-state.ts";
+export { type ReapPath, type ReapTarget, reap } from "./reap.ts";
+export { type DiscoveredSkill, liveSkillProbe, type SkillProbeFactory } from "./skill-probe.ts";
+export { skillRestrictionTransport } from "./skill-restriction-transport.ts";
+export { readSystemPromptSidecar } from "./system-prompt-recorder.ts";
+export { SYSTEM_PROMPT_SIDECAR_SUFFIX, systemPromptSidecarPath, } from "./system-prompt-recorder-extension.ts";
+export type { AgentStats, AgentTransport, AskCompletion, AskInvalidOutputPlayback, AskMarker, AskMarkerContext, AskPlayback, Frame, OpenOptions, TokenBreakdown, TransportFactory, TransportStartup, TransportStartupObserver, WorktreeResolution, } from "./transport.ts";
+export { worktreeTransport } from "./worktree-transport.ts";

package/assets/types/runtime/{transport.d.ts → transport/transport.d.ts}

@@ -1,7 +1,6 @@
-import type { CanonicalJsonObject } from "./ask-contract-identity.ts";
-import type { AskLimitOutcome, AskStalledOutcome } from "./errors.ts";
-import type { ReportedResult } from "./report-result.ts";
-import type { AskOptions, ResolvedSpawnOptions, ThinkingLevel } from "./types.ts";
+import type { CanonicalJsonObject, ReportedResult } from "../ask-contract/index.ts";
+import type { AskLimitOutcome, AskStalledOutcome } from "../errors.ts";
+import type { AskOptions, ResolvedSpawnOptions, ThinkingLevel } from "../types.ts";
 /**
  * The one seam of the runtime (ticket 04). An AgentTransport represents a whole
  * Agent and exchanges raw JSONL frames; it is the only place a process is known.

package/assets/types/runtime/types.d.ts

@@ -1,7 +1,6 @@
 import type { Static, TSchema } from "typebox";
-import type { ModelSpec, ThinkingSpec } from "./model-resolution.ts";
-import type { ThinkingLevel } from "./thinking-level.ts";
-export type { ThinkingLevel } from "./thinking-level.ts";
+import type { ModelSpec, ThinkingLevel, ThinkingSpec } from "./model/index.ts";
+export type { ThinkingLevel } from "./model/index.ts";
 /** Options for spawning one Agent (ADR-0001, ADR-0009, ADR-0026). */
 export interface SpawnOptions {
     /** Working directory. Defaults to the Orchestrator's cwd. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaag/cli",
-  "version": "0.5.2",
+  "version": "0.6.1",
   "publishConfig": {
     "access": "public"
   },
@@ -21,8 +21,8 @@
   },
   "dependencies": {
     "@earendil-works/pi-tui": "^0.84.0",
-    "@yaag/runtime": "0.5.2",
-    "@yaag/tui": "0.5.2",
+    "@yaag/runtime": "0.6.1",
+    "@yaag/tui": "0.6.1",
     "typebox": "1.3.7"
   }
 }

package/src/cli.ts

@@ -9,16 +9,19 @@ import {
   programDefinition,
   type StampedEventSink,
 } from "@yaag/runtime";
-import { interactiveAvailable } from "./alt-screen.ts";
 import { parseArgv } from "./argv.ts";
-import { runInteractive } from "./interactive-run.ts";
-import { writeChannel, writeChannelFd } from "./output-channel.ts";
-import { createPlainPresenter } from "./presenter.ts";
-import { loadProgram } from "./program-loader.ts";
-import { executeOptions, formatResult, type RunFlags } from "./run-invocation.ts";
-import { loadRunProgram } from "./run-program.ts";
-import { registerRuntimeAlias } from "./runtime-alias.ts";
+import { loadProgram, loadRunProgram, registerRuntimeAlias } from "./program/index.ts";
 import { setupWorkspace } from "./setup-workspace.ts";
+import {
+  createPlainPresenter,
+  executeOptions,
+  formatResult,
+  interactiveAvailable,
+  type RunFlags,
+  runInteractive,
+  writeChannel,
+  writeChannelFd,
+} from "./terminal/index.ts";
 
 registerRuntimeAlias();
 

package/src/program/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Public surface of the `program/` module: load and execute an Orchestration
+ * Program. Files inside this directory import each other directly.
+ */
+export { loadProgram } from "./program-loader.ts";
+export { loadRunProgram } from "./run-program.ts";
+export { registerRuntimeAlias } from "./runtime-alias.ts";

package/src/{run-program.ts → program/run-program.ts}

@@ -8,7 +8,7 @@
  */
 import { resolve } from "node:path";
 import type { OrchestrationProgram } from "@yaag/runtime";
-import type { ProgramSource } from "./argv.ts";
+import type { ProgramSource } from "../argv.ts";
 import { readEvalSource } from "./eval-fd.ts";
 import { loadInlineProgram } from "./inline-program.ts";
 import { loadProgram } from "./program-loader.ts";

package/src/terminal/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Public surface of the `terminal/` module: terminal presentation and the
+ * interactive run. Files inside this directory import each other directly.
+ */
+export { interactiveAvailable } from "./alt-screen.ts";
+export { runInteractive } from "./interactive-run.ts";
+export { writeChannel, writeChannelFd } from "./output-channel.ts";
+export { createPlainPresenter } from "./presenter.ts";
+export { executeOptions, formatResult, type RunFlags } from "./run-invocation.ts";