@loopstack/cli 0.15.1 → 0.18.0

package/dist/commands/login.js

@@ -0,0 +1,62 @@
+import { stdin, stdout } from 'node:process';
+import { createInterface } from 'node:readline/promises';
+import pc from 'picocolors';
+import { createClient } from '@loopstack/client';
+import { configPath, loadConfig, saveConfig } from '../config/config.js';
+import { CliError } from '../errors.js';
+import { printStatus } from '../output/format.js';
+function suggestName(url) {
+    const hostname = new URL(url).hostname;
+    return hostname === 'localhost' || hostname === '127.0.0.1' ? 'local' : hostname;
+}
+export function registerLoginCommand(program) {
+    program
+        .command('login')
+        .description('Save a backend environment to ~/.loopstack/config.json (pass --url/--token or answer the prompts)')
+        .option('--name <name>', 'environment name')
+        .option('--studio-url <url>', 'Studio frontend URL — enables deep links in run output')
+        .action(async (_options, cmd) => {
+        const merged = cmd.optsWithGlobals();
+        let { url, token, name, studioUrl } = merged;
+        token = token || undefined;
+        studioUrl = studioUrl || undefined;
+        if (!url && !stdin.isTTY) {
+            throw new CliError('Non-interactive shell — pass --url (and --token for authenticated backends).');
+        }
+        if (!url || (token === undefined && stdin.isTTY)) {
+            const rl = createInterface({ input: stdin, output: stdout });
+            try {
+                if (!url) {
+                    url = (await rl.question('Backend URL [http://localhost:3000]: ')).trim() || 'http://localhost:3000';
+                }
+                if (token === undefined) {
+                    token = (await rl.question('API token (lsk_…, empty for local no-auth): ')).trim() || undefined;
+                }
+                if (studioUrl === undefined) {
+                    const isLocal = ['localhost', '127.0.0.1'].includes(new URL(url).hostname);
+                    const suggestion = isLocal ? 'http://localhost:5173' : '';
+                    const hint = suggestion ? ` [${suggestion}]` : ' (empty for none)';
+                    studioUrl = (await rl.question(`Studio URL${hint}: `)).trim() || suggestion || undefined;
+                }
+                if (!name) {
+                    const suggested = suggestName(url);
+                    name = (await rl.question(`Environment name [${suggested}]: `)).trim() || suggested;
+                }
+            }
+            finally {
+                rl.close();
+            }
+        }
+        name ??= suggestName(url);
+        printStatus(pc.dim(`Probing ${url} …`));
+        const client = createClient({ url, token, envKey: name });
+        await client.workflows.list({ limit: 1 });
+        const config = loadConfig();
+        config.environments[name] = { ...config.environments[name], url, token, ...(studioUrl && { studioUrl }) };
+        config.defaultEnvironment ??= name;
+        saveConfig(config);
+        const isDefault = config.defaultEnvironment === name;
+        printStatus(pc.green(`✔ Environment "${name}" saved to ${configPath()}${isDefault ? ' (default)' : ''}.`));
+    });
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerRunCommand(program: Command): void;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4HzD"}

package/dist/commands/run.js

@@ -0,0 +1,119 @@
+import { Writable } from 'node:stream';
+import pc from 'picocolors';
+import { WorkflowState } from '@loopstack/contracts/enums';
+import { createClientFor, resolveConnection } from '../config/resolve.js';
+import { ExitCode } from '../errors.js';
+import { createIdleHandler } from '../hitl/idle-handler.js';
+import { formatDuration, printData, printStatus, renderResult } from '../output/format.js';
+import { openInBrowser, studioRunUrl } from '../output/studio-link.js';
+import { parseRunArgs } from '../run/args.js';
+import { createDocumentRenderer } from '../run/documents.js';
+import { followRun } from '../run/follow.js';
+import { offerRetry } from '../run/retry.js';
+import { resolveWorkspaceId } from '../run/workspace.js';
+const collect = (value, previous) => [...previous, value];
+const discard = () => new Writable({ write: (_chunk, _encoding, callback) => callback() });
+export function registerRunCommand(program) {
+    program
+        .command('run <workflow>')
+        .description('Start a workflow run and follow it live (exit 0 completed / 1 failed / 3 waiting for input)')
+        .option('--arg <key=value>', 'workflow argument, repeatable; key=@file.json reads a file, key=@- reads stdin', collect, [])
+        .option('--workspace <id>', 'workspace to run in (default: newest workspace of the workflow’s app)')
+        .option('--detach', 'start the run, print its id, exit immediately')
+        .option('--trace', 'persist the run trace (tool calls, transitions) — enables `runs <id> --record`')
+        .option('--quiet', 'no progress — print only the final result')
+        .option('--open', 'open the run in Studio')
+        .action(async (workflowName, options, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const connection = resolveConnection(globals);
+        const client = createClientFor(connection);
+        const json = !!globals.json;
+        const quiet = !!options.quiet;
+        const out = json ? process.stderr : quiet ? discard() : options.detach ? process.stderr : process.stdout;
+        const statusOut = json || quiet ? process.stderr : process.stdout;
+        const args = parseRunArgs(options.arg);
+        const workspaceId = await resolveWorkspaceId(client, workflowName, options.workspace, connection.workspaceId);
+        const events = options.detach ? undefined : client.stream.events();
+        if (events)
+            await client.stream.waitForOpen();
+        const startedAt = Date.now();
+        const run = await client.processor.start({
+            workflowName,
+            workspaceId,
+            args,
+            ...(options.trace ? { trace: true } : {}),
+        });
+        out.write(pc.dim(`▸ run ${run.workflowId} started\n`));
+        const link = studioRunUrl(connection, run.workflowId);
+        if (link && events)
+            out.write(pc.dim(`⧉ ${link}\n`));
+        if (options.open) {
+            if (link)
+                openInBrowser(link);
+            else
+                printStatus('No Studio URL configured for this environment — set one with `loopstack login`.');
+        }
+        if (!events) {
+            if (link)
+                printStatus(pc.dim(`⧉ ${link}`));
+            printStatus(pc.dim(`attach with: loopstack attach ${run.workflowId}`));
+            printData(json ? JSON.stringify({ workflowId: run.workflowId, ...(link && { studioUrl: link }) }) : run.workflowId);
+            process.exit(ExitCode.Success);
+        }
+        const streamedMessageIds = new Set();
+        const streamedToolCallIds = new Set();
+        const visibleWorkflowIds = new Set();
+        const renderer = createDocumentRenderer(client, out, {
+            studioUrl: (id) => studioRunUrl(connection, id),
+            streamedMessageIds,
+            streamedToolCallIds,
+            visibleWorkflowIds,
+        });
+        const followOptions = {
+            onIdle: createIdleHandler(client, run.workflowId, statusOut, { studioUrl: link }),
+            onDocument: renderer.onDocument,
+            streamedMessageIds,
+            streamedToolCallIds,
+            visibleWorkflowIds,
+            onStreamReset: async () => (await client.workflows.get(run.workflowId)).status,
+        };
+        let outcome = await followRun(events, run.workflowId, out, followOptions);
+        if (!json)
+            outcome = await offerRetry(client, run.workflowId, events, out, statusOut, followOptions, outcome);
+        client.stream.close();
+        const durationMs = Date.now() - startedAt;
+        const full = await client.workflows.get(run.workflowId);
+        if (json) {
+            printData(JSON.stringify({
+                workflowId: run.workflowId,
+                status: outcome.status,
+                result: full.result,
+                errorMessage: full.errorMessage,
+                durationMs,
+                ...(link && { studioUrl: link }),
+            }, null, 2));
+        }
+        if (outcome.status === WorkflowState.Completed) {
+            if (!json) {
+                if (!quiet)
+                    out.write('\n');
+                const wrote = renderResult(quiet ? process.stdout : out, full.result);
+                if (!quiet && wrote)
+                    out.write('\n');
+            }
+            statusOut.write(`${pc.green('■')} run completed in ${formatDuration(durationMs)}\n`);
+            process.exit(ExitCode.Success);
+        }
+        if (outcome.status === WorkflowState.Waiting || outcome.status === WorkflowState.Paused) {
+            statusOut.write(`${pc.yellow('⏸')} run is waiting for input — resume with \`loopstack attach ${run.workflowId}\`\n`);
+            if (link)
+                statusOut.write(pc.dim(`⧉ answer in Studio: ${link}\n`));
+            process.exit(ExitCode.NeedsInput);
+        }
+        statusOut.write(`${pc.red('■')} run ${outcome.status}${full.errorMessage ? `: ${full.errorMessage}` : ''}\n`);
+        if (link)
+            statusOut.write(pc.dim(`⧉ inspect in Studio: ${link}\n`));
+        process.exit(ExitCode.RunFailed);
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/runs.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerRunsCommand(program: Command): void;
+//# sourceMappingURL=runs.d.ts.map

package/dist/commands/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/commands/runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4B1D"}

package/dist/commands/runs.js

@@ -0,0 +1,151 @@
+import { writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import pc from 'picocolors';
+import { SortOrder, WorkflowState } from '@loopstack/contracts/enums';
+import { createClientFor, resolveConnection } from '../config/resolve.js';
+import { CliError, ExitCode } from '../errors.js';
+import { inspectPendingPrompt } from '../hitl/pending.js';
+import { colorStatus, printData, printStatus, renderResult, renderTable } from '../output/format.js';
+import { openInBrowser, studioRunUrl } from '../output/studio-link.js';
+import { renderRunTrail } from '../run/trail.js';
+const IDLE_STATES = [WorkflowState.Waiting, WorkflowState.Paused];
+export function registerRunsCommand(program) {
+    program
+        .command('runs [runId]')
+        .description('Recent runs (runs waiting for input first), or one run’s full transcript; `attach` joins it live')
+        .option('--limit <n>', 'maximum number of runs to list', '20')
+        .option('--workspace <id>', 'filter by workspace id')
+        .option('--search <text>', 'search runs')
+        .option('--status <status>', 'filter by status (e.g. waiting, completed, failed)')
+        .option('--open', 'open the run in Studio (requires a run id)')
+        .option('--record <file>', 'write the run’s recorded tool calls as a replay fixture (JSON)')
+        .option('--tools <names>', 'comma-separated tool names to include in the fixture (default: all)')
+        .action(async (runId, options, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const connection = resolveConnection(globals);
+        const client = createClientFor(connection);
+        if (!runId) {
+            if (options.open)
+                throw new CliError('--open requires a run id: loopstack runs <run-id> --open');
+            if (options.record)
+                throw new CliError('--record requires a run id: loopstack runs <run-id> --record <file>');
+            await listRuns(client, connection, options, !!globals.json);
+            return;
+        }
+        if (options.record) {
+            await recordFixture(client, runId, options.record, options.tools, !!globals.json);
+            return;
+        }
+        await showRun(client, connection, runId, options, !!globals.json);
+    });
+}
+async function recordFixture(client, runId, file, tools, json) {
+    const allRecords = await client.workflows.toolCalls(runId);
+    if (allRecords.length === 0) {
+        throw new CliError('No recorded tool calls for this run. Start the run with `loopstack run <workflow> --trace` ' +
+            '(or the backend with LOOPSTACK_TRACE=true) and run the workflow again.');
+    }
+    const boundary = tools ? new Set(tools.split(',').map((name) => name.trim())) : undefined;
+    const inBoundary = boundary ? allRecords.filter((record) => boundary.has(record.toolName)) : allRecords;
+    if (boundary && inBoundary.length === 0) {
+        throw new CliError(`No recorded calls match --tools ${tools}. Recorded tools: ` +
+            `${[...new Set(allRecords.map((record) => record.toolName))].join(', ')}`);
+    }
+    const records = inBoundary.filter((record) => !record.envelope.pending);
+    const recordings = records.map((record) => ({
+        tool: record.toolName,
+        workflow: record.workflowName,
+        transition: record.transitionId ?? '',
+        ...(record.args !== null ? { args: record.args } : {}),
+        ...(record.config !== null ? { config: record.config } : {}),
+        envelope: record.envelope,
+    }));
+    const target = resolve(file);
+    writeFileSync(target, `${JSON.stringify({ version: 3, recordings }, null, 2)}\n`);
+    const skipped = inBoundary.length - records.length;
+    if (json) {
+        printData(JSON.stringify({ file: target, recordings: recordings.length, skippedPending: skipped }, null, 2));
+    }
+    else {
+        printStatus(`${pc.green('✓')} wrote ${recordings.length} recording(s) to ${target}`);
+        if (skipped > 0) {
+            printStatus(`  ${skipped} pending envelope(s) skipped — async tools always run live in replayed tests`);
+        }
+    }
+}
+async function listRuns(client, connection, options, json) {
+    const filter = {
+        ...(options.workspace && { workspaceId: options.workspace }),
+        ...(options.status && { status: options.status }),
+    };
+    const page = await client.workflows.list({
+        ...(Object.keys(filter).length > 0 && { filter }),
+        ...(options.search && { search: options.search }),
+        sortBy: [{ field: 'createdAt', order: SortOrder.DESC }],
+        page: 0,
+        limit: Number(options.limit),
+    });
+    const needsInput = page.data.filter((run) => IDLE_STATES.includes(run.status));
+    const rest = page.data.filter((run) => !IDLE_STATES.includes(run.status));
+    const ordered = [...needsInput, ...rest];
+    if (json) {
+        const withLinks = ordered.map((run) => {
+            const studioUrl = studioRunUrl(connection, run.id);
+            return { ...run, ...(studioUrl && { studioUrl }) };
+        });
+        printData(JSON.stringify(withLinks, null, 2));
+        return;
+    }
+    if (ordered.length === 0) {
+        printStatus(`No runs on ${connection.url} yet — start one with \`loopstack run <workflow>\`.`);
+        return;
+    }
+    const rows = ordered.map((run) => [
+        run.id,
+        run.workflowName,
+        `#${run.run}`,
+        colorStatus(run.status),
+        run.title ?? '',
+        new Date(run.createdAt).toLocaleString(),
+    ]);
+    printData(renderTable(['ID', 'WORKFLOW', 'RUN', 'STATUS', 'TITLE', 'CREATED'], rows));
+    printStatus('');
+    if (needsInput.length > 0) {
+        printStatus(`${pc.yellow('⏸')} ${needsInput.length} waiting for input — answer with \`loopstack attach <run-id>\``);
+    }
+    printStatus(`${ordered.length} of ${page.total} runs (${connection.name})`);
+}
+async function showRun(client, connection, runId, options, json) {
+    const link = studioRunUrl(connection, runId);
+    if (options.open) {
+        if (link)
+            openInBrowser(link);
+        else
+            printStatus('No Studio URL configured for this environment — set one with `loopstack login`.');
+    }
+    const workflow = await client.workflows.get(runId);
+    const checkpoints = await client.workflows.checkpoints(runId);
+    const pendingPrompt = IDLE_STATES.includes(workflow.status)
+        ? await inspectPendingPrompt(client, runId).catch(() => undefined)
+        : undefined;
+    if (json) {
+        printData(JSON.stringify({ workflow, checkpoints, ...(pendingPrompt && { pendingPrompt }), ...(link && { studioUrl: link }) }, null, 2));
+        process.exit(ExitCode.Success);
+    }
+    const out = process.stdout;
+    await renderRunTrail(client, connection, out, workflow, checkpoints);
+    out.write('\n');
+    if (renderResult(out, workflow.result))
+        out.write('\n');
+    if (IDLE_STATES.includes(workflow.status)) {
+        if (pendingPrompt && !pendingPrompt.studioOnly) {
+            out.write(`${pc.yellow('⏸')} waiting for input: ${pendingPrompt.description}\n`);
+            out.write(pc.dim(`  answer with \`loopstack answer ${runId} --arg k=v\` or interactively: \`loopstack attach ${runId}\`\n`));
+        }
+        else {
+            out.write(`${pc.yellow('⏸')} run is waiting for input — answer with \`loopstack attach ${runId}\`\n`);
+        }
+    }
+    process.exit(ExitCode.Success);
+}
+//# sourceMappingURL=runs.js.map

package/dist/commands/runs.js.map

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

package/dist/commands/watch.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerWatchCommand(program: Command): void;
+//# sourceMappingURL=watch.d.ts.map

package/dist/commands/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiC3D"}

package/dist/commands/watch.js

@@ -0,0 +1,50 @@
+import pc from 'picocolors';
+import { createClientFor, resolveConnection } from '../config/resolve.js';
+import { printStatus } from '../output/format.js';
+const collect = (value, previous) => [...previous, value];
+function summarize(message) {
+    const parts = [];
+    if (typeof message.workflowId === 'string')
+        parts.push(message.workflowId);
+    if (typeof message.status === 'string')
+        parts.push(String(message.status));
+    if (typeof message.place === 'string')
+        parts.push(`@${String(message.place)}`);
+    if (typeof message.delta === 'string')
+        parts.push(JSON.stringify(message.delta.slice(0, 40)));
+    if (typeof message.workspaceId === 'string')
+        parts.push(`ws:${String(message.workspaceId)}`);
+    return parts.join('  ');
+}
+export function registerWatchCommand(program) {
+    program
+        .command('watch')
+        .description("Stream the environment's live events (Ctrl+C to stop)")
+        .option('--workflow <id>', 'only events of this workflow run')
+        .option('--type <type>', 'only this event type (repeatable, e.g. workflow.updated)', collect, [])
+        .action(async (options, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const connection = resolveConnection(globals);
+        const client = createClientFor(connection);
+        const json = !!globals.json;
+        client.stream.onStatus((status) => printStatus(pc.dim(`stream: ${status}`)));
+        client.stream.onAny((message) => {
+            const record = message;
+            if (options.workflow && record.workflowId !== options.workflow)
+                return;
+            if (options.type.length > 0 && !options.type.includes(String(record.type)))
+                return;
+            if (json) {
+                console.log(JSON.stringify(message));
+                return;
+            }
+            const time = new Date().toLocaleTimeString();
+            console.log(`${pc.dim(time)}  ${pc.bold(String(record.type).padEnd(28))} ${summarize(record)}`);
+        });
+        printStatus(pc.dim(`watching ${connection.url} — Ctrl+C to stop`));
+        await new Promise((_resolve, reject) => {
+            client.stream.onError(reject);
+        });
+    });
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

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

package/dist/config/config.d.ts

@@ -0,0 +1,14 @@
+export interface EnvironmentConfig {
+    url: string;
+    token?: string;
+    workspaceId?: string;
+    studioUrl?: string;
+}
+export interface CliConfig {
+    defaultEnvironment?: string;
+    environments: Record<string, EnvironmentConfig>;
+}
+export declare function configPath(): string;
+export declare function loadConfig(path?: string): CliConfig;
+export declare function saveConfig(config: CliConfig, path?: string): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACjD;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAqB,GAAG,SAAS,CAUjE;AAGD,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,GAAE,MAAqB,GAAG,IAAI,CAI/E"}

package/dist/config/config.js

@@ -0,0 +1,25 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { CliError } from '../errors.js';
+export function configPath() {
+    return join(homedir(), '.loopstack', 'config.json');
+}
+export function loadConfig(path = configPath()) {
+    if (!existsSync(path)) {
+        return { environments: {} };
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        return { ...parsed, environments: parsed.environments ?? {} };
+    }
+    catch {
+        throw new CliError(`Config file ${path} is not valid JSON — fix or delete it.`);
+    }
+}
+export function saveConfig(config, path = configPath()) {
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    writeFileSync(path, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
+    chmodSync(path, 0o600);
+}
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAgBxC,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe,UAAU,EAAE;IACpD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC9B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAuB,CAAC;QAC5E,OAAO,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,eAAe,IAAI,wCAAwC,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,UAAU,CAAC,MAAiB,EAAE,OAAe,UAAU,EAAE;IACvE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC"}

package/dist/config/resolve.d.ts

@@ -0,0 +1,18 @@
+import type { LoopstackClient } from '@loopstack/client';
+import type { CliConfig } from './config.js';
+export interface ConnectionFlags {
+    env?: string;
+    url?: string;
+    token?: string;
+}
+export interface ResolvedConnection {
+    name: string;
+    url: string;
+    token?: string;
+    workspaceId?: string;
+    studioUrl?: string;
+    source: 'flags' | 'env-vars' | 'config' | 'default';
+}
+export declare function resolveConnection(flags: ConnectionFlags, env?: NodeJS.ProcessEnv, config?: CliConfig): ResolvedConnection;
+export declare function createClientFor(connection: ResolvedConnection): LoopstackClient;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/config/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IAEjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;CACrD;AAYD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,EACtB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,MAAM,GAAE,SAAwB,GAC/B,kBAAkB,CAoDpB;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,kBAAkB,GAAG,eAAe,CAE/E"}

package/dist/config/resolve.js

@@ -0,0 +1,57 @@
+import { createClient } from '@loopstack/client';
+import { CliError } from '../errors.js';
+import { loadConfig } from './config.js';
+const LOCAL_URL = 'http://localhost:3000';
+const LOCAL_STUDIO_URL = 'http://localhost:5173';
+export function resolveConnection(flags, env = process.env, config = loadConfig()) {
+    const tokenOverride = flags.token ?? env.LOOPSTACK_TOKEN;
+    const studioOverride = env.LOOPSTACK_STUDIO_URL;
+    if (flags.url) {
+        return { name: flags.url, url: flags.url, token: tokenOverride, studioUrl: studioOverride, source: 'flags' };
+    }
+    if (flags.env) {
+        const saved = config.environments[flags.env];
+        if (!saved) {
+            throw new CliError(`Unknown environment "${flags.env}" — run \`loopstack env list\` or \`loopstack login\`.`);
+        }
+        return {
+            name: flags.env,
+            url: saved.url,
+            token: tokenOverride ?? saved.token,
+            workspaceId: saved.workspaceId,
+            studioUrl: studioOverride ?? saved.studioUrl,
+            source: 'flags',
+        };
+    }
+    if (env.LOOPSTACK_URL) {
+        return {
+            name: env.LOOPSTACK_URL,
+            url: env.LOOPSTACK_URL,
+            token: tokenOverride,
+            studioUrl: studioOverride,
+            source: 'env-vars',
+        };
+    }
+    if (config.defaultEnvironment && config.environments[config.defaultEnvironment]) {
+        const saved = config.environments[config.defaultEnvironment];
+        return {
+            name: config.defaultEnvironment,
+            url: saved.url,
+            token: tokenOverride ?? saved.token,
+            workspaceId: saved.workspaceId,
+            studioUrl: studioOverride ?? saved.studioUrl,
+            source: 'config',
+        };
+    }
+    return {
+        name: 'local',
+        url: LOCAL_URL,
+        token: tokenOverride,
+        studioUrl: studioOverride ?? LOCAL_STUDIO_URL,
+        source: 'default',
+    };
+}
+export function createClientFor(connection) {
+    return createClient({ url: connection.url, token: connection.token, envKey: connection.name });
+}
+//# sourceMappingURL=resolve.js.map

package/dist/config/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAoBzC,MAAM,SAAS,GAAG,uBAAuB,CAAC;AAC1C,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AASjD,MAAM,UAAU,iBAAiB,CAC/B,KAAsB,EACtB,MAAyB,OAAO,CAAC,GAAG,EACpC,SAAoB,UAAU,EAAE;IAEhC,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC,eAAe,CAAC;IACzD,MAAM,cAAc,GAAG,GAAG,CAAC,oBAAoB,CAAC;IAEhD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC/G,CAAC;IAED,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,QAAQ,CAAC,wBAAwB,KAAK,CAAC,GAAG,wDAAwD,CAAC,CAAC;QAChH,CAAC;QACD,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,GAAG;YACf,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,aAAa,IAAI,KAAK,CAAC,KAAK;YACnC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,cAAc,IAAI,KAAK,CAAC,SAAS;YAC5C,MAAM,EAAE,OAAO;SAChB,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,aAAa;YACvB,GAAG,EAAE,GAAG,CAAC,aAAa;YACtB,KAAK,EAAE,aAAa;YACpB,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAChF,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,kBAAkB;YAC/B,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,aAAa,IAAI,KAAK,CAAC,KAAK;YACnC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,cAAc,IAAI,KAAK,CAAC,SAAS;YAC5C,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,cAAc,IAAI,gBAAgB;QAC7C,MAAM,EAAE,SAAS;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAA8B;IAC5D,OAAO,YAAY,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;AACjG,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+export declare const ExitCode: {
+    readonly Success: 0;
+    readonly RunFailed: 1;
+    readonly ConnectionOrConfig: 2;
+    readonly NeedsInput: 3;
+};
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare function handleError(error: unknown, url?: string): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AAEX,qBAAa,QAAS,SAAQ,KAAK;IAG/B,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBADzB,OAAO,EAAE,MAAM,EACN,QAAQ,GAAE,MAAoC;CAI1D;AAOD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAgB/D"}