create-relkit 0.0.0

package/dist/options.js

@@ -0,0 +1,113 @@
+export const CREATE_TEMPLATES = ["minimal", "api", "agent"];
+export const CREATE_CLOUDS = ["aws", "none"];
+export const CREATE_DEPLOYMENTS = ["pulumi", "none"];
+export const CREATE_OPTION_DEFAULTS = Object.freeze({
+    template: "minimal",
+    cloud: "aws",
+    deploy: "pulumi",
+    install: true,
+    git: true,
+    examples: true,
+    forceEmptyDirectory: false,
+    json: false,
+});
+export class CreateOptionsError extends Error {
+    code = "RELKIT_CREATE_USAGE";
+    constructor(message) {
+        super(message);
+        this.name = "CreateOptionsError";
+    }
+}
+/** Parses the non-interactive create flags and applies the v3 defaults. */
+export function normalizeCreateOptions(args, context = {}) {
+    let name;
+    let directory;
+    let template = CREATE_OPTION_DEFAULTS.template;
+    let cloud = CREATE_OPTION_DEFAULTS.cloud;
+    let deploy = CREATE_OPTION_DEFAULTS.deploy;
+    let install = CREATE_OPTION_DEFAULTS.install;
+    let git = CREATE_OPTION_DEFAULTS.git;
+    let examples = CREATE_OPTION_DEFAULTS.examples;
+    let forceEmptyDirectory = CREATE_OPTION_DEFAULTS.forceEmptyDirectory;
+    let json = CREATE_OPTION_DEFAULTS.json || context.json === true;
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        if (argument === "--json")
+            json = true;
+        else if (argument === "--force-empty-directory")
+            forceEmptyDirectory = true;
+        else if (argument === "--install")
+            install = true;
+        else if (argument === "--no-install")
+            install = false;
+        else if (argument === "--git")
+            git = true;
+        else if (argument === "--no-git")
+            git = false;
+        else if (argument === "--examples")
+            examples = true;
+        else if (argument === "--no-examples")
+            examples = false;
+        else if (argument === "--template" || argument.startsWith("--template=")) {
+            const option = readValue(args, index, argument, "--template");
+            index = option.index;
+            template = choice(option.value, "--template", CREATE_TEMPLATES);
+        }
+        else if (argument === "--cloud" || argument.startsWith("--cloud=")) {
+            const option = readValue(args, index, argument, "--cloud");
+            index = option.index;
+            cloud = choice(option.value, "--cloud", CREATE_CLOUDS);
+        }
+        else if (argument === "--deploy" || argument.startsWith("--deploy=")) {
+            const option = readValue(args, index, argument, "--deploy");
+            index = option.index;
+            deploy = choice(option.value, "--deploy", CREATE_DEPLOYMENTS);
+        }
+        else if (argument === "--directory" || argument.startsWith("--directory=")) {
+            const option = readValue(args, index, argument, "--directory");
+            index = option.index;
+            directory = option.value;
+        }
+        else if (argument.startsWith("-")) {
+            throw new CreateOptionsError(`Unknown create option: ${argument}`);
+        }
+        else if (name === undefined)
+            name = argument;
+        else
+            throw new CreateOptionsError("Only one project name is allowed.");
+    }
+    if (name === undefined)
+        throw new CreateOptionsError("Usage: create-relkit <name> [options]");
+    return Object.freeze({
+        name,
+        template,
+        cloud,
+        deploy,
+        install,
+        git,
+        examples,
+        ...(directory === undefined ? {} : { directory }),
+        forceEmptyDirectory,
+        json,
+    });
+}
+function readValue(args, index, argument, option) {
+    const prefix = `${option}=`;
+    if (argument.startsWith(prefix)) {
+        const value = argument.slice(prefix.length);
+        if (value.length > 0)
+            return { value, index };
+    }
+    else {
+        const value = args[index + 1];
+        if (value !== undefined && !value.startsWith("-"))
+            return { value, index: index + 1 };
+    }
+    throw new CreateOptionsError(`${option} requires a value.`);
+}
+function choice(value, option, allowed) {
+    if (allowed.includes(value))
+        return value;
+    throw new CreateOptionsError(`${option} must be one of: ${allowed.join("|")}.`);
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

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

package/dist/templates/default/README.md

@@ -0,0 +1,13 @@
+# Default RelKit templates
+
+The `v1` directory contains the bundled project templates used by the
+scaffolder:
+
+- `minimal` — one function and a `GET /hello` route;
+- `api` — the minimal example plus a JSON `POST /echo` route;
+- `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.0.0`), Bun `1.3.10`, and
+TypeScript `5.9.2`. The generator owns project-name substitution and later
+installation/Git behavior.

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

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

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

@@ -0,0 +1,23 @@
+# 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 deterministic AI
+SDK test models, while production uses the configured AWS provider set.
+
+The agent may omit `model` to use the configured `defaultProvider` and
+`defaultModel`; production keeps OpenAI and Anthropic credentials as
+environment references in `modelProviders`.
+
+## Commands
+
+```sh
+bun install
+bun run dev
+bun run test
+bun run check
+bun run typecheck
+bun run build
+```
+
+The example route is `GET /hello?name=RelKit`. Agent prompt and result content
+are not captured by default.

package/dist/templates/default/v1/agent/gitignore

@@ -0,0 +1,10 @@
+node_modules/
+.env
+.env.*
+!.env.example
+.relkit/generated/
+.relkit/build/
+.relkit/state/
+.relkit/observability/
+coverage/
+dist/

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

@@ -0,0 +1,29 @@
+{
+  "name": "my-app",
+  "private": true,
+  "type": "module",
+  "packageManager": "bun@1.3.10",
+  "scripts": {
+    "dev": "relkit dev",
+    "check": "relkit check",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "test:unit": "bun test tests/unit",
+    "test:integration": "bun test tests/integration",
+    "build": "relkit build",
+    "start": "relkit start",
+    "graph": "relkit graph print",
+    "deploy:preview": "relkit deploy preview",
+    "deploy": "relkit deploy up"
+  },
+  "dependencies": {
+    "@relkit/app": "0.0.0",
+    "@relkit/providers-standard": "0.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.10",
+    "@relkit/cli": "0.0.0",
+    "@relkit/testing": "0.0.0",
+    "typescript": "5.9.2"
+  }
+}

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

@@ -0,0 +1,23 @@
+import { aiSdk, defineConfig, external } from "@relkit/app/config";
+import env from "@app/env.js";
+
+export default defineConfig({
+  env,
+  models: {
+    default: external(
+      aiSdk({
+        defaultProvider: "openai",
+        defaultModel: "gpt-5-mini",
+        openai: { apiKey: env.OPENAI_API_KEY },
+        anthropic: {
+          defaultModel: "claude-sonnet-4-5",
+          apiKey: env.ANTHROPIC_API_KEY,
+        },
+      }),
+    ),
+  },
+  telemetry: { bodyCapture: { mode: "off" } },
+  server: { port: 3000, maxBodyBytes: 1_048_576 },
+  inspector: { port: 3210 },
+  deployment: { target: "aws", adapter: "pulumi" },
+});

package/dist/templates/default/v1/agent/src/agents/assistant.agent.ts

@@ -0,0 +1,13 @@
+import { defineAgent } from "@relkit/app/agents";
+import { z } from "@relkit/app/schema";
+import { lookup } from "@app/functions/hello.function.js";
+
+export default defineAgent({
+  id: "assistant",
+  input: z.object({ question: z.string().min(1) }),
+  output: z.object({ answer: z.string() }),
+  model: "openai:gpt-5-mini",
+  instructions: "Answer greeting questions with the read-only lookup tool.",
+  tools: [lookup],
+  limits: { maxSteps: 4, maxToolCalls: 4, timeoutMs: 10_000 },
+});

package/dist/templates/default/v1/agent/src/env.ts

@@ -0,0 +1,7 @@
+import { defineEnv, env } from "@relkit/app/config";
+
+export default defineEnv({
+  LOG_LEVEL: env.literal("trace", "debug", "info", "warn", "error").default("info"),
+  OPENAI_API_KEY: env.secret().requiredIn("production"),
+  ANTHROPIC_API_KEY: env.secret().requiredIn("production"),
+});

package/dist/templates/default/v1/agent/src/functions/hello.function.ts

@@ -0,0 +1,21 @@
+import { defineFunction } from "@relkit/app/functions";
+import { z } from "@relkit/app/schema";
+
+const hello = defineFunction({
+  id: "hello",
+  input: z.object({ name: z.string().min(1).default("world") }),
+  output: z.object({ message: z.string() }),
+  handler: async ({ name }, context) => {
+    context.log.info("hello invoked", { name });
+    return { message: `Hello, ${name}!` };
+  },
+});
+
+export const lookup = hello.asTool({
+  id: "hello.lookup",
+  description: "Read a greeting for a supplied name",
+  sideEffect: "read",
+  approval: "never",
+});
+
+export default hello;

package/dist/templates/default/v1/agent/src/routes/hello/route.ts

@@ -0,0 +1,7 @@
+import { defineRoute } from "@relkit/app/routes";
+import hello from "@app/functions/hello.function.js";
+
+export const GET = defineRoute({
+  id: "hello.http",
+  target: hello,
+});

package/dist/templates/default/v1/agent/tests/integration/hello.route.test.ts

@@ -0,0 +1,13 @@
+import { afterAll, expect, test } from "bun:test";
+import { createTestApplication } from "@relkit/testing";
+import config from "../../relkit.config.js";
+
+const testApp = await createTestApplication(config);
+
+test("GET /hello", async () => {
+  const response = await testApp.http.request("/hello?name=Mustafa");
+  expect(response.status).toBe(200);
+  expect(await response.json()).toEqual({ message: "Hello, Mustafa!" });
+});
+
+afterAll(() => testApp.close());

package/dist/templates/default/v1/agent/tests/unit/assistant.agent.test.ts

@@ -0,0 +1,29 @@
+import { expect, test } from "bun:test";
+import { createTestAgent, invokeFunction } from "@relkit/testing";
+import assistant from "@app/agents/assistant.agent.js";
+import hello, { lookup } from "@app/functions/hello.function.js";
+
+test("assistant uses a function-derived tool with an offline AI SDK model", async () => {
+  expect(assistant.model).toBe("openai:gpt-5-mini");
+  expect(assistant.tools.map((tool) => tool.ref.id)).toEqual(["hello.lookup"]);
+  expect(assistant.limits).toEqual({ maxSteps: 4, maxToolCalls: 4, timeoutMs: 10_000 });
+
+  const agent = createTestAgent({
+    agent: assistant,
+    tools: [lookup],
+    engine: {
+      invoke: (request) =>
+        invokeFunction(hello, request.input as Parameters<typeof hello.invoke>[0]),
+    },
+    model: { provider: "openai", modelId: "gpt-5-mini" },
+    script: [
+      { type: "tool-call", callId: "call-1", toolId: "hello.lookup", input: { name: "Ada" } },
+      { type: "final", output: { answer: "Hello, Ada!" } },
+    ],
+  });
+
+  await expect(agent.invoke({ question: "greet Ada" })).resolves.toEqual({
+    answer: "Hello, Ada!",
+  });
+  expect(agent.model.calls).toHaveLength(2);
+});

package/dist/templates/default/v1/agent/tests/unit/hello.function.test.ts

@@ -0,0 +1,9 @@
+import { expect, test } from "bun:test";
+import { invokeFunction } from "@relkit/testing";
+import hello from "@app/functions/hello.function.js";
+
+test("hello returns a greeting", async () => {
+  await expect(invokeFunction(hello, { name: "Mustafa" })).resolves.toEqual({
+    message: "Hello, Mustafa!",
+  });
+});

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

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "baseUrl": ".",
+    "paths": { "@app/*": ["src/*"] },
+    "lib": ["ES2022"],
+    "types": ["bun"],
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "files": [".relkit/generated/event-registry.d.ts"],
+  "include": ["src/**/*.ts", "tests/**/*.ts", "relkit.config.ts"],
+  "exclude": ["node_modules", ".relkit"]
+}

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

@@ -0,0 +1,4 @@
+LOG_LEVEL=info
+EVENT_REGION=us-east-1
+EVENT_ENDPOINT=http://localhost:4566
+EVENT_BUS_NAME=default

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

@@ -0,0 +1,25 @@
+# my-app
+
+A RelKit TypeScript/Bun API project with greeting, echo, and order routes.
+Functions own the application handlers; routes describe transport mapping and
+responses. Source-scoped IDs are inferred where safe, the order route targets a
+small service, and nested calls use descriptor `invoke`.
+
+## Commands
+
+```sh
+bun install
+bun run dev
+bun run test
+bun run check
+bun run typecheck
+bun run build
+```
+
+The example routes are `GET /hello?name=RelKit`, `POST /echo` with a JSON
+`message` field, and `POST /orders` with `{ orderId, sku, quantity }`.
+
+Creating an order publishes `orders.created`. Its confirmation and audit
+listeners are independent durable, at-least-once deliveries: one listener can
+fail without rolling back the other, and delivery is not a transaction or a
+promise of simultaneous execution.

package/dist/templates/default/v1/api/gitignore

@@ -0,0 +1,10 @@
+node_modules/
+.env
+.env.*
+!.env.example
+.relkit/generated/
+.relkit/build/
+.relkit/state/
+.relkit/observability/
+coverage/
+dist/

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

@@ -0,0 +1,30 @@
+{
+  "name": "my-app",
+  "private": true,
+  "type": "module",
+  "packageManager": "bun@1.3.10",
+  "scripts": {
+    "dev": "relkit dev",
+    "check": "relkit check",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "test:unit": "bun test tests/unit",
+    "test:integration": "bun test tests/integration",
+    "build": "relkit build",
+    "start": "relkit start",
+    "graph": "relkit graph print",
+    "deploy:preview": "relkit deploy preview",
+    "deploy": "relkit deploy up"
+  },
+  "dependencies": {
+    "@relkit/app": "0.0.0",
+    "@relkit/providers-standard": "0.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.10",
+    "@relkit/cli": "0.0.0",
+    "@relkit/events": "0.0.0",
+    "@relkit/testing": "0.0.0",
+    "typescript": "5.9.2"
+  }
+}

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

@@ -0,0 +1,19 @@
+import { defineConfig, eventBridge, managed } from "@relkit/app/config";
+import env from "@app/env.js";
+
+export default defineConfig({
+  env,
+  events: {
+    default: managed(
+      eventBridge({
+        region: env.EVENT_REGION,
+        endpoint: env.EVENT_ENDPOINT,
+        busName: env.EVENT_BUS_NAME,
+      }),
+    ),
+  },
+  telemetry: { bodyCapture: { mode: "off" } },
+  server: { port: 3000, maxBodyBytes: 1_048_576 },
+  inspector: { port: 3210 },
+  deployment: { target: "aws", adapter: "pulumi" },
+});

package/dist/templates/default/v1/api/src/env.ts

@@ -0,0 +1,8 @@
+import { defineEnv, env } from "@relkit/app/config";
+
+export default defineEnv({
+  LOG_LEVEL: env.literal("trace", "debug", "info", "warn", "error").default("info"),
+  EVENT_REGION: env.string().default("us-east-1"),
+  EVENT_ENDPOINT: env.url().requiredIn("development", "production"),
+  EVENT_BUS_NAME: env.string().requiredIn("development", "production"),
+});

package/dist/templates/default/v1/api/src/events/order-audit.event.ts

@@ -0,0 +1,15 @@
+import { onEvent } from "@relkit/app/events";
+
+const orderAudit = onEvent(
+  "orders.created",
+  async (payload, context) => {
+    context.log.info("order.audit.recorded", {
+      orderId: payload.orderId,
+      sku: payload.sku,
+      totalCents: payload.totalCents,
+    });
+  },
+  { id: "orders.audit" },
+);
+
+export default orderAudit;

package/dist/templates/default/v1/api/src/events/order-confirmation.event.ts

@@ -0,0 +1,11 @@
+import { onEvent } from "@relkit/app/events";
+
+const orderConfirmation = onEvent(
+  "orders.created",
+  async (payload, context) => {
+    context.log.info("order.confirmation.requested", { orderId: payload.orderId });
+  },
+  { id: "orders.confirmation" },
+);
+
+export default orderConfirmation;

package/dist/templates/default/v1/api/src/events/order-created.event.ts

@@ -0,0 +1,15 @@
+import { defineEvent } from "@relkit/app/events";
+import { z } from "@relkit/app/schema";
+
+const orderCreated = defineEvent({
+  id: "orders.created",
+  version: 1,
+  payload: z.object({
+    orderId: z.string().min(1),
+    sku: z.string().min(1),
+    totalCents: z.number().int().nonnegative(),
+  }),
+  title: "Order created",
+});
+
+export default orderCreated;

package/dist/templates/default/v1/api/src/functions/echo.function.ts

@@ -0,0 +1,10 @@
+import { defineFunction } from "@relkit/app/functions";
+import { z } from "@relkit/app/schema";
+
+const echo = defineFunction({
+  input: z.object({ message: z.string().min(1) }),
+  output: z.object({ message: z.string() }),
+  handler: async ({ message }) => ({ message }),
+});
+
+export default echo;

package/dist/templates/default/v1/api/src/functions/hello.function.ts

@@ -0,0 +1,13 @@
+import { defineFunction } from "@relkit/app/functions";
+import { z } from "@relkit/app/schema";
+
+const hello = defineFunction({
+  input: z.object({ name: z.string().min(1).default("world") }),
+  output: z.object({ message: z.string() }),
+  handler: async ({ name }, context) => {
+    context.log.info("hello invoked", { name });
+    return { message: `Hello, ${name}!` };
+  },
+});
+
+export default hello;

package/dist/templates/default/v1/api/src/functions/orders/create-order.function.ts

@@ -0,0 +1,29 @@
+import { defineFunction } from "@relkit/app/functions";
+import { z } from "@relkit/app/schema";
+import orderCreated from "@app/events/order-created.event.js";
+import priceOrder from "@app/functions/orders/price-order.function.js";
+
+const orderInput = z.object({
+  orderId: z.string().min(1),
+  sku: z.string().min(1),
+  quantity: z.number().int().positive(),
+});
+const orderOutput = z.object({
+  orderId: z.string(),
+  sku: z.string(),
+  totalCents: z.number().int().nonnegative(),
+});
+
+const createOrder = defineFunction({
+  input: orderInput,
+  output: orderOutput,
+  dependencies: { events: { orderCreated } },
+  handler: async (input, context) => {
+    const { totalCents } = await priceOrder.invoke({ quantity: input.quantity });
+    const order = { orderId: input.orderId, sku: input.sku, totalCents };
+    await context.events.orderCreated.publish(order);
+    return order;
+  },
+});
+
+export default createOrder;

package/dist/templates/default/v1/api/src/functions/orders/price-order.function.ts

@@ -0,0 +1,10 @@
+import { defineFunction } from "@relkit/app/functions";
+import { z } from "@relkit/app/schema";
+
+const priceOrder = defineFunction({
+  input: z.object({ quantity: z.number().int().positive() }),
+  output: z.object({ totalCents: z.number().int().nonnegative() }),
+  handler: ({ quantity }) => ({ totalCents: quantity * 100 }),
+});
+
+export default priceOrder;

package/dist/templates/default/v1/api/src/routes/echo/route.ts

@@ -0,0 +1,6 @@
+import { defineRoute } from "@relkit/app/routes";
+import echo from "@app/functions/echo.function.js";
+
+export const POST = defineRoute({
+  target: echo,
+});

package/dist/templates/default/v1/api/src/routes/hello/route.ts

@@ -0,0 +1,6 @@
+import { defineRoute } from "@relkit/app/routes";
+import hello from "@app/functions/hello.function.js";
+
+export const GET = defineRoute({
+  target: hello,
+});

package/dist/templates/default/v1/api/src/routes/orders/route.ts

@@ -0,0 +1,9 @@
+import { defineRoute } from "@relkit/app/routes";
+import orders from "@app/services/orders.service.js";
+
+export const POST = defineRoute({
+  // Reuse the checked application function instead of duplicating HTTP logic.
+  target: orders.createOrder,
+  // Successful creates return the conventional HTTP 201 status.
+  successStatus: 201,
+});

package/dist/templates/default/v1/api/src/services/orders.service.ts

@@ -0,0 +1,7 @@
+import { defineService } from "@relkit/app/services";
+import createOrder from "@app/functions/orders/create-order.function.js";
+import priceOrder from "@app/functions/orders/price-order.function.js";
+
+const orders = defineService({ functions: { createOrder, priceOrder } });
+
+export default orders;

package/dist/templates/default/v1/api/tests/integration/echo.route.test.ts

@@ -0,0 +1,17 @@
+import { afterAll, expect, test } from "bun:test";
+import { createTestApplication } from "@relkit/testing";
+import config from "../../relkit.config.js";
+
+const testApp = await createTestApplication(config);
+
+test("POST /echo", async () => {
+  const response = await testApp.http.request("/echo", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ message: "hello" }),
+  });
+  expect(response.status).toBe(200);
+  expect(await response.json()).toEqual({ message: "hello" });
+});
+
+afterAll(() => testApp.close());

package/dist/templates/default/v1/api/tests/integration/hello.route.test.ts

@@ -0,0 +1,13 @@
+import { afterAll, expect, test } from "bun:test";
+import { createTestApplication } from "@relkit/testing";
+import config from "../../relkit.config.js";
+
+const testApp = await createTestApplication(config);
+
+test("GET /hello", async () => {
+  const response = await testApp.http.request("/hello?name=Mustafa");
+  expect(response.status).toBe(200);
+  expect(await response.json()).toEqual({ message: "Hello, Mustafa!" });
+});
+
+afterAll(() => testApp.close());