@fragno-dev/pi-harness 0.0.0-stage → 0.0.3

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 (140) hide show
  1. package/LICENSE.md +16 -0
  2. package/README.md +181 -2
  3. package/dist/browser/agent-harness-event-protocol-CuKubox1.js +666 -0
  4. package/dist/browser/agent-harness-event-protocol-CuKubox1.js.map +1 -0
  5. package/dist/browser/agent-harness-event-protocol-d6mH_9n3.d.ts +261 -0
  6. package/dist/browser/agent-harness-event-protocol-d6mH_9n3.d.ts.map +1 -0
  7. package/dist/browser/client/clients.d.ts +2 -0
  8. package/dist/browser/client/clients.js +2 -0
  9. package/dist/browser/client/pi-workflow-emission-stream.d.ts +13 -0
  10. package/dist/browser/client/pi-workflow-emission-stream.d.ts.map +1 -0
  11. package/dist/browser/client/pi-workflow-emission-stream.js +29 -0
  12. package/dist/browser/client/pi-workflow-emission-stream.js.map +1 -0
  13. package/dist/browser/client/react.d.ts +147 -0
  14. package/dist/browser/client/react.d.ts.map +1 -0
  15. package/dist/browser/client/react.js +187 -0
  16. package/dist/browser/client/react.js.map +1 -0
  17. package/dist/browser/client/solid.d.ts +150 -0
  18. package/dist/browser/client/solid.d.ts.map +1 -0
  19. package/dist/browser/client/solid.js +130 -0
  20. package/dist/browser/client/solid.js.map +1 -0
  21. package/dist/browser/client/svelte.d.ts +150 -0
  22. package/dist/browser/client/svelte.d.ts.map +1 -0
  23. package/dist/browser/client/svelte.js +132 -0
  24. package/dist/browser/client/svelte.js.map +1 -0
  25. package/dist/browser/client/vanilla.d.ts +177 -0
  26. package/dist/browser/client/vanilla.d.ts.map +1 -0
  27. package/dist/browser/client/vanilla.js +159 -0
  28. package/dist/browser/client/vanilla.js.map +1 -0
  29. package/dist/browser/client/vue.d.ts +150 -0
  30. package/dist/browser/client/vue.d.ts.map +1 -0
  31. package/dist/browser/client/vue.js +128 -0
  32. package/dist/browser/client/vue.js.map +1 -0
  33. package/dist/browser/client/workflow-lofi-session-projection.d.ts +17 -0
  34. package/dist/browser/client/workflow-lofi-session-projection.d.ts.map +1 -0
  35. package/dist/browser/client/workflow-lofi-session-projection.js +107 -0
  36. package/dist/browser/client/workflow-lofi-session-projection.js.map +1 -0
  37. package/dist/browser/clients-DYXj19je.d.ts +247 -0
  38. package/dist/browser/clients-DYXj19je.d.ts.map +1 -0
  39. package/dist/browser/clients-pIAk6ClP.js +1853 -0
  40. package/dist/browser/clients-pIAk6ClP.js.map +1 -0
  41. package/dist/browser/pi/context-usage.d.ts +20 -0
  42. package/dist/browser/pi/context-usage.d.ts.map +1 -0
  43. package/dist/browser/pi/context-usage.js +84 -0
  44. package/dist/browser/pi/context-usage.js.map +1 -0
  45. package/dist/browser/pi/harness/agent-harness-event-protocol.d.ts +2 -0
  46. package/dist/browser/pi/harness/agent-harness-event-protocol.js +2 -0
  47. package/dist/browser/pi/route-schemas.d.ts +2 -0
  48. package/dist/browser/pi/route-schemas.js +130 -0
  49. package/dist/browser/pi/route-schemas.js.map +1 -0
  50. package/dist/browser/pi/workflow-session-projection.d.ts +2 -0
  51. package/dist/browser/pi/workflow-session-projection.js +2 -0
  52. package/dist/browser/route-schemas-DQB5ZR1E.d.ts +109 -0
  53. package/dist/browser/route-schemas-DQB5ZR1E.d.ts.map +1 -0
  54. package/dist/browser/types-8q4RWFXT.js +23 -0
  55. package/dist/browser/types-8q4RWFXT.js.map +1 -0
  56. package/dist/browser/types-Dk856kV1.d.ts +527 -0
  57. package/dist/browser/types-Dk856kV1.d.ts.map +1 -0
  58. package/dist/browser/workflow-session-projection-CJ4MUkpJ.js +443 -0
  59. package/dist/browser/workflow-session-projection-CJ4MUkpJ.js.map +1 -0
  60. package/dist/browser/workflow-session-projection-Dj_a79GF.d.ts +93 -0
  61. package/dist/browser/workflow-session-projection-Dj_a79GF.d.ts.map +1 -0
  62. package/dist/node/pi/compact-command-outcome-projection.js +41 -0
  63. package/dist/node/pi/compact-command-outcome-projection.js.map +1 -0
  64. package/dist/node/pi/context-usage.d.ts +20 -0
  65. package/dist/node/pi/context-usage.d.ts.map +1 -0
  66. package/dist/node/pi/context-usage.js +84 -0
  67. package/dist/node/pi/context-usage.js.map +1 -0
  68. package/dist/node/pi/definition.d.ts +535 -0
  69. package/dist/node/pi/definition.d.ts.map +1 -0
  70. package/dist/node/pi/definition.js +71 -0
  71. package/dist/node/pi/definition.js.map +1 -0
  72. package/dist/node/pi/factory.d.ts +142 -0
  73. package/dist/node/pi/factory.d.ts.map +1 -0
  74. package/dist/node/pi/factory.js +22 -0
  75. package/dist/node/pi/factory.js.map +1 -0
  76. package/dist/node/pi/harness/agent-harness-event-protocol.d.ts +261 -0
  77. package/dist/node/pi/harness/agent-harness-event-protocol.d.ts.map +1 -0
  78. package/dist/node/pi/harness/agent-harness-event-protocol.js +588 -0
  79. package/dist/node/pi/harness/agent-harness-event-protocol.js.map +1 -0
  80. package/dist/node/pi/harness/json-value.js +82 -0
  81. package/dist/node/pi/harness/json-value.js.map +1 -0
  82. package/dist/node/pi/harness/pi-operation-completed.d.ts +16 -0
  83. package/dist/node/pi/harness/pi-operation-completed.d.ts.map +1 -0
  84. package/dist/node/pi/harness/pi-operation-completed.js +71 -0
  85. package/dist/node/pi/harness/pi-operation-completed.js.map +1 -0
  86. package/dist/node/pi/harness/session-storage.d.ts +62 -0
  87. package/dist/node/pi/harness/session-storage.d.ts.map +1 -0
  88. package/dist/node/pi/harness/session-storage.js +174 -0
  89. package/dist/node/pi/harness/session-storage.js.map +1 -0
  90. package/dist/node/pi/pi-jsonl-export.d.ts +11 -0
  91. package/dist/node/pi/pi-jsonl-export.d.ts.map +1 -0
  92. package/dist/node/pi/pi-jsonl-export.js +31 -0
  93. package/dist/node/pi/pi-jsonl-export.js.map +1 -0
  94. package/dist/node/pi/route-schemas.d.ts +109 -0
  95. package/dist/node/pi/route-schemas.d.ts.map +1 -0
  96. package/dist/node/pi/route-schemas.js +130 -0
  97. package/dist/node/pi/route-schemas.js.map +1 -0
  98. package/dist/node/pi/session-command-protocol.d.ts +14 -0
  99. package/dist/node/pi/session-command-protocol.d.ts.map +1 -0
  100. package/dist/node/pi/session-command-protocol.js +25 -0
  101. package/dist/node/pi/session-command-protocol.js.map +1 -0
  102. package/dist/node/pi/session-entry-projection.js +79 -0
  103. package/dist/node/pi/session-entry-projection.js.map +1 -0
  104. package/dist/node/pi/skills.d.ts +70 -0
  105. package/dist/node/pi/skills.d.ts.map +1 -0
  106. package/dist/node/pi/skills.js +150 -0
  107. package/dist/node/pi/skills.js.map +1 -0
  108. package/dist/node/pi/tools.d.ts +12 -0
  109. package/dist/node/pi/tools.d.ts.map +1 -0
  110. package/dist/node/pi/tools.js +8 -0
  111. package/dist/node/pi/tools.js.map +1 -0
  112. package/dist/node/pi/types.d.ts +165 -0
  113. package/dist/node/pi/types.d.ts.map +1 -0
  114. package/dist/node/pi/types.js +49 -0
  115. package/dist/node/pi/types.js.map +1 -0
  116. package/dist/node/pi/wait-for-command-step.js +46 -0
  117. package/dist/node/pi/wait-for-command-step.js.map +1 -0
  118. package/dist/node/pi/workflow-session-live-projection.js +220 -0
  119. package/dist/node/pi/workflow-session-live-projection.js.map +1 -0
  120. package/dist/node/pi/workflow-session-projection.d.ts +84 -0
  121. package/dist/node/pi/workflow-session-projection.d.ts.map +1 -0
  122. package/dist/node/pi/workflow-session-projection.js +100 -0
  123. package/dist/node/pi/workflow-session-projection.js.map +1 -0
  124. package/dist/node/pi/workflows/interactive-chat-workflow.d.ts +37 -0
  125. package/dist/node/pi/workflows/interactive-chat-workflow.d.ts.map +1 -0
  126. package/dist/node/pi/workflows/interactive-chat-workflow.js +219 -0
  127. package/dist/node/pi/workflows/interactive-chat-workflow.js.map +1 -0
  128. package/dist/node/pi/workflows/workflow-agent-harness.d.ts +142 -0
  129. package/dist/node/pi/workflows/workflow-agent-harness.d.ts.map +1 -0
  130. package/dist/node/pi/workflows/workflow-agent-harness.js +450 -0
  131. package/dist/node/pi/workflows/workflow-agent-harness.js.map +1 -0
  132. package/dist/node/routes.d.ts +631 -0
  133. package/dist/node/routes.d.ts.map +1 -0
  134. package/dist/node/routes.js +355 -0
  135. package/dist/node/routes.js.map +1 -0
  136. package/dist/node/schema.d.ts +5 -0
  137. package/dist/node/schema.d.ts.map +1 -0
  138. package/dist/node/schema.js +7 -0
  139. package/dist/node/schema.js.map +1 -0
  140. package/package.json +175 -3
@@ -0,0 +1,535 @@
1
+ import { PiHarnessFrontendAgentMessage } from "./harness/agent-harness-event-protocol.js";
2
+ import { PiFragmentConfig, PiOperationCompletedHookPayload, PiSession } from "./types.js";
3
+ import { HookFn } from "@fragno-dev/db";
4
+ import { SessionTreeEntry } from "@earendil-works/pi-agent-core";
5
+ import { InstanceStatus } from "@fragno-dev/workflows/workflow";
6
+ //#region src/pi/definition.d.ts
7
+ type PiHarnessHooksMap = {
8
+ onOperationCompleted: HookFn<PiOperationCompletedHookPayload>;
9
+ };
10
+ type PiSessionDetailSnapshot = {
11
+ session: PiSession;
12
+ workflowStatus: InstanceStatus;
13
+ messages: PiHarnessFrontendAgentMessage[];
14
+ sessionEntries: readonly SessionTreeEntry[];
15
+ };
16
+ declare const piHarnessDefinition: import("@fragno-dev/core").FragmentDefinition<PiFragmentConfig, import("@fragno-dev/db").FragnoPublicConfigWithDatabase, import("@fragno-dev/db").ImplicitDatabaseDependencies<import("@fragno-dev/db/schema").Schema<{}>>, {
17
+ getSessionDetailSnapshot: (workflowName: string, sessionId: string) => import("@fragno-dev/db").TxResult<{
18
+ session: PiSession;
19
+ workflowStatus: InstanceStatus;
20
+ messages: PiHarnessFrontendAgentMessage[];
21
+ sessionEntries: SessionTreeEntry[];
22
+ }, []>;
23
+ createWorkflowSession: (values: {
24
+ id: string;
25
+ workflowName: string;
26
+ name?: string;
27
+ params?: Record<string, unknown>;
28
+ }) => import("@fragno-dev/db").TxResult<{
29
+ id: string;
30
+ details: InstanceStatus;
31
+ }[], []>;
32
+ }, {}, {
33
+ workflows: import("@fragno-dev/core").BoundServices<{
34
+ createInstance: (workflowName: string, options?: {
35
+ id?: string;
36
+ params?: unknown;
37
+ remoteWorkflowName?: string;
38
+ }) => import("@fragno-dev/db").TxResult<{
39
+ id: string;
40
+ details: InstanceStatus;
41
+ }, {
42
+ id: string;
43
+ details: InstanceStatus;
44
+ }>;
45
+ restartOrCreateInstance: (workflowName: string, options: import("@fragno-dev/workflows/workflow").WorkflowRestartOrCreateOptions) => import("@fragno-dev/db").TxResult<{
46
+ action: "created";
47
+ id: string;
48
+ details: InstanceStatus;
49
+ observedStatus?: undefined;
50
+ previousStatus?: undefined;
51
+ } | {
52
+ action: "unchanged";
53
+ observedStatus: "active" | "paused" | "errored" | "terminated" | "complete" | "waiting";
54
+ id: string;
55
+ details: InstanceStatus;
56
+ previousStatus?: undefined;
57
+ } | {
58
+ action: "restarted";
59
+ previousStatus: "active" | "paused" | "errored" | "terminated" | "complete" | "waiting";
60
+ id: string;
61
+ details: InstanceStatus;
62
+ observedStatus?: undefined;
63
+ }, [{
64
+ id: import("@fragno-dev/db/schema").FragnoId;
65
+ workflowName: string;
66
+ remoteWorkflowName: string | null;
67
+ instanceId: string;
68
+ status: string;
69
+ runGeneration: number;
70
+ createdAt: Date;
71
+ updatedAt: Date;
72
+ startedAt: Date | null;
73
+ completedAt: Date | null;
74
+ params: unknown;
75
+ output: unknown;
76
+ errorName: string | null;
77
+ errorMessage: string | null;
78
+ } | null, {
79
+ id: import("@fragno-dev/db/schema").FragnoId;
80
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
81
+ stepKey: string;
82
+ parentStepKey: string | null;
83
+ depth: number;
84
+ name: string;
85
+ type: string;
86
+ status: string;
87
+ committedByExecutionId: string;
88
+ attempts: number;
89
+ maxAttempts: number;
90
+ timeoutMs: number | null;
91
+ nextRetryAt: Date | null;
92
+ wakeAt: Date | null;
93
+ waitEventType: string | null;
94
+ result: unknown;
95
+ errorName: string | null;
96
+ errorMessage: string | null;
97
+ createdAt: Date;
98
+ updatedAt: Date;
99
+ }[], {
100
+ id: import("@fragno-dev/db/schema").FragnoId;
101
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
102
+ actor: string;
103
+ type: string;
104
+ payload: unknown;
105
+ createdAt: Date;
106
+ deliveredAt: Date | null;
107
+ consumedByStepKey: string | null;
108
+ }[], {
109
+ id: import("@fragno-dev/db/schema").FragnoId;
110
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
111
+ stepKey: string;
112
+ executionId: string;
113
+ epoch: string;
114
+ sequence: number;
115
+ actor: string;
116
+ payload: unknown;
117
+ createdAt: Date;
118
+ }[]]>;
119
+ createBatch: (workflowName: string, instances: {
120
+ id: string;
121
+ params?: unknown;
122
+ }[], options?: {
123
+ remoteWorkflowName?: string;
124
+ }) => import("@fragno-dev/db").TxResult<never[], []> | import("@fragno-dev/db").TxResult<{
125
+ id: string;
126
+ details: InstanceStatus;
127
+ }[], [{
128
+ id: import("@fragno-dev/db/schema").FragnoId;
129
+ workflowName: string;
130
+ remoteWorkflowName: string | null;
131
+ instanceId: string;
132
+ status: string;
133
+ runGeneration: number;
134
+ createdAt: Date;
135
+ updatedAt: Date;
136
+ startedAt: Date | null;
137
+ completedAt: Date | null;
138
+ params: unknown;
139
+ output: unknown;
140
+ errorName: string | null;
141
+ errorMessage: string | null;
142
+ }[]]>;
143
+ getInstanceStatus: (workflowName: string, instanceId: string) => import("@fragno-dev/db").TxResult<InstanceStatus, InstanceStatus>;
144
+ getInstanceMetadata: (workflowName: string, instanceId: string) => import("@fragno-dev/db").TxResult<import("@fragno-dev/workflows/workflow").WorkflowInstanceMetadata, import("@fragno-dev/workflows/workflow").WorkflowInstanceMetadata>;
145
+ getInstanceCurrentStep: (workflowName: string, instanceId: string) => import("@fragno-dev/db").TxResult<import("@fragno-dev/workflows/workflow").WorkflowInstanceCurrentStep | undefined, import("@fragno-dev/workflows/workflow").WorkflowInstanceCurrentStep | undefined>;
146
+ listInstances: ({ workflowName, remoteWorkflowName, status, pageSize, cursor, order }: {
147
+ workflowName: string;
148
+ remoteWorkflowName?: string;
149
+ status?: InstanceStatus["status"];
150
+ pageSize?: number;
151
+ cursor?: import("@fragno-dev/db").Cursor;
152
+ order?: "asc" | "desc";
153
+ }) => import("@fragno-dev/db").TxResult<{
154
+ instances: {
155
+ id: string;
156
+ details: InstanceStatus;
157
+ params: {};
158
+ createdAt: Date;
159
+ updatedAt: Date;
160
+ }[];
161
+ cursor: import("@fragno-dev/db").Cursor | undefined;
162
+ hasNextPage: boolean;
163
+ }, {
164
+ instances: {
165
+ id: string;
166
+ details: InstanceStatus;
167
+ params: {};
168
+ createdAt: Date;
169
+ updatedAt: Date;
170
+ }[];
171
+ cursor: import("@fragno-dev/db").Cursor | undefined;
172
+ hasNextPage: boolean;
173
+ }>;
174
+ getStepOutcome: (workflowName: string, instanceId: string, stepKey: string) => import("@fragno-dev/db").TxResult<{
175
+ status: "not-started" | "waiting";
176
+ } | {
177
+ status: "completed";
178
+ } | {
179
+ status: "errored";
180
+ error: {
181
+ name: string;
182
+ message: string;
183
+ };
184
+ } | {
185
+ status: "instance-terminal";
186
+ instanceStatus: string;
187
+ }, {
188
+ status: "not-started" | "waiting";
189
+ } | {
190
+ status: "completed";
191
+ } | {
192
+ status: "errored";
193
+ error: {
194
+ name: string;
195
+ message: string;
196
+ };
197
+ } | {
198
+ status: "instance-terminal";
199
+ instanceStatus: string;
200
+ }>;
201
+ listHistory: ({ workflowName, instanceId }: {
202
+ workflowName: string;
203
+ instanceId: string;
204
+ }) => import("@fragno-dev/db").TxResult<{
205
+ steps: import("@fragno-dev/workflows").WorkflowsHistoryStep[];
206
+ events: import("@fragno-dev/workflows").WorkflowsHistoryEvent[];
207
+ emissions: import("@fragno-dev/workflows").WorkflowsHistoryEmission[];
208
+ }, [{
209
+ id: import("@fragno-dev/db/schema").FragnoId;
210
+ workflowName: string;
211
+ remoteWorkflowName: string | null;
212
+ instanceId: string;
213
+ status: string;
214
+ runGeneration: number;
215
+ createdAt: Date;
216
+ updatedAt: Date;
217
+ startedAt: Date | null;
218
+ completedAt: Date | null;
219
+ params: unknown;
220
+ output: unknown;
221
+ errorName: string | null;
222
+ errorMessage: string | null;
223
+ } | null, {
224
+ id: import("@fragno-dev/db/schema").FragnoId;
225
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
226
+ stepKey: string;
227
+ parentStepKey: string | null;
228
+ depth: number;
229
+ name: string;
230
+ type: string;
231
+ status: string;
232
+ committedByExecutionId: string;
233
+ attempts: number;
234
+ maxAttempts: number;
235
+ timeoutMs: number | null;
236
+ nextRetryAt: Date | null;
237
+ wakeAt: Date | null;
238
+ waitEventType: string | null;
239
+ result: unknown;
240
+ errorName: string | null;
241
+ errorMessage: string | null;
242
+ createdAt: Date;
243
+ updatedAt: Date;
244
+ }[], {
245
+ id: import("@fragno-dev/db/schema").FragnoId;
246
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
247
+ actor: string;
248
+ type: string;
249
+ payload: unknown;
250
+ createdAt: Date;
251
+ deliveredAt: Date | null;
252
+ consumedByStepKey: string | null;
253
+ }[], {
254
+ id: import("@fragno-dev/db/schema").FragnoId;
255
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
256
+ stepKey: string;
257
+ executionId: string;
258
+ epoch: string;
259
+ sequence: number;
260
+ actor: string;
261
+ payload: unknown;
262
+ createdAt: Date;
263
+ }[]]>;
264
+ pauseInstance: (workflowName: string, instanceId: string) => import("@fragno-dev/db").TxResult<{
265
+ status: "active" | "paused" | "errored" | "terminated" | "complete" | "waiting";
266
+ runGeneration: number;
267
+ error?: {
268
+ name: string;
269
+ message: string;
270
+ } | undefined;
271
+ output?: unknown;
272
+ }, [{
273
+ id: import("@fragno-dev/db/schema").FragnoId;
274
+ workflowName: string;
275
+ remoteWorkflowName: string | null;
276
+ instanceId: string;
277
+ status: string;
278
+ runGeneration: number;
279
+ createdAt: Date;
280
+ updatedAt: Date;
281
+ startedAt: Date | null;
282
+ completedAt: Date | null;
283
+ params: unknown;
284
+ output: unknown;
285
+ errorName: string | null;
286
+ errorMessage: string | null;
287
+ } | null]>;
288
+ resumeInstance: (workflowName: string, instanceId: string) => import("@fragno-dev/db").TxResult<{
289
+ status: "active" | "paused" | "errored" | "terminated" | "complete" | "waiting";
290
+ runGeneration: number;
291
+ error?: {
292
+ name: string;
293
+ message: string;
294
+ } | undefined;
295
+ output?: unknown;
296
+ }, [{
297
+ id: import("@fragno-dev/db/schema").FragnoId;
298
+ workflowName: string;
299
+ remoteWorkflowName: string | null;
300
+ instanceId: string;
301
+ status: string;
302
+ runGeneration: number;
303
+ createdAt: Date;
304
+ updatedAt: Date;
305
+ startedAt: Date | null;
306
+ completedAt: Date | null;
307
+ params: unknown;
308
+ output: unknown;
309
+ errorName: string | null;
310
+ errorMessage: string | null;
311
+ } | null]>;
312
+ restartInstance: (workflowName: string, instanceId: string) => import("@fragno-dev/db").TxResult<{
313
+ status: "active" | "paused" | "errored" | "terminated" | "complete" | "waiting";
314
+ runGeneration: number;
315
+ error?: {
316
+ name: string;
317
+ message: string;
318
+ } | undefined;
319
+ output?: unknown;
320
+ }, [{
321
+ id: import("@fragno-dev/db/schema").FragnoId;
322
+ workflowName: string;
323
+ remoteWorkflowName: string | null;
324
+ instanceId: string;
325
+ status: string;
326
+ runGeneration: number;
327
+ createdAt: Date;
328
+ updatedAt: Date;
329
+ startedAt: Date | null;
330
+ completedAt: Date | null;
331
+ params: unknown;
332
+ output: unknown;
333
+ errorName: string | null;
334
+ errorMessage: string | null;
335
+ } | null, {
336
+ id: import("@fragno-dev/db/schema").FragnoId;
337
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
338
+ stepKey: string;
339
+ parentStepKey: string | null;
340
+ depth: number;
341
+ name: string;
342
+ type: string;
343
+ status: string;
344
+ committedByExecutionId: string;
345
+ attempts: number;
346
+ maxAttempts: number;
347
+ timeoutMs: number | null;
348
+ nextRetryAt: Date | null;
349
+ wakeAt: Date | null;
350
+ waitEventType: string | null;
351
+ result: unknown;
352
+ errorName: string | null;
353
+ errorMessage: string | null;
354
+ createdAt: Date;
355
+ updatedAt: Date;
356
+ }[], {
357
+ id: import("@fragno-dev/db/schema").FragnoId;
358
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
359
+ actor: string;
360
+ type: string;
361
+ payload: unknown;
362
+ createdAt: Date;
363
+ deliveredAt: Date | null;
364
+ consumedByStepKey: string | null;
365
+ }[], {
366
+ id: import("@fragno-dev/db/schema").FragnoId;
367
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
368
+ stepKey: string;
369
+ executionId: string;
370
+ epoch: string;
371
+ sequence: number;
372
+ actor: string;
373
+ payload: unknown;
374
+ createdAt: Date;
375
+ }[]]>;
376
+ terminateInstance: (workflowName: string, instanceId: string) => import("@fragno-dev/db").TxResult<{
377
+ status: "active" | "paused" | "errored" | "terminated" | "complete" | "waiting";
378
+ runGeneration: number;
379
+ error?: {
380
+ name: string;
381
+ message: string;
382
+ } | undefined;
383
+ output?: unknown;
384
+ }, [{
385
+ id: import("@fragno-dev/db/schema").FragnoId;
386
+ workflowName: string;
387
+ remoteWorkflowName: string | null;
388
+ instanceId: string;
389
+ status: string;
390
+ runGeneration: number;
391
+ createdAt: Date;
392
+ updatedAt: Date;
393
+ startedAt: Date | null;
394
+ completedAt: Date | null;
395
+ params: unknown;
396
+ output: unknown;
397
+ errorName: string | null;
398
+ errorMessage: string | null;
399
+ } | null]>;
400
+ retryFailedStep: (workflowName: string, instanceId: string, options?: {
401
+ delayMs?: number;
402
+ }) => import("@fragno-dev/db").TxResult<{
403
+ accepted: true;
404
+ instance: {
405
+ id: string;
406
+ details: InstanceStatus;
407
+ };
408
+ retry: {
409
+ stepKey: string;
410
+ attempts: number;
411
+ maxAttempts: number;
412
+ scheduledAt: Date;
413
+ };
414
+ }, [{
415
+ id: import("@fragno-dev/db/schema").FragnoId;
416
+ workflowName: string;
417
+ remoteWorkflowName: string | null;
418
+ instanceId: string;
419
+ status: string;
420
+ runGeneration: number;
421
+ createdAt: Date;
422
+ updatedAt: Date;
423
+ startedAt: Date | null;
424
+ completedAt: Date | null;
425
+ params: unknown;
426
+ output: unknown;
427
+ errorName: string | null;
428
+ errorMessage: string | null;
429
+ } | null, {
430
+ id: import("@fragno-dev/db/schema").FragnoId;
431
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
432
+ stepKey: string;
433
+ parentStepKey: string | null;
434
+ depth: number;
435
+ name: string;
436
+ type: string;
437
+ status: string;
438
+ committedByExecutionId: string;
439
+ attempts: number;
440
+ maxAttempts: number;
441
+ timeoutMs: number | null;
442
+ nextRetryAt: Date | null;
443
+ wakeAt: Date | null;
444
+ waitEventType: string | null;
445
+ result: unknown;
446
+ errorName: string | null;
447
+ errorMessage: string | null;
448
+ createdAt: Date;
449
+ updatedAt: Date;
450
+ }[], {
451
+ id: import("@fragno-dev/db/schema").FragnoId;
452
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
453
+ actor: string;
454
+ type: string;
455
+ payload: unknown;
456
+ createdAt: Date;
457
+ deliveredAt: Date | null;
458
+ consumedByStepKey: string | null;
459
+ }[], {
460
+ id: import("@fragno-dev/db/schema").FragnoId;
461
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
462
+ stepKey: string;
463
+ executionId: string;
464
+ epoch: string;
465
+ sequence: number;
466
+ actor: string;
467
+ payload: unknown;
468
+ createdAt: Date;
469
+ }[]]>;
470
+ sendEvent: (workflowName: string, instanceId: string, options: {
471
+ id?: string;
472
+ type: string;
473
+ payload?: unknown;
474
+ expectedRemoteWorkflowName?: string;
475
+ createdAt?: Date;
476
+ ignoreTerminal?: boolean;
477
+ }) => import("@fragno-dev/db").TxResult<{
478
+ status: "active" | "paused" | "errored" | "terminated" | "complete" | "waiting";
479
+ runGeneration: number;
480
+ error?: {
481
+ name: string;
482
+ message: string;
483
+ } | undefined;
484
+ output?: unknown;
485
+ }, [{
486
+ id: import("@fragno-dev/db/schema").FragnoId;
487
+ workflowName: string;
488
+ remoteWorkflowName: string | null;
489
+ instanceId: string;
490
+ status: string;
491
+ runGeneration: number;
492
+ createdAt: Date;
493
+ updatedAt: Date;
494
+ startedAt: Date | null;
495
+ completedAt: Date | null;
496
+ params: unknown;
497
+ output: unknown;
498
+ errorName: string | null;
499
+ errorMessage: string | null;
500
+ } | null, {
501
+ id: import("@fragno-dev/db/schema").FragnoId;
502
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
503
+ actor: string;
504
+ type: string;
505
+ payload: unknown;
506
+ createdAt: Date;
507
+ deliveredAt: Date | null;
508
+ consumedByStepKey: string | null;
509
+ } | null, {
510
+ id: import("@fragno-dev/db/schema").FragnoId;
511
+ instanceRef: import("@fragno-dev/db/schema").FragnoReference;
512
+ stepKey: string;
513
+ parentStepKey: string | null;
514
+ depth: number;
515
+ name: string;
516
+ type: string;
517
+ status: string;
518
+ committedByExecutionId: string;
519
+ attempts: number;
520
+ maxAttempts: number;
521
+ timeoutMs: number | null;
522
+ nextRetryAt: Date | null;
523
+ wakeAt: Date | null;
524
+ waitEventType: string | null;
525
+ result: unknown;
526
+ errorName: string | null;
527
+ errorMessage: string | null;
528
+ createdAt: Date;
529
+ updatedAt: Date;
530
+ }[]]>;
531
+ }>;
532
+ }, {}, import("@fragno-dev/db").DatabaseServiceContext<PiHarnessHooksMap>, import("@fragno-dev/db").DatabaseRequestContext<PiHarnessHooksMap>, import("@fragno-dev/db/fragment-definition-builder").DatabaseRequestStorage, []>;
533
+ //#endregion
534
+ export { PiHarnessHooksMap, PiSessionDetailSnapshot, piHarnessDefinition };
535
+ //# sourceMappingURL=definition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"definition.d.ts","names":[],"sources":["../../../src/pi/definition.ts"],"mappings":";;;;;;KAwBY;EACV,sBAAsB,OAAO;;KAGnB;EACV,SAAS;EACT,gBAAgB;EAChB,UAAU;EACV,yBAAyB;;cAGd,gDAAmB,mBAAA,2CAAA,yDAAA,6DAAA;mDAU8B,+CAAmB;;;;;;;IA4DzE;IACA;IACA;IACA,SAAS;iCACV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAkBq4gC;;wCAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAu2R"}
@@ -0,0 +1,71 @@
1
+ import { piSchema } from "../schema.js";
2
+ import { PiSessionDataUnavailableError, projectPiSessionFromWorkflowInstance } from "./types.js";
3
+ import { latestCompletedPiHarnessEntries } from "./session-entry-projection.js";
4
+ import { projectPiWorkflowSession } from "./workflow-session-projection.js";
5
+ import { selectWorkflowStepCommittedEpochs } from "@fragno-dev/workflows/step-emission-control";
6
+ import { defineFragment } from "@fragno-dev/core";
7
+ import { serviceCalls, withDatabase } from "@fragno-dev/db";
8
+ //#region src/pi/definition.ts
9
+ const piHarnessDefinition = defineFragment("pi-harness").extend(withDatabase(piSchema)).usesService("workflows").provideHooks(({ defineHook, config }) => ({ onOperationCompleted: defineHook(async function(payload) {
10
+ await config.onOperationCompleted?.(payload, this);
11
+ }) })).providesBaseService(({ defineService, serviceDeps }) => defineService({
12
+ getSessionDetailSnapshot: function(workflowName, sessionId) {
13
+ return this.serviceTx(piSchema).withServiceCalls(() => serviceCalls(serviceDeps.workflows.getInstanceMetadata(workflowName, sessionId), serviceDeps.workflows.getInstanceStatus(workflowName, sessionId), serviceDeps.workflows.listHistory({
14
+ workflowName,
15
+ instanceId: sessionId
16
+ }))).transform(({ serviceResult }) => {
17
+ const [instanceMetadata, workflowStatus, history] = serviceResult;
18
+ const session = projectPiSessionFromWorkflowInstance({
19
+ id: sessionId,
20
+ workflowName,
21
+ params: instanceMetadata.params,
22
+ createdAt: instanceMetadata.createdAt,
23
+ updatedAt: instanceMetadata.updatedAt
24
+ });
25
+ if (!session) throw new PiSessionDataUnavailableError(workflowName, sessionId);
26
+ const workflowSteps = history.steps.map((step) => ({
27
+ stepKey: step.stepKey,
28
+ type: step.type,
29
+ status: step.status,
30
+ waitEventType: step.waitEventType,
31
+ result: step.result ?? null
32
+ }));
33
+ const selectedEpochs = selectWorkflowStepCommittedEpochs(history.emissions);
34
+ return {
35
+ session,
36
+ workflowStatus,
37
+ messages: projectPiWorkflowSession({
38
+ workflowName,
39
+ sessionId,
40
+ instance: workflowStatus,
41
+ workflowSteps,
42
+ workflowStepEmissions: history.emissions.filter((emission) => {
43
+ const selectedEpoch = selectedEpochs.get(emission.stepKey);
44
+ return !selectedEpoch || selectedEpoch === emission.epoch;
45
+ }).map((emission) => ({
46
+ stepKey: emission.stepKey,
47
+ executionId: emission.executionId,
48
+ epoch: emission.epoch,
49
+ sequence: emission.sequence,
50
+ payload: typeof emission.payload === "object" && emission.payload !== null ? emission.payload : null,
51
+ createdAt: emission.createdAt
52
+ }))
53
+ }).contextMessages,
54
+ sessionEntries: latestCompletedPiHarnessEntries(workflowSteps)
55
+ };
56
+ }).build();
57
+ },
58
+ createWorkflowSession: function(values) {
59
+ return this.serviceTx(piSchema).withServiceCalls(() => [serviceDeps.workflows.createInstance(values.workflowName, {
60
+ id: values.id,
61
+ params: {
62
+ ...values.params,
63
+ __piSession: { name: values.name ?? null }
64
+ }
65
+ })]).build();
66
+ }
67
+ })).build();
68
+ //#endregion
69
+ export { piHarnessDefinition };
70
+
71
+ //# sourceMappingURL=definition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"definition.js","names":[],"sources":["../../../src/pi/definition.ts"],"sourcesContent":["import { selectWorkflowStepCommittedEpochs } from \"@fragno-dev/workflows/step-emission-control\";\nimport type { InstanceStatus } from \"@fragno-dev/workflows/workflow\";\n\nimport { defineFragment } from \"@fragno-dev/core\";\nimport { serviceCalls, withDatabase, type HookFn } from \"@fragno-dev/db\";\nimport type { WorkflowsFragmentServices } from \"@fragno-dev/workflows\";\n\nimport type { SessionTreeEntry } from \"@earendil-works/pi-agent-core\";\n\nimport { piSchema } from \"../schema\";\nimport type { PiHarnessFrontendAgentMessage } from \"./harness/agent-harness-event-protocol\";\nimport { latestCompletedPiHarnessEntries } from \"./session-entry-projection\";\nimport {\n PiSessionDataUnavailableError,\n projectPiSessionFromWorkflowInstance,\n type PiFragmentConfig,\n type PiSession,\n type PiOperationCompletedHookPayload,\n} from \"./types\";\nimport {\n projectPiWorkflowSession,\n type PiWorkflowSessionProjectionStep,\n} from \"./workflow-session-projection\";\n\nexport type PiHarnessHooksMap = {\n onOperationCompleted: HookFn<PiOperationCompletedHookPayload>;\n};\n\nexport type PiSessionDetailSnapshot = {\n session: PiSession;\n workflowStatus: InstanceStatus;\n messages: PiHarnessFrontendAgentMessage[];\n sessionEntries: readonly SessionTreeEntry[];\n};\n\nexport const piHarnessDefinition = defineFragment<PiFragmentConfig>(\"pi-harness\")\n .extend(withDatabase(piSchema))\n .usesService<\"workflows\", WorkflowsFragmentServices>(\"workflows\")\n .provideHooks<PiHarnessHooksMap>(({ defineHook, config }) => ({\n onOperationCompleted: defineHook<PiOperationCompletedHookPayload>(async function (payload) {\n await config.onOperationCompleted?.(payload, this);\n }),\n }))\n .providesBaseService(({ defineService, serviceDeps }) =>\n defineService({\n getSessionDetailSnapshot: function (workflowName: string, sessionId: string) {\n return this.serviceTx(piSchema)\n .withServiceCalls(() =>\n serviceCalls(\n serviceDeps.workflows.getInstanceMetadata(workflowName, sessionId),\n serviceDeps.workflows.getInstanceStatus(workflowName, sessionId),\n serviceDeps.workflows.listHistory({ workflowName, instanceId: sessionId }),\n ),\n )\n .transform(({ serviceResult }) => {\n const [instanceMetadata, workflowStatus, history] = serviceResult;\n const session = projectPiSessionFromWorkflowInstance({\n id: sessionId,\n workflowName,\n params: instanceMetadata.params,\n createdAt: instanceMetadata.createdAt,\n updatedAt: instanceMetadata.updatedAt,\n });\n if (!session) {\n throw new PiSessionDataUnavailableError(workflowName, sessionId);\n }\n const workflowSteps: PiWorkflowSessionProjectionStep[] = history.steps.map((step) => ({\n stepKey: step.stepKey,\n type: step.type,\n status: step.status,\n waitEventType: step.waitEventType,\n result: step.result ?? null,\n }));\n const selectedEpochs = selectWorkflowStepCommittedEpochs(history.emissions);\n const selectedEmissions = history.emissions.filter((emission) => {\n const selectedEpoch = selectedEpochs.get(emission.stepKey);\n return !selectedEpoch || selectedEpoch === emission.epoch;\n });\n const projection = projectPiWorkflowSession({\n workflowName,\n sessionId,\n instance: workflowStatus,\n workflowSteps,\n workflowStepEmissions: selectedEmissions.map((emission) => ({\n stepKey: emission.stepKey,\n executionId: emission.executionId,\n epoch: emission.epoch,\n sequence: emission.sequence,\n payload:\n typeof emission.payload === \"object\" && emission.payload !== null\n ? (emission.payload as never)\n : null,\n createdAt: emission.createdAt,\n })),\n });\n return {\n session,\n workflowStatus,\n messages: projection.contextMessages,\n sessionEntries: latestCompletedPiHarnessEntries(workflowSteps),\n };\n })\n .build();\n },\n createWorkflowSession: function (values: {\n id: string;\n workflowName: string;\n name?: string;\n params?: Record<string, unknown>;\n }) {\n return this.serviceTx(piSchema)\n .withServiceCalls(() => [\n serviceDeps.workflows.createInstance(values.workflowName, {\n id: values.id,\n params: {\n ...values.params,\n __piSession: {\n name: values.name ?? null,\n },\n },\n }),\n ])\n .build();\n },\n }),\n )\n .build();\n"],"mappings":";;;;;;;;AAmCA,MAAa,sBAAsB,eAAiC,YAAY,CAAC,CAC9E,OAAO,aAAa,QAAQ,CAAC,CAAC,CAC9B,YAAoD,WAAW,CAAC,CAChE,cAAiC,EAAE,YAAY,cAAc,EAC5D,sBAAsB,WAA4C,eAAgB,SAAS;CACzF,MAAM,OAAO,uBAAuB,SAAS,IAAI;AACnD,CAAC,EACH,EAAE,CAAC,CACF,qBAAqB,EAAE,eAAe,kBACrC,cAAc;CACZ,0BAA0B,SAAU,cAAsB,WAAmB;EAC3E,OAAO,KAAK,UAAU,QAAQ,CAAC,CAC5B,uBACC,aACE,YAAY,UAAU,oBAAoB,cAAc,SAAS,GACjE,YAAY,UAAU,kBAAkB,cAAc,SAAS,GAC/D,YAAY,UAAU,YAAY;GAAE;GAAc,YAAY;EAAU,CAAC,CAC3E,CACF,CAAC,CACA,WAAW,EAAE,oBAAoB;GAChC,MAAM,CAAC,kBAAkB,gBAAgB,WAAW;GACpD,MAAM,UAAU,qCAAqC;IACnD,IAAI;IACJ;IACA,QAAQ,iBAAiB;IACzB,WAAW,iBAAiB;IAC5B,WAAW,iBAAiB;GAC9B,CAAC;GACD,IAAI,CAAC,SACH,MAAM,IAAI,8BAA8B,cAAc,SAAS;GAEjE,MAAM,gBAAmD,QAAQ,MAAM,KAAK,UAAU;IACpF,SAAS,KAAK;IACd,MAAM,KAAK;IACX,QAAQ,KAAK;IACb,eAAe,KAAK;IACpB,QAAQ,KAAK,UAAU;GACzB,EAAE;GACF,MAAM,iBAAiB,kCAAkC,QAAQ,SAAS;GAsB1E,OAAO;IACL;IACA;IACA,UApBiB,yBAAyB;KAC1C;KACA;KACA,UAAU;KACV;KACA,uBATwB,QAAQ,UAAU,QAAQ,aAAa;MAC/D,MAAM,gBAAgB,eAAe,IAAI,SAAS,OAAO;MACzD,OAAO,CAAC,iBAAiB,kBAAkB,SAAS;KACtD,CAMyC,CAAC,CAAC,KAAK,cAAc;MAC1D,SAAS,SAAS;MAClB,aAAa,SAAS;MACtB,OAAO,SAAS;MAChB,UAAU,SAAS;MACnB,SACE,OAAO,SAAS,YAAY,YAAY,SAAS,YAAY,OACxD,SAAS,UACV;MACN,WAAW,SAAS;KACtB,EAAE;IACJ,CAIqB,CAAC,CAAC;IACrB,gBAAgB,gCAAgC,aAAa;GAC/D;EACF,CAAC,CAAC,CACD,MAAM;CACX;CACA,uBAAuB,SAAU,QAK9B;EACD,OAAO,KAAK,UAAU,QAAQ,CAAC,CAC5B,uBAAuB,CACtB,YAAY,UAAU,eAAe,OAAO,cAAc;GACxD,IAAI,OAAO;GACX,QAAQ;IACN,GAAG,OAAO;IACV,aAAa,EACX,MAAM,OAAO,QAAQ,KACvB;GACF;EACF,CAAC,CACH,CAAC,CAAC,CACD,MAAM;CACX;AACF,CAAC,CACH,CAAC,CACA,MAAM"}