@relkit/app 0.7.10 → 0.8.1

package/README.md

@@ -21,7 +21,7 @@ export default defineApp({
   defaults: { cache: "requests", bucket: "receipts" },
   deployment: { engine: "pulumi", host: "aws" },
   server: { port: 3000 },
-  inspector: { port: 3210 },
+  inspector: { enabled: true },
 });
 ```
 
@@ -31,3 +31,9 @@ provider binding and do not become handler-visible `ctx.env` fields.
 
 Cloud and deployment default to `none`. Tests provide replacements explicitly by capability and
 profile; environment names never swap providers.
+
+Inspection defaults to disabled. `inspector.enabled` selects a development bridge;
+`inspector.connection` optionally sets its bind host and port (defaults
+`127.0.0.1:0`). The standalone tool owns UI port `3210`. The obsolete
+`inspector.port` and `inspector.enabledInProduction` settings are rejected.
+Installing or running the standalone tool is separate from application configuration.

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

@@ -1,7 +1,15 @@
+/**
+ * Declares server exposure and optional HTTP capability selection without loading
+ * native SDKs. Compiler validation supplies defaults before runtime generation;
+ * inspector settings select only the development bridge, independently of a tool.
+ */
+import type { InspectorConfigurationInput } from "@relkit/contracts";
 /** API documentation visibility and domain exclusions.
  * @example const docs: ApiDocsConfig = { enabledInProduction: false };
  */
 export interface ApiDocsConfig {
+    /** Explicitly selects Scalar; omitted/false keeps JSON OpenAPI only. */
+    readonly ui?: "scalar" | false;
     readonly enabledInProduction?: boolean;
     readonly excludeDomains?: readonly string[];
 }
@@ -14,14 +22,13 @@ export interface ServerConfig {
     readonly apiDocs?: ApiDocsConfig;
     readonly clientContract?: boolean;
     readonly mcp?: boolean;
+    /** Explicitly selects the optional AG-UI HTTP protocol independently of agent RPC. */
+    readonly agUi?: boolean;
 }
-/** Inspector settings attached to an application descriptor.
- * @example const inspector: InspectorConfig = { port: 3210 };
+/** Development bridge selection; installing or running the UI is independent.
+ * @example const inspector: InspectorConfig = { enabled: true };
  */
-export interface InspectorConfig {
-    readonly port?: number;
-    readonly enabledInProduction?: boolean;
-    readonly maxPreviewBytes?: number;
+export interface InspectorConfig extends InspectorConfigurationInput {
 }
 /** Transitional compatibility switches for application authoring.
  * @example const compatibility: AppCompatibilityConfig = { legacyJobs: true };

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

@@ -1 +1 @@
-{"version":3,"file":"app-config.types.d.ts","sourceRoot":"","sources":["../src/app-config.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B"}
+{"version":3,"file":"app-config.types.d.ts","sourceRoot":"","sources":["../src/app-config.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,sFAAsF;IACtF,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,2BAA2B;CAAG;AAEvE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B"}

package/dist/app-observability.types.d.ts

@@ -1,8 +1,13 @@
+/**
+ * Defines bounded application-authoring operation labels and the injectable
+ * observer contract. Observers preserve each operation's success/error/services
+ * while the live implementation records its spans and outcomes.
+ */
 import type { Effect } from "effect";
 /** Fixed operation labels used for application authoring telemetry.
  * @example const operation: AppOperation = "define";
  */
-export type AppOperation = "define" | "env.isDefinition" | "id.derive" | "compatibility.normalize" | "alias.assertExclusive" | "constants.define" | "prompt.define" | "context.create" | "context.resolve";
+export type AppOperation = "define" | "env.isDefinition" | "id.derive" | "compatibility.normalize" | "runtimeMetadata.normalize" | "alias.assertExclusive" | "constants.define" | "prompt.define" | "context.create" | "context.resolve";
 /** A replaceable observer for application authoring operations.
  * @example const observer: AppTelemetryService = { observe: (_name, effect) => effect };
  */

package/dist/app-observability.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-observability.types.d.ts","sourceRoot":"","sources":["../src/app-observability.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,kBAAkB,GAClB,WAAW,GACX,yBAAyB,GACzB,uBAAuB,GACvB,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACxB,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"app-observability.types.d.ts","sourceRoot":"","sources":["../src/app-observability.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,kBAAkB,GAClB,WAAW,GACX,yBAAyB,GACzB,2BAA2B,GAC3B,uBAAuB,GACvB,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACxB,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;CAC7B"}

package/dist/app-provider-normalization.d.ts

@@ -7,19 +7,19 @@ import type { NormalizedProviderProfiles, ProviderSourceInput } from "@relkit/pr
  * @returns Normalized profiles or AppValidationFailure.
  * @example Effect.runSync(normalizeProvidersEffect({}));
  */
-export declare const normalizeProvidersEffect: (options: AppProviderInputs) => Effect.Effect<Partial<Record<"model" | "event" | "bucket" | "cache" | "job" | "realtime" | "agent-state", NormalizedProviderProfiles<import("@relkit/provider").ProviderAdapter>>>, AppValidationFailure, never>;
+export declare const normalizeProvidersEffect: (options: AppProviderInputs) => Effect.Effect<Partial<Record<"bucket" | "cache" | "job" | "event" | "model" | "realtime" | "agent-state", NormalizedProviderProfiles<import("@relkit/provider").ProviderAdapter>>>, AppValidationFailure, never>;
 /** Checks default profile selections and returns an immutable copy.
  * @param providers - Normalized available provider profiles.
  * @param defaults - Optional selected profile names.
  * @returns Frozen defaults or AppValidationFailure.
  * @example Effect.runSync(normalizeDefaultsEffect({}, undefined));
  */
-export declare const normalizeDefaultsEffect: <Providers extends AppProviderInputs>(providers: Partial<Record<"model" | "event" | "bucket" | "cache" | "job" | "realtime" | "agent-state", NormalizedProviderProfiles<import("@relkit/provider").ProviderAdapter>>>, defaults: AppProviderDefaults<Providers> | undefined) => Effect.Effect<Readonly<{
-    model?: ["model" extends infer T ? T extends "model" ? T extends keyof Providers ? NonNullable<Providers[T]> : never : never : never] extends [never] ? never : ("model" extends infer T_1 ? T_1 extends "model" ? T_1 extends keyof Providers ? NonNullable<Providers[T_1]> : never : never : never) extends infer T_2 ? T_2 extends ("model" extends infer T_3 ? T_3 extends "model" ? T_3 extends keyof Providers ? NonNullable<Providers[T_3]> : never : never : never) ? T_2 extends ProviderSourceInput ? "default" : Extract<keyof T_2, string> : never : never;
-    event?: ["event" extends infer T_4 ? T_4 extends "event" ? T_4 extends keyof Providers ? NonNullable<Providers[T_4]> : never : never : never] extends [never] ? never : ("event" extends infer T_5 ? T_5 extends "event" ? T_5 extends keyof Providers ? NonNullable<Providers[T_5]> : never : never : never) extends infer T_6 ? T_6 extends ("event" extends infer T_7 ? T_7 extends "event" ? T_7 extends keyof Providers ? NonNullable<Providers[T_7]> : never : never : never) ? T_6 extends ProviderSourceInput ? "default" : Extract<keyof T_6, string> : never : never;
-    bucket?: ["bucket" extends infer T_8 ? T_8 extends "bucket" ? T_8 extends keyof Providers ? NonNullable<Providers[T_8]> : never : never : never] extends [never] ? never : ("bucket" extends infer T_9 ? T_9 extends "bucket" ? T_9 extends keyof Providers ? NonNullable<Providers[T_9]> : never : never : never) extends infer T_10 ? T_10 extends ("bucket" extends infer T_11 ? T_11 extends "bucket" ? T_11 extends keyof Providers ? NonNullable<Providers[T_11]> : never : never : never) ? T_10 extends ProviderSourceInput ? "default" : Extract<keyof T_10, string> : never : never;
-    cache?: ["cache" extends infer T_12 ? T_12 extends "cache" ? T_12 extends keyof Providers ? NonNullable<Providers[T_12]> : never : never : never] extends [never] ? never : ("cache" extends infer T_13 ? T_13 extends "cache" ? T_13 extends keyof Providers ? NonNullable<Providers[T_13]> : never : never : never) extends infer T_14 ? T_14 extends ("cache" extends infer T_15 ? T_15 extends "cache" ? T_15 extends keyof Providers ? NonNullable<Providers[T_15]> : never : never : never) ? T_14 extends ProviderSourceInput ? "default" : Extract<keyof T_14, string> : never : never;
-    job?: ["jobs" extends keyof Providers ? NonNullable<Providers[keyof Providers & "jobs"]> : "job" extends keyof Providers ? NonNullable<Providers[keyof Providers & "job"]> : never] extends [never] ? never : ("jobs" extends keyof Providers ? NonNullable<Providers[keyof Providers & "jobs"]> : "job" extends keyof Providers ? NonNullable<Providers[keyof Providers & "job"]> : never) extends infer T_16 ? T_16 extends ("jobs" extends keyof Providers ? NonNullable<Providers[keyof Providers & "jobs"]> : "job" extends keyof Providers ? NonNullable<Providers[keyof Providers & "job"]> : never) ? T_16 extends ProviderSourceInput ? "default" : Extract<keyof T_16, string> : never : never;
+export declare const normalizeDefaultsEffect: <Providers extends AppProviderInputs>(providers: Partial<Record<"bucket" | "cache" | "job" | "event" | "model" | "realtime" | "agent-state", NormalizedProviderProfiles<import("@relkit/provider").ProviderAdapter>>>, defaults: AppProviderDefaults<Providers> | undefined) => Effect.Effect<Readonly<{
+    bucket?: ["bucket" extends infer T ? T extends "bucket" ? T extends keyof Providers ? NonNullable<Providers[T]> : never : never : never] extends [never] ? never : ("bucket" extends infer T_1 ? T_1 extends "bucket" ? T_1 extends keyof Providers ? NonNullable<Providers[T_1]> : never : never : never) extends infer T_2 ? T_2 extends ("bucket" extends infer T_3 ? T_3 extends "bucket" ? T_3 extends keyof Providers ? NonNullable<Providers[T_3]> : never : never : never) ? T_2 extends ProviderSourceInput ? "default" : Extract<keyof T_2, string> : never : never;
+    cache?: ["cache" extends infer T_4 ? T_4 extends "cache" ? T_4 extends keyof Providers ? NonNullable<Providers[T_4]> : never : never : never] extends [never] ? never : ("cache" extends infer T_5 ? T_5 extends "cache" ? T_5 extends keyof Providers ? NonNullable<Providers[T_5]> : never : never : never) extends infer T_6 ? T_6 extends ("cache" extends infer T_7 ? T_7 extends "cache" ? T_7 extends keyof Providers ? NonNullable<Providers[T_7]> : never : never : never) ? T_6 extends ProviderSourceInput ? "default" : Extract<keyof T_6, string> : never : never;
+    job?: ["jobs" extends keyof Providers ? NonNullable<Providers[keyof Providers & "jobs"]> : "job" extends keyof Providers ? NonNullable<Providers[keyof Providers & "job"]> : never] extends [never] ? never : ("jobs" extends keyof Providers ? NonNullable<Providers[keyof Providers & "jobs"]> : "job" extends keyof Providers ? NonNullable<Providers[keyof Providers & "job"]> : never) extends infer T_8 ? T_8 extends ("jobs" extends keyof Providers ? NonNullable<Providers[keyof Providers & "jobs"]> : "job" extends keyof Providers ? NonNullable<Providers[keyof Providers & "job"]> : never) ? T_8 extends ProviderSourceInput ? "default" : Extract<keyof T_8, string> : never : never;
+    event?: ["event" extends infer T_9 ? T_9 extends "event" ? T_9 extends keyof Providers ? NonNullable<Providers[T_9]> : never : never : never] extends [never] ? never : ("event" extends infer T_10 ? T_10 extends "event" ? T_10 extends keyof Providers ? NonNullable<Providers[T_10]> : never : never : never) extends infer T_11 ? T_11 extends ("event" extends infer T_12 ? T_12 extends "event" ? T_12 extends keyof Providers ? NonNullable<Providers[T_12]> : never : never : never) ? T_11 extends ProviderSourceInput ? "default" : Extract<keyof T_11, string> : never : never;
+    model?: ["model" extends infer T_13 ? T_13 extends "model" ? T_13 extends keyof Providers ? NonNullable<Providers[T_13]> : never : never : never] extends [never] ? never : ("model" extends infer T_14 ? T_14 extends "model" ? T_14 extends keyof Providers ? NonNullable<Providers[T_14]> : never : never : never) extends infer T_15 ? T_15 extends ("model" extends infer T_16 ? T_16 extends "model" ? T_16 extends keyof Providers ? NonNullable<Providers[T_16]> : never : never : never) ? T_15 extends ProviderSourceInput ? "default" : Extract<keyof T_15, string> : never : never;
     realtime?: ["realtime" extends infer T_17 ? T_17 extends "realtime" ? T_17 extends keyof Providers ? NonNullable<Providers[T_17]> : never : never : never] extends [never] ? never : ("realtime" extends infer T_18 ? T_18 extends "realtime" ? T_18 extends keyof Providers ? NonNullable<Providers[T_18]> : never : never : never) extends infer T_19 ? T_19 extends ("realtime" extends infer T_20 ? T_20 extends "realtime" ? T_20 extends keyof Providers ? NonNullable<Providers[T_20]> : never : never : never) ? T_19 extends ProviderSourceInput ? "default" : Extract<keyof T_19, string> : never : never;
     "agent-state"?: ["agent-state" extends infer T_21 ? T_21 extends "agent-state" ? T_21 extends keyof Providers ? NonNullable<Providers[T_21]> : never : never : never] extends [never] ? never : ("agent-state" extends infer T_22 ? T_22 extends "agent-state" ? T_22 extends keyof Providers ? NonNullable<Providers[T_22]> : never : never : never) extends infer T_23 ? T_23 extends ("agent-state" extends infer T_24 ? T_24 extends "agent-state" ? T_24 extends keyof Providers ? NonNullable<Providers[T_24]> : never : never : never) ? T_23 extends ProviderSourceInput ? "default" : Extract<keyof T_23, string> : never : never;
 }>, AppValidationFailure, never>;

package/dist/app-runtime-metadata.d.ts

@@ -0,0 +1,14 @@
+import { Effect } from "effect";
+import { AppValidationFailure } from "./app-validation.js";
+import type { ApplicationDescriptor } from "./define-app.types.js";
+/**
+ * Normalizes immutable runtime policy without starting its selected features.
+ * @param options - Optional server, bridge and deployment authoring metadata.
+ * @returns Lazy metadata copies, failing with AppValidationFailure on invalid input.
+ */
+export declare const normalizeAppRuntimeMetadataEffect: (options: Pick<ApplicationDescriptor, "server" | "inspector" | "deployment">) => Effect.Effect<{
+    server: import("./app-config.types.js").ServerConfig | undefined;
+    inspector: import("@relkit/contracts").InspectorConfiguration | undefined;
+    deployment: Readonly<Record<string, import("@relkit/contracts").JsonValue>> | undefined;
+}, AppValidationFailure, never>;
+//# sourceMappingURL=app-runtime-metadata.d.ts.map

package/dist/app-runtime-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-runtime-metadata.d.ts","sourceRoot":"","sources":["../src/app-runtime-metadata.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,iCAAiC;;;;+BAmB7C,CAAC"}

package/dist/app-runtime-metadata.js

@@ -0,0 +1,24 @@
+/**
+ * Copies application server/deployment metadata and validates optional inspection
+ * selection before descriptor freezing. These pure authoring effects acquire no
+ * listeners or providers; invalid input retains the public validation cause.
+ */
+import { normalizeInspectorConfiguration } from "@relkit/contracts";
+import { Effect } from "effect";
+import { observeApp } from "./app-observability.js";
+import { copyEffect } from "./app-provider-normalization.js";
+import { AppValidationFailure } from "./app-validation.js";
+/**
+ * Normalizes immutable runtime policy without starting its selected features.
+ * @param options - Optional server, bridge and deployment authoring metadata.
+ * @returns Lazy metadata copies, failing with AppValidationFailure on invalid input.
+ */
+export const normalizeAppRuntimeMetadataEffect = Effect.fn("App.runtimeMetadata")((options) => observeApp("runtimeMetadata.normalize", Effect.gen(function* () {
+    const server = options.server === undefined ? undefined : yield* copyEffect(options.server);
+    const inspector = options.inspector === undefined
+        ? undefined
+        : yield* Effect.fromResult(normalizeInspectorConfiguration(options.inspector)).pipe(Effect.mapError((error) => new AppValidationFailure({ message: error.message, cause: error })));
+    const deployment = options.deployment === undefined ? undefined : yield* copyEffect(options.deployment);
+    return { server, inspector, deployment };
+})));
+//# sourceMappingURL=app-runtime-metadata.js.map

package/dist/app-runtime-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-runtime-metadata.js","sourceRoot":"","sources":["../src/app-runtime-metadata.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAC/E,CAAC,OAA2E,EAAE,EAAE,CAC9E,UAAU,CACR,2BAA2B,EAC3B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5F,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,KAAK,SAAS;QAC7B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,+BAA+B,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAC/E,MAAM,CAAC,QAAQ,CACb,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAC9E,CACF,CAAC;IACR,MAAM,UAAU,GACd,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AAC3C,CAAC,CAAC,CACH,CACJ,CAAC"}

package/dist/context-descriptors.d.ts

@@ -22,7 +22,14 @@ export declare const defineConstantsEffect: <const Values extends ConstantsShape
  * @param options - Optional stable descriptor identity.
  * @returns A frozen constants descriptor.
  * @throws The original validation error for invalid values.
- * @example defineConstants({ region: "eu" });
+ * @example
+ * ```ts
+ * import { defineConstants, defineEnv, env } from "@relkit/app";
+ * const environment = defineEnv({ REGION: env.string() });
+ * const limits = defineConstants({ maxItems: 20, region: environment.REGION });
+ * // Literal values are immutable; the environment reference resolves with the context.
+ * ```
+ * @see https://relkit.up.railway.app/docs/modules/service/context-values
  */
 export declare function defineConstants<const Values extends ConstantsShape>(values: Values, options?: ContextDescriptorOptions): ConstantsDescriptor<Values>;
 /** Defines a frozen prompt descriptor in Effect.
@@ -37,7 +44,13 @@ export declare const definePromptEffect: <const Value extends PromptValue>(value
  * @param options - Optional stable descriptor identity.
  * @returns A frozen prompt descriptor.
  * @throws The original validation error for invalid text.
- * @example definePrompt("Be concise.");
+ * @example
+ * ```ts
+ * import { definePrompt } from "@relkit/app";
+ * const support = definePrompt(["Use the order details.", "Do not invent delivery dates."]);
+ * // support.value preserves the two fragments in order.
+ * ```
+ * @see https://relkit.up.railway.app/docs/modules/service/context-values
  */
 export declare function definePrompt<const Value extends PromptValue>(value: Value, options?: ContextDescriptorOptions): PromptDescriptor<Value>;
 //# 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":"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"}
+{"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;;;;;;;;;;;;;GAaG;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;;;;;;;;;;;;GAYG;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

@@ -40,7 +40,14 @@ export const defineConstantsEffect = Effect.fn("App.defineConstants")((values, o
  * @param options - Optional stable descriptor identity.
  * @returns A frozen constants descriptor.
  * @throws The original validation error for invalid values.
- * @example defineConstants({ region: "eu" });
+ * @example
+ * ```ts
+ * import { defineConstants, defineEnv, env } from "@relkit/app";
+ * const environment = defineEnv({ REGION: env.string() });
+ * const limits = defineConstants({ maxItems: 20, region: environment.REGION });
+ * // Literal values are immutable; the environment reference resolves with the context.
+ * ```
+ * @see https://relkit.up.railway.app/docs/modules/service/context-values
  */
 export function defineConstants(values, options = {}) {
     return runDescriptor(defineConstantsEffect(values, options));
@@ -74,7 +81,13 @@ export const definePromptEffect = Effect.fn("App.definePrompt")((value, options
  * @param options - Optional stable descriptor identity.
  * @returns A frozen prompt descriptor.
  * @throws The original validation error for invalid text.
- * @example definePrompt("Be concise.");
+ * @example
+ * ```ts
+ * import { definePrompt } from "@relkit/app";
+ * const support = definePrompt(["Use the order details.", "Do not invent delivery dates."]);
+ * // support.value preserves the two fragments in order.
+ * ```
+ * @see https://relkit.up.railway.app/docs/modules/service/context-values
  */
 export function definePrompt(value, options = {}) {
     return runDescriptor(definePromptEffect(value, options));

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/define-app.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Constructs immutable application descriptors without acquiring providers or
+ * optional tools. Shared bridge validation rejects obsolete inspection settings;
+ * the synchronous facade preserves original validation errors for authors.
+ */
 import type { EnvShape } from "@relkit/config";
 import { type TelemetryExporterMap } from "@relkit/observability/telemetry";
 import { Effect } from "effect";

package/dist/define-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-app.d.ts","sourceRoot":"","sources":["../src/define-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAQxC,OAAO,EACL,oBAAoB,EAIrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAE/B,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAkB3E;;;;GAIG;AACH,eAAO,MAAM,eAAe,SAElB,KAAK,SAAS,QAAQ,QACtB,SAAS,SAAS,iBAAiB,QACnC,SAAS,SAAS,oBAAoB,qRAoD/C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,KAAK,CAAC,KAAK,SAAS,QAAQ,EAC5B,KAAK,CAAC,SAAS,SAAS,iBAAiB,EACzC,KAAK,CAAC,SAAS,SAAS,oBAAoB,GAAG,oBAAoB,EAEnE,OAAO,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,GACrD,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAIpD"}
+{"version":3,"file":"define-app.d.ts","sourceRoot":"","sources":["../src/define-app.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAKxC,OAAO,EACL,oBAAoB,EAIrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAE/B,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAkB3E;;;;GAIG;AACH,eAAO,MAAM,eAAe,SAElB,KAAK,SAAS,QAAQ,QACtB,SAAS,SAAS,iBAAiB,QACnC,SAAS,SAAS,oBAAoB,qRAsD/C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,KAAK,CAAC,KAAK,SAAS,QAAQ,EAC5B,KAAK,CAAC,SAAS,SAAS,iBAAiB,EACzC,KAAK,CAAC,SAAS,SAAS,oBAAoB,GAAG,oBAAoB,EAEnE,OAAO,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,GACrD,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAIpD"}

package/dist/define-app.js

@@ -4,7 +4,8 @@ import { normalizeTelemetryConfiguration, } from "@relkit/observability/telemetr
 import { Effect, Result } from "effect";
 import { observeApp } from "./app-observability.js";
 import { APP_PROVIDER_CAPABILITIES } from "./app-provider-capabilities.js";
-import { copyEffect, normalizeDefaultsEffect, normalizeProvidersEffect, } from "./app-provider-normalization.js";
+import { normalizeDefaultsEffect, normalizeProvidersEffect } from "./app-provider-normalization.js";
+import { normalizeAppRuntimeMetadataEffect } from "./app-runtime-metadata.js";
 import { AppValidationFailure, assertExclusiveAliasEffect, isEnvDefinitionEffect, normalizeCompatibilityEffect, } from "./app-validation.js";
 export * from "./define-app.types.js";
 export { APP_PROVIDER_CAPABILITIES } from "./app-provider-capabilities.js";
@@ -34,7 +35,7 @@ export const defineAppEffect = Effect.fn("App.defineApp")((options) => observeAp
     for (const key of Object.keys(options))
         if (!OPTION_KEYS.has(key))
             return yield* invalid(`Unknown defineApp option "${key}"`);
-    yield* assertExclusiveAliasEffect(options, "jobs", "job", "defineApp");
+    yield* assertExclusiveAliasEffect({ jobs: options.jobs, job: options.job }, "jobs", "job", "defineApp");
     yield* assertExclusiveAliasEffect(options.defaults ?? {}, "jobs", "job", "defineApp defaults");
     const providers = yield* normalizeProvidersEffect(options);
     const defaults = yield* normalizeDefaultsEffect(providers, options.defaults);
@@ -50,9 +51,8 @@ export const defineAppEffect = Effect.fn("App.defineApp")((options) => observeAp
             try: () => normalizeTelemetryConfiguration(options.telemetry),
             catch: fromCause,
         });
-    const server = options.server === undefined ? undefined : yield* copyEffect(options.server);
-    const inspector = options.inspector === undefined ? undefined : yield* copyEffect(options.inspector);
-    const deployment = options.deployment === undefined ? undefined : yield* copyEffect(options.deployment);
+    const { server, inspector, deployment } = yield* normalizeAppRuntimeMetadataEffect(options);
+    // Provider/default normalizers retain the authored generic profile keys.
     return deepFreeze({
         ...base,
         env: options.env,
@@ -84,20 +84,30 @@ export function defineApp(options) {
         throw result.failure.cause;
     return result.success;
 }
-/** Constructs a typed invalid-input failure. */
+/** Constructs a typed invalid-input failure.
+ * @param message - Safe author correction guidance.
+ * @returns The rejected validation effect.
+ */
 function invalid(message) {
     return Effect.fail(fromCause(new TypeError(message)));
 }
-/** Preserves the cause for the synchronous adapter. */
+/** Preserves the cause for the synchronous adapter.
+ * @typeParam Failure - Original validation or identity rejection.
+ * @param cause - Failure retained for the public synchronous boundary.
+ * @returns Typed validation error preserving its original cause.
+ */
 function fromCause(cause) {
-    if (cause instanceof DescriptorIdentityFailure)
-        cause = cause.cause;
+    const original = cause instanceof DescriptorIdentityFailure ? cause.cause : cause;
     return new AppValidationFailure({
-        message: cause instanceof Error ? cause.message : String(cause),
-        cause,
+        message: original instanceof Error ? original.message : String(original),
+        cause: original,
     });
 }
-/** Checks for a non-array record. */
+/** Checks that authoring input is a non-array object.
+ * @typeParam Value - Actual constructor input type retained by the guard.
+ * @param value - Candidate input before property access.
+ * @returns Whether the input is a non-null, non-array object.
+ */
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }

package/dist/define-app.js.map

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

package/dist/internal-runtime.d.ts

@@ -1,8 +1,9 @@
 /**
  * Exposes the framework-owned descriptor identity and application context wiring
- * needed by emitted hosts. Both exports preserve their authoring facade identity;
- * this entrypoint avoids evaluating unrelated agent and transport declarations.
+ * needed by emitted hosts, including selected dependency preflight. Re-exports
+ * preserve identity while resolving framework dependencies from their owning app.
  */
 export { bindDescriptorIdentity } from "@relkit/invocation";
 export { createApplicationContextResolver } from "./context-resolver.js";
+export { checkIntegrationDependencies, SelectedDependenciesLive, initializeIntegration, } from "@relkit/provider/internal/dependencies";
 //# sourceMappingURL=internal-runtime.d.ts.map

package/dist/internal-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-runtime.d.ts","sourceRoot":"","sources":["../src/internal-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"internal-runtime.d.ts","sourceRoot":"","sources":["../src/internal-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,wCAAwC,CAAC"}

package/dist/internal-runtime.js

@@ -1,8 +1,9 @@
 /**
  * Exposes the framework-owned descriptor identity and application context wiring
- * needed by emitted hosts. Both exports preserve their authoring facade identity;
- * this entrypoint avoids evaluating unrelated agent and transport declarations.
+ * needed by emitted hosts, including selected dependency preflight. Re-exports
+ * preserve identity while resolving framework dependencies from their owning app.
  */
 export { bindDescriptorIdentity } from "@relkit/invocation";
 export { createApplicationContextResolver } from "./context-resolver.js";
+export { checkIntegrationDependencies, SelectedDependenciesLive, initializeIntegration, } from "@relkit/provider/internal/dependencies";
 //# sourceMappingURL=internal-runtime.js.map

package/dist/internal-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal-runtime.js","sourceRoot":"","sources":["../src/internal-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"internal-runtime.js","sourceRoot":"","sources":["../src/internal-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,wCAAwC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relkit/app",
-  "version": "0.7.10",
+  "version": "0.8.1",
   "description": "The primary typed application-authoring API for RELKIT.",
   "license": "MIT",
   "repository": {
@@ -89,22 +89,22 @@
     }
   },
   "dependencies": {
-    "@relkit/agents": "0.7.10",
-    "@relkit/buckets": "0.7.10",
-    "@relkit/cache": "0.7.10",
-    "@relkit/config": "0.7.10",
-    "@relkit/contracts": "0.7.10",
-    "@relkit/events": "0.7.10",
-    "@relkit/functions": "0.7.10",
-    "@relkit/invocation": "0.7.10",
-    "@relkit/jobs": "0.7.10",
-    "@relkit/observability": "0.7.10",
-    "@relkit/provider": "0.7.10",
-    "@relkit/realtime": "0.7.10",
-    "@relkit/routes": "0.7.10",
-    "@relkit/schema": "0.7.10",
-    "@relkit/services": "0.7.10",
-    "@relkit/tools": "0.7.10",
+    "@relkit/agents": "0.8.1",
+    "@relkit/buckets": "0.7.12",
+    "@relkit/cache": "0.7.12",
+    "@relkit/config": "0.7.12",
+    "@relkit/contracts": "0.8.1",
+    "@relkit/events": "0.7.12",
+    "@relkit/functions": "0.7.12",
+    "@relkit/invocation": "0.7.12",
+    "@relkit/jobs": "0.7.12",
+    "@relkit/observability": "0.8.1",
+    "@relkit/provider": "0.8.1",
+    "@relkit/realtime": "0.7.12",
+    "@relkit/routes": "0.7.12",
+    "@relkit/schema": "0.7.12",
+    "@relkit/services": "0.7.12",
+    "@relkit/tools": "0.7.12",
     "effect": "4.0.1"
   },
   "devDependencies": {