@llm4ts/runner 3.3.0 → 4.0.0

package/src/Terminal.ts

@@ -5,18 +5,16 @@ import * as Effect from "effect/Effect"
 import * as Ref from "effect/Ref"
 import * as Semaphore from "effect/Semaphore"
 import type * as Scope from "effect/Scope"
-import * as Schema from "effect/Schema"
-import * as Stream from "effect/Stream"
 import {
-  awaitConsumed,
+  eventLanes,
   type FlowEvent,
   type FlowEventHub,
+  laneOf,
+  type LaneRef,
   rosterEventMessage,
   type ReviewFindings
 } from "@llm4ts/flow/FlowEvents"
-
-export const Verbosity = Schema.Literals(["Quiet", "Normal", "Verbose", "Debug"])
-export type Verbosity = typeof Verbosity.Type
+import { atLeast, presentationOf, type Verbosity } from "./EventPresentation.ts"
 
 export const parseVerbosity = (value: string | undefined): Verbosity => {
   switch (value?.trim().toLowerCase()) {
@@ -32,45 +30,10 @@ export const parseVerbosity = (value: string | undefined): Verbosity => {
 }
 
 export const rendersEvent = (verbosity: Verbosity, event: FlowEvent): boolean => {
-  switch (event._tag) {
-    // Advise mode publishes a separate Info event for the operator; progress
-    // feeds the status rows; a blackboard run is for the trace file; a lease
-    // ending is routine; the story's outcome already says whether the judge
-    // cleared it. None is a line of its own.
-    case "JudgmentObserved":
-    case "BlackboardRun":
-    case "UsageProgress":
-    case "ExecutorReleased":
-    case "StoryJudged":
-    case "RoundtableTurn":
-    case "BriefReported":
-    case "Timed":
-    case "TasksPlanned":
-    case "TaskStarted":
-    case "TaskCompleted":
-    case "StoryStatusChanged":
-      return false
-    // A gate or a setup may run for many minutes: its start is a line, so a
-    // long one reads as running, not stuck. Other work starts too often.
-    case "Began":
-      return event.kind === "gate" && verbosity !== "Quiet"
-    case "StageStarted":
-    case "StageCompleted":
-    case "StageFailed":
-    case "Aborted":
-    case "CapabilityDenied":
-    case "CapabilityUnenforceable":
-    case "EvidenceChecked":
-    case "ReviewFindingDemoted":
-      return true
-    // Every git read and gate command is a capability event: useful in a
-    // trace, noise on screen once several stories run.
-    case "TokensUsed":
-    case "CapabilityUsed":
-      return verbosity === "Verbose" || verbosity === "Debug"
-    default:
-      return verbosity !== "Quiet"
-  }
+  const { line } = presentationOf(event)
+  return typeof line === "function"
+    ? line(event, verbosity)
+    : line !== "never" && atLeast(verbosity, line)
 }
 
 export const terminalSafe = (value: string): string => {
@@ -313,8 +276,6 @@ export const terminalLine = (
           : palette.dim(
               `evidence: ${safe(event.task)} — ${event.claimed} claimed command(s) ran${event.confidence === undefined ? "" : `, confidence ${event.confidence}`}`
             )
-    case "Declassified":
-      return palette.info(`declassified: ${safe(event.label)}`)
     case "ExecutorLeased":
     case "ExecutorReleased":
     case "ExecutorExcluded":
@@ -548,7 +509,6 @@ export interface TerminalRunStats {
 }
 
 export interface TerminalConsumer {
-  readonly consumed: Ref.Ref<number>
   readonly stats: Effect.Effect<TerminalRunStats>
   readonly awaitDrained: (timeout?: Duration.Input) => Effect.Effect<void>
 }
@@ -562,33 +522,20 @@ interface OpenStage {
   readonly startedAt: number
 }
 
-/** The lane an event belongs to (a concurrent story), if it carries one. */
-export const laneOfEvent = (
-  event: FlowEvent
-): { readonly lane: string; readonly executor?: string } | undefined => {
-  switch (event._tag) {
-    case "StageStarted":
-    case "StageCompleted":
-    case "StageFailed":
-    case "Info":
-    case "ToolUse":
-    case "AssistantMessage":
-    case "TokensUsed":
-    case "UsageProgress":
-    case "ReviewFindings":
-    case "TasksPlanned":
-    case "TaskStarted":
-    case "TaskCompleted":
-      return event.lane === undefined
-        ? undefined
-        : {
-            lane: event.lane,
-            ...(event.executor === undefined ? {} : { executor: event.executor })
-          }
-    default:
-      return undefined
-  }
-}
+/**
+ * The lane an event belongs to on screen (a concurrent story), if it carries
+ * one. This is `laneOf` with two exclusions, both kept as they were:
+ * - an event whose producer names its lane (a verdict, a roundtable turn, an
+ *   evidence check, a parked item) prints, when it prints, as a line of the
+ *   run: only the events `withLane` stamps drive a lane's row;
+ * - `Timed` and `Began`: one arriving after its lane's last stage closed
+ *   would reopen a row that never closes (`UsageProgress` has the same
+ *   hazard and is guarded where the consumer reads it).
+ */
+export const laneOfEvent = (event: FlowEvent): LaneRef | undefined =>
+  eventLanes[event._tag].lane !== "stamped" || event._tag === "Timed" || event._tag === "Began"
+    ? undefined
+    : laneOf(event)
 
 /** `bonifici-list · lemonade-deepseek` — how a lane is named on screen. */
 export const laneLabel = (lane: string, executor: string | undefined): string =>
@@ -744,9 +691,7 @@ export const consumeTerminalEvents = Effect.fn("@llm4ts/runner/Terminal.consume"
   // Tokens of events outside any lane: the whole run, for a flow with one coder.
   const runTokens = emptyTally()
   const runInFlight = new Map<string, TokenTally>()
-  const consumed = yield* Ref.make(0)
   const statsRef = yield* Ref.make<TerminalRunStats>({ stagesCompleted: 0, stagesFailed: 0 })
-  const subscription = yield* events.subscribe
   const palette = surface.palette
   const timestampPrefix =
     options.timestamps === true
@@ -800,99 +745,93 @@ export const consumeTerminalEvents = Effect.fn("@llm4ts/runner/Terminal.consume"
       return `${line} ${palette.dim(`(${formatDurationMs(now - closed.startedAt)})`)}`
     })
 
-  yield* Stream.fromSubscription(subscription).pipe(
-    Stream.runForEach((event) =>
-      Effect.gen(function* () {
-        const tagged = laneOfEvent(event)
-        if (tagged !== undefined && event._tag === "UsageProgress" && !lanes.has(tagged.lane)) {
-          // A call that ends after its story's row closed: nothing to show.
-          yield* Ref.update(consumed, (count) => count + 1)
-          return
-        }
-        if (tagged !== undefined) {
-          const now = yield* Clock.currentTimeMillis
-          const state =
-            lanes.get(tagged.lane) ??
-            ({
-              index: lanes.size,
-              depth: 0,
-              stages: [],
-              tools: 0,
-              executor: undefined,
-              startedAt: now,
-              tokens: emptyTally(),
-              inFlight: new Map(),
-              lastTool: undefined
-            } satisfies LaneState)
-          lanes.set(tagged.lane, state)
-          if (tagged.executor !== undefined) {
-            state.executor = tagged.executor
-          }
-          let closed: OpenStage | undefined
-          if (closesChild(event)) {
-            state.depth = Math.max(0, state.depth - 1)
-          }
-          const lineDepth = state.depth
-          if (event._tag === "StageStarted") {
-            state.depth += 1
-            state.stages = [...state.stages, { name: terminalSafe(event.stage), startedAt: now }]
-          } else if (closesChild(event)) {
-            closed = state.stages.at(-1)
-            state.stages = state.stages.slice(0, -1)
-            yield* countStage(event)
-          } else if (event._tag === "ToolUse") {
-            state.tools += 1
-            state.lastTool = { tool: terminalSafe(event.tool), at: now }
-          }
-          addTokens(state.tokens, event)
-          trackProgress(state.inFlight, event)
-          if (state.stages.length === 0 && closesChild(event)) {
-            lanes.delete(tagged.lane)
-          }
-          if (rendersLanedEvent(verbosity, event)) {
-            const tag = palette.lane(state.index, `[${laneLabel(tagged.lane, state.executor)}]`)
-            const line = yield* withDuration(event, terminalLine(event, palette, verbosity), closed)
-            const prefix = yield* timestampPrefix
-            yield* surface.log(`${prefix}${tag} ${indentBlock(lineDepth, line)}`)
-          }
-          yield* refreshStatus
-          yield* Ref.update(consumed, (count) => count + 1)
-          return
+  const consumer = yield* events.consume("terminal", (event) =>
+    Effect.gen(function* () {
+      const tagged = laneOfEvent(event)
+      if (tagged !== undefined && event._tag === "UsageProgress" && !lanes.has(tagged.lane)) {
+        // A call that ends after its story's row closed: nothing to show.
+        return
+      }
+      if (tagged !== undefined) {
+        const now = yield* Clock.currentTimeMillis
+        const state =
+          lanes.get(tagged.lane) ??
+          ({
+            index: lanes.size,
+            depth: 0,
+            stages: [],
+            tools: 0,
+            executor: undefined,
+            startedAt: now,
+            tokens: emptyTally(),
+            inFlight: new Map(),
+            lastTool: undefined
+          } satisfies LaneState)
+        lanes.set(tagged.lane, state)
+        if (tagged.executor !== undefined) {
+          state.executor = tagged.executor
         }
-        if (event._tag === "TokensUsed" || event._tag === "UsageProgress") {
-          addTokens(runTokens, event)
-          trackProgress(runInFlight, event)
-          yield* refreshStatus
+        let closed: OpenStage | undefined
+        if (closesChild(event)) {
+          state.depth = Math.max(0, state.depth - 1)
         }
-        const currentDepth = closesChild(event)
-          ? yield* Ref.updateAndGet(depth, (value) => Math.max(0, value - 1))
-          : yield* Ref.get(depth)
-        let closedStage: OpenStage | undefined
+        const lineDepth = state.depth
         if (event._tag === "StageStarted") {
-          yield* Ref.update(depth, (value) => value + 1)
-          const active = terminalSafe(event.stage)
-          const startedAt = yield* Clock.currentTimeMillis
-          yield* Ref.update(stages, (current) => [...current, { name: active, startedAt }])
-          yield* refreshStatus
+          state.depth += 1
+          state.stages = [...state.stages, { name: terminalSafe(event.stage), startedAt: now }]
         } else if (closesChild(event)) {
-          closedStage = (yield* Ref.get(stages)).at(-1)
-          yield* Ref.update(stages, (current) => current.slice(0, -1))
-          yield* refreshStatus
+          closed = state.stages.at(-1)
+          state.stages = state.stages.slice(0, -1)
           yield* countStage(event)
+        } else if (event._tag === "ToolUse") {
+          state.tools += 1
+          state.lastTool = { tool: terminalSafe(event.tool), at: now }
         }
-        if (rendersEvent(verbosity, event)) {
-          const line = yield* withDuration(
-            event,
-            terminalLine(event, palette, verbosity),
-            closedStage
-          )
+        addTokens(state.tokens, event)
+        trackProgress(state.inFlight, event)
+        if (state.stages.length === 0 && closesChild(event)) {
+          lanes.delete(tagged.lane)
+        }
+        if (rendersLanedEvent(verbosity, event)) {
+          const tag = palette.lane(state.index, `[${laneLabel(tagged.lane, state.executor)}]`)
+          const line = yield* withDuration(event, terminalLine(event, palette, verbosity), closed)
           const prefix = yield* timestampPrefix
-          yield* surface.log(`${prefix}${indentBlock(currentDepth, line)}`)
+          yield* surface.log(`${prefix}${tag} ${indentBlock(lineDepth, line)}`)
         }
-        yield* Ref.update(consumed, (count) => count + 1)
-      })
-    ),
-    Effect.forkScoped
+        yield* refreshStatus
+        return
+      }
+      if (event._tag === "TokensUsed" || event._tag === "UsageProgress") {
+        addTokens(runTokens, event)
+        trackProgress(runInFlight, event)
+        yield* refreshStatus
+      }
+      const currentDepth = closesChild(event)
+        ? yield* Ref.updateAndGet(depth, (value) => Math.max(0, value - 1))
+        : yield* Ref.get(depth)
+      let closedStage: OpenStage | undefined
+      if (event._tag === "StageStarted") {
+        yield* Ref.update(depth, (value) => value + 1)
+        const active = terminalSafe(event.stage)
+        const startedAt = yield* Clock.currentTimeMillis
+        yield* Ref.update(stages, (current) => [...current, { name: active, startedAt }])
+        yield* refreshStatus
+      } else if (closesChild(event)) {
+        closedStage = (yield* Ref.get(stages)).at(-1)
+        yield* Ref.update(stages, (current) => current.slice(0, -1))
+        yield* refreshStatus
+        yield* countStage(event)
+      }
+      if (rendersEvent(verbosity, event)) {
+        const line = yield* withDuration(
+          event,
+          terminalLine(event, palette, verbosity),
+          closedStage
+        )
+        const prefix = yield* timestampPrefix
+        yield* surface.log(`${prefix}${indentBlock(currentDepth, line)}`)
+      }
+    })
   )
   // Elapsed time and "Running <tool>…" age between events too.
   yield* Effect.sleep("1 second").pipe(
@@ -901,8 +840,8 @@ export const consumeTerminalEvents = Effect.fn("@llm4ts/runner/Terminal.consume"
     Effect.forkScoped
   )
   // Display only, so a drain that gives up just means a trailing line was
-  // never printed; the shared helper already bounds the wait.
+  // never printed; the hub already bounds the wait.
   const awaitDrained = (timeout?: Duration.Input): Effect.Effect<void> =>
-    Effect.asVoid(awaitConsumed(events, consumed, timeout))
-  return { consumed, stats: Ref.get(statsRef), awaitDrained }
+    Effect.asVoid(consumer.caughtUp(timeout))
+  return { stats: Ref.get(statsRef), awaitDrained }
 })

package/src/Tools.ts

@@ -7,6 +7,7 @@ import { builtinTools } from "@llm4ts/flow/tools/Builtin"
 import type { ToolReport, ToolSpec } from "@llm4ts/flow/tools/Tool"
 import { isToolName, renderUsage, specOf, type ToolShape } from "@llm4ts/flow/tools/Tool"
 import type { ToolPreset } from "@llm4ts/flow/Pack"
+import { settingValue } from "@llm4ts/flow/Settings"
 import type { DiscoveredKit } from "./Kits.ts"
 
 /**
@@ -177,7 +178,7 @@ export const toolBrief = (
   specs: ReadonlyMap<string, ToolSpec>,
   environment: Readonly<Record<string, string | undefined>> = process.env
 ): string | undefined => {
-  if (environment.LLM4TS_TOOL_BRIEF?.trim().toLowerCase() === "off") {
+  if (!settingValue("LLM4TS_TOOL_BRIEF", environment)) {
     return undefined
   }
   const lines = [

package/src/Transcripts.ts

@@ -4,6 +4,7 @@ import * as Effect from "effect/Effect"
 import * as Schema from "effect/Schema"
 import { summariseToolArgs } from "@llm4ts/flow/Activity"
 import { TranscriptEntry, type TranscriptSink } from "@llm4ts/flow/Transcript"
+import { settingValue } from "@llm4ts/flow/Settings"
 import { duration } from "./AgentTree.ts"
 
 /**
@@ -14,10 +15,10 @@ import { duration } from "./AgentTree.ts"
  * never fails the run.
  */
 
-/** `LLM4TS_TRANSCRIPT=on` (what `--transcript` sets); also `1`, `true`, `yes`. */
+/** `LLM4TS_TRANSCRIPT=on` (what `--transcript` sets). */
 export const transcriptsWanted = (
   environment: Readonly<Record<string, string | undefined>>
-): boolean => /^(on|1|true|yes)$/iu.test(environment.LLM4TS_TRANSCRIPT?.trim() ?? "")
+): boolean => settingValue("LLM4TS_TRANSCRIPT", environment) === true
 
 export const transcriptFileOf = (lane: string | undefined): string =>
   `${(lane ?? "run").replace(/[^A-Za-z0-9._-]/gu, "_")}.jsonl`

package/src/WindowsCommand.ts

@@ -1,3 +1,4 @@
+// @internal: Windows command resolution for NodeProcessExecutor
 import { existsSync } from "node:fs"
 // win32 semantics explicitly, never the host's: this module only ever
 // describes Windows, so it should not change meaning with the platform it

package/src/index.ts

@@ -14,8 +14,10 @@ export {
   asReadOnly,
   asToolless,
   coderFor,
-  coderFromEnv,
   mock,
+  coderFromEnvironment,
+  reasonerFromEnvironment,
+  seatsFromEnvironment,
   withModel,
   withTurnLimit
 } from "./Connectors.ts"
@@ -24,7 +26,6 @@ export type { OpenedPack } from "./Packs.ts"
 export { nodePlainFileStore } from "./NodePlainFileStore.ts"
 export { makeNodeWorkspace } from "./NodeWorkspace.ts"
 export { nodeProcessExecutor } from "./NodeProcessExecutor.ts"
-export { reviewFingerprint } from "./ReviewFingerprint.ts"
 
 export { completeAndPublish, implementPlanFlow } from "@llm4ts/flow/Flow"
 export type { ImplementPlanOptions } from "@llm4ts/flow/Flow"

package/dist/Costs.d.ts

@@ -1,52 +0,0 @@
-import type * as DateTime from "effect/DateTime";
-import * as Effect from "effect/Effect";
-import * as Schema from "effect/Schema";
-import { CostReport } from "@llm4ts/flow/CostReport";
-import type { PlainFileStoreShape } from "@llm4ts/flow/Persistence";
-/**
- * `llm4ts costs`: the budgeting view over every trace the runner wrote.
- *
- * Traces are the source for timing: a run can span hours and only the trace
- * carries a timestamp per token report, which the hourly buckets need. The
- * cost ledger is the source for each run's total: its line is the run's own
- * summary, and a trace can be short (`CostReport.reconcileWithLedger`). One
- * unreadable trace is reported and skipped rather than failing the whole
- * report — the other runs still answer the question.
- */
-export declare const TraceDirectoryName = ".llm4ts";
-/** `trace-<timestamp>.jsonl` as the runner writes it, or a prefixed variant like `loop-trace-…`. */
-export declare const isTraceFileName: (name: string) => boolean;
-export declare const nodeListTraces: (directory: string) => ReadonlyArray<string>;
-export interface CostsOptions {
-    /** Repositories whose `.llm4ts/` traces are read. */
-    readonly repos: ReadonlyArray<string>;
-    /** Drop token reports before this epoch millisecond. */
-    readonly since?: number;
-    readonly timeZone?: DateTime.TimeZone;
-    readonly runsPerDay?: number;
-}
-export interface CostsDependencies {
-    readonly files: PlainFileStoreShape;
-    /** Absolute trace paths under one `.llm4ts/` directory. */
-    readonly listTraces: (directory: string) => ReadonlyArray<string>;
-}
-export declare const nodeCostsDependencies: () => CostsDependencies;
-declare const SkippedTrace_base: Schema.Class<SkippedTrace, Schema.Struct<{
-    readonly path: Schema.String;
-    readonly reason: Schema.String;
-}>, {}>;
-export declare class SkippedTrace extends SkippedTrace_base {
-}
-declare const CostsResult_base: Schema.Class<CostsResult, Schema.Struct<{
-    readonly report: typeof CostReport;
-    readonly traces: Schema.Int;
-    readonly skipped: Schema.$Array<typeof SkippedTrace>;
-    /** Runs whose trace was short or missing, completed from their cost ledger line. */
-    readonly ledgerRuns: Schema.withDecodingDefaultKey<Schema.withConstructorDefault<Schema.$Array<Schema.String>>, never>;
-}>, {}>;
-export declare class CostsResult extends CostsResult_base {
-}
-export declare const makeCostsProgram: (options: CostsOptions, dependencies?: CostsDependencies | undefined) => Effect.Effect<CostsResult, never, never>;
-export declare const renderCostsResult: (result: CostsResult) => string;
-export {};
-//# sourceMappingURL=Costs.d.ts.map

package/dist/Costs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Costs.d.ts","sourceRoot":"","sources":["../src/Costs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EACL,UAAU,EAMX,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAInE;;;;;;;;;GASG;AAEH,eAAO,MAAM,kBAAkB,YAAY,CAAA;AAE3C,oGAAoG;AACpG,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,OAAiD,CAAA;AAEhG,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,KAAG,aAAa,CAAC,MAAM,CAM/D,CAAA;AAER,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACrC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAA;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC,CAAA;CAClE;AAED,eAAO,MAAM,qBAAqB,QAAO,iBAGvC,CAAA;;;;;AAEF,qBAAa,YAAa,SAAQ,iBAGhC;CAAG;;;;;IAMH,oFAAoF;;;AAJtF,qBAAa,WAAY,SAAQ,gBAS/B;CAAG;AAEL,eAAO,MAAM,gBAAgB,mHAgD3B,CAAA;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,WAAW,KAAG,MAkBvD,CAAA"}

package/dist/Costs.js

@@ -1,95 +0,0 @@
-import { existsSync, readdirSync } from "node:fs";
-import { join } from "node:path";
-import * as Effect from "effect/Effect";
-import * as Schema from "effect/Schema";
-import { CostLedgerFileName, loadCostLedger } from "@llm4ts/flow/CostLedger";
-import { CostReport, buildCostReport, reconcileWithLedger, renderCostReport, usageSamplesFromTrace } from "@llm4ts/flow/CostReport";
-import { describeFlowError } from "@llm4ts/flow/FlowError";
-import { readTrace } from "@llm4ts/flow/Replay";
-import { nodePlainFileStore } from "./NodePlainFileStore.js";
-/**
- * `llm4ts costs`: the budgeting view over every trace the runner wrote.
- *
- * Traces are the source for timing: a run can span hours and only the trace
- * carries a timestamp per token report, which the hourly buckets need. The
- * cost ledger is the source for each run's total: its line is the run's own
- * summary, and a trace can be short (`CostReport.reconcileWithLedger`). One
- * unreadable trace is reported and skipped rather than failing the whole
- * report — the other runs still answer the question.
- */
-export const TraceDirectoryName = ".llm4ts";
-/** `trace-<timestamp>.jsonl` as the runner writes it, or a prefixed variant like `loop-trace-…`. */
-export const isTraceFileName = (name) => /(?:^|-)trace-\d+\.jsonl$/u.test(name);
-export const nodeListTraces = (directory) => existsSync(directory)
-    ? readdirSync(directory)
-        .filter(isTraceFileName)
-        .sort()
-        .map((name) => join(directory, name))
-    : [];
-export const nodeCostsDependencies = () => ({
-    files: nodePlainFileStore,
-    listTraces: nodeListTraces
-});
-export class SkippedTrace extends Schema.Class("SkippedTrace")({
-    path: Schema.String,
-    reason: Schema.String
-}) {
-}
-export class CostsResult extends Schema.Class("CostsResult")({
-    report: CostReport,
-    traces: Schema.Int,
-    skipped: Schema.Array(SkippedTrace),
-    /** Runs whose trace was short or missing, completed from their cost ledger line. */
-    ledgerRuns: Schema.Array(Schema.String).pipe(Schema.withConstructorDefault(Effect.succeed([])), Schema.withDecodingDefaultKey(Effect.succeed([])))
-}) {
-}
-export const makeCostsProgram = Effect.fn("@llm4ts/runner/Costs.make")(function* (options, dependencies = nodeCostsDependencies()) {
-    const paths = options.repos.flatMap((repo) => dependencies.listTraces(join(repo, TraceDirectoryName)));
-    const skipped = [];
-    const traced = [];
-    for (const path of paths) {
-        const lines = yield* readTrace(dependencies.files, path).pipe(Effect.catch((error) => Effect.sync(() => {
-            skipped.push(SkippedTrace.make({ path, reason: describeFlowError(error) }));
-            return [];
-        })));
-        traced.push(...usageSamplesFromTrace(lines));
-    }
-    // An unreadable ledger is no ledger: the traces still answer, uncorrected.
-    const records = [];
-    for (const repo of options.repos) {
-        const path = join(repo, TraceDirectoryName, CostLedgerFileName);
-        records.push(...(yield* loadCostLedger(dependencies.files, path).pipe(Effect.catch((error) => Effect.sync(() => {
-            skipped.push(SkippedTrace.make({ path, reason: describeFlowError(error) }));
-            return [];
-        })))));
-    }
-    const reconciled = reconcileWithLedger(traced, records);
-    const samples = reconciled.samples.filter((sample) => options.since === undefined || sample.at >= options.since);
-    return CostsResult.make({
-        report: buildCostReport(samples, {
-            ...(options.timeZone === undefined ? {} : { timeZone: options.timeZone }),
-            ...(options.runsPerDay === undefined ? {} : { runsPerDay: options.runsPerDay })
-        }),
-        traces: paths.length,
-        skipped,
-        ledgerRuns: reconciled.filledRuns
-    });
-});
-export const renderCostsResult = (result) => {
-    const skipped = result.skipped.length === 0
-        ? []
-        : ["", ...result.skipped.map((entry) => `skipped ${entry.path}: ${entry.reason}`)];
-    const ledger = result.ledgerRuns.length === 0
-        ? []
-        : [
-            `${result.ledgerRuns.length} run${result.ledgerRuns.length === 1 ? "" : "s"} completed from the cost ledger (trace short or missing, remainder at the run's start): ${result.ledgerRuns.join(", ")}`
-        ];
-    return [
-        renderCostReport(result.report),
-        "",
-        `traces read: ${result.traces - result.skipped.length} of ${result.traces}`,
-        ...ledger,
-        ...skipped
-    ].join("\n");
-};
-//# sourceMappingURL=Costs.js.map

package/dist/Costs.js.map

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

package/dist/McpStdio.d.ts

@@ -1,7 +0,0 @@
-import * as Effect from "effect/Effect";
-import * as Stream from "effect/Stream";
-import { type FlowError } from "@llm4ts/flow/FlowError";
-import { type McpTool } from "@llm4ts/flow/McpServer";
-export declare const mcpStdioResponses: <R>(lines: Stream.Stream<string, FlowError, R>, tools: ReadonlyArray<McpTool>) => Stream.Stream<string, FlowError, R>;
-export declare const runMcpStdio: (tools: ReadonlyArray<McpTool>, write?: (line: string) => void) => Effect.Effect<void, FlowError>;
-//# sourceMappingURL=McpStdio.d.ts.map

package/dist/McpStdio.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"McpStdio.d.ts","sourceRoot":"","sources":["../src/McpStdio.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACrE,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAEpE,eAAO,MAAM,iBAAiB,GAAI,CAAC,EACjC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,EAC1C,OAAO,aAAa,CAAC,OAAO,CAAC,KAC5B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAIlC,CAAA;AAEH,eAAO,MAAM,WAAW,GACtB,OAAO,aAAa,CAAC,OAAO,CAAC,EAC7B,QAAO,CAAC,IAAI,EAAE,MAAM,KAAK,IAA0C,KAClE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAqB7B,CAAA"}

package/dist/McpStdio.js

@@ -1,19 +0,0 @@
-import { createInterface } from "node:readline";
-import { stdin, stdout } from "node:process";
-import * as Effect from "effect/Effect";
-import * as Stream from "effect/Stream";
-import { ProcessError } from "@llm4ts/flow/FlowError";
-import { handleMcpLine } from "@llm4ts/flow/McpServer";
-export const mcpStdioResponses = (lines, tools) => lines.pipe(Stream.mapEffect((line) => handleMcpLine(line, tools)), Stream.filter((response) => response !== undefined));
-export const runMcpStdio = (tools, write = (line) => stdout.write(`${line}\n`)) => Effect.acquireUseRelease(Effect.sync(() => createInterface({
-    input: stdin,
-    crlfDelay: Infinity,
-    terminal: false
-})), (input) => {
-    const lines = Stream.fromAsyncIterable(input, (error) => ProcessError.make({
-        message: "MCP stdio input",
-        detail: error instanceof Error ? error.message : String(error)
-    }));
-    return mcpStdioResponses(lines, tools).pipe(Stream.runForEach((line) => Effect.sync(() => write(line))));
-}, (input) => Effect.sync(() => input.close()));
-//# sourceMappingURL=McpStdio.js.map

package/dist/McpStdio.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"McpStdio.js","sourceRoot":"","sources":["../src/McpStdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAkB,MAAM,wBAAwB,CAAA;AACrE,OAAO,EAAE,aAAa,EAAgB,MAAM,wBAAwB,CAAA;AAEpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,KAA0C,EAC1C,KAA6B,EACQ,EAAE,CACvC,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EACtD,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAsB,EAAE,CAAC,QAAQ,KAAK,SAAS,CAAC,CACxE,CAAA;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,KAA6B,EAC7B,QAAgC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,EACnC,EAAE,CAClC,MAAM,CAAC,iBAAiB,CACtB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CACf,eAAe,CAAC;IACd,KAAK,EAAE,KAAK;IACZ,SAAS,EAAE,QAAQ;IACnB,QAAQ,EAAE,KAAK;CAChB,CAAC,CACH,EACD,CAAC,KAAK,EAAE,EAAE;IACR,MAAM,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACtD,YAAY,CAAC,IAAI,CAAC;QAChB,OAAO,EAAE,iBAAiB;QAC1B,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KAC/D,CAAC,CACH,CAAA;IACD,OAAO,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,CACzC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAC5D,CAAA;AACH,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAC5C,CAAA"}