@cleocode/adapters 2026.5.4 → 2026.5.5

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

@@ -1,121 +0,0 @@
-/**
- * OpenAI SDK Adapter — Vercel AI SDK edition.
- *
- * 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 (original)
- * @task T933 (SDK consolidation — Vercel AI SDK migration)
- * @see ADR-052 — SDK consolidation decision
- */
-import { OpenAiSdkInstallProvider } from './install.js';
-import { OpenAiSdkSpawnProvider } from './spawn.js';
-/**
- * CLEO provider adapter for the OpenAI provider.
- *
- * 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
- * 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 class OpenAiSdkAdapter {
-    /** Unique provider identifier. */
-    id = 'openai-sdk';
-    /** Human-readable provider name. */
-    name = 'OpenAI SDK (Vercel AI SDK)';
-    /** Adapter version string. */
-    version = '2.0.0';
-    /** Declared capabilities for this provider. */
-    capabilities = {
-        supportsHooks: false,
-        // The SDK does not expose CLI lifecycle hooks equivalent to Claude Code.
-        supportedHookEvents: [],
-        supportsSpawn: true,
-        supportsInstall: true,
-        supportsInstructionFiles: true,
-        instructionFilePattern: 'AGENTS.md',
-        supportsContextMonitor: false,
-        supportsStatusline: false,
-        supportsProviderPaths: false,
-        supportsTransport: false,
-        supportsTaskSync: false,
-    };
-    /** Spawn provider for SDK-backed agent runs with handoff topology. */
-    spawn;
-    /** Install provider for AGENTS.md and .openai/ config directory management. */
-    install;
-    /** Project directory this adapter was initialized with, or null. */
-    projectDir = null;
-    /** Whether {@link initialize} has been called. */
-    initialized = false;
-    constructor() {
-        this.spawn = new OpenAiSdkSpawnProvider();
-        this.install = new OpenAiSdkInstallProvider();
-    }
-    /**
-     * Initialize the adapter for a given project directory.
-     *
-     * @param projectDir - Root directory of the project.
-     */
-    async initialize(projectDir) {
-        this.projectDir = projectDir;
-        this.initialized = true;
-    }
-    /**
-     * Dispose the adapter and release all resources.
-     */
-    async dispose() {
-        this.initialized = false;
-        this.projectDir = null;
-    }
-    /**
-     * Run a health check to verify the OpenAI SDK is usable.
-     *
-     * Checks:
-     * 1. Adapter has been initialized
-     * 2. `OPENAI_API_KEY` is set in the environment
-     *
-     * @returns Health status with details about each check.
-     */
-    async healthCheck() {
-        if (!this.initialized) {
-            return {
-                healthy: false,
-                provider: this.id,
-                details: { error: 'Adapter not initialized' },
-            };
-        }
-        const apiKeyPresent = typeof process.env.OPENAI_API_KEY === 'string' && process.env.OPENAI_API_KEY.length > 0;
-        return {
-            healthy: apiKeyPresent,
-            provider: this.id,
-            details: {
-                apiKeyPresent,
-                projectDir: this.projectDir,
-                sdkVersion: 'ai@6 + @ai-sdk/openai',
-            },
-        };
-    }
-    /**
-     * Check whether the adapter has been initialized.
-     */
-    isInitialized() {
-        return this.initialized;
-    }
-    /**
-     * Get the project directory this adapter was initialized with.
-     */
-    getProjectDir() {
-        return this.projectDir;
-    }
-}
-//# sourceMappingURL=adapter.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/openai-sdk/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,gBAAgB;IAC3B,kCAAkC;IACzB,EAAE,GAAG,YAAY,CAAC;IAC3B,oCAAoC;IAC3B,IAAI,GAAG,4BAA4B,CAAC;IAC7C,8BAA8B;IACrB,OAAO,GAAG,OAAO,CAAC;IAE3B,+CAA+C;IAC/C,YAAY,GAAwB;QAClC,aAAa,EAAE,KAAK;QACpB,yEAAyE;QACzE,mBAAmB,EAAE,EAAE;QACvB,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;QACrB,wBAAwB,EAAE,IAAI;QAC9B,sBAAsB,EAAE,WAAW;QACnC,sBAAsB,EAAE,KAAK;QAC7B,kBAAkB,EAAE,KAAK;QACzB,qBAAqB,EAAE,KAAK;QAC5B,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;KACxB,CAAC;IAEF,sEAAsE;IACtE,KAAK,CAAyB;IAC9B,+EAA+E;IAC/E,OAAO,CAA2B;IAElC,oEAAoE;IAC5D,UAAU,GAAkB,IAAI,CAAC;IACzC,kDAAkD;IAC1C,WAAW,GAAG,KAAK,CAAC;IAE5B;QACE,IAAI,CAAC,KAAK,GAAG,IAAI,sBAAsB,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,wBAAwB,EAAE,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,UAAkB;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,IAAI,CAAC,EAAE;gBACjB,OAAO,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE;aAC9C,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GACjB,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;QAE1F,OAAO;YACL,OAAO,EAAE,aAAa;YACtB,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,OAAO,EAAE;gBACP,aAAa;gBACb,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,UAAU,EAAE,uBAAuB;aACpC;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

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

@@ -1,174 +0,0 @@
-/**
- * CLEO permission rules for the OpenAI SDK adapter.
- *
- * 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.
- *
- * 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)
- */
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/**
- * Converts a simple glob pattern to a RegExp.
- *
- * Supports `*` (any chars within a segment) and `**` (any chars including `/`).
- * This is a lightweight alternative to the `minimatch` package so no extra
- * dependency is required in the adapters package.
- *
- * @param glob - Glob pattern to convert (e.g. `/mnt/projects/**`).
- * @returns A RegExp that matches paths conforming to the glob.
- */
-function globToRegex(glob) {
-    // Escape regex metacharacters except * and ?
-    const escaped = glob.replace(/[.+^${}()|[\]\\]/g, '\\$&');
-    // Replace ** first (order matters), then *
-    const pattern = escaped.replace(/\*\*/g, '.+').replace(/\*/g, '[^/]*');
-    return new RegExp(`^${pattern}$`);
-}
-/**
- * Check whether a file-system path is covered by at least one glob pattern.
- *
- * @param path - The absolute or relative path to test.
- * @param allowedGlobs - Array of glob patterns (supports `*` and `**`).
- * @returns `true` when the path matches at least one pattern.
- */
-export function isPathAllowed(path, allowedGlobs) {
-    if (allowedGlobs.length === 0)
-        return true;
-    return allowedGlobs.some((glob) => globToRegex(glob).test(path));
-}
-// ---------------------------------------------------------------------------
-// Guardrail builders
-// ---------------------------------------------------------------------------
-/**
- * Build an input guardrail that enforces CLEO file-glob path ACLs.
- *
- * Inspects the serialised agent input for embedded `"path":"..."` fields
- * and rejects the run when a path falls outside the allowlist. This provides
- * an early-exit safety fence before the agent starts consuming model tokens.
- *
- * @param allowedGlobs - Glob patterns that tool path arguments must match.
- *   Pass an empty array to allow all paths (permissive mode).
- * @returns A {@link CleoInputGuardrail} ready to attach to an agent.
- *
- * @example
- * ```typescript
- * const guard = buildPathGuardrail(['/mnt/projects/**', '/tmp/**']);
- * const agent = buildStandaloneAgent('...', 'gpt-4.1', [guard]);
- * ```
- */
-export function buildPathGuardrail(allowedGlobs) {
-    return {
-        name: 'cleo_path_acl',
-        execute: async (args) => {
-            // Serialise input to a string for heuristic path scanning.
-            const inputStr = typeof args.input === 'string' ? args.input : JSON.stringify(args.input);
-            // Scan for JSON-encoded `"path":"..."` occurrences in the input text.
-            // This is conservative: if no path field is found the guardrail passes.
-            const pathMatches = inputStr.matchAll(/"path"\s*:\s*"([^"]+)"/g);
-            for (const match of pathMatches) {
-                const candidate = match[1];
-                if (candidate && !isPathAllowed(candidate, allowedGlobs)) {
-                    return {
-                        tripwireTriggered: true,
-                        outputInfo: {
-                            reason: `cleo_path_acl: path denied by ACL — ${candidate}`,
-                            deniedPath: candidate,
-                            allowedGlobs,
-                        },
-                    };
-                }
-            }
-            return { tripwireTriggered: false, outputInfo: null };
-        },
-    };
-}
-/**
- * Build an input guardrail that documents the tool allowlist for audit purposes.
- *
- * 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 A {@link CleoInputGuardrail} ready to attach to an agent.
- *
- * @example
- * ```typescript
- * const guard = buildToolAllowlistGuardrail(['read', 'write']);
- * ```
- */
-export function buildToolAllowlistGuardrail(allowedTools) {
-    return {
-        name: 'cleo_tool_allowlist',
-        execute: async (_args) => {
-            // Structural enforcement: only listed tools are attached to the agent.
-            // This guardrail records the allowlist for audit and always passes.
-            return {
-                tripwireTriggered: false,
-                outputInfo: { allowedTools, checked: true },
-            };
-        },
-    };
-}
-/**
- * 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 topology build.
- *
- * @param allowedGlobs - File-path glob allowlist.
- * @param allowedTools - Tool name allowlist.
- * @returns Array of input guardrails to attach to the agent.
- */
-export function buildDefaultGuardrails(allowedGlobs, allowedTools) {
-    const guards = [];
-    if (allowedGlobs.length > 0) {
-        guards.push(buildPathGuardrail(allowedGlobs));
-    }
-    if (allowedTools.length > 0) {
-        guards.push(buildToolAllowlistGuardrail(allowedTools));
-    }
-    return guards;
-}
-/**
- * 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 async function evaluateGuardrails(guardrails, input) {
-    const aggregate = [];
-    for (const guard of guardrails) {
-        const result = await guard.execute({
-            agent: null,
-            input,
-            context: null,
-        });
-        if (result.tripwireTriggered) {
-            return result;
-        }
-        aggregate.push({ name: guard.name, outputInfo: result.outputInfo });
-    }
-    return {
-        tripwireTriggered: false,
-        outputInfo: aggregate,
-    };
-}
-//# sourceMappingURL=guardrails.js.map

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

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

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

@@ -1,128 +0,0 @@
-/**
- * CLEO Team topology → lead/worker agent descriptors.
- *
- * 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 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 (original)
- * @task T933 (SDK consolidation — CLEO-native topology)
- */
-/**
- * Registry of built-in CLEO worker archetypes.
- *
- * Callers reference these by name in `SpawnContext.options.handoffs`.
- * New archetypes can be added here without changing the spawn provider.
- */
-export const WORKER_ARCHETYPES = {
-    'worker-read': {
-        name: 'worker-read',
-        instructions: 'You are a read-only CLEO worker. You may only read files and return findings. Never write, modify, or delete files.',
-        model: 'gpt-4.1-mini',
-    },
-    'worker-write': {
-        name: 'worker-write',
-        instructions: 'You are a CLEO write worker. You implement code changes directed by the lead agent. Follow the lead agent instructions precisely.',
-        model: 'gpt-4.1-mini',
-    },
-    'worker-bash': {
-        name: 'worker-bash',
-        instructions: 'You are a CLEO bash worker. You run shell commands directed by the lead agent. Only execute commands explicitly requested.',
-        model: 'gpt-4.1-mini',
-    },
-};
-// ---------------------------------------------------------------------------
-// Agent builders
-// ---------------------------------------------------------------------------
-/**
- * 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 agent descriptor or `null` when the archetype is unknown.
- */
-export function buildWorkerAgent(archetypeName, guardrails) {
-    const archetype = WORKER_ARCHETYPES[archetypeName];
-    if (!archetype)
-        return null;
-    return {
-        name: archetype.name,
-        instructions: archetype.instructions,
-        model: archetype.model,
-        ...(guardrails.length > 0 ? { inputGuardrails: guardrails } : {}),
-    };
-}
-/**
- * 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 agent descriptor.
- */
-export function buildLeadAgent(leadInstructions, leadModel, workers, guardrails) {
-    return {
-        name: 'cleo-lead',
-        instructions: leadInstructions,
-        model: leadModel,
-        ...(workers.length > 0 ? { handoffs: workers } : {}),
-        ...(guardrails.length > 0 ? { inputGuardrails: guardrails } : {}),
-    };
-}
-/**
- * Build a simple single-tier agent (no handoffs) from prompt and model.
- *
- * Used when `SpawnContext.options.tier` is `'worker'` or when no handoff
- * names are provided.
- *
- * @param instructions - Agent system instructions.
- * @param model - Model identifier.
- * @param guardrails - Input guardrails.
- * @returns A configured agent descriptor.
- */
-export function buildStandaloneAgent(instructions, model, guardrails) {
-    return {
-        name: 'cleo-worker',
-        instructions,
-        model,
-        ...(guardrails.length > 0 ? { inputGuardrails: guardrails } : {}),
-    };
-}
-/**
- * Build the entry-point agent and its worker topology from spawn options.
- *
- * - `tier === 'lead'` or `tier === 'orchestrator'`: creates a lead agent with
- *   worker handoffs derived from `handoffNames`.
- * - `tier === 'worker'`: creates a standalone agent with no handoffs.
- *
- * Unknown archetype names in `handoffNames` are silently skipped.
- *
- * @param options - Topology build options.
- * @returns The entry-point agent descriptor.
- */
-export function buildAgentTopology(options) {
-    const { instructions, model, tier, handoffNames, guardrails } = options;
-    if (tier === 'worker') {
-        return buildStandaloneAgent(instructions, model, guardrails);
-    }
-    // Build worker agents from archetype names; skip unknown names.
-    const workers = handoffNames
-        .map((name) => buildWorkerAgent(name, guardrails))
-        .filter((a) => a !== null);
-    if (workers.length === 0) {
-        // Lead with no workers — still usable as a standalone agent.
-        return buildStandaloneAgent(instructions, model, guardrails);
-    }
-    return buildLeadAgent(instructions, model, workers, guardrails);
-}
-//# sourceMappingURL=handoff.js.map

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

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

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

@@ -1,40 +0,0 @@
-/**
- * @packageDocumentation
- *
- * 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 (original)
- * @task T933 (SDK consolidation — Vercel AI SDK migration)
- */
-import { OpenAiSdkAdapter } from './adapter.js';
-export { OpenAiSdkAdapter } from './adapter.js';
-export { buildDefaultGuardrails, buildPathGuardrail, buildToolAllowlistGuardrail, evaluateGuardrails, isPathAllowed, } from './guardrails.js';
-export { buildAgentTopology, buildLeadAgent, buildStandaloneAgent, buildWorkerAgent, WORKER_ARCHETYPES, } from './handoff.js';
-export { OpenAiSdkInstallProvider } from './install.js';
-export { OpenAiSdkSpawnProvider, registerTraceProcessor, setTracingDisabled, unregisterTraceProcessor, } from './spawn.js';
-export { CleoConduitTraceProcessor } from './tracing.js';
-export default OpenAiSdkAdapter;
-/**
- * Factory function for creating adapter instances.
- * Used by AdapterManager's dynamic import fallback.
- *
- * @remarks
- * This is the primary entry point for dynamic adapter loading.
- * AdapterManager calls this function when it resolves the openai-sdk
- * provider via its import-based discovery mechanism.
- *
- * @returns A new {@link OpenAiSdkAdapter} instance ready for initialization.
- *
- * @example
- * ```typescript
- * import { createAdapter } from '@cleocode/adapters/providers/openai-sdk';
- *
- * const adapter = createAdapter();
- * await adapter.initialize('/path/to/project');
- * ```
- */
-export function createAdapter() {
-    return new OpenAiSdkAdapter();
-}
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","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;AAOhD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,EAClB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAYpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,eAAe,gBAAgB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,gBAAgB,EAAE,CAAC;AAChC,CAAC"}

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

@@ -1,120 +0,0 @@
-/**
- * OpenAI SDK Install Provider.
- *
- * Handles CLEO installation into OpenAI SDK environments:
- * - Writes an AGENTS.md file with CLEO @-references
- * - Creates a `.openai/` config stub if it does not exist
- *
- * @task T582
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-/** Lines that should appear in AGENTS.md to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
-/**
- * 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
- * 2. Creating the `.openai/` config directory stub if absent
- *
- * @remarks
- * Installation is idempotent — running install multiple times on the same
- * project produces the same result.
- */
-export class OpenAiSdkInstallProvider {
-    /**
-     * Install CLEO into an OpenAI SDK project.
-     *
-     * @param options - Installation options including project directory.
-     * @returns Result describing what was installed.
-     */
-    async install(options) {
-        const { projectDir } = options;
-        const installedAt = new Date().toISOString();
-        const details = {};
-        // Step 1: Ensure AGENTS.md has @-references
-        const instructionFileUpdated = this.updateInstructionFile(projectDir);
-        if (instructionFileUpdated) {
-            details.instructionFile = join(projectDir, 'AGENTS.md');
-        }
-        // Step 2: Create .openai config directory stub
-        const configCreated = this.ensureConfigDir(projectDir);
-        if (configCreated) {
-            details.configDir = join(projectDir, '.openai');
-        }
-        return {
-            success: true,
-            installedAt,
-            instructionFileUpdated,
-            details,
-        };
-    }
-    /**
-     * Uninstall CLEO from the current OpenAI SDK project.
-     *
-     * Does not remove AGENTS.md references (they are harmless if CLEO is absent).
-     */
-    async uninstall() { }
-    /**
-     * Check whether CLEO is installed in the current OpenAI SDK environment.
-     *
-     * Checks for `@~/.cleo/templates/CLEO-INJECTION.md` in AGENTS.md.
-     */
-    async isInstalled() {
-        // A project is considered installed when AGENTS.md contains the first reference.
-        // There is no plugin registry for the OpenAI SDK.
-        return false;
-    }
-    /**
-     * Ensure AGENTS.md contains @-references to CLEO instruction files.
-     *
-     * @param projectDir - Project root directory.
-     */
-    async ensureInstructionReferences(projectDir) {
-        this.updateInstructionFile(projectDir);
-    }
-    // ---------------------------------------------------------------------------
-    // Private helpers
-    // ---------------------------------------------------------------------------
-    /**
-     * Update AGENTS.md with CLEO @-references.
-     *
-     * @returns `true` if the file was created or modified.
-     */
-    updateInstructionFile(projectDir) {
-        const agentsMdPath = join(projectDir, 'AGENTS.md');
-        let content = '';
-        let existed = false;
-        if (existsSync(agentsMdPath)) {
-            content = readFileSync(agentsMdPath, 'utf-8');
-            existed = true;
-        }
-        const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-        if (missingRefs.length === 0)
-            return false;
-        const refsBlock = missingRefs.join('\n');
-        if (existed) {
-            const separator = content.endsWith('\n') ? '' : '\n';
-            content = content + separator + refsBlock + '\n';
-        }
-        else {
-            content = refsBlock + '\n';
-        }
-        writeFileSync(agentsMdPath, content, 'utf-8');
-        return true;
-    }
-    /**
-     * Create the `.openai/` config directory if it does not exist.
-     *
-     * @returns `true` if the directory was created.
-     */
-    ensureConfigDir(projectDir) {
-        const configDir = join(projectDir, '.openai');
-        if (existsSync(configDir))
-            return false;
-        mkdirSync(configDir, { recursive: true });
-        return true;
-    }
-}
-//# sourceMappingURL=install.js.map

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

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