@cleocode/adapters 2026.4.11 → 2026.4.12

package/dist/providers/opencode/hooks.js

@@ -1,206 +0,0 @@
-/**
- * OpenCode Hook Provider
- *
- * Maps OpenCode's native hook events to CAAMP canonical hook events.
- * OpenCode supports 10 of 16 canonical events through its plugin system.
- *
- * Event translation uses CAAMP normalizer APIs:
- * - `toCanonical(nativeName, 'opencode')` for runtime event name resolution
- * - `getSupportedEvents('opencode')` to enumerate supported canonical events
- * - `getProviderHookProfile('opencode')` for the full provider profile
- *
- * OpenCode uses a JavaScript plugin system with event-prefixed names
- * (e.g. `event:session.created`) for some hooks and bare names for others.
- * The map is derived from `getProviderHookProfile('opencode').mappings` in
- * CAAMP 1.9.1. PostToolUseFailure, SubagentStart, SubagentStop, Notification,
- * and ConfigChange are not supported by OpenCode.
- *
- * @task T164
- * @epic T134
- */
-/** CAAMP provider identifier for OpenCode. */
-const PROVIDER_ID = 'opencode';
-/**
- * Fallback map from OpenCode native event names to CAAMP canonical names.
- *
- * Derived from `getProviderHookProfile('opencode').mappings` in CAAMP 1.9.1.
- * Covers all 10 supported events. PostToolUseFailure, SubagentStart,
- * SubagentStop, Notification, and ConfigChange are not supported by OpenCode
- * and are absent from this map.
- *
- * OpenCode uses dot-delimited and event-prefixed names (e.g. "event:session.created")
- * while CAAMP canonical names are PascalCase (e.g. "SessionStart").
- */
-const OPENCODE_EVENT_MAP = {
-    // CAAMP: toNative('SessionStart',       'opencode') = 'event:session.created'
-    'event:session.created': 'SessionStart',
-    // CAAMP: toNative('SessionEnd',         'opencode') = 'event:session.deleted'
-    'event:session.deleted': 'SessionEnd',
-    // CAAMP: toNative('PromptSubmit',       'opencode') = 'chat.message'
-    'chat.message': 'PromptSubmit',
-    // CAAMP: toNative('ResponseComplete',   'opencode') = 'event:session.idle'
-    'event:session.idle': 'ResponseComplete',
-    // CAAMP: toNative('PreToolUse',         'opencode') = 'tool.execute.before'
-    'tool.execute.before': 'PreToolUse',
-    // CAAMP: toNative('PostToolUse',        'opencode') = 'tool.execute.after'
-    'tool.execute.after': 'PostToolUse',
-    // CAAMP: toNative('PermissionRequest',  'opencode') = 'permission.ask'
-    'permission.ask': 'PermissionRequest',
-    // CAAMP: toNative('PreModel',           'opencode') = 'chat.params'
-    'chat.params': 'PreModel',
-    // CAAMP: toNative('PreCompact',         'opencode') = 'experimental.session.compacting'
-    'experimental.session.compacting': 'PreCompact',
-    // CAAMP: toNative('PostCompact',        'opencode') = 'event:session.compacted'
-    'event:session.compacted': 'PostCompact',
-};
-/**
- * Hook provider for OpenCode.
- *
- * OpenCode registers hooks via its JavaScript plugin system at
- * `.opencode/plugins/`. Supported handler type: plugin (JavaScript).
- *
- * Event mapping is based on `getProviderHookProfile('opencode')` from
- * CAAMP 1.9.1. Async accessors (`getSupportedCanonicalEvents`,
- * `getProviderProfile`) call CAAMP directly when available.
- *
- * Since hooks are registered through the plugin system (managed by the install
- * provider), `registerNativeHooks` and `unregisterNativeHooks` track registration
- * state without performing filesystem operations.
- *
- * @remarks
- * OpenCode uses dot-delimited and `event:`-prefixed event names
- * (e.g. `event:session.created`, `tool.execute.before`) which differ
- * significantly from the PascalCase CAAMP canonical names. The static
- * event map covers all 10 supported events. Async CAAMP accessors
- * (`getSupportedCanonicalEvents`, `getProviderProfile`, `toNativeEvent`)
- * call the normalizer directly when available and fall back to the static map.
- *
- * @task T164
- * @epic T134
- */
-export class OpenCodeHookProvider {
-    /** Whether hooks have been registered for the current session. */
-    registered = false;
-    /**
-     * Map an OpenCode native event name to a CAAMP canonical hook event name.
-     *
-     * Looks up the native event name in the map derived from
-     * `getProviderHookProfile('opencode').mappings` (CAAMP 1.9.1).
-     * Returns null for unsupported events (PostToolUseFailure, SubagentStart,
-     * SubagentStop, Notification, ConfigChange).
-     *
-     * @param providerEvent - OpenCode native event (e.g. "event:session.created", "tool.execute.before")
-     * @returns CAAMP canonical event name, or null if unmapped
-     * @task T164
-     */
-    mapProviderEvent(providerEvent) {
-        return OPENCODE_EVENT_MAP[providerEvent] ?? null;
-    }
-    /**
-     * Register native hooks for a project.
-     *
-     * For OpenCode, hooks are registered via the plugin system
-     * (`.opencode/plugins/`), managed by the install provider.
-     * This method marks hooks as registered without performing filesystem operations.
-     *
-     * Iterating supported events is handled at install time using
-     * `getSupportedCanonicalEvents()` to enumerate all 10 supported hooks.
-     *
-     * @param _projectDir - Project directory (unused; config manages registration)
-     * @task T164
-     */
-    async registerNativeHooks(_projectDir) {
-        this.registered = true;
-    }
-    /**
-     * Unregister native hooks.
-     *
-     * For OpenCode, this is a no-op since hooks are managed through the plugin
-     * system. Unregistration happens via the install provider's uninstall method.
-     *
-     * @task T164
-     */
-    async unregisterNativeHooks() {
-        this.registered = false;
-    }
-    /**
-     * Check whether hooks have been registered via `registerNativeHooks`.
-     */
-    isRegistered() {
-        return this.registered;
-    }
-    /**
-     * Get the native→canonical event mapping for introspection and debugging.
-     *
-     * Returns the map derived from `getProviderHookProfile('opencode').mappings`
-     * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
-     * names via live CAAMP APIs.
-     *
-     * @returns Immutable record of native event name → canonical event name
-     */
-    getEventMap() {
-        return { ...OPENCODE_EVENT_MAP };
-    }
-    /**
-     * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
-     *
-     * Calls `getSupportedEvents('opencode')` from the CAAMP normalizer to get the
-     * authoritative list. OpenCode supports 10 of 16 canonical events via its
-     * plugin system. Falls back to the values of the static event map when
-     * CAAMP is unavailable at runtime.
-     *
-     * @returns Array of CAAMP canonical event names supported by OpenCode
-     * @task T164
-     */
-    async getSupportedCanonicalEvents() {
-        try {
-            const { getSupportedEvents } = await import('@cleocode/caamp');
-            return getSupportedEvents(PROVIDER_ID);
-        }
-        catch {
-            return [...new Set(Object.values(OPENCODE_EVENT_MAP))];
-        }
-    }
-    /**
-     * Retrieve the full provider hook profile from CAAMP.
-     *
-     * Calls `getProviderHookProfile('opencode')` from the CAAMP normalizer to
-     * get the complete profile: hook system type (`plugin`), config path
-     * (`.opencode/plugins/`), handler types, and all event mappings.
-     * Returns null when CAAMP is unavailable at runtime.
-     *
-     * @returns Provider hook profile or null if CAAMP is unavailable
-     * @task T164
-     */
-    async getProviderProfile() {
-        try {
-            const { getProviderHookProfile } = await import('@cleocode/caamp');
-            return getProviderHookProfile(PROVIDER_ID) ?? null;
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Translate a CAAMP canonical event to its OpenCode native name via CAAMP.
-     *
-     * Calls `toNative(canonical, 'opencode')` from the CAAMP normalizer.
-     * Returns null for unsupported events or when CAAMP is unavailable.
-     *
-     * @param canonical - CAAMP canonical event name (e.g. "PreToolUse")
-     * @returns OpenCode native event name or null
-     * @task T164
-     */
-    async toNativeEvent(canonical) {
-        try {
-            const { toNative } = await import('@cleocode/caamp');
-            return toNative(canonical, PROVIDER_ID);
-        }
-        catch {
-            // Invert the static map as fallback
-            const entry = Object.entries(OPENCODE_EVENT_MAP).find(([, v]) => v === canonical);
-            return entry?.[0] ?? null;
-        }
-    }
-}
-//# sourceMappingURL=hooks.js.map

package/dist/providers/opencode/hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/opencode/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,8CAA8C;AAC9C,MAAM,WAAW,GAAG,UAAmB,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,kBAAkB,GAA2B;IACjD,8EAA8E;IAC9E,uBAAuB,EAAE,cAAc;IACvC,8EAA8E;IAC9E,uBAAuB,EAAE,YAAY;IACrC,qEAAqE;IACrE,cAAc,EAAE,cAAc;IAC9B,2EAA2E;IAC3E,oBAAoB,EAAE,kBAAkB;IACxC,4EAA4E;IAC5E,qBAAqB,EAAE,YAAY;IACnC,2EAA2E;IAC3E,oBAAoB,EAAE,aAAa;IACnC,uEAAuE;IACvE,gBAAgB,EAAE,mBAAmB;IACrC,oEAAoE;IACpE,aAAa,EAAE,UAAU;IACzB,wFAAwF;IACxF,iCAAiC,EAAE,YAAY;IAC/C,gFAAgF;IAChF,yBAAyB,EAAE,aAAa;CACzC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,oBAAoB;IAC/B,kEAAkE;IAC1D,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,kBAAkB,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IACnD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;;;;;OAQG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,2BAA2B;QAC/B,IAAI,CAAC;YACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC/D,OAAO,kBAAkB,CAAC,WAAW,CAAa,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,kBAAkB;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACnE,OAAO,sBAAsB,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACrD,OAAO,QAAQ,CAAC,SAA2C,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;YACpC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;YAClF,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/providers/opencode/index.d.ts

@@ -1,35 +0,0 @@
-/**
- * @packageDocumentation
- *
- * CLEO provider adapter for OpenCode AI coding assistant.
- * Default export is the adapter class for dynamic loading by AdapterManager.
- *
- * @task T5240
- */
-import { OpenCodeAdapter } from './adapter.js';
-export { OpenCodeAdapter } from './adapter.js';
-export { OpenCodeHookProvider } from './hooks.js';
-export { OpenCodeInstallProvider } from './install.js';
-export { OpenCodeSpawnProvider } from './spawn.js';
-export default OpenCodeAdapter;
-/**
- * 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 opencode
- * provider via its import-based discovery mechanism.
- *
- * @returns A new {@link OpenCodeAdapter} instance ready for initialization
- *
- * @example
- * ```typescript
- * import { createAdapter } from '@cleocode/adapters/providers/opencode';
- *
- * const adapter = createAdapter();
- * await adapter.initialize('/path/to/project');
- * ```
- */
-export declare function createAdapter(): OpenCodeAdapter;
-//# sourceMappingURL=index.d.ts.map

package/dist/providers/opencode/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAe,eAAe,CAAC;AAE/B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAE/C"}

package/dist/providers/opencode/index.js

@@ -1,37 +0,0 @@
-/**
- * @packageDocumentation
- *
- * CLEO provider adapter for OpenCode AI coding assistant.
- * Default export is the adapter class for dynamic loading by AdapterManager.
- *
- * @task T5240
- */
-import { OpenCodeAdapter } from './adapter.js';
-export { OpenCodeAdapter } from './adapter.js';
-export { OpenCodeHookProvider } from './hooks.js';
-export { OpenCodeInstallProvider } from './install.js';
-export { OpenCodeSpawnProvider } from './spawn.js';
-export default OpenCodeAdapter;
-/**
- * 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 opencode
- * provider via its import-based discovery mechanism.
- *
- * @returns A new {@link OpenCodeAdapter} instance ready for initialization
- *
- * @example
- * ```typescript
- * import { createAdapter } from '@cleocode/adapters/providers/opencode';
- *
- * const adapter = createAdapter();
- * await adapter.initialize('/path/to/project');
- * ```
- */
-export function createAdapter() {
-    return new OpenCodeAdapter();
-}
-//# sourceMappingURL=index.js.map

package/dist/providers/opencode/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAe,eAAe,CAAC;AAE/B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}

package/dist/providers/opencode/install.d.ts

@@ -1,56 +0,0 @@
-/**
- * OpenCode Install Provider
- *
- * Handles CLEO installation into OpenCode environments:
- * - Ensures AGENTS.md has CLEO @-references
- *
- * @task T5240
- */
-import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
-/**
- * Install provider for OpenCode.
- *
- * Manages CLEO's integration with OpenCode by:
- * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
- *
- * @remarks
- * Installation is idempotent -- running install multiple times on the same
- * project produces the same result. Only AGENTS.md is managed; OpenCode's
- * plugin system is handled separately by the hook provider.
- */
-export declare class OpenCodeInstallProvider implements AdapterInstallProvider {
-    /**
-     * Install CLEO into an OpenCode project.
-     *
-     * @param options - Installation options including project directory
-     * @returns Result describing what was installed
-     */
-    install(options: InstallOptions): Promise<InstallResult>;
-    /**
-     * Uninstall CLEO from the current OpenCode project.
-     *
-     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
-     */
-    uninstall(): Promise<void>;
-    /**
-     * Check whether CLEO is installed in the current environment.
-     *
-     * Checks for CLEO references in AGENTS.md.
-     */
-    isInstalled(): Promise<boolean>;
-    /**
-     * Ensure AGENTS.md contains @-references to CLEO instruction files.
-     *
-     * Creates AGENTS.md if it does not exist. Appends any missing references.
-     *
-     * @param projectDir - Project root directory
-     */
-    ensureInstructionReferences(projectDir: string): Promise<void>;
-    /**
-     * Update AGENTS.md with CLEO @-references.
-     *
-     * @returns true if the file was created or modified
-     */
-    private updateInstructionFile;
-}
-//# sourceMappingURL=install.d.ts.map

package/dist/providers/opencode/install.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAqB9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;CA8B9B"}

package/dist/providers/opencode/install.js

@@ -1,116 +0,0 @@
-/**
- * OpenCode Install Provider
- *
- * Handles CLEO installation into OpenCode environments:
- * - Ensures AGENTS.md has CLEO @-references
- *
- * @task T5240
- */
-import { existsSync, 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 OpenCode.
- *
- * Manages CLEO's integration with OpenCode by:
- * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
- *
- * @remarks
- * Installation is idempotent -- running install multiple times on the same
- * project produces the same result. Only AGENTS.md is managed; OpenCode's
- * plugin system is handled separately by the hook provider.
- */
-export class OpenCodeInstallProvider {
-    /**
-     * Install CLEO into an OpenCode 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();
-        let instructionFileUpdated = false;
-        const details = {};
-        // Step 1: Ensure AGENTS.md has @-references
-        instructionFileUpdated = this.updateInstructionFile(projectDir);
-        if (instructionFileUpdated) {
-            details.instructionFile = join(projectDir, 'AGENTS.md');
-        }
-        return {
-            success: true,
-            installedAt,
-            instructionFileUpdated,
-            mcpRegistered: false,
-            details,
-        };
-    }
-    /**
-     * Uninstall CLEO from the current OpenCode project.
-     *
-     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
-     */
-    async uninstall() { }
-    /**
-     * Check whether CLEO is installed in the current environment.
-     *
-     * Checks for CLEO references in AGENTS.md.
-     */
-    async isInstalled() {
-        const agentsMdPath = join(process.cwd(), 'AGENTS.md');
-        if (existsSync(agentsMdPath)) {
-            try {
-                const content = readFileSync(agentsMdPath, 'utf-8');
-                if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
-                    return true;
-                }
-            }
-            catch {
-                // Fall through
-            }
-        }
-        return false;
-    }
-    /**
-     * Ensure AGENTS.md contains @-references to CLEO instruction files.
-     *
-     * Creates AGENTS.md if it does not exist. Appends any missing references.
-     *
-     * @param projectDir - Project root directory
-     */
-    async ensureInstructionReferences(projectDir) {
-        this.updateInstructionFile(projectDir);
-    }
-    /**
-     * 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) {
-            // Append missing references
-            const separator = content.endsWith('\n') ? '' : '\n';
-            content = content + separator + refsBlock + '\n';
-        }
-        else {
-            // Create new AGENTS.md with references
-            content = refsBlock + '\n';
-        }
-        writeFileSync(agentsMdPath, content, 'utf-8');
-        return true;
-    }
-}
-//# sourceMappingURL=install.js.map

package/dist/providers/opencode/install.js.map

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

package/dist/providers/opencode/spawn.d.ts

@@ -1,94 +0,0 @@
-/**
- * OpenCode Spawn Provider
- *
- * Implements AdapterSpawnProvider for OpenCode CLI.
- * Migrated from src/core/spawn/adapters/opencode-adapter.ts
- *
- * Uses `opencode run --agent ... --format json` to spawn subagent
- * processes. Processes run detached and are tracked by PID for
- * listing and termination.
- *
- * @task T5240
- */
-import type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/contracts';
-/**
- * Build the markdown content for an OpenCode agent definition file.
- *
- * OpenCode agents are defined as markdown files with YAML frontmatter
- * in the .opencode/agent/ directory.
- *
- * @remarks
- * The generated markdown uses YAML frontmatter with `mode: subagent`
- * and `hidden: true` so the agent does not appear in OpenCode's
- * interactive agent selection menu.
- *
- * @param description - Agent description for frontmatter
- * @param instructions - Markdown instructions body
- * @returns Complete agent definition markdown with YAML frontmatter
- *
- * @example
- * ```typescript
- * import { buildOpenCodeAgentMarkdown } from '@cleocode/adapters/providers/opencode/spawn';
- *
- * const md = buildOpenCodeAgentMarkdown(
- *   'CLEO task executor',
- *   '# Subagent\n\nExecute the delegated task.',
- * );
- * ```
- */
-export declare function buildOpenCodeAgentMarkdown(description: string, instructions: string): string;
-/**
- * Spawn provider for OpenCode.
- *
- * Spawns detached OpenCode CLI processes for subagent execution.
- * Each spawn ensures a CLEO subagent definition exists, then runs
- * `opencode run --format json --agent <name> --title <title> <prompt>`
- * as a detached, unref'd child process.
- *
- * @remarks
- * Before spawning, the provider ensures a `cleo-subagent` agent definition
- * exists in `.opencode/agent/`. If the definition cannot be created, it
- * falls back to the built-in `general` agent. Processes are tracked by
- * instance ID in an in-memory map and verified via `kill(pid, 0)` liveness
- * checks.
- */
-export declare class OpenCodeSpawnProvider implements AdapterSpawnProvider {
-    /** Map of instance IDs to tracked process info. */
-    private processMap;
-    /**
-     * Check if the OpenCode CLI is available in PATH.
-     *
-     * @returns true if `opencode` is found via `which`
-     */
-    canSpawn(): Promise<boolean>;
-    /**
-     * Spawn a subagent via OpenCode CLI.
-     *
-     * Ensures the CLEO subagent definition exists in the project's
-     * .opencode/agent/ directory, then spawns a detached OpenCode
-     * process. The process runs independently of the parent.
-     *
-     * @param context - Spawn context with taskId, prompt, and options
-     * @returns Spawn result with instance ID and status
-     */
-    spawn(context: SpawnContext): Promise<SpawnResult>;
-    /**
-     * List currently running OpenCode subagent processes.
-     *
-     * Checks each tracked process via kill(pid, 0) to verify it is still alive.
-     * Dead processes are automatically cleaned from the tracking map.
-     *
-     * @returns Array of spawn results for running processes
-     */
-    listRunning(): Promise<SpawnResult[]>;
-    /**
-     * Terminate a running spawn by instance ID.
-     *
-     * Sends SIGTERM to the tracked process. If the process is not found
-     * or has already exited, this is a no-op.
-     *
-     * @param instanceId - ID of the spawn instance to terminate
-     */
-    terminate(instanceId: string): Promise<void>;
-}
-//# sourceMappingURL=spawn.d.ts.map

package/dist/providers/opencode/spawn.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiB3F;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAY5F;AA0CD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAiExD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}