@respan/cli 0.15.0 → 0.16.0

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

@@ -1,189 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { BaseCommand } from '../../lib/base-command.js';
-import { integrateFlags, deepMerge, readJsonFile, writeJsonFile, writeTextFile, expandHome, parseAttrs, getJsHookScript, resolveScope, findProjectRoot, DEFAULT_BASE_URL, } from '../../lib/integrate.js';
-class IntegrateGeminiCli extends BaseCommand {
-    async run() {
-        const { flags } = await this.parse(IntegrateGeminiCli);
-        this.globalFlags = flags;
-        try {
-            const dryRun = flags['dry-run'];
-            const scope = resolveScope(flags, 'global');
-            // ── Disable mode ─────────────────────────────────────────────
-            if (flags.disable) {
-                // Remove respan hook entries from settings.json
-                const settingsPath = scope === 'global'
-                    ? expandHome('~/.gemini/settings.json')
-                    : path.join(findProjectRoot(), '.gemini', 'settings.json');
-                const existing = readJsonFile(settingsPath);
-                const hooksSection = (existing.hooks || {});
-                for (const eventName of ['AfterModel', 'BeforeTool', 'AfterTool']) {
-                    if (!Array.isArray(hooksSection[eventName]))
-                        continue;
-                    hooksSection[eventName] = hooksSection[eventName].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('gemini-cli')));
-                    });
-                }
-                const merged = { ...existing, hooks: hooksSection };
-                if (dryRun) {
-                    this.log(`[dry-run] Would update: ${settingsPath}`);
-                    this.log(JSON.stringify(merged, null, 2));
-                }
-                else {
-                    writeJsonFile(settingsPath, merged);
-                    this.log(`Removed hook entries: ${settingsPath}`);
-                }
-                this.log('Gemini CLI tracing disabled. Run "respan integrate gemini-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);
-            // ── 1. Install hook script ──────────────────────────────────
-            const hookDir = expandHome('~/.respan/hooks');
-            const hookPath = `${hookDir}/gemini-cli.cjs`;
-            if (dryRun) {
-                this.log(`[dry-run] Would write hook script to: ${hookPath}`);
-            }
-            else {
-                writeTextFile(hookPath, getJsHookScript('gemini-cli'));
-                fs.chmodSync(hookPath, 0o755);
-                this.log(`Wrote hook script: ${hookPath}`);
-            }
-            // ── 2. Register hooks in settings.json ────────────────────────
-            const settingsPath = scope === 'global'
-                ? expandHome('~/.gemini/settings.json')
-                : path.join(findProjectRoot(), '.gemini', 'settings.json');
-            const existing = readJsonFile(settingsPath);
-            const hookEntry = {
-                hooks: [{ type: 'command', command: `node ${hookPath}` }],
-            };
-            const hooksSection = (existing.hooks || {});
-            // Register the same hook script for AfterModel, BeforeTool, and AfterTool.
-            // AfterModel captures streaming text; BeforeTool/AfterTool capture tool
-            // names, arguments, and output for rich tool spans.
-            const hookEvents = ['AfterModel', 'BeforeTool', 'AfterTool'];
-            const updatedHooks = { ...hooksSection };
-            for (const eventName of hookEvents) {
-                const eventHooks = Array.isArray(hooksSection[eventName])
-                    ? [...hooksSection[eventName]]
-                    : [];
-                // Replace existing respan hook or add new one
-                const existingIdx = eventHooks.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('gemini_hook') || h.command.includes('gemini-cli.js')));
-                });
-                if (existingIdx >= 0) {
-                    eventHooks[existingIdx] = hookEntry;
-                }
-                else {
-                    eventHooks.push(hookEntry);
-                }
-                updatedHooks[eventName] = eventHooks;
-            }
-            // Remove legacy telemetry config (from older CLI versions) to avoid
-            // Gemini CLI sending broken OTEL requests to the wrong endpoint.
-            // The hooks handle all trace export now.
-            const mergeSource = { hooks: updatedHooks };
-            if (existing.telemetry) {
-                mergeSource.telemetry = undefined;
-            }
-            const merged = deepMerge(existing, mergeSource);
-            // Explicitly remove telemetry key if it existed
-            delete merged.telemetry;
-            // ── 3. Write respan.json with non-secret config ─────────────
-            const configPath = expandHome('~/.gemini/respan.json');
-            const respanConfig = readJsonFile(configPath);
-            const newConfig = { ...respanConfig };
-            const baseUrl = flags['base-url'];
-            if (baseUrl && baseUrl !== DEFAULT_BASE_URL) {
-                newConfig.base_url = baseUrl;
-            }
-            if (customerId)
-                newConfig.customer_id = customerId;
-            if (spanName)
-                newConfig.span_name = spanName;
-            if (workflowName)
-                newConfig.workflow_name = workflowName;
-            if (projectId)
-                newConfig.project_id = projectId;
-            for (const [k, v] of Object.entries(attrs)) {
-                newConfig[k] = v;
-            }
-            if (dryRun) {
-                this.log(`[dry-run] Would update: ${settingsPath}`);
-                this.log(JSON.stringify(merged, null, 2));
-                if (Object.keys(newConfig).length > 0) {
-                    this.log('');
-                    this.log(`[dry-run] Would write: ${configPath}`);
-                    this.log(JSON.stringify(newConfig, null, 2));
-                }
-            }
-            else {
-                writeJsonFile(settingsPath, merged);
-                this.log(`Updated settings: ${settingsPath}`);
-                if (Object.keys(newConfig).length > 0) {
-                    writeJsonFile(configPath, newConfig);
-                    this.log(`Wrote Respan config: ${configPath}`);
-                }
-            }
-            this.log('');
-            this.log(`Gemini CLI integration complete (${scope}).`);
-            this.log('');
-            this.log('Auth:   ~/.respan/credentials.json  (from `respan auth login`)');
-            this.log('Config: ~/.gemini/respan.json               (shareable, non-secret)');
-            this.log('');
-            this.log('Set properties via integrate flags or edit ~/.gemini/respan.json:');
-            this.log('  respan integrate gemini-cli --customer-id "frank" --span-name "my-app"');
-            this.log('  respan integrate gemini-cli --attrs \'{"team":"platform","env":"staging"}\'');
-        }
-        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');
-    }
-}
-IntegrateGeminiCli.description = `Integrate Respan with Gemini CLI.
-
-Installs an AfterModel hook that captures LLM request/response data
-and sends it to Respan as structured spans with model, token counts,
-and input/output.
-
-Scope:
-  --global   Write to ~/.gemini/settings.json (default)
-  --local    Write to .gemini/settings.json in project root
-
-Gemini CLI ignores workspace-level telemetry settings, so --global is the default.`;
-IntegrateGeminiCli.examples = [
-    'respan integrate gemini-cli',
-    'respan integrate gemini-cli --disable',
-    'respan integrate gemini-cli --local',
-    'respan integrate gemini-cli --project-id my-project --attrs \'{"env":"prod"}\'',
-    'respan integrate gemini-cli --dry-run',
-];
-IntegrateGeminiCli.flags = {
-    ...BaseCommand.baseFlags,
-    ...integrateFlags,
-};
-export default IntegrateGeminiCli;

package/dist/commands/integrate/opencode.d.ts

@@ -1,25 +0,0 @@
-import { BaseCommand } from '../../lib/base-command.js';
-export default class IntegrateOpencode 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/opencode.js

@@ -1,123 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { execSync } from 'node:child_process';
-import { BaseCommand } from '../../lib/base-command.js';
-import { integrateFlags, writeJsonFile, expandHome, parseAttrs, resolveScope, findProjectRoot, } from '../../lib/integrate.js';
-class IntegrateOpencode extends BaseCommand {
-    async run() {
-        const { flags } = await this.parse(IntegrateOpencode);
-        this.globalFlags = flags;
-        try {
-            const dryRun = flags['dry-run'];
-            const scope = resolveScope(flags, 'local');
-            // ── Disable mode ─────────────────────────────────────────────
-            if (flags.disable) {
-                const pluginPath = scope === 'global'
-                    ? expandHome('~/.config/opencode/plugins/otel.json')
-                    : path.join(findProjectRoot(), '.opencode', 'plugins', 'otel.json');
-                if (dryRun) {
-                    this.log(`[dry-run] Would remove: ${pluginPath}`);
-                }
-                else {
-                    try {
-                        fs.unlinkSync(pluginPath);
-                        this.log(`Removed plugin config: ${pluginPath}`);
-                    }
-                    catch {
-                        this.log(`No plugin config found at: ${pluginPath}`);
-                    }
-                }
-                this.log('OpenCode tracing disabled. Run with --enable to re-enable.');
-                return;
-            }
-            // ── Enable mode (default) ────────────────────────────────────
-            const apiKey = this.resolveApiKey();
-            const baseUrl = (flags['base-url']).replace(/\/+$/, '');
-            const projectId = flags['project-id'];
-            const attrs = parseAttrs(flags.attrs);
-            // ── 1. Install opencode-otel (always global) ─────────────────
-            if (dryRun) {
-                this.log('[dry-run] Would run: npm install -g opencode-otel');
-            }
-            else {
-                this.log('Installing opencode-otel...');
-                try {
-                    execSync('npm install -g opencode-otel', { stdio: 'pipe' });
-                    this.log('Installed opencode-otel globally.');
-                }
-                catch (err) {
-                    const msg = err instanceof Error ? err.message : String(err);
-                    this.warn(`Failed to install opencode-otel: ${msg}`);
-                    this.warn('You may need to install it manually: npm install -g opencode-otel');
-                }
-            }
-            // ── 2. Write plugin config ────────────────────────────────────
-            const pluginPath = scope === 'global'
-                ? expandHome('~/.config/opencode/plugins/otel.json')
-                : path.join(findProjectRoot(), '.opencode', 'plugins', 'otel.json');
-            const resourceAttrs = {
-                'service.name': 'opencode',
-                ...attrs,
-            };
-            if (projectId) {
-                resourceAttrs['respan.project_id'] = projectId;
-            }
-            const pluginConfig = {
-                tracesEndpoint: `${baseUrl}/v2/traces`,
-                logsEndpoint: `${baseUrl}/v2/logs`,
-                headers: {
-                    Authorization: `Bearer ${apiKey}`,
-                },
-                resourceAttributes: resourceAttrs,
-            };
-            if (dryRun) {
-                this.log(`[dry-run] Would write: ${pluginPath}`);
-                this.log(JSON.stringify(pluginConfig, null, 2));
-            }
-            else {
-                writeJsonFile(pluginPath, pluginConfig);
-                this.log(`Wrote plugin config: ${pluginPath}`);
-            }
-            // ── Done ──────────────────────────────────────────────────────
-            this.log('');
-            this.log(`OpenCode integration complete (${scope}).`);
-            this.log('');
-            this.log('Set dynamic attributes before a session:');
-            this.log('  export OTEL_RESOURCE_ATTRIBUTES="env=prod,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');
-    }
-}
-IntegrateOpencode.description = `Integrate Respan with OpenCode.
-
-OpenCode's built-in OTel does not work reliably, so this uses the
-community opencode-otel plugin instead.
-
-Scope:
-  --local    Write plugin config to project root (default)
-  --global   Write to ~/.config/opencode/plugins/otel.json
-  The opencode-otel package is always installed globally.`;
-IntegrateOpencode.examples = [
-    'respan integrate opencode',
-    'respan integrate opencode --disable',
-    'respan integrate opencode --global',
-    'respan integrate opencode --project-id my-project --attrs \'{"env":"prod"}\'',
-    'respan integrate opencode --dry-run',
-];
-IntegrateOpencode.flags = {
-    ...BaseCommand.baseFlags,
-    ...integrateFlags,
-};
-export default IntegrateOpencode;

package/dist/commands/integrate/pi.d.ts

@@ -1,28 +0,0 @@
-import { BaseCommand } from '../../lib/base-command.js';
-export default class IntegratePi extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        'workflow-name': 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>;
-        'trace-scope': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'with-collector': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'collector-port': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        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>;
-        '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/pi.js

@@ -1,198 +0,0 @@
-import { execSync } from 'node:child_process';
-import { Flags } from '@oclif/core';
-import { BaseCommand } from '../../lib/base-command.js';
-import { isBinaryInstalled } from '../../lib/agents.js';
-import { DEFAULT_BASE_URL, integrateFlags, readJsonFile, writeJsonFile, parseAttrs, resolveScope, findProjectRoot, } from '../../lib/integrate.js';
-import { PI_PACKAGE_SPEC, buildPiRespanConfig, piConfigPath, piInstallArgs, } from '../../lib/pi-integrate.js';
-import { DEFAULT_COLLECTOR_PORT, collectorBaseUrl } from '../../lib/collector.js';
-class IntegratePi extends BaseCommand {
-    async run() {
-        const { flags } = await this.parse(IntegratePi);
-        this.globalFlags = flags;
-        try {
-            const dryRun = flags['dry-run'];
-            // pi loads global packages from ~/.pi/agent, so global is the default.
-            const scope = resolveScope(flags, 'global');
-            const projectRoot = scope === 'local' ? findProjectRoot() : process.cwd();
-            const configPath = piConfigPath(scope, projectRoot);
-            // ── Disable mode ─────────────────────────────────────────────
-            if (flags.disable) {
-                const disabled = buildPiRespanConfig(readJsonFile(configPath), { enabled: false });
-                if (dryRun) {
-                    this.log(`[dry-run] Would write: ${configPath}`);
-                    this.log(JSON.stringify(disabled, null, 2));
-                }
-                else {
-                    writeJsonFile(configPath, disabled);
-                    this.log(`Disabled tracing in: ${configPath}`);
-                }
-                this.log('');
-                this.log('pi tracing disabled (the extension package stays installed). Run "respan integrate pi" to re-enable.');
-                this.log(`To uninstall the extension package: pi remove ${PI_PACKAGE_SPEC}`);
-                return;
-            }
-            // ── Enable mode (default) ────────────────────────────────────
-            // Auth precheck only — the key is read by the extension at runtime.
-            this.resolveApiKey();
-            const baseUrl = flags['base-url'];
-            const projectId = flags['project-id'];
-            const customerId = flags['customer-id'];
-            // The extension treats span_name as an alias of workflow_name.
-            const workflowName = flags['workflow-name'] ?? flags['span-name'];
-            const traceScope = flags['trace-scope'];
-            const attrs = parseAttrs(flags.attrs);
-            const withCollector = flags['with-collector'];
-            const collectorPort = flags['collector-port'] ?? DEFAULT_COLLECTOR_PORT;
-            if (flags['collector-port'] !== undefined && !withCollector) {
-                this.warn('--collector-port has no effect without --with-collector.');
-            }
-            if (withCollector && baseUrl && baseUrl.replace(/\/+$/, '') !== DEFAULT_BASE_URL) {
-                this.warn(`--with-collector overrides --base-url: traces go to ${collectorBaseUrl(collectorPort)}. ` +
-                    'Point the collector at your endpoint with `respan collector start --export-url ...`.');
-            }
-            // ── 1. Install the pi package ─────────────────────────────────
-            const installCommand = ['pi', ...piInstallArgs(scope)].join(' ');
-            if (!isBinaryInstalled('pi')) {
-                const message = 'pi is not installed. Install it with `npm install -g @earendil-works/pi-coding-agent` (see https://pi.dev)';
-                if (dryRun) {
-                    this.warn(message);
-                }
-                else {
-                    this.error(message);
-                }
-            }
-            if (dryRun) {
-                this.log(`[dry-run] Would run: ${installCommand}`);
-            }
-            else {
-                this.log(`Installing ${PI_PACKAGE_SPEC}...`);
-                try {
-                    execSync(installCommand, { stdio: 'pipe', cwd: projectRoot });
-                    this.log(`Installed ${PI_PACKAGE_SPEC} (${scope}).`);
-                }
-                catch (err) {
-                    const msg = err instanceof Error ? err.message : String(err);
-                    this.warn(`Failed to install ${PI_PACKAGE_SPEC}: ${msg}`);
-                    this.warn(`You may need to install it manually: ${installCommand}`);
-                }
-            }
-            // ── 2. Write respan.json (non-secret) ─────────────────────────
-            const config = buildPiRespanConfig(readJsonFile(configPath), {
-                enabled: true,
-                customerId,
-                workflowName,
-                projectId,
-                traceScope,
-                baseUrl,
-                collectorPort: withCollector ? collectorPort : undefined,
-                attrs,
-            });
-            if (dryRun) {
-                this.log(`[dry-run] Would write: ${configPath}`);
-                this.log(JSON.stringify(config, null, 2));
-            }
-            else {
-                writeJsonFile(configPath, config);
-                this.log(`Wrote Respan config: ${configPath}`);
-            }
-            // ── Done ──────────────────────────────────────────────────────
-            this.log('');
-            this.log(`pi integration complete (${scope}). Restart pi to load the extension.`);
-            this.log('');
-            this.log('Auth:   RESPAN_API_KEY or ~/.respan/credentials.json  (from `respan auth login`)');
-            this.log(`Config: ${configPath}  (shareable, non-secret)`);
-            if (withCollector) {
-                this.log('');
-                this.log(`Traces go through the local collector at ${collectorBaseUrl(collectorPort)} (base_url in respan.json).`);
-                this.log('Start it once per machine; it keeps running across pi sessions:');
-                this.log(`  respan collector start${collectorPort === DEFAULT_COLLECTOR_PORT ? '' : ` --port ${collectorPort}`}`);
-                this.log('Remove base_url from respan.json to send directly to Respan again.');
-            }
-            this.log('');
-            this.log('Set properties via integrate flags or edit respan.json:');
-            this.log('  respan integrate pi --customer-id "frank" --workflow-name "my-agent"');
-            this.log('  respan integrate pi --attrs \'{"team":"platform","env":"staging"}\'');
-            this.log('  respan integrate pi --trace-scope run       # one trace per prompt instead of one per session ("trace_scope")');
-            this.log('');
-            this.log('Override per-session with env vars:');
-            this.log('  export RESPAN_CUSTOMER_ID="your-name"');
-            this.log('  export RESPAN_PI_TRACE_SCOPE=run       # or session (default)');
-            this.log('  export RESPAN_PI_TRACING=false     # skip tracing for one session');
-            this.log('');
-            this.log('One-off run without installing (from a project that has the package):');
-            this.log('  pi -e ./node_modules/@respan/instrumentation-pi/dist/extension.js');
-            this.log('');
-            this.log('Debug: RESPAN_PI_DEBUG=true pi   (logs to stderr only; nothing is written to disk)');
-        }
-        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');
-    }
-}
-IntegratePi.description = `Integrate Respan with the pi coding agent (https://pi.dev).
-
-Installs the @respan/instrumentation-pi pi package — a pi extension that
-traces every agent run as one turn span per prompt with chat and tool spans underneath,
-correlating all runs of a pi session by its session id — and writes a
-non-secret respan.json config for it.
-
-Scope:
-  --global   pi install npm:@respan/instrumentation-pi + ~/.pi/agent/respan.json (default)
-  --local    pi install -l npm:@respan/instrumentation-pi + .pi/respan.json in the project root
-
-Trace scope (--trace-scope, "trace_scope" in respan.json):
-  session    one multi-root trace per pi session, across processes and pauses (default)
-  run        one trace per agent run; runs of a session share a thread id
-
-Durable delivery (--with-collector):
-  Sets base_url to a local Respan collector (http://127.0.0.1:4318) so traces
-  go through its persistent queue and survive Respan outages. Run
-  "respan collector start" once per machine.
-
-Credentials are never written to these files: the extension reads
-RESPAN_API_KEY or ~/.respan/credentials.json (from "respan auth login").`;
-IntegratePi.examples = [
-    'respan integrate pi',
-    'respan integrate pi --disable',
-    'respan integrate pi --local',
-    'respan integrate pi --customer-id frank --workflow-name email-agent',
-    'respan integrate pi --trace-scope run',
-    'respan integrate pi --with-collector',
-    'respan integrate pi --project-id my-project --attrs \'{"env":"prod"}\'',
-    'respan integrate pi --dry-run',
-];
-IntegratePi.flags = {
-    ...BaseCommand.baseFlags,
-    ...integrateFlags,
-    // The shared descriptions advertise the claude-code default; pi's is "pi".
-    'workflow-name': Flags.string({
-        description: 'traceloop.workflow.name on pi turn spans (default: pi)',
-    }),
-    'span-name': Flags.string({
-        description: 'Alias of --workflow-name (default: pi)',
-    }),
-    'trace-scope': Flags.string({
-        description: 'Trace scope: "session" = one multi-root trace per pi session (default), "run" = one trace per agent run',
-        options: ['run', 'session'],
-    }),
-    'with-collector': Flags.boolean({
-        description: 'Send traces through a local Respan collector (respan collector start) for durable delivery',
-        default: false,
-    }),
-    'collector-port': Flags.integer({
-        description: `Port of the local collector, with --with-collector (default: ${DEFAULT_COLLECTOR_PORT})`,
-        min: 1,
-        max: 65535,
-    }),
-};
-export default IntegratePi;