@heddleagent/execution-host-client 6.0.0-next.0

package/dist/conversation/lifecycle-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-types.d.ts","sourceRoot":"","sources":["../../src/conversation/lifecycle-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAKL,KAAK,0BAA0B,EAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,iCAAiC,mGAQpC,CAAC;AAEX,eAAO,MAAM,gCAAgC,wSAenC,CAAC;AAEX,eAAO,MAAM,qCAAqC,qIAMxC,CAAC;AAEX,eAAO,MAAM,mCAAmC,mCAEtC,CAAC;AAEX,eAAO,MAAM,iCAAiC,0bAIpC,CAAC;AAEX,eAAO,MAAM,kCAAkC;;;;;;;;EAE9C,CAAC;AACF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;EAE/C,CAAC;AACF,eAAO,MAAM,wCAAwC;;;;kBACL,CAAC;AACjD,eAAO,MAAM,oCAAoC;;;;;;;kBAGtC,CAAC;AACZ,eAAO,MAAM,qCAAqC;;;;;;;;;;kBAMrC,CAAC;AACd,eAAO,MAAM,oCAAoC;;;;;;;;;kBAIpC,CAAC;AAOd,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BA0BlD,CAAC;AAEF,eAAO,MAAM,iDAAiD;;;;;;;;kBAInD,CAAC;AAEZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,OAAO,CACpD,4BAA4B,EAC5B,WAAW,GAAG,SAAS,CACxB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,mCAAmC,CAC3C,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CACtD,OAAO,wCAAwC,CAChD,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,oCAAoC,CAC5C,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,qCAAqC,CAC7C,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,oCAAoC,CAC5C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,sCAAsC,CAC9C,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAC/C,+BAA+B,GAAG;IAChC,MAAM,EAAE,4BAA4B,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,6BAA6B,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEJ,MAAM,MAAM,2CAA2C,GAAG,CAAC,CAAC,KAAK,CAC/D,OAAO,iDAAiD,CACzD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,oCAAoC;IACnD,UAAU,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,cAAc,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,UAAU,CAAC,KAAK,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,qBAAqB,CACnB,KAAK,EAAE,2CAA2C,GACjD,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,MAAM,0CAA0C,GAAG;IACvD,KAAK,EAAE,4BAA4B,CAAC;IACpC,KAAK,EAAE,oCAAoC,CAAC;IAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAAC,SAAS,gCAAgC,GACpE,IAAI,CAAC,CAAC,EAAE,MAAM,8BAA8B,GAAG,WAAW,CAAC,GAC3D,KAAK,CAAC;AAEV,MAAM,MAAM,oCAAoC,GAAG;IACjD,KAAK,EAAE,0BAA0B,CAAC;IAClC,UAAU,EAAE,mBAAmB,CAAC,gCAAgC,CAAC,CAAC;CACnE,CAAC"}

package/dist/conversation/lifecycle-types.js

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import { ExecutionHostConversationTurnRequestSchema, ExecutionScopeSchema, OpaqueIdSchema, TimestampSchema, } from '../contracts/index.js';
+export const HOSTED_CONVERSATION_TURN_STATUSES = [
+    'requested',
+    'running',
+    'completed',
+    'max_steps',
+    'failed',
+    'cancelled',
+    'interrupted',
+];
+export const HOSTED_CONVERSATION_FAILED_CODES = [
+    'execution_error',
+    'execution_failed',
+    'execution_result_error',
+    'host_protocol_error',
+    'host_rejected',
+    'model_authentication',
+    'model_context_window',
+    'model_empty_response',
+    'model_permission',
+    'model_quota',
+    'model_rate_limit',
+    'model_request',
+    'model_transport',
+    'model_unknown',
+];
+export const HOSTED_CONVERSATION_INTERRUPTED_CODES = [
+    'deadline_elapsed',
+    'execution_interrupted',
+    'invocation_aborted',
+    'stream_ended_without_terminal',
+    'stream_interrupted',
+];
+export const HOSTED_CONVERSATION_CANCELLED_CODES = [
+    'invocation_cancelled',
+];
+export const HOSTED_CONVERSATION_FAILURE_CODES = [
+    ...HOSTED_CONVERSATION_FAILED_CODES,
+    ...HOSTED_CONVERSATION_INTERRUPTED_CODES,
+    ...HOSTED_CONVERSATION_CANCELLED_CODES,
+];
+export const HostedConversationTurnStatusSchema = z.enum(HOSTED_CONVERSATION_TURN_STATUSES);
+export const HostedConversationFailureCodeSchema = z.enum(HOSTED_CONVERSATION_FAILURE_CODES);
+export const HostedConversationPersistenceScopeSchema = ExecutionScopeSchema.omit({ adopterId: true });
+export const HostedConversationTurnIdentitySchema = z.object({
+    invocationId: OpaqueIdSchema,
+    scope: HostedConversationPersistenceScopeSchema,
+}).strict();
+export const HostedConversationRequestedTurnSchema = HostedConversationTurnIdentitySchema.extend({
+    prompt: ExecutionHostConversationTurnRequestSchema.shape.prompt,
+    deadlineAt: ExecutionHostConversationTurnRequestSchema.shape.deadlineAt,
+    requestedAt: TimestampSchema,
+}).strict();
+export const HostedConversationAcceptedTurnSchema = HostedConversationTurnIdentitySchema.extend({
+    runId: OpaqueIdSchema,
+    acceptedAt: TimestampSchema,
+}).strict();
+const SummarySchema = z.string().max(1_000_000);
+const SettlementBaseSchema = HostedConversationTurnIdentitySchema.extend({
+    settledAt: TimestampSchema,
+});
+export const HostedConversationTurnSettlementSchema = z.discriminatedUnion('status', [
+    SettlementBaseSchema.extend({
+        status: z.literal('completed'),
+        summary: SummarySchema.optional(),
+    }).strict(),
+    SettlementBaseSchema.extend({
+        status: z.literal('max_steps'),
+        summary: SummarySchema.optional(),
+    }).strict(),
+    SettlementBaseSchema.extend({
+        status: z.literal('failed'),
+        summary: SummarySchema.optional(),
+        failureCode: z.enum(HOSTED_CONVERSATION_FAILED_CODES),
+    }).strict(),
+    SettlementBaseSchema.extend({
+        status: z.literal('cancelled'),
+        failureCode: z.literal(HOSTED_CONVERSATION_CANCELLED_CODES[0]),
+    }).strict(),
+    SettlementBaseSchema.extend({
+        status: z.literal('interrupted'),
+        summary: SummarySchema.optional(),
+        failureCode: z.enum(HOSTED_CONVERSATION_INTERRUPTED_CODES),
+    }).strict(),
+]);
+export const HostedConversationExpiredTurnReconciliationSchema = z.object({
+    scope: HostedConversationPersistenceScopeSchema,
+    expiredBefore: TimestampSchema,
+    settledAt: TimestampSchema,
+}).strict();
+//# sourceMappingURL=lifecycle-types.js.map

package/dist/conversation/lifecycle-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-types.js","sourceRoot":"","sources":["../../src/conversation/lifecycle-types.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport {\n  ExecutionHostConversationTurnRequestSchema,\n  ExecutionScopeSchema,\n  OpaqueIdSchema,\n  TimestampSchema,\n  type ExecutionHostTerminalEvent,\n} from '../contracts/index.js';\nimport type {\n  HostedConversationTurnRunner,\n} from './types.js';\n\nexport const HOSTED_CONVERSATION_TURN_STATUSES = [\n  'requested',\n  'running',\n  'completed',\n  'max_steps',\n  'failed',\n  'cancelled',\n  'interrupted',\n] as const;\n\nexport const HOSTED_CONVERSATION_FAILED_CODES = [\n  'execution_error',\n  'execution_failed',\n  'execution_result_error',\n  'host_protocol_error',\n  'host_rejected',\n  'model_authentication',\n  'model_context_window',\n  'model_empty_response',\n  'model_permission',\n  'model_quota',\n  'model_rate_limit',\n  'model_request',\n  'model_transport',\n  'model_unknown',\n] as const;\n\nexport const HOSTED_CONVERSATION_INTERRUPTED_CODES = [\n  'deadline_elapsed',\n  'execution_interrupted',\n  'invocation_aborted',\n  'stream_ended_without_terminal',\n  'stream_interrupted',\n] as const;\n\nexport const HOSTED_CONVERSATION_CANCELLED_CODES = [\n  'invocation_cancelled',\n] as const;\n\nexport const HOSTED_CONVERSATION_FAILURE_CODES = [\n  ...HOSTED_CONVERSATION_FAILED_CODES,\n  ...HOSTED_CONVERSATION_INTERRUPTED_CODES,\n  ...HOSTED_CONVERSATION_CANCELLED_CODES,\n] as const;\n\nexport const HostedConversationTurnStatusSchema = z.enum(\n  HOSTED_CONVERSATION_TURN_STATUSES,\n);\nexport const HostedConversationFailureCodeSchema = z.enum(\n  HOSTED_CONVERSATION_FAILURE_CODES,\n);\nexport const HostedConversationPersistenceScopeSchema =\n  ExecutionScopeSchema.omit({ adopterId: true });\nexport const HostedConversationTurnIdentitySchema = z.object({\n  invocationId: OpaqueIdSchema,\n  scope: HostedConversationPersistenceScopeSchema,\n}).strict();\nexport const HostedConversationRequestedTurnSchema =\n  HostedConversationTurnIdentitySchema.extend({\n    prompt: ExecutionHostConversationTurnRequestSchema.shape.prompt,\n    deadlineAt:\n      ExecutionHostConversationTurnRequestSchema.shape.deadlineAt,\n    requestedAt: TimestampSchema,\n  }).strict();\nexport const HostedConversationAcceptedTurnSchema =\n  HostedConversationTurnIdentitySchema.extend({\n    runId: OpaqueIdSchema,\n    acceptedAt: TimestampSchema,\n  }).strict();\n\nconst SummarySchema = z.string().max(1_000_000);\nconst SettlementBaseSchema = HostedConversationTurnIdentitySchema.extend({\n  settledAt: TimestampSchema,\n});\n\nexport const HostedConversationTurnSettlementSchema = z.discriminatedUnion(\n  'status',\n  [\n    SettlementBaseSchema.extend({\n      status: z.literal('completed'),\n      summary: SummarySchema.optional(),\n    }).strict(),\n    SettlementBaseSchema.extend({\n      status: z.literal('max_steps'),\n      summary: SummarySchema.optional(),\n    }).strict(),\n    SettlementBaseSchema.extend({\n      status: z.literal('failed'),\n      summary: SummarySchema.optional(),\n      failureCode: z.enum(HOSTED_CONVERSATION_FAILED_CODES),\n    }).strict(),\n    SettlementBaseSchema.extend({\n      status: z.literal('cancelled'),\n      failureCode: z.literal(HOSTED_CONVERSATION_CANCELLED_CODES[0]),\n    }).strict(),\n    SettlementBaseSchema.extend({\n      status: z.literal('interrupted'),\n      summary: SummarySchema.optional(),\n      failureCode: z.enum(HOSTED_CONVERSATION_INTERRUPTED_CODES),\n    }).strict(),\n  ],\n);\n\nexport const HostedConversationExpiredTurnReconciliationSchema = z.object({\n  scope: HostedConversationPersistenceScopeSchema,\n  expiredBefore: TimestampSchema,\n  settledAt: TimestampSchema,\n}).strict();\n\nexport type HostedConversationTurnStatus = z.infer<\n  typeof HostedConversationTurnStatusSchema\n>;\n\nexport type HostedConversationTerminalStatus = Exclude<\n  HostedConversationTurnStatus,\n  'requested' | 'running'\n>;\n\nexport type HostedConversationFailureCode = z.infer<\n  typeof HostedConversationFailureCodeSchema\n>;\n\nexport type HostedConversationPersistenceScope = z.infer<\n  typeof HostedConversationPersistenceScopeSchema\n>;\n\nexport type HostedConversationTurnIdentity = z.infer<\n  typeof HostedConversationTurnIdentitySchema\n>;\n\nexport type HostedConversationRequestedTurn = z.infer<\n  typeof HostedConversationRequestedTurnSchema\n>;\n\nexport type HostedConversationAcceptedTurn = z.infer<\n  typeof HostedConversationAcceptedTurnSchema\n>;\n\nexport type HostedConversationTurnSettlement = z.infer<\n  typeof HostedConversationTurnSettlementSchema\n>;\n\nexport type HostedConversationTurnLifecycleRecord =\n  HostedConversationRequestedTurn & {\n    status: HostedConversationTurnStatus;\n    runId?: string;\n    summary?: string;\n    failureCode?: HostedConversationFailureCode;\n    acceptedAt?: string;\n    settledAt?: string;\n  };\n\nexport type HostedConversationExpiredTurnReconciliation = z.infer<\n  typeof HostedConversationExpiredTurnReconciliationSchema\n>;\n\n/**\n * Durable write port for the generic hosted-turn lifecycle.\n *\n * Implementations must fence every mutation by invocation and full scope.\n * Creation rejects every duplicate invocation so a repeated request cannot\n * start execution twice. Accepted and terminal writes allow only an exact\n * repeat; conflicting or late transitions must fail atomically. The port\n * deliberately cannot carry activity, raw errors, credentials, or tool data.\n */\nexport interface HostedConversationTurnLifecycleStore {\n  createTurn(input: HostedConversationRequestedTurn): Promise<void>;\n  recordAccepted(input: HostedConversationAcceptedTurn): Promise<void>;\n  settleTurn(input: HostedConversationTurnSettlement): Promise<void>;\n  interruptExpiredTurns(\n    input: HostedConversationExpiredTurnReconciliation,\n  ): Promise<void>;\n}\n\nexport type DurableHostedConversationTurnServiceConfig = {\n  turns: HostedConversationTurnRunner;\n  store: HostedConversationTurnLifecycleStore;\n  maxSummaryCharacters?: number;\n  expiredTurnGraceMs?: number;\n};\n\nexport type DurableHostedConversationTurnServiceOptions = {\n  now?: () => Date;\n};\n\nexport type HostedConversationTurnReconciliationOptions = {\n  expiredTurnGraceMs?: number;\n  now?: () => Date;\n};\n\ntype ProjectedSettlement<T> = T extends HostedConversationTurnSettlement\n  ? Omit<T, keyof HostedConversationTurnIdentity | 'settledAt'>\n  : never;\n\nexport type HostedConversationTerminalProjection = {\n  event: ExecutionHostTerminalEvent;\n  settlement: ProjectedSettlement<HostedConversationTurnSettlement>;\n};\n"]}

package/dist/conversation/types.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { type ExecutionHostStreamEvent } from '../contracts/index.js';
+import type { ExecutionAuthority } from '../authority/index.js';
+import type { ExecutionHost } from '../http-sse/index.js';
+export declare const HostedConversationTurnInputSchema: z.ZodObject<{
+    scope: z.ZodObject<{
+        tenantId: z.ZodString;
+        subjectId: z.ZodString;
+        productSessionId: z.ZodString;
+    }, z.core.$strict>;
+    runtimeSessionId: z.ZodString;
+    invocationId: z.ZodString;
+    prompt: z.ZodString;
+    deadlineAt: z.ZodOptional<z.ZodISODateTime>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+}, z.core.$strict>;
+export type HostedConversationTurnInput = z.infer<typeof HostedConversationTurnInputSchema>;
+export type HostedConversationCredentialContext = Pick<HostedConversationTurnInput, 'scope' | 'invocationId' | 'signal'>;
+/** Resolves model authority without exposing it to HTTP or product data. */
+export interface HostedConversationModelCredentialProvider {
+    resolveModelApiKey(context: HostedConversationCredentialContext): Promise<string>;
+}
+export interface HostedConversationTurnRunner {
+    streamTurn(input: HostedConversationTurnInput): AsyncIterable<ExecutionHostStreamEvent>;
+}
+export type HostedConversationTurnServiceConfig = {
+    authority: ExecutionAuthority;
+    executionHost: ExecutionHost;
+    modelCredentials: HostedConversationModelCredentialProvider;
+    /** Omit this policy when the hosted workflow needs no product MCP tools. */
+    mcp?: {
+        allowedTools: readonly string[];
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/conversation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/conversation/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,eAAO,MAAM,iCAAiC;;;;;;;;;;;kBAUnC,CAAC;AAEZ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,iCAAiC,CACzC,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG,IAAI,CACpD,2BAA2B,EAC3B,OAAO,GAAG,cAAc,GAAG,QAAQ,CACpC,CAAC;AAEF,4EAA4E;AAC5E,MAAM,WAAW,yCAAyC;IACxD,kBAAkB,CAChB,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CACR,KAAK,EAAE,2BAA2B,GACjC,aAAa,CAAC,wBAAwB,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,mCAAmC,GAAG;IAChD,SAAS,EAAE,kBAAkB,CAAC;IAC9B,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,yCAAyC,CAAC;IAC5D,4EAA4E;IAC5E,GAAG,CAAC,EAAE;QACJ,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;KACjC,CAAC;CACH,CAAC"}

package/dist/conversation/types.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import { ExecutionHostConversationTurnRequestSchema, ExecutionScopeSchema, RuntimeSessionIdSchema, } from '../contracts/index.js';
+export const HostedConversationTurnInputSchema = z.object({
+    scope: ExecutionScopeSchema.omit({ adopterId: true }),
+    runtimeSessionId: RuntimeSessionIdSchema,
+    invocationId: ExecutionHostConversationTurnRequestSchema.shape.invocationId,
+    prompt: ExecutionHostConversationTurnRequestSchema.shape.prompt,
+    deadlineAt: ExecutionHostConversationTurnRequestSchema.shape.deadlineAt,
+    signal: z.custom((value) => value instanceof AbortSignal, 'signal must be an AbortSignal').optional(),
+}).strict();
+//# sourceMappingURL=types.js.map

package/dist/conversation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/conversation/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,0CAA0C,EAC1C,oBAAoB,EACpB,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,KAAK,EAAE,oBAAoB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrD,gBAAgB,EAAE,sBAAsB;IACxC,YAAY,EAAE,0CAA0C,CAAC,KAAK,CAAC,YAAY;IAC3E,MAAM,EAAE,0CAA0C,CAAC,KAAK,CAAC,MAAM;IAC/D,UAAU,EAAE,0CAA0C,CAAC,KAAK,CAAC,UAAU;IACvE,MAAM,EAAE,CAAC,CAAC,MAAM,CACd,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,WAAW,EACvC,+BAA+B,CAChC,CAAC,QAAQ,EAAE;CACb,CAAC,CAAC,MAAM,EAAE,CAAC","sourcesContent":["import { z } from 'zod';\nimport {\n  ExecutionHostConversationTurnRequestSchema,\n  ExecutionScopeSchema,\n  RuntimeSessionIdSchema,\n  type ExecutionHostStreamEvent,\n} from '../contracts/index.js';\nimport type { ExecutionAuthority } from '../authority/index.js';\nimport type { ExecutionHost } from '../http-sse/index.js';\n\nexport const HostedConversationTurnInputSchema = z.object({\n  scope: ExecutionScopeSchema.omit({ adopterId: true }),\n  runtimeSessionId: RuntimeSessionIdSchema,\n  invocationId: ExecutionHostConversationTurnRequestSchema.shape.invocationId,\n  prompt: ExecutionHostConversationTurnRequestSchema.shape.prompt,\n  deadlineAt: ExecutionHostConversationTurnRequestSchema.shape.deadlineAt,\n  signal: z.custom<AbortSignal>(\n    (value) => value instanceof AbortSignal,\n    'signal must be an AbortSignal',\n  ).optional(),\n}).strict();\n\nexport type HostedConversationTurnInput = z.infer<\n  typeof HostedConversationTurnInputSchema\n>;\n\nexport type HostedConversationCredentialContext = Pick<\n  HostedConversationTurnInput,\n  'scope' | 'invocationId' | 'signal'\n>;\n\n/** Resolves model authority without exposing it to HTTP or product data. */\nexport interface HostedConversationModelCredentialProvider {\n  resolveModelApiKey(\n    context: HostedConversationCredentialContext,\n  ): Promise<string>;\n}\n\nexport interface HostedConversationTurnRunner {\n  streamTurn(\n    input: HostedConversationTurnInput,\n  ): AsyncIterable<ExecutionHostStreamEvent>;\n}\n\nexport type HostedConversationTurnServiceConfig = {\n  authority: ExecutionAuthority;\n  executionHost: ExecutionHost;\n  modelCredentials: HostedConversationModelCredentialProvider;\n  /** Omit this policy when the hosted workflow needs no product MCP tools. */\n  mcp?: {\n    allowedTools: readonly string[];\n  };\n};\n"]}

package/dist/http-sse/direct-http-execution-host.d.ts

@@ -0,0 +1,12 @@
+import { type ExecutionHostStreamEvent } from '../contracts/index.js';
+import type { DirectHttpExecutionHostConfig, ExecutionHost, ExecutionHostConversationTurn } from './types.js';
+/**
+ * Strict direct-development HTTP/SSE adapter for the Execution Host v1 wire.
+ * It deliberately owns neither AWS SDK nor SigV4 behavior.
+ */
+export declare class DirectHttpExecutionHost implements ExecutionHost {
+    #private;
+    constructor(config: DirectHttpExecutionHostConfig);
+    streamConversationTurn(rawInput: ExecutionHostConversationTurn): AsyncIterable<ExecutionHostStreamEvent>;
+}
+//# sourceMappingURL=direct-http-execution-host.d.ts.map

package/dist/http-sse/direct-http-execution-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-http-execution-host.d.ts","sourceRoot":"","sources":["../../src/http-sse/direct-http-execution-host.ts"],"names":[],"mappings":"AAEA,OAAO,EAeL,KAAK,wBAAwB,EAC9B,MAAM,uBAAuB,CAAC;AAO/B,OAAO,KAAK,EACV,6BAA6B,EAC7B,aAAa,EACb,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AA0BpB;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,aAAa;;gBAK/C,MAAM,EAAE,6BAA6B;IAO1C,sBAAsB,CAC3B,QAAQ,EAAE,6BAA6B,GACtC,aAAa,CAAC,wBAAwB,CAAC;CAuH3C"}

package/dist/http-sse/direct-http-execution-host.js

@@ -0,0 +1,279 @@
+import { createParser } from 'eventsource-parser';
+import { z } from 'zod';
+import { AGENTCORE_RUNTIME_SESSION_HEADER, CONVERSATION_TURN_WORKFLOW, EXECUTION_ASSERTION_HEADER, EXECUTION_CONTRACT_VERSION, EXECUTION_HOST_LOCAL_TOKEN_HEADER, ExecutionHostConversationTurnRequestSchema, ExecutionHostStreamEventSchema, MCP_CAPABILITY_HEADER, MODEL_API_KEY_HEADER, OpaqueIdSchema, RuntimeSessionIdSchema, TimestampSchema, isExecutionHostTerminalEvent, isSafeWebUrl, } from '../contracts/index.js';
+import { ExecutionHostInvocationCancelledError, ExecutionHostProtocolError, ExecutionHostRejectedError, ExecutionHostStreamInterruptedError, } from './errors.js';
+const MAX_SSE_BUFFER_CHARACTERS = 1_048_576;
+const MAX_PENDING_SSE_FRAMES = 1_024;
+const MAX_ERROR_BODY_BYTES = 16_384;
+const SecretSchema = z.string().min(8).max(4_096);
+const ConversationTurnSchema = z.object({
+    invocationId: OpaqueIdSchema,
+    runtimeSessionId: RuntimeSessionIdSchema,
+    prompt: z.string().trim().min(1).max(200_000),
+    deadlineAt: TimestampSchema.optional(),
+    executionAssertion: z.string().min(32).max(4_096),
+    mcpCapability: z.string().min(32).max(4_096).optional(),
+    modelApiKey: SecretSchema,
+    signal: z.custom((value) => value instanceof AbortSignal, 'signal must be an AbortSignal').optional(),
+}).strict();
+const ApiErrorSchema = z.object({
+    error: z.object({
+        code: z.string().min(1).max(128).regex(/^[a-z0-9_]+$/),
+        message: z.string(),
+    }).strict(),
+}).strict();
+/**
+ * Strict direct-development HTTP/SSE adapter for the Execution Host v1 wire.
+ * It deliberately owns neither AWS SDK nor SigV4 behavior.
+ */
+export class DirectHttpExecutionHost {
+    #endpoint;
+    #fetch;
+    #localToken;
+    constructor(config) {
+        assertSafeBaseUrl(config.baseUrl);
+        this.#localToken = SecretSchema.parse(config.localToken);
+        this.#endpoint = new URL('invocations', withTrailingSlash(config.baseUrl));
+        this.#fetch = config.fetch ?? globalThis.fetch;
+    }
+    async *streamConversationTurn(rawInput) {
+        const input = ConversationTurnSchema.parse(rawInput);
+        if (input.signal?.aborted) {
+            throw new ExecutionHostInvocationCancelledError();
+        }
+        const response = await this.#invoke(input);
+        if (!response.ok) {
+            throw new ExecutionHostRejectedError(response.status, await readSafeErrorCode(response));
+        }
+        if (!isEventStream(response.headers.get('content-type'))) {
+            await cancelBody(response);
+            throw new ExecutionHostProtocolError('Execution Host did not return an SSE stream.');
+        }
+        if (!response.body) {
+            throw new ExecutionHostProtocolError('Execution Host returned an empty SSE response body.');
+        }
+        const state = {
+            invocationId: input.invocationId,
+            nextSequence: 0,
+            terminal: false,
+        };
+        const decoder = new TextDecoder();
+        const pending = [];
+        let terminalEvent;
+        let parserError = false;
+        const parser = createParser({
+            maxBufferSize: MAX_SSE_BUFFER_CHARACTERS,
+            onEvent: (event) => {
+                if (pending.length >= MAX_PENDING_SSE_FRAMES) {
+                    parserError = true;
+                    return;
+                }
+                pending.push(event);
+            },
+            onError: () => {
+                parserError = true;
+            },
+        });
+        try {
+            for await (const chunk of response.body) {
+                input.signal?.throwIfAborted();
+                parser.feed(decoder.decode(chunk, { stream: true }));
+                if (parserError) {
+                    throw new ExecutionHostProtocolError();
+                }
+                while (pending.length > 0) {
+                    const event = validateEvent(pending.shift(), state);
+                    if (isExecutionHostTerminalEvent(event)) {
+                        terminalEvent = event;
+                    }
+                    else {
+                        yield event;
+                    }
+                }
+            }
+            parser.feed(decoder.decode());
+            parser.reset({ consume: true });
+            if (parserError) {
+                throw new ExecutionHostProtocolError();
+            }
+            while (pending.length > 0) {
+                const event = validateEvent(pending.shift(), state);
+                if (isExecutionHostTerminalEvent(event)) {
+                    terminalEvent = event;
+                }
+                else {
+                    yield event;
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof ExecutionHostProtocolError) {
+                throw error;
+            }
+            throw toTransportError(error, input.signal);
+        }
+        if (!state.accepted) {
+            throw new ExecutionHostProtocolError('Execution Host stream omitted the accepted event.');
+        }
+        if (!state.terminal || !terminalEvent) {
+            throw new ExecutionHostStreamInterruptedError();
+        }
+        // Terminal is released only after clean EOF, so a trailing malformed or
+        // post-terminal frame cannot be projected as success.
+        yield terminalEvent;
+    }
+    async #invoke(input) {
+        const body = ExecutionHostConversationTurnRequestSchema.parse({
+            schemaVersion: EXECUTION_CONTRACT_VERSION,
+            kind: CONVERSATION_TURN_WORKFLOW,
+            invocationId: input.invocationId,
+            prompt: input.prompt,
+            ...(input.deadlineAt ? { deadlineAt: input.deadlineAt } : {}),
+        });
+        try {
+            return await this.#fetch(this.#endpoint, {
+                method: 'POST',
+                redirect: 'error',
+                signal: input.signal,
+                headers: createSensitiveHeaders(input, this.#localToken),
+                body: JSON.stringify(body),
+            });
+        }
+        catch (error) {
+            throw toTransportError(error, input.signal);
+        }
+    }
+}
+function validateEvent(frame, state) {
+    let decoded;
+    try {
+        decoded = JSON.parse(frame.data);
+    }
+    catch {
+        throw new ExecutionHostProtocolError();
+    }
+    const parsed = ExecutionHostStreamEventSchema.safeParse(decoded);
+    if (!parsed.success) {
+        throw new ExecutionHostProtocolError();
+    }
+    const event = parsed.data;
+    const correctFrameMetadata = frame.event === event.kind
+        && frame.id === String(event.sequence);
+    const correctEnvelope = event.invocationId === state.invocationId
+        && event.sequence === state.nextSequence;
+    if (!correctFrameMetadata || !correctEnvelope || state.terminal) {
+        throw new ExecutionHostProtocolError();
+    }
+    if (!state.accepted) {
+        if (event.kind !== 'accepted') {
+            throw new ExecutionHostProtocolError();
+        }
+        state.accepted = true;
+        state.runId = event.runId;
+    }
+    else if (event.kind === 'accepted' || event.runId !== state.runId) {
+        throw new ExecutionHostProtocolError();
+    }
+    state.nextSequence += 1;
+    state.terminal = isExecutionHostTerminalEvent(event);
+    return event;
+}
+function createSensitiveHeaders(input, localToken) {
+    const headers = new Headers({
+        Accept: 'text/event-stream',
+        'Content-Type': 'application/json',
+        [AGENTCORE_RUNTIME_SESSION_HEADER]: input.runtimeSessionId,
+        [EXECUTION_HOST_LOCAL_TOKEN_HEADER]: localToken,
+        [MODEL_API_KEY_HEADER]: input.modelApiKey,
+        [EXECUTION_ASSERTION_HEADER]: input.executionAssertion,
+    });
+    if (input.mcpCapability) {
+        headers.set(MCP_CAPABILITY_HEADER, input.mcpCapability);
+    }
+    return headers;
+}
+function isEventStream(contentType) {
+    return contentType?.split(';', 1)[0]?.trim().toLowerCase()
+        === 'text/event-stream';
+}
+async function readSafeErrorCode(response) {
+    try {
+        const declaredLength = Number(response.headers.get('content-length'));
+        if (Number.isFinite(declaredLength)
+            && declaredLength > MAX_ERROR_BODY_BYTES) {
+            await cancelBody(response);
+            return 'unknown';
+        }
+        const bytes = await readBoundedBody(response, MAX_ERROR_BODY_BYTES);
+        if (!bytes) {
+            return 'unknown';
+        }
+        const parsed = ApiErrorSchema.safeParse(JSON.parse(new TextDecoder().decode(bytes)));
+        return parsed.success ? parsed.data.error.code : 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+async function readBoundedBody(response, maxBytes) {
+    if (!response.body) {
+        return new Uint8Array();
+    }
+    const reader = response.body.getReader();
+    const chunks = [];
+    let totalBytes = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+                break;
+            }
+            totalBytes += value.byteLength;
+            if (totalBytes > maxBytes) {
+                await reader.cancel();
+                return undefined;
+            }
+            chunks.push(value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const bytes = new Uint8Array(totalBytes);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return bytes;
+}
+async function cancelBody(response) {
+    try {
+        await response.body?.cancel();
+    }
+    catch {
+        // Response cleanup is best effort and must not replace the protocol error.
+    }
+}
+function toTransportError(error, signal) {
+    if (signal?.aborted || isAbortError(error)) {
+        return new ExecutionHostInvocationCancelledError();
+    }
+    return new ExecutionHostStreamInterruptedError();
+}
+function isAbortError(error) {
+    return error instanceof Error && error.name === 'AbortError';
+}
+function assertSafeBaseUrl(url) {
+    if (!isSafeWebUrl(url)) {
+        throw new Error('Direct Execution Host URL must use HTTPS or loopback HTTP and contain no credentials, query, or fragment.');
+    }
+}
+function withTrailingSlash(url) {
+    const normalized = new URL(url);
+    normalized.pathname = normalized.pathname.endsWith('/')
+        ? normalized.pathname
+        : `${normalized.pathname}/`;
+    return normalized;
+}
+//# sourceMappingURL=direct-http-execution-host.js.map

package/dist/http-sse/direct-http-execution-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-http-execution-host.js","sourceRoot":"","sources":["../../src/http-sse/direct-http-execution-host.ts"],"names":[],"mappings":"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","sourcesContent":["import { createParser, type EventSourceMessage } from 'eventsource-parser';\nimport { z } from 'zod';\nimport {\n  AGENTCORE_RUNTIME_SESSION_HEADER,\n  CONVERSATION_TURN_WORKFLOW,\n  EXECUTION_ASSERTION_HEADER,\n  EXECUTION_CONTRACT_VERSION,\n  EXECUTION_HOST_LOCAL_TOKEN_HEADER,\n  ExecutionHostConversationTurnRequestSchema,\n  ExecutionHostStreamEventSchema,\n  MCP_CAPABILITY_HEADER,\n  MODEL_API_KEY_HEADER,\n  OpaqueIdSchema,\n  RuntimeSessionIdSchema,\n  TimestampSchema,\n  isExecutionHostTerminalEvent,\n  isSafeWebUrl,\n  type ExecutionHostStreamEvent,\n} from '../contracts/index.js';\nimport {\n  ExecutionHostInvocationCancelledError,\n  ExecutionHostProtocolError,\n  ExecutionHostRejectedError,\n  ExecutionHostStreamInterruptedError,\n} from './errors.js';\nimport type {\n  DirectHttpExecutionHostConfig,\n  ExecutionHost,\n  ExecutionHostConversationTurn,\n} from './types.js';\n\nconst MAX_SSE_BUFFER_CHARACTERS = 1_048_576;\nconst MAX_PENDING_SSE_FRAMES = 1_024;\nconst MAX_ERROR_BODY_BYTES = 16_384;\nconst SecretSchema = z.string().min(8).max(4_096);\nconst ConversationTurnSchema = z.object({\n  invocationId: OpaqueIdSchema,\n  runtimeSessionId: RuntimeSessionIdSchema,\n  prompt: z.string().trim().min(1).max(200_000),\n  deadlineAt: TimestampSchema.optional(),\n  executionAssertion: z.string().min(32).max(4_096),\n  mcpCapability: z.string().min(32).max(4_096).optional(),\n  modelApiKey: SecretSchema,\n  signal: z.custom<AbortSignal>(\n    (value) => value instanceof AbortSignal,\n    'signal must be an AbortSignal',\n  ).optional(),\n}).strict();\nconst ApiErrorSchema = z.object({\n  error: z.object({\n    code: z.string().min(1).max(128).regex(/^[a-z0-9_]+$/),\n    message: z.string(),\n  }).strict(),\n}).strict();\n\n/**\n * Strict direct-development HTTP/SSE adapter for the Execution Host v1 wire.\n * It deliberately owns neither AWS SDK nor SigV4 behavior.\n */\nexport class DirectHttpExecutionHost implements ExecutionHost {\n  readonly #endpoint: URL;\n  readonly #fetch: typeof fetch;\n  readonly #localToken: string;\n\n  constructor(config: DirectHttpExecutionHostConfig) {\n    assertSafeBaseUrl(config.baseUrl);\n    this.#localToken = SecretSchema.parse(config.localToken);\n    this.#endpoint = new URL('invocations', withTrailingSlash(config.baseUrl));\n    this.#fetch = config.fetch ?? globalThis.fetch;\n  }\n\n  async *streamConversationTurn(\n    rawInput: ExecutionHostConversationTurn,\n  ): AsyncIterable<ExecutionHostStreamEvent> {\n    const input = ConversationTurnSchema.parse(rawInput);\n    if (input.signal?.aborted) {\n      throw new ExecutionHostInvocationCancelledError();\n    }\n\n    const response = await this.#invoke(input);\n    if (!response.ok) {\n      throw new ExecutionHostRejectedError(\n        response.status,\n        await readSafeErrorCode(response),\n      );\n    }\n    if (!isEventStream(response.headers.get('content-type'))) {\n      await cancelBody(response);\n      throw new ExecutionHostProtocolError(\n        'Execution Host did not return an SSE stream.',\n      );\n    }\n    if (!response.body) {\n      throw new ExecutionHostProtocolError(\n        'Execution Host returned an empty SSE response body.',\n      );\n    }\n\n    const state: StreamValidationState = {\n      invocationId: input.invocationId,\n      nextSequence: 0,\n      terminal: false,\n    };\n    const decoder = new TextDecoder();\n    const pending: EventSourceMessage[] = [];\n    let terminalEvent: ExecutionHostStreamEvent | undefined;\n    let parserError = false;\n    const parser = createParser({\n      maxBufferSize: MAX_SSE_BUFFER_CHARACTERS,\n      onEvent: (event) => {\n        if (pending.length >= MAX_PENDING_SSE_FRAMES) {\n          parserError = true;\n          return;\n        }\n        pending.push(event);\n      },\n      onError: () => {\n        parserError = true;\n      },\n    });\n\n    try {\n      for await (const chunk of response.body) {\n        input.signal?.throwIfAborted();\n        parser.feed(decoder.decode(chunk, { stream: true }));\n        if (parserError) {\n          throw new ExecutionHostProtocolError();\n        }\n        while (pending.length > 0) {\n          const event = validateEvent(pending.shift()!, state);\n          if (isExecutionHostTerminalEvent(event)) {\n            terminalEvent = event;\n          } else {\n            yield event;\n          }\n        }\n      }\n      parser.feed(decoder.decode());\n      parser.reset({ consume: true });\n      if (parserError) {\n        throw new ExecutionHostProtocolError();\n      }\n      while (pending.length > 0) {\n        const event = validateEvent(pending.shift()!, state);\n        if (isExecutionHostTerminalEvent(event)) {\n          terminalEvent = event;\n        } else {\n          yield event;\n        }\n      }\n    } catch (error) {\n      if (error instanceof ExecutionHostProtocolError) {\n        throw error;\n      }\n      throw toTransportError(error, input.signal);\n    }\n\n    if (!state.accepted) {\n      throw new ExecutionHostProtocolError(\n        'Execution Host stream omitted the accepted event.',\n      );\n    }\n    if (!state.terminal || !terminalEvent) {\n      throw new ExecutionHostStreamInterruptedError();\n    }\n    // Terminal is released only after clean EOF, so a trailing malformed or\n    // post-terminal frame cannot be projected as success.\n    yield terminalEvent;\n  }\n\n  async #invoke(\n    input: z.infer<typeof ConversationTurnSchema>,\n  ): Promise<Response> {\n    const body = ExecutionHostConversationTurnRequestSchema.parse({\n      schemaVersion: EXECUTION_CONTRACT_VERSION,\n      kind: CONVERSATION_TURN_WORKFLOW,\n      invocationId: input.invocationId,\n      prompt: input.prompt,\n      ...(input.deadlineAt ? { deadlineAt: input.deadlineAt } : {}),\n    });\n    try {\n      return await this.#fetch(this.#endpoint, {\n        method: 'POST',\n        redirect: 'error',\n        signal: input.signal,\n        headers: createSensitiveHeaders(input, this.#localToken),\n        body: JSON.stringify(body),\n      });\n    } catch (error) {\n      throw toTransportError(error, input.signal);\n    }\n  }\n}\n\ntype StreamValidationState = {\n  invocationId: string;\n  runId?: string;\n  nextSequence: number;\n  accepted?: true;\n  terminal: boolean;\n};\n\nfunction validateEvent(\n  frame: EventSourceMessage,\n  state: StreamValidationState,\n): ExecutionHostStreamEvent {\n  let decoded: unknown;\n  try {\n    decoded = JSON.parse(frame.data);\n  } catch {\n    throw new ExecutionHostProtocolError();\n  }\n  const parsed = ExecutionHostStreamEventSchema.safeParse(decoded);\n  if (!parsed.success) {\n    throw new ExecutionHostProtocolError();\n  }\n  const event = parsed.data;\n  const correctFrameMetadata = frame.event === event.kind\n    && frame.id === String(event.sequence);\n  const correctEnvelope = event.invocationId === state.invocationId\n    && event.sequence === state.nextSequence;\n  if (!correctFrameMetadata || !correctEnvelope || state.terminal) {\n    throw new ExecutionHostProtocolError();\n  }\n\n  if (!state.accepted) {\n    if (event.kind !== 'accepted') {\n      throw new ExecutionHostProtocolError();\n    }\n    state.accepted = true;\n    state.runId = event.runId;\n  } else if (event.kind === 'accepted' || event.runId !== state.runId) {\n    throw new ExecutionHostProtocolError();\n  }\n\n  state.nextSequence += 1;\n  state.terminal = isExecutionHostTerminalEvent(event);\n  return event;\n}\n\nfunction createSensitiveHeaders(\n  input: z.infer<typeof ConversationTurnSchema>,\n  localToken: string,\n): Headers {\n  const headers = new Headers({\n    Accept: 'text/event-stream',\n    'Content-Type': 'application/json',\n    [AGENTCORE_RUNTIME_SESSION_HEADER]: input.runtimeSessionId,\n    [EXECUTION_HOST_LOCAL_TOKEN_HEADER]: localToken,\n    [MODEL_API_KEY_HEADER]: input.modelApiKey,\n    [EXECUTION_ASSERTION_HEADER]: input.executionAssertion,\n  });\n  if (input.mcpCapability) {\n    headers.set(MCP_CAPABILITY_HEADER, input.mcpCapability);\n  }\n  return headers;\n}\n\nfunction isEventStream(contentType: string | null): boolean {\n  return contentType?.split(';', 1)[0]?.trim().toLowerCase()\n    === 'text/event-stream';\n}\n\nasync function readSafeErrorCode(response: Response): Promise<string> {\n  try {\n    const declaredLength = Number(response.headers.get('content-length'));\n    if (\n      Number.isFinite(declaredLength)\n      && declaredLength > MAX_ERROR_BODY_BYTES\n    ) {\n      await cancelBody(response);\n      return 'unknown';\n    }\n    const bytes = await readBoundedBody(response, MAX_ERROR_BODY_BYTES);\n    if (!bytes) {\n      return 'unknown';\n    }\n    const parsed = ApiErrorSchema.safeParse(\n      JSON.parse(new TextDecoder().decode(bytes)),\n    );\n    return parsed.success ? parsed.data.error.code : 'unknown';\n  } catch {\n    return 'unknown';\n  }\n}\n\nasync function readBoundedBody(\n  response: Response,\n  maxBytes: number,\n): Promise<Uint8Array | undefined> {\n  if (!response.body) {\n    return new Uint8Array();\n  }\n  const reader = response.body.getReader();\n  const chunks: Uint8Array[] = [];\n  let totalBytes = 0;\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) {\n        break;\n      }\n      totalBytes += value.byteLength;\n      if (totalBytes > maxBytes) {\n        await reader.cancel();\n        return undefined;\n      }\n      chunks.push(value);\n    }\n  } finally {\n    reader.releaseLock();\n  }\n  const bytes = new Uint8Array(totalBytes);\n  let offset = 0;\n  for (const chunk of chunks) {\n    bytes.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return bytes;\n}\n\nasync function cancelBody(response: Response): Promise<void> {\n  try {\n    await response.body?.cancel();\n  } catch {\n    // Response cleanup is best effort and must not replace the protocol error.\n  }\n}\n\nfunction toTransportError(error: unknown, signal?: AbortSignal): Error {\n  if (signal?.aborted || isAbortError(error)) {\n    return new ExecutionHostInvocationCancelledError();\n  }\n  return new ExecutionHostStreamInterruptedError();\n}\n\nfunction isAbortError(error: unknown): boolean {\n  return error instanceof Error && error.name === 'AbortError';\n}\n\nfunction assertSafeBaseUrl(url: URL): void {\n  if (!isSafeWebUrl(url)) {\n    throw new Error(\n      'Direct Execution Host URL must use HTTPS or loopback HTTP and contain no credentials, query, or fragment.',\n    );\n  }\n}\n\nfunction withTrailingSlash(url: URL): URL {\n  const normalized = new URL(url);\n  normalized.pathname = normalized.pathname.endsWith('/')\n    ? normalized.pathname\n    : `${normalized.pathname}/`;\n  return normalized;\n}\n"]}

package/dist/http-sse/errors.d.ts

@@ -0,0 +1,19 @@
+export declare class ExecutionHostProtocolError extends Error {
+    readonly name = "ExecutionHostProtocolError";
+    constructor(message?: string);
+}
+export declare class ExecutionHostStreamInterruptedError extends Error {
+    readonly name = "ExecutionHostStreamInterruptedError";
+    constructor();
+}
+export declare class ExecutionHostInvocationCancelledError extends Error {
+    readonly name = "ExecutionHostInvocationCancelledError";
+    constructor();
+}
+export declare class ExecutionHostRejectedError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly name = "ExecutionHostRejectedError";
+    constructor(status: number, code: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/http-sse/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/http-sse/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,gCAAgC;gBAEjC,OAAO,SAAkD;CAGtE;AAED,qBAAa,mCAAoC,SAAQ,KAAK;IAC5D,QAAQ,CAAC,IAAI,yCAAyC;;CAKvD;AAED,qBAAa,qCAAsC,SAAQ,KAAK;IAC9D,QAAQ,CAAC,IAAI,2CAA2C;;CAKzD;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IAIjD,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAJvB,QAAQ,CAAC,IAAI,gCAAgC;gBAGlC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;CAIxB"}

package/dist/http-sse/errors.js

@@ -0,0 +1,29 @@
+export class ExecutionHostProtocolError extends Error {
+    name = 'ExecutionHostProtocolError';
+    constructor(message = 'Execution Host returned an invalid v1 stream.') {
+        super(message);
+    }
+}
+export class ExecutionHostStreamInterruptedError extends Error {
+    name = 'ExecutionHostStreamInterruptedError';
+    constructor() {
+        super('Execution Host stream ended without a terminal event.');
+    }
+}
+export class ExecutionHostInvocationCancelledError extends Error {
+    name = 'ExecutionHostInvocationCancelledError';
+    constructor() {
+        super('Execution Host invocation was cancelled.');
+    }
+}
+export class ExecutionHostRejectedError extends Error {
+    status;
+    code;
+    name = 'ExecutionHostRejectedError';
+    constructor(status, code) {
+        super(`Execution Host rejected the invocation (${status}, ${code}).`);
+        this.status = status;
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/http-sse/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/http-sse/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,GAAG,4BAA4B,CAAC;IAE7C,YAAY,OAAO,GAAG,+CAA+C;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAED,MAAM,OAAO,mCAAoC,SAAQ,KAAK;IACnD,IAAI,GAAG,qCAAqC,CAAC;IAEtD;QACE,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACjE,CAAC;CACF;AAED,MAAM,OAAO,qCAAsC,SAAQ,KAAK;IACrD,IAAI,GAAG,uCAAuC,CAAC;IAExD;QACE,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAIxC;IACA;IAJF,IAAI,GAAG,4BAA4B,CAAC;IAE7C,YACW,MAAc,EACd,IAAY;QAErB,KAAK,CAAC,2CAA2C,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC;QAH7D,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;IAGvB,CAAC;CACF","sourcesContent":["export class ExecutionHostProtocolError extends Error {\n  readonly name = 'ExecutionHostProtocolError';\n\n  constructor(message = 'Execution Host returned an invalid v1 stream.') {\n    super(message);\n  }\n}\n\nexport class ExecutionHostStreamInterruptedError extends Error {\n  readonly name = 'ExecutionHostStreamInterruptedError';\n\n  constructor() {\n    super('Execution Host stream ended without a terminal event.');\n  }\n}\n\nexport class ExecutionHostInvocationCancelledError extends Error {\n  readonly name = 'ExecutionHostInvocationCancelledError';\n\n  constructor() {\n    super('Execution Host invocation was cancelled.');\n  }\n}\n\nexport class ExecutionHostRejectedError extends Error {\n  readonly name = 'ExecutionHostRejectedError';\n\n  constructor(\n    readonly status: number,\n    readonly code: string,\n  ) {\n    super(`Execution Host rejected the invocation (${status}, ${code}).`);\n  }\n}\n"]}

package/dist/http-sse/index.d.ts

@@ -0,0 +1,4 @@
+export { DirectHttpExecutionHost } from './direct-http-execution-host.js';
+export { ExecutionHostInvocationCancelledError, ExecutionHostProtocolError, ExecutionHostRejectedError, ExecutionHostStreamInterruptedError, } from './errors.js';
+export type { DirectHttpExecutionHostConfig, ExecutionHost, ExecutionHostConversationTurn, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/http-sse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http-sse/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EACL,qCAAqC,EACrC,0BAA0B,EAC1B,0BAA0B,EAC1B,mCAAmC,GACpC,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,6BAA6B,EAC7B,aAAa,EACb,6BAA6B,GAC9B,MAAM,YAAY,CAAC"}

package/dist/http-sse/index.js

@@ -0,0 +1,3 @@
+export { DirectHttpExecutionHost } from './direct-http-execution-host.js';
+export { ExecutionHostInvocationCancelledError, ExecutionHostProtocolError, ExecutionHostRejectedError, ExecutionHostStreamInterruptedError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/http-sse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http-sse/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EACL,qCAAqC,EACrC,0BAA0B,EAC1B,0BAA0B,EAC1B,mCAAmC,GACpC,MAAM,aAAa,CAAC","sourcesContent":["export { DirectHttpExecutionHost } from './direct-http-execution-host.js';\nexport {\n  ExecutionHostInvocationCancelledError,\n  ExecutionHostProtocolError,\n  ExecutionHostRejectedError,\n  ExecutionHostStreamInterruptedError,\n} from './errors.js';\nexport type {\n  DirectHttpExecutionHostConfig,\n  ExecutionHost,\n  ExecutionHostConversationTurn,\n} from './types.js';\n"]}

package/dist/http-sse/types.d.ts

@@ -0,0 +1,20 @@
+import type { ExecutionHostStreamEvent } from '../contracts/index.js';
+export type ExecutionHostConversationTurn = {
+    invocationId: string;
+    runtimeSessionId: string;
+    prompt: string;
+    deadlineAt?: string;
+    executionAssertion: string;
+    mcpCapability?: string;
+    modelApiKey: string;
+    signal?: AbortSignal;
+};
+export interface ExecutionHost {
+    streamConversationTurn(input: ExecutionHostConversationTurn): AsyncIterable<ExecutionHostStreamEvent>;
+}
+export type DirectHttpExecutionHostConfig = {
+    baseUrl: URL;
+    localToken: string;
+    fetch?: typeof fetch;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/http-sse/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/http-sse/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,sBAAsB,CACpB,KAAK,EAAE,6BAA6B,GACnC,aAAa,CAAC,wBAAwB,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,EAAE,GAAG,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB,CAAC"}

package/dist/http-sse/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/http-sse/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/http-sse/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ExecutionHostStreamEvent } from '../contracts/index.js';\n\nexport type ExecutionHostConversationTurn = {\n  invocationId: string;\n  runtimeSessionId: string;\n  prompt: string;\n  deadlineAt?: string;\n  executionAssertion: string;\n  mcpCapability?: string;\n  modelApiKey: string;\n  signal?: AbortSignal;\n};\n\nexport interface ExecutionHost {\n  streamConversationTurn(\n    input: ExecutionHostConversationTurn,\n  ): AsyncIterable<ExecutionHostStreamEvent>;\n}\n\nexport type DirectHttpExecutionHostConfig = {\n  baseUrl: URL;\n  localToken: string;\n  fetch?: typeof fetch;\n};\n"]}