@toa.io/extensions.exposition 1.0.0-alpha.286 → 1.0.0-alpha.288

package/transpiled/directives/map/Headers.js.map

@@ -1 +1 @@
-{"version":3,"file":"Headers.js","sourceRoot":"","sources":["../../../source/directives/map/Headers.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAI7C;;;;GAIG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;AAE7C,MAAM,OAAO,OAAQ,SAAQ,OAA+B;IACzC,OAAO,CAAU;IAElC,YAAmB,GAA2B;QAC5C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,EAAE,iCAAiC,CAAC,CAAA;QAExE,MAAM,CAAC,EAAE,CACP,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAC9D,oDAAoD,CACrD,CAAA;QAED,KAAK,CAAC,GAAG,CAAC,CAAA;QAEV,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC5E,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IACtD,CAAC;IAEe,OAAO,CAAC,aAA4B;QAClD,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;YAE5C,aAAa,CAAC,OAAO,KAAK,EAAE,CAAA;YAC5B,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAA;QACzD,CAAC;IACH,CAAC;IAEM,UAAU,CAAC,OAAc;QAC9B,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC3C,QAAQ,CAAC,OAAO,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAA;YAEzC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;gBAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC5E,CAAC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CACtC,CAAC,UAAkC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE;YACzD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAE7C,IAAI,KAAK,KAAK,SAAS;gBACrB,UAAU,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;YAExE,OAAO,UAAU,CAAA;QACnB,CAAC,EACD,EAAE,CACH,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"Headers.js","sourceRoot":"","sources":["../../../source/directives/map/Headers.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAI7C;;;;GAIG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;AAE7C,MAAM,OAAO,OAAQ,SAAQ,OAA+B;IACzC,OAAO,CAAU;IAElC,YAAmB,GAA2B;QAC5C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,EAAE,iCAAiC,CAAC,CAAA;QAExE,MAAM,CAAC,EAAE,CACP,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAC9D,oDAAoD,CACrD,CAAA;QAED,KAAK,CAAC,GAAG,CAAC,CAAA;QAEV,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC5E,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IACtD,CAAC;IAED;;;;OAIG;IACa,OAAO,CAAC,aAA4B;QAClD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;IAC/E,CAAC;IAEM,UAAU,CAAC,OAAc;QAC9B,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC3C,QAAQ,CAAC,OAAO,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAA;YAEzC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;gBAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC5E,CAAC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CACtC,CAAC,UAAkC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE;YACzD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAE7C,IAAI,KAAK,KAAK,SAAS;gBACrB,UAAU,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;YAExE,OAAO,UAAU,CAAA;QACnB,CAAC,EACD,EAAE,CACH,CAAA;IACH,CAAC;CACF"}

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"}