@cleocode/adapters 2026.4.139 → 2026.4.141

package/dist/providers/claude-sdk/adapter.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Claude SDK provider adapter.
+ *
+ * Wraps {@link ClaudeSDKSpawnProvider} in the standard
+ * {@link CLEOProviderAdapter} contract so registry and sovereignty probes can
+ * treat the SDK-backed Claude provider like every other CLEO provider.
+ *
+ * @task T933
+ * @packageDocumentation
+ */
+import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
+import { ClaudeSDKInstallProvider } from './install.js';
+import { ClaudeSDKSpawnProvider } from './spawn.js';
+/**
+ * CLEO provider adapter for Anthropic Claude via the Vercel AI SDK.
+ *
+ * @remarks
+ * This adapter intentionally exposes spawn only. Hooks, instruction files, and
+ * provider-native paths belong to CLI providers such as `claude-code`; the SDK
+ * provider is the programmatic LLM bridge used when `provider.claude.mode` is
+ * configured as `sdk`.
+ */
+export declare class ClaudeSDKAdapter implements CLEOProviderAdapter {
+    /** Unique provider identifier. */
+    readonly id = "claude-sdk";
+    /** Human-readable provider name. */
+    readonly name = "Claude SDK (Vercel AI SDK)";
+    /** Adapter version string. */
+    readonly version = "2.0.0";
+    /** Declared capabilities for this provider. */
+    capabilities: AdapterCapabilities;
+    /** Spawn provider for SDK-backed Claude runs. */
+    spawn: ClaudeSDKSpawnProvider;
+    /** No-op install provider required by the adapter contract. */
+    install: ClaudeSDKInstallProvider;
+    private projectDir;
+    private initialized;
+    constructor();
+    /**
+     * Initialize the adapter for a project directory.
+     *
+     * @param projectDir - Root directory of the project using this adapter.
+     */
+    initialize(projectDir: string): Promise<void>;
+    /**
+     * Dispose the adapter and clear tracked project state.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Check whether SDK-backed spawning can run in the current environment.
+     *
+     * @returns Adapter health with credential availability and initialization
+     *   state.
+     */
+    healthCheck(): Promise<AdapterHealthStatus>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/claude-sdk/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-sdk/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,kCAAkC;IAClC,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,gCAAgC;IAC7C,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CAW/B;IAEF,iDAAiD;IACjD,KAAK,EAAE,sBAAsB,CAAC;IAC9B,+DAA+D;IAC/D,OAAO,EAAE,wBAAwB,CAAC;IAElC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;OAIG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAalD"}

package/dist/providers/claude-sdk/index.d.ts

@@ -15,10 +15,20 @@
  * @task T933 (SDK consolidation — Vercel AI SDK migration)
  * @see ADR-052 — SDK consolidation decision
  */
+import { ClaudeSDKAdapter } from './adapter.js';
+export { ClaudeSDKAdapter } from './adapter.js';
+export { ClaudeSDKInstallProvider } from './install.js';
 export type { McpServerMap, McpStdioConfig } from './mcp-registry.js';
 export { getServers } from './mcp-registry.js';
 export type { SessionEntry } from './session-store.js';
 export { SessionStore } from './session-store.js';
 export { ClaudeSDKSpawnProvider } from './spawn.js';
 export { DEFAULT_TOOLS, resolveTools } from './tool-bridge.js';
+export default ClaudeSDKAdapter;
+/**
+ * Create a Claude SDK adapter instance for dynamic adapter loading.
+ *
+ * @returns A fresh {@link ClaudeSDKAdapter}.
+ */
+export declare function createAdapter(): ClaudeSDKAdapter;
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/claude-sdk/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE/D,eAAe,gBAAgB,CAAC;AAEhC;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD"}

package/dist/providers/claude-sdk/install.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Claude SDK install provider.
+ *
+ * The Claude SDK adapter is a programmatic LLM bridge, not a native CLI
+ * integration surface. CLEO installation is therefore a no-op: project
+ * instruction files are managed by the active CLI provider (for example
+ * `claude-code`) while this provider supplies SDK-backed spawning.
+ *
+ * @task T933
+ * @packageDocumentation
+ */
+import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+/**
+ * No-op install provider for the SDK-backed Claude provider.
+ *
+ * @remarks
+ * `CLEOProviderAdapter` requires an install provider. This implementation
+ * preserves that contract without pretending the Anthropic SDK has a native
+ * instruction-file or hook installation target.
+ */
+export declare class ClaudeSDKInstallProvider implements AdapterInstallProvider {
+    /**
+     * Report a successful no-op installation.
+     *
+     * @param options - Installation options. Currently accepted for contract
+     *   parity and not mutated.
+     * @returns A successful install result with `instructionFileUpdated=false`.
+     */
+    install(options: InstallOptions): Promise<InstallResult>;
+    /**
+     * No-op uninstall for the SDK provider.
+     */
+    uninstall(): Promise<void>;
+    /**
+     * Return true because the SDK provider requires no filesystem installation.
+     *
+     * @returns Always `true`.
+     */
+    isInstalled(): Promise<boolean>;
+    /**
+     * No-op instruction-file reference hook.
+     *
+     * @param projectDir - Project directory accepted for interface parity.
+     */
+    ensureInstructionReferences(projectDir: string): Promise<void>;
+}
+//# sourceMappingURL=install.d.ts.map

package/dist/providers/claude-sdk/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-sdk/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEjG;;;;;;;GAOG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAa9D;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;;;OAIG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/adapters",
-  "version": "2026.4.139",
+  "version": "2026.4.141",
   "description": "Unified provider adapters for CLEO (Claude Code, OpenCode, Cursor)",
   "type": "module",
   "main": "dist/index.js",
@@ -15,8 +15,8 @@
     "@ai-sdk/anthropic": "^3.0.69",
     "@ai-sdk/openai": "^2.0.53",
     "ai": "^6.0.168",
-    "@cleocode/caamp": "2026.4.139",
-    "@cleocode/contracts": "2026.4.139"
+    "@cleocode/caamp": "2026.4.141",
+    "@cleocode/contracts": "2026.4.141"
   },
   "license": "MIT",
   "engines": {
@@ -29,7 +29,7 @@
   "devDependencies": {
     "@types/node": "^22.19.15",
     "vitest": "^4.1.4",
-    "@cleocode/playbooks": "2026.4.139"
+    "@cleocode/playbooks": "2026.4.141"
   },
   "repository": {
     "type": "git",

package/src/index.ts

@@ -47,7 +47,10 @@ export {
 } from './providers/claude-code/index.js';
 export type { McpServerMap, McpStdioConfig, SessionEntry } from './providers/claude-sdk/index.js';
 export {
+  ClaudeSDKAdapter,
+  ClaudeSDKInstallProvider,
   ClaudeSDKSpawnProvider,
+  createAdapter as createClaudeSDKAdapter,
   DEFAULT_TOOLS,
   getServers,
   resolveTools,

package/src/providers/claude-sdk/__tests__/spawn.test.ts

@@ -267,6 +267,19 @@ describe('ClaudeSDKSpawnProvider', () => {
   });
 });
 
+describe('ClaudeSDKAdapter', () => {
+  it('exports a default CLEOProviderAdapter-compatible class', async () => {
+    const mod = await import('../index.js');
+    const adapter = new mod.default();
+
+    expect(adapter.id).toBe('claude-sdk');
+    expect(adapter.name).toBe('Claude SDK (Vercel AI SDK)');
+    expect(adapter.version).toBe('2.0.0');
+    expect(adapter.capabilities.supportsSpawn).toBe(true);
+    expect(adapter.spawn).toBeInstanceOf(mod.ClaudeSDKSpawnProvider);
+  });
+});
+
 // ---------------------------------------------------------------------------
 // SessionStore unit tests
 // ---------------------------------------------------------------------------

package/src/providers/claude-sdk/adapter.ts

@@ -0,0 +1,101 @@
+/**
+ * Claude SDK provider adapter.
+ *
+ * Wraps {@link ClaudeSDKSpawnProvider} in the standard
+ * {@link CLEOProviderAdapter} contract so registry and sovereignty probes can
+ * treat the SDK-backed Claude provider like every other CLEO provider.
+ *
+ * @task T933
+ * @packageDocumentation
+ */
+
+import type {
+  AdapterCapabilities,
+  AdapterHealthStatus,
+  CLEOProviderAdapter,
+} from '@cleocode/contracts';
+import { ClaudeSDKInstallProvider } from './install.js';
+import { ClaudeSDKSpawnProvider } from './spawn.js';
+
+/**
+ * CLEO provider adapter for Anthropic Claude via the Vercel AI SDK.
+ *
+ * @remarks
+ * This adapter intentionally exposes spawn only. Hooks, instruction files, and
+ * provider-native paths belong to CLI providers such as `claude-code`; the SDK
+ * provider is the programmatic LLM bridge used when `provider.claude.mode` is
+ * configured as `sdk`.
+ */
+export class ClaudeSDKAdapter implements CLEOProviderAdapter {
+  /** Unique provider identifier. */
+  readonly id = 'claude-sdk';
+  /** Human-readable provider name. */
+  readonly name = 'Claude SDK (Vercel AI SDK)';
+  /** Adapter version string. */
+  readonly version = '2.0.0';
+
+  /** Declared capabilities for this provider. */
+  capabilities: AdapterCapabilities = {
+    supportsHooks: false,
+    supportedHookEvents: [],
+    supportsSpawn: true,
+    supportsInstall: false,
+    supportsInstructionFiles: false,
+    supportsContextMonitor: false,
+    supportsStatusline: false,
+    supportsProviderPaths: false,
+    supportsTransport: false,
+    supportsTaskSync: false,
+  };
+
+  /** Spawn provider for SDK-backed Claude runs. */
+  spawn: ClaudeSDKSpawnProvider;
+  /** No-op install provider required by the adapter contract. */
+  install: ClaudeSDKInstallProvider;
+
+  private projectDir: string | null = null;
+  private initialized = false;
+
+  constructor() {
+    this.spawn = new ClaudeSDKSpawnProvider();
+    this.install = new ClaudeSDKInstallProvider();
+  }
+
+  /**
+   * Initialize the adapter for a project directory.
+   *
+   * @param projectDir - Root directory of the project using this adapter.
+   */
+  async initialize(projectDir: string): Promise<void> {
+    this.projectDir = projectDir;
+    this.initialized = true;
+  }
+
+  /**
+   * Dispose the adapter and clear tracked project state.
+   */
+  async dispose(): Promise<void> {
+    this.projectDir = null;
+    this.initialized = false;
+  }
+
+  /**
+   * Check whether SDK-backed spawning can run in the current environment.
+   *
+   * @returns Adapter health with credential availability and initialization
+   *   state.
+   */
+  async healthCheck(): Promise<AdapterHealthStatus> {
+    const credentialsAvailable = await this.spawn.canSpawn();
+    return {
+      healthy: this.initialized && credentialsAvailable,
+      provider: this.id,
+      details: {
+        initialized: this.initialized,
+        credentialsAvailable,
+        projectDir: this.projectDir,
+        sdkVersion: 'ai@6 + @ai-sdk/anthropic',
+      },
+    };
+  }
+}

package/src/providers/claude-sdk/index.ts

@@ -16,9 +16,24 @@
  * @see ADR-052 — SDK consolidation decision
  */
 
+import { ClaudeSDKAdapter } from './adapter.js';
+
+export { ClaudeSDKAdapter } from './adapter.js';
+export { ClaudeSDKInstallProvider } from './install.js';
 export type { McpServerMap, McpStdioConfig } from './mcp-registry.js';
 export { getServers } from './mcp-registry.js';
 export type { SessionEntry } from './session-store.js';
 export { SessionStore } from './session-store.js';
 export { ClaudeSDKSpawnProvider } from './spawn.js';
 export { DEFAULT_TOOLS, resolveTools } from './tool-bridge.js';
+
+export default ClaudeSDKAdapter;
+
+/**
+ * Create a Claude SDK adapter instance for dynamic adapter loading.
+ *
+ * @returns A fresh {@link ClaudeSDKAdapter}.
+ */
+export function createAdapter(): ClaudeSDKAdapter {
+  return new ClaudeSDKAdapter();
+}

package/src/providers/claude-sdk/install.ts

@@ -0,0 +1,66 @@
+/**
+ * Claude SDK install provider.
+ *
+ * The Claude SDK adapter is a programmatic LLM bridge, not a native CLI
+ * integration surface. CLEO installation is therefore a no-op: project
+ * instruction files are managed by the active CLI provider (for example
+ * `claude-code`) while this provider supplies SDK-backed spawning.
+ *
+ * @task T933
+ * @packageDocumentation
+ */
+
+import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+
+/**
+ * No-op install provider for the SDK-backed Claude provider.
+ *
+ * @remarks
+ * `CLEOProviderAdapter` requires an install provider. This implementation
+ * preserves that contract without pretending the Anthropic SDK has a native
+ * instruction-file or hook installation target.
+ */
+export class ClaudeSDKInstallProvider implements AdapterInstallProvider {
+  /**
+   * Report a successful no-op installation.
+   *
+   * @param options - Installation options. Currently accepted for contract
+   *   parity and not mutated.
+   * @returns A successful install result with `instructionFileUpdated=false`.
+   */
+  async install(options: InstallOptions): Promise<InstallResult> {
+    return {
+      success: true,
+      installedAt: new Date().toISOString(),
+      instructionFileUpdated: false,
+      details: {
+        provider: 'claude-sdk',
+        projectDir: options.projectDir,
+        mode: 'programmatic-sdk',
+      },
+    };
+  }
+
+  /**
+   * No-op uninstall for the SDK provider.
+   */
+  async uninstall(): Promise<void> {}
+
+  /**
+   * Return true because the SDK provider requires no filesystem installation.
+   *
+   * @returns Always `true`.
+   */
+  async isInstalled(): Promise<boolean> {
+    return true;
+  }
+
+  /**
+   * No-op instruction-file reference hook.
+   *
+   * @param projectDir - Project directory accepted for interface parity.
+   */
+  async ensureInstructionReferences(projectDir: string): Promise<void> {
+    void projectDir;
+  }
+}