@zackbart/connecta 0.22.0 → 0.22.1

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this package are documented here.
 
+## 0.22.1 — 2026-08-31
+
+This patch adds a maintained Vercel connection over the public REST API. It is
+a new opt-in provider subpath: existing imports, connector declarations,
+credentials, and deployment behavior do not change. Deployments that do not
+import the Vercel provider can ignore this release.
+
+### Added
+
+- **Maintained Vercel REST connection.** `@zackbart/connecta/providers/vercel`
+  ships 18 projected project, deployment, log, domain, environment-variable,
+  and lifecycle tools plus separate GET, JSON-mutation, and upload hatches. It
+  uses one operator-managed access token, defaults account calls to an optional
+  team, never decrypts environment values in named reads, and adds no Vercel
+  SDK dependency.
+
 ## 0.22.0 — 2026-08-31
 
 This release lets one deployment serve several authenticated people without

package/README.md

@@ -33,7 +33,7 @@ flowchart TB
         Explicit["call_destructive_tool<br/>one visible call per write<br/>your client can ask you first"]
     end
 
-    Integrations["The integrations you chose<br/>Linear · Stripe · Notion · your HTTP API · any MCP server"]
+    Integrations["The integrations you chose<br/>Linear · Stripe · Notion · Vercel · your HTTP API · any MCP server"]
 
     Client -->|"one connection"| Sandbox
     Client --> Explicit
@@ -63,8 +63,8 @@ Fifty issues in, one small object out. Your context window notices.
 - **Wrap any HTTP API by hand.** A few lines per tool. No OpenAPI conversion —
   generated tool sprawl is the problem, not the fix.
 - **Use maintained connections** for Cloudflare, Linear, Mixpanel, Notion,
-  RevenueCat, and Stripe — known endpoints, auth defaults, and vetted read/write
-  classifications, imported one at a time.
+  RevenueCat, Stripe, and Vercel — known endpoints, auth defaults, and vetted
+  read/write classifications, imported one at a time.
 - **Let the agent work in code.** Search, chain, filter, join, and reduce
   inside the sandbox instead of round-tripping every call through the model.
 - **Teach undeclared result shapes by using them.** Successful read-only calls

package/dist/providers/vercel.d.ts

@@ -0,0 +1,25 @@
+import type { Connector, ConnectorCallAdmissionPolicy } from "../types.js";
+/** Vercel's public REST origin. Override only for a proxy or test double. */
+export declare const VERCEL_API_BASE_URL = "https://api.vercel.com";
+export interface VercelOptions {
+    /** Human-readable display name; defaults to "Vercel". */
+    title?: string;
+    /** Downstream auth ownership. Defaults to one shared deployment grant. */
+    authScope?: "shared" | "personal";
+    /** Which Vercel account or team this connection operates, and for whom. */
+    purpose: string;
+    /** Default team id for scoped calls. Omit to use the token's personal account. */
+    teamId?: string;
+    /** Account-specific conventions appended to the maintained provider guide. */
+    instructions?: string;
+    /** API base override for a proxy or test double. */
+    baseUrl?: string;
+    /** Default page size for list tools. Defaults to 20; Vercel's local cap is 100. */
+    defaultPageSize?: number;
+    /** Optional per-runtime downstream call-admission policy. */
+    callAdmission?: ConnectorCallAdmissionPolicy;
+    /** Connector-specific inline result limit; omit to inherit the deployment. */
+    maxResultBytes?: number;
+}
+/** A maintained Vercel connection over the public REST API. */
+export declare function vercel(id: string, options: VercelOptions): Connector;