gatewaysdk 0.3.2__py3-none-any.whl

gatewaysdk/environment/schema/connectors/google-calendar/handlers.py

@@ -0,0 +1,23 @@
+"""Google Calendar world tools; every mutation goes through the schema store."""
+
+from gateway_env import store, tool
+
+
+@tool(name="list_events")
+def list_events(calendar_id):
+    return [e for e in store.list("calendar_events") if e["calendar_id"] == calendar_id]
+
+
+@tool(name="create_event")
+def create_event(event):
+    return store.insert("calendar_events", event, source={"record": "tool.create_event"})
+
+
+@tool(name="cancel_event")
+def cancel_event(calendar_id, id):
+    return store.update(
+        "calendar_events",
+        {"calendar_id": calendar_id, "id": id},
+        {"status": "cancelled"},
+        source={"record": "tool.cancel_event"},
+    )

gatewaysdk/environment/schema/connectors/google-calendar/world.json

@@ -0,0 +1,209 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:gateway:connector:google-calendar",
+  "$defs": {
+    "Calendar": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "summary": {
+          "$ref": "base.json#/$defs/Label"
+        },
+        "time_zone": {
+          "$ref": "base.json#/$defs/Label"
+        },
+        "owner_email": {
+          "$ref": "base.json#/$defs/Email"
+        }
+      },
+      "required": [
+        "id",
+        "summary",
+        "time_zone",
+        "owner_email"
+      ],
+      "additionalProperties": false
+    },
+    "Event": {
+      "type": "object",
+      "properties": {
+        "calendar_id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "summary": {
+          "$ref": "base.json#/$defs/Label"
+        },
+        "description": {
+          "anyOf": [
+            {
+              "$ref": "base.json#/$defs/Text"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "start": {
+          "$ref": "base.json#/$defs/Timestamp"
+        },
+        "end": {
+          "$ref": "base.json#/$defs/Timestamp"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "confirmed",
+            "tentative",
+            "cancelled"
+          ]
+        },
+        "organizer_email": {
+          "$ref": "base.json#/$defs/Email"
+        },
+        "attendees": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "email": {
+                "$ref": "base.json#/$defs/Email"
+              },
+              "response": {
+                "type": "string",
+                "enum": [
+                  "needsAction",
+                  "accepted",
+                  "declined",
+                  "tentative"
+                ]
+              }
+            },
+            "required": [
+              "email",
+              "response"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "calendar_id",
+        "id",
+        "summary",
+        "start",
+        "end",
+        "status",
+        "organizer_email",
+        "attendees"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "x-gateway": {
+    "version": 1,
+    "domain_version": "1.0.0",
+    "package": {
+      "id": "gateway-connector-google-calendar",
+      "version": "1.0.0"
+    },
+    "entities": {
+      "calendar_calendars": {
+        "schema": {
+          "$ref": "#/$defs/Calendar"
+        },
+        "primary_key": [
+          "id"
+        ],
+        "unique": [],
+        "relationships": []
+      },
+      "calendar_events": {
+        "schema": {
+          "$ref": "#/$defs/Event"
+        },
+        "primary_key": [
+          "calendar_id",
+          "id"
+        ],
+        "unique": [],
+        "relationships": [
+          {
+            "fields": [
+              "calendar_id"
+            ],
+            "target": "calendar_calendars",
+            "on_delete": "restrict"
+          }
+        ]
+      }
+    },
+    "tools": {
+      "list_events": {
+        "input": {
+          "type": "object",
+          "properties": {
+            "calendar_id": {
+              "$ref": "base.json#/$defs/Id"
+            }
+          },
+          "required": [
+            "calendar_id"
+          ],
+          "additionalProperties": false
+        },
+        "output": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Event"
+          }
+        },
+        "description": "Events on one calendar."
+      },
+      "create_event": {
+        "input": {
+          "type": "object",
+          "properties": {
+            "event": {
+              "$ref": "#/$defs/Event"
+            }
+          },
+          "required": [
+            "event"
+          ],
+          "additionalProperties": false
+        },
+        "output": {
+          "$ref": "#/$defs/Event"
+        },
+        "description": "Create an event on an existing calendar."
+      },
+      "cancel_event": {
+        "input": {
+          "type": "object",
+          "properties": {
+            "calendar_id": {
+              "$ref": "base.json#/$defs/Id"
+            },
+            "id": {
+              "$ref": "base.json#/$defs/Id"
+            }
+          },
+          "required": [
+            "calendar_id",
+            "id"
+          ],
+          "additionalProperties": false
+        },
+        "output": {
+          "$ref": "#/$defs/Event"
+        },
+        "description": "Mark an event cancelled; the row is kept for history."
+      }
+    }
+  }
+}

gatewaysdk/environment/schema/connectors/google-drive/handlers.py

@@ -0,0 +1,18 @@
+"""Google Drive world tools; every mutation goes through the schema store."""
+
+from gateway_env import store, tool
+
+
+@tool(name="list_files")
+def list_files(folder_id=None):
+    return [f for f in store.list("drive_files") if f.get("folder_id") == folder_id]
+
+
+@tool(name="get_file")
+def get_file(id):
+    return store.get("drive_files", {"id": id})
+
+
+@tool(name="share_file")
+def share_file(permission):
+    return store.insert("drive_permissions", permission, source={"record": "tool.share_file"})

gatewaysdk/environment/schema/connectors/google-drive/world.json

@@ -0,0 +1,286 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:gateway:connector:google-drive",
+  "$defs": {
+    "Folder": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "parent_id": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "name": {
+          "$ref": "base.json#/$defs/Label"
+        },
+        "owner_email": {
+          "$ref": "base.json#/$defs/Email"
+        }
+      },
+      "required": [
+        "id",
+        "name",
+        "owner_email"
+      ],
+      "additionalProperties": false
+    },
+    "File": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "folder_id": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "name": {
+          "$ref": "base.json#/$defs/Label"
+        },
+        "mime_type": {
+          "$ref": "base.json#/$defs/Label"
+        },
+        "size": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "owner_email": {
+          "$ref": "base.json#/$defs/Email"
+        },
+        "modified_at": {
+          "$ref": "base.json#/$defs/Timestamp"
+        },
+        "trashed": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "id",
+        "name",
+        "mime_type",
+        "size",
+        "owner_email",
+        "modified_at",
+        "trashed"
+      ],
+      "additionalProperties": false
+    },
+    "Permission": {
+      "type": "object",
+      "properties": {
+        "file_id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "principal": {
+          "$ref": "base.json#/$defs/Email"
+        },
+        "role": {
+          "type": "string",
+          "enum": [
+            "reader",
+            "commenter",
+            "writer",
+            "owner"
+          ]
+        }
+      },
+      "required": [
+        "file_id",
+        "principal",
+        "role"
+      ],
+      "additionalProperties": false
+    },
+    "Revision": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "file_id": {
+          "$ref": "base.json#/$defs/Id"
+        },
+        "modified_at": {
+          "$ref": "base.json#/$defs/Timestamp"
+        },
+        "size": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "author_email": {
+          "$ref": "base.json#/$defs/Email"
+        }
+      },
+      "required": [
+        "id",
+        "file_id",
+        "modified_at",
+        "size",
+        "author_email"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "x-gateway": {
+    "version": 1,
+    "domain_version": "1.0.0",
+    "package": {
+      "id": "gateway-connector-google-drive",
+      "version": "1.0.0"
+    },
+    "entities": {
+      "drive_folders": {
+        "schema": {
+          "$ref": "#/$defs/Folder"
+        },
+        "primary_key": [
+          "id"
+        ],
+        "unique": [],
+        "relationships": [
+          {
+            "fields": [
+              "parent_id"
+            ],
+            "target": "drive_folders",
+            "on_delete": "restrict"
+          }
+        ]
+      },
+      "drive_files": {
+        "schema": {
+          "$ref": "#/$defs/File"
+        },
+        "primary_key": [
+          "id"
+        ],
+        "unique": [],
+        "relationships": [
+          {
+            "fields": [
+              "folder_id"
+            ],
+            "target": "drive_folders",
+            "on_delete": "restrict"
+          }
+        ]
+      },
+      "drive_permissions": {
+        "schema": {
+          "$ref": "#/$defs/Permission"
+        },
+        "primary_key": [
+          "file_id",
+          "principal"
+        ],
+        "unique": [],
+        "relationships": [
+          {
+            "fields": [
+              "file_id"
+            ],
+            "target": "drive_files",
+            "on_delete": "restrict"
+          }
+        ]
+      },
+      "drive_revisions": {
+        "schema": {
+          "$ref": "#/$defs/Revision"
+        },
+        "primary_key": [
+          "id"
+        ],
+        "unique": [],
+        "relationships": [
+          {
+            "fields": [
+              "file_id"
+            ],
+            "target": "drive_files",
+            "on_delete": "restrict"
+          }
+        ]
+      }
+    },
+    "tools": {
+      "list_files": {
+        "input": {
+          "type": "object",
+          "properties": {
+            "folder_id": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "minLength": 1,
+              "maxLength": 128
+            }
+          },
+          "required": [],
+          "additionalProperties": false
+        },
+        "output": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/File"
+          }
+        },
+        "description": "Files in a folder; null lists the root."
+      },
+      "get_file": {
+        "input": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "$ref": "base.json#/$defs/Id"
+            }
+          },
+          "required": [
+            "id"
+          ],
+          "additionalProperties": false
+        },
+        "output": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/File"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "description": "One file's metadata, or null."
+      },
+      "share_file": {
+        "input": {
+          "type": "object",
+          "properties": {
+            "permission": {
+              "$ref": "#/$defs/Permission"
+            }
+          },
+          "required": [
+            "permission"
+          ],
+          "additionalProperties": false
+        },
+        "output": {
+          "$ref": "#/$defs/Permission"
+        },
+        "description": "Grant a principal a role on an existing file."
+      }
+    }
+  }
+}

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

@@ -0,0 +1,34 @@
+"""Jamf Pro world tools; every mutation goes through the schema store.
+
+Errors carry the status and description the pinned Jamf Pro API spec documents
+for the endpoint each tool mirrors, in the shape of ``ApiError``'s single cause.
+Jamf does not publish the ``code`` values, so none is invented here.
+"""
+
+from gateway_env import store, tool
+
+
+@tool(name="list_computers")
+def list_computers():
+    return store.list("jamf_computers")
+
+
+@tool(name="get_computer")
+def get_computer(id):
+    computer = store.get("jamf_computers", {"id": id})
+    if computer is None:
+        raise ValueError("404: Specified computer object does not exist.")
+    return computer
+
+
+@tool(name="list_policies")
+def list_policies():
+    return store.list("jamf_policies")
+
+
+@tool(name="create_computer_group")
+def create_computer_group(group):
+    taken = any(g["name"] == group["name"] for g in store.list("jamf_computer_groups"))
+    if taken:
+        raise ValueError("422: Duplicate group name.")
+    return store.insert("jamf_computer_groups", group, source={"record": "tool.create_computer_group"})

gatewaysdk/environment/schema/connectors/jamf/parity.json

@@ -0,0 +1,49 @@
+{
+  "version": 1,
+  "connector": "jamf",
+  "status": "subset",
+  "world_tools": [
+    "create_computer_group",
+    "get_computer",
+    "list_computers",
+    "list_policies"
+  ],
+  "registration": {
+    "mode": "remote_mcp",
+    "provider": "user_configured",
+    "managed_tool_allowlist": []
+  },
+  "surfaces": [
+    {
+      "name": "Jamf Developer MCP",
+      "kind": "official_hosted_mcp",
+      "auth": "none for documentation tools",
+      "manifest_validation": "credentialed",
+      "supported_world_tools": [],
+      "limitations": [
+        "The tools expose Jamf API specifications, not tenant data operations."
+      ],
+      "evidence": [
+        "https://developer.jamf.com/developer-guide/docs/mcp",
+        "https://developer.jamf.com/mcp"
+      ]
+    },
+    {
+      "name": "Jamf MCP Hub",
+      "kind": "open_source_remote_mcp",
+      "auth": "Jamf tenant URL, API client ID, and API client secret",
+      "manifest_validation": "public_catalog",
+      "supported_world_tools": [
+        "create_computer_group",
+        "get_computer",
+        "list_computers",
+        "list_policies"
+      ],
+      "limitations": [
+        "Tool names and response contracts do not exactly match the schema world.",
+        "Gateway configures a remote server; tenant credentials remain in the Hub."
+      ],
+      "evidence": ["https://github.com/Jamf-Concepts/mcp-hub"]
+    }
+  ]
+}