create-relkit 0.5.6 → 0.7.0

package/dist/provider-profile-definition.js

@@ -0,0 +1,93 @@
+import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
+import { providerDefinitions } from "./provider-planning-definitions.js";
+/**
+ * Reexports the shared pure provider constructors used by profile selection.
+ */
+export const { awsDefinition, connectedCloudflare, connectedRedis, connectedS3, dockerDefinition } = providerDefinitions;
+/**
+ * Selects the source definition for a requested provider capability.
+ * @param capability - Requested provider capability.
+ * @param options - Explicit request options or declared prompt choices.
+ * @returns The local event/job or requested cache/bucket provider definition.
+ */
+export function definitionFor(capability, options) {
+    if (capability === "event" || capability === "job")
+        return localDefinition(capability);
+    if (capability === "cache")
+        return cacheDefinition(options);
+    return bucketDefinition(options);
+}
+/**
+ * Builds a local in-process event or job provider definition.
+ * @param capability - Requested provider capability.
+ * @returns The local adapter constructor source, import and dependency.
+ */
+export function localDefinition(capability) {
+    return {
+        adapter: capability === "event" ? "localEvent" : "localJob",
+        expression: capability === "event" ? "localEvent()" : "localJob()",
+        imports: [
+            `import { ${capability === "event" ? "localEvent" : "localJob"} } from "@relkit/local";`,
+        ],
+        dependencies: ["@relkit/local"],
+        environment: [],
+    };
+}
+/**
+ * Selects cache source using explicit provider/source choices and local defaults.
+ * @param options - Explicit request options or declared prompt choices.
+ * @returns The Redis or Cloudflare KV provider definition; unsupported pairings raise usage errors.
+ */
+export function cacheDefinition(options) {
+    const provider = options.provider ?? "redis";
+    const source = options.source ?? "docker";
+    if (provider === "cloudflare-kv") {
+        if (source !== "connected")
+            usage("Cloudflare KV supports only --source connected.");
+        return connectedCloudflare("kv");
+    }
+    if (source === "aws")
+        return awsDefinition("redis", 'aws(redis(), { engine: "valkey" })');
+    if (source === "connected")
+        return connectedRedis();
+    return dockerDefinition("redis", "docker(redis())");
+}
+/**
+ * Selects bucket source using explicit provider/source choices and local defaults.
+ * @param options - Explicit request options or declared prompt choices.
+ * @returns The S3 or Cloudflare R2 provider definition; unsupported pairings raise usage errors.
+ */
+export function bucketDefinition(options) {
+    const provider = options.provider ?? "s3";
+    const source = options.source ?? "docker";
+    if (provider === "cloudflare-r2") {
+        if (source !== "connected")
+            usage("Cloudflare R2 supports only --source connected.");
+        return connectedCloudflare("r2");
+    }
+    if (source === "aws")
+        return awsDefinition("s3", "aws(s3(), { versioning: true })");
+    if (source === "connected")
+        return connectedS3();
+    return dockerDefinition("s3", "docker(s3())");
+}
+/**
+ * Rejects unsupported or incomplete scaffold arguments.
+ * @param message - Diagnostic explaining the unsupported arguments.
+ * @returns No value; throws AddScaffoldError with RELKIT_ADD_USAGE.
+ */
+export function usage(message) {
+    throw new AddScaffoldError(ADD_FAILURE_CODES.usage, message);
+}
+/**
+ * Checks whether a discovered profile matches the requested adapter.
+ * @param existing - Existing authored declaration or adapter identity.
+ * @param requested - Explicitly requested declaration or adapter identity.
+ * @returns Whether exact adapter identities match, including discovered Docker-wrapped forms.
+ */
+export function sameProviderAdapter(existing, requested) {
+    return requested === "docker"
+        ? existing === "docker" || existing.startsWith("docker(")
+        : existing === requested;
+}
+//# sourceMappingURL=provider-profile-definition.js.map

package/dist/provider-profile-definition.js.map

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

package/dist/render-ai-sources.d.ts

@@ -1,9 +1,29 @@
 import { type DomainArtifact } from "./domain-planning.js";
+/**
+ * Binding and export form of a source artifact referenced by a renderer.
+ */
 type ArtifactReference = {
     readonly binding: string;
     readonly exportKind?: "default" | "named" | undefined;
 };
+/**
+ * Renders tool Source as source text without executing user modules.
+ * @param artifact - Normalized artifact identity, source path, binding and export metadata.
+ * @param target - Discovered domain or artifact target.
+ * @param targetModule - Source module specifier of the referenced callable or task.
+ * @param sideEffect - Side-effect category declared by the generated tool.
+ * @param approval - Approval policy declared by the generated tool.
+ * @returns TypeScript declaring a tool wrapper for the target callable with the selected effect/approval policy.
+ */
 export declare function toolSource(artifact: DomainArtifact, target: ArtifactReference, targetModule: string, sideEffect: "none" | "read" | "write" | "external", approval: "never" | "on-write" | "always"): string;
+/**
+ * Renders agent Source as source text without executing user modules.
+ * @param artifact - Normalized artifact identity, source path, binding and export metadata.
+ * @param model - Selected model profile/ID, or undefined for the deterministic offline model.
+ * @param tools - Resolved tool bindings, module paths and export forms.
+ * @param instructions - Inline instruction text or resolved prompt import metadata.
+ * @returns TypeScript declaring the agent, resolved tools/instructions and selected or offline model.
+ */
 export declare function agentSource(artifact: DomainArtifact, model: string | undefined, tools: readonly {
     readonly binding: string;
     readonly module: string;

package/dist/render-ai-sources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-ai-sources.d.ts","sourceRoot":"","sources":["../src/render-ai-sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEzE,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CACvD,CAAC;AAEF,wBAAgB,UAAU,CACxB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,iBAAiB,EACzB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,EAClD,QAAQ,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GACxC,MAAM,CAaR;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,SAAS;IACd,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CACvD,EAAE,EACH,YAAY,EAAE;IACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CACvD,GACA,MAAM,CAuBR"}
+{"version":3,"file":"render-ai-sources.d.ts","sourceRoot":"","sources":["../src/render-ai-sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEzE;;GAEG;AACH,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CACvD,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,iBAAiB,EACzB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,EAClD,QAAQ,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GACxC,MAAM,CAaR;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,SAAS;IACd,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CACvD,EAAE,EACH,YAAY,EAAE;IACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CACvD,GACA,MAAM,CAuBR"}

package/dist/render-ai-sources.js

@@ -1,4 +1,13 @@
 import { sourceImport } from "./domain-planning.js";
+/**
+ * Renders tool Source as source text without executing user modules.
+ * @param artifact - Normalized artifact identity, source path, binding and export metadata.
+ * @param target - Discovered domain or artifact target.
+ * @param targetModule - Source module specifier of the referenced callable or task.
+ * @param sideEffect - Side-effect category declared by the generated tool.
+ * @param approval - Approval policy declared by the generated tool.
+ * @returns TypeScript declaring a tool wrapper for the target callable with the selected effect/approval policy.
+ */
 export function toolSource(artifact, target, targetModule, sideEffect, approval) {
     return `${sourceImport(target.binding, targetModule, target.exportKind)}
 
@@ -13,6 +22,14 @@ const ${artifact.binding} = ${target.binding}.asTool({
 export default ${artifact.binding};
 `;
 }
+/**
+ * Renders agent Source as source text without executing user modules.
+ * @param artifact - Normalized artifact identity, source path, binding and export metadata.
+ * @param model - Selected model profile/ID, or undefined for the deterministic offline model.
+ * @param tools - Resolved tool bindings, module paths and export forms.
+ * @param instructions - Inline instruction text or resolved prompt import metadata.
+ * @returns TypeScript declaring the agent, resolved tools/instructions and selected or offline model.
+ */
 export function agentSource(artifact, model, tools, instructions) {
     const imports = [
         `import { defineAgent } from "@relkit/app/agents";`,
@@ -37,6 +54,10 @@ export function agentSource(artifact, model, tools, instructions) {
 export default ${artifact.binding};
 `;
 }
+/**
+ * Renders offline Model as source text without executing user modules.
+ * @returns A deterministic FakeToolCallingModel constructor expression for generated offline examples.
+ */
 function offlineModel() {
     return `new FakeToolCallingModel({
     toolCalls: [[{

package/dist/render-ai-sources.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-ai-sources.js","sourceRoot":"","sources":["../src/render-ai-sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,sBAAsB,CAAC;AAOzE,MAAM,UAAU,UAAU,CACxB,QAAwB,EACxB,MAAyB,EACzB,YAAoB,EACpB,UAAkD,EAClD,QAAyC;IAEzC,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC;;QAEjE,QAAQ,CAAC,OAAO,MAAM,MAAM,CAAC,OAAO;SACnC,QAAQ,CAAC,EAAE;kBACF,QAAQ,CAAC,IAAI,CAAC,KAAK;iBACpB,UAAU;eACZ,QAAQ;;;;iBAIN,QAAQ,CAAC,OAAO;CAChC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,QAAwB,EACxB,KAAyB,EACzB,KAIG,EACH,YAKC;IAED,MAAM,OAAO,GAAG;QACd,mDAAmD;QACnD,yCAAyC;QACzC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,mDAAmD,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAChF,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,MAAM;YAC7C,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;YACpF,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACzE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,OAAO;SAClD,QAAQ,CAAC,EAAE;;;WAGT,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;kBACrD,MAAM;YACZ,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;iBAIvC,QAAQ,CAAC,OAAO;CAChC,CAAC;AACF,CAAC;AAED,SAAS,YAAY;IACnB,OAAO;;;;;;KAMJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"render-ai-sources.js","sourceRoot":"","sources":["../src/render-ai-sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,sBAAsB,CAAC;AAUzE;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CACxB,QAAwB,EACxB,MAAyB,EACzB,YAAoB,EACpB,UAAkD,EAClD,QAAyC;IAEzC,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC;;QAEjE,QAAQ,CAAC,OAAO,MAAM,MAAM,CAAC,OAAO;SACnC,QAAQ,CAAC,EAAE;kBACF,QAAQ,CAAC,IAAI,CAAC,KAAK;iBACpB,UAAU;eACZ,QAAQ;;;;iBAIN,QAAQ,CAAC,OAAO;CAChC,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,QAAwB,EACxB,KAAyB,EACzB,KAIG,EACH,YAKC;IAED,MAAM,OAAO,GAAG;QACd,mDAAmD;QACnD,yCAAyC;QACzC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,mDAAmD,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAChF,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,MAAM;YAC7C,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;YACpF,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACzE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,OAAO;SAClD,QAAQ,CAAC,EAAE;;;WAGT,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;kBACrD,MAAM;YACZ,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;iBAIvC,QAAQ,CAAC,OAAO;CAChC,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY;IACnB,OAAO;;;;;;KAMJ,CAAC;AACN,CAAC"}

package/dist/render-ai.d.ts

@@ -1,10 +1,59 @@
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { type GeneratorDomainError, type GeneratorIoError } from "./generator-errors.js";
 import { type AddRequest } from "./add-types.js";
 import { type DomainTarget } from "./domain-planning.js";
 import { PlanBuilder } from "./plan-builder.js";
 import { type RenderedArtifact } from "./render-domain.js";
+/**
+ * Plans tool through the owning request and typed filesystem authority.
+ * @param builder - Per-request planning owner.
+ * @param target - Discovered domain or artifact target.
+ * @param request - Normalized scaffold request.
+ * @returns The planned tool source path and binding after request-state registration.
+ */
+export declare const renderToolEffect: (builder: PlanBuilder, target: DomainTarget, request: import("./add-types.js").AddRequestBase & Readonly<{
+    kind: "tool";
+    name: string;
+}> & Readonly<{
+    target: string;
+    createFunction?: boolean;
+    sideEffect: "none" | "read" | "write" | "external";
+    approval: "never" | "on-write" | "always";
+}>) => Effect.Effect<import("./domain-planning.types.js").DomainArtifact, GeneratorIoError | GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Plans agent through the owning request and typed filesystem authority.
+ * @param builder - Per-request planning owner.
+ * @param target - Discovered domain or artifact target.
+ * @param request - Normalized scaffold request.
+ * @returns The planned agent source path and binding after request-state registration.
+ */
+export declare const renderAgentEffect: (builder: PlanBuilder, target: DomainTarget, request: import("./add-types.js").AddRequestBase & Readonly<{
+    kind: "agent";
+    name: string;
+}> & Readonly<{
+    model?: string;
+    tools: readonly string[];
+    prompt?: string;
+    instructions?: string;
+}>) => Effect.Effect<import("./domain-planning.types.js").DomainArtifact, GeneratorIoError | GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Preserves the renderTool Promise compatibility API.
+ * @param builder - Per-request planning owner.
+ * @param target - Discovered domain or artifact target.
+ * @param request - Normalized scaffold request.
+ * @returns The planned tool source path and binding after typed planning settles.
+ */
 export declare function renderTool(builder: PlanBuilder, target: DomainTarget, request: Extract<AddRequest, {
     kind: "tool";
 }>): Promise<RenderedArtifact>;
+/**
+ * Preserves the renderAgent Promise compatibility API.
+ * @param builder - Per-request planning owner.
+ * @param target - Discovered domain or artifact target.
+ * @param request - Normalized scaffold request.
+ * @returns The planned agent source path and binding after typed planning settles.
+ */
 export declare function renderAgent(builder: PlanBuilder, target: DomainTarget, request: Extract<AddRequest, {
     kind: "agent";
 }>): Promise<RenderedArtifact>;

package/dist/render-ai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-ai.d.ts","sourceRoot":"","sources":["../src/render-ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,wBAAsB,UAAU,CAC9B,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7C,OAAO,CAAC,gBAAgB,CAAC,CA6B3B;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CAkC3B"}
+{"version":3,"file":"render-ai.d.ts","sourceRoot":"","sources":["../src/render-ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEjF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;uIAwC5B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;uIAoD7B,CAAC;AAkBF;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7C,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CAE3B"}

package/dist/render-ai.js

@@ -1,18 +1,30 @@
+import { Effect } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { scaffoldErrors, } from "./generator-errors.js";
+import { runGeneratorPromise } from "./generator-runtime.js";
 import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
 import { assertAvailableId, domainArtifact, resolveArtifact, sourceModule, } from "./domain-planning.js";
 import { PlanBuilder } from "./plan-builder.js";
 import { agentSource, toolSource } from "./render-ai-sources.js";
-import { renderFunction } from "./render-domain.js";
-export async function renderTool(builder, target, request) {
+import { renderFunctionEffect } from "./render-domain.js";
+/**
+ * Plans tool through the owning request and typed filesystem authority.
+ * @param builder - Per-request planning owner.
+ * @param target - Discovered domain or artifact target.
+ * @param request - Normalized scaffold request.
+ * @returns The planned tool source path and binding after request-state registration.
+ */
+export const renderToolEffect = Effect.fn("Scaffold.renderTool")(function* (builder, target, request) {
     const functionTarget = !request.createFunction &&
         (target.service ||
             builder.artifacts.some((item) => item.domain === target.domain.fileStem && item.kind === "function"))
         ? resolveArtifact(builder, target, "function", request.target)
-        : await renderFunction(builder, target, request.target);
+        : yield* renderFunctionEffect(builder, target, request.target);
     const artifact = domainArtifact(target, request.name, "tools", "tool", "tool");
     assertAvailableId(builder, artifact.id);
-    await builder.create(artifact.path, toolSource(artifact, functionTarget, sourceModule(functionTarget.path), request.sideEffect, request.approval));
-    builder.registerArtifact("tool", {
+    yield* builder.createEffect(artifact.path, toolSource(artifact, functionTarget, sourceModule(functionTarget.path), request.sideEffect, request.approval));
+    yield* builder.registerArtifactEffect("tool", {
         domain: target.domain.fileStem,
         path: artifact.path,
         binding: artifact.binding,
@@ -20,8 +32,15 @@ export async function renderTool(builder, target, request) {
         exportKind: artifact.exportKind,
     });
     return artifact;
-}
-export async function renderAgent(builder, target, request) {
+}, (effect) => observeExecution("generator", "planning.renderTool", scaffoldErrors(effect)));
+/**
+ * Plans agent through the owning request and typed filesystem authority.
+ * @param builder - Per-request planning owner.
+ * @param target - Discovered domain or artifact target.
+ * @param request - Normalized scaffold request.
+ * @returns The planned agent source path and binding after request-state registration.
+ */
+export const renderAgentEffect = Effect.fn("Scaffold.renderAgent")(function* (builder, target, request) {
     const artifact = domainArtifact(target, request.name, "agents", "agent", "agent");
     assertAvailableId(builder, artifact.id);
     if (request.model !== undefined) {
@@ -31,17 +50,21 @@ export async function renderAgent(builder, target, request) {
         }
     }
     else {
-        builder.dependency("langchain");
+        yield* builder.dependencyEffect("langchain");
     }
     const tools = request.tools.map((value) => {
         const tool = resolveArtifact(builder, target, "tool", value);
-        return { binding: tool.binding, module: sourceModule(tool.path), exportKind: tool.exportKind };
+        return {
+            binding: tool.binding,
+            module: sourceModule(tool.path),
+            exportKind: tool.exportKind,
+        };
     });
     const instructions = request.prompt
         ? promptInstructions(builder, target, request.prompt)
         : { text: request.instructions };
-    await builder.create(artifact.path, agentSource(artifact, request.model, tools, instructions));
-    builder.registerArtifact("agent", {
+    yield* builder.createEffect(artifact.path, agentSource(artifact, request.model, tools, instructions));
+    yield* builder.registerArtifactEffect("agent", {
         domain: target.domain.fileStem,
         path: artifact.path,
         binding: artifact.binding,
@@ -49,7 +72,14 @@ export async function renderAgent(builder, target, request) {
         exportKind: artifact.exportKind,
     });
     return artifact;
-}
+}, (effect) => observeExecution("generator", "planning.renderAgent", scaffoldErrors(effect)));
+/**
+ * Resolves a prompt artifact's import metadata for agent instructions.
+ * @param builder - Per-request planning owner.
+ * @param target - Discovered domain or artifact target.
+ * @param value - Prompt ID, binding or normalized source stem.
+ * @returns The prompt binding, @app module and export form.
+ */
 function promptInstructions(builder, target, value) {
     const prompt = resolveArtifact(builder, target, "prompt", value);
     return {
@@ -58,4 +88,24 @@ function promptInstructions(builder, target, value) {
         exportKind: prompt.exportKind,
     };
 }
+/**
+ * Preserves the renderTool Promise compatibility API.
+ * @param builder - Per-request planning owner.
+ * @param target - Discovered domain or artifact target.
+ * @param request - Normalized scaffold request.
+ * @returns The planned tool source path and binding after typed planning settles.
+ */
+export function renderTool(builder, target, request) {
+    return runGeneratorPromise(renderToolEffect(builder, target, request));
+}
+/**
+ * Preserves the renderAgent Promise compatibility API.
+ * @param builder - Per-request planning owner.
+ * @param target - Discovered domain or artifact target.
+ * @param request - Normalized scaffold request.
+ * @returns The planned agent source path and binding after typed planning settles.
+ */
+export function renderAgent(builder, target, request) {
+    return runGeneratorPromise(renderAgentEffect(builder, target, request));
+}
 //# sourceMappingURL=render-ai.js.map

package/dist/render-ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-ai.js","sourceRoot":"","sources":["../src/render-ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAmB,MAAM,gBAAgB,CAAC;AACtF,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,GAEb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAyB,MAAM,oBAAoB,CAAC;AAE3E,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAoB,EACpB,MAAoB,EACpB,OAA8C;IAE9C,MAAM,cAAc,GAClB,CAAC,OAAO,CAAC,cAAc;QACvB,CAAC,MAAM,CAAC,OAAO;YACb,OAAO,CAAC,SAAS,CAAC,IAAI,CACpB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,CAC7E,CAAC;QACF,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC;QAC9D,CAAC,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/E,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxC,MAAM,OAAO,CAAC,MAAM,CAClB,QAAQ,CAAC,IAAI,EACb,UAAU,CACR,QAAQ,EACR,cAAc,EACd,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC,EACjC,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,QAAQ,CACjB,CACF,CAAC;IACF,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QAC9B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAoB,EACpB,MAAoB,EACpB,OAA+C;IAE/C,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClF,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9C,IACE,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAC/D,EACD,CAAC;YACD,MAAM,IAAI,gBAAgB,CACxB,iBAAiB,CAAC,KAAK,EACvB,iBAAiB,OAAO,0DAA0D,CACnF,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxC,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IACjG,CAAC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM;QACjC,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;QACrD,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,YAAa,EAAE,CAAC;IACpC,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;IAC/F,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE;QAChC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QAC9B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAoB,EAAE,MAAoB,EAAE,KAAa;IACnF,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjE,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"render-ai.js","sourceRoot":"","sources":["../src/render-ai.ts"],"names":[],"mappings":"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"}

package/dist/render-auth-schema.d.ts

@@ -1,3 +1,8 @@
 import type { DatabaseDialect } from "./add-types.js";
+/**
+ * Renders the authentication tables for a supported database dialect.
+ * @param dialect - Database dialect selected for the auth service.
+ * @returns Drizzle schema source for user, session, account and verification tables.
+ */
 export declare function authSchemaSource(dialect: DatabaseDialect): string;
 //# sourceMappingURL=render-auth-schema.d.ts.map

package/dist/render-auth-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-auth-schema.d.ts","sourceRoot":"","sources":["../src/render-auth-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAsCtD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAyDjE"}
+{"version":3,"file":"render-auth-schema.d.ts","sourceRoot":"","sources":["../src/render-auth-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA4CtD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAyDjE"}

package/dist/render-auth-schema.js

@@ -1,3 +1,6 @@
+/**
+ * Dialect-specific Drizzle constructors used by generated authentication tables.
+ */
 const DIALECTS = {
     sqlite: {
         imports: "integer, sqliteTable, text, uniqueIndex",
@@ -24,6 +27,11 @@ const DIALECTS = {
         timestamp: "datetime()",
     },
 };
+/**
+ * Renders the authentication tables for a supported database dialect.
+ * @param dialect - Database dialect selected for the auth service.
+ * @returns Drizzle schema source for user, session, account and verification tables.
+ */
 export function authSchemaSource(dialect) {
     const value = DIALECTS[dialect];
     const module = dialect === "postgresql" ? "pg" : dialect;

package/dist/render-auth-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-auth-schema.js","sourceRoot":"","sources":["../src/render-auth-schema.ts"],"names":[],"mappings":"AAWA,MAAM,QAAQ,GAAmD;IAC/D,MAAM,EAAE;QACN,OAAO,EAAE,yCAAyC;QAClD,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,8BAA8B;QACvC,SAAS,EAAE,gCAAgC;KAC5C;IACD,UAAU,EAAE;QACV,OAAO,EAAE,gDAAgD;QACzD,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,mCAAmC;KAC/C;IACD,KAAK,EAAE;QACL,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,0BAA0B;QAClC,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,YAAY;KACxB;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;IACzD,OAAO,YAAY,KAAK,CAAC,OAAO,wBAAwB,MAAM;;;eAGjD,KAAK,CAAC,SAAS;eACf,KAAK,CAAC,SAAS;;;sBAGR,KAAK,CAAC,KAAK;QACzB,KAAK,CAAC,MAAM;UACV,KAAK,CAAC,MAAM;WACX,KAAK,CAAC,MAAM;mBACJ,KAAK,CAAC,OAAO;WACrB,KAAK,CAAC,KAAK;;;;yBAIG,KAAK,CAAC,KAAK;QAC5B,KAAK,CAAC,MAAM;eACL,KAAK,CAAC,SAAS;WACnB,KAAK,CAAC,MAAM;eACR,KAAK,CAAC,MAAM;eACZ,KAAK,CAAC,KAAK;YACd,KAAK,CAAC,MAAM;;;;yBAIC,KAAK,CAAC,KAAK;;;UAG1B,KAAK,CAAC,MAAM;iBACL,KAAK,CAAC,MAAM;cACf,KAAK,CAAC,MAAM;kBACR,KAAK,CAAC,MAAM;cAChB,KAAK,CAAC,MAAM;mBACP,KAAK,CAAC,KAAK;oBACV,KAAK,CAAC,KAAK;eAChB,KAAK,CAAC,KAAK;4BACE,KAAK,CAAC,SAAS;6BACd,KAAK,CAAC,SAAS;aAC/B,KAAK,CAAC,MAAM;gBACT,KAAK,CAAC,KAAK;;;;;;8BAMG,KAAK,CAAC,KAAK;QACjC,KAAK,CAAC,MAAM;gBACJ,KAAK,CAAC,MAAM;WACjB,KAAK,CAAC,KAAK;eACP,KAAK,CAAC,SAAS;;;CAG7B,CAAC;AACF,CAAC"}
+{"version":3,"file":"render-auth-schema.js","sourceRoot":"","sources":["../src/render-auth-schema.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,QAAQ,GAAmD;IAC/D,MAAM,EAAE;QACN,OAAO,EAAE,yCAAyC;QAClD,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,8BAA8B;QACvC,SAAS,EAAE,gCAAgC;KAC5C;IACD,UAAU,EAAE;QACV,OAAO,EAAE,gDAAgD;QACzD,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,mCAAmC;KAC/C;IACD,KAAK,EAAE;QACL,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,0BAA0B;QAClC,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,YAAY;KACxB;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;IACzD,OAAO,YAAY,KAAK,CAAC,OAAO,wBAAwB,MAAM;;;eAGjD,KAAK,CAAC,SAAS;eACf,KAAK,CAAC,SAAS;;;sBAGR,KAAK,CAAC,KAAK;QACzB,KAAK,CAAC,MAAM;UACV,KAAK,CAAC,MAAM;WACX,KAAK,CAAC,MAAM;mBACJ,KAAK,CAAC,OAAO;WACrB,KAAK,CAAC,KAAK;;;;yBAIG,KAAK,CAAC,KAAK;QAC5B,KAAK,CAAC,MAAM;eACL,KAAK,CAAC,SAAS;WACnB,KAAK,CAAC,MAAM;eACR,KAAK,CAAC,MAAM;eACZ,KAAK,CAAC,KAAK;YACd,KAAK,CAAC,MAAM;;;;yBAIC,KAAK,CAAC,KAAK;;;UAG1B,KAAK,CAAC,MAAM;iBACL,KAAK,CAAC,MAAM;cACf,KAAK,CAAC,MAAM;kBACR,KAAK,CAAC,MAAM;cAChB,KAAK,CAAC,MAAM;mBACP,KAAK,CAAC,KAAK;oBACV,KAAK,CAAC,KAAK;eAChB,KAAK,CAAC,KAAK;4BACE,KAAK,CAAC,SAAS;6BACd,KAAK,CAAC,SAAS;aAC/B,KAAK,CAAC,MAAM;gBACT,KAAK,CAAC,KAAK;;;;;;8BAMG,KAAK,CAAC,KAAK;QACjC,KAAK,CAAC,MAAM;gBACJ,KAAK,CAAC,MAAM;WACjB,KAAK,CAAC,KAAK;eACP,KAAK,CAAC,SAAS;;;CAG7B,CAAC;AACF,CAAC"}

package/dist/render-auth-sources.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Renders auth Service Source as source text without executing user modules.
+ * @returns TypeScript declaring an email/password Better Auth service with a local URL fallback.
+ */
 export declare function authServiceSource(): string;
+/**
+ * Renders auth Route Source as source text without executing user modules.
+ * @returns TypeScript exporting the auth handler as an ALL route.
+ */
 export declare function authRouteSource(): string;
 //# sourceMappingURL=render-auth-sources.d.ts.map

package/dist/render-auth-sources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-auth-sources.d.ts","sourceRoot":"","sources":["../src/render-auth-sources.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAED,wBAAgB,eAAe,IAAI,MAAM,CAMxC"}
+{"version":3,"file":"render-auth-sources.d.ts","sourceRoot":"","sources":["../src/render-auth-sources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC"}

package/dist/render-auth-sources.js

@@ -1,3 +1,7 @@
+/**
+ * Renders auth Service Source as source text without executing user modules.
+ * @returns TypeScript declaring an email/password Better Auth service with a local URL fallback.
+ */
 export function authServiceSource() {
     return `import { defineBetterAuthService } from "@relkit/better-auth";
 
@@ -7,6 +11,10 @@ export default defineBetterAuthService({
 });
 `;
 }
+/**
+ * Renders auth Route Source as source text without executing user modules.
+ * @returns TypeScript exporting the auth handler as an ALL route.
+ */
 export function authRouteSource() {
     return `import { defineRoute } from "@relkit/app/routes";
 import auth from "@app/auth/service.js";

package/dist/render-auth-sources.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-auth-sources.js","sourceRoot":"","sources":["../src/render-auth-sources.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB;IAC/B,OAAO;;;;;;CAMR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;CAIR,CAAC;AACF,CAAC"}
+{"version":3,"file":"render-auth-sources.js","sourceRoot":"","sources":["../src/render-auth-sources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;;;;;;CAMR,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;CAIR,CAAC;AACF,CAAC"}

package/dist/render-auth.d.ts

@@ -1,5 +1,26 @@
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { type GeneratorDomainError, type GeneratorIoError } from "./generator-errors.js";
 import { type AddRequest } from "./add-types.js";
 import { PlanBuilder } from "./plan-builder.js";
+/**
+ * Plans auth through the owning request and typed filesystem authority.
+ * @param builder - Per-request planning owner.
+ * @param request - Normalized scaffold request.
+ * @returns Completion after auth service, schema, routes and dependencies are planned.
+ */
+export declare const renderAuthEffect: (builder: PlanBuilder, request: import("./add-types.js").AddRequestBase & {
+    readonly kind: "auth";
+    readonly adapter: "better-auth";
+    readonly databaseDialect: import("./add-types.js").DatabaseDialect;
+    readonly basePath: string;
+}) => Effect.Effect<void, GeneratorIoError | GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Preserves the renderAuth Promise compatibility API.
+ * @param builder - Per-request planning owner.
+ * @param request - Normalized scaffold request.
+ * @returns Completion after the existing contract has been applied.
+ */
 export declare function renderAuth(builder: PlanBuilder, request: Extract<AddRequest, {
     kind: "auth";
 }>): Promise<void>;

package/dist/render-auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-auth.d.ts","sourceRoot":"","sources":["../src/render-auth.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUhD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CA0Cf"}
+{"version":3,"file":"render-auth.d.ts","sourceRoot":"","sources":["../src/render-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAahD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;uFAmD5B,CAAC;AAuGF;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAEf"}