@heddleagent/execution-host-client 6.5.0 → 6.6.0

package/dist/coordinator/contracts.d.ts

@@ -1,8 +1,10 @@
 import { z } from 'zod';
 export declare const HOSTED_HEARTBEAT_COORDINATOR_PATHS: Readonly<{
+    state: "/v1/coordinator";
     tasks: "/v1/heartbeat/tasks";
     pause: "/v1/control/pause";
     resume: "/v1/control/resume";
+    drain: "/v1/control/drain";
 }>;
 export declare const HOSTED_HEARTBEAT_DELEGATIONS_PATH = "/hosted-execution/internal/heartbeat-delegations";
 export declare const HostedHeartbeatCoordinatorTaskInputSchema: z.ZodObject<{
@@ -21,14 +23,374 @@ export declare const HostedHeartbeatCoordinatorTaskInputSchema: z.ZodObject<{
     searchIgnoreDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
     systemContext: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
-export declare const HostedHeartbeatCoordinatorTaskSummarySchema: z.ZodObject<{
+export declare const HostedHeartbeatCoordinatorStateSchema: z.ZodEnum<{
+    running: "running";
+    paused: "paused";
+    drained: "drained";
+    stopped: "stopped";
+}>;
+export declare const HostedHeartbeatCoordinatorStateResponseSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        running: "running";
+        paused: "paused";
+        drained: "drained";
+        stopped: "stopped";
+    }>;
+}, z.core.$strict>;
+export declare const HostedHeartbeatCoordinatorTaskStatusSchema: z.ZodEnum<{
+    running: "running";
+    failed: "failed";
+    idle: "idle";
+    waiting: "waiting";
+    blocked: "blocked";
+    complete: "complete";
+}>;
+export declare const HostedHeartbeatCoordinatorTaskResultSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        agent: "agent";
+        cancelled: "cancelled";
+        failed: "failed";
+        blocked: "blocked";
+        skipped: "skipped";
+        retry: "retry";
+    }>;
+    decision: z.ZodOptional<z.ZodEnum<{
+        continue: "continue";
+        pause: "pause";
+        complete: "complete";
+        escalate: "escalate";
+    }>>;
+    summary: z.ZodString;
+    outcome: z.ZodString;
+    agentRunId: z.ZodOptional<z.ZodString>;
+    usage: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$loose>;
+/** Stable product/operator projection returned by the Coordinator API. */
+export declare const HostedHeartbeatCoordinatorTaskViewSchema: z.ZodObject<{
     id: z.ZodString;
+    taskId: z.ZodString;
     workspaceId: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    task: z.ZodString;
+    enabled: z.ZodBoolean;
+    continuationMode: z.ZodOptional<z.ZodEnum<{
+        operator: "operator";
+        agent: "agent";
+    }>>;
+    schedule: z.ZodObject<{
+        intervalMs: z.ZodNumber;
+        nextRunAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$loose>;
+    state: z.ZodObject<{
+        status: z.ZodEnum<{
+            running: "running";
+            failed: "failed";
+            idle: "idle";
+            waiting: "waiting";
+            blocked: "blocked";
+            complete: "complete";
+        }>;
+        progress: z.ZodOptional<z.ZodString>;
+        runId: z.ZodOptional<z.ZodString>;
+        runAt: z.ZodOptional<z.ZodISODateTime>;
+        loadedCheckpoint: z.ZodOptional<z.ZodBoolean>;
+        resumable: z.ZodOptional<z.ZodBoolean>;
+        result: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                agent: "agent";
+                cancelled: "cancelled";
+                failed: "failed";
+                blocked: "blocked";
+                skipped: "skipped";
+                retry: "retry";
+            }>;
+            decision: z.ZodOptional<z.ZodEnum<{
+                continue: "continue";
+                pause: "pause";
+                complete: "complete";
+                escalate: "escalate";
+            }>>;
+            summary: z.ZodString;
+            outcome: z.ZodString;
+            agentRunId: z.ZodOptional<z.ZodString>;
+            usage: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$loose>>;
+        error: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$loose>;
 }, z.core.$loose>;
 export declare const HostedHeartbeatCoordinatorTaskListSchema: z.ZodObject<{
     tasks: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
+        taskId: z.ZodString;
+        workspaceId: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        task: z.ZodString;
+        enabled: z.ZodBoolean;
+        continuationMode: z.ZodOptional<z.ZodEnum<{
+            operator: "operator";
+            agent: "agent";
+        }>>;
+        schedule: z.ZodObject<{
+            intervalMs: z.ZodNumber;
+            nextRunAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$loose>;
+        state: z.ZodObject<{
+            status: z.ZodEnum<{
+                running: "running";
+                failed: "failed";
+                idle: "idle";
+                waiting: "waiting";
+                blocked: "blocked";
+                complete: "complete";
+            }>;
+            progress: z.ZodOptional<z.ZodString>;
+            runId: z.ZodOptional<z.ZodString>;
+            runAt: z.ZodOptional<z.ZodISODateTime>;
+            loadedCheckpoint: z.ZodOptional<z.ZodBoolean>;
+            resumable: z.ZodOptional<z.ZodBoolean>;
+            result: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    agent: "agent";
+                    cancelled: "cancelled";
+                    failed: "failed";
+                    blocked: "blocked";
+                    skipped: "skipped";
+                    retry: "retry";
+                }>;
+                decision: z.ZodOptional<z.ZodEnum<{
+                    continue: "continue";
+                    pause: "pause";
+                    complete: "complete";
+                    escalate: "escalate";
+                }>>;
+                summary: z.ZodString;
+                outcome: z.ZodString;
+                agentRunId: z.ZodOptional<z.ZodString>;
+                usage: z.ZodOptional<z.ZodUnknown>;
+            }, z.core.$loose>>;
+            error: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$loose>;
+    }, z.core.$loose>>;
+}, z.core.$strict>;
+export declare const HostedHeartbeatCoordinatorRunViewSchema: z.ZodObject<{
+    id: z.ZodString;
+    taskId: z.ZodString;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    executionId: z.ZodString;
+    runId: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    task: z.ZodObject<{
+        id: z.ZodString;
+        taskId: z.ZodString;
         workspaceId: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        task: z.ZodString;
+        enabled: z.ZodBoolean;
+        continuationMode: z.ZodOptional<z.ZodEnum<{
+            operator: "operator";
+            agent: "agent";
+        }>>;
+        schedule: z.ZodObject<{
+            intervalMs: z.ZodNumber;
+            nextRunAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$loose>;
+        state: z.ZodObject<{
+            status: z.ZodEnum<{
+                running: "running";
+                failed: "failed";
+                idle: "idle";
+                waiting: "waiting";
+                blocked: "blocked";
+                complete: "complete";
+            }>;
+            progress: z.ZodOptional<z.ZodString>;
+            runId: z.ZodOptional<z.ZodString>;
+            runAt: z.ZodOptional<z.ZodISODateTime>;
+            loadedCheckpoint: z.ZodOptional<z.ZodBoolean>;
+            resumable: z.ZodOptional<z.ZodBoolean>;
+            result: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    agent: "agent";
+                    cancelled: "cancelled";
+                    failed: "failed";
+                    blocked: "blocked";
+                    skipped: "skipped";
+                    retry: "retry";
+                }>;
+                decision: z.ZodOptional<z.ZodEnum<{
+                    continue: "continue";
+                    pause: "pause";
+                    complete: "complete";
+                    escalate: "escalate";
+                }>>;
+                summary: z.ZodString;
+                outcome: z.ZodString;
+                agentRunId: z.ZodOptional<z.ZodString>;
+                usage: z.ZodOptional<z.ZodUnknown>;
+            }, z.core.$loose>>;
+            error: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+    result: z.ZodObject<{
+        kind: z.ZodEnum<{
+            agent: "agent";
+            cancelled: "cancelled";
+            failed: "failed";
+            blocked: "blocked";
+            skipped: "skipped";
+            retry: "retry";
+        }>;
+        decision: z.ZodOptional<z.ZodEnum<{
+            continue: "continue";
+            pause: "pause";
+            complete: "complete";
+            escalate: "escalate";
+        }>>;
+        summary: z.ZodString;
+        outcome: z.ZodString;
+        agentRunId: z.ZodOptional<z.ZodString>;
+        usage: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>;
+    loadedCheckpoint: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export declare const HostedHeartbeatCoordinatorTaskDetailSchema: z.ZodObject<{
+    task: z.ZodObject<{
+        id: z.ZodString;
+        taskId: z.ZodString;
+        workspaceId: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        task: z.ZodString;
+        enabled: z.ZodBoolean;
+        continuationMode: z.ZodOptional<z.ZodEnum<{
+            operator: "operator";
+            agent: "agent";
+        }>>;
+        schedule: z.ZodObject<{
+            intervalMs: z.ZodNumber;
+            nextRunAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$loose>;
+        state: z.ZodObject<{
+            status: z.ZodEnum<{
+                running: "running";
+                failed: "failed";
+                idle: "idle";
+                waiting: "waiting";
+                blocked: "blocked";
+                complete: "complete";
+            }>;
+            progress: z.ZodOptional<z.ZodString>;
+            runId: z.ZodOptional<z.ZodString>;
+            runAt: z.ZodOptional<z.ZodISODateTime>;
+            loadedCheckpoint: z.ZodOptional<z.ZodBoolean>;
+            resumable: z.ZodOptional<z.ZodBoolean>;
+            result: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    agent: "agent";
+                    cancelled: "cancelled";
+                    failed: "failed";
+                    blocked: "blocked";
+                    skipped: "skipped";
+                    retry: "retry";
+                }>;
+                decision: z.ZodOptional<z.ZodEnum<{
+                    continue: "continue";
+                    pause: "pause";
+                    complete: "complete";
+                    escalate: "escalate";
+                }>>;
+                summary: z.ZodString;
+                outcome: z.ZodString;
+                agentRunId: z.ZodOptional<z.ZodString>;
+                usage: z.ZodOptional<z.ZodUnknown>;
+            }, z.core.$loose>>;
+            error: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+    runs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        taskId: z.ZodString;
+        workspaceId: z.ZodOptional<z.ZodString>;
+        executionId: z.ZodString;
+        runId: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodISODateTime;
+        task: z.ZodObject<{
+            id: z.ZodString;
+            taskId: z.ZodString;
+            workspaceId: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            task: z.ZodString;
+            enabled: z.ZodBoolean;
+            continuationMode: z.ZodOptional<z.ZodEnum<{
+                operator: "operator";
+                agent: "agent";
+            }>>;
+            schedule: z.ZodObject<{
+                intervalMs: z.ZodNumber;
+                nextRunAt: z.ZodOptional<z.ZodISODateTime>;
+            }, z.core.$loose>;
+            state: z.ZodObject<{
+                status: z.ZodEnum<{
+                    running: "running";
+                    failed: "failed";
+                    idle: "idle";
+                    waiting: "waiting";
+                    blocked: "blocked";
+                    complete: "complete";
+                }>;
+                progress: z.ZodOptional<z.ZodString>;
+                runId: z.ZodOptional<z.ZodString>;
+                runAt: z.ZodOptional<z.ZodISODateTime>;
+                loadedCheckpoint: z.ZodOptional<z.ZodBoolean>;
+                resumable: z.ZodOptional<z.ZodBoolean>;
+                result: z.ZodOptional<z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        agent: "agent";
+                        cancelled: "cancelled";
+                        failed: "failed";
+                        blocked: "blocked";
+                        skipped: "skipped";
+                        retry: "retry";
+                    }>;
+                    decision: z.ZodOptional<z.ZodEnum<{
+                        continue: "continue";
+                        pause: "pause";
+                        complete: "complete";
+                        escalate: "escalate";
+                    }>>;
+                    summary: z.ZodString;
+                    outcome: z.ZodString;
+                    agentRunId: z.ZodOptional<z.ZodString>;
+                    usage: z.ZodOptional<z.ZodUnknown>;
+                }, z.core.$loose>>;
+                error: z.ZodOptional<z.ZodString>;
+                updatedAt: z.ZodOptional<z.ZodISODateTime>;
+            }, z.core.$loose>;
+        }, z.core.$loose>;
+        result: z.ZodObject<{
+            kind: z.ZodEnum<{
+                agent: "agent";
+                cancelled: "cancelled";
+                failed: "failed";
+                blocked: "blocked";
+                skipped: "skipped";
+                retry: "retry";
+            }>;
+            decision: z.ZodOptional<z.ZodEnum<{
+                continue: "continue";
+                pause: "pause";
+                complete: "complete";
+                escalate: "escalate";
+            }>>;
+            summary: z.ZodString;
+            outcome: z.ZodString;
+            agentRunId: z.ZodOptional<z.ZodString>;
+            usage: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$loose>;
+        loadedCheckpoint: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>>;
 }, z.core.$strict>;
 export declare const HostedHeartbeatDesiredTaskSchema: z.ZodObject<{
@@ -121,7 +483,10 @@ export declare const HostedHeartbeatDelegationAuthorizationSchema: z.ZodObject<{
     allowedTools: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 export type HostedHeartbeatCoordinatorTaskInput = z.infer<typeof HostedHeartbeatCoordinatorTaskInputSchema>;
-export type HostedHeartbeatCoordinatorTaskSummary = z.infer<typeof HostedHeartbeatCoordinatorTaskSummarySchema>;
+export type HostedHeartbeatCoordinatorState = z.infer<typeof HostedHeartbeatCoordinatorStateSchema>;
+export type HostedHeartbeatCoordinatorTaskView = z.infer<typeof HostedHeartbeatCoordinatorTaskViewSchema>;
+export type HostedHeartbeatCoordinatorRunView = z.infer<typeof HostedHeartbeatCoordinatorRunViewSchema>;
+export type HostedHeartbeatCoordinatorTaskDetail = z.infer<typeof HostedHeartbeatCoordinatorTaskDetailSchema>;
 export type HostedHeartbeatDesiredTask = z.infer<typeof HostedHeartbeatDesiredTaskSchema>;
 export type HostedHeartbeatDesiredTaskCatalog = z.infer<typeof HostedHeartbeatDesiredTaskCatalogSchema>;
 export type HostedHeartbeatDelegationRequest = z.infer<typeof HostedHeartbeatDelegationRequestSchema>;

package/dist/coordinator/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/coordinator/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,kCAAkC;;;;EAI7C,CAAC;AAEH,eAAO,MAAM,iCAAiC,qDACM,CAAC;AAErD,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;kBAc3C,CAAC;AAEZ,eAAO,MAAM,2CAA2C;;;iBAGxC,CAAC;AAEjB,eAAO,MAAM,wCAAwC;;;;;kBAE1C,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;kBAGlC,CAAC;AAEZ,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;kBAelD,CAAC;AAEH,eAAO,MAAM,sCAAsC;;;;kBAIxC,CAAC;AAiBZ,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA6B1C,CAAC;AAEH,eAAO,MAAM,4CAA4C;;;;;;;kBAG9C,CAAC;AAEZ,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,yCAAyC,CACjD,CAAC;AACF,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CACzD,OAAO,2CAA2C,CACnD,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,uCAAuC,CAC/C,CAAC;AACF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,sCAAsC,CAC9C,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC;AACF,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAC1D,OAAO,4CAA4C,CACpD,CAAC"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/coordinator/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,kCAAkC;;;;;;EAM7C,CAAC;AAEH,eAAO,MAAM,iCAAiC,qDACM,CAAC;AAErD,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;kBAc3C,CAAC;AAEZ,eAAO,MAAM,qCAAqC;;;;;EAKhD,CAAC;AAEH,eAAO,MAAM,6CAA6C;;;;;;;kBAE/C,CAAC;AAEZ,eAAO,MAAM,0CAA0C;;;;;;;EAOrD,CAAC;AAEH,eAAO,MAAM,0CAA0C;;;;;;;;;;;;;;;;;;;iBAcvC,CAAC;AAEjB,0EAA0E;AAC1E,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBrC,CAAC;AAEjB,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE1C,CAAC;AAEZ,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUpC,CAAC;AAEjB,eAAO,MAAM,0CAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAG5C,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;kBAGlC,CAAC;AAEZ,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;kBAelD,CAAC;AAEH,eAAO,MAAM,sCAAsC;;;;kBAIxC,CAAC;AAiBZ,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA6B1C,CAAC;AAEH,eAAO,MAAM,4CAA4C;;;;;;;kBAG9C,CAAC;AAEZ,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,yCAAyC,CACjD,CAAC;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,qCAAqC,CAC7C,CAAC;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,wCAAwC,CAChD,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,uCAAuC,CAC/C,CAAC;AACF,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CACxD,OAAO,0CAA0C,CAClD,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,uCAAuC,CAC/C,CAAC;AACF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,sCAAsC,CAC9C,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC;AACF,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAC1D,OAAO,4CAA4C,CACpD,CAAC"}

package/dist/coordinator/contracts.js

@@ -4,9 +4,11 @@ const ProductExecutionScopeSchema = ExecutionScopeSchema.omit({
     adopterId: true,
 });
 export const HOSTED_HEARTBEAT_COORDINATOR_PATHS = Object.freeze({
+    state: '/v1/coordinator',
     tasks: '/v1/heartbeat/tasks',
     pause: '/v1/control/pause',
     resume: '/v1/control/resume',
+    drain: '/v1/control/drain',
 });
 export const HOSTED_HEARTBEAT_DELEGATIONS_PATH = '/hosted-execution/internal/heartbeat-delegations';
 export const HostedHeartbeatCoordinatorTaskInputSchema = z.object({
@@ -24,12 +26,80 @@ export const HostedHeartbeatCoordinatorTaskInputSchema = z.object({
         .optional(),
     systemContext: z.string().max(200_000).optional(),
 }).strict();
-export const HostedHeartbeatCoordinatorTaskSummarySchema = z.object({
+export const HostedHeartbeatCoordinatorStateSchema = z.enum([
+    'running',
+    'paused',
+    'drained',
+    'stopped',
+]);
+export const HostedHeartbeatCoordinatorStateResponseSchema = z.object({
+    state: HostedHeartbeatCoordinatorStateSchema,
+}).strict();
+export const HostedHeartbeatCoordinatorTaskStatusSchema = z.enum([
+    'idle',
+    'running',
+    'waiting',
+    'blocked',
+    'complete',
+    'failed',
+]);
+export const HostedHeartbeatCoordinatorTaskResultSchema = z.object({
+    kind: z.enum([
+        'agent',
+        'skipped',
+        'cancelled',
+        'retry',
+        'blocked',
+        'failed',
+    ]),
+    decision: z.enum(['continue', 'pause', 'complete', 'escalate']).optional(),
+    summary: z.string(),
+    outcome: z.string(),
+    agentRunId: OpaqueIdSchema.optional(),
+    usage: z.unknown().optional(),
+}).passthrough();
+/** Stable product/operator projection returned by the Coordinator API. */
+export const HostedHeartbeatCoordinatorTaskViewSchema = z.object({
     id: OpaqueIdSchema,
+    taskId: OpaqueIdSchema,
     workspaceId: OpaqueIdSchema.optional(),
+    name: z.string().optional(),
+    task: z.string(),
+    enabled: z.boolean(),
+    continuationMode: z.enum(['operator', 'agent']).optional(),
+    schedule: z.object({
+        intervalMs: z.number().int().positive(),
+        nextRunAt: TimestampSchema.optional(),
+    }).passthrough(),
+    state: z.object({
+        status: HostedHeartbeatCoordinatorTaskStatusSchema,
+        progress: z.string().optional(),
+        runId: OpaqueIdSchema.optional(),
+        runAt: TimestampSchema.optional(),
+        loadedCheckpoint: z.boolean().optional(),
+        resumable: z.boolean().optional(),
+        result: HostedHeartbeatCoordinatorTaskResultSchema.optional(),
+        error: z.string().optional(),
+        updatedAt: TimestampSchema.optional(),
+    }).passthrough(),
 }).passthrough();
 export const HostedHeartbeatCoordinatorTaskListSchema = z.object({
-    tasks: z.array(HostedHeartbeatCoordinatorTaskSummarySchema),
+    tasks: z.array(HostedHeartbeatCoordinatorTaskViewSchema),
+}).strict();
+export const HostedHeartbeatCoordinatorRunViewSchema = z.object({
+    id: OpaqueIdSchema,
+    taskId: OpaqueIdSchema,
+    workspaceId: OpaqueIdSchema.optional(),
+    executionId: OpaqueIdSchema,
+    runId: OpaqueIdSchema.optional(),
+    createdAt: TimestampSchema,
+    task: HostedHeartbeatCoordinatorTaskViewSchema,
+    result: HostedHeartbeatCoordinatorTaskResultSchema,
+    loadedCheckpoint: z.boolean().optional(),
+}).passthrough();
+export const HostedHeartbeatCoordinatorTaskDetailSchema = z.object({
+    task: HostedHeartbeatCoordinatorTaskViewSchema,
+    runs: z.array(HostedHeartbeatCoordinatorRunViewSchema),
 }).strict();
 export const HostedHeartbeatDesiredTaskSchema = z.object({
     taskId: OpaqueIdSchema,

package/dist/coordinator/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/coordinator/contracts.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport {\n  ExecutionScopeSchema,\n  HEARTBEAT_TASK_WORKFLOW,\n  McpAllowedToolsSchema,\n  McpServerIdSchema,\n  OpaqueIdSchema,\n  RuntimeSessionIdSchema,\n  TimestampSchema,\n} from '../contracts/index.js';\n\nconst ProductExecutionScopeSchema = ExecutionScopeSchema.omit({\n  adopterId: true,\n});\n\nexport const HOSTED_HEARTBEAT_COORDINATOR_PATHS = Object.freeze({\n  tasks: '/v1/heartbeat/tasks',\n  pause: '/v1/control/pause',\n  resume: '/v1/control/resume',\n});\n\nexport const HOSTED_HEARTBEAT_DELEGATIONS_PATH =\n  '/hosted-execution/internal/heartbeat-delegations';\n\nexport const HostedHeartbeatCoordinatorTaskInputSchema = z.object({\n  workspaceId: OpaqueIdSchema.optional(),\n  name: z.string().trim().min(1).max(200).optional(),\n  task: z.string().trim().min(1).max(200_000),\n  enabled: z.boolean().optional(),\n  continuationMode: z.enum(['operator', 'agent']).optional(),\n  intervalMs: z.number().int().min(1_000).max(Number.MAX_SAFE_INTEGER)\n    .optional(),\n  defer: z.boolean().optional(),\n  model: z.string().trim().min(1).max(512).optional(),\n  maxSteps: z.number().int().positive().max(10_000).optional(),\n  searchIgnoreDirs: z.array(z.string().min(1).max(1_024)).max(1_000)\n    .optional(),\n  systemContext: z.string().max(200_000).optional(),\n}).strict();\n\nexport const HostedHeartbeatCoordinatorTaskSummarySchema = z.object({\n  id: OpaqueIdSchema,\n  workspaceId: OpaqueIdSchema.optional(),\n}).passthrough();\n\nexport const HostedHeartbeatCoordinatorTaskListSchema = z.object({\n  tasks: z.array(HostedHeartbeatCoordinatorTaskSummarySchema),\n}).strict();\n\nexport const HostedHeartbeatDesiredTaskSchema = z.object({\n  taskId: OpaqueIdSchema,\n  input: HostedHeartbeatCoordinatorTaskInputSchema,\n}).strict();\n\nexport const HostedHeartbeatDesiredTaskCatalogSchema = z.object({\n  tasks: z.array(HostedHeartbeatDesiredTaskSchema).max(10_000),\n  resume: z.boolean(),\n}).strict().superRefine(({ tasks }, context) => {\n  const seen = new Set<string>();\n  tasks.forEach(({ taskId }, index) => {\n    if (seen.has(taskId)) {\n      context.addIssue({\n        code: 'custom',\n        path: ['tasks', index, 'taskId'],\n        message: 'must be unique within the desired task catalog',\n      });\n    }\n    seen.add(taskId);\n  });\n});\n\nexport const HostedHeartbeatDelegationRequestSchema = z.object({\n  schemaVersion: z.literal(1),\n  taskId: OpaqueIdSchema,\n  executionId: OpaqueIdSchema,\n}).strict();\n\nconst DelegatedAuthorityMetadataSchema = z.object({\n  scope: ExecutionScopeSchema,\n  runtimeSessionId: RuntimeSessionIdSchema,\n  invocationId: OpaqueIdSchema,\n  workflow: z.literal(HEARTBEAT_TASK_WORKFLOW),\n  issuedAt: TimestampSchema,\n  executionExpiresAt: TimestampSchema,\n  mcp: z.object({\n    capabilityId: OpaqueIdSchema,\n    serverId: McpServerIdSchema,\n    allowedTools: McpAllowedToolsSchema,\n    expiresAt: TimestampSchema,\n  }).strict(),\n}).strict();\n\nexport const HostedHeartbeatDelegationSchema = z.object({\n  schemaVersion: z.literal(1),\n  taskId: OpaqueIdSchema,\n  executionId: OpaqueIdSchema,\n  scope: ProductExecutionScopeSchema,\n  runtimeSessionId: RuntimeSessionIdSchema,\n  deadlineAt: TimestampSchema,\n  authority: z.object({\n    metadata: DelegatedAuthorityMetadataSchema,\n    executionAssertion: z.string().min(1).max(16_384),\n    mcpCapability: z.string().min(1).max(16_384),\n  }).strict(),\n}).strict().superRefine((delegation, context) => {\n  const metadata = delegation.authority.metadata;\n  const mismatches: Array<[path: string, mismatched: boolean]> = [\n    ['executionId', metadata.invocationId !== delegation.executionId],\n    [\n      'runtimeSessionId',\n      metadata.runtimeSessionId !== delegation.runtimeSessionId,\n    ],\n    ['scope', !sameProductScope(metadata.scope, delegation.scope)],\n  ];\n  mismatches\n    .filter(([, mismatched]) => mismatched)\n    .forEach(([path]) => context.addIssue({\n      code: 'custom',\n      path: [path],\n      message: 'must match the delegated execution authority metadata',\n    }));\n});\n\nexport const HostedHeartbeatDelegationAuthorizationSchema = z.object({\n  scope: ProductExecutionScopeSchema,\n  allowedTools: McpAllowedToolsSchema,\n}).strict();\n\nexport type HostedHeartbeatCoordinatorTaskInput = z.infer<\n  typeof HostedHeartbeatCoordinatorTaskInputSchema\n>;\nexport type HostedHeartbeatCoordinatorTaskSummary = z.infer<\n  typeof HostedHeartbeatCoordinatorTaskSummarySchema\n>;\nexport type HostedHeartbeatDesiredTask = z.infer<\n  typeof HostedHeartbeatDesiredTaskSchema\n>;\nexport type HostedHeartbeatDesiredTaskCatalog = z.infer<\n  typeof HostedHeartbeatDesiredTaskCatalogSchema\n>;\nexport type HostedHeartbeatDelegationRequest = z.infer<\n  typeof HostedHeartbeatDelegationRequestSchema\n>;\nexport type HostedHeartbeatDelegation = z.infer<\n  typeof HostedHeartbeatDelegationSchema\n>;\nexport type HostedHeartbeatDelegationAuthorization = z.infer<\n  typeof HostedHeartbeatDelegationAuthorizationSchema\n>;\n\nfunction sameProductScope(\n  left: z.infer<typeof ExecutionScopeSchema>,\n  right: z.infer<typeof ProductExecutionScopeSchema>,\n): boolean {\n  return left.tenantId === right.tenantId\n    && left.subjectId === right.subjectId\n    && left.productSessionId === right.productSessionId;\n}\n"]}
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/coordinator/contracts.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport {\n  ExecutionScopeSchema,\n  HEARTBEAT_TASK_WORKFLOW,\n  McpAllowedToolsSchema,\n  McpServerIdSchema,\n  OpaqueIdSchema,\n  RuntimeSessionIdSchema,\n  TimestampSchema,\n} from '../contracts/index.js';\n\nconst ProductExecutionScopeSchema = ExecutionScopeSchema.omit({\n  adopterId: true,\n});\n\nexport const HOSTED_HEARTBEAT_COORDINATOR_PATHS = Object.freeze({\n  state: '/v1/coordinator',\n  tasks: '/v1/heartbeat/tasks',\n  pause: '/v1/control/pause',\n  resume: '/v1/control/resume',\n  drain: '/v1/control/drain',\n});\n\nexport const HOSTED_HEARTBEAT_DELEGATIONS_PATH =\n  '/hosted-execution/internal/heartbeat-delegations';\n\nexport const HostedHeartbeatCoordinatorTaskInputSchema = z.object({\n  workspaceId: OpaqueIdSchema.optional(),\n  name: z.string().trim().min(1).max(200).optional(),\n  task: z.string().trim().min(1).max(200_000),\n  enabled: z.boolean().optional(),\n  continuationMode: z.enum(['operator', 'agent']).optional(),\n  intervalMs: z.number().int().min(1_000).max(Number.MAX_SAFE_INTEGER)\n    .optional(),\n  defer: z.boolean().optional(),\n  model: z.string().trim().min(1).max(512).optional(),\n  maxSteps: z.number().int().positive().max(10_000).optional(),\n  searchIgnoreDirs: z.array(z.string().min(1).max(1_024)).max(1_000)\n    .optional(),\n  systemContext: z.string().max(200_000).optional(),\n}).strict();\n\nexport const HostedHeartbeatCoordinatorStateSchema = z.enum([\n  'running',\n  'paused',\n  'drained',\n  'stopped',\n]);\n\nexport const HostedHeartbeatCoordinatorStateResponseSchema = z.object({\n  state: HostedHeartbeatCoordinatorStateSchema,\n}).strict();\n\nexport const HostedHeartbeatCoordinatorTaskStatusSchema = z.enum([\n  'idle',\n  'running',\n  'waiting',\n  'blocked',\n  'complete',\n  'failed',\n]);\n\nexport const HostedHeartbeatCoordinatorTaskResultSchema = z.object({\n  kind: z.enum([\n    'agent',\n    'skipped',\n    'cancelled',\n    'retry',\n    'blocked',\n    'failed',\n  ]),\n  decision: z.enum(['continue', 'pause', 'complete', 'escalate']).optional(),\n  summary: z.string(),\n  outcome: z.string(),\n  agentRunId: OpaqueIdSchema.optional(),\n  usage: z.unknown().optional(),\n}).passthrough();\n\n/** Stable product/operator projection returned by the Coordinator API. */\nexport const HostedHeartbeatCoordinatorTaskViewSchema = z.object({\n  id: OpaqueIdSchema,\n  taskId: OpaqueIdSchema,\n  workspaceId: OpaqueIdSchema.optional(),\n  name: z.string().optional(),\n  task: z.string(),\n  enabled: z.boolean(),\n  continuationMode: z.enum(['operator', 'agent']).optional(),\n  schedule: z.object({\n    intervalMs: z.number().int().positive(),\n    nextRunAt: TimestampSchema.optional(),\n  }).passthrough(),\n  state: z.object({\n    status: HostedHeartbeatCoordinatorTaskStatusSchema,\n    progress: z.string().optional(),\n    runId: OpaqueIdSchema.optional(),\n    runAt: TimestampSchema.optional(),\n    loadedCheckpoint: z.boolean().optional(),\n    resumable: z.boolean().optional(),\n    result: HostedHeartbeatCoordinatorTaskResultSchema.optional(),\n    error: z.string().optional(),\n    updatedAt: TimestampSchema.optional(),\n  }).passthrough(),\n}).passthrough();\n\nexport const HostedHeartbeatCoordinatorTaskListSchema = z.object({\n  tasks: z.array(HostedHeartbeatCoordinatorTaskViewSchema),\n}).strict();\n\nexport const HostedHeartbeatCoordinatorRunViewSchema = z.object({\n  id: OpaqueIdSchema,\n  taskId: OpaqueIdSchema,\n  workspaceId: OpaqueIdSchema.optional(),\n  executionId: OpaqueIdSchema,\n  runId: OpaqueIdSchema.optional(),\n  createdAt: TimestampSchema,\n  task: HostedHeartbeatCoordinatorTaskViewSchema,\n  result: HostedHeartbeatCoordinatorTaskResultSchema,\n  loadedCheckpoint: z.boolean().optional(),\n}).passthrough();\n\nexport const HostedHeartbeatCoordinatorTaskDetailSchema = z.object({\n  task: HostedHeartbeatCoordinatorTaskViewSchema,\n  runs: z.array(HostedHeartbeatCoordinatorRunViewSchema),\n}).strict();\n\nexport const HostedHeartbeatDesiredTaskSchema = z.object({\n  taskId: OpaqueIdSchema,\n  input: HostedHeartbeatCoordinatorTaskInputSchema,\n}).strict();\n\nexport const HostedHeartbeatDesiredTaskCatalogSchema = z.object({\n  tasks: z.array(HostedHeartbeatDesiredTaskSchema).max(10_000),\n  resume: z.boolean(),\n}).strict().superRefine(({ tasks }, context) => {\n  const seen = new Set<string>();\n  tasks.forEach(({ taskId }, index) => {\n    if (seen.has(taskId)) {\n      context.addIssue({\n        code: 'custom',\n        path: ['tasks', index, 'taskId'],\n        message: 'must be unique within the desired task catalog',\n      });\n    }\n    seen.add(taskId);\n  });\n});\n\nexport const HostedHeartbeatDelegationRequestSchema = z.object({\n  schemaVersion: z.literal(1),\n  taskId: OpaqueIdSchema,\n  executionId: OpaqueIdSchema,\n}).strict();\n\nconst DelegatedAuthorityMetadataSchema = z.object({\n  scope: ExecutionScopeSchema,\n  runtimeSessionId: RuntimeSessionIdSchema,\n  invocationId: OpaqueIdSchema,\n  workflow: z.literal(HEARTBEAT_TASK_WORKFLOW),\n  issuedAt: TimestampSchema,\n  executionExpiresAt: TimestampSchema,\n  mcp: z.object({\n    capabilityId: OpaqueIdSchema,\n    serverId: McpServerIdSchema,\n    allowedTools: McpAllowedToolsSchema,\n    expiresAt: TimestampSchema,\n  }).strict(),\n}).strict();\n\nexport const HostedHeartbeatDelegationSchema = z.object({\n  schemaVersion: z.literal(1),\n  taskId: OpaqueIdSchema,\n  executionId: OpaqueIdSchema,\n  scope: ProductExecutionScopeSchema,\n  runtimeSessionId: RuntimeSessionIdSchema,\n  deadlineAt: TimestampSchema,\n  authority: z.object({\n    metadata: DelegatedAuthorityMetadataSchema,\n    executionAssertion: z.string().min(1).max(16_384),\n    mcpCapability: z.string().min(1).max(16_384),\n  }).strict(),\n}).strict().superRefine((delegation, context) => {\n  const metadata = delegation.authority.metadata;\n  const mismatches: Array<[path: string, mismatched: boolean]> = [\n    ['executionId', metadata.invocationId !== delegation.executionId],\n    [\n      'runtimeSessionId',\n      metadata.runtimeSessionId !== delegation.runtimeSessionId,\n    ],\n    ['scope', !sameProductScope(metadata.scope, delegation.scope)],\n  ];\n  mismatches\n    .filter(([, mismatched]) => mismatched)\n    .forEach(([path]) => context.addIssue({\n      code: 'custom',\n      path: [path],\n      message: 'must match the delegated execution authority metadata',\n    }));\n});\n\nexport const HostedHeartbeatDelegationAuthorizationSchema = z.object({\n  scope: ProductExecutionScopeSchema,\n  allowedTools: McpAllowedToolsSchema,\n}).strict();\n\nexport type HostedHeartbeatCoordinatorTaskInput = z.infer<\n  typeof HostedHeartbeatCoordinatorTaskInputSchema\n>;\nexport type HostedHeartbeatCoordinatorState = z.infer<\n  typeof HostedHeartbeatCoordinatorStateSchema\n>;\nexport type HostedHeartbeatCoordinatorTaskView = z.infer<\n  typeof HostedHeartbeatCoordinatorTaskViewSchema\n>;\nexport type HostedHeartbeatCoordinatorRunView = z.infer<\n  typeof HostedHeartbeatCoordinatorRunViewSchema\n>;\nexport type HostedHeartbeatCoordinatorTaskDetail = z.infer<\n  typeof HostedHeartbeatCoordinatorTaskDetailSchema\n>;\nexport type HostedHeartbeatDesiredTask = z.infer<\n  typeof HostedHeartbeatDesiredTaskSchema\n>;\nexport type HostedHeartbeatDesiredTaskCatalog = z.infer<\n  typeof HostedHeartbeatDesiredTaskCatalogSchema\n>;\nexport type HostedHeartbeatDelegationRequest = z.infer<\n  typeof HostedHeartbeatDelegationRequestSchema\n>;\nexport type HostedHeartbeatDelegation = z.infer<\n  typeof HostedHeartbeatDelegationSchema\n>;\nexport type HostedHeartbeatDelegationAuthorization = z.infer<\n  typeof HostedHeartbeatDelegationAuthorizationSchema\n>;\n\nfunction sameProductScope(\n  left: z.infer<typeof ExecutionScopeSchema>,\n  right: z.infer<typeof ProductExecutionScopeSchema>,\n): boolean {\n  return left.tenantId === right.tenantId\n    && left.subjectId === right.subjectId\n    && left.productSessionId === right.productSessionId;\n}\n"]}

package/dist/coordinator/hosted-heartbeat-coordinator-client.d.ts

@@ -1,4 +1,4 @@
-import { type HostedHeartbeatCoordinatorTaskInput, type HostedHeartbeatCoordinatorTaskSummary } from './contracts.js';
+import { type HostedHeartbeatCoordinatorTaskInput, type HostedHeartbeatCoordinatorState, type HostedHeartbeatCoordinatorTaskDetail, type HostedHeartbeatCoordinatorTaskView } from './contracts.js';
 import type { HostedHeartbeatCoordinatorClientConfig, HostedHeartbeatCoordinatorTaskApi } from './types.js';
 export declare class HostedHeartbeatCoordinatorRequestError extends Error {
     readonly method: string;
@@ -11,10 +11,14 @@ export declare class HostedHeartbeatCoordinatorRequestError extends Error {
 export declare class HostedHeartbeatCoordinatorClient implements HostedHeartbeatCoordinatorTaskApi {
     #private;
     constructor(config: HostedHeartbeatCoordinatorClientConfig);
-    listTasks(signal?: AbortSignal): Promise<HostedHeartbeatCoordinatorTaskSummary[]>;
+    readState(signal?: AbortSignal): Promise<HostedHeartbeatCoordinatorState>;
+    listTasks(signal?: AbortSignal): Promise<HostedHeartbeatCoordinatorTaskView[]>;
+    readTask(rawTaskId: string, signal?: AbortSignal): Promise<HostedHeartbeatCoordinatorTaskDetail>;
     upsertTask(rawTaskId: string, rawTask: HostedHeartbeatCoordinatorTaskInput, signal?: AbortSignal): Promise<void>;
     deleteTask(rawTaskId: string, signal?: AbortSignal): Promise<void>;
+    triggerTask(rawTaskId: string, signal?: AbortSignal): Promise<HostedHeartbeatCoordinatorTaskView>;
     pause(signal?: AbortSignal): Promise<void>;
     resume(signal?: AbortSignal): Promise<void>;
+    drain(signal?: AbortSignal): Promise<void>;
 }
 //# sourceMappingURL=hosted-heartbeat-coordinator-client.d.ts.map

package/dist/coordinator/hosted-heartbeat-coordinator-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-heartbeat-coordinator-client.d.ts","sourceRoot":"","sources":["../../src/coordinator/hosted-heartbeat-coordinator-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,mCAAmC,EACxC,KAAK,qCAAqC,EAC3C,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EACV,sCAAsC,EACtC,iCAAiC,EAClC,MAAM,YAAY,CAAC;AAOpB,qBAAa,sCAAuC,SAAQ,KAAK;IAI7D,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;IALzB,QAAQ,CAAC,IAAI,4CAA4C;gBAG9C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAI1B;AAED,gFAAgF;AAChF,qBAAa,gCACb,YAAW,iCAAiC;;gBAK9B,MAAM,EAAE,sCAAsC;IAQpD,SAAS,CACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,qCAAqC,EAAE,CAAC;IAU7C,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mCAAmC,EAC5C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAWV,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CA8BlD"}
+{"version":3,"file":"hosted-heartbeat-coordinator-client.d.ts","sourceRoot":"","sources":["../../src/coordinator/hosted-heartbeat-coordinator-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAOL,KAAK,mCAAmC,EACxC,KAAK,+BAA+B,EACpC,KAAK,oCAAoC,EACzC,KAAK,kCAAkC,EACxC,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EACV,sCAAsC,EACtC,iCAAiC,EAClC,MAAM,YAAY,CAAC;AAOpB,qBAAa,sCAAuC,SAAQ,KAAK;IAI7D,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;IALzB,QAAQ,CAAC,IAAI,4CAA4C;gBAG9C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAI1B;AAED,gFAAgF;AAChF,qBAAa,gCACb,YAAW,iCAAiC;;gBAK9B,MAAM,EAAE,sCAAsC;IAQpD,SAAS,CACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,+BAA+B,CAAC;IAUrC,SAAS,CACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kCAAkC,EAAE,CAAC;IAU1C,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,oCAAoC,CAAC;IAU1C,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mCAAmC,EAC5C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAWV,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kCAAkC,CAAC;IASxC,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3C,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CA8BjD"}

package/dist/coordinator/hosted-heartbeat-coordinator-client.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { OpaqueIdSchema, isSafeWebUrl, } from '../contracts/index.js';
-import { HOSTED_HEARTBEAT_COORDINATOR_PATHS, HostedHeartbeatCoordinatorTaskInputSchema, HostedHeartbeatCoordinatorTaskListSchema, } from './contracts.js';
+import { HOSTED_HEARTBEAT_COORDINATOR_PATHS, HostedHeartbeatCoordinatorStateResponseSchema, HostedHeartbeatCoordinatorTaskDetailSchema, HostedHeartbeatCoordinatorTaskInputSchema, HostedHeartbeatCoordinatorTaskListSchema, HostedHeartbeatCoordinatorTaskViewSchema, } from './contracts.js';
 import { HostedHeartbeatServiceTokenSchema } from './service-token.js';
 const SafeBaseUrlSchema = z.custom((value) => value instanceof URL && isSafeWebUrl(value), 'baseUrl must be a safe HTTPS or loopback HTTP URL');
 export class HostedHeartbeatCoordinatorRequestError extends Error {
@@ -25,10 +25,18 @@ export class HostedHeartbeatCoordinatorClient {
         this.#authorization = `Bearer ${HostedHeartbeatServiceTokenSchema.parse(config.apiToken)}`;
         this.#fetch = config.fetch ?? globalThis.fetch;
     }
+    async readState(signal) {
+        const response = await this.#request(HOSTED_HEARTBEAT_COORDINATOR_PATHS.state, { method: 'GET', signal });
+        return HostedHeartbeatCoordinatorStateResponseSchema.parse(await response.json()).state;
+    }
     async listTasks(signal) {
         const response = await this.#request(HOSTED_HEARTBEAT_COORDINATOR_PATHS.tasks, { method: 'GET', signal });
         return HostedHeartbeatCoordinatorTaskListSchema.parse(await response.json()).tasks;
     }
+    async readTask(rawTaskId, signal) {
+        const response = await this.#request(this.#taskPath(OpaqueIdSchema.parse(rawTaskId)), { method: 'GET', signal });
+        return HostedHeartbeatCoordinatorTaskDetailSchema.parse(await response.json());
+    }
     async upsertTask(rawTaskId, rawTask, signal) {
         const taskId = OpaqueIdSchema.parse(rawTaskId);
         const task = HostedHeartbeatCoordinatorTaskInputSchema.parse(rawTask);
@@ -45,6 +53,12 @@ export class HostedHeartbeatCoordinatorClient {
             signal,
         });
     }
+    async triggerTask(rawTaskId, signal) {
+        const taskId = OpaqueIdSchema.parse(rawTaskId);
+        const path = `${this.#taskPath(taskId)}/trigger`;
+        const response = await this.#request(path, { method: 'POST', signal });
+        return HostedHeartbeatCoordinatorTaskViewSchema.parse(await response.json());
+    }
     async pause(signal) {
         await this.#request(HOSTED_HEARTBEAT_COORDINATOR_PATHS.pause, {
             method: 'POST',
@@ -57,6 +71,12 @@ export class HostedHeartbeatCoordinatorClient {
             signal,
         });
     }
+    async drain(signal) {
+        await this.#request(HOSTED_HEARTBEAT_COORDINATOR_PATHS.drain, {
+            method: 'POST',
+            signal,
+        });
+    }
     #taskPath(taskId) {
         return `${HOSTED_HEARTBEAT_COORDINATOR_PATHS.tasks}/${encodeURIComponent(taskId)}`;
     }