@loopstack/cli 0.17.0 → 0.18.0

package/dist/widgets/document/llm-message.widget.js

@@ -0,0 +1,67 @@
+import { randomUUID } from 'node:crypto';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import pc from 'picocolors';
+const MAX_TOOL_RESULT_LINES = 8;
+export const llmMessageWidget = (content, ctx, out) => {
+    const blocks = Array.isArray(content.blocks) ? content.blocks : [];
+    const streamed = typeof content.id === 'string' && content.id.length > 0 && !!ctx.streamedMessageIds?.has(content.id);
+    if (!streamed) {
+        const text = typeof content.text === 'string' && content.text.trim()
+            ? content.text
+            : blocks
+                .filter((block) => block.type === 'text' && typeof block.text === 'string')
+                .map((block) => block.text)
+                .join('\n');
+        if (text.trim()) {
+            const role = typeof content.role === 'string' ? `${pc.dim(`${content.role}:`)}\n` : '';
+            out.block(`${role}${text}`);
+        }
+    }
+    for (const block of blocks) {
+        if (block.type === 'tool_call') {
+            if (typeof block.id === 'string' && ctx.streamedToolCallIds?.has(block.id))
+                continue;
+            out.line(pc.dim(`⚒ ${block.name ?? 'tool'} ${JSON.stringify(block.args ?? {})}`));
+        }
+        else if (block.type === 'tool_result') {
+            const mark = block.isError ? pc.red('✗') : '→';
+            out.line(pc.dim(`  ${mark} ${truncateToolResult(formatToolResult(block.content))}`));
+        }
+    }
+};
+function truncateToolResult(text) {
+    const lines = text.split('\n');
+    if (lines.length <= MAX_TOOL_RESULT_LINES)
+        return text;
+    const preview = lines.slice(0, MAX_TOOL_RESULT_LINES).join('\n');
+    const hidden = lines.length - MAX_TOOL_RESULT_LINES;
+    const file = writeFullResult(text);
+    const view = file ? ` — full result: ${file}` : '';
+    return `${preview}\n… (+${hidden} lines${view})`;
+}
+function writeFullResult(text) {
+    try {
+        const dir = join(tmpdir(), 'loopstack-cli');
+        mkdirSync(dir, { recursive: true });
+        const file = join(dir, `tool-result-${randomUUID()}.txt`);
+        writeFileSync(file, text);
+        return file;
+    }
+    catch {
+        return undefined;
+    }
+}
+function formatToolResult(content) {
+    if (typeof content !== 'string')
+        return JSON.stringify(content);
+    try {
+        const parsed = JSON.parse(content);
+        return typeof parsed === 'string' ? parsed : content;
+    }
+    catch {
+        return content;
+    }
+}
+//# sourceMappingURL=llm-message.widget.js.map

package/dist/widgets/document/llm-message.widget.js.map

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

package/dist/widgets/document/message.widget.d.ts

@@ -0,0 +1,5 @@
+import type { DocumentWidget } from '../types.js';
+export declare const messageWidget: DocumentWidget;
+export declare const markdownWidget: DocumentWidget;
+export declare const errorWidget: DocumentWidget;
+//# sourceMappingURL=message.widget.d.ts.map

package/dist/widgets/document/message.widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.widget.d.ts","sourceRoot":"","sources":["../../../src/widgets/document/message.widget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,eAAO,MAAM,aAAa,EAAE,cAc3B,CAAC;AAGF,eAAO,MAAM,cAAc,EAAE,cAI5B,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,cAIzB,CAAC"}

package/dist/widgets/document/message.widget.js

@@ -0,0 +1,35 @@
+import pc from 'picocolors';
+export const messageWidget = (content, ctx, out) => {
+    const text = typeof content.text === 'string'
+        ? content.text
+        : typeof content.markdown === 'string'
+            ? content.markdown
+            : undefined;
+    if (!text?.trim())
+        return;
+    if (typeof content.role === 'string') {
+        out.block(`${pc.dim(`${content.role}:`)}\n${text}`);
+    }
+    else {
+        out.block(`${pc.dim(`document: ${ctx.documentName}`)}\n${indent(text)}`);
+    }
+};
+export const markdownWidget = (content, ctx, out) => {
+    const markdown = typeof content.markdown === 'string' ? content.markdown : undefined;
+    if (!markdown?.trim())
+        return;
+    out.block(`${pc.dim(`document: ${ctx.documentName}`)}\n${indent(markdown)}`);
+};
+export const errorWidget = (content, ctx, out) => {
+    const error = typeof content.error === 'string' ? content.error : undefined;
+    if (!error?.trim())
+        return;
+    out.block(`${pc.dim(`document: ${ctx.documentName}`)}\n${indent(pc.red(error))}`);
+};
+function indent(text) {
+    return text
+        .split('\n')
+        .map((line) => `  ${line}`)
+        .join('\n');
+}
+//# sourceMappingURL=message.widget.js.map

package/dist/widgets/document/message.widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.widget.js","sourceRoot":"","sources":["../../../src/widgets/document/message.widget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAO5B,MAAM,CAAC,MAAM,aAAa,GAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACjE,MAAM,IAAI,GACR,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAC9B,CAAC,CAAC,OAAO,CAAC,IAAI;QACd,CAAC,CAAC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;YACpC,CAAC,CAAC,OAAO,CAAC,QAAQ;YAClB,CAAC,CAAC,SAAS,CAAC;IAClB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE;QAAE,OAAO;IAE1B,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,YAAY,EAAE,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC,CAAC;AAGF,MAAM,CAAC,MAAM,cAAc,GAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAClE,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE;QAAE,OAAO;IAC9B,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,YAAY,EAAE,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC/E,CAAC,CAAC;AAGF,MAAM,CAAC,MAAM,WAAW,GAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAC/D,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;QAAE,OAAO;IAC3B,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,YAAY,EAAE,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;AACpF,CAAC,CAAC;AAEF,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;SAC1B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/widgets/document/oauth-prompt.widget.d.ts

@@ -0,0 +1,4 @@
+import type { DocumentWidget } from '../types.js';
+export declare const oauthPromptWidget: DocumentWidget;
+export declare function oauthHandoff(content: Record<string, unknown>): string | undefined;
+//# sourceMappingURL=oauth-prompt.widget.d.ts.map

package/dist/widgets/document/oauth-prompt.widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-prompt.widget.d.ts","sourceRoot":"","sources":["../../../src/widgets/document/oauth-prompt.widget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAUlD,eAAO,MAAM,iBAAiB,EAAE,cAY/B,CAAC;AAOF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAKjF"}

package/dist/widgets/document/oauth-prompt.widget.js

@@ -0,0 +1,22 @@
+import pc from 'picocolors';
+export const oauthPromptWidget = (content, _ctx, out) => {
+    const provider = typeof content.provider === 'string' ? content.provider : 'oauth';
+    if (content.status === 'success') {
+        const message = typeof content.message === 'string' ? content.message : 'Successfully connected.';
+        out.block(`${pc.green('✓')} ${provider} connected — ${message}`);
+        return;
+    }
+    const authUrl = typeof content.authUrl === 'string' ? content.authUrl : undefined;
+    if (!authUrl)
+        return;
+    out.block(`⧉ sign in with ${provider}: ${authUrl}`);
+};
+export function oauthHandoff(content) {
+    if (content.status === 'success')
+        return undefined;
+    if (typeof content.authUrl !== 'string')
+        return undefined;
+    const provider = typeof content.provider === 'string' ? content.provider : 'oauth';
+    return `waiting for browser sign-in (${provider}) — open the sign-in link above`;
+}
+//# sourceMappingURL=oauth-prompt.widget.js.map

package/dist/widgets/document/oauth-prompt.widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-prompt.widget.js","sourceRoot":"","sources":["../../../src/widgets/document/oauth-prompt.widget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAW5B,MAAM,CAAC,MAAM,iBAAiB,GAAmB,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACtE,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;IAEnF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC;QAClG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,QAAQ,gBAAgB,OAAO,EAAE,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,GAAG,CAAC,KAAK,CAAC,kBAAkB,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;AACtD,CAAC,CAAC;AAOF,MAAM,UAAU,YAAY,CAAC,OAAgC;IAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;IACnF,OAAO,gCAAgC,QAAQ,iCAAiC,CAAC;AACnF,CAAC"}

package/dist/widgets/document/secret-request.widget.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentWidget } from '../types.js';
+export declare const secretRequestWidget: DocumentWidget;
+//# sourceMappingURL=secret-request.widget.d.ts.map

package/dist/widgets/document/secret-request.widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-request.widget.d.ts","sourceRoot":"","sources":["../../../src/widgets/document/secret-request.widget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOlD,eAAO,MAAM,mBAAmB,EAAE,cAKjC,CAAC"}

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

@@ -0,0 +1,9 @@
+import pc from 'picocolors';
+export const secretRequestWidget = (content, ctx, out) => {
+    const variables = Array.isArray(content.variables) ? content.variables : [];
+    const keys = variables.map((variable) => variable.key).filter((key) => typeof key === 'string');
+    if (keys.length === 0)
+        return;
+    out.block(`${pc.dim(`document: ${ctx.documentName}`)}\n  requested secrets: ${keys.join(', ')}`);
+};
+//# sourceMappingURL=secret-request.widget.js.map

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/{hitl → widgets}/editor.d.ts

@@ -1,4 +1,3 @@
 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/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/{hitl → widgets}/editor.js

@@ -32,19 +32,6 @@ export function buildFormSkeleton(content, schema) {
     }
     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-'));

package/dist/widgets/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../../src/widgets/editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,YAAY,CAAC;AAS5B,SAAS,UAAU,CAAC,QAA8C;IAChE,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC5D,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,OAAO;YACV,OAAO,EAAE,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC;QACZ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAE,MAAgC;IAClF,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9E,OAAO,OAAkC,CAAC;IAC5C,CAAC;IACD,MAAM,KAAK,GAAG,MAAoC,CAAC;IACnD,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACpH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAQD,MAAM,UAAU,mBAAmB,CAAC,OAAgC,EAAE,GAA0B;IAC9F,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC;IAChE,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACtC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAE7D,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACjG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAC;YAC5B,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,iBAAiB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;YAC/G,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

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":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAc5B,MAAM,YAAY,GAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAE7E,MAAM,YAAY,GAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAC/C,YAAY,CAAC,GAAG,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAE/E,MAAM,QAAQ,GAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAC3C,YAAY,CAAC,GAAG,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAEhG,MAAM,SAAS,GAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAEjG,MAAM,aAAa,GAAG,IAAI,GAAG,CAAsB;IACjD,CAAC,OAAO,EAAE,YAAY,CAAC;IACvB,CAAC,UAAU,EAAE,YAAY,CAAC;IAC1B,CAAC,QAAQ,EAAE,YAAY,CAAC;IACxB,CAAC,UAAU,EAAE,YAAY,CAAC;IAC1B,CAAC,OAAO,EAAE,YAAY,CAAC;IACvB,CAAC,QAAQ,EAAE,YAAY,CAAC;IACxB,CAAC,QAAQ,EAAE,YAAY,CAAC;IACxB,CAAC,QAAQ,EAAE,YAAY,CAAC;IACxB,CAAC,eAAe,EAAE,YAAY,CAAC;IAC/B,CAAC,WAAW,EAAE,QAAQ,CAAC;CACxB,CAAC,CAAC;AAGH,MAAM,UAAU,kBAAkB,CAAC,UAA8B;IAC/D,IAAI,CAAC,UAAU;QAAE,OAAO,YAAY,CAAC;IACrC,OAAO,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC;AACpD,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,IAAY;IAC7C,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAOD,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,KAAc,EAAE,MAAc;IACrE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7D,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,IAA+B,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5E,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,aAAa,CAAC,KAAgC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACxG,CAAC;IACD,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAA4B,EAAE,MAAc;IACxE,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAGD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC"}

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

@@ -17,12 +17,16 @@ The `loopstack` CLI talks to the running backend (`npm run start:dev`, http://lo
 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 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:
@@ -33,6 +37,16 @@ Follow `src/hello/hello.workflow.ts` as the canonical example:
 - 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)

package/fixtures/app/src/main.ts

@@ -3,6 +3,9 @@ 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

@@ -2,7 +2,7 @@
   "name": "@loopstack/cli",
   "displayName": "Loopstack CLI",
   "description": "Run, trace, and watch Loopstack workflows from the terminal",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "license": "MIT",
   "author": {
     "name": "Jakob Klippel",
@@ -26,8 +26,8 @@
     "watch": "tsc -p tsconfig.build.json --watch"
   },
   "dependencies": {
-    "@loopstack/client": "^0.37.1",
-    "@loopstack/contracts": "^0.37.0",
+    "@loopstack/client": "^0.38.0",
+    "@loopstack/contracts": "^0.38.0",
     "commander": "^15.0.0",
     "picocolors": "^1.1.1"
   },

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"version":3,"file":"editor.js","sourceRoot":"","sources":["../../src/hitl/editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,YAAY,CAAC;AAS5B,SAAS,UAAU,CAAC,QAA8C;IAChE,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC5D,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,OAAO;YACV,OAAO,EAAE,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC;QACZ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAE,MAAgC;IAClF,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9E,OAAO,OAAkC,CAAC;IAC5C,CAAC;IACD,MAAM,KAAK,GAAG,MAAoC,CAAC;IACnD,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACpH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAGD,MAAM,UAAU,kBAAkB,CAAC,MAAgC;IACjE,MAAM,KAAK,GAAG,MAAoC,CAAC;IACnD,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE;QAC9D,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;QACvC,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,OAAO,KAAK,GAAG,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC;AAQD,MAAM,UAAU,mBAAmB,CAAC,OAAgC,EAAE,GAA0B;IAC9F,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC;IAChE,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACtC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAE7D,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACjG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAC;YAC5B,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,iBAAiB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;YAC/G,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}