@relkit/app 0.5.1 → 0.5.4

package/dist/app-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-validation.js","sourceRoot":"","sources":["../src/app-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAqC,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChG,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE;QAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,CACL,QAAQ,CAAC,OAAO,CAAC;YACjB,OAAO,CAAC,IAAI,KAAK,aAAa;YAC9B,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU;YACnC,OAAO,OAAO,CAAC,UAAU,KAAK,UAAU;YACxC,QAAQ,CAAC,SAAS,CAAC;YACnB,SAAS,CAAC,IAAI,KAAK,IAAI,CACxB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IACpF,OAAO,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAyC;IAG9E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChB,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,EACzE,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAA8B,EAC9B,OAAe,EACf,MAAc,EACd,KAAa;IAEb,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;QAChE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,yBAAyB,OAAO,UAAU,MAAM,GAAG,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"app-validation.js","sourceRoot":"","sources":["../src/app-validation.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -1,4 +1,5 @@
-export { deriveApplicationId } from "./app-validation.js";
+export * from "./app-validation.js";
+export { AppTelemetry, AppTelemetryLive } from "./app-observability.js";
 export * from "./define-app.js";
 export * from "@relkit/config";
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACxE,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/config.js

@@ -1,4 +1,5 @@
-export { deriveApplicationId } from "./app-validation.js";
+export * from "./app-validation.js";
+export { AppTelemetry, AppTelemetryLive } from "./app-observability.js";
 export * from "./define-app.js";
 export * from "@relkit/config";
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACxE,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/context-descriptors.d.ts

@@ -1,30 +1,43 @@
-import { type EnvRef } from "@relkit/config";
-import { type DescriptorBase, type JsonValue, type MaybePromise } from "@relkit/contracts";
-import { type PublicLogger } from "@relkit/invocation";
-export interface ContextResolverOptions {
-    readonly env: Readonly<Record<string, unknown>>;
-    readonly signal: AbortSignal;
-    readonly log: PublicLogger;
+import { Effect, Schema } from "effect";
+import type { ConstantsDescriptor, ConstantsShape, ContextDescriptorOptions, PromptDescriptor, PromptValue } from "./context-descriptors.types.js";
+export * from "./context-descriptors.types.js";
+declare const ContextDescriptorFailure_base: Schema.Class<ContextDescriptorFailure, Schema.TaggedStruct<"ContextDescriptorFailure", {
+    readonly message: Schema.String;
+    readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/** Expected invalid constant or prompt descriptor input.
+ * @example if (error._tag === "ContextDescriptorFailure") console.error(error.message);
+ */
+export declare class ContextDescriptorFailure extends ContextDescriptorFailure_base {
 }
-export type ConstantResolver<Value = unknown> = (options: ContextResolverOptions) => MaybePromise<Value>;
-export type ConstantValue = JsonValue | EnvRef | ConstantResolver;
-export type ConstantsShape = Readonly<Record<string, ConstantValue>>;
-export interface ConstantsDescriptor<Values extends ConstantsShape = ConstantsShape> extends DescriptorBase<"constants", string> {
-    readonly values: Values;
-}
-export interface PromptDescriptor<Value extends PromptValue = PromptValue> extends DescriptorBase<"prompt", string> {
-    readonly value: Value;
-}
-export type PromptValue = string | readonly string[];
-export interface ContextDescriptorOptions {
-    readonly id?: string;
-}
-export type ResolvedConstants<Descriptor extends ConstantsDescriptor> = {
-    readonly [Key in keyof Descriptor["values"]]: ResolveConstant<Descriptor["values"][Key]>;
-};
-export type ResolvedPrompt<Descriptor extends PromptDescriptor> = Descriptor["value"];
-type ResolveConstant<Value> = Value extends (...args: never[]) => infer Result ? Awaited<Result> : Value extends EnvRef<string, infer Result> ? Result : Value;
+/** Defines a frozen constants descriptor in Effect.
+ * @param values - Named JSON values, environment references, or resolver functions.
+ * @param options - Optional stable descriptor identity.
+ * @returns A constants descriptor or ContextDescriptorFailure.
+ * @example Effect.runSync(defineConstantsEffect({ region: "eu" }));
+ */
+export declare const defineConstantsEffect: <const Values extends ConstantsShape>(values: Values, options?: ContextDescriptorOptions | undefined) => Effect.Effect<ConstantsDescriptor<Values>, ContextDescriptorFailure, never>;
+/** Synchronous constants descriptor adapter.
+ * @param values - Named constants and resolver functions.
+ * @param options - Optional stable descriptor identity.
+ * @returns A frozen constants descriptor.
+ * @throws The original validation error for invalid values.
+ * @example defineConstants({ region: "eu" });
+ */
 export declare function defineConstants<const Values extends ConstantsShape>(values: Values, options?: ContextDescriptorOptions): ConstantsDescriptor<Values>;
+/** Defines a frozen prompt descriptor in Effect.
+ * @param value - Nonempty text or ordered text fragments.
+ * @param options - Optional stable descriptor identity.
+ * @returns A prompt descriptor or ContextDescriptorFailure.
+ * @example Effect.runSync(definePromptEffect("Be concise."));
+ */
+export declare const definePromptEffect: <const Value extends PromptValue>(value: Value, options?: ContextDescriptorOptions | undefined) => Effect.Effect<PromptDescriptor<Value>, ContextDescriptorFailure, never>;
+/** Synchronous prompt descriptor adapter.
+ * @param value - Nonempty text or ordered text fragments.
+ * @param options - Optional stable descriptor identity.
+ * @returns A frozen prompt descriptor.
+ * @throws The original validation error for invalid text.
+ * @example definePrompt("Be concise.");
+ */
 export declare function definePrompt<const Value extends PromptValue>(value: Value, options?: ContextDescriptorOptions): PromptDescriptor<Value>;
-export {};
 //# sourceMappingURL=context-descriptors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context-descriptors.d.ts","sourceRoot":"","sources":["../src/context-descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IAAI,CAC9C,OAAO,EAAE,sBAAsB,KAC5B,YAAY,CAAC,KAAK,CAAC,CAAC;AACzB,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;AAErE,MAAM,WAAW,mBAAmB,CAClC,MAAM,SAAS,cAAc,GAAG,cAAc,CAC9C,SAAQ,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,cAAc,CAC/F,QAAQ,EACR,MAAM,CACP;IACC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,iBAAiB,CAAC,UAAU,SAAS,mBAAmB,IAAI;IACtE,QAAQ,EAAE,GAAG,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;CACzF,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,UAAU,SAAS,gBAAgB,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;AAEtF,KAAK,eAAe,CAAC,KAAK,IAAI,KAAK,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,MAAM,MAAM,GAC1E,OAAO,CAAC,MAAM,CAAC,GACf,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,GACxC,MAAM,GACN,KAAK,CAAC;AAEZ,wBAAgB,eAAe,CAAC,KAAK,CAAC,MAAM,SAAS,cAAc,EACjE,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACrC,mBAAmB,CAAC,MAAM,CAAC,CAc7B;AAED,wBAAgB,YAAY,CAAC,KAAK,CAAC,KAAK,SAAS,WAAW,EAC1D,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,wBAA6B,GACrC,gBAAgB,CAAC,KAAK,CAAC,CAgBzB"}
+{"version":3,"file":"context-descriptors.d.ts","sourceRoot":"","sources":["../src/context-descriptors.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,EACZ,MAAM,gCAAgC,CAAC;AACxC,cAAc,gCAAgC,CAAC;;;;;AAC/C;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,6BAG7C;CAAG;AACJ;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,SACzB,MAAM,SAAS,cAAc,gJA0BrC,CAAC;AACF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,MAAM,SAAS,cAAc,EACjE,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACrC,mBAAmB,CAAC,MAAM,CAAC,CAE7B;AACD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,SACtB,KAAK,SAAS,WAAW,0IAyBjC,CAAC;AACF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,KAAK,SAAS,WAAW,EAC1D,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,wBAA6B,GACrC,gBAAgB,CAAC,KAAK,CAAC,CAEzB"}

package/dist/context-descriptors.js

@@ -1,46 +1,124 @@
 import { isEnvRef } from "@relkit/config";
-import { createDescriptorBase, deepFreeze, } from "@relkit/contracts";
-import { createUnboundIdentity } from "@relkit/invocation";
-export function defineConstants(values, options = {}) {
+import { createDescriptorBase, deepFreeze } from "@relkit/contracts";
+import { createUnboundIdentityEffect, DescriptorIdentityFailure } from "@relkit/invocation";
+import { Effect, Result, Schema } from "effect";
+import { observeApp } from "./app-observability.js";
+export * from "./context-descriptors.types.js";
+/** Expected invalid constant or prompt descriptor input.
+ * @example if (error._tag === "ContextDescriptorFailure") console.error(error.message);
+ */
+export class ContextDescriptorFailure extends Schema.TaggedError()("ContextDescriptorFailure", { message: Schema.String, cause: Schema.Defect() }) {
+}
+/** Defines a frozen constants descriptor in Effect.
+ * @param values - Named JSON values, environment references, or resolver functions.
+ * @param options - Optional stable descriptor identity.
+ * @returns A constants descriptor or ContextDescriptorFailure.
+ * @example Effect.runSync(defineConstantsEffect({ region: "eu" }));
+ */
+export const defineConstantsEffect = Effect.fn("App.defineConstants")((values, options = {}) => observeApp("constants.define", Effect.gen(function* () {
     if (!isRecord(values))
-        throw new TypeError("Constants must be an object map");
-    if (options === null || typeof options !== "object" || Array.isArray(options)) {
-        throw new TypeError("Constants options must be an object");
-    }
+        return yield* invalid("Constants must be an object map");
+    if (!isRecord(options))
+        return yield* invalid("Constants options must be an object");
     for (const [key, value] of Object.entries(values)) {
-        if (key.trim() === "" || (!isEnvRef(value) && typeof value !== "function" && !isJson(value))) {
-            throw new TypeError(`Constant "${key}" is invalid`);
-        }
+        if (key.trim() === "" ||
+            (!isEnvRef(value) && typeof value !== "function" && !(yield* isJsonEffect(value))))
+            return yield* invalid(`Constant "${key}" is invalid`);
     }
-    return deepFreeze({
-        ...createDescriptorBase("constants", options.id ?? createUnboundIdentity()),
-        values: { ...values },
+    const authoredId = options.id;
+    const id = authoredId ?? (yield* createUnboundIdentityEffect().pipe(Effect.mapError(failure)));
+    return yield* Effect.try({
+        try: () => deepFreeze({
+            ...createDescriptorBase("constants", id),
+            values: { ...values },
+        }),
+        catch: failure,
     });
+})));
+/** Synchronous constants descriptor adapter.
+ * @param values - Named constants and resolver functions.
+ * @param options - Optional stable descriptor identity.
+ * @returns A frozen constants descriptor.
+ * @throws The original validation error for invalid values.
+ * @example defineConstants({ region: "eu" });
+ */
+export function defineConstants(values, options = {}) {
+    return runDescriptor(defineConstantsEffect(values, options));
 }
-export function definePrompt(value, options = {}) {
-    if (options === null || typeof options !== "object" || Array.isArray(options)) {
-        throw new TypeError("Prompt options must be an object");
-    }
+/** Defines a frozen prompt descriptor in Effect.
+ * @param value - Nonempty text or ordered text fragments.
+ * @param options - Optional stable descriptor identity.
+ * @returns A prompt descriptor or ContextDescriptorFailure.
+ * @example Effect.runSync(definePromptEffect("Be concise."));
+ */
+export const definePromptEffect = Effect.fn("App.definePrompt")((value, options = {}) => observeApp("prompt.define", Effect.gen(function* () {
+    if (!isRecord(options))
+        return yield* invalid("Prompt options must be an object");
     const values = typeof value === "string" ? [value] : value;
     if (!Array.isArray(values) ||
         values.length === 0 ||
-        values.some((entry) => entry.trim() === "")) {
-        throw new TypeError("A prompt must contain nonempty text");
-    }
-    return deepFreeze({
-        ...createDescriptorBase("prompt", options.id ?? createUnboundIdentity()),
-        value: Array.isArray(value) ? [...value] : value,
+        values.some((entry) => typeof entry !== "string" || entry.trim() === ""))
+        return yield* invalid("A prompt must contain nonempty text");
+    const authoredId = options.id;
+    const id = authoredId ?? (yield* createUnboundIdentityEffect().pipe(Effect.mapError(failure)));
+    return yield* Effect.try({
+        try: () => deepFreeze({
+            ...createDescriptorBase("prompt", id),
+            value: Array.isArray(value) ? [...value] : value,
+        }),
+        catch: failure,
     });
+})));
+/** Synchronous prompt descriptor adapter.
+ * @param value - Nonempty text or ordered text fragments.
+ * @param options - Optional stable descriptor identity.
+ * @returns A frozen prompt descriptor.
+ * @throws The original validation error for invalid text.
+ * @example definePrompt("Be concise.");
+ */
+export function definePrompt(value, options = {}) {
+    return runDescriptor(definePromptEffect(value, options));
 }
-function isJson(value) {
+/** Checks JSON values recursively without parallelizing pure traversal. */
+const isJsonEffect = Effect.fn("App.isJson")((value) => Effect.gen(function* () {
     if (value === null || ["string", "boolean"].includes(typeof value))
         return true;
     if (typeof value === "number")
         return Number.isFinite(value);
-    if (Array.isArray(value))
-        return value.every(isJson);
-    return isRecord(value) && Object.values(value).every(isJson);
+    if (Array.isArray(value)) {
+        for (const entry of value)
+            if (!(yield* isJsonEffect(entry)))
+                return false;
+        return true;
+    }
+    if (!isRecord(value))
+        return false;
+    for (const entry of Object.values(value))
+        if (!(yield* isJsonEffect(entry)))
+            return false;
+    return true;
+}));
+/** Turns an invalid input into a typed failure. */
+function invalid(message) {
+    return Effect.fail(failure(new TypeError(message)));
+}
+/** Retains the original validation cause for synchronous callers. */
+function failure(cause) {
+    if (cause instanceof DescriptorIdentityFailure)
+        cause = cause.cause;
+    return new ContextDescriptorFailure({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+/** Runs a descriptor Effect and rethrows its original compatibility error. */
+function runDescriptor(effect) {
+    const result = Effect.runSync(Effect.result(effect));
+    if (Result.isFailure(result))
+        throw result.failure.cause;
+    return result.success;
 }
+/** Checks for a non-array object record. */
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }

package/dist/context-descriptors.js.map

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

package/dist/context-descriptors.types.d.ts

@@ -0,0 +1,58 @@
+import type { EnvRef } from "@relkit/config";
+import type { DescriptorBase, JsonValue, MaybePromise } from "@relkit/contracts";
+import type { PublicLogger } from "@relkit/invocation";
+/** Inputs available to a dynamic constant resolver.
+ * @example const options: ContextResolverOptions = { env: {}, signal, log };
+ */
+export interface ContextResolverOptions {
+    readonly env: Readonly<Record<string, unknown>>;
+    readonly signal: AbortSignal;
+    readonly log: PublicLogger;
+}
+/** Computes one constant for each context resolution.
+ * @example const region: ConstantResolver<string> = ({ env }) => String(env.REGION);
+ */
+export type ConstantResolver<Value = unknown> = (options: ContextResolverOptions) => MaybePromise<Value>;
+/** Accepted static, environment, or dynamic constant input.
+ * @example const value: ConstantValue = "eu-west-1";
+ */
+export type ConstantValue = JsonValue | EnvRef | ConstantResolver;
+/** Named constant inputs for one descriptor.
+ * @example const values: ConstantsShape = { region: "eu-west-1" };
+ */
+export type ConstantsShape = Readonly<Record<string, ConstantValue>>;
+/** Immutable descriptor for one set of constants.
+ * @example const descriptor: ConstantsDescriptor = defineConstants({ region: "eu" });
+ */
+export interface ConstantsDescriptor<Values extends ConstantsShape = ConstantsShape> extends DescriptorBase<"constants", string> {
+    readonly values: Values;
+}
+/** Prompt text or an ordered list of prompt fragments.
+ * @example const prompt: PromptValue = ["Be concise.", "Use tools."];
+ */
+export type PromptValue = string | readonly string[];
+/** Immutable descriptor for one prompt.
+ * @example const descriptor: PromptDescriptor = definePrompt("Be concise.");
+ */
+export interface PromptDescriptor<Value extends PromptValue = PromptValue> extends DescriptorBase<"prompt", string> {
+    readonly value: Value;
+}
+/** Optional stable identity for a context descriptor.
+ * @example const options: ContextDescriptorOptions = { id: "support.prompt" };
+ */
+export interface ContextDescriptorOptions {
+    readonly id?: string;
+}
+/** Resolved values inferred from a constants descriptor.
+ * @example type Values = ResolvedConstants<typeof constants>;
+ */
+export type ResolvedConstants<Descriptor extends ConstantsDescriptor> = {
+    readonly [Key in keyof Descriptor["values"]]: ResolveConstant<Descriptor["values"][Key]>;
+};
+/** Resolved prompt text inferred from a prompt descriptor.
+ * @example type Text = ResolvedPrompt<typeof prompt>;
+ */
+export type ResolvedPrompt<Descriptor extends PromptDescriptor> = Descriptor["value"];
+type ResolveConstant<Value> = Value extends (...args: never[]) => infer Result ? Awaited<Result> : Value extends EnvRef<string, infer Result> ? Result : Value;
+export {};
+//# sourceMappingURL=context-descriptors.types.d.ts.map

package/dist/context-descriptors.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-descriptors.types.d.ts","sourceRoot":"","sources":["../src/context-descriptors.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IAAI,CAC9C,OAAO,EAAE,sBAAsB,KAC5B,YAAY,CAAC,KAAK,CAAC,CAAC;AAEzB;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAClC,MAAM,SAAS,cAAc,GAAG,cAAc,CAC9C,SAAQ,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,cAAc,CAC/F,QAAQ,EACR,MAAM,CACP;IACC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,UAAU,SAAS,mBAAmB,IAAI;IACtE,QAAQ,EAAE,GAAG,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;CACzF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,UAAU,SAAS,gBAAgB,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;AAEtF,KAAK,eAAe,CAAC,KAAK,IAAI,KAAK,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,MAAM,MAAM,GAC1E,OAAO,CAAC,MAAM,CAAC,GACf,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,GACxC,MAAM,GACN,KAAK,CAAC"}

package/dist/context-descriptors.types.js

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

package/dist/context-descriptors.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-descriptors.types.js","sourceRoot":"","sources":["../src/context-descriptors.types.ts"],"names":[],"mappings":""}

package/dist/context-resolution-service.d.ts

@@ -0,0 +1,16 @@
+import { Context, Layer } from "effect";
+import type { AppConstantRunnerService } from "./context-resolution-service.types.js";
+export type { AppConstantRunnerService } from "./context-resolution-service.types.js";
+declare const AppConstantRunner_base: Context.ServiceClass<AppConstantRunner, "relkit/app/AppConstantRunner", AppConstantRunnerService>;
+/** Replaceable boundary for dynamic constant callback execution.
+ * @example Effect.provide(resolver.resolveEffect(context), AppConstantRunnerLive);
+ */
+export declare class AppConstantRunner extends AppConstantRunner_base {
+}
+/** Live runner that propagates Effect interruption into callback AbortSignals.
+ * @example Effect.provide(resolver.resolveEffect(context), AppConstantRunnerLive);
+ */
+export declare const AppConstantRunnerLive: Layer.Layer<AppConstantRunner, never, never>;
+/** Compatibility runner that passes the caller's exact signal to callbacks. */
+export declare const AppConstantRunnerPromiseLive: Layer.Layer<AppConstantRunner, never, never>;
+//# sourceMappingURL=context-resolution-service.d.ts.map

package/dist/context-resolution-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resolution-service.d.ts","sourceRoot":"","sources":["../src/context-resolution-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEtF,YAAY,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;;AACtF;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,sBAGJ;CAAG;AACtC;;GAEG;AACH,eAAO,MAAM,qBAAqB,8CAUhC,CAAC;AACH,+EAA+E;AAC/E,eAAO,MAAM,4BAA4B,8CAOvC,CAAC"}

package/dist/context-resolution-service.js

@@ -0,0 +1,31 @@
+import { Context, Effect, Layer } from "effect";
+import { ContextResolutionFailure } from "./context-resolver.js";
+/** Replaceable boundary for dynamic constant callback execution.
+ * @example Effect.provide(resolver.resolveEffect(context), AppConstantRunnerLive);
+ */
+export class AppConstantRunner extends Context.Service()("relkit/app/AppConstantRunner") {
+}
+/** Live runner that propagates Effect interruption into callback AbortSignals.
+ * @example Effect.provide(resolver.resolveEffect(context), AppConstantRunnerLive);
+ */
+export const AppConstantRunnerLive = Layer.succeed(AppConstantRunner, {
+    run: Effect.fn("App.ConstantRunner.run")((resolver, options) => Effect.tryPromise({
+        try: (signal) => Promise.resolve(resolver({ ...options, signal: AbortSignal.any([options.signal, signal]) })),
+        catch: failure,
+    })),
+});
+/** Compatibility runner that passes the caller's exact signal to callbacks. */
+export const AppConstantRunnerPromiseLive = Layer.succeed(AppConstantRunner, {
+    run: Effect.fn("App.ConstantRunner.runPromise")((resolver, options) => Effect.tryPromise({
+        try: () => Promise.resolve(resolver(options)),
+        catch: failure,
+    })),
+});
+/** Maps callback failures into the context error channel. */
+function failure(cause) {
+    return new ContextResolutionFailure({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=context-resolution-service.js.map

package/dist/context-resolution-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resolution-service.js","sourceRoot":"","sources":["../src/context-resolution-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,OAAO,CAAC,OAAO,EAGnD,CAAC,8BAA8B,CAAC;CAAG;AACtC;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE;IACpE,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAC7D,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,OAAO,CAAC,OAAO,CACb,QAAQ,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAC5E;QACH,KAAK,EAAE,OAAO;KACf,CAAC,CACH;CACF,CAAC,CAAC;AACH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAC3E,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,+BAA+B,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CACpE,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7C,KAAK,EAAE,OAAO;KACf,CAAC,CACH;CACF,CAAC,CAAC;AACH,6DAA6D;AAC7D,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,IAAI,wBAAwB,CAAC;QAClC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/context-resolution-service.types.d.ts

@@ -0,0 +1,21 @@
+import type { PublicLogger } from "@relkit/invocation";
+import type { Effect } from "effect";
+import type { ConstantResolver } from "./context-descriptors.types.js";
+import type { ContextResolutionFailure } from "./context-resolver.js";
+/** Replaceable execution boundary for dynamic constant callbacks.
+ * @example const runner: AppConstantRunnerService = { run: () => Effect.succeed("eu") };
+ */
+export interface AppConstantRunnerService {
+    /** Invokes a dynamic constant resolver.
+     * @param resolver - User supplied constant callback.
+     * @param options - Environment, logger, and caller signal available to the callback.
+     * @returns The callback result or ContextResolutionFailure.
+     * @example runner.run(() => "eu", { env: {}, log });
+     */
+    readonly run: (resolver: ConstantResolver, options: {
+        readonly env: Readonly<Record<string, unknown>>;
+        readonly log: PublicLogger;
+        readonly signal: AbortSignal;
+    }) => Effect.Effect<unknown, ContextResolutionFailure>;
+}
+//# sourceMappingURL=context-resolution-service.types.d.ts.map

package/dist/context-resolution-service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resolution-service.types.d.ts","sourceRoot":"","sources":["../src/context-resolution-service.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,CACZ,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE;QACP,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAChD,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;QAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;KAC9B,KACE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;CACvD"}

package/dist/context-resolution-service.types.js

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

package/dist/context-resolution-service.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resolution-service.types.js","sourceRoot":"","sources":["../src/context-resolution-service.types.ts"],"names":[],"mappings":""}

package/dist/context-resolver.d.ts

@@ -1,17 +1,26 @@
-import type { PublicLogger } from "@relkit/invocation";
-import type { ConstantsDescriptor, PromptDescriptor, PromptValue } from "./context-descriptors.js";
-export interface ApplicationContextResolver {
-    readonly resolve: (options: {
-        readonly signal: AbortSignal;
-        readonly log: PublicLogger;
-    }) => Promise<{
-        readonly constants: Readonly<Record<string, unknown>>;
-        readonly prompts: Readonly<Record<string, PromptValue>>;
-    }>;
+import { Effect, Schema } from "effect";
+import type { ApplicationContextOptions, ApplicationContextResolver } from "./context-resolver.types.js";
+export type * from "./context-resolver.types.js";
+declare const ContextResolutionFailure_base: Schema.Class<ContextResolutionFailure, Schema.TaggedStruct<"ContextResolutionFailure", {
+    readonly message: Schema.String;
+    readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/** Expected context registration or resolution failure with its original cause.
+ * @example if (error._tag === "ContextResolutionFailure") console.error(error.message);
+ */
+export declare class ContextResolutionFailure extends ContextResolutionFailure_base {
 }
-export declare function createApplicationContextResolver(options: {
-    readonly constants?: Readonly<Record<string, ConstantsDescriptor>>;
-    readonly prompts?: Readonly<Record<string, PromptDescriptor>>;
-    readonly env: Readonly<Record<string, unknown>>;
-}): ApplicationContextResolver;
+/** Builds an application context resolver in Effect.
+ * @param options - Constants, prompts, and resolved environment values.
+ * @returns A resolver or ContextResolutionFailure for duplicate names.
+ * @example Effect.runSync(createApplicationContextResolverEffect({ env: {} }));
+ */
+export declare const createApplicationContextResolverEffect: (options: ApplicationContextOptions) => Effect.Effect<ApplicationContextResolver, ContextResolutionFailure, never>;
+/** Builds a context resolver synchronously for existing application callers.
+ * @param options - Constants, prompts, and resolved environment values.
+ * @returns A resolver with Promise and Effect execution paths.
+ * @throws TypeError when constant names collide.
+ * @example createApplicationContextResolver({ env: {} });
+ */
+export declare function createApplicationContextResolver(options: ApplicationContextOptions): ApplicationContextResolver;
 //# sourceMappingURL=context-resolver.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context-resolver.d.ts","sourceRoot":"","sources":["../src/context-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAEV,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;QAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;QAC7B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;KAC5B,KAAK,OAAO,CAAC;QACZ,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACtD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;KACzD,CAAC,CAAC;CACJ;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE;IACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjD,GAAG,0BAA0B,CAkC7B"}
+{"version":3,"file":"context-resolver.d.ts","sourceRoot":"","sources":["../src/context-resolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhD,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAG3B,MAAM,6BAA6B,CAAC;AACrC,mBAAmB,6BAA6B,CAAC;;;;;AACjD;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,6BAG7C;CAAG;AACJ;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,oHA+ElD,CAAC;AACF;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,yBAAyB,GACjC,0BAA0B,CAI5B"}