@atbash/atbash-langgraph 0.0.15-dev.1 → 0.0.15-dev.3

package/README.md

@@ -7,7 +7,7 @@ This package adds a guard node before tool execution and an audit node after, us
 ## Installation
 
 ```bash
-npm install @atbash/atbash-langgraph
+npm install @atbash/atbash-langgraph@0.0.15-dev.2
 ```
 
 Peer dependencies:
@@ -28,7 +28,6 @@ Use this package when:
 ## Quick Start
 
 ```ts
-import { loadAgent } from "@atbash/sdk";
 import { StateGraph, START, END, MemorySaver } from "@langchain/langgraph";
 import { AtbashStateAnnotation, addAtbashSafety } from "@atbash/atbash-langgraph";
 
@@ -66,11 +65,22 @@ Convenience helper that wires `atbash_guard` and `atbash_audit` into your graph.
 
 Assumes your graph has nodes named `agent` and `tools`. If your layout differs, use `createGuardNode()` and `createAuditNode()` directly.
 
-| Option | Type | Description |
-|---|---|---|
-| `privkey` | `string` | Agent private key (falls back to `ATBASH_AGENT_PRIVKEY` env var) |
-| `agent` | `AgentAuth` | Pre-loaded agent (alternative to `privkey`) |
-| `endpoint` | `string` | Override Atbash endpoint |
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `privkey` | `string` | — | Agent private key (falls back to `ATBASH_AGENT_PRIVKEY` env var) |
+| `endpoint` | `string` | `https://atbash.ai` | Override Atbash endpoint |
+| `toolsNode` | `string` | `"tools"` | Name of the tools node in your graph |
+| `agentNode` | `string` | `"agent"` | Name of the agent node in your graph |
+| `workspaceDir` | `string` | `process.cwd()` | Agent workspace directory; `~` is expanded |
+| `memoryFilePath` | `string` | `<workspaceDir>/MEMORY.md` | Explicit MEMORY.md path; overrides `workspaceDir` |
+| `memorySyncTTLMs` | `number` | `30000` | How long (ms) to trust the local memory pointer between chain checks |
+| `memoryRollbackMinScore` | `number` | `1` | Block memory reads when a rolled-back version scores below this (1–10); default 1 = warn only |
+| `memoryPathPatterns` | `string[]` | SDK built-ins | Custom memory path glob patterns |
+| `judgeEndpoint` | `string` | — | Override the judge endpoint separately from the main endpoint |
+| `judgeVerifyPubKey` | `string` | — | Self-hosted judge response-signing pubkey (required when `judgeEndpoint` uses a self-hosted policy) |
+| `orgName` | `string` | — | Organization name for chain resolution (public vs private chain) |
+| `enforce` | `boolean` | `true` | Set to `false` for monitor mode: memory guard logs violations but never blocks |
+| `debug` | `boolean` | `false` | Enable verbose debug logging |
 
 ### `createGuardNode(opts)`
 
@@ -97,10 +107,14 @@ Extends `MessagesAnnotation` with Atbash fields:
 | `atbashToolCallId` | `string \| null` | Tool call ID for polling or HOLD resume |
 | `atbashConfidence` | `number \| null` | Confidence score |
 
-### `createJudgeTool(agent, endpoint?)`
+### `createJudgeTool(client)`
 
 Optional: creates an `atbash_safety_check` LangChain tool for direct LLM access to the judge.
 
+| Param | Type | Description |
+|---|---|---|
+| `client` | `Atbash` | A constructed `Atbash` instance (e.g. `new Atbash(privkey)`) |
+
 ## Verdict Handling
 
 | Verdict | Meaning | Graph Behavior |
@@ -146,7 +160,7 @@ and asking the agent to try again is the supported flow.
 | Variable | Required | Description |
 |---|---|---|
 | `ATBASH_AGENT_PRIVKEY` | Yes (if not passing `agent`) | Your Atbash agent private key |
-| `ATBASH_ENDPOINT` | No | Override the default Atbash endpoint (`https://atbash.ai`) |
+| `ATBASH_ENDPOINT` | No | Passed by your application via `opts.endpoint`. The builder does not read this env var automatically; read it yourself and forward it: `addAtbashSafety(builder, { endpoint: process.env.ATBASH_ENDPOINT })` |
 
 ## What This Package Does Not Do
 

package/dist/index.js

@@ -349,11 +349,15 @@ function sealRoutesIntoGuard(graph, toolsNode) {
     return compile(...args);
   };
 }
+var _telemetryRegistered = false;
 function addAtbashSafety(builder, opts) {
   setupTelemetry({ enabled: true, source: "plugin:langgraph" });
-  process.once("beforeExit", () => shutdownTelemetry());
-  process.once("SIGINT", () => shutdownTelemetry().finally(() => process.exit(0)));
-  process.once("SIGTERM", () => shutdownTelemetry().finally(() => process.exit(0)));
+  if (!_telemetryRegistered) {
+    _telemetryRegistered = true;
+    process.once("beforeExit", () => shutdownTelemetry());
+    process.once("SIGINT", () => shutdownTelemetry().finally(() => process.exit(0)));
+    process.once("SIGTERM", () => shutdownTelemetry().finally(() => process.exit(0)));
+  }
   const privkey = opts.privkey ?? process.env.ATBASH_AGENT_PRIVKEY ?? "";
   const clientOpts = {};
   if (opts.endpoint) clientOpts.endpoint = opts.endpoint;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atbash/atbash-langgraph",
-  "version": "0.0.15-dev.1",
+  "version": "0.0.15-dev.3",
   "description": "Atbash safety guard and audit nodes for LangGraph workflows",
   "type": "module",
   "main": "dist/index.js",
@@ -45,7 +45,7 @@
     "release:dev": "node scripts/release.mjs --channel dev"
   },
   "dependencies": {
-    "@atbash/sdk": "0.13.2-dev.0",
+    "@atbash/sdk": "0.13.3-dev.0",
     "zod": "^3.25.76"
   },
   "peerDependencies": {