@cleocode/adapters 2026.5.3 → 2026.5.5

package/dist/providers/openai-sdk/spawn.js

@@ -1,361 +0,0 @@
-/**
- * OpenAI SDK spawn provider — Vercel AI SDK edition.
- *
- * Implements `AdapterSpawnProvider` using the Vercel AI SDK
- * (`ai` v6 + `@ai-sdk/openai`) instead of the legacy `@openai/agents`. CLEO
- * retains its own orchestration (handoff topology, guardrails, tracing); the
- * SDK is strictly the LLM bridge.
- *
- * Unlike the Claude Code provider (detached fire-and-forget), this provider
- * awaits the run and returns `status: 'completed'` or `status: 'failed'` so
- * the orchestrator receives rich output immediately.
- *
- * Key features:
- * - Tier-based model selection (lead → gpt-4.1, worker → gpt-4.1-mini)
- * - Handoff topology built from `SpawnContext.options.handoffs` (CLEO-native)
- * - CLEO path ACL guardrails evaluated before the model call
- * - Default-on tracing via `CleoConduitTraceProcessor`
- * - CANT prompt enrichment (best-effort, same as Claude Code provider)
- *
- * @task T582 (original)
- * @task T933 (SDK consolidation — Vercel AI SDK migration)
- * @see ADR-052 — SDK consolidation decision
- */
-import { getErrorMessage } from '@cleocode/contracts';
-import { mapSdkRunOutcome } from '../shared/sdk-result-mapper.js';
-import { buildDefaultGuardrails, evaluateGuardrails } from './guardrails.js';
-import { buildAgentTopology } from './handoff.js';
-import { CleoConduitTraceProcessor } from './tracing.js';
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-const MODEL_LEAD = 'gpt-4.1';
-const MODEL_WORKER = 'gpt-4.1-mini';
-// ---------------------------------------------------------------------------
-// Trace processor registry (module-scoped)
-// ---------------------------------------------------------------------------
-/** Registered trace processors that receive span events across the module. */
-const registeredProcessors = [];
-/** Module-level flag that disables span dispatch globally. */
-let tracingGlobalDisabled = false;
-/**
- * Register a CLEO trace processor. Mirrors `addTraceProcessor` from the
- * legacy `@openai/agents` surface so existing consumers continue to work.
- *
- * @param processor - Processor to register.
- */
-export function registerTraceProcessor(processor) {
-    registeredProcessors.push(processor);
-}
-/**
- * Remove a previously registered trace processor.
- *
- * @param processor - Processor to remove.
- */
-export function unregisterTraceProcessor(processor) {
-    const idx = registeredProcessors.indexOf(processor);
-    if (idx >= 0) {
-        registeredProcessors.splice(idx, 1);
-    }
-}
-/**
- * Enable or disable global tracing. Equivalent to `setTracingDisabled` from
- * the legacy `@openai/agents` surface.
- *
- * @param disabled - When true, no spans are emitted.
- */
-export function setTracingDisabled(disabled) {
-    tracingGlobalDisabled = disabled;
-}
-/**
- * Dispatch a span to every registered trace processor, subject to the global
- * `tracingGlobalDisabled` flag.
- *
- * @param span - Span event to dispatch.
- */
-async function emitSpan(span) {
-    if (tracingGlobalDisabled)
-        return;
-    for (const processor of registeredProcessors) {
-        try {
-            await processor.onSpanEnd(span);
-        }
-        catch {
-            // Tracing failures must never break a run.
-        }
-    }
-}
-// ---------------------------------------------------------------------------
-// Provider
-// ---------------------------------------------------------------------------
-/**
- * Spawn provider for the Vercel AI SDK (OpenAI flavour).
- *
- * Spawns SDK-backed agent runs for a given `SpawnContext`. The run is awaited
- * synchronously and the result mapped to a `SpawnResult` with
- * `status: 'completed'` or `status: 'failed'`. In-flight runs are tracked by
- * instance ID so `listRunning()` and `terminate()` work correctly.
- *
- * @remarks
- * Handoff topology is resolved by this provider, not the SDK. When the entry
- * agent is a lead with workers, the provider:
- *
- *   1. Runs the lead agent's `generateText` with the enriched prompt.
- *   2. For each worker listed in handoffs, runs a sequential `generateText`
- *      using the worker's archetype model, passing the lead's output as the
- *      worker prompt. Results are concatenated.
- *
- * This preserves the visible behaviour of the legacy `@openai/agents` runner
- * while keeping CLEO as the orchestration owner.
- *
- * @example
- * ```typescript
- * const provider = new OpenAiSdkSpawnProvider();
- * const result = await provider.spawn({
- *   taskId: 'T582',
- *   prompt: 'Implement feature X',
- *   options: { tier: 'lead', handoffs: ['worker-read', 'worker-write'] },
- * });
- * console.log(result.status); // 'completed'
- * ```
- */
-export class OpenAiSdkSpawnProvider {
-    /** Currently running instance IDs (completed runs are removed). */
-    runningInstances = new Set();
-    /**
-     * Check whether the OpenAI SDK can spawn in the current environment.
-     *
-     * Requires `OPENAI_API_KEY` to be set. Does not make a network call.
-     *
-     * @returns `true` when `OPENAI_API_KEY` is present in the environment.
-     */
-    async canSpawn() {
-        return typeof process.env.OPENAI_API_KEY === 'string' && process.env.OPENAI_API_KEY.length > 0;
-    }
-    /**
-     * Spawn a subagent via the Vercel AI SDK.
-     *
-     * Awaits the run to completion and returns a fully-resolved `SpawnResult`.
-     *
-     * @param context - Spawn context with task ID, prompt, and options.
-     * @returns Resolved spawn result with `status: 'completed'` or `'failed'`.
-     */
-    async spawn(context) {
-        const instanceId = `openai-sdk-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-        const startTime = new Date().toISOString();
-        this.runningInstances.add(instanceId);
-        try {
-            const opts = this.parseOptions(context.options);
-            // Enrich prompt with CANT bundle (best-effort, same pattern as Claude Code provider).
-            let finalPrompt = context.prompt;
-            try {
-                const { buildCantEnrichedPrompt } = await import('../../cant-context.js');
-                finalPrompt = await buildCantEnrichedPrompt({
-                    projectDir: context.workingDirectory ?? process.cwd(),
-                    basePrompt: context.prompt,
-                    agentName: opts.agentName,
-                });
-            }
-            catch {
-                // CANT enrichment unavailable — use raw prompt.
-            }
-            // Build guardrails from ACL options.
-            const guardrails = buildDefaultGuardrails(opts.allowedGlobs ?? [], opts.allowedTools ?? []);
-            // Derive model from tier when not explicitly set.
-            const model = opts.model ?? this.modelForTier(opts.tier ?? 'worker');
-            // Build agent topology (lead + workers, or standalone worker).
-            const agent = buildAgentTopology({
-                instructions: finalPrompt,
-                model,
-                tier: opts.tier ?? 'worker',
-                handoffNames: opts.handoffs ?? [],
-                guardrails,
-            });
-            // Register trace processor globally (default-on).
-            let traceProcessor;
-            const previousTracingDisabled = tracingGlobalDisabled;
-            if (!opts.tracingDisabled) {
-                traceProcessor = new CleoConduitTraceProcessor(context.taskId);
-                registerTraceProcessor(traceProcessor);
-                setTracingDisabled(false);
-            }
-            else {
-                setTracingDisabled(true);
-            }
-            try {
-                // Evaluate guardrails before any model call. A tripped guardrail
-                // aborts the run with a structured failure.
-                const guardResult = await evaluateGuardrails(agent.inputGuardrails ?? [], finalPrompt);
-                if (guardResult.tripwireTriggered) {
-                    this.runningInstances.delete(instanceId);
-                    return mapSdkRunOutcome(instanceId, context.taskId, 'openai-sdk', startTime, {
-                        finalOutput: '',
-                        succeeded: false,
-                        errorMessage: `guardrail tripped: ${JSON.stringify(guardResult.outputInfo)}`,
-                    });
-                }
-                // Run the lead/worker topology.
-                const runOutput = await runAgentTopology(agent, finalPrompt, emitSpan);
-                this.runningInstances.delete(instanceId);
-                return mapSdkRunOutcome(instanceId, context.taskId, 'openai-sdk', startTime, {
-                    finalOutput: runOutput,
-                    succeeded: true,
-                });
-            }
-            finally {
-                // Restore previous tracing state and unregister this run's processor.
-                if (traceProcessor) {
-                    unregisterTraceProcessor(traceProcessor);
-                }
-                setTracingDisabled(previousTracingDisabled);
-            }
-        }
-        catch (error) {
-            this.runningInstances.delete(instanceId);
-            return mapSdkRunOutcome(instanceId, context.taskId, 'openai-sdk', startTime, {
-                finalOutput: '',
-                succeeded: false,
-                errorMessage: getErrorMessage(error),
-            });
-        }
-    }
-    /**
-     * List currently running OpenAI SDK agent instances.
-     *
-     * @returns Array of in-progress spawn results.
-     */
-    async listRunning() {
-        return [...this.runningInstances].map((instanceId) => ({
-            instanceId,
-            taskId: 'unknown',
-            providerId: 'openai-sdk',
-            status: 'running',
-            startTime: new Date().toISOString(),
-        }));
-    }
-    /**
-     * Terminate a running spawn by instance ID.
-     *
-     * The Vercel AI SDK does not support external termination of in-flight
-     * requests; this method removes the instance from the tracking set so it
-     * will no longer appear in `listRunning()`.
-     *
-     * @param instanceId - ID of the spawn instance to terminate.
-     */
-    async terminate(instanceId) {
-        this.runningInstances.delete(instanceId);
-    }
-    // ---------------------------------------------------------------------------
-    // Private helpers
-    // ---------------------------------------------------------------------------
-    /**
-     * Parse and validate `SpawnContext.options` into typed `OpenAiSdkSpawnOptions`.
-     *
-     * Unknown fields are silently ignored.
-     */
-    parseOptions(raw) {
-        if (!raw)
-            return {};
-        const opts = {};
-        if (typeof raw.model === 'string')
-            opts.model = raw.model;
-        if (raw.tier === 'lead' || raw.tier === 'worker' || raw.tier === 'orchestrator') {
-            opts.tier = raw.tier;
-        }
-        if (Array.isArray(raw.handoffs) && raw.handoffs.every((h) => typeof h === 'string')) {
-            opts.handoffs = raw.handoffs;
-        }
-        if (Array.isArray(raw.allowedGlobs) && raw.allowedGlobs.every((g) => typeof g === 'string')) {
-            opts.allowedGlobs = raw.allowedGlobs;
-        }
-        if (Array.isArray(raw.allowedTools) && raw.allowedTools.every((t) => typeof t === 'string')) {
-            opts.allowedTools = raw.allowedTools;
-        }
-        if (typeof raw.tracingDisabled === 'boolean')
-            opts.tracingDisabled = raw.tracingDisabled;
-        if (typeof raw.agentName === 'string')
-            opts.agentName = raw.agentName;
-        return opts;
-    }
-    /**
-     * Derive the default model for a given tier.
-     *
-     * @param tier - Agent tier.
-     * @returns Model identifier string.
-     */
-    modelForTier(tier) {
-        return tier === 'worker' ? MODEL_WORKER : MODEL_LEAD;
-    }
-}
-// ---------------------------------------------------------------------------
-// Topology runner
-// ---------------------------------------------------------------------------
-/**
- * Execute a CLEO agent topology against the Vercel AI SDK.
- *
- * Runs the entry agent via `generateText`. When the entry agent declares
- * handoffs, each worker is executed sequentially with the lead's output as
- * input and the concatenated result returned.
- *
- * @param agent - Entry agent descriptor.
- * @param userPrompt - Enriched user prompt.
- * @param emit - Span emitter invoked after every agent run.
- * @returns Concatenated assistant output.
- */
-async function runAgentTopology(agent, userPrompt, emit) {
-    const { createOpenAI } = await import('@ai-sdk/openai');
-    const { generateText } = await import('ai');
-    const apiKey = process.env.OPENAI_API_KEY;
-    if (!apiKey) {
-        throw new Error('OPENAI_API_KEY is not set — OpenAI SDK provider cannot run');
-    }
-    const openai = createOpenAI({ apiKey });
-    // Run the entry agent.
-    const startedAt = new Date().toISOString();
-    const leadResult = await generateText({
-        model: openai(agent.model),
-        system: agent.instructions,
-        prompt: userPrompt,
-    });
-    const leadText = (leadResult.text ?? '').trim();
-    const leadEnd = new Date().toISOString();
-    await emit({
-        spanId: `${agent.name}-${Date.now()}`,
-        startedAt,
-        endedAt: leadEnd,
-        spanData: { type: 'agent', name: agent.name },
-    });
-    // When there are no handoffs, return the lead output directly.
-    const workers = agent.handoffs ?? [];
-    if (workers.length === 0) {
-        return leadText;
-    }
-    // Sequential handoff execution. Each worker receives the lead output as
-    // input, and the concatenated worker outputs become the final run output.
-    const workerOutputs = [];
-    for (const worker of workers) {
-        const handoffStart = new Date().toISOString();
-        await emit({
-            spanId: `handoff-${agent.name}-${worker.name}-${Date.now()}`,
-            startedAt: handoffStart,
-            endedAt: handoffStart,
-            spanData: { type: 'handoff', from_agent: agent.name, to_agent: worker.name },
-        });
-        const workerStart = new Date().toISOString();
-        const workerResult = await generateText({
-            model: openai(worker.model),
-            system: worker.instructions,
-            prompt: leadText,
-        });
-        const workerEnd = new Date().toISOString();
-        await emit({
-            spanId: `${worker.name}-${Date.now()}`,
-            startedAt: workerStart,
-            endedAt: workerEnd,
-            spanData: { type: 'agent', name: worker.name },
-        });
-        workerOutputs.push(`[${worker.name}] ${(workerResult.text ?? '').trim()}`);
-    }
-    return [leadText, ...workerOutputs].join('\n\n');
-}
-//# sourceMappingURL=spawn.js.map

package/dist/providers/openai-sdk/spawn.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/providers/openai-sdk/spawn.ts"],"names":[],"mappings":"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"}

package/dist/providers/openai-sdk/tracing.js

@@ -1,159 +0,0 @@
-/**
- * CLEO trace processor that writes spans to conduit.db.
- *
- * `CleoConduitTraceProcessor` implements a CLEO-native tracing processor
- * interface that records spans emitted by the OpenAI SDK adapter. Post T933
- * (ADR-052 — Vercel AI SDK consolidation) the processor no longer implements
- * `@openai/agents` type surfaces; instead it consumes `CleoSpan` events
- * produced by `OpenAiSdkSpawnProvider` during a run.
- *
- * Tracing is on by default for all OpenAI SDK spawns. Set
- * `options.tracingDisabled = true` in `SpawnContext.options` to opt out when
- * conduit is unavailable.
- *
- * @task T582 (original)
- * @task T933 (SDK consolidation — provider-neutral rewrite)
- */
-import { writeSpanBatchToConduit } from '../shared/conduit-trace-writer.js';
-// ---------------------------------------------------------------------------
-// Processor
-// ---------------------------------------------------------------------------
-/**
- * CLEO trace processor that persists OpenAI SDK adapter spans to conduit.db.
- *
- * Each `onSpanEnd` call extracts span metadata and enqueues a write to conduit
- * via the shared `conduit-trace-writer` module. Writes are fire-and-forget —
- * failures are logged but never propagated to the caller.
- *
- * @remarks
- * `onTraceEnd` performs a batch flush of any buffered spans. Individual
- * `onSpanEnd` calls also write immediately so spans are not lost if the run
- * is interrupted.
- *
- * @example
- * ```typescript
- * import { registerTraceProcessor } from './spawn.js';
- * import { CleoConduitTraceProcessor } from './tracing.js';
- *
- * const processor = new CleoConduitTraceProcessor('T582');
- * registerTraceProcessor(processor);
- * ```
- */
-export class CleoConduitTraceProcessor {
-    /** CLEO task ID included in every span event for correlation. */
-    taskId;
-    /** Pending span events buffered within the current trace. */
-    pendingEvents = [];
-    /**
-     * @param taskId - CLEO task ID to attach to every written span.
-     */
-    constructor(taskId) {
-        this.taskId = taskId;
-    }
-    /**
-     * Called when a new trace starts. Resets the pending event buffer.
-     *
-     * @param _trace - The trace that just started (unused).
-     */
-    async onTraceStart(_trace) {
-        this.pendingEvents = [];
-    }
-    /**
-     * Called when a trace ends. Flushes all pending span events to conduit.
-     *
-     * @param _trace - The trace that just ended (unused — spans were captured via `onSpanEnd`).
-     */
-    async onTraceEnd(_trace) {
-        if (this.pendingEvents.length > 0) {
-            await writeSpanBatchToConduit(this.pendingEvents);
-            this.pendingEvents = [];
-        }
-    }
-    /**
-     * Called when a new span starts. No-op — we capture on end to have full timing.
-     *
-     * @param _span - The span that just started (unused).
-     */
-    async onSpanStart(_span) {
-        // Capture on end so startedAt / endedAt are both populated.
-    }
-    /**
-     * Called when a span ends. Serialises and writes the span to conduit.
-     *
-     * @param span - The completed span from the adapter.
-     */
-    async onSpanEnd(span) {
-        const event = this.extractSpanEvent(span);
-        if (event) {
-            this.pendingEvents.push(event);
-            // Also write immediately to survive partial run interruptions.
-            await writeSpanBatchToConduit([event]);
-        }
-    }
-    /**
-     * Called during graceful shutdown. Flushes any remaining pending events.
-     *
-     * @param _timeout - Shutdown timeout in milliseconds (unused).
-     */
-    async shutdown(_timeout) {
-        if (this.pendingEvents.length > 0) {
-            await writeSpanBatchToConduit(this.pendingEvents);
-            this.pendingEvents = [];
-        }
-    }
-    /**
-     * Force-flush all pending span events to conduit immediately.
-     */
-    async forceFlush() {
-        if (this.pendingEvents.length > 0) {
-            await writeSpanBatchToConduit(this.pendingEvents);
-            this.pendingEvents = [];
-        }
-    }
-    // ---------------------------------------------------------------------------
-    // Private helpers
-    // ---------------------------------------------------------------------------
-    /**
-     * Extract a {@link ConduitSpanEvent} from an adapter span, or `null` if the
-     * span cannot be meaningfully serialised.
-     *
-     * @param span - The adapter span to serialise.
-     * @returns A conduit span event or `null`.
-     */
-    extractSpanEvent(span) {
-        const spanId = span.spanId ?? `span-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`;
-        // Guard against malformed/empty spans (e.g. in unit tests with minimal mocks).
-        if (!span.spanData)
-            return null;
-        const data = span.spanData;
-        const spanType = data.type;
-        // Extract agent name from span data shape based on type.
-        let agentName = 'unknown';
-        let handoffTarget;
-        if (data.type === 'agent') {
-            agentName = data.name;
-        }
-        else if (data.type === 'handoff') {
-            agentName = data.from_agent ?? 'unknown';
-            handoffTarget = data.to_agent ?? undefined;
-        }
-        else if (data.type === 'function') {
-            agentName = data.name;
-        }
-        const startTime = span.startedAt ?? new Date().toISOString();
-        const endTime = span.endedAt ?? new Date().toISOString();
-        return {
-            spanId,
-            taskId: this.taskId,
-            agentName,
-            spanType,
-            startTime,
-            endTime,
-            handoffTarget,
-            metadata: {
-                rawSpanData: data,
-            },
-        };
-    }
-}
-//# sourceMappingURL=tracing.js.map

package/dist/providers/openai-sdk/tracing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../../src/providers/openai-sdk/tracing.ts"],"names":[],"mappings":"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"}