@cleocode/adapters 2.0.0

package/src/providers/cursor/__tests__/adapter.test.ts

@@ -0,0 +1,291 @@
+/**
+ * Tests for the Cursor adapter package.
+ *
+ * @task T5240
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { CursorAdapter } from '../adapter.js';
+import { CursorHookProvider } from '../hooks.js';
+import { CursorSpawnProvider } from '../spawn.js'; // spawn.ts still exists for direct use
+import { CursorInstallProvider } from '../install.js';
+
+vi.mock('node:fs', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('node:fs')>();
+  return {
+    ...actual,
+    existsSync: vi.fn((path: string) => {
+      if (typeof path === 'string' && path.includes('.cursor')) return true;
+      if (typeof path === 'string' && path.includes('.cursorrules')) return false;
+      return false;
+    }),
+    readFileSync: vi.fn((path: string) => {
+      if (typeof path === 'string' && path.includes('mcp.json')) {
+        return JSON.stringify({ mcpServers: { cleo: { command: 'node', args: ['mcp.js'] } } });
+      }
+      return '{}';
+    }),
+    writeFileSync: vi.fn(),
+    mkdirSync: vi.fn(),
+  };
+});
+
+describe('CursorAdapter', () => {
+  let adapter: CursorAdapter;
+
+  beforeEach(() => {
+    adapter = new CursorAdapter();
+  });
+
+  afterEach(async () => {
+    if (adapter.isInitialized()) {
+      await adapter.dispose();
+    }
+    vi.restoreAllMocks();
+  });
+
+  describe('identity', () => {
+    it('has correct id', () => {
+      expect(adapter.id).toBe('cursor');
+    });
+
+    it('has correct name', () => {
+      expect(adapter.name).toBe('Cursor');
+    });
+
+    it('has correct version', () => {
+      expect(adapter.version).toBe('1.0.0');
+    });
+  });
+
+  describe('capabilities', () => {
+    it('does not support hooks', () => {
+      expect(adapter.capabilities.supportsHooks).toBe(false);
+    });
+
+    it('has no supported hook events', () => {
+      expect(adapter.capabilities.supportedHookEvents).toHaveLength(0);
+    });
+
+    it('does not support spawn', () => {
+      expect(adapter.capabilities.supportsSpawn).toBe(false);
+    });
+
+    it('supports install', () => {
+      expect(adapter.capabilities.supportsInstall).toBe(true);
+    });
+
+    it('supports MCP', () => {
+      expect(adapter.capabilities.supportsMcp).toBe(true);
+    });
+
+    it('supports instruction files with MDC pattern', () => {
+      expect(adapter.capabilities.supportsInstructionFiles).toBe(true);
+      expect(adapter.capabilities.instructionFilePattern).toBe('.cursor/rules/*.mdc');
+    });
+  });
+
+  describe('sub-providers', () => {
+    it('provides a hook provider (stub)', () => {
+      expect(adapter.hooks).toBeInstanceOf(CursorHookProvider);
+    });
+
+    it('provides an install provider', () => {
+      expect(adapter.install).toBeInstanceOf(CursorInstallProvider);
+    });
+  });
+
+  describe('initialize', () => {
+    it('sets initialized state', async () => {
+      expect(adapter.isInitialized()).toBe(false);
+      await adapter.initialize('/tmp/test-project');
+      expect(adapter.isInitialized()).toBe(true);
+    });
+
+    it('stores project directory', async () => {
+      await adapter.initialize('/tmp/test-project');
+      expect(adapter.getProjectDir()).toBe('/tmp/test-project');
+    });
+  });
+
+  describe('dispose', () => {
+    it('resets initialized state', async () => {
+      await adapter.initialize('/tmp/test-project');
+      await adapter.dispose();
+      expect(adapter.isInitialized()).toBe(false);
+      expect(adapter.getProjectDir()).toBeNull();
+    });
+  });
+
+  describe('healthCheck', () => {
+    it('returns unhealthy when not initialized', async () => {
+      const status = await adapter.healthCheck();
+      expect(status.healthy).toBe(false);
+      expect(status.provider).toBe('cursor');
+      expect(status.details?.error).toBe('Adapter not initialized');
+    });
+
+    it('returns health status with provider id', async () => {
+      await adapter.initialize('/tmp/test-project');
+      const status = await adapter.healthCheck();
+      expect(status.provider).toBe('cursor');
+      expect(typeof status.healthy).toBe('boolean');
+    });
+
+    it('checks for .cursor directory existence', async () => {
+      await adapter.initialize('/tmp/test-project');
+      const status = await adapter.healthCheck();
+      expect(status.details?.configDirExists).toBeDefined();
+    });
+
+    it('checks for CURSOR_EDITOR env var', async () => {
+      await adapter.initialize('/tmp/test-project');
+      const status = await adapter.healthCheck();
+      expect(status.details?.editorEnvSet).toBeDefined();
+    });
+  });
+});
+
+describe('CursorHookProvider', () => {
+  let hooks: CursorHookProvider;
+
+  beforeEach(() => {
+    hooks = new CursorHookProvider();
+  });
+
+  describe('mapProviderEvent', () => {
+    it('returns null for any event (no hook support)', () => {
+      expect(hooks.mapProviderEvent('session.start')).toBeNull();
+      expect(hooks.mapProviderEvent('tool.complete')).toBeNull();
+      expect(hooks.mapProviderEvent('any-event')).toBeNull();
+      expect(hooks.mapProviderEvent('')).toBeNull();
+    });
+  });
+
+  describe('registerNativeHooks', () => {
+    it('completes without error and marks as registered', async () => {
+      expect(hooks.isRegistered()).toBe(false);
+      await hooks.registerNativeHooks('/tmp/project');
+      expect(hooks.isRegistered()).toBe(true);
+    });
+  });
+
+  describe('unregisterNativeHooks', () => {
+    it('completes without error and marks as unregistered', async () => {
+      await hooks.registerNativeHooks('/tmp/project');
+      await hooks.unregisterNativeHooks();
+      expect(hooks.isRegistered()).toBe(false);
+    });
+  });
+});
+
+describe('CursorSpawnProvider', () => {
+  let spawnProvider: CursorSpawnProvider;
+
+  beforeEach(() => {
+    spawnProvider = new CursorSpawnProvider();
+  });
+
+  describe('canSpawn', () => {
+    it('returns false (spawn not supported)', async () => {
+      const result = await spawnProvider.canSpawn();
+      expect(result).toBe(false);
+    });
+  });
+
+  describe('spawn', () => {
+    it('throws an error explaining spawn is not supported', async () => {
+      await expect(
+        spawnProvider.spawn({
+          taskId: 'T1234',
+          prompt: 'test prompt',
+        }),
+      ).rejects.toThrow('Cursor does not support subagent spawning');
+    });
+  });
+
+  describe('listRunning', () => {
+    it('returns empty array', async () => {
+      const running = await spawnProvider.listRunning();
+      expect(running).toEqual([]);
+    });
+  });
+
+  describe('terminate', () => {
+    it('handles any instance id gracefully (no-op)', async () => {
+      await expect(spawnProvider.terminate('any-id')).resolves.toBeUndefined();
+    });
+  });
+});
+
+describe('CursorInstallProvider', () => {
+  let installProvider: CursorInstallProvider;
+
+  beforeEach(() => {
+    installProvider = new CursorInstallProvider();
+  });
+
+  describe('isInstalled', () => {
+    it('returns a boolean', async () => {
+      const result = await installProvider.isInstalled();
+      expect(typeof result).toBe('boolean');
+    });
+  });
+
+  describe('install', () => {
+    it('returns a success result', async () => {
+      const result = await installProvider.install({
+        projectDir: '/tmp/test-project',
+      });
+      expect(result.success).toBe(true);
+      expect(result.installedAt).toBeTruthy();
+      expect(typeof result.instructionFileUpdated).toBe('boolean');
+      expect(typeof result.mcpRegistered).toBe('boolean');
+    });
+
+    it('registers MCP when mcpServerPath provided', async () => {
+      const result = await installProvider.install({
+        projectDir: '/tmp/test-project',
+        mcpServerPath: '/path/to/mcp-server.js',
+      });
+      expect(result.mcpRegistered).toBe(true);
+    });
+
+    it('includes instruction files in details', async () => {
+      const result = await installProvider.install({
+        projectDir: '/tmp/test-project',
+      });
+      const files = result.details?.instructionFiles as string[];
+      expect(Array.isArray(files)).toBe(true);
+      expect(files.some((f) => f.includes('cleo.mdc'))).toBe(true);
+    });
+  });
+
+  describe('uninstall', () => {
+    it('handles uninstall when not installed', async () => {
+      await expect(installProvider.uninstall()).resolves.toBeUndefined();
+    });
+  });
+
+  describe('ensureInstructionReferences', () => {
+    it('completes without error', async () => {
+      await expect(
+        installProvider.ensureInstructionReferences('/tmp/test-project'),
+      ).resolves.toBeUndefined();
+    });
+  });
+});
+
+describe('barrel exports', () => {
+  it('exports createAdapter factory function', async () => {
+    const module = await import('../index.js');
+    expect(typeof module.createAdapter).toBe('function');
+    const adapter = module.createAdapter();
+    expect(adapter).toBeInstanceOf(CursorAdapter);
+  });
+
+  it('exports CursorAdapter as default', async () => {
+    const module = await import('../index.js');
+    expect(module.default).toBe(CursorAdapter);
+  });
+});

package/src/providers/cursor/adapter.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Cursor Adapter
+ *
+ * Main CLEOProviderAdapter implementation for Cursor AI code editor.
+ * Provides install capabilities for CLEO integration. Hooks and spawn
+ * are not supported since Cursor lacks CLI-based lifecycle events
+ * and subagent spawning.
+ *
+ * @task T5240
+ */
+import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
+import { CursorHookProvider } from './hooks.js';
+import { CursorInstallProvider } from './install.js';
+/**
+ * CLEO provider adapter for Cursor AI code editor.
+ *
+ * Bridges CLEO's adapter system with Cursor's capabilities:
+ * - Install: Registers MCP server in .cursor/mcp.json and manages rule files
+ * - Hooks: Stub provider (Cursor has no lifecycle event system)
+ * - Spawn: Not supported (Cursor has no CLI for subagent spawning)
+ */
+export declare class CursorAdapter implements CLEOProviderAdapter {
+    readonly id = "cursor";
+    readonly name = "Cursor";
+    readonly version = "1.0.0";
+    capabilities: AdapterCapabilities;
+    hooks: CursorHookProvider;
+    install: CursorInstallProvider;
+    private projectDir;
+    private initialized;
+    constructor();
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * @param projectDir - Root directory of the project
+     */
+    initialize(projectDir: string): Promise<void>;
+    /**
+     * Dispose the adapter and clean up resources.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Run a health check to verify Cursor is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. .cursor/ configuration directory exists in the project
+     * 3. CURSOR_EDITOR env var is set
+     *
+     * @returns Health status with details about each check
+     */
+    healthCheck(): Promise<AdapterHealthStatus>;
+    /**
+     * Check whether the adapter has been initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the project directory this adapter was initialized with.
+     */
+    getProjectDir(): string | null;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/src/providers/cursor/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,mBAAmB;IACvD,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAa/B;IAEF,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,qBAAqB,CAAC;IAE/B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;OAIG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAwCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/src/providers/cursor/adapter.js

@@ -0,0 +1,124 @@
+/**
+ * Cursor Adapter
+ *
+ * Main CLEOProviderAdapter implementation for Cursor AI code editor.
+ * Provides install capabilities for CLEO integration. Hooks and spawn
+ * are not supported since Cursor lacks CLI-based lifecycle events
+ * and subagent spawning.
+ *
+ * @task T5240
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { CursorHookProvider } from './hooks.js';
+import { CursorInstallProvider } from './install.js';
+/**
+ * CLEO provider adapter for Cursor AI code editor.
+ *
+ * Bridges CLEO's adapter system with Cursor's capabilities:
+ * - Install: Registers MCP server in .cursor/mcp.json and manages rule files
+ * - Hooks: Stub provider (Cursor has no lifecycle event system)
+ * - Spawn: Not supported (Cursor has no CLI for subagent spawning)
+ */
+export class CursorAdapter {
+    id = 'cursor';
+    name = 'Cursor';
+    version = '1.0.0';
+    capabilities = {
+        supportsHooks: false,
+        supportedHookEvents: [],
+        supportsSpawn: false,
+        supportsInstall: true,
+        supportsMcp: true,
+        supportsInstructionFiles: true,
+        instructionFilePattern: '.cursor/rules/*.mdc',
+        supportsContextMonitor: false,
+        supportsStatusline: false,
+        supportsProviderPaths: true,
+        supportsTransport: false,
+        supportsTaskSync: false,
+    };
+    hooks;
+    install;
+    projectDir = null;
+    initialized = false;
+    constructor() {
+        this.hooks = new CursorHookProvider();
+        this.install = new CursorInstallProvider();
+    }
+    /**
+     * 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 clean up resources.
+     */
+    async dispose() {
+        if (this.hooks.isRegistered()) {
+            await this.hooks.unregisterNativeHooks();
+        }
+        this.initialized = false;
+        this.projectDir = null;
+    }
+    /**
+     * Run a health check to verify Cursor is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. .cursor/ configuration directory exists in the project
+     * 3. CURSOR_EDITOR env var is set
+     *
+     * @returns Health status with details about each check
+     */
+    async healthCheck() {
+        const details = {};
+        if (!this.initialized) {
+            return {
+                healthy: false,
+                provider: this.id,
+                details: { error: 'Adapter not initialized' },
+            };
+        }
+        // Check for Cursor config directory in the project
+        let configExists = false;
+        if (this.projectDir) {
+            const cursorConfigDir = join(this.projectDir, '.cursor');
+            configExists = existsSync(cursorConfigDir);
+            details.configDirExists = configExists;
+        }
+        // Check for CURSOR_EDITOR env var
+        const editorEnvSet = process.env.CURSOR_EDITOR !== undefined;
+        details.editorEnvSet = editorEnvSet;
+        // Check for legacy .cursorrules file
+        if (this.projectDir) {
+            const legacyRulesExist = existsSync(join(this.projectDir, '.cursorrules'));
+            details.legacyRulesExist = legacyRulesExist;
+        }
+        // Healthy if we detect Cursor presence (config dir or env var)
+        const healthy = configExists || editorEnvSet;
+        details.detected = healthy;
+        return {
+            healthy,
+            provider: this.id,
+            details,
+        };
+    }
+    /**
+     * 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/src/providers/cursor/adapter.js.map

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

package/src/providers/cursor/adapter.ts

@@ -0,0 +1,145 @@
+/**
+ * Cursor Adapter
+ *
+ * Main CLEOProviderAdapter implementation for Cursor AI code editor.
+ * Provides install capabilities for CLEO integration. Hooks and spawn
+ * are not supported since Cursor lacks CLI-based lifecycle events
+ * and subagent spawning.
+ *
+ * @task T5240
+ */
+
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import type {
+  AdapterCapabilities,
+  AdapterHealthStatus,
+  CLEOProviderAdapter,
+} from '@cleocode/contracts';
+import { CursorHookProvider } from './hooks.js';
+import { CursorInstallProvider } from './install.js';
+
+/**
+ * CLEO provider adapter for Cursor AI code editor.
+ *
+ * Bridges CLEO's adapter system with Cursor's capabilities:
+ * - Install: Registers MCP server in .cursor/mcp.json and manages rule files
+ * - Hooks: Stub provider (Cursor has no lifecycle event system)
+ * - Spawn: Not supported (Cursor has no CLI for subagent spawning)
+ */
+export class CursorAdapter implements CLEOProviderAdapter {
+  readonly id = 'cursor';
+  readonly name = 'Cursor';
+  readonly version = '1.0.0';
+
+  capabilities: AdapterCapabilities = {
+    supportsHooks: false,
+    supportedHookEvents: [],
+    supportsSpawn: false,
+    supportsInstall: true,
+    supportsMcp: true,
+    supportsInstructionFiles: true,
+    instructionFilePattern: '.cursor/rules/*.mdc',
+    supportsContextMonitor: false,
+    supportsStatusline: false,
+    supportsProviderPaths: true,
+    supportsTransport: false,
+    supportsTaskSync: false,
+  };
+
+  hooks: CursorHookProvider;
+  install: CursorInstallProvider;
+
+  private projectDir: string | null = null;
+  private initialized = false;
+
+  constructor() {
+    this.hooks = new CursorHookProvider();
+    this.install = new CursorInstallProvider();
+  }
+
+  /**
+   * Initialize the adapter for a given project directory.
+   *
+   * @param projectDir - Root directory of the project
+   */
+  async initialize(projectDir: string): Promise<void> {
+    this.projectDir = projectDir;
+    this.initialized = true;
+  }
+
+  /**
+   * Dispose the adapter and clean up resources.
+   */
+  async dispose(): Promise<void> {
+    if (this.hooks.isRegistered()) {
+      await this.hooks.unregisterNativeHooks();
+    }
+    this.initialized = false;
+    this.projectDir = null;
+  }
+
+  /**
+   * Run a health check to verify Cursor is accessible.
+   *
+   * Checks:
+   * 1. Adapter has been initialized
+   * 2. .cursor/ configuration directory exists in the project
+   * 3. CURSOR_EDITOR env var is set
+   *
+   * @returns Health status with details about each check
+   */
+  async healthCheck(): Promise<AdapterHealthStatus> {
+    const details: Record<string, unknown> = {};
+
+    if (!this.initialized) {
+      return {
+        healthy: false,
+        provider: this.id,
+        details: { error: 'Adapter not initialized' },
+      };
+    }
+
+    // Check for Cursor config directory in the project
+    let configExists = false;
+    if (this.projectDir) {
+      const cursorConfigDir = join(this.projectDir, '.cursor');
+      configExists = existsSync(cursorConfigDir);
+      details.configDirExists = configExists;
+    }
+
+    // Check for CURSOR_EDITOR env var
+    const editorEnvSet = process.env.CURSOR_EDITOR !== undefined;
+    details.editorEnvSet = editorEnvSet;
+
+    // Check for legacy .cursorrules file
+    if (this.projectDir) {
+      const legacyRulesExist = existsSync(join(this.projectDir, '.cursorrules'));
+      details.legacyRulesExist = legacyRulesExist;
+    }
+
+    // Healthy if we detect Cursor presence (config dir or env var)
+    const healthy = configExists || editorEnvSet;
+    details.detected = healthy;
+
+    return {
+      healthy,
+      provider: this.id,
+      details,
+    };
+  }
+
+  /**
+   * Check whether the adapter has been initialized.
+   */
+  isInitialized(): boolean {
+    return this.initialized;
+  }
+
+  /**
+   * Get the project directory this adapter was initialized with.
+   */
+  getProjectDir(): string | null {
+    return this.projectDir;
+  }
+}

package/src/providers/cursor/hooks.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Cursor Hook Provider
+ *
+ * Cursor does not have a native hook/event system for external tools.
+ * This provider returns null for all event mappings and marks hooks
+ * as unsupported. It exists to satisfy the AdapterHookProvider contract
+ * so the adapter can be used uniformly by the AdapterManager.
+ *
+ * @task T5240
+ */
+import type { AdapterHookProvider } from '@cleocode/contracts';
+/**
+ * Hook provider for Cursor (stub).
+ *
+ * Cursor lacks a hook-based lifecycle event system. All mapping
+ * operations return null. Registration is a no-op.
+ */
+export declare class CursorHookProvider implements AdapterHookProvider {
+    private registered;
+    /**
+     * Map a provider event name to a CAAMP hook event name.
+     *
+     * Always returns null since Cursor does not emit hook events.
+     *
+     * @param _providerEvent - Ignored; Cursor has no hook events
+     * @returns null (no mapping available)
+     */
+    mapProviderEvent(_providerEvent: string): string | null;
+    /**
+     * Register native hooks for a project.
+     *
+     * No-op for Cursor since it has no hook system.
+     *
+     * @param _projectDir - Ignored
+     */
+    registerNativeHooks(_projectDir: string): Promise<void>;
+    /**
+     * Unregister native hooks.
+     *
+     * No-op for Cursor since it has no hook system.
+     */
+    unregisterNativeHooks(): Promise<void>;
+    /**
+     * Check whether hooks have been registered.
+     */
+    isRegistered(): boolean;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/src/providers/cursor/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;OAOG;IACH,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIvD;;;;;;OAMG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;CAGxB"}