@loopstack/cli 0.15.1 → 0.18.0

package/README.md

@@ -0,0 +1,66 @@
+# @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. Choices, confirms, chat inputs, and secret entry render as native prompts; forms submit as-is or open the complete content in `$EDITOR` first:
+
+```
+⏸ waiting_for_answer
+
+Which environment should we deploy to?
+  1. staging
+  2. production
+answer: 2
+■ run completed
+```
+
+Input only Studio can collect is named explicitly (with a deep link) instead of hanging, and browser-based waits — like an OAuth sign-in link — resume the attached session automatically once 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 full transcript; `--json` includes the pending prompt (`pendingPrompt`), `--record <file>` derives a replay fixture from the run’s recorded tool calls |
+| `loopstack answer <run-id>` | Answer a waiting run’s prompt non-interactively — `--arg k=v` fields or `--payload <json>`; for agents and scripts                                                                                        |
+| `loopstack attach <run-id>` | Rejoin a run live — transcript so far, then streaming output and interactive prompts (docker/tmux semantics)                                                                                              |
+| `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/answer.d.ts

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

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

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

package/dist/commands/answer.js

@@ -0,0 +1,82 @@
+import { readFileSync } from 'node:fs';
+import pc from 'picocolors';
+import { createClientFor, resolveConnection } from '../config/resolve.js';
+import { CliError, ExitCode } from '../errors.js';
+import { inspectPendingPrompt } from '../hitl/pending.js';
+import { printData, printStatus } from '../output/format.js';
+import { parseRunArgs } from '../run/args.js';
+const collect = (value, previous) => [...previous, value];
+export function registerAnswerCommand(program) {
+    program
+        .command('answer <runId>')
+        .description('Answer the prompt a waiting run is parked on — non-interactive (for agents and scripts)')
+        .option('--arg <key=value>', 'answer field (repeatable); key=@file reads a file, key=@- reads stdin', collect, [])
+        .option('--payload <json>', 'full answer payload as JSON; @file reads a file, @- reads stdin')
+        .option('--transition <id>', 'wait transition to answer (required when several are available)')
+        .action(async (runId, options, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const connection = resolveConnection(globals);
+        const client = createClientFor(connection);
+        const json = !!globals.json;
+        const pending = await inspectPendingPrompt(client, runId);
+        if (!pending) {
+            throw new CliError(`Run ${runId} has no pending prompt — nothing to answer.`);
+        }
+        if (pending.studioOnly) {
+            throw new CliError(`The pending input (${pending.widget}) can only be collected in Studio — the CLI cannot answer it.`);
+        }
+        const transition = options.transition ?? pending.transition;
+        if (!transition) {
+            throw new CliError(`Several transitions are available (${pending.transitions.join(', ')}) — pick one with --transition <id>.`);
+        }
+        if (!pending.transitions.includes(transition)) {
+            throw new CliError(`Transition '${transition}' is not available — currently available: ${pending.transitions.join(', ')}.`);
+        }
+        const payload = buildPayload(options);
+        await client.processor.run(pending.workflowId, {
+            transition: { id: transition, workflowId: pending.workflowId, payload },
+        });
+        if (json) {
+            printData(JSON.stringify({ runId, promptWorkflowId: pending.workflowId, transition, payload, submitted: true }, null, 2));
+        }
+        else {
+            printStatus(`${pc.green('✓')} answered '${transition}' on ${pending.workflowName}`);
+            printStatus(pc.dim(`  follow with: loopstack attach ${runId}`));
+        }
+        process.exit(ExitCode.Success);
+    });
+}
+function buildPayload(options) {
+    if (options.payload !== undefined && options.arg.length > 0) {
+        throw new CliError('Use either --payload or --arg, not both.');
+    }
+    if (options.payload !== undefined) {
+        const raw = options.payload === '@-'
+            ? readFileSync(0, 'utf8')
+            : options.payload.startsWith('@')
+                ? readPayloadFile(options.payload.slice(1))
+                : options.payload;
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                throw new CliError('--payload must be a JSON object.');
+            }
+            return parsed;
+        }
+        catch (error) {
+            if (error instanceof CliError)
+                throw error;
+            throw new CliError(`--payload is not valid JSON: ${raw.slice(0, 120)}`);
+        }
+    }
+    return parseRunArgs(options.arg);
+}
+function readPayloadFile(path) {
+    try {
+        return readFileSync(path, 'utf8');
+    }
+    catch {
+        throw new CliError(`Cannot read --payload file "${path}".`);
+    }
+}
+//# sourceMappingURL=answer.js.map

package/dist/commands/answer.js.map

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

package/dist/commands/attach.d.ts

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

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

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

package/dist/commands/attach.js

@@ -0,0 +1,103 @@
+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 { printData, printStatus, renderResult } from '../output/format.js';
+import { openInBrowser, studioRunUrl } from '../output/studio-link.js';
+import { followRun } from '../run/follow.js';
+import { offerRetry } from '../run/retry.js';
+import { renderRunTrail } from '../run/trail.js';
+const TERMINAL_STATES = [
+    WorkflowState.Completed,
+    WorkflowState.Failed,
+    WorkflowState.Canceled,
+];
+const IDLE_STATES = [WorkflowState.Waiting, WorkflowState.Paused];
+function exitCodeForStatus(status) {
+    if (status === WorkflowState.Completed)
+        return ExitCode.Success;
+    if (IDLE_STATES.includes(status))
+        return ExitCode.NeedsInput;
+    return ExitCode.RunFailed;
+}
+export function registerAttachCommand(program) {
+    program
+        .command('attach <runId>')
+        .description('Attach to a run: transcript so far, then live progress and prompts (exit 0 completed / 1 failed / 3 waiting)')
+        .option('--open', 'open the run in Studio')
+        .action(async (runId, options, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const connection = resolveConnection(globals);
+        const client = createClientFor(connection);
+        const json = !!globals.json;
+        const out = json ? process.stderr : process.stdout;
+        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 events = client.stream.events();
+        await client.stream.waitForOpen();
+        const workflow = await client.workflows.get(runId);
+        const checkpoints = await client.workflows.checkpoints(runId);
+        const { renderer, streamedMessageIds, streamedToolCallIds, visibleWorkflowIds } = await renderRunTrail(client, connection, out, workflow, checkpoints);
+        if (TERMINAL_STATES.includes(workflow.status)) {
+            if (json) {
+                printData(JSON.stringify({
+                    workflowId: runId,
+                    status: workflow.status,
+                    result: workflow.result,
+                    errorMessage: workflow.errorMessage,
+                }, null, 2));
+            }
+            else {
+                out.write('\n');
+                if (renderResult(out, workflow.result))
+                    out.write('\n');
+            }
+            out.write(pc.dim(`run already ${workflow.status} — nothing to attach to\n`));
+            if (workflow.status !== WorkflowState.Completed && workflow.errorMessage) {
+                out.write(`${pc.red('■')} ${workflow.errorMessage}\n`);
+            }
+            client.stream.close();
+            process.exit(exitCodeForStatus(workflow.status));
+        }
+        out.write(pc.dim('\n— attached, following live —\n'));
+        const followOptions = {
+            onIdle: createIdleHandler(client, runId, out, { studioUrl: link }),
+            initiallyIdle: IDLE_STATES.includes(workflow.status),
+            onDocument: renderer.onDocument,
+            streamedMessageIds,
+            streamedToolCallIds,
+            visibleWorkflowIds,
+            onStreamReset: async () => (await client.workflows.get(runId)).status,
+        };
+        let outcome = await followRun(events, runId, out, followOptions);
+        if (!json)
+            outcome = await offerRetry(client, runId, events, out, out, followOptions, outcome);
+        client.stream.close();
+        const full = await client.workflows.get(runId);
+        if (json) {
+            printData(JSON.stringify({ workflowId: runId, status: outcome.status, result: full.result, errorMessage: full.errorMessage }, null, 2));
+        }
+        if (outcome.status === WorkflowState.Completed) {
+            if (!json) {
+                out.write('\n');
+                if (renderResult(out, full.result))
+                    out.write('\n');
+            }
+            out.write(`${pc.green('■')} run completed\n`);
+        }
+        else if (IDLE_STATES.includes(outcome.status)) {
+            out.write(`${pc.yellow('⏸')} run is still waiting for input\n`);
+        }
+        else {
+            out.write(`${pc.red('■')} run ${outcome.status}${full.errorMessage ? `: ${full.errorMessage}` : ''}\n`);
+        }
+        process.exit(exitCodeForStatus(outcome.status));
+    });
+}
+//# sourceMappingURL=attach.js.map

package/dist/commands/attach.js.map

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

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"}