skill-rails 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +16 -0
- package/.claude-plugin/plugin.json +16 -0
- package/.mcp.json +8 -0
- package/LICENSE +21 -0
- package/README.md +255 -0
- package/bin/skill-rails.js +4 -0
- package/dist/api.d.ts +38 -0
- package/dist/api.js +73 -0
- package/dist/api.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +112 -0
- package/dist/cli.js.map +1 -0
- package/dist/engine.d.ts +18 -0
- package/dist/engine.js +312 -0
- package/dist/engine.js.map +1 -0
- package/dist/expressions.d.ts +12 -0
- package/dist/expressions.js +44 -0
- package/dist/expressions.js.map +1 -0
- package/dist/flow.d.ts +11 -0
- package/dist/flow.js +137 -0
- package/dist/flow.js.map +1 -0
- package/dist/mcp.d.ts +5 -0
- package/dist/mcp.js +37 -0
- package/dist/mcp.js.map +1 -0
- package/dist/run.d.ts +6 -0
- package/dist/run.js +67 -0
- package/dist/run.js.map +1 -0
- package/dist/schema.d.ts +10 -0
- package/dist/schema.js +15 -0
- package/dist/schema.js.map +1 -0
- package/dist/state.d.ts +6 -0
- package/dist/state.js +24 -0
- package/dist/state.js.map +1 -0
- package/dist/testing.d.ts +50 -0
- package/dist/testing.js +233 -0
- package/dist/testing.js.map +1 -0
- package/dist/types.d.ts +200 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/docs/format.md +256 -0
- package/docs/testing.md +100 -0
- package/examples/hello/flow.yaml +32 -0
- package/examples/hello/tests/hello.test.yaml +22 -0
- package/examples/open-pr/flow.yaml +87 -0
- package/examples/open-pr/prompts/text.md +26 -0
- package/examples/open-pr/scripts/body-file.sh +10 -0
- package/examples/open-pr/scripts/context.sh +21 -0
- package/examples/open-pr/scripts/create.sh +6 -0
- package/examples/open-pr/scripts/push.sh +8 -0
- package/examples/open-pr/tests/open-pr.test.yaml +42 -0
- package/examples/open-pr/tests/stubs/gh +9 -0
- package/package.json +72 -0
- package/schema/flow.schema.json +440 -0
- package/skills/create-skill-rails/SKILL.md +72 -0
- package/skills/create-skill-rails/template/SKILL.md +24 -0
- package/skills/migrate-to-skill-rails/SKILL.md +78 -0
- package/skills/run-skill-rails/SKILL.md +63 -0
package/dist/engine.js
ADDED
|
@@ -0,0 +1,312 @@
|
|
|
1
|
+
// The engine: runs the run, stop, foreach and uses steps, and stops at the next step for the agent.
|
|
2
|
+
// The state is a stack of frames: the root flow, then one frame per sub-flow and per foreach iteration.
|
|
3
|
+
import { condition, render, text } from './expressions.js';
|
|
4
|
+
import { kindOf } from './flow.js';
|
|
5
|
+
import { runCommand } from './run.js';
|
|
6
|
+
import { validateOutput } from './schema.js';
|
|
7
|
+
const TAIL_LINES = 20;
|
|
8
|
+
const POLL_INTERVAL_SECONDS = 30;
|
|
9
|
+
const POLL_TIMEOUT_MINUTES = 30;
|
|
10
|
+
const RUN_TIMEOUT_MINUTES = 10;
|
|
11
|
+
// A poll gives control back to the agent after this time, so that one done call stays under the tool timeout of the agent.
|
|
12
|
+
const waitSliceMs = () => Number(process.env.SKILL_RAILS_WAIT_SLICE_SECONDS ?? 540) * 1000;
|
|
13
|
+
const sleep = (ms) => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
|
|
14
|
+
export class InputError extends Error {
|
|
15
|
+
errors;
|
|
16
|
+
constructor(errors) {
|
|
17
|
+
super(errors.join('\n'));
|
|
18
|
+
this.errors = errors;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
export function resolveInputs(spec, given) {
|
|
22
|
+
const errors = [];
|
|
23
|
+
for (const key of Object.keys(given))
|
|
24
|
+
if (!Object.hasOwn(spec, key))
|
|
25
|
+
errors.push(`unknown input "${key}"`);
|
|
26
|
+
const values = {};
|
|
27
|
+
for (const [key, def] of Object.entries(spec)) {
|
|
28
|
+
const raw = given[key];
|
|
29
|
+
if (raw === undefined || raw === null) {
|
|
30
|
+
if (def.required)
|
|
31
|
+
errors.push(`input "${key}" is required`);
|
|
32
|
+
values[key] = def.default ?? null;
|
|
33
|
+
}
|
|
34
|
+
else if (def.type === 'boolean') {
|
|
35
|
+
if (![true, false, 'true', 'false'].includes(raw))
|
|
36
|
+
errors.push(`input "${key}" must be true or false`);
|
|
37
|
+
values[key] = raw === true || raw === 'true';
|
|
38
|
+
}
|
|
39
|
+
else if (def.type === 'number') {
|
|
40
|
+
if (!Number.isFinite(Number(raw)))
|
|
41
|
+
errors.push(`input "${key}" must be a number`);
|
|
42
|
+
values[key] = Number(raw);
|
|
43
|
+
}
|
|
44
|
+
else
|
|
45
|
+
values[key] = typeof raw === 'string' ? raw : text(raw);
|
|
46
|
+
}
|
|
47
|
+
if (errors.length)
|
|
48
|
+
throw new InputError(errors);
|
|
49
|
+
return values;
|
|
50
|
+
}
|
|
51
|
+
export function newState(flow, given = {}, cwd = process.cwd()) {
|
|
52
|
+
const root = { kind: 'root', name: flow.name, dir: flow.dir, steps: flow.steps, index: 0, inputs: resolveInputs(flow.inputs, given), results: {} };
|
|
53
|
+
return { flow, cwd, frames: [root], notes: [], status: 'running', pending: null, message: null };
|
|
54
|
+
}
|
|
55
|
+
const top = (state) => state.frames[state.frames.length - 1];
|
|
56
|
+
/** The frames of the current flow (root or sub-flow), outer first: a flow sees its own steps only. */
|
|
57
|
+
function currentFlowFrames(state) {
|
|
58
|
+
const frames = [];
|
|
59
|
+
for (let i = state.frames.length - 1; i >= 0; i--) {
|
|
60
|
+
const frame = state.frames[i];
|
|
61
|
+
frames.unshift(frame);
|
|
62
|
+
if (frame.kind !== 'foreach')
|
|
63
|
+
break;
|
|
64
|
+
}
|
|
65
|
+
return frames;
|
|
66
|
+
}
|
|
67
|
+
function contextOf(state) {
|
|
68
|
+
const frames = currentFlowFrames(state);
|
|
69
|
+
const flowFrame = frames[0];
|
|
70
|
+
const loop = [...frames].reverse().find((frame) => frame.kind === 'foreach');
|
|
71
|
+
return {
|
|
72
|
+
inputs: flowFrame.inputs,
|
|
73
|
+
steps: Object.assign({}, ...frames.map((frame) => frame.results)),
|
|
74
|
+
env: { ...process.env },
|
|
75
|
+
flow: { name: flowFrame.name, dir: flowFrame.dir },
|
|
76
|
+
item: loop?.items?.[loop.position ?? 0] ?? null,
|
|
77
|
+
loop: loop ? { index: loop.position ?? 0, count: loop.items?.length ?? 0 } : null,
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
export function finish(state, status, message) {
|
|
81
|
+
Object.assign(state, { status, message: message || null, pending: null });
|
|
82
|
+
}
|
|
83
|
+
/** Ends the current flow. A sub-flow becomes the result of its uses step; a failure goes up unless continue-on-error. */
|
|
84
|
+
function endFlow(state, status, message) {
|
|
85
|
+
for (;;) {
|
|
86
|
+
const frame = top(state);
|
|
87
|
+
if (frame.kind === 'root')
|
|
88
|
+
return finish(state, status, message);
|
|
89
|
+
state.frames.pop();
|
|
90
|
+
if (frame.kind !== 'flow')
|
|
91
|
+
continue;
|
|
92
|
+
const parent = top(state);
|
|
93
|
+
const uses = parent.steps[parent.index];
|
|
94
|
+
parent.results[frame.id] = { outcome: status === 'done' ? 'success' : 'failure', outputs: { status, message, steps: frame.results } };
|
|
95
|
+
if (status === 'failed' && !uses['continue-on-error']) {
|
|
96
|
+
message = `Step "${frame.id}" failed: ${message ?? 'the flow failed'}`;
|
|
97
|
+
continue;
|
|
98
|
+
}
|
|
99
|
+
parent.index += 1;
|
|
100
|
+
return;
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
/** The current frame has no more steps, or a break ends its loop. */
|
|
104
|
+
function endFrame(state, broken = false) {
|
|
105
|
+
const frame = top(state);
|
|
106
|
+
if (frame.kind === 'root' || frame.kind === 'flow')
|
|
107
|
+
return endFlow(state, 'done', null);
|
|
108
|
+
const items = frame.items ?? [];
|
|
109
|
+
const position = frame.position ?? 0;
|
|
110
|
+
frame.iterations = [...(frame.iterations ?? []), { item: items[position], steps: frame.results }];
|
|
111
|
+
if (!broken && position + 1 < items.length) {
|
|
112
|
+
Object.assign(frame, { position: position + 1, results: {}, index: 0 });
|
|
113
|
+
return;
|
|
114
|
+
}
|
|
115
|
+
state.frames.pop();
|
|
116
|
+
const parent = top(state);
|
|
117
|
+
parent.results[frame.id] = { outcome: 'success', outputs: { count: items.length, done: frame.iterations.length, broken, results: frame.iterations } };
|
|
118
|
+
parent.index += 1;
|
|
119
|
+
}
|
|
120
|
+
function askStep(step, context) {
|
|
121
|
+
const questions = step.ask
|
|
122
|
+
.filter((question) => condition(question.if, context))
|
|
123
|
+
.map(({ if: _, ...question }) => ({
|
|
124
|
+
...question,
|
|
125
|
+
question: text(render(question.question, context)),
|
|
126
|
+
multiSelect: Boolean(question.multiSelect),
|
|
127
|
+
free: Boolean(question.free),
|
|
128
|
+
options: render(question.options ?? [], context).flat(),
|
|
129
|
+
}));
|
|
130
|
+
if (!questions.length)
|
|
131
|
+
return null;
|
|
132
|
+
const properties = Object.fromEntries(questions.map((question) => {
|
|
133
|
+
if (question.free)
|
|
134
|
+
return [question.id, { type: 'string', minLength: 1 }];
|
|
135
|
+
const labels = { enum: question.options.map((option) => option.label) };
|
|
136
|
+
return [question.id, question.multiSelect ? { type: 'array', items: labels } : labels];
|
|
137
|
+
}));
|
|
138
|
+
return { id: step.id, type: 'ask', questions, output: { type: 'object', properties, required: Object.keys(properties) } };
|
|
139
|
+
}
|
|
140
|
+
function agentStep(step, kind, context) {
|
|
141
|
+
const skillStep = kind === 'skill' ? step : undefined;
|
|
142
|
+
return {
|
|
143
|
+
id: step.id,
|
|
144
|
+
type: kind,
|
|
145
|
+
skill: skillStep?.skill,
|
|
146
|
+
args: skillStep?.with === undefined ? undefined : text(render(skillStep.with, context)),
|
|
147
|
+
instructions: step.prompt === undefined ? undefined : text(render(step.prompt, context)),
|
|
148
|
+
output: step.output,
|
|
149
|
+
};
|
|
150
|
+
}
|
|
151
|
+
function failureMessage(id, exitCode, stderr) {
|
|
152
|
+
const tail = stderr.trim().split('\n').slice(-TAIL_LINES).join('\n');
|
|
153
|
+
return `Step "${id}" failed with exit code ${exitCode}.${tail ? `\n${tail}` : ''}`;
|
|
154
|
+
}
|
|
155
|
+
/** Runs a run step once, or polls it until its condition. Returns true when the step is over. */
|
|
156
|
+
function runStep(state, step, id, exec) {
|
|
157
|
+
const frame = top(state);
|
|
158
|
+
const once = () => {
|
|
159
|
+
const result = exec(step.run, {
|
|
160
|
+
env: render(step.env ?? {}, contextOf(state)),
|
|
161
|
+
dir: frame.dir,
|
|
162
|
+
cwd: state.cwd,
|
|
163
|
+
timeoutMs: (step.until === undefined ? (step['timeout-minutes'] ?? RUN_TIMEOUT_MINUTES) : RUN_TIMEOUT_MINUTES) * 60_000,
|
|
164
|
+
});
|
|
165
|
+
frame.results[id] = { outcome: result.outcome, exitCode: result.exitCode, outputs: result.outputs };
|
|
166
|
+
state.notes.push(...result.warnings);
|
|
167
|
+
return result;
|
|
168
|
+
};
|
|
169
|
+
const fail = (message) => {
|
|
170
|
+
frame.pollStarted = undefined;
|
|
171
|
+
if (step['continue-on-error'])
|
|
172
|
+
frame.index += 1;
|
|
173
|
+
else
|
|
174
|
+
endFlow(state, 'failed', message);
|
|
175
|
+
};
|
|
176
|
+
if (step.until === undefined) {
|
|
177
|
+
const result = once();
|
|
178
|
+
if (result.outcome === 'failure')
|
|
179
|
+
return fail(failureMessage(id, result.exitCode, result.stderr));
|
|
180
|
+
frame.index += 1;
|
|
181
|
+
return;
|
|
182
|
+
}
|
|
183
|
+
frame.pollStarted ??= Date.now();
|
|
184
|
+
const deadline = frame.pollStarted + (step['timeout-minutes'] ?? POLL_TIMEOUT_MINUTES) * 60_000;
|
|
185
|
+
const sliceEnd = Date.now() + waitSliceMs();
|
|
186
|
+
const interval = (step['interval-seconds'] ?? POLL_INTERVAL_SECONDS) * 1000;
|
|
187
|
+
for (;;) {
|
|
188
|
+
const result = once();
|
|
189
|
+
if (result.outcome === 'failure')
|
|
190
|
+
return fail(failureMessage(id, result.exitCode, result.stderr));
|
|
191
|
+
if (condition(step.until, contextOf(state))) {
|
|
192
|
+
frame.pollStarted = undefined;
|
|
193
|
+
frame.index += 1;
|
|
194
|
+
return;
|
|
195
|
+
}
|
|
196
|
+
if (Date.now() + interval > deadline) {
|
|
197
|
+
frame.results[id].outcome = 'failure';
|
|
198
|
+
return fail(`Step "${id}" timed out after ${step['timeout-minutes'] ?? POLL_TIMEOUT_MINUTES} minutes.`);
|
|
199
|
+
}
|
|
200
|
+
if (Date.now() + interval > sliceEnd) {
|
|
201
|
+
state.pending = {
|
|
202
|
+
id,
|
|
203
|
+
type: 'wait',
|
|
204
|
+
instructions: `Step "${id}" is still waiting (polls every ${interval / 1000} s). Report it as done, with no output, to keep waiting.`,
|
|
205
|
+
};
|
|
206
|
+
return;
|
|
207
|
+
}
|
|
208
|
+
sleep(interval);
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
/** Runs steps until the flow ends or a step waits for the agent. */
|
|
212
|
+
export function advance(state, { exec = runCommand } = {}) {
|
|
213
|
+
while (state.status === 'running' && !state.pending) {
|
|
214
|
+
const frame = top(state);
|
|
215
|
+
const step = frame.steps[frame.index];
|
|
216
|
+
if (!step) {
|
|
217
|
+
endFrame(state);
|
|
218
|
+
continue;
|
|
219
|
+
}
|
|
220
|
+
const id = step.id ?? `step-${frame.index}`;
|
|
221
|
+
const kind = kindOf(step);
|
|
222
|
+
const context = contextOf(state);
|
|
223
|
+
if (!condition(step.if, context)) {
|
|
224
|
+
frame.results[id] = { outcome: 'skipped' };
|
|
225
|
+
frame.index += 1;
|
|
226
|
+
continue;
|
|
227
|
+
}
|
|
228
|
+
switch (kind) {
|
|
229
|
+
case 'stop': {
|
|
230
|
+
const stop = step;
|
|
231
|
+
endFlow(state, stop.outcome === 'failure' ? 'failed' : 'done', text(render(stop.stop, context)));
|
|
232
|
+
break;
|
|
233
|
+
}
|
|
234
|
+
case 'run':
|
|
235
|
+
runStep(state, step, id, exec);
|
|
236
|
+
break;
|
|
237
|
+
case 'break':
|
|
238
|
+
frame.results[id] = { outcome: 'success' };
|
|
239
|
+
endFrame(state, true);
|
|
240
|
+
break;
|
|
241
|
+
case 'foreach': {
|
|
242
|
+
const foreach = step;
|
|
243
|
+
const items = typeof foreach.foreach === 'string' ? render(foreach.foreach, context) : foreach.foreach;
|
|
244
|
+
if (!Array.isArray(items)) {
|
|
245
|
+
endFlow(state, 'failed', `Step "${id}": foreach needs a list, and got ${JSON.stringify(items)}.`);
|
|
246
|
+
break;
|
|
247
|
+
}
|
|
248
|
+
if (!items.length) {
|
|
249
|
+
frame.results[id] = { outcome: 'success', outputs: { count: 0, done: 0, broken: false, results: [] } };
|
|
250
|
+
frame.index += 1;
|
|
251
|
+
break;
|
|
252
|
+
}
|
|
253
|
+
state.frames.push({ kind: 'foreach', id, name: frame.name, dir: frame.dir, steps: foreach.steps, index: 0, inputs: frame.inputs, results: {}, items, position: 0, iterations: [] });
|
|
254
|
+
break;
|
|
255
|
+
}
|
|
256
|
+
case 'uses': {
|
|
257
|
+
const uses = step;
|
|
258
|
+
const child = uses.flow;
|
|
259
|
+
let inputs;
|
|
260
|
+
try {
|
|
261
|
+
inputs = resolveInputs(child.inputs, render(uses.with ?? {}, context));
|
|
262
|
+
}
|
|
263
|
+
catch (error) {
|
|
264
|
+
endFlow(state, 'failed', `Step "${id}" (${uses.uses}): ${error.message}`);
|
|
265
|
+
break;
|
|
266
|
+
}
|
|
267
|
+
state.frames.push({ kind: 'flow', id, name: child.name, dir: child.dir, steps: child.steps, index: 0, inputs, results: {} });
|
|
268
|
+
break;
|
|
269
|
+
}
|
|
270
|
+
default: {
|
|
271
|
+
const pending = kind === 'ask' ? askStep(step, context) : agentStep(step, kind, context);
|
|
272
|
+
if (pending)
|
|
273
|
+
state.pending = pending;
|
|
274
|
+
else {
|
|
275
|
+
frame.results[id] = { outcome: 'skipped' };
|
|
276
|
+
frame.index += 1;
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
}
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
/** Records the output of the waiting step. Returns the errors; none when the flow can go on. */
|
|
283
|
+
export function submit(state, id, output = {}) {
|
|
284
|
+
if (!state.pending)
|
|
285
|
+
return [`no step waits for an output: the flow is ${state.status}`];
|
|
286
|
+
if (state.pending.id !== id)
|
|
287
|
+
return [`the current step is "${state.pending.id}", not "${id}"`];
|
|
288
|
+
if (state.pending.type === 'wait') {
|
|
289
|
+
// The poll goes on from where it stopped: the step keeps its place.
|
|
290
|
+
state.pending = null;
|
|
291
|
+
return [];
|
|
292
|
+
}
|
|
293
|
+
const errors = validateOutput(state.pending.output ?? { type: 'object' }, output);
|
|
294
|
+
if (errors.length)
|
|
295
|
+
return errors;
|
|
296
|
+
const frame = top(state);
|
|
297
|
+
frame.results[id] = { outcome: 'success', outputs: output };
|
|
298
|
+
state.pending = null;
|
|
299
|
+
frame.index += 1;
|
|
300
|
+
return [];
|
|
301
|
+
}
|
|
302
|
+
/** The step results of the root flow. */
|
|
303
|
+
export const rootResults = (state) => state.frames[0].results;
|
|
304
|
+
/** What the agent reads after each command. The notes are shown once. */
|
|
305
|
+
export function report(state) {
|
|
306
|
+
const notes = state.notes.splice(0);
|
|
307
|
+
const extra = notes.length ? { notes } : {};
|
|
308
|
+
if (state.pending)
|
|
309
|
+
return { status: 'step', flow: state.flow.name, ...state.pending, ...extra };
|
|
310
|
+
return { status: state.status, flow: state.flow.name, message: state.message, ...extra };
|
|
311
|
+
}
|
|
312
|
+
//# sourceMappingURL=engine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Condition, Context } from './types.js';
|
|
2
|
+
export declare const CONTEXTS: string[];
|
|
3
|
+
export declare const EXPRESSION: RegExp;
|
|
4
|
+
export declare const text: (value: unknown) => string;
|
|
5
|
+
export declare const parse: (source: string) => import("@actions/expressions").Expr;
|
|
6
|
+
export declare function evaluate(source: string, context: Context): unknown;
|
|
7
|
+
/** Replaces the ${{ }} expressions. A value that is one expression keeps the type of its result. */
|
|
8
|
+
export declare function render(value: unknown, context: Context): unknown;
|
|
9
|
+
/** An `if:` value: a ${{ }} string, a bare expression, or a boolean. */
|
|
10
|
+
export declare function condition(value: Condition | undefined, context: Context): boolean;
|
|
11
|
+
/** The expression sources in a value. A bare `if:` value is one expression. */
|
|
12
|
+
export declare function sourcesOf(value: unknown, key?: string): string[];
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
// ${{ }} expressions, evaluated by @actions/expressions, so they behave as in GitHub Actions.
|
|
2
|
+
import { Evaluator, Lexer, Parser, data } from '@actions/expressions';
|
|
3
|
+
export const CONTEXTS = ['inputs', 'steps', 'env', 'flow', 'item', 'loop'];
|
|
4
|
+
export const EXPRESSION = /\$\{\{([\s\S]*?)\}\}/g;
|
|
5
|
+
const WHOLE = /^\s*\$\{\{([\s\S]*?)\}\}\s*$/;
|
|
6
|
+
export const text = (value) => value == null ? '' : typeof value === 'object' ? JSON.stringify(value) : String(value);
|
|
7
|
+
export const parse = (source) => new Parser(new Lexer(source).lex().tokens, CONTEXTS, []).parse();
|
|
8
|
+
export function evaluate(source, context) {
|
|
9
|
+
const dictionary = JSON.parse(JSON.stringify(context), data.reviver);
|
|
10
|
+
const result = new Evaluator(parse(source), dictionary).evaluate();
|
|
11
|
+
return JSON.parse(JSON.stringify(result, data.replacer));
|
|
12
|
+
}
|
|
13
|
+
/** Replaces the ${{ }} expressions. A value that is one expression keeps the type of its result. */
|
|
14
|
+
export function render(value, context) {
|
|
15
|
+
if (typeof value === 'string') {
|
|
16
|
+
const whole = value.match(WHOLE);
|
|
17
|
+
if (whole?.[1] !== undefined && !whole[1].includes('${{'))
|
|
18
|
+
return evaluate(whole[1], context);
|
|
19
|
+
return value.replace(EXPRESSION, (_, source) => text(evaluate(source, context)));
|
|
20
|
+
}
|
|
21
|
+
if (Array.isArray(value))
|
|
22
|
+
return value.map((item) => render(item, context));
|
|
23
|
+
if (value && typeof value === 'object') {
|
|
24
|
+
return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, render(item, context)]));
|
|
25
|
+
}
|
|
26
|
+
return value;
|
|
27
|
+
}
|
|
28
|
+
/** An `if:` value: a ${{ }} string, a bare expression, or a boolean. */
|
|
29
|
+
export function condition(value, context) {
|
|
30
|
+
if (value === undefined)
|
|
31
|
+
return true;
|
|
32
|
+
if (typeof value === 'string' && !value.includes('${{'))
|
|
33
|
+
return Boolean(evaluate(value, context));
|
|
34
|
+
return Boolean(render(value, context));
|
|
35
|
+
}
|
|
36
|
+
/** The expression sources in a value. A bare `if:` value is one expression. */
|
|
37
|
+
export function sourcesOf(value, key) {
|
|
38
|
+
if (typeof value !== 'string')
|
|
39
|
+
return [];
|
|
40
|
+
if (key === 'if' && !value.includes('${{'))
|
|
41
|
+
return [value];
|
|
42
|
+
return [...value.matchAll(EXPRESSION)].map((match) => match[1] ?? '');
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=expressions.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"expressions.js","sourceRoot":"","sources":["../src/expressions.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGtE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAClD,MAAM,KAAK,GAAG,8BAA8B,CAAC;AAE7C,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAc,EAAU,EAAE,CAC7C,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAE1G,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,OAAgB;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAoB,CAAC;IACxF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,OAAgB;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9F,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,MAAc,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5E,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,SAAS,CAAC,KAA4B,EAAE,OAAgB;IACtE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAClG,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,GAAY;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzC,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC"}
|
package/dist/flow.d.ts
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { Flow, StepKind } from './types.js';
|
|
2
|
+
export declare class FlowError extends Error {
|
|
3
|
+
readonly errors: string[];
|
|
4
|
+
constructor(errors: string[]);
|
|
5
|
+
}
|
|
6
|
+
/** The type of a step, from its keys. A step with a prompt and no other type is a prompt step. */
|
|
7
|
+
export declare function kindOf(step: unknown): StepKind | null;
|
|
8
|
+
/** Checks a parsed flow. Returns the errors. */
|
|
9
|
+
export declare function validateFlow(flow: unknown): string[];
|
|
10
|
+
/** Reads, checks and prepares a flow file and its sub-flows. Throws a FlowError with all the problems. */
|
|
11
|
+
export declare function loadFlow(file: string): Flow;
|
package/dist/flow.js
ADDED
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
// Loads a flow file: YAML, schema check, prompt files, sub-flows, step ids and expressions.
|
|
2
|
+
import fs from 'node:fs';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import yaml from 'js-yaml';
|
|
5
|
+
import { ajv, formatErrors, schema } from './schema.js';
|
|
6
|
+
import { parse, sourcesOf } from './expressions.js';
|
|
7
|
+
const KEYED_KINDS = ['run', 'skill', 'ask', 'stop', 'foreach', 'uses', 'break'];
|
|
8
|
+
const ALL_KINDS = ['run', 'skill', 'prompt', 'ask', 'stop', 'foreach', 'uses', 'break'];
|
|
9
|
+
export class FlowError extends Error {
|
|
10
|
+
errors;
|
|
11
|
+
constructor(errors) {
|
|
12
|
+
super(errors.join('\n'));
|
|
13
|
+
this.errors = errors;
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
/** The type of a step, from its keys. A step with a prompt and no other type is a prompt step. */
|
|
17
|
+
export function kindOf(step) {
|
|
18
|
+
if (!step || typeof step !== 'object' || Array.isArray(step))
|
|
19
|
+
return null;
|
|
20
|
+
const kinds = KEYED_KINDS.filter((kind) => Object.hasOwn(step, kind));
|
|
21
|
+
if (kinds.length > 1)
|
|
22
|
+
return null;
|
|
23
|
+
if (kinds[0])
|
|
24
|
+
return kinds[0];
|
|
25
|
+
return Object.hasOwn(step, 'prompt') || Object.hasOwn(step, 'prompt-file') ? 'prompt' : null;
|
|
26
|
+
}
|
|
27
|
+
// The top level is checked with the steps as plain objects, then each step against the schema of its own type,
|
|
28
|
+
// so that an error names one type and not every branch of the oneOf.
|
|
29
|
+
const topLevel = ajv.compile({ ...schema, $id: undefined, properties: { ...schema.properties, steps: { type: 'array', minItems: 1 } } });
|
|
30
|
+
const stepSchemas = Object.fromEntries(ALL_KINDS.map((kind) => [kind, ajv.getSchema(`${schema.$id}#/definitions/${kind}Step`)]));
|
|
31
|
+
function validateSteps(steps, at, errors, ids, inLoop = false) {
|
|
32
|
+
steps.forEach((step, index) => {
|
|
33
|
+
const where = `${at}/${index}`;
|
|
34
|
+
const kind = kindOf(step);
|
|
35
|
+
if (!kind) {
|
|
36
|
+
errors.push(`${where} must have exactly one of run, skill, prompt (or prompt-file), ask, stop, foreach, uses, break`);
|
|
37
|
+
return;
|
|
38
|
+
}
|
|
39
|
+
if (kind === 'break' && !inLoop)
|
|
40
|
+
errors.push(`${where}: break is allowed only inside a foreach`);
|
|
41
|
+
const id = step.id;
|
|
42
|
+
if (typeof id === 'string')
|
|
43
|
+
ids.push(id);
|
|
44
|
+
// A foreach is checked with a placeholder body: its own steps are checked one by one below.
|
|
45
|
+
const shallow = kind === 'foreach' ? { ...step, steps: [{ stop: '' }] } : step;
|
|
46
|
+
const check = stepSchemas[kind];
|
|
47
|
+
if (!check(shallow))
|
|
48
|
+
errors.push(...formatErrors(where, check.errors).map((line) => `${line} (${kind} step)`));
|
|
49
|
+
const body = step.steps;
|
|
50
|
+
if (kind === 'foreach' && Array.isArray(body))
|
|
51
|
+
validateSteps(body, `${where}/steps`, errors, ids, true);
|
|
52
|
+
});
|
|
53
|
+
}
|
|
54
|
+
/** Checks a parsed flow. Returns the errors. */
|
|
55
|
+
export function validateFlow(flow) {
|
|
56
|
+
if (!topLevel(flow))
|
|
57
|
+
return formatErrors('', topLevel.errors);
|
|
58
|
+
const errors = [];
|
|
59
|
+
const ids = [];
|
|
60
|
+
validateSteps(flow.steps, '/steps', errors, ids);
|
|
61
|
+
for (const id of new Set(ids.filter((id, i) => ids.indexOf(id) !== i)))
|
|
62
|
+
errors.push(`step id "${id}" is used twice`);
|
|
63
|
+
return errors;
|
|
64
|
+
}
|
|
65
|
+
function checkExpressions(value, at, key, errors) {
|
|
66
|
+
for (const source of sourcesOf(value, key)) {
|
|
67
|
+
try {
|
|
68
|
+
parse(source);
|
|
69
|
+
}
|
|
70
|
+
catch (error) {
|
|
71
|
+
errors.push(`${at}: ${error.message} in "${source.trim()}"`);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
if (value && typeof value === 'object') {
|
|
75
|
+
for (const [childKey, child] of Object.entries(value)) {
|
|
76
|
+
// A run command holds no expression, and a loaded sub-flow was checked when it was loaded.
|
|
77
|
+
if (childKey !== 'run' && childKey !== 'flow')
|
|
78
|
+
checkExpressions(child, `${at}/${childKey}`, childKey, errors);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
/** Reads the prompt files and loads the sub-flows of a list of steps, recursively. */
|
|
83
|
+
function prepareSteps(steps, dir, errors, loading) {
|
|
84
|
+
for (const step of steps) {
|
|
85
|
+
const withPrompt = step;
|
|
86
|
+
const promptFile = withPrompt['prompt-file'];
|
|
87
|
+
if (promptFile) {
|
|
88
|
+
try {
|
|
89
|
+
withPrompt.prompt = fs.readFileSync(path.resolve(dir, promptFile), 'utf8');
|
|
90
|
+
}
|
|
91
|
+
catch (error) {
|
|
92
|
+
errors.push(`step "${step.id}": cannot read ${promptFile}: ${error.message}`);
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
const kind = kindOf(step);
|
|
96
|
+
if (kind === 'foreach')
|
|
97
|
+
prepareSteps(step.steps, dir, errors, loading);
|
|
98
|
+
if (kind === 'uses') {
|
|
99
|
+
const uses = step;
|
|
100
|
+
try {
|
|
101
|
+
uses.flow = loadFile(path.resolve(dir, uses.uses), loading);
|
|
102
|
+
}
|
|
103
|
+
catch (error) {
|
|
104
|
+
const inner = error.errors ?? [error.message];
|
|
105
|
+
errors.push(...inner.map((line) => `step "${uses.id}" (${uses.uses}): ${line}`));
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
function loadFile(file, loading) {
|
|
111
|
+
const resolved = path.resolve(file);
|
|
112
|
+
if (loading.includes(resolved)) {
|
|
113
|
+
throw new FlowError([`the flows use each other: ${[...loading, resolved].map((f) => path.basename(path.dirname(f)) + '/' + path.basename(f)).join(' → ')}`]);
|
|
114
|
+
}
|
|
115
|
+
let raw;
|
|
116
|
+
try {
|
|
117
|
+
raw = yaml.load(fs.readFileSync(resolved, 'utf8'));
|
|
118
|
+
}
|
|
119
|
+
catch (error) {
|
|
120
|
+
throw new FlowError([`cannot read ${file}: ${error.message}`]);
|
|
121
|
+
}
|
|
122
|
+
const errors = validateFlow(raw);
|
|
123
|
+
if (errors.length)
|
|
124
|
+
throw new FlowError(errors);
|
|
125
|
+
const flow = raw;
|
|
126
|
+
const dir = path.dirname(resolved);
|
|
127
|
+
prepareSteps(flow.steps, dir, errors, [...loading, resolved]);
|
|
128
|
+
checkExpressions(flow.steps, '/steps', undefined, errors);
|
|
129
|
+
if (errors.length)
|
|
130
|
+
throw new FlowError(errors);
|
|
131
|
+
return { ...flow, inputs: flow.inputs ?? {}, dir };
|
|
132
|
+
}
|
|
133
|
+
/** Reads, checks and prepares a flow file and its sub-flows. Throws a FlowError with all the problems. */
|
|
134
|
+
export function loadFlow(file) {
|
|
135
|
+
return loadFile(file, []);
|
|
136
|
+
}
|
|
137
|
+
//# sourceMappingURL=flow.js.map
|
package/dist/flow.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flow.js","sourceRoot":"","sources":["../src/flow.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AACzF,MAAM,SAAS,GAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpG,MAAM,OAAO,SAAU,SAAQ,KAAK;IACb;IAArB,YAAqB,MAAgB;QACnC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QADN,WAAM,GAAN,MAAM,CAAU;IAErC,CAAC;CACF;AAED,kGAAkG;AAClG,MAAM,UAAU,MAAM,CAAC,IAAa;IAClC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/F,CAAC;AAED,+GAA+G;AAC/G,qEAAqE;AACrE,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AACzI,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CACpC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,GAAG,iBAAiB,IAAI,MAAM,CAAqB,CAAC,CAAC,CACvE,CAAC;AAExC,SAAS,aAAa,CAAC,KAAgB,EAAE,EAAU,EAAE,MAAgB,EAAE,GAAa,EAAE,MAAM,GAAG,KAAK;IAClG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,GAAG,EAAE,IAAI,KAAK,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,gGAAgG,CAAC,CAAC;YACtH,OAAO;QACT,CAAC;QACD,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,0CAA0C,CAAC,CAAC;QACjG,MAAM,EAAE,GAAI,IAAyB,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,EAAE,KAAK,QAAQ;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,4FAA4F;QAC5F,MAAM,OAAO,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAI,IAAe,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3F,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC;QAC/G,MAAM,IAAI,GAAI,IAA4B,CAAC,KAAK,CAAC;QACjD,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,aAAa,CAAC,IAAI,EAAE,GAAG,KAAK,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1G,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,aAAa,CAAE,IAA6B,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3E,KAAK,MAAM,EAAE,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACrH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,EAAU,EAAE,GAAuB,EAAE,MAAgB;IAC7F,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,KAAK,CAAC,MAAM,CAAC,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAM,KAAe,CAAC,OAAO,QAAQ,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,2FAA2F;YAC3F,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM;gBAAE,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChH,CAAC;IACH,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,SAAS,YAAY,CAAC,KAAa,EAAE,GAAW,EAAE,MAAgB,EAAE,OAAiB;IACnF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAA0D,CAAC;QAC9E,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;QAC7C,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;YAC7E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,kBAAkB,UAAU,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,SAAS;YAAE,YAAY,CAAE,IAAoB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACxF,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,IAAgB,CAAC;YAC9B,IAAI,CAAC;gBACH,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC9D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,KAAK,GAAI,KAAmB,CAAC,MAAM,IAAI,CAAE,KAAe,CAAC,OAAO,CAAC,CAAC;gBACxE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,OAAiB;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CAAC,CAAC,6BAA6B,CAAC,GAAG,OAAO,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/J,CAAC;IACD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC,CAAC,eAAe,IAAI,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,GAAwB,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC9D,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC;AACrD,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC"}
|
package/dist/mcp.d.ts
ADDED
package/dist/mcp.js
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
// The MCP server: the same commands as the CLI, as tools. The working directory of the server is the project.
|
|
2
|
+
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
3
|
+
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
|
4
|
+
import { z } from 'zod';
|
|
5
|
+
import { check, done, reset, start, status } from './api.js';
|
|
6
|
+
const reply = (result) => ({
|
|
7
|
+
content: [{ type: 'text', text: JSON.stringify(result) }],
|
|
8
|
+
isError: result.status === 'error',
|
|
9
|
+
});
|
|
10
|
+
const LOOP = 'Act on the status of the result: step → do the step, then call flow_done; invalid → correct the output and call flow_done again; done or failed → tell the user the message.';
|
|
11
|
+
export function createServer({ cwd = process.cwd() } = {}) {
|
|
12
|
+
const server = new McpServer({ name: 'skill-rails', version: '0.2.0' });
|
|
13
|
+
server.registerTool('flow_start', {
|
|
14
|
+
description: `Start a skill-rails flow: check the flow file, reset its state, and get the first step to do. ${LOOP}`,
|
|
15
|
+
inputSchema: {
|
|
16
|
+
file: z.string().describe('Path of the flow YAML file.'),
|
|
17
|
+
inputs: z.record(z.string(), z.union([z.string(), z.boolean(), z.number()])).optional().describe('The flow inputs.'),
|
|
18
|
+
},
|
|
19
|
+
}, async ({ file, inputs }) => reply(start({ file, inputs, cwd })));
|
|
20
|
+
server.registerTool('flow_done', {
|
|
21
|
+
description: `Report the output of the current step of a flow, and get the next step. Give fail instead of output when you cannot do the step. ${LOOP}`,
|
|
22
|
+
inputSchema: {
|
|
23
|
+
flow: z.string().describe('The flow name.'),
|
|
24
|
+
step: z.string().describe('The id of the current step.'),
|
|
25
|
+
output: z.record(z.string(), z.unknown()).optional().describe('The output, matching the output schema of the step.'),
|
|
26
|
+
fail: z.string().optional().describe('The reason why the step cannot be done. It ends the flow.'),
|
|
27
|
+
},
|
|
28
|
+
}, async ({ flow, step, output, fail }) => reply(done({ flow, id: step, output, fail, cwd })));
|
|
29
|
+
server.registerTool('flow_status', { description: 'Get the current step of a flow again, with the results of the steps so far.', inputSchema: { flow: z.string() } }, async ({ flow }) => reply(status({ flow, cwd })));
|
|
30
|
+
server.registerTool('flow_reset', { description: 'Delete the state of a flow.', inputSchema: { flow: z.string() } }, async ({ flow }) => reply(reset({ flow, cwd })));
|
|
31
|
+
server.registerTool('flow_check', { description: 'Check a flow file without running it.', inputSchema: { file: z.string() } }, async ({ file }) => reply(check({ file })));
|
|
32
|
+
return server;
|
|
33
|
+
}
|
|
34
|
+
export async function serve() {
|
|
35
|
+
await createServer().connect(new StdioServerTransport());
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=mcp.js.map
|
package/dist/mcp.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}
|
package/dist/run.d.ts
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { RunOptions, RunResult } from './types.js';
|
|
2
|
+
/** Lines `key=value`, or `key<<DELIMITER` ... `DELIMITER`, as in GITHUB_OUTPUT. */
|
|
3
|
+
export declare function parseOutputs(content: string): Record<string, string>;
|
|
4
|
+
/** `::warning::<text>` lines on stdout, as in GitHub Actions. The agent shows them to the user. */
|
|
5
|
+
export declare const parseWarnings: (stdout: string) => string[];
|
|
6
|
+
export declare function runCommand(command: string, { env, dir, cwd, timeoutMs }: RunOptions): RunResult;
|