@synapsor/runner 0.1.0-alpha.1 → 0.1.0-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -13
- package/TRADEMARKS.md +23 -0
- package/dist/cli.js +15 -8723
- package/dist/runner.mjs +8767 -0
- package/docs/MCP_RUNNER_IMPLEMENTATION_PLAN.md +187 -0
- package/docs/README.md +56 -0
- package/docs/architecture.md +65 -0
- package/docs/capability-config.md +180 -0
- package/docs/cloud-mode.md +140 -0
- package/docs/config-migrations.md +67 -0
- package/docs/demo-transcript.md +73 -0
- package/docs/dependency-license-inventory.md +35 -0
- package/docs/first-10-minutes.md +147 -0
- package/docs/getting-started-own-database.md +367 -0
- package/docs/licensing.md +38 -0
- package/docs/limitations.md +75 -0
- package/docs/local-mode.md +246 -0
- package/docs/local-ui.md +163 -0
- package/docs/mcp-audit.md +135 -0
- package/docs/mcp-client-setup.md +155 -0
- package/docs/mcp-efficiency-benchmark.md +84 -0
- package/docs/operations.md +38 -0
- package/docs/own-db-20-minutes.md +185 -0
- package/docs/production-readiness.md +39 -0
- package/docs/protocol.md +90 -0
- package/docs/recipes.md +61 -0
- package/docs/roadmap.md +13 -0
- package/docs/schema-inspection.md +88 -0
- package/docs/security-boundary.md +70 -0
- package/docs/shadow-mode.md +67 -0
- package/docs/telemetry.md +28 -0
- package/docs/threat-model.md +25 -0
- package/docs/troubleshooting-first-run.md +248 -0
- package/docs/trusted-context.md +70 -0
- package/docs/writeback-executors.md +128 -0
- package/examples/dangerous-mcp-tools.json +88 -0
- package/examples/reference-support-billing-app/README.md +86 -0
- package/examples/reference-support-billing-app/docker-compose.yml +13 -0
- package/examples/reference-support-billing-app/mcp-client.generic.json +11 -0
- package/examples/reference-support-billing-app/schema.sql +55 -0
- package/examples/reference-support-billing-app/scripts/run-demo.sh +7 -0
- package/examples/reference-support-billing-app/seed.sql +26 -0
- package/examples/reference-support-billing-app/synapsor.runner.json +136 -0
- package/package.json +10 -4
- package/recipes/accounts.trial_extension.json +42 -0
- package/recipes/billing.late_fee_waiver.json +46 -0
- package/recipes/credits.account_credit.json +45 -0
- package/recipes/orders.refund_review.json +57 -0
- package/recipes/support.ticket_resolution.json +51 -0
- package/dist/bin.cjs +0 -13
package/README.md
CHANGED
|
@@ -1,12 +1,11 @@
|
|
|
1
1
|
# Synapsor Runner
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Safe database tools for AI agents.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
through guarded execution.
|
|
5
|
+
Turn Postgres/MySQL into reviewed MCP capabilities, not raw SQL. Synapsor
|
|
6
|
+
Runner lets an MCP agent inspect scoped data and request database-backed
|
|
7
|
+
business actions without receiving raw SQL, write credentials, approval tools,
|
|
8
|
+
or commit tools.
|
|
10
9
|
|
|
11
10
|
## Run The Alpha
|
|
12
11
|
|
|
@@ -14,14 +13,18 @@ through guarded execution.
|
|
|
14
13
|
npx -y -p @synapsor/runner@alpha synapsor-runner --help
|
|
15
14
|
```
|
|
16
15
|
|
|
16
|
+
The already-published alpha may expose only `synapsor-runner`. This package now
|
|
17
|
+
also exposes `synapsor` as the primary command, with `synapsor-runner` kept as a
|
|
18
|
+
backward-compatible alias.
|
|
19
|
+
|
|
17
20
|
Use it with a local or staging database:
|
|
18
21
|
|
|
19
22
|
```bash
|
|
20
23
|
export DATABASE_URL="postgresql://readonly_user:password@localhost:5432/app"
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
24
|
+
synapsor inspect --engine auto --from-env DATABASE_URL --schema public
|
|
25
|
+
synapsor init --wizard --engine auto --from-env DATABASE_URL --schema public
|
|
26
|
+
synapsor tools preview
|
|
27
|
+
synapsor mcp serve
|
|
25
28
|
```
|
|
26
29
|
|
|
27
30
|
For a longer local session, you can install the alpha package explicitly:
|
|
@@ -50,9 +53,8 @@ local proposals, evidence, receipts, and replay data in a local SQLite store.
|
|
|
50
53
|
|
|
51
54
|
## Command Name
|
|
52
55
|
|
|
53
|
-
This package installs the `synapsor-runner`
|
|
54
|
-
|
|
55
|
-
that command.
|
|
56
|
+
This package installs `synapsor` as the primary binary and `synapsor-runner` as
|
|
57
|
+
a backward-compatible alias.
|
|
56
58
|
|
|
57
59
|
## Scope
|
|
58
60
|
|
package/TRADEMARKS.md
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Trademark Policy
|
|
2
|
+
|
|
3
|
+
Apache License 2.0 grants copyright and patent rights to the code in this
|
|
4
|
+
repository. It does not grant trademark rights.
|
|
5
|
+
|
|
6
|
+
The names "Synapsor" and "Synapsor Runner", Synapsor logos, and Synapsor brand
|
|
7
|
+
assets may not be used to imply endorsement or to operate a confusingly similar
|
|
8
|
+
hosted service.
|
|
9
|
+
|
|
10
|
+
Forks may accurately describe themselves as:
|
|
11
|
+
|
|
12
|
+
- "based on Synapsor Runner";
|
|
13
|
+
- "built with Synapsor Runner";
|
|
14
|
+
- "compatible with Synapsor Runner".
|
|
15
|
+
|
|
16
|
+
Forks may not call themselves "Synapsor", use Synapsor branding as their own
|
|
17
|
+
product branding, or imply that Synapsor sponsors, endorses, or operates the
|
|
18
|
+
fork.
|
|
19
|
+
|
|
20
|
+
Hosted or commercial services based on this code must use their own branding.
|
|
21
|
+
|
|
22
|
+
For trademark permission requests, use the contact form at
|
|
23
|
+
https://synapsor.ai/contact.
|