@mcowger/plexus-cli 0.0.1 → 0.0.2

package/README.md

@@ -0,0 +1,46 @@
+# Plexus CLI
+
+`@mcowger/plexus-cli` is a Bun-powered command-line client for the Plexus
+management API. It discovers the target server's OpenAPI document at runtime,
+so documented management operations are available without a CLI update.
+
+## Install or run
+
+Run once with Bun:
+
+```bash
+bunx @mcowger/plexus-cli api list
+```
+
+Or install the `plexuscli` command globally:
+
+```bash
+bun install -g @mcowger/plexus-cli
+plexuscli --help
+```
+
+## Connect to Plexus
+
+Set the target URL and management key. The local Plexus dev stack defaults to
+`password`; use a real admin key for non-local instances.
+
+```bash
+export PLEXUS_URL=http://localhost:4000
+export PLEXUS_ADMIN_KEY=password
+
+plexuscli api call getV0ManagementAuthVerify
+plexuscli api list
+```
+
+Use `--url` and `--admin-key` to override the environment for one invocation.
+
+## Agent guidance
+
+Print the packaged skill for complete operational and safety guidance:
+
+```bash
+plexuscli skill > SKILL.md
+```
+
+The skill covers discovery, JSON request bodies, paginated reads, debug traces,
+errors, system logs, and runtime logging/debug configuration.

package/package.json

@@ -1,13 +1,25 @@
 {
   "name": "@mcowger/plexus-cli",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Dynamic command line client for Plexus management APIs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mcowger/plexus"
+  },
   "type": "module",
   "bin": {
-    "plexuscli": "./src/index.ts"
+    "plexuscli": "src/index.ts"
   },
+  "files": [
+    "README.md",
+    "skills",
+    "src/cli.ts",
+    "src/index.ts",
+    "src/skill.ts"
+  ],
   "scripts": {
     "start": "bun run src/index.ts",
+    "prepack": "bun run --cwd ../.. sync:cli-skill",
     "typecheck": "bun x tsc --noEmit",
     "test": "bunx --bun vitest run"
   },

package/skills/plexus-cli/SKILL.md

@@ -0,0 +1,192 @@
+---
+name: plexus-cli
+description: >-
+  Use this skill to inspect or administer a running Plexus instance through
+  plexuscli. Use it before plexus-rest-api whenever `bun run plexuscli` or
+  `plexuscli` is available; it is the preferred interface for live
+  request/debug-trace/error/system-log review and runtime configuration.
+---
+
+# Plexus Management CLI
+
+Use `plexuscli` to call the Management API. The CLI discovers the running
+server's public OpenAPI document on each invocation, so use `api list` and
+`api describe` when an operation ID is uncertain.
+
+## Preference
+
+Use this skill whenever either `bun run plexuscli --help` or
+`plexuscli --help` succeeds. Use `plexus-rest-api` only when neither command
+is available or when this CLI intentionally does not support the required API
+operation, such as SSE streaming.
+
+## Local Dev Setup
+
+Get the active worktree server port; do not derive it manually:
+
+```bash
+PORT=$(bun run dev:get:port)
+export PLEXUS_URL="http://localhost:$PORT"
+```
+
+The standard local dev stack uses `password` as its admin key. This is for
+local development only; never assume it for staging or production.
+
+```bash
+export PLEXUS_ADMIN_KEY=password
+```
+
+Run the checkout-local CLI:
+
+```bash
+PLEXUSCLI='bun run plexuscli'
+```
+
+After installation, use `PLEXUSCLI=plexuscli` instead. Verify access before
+making a change:
+
+```bash
+$PLEXUSCLI api call getV0ManagementAuthVerify
+```
+
+For a remote instance, require `PLEXUS_URL` and `PLEXUS_ADMIN_KEY` from the
+user. Never print a supplied key. The CLI does not redact API responses, so
+avoid broad key/config reads unless the user requested them.
+
+## CLI Conventions
+
+- `api list` prints the available supported management operations.
+- `api describe <operationId>` shows parameters and body requirements.
+- `api call <operationId>` invokes an operation. An operation ID alone is a
+  shorthand for `api call`.
+- Use `--param name=value` for path/query parameters. JSON literals are
+  coerced, so `--param limit=50` is numeric and
+  `--param fields='["requestId"]'` is an array.
+- Use `--body '{...}'` or `--body-file payload.json` for writes.
+- Use `--output json|yaml|table`. Non-interactive output defaults to JSON;
+  interactive output defaults to a deterministic table.
+- Use `--all` only for standardized paginated list operations.
+- `DELETE` and operations named delete, restore, restart, reset, clear,
+  rotate, or disable prompt for confirmation. Use `--yes` only when the user
+  explicitly requested that action.
+- The CLI deliberately hides SSE operations, including live system-log
+  streaming. Use the recent-log endpoint instead.
+
+## Common Read Workflows
+
+### Inspect Available Operations
+
+```bash
+$PLEXUSCLI api list --output table
+$PLEXUSCLI api describe getV0ManagementDebugLogs --output yaml
+```
+
+### Review Debug Trace Configuration
+
+Debug capture configuration is in memory and resets when Plexus restarts.
+Capture is inclusive: global capture, key targets, alias targets, and provider
+targets each independently cause a trace to be captured.
+
+```bash
+$PLEXUSCLI api call getV0ManagementDebug
+```
+
+### Review Recent Debug Traces
+
+List newest traces, then request the full trace by ID:
+
+```bash
+$PLEXUSCLI api call getV0ManagementDebugLogs --param limit=50
+
+$PLEXUSCLI api call getV0ManagementDebugLogsByrequestId \
+  --param requestId='<request-id>' \
+  --output json
+```
+
+Trace payloads and headers can contain customer data or secrets. Report only
+the specific redacted fields needed to diagnose the issue.
+
+### Review Inference Errors
+
+```bash
+$PLEXUSCLI api call getV0ManagementErrors --param limit=50
+
+# Retrieve every documented error page only when the user needs the full set.
+$PLEXUSCLI api call getV0ManagementErrors --all --param limit=100
+```
+
+### Review Recent System Logs
+
+```bash
+$PLEXUSCLI api call getV0SystemLogsRecent --param limit=100
+
+$PLEXUSCLI api call getV0SystemLogsRecent --all --param limit=100
+```
+
+The recent-log endpoint is bounded in memory. It is not a persistent audit
+log, and `--all` can only retrieve entries the server still retains.
+
+## Runtime Configuration Workflows
+
+Inspect the current state before changing it. State the intended change to the
+user, then send the smallest PATCH/PUT body that satisfies the API.
+
+### Adjust Debug Trace Capture
+
+Enable temporary global capture:
+
+```bash
+$PLEXUSCLI api call patchV0ManagementDebug --body '{"enabled":true}'
+```
+
+Capture only selected request dimensions while global capture stays off:
+
+```bash
+$PLEXUSCLI api call patchV0ManagementDebug \
+  --body '{"enabled":false,"keys":["mobile-app"],"aliases":["support"],"providers":["openai"]}'
+```
+
+Clear provider targeting and disable global capture after the investigation:
+
+```bash
+$PLEXUSCLI api call patchV0ManagementDebug \
+  --body '{"enabled":false,"providers":null}'
+```
+
+`keys`, `aliases`, and `providers` replace their corresponding target lists;
+send `null` or `[]` to clear one. Do not leave broad debug capture enabled
+longer than required.
+
+### Adjust Runtime Log Verbosity
+
+Read the current and startup log levels:
+
+```bash
+$PLEXUSCLI api call getV0ManagementLoggingLevel
+```
+
+Increase temporary detail:
+
+```bash
+$PLEXUSCLI api call putV0ManagementLoggingLevel --body '{"level":"debug"}'
+```
+
+Valid levels, least to most verbose: `error`, `warn`, `info`, `debug`,
+`verbose`, `silly`. The setting is runtime-only and reverts on restart.
+
+Reset it to the startup default only when explicitly requested:
+
+```bash
+$PLEXUSCLI api call deleteV0ManagementLoggingLevel --yes
+```
+
+## Failure Handling
+
+- If spec discovery fails, confirm the URL with `bun run dev:get:port` locally
+  or ask for the remote base URL.
+- If an operation ID is unavailable, run `api list`; do not guess a path or
+  substitute raw HTTP requests.
+- On HTTP validation errors, report the exact response and stop rather than
+  guessing a new payload.
+- For a 401/403, verify the correct `PLEXUS_ADMIN_KEY` was supplied and do not
+  retry with unrelated credentials.

package/src/cli.ts

@@ -1,3 +1,5 @@
+import { plexusCliSkill } from './skill';
+
 export const DEFAULT_URL = 'http://localhost:4000';
 const OPENAPI_PATH = '/.well-known/plexus/openapi.json';
 const ALLOWED_PATH = /^\/v0\/(management\/|system\/logs\/)/;
@@ -115,15 +117,24 @@ export function discoverOperations(document: {
   const candidates: Operation[] = [];
   for (const [path, pathItem] of Object.entries(document.paths ?? {})) {
     if (!ALLOWED_PATH.test(path)) continue;
+    const pathParameters = Array.isArray(pathItem.parameters)
+      ? (pathItem.parameters as OpenApiParameter[])
+      : [];
     for (const [method, value] of Object.entries(pathItem)) {
       if (!HTTP_METHODS.has(method) || !value || typeof value !== 'object') continue;
       const operation = value as OpenApiOperation;
       if (isStreamOperation(operation)) continue;
+      const parameters = new Map(
+        pathParameters.map((parameter) => [`${parameter.in}:${parameter.name}`, parameter])
+      );
+      for (const parameter of operation.parameters ?? []) {
+        parameters.set(`${parameter.in}:${parameter.name}`, parameter);
+      }
       candidates.push({
         id: operation.operationId ?? fallbackId(method, path, operation.tags),
         method,
         path,
-        operation,
+        operation: { ...operation, parameters: [...parameters.values()] },
       });
     }
   }
@@ -278,7 +289,7 @@ async function fetchAllPages(
     limit ??= page.data.length;
     if (!limit || page.data.length === 0) break;
     allData.push(...page.data);
-    offset += limit;
+    offset += page.data.length;
   }
 
   return { data: allData, total: total ?? allData.length, limit: limit ?? 0, offset: 0 };
@@ -290,7 +301,15 @@ export function formatOutput(value: unknown, output: 'json' | 'yaml' | 'table'):
   return `${JSON.stringify(value, null, 2)}\n`;
 }
 
-const HELP = `Usage: plexuscli [options] api <list|describe|call> [operation]
+const HELP = `Usage: plexuscli [options] <skill|api> [operation]
+
+AGENTS: Run \`plexuscli skill\` to print the \`plexus-cli\` skill and understand how to use this tool.
+
+Commands:
+  skill                  Print the bundled plexus-cli SKILL.md
+  api list               List discovered management operations
+  api describe OPERATION Describe a discovered operation
+  api call OPERATION     Call a discovered operation
 
 Options:
   --url URL              Plexus URL (default: PLEXUS_URL or ${DEFAULT_URL})
@@ -325,6 +344,10 @@ export async function run(
       runtime.stdout(HELP);
       return 0;
     }
+    if (args.positionals.length === 1 && args.positionals[0] === 'skill') {
+      runtime.stdout(plexusCliSkill);
+      return 0;
+    }
     const baseUrl = args.url.replace(/\/$/, '');
     const specResponse = await runtime.fetch(`${baseUrl}${OPENAPI_PATH}`, { cache: 'no-store' });
     if (!specResponse.ok)
@@ -391,6 +414,8 @@ export async function run(
     if (args.adminKey) request.headers.set('x-admin-key', args.adminKey);
     if (body) request.headers.set('content-type', 'application/json');
     if (args.all) {
+      if (operation.method !== 'get')
+        throw new CliError('--all can only be used with GET operations');
       if (body) throw new CliError('--all cannot be used with a request body');
       runtime.stdout(
         formatOutput(

package/src/skill.ts

@@ -0,0 +1 @@
+export const plexusCliSkill = "---\nname: plexus-cli\ndescription: >-\n  Use this skill to inspect or administer a running Plexus instance through\n  plexuscli. Use it before plexus-rest-api whenever `bun run plexuscli` or\n  `plexuscli` is available; it is the preferred interface for live\n  request/debug-trace/error/system-log review and runtime configuration.\n---\n\n# Plexus Management CLI\n\nUse `plexuscli` to call the Management API. The CLI discovers the running\nserver's public OpenAPI document on each invocation, so use `api list` and\n`api describe` when an operation ID is uncertain.\n\n## Preference\n\nUse this skill whenever either `bun run plexuscli --help` or\n`plexuscli --help` succeeds. Use `plexus-rest-api` only when neither command\nis available or when this CLI intentionally does not support the required API\noperation, such as SSE streaming.\n\n## Local Dev Setup\n\nGet the active worktree server port; do not derive it manually:\n\n```bash\nPORT=$(bun run dev:get:port)\nexport PLEXUS_URL=\"http://localhost:$PORT\"\n```\n\nThe standard local dev stack uses `password` as its admin key. This is for\nlocal development only; never assume it for staging or production.\n\n```bash\nexport PLEXUS_ADMIN_KEY=password\n```\n\nRun the checkout-local CLI:\n\n```bash\nPLEXUSCLI='bun run plexuscli'\n```\n\nAfter installation, use `PLEXUSCLI=plexuscli` instead. Verify access before\nmaking a change:\n\n```bash\n$PLEXUSCLI api call getV0ManagementAuthVerify\n```\n\nFor a remote instance, require `PLEXUS_URL` and `PLEXUS_ADMIN_KEY` from the\nuser. Never print a supplied key. The CLI does not redact API responses, so\navoid broad key/config reads unless the user requested them.\n\n## CLI Conventions\n\n- `api list` prints the available supported management operations.\n- `api describe <operationId>` shows parameters and body requirements.\n- `api call <operationId>` invokes an operation. An operation ID alone is a\n  shorthand for `api call`.\n- Use `--param name=value` for path/query parameters. JSON literals are\n  coerced, so `--param limit=50` is numeric and\n  `--param fields='[\"requestId\"]'` is an array.\n- Use `--body '{...}'` or `--body-file payload.json` for writes.\n- Use `--output json|yaml|table`. Non-interactive output defaults to JSON;\n  interactive output defaults to a deterministic table.\n- Use `--all` only for standardized paginated list operations.\n- `DELETE` and operations named delete, restore, restart, reset, clear,\n  rotate, or disable prompt for confirmation. Use `--yes` only when the user\n  explicitly requested that action.\n- The CLI deliberately hides SSE operations, including live system-log\n  streaming. Use the recent-log endpoint instead.\n\n## Common Read Workflows\n\n### Inspect Available Operations\n\n```bash\n$PLEXUSCLI api list --output table\n$PLEXUSCLI api describe getV0ManagementDebugLogs --output yaml\n```\n\n### Review Debug Trace Configuration\n\nDebug capture configuration is in memory and resets when Plexus restarts.\nCapture is inclusive: global capture, key targets, alias targets, and provider\ntargets each independently cause a trace to be captured.\n\n```bash\n$PLEXUSCLI api call getV0ManagementDebug\n```\n\n### Review Recent Debug Traces\n\nList newest traces, then request the full trace by ID:\n\n```bash\n$PLEXUSCLI api call getV0ManagementDebugLogs --param limit=50\n\n$PLEXUSCLI api call getV0ManagementDebugLogsByrequestId \\\n  --param requestId='<request-id>' \\\n  --output json\n```\n\nTrace payloads and headers can contain customer data or secrets. Report only\nthe specific redacted fields needed to diagnose the issue.\n\n### Review Inference Errors\n\n```bash\n$PLEXUSCLI api call getV0ManagementErrors --param limit=50\n\n# Retrieve every documented error page only when the user needs the full set.\n$PLEXUSCLI api call getV0ManagementErrors --all --param limit=100\n```\n\n### Review Recent System Logs\n\n```bash\n$PLEXUSCLI api call getV0SystemLogsRecent --param limit=100\n\n$PLEXUSCLI api call getV0SystemLogsRecent --all --param limit=100\n```\n\nThe recent-log endpoint is bounded in memory. It is not a persistent audit\nlog, and `--all` can only retrieve entries the server still retains.\n\n## Runtime Configuration Workflows\n\nInspect the current state before changing it. State the intended change to the\nuser, then send the smallest PATCH/PUT body that satisfies the API.\n\n### Adjust Debug Trace Capture\n\nEnable temporary global capture:\n\n```bash\n$PLEXUSCLI api call patchV0ManagementDebug --body '{\"enabled\":true}'\n```\n\nCapture only selected request dimensions while global capture stays off:\n\n```bash\n$PLEXUSCLI api call patchV0ManagementDebug \\\n  --body '{\"enabled\":false,\"keys\":[\"mobile-app\"],\"aliases\":[\"support\"],\"providers\":[\"openai\"]}'\n```\n\nClear provider targeting and disable global capture after the investigation:\n\n```bash\n$PLEXUSCLI api call patchV0ManagementDebug \\\n  --body '{\"enabled\":false,\"providers\":null}'\n```\n\n`keys`, `aliases`, and `providers` replace their corresponding target lists;\nsend `null` or `[]` to clear one. Do not leave broad debug capture enabled\nlonger than required.\n\n### Adjust Runtime Log Verbosity\n\nRead the current and startup log levels:\n\n```bash\n$PLEXUSCLI api call getV0ManagementLoggingLevel\n```\n\nIncrease temporary detail:\n\n```bash\n$PLEXUSCLI api call putV0ManagementLoggingLevel --body '{\"level\":\"debug\"}'\n```\n\nValid levels, least to most verbose: `error`, `warn`, `info`, `debug`,\n`verbose`, `silly`. The setting is runtime-only and reverts on restart.\n\nReset it to the startup default only when explicitly requested:\n\n```bash\n$PLEXUSCLI api call deleteV0ManagementLoggingLevel --yes\n```\n\n## Failure Handling\n\n- If spec discovery fails, confirm the URL with `bun run dev:get:port` locally\n  or ask for the remote base URL.\n- If an operation ID is unavailable, run `api list`; do not guess a path or\n  substitute raw HTTP requests.\n- On HTTP validation errors, report the exact response and stop rather than\n  guessing a new payload.\n- For a 401/403, verify the correct `PLEXUS_ADMIN_KEY` was supplied and do not\n  retry with unrelated credentials.\n";

package/src/__tests__/cli.test.ts

@@ -1,177 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import {
-  buildRequest,
-  discoverOperations,
-  formatOutput,
-  isRisky,
-  parseArgs,
-  run,
-  type Json,
-  type Operation,
-} from '../cli';
-
-const document = {
-  paths: {
-    '/v0/management/keys/{id}': {
-      delete: {
-        operationId: 'deleteKey',
-        parameters: [{ name: 'id', in: 'path', required: true }],
-      },
-      get: { operationId: 'getKey', tags: ['Keys'] },
-    },
-    '/v0/system/logs/stream': {
-      get: {
-        operationId: 'streamLogs',
-        responses: { 200: { content: { 'text/event-stream': {} } } },
-      },
-    },
-    '/v1/models': { get: { operationId: 'listModels' } },
-  },
-};
-
-describe('dynamic OpenAPI routing', () => {
-  it('limits discovery to supported non-stream operations', () => {
-    expect(discoverOperations(document).map((operation) => operation.id)).toEqual([
-      'deleteKey',
-      'getKey',
-    ]);
-  });
-
-  it('builds encoded path and query parameters', () => {
-    const operation: Operation = {
-      id: 'get',
-      method: 'get',
-      path: '/v0/management/items/{id}',
-      operation: {
-        parameters: [
-          { name: 'id', in: 'path', required: true },
-          { name: 'limit', in: 'query' },
-        ],
-      },
-    };
-    const request = buildRequest(
-      operation,
-      new Map([
-        ['id', 'a/b' as Json],
-        ['limit', 10 as Json],
-      ])
-    );
-    expect(request.url).toBe('/v0/management/items/a%2Fb?limit=10');
-  });
-
-  it('recognizes destructive operations', () => {
-    expect(isRisky(discoverOperations(document)[0]!)).toBe(true);
-  });
-});
-
-describe('arguments and output', () => {
-  it('uses environment defaults and coerces JSON literal parameters', () => {
-    const args = parseArgs(['api', 'call', 'getKey', '--param', 'limit=10'], {
-      PLEXUS_URL: 'http://plexus',
-    });
-    expect(args.url).toBe('http://plexus');
-    expect(args.params.get('limit')).toBe(10);
-  });
-
-  it('parses the all-pages flag', () => {
-    expect(parseArgs(['api', 'call', 'getKey', '--all'], {}).all).toBe(true);
-  });
-
-  it('formats tables with deterministic columns', () => {
-    expect(formatOutput([{ b: 2, a: 'one' }], 'table')).toBe('a    b\n---  -\none  2\n');
-  });
-});
-
-describe('execution', () => {
-  it('fetches the schema without caching and uses JSON for non-TTY output', async () => {
-    const requests: Array<{ url: string; init?: RequestInit }> = [];
-    let stdout = '';
-    const exitCode = await run(
-      ['api', 'call', 'getKey'],
-      {},
-      {
-        fetch: async (url, init) => {
-          requests.push({ url: String(url), init });
-          return requests.length === 1
-            ? new Response(JSON.stringify(document))
-            : new Response(JSON.stringify({ value: true }));
-        },
-        stdin: async () => '',
-        stdout: (text) => {
-          stdout += text;
-        },
-        stderr: () => {},
-        isTTY: false,
-        confirm: async () => false,
-      }
-    );
-    expect(exitCode).toBe(0);
-    expect(requests[0]).toMatchObject({
-      url: 'http://localhost:4000/.well-known/plexus/openapi.json',
-      init: { cache: 'no-store' },
-    });
-    expect(stdout).toBe('{\n  "value": true\n}\n');
-  });
-
-  it('sends the management credential with x-admin-key', async () => {
-    const requests: Array<{ url: string; init?: RequestInit }> = [];
-    const exitCode = await run(
-      ['api', 'call', 'getKey', '--admin-key', 'secret'],
-      {},
-      {
-        fetch: async (url, init) => {
-          requests.push({ url: String(url), init });
-          return requests.length === 1
-            ? new Response(JSON.stringify(document))
-            : new Response(JSON.stringify({ value: true }));
-        },
-        stdin: async () => '',
-        stdout: () => {},
-        stderr: () => {},
-        isTTY: false,
-        confirm: async () => false,
-      }
-    );
-    expect(exitCode).toBe(0);
-    expect(new Headers(requests[1]?.init?.headers).get('x-admin-key')).toBe('secret');
-  });
-
-  it('retrieves all standardized pages', async () => {
-    const paginatedDocument = {
-      paths: {
-        '/v0/management/items': {
-          get: {
-            operationId: 'listItems',
-            parameters: [
-              { name: 'limit', in: 'query' },
-              { name: 'offset', in: 'query' },
-            ],
-          },
-        },
-      },
-    };
-    let stdout = '';
-    const exitCode = await run(
-      ['api', 'call', 'listItems', '--all', '--param', 'limit=2'],
-      {},
-      {
-        fetch: async (url) => {
-          if (String(url).includes('openapi.json'))
-            return new Response(JSON.stringify(paginatedDocument));
-          return String(url).includes('offset=2')
-            ? new Response(JSON.stringify({ data: [3], total: 3, limit: 2, offset: 2 }))
-            : new Response(JSON.stringify({ data: [1, 2], total: 3, limit: 2, offset: 0 }));
-        },
-        stdin: async () => '',
-        stdout: (text) => {
-          stdout += text;
-        },
-        stderr: () => {},
-        isTTY: false,
-        confirm: async () => true,
-      }
-    );
-    expect(exitCode).toBe(0);
-    expect(JSON.parse(stdout)).toMatchObject({ data: [1, 2, 3], total: 3 });
-  });
-});

package/test/integration/cli.e2e.test.ts

@@ -1,112 +0,0 @@
-import { rm } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { afterAll, afterEach, beforeAll, describe, expect, test } from 'vitest';
-
-const openApiDocument = {
-  openapi: '3.1.0',
-  paths: {
-    '/v0/management/usage': {
-      get: {
-        operationId: 'getV0ManagementUsage',
-        parameters: [
-          { name: 'limit', in: 'query' },
-          { name: 'offset', in: 'query' },
-        ],
-        responses: {
-          200: {
-            content: {
-              'application/json': {},
-            },
-          },
-        },
-      },
-    },
-  },
-};
-
-describe('plexuscli end-to-end', () => {
-  let server: ReturnType<typeof Bun.serve> | undefined;
-  const buildDir = join(tmpdir(), `plexuscli-e2e-${crypto.randomUUID()}`);
-  let cliPath: string;
-
-  beforeAll(async () => {
-    const result = await Bun.build({
-      entrypoints: [join(process.cwd(), 'src', 'index.ts')],
-      outdir: buildDir,
-      compile: true,
-      target: 'bun',
-    });
-    if (!result.success) throw new Error(result.logs.map((log) => log.message).join('\n'));
-    cliPath = result.outputs[0]!.path;
-  });
-
-  afterEach(() => {
-    server?.stop(true);
-    server = undefined;
-  });
-
-  afterAll(async () => {
-    await rm(buildDir, { force: true, recursive: true });
-  });
-
-  test('discovers and calls a paginated management operation', async () => {
-    const adminKeys: string[] = [];
-    server = Bun.serve({
-      port: 0,
-      fetch(request) {
-        const url = new URL(request.url);
-        if (url.pathname === '/.well-known/plexus/openapi.json') {
-          return Response.json(openApiDocument);
-        }
-
-        if (url.pathname === '/v0/management/usage') {
-          adminKeys.push(request.headers.get('x-admin-key') ?? '');
-          const offset = Number(url.searchParams.get('offset') ?? '0');
-          return Response.json(
-            offset === 0
-              ? { data: [{ requestId: 'one' }], total: 2, limit: 1, offset }
-              : { data: [{ requestId: 'two' }], total: 2, limit: 1, offset }
-          );
-        }
-
-        return new Response('Not Found', { status: 404 });
-      },
-    });
-
-    const child = Bun.spawn(
-      [
-        cliPath,
-        '--url',
-        `http://localhost:${server.port}`,
-        '--admin-key',
-        'e2e-admin-key',
-        'api',
-        'call',
-        'getV0ManagementUsage',
-        '--all',
-        '--param',
-        'limit=1',
-        '--output',
-        'json',
-      ],
-      {
-        stdout: 'pipe',
-        stderr: 'pipe',
-      }
-    );
-    const [stdout, stderr, exitCode] = await Promise.all([
-      new Response(child.stdout).text(),
-      new Response(child.stderr).text(),
-      child.exited,
-    ]);
-
-    expect(exitCode).toBe(0);
-    expect(stderr).toBe('');
-    expect(JSON.parse(stdout)).toMatchObject({
-      data: [{ requestId: 'one' }, { requestId: 'two' }],
-      total: 2,
-    });
-    expect(adminKeys).toEqual(['e2e-admin-key', 'e2e-admin-key']);
-  });
-});

package/tsconfig.json

@@ -1,7 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "types": ["bun-types"]
-  },
-  "include": ["src", "test"]
-}