@respan/cli 0.14.1 → 0.15.0

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 {};