@barnum/barnum 0.0.0-main-bbc76251 → 0.0.0-main-9a5106ee

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import type { TaggedUnion, OptionDef, ResultDef } from "./ast.js";
 export * from "./ast.js";
 export { constant, identity, drop, tag, merge, flatten, extractField, extractIndex, pick, dropResult, withResource, augment, tap, range, Option, Result, } from "./builtins.js";
 export * from "./handler.js";
-export { runPipeline } from "./run.js";
+export { runPipeline, type RunPipelineOptions, type LogLevel } from "./run.js";
 export { zodToCheckedJsonSchema } from "./schema.js";
 export type Option<T> = TaggedUnion<OptionDef<T>>;
 export type Result<TValue, TError> = TaggedUnion<ResultDef<TValue, TError>>;

package/dist/run.d.ts

@@ -3,5 +3,11 @@
  * script, then spawns the workflow as a subprocess.
  */
 import type { Action, ExtractOutput } from "./ast.js";
+/** Log verbosity for the barnum engine runtime. Passed to the CLI's `--log-level`. */
+export type LogLevel = "off" | "error" | "warn" | "info" | "debug" | "trace";
+export interface RunPipelineOptions {
+    /** Engine log verbosity. Default: "off" (only handler stderr is visible). */
+    logLevel?: LogLevel;
+}
 /** Run a pipeline to completion. Returns the workflow's final output value. */
-export declare function runPipeline<TPipeline extends Action>(pipeline: TPipeline, input?: unknown): Promise<ExtractOutput<TPipeline>>;
+export declare function runPipeline<TPipeline extends Action>(pipeline: TPipeline, input?: unknown, options?: RunPipelineOptions): Promise<ExtractOutput<TPipeline>>;

package/dist/run.js

@@ -88,14 +88,14 @@ function buildBinary() {
     });
 }
 /** Run a pipeline to completion. Returns the workflow's final output value. */
-export function runPipeline(pipeline, input) {
+export function runPipeline(pipeline, input, options) {
     const workflow = input === undefined
         ? pipeline
         : chain(constant(input), pipeline);
-    return spawnBarnum({ workflow });
+    return spawnBarnum({ workflow }, options?.logLevel);
 }
 /** Spawn the barnum CLI with the given config. Returns the parsed final value from stdout. */
-function spawnBarnum(config) {
+function spawnBarnum(config, logLevel) {
     const binaryResolution = resolveBinary();
     if (binaryResolution.kind === "Local") {
         buildBinary();
@@ -103,16 +103,20 @@ function spawnBarnum(config) {
     const executor = resolveExecutor();
     const worker = resolveWorker();
     const configJson = JSON.stringify(config);
+    const cliArgs = [
+        "run",
+        "--config",
+        configJson,
+        "--executor",
+        executor,
+        "--worker",
+        worker,
+    ];
+    if (logLevel) {
+        cliArgs.push("--log-level", logLevel);
+    }
     return new Promise((resolve, reject) => {
-        const child = nodeSpawn(binaryResolution.path, [
-            "run",
-            "--config",
-            configJson,
-            "--executor",
-            executor,
-            "--worker",
-            worker,
-        ], {
+        const child = nodeSpawn(binaryResolution.path, cliArgs, {
             stdio: ["inherit", "pipe", "inherit"],
         });
         const stdoutChunks = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barnum/barnum",
-  "version": "0.0.0-main-bbc76251",
+  "version": "0.0.0-main-9a5106ee",
   "description": "Barnum workflow engine",
   "type": "module",
   "main": "dist/index.js",
@@ -51,7 +51,7 @@
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"
   },
-  "dependencies": {
+  "peerDependencies": {
     "zod": "^4.3.6"
   }
 }

package/src/index.ts

@@ -20,7 +20,7 @@ export {
   Result,
 } from "./builtins.js";
 export * from "./handler.js";
-export { runPipeline } from "./run.js";
+export { runPipeline, type RunPipelineOptions, type LogLevel } from "./run.js";
 export { zodToCheckedJsonSchema } from "./schema.js";
 
 // Declaration merge: the explicit value exports of Option/Result from builtins

package/src/run.ts

@@ -12,6 +12,14 @@ import type { Action, Config, ExtractOutput, Pipeable } from "./ast.js";
 import { chain } from "./chain.js";
 import { constant } from "./builtins.js";
 
+/** Log verbosity for the barnum engine runtime. Passed to the CLI's `--log-level`. */
+export type LogLevel = "off" | "error" | "warn" | "info" | "debug" | "trace";
+
+export interface RunPipelineOptions {
+  /** Engine log verbosity. Default: "off" (only handler stderr is visible). */
+  logLevel?: LogLevel;
+}
+
 const __dirname = import.meta.dirname;
 
 /** Resolve the TypeScript executor. Uses bun if the workflow was launched with bun, otherwise tsx. */
@@ -114,16 +122,17 @@ function buildBinary(): void {
 export function runPipeline<TPipeline extends Action>(
   pipeline: TPipeline,
   input?: unknown,
+  options?: RunPipelineOptions,
 ): Promise<ExtractOutput<TPipeline>> {
   const workflow =
     input === undefined
       ? pipeline
       : (chain(constant(input) as Pipeable, pipeline as Pipeable) as Action);
-  return spawnBarnum({ workflow });
+  return spawnBarnum({ workflow }, options?.logLevel);
 }
 
 /** Spawn the barnum CLI with the given config. Returns the parsed final value from stdout. */
-function spawnBarnum<TOut>(config: Config): Promise<TOut> {
+function spawnBarnum<TOut>(config: Config, logLevel?: LogLevel): Promise<TOut> {
   const binaryResolution = resolveBinary();
   if (binaryResolution.kind === "Local") {
     buildBinary();
@@ -132,22 +141,23 @@ function spawnBarnum<TOut>(config: Config): Promise<TOut> {
   const worker = resolveWorker();
   const configJson = JSON.stringify(config);
 
+  const cliArgs = [
+    "run",
+    "--config",
+    configJson,
+    "--executor",
+    executor,
+    "--worker",
+    worker,
+  ];
+  if (logLevel) {
+    cliArgs.push("--log-level", logLevel);
+  }
+
   return new Promise<TOut>((resolve, reject) => {
-    const child = nodeSpawn(
-      binaryResolution.path,
-      [
-        "run",
-        "--config",
-        configJson,
-        "--executor",
-        executor,
-        "--worker",
-        worker,
-      ],
-      {
-        stdio: ["inherit", "pipe", "inherit"],
-      },
-    );
+    const child = nodeSpawn(binaryResolution.path, cliArgs, {
+      stdio: ["inherit", "pipe", "inherit"],
+    });
 
     const stdoutChunks: Buffer[] = [];