@heddleagent/execution-host-client 6.7.0 → 8.0.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-heartbeat-execution-service.js","sourceRoot":"","sources":["../../src/coordinator/hosted-heartbeat-execution-service.ts"],"names":[],"mappings":"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","sourcesContent":["import dayjs from 'dayjs';\nimport { z } from 'zod';\nimport { HEARTBEAT_TASK_WORKFLOW, OpaqueIdSchema } from '../contracts/index.js';\nimport {\n  HostedHeartbeatDelegationSchema,\n  HostedHeartbeatExecutionDispositionSchema,\n  HostedHeartbeatExecutionPreparationDecisionSchema,\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 { createHostedRuntimeSessionId } from './runtime-session.js';\nimport type {\n  HostedHeartbeatExecutionApi,\n  HostedHeartbeatExecutionServiceConfig,\n} from './types.js';\n\nconst ExecutionServiceConfigSchema = z.object({\n  runtimeSessionNamespace: OpaqueIdSchema,\n  maxExecutionMs: z.number().int().min(1_000).max(Number.MAX_SAFE_INTEGER),\n}).strict();\n\n/**\n * Owns the generic product lifecycle edge for one Coordinator execution.\n * Product code decides whether work exists and how it settles; this service\n * alone constructs the Heddle authority bundle used by the Execution Host.\n */\nexport class HostedHeartbeatExecutionService\nimplements HostedHeartbeatExecutionApi {\n  readonly #authority: HostedHeartbeatExecutionServiceConfig['authority'];\n  readonly #lifecycle: HostedHeartbeatExecutionServiceConfig['lifecycle'];\n  readonly #runtimeSessionNamespace: string;\n  readonly #maxExecutionMs: number;\n  readonly #now: () => Date;\n\n  constructor(config: HostedHeartbeatExecutionServiceConfig) {\n    const parsed = ExecutionServiceConfigSchema.parse({\n      runtimeSessionNamespace: config.runtimeSessionNamespace,\n      maxExecutionMs: config.maxExecutionMs,\n    });\n    this.#authority = config.authority;\n    this.#lifecycle = config.lifecycle;\n    this.#runtimeSessionNamespace = parsed.runtimeSessionNamespace;\n    this.#maxExecutionMs = parsed.maxExecutionMs;\n    this.#now = config.now ?? (() => new Date());\n  }\n\n  async prepare(\n    rawInput: HostedHeartbeatExecutionPreparationRequest,\n    rawSignal?: AbortSignal,\n  ): Promise<HostedHeartbeatExecutionPreparation> {\n    const input = HostedHeartbeatExecutionPreparationRequestSchema.parse(\n      rawInput,\n    );\n    const signal = rawSignal ?? new AbortController().signal;\n    signal.throwIfAborted();\n    const decision = HostedHeartbeatExecutionPreparationDecisionSchema.parse(\n      await this.#lifecycle.prepare({ ...input, signal }),\n    );\n    signal.throwIfAborted();\n    if (decision.kind === 'skip') {\n      return HostedHeartbeatExecutionPreparationSchema.parse({\n        schemaVersion: 1,\n        kind: 'skip',\n        taskId: input.taskId,\n        executionId: input.executionId,\n        summary: decision.summary,\n      });\n    }\n\n    return HostedHeartbeatExecutionPreparationSchema.parse({\n      schemaVersion: 1,\n      kind: 'execute',\n      delegation: await this.#createDelegation(input, decision.authorization),\n    });\n  }\n\n  async settle(\n    rawInput: HostedHeartbeatExecutionSettlementRequest,\n    rawSignal?: AbortSignal,\n  ): Promise<HostedHeartbeatExecutionSettlement> {\n    const input = HostedHeartbeatExecutionSettlementRequestSchema.parse(\n      rawInput,\n    );\n    const signal = rawSignal ?? new AbortController().signal;\n    signal.throwIfAborted();\n    const disposition = HostedHeartbeatExecutionDispositionSchema.parse(\n      await this.#lifecycle.settle({ ...input, signal }),\n    );\n    signal.throwIfAborted();\n    return HostedHeartbeatExecutionSettlementSchema.parse({\n      schemaVersion: 1,\n      taskId: input.taskId,\n      executionId: input.executionId,\n      disposition,\n    });\n  }\n\n  async #createDelegation(\n    input: HostedHeartbeatExecutionPreparationRequest,\n    authorization: Extract<\n      z.infer<typeof HostedHeartbeatExecutionPreparationDecisionSchema>,\n      { kind: 'execute' }\n    >['authorization'],\n  ): Promise<HostedHeartbeatDelegation> {\n    const runtimeSessionId = createHostedRuntimeSessionId({\n      namespace: this.#runtimeSessionNamespace,\n      scope: authorization.scope,\n    });\n    const deadlineAt = dayjs(this.#now())\n      .add(this.#maxExecutionMs, 'millisecond')\n      .toISOString();\n    const issued = await this.#authority.issue({\n      scope: authorization.scope,\n      runtimeSessionId,\n      invocationId: input.executionId,\n      workflow: HEARTBEAT_TASK_WORKFLOW,\n      mcp: { allowedTools: authorization.allowedTools },\n    });\n    const mcpCapability = issued.mcpCapability();\n    if (!mcpCapability || !issued.metadata.mcp) {\n      throw new Error(\n        'Hosted heartbeat execution requires an MCP-capable authority.',\n      );\n    }\n\n    return HostedHeartbeatDelegationSchema.parse({\n      schemaVersion: 1,\n      taskId: input.taskId,\n      executionId: input.executionId,\n      scope: authorization.scope,\n      runtimeSessionId,\n      deadlineAt,\n      authority: {\n        metadata: issued.metadata,\n        executionAssertion: issued.executionAssertion(),\n        mcpCapability,\n      },\n    });\n  }\n}\n"]}

package/dist/coordinator/index.d.ts

@@ -1,9 +1,9 @@
-export { HOSTED_HEARTBEAT_COORDINATOR_PATHS, HOSTED_HEARTBEAT_DELEGATIONS_PATH, HostedHeartbeatCoordinatorRunViewSchema, HostedHeartbeatCoordinatorStateResponseSchema, HostedHeartbeatCoordinatorStateSchema, HostedHeartbeatCoordinatorTaskDetailSchema, HostedHeartbeatCoordinatorTaskInputSchema, HostedHeartbeatCoordinatorTaskListSchema, HostedHeartbeatCoordinatorTaskResultSchema, HostedHeartbeatCoordinatorTaskStatusSchema, HostedHeartbeatCoordinatorTaskViewSchema, HostedHeartbeatDelegationAuthorizationSchema, HostedHeartbeatDelegationRequestSchema, HostedHeartbeatDelegationSchema, HostedHeartbeatDesiredTaskCatalogSchema, HostedHeartbeatDesiredTaskSchema, } from './contracts.js';
-export type { HostedHeartbeatCoordinatorTaskInput, HostedHeartbeatCoordinatorRunView, HostedHeartbeatCoordinatorState, HostedHeartbeatCoordinatorTaskDetail, HostedHeartbeatCoordinatorTaskView, HostedHeartbeatDelegation, HostedHeartbeatDelegationAuthorization, HostedHeartbeatDelegationRequest, HostedHeartbeatDesiredTask, HostedHeartbeatDesiredTaskCatalog, } from './contracts.js';
+export { HOSTED_HEARTBEAT_COORDINATOR_PATHS, HOSTED_HEARTBEAT_EXECUTION_PATHS, HostedHeartbeatCoordinatorRunViewSchema, HostedHeartbeatCoordinatorStateResponseSchema, HostedHeartbeatCoordinatorStateSchema, HostedHeartbeatCoordinatorTaskDetailSchema, HostedHeartbeatCoordinatorTaskInputSchema, HostedHeartbeatCoordinatorTaskListSchema, HostedHeartbeatCoordinatorTaskResultSchema, HostedHeartbeatCoordinatorTaskStatusSchema, HostedHeartbeatCoordinatorTaskViewSchema, HostedHeartbeatDelegationSchema, HostedHeartbeatExecutionAuthorizationSchema, HostedHeartbeatExecutionDispositionSchema, HostedHeartbeatExecutionPreparationDecisionSchema, HostedHeartbeatExecutionPreparationRequestSchema, HostedHeartbeatExecutionPreparationSchema, HostedHeartbeatExecutionResultSchema, HostedHeartbeatExecutionSettlementRequestSchema, HostedHeartbeatExecutionSettlementSchema, HostedHeartbeatDesiredTaskCatalogSchema, HostedHeartbeatDesiredTaskSchema, } from './contracts.js';
+export type { HostedHeartbeatCoordinatorTaskInput, HostedHeartbeatCoordinatorRunView, HostedHeartbeatCoordinatorState, HostedHeartbeatCoordinatorTaskDetail, HostedHeartbeatCoordinatorTaskView, HostedHeartbeatDelegation, HostedHeartbeatExecutionAuthorization, HostedHeartbeatExecutionDisposition, HostedHeartbeatExecutionPreparation, HostedHeartbeatExecutionPreparationDecision, HostedHeartbeatExecutionPreparationRequest, HostedHeartbeatExecutionResult, HostedHeartbeatExecutionSettlement, HostedHeartbeatExecutionSettlementRequest, HostedHeartbeatDesiredTask, HostedHeartbeatDesiredTaskCatalog, } from './contracts.js';
 export { HostedHeartbeatCoordinatorClient, HostedHeartbeatCoordinatorRequestError, } from './hosted-heartbeat-coordinator-client.js';
-export { HostedHeartbeatDelegatedExecutionTransport, HostedHeartbeatDelegationClient, HostedHeartbeatDelegationRequestError, } from './hosted-heartbeat-delegation-client.js';
-export { HostedHeartbeatDelegationRejectedError, HostedHeartbeatDelegationService, } from './hosted-heartbeat-delegation-service.js';
+export { HostedHeartbeatDelegatedExecution, HostedHeartbeatExecutionClient, HostedHeartbeatExecutionRequestError, } from './hosted-heartbeat-execution-client.js';
+export { HostedHeartbeatExecutionService, } from './hosted-heartbeat-execution-service.js';
 export { HostedHeartbeatTaskReconciler } from './hosted-heartbeat-task-reconciler.js';
 export { createHostedRuntimeSessionId } from './runtime-session.js';
-export type { HostedHeartbeatCoordinatorClientConfig, HostedHeartbeatCoordinatorTaskApi, HostedHeartbeatDelegatedExecutionTransportConfig, HostedHeartbeatDelegatedExecutionTransportPort, HostedHeartbeatDelegationAuthorizationInput, HostedHeartbeatDelegationAuthorizer, HostedHeartbeatDelegationClientConfig, HostedHeartbeatDelegationIssuer, HostedHeartbeatDelegationServiceConfig, HostedHeartbeatTaskReconcilerConfig, HostedHeartbeatTaskReconciliation, HostedHeartbeatTaskReconciliationInput, } from './types.js';
+export type { HostedHeartbeatCoordinatorClientConfig, HostedHeartbeatCoordinatorTaskApi, HostedHeartbeatCoordinatorExecutionContext, HostedHeartbeatDelegatedExecutionConfig, HostedHeartbeatExecutionTransportPort, HostedHeartbeatExecutionApi, HostedHeartbeatExecutionClientConfig, HostedHeartbeatExecutionPreparationInput, HostedHeartbeatExecutionServiceConfig, HostedHeartbeatExecutionSettlementInput, HostedHeartbeatProductExecutionLifecycle, HostedHeartbeatTaskReconcilerConfig, HostedHeartbeatTaskReconciliation, HostedHeartbeatTaskReconciliationInput, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/coordinator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,iCAAiC,EACjC,uCAAuC,EACvC,6CAA6C,EAC7C,qCAAqC,EACrC,0CAA0C,EAC1C,yCAAyC,EACzC,wCAAwC,EACxC,0CAA0C,EAC1C,0CAA0C,EAC1C,wCAAwC,EACxC,4CAA4C,EAC5C,sCAAsC,EACtC,+BAA+B,EAC/B,uCAAuC,EACvC,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,mCAAmC,EACnC,iCAAiC,EACjC,+BAA+B,EAC/B,oCAAoC,EACpC,kCAAkC,EAClC,yBAAyB,EACzB,sCAAsC,EACtC,gCAAgC,EAChC,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gCAAgC,EAChC,sCAAsC,GACvC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,0CAA0C,EAC1C,+BAA+B,EAC/B,qCAAqC,GACtC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,sCAAsC,EACtC,gCAAgC,GACjC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EACV,sCAAsC,EACtC,iCAAiC,EACjC,gDAAgD,EAChD,8CAA8C,EAC9C,2CAA2C,EAC3C,mCAAmC,EACnC,qCAAqC,EACrC,+BAA+B,EAC/B,sCAAsC,EACtC,mCAAmC,EACnC,iCAAiC,EACjC,sCAAsC,GACvC,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/coordinator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,gCAAgC,EAChC,uCAAuC,EACvC,6CAA6C,EAC7C,qCAAqC,EACrC,0CAA0C,EAC1C,yCAAyC,EACzC,wCAAwC,EACxC,0CAA0C,EAC1C,0CAA0C,EAC1C,wCAAwC,EACxC,+BAA+B,EAC/B,2CAA2C,EAC3C,yCAAyC,EACzC,iDAAiD,EACjD,gDAAgD,EAChD,yCAAyC,EACzC,oCAAoC,EACpC,+CAA+C,EAC/C,wCAAwC,EACxC,uCAAuC,EACvC,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,mCAAmC,EACnC,iCAAiC,EACjC,+BAA+B,EAC/B,oCAAoC,EACpC,kCAAkC,EAClC,yBAAyB,EACzB,qCAAqC,EACrC,mCAAmC,EACnC,mCAAmC,EACnC,2CAA2C,EAC3C,0CAA0C,EAC1C,8BAA8B,EAC9B,kCAAkC,EAClC,yCAAyC,EACzC,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gCAAgC,EAChC,sCAAsC,GACvC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,oCAAoC,GACrC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,+BAA+B,GAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EACV,sCAAsC,EACtC,iCAAiC,EACjC,0CAA0C,EAC1C,uCAAuC,EACvC,qCAAqC,EACrC,2BAA2B,EAC3B,oCAAoC,EACpC,wCAAwC,EACxC,qCAAqC,EACrC,uCAAuC,EACvC,wCAAwC,EACxC,mCAAmC,EACnC,iCAAiC,EACjC,sCAAsC,GACvC,MAAM,YAAY,CAAC"}

package/dist/coordinator/index.js

@@ -1,7 +1,7 @@
-export { HOSTED_HEARTBEAT_COORDINATOR_PATHS, HOSTED_HEARTBEAT_DELEGATIONS_PATH, HostedHeartbeatCoordinatorRunViewSchema, HostedHeartbeatCoordinatorStateResponseSchema, HostedHeartbeatCoordinatorStateSchema, HostedHeartbeatCoordinatorTaskDetailSchema, HostedHeartbeatCoordinatorTaskInputSchema, HostedHeartbeatCoordinatorTaskListSchema, HostedHeartbeatCoordinatorTaskResultSchema, HostedHeartbeatCoordinatorTaskStatusSchema, HostedHeartbeatCoordinatorTaskViewSchema, HostedHeartbeatDelegationAuthorizationSchema, HostedHeartbeatDelegationRequestSchema, HostedHeartbeatDelegationSchema, HostedHeartbeatDesiredTaskCatalogSchema, HostedHeartbeatDesiredTaskSchema, } from './contracts.js';
+export { HOSTED_HEARTBEAT_COORDINATOR_PATHS, HOSTED_HEARTBEAT_EXECUTION_PATHS, HostedHeartbeatCoordinatorRunViewSchema, HostedHeartbeatCoordinatorStateResponseSchema, HostedHeartbeatCoordinatorStateSchema, HostedHeartbeatCoordinatorTaskDetailSchema, HostedHeartbeatCoordinatorTaskInputSchema, HostedHeartbeatCoordinatorTaskListSchema, HostedHeartbeatCoordinatorTaskResultSchema, HostedHeartbeatCoordinatorTaskStatusSchema, HostedHeartbeatCoordinatorTaskViewSchema, HostedHeartbeatDelegationSchema, HostedHeartbeatExecutionAuthorizationSchema, HostedHeartbeatExecutionDispositionSchema, HostedHeartbeatExecutionPreparationDecisionSchema, HostedHeartbeatExecutionPreparationRequestSchema, HostedHeartbeatExecutionPreparationSchema, HostedHeartbeatExecutionResultSchema, HostedHeartbeatExecutionSettlementRequestSchema, HostedHeartbeatExecutionSettlementSchema, HostedHeartbeatDesiredTaskCatalogSchema, HostedHeartbeatDesiredTaskSchema, } from './contracts.js';
 export { HostedHeartbeatCoordinatorClient, HostedHeartbeatCoordinatorRequestError, } from './hosted-heartbeat-coordinator-client.js';
-export { HostedHeartbeatDelegatedExecutionTransport, HostedHeartbeatDelegationClient, HostedHeartbeatDelegationRequestError, } from './hosted-heartbeat-delegation-client.js';
-export { HostedHeartbeatDelegationRejectedError, HostedHeartbeatDelegationService, } from './hosted-heartbeat-delegation-service.js';
+export { HostedHeartbeatDelegatedExecution, HostedHeartbeatExecutionClient, HostedHeartbeatExecutionRequestError, } from './hosted-heartbeat-execution-client.js';
+export { HostedHeartbeatExecutionService, } from './hosted-heartbeat-execution-service.js';
 export { HostedHeartbeatTaskReconciler } from './hosted-heartbeat-task-reconciler.js';
 export { createHostedRuntimeSessionId } from './runtime-session.js';
 //# sourceMappingURL=index.js.map

package/dist/coordinator/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordinator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,iCAAiC,EACjC,uCAAuC,EACvC,6CAA6C,EAC7C,qCAAqC,EACrC,0CAA0C,EAC1C,yCAAyC,EACzC,wCAAwC,EACxC,0CAA0C,EAC1C,0CAA0C,EAC1C,wCAAwC,EACxC,4CAA4C,EAC5C,sCAAsC,EACtC,+BAA+B,EAC/B,uCAAuC,EACvC,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AAaxB,OAAO,EACL,gCAAgC,EAChC,sCAAsC,GACvC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,0CAA0C,EAC1C,+BAA+B,EAC/B,qCAAqC,GACtC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,sCAAsC,EACtC,gCAAgC,GACjC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["export {\n  HOSTED_HEARTBEAT_COORDINATOR_PATHS,\n  HOSTED_HEARTBEAT_DELEGATIONS_PATH,\n  HostedHeartbeatCoordinatorRunViewSchema,\n  HostedHeartbeatCoordinatorStateResponseSchema,\n  HostedHeartbeatCoordinatorStateSchema,\n  HostedHeartbeatCoordinatorTaskDetailSchema,\n  HostedHeartbeatCoordinatorTaskInputSchema,\n  HostedHeartbeatCoordinatorTaskListSchema,\n  HostedHeartbeatCoordinatorTaskResultSchema,\n  HostedHeartbeatCoordinatorTaskStatusSchema,\n  HostedHeartbeatCoordinatorTaskViewSchema,\n  HostedHeartbeatDelegationAuthorizationSchema,\n  HostedHeartbeatDelegationRequestSchema,\n  HostedHeartbeatDelegationSchema,\n  HostedHeartbeatDesiredTaskCatalogSchema,\n  HostedHeartbeatDesiredTaskSchema,\n} from './contracts.js';\nexport type {\n  HostedHeartbeatCoordinatorTaskInput,\n  HostedHeartbeatCoordinatorRunView,\n  HostedHeartbeatCoordinatorState,\n  HostedHeartbeatCoordinatorTaskDetail,\n  HostedHeartbeatCoordinatorTaskView,\n  HostedHeartbeatDelegation,\n  HostedHeartbeatDelegationAuthorization,\n  HostedHeartbeatDelegationRequest,\n  HostedHeartbeatDesiredTask,\n  HostedHeartbeatDesiredTaskCatalog,\n} from './contracts.js';\nexport {\n  HostedHeartbeatCoordinatorClient,\n  HostedHeartbeatCoordinatorRequestError,\n} from './hosted-heartbeat-coordinator-client.js';\nexport {\n  HostedHeartbeatDelegatedExecutionTransport,\n  HostedHeartbeatDelegationClient,\n  HostedHeartbeatDelegationRequestError,\n} from './hosted-heartbeat-delegation-client.js';\nexport {\n  HostedHeartbeatDelegationRejectedError,\n  HostedHeartbeatDelegationService,\n} from './hosted-heartbeat-delegation-service.js';\nexport { HostedHeartbeatTaskReconciler } from './hosted-heartbeat-task-reconciler.js';\nexport { createHostedRuntimeSessionId } from './runtime-session.js';\nexport type {\n  HostedHeartbeatCoordinatorClientConfig,\n  HostedHeartbeatCoordinatorTaskApi,\n  HostedHeartbeatDelegatedExecutionTransportConfig,\n  HostedHeartbeatDelegatedExecutionTransportPort,\n  HostedHeartbeatDelegationAuthorizationInput,\n  HostedHeartbeatDelegationAuthorizer,\n  HostedHeartbeatDelegationClientConfig,\n  HostedHeartbeatDelegationIssuer,\n  HostedHeartbeatDelegationServiceConfig,\n  HostedHeartbeatTaskReconcilerConfig,\n  HostedHeartbeatTaskReconciliation,\n  HostedHeartbeatTaskReconciliationInput,\n} from './types.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordinator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,gCAAgC,EAChC,uCAAuC,EACvC,6CAA6C,EAC7C,qCAAqC,EACrC,0CAA0C,EAC1C,yCAAyC,EACzC,wCAAwC,EACxC,0CAA0C,EAC1C,0CAA0C,EAC1C,wCAAwC,EACxC,+BAA+B,EAC/B,2CAA2C,EAC3C,yCAAyC,EACzC,iDAAiD,EACjD,gDAAgD,EAChD,yCAAyC,EACzC,oCAAoC,EACpC,+CAA+C,EAC/C,wCAAwC,EACxC,uCAAuC,EACvC,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AAmBxB,OAAO,EACL,gCAAgC,EAChC,sCAAsC,GACvC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,oCAAoC,GACrC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,+BAA+B,GAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["export {\n  HOSTED_HEARTBEAT_COORDINATOR_PATHS,\n  HOSTED_HEARTBEAT_EXECUTION_PATHS,\n  HostedHeartbeatCoordinatorRunViewSchema,\n  HostedHeartbeatCoordinatorStateResponseSchema,\n  HostedHeartbeatCoordinatorStateSchema,\n  HostedHeartbeatCoordinatorTaskDetailSchema,\n  HostedHeartbeatCoordinatorTaskInputSchema,\n  HostedHeartbeatCoordinatorTaskListSchema,\n  HostedHeartbeatCoordinatorTaskResultSchema,\n  HostedHeartbeatCoordinatorTaskStatusSchema,\n  HostedHeartbeatCoordinatorTaskViewSchema,\n  HostedHeartbeatDelegationSchema,\n  HostedHeartbeatExecutionAuthorizationSchema,\n  HostedHeartbeatExecutionDispositionSchema,\n  HostedHeartbeatExecutionPreparationDecisionSchema,\n  HostedHeartbeatExecutionPreparationRequestSchema,\n  HostedHeartbeatExecutionPreparationSchema,\n  HostedHeartbeatExecutionResultSchema,\n  HostedHeartbeatExecutionSettlementRequestSchema,\n  HostedHeartbeatExecutionSettlementSchema,\n  HostedHeartbeatDesiredTaskCatalogSchema,\n  HostedHeartbeatDesiredTaskSchema,\n} from './contracts.js';\nexport type {\n  HostedHeartbeatCoordinatorTaskInput,\n  HostedHeartbeatCoordinatorRunView,\n  HostedHeartbeatCoordinatorState,\n  HostedHeartbeatCoordinatorTaskDetail,\n  HostedHeartbeatCoordinatorTaskView,\n  HostedHeartbeatDelegation,\n  HostedHeartbeatExecutionAuthorization,\n  HostedHeartbeatExecutionDisposition,\n  HostedHeartbeatExecutionPreparation,\n  HostedHeartbeatExecutionPreparationDecision,\n  HostedHeartbeatExecutionPreparationRequest,\n  HostedHeartbeatExecutionResult,\n  HostedHeartbeatExecutionSettlement,\n  HostedHeartbeatExecutionSettlementRequest,\n  HostedHeartbeatDesiredTask,\n  HostedHeartbeatDesiredTaskCatalog,\n} from './contracts.js';\nexport {\n  HostedHeartbeatCoordinatorClient,\n  HostedHeartbeatCoordinatorRequestError,\n} from './hosted-heartbeat-coordinator-client.js';\nexport {\n  HostedHeartbeatDelegatedExecution,\n  HostedHeartbeatExecutionClient,\n  HostedHeartbeatExecutionRequestError,\n} from './hosted-heartbeat-execution-client.js';\nexport {\n  HostedHeartbeatExecutionService,\n} from './hosted-heartbeat-execution-service.js';\nexport { HostedHeartbeatTaskReconciler } from './hosted-heartbeat-task-reconciler.js';\nexport { createHostedRuntimeSessionId } from './runtime-session.js';\nexport type {\n  HostedHeartbeatCoordinatorClientConfig,\n  HostedHeartbeatCoordinatorTaskApi,\n  HostedHeartbeatCoordinatorExecutionContext,\n  HostedHeartbeatDelegatedExecutionConfig,\n  HostedHeartbeatExecutionTransportPort,\n  HostedHeartbeatExecutionApi,\n  HostedHeartbeatExecutionClientConfig,\n  HostedHeartbeatExecutionPreparationInput,\n  HostedHeartbeatExecutionServiceConfig,\n  HostedHeartbeatExecutionSettlementInput,\n  HostedHeartbeatProductExecutionLifecycle,\n  HostedHeartbeatTaskReconcilerConfig,\n  HostedHeartbeatTaskReconciliation,\n  HostedHeartbeatTaskReconciliationInput,\n} from './types.js';\n"]}

package/dist/coordinator/node/execution-http-service.d.ts

@@ -0,0 +1,11 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { NodeHostedHeartbeatExecutionHttpHandler, NodeHostedHeartbeatExecutionHttpServiceConfig } from './types.js';
+/** Standard authenticated Node HTTP edge for product-owned work lifecycle. */
+export declare class NodeHostedHeartbeatExecutionHttpService implements NodeHostedHeartbeatExecutionHttpHandler {
+    #private;
+    constructor(config: NodeHostedHeartbeatExecutionHttpServiceConfig);
+    handle(request: IncomingMessage, response: ServerResponse): boolean;
+    handleExecution(request: IncomingMessage, response: ServerResponse): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=execution-http-service.d.ts.map

package/dist/coordinator/node/execution-http-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-http-service.d.ts","sourceRoot":"","sources":["../../../src/coordinator/node/execution-http-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAkBjE,OAAO,KAAK,EAEV,uCAAuC,EACvC,6CAA6C,EAC9C,MAAM,YAAY,CAAC;AAYpB,8EAA8E;AAC9E,qBAAa,uCACb,YAAW,uCAAuC;;gBAcpC,MAAM,EAAE,6CAA6C;IAmBjE,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO;IASnE,eAAe,CACb,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,GACvB,IAAI;IAUP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA2IvB"}