@respan/cli 0.14.2 → 0.15.0

package/dist/commands/setup/gateway.d.ts

@@ -5,11 +5,11 @@ export default class SetupGateway extends SetupBaseCommand {
     static flags: {
         agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'no-instrument': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': 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>;

package/dist/commands/setup/gateway.js

@@ -10,11 +10,7 @@ class SetupGateway extends SetupBaseCommand {
         });
     }
 }
-SetupGateway.description = `Set up Respan gateway routing in this project.
-
-Runs the gateway setup flow directly (skips the "Tracing or Gateway?"
-question). Sets up your API key, installs the Respan skill, and optionally
-opens your coding agent to route the detected framework through the gateway.`;
+SetupGateway.description = 'Deprecated gateway setup entry point. Prints the official gateway setup prompt.';
 SetupGateway.examples = [
     'respan setup gateway',
     'respan setup gateway --agent claude-code',
@@ -23,10 +19,10 @@ SetupGateway.examples = [
 SetupGateway.flags = {
     ...SetupBaseCommand.baseFlags,
     agent: Flags.string({
-        description: 'Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)',
+        description: 'Deprecated compatibility flag; no agent is launched',
     }),
     'no-instrument': Flags.boolean({
-        description: 'Skip agent selection and opening after setup',
+        description: 'Deprecated compatibility flag; setup only prints a prompt',
         default: false,
     }),
 };

package/dist/commands/setup/index.d.ts

@@ -5,11 +5,11 @@ export default class Setup extends SetupBaseCommand {
     static flags: {
         agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'no-instrument': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': 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>;

package/dist/commands/setup/index.js

@@ -4,20 +4,14 @@ class Setup extends SetupBaseCommand {
     async run() {
         const { flags } = await this.parse(Setup);
         this.globalFlags = flags;
-        // No mode → runSetup asks "Tracing or Gateway?"
+        // No mode: print both prompts without an interactive question.
         await this.runSetup(undefined, {
             agent: flags.agent,
             noInstrument: flags['no-instrument'],
         });
     }
 }
-Setup.description = `Interactive setup wizard for Respan.
-
-Sets up your API key, installs skills and SDK docs for your preferred
-coding agents, and optionally runs a setup agent. Asks whether you want
-to set up tracing or gateway routing.
-
-This is the recommended way to get started with Respan.`;
+Setup.description = 'Deprecated setup entry point. Prints tracing and gateway setup prompts.';
 Setup.examples = [
     'npx @respan/cli setup',
     'respan setup',
@@ -29,10 +23,10 @@ Setup.examples = [
 Setup.flags = {
     ...SetupBaseCommand.baseFlags,
     agent: Flags.string({
-        description: 'Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)',
+        description: 'Deprecated compatibility flag; no agent is launched',
     }),
     'no-instrument': Flags.boolean({
-        description: 'Skip agent selection and opening after setup',
+        description: 'Deprecated compatibility flag; setup only prints a prompt',
         default: false,
     }),
 };

package/dist/commands/setup/tracing.d.ts

@@ -5,11 +5,11 @@ export default class SetupTracing extends SetupBaseCommand {
     static flags: {
         agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'no-instrument': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': 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>;

package/dist/commands/setup/tracing.js

@@ -10,11 +10,7 @@ class SetupTracing extends SetupBaseCommand {
         });
     }
 }
-SetupTracing.description = `Set up Respan SDK tracing in this project.
-
-Runs the tracing setup flow directly (skips the "Tracing or Gateway?"
-question). Sets up your API key, installs the Respan skill, and optionally
-opens your coding agent to instrument the project.`;
+SetupTracing.description = 'Deprecated tracing setup entry point. Prints the official tracing setup prompt.';
 SetupTracing.examples = [
     'respan setup tracing',
     'respan setup tracing --agent claude-code',
@@ -23,10 +19,10 @@ SetupTracing.examples = [
 SetupTracing.flags = {
     ...SetupBaseCommand.baseFlags,
     agent: Flags.string({
-        description: 'Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)',
+        description: 'Deprecated compatibility flag; no agent is launched',
     }),
     'no-instrument': Flags.boolean({
-        description: 'Skip agent selection and opening after setup',
+        description: 'Deprecated compatibility flag; setup only prints a prompt',
         default: false,
     }),
 };

package/dist/lib/setup-base-command.d.ts

@@ -1,117 +1,11 @@
 import { BaseCommand } from './base-command.js';
-import { CliTool, DetectionSignal } from './agents.js';
 export type SetupMode = 'tracing' | 'gateway';
 interface RunSetupOptions {
     agent?: string;
     noInstrument?: boolean;
 }
-/**
- * Intermediate base class for the `respan setup` family of commands
- * (`setup`, `setup tracing`, `setup gateway`).
- *
- * It deliberately sits between the concrete commands and {@link BaseCommand}
- * so that setup-only concerns (interactive prompts, the agent registry, and
- * multi-kilobyte skill content) never leak onto the root command class that
- * every other command extends.
- */
+/** Compatibility entry point. Setup instructions are maintained in the docs. */
 export declare abstract class SetupBaseCommand extends BaseCommand {
-    static baseFlags: {
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'base-url': 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>;
-        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    /**
-     * Shared setup flow for all three entry points.
-     *
-     *   1. askEndpoint()      // saved endpoint (confirm reuse) → environment prompt
-     *   2. askApiKey()        // .env → global credential → prompt
-     *   3. if mode is undefined → ask "Tracing or Gateway?" (interactive only)
-     *   4. verifyApiKey(mode) // both re-prompt on a rejected key; can pause setup
-     *   5. selectAgent()      // drives only the launch
-     *   6. installSkill()     // full bundle, for all agents, regardless of selection
-     *   7. launchAgent(mode)  // only if an agent was selected
-     */
-    protected runSetup(mode?: SetupMode, opts?: RunSetupOptions): Promise<void>;
-    /**
-     * Resolve which Respan endpoint this project should target, mirroring the
-     * environment prompt in `respan auth login`.
-     *
-     * First run: ask "Respan Platform or Enterprise?" and remember the choice.
-     * Later runs: offer the saved endpoint and confirm before reusing it, so a
-     * user who switched environments isn't silently pinned to the old one. An
-     * explicit `--base-url` flag wins and skips the prompt for scripted flows.
-     */
-    protected askEndpoint(projectRoot: string): Promise<string>;
-    /**
-     * Persist the chosen endpoint onto the existing saved credential — the same
-     * `~/.respan/credentials.json` store `auth login` uses. Only updates a
-     * credential that already exists; a first-time key is saved (with this
-     * baseUrl) later in {@link askApiKey}, so we never create a second store.
-     */
-    private rememberEndpoint;
-    /** Friendly name for the known endpoints; falls back to the raw URL. */
-    protected endpointLabel(baseUrl: string): string;
-    /** Dashboard origin that pairs with an ingest endpoint. */
-    protected dashboardUrl(baseUrl: string): string;
-    /**
-     * Pin the SDK's RESPAN_BASE_URL in `.env` when the endpoint isn't the
-     * default. The SDK already targets the Respan Platform out of the box, so we
-     * leave `.env` untouched for that choice and only write the override that a
-     * non-default endpoint actually needs (with the `/api` suffix the SDK wants).
-     */
-    protected persistBaseUrlToEnv(projectRoot: string, baseUrl: string): void;
-    /** Resolve the OTLP traces ingest URL for a base URL (with/without /api). */
-    protected resolveTracesEndpoint(baseUrl: string): string;
-    /** Resolve the gateway chat-completions URL for a base URL (with/without /api). */
-    protected resolveCompletionsEndpoint(baseUrl: string): string;
-    protected askMode(step: number): Promise<SetupMode>;
-    protected askApiKey(projectRoot: string, baseUrl?: string): Promise<string>;
-    /**
-     * Verify the key for the chosen mode. Both paths re-prompt on a rejected key
-     * and return false if the user abandons the check, so the caller can pause
-     * setup instead of reporting success with a key that doesn't work.
-     */
-    protected verifyApiKey(apiKey: string, mode: SetupMode, projectRoot: string, baseUrl: string): Promise<boolean>;
-    /** Prompt for a replacement key and persist it to the project .env. */
-    private reenterApiKey;
-    private verifyTracingKey;
-    /**
-     * Gateway verification gates on a real request succeeding: there is no
-     * credit-balance endpoint, so a 200 is the only proof of a valid key with a
-     * positive balance. A rejected key (401/403) re-prompts; any other failure
-     * loops on the user's say-so. Returns true on success, false if abandoned.
-     */
-    private verifyGatewayKey;
-    /**
-     * Build a rich demo OTLP trace that mimics a customer support agent workflow:
-     *   workflow: customer_support_pipeline
-     *     └── agent: support_agent
-     *           ├── tool: lookup_order
-     *           ├── chat: openai.chat (classify intent)
-     *           ├── tool: process_refund
-     *           ├── chat: openai.chat (generate response)
-     *           └── task: log_resolution
-     */
-    protected buildDemoTrace(email?: string): Record<string, unknown>;
-    /**
-     * Minimal chat completion sent through the gateway to prove auth + routing
-     * and drop a real logged request into the user's account.
-     */
-    protected buildDemoCompletion(): Record<string, unknown>;
-    protected selectAgent(flagAgent: CliTool | undefined, detected: DetectionSignal[]): Promise<CliTool | null>;
-    protected installSkill(): Promise<void>;
-    protected launchAgent(tool: CliTool, projectRoot: string, mode: SetupMode): Promise<void>;
-    protected logStep(num: number, label: string): void;
-    protected saveToEnv(envPath: string, existingContent: string, key: string, value: string): void;
-    protected getGitEmail(): string | undefined;
-    /**
-     * Send a lightweight setup notification (email only).
-     * This helps the team know when new users set up Respan so we can
-     * reach out and help with onboarding.
-     */
-    protected notifySetup(email?: string): Promise<void>;
+    protected runSetup(mode?: SetupMode, _opts?: RunSetupOptions): Promise<void>;
 }
 export {};