@commandable/integration-data 0.0.1

package/integrations/github/handlers/create_pull_request.js

@@ -0,0 +1,16 @@
+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/integrations/github/handlers/create_repo.js

@@ -0,0 +1,11 @@
+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/integrations/github/handlers/delete_repo.js

@@ -0,0 +1,6 @@
+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 }
+}
+

package/integrations/github/handlers/get_issue.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}`)
+  return await res.json()
+}

package/integrations/github/handlers/get_repo.js

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

package/integrations/github/handlers/list_branches.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/branches`)
+  return await res.json()
+}

package/integrations/github/handlers/list_commits.js

@@ -0,0 +1,12 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.sha)
+    params.set('sha', input.sha)
+  if (typeof input.path === 'string' && input.path.length > 0)
+    params.set('path', input.path)
+  if (input.author)
+    params.set('author', input.author)
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/commits${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_issues.js

@@ -0,0 +1,12 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.state)
+    params.set('state', input.state)
+  if (input.labels)
+    params.set('labels', input.labels)
+  if (input.assignee)
+    params.set('assignee', input.assignee)
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_pull_requests.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.state)
+    params.set('state', input.state)
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls${query}`)
+  return await res.json()
+}

package/integrations/github/handlers/list_repos_install.js

@@ -0,0 +1,4 @@
+async () => {
+  const res = await integration.fetch('/installation/repositories')
+  return await res.json()
+}

package/integrations/github/handlers/list_repos_user.js

@@ -0,0 +1,4 @@
+async () => {
+  const res = await integration.fetch('/user/repos')
+  return await res.json()
+}

package/integrations/github/handlers/merge_pull_request.js

@@ -0,0 +1,14 @@
+async (input) => {
+  const body = {
+    commit_title: input.commit_title,
+    commit_message: input.commit_message,
+    merge_method: input.merge_method || 'merge',
+  }
+  
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}/merge`, { 
+    method: 'PUT', 
+    body 
+  })
+  return await res.json()
+}
+

package/integrations/github/handlers/update_issue.js

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

package/integrations/github/manifest.json

@@ -0,0 +1,26 @@
+{
+  "name": "github",
+  "version": "0.1.0",
+  "tools": [
+    { "name": "list_repos", "description": "List repositories for the authenticated user.", "inputSchema": "schemas/empty.json", "handler": "handlers/list_repos_user.js", "scope": "read" },
+    { "name": "get_repo", "description": "Get a repository by owner and name.", "inputSchema": "schemas/get_repo.json", "handler": "handlers/get_repo.js", "scope": "read" },
+    { "name": "list_issues", "description": "List issues for a repository.", "inputSchema": "schemas/list_issues.json", "handler": "handlers/list_issues.js", "scope": "read" },
+    { "name": "get_issue", "description": "Get a specific issue by number.", "inputSchema": "schemas/get_issue.json", "handler": "handlers/get_issue.js", "scope": "read" },
+    { "name": "list_pull_requests", "description": "List pull requests for a repository.", "inputSchema": "schemas/list_pull_requests.json", "handler": "handlers/list_pull_requests.js", "scope": "read" },
+    { "name": "list_branches", "description": "List branches for a repository.", "inputSchema": "schemas/owner_repo.json", "handler": "handlers/list_branches.js", "scope": "read" },
+    { "name": "list_commits", "description": "List commits for a repository.", "inputSchema": "schemas/list_commits.json", "handler": "handlers/list_commits.js", "scope": "read" },
+
+    { "name": "create_repo", "description": "Create a new repository.", "inputSchema": "schemas/create_repo.json", "handler": "handlers/create_repo.js", "scope": "write" },
+    { "name": "delete_repo", "description": "Delete a repository (requires delete_repo scope).", "inputSchema": "schemas/delete_repo.json", "handler": "handlers/delete_repo.js", "scope": "write" },
+    { "name": "create_branch", "description": "Create a new branch in a repository.", "inputSchema": "schemas/create_branch.json", "handler": "handlers/create_branch.js", "scope": "write" },
+    { "name": "create_or_update_file", "description": "Create or update a single file (content must be plain text; base64 handled internally).", "inputSchema": "schemas/create_or_update_file.json", "handler": "handlers/create_or_update_file.js", "scope": "write" },
+    { "name": "create_commit", "description": "Create a commit with multiple files (content must be plain text; base64 handled internally).", "inputSchema": "schemas/create_commit.json", "handler": "handlers/create_commit.js", "scope": "write" },
+    { "name": "create_pull_request", "description": "Create a pull request.", "inputSchema": "schemas/create_pull_request.json", "handler": "handlers/create_pull_request.js", "scope": "write" },
+    { "name": "merge_pull_request", "description": "Merge a pull request.", "inputSchema": "schemas/merge_pull_request.json", "handler": "handlers/merge_pull_request.js", "scope": "write" },
+    { "name": "create_issue", "description": "Create an issue in a repository.", "inputSchema": "schemas/create_issue.json", "handler": "handlers/create_issue.js", "scope": "write" },
+    { "name": "update_issue", "description": "Update fields on an issue.", "inputSchema": "schemas/update_issue.json", "handler": "handlers/update_issue.js", "scope": "write" },
+    { "name": "comment_on_issue", "description": "Add a comment to an issue.", "inputSchema": "schemas/comment_on_issue.json", "handler": "handlers/comment_on_issue.js", "scope": "write" },
+    { "name": "add_labels_to_issue", "description": "Add labels to an issue or pull request.", "inputSchema": "schemas/add_labels_to_issue.json", "handler": "handlers/add_labels_to_issue.js", "scope": "write" },
+    { "name": "close_issue", "description": "Close an issue.", "inputSchema": "schemas/close_issue.json", "handler": "handlers/close_issue.js", "scope": "write" }
+  ]
+}

package/integrations/github/schemas/add_labels_to_issue.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "issue_number": { "type": "number", "description": "The number of the issue" },
+    "labels": { "type": "array", "items": { "type": "string" }, "description": "The names of the labels to add" }
+  },
+  "required": ["owner", "repo", "issue_number", "labels"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/close_issue.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "issue_number": { "type": "integer", "minimum": 1 }
+  },
+  "required": ["owner", "repo", "issue_number"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/comment_on_issue.json

@@ -0,0 +1,11 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "issue_number": { "type": "integer", "minimum": 1 },
+    "body": { "type": "string" }
+  },
+  "required": ["owner", "repo", "issue_number", "body"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/create_branch.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "branch": { "type": "string", "description": "The name of the new branch" },
+    "from_branch": { "type": "string", "description": "The branch to create from. Defaults to the repository's default branch" }
+  },
+  "required": ["owner", "repo", "branch"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/create_commit.json

@@ -0,0 +1,25 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "branch": { "type": "string", "description": "The branch to commit to" },
+    "message": { "type": "string", "description": "The commit message" },
+    "files": {
+      "type": "array",
+      "description": "Array of files to add/update/delete in this commit",
+      "items": {
+        "type": "object",
+        "properties": {
+          "path": { "type": "string", "description": "File path in the repository" },
+          "content": { "type": "string", "description": "Plain text file content (omit to delete). Do NOT base64; encoding handled internally." },
+          "mode": { "type": "string", "enum": ["100644", "100755", "040000", "160000", "120000"], "description": "File mode (100644 for regular files, 100755 for executable)" }
+        },
+        "required": ["path"]
+      }
+    }
+  },
+  "required": ["owner", "repo", "branch", "message", "files"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/create_issue.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "title": { "type": "string" },
+    "body": { "type": "string" },
+    "assignees": { "type": "array", "items": { "type": "string" } },
+    "labels": { "type": "array", "items": { "type": "string" } }
+  },
+  "required": ["owner", "repo", "title"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/create_or_update_file.json

@@ -0,0 +1,15 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "path": { "type": "string", "description": "Path to the file in the repository" },
+    "message": { "type": "string", "description": "The commit message" },
+    "content": { "type": "string", "description": "Plain text file content. Do NOT base64; encoding handled internally." },
+    "branch": { "type": "string", "description": "The branch name. Defaults to the repository's default branch" },
+    "sha": { "type": "string", "description": "Required if updating an existing file. The blob SHA of the file being replaced" }
+  },
+  "required": ["owner", "repo", "path", "message", "content"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/create_pull_request.json

@@ -0,0 +1,15 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "title": { "type": "string", "description": "The title of the pull request" },
+    "body": { "type": "string", "description": "The contents of the pull request" },
+    "head": { "type": "string", "description": "The name of the branch where your changes are implemented" },
+    "base": { "type": "string", "description": "The name of the branch you want the changes pulled into" },
+    "draft": { "type": "boolean", "description": "Whether to create the pull request as a draft" }
+  },
+  "required": ["owner", "repo", "title", "head", "base"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/create_repo.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "name": { "type": "string", "description": "The name of the repository" },
+    "description": { "type": "string", "description": "A short description of the repository" },
+    "private": { "type": "boolean", "description": "Whether the repository is private", "default": false },
+    "auto_init": { "type": "boolean", "description": "Pass true to create an initial commit with empty README", "default": false }
+  },
+  "required": ["name"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/delete_repo.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/empty.json

@@ -0,0 +1,5 @@
+{
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_issue.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "issue_number": { "type": "integer", "minimum": 1 }
+  },
+  "required": ["owner", "repo", "issue_number"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_repo.json

@@ -0,0 +1,9 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/list_commits.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "sha": { "type": "string" },
+    "path": { "type": "string" },
+    "author": { "type": "string" }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/list_issues.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "state": { "type": "string", "enum": ["open", "closed", "all"], "default": "open" },
+    "labels": { "type": "string" },
+    "assignee": { "type": "string" }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/list_pull_requests.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "state": { "type": "string", "enum": ["open", "closed", "all"], "default": "open" }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/merge_pull_request.json

@@ -0,0 +1,14 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "pull_number": { "type": "number", "description": "The number of the pull request" },
+    "commit_title": { "type": "string", "description": "Title for the automatic commit message" },
+    "commit_message": { "type": "string", "description": "Extra detail to append to automatic commit message" },
+    "merge_method": { "type": "string", "enum": ["merge", "squash", "rebase"], "description": "Merge method to use. Default is 'merge'" }
+  },
+  "required": ["owner", "repo", "pull_number"],
+  "additionalProperties": false
+}
+

package/integrations/github/schemas/owner_repo.json

@@ -0,0 +1,9 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/update_issue.json

@@ -0,0 +1,15 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "issue_number": { "type": "integer", "minimum": 1 },
+    "title": { "type": "string" },
+    "body": { "type": "string" },
+    "state": { "type": "string", "enum": ["open", "closed"] },
+    "assignees": { "type": "array", "items": { "type": "string" } },
+    "labels": { "type": "array", "items": { "type": "string" } }
+  },
+  "required": ["owner", "repo", "issue_number"],
+  "additionalProperties": false
+}

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

@@ -0,0 +1,112 @@
+import { beforeAll, describe, expect, it } from 'vitest'
+import { IntegrationProxy } from '../../../../server/src/integrations/proxy.js'
+import { loadIntegrationTools } from '../../../../server/src/integrations/dataLoader.js'
+
+// LIVE Google Calendar read tests using managed OAuth
+// Required env vars:
+// - COMMANDABLE_MANAGED_OAUTH_BASE_URL
+// - COMMANDABLE_MANAGED_OAUTH_SECRET_KEY
+// - GCAL_TEST_CONNECTION_ID (managed OAuth connection for provider 'google-calendar')
+
+interface Ctx {
+  calendarId?: string
+  eventId?: string
+}
+
+const env = process.env as Record<string, string>
+const hasEnv = (...keys: string[]) => keys.every(k => !!env[k] && env[k].trim().length > 0)
+const suite = hasEnv(
+  'COMMANDABLE_MANAGED_OAUTH_BASE_URL',
+  'COMMANDABLE_MANAGED_OAUTH_SECRET_KEY',
+  'GCAL_TEST_CONNECTION_ID',
+)
+  ? describe
+  : describe.skip
+
+suite('google-calendar read handlers (live)', () => {
+  const ctx: Ctx = {}
+  let buildHandler: (name: string) => ((input: any) => Promise<any>)
+
+  beforeAll(async () => {
+    const { COMMANDABLE_MANAGED_OAUTH_BASE_URL, COMMANDABLE_MANAGED_OAUTH_SECRET_KEY, GCAL_TEST_CONNECTION_ID } = env
+
+    const proxy = new IntegrationProxy({
+      managedOAuthBaseUrl: COMMANDABLE_MANAGED_OAUTH_BASE_URL,
+      managedOAuthSecretKey: COMMANDABLE_MANAGED_OAUTH_SECRET_KEY,
+    })
+    const integrationNode = { id: 'node-gcal', type: 'google-calendar', label: 'Google Calendar', connectionId: GCAL_TEST_CONNECTION_ID } as any
+
+    const tools = loadIntegrationTools('google-calendar')
+    expect(tools).toBeTruthy()
+
+    buildHandler = (name: string) => {
+      const tool = tools!.read.find(t => t.name === name)
+      expect(tool, `tool ${name} exists`).toBeTruthy()
+      const integration = { fetch: (path: string, init?: RequestInit) => proxy.call(integrationNode, path, init) }
+      const build = new Function('integration', `return (${tool!.handlerCode});`)
+      return build(integration) as (input: any) => Promise<any>
+    }
+
+    const list_calendars = buildHandler('list_calendars')
+    const calendars = await list_calendars({})
+    ctx.calendarId = calendars?.items?.[0]?.id || 'primary'
+
+    if (ctx.calendarId) {
+      const list_events = buildHandler('list_events')
+      const events = await list_events({ calendarId: ctx.calendarId, maxResults: 1, singleEvents: true, orderBy: 'startTime', timeMin: new Date(Date.now() - 7 * 24 * 3600 * 1000).toISOString() })
+      ctx.eventId = events?.items?.[0]?.id
+    }
+  }, 60000)
+
+  it('list_calendars returns calendars', async () => {
+    const handler = buildHandler('list_calendars')
+    const result = await handler({})
+    expect(result).toBeTruthy()
+  }, 30000)
+
+  it('get_calendar returns a calendar', async () => {
+    const handler = buildHandler('get_calendar')
+    const result = await handler({ calendarId: ctx.calendarId || 'primary' })
+    expect(result?.id).toBeTruthy()
+  }, 30000)
+
+  it('list_events returns events', async () => {
+    if (!ctx.calendarId)
+      return expect(true).toBe(true)
+    const handler = buildHandler('list_events')
+    const result = await handler({ calendarId: ctx.calendarId, maxResults: 3, singleEvents: true })
+    expect(result).toBeTruthy()
+  }, 30000)
+
+  it('get_event returns an event by id when available', async () => {
+    if (!ctx.calendarId || !ctx.eventId)
+      return expect(true).toBe(true)
+    const handler = buildHandler('get_event')
+    const result = await handler({ calendarId: ctx.calendarId, eventId: ctx.eventId })
+    expect(result?.id).toBe(ctx.eventId)
+  }, 30000)
+
+  it('list_colors returns colors', async () => {
+    const handler = buildHandler('list_colors')
+    const result = await handler({})
+    expect(result?.calendar || result?.event).toBeTruthy()
+  }, 30000)
+
+  it('list_settings returns user settings', async () => {
+    const handler = buildHandler('list_settings')
+    const result = await handler({})
+    expect(Array.isArray(result?.items) || result?.kind === 'calendar#settings').toBe(true)
+  }, 30000)
+
+  it('freebusy_query returns availability', async () => {
+    const handler = buildHandler('freebusy_query')
+    const now = new Date()
+    const inOneHour = new Date(now.getTime() + 60 * 60 * 1000)
+    const result = await handler({
+      timeMin: now.toISOString(),
+      timeMax: inOneHour.toISOString(),
+      items: [{ id: ctx.calendarId || 'primary' }],
+    })
+    expect(result?.calendars || result?.groups).toBeTruthy()
+  }, 30000)
+})

package/integrations/google-calendar/__tests__/usage_parity.test.ts

@@ -0,0 +1,34 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { describe, expect, it } from 'vitest'
+import { loadIntegrationManifest } from '../../../src/integrations/dataLoader.js'
+
+function escapeRegExp(str: string): string {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+describe('google-calendar static usage parity', () => {
+  it('every manifest tool is referenced in tests via build*(name)', () => {
+    const manifest = loadIntegrationManifest('google-calendar')!
+    const toolNames = (manifest.tools as any[]).map(t => t.name)
+
+    const testsDir = fileURLToPath(new URL('.', import.meta.url))
+    expect(existsSync(testsDir)).toBe(true)
+    const testFiles = readdirSync(testsDir)
+      .filter(f => /\.test\.(t|j)s$/.test(f) && !f.includes('usage_parity.test'))
+      .map(f => resolve(testsDir, f))
+
+    const fileContents = testFiles.map(f => readFileSync(f, 'utf8'))
+
+    const missing: string[] = []
+    for (const name of toolNames) {
+      const nameRe = new RegExp(`build(?:Read|Write|Admin|Handler)\\(\\s*['\"\`]${escapeRegExp(name)}['\"\`]\\s*\\)`, 'm')
+      const found = fileContents.some(src => nameRe.test(src))
+      if (!found)
+        missing.push(name)
+    }
+
+    expect(missing, `Missing handler usages in tests: ${missing.join(', ')}`).toEqual([])
+  })
+})