@vibecontrols/plugin-sdk 2026.509.1 → 2026.509.2

package/dist/contract/index.d.ts

@@ -38,10 +38,32 @@ interface StorageProvider {
     delete(namespace: string, key: string): Promise<boolean>;
     list?(namespace: string): Promise<string[]>;
 }
+/**
+ * Minimal façade over the agent's ServiceRegistry. Mirrors the agent's
+ * actual signatures (vibecontrols-agent/src/core/service-registry.ts):
+ *
+ *   - `registerProvider(type, provider, pluginName)` — register a
+ *     provider implementation under a provider type ("session", "tunnel",
+ *     "ai"). The agent multiplexes providers per type and resolves a
+ *     default via `getProvider<T>(type)`.
+ *   - `getProvider<T>(type)` — return the default-resolved provider for
+ *     the given type.
+ *   - `registerService(pluginName, serviceName, service)` /
+ *     `getService(pluginName, serviceName)` — namespaced bag for plugin-
+ *     to-plugin services that aren't provider implementations.
+ *
+ * Every member is optional so SDK consumers tolerate partial or alt
+ * hosts. The SDK's `ProviderRegistry` wrapper picks the right method.
+ */
 interface ServiceRegistry {
-    registerService<T>(type: string, name: string, instance: T): void;
-    getService<T>(type: string, name: string): T | undefined;
-    listProvidersForType?(type: string): string[];
+    registerProvider?(type: string, provider: unknown, pluginName: string): void;
+    getProvider?<T>(type: string): T | undefined;
+    registerService?(pluginName: string, serviceName: string, service: unknown): void;
+    getService?<T>(pluginName: string, serviceName: string): T | undefined;
+    listProvidersForType?(type: string): string[] | Array<{
+        pluginName: string;
+        isDefault: boolean;
+    }>;
 }
 interface SdkLogger {
     debug?(source: string, message: string, metadata?: Record<string, unknown>): void;

package/dist/index.js

@@ -537,15 +537,40 @@ var ProviderRegistry = class {
   getServiceRegistry() {
     return this.hostServices?.serviceRegistry;
   }
+  /**
+   * Register a provider implementation (session / tunnel / ai) on the
+   * agent's per-type provider registry. Maps onto the agent's
+   * `registerProvider(type, provider, pluginName)` shape.
+   */
   registerProvider(type, name, provider) {
-    this.hostServices?.serviceRegistry?.registerService(type, name, provider);
+    this.hostServices?.serviceRegistry?.registerProvider?.(type, provider, name);
   }
+  /**
+   * Resolve a provider for a given type. With one argument, returns the
+   * default-resolved provider (matching the agent's
+   * `serviceRegistry.getProvider<T>(type)` shape). With two arguments,
+   * resolves a *specific* provider by name — the agent's registry only
+   * exposes a default-resolved getter, so we list per-type entries and
+   * verify the name is present. The two-argument form preserves the
+   * original SDK signature so consumer plugins (e.g. session-manager)
+   * keep compiling.
+   */
   getProvider(type, name) {
-    return this.hostServices?.serviceRegistry?.getService(type, name);
+    const reg = this.hostServices?.serviceRegistry;
+    if (!reg) return void 0;
+    if (name === void 0) return reg.getProvider?.(type);
+    if (!reg.listProvidersForType) return void 0;
+    const entries = reg.listProvidersForType(type) ?? [];
+    const present = entries.some(
+      (entry) => typeof entry === "string" ? entry === name : entry.pluginName === name
+    );
+    if (!present) return void 0;
+    return reg.getProvider?.(type);
   }
   listProviders(type) {
     const reg = this.hostServices?.serviceRegistry;
-    return reg?.listProvidersForType?.(type) ?? [];
+    const entries = reg?.listProvidersForType?.(type) ?? [];
+    return entries.map((entry) => typeof entry === "string" ? entry : entry.pluginName);
   }
   /**
    * Register a CLI contribution bundle (status sections + doctor checks).

package/dist/providers/index.d.ts

@@ -16,8 +16,23 @@ declare class ProviderRegistry {
     private readonly hostServices?;
     constructor(hostServices?: HostServices | undefined);
     getServiceRegistry(): ServiceRegistry | undefined;
+    /**
+     * Register a provider implementation (session / tunnel / ai) on the
+     * agent's per-type provider registry. Maps onto the agent's
+     * `registerProvider(type, provider, pluginName)` shape.
+     */
     registerProvider<T>(type: string, name: string, provider: T): void;
-    getProvider<T>(type: string, name: string): T | undefined;
+    /**
+     * Resolve a provider for a given type. With one argument, returns the
+     * default-resolved provider (matching the agent's
+     * `serviceRegistry.getProvider<T>(type)` shape). With two arguments,
+     * resolves a *specific* provider by name — the agent's registry only
+     * exposes a default-resolved getter, so we list per-type entries and
+     * verify the name is present. The two-argument form preserves the
+     * original SDK signature so consumer plugins (e.g. session-manager)
+     * keep compiling.
+     */
+    getProvider<T>(type: string, name?: string): T | undefined;
     listProviders(type: string): string[];
     /**
      * Register a CLI contribution bundle (status sections + doctor checks).

package/dist/providers/index.js

@@ -7,15 +7,40 @@ var ProviderRegistry = class {
   getServiceRegistry() {
     return this.hostServices?.serviceRegistry;
   }
+  /**
+   * Register a provider implementation (session / tunnel / ai) on the
+   * agent's per-type provider registry. Maps onto the agent's
+   * `registerProvider(type, provider, pluginName)` shape.
+   */
   registerProvider(type, name, provider) {
-    this.hostServices?.serviceRegistry?.registerService(type, name, provider);
+    this.hostServices?.serviceRegistry?.registerProvider?.(type, provider, name);
   }
+  /**
+   * Resolve a provider for a given type. With one argument, returns the
+   * default-resolved provider (matching the agent's
+   * `serviceRegistry.getProvider<T>(type)` shape). With two arguments,
+   * resolves a *specific* provider by name — the agent's registry only
+   * exposes a default-resolved getter, so we list per-type entries and
+   * verify the name is present. The two-argument form preserves the
+   * original SDK signature so consumer plugins (e.g. session-manager)
+   * keep compiling.
+   */
   getProvider(type, name) {
-    return this.hostServices?.serviceRegistry?.getService(type, name);
+    const reg = this.hostServices?.serviceRegistry;
+    if (!reg) return void 0;
+    if (name === void 0) return reg.getProvider?.(type);
+    if (!reg.listProvidersForType) return void 0;
+    const entries = reg.listProvidersForType(type) ?? [];
+    const present = entries.some(
+      (entry) => typeof entry === "string" ? entry === name : entry.pluginName === name
+    );
+    if (!present) return void 0;
+    return reg.getProvider?.(type);
   }
   listProviders(type) {
     const reg = this.hostServices?.serviceRegistry;
-    return reg?.listProvidersForType?.(type) ?? [];
+    const entries = reg?.listProvidersForType?.(type) ?? [];
+    return entries.map((entry) => typeof entry === "string" ? entry : entry.pluginName);
   }
   /**
    * Register a CLI contribution bundle (status sections + doctor checks).

package/dist/testing/index.js

@@ -9,6 +9,8 @@ function createMockHostServices(overrides = {}) {
     list: mock(async () => [])
   };
   const serviceRegistry = {
+    registerProvider: mock(() => void 0),
+    getProvider: mock(() => void 0),
     registerService: mock(() => void 0),
     getService: mock(() => void 0),
     listProvidersForType: mock(() => [])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecontrols/plugin-sdk",
-  "version": "2026.509.1",
+  "version": "2026.509.2",
   "type": "module",
   "description": "VibeControls Plugin SDK — shared contract, lifecycle, CLI, telemetry, storage helpers for all vibe-plugin-* packages.",
   "engines": {