clinkx 0.2.0 → 0.2.2

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 (149) hide show
  1. package/clinkx-workflows/dist/artifacts.d.ts +65 -0
  2. package/clinkx-workflows/dist/artifacts.js +268 -0
  3. package/clinkx-workflows/dist/artifacts.js.map +1 -0
  4. package/clinkx-workflows/dist/backend.d.ts +33 -0
  5. package/clinkx-workflows/dist/backend.js +9 -0
  6. package/clinkx-workflows/dist/backend.js.map +1 -0
  7. package/clinkx-workflows/dist/child-env.d.ts +23 -0
  8. package/clinkx-workflows/dist/child-env.js +53 -0
  9. package/clinkx-workflows/dist/child-env.js.map +1 -0
  10. package/clinkx-workflows/dist/clink-client.d.ts +51 -0
  11. package/clinkx-workflows/dist/clink-client.js +216 -0
  12. package/clinkx-workflows/dist/clink-client.js.map +1 -0
  13. package/clinkx-workflows/dist/config.d.ts +126 -0
  14. package/clinkx-workflows/dist/config.js +226 -0
  15. package/clinkx-workflows/dist/config.js.map +1 -0
  16. package/clinkx-workflows/dist/definition-normalizer.d.ts +59 -0
  17. package/clinkx-workflows/dist/definition-normalizer.js +75 -0
  18. package/clinkx-workflows/dist/definition-normalizer.js.map +1 -0
  19. package/clinkx-workflows/dist/engine.d.ts +235 -0
  20. package/clinkx-workflows/dist/engine.js +1044 -0
  21. package/clinkx-workflows/dist/engine.js.map +1 -0
  22. package/clinkx-workflows/dist/errors.d.ts +74 -0
  23. package/clinkx-workflows/dist/errors.js +84 -0
  24. package/clinkx-workflows/dist/errors.js.map +1 -0
  25. package/clinkx-workflows/dist/fidelity.d.ts +112 -0
  26. package/clinkx-workflows/dist/fidelity.js +140 -0
  27. package/clinkx-workflows/dist/fidelity.js.map +1 -0
  28. package/clinkx-workflows/dist/fingerprint.d.ts +69 -0
  29. package/clinkx-workflows/dist/fingerprint.js +143 -0
  30. package/clinkx-workflows/dist/fingerprint.js.map +1 -0
  31. package/clinkx-workflows/dist/index.d.ts +16 -0
  32. package/clinkx-workflows/dist/index.js +42 -0
  33. package/clinkx-workflows/dist/index.js.map +1 -0
  34. package/clinkx-workflows/dist/loader.d.ts +64 -0
  35. package/clinkx-workflows/dist/loader.js +371 -0
  36. package/clinkx-workflows/dist/loader.js.map +1 -0
  37. package/clinkx-workflows/dist/logger.d.ts +16 -0
  38. package/clinkx-workflows/dist/logger.js +31 -0
  39. package/clinkx-workflows/dist/logger.js.map +1 -0
  40. package/clinkx-workflows/dist/path-validation.d.ts +23 -0
  41. package/clinkx-workflows/dist/path-validation.js +73 -0
  42. package/clinkx-workflows/dist/path-validation.js.map +1 -0
  43. package/clinkx-workflows/dist/prompt-budget.d.ts +31 -0
  44. package/clinkx-workflows/dist/prompt-budget.js +78 -0
  45. package/clinkx-workflows/dist/prompt-budget.js.map +1 -0
  46. package/clinkx-workflows/dist/queue.d.ts +16 -0
  47. package/clinkx-workflows/dist/queue.js +46 -0
  48. package/clinkx-workflows/dist/queue.js.map +1 -0
  49. package/clinkx-workflows/dist/ranking-reducer.d.ts +11 -0
  50. package/clinkx-workflows/dist/ranking-reducer.js +245 -0
  51. package/clinkx-workflows/dist/ranking-reducer.js.map +1 -0
  52. package/clinkx-workflows/dist/reducers/index.d.ts +8 -0
  53. package/clinkx-workflows/dist/reducers/index.js +12 -0
  54. package/clinkx-workflows/dist/reducers/index.js.map +1 -0
  55. package/clinkx-workflows/dist/run-id.d.ts +17 -0
  56. package/clinkx-workflows/dist/run-id.js +26 -0
  57. package/clinkx-workflows/dist/run-id.js.map +1 -0
  58. package/clinkx-workflows/dist/run-summary/cards/council-answer.d.ts +8 -0
  59. package/clinkx-workflows/dist/run-summary/cards/council-answer.js +75 -0
  60. package/clinkx-workflows/dist/run-summary/cards/council-answer.js.map +1 -0
  61. package/clinkx-workflows/dist/run-summary/cards/council-code-review.d.ts +13 -0
  62. package/clinkx-workflows/dist/run-summary/cards/council-code-review.js +90 -0
  63. package/clinkx-workflows/dist/run-summary/cards/council-code-review.js.map +1 -0
  64. package/clinkx-workflows/dist/run-summary/cards/council-debug.d.ts +9 -0
  65. package/clinkx-workflows/dist/run-summary/cards/council-debug.js +79 -0
  66. package/clinkx-workflows/dist/run-summary/cards/council-debug.js.map +1 -0
  67. package/clinkx-workflows/dist/run-summary/cards/council-default.d.ts +11 -0
  68. package/clinkx-workflows/dist/run-summary/cards/council-default.js +57 -0
  69. package/clinkx-workflows/dist/run-summary/cards/council-default.js.map +1 -0
  70. package/clinkx-workflows/dist/run-summary/cards/council-discover.d.ts +10 -0
  71. package/clinkx-workflows/dist/run-summary/cards/council-discover.js +79 -0
  72. package/clinkx-workflows/dist/run-summary/cards/council-discover.js.map +1 -0
  73. package/clinkx-workflows/dist/run-summary/cards/generic.d.ts +2 -0
  74. package/clinkx-workflows/dist/run-summary/cards/generic.js +4 -0
  75. package/clinkx-workflows/dist/run-summary/cards/generic.js.map +1 -0
  76. package/clinkx-workflows/dist/run-summary/cards/index.d.ts +6 -0
  77. package/clinkx-workflows/dist/run-summary/cards/index.js +17 -0
  78. package/clinkx-workflows/dist/run-summary/cards/index.js.map +1 -0
  79. package/clinkx-workflows/dist/run-summary/utils.d.ts +6 -0
  80. package/clinkx-workflows/dist/run-summary/utils.js +30 -0
  81. package/clinkx-workflows/dist/run-summary/utils.js.map +1 -0
  82. package/clinkx-workflows/dist/run-summary-derived.d.ts +19 -0
  83. package/clinkx-workflows/dist/run-summary-derived.js +100 -0
  84. package/clinkx-workflows/dist/run-summary-derived.js.map +1 -0
  85. package/clinkx-workflows/dist/run-summary.d.ts +70 -0
  86. package/clinkx-workflows/dist/run-summary.js +125 -0
  87. package/clinkx-workflows/dist/run-summary.js.map +1 -0
  88. package/clinkx-workflows/dist/schema.d.ts +609 -0
  89. package/clinkx-workflows/dist/schema.js +123 -0
  90. package/clinkx-workflows/dist/schema.js.map +1 -0
  91. package/clinkx-workflows/dist/server.d.ts +16 -0
  92. package/clinkx-workflows/dist/server.js +33 -0
  93. package/clinkx-workflows/dist/server.js.map +1 -0
  94. package/clinkx-workflows/dist/shutdown.d.ts +54 -0
  95. package/clinkx-workflows/dist/shutdown.js +120 -0
  96. package/clinkx-workflows/dist/shutdown.js.map +1 -0
  97. package/clinkx-workflows/dist/state-schema.d.ts +141 -0
  98. package/clinkx-workflows/dist/state-schema.js +21 -0
  99. package/clinkx-workflows/dist/state-schema.js.map +1 -0
  100. package/clinkx-workflows/dist/state.d.ts +37 -0
  101. package/clinkx-workflows/dist/state.js +838 -0
  102. package/clinkx-workflows/dist/state.js.map +1 -0
  103. package/clinkx-workflows/dist/template-loader.d.ts +30 -0
  104. package/clinkx-workflows/dist/template-loader.js +77 -0
  105. package/clinkx-workflows/dist/template-loader.js.map +1 -0
  106. package/clinkx-workflows/dist/template.d.ts +54 -0
  107. package/clinkx-workflows/dist/template.js +128 -0
  108. package/clinkx-workflows/dist/template.js.map +1 -0
  109. package/clinkx-workflows/dist/transport.d.ts +91 -0
  110. package/clinkx-workflows/dist/transport.js +249 -0
  111. package/clinkx-workflows/dist/transport.js.map +1 -0
  112. package/clinkx-workflows/dist/types.d.ts +137 -0
  113. package/clinkx-workflows/dist/types.js +11 -0
  114. package/clinkx-workflows/dist/types.js.map +1 -0
  115. package/clinkx-workflows/dist/validators/council.d.ts +1488 -0
  116. package/clinkx-workflows/dist/validators/council.js +509 -0
  117. package/clinkx-workflows/dist/validators/council.js.map +1 -0
  118. package/clinkx-workflows/dist/validators/index.d.ts +40 -0
  119. package/clinkx-workflows/dist/validators/index.js +43 -0
  120. package/clinkx-workflows/dist/validators/index.js.map +1 -0
  121. package/clinkx-workflows/dist/workflow-receipt.d.ts +4 -0
  122. package/clinkx-workflows/dist/workflow-receipt.js +177 -0
  123. package/clinkx-workflows/dist/workflow-receipt.js.map +1 -0
  124. package/clinkx-workflows/dist/workflow-tools.d.ts +77 -0
  125. package/clinkx-workflows/dist/workflow-tools.js +1131 -0
  126. package/clinkx-workflows/dist/workflow-tools.js.map +1 -0
  127. package/clinkx-workflows/dist/workflows/council-default.d.ts +123 -0
  128. package/clinkx-workflows/dist/workflows/council-default.js +141 -0
  129. package/clinkx-workflows/dist/workflows/council-default.js.map +1 -0
  130. package/clinkx-workflows/dist/workflows/index.d.ts +12 -0
  131. package/clinkx-workflows/dist/workflows/index.js +15 -0
  132. package/clinkx-workflows/dist/workflows/index.js.map +1 -0
  133. package/conf/adapters/codex.json +2 -2
  134. package/conf/adapters/hapi/codex.json +2 -2
  135. package/dist/config.d.ts +5 -0
  136. package/dist/config.js +17 -0
  137. package/dist/config.js.map +1 -1
  138. package/dist/parsers/extract.d.ts +2 -0
  139. package/dist/parsers/extract.js +29 -20
  140. package/dist/parsers/extract.js.map +1 -1
  141. package/dist/pipeline.d.ts +2 -4
  142. package/dist/pipeline.js +93 -8
  143. package/dist/pipeline.js.map +1 -1
  144. package/dist/result-contract.d.ts +6 -1
  145. package/dist/result-contract.js +10 -22
  146. package/dist/result-contract.js.map +1 -1
  147. package/dist/runner.js +43 -1
  148. package/dist/runner.js.map +1 -1
  149. package/package.json +12 -5
@@ -0,0 +1,19 @@
1
+ import type { NormalizedStage, NormalizedWorkflowDefinition } from "./definition-normalizer.js";
2
+ import type { ExecutedCall } from "./engine.js";
3
+ import type { CallStateEntry, StageStateEntry } from "./state-schema.js";
4
+ export interface DerivedStagePresentation {
5
+ readonly state: "ok" | "partial" | "failed" | "cancelled";
6
+ readonly wallDurationMs: number;
7
+ readonly retryEvents: number;
8
+ readonly retriedCalls: number;
9
+ readonly completedCalls: number;
10
+ readonly totalCalls: number;
11
+ }
12
+ export interface DecisiveFailure {
13
+ readonly location: string;
14
+ readonly failureClass: string;
15
+ readonly message: string;
16
+ }
17
+ export declare function deriveWallDurationMs(calls: readonly CallStateEntry[], resumeCompletedCalls?: ReadonlyMap<string, ExecutedCall> | undefined): number;
18
+ export declare function deriveStagePresentation(calls: readonly CallStateEntry[], stageDefinition: NormalizedStage, resumeCompletedCalls?: ReadonlyMap<string, ExecutedCall> | undefined): DerivedStagePresentation;
19
+ export declare function deriveDecisiveFailure(stages: readonly StageStateEntry[], definition?: NormalizedWorkflowDefinition | undefined): DecisiveFailure | undefined;
@@ -0,0 +1,100 @@
1
+ export function deriveWallDurationMs(calls, resumeCompletedCalls) {
2
+ let minStartedAtMs;
3
+ let maxCompletedAtMs;
4
+ for (const call of calls) {
5
+ const callKey = `${call.stageId}.${call.callId}`;
6
+ if (resumeCompletedCalls?.has(callKey) === true) {
7
+ continue;
8
+ }
9
+ if (call.startedAt == null || call.completedAt == null) {
10
+ continue;
11
+ }
12
+ const startedAtMs = Date.parse(call.startedAt);
13
+ const completedAtMs = Date.parse(call.completedAt);
14
+ if (!Number.isFinite(startedAtMs) || !Number.isFinite(completedAtMs)) {
15
+ continue;
16
+ }
17
+ minStartedAtMs = minStartedAtMs == null ? startedAtMs : Math.min(minStartedAtMs, startedAtMs);
18
+ maxCompletedAtMs = maxCompletedAtMs == null ? completedAtMs : Math.max(maxCompletedAtMs, completedAtMs);
19
+ }
20
+ if (minStartedAtMs == null || maxCompletedAtMs == null) {
21
+ return 0;
22
+ }
23
+ return Math.max(0, maxCompletedAtMs - minStartedAtMs);
24
+ }
25
+ export function deriveStagePresentation(calls, stageDefinition, resumeCompletedCalls) {
26
+ const completedCalls = calls.filter((call) => call.state === "succeeded" || call.state === "failed" || call.state === "cancelled").length;
27
+ const retryEvents = calls.reduce((sum, call) => sum + call.retryCount, 0);
28
+ const retriedCalls = calls.filter((call) => call.retryCount > 0).length;
29
+ return {
30
+ state: deriveStagePresentationState(calls, stageDefinition),
31
+ wallDurationMs: deriveWallDurationMs(calls, resumeCompletedCalls),
32
+ retryEvents,
33
+ retriedCalls,
34
+ completedCalls,
35
+ totalCalls: stageDefinition.calls.length,
36
+ };
37
+ }
38
+ function isEarlierCompletion(a, b) {
39
+ if (a.completedAt == null)
40
+ return false;
41
+ if (b.completedAt == null)
42
+ return true;
43
+ return Date.parse(a.completedAt) < Date.parse(b.completedAt);
44
+ }
45
+ export function deriveDecisiveFailure(stages, definition) {
46
+ const abortStageIds = new Set();
47
+ if (definition != null) {
48
+ for (const stage of definition.stages) {
49
+ if (stage.on_failure === "abort") {
50
+ abortStageIds.add(stage.id);
51
+ }
52
+ }
53
+ }
54
+ let decisiveCall;
55
+ let decisiveStageId;
56
+ let decisiveFromAbort = false;
57
+ for (const stage of stages) {
58
+ const isAbortStage = abortStageIds.has(stage.stageId);
59
+ for (const call of stage.calls) {
60
+ if (call.state !== "failed") {
61
+ continue;
62
+ }
63
+ if (isAbortStage) {
64
+ if (!decisiveFromAbort || isEarlierCompletion(call, decisiveCall)) {
65
+ decisiveCall = call;
66
+ decisiveStageId = stage.stageId;
67
+ decisiveFromAbort = true;
68
+ }
69
+ }
70
+ else if (!decisiveFromAbort && decisiveCall == null) {
71
+ decisiveCall = call;
72
+ decisiveStageId = stage.stageId;
73
+ }
74
+ }
75
+ }
76
+ if (decisiveCall == null || decisiveStageId == null) {
77
+ return undefined;
78
+ }
79
+ return {
80
+ location: `${decisiveStageId}.${decisiveCall.callId}`,
81
+ failureClass: decisiveCall.failureClass ?? "unknown",
82
+ message: decisiveCall.errorMessage ?? "Call failed",
83
+ };
84
+ }
85
+ function deriveStagePresentationState(calls, stageDefinition) {
86
+ if (calls.every((call) => call.state === "pending")) {
87
+ return "cancelled";
88
+ }
89
+ if (calls.some((call) => call.state === "cancelled")) {
90
+ return "cancelled";
91
+ }
92
+ if (calls.every((call) => call.state === "succeeded")) {
93
+ return "ok";
94
+ }
95
+ if (calls.some((call) => call.state === "failed")) {
96
+ return stageDefinition.on_failure === "continue" ? "partial" : "failed";
97
+ }
98
+ return "cancelled";
99
+ }
100
+ //# sourceMappingURL=run-summary-derived.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-summary-derived.js","sourceRoot":"","sources":["../src/run-summary-derived.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,oBAAoB,CAClC,KAAgC,EAChC,oBAAoE;IAEpE,IAAI,cAAkC,CAAC;IACvC,IAAI,gBAAoC,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACjD,IAAI,oBAAoB,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YAChD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;YACvD,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACrE,SAAS;QACX,CAAC;QAED,cAAc,GAAG,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAC9F,gBAAgB,GAAG,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAC1G,CAAC;IAED,IAAI,cAAc,IAAI,IAAI,IAAI,gBAAgB,IAAI,IAAI,EAAE,CAAC;QACvD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,GAAG,cAAc,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAgC,EAChC,eAAgC,EAChC,oBAAoE;IAEpE,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3C,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,CACpF,CAAC,MAAM,CAAC;IACT,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC1E,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAExE,OAAO;QACL,KAAK,EAAE,4BAA4B,CAAC,KAAK,EAAE,eAAe,CAAC;QAC3D,cAAc,EAAE,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,CAAC;QACjE,WAAW;QACX,YAAY;QACZ,cAAc;QACd,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,CAAiB,EAAE,CAAiB;IAC/D,IAAI,CAAC,CAAC,WAAW,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,CAAC,CAAC,WAAW,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAkC,EAClC,UAAqD;IAErD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;gBACjC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,YAAwC,CAAC;IAC7C,IAAI,eAAmC,CAAC;IACxC,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,SAAS;YACX,CAAC;YACD,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC,iBAAiB,IAAI,mBAAmB,CAAC,IAAI,EAAE,YAAa,CAAC,EAAE,CAAC;oBACnE,YAAY,GAAG,IAAI,CAAC;oBACpB,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC;oBAChC,iBAAiB,GAAG,IAAI,CAAC;gBAC3B,CAAC;YACH,CAAC;iBAAM,IAAI,CAAC,iBAAiB,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;gBACtD,YAAY,GAAG,IAAI,CAAC;gBACpB,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,YAAY,IAAI,IAAI,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;QACpD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,GAAG,eAAe,IAAI,YAAY,CAAC,MAAM,EAAE;QACrD,YAAY,EAAE,YAAY,CAAC,YAAY,IAAI,SAAS;QACpD,OAAO,EAAE,YAAY,CAAC,YAAY,IAAI,aAAa;KACpD,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CACnC,KAAgC,EAChC,eAAgC;IAEhC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE,CAAC;QACpD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,EAAE,CAAC;QACrD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;QAClD,OAAO,eAAe,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC1E,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}
@@ -0,0 +1,70 @@
1
+ import type { NormalizedWorkflowDefinition } from "./definition-normalizer.js";
2
+ import type { WorkflowExecutionResult, ExecutedCall } from "./engine.js";
3
+ import type { WorkflowStateStore } from "./state.js";
4
+ export interface RunSummaryV1 {
5
+ runId: string;
6
+ workflow: {
7
+ name: string;
8
+ version: string;
9
+ };
10
+ status: "completed" | "failed" | "cancelled";
11
+ resumable: boolean;
12
+ attemptStartedAt: string;
13
+ attemptCompletedAt: string;
14
+ stages: RunSummaryStageV1[];
15
+ card: RunSummaryCardV1;
16
+ failure?: RunSummaryFailureV1;
17
+ }
18
+ export interface RunSummaryStageV1 {
19
+ id: string;
20
+ label: string;
21
+ state: "ok" | "partial" | "failed" | "cancelled";
22
+ completedCalls: number;
23
+ totalCalls: number;
24
+ retryEvents: number;
25
+ retriedCalls: number;
26
+ wallDurationMs: number;
27
+ }
28
+ export interface RunSummaryFailureV1 {
29
+ location: string;
30
+ failureClass: string;
31
+ message: string;
32
+ }
33
+ export type RunSummaryCardV1 = {
34
+ kind: "council-default";
35
+ confidence?: number;
36
+ selectedApproach?: string;
37
+ agreements: number;
38
+ disagreements: number;
39
+ topConsensus?: string;
40
+ } | {
41
+ kind: "council-code-review";
42
+ status: "approved" | "revise" | "reject";
43
+ confidence?: number;
44
+ blockingCount: number;
45
+ nonBlockingCount: number;
46
+ testsCount: number;
47
+ topBlockingIssues: string[];
48
+ } | {
49
+ kind: "council-debug";
50
+ confidence?: number;
51
+ topHypotheses: string[];
52
+ riskLevel?: "low" | "medium" | "high";
53
+ } | {
54
+ kind: "council-discover";
55
+ confidence?: number;
56
+ topFindings: string[];
57
+ openQuestionCount: number;
58
+ } | {
59
+ kind: "council-answer";
60
+ confidence?: number;
61
+ caveatCount: number;
62
+ topCaveats: string[];
63
+ } | {
64
+ kind: "generic";
65
+ };
66
+ export type RunSummaryCardExtractor = (calls: readonly ExecutedCall[], definition: NormalizedWorkflowDefinition) => RunSummaryCardV1;
67
+ export declare function deriveCardKind(definitionName: string): RunSummaryCardV1["kind"];
68
+ export declare function buildSuccessRunSummary(result: WorkflowExecutionResult, store: WorkflowStateStore, cardExtractor: RunSummaryCardExtractor): RunSummaryV1;
69
+ export declare function buildFailureRunSummary(store: WorkflowStateStore): RunSummaryV1;
70
+ export declare function buildRunSummaryOrUndefined(result: WorkflowExecutionResult | undefined, store: WorkflowStateStore, cardExtractor: RunSummaryCardExtractor): RunSummaryV1 | undefined;
@@ -0,0 +1,125 @@
1
+ import { logger } from "./logger.js";
2
+ import { deriveDecisiveFailure, deriveStagePresentation } from "./run-summary-derived.js";
3
+ export function deriveCardKind(definitionName) {
4
+ switch (definitionName) {
5
+ case "council-default":
6
+ return "council-default";
7
+ case "council-code-review":
8
+ return "council-code-review";
9
+ case "council-debug":
10
+ return "council-debug";
11
+ case "council-discover":
12
+ return "council-discover";
13
+ case "council-answer":
14
+ return "council-answer";
15
+ default:
16
+ return "generic";
17
+ }
18
+ }
19
+ export function buildSuccessRunSummary(result, store, cardExtractor) {
20
+ const runState = store.runState;
21
+ const definition = store.definition;
22
+ return {
23
+ runId: runState.runId,
24
+ workflow: {
25
+ name: definition.name,
26
+ version: definition.version,
27
+ },
28
+ status: deriveRunSummaryStatus(runState.status),
29
+ resumable: runState.resumable,
30
+ attemptStartedAt: expectTimestamp(runState.startedAt, "run startedAt"),
31
+ attemptCompletedAt: expectTimestamp(runState.completedAt, "run completedAt"),
32
+ stages: buildStageSummaries(runState, definition, store),
33
+ card: cardExtractor(flattenExecutedCalls(result), definition),
34
+ };
35
+ }
36
+ export function buildFailureRunSummary(store) {
37
+ const runState = store.runState;
38
+ const definition = store.definition;
39
+ const decisiveFailure = deriveDecisiveFailure(runState.stages, definition);
40
+ const summary = {
41
+ runId: runState.runId,
42
+ workflow: {
43
+ name: definition.name,
44
+ version: definition.version,
45
+ },
46
+ status: deriveRunSummaryStatus(runState.status),
47
+ resumable: runState.resumable,
48
+ attemptStartedAt: expectTimestamp(runState.startedAt, "run startedAt"),
49
+ attemptCompletedAt: expectTimestamp(runState.completedAt, "run completedAt"),
50
+ stages: buildStageSummaries(runState, definition, store),
51
+ card: { kind: "generic" },
52
+ };
53
+ if (decisiveFailure != null) {
54
+ summary.failure = decisiveFailure;
55
+ }
56
+ return summary;
57
+ }
58
+ export function buildRunSummaryOrUndefined(result, store, cardExtractor) {
59
+ try {
60
+ return result != null
61
+ ? buildSuccessRunSummary(result, store, cardExtractor)
62
+ : buildFailureRunSummary(store);
63
+ }
64
+ catch (error) {
65
+ logger.warn({
66
+ run_id: safeRunId(store),
67
+ err: error instanceof Error ? error.message : String(error),
68
+ }, "failed to build workflow run summary");
69
+ return undefined;
70
+ }
71
+ }
72
+ function buildStageSummaries(runState, definition, store) {
73
+ return definition.stages.map((stage) => buildStageSummary(stage, runState.stages, store));
74
+ }
75
+ function buildStageSummary(stageDefinition, stageEntries, store) {
76
+ const stageState = stageEntries.find((entry) => entry.stageId === stageDefinition.id);
77
+ if (stageState == null) {
78
+ throw new Error(`Missing run state for stage "${stageDefinition.id}"`);
79
+ }
80
+ const presentation = deriveStagePresentation(stageState.calls, stageDefinition, store.resume.completedCalls);
81
+ return {
82
+ id: stageDefinition.id,
83
+ label: stageDefinition.description ?? humanizeStageId(stageDefinition.id),
84
+ state: presentation.state,
85
+ completedCalls: presentation.completedCalls,
86
+ totalCalls: presentation.totalCalls,
87
+ retryEvents: presentation.retryEvents,
88
+ retriedCalls: presentation.retriedCalls,
89
+ wallDurationMs: presentation.wallDurationMs,
90
+ };
91
+ }
92
+ function deriveRunSummaryStatus(status) {
93
+ switch (status) {
94
+ case "succeeded":
95
+ return "completed";
96
+ case "failed":
97
+ return "failed";
98
+ case "cancelled":
99
+ return "cancelled";
100
+ default:
101
+ throw new Error(`Cannot build a run summary from non-terminal status "${status}"`);
102
+ }
103
+ }
104
+ function expectTimestamp(value, label) {
105
+ if (value == null || value.length === 0) {
106
+ throw new Error(`Missing ${label}`);
107
+ }
108
+ return value;
109
+ }
110
+ function flattenExecutedCalls(result) {
111
+ return result.stages.flatMap((stage) => stage.calls);
112
+ }
113
+ function humanizeStageId(id) {
114
+ const spaced = id.replace(/_/g, " ");
115
+ return spaced.charAt(0).toUpperCase() + spaced.slice(1);
116
+ }
117
+ function safeRunId(store) {
118
+ try {
119
+ return store.runState.runId;
120
+ }
121
+ catch {
122
+ return undefined;
123
+ }
124
+ }
125
+ //# sourceMappingURL=run-summary.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-summary.js","sourceRoot":"","sources":["../src/run-summary.ts"],"names":[],"mappings":"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"}