@telorun/http-server 0.16.1 → 0.17.1

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @telorun/http-server
 
+## 0.17.1
+
+### Patch Changes
+
+- Updated dependencies [f3b044d]
+  - @telorun/http-dispatch@0.4.2
+
+## 0.17.0
+
+### Minor Changes
+
+- 942c176: Rename `ctx.resolveChildren` to `ctx.ensureKindRef`. The old name stays as a
+  deprecated delegate.
+
+  The method never resolved anything: it takes a nested slot value — an inline
+  `{ kind, …config }` definition, a `{ kind, name }` ref, or a `!ref` sentinel —
+  and produces a `KindRef`, registering the inline case as a manifest (under a
+  supplied or generated name) on the way. `ensure` carries that create-if-needed
+  side effect; `KindRef` is what comes back.
+
+  It also reads correctly next to `ctx.resolveRef`, which runs the other direction
+  — ref to live instance. Two `resolve*` methods on one interface returning
+  opposite categories was the ambiguity; this fixes it at the source rather than
+  lengthening the name of the method that was right.
+
+### Patch Changes
+
+- @telorun/http-dispatch@0.4.1
+
 ## 0.16.1
 
 ### Patch Changes

package/README.md

@@ -27,8 +27,8 @@ Language- and framework-agnostic HTTP server for Telo. Declarative routes, schem
 kind: Telo.Application
 metadata: { name: hello-http, version: 1.0.0 }
 imports:
-  Http: std/http-server@<version>
-  JS: std/javascript@<version>
+  Http: std/http-server@0.19.1
+  JS: std/javascript@0.7.0
 targets: [ !ref Server ]
 ---
 kind: Http.Server
@@ -56,7 +56,7 @@ routes:
               description: Name to greet.
               examples: [ "Ada" ]
     inputs:
-      name: "${{ request.params.name }}"
+      name: !cel "request.params.name"
     handler: !ref Greet
     returns:
       - status: 200
@@ -69,7 +69,7 @@ routes:
                   type: string
                   description: The greeting.
                   examples: [ "Hello, Ada!" ]
-            body: { message: "${{ result.message }}" }
+            body: { message: !cel "result.message" }
 ---
 kind: JS.Script
 metadata: { name: Greet }

package/dist/http-api-controller.js

@@ -204,7 +204,7 @@ export async function create(resource, ctx) {
         if (!h)
             continue;
         if (typeof h === "object") {
-            handlerRefs.set(route, ctx.resolveChildren(h));
+            handlerRefs.set(route, ctx.ensureKindRef(h));
         }
         else if (typeof h === "string") {
             // String form (schema oneOf: string | object) — only the resource name

package/dist/http-server-controller.d.ts

@@ -2,7 +2,7 @@ import { CatchEntry, ReturnEntry } from "@telorun/http-dispatch";
 import { type Invocable, type KindRef, type ResourceContext, type ResourceInstance, type RuntimeResource } from "@telorun/sdk";
 import { FastifyInstance } from "fastify";
 /** A mounted Telo.Mount instance (Http.Api, Mcp.HttpEndpoint, …). The kernel injects the
- *  live instance into a mount's `mount` slot (x-telo-ref "telo#Mount") — cross-module refs
+ *  live instance into a mount's `mount` slot (x-telo-ref `Telo.Mount`) — cross-module refs
  *  resolve to an imported library's exported mount — and every mountable exposes register(). */
 interface Mountable {
     register(app: FastifyInstance, prefix: string): void | Promise<void>;

package/dist/http-server-controller.js

@@ -189,7 +189,7 @@ class HttpServer {
         for (const mount of mounts) {
             const prefix = mount.path || "";
             // `mount.mount` is the live Telo.Mount instance injected by the kernel at Phase 5
-            // (x-telo-ref "telo#Mount") — a same-module or imported-library mount, uniformly.
+            // (x-telo-ref `Telo.Mount`) — a same-module or imported-library mount, uniformly.
             const api = mount.mount;
             if (!api || typeof api.register !== "function") {
                 throw new Error(`Failed to mount at "${prefix}": mount target did not resolve to a Telo.Mount instance`);
@@ -285,7 +285,7 @@ export async function create(resource, ctx) {
         let kind = "";
         let name = "";
         if (typeof invoke === "object" && invoke !== null) {
-            const resolved = ctx.resolveChildren(invoke);
+            const resolved = ctx.ensureKindRef(invoke);
             kind = resolved.kind;
             name = resolved.name;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/http-server",
-  "version": "0.16.1",
+  "version": "0.17.1",
   "description": "Telo HTTP Server module - HTTP server and API resource kinds for Telo manifests.",
   "keywords": [
     "telo",
@@ -49,13 +49,13 @@
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "fastify": "^5.7.2",
-    "@telorun/http-dispatch": "0.4.1"
+    "@telorun/http-dispatch": "0.4.2"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0",
     "vitest": "^2.1.8",
-    "@telorun/sdk": "0.50.0"
+    "@telorun/sdk": "0.56.0"
   },
   "peerDependencies": {
     "@telorun/sdk": "*"

package/src/http-api-controller.ts

@@ -266,7 +266,7 @@ export async function create(resource: any, ctx: ResourceContext): Promise<HttpS
     const h = route.handler;
     if (!h) continue;
     if (typeof h === "object") {
-      handlerRefs.set(route, ctx.resolveChildren(h));
+      handlerRefs.set(route, ctx.ensureKindRef(h));
     } else if (typeof h === "string") {
       // String form (schema oneOf: string | object) — only the resource name
       // is given, not the kind. Phase 5 injects the live instance either way;

package/src/http-server-controller.ts

@@ -22,7 +22,7 @@ import Fastify, { FastifyInstance } from "fastify";
 import { fastifyReplySink } from "./fastify-reply-sink.js";
 
 /** A mounted Telo.Mount instance (Http.Api, Mcp.HttpEndpoint, …). The kernel injects the
- *  live instance into a mount's `mount` slot (x-telo-ref "telo#Mount") — cross-module refs
+ *  live instance into a mount's `mount` slot (x-telo-ref `Telo.Mount`) — cross-module refs
  *  resolve to an imported library's exported mount — and every mountable exposes register(). */
 interface Mountable {
   register(app: FastifyInstance, prefix: string): void | Promise<void>;
@@ -59,7 +59,7 @@ type HttpServerResource = RuntimeResource & {
   };
   mounts?: Array<{
     path?: string;
-    // x-telo-ref "telo#Mount": Phase 5 replaces this slot with the live mounted
+    // x-telo-ref `Telo.Mount`: Phase 5 replaces this slot with the live mounted
     // instance (Http.Api, Mcp.HttpEndpoint, …), local or imported.
     mount?: Mountable;
   }>;
@@ -270,7 +270,7 @@ class HttpServer implements ResourceInstance {
     for (const mount of mounts) {
       const prefix = mount.path || "";
       // `mount.mount` is the live Telo.Mount instance injected by the kernel at Phase 5
-      // (x-telo-ref "telo#Mount") — a same-module or imported-library mount, uniformly.
+      // (x-telo-ref `Telo.Mount`) — a same-module or imported-library mount, uniformly.
       const api = mount.mount;
       if (!api || typeof api.register !== "function") {
         throw new Error(
@@ -399,7 +399,7 @@ export async function create(
     let kind = "";
     let name = "";
     if (typeof invoke === "object" && invoke !== null) {
-      const resolved = ctx.resolveChildren(invoke);
+      const resolved = ctx.ensureKindRef(invoke);
       kind = resolved.kind;
       name = resolved.name;
     } else if (typeof invoke === "string") {

package/tests/fastify-telo-logger.test.ts

@@ -81,7 +81,7 @@ describe("Http.Server boots with request logging enabled", () => {
     return {
       log,
       args: { _: [] },
-      resolveChildren: () => ({ kind: "Http.Api", name: "x" }),
+      ensureKindRef: () => ({ kind: "Http.Api", name: "x" }),
       moduleContext: { expandWith: (value: unknown) => value },
       validateSchema: () => {},
     } as never;

package/tests/request-cancel.test.ts

@@ -42,7 +42,7 @@ describe("http-server request cancellation", () => {
     // Minimal ResourceContext: just the surface the controller touches.
     const ctx = {
       validateSchema: () => {},
-      resolveChildren: () => ({ kind: "Test.Handler", name: "SlowWork" }),
+      ensureKindRef: () => ({ kind: "Test.Handler", name: "SlowWork" }),
       moduleContext: { expandWith: (value: unknown) => value },
       createCancellationSource: () => createCancellationSource(),
       invokeResolved: (_kind: string, _name: string, h: typeof handler, input: unknown, c: unknown) =>

package/tests/request-span.test.ts

@@ -28,7 +28,7 @@ describe("http-server request span", () => {
 
     const ctx = {
       validateSchema: () => {},
-      resolveChildren: () => ({ kind: "JS.Script", name: "Echo" }),
+      ensureKindRef: () => ({ kind: "JS.Script", name: "Echo" }),
       moduleContext: { expandWith: (value: unknown) => value },
       createCancellationSource: () => createCancellationSource(),
       invokeResolved: (_kind: string, _name: string, h: typeof handler, input: unknown) =>