@heddleagent/execution-host-client 7.0.0 → 8.0.1

package/dist/coordinator/contracts.js

@@ -10,7 +10,10 @@ export const HOSTED_HEARTBEAT_COORDINATOR_PATHS = Object.freeze({
     resume: '/v1/control/resume',
     drain: '/v1/control/drain',
 });
-export const HOSTED_HEARTBEAT_DELEGATIONS_PATH = '/hosted-execution/internal/heartbeat-delegations';
+export const HOSTED_HEARTBEAT_EXECUTION_PATHS = Object.freeze({
+    prepare: '/hosted-execution/internal/heartbeat-executions/prepare',
+    settle: '/hosted-execution/internal/heartbeat-executions/settle',
+});
 export const HostedHeartbeatCoordinatorTaskInputSchema = z.object({
     workspaceId: OpaqueIdSchema.optional(),
     name: z.string().trim().min(1).max(200).optional(),
@@ -121,10 +124,11 @@ export const HostedHeartbeatDesiredTaskCatalogSchema = z.object({
         seen.add(taskId);
     });
 });
-export const HostedHeartbeatDelegationRequestSchema = z.object({
+export const HostedHeartbeatExecutionPreparationRequestSchema = z.object({
     schemaVersion: z.literal(1),
     taskId: OpaqueIdSchema,
     executionId: OpaqueIdSchema,
+    interruptedExecutionId: OpaqueIdSchema.optional(),
 }).strict();
 const DelegatedAuthorityMetadataSchema = z.object({
     scope: ExecutionScopeSchema,
@@ -170,10 +174,77 @@ export const HostedHeartbeatDelegationSchema = z.object({
         message: 'must match the delegated execution authority metadata',
     }));
 });
-export const HostedHeartbeatDelegationAuthorizationSchema = z.object({
+export const HostedHeartbeatExecutionAuthorizationSchema = z.object({
     scope: ProductExecutionScopeSchema,
     allowedTools: McpAllowedToolsSchema,
 }).strict();
+export const HostedHeartbeatExecutionPreparationDecisionSchema = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('execute'),
+        authorization: HostedHeartbeatExecutionAuthorizationSchema,
+    }).strict(),
+    z.object({
+        kind: z.literal('skip'),
+        summary: z.string().trim().min(1).max(500),
+    }).strict(),
+]);
+export const HostedHeartbeatExecutionPreparationSchema = z.discriminatedUnion('kind', [
+    z.object({
+        schemaVersion: z.literal(1),
+        kind: z.literal('execute'),
+        delegation: HostedHeartbeatDelegationSchema,
+    }).strict(),
+    z.object({
+        schemaVersion: z.literal(1),
+        kind: z.literal('skip'),
+        taskId: OpaqueIdSchema,
+        executionId: OpaqueIdSchema,
+        summary: z.string().trim().min(1).max(500),
+    }).strict(),
+]);
+export const HostedHeartbeatExecutionResultSchema = z.object({
+    decision: z.enum(['continue', 'pause', 'complete', 'escalate']),
+    summary: z.string(),
+    runId: OpaqueIdSchema,
+    outcome: z.enum(['done', 'max_steps', 'error', 'interrupted']),
+}).strict();
+const HostedHeartbeatExecutionSettlementEnvelopeSchema = z.object({
+    schemaVersion: z.literal(1),
+    taskId: OpaqueIdSchema,
+    executionId: OpaqueIdSchema,
+});
+export const HostedHeartbeatExecutionSettlementRequestSchema = z.discriminatedUnion('kind', [
+    HostedHeartbeatExecutionSettlementEnvelopeSchema.extend({
+        kind: z.literal('completed'),
+        result: HostedHeartbeatExecutionResultSchema,
+    }).strict(),
+    HostedHeartbeatExecutionSettlementEnvelopeSchema.extend({
+        kind: z.literal('failed'),
+        errorType: z.string().trim().min(1).max(128),
+    }).strict(),
+    HostedHeartbeatExecutionSettlementEnvelopeSchema.extend({
+        kind: z.literal('interrupted'),
+    }).strict(),
+]);
+export const HostedHeartbeatExecutionDispositionSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('accepted') }).strict(),
+    z.object({
+        kind: z.literal('retry'),
+        summary: z.string().trim().min(1).max(500),
+        delayMs: z.number().int().min(1_000).max(Number.MAX_SAFE_INTEGER)
+            .optional(),
+    }).strict(),
+    z.object({
+        kind: z.literal('blocked'),
+        summary: z.string().trim().min(1).max(500),
+    }).strict(),
+]);
+export const HostedHeartbeatExecutionSettlementSchema = z.object({
+    schemaVersion: z.literal(1),
+    taskId: OpaqueIdSchema,
+    executionId: OpaqueIdSchema,
+    disposition: HostedHeartbeatExecutionDispositionSchema,
+}).strict();
 function sameProductScope(left, right) {
     return left.tenantId === right.tenantId
         && left.subjectId === right.subjectId

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  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"]}
+{"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_EXECUTION_PATHS = Object.freeze({\n  prepare: '/hosted-execution/internal/heartbeat-executions/prepare',\n  settle: '/hosted-execution/internal/heartbeat-executions/settle',\n});\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 HostedHeartbeatExecutionPreparationRequestSchema = z.object({\n  schemaVersion: z.literal(1),\n  taskId: OpaqueIdSchema,\n  executionId: OpaqueIdSchema,\n  interruptedExecutionId: OpaqueIdSchema.optional(),\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 HostedHeartbeatExecutionAuthorizationSchema = z.object({\n  scope: ProductExecutionScopeSchema,\n  allowedTools: McpAllowedToolsSchema,\n}).strict();\n\nexport const HostedHeartbeatExecutionPreparationDecisionSchema =\n  z.discriminatedUnion('kind', [\n    z.object({\n      kind: z.literal('execute'),\n      authorization: HostedHeartbeatExecutionAuthorizationSchema,\n    }).strict(),\n    z.object({\n      kind: z.literal('skip'),\n      summary: z.string().trim().min(1).max(500),\n    }).strict(),\n  ]);\n\nexport const HostedHeartbeatExecutionPreparationSchema = z.discriminatedUnion(\n  'kind',\n  [\n    z.object({\n      schemaVersion: z.literal(1),\n      kind: z.literal('execute'),\n      delegation: HostedHeartbeatDelegationSchema,\n    }).strict(),\n    z.object({\n      schemaVersion: z.literal(1),\n      kind: z.literal('skip'),\n      taskId: OpaqueIdSchema,\n      executionId: OpaqueIdSchema,\n      summary: z.string().trim().min(1).max(500),\n    }).strict(),\n  ],\n);\n\nexport const HostedHeartbeatExecutionResultSchema = z.object({\n  decision: z.enum(['continue', 'pause', 'complete', 'escalate']),\n  summary: z.string(),\n  runId: OpaqueIdSchema,\n  outcome: z.enum(['done', 'max_steps', 'error', 'interrupted']),\n}).strict();\n\nconst HostedHeartbeatExecutionSettlementEnvelopeSchema = z.object({\n  schemaVersion: z.literal(1),\n  taskId: OpaqueIdSchema,\n  executionId: OpaqueIdSchema,\n});\n\nexport const HostedHeartbeatExecutionSettlementRequestSchema =\n  z.discriminatedUnion('kind', [\n    HostedHeartbeatExecutionSettlementEnvelopeSchema.extend({\n      kind: z.literal('completed'),\n      result: HostedHeartbeatExecutionResultSchema,\n    }).strict(),\n    HostedHeartbeatExecutionSettlementEnvelopeSchema.extend({\n      kind: z.literal('failed'),\n      errorType: z.string().trim().min(1).max(128),\n    }).strict(),\n    HostedHeartbeatExecutionSettlementEnvelopeSchema.extend({\n      kind: z.literal('interrupted'),\n    }).strict(),\n  ]);\n\nexport const HostedHeartbeatExecutionDispositionSchema = z.discriminatedUnion(\n  'kind',\n  [\n    z.object({ kind: z.literal('accepted') }).strict(),\n    z.object({\n      kind: z.literal('retry'),\n      summary: z.string().trim().min(1).max(500),\n      delayMs: z.number().int().min(1_000).max(Number.MAX_SAFE_INTEGER)\n        .optional(),\n    }).strict(),\n    z.object({\n      kind: z.literal('blocked'),\n      summary: z.string().trim().min(1).max(500),\n    }).strict(),\n  ],\n);\n\nexport const HostedHeartbeatExecutionSettlementSchema = z.object({\n  schemaVersion: z.literal(1),\n  taskId: OpaqueIdSchema,\n  executionId: OpaqueIdSchema,\n  disposition: HostedHeartbeatExecutionDispositionSchema,\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 HostedHeartbeatExecutionPreparationRequest = z.infer<\n  typeof HostedHeartbeatExecutionPreparationRequestSchema\n>;\nexport type HostedHeartbeatDelegation = z.infer<\n  typeof HostedHeartbeatDelegationSchema\n>;\nexport type HostedHeartbeatExecutionAuthorization = z.infer<\n  typeof HostedHeartbeatExecutionAuthorizationSchema\n>;\nexport type HostedHeartbeatExecutionPreparationDecision = z.infer<\n  typeof HostedHeartbeatExecutionPreparationDecisionSchema\n>;\nexport type HostedHeartbeatExecutionPreparation = z.infer<\n  typeof HostedHeartbeatExecutionPreparationSchema\n>;\nexport type HostedHeartbeatExecutionResult = z.infer<\n  typeof HostedHeartbeatExecutionResultSchema\n>;\nexport type HostedHeartbeatExecutionSettlementRequest = z.infer<\n  typeof HostedHeartbeatExecutionSettlementRequestSchema\n>;\nexport type HostedHeartbeatExecutionDisposition = z.infer<\n  typeof HostedHeartbeatExecutionDispositionSchema\n>;\nexport type HostedHeartbeatExecutionSettlement = z.infer<\n  typeof HostedHeartbeatExecutionSettlementSchema\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-execution-client.d.ts

@@ -0,0 +1,30 @@
+import { type HostedHeartbeatAgentExecutionTransportInput } from '../heartbeat/index.js';
+import { type HostedHeartbeatExecutionPreparation, type HostedHeartbeatExecutionPreparationRequest, type HostedHeartbeatExecutionSettlement, type HostedHeartbeatExecutionSettlementRequest } from './contracts.js';
+import type { HostedHeartbeatCoordinatorExecutionContext, HostedHeartbeatDelegatedExecutionConfig, HostedHeartbeatExecutionTransportPort, HostedHeartbeatExecutionApi, HostedHeartbeatExecutionClientConfig } from './types.js';
+type ExecutionOperation = 'prepare' | 'settle';
+export declare class HostedHeartbeatExecutionRequestError extends Error {
+    readonly operation: ExecutionOperation;
+    readonly status: number;
+    readonly name = "HostedHeartbeatExecutionRequestError";
+    constructor(operation: ExecutionOperation, status: number);
+}
+/** Authenticated Coordinator client for the product-owned work lifecycle. */
+export declare class HostedHeartbeatExecutionClient implements HostedHeartbeatExecutionApi {
+    #private;
+    constructor(config: HostedHeartbeatExecutionClientConfig);
+    prepare(rawInput: HostedHeartbeatExecutionPreparationRequest, signal?: AbortSignal): Promise<HostedHeartbeatExecutionPreparation>;
+    settle(rawInput: HostedHeartbeatExecutionSettlementRequest, signal?: AbortSignal): Promise<HostedHeartbeatExecutionSettlement>;
+}
+/**
+ * Coordinates product work around Heddle's authoritative task attempt.
+ * The paired transport consumes exactly the delegation prepared for that
+ * execution, so running the agent can never create a second product claim.
+ */
+export declare class HostedHeartbeatDelegatedExecution implements HostedHeartbeatExecutionTransportPort {
+    #private;
+    constructor(config: HostedHeartbeatDelegatedExecutionConfig);
+    handle<TResult, TOutcome>(context: HostedHeartbeatCoordinatorExecutionContext<TResult, TOutcome>): Promise<TResult | TOutcome>;
+    execute(input: HostedHeartbeatAgentExecutionTransportInput): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=hosted-heartbeat-execution-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-heartbeat-execution-client.d.ts","sourceRoot":"","sources":["../../src/coordinator/hosted-heartbeat-execution-client.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,KAAK,2CAA2C,EACjD,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAOL,KAAK,mCAAmC,EACxC,KAAK,0CAA0C,EAC/C,KAAK,kCAAkC,EACvC,KAAK,yCAAyC,EAC/C,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EACV,0CAA0C,EAC1C,uCAAuC,EACvC,qCAAqC,EACrC,2BAA2B,EAC3B,oCAAoC,EACrC,MAAM,YAAY,CAAC;AAgBpB,KAAK,kBAAkB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/C,qBAAa,oCAAqC,SAAQ,KAAK;IAI3D,QAAQ,CAAC,SAAS,EAAE,kBAAkB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAJzB,QAAQ,CAAC,IAAI,0CAA0C;gBAG5C,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,MAAM;CAI1B;AAED,6EAA6E;AAC7E,qBAAa,8BACb,YAAW,2BAA2B;;gBAMxB,MAAM,EAAE,oCAAoC;IAyBlD,OAAO,CACX,QAAQ,EAAE,0CAA0C,EACpD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mCAAmC,CAAC;IAczC,MAAM,CACV,QAAQ,EAAE,yCAAyC,EACnD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kCAAkC,CAAC;CAqC/C;AAED;;;;GAIG;AACH,qBAAa,iCACb,YAAW,qCAAqC;;gBAIlC,MAAM,EAAE,uCAAuC;IAIrD,MAAM,CAAC,OAAO,EAAE,QAAQ,EAC5B,OAAO,EAAE,0CAA0C,CAAC,OAAO,EAAE,QAAQ,CAAC,GACrE,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC;IA2DxB,OAAO,CACX,KAAK,EAAE,2CAA2C,GACjD,OAAO,CAAC,OAAO,CAAC;CA+DpB"}

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

@@ -0,0 +1,240 @@
+import { z } from 'zod';
+import { HEARTBEAT_TASK_WORKFLOW, OpaqueIdSchema, isDockerLocalWebUrl, isSafeWebUrl, } from '../contracts/index.js';
+import { HostedHeartbeatAgentExecutionTransport, HostedHeartbeatTaskService, } from '../heartbeat/index.js';
+import { HOSTED_HEARTBEAT_EXECUTION_PATHS, HostedHeartbeatExecutionPreparationRequestSchema, HostedHeartbeatExecutionPreparationSchema, HostedHeartbeatExecutionSettlementRequestSchema, HostedHeartbeatExecutionSettlementSchema, } from './contracts.js';
+import { HostedHeartbeatServiceTokenSchema } from './service-token.js';
+const AbsolutePathSchema = z.string().min(1).max(256).regex(/^\/(?:[^?#\s]*)$/, 'must be an absolute path without query, fragment, or whitespace');
+const RequestTimeoutSchema = z.number().int().min(1_000).max(60_000);
+const AgentResultSchema = z.object({
+    decision: z.enum(['continue', 'pause', 'complete', 'escalate']),
+    summary: z.string(),
+    state: z.object({
+        runId: OpaqueIdSchema,
+        outcome: z.enum(['done', 'max_steps', 'error', 'interrupted']),
+    }).passthrough(),
+}).passthrough();
+export class HostedHeartbeatExecutionRequestError extends Error {
+    operation;
+    status;
+    name = 'HostedHeartbeatExecutionRequestError';
+    constructor(operation, status) {
+        super(`Heartbeat execution ${operation} failed with status ${status}.`);
+        this.operation = operation;
+        this.status = status;
+    }
+}
+/** Authenticated Coordinator client for the product-owned work lifecycle. */
+export class HostedHeartbeatExecutionClient {
+    #endpoints;
+    #authorization;
+    #fetch;
+    #requestTimeoutMs;
+    constructor(config) {
+        const baseUrl = parseSafeBaseUrl(config);
+        this.#endpoints = {
+            prepare: new URL(AbsolutePathSchema.parse(config.preparePath ?? HOSTED_HEARTBEAT_EXECUTION_PATHS.prepare), baseUrl),
+            settle: new URL(AbsolutePathSchema.parse(config.settlePath ?? HOSTED_HEARTBEAT_EXECUTION_PATHS.settle), baseUrl),
+        };
+        this.#authorization = `Bearer ${HostedHeartbeatServiceTokenSchema.parse(config.apiToken)}`;
+        this.#fetch = config.fetch ?? globalThis.fetch;
+        this.#requestTimeoutMs = RequestTimeoutSchema.parse(config.requestTimeoutMs ?? 10_000);
+    }
+    async prepare(rawInput, signal) {
+        const input = HostedHeartbeatExecutionPreparationRequestSchema.parse(rawInput);
+        const preparation = HostedHeartbeatExecutionPreparationSchema.parse(await this.#post('prepare', input, signal));
+        const identity = preparation.kind === 'execute'
+            ? preparation.delegation
+            : preparation;
+        assertMatchingExecution(identity, input, 'preparation');
+        return preparation;
+    }
+    async settle(rawInput, signal) {
+        const input = HostedHeartbeatExecutionSettlementRequestSchema.parse(rawInput);
+        const settlement = HostedHeartbeatExecutionSettlementSchema.parse(await this.#post('settle', input, signal));
+        assertMatchingExecution(settlement, input, 'settlement');
+        return settlement;
+    }
+    async #post(operation, body, signal) {
+        const requestSignal = signal
+            ? AbortSignal.any([signal, AbortSignal.timeout(this.#requestTimeoutMs)])
+            : AbortSignal.timeout(this.#requestTimeoutMs);
+        const response = await this.#fetch(this.#endpoints[operation], {
+            method: 'POST',
+            headers: {
+                authorization: this.#authorization,
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify(body),
+            redirect: 'error',
+            signal: requestSignal,
+        });
+        if (!response.ok) {
+            throw new HostedHeartbeatExecutionRequestError(operation, response.status);
+        }
+        return await response.json();
+    }
+}
+/**
+ * Coordinates product work around Heddle's authoritative task attempt.
+ * The paired transport consumes exactly the delegation prepared for that
+ * execution, so running the agent can never create a second product claim.
+ */
+export class HostedHeartbeatDelegatedExecution {
+    #config;
+    #prepared = new Map();
+    constructor(config) {
+        this.#config = config;
+    }
+    async handle(context) {
+        const request = HostedHeartbeatExecutionPreparationRequestSchema.parse({
+            schemaVersion: 1,
+            taskId: context.task.id,
+            executionId: context.executionId,
+            ...(context.task.state?.recovery?.interruptedExecutionId
+                ? {
+                    interruptedExecutionId: context.task.state.recovery.interruptedExecutionId,
+                }
+                : {}),
+        });
+        const preparation = await this.#config.executions.prepare(request, context.signal);
+        if (preparation.kind === 'skip') {
+            return context.skip({ summary: preparation.summary });
+        }
+        this.#remember(preparation.delegation);
+        let result;
+        try {
+            result = await context.runAgent();
+            AgentResultSchema.parse(result);
+        }
+        catch (error) {
+            this.#prepared.delete(context.executionId);
+            await this.#settleFailure(request, error, context.signal.aborted);
+            throw error;
+        }
+        this.#prepared.delete(context.executionId);
+        const parsed = AgentResultSchema.parse(result);
+        const settlement = await this.#config.executions.settle({
+            schemaVersion: 1,
+            kind: 'completed',
+            taskId: request.taskId,
+            executionId: request.executionId,
+            result: {
+                decision: parsed.decision,
+                summary: parsed.summary,
+                runId: parsed.state.runId,
+                outcome: parsed.state.outcome,
+            },
+        });
+        if (settlement.disposition.kind === 'retry') {
+            return context.retry({
+                summary: settlement.disposition.summary,
+                ...(settlement.disposition.delayMs !== undefined
+                    ? { delayMs: settlement.disposition.delayMs }
+                    : {}),
+            });
+        }
+        if (settlement.disposition.kind === 'blocked') {
+            return context.block({ summary: settlement.disposition.summary });
+        }
+        return result;
+    }
+    async execute(input) {
+        const delegation = this.#prepared.get(input.request.executionId);
+        this.#prepared.delete(input.request.executionId);
+        if (!delegation
+            || delegation.taskId !== input.request.taskId
+            || delegation.executionId !== input.request.executionId) {
+            throw new Error('Heartbeat execution has no matching prepared product authority.');
+        }
+        const service = new HostedHeartbeatTaskService({
+            authority: new DelegatedExecutionAuthorityIssuer(delegation),
+            executionHost: this.#config.executionHost,
+            modelCredentials: this.#config.modelCredentials,
+            mcp: {
+                allowedTools: delegation.authority.metadata.mcp.allowedTools,
+            },
+        });
+        const transport = new HostedHeartbeatAgentExecutionTransport({
+            runner: service,
+            resolveInvocationContext: () => ({
+                scope: delegation.scope,
+                runtimeSessionId: delegation.runtimeSessionId,
+                deadlineAt: delegation.deadlineAt,
+            }),
+        });
+        return await transport.execute(input);
+    }
+    #remember(delegation) {
+        if (this.#prepared.has(delegation.executionId)) {
+            throw new Error('Heartbeat execution was prepared more than once.');
+        }
+        this.#prepared.set(delegation.executionId, delegation);
+    }
+    async #settleFailure(request, error, interrupted) {
+        const settlement = await this.#config.executions.settle(interrupted
+            ? {
+                schemaVersion: 1,
+                kind: 'interrupted',
+                taskId: request.taskId,
+                executionId: request.executionId,
+            }
+            : {
+                schemaVersion: 1,
+                kind: 'failed',
+                taskId: request.taskId,
+                executionId: request.executionId,
+                errorType: error instanceof Error ? error.name : 'unknown',
+            });
+        if (settlement.disposition.kind !== 'accepted') {
+            throw new Error('Product must accept failed or interrupted heartbeat settlement.');
+        }
+    }
+}
+function parseSafeBaseUrl(config) {
+    return z.custom((value) => value instanceof URL && (isSafeWebUrl(value)
+        || (config.allowDockerLocalHost === true
+            && isDockerLocalWebUrl(value))), 'baseUrl must use HTTPS or loopback HTTP; Docker local-host HTTP requires an explicit opt-in').parse(config.baseUrl);
+}
+function assertMatchingExecution(response, request, responseName) {
+    if (response.taskId !== request.taskId
+        || response.executionId !== request.executionId) {
+        throw new Error(`Product backend returned a mismatched heartbeat ${responseName}.`);
+    }
+}
+/** Ensures downstream execution cannot widen a delegated authority bundle. */
+class DelegatedExecutionAuthorityIssuer {
+    delegation;
+    constructor(delegation) {
+        this.delegation = delegation;
+    }
+    async issue(input) {
+        const metadata = this.delegation.authority.metadata;
+        if (input.workflow !== HEARTBEAT_TASK_WORKFLOW
+            || input.workflow !== metadata.workflow
+            || input.invocationId !== metadata.invocationId
+            || input.runtimeSessionId !== metadata.runtimeSessionId
+            || !sameScope(input.scope, this.delegation.scope)
+            || !sameScope(input.scope, metadata.scope)
+            || !sameTools(input.mcp?.allowedTools, metadata.mcp.allowedTools)) {
+            throw new Error('Heartbeat delegation does not match Heddle execution.');
+        }
+        const authority = this.delegation.authority;
+        return Object.freeze({
+            metadata: metadata,
+            executionAssertion: () => authority.executionAssertion,
+            mcpCapability: () => authority.mcpCapability,
+            toJSON: () => metadata,
+        });
+    }
+}
+function sameScope(left, right) {
+    return left.tenantId === right.tenantId
+        && left.subjectId === right.subjectId
+        && left.productSessionId === right.productSessionId;
+}
+function sameTools(left, right) {
+    return Boolean(left
+        && left.length === right.length
+        && left.every((tool, index) => tool === right[index]));
+}
+//# sourceMappingURL=hosted-heartbeat-execution-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-heartbeat-execution-client.js","sourceRoot":"","sources":["../../src/coordinator/hosted-heartbeat-execution-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport type {\n  ExecutionAuthorityIssueInput,\n  ExecutionAuthorityIssuer,\n  IssuedExecutionAuthority,\n  IssuedExecutionAuthorityMetadata,\n} from '../authority/index.js';\nimport {\n  HEARTBEAT_TASK_WORKFLOW,\n  OpaqueIdSchema,\n  isDockerLocalWebUrl,\n  isSafeWebUrl,\n} from '../contracts/index.js';\nimport {\n  HostedHeartbeatAgentExecutionTransport,\n  HostedHeartbeatTaskService,\n  type HostedHeartbeatAgentExecutionTransportInput,\n} from '../heartbeat/index.js';\nimport {\n  HOSTED_HEARTBEAT_EXECUTION_PATHS,\n  HostedHeartbeatExecutionPreparationRequestSchema,\n  HostedHeartbeatExecutionPreparationSchema,\n  HostedHeartbeatExecutionSettlementRequestSchema,\n  HostedHeartbeatExecutionSettlementSchema,\n  type HostedHeartbeatDelegation,\n  type HostedHeartbeatExecutionPreparation,\n  type HostedHeartbeatExecutionPreparationRequest,\n  type HostedHeartbeatExecutionSettlement,\n  type HostedHeartbeatExecutionSettlementRequest,\n} from './contracts.js';\nimport { HostedHeartbeatServiceTokenSchema } from './service-token.js';\nimport type {\n  HostedHeartbeatCoordinatorExecutionContext,\n  HostedHeartbeatDelegatedExecutionConfig,\n  HostedHeartbeatExecutionTransportPort,\n  HostedHeartbeatExecutionApi,\n  HostedHeartbeatExecutionClientConfig,\n} from './types.js';\n\nconst AbsolutePathSchema = z.string().min(1).max(256).regex(\n  /^\\/(?:[^?#\\s]*)$/,\n  'must be an absolute path without query, fragment, or whitespace',\n);\nconst RequestTimeoutSchema = z.number().int().min(1_000).max(60_000);\nconst AgentResultSchema = z.object({\n  decision: z.enum(['continue', 'pause', 'complete', 'escalate']),\n  summary: z.string(),\n  state: z.object({\n    runId: OpaqueIdSchema,\n    outcome: z.enum(['done', 'max_steps', 'error', 'interrupted']),\n  }).passthrough(),\n}).passthrough();\n\ntype ExecutionOperation = 'prepare' | 'settle';\n\nexport class HostedHeartbeatExecutionRequestError extends Error {\n  readonly name = 'HostedHeartbeatExecutionRequestError';\n\n  constructor(\n    readonly operation: ExecutionOperation,\n    readonly status: number,\n  ) {\n    super(`Heartbeat execution ${operation} failed with status ${status}.`);\n  }\n}\n\n/** Authenticated Coordinator client for the product-owned work lifecycle. */\nexport class HostedHeartbeatExecutionClient\nimplements HostedHeartbeatExecutionApi {\n  readonly #endpoints: Record<ExecutionOperation, URL>;\n  readonly #authorization: string;\n  readonly #fetch: typeof globalThis.fetch;\n  readonly #requestTimeoutMs: number;\n\n  constructor(config: HostedHeartbeatExecutionClientConfig) {\n    const baseUrl = parseSafeBaseUrl(config);\n    this.#endpoints = {\n      prepare: new URL(\n        AbsolutePathSchema.parse(\n          config.preparePath ?? HOSTED_HEARTBEAT_EXECUTION_PATHS.prepare,\n        ),\n        baseUrl,\n      ),\n      settle: new URL(\n        AbsolutePathSchema.parse(\n          config.settlePath ?? HOSTED_HEARTBEAT_EXECUTION_PATHS.settle,\n        ),\n        baseUrl,\n      ),\n    };\n    this.#authorization = `Bearer ${\n      HostedHeartbeatServiceTokenSchema.parse(config.apiToken)\n    }`;\n    this.#fetch = config.fetch ?? globalThis.fetch;\n    this.#requestTimeoutMs = RequestTimeoutSchema.parse(\n      config.requestTimeoutMs ?? 10_000,\n    );\n  }\n\n  async prepare(\n    rawInput: HostedHeartbeatExecutionPreparationRequest,\n    signal?: AbortSignal,\n  ): Promise<HostedHeartbeatExecutionPreparation> {\n    const input = HostedHeartbeatExecutionPreparationRequestSchema.parse(\n      rawInput,\n    );\n    const preparation = HostedHeartbeatExecutionPreparationSchema.parse(\n      await this.#post('prepare', input, signal),\n    );\n    const identity = preparation.kind === 'execute'\n      ? preparation.delegation\n      : preparation;\n    assertMatchingExecution(identity, input, 'preparation');\n    return preparation;\n  }\n\n  async settle(\n    rawInput: HostedHeartbeatExecutionSettlementRequest,\n    signal?: AbortSignal,\n  ): Promise<HostedHeartbeatExecutionSettlement> {\n    const input = HostedHeartbeatExecutionSettlementRequestSchema.parse(\n      rawInput,\n    );\n    const settlement = HostedHeartbeatExecutionSettlementSchema.parse(\n      await this.#post('settle', input, signal),\n    );\n    assertMatchingExecution(settlement, input, 'settlement');\n    return settlement;\n  }\n\n  async #post(\n    operation: ExecutionOperation,\n    body: unknown,\n    signal?: AbortSignal,\n  ): Promise<unknown> {\n    const requestSignal = signal\n      ? AbortSignal.any([signal, AbortSignal.timeout(this.#requestTimeoutMs)])\n      : AbortSignal.timeout(this.#requestTimeoutMs);\n    const response = await this.#fetch(this.#endpoints[operation], {\n      method: 'POST',\n      headers: {\n        authorization: this.#authorization,\n        'content-type': 'application/json',\n      },\n      body: JSON.stringify(body),\n      redirect: 'error',\n      signal: requestSignal,\n    });\n    if (!response.ok) {\n      throw new HostedHeartbeatExecutionRequestError(\n        operation,\n        response.status,\n      );\n    }\n    return await response.json();\n  }\n}\n\n/**\n * Coordinates product work around Heddle's authoritative task attempt.\n * The paired transport consumes exactly the delegation prepared for that\n * execution, so running the agent can never create a second product claim.\n */\nexport class HostedHeartbeatDelegatedExecution\nimplements HostedHeartbeatExecutionTransportPort {\n  readonly #config: HostedHeartbeatDelegatedExecutionConfig;\n  readonly #prepared = new Map<string, HostedHeartbeatDelegation>();\n\n  constructor(config: HostedHeartbeatDelegatedExecutionConfig) {\n    this.#config = config;\n  }\n\n  async handle<TResult, TOutcome>(\n    context: HostedHeartbeatCoordinatorExecutionContext<TResult, TOutcome>,\n  ): Promise<TResult | TOutcome> {\n    const request = HostedHeartbeatExecutionPreparationRequestSchema.parse({\n      schemaVersion: 1,\n      taskId: context.task.id,\n      executionId: context.executionId,\n      ...(context.task.state?.recovery?.interruptedExecutionId\n        ? {\n            interruptedExecutionId:\n              context.task.state.recovery.interruptedExecutionId,\n          }\n        : {}),\n    });\n    const preparation = await this.#config.executions.prepare(\n      request,\n      context.signal,\n    );\n    if (preparation.kind === 'skip') {\n      return context.skip({ summary: preparation.summary });\n    }\n\n    this.#remember(preparation.delegation);\n    let result: TResult;\n    try {\n      result = await context.runAgent();\n      AgentResultSchema.parse(result);\n    } catch (error) {\n      this.#prepared.delete(context.executionId);\n      await this.#settleFailure(request, error, context.signal.aborted);\n      throw error;\n    }\n    this.#prepared.delete(context.executionId);\n\n    const parsed = AgentResultSchema.parse(result);\n    const settlement = await this.#config.executions.settle({\n      schemaVersion: 1,\n      kind: 'completed',\n      taskId: request.taskId,\n      executionId: request.executionId,\n      result: {\n        decision: parsed.decision,\n        summary: parsed.summary,\n        runId: parsed.state.runId,\n        outcome: parsed.state.outcome,\n      },\n    });\n    if (settlement.disposition.kind === 'retry') {\n      return context.retry({\n        summary: settlement.disposition.summary,\n        ...(settlement.disposition.delayMs !== undefined\n          ? { delayMs: settlement.disposition.delayMs }\n          : {}),\n      });\n    }\n    if (settlement.disposition.kind === 'blocked') {\n      return context.block({ summary: settlement.disposition.summary });\n    }\n    return result;\n  }\n\n  async execute(\n    input: HostedHeartbeatAgentExecutionTransportInput,\n  ): Promise<unknown> {\n    const delegation = this.#prepared.get(input.request.executionId);\n    this.#prepared.delete(input.request.executionId);\n    if (\n      !delegation\n      || delegation.taskId !== input.request.taskId\n      || delegation.executionId !== input.request.executionId\n    ) {\n      throw new Error(\n        'Heartbeat execution has no matching prepared product authority.',\n      );\n    }\n    const service = new HostedHeartbeatTaskService({\n      authority: new DelegatedExecutionAuthorityIssuer(delegation),\n      executionHost: this.#config.executionHost,\n      modelCredentials: this.#config.modelCredentials,\n      mcp: {\n        allowedTools: delegation.authority.metadata.mcp.allowedTools,\n      },\n    });\n    const transport = new HostedHeartbeatAgentExecutionTransport({\n      runner: service,\n      resolveInvocationContext: () => ({\n        scope: delegation.scope,\n        runtimeSessionId: delegation.runtimeSessionId,\n        deadlineAt: delegation.deadlineAt,\n      }),\n    });\n    return await transport.execute(input);\n  }\n\n  #remember(delegation: HostedHeartbeatDelegation): void {\n    if (this.#prepared.has(delegation.executionId)) {\n      throw new Error('Heartbeat execution was prepared more than once.');\n    }\n    this.#prepared.set(delegation.executionId, delegation);\n  }\n\n  async #settleFailure(\n    request: HostedHeartbeatExecutionPreparationRequest,\n    error: unknown,\n    interrupted: boolean,\n  ): Promise<void> {\n    const settlement = await this.#config.executions.settle(interrupted\n      ? {\n          schemaVersion: 1,\n          kind: 'interrupted',\n          taskId: request.taskId,\n          executionId: request.executionId,\n        }\n      : {\n          schemaVersion: 1,\n          kind: 'failed',\n          taskId: request.taskId,\n          executionId: request.executionId,\n          errorType: error instanceof Error ? error.name : 'unknown',\n        });\n    if (settlement.disposition.kind !== 'accepted') {\n      throw new Error(\n        'Product must accept failed or interrupted heartbeat settlement.',\n      );\n    }\n  }\n}\n\nfunction parseSafeBaseUrl(\n  config: HostedHeartbeatExecutionClientConfig,\n): URL {\n  return z.custom<URL>(\n    (value) => value instanceof URL && (\n      isSafeWebUrl(value)\n      || (\n        config.allowDockerLocalHost === true\n        && isDockerLocalWebUrl(value)\n      )\n    ),\n    'baseUrl must use HTTPS or loopback HTTP; Docker local-host HTTP requires an explicit opt-in',\n  ).parse(config.baseUrl);\n}\n\nfunction assertMatchingExecution(\n  response: { taskId: string; executionId: string },\n  request: { taskId: string; executionId: string },\n  responseName: string,\n): void {\n  if (\n    response.taskId !== request.taskId\n    || response.executionId !== request.executionId\n  ) {\n    throw new Error(\n      `Product backend returned a mismatched heartbeat ${responseName}.`,\n    );\n  }\n}\n\n/** Ensures downstream execution cannot widen a delegated authority bundle. */\nclass DelegatedExecutionAuthorityIssuer implements ExecutionAuthorityIssuer {\n  constructor(private readonly delegation: HostedHeartbeatDelegation) {}\n\n  async issue(\n    input: ExecutionAuthorityIssueInput,\n  ): Promise<IssuedExecutionAuthority> {\n    const metadata = this.delegation.authority.metadata;\n    if (\n      input.workflow !== HEARTBEAT_TASK_WORKFLOW\n      || input.workflow !== metadata.workflow\n      || input.invocationId !== metadata.invocationId\n      || input.runtimeSessionId !== metadata.runtimeSessionId\n      || !sameScope(input.scope, this.delegation.scope)\n      || !sameScope(input.scope, metadata.scope)\n      || !sameTools(input.mcp?.allowedTools, metadata.mcp.allowedTools)\n    ) {\n      throw new Error('Heartbeat delegation does not match Heddle execution.');\n    }\n    const authority = this.delegation.authority;\n    return Object.freeze({\n      metadata: metadata as IssuedExecutionAuthorityMetadata,\n      executionAssertion: () => authority.executionAssertion,\n      mcpCapability: () => authority.mcpCapability,\n      toJSON: () => metadata as IssuedExecutionAuthorityMetadata,\n    });\n  }\n}\n\nfunction sameScope(\n  left: ExecutionAuthorityIssueInput['scope'],\n  right: HostedHeartbeatDelegation['scope']\n    | HostedHeartbeatDelegation['authority']['metadata']['scope'],\n): boolean {\n  return left.tenantId === right.tenantId\n    && left.subjectId === right.subjectId\n    && left.productSessionId === right.productSessionId;\n}\n\nfunction sameTools(\n  left: readonly string[] | undefined,\n  right: readonly string[],\n): boolean {\n  return Boolean(\n    left\n    && left.length === right.length\n    && left.every((tool, index) => tool === right[index]),\n  );\n}\n"]}

package/dist/coordinator/hosted-heartbeat-execution-service.d.ts

@@ -0,0 +1,14 @@
+import { type HostedHeartbeatExecutionPreparation, type HostedHeartbeatExecutionPreparationRequest, type HostedHeartbeatExecutionSettlement, type HostedHeartbeatExecutionSettlementRequest } from './contracts.js';
+import type { HostedHeartbeatExecutionApi, HostedHeartbeatExecutionServiceConfig } from './types.js';
+/**
+ * Owns the generic product lifecycle edge for one Coordinator execution.
+ * Product code decides whether work exists and how it settles; this service
+ * alone constructs the Heddle authority bundle used by the Execution Host.
+ */
+export declare class HostedHeartbeatExecutionService implements HostedHeartbeatExecutionApi {
+    #private;
+    constructor(config: HostedHeartbeatExecutionServiceConfig);
+    prepare(rawInput: HostedHeartbeatExecutionPreparationRequest, rawSignal?: AbortSignal): Promise<HostedHeartbeatExecutionPreparation>;
+    settle(rawInput: HostedHeartbeatExecutionSettlementRequest, rawSignal?: AbortSignal): Promise<HostedHeartbeatExecutionSettlement>;
+}
+//# sourceMappingURL=hosted-heartbeat-execution-service.d.ts.map

package/dist/coordinator/hosted-heartbeat-execution-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-heartbeat-execution-service.d.ts","sourceRoot":"","sources":["../../src/coordinator/hosted-heartbeat-execution-service.ts"],"names":[],"mappings":"AAGA,OAAO,EASL,KAAK,mCAAmC,EACxC,KAAK,0CAA0C,EAC/C,KAAK,kCAAkC,EACvC,KAAK,yCAAyC,EAC/C,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EACV,2BAA2B,EAC3B,qCAAqC,EACtC,MAAM,YAAY,CAAC;AAOpB;;;;GAIG;AACH,qBAAa,+BACb,YAAW,2BAA2B;;gBAOxB,MAAM,EAAE,qCAAqC;IAYnD,OAAO,CACX,QAAQ,EAAE,0CAA0C,EACpD,SAAS,CAAC,EAAE,WAAW,GACtB,OAAO,CAAC,mCAAmC,CAAC;IA2BzC,MAAM,CACV,QAAQ,EAAE,yCAAyC,EACnD,SAAS,CAAC,EAAE,WAAW,GACtB,OAAO,CAAC,kCAAkC,CAAC;CA4D/C"}

package/dist/coordinator/hosted-heartbeat-execution-service.js

@@ -0,0 +1,100 @@
+import dayjs from 'dayjs';
+import { z } from 'zod';
+import { HEARTBEAT_TASK_WORKFLOW, OpaqueIdSchema } from '../contracts/index.js';
+import { HostedHeartbeatDelegationSchema, HostedHeartbeatExecutionDispositionSchema, HostedHeartbeatExecutionPreparationDecisionSchema, HostedHeartbeatExecutionPreparationRequestSchema, HostedHeartbeatExecutionPreparationSchema, HostedHeartbeatExecutionSettlementRequestSchema, HostedHeartbeatExecutionSettlementSchema, } from './contracts.js';
+import { createHostedRuntimeSessionId } from './runtime-session.js';
+const ExecutionServiceConfigSchema = z.object({
+    runtimeSessionNamespace: OpaqueIdSchema,
+    maxExecutionMs: z.number().int().min(1_000).max(Number.MAX_SAFE_INTEGER),
+}).strict();
+/**
+ * Owns the generic product lifecycle edge for one Coordinator execution.
+ * Product code decides whether work exists and how it settles; this service
+ * alone constructs the Heddle authority bundle used by the Execution Host.
+ */
+export class HostedHeartbeatExecutionService {
+    #authority;
+    #lifecycle;
+    #runtimeSessionNamespace;
+    #maxExecutionMs;
+    #now;
+    constructor(config) {
+        const parsed = ExecutionServiceConfigSchema.parse({
+            runtimeSessionNamespace: config.runtimeSessionNamespace,
+            maxExecutionMs: config.maxExecutionMs,
+        });
+        this.#authority = config.authority;
+        this.#lifecycle = config.lifecycle;
+        this.#runtimeSessionNamespace = parsed.runtimeSessionNamespace;
+        this.#maxExecutionMs = parsed.maxExecutionMs;
+        this.#now = config.now ?? (() => new Date());
+    }
+    async prepare(rawInput, rawSignal) {
+        const input = HostedHeartbeatExecutionPreparationRequestSchema.parse(rawInput);
+        const signal = rawSignal ?? new AbortController().signal;
+        signal.throwIfAborted();
+        const decision = HostedHeartbeatExecutionPreparationDecisionSchema.parse(await this.#lifecycle.prepare({ ...input, signal }));
+        signal.throwIfAborted();
+        if (decision.kind === 'skip') {
+            return HostedHeartbeatExecutionPreparationSchema.parse({
+                schemaVersion: 1,
+                kind: 'skip',
+                taskId: input.taskId,
+                executionId: input.executionId,
+                summary: decision.summary,
+            });
+        }
+        return HostedHeartbeatExecutionPreparationSchema.parse({
+            schemaVersion: 1,
+            kind: 'execute',
+            delegation: await this.#createDelegation(input, decision.authorization),
+        });
+    }
+    async settle(rawInput, rawSignal) {
+        const input = HostedHeartbeatExecutionSettlementRequestSchema.parse(rawInput);
+        const signal = rawSignal ?? new AbortController().signal;
+        signal.throwIfAborted();
+        const disposition = HostedHeartbeatExecutionDispositionSchema.parse(await this.#lifecycle.settle({ ...input, signal }));
+        signal.throwIfAborted();
+        return HostedHeartbeatExecutionSettlementSchema.parse({
+            schemaVersion: 1,
+            taskId: input.taskId,
+            executionId: input.executionId,
+            disposition,
+        });
+    }
+    async #createDelegation(input, authorization) {
+        const runtimeSessionId = createHostedRuntimeSessionId({
+            namespace: this.#runtimeSessionNamespace,
+            scope: authorization.scope,
+        });
+        const deadlineAt = dayjs(this.#now())
+            .add(this.#maxExecutionMs, 'millisecond')
+            .toISOString();
+        const issued = await this.#authority.issue({
+            scope: authorization.scope,
+            runtimeSessionId,
+            invocationId: input.executionId,
+            workflow: HEARTBEAT_TASK_WORKFLOW,
+            mcp: { allowedTools: authorization.allowedTools },
+        });
+        const mcpCapability = issued.mcpCapability();
+        if (!mcpCapability || !issued.metadata.mcp) {
+            throw new Error('Hosted heartbeat execution requires an MCP-capable authority.');
+        }
+        return HostedHeartbeatDelegationSchema.parse({
+            schemaVersion: 1,
+            taskId: input.taskId,
+            executionId: input.executionId,
+            scope: authorization.scope,
+            runtimeSessionId,
+            deadlineAt,
+            authority: {
+                metadata: issued.metadata,
+                executionAssertion: issued.executionAssertion(),
+                mcpCapability,
+            },
+        });
+    }
+}
+//# sourceMappingURL=hosted-heartbeat-execution-service.js.map