create-relkit 0.0.5 → 0.1.0

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.0.5`), Bun `1.3.10`, and
+the current checked-in RelKit package version (`0.1.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/package.json

@@ -17,13 +17,13 @@
     "deploy": "relkit deploy up"
   },
   "dependencies": {
-    "@relkit/app": "0.0.5",
-    "@relkit/providers-standard": "0.0.5"
+    "@relkit/app": "0.1.0",
+    "@relkit/providers-standard": "0.1.0"
   },
   "devDependencies": {
     "@types/bun": "1.3.10",
-    "@relkit/cli": "0.0.5",
-    "@relkit/testing": "0.0.5",
+    "@relkit/cli": "0.1.0",
+    "@relkit/testing": "0.1.0",
     "typescript": "5.9.3"
   }
 }

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

@@ -4,10 +4,17 @@ import lookup from "@app/hello/tools/lookup.tool.js";
 
 export default defineAgent({
   id: "hello.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 },
+
+  limits: {
+    maxSteps: 4,
+    maxToolCalls: 4,
+    timeoutMs: 10_000,
+  },
 });

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

@@ -0,0 +1,16 @@
+import { defineFunction } from "@relkit/app/functions";
+import { z } from "@relkit/app/schema";
+import assistant from "@app/hello/agents/assistant.agent.js";
+
+export default defineFunction({
+  id: "hello.ask-assistant",
+
+  input: z.object({ question: z.string().min(1) }),
+  output: z.object({ answer: z.string() }),
+
+  dependencies: { agents: { assistant } },
+
+  handler: async (input, context) => {
+    return context.agents.assistant(input);
+  },
+});

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

@@ -3,10 +3,13 @@ import { z } from "@relkit/app/schema";
 
 const hello = defineFunction({
   id: "hello.greet",
+
   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}!` };
   },
 });

package/dist/templates/default/v1/agent/src/hello/tools/lookup.tool.ts

@@ -3,6 +3,8 @@ import hello from "@app/hello/functions/hello.function.js";
 export default hello.asTool({
   id: "hello.lookup",
   description: "Read a greeting for a supplied name",
+
   sideEffect: "read",
   approval: "never",
+  timeoutMs: 2_000,
 });

package/dist/templates/default/v1/agent/tests/fixtures/lookup.tool.ts

@@ -0,0 +1,12 @@
+import { defineTool } from "@relkit/app/tools";
+import hello from "@app/hello/functions/hello.function.js";
+
+export default defineTool({
+  id: "hello.lookup",
+  target: hello,
+  description: "Read a greeting for a supplied name",
+
+  sideEffect: "read",
+  approval: "never",
+  timeoutMs: 2_000,
+});

package/dist/templates/default/v1/agent/tests/fixtures/mcp-options.ts

@@ -0,0 +1,26 @@
+// #region private-tool
+import hello from "@app/hello/functions/hello.function.js";
+
+export const privateLookup = hello.asTool({
+  id: "hello.private-lookup",
+  description: "Read a greeting inside this app only",
+
+  sideEffect: "read",
+  approval: "never",
+  timeoutMs: 2_000,
+  mcp: false,
+});
+// #endregion private-tool
+
+import { defineConfig } from "@relkit/app/config";
+import env from "@app/platform/env.js";
+
+export const mcpDisabled = defineConfig({
+  env,
+  // #region disable-mcp
+  server: {
+    port: 3000,
+    mcp: false,
+  },
+  // #endregion disable-mcp
+});

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

@@ -1,6 +1,7 @@
 import { expect, test } from "bun:test";
 import { createTestAgent, invokeFunction } from "@relkit/testing";
 import assistant from "@app/hello/agents/assistant.agent.js";
+import askAssistant from "@app/hello/functions/ask-assistant.function.js";
 import hello from "@app/hello/functions/hello.function.js";
 import lookup from "@app/hello/tools/lookup.tool.js";
 
@@ -17,14 +18,26 @@ test("assistant uses a function-derived tool with an offline AI SDK model", asyn
         invokeFunction(hello, request.input as Parameters<typeof hello.invoke>[0]),
     },
     model: { provider: "openai", modelId: "gpt-5-mini" },
+    // Script the model's choices while running the real greeting function.
     script: [
-      { type: "tool-call", callId: "call-1", toolId: "hello.lookup", input: { name: "Ada" } },
+      {
+        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!",
-  });
+  await expect(
+    invokeFunction(
+      askAssistant,
+      { question: "greet Ada" },
+      {
+        clients: { agents: { "hello.assistant": agent.invoke } },
+      },
+    ),
+  ).resolves.toEqual({ answer: "Hello, Ada!" });
   expect(agent.model.calls).toHaveLength(2);
 });

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

@@ -0,0 +1,20 @@
+import { expect, test } from "bun:test";
+import hello from "@app/hello/functions/hello.function.js";
+import lookup from "../fixtures/lookup.tool.js";
+import { mcpDisabled, privateLookup } from "../fixtures/mcp-options.js";
+
+test("defineTool reuses the greeting function", async () => {
+  expect(lookup.target.ref).toEqual(hello.ref);
+  expect(lookup.mcp).toBe(true);
+  await expect(lookup.invoke({ name: "Ada" })).resolves.toEqual({
+    message: "Hello, Ada!",
+  });
+});
+
+test("MCP visibility can be disabled without disabling ordinary tool invocation", async () => {
+  expect(privateLookup.mcp).toBe(false);
+  expect(mcpDisabled.server?.mcp).toBe(false);
+  await expect(privateLookup.invoke({ name: "Ada" })).resolves.toEqual({
+    message: "Hello, Ada!",
+  });
+});

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

@@ -17,14 +17,14 @@
     "deploy": "relkit deploy up"
   },
   "dependencies": {
-    "@relkit/app": "0.0.5",
-    "@relkit/providers-standard": "0.0.5"
+    "@relkit/app": "0.1.0",
+    "@relkit/providers-standard": "0.1.0"
   },
   "devDependencies": {
     "@types/bun": "1.3.10",
-    "@relkit/cli": "0.0.5",
-    "@relkit/events": "0.0.5",
-    "@relkit/testing": "0.0.5",
+    "@relkit/cli": "0.1.0",
+    "@relkit/events": "0.1.0",
+    "@relkit/testing": "0.1.0",
     "typescript": "5.9.3"
   }
 }

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

@@ -4,11 +4,14 @@ import { z } from "@relkit/app/schema";
 const orderCreated = defineEvent({
   id: "orders.created",
   version: 1,
-  payload: z.object({
+
+  // Data every subscriber receives when an order is created.
+  input: z.object({
     orderId: z.string().min(1),
     sku: z.string().min(1),
     totalCents: z.number().int().nonnegative(),
   }),
+
   title: "Order created",
 });
 

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

@@ -1,6 +1,5 @@
 import { defineFunction } from "@relkit/app/functions";
 import { z } from "@relkit/app/schema";
-import orderCreated from "@app/orders/events/order-created.event.js";
 import priceOrder from "@app/orders/functions/price-order.function.js";
 
 const orderInput = z.object({
@@ -8,6 +7,7 @@ const orderInput = z.object({
   sku: z.string().min(1),
   quantity: z.number().int().positive(),
 });
+
 const orderOutput = z.object({
   orderId: z.string(),
   sku: z.string(),
@@ -17,11 +17,21 @@ const orderOutput = z.object({
 const createOrder = defineFunction({
   input: orderInput,
   output: orderOutput,
-  dependencies: { events: { orderCreated } },
+
+  // Events this function is allowed to publish.
+  publishes: ["orders.created"],
+
   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);
+    const order = {
+      orderId: input.orderId,
+      sku: input.sku,
+      totalCents,
+    };
+
+    // Let subscribers react to the new order.
+    await context.events["orders.created"].publish(order);
+
     return order;
   },
 });

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

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

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

@@ -0,0 +1,15 @@
+import { defineEventFunction } from "@relkit/app/events";
+
+const orderConfirmation = defineEventFunction({
+  id: "orders.confirmation",
+  event: "orders.created",
+
+  handler: async (payload, context) => {
+    // Replace this log with your email-sending code.
+    context.log.info("order.confirmation.requested", {
+      orderId: payload.orderId,
+    });
+  },
+});
+
+export default orderConfirmation;

package/dist/templates/default/v1/api/tests/integration/order-events.test.ts

@@ -1,9 +1,9 @@
 import { expect, test } from "bun:test";
-import { createEventListenerTarget, eventListenerFunctionId } from "@relkit/app/events";
+import { bindFunctionEvents } from "@relkit/app/events";
 import { createTestEvent, invokeFunction } from "@relkit/testing";
 import orderCreated from "@app/orders/events/order-created.event.js";
-import orderAudit from "@app/orders/events/order-audit.event.js";
-import orderConfirmation from "@app/orders/events/order-confirmation.event.js";
+import orderAudit from "@app/orders/functions/order-audit.function.js";
+import orderConfirmation from "@app/orders/functions/order-confirmation.function.js";
 import orders from "@app/orders/service.js";
 
 const retry = {
@@ -15,16 +15,8 @@ const retry = {
 };
 
 test("order.created fans out deterministic independent deliveries", async () => {
-  const confirmationTarget = createEventListenerTarget(
-    orderConfirmation,
-    [orderCreated],
-    eventListenerFunctionId(orderConfirmation.id),
-  );
-  const auditTarget = createEventListenerTarget(
-    orderAudit,
-    [orderCreated],
-    eventListenerFunctionId(orderAudit.id),
-  );
+  const confirmationTarget = orderConfirmation;
+  const auditTarget = orderAudit;
   const failingAuditTarget = {
     ...auditTarget,
     handler: async (...args: Parameters<typeof auditTarget.handler>) => {
@@ -43,9 +35,9 @@ test("order.created fans out deterministic independent deliveries", async () =>
   try {
     await expect(
       invokeFunction(
-        orders.createOrder,
+        bindFunctionEvents(orders.createOrder, undefined, [orderCreated]),
         { orderId: "order-1", sku: "book", quantity: 3 },
-        { clients: { events: { orderCreated: event.provider } } },
+        { clients: { events: { "orders.created": event.provider } } },
       ),
     ).resolves.toEqual({ orderId: "order-1", sku: "book", totalCents: 300 });
 

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

@@ -3,7 +3,7 @@ import { createTestApplication } from "@relkit/testing";
 import config from "../../relkit.config.js";
 
 const testApp = await createTestApplication(config);
-testApp.fakes.setClient("events", "orderCreated", {
+testApp.fakes.setClient("events", "orders.created", {
   publish: async () => ({ accepted: true, instanceId: "event-1" }),
 });
 

package/dist/templates/default/v1/api/tests/unit/orders.function.test.ts

@@ -1,16 +1,18 @@
 import { expect, test } from "bun:test";
 import { invokeFunction } from "@relkit/testing";
 import orders from "@app/orders/service.js";
+import { bindFunctionEvents } from "@relkit/app/events";
+import orderCreated from "@app/orders/events/order-created.event.js";
 
 test("createOrder invokes pricing and publishes the order event", async () => {
   const published: unknown[] = [];
   const result = await invokeFunction(
-    orders.createOrder,
+    bindFunctionEvents(orders.createOrder, undefined, [orderCreated]),
     { orderId: "order-1", sku: "book", quantity: 3 },
     {
       clients: {
         events: {
-          orderCreated: {
+          "orders.created": {
             publish: async (payload: unknown) => {
               published.push(payload);
               return { accepted: true, instanceId: "event-1" };

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

@@ -17,13 +17,13 @@
     "deploy": "relkit deploy up"
   },
   "dependencies": {
-    "@relkit/app": "0.0.5",
-    "@relkit/providers-standard": "0.0.5"
+    "@relkit/app": "0.1.0",
+    "@relkit/providers-standard": "0.1.0"
   },
   "devDependencies": {
     "@types/bun": "1.3.10",
-    "@relkit/cli": "0.0.5",
-    "@relkit/testing": "0.0.5",
+    "@relkit/cli": "0.1.0",
+    "@relkit/testing": "0.1.0",
     "typescript": "5.9.3"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-relkit",
-  "version": "0.0.5",
+  "version": "0.1.0",
   "description": "Create a RELKIT application from a supported project template.",
   "license": "MIT",
   "repository": {

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

@@ -1,15 +0,0 @@
-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/orders/events/order-confirmation.event.ts

@@ -1,11 +0,0 @@
-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;