@synapsor/client 0.1.0 → 0.1.1

package/README.md

@@ -1,7 +1,8 @@
-# Synapsor Node.js Adapter
+# Synapsor Node.js SDK
 
-The Node.js adapter is a thin ESM client over `synapsor_server` HTTP/JSON APIs.
-It keeps Synapsor semantics in C++ and exposes a compact JavaScript API.
+The Synapsor Node.js SDK connects applications to hosted or local Synapsor
+databases. Use it for SQL, branch workflows, agent contexts, capabilities,
+evidence, memory, and safe write proposals from Node.js applications.
 
 ## Local Usage
 
@@ -35,7 +36,7 @@ await db.close();
 
 ## Hosted Usage
 
-Install from npm after the package is published:
+Install from npm:
 
 ```bash
 npm install @synapsor/client
@@ -59,14 +60,12 @@ const ctx = await db.invokeAgentCapability("chat.prepare_llm_context", { questio
 ```
 
 Use database-scoped API keys from the Synapsor control panel for hosted projects.
-The cloud gateway pins those keys to the database runtime branch before forwarding
-requests to the single-node runtime.
 
 ## API Surface
 
 - `execute(sql)` and `query(sql)`
 - `setSession({...})`
-- `invokeAgentCapability(name, args)`
+- `invokeAgentCapability(name, args, options)`
 - `listCapabilities(query)`
 - `rememberFact({...})`
 - `proposeMemoryFact({...})`
@@ -77,7 +76,7 @@ requests to the single-node runtime.
 - `retireFact(id, {...})` and `forgetFact(id, reason)`
 - `checkFactForAction({...})`
 - branch helpers: `createBranch`, `useBranch`, `diffBranch`, `mergeBranch`, `dropBranch`
-- write lifecycle helpers: `previewWrite`, `approveWrite`, `commitWrite`, `rejectWrite`
+- write lifecycle helpers: `previewWrite`, `approveWrite`, `commitWrite`, `rejectWrite`, `settleWrite`
 - `readResource(uri)`
 
 Errors from Synapsor become `SynapsorError` with `status` and `payload`.

package/generated-contract.mjs

@@ -1,6 +1,6 @@
 // Generated by tools/generate_openapi_sdk_contract.py. Do not edit by hand.
 export const PROTOCOL_VERSION = "v1";
-export const CONTRACT_SHA256 = "f738189b0873fe48c5900cbffafb7d4eed90acbe9fc8c7cfcd4db89ad78f106a";
+export const CONTRACT_SHA256 = "af3ae249f90c9d7dd7d424890c8a9d37e1c6c8c024cd83341f882c5bac8c389d";
 export const OPENAPI_OPERATIONS = Object.freeze({
   "approveAgentProposal": {
     "method": "POST",
@@ -209,6 +209,14 @@ export const OPENAPI_OPERATIONS = Object.freeze({
     "public": false,
     "python_method": "run_hybrid_reembed_jobs",
     "request_schema": "#/components/schemas/HybridReembedRunRequest"
+  },
+  "settleAgentProposal": {
+    "method": "POST",
+    "node_method": "settleWrite",
+    "path": "/v1/agent/proposals/settle",
+    "public": false,
+    "python_method": "settle_write",
+    "request_schema": "#/components/schemas/ProposalLifecycleRequest"
   }
 });
 export const PYTHON_OPERATION_METHODS = Object.freeze({
@@ -237,7 +245,8 @@ export const PYTHON_OPERATION_METHODS = Object.freeze({
   "previewAgentProposal": "preview_write",
   "rejectAgentProposal": "reject_write",
   "resumeHybridReembedJob": "resume_hybrid_reembed_job",
-  "runHybridReembedJobs": "run_hybrid_reembed_jobs"
+  "runHybridReembedJobs": "run_hybrid_reembed_jobs",
+  "settleAgentProposal": "settle_write"
 });
 export const NODE_OPERATION_METHODS = Object.freeze({
   "approveAgentProposal": "approveWrite",
@@ -265,7 +274,8 @@ export const NODE_OPERATION_METHODS = Object.freeze({
   "previewAgentProposal": "previewWrite",
   "rejectAgentProposal": "rejectWrite",
   "resumeHybridReembedJob": "resumeHybridReembedJob",
-  "runHybridReembedJobs": "runHybridReembedJobs"
+  "runHybridReembedJobs": "runHybridReembedJobs",
+  "settleAgentProposal": "settleWrite"
 });
 export const PUBLIC_OPERATIONS = Object.freeze([
   "getHealth",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@synapsor/client",
-  "version": "0.1.0",
-  "description": "Node.js client for Synapsor HTTP/JSON APIs",
+  "version": "0.1.1",
+  "description": "Node.js SDK for Synapsor, the agent-native database for auditable AI applications",
   "type": "module",
   "main": "./synapsor.mjs",
   "exports": {

package/synapsor.mjs

@@ -236,14 +236,47 @@ export class Synapsor {
     return results.at(-1).result?.rows ?? [];
   }
 
-  async invokeAgentCapability(capability, args = {}, { session = undefined, traceId = undefined } = {}) {
+  async invokeAgentCapability(capability, args = {}, {
+    session = undefined,
+    traceId = undefined,
+    trace_id = undefined,
+    mode = undefined,
+    autoBranch = undefined,
+    auto_branch = undefined,
+    responseEnvelope = undefined,
+    response_envelope = undefined,
+    includeAuditTrail = undefined,
+    include_audit_trail = undefined,
+    settlementPolicy = undefined,
+    settlement_policy = undefined,
+  } = {}) {
     const payload = {
       capability,
       arguments: args,
       session: this.requireSession(session),
     };
-    if (traceId !== undefined) {
-      payload.trace_id = traceId;
+    const trace = traceId ?? trace_id;
+    const branch = autoBranch ?? auto_branch;
+    const envelope = responseEnvelope ?? response_envelope;
+    const audit = includeAuditTrail ?? include_audit_trail;
+    const policy = settlementPolicy ?? settlement_policy;
+    if (trace !== undefined) {
+      payload.trace_id = trace;
+    }
+    if (mode !== undefined) {
+      payload.mode = mode;
+    }
+    if (branch !== undefined) {
+      payload.auto_branch = Boolean(branch);
+    }
+    if (envelope !== undefined) {
+      payload.response_envelope = Boolean(envelope);
+    }
+    if (audit !== undefined) {
+      payload.include_audit_trail = Boolean(audit);
+    }
+    if (policy !== undefined) {
+      payload.settlement_policy = policy;
     }
     return this.request("POST", "/v1/agent/invoke", payload);
   }
@@ -414,6 +447,13 @@ export class Synapsor {
     return this.proposalLifecycle("cancel", proposal, options);
   }
 
+  async settleWrite(proposal, settlementPolicy, options = {}) {
+    return this.proposalLifecycle("settle", proposal, {
+      ...options,
+      settlementPolicy,
+    });
+  }
+
   async replayAgentRun(runId, options = {}) {
     return this.request("POST", "/v1/agent/runs/replay", {
       run_id: Number(runId),
@@ -422,19 +462,23 @@ export class Synapsor {
     });
   }
 
-  async proposalLifecycle(action, proposal, { session = undefined, promoteBranch = undefined, promote_branch = undefined, targetBranch = undefined, target_branch = undefined } = {}) {
+  async proposalLifecycle(action, proposal, { session = undefined, promoteBranch = undefined, promote_branch = undefined, targetBranch = undefined, target_branch = undefined, settlementPolicy = undefined, settlement_policy = undefined } = {}) {
     const payload = {
       proposal,
       session: this.requireSession(session),
     };
     const shouldPromote = promoteBranch ?? promote_branch;
     const target = targetBranch ?? target_branch;
+    const policy = settlementPolicy ?? settlement_policy;
     if (shouldPromote !== undefined) {
       payload.promote_branch = Boolean(shouldPromote);
     }
     if (target !== undefined) {
       payload.target_branch = target;
     }
+    if (policy !== undefined) {
+      payload.settlement_policy = policy;
+    }
     return this.request("POST", `/v1/agent/proposals/${action}`, payload);
   }