gatewaysdk 0.3.2__py3-none-any.whl

gatewaysdk/environment/schema/connectors/linear/handlers.py

@@ -0,0 +1,20 @@
+"""Linear world tools; every mutation goes through the schema store."""
+
+from gateway_env import store, tool
+
+
+@tool(name="list_issues")
+def list_issues(team_id):
+    return [i for i in store.list("linear_issues") if i["team_id"] == team_id]
+
+
+@tool(name="create_issue")
+def create_issue(issue):
+    return store.insert("linear_issues", issue, source={"record": "tool.create_issue"})
+
+
+@tool(name="set_state")
+def set_state(id, state):
+    return store.update(
+        "linear_issues", {"id": id}, {"state": state}, source={"record": "tool.set_state"}
+    )

gatewaysdk/environment/schema/connectors/linear/world.json

@@ -0,0 +1,363 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:gateway:connector:linear",
+  "$defs": {
+    "Team": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "key": {
+          "$ref": "base.json#/$defs/Label"
+        },
+        "name": {
+          "$ref": "base.json#/$defs/Label"
+        }
+      },
+      "required": [
+        "id",
+        "key",
+        "name"
+      ],
+      "additionalProperties": false
+    },
+    "User": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "name": {
+          "$ref": "base.json#/$defs/Label"
+        },
+        "email": {
+          "$ref": "base.json#/$defs/Email"
+        }
+      },
+      "required": [
+        "id",
+        "name",
+        "email"
+      ],
+      "additionalProperties": false
+    },
+    "Project": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "team_id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "name": {
+          "$ref": "base.json#/$defs/Label"
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "planned",
+            "started",
+            "paused",
+            "completed",
+            "canceled"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "team_id",
+        "name",
+        "state"
+      ],
+      "additionalProperties": false
+    },
+    "Issue": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "team_id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "identifier": {
+          "$ref": "base.json#/$defs/Label"
+        },
+        "title": {
+          "$ref": "base.json#/$defs/Label"
+        },
+        "description": {
+          "anyOf": [
+            {
+              "$ref": "base.json#/$defs/Text"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "backlog",
+            "todo",
+            "in_progress",
+            "done",
+            "canceled"
+          ]
+        },
+        "priority": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 4
+        },
+        "assignee_id": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "project_id": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "created_at": {
+          "$ref": "base.json#/$defs/Timestamp"
+        }
+      },
+      "required": [
+        "id",
+        "team_id",
+        "identifier",
+        "title",
+        "state",
+        "priority",
+        "created_at"
+      ],
+      "additionalProperties": false
+    },
+    "Comment": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "issue_id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "user_id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "body": {
+          "$ref": "base.json#/$defs/Text"
+        },
+        "created_at": {
+          "$ref": "base.json#/$defs/Timestamp"
+        }
+      },
+      "required": [
+        "id",
+        "issue_id",
+        "user_id",
+        "body",
+        "created_at"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "x-gateway": {
+    "version": 1,
+    "domain_version": "1.0.0",
+    "package": {
+      "id": "gateway-connector-linear",
+      "version": "1.0.0"
+    },
+    "entities": {
+      "linear_teams": {
+        "schema": {
+          "$ref": "#/$defs/Team"
+        },
+        "primary_key": [
+          "id"
+        ],
+        "unique": [
+          [
+            "key"
+          ]
+        ],
+        "relationships": []
+      },
+      "linear_users": {
+        "schema": {
+          "$ref": "#/$defs/User"
+        },
+        "primary_key": [
+          "id"
+        ],
+        "unique": [
+          [
+            "email"
+          ]
+        ],
+        "relationships": []
+      },
+      "linear_projects": {
+        "schema": {
+          "$ref": "#/$defs/Project"
+        },
+        "primary_key": [
+          "id"
+        ],
+        "unique": [],
+        "relationships": [
+          {
+            "fields": [
+              "team_id"
+            ],
+            "target": "linear_teams",
+            "on_delete": "restrict"
+          }
+        ]
+      },
+      "linear_issues": {
+        "schema": {
+          "$ref": "#/$defs/Issue"
+        },
+        "primary_key": [
+          "id"
+        ],
+        "unique": [
+          [
+            "identifier"
+          ]
+        ],
+        "relationships": [
+          {
+            "fields": [
+              "team_id"
+            ],
+            "target": "linear_teams",
+            "on_delete": "restrict"
+          },
+          {
+            "fields": [
+              "assignee_id"
+            ],
+            "target": "linear_users",
+            "on_delete": "restrict"
+          },
+          {
+            "fields": [
+              "project_id"
+            ],
+            "target": "linear_projects",
+            "on_delete": "restrict"
+          }
+        ]
+      },
+      "linear_comments": {
+        "schema": {
+          "$ref": "#/$defs/Comment"
+        },
+        "primary_key": [
+          "id"
+        ],
+        "unique": [],
+        "relationships": [
+          {
+            "fields": [
+              "issue_id"
+            ],
+            "target": "linear_issues",
+            "on_delete": "restrict"
+          },
+          {
+            "fields": [
+              "user_id"
+            ],
+            "target": "linear_users",
+            "on_delete": "restrict"
+          }
+        ]
+      }
+    },
+    "tools": {
+      "list_issues": {
+        "input": {
+          "type": "object",
+          "properties": {
+            "team_id": {
+              "$ref": "base.json#/$defs/Id"
+            }
+          },
+          "required": [
+            "team_id"
+          ],
+          "additionalProperties": false
+        },
+        "output": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Issue"
+          }
+        },
+        "description": "Issues owned by one team."
+      },
+      "create_issue": {
+        "input": {
+          "type": "object",
+          "properties": {
+            "issue": {
+              "$ref": "#/$defs/Issue"
+            }
+          },
+          "required": [
+            "issue"
+          ],
+          "additionalProperties": false
+        },
+        "output": {
+          "$ref": "#/$defs/Issue"
+        },
+        "description": "Create an issue; team, assignee and project must exist."
+      },
+      "set_state": {
+        "input": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "$ref": "base.json#/$defs/Id"
+            },
+            "state": {
+              "type": "string",
+              "enum": [
+                "backlog",
+                "todo",
+                "in_progress",
+                "done",
+                "canceled"
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "state"
+          ],
+          "additionalProperties": false
+        },
+        "output": {
+          "$ref": "#/$defs/Issue"
+        },
+        "description": "Move an issue to a workflow state."
+      }
+    }
+  }
+}

gatewaysdk/environment/schema/connectors/microsoft-teams/fidelity.json

@@ -0,0 +1,45 @@
+{
+  "connector": "microsoft-teams",
+  "domain_id": "urn:gateway:connector:microsoft-teams",
+  "domain_version": "1.0.0",
+  "api_version": "v1.0",
+  "shape": "base",
+  "label": "subset",
+  "assessment": "provisional",
+  "assessed_on": "2026-09-07",
+  "evidence": "provenance.json; independently authored synthetic fixtures",
+  "coverage": {
+    "entity_count": 17,
+    "type_count": 78,
+    "membership_variants": 7,
+    "event_variants": 30,
+    "scope_document": "scope.md"
+  },
+  "checks": {
+    "structural_validation": {
+      "status": "passed",
+      "command": "PYTHONPATH=gatewaysdk/sdk/src /private/tmp/gateway-teams-venv/bin/python -m pytest gatewaysdk/sdk/tests/environment -q",
+      "result": "716 passed in 88.94s",
+      "python": "3.12"
+    },
+    "synthetic_round_trip": {
+      "status": "passed",
+      "record_count": 46,
+      "evidence": "samples/schema-worlds/microsoft-teams/example.py",
+      "scope": "46 records, exact retry, SQL rejection, audit, deterministic export, current evidence digests"
+    },
+    "live_response_validation": {
+      "status": "skipped",
+      "reason": "No authorized live capture or sandbox; fixtures are synthetic."
+    },
+    "behavioral_equivalence": {"status": "not_applicable", "reason": "Empty tool catalog."},
+    "surface_parity": {"status": "not_applicable", "reason": "No MCP surface."},
+    "drift_monitoring": {"status": "not_implemented", "reason": "Pinned sources only."},
+    "packaging": {
+      "status": "passed",
+      "scope": "Built and installed merged SDK wheel; all nine templates initialize, check and materialize.",
+      "installed_wheel": "50 scaffold tests passed in 4.60s, including supporting artifacts, capability expansion and bytecode caches."
+    }
+  },
+  "limitations": "scope.md#enforcement-boundary-and-future-mapper-obligations; no live goldens or behavior claim"
+}

gatewaysdk/environment/schema/connectors/microsoft-teams/handlers.py

@@ -0,0 +1 @@
+"""Microsoft Teams schema foundation. No simulated tools are declared."""