@loopstack/cli 0.15.1 → 0.18.0

package/dist/widgets/document/secret-request.widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-request.widget.js","sourceRoot":"","sources":["../../../src/widgets/document/secret-request.widget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAQ5B,MAAM,CAAC,MAAM,mBAAmB,GAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACvE,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAE,OAAO,CAAC,SAAiC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrG,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC;IAC/G,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC9B,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,YAAY,EAAE,CAAC,0BAA0B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnG,CAAC,CAAC"}

package/dist/widgets/editor.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/widgets/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;AAQD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAqBzG"}

package/dist/widgets/editor.js

@@ -0,0 +1,60 @@
+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 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/widgets/editor.js.map

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

package/dist/widgets/field/field-widgets.d.ts

@@ -0,0 +1,6 @@
+import type { FieldWidget } from '../types.js';
+export declare function resolveFieldWidget(widgetName: string | undefined): FieldWidget;
+export declare function formatEntry(key: string, value: unknown, indent: number): string[];
+export declare function formatEntries(obj: Record<string, unknown>, indent: number): string[];
+export declare function stripCodeFences(text: string): string;
+//# sourceMappingURL=field-widgets.d.ts.map

package/dist/widgets/field/field-widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-widgets.d.ts","sourceRoot":"","sources":["../../../src/widgets/field/field-widgets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAqC/C,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAG9E;AAWD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAuBjF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAEpF;AAQD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/dist/widgets/field/field-widgets.js

@@ -0,0 +1,64 @@
+import pc from 'picocolors';
+const defaultField = (key, value) => formatEntry(key, value, 0);
+const markdownView = (key, value) => labeledBlock(key, typeof value === 'string' ? value : JSON.stringify(value));
+const codeView = (key, value) => labeledBlock(key, typeof value === 'string' ? stripCodeFences(value) : JSON.stringify(value));
+const jsonField = (key, value) => labeledBlock(key, JSON.stringify(value, null, 2));
+const FIELD_WIDGETS = new Map([
+    ['input', defaultField],
+    ['textarea', defaultField],
+    ['number', defaultField],
+    ['checkbox', defaultField],
+    ['radio', defaultField],
+    ['switch', defaultField],
+    ['select', defaultField],
+    ['slider', defaultField],
+    ['markdown-view', markdownView],
+    ['code-view', codeView],
+]);
+export function resolveFieldWidget(widgetName) {
+    if (!widgetName)
+        return defaultField;
+    return FIELD_WIDGETS.get(widgetName) ?? jsonField;
+}
+function labeledBlock(key, text) {
+    return [pc.dim(`${key}:`), ...text.split('\n')];
+}
+export function formatEntry(key, value, indent) {
+    const pad = '  '.repeat(indent);
+    if (value == null)
+        return [];
+    if (Array.isArray(value)) {
+        const lines = [`${pad}${pc.dim(`${key}:`)}`];
+        for (const item of value) {
+            if (item && typeof item === 'object' && !Array.isArray(item)) {
+                lines.push(`${pad}  -`);
+                lines.push(...formatEntries(item, indent + 2));
+            }
+            else {
+                lines.push(`${pad}  - ${formatScalar(item)}`);
+            }
+        }
+        return lines;
+    }
+    if (typeof value === 'object') {
+        return [`${pad}${pc.dim(`${key}:`)}`, ...formatEntries(value, indent + 1)];
+    }
+    const text = formatScalar(value);
+    if (text.includes('\n')) {
+        return [`${pad}${pc.dim(`${key}:`)}`, ...text.split('\n').map((line) => `${pad}${line}`)];
+    }
+    return [`${pad}${pc.dim(`${key}:`)} ${text}`];
+}
+export function formatEntries(obj, indent) {
+    return Object.entries(obj).flatMap(([key, value]) => formatEntry(key, value, indent));
+}
+function formatScalar(value) {
+    if (typeof value === 'string')
+        return stripCodeFences(value);
+    return JSON.stringify(value);
+}
+export function stripCodeFences(text) {
+    const match = text.trim().match(/^```[^\n]*\n([\s\S]*?)\n?```$/);
+    return match ? match[1] : text;
+}
+//# sourceMappingURL=field-widgets.js.map

package/dist/widgets/field/field-widgets.js.map

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

package/dist/widgets/registry.d.ts

@@ -0,0 +1,6 @@
+import type { CollectWidget, DocumentWidget } from './types.js';
+export declare function resolveDocumentWidget(widgetName: string | undefined): DocumentWidget | undefined;
+export declare function resolveCollectWidget(widgetName: string | undefined): CollectWidget | undefined;
+export declare function isCollectable(widgetName: string | undefined): boolean;
+export declare function resolveHandoff(widgetName: string | undefined, content: Record<string, unknown>): string | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/widgets/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/widgets/registry.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAa,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqC3E,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAKhG;AAGD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAE9F;AAGD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAErE;AAGD,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAEnH"}

package/dist/widgets/registry.js

@@ -0,0 +1,45 @@
+import { collectForm } from './collect/form.collect.js';
+import { collectChoices, collectConfirm, collectText } from './collect/prompts.collect.js';
+import { collectSecretInput } from './collect/secret-input.collect.js';
+import { collectButton, collectPromptInput } from './collect/workflow.collect.js';
+import { formWidget } from './document/form.widget.js';
+import { jsonWidget } from './document/json.widget.js';
+import { linkWidget } from './document/link.widget.js';
+import { llmMessageWidget } from './document/llm-message.widget.js';
+import { errorWidget, markdownWidget, messageWidget } from './document/message.widget.js';
+import { oauthHandoff, oauthPromptWidget } from './document/oauth-prompt.widget.js';
+import { secretRequestWidget } from './document/secret-request.widget.js';
+const WIDGETS = new Map([
+    ['llm-message', { render: llmMessageWidget }],
+    ['message', { render: messageWidget }],
+    ['plain', { render: messageWidget }],
+    ['markdown', { render: markdownWidget }],
+    ['error', { render: errorWidget }],
+    ['link', { render: linkWidget }],
+    ['form', { render: formWidget, collect: collectForm }],
+    ['secret-input', { render: secretRequestWidget, collect: collectSecretInput }],
+    ['oauth-prompt', { render: oauthPromptWidget, handoff: oauthHandoff }],
+    ['text-prompt', { collect: collectText }],
+    ['confirm-prompt', { collect: collectConfirm }],
+    ['choices', { collect: collectChoices }],
+    ['prompt-input', { collect: collectPromptInput }],
+    ['button', { collect: collectButton }],
+]);
+export function resolveDocumentWidget(widgetName) {
+    if (!widgetName)
+        return undefined;
+    const entry = WIDGETS.get(widgetName);
+    if (entry)
+        return entry.render;
+    return jsonWidget;
+}
+export function resolveCollectWidget(widgetName) {
+    return widgetName ? WIDGETS.get(widgetName)?.collect : undefined;
+}
+export function isCollectable(widgetName) {
+    return resolveCollectWidget(widgetName) !== undefined;
+}
+export function resolveHandoff(widgetName, content) {
+    return widgetName ? WIDGETS.get(widgetName)?.handoff?.(content) : undefined;
+}
+//# sourceMappingURL=registry.js.map

package/dist/widgets/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/widgets/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAU1E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAoB;IACzC,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC7C,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACtC,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACpC,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACxC,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAClC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAChC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACtD,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAG9E,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAGtE,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACzC,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC/C,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAGxC,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IACjD,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;CACvC,CAAC,CAAC;AAOH,MAAM,UAAU,qBAAqB,CAAC,UAA8B;IAClE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC/B,OAAO,UAAU,CAAC;AACpB,CAAC;AAGD,MAAM,UAAU,oBAAoB,CAAC,UAA8B;IACjE,OAAO,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC;AAGD,MAAM,UAAU,aAAa,CAAC,UAA8B;IAC1D,OAAO,oBAAoB,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC;AACxD,CAAC;AAGD,MAAM,UAAU,cAAc,CAAC,UAA8B,EAAE,OAAgC;IAC7F,OAAO,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC"}

package/dist/widgets/types.d.ts

@@ -0,0 +1,44 @@
+export interface WidgetContext {
+    documentName: string;
+    workflowId: string;
+    options?: Record<string, unknown>;
+    schema?: Record<string, unknown>;
+    streamedMessageIds?: ReadonlySet<string>;
+    streamedToolCallIds?: ReadonlySet<string>;
+    studioUrl?: (workflowId: string) => string | undefined;
+}
+export interface WidgetOutput {
+    block(text: string): void;
+    line(text: string): void;
+}
+export type DocumentWidget = (content: Record<string, unknown>, ctx: WidgetContext, out: WidgetOutput) => void;
+export type FieldWidget = (key: string, value: unknown) => string[];
+export interface PromptAnswer {
+    transitionId: string;
+    payload: unknown;
+}
+export interface CollectHttp {
+    get<T = unknown>(path: string): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown): Promise<T>;
+}
+export interface CollectContext {
+    content: Record<string, unknown>;
+    documentName?: string;
+    options?: Record<string, unknown>;
+    schema?: Record<string, unknown>;
+    availableTransitions: string[];
+    workspaceId?: string;
+    http?: CollectHttp;
+}
+export interface CollectIo {
+    ask(query: string): Promise<string>;
+    askSecret(query: string): Promise<string>;
+    out: NodeJS.WritableStream;
+}
+export type CollectWidget = (ctx: CollectContext, io: CollectIo) => Promise<PromptAnswer | undefined>;
+export interface CliWidget {
+    render?: DocumentWidget;
+    collect?: CollectWidget;
+    handoff?: (content: Record<string, unknown>) => string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/widgets/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/widgets/types.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IAErB,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAEzC,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1C,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,WAAW,YAAY;IAE3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;AAG/G,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,EAAE,CAAC;AAGpE,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAOD,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5D;AAGD,MAAM,WAAW,cAAc;IAE7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAE/B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IAExB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC;CAC5B;AAOD,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;AAGtG,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IAMxB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;CACpE"}

package/dist/widgets/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/widgets/types.js.map

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

package/fixtures/app/CLAUDE.md

@@ -0,0 +1,54 @@
+# 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>               # one run's audit trail (+ pendingPrompt under --json)
+loopstack answer <run-id> --arg k=v   # answer a waiting run's prompt non-interactively
+loopstack attach <run-id>             # rejoin a run live and answer its prompts interactively
+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.
+
+When a run exits `3`, it parked on a human question. Close the loop instead of stopping: read the question with `loopstack runs <run-id> --json` (the `pendingPrompt` field carries the description, the expected answer schema, and the transition), ask the human for their answer, submit it with `loopstack answer <run-id> --arg key=value`, then re-check `loopstack runs <run-id>` for the outcome. Never invent an answer to a human question yourself.
+
+## 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>`.
+
+## Testing
+
+Tests are ordinary vitest tests that run the real engine in-process — no backend, no database:
+
+- `runWorkflow(MyWorkflow, args, { providers, answers })` from `@loopstack/testing` executes the workflow and returns `{ status, path, result, documents, document(key) }` for assertions. Script HITL input with `answers: { waitTransitionName: payload }`; sub-workflows run inline.
+- `testTool().forTool(MyTool)` unit-tests a tool's `handle()` in isolation.
+- For deterministic LLM/tool regression tests, record a live run (`loopstack run <workflow> --trace`, then `loopstack runs <run-id> --record fixture.json`) and pass `replay: replay('fixture.json')` to `runWorkflow`. Omit `replay` to test against real providers — keep those assertions structural and run them on demand, not in CI.
+
+Write workflow tests for every non-trivial workflow you build. Guide: https://loopstack.ai/docs/build/testing
+
+## 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:

package/fixtures/app/env.example

@@ -0,0 +1,16 @@
+# All values are optional — the defaults below match docker-compose.yml.
+
+# PORT=3000
+
+# DATABASE_HOST=localhost
+# DATABASE_PORT=5432
+# DATABASE_USERNAME=postgres
+# DATABASE_PASSWORD=admin
+# DATABASE_NAME=postgres
+
+# REDIS_HOST=localhost
+# REDIS_PORT=6379
+# REDIS_PASSWORD=
+
+# API keys for LLM feature modules (e.g. @loopstack/claude-module)
+# ANTHROPIC_API_KEY=

package/fixtures/app/nest-cli.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true,
+    "assets": ["**/*.yaml"],
+    "watchAssets": true
+  }
+}

package/fixtures/app/src/app.module.ts

@@ -0,0 +1,8 @@
+import { Module } from '@nestjs/common';
+import { LoopstackModule } from '@loopstack/loopstack-module';
+import { HelloModule } from './hello/hello.module';
+
+@Module({
+  imports: [LoopstackModule.forRoot(), HelloModule],
+})
+export class AppModule {}

package/fixtures/app/src/hello/hello.module.ts

@@ -0,0 +1,12 @@
+import { Module } from '@nestjs/common';
+import { StudioApp } from '@loopstack/common';
+import { HelloWorkflow } from './hello.workflow';
+
+@StudioApp({
+  title: 'My First App',
+  workflows: [HelloWorkflow],
+})
+@Module({
+  providers: [HelloWorkflow],
+})
+export class HelloModule {}

package/fixtures/app/src/hello/hello.workflow.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { BaseWorkflow, MessageDocument, Transition, Workflow } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+
+const InputSchema = z.object({
+  name: z.string().default('World'),
+});
+
+type InputArgs = z.infer<typeof InputSchema>;
+
+@Workflow({
+  title: 'Hello World',
+  description: 'Greets you by name — replace this with your first real workflow.',
+  schema: InputSchema,
+})
+export class HelloWorkflow extends BaseWorkflow<InputArgs> {
+  @Transition({ from: 'start', to: 'end' })
+  async greet(_state: unknown, ctx: RunContext<InputArgs>) {
+    const greeting = `Hello, ${ctx.args.name}! 👋`;
+
+    await this.documentStore.save(MessageDocument, {
+      role: 'assistant',
+      text: greeting,
+    });
+
+    this.assignResult({ greeting });
+  }
+}

package/fixtures/app/src/main.ts

@@ -0,0 +1,11 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  // Graceful shutdown: on SIGTERM/SIGINT the BullMQ worker finishes in-flight
+  // transitions before the process exits, instead of stalling them.
+  app.enableShutdownHooks();
+  await app.listen(process.env.PORT ?? 3000);
+}
+void bootstrap();

package/package.json

@@ -1,15 +1,41 @@
 {
   "name": "@loopstack/cli",
-  "version": "0.15.1",
-  "description": "Global wrapper for Loopstack local commands",
+  "displayName": "Loopstack CLI",
+  "description": "Run, trace, and watch Loopstack workflows from the terminal",
+  "version": "0.18.0",
+  "license": "MIT",
+  "author": {
+    "name": "Jakob Klippel",
+    "url": "https://www.linkedin.com/in/jakob-klippel/"
+  },
+  "type": "module",
   "bin": {
-    "loopstack": "./bin/loopstack.js"
+    "loopstack": "dist/main.js"
   },
-  "files": [
-    "bin"
-  ],
-  "keywords": ["loopstack", "cli"],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "engines": {
-    "node": ">=16"
-  }
-}
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "compile": "tsc --noEmit",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "watch": "tsc -p tsconfig.build.json --watch"
+  },
+  "dependencies": {
+    "@loopstack/client": "^0.38.0",
+    "@loopstack/contracts": "^0.38.0",
+    "commander": "^15.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.6"
+  },
+  "files": [
+    "dist",
+    "fixtures"
+  ]
+}

package/bin/loopstack.js

@@ -1,33 +0,0 @@
-#!/usr/bin/env node
-
-const { spawnSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-function findPackageJson() {
-  let dir = process.cwd();
-  const root = path.parse(dir).root;
-
-  while (dir !== root) {
-    if (fs.existsSync(path.join(dir, 'package.json'))) {
-      return dir;
-    }
-    dir = path.dirname(dir);
-  }
-
-  return null;
-}
-
-const projectRoot = findPackageJson();
-
-if (!projectRoot) {
-  console.error('ERROR: No package.json found');
-  process.exit(1);
-}
-
-const result = spawnSync('npm', ['run', 'loopstack', '--', ...process.argv.slice(2)], {
-  cwd: projectRoot,
-  stdio: 'inherit'
-});
-
-process.exit(result.status || 0);