@cleocode/adapters 2026.4.92 → 2026.4.94

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

@@ -1,13 +1,19 @@
 /**
  * @packageDocumentation
  *
- * Claude Agent SDK spawn provider for CLEO.
- * Uses `@anthropic-ai/claude-agent-sdk` instead of the CLI for programmatic
- * subagent execution with structured output and session tracking.
+ * Claude SDK spawn provider for CLEO — Vercel AI SDK edition.
+ *
+ * Uses `@ai-sdk/anthropic` via the Vercel AI SDK (`ai` v6) instead of the
+ * legacy `@anthropic-ai/claude-agent-sdk`. CLEO retains its own orchestration
+ * primitives (composeSpawnPayload, playbook runtime, agent registry); this
+ * provider exposes the LLM bridge for programmatic subagent execution with
+ * structured output and session tracking.
  *
  * Enabled via `provider.claude.mode = 'sdk'` in CLEO config.
  *
- * @task T581
+ * @task T581 (original)
+ * @task T933 (SDK consolidation — Vercel AI SDK migration)
+ * @see ADR-052 — SDK consolidation decision
  */
 export type { McpServerMap, McpStdioConfig } from './mcp-registry.js';
 export { getServers } from './mcp-registry.js';

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;;;;;;;;;;GAUG;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,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"}

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

@@ -1,37 +1,42 @@
 /**
- * Claude SDK Spawn Provider
+ * Claude SDK Spawn Provider — Vercel AI SDK edition.
  *
- * Implements `AdapterSpawnProvider` using the `@anthropic-ai/claude-agent-sdk`
- * programmatic API instead of shelling out to the `claude` CLI.
+ * Implements {@link AdapterSpawnProvider} using the Vercel AI SDK
+ * (`ai` v6 + `@ai-sdk/anthropic`) instead of the legacy
+ * `@anthropic-ai/claude-agent-sdk`. CLEO retains its own orchestration
+ * primitives (`composeSpawnPayload`, playbook runtime, agent registry);
+ * the SDK is strictly the LLM bridge.
  *
  * Differences from `ClaudeCodeSpawnProvider`:
- * - Uses SDK `query()` instead of a detached child process
+ * - Uses `generateText()` via Vercel AI SDK instead of a detached child process
  * - Awaits full completion before returning (synchronous output capture)
- * - Session IDs from the SDK enable future multi-turn resumption
+ * - Session IDs are generated by CLEO and tracked in `SessionStore`
  * - No temp files, no OS PIDs — tracking is purely in-memory session IDs
  * - `canSpawn()` uses 3-tier key resolution (env var → stored key → Claude Code OAuth)
  *
  * CANT enrichment is identical to the CLI provider: `buildCantEnrichedPrompt()`
- * is called before `query()` and the result is passed as the SDK prompt string.
+ * is called before `generateText()` and the result is passed as the user prompt.
  *
- * @task T581
+ * @task T581 (original)
+ * @task T933 (SDK consolidation — Vercel AI SDK migration)
  * @see T752 — canSpawn() OAuth fix
+ * @see ADR-052 — SDK consolidation decision
  */
 import type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/contracts';
 /**
- * Spawn provider that uses the Anthropic Claude Agent SDK for programmatic
- * subagent execution.
+ * Spawn provider that uses the Vercel AI SDK (`ai` v6 + `@ai-sdk/anthropic`)
+ * for programmatic subagent execution.
  *
- * Each call to `spawn()` runs a full SDK `query()` to completion and
- * captures the output. Sessions are tracked in `SessionStore` so callers
- * can inspect active sessions via `listRunning()` and cancel them via
- * `terminate()`.
+ * Each call to `spawn()` runs a single `generateText()` call to completion and
+ * captures the output. Sessions are tracked in `SessionStore` so callers can
+ * inspect active sessions via `listRunning()` and remove them via `terminate()`.
  *
  * @remarks
- * The `permissionMode: 'bypassPermissions'` + `allowDangerouslySkipPermissions: true`
- * combination mirrors the `--dangerously-skip-permissions` flag used by
- * the CLI provider. Both are required by the SDK when bypassing all tool
- * permission prompts.
+ * Unlike the legacy `@anthropic-ai/claude-agent-sdk`, the Vercel AI SDK is
+ * strictly an LLM bridge — it does not manage a Claude Code subprocess or
+ * provide built-in MCP server wiring. Tool use is available through the SDK's
+ * tool system, but CLEO orchestration (composeSpawnPayload, playbooks, the
+ * agent registry) remains the source of truth for scaffolding.
  */
 export declare class ClaudeSDKSpawnProvider implements AdapterSpawnProvider {
     /** In-memory session registry. */
@@ -44,18 +49,14 @@ export declare class ClaudeSDKSpawnProvider implements AdapterSpawnProvider {
      * - `~/.local/share/cleo/anthropic-key` (user-stored via cleo config)
      * - Claude Code OAuth token (zero-config for Claude Code users)
      *
-     * No binary check is needed because the SDK manages the Claude Code
-     * subprocess internally.
-     *
      * @returns `true` when any Anthropic credential is available
      */
     canSpawn(): Promise<boolean>;
     /**
-     * Spawn a subagent using the Claude Agent SDK.
+     * Spawn a subagent using the Vercel AI SDK.
      *
-     * Enriches the prompt via CANT context, runs the SDK `query()` to
-     * completion, captures all assistant text output, and returns a
-     * `SpawnResult` with the final output and exit code.
+     * Enriches the prompt via CANT context, runs `generateText()` to completion,
+     * and returns a `SpawnResult` with the final output and exit code.
      *
      * @param context - Spawn context with taskId, prompt, options
      * @returns Resolved spawn result (status: 'completed' or 'failed')
@@ -73,10 +74,10 @@ export declare class ClaudeSDKSpawnProvider implements AdapterSpawnProvider {
     /**
      * Remove a session from tracking.
      *
-     * The underlying SDK query runs inside `spawn()` and cannot be cancelled
-     * externally once the async iterator is in flight. Removing the entry from
-     * the store prevents it from appearing in `listRunning()` but does not
-     * interrupt the in-progress HTTP request.
+     * The underlying `generateText()` call runs inside `spawn()` and cannot be
+     * cancelled externally once the HTTP request is in flight. Removing the
+     * entry from the store prevents it from appearing in `listRunning()` but
+     * does not interrupt the in-progress request.
      *
      * @param instanceId - ID of the spawn instance to terminate
      */

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

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-sdk/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAgE3F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sBAAuB,YAAW,oBAAoB;IACjE,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAE/C;;;;;;;;;;;;OAYG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA6IxD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAU3C;;;;;;;;;OASG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGnD"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-sdk/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA+D3F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sBAAuB,YAAW,oBAAoB;IACjE,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAE/C;;;;;;;;;OASG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC;;;;;;;;OAQG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAwGxD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAU3C;;;;;;;;;OASG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGnD"}

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

@@ -1,39 +1,40 @@
 /**
- * OpenAI Agents SDK Adapter.
+ * OpenAI SDK Adapter — Vercel AI SDK edition.
  *
- * Main `CLEOProviderAdapter` implementation for the OpenAI Agents SDK.
- * Provides spawn and install capabilities. Hooks are not supported (the
- * SDK does not expose a CLI hook system equivalent to Claude Code's).
+ * Main `CLEOProviderAdapter` implementation for the OpenAI provider, backed
+ * by the Vercel AI SDK (`ai` v6 + `@ai-sdk/openai`). Provides spawn and
+ * install capabilities. Hooks are not supported — the Vercel AI SDK does not
+ * expose a CLI hook system equivalent to Claude Code's.
  *
- * @task T582
+ * @task T582 (original)
+ * @task T933 (SDK consolidation — Vercel AI SDK migration)
+ * @see ADR-052 — SDK consolidation decision
  */
 import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
 import { OpenAiSdkInstallProvider } from './install.js';
 import { OpenAiSdkSpawnProvider } from './spawn.js';
 /**
- * CLEO provider adapter for the OpenAI Agents SDK.
+ * CLEO provider adapter for the OpenAI provider.
  *
- * Bridges CLEO's adapter system with the `@openai/agents` SDK:
- * - Spawn: Launches agents via the SDK runner with handoff topology
+ * Bridges CLEO's adapter system with the Vercel AI SDK:
+ * - Spawn: Launches agents via the SDK with CLEO-native handoff topology
  * - Install: Manages AGENTS.md @-references and .openai/ config directory
  * - Tracing: Default-on conduit span persistence via `CleoConduitTraceProcessor`
  *
  * @remarks
- * This adapter is the only CLEO provider with first-class handoff support.
- * Team Lead → Worker topology is declared in `SpawnContext.options.handoffs`
- * and wired directly to SDK `Agent.handoffs`. The SDK handles routing
- * internally without any CLEO glue code.
- *
- * This is also the only provider supporting 100+ LLMs via the Vercel AI SDK
- * bridge (capability flag: `supportsMultiModel`).
+ * Handoff topology is CLEO-owned (see `handoff.ts`): lead agents delegate to
+ * worker archetypes in sequence, and the concatenated output is returned.
+ * The Vercel AI SDK surface (`generateText` / `streamText`) works uniformly
+ * across Anthropic, OpenAI, and compatible providers, so the provider keeps
+ * the `supportsMultiModel` capability flag.
  */
 export declare class OpenAiSdkAdapter implements CLEOProviderAdapter {
     /** Unique provider identifier. */
     readonly id = "openai-sdk";
     /** Human-readable provider name. */
-    readonly name = "OpenAI Agents SDK";
+    readonly name = "OpenAI SDK (Vercel AI SDK)";
     /** Adapter version string. */
-    readonly version = "1.0.0";
+    readonly version = "2.0.0";
     /** Declared capabilities for this provider. */
     capabilities: AdapterCapabilities;
     /** Spawn provider for SDK-backed agent runs with handoff topology. */

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

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;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;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,kCAAkC;IAClC,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,uBAAuB;IACpC,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CAa/B;IAEF,sEAAsE;IACtE,KAAK,EAAE,sBAAsB,CAAC;IAC9B,+EAA+E;IAC/E,OAAO,EAAE,wBAAwB,CAAC;IAElC,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,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;;;;;;;;OAQG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAuBjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;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;;;;;;;;;;;;;;GAcG;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,CAa/B;IAEF,sEAAsE;IACtE,KAAK,EAAE,sBAAsB,CAAC;IAC9B,+EAA+E;IAC/E,OAAO,EAAE,wBAAwB,CAAC;IAElC,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,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;;;;;;;;OAQG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAuBjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/providers/openai-sdk/guardrails.d.ts

@@ -1,14 +1,56 @@
 /**
- * CLEO permission rules mapped to OpenAI Agents SDK guardrails.
+ * CLEO permission rules for the OpenAI SDK adapter.
  *
- * CLEO ACLs (file-glob path allowlists, tool allowlists) are expressed as
- * `InputGuardrail` instances that run before agent execution. A path that
- * falls outside the allowed glob list causes the guardrail to trip and
- * the agent run is rejected.
+ * Historically these rules were expressed as `InputGuardrail` instances from
+ * `@openai/agents`. Post T933 (ADR-052 — Vercel AI SDK consolidation) they
+ * are CLEO-native objects with the same shape so provider code that relies on
+ * their behaviour does not need to change. The Vercel AI SDK does not ship an
+ * equivalent guardrail abstraction — CLEO implements its own path ACL and
+ * tool allowlist enforcement here.
  *
- * @task T582
+ * A guardrail evaluates the serialised agent input before the request is sent
+ * to the model. A path that falls outside the allowed glob list causes the
+ * guardrail to trip and the run is rejected.
+ *
+ * @task T582 (original)
+ * @task T933 (SDK consolidation — provider-neutral rewrite)
+ */
+/** Arguments passed to a CLEO input guardrail. */
+export interface CleoInputGuardrailFunctionArgs {
+    /** The agent being invoked. Opaque to guardrails. */
+    agent: unknown;
+    /** Serialised input to scan — may be a string or arbitrary JSON value. */
+    input: unknown;
+    /** Per-run context (opaque). */
+    context: unknown;
+}
+/** Result of evaluating a CLEO input guardrail. */
+export interface CleoGuardrailResult {
+    /** When true, the guardrail has tripped and the run MUST be rejected. */
+    tripwireTriggered: boolean;
+    /** Free-form diagnostic payload for logging and trace spans. */
+    outputInfo: unknown;
+}
+/**
+ * CLEO-native replacement for `InputGuardrail` from `@openai/agents`.
+ *
+ * @remarks
+ * The shape is identical to the legacy SDK contract so downstream consumers
+ * do not require changes. CLEO enforces these guardrails in-process before
+ * dispatching a prompt to the Vercel AI SDK.
+ */
+export interface CleoInputGuardrail {
+    /** Stable guardrail identifier for logs and trace metadata. */
+    name: string;
+    /** Execute the guardrail against the current run arguments. */
+    execute(args: CleoInputGuardrailFunctionArgs): Promise<CleoGuardrailResult>;
+}
+/**
+ * @deprecated Use {@link CleoInputGuardrail}. Kept as a named alias for
+ *   callers that previously imported the legacy `InputGuardrail` name from
+ *   this module. Removed in a future major.
  */
-import type { InputGuardrail } from '@openai/agents';
+export type InputGuardrail = CleoInputGuardrail;
 /**
  * Check whether a file-system path is covered by at least one glob pattern.
  *
@@ -26,42 +68,53 @@ export declare function isPathAllowed(path: string, allowedGlobs: string[]): boo
  *
  * @param allowedGlobs - Glob patterns that tool path arguments must match.
  *   Pass an empty array to allow all paths (permissive mode).
- * @returns An {@link InputGuardrail} ready to attach to an `Agent`.
+ * @returns A {@link CleoInputGuardrail} ready to attach to an agent.
  *
  * @example
  * ```typescript
  * const guard = buildPathGuardrail(['/mnt/projects/**', '/tmp/**']);
- * const agent = new Agent({ ..., inputGuardrails: [guard] });
+ * const agent = buildStandaloneAgent('...', 'gpt-4.1', [guard]);
  * ```
  */
-export declare function buildPathGuardrail(allowedGlobs: string[]): InputGuardrail;
+export declare function buildPathGuardrail(allowedGlobs: string[]): CleoInputGuardrail;
 /**
  * Build an input guardrail that documents the tool allowlist for audit purposes.
  *
- * In the OpenAI Agents SDK, tool-name enforcement is primarily structural —
- * agents only receive the tools attached to their `tools` array. This guardrail
- * provides an additional audit layer that records the active allowlist in the
- * span metadata.
+ * Tool-name enforcement is primarily structural — agents only receive the
+ * tools declared by CLEO orchestration. This guardrail provides an additional
+ * audit layer that records the active allowlist in the span metadata.
  *
  * @param allowedTools - Exact tool names permitted for this agent.
  *   Pass an empty array to allow all tools (permissive mode).
- * @returns An {@link InputGuardrail} ready to attach to an `Agent`.
+ * @returns A {@link CleoInputGuardrail} ready to attach to an agent.
  *
  * @example
  * ```typescript
  * const guard = buildToolAllowlistGuardrail(['read', 'write']);
  * ```
  */
-export declare function buildToolAllowlistGuardrail(allowedTools: string[]): InputGuardrail;
+export declare function buildToolAllowlistGuardrail(allowedTools: string[]): CleoInputGuardrail;
 /**
  * Build the default CLEO guardrail set from spawn options.
  *
  * Combines path ACL and tool allowlist guards into a single array ready to
- * pass as `inputGuardrails` on an `Agent` or `RunConfig`.
+ * pass as `inputGuardrails` on an agent topology build.
  *
  * @param allowedGlobs - File-path glob allowlist.
  * @param allowedTools - Tool name allowlist.
  * @returns Array of input guardrails to attach to the agent.
  */
-export declare function buildDefaultGuardrails(allowedGlobs: string[], allowedTools: string[]): InputGuardrail[];
+export declare function buildDefaultGuardrails(allowedGlobs: string[], allowedTools: string[]): CleoInputGuardrail[];
+/**
+ * Evaluate a set of CLEO input guardrails against an input payload.
+ *
+ * Runs every guardrail in sequence and returns the first tripwire result.
+ * When no guardrail trips, returns a passing result with diagnostic data
+ * aggregated from each guardrail's `outputInfo`.
+ *
+ * @param guardrails - Guardrails to evaluate.
+ * @param input - The input string to test (typically the enriched prompt).
+ * @returns Aggregated guardrail result.
+ */
+export declare function evaluateGuardrails(guardrails: CleoInputGuardrail[], input: string): Promise<CleoGuardrailResult>;
 //# sourceMappingURL=guardrails.d.ts.map

package/dist/providers/openai-sdk/guardrails.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/guardrails.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA8B,MAAM,gBAAgB,CAAC;AAwBjF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAG3E;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,cAAc,CA6BzE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,cAAc,CAclF;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,MAAM,EAAE,GACrB,cAAc,EAAE,CAYlB"}
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/guardrails.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,kDAAkD;AAClD,MAAM,WAAW,8BAA8B;IAC7C,qDAAqD;IACrD,KAAK,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;IACf,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,OAAO,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7E;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAwBhD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAG3E;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,kBAAkB,CA2B7E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAYtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,MAAM,EAAE,GACrB,kBAAkB,EAAE,CAYtB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,kBAAkB,EAAE,EAChC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,CAAC,CAqB9B"}

package/dist/providers/openai-sdk/handoff.d.ts

@@ -1,29 +1,59 @@
 /**
- * CLEO Team topology → OpenAI Agents SDK handoff mapping.
+ * CLEO Team topology → lead/worker agent descriptors.
  *
- * CLEO agents are organised in a Lead → Worker hierarchy. This module maps
- * that topology to the SDK's first-class `handoffs` graph:
+ * CLEO agents are organised in a Lead → Worker hierarchy. Historically this
+ * was wired into the `@openai/agents` first-class `handoffs` graph. Post T933
+ * (ADR-052 — Vercel AI SDK consolidation) CLEO owns the topology entirely:
  *
- * - A Team Lead becomes an `Agent` whose `handoffs` array lists its workers.
+ * - A Team Lead is a {@link CleoAgent} whose `handoffs` array lists its workers.
  * - Each Worker archetype (read-only, write, bash) is declared in
  *   `WORKER_ARCHETYPES` and built on demand.
  * - The mapping is driven by `SpawnContext.options.handoffs`, which is an
  *   array of worker archetype names.
+ * - When a lead agent needs to delegate, the spawn provider runs a separate
+ *   `generateText` call for the selected worker and injects the result back
+ *   into the lead's context.
  *
- * @task T582
+ * @task T582 (original)
+ * @task T933 (SDK consolidation — CLEO-native topology)
  */
-import type { InputGuardrail } from '@openai/agents';
-import { Agent } from '@openai/agents';
+import type { CleoInputGuardrail } from './guardrails.js';
+/**
+ * Agent descriptor used by the CLEO OpenAI adapter.
+ *
+ * @remarks
+ * Intentionally mirrors the subset of `@openai/agents`'s `Agent` that CLEO
+ * actually consumed. The Vercel AI SDK delivers model inference via
+ * `generateText` / `streamText`; handoffs are orchestrated by the spawn
+ * provider using this descriptor as input.
+ */
+export interface CleoAgent {
+    /** Agent identifier surfaced in trace spans. */
+    name: string;
+    /** System-level instructions fed to the model. */
+    instructions: string;
+    /** Vercel AI SDK model identifier (e.g. `gpt-4.1`, `gpt-4.1-mini`). */
+    model: string;
+    /** Workers this agent may delegate to. Undefined when the agent is a leaf. */
+    handoffs?: CleoAgent[];
+    /** Input guardrails evaluated before the model call. */
+    inputGuardrails?: CleoInputGuardrail[];
+}
+/**
+ * @deprecated Use {@link CleoAgent}. Legacy alias for callers that imported
+ *   the `Agent` type from this module. Removed in a future major.
+ */
+export type Agent = CleoAgent;
 /**
  * Descriptor for a pre-configured worker agent archetype.
  *
  * Archetypes are declarative templates. `buildWorkerAgent` inflates them into
- * live SDK `Agent` instances.
+ * live {@link CleoAgent} instances.
  */
 export interface WorkerArchetype {
-    /** Archetype identifier (also used as SDK agent name). */
+    /** Archetype identifier (also used as agent name). */
     name: string;
-    /** Short description passed as the SDK agent instructions. */
+    /** Short description passed as the agent instructions. */
     instructions: string;
     /** Preferred model for this archetype. */
     model: string;
@@ -36,23 +66,23 @@ export interface WorkerArchetype {
  */
 export declare const WORKER_ARCHETYPES: Record<string, WorkerArchetype>;
 /**
- * Build a worker `Agent` instance from a named archetype.
+ * Build a worker {@link CleoAgent} from a named archetype.
  *
  * @param archetypeName - Key in {@link WORKER_ARCHETYPES}.
  * @param guardrails - Input guardrails to attach to the worker agent.
- * @returns A configured SDK `Agent` or `null` when the archetype is unknown.
+ * @returns A configured agent descriptor or `null` when the archetype is unknown.
  */
-export declare function buildWorkerAgent(archetypeName: string, guardrails: InputGuardrail[]): Agent | null;
+export declare function buildWorkerAgent(archetypeName: string, guardrails: CleoInputGuardrail[]): CleoAgent | null;
 /**
- * Build a team lead `Agent` whose `handoffs` reference the given workers.
+ * Build a team lead {@link CleoAgent} whose `handoffs` reference the given workers.
  *
  * @param leadInstructions - System instructions for the lead agent.
  * @param leadModel - Model to use for the lead agent.
  * @param workers - Worker agents this lead can hand off to.
  * @param guardrails - Input guardrails to attach to the lead agent.
- * @returns A configured lead SDK `Agent`.
+ * @returns A configured lead agent descriptor.
  */
-export declare function buildLeadAgent(leadInstructions: string, leadModel: string, workers: Agent[], guardrails: InputGuardrail[]): Agent;
+export declare function buildLeadAgent(leadInstructions: string, leadModel: string, workers: CleoAgent[], guardrails: CleoInputGuardrail[]): CleoAgent;
 /**
  * Build a simple single-tier agent (no handoffs) from prompt and model.
  *
@@ -62,9 +92,9 @@ export declare function buildLeadAgent(leadInstructions: string, leadModel: stri
  * @param instructions - Agent system instructions.
  * @param model - Model identifier.
  * @param guardrails - Input guardrails.
- * @returns A configured SDK `Agent`.
+ * @returns A configured agent descriptor.
  */
-export declare function buildStandaloneAgent(instructions: string, model: string, guardrails: InputGuardrail[]): Agent;
+export declare function buildStandaloneAgent(instructions: string, model: string, guardrails: CleoInputGuardrail[]): CleoAgent;
 /** Options for building the agent topology from a spawn context. */
 export interface TopologyOptions {
     /** Prompt / instructions for the entry-point agent. */
@@ -76,7 +106,7 @@ export interface TopologyOptions {
     /** Names of worker archetypes to create and attach as handoffs. */
     handoffNames: string[];
     /** Input guardrails shared across all agents in the topology. */
-    guardrails: InputGuardrail[];
+    guardrails: CleoInputGuardrail[];
 }
 /**
  * Build the entry-point agent and its worker topology from spawn options.
@@ -88,7 +118,7 @@ export interface TopologyOptions {
  * Unknown archetype names in `handoffNames` are silently skipped.
  *
  * @param options - Topology build options.
- * @returns The entry-point agent to pass to `runner.run()`.
+ * @returns The entry-point agent descriptor.
  */
-export declare function buildAgentTopology(options: TopologyOptions): Agent;
+export declare function buildAgentTopology(options: TopologyOptions): CleoAgent;
 //# sourceMappingURL=handoff.d.ts.map

package/dist/providers/openai-sdk/handoff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAMvC;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAmB7D,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,cAAc,EAAE,GAC3B,KAAK,GAAG,IAAI,CAUd;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,KAAK,EAAE,EAChB,UAAU,EAAE,cAAc,EAAE,GAC3B,KAAK,CAQP;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,cAAc,EAAE,GAC3B,KAAK,CAOP;AAMD,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;IACzC,mEAAmE;IACnE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iEAAiE;IACjE,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,KAAK,CAkBlE"}
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAM1D;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,wDAAwD;IACxD,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC;AAM9B;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAmB7D,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,kBAAkB,EAAE,GAC/B,SAAS,GAAG,IAAI,CAUlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,EAAE,EACpB,UAAU,EAAE,kBAAkB,EAAE,GAC/B,SAAS,CAQX;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,kBAAkB,EAAE,GAC/B,SAAS,CAOX;AAMD,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;IACzC,mEAAmE;IACnE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iEAAiE;IACjE,UAAU,EAAE,kBAAkB,EAAE,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAkBtE"}

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

@@ -1,19 +1,22 @@
 /**
  * @packageDocumentation
  *
- * CLEO provider adapter for the OpenAI Agents SDK.
+ * CLEO provider adapter for the OpenAI provider, backed by the Vercel AI SDK.
  * Default export is the adapter class for dynamic loading by AdapterManager.
  *
- * @task T582
+ * @task T582 (original)
+ * @task T933 (SDK consolidation — Vercel AI SDK migration)
  */
 import { OpenAiSdkAdapter } from './adapter.js';
 export { OpenAiSdkAdapter } from './adapter.js';
-export { buildDefaultGuardrails, buildPathGuardrail, buildToolAllowlistGuardrail, isPathAllowed, } from './guardrails.js';
-export type { TopologyOptions, WorkerArchetype } from './handoff.js';
+export type { CleoGuardrailResult, CleoInputGuardrail, CleoInputGuardrailFunctionArgs, InputGuardrail, } from './guardrails.js';
+export { buildDefaultGuardrails, buildPathGuardrail, buildToolAllowlistGuardrail, evaluateGuardrails, isPathAllowed, } from './guardrails.js';
+export type { Agent, CleoAgent, TopologyOptions, WorkerArchetype } from './handoff.js';
 export { buildAgentTopology, buildLeadAgent, buildStandaloneAgent, buildWorkerAgent, WORKER_ARCHETYPES, } from './handoff.js';
 export { OpenAiSdkInstallProvider } from './install.js';
 export type { OpenAiSdkSpawnOptions } from './spawn.js';
-export { OpenAiSdkSpawnProvider } from './spawn.js';
+export { OpenAiSdkSpawnProvider, registerTraceProcessor, setTracingDisabled, unregisterTraceProcessor, } from './spawn.js';
+export type { CleoAgentSpanData, CleoFunctionSpanData, CleoGenericSpanData, CleoHandoffSpanData, CleoSpan, CleoSpanData, CleoSpanKind, CleoTrace, CleoTraceProcessor, } from './tracing.js';
 export { CleoConduitTraceProcessor } from './tracing.js';
 export default OpenAiSdkAdapter;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,eAAe,gBAAgB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,8BAA8B,EAC9B,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,EAClB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,eAAe,gBAAgB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD"}

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

@@ -9,7 +9,7 @@
  */
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 /**
- * Install provider for the OpenAI Agents SDK.
+ * Install provider for the OpenAI SDK adapter (Vercel AI SDK).
  *
  * Manages CLEO's integration with OpenAI SDK projects by:
  * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files