@loopstack/cli 0.15.1 → 0.17.0

package/README.md

@@ -0,0 +1,62 @@
+# @loopstack/cli
+
+Scaffold, run, inspect, and watch [Loopstack](https://loopstack.ai) workflows from the terminal — live transition and LLM token streaming, human-in-the-loop prompts answered inline, and CI-ready JSON output with meaningful exit codes.
+
+```bash
+npm install -g @loopstack/cli
+```
+
+Start a new app with a zero-config hello workflow:
+
+```bash
+loopstack create my-app
+cd my-app && docker compose up -d && npm run start:dev
+```
+
+```bash
+$ loopstack run hello --arg name=Maya
+
+▸ run 088cd19c… started
+▸ start
+✓ start (9ms)
+Hello, Maya! 👋
+result: {"greeting":"Hello, Maya! 👋"}
+■ run completed in 96ms
+```
+
+When a run asks a question, answer it right there — or in Studio; whichever answers first wins, and the CLI keeps following either way. Field forms hand off to Studio via deep link (or open in `$EDITOR` with `--editor`):
+
+```
+⏸ waiting_for_answer
+
+Which environment should we deploy to?
+  1. staging
+  2. production
+answer: 2
+■ run completed
+```
+
+## Commands
+
+| Command                     | What it does                                                                                                                       |
+| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `loopstack create <dir>`    | Scaffold a new Loopstack app (NestJS + LoopstackModule + hello workflow + docker-compose)                                          |
+| `loopstack list [workflow]` | Workflows you can run; with a name: its arguments and a ready-to-run example                                                       |
+| `loopstack run <workflow>`  | Start a run and follow it live; `--arg k=v`, `--arg k=@file.json`, `--arg k=@-` (stdin), `--detach`, `--quiet`, `--open`, `--json` |
+| `loopstack runs [run-id]`   | Recent runs (waiting-for-input first) or one run’s audit trail; `--follow` reattaches and answers prompts                          |
+| `loopstack watch`           | Live event stream; `--workflow`, `--type`, NDJSON with `--json`                                                                    |
+| `loopstack login`           | Save a backend environment to `~/.loopstack/config.json`                                                                           |
+| `loopstack env list\|use`   | Manage saved environments                                                                                                          |
+
+## CI
+
+```yaml
+- run: npx --yes @loopstack/cli run triage-ticket --arg ticket=@samples/ticket-042.json --json
+  env:
+    LOOPSTACK_URL: ${{ vars.LOOPSTACK_URL }}
+    LOOPSTACK_TOKEN: ${{ secrets.LOOPSTACK_TOKEN }}
+```
+
+Exit codes: `0` completed · `1` failed · `2` connection/config error · `3` waiting for input (non-interactive). `--json` prints one final object — `{ workflowId, status, result, errorMessage, durationMs }` — on a clean stdout.
+
+Local backends with auth disabled need no login or token at all. When an environment has a Studio URL (saved via `login`, `LOOPSTACK_STUDIO_URL`, or the local default), run output includes deep links into Studio — and `--open` jumps straight there. Full documentation: [CLI Reference](https://loopstack.ai/docs/reference/cli).

package/dist/commands/create.d.ts

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

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

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

package/dist/commands/create.js

@@ -0,0 +1,80 @@
+import { spawnSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import pc from 'picocolors';
+import { CliError } from '../errors.js';
+import { printData, printStatus } from '../output/format.js';
+const FIXTURES_DIR = fileURLToPath(new URL('../../fixtures/app', import.meta.url));
+const LOOPSTACK_DEPENDENCIES = ['@loopstack/loopstack-module', '@loopstack/common', 'zod'];
+function run(label, command, args, cwd) {
+    printStatus(pc.dim(`▸ ${label}`));
+    const result = spawnSync(command, args, { cwd, stdio: ['ignore', 2, 2] });
+    if (result.error)
+        throw new CliError(`${label} failed: ${result.error.message}`);
+    if (result.status !== 0)
+        throw new CliError(`${label} failed (exit ${result.status ?? 'unknown'})`);
+}
+function overlayFixtures(targetDir) {
+    fs.cpSync(FIXTURES_DIR, targetDir, { recursive: true });
+    const example = path.join(targetDir, 'env.example');
+    fs.copyFileSync(example, path.join(targetDir, '.env'));
+    fs.renameSync(example, path.join(targetDir, '.env.example'));
+}
+function addDependencies(targetDir) {
+    const pkgPath = path.join(targetDir, 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    pkg.dependencies ??= {};
+    for (const name of LOOPSTACK_DEPENDENCIES) {
+        pkg.dependencies[name] = 'latest';
+    }
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+}
+export function registerCreateCommand(program) {
+    program
+        .command('create')
+        .description('Scaffold a new Loopstack app (NestJS + LoopstackModule + a hello workflow)')
+        .argument('<dir>', 'target directory — its basename becomes the project name')
+        .option('--skip-install', 'skip npm install (dependencies are added to package.json)')
+        .option('--no-git', 'skip git init')
+        .action((dir, options) => {
+        const targetDir = path.resolve(dir);
+        const name = path.basename(targetDir);
+        const parentDir = path.dirname(targetDir);
+        if (!/^[a-z0-9][a-z0-9-]*$/.test(name)) {
+            throw new CliError(`Invalid project name "${name}" — use lowercase letters, digits, and hyphens.`);
+        }
+        if (fs.existsSync(targetDir) && fs.readdirSync(targetDir).length > 0) {
+            throw new CliError(`Directory ${targetDir} already exists and is not empty.`);
+        }
+        fs.mkdirSync(parentDir, { recursive: true });
+        run('Scaffolding NestJS app', 'npx', ['--yes', '@nestjs/cli@latest', 'new', name, '--skip-git', '--skip-install', '--package-manager', 'npm'], parentDir);
+        printStatus(pc.dim('▸ Applying Loopstack fixtures'));
+        overlayFixtures(targetDir);
+        addDependencies(targetDir);
+        if (!options.skipInstall) {
+            run('Installing dependencies', 'npm', ['install'], targetDir);
+        }
+        if (options.git !== false) {
+            run('Initializing git repository', 'git', ['init', '-b', 'main'], targetDir);
+            spawnSync('git', ['add', '-A'], { cwd: targetDir, stdio: 'ignore' });
+            spawnSync('git', ['commit', '-m', 'Initial commit'], { cwd: targetDir, stdio: 'ignore' });
+        }
+        printStatus(pc.green(`■ Created ${name}`));
+        printData([
+            '',
+            'Next steps:',
+            `  cd ${path.relative(process.cwd(), targetDir) || '.'}`,
+            ...(options.skipInstall ? ['  npm install'] : []),
+            '  docker compose up -d      # Postgres, Redis, and Studio',
+            '  npm run start:dev         # backend on http://localhost:3000',
+            '',
+            '  Studio: http://localhost:5173',
+            '  Terminal: npx @loopstack/cli run hello --arg name=You',
+            '',
+            '  CLAUDE.md primes coding agents with the conventions and the CLI feedback loop.',
+            '',
+        ].join('\n'));
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

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

package/dist/commands/env.d.ts

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

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

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

package/dist/commands/env.js

@@ -0,0 +1,42 @@
+import pc from 'picocolors';
+import { loadConfig, saveConfig } from '../config/config.js';
+import { CliError } from '../errors.js';
+import { printData, printStatus, renderTable } from '../output/format.js';
+export function registerEnvCommand(program) {
+    const env = program.command('env').description('Manage saved backend environments');
+    env
+        .command('list')
+        .description('List saved environments')
+        .action((_options, cmd) => {
+        const config = loadConfig();
+        const names = Object.keys(config.environments);
+        const globals = cmd.optsWithGlobals();
+        if (globals.json) {
+            printData(JSON.stringify(config, null, 2));
+            return;
+        }
+        if (names.length === 0) {
+            printStatus('No environments saved — run `loopstack login`.');
+            return;
+        }
+        const rows = names.map((name) => [
+            config.defaultEnvironment === name ? `${name} ${pc.dim('(default)')}` : name,
+            config.environments[name].url,
+            config.environments[name].token ? 'yes' : 'no',
+        ]);
+        printData(renderTable(['NAME', 'URL', 'TOKEN'], rows));
+    });
+    env
+        .command('use <name>')
+        .description('Set the default environment')
+        .action((name) => {
+        const config = loadConfig();
+        if (!config.environments[name]) {
+            throw new CliError(`Unknown environment "${name}" — run \`loopstack env list\`.`);
+        }
+        config.defaultEnvironment = name;
+        saveConfig(config);
+        printStatus(pc.green(`✔ Default environment is now "${name}".`));
+    });
+}
+//# sourceMappingURL=env.js.map

package/dist/commands/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,mCAAmC,CAAC,CAAC;IAEpF,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,yBAAyB,CAAC;SACtC,MAAM,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,EAAwB,CAAC;QAE5D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,WAAW,CAAC,gDAAgD,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/B,MAAM,CAAC,kBAAkB,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;YAC5E,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG;YAC7B,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;SAC/C,CAAC,CAAC;QACH,SAAS,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,QAAQ,CAAC,wBAAwB,IAAI,iCAAiC,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACjC,UAAU,CAAC,MAAM,CAAC,CAAC;QACnB,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,iCAAiC,IAAI,IAAI,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/list.d.ts

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

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

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

package/dist/commands/list.js

@@ -0,0 +1,119 @@
+import pc from 'picocolors';
+import { createClientFor, resolveConnection } from '../config/resolve.js';
+import { CliError } from '../errors.js';
+import { printData, printStatus, renderTable } from '../output/format.js';
+export function registerListCommand(program) {
+    program
+        .command('list [workflow]')
+        .description('List the workflows you can run, or show one workflow’s arguments')
+        .action(async (workflowName, _options, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const connection = resolveConnection(globals);
+        const client = createClientFor(connection);
+        if (workflowName) {
+            await describeWorkflow(client, workflowName, !!globals.json);
+            return;
+        }
+        await listWorkflows(client, connection, !!globals.json);
+    });
+}
+async function listWorkflows(client, connection, json) {
+    const apps = await client.config.apps();
+    const workflows = apps.flatMap((app) => app.workflows.map((workflow) => ({
+        workflowName: workflow.workflowName,
+        title: workflow.title ?? '',
+        description: workflow.description ?? '',
+        appName: app.appName,
+        appTitle: app.title,
+    })));
+    if (json) {
+        printData(JSON.stringify(workflows, null, 2));
+        return;
+    }
+    if (workflows.length === 0) {
+        printStatus(`No workflows on ${connection.url} — is a Loopstack app with @StudioApp modules running?`);
+        return;
+    }
+    const rows = workflows.map((workflow) => [workflow.workflowName, workflow.title, workflow.appTitle]);
+    printData(renderTable(['WORKFLOW', 'TITLE', 'APP'], rows, [32, 42, 20]));
+    printStatus('');
+    printStatus(`${workflows.length} workflows in ${apps.length} apps (${connection.name}) — \`loopstack list <workflow>\` shows its arguments`);
+}
+async function describeWorkflow(client, workflowName, json) {
+    const apps = await client.config.apps();
+    let app;
+    let workflow;
+    for (const candidate of apps) {
+        workflow = candidate.workflows.find((entry) => entry.workflowName === workflowName);
+        if (workflow) {
+            app = candidate;
+            break;
+        }
+    }
+    if (!workflow || !app) {
+        const available = apps.flatMap((entry) => entry.workflows.map((item) => item.workflowName)).sort();
+        throw new CliError(`Unknown workflow "${workflowName}". Available workflows: ${available.join(', ')}`);
+    }
+    const schema = (workflow.schema ?? {});
+    const properties = schema.type === 'object' ? (schema.properties ?? {}) : {};
+    const required = new Set(schema.required ?? []);
+    if (json) {
+        printData(JSON.stringify({
+            workflowName: workflow.workflowName,
+            title: workflow.title,
+            description: workflow.description,
+            appName: app.appName,
+            appTitle: app.title,
+            schema: workflow.schema ?? null,
+        }, null, 2));
+        return;
+    }
+    const title = workflow.title ? ` — ${workflow.title}` : '';
+    printData(`${pc.bold(workflow.workflowName)}${title}`);
+    if (workflow.description)
+        printData(workflow.description);
+    printData(pc.dim(`app: ${app.title} (${app.appName})`));
+    printData('');
+    const argNames = Object.keys(properties);
+    if (argNames.length === 0) {
+        printData(pc.dim('No arguments.'));
+    }
+    else {
+        const rows = argNames.map((name) => {
+            const property = properties[name];
+            return [
+                name,
+                property.type ?? 'any',
+                required.has(name) && property.default === undefined ? 'yes' : 'no',
+                property.default !== undefined ? JSON.stringify(property.default) : '',
+                property.description ?? '',
+            ];
+        });
+        printData(renderTable(['ARGUMENT', 'TYPE', 'REQUIRED', 'DEFAULT', 'DESCRIPTION'], rows));
+    }
+    printData('');
+    printData(`Run it:  ${pc.bold(exampleInvocation(workflow.workflowName, properties, required))}`);
+}
+function exampleInvocation(workflowName, properties, required) {
+    const sample = (property) => {
+        if (property.default !== undefined)
+            return JSON.stringify(property.default);
+        switch (property.type) {
+            case 'number':
+            case 'integer':
+                return '42';
+            case 'boolean':
+                return 'true';
+            default:
+                return `<${property.type ?? 'value'}>`;
+        }
+    };
+    const names = Object.keys(properties);
+    const shown = names.filter((name) => required.has(name));
+    const optional = names.filter((name) => !required.has(name));
+    if (shown.length === 0 || names.length <= 3)
+        shown.push(...optional.slice(0, 3 - shown.length));
+    const args = shown.map((name) => `--arg ${name}=${sample(properties[name])}`).join(' ');
+    return `loopstack run ${workflowName}${args ? ` ${args}` : ''}`;
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/login.d.ts

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

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

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

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;AA2BzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgGzD"}

package/dist/commands/run.js

@@ -0,0 +1,94 @@
+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 { 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('--quiet', 'no progress — print only the final result')
+        .option('--open', 'open the run in Studio')
+        .option('--editor', 'answer field forms in $EDITOR instead of handing off to 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() : 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();
+        const startedAt = Date.now();
+        const run = await client.processor.start({ workflowName, workspaceId, args });
+        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(`resume with: loopstack runs ${run.workflowId} --follow`));
+            printData(json ? JSON.stringify({ workflowId: run.workflowId, ...(link && { studioUrl: link }) }) : run.workflowId);
+            process.exit(ExitCode.Success);
+        }
+        const outcome = await followRun(events, run.workflowId, out, {
+            onIdle: createIdleHandler(client, run.workflowId, statusOut, { studioUrl: link, editor: options.editor }),
+            onDocument: createDocumentRenderer(client, out),
+        });
+        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 && quiet) {
+                const result = full.result;
+                printData(typeof result === 'string' ? result : JSON.stringify(result ?? null, null, 2));
+            }
+            if (!json && !quiet)
+                renderResult(out, full.result);
+            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 runs ${run.workflowId} --follow\`\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;AAsCzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwB1D"}