@vonzio/plugin-api 0.1.0 → 0.2.0

package/index.d.ts

@@ -5,9 +5,10 @@ import type { FastifyInstance } from "fastify";
  * plugins whose major differs or whose minor is ahead of core's (see
  * `assertApiCompatible`). Bumped to 1.0.0 with the external-loader contract
  * (docs/PLUGIN_LOADER_SPEC.md) — the loader surface is now a stability
- * commitment.
+ * commitment. 1.1.0 added `scope`/`profile_ids` to PluginIntegration
+ * (additive; plugins targeting 1.0 are unaffected).
  */
-export declare const PLUGIN_API_VERSION = "1.0.0";
+export declare const PLUGIN_API_VERSION = "1.1.0";
 /**
  * The shape every plugin's default export must satisfy. Generic over
  * the plugin's own config type so init() receives a fully-typed config.
@@ -195,6 +196,19 @@ export interface PluginIntegration {
     type: string;
     config: Record<string, unknown>;
     enabled: boolean;
+    /**
+     * Visibility scope for agent-facing surfaces (MCP injection, etc.):
+     *  - `"all"`: available to every agent profile the user owns.
+     *  - `"agents"`: restricted to the profiles listed in `profile_ids`.
+     * A plugin gating per-profile (e.g. only surface a bank to the agent the
+     * user scoped it to) filters with:
+     *   `scope === "all" || profile_ids.includes(profileId)`.
+     * Added in plugin-api 1.1.0.
+     */
+    scope: "all" | "agents";
+    /** Profile ids this integration is restricted to when `scope === "agents"`
+     *  (empty otherwise). Added in plugin-api 1.1.0. */
+    profile_ids: string[];
     /**
      * Last-modified timestamp (ISO-8601). Plugins use this for
      * optimistic-locking writes -- see `update({...}, { expectUpdatedAt })`.

package/index.js

@@ -13,9 +13,10 @@
  * plugins whose major differs or whose minor is ahead of core's (see
  * `assertApiCompatible`). Bumped to 1.0.0 with the external-loader contract
  * (docs/PLUGIN_LOADER_SPEC.md) — the loader surface is now a stability
- * commitment.
+ * commitment. 1.1.0 added `scope`/`profile_ids` to PluginIntegration
+ * (additive; plugins targeting 1.0 are unaffected).
  */
-export const PLUGIN_API_VERSION = "1.0.0";
+export const PLUGIN_API_VERSION = "1.1.0";
 export { PLUGIN_CAPABILITIES, CAPABILITY_SURFACE_MAP, ROOT_EQUIVALENT_COMBINATIONS, BUILTIN_ONLY_CAPABILITIES, isPluginCapability, } from "./capabilities.js";
 export { MANIFEST_ALLOWED_KEYS, POLICY_ENTRY_ALLOWED_KEYS, SCHEMA_PREFIX_PATTERN, MTLS_SECRET_NAME_PATTERN, } from "./manifest.js";
 export { validateManifest, validatePolicy, matchOutboundHost, normalizeHostPattern, } from "./manifest-validate.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vonzio/plugin-api",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "Plugin contract for vonzio. Defines the types + helpers a plugin author implements; defines what core-server's loader and bus implement. Stable surface: breaking changes require a major bump.",
   "license": "AGPL-3.0-or-later",