@studio-foundation/contracts 0.17.1 → 0.18.0

package/dist/spawner.d.ts

@@ -1,4 +1,17 @@
+import type { StageStatus } from './stage';
 import type { TokenUsage } from './usage';
+/**
+ * One stage of a child run, as the parent sees it. The flat `token_usage` says
+ * what a child cost; this says what bought it. Without it a caller pricing a
+ * fan-out assumes one call per item, under-counting every retried stage.
+ */
+export interface ChildStageUsage {
+    stage: string;
+    status: StageStatus;
+    /** Attempts the stage's RALPH loop made. 0 for a stage that ran no agent. */
+    attempts: number;
+    token_usage?: TokenUsage;
+}
 /**
  * Per-spawn execution overrides. In-process spawners honour them; a remote
  * spawner ignores them, because they name objects that live in this process.
@@ -29,6 +42,19 @@ export interface SpawnResult {
     output: unknown;
     /** What the child run spent, summed over its stages. Absent when unreported. */
     token_usage?: TokenUsage;
+    /** The per-stage breakdown behind `token_usage`. Absent when the spawner reports none. */
+    stages?: ChildStageUsage[];
+}
+/**
+ * A child run that reached a terminal non-success status. The calls it made were
+ * still billed, so the throw carries the same record a successful spawn returns.
+ */
+export declare class ChildRunError extends Error {
+    run_id: string;
+    run_status: string;
+    stages: ChildStageUsage[];
+    token_usage?: TokenUsage | undefined;
+    constructor(message: string, run_id: string, run_status: string, stages: ChildStageUsage[], token_usage?: TokenUsage | undefined);
 }
 export interface RunSpawner {
     spawnAndWait(config: SpawnConfig): Promise<SpawnResult>;

package/dist/spawner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawner.d.ts","sourceRoot":"","sources":["../src/spawner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,gFAAgF;IAChF,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACzD"}
+{"version":3,"file":"spawner.d.ts","sourceRoot":"","sources":["../src/spawner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,gFAAgF;IAChF,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAG7B,MAAM,EAAE,MAAM;IACd,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE,eAAe,EAAE;IACzB,WAAW,CAAC,EAAE,UAAU;gBAJ/B,OAAO,EAAE,MAAM,EACR,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EAAE,EACzB,WAAW,CAAC,EAAE,UAAU,YAAA;CAKlC;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACzD"}

package/dist/spawner.js

@@ -1,4 +1,21 @@
 // The abstraction that studio-run tool uses to launch child runs.
 // Implementations: DirectEngineSpawner (engine) and HttpApiSpawner (api).
-export {};
+/**
+ * A child run that reached a terminal non-success status. The calls it made were
+ * still billed, so the throw carries the same record a successful spawn returns.
+ */
+export class ChildRunError extends Error {
+    run_id;
+    run_status;
+    stages;
+    token_usage;
+    constructor(message, run_id, run_status, stages, token_usage) {
+        super(message);
+        this.run_id = run_id;
+        this.run_status = run_status;
+        this.stages = stages;
+        this.token_usage = token_usage;
+        this.name = 'ChildRunError';
+    }
+}
 //# sourceMappingURL=spawner.js.map

package/dist/spawner.js.map

@@ -1 +1 @@
-{"version":3,"file":"spawner.js","sourceRoot":"","sources":["../src/spawner.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,0EAA0E"}
+{"version":3,"file":"spawner.js","sourceRoot":"","sources":["../src/spawner.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,0EAA0E;AAsD1E;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAG7B;IACA;IACA;IACA;IALT,YACE,OAAe,EACR,MAAc,EACd,UAAkB,EAClB,MAAyB,EACzB,WAAwB;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QALR,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAQ;QAClB,WAAM,GAAN,MAAM,CAAmB;QACzB,gBAAW,GAAX,WAAW,CAAa;QAG/B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studio-foundation/contracts",
-  "version": "0.17.1",
+  "version": "0.18.0",
   "description": "Shared TypeScript types and interfaces for Studio packages",
   "type": "module",
   "main": "./dist/index.js",