skein-js 0.9.0 → 0.9.1

package/README.md

@@ -67,15 +67,22 @@ any layer. Public-registry builds don't need it.
 
 ## `skein dev` flags
 
-| Flag               | Values               | Default     | Notes                                                          |
-| ------------------ | -------------------- | ----------- | -------------------------------------------------------------- |
-| `-p, --port`       | number               | `2024`      | Port to listen on.                                             |
-| `--host`           | host                 | `127.0.0.1` | Interface to bind.                                             |
-| `--store <driver>` | `memory`, `postgres` | `memory`    | `postgres` reads `POSTGRES_URI`; also selects `PostgresSaver`. |
-| `--queue <driver>` | `memory`, `redis`    | `memory`    | `redis` reads `REDIS_URI` (BullMQ queue + Redis Streams bus).  |
-| `--no-persist`     | —                    | persists    | Don't snapshot dev state to `.skein/` across restarts.         |
-| `--no-reload`      | —                    | reloads     | Disable hot reload on source change.                           |
-| `-v, --verbose`    | —                    | off         | Log per-run activity (tool calls, interrupts, timing).         |
+| Flag                      | Values               | Default     | Notes                                                          |
+| ------------------------- | -------------------- | ----------- | -------------------------------------------------------------- |
+| `-p, --port`              | number               | `2024`      | Port to listen on.                                             |
+| `--host`                  | host                 | `127.0.0.1` | Interface to bind.                                             |
+| `--store <driver>`        | `memory`, `postgres` | `memory`    | `postgres` reads `POSTGRES_URI`; also selects `PostgresSaver`. |
+| `--queue <driver>`        | `memory`, `redis`    | `memory`    | `redis` reads `REDIS_URI` (BullMQ queue + Redis Streams bus).  |
+| `--concurrency`           | number               | `10`        | Queued runs the background worker executes at once.            |
+| `-n, --n-jobs-per-worker` | number               | `10`        | LangGraph-compatible alias for `--concurrency`.                |
+| `--no-persist`            | —                    | persists    | Don't snapshot dev state to `.skein/` across restarts.         |
+| `--no-reload`             | —                    | reloads     | Disable hot reload on source change.                           |
+| `-v, --verbose`           | —                    | off         | Log per-run activity (tool calls, interrupts, timing).         |
+
+`--store`, `--queue`, `--concurrency`, and `-n, --n-jobs-per-worker` are accepted by `skein start`
+too. Concurrency also reads `SKEIN_RUN_CONCURRENCY` (or `N_JOBS_PER_WORKER`) when no flag is passed —
+the path that reaches a container. See
+[runs-and-redis.md](../../docs/runs-and-redis.md#run-concurrency).
 
 `skein dev --store postgres --queue redis` is a capability the LangGraph CLI does **not** offer: it
 lets you develop against **production-shaped** storage (durable Postgres checkpoints, pgvector

package/dist/index.js

@@ -14,6 +14,7 @@ import {
   readLanggraphDevState
 } from "@skein-js/express";
 import { buildRuntime } from "@skein-js/runtime";
+import { resolveRunConcurrency } from "@skein-js/server-kit";
 
 // src/colors.ts
 var colorEnabled = process.stdout.isTTY === true && process.env.NO_COLOR === void 0;
@@ -27,7 +28,7 @@ var dim = paint(2);
 
 // src/banner.ts
 function printBanner(info, logger2) {
-  const { host, port, graphIds, authPath, workerCount } = info;
+  const { host, port, graphIds, authPath, runConcurrency } = info;
   const base = `http://${host}:${port}`;
   console.log();
   console.log(`${bold(green("skein"))} ${dim("\xB7 Agent Protocol dev server")}`);
@@ -37,7 +38,9 @@ function printBanner(info, logger2) {
   console.log();
   for (const id of graphIds) logger2.info(`Registering graph with id '${id}'`);
   if (authPath) logger2.info(`Loading auth from ${authPath}`);
-  logger2.info(`Starting ${workerCount} worker${workerCount === 1 ? "" : "s"}`);
+  logger2.info(
+    runConcurrency === 1 ? "Starting 1 worker" : `Starting 1 worker, up to ${runConcurrency} concurrent runs`
+  );
   logger2.info(`Server running at ${base}`);
 }
 
@@ -225,6 +228,7 @@ async function runDev(options) {
   });
   const port = options.portExplicit ? options.port : envPort(options.port);
   const host = options.hostExplicit ? options.host : envHost(options.host);
+  const runConcurrency = resolveRunConcurrency(options.concurrency ?? options.nJobsPerWorker);
   const canPersist = options.persist && runtime.snapshotState !== void 0;
   if (options.persist && runtime.snapshotState === void 0) {
     console.log(
@@ -263,7 +267,8 @@ async function runDev(options) {
       deps: runtime.deps,
       cors: runtime.cors,
       warm: true,
-      logger: devLogger
+      logger: devLogger,
+      worker: { maxConcurrency: runConcurrency }
     });
     await server.listen(port, host);
   } catch (error) {
@@ -278,7 +283,7 @@ async function runDev(options) {
       port,
       graphIds: runtime.deps.graphs.ids,
       authPath: config.auth?.path,
-      workerCount: 1
+      runConcurrency
     },
     devLogger
   );
@@ -925,6 +930,7 @@ import { createExpressServer as createExpressServer2 } from "@skein-js/express";
 import {
   buildRuntime as buildRuntime3
 } from "@skein-js/runtime";
+import { resolveRunConcurrency as resolveRunConcurrency2 } from "@skein-js/server-kit";
 var FORCE_EXIT_MS2 = 5e3;
 var logger = createDevLogger();
 function readBakedSchemas(configDir) {
@@ -941,11 +947,13 @@ async function runStart(options) {
   let schemas;
   let configDir;
   let authPath;
+  let runConcurrency;
   try {
     const loaded = await loadConfig5({ configPath });
     configDir = loaded.configDir;
     authPath = loaded.config.auth?.path;
     await applyProjectEnv(loaded.config, configDir);
+    runConcurrency = resolveRunConcurrency2(options.concurrency ?? options.nJobsPerWorker);
     schemas = readBakedSchemas(configDir);
   } catch (error) {
     console.error(`skein: ${error instanceof Error ? error.message : String(error)}`);
@@ -974,7 +982,8 @@ async function runStart(options) {
       deps: runtime.deps,
       cors: runtime.cors,
       warm: true,
-      logger
+      logger,
+      worker: { maxConcurrency: runConcurrency }
     });
     await server.listen(port, host);
   } catch (error) {
@@ -983,7 +992,7 @@ async function runStart(options) {
     process.exitCode = 1;
     return;
   }
-  printBanner({ host, port, graphIds: runtime.deps.graphs.ids, authPath, workerCount: 1 }, logger);
+  printBanner({ host, port, graphIds: runtime.deps.graphs.ids, authPath, runConcurrency }, logger);
   let shuttingDown = false;
   const shutdown = () => {
     if (shuttingDown) return;
@@ -1006,6 +1015,13 @@ function parsePort(value) {
   }
   return port;
 }
+function parseConcurrency(value) {
+  const concurrency = Number(value);
+  if (!Number.isInteger(concurrency) || concurrency <= 0) {
+    throw new InvalidArgumentError("Concurrency must be a positive integer.");
+  }
+  return concurrency;
+}
 function parseChoice(choices) {
   return (value) => {
     if (!choices.includes(value)) {
@@ -1019,14 +1035,30 @@ var parseQueue = parseChoice(["memory", "redis"]);
 var program = new Command().name("skein").description(
   "Agent Protocol server for LangGraph.js \u2014 a drop-in replacement for the LangGraph CLI."
 ).version(version, "-v, --version");
-program.command("dev").description("Run the in-process dev server with hot reload (no Docker).").option("-c, --config <path>", "Path to langgraph.json", "langgraph.json").option("-p, --port <port>", "Port to bind", parsePort, 2024).option("--host <host>", "Host to bind", "127.0.0.1").option("--no-reload", "Disable hot reload").option("--no-persist", "Don't persist dev state to .skein/ between restarts").option("--store <driver>", "Store driver: memory | postgres", parseStore, "memory").option("--queue <driver>", "Queue driver: memory | redis", parseQueue, "memory").option("-v, --verbose", "Log per-run activity: start/finish, tool calls, and interrupts").action(
+program.command("dev").description("Run the in-process dev server with hot reload (no Docker).").option("-c, --config <path>", "Path to langgraph.json", "langgraph.json").option("-p, --port <port>", "Port to bind", parsePort, 2024).option("--host <host>", "Host to bind", "127.0.0.1").option("--no-reload", "Disable hot reload").option("--no-persist", "Don't persist dev state to .skein/ between restarts").option("--store <driver>", "Store driver: memory | postgres", parseStore, "memory").option("--queue <driver>", "Queue driver: memory | redis", parseQueue, "memory").option(
+  "--concurrency <count>",
+  "Queued runs the background worker executes at once (default 10; env SKEIN_RUN_CONCURRENCY)",
+  parseConcurrency
+).option(
+  "-n, --n-jobs-per-worker <count>",
+  "Alias for --concurrency (LangGraph CLI compatibility)",
+  parseConcurrency
+).option("-v, --verbose", "Log per-run activity: start/finish, tool calls, and interrupts").action(
   (options, command) => runDev({
     ...options,
     portExplicit: command.getOptionValueSource("port") === "cli",
     hostExplicit: command.getOptionValueSource("host") === "cli"
   })
 );
-program.command("start").description("Serve a pre-built .skein/build artifact (the production image entrypoint).").option("-c, --config <path>", "Path to the artifact's langgraph.json", "langgraph.json").option("-p, --port <port>", "Port to bind", parsePort, 2024).option("--host <host>", "Host to bind", "127.0.0.1").option("--store <driver>", "Store driver: memory | postgres", parseStore, "memory").option("--queue <driver>", "Queue driver: memory | redis", parseQueue, "memory").option("-v, --verbose", "Log per-run activity: start/finish, tool calls, and interrupts").action(
+program.command("start").description("Serve a pre-built .skein/build artifact (the production image entrypoint).").option("-c, --config <path>", "Path to the artifact's langgraph.json", "langgraph.json").option("-p, --port <port>", "Port to bind", parsePort, 2024).option("--host <host>", "Host to bind", "127.0.0.1").option("--store <driver>", "Store driver: memory | postgres", parseStore, "memory").option("--queue <driver>", "Queue driver: memory | redis", parseQueue, "memory").option(
+  "--concurrency <count>",
+  "Queued runs the background worker executes at once (default 10; env SKEIN_RUN_CONCURRENCY)",
+  parseConcurrency
+).option(
+  "-n, --n-jobs-per-worker <count>",
+  "Alias for --concurrency (LangGraph CLI compatibility)",
+  parseConcurrency
+).option("-v, --verbose", "Log per-run activity: start/finish, tool calls, and interrupts").action(
   (options, command) => runStart({
     ...options,
     portExplicit: command.getOptionValueSource("port") === "cli",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skein-js",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "The skein-js CLI — a drop-in replacement for the LangGraph CLI (dev/up/build/dockerfile).",
   "license": "Apache-2.0",
   "author": "Maina Wycliffe <wmmaina7@gmail.com>",
@@ -47,10 +47,11 @@
     "@commander-js/extra-typings": "~13.1.0",
     "@langchain/langgraph-checkpoint-postgres": "^1.0.4",
     "commander": "~13.1.0",
-    "@skein-js/core": "0.9.0",
-    "@skein-js/config": "0.9.0",
-    "@skein-js/express": "0.9.0",
-    "@skein-js/runtime": "0.9.0"
+    "@skein-js/core": "0.9.1",
+    "@skein-js/express": "0.9.1",
+    "@skein-js/runtime": "0.9.1",
+    "@skein-js/server-kit": "0.9.1",
+    "@skein-js/config": "0.9.1"
   },
   "optionalDependencies": {
     "vite": "^8.1.0"