@ontemper/sdk 0.4.10-rc.1 → 0.4.10

package/README.md

@@ -84,6 +84,7 @@ type InvocationContext = {
   triggerKind: 'http' | 'schedule' | 'manual' | 'agent' | 'as2' | 'sftp' | 'kafka' | 'child';
   deadline: number; // epoch milliseconds
   token: string; // run-scoped platform token
+  responsePolicy?: 'wait' | 'ack' | 'early' | ''; // the route's stored policy; '' from an older host
 };
 ```
 
@@ -96,6 +97,29 @@ The SDK owns three runtime behaviours around every handler:
    ahead of the host's own timer.
 3. Headers: platform `x-temper-*` request headers are removed before the handler runs.
 
+## Answer early, then keep working
+
+🟡 Proposed ([early-answer Runs](../../docs/specs/early-answer-runs.md), A4 open). On a route whose
+stored response policy is `early`, `Answer.early(response)` sends the caller its answer now. The
+handler keeps running in the same Run, and the value it returns sets only the Run outcome:
+
+```ts
+.handle('createOrder', ({ payload }) =>
+  Effect.gen(function* () {
+    yield* Answer.early(HttpServerResponse.jsonUnsafe({ accepted: true }, { status: 202 }));
+    yield* callPartner(payload); // the caller already has its 202
+    return { delivered: true };
+  }),
+)
+```
+
+It fails without writing anything with `EarlyAnswerNotEnabled` (the policy is not `early`),
+`EarlyAnswerUnsupportedMethod` (`HEAD`), `AnswerAlreadySent`, `AnswerStatusInvalid` (outside
+200–599), `AnswerTooLarge` (over 1 MiB), or `AnswerBodyNotAllowed` (a `204` or `304` with a body).
+The deadline still applies to the work: after the answer it ends the Run `failed` with
+`InvocationDeadlineExceeded`. In a test, `readEarlyAnswer(response)` from `@temper/workflow/testing`
+reads the answer and then the trailer.
+
 ## Resources and variables
 
 Declare each resource, variable, and resource type that the workflow reads once. The class is both

package/dist/Answer.d.ts

@@ -0,0 +1,68 @@
+import { Effect, Schema } from 'effect';
+import { HttpServerRequest, HttpServerResponse } from 'effect/unstable/http';
+import { type AnswerTrailer, type AnswerTrailerError } from './Contract/EarlyAnswer.js';
+import { Invocation } from './Invocation.js';
+declare const EarlyAnswerNotEnabled_base: Schema.Class<EarlyAnswerNotEnabled, Schema.TaggedStruct<"EarlyAnswerNotEnabled", {
+    readonly responsePolicy: Schema.String;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** The route's stored response policy is not `early`, so the caller gets the complete response. */
+export declare class EarlyAnswerNotEnabled extends EarlyAnswerNotEnabled_base {
+}
+declare const AnswerAlreadySent_base: Schema.Class<AnswerAlreadySent, Schema.TaggedStruct<"AnswerAlreadySent", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** This invocation already answered; the caller keeps the first answer. */
+export declare class AnswerAlreadySent extends AnswerAlreadySent_base {
+}
+declare const AnswerTooLarge_base: Schema.Class<AnswerTooLarge, Schema.TaggedStruct<"AnswerTooLarge", {
+    readonly limitBytes: Schema.Number;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** The answer body is over the 1 MiB limit. */
+export declare class AnswerTooLarge extends AnswerTooLarge_base {
+}
+declare const AnswerBodyNotAllowed_base: Schema.Class<AnswerBodyNotAllowed, Schema.TaggedStruct<"AnswerBodyNotAllowed", {
+    readonly status: Schema.Number;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A `204` or `304` answer carries a body, which HTTP forbids (EAR-17). */
+export declare class AnswerBodyNotAllowed extends AnswerBodyNotAllowed_base {
+}
+declare const AnswerStatusInvalid_base: Schema.Class<AnswerStatusInvalid, Schema.TaggedStruct<"AnswerStatusInvalid", {
+    readonly status: Schema.Number;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** The answer status is outside 200–599. */
+export declare class AnswerStatusInvalid extends AnswerStatusInvalid_base {
+}
+declare const EarlyAnswerUnsupportedMethod_base: Schema.Class<EarlyAnswerUnsupportedMethod, Schema.TaggedStruct<"EarlyAnswerUnsupportedMethod", {
+    readonly method: Schema.String;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A `HEAD` request never gets a framed response; the complete response answers it (EAR-17). */
+export declare class EarlyAnswerUnsupportedMethod extends EarlyAnswerUnsupportedMethod_base {
+}
+export type EarlyAnswerError = EarlyAnswerNotEnabled | AnswerAlreadySent | AnswerTooLarge | AnswerBodyNotAllowed | AnswerStatusInvalid | EarlyAnswerUnsupportedMethod;
+/**
+ * Sends `response` to the caller now; the handler keeps running in the same Run, and its return value
+ * sets only the Run outcome (EAR-4). It returns once the answer bytes are on the response stream, and
+ * fails without writing anything when the route is not `early`, the request is `HEAD`, an answer was
+ * already sent, the status is outside 200–599, the body is over 1 MiB, or a 204 or 304 carries a body.
+ */
+declare const early: (response: HttpServerResponse.HttpServerResponse | Response) => Effect.Effect<void, EarlyAnswerError, Invocation | HttpServerRequest.HttpServerRequest>;
+export declare const Answer: {
+    readonly early: typeof early;
+};
+/** Records why the handler failed, so a trailer after an early answer names it. A no-op for other policies. */
+export declare const recordAnswerFailure: (request: HttpServerRequest.HttpServerRequest, failure: AnswerTrailerError) => void;
+/** `<L: u32 big-endian><L bytes of JSON>`, the end of a framed body. */
+export declare const encodeTrailer: (trailer: AnswerTrailer) => Uint8Array;
+/**
+ * Serves one `early` invocation. When the handler calls `Answer.early` first, the response is framed:
+ * transport status 200, the answer head and bytes at once, then the trailer when the handler ends.
+ * When the handler returns first, its complete response goes out unframed, as on every other policy.
+ */
+export declare const serveEarly: (request: Request, run: () => Promise<Response>) => Promise<Response>;
+export {};
+//# sourceMappingURL=Answer.d.ts.map

package/dist/Answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Answer.d.ts","sourceRoot":"","sources":["../src/Answer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EAMxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;;;;;AAG7C,mGAAmG;AACnG,qBAAa,qBAAsB,SAAQ,0BAGzC;CAAG;;;;AAEL,2EAA2E;AAC3E,qBAAa,iBAAkB,SAAQ,sBAErC;CAAG;;;;;AAEL,+CAA+C;AAC/C,qBAAa,cAAe,SAAQ,mBAGlC;CAAG;;;;;AAEL,2EAA2E;AAC3E,qBAAa,oBAAqB,SAAQ,yBAGxC;CAAG;;;;;AAEL,4CAA4C;AAC5C,qBAAa,mBAAoB,SAAQ,wBAGvC;CAAG;;;;;AAEL,gGAAgG;AAChG,qBAAa,4BAA6B,SAAQ,iCAGjD;CAAG;AAEJ,MAAM,MAAM,gBAAgB,GACxB,qBAAqB,GACrB,iBAAiB,GACjB,cAAc,GACd,oBAAoB,GACpB,mBAAmB,GACnB,4BAA4B,CAAC;AAmGjC;;;;;GAKG;AACH,QAAA,MAAM,KAAK,aACC,kBAAkB,CAAC,kBAAkB,GAAG,QAAQ,KACzD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,UAAU,GAAG,iBAAiB,CAAC,iBAAiB,CAkDrF,CAAC;AAEL,eAAO,MAAM,MAAM;;CAAqB,CAAC;AAEzC,+GAA+G;AAC/G,eAAO,MAAM,mBAAmB,YACrB,iBAAiB,CAAC,iBAAiB,WACnC,kBAAkB,KAC1B,IAKF,CAAC;AAIF,wEAAwE;AACxE,eAAO,MAAM,aAAa,YAAa,aAAa,KAAG,UAStD,CAAC;AA+BF;;;;GAIG;AACH,eAAO,MAAM,UAAU,YAAmB,OAAO,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAG,OAAO,CAAC,QAAQ,CAkCjG,CAAC"}

package/dist/Answer.js

@@ -0,0 +1,239 @@
+import { Effect, Schema } from 'effect';
+import { HttpServerRequest, HttpServerResponse } from 'effect/unstable/http';
+import { ANSWER_LENGTH_HEADER, ANSWER_STATUS_HEADER, EARLY_ANSWER_PROTOCOL_VERSION, MAX_ANSWER_BYTES, MAX_TRAILER_BYTES, RUN_OUTCOME_HEADER, TRAILER_LENGTH_BYTES, } from './Contract/EarlyAnswer.js';
+import { Invocation } from './Invocation.js';
+import { CurrentLogContext, TRACE_HEADER } from './LogContext.js';
+/** The route's stored response policy is not `early`, so the caller gets the complete response. */
+export class EarlyAnswerNotEnabled extends Schema.TaggedError()('EarlyAnswerNotEnabled', {
+    responsePolicy: Schema.String,
+    message: Schema.String,
+}) {
+}
+/** This invocation already answered; the caller keeps the first answer. */
+export class AnswerAlreadySent extends Schema.TaggedError()('AnswerAlreadySent', {
+    message: Schema.String,
+}) {
+}
+/** The answer body is over the 1 MiB limit. */
+export class AnswerTooLarge extends Schema.TaggedError()('AnswerTooLarge', {
+    limitBytes: Schema.Number,
+    message: Schema.String,
+}) {
+}
+/** A `204` or `304` answer carries a body, which HTTP forbids (EAR-17). */
+export class AnswerBodyNotAllowed extends Schema.TaggedError()('AnswerBodyNotAllowed', {
+    status: Schema.Number,
+    message: Schema.String,
+}) {
+}
+/** The answer status is outside 200–599. */
+export class AnswerStatusInvalid extends Schema.TaggedError()('AnswerStatusInvalid', {
+    status: Schema.Number,
+    message: Schema.String,
+}) {
+}
+/** A `HEAD` request never gets a framed response; the complete response answers it (EAR-17). */
+export class EarlyAnswerUnsupportedMethod extends Schema.TaggedError()('EarlyAnswerUnsupportedMethod', { method: Schema.String, message: Schema.String }) {
+}
+/** Keyed by the web `Request` the SDK serves, which `HttpServerRequest.source` carries into the handler. */
+const slots = new WeakMap();
+const slotOf = (request) => request.source instanceof Request ? slots.get(request.source) : undefined;
+/** Answer headers the platform owns: hop-by-hop framing, and the frame's own and outcome headers. */
+const ownedHeader = (name) => name === 'content-length' ||
+    name === 'transfer-encoding' ||
+    name === 'connection' ||
+    name === 'keep-alive' ||
+    name === 'trailer' ||
+    name === 'upgrade' ||
+    name === RUN_OUTCOME_HEADER ||
+    name.startsWith('x-temper-answer-');
+/** The body, read at most one byte past the limit; `undefined` when it is over the limit. */
+const readBounded = async (response) => {
+    if (response.body === null)
+        return new Uint8Array();
+    const reader = response.body.getReader();
+    const chunks = [];
+    let total = 0;
+    while (true) {
+        const next = await reader.read();
+        if (next.done)
+            break;
+        total += next.value.byteLength;
+        if (total > MAX_ANSWER_BYTES) {
+            await reader.cancel().catch(() => undefined);
+            return undefined;
+        }
+        chunks.push(next.value);
+    }
+    const bytes = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return bytes;
+};
+/** The answer as bytes. The status is set to 200 only to build a web body, which a 204 or 304 forbids. */
+const encodeAnswer = (response, status) => Effect.gen(function* () {
+    const web = response instanceof Response ? response : HttpServerResponse.toWeb(HttpServerResponse.setStatus(response, 200));
+    const body = yield* Effect.promise(() => readBounded(web));
+    if (body === undefined) {
+        return yield* Effect.fail(new AnswerTooLarge({
+            limitBytes: MAX_ANSWER_BYTES,
+            message: `The answer body is over ${MAX_ANSWER_BYTES} bytes.`,
+        }));
+    }
+    if ((status === 204 || status === 304) && body.byteLength > 0) {
+        return yield* Effect.fail(new AnswerBodyNotAllowed({ status, message: `A ${status} answer must have an empty body.` }));
+    }
+    const headers = new Headers();
+    for (const [name, value] of web.headers) {
+        if (!ownedHeader(name.toLowerCase()))
+            headers.append(name, value);
+    }
+    return { status, headers, body };
+});
+/** The trace and message ids the SDK echoes on every response, as `EventRequestMiddleware` does. */
+const echoIds = (headers) => Effect.gen(function* () {
+    const context = yield* CurrentLogContext;
+    if (context === undefined || context.messageId === '')
+        return;
+    if (!headers.has(TRACE_HEADER))
+        headers.set(TRACE_HEADER, context.traceId);
+    if (context.messageId !== undefined && !headers.has('x-message-id'))
+        headers.set('x-message-id', context.messageId);
+});
+/**
+ * Sends `response` to the caller now; the handler keeps running in the same Run, and its return value
+ * sets only the Run outcome (EAR-4). It returns once the answer bytes are on the response stream, and
+ * fails without writing anything when the route is not `early`, the request is `HEAD`, an answer was
+ * already sent, the status is outside 200–599, the body is over 1 MiB, or a 204 or 304 carries a body.
+ */
+const early = (response) => Effect.gen(function* () {
+    const invocation = yield* Invocation;
+    const request = yield* HttpServerRequest.HttpServerRequest;
+    const policy = invocation.responsePolicy ?? '';
+    const notEnabled = new EarlyAnswerNotEnabled({
+        responsePolicy: policy,
+        message: `Answer.early needs the route's response policy to be 'early'; it is '${policy}'.`,
+    });
+    if (policy !== 'early')
+        return yield* Effect.fail(notEnabled);
+    if (request.method === 'HEAD') {
+        return yield* Effect.fail(new EarlyAnswerUnsupportedMethod({
+            method: request.method,
+            message: 'A HEAD request gets the complete response, never an early answer.',
+        }));
+    }
+    // Only the SDK's own `fetch` opens a slot; a request served any other way cannot answer early.
+    const slot = slotOf(request);
+    if (slot === undefined)
+        return yield* Effect.fail(notEnabled);
+    if (slot.state !== 'open') {
+        return yield* Effect.fail(new AnswerAlreadySent({ message: 'This invocation already answered.' }));
+    }
+    const status = response.status;
+    if (!Number.isInteger(status) || status < 200 || status > 599) {
+        return yield* Effect.fail(new AnswerStatusInvalid({ status, message: `The answer status ${status} is outside 200-599.` }));
+    }
+    slot.state = 'pending';
+    const answer = yield* encodeAnswer(response, status).pipe(Effect.tap((encoded) => echoIds(encoded.headers)), Effect.onExit(() => Effect.sync(() => {
+        if (slot.state === 'pending')
+            slot.state = 'open';
+    })), Effect.flatMap((encoded) => Effect.suspend(() => {
+        // A complete response that won the race already answered the caller.
+        if (slot.state !== 'open')
+            return Effect.fail(new AnswerAlreadySent({ message: 'This invocation already answered.' }));
+        slot.state = 'sent';
+        return Effect.succeed(encoded);
+    })));
+    slot.answered.resolve(answer);
+    yield* Effect.promise(() => slot.written.promise);
+});
+export const Answer = { early };
+/** Records why the handler failed, so a trailer after an early answer names it. A no-op for other policies. */
+export const recordAnswerFailure = (request, failure) => {
+    const slot = slotOf(request);
+    if (slot !== undefined && slot.failure === undefined) {
+        slot.failure = { tag: failure.tag.slice(0, 256), message: failure.message.slice(0, 4_096) };
+    }
+};
+const encoder = new TextEncoder();
+/** `<L: u32 big-endian><L bytes of JSON>`, the end of a framed body. */
+export const encodeTrailer = (trailer) => {
+    let json = encoder.encode(JSON.stringify(trailer));
+    if (json.byteLength > MAX_TRAILER_BYTES && trailer.error !== null) {
+        json = encoder.encode(JSON.stringify({ ...trailer, error: { tag: trailer.error.tag, message: '' } }));
+    }
+    const frame = new Uint8Array(TRAILER_LENGTH_BYTES + json.byteLength);
+    new DataView(frame.buffer).setUint32(0, json.byteLength);
+    frame.set(json, TRAILER_LENGTH_BYTES);
+    return frame;
+};
+/** The trailer for the handler's final value: a declared `x-temper-run-outcome`, else its status class. */
+const trailerOf = async (completed, slot) => {
+    const settled = await completed;
+    if (settled.status === 'rejected') {
+        return {
+            v: EARLY_ANSWER_PROTOCOL_VERSION,
+            outcome: 'failed',
+            status: 500,
+            error: slot.failure ?? { tag: 'WorkflowRequestFailed', message: 'Workflow request failed.' },
+        };
+    }
+    const final = settled.value;
+    // The final value never reaches the caller; releasing its body ends the request scope.
+    await final.body?.cancel().catch(() => undefined);
+    const declared = final.headers.get(RUN_OUTCOME_HEADER);
+    const outcome = slot.failure !== undefined
+        ? 'failed'
+        : declared === 'succeeded' || declared === 'failed'
+            ? declared
+            : final.status < 400
+                ? 'succeeded'
+                : 'failed';
+    return { v: EARLY_ANSWER_PROTOCOL_VERSION, outcome, status: final.status, error: slot.failure ?? null };
+};
+/**
+ * Serves one `early` invocation. When the handler calls `Answer.early` first, the response is framed:
+ * transport status 200, the answer head and bytes at once, then the trailer when the handler ends.
+ * When the handler returns first, its complete response goes out unframed, as on every other policy.
+ */
+export const serveEarly = async (request, run) => {
+    const slot = {
+        state: 'open',
+        failure: undefined,
+        answered: Promise.withResolvers(),
+        written: Promise.withResolvers(),
+    };
+    slots.set(request, slot);
+    const completed = Promise.allSettled([run()]).then(([settled]) => settled);
+    const first = await Promise.race([
+        completed.then((settled) => ({ _tag: 'complete', settled })),
+        slot.answered.promise.then((answer) => ({ _tag: 'answer', answer })),
+    ]);
+    if (first._tag === 'complete') {
+        slot.state = 'closed';
+        slot.written.resolve(undefined);
+        if (first.settled.status === 'rejected')
+            throw first.settled.reason;
+        return first.settled.value;
+    }
+    const { answer } = first;
+    const headers = new Headers(answer.headers);
+    headers.set(ANSWER_STATUS_HEADER, String(answer.status));
+    headers.set(ANSWER_LENGTH_HEADER, String(answer.body.byteLength));
+    const body = new ReadableStream({
+        start(controller) {
+            if (answer.body.byteLength > 0)
+                controller.enqueue(answer.body);
+            slot.written.resolve(undefined);
+        },
+        async pull(controller) {
+            controller.enqueue(encodeTrailer(await trailerOf(completed, slot)));
+            controller.close();
+        },
+    });
+    return new Response(body, { status: 200, headers });
+};
+//# sourceMappingURL=Answer.js.map

package/dist/Answer.js.map

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

package/dist/Contract/EarlyAnswer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Early-answer wire protocol, version 1 (docs/specs/early-answer-runs.md#wire-protocol). One HTTP
+ * response carries the partner answer and then a trailer that sets the Run outcome:
+ * `<N answer bytes><L: u32 big-endian><L bytes of UTF-8 JSON trailer>`.
+ */
+/** The response policy the executor sends the runtime on every invocation (EAR-19). */
+export declare const RESPONSE_POLICY_HEADER = "x-temper-response-policy";
+/** The partner status of a framed response; the transport status is always 200 (EAR-17). */
+export declare const ANSWER_STATUS_HEADER = "x-temper-answer-status";
+/** Decimal byte count of the answer that starts the framed body. Its presence marks a framed response. */
+export declare const ANSWER_LENGTH_HEADER = "x-temper-answer-length";
+/** A handler's declared Run outcome (RUN-8); on a framed response the trailer carries it instead. */
+export declare const RUN_OUTCOME_HEADER = "x-temper-run-outcome";
+export declare const EARLY_ANSWER_PROTOCOL_VERSION = 1;
+/** Largest answer body: 1 MiB. */
+export declare const MAX_ANSWER_BYTES = 1048576;
+/** Largest trailer JSON: 64 KiB. */
+export declare const MAX_TRAILER_BYTES = 65536;
+/** Bytes of the big-endian trailer length prefix. */
+export declare const TRAILER_LENGTH_BYTES = 4;
+/** The policy the platform admitted this invocation under; `''` comes from a host that predates EAR-19. */
+export type InvocationResponsePolicy = 'wait' | 'ack' | 'early' | '';
+export interface AnswerTrailerError {
+    readonly tag: string;
+    readonly message: string;
+}
+/** The JSON that ends a framed body. `outcome` sets the Run outcome; the answer status does not (EAR-6). */
+export interface AnswerTrailer {
+    readonly v: typeof EARLY_ANSWER_PROTOCOL_VERSION;
+    readonly outcome: 'succeeded' | 'failed';
+    /** The final handler status, recorded as `http_status`. */
+    readonly status: number;
+    readonly error: AnswerTrailerError | null;
+}
+//# sourceMappingURL=EarlyAnswer.d.ts.map

package/dist/Contract/EarlyAnswer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EarlyAnswer.d.ts","sourceRoot":"","sources":["../../src/Contract/EarlyAnswer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AACjE,4FAA4F;AAC5F,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAC7D,0GAA0G;AAC1G,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAC7D,qGAAqG;AACrG,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AAEzD,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,kCAAkC;AAClC,eAAO,MAAM,gBAAgB,UAAY,CAAC;AAC1C,oCAAoC;AACpC,eAAO,MAAM,iBAAiB,QAAS,CAAC;AACxC,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,2GAA2G;AAC3G,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,EAAE,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,4GAA4G;AAC5G,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,CAAC,EAAE,OAAO,6BAA6B,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC3C"}

package/dist/Contract/EarlyAnswer.js

@@ -0,0 +1,21 @@
+/**
+ * Early-answer wire protocol, version 1 (docs/specs/early-answer-runs.md#wire-protocol). One HTTP
+ * response carries the partner answer and then a trailer that sets the Run outcome:
+ * `<N answer bytes><L: u32 big-endian><L bytes of UTF-8 JSON trailer>`.
+ */
+/** The response policy the executor sends the runtime on every invocation (EAR-19). */
+export const RESPONSE_POLICY_HEADER = 'x-temper-response-policy';
+/** The partner status of a framed response; the transport status is always 200 (EAR-17). */
+export const ANSWER_STATUS_HEADER = 'x-temper-answer-status';
+/** Decimal byte count of the answer that starts the framed body. Its presence marks a framed response. */
+export const ANSWER_LENGTH_HEADER = 'x-temper-answer-length';
+/** A handler's declared Run outcome (RUN-8); on a framed response the trailer carries it instead. */
+export const RUN_OUTCOME_HEADER = 'x-temper-run-outcome';
+export const EARLY_ANSWER_PROTOCOL_VERSION = 1;
+/** Largest answer body: 1 MiB. */
+export const MAX_ANSWER_BYTES = 1_048_576;
+/** Largest trailer JSON: 64 KiB. */
+export const MAX_TRAILER_BYTES = 65_536;
+/** Bytes of the big-endian trailer length prefix. */
+export const TRAILER_LENGTH_BYTES = 4;
+//# sourceMappingURL=EarlyAnswer.js.map

package/dist/Contract/EarlyAnswer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EarlyAnswer.js","sourceRoot":"","sources":["../../src/Contract/EarlyAnswer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uFAAuF;AACvF,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAC;AACjE,4FAA4F;AAC5F,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAC7D,0GAA0G;AAC1G,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAC7D,qGAAqG;AACrG,MAAM,CAAC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAEzD,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAC/C,kCAAkC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAC1C,oCAAoC;AACpC,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACxC,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC"}

package/dist/Contract/Invocation.d.ts

@@ -1,3 +1,4 @@
+import type { InvocationResponsePolicy } from './EarlyAnswer.js';
 /** Who admitted this invocation. Mirrors the platform `RunTriggerKind`; `http` is the guest default. */
 export type InvocationTriggerKind = 'http' | 'schedule' | 'manual' | 'agent' | 'as2' | 'sftp' | 'kafka' | 'child';
 /**
@@ -17,5 +18,10 @@ export interface InvocationContext {
     readonly deadline: number;
     /** Run-scoped platform token for AS2, EDI, and Resource calls. Empty outside a platform host. */
     readonly token: string;
+    /**
+     * The route's stored response policy, from `x-temper-response-policy`. Absent or `''` from a host
+     * that predates early answers; `Answer.early` works only under `early`.
+     */
+    readonly responsePolicy?: InvocationResponsePolicy | undefined;
 }
 //# sourceMappingURL=Invocation.d.ts.map

package/dist/Contract/Invocation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Invocation.d.ts","sourceRoot":"","sources":["../../src/Contract/Invocation.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAElH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,gHAAgH;IAChH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iGAAiG;IACjG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"Invocation.d.ts","sourceRoot":"","sources":["../../src/Contract/Invocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,wGAAwG;AACxG,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAElH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,gHAAgH;IAChH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iGAAiG;IACjG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;CAChE"}