@relkit/invocation 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rel-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @relkit/invocation
+
+Unsupported internal RELKIT invocation contracts; use @relkit/app.
+
+See [@relkit/app](https://github.com/rel-kit/relkit) for supported application APIs.

package/dist/abort.d.ts

@@ -0,0 +1,9 @@
+export interface AbortBridge {
+    readonly signal: AbortSignal;
+    readonly dispose: () => void;
+}
+/** Links a public signal to the fiber signal without retaining listeners. */
+export declare function createAbortBridge(fiberSignal: AbortSignal, parentSignal?: AbortSignal): AbortBridge;
+/** Passes a signal to a Promise operation and rejects promptly on abort. */
+export declare function abortablePromise<A>(signal: AbortSignal, operation: (signal: AbortSignal) => PromiseLike<A>): Promise<A>;
+//# sourceMappingURL=abort.d.ts.map

package/dist/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,WAAW,EACxB,YAAY,CAAC,EAAE,WAAW,GACzB,WAAW,CAkCb;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,GACjD,OAAO,CAAC,CAAC,CAAC,CAwCZ"}

package/dist/abort.js

@@ -0,0 +1,80 @@
+/** Links a public signal to the fiber signal without retaining listeners. */
+export function createAbortBridge(fiberSignal, parentSignal) {
+    const controller = new AbortController();
+    let disposed = false;
+    const abortFrom = (source) => {
+        if (!controller.signal.aborted)
+            controller.abort(source.reason);
+    };
+    const onFiberAbort = () => abortFrom(fiberSignal);
+    const onParentAbort = () => {
+        if (parentSignal !== undefined)
+            abortFrom(parentSignal);
+    };
+    const preAborted = parentSignal?.aborted === true ? parentSignal : fiberSignal.aborted ? fiberSignal : undefined;
+    if (preAborted !== undefined) {
+        controller.abort(preAborted.reason);
+    }
+    else {
+        fiberSignal.addEventListener("abort", onFiberAbort, { once: true });
+        if (parentSignal !== undefined && parentSignal !== fiberSignal) {
+            parentSignal.addEventListener("abort", onParentAbort, { once: true });
+        }
+    }
+    return {
+        signal: controller.signal,
+        dispose: () => {
+            if (disposed)
+                return;
+            disposed = true;
+            fiberSignal.removeEventListener("abort", onFiberAbort);
+            if (parentSignal !== undefined && parentSignal !== fiberSignal) {
+                parentSignal.removeEventListener("abort", onParentAbort);
+            }
+        },
+    };
+}
+/** Passes a signal to a Promise operation and rejects promptly on abort. */
+export function abortablePromise(signal, operation) {
+    if (signal.aborted)
+        return Promise.reject(abortReason(signal));
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const cleanup = () => signal.removeEventListener("abort", onAbort);
+        function onAbort() {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(abortReason(signal));
+        }
+        signal.addEventListener("abort", onAbort, { once: true });
+        if (signal.aborted) {
+            onAbort();
+            return;
+        }
+        void Promise.resolve()
+            .then(() => {
+            if (settled)
+                return;
+            return operation(signal);
+        })
+            .then((value) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve(value);
+        }, (cause) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(cause);
+        });
+    });
+}
+function abortReason(signal) {
+    return signal.reason ?? new Error("Operation aborted");
+}
+//# sourceMappingURL=abort.js.map

package/dist/abort.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,7 @@
+import type { MaybePromise } from "@relkit/contracts";
+import type { InvocationContextOptions, InvocationRecord, PublicClock } from "./contracts.js";
+export declare function makeContext<Context extends {
+    readonly signal: AbortSignal;
+}>(factory: ((options: InvocationContextOptions) => MaybePromise<Context>) | undefined, record: InvocationRecord, signal: AbortSignal, env: Readonly<Record<string, unknown>>, time: PublicClock): Promise<Context>;
+export declare function linkSignals(controller: AbortController, signals: readonly (AbortSignal | undefined)[]): () => void;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE9F,wBAAgB,WAAW,CAAC,OAAO,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,EAC1E,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,wBAAwB,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,EACnF,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACtC,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED,wBAAgB,WAAW,CACzB,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,GAC5C,MAAM,IAAI,CAYZ"}

package/dist/context.js

@@ -0,0 +1,39 @@
+export function makeContext(factory, record, signal, env, time) {
+    const options = { invocation: record, signal, env: Object.freeze({ ...env }), time };
+    if (factory !== undefined)
+        return Promise.resolve(factory(options));
+    const noop = () => undefined;
+    return Promise.resolve(Object.freeze({
+        invocation: record,
+        signal,
+        env: options.env,
+        log: Object.freeze({ trace: noop, debug: noop, info: noop, warn: noop, error: noop }),
+        time,
+        jobs: Object.freeze({}),
+        events: Object.freeze({}),
+        buckets: Object.freeze({}),
+        cache: Object.freeze({}),
+        agents: Object.freeze({}),
+        database: Object.freeze({}),
+        auth: Object.freeze({ getSession: () => Promise.resolve(null) }),
+        constants: Object.freeze({}),
+        prompts: Object.freeze({}),
+        service: Object.freeze({}),
+    }));
+}
+export function linkSignals(controller, signals) {
+    const listeners = [];
+    for (const signal of signals) {
+        if (signal === undefined)
+            continue;
+        const abort = () => controller.abort(signal.reason);
+        if (signal.aborted)
+            abort();
+        else {
+            signal.addEventListener("abort", abort, { once: true });
+            listeners.push([signal, abort]);
+        }
+    }
+    return () => listeners.forEach(([signal, abort]) => signal.removeEventListener("abort", abort));
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,WAAW,CACzB,OAAmF,EACnF,MAAwB,EACxB,MAAmB,EACnB,GAAsC,EACtC,IAAiB;IAEjB,MAAM,OAAO,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IACrF,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAY,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;IACnC,OAAO,OAAO,CAAC,OAAO,CACpB,MAAM,CAAC,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM;QAClB,MAAM;QACN,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACrF,IAAI;QACJ,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;KAC3B,CAAuB,CACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,UAA2B,EAC3B,OAA6C;IAE7C,MAAM,SAAS,GAA8C,EAAE,CAAC;IAChE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QACnC,MAAM,KAAK,GAAG,GAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,EAAE,CAAC;aACvB,CAAC;YACJ,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAClG,CAAC"}

package/dist/contracts.d.ts

@@ -0,0 +1,135 @@
+import type { MaybePromise, ProtocolId } from "@relkit/contracts";
+import type { StandardIssue, StandardSchemaV1 } from "@relkit/schema";
+import { Effect } from "effect";
+import type { InvocationFailure, PublicFailureEnvelope } from "./failure-types.js";
+export type InvocationSource = "direct" | "http" | "job" | "event" | "tool" | "agent";
+export type InvocationKind = "trace" | "invocation" | "span";
+export type InvocationIdSource = {
+    readonly next: (kind: InvocationKind) => ProtocolId;
+};
+export interface PublicLogger {
+    readonly trace: (message: string, fields?: Readonly<Record<string, unknown>>) => void;
+    readonly debug: (message: string, fields?: Readonly<Record<string, unknown>>) => void;
+    readonly info: (message: string, fields?: Readonly<Record<string, unknown>>) => void;
+    readonly warn: (message: string, fields?: Readonly<Record<string, unknown>>) => void;
+    readonly error: (message: string, fields?: Readonly<Record<string, unknown>>) => void;
+}
+export interface PublicClock {
+    readonly now: () => Date;
+    readonly sleep: (milliseconds: number) => Promise<void>;
+}
+export interface InvocationMetadata {
+    readonly id: string;
+    readonly parentId?: string;
+    readonly traceId: string;
+    readonly correlationId?: string;
+    readonly startedAt: string;
+    readonly deadline?: string;
+    readonly attempt: number;
+    readonly source: InvocationSource;
+    readonly serviceId?: string;
+}
+export interface InvocationContext {
+    readonly invocation: InvocationMetadata;
+    readonly signal: AbortSignal;
+    readonly env: Readonly<Record<string, unknown>>;
+    readonly log: PublicLogger;
+    readonly time: PublicClock;
+    readonly jobs: Readonly<Record<string, never>>;
+    readonly events: Readonly<Record<string, never>>;
+    readonly buckets: Readonly<Record<string, never>>;
+    readonly cache: Readonly<Record<string, never>>;
+    readonly agents: Readonly<Record<string, never>>;
+    readonly database: Readonly<Record<string, never>>;
+    readonly auth: {
+        readonly getSession: () => Promise<unknown | null>;
+    };
+    readonly constants: Readonly<Record<string, never>>;
+    readonly prompts: Readonly<Record<string, never>>;
+    readonly service: Readonly<Record<string, unknown>>;
+}
+export interface InvocationErrorDefinition {
+    readonly id: string;
+    readonly data: StandardSchemaV1;
+}
+export interface InvocationTarget<Input = unknown, Output = unknown, Context extends {
+    readonly signal: AbortSignal;
+} = InvocationContext> {
+    readonly id: string;
+    readonly input: StandardSchemaV1;
+    readonly output: StandardSchemaV1;
+    readonly errors?: readonly InvocationErrorDefinition[];
+    readonly timeoutMs?: number;
+    readonly concurrency?: number;
+    readonly onBefore?: (input: Input, context: Context) => MaybePromise<Input>;
+    readonly onAfter?: (output: Output, context: Context) => MaybePromise<Output>;
+    readonly handler: (input: Input, context: Context) => MaybePromise<Output>;
+}
+export interface InvocationRecord extends InvocationMetadata {
+    readonly functionId: string;
+    readonly status: "started" | "success" | "validation-error" | "declared-error" | "provider-failure" | "cancelled" | "timeout" | "defect";
+    readonly completedAt?: string;
+    readonly durationMs?: number;
+}
+export interface SpanRecord {
+    readonly invocationId: string;
+    readonly functionId: string;
+    readonly name: string;
+    readonly spanId: string;
+    readonly parentSpanId?: string;
+    readonly traceId: string;
+    readonly source: InvocationSource;
+    readonly serviceId?: string;
+    readonly status: "started" | "completed";
+    readonly startedAt: string;
+    readonly completedAt?: string;
+}
+export interface InvocationParent {
+    readonly id: string;
+    readonly traceId: string;
+    readonly spanId?: string;
+    readonly correlationId?: string;
+    readonly deadlineMs?: number;
+    readonly signal?: AbortSignal;
+    readonly trace?: unknown;
+}
+export interface InvocationAdmissionRequest {
+    readonly functionId: string;
+    readonly source: InvocationSource;
+    readonly triggerLimit?: number;
+    readonly limit?: number;
+    readonly deadlineMs?: number;
+    readonly signal: AbortSignal;
+}
+export interface InvocationLease {
+    readonly release: () => MaybePromise<void>;
+}
+export type InvocationAdmit = (request: InvocationAdmissionRequest) => MaybePromise<InvocationLease | void>;
+export interface InvocationContextOptions {
+    readonly invocation: InvocationRecord;
+    readonly signal: AbortSignal;
+    readonly env: Readonly<Record<string, unknown>>;
+    readonly time: PublicClock;
+}
+export interface InvocationRunner {
+    readonly run: <A, E>(effect: Effect.Effect<A, E, never>, options?: {
+        readonly signal?: AbortSignal;
+    }) => Promise<A>;
+}
+export interface InvocationCompletion {
+    readonly record: InvocationRecord;
+    readonly outcome: Exclude<InvocationRecord["status"], "started">;
+    readonly error?: InvocationValidationError | InvocationFailure;
+    readonly publicError?: PublicFailureEnvelope;
+}
+export interface InvocationRelease {
+    readonly record: InvocationRecord;
+    readonly admitted: boolean;
+}
+export declare class InvocationValidationError extends TypeError {
+    readonly code: "RELKIT_INPUT_VALIDATION" | "RELKIT_OUTPUT_VALIDATION";
+    readonly phase: "input" | "output";
+    readonly issues: readonly StandardIssue[];
+    constructor(phase: "input" | "output", issues: readonly StandardIssue[]);
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

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

package/dist/contracts.js

@@ -0,0 +1,14 @@
+import { Effect } from "effect";
+export class InvocationValidationError extends TypeError {
+    code;
+    phase;
+    issues;
+    constructor(phase, issues) {
+        super(`${phase === "input" ? "Input" : "Output"} validation failed`);
+        this.name = "InvocationValidationError";
+        this.code = phase === "input" ? "RELKIT_INPUT_VALIDATION" : "RELKIT_OUTPUT_VALIDATION";
+        this.phase = phase;
+        this.issues = Object.freeze(issues.map((issue) => Object.freeze({ ...issue })));
+    }
+}
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAyJhC,MAAM,OAAO,yBAA0B,SAAQ,SAAS;IAC7C,IAAI,CAAyD;IAC7D,KAAK,CAAqB;IAC1B,MAAM,CAA2B;IAE1C,YAAY,KAAyB,EAAE,MAAgC;QACrE,KAAK,CAAC,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,oBAAoB,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,0BAA0B,CAAC;QACvF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;CACF"}

package/dist/deadline.d.ts

@@ -0,0 +1,12 @@
+import { Cause, Context, Effect } from "effect";
+/** An absolute Unix timestamp in milliseconds. */
+export type Deadline = number;
+/** The effective deadline inherited by child effects in the current fiber. */
+export declare const Deadline: Context.Reference<number | undefined>;
+/** Combines a parent deadline with a child timeout using the earliest instant. */
+export declare function composeDeadline(parentDeadline: Deadline | undefined, timeoutMs: number | undefined, now: number): Deadline | undefined;
+/** Runs an effect until an absolute deadline, preserving the deadline for children. */
+export declare function withDeadline<A, E, R>(effect: Effect.Effect<A, E, R>, deadline: Deadline | undefined): Effect.Effect<A, E | Cause.TimeoutError, R>;
+/** Applies a child timeout while inheriting an earlier deadline from the fiber. */
+export declare function withTimeout<A, E, R>(effect: Effect.Effect<A, E, R>, timeoutMs: number, parentDeadline?: Deadline): Effect.Effect<A, E | Cause.TimeoutError, R>;
+//# sourceMappingURL=deadline.d.ts.map

package/dist/deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../src/deadline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhD,kDAAkD;AAClD,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,uCAEnB,CAAC;AAEH,kFAAkF;AAClF,wBAAgB,eAAe,CAC7B,cAAc,EAAE,QAAQ,GAAG,SAAS,EACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,GACV,QAAQ,GAAG,SAAS,CAWtB;AAED,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAClC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAS7C;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACjC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,QAAQ,GACxB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAS7C"}

package/dist/deadline.js

@@ -0,0 +1,57 @@
+import { Cause, Context, Effect } from "effect";
+/** The effective deadline inherited by child effects in the current fiber. */
+export const Deadline = Context.Reference("relkit/runtime/Deadline", {
+    defaultValue: () => undefined,
+});
+/** Combines a parent deadline with a child timeout using the earliest instant. */
+export function composeDeadline(parentDeadline, timeoutMs, now) {
+    assertTimestamp(now, "now");
+    assertDeadline(parentDeadline);
+    if (timeoutMs !== undefined && (!Number.isFinite(timeoutMs) || timeoutMs < 0)) {
+        throw new RangeError("timeoutMs must be a finite non-negative number");
+    }
+    const childDeadline = timeoutMs === undefined ? undefined : now + timeoutMs;
+    if (childDeadline !== undefined)
+        assertTimestamp(childDeadline, "timeoutMs");
+    if (parentDeadline === undefined)
+        return childDeadline;
+    if (childDeadline === undefined)
+        return parentDeadline;
+    return Math.min(parentDeadline, childDeadline);
+}
+/** Runs an effect until an absolute deadline, preserving the deadline for children. */
+export function withDeadline(effect, deadline) {
+    if (deadline === undefined)
+        return effect;
+    assertDeadline(deadline);
+    return Effect.clockWith((clock) => {
+        const remaining = deadline - clock.currentTimeMillisUnsafe();
+        const timed = remaining <= 0 ? Effect.fail(new Cause.TimeoutError()) : Effect.timeout(effect, remaining);
+        return Effect.provideService(timed, Deadline, deadline);
+    });
+}
+/** Applies a child timeout while inheriting an earlier deadline from the fiber. */
+export function withTimeout(effect, timeoutMs, parentDeadline) {
+    return Effect.clockWith((clock) => Effect.gen(function* () {
+        const inherited = yield* Effect.service(Deadline);
+        const parent = earliest(inherited, parentDeadline);
+        const deadline = composeDeadline(parent, timeoutMs, clock.currentTimeMillisUnsafe());
+        return yield* withDeadline(effect, deadline);
+    }));
+}
+function earliest(first, second) {
+    if (first === undefined)
+        return second;
+    if (second === undefined)
+        return first;
+    return Math.min(first, second);
+}
+function assertDeadline(value) {
+    if (value !== undefined)
+        assertTimestamp(value, "deadline");
+}
+function assertTimestamp(value, name) {
+    if (!Number.isFinite(value))
+        throw new RangeError(`${name} must be a finite number`);
+}
+//# sourceMappingURL=deadline.js.map

package/dist/deadline.js.map

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

package/dist/dispatcher-context.d.ts

@@ -0,0 +1,26 @@
+import type { InvocationRecord, PublicClock, PublicLogger } from "./contracts.js";
+import type { InvocationContextFactory, LocalStructuredLogger, ManagedDependencySources } from "./dispatcher-types.js";
+import type { ManagedDependencyCategory } from "./dispatcher-types.js";
+export declare class DependencyNotConfiguredError extends Error {
+    readonly code: "RELKIT_DEPENDENCY_NOT_CONFIGURED";
+    readonly category: ManagedDependencyCategory;
+    readonly dependencyName: string;
+    constructor(category: ManagedDependencyCategory, dependencyName: string);
+}
+export declare function createLocalClock(signal: AbortSignal, now?: () => number): PublicClock;
+export declare function createLocalStructuredLogger(record: InvocationRecord, time: PublicClock): LocalStructuredLogger;
+export interface StandaloneContextOptions<Context extends {
+    readonly signal: AbortSignal;
+}> {
+    readonly factory?: InvocationContextFactory<Context>;
+    readonly record: InvocationRecord;
+    readonly signal: AbortSignal;
+    readonly env: Readonly<Record<string, unknown>>;
+    readonly time: PublicClock;
+    readonly logger?: PublicLogger;
+    readonly clients?: ManagedDependencySources;
+}
+export declare function makeStandaloneContext<Context extends {
+    readonly signal: AbortSignal;
+}>(options: StandaloneContextOptions<Context>): Promise<Context>;
+//# sourceMappingURL=dispatcher-context.d.ts.map

package/dist/dispatcher-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-context.d.ts","sourceRoot":"","sources":["../src/dispatcher-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElF,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EAEzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEvE,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,EAAG,kCAAkC,CAAU;IAC5D,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,QAAQ,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM;CAMxE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,GAAE,MAAM,MAAiB,GAAG,WAAW,CAyB/F;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,WAAW,GAChB,qBAAqB,CAoCvB;AAED,MAAM,WAAW,wBAAwB,CAAC,OAAO,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC;CAC7C;AAED,wBAAsB,qBAAqB,CAAC,OAAO,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,EAC1F,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,GACzC,OAAO,CAAC,OAAO,CAAC,CAgBlB"}

package/dist/dispatcher-context.js

@@ -0,0 +1,90 @@
+import { abortablePromise } from "./abort.js";
+import { makeContext } from "./context.js";
+import { MANAGED_DEPENDENCY_CATEGORIES } from "./dispatcher-types.js";
+export class DependencyNotConfiguredError extends Error {
+    code = "RELKIT_DEPENDENCY_NOT_CONFIGURED";
+    category;
+    dependencyName;
+    constructor(category, dependencyName) {
+        super(`Managed dependency "${category}.${dependencyName}" has no configured standalone client`);
+        this.name = "DependencyNotConfiguredError";
+        this.category = category;
+        this.dependencyName = dependencyName;
+    }
+}
+export function createLocalClock(signal, now = Date.now) {
+    return Object.freeze({
+        now: () => new Date(now()),
+        sleep: (milliseconds) => {
+            if (!Number.isFinite(milliseconds) || milliseconds < 0) {
+                return Promise.reject(new RangeError("sleep duration must be finite and non-negative"));
+            }
+            return abortablePromise(signal, (sleepSignal) => new Promise((resolve, reject) => {
+                const onAbort = () => {
+                    clearTimeout(timer);
+                    reject(sleepSignal.reason ?? new Error("Operation aborted"));
+                };
+                const timer = setTimeout(() => {
+                    sleepSignal.removeEventListener("abort", onAbort);
+                    resolve();
+                }, milliseconds);
+                sleepSignal.addEventListener("abort", onAbort, { once: true });
+                if (sleepSignal.aborted)
+                    onAbort();
+            }));
+        },
+    });
+}
+export function createLocalStructuredLogger(record, time) {
+    const entries = [];
+    const write = (level, message, fields) => {
+        entries.push(Object.freeze({
+            level,
+            message,
+            fields: Object.freeze({ ...(fields ?? {}) }),
+            timestamp: time.now().toISOString(),
+            invocationId: record.id,
+            traceId: record.traceId,
+            functionId: record.functionId,
+            source: record.source,
+            ...(record.serviceId === undefined ? {} : { serviceId: record.serviceId }),
+        }));
+    };
+    return Object.freeze({
+        trace: (message, fields) => write("trace", message, fields),
+        debug: (message, fields) => write("debug", message, fields),
+        info: (message, fields) => write("info", message, fields),
+        warn: (message, fields) => write("warn", message, fields),
+        error: (message, fields) => write("error", message, fields),
+        get records() {
+            return Object.freeze([...entries]);
+        },
+    });
+}
+export async function makeStandaloneContext(options) {
+    const base = await makeContext(options.factory, options.record, options.signal, options.env, options.time);
+    const installManagedMaps = options.factory === undefined || options.clients !== undefined;
+    return Object.freeze({
+        ...base,
+        ...(options.logger === undefined && options.factory !== undefined
+            ? {}
+            : { log: options.logger ?? createLocalStructuredLogger(options.record, options.time) }),
+        ...(installManagedMaps ? createManagedMaps(options.clients) : {}),
+    });
+}
+function createManagedMaps(sources) {
+    const categories = MANAGED_DEPENDENCY_CATEGORIES;
+    return Object.fromEntries(categories.map((category) => [category, configuredMap(category, sources?.[category])]));
+}
+function configuredMap(category, source) {
+    const target = Object.freeze({ ...(source ?? {}) });
+    return new Proxy(target, {
+        get(current, property, receiver) {
+            if (typeof property === "string" && !Object.hasOwn(current, property)) {
+                throw new DependencyNotConfiguredError(category, property);
+            }
+            return Reflect.get(current, property, receiver);
+        },
+    });
+}
+//# sourceMappingURL=dispatcher-context.js.map

package/dist/dispatcher-context.js.map

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

package/dist/dispatcher-scope.d.ts

@@ -0,0 +1,4 @@
+import type { InvocationDispatchScope } from "./dispatcher-types.js";
+export declare function currentInvocationScope(): InvocationDispatchScope | undefined;
+export declare function runInInvocationScope<A>(scope: InvocationDispatchScope, callback: () => A): A;
+//# sourceMappingURL=dispatcher-scope.d.ts.map

package/dist/dispatcher-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-scope.d.ts","sourceRoot":"","sources":["../src/dispatcher-scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAIrE,wBAAgB,sBAAsB,IAAI,uBAAuB,GAAG,SAAS,CAE5E;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAE5F"}

package/dist/dispatcher-scope.js

@@ -0,0 +1,9 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const storage = new AsyncLocalStorage();
+export function currentInvocationScope() {
+    return storage.getStore();
+}
+export function runInInvocationScope(scope, callback) {
+    return storage.run(scope, callback);
+}
+//# sourceMappingURL=dispatcher-scope.js.map

package/dist/dispatcher-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-scope.js","sourceRoot":"","sources":["../src/dispatcher-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAA2B,CAAC;AAEjE,MAAM,UAAU,sBAAsB;IACpC,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,KAA8B,EAAE,QAAiB;IACvF,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC"}