@synapsor/runner 0.1.0-alpha.9 → 0.1.1

package/examples/support-billing-agent/db/seed.sql

@@ -0,0 +1,43 @@
+INSERT INTO public.tenants (id, name, created_at, updated_at)
+VALUES
+  ('acme', 'Acme Robotics', '2026-06-20T10:00:00Z', '2026-06-20T10:00:00Z'),
+  ('otherco', 'OtherCo Labs', '2026-06-20T10:00:00Z', '2026-06-20T10:00:00Z')
+ON CONFLICT (id) DO UPDATE SET name = EXCLUDED.name, updated_at = EXCLUDED.updated_at;
+
+INSERT INTO public.customers (id, tenant_id, name, email, plan, plan_credit_cents, credit_reason, created_at, updated_at)
+VALUES
+  ('cust_acme_1', 'acme', 'Acme Robotics', 'ops@example.invalid', 'enterprise', 0, NULL, '2026-06-20T10:00:00Z', '2026-06-20T10:00:00Z'),
+  ('cust_acme_2', 'acme', 'Acme Field Ops', 'field@example.invalid', 'builder', 0, NULL, '2026-06-20T10:00:00Z', '2026-06-20T10:00:00Z'),
+  ('cust_other_1', 'otherco', 'OtherCo Labs', 'ops@otherco.invalid', 'builder', 0, NULL, '2026-06-20T10:00:00Z', '2026-06-20T10:00:00Z')
+ON CONFLICT (id) DO UPDATE SET tenant_id = EXCLUDED.tenant_id, name = EXCLUDED.name, email = EXCLUDED.email, plan = EXCLUDED.plan, plan_credit_cents = EXCLUDED.plan_credit_cents, credit_reason = EXCLUDED.credit_reason, updated_at = EXCLUDED.updated_at;
+
+INSERT INTO public.support_tickets (id, tenant_id, customer_id, subject, status, resolution_note, updated_at)
+VALUES
+  ('T-1042', 'acme', 'cust_acme_1', 'Late fee waiver request for INV-3001', 'open', NULL, '2026-06-20T12:00:00Z'),
+  ('T-1043', 'acme', 'cust_acme_2', 'Duplicate card charge question', 'open', NULL, '2026-06-20T12:05:00Z'),
+  ('T-9001', 'otherco', 'cust_other_1', 'OtherCo private billing ticket', 'open', NULL, '2026-06-20T12:00:00Z')
+ON CONFLICT (id) DO UPDATE SET tenant_id = EXCLUDED.tenant_id, customer_id = EXCLUDED.customer_id, subject = EXCLUDED.subject, status = EXCLUDED.status, resolution_note = EXCLUDED.resolution_note, updated_at = EXCLUDED.updated_at;
+
+INSERT INTO public.invoices (id, tenant_id, customer_id, status, balance_cents, late_fee_cents, waiver_reason, updated_at)
+VALUES
+  ('INV-3001', 'acme', 'cust_acme_1', 'overdue', 25500, 5500, NULL, '2026-06-20T14:31:08Z'),
+  ('INV-3002', 'acme', 'cust_acme_2', 'paid', 0, 0, NULL, '2026-06-20T14:40:00Z'),
+  ('INV-9001', 'otherco', 'cust_other_1', 'overdue', 25500, 5500, NULL, '2026-06-20T14:31:08Z')
+ON CONFLICT (id) DO UPDATE SET tenant_id = EXCLUDED.tenant_id, customer_id = EXCLUDED.customer_id, status = EXCLUDED.status, balance_cents = EXCLUDED.balance_cents, late_fee_cents = EXCLUDED.late_fee_cents, waiver_reason = EXCLUDED.waiver_reason, updated_at = EXCLUDED.updated_at;
+
+INSERT INTO public.credits (id, tenant_id, customer_id, invoice_id, amount_cents, reason, status, created_at, updated_at)
+VALUES
+  ('CR-1001', 'acme', 'cust_acme_1', 'INV-3001', 1000, 'Seeded goodwill credit for review flow', 'draft', '2026-06-20T15:00:00Z', '2026-06-20T15:00:00Z')
+ON CONFLICT (id) DO UPDATE SET tenant_id = EXCLUDED.tenant_id, customer_id = EXCLUDED.customer_id, invoice_id = EXCLUDED.invoice_id, amount_cents = EXCLUDED.amount_cents, reason = EXCLUDED.reason, status = EXCLUDED.status, updated_at = EXCLUDED.updated_at;
+
+INSERT INTO public.agent_actions (id, tenant_id, action_type, target_type, target_id, proposal_id, status, created_at)
+VALUES
+  ('ACT-1001', 'acme', 'late_fee_review', 'invoice', 'INV-3001', NULL, 'seeded', '2026-06-20T15:05:00Z')
+ON CONFLICT (id) DO UPDATE SET tenant_id = EXCLUDED.tenant_id, action_type = EXCLUDED.action_type, target_type = EXCLUDED.target_type, target_id = EXCLUDED.target_id, proposal_id = EXCLUDED.proposal_id, status = EXCLUDED.status, created_at = EXCLUDED.created_at;
+
+INSERT INTO public.orders (id, tenant_id, customer_id, status, status_change_reason, updated_at)
+VALUES
+  ('O-1001', 'acme', 'cust_acme_1', 'paid', NULL, '2026-06-20T13:00:00Z'),
+  ('O-1002', 'acme', 'cust_acme_2', 'processing', NULL, '2026-06-20T13:05:00Z'),
+  ('O-9001', 'otherco', 'cust_other_1', 'paid', NULL, '2026-06-20T13:00:00Z')
+ON CONFLICT (id) DO UPDATE SET tenant_id = EXCLUDED.tenant_id, customer_id = EXCLUDED.customer_id, status = EXCLUDED.status, status_change_reason = EXCLUDED.status_change_reason, updated_at = EXCLUDED.updated_at;

package/examples/support-billing-agent/docker-compose.yml

@@ -0,0 +1,13 @@
+services:
+  postgres:
+    image: postgres:16
+    container_name: synapsor_runner_support_billing_agent
+    environment:
+      POSTGRES_DB: synapsor_support_billing_agent
+      POSTGRES_USER: synapsor_admin
+      POSTGRES_PASSWORD: synapsor_admin_password
+    ports:
+      - "55436:5432"
+    volumes:
+      - ./db/schema.sql:/docker-entrypoint-initdb.d/001_schema.sql:ro
+      - ./db/seed.sql:/docker-entrypoint-initdb.d/002_seed.sql:ro

package/examples/support-billing-agent/scripts/run-demo.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
+cd "$ROOT_DIR"
+
+SYNAPSOR_REFERENCE_EXAMPLE_DIR="examples/support-billing-agent" \
+SYNAPSOR_REFERENCE_CONFIG_PATH="examples/support-billing-agent/synapsor.runner.json" \
+SYNAPSOR_REFERENCE_TMP_DIR="tmp/support-billing-agent" \
+SYNAPSOR_REFERENCE_CONTAINER="synapsor_runner_support_billing_agent" \
+SYNAPSOR_REFERENCE_DB="synapsor_support_billing_agent" \
+SYNAPSOR_REFERENCE_PORT="55436" \
+SYNAPSOR_REFERENCE_EXPECTED_TOOLS="support.inspect_ticket,support.propose_plan_credit,billing.inspect_invoice,billing.propose_late_fee_waiver" \
+SYNAPSOR_REFERENCE_EXACT_TOOLS="1" \
+node scripts/smoke-reference-support-billing-app.mjs

package/examples/support-billing-agent/synapsor.runner.json

@@ -0,0 +1,233 @@
+{
+  "version": 1,
+  "mode": "review",
+  "storage": {
+    "sqlite_path": "./tmp/support-billing-agent/local.db"
+  },
+  "sources": {
+    "app_postgres": {
+      "engine": "postgres",
+      "read_url_env": "REFERENCE_POSTGRES_READ_URL",
+      "write_url_env": "REFERENCE_POSTGRES_WRITE_URL",
+      "statement_timeout_ms": 3000
+    }
+  },
+  "trusted_context": {
+    "provider": "environment",
+    "values": {
+      "tenant_id_env": "SYNAPSOR_TENANT_ID",
+      "principal_env": "SYNAPSOR_PRINCIPAL"
+    }
+  },
+  "contexts": {
+    "local_operator": {
+      "provider": "environment",
+      "values": {
+        "tenant_id_env": "SYNAPSOR_TENANT_ID",
+        "principal_env": "SYNAPSOR_PRINCIPAL"
+      }
+    }
+  },
+  "capabilities": [
+    {
+      "name": "support.inspect_ticket",
+      "kind": "read",
+      "source": "app_postgres",
+      "context": "local_operator",
+      "target": {
+        "schema": "public",
+        "table": "support_tickets",
+        "primary_key": "id",
+        "tenant_key": "tenant_id"
+      },
+      "args": {
+        "ticket_id": {
+          "type": "string",
+          "required": true,
+          "max_length": 128
+        }
+      },
+      "lookup": {
+        "id_from_arg": "ticket_id"
+      },
+      "visible_columns": [
+        "id",
+        "tenant_id",
+        "customer_id",
+        "subject",
+        "status",
+        "resolution_note",
+        "updated_at"
+      ],
+      "evidence": "required",
+      "max_rows": 1
+    },
+    {
+      "name": "support.propose_plan_credit",
+      "kind": "proposal",
+      "source": "app_postgres",
+      "context": "local_operator",
+      "target": {
+        "schema": "public",
+        "table": "customers",
+        "primary_key": "id",
+        "tenant_key": "tenant_id"
+      },
+      "args": {
+        "customer_id": {
+          "type": "string",
+          "required": true,
+          "max_length": 128
+        },
+        "credit_cents": {
+          "type": "number",
+          "required": true,
+          "minimum": 0,
+          "maximum": 5000
+        },
+        "reason": {
+          "type": "string",
+          "required": true,
+          "max_length": 500
+        }
+      },
+      "lookup": {
+        "id_from_arg": "customer_id"
+      },
+      "visible_columns": [
+        "id",
+        "tenant_id",
+        "name",
+        "plan",
+        "plan_credit_cents",
+        "credit_reason",
+        "updated_at"
+      ],
+      "evidence": "required",
+      "max_rows": 1,
+      "patch": {
+        "plan_credit_cents": {
+          "from_arg": "credit_cents"
+        },
+        "credit_reason": {
+          "from_arg": "reason"
+        }
+      },
+      "allowed_columns": [
+        "plan_credit_cents",
+        "credit_reason"
+      ],
+      "numeric_bounds": {
+        "plan_credit_cents": {
+          "minimum": 0,
+          "maximum": 5000
+        }
+      },
+      "conflict_guard": {
+        "column": "updated_at"
+      },
+      "approval": {
+        "mode": "human",
+        "required_role": "support_lead"
+      }
+    },
+    {
+      "name": "billing.inspect_invoice",
+      "kind": "read",
+      "source": "app_postgres",
+      "context": "local_operator",
+      "target": {
+        "schema": "public",
+        "table": "invoices",
+        "primary_key": "id",
+        "tenant_key": "tenant_id"
+      },
+      "args": {
+        "invoice_id": {
+          "type": "string",
+          "required": true,
+          "max_length": 128
+        }
+      },
+      "lookup": {
+        "id_from_arg": "invoice_id"
+      },
+      "visible_columns": [
+        "id",
+        "tenant_id",
+        "customer_id",
+        "status",
+        "balance_cents",
+        "late_fee_cents",
+        "waiver_reason",
+        "updated_at"
+      ],
+      "evidence": "required",
+      "max_rows": 1
+    },
+    {
+      "name": "billing.propose_late_fee_waiver",
+      "kind": "proposal",
+      "source": "app_postgres",
+      "context": "local_operator",
+      "target": {
+        "schema": "public",
+        "table": "invoices",
+        "primary_key": "id",
+        "tenant_key": "tenant_id"
+      },
+      "args": {
+        "invoice_id": {
+          "type": "string",
+          "required": true,
+          "max_length": 128
+        },
+        "reason": {
+          "type": "string",
+          "required": true,
+          "max_length": 500
+        }
+      },
+      "lookup": {
+        "id_from_arg": "invoice_id"
+      },
+      "visible_columns": [
+        "id",
+        "tenant_id",
+        "customer_id",
+        "status",
+        "balance_cents",
+        "late_fee_cents",
+        "waiver_reason",
+        "updated_at"
+      ],
+      "evidence": "required",
+      "max_rows": 1,
+      "patch": {
+        "late_fee_cents": {
+          "fixed": 0
+        },
+        "waiver_reason": {
+          "from_arg": "reason"
+        }
+      },
+      "allowed_columns": [
+        "late_fee_cents",
+        "waiver_reason"
+      ],
+      "numeric_bounds": {
+        "late_fee_cents": {
+          "minimum": 0,
+          "maximum": 10000
+        }
+      },
+      "conflict_guard": {
+        "column": "updated_at"
+      },
+      "approval": {
+        "mode": "human",
+        "required_role": "billing_lead"
+      }
+    }
+  ]
+}

package/fixtures/benchmark/mcp-efficiency.json

@@ -0,0 +1,53 @@
+{
+  "benchmark": "mcp-efficiency",
+  "fixture": "late-fee-waiver",
+  "tokenizer": {
+    "name": "synapsor-fixture-tokenizer-v1",
+    "version": 1,
+    "method": "deterministic regex tokenization for fixture comparison; not a model billing tokenizer"
+  },
+  "note": "This benchmark compares the included fixture/reference workflow only. It is not a universal token-savings claim.",
+  "paths": {
+    "generic_database_mcp_reference": {
+      "exposed_tools": 4,
+      "serialized_tools_list_bytes": 822,
+      "serialized_tools_list_tokens": 298,
+      "schema_context_bytes": 215,
+      "schema_context_tokens": 75,
+      "business_result_bytes": 199,
+      "business_result_tokens": 77,
+      "scripted_tool_calls": 5,
+      "exposes_raw_sql": true,
+      "exposes_write_credentials": false,
+      "approval_separated": false,
+      "stale_row_conflict_checked": false
+    },
+    "synapsor_runner_semantic_path": {
+      "exposed_tools": 2,
+      "serialized_tools_list_bytes": 728,
+      "serialized_tools_list_tokens": 236,
+      "schema_context_bytes": 331,
+      "schema_context_tokens": 87,
+      "business_result_bytes": 277,
+      "business_result_tokens": 91,
+      "scripted_tool_calls": 2,
+      "exposes_raw_sql": false,
+      "exposes_write_credentials": false,
+      "approval_separated": true,
+      "stale_row_conflict_checked": true
+    }
+  },
+  "scripted_plans": {
+    "generic_database_mcp_reference": [
+      "list_tables",
+      "describe_table invoices",
+      "query_database SELECT invoice",
+      "formulate raw UPDATE",
+      "execute_sql UPDATE invoice"
+    ],
+    "synapsor_runner_semantic_path": [
+      "billing.inspect_invoice",
+      "billing.propose_late_fee_waiver"
+    ]
+  }
+}

package/fixtures/benchmark/mcp-efficiency.txt

@@ -0,0 +1,25 @@
+MCP efficiency benchmark: late-fee-waiver fixture
+Tokenizer: synapsor-fixture-tokenizer-v1 (deterministic fixture tokenizer; not a model billing tokenizer)
+Scope: included fixture/reference workflow only; not a universal savings claim.
+
+Generic database MCP reference:
+  exposed tools: 4
+  tools/list: 822 bytes, 298 tokens
+  scripted tool calls: 5
+  schema/context: 215 bytes, 75 tokens
+  business result: 199 bytes, 77 tokens
+  raw SQL exposed: yes
+  approval separated: no
+  stale-row conflict checked: no
+
+Synapsor Runner semantic path:
+  exposed tools: 2
+  tools/list: 728 bytes, 236 tokens
+  scripted tool calls: 2
+  schema/context: 331 bytes, 87 tokens
+  business result: 277 bytes, 91 tokens
+  raw SQL exposed: no
+  approval separated: yes
+  stale-row conflict checked: yes
+
+Run with --json to inspect machine-readable measurements and scripted plans.

package/fixtures/protocol/MANIFEST.json

@@ -0,0 +1,54 @@
+{
+  "schema_version": "synapsor.protocol-manifest.v1",
+  "protocol_set": "database-mcp-writeback",
+  "version": "0.1.0-alpha",
+  "hash_algorithm": "sha256",
+  "note": "This manifest is copied in Synapsor main protocol/MANIFEST.json and synapsor-runner fixtures/protocol/MANIFEST.json. Hashes are over the checked-in JSON artifact bytes.",
+  "artifacts": [
+    {
+      "kind": "fixture",
+      "name": "change-set.late-fee-waiver.v1.json",
+      "sha256": "7112d0f28832e61b4ac5846d169666c0476ba92eb68c6790c10ac614ee3f2b33"
+    },
+    {
+      "kind": "fixture",
+      "name": "execution-receipt.applied.v1.json",
+      "sha256": "5af8be1b72b03d5a4c7af22748d9ade9f0febbf5e9503931054361ef998b5870"
+    },
+    {
+      "kind": "fixture",
+      "name": "execution-receipt.conflict.v1.json",
+      "sha256": "64e8a5fd90cdeafa2dd92a2c67cad1307b9d09e585cc82b06b987bde382f7733"
+    },
+    {
+      "kind": "fixture",
+      "name": "runner-registration.v1.json",
+      "sha256": "3eaf844cdc94a4274601cedfed7252d65dd837a345c8c3b0f17ab6bbdf7f75da"
+    },
+    {
+      "kind": "fixture",
+      "name": "writeback-job.late-fee-waiver.v1.json",
+      "sha256": "577e7987427031b55134c3d7296e644b1c8b7adec495758d4cff3665e954dbc8"
+    },
+    {
+      "kind": "schema",
+      "name": "change-set.v1.schema.json",
+      "sha256": "4e52b369b0d3bea30b0ed7b61ec239fc67de3dc691ed4014d6d5eabc7d2be4de"
+    },
+    {
+      "kind": "schema",
+      "name": "execution-receipt.v1.schema.json",
+      "sha256": "69504ce51fa66440e42d57ef6cb36cc6d8543427d8d385c9ccff954ecae5ec83"
+    },
+    {
+      "kind": "schema",
+      "name": "runner-registration.v1.schema.json",
+      "sha256": "86242555545b44ae747965ddb8aa35e2982587c76c2538f0f646e8b63994286b"
+    },
+    {
+      "kind": "schema",
+      "name": "writeback-job.v1.schema.json",
+      "sha256": "eab35194dd6b6caa7694aa8f14afbf265338d6ee8ed3d3db5d08ec83c4e7092e"
+    }
+  ]
+}

package/fixtures/protocol/change-set.late-fee-waiver.v1.json

@@ -0,0 +1,72 @@
+{
+  "schema_version": "synapsor.change-set.v1",
+  "proposal_id": "wrp_123",
+  "proposal_version": 1,
+  "action": "billing.waive_late_fee",
+  "mode": "review_required",
+  "principal": {
+    "id": "support_agent_17",
+    "source": "trusted_session"
+  },
+  "scope": {
+    "tenant_id": "acme",
+    "business_object": "invoice",
+    "object_id": "INV-3001"
+  },
+  "source": {
+    "kind": "external_postgres",
+    "source_id": "src_pg_acme",
+    "schema": "public",
+    "table": "invoices",
+    "primary_key": {
+      "column": "id",
+      "value": "INV-3001"
+    }
+  },
+  "before": {
+    "late_fee_cents": 5500,
+    "waiver_reason": null,
+    "updated_at": "2026-06-20T14:31:08Z"
+  },
+  "patch": {
+    "late_fee_cents": 0,
+    "waiver_reason": "customer requested review"
+  },
+  "after": {
+    "late_fee_cents": 0,
+    "waiver_reason": "customer requested review",
+    "updated_at": "2026-06-20T14:31:08Z"
+  },
+  "guards": {
+    "tenant": {
+      "column": "tenant_id",
+      "value": "acme"
+    },
+    "allowed_columns": [
+      "late_fee_cents",
+      "waiver_reason"
+    ],
+    "expected_version": {
+      "column": "updated_at",
+      "value": "2026-06-20T14:31:08Z"
+    }
+  },
+  "evidence": {
+    "bundle_id": "ev_456",
+    "query_fingerprint": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+    "items": []
+  },
+  "approval": {
+    "status": "pending",
+    "required_role": "support_lead"
+  },
+  "writeback": {
+    "status": "not_applied",
+    "mode": "trusted_worker_required"
+  },
+  "source_database_mutated": false,
+  "integrity": {
+    "proposal_hash": "sha256:2222222222222222222222222222222222222222222222222222222222222222"
+  },
+  "created_at": "2026-06-20T14:31:09Z"
+}

package/fixtures/protocol/execution-receipt.applied.v1.json

@@ -0,0 +1,14 @@
+{
+  "schema_version": "synapsor.execution-receipt.v1",
+  "writeback_job_id": "wbj_123",
+  "proposal_id": "wrp_123",
+  "runner_id": "runner_123",
+  "status": "applied",
+  "rows_affected": 1,
+  "idempotency_key": "wrp_123:INV-3001",
+  "previous_version": "2026-06-20T14:31:08Z",
+  "new_version": "2026-06-20T14:34:19Z",
+  "source_database_mutated": true,
+  "executed_at": "2026-06-20T14:34:19Z",
+  "receipt_hash": "sha256:3333333333333333333333333333333333333333333333333333333333333333"
+}

package/fixtures/protocol/execution-receipt.conflict.v1.json

@@ -0,0 +1,15 @@
+{
+  "schema_version": "synapsor.execution-receipt.v1",
+  "writeback_job_id": "wbj_124",
+  "proposal_id": "wrp_124",
+  "runner_id": "runner_123",
+  "status": "conflict",
+  "rows_affected": 0,
+  "idempotency_key": "wrp_124:INV-3001",
+  "previous_version": "2026-06-20T14:31:08Z",
+  "new_version": "2026-06-20T14:39:19Z",
+  "source_database_mutated": false,
+  "executed_at": "2026-06-20T14:40:19Z",
+  "safe_error_code": "VERSION_CONFLICT",
+  "receipt_hash": "sha256:4444444444444444444444444444444444444444444444444444444444444444"
+}

package/fixtures/protocol/runner-registration.v1.json

@@ -0,0 +1,22 @@
+{
+  "schema_version": "synapsor.runner-registration.v1",
+  "runner_id": "runner_123",
+  "runner_version": "0.1.0-alpha.0",
+  "engines": [
+    "postgres",
+    "mysql"
+  ],
+  "capabilities": [
+    "single_row_update",
+    "idempotency_receipts",
+    "version_conflict_guard"
+  ],
+  "scope": {
+    "project_id": "acme-support",
+    "source_ids": [
+      "src_pg_acme",
+      "src_mysql_acme"
+    ]
+  },
+  "registered_at": "2026-06-20T14:30:00Z"
+}

package/fixtures/protocol/writeback-job.late-fee-waiver.v1.json

@@ -0,0 +1,44 @@
+{
+  "schema_version": "synapsor.writeback-job.v1",
+  "writeback_job_id": "wbj_123",
+  "proposal_id": "wrp_123",
+  "proposal_version": 1,
+  "proposal_hash": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+  "runner_scope": {
+    "project_id": "acme-support",
+    "source_id": "src_pg_acme"
+  },
+  "engine": "postgres",
+  "operation": "single_row_update",
+  "target": {
+    "schema": "public",
+    "table": "invoices",
+    "primary_key": {
+      "column": "id",
+      "value": "INV-3001"
+    }
+  },
+  "tenant_guard": {
+    "column": "tenant_id",
+    "value": "acme"
+  },
+  "allowed_columns": [
+    "late_fee_cents",
+    "waiver_reason"
+  ],
+  "patch": {
+    "late_fee_cents": 0,
+    "waiver_reason": "approved support waiver"
+  },
+  "conflict_guard": {
+    "kind": "column",
+    "column": "updated_at",
+    "expected_value": "2026-06-20T14:31:08Z"
+  },
+  "idempotency_key": "wrp_123:INV-3001",
+  "lease": {
+    "lease_id": "lease_123",
+    "attempt": 1,
+    "expires_at": "2026-06-20T14:36:00Z"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@synapsor/runner",
-  "version": "0.1.0-alpha.9",
-  "description": "Commit-safe MCP runner for Postgres and MySQL agents",
+  "version": "0.1.1",
+  "description": "Stop giving AI agents execute_sql; expose reviewed Postgres/MySQL MCP actions with proposals, approval, writeback, and replay.",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {
@@ -16,15 +16,39 @@
     "dist/runner.mjs",
     "docs/**/*.md",
     "examples/dangerous-mcp-tools.json",
+    "examples/app-owned-writeback/**",
+    "examples/claude-desktop-postgres/**",
+    "examples/cursor-postgres/**",
+    "examples/mcp-postgres-billing-app-handler/**",
+    "examples/mysql-refund-agent/**",
     "examples/openai-agents-http/**",
     "examples/openai-agents-stdio/**",
+    "examples/raw-sql-vs-synapsor/**",
     "examples/reference-support-billing-app/**",
+    "examples/support-billing-agent/**",
+    "fixtures/**",
+    "schemas/**",
     "recipes/**/*.json",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE",
     "NOTICE",
     "TRADEMARKS.md"
   ],
+  "keywords": [
+    "mcp",
+    "postgres",
+    "mysql",
+    "ai-agents",
+    "sql-safety",
+    "database-safety",
+    "openai-agents",
+    "claude",
+    "cursor",
+    "writeback",
+    "replay",
+    "model-context-protocol"
+  ],
   "engines": {
     "node": ">=22.5.0"
   },
@@ -52,7 +76,6 @@
     "url": "https://synapsor.ai/contact"
   },
   "publishConfig": {
-    "access": "public",
-    "tag": "alpha"
+    "access": "public"
   }
 }