create-relkit 0.4.0 → 0.5.0

package/dist/render-service.js

@@ -0,0 +1,124 @@
+import { ADD_FAILURE_CODES, AddScaffoldError, } from "./add-types.js";
+import { normalizeArtifactName } from "./add-name.js";
+import { serviceSource } from "./domain-planning.js";
+import { PlanBuilder } from "./plan-builder.js";
+import { renderAgent, renderTool } from "./render-ai.js";
+import { renderConstants, renderError, renderEvent, renderEventFunction, renderFunction, renderJob, renderTask, renderPrompt, } from "./render-domain.js";
+import { renderBucket, renderCache } from "./render-resources.js";
+import { renderRoute } from "./render-routes.js";
+const FULL = [
+    "function",
+    "event-function",
+    "task",
+    "error",
+    "event",
+    "job",
+    "cache",
+    "bucket",
+    "tool",
+    "prompt",
+    "agent",
+    "constants",
+    "route",
+];
+export async function renderService(builder, request) {
+    const domain = normalizeArtifactName(request.name);
+    if (builder.discovery.services.some((service) => service.domain === domain.fileStem) ||
+        builder.discovery.artifacts.some((artifact) => artifact.domain === domain.fileStem)) {
+        throw new AddScaffoldError(ADD_FAILURE_CODES.collision, `Domain ${domain.fileStem} already exists.`);
+    }
+    const target = {
+        domain,
+        servicePath: `src/${domain.fileStem}/service.ts`,
+        service: undefined,
+    };
+    await builder.create(target.servicePath, serviceSource(domain));
+    const selected = closure(request.full ? FULL : request.include.length ? request.include : ["function"]);
+    const error = selected.has("error") ? await renderError(builder, target, "example") : undefined;
+    const event = selected.has("event") ? await renderEvent(builder, target, "example") : undefined;
+    const fn = selected.has("function")
+        ? await renderFunction(builder, target, "example", {
+            ...(error ? { error } : {}),
+            ...(event ? { event } : {}),
+        })
+        : undefined;
+    const taskExecution = selected.has("task") ? taskExecutionFor(builder) : undefined;
+    const task = selected.has("task")
+        ? await renderTask(builder, target, requestFor(builder, "task", {
+            name: "Example",
+            version: "1",
+            execution: taskExecution ?? "durable",
+        }))
+        : undefined;
+    if (selected.has("event-function")) {
+        await renderEventFunction(builder, target, requestFor(builder, "event-function", {
+            name: "On Example",
+            event: event?.id ?? "example",
+            delivery: "durable",
+        }));
+    }
+    if (selected.has("job")) {
+        await renderJob(builder, target, requestFor(builder, "job", { name: "Example", target: task?.id ?? fn?.id ?? "example" }));
+    }
+    if (selected.has("cache")) {
+        await renderCache(builder, target, requestFor(builder, "cache", { name: "Example" }));
+    }
+    if (selected.has("bucket")) {
+        await renderBucket(builder, target, requestFor(builder, "bucket", { name: "Example" }));
+    }
+    const tool = selected.has("tool")
+        ? await renderTool(builder, target, requestFor(builder, "tool", {
+            name: "Example",
+            target: fn?.id ?? "example",
+            sideEffect: "read",
+            approval: "never",
+        }))
+        : undefined;
+    const prompt = selected.has("prompt")
+        ? await renderPrompt(builder, target, "Example", [
+            "Use the available tool and answer concisely.",
+        ])
+        : undefined;
+    if (selected.has("agent")) {
+        await renderAgent(builder, target, requestFor(builder, "agent", {
+            name: "Example",
+            tools: tool ? [tool.id] : [],
+            prompt: prompt?.id ?? "example",
+        }));
+    }
+    if (selected.has("constants"))
+        await renderConstants(builder, target, "Example");
+    if (selected.has("route")) {
+        await renderRoute(builder, requestFor(builder, "route", {
+            path: `/${domain.fileStem}`,
+            mode: "service-route",
+            maps: { GET: fn?.binding ?? "example" },
+        }), target);
+    }
+}
+function taskExecutionFor(builder) {
+    const profile = builder.profiles.find((item) => item.capability === "job" && item.isDefault);
+    return profile?.adapter?.includes("effectMq") ? "retryable" : "durable";
+}
+function closure(input) {
+    const selected = new Set(input);
+    if (["error", "job", "tool", "route"].some((kind) => selected.has(kind)))
+        selected.add("function");
+    if (selected.has("event-function"))
+        selected.add("event");
+    if (selected.has("agent")) {
+        selected.add("function");
+        selected.add("tool");
+        selected.add("prompt");
+    }
+    return selected;
+}
+function requestFor(builder, kind, options) {
+    return {
+        kind,
+        projectRoot: builder.discovery.projectRoot,
+        install: builder.request.install,
+        ...options,
+    };
+}
+//# sourceMappingURL=render-service.js.map

package/dist/render-service.js.map

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

package/dist/scaffold-catalog.d.ts

@@ -0,0 +1,75 @@
+export type DependencySection = "dependencies" | "devDependencies";
+export interface ScaffoldDependency {
+    readonly version: string;
+    readonly section: DependencySection;
+}
+/** Versions copied into generated projects; first-party packages share this fixed release train. */
+export declare const SCAFFOLD_DEPENDENCIES: Readonly<{
+    "@relkit/aws": {
+        version: string;
+        section: "dependencies";
+    };
+    "@relkit/better-auth": {
+        version: string;
+        section: "dependencies";
+    };
+    "@relkit/cloudflare": {
+        version: string;
+        section: "dependencies";
+    };
+    "@relkit/docker": {
+        version: string;
+        section: "dependencies";
+    };
+    "@relkit/effect-mq": {
+        version: string;
+        section: "dependencies";
+    };
+    "@relkit/inngest": {
+        version: string;
+        section: "dependencies";
+    };
+    "@relkit/drizzle": {
+        version: string;
+        section: "dependencies";
+    };
+    "@relkit/local": {
+        version: string;
+        section: "dependencies";
+    };
+    "@relkit/pulumi": {
+        version: string;
+        section: "dependencies";
+    };
+    "@relkit/redis": {
+        version: string;
+        section: "dependencies";
+    };
+    "@relkit/s3": {
+        version: string;
+        section: "dependencies";
+    };
+    "@relkit/trigger": {
+        version: string;
+        section: "dependencies";
+    };
+    "better-auth": {
+        version: string;
+        section: "dependencies";
+    };
+    "drizzle-kit": {
+        version: string;
+        section: "devDependencies";
+    };
+    "drizzle-orm": {
+        version: string;
+        section: "dependencies";
+    };
+    langchain: {
+        version: string;
+        section: "dependencies";
+    };
+}>;
+export type ScaffoldDependencyName = keyof typeof SCAFFOLD_DEPENDENCIES;
+export declare function scaffoldDependency(name: ScaffoldDependencyName): ScaffoldDependency;
+//# sourceMappingURL=scaffold-catalog.d.ts.map

package/dist/scaffold-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-catalog.d.ts","sourceRoot":"","sources":["../src/scaffold-catalog.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,iBAAiB,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC;AAED,oGAAoG;AACpG,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBuB,CAAC;AAE1D,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAExE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,kBAAkB,CAEnF"}

package/dist/scaffold-catalog.js

@@ -0,0 +1,24 @@
+import manifest from "../package.json" with { type: "json" };
+/** Versions copied into generated projects; first-party packages share this fixed release train. */
+export const SCAFFOLD_DEPENDENCIES = Object.freeze({
+    "@relkit/aws": { version: manifest.version, section: "dependencies" },
+    "@relkit/better-auth": { version: manifest.version, section: "dependencies" },
+    "@relkit/cloudflare": { version: manifest.version, section: "dependencies" },
+    "@relkit/docker": { version: manifest.version, section: "dependencies" },
+    "@relkit/effect-mq": { version: manifest.version, section: "dependencies" },
+    "@relkit/inngest": { version: manifest.version, section: "dependencies" },
+    "@relkit/drizzle": { version: manifest.version, section: "dependencies" },
+    "@relkit/local": { version: manifest.version, section: "dependencies" },
+    "@relkit/pulumi": { version: manifest.version, section: "dependencies" },
+    "@relkit/redis": { version: manifest.version, section: "dependencies" },
+    "@relkit/s3": { version: manifest.version, section: "dependencies" },
+    "@relkit/trigger": { version: manifest.version, section: "dependencies" },
+    "better-auth": { version: "1.7.1", section: "dependencies" },
+    "drizzle-kit": { version: "1.0.0-rc.5-ab785fc", section: "devDependencies" },
+    "drizzle-orm": { version: "1.0.0-rc.5-169397b", section: "dependencies" },
+    langchain: { version: "1.5.10", section: "dependencies" },
+});
+export function scaffoldDependency(name) {
+    return SCAFFOLD_DEPENDENCIES[name];
+}
+//# sourceMappingURL=scaffold-catalog.js.map

package/dist/scaffold-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-catalog.js","sourceRoot":"","sources":["../src/scaffold-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAS7D,oGAAoG;AACpG,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,aAAa,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IACrE,qBAAqB,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IAC7E,oBAAoB,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IAC5E,gBAAgB,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IACxE,mBAAmB,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IAC3E,iBAAiB,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IACzE,iBAAiB,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IACzE,eAAe,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IACvE,gBAAgB,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IACxE,eAAe,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IACvE,YAAY,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IACpE,iBAAiB,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IACzE,aAAa,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;IAC5D,aAAa,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,iBAAiB,EAAE;IAC5E,aAAa,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,EAAE;IACzE,SAAS,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE;CACH,CAAC,CAAC;AAI1D,MAAM,UAAU,kBAAkB,CAAC,IAA4B;IAC7D,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/source-edit.d.ts

@@ -0,0 +1,10 @@
+import * as ts from "typescript";
+export { addSourceImport } from "./source-import-edit.js";
+/** Appends one export declaration after validating the source syntax. */
+export declare function addSourceExport(source: string, fileName: string, declaration: string): string;
+/** Inserts one property into a canonical factory object or one nested object property. */
+export declare function addFactoryObjectMember(source: string, fileName: string, factories: readonly string[], path: readonly string[], memberName: string, memberSource: string): string;
+export declare function readFactoryObject(source: string, fileName: string, factories: readonly string[]): ts.ObjectLiteralExpression;
+export declare function readFactoryStringProperty(source: string, fileName: string, factory: string, name: string, argumentIndex?: number): string | undefined;
+export declare function staticPropertyName(node: ts.PropertyName | undefined): string | undefined;
+//# sourceMappingURL=source-edit.d.ts.map

package/dist/source-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-edit.d.ts","sourceRoot":"","sources":["../src/source-edit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAI7F;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,MAAM,CAaR;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,EAAE,CAAC,uBAAuB,CAE5B;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,aAAa,SAAI,GAChB,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMxF"}

package/dist/source-edit.js

@@ -0,0 +1,136 @@
+import * as ts from "typescript";
+import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
+export { addSourceImport } from "./source-import-edit.js";
+/** Appends one export declaration after validating the source syntax. */
+export function addSourceExport(source, fileName, declaration) {
+    if (source.includes(declaration))
+        return source;
+    parse(fileName, source);
+    return `${source.trimEnd()}\n${declaration}\n`;
+}
+/** Inserts one property into a canonical factory object or one nested object property. */
+export function addFactoryObjectMember(source, fileName, factories, path, memberName, memberSource) {
+    const file = parse(fileName, source);
+    const root = factoryObject(file, factories);
+    const target = descend(root, path, source, memberSource);
+    assertObject(target.object, source);
+    const existing = !target.created ? property(target.object, memberName) : undefined;
+    if (existing !== undefined) {
+        const current = source.slice(existing.getStart(), existing.getEnd()).replace(/\s+/g, " ");
+        if (current === memberSource.replace(/\s+/g, " "))
+            return source;
+        collision(fileName, [...path, memberName]);
+    }
+    const insertion = target.created ? `${target.name}: { ${memberSource} }` : memberSource;
+    return insertMember(source, target.parent ?? target.object, insertion);
+}
+export function readFactoryObject(source, fileName, factories) {
+    return factoryObject(parse(fileName, source), factories);
+}
+export function readFactoryStringProperty(source, fileName, factory, name, argumentIndex = 0) {
+    const object = factoryObject(parse(fileName, source), [factory], argumentIndex);
+    const item = property(object, name);
+    return item && ts.isPropertyAssignment(item) && ts.isStringLiteralLike(item.initializer)
+        ? item.initializer.text
+        : undefined;
+}
+export function staticPropertyName(node) {
+    if (node === undefined)
+        return undefined;
+    if (ts.isIdentifier(node) || ts.isStringLiteralLike(node) || ts.isNumericLiteral(node)) {
+        return node.text;
+    }
+    return undefined;
+}
+function factoryObject(file, factories, argumentIndex = 0) {
+    const matches = [];
+    const visit = (node) => {
+        if (ts.isCallExpression(node) && factories.includes(lastSegment(node.expression))) {
+            const argument = unwrap(node.arguments[argumentIndex]);
+            if (!argument || !ts.isObjectLiteralExpression(argument))
+                unsupported(file.fileName);
+            matches.push(argument);
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(file);
+    if (matches.length !== 1)
+        unsupported(file.fileName);
+    return matches[0];
+}
+function descend(root, path, source, memberSource) {
+    let object = root;
+    for (const [index, name] of path.entries()) {
+        assertObject(object, source);
+        const found = property(object, name);
+        if (found === undefined) {
+            if (index !== path.length - 1)
+                unsupported("nested object");
+            return { object, parent: object, name, created: true };
+        }
+        if (!ts.isPropertyAssignment(found))
+            unsupported(name);
+        const value = unwrap(found.initializer);
+        if (!value || !ts.isObjectLiteralExpression(value))
+            unsupported(name);
+        object = value;
+    }
+    return { object, name: path.at(-1) ?? memberSource, created: false };
+}
+function insertMember(source, object, member) {
+    const close = object.getEnd() - 1;
+    const body = source.slice(object.getStart() + 1, close);
+    if (object.properties.length === 0) {
+        return `${source.slice(0, object.getStart() + 1)} ${member} ${source.slice(close)}`;
+    }
+    if (!body.includes("\n")) {
+        const last = object.properties.at(-1);
+        return `${source.slice(0, last.getEnd())}, ${member}${source.slice(last.getEnd())}`;
+    }
+    const last = object.properties.at(-1);
+    const between = source.slice(last.getEnd(), close);
+    const comma = between.trimStart().startsWith(",") ? "" : ",";
+    const lineStart = source.lastIndexOf("\n", close - 1) + 1;
+    const closeIndent = source.slice(lineStart, close);
+    return `${source.slice(0, last.getEnd())}${comma}${source.slice(last.getEnd(), close)}${closeIndent}  ${member},\n${closeIndent}${source.slice(close)}`;
+}
+function assertObject(object, source) {
+    for (const item of object.properties) {
+        if (ts.isSpreadAssignment(item) || staticPropertyName(item.name) === undefined) {
+            unsupported(source.slice(item.getStart(), item.getEnd()));
+        }
+    }
+}
+function property(object, name) {
+    return object.properties.find((item) => staticPropertyName(item.name) === name);
+}
+function parse(fileName, source) {
+    const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const diagnostics = file.parseDiagnostics;
+    if (diagnostics?.length)
+        unsupported(fileName);
+    return file;
+}
+function unwrap(value) {
+    let current = value;
+    while (current &&
+        (ts.isParenthesizedExpression(current) ||
+            ts.isAsExpression(current) ||
+            ts.isSatisfiesExpression(current)))
+        current = current.expression;
+    return current;
+}
+function lastSegment(expression) {
+    return ts.isIdentifier(expression)
+        ? expression.text
+        : ts.isPropertyAccessExpression(expression)
+            ? expression.name.text
+            : "";
+}
+function collision(fileName, path) {
+    throw new AddScaffoldError(ADD_FAILURE_CODES.collision, `${fileName} already declares ${path.join(".")}.`);
+}
+function unsupported(label) {
+    throw new AddScaffoldError(ADD_FAILURE_CODES.unsupportedSourceShape, `Cannot safely edit canonical object in ${label}.`);
+}
+//# sourceMappingURL=source-edit.js.map

package/dist/source-edit.js.map

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

package/dist/source-import-edit.d.ts

@@ -0,0 +1,3 @@
+/** Adds or merges one import declaration without reprinting the source file. */
+export declare function addSourceImport(source: string, fileName: string, declaration: string): string;
+//# sourceMappingURL=source-import-edit.d.ts.map

package/dist/source-import-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-import-edit.d.ts","sourceRoot":"","sources":["../src/source-import-edit.ts"],"names":[],"mappings":"AAGA,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAmC7F"}

package/dist/source-import-edit.js

@@ -0,0 +1,52 @@
+import * as ts from "typescript";
+import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
+/** Adds or merges one import declaration without reprinting the source file. */
+export function addSourceImport(source, fileName, declaration) {
+    if (source.includes(declaration))
+        return source;
+    const file = parse(fileName, source);
+    const wantedFile = parse("import.ts", declaration);
+    const wanted = wantedFile.statements.find(ts.isImportDeclaration);
+    if (!wanted || !ts.isStringLiteralLike(wanted.moduleSpecifier))
+        return append(source, file, declaration);
+    const moduleName = wanted.moduleSpecifier.text;
+    const existing = file.statements
+        .filter(ts.isImportDeclaration)
+        .find((item) => ts.isStringLiteralLike(item.moduleSpecifier) && item.moduleSpecifier.text === moduleName);
+    const currentBindings = existing?.importClause?.namedBindings;
+    const wantedBindings = wanted.importClause?.namedBindings;
+    if (existing &&
+        !existing.importClause?.name &&
+        !wanted.importClause?.name &&
+        currentBindings &&
+        ts.isNamedImports(currentBindings) &&
+        wantedBindings &&
+        ts.isNamedImports(wantedBindings)) {
+        const current = new Set(currentBindings.elements.map((item) => item.getText(file)));
+        const missing = wantedBindings.elements
+            .map((item) => item.getText(wantedFile))
+            .filter((item) => !current.has(item));
+        if (missing.length === 0)
+            return source;
+        const end = currentBindings.elements.at(-1)?.getEnd() ?? currentBindings.getStart() + 1;
+        const separator = currentBindings.elements.length ? ", " : "";
+        return `${source.slice(0, end)}${separator}${missing.join(", ")}${source.slice(end)}`;
+    }
+    return append(source, file, declaration);
+}
+function parse(fileName, source) {
+    const file = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const diagnostics = file.parseDiagnostics;
+    if (diagnostics?.length) {
+        throw new AddScaffoldError(ADD_FAILURE_CODES.unsupportedSourceShape, `Cannot safely edit imports in ${fileName}.`);
+    }
+    return file;
+}
+function append(source, file, declaration) {
+    const imports = file.statements.filter(ts.isImportDeclaration);
+    const offset = imports.at(-1)?.getEnd() ?? 0;
+    return offset === 0
+        ? `${declaration}\n${source}`
+        : `${source.slice(0, offset)}\n${declaration}${source.slice(offset)}`;
+}
+//# sourceMappingURL=source-import-edit.js.map

package/dist/source-import-edit.js.map

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

package/dist/template-root.d.ts

@@ -0,0 +1,5 @@
+export declare function resolveTemplateRoot(context: {
+    readonly cwd?: string;
+    readonly templateRoot?: string;
+}): string;
+//# sourceMappingURL=template-root.d.ts.map

package/dist/template-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-root.d.ts","sourceRoot":"","sources":["../src/template-root.ts"],"names":[],"mappings":"AAIA,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC,GAAG,MAAM,CAOT"}

package/dist/template-root.js

@@ -0,0 +1,15 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export function resolveTemplateRoot(context) {
+    if (context.templateRoot !== undefined)
+        return resolve(context.templateRoot);
+    const packaged = fileURLToPath(new URL("./templates/default/v1", import.meta.url));
+    if (existsSync(packaged))
+        return resolve(packaged);
+    const source = fileURLToPath(new URL("../../../templates/default/v1", import.meta.url));
+    if (existsSync(source))
+        return resolve(source);
+    return resolve(context.cwd ?? process.cwd(), "templates/default/v1");
+}
+//# sourceMappingURL=template-root.js.map

package/dist/template-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-root.js","sourceRoot":"","sources":["../src/template-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,mBAAmB,CAAC,OAGnC;IACC,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,+BAA+B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxF,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC;AACvE,CAAC"}

package/dist/templates/default/README.md

@@ -8,6 +8,6 @@ scaffolder:
 - `agent` — the minimal example plus a read-only tool and agent descriptor.
 
 Each variant is self-contained and can be copied as a project root. It uses
-the current checked-in RelKit package version (`0.4.0`), Bun `1.3.10`, and
+the current checked-in RelKit package version (`0.5.0`), Bun `1.3.10`, and
 TypeScript `5.9.3`. The generator owns project-name substitution and later
 installation/Git behavior.

package/dist/templates/default/v1/agent/.env.example

@@ -1,3 +1 @@
 LOG_LEVEL=info
-OPENAI_API_KEY=
-ANTHROPIC_API_KEY=

package/dist/templates/default/v1/agent/README.md

@@ -1,11 +1,9 @@
 # my-app
 
-A RelKit TypeScript/Bun project with the minimal HTTP example and a bounded
-agent backed by a function-derived read-only tool. Tests use a deterministic
-scripted model, while production resolves the selected AI SDK profile.
-
-The agent may omit `model` to use the configured default profile. OpenAI and
-Anthropic credentials remain named binding-local values.
+A RelKit TypeScript/Bun project with a bounded native LangChain agent and a
+native LangGraph review workflow. The starter uses LangChain's deterministic
+model plus local realtime and thread-state providers, so it runs without an API
+key. Replace the model when connecting a production provider.
 
 ## Commands
 
@@ -18,5 +16,6 @@ bun run typecheck
 bun run build
 ```
 
-The example route is `GET /hello?name=RelKit`. Agent prompt and result content
-are not captured by default.
+The example route is `GET /hello?name=RelKit`. The assistant exposes typed todo
+state and both native and function-derived tools. The review graph demonstrates
+a typed interrupt and resume on an application-owned `threadId`.

package/dist/templates/default/v1/agent/package.json

@@ -15,13 +15,15 @@
     "graph": "relkit graph print"
   },
   "dependencies": {
-    "@relkit/ai-sdk": "0.4.0",
-    "@relkit/app": "0.4.0"
+    "@langchain/langgraph": "1.4.14",
+    "@relkit/app": "0.5.0",
+    "@relkit/local": "0.5.0",
+    "langchain": "1.5.10"
   },
   "devDependencies": {
     "@types/bun": "1.3.10",
-    "@relkit/cli": "0.4.0",
-    "@relkit/testing": "0.4.0",
+    "@relkit/cli": "0.5.0",
+    "@relkit/testing": "0.5.0",
     "typescript": "5.9.3"
   }
 }

package/dist/templates/default/v1/agent/relkit.config.ts

@@ -1,23 +1,13 @@
-import { aiSdk } from "@relkit/ai-sdk";
-import { defineApp, env as binding } from "@relkit/app/config";
+import { defineApp } from "@relkit/app/config";
+import { localAgentState, localRealtime } from "@relkit/local";
 import env from "@app/platform/env.js";
 // relkit:create:deployment-imports
 
 export default defineApp({
   env,
-  model: {
-    openai: aiSdk({
-      provider: "openai",
-      defaultModel: "gpt-5-mini",
-      apiKey: binding.secret("OPENAI_API_KEY"),
-    }),
-    anthropic: aiSdk({
-      provider: "anthropic",
-      defaultModel: "claude-sonnet-4-5",
-      apiKey: binding.secret("ANTHROPIC_API_KEY"),
-    }),
-  },
-  defaults: { model: "openai" },
+  realtime: localRealtime(),
+  "agent-state": localAgentState(),
+  defaults: { realtime: "default", "agent-state": "default" },
   telemetry: { redaction: { mode: "development-redacted", maxBytes: 65_536 } },
   server: { port: 3000, maxBodyBytes: 1_048_576 },
   inspector: { port: 3210 },