@synapsor/runner 0.1.0-alpha.6 → 0.1.0-alpha.7

package/README.md

@@ -181,6 +181,27 @@ examples/openai-agents-http/
 Use `--mode review` only when you are ready to create proposal tools and test
 guarded writeback with a separate trusted write credential.
 
+## Sanity Check The Agent Connection
+
+Before asking an agent to solve a real task, confirm it can call a Runner tool:
+
+```bash
+synapsor-runner tools preview --config ./synapsor.runner.json --store ./.synapsor/local.db
+```
+
+Then ask the agent:
+
+```text
+Use the Synapsor Runner MCP tool to inspect invoice INV-3001.
+Do not answer from memory.
+Return the tool name called, the evidence handle, and whether raw SQL was available.
+```
+
+Expected result: the agent calls a semantic tool, returns an evidence handle or
+local ledger reference, and says raw SQL/write/approval tools were not
+available. If it gives generic advice or unrelated prose without a tool call,
+Runner is not connected yet.
+
 The disposable reference app includes proposal-first write examples for:
 
 - `billing.propose_late_fee_waiver`

package/dist/runner.mjs

@@ -2685,7 +2685,7 @@ function createMcpRuntime(config, options = {}) {
 }
 function createSynapsorMcpServer(runtime) {
   const server = new McpServer(
-    { name: "synapsor-runner", version: "0.1.0-alpha.6" },
+    { name: "synapsor-runner", version: "0.1.0-alpha.7" },
     { capabilities: { tools: {}, resources: {} } }
   );
   if (runtime.config.mode === "cloud") {
@@ -7977,7 +7977,7 @@ async function cloudConnect(args) {
     return 1;
   }
   const runnerId = String(parsed.cloud.runner_id || process2.env.SYNAPSOR_RUNNER_ID || "synapsor_runner_local").trim();
-  const runnerVersion = String(parsed.cloud.runner_version || process2.env.npm_package_version || "0.1.0-alpha.6").trim();
+  const runnerVersion = String(parsed.cloud.runner_version || process2.env.npm_package_version || "0.1.0-alpha.7").trim();
   const engines = normalizeEngines(parsed.cloud.engines);
   const capabilities = normalizeCapabilities(parsed.cloud.capabilities);
   const client = new ControlPlaneClient({
@@ -11435,7 +11435,7 @@ function starterCloudConfig() {
       base_url_env: "SYNAPSOR_CLOUD_BASE_URL",
       runner_token_env: "SYNAPSOR_RUNNER_TOKEN",
       runner_id: "synapsor_runner_local",
-      runner_version: "0.1.0-alpha.6",
+      runner_version: "0.1.0-alpha.7",
       project_id: "token_scope",
       adapter_id: "mcp.your_adapter",
       source_id: "src_replace_me",

package/docs/mcp-client-setup.md

@@ -127,7 +127,7 @@ npx -y -p @synapsor/runner@alpha synapsor-runner mcp serve-http \
         "-y",
         "-p",
         "@synapsor/runner@alpha",
-        "synapsor",
+        "synapsor-runner",
         "mcp",
         "serve",
         "--config",
@@ -161,6 +161,39 @@ approve_proposal
 commit_proposal
 ```
 
+## Sanity Check The Agent Connection
+
+After installing the MCP client snippet, restart the client and run a deliberately
+small tool-call test.
+
+First confirm what Runner exposes:
+
+```bash
+npx -y -p @synapsor/runner@alpha synapsor-runner tools preview \
+  --config ./synapsor.runner.json \
+  --store ./.synapsor/local.db
+```
+
+Then ask the MCP client:
+
+```text
+Use the Synapsor Runner MCP tool to inspect invoice INV-3001.
+Do not answer from memory.
+Return the tool name called, the evidence handle, and whether raw SQL was available.
+```
+
+Expected result:
+
+- the client calls a tool such as `billing.inspect_invoice`;
+- the response includes an evidence handle or local ledger reference;
+- the model reports that raw SQL, write credentials, approval tools, and commit
+  tools were not available.
+
+If the answer is generic prose or unrelated task planning with no tool call and
+no evidence handle, Synapsor Runner is not connected to that agent session yet.
+Check the MCP config path, restart the client, set trusted context env vars, and
+run `tools/list` or `synapsor-runner tools preview` again.
+
 ## Claude Desktop / Cursor / VS Code
 
 Use the matching checked-in example as the starting point:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synapsor/runner",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.7",
   "description": "Commit-safe MCP runner for Postgres and MySQL agents",
   "license": "Apache-2.0",
   "type": "module",