@pylonsync/functions 0.22.34 → 0.22.38

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Campbell Venture Studio, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -19,7 +19,7 @@
  */
 export { query, mutation, action } from "./define";
 export { v } from "./validators";
-export { workflow } from "./workflows";
+export { isWorkflowSignal, workflow } from "./workflows";
 export type { RawResponse, RawResponseInit } from "./response";
 export { agent, isAgentDefinition, validatorToJsonSchema, validatorSchemaToJsonSchema, } from "./agent";
 export type { AgentDefinition, AgentTool, AgentToolRun, AgentCallArgs, AgentResult, } from "./agent";

package/dist/workflows.d.ts

@@ -137,6 +137,17 @@ export declare function workflow<TInput = unknown>(name: string, fn: (wf: Workfl
 }): WorkflowDefinition<TInput>;
 /** Runtime shape check for a `workflows/` file's default export. */
 export declare function isWorkflowDefinition(v: unknown): v is WorkflowDefinition;
+/**
+ * Whether `err` is the engine pausing the workflow (a slice boundary or a
+ * wait), not a failure. A `try`/`catch` around steps in a workflow body must
+ * rethrow these untouched, or the workflow treats every pause as a crash:
+ *
+ *   catch (err) {
+ *     if (isWorkflowSignal(err)) throw err;
+ *     // real failure handling
+ *   }
+ */
+export declare function isWorkflowSignal(err: unknown): boolean;
 /**
  * Execute one slice of `def` for `request`, returning the engine verdict.
  * Never throws for handler errors — a step failure becomes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pylonsync/functions",
-  "version": "0.22.34",
+  "version": "0.22.38",
   "description": "TypeScript function runtime for pylon — defines server-side queries, mutations, and actions.",
   "type": "module",
   "main": "src/index.ts",
@@ -30,7 +30,8 @@
     "src",
     "dist",
     "assets",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "check": "tsc --noEmit",
@@ -45,7 +46,7 @@
     "functions",
     "database"
   ],
-  "license": "MIT OR Apache-2.0",
+  "license": "MIT",
   "dependencies": {
     "satori": "^0.26.0",
     "@resvg/resvg-wasm": "^2.6.2",

package/src/index.ts

@@ -20,7 +20,7 @@
 
 export { query, mutation, action } from "./define";
 export { v } from "./validators";
-export { workflow } from "./workflows";
+export { isWorkflowSignal, workflow } from "./workflows";
 export type { RawResponse, RawResponseInit } from "./response";
 export {
   agent,

package/src/workflows.test.ts

@@ -15,6 +15,7 @@ import { describe, expect, test } from "bun:test";
 import {
   executeWorkflowSlice,
   isWorkflowDefinition,
+  isWorkflowSignal,
   workflow,
   type WorkflowRunRequest,
   type WorkflowStepResult,
@@ -264,3 +265,41 @@ describe("executeWorkflowSlice", () => {
     expect(res).toEqual({ action: "complete", output: { echoed: 42 } });
   });
 });
+
+describe("catching errors around steps", () => {
+  test("a pause is a workflow signal, not a failure, when the body catches it", async () => {
+    const failures: unknown[] = [];
+    const guarded = workflow("guarded", async (wf) => {
+      try {
+        await wf.step("one", () => 1);
+        await wf.step("two", () => 2);
+        return { ok: true };
+      } catch (err) {
+        if (isWorkflowSignal(err)) throw err;
+        failures.push(err);
+        throw err;
+      }
+    });
+    // Slice 0 runs step one and pauses at step two's boundary.
+    const res = await executeWorkflowSlice(guarded, req(0, []), ctx);
+    expect(res).toMatchObject({ action: "step_complete", step_name: "one" });
+    expect(failures).toEqual([]);
+  });
+
+  test("without the check, the body sees the pause as an error (the bug the helper prevents)", async () => {
+    const seen: string[] = [];
+    const careless = workflow("careless", async (wf) => {
+      try {
+        await wf.step("one", () => 1);
+        await wf.step("two", () => 2);
+      } catch (err) {
+        seen.push((err as Error).message);
+        throw err;
+      }
+    });
+    await executeWorkflowSlice(careless, req(0, []), ctx);
+    expect(seen).toEqual(["slice boundary"]);
+    expect(isWorkflowSignal(new Error("slice boundary"))).toBe(false);
+  });
+});
+

package/src/workflows.ts

@@ -178,6 +178,20 @@ class SliceBoundary extends Error {
   }
 }
 
+/**
+ * Whether `err` is the engine pausing the workflow (a slice boundary or a
+ * wait), not a failure. A `try`/`catch` around steps in a workflow body must
+ * rethrow these untouched, or the workflow treats every pause as a crash:
+ *
+ *   catch (err) {
+ *     if (isWorkflowSignal(err)) throw err;
+ *     // real failure handling
+ *   }
+ */
+export function isWorkflowSignal(err: unknown): boolean {
+  return err instanceof SliceBoundary || err instanceof WorkflowPaused;
+}
+
 /**
  * Execute one slice of `def` for `request`, returning the engine verdict.
  * Never throws for handler errors — a step failure becomes