@flowrunner/cli 0.1.4 → 0.1.5-dev.1

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 (48) hide show
  1. package/ai-docs/instructions/service-code-format/08-polling-triggers.md +2 -2
  2. package/dist/cli.js +46 -31
  3. package/dist/cli.js.map +3 -3
  4. package/dist/index.js +14 -7
  5. package/dist/index.js.map +2 -2
  6. package/dist/types/shared/src/constants/docs.d.ts +4 -0
  7. package/dist/types/shared/src/constants/error-codes.d.ts +1 -0
  8. package/dist/types/shared/src/constants/index.d.ts +1 -0
  9. package/dist/types/shared/src/constants/knowledge-base.d.ts +1 -0
  10. package/dist/types/shared/src/constants/notification-types.d.ts +95 -22
  11. package/dist/types/shared/src/constants/shared-extensions.d.ts +9 -0
  12. package/dist/types/shared/src/errors/k8s.d.ts +10 -0
  13. package/dist/types/shared/src/scheme/crm/dto.d.ts +2 -2
  14. package/dist/types/shared/src/scheme/flowrunner/custom-elements.d.ts +20 -29
  15. package/dist/types/shared/src/scheme/integration-connection/dto.d.ts +2 -2
  16. package/dist/types/shared/src/scheme/knowledge-base/dto.d.ts +80 -0
  17. package/dist/types/shared/src/scheme/notifications/dto.d.ts +3 -0
  18. package/dist/types/shared/src/scheme/notifications/rest.d.ts +6 -0
  19. package/dist/types/shared/src/scheme/shared-extensions/config.d.ts +20 -20
  20. package/dist/types/shared/src/scheme/shared-extensions/custom-extensions.d.ts +30 -36
  21. package/dist/types/shared/src/scheme/shared-extensions/extension.d.ts +40 -40
  22. package/dist/types/shared/src/scheme/shared-extensions/index.d.ts +1 -0
  23. package/dist/types/shared/src/scheme/shared-extensions/resolve.d.ts +15 -24
  24. package/dist/types/shared/src/scheme/shared-extensions/search.d.ts +10 -10
  25. package/dist/types/shared/src/scheme/shared-extensions/workspace-stack.d.ts +44 -0
  26. package/dist/types/shared/src/scheme/workspace/dto.d.ts +1 -1
  27. package/package.json +1 -1
  28. package/runtime/index.js +14 -7
  29. package/runtime/index.js.map +2 -2
  30. package/runtime/types/shared/src/constants/docs.d.ts +4 -0
  31. package/runtime/types/shared/src/constants/error-codes.d.ts +1 -0
  32. package/runtime/types/shared/src/constants/index.d.ts +1 -0
  33. package/runtime/types/shared/src/constants/knowledge-base.d.ts +1 -0
  34. package/runtime/types/shared/src/constants/notification-types.d.ts +95 -22
  35. package/runtime/types/shared/src/constants/shared-extensions.d.ts +9 -0
  36. package/runtime/types/shared/src/errors/k8s.d.ts +10 -0
  37. package/runtime/types/shared/src/scheme/flowrunner/custom-elements.d.ts +20 -29
  38. package/runtime/types/shared/src/scheme/integration-connection/dto.d.ts +2 -2
  39. package/runtime/types/shared/src/scheme/knowledge-base/dto.d.ts +80 -0
  40. package/runtime/types/shared/src/scheme/notifications/dto.d.ts +3 -0
  41. package/runtime/types/shared/src/scheme/notifications/rest.d.ts +6 -0
  42. package/runtime/types/shared/src/scheme/shared-extensions/config.d.ts +20 -20
  43. package/runtime/types/shared/src/scheme/shared-extensions/custom-extensions.d.ts +30 -36
  44. package/runtime/types/shared/src/scheme/shared-extensions/extension.d.ts +40 -40
  45. package/runtime/types/shared/src/scheme/shared-extensions/index.d.ts +1 -0
  46. package/runtime/types/shared/src/scheme/shared-extensions/resolve.d.ts +15 -24
  47. package/runtime/types/shared/src/scheme/shared-extensions/search.d.ts +10 -10
  48. package/runtime/types/shared/src/scheme/shared-extensions/workspace-stack.d.ts +44 -0
@@ -21,7 +21,7 @@ Declare **exactly one** mechanism.
21
21
 
22
22
  | Mechanism | Config | Runtime behavior |
23
23
  |---|---|---|
24
- | `dedupe` (seen-set) | `item => id` (or field path); or `{ by, stateKey='seen', max=500 }` | Keeps a bounded id set under `stateKey`; emits items whose id is new. Covers new-by-id + stateless-newest (head-only `fetch`). |
24
+ | `dedupe` (seen-set) | `item => id` (or field path); or `{ by, stateKey='seen', max=500 }` | Keeps the last `max` ids it has seen under `stateKey`, oldest first, and forgets the oldest when full (an id still in the feed counts as just seen); emits items whose id is new. Covers new-by-id + stateless-newest (head-only `fetch`). |
25
25
  | `watermark` (marker) | `{ by, stateKey='watermark', sortedDesc? }` — `by` = field path or `(item,{params})=>value` | Stores newest marker, emits items past it, advances. `sortedDesc:true` stops at the first non-newer item — **only for a strictly newest-first feed**, see below. Covers new-by-date + new-or-updated. |
26
26
  | `poll` (escape hatch) | fn (above) | Full control; author owns `state` shape. Covers overlap-window+dedup, lag-held cursor, consuming/offset feeds. |
27
27
 
@@ -29,7 +29,7 @@ Declare **exactly one** mechanism.
29
29
 
30
30
  | Phase | `dedupe` | `watermark` | `poll` |
31
31
  |---|---|---|---|
32
- | start (no state) | `null → { seen:{…} }` \| `[]` (seed) | `null → { <marker> }` \| `[]` (seed) | `null → seeded` \| `[]` (seed yourself) |
32
+ | start (no state) | `null → { seen:[…] }` \| `[]` (seed) | `null → { <marker> }` \| `[]` (seed) | `null → seeded` \| `[]` (seed yourself) |
33
33
  | learningMode | `null → null` \| everything `fetch` returned | `null → null` \| everything `fetch` returned | **no handling** — whatever you return |
34
34
  | timer | `{seen} → {seen+new}` \| `[new]` | `{marker} → {advanced}` \| `[past marker]` | yours → yours \| your delta |
35
35
 
package/dist/cli.js CHANGED
@@ -4185,10 +4185,10 @@ var require_package = __commonJS({
4185
4185
  "package.json"(exports2, module2) {
4186
4186
  module2.exports = {
4187
4187
  name: "@flowrunner/cli",
4188
+ version: "0.1.5-dev.1",
4188
4189
  publishConfig: {
4189
4190
  access: "public"
4190
4191
  },
4191
- version: "0.1.4",
4192
4192
  engines: {
4193
4193
  node: ">=20"
4194
4194
  },
@@ -4672,7 +4672,7 @@ function stripConditionals(source, answers, origin) {
4672
4672
  throw new Error(`Unknown flag "${name}" in {{#if}} at ${origin}:${index + 1}`);
4673
4673
  }
4674
4674
  const matches = expected === void 0 ? Boolean(answers[name]) : String(answers[name]) === expected;
4675
- stack.push({ name, keep: matches && stack.every((frame2) => frame2.keep) });
4675
+ stack.push({ name, keep: matches && stack.every((frame) => frame.keep) });
4676
4676
  continue;
4677
4677
  }
4678
4678
  if (IF_CLOSE.test(line)) {
@@ -4681,7 +4681,7 @@ function stripConditionals(source, answers, origin) {
4681
4681
  }
4682
4682
  continue;
4683
4683
  }
4684
- if (stack.every((frame2) => frame2.keep)) {
4684
+ if (stack.every((frame) => frame.keep)) {
4685
4685
  output.push(line);
4686
4686
  }
4687
4687
  }
@@ -7765,17 +7765,24 @@ var DedupeMechanism = class extends FetchingMechanism {
7765
7765
  delta(items, state) {
7766
7766
  const currentIds = items.map(this.#by).map((id) => `${id}`);
7767
7767
  if (!state?.[this.#stateKey]) {
7768
- return { events: [], state: { [this.#stateKey]: this.#buildSeen(currentIds) } };
7768
+ return { events: [], state: { [this.#stateKey]: this.#buildSeen([], currentIds) } };
7769
7769
  }
7770
- const seen = state[this.#stateKey];
7771
- const events = items.filter((item) => !seen[`${this.#by(item)}`]);
7772
- return { events, state: { [this.#stateKey]: this.#buildSeen([...Object.keys(seen), ...currentIds]) } };
7770
+ const seen = toSeenList(state[this.#stateKey]);
7771
+ const seenSet = new Set(seen);
7772
+ const events = items.filter((_item, index) => !seenSet.has(currentIds[index]));
7773
+ return { events, state: { [this.#stateKey]: this.#buildSeen(seen, currentIds) } };
7773
7774
  }
7774
- // Bounded id → 1 map, keeping the most-recent `max` ids (dedup, last occurrence wins).
7775
- #buildSeen(ids) {
7776
- return [...new Set(ids)].slice(-this.#max).reduce((acc, id) => ({ ...acc, [id]: 1 }), {});
7775
+ // Bounded id list, oldest first, keeping the most-recent `max` ids. An id fetched again moves to the end,
7776
+ // so an item that is still in the feed is never the one evicted. It is a list, not an `{ id: 1 }` map: a
7777
+ // map orders integer-like keys numerically, which evicted the SMALLEST id instead of the oldest one.
7778
+ #buildSeen(seen, currentIds) {
7779
+ const fetched = new Set(currentIds);
7780
+ return [...seen.filter((id) => !fetched.has(id)), ...fetched].slice(-this.#max);
7777
7781
  }
7778
7782
  };
7783
+ var toSeenList = (value) => {
7784
+ return Array.isArray(value) ? value.map((id) => `${id}`) : Object.keys(value);
7785
+ };
7779
7786
  var isNewer = (value, marker) => value > marker;
7780
7787
  var WatermarkMechanism = class extends FetchingMechanism {
7781
7788
  constructor(fetch2, config) {
@@ -9926,6 +9933,7 @@ async function interactiveLogin(gap) {
9926
9933
 
9927
9934
  // src/cli/prompts/select-list.ts
9928
9935
  var import_node_readline = __toESM(require("node:readline"));
9936
+ var import_node_util = require("node:util");
9929
9937
  function canRenderList() {
9930
9938
  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
9931
9939
  }
@@ -9966,46 +9974,52 @@ var SHOW_CURSOR = "\x1B[?25h";
9966
9974
  function styling() {
9967
9975
  return process.env.NO_COLOR ? { dim: "", bold: "", reset: "" } : { dim: "\x1B[2m", bold: "\x1B[1m", reset: "\x1B[0m" };
9968
9976
  }
9969
- function fit(line, plainLength) {
9970
- const width = (process.stdout.columns || 80) - 1;
9971
- return plainLength <= width ? line : `${line.slice(0, line.length - (plainLength - width) - 1)}\u2026`;
9977
+ function terminalColumns() {
9978
+ return process.stdout.columns || 80;
9972
9979
  }
9973
- function frame(choices, selected) {
9980
+ function renderFrame(choices, selected, columns) {
9974
9981
  const { dim, bold, reset } = styling();
9975
- const lines = [];
9982
+ const rows = [];
9976
9983
  for (const [index, choice] of choices.entries()) {
9977
9984
  const active = index === selected;
9978
- const pointer = active ? "\u276F" : " ";
9979
- const label = active ? `${bold}${choice.label}${reset}` : choice.label;
9980
- lines.push(fit(`${pointer} ${label}`, `${pointer} ${choice.label}`.length));
9985
+ rows.push({ prefix: active ? "\u276F " : " ", text: choice.label, style: active ? bold : "" });
9981
9986
  if (choice.description) {
9982
- lines.push(fit(` ${dim}${choice.description}${reset}`, ` ${choice.description}`.length));
9987
+ rows.push({ prefix: " ", text: choice.description, style: dim });
9983
9988
  }
9984
9989
  }
9985
- lines.push("");
9986
- lines.push(fit(
9987
- `${dim} \u2191/\u2193 to move \xB7 enter to select \xB7 esc to cancel${reset}`,
9988
- " \u2191/\u2193 to move \xB7 enter to select \xB7 esc to cancel".length
9989
- ));
9990
- return lines;
9990
+ rows.push({ prefix: "", text: "", style: "" });
9991
+ rows.push({ prefix: " ", text: "\u2191/\u2193 to move \xB7 enter to select \xB7 esc to cancel", style: dim });
9992
+ const width = columns - 1;
9993
+ return rows.map(({ prefix, text: text2, style }) => {
9994
+ const room = width - prefix.length;
9995
+ const fitted = text2.length <= room ? text2 : `${text2.slice(0, Math.max(room - 1, 0))}\u2026`;
9996
+ return style && fitted ? `${prefix}${style}${fitted}${reset}` : `${prefix}${fitted}`;
9997
+ });
9998
+ }
9999
+ function rowsOccupied(lines, columns) {
10000
+ return lines.reduce((total, line) => {
10001
+ const visible = (0, import_node_util.stripVTControlCharacters)(line).length;
10002
+ return total + Math.max(1, Math.ceil(visible / columns));
10003
+ }, 0);
9991
10004
  }
9992
10005
  function selectFromList(title, choices, startAt = 0) {
9993
10006
  const { stdin, stdout } = process;
9994
10007
  return new Promise((resolve, reject) => {
9995
10008
  let selected = Math.min(Math.max(startAt, 0), choices.length - 1);
9996
- let painted = 0;
10009
+ let painted = [];
9997
10010
  const draw = () => {
9998
- if (painted > 0) {
9999
- import_node_readline.default.moveCursor(stdout, 0, -painted);
10011
+ const columns = terminalColumns();
10012
+ if (painted.length > 0) {
10013
+ import_node_readline.default.moveCursor(stdout, 0, -rowsOccupied(painted, columns));
10000
10014
  import_node_readline.default.clearScreenDown(stdout);
10001
10015
  }
10002
- const lines = frame(choices, selected);
10003
- stdout.write(`${lines.join("\n")}
10016
+ painted = renderFrame(choices, selected, columns);
10017
+ stdout.write(`${painted.join("\n")}
10004
10018
  `);
10005
- painted = lines.length;
10006
10019
  };
10007
10020
  const cleanup = () => {
10008
10021
  stdin.off("keypress", onKeypress);
10022
+ stdout.off("resize", draw);
10009
10023
  if (stdin.isTTY) {
10010
10024
  stdin.setRawMode(false);
10011
10025
  }
@@ -10037,6 +10051,7 @@ ${title}
10037
10051
  stdin.setRawMode(true);
10038
10052
  stdin.resume();
10039
10053
  stdin.on("keypress", onKeypress);
10054
+ stdout.on("resize", draw);
10040
10055
  draw();
10041
10056
  });
10042
10057
  }