@toa.io/extensions.exposition 1.0.0-alpha.287 → 1.0.0-alpha.289

package/transpiled/directives/mcp/MCP.d.ts

@@ -1,15 +1,18 @@
 import { Tool } from './Tool.js';
+import type { DirectiveFamily } from '../../RTD/index.js';
 import type { Context } from '../../HTTP/index.js';
 import type { Introspection } from '../../Introspection.js';
-import type { DirectiveFamily } from '../../RTD/index.js';
 /** The name the family is declared under, and what `MCP` asks a method for. */
 export declare const FAMILY = "mcp";
 export declare class MCP implements DirectiveFamily<Tool> {
     readonly name = "mcp";
     readonly mandatory = false;
-    /** What this method is published as, which is what the nearest declaration says. */
-    static published(directives: Tool[] | undefined): Tool | null;
-    create(name: string, value: unknown, _: unknown, route: string): Tool;
-    /** What the route states this method is, which is the only thing that states it. */
+    /** Whether this method is published, which is what the nearest declaration says. */
+    static published(directives: Tool[] | undefined): boolean;
+    /**
+     * Whether this method is published to a model, which is what the route declares. Whether
+     * one is served at all is the annotation's, and a route says nothing of that.
+     */
     explain(directives: Tool[], _: Context, introspection: Introspection): Introspection;
+    create(name: string, value: unknown, _: unknown, route: string): Tool;
 }

package/transpiled/directives/mcp/MCP.js

@@ -5,25 +5,21 @@ export const FAMILY = 'mcp';
 export class MCP {
     name = FAMILY;
     mandatory = false;
-    /** What this method is published as, which is what the nearest declaration says. */
+    /** Whether this method is published, which is what the nearest declaration says. */
     static published(directives) {
-        return directives?.[0] ?? null;
+        return directives?.[0]?.published ?? false;
+    }
+    /**
+     * Whether this method is published to a model, which is what the route declares. Whether
+     * one is served at all is the annotation's, and a route says nothing of that.
+     */
+    explain(directives, _, introspection) {
+        return MCP.published(directives) ? { ...introspection, mcp: true } : introspection;
     }
     // eslint-disable-next-line max-params
     create(name, value, _, route) {
         assert.ok(name === 'tool', `Unknown directive: mcp:${name}`);
         return new Tool(value, route);
     }
-    /** What the route states this method is, which is the only thing that states it. */
-    explain(directives, _, introspection) {
-        const tool = MCP.published(directives);
-        if (tool === null)
-            return introspection;
-        return {
-            ...introspection,
-            description: tool.description,
-            ...(tool.title === undefined ? {} : { title: tool.title })
-        };
-    }
 }
 //# sourceMappingURL=MCP.js.map

package/transpiled/directives/mcp/MCP.js.map

@@ -1 +1 @@
-{"version":3,"file":"MCP.js","sourceRoot":"","sources":["../../../source/directives/mcp/MCP.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAKhC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAA;AAE3B,MAAM,OAAO,GAAG;IACE,IAAI,GAAG,MAAM,CAAA;IACb,SAAS,GAAG,KAAK,CAAA;IAEjC,oFAAoF;IAC7E,MAAM,CAAC,SAAS,CAAC,UAA8B;QACpD,OAAO,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IAChC,CAAC;IAED,sCAAsC;IAC/B,MAAM,CAAC,IAAY,EAAE,KAAc,EAAE,CAAU,EAAE,KAAa;QACnE,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,EAAE,0BAA0B,IAAI,EAAE,CAAC,CAAA;QAE5D,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAC/B,CAAC;IAED,oFAAoF;IAC7E,OAAO,CACZ,UAAkB,EAClB,CAAU,EACV,aAA4B;QAE5B,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QAEtC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,aAAa,CAAA;QAEvC,OAAO;YACL,GAAG,aAAa;YAChB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;SAC3D,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"MCP.js","sourceRoot":"","sources":["../../../source/directives/mcp/MCP.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAKhC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAA;AAE3B,MAAM,OAAO,GAAG;IACE,IAAI,GAAG,MAAM,CAAA;IACb,SAAS,GAAG,KAAK,CAAA;IAEjC,oFAAoF;IAC7E,MAAM,CAAC,SAAS,CAAC,UAA8B;QACpD,OAAO,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,KAAK,CAAA;IAC5C,CAAC;IAED;;;OAGG;IACI,OAAO,CAAC,UAAkB,EAAE,CAAU,EAAE,aAA4B;QACzE,OAAO,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAA;IACpF,CAAC;IAED,sCAAsC;IAC/B,MAAM,CAAC,IAAY,EAAE,KAAc,EAAE,CAAU,EAAE,KAAa;QACnE,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,EAAE,0BAA0B,IAAI,EAAE,CAAC,CAAA;QAE5D,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAC/B,CAAC;CACF"}

package/transpiled/directives/mcp/Tool.d.ts

@@ -1,18 +1,12 @@
 /**
- * What one method is, published to a model. Declaring it is what publishes it, and what it
- * says is what it says it is: a tool a model cannot read the purpose of is one it cannot
- * choose, so there is no way to publish one that states nothing.
+ * Whether one method is published to a model. Declaring it is what publishes it, and it
+ * says nothing else — what a tool is, is [`help:method`](../help/Help.ts), which is what
+ * describes the method to everything else as well.
  *
- * A `title` is what a person is shown where a client lists what it may call — a name is an
- * address and reads as one. A description alone is written as the value; both are written as
- * a mapping.
- *
- * The operation states what it is too, and that is not this. An operation is written without
- * knowledge of any route, and a tool is an operation and a route together — the same
- * operation mounted twice is two tools, and one sentence is not true of both.
+ * `false` withdraws one: the declaration is inherited, as every directive is, and a node
+ * publishing what is under it is how a subtree is published at all.
  */
 export declare class Tool {
-    readonly description: string;
-    readonly title: string | undefined;
+    readonly published: boolean;
     constructor(value: unknown, route: string);
 }

package/transpiled/directives/mcp/Tool.js

@@ -2,35 +2,22 @@ import assert from 'node:assert';
 import { refusal } from '../../RPC/names.js';
 import { segment } from '../../RTD/segment.js';
 /**
- * What one method is, published to a model. Declaring it is what publishes it, and what it
- * says is what it says it is: a tool a model cannot read the purpose of is one it cannot
- * choose, so there is no way to publish one that states nothing.
+ * Whether one method is published to a model. Declaring it is what publishes it, and it
+ * says nothing else — what a tool is, is [`help:method`](../help/Help.ts), which is what
+ * describes the method to everything else as well.
  *
- * A `title` is what a person is shown where a client lists what it may call — a name is an
- * address and reads as one. A description alone is written as the value; both are written as
- * a mapping.
- *
- * The operation states what it is too, and that is not this. An operation is written without
- * knowledge of any route, and a tool is an operation and a route together — the same
- * operation mounted twice is two tools, and one sentence is not true of both.
+ * `false` withdraws one: the declaration is inherited, as every directive is, and a node
+ * publishing what is under it is how a subtree is published at all.
  */
 export class Tool {
-    description;
-    title;
+    published;
     constructor(value, route) {
-        const stated = typeof value === 'string' ? { description: value } : value;
-        assert.ok(typeof stated === 'object' && stated !== null && !Array.isArray(stated), 'Directive mcp:tool: the value is what the tool is, or a `title` and a `description`');
-        const { description, title, ...rest } = stated;
-        assert.ok(Object.keys(rest).length === 0, `Directive mcp:tool: unknown ${Object.keys(rest)
-            .map((key) => `'${key}'`)
-            .join(', ')}`);
-        assert.ok(typeof description === 'string' && description.trim().length > 0, 'Directive mcp:tool: a description cannot be empty');
-        assert.ok(title === undefined || (typeof title === 'string' && title.trim().length > 0), 'Directive mcp:tool: a title cannot be empty');
+        assert.ok(typeof value === 'boolean', 'Directive mcp:tool: the value is whether the method is published; what it is, is `help:method`');
         // a tool is called by name, so a route that cannot be named cannot be one — said where
         // the mistake is, rather than as a tool that is quietly never listed
-        assert.ok(refusal(segment(route)) === null, `Directive mcp:tool: '${route}' holds a segment no tool name can spell`);
-        this.description = description;
-        this.title = title;
+        if (value)
+            assert.ok(refusal(segment(route)) === null, `Directive mcp:tool: '${route}' holds a segment no tool name can spell`);
+        this.published = value;
     }
 }
 //# sourceMappingURL=Tool.js.map

package/transpiled/directives/mcp/Tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tool.js","sourceRoot":"","sources":["../../../source/directives/mcp/Tool.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,IAAI;IACC,WAAW,CAAQ;IACnB,KAAK,CAAoB;IAEzC,YAAmB,KAAc,EAAE,KAAa;QAC9C,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;QAEzE,MAAM,CAAC,EAAE,CACP,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EACvE,qFAAqF,CACtF,CAAA;QAED,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAiC,CAAA;QAEzE,MAAM,CAAC,EAAE,CACP,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAC9B,+BAA+B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;aAC7C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC;aACxB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAA;QAED,MAAM,CAAC,EAAE,CACP,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAChE,mDAAmD,CACpD,CAAA;QAED,MAAM,CAAC,EAAE,CACP,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,EAC7E,6CAA6C,CAC9C,CAAA;QAED,uFAAuF;QACvF,qEAAqE;QACrE,MAAM,CAAC,EAAE,CACP,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAChC,wBAAwB,KAAK,0CAA0C,CACxE,CAAA;QAED,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,KAAK,GAAG,KAA2B,CAAA;IAC1C,CAAC;CACF"}
+{"version":3,"file":"Tool.js","sourceRoot":"","sources":["../../../source/directives/mcp/Tool.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,OAAO,IAAI;IACC,SAAS,CAAS;IAElC,YAAmB,KAAc,EAAE,KAAa;QAC9C,MAAM,CAAC,EAAE,CACP,OAAO,KAAK,KAAK,SAAS,EAC1B,gGAAgG,CACjG,CAAA;QAED,uFAAuF;QACvF,qEAAqE;QACrE,IAAI,KAAK;YACP,MAAM,CAAC,EAAE,CACP,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAChC,wBAAwB,KAAK,0CAA0C,CACxE,CAAA;QAEH,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;IACxB,CAAC;CACF"}

package/transpiled/directives/octets/Directive.d.ts

@@ -1,8 +1,14 @@
 import type { Input } from './types.js';
 import type { Parameter } from '../../RTD/index.js';
+import type { Introspection } from '../../Introspection.js';
 import type * as io from '../../io.js';
 export declare abstract class Directive {
     readonly name: string;
     abstract readonly targeted: boolean;
     abstract apply(storage: string, input: Input, parameters: Parameter[]): Promise<io.Output>;
+    /**
+     * What a caller has to know to make the request. Only sending a file takes anything a
+     * schema does not already say; reading one and deleting one take nothing.
+     */
+    describe?(introspection: Introspection): void;
 }

package/transpiled/directives/octets/Directive.js.map

@@ -1 +1 @@
-{"version":3,"file":"Directive.js","sourceRoot":"","sources":["../../../source/directives/octets/Directive.ts"],"names":[],"mappings":"AAIA,MAAM,OAAgB,SAAS;IACb,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,CAAA;CAQvE"}
+{"version":3,"file":"Directive.js","sourceRoot":"","sources":["../../../source/directives/octets/Directive.ts"],"names":[],"mappings":"AAKA,MAAM,OAAgB,SAAS;IACb,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,CAAA;CAcvE"}

package/transpiled/directives/octets/Octets.d.ts

@@ -2,11 +2,14 @@ import type { Directive } from './Directive.js';
 import type { Output } from '../../io.js';
 import type { Remotes } from '../../Remotes.js';
 import type { Parameter, DirectiveFamily } from '../../RTD/index.js';
+import type { Introspection } from '../../Introspection.js';
 import type { Input } from './types.js';
 export declare class Octets implements DirectiveFamily<Directive> {
     readonly name: string;
     readonly mandatory: boolean;
     private discovery;
     create(name: string, value: any, remotes: Remotes): Directive;
+    /** What the request takes, which only sending a file says anything about. */
+    explain(directives: Directive[], _: Input, introspection: Introspection): Introspection;
     precall(directives: Directive[], input: Input, parameters: Parameter[]): Promise<Output>;
 }

package/transpiled/directives/octets/Octets.js

@@ -15,6 +15,12 @@ export class Octets {
         this.discovery ??= remotes.discover('exposition', 'octets');
         return new Class(value, this.discovery, remotes);
     }
+    /** What the request takes, which only sending a file says anything about. */
+    explain(directives, _, introspection) {
+        for (const directive of directives)
+            directive.describe?.(introspection);
+        return introspection;
+    }
     async precall(directives, input, parameters) {
         let context = null;
         let action = null;

package/transpiled/directives/octets/Octets.js.map

@@ -1 +1 @@
-{"version":3,"file":"Octets.js","sourceRoot":"","sources":["../../../source/directives/octets/Octets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAQjD,MAAM,OAAO,MAAM;IACD,IAAI,GAAW,QAAQ,CAAA;IACvB,SAAS,GAAY,KAAK,CAAA;IAElC,SAAS,GAAG,IAAqC,CAAA;IAElD,MAAM,CAAC,IAAY,EAAE,KAAU,EAAE,OAAgB;QACtD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAE9B,IAAI,KAAK,KAAK,SAAS;YACrB,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,sBAAsB,CAAC,CAAA;QAElE,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;QAE3D,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAClD,CAAC;IAEM,KAAK,CAAC,OAAO,CAClB,UAAuB,EACvB,KAAY,EACZ,UAAuB;QAEvB,IAAI,OAAO,GAAmB,IAAI,CAAA;QAClC,IAAI,MAAM,GAAqB,IAAI,CAAA;QAEnC,KAAK,MAAM,SAAS,IAAI,UAAU;YAChC,IAAI,SAAS,YAAY,OAAO;gBAAE,OAAO,KAAK,SAAS,CAAA;iBAClD,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM,GAAG,SAAS,CAAA;;gBACvC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;QAEpD,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAEhC,4CAA4C;QAC5C,IAAI,OAAO,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QAEtE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,CAAA;QAExE,IAAI,QAAQ,KAAK,MAAM,CAAC,QAAQ;YAC9B,MAAM,IAAI,QAAQ,CAChB,qBAAqB,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,CAClE,CAAA;QAEH,uCAAuC;QACvC,OAAO,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;IAC/D,CAAC;CACF;AAED,MAAM,UAAU,GAAgC;IAC9C,OAAO,EAAE,OAAO;IAChB,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,iBAAiB;CAC5B,CAAA"}
+{"version":3,"file":"Octets.js","sourceRoot":"","sources":["../../../source/directives/octets/Octets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AASjD,MAAM,OAAO,MAAM;IACD,IAAI,GAAW,QAAQ,CAAA;IACvB,SAAS,GAAY,KAAK,CAAA;IAElC,SAAS,GAAG,IAAqC,CAAA;IAElD,MAAM,CAAC,IAAY,EAAE,KAAU,EAAE,OAAgB;QACtD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAE9B,IAAI,KAAK,KAAK,SAAS;YACrB,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,sBAAsB,CAAC,CAAA;QAElE,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;QAE3D,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAClD,CAAC;IAED,6EAA6E;IACtE,OAAO,CAAC,UAAuB,EAAE,CAAQ,EAAE,aAA4B;QAC5E,KAAK,MAAM,SAAS,IAAI,UAAU;YAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,CAAA;QAEvE,OAAO,aAAa,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,OAAO,CAClB,UAAuB,EACvB,KAAY,EACZ,UAAuB;QAEvB,IAAI,OAAO,GAAmB,IAAI,CAAA;QAClC,IAAI,MAAM,GAAqB,IAAI,CAAA;QAEnC,KAAK,MAAM,SAAS,IAAI,UAAU;YAChC,IAAI,SAAS,YAAY,OAAO;gBAAE,OAAO,KAAK,SAAS,CAAA;iBAClD,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM,GAAG,SAAS,CAAA;;gBACvC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;QAEpD,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAEhC,4CAA4C;QAC5C,IAAI,OAAO,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QAEtE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,CAAA;QAExE,IAAI,QAAQ,KAAK,MAAM,CAAC,QAAQ;YAC9B,MAAM,IAAI,QAAQ,CAChB,qBAAqB,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,CAClE,CAAA;QAEH,uCAAuC;QACvC,OAAO,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;IAC/D,CAAC;CACF;AAED,MAAM,UAAU,GAAgC;IAC9C,OAAO,EAAE,OAAO;IAChB,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,iBAAiB;CAC5B,CAAA"}

package/transpiled/directives/octets/Put.d.ts

@@ -3,6 +3,7 @@ import type { Parameter } from '../../RTD/index.js';
 import type { Unit } from './workflows/index.js';
 import type { Remotes } from '../../Remotes.js';
 import type { Component } from '@toa.io/core';
+import type { Introspection } from '../../Introspection.js';
 import type { Output } from '../../io.js';
 import type { Input } from './types.js';
 export declare class Put extends Directive {
@@ -16,6 +17,8 @@ export declare class Put extends Directive {
     private readonly discovery;
     private storage;
     constructor(options: Options | null, discovery: Promise<Component>, remotes: Remotes);
+    /** What sending a file here takes: what may be sent, how much of it, and what comes back. */
+    describe(introspection: Introspection): void;
     apply(storage: string, input: Input, parameters: Parameter[]): Promise<Output>;
     private reply;
     private execute;

package/transpiled/directives/octets/Put.js

@@ -32,6 +32,14 @@ export class Put extends Directive {
         cors.allow('content-attributes');
         cors.allow('content-location');
     }
+    /** What sending a file here takes: what may be sent, how much of it, and what comes back. */
+    describe(introspection) {
+        introspection.octets = {
+            ...(this.accept === undefined ? {} : { accept: this.accept }),
+            limit: this.limitString,
+            ...(this.workflow === undefined ? {} : { stream: true })
+        };
+    }
     async apply(storage, input, parameters) {
         this.storage ??= await this.discovery.storage;
         const request = {

package/transpiled/directives/octets/Put.js.map

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

package/transpiled/manifest.js

@@ -1,6 +1,6 @@
 import assert from 'node:assert';
 import { parse } from './RTD/syntax/index.js';
-import { shortcuts } from './Directive.js';
+import { shortcuts } from './shortcuts.js';
 import * as schemas from './schemas.js';
 export function manifest(declaration, manifest) {
     assert.ok(typeof declaration === 'object' && declaration !== null, 'Exposition declaration must be an object');

package/transpiled/root.js

@@ -1,7 +1,7 @@
-import { merge } from '@toa.io/generic';
+import { environment, merge } from '@toa.io/generic';
 import { syntax } from './RTD/index.js';
 export function resolve() {
-    const value = process.env.TOA_EXPOSITION;
+    const value = environment.get('TOA_EXPOSITION');
     const root = value !== undefined ? JSON.parse(value) : syntax.createNode();
     merge(root, PREDEFINED);
     return root;

package/transpiled/root.js.map

@@ -1 +1 @@
-{"version":3,"file":"root.js","sourceRoot":"","sources":["../source/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEvC,MAAM,UAAU,OAAO;IACrB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;IACxC,MAAM,IAAI,GACR,KAAK,KAAK,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;IAEhF,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAEvB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,GAAgB;IAC9B,MAAM,EAAE;QACN;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,EAAE;gBACV,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,KAAK;wBACX,UAAU,EAAE;4BACV;gCACE,MAAM,EAAE,IAAI;gCACZ,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;6BACvB;4BACD;gCACE,MAAM,EAAE,MAAM;gCACd,IAAI,EAAE,MAAM;gCACZ,KAAK,EAAE,IAAI;6BACZ;yBACF;qBACF;oBACD;wBACE,IAAI,EAAE,MAAM;wBACZ,UAAU,EAAE;4BACV;gCACE,MAAM,EAAE,IAAI;gCACZ,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;6BACvB;4BACD;gCACE,MAAM,EAAE,MAAM;gCACd,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE,IAAI;6BACZ;yBACF;qBACF;iBACF;gBACD,UAAU,EAAE,EAAE;aACf;SACF;KACF;IACD,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;CACf,CAAA"}
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../source/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEvC,MAAM,UAAU,OAAO;IACrB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC/C,MAAM,IAAI,GACR,KAAK,KAAK,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;IAEhF,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAEvB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,GAAgB;IAC9B,MAAM,EAAE;QACN;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,EAAE;gBACV,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,KAAK;wBACX,UAAU,EAAE;4BACV;gCACE,MAAM,EAAE,IAAI;gCACZ,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;6BACvB;4BACD;gCACE,MAAM,EAAE,MAAM;gCACd,IAAI,EAAE,MAAM;gCACZ,KAAK,EAAE,IAAI;6BACZ;yBACF;qBACF;oBACD;wBACE,IAAI,EAAE,MAAM;wBACZ,UAAU,EAAE;4BACV;gCACE,MAAM,EAAE,IAAI;gCACZ,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;6BACvB;4BACD;gCACE,MAAM,EAAE,MAAM;gCACd,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE,IAAI;6BACZ;yBACF;qBACF;iBACF;gBACD,UAAU,EAAE,EAAE;aACf;SACF;KACF;IACD,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;CACf,CAAA"}

package/transpiled/service.d.ts

@@ -0,0 +1,7 @@
+import type { Connector } from '@toa.io/core';
+import type { Host } from './Factory.js';
+/**
+ * The gateway. A composition loads this extension for its tenants alone, so what the
+ * gateway is made of is reached from here and nowhere the factory imports.
+ */
+export declare function service(host: Host): Promise<Connector | null>;

package/transpiled/service.js

@@ -0,0 +1,74 @@
+import assert from 'node:assert';
+import { console, traces } from 'openspan';
+import { Gateway } from './Gateway.js';
+import { Remotes } from './Remotes.js';
+import { Tree } from './RTD/index.js';
+import { EndpointsFactory } from './Endpoint.js';
+import { families, interceptors } from './directives/index.js';
+import { DirectivesFactory } from './Directive.js';
+import { Composition } from './Composition.js';
+import * as root from './root.js';
+import { ATOM_GROUP, CHANNEL } from './const.js';
+import { Interception } from './Interception.js';
+import { Dispatcher } from './RPC/index.js';
+import { Server as Model } from './MCP/index.js';
+import * as http from './HTTP/index.js';
+import { environment } from '@toa.io/generic';
+/**
+ * The gateway. A composition loads this extension for its tenants alone, so what the
+ * gateway is made of is reached from here and nowhere the factory imports.
+ */
+export async function service(host) {
+    const properties = environment.get('TOA_EXPOSITION_PROPERTIES');
+    assert.ok(properties !== undefined, 'TOA_EXPOSITION_PROPERTIES is undefined');
+    configureLogs();
+    const options = JSON.parse(properties);
+    const broadcast = await host.broadcast(CHANNEL);
+    const server = http.Server.create({ ...options });
+    const remotes = new Remotes(host);
+    const node = root.resolve();
+    const methods = new EndpointsFactory(remotes);
+    const directives = new DirectivesFactory(families, remotes, host, options);
+    const interception = new Interception(interceptors, options);
+    const tree = new Tree(node, methods, directives);
+    const composition = new Composition(host);
+    const dispatcher = options.rpc === undefined ? null : new Dispatcher(options.rpc);
+    const mcp = options.mcp === undefined ? null : new Model(options.mcp, tree);
+    const gateway = new Gateway(broadcast, tree, interception, directives, dispatcher, mcp);
+    gateway.depends(remotes);
+    gateway.depends(composition);
+    // what the directives meter through; one atom per process, connected once
+    gateway.depends(host.atom(ATOM_GROUP));
+    server.attach(gateway.process.bind(gateway));
+    server.depends(gateway);
+    return server;
+}
+const LOGS_PREFIX = 'TOA_TELEMETRY_LOGS';
+const TRACES_ENV = 'TOA_TELEMETRY_TRACES';
+function configureLogs() {
+    const globEnv = environment.get(LOGS_PREFIX);
+    const level = environment.get('TOA_DEV') === '1' ? 'trace' : 'info';
+    const options = globEnv === undefined ? { level } : JSON.parse(globEnv);
+    console.configure({ level: options.level ?? level });
+    const tracesEnv = environment.get(TRACES_ENV);
+    const tracing = tracesEnv === undefined ? development() : JSON.parse(tracesEnv);
+    // `openspan` is not Toa's and reads the environment, which no longer holds the context by
+    // the time the exporter is made — so the service is named here
+    if (tracing.exporters?.otlp !== undefined)
+        tracing.exporters.otlp.service ??= environment.get('TOA_CONTEXT');
+    traces(tracing);
+}
+/**
+ * Tracing is off unless it is configured. The console exporter is a local development
+ * mechanism, so it is turned on for `toa dev` and for a boot trace the CLI has already
+ * asked for (`runtime/boot/src/span.js`), and nowhere else — a deployment that wants
+ * traces annotates `telemetry.traces.exporters`.
+ *
+ * The gateway boots without the telemetry extension, hence the copy of
+ * `extensions/telemetry/source/extension.ts`.
+ */
+function development() {
+    const local = environment.get('TOA_DEV') === '1' || environment.get('TOA_BOOT_TRACE') === '1';
+    return local ? { exporters: { console: {} } } : {};
+}
+//# sourceMappingURL=service.js.map

package/transpiled/service.js.map

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

package/transpiled/shortcuts.d.ts

@@ -0,0 +1,3 @@
+import type { Shortcuts } from './RTD/syntax/index.js';
+/** What a directive may be written as, where the family is implied. */
+export declare const shortcuts: Shortcuts;

package/transpiled/shortcuts.js

@@ -0,0 +1,13 @@
+/** What a directive may be written as, where the family is implied. */
+export const shortcuts = new Map([
+    ['anonymous', 'auth:anonymous'],
+    ['anyone', 'auth:anyone'],
+    ['id', 'auth:id'],
+    ['role', 'auth:role'],
+    ['rule', 'auth:rule'],
+    ['incept', 'auth:incept'],
+    ['input', 'io:input'],
+    ['output', 'io:output'],
+    ['languages', 'map:languages']
+]);
+//# sourceMappingURL=shortcuts.js.map

package/transpiled/shortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.js","sourceRoot":"","sources":["../source/shortcuts.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,MAAM,CAAC,MAAM,SAAS,GAAc,IAAI,GAAG,CAAC;IAC1C,CAAC,WAAW,EAAE,gBAAgB,CAAC;IAC/B,CAAC,QAAQ,EAAE,aAAa,CAAC;IACzB,CAAC,IAAI,EAAE,SAAS,CAAC;IACjB,CAAC,MAAM,EAAE,WAAW,CAAC;IACrB,CAAC,MAAM,EAAE,WAAW,CAAC;IACrB,CAAC,QAAQ,EAAE,aAAa,CAAC;IACzB,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,QAAQ,EAAE,WAAW,CAAC;IACvB,CAAC,WAAW,EAAE,eAAe,CAAC;CAC/B,CAAC,CAAA"}