@skein-js/agent-protocol 0.9.0 → 0.9.1

package/README.md

@@ -102,7 +102,10 @@ Graph **state, history, and interrupt/resume are 100% LangGraph-native** via the
 
 - **Entry points:** `createProtocolRuntime(deps, options?)` → `{ service, handlers, worker }`;
   `createProtocolService` / `createProtocolServiceFromContext`; `createProtocolHandlers`; `createContext`;
-  `createRunWorker(ctx, options?)` (`RunWorkerOptions`: `maxConcurrency`, `shutdownGraceMs`).
+  `createRunWorker(ctx, options?)` (`RunWorkerOptions`: `maxConcurrency` — queued runs at once,
+  default `DEFAULT_RUN_CONCURRENCY` (10, matching the LangGraph CLI) — and `shutdownGraceMs`). The
+  adapters surface this as `worker.maxConcurrency` and also read `SKEIN_RUN_CONCURRENCY` /
+  `N_JOBS_PER_WORKER`; see [runs-and-redis.md](../../docs/runs-and-redis.md#run-concurrency).
 - **Service surface** (`runtime.service`): `assistants` (`registerGraphAssistants`, `get`, `list`,
   `search`, `schemas`), `threads` (`create`/`get`/`list`/`patch`/`delete`/`history`/`getState`),
   `threadStream` (`stream` / `joinStream` / `command` — HIL resume, requires status `interrupted`),

package/dist/index.d.ts

@@ -436,8 +436,19 @@ interface ProtocolHandlers {
 }
 declare function createProtocolHandlers(service: ProtocolService): ProtocolHandlers;
 
+/**
+ * Queued runs one worker executes at once when nothing is configured. Matches the LangGraph CLI's
+ * `--n-jobs-per-worker` default, so a project moving off `langgraph dev` keeps its throughput.
+ */
+declare const DEFAULT_RUN_CONCURRENCY = 10;
 interface RunWorkerOptions {
-    /** Max runs executing at once. Default 1 — strict per-thread serialization in dev. */
+    /**
+     * Max queued runs this worker executes at once. Default {@link DEFAULT_RUN_CONCURRENCY}.
+     * Per-thread ordering does not depend on this: `startRunExecution` serializes by `thread_id` at
+     * every value. The trade-off is head-of-line blocking — a run waiting on a busy thread's lock
+     * still holds a slot, so a burst of `multitask_strategy: "enqueue"` runs on one thread can occupy
+     * the worker. See docs/runs-and-redis.md.
+     */
     maxConcurrency?: number;
     /** How long `stop()` waits for in-flight runs before aborting them (ms). Default 5000. */
     shutdownGraceMs?: number;
@@ -452,7 +463,7 @@ declare function createRunWorker(ctx: ProtocolContext, options?: RunWorkerOption
 
 /** Options for {@link createProtocolRuntime}. */
 interface ProtocolRuntimeOptions {
-    /** Tuning for the background run worker (concurrency, poll interval). */
+    /** Tuning for the background run worker (max concurrency, shutdown grace period). */
     worker?: RunWorkerOptions;
 }
 /** The wired engine: the service, the transport-neutral handler table, and the background worker. */
@@ -602,4 +613,4 @@ declare function toSseEvents(frames: AsyncIterable<RunFrame>, finalStatus: () =>
  */
 declare function parseAfterSeq(lastEventId: string | undefined): number;
 
-export { type AssistantService, type Clock, type CommandInput, type CompiledGraphFactory, type CreateAssistantInput, type CreateRunInput, type CreateThreadInput, DEFAULT_INVOKE_PREFIX, type DeleteAssistantOptions, type DrawGraphOptions, type GraphInvokeHandlerName, type GraphInvokeOptions, type GraphResolver, type GraphSchemas, type HistoryOptions, type HttpMethod, type Logger, type PatchThreadInput, type ProtocolContext, type ProtocolDeps, type ProtocolHandler, type ProtocolHandlers, type ProtocolRequest, type ProtocolResponse, type ProtocolRuntime, type ProtocolRuntimeOptions, type ProtocolService, type ResolvedGraph, type RouteBinding, type RouteMatch, type RouteMatcher, type RunService, type RunWorker, type RunWorkerOptions, SSE_HEADERS, SkeinBaseStore, type StartedStream, type StoreService, type SubgraphsOptions, type ThreadService, type ThreadStreamInput, type ThreadStreamService, buildProtocolService, copyThreadIdIntoBody, createContext, createGraphInvokeHandler, createProtocolHandlers, createProtocolRuntime, createProtocolService, createProtocolServiceFromContext, createRouteMatcher, createRunWorker, encodeFrame, encodeTerminal, foldThreadId, graphInvokeRoutes, matchSkeinRoute, parseAfterSeq, skeinRoutes, toSseEvents };
+export { type AssistantService, type Clock, type CommandInput, type CompiledGraphFactory, type CreateAssistantInput, type CreateRunInput, type CreateThreadInput, DEFAULT_INVOKE_PREFIX, DEFAULT_RUN_CONCURRENCY, type DeleteAssistantOptions, type DrawGraphOptions, type GraphInvokeHandlerName, type GraphInvokeOptions, type GraphResolver, type GraphSchemas, type HistoryOptions, type HttpMethod, type Logger, type PatchThreadInput, type ProtocolContext, type ProtocolDeps, type ProtocolHandler, type ProtocolHandlers, type ProtocolRequest, type ProtocolResponse, type ProtocolRuntime, type ProtocolRuntimeOptions, type ProtocolService, type ResolvedGraph, type RouteBinding, type RouteMatch, type RouteMatcher, type RunService, type RunWorker, type RunWorkerOptions, SSE_HEADERS, SkeinBaseStore, type StartedStream, type StoreService, type SubgraphsOptions, type ThreadService, type ThreadStreamInput, type ThreadStreamService, buildProtocolService, copyThreadIdIntoBody, createContext, createGraphInvokeHandler, createProtocolHandlers, createProtocolRuntime, createProtocolService, createProtocolServiceFromContext, createRouteMatcher, createRunWorker, encodeFrame, encodeTerminal, foldThreadId, graphInvokeRoutes, matchSkeinRoute, parseAfterSeq, skeinRoutes, toSseEvents };

package/dist/index.js

@@ -2014,6 +2014,7 @@ function createAuthorizingHandlers(context, engine) {
 import {
   isTerminalRunStatus as isTerminalRunStatus6
 } from "@skein-js/core";
+var DEFAULT_RUN_CONCURRENCY = 10;
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function logRunLifecycle(logger, run, status, startedAt, endedAt) {
   logger.info(status === "success" ? "Background run succeeded" : `Background run ${status}`, {
@@ -2028,7 +2029,7 @@ function logRunLifecycle(logger, run, status, startedAt, endedAt) {
 }
 function createRunWorker(ctx, options = {}) {
   const { deps, control } = ctx;
-  const maxConcurrency = options.maxConcurrency ?? 1;
+  const maxConcurrency = options.maxConcurrency ?? DEFAULT_RUN_CONCURRENCY;
   const shutdownGraceMs = options.shutdownGraceMs ?? 5e3;
   const inFlight = /* @__PURE__ */ new Set();
   const process = async (queued) => {
@@ -2315,6 +2316,7 @@ function createGraphInvokeHandler(deps, options = {}) {
 }
 export {
   DEFAULT_INVOKE_PREFIX,
+  DEFAULT_RUN_CONCURRENCY,
   SSE_HEADERS,
   SkeinBaseStore,
   buildProtocolService,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skein-js/agent-protocol",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Framework-agnostic Agent Protocol engine for LangGraph.js — run engine, handlers, and SSE, driven entirely by injected dependencies.",
   "license": "Apache-2.0",
   "author": "Maina Wycliffe <wmmaina7@gmail.com>",
@@ -44,14 +44,14 @@
   },
   "dependencies": {
     "zod": "^3.25.76",
-    "@skein-js/core": "0.9.0"
+    "@skein-js/core": "0.9.1"
   },
   "peerDependencies": {
     "@langchain/langgraph": "^1.4.0",
     "@langchain/langgraph-sdk": "^1.9.0"
   },
   "devDependencies": {
-    "@skein-js/storage-memory": "0.9.0"
+    "@skein-js/storage-memory": "0.9.1"
   },
   "publishConfig": {
     "access": "public"