@tangle-network/agent-runtime 0.349.0 → 0.352.1

package/dist/tui/index.d.ts

@@ -1,48 +1,28 @@
-import { Ir as provisionSupervisor } from "../types-C8BGOCBn.js";
-//#region src/tui/top-snapshot.d.ts
-/**
- * The snapshot reader for the supervisor-run TUI: turn the on-disk run layout into a `TopSnapshot`.
- * ANSI frame presentation lives in `./top-frame`; this module owns reading and projection.
- *
- * This module never derives a run path itself. Every directory and per-worker file it reads comes
- * from `../runtime/supervise/run-layout` — the same module the writers use — so the reader cannot
- * drift from the layout the way an independently-versioned copy of the contract would.
- *
- * Extracted from the `loops` repo (`src/top-model.ts`), which held a hand-joined copy of the
- * layout. Rendering is deliberately unchanged: raw ANSI, zero dependencies.
- *
- * This is the OPERATOR view: what is on disk right now, for a human watching a workspace. It
- * carries no model-call identity, so its per-supervisor totals cannot be joined with root stream
- * events without double counting. A client that needs one execution's totals reads
- * `projectPursuit` from `../durable` instead.
- *
- * @experimental
- */
+import { Hr as provisionSupervisor, L as Spend, M as Budget, Wu as PursuitProjection } from "../types-0uzVKtFW.js";
 interface TopSnapshot {
   readonly root: string;
   readonly generatedAt: number;
   readonly supervisors: SupervisorView[];
+  /** Canonical facts, including unknown accounting and requested/observed identities. */
+  readonly pursuit?: PursuitProjection;
   /** `partial` when at least one discovered source could not be read completely. */
   readonly completeness: TopSnapshotCompleteness;
   /** One bounded entry per skipped or partially read source; empty when complete. */
   readonly diagnostics: ReadonlyArray<TopSnapshotDiagnostic>;
   /** Run directories found under the runs roots, readable or not. */
   readonly discovered: number;
-  /** Run directories whose state.json parsed into a valid supervisor view. */
+  /** Run directories projected into a valid supervisor view. */
   readonly loaded: number;
 }
 type TopSnapshotCompleteness = 'complete' | 'partial';
-type TopSnapshotDiagnosticSource = 'supervisor-state' | 'journal' | 'progress' | 'worker-tail';
+type TopSnapshotDiagnosticSource = 'observer-journal' | 'supervisor-state' | 'journal' | 'progress' | 'worker-tail';
 type TopSnapshotDiagnosticReason = 'unreadable' | 'partial-json' | 'invalid-state' | 'missing';
 /**
  * One skipped or partially read snapshot source. `path` is relative to the run directory and
  * never carries file contents, so a diagnostic is safe to show or log without leaking run data.
  */
-interface TopSnapshotDiagnostic {
-  readonly source: TopSnapshotDiagnosticSource;
+interface TopSnapshotDiagnostic extends SourceDiagnostic {
   readonly runId?: string;
-  readonly path: string;
-  readonly reason: TopSnapshotDiagnosticReason;
 }
 interface SupervisorBase {
   readonly id: string;
@@ -50,6 +30,7 @@ interface SupervisorBase {
   readonly task: string;
   readonly workspaceDir: string;
   readonly budget: number;
+  readonly budgetKnown?: boolean;
   readonly verifyCmd?: string;
   readonly workerModel?: string;
   readonly driverModel?: string;
@@ -92,7 +73,7 @@ interface WorkerView {
   readonly outRef?: string;
   readonly reason?: string;
 }
-interface SupervisorTotals {
+interface SupervisorTotals extends Pick<SpendStats, 'tokensInput' | 'tokensOutput' | 'usd' | 'usdKnown' | 'tokensKnown'> {
   readonly workers: number;
   readonly running: number;
   readonly done: number;
@@ -100,10 +81,7 @@ interface SupervisorTotals {
   readonly cancelled: number;
   readonly inFlight: number;
   readonly settled: number;
-  readonly tokensInput: number;
-  readonly tokensOutput: number;
   readonly tokensTotal: number;
-  readonly usd: number;
   readonly latencyMs: number;
   readonly workerLatency: Distribution;
 }
@@ -114,58 +92,46 @@ interface Distribution {
   readonly p90: number;
   readonly max: number;
 }
-interface BudgetStats {
-  readonly maxIterations?: number;
-  readonly maxTokens?: number;
-  readonly maxUsd?: number;
-}
-interface SpendStats {
-  readonly iterations: number;
+type BudgetStats = Partial<Pick<Budget, 'maxIterations' | 'maxTokens' | 'maxUsd'>>;
+interface SpendStats extends Readonly<Pick<Spend, 'iterations' | 'usd' | 'ms' | 'usdKnown' | 'tokensKnown'>> {
   readonly tokensInput: number;
   readonly tokensOutput: number;
-  readonly usd: number;
-  readonly ms: number;
 }
 type TopJournalEvent = {
-  readonly kind: 'spawned';
   readonly id: string;
+  readonly seq?: number;
+  readonly at?: string;
+} & ({
+  readonly kind: 'spawned';
   readonly parent?: string;
   readonly label?: string;
   readonly budget?: unknown;
   readonly runtime?: string;
-  readonly seq?: number;
-  readonly at?: string;
 } | {
   readonly kind: 'settled';
-  readonly id: string;
   readonly status?: string;
   readonly outRef?: string;
   readonly verdict?: unknown;
   readonly spent?: unknown;
   readonly infra?: boolean;
-  readonly seq?: number;
-  readonly at?: string;
 } | {
   readonly kind: 'cancelled';
   readonly spent?: unknown;
-  readonly id: string;
   readonly reason?: string;
-  readonly seq?: number;
-  readonly at?: string;
 } | {
   readonly kind: 'metered';
-  readonly id: string;
   readonly spend?: unknown;
   readonly accountingOnly?: boolean;
-  readonly seq?: number;
-  readonly at?: string;
 } | {
   readonly kind: 'progress';
-  readonly id: string;
   readonly spend?: unknown;
-  readonly seq?: number;
-  readonly at?: string;
-};
+});
+/** A diagnostic before its run id is attached; `loadTopSnapshot` adds `runId`. */
+interface SourceDiagnostic {
+  readonly source: TopSnapshotDiagnosticSource;
+  readonly path: string;
+  readonly reason: TopSnapshotDiagnosticReason;
+}
 /**
  * Read every supervisor run under one workspace into a single point-in-time snapshot.
  *
@@ -175,7 +141,10 @@ type TopJournalEvent = {
  * tell a removed run from a partial read. `now` is injectable so elapsed time is deterministic
  * under test.
  */
-declare function loadTopSnapshot(rootDir: string, now?: number): TopSnapshot;
-//#endregion
-export { type BudgetStats, type Distribution, type SpendStats, type SupervisorTotals, type SupervisorView, type TopJournalEvent, type TopSnapshot, type TopSnapshotCompleteness, type TopSnapshotDiagnostic, type TopSnapshotDiagnosticReason, type TopSnapshotDiagnosticSource, type WorkerView, loadTopSnapshot, provisionSupervisor };
+export declare function loadTopSnapshot(rootDir: string, now?: number): TopSnapshot;
+export declare function loadTopSnapshot(rootDir: string, options: {
+  runDir: string;
+  now?: number;
+}): Promise<TopSnapshot>;
+export { type BudgetStats, type Distribution, type SpendStats, type SupervisorTotals, type SupervisorView, type TopJournalEvent, type TopSnapshot, type TopSnapshotCompleteness, type TopSnapshotDiagnostic, type TopSnapshotDiagnosticReason, type TopSnapshotDiagnosticSource, type WorkerView, provisionSupervisor };
 //# sourceMappingURL=index.d.ts.map

package/dist/tui/index.js

@@ -1,3 +1,3 @@
-import { t as provisionSupervisor } from "../provision-supervisor-C4v2vqDo.js";
-import { n as loadTopSnapshot } from "../top-snapshot-CflmaDgk.js";
+import { t as provisionSupervisor } from "../provision-supervisor-D9pO-iPl.js";
+import { n as loadTopSnapshot } from "../top-snapshot-DcV7VG4m.js";
 export { loadTopSnapshot, provisionSupervisor };