@loopstack/cli 0.1.0

package/dist/hitl/prompt.js

@@ -0,0 +1,117 @@
+import { stdin } from 'node:process';
+import { createInterface } from 'node:readline/promises';
+import pc from 'picocolors';
+import { buildFormSkeleton, describeFormFields, editPayloadInEditor } from './editor.js';
+function availableTransitionIds(prompt) {
+    return prompt.workflow.availableTransitions?.map((transition) => transition.id) ?? [];
+}
+function resolveTransitionId(prompt) {
+    const available = availableTransitionIds(prompt);
+    const configured = prompt.widget?.options?.transition;
+    if (configured && available.includes(configured))
+        return configured;
+    if (available.length === 1)
+        return available[0];
+    return undefined;
+}
+function formProperties(prompt) {
+    const schema = prompt.widget?.schema;
+    if (schema?.type !== 'object')
+        return {};
+    return schema.properties ?? {};
+}
+export async function promptForAnswer(prompt, out, options = {}) {
+    const rl = createInterface({ input: stdin, output: out });
+    const ask = (query) => rl.question(query, { signal: options.signal });
+    try {
+        const widget = prompt.widget?.widget;
+        const content = (prompt.document?.content ?? {});
+        if (widget === 'text-prompt' || widget === 'confirm-prompt' || widget === 'choices') {
+            const transitionId = resolveTransitionId(prompt);
+            if (!transitionId)
+                return await pickTransition(prompt, ask, out);
+            out.write(`\n${String(content.question ?? 'Input required')}\n`);
+            if (widget === 'confirm-prompt') {
+                const raw = (await ask(`${pc.bold('[y]es / [n]o:')} `)).trim().toLowerCase();
+                return { transitionId, payload: { answer: raw === 'y' || raw === 'yes' ? 'yes' : 'no' } };
+            }
+            if (widget === 'choices') {
+                const choices = Array.isArray(content.options) ? content.options : [];
+                const allowCustom = content.allowCustomAnswer === true;
+                choices.forEach((option, index) => out.write(`  ${pc.bold(String(index + 1))}. ${option}\n`));
+                if (allowCustom)
+                    out.write(pc.dim('  (or type a custom answer)\n'));
+                const raw = (await ask(`${pc.bold('answer:')} `)).trim();
+                const byNumber = choices[Number(raw) - 1];
+                const answer = byNumber ?? (allowCustom || choices.includes(raw) ? raw : undefined);
+                if (!answer)
+                    return undefined;
+                return { transitionId, payload: { answer } };
+            }
+            const answer = (await ask(`${pc.bold('>')} `)).trim();
+            if (!answer)
+                return undefined;
+            return { transitionId, payload: { answer } };
+        }
+        if (widget === 'form') {
+            const actions = (prompt.widget?.options?.actions ?? []).filter((action) => action.transition && availableTransitionIds(prompt).includes(action.transition));
+            if (actions.length === 0)
+                return await pickTransition(prompt, ask, out);
+            const markdown = typeof content.markdown === 'string' ? content.markdown : undefined;
+            const title = prompt.widget?.options?.title ?? prompt.document?.documentName;
+            out.write(`\n${markdown ?? pc.bold(title ?? 'Form')}\n`);
+            const properties = formProperties(prompt);
+            const hasFields = Object.keys(properties).length > 0;
+            if (hasFields) {
+                if (!options.useEditor && options.studioUrl) {
+                    out.write(`${pc.dim('⧉ answer in Studio:')} ${options.studioUrl}\n`);
+                    out.write(pc.dim('waiting for the answer — Ctrl+C to detach, or rerun with --editor to answer here\n'));
+                    return 'handoff';
+                }
+                describeFormFields(prompt.widget?.schema).forEach((line) => out.write(pc.dim(`${line}\n`)));
+                out.write(pc.dim('opening $EDITOR — save to submit, empty the file to cancel\n'));
+                const payload = editPayloadInEditor(buildFormSkeleton(prompt.document?.content, prompt.widget?.schema), out);
+                if (payload === undefined)
+                    return undefined;
+                const action = await pickFormAction(actions, ask, out);
+                if (!action)
+                    return undefined;
+                return { transitionId: action.transition, payload };
+            }
+            const action = await pickFormAction(actions, ask, out);
+            if (!action)
+                return undefined;
+            return { transitionId: action.transition, payload: {} };
+        }
+        return await pickTransition(prompt, ask, out);
+    }
+    finally {
+        rl.close();
+    }
+}
+async function pickFormAction(actions, ask, out) {
+    actions.forEach((action, index) => out.write(`  ${pc.bold(String(index + 1))}. ${action.label ?? action.transition}\n`));
+    const raw = (await ask(`${pc.bold('action:')} `)).trim();
+    return actions[Number(raw) - 1] ?? actions.find((candidate) => candidate.label === raw);
+}
+async function pickTransition(prompt, ask, out) {
+    const available = availableTransitionIds(prompt);
+    if (available.length === 0)
+        return undefined;
+    out.write(`\nRun is waiting — available transitions:\n`);
+    available.forEach((id, index) => out.write(`  ${pc.bold(String(index + 1))}. ${id}\n`));
+    const raw = (await ask(`${pc.bold('transition:')} `)).trim();
+    const transitionId = available[Number(raw) - 1] ?? (available.includes(raw) ? raw : undefined);
+    if (!transitionId)
+        return undefined;
+    return { transitionId, payload: {} };
+}
+export function describePrompt(prompt) {
+    const content = (prompt.document?.content ?? {});
+    if (typeof content.question === 'string')
+        return content.question;
+    if (typeof content.markdown === 'string')
+        return content.markdown.split('\n')[0];
+    return `transitions: ${availableTransitionIds(prompt).join(', ')}`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/hitl/prompt.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createRequire } from 'node:module';
+import { registerCreateCommand } from './commands/create.js';
+import { registerEnvCommand } from './commands/env.js';
+import { registerListCommand } from './commands/list.js';
+import { registerLoginCommand } from './commands/login.js';
+import { registerRunCommand } from './commands/run.js';
+import { registerRunsCommand } from './commands/runs.js';
+import { registerWatchCommand } from './commands/watch.js';
+import { handleError } from './errors.js';
+const { version } = createRequire(import.meta.url)('../package.json');
+const program = new Command('loopstack')
+    .description('Scaffold, run, inspect, and watch Loopstack workflows from the terminal')
+    .version(version)
+    .option('--env <name>', 'named environment from ~/.loopstack/config.json')
+    .option('--url <url>', 'backend URL (overrides --env and the config file)')
+    .option('--token <token>', 'API token (lsk_…); LOOPSTACK_TOKEN works too')
+    .option('--json', 'machine-readable JSON output on stdout');
+registerCreateCommand(program);
+registerLoginCommand(program);
+registerEnvCommand(program);
+registerRunCommand(program);
+registerRunsCommand(program);
+registerWatchCommand(program);
+registerListCommand(program);
+try {
+    await program.parseAsync();
+}
+catch (error) {
+    handleError(error);
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAwB,CAAC;AAE7F,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;KACrC,WAAW,CAAC,yEAAyE,CAAC;KACtF,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,cAAc,EAAE,iDAAiD,CAAC;KACzE,MAAM,CAAC,aAAa,EAAE,mDAAmD,CAAC;KAC1E,MAAM,CAAC,iBAAiB,EAAE,8CAA8C,CAAC;KACzE,MAAM,CAAC,QAAQ,EAAE,wCAAwC,CAAC,CAAC;AAE9D,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,IAAI,CAAC;IACH,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,WAAW,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC"}

package/dist/output/format.d.ts

@@ -0,0 +1,6 @@
+export declare function renderTable(headers: string[], rows: string[][]): string;
+export declare function colorStatus(status: string): string;
+export declare function formatDuration(ms: number): string;
+export declare function printData(text: string): void;
+export declare function printStatus(text: string): void;
+//# sourceMappingURL=format.d.ts.map

package/dist/output/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/output/format.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAUvE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAclD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C"}

package/dist/output/format.js

@@ -0,0 +1,39 @@
+import pc from 'picocolors';
+import { WorkflowState } from '@loopstack/contracts/enums';
+export function renderTable(headers, rows) {
+    const widths = headers.map((header, column) => Math.max(header.length, ...rows.map((row) => (row[column] ?? '').length)));
+    const renderRow = (cells) => widths
+        .map((width, column) => (cells[column] ?? '').padEnd(width))
+        .join('  ')
+        .trimEnd();
+    return [pc.dim(renderRow(headers)), ...rows.map(renderRow)].join('\n');
+}
+export function colorStatus(status) {
+    switch (status) {
+        case WorkflowState.Completed:
+            return pc.green(status);
+        case WorkflowState.Failed:
+            return pc.red(status);
+        case WorkflowState.Waiting:
+        case WorkflowState.Paused:
+            return pc.yellow(status);
+        case WorkflowState.Running:
+            return pc.cyan(status);
+        default:
+            return status;
+    }
+}
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    return `${Math.floor(ms / 60_000)}m ${Math.round((ms % 60_000) / 1000)}s`;
+}
+export function printData(text) {
+    console.log(text);
+}
+export function printStatus(text) {
+    console.error(text);
+}
+//# sourceMappingURL=format.js.map

package/dist/output/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/output/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,MAAM,UAAU,WAAW,CAAC,OAAiB,EAAE,IAAgB;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAC5C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAC1E,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,KAAe,EAAE,EAAE,CACpC,MAAM;SACH,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SAC3D,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,aAAa,CAAC,SAAS;YAC1B,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,KAAK,aAAa,CAAC,MAAM;YACvB,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxB,KAAK,aAAa,CAAC,OAAO,CAAC;QAC3B,KAAK,aAAa,CAAC,MAAM;YACvB,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3B,KAAK,aAAa,CAAC,OAAO;YACxB,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC;IAC5C,IAAI,EAAE,GAAG,MAAM;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;AAC5E,CAAC;AAGD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/dist/output/studio-link.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedConnection } from '../config/resolve.js';
+export declare function studioRunUrl(connection: ResolvedConnection, workflowId: string): string | undefined;
+export declare function openInBrowser(url: string): void;
+//# sourceMappingURL=studio-link.d.ts.map

package/dist/output/studio-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-link.d.ts","sourceRoot":"","sources":["../../src/output/studio-link.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,wBAAgB,YAAY,CAAC,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGnG;AAGD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAU/C"}

package/dist/output/studio-link.js

@@ -0,0 +1,17 @@
+import { spawn } from 'node:child_process';
+export function studioRunUrl(connection, workflowId) {
+    if (!connection.studioUrl)
+        return undefined;
+    return `${connection.studioUrl.replace(/\/+$/, '')}/workflows/${workflowId}`;
+}
+export function openInBrowser(url) {
+    const [command, args] = process.platform === 'darwin'
+        ? ['open', [url]]
+        : process.platform === 'win32'
+            ? ['cmd', ['/c', 'start', '', url]]
+            : ['xdg-open', [url]];
+    spawn(command, args, { detached: true, stdio: 'ignore' })
+        .on('error', () => { })
+        .unref();
+}
+//# sourceMappingURL=studio-link.js.map

package/dist/output/studio-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-link.js","sourceRoot":"","sources":["../../src/output/studio-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAI3C,MAAM,UAAU,YAAY,CAAC,UAA8B,EAAE,UAAkB;IAC7E,IAAI,CAAC,UAAU,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,UAAU,EAAE,CAAC;AAC/E,CAAC;AAGD,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GACnB,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAC3B,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO;YAC5B,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,KAAK,CAAC,OAAiB,EAAE,IAAgB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;SAC5E,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC;SACrB,KAAK,EAAE,CAAC;AACb,CAAC"}

package/dist/run/args.d.ts

@@ -0,0 +1,2 @@
+export declare function parseRunArgs(pairs: string[], readFile?: (path: string) => string, readStdin?: () => string): Record<string, unknown>;
+//# sourceMappingURL=args.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/run/args.ts"],"names":[],"mappings":"AAUA,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAA6C,EACzE,SAAS,GAAE,MAAM,MAAsC,GACtD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB"}

package/dist/run/args.js

@@ -0,0 +1,41 @@
+import { readFileSync } from 'node:fs';
+import { CliError } from '../errors.js';
+export function parseRunArgs(pairs, readFile = (path) => readFileSync(path, 'utf8'), readStdin = () => readFileSync(0, 'utf8')) {
+    const args = {};
+    for (const pair of pairs) {
+        const separator = pair.indexOf('=');
+        if (separator <= 0) {
+            throw new CliError(`Invalid --arg "${pair}" — expected key=value or key=@file.`);
+        }
+        const key = pair.slice(0, separator);
+        const raw = pair.slice(separator + 1);
+        const value = raw === '@-' ? readStdinArg(readStdin) : raw.startsWith('@') ? readArgFile(raw.slice(1), readFile) : raw;
+        args[key] = coerce(value);
+    }
+    return args;
+}
+function readStdinArg(readStdin) {
+    try {
+        return readStdin();
+    }
+    catch {
+        throw new CliError('Cannot read --arg value from stdin (@-).');
+    }
+}
+function readArgFile(path, readFile) {
+    try {
+        return readFile(path);
+    }
+    catch {
+        throw new CliError(`Cannot read --arg file "${path}".`);
+    }
+}
+function coerce(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+//# sourceMappingURL=args.js.map

package/dist/run/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/run/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AASxC,MAAM,UAAU,YAAY,CAC1B,KAAe,EACf,WAAqC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EACzE,YAA0B,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;IAEvD,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,QAAQ,CAAC,kBAAkB,IAAI,sCAAsC,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACtC,MAAM,KAAK,GACT,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3G,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,SAAuB;IAC3C,IAAI,CAAC;QACH,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,0CAA0C,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,QAAkC;IACnE,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,2BAA2B,IAAI,IAAI,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,GAAW;IACzB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/run/follow.d.ts

@@ -0,0 +1,13 @@
+import { WorkflowState } from '@loopstack/contracts/enums';
+import type { ClientMessage } from '@loopstack/contracts/events';
+export interface FollowOutcome {
+    status: WorkflowState;
+    durationMs: number;
+}
+export type IdleOutcome = 'answered' | 'external' | 'stop';
+export interface FollowOptions {
+    onIdle?: (signal: AbortSignal, onPromptWorkflow: (id: string) => void) => Promise<IdleOutcome>;
+    initiallyIdle?: boolean;
+}
+export declare function followRun(events: AsyncIterableIterator<ClientMessage>, workflowId: string, out: NodeJS.WritableStream, options?: FollowOptions): Promise<FollowOutcome>;
+//# sourceMappingURL=follow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"follow.d.ts","sourceRoot":"","sources":["../../src/run/follow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,aAAa;IAQ5B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAE/F,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AA0BD,wBAAsB,SAAS,CAC7B,MAAM,EAAE,qBAAqB,CAAC,aAAa,CAAC,EAC5C,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAwHxB"}

package/dist/run/follow.js

@@ -0,0 +1,130 @@
+import pc from 'picocolors';
+import { WorkflowState } from '@loopstack/contracts/enums';
+import { CliError } from '../errors.js';
+import { formatDuration } from '../output/format.js';
+const TERMINAL_STATES = [
+    WorkflowState.Completed,
+    WorkflowState.Failed,
+    WorkflowState.Canceled,
+];
+const IDLE_STATES = [WorkflowState.Waiting, WorkflowState.Paused];
+export async function followRun(events, workflowId, out, options = {}) {
+    const startedAt = Date.now();
+    let currentPlace;
+    let placeEnteredAt = startedAt;
+    let streaming = false;
+    const endTokenLine = () => {
+        if (!streaming)
+            return;
+        out.write('\n');
+        streaming = false;
+    };
+    const finishStep = (mark = pc.green('✓')) => {
+        if (!currentPlace)
+            return;
+        endTokenLine();
+        out.write(`${mark} ${currentPlace} ${pc.dim(`(${formatDuration(Date.now() - placeEnteredAt)})`)}\n`);
+        currentPlace = undefined;
+    };
+    const outcome = (status) => ({ status, durationMs: Date.now() - startedAt });
+    const handleEvent = (event) => {
+        if (!('workflowId' in event) || event.workflowId !== workflowId)
+            return undefined;
+        switch (event.type) {
+            case 'llm.response.text_delta':
+                streaming = true;
+                out.write(event.delta);
+                break;
+            case 'llm.response.done':
+            case 'llm.response.error':
+                endTokenLine();
+                break;
+            case 'workflow.updated': {
+                if (event.place && event.place !== currentPlace) {
+                    finishStep();
+                    if (event.place !== 'end') {
+                        currentPlace = event.place;
+                        placeEnteredAt = Date.now();
+                        if (!TERMINAL_STATES.includes(event.status)) {
+                            out.write(pc.dim(`▸ ${currentPlace}\n`));
+                        }
+                    }
+                }
+                if (TERMINAL_STATES.includes(event.status)) {
+                    endTokenLine();
+                    return outcome(event.status);
+                }
+                if (IDLE_STATES.includes(event.status)) {
+                    finishStep(pc.yellow('⏸'));
+                    return 'idle';
+                }
+                break;
+            }
+        }
+        return undefined;
+    };
+    const startPrompt = () => {
+        const controller = new AbortController();
+        const pending = { controller };
+        pending.result = options.onIdle(controller.signal, (id) => {
+            pending.workflowId = id;
+        });
+        return pending;
+    };
+    const resolvesPrompt = (prompt, event) => {
+        if (event.type !== 'workflow.updated' || !('workflowId' in event))
+            return false;
+        const promptWorkflowId = prompt.workflowId ?? workflowId;
+        return event.workflowId === promptWorkflowId && !IDLE_STATES.includes(event.status);
+    };
+    let prompt = options.initiallyIdle && options.onIdle ? startPrompt() : null;
+    let pendingNext = null;
+    const pullNext = () => (pendingNext ??= events.next());
+    while (true) {
+        let event;
+        if (prompt) {
+            const raced = await Promise.race([
+                pullNext().then((result) => ({ kind: 'event', result })),
+                prompt.result.then((idle) => ({ kind: 'idle', idle })),
+            ]);
+            if (raced.kind === 'idle') {
+                prompt = null;
+                if (raced.idle === 'stop')
+                    return outcome(WorkflowState.Waiting);
+                if (raced.idle === 'external')
+                    out.write(`${pc.green('✓')} answered in Studio\n`);
+                continue;
+            }
+            pendingNext = null;
+            if (raced.result.done)
+                throw new CliError('Event stream ended before the run reached a final state.');
+            event = raced.result.value;
+            if (resolvesPrompt(prompt, event)) {
+                prompt.controller.abort();
+                const idle = await prompt.result;
+                prompt = null;
+                if (idle === 'stop')
+                    return outcome(WorkflowState.Waiting);
+                if (idle === 'external')
+                    out.write(`${pc.green('✓')} answered in Studio\n`);
+            }
+        }
+        else {
+            const { value, done } = await pullNext();
+            pendingNext = null;
+            if (done)
+                throw new CliError('Event stream ended before the run reached a final state.');
+            event = value;
+        }
+        const handled = handleEvent(event);
+        if (handled === 'idle') {
+            if (!options.onIdle)
+                return outcome(WorkflowState.Waiting);
+            prompt ??= startPrompt();
+        }
+        else if (handled) {
+            return handled;
+        }
+    }
+}
+//# sourceMappingURL=follow.js.map

package/dist/run/follow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow.js","sourceRoot":"","sources":["../../src/run/follow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA4BrD,MAAM,eAAe,GAA6B;IAChD,aAAa,CAAC,SAAS;IACvB,aAAa,CAAC,MAAM;IACpB,aAAa,CAAC,QAAQ;CACvB,CAAC;AAEF,MAAM,WAAW,GAA6B,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;AAkB5F,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAA4C,EAC5C,UAAkB,EAClB,GAA0B,EAC1B,UAAyB,EAAE;IAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,YAAgC,CAAC;IACrC,IAAI,cAAc,GAAG,SAAS,CAAC;IAC/B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,SAAS,GAAG,KAAK,CAAC;IACpB,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE;QAC1C,IAAI,CAAC,YAAY;YAAE,OAAO;QAC1B,YAAY,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrG,YAAY,GAAG,SAAS,CAAC;IAC3B,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,MAAqB,EAAiB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;IAG3G,MAAM,WAAW,GAAG,CAAC,KAAoB,EAAsC,EAAE;QAC/E,IAAI,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU;YAAE,OAAO,SAAS,CAAC;QAElF,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,yBAAyB;gBAC5B,SAAS,GAAG,IAAI,CAAC;gBACjB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACvB,MAAM;YACR,KAAK,mBAAmB,CAAC;YACzB,KAAK,oBAAoB;gBACvB,YAAY,EAAE,CAAC;gBACf,MAAM;YACR,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;oBAChD,UAAU,EAAE,CAAC;oBAEb,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;wBAC1B,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC;wBAC3B,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;wBAC5B,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;4BAC5C,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC;wBAC3C,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3C,YAAY,EAAE,CAAC;oBACf,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC/B,CAAC;gBACD,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBACvC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC3B,OAAO,MAAM,CAAC;gBAChB,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,GAAkB,EAAE;QACtC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAkB,EAAE,UAAU,EAAmB,CAAC;QAC/D,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAO,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE;YACzD,OAAO,CAAC,UAAU,GAAG,EAAE,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAGF,MAAM,cAAc,GAAG,CAAC,MAAqB,EAAE,KAAoB,EAAW,EAAE;QAC9E,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAChF,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,IAAI,UAAU,CAAC;QACzD,OAAO,KAAK,CAAC,UAAU,KAAK,gBAAgB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtF,CAAC,CAAC;IAEF,IAAI,MAAM,GAAyB,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAClG,IAAI,WAAW,GAAkD,IAAI,CAAC;IACtE,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC,WAAW,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAEvD,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,KAAoB,CAAC;QAEzB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAC/B,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;gBACjE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC;aAChE,CAAC,CAAC;YACH,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,MAAM,GAAG,IAAI,CAAC;gBACd,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBACjE,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;oBAAE,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;gBAClF,SAAS;YACX,CAAC;YACD,WAAW,GAAG,IAAI,CAAC;YACnB,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI;gBAAE,MAAM,IAAI,QAAQ,CAAC,0DAA0D,CAAC,CAAC;YACtG,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;YAE3B,IAAI,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;gBACjC,MAAM,GAAG,IAAI,CAAC;gBACd,IAAI,IAAI,KAAK,MAAM;oBAAE,OAAO,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC3D,IAAI,IAAI,KAAK,UAAU;oBAAE,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;YACzC,WAAW,GAAG,IAAI,CAAC;YACnB,IAAI,IAAI;gBAAE,MAAM,IAAI,QAAQ,CAAC,0DAA0D,CAAC,CAAC;YACzF,KAAK,GAAG,KAAK,CAAC;QAChB,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,MAAM;gBAAE,OAAO,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC3D,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,CAAC;aAAM,IAAI,OAAO,EAAE,CAAC;YACnB,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/run/workspace.d.ts

@@ -0,0 +1,3 @@
+import type { LoopstackClient } from '@loopstack/client';
+export declare function resolveWorkspaceId(client: LoopstackClient, workflowName: string, explicit?: string, pinned?: string): Promise<string>;
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/run/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASzD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAwBjB"}

package/dist/run/workspace.js

@@ -0,0 +1,26 @@
+import { SortOrder } from '@loopstack/contracts/enums';
+import { CliError } from '../errors.js';
+export async function resolveWorkspaceId(client, workflowName, explicit, pinned) {
+    if (explicit)
+        return explicit;
+    if (pinned)
+        return pinned;
+    const apps = await client.config.apps();
+    const app = apps.find((candidate) => candidate.workflows?.some((workflow) => workflow.workflowName === workflowName));
+    if (!app) {
+        const available = apps.flatMap((candidate) => candidate.workflows?.map((w) => w.workflowName) ?? []);
+        throw new CliError(`Unknown workflow "${workflowName}". Available workflows: ${available.sort().join(', ') || '(none)'}`);
+    }
+    const page = await client.workspaces.list({
+        filter: { appName: app.appName },
+        sortBy: [{ field: 'createdAt', order: SortOrder.DESC }],
+        page: 0,
+        limit: 1,
+    });
+    const existing = page.data[0];
+    if (existing)
+        return existing.id;
+    const created = await client.workspaces.create({ title: 'CLI', appName: app.appName });
+    return created.id;
+}
+//# sourceMappingURL=workspace.js.map

package/dist/run/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/run/workspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAOxC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAuB,EACvB,YAAoB,EACpB,QAAiB,EACjB,MAAe;IAEf,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,KAAK,YAAY,CAAC,CAAC,CAAC;IACtH,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;QACrG,MAAM,IAAI,QAAQ,CAChB,qBAAqB,YAAY,2BAA2B,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CACtG,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;QACxC,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;QAChC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;KACT,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,EAAE,CAAC;IAEjC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,OAAO,OAAO,CAAC,EAAE,CAAC;AACpB,CAAC"}

package/fixtures/app/CLAUDE.md

@@ -0,0 +1,40 @@
+# Loopstack App
+
+This is a [Loopstack](https://loopstack.ai) app — a NestJS backend where AI workflows are code: state machines with explicit transitions, typed documents, and tools, all observable in Studio and from the CLI.
+
+## Where things live
+
+- `src/app.module.ts` — mounts `LoopstackModule.forRoot()` plus your app modules
+- `src/hello/` — a complete example: `hello.module.ts` (`@StudioApp` groups workflows into an app) and `hello.workflow.ts` (a minimal workflow)
+- `docker-compose.yml` — Postgres, Redis, and Studio (http://localhost:5173)
+- `.env` — configuration; add API keys here when a module needs them
+
+## The feedback loop — use the CLI, not guesswork
+
+The `loopstack` CLI talks to the running backend (`npm run start:dev`, http://localhost:3000):
+
+```bash
+loopstack list                        # what can be run right now
+loopstack run <workflow> --arg k=v    # run it, streamed live; --json for machine-readable output
+loopstack runs                        # recent runs, waiting-for-input first
+loopstack runs <run-id> --follow      # audit trail; reattach to a waiting run and answer prompts
+loopstack watch --json                # NDJSON event firehose while you develop
+```
+
+Exit codes: `0` completed, `1` failed, `2` connection/config error, `3` waiting for input in a non-interactive shell. After changing code, the dev server reloads automatically — rerun the workflow to verify.
+
+## Writing workflows
+
+Follow `src/hello/hello.workflow.ts` as the canonical example:
+
+- A workflow is a class with `@Workflow({ title, description, schema })` extending `BaseWorkflow<Args>` (the zod `schema` types and validates its args); register it in the `@StudioApp` module.
+- Transitions are methods with `@Transition({ to: 'x' })` (initial, `from` defaults to `'start'`) or `@Transition({ from: 'x', to: 'end' })` (final). Signatures: `(state, ctx)` for automatic transitions, `(state, payload, ctx)` for wait transitions. Workflow args are on `ctx.args`.
+- Transitions return nothing — mutate via `this.assignState(partial)` and publish results via `this.assignResult(partial)`. Use `async` only when the body awaits.
+- Documents are classes with `@Document({ schema })` (zod) saved via `this.documentStore.save(SomeDocument, data)` — they are what Studio renders.
+- Tools are NestJS providers with `@Tool({ name })`, implementing `protected async handle(args, ctx, options?): Promise<ToolEnvelope>`.
+
+## Learning more
+
+- Docs: https://loopstack.ai/docs — for agents, the full corpus is at https://loopstack.ai/llms.txt (route via titles, fetch what you need)
+- Registry of feature modules and examples (LLM providers, HITL prompts, agents, git, secrets, sandboxes): https://loopstack.ai/registry — each package README has an installation section; prefer adapting a registry example over building from scratch
+- CLI reference: https://loopstack.ai/docs/reference/cli

package/fixtures/app/README.md

@@ -0,0 +1,21 @@
+# Loopstack App
+
+Scaffolded with `loopstack create`.
+
+## Quickstart
+
+```bash
+docker compose up -d     # Postgres, Redis, and Studio
+npm run start:dev        # the backend on http://localhost:3000
+```
+
+Open Studio at [http://localhost:5173](http://localhost:5173), or run the hello workflow from the terminal:
+
+```bash
+npx @loopstack/cli run hello --arg name=You
+```
+
+## Next steps
+
+- Build your first workflow: https://loopstack.ai/docs
+- Add feature modules and example workflows from the registry: https://loopstack.ai/registry

package/fixtures/app/docker-compose.yml

@@ -0,0 +1,33 @@
+name: loopstack
+
+services:
+  postgres:
+    image: postgres:16-alpine
+    ports:
+      - '5432:5432'
+    environment:
+      POSTGRES_DB: ${DATABASE_NAME:-postgres}
+      POSTGRES_USER: ${DATABASE_USERNAME:-postgres}
+      POSTGRES_PASSWORD: ${DATABASE_PASSWORD:-admin}
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+
+  redis:
+    image: redis:8-alpine
+    ports:
+      - '6379:6379'
+    command: ['redis-server', '--appendonly', 'yes']
+    volumes:
+      - redis_data:/data
+
+  studio:
+    image: ghcr.io/loopstack-ai/loopstack-studio:latest
+    pull_policy: always
+    ports:
+      - '5173:3000'
+    environment:
+      VITE_API_URL: ${VITE_API_URL:-http://localhost:3000}
+
+volumes:
+  postgres_data:
+  redis_data: