@synap-core/workspace-templates 0.11.0 → 0.23.0

package/capabilities/vercel.capability.json

@@ -0,0 +1,424 @@
+{
+  "apiVersion": "synap/v1",
+  "kind": "capability",
+  "meta": {
+    "slug": "vercel",
+    "name": "Vercel — Projects & Deploys",
+    "description": "Vercel account operations through ONE personal access token (REST API v9-v13): list/get projects, list/get deployments, list project domains, list environment variables, and redeploy a deployment. List verbs default their limit. Connect your Vercel account to use it.",
+    "tags": [
+      "capability"
+    ],
+    "isPublic": true,
+    "syncByDefault": true
+  },
+  "spec": {
+    "key": "vercel",
+    "name": "Vercel — Projects & Deploys",
+    "description": "Vercel REST API (https://api.vercel.com) through ONE vault API key: a Vercel Personal Access Token (Account Settings → Tokens), sent as `Authorization: Bearer <token>`. Read verbs: list projects, get a project, list deployments (optionally filtered by project/target/state), get a deployment, list a project's domains, list a project's environment variables. One write verb: redeploy an existing deployment — side-effecting, so it routes through the capability-execution gate. List verbs default their limit (20, max 100) and all filter params are optional. TEAM SCOPE: a token with access to a Team still needs the team identified — pass `teamId` (or `teamSlug`) on any verb or the request resolves against the personal account; both are optional and only sent when provided. PATHS ARE RELATIVE to the `vercel` tool's `config.baseUrl` (https://api.vercel.com). Environment-variable VALUES are deliberately NOT returned (matching Vercel's dashboard default): the verb lists keys, targets, types and timestamps. NOTE: response-field shaping is best-effort and confirmed against the live API at first run.",
+    "params": [
+      {
+        "name": "vercelToken",
+        "label": "Vercel Personal Access Token",
+        "type": "text",
+        "required": true,
+        "description": "A Vercel Personal Access Token created at https://vercel.com/account/tokens (Account Settings → Tokens). It is stored in the vault as an API key and sent as `Authorization: Bearer <token>`. Scope it to the Team that owns the projects you want reachable."
+      }
+    ],
+    "vault": [
+      {
+        "ref": "vercel",
+        "name": "Vercel Personal Access Token",
+        "value": "{{vercelToken}}",
+        "type": "api_key",
+        "service": "vercel",
+        "description": "Vercel personal access token (Bearer) used by every `vercel_*` verb."
+      }
+    ],
+    "tools": [
+      {
+        "name": "vercel",
+        "kind": "provider",
+        "description": "Vercel REST API access through a vault API key. credentialRef resolves to the created vault secret; the dispatcher injects `Authorization: Bearer <key>` and composes requests against config.baseUrl (https://api.vercel.com).",
+        "credentialRef": "vercel",
+        "executor": "is-agent",
+        "config": {
+          "serviceId": "vercel",
+          "baseUrl": "https://api.vercel.com"
+        }
+      }
+    ],
+    "skills": [
+      {
+        "name": "vercel_list_projects",
+        "intent": "list_records",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Lists the Vercel projects on the account (or team). Args: { limit?: number (default 20, max 100), search?: string (filter by project name, max 100 chars), teamId?: string, teamSlug?: string }.",
+        "requires": [
+          "vercel"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "limit": "number?",
+          "search": "string?",
+          "teamId": "string?",
+          "teamSlug": "string?"
+        },
+        "providerSpec": {
+          "tool": "vercel",
+          "method": "GET",
+          "pathTemplate": "/v10/projects",
+          "query": {
+            "limit": "{{limit}}",
+            "search": "{{search}}",
+            "teamId": "{{teamId}}",
+            "slug": "{{teamSlug}}"
+          },
+          "paramMapping": {
+            "limit": {
+              "default": 20,
+              "clampMin": 1,
+              "clampMax": 100
+            }
+          },
+          "responseShape": {
+            "collectionPath": "projects",
+            "collectionAs": "projects",
+            "item": {
+              "id": "id",
+              "name": "name",
+              "framework": "framework",
+              "nodeVersion": "nodeVersion",
+              "createdAt": "createdAt",
+              "updatedAt": "updatedAt"
+            },
+            "scalar": {
+              "count": "@count"
+            }
+          }
+        }
+      },
+      {
+        "name": "vercel_get_project",
+        "intent": "fetch_record",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Gets one Vercel project by its id or name. Args: { projectIdOrName: string, teamId?: string, teamSlug?: string }.",
+        "requires": [
+          "vercel"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "projectIdOrName": "string",
+          "teamId": "string?",
+          "teamSlug": "string?"
+        },
+        "providerSpec": {
+          "tool": "vercel",
+          "method": "GET",
+          "pathTemplate": "/v9/projects/{{projectIdOrName}}",
+          "query": {
+            "teamId": "{{teamId}}",
+            "slug": "{{teamSlug}}"
+          },
+          "paramMapping": {
+            "projectIdOrName": {
+              "required": true,
+              "encode": "uri"
+            }
+          },
+          "responseShape": {
+            "scalar": {
+              "id": "id",
+              "name": "name",
+              "framework": "framework",
+              "nodeVersion": "nodeVersion",
+              "rootDirectory": "rootDirectory",
+              "createdAt": "createdAt",
+              "updatedAt": "updatedAt",
+              "gitType": "link.type",
+              "gitRepo": "link.repo",
+              "gitProductionBranch": "link.productionBranch"
+            }
+          }
+        }
+      },
+      {
+        "name": "vercel_list_deployments",
+        "intent": "list_records",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Lists deployments, newest first — all of them, or filtered to one project. Args: { limit?: number (default 20, max 100), projectId?: string (project id or name), target?: string ('production' | 'staging'), state?: string ('BUILDING' | 'ERROR' | 'INITIALIZING' | 'QUEUED' | 'READY' | 'CANCELED' | 'BLOCKED'), teamId?: string, teamSlug?: string }.",
+        "requires": [
+          "vercel"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "limit": "number?",
+          "projectId": "string?",
+          "target": "string?",
+          "state": "string?",
+          "teamId": "string?",
+          "teamSlug": "string?"
+        },
+        "providerSpec": {
+          "tool": "vercel",
+          "method": "GET",
+          "pathTemplate": "/v7/deployments",
+          "query": {
+            "limit": "{{limit}}",
+            "projectId": "{{projectId}}",
+            "target": "{{target}}",
+            "state": "{{state}}",
+            "teamId": "{{teamId}}",
+            "slug": "{{teamSlug}}"
+          },
+          "paramMapping": {
+            "limit": {
+              "default": 20,
+              "clampMin": 1,
+              "clampMax": 100
+            }
+          },
+          "responseShape": {
+            "collectionPath": "deployments",
+            "collectionAs": "deployments",
+            "item": {
+              "id": "uid",
+              "name": "name",
+              "url": "url",
+              "state": "state",
+              "target": "target",
+              "source": "source",
+              "projectId": "projectId",
+              "inspectorUrl": "inspectorUrl",
+              "createdAt": "createdAt",
+              "readyAt": "ready"
+            },
+            "scalar": {
+              "count": "@count"
+            }
+          }
+        }
+      },
+      {
+        "name": "vercel_get_deployment",
+        "intent": "fetch_record",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Gets one deployment by its id (dpl_…) or hostname. Args: { deploymentIdOrUrl: string, teamId?: string, teamSlug?: string }.",
+        "requires": [
+          "vercel"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "deploymentIdOrUrl": "string",
+          "teamId": "string?",
+          "teamSlug": "string?"
+        },
+        "providerSpec": {
+          "tool": "vercel",
+          "method": "GET",
+          "pathTemplate": "/v13/deployments/{{deploymentIdOrUrl}}",
+          "query": {
+            "teamId": "{{teamId}}",
+            "slug": "{{teamSlug}}"
+          },
+          "paramMapping": {
+            "deploymentIdOrUrl": {
+              "required": true,
+              "encode": "uri"
+            }
+          },
+          "responseShape": {
+            "scalar": {
+              "id": "id",
+              "name": "name",
+              "url": "url",
+              "state": "state",
+              "readyState": "readyState",
+              "readySubstate": "readySubstate",
+              "target": "target",
+              "source": "source",
+              "projectId": "projectId",
+              "inspectorUrl": "inspectorUrl",
+              "creatorUsername": "creator.username",
+              "createdAt": "createdAt",
+              "readyAt": "ready",
+              "buildingAt": "buildingAt",
+              "meta": "meta"
+            }
+          }
+        }
+      },
+      {
+        "name": "vercel_list_project_domains",
+        "intent": "list_records",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Lists the domains attached to a project, with their verification state. Args: { projectIdOrName: string, limit?: number (default 20, max 100), teamId?: string, teamSlug?: string }.",
+        "requires": [
+          "vercel"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "projectIdOrName": "string",
+          "limit": "number?",
+          "teamId": "string?",
+          "teamSlug": "string?"
+        },
+        "providerSpec": {
+          "tool": "vercel",
+          "method": "GET",
+          "pathTemplate": "/v9/projects/{{projectIdOrName}}/domains",
+          "query": {
+            "limit": "{{limit}}",
+            "teamId": "{{teamId}}",
+            "slug": "{{teamSlug}}"
+          },
+          "paramMapping": {
+            "projectIdOrName": {
+              "required": true,
+              "encode": "uri"
+            },
+            "limit": {
+              "default": 20,
+              "clampMin": 1,
+              "clampMax": 100
+            }
+          },
+          "responseShape": {
+            "collectionPath": "domains",
+            "collectionAs": "domains",
+            "item": {
+              "name": "name",
+              "apexName": "apexName",
+              "projectId": "projectId",
+              "verified": "verified",
+              "redirect": "redirect",
+              "redirectStatusCode": "redirectStatusCode",
+              "createdAt": "createdAt",
+              "updatedAt": "updatedAt"
+            },
+            "scalar": {
+              "count": "@count"
+            }
+          }
+        }
+      },
+      {
+        "name": "vercel_list_env_vars",
+        "intent": "list_records",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Lists a project's environment variables — key, target environment(s), type and timestamps. Secret VALUES are not returned (this endpoint is not paginated and has no limit param). Args: { projectIdOrName: string, teamId?: string, teamSlug?: string }.",
+        "requires": [
+          "vercel"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "projectIdOrName": "string",
+          "teamId": "string?",
+          "teamSlug": "string?"
+        },
+        "providerSpec": {
+          "tool": "vercel",
+          "method": "GET",
+          "pathTemplate": "/v10/projects/{{projectIdOrName}}/env",
+          "query": {
+            "teamId": "{{teamId}}",
+            "slug": "{{teamSlug}}"
+          },
+          "paramMapping": {
+            "projectIdOrName": {
+              "required": true,
+              "encode": "uri"
+            }
+          },
+          "responseShape": {
+            "collectionPath": "envs",
+            "collectionAs": "env_vars",
+            "item": {
+              "id": "id",
+              "key": "key",
+              "type": "type",
+              "target": "target",
+              "gitBranch": "gitBranch",
+              "createdAt": "createdAt",
+              "updatedAt": "updatedAt"
+            },
+            "scalar": {
+              "count": "@count"
+            }
+          }
+        }
+      },
+      {
+        "name": "vercel_redeploy",
+        "intent": "run_external_job",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Redeploys an existing deployment by creating a NEW deployment (new id, url and build) that inherits the original's settings and environment variables. Side-effecting write — routes through the capability-execution gate. Returns immediately; poll vercel_get_deployment on the returned id for readiness. Args: { projectName: string, deploymentId: string (dpl_… to redeploy), target?: string (default 'production'), teamId?: string, teamSlug?: string }.",
+        "requires": [
+          "vercel"
+        ],
+        "executionMode": "async",
+        "timeoutSeconds": 90,
+        "parameters": {
+          "deploymentId": "string",
+          "projectName": "string",
+          "target": "string?",
+          "teamId": "string?",
+          "teamSlug": "string?"
+        },
+        "providerSpec": {
+          "tool": "vercel",
+          "method": "POST",
+          "pathTemplate": "/v13/deployments",
+          "query": {
+            "teamId": "{{teamId}}",
+            "slug": "{{teamSlug}}"
+          },
+          "body": {
+            "name": "{{projectName}}",
+            "deploymentId": "{{deploymentId}}",
+            "target": "{{target}}"
+          },
+          "paramMapping": {
+            "deploymentId": {
+              "required": true
+            },
+            "projectName": {
+              "required": true
+            },
+            "target": {
+              "default": "production"
+            }
+          },
+          "responseShape": {
+            "scalar": {
+              "id": "id",
+              "url": "url",
+              "readyState": "readyState",
+              "target": "target",
+              "status": "status",
+              "inspectorUrl": "inspectorUrl"
+            }
+          }
+        }
+      }
+    ],
+    "provides": [
+      "fetch_record",
+      "list_records",
+      "run_external_job"
+    ]
+  },
+  "dependencies": []
+}