@skein-js/agent-protocol 0.2.0 → 0.3.0

package/README.md

@@ -2,10 +2,26 @@
 
 > The framework-agnostic Agent Protocol **engine** — run engine, handler table, and SSE mapping. The heart of skein-js.
 
-Part of **[skein-js](https://github.com/mainawycliffe/skein)** — a TypeScript [Agent Protocol](https://github.com/langchain-ai/agent-protocol) server for [LangGraph.js](https://github.com/langchain-ai/langgraphjs), and a drop-in replacement for the LangGraph CLI.
+Part of **[skein-js](../../README.md)** — a TypeScript [Agent Protocol](https://github.com/langchain-ai/agent-protocol) server for [LangGraph.js](https://github.com/langchain-ai/langgraphjs), and a drop-in replacement for the LangGraph CLI.
 
 **Status:** 🚧 Pre-alpha — implemented. Depends only on the [`@skein-js/core`](../core) contracts and is designed to be consumed on its own.
 
+This is **the engine** at the heart of skein-js: a complete, framework-agnostic implementation of the
+Agent Protocol for LangGraph.js. Build your own server on it — any HTTP framework, any storage/queue —
+by injecting a [`ProtocolDeps`](#the-injected-contract-protocoldeps).
+
+## Contents
+
+- [What it does](#what-it-does)
+- [Install](#install)
+- [Usage](#usage)
+- [Two layers](#two-layers)
+- [The injected contract (`ProtocolDeps`)](#the-injected-contract-protocoldeps)
+- [API](#api)
+- [Reuse](#reuse)
+- [Learn more](#learn-more)
+- [License](#license)
+
 ## What it does
 
 The **run engine + protocol handler table + SSE mapping**, and nothing else. It has no opinion about
@@ -17,12 +33,16 @@ client.
 
 ## Install
 
-```sh
-npm install @skein-js/agent-protocol @skein-js/core @langchain/langgraph @langchain/langgraph-sdk
+```bash
+pnpm add @skein-js/agent-protocol @skein-js/core
 ```
 
-`@langchain/langgraph` and `@langchain/langgraph-sdk` are peer dependencies; `@skein-js/core` is a
-regular dependency you should pin alongside.
+`@langchain/langgraph` and `@langchain/langgraph-sdk` are peer dependencies — install them too if
+your project doesn't already depend on them:
+
+```bash
+pnpm add @langchain/langgraph @langchain/langgraph-sdk
+```
 
 ## Usage
 
@@ -108,7 +128,8 @@ from `@langchain/langgraph-sdk` via [`@skein-js/core`](../core).
 ## Learn more
 
 - [Agent Protocol surface](../../docs/agent-protocol.md) · [Streaming (SSE)](../../docs/streaming.md) · [Runs & Redis](../../docs/runs-and-redis.md)
-- [skein-js overview](../../docs/index.md) · [Reuse-first architecture](../../docs/reuse.md)
+- [Building your own adapter](../../docs/building-an-adapter.md) — mount this engine on any HTTP framework
+- [skein-js overview](../../docs/index.md) · [Reuse-first architecture](../../docs/reuse.md) · [Root README](../../README.md)
 
 ## License
 

package/dist/index.js

@@ -1312,8 +1312,21 @@ function createAuthorizingHandlers(context, engine) {
 }
 
 // src/runs/run-worker.ts
-import { isTerminalRunStatus as isTerminalRunStatus6 } from "@skein-js/core";
+import {
+  isTerminalRunStatus as isTerminalRunStatus6
+} from "@skein-js/core";
 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}`, {
+    run_id: run.run_id,
+    run_attempt: 1,
+    run_created_at: run.created_at,
+    run_started_at: new Date(startedAt).toISOString(),
+    run_ended_at: new Date(endedAt).toISOString(),
+    run_exec_ms: endedAt - startedAt,
+    run_queue_ms: startedAt - Date.parse(run.created_at)
+  });
+}
 function createRunWorker(ctx, options = {}) {
   const { deps, control } = ctx;
   const maxConcurrency = options.maxConcurrency ?? 1;
@@ -1325,9 +1338,12 @@ function createRunWorker(ctx, options = {}) {
     const kwargs = await deps.store.runs.getKwargs(queued.run_id) ?? {};
     const runControl = control.register(queued.run_id);
     inFlight.add(queued.run_id);
+    const startedAt = Date.now();
+    let status = "error";
     try {
-      await executeRun(deps, { run, kwargs, control: runControl });
+      status = (await executeRun(deps, { run, kwargs, control: runControl })).status;
     } finally {
+      logRunLifecycle(deps.logger, run, status, startedAt, Date.now());
       control.clear(queued.run_id);
       inFlight.delete(queued.run_id);
     }

package/package.json

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