@commandable/mcp 0.0.1 → 0.0.4

package/integration-data/google-slides/handlers/replace_text_first_match.js

@@ -1,9 +0,0 @@
-async (input) => {
-  const { presentationId, findText, replaceText, matchCase } = input
-  const res = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, {
-    method: 'POST',
-    body: { requests: [{ replaceAllText: { containsText: { text: findText, matchCase: Boolean(matchCase) }, replaceText } }] },
-  })
-  const out = await res.json()
-  return out?.presentationId ? { ...out, applied: true } : { presentationId, applied: true, replies: out?.replies || [] }
-}

package/integration-data/google-slides/handlers/set_background_color_for_slide_index.js

@@ -1,15 +0,0 @@
-async (input) => {
-  const { presentationId, slideIndex, rgbColor } = input
-  const presRes = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}`)
-  const pres = await presRes.json()
-  const slide = (pres?.slides || [])[slideIndex]
-  if (!slide?.objectId)
-    return { presentationId, applied: false, replies: [] }
-  const color = { color: { rgbColor } }
-  const res = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, {
-    method: 'POST',
-    body: { requests: [{ updatePageProperties: { objectId: slide.objectId, pageProperties: { pageBackgroundFill: { solidFill: color } }, fields: 'pageBackgroundFill.solidFill.color' } }] },
-  })
-  const out = await res.json()
-  return out?.presentationId ? { ...out, applied: true } : { presentationId, applied: true, replies: out?.replies || [] }
-}

package/integration-data/google-slides/handlers/style_text_first_match.js

@@ -1,48 +0,0 @@
-async (input) => {
-  const { presentationId, findText, textStyle, fields } = input
-  // Replace first match with a marker to derive objectId/range
-  const marker = `__CMD_MARK_${Date.now()}__`
-  const rep = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, {
-    method: 'POST',
-    body: { requests: [{ replaceAllText: { containsText: { text: findText, matchCase: false }, replaceText: marker } }] },
-  })
-  await rep.json()
-  // Scan pages for marker and apply style to that range on the text element
-  const presRes = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}`)
-  const pres = await presRes.json()
-  let targetObjectId = null
-  let startIndex = -1
-  let endIndex = -1
-  for (const slide of (pres?.slides || [])) {
-    for (const el of (slide.pageElements || [])) {
-      const text = el.shape?.text
-      if (!text)
-        continue
-      for (const pe of (text.textElements || [])) {
-        const t = pe.textRun?.content
-        if (!t)
-          continue
-        const idx = t.indexOf(marker)
-        if (idx >= 0) {
-          targetObjectId = el.objectId
-          startIndex = (pe.startIndex || 0) + idx
-          endIndex = startIndex + marker.length
-          break
-        }
-      }
-      if (targetObjectId)
-        break
-    }
-    if (targetObjectId)
-      break
-  }
-  if (!targetObjectId)
-    return { presentationId, applied: false, replies: [] }
-  const requests = [
-    { updateTextStyle: { objectId: targetObjectId, style: textStyle, textRange: { type: 'FIXED_RANGE', startIndex, endIndex }, fields: fields || Object.keys(textStyle || {}).join(',') } },
-    { replaceAllText: { containsText: { text: marker, matchCase: true }, replaceText: findText } },
-  ]
-  const res = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, { method: 'POST', body: { requests } })
-  const out = await res.json()
-  return out?.presentationId ? { ...out, applied: true } : { presentationId, applied: true, replies: out?.replies || [] }
-}

package/integration-data/google-slides/manifest.json

@@ -1,41 +0,0 @@
-{
-  "name": "google-slides",
-  "version": "0.1.0",
-  "tools": [
-    {
-      "name": "get_presentation",
-      "description": "Retrieve presentation metadata, including slides/pages and elements.",
-      "inputSchema": "schemas/get_presentation.json",
-      "handler": "handlers/get_presentation.js",
-      "scope": "read"
-    },
-    {
-      "name": "get_page_thumbnail",
-      "description": "Get a thumbnail image for a page (slide) in a presentation.",
-      "inputSchema": "schemas/get_page_thumbnail.json",
-      "handler": "handlers/get_page_thumbnail.js",
-      "scope": "read"
-    },
-    {
-      "name": "create_presentation",
-      "description": "Create a new presentation with optional initial title.",
-      "inputSchema": "schemas/create_presentation.json",
-      "handler": "handlers/create_presentation.js",
-      "scope": "write"
-    },
-    {
-      "name": "batch_update",
-      "description": "Send a batchUpdate request to modify presentation structure and content.",
-      "inputSchema": "schemas/batch_update.json",
-      "handler": "handlers/batch_update.js",
-      "scope": "write"
-    },
-    { "name": "append_text_to_title_of_slide_index", "description": "Append text to the title shape of the specified slide (slideIndex, default 0).", "inputSchema": "schemas/append_text_to_title_of_first_slide.json", "handler": "handlers/append_text_to_title_of_first_slide.js", "scope": "write" },
-    { "name": "replace_text_first_match", "description": "Replace text for the first match anywhere in the presentation.", "inputSchema": "schemas/replace_text_first_match.json", "handler": "handlers/replace_text_first_match.js", "scope": "write" },
-    { "name": "style_text_first_match", "description": "Apply text style to the first match of given text.", "inputSchema": "schemas/style_text_first_match.json", "handler": "handlers/style_text_first_match.js", "scope": "write" },
-    { "name": "insert_shape_after_first_match", "description": "Insert a rectangle shape near the first match of text on a slide.", "inputSchema": "schemas/insert_shape_after_first_match.json", "handler": "handlers/insert_shape_after_first_match.js", "scope": "write" },
-    { "name": "insert_image_after_first_match", "description": "Insert an image near the first match of text on a slide.", "inputSchema": "schemas/insert_image_after_first_match.json", "handler": "handlers/insert_image_after_first_match.js", "scope": "write" },
-    { "name": "create_slide_after_first_match", "description": "Create a new slide after the slide that contains the first text match.", "inputSchema": "schemas/create_slide_after_first_match.json", "handler": "handlers/create_slide_after_first_match.js", "scope": "write" },
-    { "name": "set_background_color_for_slide_index", "description": "Set background color for a slide by index.", "inputSchema": "schemas/set_background_color_for_slide_index.json", "handler": "handlers/set_background_color_for_slide_index.js", "scope": "write" }
-  ]
-}

package/integration-data/google-slides/schemas/append_text_to_title_of_first_slide.json

@@ -1,11 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "presentationId": { "type": "string" },
-    "text": { "type": "string" },
-    "slideIndex": { "type": "number", "minimum": 0, "description": "Zero-based slide index to target (default 0)." }
-  },
-  "required": ["presentationId", "text"],
-  "additionalProperties": false
-}

package/integration-data/google-slides/schemas/batch_update.json

@@ -1,13 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "required": ["presentationId", "requests"],
-  "properties": {
-    "presentationId": { "type": "string", "description": "ID of the presentation." },
-    "requests": { "type": "array", "items": { "type": "object" }, "description": "Array of Slides API requests." },
-    "writeControl": { "type": "object", "description": "Optional write control object." },
-    "includePresentationInResponse": { "type": "boolean" },
-    "responsePageObjectIds": { "type": "array", "items": { "type": "string" } }
-  },
-  "additionalProperties": false
-}

package/integration-data/google-slides/schemas/create_presentation.json

@@ -1,8 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "title": { "type": "string", "description": "Optional title for the new presentation." }
-  },
-  "additionalProperties": false
-}

package/integration-data/google-slides/schemas/create_slide_after_first_match.json

@@ -1,11 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "presentationId": { "type": "string" },
-    "findText": { "type": "string" },
-    "layout": { "type": "string", "default": "BLANK" }
-  },
-  "required": ["presentationId", "findText"],
-  "additionalProperties": false
-}

package/integration-data/google-slides/schemas/get_page_thumbnail.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "required": ["presentationId", "pageObjectId"],
-  "properties": {
-    "presentationId": { "type": "string", "description": "ID of the presentation." },
-    "pageObjectId": { "type": "string", "description": "Object ID of the page (slide)." },
-    "thumbnailProperties.thumbnailSize": { "type": "string", "enum": ["THUMBNAIL_SIZE_UNSPECIFIED", "LARGE", "MEDIUM", "SMALL"], "description": "Requested size hint for the thumbnail." },
-    "thumbnailProperties.mimeType": { "type": "string", "enum": ["PNG", "JPEG"], "description": "Requested image MIME type." }
-  },
-  "additionalProperties": false
-}

package/integration-data/google-slides/schemas/get_presentation.json

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

package/integration-data/google-slides/schemas/insert_image_after_first_match.json

@@ -1,13 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "presentationId": { "type": "string" },
-    "findText": { "type": "string" },
-    "uri": { "type": "string" },
-    "width": { "type": "number", "default": 2000000 },
-    "height": { "type": "number", "default": 2000000 }
-  },
-  "required": ["presentationId", "findText", "uri"],
-  "additionalProperties": false
-}

package/integration-data/google-slides/schemas/insert_shape_after_first_match.json

@@ -1,13 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "presentationId": { "type": "string" },
-    "findText": { "type": "string" },
-    "shapeType": { "type": "string", "default": "RECTANGLE" },
-    "width": { "type": "number", "default": 2000000 },
-    "height": { "type": "number", "default": 1000000 }
-  },
-  "required": ["presentationId", "findText"],
-  "additionalProperties": false
-}

package/integration-data/google-slides/schemas/replace_text_first_match.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "presentationId": { "type": "string" },
-    "findText": { "type": "string" },
-    "replaceText": { "type": "string" },
-    "matchCase": { "type": "boolean" }
-  },
-  "required": ["presentationId", "findText", "replaceText"],
-  "additionalProperties": false
-}

package/integration-data/google-slides/schemas/set_background_color_for_slide_index.json

@@ -1,11 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "presentationId": { "type": "string" },
-    "slideIndex": { "type": "number", "minimum": 0 },
-    "rgbColor": { "type": "object", "properties": { "red": { "type": "number" }, "green": { "type": "number" }, "blue": { "type": "number" } }, "required": ["red", "green", "blue"] }
-  },
-  "required": ["presentationId", "slideIndex", "rgbColor"],
-  "additionalProperties": false
-}

package/integration-data/google-slides/schemas/style_text_first_match.json

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

package/integration-data/new_integration_prompt.md

@@ -1,41 +0,0 @@
-## Task
-
-Write a new integration-data folder for `<INTEGRATION_NAME>`.
-
-## Required structure
-
-Create `commandable-mcp/packages/server/integration-data/<name>/` containing:
-
-- `manifest.json`: flat `tools[]`; each tool has `name`, `description`, `inputSchema` (relative path), `handler` (relative path), `scope` (`read` | `write` | optionally `admin`)
-- `schemas/*.json`: JSON Schema for each tool input. Prefer `additionalProperties: false` for strict contracts; use `true` only for pass-through bodies (common in Google APIs). Reuse `empty.json` for no-arg tools.
-- `handlers/*.js`: async arrow functions `async (input) => { ... }` using `integration.fetch(path, init?)` for all HTTP calls. Pass `body` as a plain object (proxy will JSON-stringify). Return parsed JSON.
-- `credentials.json`: `{ schema, injection }` where `schema` is JSON Schema for secrets and `injection` is `headers` and/or `query` templates using `{{placeholder}}`
-- `credentials_hint.md`: **numbered steps** (1., 2., 3., …) telling a user exactly how to obtain/provide credentials
-- `prompt.md` (optional): extra LLM guidance only if the API has non-obvious usage patterns
-
-Also register the provider in `src/integrations/providerRegistry.ts` with its base URL and auth factory.
-
-## Tool design goals
-
-- **Default**: small, composable tools that mirror API resources.
-- **Read tools**: side-effect free (GET only).
-- **Write tools**: POST/PUT/PATCH/DELETE where appropriate.
-- **Coverage**: start with core CRUD + list/search + get-by-id; add convenience tools after.
-
-## When to go beyond REST proxying
-
-Most handlers should be thin proxies (fetch → return JSON). Only add multi-step/orchestrating handlers when the raw API is genuinely hard for an LLM to use correctly, e.g.:
-
-- multi-step workflows (GitHub tree → blob → commit → ref)
-- required transforms (e.g. base64 encoding) that the caller shouldn’t manage
-- awkward addressing that benefits from higher-level helpers (“find text then act” patterns like Docs/Slides)
-
-If an endpoint is already clean and self-contained, just proxy it.
-
-## Reference examples (follow exactly)
-
-- `github/`: simple proxies + complex orchestration (`create_commit.js`)
-- `notion/`: clean proxying + optional `prompt.md`
-- `google-calendar/`: query param building + `read`/`write`/`admin` scopes
-- `trello/`: query-param credential injection + `displayCards`
-- `google-docs/`, `google-slides/`: higher-level write helpers over batchUpdate APIs

package/integration-data/notion/credentials.json

@@ -1,21 +0,0 @@
-{
-  "schema": {
-    "type": "object",
-    "properties": {
-      "token": {
-        "type": "string",
-        "title": "Internal Integration Token",
-        "description": "Notion internal integration token (starts with \"secret_\")."
-      }
-    },
-    "required": ["token"],
-    "additionalProperties": false
-  },
-  "injection": {
-    "headers": {
-      "Authorization": "Bearer {{token}}",
-      "Notion-Version": "2022-06-28"
-    }
-  }
-}
-

package/integration-data/notion/credentials_hint.md

@@ -1,5 +0,0 @@
-1. Go to `https://www.notion.so/profile/integrations/internal`
-2. Create a Notion integration in Notion’s developer settings
-3. Share your target pages/databases with that integration so it has access
-4. Copy the **Internal Integration Token** (usually starts with `secret_`)
-

package/integration-data/notion/handlers/append_block_children.js

@@ -1,7 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/blocks/${encodeURIComponent(input.block_id)}/children`, {
-    method: 'PATCH',
-    body: { children: input.children },
-  })
-  return await res.json()
-}

package/integration-data/notion/handlers/create_comment.js

@@ -1,10 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/comments`, {
-    method: 'POST',
-    body: {
-      parent: input.parent,
-      rich_text: input.rich_text,
-    },
-  })
-  return await res.json()
-}

package/integration-data/notion/handlers/create_database.js

@@ -1,11 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/databases`, {
-    method: 'POST',
-    body: {
-      parent: input.parent,
-      title: input.title,
-      properties: input.properties,
-    },
-  })
-  return await res.json()
-}

package/integration-data/notion/handlers/create_page.js

@@ -1,13 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/pages`, {
-    method: 'POST',
-    body: {
-      parent: input.parent,
-      properties: input.properties,
-      children: input.children || undefined,
-      icon: input.icon || undefined,
-      cover: input.cover || undefined,
-    },
-  })
-  return await res.json()
-}

package/integration-data/notion/handlers/delete_block.js

@@ -1,8 +0,0 @@
-async (input) => {
-  // Notion 'delete' is archive block
-  const res = await integration.fetch(`/blocks/${encodeURIComponent(input.block_id)}`, {
-    method: 'PATCH',
-    body: { archived: true },
-  })
-  return await res.json()
-}

package/integration-data/notion/handlers/get_me.js

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

package/integration-data/notion/handlers/list_block_children.js

@@ -1,10 +0,0 @@
-async (input) => {
-  const params = new URLSearchParams()
-  if (input.start_cursor)
-    params.set('start_cursor', input.start_cursor)
-  if (input.page_size)
-    params.set('page_size', String(input.page_size))
-  const qs = params.toString()
-  const res = await integration.fetch(`/blocks/${encodeURIComponent(input.block_id)}/children${qs ? `?${qs}` : ''}`)
-  return await res.json()
-}

package/integration-data/notion/handlers/list_comments.js

@@ -1,14 +0,0 @@
-async (input) => {
-  const params = new URLSearchParams()
-  if (input.block_id)
-    params.set('block_id', input.block_id)
-  if (input.discussion_id)
-    params.set('discussion_id', input.discussion_id)
-  if (input.start_cursor)
-    params.set('start_cursor', input.start_cursor)
-  if (input.page_size)
-    params.set('page_size', String(input.page_size))
-  const qs = params.toString()
-  const res = await integration.fetch(`/comments${qs ? `?${qs}` : ''}`)
-  return await res.json()
-}

package/integration-data/notion/handlers/list_users.js

@@ -1,10 +0,0 @@
-async (input) => {
-  const params = new URLSearchParams()
-  if (input.start_cursor)
-    params.set('start_cursor', input.start_cursor)
-  if (input.page_size)
-    params.set('page_size', String(input.page_size))
-  const qs = params.toString()
-  const res = await integration.fetch(`/users${qs ? `?${qs}` : ''}`)
-  return await res.json()
-}

package/integration-data/notion/handlers/query_database.js

@@ -1,10 +0,0 @@
-async (input) => {
-  const body = {
-    filter: input.filter || undefined,
-    sorts: input.sorts || undefined,
-    start_cursor: input.start_cursor || undefined,
-    page_size: input.page_size || undefined,
-  }
-  const res = await integration.fetch(`/databases/${encodeURIComponent(input.database_id)}/query`, { method: 'POST', body })
-  return await res.json()
-}

package/integration-data/notion/handlers/retrieve_block.js

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

package/integration-data/notion/handlers/retrieve_database.js

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

package/integration-data/notion/handlers/retrieve_page.js

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

package/integration-data/notion/handlers/retrieve_page_property_item.js

@@ -1,10 +0,0 @@
-async (input) => {
-  const params = new URLSearchParams()
-  if (input.start_cursor)
-    params.set('start_cursor', input.start_cursor)
-  if (input.page_size)
-    params.set('page_size', String(input.page_size))
-  const qs = params.toString()
-  const res = await integration.fetch(`/pages/${encodeURIComponent(input.page_id)}/properties/${encodeURIComponent(input.property_id)}${qs ? `?${qs}` : ''}`)
-  return await res.json()
-}

package/integration-data/notion/handlers/retrieve_user.js

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

package/integration-data/notion/handlers/search.js

@@ -1,11 +0,0 @@
-async (input) => {
-  const body = {
-    query: input.query || '',
-    filter: input.filter || undefined,
-    sort: input.sort || undefined,
-    start_cursor: input.start_cursor || undefined,
-    page_size: input.page_size || undefined,
-  }
-  const res = await integration.fetch(`/search`, { method: 'POST', body })
-  return await res.json()
-}

package/integration-data/notion/handlers/update_block.js

@@ -1,7 +0,0 @@
-async (input) => {
-  const res = await integration.fetch(`/blocks/${encodeURIComponent(input.block_id)}`, {
-    method: 'PATCH',
-    body: input.body || {},
-  })
-  return await res.json()
-}

package/integration-data/notion/handlers/update_database.js

@@ -1,10 +0,0 @@
-async (input) => {
-  const body = {
-    title: input.title || undefined,
-    description: input.description || undefined,
-    properties: input.properties || undefined,
-    archived: input.archived === undefined ? undefined : input.archived,
-  }
-  const res = await integration.fetch(`/databases/${encodeURIComponent(input.database_id)}`, { method: 'PATCH', body })
-  return await res.json()
-}

package/integration-data/notion/handlers/update_page_properties.js

@@ -1,10 +0,0 @@
-async (input) => {
-  const body = {
-    properties: input.properties,
-    archived: input.archived === undefined ? undefined : input.archived,
-    icon: input.icon || undefined,
-    cover: input.cover || undefined,
-  }
-  const res = await integration.fetch(`/pages/${encodeURIComponent(input.page_id)}`, { method: 'PATCH', body })
-  return await res.json()
-}