@plateforme-ai/lobster 2026.6.12

package/dist/test/step_timeout.test.js

@@ -0,0 +1,154 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { promises as fsp } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { PassThrough } from "node:stream";
+import { loadWorkflowFile, runWorkflowFile } from "../src/workflows/file.js";
+import { createDefaultRegistry } from "../src/commands/registry.js";
+async function runWorkflow(workflow, opts) {
+    const tmpDir = await fsp.mkdtemp(path.join(os.tmpdir(), "lobster-step-timeout-"));
+    const stateDir = path.join(tmpDir, "state");
+    const filePath = path.join(tmpDir, "workflow.lobster");
+    await fsp.writeFile(filePath, JSON.stringify(workflow, null, 2), "utf8");
+    const stderr = new PassThrough();
+    const chunks = [];
+    stderr.on("data", (chunk) => chunks.push(String(chunk)));
+    const result = await runWorkflowFile({
+        filePath,
+        ctx: {
+            stdin: process.stdin,
+            stdout: process.stdout,
+            stderr,
+            env: { ...process.env, LOBSTER_STATE_DIR: stateDir },
+            mode: "tool",
+            signal: opts?.signal,
+            dryRun: opts?.dryRun,
+            registry: createDefaultRegistry(),
+        },
+    });
+    return { result, stderrOutput: chunks.join("") };
+}
+async function writeWorkflow(workflow) {
+    const tmpDir = await fsp.mkdtemp(path.join(os.tmpdir(), "lobster-step-timeout-load-"));
+    const filePath = path.join(tmpDir, "workflow.lobster");
+    await fsp.writeFile(filePath, JSON.stringify(workflow, null, 2), "utf8");
+    return filePath;
+}
+test("timeout_ms validation rejects non-numeric values", async () => {
+    const filePath = await writeWorkflow({
+        steps: [{ id: "x", command: "echo hi", timeout_ms: "fast" }],
+    });
+    await assert.rejects(() => loadWorkflowFile(filePath), /timeout_ms must be a positive integer between 1 and 2147483647/);
+});
+test("timeout_ms validation rejects 0", async () => {
+    const filePath = await writeWorkflow({
+        steps: [{ id: "x", command: "echo hi", timeout_ms: 0 }],
+    });
+    await assert.rejects(() => loadWorkflowFile(filePath), /timeout_ms must be a positive integer between 1 and 2147483647/);
+});
+test("timeout_ms validation rejects non-integer values", async () => {
+    const filePath = await writeWorkflow({
+        steps: [{ id: "x", command: "echo hi", timeout_ms: 1.5 }],
+    });
+    await assert.rejects(() => loadWorkflowFile(filePath), /timeout_ms must be a positive integer between 1 and 2147483647/);
+});
+test("timeout_ms validation rejects values above Node timer max", async () => {
+    const filePath = await writeWorkflow({
+        steps: [{ id: "x", command: "echo hi", timeout_ms: 2_147_483_648 }],
+    });
+    await assert.rejects(() => loadWorkflowFile(filePath), /timeout_ms must be a positive integer between 1 and 2147483647/);
+});
+test("on_error validation rejects unsupported values", async () => {
+    const filePath = await writeWorkflow({
+        steps: [{ id: "x", command: "echo hi", on_error: "retry" }],
+    });
+    await assert.rejects(() => loadWorkflowFile(filePath), /on_error must be "stop", "continue", or "skip_rest"/);
+});
+test("timed-out step fails by default (on_error: stop)", async () => {
+    await assert.rejects(() => runWorkflow({
+        steps: [{ id: "slow", command: 'node -e "setTimeout(() => {}, 5000)"', timeout_ms: 100 }],
+    }), /timed out after 100ms/);
+});
+test("timed-out step with on_error: continue records error and continues", async () => {
+    const { result } = await runWorkflow({
+        steps: [
+            {
+                id: "slow",
+                command: 'node -e "setTimeout(() => {}, 5000)"',
+                timeout_ms: 100,
+                on_error: "continue",
+            },
+            { id: "after", command: 'node -e "process.stdout.write(JSON.stringify({ok:true}))"' },
+        ],
+    });
+    assert.equal(result.status, "ok");
+    assert.deepEqual(result.output, [{ ok: true }]);
+});
+test("timed-out step with on_error: skip_rest stops remaining steps", async () => {
+    const { result } = await runWorkflow({
+        steps: [
+            { id: "start", command: 'node -e "process.stdout.write(JSON.stringify({kept:true}))"' },
+            {
+                id: "slow",
+                command: 'node -e "setTimeout(() => {}, 5000)"',
+                timeout_ms: 100,
+                on_error: "skip_rest",
+            },
+            { id: "after", command: 'node -e "process.stdout.write(JSON.stringify({shouldRun:false}))"' },
+        ],
+    });
+    assert.equal(result.status, "ok");
+    assert.deepEqual(result.output, [{ kept: true }]);
+});
+test("step error marker is available to conditions after on_error: continue", async () => {
+    const { result } = await runWorkflow({
+        steps: [
+            {
+                id: "slow",
+                command: 'node -e "setTimeout(() => {}, 5000)"',
+                timeout_ms: 100,
+                on_error: "continue",
+            },
+            {
+                id: "check",
+                command: 'node -e "process.stdout.write(JSON.stringify({timedOut: process.env.TIMED_OUT}))"',
+                env: {
+                    TIMED_OUT: "$slow.error",
+                },
+                when: "$slow.error == true",
+            },
+        ],
+    });
+    assert.equal(result.status, "ok");
+    assert.deepEqual(result.output, [{ timedOut: "true" }]);
+});
+test("external abort still propagates when timeout is configured", async () => {
+    const controller = new AbortController();
+    controller.abort();
+    await assert.rejects(() => runWorkflow({
+        steps: [
+            {
+                id: "slow",
+                command: 'node -e "setTimeout(() => {}, 5000)"',
+                timeout_ms: 5000,
+                on_error: "continue",
+            },
+        ],
+    }, { signal: controller.signal }), (err) => err?.name === "AbortError" || err?.code === "ABORT_ERR");
+});
+test("dry-run renders timeout and on_error details", async () => {
+    const { stderrOutput } = await runWorkflow({
+        steps: [
+            {
+                id: "fetch",
+                command: "curl https://example.com",
+                timeout_ms: 5000,
+                on_error: "continue",
+            },
+        ],
+    }, { dryRun: true });
+    assert.match(stderrOutput, /timeout: 5000ms/);
+    assert.match(stderrOutput, /on_error: continue/);
+});
+//# sourceMappingURL=step_timeout.test.js.map

package/dist/test/step_timeout.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step_timeout.test.js","sourceRoot":"","sources":["../../test/step_timeout.test.ts"],"names":[],"mappings":"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"}

package/dist/test/template.test.js

@@ -0,0 +1,46 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { runPipeline } from "../src/runtime.js";
+import { createDefaultRegistry } from "../src/commands/registry.js";
+import { parsePipeline } from "../src/parser.js";
+async function run(pipelineText, input) {
+    const pipeline = parsePipeline(pipelineText);
+    const registry = createDefaultRegistry();
+    const res = await runPipeline({
+        pipeline,
+        registry,
+        stdin: process.stdin,
+        stdout: process.stdout,
+        stderr: process.stderr,
+        env: process.env,
+        mode: "tool",
+        input: (async function* () {
+            for (const x of input)
+                yield x;
+        })(),
+    });
+    return res.items;
+}
+test("template renders fields and nested fields", async () => {
+    const out = await run("template --text 'hi {{user.name}}'", [{ user: { name: "v" } }]);
+    assert.deepEqual(out, ["hi v"]);
+});
+test("template renders missing fields as empty", async () => {
+    const out = await run("template --text 'x={{nope}}'", [{ a: 1 }]);
+    assert.deepEqual(out, ["x="]);
+});
+test("template supports {{.}} for whole item", async () => {
+    const out = await run("template --text '{{.}}'", [{ a: 1 }]);
+    assert.deepEqual(out, [JSON.stringify({ a: 1 })]);
+});
+test("template supports --file", async () => {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), "lobster-template-"));
+    const file = path.join(dir, "tpl.txt");
+    await fs.writeFile(file, "hey {{x}}", "utf8");
+    const out = await run(`template --file ${file}`, [{ x: "ok" }]);
+    assert.deepEqual(out, ["hey ok"]);
+});
+//# sourceMappingURL=template.test.js.map

package/dist/test/template.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.test.js","sourceRoot":"","sources":["../../test/template.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,KAAK,UAAU,GAAG,CAAC,YAAoB,EAAE,KAAY;IACnD,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC;QAC5B,QAAQ;QACR,QAAQ;QACR,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC;YACrB,KAAK,MAAM,CAAC,IAAI,KAAK;gBAAE,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC,EAAE;KACL,CAAC,CAAC;IACH,OAAO,GAAG,CAAC,KAAK,CAAC;AACnB,CAAC;AAED,IAAI,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;IAC3D,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,oCAAoC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IACvF,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;IAC1D,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,8BAA8B,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;IACxD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,yBAAyB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;IAC1C,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,mBAAmB,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC"}

package/dist/test/template_filters.test.js

@@ -0,0 +1,107 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { parsePipeline } from "../src/parser.js";
+import { runPipeline } from "../src/runtime.js";
+import { createDefaultRegistry } from "../src/commands/registry.js";
+import { applyFilters, parseFilterExpression } from "../src/core/filters.js";
+async function run(pipelineText, input) {
+    const pipeline = parsePipeline(pipelineText);
+    const registry = createDefaultRegistry();
+    const res = await runPipeline({
+        pipeline,
+        registry,
+        stdin: process.stdin,
+        stdout: process.stdout,
+        stderr: process.stderr,
+        env: process.env,
+        mode: "tool",
+        input: (async function* () {
+            for (const x of input)
+                yield x;
+        })(),
+    });
+    return res.items;
+}
+test("parseFilterExpression parses simple filter", () => {
+    assert.deepEqual(parseFilterExpression("upper"), ["upper"]);
+});
+test("parseFilterExpression parses filter args", () => {
+    assert.deepEqual(parseFilterExpression("truncate 80"), ["truncate", "80"]);
+});
+test("parseFilterExpression parses quoted args", () => {
+    assert.deepEqual(parseFilterExpression('replace "-" "_"'), ["replace", "-", "_"]);
+});
+test("applyFilters upper", () => {
+    assert.equal(applyFilters("hello", ["upper"]), "HELLO");
+});
+test("applyFilters lower", () => {
+    assert.equal(applyFilters("HELLO", ["lower"]), "hello");
+});
+test("applyFilters trim", () => {
+    assert.equal(applyFilters("  hi  ", ["trim"]), "hi");
+});
+test("applyFilters truncate", () => {
+    assert.equal(applyFilters("hello world", ["truncate 5"]), "hello...");
+});
+test("applyFilters replace", () => {
+    assert.equal(applyFilters("a-b-c", ['replace "-" "_"']), "a_b_c");
+});
+test("applyFilters split", () => {
+    assert.deepEqual(applyFilters("a,b,c", ['split ","']), ["a", "b", "c"]);
+});
+test("applyFilters first/last", () => {
+    assert.equal(applyFilters([1, 2, 3], ["first"]), 1);
+    assert.equal(applyFilters([1, 2, 3], ["last"]), 3);
+});
+test("applyFilters length on array and string", () => {
+    assert.equal(applyFilters([1, 2, 3], ["length"]), 3);
+    assert.equal(applyFilters("hello", ["length"]), 5);
+});
+test("applyFilters join", () => {
+    assert.equal(applyFilters(["a", "b", "c"], ['join ", "']), "a, b, c");
+});
+test("applyFilters json/default/round", () => {
+    assert.equal(applyFilters({ a: 1 }, ["json"]), JSON.stringify({ a: 1 }, null, 2));
+    assert.equal(applyFilters(null, ['default "N/A"']), "N/A");
+    assert.equal(applyFilters("ok", ['default "N/A"']), "ok");
+    assert.equal(applyFilters(3.14159, ["round 2"]), 3.14);
+});
+test("applyFilters chain", () => {
+    assert.equal(applyFilters("  Hello World  ", ["trim", "upper"]), "HELLO WORLD");
+});
+test("applyFilters date formatting is UTC-stable", () => {
+    const result = applyFilters(1710000000000, ['date "YYYY-MM-DD"']);
+    assert.equal(result, "2024-03-09");
+});
+test("applyFilters unknown filter throws", () => {
+    assert.throws(() => applyFilters("x", ["nonexistent"]), /Unknown template filter/);
+});
+test("template filter integration: upper", async () => {
+    const out = await run("template --text '{{name | upper}}'", [{ name: "alice" }]);
+    assert.deepEqual(out, ["ALICE"]);
+});
+test("template filter integration: length", async () => {
+    const out = await run("template --text '{{items | length}}'", [{ items: [1, 2, 3] }]);
+    assert.deepEqual(out, ["3"]);
+});
+test("template filter integration: default", async () => {
+    const out = await run("template --text '{{missing | default \"N/A\"}}'", [{ other: 1 }]);
+    assert.deepEqual(out, ["N/A"]);
+});
+test("template filter integration: chained", async () => {
+    const out = await run("template --text '{{name | trim | upper}}'", [{ name: "  bob  " }]);
+    assert.deepEqual(out, ["BOB"]);
+});
+test("template integration without filters remains unchanged", async () => {
+    const out = await run("template --text 'hi {{name}}'", [{ name: "v" }]);
+    assert.deepEqual(out, ["hi v"]);
+});
+test("template filter integration: join", async () => {
+    const out = await run("template --text '{{tags | join \", \"}}'", [{ tags: ["a", "b", "c"] }]);
+    assert.deepEqual(out, ["a, b, c"]);
+});
+test("template filter splitter handles quoted pipe characters", async () => {
+    const out = await run("template --text '{{line | split \"|\" | first}}'", [{ line: "a|b|c" }]);
+    assert.deepEqual(out, ["a"]);
+});
+//# sourceMappingURL=template_filters.test.js.map

package/dist/test/template_filters.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template_filters.test.js","sourceRoot":"","sources":["../../test/template_filters.test.ts"],"names":[],"mappings":"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"}

package/dist/test/tool_envelope_version.test.js

@@ -0,0 +1,15 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+test("tool mode outputs protocolVersion", () => {
+    const bin = path.join(process.cwd(), "bin", "lobster.js");
+    const res = spawnSync("node", [bin, "run", "--mode", "tool", "exec --json --shell 'echo [1]'"], {
+        encoding: "utf8",
+    });
+    assert.equal(res.status, 0);
+    const out = JSON.parse(res.stdout);
+    assert.equal(out.protocolVersion, 1);
+    assert.equal(out.ok, true);
+});
+//# sourceMappingURL=tool_envelope_version.test.js.map

package/dist/test/tool_envelope_version.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_envelope_version.test.js","sourceRoot":"","sources":["../../test/tool_envelope_version.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,IAAI,CAAC,mCAAmC,EAAE,GAAG,EAAE;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,gCAAgC,CAAC,EAAE;QAC9F,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC"}

package/dist/test/tool_mode.test.js

@@ -0,0 +1,83 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { parsePipeline } from "../src/parser.js";
+import { createDefaultRegistry } from "../src/commands/registry.js";
+import { runPipeline } from "../src/runtime.js";
+function streamOf(items) {
+    return (async function* () {
+        for (const item of items)
+            yield item;
+    })();
+}
+test("approve halts pipeline in tool mode", async () => {
+    const registry = createDefaultRegistry();
+    const pipeline = parsePipeline("exec --json --shell \"node -e 'process.stdout.write(JSON.stringify([{a:1}]))'\" | approve --prompt 'send?' | exec --shell 'exit 1'");
+    const output = await runPipeline({
+        pipeline,
+        registry,
+        input: [],
+        stdin: process.stdin,
+        stdout: process.stdout,
+        stderr: process.stderr,
+        env: process.env,
+        mode: "tool",
+    });
+    assert.equal(output.halted, true);
+    assert.equal(output.items.length, 1);
+    assert.equal(output.items[0].type, "approval_request");
+    assert.equal(output.items[0].items.length, 1);
+    assert.deepEqual(output.items[0].items[0], { a: 1 });
+});
+test("approve passes through in human interactive mode only (emit required otherwise)", async () => {
+    const registry = createDefaultRegistry();
+    const cmd = registry.get("approve");
+    const result = await cmd.run({
+        input: streamOf([{ x: 1 }]),
+        args: { _: [], emit: true, prompt: "ok?" },
+        ctx: {
+            stdin: process.stdin,
+            stdout: process.stdout,
+            stderr: process.stderr,
+            env: process.env,
+            registry,
+            mode: "human",
+            render: { json() { }, lines() { } },
+        },
+    });
+    const items = [];
+    for await (const it of result.output)
+        items.push(it);
+    assert.equal(result.halt, true);
+    assert.equal(items[0].type, "approval_request");
+});
+test("ask halts pipeline in tool mode with needs_input payload", async () => {
+    const registry = createDefaultRegistry();
+    const cmd = registry.get("ask");
+    const result = await cmd.run({
+        input: streamOf([{ text: "draft v1" }]),
+        args: {
+            _: [],
+            prompt: "Review?",
+            "subject-from-stdin": true,
+            schema: '{"type":"object","properties":{"decision":{"type":"string"}},"required":["decision"]}',
+        },
+        ctx: {
+            stdin: process.stdin,
+            stdout: process.stdout,
+            stderr: process.stderr,
+            env: process.env,
+            registry,
+            mode: "tool",
+            render: { json() { }, lines() { } },
+        },
+    });
+    const items = [];
+    for await (const it of result.output)
+        items.push(it);
+    assert.equal(result.halt, true);
+    assert.equal(items.length, 1);
+    assert.equal(items[0].type, "input_request");
+    assert.equal(items[0].prompt, "Review?");
+    assert.deepEqual(items[0].subject, { text: '{"text":"draft v1"}' });
+});
+//# sourceMappingURL=tool_mode.test.js.map

package/dist/test/tool_mode.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_mode.test.js","sourceRoot":"","sources":["../../test/tool_mode.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,SAAS,QAAQ,CAAC,KAAK;IACrB,OAAO,CAAC,KAAK,SAAS,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,MAAM,IAAI,CAAC;IACvC,CAAC,CAAC,EAAE,CAAC;AACP,CAAC;AAED,IAAI,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;IACrD,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,aAAa,CAC5B,oIAAoI,CACrI,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;QAC/B,QAAQ;QACR,QAAQ;QACR,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE,MAAM;KACb,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;IACjG,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEpC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC;QAC3B,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;QAC1C,GAAG,EAAE;YACH,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ;YACR,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,EAAE,IAAI,KAAI,CAAC,EAAE,KAAK,KAAI,CAAC,EAAE;SAClC;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;IAC1E,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEhC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC;QAC3B,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QACvC,IAAI,EAAE;YACJ,CAAC,EAAE,EAAE;YACL,MAAM,EAAE,SAAS;YACjB,oBAAoB,EAAE,IAAI;YAC1B,MAAM,EACJ,uFAAuF;SAC1F;QACD,GAAG,EAAE;YACH,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ;YACR,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,EAAE,IAAI,KAAI,CAAC,EAAE,KAAK,KAAI,CAAC,EAAE;SAClC;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC;AACtE,CAAC,CAAC,CAAC"}

package/dist/test/validation.test.js

@@ -0,0 +1,28 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { Ajv } from "ajv";
+import { createCompileCached } from "../src/validation.js";
+test("compileCached reuses validators for structurally equivalent schemas", () => {
+    const ajv = new Ajv({ strict: false });
+    const compile = ajv.compile.bind(ajv);
+    let compileCount = 0;
+    ajv.compile = ((schema) => {
+        compileCount += 1;
+        return compile(schema);
+    });
+    const compileCached = createCompileCached(ajv);
+    const first = compileCached({
+        type: "object",
+        properties: { value: { type: "string" } },
+        required: ["value"],
+    });
+    const second = compileCached({
+        required: ["value"],
+        properties: { value: { type: "string" } },
+        type: "object",
+    });
+    assert.equal(second, first);
+    assert.equal(compileCount, 1);
+    assert.equal(first({ value: "ok" }), true);
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/test/validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.js","sourceRoot":"","sources":["../../test/validation.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,IAAI,CAAC,qEAAqE,EAAE,GAAG,EAAE;IAC/E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACxB,YAAY,IAAI,CAAC,CAAC;QAClB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,CAAuB,CAAC;IAEzB,MAAM,aAAa,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,aAAa,CAAC;QAC1B,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QACzC,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,aAAa,CAAC;QAC3B,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QACzC,IAAI,EAAE,QAAQ;KACf,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5B,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC"}

package/dist/test/workflow_args_env.test.js

@@ -0,0 +1,41 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { promises as fsp } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { runWorkflowFile } from "../src/workflows/file.js";
+test("workflow file exposes args as LOBSTER_ARG_* env vars (safe for quotes)", async () => {
+    const workflow = {
+        name: "args-env",
+        args: {
+            text: { default: "" },
+        },
+        steps: [
+            {
+                id: "echo",
+                // Avoid embedding the arg into the shell command; read from env instead.
+                command: 'node -e "process.stdout.write(JSON.stringify({text: process.env.LOBSTER_ARG_TEXT}))"',
+            },
+        ],
+    };
+    const tmpDir = await fsp.mkdtemp(path.join(os.tmpdir(), "lobster-workflow-args-env-"));
+    const stateDir = path.join(tmpDir, "state");
+    const filePath = path.join(tmpDir, "workflow.lobster");
+    await fsp.writeFile(filePath, JSON.stringify(workflow, null, 2), "utf8");
+    const env = { ...process.env, LOBSTER_STATE_DIR: stateDir };
+    const text = 'hello "world" $HOME `backticks` $(whoami)';
+    const result = await runWorkflowFile({
+        filePath,
+        args: { text },
+        ctx: {
+            stdin: process.stdin,
+            stdout: process.stdout,
+            stderr: process.stderr,
+            env,
+            mode: "tool",
+        },
+    });
+    assert.equal(result.status, "ok");
+    assert.deepEqual(result.output, [{ text }]);
+});
+//# sourceMappingURL=workflow_args_env.test.js.map

package/dist/test/workflow_args_env.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_args_env.test.js","sourceRoot":"","sources":["../../test/workflow_args_env.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,IAAI,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;IACxF,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE;YACJ,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;SACtB;QACD,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,MAAM;gBACV,yEAAyE;gBACzE,OAAO,EACL,sFAAsF;aACzF;SACF;KACF,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAC;IACvF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACvD,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAEzE,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,2CAA2C,CAAC;IAEzD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,QAAQ;QACR,IAAI,EAAE,EAAE,IAAI,EAAE;QACd,GAAG,EAAE;YACH,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG;YACH,IAAI,EAAE,MAAM;SACb;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC"}