@synapsor/runner 0.1.0-alpha.1 → 0.1.0-alpha.2

package/recipes/billing.late_fee_waiver.json

@@ -0,0 +1,46 @@
+{
+  "id": "billing.late_fee_waiver",
+  "title": "Late-fee waiver",
+  "summary": "Inspect one invoice and create a review-required proposal to waive a late fee.",
+  "expected_table_type": "invoice or billing table",
+  "required_columns": ["id", "tenant_id", "late_fee_cents", "waiver_reason", "updated_at"],
+  "recommended_primary_key": "id",
+  "recommended_tenant_key": "tenant_id",
+  "recommended_conflict_column": "updated_at",
+  "visible_columns": ["id", "tenant_id", "late_fee_cents", "waiver_reason", "status", "updated_at"],
+  "allowed_write_columns": ["late_fee_cents", "waiver_reason"],
+  "semantic_tools": ["billing.inspect_invoice", "billing.propose_late_fee_waiver"],
+  "notes": [
+    "Start against staging.",
+    "Keep the model-facing tool proposal-only.",
+    "Set a business-specific maximum waiver bound before real use."
+  ],
+  "spec": {
+    "version": 1,
+    "engine": "postgres",
+    "mode": "review",
+    "schema": "public",
+    "table": "invoices",
+    "primary_key": "id",
+    "tenant_key": "tenant_id",
+    "conflict_column": "updated_at",
+    "namespace": "billing",
+    "object_name": "invoice",
+    "inspect_tool_name": "billing.inspect_invoice",
+    "proposal_tool_name": "billing.propose_late_fee_waiver",
+    "lookup_arg": "invoice_id",
+    "visible_columns": ["id", "tenant_id", "late_fee_cents", "waiver_reason", "status", "updated_at"],
+    "allowed_columns": ["late_fee_cents", "waiver_reason"],
+    "patch": {
+      "late_fee_cents": { "fixed": 0 },
+      "waiver_reason": { "from_arg": "reason" }
+    },
+    "patch_args": {
+      "reason": { "type": "string", "required": true, "max_length": 500 }
+    },
+    "numeric_bounds": {
+      "late_fee_cents": { "minimum": 0, "maximum": 10000 }
+    },
+    "approval": { "required_role": "billing_lead" }
+  }
+}

package/recipes/credits.account_credit.json

@@ -0,0 +1,45 @@
+{
+  "id": "credits.account_credit",
+  "title": "Account credit",
+  "summary": "Inspect one account balance row and propose a bounded account credit.",
+  "expected_table_type": "account credits or balances table",
+  "required_columns": ["id", "tenant_id", "credit_cents", "credit_reason", "updated_at"],
+  "recommended_primary_key": "id",
+  "recommended_tenant_key": "tenant_id",
+  "recommended_conflict_column": "updated_at",
+  "visible_columns": ["id", "tenant_id", "credit_cents", "credit_reason", "updated_at"],
+  "allowed_write_columns": ["credit_cents", "credit_reason"],
+  "semantic_tools": ["credits.inspect_account_credit", "credits.propose_account_credit"],
+  "notes": [
+    "Configure the maximum credit bound before running against real data."
+  ],
+  "spec": {
+    "version": 1,
+    "engine": "postgres",
+    "mode": "review",
+    "schema": "public",
+    "table": "account_credits",
+    "primary_key": "id",
+    "tenant_key": "tenant_id",
+    "conflict_column": "updated_at",
+    "namespace": "credits",
+    "object_name": "account_credit",
+    "inspect_tool_name": "credits.inspect_account_credit",
+    "proposal_tool_name": "credits.propose_account_credit",
+    "lookup_arg": "credit_id",
+    "visible_columns": ["id", "tenant_id", "credit_cents", "credit_reason", "updated_at"],
+    "allowed_columns": ["credit_cents", "credit_reason"],
+    "patch": {
+      "credit_cents": { "from_arg": "credit_cents" },
+      "credit_reason": { "from_arg": "reason" }
+    },
+    "patch_args": {
+      "credit_cents": { "type": "number", "required": true, "minimum": 0, "maximum": 10000 },
+      "reason": { "type": "string", "required": true, "max_length": 500 }
+    },
+    "numeric_bounds": {
+      "credit_cents": { "minimum": 0, "maximum": 10000 }
+    },
+    "approval": { "required_role": "billing_lead" }
+  }
+}

package/recipes/orders.refund_review.json

@@ -0,0 +1,57 @@
+{
+  "id": "orders.refund_review",
+  "title": "Refund review",
+  "summary": "Inspect one order and propose a reviewed refund status update.",
+  "expected_table_type": "orders table",
+  "required_columns": ["id", "tenant_id", "status", "refund_cents", "refund_reason", "updated_at"],
+  "recommended_primary_key": "id",
+  "recommended_tenant_key": "tenant_id",
+  "recommended_conflict_column": "updated_at",
+  "visible_columns": ["id", "tenant_id", "status", "total_cents", "refund_cents", "refund_reason", "updated_at"],
+  "allowed_write_columns": ["status", "refund_cents", "refund_reason"],
+  "semantic_tools": ["orders.inspect_order", "orders.propose_refund_review"],
+  "notes": [
+    "Use numeric bounds that match your real refund policy.",
+    "Keep payment-provider execution outside MCP."
+  ],
+  "spec": {
+    "version": 1,
+    "engine": "mysql",
+    "mode": "review",
+    "schema": "app",
+    "table": "orders",
+    "primary_key": "id",
+    "tenant_key": "tenant_id",
+    "conflict_column": "updated_at",
+    "namespace": "orders",
+    "object_name": "order",
+    "inspect_tool_name": "orders.inspect_order",
+    "proposal_tool_name": "orders.propose_refund_review",
+    "lookup_arg": "order_id",
+    "visible_columns": ["id", "tenant_id", "status", "total_cents", "refund_cents", "refund_reason", "updated_at"],
+    "allowed_columns": ["status", "refund_cents", "refund_reason"],
+    "patch": {
+      "status": { "from_arg": "next_status" },
+      "refund_cents": { "from_arg": "refund_cents" },
+      "refund_reason": { "from_arg": "reason" }
+    },
+    "patch_args": {
+      "next_status": { "type": "string", "required": true, "enum": ["refund_requested", "refunded", "needs_review"] },
+      "refund_cents": { "type": "number", "required": true, "minimum": 0, "maximum": 100000 },
+      "reason": { "type": "string", "required": true, "max_length": 500 }
+    },
+    "numeric_bounds": {
+      "refund_cents": { "minimum": 0, "maximum": 100000 }
+    },
+    "transition_guards": {
+      "status": {
+        "allowed": {
+          "paid": ["refund_requested", "needs_review"],
+          "shipped": ["refund_requested", "needs_review"],
+          "refund_requested": ["refunded", "needs_review"]
+        }
+      }
+    },
+    "approval": { "required_role": "ops_lead" }
+  }
+}

package/recipes/support.ticket_resolution.json

@@ -0,0 +1,51 @@
+{
+  "id": "support.ticket_resolution",
+  "title": "Support ticket resolution",
+  "summary": "Inspect one support ticket and propose a reviewed status/resolution update.",
+  "expected_table_type": "support ticket table",
+  "required_columns": ["id", "tenant_id", "status", "resolution_note", "updated_at"],
+  "recommended_primary_key": "id",
+  "recommended_tenant_key": "tenant_id",
+  "recommended_conflict_column": "updated_at",
+  "visible_columns": ["id", "tenant_id", "subject", "status", "resolution_note", "updated_at"],
+  "allowed_write_columns": ["status", "resolution_note"],
+  "semantic_tools": ["support.inspect_ticket", "support.propose_ticket_resolution"],
+  "notes": [
+    "Use a safe view if ticket bodies contain sensitive data.",
+    "Keep status transitions explicit."
+  ],
+  "spec": {
+    "version": 1,
+    "engine": "postgres",
+    "mode": "review",
+    "schema": "public",
+    "table": "support_tickets",
+    "primary_key": "id",
+    "tenant_key": "tenant_id",
+    "conflict_column": "updated_at",
+    "namespace": "support",
+    "object_name": "ticket",
+    "inspect_tool_name": "support.inspect_ticket",
+    "proposal_tool_name": "support.propose_ticket_resolution",
+    "lookup_arg": "ticket_id",
+    "visible_columns": ["id", "tenant_id", "subject", "status", "resolution_note", "updated_at"],
+    "allowed_columns": ["status", "resolution_note"],
+    "patch": {
+      "status": { "from_arg": "next_status" },
+      "resolution_note": { "from_arg": "resolution_note" }
+    },
+    "patch_args": {
+      "next_status": { "type": "string", "required": true, "enum": ["pending_review", "resolved", "needs_human"] },
+      "resolution_note": { "type": "string", "required": true, "max_length": 1000 }
+    },
+    "transition_guards": {
+      "status": {
+        "allowed": {
+          "open": ["pending_review", "needs_human"],
+          "pending_review": ["resolved", "needs_human"]
+        }
+      }
+    },
+    "approval": { "required_role": "support_lead" }
+  }
+}

package/dist/bin.cjs

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-const { spawnSync } = require('node:child_process');
-const { join } = require('node:path');
-const result = spawnSync(process.execPath, ['--no-warnings', join(__dirname, 'cli.js'), ...process.argv.slice(2)], {
-  stdio: 'inherit',
-  env: { ...process.env, NODE_NO_WARNINGS: '1', SYNAPSOR_RUNNER_COMMAND_NAME: 'synapsor-runner' },
-});
-if (result.error) {
-  console.error(result.error);
-  process.exit(1);
-}
-if (result.signal) process.kill(process.pid, result.signal);
-process.exit(result.status ?? 1);