@telorun/http-server 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @telorun/http-server
 
+## 0.10.0
+
+### Minor Changes
+
+- ee8926f: Unify resource references on the `!ref` YAML tag. The object form `{ kind, name }`
+  and bare-string references are removed: the analyzer rejects them up front
+  (`INVALID_REFERENCE_FORM`) and `!ref <name>` / `!ref <Alias>.<name>` is the only
+  authored shape. `resolveRefSentinels` now resolves `!ref` sentinels across the
+  whole manifest tree (including step `invoke`s and refs nested in inline
+  definitions), so every consumer sees the uniform resolved shape. The
+  http-server mount slot is renamed `mounts[].type` → `mounts[].mount`, and the
+  mcp transports / clients read their Phase-5-injected ref instances directly.
+
+  Schema validation (analyzer and kernel) now drops the stale scalar `type` a ref
+  slot may still pin (older published modules encode references as `type: string`)
+  before running AJV, so a resolved reference object validates against a legacy
+  `x-telo-ref` slot. This keeps an app that consumes a not-yet-republished
+  dependency analyzable and bootable during the migration. Object-typed ref slots
+  that also accept an inline value (e.g. `inputType` / `outputType`) are left
+  untouched.
+
+  `Run.Sequence` reference slots are brought onto the same enforcement path: a
+  step `invoke` and a scope `targets` entry now require a `!ref` (the `targets`
+  slot gains an `x-telo-ref` constraint and the `with` scope's visibility extends
+  to `/targets`), so a bare-string ref at either is rejected with
+  `INVALID_REFERENCE_FORM` at `telo check` — uniform with `Telo.Application`
+  targets — instead of failing as an obscure runtime error. The controller reads
+  the resolved reference rather than a bare name.
+
 ## 0.9.0
 
 ### Minor Changes

package/README.md

@@ -24,16 +24,16 @@ Language- and framework-agnostic HTTP server for Telo. Declarative routes, schem
 kind: Telo.Application
 metadata: { name: hello-http, version: 1.0.0 }
 imports:
-  Http: pkg:npm/@telorun/http-server@^1.0.0
-  JS: pkg:npm/@telorun/javascript@^1.0.0
-targets: [Server]
+  Http: std/http-server@0.9.0
+  JS: std/javascript@0.4.1
+targets: [ !ref Server ]
 ---
 kind: Http.Server
 metadata: { name: Server }
 port: 8080
 mounts:
   - path: /api
-    type: Api
+    mount: !ref Api
 ---
 kind: Http.Api
 metadata: { name: Api }
@@ -54,7 +54,7 @@ routes:
               examples: [ "Ada" ]
     inputs:
       name: "${{ request.params.name }}"
-    handler: { kind: JS.Script, name: Greet }
+    handler: !ref Greet
     returns:
       - status: 200
         content:

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 `type` 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>;
@@ -40,7 +40,7 @@ type HttpServerResource = RuntimeResource & {
     };
     mounts?: Array<{
         path?: string;
-        type?: Mountable;
+        mount?: Mountable;
     }>;
     notFoundHandler?: {
         invoke: KindRef<Invocable>;

package/dist/http-server-controller.js

@@ -119,9 +119,9 @@ class HttpServer {
         // const resolveSchema = createSchemaResolver(this.ctx);
         for (const mount of mounts) {
             const prefix = mount.path || "";
-            // `mount.type` is the live Telo.Mount instance injected by the kernel at Phase 5
+            // `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.
-            const api = mount.type;
+            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`);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/http-server",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Telo HTTP Server module - HTTP server and API resource kinds for Telo manifests.",
   "keywords": [
     "telo",

package/src/http-server-controller.ts

@@ -20,7 +20,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 `type` 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>;
@@ -58,7 +58,7 @@ type HttpServerResource = RuntimeResource & {
     path?: string;
     // x-telo-ref "telo#Mount": Phase 5 replaces this slot with the live mounted
     // instance (Http.Api, Mcp.HttpEndpoint, …), local or imported.
-    type?: Mountable;
+    mount?: Mountable;
   }>;
   notFoundHandler?: {
     invoke: KindRef<Invocable>;
@@ -201,9 +201,9 @@ class HttpServer implements ResourceInstance {
     // const resolveSchema = createSchemaResolver(this.ctx);
     for (const mount of mounts) {
       const prefix = mount.path || "";
-      // `mount.type` is the live Telo.Mount instance injected by the kernel at Phase 5
+      // `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.
-      const api = mount.type;
+      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`,