@commandable/integration-data 0.0.1

package/integrations/google-docs/handlers/insert_table_after_first_match.js

@@ -0,0 +1,49 @@
+async (input) => {
+  const { documentId, findText, rows, columns, position } = input
+  const marker = `__CMD_MARK_${Date.now()}__`
+  const replaceRes = await integration.fetch(`/documents/${encodeURIComponent(documentId)}:batchUpdate`, {
+    method: 'POST',
+    body: { requests: [{ replaceAllText: { containsText: { text: findText, matchCase: false }, replaceText: marker } }] },
+  })
+  await replaceRes.json()
+
+  const getRes = await integration.fetch(`/documents/${encodeURIComponent(documentId)}`)
+  const doc = await getRes.json()
+  let baseIndex = -1
+  for (const el of (doc?.body?.content || [])) {
+    const p = el.paragraph
+    if (!p)
+      continue
+    for (const e of (p.elements || [])) {
+      const t = e?.textRun?.content
+      if (!t)
+        continue
+      const idx = t.indexOf(marker)
+      if (idx >= 0) {
+        const elStart = e.startIndex || 1
+        const startIndex = elStart + idx
+        const endIndex = startIndex + marker.length
+        baseIndex = position === 'before' ? startIndex : endIndex
+        break
+      }
+    }
+    if (baseIndex >= 0)
+      break
+  }
+  if (baseIndex < 0) {
+    const confirm = await integration.fetch(`/documents/${encodeURIComponent(documentId)}`)
+    const got = await confirm.json()
+    return { documentId: got?.documentId || documentId, applied: false, replies: [] }
+  }
+
+  const requests = []
+  requests.push({ insertTable: { location: { index: baseIndex }, rows, columns } })
+  requests.push({ replaceAllText: { containsText: { text: marker, matchCase: true }, replaceText: findText } })
+  const res = await integration.fetch(`/documents/${encodeURIComponent(documentId)}:batchUpdate`, { method: 'POST', body: { requests } })
+  const out = await res.json()
+  if (out?.documentId || Array.isArray(out?.replies))
+    return { ...out, applied: true }
+  const confirm = await integration.fetch(`/documents/${encodeURIComponent(documentId)}`)
+  const got = await confirm.json()
+  return { documentId: got?.documentId || documentId, applied: true, replies: Array.isArray(out?.replies) ? out.replies : [] }
+}

package/integrations/google-docs/handlers/insert_text_after_first_match.js

@@ -0,0 +1,51 @@
+async (input) => {
+  const { documentId, findText, insertText, position } = input
+  const marker = `__CMD_MARK_${Date.now()}__`
+  // Replace first occurrence by marker only (simulate single by replacing all, then revert later to first span)
+  const replaceRes = await integration.fetch(`/documents/${encodeURIComponent(documentId)}:batchUpdate`, {
+    method: 'POST',
+    body: { requests: [{ replaceAllText: { containsText: { text: findText, matchCase: false }, replaceText: marker } }] },
+  })
+  await replaceRes.json()
+
+  const getRes = await integration.fetch(`/documents/${encodeURIComponent(documentId)}`)
+  const doc = await getRes.json()
+  let insertIndex = -1
+  for (const el of (doc?.body?.content || [])) {
+    const p = el.paragraph
+    if (!p)
+      continue
+    for (const e of (p.elements || [])) {
+      const t = e?.textRun?.content
+      if (!t)
+        continue
+      const idx = t.indexOf(marker)
+      if (idx >= 0) {
+        const elStart = e.startIndex || 1
+        const startIndex = elStart + idx
+        const endIndex = startIndex + marker.length
+        insertIndex = position === 'before' ? startIndex : endIndex
+        break
+      }
+    }
+    if (insertIndex >= 0)
+      break
+  }
+  if (insertIndex < 0) {
+    const confirm = await integration.fetch(`/documents/${encodeURIComponent(documentId)}`)
+    const got = await confirm.json()
+    return { documentId: got?.documentId || documentId, applied: false, replies: [] }
+  }
+
+  const requests = []
+  requests.push({ insertText: { text: insertText, location: { index: insertIndex } } })
+  // restore marker back to original findText everywhere
+  requests.push({ replaceAllText: { containsText: { text: marker, matchCase: true }, replaceText: findText } })
+  const res = await integration.fetch(`/documents/${encodeURIComponent(documentId)}:batchUpdate`, { method: 'POST', body: { requests } })
+  const out = await res.json()
+  if (out?.documentId || Array.isArray(out?.replies))
+    return { ...out, applied: true }
+  const confirm = await integration.fetch(`/documents/${encodeURIComponent(documentId)}`)
+  const got = await confirm.json()
+  return { documentId: got?.documentId || documentId, applied: true, replies: Array.isArray(out?.replies) ? out.replies : [] }
+}

package/integrations/google-docs/handlers/replace_all_text.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const { documentId, findText, replaceText, matchCase } = input
+  const res = await integration.fetch(`/documents/${encodeURIComponent(documentId)}:batchUpdate`, {
+    method: 'POST',
+    body: { requests: [{ replaceAllText: { containsText: { text: findText, matchCase: Boolean(matchCase) }, replaceText } }] },
+  })
+  return await res.json()
+}

package/integrations/google-docs/handlers/style_first_match.js

@@ -0,0 +1,42 @@
+async (input) => {
+  const { documentId, findText, textStyle, fields } = input
+  // 1) Find first match via replaceAllText with unique marker
+  const marker = `__CMD_MARK_${Date.now()}__`
+  const replaceRes = await integration.fetch(`/documents/${encodeURIComponent(documentId)}:batchUpdate`, {
+    method: 'POST',
+    body: { requests: [{ replaceAllText: { containsText: { text: findText, matchCase: false }, replaceText: marker } }] },
+  })
+  const rep = await replaceRes.json()
+  // 2) Get doc, locate marker, compute indices
+  const getRes = await integration.fetch(`/documents/${encodeURIComponent(documentId)}`)
+  const doc = await getRes.json()
+  let startIndex = -1
+  let endIndex = -1
+  for (const el of (doc?.body?.content || [])) {
+    const p = el.paragraph
+    if (!p)
+      continue
+    for (const e of (p.elements || [])) {
+      const t = e?.textRun?.content
+      if (!t)
+        continue
+      const idx = t.indexOf(marker)
+      if (idx >= 0) {
+        const elStart = e.startIndex || 1
+        startIndex = elStart + idx
+        endIndex = startIndex + marker.length
+        break
+      }
+    }
+    if (startIndex >= 0)
+      break
+  }
+  if (startIndex < 0)
+    return rep
+  // 3) Apply style and restore original text
+  const requests = []
+  requests.push({ updateTextStyle: { range: { startIndex, endIndex }, textStyle, fields: fields || Object.keys(textStyle || {}).join(',') } })
+  requests.push({ replaceAllText: { containsText: { text: marker, matchCase: true }, replaceText: findText } })
+  const res = await integration.fetch(`/documents/${encodeURIComponent(documentId)}:batchUpdate`, { method: 'POST', body: { requests } })
+  return await res.json()
+}

package/integrations/google-docs/handlers/update_document_style.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const { documentId, documentStyle, fields } = input
+  const res = await integration.fetch(`/documents/${encodeURIComponent(documentId)}:batchUpdate`, {
+    method: 'POST',
+    body: { requests: [{ updateDocumentStyle: { documentStyle, fields: fields || Object.keys(documentStyle || {}).join(',') } }] },
+  })
+  return await res.json()
+}

package/integrations/google-docs/handlers/update_paragraph_style_for_first_match.js

@@ -0,0 +1,48 @@
+async (input) => {
+  const { documentId, findText, paragraphStyle, fields } = input
+  const marker = `__CMD_MARK_${Date.now()}__`
+  const replaceRes = await integration.fetch(`/documents/${encodeURIComponent(documentId)}:batchUpdate`, {
+    method: 'POST',
+    body: { requests: [{ replaceAllText: { containsText: { text: findText, matchCase: false }, replaceText: marker } }] },
+  })
+  await replaceRes.json()
+
+  const getRes = await integration.fetch(`/documents/${encodeURIComponent(documentId)}`)
+  const doc = await getRes.json()
+  let paragraphStart = -1
+  let paragraphEnd = -1
+  for (const el of (doc?.body?.content || [])) {
+    const p = el.paragraph
+    if (!p)
+      continue
+    for (const e of (p.elements || [])) {
+      const t = e?.textRun?.content
+      if (!t)
+        continue
+      const idx = t.indexOf(marker)
+      if (idx >= 0) {
+        paragraphStart = p.elements?.[0]?.startIndex || e.startIndex || 1
+        paragraphEnd = (p.elements?.[p.elements.length - 1]?.endIndex) || (e.endIndex) || (paragraphStart + marker.length)
+        break
+      }
+    }
+    if (paragraphStart >= 0)
+      break
+  }
+  if (paragraphStart < 0) {
+    const confirm = await integration.fetch(`/documents/${encodeURIComponent(documentId)}`)
+    const got = await confirm.json()
+    return { documentId: got?.documentId || documentId, applied: false, replies: [] }
+  }
+
+  const requests = []
+  requests.push({ updateParagraphStyle: { range: { startIndex: paragraphStart, endIndex: paragraphEnd }, paragraphStyle, fields: fields || Object.keys(paragraphStyle || {}).join(',') } })
+  requests.push({ replaceAllText: { containsText: { text: marker, matchCase: true }, replaceText: findText } })
+  const res = await integration.fetch(`/documents/${encodeURIComponent(documentId)}:batchUpdate`, { method: 'POST', body: { requests } })
+  const out = await res.json()
+  if (out?.documentId || Array.isArray(out?.replies))
+    return { ...out, applied: true }
+  const confirm = await integration.fetch(`/documents/${encodeURIComponent(documentId)}`)
+  const got = await confirm.json()
+  return { documentId: got?.documentId || documentId, applied: true, replies: Array.isArray(out?.replies) ? out.replies : [] }
+}

package/integrations/google-docs/manifest.json

@@ -0,0 +1,58 @@
+{
+  "name": "google-docs",
+  "version": "0.1.0",
+  "tools": [
+    {
+      "name": "get_document",
+      "description": "Retrieve Google Doc content and metadata.",
+      "inputSchema": "schemas/get_document.json",
+      "handler": "handlers/get_document.js",
+      "scope": "read"
+    },
+    {
+      "name": "get_document_text",
+      "description": "Retrieve the document's plain text content.",
+      "inputSchema": "schemas/get_document_text.json",
+      "handler": "handlers/get_document_text.js",
+      "scope": "read"
+    },
+    {
+      "name": "get_document_structured",
+      "description": "Retrieve the structured body JSON (body.content).",
+      "inputSchema": "schemas/get_document_structured.json",
+      "handler": "handlers/get_document_structured.js",
+      "scope": "read"
+    },
+    {
+      "name": "create_document",
+      "description": "Create a new Google Doc.",
+      "inputSchema": "schemas/create_document.json",
+      "handler": "handlers/create_document.js",
+      "scope": "write"
+    },
+    {
+      "name": "batch_update",
+      "description": "Send a documents.batchUpdate request to modify a Doc (insertText, replaceAllText, structural updates, etc).",
+      "inputSchema": "schemas/batch_update.json",
+      "handler": "handlers/batch_update.js",
+      "scope": "write"
+    },
+    { "name": "append_text", "description": "Append plain text to the end of the document.", "inputSchema": "schemas/append_text.json", "handler": "handlers/append_text.js", "scope": "write" },
+    { "name": "replace_all_text", "description": "Replace all occurrences of text matching a query.", "inputSchema": "schemas/replace_all_text.json", "handler": "handlers/replace_all_text.js", "scope": "write" },
+
+    { "name": "style_first_match", "description": "Find the first occurrence of text and apply a TextStyle to it.", "inputSchema": "schemas/style_first_match.json", "handler": "handlers/style_first_match.js", "scope": "write" },
+    { "name": "insert_text_after_first_match", "description": "Find the first occurrence of text and insert new text after or before it.", "inputSchema": "schemas/insert_text_after_first_match.json", "handler": "handlers/insert_text_after_first_match.js", "scope": "write" },
+    { "name": "insert_table_after_first_match", "description": "Find the first occurrence of text and insert a table nearby.", "inputSchema": "schemas/insert_table_after_first_match.json", "handler": "handlers/insert_table_after_first_match.js", "scope": "write" },
+    { "name": "insert_page_break_after_first_match", "description": "Find the first occurrence of text and insert a page break nearby.", "inputSchema": "schemas/insert_page_break_after_first_match.json", "handler": "handlers/insert_page_break_after_first_match.js", "scope": "write" },
+    { "name": "insert_inline_image_after_first_match", "description": "Find the first occurrence of text and insert an inline image nearby.", "inputSchema": "schemas/insert_inline_image_after_first_match.json", "handler": "handlers/insert_inline_image_after_first_match.js", "scope": "write" },
+    { "name": "delete_first_match", "description": "Find the first occurrence of text and delete it.", "inputSchema": "schemas/delete_first_match.json", "handler": "handlers/delete_first_match.js", "scope": "write" },
+    { "name": "update_paragraph_style_for_first_match", "description": "Find the first occurrence of text and update the paragraph style for that paragraph.", "inputSchema": "schemas/update_paragraph_style_for_first_match.json", "handler": "handlers/update_paragraph_style_for_first_match.js", "scope": "write" },
+    {
+      "name": "update_document_style",
+      "description": "Update the document style (e.g., page size, margins).",
+      "inputSchema": "schemas/update_document_style.json",
+      "handler": "handlers/update_document_style.js",
+      "scope": "write"
+    }
+  ]
+}

package/integrations/google-docs/schemas/append_text.json

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

package/integrations/google-docs/schemas/apply_text_style.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "documentId": { "type": "string" },
+    "startIndex": { "type": "number", "minimum": 1 },
+    "endIndex": { "type": "number", "minimum": 1 },
+    "textStyle": { "type": "object", "description": "Docs API TextStyle object, e.g., { bold: true }" },
+    "fields": { "type": "string", "description": "Fields mask for update, e.g., 'bold,italic'" }
+  },
+  "required": ["documentId", "startIndex", "endIndex", "textStyle"],
+  "additionalProperties": false
+}

package/integrations/google-docs/schemas/batch_update.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "documentId": { "type": "string", "description": "The document ID of the Google Doc." },
+    "requests": {
+      "type": "array",
+      "description": "Array of Docs API requests (insertText, updateParagraphStyle, replaceAllText, etc).",
+      "items": { "type": "object" }
+    },
+    "writeControl": { "type": "object", "description": "Write control to ensure idempotency (requiredRevisionId, targetRevisionId)." },
+    "includeTabStops": { "type": "boolean", "description": "Include tab stops in responses where applicable." }
+  },
+  "required": ["documentId", "requests"],
+  "additionalProperties": true
+}

package/integrations/google-docs/schemas/create_document.json

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

package/integrations/google-docs/schemas/delete_content_range.json

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

package/integrations/google-docs/schemas/delete_first_match.json

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

package/integrations/google-docs/schemas/get_document.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "documentId": { "type": "string", "description": "The document ID of the Google Doc." },
+    "suggestionsViewMode": { "type": "string", "enum": ["DEFAULT_FOR_CURRENT_ACCESS", "SUGGESTIONS_INLINE", "PREVIEW_SUGGESTIONS_ACCEPTED", "PREVIEW_WITHOUT_SUGGESTIONS"], "description": "How to view suggested changes." },
+    "includeTabsAndSpaces": { "type": "boolean", "description": "Include tabs and spaces in the text content." }
+  },
+  "required": ["documentId"],
+  "additionalProperties": false
+}

package/integrations/google-docs/schemas/get_document_structured.json

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

package/integrations/google-docs/schemas/get_document_text.json

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

package/integrations/google-docs/schemas/insert_inline_image.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "documentId": { "type": "string" },
+    "index": { "type": "number", "minimum": 1 },
+    "uri": { "type": "string", "description": "Publicly accessible image URL" },
+    "altText": { "type": "string" }
+  },
+  "required": ["documentId", "index", "uri"],
+  "additionalProperties": false
+}

package/integrations/google-docs/schemas/insert_inline_image_after_first_match.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "documentId": { "type": "string" },
+    "findText": { "type": "string" },
+    "uri": { "type": "string" },
+    "altText": { "type": "string" },
+    "position": { "type": "string", "enum": ["after", "before"], "default": "after" }
+  },
+  "required": ["documentId", "findText", "uri"],
+  "additionalProperties": false
+}

package/integrations/google-docs/schemas/insert_page_break.json

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

package/integrations/google-docs/schemas/insert_page_break_after_first_match.json

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

package/integrations/google-docs/schemas/insert_table.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "documentId": { "type": "string" },
+    "index": { "type": "number", "minimum": 1 },
+    "rows": { "type": "number", "minimum": 1 },
+    "columns": { "type": "number", "minimum": 1 }
+  },
+  "required": ["documentId", "index", "rows", "columns"],
+  "additionalProperties": false
+}

package/integrations/google-docs/schemas/insert_table_after_first_match.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "documentId": { "type": "string" },
+    "findText": { "type": "string" },
+    "rows": { "type": "number", "minimum": 1 },
+    "columns": { "type": "number", "minimum": 1 },
+    "position": { "type": "string", "enum": ["after", "before"], "default": "after" }
+  },
+  "required": ["documentId", "findText", "rows", "columns"],
+  "additionalProperties": false
+}

package/integrations/google-docs/schemas/insert_text_after_first_match.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "documentId": { "type": "string" },
+    "findText": { "type": "string" },
+    "insertText": { "type": "string" },
+    "position": { "type": "string", "enum": ["after", "before"], "default": "after" }
+  },
+  "required": ["documentId", "findText", "insertText"],
+  "additionalProperties": false
+}

package/integrations/google-docs/schemas/insert_text_at.json

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

package/integrations/google-docs/schemas/replace_all_text.json

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

package/integrations/google-docs/schemas/style_first_match.json

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

package/integrations/google-docs/schemas/update_document_style.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "documentId": { "type": "string" },
+    "documentStyle": { "type": "object", "description": "Docs API DocumentStyle object" },
+    "fields": { "type": "string" }
+  },
+  "required": ["documentId", "documentStyle"],
+  "additionalProperties": false
+}

package/integrations/google-docs/schemas/update_paragraph_style.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "documentId": { "type": "string" },
+    "startIndex": { "type": "number", "minimum": 1 },
+    "endIndex": { "type": "number", "minimum": 1 },
+    "paragraphStyle": { "type": "object", "description": "Docs API ParagraphStyle object" },
+    "fields": { "type": "string" }
+  },
+  "required": ["documentId", "startIndex", "endIndex", "paragraphStyle"],
+  "additionalProperties": false
+}

package/integrations/google-docs/schemas/update_paragraph_style_for_first_match.json

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