@contractspec/integration.workflow-devkit 0.1.3 → 0.1.5
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.
- package/dist/agent-adapter.js +1 -79
- package/dist/browser/agent-adapter.js +1 -79
- package/dist/browser/chat-routes.js +1 -100
- package/dist/browser/compiler.js +14 -141
- package/dist/browser/helpers.js +1 -80
- package/dist/browser/index.js +14 -443
- package/dist/browser/next.js +1 -8
- package/dist/browser/runtime.js +1 -180
- package/dist/chat-routes.js +1 -100
- package/dist/compiler.js +14 -141
- package/dist/helpers.js +1 -80
- package/dist/index.js +14 -443
- package/dist/next.js +1 -8
- package/dist/node/agent-adapter.js +1 -79
- package/dist/node/chat-routes.js +1 -100
- package/dist/node/compiler.js +14 -141
- package/dist/node/helpers.js +1 -80
- package/dist/node/index.js +14 -443
- package/dist/node/next.js +1 -8
- package/dist/node/runtime.js +1 -180
- package/dist/runtime.js +1 -180
- package/package.json +9 -9
package/dist/node/index.js
CHANGED
|
@@ -1,285 +1,7 @@
|
|
|
1
|
-
|
|
2
|
-
class InMemoryWorkflowDevkitCheckpointStore {
|
|
3
|
-
envelopes = new Map;
|
|
4
|
-
async delete(sessionId) {
|
|
5
|
-
this.envelopes.delete(sessionId);
|
|
6
|
-
}
|
|
7
|
-
async load(sessionId) {
|
|
8
|
-
return this.envelopes.get(sessionId) ?? null;
|
|
9
|
-
}
|
|
10
|
-
async save(envelope) {
|
|
11
|
-
this.envelopes.set(envelope.sessionId, envelope);
|
|
12
|
-
}
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
class InMemoryWorkflowDevkitSuspensionStore {
|
|
16
|
-
states = new Map;
|
|
17
|
-
async clear(sessionId) {
|
|
18
|
-
this.states.delete(sessionId);
|
|
19
|
-
}
|
|
20
|
-
async get(sessionId) {
|
|
21
|
-
return this.states.get(sessionId) ?? null;
|
|
22
|
-
}
|
|
23
|
-
async set(sessionId, state) {
|
|
24
|
-
this.states.set(sessionId, state);
|
|
25
|
-
}
|
|
26
|
-
}
|
|
27
|
-
function createWorkflowDevkitAgentRuntimeAdapterBundle(options = {}) {
|
|
28
|
-
const checkpointStore = options.checkpointStore ?? new InMemoryWorkflowDevkitCheckpointStore;
|
|
29
|
-
const suspensionStore = options.suspensionStore ?? new InMemoryWorkflowDevkitSuspensionStore;
|
|
30
|
-
const resolveSessionToken = options.resolveSessionToken ?? defaultWorkflowDevkitAgentToken;
|
|
31
|
-
return {
|
|
32
|
-
key: "workflow-devkit",
|
|
33
|
-
checkpoint: {
|
|
34
|
-
delete(sessionId) {
|
|
35
|
-
return checkpointStore.delete(sessionId);
|
|
36
|
-
},
|
|
37
|
-
load(sessionId) {
|
|
38
|
-
return checkpointStore.load(sessionId);
|
|
39
|
-
},
|
|
40
|
-
save(envelope) {
|
|
41
|
-
return checkpointStore.save(envelope);
|
|
42
|
-
}
|
|
43
|
-
},
|
|
44
|
-
suspendResume: {
|
|
45
|
-
async resume(params) {
|
|
46
|
-
await suspensionStore.set(params.sessionId, {
|
|
47
|
-
input: params.input,
|
|
48
|
-
metadata: params.metadata,
|
|
49
|
-
reason: "resumed",
|
|
50
|
-
resumedAt: new Date,
|
|
51
|
-
suspendedAt: new Date
|
|
52
|
-
});
|
|
53
|
-
if (options.workflowApi) {
|
|
54
|
-
await options.workflowApi.resumeHook(resolveSessionToken(params.sessionId), {
|
|
55
|
-
input: params.input,
|
|
56
|
-
metadata: params.metadata,
|
|
57
|
-
sessionId: params.sessionId
|
|
58
|
-
});
|
|
59
|
-
}
|
|
60
|
-
},
|
|
61
|
-
async suspend(params) {
|
|
62
|
-
await suspensionStore.set(params.sessionId, {
|
|
63
|
-
metadata: params.metadata,
|
|
64
|
-
reason: params.reason,
|
|
65
|
-
suspendedAt: new Date
|
|
66
|
-
});
|
|
67
|
-
}
|
|
68
|
-
}
|
|
69
|
-
};
|
|
70
|
-
}
|
|
71
|
-
function defaultWorkflowDevkitAgentToken(sessionId) {
|
|
72
|
-
return `agent-session:${sessionId}`;
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
// src/chat-routes.ts
|
|
76
|
-
import { createUIMessageStreamResponse } from "ai";
|
|
77
|
-
import { getRun, resumeHook, start } from "workflow/api";
|
|
78
|
-
var WORKFLOW_RUN_ID_HEADER = "x-workflow-run-id";
|
|
79
|
-
var WORKFLOW_STREAM_TAIL_INDEX_HEADER = "x-workflow-stream-tail-index";
|
|
80
|
-
function createWorkflowDevkitStartRoute(options) {
|
|
81
|
-
const workflowApi = options.workflowApi ?? { start };
|
|
82
|
-
return async (request) => {
|
|
83
|
-
const body = await request.json();
|
|
84
|
-
const args = await options.buildArgs(body, request);
|
|
85
|
-
const run = await workflowApi.start(options.workflow, args);
|
|
86
|
-
if (options.createResponse) {
|
|
87
|
-
return options.createResponse({ body, run });
|
|
88
|
-
}
|
|
89
|
-
if (!run.readable) {
|
|
90
|
-
return new Response(JSON.stringify({ runId: run.runId }), {
|
|
91
|
-
headers: {
|
|
92
|
-
"Content-Type": "application/json",
|
|
93
|
-
[WORKFLOW_RUN_ID_HEADER]: run.runId
|
|
94
|
-
}
|
|
95
|
-
});
|
|
96
|
-
}
|
|
97
|
-
return createUIMessageStreamResponse({
|
|
98
|
-
headers: {
|
|
99
|
-
[WORKFLOW_RUN_ID_HEADER]: run.runId
|
|
100
|
-
},
|
|
101
|
-
stream: run.readable
|
|
102
|
-
});
|
|
103
|
-
};
|
|
104
|
-
}
|
|
105
|
-
function createWorkflowDevkitFollowUpRoute(options) {
|
|
106
|
-
const workflowApi = options.workflowApi ?? { resumeHook };
|
|
107
|
-
return async (request, context) => {
|
|
108
|
-
const runId = context.params.runId ?? context.params.id;
|
|
109
|
-
if (!runId) {
|
|
110
|
-
return new Response(JSON.stringify({ error: "Missing run id" }), {
|
|
111
|
-
status: 400
|
|
112
|
-
});
|
|
113
|
-
}
|
|
114
|
-
const body = await request.json();
|
|
115
|
-
const token = options.resolveToken({ body, request, runId });
|
|
116
|
-
const payload = options.buildPayload ? await options.buildPayload(body, request) : body;
|
|
117
|
-
await workflowApi.resumeHook(token, payload);
|
|
118
|
-
return new Response(JSON.stringify({ ok: true }), {
|
|
119
|
-
headers: {
|
|
120
|
-
"Content-Type": "application/json",
|
|
121
|
-
[WORKFLOW_RUN_ID_HEADER]: runId
|
|
122
|
-
}
|
|
123
|
-
});
|
|
124
|
-
};
|
|
125
|
-
}
|
|
126
|
-
function createWorkflowDevkitStreamRoute(options = {}) {
|
|
127
|
-
const workflowApi = options.workflowApi ?? { getRun };
|
|
128
|
-
return async (request, context) => {
|
|
129
|
-
const runId = context.params.runId ?? context.params.id;
|
|
130
|
-
if (!runId) {
|
|
131
|
-
return new Response(JSON.stringify({ error: "Missing run id" }), {
|
|
132
|
-
status: 400
|
|
133
|
-
});
|
|
134
|
-
}
|
|
135
|
-
const run = workflowApi.getRun(runId);
|
|
136
|
-
if (!run) {
|
|
137
|
-
return new Response(JSON.stringify({ error: "Workflow run not found" }), {
|
|
138
|
-
status: 404
|
|
139
|
-
});
|
|
140
|
-
}
|
|
141
|
-
const startIndex = readStartIndex(request.url);
|
|
142
|
-
const readable = run.getReadable ? run.getReadable({ startIndex }) : run.readable;
|
|
143
|
-
if (!readable) {
|
|
144
|
-
return new Response(JSON.stringify({ error: "Run has no readable stream" }), {
|
|
145
|
-
status: 404
|
|
146
|
-
});
|
|
147
|
-
}
|
|
148
|
-
const tailIndex = await readable.getTailIndex?.();
|
|
149
|
-
return createUIMessageStreamResponse({
|
|
150
|
-
headers: {
|
|
151
|
-
...tailIndex !== undefined ? {
|
|
152
|
-
[WORKFLOW_STREAM_TAIL_INDEX_HEADER]: String(tailIndex)
|
|
153
|
-
} : {}
|
|
154
|
-
},
|
|
155
|
-
stream: readable
|
|
156
|
-
});
|
|
157
|
-
};
|
|
158
|
-
}
|
|
159
|
-
function readStartIndex(url) {
|
|
160
|
-
const parsed = new URL(url);
|
|
161
|
-
const rawStartIndex = parsed.searchParams.get("startIndex");
|
|
162
|
-
if (!rawStartIndex) {
|
|
163
|
-
return;
|
|
164
|
-
}
|
|
165
|
-
const parsedStartIndex = Number(rawStartIndex);
|
|
166
|
-
return Number.isFinite(parsedStartIndex) ? parsedStartIndex : undefined;
|
|
167
|
-
}
|
|
1
|
+
class Y{envelopes=new Map;async delete(C){this.envelopes.delete(C)}async load(C){return this.envelopes.get(C)??null}async save(C){this.envelopes.set(C.sessionId,C)}}class Z{states=new Map;async clear(C){this.states.delete(C)}async get(C){return this.states.get(C)??null}async set(C,_){this.states.set(C,_)}}function F(C={}){let _=C.checkpointStore??new Y,H=C.suspensionStore??new Z,A=C.resolveSessionToken??M;return{key:"workflow-devkit",checkpoint:{delete(O){return _.delete(O)},load(O){return _.load(O)},save(O){return _.save(O)}},suspendResume:{async resume(O){if(await H.set(O.sessionId,{input:O.input,metadata:O.metadata,reason:"resumed",resumedAt:new Date,suspendedAt:new Date}),C.workflowApi)await C.workflowApi.resumeHook(A(O.sessionId),{input:O.input,metadata:O.metadata,sessionId:O.sessionId})},async suspend(O){await H.set(O.sessionId,{metadata:O.metadata,reason:O.reason,suspendedAt:new Date})}}}}function M(C){return`agent-session:${C}`}import{createUIMessageStreamResponse as P}from"ai";import{getRun as f,resumeHook as h,start as N}from"workflow/api";var Q="x-workflow-run-id",B="x-workflow-stream-tail-index";function g(C){let _=C.workflowApi??{start:N};return async(H)=>{let A=await H.json(),O=await C.buildArgs(A,H),K=await _.start(C.workflow,O);if(C.createResponse)return C.createResponse({body:A,run:K});if(!K.readable)return new Response(JSON.stringify({runId:K.runId}),{headers:{"Content-Type":"application/json",[Q]:K.runId}});return P({headers:{[Q]:K.runId},stream:K.readable})}}function S(C){let _=C.workflowApi??{resumeHook:h};return async(H,A)=>{let O=A.params.runId??A.params.id;if(!O)return new Response(JSON.stringify({error:"Missing run id"}),{status:400});let K=await H.json(),L=C.resolveToken({body:K,request:H,runId:O}),W=C.buildPayload?await C.buildPayload(K,H):K;return await _.resumeHook(L,W),new Response(JSON.stringify({ok:!0}),{headers:{"Content-Type":"application/json",[Q]:O}})}}function y(C={}){let _=C.workflowApi??{getRun:f};return async(H,A)=>{let O=A.params.runId??A.params.id;if(!O)return new Response(JSON.stringify({error:"Missing run id"}),{status:400});let K=_.getRun(O);if(!K)return new Response(JSON.stringify({error:"Workflow run not found"}),{status:404});let L=w(H.url),W=K.getReadable?K.getReadable({startIndex:L}):K.readable;if(!W)return new Response(JSON.stringify({error:"Run has no readable stream"}),{status:404});let j=await W.getTailIndex?.();return P({headers:{...j!==void 0?{[B]:String(j)}:{}},stream:W})}}function w(C){let H=new URL(C).searchParams.get("startIndex");if(!H)return;let A=Number(H);return Number.isFinite(A)?A:void 0}import{evaluateExpression as b}from"@contractspec/lib.contracts-spec/workflow/expression";function R(C){return C.runtime?.workflowDevkit?.behavior??C.type}function U(C){let _=C.definition.entryStepId??C.definition.steps[0]?.id;if(!_)throw Error(`Workflow ${C.meta.key}.v${C.meta.version} does not define an entry step.`);return _}function v(C,_){if(_)return _;let H=C.runtime?.workflowDevkit?.runIdentity?.strategy??"meta-key-version",A=C.runtime?.workflowDevkit?.runIdentity?.prefix,O=H==="meta-key-version"?`${C.meta.key}.v${C.meta.version}`:`${C.meta.key}.v${C.meta.version}`;return A?`${A}:${O}`:O}function V(C,_,H){let A=_.runtime?.workflowDevkit;if(!A)return;let O=A.hookWait?.token??A.webhookWait?.token??A.approvalWait?.token??A.streamSession?.followUpToken;if(O)return O;let K=C.runtime?.workflowDevkit?.hookTokens?.strategy??"deterministic",L=C.runtime?.workflowDevkit?.hookTokens?.prefix??C.meta.key,W=D(_.id);if(K==="session-scoped"){let j=D(v(C,H));return`${L}:${j}:${W}`}if(K==="step-scoped")return`${L}:v${C.meta.version}:${W}`;return`${L}:${W}`}function E(C,_,H,A,O){let K=C.definition.transitions.filter((L)=>L.from===_.id);for(let L of K)if(b(L.condition,{data:H,input:A,output:O}))return L.to;return null}function z(C,_,H){let A={...C};if(T(_))Object.assign(A,_);if(T(H))Object.assign(A,H);return A}function D(C){return C.replace(/[^a-zA-Z0-9_-]+/g,"-")}function T(C){return C!=null&&typeof C==="object"&&!Array.isArray(C)}function q(C){return{entryStepId:U(C),hostTarget:C.runtime?.workflowDevkit?.hostTarget??"generic",hookTokenStrategy:C.runtime?.workflowDevkit?.hookTokens?.strategy??"deterministic",integrationMode:C.runtime?.workflowDevkit?.integrationMode??"manual",runIdentityStrategy:C.runtime?.workflowDevkit?.runIdentity?.strategy??"meta-key-version",specKey:C.meta.key,specVersion:C.meta.version,steps:C.definition.steps.map((_)=>({behavior:R(_),id:_.id,label:_.label,operationRef:_.action?.operation?`${_.action.operation.key}.v${_.action.operation.version}`:void 0,runtime:_.runtime?.workflowDevkit,transitions:C.definition.transitions.filter((H)=>H.from===_.id).map((H)=>({condition:H.condition,to:H.to})),type:_.type,waitToken:V(C,_)}))}}function k(C,_){let H=q(C),A=_.workflowFunctionName??`${D(_.exportName)}WorkflowDevkit`;return{genericBootstrap:l(_.exportName,A),manifest:JSON.stringify(H,null,2),nextFollowUpRoute:m(A),nextStartRoute:I(A),nextStreamRoute:x(),workflowModule:d(_.exportName,_.specImportPath,A)}}function l(C,_){return`import { ${_} } from "./${D(C)}.workflow-devkit";
|
|
168
2
|
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
function inferWorkflowDevkitBehavior(step) {
|
|
172
|
-
return step.runtime?.workflowDevkit?.behavior ?? step.type;
|
|
173
|
-
}
|
|
174
|
-
function resolveWorkflowDevkitEntryStepId(spec) {
|
|
175
|
-
const entryStepId = spec.definition.entryStepId ?? spec.definition.steps[0]?.id;
|
|
176
|
-
if (!entryStepId) {
|
|
177
|
-
throw new Error(`Workflow ${spec.meta.key}.v${spec.meta.version} does not define an entry step.`);
|
|
178
|
-
}
|
|
179
|
-
return entryStepId;
|
|
180
|
-
}
|
|
181
|
-
function resolveWorkflowDevkitRunIdentity(spec, runIdentity) {
|
|
182
|
-
if (runIdentity) {
|
|
183
|
-
return runIdentity;
|
|
184
|
-
}
|
|
185
|
-
const strategy = spec.runtime?.workflowDevkit?.runIdentity?.strategy ?? "meta-key-version";
|
|
186
|
-
const prefix = spec.runtime?.workflowDevkit?.runIdentity?.prefix;
|
|
187
|
-
const baseIdentity = strategy === "meta-key-version" ? `${spec.meta.key}.v${spec.meta.version}` : `${spec.meta.key}.v${spec.meta.version}`;
|
|
188
|
-
return prefix ? `${prefix}:${baseIdentity}` : baseIdentity;
|
|
189
|
-
}
|
|
190
|
-
function resolveWorkflowDevkitWaitToken(spec, step, runIdentity) {
|
|
191
|
-
const runtime = step.runtime?.workflowDevkit;
|
|
192
|
-
if (!runtime) {
|
|
193
|
-
return;
|
|
194
|
-
}
|
|
195
|
-
const explicitToken = runtime.hookWait?.token ?? runtime.webhookWait?.token ?? runtime.approvalWait?.token ?? runtime.streamSession?.followUpToken;
|
|
196
|
-
if (explicitToken) {
|
|
197
|
-
return explicitToken;
|
|
198
|
-
}
|
|
199
|
-
const tokenStrategy = spec.runtime?.workflowDevkit?.hookTokens?.strategy ?? "deterministic";
|
|
200
|
-
const prefix = spec.runtime?.workflowDevkit?.hookTokens?.prefix ?? spec.meta.key;
|
|
201
|
-
const stableStepId = sanitizeIdentifier(step.id);
|
|
202
|
-
if (tokenStrategy === "session-scoped") {
|
|
203
|
-
const resolvedRunIdentity = sanitizeIdentifier(resolveWorkflowDevkitRunIdentity(spec, runIdentity));
|
|
204
|
-
return `${prefix}:${resolvedRunIdentity}:${stableStepId}`;
|
|
205
|
-
}
|
|
206
|
-
if (tokenStrategy === "step-scoped") {
|
|
207
|
-
return `${prefix}:v${spec.meta.version}:${stableStepId}`;
|
|
208
|
-
}
|
|
209
|
-
return `${prefix}:${stableStepId}`;
|
|
210
|
-
}
|
|
211
|
-
function resolveWorkflowDevkitNextStepId(spec, step, data, input, output) {
|
|
212
|
-
const transitions = spec.definition.transitions.filter((transition) => transition.from === step.id);
|
|
213
|
-
for (const transition of transitions) {
|
|
214
|
-
if (evaluateExpression(transition.condition, {
|
|
215
|
-
data,
|
|
216
|
-
input,
|
|
217
|
-
output
|
|
218
|
-
})) {
|
|
219
|
-
return transition.to;
|
|
220
|
-
}
|
|
221
|
-
}
|
|
222
|
-
return null;
|
|
223
|
-
}
|
|
224
|
-
function mergeWorkflowDevkitData(current, input, output) {
|
|
225
|
-
const next = { ...current };
|
|
226
|
-
if (isRecord(input)) {
|
|
227
|
-
Object.assign(next, input);
|
|
228
|
-
}
|
|
229
|
-
if (isRecord(output)) {
|
|
230
|
-
Object.assign(next, output);
|
|
231
|
-
}
|
|
232
|
-
return next;
|
|
233
|
-
}
|
|
234
|
-
function sanitizeIdentifier(value) {
|
|
235
|
-
return value.replace(/[^a-zA-Z0-9_-]+/g, "-");
|
|
236
|
-
}
|
|
237
|
-
function isRecord(value) {
|
|
238
|
-
return value != null && typeof value === "object" && !Array.isArray(value);
|
|
239
|
-
}
|
|
240
|
-
|
|
241
|
-
// src/compiler.ts
|
|
242
|
-
function compileWorkflowSpecToWorkflowDevkit(spec) {
|
|
243
|
-
return {
|
|
244
|
-
entryStepId: resolveWorkflowDevkitEntryStepId(spec),
|
|
245
|
-
hostTarget: spec.runtime?.workflowDevkit?.hostTarget ?? "generic",
|
|
246
|
-
hookTokenStrategy: spec.runtime?.workflowDevkit?.hookTokens?.strategy ?? "deterministic",
|
|
247
|
-
integrationMode: spec.runtime?.workflowDevkit?.integrationMode ?? "manual",
|
|
248
|
-
runIdentityStrategy: spec.runtime?.workflowDevkit?.runIdentity?.strategy ?? "meta-key-version",
|
|
249
|
-
specKey: spec.meta.key,
|
|
250
|
-
specVersion: spec.meta.version,
|
|
251
|
-
steps: spec.definition.steps.map((step) => ({
|
|
252
|
-
behavior: inferWorkflowDevkitBehavior(step),
|
|
253
|
-
id: step.id,
|
|
254
|
-
label: step.label,
|
|
255
|
-
operationRef: step.action?.operation ? `${step.action.operation.key}.v${step.action.operation.version}` : undefined,
|
|
256
|
-
runtime: step.runtime?.workflowDevkit,
|
|
257
|
-
transitions: spec.definition.transitions.filter((transition) => transition.from === step.id).map((transition) => ({
|
|
258
|
-
condition: transition.condition,
|
|
259
|
-
to: transition.to
|
|
260
|
-
})),
|
|
261
|
-
type: step.type,
|
|
262
|
-
waitToken: resolveWorkflowDevkitWaitToken(spec, step)
|
|
263
|
-
}))
|
|
264
|
-
};
|
|
265
|
-
}
|
|
266
|
-
function generateWorkflowDevkitArtifacts(spec, options) {
|
|
267
|
-
const compilation = compileWorkflowSpecToWorkflowDevkit(spec);
|
|
268
|
-
const workflowFunctionName = options.workflowFunctionName ?? `${sanitizeIdentifier(options.exportName)}WorkflowDevkit`;
|
|
269
|
-
return {
|
|
270
|
-
genericBootstrap: createGenericBootstrapTemplate(options.exportName, workflowFunctionName),
|
|
271
|
-
manifest: JSON.stringify(compilation, null, 2),
|
|
272
|
-
nextFollowUpRoute: createFollowUpRouteTemplate(workflowFunctionName),
|
|
273
|
-
nextStartRoute: createStartRouteTemplate(workflowFunctionName),
|
|
274
|
-
nextStreamRoute: createStreamRouteTemplate(),
|
|
275
|
-
workflowModule: createWorkflowModuleTemplate(options.exportName, options.specImportPath, workflowFunctionName)
|
|
276
|
-
};
|
|
277
|
-
}
|
|
278
|
-
function createGenericBootstrapTemplate(exportName, workflowFunctionName) {
|
|
279
|
-
return `import { ${workflowFunctionName} } from "./${sanitizeIdentifier(exportName)}.workflow-devkit";
|
|
280
|
-
|
|
281
|
-
export const ${sanitizeIdentifier(exportName)}WorkflowDevkitBootstrap = {
|
|
282
|
-
workflow: ${workflowFunctionName},
|
|
3
|
+
export const ${D(C)}WorkflowDevkitBootstrap = {
|
|
4
|
+
workflow: ${_},
|
|
283
5
|
createBridge() {
|
|
284
6
|
return {
|
|
285
7
|
executeAutomationStep: async () => {
|
|
@@ -288,49 +10,37 @@ export const ${sanitizeIdentifier(exportName)}WorkflowDevkitBootstrap = {
|
|
|
288
10
|
};
|
|
289
11
|
},
|
|
290
12
|
};
|
|
291
|
-
|
|
292
|
-
}
|
|
293
|
-
function createStartRouteTemplate(workflowFunctionName) {
|
|
294
|
-
return `import { createWorkflowDevkitStartRoute } from "@contractspec/integration.workflow-devkit";
|
|
295
|
-
import { ${workflowFunctionName} } from "./workflow";
|
|
13
|
+
`}function I(C){return`import { createWorkflowDevkitStartRoute } from "@contractspec/integration.workflow-devkit";
|
|
14
|
+
import { ${C} } from "./workflow";
|
|
296
15
|
|
|
297
16
|
export const POST = createWorkflowDevkitStartRoute({
|
|
298
|
-
workflow: ${
|
|
17
|
+
workflow: ${C},
|
|
299
18
|
async buildArgs(body) {
|
|
300
19
|
return [body];
|
|
301
20
|
},
|
|
302
21
|
});
|
|
303
|
-
|
|
304
|
-
}
|
|
305
|
-
function createFollowUpRouteTemplate(workflowFunctionName) {
|
|
306
|
-
return `import { createWorkflowDevkitFollowUpRoute } from "@contractspec/integration.workflow-devkit";
|
|
22
|
+
`}function m(C){return`import { createWorkflowDevkitFollowUpRoute } from "@contractspec/integration.workflow-devkit";
|
|
307
23
|
|
|
308
24
|
export const POST = createWorkflowDevkitFollowUpRoute({
|
|
309
25
|
resolveToken({ runId }) {
|
|
310
|
-
return \`${
|
|
26
|
+
return \`${C}:\${runId}\`;
|
|
311
27
|
},
|
|
312
28
|
});
|
|
313
|
-
|
|
314
|
-
}
|
|
315
|
-
function createStreamRouteTemplate() {
|
|
316
|
-
return `import { createWorkflowDevkitStreamRoute } from "@contractspec/integration.workflow-devkit";
|
|
29
|
+
`}function x(){return`import { createWorkflowDevkitStreamRoute } from "@contractspec/integration.workflow-devkit";
|
|
317
30
|
|
|
318
31
|
export const GET = createWorkflowDevkitStreamRoute();
|
|
319
|
-
|
|
320
|
-
}
|
|
321
|
-
function createWorkflowModuleTemplate(exportName, specImportPath, workflowFunctionName) {
|
|
322
|
-
return `import { createHook, createWebhook, sleep } from "workflow";
|
|
32
|
+
`}function d(C,_,H){return`import { createHook, createWebhook, sleep } from "workflow";
|
|
323
33
|
import { runWorkflowSpecWithWorkflowDevkit } from "@contractspec/integration.workflow-devkit";
|
|
324
|
-
import { ${
|
|
34
|
+
import { ${C} } from "${_}";
|
|
325
35
|
|
|
326
|
-
export async function ${
|
|
36
|
+
export async function ${H}(input = {}, bridge = {}) {
|
|
327
37
|
"use workflow";
|
|
328
38
|
|
|
329
39
|
// Keep the workflow function deterministic.
|
|
330
40
|
// Any Node.js or side-effectful logic should live in "use step" helpers that
|
|
331
41
|
// your bridge calls, not in this orchestrator itself.
|
|
332
42
|
return runWorkflowSpecWithWorkflowDevkit({
|
|
333
|
-
spec: ${
|
|
43
|
+
spec: ${C},
|
|
334
44
|
initialData: input,
|
|
335
45
|
bridge,
|
|
336
46
|
primitives: {
|
|
@@ -340,143 +50,4 @@ export async function ${workflowFunctionName}(input = {}, bridge = {}) {
|
|
|
340
50
|
},
|
|
341
51
|
});
|
|
342
52
|
}
|
|
343
|
-
|
|
344
|
-
}
|
|
345
|
-
|
|
346
|
-
// src/next.ts
|
|
347
|
-
import { withWorkflow } from "workflow/next";
|
|
348
|
-
function withContractSpecWorkflow(nextConfig) {
|
|
349
|
-
return withWorkflow(nextConfig);
|
|
350
|
-
}
|
|
351
|
-
|
|
352
|
-
// src/runtime.ts
|
|
353
|
-
async function runWorkflowSpecWithWorkflowDevkit(options) {
|
|
354
|
-
const history = [];
|
|
355
|
-
let currentStepId = resolveWorkflowDevkitEntryStepId(options.spec);
|
|
356
|
-
let data = { ...options.initialData ?? {} };
|
|
357
|
-
let input = options.initialData;
|
|
358
|
-
while (currentStepId) {
|
|
359
|
-
const step = lookupStep(options.spec, currentStepId);
|
|
360
|
-
const runtime = step.runtime?.workflowDevkit;
|
|
361
|
-
const context = {
|
|
362
|
-
data,
|
|
363
|
-
input,
|
|
364
|
-
runIdentity: options.runIdentity,
|
|
365
|
-
runtime,
|
|
366
|
-
spec: options.spec,
|
|
367
|
-
step
|
|
368
|
-
};
|
|
369
|
-
const behavior = inferWorkflowDevkitBehavior(step);
|
|
370
|
-
const token = resolveWorkflowDevkitWaitToken(options.spec, step, options.runIdentity);
|
|
371
|
-
const output = await executeWorkflowDevkitBehavior(behavior, context, token, options.bridge, options.primitives);
|
|
372
|
-
history.push({
|
|
373
|
-
behavior,
|
|
374
|
-
input,
|
|
375
|
-
output,
|
|
376
|
-
stepId: step.id,
|
|
377
|
-
token
|
|
378
|
-
});
|
|
379
|
-
data = mergeWorkflowDevkitData(data, input, output);
|
|
380
|
-
const nextStepId = resolveWorkflowDevkitNextStepId(options.spec, step, data, input, output);
|
|
381
|
-
if (!nextStepId) {
|
|
382
|
-
return {
|
|
383
|
-
currentStep: null,
|
|
384
|
-
data,
|
|
385
|
-
history,
|
|
386
|
-
status: "completed"
|
|
387
|
-
};
|
|
388
|
-
}
|
|
389
|
-
currentStepId = nextStepId;
|
|
390
|
-
input = output;
|
|
391
|
-
}
|
|
392
|
-
return {
|
|
393
|
-
currentStep: null,
|
|
394
|
-
data,
|
|
395
|
-
history,
|
|
396
|
-
status: "completed"
|
|
397
|
-
};
|
|
398
|
-
}
|
|
399
|
-
async function executeWorkflowDevkitBehavior(behavior, context, token, bridge, primitives) {
|
|
400
|
-
switch (behavior) {
|
|
401
|
-
case "sleep":
|
|
402
|
-
if (!context.runtime?.sleep?.duration) {
|
|
403
|
-
throw new Error(`Step "${context.step.id}" is missing sleep.duration.`);
|
|
404
|
-
}
|
|
405
|
-
await primitives.sleep(context.runtime.sleep.duration);
|
|
406
|
-
return { sleptFor: context.runtime.sleep.duration };
|
|
407
|
-
case "hookWait":
|
|
408
|
-
return awaitExternalWait(context, token, bridge?.onExternalWait, primitives.createHook);
|
|
409
|
-
case "webhookWait":
|
|
410
|
-
return awaitExternalWait(context, token, bridge?.onExternalWait, primitives.createWebhook ?? primitives.createHook, context.runtime?.webhookWait?.path, context.runtime?.webhookWait?.method);
|
|
411
|
-
case "approvalWait":
|
|
412
|
-
return awaitExternalWait(context, token, bridge?.onApprovalRequested, primitives.createHook);
|
|
413
|
-
case "streamSession":
|
|
414
|
-
return awaitExternalWait(context, token, bridge?.onStreamSession, primitives.createHook);
|
|
415
|
-
case "automation":
|
|
416
|
-
if (!bridge?.executeAutomationStep) {
|
|
417
|
-
throw new Error("Workflow DevKit bridge requires executeAutomationStep for automation steps.");
|
|
418
|
-
}
|
|
419
|
-
return bridge.executeAutomationStep(context);
|
|
420
|
-
case "human":
|
|
421
|
-
if (!bridge?.awaitHumanInput) {
|
|
422
|
-
throw new Error("Workflow DevKit bridge requires awaitHumanInput for human steps without explicit wait behavior.");
|
|
423
|
-
}
|
|
424
|
-
return bridge.awaitHumanInput(context);
|
|
425
|
-
case "decision":
|
|
426
|
-
return bridge?.executeDecisionStep ? bridge.executeDecisionStep(context) : context.input;
|
|
427
|
-
}
|
|
428
|
-
}
|
|
429
|
-
async function awaitExternalWait(context, token, notifier, factory, path, method) {
|
|
430
|
-
if (!token) {
|
|
431
|
-
throw new Error(`Step "${context.step.id}" requires a Workflow DevKit wait token.`);
|
|
432
|
-
}
|
|
433
|
-
const behavior = context.runtime?.behavior;
|
|
434
|
-
if (behavior !== "approvalWait" && behavior !== "hookWait" && behavior !== "streamSession" && behavior !== "webhookWait") {
|
|
435
|
-
throw new Error(`Step "${context.step.id}" is not configured with an external wait behavior.`);
|
|
436
|
-
}
|
|
437
|
-
const waitContext = {
|
|
438
|
-
...context,
|
|
439
|
-
behavior,
|
|
440
|
-
token
|
|
441
|
-
};
|
|
442
|
-
await notifier?.(waitContext);
|
|
443
|
-
const hook = factory({ method, path, token });
|
|
444
|
-
try {
|
|
445
|
-
return await hook;
|
|
446
|
-
} finally {
|
|
447
|
-
await hook.dispose?.();
|
|
448
|
-
}
|
|
449
|
-
}
|
|
450
|
-
function lookupStep(spec, stepId) {
|
|
451
|
-
const step = spec.definition.steps.find((candidate) => candidate.id === stepId);
|
|
452
|
-
if (!step) {
|
|
453
|
-
throw new Error(`Step "${stepId}" not found in workflow ${spec.meta.key}.v${spec.meta.version}.`);
|
|
454
|
-
}
|
|
455
|
-
return step;
|
|
456
|
-
}
|
|
457
|
-
|
|
458
|
-
// src/index.ts
|
|
459
|
-
import { WorkflowChatTransport } from "@workflow/ai";
|
|
460
|
-
export {
|
|
461
|
-
withContractSpecWorkflow,
|
|
462
|
-
sanitizeIdentifier,
|
|
463
|
-
runWorkflowSpecWithWorkflowDevkit,
|
|
464
|
-
resolveWorkflowDevkitWaitToken,
|
|
465
|
-
resolveWorkflowDevkitRunIdentity,
|
|
466
|
-
resolveWorkflowDevkitNextStepId,
|
|
467
|
-
resolveWorkflowDevkitEntryStepId,
|
|
468
|
-
mergeWorkflowDevkitData,
|
|
469
|
-
inferWorkflowDevkitBehavior,
|
|
470
|
-
generateWorkflowDevkitArtifacts,
|
|
471
|
-
defaultWorkflowDevkitAgentToken,
|
|
472
|
-
createWorkflowDevkitStreamRoute,
|
|
473
|
-
createWorkflowDevkitStartRoute,
|
|
474
|
-
createWorkflowDevkitFollowUpRoute,
|
|
475
|
-
createWorkflowDevkitAgentRuntimeAdapterBundle,
|
|
476
|
-
compileWorkflowSpecToWorkflowDevkit,
|
|
477
|
-
WorkflowChatTransport,
|
|
478
|
-
WORKFLOW_STREAM_TAIL_INDEX_HEADER,
|
|
479
|
-
WORKFLOW_RUN_ID_HEADER,
|
|
480
|
-
InMemoryWorkflowDevkitSuspensionStore,
|
|
481
|
-
InMemoryWorkflowDevkitCheckpointStore
|
|
482
|
-
};
|
|
53
|
+
`}import{withWorkflow as u}from"workflow/next";function c(C){return u(C)}async function a(C){let _=[],H=U(C.spec),A={...C.initialData??{}},O=C.initialData;while(H){let K=p(C.spec,H),L=K.runtime?.workflowDevkit,W={data:A,input:O,runIdentity:C.runIdentity,runtime:L,spec:C.spec,step:K},j=R(K),$=V(C.spec,K,C.runIdentity),J=await r(j,W,$,C.bridge,C.primitives);_.push({behavior:j,input:O,output:J,stepId:K.id,token:$}),A=z(A,O,J);let G=E(C.spec,K,A,O,J);if(!G)return{currentStep:null,data:A,history:_,status:"completed"};H=G,O=J}return{currentStep:null,data:A,history:_,status:"completed"}}async function r(C,_,H,A,O){switch(C){case"sleep":if(!_.runtime?.sleep?.duration)throw Error(`Step "${_.step.id}" is missing sleep.duration.`);return await O.sleep(_.runtime.sleep.duration),{sleptFor:_.runtime.sleep.duration};case"hookWait":return X(_,H,A?.onExternalWait,O.createHook);case"webhookWait":return X(_,H,A?.onExternalWait,O.createWebhook??O.createHook,_.runtime?.webhookWait?.path,_.runtime?.webhookWait?.method);case"approvalWait":return X(_,H,A?.onApprovalRequested,O.createHook);case"streamSession":return X(_,H,A?.onStreamSession,O.createHook);case"automation":if(!A?.executeAutomationStep)throw Error("Workflow DevKit bridge requires executeAutomationStep for automation steps.");return A.executeAutomationStep(_);case"human":if(!A?.awaitHumanInput)throw Error("Workflow DevKit bridge requires awaitHumanInput for human steps without explicit wait behavior.");return A.awaitHumanInput(_);case"decision":return A?.executeDecisionStep?A.executeDecisionStep(_):_.input}}async function X(C,_,H,A,O,K){if(!_)throw Error(`Step "${C.step.id}" requires a Workflow DevKit wait token.`);let L=C.runtime?.behavior;if(L!=="approvalWait"&&L!=="hookWait"&&L!=="streamSession"&&L!=="webhookWait")throw Error(`Step "${C.step.id}" is not configured with an external wait behavior.`);let W={...C,behavior:L,token:_};await H?.(W);let j=A({method:K,path:O,token:_});try{return await j}finally{await j.dispose?.()}}function p(C,_){let H=C.definition.steps.find((A)=>A.id===_);if(!H)throw Error(`Step "${_}" not found in workflow ${C.meta.key}.v${C.meta.version}.`);return H}import{WorkflowChatTransport as jC}from"@workflow/ai";export{c as withContractSpecWorkflow,D as sanitizeIdentifier,a as runWorkflowSpecWithWorkflowDevkit,V as resolveWorkflowDevkitWaitToken,v as resolveWorkflowDevkitRunIdentity,E as resolveWorkflowDevkitNextStepId,U as resolveWorkflowDevkitEntryStepId,z as mergeWorkflowDevkitData,R as inferWorkflowDevkitBehavior,k as generateWorkflowDevkitArtifacts,M as defaultWorkflowDevkitAgentToken,y as createWorkflowDevkitStreamRoute,g as createWorkflowDevkitStartRoute,S as createWorkflowDevkitFollowUpRoute,F as createWorkflowDevkitAgentRuntimeAdapterBundle,q as compileWorkflowSpecToWorkflowDevkit,jC as WorkflowChatTransport,B as WORKFLOW_STREAM_TAIL_INDEX_HEADER,Q as WORKFLOW_RUN_ID_HEADER,Z as InMemoryWorkflowDevkitSuspensionStore,Y as InMemoryWorkflowDevkitCheckpointStore};
|
package/dist/node/next.js
CHANGED
|
@@ -1,8 +1 @@
|
|
|
1
|
-
|
|
2
|
-
import { withWorkflow } from "workflow/next";
|
|
3
|
-
function withContractSpecWorkflow(nextConfig) {
|
|
4
|
-
return withWorkflow(nextConfig);
|
|
5
|
-
}
|
|
6
|
-
export {
|
|
7
|
-
withContractSpecWorkflow
|
|
8
|
-
};
|
|
1
|
+
import{withWorkflow as t}from"workflow/next";function e(o){return t(o)}export{e as withContractSpecWorkflow};
|