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

package/source/directives/mcp/Tool.test.ts

@@ -4,99 +4,53 @@ import { Tool } from './Tool.js'
 import { MCP } from './MCP.js'
 
 describe('mcp:tool', () => {
-  it('should take what the route states the tool is', () => {
-    const tool = new Tool('The pots that are hot.', '/pots/hot')
-
-    assert.strictEqual(tool.description, 'The pots that are hot.')
-    assert.strictEqual(tool.title, undefined)
-  })
-
-  it('should take a title beside the description', () => {
-    const tool = new Tool(
-      { title: 'Hot pots', description: 'The pots that are hot.' },
-      '/pots'
-    )
-
-    assert.strictEqual(tool.title, 'Hot pots')
-    assert.strictEqual(tool.description, 'The pots that are hot.')
-  })
-
-  it('should not accept a mapping without a description', () => {
-    assert.throws(() => new Tool({ title: 'Hot pots' }, '/pots'), /cannot be empty/)
-  })
-
-  it('should not accept an empty title', () => {
-    assert.throws(
-      () => new Tool({ title: ' ', description: 'A pot.' }, '/pots'),
-      /a title cannot be empty/
-    )
+  it('should publish a method', () => {
+    assert.strictEqual(new Tool(true, '/pots/hot').published, true)
   })
 
-  it('should not accept what it does not know', () => {
-    assert.throws(
-      () => new Tool({ description: 'A pot.', name: 'pots' }, '/pots'),
-      /unknown 'name'/
-    )
+  it('should withdraw one, because a declaration is inherited', () => {
+    assert.strictEqual(new Tool(false, '/pots/hot').published, false)
   })
 
-  it('should not accept an empty description', () => {
-    assert.throws(() => new Tool('  ', '/pots'), /cannot be empty/)
+  it('should not accept what a tool is, which is `help:method`', () => {
+    assert.throws(() => new Tool('The pots that are hot.', '/pots'), /`help:method`/)
+    assert.throws(() => new Tool({ title: 'Hot pots' }, '/pots'), /`help:method`/)
   })
 
   it('should not accept a value that is not one', () => {
-    // `true` published a tool that stated nothing, back when an operation stated it instead
-    assert.throws(() => new Tool(true, '/pots'), /the value is what the tool is/)
-    assert.throws(() => new Tool(false, '/pots'), /the value is what the tool is/)
-    assert.throws(() => new Tool(1, '/pots'), /the value is what the tool is/)
-    assert.throws(() => new Tool(['A pot.'], '/pots'), /the value is what the tool is/)
+    assert.throws(() => new Tool(undefined, '/pots'), /whether the method is published/)
+    assert.throws(() => new Tool(null, '/pots'), /whether the method is published/)
   })
 
   it('should refuse a route no name can spell', () => {
-    assert.throws(() => new Tool('A pot.', '/pots/a.b'), /no tool name can spell/)
-    assert.throws(() => new Tool('A pot.', '/pots/:a.b'), /no tool name can spell/)
-
-    // an underscore is what the convention keeps for itself
-    assert.throws(() => new Tool('A pot.', '/pots/a_b'), /no tool name can spell/)
+    assert.throws(() => new Tool(true, '/pots/v1.0'), /no tool name can spell/)
   })
 
   it('should name the route it refuses', () => {
-    assert.throws(() => new Tool('A pot.', '/pots/a.b'), /'\/pots\/a\.b'/)
+    assert.throws(() => new Tool(true, '/pots/v1.0'), /'\/pots\/v1\.0'/)
+  })
+
+  it('should not ask a route it does not publish to be spellable', () => {
+    assert.strictEqual(new Tool(false, '/pots/v1.0').published, false)
   })
 })
 
 describe('mcp:tool inheritance', () => {
-  const family = new MCP()
+  const mcp = new MCP()
 
   it('should take the nearest declaration', () => {
-    const own = new Tool('Nearest.', '/pots')
-    const inherited = new Tool('Furthest.', '/pots')
+    const nearest = new Tool(false, '/pots')
+    const further = new Tool(true, '/pots')
 
-    assert.strictEqual(MCP.published([own, inherited])?.description, 'Nearest.')
+    assert.strictEqual(MCP.published([nearest, further]), false)
   })
 
   it('should publish nothing where nothing is declared', () => {
-    assert.strictEqual(MCP.published(undefined), null)
-    assert.strictEqual(MCP.published([]), null)
-  })
-
-  it('should describe a method with what the route states', () => {
-    const described = family.explain(
-      [new Tool('What the route is.', '/pots')],
-      null as never,
-      { description: 'What the operation is.' }
-    )
-
-    assert.strictEqual(described.description, 'What the route is.')
-  })
-
-  it('should state nothing where nothing is declared', () => {
-    assert.strictEqual(family.explain([], null as never, {}).description, undefined)
+    assert.strictEqual(MCP.published(undefined), false)
+    assert.strictEqual(MCP.published([]), false)
   })
 
   it('should refuse a directive it does not know', () => {
-    assert.throws(
-      () => family.create('resource', 'A pot.', null, '/pots'),
-      /Unknown directive: mcp:resource/
-    )
+    assert.throws(() => mcp.create('tools', true, null, '/pots'), /Unknown directive/)
   })
 })

package/source/directives/mcp/Tool.ts

@@ -3,57 +3,30 @@ 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 {
-  public readonly description: string
-  public readonly title: string | undefined
+  public readonly published: boolean
 
   public constructor(value: unknown, route: string) {
-    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 as Record<string, unknown>
-
-    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'
+      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`
-    )
+    if (value)
+      assert.ok(
+        refusal(segment(route)) === null,
+        `Directive mcp:tool: '${route}' holds a segment no tool name can spell`
+      )
 
-    this.description = description
-    this.title = title as string | undefined
+    this.published = value
   }
 }

package/source/directives/octets/Directive.ts

@@ -1,5 +1,6 @@
 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 abstract class Directive {
@@ -11,4 +12,10 @@ export abstract class Directive {
     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.
+   */
+  public describe?(introspection: Introspection): void
 }

package/source/directives/octets/Octets.ts

@@ -9,6 +9,7 @@ import type { Output } from '../../io.js'
 import type { Component } from '@toa.io/core'
 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 class Octets implements DirectiveFamily<Directive> {
@@ -28,6 +29,13 @@ export class Octets implements DirectiveFamily<Directive> {
     return new Class(value, this.discovery, remotes)
   }
 
+  /** What the request takes, which only sending a file says anything about. */
+  public explain(directives: Directive[], _: Input, introspection: Introspection): Introspection {
+    for (const directive of directives) directive.describe?.(introspection)
+
+    return introspection
+  }
+
   public async precall(
     directives: Directive[],
     input: Input,

package/source/directives/octets/Put.ts

@@ -12,6 +12,7 @@ import type { Unit, Location } from './workflows/index.js'
 import type { Entry } from '@toa.io/extensions.storages'
 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'
 
@@ -63,6 +64,15 @@ export class Put extends Directive {
     cors.allow('content-location')
   }
 
+  /** What sending a file here takes: what may be sent, how much of it, and what comes back. */
+  public override describe(introspection: Introspection): void {
+    introspection.octets = {
+      ...(this.accept === undefined ? {} : { accept: this.accept }),
+      limit: this.limitString,
+      ...(this.workflow === undefined ? {} : { stream: true })
+    }
+  }
+
   public async apply(
     storage: string,
     input: Input,

package/source/manifest.ts

@@ -1,6 +1,6 @@
 import assert from 'node:assert'
 import { parse, type Node, type Method, type Query } from './RTD/syntax/index.js'
-import { shortcuts } from './Directive.js'
+import { shortcuts } from './shortcuts.js'
 import * as schemas from './schemas.js'
 import type { Manifest } from '@toa.io/norm'
 

package/source/root.ts

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

package/source/service.ts

@@ -0,0 +1,94 @@
+import assert from 'node:assert'
+import { console, traces, type LevelName, type TracesOptions } 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'
+import type { Broadcast } from './Gateway.js'
+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 async function service(host: Host): Promise<Connector | null> {
+  const properties = environment.get('TOA_EXPOSITION_PROPERTIES')
+
+  assert.ok(properties !== undefined, 'TOA_EXPOSITION_PROPERTIES is undefined')
+
+  configureLogs()
+
+  const options = JSON.parse(properties) as http.Options
+  const broadcast: 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(): void {
+  const globEnv = environment.get(LOGS_PREFIX)
+  const level: LevelName = environment.get('TOA_DEV') === '1' ? 'trace' : 'info'
+  const options =
+    globEnv === undefined ? { level } : (JSON.parse(globEnv) as { level?: LevelName })
+
+  console.configure({ level: options.level ?? level })
+
+  const tracesEnv = environment.get(TRACES_ENV)
+  const tracing =
+    tracesEnv === undefined ? development() : (JSON.parse(tracesEnv) as TracesOptions)
+
+  // `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(): TracesOptions {
+  const local = environment.get('TOA_DEV') === '1' || environment.get('TOA_BOOT_TRACE') === '1'
+
+  return local ? { exporters: { console: {} } } : {}
+}

package/source/shortcuts.ts

@@ -0,0 +1,14 @@
+import type { Shortcuts } from './RTD/syntax/index.js'
+
+/** What a directive may be written as, where the family is implied. */
+export const shortcuts: 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']
+])

package/transpiled/Directive.d.ts

@@ -36,8 +36,8 @@ export declare class DirectivesFactory implements RTD.DirectiveFactory {
     /** Request-scoped, on the message going back. */
     depart(context: Context, response: OutgoingMessage): Promise<void>;
     create(declarations: RTD.syntax.Directive[], route?: string): Directives;
+    inheritable(directive: RTD.syntax.Directive): boolean;
     dispose(): void;
     /** Mandatory families first, in their own order; everything else keeps its own. */
     private rank;
 }
-export declare const shortcuts: RTD.syntax.Shortcuts;

package/transpiled/Directive.js

@@ -141,6 +141,9 @@ export class DirectivesFactory {
         this.instances.push(directives);
         return directives;
     }
+    inheritable(directive) {
+        return this.families[directive.family]?.inherited !== false;
+    }
     dispose() {
         for (const directives of this.instances)
             directives.dispose();
@@ -157,15 +160,4 @@ function options(set, stage) {
         options.attributes = { directives: Array.from(new Set(set.names)).join(' ') };
     return options;
 }
-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=Directive.js.map

package/transpiled/Directive.js.map

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

package/transpiled/Discovery/Explorer.d.ts

@@ -0,0 +1,11 @@
+import * as http from '../HTTP/index.js';
+import type { Tree } from '../RTD/index.js';
+/**
+ * What an application serves, for every route at once. Each entry is what `OPTIONS` on that
+ * path answers, so a key taken from here is a request that can be made.
+ */
+export declare class Explorer {
+    private readonly tree;
+    constructor(tree: Tree);
+    process(context: http.Context): Promise<http.OutgoingMessage>;
+}

package/transpiled/Discovery/Explorer.js

@@ -0,0 +1,29 @@
+import * as http from '../HTTP/index.js';
+import { BRANCH_TTL } from '../const.js';
+import { describe } from './tree.js';
+/**
+ * What an application serves, for every route at once. Each entry is what `OPTIONS` on that
+ * path answers, so a key taken from here is a request that can be made.
+ */
+export class Explorer {
+    tree;
+    constructor(tree) {
+        this.tree = tree;
+    }
+    async process(context) {
+        if (context.request.method !== 'OPTIONS')
+            throw new http.MethodNotAllowed(new Headers({ allow: ALLOW }));
+        return {
+            body: await describe(this.tree, context),
+            headers: new Headers({
+                allow: ALLOW,
+                // it stands until a branch expires, and it is filtered by who asked
+                'cache-control': `private, max-age=${BRANCH_TTL / 1000}`,
+                vary: 'authorization'
+            })
+        };
+    }
+}
+/** The verbs of this path, which are not the verbs of the tree it answers with. */
+const ALLOW = 'GET, HEAD, OPTIONS';
+//# sourceMappingURL=Explorer.js.map

package/transpiled/Discovery/Explorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Explorer.js","sourceRoot":"","sources":["../../source/Discovery/Explorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGpC;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACF,IAAI,CAAM;IAE3B,YAAmB,IAAU;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,OAAqB;QACxC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS;YACtC,MAAM,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;QAEhE,OAAO;YACL,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;YACxC,OAAO,EAAE,IAAI,OAAO,CAAC;gBACnB,KAAK,EAAE,KAAK;gBACZ,oEAAoE;gBACpE,eAAe,EAAE,oBAAoB,UAAU,GAAG,IAAI,EAAE;gBACxD,IAAI,EAAE,eAAe;aACtB,CAAC;SACH,CAAA;IACH,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,KAAK,GAAG,oBAAoB,CAAA"}

package/transpiled/Discovery/Site.d.ts

@@ -0,0 +1,43 @@
+import type { Input, Output } from '../io.js';
+import type { Interceptor } from '../Interception.js';
+/**
+ * The page that reads the tree: the directory `ui` builds, and nothing else.
+ *
+ * An interceptor rather than an endpoint, for the reason the OAuth documents are one — it
+ * runs before a credential is resolved. A page is public, and one served after `auth` would
+ * refuse the client holding a stale token, who is the client most likely to have opened it.
+ * It is also what keeps `depart` off these replies: a re-issued credential sets `no-store`,
+ * which would take the build hash off every asset that carries one.
+ *
+ * It claims the whole prefix, so that nothing under it reaches the router — a crawler
+ * asking for assets that are not there would otherwise have every one of them counted as a
+ * route that has gone missing, and ping discovery about it.
+ *
+ * `OPTIONS` on the prefix itself is the exception it lets through: the tree is what answers
+ * there, and that needs the identity this stage does not have yet.
+ */
+export declare class Site implements Interceptor {
+    readonly name = "discovery";
+    /** What a test points at a fixture; the build otherwise. */
+    private readonly override;
+    private root;
+    constructor(root?: string);
+    /**
+     * Resolved here rather than at construction because this is a module singleton, built
+     * when the module loads and before anything has said where the page is. Said once, too,
+     * because a page that is not built is otherwise a `503` per request and nothing else.
+     */
+    mount(): void;
+    intercept(input: Input): Output;
+    /**
+     * The file a request lands on, or `null` when nothing does. A path that exists is served
+     * as it is; anything else that could be a route falls back to the page, because the
+     * client router — not this server — knows what routes there are.
+     */
+    private resolve;
+    /**
+     * Always with a `content-type` of its own: a stream without one is framed as
+     * `multipart/*` and the page arrives as an envelope of JSON-encoded buffers.
+     */
+    private send;
+}