@relkit/app 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,54 @@
+# @relkit/app
+
+`@relkit/app` is the public entry point for application configuration, descriptors, and composable
+provider bindings. `relkit.config.ts` contains settings and provider profiles; database and auth are
+registered by their own discovered descriptors.
+
+```ts
+import { defineConfig, defineEnv, env, external, redis, s3 } from "@relkit/app/config";
+
+const values = defineEnv({
+  BUCKET_ENDPOINT: env.url(),
+  BUCKET_NAME: env.string(),
+  BUCKET_REGION: env.string(),
+  BUCKET_ACCESS_KEY_ID: env.secret().optional(),
+  BUCKET_SECRET_ACCESS_KEY: env.secret().optional(),
+  CACHE_URL: env.secret(),
+});
+
+export default defineConfig({
+  env: values,
+  buckets: {
+    assets: external(
+      s3({
+        endpoint: values.BUCKET_ENDPOINT,
+        bucketName: values.BUCKET_NAME,
+        region: values.BUCKET_REGION,
+        credentials: {
+          accessKeyId: values.BUCKET_ACCESS_KEY_ID,
+          secretAccessKey: values.BUCKET_SECRET_ACCESS_KEY,
+        },
+      }),
+    ),
+  },
+  caches: { primary: external(redis({ url: values.CACHE_URL })) },
+  defaults: { bucket: "assets", cache: "primary" },
+  server: { port: 3000 },
+  inspector: { port: 3210 },
+});
+```
+
+Use MinIO and Redis values locally, R2 and Upstash values in a hosted pipeline, or `managed()` S3 and
+Valkey bindings with an AWS deployment. `external()` resources are never provisioned and receive no
+deployment IAM statements. Secret adapter fields require secret environment references.
+
+`id` defaults to the normalized `package.json.name`. `PORT` and `RELKIT_ENV` are framework-reserved.
+Hosting remains in `relkit.config.ts`:
+
+```ts
+export default defineConfig({
+  deployment: { target: "aws", adapter: "pulumi" },
+  server: { port: 3000 },
+  inspector: { port: 3210 },
+});
+```

package/dist/agents.d.ts

@@ -0,0 +1,2 @@
+export * from "@relkit/agents";
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/agents.js

@@ -0,0 +1,2 @@
+export * from "@relkit/agents";
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/buckets.d.ts

@@ -0,0 +1,2 @@
+export * from "@relkit/buckets";
+//# sourceMappingURL=buckets.d.ts.map

package/dist/buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buckets.d.ts","sourceRoot":"","sources":["../src/buckets.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/buckets.js

@@ -0,0 +1,2 @@
+export * from "@relkit/buckets";
+//# sourceMappingURL=buckets.js.map

package/dist/buckets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buckets.js","sourceRoot":"","sources":["../src/buckets.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/cache.d.ts

@@ -0,0 +1,2 @@
+export * from "@relkit/cache";
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/cache.js

@@ -0,0 +1,2 @@
+export * from "@relkit/cache";
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/config-types.d.ts

@@ -0,0 +1,58 @@
+import type { EnvDefinition, EnvRef, EnvShape } from "@relkit/config";
+import type { DescriptorBase, DescriptorMetadata, JsonValue } from "@relkit/contracts";
+import type { CapabilityBindings } from "./providers.js";
+export interface ApiDocsConfig {
+    readonly enabledInProduction?: boolean;
+}
+export interface ServerConfig {
+    readonly port?: number;
+    readonly maxBodyBytes?: number;
+    readonly apiDocs?: ApiDocsConfig;
+    readonly clientContract?: boolean;
+    readonly mcp?: boolean;
+}
+export interface InspectorConfig {
+    readonly port?: number;
+    readonly enabledInProduction?: boolean;
+    readonly maxPreviewBytes?: number;
+}
+export interface DeploymentConfig {
+    readonly target: "aws";
+    readonly adapter: "pulumi";
+}
+export interface SentryConfig {
+    readonly dsn: string | EnvRef;
+    readonly tracesSampleRate?: number;
+    readonly sendDefaultPii?: false;
+}
+export interface ConfigProviderMaps {
+    readonly buckets?: CapabilityBindings<"buckets">;
+    readonly caches?: CapabilityBindings<"cache">;
+    readonly jobs?: CapabilityBindings<"jobs">;
+    readonly events?: CapabilityBindings<"events">;
+    readonly models?: CapabilityBindings<"models">;
+    readonly observability?: CapabilityBindings<"observability">;
+}
+type Profile<Map> = Extract<keyof NonNullable<Map>, string>;
+export type CapabilityDefaults<Maps extends ConfigProviderMaps> = Readonly<{
+    bucket?: Profile<Maps["buckets"]>;
+    cache?: Profile<Maps["caches"]>;
+    job?: Profile<Maps["jobs"]>;
+    event?: Profile<Maps["events"]>;
+    model?: Profile<Maps["models"]>;
+    observability?: Profile<Maps["observability"]>;
+}>;
+export type TelemetryConfig = Readonly<Record<string, JsonValue | EnvRef>>;
+export type DefineConfigOptions<S extends EnvShape, Maps extends ConfigProviderMaps> = DescriptorMetadata & Maps & {
+    readonly id?: string;
+    readonly env: EnvDefinition<S>;
+    readonly defaults?: CapabilityDefaults<Maps>;
+    readonly sentry?: SentryConfig;
+    readonly telemetry?: TelemetryConfig;
+    readonly server?: ServerConfig;
+    readonly inspector?: InspectorConfig;
+    readonly deployment?: DeploymentConfig;
+};
+export type ApplicationConfigDescriptor<Id extends string = string, S extends EnvShape = EnvShape, Maps extends ConfigProviderMaps = ConfigProviderMaps> = DescriptorBase<"app", Id> & Omit<DefineConfigOptions<S, Maps>, keyof DescriptorMetadata | "id">;
+export {};
+//# sourceMappingURL=config-types.d.ts.map

package/dist/config-types.d.ts.map

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

package/dist/config-types.js

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

package/dist/config-types.js.map

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

package/dist/config-validation.d.ts

@@ -0,0 +1,10 @@
+import { type EnvDefinition, type EnvShape } from "@relkit/config";
+import type { ConfigProviderMaps } from "./config-types.js";
+import { type ProviderTopology } from "./providers.js";
+export declare function copyProviderMaps(value: ConfigProviderMaps): ConfigProviderMaps;
+export declare function providerTopology(value: ConfigProviderMaps): ProviderTopology;
+export declare function validateDefaults(maps: ConfigProviderMaps, defaults: Readonly<Record<string, unknown>> | undefined): void;
+export declare function resolveDefaults(maps: ConfigProviderMaps, defaults: Readonly<Record<string, unknown>> | undefined): Readonly<Record<string, string>>;
+export declare function isEnvDefinition(value: unknown): value is EnvDefinition<EnvShape>;
+export declare function deriveApplicationId(packageName: string): string;
+//# sourceMappingURL=config-validation.d.ts.map

package/dist/config-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validation.d.ts","sourceRoot":"","sources":["../src/config-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAY7E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,CAU9E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,gBAAgB,CAS5E;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GACtD,IAAI,CAiBN;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GACtD,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAUlC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAAC,QAAQ,CAAC,CAahF;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAG/D"}

package/dist/config-validation.js

@@ -0,0 +1,83 @@
+import { isEnvRef } from "@relkit/config";
+import { normalizeId } from "@relkit/contracts";
+import { copyProviderTopology } from "./providers.js";
+const MAPS = ["buckets", "caches", "jobs", "events", "models", "observability"];
+const DEFAULTS = {
+    buckets: "bucket",
+    caches: "cache",
+    jobs: "job",
+    events: "event",
+    models: "model",
+    observability: "observability",
+};
+export function copyProviderMaps(value) {
+    const topology = providerTopology(value);
+    return {
+        ...(topology.buckets === undefined ? {} : { buckets: topology.buckets }),
+        ...(topology.cache === undefined ? {} : { caches: topology.cache }),
+        ...(topology.jobs === undefined ? {} : { jobs: topology.jobs }),
+        ...(topology.events === undefined ? {} : { events: topology.events }),
+        ...(topology.models === undefined ? {} : { models: topology.models }),
+        ...(topology.observability === undefined ? {} : { observability: topology.observability }),
+    };
+}
+export function providerTopology(value) {
+    return copyProviderTopology({
+        ...(value.buckets === undefined ? {} : { buckets: value.buckets }),
+        ...(value.caches === undefined ? {} : { cache: value.caches }),
+        ...(value.jobs === undefined ? {} : { jobs: value.jobs }),
+        ...(value.events === undefined ? {} : { events: value.events }),
+        ...(value.models === undefined ? {} : { models: value.models }),
+        ...(value.observability === undefined ? {} : { observability: value.observability }),
+    });
+}
+export function validateDefaults(maps, defaults) {
+    for (const mapName of MAPS) {
+        const profiles = maps[mapName];
+        const defaultName = DEFAULTS[mapName];
+        const selected = defaults?.[defaultName];
+        if (selected !== undefined &&
+            (typeof selected !== "string" || profiles?.[selected] === undefined)) {
+            throw new TypeError(`defaults.${defaultName} must reference a ${mapName} profile`);
+        }
+    }
+    for (const key of Object.keys(defaults ?? {})) {
+        if (!Object.values(DEFAULTS).includes(key)) {
+            throw new TypeError(`Unknown default capability "${key}"`);
+        }
+    }
+}
+export function resolveDefaults(maps, defaults) {
+    validateDefaults(maps, defaults);
+    const resolved = {};
+    for (const mapName of MAPS) {
+        const selected = defaults?.[DEFAULTS[mapName]];
+        const profiles = Object.keys(maps[mapName] ?? {});
+        if (typeof selected === "string")
+            resolved[DEFAULTS[mapName]] = selected;
+        else if (profiles.length === 1)
+            resolved[DEFAULTS[mapName]] = profiles[0];
+    }
+    return Object.freeze(resolved);
+}
+export function isEnvDefinition(value) {
+    if (!isRecord(value) || value.kind !== "env-definition" || !isRecord(value.shape))
+        return false;
+    return Object.entries(value.shape).every(([name, builder]) => {
+        const reference = value[name];
+        return (isRecord(builder) &&
+            builder.kind === "env-builder" &&
+            typeof builder.parse === "function" &&
+            typeof builder.getDefault === "function" &&
+            isEnvRef(reference) &&
+            reference.name === name);
+    });
+}
+export function deriveApplicationId(packageName) {
+    const normalized = packageName.startsWith("@") ? packageName.slice(1) : packageName;
+    return normalizeId(normalized.replaceAll("/", "."));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=config-validation.js.map

package/dist/config-validation.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,34 @@
+import type { ApplicationConfigDescriptor, ConfigProviderMaps, DefineConfigOptions } from "./config-types.js";
+export * from "./config-types.js";
+export { deriveApplicationId } from "./config-validation.js";
+export * from "./providers.js";
+export * from "@relkit/config";
+/**
+ * Defines application, environment, provider, runtime, and deployment settings.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig, defineEnv, env, external, s3 } from "@relkit/app/config"
+ *
+ * const values = defineEnv({
+ *   BUCKET_ENDPOINT: env.url(),
+ *   BUCKET_NAME: env.string(),
+ * })
+ *
+ * export default defineConfig({
+ *   env: values,
+ *   buckets: {
+ *     assets: external(s3({
+ *       endpoint: values.BUCKET_ENDPOINT,
+ *       bucketName: values.BUCKET_NAME,
+ *       region: "us-east-1",
+ *     })),
+ *   },
+ *   defaults: { bucket: "assets" },
+ * })
+ * ```
+ * @category Application
+ * @since 0.2.0
+ */
+export declare function defineConfig<const S extends import("@relkit/config").EnvShape, const Maps extends ConfigProviderMaps>(options: DefineConfigOptions<S, Maps>): ApplicationConfigDescriptor<string, S, Maps>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,2BAA2B,EAC3B,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAC1B,KAAK,CAAC,CAAC,SAAS,OAAO,gBAAgB,EAAE,QAAQ,EACjD,KAAK,CAAC,IAAI,SAAS,kBAAkB,EACrC,OAAO,EAAE,mBAAmB,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,2BAA2B,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,CA4CrF"}

package/dist/config.js

@@ -0,0 +1,76 @@
+import { createDescriptorBase, deepFreeze } from "@relkit/contracts";
+import { createUnboundIdentity } from "@relkit/invocation";
+import { isEnvRef } from "@relkit/config";
+import { copyProviderMaps, isEnvDefinition, resolveDefaults } from "./config-validation.js";
+export * from "./config-types.js";
+export { deriveApplicationId } from "./config-validation.js";
+export * from "./providers.js";
+export * from "@relkit/config";
+/**
+ * Defines application, environment, provider, runtime, and deployment settings.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig, defineEnv, env, external, s3 } from "@relkit/app/config"
+ *
+ * const values = defineEnv({
+ *   BUCKET_ENDPOINT: env.url(),
+ *   BUCKET_NAME: env.string(),
+ * })
+ *
+ * export default defineConfig({
+ *   env: values,
+ *   buckets: {
+ *     assets: external(s3({
+ *       endpoint: values.BUCKET_ENDPOINT,
+ *       bucketName: values.BUCKET_NAME,
+ *       region: "us-east-1",
+ *     })),
+ *   },
+ *   defaults: { bucket: "assets" },
+ * })
+ * ```
+ * @category Application
+ * @since 0.2.0
+ */
+export function defineConfig(options) {
+    if (!isRecord(options) || !isEnvDefinition(options.env)) {
+        throw new TypeError("RELKIT config requires an environment definition");
+    }
+    if (options.deployment !== undefined &&
+        (options.deployment.target !== "aws" || options.deployment.adapter !== "pulumi")) {
+        throw new TypeError("RELKIT deployment must select the aws target and pulumi adapter");
+    }
+    if (options.sentry?.sendDefaultPii !== undefined && options.sentry.sendDefaultPii !== false) {
+        throw new TypeError("Sentry PII collection cannot be enabled through RELKIT config");
+    }
+    if (options.sentry !== undefined &&
+        !((typeof options.sentry.dsn === "string" && options.sentry.dsn.trim() !== "") ||
+            isEnvRef(options.sentry.dsn))) {
+        throw new TypeError("Sentry dsn must be nonempty text or an environment reference");
+    }
+    if (options.sentry?.tracesSampleRate !== undefined &&
+        (!Number.isFinite(options.sentry.tracesSampleRate) ||
+            options.sentry.tracesSampleRate < 0 ||
+            options.sentry.tracesSampleRate > 1)) {
+        throw new TypeError("Sentry tracesSampleRate must be between 0 and 1");
+    }
+    const maps = copyProviderMaps(options);
+    const defaults = resolveDefaults(maps, options.defaults);
+    const base = createDescriptorBase("app", options.id ?? createUnboundIdentity(), options);
+    return deepFreeze({
+        ...base,
+        env: options.env,
+        ...maps,
+        ...(Object.keys(defaults).length === 0 ? {} : { defaults }),
+        ...(options.sentry === undefined ? {} : { sentry: { ...options.sentry } }),
+        ...(options.telemetry === undefined ? {} : { telemetry: { ...options.telemetry } }),
+        ...(options.server === undefined ? {} : { server: { ...options.server } }),
+        ...(options.inspector === undefined ? {} : { inspector: { ...options.inspector } }),
+        ...(options.deployment === undefined ? {} : { deployment: { ...options.deployment } }),
+    });
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context-descriptors.d.ts

@@ -0,0 +1,27 @@
+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;
+}
+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 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;
+export declare function defineConstants<const Values extends ConstantsShape>(values: Values): ConstantsDescriptor<Values>;
+export declare function definePrompt<const Value extends PromptValue>(value: Value): PromptDescriptor<Value>;
+export {};
+//# sourceMappingURL=context-descriptors.d.ts.map

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

@@ -0,0 +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,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,GACb,mBAAmB,CAAC,MAAM,CAAC,CAW7B;AAED,wBAAgB,YAAY,CAAC,KAAK,CAAC,KAAK,SAAS,WAAW,EAC1D,KAAK,EAAE,KAAK,GACX,gBAAgB,CAAC,KAAK,CAAC,CAazB"}

package/dist/context-descriptors.js

@@ -0,0 +1,41 @@
+import { isEnvRef } from "@relkit/config";
+import { createDescriptorBase, deepFreeze, } from "@relkit/contracts";
+import { createUnboundIdentity } from "@relkit/invocation";
+export function defineConstants(values) {
+    if (!isRecord(values))
+        throw new TypeError("Constants must be an object map");
+    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`);
+        }
+    }
+    return deepFreeze({
+        ...createDescriptorBase("constants", createUnboundIdentity()),
+        values: { ...values },
+    });
+}
+export function definePrompt(value) {
+    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", createUnboundIdentity()),
+        value: Array.isArray(value) ? [...value] : value,
+    });
+}
+function isJson(value) {
+    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);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=context-descriptors.js.map

package/dist/context-descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-descriptors.js","sourceRoot":"","sources":["../src/context-descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAe,MAAM,gBAAgB,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,UAAU,GAIX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAqB,MAAM,oBAAoB,CAAC;AAyC9E,MAAM,UAAU,eAAe,CAC7B,MAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;IAC9E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7F,MAAM,IAAI,SAAS,CAAC,aAAa,GAAG,cAAc,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;QAChB,GAAG,oBAAoB,CAAC,WAAW,EAAE,qBAAqB,EAAE,CAAC;QAC7D,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE;KACtB,CAAgC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,KAAY;IAEZ,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3D,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACtB,MAAM,CAAC,MAAM,KAAK,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAC3C,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,UAAU,CAAC;QAChB,GAAG,oBAAoB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;QAC1D,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;KACjD,CAA4B,CAAC;AAChC,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC/D,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"}

package/dist/context-resolver.d.ts

@@ -0,0 +1,17 @@
+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>>;
+    }>;
+}
+export declare function createApplicationContextResolver(options: {
+    readonly constants?: Readonly<Record<string, ConstantsDescriptor>>;
+    readonly prompts?: Readonly<Record<string, PromptDescriptor>>;
+    readonly env: Readonly<Record<string, unknown>>;
+}): ApplicationContextResolver;
+//# sourceMappingURL=context-resolver.d.ts.map

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

@@ -0,0 +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"}

package/dist/context-resolver.js

@@ -0,0 +1,30 @@
+import { isEnvRef } from "@relkit/config";
+export function createApplicationContextResolver(options) {
+    const staticValues = {};
+    const resolvers = [];
+    for (const descriptor of Object.values(options.constants ?? {})) {
+        for (const [key, value] of Object.entries(descriptor.values)) {
+            if (Object.hasOwn(staticValues, key) || resolvers.some(([name]) => name === key)) {
+                throw new TypeError(`Constant "${key}" is registered more than once`);
+            }
+            if (typeof value === "function")
+                resolvers.push([key, value]);
+            else
+                staticValues[key] = isEnvRef(value) ? options.env[value.name] : value;
+        }
+    }
+    const prompts = Object.freeze(Object.fromEntries(Object.entries(options.prompts ?? {}).map(([key, descriptor]) => [key, descriptor.value])));
+    return Object.freeze({
+        async resolve(context) {
+            const dynamic = await Promise.all(resolvers.map(async ([key, resolver]) => [
+                key,
+                await resolver({ env: options.env, signal: context.signal, log: context.log }),
+            ]));
+            return {
+                constants: Object.freeze({ ...staticValues, ...Object.fromEntries(dynamic) }),
+                prompts,
+            };
+        },
+    });
+}
+//# sourceMappingURL=context-resolver.js.map

package/dist/context-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resolver.js","sourceRoot":"","sources":["../src/context-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAmB1C,MAAM,UAAU,gCAAgC,CAAC,OAIhD;IACC,MAAM,YAAY,GAA4B,EAAE,CAAC;IACjD,MAAM,SAAS,GAAiC,EAAE,CAAC;IACnD,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;QAChE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7D,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACjF,MAAM,IAAI,SAAS,CAAC,aAAa,GAAG,gCAAgC,CAAC,CAAC;YACxE,CAAC;YACD,IAAI,OAAO,KAAK,KAAK,UAAU;gBAAE,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;;gBACzD,YAAY,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC7E,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAC3B,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAC1F,CACF,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,CAAC,OAAO,CAAC,OAAqE;YACjF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,CACxB;gBACE,GAAG;gBACH,MAAM,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;aACtE,CACb,CACF,CAAC;YACF,OAAO;gBACL,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7E,OAAO;aACR,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,2 @@
+export * from "@relkit/events";
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/events.js

@@ -0,0 +1,2 @@
+export * from "@relkit/events";
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/functions.d.ts

@@ -0,0 +1,2 @@
+export * from "@relkit/functions";
+//# sourceMappingURL=functions.d.ts.map

package/dist/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../src/functions.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/functions.js

@@ -0,0 +1,2 @@
+export * from "@relkit/functions";
+//# sourceMappingURL=functions.js.map

package/dist/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../src/functions.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./config.js";
+export * from "./context-descriptors.js";
+export * from "./context-resolver.js";
+export * from "@relkit/agents";
+export * from "@relkit/buckets";
+export * from "@relkit/cache";
+export * from "@relkit/events";
+export * from "@relkit/functions";
+export type { EventAttributeValue, EventPublishOptions, EventPublishResult } from "@relkit/events";
+export * from "@relkit/jobs";
+export * from "@relkit/routes";
+export * from "@relkit/services";
+export * from "@relkit/tools";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACnG,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}