@yaag/runtime 0.6.0 → 0.6.1

package/src/index.ts

@@ -1,3 +1,5 @@
+export type { AgentConfig, AgentDefinition } from "./agent/index.ts";
+export { agentDefinitionConfig, defineAgent, isAgentDefinition } from "./agent/index.ts";
 export type {
   Cassette,
   CassetteAgent,
@@ -7,13 +9,15 @@ export type {
   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";
+} from "./cassette/index.ts";
+export {
+  assertReplayable,
+  CASSETTE_VERSION,
+  loadCassette,
+  recordingTransport,
+  replayTransport,
+  resumeTransport,
+} from "./cassette/index.ts";
 export type {
   AskInvalidOutputOutcome,
   AskLimitKind,
@@ -40,24 +44,23 @@ export type {
   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";
+} 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,
@@ -70,22 +73,26 @@ export type {
   RunOutcome,
   RunState,
   RunSummary,
-} from "./summary.ts";
-export { applyEvent, initialSummary } from "./summary.ts";
-export { readSystemPromptSidecar } from "./system-prompt-recorder.ts";
+} 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.ts";
+} from "./transport/index.ts";
+export { readSystemPromptSidecar, reap, worktreeTransport } from "./transport/index.ts";
 export type {
   AskOptions,
   Handle,
@@ -104,4 +111,3 @@ export {
   PROMPT_GIST_MAX_CHARS,
   TOOL_ARGS_GIST_MAX_CHARS,
 } from "./wire-constants.ts";
-export { worktreeTransport } from "./worktree-transport.ts";

package/src/model/index.ts

@@ -0,0 +1,15 @@
+/**
+ * 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/src/node/index.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/src/{node-decoder-subagent.ts → node/node-decoder-subagent.ts}

@@ -1,4 +1,4 @@
-import type { NodeState } from "./events.ts";
+import type { NodeState } from "../events.ts";
 import type { DecodedNode, NodeDecoder } from "./node-decoder.ts";
 import { isRecord, nodeGist, nodeUsage } from "./node-details.ts";
 

package/src/{node-decoder-workflow.ts → node/node-decoder-workflow.ts}

@@ -1,4 +1,4 @@
-import type { NodeState } from "./events.ts";
+import type { NodeState } from "../events.ts";
 import type { DecodedNode, NodeDecoder } from "./node-decoder.ts";
 import { isRecord, nodeGist, nodeUsage } from "./node-details.ts";
 

package/src/{node-decoder.ts → node/node-decoder.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 {

package/src/{node-details.ts → node/node-details.ts}

@@ -1,6 +1,6 @@
-import type { NodeUsage } from "./events.ts";
-import type { TokenBreakdown } from "./transport.ts";
-import { NODE_GIST_MAX_CHARS } from "./wire-constants.ts";
+import type { NodeUsage } from "../events.ts";
+import type { TokenBreakdown } from "../transport/index.ts";
+import { NODE_GIST_MAX_CHARS } from "../wire-constants.ts";
 
 /**
  * Reading untrusted nesting-tool detail payloads. Every decoder narrows from

package/src/{node-tracker.ts → node/node-tracker.ts}

@@ -1,9 +1,9 @@
-import type { NodeState, NodeUsage } from "./events.ts";
+import type { NodeState, NodeUsage } from "../events.ts";
+import type { Frame } from "../transport/index.ts";
 import type { DecodedNode, NodeDecoder } from "./node-decoder.ts";
 import { DEFAULT_NODE_DECODERS } from "./node-decoders.ts";
 import { isRecord } from "./node-details.ts";
 import { sanitizeNodeName } from "./node-path.ts";
-import type { Frame } from "./transport.ts";
 
 /** One Nested Node observation, relative to the tool call that produced it. */
 export interface NodeSnapshot {

package/src/prompt/index.ts

@@ -0,0 +1,7 @@
+/**
+ * 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/src/{prompt-gist.ts → prompt/prompt-gist.ts}

@@ -1,4 +1,4 @@
-import { PROMPT_GIST_MAX_CHARS } from "./wire-constants.ts";
+import { PROMPT_GIST_MAX_CHARS } from "../wire-constants.ts";
 
 /**
  * Condenses an Ask prompt for the `ask_start` Lifecycle Event.

package/src/{args-validation.ts → run/args-validation.ts}

@@ -1,7 +1,7 @@
 import type { TSchema } from "typebox";
 import { Value } from "typebox/value";
-import { YaagError } from "./errors.ts";
-import { formatValidationErrors } from "./validation-errors.ts";
+import { YaagError } from "../errors.ts";
+import { formatValidationErrors } from "../validation-errors.ts";
 
 /** Throws ARGS_INVALID when value violates schema, without changing value. */
 export function validateArgs(schema: TSchema, value: unknown): void {

package/src/run/index.ts

@@ -0,0 +1,13 @@
+/**
+ * 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/src/{run-context.ts → run/run-context.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> {

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

@@ -1,37 +1,43 @@
 import { join } from "node:path";
 import type { TSchema } from "typebox";
-import type { Agent } from "./agent.ts";
-import { validateArgs } from "./args-validation.ts";
-import { type Cassette, CassetteCollector, type CassetteSink } from "./cassette.ts";
-import { assertReplayable, interruptedResumeWarning, loadCassette } from "./cassette-loader.ts";
+import type { Agent } from "../agent/index.ts";
+import { makeSpawn } from "../agent/index.ts";
 import {
+  assertReplayable,
+  type Cassette,
+  CassetteCollector,
+  type CassetteSink,
   checkpointFileName,
   cleanStaleCheckpointTemp,
-  resolveCheckpointDirectory,
-} from "./checkpoint-dir.ts";
-import { createCheckpointFlusher, flushingSink } from "./checkpoint-flush.ts";
-import { type OrchestrationProgram, programDefinition } from "./define-run.ts";
-import { isYaagError, YaagError } from "./errors.ts";
-import type { EventSink, LifecycleEvent, RunOutcome, StampedEventSink } from "./events.ts";
-import { liveTransport } from "./live-transport.ts";
-import { recordingTransport } from "./recording-transport.ts";
-import { replayTransport } from "./replay-transport.ts";
-import { programIdentityWarning } from "./resume-identity.ts";
-import { resumeTransport } from "./resume-transport.ts";
-import {
+  createCheckpointFlusher,
+  flushingSink,
+  interruptedResumeWarning,
+  loadCassette,
   type ProgramIdentity,
+  programIdentityWarning,
   publishRunCheckpoint,
   type RunCheckpointResult,
+  recordingTransport,
+  replayTransport,
+  resolveCheckpointDirectory,
   resolveRunIdentity,
+  resumeTransport,
   writeRecordingDiagnostic,
-} from "./run-checkpoint.ts";
+} from "../cassette/index.ts";
+import { isYaagError, YaagError } from "../errors.ts";
+import type { EventSink, LifecycleEvent, RunOutcome, StampedEventSink } from "../events.ts";
+import { applyEvent, initialSummary, type RunSummary } from "../summary/index.ts";
+import type { TransportFactory } from "../transport/index.ts";
+import {
+  liveSkillProbe,
+  liveTransport,
+  type SkillProbeFactory,
+  skillRestrictionTransport,
+  worktreeTransport,
+} from "../transport/index.ts";
+import { validateArgs } from "./args-validation.ts";
+import { type OrchestrationProgram, programDefinition } from "./define-run.ts";
 import type { RunContext } from "./run-context.ts";
-import { liveSkillProbe, type SkillProbeFactory } from "./skill-probe.ts";
-import { skillRestrictionTransport } from "./skill-restriction-transport.ts";
-import { makeSpawn } from "./spawn.ts";
-import { applyEvent, initialSummary, type RunSummary } from "./summary.ts";
-import type { TransportFactory } from "./transport.ts";
-import { worktreeTransport } from "./worktree-transport.ts";
 
 export interface RunOptions {
   /** Where Agents come from. Defaults to real `pi --mode rpc` processes. */

package/src/summary/index.ts

@@ -0,0 +1,22 @@
+/**
+ * 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/src/{summary-agent.ts → summary/summary-agent.ts}

@@ -1,8 +1,8 @@
-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. */

package/src/{summary-nodes.ts → summary/summary-nodes.ts}

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

package/src/{summary.ts → summary/summary.ts}

@@ -1,4 +1,5 @@
-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 AgentRecord,
@@ -11,9 +12,8 @@ import {
   totalsFromAgents,
 } from "./summary-agent.ts";
 import { applyNodeUpdate } from "./summary-nodes.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,

package/src/{connection.ts → transport/connection.ts}

@@ -1,4 +1,4 @@
-import { YaagError } from "./errors.ts";
+import { YaagError } from "../errors.ts";
 import type { AgentTransport, Frame } from "./transport.ts";
 
 /** The useful part of a `response` frame, once narrowed. */

package/src/{fake-transport.ts → transport/fake-transport.ts}

@@ -1,7 +1,10 @@
-import { DEFAULT_WRAP_UP_PROMPT } from "./ask-limit.ts";
+import {
+  DEFAULT_WRAP_UP_PROMPT,
+  isReportResultCommandFrame,
+  REPORT_RESULT_TOOL_NAME,
+} from "../ask-contract/index.ts";
 import { FrameQueue } from "./frame-queue.ts";
 import { parseFrame } from "./jsonl.ts";
-import { isReportResultCommandFrame, REPORT_RESULT_TOOL_NAME } from "./report-result.ts";
 import type { AgentStats, AgentTransport, AskMarker, Frame } from "./transport.ts";
 
 /**
@@ -287,7 +290,7 @@ export function reportResultFrames(value: unknown, toolCallId = "call-1"): reado
  * Rejects when the fixture cannot be read or contains an invalid frame.
  */
 export async function recordedFrames(name: string): Promise<Frame[]> {
-  const text = await Bun.file(`${import.meta.dir}/fixtures/${name}.jsonl`).text();
+  const text = await Bun.file(`${import.meta.dir}/../fixtures/${name}.jsonl`).text();
   return text
     .split("\n")
     .map(parseFrame)

package/src/transport/index.ts

@@ -0,0 +1,41 @@
+/**
+ * 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/src/{live-transport.ts → transport/live-transport.ts}

@@ -1,4 +1,4 @@
-import { YaagError } from "./errors.ts";
+import { YaagError } from "../errors.ts";
 import { FrameQueue } from "./frame-queue.ts";
 import { decodeFrames } from "./jsonl.ts";
 import { piCommand, readModel, readSessionFile, readStats } from "./pi-state.ts";

package/src/{pi-state.ts → transport/pi-state.ts}

@@ -1,4 +1,4 @@
-import { REPORT_RESULT_EXTENSION_PATH, REPORT_RESULT_TOOL_NAME } from "./report-result.ts";
+import { REPORT_RESULT_EXTENSION_PATH, REPORT_RESULT_TOOL_NAME } from "../ask-contract/index.ts";
 import { SYSTEM_PROMPT_RECORDER_EXTENSION_PATH } from "./system-prompt-recorder.ts";
 import type { AgentStats, Frame, OpenOptions, TokenBreakdown } from "./transport.ts";
 

package/src/{tool-probe.ts → transport/tool-probe.ts}

@@ -1,7 +1,6 @@
 import { fileURLToPath } from "node:url";
-
+import { REPORT_RESULT_TOOL_NAME } from "../ask-contract/index.ts";
 import { type ToolSelection, toolAllowlist } from "./pi-state.ts";
-import { REPORT_RESULT_TOOL_NAME } from "./report-result.ts";
 import type { Frame } from "./transport.ts";
 
 /** The private status key used only by yaag's internal pi tool probe extension. */

package/src/{transport.ts → transport/transport.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

package/src/{worktree-transport.ts → transport/worktree-transport.ts}

@@ -1,6 +1,6 @@
 import { lstat, mkdir } from "node:fs/promises";
 import { basename, dirname, join } from "node:path";
-import { YaagError } from "./errors.ts";
+import { YaagError } from "../errors.ts";
 import type {
   AgentTransport,
   OpenOptions,

package/src/types.ts

@@ -1,8 +1,7 @@
 import type { Static, TSchema } from "typebox";
-import type { ModelSpec, ThinkingSpec } from "./model-resolution.ts";
-import type { ThinkingLevel } from "./thinking-level.ts";
+import type { ModelSpec, ThinkingLevel, ThinkingSpec } from "./model/index.ts";
 
-export type { ThinkingLevel } from "./thinking-level.ts";
+export type { ThinkingLevel } from "./model/index.ts";
 
 /** Options for spawning one Agent (ADR-0001, ADR-0009, ADR-0026). */
 export interface SpawnOptions {