@invinite-org/invinite-data-cli 2.0.0 → 4.0.0

package/dist/src/commands/agent-setup.d.ts

@@ -0,0 +1,21 @@
+import { Command } from 'commander';
+/** The runtimes `agent-setup` wires both the MCP connector and the skill for. */
+export declare const AGENT_RUNTIMES: readonly ["claude", "codex"];
+export type AgentRuntime = (typeof AGENT_RUNTIMES)[number];
+export interface Connector {
+    name: string;
+    url: string;
+}
+/** The plugin's one MCP connector (`claude-plugin/.mcp.json`): the name and URL every runtime is given. */
+export declare function bundledConnector(sourceDir?: string): Connector;
+/** Where a runtime reads its MCP servers: Claude Code `./.mcp.json` / `~/.claude.json`, Codex `config.toml`. */
+export declare function mcpConfigPath(runtime: AgentRuntime, scope: 'global' | 'local', cwd?: string, home?: string): string;
+/** The JSON config with the connector set under `mcpServers` (every other key kept as it was). */
+export declare function mergeClaudeMcp(current: string | undefined, connector: Connector): string;
+/** The Codex TOML with a `[mcp_servers.<name>]` table for the connector (an existing table is replaced). */
+export declare function mergeCodexMcp(current: string | undefined, connector: Connector): string;
+/**
+ * `invd agent-setup`: one step for an agent — the MCP connector in the runtime's config (Claude Code, Codex) and the
+ * skill / agent / commands the plugin installs. The connector signs in with OAuth on first use; no key is written.
+ */
+export declare function registerAgentSetupCommand(program: Command): void;

package/dist/src/commands/agent-setup.js

@@ -0,0 +1,112 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import chalk from 'chalk';
+import { UsageError, withErrorHandling } from '../shared/errors.js';
+import { getSourceDir, promptInteractive, RUNTIMES, resolveScope } from './plugin.js';
+/** The runtimes `agent-setup` wires both the MCP connector and the skill for. */
+export const AGENT_RUNTIMES = ['claude', 'codex'];
+/** The plugin's one MCP connector (`claude-plugin/.mcp.json`): the name and URL every runtime is given. */
+export function bundledConnector(sourceDir = getSourceDir()) {
+    const raw = JSON.parse(fs.readFileSync(path.join(sourceDir, '.mcp.json'), 'utf8'));
+    const [entry] = Object.entries(raw.mcpServers ?? {});
+    if (!entry?.[1]?.url)
+        throw new Error('claude-plugin/.mcp.json names no MCP connector');
+    return { name: entry[0], url: entry[1].url };
+}
+/** Where a runtime reads its MCP servers: Claude Code `./.mcp.json` / `~/.claude.json`, Codex `config.toml`. */
+export function mcpConfigPath(runtime, scope, cwd = process.cwd(), home = os.homedir()) {
+    if (runtime === 'claude')
+        return scope === 'local' ? path.join(cwd, '.mcp.json') : path.join(home, '.claude.json');
+    return scope === 'local' ? path.join(cwd, '.codex', 'config.toml') : path.join(home, '.codex', 'config.toml');
+}
+/** The JSON config with the connector set under `mcpServers` (every other key kept as it was). */
+export function mergeClaudeMcp(current, connector) {
+    let config = {};
+    if (current?.trim()) {
+        const parsed = JSON.parse(current);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+            throw new Error('not a JSON object');
+        config = parsed;
+    }
+    const servers = typeof config.mcpServers === 'object' && config.mcpServers !== null ? config.mcpServers : {};
+    return `${JSON.stringify({ ...config, mcpServers: { ...servers, [connector.name]: { type: 'http', url: connector.url } } }, null, 2)}\n`;
+}
+/** The Codex TOML with a `[mcp_servers.<name>]` table for the connector (an existing table is replaced). */
+export function mergeCodexMcp(current, connector) {
+    const header = `[mcp_servers.${connector.name}]`;
+    const lines = (current ?? '').split('\n');
+    const start = lines.findIndex(line => line.trim() === header);
+    if (start >= 0) {
+        let end = start + 1;
+        while (end < lines.length && !(lines[end] ?? '').trim().startsWith('['))
+            end += 1;
+        lines.splice(start, end - start);
+    }
+    const body = lines.join('\n').replace(/\n+$/, '');
+    return `${body ? `${body}\n\n` : ''}${header}\nurl = "${connector.url}"\n`;
+}
+function writeMcp(runtime, scope, connector, dryRun) {
+    const target = mcpConfigPath(runtime, scope);
+    const current = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : undefined;
+    let next;
+    try {
+        next = runtime === 'claude' ? mergeClaudeMcp(current, connector) : mergeCodexMcp(current, connector);
+    }
+    catch (error) {
+        throw new Error(`${target}: ${error instanceof Error ? error.message : String(error)} — fix the file or add the connector by hand`);
+    }
+    if (!dryRun) {
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        fs.writeFileSync(target, next);
+    }
+    return target;
+}
+/**
+ * `invd agent-setup`: one step for an agent — the MCP connector in the runtime's config (Claude Code, Codex) and the
+ * skill / agent / commands the plugin installs. The connector signs in with OAuth on first use; no key is written.
+ */
+export function registerAgentSetupCommand(program) {
+    program
+        .command('agent-setup')
+        .description('Connect an AI agent: the Invinite MCP connector plus the invd skill, in one step')
+        .option('--claude', 'Claude Code (.mcp.json / ~/.claude.json + .claude/)')
+        .option('--codex', 'Codex (config.toml [mcp_servers] + .codex/skills)')
+        .option('--all', 'Both')
+        .option('-g, --global', 'User-wide (home directory)')
+        .option('-l, --local', 'This project (current directory)')
+        .option('--dry-run', 'Print what would be written; write nothing')
+        .addHelpText('before', 'Examples:\n  $ invd agent-setup --claude --local\n  $ invd agent-setup --all --global --dry-run\n')
+        .action(withErrorHandling(async (opts) => {
+        let runtimes = opts.all ? [...AGENT_RUNTIMES] : AGENT_RUNTIMES.filter(runtime => opts[runtime]);
+        if (runtimes.length === 0)
+            runtimes = null;
+        let scope = resolveScope(opts);
+        if (!runtimes || !scope) {
+            if (!process.stdin.isTTY)
+                throw new UsageError('Name the agent (--claude, --codex, --all) and the scope (--global or --local)');
+            const answers = await promptInteractive(runtimes, scope);
+            runtimes = answers.runtimes;
+            scope = answers.scope;
+        }
+        const chosen = runtimes.filter((runtime) => AGENT_RUNTIMES.includes(runtime));
+        if (chosen.length === 0)
+            throw new UsageError('agent-setup supports --claude and --codex (invd plugin install covers the others)');
+        const sourceDir = getSourceDir();
+        const connector = bundledConnector(sourceDir);
+        const dryRun = opts.dryRun === true;
+        for (const runtime of chosen) {
+            const config = RUNTIMES[runtime];
+            const mcp = writeMcp(runtime, scope, connector, dryRun);
+            const skillRoot = scope === 'global' ? config.globalDir : config.localDir ? path.resolve(process.cwd(), config.localDir) : null;
+            if (skillRoot && !dryRun)
+                config.install(sourceDir, skillRoot);
+            const verb = dryRun ? 'would write' : 'wrote';
+            console.log(chalk.green(`  ✓ ${config.label}`) + chalk.dim(` — ${verb} MCP ${connector.name} → ${mcp}${skillRoot ? `; skill → ${skillRoot}` : ''}`));
+        }
+        console.log(dryRun
+            ? chalk.bold('\nDry run: nothing was written.')
+            : chalk.bold(`\nDone. Restart the agent; it asks you to sign in to ${connector.url} the first time it uses a tool.`));
+    }));
+}
+//# sourceMappingURL=agent-setup.js.map

package/dist/src/commands/agent-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-setup.js","sourceRoot":"","sources":["../../../src/commands/agent-setup.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/api.d.ts

@@ -0,0 +1,27 @@
+import { Command } from 'commander';
+import { type RequestOptions } from '../client/api-client.js';
+/**
+ * The path (+ query) `invd api` sends to the configured API. An absolute URL is accepted only on the API's own
+ * origin (its path is used); any other host is refused — the request carries the API key.
+ */
+export declare function apiPathOf(rawPath: string, baseUrl?: string): string;
+interface ApiOpts {
+    field?: string[];
+    rawField?: string[];
+    header?: string[];
+    input?: string;
+    paginate?: boolean;
+    jq?: string;
+    dryRun?: boolean;
+    yes?: boolean;
+    showCost?: boolean;
+}
+/** The request `invd api [METHOD] <path> [-F k=v] [-f k=v] [-H 'Name: value'] [--input file]` describes. */
+export declare function apiRequestFrom(first: string, second: string | undefined, opts: ApiOpts): Promise<RequestOptions>;
+/**
+ * `invd api`: any operation of the spec, raw. `--paginate` follows `next_cursor` / `Link rel="next"` and prints
+ * every page (each through `--jq`), so `invd api /v2/filings?company=AAPL --paginate --jq '.data[].accession'`
+ * streams accessions.
+ */
+export declare function registerApiCommand(program: Command): void;
+export {};

package/dist/src/commands/api.js

@@ -0,0 +1,180 @@
+import { readFile } from 'node:fs/promises';
+import chalk from 'chalk';
+import { apiCall, buildUrl } from '../client/api-client.js';
+import { getBaseUrl } from '../config/config-manager.js';
+import { nextCursorOf, rowsOf, walkPages } from '../client/pagination.js';
+import { runJq } from '../output/jq.js';
+import { emit } from '../output/render.js';
+import { PartialResultError, UsageError, withErrorHandling } from '../shared/errors.js';
+import { confirmOrRefuse, readStdin } from '../shared/prompt.js';
+import { setJsonMode } from '../shared/spinner.js';
+const METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
+/** `-F key=value`: `true` / `false` / `null` and numbers typed, `@file` read from a file, anything else a string. */
+async function typedValue(raw) {
+    if (raw === 'true' || raw === 'false')
+        return raw === 'true';
+    if (raw === 'null')
+        return null;
+    if (/^-?\d+(\.\d+)?$/.test(raw))
+        return Number(raw);
+    if (raw.startsWith('@'))
+        return (await readFile(raw.slice(1), 'utf8')).replace(/\n$/, '');
+    return raw;
+}
+/** A scheme (`https:`) or a protocol-relative `//host`: an absolute URL, not a path. */
+const ABSOLUTE_URL = /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i;
+/**
+ * The path (+ query) `invd api` sends to the configured API. An absolute URL is accepted only on the API's own
+ * origin (its path is used); any other host is refused — the request carries the API key.
+ */
+export function apiPathOf(rawPath, baseUrl = getBaseUrl()) {
+    if (!ABSOLUTE_URL.test(rawPath))
+        return rawPath.startsWith('/') ? rawPath : `/${rawPath}`;
+    const base = new URL(baseUrl);
+    let target;
+    try {
+        target = new URL(rawPath, base);
+    }
+    catch {
+        throw new UsageError(`${rawPath} is not a URL or an API path`);
+    }
+    if (target.origin !== base.origin) {
+        throw new UsageError(`invd api only calls ${base.origin} (the request carries your API key); refusing ${target.origin}. Pass a path such as /v2/companies/AAPL`);
+    }
+    const prefix = base.pathname.replace(/\/+$/, '');
+    const path = prefix && target.pathname.startsWith(`${prefix}/`) ? target.pathname.slice(prefix.length) : target.pathname;
+    return `${path}${target.search}`;
+}
+function splitPair(pair, separator, flag) {
+    const index = pair.indexOf(separator);
+    if (index <= 0)
+        throw new UsageError(`${flag} expects key${separator}value (got ${pair})`);
+    return [pair.slice(0, index).trim(), pair.slice(index + 1).trim()];
+}
+/** The request `invd api [METHOD] <path> [-F k=v] [-f k=v] [-H 'Name: value'] [--input file]` describes. */
+export async function apiRequestFrom(first, second, opts) {
+    const upper = first.toUpperCase();
+    const [method, rawPath] = second !== undefined
+        ? [upper, second]
+        : METHODS.includes(upper) ? [upper, ''] : ['GET', first];
+    if (!METHODS.includes(method))
+        throw new UsageError(`${first} is not an HTTP method (${METHODS.join(', ')})`);
+    if (!rawPath)
+        throw new UsageError('invd api needs a path, e.g. invd api /v2/companies/AAPL');
+    const url = new URL(apiPathOf(rawPath), 'http://placeholder');
+    const query = {};
+    url.searchParams.forEach((value, key) => { (query[key] ??= []).push(value); });
+    const fields = [];
+    for (const pair of opts.field ?? []) {
+        const [key, value] = splitPair(pair, '=', '-F');
+        fields.push([key, await typedValue(value)]);
+    }
+    for (const pair of opts.rawField ?? [])
+        fields.push(splitPair(pair, '=', '-f'));
+    const headers = {};
+    for (const pair of opts.header ?? []) {
+        const [name, value] = splitPair(pair, ':', '-H');
+        headers[name] = value;
+    }
+    let body;
+    if (opts.input !== undefined) {
+        const text = opts.input === '-' ? await readStdin() : await readFile(opts.input, 'utf8');
+        try {
+            body = JSON.parse(text);
+        }
+        catch (error) {
+            throw new UsageError(`--input is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (method === 'GET' || method === 'DELETE') {
+        for (const [key, value] of fields)
+            (query[key] ??= []).push(String(value));
+    }
+    else if (fields.length > 0) {
+        if (body !== undefined && (typeof body !== 'object' || body === null || Array.isArray(body))) {
+            throw new UsageError('--input must hold a JSON object to combine with -F / -f');
+        }
+        body = { ...body, ...Object.fromEntries(fields) };
+    }
+    return {
+        path: url.pathname,
+        method,
+        query,
+        ...(Object.keys(headers).length ? { headers } : {}),
+        ...(body !== undefined ? { body } : {}),
+    };
+}
+function print(body, jq) {
+    if (body === undefined)
+        return;
+    emit(jq ? runJq(jq, body).join('\n') : typeof body === 'string' ? body : JSON.stringify(body, null, 2));
+}
+/**
+ * `invd api`: any operation of the spec, raw. `--paginate` follows `next_cursor` / `Link rel="next"` and prints
+ * every page (each through `--jq`), so `invd api /v2/filings?company=AAPL --paginate --jq '.data[].accession'`
+ * streams accessions.
+ */
+export function registerApiCommand(program) {
+    program
+        .command('api')
+        .description('Call any API path directly (the escape hatch for anything the command tree lacks)')
+        .argument('<method-or-path>', 'GET (default), POST, PATCH, DELETE … or the path')
+        .argument('[path]', 'The path when a method is given, e.g. /v2/filings?company=AAPL')
+        .option('-F, --field <key=value>', 'A parameter (query on GET / DELETE, JSON body field otherwise); typed: numbers, true / false, null, @file', collect, [])
+        .option('-f, --raw-field <key=value>', 'Like -F, always a string', collect, [])
+        .option('-H, --header <name:value>', 'An extra request header', collect, [])
+        .option('--input <file>', 'The JSON request body from a file (- = stdin)')
+        .option('--paginate', 'Follow next_cursor / Link rel="next" and print every page')
+        .option('--jq <expr>', 'Filter each response with a jq expression (strings print raw)')
+        .option('--dry-run', 'Print the request; send nothing')
+        .option('--yes', 'Do not ask before a DELETE')
+        .option('--no-input', 'Never prompt')
+        .option('--show-cost', 'Print the credits this command cost to stderr')
+        .addHelpText('before', [
+        'Examples:',
+        '  $ invd api /v2/companies/AAPL',
+        "  $ invd api GET /v2/filings?company=AAPL --paginate --jq '.data[].accession'",
+        '',
+    ].join('\n'))
+        .addHelpText('after', '\nPaths: invd completion <shell> completes every /v2 path of the spec after `invd api`.\n')
+        .action(withErrorHandling(async (first, second, _raw, command) => {
+        const opts = command.opts();
+        // commander keeps --input <file> and --no-input in one attribute: a string is the file, false the switch.
+        const input = typeof opts.input === 'string' ? opts.input : undefined;
+        const request = await apiRequestFrom(first, second, { ...opts, input });
+        if (opts.jq)
+            setJsonMode(true);
+        if (opts.dryRun) {
+            emit(`${request.method} ${buildUrl(request.path, request.query)}${request.body !== undefined ? `\nbody: ${JSON.stringify(request.body)}` : ''}\ndry run: no request was sent`);
+            return;
+        }
+        if (request.method === 'DELETE') {
+            await confirmOrRefuse(`${request.method} ${request.path} deletes this resource.`, { yes: opts.yes, input: opts.input !== false });
+        }
+        const first_ = await apiCall(request);
+        if (!opts.paginate) {
+            print(first_.body, opts.jq);
+            if (first_.body === undefined)
+                console.error(chalk.green(`${first_.status} (no body)`));
+            return;
+        }
+        let written = 0;
+        let cursor;
+        try {
+            for await (const page of walkPages(request, first_)) {
+                print(page.body, opts.jq);
+                written += rowsOf(page.body).length || 1;
+                cursor = nextCursorOf(page.body);
+            }
+        }
+        catch (error) {
+            if (written > 0)
+                throw new PartialResultError(error, written, cursor);
+            throw error;
+        }
+    }));
+}
+function collect(value, previous) {
+    return [...previous, value];
+}
+//# sourceMappingURL=api.js.map

package/dist/src/commands/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/commands/api.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/auth.d.ts

@@ -0,0 +1,37 @@
+import { Command } from 'commander';
+type ExchangeData = {
+    key: string;
+    keyHint: string;
+    label: string;
+};
+export type LoginDependencies = {
+    fetch: typeof fetch;
+    openBrowser: (url: string) => Promise<void>;
+    timeoutMs: number;
+    /**
+     * `--no-browser`: the redirect URL (or code) the person pastes; resolves with the pasted text. `signal` aborts the
+     * read once the login settled another way (the loopback callback won), so a waiting prompt never holds the process.
+     */
+    readPasted?: (prompt: string, signal: AbortSignal) => Promise<string>;
+};
+/** The exchange code and state of a pasted redirect URL (`http://127.0.0.1:…/callback?code=…&state=…`), or a bare code. */
+export declare function parsePastedCallback(text: string): {
+    code?: string;
+    state?: string;
+};
+/**
+ * Browser sign-in: a loopback callback server receives the exchange code. With `noBrowser` (SSH sessions) the URL
+ * is printed instead and the person pastes the address their browser was sent to (the page itself may not load —
+ * the code is in its URL); whichever arrives first wins.
+ */
+export declare function login(dependencies?: LoginDependencies, opts?: {
+    noBrowser?: boolean;
+}): Promise<ExchangeData>;
+export declare function logout(dependencies?: Pick<LoginDependencies, 'fetch'>): Promise<void>;
+/** `invd auth status`: where the key comes from and, unless `offline`, what `GET /v2/me` says about it (free). */
+export declare function status(opts?: {
+    offline?: boolean;
+    json?: boolean;
+}): Promise<void>;
+export declare function registerAuthCommands(program: Command): void;
+export {};