@skein-js/agent-protocol 0.6.3 → 0.7.0

package/README.md

@@ -101,7 +101,7 @@ Graph **state, history, and interrupt/resume are 100% LangGraph-native** via the
 ## API
 
 - **Entry points:** `createProtocolRuntime(deps, options?)` → `{ service, handlers, worker }`;
-  `createProtocolService` / `buildProtocolService`; `createProtocolHandlers`; `createContext`;
+  `createProtocolService` / `createProtocolServiceFromContext`; `createProtocolHandlers`; `createContext`;
   `createRunWorker(ctx, options?)` (`RunWorkerOptions`: `maxConcurrency`, `shutdownGraceMs`).
 - **Service surface** (`runtime.service`): `assistants` (`registerGraphAssistants`, `get`, `list`,
   `search`, `schemas`), `threads` (`create`/`get`/`list`/`patch`/`delete`/`history`/`getState`),

package/dist/index.d.ts

@@ -331,10 +331,16 @@ interface ProtocolService {
     store: StoreService;
 }
 /** Assemble the service over an existing context (used by the runtime to share the context). */
-declare function buildProtocolService(ctx: ProtocolContext): ProtocolService;
+declare function createProtocolServiceFromContext(ctx: ProtocolContext): ProtocolService;
 /** Build the service with its own context. Use {@link createProtocolRuntime} when you also run a
  * background worker in the same process, so cancellation is shared. */
 declare function createProtocolService(deps: ProtocolDeps): ProtocolService;
+/**
+ * @deprecated Renamed to {@link createProtocolServiceFromContext} — it builds the service over an
+ * existing `ProtocolContext` (vs {@link createProtocolService}, which takes `deps` and makes its own).
+ * Kept for back-compat; slated for removal in a future major.
+ */
+declare const buildProtocolService: typeof createProtocolServiceFromContext;
 
 /** A normalized request an adapter maps its framework request onto. */
 interface ProtocolRequest {
@@ -414,12 +420,18 @@ interface RunWorker {
 }
 declare function createRunWorker(ctx: ProtocolContext, options?: RunWorkerOptions): RunWorker;
 
+/** Options for {@link createProtocolRuntime}. */
 interface ProtocolRuntimeOptions {
+    /** Tuning for the background run worker (concurrency, poll interval). */
     worker?: RunWorkerOptions;
 }
+/** The wired engine: the service, the transport-neutral handler table, and the background worker. */
 interface ProtocolRuntime {
+    /** High-level operations over assistants / threads / runs / store (used to seed assistants). */
     service: ProtocolService;
+    /** The transport-neutral HTTP handler table an adapter dispatches requests into. */
     handlers: ProtocolHandlers;
+    /** The background worker that drains the run queue; `start()` it after seeding assistants. */
     worker: RunWorker;
 }
 /**
@@ -448,9 +460,14 @@ declare const skeinRoutes: readonly RouteBinding[];
 /**
  * Copy the path `thread_id` into an object body so a stateless run handler runs on the right thread.
  * A no-op when there is no `thread_id` param. Used by every adapter for the `foldThreadIdIntoBody`
- * routes, so the folding rule lives in one place.
+ * routes, so this rule lives in one place.
+ */
+declare function copyThreadIdIntoBody(request: ProtocolRequest): ProtocolRequest;
+/**
+ * @deprecated Renamed to {@link copyThreadIdIntoBody} — it copies the path `thread_id` into the
+ * request body. Kept for back-compat; slated for removal in a future major.
  */
-declare function foldThreadId(request: ProtocolRequest): ProtocolRequest;
+declare const foldThreadId: typeof copyThreadIdIntoBody;
 /** A resolved route: the matched binding plus the path params extracted from the URL. */
 interface RouteMatch {
     binding: RouteBinding;
@@ -518,4 +535,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, type DeleteAssistantOptions, type DrawGraphOptions, 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 RunService, type RunWorker, type RunWorkerOptions, SSE_HEADERS, SkeinBaseStore, type StartedStream, type StoreService, type SubgraphsOptions, type ThreadService, type ThreadStreamInput, type ThreadStreamService, buildProtocolService, createContext, createProtocolHandlers, createProtocolRuntime, createProtocolService, createRunWorker, encodeFrame, encodeTerminal, foldThreadId, matchSkeinRoute, parseAfterSeq, skeinRoutes, toSseEvents };
+export { type AssistantService, type Clock, type CommandInput, type CompiledGraphFactory, type CreateAssistantInput, type CreateRunInput, type CreateThreadInput, type DeleteAssistantOptions, type DrawGraphOptions, 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 RunService, type RunWorker, type RunWorkerOptions, SSE_HEADERS, SkeinBaseStore, type StartedStream, type StoreService, type SubgraphsOptions, type ThreadService, type ThreadStreamInput, type ThreadStreamService, buildProtocolService, copyThreadIdIntoBody, createContext, createProtocolHandlers, createProtocolRuntime, createProtocolService, createProtocolServiceFromContext, createRunWorker, encodeFrame, encodeTerminal, foldThreadId, matchSkeinRoute, parseAfterSeq, skeinRoutes, toSseEvents };

package/dist/index.js

@@ -1692,7 +1692,7 @@ function createThreadStreamService(ctx, runs) {
 }
 
 // src/service.ts
-function buildProtocolService(ctx) {
+function createProtocolServiceFromContext(ctx) {
   const runs = createRunService(ctx);
   const threads = createThreadService(ctx);
   return {
@@ -1707,8 +1707,9 @@ function buildProtocolService(ctx) {
   };
 }
 function createProtocolService(deps) {
-  return buildProtocolService(createContext(deps));
+  return createProtocolServiceFromContext(createContext(deps));
 }
+var buildProtocolService = createProtocolServiceFromContext;
 
 // src/auth/auth-scoped-store.ts
 import {
@@ -1878,7 +1879,7 @@ var STUDIO_USER = {
   permissions: []
 };
 function createAuthorizingHandlers(context, engine) {
-  const baseHandlers = createProtocolHandlers(buildProtocolService(context));
+  const baseHandlers = createProtocolHandlers(createProtocolServiceFromContext(context));
   const names = Object.keys(ROUTE_AUTHZ);
   const resolveAuthContext = async (req) => {
     if (!engine.studioAuthDisabled && req.headers["x-auth-scheme"] === "langsmith") {
@@ -1907,7 +1908,7 @@ function createAuthorizingHandlers(context, engine) {
           store: createAuthScopedStore(context.deps.store, engine, filters, route.resource)
         } : context.deps
       };
-      return createProtocolHandlers(buildProtocolService(requestContext))[name](req);
+      return createProtocolHandlers(createProtocolServiceFromContext(requestContext))[name](req);
     };
   }
   return wrapped;
@@ -1977,7 +1978,7 @@ function createRunWorker(ctx, options = {}) {
 // src/runtime.ts
 function createProtocolRuntime(deps, options = {}) {
   const context = createContext(deps);
-  const service = buildProtocolService(context);
+  const service = createProtocolServiceFromContext(context);
   const handlers = deps.auth ? createAuthorizingHandlers(context, deps.auth) : createProtocolHandlers(service);
   return {
     service,
@@ -2051,12 +2052,13 @@ var skeinRoutes = [
   { method: "post", path: "/store/items/search", handler: "searchStoreItems" },
   { method: "post", path: "/store/namespaces", handler: "listStoreNamespaces" }
 ];
-function foldThreadId(request) {
+function copyThreadIdIntoBody(request) {
   const threadId = request.params["thread_id"];
   if (threadId === void 0) return request;
   const base = typeof request.body === "object" && request.body !== null && !Array.isArray(request.body) ? request.body : {};
   return { ...request, body: { ...base, thread_id: threadId } };
 }
+var foldThreadId = copyThreadIdIntoBody;
 var compiledRoutes = skeinRoutes.map((binding) => ({
   binding,
   regex: new RegExp(`^${binding.path.replace(/:(\w+)/g, "(?<$1>[^/]+)")}$`)
@@ -2085,10 +2087,12 @@ export {
   SSE_HEADERS,
   SkeinBaseStore,
   buildProtocolService,
+  copyThreadIdIntoBody,
   createContext,
   createProtocolHandlers,
   createProtocolRuntime,
   createProtocolService,
+  createProtocolServiceFromContext,
   createRunWorker,
   encodeFrame,
   encodeTerminal,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skein-js/agent-protocol",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "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.6.3"
+    "@skein-js/core": "0.7.0"
   },
   "peerDependencies": {
     "@langchain/langgraph": "^1.4.0",
     "@langchain/langgraph-sdk": "^1.9.0"
   },
   "devDependencies": {
-    "@skein-js/storage-memory": "0.6.3"
+    "@skein-js/storage-memory": "0.7.0"
   },
   "publishConfig": {
     "access": "public"