agentledger-runtime 1.0.5 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 # AgentLedger Node / TypeScript Runtime
 
-This directory contains the dependency-free Node/TypeScript-compatible runtime-core baseline for AgentLedger 1.0.5.
+This directory contains the dependency-free Node/TypeScript-compatible runtime-core baseline for AgentLedger 1.2.0.
 
 It runs a native local runtime loop, participates in the shared Python/Go/TypeScript/Rust conformance gate, and should be treated as runtime-core aligned; concrete production adapters are shipped separately as they mature.
 

package/package.json

@@ -1,14 +1,44 @@
 {
   "name": "agentledger-runtime",
-  "version": "1.0.5",
+  "version": "1.2.0",
   "private": false,
   "description": "Dependency-free Node/TypeScript-compatible runtime for AgentLedger.",
   "type": "module",
   "main": "src/index.js",
   "types": "src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./postgres": {
+      "types": "./src/adapters/postgres.d.ts",
+      "import": "./src/adapters/postgres.js"
+    },
+    "./s3": {
+      "types": "./src/adapters/s3.d.ts",
+      "import": "./src/adapters/s3.js"
+    },
+    "./mcp": {
+      "types": "./src/adapters/mcp.d.ts",
+      "import": "./src/adapters/mcp.js"
+    },
+    "./otel": {
+      "types": "./src/adapters/otel.d.ts",
+      "import": "./src/adapters/otel.js"
+    },
+    "./sandbox/docker": {
+      "types": "./src/adapters/sandbox-docker.d.ts",
+      "import": "./src/adapters/sandbox-docker.js"
+    },
+    "./langgraph": {
+      "types": "./src/adapters/langgraph.d.ts",
+      "import": "./src/adapters/langgraph.js"
+    }
+  },
   "scripts": {
     "test": "node --test",
-    "check": "node --check src/index.js && node --check test/runtime.test.js",
+    "check": "node --check src/index.js && node --check src/adapters/*.js && node --check test/runtime.test.js",
     "conformance": "node src/cli.js conformance",
     "contract:validate": "node src/cli.js contract validate"
   },
@@ -20,6 +50,7 @@
   },
   "files": [
     "src/",
+    "src/adapters/",
     "examples/README.md",
     "examples/quickstart/",
     "README.md"

package/src/adapters/langgraph.d.ts

@@ -0,0 +1,19 @@
+export class LangGraphCheckpointerAdapter {
+  constructor(runtime: any);
+  name: string;
+  configForRun(runId: string, options?: { threadId?: string | null; checkpointNs?: string }): any;
+  checkpointFromRun(runId: string): any;
+  put(config: any, checkpoint: any, metadata?: any, newVersions?: any): any;
+  get(config: any): any;
+  getTuple(config: any): any;
+  list(config?: any): any[];
+}
+export class LangGraphNodeAdapter {
+  constructor(node: any, options?: { role?: string });
+  name: string;
+  role: string;
+  mapRunSpec(): any;
+  asAgent(options?: { outputKey?: string }): any;
+}
+export const adapterPackage: { name: string; runtimePackage: string; version: string; category: string };
+

package/src/adapters/langgraph.js

@@ -0,0 +1,77 @@
+import { randomBytes } from 'node:crypto';
+
+export class LangGraphCheckpointerAdapter {
+  constructor(runtime) {
+    this.runtime = runtime;
+    this.name = 'langgraph-checkpointer';
+  }
+
+  configForRun(runId, { threadId = null, checkpointNs = '' } = {}) {
+    return { configurable: { agentledger_run_id: runId, thread_id: threadId ?? runId, checkpoint_ns: checkpointNs } };
+  }
+
+  checkpointFromRun(runId) {
+    const loaded = this.runtime.store.loadState(runId);
+    return { run_id: runId, session_id: loaded.sessionId, state_version: loaded.version, state: loaded.state };
+  }
+
+  put(config, checkpoint, metadata = {}, newVersions = {}) {
+    const checkpointId = String(checkpoint.id ?? checkpoint.checkpoint_id ?? newCheckpointId());
+    const nextConfig = this.withCheckpointId(config, checkpointId);
+    return { config: nextConfig, checkpoint: { ...checkpoint, id: checkpointId }, metadata, new_versions: newVersions };
+  }
+
+  get(config) {
+    const runId = this.runIdFromConfig(config);
+    return this.checkpointFromRun(runId);
+  }
+
+  getTuple(config) {
+    return { config, checkpoint: this.get(config), metadata: {}, parent_config: null, pending_writes: [] };
+  }
+
+  list(config = null) {
+    return config ? [this.getTuple(config)] : [];
+  }
+
+  runIdFromConfig(config) {
+    const configurable = config?.configurable ?? {};
+    const runId = configurable.agentledger_run_id ?? configurable.run_id;
+    if (!runId) throw new Error('LangGraph config must include configurable.agentledger_run_id or configurable.run_id');
+    return String(runId);
+  }
+
+  withCheckpointId(config, checkpointId) {
+    return { ...config, configurable: { ...(config?.configurable ?? {}), checkpoint_id: checkpointId } };
+  }
+}
+
+function newCheckpointId() {
+  return `lgckpt_${randomBytes(12).toString('hex')}`;
+}
+
+export class LangGraphNodeAdapter {
+  constructor(node, { role = 'LangGraphAgent' } = {}) {
+    this.node = node;
+    this.role = role;
+    this.name = 'langgraph-node';
+  }
+
+  mapRunSpec() {
+    return { adapter: this.name, role: this.role, node: this.node?.name ?? '<anonymous>' };
+  }
+
+  asAgent({ outputKey = 'output' } = {}) {
+    return async (ctx, state) => {
+      const result = await this.node(ctx, state);
+      if (outputKey && result !== undefined) await ctx.writeState(outputKey, result);
+    };
+  }
+}
+
+export const adapterPackage = {
+  name: 'agentledger-langgraph',
+  runtimePackage: 'agentledger-runtime',
+  version: '1.2.0',
+  category: 'framework',
+};

package/src/adapters/mcp.d.ts

@@ -0,0 +1,3 @@
+export { InMemoryMCPContextServer, InMemoryMCPToolServer, MCPContextAdapter, MCPToolAdapter } from '../index.js';
+export const adapterPackage: { name: string; runtimePackage: string; version: string; category: string };
+

package/src/adapters/mcp.js

@@ -0,0 +1,9 @@
+export { InMemoryMCPContextServer, InMemoryMCPToolServer, MCPContextAdapter, MCPToolAdapter } from '../index.js';
+
+export const adapterPackage = {
+  name: 'agentledger-mcp',
+  runtimePackage: 'agentledger-runtime',
+  version: '1.2.0',
+  category: 'mcp',
+};
+

package/src/adapters/otel.d.ts

@@ -0,0 +1,3 @@
+export { OTLPTransport, otlpTraceJSON } from '../index.js';
+export const adapterPackage: { name: string; runtimePackage: string; version: string; category: string };
+

package/src/adapters/otel.js

@@ -0,0 +1,9 @@
+export { OTLPTransport, otlpTraceJSON } from '../index.js';
+
+export const adapterPackage = {
+  name: 'agentledger-otel',
+  runtimePackage: 'agentledger-runtime',
+  version: '1.2.0',
+  category: 'observability',
+};
+

package/src/adapters/postgres.d.ts

@@ -0,0 +1,3 @@
+export { PostgresAdapter } from '../index.js';
+export const adapterPackage: { name: string; runtimePackage: string; version: string; category: string };
+

package/src/adapters/postgres.js

@@ -0,0 +1,9 @@
+export { PostgresAdapter } from '../index.js';
+
+export const adapterPackage = {
+  name: 'agentledger-postgres',
+  runtimePackage: 'agentledger-runtime',
+  version: '1.2.0',
+  category: 'storage',
+};
+

package/src/adapters/s3.d.ts

@@ -0,0 +1,3 @@
+export { S3BlobStoreAdapter } from '../index.js';
+export const adapterPackage: { name: string; runtimePackage: string; version: string; category: string };
+

package/src/adapters/s3.js

@@ -0,0 +1,9 @@
+export { S3BlobStoreAdapter } from '../index.js';
+
+export const adapterPackage = {
+  name: 'agentledger-s3',
+  runtimePackage: 'agentledger-runtime',
+  version: '1.2.0',
+  category: 'blobstore',
+};
+

package/src/adapters/sandbox-docker.d.ts

@@ -0,0 +1,3 @@
+export { DockerSandboxAdapter } from '../index.js';
+export const adapterPackage: { name: string; runtimePackage: string; version: string; category: string };
+

package/src/adapters/sandbox-docker.js

@@ -0,0 +1,9 @@
+export { DockerSandboxAdapter } from '../index.js';
+
+export const adapterPackage = {
+  name: 'agentledger-sandbox-docker',
+  runtimePackage: 'agentledger-runtime',
+  version: '1.2.0',
+  category: 'sandbox',
+};
+

package/src/cli.js

@@ -194,7 +194,7 @@ export function validateFixtures() {
 }
 
 function usage() {
-  return `AgentLedger TypeScript Runtime 1.0.5\n\nUsage:\n  agentledger-ts doctor\n  agentledger-ts version\n  agentledger-ts quickstart\n  agentledger-ts conformance\n  agentledger-ts contract validate\n  agentledger-ts contract export\n\nProject: https://github.com/yaogdu/AgentLedger`;
+  return `AgentLedger TypeScript Runtime 1.2.0\n\nUsage:\n  agentledger-ts doctor\n  agentledger-ts version\n  agentledger-ts quickstart\n  agentledger-ts conformance\n  agentledger-ts contract validate\n  agentledger-ts contract export\n\nProject: https://github.com/yaogdu/AgentLedger`;
 }
 
 export async function runRuntimeSmoke() {
@@ -577,11 +577,11 @@ export async function main(args = process.argv.slice(2)) {
     return 0;
   }
   if (args.length === 1 && args[0] === 'version') {
-    console.log('agentledger-ts 1.0.5');
+    console.log('agentledger-ts 1.2.0');
     return 0;
   }
   if (args.length === 1 && args[0] === 'doctor') {
-    console.log(JSON.stringify({ language: 'typescript', version: '1.0.5', status: 'ok', runtime_core_parity: true }, null, 2));
+    console.log(JSON.stringify({ language: 'typescript', version: '1.2.0', status: 'ok', runtime_core_parity: true }, null, 2));
     return 0;
   }
   if (args.length === 1 && args[0] === 'quickstart') {