@growthub/cli 0.5.1 → 0.6.1

package/dist/__tests__/execute-hosted-pipeline.test.js

@@ -0,0 +1,131 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+const spinnerStart = vi.fn();
+const spinnerStop = vi.fn();
+const fetchHostedCreditsMock = vi.fn(async () => ({
+    totalAvailable: 34.5,
+    creditsUsedThisPeriod: 0.05,
+    creditsPerMonth: 100,
+}));
+const saveHostedWorkflowMock = vi.fn(async () => ({
+    workflowId: "b725dceb-1993-4af8-a1b2-75af9d348a00",
+}));
+const executeWorkflowMock = vi.fn(async (_input, opts) => {
+    await opts?.onEvent?.({ type: "node_start", nodeId: "node_e3480038977c" });
+    await opts?.onEvent?.({ type: "node_complete", nodeId: "node_e3480038977c" });
+    return {
+        executionId: "b725dceb-1993-4af8-a1b2-75af9d348a00",
+        threadId: "b725dceb-1993-4af8-a1b2-75af9d348a00",
+        status: "succeeded",
+        startedAt: "2026-04-14T05:00:00.000Z",
+        completedAt: "2026-04-14T05:00:36.000Z",
+        nodeResults: {
+            node_e3480038977c: {
+                slug: "image-generation",
+                status: "succeeded",
+            },
+        },
+        artifacts: [
+            { artifactId: "images/foo.png", artifactType: "image", nodeId: "node_e3480038977c" },
+        ],
+        summary: {
+            imageCount: 1,
+            workflowRunId: "f26e66be-5f4a-469c-85b6-ec49243f564c",
+            keyboardShortcutHint: "Open the full run in Growthub if you want the expanded UI view.",
+        },
+    };
+});
+vi.mock("@clack/prompts", () => ({
+    spinner: () => ({
+        start: spinnerStart,
+        stop: spinnerStop,
+    }),
+    log: { info: vi.fn(), error: vi.fn(), success: vi.fn() },
+    intro: vi.fn(),
+    note: vi.fn(),
+    select: vi.fn(),
+    confirm: vi.fn(),
+    text: vi.fn(),
+    multiselect: vi.fn(),
+    isCancel: () => false,
+}));
+vi.mock("../auth/session-store.js", () => ({
+    readSession: () => ({
+        hostedBaseUrl: "http://localhost:3000",
+        accessToken: "tok",
+        userId: "9dd7fa1b-1491-46da-962f-f2fe7342d013",
+        expiresAt: "2099-01-01T00:00:00.000Z",
+    }),
+    isSessionExpired: () => false,
+}));
+vi.mock("../auth/hosted-client.js", () => ({
+    fetchHostedCredits: fetchHostedCreditsMock,
+    saveHostedWorkflow: saveHostedWorkflowMock,
+    HostedEndpointUnavailableError: class HostedEndpointUnavailableError extends Error {
+    },
+}));
+vi.mock("../runtime/hosted-execution-client/index.js", () => ({
+    createHostedExecutionClient: () => ({
+        executeWorkflow: executeWorkflowMock,
+    }),
+}));
+const artifactCreateMock = vi.fn();
+vi.mock("../runtime/artifact-contracts/index.js", () => ({
+    createArtifactStore: () => ({
+        create: artifactCreateMock,
+    }),
+}));
+vi.mock("../auth/workflow-access.js", () => ({
+    getWorkflowAccess: () => ({ state: "ready", reason: "" }),
+}));
+vi.mock("../utils/banner.js", () => ({
+    printPaperclipCliBanner: vi.fn(),
+}));
+describe("executeHostedPipeline", () => {
+    const stdoutWrite = vi.spyOn(process.stdout, "write");
+    const consoleLog = vi.spyOn(console, "log").mockImplementation(() => { });
+    const originalIsTTY = process.stdout.isTTY;
+    beforeEach(() => {
+        spinnerStart.mockReset();
+        spinnerStop.mockReset();
+        fetchHostedCreditsMock.mockClear();
+        saveHostedWorkflowMock.mockClear();
+        executeWorkflowMock.mockClear();
+        stdoutWrite.mockClear();
+        consoleLog.mockClear();
+        Object.defineProperty(process.stdout, "isTTY", { value: true, configurable: true });
+    });
+    afterEach(() => {
+        Object.defineProperty(process.stdout, "isTTY", { value: originalIsTTY, configurable: true });
+    });
+    it("shows startup loading, progress, summary, and credits for hosted execution", async () => {
+        const { executeHostedPipeline } = await import("../commands/pipeline.js");
+        await executeHostedPipeline({
+            pipelineId: "pipe_d37338d337f40b76",
+            threadId: "b725dceb-1993-4af8-a1b2-75af9d348a00",
+            executionMode: "hosted",
+            nodes: [
+                {
+                    id: "node_e3480038977c",
+                    slug: "image-generation",
+                    bindings: {
+                        prompt: "Create a polished software product hero image.",
+                    },
+                },
+            ],
+            metadata: {
+                workflowName: "Image Generation Workflow",
+            },
+        });
+        expect(spinnerStart).toHaveBeenCalledWith("Preparing hosted workflow execution...");
+        expect(spinnerStop).toHaveBeenCalledWith("Hosted workflow execution started.");
+        const writes = stdoutWrite.mock.calls.map((call) => String(call[0]));
+        expect(writes.some((line) => line.includes("Workflow run"))).toBe(true);
+        expect(writes.some((line) => line.includes("100%"))).toBe(true);
+        const logs = consoleLog.mock.calls.map((call) => call.join(" "));
+        expect(logs.some((line) => line.includes("Pipeline Execution Result"))).toBe(true);
+        expect(logs.some((line) => line.includes("workflow_run_id: f26e66be-5f4a-469c-85b6-ec49243f564c"))).toBe(true);
+        expect(logs.some((line) => line.includes("Credits:"))).toBe(true);
+        expect(logs.some((line) => line.includes("available: $34.50"))).toBe(true);
+    });
+});
+//# sourceMappingURL=execute-hosted-pipeline.test.js.map

package/dist/__tests__/execute-hosted-pipeline.test.js.map

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

package/dist/__tests__/fork-policy.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Kit Fork Policy — Unit Tests
+ *
+ * Covers:
+ *   - default policy shape
+ *   - read/write round-trip against <forkPath>/.growthub-fork/policy.json
+ *   - updateKitForkPolicy patch semantics
+ *   - path evaluation helpers (isUntouchable, requiresConfirmation)
+ *   - autoApprove scope helpers
+ */
+export {};
+//# sourceMappingURL=fork-policy.test.d.ts.map

package/dist/__tests__/fork-policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-policy.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fork-policy.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/__tests__/fork-policy.test.js

@@ -0,0 +1,132 @@
+/**
+ * Kit Fork Policy — Unit Tests
+ *
+ * Covers:
+ *   - default policy shape
+ *   - read/write round-trip against <forkPath>/.growthub-fork/policy.json
+ *   - updateKitForkPolicy patch semantics
+ *   - path evaluation helpers (isUntouchable, requiresConfirmation)
+ *   - autoApprove scope helpers
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { readKitForkPolicy, writeKitForkPolicy, updateKitForkPolicy, makeDefaultKitForkPolicy, isUntouchable, requiresConfirmation, canAutoApplyAddition, canAutoApplyModification, canAutoApplyDepAddition, canAutoApplyDepUpgrade, } from "../kits/fork-policy.js";
+const ORIGINAL_ENV = { ...process.env };
+function makeForkDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), "fork-policy-"));
+}
+beforeEach(() => {
+    process.env = { ...ORIGINAL_ENV };
+});
+afterEach(() => {
+    process.env = { ...ORIGINAL_ENV };
+});
+describe("makeDefaultKitForkPolicy", () => {
+    it("is a safe conservative baseline", () => {
+        const p = makeDefaultKitForkPolicy();
+        expect(p.version).toBe(1);
+        expect(p.autoApprove).toBe("additive");
+        expect(p.autoApproveDepUpdates).toBe("additive");
+        expect(p.remoteSyncMode).toBe("off");
+        expect(p.interactiveConflicts).toBe(true);
+        expect(p.untouchablePaths).toEqual([]);
+        expect(p.confirmBeforeChange).toContain("package.json");
+        expect(p.confirmBeforeChange).toContain("kit.json");
+    });
+});
+describe("readKitForkPolicy", () => {
+    it("returns defaults when no policy.json exists", () => {
+        const dir = makeForkDir();
+        const p = readKitForkPolicy(dir);
+        expect(p.autoApprove).toBe("additive");
+    });
+    it("returns defaults on malformed JSON", () => {
+        const dir = makeForkDir();
+        fs.mkdirSync(path.resolve(dir, ".growthub-fork"), { recursive: true });
+        fs.writeFileSync(path.resolve(dir, ".growthub-fork", "policy.json"), "{not json}");
+        const p = readKitForkPolicy(dir);
+        expect(p.autoApprove).toBe("additive");
+    });
+});
+describe("writeKitForkPolicy + round-trip", () => {
+    it("persists at <forkPath>/.growthub-fork/policy.json", () => {
+        const dir = makeForkDir();
+        writeKitForkPolicy(dir, {
+            ...makeDefaultKitForkPolicy(),
+            autoApprove: "all",
+            untouchablePaths: ["custom/mine.md"],
+        });
+        const readBack = readKitForkPolicy(dir);
+        expect(readBack.autoApprove).toBe("all");
+        expect(readBack.untouchablePaths).toEqual(["custom/mine.md"]);
+        const onDisk = path.resolve(dir, ".growthub-fork", "policy.json");
+        expect(fs.existsSync(onDisk)).toBe(true);
+    });
+});
+describe("updateKitForkPolicy", () => {
+    it("patches specific fields and preserves the rest", () => {
+        const dir = makeForkDir();
+        writeKitForkPolicy(dir, { ...makeDefaultKitForkPolicy(), remoteSyncMode: "branch" });
+        const next = updateKitForkPolicy(dir, { remoteSyncMode: "pr" });
+        expect(next.remoteSyncMode).toBe("pr");
+        expect(next.autoApprove).toBe("additive"); // unchanged
+    });
+});
+describe("path evaluation helpers", () => {
+    const p = {
+        ...makeDefaultKitForkPolicy(),
+        untouchablePaths: ["custom", "skills/personal.md"],
+        confirmBeforeChange: ["package.json", "docs"],
+    };
+    it("isUntouchable matches exact paths and prefixes", () => {
+        expect(isUntouchable(p, "custom")).toBe(true);
+        expect(isUntouchable(p, "custom/foo.md")).toBe(true);
+        expect(isUntouchable(p, "skills/personal.md")).toBe(true);
+        expect(isUntouchable(p, "skills/other.md")).toBe(false);
+        expect(isUntouchable(p, "src/app.ts")).toBe(false);
+    });
+    it("requiresConfirmation matches exact paths and prefixes", () => {
+        expect(requiresConfirmation(p, "package.json")).toBe(true);
+        expect(requiresConfirmation(p, "docs/README.md")).toBe(true);
+        expect(requiresConfirmation(p, "src/index.ts")).toBe(false);
+    });
+    it("normalises leading/trailing slashes", () => {
+        expect(isUntouchable({ ...p, untouchablePaths: ["/custom/"] }, "custom/foo.md")).toBe(true);
+    });
+});
+describe("autoApprove scope helpers", () => {
+    it("additive auto-approves additions but not modifications", () => {
+        const p = { ...makeDefaultKitForkPolicy(), autoApprove: "additive" };
+        expect(canAutoApplyAddition(p)).toBe(true);
+        expect(canAutoApplyModification(p)).toBe(false);
+    });
+    it("all auto-approves everything", () => {
+        const p = { ...makeDefaultKitForkPolicy(), autoApprove: "all" };
+        expect(canAutoApplyAddition(p)).toBe(true);
+        expect(canAutoApplyModification(p)).toBe(true);
+    });
+    it("none blocks every category", () => {
+        const p = { ...makeDefaultKitForkPolicy(), autoApprove: "none" };
+        expect(canAutoApplyAddition(p)).toBe(false);
+        expect(canAutoApplyModification(p)).toBe(false);
+    });
+    it("dep-specific helpers are orthogonal to autoApprove", () => {
+        const p = {
+            ...makeDefaultKitForkPolicy(),
+            autoApprove: "none",
+            autoApproveDepUpdates: "additive",
+        };
+        expect(canAutoApplyDepAddition(p)).toBe(true);
+        expect(canAutoApplyDepUpgrade(p)).toBe(false);
+    });
+    it("dep 'all' unlocks upgrades", () => {
+        const p = {
+            ...makeDefaultKitForkPolicy(),
+            autoApproveDepUpdates: "all",
+        };
+        expect(canAutoApplyDepUpgrade(p)).toBe(true);
+    });
+});
+//# sourceMappingURL=fork-policy.test.js.map

package/dist/__tests__/fork-policy.test.js.map

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

package/dist/__tests__/fork-trace.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Kit Fork Trace — Unit Tests
+ *
+ * Covers:
+ *   - appendKitForkTraceEvent writes JSONL into <forkPath>/.growthub-fork/trace.jsonl
+ *   - readKitForkTrace deserialises every line
+ *   - malformed lines are tolerated, not thrown
+ *   - tailKitForkTrace returns the last N events in order
+ *   - timestamps are auto-populated when not supplied
+ */
+export {};
+//# sourceMappingURL=fork-trace.test.d.ts.map

package/dist/__tests__/fork-trace.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-trace.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fork-trace.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/__tests__/fork-trace.test.js

@@ -0,0 +1,90 @@
+/**
+ * Kit Fork Trace — Unit Tests
+ *
+ * Covers:
+ *   - appendKitForkTraceEvent writes JSONL into <forkPath>/.growthub-fork/trace.jsonl
+ *   - readKitForkTrace deserialises every line
+ *   - malformed lines are tolerated, not thrown
+ *   - tailKitForkTrace returns the last N events in order
+ *   - timestamps are auto-populated when not supplied
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { appendKitForkTraceEvent, readKitForkTrace, tailKitForkTrace, } from "../kits/fork-trace.js";
+function makeForkDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), "fork-trace-"));
+}
+describe("appendKitForkTraceEvent", () => {
+    it("writes a JSONL line at <forkPath>/.growthub-fork/trace.jsonl", () => {
+        const dir = makeForkDir();
+        const event = appendKitForkTraceEvent(dir, {
+            forkId: "fork-a",
+            kitId: "creative-strategist-v1",
+            type: "registered",
+            summary: "Test registration",
+        });
+        expect(event.timestamp).toBeTruthy();
+        const p = path.resolve(dir, ".growthub-fork", "trace.jsonl");
+        expect(fs.existsSync(p)).toBe(true);
+        const contents = fs.readFileSync(p, "utf8");
+        expect(contents.endsWith("\n")).toBe(true);
+        expect(contents.split("\n").filter(Boolean)).toHaveLength(1);
+    });
+    it("honours a supplied timestamp when given", () => {
+        const dir = makeForkDir();
+        const ts = "2024-01-01T00:00:00.000Z";
+        const event = appendKitForkTraceEvent(dir, {
+            forkId: "fork-a", kitId: "creative-strategist-v1",
+            type: "heal_applied", summary: "test", timestamp: ts,
+        });
+        expect(event.timestamp).toBe(ts);
+    });
+    it("appends rather than overwrites", () => {
+        const dir = makeForkDir();
+        appendKitForkTraceEvent(dir, { forkId: "x", kitId: "y", type: "status_ran", summary: "one" });
+        appendKitForkTraceEvent(dir, { forkId: "x", kitId: "y", type: "status_ran", summary: "two" });
+        const events = readKitForkTrace(dir);
+        expect(events).toHaveLength(2);
+        expect(events[0].summary).toBe("one");
+        expect(events[1].summary).toBe("two");
+    });
+});
+describe("readKitForkTrace", () => {
+    it("returns [] when trace.jsonl does not exist", () => {
+        const dir = makeForkDir();
+        expect(readKitForkTrace(dir)).toEqual([]);
+    });
+    it("tolerates malformed lines without throwing", () => {
+        const dir = makeForkDir();
+        const p = path.resolve(dir, ".growthub-fork", "trace.jsonl");
+        fs.mkdirSync(path.dirname(p), { recursive: true });
+        fs.writeFileSync(p, [
+            JSON.stringify({ timestamp: "t", forkId: "a", kitId: "b", type: "registered", summary: "ok" }),
+            "this is not json",
+            "",
+            JSON.stringify({ timestamp: "t2", forkId: "a", kitId: "b", type: "status_ran", summary: "still ok" }),
+        ].join("\n") + "\n");
+        const events = readKitForkTrace(dir);
+        expect(events).toHaveLength(2);
+        expect(events[0].summary).toBe("ok");
+        expect(events[1].summary).toBe("still ok");
+    });
+});
+describe("tailKitForkTrace", () => {
+    it("returns the last N events in original order", () => {
+        const dir = makeForkDir();
+        for (const summary of ["a", "b", "c", "d", "e"]) {
+            appendKitForkTraceEvent(dir, { forkId: "x", kitId: "y", type: "status_ran", summary });
+        }
+        const last3 = tailKitForkTrace(dir, 3);
+        expect(last3.map((e) => e.summary)).toEqual(["c", "d", "e"]);
+    });
+    it("returns all events when N > total", () => {
+        const dir = makeForkDir();
+        appendKitForkTraceEvent(dir, { forkId: "x", kitId: "y", type: "status_ran", summary: "only" });
+        expect(tailKitForkTrace(dir, 100).map((e) => e.summary)).toEqual(["only"]);
+    });
+});
+//# sourceMappingURL=fork-trace.test.js.map

package/dist/__tests__/fork-trace.test.js.map

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

package/dist/__tests__/home-paths.test.d.ts

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

package/dist/__tests__/home-paths.test.d.ts.map

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

package/dist/__tests__/home-paths.test.js

@@ -0,0 +1,32 @@
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { describeLocalInstancePaths, expandHomePrefix, resolvePaperclipHomeDir, resolvePaperclipInstanceId, } from "../config/home.js";
+const ORIGINAL_ENV = { ...process.env };
+describe("home path resolution", () => {
+    afterEach(() => {
+        process.env = { ...ORIGINAL_ENV };
+    });
+    it("defaults to ~/.paperclip and default instance", () => {
+        delete process.env.PAPERCLIP_HOME;
+        delete process.env.PAPERCLIP_INSTANCE_ID;
+        const paths = describeLocalInstancePaths();
+        expect(paths.homeDir).toBe(path.resolve(os.homedir(), ".paperclip"));
+        expect(paths.instanceId).toBe("default");
+        expect(paths.configPath).toBe(path.resolve(os.homedir(), ".paperclip", "instances", "default", "config.json"));
+    });
+    it("supports PAPERCLIP_HOME and explicit instance ids", () => {
+        process.env.PAPERCLIP_HOME = "~/paperclip-home";
+        const home = resolvePaperclipHomeDir();
+        expect(home).toBe(path.resolve(os.homedir(), "paperclip-home"));
+        expect(resolvePaperclipInstanceId("dev_1")).toBe("dev_1");
+    });
+    it("rejects invalid instance ids", () => {
+        expect(() => resolvePaperclipInstanceId("bad/id")).toThrow(/Invalid instance id/);
+    });
+    it("expands ~ prefixes", () => {
+        expect(expandHomePrefix("~")).toBe(os.homedir());
+        expect(expandHomePrefix("~/x/y")).toBe(path.resolve(os.homedir(), "x/y"));
+    });
+});
+//# sourceMappingURL=home-paths.test.js.map

package/dist/__tests__/home-paths.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-paths.test.js","sourceRoot":"","sources":["../../src/__tests__/home-paths.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,YAAY,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAExC,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAClC,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;QAEzC,MAAM,KAAK,GAAG,0BAA0B,EAAE,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IACjH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,kBAAkB,CAAC;QAEhD,MAAM,IAAI,GAAG,uBAAuB,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,GAAG,EAAE,CAAC,0BAA0B,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/hosted-execution-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hosted-execution-client.test.d.ts.map

package/dist/__tests__/hosted-execution-client.test.d.ts.map

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

package/dist/__tests__/hosted-execution-client.test.js

@@ -0,0 +1,100 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("../auth/session-store.js", () => ({
+    readSession: () => ({
+        hostedBaseUrl: "http://localhost:3000",
+        accessToken: "tok",
+        userId: "9dd7fa1b-1491-46da-962f-f2fe7342d013",
+        expiresAt: "2099-01-01T00:00:00.000Z",
+    }),
+    isSessionExpired: () => false,
+}));
+vi.mock("../auth/overlay-store.js", () => ({
+    readHostedOverlay: () => null,
+}));
+vi.mock("../client/http.js", () => ({
+    PaperclipApiClient: class PaperclipApiClient {
+        async get() {
+            return {};
+        }
+        async post() {
+            return {};
+        }
+    },
+    ApiRequestError: class ApiRequestError extends Error {
+        status;
+        constructor(status, message = "error") {
+            super(message);
+            this.status = status;
+        }
+    },
+}));
+describe("hosted execution client", () => {
+    const fetchMock = vi.fn();
+    beforeEach(() => {
+        fetchMock.mockReset();
+        vi.stubGlobal("fetch", fetchMock);
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it("sanitizes placeholder bindings and infers a real user prompt for hosted execution", async () => {
+        let requestBody = null;
+        const stream = new ReadableStream({
+            start(controller) {
+                controller.enqueue(new TextEncoder().encode(`${JSON.stringify({
+                    type: "complete",
+                    executionId: "b725dceb-1993-4af8-a1b2-75af9d348a00",
+                    executionLog: [
+                        { nodeId: "start-1", type: "start", output: "Workflow started" },
+                        {
+                            nodeId: "node_img_1",
+                            type: "cmsNode",
+                            output: {
+                                thread_id: "b725dceb-1993-4af8-a1b2-75af9d348a00",
+                                images: [{ url: "/api/secure-image?path=file.png" }],
+                                ui_message_parts: [{ type: "text", text: "MCP tool execution complete." }],
+                            },
+                        },
+                        { nodeId: "end-1", type: "end", output: { finalOutput: { ok: true } } },
+                    ],
+                })}\n`));
+                controller.close();
+            },
+        });
+        fetchMock.mockImplementation(async (_input, init) => {
+            requestBody = JSON.parse(String(init?.body ?? "{}"));
+            return new Response(stream, {
+                status: 200,
+                headers: { "content-type": "text/plain" },
+            });
+        });
+        const { createHostedExecutionClient } = await import("../runtime/hosted-execution-client/index.js");
+        const client = createHostedExecutionClient();
+        await client.executeWorkflow({
+            pipelineId: "pipe_d37338d337f40b76",
+            workflowId: "b725dceb-1993-4af8-a1b2-75af9d348a00",
+            threadId: "b725dceb-1993-4af8-a1b2-75af9d348a00",
+            executionMode: "hosted",
+            metadata: {},
+            nodes: [
+                {
+                    nodeId: "node_img_1",
+                    slug: "image-generation",
+                    bindings: {
+                        prompt: "Create a polished software product hero image.",
+                        brandKitId: "Enter brandKitId",
+                        referenceImages: [{ url: "file:///Users/antonio/Desktop/ref.png", type: "reference" }],
+                    },
+                },
+            ],
+        });
+        expect(requestBody?.userPrompt).toBe("Create a polished software product hero image.");
+        const cmsNode = (requestBody?.nodes)[1];
+        expect(cmsNode.data.inputs).toMatchObject({
+            prompt: "Create a polished software product hero image.",
+            brandKitId: "",
+            referenceImages: [{ url: "file:///Users/antonio/Desktop/ref.png", type: "reference" }],
+        });
+    });
+});
+//# sourceMappingURL=hosted-execution-client.test.js.map

package/dist/__tests__/hosted-execution-client.test.js.map

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

package/dist/__tests__/http.test.d.ts

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

package/dist/__tests__/http.test.d.ts.map

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

package/dist/__tests__/http.test.js

@@ -0,0 +1,42 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { PaperclipApiClient } from "../client/http.js";
+describe("PaperclipApiClient", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("adds authorization and run-id headers", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(new Response(JSON.stringify({ ok: true }), { status: 200 }));
+        vi.stubGlobal("fetch", fetchMock);
+        const client = new PaperclipApiClient({
+            apiBase: "http://localhost:3100",
+            apiKey: "token-123",
+            runId: "run-abc",
+        });
+        await client.post("/api/test", { hello: "world" });
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const call = fetchMock.mock.calls[0];
+        expect(call[0]).toContain("/api/test");
+        const headers = call[1].headers;
+        expect(headers.authorization).toBe("Bearer token-123");
+        expect(headers["x-paperclip-run-id"]).toBe("run-abc");
+        expect(headers["content-type"]).toBe("application/json");
+    });
+    it("returns null on ignoreNotFound", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(new Response(JSON.stringify({ error: "Not found" }), { status: 404 }));
+        vi.stubGlobal("fetch", fetchMock);
+        const client = new PaperclipApiClient({ apiBase: "http://localhost:3100" });
+        const result = await client.get("/api/missing", { ignoreNotFound: true });
+        expect(result).toBeNull();
+    });
+    it("throws ApiRequestError with details", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(new Response(JSON.stringify({ error: "Issue checkout conflict", details: { issueId: "1" } }), { status: 409 }));
+        vi.stubGlobal("fetch", fetchMock);
+        const client = new PaperclipApiClient({ apiBase: "http://localhost:3100" });
+        await expect(client.post("/api/issues/1/checkout", {})).rejects.toMatchObject({
+            status: 409,
+            message: "Issue checkout conflict",
+            details: { issueId: "1" },
+        });
+    });
+});
+//# sourceMappingURL=http.test.js.map