@tai42/api-client 17.1.2 → 18.0.0

package/dist/schemas/served.d.ts

@@ -180,6 +180,11 @@ export type PresetBody = z.input<typeof presetBody>;
 export declare const conversationRoute: z.ZodObject<{
     callback_secret: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
     callback_url: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    cancel_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
     channel: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
     door: z.ZodEnum<{
         channel: "channel";
@@ -188,6 +193,11 @@ export declare const conversationRoute: z.ZodObject<{
     error_reply_text: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
     execution_key: z.ZodString;
     execution_key_fingerprint: z.ZodString;
+    extras_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
     initial_mode: z.ZodDefault<z.ZodEnum<{
         agent: "agent";
         manual: "manual";
@@ -205,17 +215,22 @@ export declare const conversationRoute: z.ZodObject<{
         }>>;
         settle_seconds: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
-    payload_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+    reply_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
         kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>, z.ZodNull]>>;
-    reply_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+    resume_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
         kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>, z.ZodNull]>>;
     route_name: z.ZodString;
+    start_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
     target_kind: z.ZodEnum<{
         tool: "tool";
         agent: "agent";
@@ -226,6 +241,11 @@ export declare const conversationRoute: z.ZodObject<{
 export type ConversationRoute = z.infer<typeof conversationRoute>;
 export declare const conversationRouteCreate: z.ZodObject<{
     callback_url: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    cancel_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
     channel: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
     door: z.ZodEnum<{
         channel: "channel";
@@ -233,6 +253,11 @@ export declare const conversationRouteCreate: z.ZodObject<{
     }>;
     error_reply_text: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
     execution_key: z.ZodString;
+    extras_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
     initial_mode: z.ZodDefault<z.ZodEnum<{
         agent: "agent";
         manual: "manual";
@@ -250,17 +275,22 @@ export declare const conversationRouteCreate: z.ZodObject<{
         }>>;
         settle_seconds: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
-    payload_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+    reply_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
         kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>, z.ZodNull]>>;
-    reply_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+    resume_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
         kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>, z.ZodNull]>>;
     route_name: z.ZodString;
+    start_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
     target_kind: z.ZodEnum<{
         tool: "tool";
         agent: "agent";
@@ -356,6 +386,11 @@ export declare const hookSubject: z.ZodObject<{
 }, z.core.$strict>;
 export type HookSubject = z.infer<typeof hookSubject>;
 export declare const hookParams: z.ZodObject<{
+    cancel_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
     condition: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
@@ -363,12 +398,22 @@ export declare const hookParams: z.ZodObject<{
     }, z.core.$strict>, z.ZodNull]>>;
     execution_key: z.ZodString;
     execution_key_fingerprint: z.ZodString;
-    expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+    extras_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
         kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>, z.ZodNull]>>;
     name: z.ZodString;
+    resume_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
+    start_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
     state_binding: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         states: z.ZodArray<z.ZodObject<{
             input_injections: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -431,18 +476,33 @@ export declare const hookParams: z.ZodObject<{
 }, z.core.$strip>;
 export type HookParams = z.infer<typeof hookParams>;
 export declare const hookRegister: z.ZodObject<{
+    cancel_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
     condition: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
         kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>, z.ZodNull]>>;
     execution_key: z.ZodString;
-    expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+    extras_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
         kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>, z.ZodNull]>>;
     name: z.ZodString;
+    resume_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
+    start_expr: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodNull]>>;
     state_binding: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         states: z.ZodArray<z.ZodObject<{
             input_injections: z.ZodDefault<z.ZodArray<z.ZodObject<{

package/dist/schemas/served.d.ts.map

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

package/dist/schemas/system-kinds.d.ts

@@ -44,10 +44,10 @@ export declare const toolExtensionsApplyResult: z.ZodObject<{
             name: z.ZodString;
             outcome: z.ZodEnum<{
                 failed: "failed";
+                applied: "applied";
                 resyncing: "resyncing";
                 recycling: "recycling";
                 stale: "stale";
-                applied: "applied";
                 missing: "missing";
                 departed: "departed";
                 timed_out: "timed_out";
@@ -66,10 +66,10 @@ export declare const toolExtensionsApplyResult: z.ZodObject<{
             name: z.ZodString;
             outcome: z.ZodEnum<{
                 failed: "failed";
+                applied: "applied";
                 resyncing: "resyncing";
                 recycling: "recycling";
                 stale: "stale";
-                applied: "applied";
                 missing: "missing";
                 departed: "departed";
                 timed_out: "timed_out";
@@ -104,10 +104,10 @@ export declare const mcpReloadResult: z.ZodObject<{
         name: z.ZodString;
         outcome: z.ZodEnum<{
             failed: "failed";
+            applied: "applied";
             resyncing: "resyncing";
             recycling: "recycling";
             stale: "stale";
-            applied: "applied";
             missing: "missing";
             departed: "departed";
             timed_out: "timed_out";

package/dist/schemas/tools.d.ts

@@ -13,6 +13,105 @@ export declare const allToolSchemas: z.ZodRecord<z.ZodString, z.ZodObject<{
     description: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>>;
 export declare const runToolResult: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+/** The lifecycle status a parked interaction on a run's subject carries: a pending ask, an
+ * ask whose continuation is resuming, or a resolved run's waiting outcome (clean/failed). */
+export declare const parkedStatus: z.ZodEnum<{
+    running: "running";
+    failed: "failed";
+    asking: "asking";
+    finished: "finished";
+}>;
+export type ParkedStatus = z.infer<typeof parkedStatus>;
+/**
+ * One parked caller-ask entry a synchronous run-tool call returns when the tool asked its
+ * CALLER (`to="caller"`) and parked. The full contract entry carries more fields; the panel
+ * reads the display subset here and tolerates the rest. `question` is the prompt, `payload`
+ * the structured value the ask handed the caller, `asked_by` the run chain that raised it.
+ */
+export declare const parkedCallerAsk: 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>;
+export type ParkedCallerAsk = z.infer<typeof parkedCallerAsk>;
+/** A synchronous run whose tool parked CALLER asks returns this envelope in place of a result:
+ * the full caller-ask entries under `asks`. An empty `asks` means the run parked with no open
+ * caller ask (only user asks remain). */
+export declare const callerAsksEnvelope: 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>;
+export type CallerAsksEnvelope = z.infer<typeof callerAsksEnvelope>;
+/** The park receipt a synchronous run returns when its tool parked only USER asks: the
+ * suspension sentinel's ids, with no caller ask for the panel to act on. */
+export declare const suspendedRunReceipt: 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 SuspendedRunReceipt = z.infer<typeof suspendedRunReceipt>;
+/** What one resume / take / cancel of a parked interaction did, as `resume_parked` /
+ * `cancel_parked` return it through run-tool. `kind` picks the payload: `result` (a final
+ * value in `result`), `asks` (new caller asks in `asks`), `parked` (only user asks remain),
+ * or `none` (nothing ran). `action` names the single non-cancel action taken. */
+export declare const visitOutcome: z.ZodObject<{
+    action: z.ZodEnum<{
+        none: "none";
+        resumed: "resumed";
+        taken: "taken";
+        started: "started";
+    }>;
+    cancelled: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    kind: z.ZodEnum<{
+        result: "result";
+        none: "none";
+        asks: "asks";
+        parked: "parked";
+    }>;
+    result: z.ZodOptional<z.ZodUnknown>;
+    asks: z.ZodDefault<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>;
+export type VisitOutcome = z.infer<typeof visitOutcome>;
 /**
  * The MEDIA content shape a direct tool run may return — fastmcp's serialized
  * `Image`/`Audio` MediaBlock (`{ type, data: <base64>, mimeType }`). One recognised

package/dist/schemas/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/schemas/tools.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,SAAS,yBAAsB,CAAC;AAE7C,eAAO,MAAM,UAAU;;;;iBAIrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,cAAc;;;;kBAAmC,CAAC;AAE/D,eAAO,MAAM,aAAa,yEAAY,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe;;;;;;;iBASxB,CAAC;AACL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAC;AACH,eAAO,MAAM,QAAQ;;;;;kBAAwB,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/schemas/tools.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,SAAS,yBAAsB,CAAC;AAE7C,eAAO,MAAM,UAAU;;;;iBAIrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,cAAc;;;;kBAAmC,CAAC;AAE/D,eAAO,MAAM,aAAa,yEAAY,CAAC;AAEvC;6FAC6F;AAC7F,eAAO,MAAM,YAAY;;;;;EAAsD,CAAC;AAChF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;iBAO1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;yCAEyC;AACzC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;iBAE7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;4EAC4E;AAC5E,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;;iFAGiF;AACjF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe;;;;;;;iBASxB,CAAC;AACL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAC;AACH,eAAO,MAAM,QAAQ;;;;;kBAAwB,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/schemas/tools.js

@@ -9,6 +9,47 @@ export const toolSchema = z.object({
 });
 export const allToolSchemas = z.record(z.string(), toolSchema);
 export const runToolResult = jsonValue;
+/** The lifecycle status a parked interaction on a run's subject carries: a pending ask, an
+ * ask whose continuation is resuming, or a resolved run's waiting outcome (clean/failed). */
+export const parkedStatus = z.enum(['asking', 'running', 'finished', 'failed']);
+/**
+ * One parked caller-ask entry a synchronous run-tool call returns when the tool asked its
+ * CALLER (`to="caller"`) and parked. The full contract entry carries more fields; the panel
+ * reads the display subset here and tolerates the rest. `question` is the prompt, `payload`
+ * the structured value the ask handed the caller, `asked_by` the run chain that raised it.
+ */
+export const parkedCallerAsk = z.object({
+    id: z.string(),
+    status: parkedStatus,
+    to: z.enum(['user', 'caller']).nullish(),
+    question: z.string().nullish(),
+    payload: z.record(z.string(), z.unknown()).nullish(),
+    asked_by: z.array(z.string()).nullish(),
+});
+/** A synchronous run whose tool parked CALLER asks returns this envelope in place of a result:
+ * the full caller-ask entries under `asks`. An empty `asks` means the run parked with no open
+ * caller ask (only user asks remain). */
+export const callerAsksEnvelope = z.object({
+    asks: z.array(parkedCallerAsk),
+});
+/** The park receipt a synchronous run returns when its tool parked only USER asks: the
+ * suspension sentinel's ids, with no caller ask for the panel to act on. */
+export const suspendedRunReceipt = z.object({
+    interaction_id: z.string(),
+    interaction_ids: z.array(z.string()),
+    caller_interaction_ids: z.array(z.string()).default([]),
+});
+/** What one resume / take / cancel of a parked interaction did, as `resume_parked` /
+ * `cancel_parked` return it through run-tool. `kind` picks the payload: `result` (a final
+ * value in `result`), `asks` (new caller asks in `asks`), `parked` (only user asks remain),
+ * or `none` (nothing ran). `action` names the single non-cancel action taken. */
+export const visitOutcome = z.object({
+    action: z.enum(['resumed', 'taken', 'started', 'none']),
+    cancelled: z.array(z.string()).default([]),
+    kind: z.enum(['result', 'asks', 'parked', 'none']),
+    result: z.unknown().optional(),
+    asks: z.array(parkedCallerAsk).default([]),
+});
 /**
  * The MEDIA content shape a direct tool run may return — fastmcp's serialized
  * `Image`/`Audio` MediaBlock (`{ type, data: <base64>, mimeType }`). One recognised

package/dist/schemas/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/schemas/tools.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAE7C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC;KACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE;IAC9D,OAAO,EAAE,iFAAiF;IAC1F,IAAI,EAAE,CAAC,UAAU,CAAC;CACnB,CAAC,CAAC;AAGL;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;CACpB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/schemas/tools.ts"],"names":[],"mappings":"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"}

package/dist/tool-runs.d.ts

@@ -9,38 +9,45 @@
  *
  * The background surface detaches a run from its HTTP request: submit returns a
  * `run_id` immediately (202), then the caller POLLS the single-run GET until the
- * status is terminal (`succeeded | failed | lost`). The list GET returns the
- * recent runs for one tool — id/status/timestamps only, never `result`/`error`.
+ * status is terminal (`succeeded | failed | lost | parked`). The list GET returns
+ * the recent runs for one tool — id/status/timestamps only, never `result`/`error`.
  */
 import { z } from 'zod';
 import type { ApiConfig } from './http';
+import type { StateSubject } from './schemas/states';
 /** A run's lifecycle state. `lost` = the server restarted mid-run; the result is
- * unrecoverable. `running` is the only non-terminal state. */
+ * unrecoverable. `parked` = the run's tool async-parked; its `result` is the park
+ * answer (see {@link toolRunParkAnswer}). `running` is the only non-terminal state. */
 export declare const toolRunStatus: z.ZodEnum<{
     running: "running";
-    succeeded: "succeeded";
     failed: "failed";
+    parked: "parked";
+    succeeded: "succeeded";
     lost: "lost";
 }>;
 /** `POST /api/tool-runs` → the handle for the detached run. */
 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
- * (present only on `succeeded`); `error` is present only on `failed`. */
+/** `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<{
     run_id: z.ZodString;
     tool_name: z.ZodString;
     status: z.ZodEnum<{
         running: "running";
-        succeeded: "succeeded";
         failed: "failed";
+        parked: "parked";
+        succeeded: "succeeded";
         lost: "lost";
     }>;
     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). */
@@ -49,8 +56,9 @@ export declare const toolRunListItem: z.ZodObject<{
     tool_name: z.ZodString;
     status: z.ZodEnum<{
         running: "running";
-        succeeded: "succeeded";
         failed: "failed";
+        parked: "parked";
+        succeeded: "succeeded";
         lost: "lost";
     }>;
     started_at: z.ZodString;
@@ -61,14 +69,44 @@ export declare const toolRunList: z.ZodArray<z.ZodObject<{
     tool_name: z.ZodString;
     status: z.ZodEnum<{
         running: "running";
-        succeeded: "succeeded";
         failed: "failed";
+        parked: "parked";
+        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>;
 export type ToolRunRecord = z.infer<typeof toolRunRecord>;
 export type ToolRunListItem = z.infer<typeof toolRunListItem>;
@@ -76,6 +114,9 @@ export type ToolRunListItem = z.infer<typeof toolRunListItem>;
 export interface SubmitToolRunArgs {
     readonly tool_name: string;
     readonly arguments?: Record<string, unknown>;
+    /** The addressed subject an async park of the detached run indexes under. Omitted
+     * from the request body when unset. */
+    readonly subject?: StateSubject;
 }
 /** Submit a tool for detached background execution; resolves with its `run_id`. */
 export declare function submitToolRun(config: ApiConfig, args: SubmitToolRunArgs, signal?: AbortSignal): Promise<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;AAGxC;8DAC8D;AAC9D,eAAO,MAAM,aAAa;;;;;EAAqD,CAAC;AAEhF,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAEH;yEACyE;AACzE,eAAO,MAAM,aAAa;;;;;;;;;;;;;iBAQxB,CAAC;AAEH;iFACiF;AACjF,eAAO,MAAM,eAAe;;;;;;;;;;;iBAM1B,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;kBAA2B,CAAC;AAEpD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,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;CAC9C;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,iBAAiB,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAM9B;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;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"}

package/dist/tool-runs.js

@@ -9,20 +9,24 @@
  *
  * The background surface detaches a run from its HTTP request: submit returns a
  * `run_id` immediately (202), then the caller POLLS the single-run GET until the
- * status is terminal (`succeeded | failed | lost`). The list GET returns the
- * recent runs for one tool — id/status/timestamps only, never `result`/`error`.
+ * status is terminal (`succeeded | failed | lost | parked`). The list GET returns
+ * 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';
 /** A run's lifecycle state. `lost` = the server restarted mid-run; the result is
- * unrecoverable. `running` is the only non-terminal state. */
-export const toolRunStatus = z.enum(['running', 'succeeded', 'failed', 'lost']);
+ * unrecoverable. `parked` = the run's tool async-parked; its `result` is the park
+ * answer (see {@link toolRunParkAnswer}). `running` is the only non-terminal state. */
+export const toolRunStatus = z.enum(['running', 'succeeded', 'failed', 'lost', 'parked']);
 /** `POST /api/tool-runs` → the handle for the detached run. */
 export const toolRunSubmitResult = z.object({
     run_id: z.string(),
 });
-/** `GET /api/tool-runs/{run_id}` → the full record. `result` is arbitrary JSON
- * (present only on `succeeded`); `error` is present only on `failed`. */
+/** `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(),
@@ -31,6 +35,7 @@ export const toolRunRecord = z.object({
     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). */
@@ -42,11 +47,22 @@ export const toolRunListItem = z.object({
     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.
+ */
+export const toolRunParkAnswer = z.union([callerAsksEnvelope, suspendedRunReceipt]);
 /** 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, {
         method: 'POST',
-        body: { tool_name: args.tool_name, arguments: args.arguments ?? {} },
+        body: {
+            tool_name: args.tool_name,
+            arguments: args.arguments ?? {},
+            ...(args.subject !== undefined ? { subject: args.subject } : {}),
+        },
         signal,
     });
 }

package/dist/tool-runs.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-runs.js","sourceRoot":"","sources":["../src/tool-runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEnD;8DAC8D;AAC9D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH;yEACyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,aAAa;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH;iFACiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,aAAa;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AAapD,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAC3B,MAAiB,EACjB,IAAuB,EACvB,MAAoB;IAEpB,OAAO,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,mBAAmB,EAAE;QAC/D,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE;QACpE,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,UAAU,CACxB,MAAiB,EACjB,KAAa,EACb,MAAoB;IAEpB,OAAO,UAAU,CAAC,MAAM,EAAE,kBAAkB,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,aAAa,EAAE;QACjF,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAC1B,MAAiB,EACjB,QAAgB,EAChB,MAAoB;IAEpB,OAAO,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE;QACvD,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;QAC9B,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,OAAO,MAAM,KAAK,SAAS,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"tool-runs.js","sourceRoot":"","sources":["../src/tool-runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE1E;;uFAEuF;AACvF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE1F,+DAA+D;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH;;;4FAG4F;AAC5F,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,aAAa;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAEH;iFACiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,aAAa;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAiBpF,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAC3B,MAAiB,EACjB,IAAuB,EACvB,MAAoB;IAEpB,OAAO,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,mBAAmB,EAAE;QAC/D,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;YACJ,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;YAC/B,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE;QACD,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,UAAU,CACxB,MAAiB,EACjB,KAAa,EACb,MAAoB;IAEpB,OAAO,UAAU,CAAC,MAAM,EAAE,kBAAkB,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,aAAa,EAAE;QACjF,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAC1B,MAAiB,EACjB,QAAgB,EAChB,MAAoB;IAEpB,OAAO,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE;QACvD,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;QAC9B,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,OAAO,MAAM,KAAK,SAAS,CAAC;AAC9B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tai42/api-client",
-  "version": "17.1.2",
+  "version": "18.0.0",
   "description": "Typed client for the tai42-skeleton HTTP API.",
   "license": "Apache-2.0",
   "author": "tai42 <oss@tai42.ai>",

package/src/client/channels-client.ts

@@ -5,7 +5,7 @@ import type { Transport } from './transport';
 export function channelsClient(t: Transport) {
   const { req } = t;
   return {
-    // The installed channel-plugin names (delivery media for ask_user questions).
+    // The installed channel-plugin names (delivery media for ask questions).
     listChannels: (signal?: AbortSignal) => req('/api/channels', s.channels, { signal }),
   };
 }

package/src/client/schedules-client.ts

@@ -13,8 +13,17 @@ export function schedulesClient(t: Transport) {
       tool_name: string;
       tool_kwargs: Record<string, unknown>;
       schedule_kwargs: Record<string, unknown>;
+      // The api-key user_id a contract-bearing recurring fire runs as; required with any door jq.
+      execution_key?: string | null;
       // The optional door-layer state binding applied around every fire of this schedule.
       state_binding?: s.StateBinding | null;
+      // The optional door-contract jqs a parkable-driving schedule carries: start_expr
+      // builds the fired tool's kwargs, cancel/resume act on parked interactions, extras
+      // builds the started run's extras.
+      start_expr?: s.TemplatedText | null;
+      cancel_expr?: s.TemplatedText | null;
+      resume_expr?: s.TemplatedText | null;
+      extras_expr?: s.TemplatedText | null;
     }) => req('/api/schedules', s.jsonValue, { method: 'POST', body }),
     deleteSchedule: (name: string) =>
       req(`/api/schedules/${encodeSegment(name)}`, s.jsonValue, { method: 'DELETE' }),