@loopstack/cli 0.15.1 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (176) hide show
  1. package/README.md +66 -0
  2. package/dist/commands/answer.d.ts +3 -0
  3. package/dist/commands/answer.d.ts.map +1 -0
  4. package/dist/commands/answer.js +82 -0
  5. package/dist/commands/answer.js.map +1 -0
  6. package/dist/commands/attach.d.ts +3 -0
  7. package/dist/commands/attach.d.ts.map +1 -0
  8. package/dist/commands/attach.js +103 -0
  9. package/dist/commands/attach.js.map +1 -0
  10. package/dist/commands/create.d.ts +3 -0
  11. package/dist/commands/create.d.ts.map +1 -0
  12. package/dist/commands/create.js +80 -0
  13. package/dist/commands/create.js.map +1 -0
  14. package/dist/commands/env.d.ts +3 -0
  15. package/dist/commands/env.d.ts.map +1 -0
  16. package/dist/commands/env.js +42 -0
  17. package/dist/commands/env.js.map +1 -0
  18. package/dist/commands/list.d.ts +3 -0
  19. package/dist/commands/list.d.ts.map +1 -0
  20. package/dist/commands/list.js +119 -0
  21. package/dist/commands/list.js.map +1 -0
  22. package/dist/commands/login.d.ts +3 -0
  23. package/dist/commands/login.d.ts.map +1 -0
  24. package/dist/commands/login.js +62 -0
  25. package/dist/commands/login.js.map +1 -0
  26. package/dist/commands/run.d.ts +3 -0
  27. package/dist/commands/run.d.ts.map +1 -0
  28. package/dist/commands/run.js +119 -0
  29. package/dist/commands/run.js.map +1 -0
  30. package/dist/commands/runs.d.ts +3 -0
  31. package/dist/commands/runs.d.ts.map +1 -0
  32. package/dist/commands/runs.js +151 -0
  33. package/dist/commands/runs.js.map +1 -0
  34. package/dist/commands/watch.d.ts +3 -0
  35. package/dist/commands/watch.d.ts.map +1 -0
  36. package/dist/commands/watch.js +50 -0
  37. package/dist/commands/watch.js.map +1 -0
  38. package/dist/config/config.d.ts +14 -0
  39. package/dist/config/config.d.ts.map +1 -0
  40. package/dist/config/config.js +25 -0
  41. package/dist/config/config.js.map +1 -0
  42. package/dist/config/resolve.d.ts +18 -0
  43. package/dist/config/resolve.d.ts.map +1 -0
  44. package/dist/config/resolve.js +57 -0
  45. package/dist/config/resolve.js.map +1 -0
  46. package/dist/errors.d.ts +12 -0
  47. package/dist/errors.d.ts.map +1 -0
  48. package/dist/errors.js +36 -0
  49. package/dist/errors.js.map +1 -0
  50. package/dist/hitl/discovery.d.ts +24 -0
  51. package/dist/hitl/discovery.d.ts.map +1 -0
  52. package/dist/hitl/discovery.js +124 -0
  53. package/dist/hitl/discovery.js.map +1 -0
  54. package/dist/hitl/idle-handler.d.ts +7 -0
  55. package/dist/hitl/idle-handler.d.ts.map +1 -0
  56. package/dist/hitl/idle-handler.js +103 -0
  57. package/dist/hitl/idle-handler.js.map +1 -0
  58. package/dist/hitl/pending.d.ts +16 -0
  59. package/dist/hitl/pending.d.ts.map +1 -0
  60. package/dist/hitl/pending.js +45 -0
  61. package/dist/hitl/pending.js.map +1 -0
  62. package/dist/hitl/prompt.d.ts +11 -0
  63. package/dist/hitl/prompt.d.ts.map +1 -0
  64. package/dist/hitl/prompt.js +69 -0
  65. package/dist/hitl/prompt.js.map +1 -0
  66. package/dist/main.d.ts +3 -0
  67. package/dist/main.d.ts.map +1 -0
  68. package/dist/main.js +37 -0
  69. package/dist/main.js.map +1 -0
  70. package/dist/output/format.d.ts +7 -0
  71. package/dist/output/format.d.ts.map +1 -0
  72. package/dist/output/format.js +58 -0
  73. package/dist/output/format.js.map +1 -0
  74. package/dist/output/studio-link.d.ts +4 -0
  75. package/dist/output/studio-link.d.ts.map +1 -0
  76. package/dist/output/studio-link.js +17 -0
  77. package/dist/output/studio-link.js.map +1 -0
  78. package/dist/run/args.d.ts +2 -0
  79. package/dist/run/args.d.ts.map +1 -0
  80. package/dist/run/args.js +41 -0
  81. package/dist/run/args.js.map +1 -0
  82. package/dist/run/documents.d.ts +15 -0
  83. package/dist/run/documents.d.ts.map +1 -0
  84. package/dist/run/documents.js +100 -0
  85. package/dist/run/documents.js.map +1 -0
  86. package/dist/run/follow.d.ts +18 -0
  87. package/dist/run/follow.d.ts.map +1 -0
  88. package/dist/run/follow.js +200 -0
  89. package/dist/run/follow.js.map +1 -0
  90. package/dist/run/retry.d.ts +5 -0
  91. package/dist/run/retry.d.ts.map +1 -0
  92. package/dist/run/retry.js +59 -0
  93. package/dist/run/retry.js.map +1 -0
  94. package/dist/run/trail.d.ts +17 -0
  95. package/dist/run/trail.d.ts.map +1 -0
  96. package/dist/run/trail.js +42 -0
  97. package/dist/run/trail.js.map +1 -0
  98. package/dist/run/workspace.d.ts +3 -0
  99. package/dist/run/workspace.d.ts.map +1 -0
  100. package/dist/run/workspace.js +26 -0
  101. package/dist/run/workspace.js.map +1 -0
  102. package/dist/widgets/collect/form.collect.d.ts +7 -0
  103. package/dist/widgets/collect/form.collect.d.ts.map +1 -0
  104. package/dist/widgets/collect/form.collect.js +71 -0
  105. package/dist/widgets/collect/form.collect.js.map +1 -0
  106. package/dist/widgets/collect/prompts.collect.d.ts +5 -0
  107. package/dist/widgets/collect/prompts.collect.d.ts.map +1 -0
  108. package/dist/widgets/collect/prompts.collect.js +38 -0
  109. package/dist/widgets/collect/prompts.collect.js.map +1 -0
  110. package/dist/widgets/collect/secret-input.collect.d.ts +3 -0
  111. package/dist/widgets/collect/secret-input.collect.d.ts.map +1 -0
  112. package/dist/widgets/collect/secret-input.collect.js +47 -0
  113. package/dist/widgets/collect/secret-input.collect.js.map +1 -0
  114. package/dist/widgets/collect/transition.d.ts +3 -0
  115. package/dist/widgets/collect/transition.d.ts.map +1 -0
  116. package/dist/widgets/collect/transition.js +5 -0
  117. package/dist/widgets/collect/transition.js.map +1 -0
  118. package/dist/widgets/collect/workflow.collect.d.ts +4 -0
  119. package/dist/widgets/collect/workflow.collect.d.ts.map +1 -0
  120. package/dist/widgets/collect/workflow.collect.js +24 -0
  121. package/dist/widgets/collect/workflow.collect.js.map +1 -0
  122. package/dist/widgets/document/form.widget.d.ts +3 -0
  123. package/dist/widgets/document/form.widget.d.ts.map +1 -0
  124. package/dist/widgets/document/form.widget.js +34 -0
  125. package/dist/widgets/document/form.widget.js.map +1 -0
  126. package/dist/widgets/document/json.widget.d.ts +3 -0
  127. package/dist/widgets/document/json.widget.d.ts.map +1 -0
  128. package/dist/widgets/document/json.widget.js +17 -0
  129. package/dist/widgets/document/json.widget.js.map +1 -0
  130. package/dist/widgets/document/link.widget.d.ts +3 -0
  131. package/dist/widgets/document/link.widget.d.ts.map +1 -0
  132. package/dist/widgets/document/link.widget.js +9 -0
  133. package/dist/widgets/document/link.widget.js.map +1 -0
  134. package/dist/widgets/document/llm-message.widget.d.ts +3 -0
  135. package/dist/widgets/document/llm-message.widget.d.ts.map +1 -0
  136. package/dist/widgets/document/llm-message.widget.js +67 -0
  137. package/dist/widgets/document/llm-message.widget.js.map +1 -0
  138. package/dist/widgets/document/message.widget.d.ts +5 -0
  139. package/dist/widgets/document/message.widget.d.ts.map +1 -0
  140. package/dist/widgets/document/message.widget.js +35 -0
  141. package/dist/widgets/document/message.widget.js.map +1 -0
  142. package/dist/widgets/document/oauth-prompt.widget.d.ts +4 -0
  143. package/dist/widgets/document/oauth-prompt.widget.d.ts.map +1 -0
  144. package/dist/widgets/document/oauth-prompt.widget.js +22 -0
  145. package/dist/widgets/document/oauth-prompt.widget.js.map +1 -0
  146. package/dist/widgets/document/secret-request.widget.d.ts +3 -0
  147. package/dist/widgets/document/secret-request.widget.d.ts.map +1 -0
  148. package/dist/widgets/document/secret-request.widget.js +9 -0
  149. package/dist/widgets/document/secret-request.widget.js.map +1 -0
  150. package/dist/widgets/editor.d.ts +3 -0
  151. package/dist/widgets/editor.d.ts.map +1 -0
  152. package/dist/widgets/editor.js +60 -0
  153. package/dist/widgets/editor.js.map +1 -0
  154. package/dist/widgets/field/field-widgets.d.ts +6 -0
  155. package/dist/widgets/field/field-widgets.d.ts.map +1 -0
  156. package/dist/widgets/field/field-widgets.js +64 -0
  157. package/dist/widgets/field/field-widgets.js.map +1 -0
  158. package/dist/widgets/registry.d.ts +6 -0
  159. package/dist/widgets/registry.d.ts.map +1 -0
  160. package/dist/widgets/registry.js +45 -0
  161. package/dist/widgets/registry.js.map +1 -0
  162. package/dist/widgets/types.d.ts +44 -0
  163. package/dist/widgets/types.d.ts.map +1 -0
  164. package/dist/widgets/types.js +2 -0
  165. package/dist/widgets/types.js.map +1 -0
  166. package/fixtures/app/CLAUDE.md +54 -0
  167. package/fixtures/app/README.md +21 -0
  168. package/fixtures/app/docker-compose.yml +33 -0
  169. package/fixtures/app/env.example +16 -0
  170. package/fixtures/app/nest-cli.json +10 -0
  171. package/fixtures/app/src/app.module.ts +8 -0
  172. package/fixtures/app/src/hello/hello.module.ts +12 -0
  173. package/fixtures/app/src/hello/hello.workflow.ts +28 -0
  174. package/fixtures/app/src/main.ts +11 -0
  175. package/package.json +36 -10
  176. package/bin/loopstack.js +0 -33
package/dist/errors.js ADDED
@@ -0,0 +1,36 @@
1
+ import pc from 'picocolors';
2
+ import { LoopstackApiError } from '@loopstack/client';
3
+ export const ExitCode = {
4
+ Success: 0,
5
+ RunFailed: 1,
6
+ ConnectionOrConfig: 2,
7
+ NeedsInput: 3,
8
+ };
9
+ export class CliError extends Error {
10
+ exitCode;
11
+ constructor(message, exitCode = ExitCode.ConnectionOrConfig) {
12
+ super(message);
13
+ this.exitCode = exitCode;
14
+ }
15
+ }
16
+ function isNetworkError(error) {
17
+ return error instanceof TypeError && /fetch failed/i.test(error.message);
18
+ }
19
+ export function handleError(error, url) {
20
+ if (error instanceof CliError) {
21
+ console.error(pc.red(`✖ ${error.message}`));
22
+ process.exit(error.exitCode);
23
+ }
24
+ if (error instanceof LoopstackApiError) {
25
+ const hint = error.status === 401 || error.status === 403 ? ' — check your token (loopstack login)' : '';
26
+ console.error(pc.red(`✖ API error ${error.status}: ${error.message}${hint}`));
27
+ process.exit(ExitCode.ConnectionOrConfig);
28
+ }
29
+ if (isNetworkError(error)) {
30
+ console.error(pc.red(`✖ Cannot reach the Loopstack backend${url ? ` at ${url}` : ''} — is it running?`));
31
+ process.exit(ExitCode.ConnectionOrConfig);
32
+ }
33
+ console.error(pc.red(`✖ ${error instanceof Error ? (error.stack ?? error.message) : String(error)}`));
34
+ process.exit(ExitCode.ConnectionOrConfig);
35
+ }
36
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,24 @@
1
+ import type { LoopstackClient } from '@loopstack/client';
2
+ import type { DocumentItemInterface, WorkflowFullInterface } from '@loopstack/contracts/api';
3
+ import { type ParkViewWidgetConfig } from '@loopstack/contracts/park-view';
4
+ export type WidgetConfig = ParkViewWidgetConfig;
5
+ export declare function fetchDocumentWidgets(client: LoopstackClient): Promise<Map<string, WidgetConfig>>;
6
+ export interface ActivePrompt {
7
+ workflow: WorkflowFullInterface;
8
+ document?: DocumentItemInterface;
9
+ widget?: WidgetConfig;
10
+ submitTransition?: string;
11
+ }
12
+ export interface UnsupportedPrompt {
13
+ workflow: WorkflowFullInterface;
14
+ widgetName: string;
15
+ documentName?: string;
16
+ content?: Record<string, unknown>;
17
+ }
18
+ export interface PromptDiscovery {
19
+ prompt?: ActivePrompt;
20
+ unsupported?: UnsupportedPrompt;
21
+ hasActiveDescendants: boolean;
22
+ }
23
+ export declare function findActivePrompt(client: LoopstackClient, rootWorkflowId: string, widgets: Map<string, WidgetConfig>, workflowWidgets?: Map<string, WidgetConfig[]>): Promise<PromptDiscovery>;
24
+ //# sourceMappingURL=discovery.d.ts.map
@@ -0,0 +1 @@
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;AAE7F,OAAO,EAEL,KAAK,oBAAoB,EAM1B,MAAM,gCAAgC,CAAC;AAOxC,MAAM,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAGhD,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAmBtG;AAED,MAAM,WAAW,YAAY;IAE3B,QAAQ,EAAE,qBAAqB,CAAC;IAEhC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAGD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAE9B,MAAM,CAAC,EAAE,YAAY,CAAC;IAKtB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAMhC,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AA6ED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAClC,eAAe,GAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAa,GACvD,OAAO,CAAC,eAAe,CAAC,CAqF1B"}
@@ -0,0 +1,124 @@
1
+ import { SortOrder, WorkflowState } from '@loopstack/contracts/enums';
2
+ import { evaluateWorkflowPrompts, isAnswerableState, pickPrompt, } from '@loopstack/contracts/park-view';
3
+ import { isCollectable } from '../widgets/registry.js';
4
+ export async function fetchDocumentWidgets(client) {
5
+ const apps = await client.config.apps();
6
+ const widgets = new Map();
7
+ for (const app of apps) {
8
+ for (const document of app.documents ?? []) {
9
+ const widget = document.ui?.widgets?.[0];
10
+ if (widget) {
11
+ const meta = document.meta;
12
+ widgets.set(document.documentName, {
13
+ ...widget,
14
+ schema: document.schema,
15
+ enableAtPlaces: meta?.enableAtPlaces,
16
+ hideAtPlaces: meta?.hideAtPlaces,
17
+ internal: document.tags?.includes('internal') || undefined,
18
+ });
19
+ }
20
+ }
21
+ }
22
+ return widgets;
23
+ }
24
+ const TERMINAL_STATES = new Set([WorkflowState.Completed, WorkflowState.Failed, WorkflowState.Canceled]);
25
+ const PARKED_STATES = new Set([WorkflowState.Waiting, WorkflowState.Paused]);
26
+ async function fetchCandidateDocuments(client, workflow, widgets) {
27
+ const page = await client.documents.list({
28
+ filter: { workflowId: workflow.id, isInvalidated: false, place: workflow.place },
29
+ sortBy: [{ field: 'index', order: SortOrder.DESC }],
30
+ });
31
+ const candidates = [...page.data];
32
+ const extraNames = new Set([...widgets.entries()]
33
+ .filter(([, config]) => config.enableAtPlaces?.includes(workflow.place ?? ''))
34
+ .map(([name]) => name));
35
+ if (extraNames.size > 0) {
36
+ const extras = await client.documents.list({
37
+ filter: { workflowId: workflow.id, isInvalidated: false },
38
+ sortBy: [{ field: 'index', order: SortOrder.DESC }],
39
+ limit: 50,
40
+ });
41
+ for (const document of extras.data) {
42
+ if (extraNames.has(document.documentName) && document.place !== workflow.place) {
43
+ candidates.push(document);
44
+ }
45
+ }
46
+ }
47
+ return candidates;
48
+ }
49
+ async function fetchWorkflowWidgets(client, workflow, cache) {
50
+ let widgets = cache.get(workflow.workflowName);
51
+ if (!widgets) {
52
+ const config = await client.config.workflowConfig(workflow.workflowName).catch(() => undefined);
53
+ widgets = config?.ui?.widgets ?? [];
54
+ cache.set(workflow.workflowName, widgets);
55
+ }
56
+ return widgets;
57
+ }
58
+ export async function findActivePrompt(client, rootWorkflowId, widgets, workflowWidgets = new Map()) {
59
+ const queue = [rootWorkflowId];
60
+ const visited = new Set();
61
+ let fallback;
62
+ let unsupported;
63
+ let hasActiveDescendants = false;
64
+ while (queue.length > 0) {
65
+ const id = queue.shift();
66
+ if (visited.has(id))
67
+ continue;
68
+ visited.add(id);
69
+ const workflow = await client.workflows.get(id);
70
+ if (id !== rootWorkflowId && !TERMINAL_STATES.has(workflow.status) && !PARKED_STATES.has(workflow.status)) {
71
+ hasActiveDescendants = true;
72
+ }
73
+ const workflowInput = {
74
+ id: workflow.id,
75
+ workflowName: workflow.workflowName,
76
+ status: workflow.status,
77
+ place: workflow.place ?? null,
78
+ availableTransitions: workflow.availableTransitions?.map((transition) => transition.id) ?? [],
79
+ };
80
+ const answerable = isAnswerableState(workflowInput.status, workflowInput.availableTransitions);
81
+ const documents = answerable
82
+ ? await fetchCandidateDocuments(client, workflow, widgets).catch(() => [])
83
+ : [];
84
+ const documentBySource = new Map();
85
+ const documentInputs = documents.map((document) => {
86
+ const input = {
87
+ documentName: document.documentName,
88
+ place: document.place ?? null,
89
+ content: (document.content ?? null),
90
+ tags: document.tags,
91
+ };
92
+ documentBySource.set(input, document);
93
+ return input;
94
+ });
95
+ const candidates = answerable
96
+ ? evaluateWorkflowPrompts(workflowInput, documentInputs, widgets, await fetchWorkflowWidgets(client, workflow, workflowWidgets))
97
+ : [];
98
+ const toActivePrompt = (candidate) => ({
99
+ workflow,
100
+ document: candidate.document ? documentBySource.get(candidate.document) : undefined,
101
+ widget: candidate.widget,
102
+ submitTransition: candidate.submitTransition,
103
+ });
104
+ const picked = pickPrompt(candidates, (candidate) => !!candidate.widget && isCollectable(candidate.widget.widget));
105
+ if (picked.prompt) {
106
+ return { prompt: toActivePrompt(picked.prompt), hasActiveDescendants };
107
+ }
108
+ if (picked.blocked?.widget) {
109
+ unsupported ??= {
110
+ workflow,
111
+ widgetName: picked.blocked.widget.widget,
112
+ documentName: picked.blocked.document?.documentName,
113
+ content: picked.blocked.document?.content ?? undefined,
114
+ };
115
+ }
116
+ if (picked.fallback) {
117
+ fallback ??= toActivePrompt(picked.fallback);
118
+ }
119
+ const children = await client.workflows.list({ filter: { parentId: id } });
120
+ queue.push(...children.data.map((child) => child.id));
121
+ }
122
+ return { prompt: fallback, unsupported, hasActiveDescendants };
123
+ }
124
+ //# sourceMappingURL=discovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/hitl/discovery.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import type { LoopstackClient } from '@loopstack/client';
2
+ import type { IdleOutcome } from '../run/follow.js';
3
+ export interface IdleHandlerOptions {
4
+ studioUrl?: string;
5
+ }
6
+ export declare function createIdleHandler(client: LoopstackClient, rootWorkflowId: string, out: NodeJS.WritableStream, options?: IdleHandlerOptions): (signal: AbortSignal, onPromptWorkflow: (id: string) => void) => Promise<IdleOutcome>;
7
+ //# sourceMappingURL=idle-handler.d.ts.map
@@ -0,0 +1 @@
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;AAMpD,MAAM,WAAW,kBAAkB;IAEjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6BD,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,CAyHvF"}
@@ -0,0 +1,103 @@
1
+ import { stdin } from 'node:process';
2
+ import pc from 'picocolors';
3
+ import { WorkflowState } from '@loopstack/contracts/enums';
4
+ import { resolveHandoff } from '../widgets/registry.js';
5
+ import { fetchDocumentWidgets, findActivePrompt } from './discovery.js';
6
+ import { describePrompt, promptForAnswer } from './prompt.js';
7
+ const abortableSleep = (ms, signal) => new Promise((resolve) => {
8
+ const timer = setTimeout(resolve, ms);
9
+ signal.addEventListener('abort', () => {
10
+ clearTimeout(timer);
11
+ resolve();
12
+ }, { once: true });
13
+ });
14
+ export function createIdleHandler(client, rootWorkflowId, out, options = {}) {
15
+ let widgetsPromise;
16
+ const workflowWidgets = new Map();
17
+ let lastAnswerAt = 0;
18
+ let announcedUnsupported;
19
+ return async (signal, onPromptWorkflow) => {
20
+ widgetsPromise ??= fetchDocumentWidgets(client);
21
+ const widgets = await widgetsPromise;
22
+ let discovery = await findActivePrompt(client, rootWorkflowId, widgets, workflowWidgets);
23
+ const renderable = () => !!(discovery.prompt?.document || discovery.prompt?.widget);
24
+ let sawActivity = discovery.hasActiveDescendants;
25
+ let quietPolls = 0;
26
+ for (let attempt = 0; !renderable() &&
27
+ !discovery.unsupported &&
28
+ (attempt < 4 || discovery.hasActiveDescendants || (sawActivity && quietPolls < 2)); attempt++) {
29
+ await abortableSleep(attempt < 4 ? 750 : 2000, signal);
30
+ if (signal.aborted)
31
+ return 'resumed';
32
+ const next = await findActivePrompt(client, rootWorkflowId, widgets, workflowWidgets);
33
+ if (next.hasActiveDescendants) {
34
+ sawActivity = true;
35
+ quietPolls = 0;
36
+ }
37
+ else if (sawActivity) {
38
+ quietPolls++;
39
+ }
40
+ discovery = {
41
+ prompt: next.prompt ?? discovery.prompt,
42
+ unsupported: next.unsupported,
43
+ hasActiveDescendants: next.hasActiveDescendants,
44
+ };
45
+ }
46
+ if (signal.aborted)
47
+ return 'resumed';
48
+ if (!renderable() && discovery.unsupported) {
49
+ const { workflow, widgetName, documentName, content } = discovery.unsupported;
50
+ const key = `${workflow.id}:${widgetName}`;
51
+ if (key !== announcedUnsupported) {
52
+ announcedUnsupported = key;
53
+ const hint = resolveHandoff(widgetName, content ?? {});
54
+ if (hint) {
55
+ out.write(`${pc.yellow('⏸')} ${hint}\n`);
56
+ }
57
+ else {
58
+ const label = documentName ? `${widgetName} (${documentName})` : widgetName;
59
+ out.write(`${pc.yellow('⏸')} waiting for input the CLI can't collect: ${label}\n`);
60
+ if (options.studioUrl)
61
+ out.write(pc.dim(`⧉ answer in Studio: ${options.studioUrl}\n`));
62
+ }
63
+ }
64
+ if (!stdin.isTTY)
65
+ return 'stop';
66
+ await abortableSleep(3_600_000, signal);
67
+ return signal.aborted ? 'resumed' : 'stop';
68
+ }
69
+ const prompt = discovery.prompt;
70
+ if (!prompt || (!prompt.document && !prompt.widget)) {
71
+ return Date.now() - lastAnswerAt < 10_000 ? 'answered' : 'stop';
72
+ }
73
+ onPromptWorkflow(prompt.workflow.id);
74
+ if (!stdin.isTTY) {
75
+ out.write(`${pc.yellow('⏸')} waiting for input: ${describePrompt(prompt)}\n`);
76
+ if (options.studioUrl)
77
+ out.write(pc.dim(`⧉ answer in Studio: ${options.studioUrl}\n`));
78
+ return 'stop';
79
+ }
80
+ try {
81
+ const answer = await promptForAnswer(client, prompt, out, { signal });
82
+ if (!answer)
83
+ return 'stop';
84
+ await client.processor.run(prompt.workflow.id, {
85
+ transition: { id: answer.transitionId, workflowId: prompt.workflow.id, payload: answer.payload },
86
+ });
87
+ lastAnswerAt = Date.now();
88
+ return 'answered';
89
+ }
90
+ catch (error) {
91
+ if (signal.aborted)
92
+ return 'external';
93
+ if (error instanceof Error && error.name === 'AbortError')
94
+ return 'stop';
95
+ const current = await client.workflows.get(prompt.workflow.id).catch(() => undefined);
96
+ if (current && current.status !== WorkflowState.Waiting && current.status !== WorkflowState.Paused) {
97
+ return 'external';
98
+ }
99
+ throw error;
100
+ }
101
+ };
102
+ }
103
+ //# sourceMappingURL=idle-handler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"idle-handler.js","sourceRoot":"","sources":["../../src/hitl/idle-handler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { LoopstackClient } from '@loopstack/client';
2
+ export interface PendingPromptInfo {
3
+ workflowId: string;
4
+ workflowName: string;
5
+ place: string | null;
6
+ description: string;
7
+ transitions: string[];
8
+ transition?: string;
9
+ widget?: string;
10
+ schema?: Record<string, unknown>;
11
+ options?: Record<string, unknown>;
12
+ content?: Record<string, unknown>;
13
+ studioOnly?: boolean;
14
+ }
15
+ export declare function inspectPendingPrompt(client: LoopstackClient, rootWorkflowId: string): Promise<PendingPromptInfo | undefined>;
16
+ //# sourceMappingURL=pending.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pending.d.ts","sourceRoot":"","sources":["../../src/hitl/pending.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAUzD,MAAM,WAAW,iBAAiB;IAEhC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAMD,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,eAAe,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CA4CxC"}
@@ -0,0 +1,45 @@
1
+ import { WorkflowState } from '@loopstack/contracts/enums';
2
+ import { fetchDocumentWidgets, findActivePrompt } from './discovery.js';
3
+ import { describePrompt } from './prompt.js';
4
+ export async function inspectPendingPrompt(client, rootWorkflowId) {
5
+ const root = await client.workflows.get(rootWorkflowId);
6
+ const parked = root.status === WorkflowState.Waiting ||
7
+ root.status === WorkflowState.Paused ||
8
+ root.status === WorkflowState.Failed;
9
+ if (!parked)
10
+ return undefined;
11
+ const widgets = await fetchDocumentWidgets(client);
12
+ const discovery = await findActivePrompt(client, rootWorkflowId, widgets);
13
+ if (discovery.prompt) {
14
+ const prompt = discovery.prompt;
15
+ const available = prompt.workflow.availableTransitions?.map((transition) => transition.id) ?? [];
16
+ return {
17
+ workflowId: prompt.workflow.id,
18
+ workflowName: prompt.workflow.workflowName,
19
+ place: prompt.workflow.place ?? null,
20
+ description: describePrompt(prompt),
21
+ transitions: available,
22
+ transition: prompt.submitTransition,
23
+ widget: prompt.widget?.widget,
24
+ schema: prompt.widget?.schema,
25
+ options: prompt.widget?.options,
26
+ content: (prompt.document?.content ?? undefined),
27
+ };
28
+ }
29
+ if (discovery.unsupported) {
30
+ const { workflow, widgetName, content } = discovery.unsupported;
31
+ const available = workflow.availableTransitions?.map((transition) => transition.id) ?? [];
32
+ return {
33
+ workflowId: workflow.id,
34
+ workflowName: workflow.workflowName,
35
+ place: workflow.place ?? null,
36
+ description: `input only Studio can collect (${widgetName})`,
37
+ transitions: available,
38
+ widget: widgetName,
39
+ content,
40
+ studioOnly: true,
41
+ };
42
+ }
43
+ return undefined;
44
+ }
45
+ //# sourceMappingURL=pending.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pending.js","sourceRoot":"","sources":["../../src/hitl/pending.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkC7C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAuB,EACvB,cAAsB;IAEtB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACxD,MAAM,MAAM,GACV,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,OAAO;QACrC,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM;QACpC,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC;IACvC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAE9B,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IAE1E,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAChC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACjG,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;YAC9B,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,YAAY;YAC1C,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI;YACpC,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC;YACnC,WAAW,EAAE,SAAS;YACtB,UAAU,EAAE,MAAM,CAAC,gBAAgB;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM;YAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO;YAC/B,OAAO,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,SAAS,CAAwC;SACxF,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,WAAW,CAAC;QAChE,MAAM,SAAS,GAAG,QAAQ,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC1F,OAAO;YACL,UAAU,EAAE,QAAQ,CAAC,EAAE;YACvB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI;YAC7B,WAAW,EAAE,kCAAkC,UAAU,GAAG;YAC5D,WAAW,EAAE,SAAS;YACtB,MAAM,EAAE,UAAU;YAClB,OAAO;YACP,UAAU,EAAE,IAAI;SACjB,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
@@ -0,0 +1,11 @@
1
+ import type { LoopstackClient } from '@loopstack/client';
2
+ import type { PromptAnswer } from '../widgets/types.js';
3
+ import type { ActivePrompt } from './discovery.js';
4
+ export type { PromptAnswer } from '../widgets/types.js';
5
+ export type PromptResult = PromptAnswer | undefined;
6
+ export interface PromptOptions {
7
+ signal?: AbortSignal;
8
+ }
9
+ export declare function promptForAnswer(client: LoopstackClient, prompt: ActivePrompt, out: NodeJS.WritableStream, options?: PromptOptions): Promise<PromptResult>;
10
+ export declare function describePrompt(prompt: ActivePrompt): string;
11
+ //# sourceMappingURL=prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/hitl/prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAA6B,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;AAEpD,MAAM,WAAW,aAAa;IAE5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA+BD,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAyCvB;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAS3D"}
@@ -0,0 +1,69 @@
1
+ import { stdin } from 'node:process';
2
+ import { createInterface } from 'node:readline/promises';
3
+ import { Writable } from 'node:stream';
4
+ import { resolveCollectWidget } from '../widgets/registry.js';
5
+ function availableTransitionIds(prompt) {
6
+ return prompt.workflow.availableTransitions?.map((transition) => transition.id) ?? [];
7
+ }
8
+ class MutableEcho extends Writable {
9
+ target;
10
+ muted = false;
11
+ constructor(target) {
12
+ super();
13
+ this.target = target;
14
+ }
15
+ _write(chunk, _encoding, callback) {
16
+ if (!this.muted)
17
+ this.target.write(chunk);
18
+ callback();
19
+ }
20
+ }
21
+ export async function promptForAnswer(client, prompt, out, options = {}) {
22
+ const collect = resolveCollectWidget(prompt.widget?.widget);
23
+ if (!collect)
24
+ return undefined;
25
+ const echo = new MutableEcho(out);
26
+ const rl = createInterface({ input: stdin, output: echo, terminal: stdin.isTTY });
27
+ const io = {
28
+ ask: (query) => rl.question(query, { signal: options.signal }),
29
+ askSecret: async (query) => {
30
+ const answer = rl.question(query, { signal: options.signal });
31
+ echo.muted = true;
32
+ try {
33
+ return await answer;
34
+ }
35
+ finally {
36
+ echo.muted = false;
37
+ out.write('\n');
38
+ }
39
+ },
40
+ out,
41
+ };
42
+ const ctx = {
43
+ content: (prompt.document?.content ?? {}),
44
+ documentName: prompt.document?.documentName,
45
+ options: prompt.widget?.options,
46
+ schema: prompt.widget?.schema,
47
+ availableTransitions: availableTransitionIds(prompt),
48
+ workspaceId: prompt.workflow.workspaceId,
49
+ http: client.http,
50
+ };
51
+ try {
52
+ return await collect(ctx, io);
53
+ }
54
+ finally {
55
+ rl.close();
56
+ }
57
+ }
58
+ export function describePrompt(prompt) {
59
+ const content = (prompt.document?.content ?? {});
60
+ if (typeof content.question === 'string')
61
+ return content.question;
62
+ if (typeof content.markdown === 'string')
63
+ return content.markdown.split('\n')[0];
64
+ const label = prompt.widget?.options?.label;
65
+ if (typeof label === 'string' && label.trim())
66
+ return label;
67
+ return `transitions: ${availableTransitionIds(prompt).join(', ')}`;
68
+ }
69
+ //# sourceMappingURL=prompt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/hitl/prompt.ts"],"names":[],"mappings":"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"}
package/dist/main.d.ts ADDED
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=main.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}
package/dist/main.js ADDED
@@ -0,0 +1,37 @@
1
+ #!/usr/bin/env node
2
+ import { Command } from 'commander';
3
+ import { createRequire } from 'node:module';
4
+ import { registerAnswerCommand } from './commands/answer.js';
5
+ import { registerAttachCommand } from './commands/attach.js';
6
+ import { registerCreateCommand } from './commands/create.js';
7
+ import { registerEnvCommand } from './commands/env.js';
8
+ import { registerListCommand } from './commands/list.js';
9
+ import { registerLoginCommand } from './commands/login.js';
10
+ import { registerRunCommand } from './commands/run.js';
11
+ import { registerRunsCommand } from './commands/runs.js';
12
+ import { registerWatchCommand } from './commands/watch.js';
13
+ import { handleError } from './errors.js';
14
+ const { version } = createRequire(import.meta.url)('../package.json');
15
+ const program = new Command('loopstack')
16
+ .description('Scaffold, run, inspect, and watch Loopstack workflows from the terminal')
17
+ .version(version)
18
+ .option('--env <name>', 'named environment from ~/.loopstack/config.json')
19
+ .option('--url <url>', 'backend URL (overrides --env and the config file)')
20
+ .option('--token <token>', 'API token (lsk_…); LOOPSTACK_TOKEN works too')
21
+ .option('--json', 'machine-readable JSON output on stdout');
22
+ registerCreateCommand(program);
23
+ registerLoginCommand(program);
24
+ registerEnvCommand(program);
25
+ registerRunCommand(program);
26
+ registerRunsCommand(program);
27
+ registerAnswerCommand(program);
28
+ registerAttachCommand(program);
29
+ registerWatchCommand(program);
30
+ registerListCommand(program);
31
+ try {
32
+ await program.parseAsync();
33
+ }
34
+ catch (error) {
35
+ handleError(error);
36
+ }
37
+ //# sourceMappingURL=main.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAwB,CAAC;AAE7F,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;KACrC,WAAW,CAAC,yEAAyE,CAAC;KACtF,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,cAAc,EAAE,iDAAiD,CAAC;KACzE,MAAM,CAAC,aAAa,EAAE,mDAAmD,CAAC;KAC1E,MAAM,CAAC,iBAAiB,EAAE,8CAA8C,CAAC;KACzE,MAAM,CAAC,QAAQ,EAAE,wCAAwC,CAAC,CAAC;AAE9D,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,IAAI,CAAC;IACH,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,WAAW,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC"}
@@ -0,0 +1,7 @@
1
+ export declare function renderTable(headers: string[], rows: string[][], minWidths?: number[]): string;
2
+ export declare function renderResult(out: NodeJS.WritableStream, result: unknown): boolean;
3
+ export declare function colorStatus(status: string): string;
4
+ export declare function formatDuration(ms: number): string;
5
+ export declare function printData(text: string): void;
6
+ export declare function printStatus(text: string): void;
7
+ //# sourceMappingURL=format.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/output/format.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,MAAM,CAUjG;AAQD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAejF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAclD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C"}
@@ -0,0 +1,58 @@
1
+ import pc from 'picocolors';
2
+ import { WorkflowState } from '@loopstack/contracts/enums';
3
+ export function renderTable(headers, rows, minWidths = []) {
4
+ const widths = headers.map((header, column) => Math.max(minWidths[column] ?? 0, header.length, ...rows.map((row) => (row[column] ?? '').length)));
5
+ const renderRow = (cells) => widths
6
+ .map((width, column) => (cells[column] ?? '').padEnd(width))
7
+ .join(' ')
8
+ .trimEnd();
9
+ return [pc.dim(renderRow(headers)), ...rows.map(renderRow)].join('\n');
10
+ }
11
+ export function renderResult(out, result) {
12
+ if (result == null)
13
+ return false;
14
+ if (typeof result === 'object' && !Array.isArray(result)) {
15
+ let wrote = false;
16
+ for (const [key, value] of Object.entries(result)) {
17
+ if (value == null)
18
+ continue;
19
+ out.write(`${pc.dim(`${key}:`)}\n${typeof value === 'string' ? value : JSON.stringify(value)}\n`);
20
+ wrote = true;
21
+ }
22
+ return wrote;
23
+ }
24
+ const text = typeof result === 'string' ? result : JSON.stringify(result);
25
+ if (!text)
26
+ return false;
27
+ out.write(`${pc.dim('result:')}\n${text}\n`);
28
+ return true;
29
+ }
30
+ export function colorStatus(status) {
31
+ switch (status) {
32
+ case WorkflowState.Completed:
33
+ return pc.green(status);
34
+ case WorkflowState.Failed:
35
+ return pc.red(status);
36
+ case WorkflowState.Waiting:
37
+ case WorkflowState.Paused:
38
+ return pc.yellow(status);
39
+ case WorkflowState.Running:
40
+ return pc.cyan(status);
41
+ default:
42
+ return status;
43
+ }
44
+ }
45
+ export function formatDuration(ms) {
46
+ if (ms < 1000)
47
+ return `${Math.round(ms)}ms`;
48
+ if (ms < 60_000)
49
+ return `${(ms / 1000).toFixed(1)}s`;
50
+ return `${Math.floor(ms / 60_000)}m ${Math.round((ms % 60_000) / 1000)}s`;
51
+ }
52
+ export function printData(text) {
53
+ console.log(text);
54
+ }
55
+ export function printStatus(text) {
56
+ console.error(text);
57
+ }
58
+ //# sourceMappingURL=format.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/output/format.ts"],"names":[],"mappings":"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"}