@synapsor/runner 0.1.0-alpha.9 → 0.1.1

package/schemas/synapsor.runner.schema.json

@@ -0,0 +1,415 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://synapsor.ai/schemas/synapsor.runner.schema.json",
+  "title": "Synapsor Runner config",
+  "description": "Configuration for local Synapsor Runner MCP capabilities over Postgres/MySQL.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "mode", "sources", "trusted_context", "capabilities"],
+  "properties": {
+    "version": {
+      "const": 1
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["read_only", "shadow", "review", "cloud"]
+    },
+    "result_format": {
+      "description": "Set to 2 to return one stable ok/summary/data/proposal/error envelope from MCP tool calls.",
+      "type": "integer",
+      "enum": [1, 2],
+      "default": 1
+    },
+    "strict": {
+      "type": "boolean",
+      "default": true
+    },
+    "storage": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "sqlite_path": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "sources": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "$ref": "#/$defs/source"
+      }
+    },
+    "trusted_context": {
+      "$ref": "#/$defs/trusted_context"
+    },
+    "contexts": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/$defs/trusted_context"
+      }
+    },
+    "executors": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/$defs/executor"
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/capability"
+      }
+    },
+    "cloud": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "$defs": {
+    "env_name": {
+      "type": "string",
+      "pattern": "^[A-Z_][A-Z0-9_]*$"
+    },
+    "identifier": {
+      "type": "string",
+      "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+    },
+    "qualified_name": {
+      "type": "string",
+      "pattern": "^[A-Za-z_][A-Za-z0-9_]*(\\.[A-Za-z_][A-Za-z0-9_]*)+$"
+    },
+    "scalar": {
+      "type": ["string", "number", "boolean", "null"]
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["engine", "read_url_env"],
+      "properties": {
+        "engine": {
+          "type": "string",
+          "enum": ["postgres", "mysql"]
+        },
+        "read_url_env": {
+          "$ref": "#/$defs/env_name"
+        },
+        "write_url_env": {
+          "$ref": "#/$defs/env_name"
+        },
+        "read_only": {
+          "type": "boolean"
+        },
+        "statement_timeout_ms": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "ssl": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    },
+    "trusted_context": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["provider"],
+      "properties": {
+        "provider": {
+          "type": "string",
+          "enum": ["static_dev", "environment", "http_claims", "cloud_session"]
+        },
+        "values": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "tenant_id": {
+              "type": "string"
+            },
+            "principal": {
+              "type": "string"
+            },
+            "tenant_id_env": {
+              "$ref": "#/$defs/env_name"
+            },
+            "principal_env": {
+              "$ref": "#/$defs/env_name"
+            }
+          }
+        }
+      }
+    },
+    "executor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["sql_update", "http_handler", "command_handler"]
+        },
+        "url_env": {
+          "$ref": "#/$defs/env_name"
+        },
+        "method": {
+          "type": "string",
+          "enum": ["POST", "PUT", "PATCH"]
+        },
+        "auth": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "type": {
+              "const": "bearer_env"
+            },
+            "token_env": {
+              "$ref": "#/$defs/env_name"
+            }
+          }
+        },
+        "signing_secret_env": {
+          "$ref": "#/$defs/env_name"
+        },
+        "timeout_ms": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "command_env": {
+          "$ref": "#/$defs/env_name"
+        }
+      }
+    },
+    "capability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "kind", "source", "target", "args", "lookup", "visible_columns"],
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/qualified_name"
+        },
+        "kind": {
+          "type": "string",
+          "enum": ["read", "proposal"]
+        },
+        "description": {
+          "description": "Model-facing text shown in MCP tools/list. Describe when to use the tool.",
+          "type": "string",
+          "minLength": 1
+        },
+        "returns_hint": {
+          "description": "Model-facing hint about what the tool returns.",
+          "type": "string",
+          "minLength": 1
+        },
+        "source": {
+          "type": "string",
+          "minLength": 1
+        },
+        "context": {
+          "type": "string",
+          "minLength": 1
+        },
+        "executor": {
+          "type": "string",
+          "minLength": 1
+        },
+        "target": {
+          "$ref": "#/$defs/target"
+        },
+        "args": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "$ref": "#/$defs/arg"
+          }
+        },
+        "lookup": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id_from_arg"],
+          "properties": {
+            "id_from_arg": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        "visible_columns": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/identifier"
+          }
+        },
+        "evidence": {
+          "type": "string"
+        },
+        "max_rows": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "patch": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/patch_binding"
+          }
+        },
+        "allowed_columns": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/identifier"
+          }
+        },
+        "numeric_bounds": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/numeric_bound"
+          }
+        },
+        "transition_guards": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/transition_guard"
+          }
+        },
+        "conflict_guard": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "column": {
+              "$ref": "#/$defs/identifier"
+            },
+            "weak_guard_ack": {
+              "type": "boolean"
+            }
+          }
+        },
+        "approval": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "mode": {
+              "type": "string"
+            },
+            "required_role": {
+              "type": "string"
+            }
+          }
+        },
+        "single_tenant_dev_ack": {
+          "type": "boolean"
+        }
+      }
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema", "table", "primary_key"],
+      "properties": {
+        "schema": {
+          "$ref": "#/$defs/identifier"
+        },
+        "table": {
+          "$ref": "#/$defs/identifier"
+        },
+        "primary_key": {
+          "$ref": "#/$defs/identifier"
+        },
+        "tenant_key": {
+          "$ref": "#/$defs/identifier"
+        },
+        "single_tenant_dev": {
+          "type": "boolean"
+        }
+      }
+    },
+    "arg": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["string", "number", "boolean"]
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "required": {
+          "type": "boolean"
+        },
+        "max_length": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "minimum": {
+          "type": "number"
+        },
+        "maximum": {
+          "type": "number"
+        },
+        "enum": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/scalar"
+          }
+        }
+      }
+    },
+    "patch_binding": {
+      "type": "object",
+      "additionalProperties": false,
+      "oneOf": [
+        {
+          "required": ["fixed"]
+        },
+        {
+          "required": ["from_arg"]
+        }
+      ],
+      "properties": {
+        "fixed": {
+          "$ref": "#/$defs/scalar"
+        },
+        "from_arg": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "numeric_bound": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "minimum": {
+          "type": "number"
+        },
+        "maximum": {
+          "type": "number"
+        }
+      }
+    },
+    "transition_guard": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["allowed"],
+      "properties": {
+        "from_column": {
+          "$ref": "#/$defs/identifier"
+        },
+        "allowed": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/writeback-job.v1.schema.json

@@ -0,0 +1,121 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.synapsor.ai/synapsor.writeback-job.v1.schema.json",
+  "title": "Synapsor Writeback Job v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "writeback_job_id",
+    "proposal_id",
+    "proposal_version",
+    "proposal_hash",
+    "runner_scope",
+    "engine",
+    "operation",
+    "target",
+    "tenant_guard",
+    "allowed_columns",
+    "patch",
+    "conflict_guard",
+    "idempotency_key",
+    "lease"
+  ],
+  "properties": {
+    "schema_version": { "const": "synapsor.writeback-job.v1" },
+    "writeback_job_id": { "type": "string", "minLength": 1 },
+    "proposal_id": { "type": "string", "minLength": 1 },
+    "proposal_version": { "type": "integer", "minimum": 1 },
+    "proposal_hash": { "type": "string", "pattern": "^sha256:.+" },
+    "runner_scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["project_id", "source_id"],
+      "properties": {
+        "project_id": { "type": "string", "minLength": 1 },
+        "source_id": { "type": "string", "minLength": 1 }
+      }
+    },
+    "engine": { "enum": ["postgres", "mysql"] },
+    "operation": { "const": "single_row_update" },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema", "table", "primary_key"],
+      "properties": {
+        "schema": { "$ref": "#/$defs/safeIdentifier" },
+        "table": { "$ref": "#/$defs/safeIdentifier" },
+        "primary_key": { "$ref": "#/$defs/columnValue" }
+      }
+    },
+    "tenant_guard": { "$ref": "#/$defs/columnValue" },
+    "allowed_columns": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/safeIdentifier" },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "patch": { "$ref": "#/$defs/scalarMap" },
+    "conflict_guard": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "column", "expected_value"],
+          "properties": {
+            "kind": { "const": "column" },
+            "column": { "$ref": "#/$defs/safeIdentifier" },
+            "expected_value": { "$ref": "#/$defs/scalar" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "expected_hash"],
+          "properties": {
+            "kind": { "const": "row_hash" },
+            "expected_hash": { "type": "string", "minLength": 1 }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind"],
+          "properties": {
+            "kind": { "const": "none" }
+          }
+        }
+      ]
+    },
+    "idempotency_key": { "type": "string", "minLength": 1 },
+    "lease": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["lease_id", "attempt", "expires_at"],
+      "properties": {
+        "lease_id": { "type": "string", "minLength": 1 },
+        "attempt": { "type": "integer", "minimum": 1 },
+        "expires_at": { "type": "string", "format": "date-time" }
+      }
+    }
+  },
+  "$defs": {
+    "safeIdentifier": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" },
+    "scalar": { "type": ["string", "number", "boolean", "null"] },
+    "scalarMap": {
+      "type": "object",
+      "propertyNames": { "$ref": "#/$defs/safeIdentifier" },
+      "additionalProperties": { "$ref": "#/$defs/scalar" },
+      "minProperties": 1
+    },
+    "columnValue": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["column", "value"],
+      "properties": {
+        "column": { "$ref": "#/$defs/safeIdentifier" },
+        "value": { "$ref": "#/$defs/scalar" }
+      }
+    }
+  }
+}