@commandable/integration-data 0.0.5 → 0.0.6

package/integrations/{google-docs/schemas/get_document_structured.json → google-gmail/schemas/get_profile.json}

@@ -2,8 +2,10 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "type": "object",
   "properties": {
-    "documentId": { "type": "string" }
+    "userId": {
+      "type": "string",
+      "description": "User email address or the special value 'me'. Defaults to 'me'."
+    }
   },
-  "required": ["documentId"],
   "additionalProperties": false
 }

package/integrations/google-gmail/schemas/get_thread.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["threadId"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email address or 'me'. Defaults to 'me'." },
+    "threadId": { "type": "string", "description": "Gmail thread ID." },
+    "format": {
+      "type": "string",
+      "enum": ["minimal", "full", "metadata"],
+      "description": "Thread message format. Defaults to full."
+    },
+    "metadataHeaders": {
+      "type": "array",
+      "description": "Headers to include when format is metadata.",
+      "items": { "type": "string" }
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/id_draft.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["draftId"],
+  "properties": {
+    "userId": {
+      "type": "string",
+      "description": "User email address or 'me'. Defaults to 'me'."
+    },
+    "draftId": {
+      "type": "string",
+      "description": "Gmail draft ID."
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/id_label.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["labelId"],
+  "properties": {
+    "userId": {
+      "type": "string",
+      "description": "User email address or 'me'. Defaults to 'me'."
+    },
+    "labelId": {
+      "type": "string",
+      "description": "Gmail label ID."
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/id_message.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["messageId"],
+  "properties": {
+    "userId": {
+      "type": "string",
+      "description": "User email address or 'me'. Defaults to 'me'."
+    },
+    "messageId": {
+      "type": "string",
+      "description": "Gmail message ID."
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/id_thread.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["threadId"],
+  "properties": {
+    "userId": {
+      "type": "string",
+      "description": "User email address or 'me'. Defaults to 'me'."
+    },
+    "threadId": {
+      "type": "string",
+      "description": "Gmail thread ID."
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/list_drafts.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "userId": {
+      "type": "string",
+      "description": "User email address or 'me'. Defaults to 'me'."
+    },
+    "q": {
+      "type": "string",
+      "description": "Gmail search query to filter drafts. Supports the same operators as list_messages: 'subject:keyword', 'to:user@example.com', etc."
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 500,
+      "default": 20,
+      "description": "Maximum number of drafts to return. Defaults to 20. Use pageToken from the response for the next page."
+    },
+    "pageToken": {
+      "type": "string",
+      "description": "Page token from a previous list_drafts response. Pass this to retrieve the next page."
+    },
+    "includeSpamTrash": {
+      "type": "boolean",
+      "description": "Include drafts from SPAM and TRASH in results. Defaults to false."
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/{google-sheet/schemas/get_developer_metadata.json → google-gmail/schemas/list_labels.json}

@@ -1,10 +1,11 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "type": "object",
-  "required": ["spreadsheetId", "metadataId"],
   "properties": {
-    "spreadsheetId": { "type": "string" },
-    "metadataId": { "type": "integer" }
+    "userId": {
+      "type": "string",
+      "description": "User email address or the special value 'me'. Defaults to 'me'."
+    }
   },
   "additionalProperties": false
 }

package/integrations/google-gmail/schemas/list_messages.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "userId": {
+      "type": "string",
+      "description": "User email address or 'me'. Defaults to 'me'."
+    },
+    "q": {
+      "type": "string",
+      "description": "Gmail search query. Supported operators: 'is:unread', 'is:read', 'from:user@example.com', 'to:user@example.com', 'subject:keyword', 'has:attachment', 'label:INBOX', 'after:2024/01/01', 'before:2024/12/31', 'newer_than:7d', 'older_than:1y', 'in:sent', 'in:drafts'. Combine operators with spaces (implicit AND) or use OR/NOT."
+    },
+    "labelIds": {
+      "type": "array",
+      "description": "Filter to messages with all of these label IDs applied. Common IDs: 'INBOX', 'UNREAD', 'STARRED', 'SENT', 'DRAFT', 'SPAM', 'TRASH'. Use list_labels for custom label IDs.",
+      "items": { "type": "string" }
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 500,
+      "default": 20,
+      "description": "Maximum number of messages to return. Defaults to 20. Use pageToken from the response for the next page of results."
+    },
+    "pageToken": {
+      "type": "string",
+      "description": "Page token from a previous list_messages response. Pass this to retrieve the next page."
+    },
+    "includeSpamTrash": {
+      "type": "boolean",
+      "description": "Include messages from SPAM and TRASH in results. Defaults to false."
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/list_threads.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "userId": {
+      "type": "string",
+      "description": "User email address or 'me'. Defaults to 'me'."
+    },
+    "q": {
+      "type": "string",
+      "description": "Gmail search query. Supported operators: 'is:unread', 'from:user@example.com', 'to:user@example.com', 'subject:keyword', 'has:attachment', 'after:2024/01/01', 'newer_than:7d', 'label:INBOX'. Same syntax as list_messages."
+    },
+    "labelIds": {
+      "type": "array",
+      "description": "Filter to threads where all messages have these label IDs. Common IDs: 'INBOX', 'UNREAD', 'STARRED', 'SENT'. Use list_labels for custom label IDs.",
+      "items": { "type": "string" }
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 500,
+      "default": 20,
+      "description": "Maximum number of threads to return. Defaults to 20. Use pageToken from the response for the next page of results."
+    },
+    "pageToken": {
+      "type": "string",
+      "description": "Page token from a previous list_threads response. Pass this to retrieve the next page."
+    },
+    "includeSpamTrash": {
+      "type": "boolean",
+      "description": "Include threads from SPAM and TRASH in results. Defaults to false."
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/modify_message.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["messageId"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email address or 'me'. Defaults to 'me'." },
+    "messageId": { "type": "string", "description": "Gmail message ID." },
+    "addLabelIds": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Label IDs to add."
+    },
+    "removeLabelIds": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Label IDs to remove."
+    }
+  },
+  "anyOf": [
+    { "required": ["addLabelIds"] },
+    { "required": ["removeLabelIds"] }
+  ],
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/modify_thread.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["threadId"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email address or 'me'. Defaults to 'me'." },
+    "threadId": { "type": "string", "description": "Gmail thread ID." },
+    "addLabelIds": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Label IDs to add."
+    },
+    "removeLabelIds": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Label IDs to remove."
+    }
+  },
+  "anyOf": [
+    { "required": ["addLabelIds"] },
+    { "required": ["removeLabelIds"] }
+  ],
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/read_email.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["messageId"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email or 'me'. Defaults to 'me'." },
+    "messageId": { "type": "string", "description": "Gmail message ID. Obtain from list_messages or search results." }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/send_draft.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "userId": { "type": "string", "description": "User email address or 'me'. Defaults to 'me'." },
+    "draftId": {
+      "type": "string",
+      "description": "Draft ID to send."
+    },
+    "raw": {
+      "type": "string",
+      "description": "Optional base64url encoded RFC822 message string for one-off send."
+    },
+    "threadId": {
+      "type": "string",
+      "description": "Optional existing thread ID when sending a one-off draft payload."
+    },
+    "labelIds": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional label IDs when sending a one-off draft payload."
+    }
+  },
+  "anyOf": [
+    { "required": ["draftId"] },
+    { "required": ["raw"] }
+  ],
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/send_email.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["to", "subject", "body"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email or 'me'. Defaults to 'me'." },
+    "to": { "type": "string", "description": "Recipient email address. Use comma-separated values for multiple recipients (e.g. 'alice@example.com, bob@example.com')." },
+    "cc": { "type": "string", "description": "CC recipients, comma-separated." },
+    "bcc": { "type": "string", "description": "BCC recipients, comma-separated." },
+    "subject": { "type": "string", "description": "Email subject line." },
+    "body": { "type": "string", "description": "Plain text email body. Required unless htmlBody is provided." },
+    "htmlBody": { "type": "string", "description": "HTML email body. If provided, takes precedence over body and the email is sent as text/html." },
+    "replyToMessageId": { "type": "string", "description": "Message ID of the email being replied to. Sets the In-Reply-To header for proper threading. Use with threadId." },
+    "threadId": { "type": "string", "description": "Thread ID to add this message to. Required when replying so the reply appears in the same conversation." }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/update_label.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["labelId"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email address or 'me'. Defaults to 'me'." },
+    "labelId": { "type": "string", "description": "Gmail label ID." },
+    "name": { "type": "string", "description": "Label display name." },
+    "messageListVisibility": {
+      "type": "string",
+      "enum": ["show", "hide"]
+    },
+    "labelListVisibility": {
+      "type": "string",
+      "enum": ["labelShow", "labelShowIfUnread", "labelHide"]
+    },
+    "color": {
+      "type": "object",
+      "properties": {
+        "textColor": { "type": "string", "description": "Hex color, e.g. #000000" },
+        "backgroundColor": { "type": "string", "description": "Hex color, e.g. #ffffff" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "anyOf": [
+    { "required": ["name"] },
+    { "required": ["messageListVisibility"] },
+    { "required": ["labelListVisibility"] },
+    { "required": ["color"] }
+  ],
+  "additionalProperties": false
+}

package/integrations/google-sheet/__tests__/get_handlers.test.ts

@@ -63,60 +63,14 @@ suite('google-sheet read handlers (live)', () => {
     expect(result?.spreadsheetId || result?.sheets).toBeTruthy()
   }, 30000)
 
-  it('get_values returns a value range', async () => {
+  it('read_sheet returns markdown with A1 coordinates', async () => {
     if (!spreadsheetId)
       return expect(true).toBe(true)
-    const handler = sheets.read('get_values')
+    const handler = sheets.read('read_sheet')
     const range = sheetTitle ? `${sheetTitle}!A1:B5` : 'A1:B5'
-    const result = await handler({ spreadsheetId, range })
-    expect(result?.range || result?.values).toBeTruthy()
-  }, 30000)
-
-  it('batch_get_values returns multiple ranges', async () => {
-    if (!spreadsheetId)
-      return expect(true).toBe(true)
-    const handler = sheets.read('batch_get_values')
-    const aTitle = sheetTitle || 'Sheet1'
-    const result = await handler({ spreadsheetId, ranges: [`${aTitle}!A1:A3`, `${aTitle}!B1:B3`] })
-    expect(Array.isArray(result?.valueRanges)).toBe(true)
-  }, 30000)
-
-  it('get_spreadsheet_by_data_filter returns metadata', async () => {
-    if (!spreadsheetId)
-      return expect(true).toBe(true)
-    const handler = sheets.read('get_spreadsheet_by_data_filter')
-    const aTitle = sheetTitle || 'Sheet1'
-    const result = await handler({ spreadsheetId, dataFilters: [{ a1Range: `${aTitle}!A1:A1` }] })
-    expect(result?.spreadsheetId || result?.sheets).toBeTruthy()
-  }, 30000)
-
-  it('get_values_by_data_filter returns values', async () => {
-    if (!spreadsheetId)
-      return expect(true).toBe(true)
-    const handler = sheets.read('get_values_by_data_filter')
-    const aTitle = sheetTitle || 'Sheet1'
-    const result = await handler({ spreadsheetId, dataFilters: [{ a1Range: `${aTitle}!A1:B2` }] })
-    expect(Array.isArray(result?.valueRanges)).toBe(true)
-  }, 30000)
-
-  it('search_developer_metadata returns results or empty', async () => {
-    if (!spreadsheetId)
-      return expect(true).toBe(true)
-    const handler = sheets.read('search_developer_metadata')
-    const result = await handler({ spreadsheetId, dataFilters: [{ developerMetadataLookup: { visibility: 'DOCUMENT' } }] })
-    expect(result !== undefined).toBe(true)
-  }, 30000)
-
-  it('get_developer_metadata retrieves by id when available', async () => {
-    if (!spreadsheetId)
-      return expect(true).toBe(true)
-    const search = sheets.read('search_developer_metadata')
-    const list = await search({ spreadsheetId, dataFilters: [{ developerMetadataLookup: { visibility: 'DOCUMENT' } }] })
-    const first = list?.matchedDeveloperMetadata?.[0]?.developerMetadata || list?.developerMetadata?.[0]
-    if (!first?.metadataId)
-      return expect(true).toBe(true)
-    const getdm = sheets.read('get_developer_metadata')
-    const got = await getdm({ spreadsheetId, metadataId: first.metadataId })
-    expect(got?.metadataId).toBe(first.metadataId)
+    const result = await handler({ spreadsheetId, range, valueRenderOption: 'FORMATTED_VALUE' })
+    expect(result?.range).toBeTruthy()
+    expect(typeof result?.markdown).toBe('string')
+    expect(result?.columnCount >= 1).toBe(true)
   }, 30000)
 })

package/integrations/google-sheet/__tests__/write_handlers.test.ts

@@ -110,17 +110,6 @@ suite('google-sheet write handlers (live)', () => {
     expect(res?.totalUpdatedCells >= 0 || res?.spreadsheetId).toBeTruthy()
   }, 60000)
 
-  it('batch_update_values_by_data_filter updates via filters', async () => {
-    if (!ctx.spreadsheetId)
-      return expect(true).toBe(true)
-    const aTitle = sheetTitle || 'Sheet1'
-    const batch_update_values_by_data_filter = sheets.write('batch_update_values_by_data_filter')
-    const res = await batch_update_values_by_data_filter({ spreadsheetId: ctx.spreadsheetId, data: [
-      { dataFilter: { a1Range: `${aTitle}!D1:D1` }, values: [[`CmdTestDF ${Date.now()}`]] },
-    ], valueInputOption: 'USER_ENTERED' })
-    expect(res?.totalUpdatedCells >= 0 || res?.spreadsheetId).toBeTruthy()
-  }, 60000)
-
   it('batch_clear_values clears multiple ranges', async () => {
     if (!ctx.spreadsheetId)
       return expect(true).toBe(true)
@@ -130,15 +119,6 @@ suite('google-sheet write handlers (live)', () => {
     expect(Boolean(res?.spreadsheetId) || Array.isArray(res?.clearedRanges)).toBe(true)
   }, 60000)
 
-  it('batch_clear_values_by_data_filter clears via filters', async () => {
-    if (!ctx.spreadsheetId)
-      return expect(true).toBe(true)
-    const aTitle = sheetTitle || 'Sheet1'
-    const batch_clear_values_by_data_filter = sheets.write('batch_clear_values_by_data_filter')
-    const res = await batch_clear_values_by_data_filter({ spreadsheetId: ctx.spreadsheetId, dataFilters: [{ a1Range: `${aTitle}!E1:E2` }] })
-    expect(Boolean(res?.spreadsheetId) || Array.isArray(res?.clearedRanges)).toBe(true)
-  }, 60000)
-
   it('batch_update handles a trivial request (no-op findReplace)', async () => {
     if (!ctx.spreadsheetId)
       return expect(true).toBe(true)

package/integrations/google-sheet/handlers/get_spreadsheet.js

@@ -5,6 +5,8 @@ async (input) => {
     params.set('includeGridData', String(includeGridData))
   if (Array.isArray(ranges))
     ranges.forEach(r => params.append('ranges', String(r)))
+  if (input.fields)
+    params.set('fields', input.fields)
   const qs = params.toString()
   const path = `/spreadsheets/${encodeURIComponent(spreadsheetId)}${qs ? `?${qs}` : ''}`
   const res = await integration.fetch(path)

package/integrations/google-sheet/handlers/read_sheet.js

@@ -0,0 +1,75 @@
+async (input) => {
+  const toColumnName = (index) => {
+    let n = index + 1
+    let out = ''
+    while (n > 0) {
+      const rem = (n - 1) % 26
+      out = String.fromCharCode(65 + rem) + out
+      n = Math.floor((n - 1) / 26)
+    }
+    return out
+  }
+
+  const columnNameToIndex = (name) => {
+    let value = 0
+    for (const ch of name.toUpperCase()) {
+      const code = ch.charCodeAt(0)
+      if (code < 65 || code > 90) continue
+      value = value * 26 + (code - 64)
+    }
+    return Math.max(0, value - 1)
+  }
+
+  const parseResolvedRange = (resolvedRange) => {
+    // Examples: "Sheet1!A1:D5", "Sheet1!B:B", "Sheet1!2:9"
+    const a1 = String(resolvedRange || '').split('!')[1] || ''
+    const [start = 'A1'] = a1.split(':')
+    const letters = (start.match(/[A-Za-z]+/) || ['A'])[0]
+    const rowDigits = (start.match(/\d+/) || ['1'])[0]
+    return {
+      startColumn: columnNameToIndex(letters),
+      startRow: Math.max(1, parseInt(rowDigits, 10) || 1),
+    }
+  }
+
+  const escapeCell = (value) =>
+    String(value ?? '')
+      .replace(/\|/g, '\\|')
+      .replace(/\r?\n/g, '<br>')
+
+  const spreadsheetId = input.spreadsheetId
+  const range = input.range || 'A1:Z1000'
+  const params = new URLSearchParams()
+  if (input.valueRenderOption) params.set('valueRenderOption', input.valueRenderOption)
+
+  const qs = params.toString()
+  const path = `/spreadsheets/${encodeURIComponent(spreadsheetId)}/values/${encodeURIComponent(range)}${qs ? `?${qs}` : ''}`
+  const res = await integration.fetch(path)
+  const payload = await res.json()
+
+  const values = Array.isArray(payload?.values) ? payload.values : []
+  const resolvedRange = payload?.range || range
+  const { startColumn, startRow } = parseResolvedRange(resolvedRange)
+
+  const width = Math.max(1, ...values.map((row) => (Array.isArray(row) ? row.length : 0)))
+  const headerCells = Array.from({ length: width }, (_, i) => toColumnName(startColumn + i))
+  const lines = [
+    `|   | ${headerCells.join(' | ')} |`,
+    `|---|${Array(width).fill('---').join('|')}|`,
+  ]
+
+  for (let i = 0; i < values.length; i += 1) {
+    const row = Array.isArray(values[i]) ? values[i] : []
+    const padded = [...row, ...Array(width - row.length).fill('')]
+    const escaped = padded.map((cell) => escapeCell(cell))
+    lines.push(`| ${startRow + i} | ${escaped.join(' | ')} |`)
+  }
+
+  return {
+    spreadsheetId,
+    range: resolvedRange,
+    rowCount: values.length,
+    columnCount: width,
+    markdown: lines.join('\n'),
+  }
+}