@respan/cli 0.14.2 → 0.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@respan/cli",
-  "version": "0.14.2",
+  "version": "0.16.0",
   "description": "Respan CLI - manage your LLM observability from the command line",
   "type": "module",
   "main": "dist/index.js",
@@ -17,9 +17,8 @@
     "directory": "javascript-sdks/respan-cli"
   },
   "scripts": {
-    "build": "npm run generate:skill-refs && tsc && npm run build:hooks",
+    "build": "npm run clean && tsc && npm run build:hooks",
     "build:hooks": "node -e \"const{build}=require('esbuild');const hooks=['claude-code','codex-cli','gemini-cli'];Promise.all(hooks.map(h=>build({entryPoints:['src/hooks/'+h+'.ts'],bundle:true,platform:'node',target:'node18',format:'cjs',outfile:'dist/hooks/'+h+'.cjs',external:[]}))).then(()=>console.log('Hooks bundled.'))\"",
-    "generate:skill-refs": "node scripts/embed-skill-refs.mjs",
     "test": "npm run build && node --test tests/*.test.mjs",
     "clean": "rm -rf dist",
     "dev": "node --loader ts-node/esm bin/dev.js",
@@ -47,6 +46,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^7",
+    "@modelcontextprotocol/sdk": "^1.25.1",
     "@oclif/core": "^4",
     "@oclif/plugin-autocomplete": "^3",
     "@oclif/plugin-help": "^6",

package/dist/commands/integrate/claude-code.d.ts

@@ -1,25 +0,0 @@
-import { BaseCommand } from '../../lib/base-command.js';
-export default class IntegrateClaudeCode extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'customer-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'span-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'workflow-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<void>;
-    private resolveApiKey;
-}

package/dist/commands/integrate/claude-code.js

@@ -1,210 +0,0 @@
-import * as fs from 'node:fs';
-// execSync no longer needed — JS hooks don't require pip install
-import { BaseCommand } from '../../lib/base-command.js';
-import { integrateFlags, deepMerge, readJsonFile, writeJsonFile, writeTextFile, expandHome, parseAttrs, getJsHookScript, resolveScope, findProjectRoot, } from '../../lib/integrate.js';
-class IntegrateClaudeCode extends BaseCommand {
-    async run() {
-        const { flags } = await this.parse(IntegrateClaudeCode);
-        this.globalFlags = flags;
-        try {
-            const dryRun = flags['dry-run'];
-            const scope = resolveScope(flags, 'both');
-            const doLocal = scope === 'local' || scope === 'both';
-            // ── Disable mode ─────────────────────────────────────────────
-            if (flags.disable) {
-                // Remove the Stop hook entry from global settings
-                const globalSettingsPath = expandHome('~/.claude/settings.json');
-                const globalSettings = readJsonFile(globalSettingsPath);
-                const hooksSection = (globalSettings.hooks || {});
-                if (Array.isArray(hooksSection.Stop)) {
-                    hooksSection.Stop = hooksSection.Stop.filter((entry) => {
-                        const inner = Array.isArray(entry.hooks)
-                            ? entry.hooks
-                            : [];
-                        return !inner.some((h) => typeof h.command === 'string' &&
-                            (h.command.includes('respan') || h.command.includes('hook.py') || h.command.includes('claude-code')));
-                    });
-                }
-                const merged = deepMerge(globalSettings, { hooks: hooksSection });
-                if (dryRun) {
-                    this.log(`[dry-run] Would update: ${globalSettingsPath}`);
-                    this.log(JSON.stringify(merged, null, 2));
-                }
-                else {
-                    writeJsonFile(globalSettingsPath, merged);
-                    this.log(`Removed hook entry: ${globalSettingsPath}`);
-                }
-                this.log('Claude Code tracing disabled. Run "respan integrate claude-code" to re-enable.');
-                return;
-            }
-            // ── Enable mode (default) ────────────────────────────────────
-            // Verify the user is authenticated (key is read by hook from ~/.respan/)
-            this.resolveApiKey();
-            const baseUrl = flags['base-url'];
-            const projectId = flags['project-id'];
-            const customerId = flags['customer-id'];
-            const spanName = flags['span-name'];
-            const workflowName = flags['workflow-name'];
-            const attrs = parseAttrs(flags.attrs);
-            // Claude Code default: both global + local.
-            const doGlobal = scope === 'global' || scope === 'both';
-            // ── Global: hook script + registration ────────────────────────
-            if (doGlobal) {
-                // 1. Write JS hook script (no Python dependency needed)
-                const hookDir = expandHome('~/.respan/hooks');
-                const hookPath = `${hookDir}/claude-code.cjs`;
-                if (dryRun) {
-                    this.log(`[dry-run] Would write hook script to: ${hookPath}`);
-                }
-                else {
-                    writeTextFile(hookPath, getJsHookScript('claude-code'));
-                    fs.chmodSync(hookPath, 0o755);
-                    this.log(`Wrote hook script: ${hookPath}`);
-                }
-                // 2. Register Stop hook in global settings (no credentials here)
-                const globalSettingsPath = expandHome('~/.claude/settings.json');
-                const globalSettings = readJsonFile(globalSettingsPath);
-                const hookEntry = {
-                    matcher: '',
-                    hooks: [{ type: 'command', command: `node ${hookPath}` }],
-                };
-                const hooksSection = (globalSettings.hooks || {});
-                const stopHooks = Array.isArray(hooksSection.Stop)
-                    ? [...hooksSection.Stop]
-                    : [];
-                const existingIdx = stopHooks.findIndex((entry) => {
-                    const inner = Array.isArray(entry.hooks)
-                        ? entry.hooks
-                        : [];
-                    return inner.some((h) => typeof h.command === 'string' &&
-                        (h.command.includes('respan') || h.command.includes('hook.py') || h.command.includes('claude-code.js')));
-                });
-                if (existingIdx >= 0) {
-                    stopHooks[existingIdx] = hookEntry;
-                }
-                else {
-                    stopHooks.push(hookEntry);
-                }
-                const mergedGlobal = deepMerge(globalSettings, {
-                    hooks: { ...hooksSection, Stop: stopHooks },
-                });
-                if (dryRun) {
-                    this.log(`[dry-run] Would update: ${globalSettingsPath}`);
-                    this.log(JSON.stringify(mergedGlobal, null, 2));
-                }
-                else {
-                    writeJsonFile(globalSettingsPath, mergedGlobal);
-                    this.log(`Updated global settings: ${globalSettingsPath}`);
-                }
-            }
-            // ── Local: credentials + enable in .claude/settings.local.json ─
-            if (doLocal) {
-                const projectRoot = findProjectRoot();
-                const localSettingsPath = `${projectRoot}/.claude/settings.local.json`;
-                const localSettings = readJsonFile(localSettingsPath);
-                // settings.local.json: enable flag only (API key from ~/.respan/)
-                const envBlock = {
-                    TRACE_TO_RESPAN: 'true',
-                };
-                const mergedLocal = deepMerge(localSettings, { env: envBlock });
-                if (dryRun) {
-                    this.log(`[dry-run] Would update: ${localSettingsPath}`);
-                    this.log(JSON.stringify(mergedLocal, null, 2));
-                }
-                else {
-                    writeJsonFile(localSettingsPath, mergedLocal);
-                    this.log(`Updated project settings: ${localSettingsPath}`);
-                }
-                // respan.json: non-secret config (known fields + custom properties)
-                const respanConfigPath = `${projectRoot}/.claude/respan.json`;
-                const respanConfig = readJsonFile(respanConfigPath);
-                const newConfig = { ...respanConfig };
-                if (customerId) {
-                    newConfig.customer_id = customerId;
-                }
-                if (spanName) {
-                    newConfig.span_name = spanName;
-                }
-                if (workflowName) {
-                    newConfig.workflow_name = workflowName;
-                }
-                if (projectId) {
-                    newConfig.project_id = projectId;
-                }
-                // Custom attrs go as top-level keys (unknown keys = custom properties)
-                for (const [k, v] of Object.entries(attrs)) {
-                    newConfig[k] = v;
-                }
-                if (Object.keys(newConfig).length > 0) {
-                    if (dryRun) {
-                        this.log(`[dry-run] Would write: ${respanConfigPath}`);
-                        this.log(JSON.stringify(newConfig, null, 2));
-                    }
-                    else {
-                        writeJsonFile(respanConfigPath, newConfig);
-                        this.log(`Wrote Respan config: ${respanConfigPath}`);
-                    }
-                }
-            }
-            // ── Done ──────────────────────────────────────────────────────
-            this.log('');
-            if (doGlobal && doLocal) {
-                this.log('Claude Code integration complete (global hook + project config).');
-            }
-            else if (doGlobal) {
-                this.log('Claude Code global hook installed.');
-                this.log('Run without --global in a project to enable tracing there.');
-            }
-            else {
-                this.log('Claude Code tracing enabled for this project.');
-            }
-            this.log('');
-            this.log('Auth:   ~/.respan/credentials.json  (from `respan auth login`)');
-            this.log('Config: .claude/respan.json                (shareable, non-secret)');
-            this.log('');
-            this.log('Set properties via integrate flags or edit .claude/respan.json:');
-            this.log('  respan integrate claude-code --customer-id "frank" --span-name "my-app"');
-            this.log('  respan integrate claude-code --attrs \'{"team":"platform","env":"staging"}\'');
-            this.log('');
-            this.log('Override per-session with env vars:');
-            this.log('  export RESPAN_CUSTOMER_ID="your-name"');
-            this.log("  export RESPAN_METADATA='{\"task_id\":\"T-123\"}'");
-        }
-        catch (error) {
-            this.handleError(error);
-        }
-    }
-    resolveApiKey() {
-        const auth = this.getAuth();
-        if (auth.apiKey)
-            return auth.apiKey;
-        if (auth.accessToken) {
-            this.warn('Using access token (JWT) which may expire. Consider using an API key instead.');
-            return auth.accessToken;
-        }
-        this.error('No API key found. Pass --api-key, set RESPAN_API_KEY, or run: respan auth login');
-    }
-}
-IntegrateClaudeCode.description = `Integrate Respan with Claude Code.
-
-Installs a Stop hook that reads conversation transcripts and sends
-them to Respan as structured spans (chat, tool, thinking).
-
-Scope:
-  --global   Install hook script + register in ~/.claude/settings.json
-  --local    Write credentials + enable flag to .claude/settings.local.json
-
-Default behavior installs the global hook and writes local project config.`;
-IntegrateClaudeCode.examples = [
-    'respan integrate claude-code',
-    'respan integrate claude-code --disable',
-    'respan integrate claude-code --global',
-    'respan integrate claude-code --local --project-id my-project',
-    'respan integrate claude-code --attrs \'{"env":"prod"}\'',
-    'respan integrate claude-code --dry-run',
-];
-IntegrateClaudeCode.flags = {
-    ...BaseCommand.baseFlags,
-    ...integrateFlags,
-};
-export default IntegrateClaudeCode;

package/dist/commands/integrate/codex-cli.d.ts

@@ -1,33 +0,0 @@
-import { BaseCommand } from '../../lib/base-command.js';
-export default class IntegrateCodexCli extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'customer-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'span-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'workflow-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<void>;
-    /**
-     * Update or insert the `notify` line in a TOML config string.
-     *
-     * TOML bare keys must appear before the first [table] header.
-     * If a `notify` line already exists, replace it in-place.
-     * Otherwise, insert the notify line before the first [table] header.
-     */
-    private updateTomlNotify;
-    private resolveApiKey;
-}

package/dist/commands/integrate/codex-cli.js

@@ -1,191 +0,0 @@
-import * as fs from 'node:fs';
-import { BaseCommand } from '../../lib/base-command.js';
-import { integrateFlags, readTextFile, writeTextFile, writeJsonFile, readJsonFile, expandHome, parseAttrs, getJsHookScript, resolveScope, findProjectRoot, } from '../../lib/integrate.js';
-class IntegrateCodexCli extends BaseCommand {
-    async run() {
-        const { flags } = await this.parse(IntegrateCodexCli);
-        this.globalFlags = flags;
-        try {
-            const dryRun = flags['dry-run'];
-            // ── Disable mode ─────────────────────────────────────────────
-            if (flags.disable) {
-                // Remove the notify line from ~/.codex/config.toml
-                const configPath = expandHome('~/.codex/config.toml');
-                const existing = readTextFile(configPath);
-                const lines = existing.split('\n');
-                const filtered = lines.filter((line) => !/^\s*notify\s*=/.test(line) && !line.includes('respan integrate codex-cli'));
-                if (dryRun) {
-                    this.log(`[dry-run] Would update: ${configPath}`);
-                    this.log(filtered.join('\n'));
-                }
-                else {
-                    writeTextFile(configPath, filtered.join('\n'));
-                    this.log(`Removed notify hook: ${configPath}`);
-                }
-                this.log('Codex CLI tracing disabled. Run "respan integrate codex-cli" to re-enable.');
-                return;
-            }
-            // ── Enable mode (default) ────────────────────────────────────
-            // Verify the user is authenticated (key is read by hook from ~/.respan/)
-            this.resolveApiKey();
-            const projectId = flags['project-id'];
-            const customerId = flags['customer-id'];
-            const spanName = flags['span-name'];
-            const workflowName = flags['workflow-name'];
-            const attrs = parseAttrs(flags.attrs);
-            // Codex CLI default: both global + local
-            const scope = resolveScope(flags, 'both');
-            const doGlobal = scope === 'global' || scope === 'both';
-            const doLocal = scope === 'local' || scope === 'both';
-            // ── Global: hook script + notify registration ──────────────────
-            if (doGlobal) {
-                // 1. Write JS hook script (no Python dependency needed)
-                const hookDir = expandHome('~/.respan/hooks');
-                const hookPath = `${hookDir}/codex-cli.cjs`;
-                if (dryRun) {
-                    this.log(`[dry-run] Would write hook script to: ${hookPath}`);
-                }
-                else {
-                    writeTextFile(hookPath, getJsHookScript('codex-cli'));
-                    fs.chmodSync(hookPath, 0o755);
-                    this.log(`Wrote hook script: ${hookPath}`);
-                }
-                // 2. Register notify hook in ~/.codex/config.toml
-                const configPath = expandHome('~/.codex/config.toml');
-                const existing = readTextFile(configPath);
-                const notifyValue = `notify = ["node", "${hookPath}"]`;
-                const updated = this.updateTomlNotify(existing, notifyValue);
-                if (dryRun) {
-                    this.log(`[dry-run] Would update: ${configPath}`);
-                    this.log(updated);
-                }
-                else {
-                    writeTextFile(configPath, updated);
-                    this.log(`Updated config: ${configPath}`);
-                }
-            }
-            // ── Local: .codex/respan.json ──────────────────────────────────
-            if (doLocal) {
-                const projectRoot = findProjectRoot();
-                const respanConfigPath = `${projectRoot}/.codex/respan.json`;
-                const respanConfig = readJsonFile(respanConfigPath);
-                const newConfig = { ...respanConfig };
-                if (customerId) {
-                    newConfig.customer_id = customerId;
-                }
-                if (spanName) {
-                    newConfig.span_name = spanName;
-                }
-                if (workflowName) {
-                    newConfig.workflow_name = workflowName;
-                }
-                if (projectId) {
-                    newConfig.project_id = projectId;
-                }
-                // Custom attrs go as top-level keys (unknown keys = custom properties)
-                for (const [k, v] of Object.entries(attrs)) {
-                    newConfig[k] = v;
-                }
-                if (Object.keys(newConfig).length > 0) {
-                    if (dryRun) {
-                        this.log(`[dry-run] Would write: ${respanConfigPath}`);
-                        this.log(JSON.stringify(newConfig, null, 2));
-                    }
-                    else {
-                        writeJsonFile(respanConfigPath, newConfig);
-                        this.log(`Wrote Respan config: ${respanConfigPath}`);
-                    }
-                }
-            }
-            // ── Done ────────────────────────────────────────────────────────
-            this.log('');
-            if (doGlobal && doLocal) {
-                this.log('Codex CLI integration complete (global hook + project config).');
-            }
-            else if (doGlobal) {
-                this.log('Codex CLI global hook installed.');
-                this.log('Run without --global in a project to configure tracing there.');
-            }
-            else {
-                this.log('Codex CLI tracing configured for this project.');
-            }
-            this.log('');
-            this.log('Auth:   ~/.respan/credentials.json  (from `respan auth login`)');
-            this.log('Config: .codex/respan.json                 (shareable, non-secret)');
-            this.log('');
-            this.log('Set properties via integrate flags or edit .codex/respan.json:');
-            this.log('  respan integrate codex-cli --customer-id "frank" --span-name "my-app"');
-            this.log('  respan integrate codex-cli --attrs \'{"team":"platform","env":"staging"}\'');
-            this.log('');
-            this.log('Override per-session with env vars:');
-            this.log('  export RESPAN_CUSTOMER_ID="your-name"');
-            this.log("  export RESPAN_METADATA='{\"task_id\":\"T-123\"}'");
-            this.log('');
-            this.log('Debug: CODEX_RESPAN_DEBUG=true → check ~/.codex/state/respan_hook.log');
-        }
-        catch (error) {
-            this.handleError(error);
-        }
-    }
-    /**
-     * Update or insert the `notify` line in a TOML config string.
-     *
-     * TOML bare keys must appear before the first [table] header.
-     * If a `notify` line already exists, replace it in-place.
-     * Otherwise, insert the notify line before the first [table] header.
-     */
-    updateTomlNotify(existing, notifyValue) {
-        const lines = existing.split('\n');
-        // Check if notify line already exists
-        const notifyIdx = lines.findIndex((line) => /^\s*notify\s*=/.test(line));
-        if (notifyIdx >= 0) {
-            // Replace existing notify line
-            lines[notifyIdx] = notifyValue;
-            return lines.join('\n');
-        }
-        // Find the first [table] header to insert before it
-        const firstTableIdx = lines.findIndex((line) => /^\s*\[/.test(line));
-        if (firstTableIdx >= 0) {
-            // Insert notify + comment before the first table header
-            lines.splice(firstTableIdx, 0, '# Respan observability (added by respan integrate codex-cli)', notifyValue, '');
-        }
-        else {
-            // No tables at all — append to end
-            lines.push('', '# Respan observability (added by respan integrate codex-cli)', notifyValue);
-        }
-        return lines.join('\n');
-    }
-    resolveApiKey() {
-        const auth = this.getAuth();
-        if (auth.apiKey)
-            return auth.apiKey;
-        if (auth.accessToken) {
-            this.warn('Using access token (JWT) which may expire. Consider using an API key instead.');
-            return auth.accessToken;
-        }
-        this.error('No API key found. Pass --api-key, set RESPAN_API_KEY, or run: respan auth login');
-    }
-}
-IntegrateCodexCli.description = `Integrate Respan with Codex CLI.
-
-Installs a notify hook that reads session JSONL files and sends
-them to Respan as structured spans (chat, tool, reasoning).
-
-Scope:
-  --global   Install hook script + register notify in ~/.codex/config.toml
-  --local    Write .codex/respan.json with customer_id, span_name, etc.
-
-Default behavior installs the global notify hook and writes local project config.`;
-IntegrateCodexCli.examples = [
-    'respan integrate codex-cli',
-    'respan integrate codex-cli --disable',
-    'respan integrate codex-cli --global',
-    'respan integrate codex-cli --local --customer-id frank',
-    'respan integrate codex-cli --attrs \'{"env":"prod"}\'',
-    'respan integrate codex-cli --dry-run',
-];
-IntegrateCodexCli.flags = {
-    ...BaseCommand.baseFlags,
-    ...integrateFlags,
-};
-export default IntegrateCodexCli;

package/dist/commands/integrate/gemini-cli.d.ts

@@ -1,25 +0,0 @@
-import { BaseCommand } from '../../lib/base-command.js';
-export default class IntegrateGeminiCli extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'customer-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'span-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'workflow-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<void>;
-    private resolveApiKey;
-}