@respan/cli 0.14.1 → 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/demo/seed-prompts.js

@@ -9,19 +9,19 @@
 import { DEMO_PROMPTS } from './prompt-fixtures.js';
 /** Prompts in the account whose name exactly matches a demo fixture name.
  *
- * Queried with the `name` `iexact` filter, one query per fixture name. NOTE: the
- * `icontains`/`iexact` filters do NOT OR-match across a multi-value array — a
- * single `value: [a, b, c]` matches nothing — so each name must be queried on
- * its own. Server matching is case-insensitive, so we re-confirm with an exact,
- * case-sensitive match client-side. Returns every match (so duplicates are all
- * found, for clear). */
+ * Queried with the `name` exact-match filter (operator `''`), one query per
+ * fixture name. The backend rejects `iexact` with a 400, and `icontains` does
+ * NOT OR-match across a multi-value array — a single `value: [a, b, c]` matches
+ * nothing — so each name is queried on its own. Matches are re-confirmed
+ * client-side with an exact, case-sensitive comparison. Returns every match (so
+ * duplicates are all found, for clear). */
 async function findExistingPrompts(ctx) {
     const found = [];
     for (const fixture of DEMO_PROMPTS) {
         const response = await ctx.client.prompts.listPrompts({
             Authorization: ctx.authHeader,
             page_size: 100,
-            filters: { name: { operator: 'iexact', value: [fixture.name] } },
+            filters: { name: { operator: '', value: [fixture.name] } },
         });
         for (const row of response.results ?? []) {
             if (row.id && row.name === fixture.name) {

package/dist/lib/demo/trace-fixtures.d.ts

@@ -1,10 +1,19 @@
 /**
- * Frozen snapshot of the demo traces, supplied by the team as ready-to-POST OTLP v2
- * bodies (the `trace-bodies/` dataset: a 22-span, 6-LLM-call multi-agent AI Service
- * Desk run across two tenants). Source of truth for the traces portion of `respan demo`.
+ * Frozen snapshot of the demo traces as ready-to-POST OTLP v2 bodies: a multi-agent
+ * AI Service Desk run across two tenants, 17 spans each. Four agents (triage,
+ * identity, knowledge, notification) hand off to each other, each making one
+ * gpt-6.1-sol call and one tool call, plus a RAG embedding. Source of truth for the
+ * traces portion of `respan demo`.
  *
- * Each `body` is a complete OTLP/JSON payload for `POST /api/v2/traces`, captured
- * VERBATIM. The seeder (`seed-traces.ts`) re-stamps fresh trace/span ids and recent
+ * Span names follow the SDKs' semantic style (`llm.<model>`, `agent.<name>`,
+ * `tool.<name>`, `handoff.<from>_to_<to>`, `embedding`; see
+ * contribution/writing-instrumentations.md), and handoff spans carry
+ * `respan.entity.log_type: handoff`. Derived from the team's original
+ * `trace-bodies/` dataset by dropping the Vercel AI SDK wrapper spans
+ * (`ai.generateText`, `ai.embed`) and moving the LLM calls to gpt-6.1-sol.
+ *
+ * Each `body` is a complete OTLP/JSON payload for `POST /api/v2/traces`. The
+ * seeder (`seed-traces.ts`) re-stamps fresh trace/span ids and recent
  * timestamps on each fresh seed, and sets the root span's name to `workflow` (below)
  * so it shows in the dashboard Workflow column and is unique per trace — the dataset
  * repeats some scenarios with a byte-identical root span, and a unique root name keeps