@loopstack/cli 0.15.1 → 0.17.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 (96) hide show
  1. package/README.md +62 -0
  2. package/dist/commands/create.d.ts +3 -0
  3. package/dist/commands/create.d.ts.map +1 -0
  4. package/dist/commands/create.js +80 -0
  5. package/dist/commands/create.js.map +1 -0
  6. package/dist/commands/env.d.ts +3 -0
  7. package/dist/commands/env.d.ts.map +1 -0
  8. package/dist/commands/env.js +42 -0
  9. package/dist/commands/env.js.map +1 -0
  10. package/dist/commands/list.d.ts +3 -0
  11. package/dist/commands/list.d.ts.map +1 -0
  12. package/dist/commands/list.js +119 -0
  13. package/dist/commands/list.js.map +1 -0
  14. package/dist/commands/login.d.ts +3 -0
  15. package/dist/commands/login.d.ts.map +1 -0
  16. package/dist/commands/login.js +62 -0
  17. package/dist/commands/login.js.map +1 -0
  18. package/dist/commands/run.d.ts +3 -0
  19. package/dist/commands/run.d.ts.map +1 -0
  20. package/dist/commands/run.js +94 -0
  21. package/dist/commands/run.js.map +1 -0
  22. package/dist/commands/runs.d.ts +3 -0
  23. package/dist/commands/runs.d.ts.map +1 -0
  24. package/dist/commands/runs.js +153 -0
  25. package/dist/commands/runs.js.map +1 -0
  26. package/dist/commands/watch.d.ts +3 -0
  27. package/dist/commands/watch.d.ts.map +1 -0
  28. package/dist/commands/watch.js +48 -0
  29. package/dist/commands/watch.js.map +1 -0
  30. package/dist/config/config.d.ts +14 -0
  31. package/dist/config/config.d.ts.map +1 -0
  32. package/dist/config/config.js +25 -0
  33. package/dist/config/config.js.map +1 -0
  34. package/dist/config/resolve.d.ts +18 -0
  35. package/dist/config/resolve.d.ts.map +1 -0
  36. package/dist/config/resolve.js +57 -0
  37. package/dist/config/resolve.js.map +1 -0
  38. package/dist/errors.d.ts +12 -0
  39. package/dist/errors.d.ts.map +1 -0
  40. package/dist/errors.js +36 -0
  41. package/dist/errors.js.map +1 -0
  42. package/dist/hitl/discovery.d.ts +16 -0
  43. package/dist/hitl/discovery.d.ts.map +1 -0
  44. package/dist/hitl/discovery.js +67 -0
  45. package/dist/hitl/discovery.js.map +1 -0
  46. package/dist/hitl/editor.d.ts +4 -0
  47. package/dist/hitl/editor.d.ts.map +1 -0
  48. package/dist/hitl/editor.js +73 -0
  49. package/dist/hitl/editor.js.map +1 -0
  50. package/dist/hitl/idle-handler.d.ts +8 -0
  51. package/dist/hitl/idle-handler.d.ts.map +1 -0
  52. package/dist/hitl/idle-handler.js +71 -0
  53. package/dist/hitl/idle-handler.js.map +1 -0
  54. package/dist/hitl/prompt.d.ts +14 -0
  55. package/dist/hitl/prompt.d.ts.map +1 -0
  56. package/dist/hitl/prompt.js +127 -0
  57. package/dist/hitl/prompt.js.map +1 -0
  58. package/dist/main.d.ts +3 -0
  59. package/dist/main.d.ts.map +1 -0
  60. package/dist/main.js +33 -0
  61. package/dist/main.js.map +1 -0
  62. package/dist/output/format.d.ts +7 -0
  63. package/dist/output/format.d.ts.map +1 -0
  64. package/dist/output/format.js +47 -0
  65. package/dist/output/format.js.map +1 -0
  66. package/dist/output/studio-link.d.ts +4 -0
  67. package/dist/output/studio-link.d.ts.map +1 -0
  68. package/dist/output/studio-link.js +17 -0
  69. package/dist/output/studio-link.js.map +1 -0
  70. package/dist/run/args.d.ts +2 -0
  71. package/dist/run/args.d.ts.map +1 -0
  72. package/dist/run/args.js +41 -0
  73. package/dist/run/args.js.map +1 -0
  74. package/dist/run/documents.d.ts +3 -0
  75. package/dist/run/documents.d.ts.map +1 -0
  76. package/dist/run/documents.js +40 -0
  77. package/dist/run/documents.js.map +1 -0
  78. package/dist/run/follow.d.ts +14 -0
  79. package/dist/run/follow.d.ts.map +1 -0
  80. package/dist/run/follow.js +148 -0
  81. package/dist/run/follow.js.map +1 -0
  82. package/dist/run/workspace.d.ts +3 -0
  83. package/dist/run/workspace.d.ts.map +1 -0
  84. package/dist/run/workspace.js +26 -0
  85. package/dist/run/workspace.js.map +1 -0
  86. package/fixtures/app/CLAUDE.md +40 -0
  87. package/fixtures/app/README.md +21 -0
  88. package/fixtures/app/docker-compose.yml +33 -0
  89. package/fixtures/app/env.example +16 -0
  90. package/fixtures/app/nest-cli.json +10 -0
  91. package/fixtures/app/src/app.module.ts +8 -0
  92. package/fixtures/app/src/hello/hello.module.ts +12 -0
  93. package/fixtures/app/src/hello/hello.workflow.ts +28 -0
  94. package/fixtures/app/src/main.ts +8 -0
  95. package/package.json +36 -10
  96. package/bin/loopstack.js +0 -33
@@ -0,0 +1,153 @@
1
+ import pc from 'picocolors';
2
+ import { SortOrder, WorkflowState } from '@loopstack/contracts/enums';
3
+ import { createClientFor, resolveConnection } from '../config/resolve.js';
4
+ import { CliError, ExitCode } from '../errors.js';
5
+ import { createIdleHandler } from '../hitl/idle-handler.js';
6
+ import { colorStatus, formatDuration, printData, printStatus, renderResult, renderTable } from '../output/format.js';
7
+ import { openInBrowser, studioRunUrl } from '../output/studio-link.js';
8
+ import { createDocumentRenderer } from '../run/documents.js';
9
+ import { followRun } from '../run/follow.js';
10
+ const TERMINAL_STATES = [
11
+ WorkflowState.Completed,
12
+ WorkflowState.Failed,
13
+ WorkflowState.Canceled,
14
+ ];
15
+ const IDLE_STATES = [WorkflowState.Waiting, WorkflowState.Paused];
16
+ export function registerRunsCommand(program) {
17
+ program
18
+ .command('runs [runId]')
19
+ .description('Recent runs (runs waiting for input first), or one run’s audit trail; --follow attaches live')
20
+ .option('--follow', 'attach to the live stream after printing the trail (requires a run id)')
21
+ .option('--limit <n>', 'maximum number of runs to list', '20')
22
+ .option('--workspace <id>', 'filter by workspace id')
23
+ .option('--search <text>', 'search runs')
24
+ .option('--status <status>', 'filter by status (e.g. waiting, completed, failed)')
25
+ .option('--open', 'open the run in Studio (requires a run id)')
26
+ .option('--editor', 'answer field forms in $EDITOR instead of handing off to Studio')
27
+ .action(async (runId, options, cmd) => {
28
+ const globals = cmd.optsWithGlobals();
29
+ const connection = resolveConnection(globals);
30
+ const client = createClientFor(connection);
31
+ if (!runId) {
32
+ if (options.follow)
33
+ throw new CliError('--follow requires a run id: loopstack runs <run-id> --follow');
34
+ if (options.open)
35
+ throw new CliError('--open requires a run id: loopstack runs <run-id> --open');
36
+ await listRuns(client, connection, options, !!globals.json);
37
+ return;
38
+ }
39
+ await showRun(client, connection, runId, options, !!globals.json);
40
+ });
41
+ }
42
+ async function listRuns(client, connection, options, json) {
43
+ const filter = {
44
+ ...(options.workspace && { workspaceId: options.workspace }),
45
+ ...(options.status && { status: options.status }),
46
+ };
47
+ const page = await client.workflows.list({
48
+ ...(Object.keys(filter).length > 0 && { filter }),
49
+ ...(options.search && { search: options.search }),
50
+ sortBy: [{ field: 'createdAt', order: SortOrder.DESC }],
51
+ page: 0,
52
+ limit: Number(options.limit),
53
+ });
54
+ const needsInput = page.data.filter((run) => IDLE_STATES.includes(run.status));
55
+ const rest = page.data.filter((run) => !IDLE_STATES.includes(run.status));
56
+ const ordered = [...needsInput, ...rest];
57
+ if (json) {
58
+ const withLinks = ordered.map((run) => {
59
+ const studioUrl = studioRunUrl(connection, run.id);
60
+ return { ...run, ...(studioUrl && { studioUrl }) };
61
+ });
62
+ printData(JSON.stringify(withLinks, null, 2));
63
+ return;
64
+ }
65
+ if (ordered.length === 0) {
66
+ printStatus(`No runs on ${connection.url} yet — start one with \`loopstack run <workflow>\`.`);
67
+ return;
68
+ }
69
+ const rows = ordered.map((run) => [
70
+ run.id,
71
+ run.workflowName,
72
+ `#${run.run}`,
73
+ colorStatus(run.status),
74
+ run.title ?? '',
75
+ new Date(run.createdAt).toLocaleString(),
76
+ ]);
77
+ printData(renderTable(['ID', 'WORKFLOW', 'RUN', 'STATUS', 'TITLE', 'CREATED'], rows));
78
+ printStatus('');
79
+ if (needsInput.length > 0) {
80
+ printStatus(`${pc.yellow('⏸')} ${needsInput.length} waiting for input — answer with \`loopstack runs <run-id> --follow\``);
81
+ }
82
+ printStatus(`${ordered.length} of ${page.total} runs (${connection.name})`);
83
+ }
84
+ async function showRun(client, connection, runId, options, json) {
85
+ const out = json ? process.stderr : process.stdout;
86
+ const link = studioRunUrl(connection, runId);
87
+ if (options.open) {
88
+ if (link)
89
+ openInBrowser(link);
90
+ else
91
+ printStatus('No Studio URL configured for this environment — set one with `loopstack login`.');
92
+ }
93
+ const events = options.follow ? client.stream.events() : undefined;
94
+ const workflow = await client.workflows.get(runId);
95
+ const checkpoints = await client.workflows.checkpoints(runId);
96
+ if (json && !options.follow) {
97
+ printData(JSON.stringify({ workflow, checkpoints, ...(link && { studioUrl: link }) }, null, 2));
98
+ process.exit(ExitCode.Success);
99
+ }
100
+ const title = workflow.title ? ` (${workflow.title})` : '';
101
+ out.write(`${pc.bold(workflow.workflowName)} #${workflow.run}${title} — ${colorStatus(workflow.status)}\n`);
102
+ out.write(pc.dim(`started ${new Date(workflow.createdAt).toLocaleString()} ${workflow.id}\n`));
103
+ if (link)
104
+ out.write(pc.dim(`⧉ ${link}\n`));
105
+ const steps = [];
106
+ for (const checkpoint of checkpoints) {
107
+ const at = new Date(checkpoint.createdAt).getTime();
108
+ const last = steps[steps.length - 1];
109
+ if (last && last.place === checkpoint.place)
110
+ continue;
111
+ if (last)
112
+ last.leftAt = at;
113
+ steps.push({ place: checkpoint.place, enteredAt: at });
114
+ }
115
+ for (const step of steps) {
116
+ if (step.place === 'end')
117
+ continue;
118
+ const duration = step.leftAt !== undefined ? pc.dim(` (${formatDuration(step.leftAt - step.enteredAt)})`) : '';
119
+ out.write(`${pc.green('✓')} ${step.place}${duration}\n`);
120
+ }
121
+ if (workflow.errorMessage)
122
+ out.write(`${pc.red('✖')} ${workflow.errorMessage}\n`);
123
+ if (!options.follow || TERMINAL_STATES.includes(workflow.status)) {
124
+ renderResult(out, workflow.result);
125
+ client.stream.close();
126
+ process.exit(ExitCode.Success);
127
+ }
128
+ out.write(pc.dim('— attached, following live —\n'));
129
+ const onIdle = createIdleHandler(client, runId, out, { studioUrl: link, editor: options.editor });
130
+ const outcome = await followRun(events, runId, out, {
131
+ onIdle,
132
+ initiallyIdle: IDLE_STATES.includes(workflow.status),
133
+ onDocument: createDocumentRenderer(client, out),
134
+ });
135
+ client.stream.close();
136
+ const full = await client.workflows.get(runId);
137
+ if (json) {
138
+ printData(JSON.stringify({ workflowId: runId, status: outcome.status, result: full.result, errorMessage: full.errorMessage }, null, 2));
139
+ }
140
+ if (outcome.status === WorkflowState.Completed) {
141
+ if (!json)
142
+ renderResult(out, full.result);
143
+ out.write(`${pc.green('■')} run completed\n`);
144
+ process.exit(ExitCode.Success);
145
+ }
146
+ if (IDLE_STATES.includes(outcome.status)) {
147
+ out.write(`${pc.yellow('⏸')} run is still waiting for input\n`);
148
+ process.exit(ExitCode.NeedsInput);
149
+ }
150
+ out.write(`${pc.red('■')} run ${outcome.status}${full.errorMessage ? `: ${full.errorMessage}` : ''}\n`);
151
+ process.exit(ExitCode.RunFailed);
152
+ }
153
+ //# sourceMappingURL=runs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/commands/runs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACrH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,eAAe,GAA6B;IAChD,aAAa,CAAC,SAAS;IACvB,aAAa,CAAC,MAAM;IACpB,aAAa,CAAC,QAAQ;CACvB,CAAC;AAEF,MAAM,WAAW,GAA6B,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;AAmB5F,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,8FAA8F,CAAC;SAC3G,MAAM,CAAC,UAAU,EAAE,wEAAwE,CAAC;SAC5F,MAAM,CAAC,aAAa,EAAE,gCAAgC,EAAE,IAAI,CAAC;SAC7D,MAAM,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;SACpD,MAAM,CAAC,iBAAiB,EAAE,aAAa,CAAC;SACxC,MAAM,CAAC,mBAAmB,EAAE,oDAAoD,CAAC;SACjF,MAAM,CAAC,QAAQ,EAAE,4CAA4C,CAAC;SAC9D,MAAM,CAAC,UAAU,EAAE,gEAAgE,CAAC;SACpF,MAAM,CAAC,KAAK,EAAE,KAAyB,EAAE,OAAoB,EAAE,GAAG,EAAE,EAAE;QACrE,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,EAAa,CAAC;QACjD,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,OAAO,CAAC,MAAM;gBAAE,MAAM,IAAI,QAAQ,CAAC,8DAA8D,CAAC,CAAC;YACvG,IAAI,OAAO,CAAC,IAAI;gBAAE,MAAM,IAAI,QAAQ,CAAC,0DAA0D,CAAC,CAAC;YACjG,MAAM,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QACD,MAAM,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACP,CAAC;AAGD,KAAK,UAAU,QAAQ,CACrB,MAAuB,EACvB,UAA8B,EAC9B,OAAoB,EACpB,IAAa;IAEb,MAAM,MAAM,GAAG;QACb,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;QAC5D,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;KAClD,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;QACvC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QACjD,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACjD,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;KAC7B,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,CAAC,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IAEzC,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACpC,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACnD,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACrD,CAAC,CAAC,CAAC;QACH,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,WAAW,CAAC,cAAc,UAAU,CAAC,GAAG,qDAAqD,CAAC,CAAC;QAC/F,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QAChC,GAAG,CAAC,EAAE;QACN,GAAG,CAAC,YAAY;QAChB,IAAI,GAAG,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC;QACvB,GAAG,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE;KACzC,CAAC,CAAC;IACH,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACtF,WAAW,CAAC,EAAE,CAAC,CAAC;IAChB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,WAAW,CACT,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,uEAAuE,CAC9G,CAAC;IACJ,CAAC;IACD,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,OAAO,IAAI,CAAC,KAAK,UAAU,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;AAC9E,CAAC;AAGD,KAAK,UAAU,OAAO,CACpB,MAAuB,EACvB,UAA8B,EAC9B,KAAa,EACb,OAAoB,EACpB,IAAa;IAEb,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACnD,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,IAAI,IAAI;YAAE,aAAa,CAAC,IAAI,CAAC,CAAC;;YACzB,WAAW,CAAC,iFAAiF,CAAC,CAAC;IACtG,CAAC;IAGD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAEnE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAE9D,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAChG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,GAAG,GAAG,KAAK,MAAM,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5G,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,KAAK,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAChG,IAAI,IAAI;QAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC;IAI3C,MAAM,KAAK,GAA4D,EAAE,CAAC;IAC1E,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,KAAK;YAAE,SAAS;QACtD,IAAI,IAAI;YAAE,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;YAAE,SAAS;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,cAAc,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/G,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,QAAQ,IAAI,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,QAAQ,CAAC,YAAY;QAAE,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,YAAY,IAAI,CAAC,CAAC;IAElF,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAKlG,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAO,EAAE,KAAK,EAAE,GAAG,EAAE;QACnD,MAAM;QACN,aAAa,EAAE,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpD,UAAU,EAAE,sBAAsB,CAAC,MAAM,EAAE,GAAG,CAAC;KAChD,CAAC,CAAC;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAEtB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,IAAI,EAAE,CAAC;QACT,SAAS,CACP,IAAI,CAAC,SAAS,CACZ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,EACnG,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,aAAa,CAAC,SAAS,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI;YAAE,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACxG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerWatchCommand(program: Command): void;
3
+ //# sourceMappingURL=watch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6B3D"}
@@ -0,0 +1,48 @@
1
+ import pc from 'picocolors';
2
+ import { createClientFor, resolveConnection } from '../config/resolve.js';
3
+ import { printStatus } from '../output/format.js';
4
+ const collect = (value, previous) => [...previous, value];
5
+ function summarize(message) {
6
+ const parts = [];
7
+ if (typeof message.workflowId === 'string')
8
+ parts.push(message.workflowId);
9
+ if (typeof message.status === 'string')
10
+ parts.push(String(message.status));
11
+ if (typeof message.place === 'string')
12
+ parts.push(`@${String(message.place)}`);
13
+ if (typeof message.delta === 'string')
14
+ parts.push(JSON.stringify(message.delta.slice(0, 40)));
15
+ if (typeof message.workspaceId === 'string')
16
+ parts.push(`ws:${String(message.workspaceId)}`);
17
+ return parts.join(' ');
18
+ }
19
+ export function registerWatchCommand(program) {
20
+ program
21
+ .command('watch')
22
+ .description("Stream the environment's live events (Ctrl+C to stop)")
23
+ .option('--workflow <id>', 'only events of this workflow run')
24
+ .option('--type <type>', 'only this event type (repeatable, e.g. workflow.updated)', collect, [])
25
+ .action(async (options, cmd) => {
26
+ const globals = cmd.optsWithGlobals();
27
+ const connection = resolveConnection(globals);
28
+ const client = createClientFor(connection);
29
+ const json = !!globals.json;
30
+ client.stream.onStatus((status) => printStatus(pc.dim(`stream: ${status}`)));
31
+ client.stream.onAny((message) => {
32
+ const record = message;
33
+ if (options.workflow && record.workflowId !== options.workflow)
34
+ return;
35
+ if (options.type.length > 0 && !options.type.includes(String(record.type)))
36
+ return;
37
+ if (json) {
38
+ console.log(JSON.stringify(message));
39
+ return;
40
+ }
41
+ const time = new Date().toLocaleTimeString();
42
+ console.log(`${pc.dim(time)} ${pc.bold(String(record.type).padEnd(28))} ${summarize(record)}`);
43
+ });
44
+ printStatus(pc.dim(`watching ${connection.url} — Ctrl+C to stop`));
45
+ await new Promise(() => { });
46
+ });
47
+ }
48
+ //# sourceMappingURL=watch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ export interface EnvironmentConfig {
2
+ url: string;
3
+ token?: string;
4
+ workspaceId?: string;
5
+ studioUrl?: string;
6
+ }
7
+ export interface CliConfig {
8
+ defaultEnvironment?: string;
9
+ environments: Record<string, EnvironmentConfig>;
10
+ }
11
+ export declare function configPath(): string;
12
+ export declare function loadConfig(path?: string): CliConfig;
13
+ export declare function saveConfig(config: CliConfig, path?: string): void;
14
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACjD;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAqB,GAAG,SAAS,CAUjE;AAGD,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,GAAE,MAAqB,GAAG,IAAI,CAI/E"}
@@ -0,0 +1,25 @@
1
+ import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
2
+ import { homedir } from 'node:os';
3
+ import { dirname, join } from 'node:path';
4
+ import { CliError } from '../errors.js';
5
+ export function configPath() {
6
+ return join(homedir(), '.loopstack', 'config.json');
7
+ }
8
+ export function loadConfig(path = configPath()) {
9
+ if (!existsSync(path)) {
10
+ return { environments: {} };
11
+ }
12
+ try {
13
+ const parsed = JSON.parse(readFileSync(path, 'utf8'));
14
+ return { ...parsed, environments: parsed.environments ?? {} };
15
+ }
16
+ catch {
17
+ throw new CliError(`Config file ${path} is not valid JSON — fix or delete it.`);
18
+ }
19
+ }
20
+ export function saveConfig(config, path = configPath()) {
21
+ mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
22
+ writeFileSync(path, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
23
+ chmodSync(path, 0o600);
24
+ }
25
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAgBxC,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe,UAAU,EAAE;IACpD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC9B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAuB,CAAC;QAC5E,OAAO,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,eAAe,IAAI,wCAAwC,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,UAAU,CAAC,MAAiB,EAAE,OAAe,UAAU,EAAE;IACvE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC"}
@@ -0,0 +1,18 @@
1
+ import type { LoopstackClient } from '@loopstack/client';
2
+ import type { CliConfig } from './config.js';
3
+ export interface ConnectionFlags {
4
+ env?: string;
5
+ url?: string;
6
+ token?: string;
7
+ }
8
+ export interface ResolvedConnection {
9
+ name: string;
10
+ url: string;
11
+ token?: string;
12
+ workspaceId?: string;
13
+ studioUrl?: string;
14
+ source: 'flags' | 'env-vars' | 'config' | 'default';
15
+ }
16
+ export declare function resolveConnection(flags: ConnectionFlags, env?: NodeJS.ProcessEnv, config?: CliConfig): ResolvedConnection;
17
+ export declare function createClientFor(connection: ResolvedConnection): LoopstackClient;
18
+ //# sourceMappingURL=resolve.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IAEjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;CACrD;AAYD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,EACtB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,MAAM,GAAE,SAAwB,GAC/B,kBAAkB,CAoDpB;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,kBAAkB,GAAG,eAAe,CAE/E"}
@@ -0,0 +1,57 @@
1
+ import { createClient } from '@loopstack/client';
2
+ import { CliError } from '../errors.js';
3
+ import { loadConfig } from './config.js';
4
+ const LOCAL_URL = 'http://localhost:3000';
5
+ const LOCAL_STUDIO_URL = 'http://localhost:5173';
6
+ export function resolveConnection(flags, env = process.env, config = loadConfig()) {
7
+ const tokenOverride = flags.token ?? env.LOOPSTACK_TOKEN;
8
+ const studioOverride = env.LOOPSTACK_STUDIO_URL;
9
+ if (flags.url) {
10
+ return { name: flags.url, url: flags.url, token: tokenOverride, studioUrl: studioOverride, source: 'flags' };
11
+ }
12
+ if (flags.env) {
13
+ const saved = config.environments[flags.env];
14
+ if (!saved) {
15
+ throw new CliError(`Unknown environment "${flags.env}" — run \`loopstack env list\` or \`loopstack login\`.`);
16
+ }
17
+ return {
18
+ name: flags.env,
19
+ url: saved.url,
20
+ token: tokenOverride ?? saved.token,
21
+ workspaceId: saved.workspaceId,
22
+ studioUrl: studioOverride ?? saved.studioUrl,
23
+ source: 'flags',
24
+ };
25
+ }
26
+ if (env.LOOPSTACK_URL) {
27
+ return {
28
+ name: env.LOOPSTACK_URL,
29
+ url: env.LOOPSTACK_URL,
30
+ token: tokenOverride,
31
+ studioUrl: studioOverride,
32
+ source: 'env-vars',
33
+ };
34
+ }
35
+ if (config.defaultEnvironment && config.environments[config.defaultEnvironment]) {
36
+ const saved = config.environments[config.defaultEnvironment];
37
+ return {
38
+ name: config.defaultEnvironment,
39
+ url: saved.url,
40
+ token: tokenOverride ?? saved.token,
41
+ workspaceId: saved.workspaceId,
42
+ studioUrl: studioOverride ?? saved.studioUrl,
43
+ source: 'config',
44
+ };
45
+ }
46
+ return {
47
+ name: 'local',
48
+ url: LOCAL_URL,
49
+ token: tokenOverride,
50
+ studioUrl: studioOverride ?? LOCAL_STUDIO_URL,
51
+ source: 'default',
52
+ };
53
+ }
54
+ export function createClientFor(connection) {
55
+ return createClient({ url: connection.url, token: connection.token, envKey: connection.name });
56
+ }
57
+ //# sourceMappingURL=resolve.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAoBzC,MAAM,SAAS,GAAG,uBAAuB,CAAC;AAC1C,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AASjD,MAAM,UAAU,iBAAiB,CAC/B,KAAsB,EACtB,MAAyB,OAAO,CAAC,GAAG,EACpC,SAAoB,UAAU,EAAE;IAEhC,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC,eAAe,CAAC;IACzD,MAAM,cAAc,GAAG,GAAG,CAAC,oBAAoB,CAAC;IAEhD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC/G,CAAC;IAED,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,QAAQ,CAAC,wBAAwB,KAAK,CAAC,GAAG,wDAAwD,CAAC,CAAC;QAChH,CAAC;QACD,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,GAAG;YACf,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,aAAa,IAAI,KAAK,CAAC,KAAK;YACnC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,cAAc,IAAI,KAAK,CAAC,SAAS;YAC5C,MAAM,EAAE,OAAO;SAChB,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,aAAa;YACvB,GAAG,EAAE,GAAG,CAAC,aAAa;YACtB,KAAK,EAAE,aAAa;YACpB,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAChF,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,kBAAkB;YAC/B,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,aAAa,IAAI,KAAK,CAAC,KAAK;YACnC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,cAAc,IAAI,KAAK,CAAC,SAAS;YAC5C,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,cAAc,IAAI,gBAAgB;QAC7C,MAAM,EAAE,SAAS;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAA8B;IAC5D,OAAO,YAAY,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;AACjG,CAAC"}
@@ -0,0 +1,12 @@
1
+ export declare const ExitCode: {
2
+ readonly Success: 0;
3
+ readonly RunFailed: 1;
4
+ readonly ConnectionOrConfig: 2;
5
+ readonly NeedsInput: 3;
6
+ };
7
+ export declare class CliError extends Error {
8
+ readonly exitCode: number;
9
+ constructor(message: string, exitCode?: number);
10
+ }
11
+ export declare function handleError(error: unknown, url?: string): never;
12
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AAEX,qBAAa,QAAS,SAAQ,KAAK;IAG/B,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBADzB,OAAO,EAAE,MAAM,EACN,QAAQ,GAAE,MAAoC;CAI1D;AAOD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAgB/D"}
package/dist/errors.js 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,16 @@
1
+ import type { LoopstackClient } from '@loopstack/client';
2
+ import type { DocumentItemInterface, WorkflowFullInterface } from '@loopstack/contracts/api';
3
+ export interface WidgetConfig {
4
+ widget: string;
5
+ options?: Record<string, unknown>;
6
+ enabledWhen?: string[];
7
+ schema?: Record<string, unknown>;
8
+ }
9
+ export declare function fetchDocumentWidgets(client: LoopstackClient): Promise<Map<string, WidgetConfig>>;
10
+ export interface ActivePrompt {
11
+ workflow: WorkflowFullInterface;
12
+ document?: DocumentItemInterface;
13
+ widget?: WidgetConfig;
14
+ }
15
+ export declare function findActivePrompt(client: LoopstackClient, rootWorkflowId: string, widgets: Map<string, WidgetConfig>, workflowWidgets?: Map<string, WidgetConfig[]>): Promise<ActivePrompt | undefined>;
16
+ //# 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;AAI7F,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AASD,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAetG;AAED,MAAM,WAAW,YAAY;IAE3B,QAAQ,EAAE,qBAAqB,CAAC;IAEhC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AA4BD,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,YAAY,GAAG,SAAS,CAAC,CA6CnC"}
@@ -0,0 +1,67 @@
1
+ import { SortOrder, WorkflowState } from '@loopstack/contracts/enums';
2
+ const PROMPT_WIDGETS = new Set(['text-prompt', 'confirm-prompt', 'choices', 'form']);
3
+ const WORKFLOW_PROMPT_WIDGETS = new Set(['prompt-input']);
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
+ widgets.set(document.documentName, {
12
+ ...widget,
13
+ schema: document.schema,
14
+ });
15
+ }
16
+ }
17
+ }
18
+ return widgets;
19
+ }
20
+ async function findWorkflowPromptWidget(client, workflow, cache) {
21
+ let widgets = cache.get(workflow.workflowName);
22
+ if (!widgets) {
23
+ const config = await client.config.workflowConfig(workflow.workflowName).catch(() => undefined);
24
+ widgets = (config?.ui?.widgets ?? []).filter((widget) => WORKFLOW_PROMPT_WIDGETS.has(widget.widget));
25
+ cache.set(workflow.workflowName, widgets);
26
+ }
27
+ return widgets.find((widget) => !widget.enabledWhen || widget.enabledWhen.includes(workflow.place ?? ''));
28
+ }
29
+ export async function findActivePrompt(client, rootWorkflowId, widgets, workflowWidgets = new Map()) {
30
+ const queue = [rootWorkflowId];
31
+ const visited = new Set();
32
+ let fallback;
33
+ while (queue.length > 0) {
34
+ const id = queue.shift();
35
+ if (visited.has(id))
36
+ continue;
37
+ visited.add(id);
38
+ const workflow = await client.workflows.get(id);
39
+ const isIdle = workflow.status === WorkflowState.Waiting || workflow.status === WorkflowState.Paused;
40
+ if (isIdle && workflow.availableTransitions?.length) {
41
+ const page = await client.documents.list({
42
+ filter: { workflowId: id, isInvalidated: false },
43
+ sortBy: [{ field: 'index', order: SortOrder.DESC }],
44
+ limit: 10,
45
+ });
46
+ const prompt = page.data.find((document) => {
47
+ const widget = widgets.get(document.documentName);
48
+ if (!widget || !PROMPT_WIDGETS.has(widget.widget))
49
+ return false;
50
+ const content = document.content;
51
+ return !content || content.answer === undefined;
52
+ });
53
+ if (prompt) {
54
+ return { workflow, document: prompt, widget: widgets.get(prompt.documentName) };
55
+ }
56
+ const workflowWidget = await findWorkflowPromptWidget(client, workflow, workflowWidgets);
57
+ if (workflowWidget) {
58
+ return { workflow, widget: workflowWidget };
59
+ }
60
+ fallback ??= { workflow };
61
+ }
62
+ const children = await client.workflows.list({ filter: { parentId: id } });
63
+ queue.push(...children.data.map((child) => child.id));
64
+ }
65
+ return fallback;
66
+ }
67
+ //# 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,4 @@
1
+ export declare function buildFormSkeleton(content: unknown, schema?: Record<string, unknown>): Record<string, unknown>;
2
+ export declare function describeFormFields(schema?: Record<string, unknown>): string[];
3
+ export declare function editPayloadInEditor(initial: Record<string, unknown>, out: NodeJS.WritableStream): unknown;
4
+ //# sourceMappingURL=editor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/hitl/editor.ts"],"names":[],"mappings":"AAiCA,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS7G;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAU7E;AAQD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAqBzG"}
@@ -0,0 +1,73 @@
1
+ import { spawnSync } from 'node:child_process';
2
+ import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { join } from 'node:path';
5
+ import pc from 'picocolors';
6
+ function emptyValue(property) {
7
+ if (property.default !== undefined)
8
+ return property.default;
9
+ switch (property.type) {
10
+ case 'string':
11
+ return '';
12
+ case 'number':
13
+ case 'integer':
14
+ return 0;
15
+ case 'boolean':
16
+ return false;
17
+ case 'array':
18
+ return [];
19
+ case 'object':
20
+ return {};
21
+ default:
22
+ return null;
23
+ }
24
+ }
25
+ export function buildFormSkeleton(content, schema) {
26
+ if (content && typeof content === 'object' && Object.keys(content).length > 0) {
27
+ return content;
28
+ }
29
+ const typed = schema;
30
+ if (typed?.type === 'object' && typed.properties) {
31
+ return Object.fromEntries(Object.entries(typed.properties).map(([key, property]) => [key, emptyValue(property)]));
32
+ }
33
+ return {};
34
+ }
35
+ export function describeFormFields(schema) {
36
+ const typed = schema;
37
+ if (typed?.type !== 'object' || !typed.properties)
38
+ return [];
39
+ const required = new Set(typed.required ?? []);
40
+ return Object.entries(typed.properties).map(([key, property]) => {
41
+ const parts = [property.type ?? 'any'];
42
+ if (required.has(key))
43
+ parts.push('required');
44
+ const description = property.description ? ` — ${property.description}` : '';
45
+ return ` ${key} (${parts.join(', ')})${description}`;
46
+ });
47
+ }
48
+ export function editPayloadInEditor(initial, out) {
49
+ const editor = process.env.EDITOR || process.env.VISUAL || 'vi';
50
+ const dir = mkdtempSync(join(tmpdir(), 'loopstack-'));
51
+ const file = join(dir, 'answer.json');
52
+ writeFileSync(file, JSON.stringify(initial, null, 2) + '\n');
53
+ try {
54
+ while (true) {
55
+ const result = spawnSync(`${editor} ${JSON.stringify(file)}`, { shell: true, stdio: 'inherit' });
56
+ if (result.status !== 0)
57
+ return undefined;
58
+ const text = readFileSync(file, 'utf8').trim();
59
+ if (!text)
60
+ return undefined;
61
+ try {
62
+ return JSON.parse(text);
63
+ }
64
+ catch (error) {
65
+ out.write(pc.red(`invalid JSON (${error instanceof Error ? error.message : String(error)}) — reopening…\n`));
66
+ }
67
+ }
68
+ }
69
+ finally {
70
+ rmSync(dir, { recursive: true, force: true });
71
+ }
72
+ }
73
+ //# sourceMappingURL=editor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"editor.js","sourceRoot":"","sources":["../../src/hitl/editor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { LoopstackClient } from '@loopstack/client';
2
+ import type { IdleOutcome } from '../run/follow.js';
3
+ export interface IdleHandlerOptions {
4
+ studioUrl?: string;
5
+ editor?: boolean;
6
+ }
7
+ export declare function createIdleHandler(client: LoopstackClient, rootWorkflowId: string, out: NodeJS.WritableStream, options?: IdleHandlerOptions): (signal: AbortSignal, onPromptWorkflow: (id: string) => void) => Promise<IdleOutcome>;
8
+ //# 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;AAKpD,MAAM,WAAW,kBAAkB;IAEjC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA2BD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,EACvB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,OAAO,GAAE,kBAAuB,GAC/B,CAAC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,WAAW,CAAC,CAmEvF"}