@commandable/integration-data 0.4.0 → 0.5.0

package/integrations/notion/manifest.json

@@ -0,0 +1,169 @@
+{
+  "name": "notion",
+  "version": "0.1.0",
+  "baseUrl": "https://api.notion.com/v1",
+  "toolsets": {
+    "pages": {
+      "label": "Pages",
+      "description": "Find, read, and edit Notion pages, blocks, comments, and users"
+    },
+    "databases": {
+      "label": "Databases",
+      "description": "Query and manage Notion databases"
+    }
+  },
+  "tools": [
+    {
+      "name": "search",
+      "description": "Search across all accessible Notion content (pages, databases).",
+      "inputSchema": "schemas/search.json",
+      "handler": "handlers/search.js",
+      "scope": "read",
+      "toolset": "pages"
+    },
+    {
+      "name": "retrieve_page",
+      "description": "Retrieve a page by ID.",
+      "inputSchema": "schemas/id_page.json",
+      "handler": "handlers/retrieve_page.js",
+      "scope": "read",
+      "toolset": "pages"
+    },
+    {
+      "name": "retrieve_page_property_item",
+      "description": "Retrieve a specific page property item (handles rollups and pagination).",
+      "inputSchema": "schemas/retrieve_page_property_item.json",
+      "handler": "handlers/retrieve_page_property_item.js",
+      "scope": "read",
+      "toolset": "pages"
+    },
+    {
+      "name": "list_block_children",
+      "description": "List child blocks for a block (including page blocks).",
+      "inputSchema": "schemas/list_block_children.json",
+      "handler": "handlers/list_block_children.js",
+      "scope": "read",
+      "toolset": "pages"
+    },
+    {
+      "name": "retrieve_block",
+      "description": "Retrieve a block by ID.",
+      "inputSchema": "schemas/id_block.json",
+      "handler": "handlers/retrieve_block.js",
+      "scope": "read",
+      "toolset": "pages"
+    },
+    {
+      "name": "list_users",
+      "description": "List users in the workspace.",
+      "inputSchema": "schemas/list_users.json",
+      "handler": "handlers/list_users.js",
+      "scope": "read",
+      "toolset": "pages"
+    },
+    {
+      "name": "retrieve_user",
+      "description": "Retrieve a user by ID.",
+      "inputSchema": "schemas/id_user.json",
+      "handler": "handlers/retrieve_user.js",
+      "scope": "read",
+      "toolset": "pages"
+    },
+    {
+      "name": "list_comments",
+      "description": "List comments for a given discussion or page block.",
+      "inputSchema": "schemas/list_comments.json",
+      "handler": "handlers/list_comments.js",
+      "scope": "read",
+      "toolset": "pages"
+    },
+    {
+      "name": "get_me",
+      "description": "Retrieve the authenticated user (bot) profile.",
+      "inputSchema": "schemas/empty.json",
+      "handler": "handlers/get_me.js",
+      "scope": "read",
+      "toolset": "pages"
+    },
+    {
+      "name": "create_page",
+      "description": "Create a new page in a database or as a child of a page.",
+      "inputSchema": "schemas/create_page.json",
+      "handler": "handlers/create_page.js",
+      "scope": "write",
+      "toolset": "pages"
+    },
+    {
+      "name": "update_page_properties",
+      "description": "Update page properties, archive/unarchive, icon and cover.",
+      "inputSchema": "schemas/update_page_properties.json",
+      "handler": "handlers/update_page_properties.js",
+      "scope": "write",
+      "toolset": "pages"
+    },
+    {
+      "name": "append_block_children",
+      "description": "Append child blocks to a block (including page blocks).",
+      "inputSchema": "schemas/append_block_children.json",
+      "handler": "handlers/append_block_children.js",
+      "scope": "write",
+      "toolset": "pages"
+    },
+    {
+      "name": "update_block",
+      "description": "Update a block (content, archived state, etc).",
+      "inputSchema": "schemas/update_block.json",
+      "handler": "handlers/update_block.js",
+      "scope": "write",
+      "toolset": "pages"
+    },
+    {
+      "name": "delete_block",
+      "description": "Archive a block (soft delete).",
+      "inputSchema": "schemas/delete_block.json",
+      "handler": "handlers/delete_block.js",
+      "scope": "write",
+      "toolset": "pages"
+    },
+    {
+      "name": "create_comment",
+      "description": "Create a comment on a discussion or block.",
+      "inputSchema": "schemas/create_comment.json",
+      "handler": "handlers/create_comment.js",
+      "scope": "write",
+      "toolset": "pages"
+    },
+    {
+      "name": "retrieve_database",
+      "description": "Retrieve a database by ID.",
+      "inputSchema": "schemas/id_database.json",
+      "handler": "handlers/retrieve_database.js",
+      "scope": "read",
+      "toolset": "databases"
+    },
+    {
+      "name": "query_database",
+      "description": "Query a database with optional filter, sorts, and pagination.",
+      "inputSchema": "schemas/query_database.json",
+      "handler": "handlers/query_database.js",
+      "scope": "read",
+      "toolset": "databases"
+    },
+    {
+      "name": "create_database",
+      "description": "Create a new database under a page.",
+      "inputSchema": "schemas/create_database.json",
+      "handler": "handlers/create_database.js",
+      "scope": "write",
+      "toolset": "databases"
+    },
+    {
+      "name": "update_database",
+      "description": "Update database title, description, properties, or archived state.",
+      "inputSchema": "schemas/update_database.json",
+      "handler": "handlers/update_database.js",
+      "scope": "write",
+      "toolset": "databases"
+    }
+  ]
+}

package/integrations/notion/prompt.md

@@ -0,0 +1,26 @@
+## Appending paragraph blocks
+
+When appending a paragraph block to a Notion page, ensure the `rich_text` field is correctly defined within the `paragraph` type. Example format:
+
+```json
+{
+  "block_id": "<page_id>",
+  "children": [
+    {
+      "object": "block",
+      "type": "paragraph",
+      "paragraph": {
+        "rich_text": [
+          {
+            "type": "text",
+            "text": {
+              "content": "Your text here"
+            }
+          }
+        ]
+      }
+    }
+  ]
+}
+```
+

package/integrations/notion/schemas/append_block_children.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["block_id", "children"],
+  "additionalProperties": false,
+  "properties": {
+    "block_id": { "type": "string" },
+    "children": { "type": "array", "items": { "type": "object" } }
+  }
+}

package/integrations/notion/schemas/create_comment.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["parent", "rich_text"],
+  "additionalProperties": false,
+  "properties": {
+    "parent": {
+      "type": "object",
+      "description": "Parent discussion_id or block_id.",
+      "additionalProperties": false,
+      "properties": {
+        "discussion_id": { "type": "string" },
+        "block_id": { "type": "string" }
+      }
+    },
+    "rich_text": { "type": "array", "items": { "type": "object" } }
+  }
+}

package/integrations/notion/schemas/create_database.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["parent", "title", "properties"],
+  "additionalProperties": false,
+  "properties": {
+    "parent": {
+      "type": "object",
+      "description": "Parent page where the database will be created.",
+      "additionalProperties": false,
+      "properties": {
+        "page_id": { "type": "string" }
+      }
+    },
+    "title": { "type": "array", "items": { "type": "object" } },
+    "properties": { "type": "object" }
+  }
+}

package/integrations/notion/schemas/create_page.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["parent", "properties"],
+  "additionalProperties": false,
+  "properties": {
+    "parent": {
+      "type": "object",
+      "description": "Parent object specifying database_id or page_id.",
+      "additionalProperties": false,
+      "properties": {
+        "database_id": { "type": "string" },
+        "page_id": { "type": "string" },
+        "type": { "type": "string" }
+      }
+    },
+    "properties": { "type": "object", "description": "Page properties map per Notion API." },
+    "children": { "type": "array", "items": { "type": "object" } },
+    "icon": { "type": ["object", "null"] },
+    "cover": { "type": ["object", "null"] }
+  }
+}

package/integrations/notion/schemas/delete_block.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["block_id"],
+  "additionalProperties": false,
+  "properties": {
+    "block_id": { "type": "string" }
+  }
+}

package/integrations/notion/schemas/empty.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}

package/integrations/notion/schemas/id_block.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["block_id"],
+  "properties": {
+    "block_id": { "type": "string" }
+  },
+  "additionalProperties": false
+}

package/integrations/notion/schemas/id_database.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["database_id"],
+  "properties": {
+    "database_id": { "type": "string" }
+  },
+  "additionalProperties": false
+}

package/integrations/notion/schemas/id_page.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["page_id"],
+  "properties": {
+    "page_id": { "type": "string" }
+  },
+  "additionalProperties": false
+}

package/integrations/notion/schemas/id_user.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["user_id"],
+  "properties": {
+    "user_id": { "type": "string" }
+  },
+  "additionalProperties": false
+}

package/integrations/notion/schemas/list_block_children.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["block_id"],
+  "properties": {
+    "block_id": { "type": "string" },
+    "start_cursor": { "type": "string" },
+    "page_size": { "type": "number", "minimum": 1, "maximum": 100 }
+  },
+  "additionalProperties": false
+}

package/integrations/notion/schemas/list_comments.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "block_id": { "type": "string" },
+    "discussion_id": { "type": "string" },
+    "start_cursor": { "type": "string" },
+    "page_size": { "type": "number", "minimum": 1, "maximum": 100 }
+  },
+  "anyOf": [
+    { "required": ["block_id"] },
+    { "required": ["discussion_id"] }
+  ],
+  "additionalProperties": false
+}

package/integrations/notion/schemas/list_users.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "start_cursor": { "type": "string" },
+    "page_size": { "type": "number", "minimum": 1, "maximum": 100 }
+  },
+  "additionalProperties": false
+}

package/integrations/notion/schemas/query_database.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["database_id"],
+  "properties": {
+    "database_id": { "type": "string" },
+    "filter": { "type": ["object", "null"] },
+    "sorts": { "type": ["array", "null"], "items": { "type": "object" } },
+    "start_cursor": { "type": "string" },
+    "page_size": { "type": "number", "minimum": 1, "maximum": 100 }
+  },
+  "additionalProperties": false
+}

package/integrations/notion/schemas/retrieve_page_property_item.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["page_id", "property_id"],
+  "properties": {
+    "page_id": { "type": "string" },
+    "property_id": { "type": "string" },
+    "start_cursor": { "type": "string" },
+    "page_size": { "type": "number", "minimum": 1, "maximum": 100 }
+  },
+  "additionalProperties": false
+}

package/integrations/notion/schemas/search.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["query"],
+  "properties": {
+    "query": { "type": "string" },
+    "filter": {
+      "type": "object",
+      "properties": {
+        "value": { "type": "string", "enum": ["page", "database"] },
+        "property": { "type": "string", "enum": ["object"] }
+      },
+      "additionalProperties": false
+    },
+    "sort": {
+      "type": "object",
+      "properties": {
+        "direction": { "type": "string", "enum": ["ascending", "descending"] },
+        "timestamp": { "type": "string", "enum": ["last_edited_time"] }
+      },
+      "additionalProperties": false
+    },
+    "start_cursor": { "type": "string" },
+    "page_size": { "type": "number", "minimum": 1, "maximum": 100 }
+  },
+  "additionalProperties": false
+}

package/integrations/notion/schemas/update_block.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["block_id", "body"],
+  "additionalProperties": false,
+  "properties": {
+    "block_id": { "type": "string" },
+    "body": { "type": "object" }
+  }
+}

package/integrations/notion/schemas/update_database.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["database_id"],
+  "additionalProperties": false,
+  "properties": {
+    "database_id": { "type": "string" },
+    "title": { "type": ["array", "null"], "items": { "type": "object" } },
+    "description": { "type": ["array", "null"], "items": { "type": "object" } },
+    "properties": { "type": ["object", "null"] },
+    "archived": { "type": ["boolean", "null"] }
+  }
+}

package/integrations/notion/schemas/update_page_properties.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["page_id", "properties"],
+  "additionalProperties": false,
+  "properties": {
+    "page_id": { "type": "string" },
+    "properties": { "type": "object" },
+    "archived": { "type": ["boolean", "null"] },
+    "icon": { "type": ["object", "null"] },
+    "cover": { "type": ["object", "null"] }
+  }
+}

package/integrations/trello/.env.test.example

@@ -0,0 +1,9 @@
+# Trello live integration tests
+#
+# Tests create/close/delete a board per run — credentials use key+token as query params.
+#
+# Get an API key + token:
+# - Key:   https://trello.com/power-ups/admin (select your Power-Up, then API key)
+# - Token: https://trello.com/1/authorize?expiration=never&name=CommandableTests&scope=read,write&response_type=token&key=<YOUR_KEY>
+TRELLO_API_KEY=
+TRELLO_API_TOKEN=

package/integrations/trello/README.md

@@ -0,0 +1,50 @@
+# Trello
+
+**34 tools**
+
+![Trello tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/theomccabe/771bd329f303087690c522afa1baa6f3/raw/test-trello.json)
+
+## Credential variants
+
+| Variant | Label |
+|---|---|
+| `api_key_token` | API Key + Token _(default)_ |
+
+## Tools
+
+| Tool | Scope | Description |
+|---|---|---|
+| `get_member` | read | Fetch the current member profile. |
+| `get_member_boards` | read | List boards for the current member. |
+| `get_member_organizations` | read | List organizations (workspaces) for the current member. |
+| `get_board` | read | Fetch a board by id. |
+| `get_board_lists` | read | List lists on a board. |
+| `get_board_cards` | read | List cards on a board. |
+| `get_board_members` | read | List members on a board. |
+| `get_board_labels` | read | List labels on a board. |
+| `get_board_custom_fields` | read | List custom fields on a board. |
+| `get_board_memberships` | read | List memberships for a board. |
+| `get_list` | read | Fetch a list by id. |
+| `get_list_cards` | read | List cards in a list. |
+| `get_card` | read | Fetch a card by id. |
+| `get_card_members` | read | List members assigned to a card. |
+| `get_card_attachments` | read | List attachments on a card. |
+| `get_card_actions` | read | List actions (activity) on a card. |
+| `get_card_checklists` | read | List checklists on a card. |
+| `get_card_custom_field_items` | read | Get custom field items on a card. |
+| `get_organization` | read | Fetch an organization (workspace) by id. |
+| `get_organization_boards` | read | List boards in an organization (workspace). |
+| `search` | read | Search across boards, cards, and members. |
+| `create_board` | write | Create a new board. |
+| `close_board` | write | Close a board (set closed=true). |
+| `delete_board` | write | Permanently delete a closed board. |
+| `create_card` | write | Create a new card in a list. |
+| `update_card` | write | Update a card's fields (name, desc, due, list, etc). |
+| `delete_card` | write | Delete a card. |
+| `move_card_to_list` | write | Move a card to another list. |
+| `add_member_to_card` | write | Add a member to a card. |
+| `remove_member_from_card` | write | Remove a member from a card. |
+| `add_checklist_to_card` | write | Create a checklist on a card. |
+| `create_list` | write | Create a new list on a board. |
+| `update_list` | write | Update a list (name, pos, closed). |
+| `archive_list` | write | Archive a list (set closed=true). |