@commandable/mcp 0.0.1 → 0.0.4

package/integration-data/README.md

@@ -1,52 +0,0 @@
-Integration Data
-================
-
-Purpose
--------
-
-This directory contains per-integration metadata and tool templates to inject standard read/write capabilities into tasks.
-
-Structure
----------
-
-Each integration lives under its own folder, e.g. `lib/integration-data/trello/`, with:
-
-- `manifest.json`: declarative index of tools and files
-- `schemas/*.json`: JSON Schemas for tool inputs
-- `handlers/*.js`: JavaScript handlers executed in the sandbox; use `integration.fetch()`
-- `prompt.md` (optional): extra prompt notes shown to the LLM
-- `openapi.json` (optional): reference spec; not used at runtime
-
-Manifest format
----------------
-
-```
-{
-  "name": string,
-  "version": string,
-  "baseUrl"?: string,
-  "tools": {
-    "read": [ToolRef],
-    "write": [ToolRef]
-  }
-}
-
-ToolRef := {
-  "name": string,
-  "description": string,
-  "inputSchema": string,   // path to JSON schema file
-  "handler": string        // path to JS handler file
-}
-```
-
-Handler pattern
----------------
-
-Handlers use the `integration.fetch(path, options?)` pattern rather than binding to a concrete integration id. At runtime, the host binds the task's selected integration instance as `integration` in the sandbox.
-
-Notes
------
-
-- Keep schemas strict and aligned with handler expectations.
-- Read tools MUST be side-effect free (GET only). Write tools include POST/PUT/DELETE.
-- Prefer small, composable tools that mirror API resources.

package/integration-data/airtable/credentials.json

@@ -1,20 +0,0 @@
-{
-  "schema": {
-    "type": "object",
-    "properties": {
-      "token": {
-        "type": "string",
-        "title": "Personal Access Token",
-        "description": "Airtable personal access token."
-      }
-    },
-    "required": ["token"],
-    "additionalProperties": false
-  },
-  "injection": {
-    "headers": {
-      "Authorization": "Bearer {{token}}"
-    }
-  }
-}
-

package/integration-data/airtable/credentials_hint.md

@@ -1,4 +0,0 @@
-Create an Airtable personal access token and paste it here.
-
-You can generate one in Airtable account settings under developer tools / personal access tokens.
-

package/integration-data/airtable/handlers/create_record.js

@@ -1,12 +0,0 @@
-async (input) => {
-  const path = `/${input.baseId}/${input.tableId}`
-  const body = {
-    records: [
-      { fields: input.fields },
-    ],
-    typecast: !!input.typecast,
-  }
-  const res = await integration.fetch(path, { method: 'POST', body })
-  const data = await res.json()
-  return data
-}

package/integration-data/airtable/handlers/delete_record.js

@@ -1,7 +0,0 @@
-async (input) => {
-  const path = `/${input.baseId}/${input.tableId}`
-  const params = new URLSearchParams()
-  params.set('records[]', input.recordId)
-  const res = await integration.fetch(`${path}?${params.toString()}`, { method: 'DELETE' })
-  return await res.json()
-}

package/integration-data/airtable/handlers/get_record.js

@@ -1,4 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/${input.baseId}/${input.tableId}/${input.recordId}`)
-  return await res.json()
-}

package/integration-data/airtable/handlers/get_table_schema.js

@@ -1,6 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/meta/bases/${input.baseId}/tables`)
-  const data = await res.json()
-  const table = (data?.tables || data)?.find?.(t => t.id === input.tableId || t.name === input.tableId)
-  return table || null
-}

package/integration-data/airtable/handlers/list_bases.js

@@ -1,4 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/meta/bases`)
-  return await res.json()
-}

package/integration-data/airtable/handlers/list_records.js

@@ -1,25 +0,0 @@
-async (input) => {
-  const params = new URLSearchParams()
-  if (input.view)
-    params.set('view', input.view)
-  if (input.maxRecords)
-    params.set('maxRecords', String(input.maxRecords))
-  if (input.pageSize)
-    params.set('pageSize', String(input.pageSize))
-  if (input.filterByFormula)
-    params.set('filterByFormula', input.filterByFormula)
-  if (input.sort && Array.isArray(input.sort)) {
-    input.sort.forEach((s, i) => {
-      if (s && typeof s === 'object') {
-        if (s.field)
-          params.set(`sort[${i}][field]`, String(s.field))
-        if (s.direction)
-          params.set(`sort[${i}][direction]`, String(s.direction))
-      }
-    })
-  }
-  const qs = params.toString()
-  const path = `/${input.baseId}/${input.tableId}${qs ? `?${qs}` : ''}`
-  const res = await integration.fetch(path)
-  return await res.json()
-}

package/integration-data/airtable/handlers/list_table_fields.js

@@ -1,6 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/meta/bases/${input.baseId}/tables`)
-  const data = await res.json()
-  const table = (data?.tables || data)?.find?.(t => t.id === input.tableId || t.name === input.tableId)
-  return table?.fields || []
-}

package/integration-data/airtable/handlers/list_tables.js

@@ -1,4 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/meta/bases/${input.baseId}/tables`)
-  return await res.json()
-}

package/integration-data/airtable/handlers/list_views.js

@@ -1,6 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/meta/bases/${input.baseId}/tables`)
-  const data = await res.json()
-  const table = (data?.tables || data)?.find?.(t => t.id === input.tableId || t.name === input.tableId)
-  return table?.views || []
-}

package/integration-data/airtable/handlers/search_records.js

@@ -1,6 +0,0 @@
-async (input) => {
-  const formula = `{${input.field}} = "${input.value}"`
-  const params = new URLSearchParams({ filterByFormula: formula })
-  const res = await integration.fetch(`/${input.baseId}/${input.tableId}?${params.toString()}`)
-  return await res.json()
-}

package/integration-data/airtable/handlers/update_record.js

@@ -1,11 +0,0 @@
-async (input) => {
-  const path = `/${input.baseId}/${input.tableId}`
-  const body = {
-    records: [
-      { id: input.recordId, fields: input.fields },
-    ],
-    typecast: !!input.typecast,
-  }
-  const res = await integration.fetch(path, { method: 'PATCH', body })
-  return await res.json()
-}

package/integration-data/airtable/manifest.json

@@ -1,83 +0,0 @@
-{
-  "name": "airtable",
-  "version": "0.1.0",
-  "tools": [
-    {
-      "name": "list_bases",
-      "description": "List bases available to the authenticated user.",
-      "inputSchema": "schemas/empty.json",
-      "handler": "handlers/list_bases.js",
-      "scope": "read"
-    },
-    {
-      "name": "list_tables",
-      "description": "List tables in a base (metadata).",
-      "inputSchema": "schemas/id_base.json",
-      "handler": "handlers/list_tables.js",
-      "scope": "read"
-    },
-    {
-      "name": "get_table_schema",
-      "description": "Fetch a table's schema (fields, views) by tableId via metadata.",
-      "inputSchema": "schemas/id_base_table.json",
-      "handler": "handlers/get_table_schema.js",
-      "scope": "read"
-    },
-    {
-      "name": "list_table_fields",
-      "description": "List fields for a table (metadata).",
-      "inputSchema": "schemas/id_base_table.json",
-      "handler": "handlers/list_table_fields.js",
-      "scope": "read"
-    },
-    {
-      "name": "list_views",
-      "description": "List views for a table (metadata).",
-      "inputSchema": "schemas/id_base_table.json",
-      "handler": "handlers/list_views.js",
-      "scope": "read"
-    },
-    {
-      "name": "list_records",
-      "description": "List records from a table with optional filters.",
-      "inputSchema": "schemas/list_records.json",
-      "handler": "handlers/list_records.js",
-      "scope": "read"
-    },
-    {
-      "name": "get_record",
-      "description": "Fetch a single record by recordId.",
-      "inputSchema": "schemas/get_record.json",
-      "handler": "handlers/get_record.js",
-      "scope": "read"
-    },
-    {
-      "name": "search_records",
-      "description": "Search records in a table using a field and value (filterByFormula).",
-      "inputSchema": "schemas/search_records.json",
-      "handler": "handlers/search_records.js",
-      "scope": "read"
-    },
-    {
-      "name": "create_record",
-      "description": "Create a record in a table.",
-      "inputSchema": "schemas/create_record.json",
-      "handler": "handlers/create_record.js",
-      "scope": "write"
-    },
-    {
-      "name": "update_record",
-      "description": "Update a record in a table.",
-      "inputSchema": "schemas/update_record.json",
-      "handler": "handlers/update_record.js",
-      "scope": "write"
-    },
-    {
-      "name": "delete_record",
-      "description": "Delete a record from a table.",
-      "inputSchema": "schemas/delete_record.json",
-      "handler": "handlers/delete_record.js",
-      "scope": "write"
-    }
-  ]
-}

package/integration-data/airtable/schemas/create_record.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "baseId": { "type": "string", "description": "Airtable base ID" },
-    "tableId": { "type": "string", "description": "Airtable table ID or name" },
-    "fields": { "type": "object", "description": "Field values for the new record" },
-    "typecast": { "type": "boolean", "description": "Coerce values to field types" }
-  },
-  "required": ["baseId", "tableId", "fields"],
-  "additionalProperties": false
-}

package/integration-data/airtable/schemas/delete_record.json

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

package/integration-data/airtable/schemas/empty.json

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

package/integration-data/airtable/schemas/get_record.json

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

package/integration-data/airtable/schemas/id_base.json

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

package/integration-data/airtable/schemas/id_base_table.json

@@ -1,10 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "required": ["baseId", "tableId"],
-  "properties": {
-    "baseId": { "type": "string", "description": "Airtable base ID" },
-    "tableId": { "type": "string", "description": "Airtable table ID (tbl...)" }
-  },
-  "additionalProperties": false
-}

package/integration-data/airtable/schemas/list_records.json

@@ -1,26 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "required": ["baseId", "tableId"],
-  "properties": {
-    "baseId": { "type": "string" },
-    "tableId": { "type": "string" },
-    "view": { "type": "string", "description": "Optional view name or ID" },
-    "maxRecords": { "type": "integer", "minimum": 1 },
-    "pageSize": { "type": "integer", "minimum": 1 },
-    "filterByFormula": { "type": "string" },
-    "sort": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["field"],
-        "properties": {
-          "field": { "type": "string" },
-          "direction": { "type": "string", "enum": ["asc", "desc"] }
-        },
-        "additionalProperties": false
-      }
-    }
-  },
-  "additionalProperties": false
-}

package/integration-data/airtable/schemas/search_records.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "required": ["baseId", "tableId", "field", "value"],
-  "properties": {
-    "baseId": { "type": "string" },
-    "tableId": { "type": "string" },
-    "field": { "type": "string", "description": "Field name to match" },
-    "value": { "type": "string", "description": "Value to search for" }
-  },
-  "additionalProperties": false
-}

package/integration-data/airtable/schemas/update_record.json

@@ -1,13 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "baseId": { "type": "string" },
-    "tableId": { "type": "string" },
-    "recordId": { "type": "string" },
-    "fields": { "type": "object" },
-    "typecast": { "type": "boolean" }
-  },
-  "required": ["baseId", "tableId", "recordId", "fields"],
-  "additionalProperties": false
-}

package/integration-data/github/credentials.json

@@ -1,20 +0,0 @@
-{
-  "schema": {
-    "type": "object",
-    "properties": {
-      "token": {
-        "type": "string",
-        "title": "Personal Access Token",
-        "description": "GitHub personal access token (classic or fine-grained) with appropriate scopes."
-      }
-    },
-    "required": ["token"],
-    "additionalProperties": false
-  },
-  "injection": {
-    "headers": {
-      "Authorization": "Bearer {{token}}"
-    }
-  }
-}
-

package/integration-data/github/credentials_hint.md

@@ -1,7 +0,0 @@
-Create a GitHub personal access token and paste it here.
-
-- Fine-grained PAT: Settings → Developer settings → Personal access tokens → Fine-grained tokens
-- Classic PAT: Settings → Developer settings → Personal access tokens → Tokens (classic)
-
-Minimum scopes depend on the tools you use (repo read/write, issues, pull requests, etc.).
-

package/integration-data/github/handlers/add_labels_to_issue.js

@@ -1,12 +0,0 @@
-async (input) => {
-  const body = {
-    labels: input.labels,
-  }
-  
-  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}/labels`, { 
-    method: 'POST', 
-    body 
-  })
-  return await res.json()
-}
-

package/integration-data/github/handlers/close_issue.js

@@ -1,5 +0,0 @@
-async (input) => {
-  const body = { state: 'closed' }
-  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}`, { method: 'PATCH', body })
-  return await res.json()
-}

package/integration-data/github/handlers/comment_on_issue.js

@@ -1,5 +0,0 @@
-async (input) => {
-  const body = { body: input.body }
-  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}/comments`, { method: 'POST', body })
-  return await res.json()
-}

package/integration-data/github/handlers/create_branch.js

@@ -1,33 +0,0 @@
-async (input) => {
-  // First, get the SHA of the branch to create from
-  let fromRef = input.from_branch || 'main'
-  
-  // Try to get the ref, fallback to master if main doesn't exist
-  let refRes
-  try {
-    refRes = await integration.fetch(`/repos/${input.owner}/${input.repo}/git/refs/heads/${fromRef}`)
-  } catch (e) {
-    if (fromRef === 'main') {
-      fromRef = 'master'
-      refRes = await integration.fetch(`/repos/${input.owner}/${input.repo}/git/refs/heads/${fromRef}`)
-    } else {
-      throw e
-    }
-  }
-  
-  const refData = await refRes.json()
-  const sha = refData.object.sha
-  
-  // Create the new branch
-  const body = {
-    ref: `refs/heads/${input.branch}`,
-    sha: sha,
-  }
-  
-  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/git/refs`, { 
-    method: 'POST', 
-    body 
-  })
-  return await res.json()
-}
-

package/integration-data/github/handlers/create_commit.js

@@ -1,91 +0,0 @@
-async (input) => {
-  const { owner, repo, branch, message, files } = input
-  
-  // 1. Get the current commit SHA for the branch
-  const refRes = await integration.fetch(`/repos/${owner}/${repo}/git/refs/heads/${branch}`)
-  const refData = await refRes.json()
-  const currentCommitSha = refData.object.sha
-  
-  // 2. Get the current commit to get its tree
-  const commitRes = await integration.fetch(`/repos/${owner}/${repo}/git/commits/${currentCommitSha}`)
-  const commitData = await commitRes.json()
-  const currentTreeSha = commitData.tree.sha
-  
-  // 3. Create blobs for each file with content
-  const tree = []
-  for (const file of files) {
-    if (file.content !== undefined && file.content !== null) {
-      // Create a blob for this file
-      const contentBase64 = typeof Buffer !== 'undefined'
-        ? Buffer.from(file.content).toString('base64')
-        : btoa(unescape(encodeURIComponent(file.content)))
-      
-      const blobRes = await integration.fetch(`/repos/${owner}/${repo}/git/blobs`, {
-        method: 'POST',
-        body: {
-          content: contentBase64,
-          encoding: 'base64',
-        },
-      })
-      const blobData = await blobRes.json()
-      
-      tree.push({
-        path: file.path,
-        mode: file.mode || '100644',
-        type: 'blob',
-        sha: blobData.sha,
-      })
-    } else {
-      // File deletion (null sha means delete)
-      tree.push({
-        path: file.path,
-        mode: '100644',
-        type: 'blob',
-        sha: null,
-      })
-    }
-  }
-  
-  // 4. Create a new tree
-  const treeRes = await integration.fetch(`/repos/${owner}/${repo}/git/trees`, {
-    method: 'POST',
-    body: {
-      base_tree: currentTreeSha,
-      tree: tree,
-    },
-  })
-  const treeData = await treeRes.json()
-  
-  // 5. Create the commit
-  const newCommitRes = await integration.fetch(`/repos/${owner}/${repo}/git/commits`, {
-    method: 'POST',
-    body: {
-      message: message,
-      tree: treeData.sha,
-      parents: [currentCommitSha],
-    },
-  })
-  const newCommitData = await newCommitRes.json()
-  
-  // 6. Update the branch reference
-  const updateRefRes = await integration.fetch(`/repos/${owner}/${repo}/git/refs/heads/${branch}`, {
-    method: 'PATCH',
-    body: {
-      sha: newCommitData.sha,
-    },
-  })
-  await updateRefRes.json()
-  
-  return {
-    commit: {
-      sha: newCommitData.sha,
-      url: newCommitData.html_url,
-      message: newCommitData.message,
-    },
-    tree: {
-      sha: treeData.sha,
-    },
-    files: files.map(f => ({ path: f.path })),
-  }
-}
-

package/integration-data/github/handlers/create_issue.js

@@ -1,10 +0,0 @@
-async (input) => {
-  const body = {
-    title: input.title,
-    body: input.body,
-    assignees: input.assignees,
-    labels: input.labels,
-  }
-  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues`, { method: 'POST', body })
-  return await res.json()
-}

package/integration-data/github/handlers/create_or_update_file.js

@@ -1,21 +0,0 @@
-async (input) => {
-  // GitHub API expects content to be base64 encoded
-  // Use btoa with proper UTF-8 encoding for browser/Node.js compatibility
-  const contentBase64 = typeof Buffer !== 'undefined' 
-    ? Buffer.from(input.content).toString('base64')
-    : btoa(unescape(encodeURIComponent(input.content)))
-  
-  const body = {
-    message: input.message,
-    content: contentBase64,
-    branch: input.branch,
-    sha: input.sha,
-  }
-  
-  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/contents/${input.path}`, { 
-    method: 'PUT', 
-    body 
-  })
-  return await res.json()
-}
-

package/integration-data/github/handlers/create_pull_request.js

@@ -1,16 +0,0 @@
-async (input) => {
-  const body = {
-    title: input.title,
-    body: input.body,
-    head: input.head,
-    base: input.base,
-    draft: input.draft,
-  }
-  
-  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls`, { 
-    method: 'POST', 
-    body 
-  })
-  return await res.json()
-}
-

package/integration-data/github/handlers/create_repo.js

@@ -1,11 +0,0 @@
-async (input) => {
-  const body = {
-    name: input.name,
-    description: input.description,
-    private: input.private,
-    auto_init: input.auto_init,
-  }
-  const res = await integration.fetch('/user/repos', { method: 'POST', body })
-  return await res.json()
-}
-

package/integration-data/github/handlers/delete_repo.js

@@ -1,6 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}`, { method: 'DELETE' })
-  // DELETE returns 204 No Content on success
-  return { success: res.status === 204, status: res.status }
-}
-