@openbrf/plugin-sdk 1.0.0 → 1.2.0

package/README.md

@@ -0,0 +1,95 @@
+# @openbrf/plugin-sdk
+
+The plugin contract of [Open BRF](https://github.com/openbrf/openbrf): the
+manifest schema, the permission set, the interfaces of the services the host
+hands a plugin, and the schema of the catalog that lists plugins and themes.
+
+The major version is the plugin API version. Anything a plugin could notice
+raises it, and an additive change keeps it. 1.x is API version 1.
+
+## Installing
+
+```sh
+npm install --save-dev @openbrf/plugin-sdk
+```
+
+A development dependency, never a dependency. An instance installs a plugin
+offline from its verified tarball and refuses a `package.json` that declares
+any `dependencies`. Nothing in this package has to resolve at runtime: the host
+passes everything a plugin uses in through `PluginHost`, so a plugin imports
+the SDK for types and for the checks its own CI runs.
+
+`@nestjs/common` 12 is a peer dependency. A plugin declares `@nestjs/common`,
+`@nestjs/core` and `zod` as peer dependencies too, and never bundles them; the
+host supplies the running copies.
+
+## The server entry
+
+A prebuilt CommonJS bundle that exports `createPlugin`. It receives the host
+object and returns a NestJS module, whose controllers the host mounts under
+`/api/plugin/<id>/`, inside the application's authorization guard.
+
+```ts
+import { Controller, Get, Injectable, Module } from "@nestjs/common";
+import type { PluginModuleFactory } from "@openbrf/plugin-sdk";
+
+export const createPlugin: PluginModuleFactory = (host) => {
+  @Injectable()
+  class OccupancyService {
+    async summary() {
+      return host.addressBook.summary();
+    }
+  }
+
+  @Controller()
+  class OccupancyController {
+    constructor(private readonly service: OccupancyService) {}
+
+    @Get("summary")
+    async summary() {
+      return this.service.summary();
+    }
+  }
+
+  @Module({})
+  class OccupancyModule {}
+
+  return {
+    module: OccupancyModule,
+    controllers: [OccupancyController],
+    providers: [OccupancyService],
+  };
+};
+```
+
+## Checking a plugin before it is published
+
+The checks an instance runs at install and at boot are exported, so a
+plugin's CI refuses what an instance would refuse:
+
+- `assertPluginPackage(packageJson)` throws with every problem in the
+  manifest at once; `parsePluginPackage` returns them instead.
+- `pluginPackageProblems(contents)` takes the parsed `package.json`, the file
+  list, the server bundle's source and the two locale files, and returns every
+  problem that would stop the package installing or loading, one sentence
+  each.
+- `catalogEntrySchema` is the schema of the entry a listing adds to the
+  catalog.
+
+## Documentation
+
+- [The plugin contract](https://github.com/openbrf/openbrf/blob/main/docs/plugin-contract.md):
+  the manifest, permissions, personal data, the server and client entries,
+  settings, translations, distribution and installation.
+- [ADR 0003](https://github.com/openbrf/openbrf/blob/main/docs/adr/0003-plugin-loading-and-module-resolution.md):
+  how a plugin is loaded and how it resolves the host's packages.
+- [ADR 0020](https://github.com/openbrf/openbrf/blob/main/docs/adr/0020-the-public-catalog-and-the-published-packages.md):
+  the public catalog and the published packages.
+
+## Licence
+
+AGPL-3.0-only, with the
+[Open BRF Module Exception](https://github.com/openbrf/openbrf/blob/main/LICENSE-EXCEPTION.md).
+A plugin that reaches the core only through the documented extension
+interfaces is a module under that exception and may be licensed on any terms.
+Both texts are in the package.

package/dist/abort-signal.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The `AbortSignal` the host hands a plugin, and takes from one.
+ *
+ * The host passes a real `AbortSignal`. This package compiles against the
+ * language alone and cannot name the platform's type, so it is looked up in
+ * the plugin's own program: where that has an `AbortSignal`, from the DOM
+ * library or from Node's types, this is it, and the signal can be passed on to
+ * `fetch` and to anything else that takes one. Where it has none, this is the
+ * part of one a plugin can use without them.
+ */
+export type PluginAbortSignal = typeof globalThis extends {
+    readonly AbortSignal: {
+        readonly prototype: infer Signal;
+    };
+} ? Signal : PluginAbortSignalShape;
+/** What every `AbortSignal` has, for a program without the platform's types. */
+interface PluginAbortSignalShape {
+    readonly aborted: boolean;
+    addEventListener(type: "abort", listener: () => void): void;
+    removeEventListener(type: "abort", listener: () => void): void;
+}
+export {};
+//# sourceMappingURL=abort-signal.d.ts.map

package/dist/abort-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-signal.d.ts","sourceRoot":"","sources":["../src/abort-signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,UAAU,SAAS;IACxD,QAAQ,CAAC,WAAW,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,MAAM,CAAA;KAAE,CAAC;CAC5D,GACG,MAAM,GACN,sBAAsB,CAAC;AAE3B,gFAAgF;AAChF,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC5D,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAChE"}

package/dist/abort-signal.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=abort-signal.js.map

package/dist/abort-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-signal.js","sourceRoot":"","sources":["../src/abort-signal.ts"],"names":[],"mappings":""}

package/dist/action-refusal.d.ts

@@ -0,0 +1,101 @@
+import type { ActionRetry } from "./actions.ts";
+/**
+ * Why the registry refused a call, in a form a caller can act on.
+ *
+ * A caller here is often a model rather than a person, which changes what a
+ * refusal has to carry. A person reads a sentence and decides what to do; a
+ * model needs to know whether trying again could ever work, and what to change
+ * if it could. So every refusal has a code, a status, and a published rule for
+ * how a connector should render it.
+ *
+ * The vocabulary lives here rather than in the API because a plugin dispatching
+ * through `host.actions.invoke` has no other way to read it: the catalogue
+ * endpoint serves the same table over HTTP, and a plugin in the same process
+ * has no route to that. The API imports it back, so there is one list.
+ */
+export declare const ACTION_ERROR_REASONS: readonly ["unknown-action", "forbidden-capability", "forbidden-surface", "insufficient-scope", "not-serving", "read-only", "confirmation-required", "output-invalid", "rate-limited", "internal"];
+export type ActionErrorReason = (typeof ACTION_ERROR_REASONS)[number];
+/**
+ * How a connector should tell its caller about a refusal.
+ *
+ * A protocol error means the call never happened; a tool result means it
+ * happened and was refused, and only the second is something to tell the
+ * person about.
+ */
+export type ActionRefusalTransport = "protocol" | "tool-result";
+/**
+ * How a connector should render each refusal, published as data.
+ *
+ * Served on the catalogue endpoint as well, so that two connectors - one
+ * reading it over HTTP, one in process - cannot disagree about whether a 403
+ * is worth retrying. Keyed by the registry's reasons and by the two refusals
+ * that are not the registry's own: a body the action's input schema refuses,
+ * and a refusal raised by the service behind the action.
+ */
+export declare const ACTION_ERROR_MCP: Readonly<Record<ActionErrorReason | "invalid-body" | "domain", {
+    readonly transport: ActionRefusalTransport;
+    readonly retry: ActionRetry;
+}>>;
+/**
+ * Which of the three ways a call was refused.
+ *
+ * "registry" is the registry's own refusal, and `reason` is then one of
+ * ACTION_ERROR_REASONS. "invalid-body" is an input the action's schema
+ * refused, and `reason` is "invalid-body". "domain" is the service behind the
+ * action refusing on the merits, and `reason` is one the action declared in
+ * its `errors`.
+ */
+export type ActionRefusalKind = "registry" | "invalid-body" | "domain";
+/**
+ * What `host.actions.invoke` rejects with when the call was refused.
+ *
+ * One shape for all three kinds, so that a connector renders a refusal from
+ * the fields it carries rather than by recognising the host's classes, which a
+ * plugin cannot import. Recognise one with `isActionRefusal`, not with
+ * `instanceof`: the host builds it, and a plugin's bundled copy of this
+ * package is not the host's.
+ *
+ * A plugin route that rethrows one answers its caller with the same status,
+ * body and headers the registry would have.
+ */
+export interface ActionRefusal extends Error {
+    readonly name: "ActionRefusal";
+    readonly kind: ActionRefusalKind;
+    readonly reason: string;
+    /** The HTTP status the refusal answers with. */
+    readonly status: number;
+    readonly transport: ActionRefusalTransport;
+    /**
+     * From ACTION_ERROR_MCP for the registry's refusals and an invalid body. For
+     * a domain refusal, the verdict the action declared for that reason in its
+     * `errors`, or "never" for a reason it did not declare.
+     */
+    readonly retry: ActionRetry;
+    /**
+     * The particulars the refusal publishes, keyed by the field they travel in.
+     *
+     * `scopes` on an insufficient-scope refusal names the scope the call needed.
+     * `issues` on an invalid body lists `{ path, message }` for each failing
+     * field, and never the submitted value.
+     */
+    details(): Record<string, readonly unknown[]>;
+    /**
+     * The bearer challenge to answer a connected app with, as the value of a
+     * `WWW-Authenticate` header (RFC 6750, ADR 0009).
+     *
+     * Set on an insufficient-scope refusal, where it names every scope the
+     * instance issues so the client can ask for what it is missing in one round
+     * trip. Absent wherever no challenge would help.
+     */
+    readonly challenge?: string;
+}
+/**
+ * Whether a value `host.actions.invoke` rejected with is a refusal.
+ *
+ * Structural rather than `instanceof`, for the reason on ActionRefusal. False
+ * means the call failed rather than being refused - the host could not be
+ * reached, or something broke - and a connector answers that as an internal
+ * error without inspecting it.
+ */
+export declare function isActionRefusal(value: unknown): value is ActionRefusal;
+//# sourceMappingURL=action-refusal.d.ts.map

package/dist/action-refusal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-refusal.d.ts","sourceRoot":"","sources":["../src/action-refusal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,oBAAoB,YAC/B,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,UAAU,CACF,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,aAAa,CAAC;AAEhE;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CACrC,MAAM,CACJ,iBAAiB,GAAG,cAAc,GAAG,QAAQ,EAC7C;IACE,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B,CACF,CAcF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEvE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B;;;;;;OAMG;IACH,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC;IAC9C;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAkBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAyBtE"}

package/dist/action-refusal.js

@@ -0,0 +1,96 @@
+/**
+ * Why the registry refused a call, in a form a caller can act on.
+ *
+ * A caller here is often a model rather than a person, which changes what a
+ * refusal has to carry. A person reads a sentence and decides what to do; a
+ * model needs to know whether trying again could ever work, and what to change
+ * if it could. So every refusal has a code, a status, and a published rule for
+ * how a connector should render it.
+ *
+ * The vocabulary lives here rather than in the API because a plugin dispatching
+ * through `host.actions.invoke` has no other way to read it: the catalogue
+ * endpoint serves the same table over HTTP, and a plugin in the same process
+ * has no route to that. The API imports it back, so there is one list.
+ */
+export const ACTION_ERROR_REASONS = [
+    "unknown-action",
+    "forbidden-capability",
+    "forbidden-surface",
+    "insufficient-scope",
+    "not-serving",
+    "read-only",
+    "confirmation-required",
+    "output-invalid",
+    "rate-limited",
+    "internal",
+];
+/**
+ * How a connector should render each refusal, published as data.
+ *
+ * Served on the catalogue endpoint as well, so that two connectors - one
+ * reading it over HTTP, one in process - cannot disagree about whether a 403
+ * is worth retrying. Keyed by the registry's reasons and by the two refusals
+ * that are not the registry's own: a body the action's input schema refuses,
+ * and a refusal raised by the service behind the action.
+ */
+export const ACTION_ERROR_MCP = {
+    "unknown-action": { transport: "protocol", retry: "never" },
+    "invalid-body": { transport: "tool-result", retry: "after-edit" },
+    "forbidden-capability": { transport: "tool-result", retry: "never" },
+    "forbidden-surface": { transport: "tool-result", retry: "never" },
+    "insufficient-scope": { transport: "tool-result", retry: "never" },
+    "not-serving": { transport: "tool-result", retry: "never" },
+    "read-only": { transport: "tool-result", retry: "after-backoff" },
+    "confirmation-required": { transport: "tool-result", retry: "never" },
+    "output-invalid": { transport: "protocol", retry: "never" },
+    "rate-limited": { transport: "tool-result", retry: "after-backoff" },
+    internal: { transport: "protocol", retry: "after-backoff" },
+    domain: { transport: "tool-result", retry: "never" },
+};
+const KINDS = [
+    "registry",
+    "invalid-body",
+    "domain",
+];
+const TRANSPORTS = [
+    "protocol",
+    "tool-result",
+];
+const RETRIES = [
+    "never",
+    "after-edit",
+    "after-backoff",
+];
+const REGISTRY_REASONS = ACTION_ERROR_REASONS;
+/**
+ * Whether a value `host.actions.invoke` rejected with is a refusal.
+ *
+ * Structural rather than `instanceof`, for the reason on ActionRefusal. False
+ * means the call failed rather than being refused - the host could not be
+ * reached, or something broke - and a connector answers that as an internal
+ * error without inspecting it.
+ */
+export function isActionRefusal(value) {
+    if (!(value instanceof Error) || value.name !== "ActionRefusal") {
+        return false;
+    }
+    const refusal = value;
+    if (typeof refusal.reason !== "string" ||
+        typeof refusal.status !== "number" ||
+        typeof refusal.details !== "function" ||
+        !KINDS.includes(refusal.kind) ||
+        !TRANSPORTS.includes(refusal.transport) ||
+        !RETRIES.includes(refusal.retry) ||
+        (refusal.challenge !== undefined && typeof refusal.challenge !== "string")) {
+        return false;
+    }
+    switch (refusal.kind) {
+        case "registry":
+            return REGISTRY_REASONS.includes(refusal.reason);
+        case "invalid-body":
+            return refusal.reason === "invalid-body";
+        default:
+            return true;
+    }
+}
+//# sourceMappingURL=action-refusal.js.map

package/dist/action-refusal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-refusal.js","sourceRoot":"","sources":["../src/action-refusal.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,gBAAgB;IAChB,sBAAsB;IACtB,mBAAmB;IACnB,oBAAoB;IACpB,aAAa;IACb,WAAW;IACX,uBAAuB;IACvB,gBAAgB;IAChB,cAAc;IACd,UAAU;CACF,CAAC;AAaX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAQzB;IACF,gBAAgB,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE;IAC3D,cAAc,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE;IACjE,sBAAsB,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE;IACpE,mBAAmB,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE;IACjE,oBAAoB,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE;IAClE,aAAa,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE;IAC3D,WAAW,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE;IACjE,uBAAuB,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE;IACrE,gBAAgB,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE;IAC3D,cAAc,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE;IACpE,QAAQ,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE;IAC3D,MAAM,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE;CACrD,CAAC;AAyDF,MAAM,KAAK,GAAuB;IAChC,UAAU;IACV,cAAc;IACd,QAAQ;CACqB,CAAC;AAChC,MAAM,UAAU,GAAuB;IACrC,UAAU;IACV,aAAa;CACqB,CAAC;AACrC,MAAM,OAAO,GAAuB;IAClC,OAAO;IACP,YAAY;IACZ,eAAe;CACQ,CAAC;AAC1B,MAAM,gBAAgB,GAAuB,oBAAoB,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,KAC+B,CAAC;IAChD,IACE,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;QAClC,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;QAClC,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;QACrC,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;QAC7B,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;QACvC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;QAChC,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,EAC1E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnD,KAAK,cAAc;YACjB,OAAO,OAAO,CAAC,MAAM,KAAK,cAAc,CAAC;QAC3C;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/action-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-schema.d.ts","sourceRoot":"","sources":["../src/action-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,OAAO,CAOpE;AAyBD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAC1C,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAC1C,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB"}
+{"version":3,"file":"action-schema.d.ts","sourceRoot":"","sources":["../src/action-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,OAAO,CAOpE;AA4BD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAC1C,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAC1C,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB"}

package/dist/action-schema.js

@@ -45,7 +45,7 @@ function convert(schema, actionName, io) {
     if (!isHostZodSchema(schema)) {
         throw new Error(`${actionName}: an action schema must be built with the host's zod.`);
     }
-    return z.toJSONSchema(schema, {
+    const document = z.toJSONSchema(schema, {
         target: "draft-2020-12",
         io,
         cycles: "throw",
@@ -54,6 +54,9 @@ function convert(schema, actionName, io) {
             throw new Error(`${actionName}: ${message} at ${[io, ...path.map(String)].join(".")}`);
         },
     });
+    // zod hangs a non-enumerable `~standard` on the root. A shallow copy leaves
+    // it behind, so what a caller is handed is a plain JSON document.
+    return { ...document };
 }
 export function actionInputJsonSchema(schema, actionName) {
     return convert(schema, actionName, "input");

package/dist/action-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"action-schema.js","sourceRoot":"","sources":["../src/action-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,MAAM,IAAI,MAAM;QACf,MAA6B,CAAC,IAAI,KAAK,SAAS,CAClD,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CACd,MAAe,EACf,UAAkB,EAClB,EAAsB;IAEtB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,uDAAuD,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE;QAC5B,MAAM,EAAE,eAAe;QACvB,EAAE;QACF,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,QAAQ;QAChB,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;YACrC,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,KAAK,OAAO,OAAO,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACtE,CAAC;QACJ,CAAC;KACF,CAA4B,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAA0C,EAC1C,UAAkB;IAElB,OAAO,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAA0C,EAC1C,UAAkB;IAElB,OAAO,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"action-schema.js","sourceRoot":"","sources":["../src/action-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,MAAM,IAAI,MAAM;QACf,MAA6B,CAAC,IAAI,KAAK,SAAS,CAClD,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CACd,MAAe,EACf,UAAkB,EAClB,EAAsB;IAEtB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,uDAAuD,CACrE,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE;QACtC,MAAM,EAAE,eAAe;QACvB,EAAE;QACF,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,QAAQ;QAChB,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;YACrC,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,KAAK,OAAO,OAAO,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACtE,CAAC;QACJ,CAAC;KACF,CAA4B,CAAC;IAC9B,4EAA4E;IAC5E,kEAAkE;IAClE,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAA0C,EAC1C,UAAkB;IAElB,OAAO,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAA0C,EAC1C,UAAkB;IAElB,OAAO,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC"}

package/dist/actions.d.ts

@@ -46,21 +46,28 @@ export type ActionPersonalData = (typeof ACTION_PERSONAL_DATA)[number];
  * directory review (64 characters).
  */
 export declare const ACTION_NAME_PATTERN: RegExp;
+/** Whether trying again could ever work, and after what. */
+export type ActionRetry = "never" | "after-edit" | "after-backoff";
 /** What a refusal means for a caller that is a model rather than a person. */
 export interface ActionErrorSpec {
     /** The machine-readable reason the handler raises. */
     readonly reason: string;
     /** Whether trying again could ever work, and after what. */
-    readonly retry: "never" | "after-edit" | "after-backoff";
+    readonly retry: ActionRetry;
     /** The sentence a person is shown, as an i18n key. */
     readonly messageKey: string;
 }
 /**
  * The request a plugin's own route received.
  *
- * Opaque on purpose: the host reads a symbol on it that only the host writes,
- * so a plugin passes the request it was handed straight through and cannot
- * construct one. That is what stops a plugin naming a person it was not given.
+ * Opaque on purpose: the host recognises the request it authenticated by its
+ * identity, which nothing on it can copy, so a plugin passes the request it was
+ * handed straight through and cannot construct one. That is what stops a plugin
+ * naming a person it was not given.
+ *
+ * It speaks for its person only while the route is serving it. Once the
+ * response is sent the host refuses it, so a request kept for later names
+ * nobody.
  */
 export type ActionRequest = object;
 /** The lowercase channel vocabulary. The registry maps it to the audit channel. */
@@ -88,6 +95,19 @@ export interface ActionContext {
     readonly principal: ActionPrincipal;
     readonly channel: ActionChannel;
     readonly client?: ActionClient;
+    /**
+     * The plugin whose route dispatched the call, when one did, by its manifest
+     * id. Set by the host from the plugin it serves, whatever the channel.
+     */
+    readonly pluginId?: string;
+    /**
+     * The pending change this call confirms, when it confirms one.
+     *
+     * A confirmed call is the confirming person's own, on `web`; this is what
+     * ties its audit entry back to the proposal, and to the channel and the app
+     * the proposal came through.
+     */
+    readonly pendingChangeId?: string;
     readonly requestId: string;
     readonly now: Date;
 }
@@ -172,6 +192,33 @@ export interface ActionSummary {
     readonly surfaces: readonly ActionSurface[];
     readonly errors: readonly ActionErrorSpec[];
 }
+/**
+ * What proposing a change answers with.
+ *
+ * Nothing has run. The change waits, for a week at most, until the person whose
+ * request proposed it confirms or rejects it on the platform's own screen at
+ * `path`, which a plugin's view links to. A plugin cannot confirm one.
+ */
+export interface PendingChangeReceipt {
+    readonly id: string;
+    readonly expiresAt: Date;
+    /** The preview, on the platform's own screen, relative to the origin. */
+    readonly path: string;
+}
+/**
+ * One action as a plugin is offered it: the summary, and the JSON Schema
+ * (draft 2020-12) of what it takes and what it returns.
+ *
+ * What an MCP connector puts in `tools/list` and what a model is told a tool
+ * accepts. The input schema is the one `invoke` validates against, converted
+ * as the HTTP catalogue converts it, so a tool is described by the rule it is
+ * held to. Each listing builds both afresh: changing one changes nothing the
+ * host holds or hands anybody else.
+ */
+export interface ActionWithSchemas extends ActionSummary {
+    readonly inputSchema: Record<string, unknown>;
+    readonly outputSchema: Record<string, unknown>;
+}
 export interface PluginActions {
     /**
      * Registers an action the manifest declared.
@@ -188,12 +235,53 @@ export interface PluginActions {
      * its own manifest in its own build.
      */
     register: (registration: PluginActionRegistration) => void;
-    /** What this plugin's route may offer the request it is serving. */
-    list: (request: ActionRequest, filter?: PluginActionFilter) => Promise<ActionSummary[]>;
+    /**
+     * What this plugin's route may offer the request it is serving, each with
+     * its schemas.
+     *
+     * Filtered by channel, surface, capability, liveness and arming, as `invoke`
+     * is, and the schemas are of the actions listed and no others. Token scope
+     * (`mcp:read`, `mcp:write`) and read-only mode are decided at `invoke`, which
+     * may still refuse a listed action.
+     */
+    list: (request: ActionRequest, filter?: PluginActionFilter) => Promise<ActionWithSchemas[]>;
     /**
      * Dispatch. The person, the channel and the connected app all come from the
      * request the host authenticated, never from an argument.
+     *
+     * A refused call rejects with an `ActionRefusal`, whichever of the three
+     * ways it was refused - by the registry, over its input or by the service
+     * behind it - and `isActionRefusal` recognises one. Anything else it
+     * rejects with is a fault rather than an answer.
      */
     invoke: <Output>(request: ActionRequest, name: string, input: unknown) => Promise<Output>;
+    /**
+     * Holds a write as a pending change instead of running it (ADR 0039).
+     *
+     * The call is checked as `invoke` would check it before running anything -
+     * the action exists and is offered, the person holds its capability, the
+     * input fits its schema - and refused the same way. A read cannot be
+     * proposed, and nor can an action the platform's own screens are not offered.
+     * The person whose request this is then sees the change as a preview and
+     * confirms it, and it runs as them at that moment, with every check made
+     * again; or rejects it, and nothing runs.
+     *
+     * Added after `invoke`, so a plugin installed on an older host has to check
+     * that it is there before calling it, for the reason `host.actions` gives.
+     */
+    propose: (request: ActionRequest, name: string, input: unknown) => Promise<PendingChangeReceipt>;
+    /**
+     * The connected app the request was authenticated with, or null when it
+     * arrived on a signed-in session.
+     *
+     * The app a dispatch on this request is recorded as, read from what the host
+     * established when it authenticated the request rather than from the
+     * request's own properties, which the plugin can write. A connector asks it
+     * before answering on a route that serves connected apps only.
+     *
+     * Added after `list` and `invoke`, so a plugin must feature-detect it
+     * (`host.actions?.client === undefined`) before calling it.
+     */
+    client: (request: ActionRequest) => ActionClient | null;
 }
 //# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

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

package/dist/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAGnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAU,CAAC;AAG5D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM;IACN,WAAW;IACX,WAAW;IACX,OAAO;IACP,OAAO;IACP,eAAe;IACf,wBAAwB;IACxB,SAAS;IACT,WAAW;IACX,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,WAAW;CACH,CAAC;AAGX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AAqB5D,mFAAmF;AACnF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK;IACL,KAAK;IACL,IAAI;IACJ,QAAQ;IACR,QAAQ;CACA,CAAC"}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAGnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAU,CAAC;AAG5D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM;IACN,WAAW;IACX,WAAW;IACX,OAAO;IACP,OAAO;IACP,eAAe;IACf,wBAAwB;IACxB,SAAS;IACT,WAAW;IACX,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,WAAW;CACH,CAAC;AAGX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AA6B5D,mFAAmF;AACnF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK;IACL,KAAK;IACL,IAAI;IACJ,QAAQ;IACR,QAAQ;CACA,CAAC"}