@loopstack/cli 0.1.0

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

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

package/dist/commands/watch.js

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

package/dist/commands/watch.js.map

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

package/dist/config/config.d.ts

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

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

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

package/dist/config/config.js

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

package/dist/config/config.js.map

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

package/dist/config/resolve.d.ts

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

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

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

package/dist/config/resolve.js

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

package/dist/config/resolve.js.map

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

package/dist/errors.d.ts

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

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -0,0 +1,36 @@
+import pc from 'picocolors';
+import { LoopstackApiError } from '@loopstack/client';
+export const ExitCode = {
+    Success: 0,
+    RunFailed: 1,
+    ConnectionOrConfig: 2,
+    NeedsInput: 3,
+};
+export class CliError extends Error {
+    exitCode;
+    constructor(message, exitCode = ExitCode.ConnectionOrConfig) {
+        super(message);
+        this.exitCode = exitCode;
+    }
+}
+function isNetworkError(error) {
+    return error instanceof TypeError && /fetch failed/i.test(error.message);
+}
+export function handleError(error, url) {
+    if (error instanceof CliError) {
+        console.error(pc.red(`✖ ${error.message}`));
+        process.exit(error.exitCode);
+    }
+    if (error instanceof LoopstackApiError) {
+        const hint = error.status === 401 || error.status === 403 ? ' — check your token (loopstack login)' : '';
+        console.error(pc.red(`✖ API error ${error.status}: ${error.message}${hint}`));
+        process.exit(ExitCode.ConnectionOrConfig);
+    }
+    if (isNetworkError(error)) {
+        console.error(pc.red(`✖ Cannot reach the Loopstack backend${url ? ` at ${url}` : ''} — is it running?`));
+        process.exit(ExitCode.ConnectionOrConfig);
+    }
+    console.error(pc.red(`✖ ${error instanceof Error ? (error.stack ?? error.message) : String(error)}`));
+    process.exit(ExitCode.ConnectionOrConfig);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,CAAC;IACZ,kBAAkB,EAAE,CAAC;IACrB,UAAU,EAAE,CAAC;CACL,CAAC;AAEX,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGtB;IAFX,YACE,OAAe,EACN,WAAmB,QAAQ,CAAC,kBAAkB;QAEvD,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,aAAQ,GAAR,QAAQ,CAAsC;IAGzD,CAAC;CACF;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,SAAS,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC3E,CAAC;AAGD,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,GAAY;IACtD,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,uCAAuC,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACzG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACtG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AAC5C,CAAC"}

package/dist/hitl/discovery.d.ts

@@ -0,0 +1,15 @@
+import type { LoopstackClient } from '@loopstack/client';
+import type { DocumentItemInterface, WorkflowFullInterface } from '@loopstack/contracts/api';
+export interface WidgetConfig {
+    widget: string;
+    options?: Record<string, unknown>;
+    schema?: Record<string, unknown>;
+}
+export declare function fetchDocumentWidgets(client: LoopstackClient): Promise<Map<string, WidgetConfig>>;
+export interface ActivePrompt {
+    workflow: WorkflowFullInterface;
+    document?: DocumentItemInterface;
+    widget?: WidgetConfig;
+}
+export declare function findActivePrompt(client: LoopstackClient, rootWorkflowId: string, widgets: Map<string, WidgetConfig>): Promise<ActivePrompt | undefined>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/hitl/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/hitl/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAI7F,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAMD,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAetG;AAED,MAAM,WAAW,YAAY;IAE3B,QAAQ,EAAE,qBAAqB,CAAC;IAEhC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAOD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACjC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAuCnC"}

package/dist/hitl/discovery.js

@@ -0,0 +1,53 @@
+import { SortOrder, WorkflowState } from '@loopstack/contracts/enums';
+const PROMPT_WIDGETS = new Set(['text-prompt', 'confirm-prompt', 'choices', 'form']);
+export async function fetchDocumentWidgets(client) {
+    const apps = await client.config.apps();
+    const widgets = new Map();
+    for (const app of apps) {
+        for (const document of app.documents ?? []) {
+            const widget = document.ui?.widgets?.[0];
+            if (widget) {
+                widgets.set(document.documentName, {
+                    ...widget,
+                    schema: document.schema,
+                });
+            }
+        }
+    }
+    return widgets;
+}
+export async function findActivePrompt(client, rootWorkflowId, widgets) {
+    const queue = [rootWorkflowId];
+    const visited = new Set();
+    let fallback;
+    while (queue.length > 0) {
+        const id = queue.shift();
+        if (visited.has(id))
+            continue;
+        visited.add(id);
+        const workflow = await client.workflows.get(id);
+        const isIdle = workflow.status === WorkflowState.Waiting || workflow.status === WorkflowState.Paused;
+        if (isIdle && workflow.availableTransitions?.length) {
+            const page = await client.documents.list({
+                filter: { workflowId: id, isInvalidated: false },
+                sortBy: [{ field: 'index', order: SortOrder.DESC }],
+                limit: 10,
+            });
+            const prompt = page.data.find((document) => {
+                const widget = widgets.get(document.documentName);
+                if (!widget || !PROMPT_WIDGETS.has(widget.widget))
+                    return false;
+                const content = document.content;
+                return !content || content.answer === undefined;
+            });
+            if (prompt) {
+                return { workflow, document: prompt, widget: widgets.get(prompt.documentName) };
+            }
+            fallback ??= { workflow };
+        }
+        const children = await client.workflows.list({ filter: { parentId: id } });
+        queue.push(...children.data.map((child) => child.id));
+    }
+    return fallback;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/hitl/discovery.js.map

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

package/dist/hitl/editor.d.ts

@@ -0,0 +1,4 @@
+export declare function buildFormSkeleton(content: unknown, schema?: Record<string, unknown>): Record<string, unknown>;
+export declare function describeFormFields(schema?: Record<string, unknown>): string[];
+export declare function editPayloadInEditor(initial: Record<string, unknown>, out: NodeJS.WritableStream): unknown;
+//# sourceMappingURL=editor.d.ts.map

package/dist/hitl/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/hitl/editor.ts"],"names":[],"mappings":"AAiCA,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS7G;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAU7E;AAQD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAqBzG"}

package/dist/hitl/editor.js

@@ -0,0 +1,73 @@
+import { spawnSync } from 'node:child_process';
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import pc from 'picocolors';
+function emptyValue(property) {
+    if (property.default !== undefined)
+        return property.default;
+    switch (property.type) {
+        case 'string':
+            return '';
+        case 'number':
+        case 'integer':
+            return 0;
+        case 'boolean':
+            return false;
+        case 'array':
+            return [];
+        case 'object':
+            return {};
+        default:
+            return null;
+    }
+}
+export function buildFormSkeleton(content, schema) {
+    if (content && typeof content === 'object' && Object.keys(content).length > 0) {
+        return content;
+    }
+    const typed = schema;
+    if (typed?.type === 'object' && typed.properties) {
+        return Object.fromEntries(Object.entries(typed.properties).map(([key, property]) => [key, emptyValue(property)]));
+    }
+    return {};
+}
+export function describeFormFields(schema) {
+    const typed = schema;
+    if (typed?.type !== 'object' || !typed.properties)
+        return [];
+    const required = new Set(typed.required ?? []);
+    return Object.entries(typed.properties).map(([key, property]) => {
+        const parts = [property.type ?? 'any'];
+        if (required.has(key))
+            parts.push('required');
+        const description = property.description ? ` — ${property.description}` : '';
+        return `  ${key} (${parts.join(', ')})${description}`;
+    });
+}
+export function editPayloadInEditor(initial, out) {
+    const editor = process.env.EDITOR || process.env.VISUAL || 'vi';
+    const dir = mkdtempSync(join(tmpdir(), 'loopstack-'));
+    const file = join(dir, 'answer.json');
+    writeFileSync(file, JSON.stringify(initial, null, 2) + '\n');
+    try {
+        while (true) {
+            const result = spawnSync(`${editor} ${JSON.stringify(file)}`, { shell: true, stdio: 'inherit' });
+            if (result.status !== 0)
+                return undefined;
+            const text = readFileSync(file, 'utf8').trim();
+            if (!text)
+                return undefined;
+            try {
+                return JSON.parse(text);
+            }
+            catch (error) {
+                out.write(pc.red(`invalid JSON (${error instanceof Error ? error.message : String(error)}) — reopening…\n`));
+            }
+        }
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=editor.js.map

package/dist/hitl/editor.js.map

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

package/dist/hitl/idle-handler.d.ts

@@ -0,0 +1,8 @@
+import type { LoopstackClient } from '@loopstack/client';
+import type { IdleOutcome } from '../run/follow.js';
+export interface IdleHandlerOptions {
+    studioUrl?: string;
+    editor?: boolean;
+}
+export declare function createIdleHandler(client: LoopstackClient, rootWorkflowId: string, out: NodeJS.WritableStream, options?: IdleHandlerOptions): (signal: AbortSignal, onPromptWorkflow: (id: string) => void) => Promise<IdleOutcome>;
+//# sourceMappingURL=idle-handler.d.ts.map

package/dist/hitl/idle-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-handler.d.ts","sourceRoot":"","sources":["../../src/hitl/idle-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAKpD,MAAM,WAAW,kBAAkB;IAEjC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA2BD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,EACvB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,OAAO,GAAE,kBAAuB,GAC/B,CAAC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,WAAW,CAAC,CAkEvF"}

package/dist/hitl/idle-handler.js

@@ -0,0 +1,70 @@
+import { stdin } from 'node:process';
+import pc from 'picocolors';
+import { WorkflowState } from '@loopstack/contracts/enums';
+import { fetchDocumentWidgets, findActivePrompt } from './discovery.js';
+import { describePrompt, promptForAnswer } from './prompt.js';
+const abortableSleep = (ms, signal) => new Promise((resolve) => {
+    const timer = setTimeout(resolve, ms);
+    signal.addEventListener('abort', () => {
+        clearTimeout(timer);
+        resolve();
+    }, { once: true });
+});
+const aborted = (signal) => new Promise((resolve) => signal.addEventListener('abort', () => resolve(), { once: true }));
+export function createIdleHandler(client, rootWorkflowId, out, options = {}) {
+    let widgetsPromise;
+    let lastAnswerAt = 0;
+    return async (signal, onPromptWorkflow) => {
+        widgetsPromise ??= fetchDocumentWidgets(client);
+        const widgets = await widgetsPromise;
+        let prompt = await findActivePrompt(client, rootWorkflowId, widgets);
+        for (let attempt = 0; attempt < 4 && (!prompt || !prompt.document); attempt++) {
+            if (signal.aborted)
+                return 'external';
+            await abortableSleep(750, signal);
+            prompt = (await findActivePrompt(client, rootWorkflowId, widgets)) ?? prompt;
+        }
+        if (signal.aborted)
+            return 'external';
+        if (!prompt) {
+            return Date.now() - lastAnswerAt < 10_000 ? 'answered' : 'stop';
+        }
+        onPromptWorkflow(prompt.workflow.id);
+        if (!stdin.isTTY) {
+            out.write(`${pc.yellow('⏸')} waiting for input: ${describePrompt(prompt)}\n`);
+            if (options.studioUrl)
+                out.write(pc.dim(`⧉ answer in Studio: ${options.studioUrl}\n`));
+            return 'stop';
+        }
+        try {
+            const answer = await promptForAnswer(prompt, out, {
+                signal,
+                studioUrl: options.studioUrl,
+                useEditor: options.editor,
+            });
+            if (answer === 'handoff') {
+                await aborted(signal);
+                return 'external';
+            }
+            if (!answer)
+                return 'stop';
+            await client.processor.run(prompt.workflow.id, {
+                transition: { id: answer.transitionId, workflowId: prompt.workflow.id, payload: answer.payload },
+            });
+            lastAnswerAt = Date.now();
+            return 'answered';
+        }
+        catch (error) {
+            if (signal.aborted)
+                return 'external';
+            if (error instanceof Error && error.name === 'AbortError')
+                return 'stop';
+            const current = await client.workflows.get(prompt.workflow.id).catch(() => undefined);
+            if (current && current.status !== WorkflowState.Waiting && current.status !== WorkflowState.Paused) {
+                return 'external';
+            }
+            throw error;
+        }
+    };
+}
+//# sourceMappingURL=idle-handler.js.map

package/dist/hitl/idle-handler.js.map

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

package/dist/hitl/prompt.d.ts

@@ -0,0 +1,14 @@
+import type { ActivePrompt } from './discovery.js';
+export interface PromptAnswer {
+    transitionId: string;
+    payload: unknown;
+}
+export type PromptResult = PromptAnswer | 'handoff' | undefined;
+export interface PromptOptions {
+    signal?: AbortSignal;
+    studioUrl?: string;
+    useEditor?: boolean;
+}
+export declare function promptForAnswer(prompt: ActivePrompt, out: NodeJS.WritableStream, options?: PromptOptions): Promise<PromptResult>;
+export declare function describePrompt(prompt: ActivePrompt): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/hitl/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/hitl/prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,aAAa;IAE5B,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAgCD,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAyEvB;AAiCD,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAK3D"}