@united-workforce/cli 0.1.0

package/dist/__tests__/thread-show-status.test.js

@@ -0,0 +1,267 @@
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { putSchema } from "@ocas/core";
+import { describe, expect, test } from "vitest";
+import { createMarker, deleteMarker } from "../background/index.js";
+import { cmdThreadShow, cmdThreadStart } from "../commands/thread.js";
+import { completeThread, createUwfStore, loadAllThreads, setThread } from "../store.js";
+const OUTPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        $status: { type: "string" },
+        question: { type: "string" },
+    },
+};
+const TEST_WORKFLOW_YAML = `
+name: test-status
+description: Test workflow for status field
+roles:
+  planner:
+    description: Plans the work
+    goal: Plan implementation
+    capabilities: ["planning"]
+    procedure: Plan
+    output: |
+      $status: "ready"
+    frontmatter:
+      type: object
+      required: ["$status"]
+      properties:
+        $status: { type: string, enum: ["ready"] }
+graph:
+  $START:
+    _:
+      role: planner
+      prompt: "Plan the work"
+      location: null
+  planner:
+    ready:
+      role: $END
+      prompt: "Done"
+      location: null
+`;
+const SUSPEND_WORKFLOW_YAML = `
+name: test-suspend-status
+description: Test workflow for suspended status
+roles:
+  worker:
+    description: Worker role
+    goal: Work
+    capabilities: ["coding"]
+    procedure: Work
+    output: |
+      $status: "needs_input"
+      question: "Which API?"
+    frontmatter:
+      oneOf:
+        - type: object
+          required: ["$status", "question"]
+          properties:
+            $status: { const: "needs_input" }
+            question: { type: string }
+graph:
+  $START:
+    _:
+      role: worker
+      prompt: "Start work"
+      location: null
+  worker:
+    needs_input:
+      role: $SUSPEND
+      prompt: "Please clarify: {{{question}}}"
+      location: null
+`;
+async function insertStepNode(storageRoot, threadId, role, outputPayload) {
+    const uwf = await createUwfStore(storageRoot);
+    const index = loadAllThreads(uwf.varStore);
+    const headEntry = index[threadId];
+    if (headEntry === undefined)
+        throw new Error(`thread ${threadId} not in index`);
+    const head = headEntry.head;
+    const outputSchemaHash = await putSchema(uwf.store, OUTPUT_SCHEMA);
+    const outputHash = await uwf.store.cas.put(outputSchemaHash, outputPayload);
+    const detailHash = await uwf.store.cas.put(uwf.schemas.text, "detail-placeholder");
+    const headNode = uwf.store.cas.get(head);
+    if (headNode === null)
+        throw new Error(`head ${head} not found`);
+    const isStart = headNode.type === uwf.schemas.startNode;
+    const startHash = isStart ? head : headNode.payload.start;
+    const stepHash = (await uwf.store.cas.put(uwf.schemas.stepNode, {
+        start: startHash,
+        prev: isStart ? null : head,
+        role,
+        output: outputHash,
+        detail: detailHash,
+        agent: "uwf-test",
+        edgePrompt: "edge",
+        startedAtMs: Date.now(),
+        completedAtMs: Date.now() + 1,
+        cwd: "/tmp",
+        assembledPrompt: null,
+    }));
+    setThread(uwf.varStore, threadId, {
+        head: stepHash,
+        status: "idle",
+        suspendedRole: null,
+        suspendMessage: null,
+        completedAt: null,
+    });
+}
+describe("thread show status field", () => {
+    let tmpDir;
+    let storageRoot;
+    async function setupTestEnv() {
+        tmpDir = join(tmpdir(), `uwf-test-status-${Date.now()}`);
+        storageRoot = join(tmpDir, "storage");
+        await mkdir(storageRoot, { recursive: true });
+    }
+    async function teardown() {
+        if (tmpDir) {
+            await rm(tmpDir, { recursive: true, force: true });
+        }
+    }
+    test("active idle thread shows status 'idle'", async () => {
+        await setupTestEnv();
+        const workflowPath = join(tmpDir, "test-status.yaml");
+        await writeFile(workflowPath, TEST_WORKFLOW_YAML, "utf8");
+        // Create a thread
+        const startResult = await cmdThreadStart(storageRoot, workflowPath, "test prompt", tmpDir);
+        const threadId = startResult.thread;
+        // Show the thread (should be idle)
+        const result = await cmdThreadShow(storageRoot, threadId);
+        expect(result.status).toBe("idle");
+        expect(result.done).toBe(false);
+        expect(result.background).toBe(null);
+        expect(result.thread).toBe(threadId);
+        await teardown();
+    });
+    test("active running thread shows status 'running'", async () => {
+        await setupTestEnv();
+        const workflowPath = join(tmpDir, "test-status.yaml");
+        await writeFile(workflowPath, TEST_WORKFLOW_YAML, "utf8");
+        // Create a thread
+        const startResult = await cmdThreadStart(storageRoot, workflowPath, "test prompt", tmpDir);
+        const threadId = startResult.thread;
+        const workflow = startResult.workflow;
+        // Create a running marker
+        await createMarker(storageRoot, {
+            thread: threadId,
+            workflow,
+            pid: process.pid,
+            startedAt: Date.now(),
+        });
+        try {
+            const result = await cmdThreadShow(storageRoot, threadId);
+            expect(result.status).toBe("running");
+            expect(result.done).toBe(false);
+            expect(result.background).toBe(null);
+            expect(result.thread).toBe(threadId);
+        }
+        finally {
+            // Cleanup: delete marker
+            await deleteMarker(storageRoot, threadId);
+            await teardown();
+        }
+    });
+    test("completed thread shows status 'completed'", async () => {
+        await setupTestEnv();
+        const workflowPath = join(tmpDir, "test-status.yaml");
+        await writeFile(workflowPath, TEST_WORKFLOW_YAML, "utf8");
+        // Create a thread
+        const startResult = await cmdThreadStart(storageRoot, workflowPath, "test prompt", tmpDir);
+        const threadId = startResult.thread;
+        const _workflow = startResult.workflow;
+        // Get the head hash before moving to history
+        const uwfForIndex = await createUwfStore(storageRoot);
+        const index = loadAllThreads(uwfForIndex.varStore);
+        const head = index[threadId].head;
+        if (!head)
+            throw new Error("Thread not found in index");
+        completeThread(uwfForIndex.varStore, threadId, "completed");
+        const result = await cmdThreadShow(storageRoot, threadId);
+        expect(result.status).toBe("completed");
+        expect(result.done).toBe(true);
+        expect(result.background).toBe(null);
+        expect(result.thread).toBe(threadId);
+        await teardown();
+    });
+    test("cancelled thread shows status 'cancelled'", async () => {
+        await setupTestEnv();
+        const workflowPath = join(tmpDir, "test-status.yaml");
+        await writeFile(workflowPath, TEST_WORKFLOW_YAML, "utf8");
+        // Create a thread
+        const startResult = await cmdThreadStart(storageRoot, workflowPath, "test prompt", tmpDir);
+        const threadId = startResult.thread;
+        const _workflow = startResult.workflow;
+        // Get the head hash before moving to history
+        const uwfForIndex = await createUwfStore(storageRoot);
+        const index = loadAllThreads(uwfForIndex.varStore);
+        const head = index[threadId].head;
+        if (!head)
+            throw new Error("Thread not found in index");
+        completeThread(uwfForIndex.varStore, threadId, "cancelled");
+        const result = await cmdThreadShow(storageRoot, threadId);
+        expect(result.status).toBe("cancelled");
+        expect(result.done).toBe(true);
+        expect(result.background).toBe(null);
+        expect(result.thread).toBe(threadId);
+        await teardown();
+    });
+    test("legacy completed thread without reason shows status 'completed'", async () => {
+        await setupTestEnv();
+        const workflowPath = join(tmpDir, "test-status.yaml");
+        await writeFile(workflowPath, TEST_WORKFLOW_YAML, "utf8");
+        // Create a thread
+        const startResult = await cmdThreadStart(storageRoot, workflowPath, "test prompt", tmpDir);
+        const threadId = startResult.thread;
+        const _workflow = startResult.workflow;
+        // Get the head hash before moving to history
+        const uwfForIndex = await createUwfStore(storageRoot);
+        const index = loadAllThreads(uwfForIndex.varStore);
+        const head = index[threadId].head;
+        if (!head)
+            throw new Error("Thread not found in index");
+        completeThread(uwfForIndex.varStore, threadId, "completed");
+        const result = await cmdThreadShow(storageRoot, threadId);
+        expect(result.status).toBe("completed");
+        expect(result.done).toBe(true);
+        expect(result.background).toBe(null);
+        await teardown();
+    });
+    test("active suspended thread shows status 'suspended'", async () => {
+        await setupTestEnv();
+        const casDir = join(tmpDir, "cas");
+        await mkdir(casDir, { recursive: true });
+        const originalCasDir = process.env.OCAS_HOME;
+        process.env.OCAS_HOME = casDir;
+        try {
+            const workflowPath = join(tmpDir, "test-suspend-status.yaml");
+            await writeFile(workflowPath, SUSPEND_WORKFLOW_YAML, "utf8");
+            const startResult = await cmdThreadStart(storageRoot, workflowPath, "test prompt", tmpDir);
+            const threadId = startResult.thread;
+            await insertStepNode(storageRoot, threadId, "worker", {
+                $status: "needs_input",
+                question: "Which API?",
+            });
+            const result = await cmdThreadShow(storageRoot, threadId);
+            expect(result.status).toBe("suspended");
+            expect(result.done).toBe(false);
+            expect(result.currentRole).toBe(null);
+            expect(result.suspendedRole).toBe("worker");
+            expect(result.suspendMessage).toBe("Please clarify: Which API?");
+            expect(result.background).toBe(null);
+            expect(result.thread).toBe(threadId);
+        }
+        finally {
+            if (originalCasDir === undefined) {
+                delete process.env.OCAS_HOME;
+            }
+            else {
+                process.env.OCAS_HOME = originalCasDir;
+            }
+            await teardown();
+        }
+    });
+});
+//# sourceMappingURL=thread-show-status.test.js.map

package/dist/__tests__/thread-show-status.test.js.map

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

package/dist/__tests__/thread-start-cwd-cli.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=thread-start-cwd-cli.test.d.ts.map

package/dist/__tests__/thread-start-cwd-cli.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-start-cwd-cli.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/thread-start-cwd-cli.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/thread-start-cwd-cli.test.js

@@ -0,0 +1,130 @@
+import { execFileSync } from "node:child_process";
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, test } from "vitest";
+import { cmdThreadStart } from "../commands/thread.js";
+import { createUwfStore, getThread } from "../store.js";
+describe("thread start --cwd CLI option", () => {
+    let tmpDir;
+    let storageRoot;
+    let casDir;
+    let originalEnv;
+    async function setupTestEnv() {
+        tmpDir = join(tmpdir(), `uwf-test-cwd-cli-${Date.now()}`);
+        storageRoot = join(tmpDir, "storage");
+        casDir = join(tmpDir, "cas");
+        await mkdir(storageRoot, { recursive: true });
+        await mkdir(casDir, { recursive: true });
+        // Set OCAS_HOME for this test
+        originalEnv = process.env.OCAS_HOME;
+        process.env.OCAS_HOME = casDir;
+    }
+    async function teardown() {
+        if (tmpDir) {
+            await rm(tmpDir, { recursive: true, force: true });
+        }
+        // Restore original environment
+        if (originalEnv === undefined) {
+            delete process.env.OCAS_HOME;
+        }
+        else {
+            process.env.OCAS_HOME = originalEnv;
+        }
+    }
+    async function createTestWorkflow() {
+        const workflowYaml = `
+name: test-cwd-cli
+description: Test workflow for CLI cwd option
+roles:
+  planner:
+    description: Plans the work
+    goal: Plan implementation
+    capabilities: ["planning"]
+    procedure: Plan
+    output: |
+      $status: "ready"
+    frontmatter:
+      type: object
+      required: ["$status"]
+      properties:
+        $status: { type: string, enum: ["ready"] }
+graph:
+  $START:
+    _:
+      role: planner
+      prompt: "Plan the work"
+      location: null
+  planner:
+    ready:
+      role: $END
+      prompt: "Done"
+      location: null
+`;
+        const workflowPath = join(tmpDir, "test-cwd-cli.yaml");
+        await writeFile(workflowPath, workflowYaml, "utf8");
+        return workflowPath;
+    }
+    async function getStartNodeCwd(threadId) {
+        const uwf = await createUwfStore(storageRoot);
+        const entry = getThread(uwf.varStore, threadId);
+        const headHash = entry.head;
+        expect(headHash).toBeDefined();
+        const startNode = uwf.store.cas.get(headHash);
+        expect(startNode).not.toBe(null);
+        expect(startNode?.type).toBe(uwf.schemas.startNode);
+        const startPayload = startNode?.payload;
+        return startPayload.cwd;
+    }
+    test("thread start with custom cwd via cmdThreadStart", async () => {
+        await setupTestEnv();
+        const workflowPath = await createTestWorkflow();
+        const testCwd = "/test/custom/path";
+        const result = await cmdThreadStart(storageRoot, workflowPath, "test prompt", tmpDir, testCwd);
+        expect(result.thread).toBeDefined();
+        const actualCwd = await getStartNodeCwd(result.thread);
+        expect(actualCwd).toBe(testCwd);
+        await teardown();
+    });
+    test("thread start without cwd defaults to process.cwd()", async () => {
+        await setupTestEnv();
+        const workflowPath = await createTestWorkflow();
+        // Call without cwd parameter (it defaults to process.cwd())
+        const result = await cmdThreadStart(storageRoot, workflowPath, "test prompt", tmpDir);
+        expect(result.thread).toBeDefined();
+        const actualCwd = await getStartNodeCwd(result.thread);
+        expect(actualCwd).toBe(process.cwd());
+        await teardown();
+    });
+    test("thread start with relative path fails", async () => {
+        await setupTestEnv();
+        const workflowPath = await createTestWorkflow();
+        await expect(cmdThreadStart(storageRoot, workflowPath, "test", tmpDir, "relative/path")).rejects.toThrow();
+        await teardown();
+    });
+    test("CLI accepts --cwd option without error", async () => {
+        await setupTestEnv();
+        const workflowPath = await createTestWorkflow();
+        const testCwd = "/test/cli/path";
+        const pkgRoot = dirname(dirname(dirname(fileURLToPath(import.meta.url))));
+        const uwfBin = join(pkgRoot, "dist", "cli.js");
+        // Register the workflow
+        execFileSync(process.execPath, [uwfBin, "workflow", "add", workflowPath], {
+            env: { ...process.env, UWF_HOME: storageRoot, OCAS_HOME: casDir },
+            encoding: "utf8",
+        });
+        // Verify CLI accepts --cwd option (no error thrown)
+        const output = execFileSync(process.execPath, [uwfBin, "thread", "start", "test-cwd-cli", "-p", "test prompt", "--cwd", testCwd], {
+            env: { ...process.env, UWF_HOME: storageRoot, OCAS_HOME: casDir },
+            encoding: "utf8",
+        });
+        const result = JSON.parse(output);
+        expect(result.thread).toBeDefined();
+        expect(result.workflow).toBeDefined();
+        // The fact that we got here without throwing means CLI accepted the --cwd option
+        // The actual cwd functionality is tested by the other tests using cmdThreadStart directly
+        await teardown();
+    });
+});
+//# sourceMappingURL=thread-start-cwd-cli.test.js.map

package/dist/__tests__/thread-start-cwd-cli.test.js.map

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

package/dist/__tests__/thread-step-count.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=thread-step-count.test.d.ts.map

package/dist/__tests__/thread-step-count.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-step-count.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/thread-step-count.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/thread-step-count.test.js

@@ -0,0 +1,55 @@
+import { execFileSync } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, test } from "vitest";
+import { validateCount } from "../commands/thread.js";
+const CLI_PATH = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "dist", "cli.js");
+function runCli(args) {
+    try {
+        const stdout = execFileSync("node", [CLI_PATH, ...args], {
+            encoding: "utf8",
+            env: { ...process.env, UWF_HOME: "/tmp/uwf-test-nonexistent" },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        return { stdout, stderr: "", exitCode: 0 };
+    }
+    catch (e) {
+        const err = e;
+        return {
+            stdout: err.stdout ?? "",
+            stderr: err.stderr ?? "",
+            exitCode: err.status ?? 1,
+        };
+    }
+}
+describe("thread exec --count CLI parsing", { timeout: 30_000 }, () => {
+    test("--help shows -c/--count option", () => {
+        const result = runCli(["thread", "exec", "--help"]);
+        const combined = result.stdout + result.stderr;
+        expect(combined).toContain("--count");
+        expect(combined).toContain("-c");
+    });
+    test("description says 'one or more steps'", () => {
+        const result = runCli(["thread", "exec", "--help"]);
+        const combined = result.stdout + result.stderr;
+        expect(combined).toContain("one or more steps");
+    });
+});
+describe("validateCount", () => {
+    test("count=0 throws validation error", () => {
+        expect(() => validateCount(0)).toThrow("positive integer");
+    });
+    test("negative count throws validation error", () => {
+        expect(() => validateCount(-1)).toThrow("positive integer");
+    });
+    test("non-integer count throws validation error", () => {
+        expect(() => validateCount(1.5)).toThrow("positive integer");
+    });
+    test("count=1 passes validation", () => {
+        expect(() => validateCount(1)).not.toThrow();
+    });
+    test("count=3 passes validation", () => {
+        expect(() => validateCount(3)).not.toThrow();
+    });
+});
+//# sourceMappingURL=thread-step-count.test.js.map

package/dist/__tests__/thread-step-count.test.js.map

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

package/dist/__tests__/thread-suspend-step.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=thread-suspend-step.test.d.ts.map

package/dist/__tests__/thread-suspend-step.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-suspend-step.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/thread-suspend-step.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/thread-suspend-step.test.js

@@ -0,0 +1,155 @@
+import { execFileSync } from "node:child_process";
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { putSchema } from "@ocas/core";
+import { openStore } from "@ocas/fs";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
+import { cmdThreadShow } from "../commands/thread.js";
+import { registerUwfSchemas } from "../schemas.js";
+import { seedThreads } from "./thread-test-helpers.js";
+const OUTPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        $status: { type: "string" },
+        question: { type: "string" },
+    },
+    required: ["$status"],
+    additionalProperties: false,
+};
+let tmpDir;
+beforeEach(async () => {
+    tmpDir = await mkdtemp(join(tmpdir(), "cli-uwf-suspend-step-test-"));
+});
+afterEach(async () => {
+    await rm(tmpDir, { recursive: true, force: true });
+});
+describe("suspend step CAS chain and threads.yaml metadata", () => {
+    test("thread exec records suspend step in CAS and suspend metadata in threads.yaml", async () => {
+        const casDir = join(tmpDir, "cas");
+        await mkdir(casDir, { recursive: true });
+        const originalCasDir = process.env.OCAS_HOME;
+        process.env.OCAS_HOME = casDir;
+        try {
+            const store = await openStore(casDir);
+            const schemas = await registerUwfSchemas(store);
+            const outputSchemaHash = await putSchema(store, OUTPUT_SCHEMA);
+            const workflowHash = await store.cas.put(schemas.workflow, {
+                name: "test-suspend-step",
+                description: "suspend step integration test",
+                roles: {
+                    worker: {
+                        description: "Worker role",
+                        goal: "Work",
+                        capabilities: [],
+                        procedure: "work",
+                        output: "result",
+                        frontmatter: outputSchemaHash,
+                    },
+                },
+                graph: {
+                    $START: { _: { role: "worker", prompt: "Start work", location: null } },
+                    worker: {
+                        needs_input: {
+                            role: "$SUSPEND",
+                            prompt: "Please clarify: {{{question}}}",
+                            location: null,
+                        },
+                    },
+                },
+            });
+            const startHash = await store.cas.put(schemas.startNode, {
+                workflow: workflowHash,
+                prompt: "Test suspend task",
+                cwd: tmpDir,
+            });
+            const threadId = "01SUSPENDSTEPTEST0000000";
+            await seedThreads(tmpDir, { [threadId]: startHash });
+            const outputHash = await store.cas.put(outputSchemaHash, {
+                $status: "needs_input",
+                question: "Which API?",
+            });
+            const detailHash = await store.cas.put(schemas.text, "mock detail");
+            const startedAtMs = 1716600000000;
+            const completedAtMs = 1716600001500;
+            const stepHash = await store.cas.put(schemas.stepNode, {
+                start: startHash,
+                prev: null,
+                role: "worker",
+                output: outputHash,
+                detail: detailHash,
+                agent: "uwf-mock",
+                edgePrompt: "Start work",
+                startedAtMs,
+                completedAtMs,
+                cwd: tmpDir,
+                assembledPrompt: null,
+            });
+            const mockAgentPath = join(tmpDir, "mock-agent.sh");
+            const adapterJson = JSON.stringify({
+                stepHash,
+                detailHash,
+                role: "worker",
+                frontmatter: { $status: "needs_input", question: "Which API?" },
+                body: "",
+                startedAtMs,
+                completedAtMs,
+            });
+            await writeFile(mockAgentPath, `#!/bin/sh\necho '${adapterJson}'\n`, { mode: 0o755 });
+            const configPath = join(tmpDir, "config.yaml");
+            await writeFile(configPath, `defaultAgent: uwf-hermes\ndefaultModel: test-model\nagentOverrides: null\nagents: {}\nproviders: {}\nmodels: {}\n`);
+            const cliPath = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "dist", "cli.js");
+            const stdout = execFileSync(process.execPath, [cliPath, "thread", "exec", threadId, "--agent", mockAgentPath], {
+                encoding: "utf8",
+                stdio: ["ignore", "pipe", "pipe"],
+                env: {
+                    ...process.env,
+                    UWF_HOME: tmpDir,
+                    OCAS_HOME: casDir,
+                },
+                cwd: tmpDir,
+                timeout: 30000,
+            });
+            const cliOutput = JSON.parse(stdout.trim());
+            expect(cliOutput.status).toBe("suspended");
+            expect(cliOutput.head).toBe(stepHash);
+            expect(cliOutput.suspendedRole).toBe("worker");
+            expect(cliOutput.suspendMessage).toBe("Please clarify: Which API?");
+            const storeAfter = await openStore(casDir);
+            const stepNode = storeAfter.cas.get(cliOutput.head);
+            expect(stepNode).not.toBeNull();
+            const payload = stepNode.payload;
+            expect(payload.role).toBe("worker");
+            expect(payload.output).toBe(outputHash);
+            const outputNode = storeAfter.cas.get(outputHash);
+            expect(outputNode?.payload).toEqual({
+                $status: "needs_input",
+                question: "Which API?",
+            });
+            const { createUwfStore, getThread } = await import("../store.js");
+            const uwf = await createUwfStore(tmpDir);
+            const threadEntry = getThread(uwf.varStore, threadId);
+            expect(threadEntry).toEqual({
+                head: stepHash,
+                status: "suspended",
+                suspendedRole: "worker",
+                suspendMessage: "Please clarify: Which API?",
+                completedAt: null,
+            });
+            const showResult = await cmdThreadShow(tmpDir, threadId);
+            expect(showResult.status).toBe("suspended");
+            expect(showResult.suspendMessage).toBe("Please clarify: Which API?");
+            expect(showResult.suspendedRole).toBe("worker");
+        }
+        finally {
+            if (originalCasDir === undefined) {
+                delete process.env.OCAS_HOME;
+            }
+            else {
+                process.env.OCAS_HOME = originalCasDir;
+            }
+        }
+    });
+});
+//# sourceMappingURL=thread-suspend-step.test.js.map