@tai42/api-client 20.0.0 → 22.0.0

package/dist/tool-runs.d.ts

@@ -20,8 +20,8 @@ import type { StateSubject } from './schemas/states';
  * answer (see {@link toolRunParkAnswer}). `running` is the only non-terminal state. */
 export declare const toolRunStatus: z.ZodEnum<{
     running: "running";
-    failed: "failed";
     parked: "parked";
+    failed: "failed";
     succeeded: "succeeded";
     lost: "lost";
 }>;
@@ -29,82 +29,203 @@ export declare const toolRunStatus: z.ZodEnum<{
 export declare const toolRunSubmitResult: z.ZodObject<{
     run_id: z.ZodString;
 }, z.core.$strip>;
-/** `GET /api/tool-runs/{run_id}` → the full record. `result` is arbitrary JSON: the
- * tool's own value on `succeeded`, the park answer ({@link toolRunParkAnswer}) on
- * `parked`. `error` is present only on `failed`. `resumed_interactions` is the parked
- * interaction ids the run resumed or took while it executed (`[]` when it resumed none). */
-export declare const toolRunRecord: z.ZodObject<{
+/**
+ * The `result` a `parked` record carries: the run answer the synchronous run-tool door
+ * returns, restricted to its two park kinds — `asks` (the tool asked its CALLER and parked)
+ * or `parked` (only USER asks remain).
+ */
+export declare const toolRunParkAnswer: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    asks: z.ZodArray<z.ZodObject<{
+        answer_format: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        asked_by: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        audience: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        channel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        error: z.ZodDefault<z.ZodUnknown>;
+        expiry_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        format_payload: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        group_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        id: z.ZodString;
+        media: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+        on_expiry: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+            kill: "kill";
+            resume: "resume";
+        }>>>;
+        payload: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        question: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        recipient: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        result: z.ZodDefault<z.ZodUnknown>;
+        status: z.ZodEnum<{
+            running: "running";
+            asking: "asking";
+            failed: "failed";
+            finished: "finished";
+        }>;
+        thread_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        to: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+            caller: "caller";
+            user: "user";
+        }>>>;
+    }, z.core.$strict>>;
+    kind: z.ZodDefault<z.ZodLiteral<"asks">>;
+    suspended: z.ZodObject<{
+        caller_interaction_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        expiry_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        interaction_id: z.ZodString;
+        interaction_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        resume_owner: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodDefault<z.ZodLiteral<"parked">>;
+    suspended: z.ZodObject<{
+        caller_interaction_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        expiry_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        interaction_id: z.ZodString;
+        interaction_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        resume_owner: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "kind">;
+/**
+ * `GET /api/tool-runs/{run_id}` → the full record, the published `ToolRunView` narrowed by
+ * `status` into one variant per lifecycle state. `result` is the tool's own value on
+ * `succeeded` and, on `parked`, the park answer ({@link toolRunParkAnswer}) parsed here so a
+ * reader switches on its `kind`; a parked record whose stored answer is not one of the two park
+ * kinds is refused on the read. `error` carries a `failed` run's message; `outcome` is set only
+ * on a `failed` record whose run reached a failed terminal: the run's outcome, whole, as the
+ * sync door delivers it (`error` is then the plain `tool run failed`). `resumed_interactions` is
+ * the parked interaction ids the run resumed or took while it executed (`[]` when it resumed
+ * none).
+ */
+export declare const toolRunRecord: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    finished_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    outcome: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    result: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    resumed_interactions: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     run_id: z.ZodString;
+    started_at: z.ZodString;
     tool_name: z.ZodString;
-    status: z.ZodEnum<{
-        running: "running";
-        failed: "failed";
-        parked: "parked";
-        succeeded: "succeeded";
-        lost: "lost";
-    }>;
+    status: z.ZodLiteral<"running">;
+}, z.core.$strip>, z.ZodObject<{
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    finished_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    outcome: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    result: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    resumed_interactions: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    run_id: z.ZodString;
     started_at: z.ZodString;
-    finished_at: z.ZodOptional<z.ZodString>;
-    result: z.ZodOptional<z.ZodUnknown>;
-    error: z.ZodOptional<z.ZodString>;
-    resumed_interactions: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-/** One entry of `GET /api/tool-runs?tool_name=...` — id/status/timestamps only,
- * deliberately carrying NO `result`/`error` (the list is not secret-bearing). */
+    tool_name: z.ZodString;
+    status: z.ZodLiteral<"succeeded">;
+}, z.core.$strip>, z.ZodObject<{
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    finished_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    outcome: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    result: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    resumed_interactions: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    run_id: z.ZodString;
+    started_at: z.ZodString;
+    tool_name: z.ZodString;
+    status: z.ZodLiteral<"failed">;
+}, z.core.$strip>, z.ZodObject<{
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    finished_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    outcome: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    result: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    resumed_interactions: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    run_id: z.ZodString;
+    started_at: z.ZodString;
+    tool_name: z.ZodString;
+    status: z.ZodLiteral<"lost">;
+}, z.core.$strip>, z.ZodObject<{
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    finished_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    outcome: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    resumed_interactions: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    run_id: z.ZodString;
+    started_at: z.ZodString;
+    tool_name: z.ZodString;
+    status: z.ZodLiteral<"parked">;
+    result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        asks: z.ZodArray<z.ZodObject<{
+            answer_format: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            asked_by: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            audience: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            channel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            created_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            error: z.ZodDefault<z.ZodUnknown>;
+            expiry_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            format_payload: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            group_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            id: z.ZodString;
+            media: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+            on_expiry: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                kill: "kill";
+                resume: "resume";
+            }>>>;
+            payload: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            question: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            recipient: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            result: z.ZodDefault<z.ZodUnknown>;
+            status: z.ZodEnum<{
+                running: "running";
+                asking: "asking";
+                failed: "failed";
+                finished: "finished";
+            }>;
+            thread_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            to: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                caller: "caller";
+                user: "user";
+            }>>>;
+        }, z.core.$strict>>;
+        kind: z.ZodDefault<z.ZodLiteral<"asks">>;
+        suspended: z.ZodObject<{
+            caller_interaction_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            expiry_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            interaction_id: z.ZodString;
+            interaction_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            resume_owner: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"parked">>;
+        suspended: z.ZodObject<{
+            caller_interaction_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            expiry_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            interaction_id: z.ZodString;
+            interaction_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            resume_owner: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>], "status">;
+/** One entry of `GET /api/tool-runs?tool_name=...` — the published list row (id, status,
+ * timestamps; never `result`/`error`, the list is not secret-bearing), its `status` narrowed to
+ * the lifecycle states. */
 export declare const toolRunListItem: z.ZodObject<{
+    finished_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     run_id: z.ZodString;
+    started_at: z.ZodString;
     tool_name: z.ZodString;
     status: z.ZodEnum<{
         running: "running";
-        failed: "failed";
         parked: "parked";
+        failed: "failed";
         succeeded: "succeeded";
         lost: "lost";
     }>;
-    started_at: z.ZodString;
-    finished_at: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const toolRunList: z.ZodArray<z.ZodObject<{
+    finished_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     run_id: z.ZodString;
+    started_at: z.ZodString;
     tool_name: z.ZodString;
     status: z.ZodEnum<{
         running: "running";
-        failed: "failed";
         parked: "parked";
+        failed: "failed";
         succeeded: "succeeded";
         lost: "lost";
     }>;
-    started_at: z.ZodString;
-    finished_at: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>;
-/**
- * The `result` a `parked` record carries — the SAME park answer the synchronous run-tool
- * door returns: either the caller-ask envelope `{asks: [...]}` (the tool asked its CALLER
- * and parked) or the suspension receipt (the run parked only USER asks, ids only). A poller
- * reads it to tell a caller-ask park from a user-only one, exactly as the sync door's caller does.
- */
-export declare const toolRunParkAnswer: z.ZodUnion<readonly [z.ZodObject<{
-    asks: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        status: z.ZodEnum<{
-            running: "running";
-            failed: "failed";
-            asking: "asking";
-            finished: "finished";
-        }>;
-        to: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            user: "user";
-            caller: "caller";
-        }>>>;
-        question: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        payload: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-        asked_by: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>, z.ZodObject<{
-    interaction_id: z.ZodString;
-    interaction_ids: z.ZodArray<z.ZodString>;
-    caller_interaction_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>]>;
 export type ToolRunStatus = z.infer<typeof toolRunStatus>;
 export type ToolRunParkAnswer = z.infer<typeof toolRunParkAnswer>;
 export type ToolRunSubmitResult = z.infer<typeof toolRunSubmitResult>;

package/dist/tool-runs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-runs.d.ts","sourceRoot":"","sources":["../src/tool-runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;uFAEuF;AACvF,eAAO,MAAM,aAAa;;;;;;EAA+D,CAAC;AAE1F,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAEH;;;4FAG4F;AAC5F,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;iBASxB,CAAC;AAEH;iFACiF;AACjF,eAAO,MAAM,eAAe;;;;;;;;;;;;iBAM1B,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;kBAA2B,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;mBAAqD,CAAC;AAEpF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C;2CACuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACjC;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,iBAAiB,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAU9B;AAED,kEAAkE;AAClE,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAIxB;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,EAAE,CAAC,CAK5B;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAElE"}
+{"version":3,"file":"tool-runs.d.ts","sourceRoot":"","sources":["../src/tool-runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;uFAEuF;AACvF,eAAO,MAAM,aAAa;;;;;;EAA+D,CAAC;AAE1F,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAAiE,CAAC;AAEhG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAMxB,CAAC;AAEH;;2BAE2B;AAC3B,eAAO,MAAM,eAAe;;;;;;;;;;;;iBAA6D,CAAC;AAE1F,eAAO,MAAM,WAAW;;;;;;;;;;;;kBAA2B,CAAC;AAEpD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C;2CACuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACjC;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,iBAAiB,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAU9B;AAED,kEAAkE;AAClE,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CASxB;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,EAAE,CAAC,CAK5B;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAElE"}

package/dist/tool-runs.js

@@ -13,8 +13,9 @@
  * the recent runs for one tool — id/status/timestamps only, never `result`/`error`.
  */
 import { z } from 'zod';
-import { apiRequest, encodeSegment } from './http';
-import { callerAsksEnvelope, suspendedRunReceipt } from './schemas/tools';
+import { apiRoutes, buildPath } from './generated/api-routes';
+import { runAsksAnswer, runParkedAnswer, toolRunListItem as generatedToolRunListItem, toolRunView, } from './generated/openapi-schemas';
+import { apiRequest } from './http';
 /** A run's lifecycle state. `lost` = the server restarted mid-run; the result is
  * unrecoverable. `parked` = the run's tool async-parked; its `result` is the park
  * answer (see {@link toolRunParkAnswer}). `running` is the only non-terminal state. */
@@ -23,40 +24,38 @@ export const toolRunStatus = z.enum(['running', 'succeeded', 'failed', 'lost', '
 export const toolRunSubmitResult = z.object({
     run_id: z.string(),
 });
-/** `GET /api/tool-runs/{run_id}` → the full record. `result` is arbitrary JSON: the
- * tool's own value on `succeeded`, the park answer ({@link toolRunParkAnswer}) on
- * `parked`. `error` is present only on `failed`. `resumed_interactions` is the parked
- * interaction ids the run resumed or took while it executed (`[]` when it resumed none). */
-export const toolRunRecord = z.object({
-    run_id: z.string(),
-    tool_name: z.string(),
-    status: toolRunStatus,
-    started_at: z.string(),
-    finished_at: z.string().optional(),
-    result: z.unknown().optional(),
-    error: z.string().optional(),
-    resumed_interactions: z.array(z.string()).optional(),
-});
-/** One entry of `GET /api/tool-runs?tool_name=...` — id/status/timestamps only,
- * deliberately carrying NO `result`/`error` (the list is not secret-bearing). */
-export const toolRunListItem = z.object({
-    run_id: z.string(),
-    tool_name: z.string(),
-    status: toolRunStatus,
-    started_at: z.string(),
-    finished_at: z.string().optional(),
-});
-export const toolRunList = z.array(toolRunListItem);
 /**
- * The `result` a `parked` record carries — the SAME park answer the synchronous run-tool
- * door returns: either the caller-ask envelope `{asks: [...]}` (the tool asked its CALLER
- * and parked) or the suspension receipt (the run parked only USER asks, ids only). A poller
- * reads it to tell a caller-ask park from a user-only one, exactly as the sync door's caller does.
+ * The `result` a `parked` record carries: the run answer the synchronous run-tool door
+ * returns, restricted to its two park kinds — `asks` (the tool asked its CALLER and parked)
+ * or `parked` (only USER asks remain).
+ */
+export const toolRunParkAnswer = z.discriminatedUnion('kind', [runAsksAnswer, runParkedAnswer]);
+/**
+ * `GET /api/tool-runs/{run_id}` → the full record, the published `ToolRunView` narrowed by
+ * `status` into one variant per lifecycle state. `result` is the tool's own value on
+ * `succeeded` and, on `parked`, the park answer ({@link toolRunParkAnswer}) parsed here so a
+ * reader switches on its `kind`; a parked record whose stored answer is not one of the two park
+ * kinds is refused on the read. `error` carries a `failed` run's message; `outcome` is set only
+ * on a `failed` record whose run reached a failed terminal: the run's outcome, whole, as the
+ * sync door delivers it (`error` is then the plain `tool run failed`). `resumed_interactions` is
+ * the parked interaction ids the run resumed or took while it executed (`[]` when it resumed
+ * none).
  */
-export const toolRunParkAnswer = z.union([callerAsksEnvelope, suspendedRunReceipt]);
+export const toolRunRecord = z.discriminatedUnion('status', [
+    toolRunView.extend({ status: z.literal('running') }),
+    toolRunView.extend({ status: z.literal('succeeded') }),
+    toolRunView.extend({ status: z.literal('failed') }),
+    toolRunView.extend({ status: z.literal('lost') }),
+    toolRunView.extend({ status: z.literal('parked'), result: toolRunParkAnswer }),
+]);
+/** One entry of `GET /api/tool-runs?tool_name=...` — the published list row (id, status,
+ * timestamps; never `result`/`error`, the list is not secret-bearing), its `status` narrowed to
+ * the lifecycle states. */
+export const toolRunListItem = generatedToolRunListItem.extend({ status: toolRunStatus });
+export const toolRunList = z.array(toolRunListItem);
 /** Submit a tool for detached background execution; resolves with its `run_id`. */
 export function submitToolRun(config, args, signal) {
-    return apiRequest(config, '/api/tool-runs', toolRunSubmitResult, {
+    return apiRequest(config, apiRoutes.post_api_tool_runs.path, toolRunSubmitResult, {
         method: 'POST',
         body: {
             tool_name: args.tool_name,
@@ -68,13 +67,13 @@ export function submitToolRun(config, args, signal) {
 }
 /** Read one background run's current record (the poll target). */
 export function getToolRun(config, runId, signal) {
-    return apiRequest(config, `/api/tool-runs/${encodeSegment(runId)}`, toolRunRecord, {
+    return apiRequest(config, buildPath(apiRoutes.get_api_tool_runs_run_id.path, { run_id: runId }), toolRunRecord, {
         signal,
     });
 }
 /** List the recent background runs for one tool (newest first). */
 export function listToolRuns(config, toolName, signal) {
-    return apiRequest(config, '/api/tool-runs', toolRunList, {
+    return apiRequest(config, apiRoutes.get_api_tool_runs.path, toolRunList, {
         query: { tool_name: toolName },
         signal,
     });

package/dist/tool-runs.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tai42/api-client",
-  "version": "20.0.0",
+  "version": "22.0.0",
   "description": "Typed client for the tai42-skeleton HTTP API.",
   "license": "Apache-2.0",
   "author": "tai42 <oss@tai42.ai>",
@@ -56,8 +56,9 @@
     "lint": "eslint src --max-warnings 0",
     "format:check": "prettier --check \"src/**/*.{ts,tsx}\"",
     "test": "vitest run",
-    "api:check": "api-extractor run --config config/api-extractor.json",
-    "api:update": "api-extractor run --local --config config/api-extractor.json",
+    "api:build": "tsc -b tsconfig.build.json --clean && tsc -b tsconfig.build.json",
+    "api:check": "pnpm run api:build && api-extractor run --config config/api-extractor.json",
+    "api:update": "pnpm run api:build && api-extractor run --local --config config/api-extractor.json",
     "schema:generate": "node scripts/gen-schemas.mjs",
     "schema:check": "node scripts/gen-schemas.mjs --check",
     "schema:refresh": "node scripts/schema-refresh.mjs"

package/src/agents.ts

@@ -17,7 +17,9 @@
 import { z } from 'zod';
 
 import { ApiError, ApiUnauthorizedError } from './errors';
-import { type ApiConfig, encodeSegment, extractError } from './http';
+import { apiRoutes, buildPath } from './generated/api-routes';
+import { API_KEY_HEADER } from './headers';
+import { type ApiConfig, extractError } from './http';
 import { readSseFrames, type SseFrame, SseFrameParser, sseOpenToken } from './sse';
 
 // -- list schema -------------------------------------------------------------
@@ -202,7 +204,7 @@ async function openAgentStream(
     accept: 'text/event-stream',
     'content-type': 'application/json',
   };
-  if (token) headers['x-api-key'] = token;
+  if (token) headers[API_KEY_HEADER] = token;
   // Distinct-URL per open — see the canonical constraint on `sseOpenToken`.
   const url = `${config.baseUrl ?? ''}${path}?_=${sseOpenToken()}`;
   const response = await doFetch(url, {
@@ -240,7 +242,12 @@ export async function streamAgentRun(
   input: unknown,
   signal?: AbortSignal,
 ): Promise<AsyncGenerator<ParsedAgentEvent>> {
-  return openAgentStream(config, `/api/agents/${encodeSegment(name)}/runs`, input, signal);
+  return openAgentStream(
+    config,
+    buildPath(apiRoutes.post_api_agents_name_runs.path, { name }),
+    input,
+    signal,
+  );
 }
 
 /**
@@ -255,7 +262,12 @@ export async function streamAuthoredAgentRun(
   input: unknown,
   signal?: AbortSignal,
 ): Promise<AsyncGenerator<ParsedAgentEvent>> {
-  return openAgentStream(config, `/api/agents/authored/${encodeSegment(name)}/runs`, input, signal);
+  return openAgentStream(
+    config,
+    buildPath(apiRoutes.post_api_agents_authored_name_runs.path, { name }),
+    input,
+    signal,
+  );
 }
 
 /**

package/src/client/agents-client.ts

@@ -1,15 +1,16 @@
 /** Agent listing and streaming-run sub-client. */
 import { agentList, streamAgentRun, streamAuthoredAgentRun } from '../agents';
+import { apiRoutes } from '../generated/api-routes';
 import type { Transport } from './transport';
 
 export function agentsClient(t: Transport) {
   const { config, req } = t;
   return {
-    listAgents: (signal?: AbortSignal) => req('/api/agents', agentList, { signal }),
+    listAgents: (signal?: AbortSignal) => req(apiRoutes.get_api_agents.path, agentList, { signal }),
     // The authorable subset (agents whose `spec_runnable` is true) — the compose
     // UI's base-agent picker. An empty `items` list ⇒ no authoring is possible.
     listSpecRunnableAgents: (signal?: AbortSignal) =>
-      req('/api/agents/spec-runnable', agentList, { signal }),
+      req(apiRoutes.get_api_agents_spec_runnable.path, agentList, { signal }),
     // The streaming run: opens POST /api/agents/{name}/runs and yields parsed
     // agent events. The auto-form's built value is the POST body.
     streamAgentRun: (name: string, input: unknown, signal?: AbortSignal) =>