@zackbart/connecta 0.34.1 → 0.36.0

package/dist/providers/vercel/tools.js

@@ -0,0 +1,642 @@
+// Curated Vercel metadata and bounded logs through kit-owned call services.
+import { Effect, Schema } from "effect";
+import { ConnectorCallError } from "../../errors.js";
+import { Refusal } from "../../http/errors.js";
+import { read, write, list } from "../../http/tools.js";
+import { fieldsProblem, selectFields } from "../../http/fields.js";
+import { vercelPage } from "../../http/hatch-paging.js";
+import { schema, typedParams } from "../_shared/rest/kit.js";
+import { refuseWithheldUpload } from "../_shared/rest/value-safety.js";
+import { rowStop } from "./lib/logs.js";
+import { checked } from "../_shared/rest/kit.js";
+import { admit, compact, defaultTeam, isRecord, invalid, named, queryOf, queryPairs, record, reviewedCode, restCall, text, vercelIndex, refuse, checkServer, } from "./api.js";
+import { pinOptions, readPinnedTeam, PIN_WRITE_STEPS } from "./lib/pin.js";
+const MAX_LOG_BYTES = 1024 * 1024;
+const MAX_LOG_TEXT = 4_000;
+const MAX_UPLOAD_BYTES = 8 * 1024 * 1024;
+function promise(run) {
+    return Effect.tryPromise({ try: run, catch: (error) => error }).pipe(Effect.catch((error) => error instanceof ConnectorCallError ? Effect.fail(new Refusal({ error })) : Effect.die(error)));
+}
+function clamp(value) {
+    if (typeof value !== "string")
+        return {};
+    return value.length > MAX_LOG_TEXT ? { text: value.slice(0, MAX_LOG_TEXT) } : { text: value };
+}
+const TEAM_ID = {
+    type: ["string", "null"],
+    minLength: 1,
+    description: "Vercel team id. Omit for the connection's default; null for the token owner's personal account.",
+};
+const PROJECT_ID = { type: "string", minLength: 1, description: "Project id or name." };
+const ENV_VAR_ID = {
+    type: "string",
+    minLength: 1,
+    description: "Environment-variable id from list_project_env_vars.",
+};
+const TARGETS = {
+    type: "array",
+    minItems: 1,
+    uniqueItems: true,
+    items: {
+        type: "string",
+        enum: ["production", "preview", "development"],
+        description: "A default Vercel environment.",
+    },
+    description: "Default Vercel environments that receive this value.",
+};
+const CUSTOM_ENVIRONMENT_IDS = {
+    type: "array",
+    uniqueItems: true,
+    items: { type: "string", minLength: 1, description: "A custom environment id." },
+    description: "Custom environment ids that receive this value.",
+};
+const ENV_SCHEMA = {
+    type: "object",
+    properties: {
+        id: { type: "string" },
+        key: { type: "string" },
+        type: { type: "string" },
+        target: { type: ["array", "string"], items: { type: "string" } },
+        gitBranch: { type: ["string", "null"] },
+        customEnvironmentIds: { type: "array", items: { type: "string" } },
+        comment: { type: "string" },
+        createdAt: { type: "number" },
+        updatedAt: { type: "number" },
+    },
+    required: ["id", "key", "type"],
+};
+/** Deliberately omits `value`, even though redaction already removed it. */
+function envMetadata(value) {
+    const variable = record(value);
+    return compact({
+        id: variable["id"],
+        key: variable["key"],
+        type: variable["type"],
+        target: variable["target"],
+        gitBranch: variable["gitBranch"],
+        customEnvironmentIds: variable["customEnvironmentIds"],
+        comment: variable["comment"],
+        createdAt: variable["createdAt"],
+        updatedAt: variable["updatedAt"],
+    });
+}
+function closed(properties, required) {
+    return { type: "object", properties, required, additionalProperties: false };
+}
+function segment(value) {
+    return encodeURIComponent(String(value));
+}
+function decodeUpload(args) {
+    const hasText = typeof args["textBody"] === "string";
+    const hasBase64 = typeof args["base64Body"] === "string";
+    if (hasText === hasBase64)
+        invalid("Provide exactly one of textBody or base64Body for a Vercel upload.");
+    let bytes;
+    if (hasText)
+        bytes = new TextEncoder().encode(args["textBody"]);
+    else {
+        try {
+            bytes = Uint8Array.from(atob(args["base64Body"]), (character) => character.charCodeAt(0));
+        }
+        catch {
+            return invalid("base64Body is not valid base64.");
+        }
+    }
+    if (bytes.length > MAX_UPLOAD_BYTES)
+        invalid(`A Vercel upload through Connecta is at most ${MAX_UPLOAD_BYTES} bytes.`);
+    return bytes;
+}
+async function sha1(bytes) {
+    const digest = new Uint8Array(await crypto.subtle.digest("SHA-1", bytes));
+    return [...digest].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+export function vercelTools({ connection, options, }) {
+    options = pinOptions(options);
+    const teamId = defaultTeam(options);
+    const makeCall = (method, path, input = {}) => restCall(method, path, input, teamId, options.pin);
+    const send = (method, path, input = {}) => checked(() => makeCall(method, path, input)).pipe(Effect.flatMap((call) => {
+        const operation = named.find((op) => op.method === call.method && op.path.replace(/:([^/]+)/g, "{$1}") === call.op.path);
+        if (!operation)
+            throw new Error("A named Vercel call has no declared operation.");
+        return admit(call, connection, options).pipe(Effect.flatMap(() => connection.send(operation, {
+            params: typedParams(call.params),
+            query: queryOf(call),
+            payload: call.body,
+        })), Effect.map((answer) => {
+            return { ...answer, data: answer.data ?? null };
+        }));
+    }));
+    const boundedRows = (call, limits) => {
+        const operation = named.find((op) => op.method === call.method && op.path.replace(/:([^/]+)/g, "{$1}") === call.op.path);
+        return admit(call, connection, options).pipe(Effect.flatMap(() => connection
+            .send(operation, { params: typedParams(call.params), query: queryOf(call), payload: undefined }, {
+            flags: { log: true },
+            prefix: { maxBytes: MAX_LOG_BYTES, timeoutMs: limits.waitMs, stop: rowStop(limits) },
+        })
+            .pipe(Effect.map((answer) => ({
+            rows: Array.isArray(answer.data) ? answer.data : [],
+            stopped: answer.prefix?.stopped === "stop" ? "rows" : (answer.prefix?.stopped ?? "end"),
+        })))));
+    };
+    const declarations = [
+        {
+            name: "list_project_env_vars",
+            description: "List a project's environment-variable metadata without decrypting or returning values: keys, types, targets, branches, and custom environments.",
+            annotations: { readOnlyHint: true },
+            inputSchema: closed({
+                projectId: PROJECT_ID,
+                teamId: TEAM_ID,
+                slug: {
+                    type: "string",
+                    minLength: 1,
+                    description: "Team slug; overrides the routing default when teamId is omitted.",
+                },
+                gitBranch: { type: "string", description: "Preview branch filter." },
+                customEnvironmentId: { type: "string", description: "Custom environment filter." },
+                fields: {
+                    type: "array",
+                    maxItems: 50,
+                    items: { type: "string", minLength: 1, maxLength: 200 },
+                    description: "Dot paths to keep in each metadata item; values cannot be restored.",
+                },
+            }, ["projectId"]),
+            outputSchema: {
+                type: "object",
+                properties: {
+                    items: { type: "array", items: { ...ENV_SCHEMA, required: [] } },
+                    page: { type: "object", properties: { hasMore: { enum: [false], type: "boolean" } }, required: ["hasMore"] },
+                },
+                required: ["items", "page"],
+            },
+            run: (args) => Effect.gen(function* () {
+                const fields = args["fields"];
+                const problem = fieldsProblem(fields, new Set(Object.keys(ENV_SCHEMA.properties)), "an environment metadata item");
+                if (problem)
+                    throw problem;
+                const { data } = yield* send("GET", `/v10/projects/${segment(args["projectId"])}/env`, {
+                    query: compact({
+                        teamId: args["teamId"],
+                        slug: args["slug"],
+                        gitBranch: args["gitBranch"],
+                        customEnvironmentId: args["customEnvironmentId"],
+                        decrypt: "false",
+                    }),
+                });
+                const envs = record(data)["envs"];
+                return {
+                    items: selectFields((Array.isArray(envs) ? envs : []).map(envMetadata), fields),
+                    page: { hasMore: false },
+                };
+            }),
+        },
+        {
+            name: "upsert_project_env_var",
+            description: "Create or replace one Vercel project environment variable. Changes affect only future deployments; returns metadata without the value.",
+            annotations: { readOnlyHint: false, destructiveHint: true },
+            inputSchema: closed({
+                projectId: PROJECT_ID,
+                teamId: TEAM_ID,
+                slug: {
+                    type: "string",
+                    minLength: 1,
+                    description: "Team slug; overrides the routing default when teamId is omitted.",
+                },
+                key: { type: "string", minLength: 1, maxLength: 256, description: "Environment variable name." },
+                value: {
+                    type: "string",
+                    writeOnly: true,
+                    maxLength: 65536,
+                    description: "New value; write input only. Vercel caps a project's environment at 64 KB.",
+                },
+                type: {
+                    type: "string",
+                    enum: ["plain", "encrypted", "sensitive"],
+                    description: "Storage type. Sensitive values cannot be read back.",
+                },
+                targets: TARGETS,
+                gitBranch: { type: "string", description: "Optional preview-only Git branch." },
+                customEnvironmentIds: CUSTOM_ENVIRONMENT_IDS,
+                comment: { type: "string", maxLength: 500, description: "Operator-facing note explaining the variable." },
+                upsert: {
+                    type: "boolean",
+                    description: "Defaults to true. False refuses to overwrite an existing variable.",
+                },
+            }, ["projectId", "key", "value", "type", "targets"]),
+            outputSchema: ENV_SCHEMA,
+            run: (args) => Effect.gen(function* () {
+                const { data } = yield* send("POST", `/v10/projects/${segment(args["projectId"])}/env`, {
+                    query: compact({
+                        slug: args["slug"],
+                        teamId: args["teamId"],
+                        upsert: args["upsert"] === false ? "false" : "true",
+                    }),
+                    body: compact({
+                        key: args["key"],
+                        value: args["value"],
+                        type: args["type"],
+                        target: args["targets"],
+                        gitBranch: args["gitBranch"],
+                        customEnvironmentIds: args["customEnvironmentIds"],
+                        comment: args["comment"],
+                    }),
+                });
+                const payload = record(data);
+                if (Array.isArray(payload["failed"]) && payload["failed"].length) {
+                    const created = (Array.isArray(payload["created"]) ? payload["created"] : [payload["created"]]).map((item) => compact({ id: text(record(item)["id"]), key: text(record(item)["key"]) }));
+                    const failed = payload["failed"].map((item) => compact({
+                        key: text(record(item)["key"] ?? record(record(item)["error"])["key"]),
+                        code: reviewedCode(record(record(item)["error"])["code"]) ?? "unclassified",
+                    }));
+                    return yield* Effect.fail(new Refusal({
+                        error: new ConnectorCallError("connector_call_failed", `Vercel partially accepted the environment-variable write for sent key ${JSON.stringify(args["key"])}. Created entries: ${JSON.stringify(created)}. Failed entries: ${JSON.stringify(failed)}. Check the target before repeating it.`, { retryable: false, writeOutcome: "unknown" }),
+                    }));
+                }
+                const created = Array.isArray(payload["created"]) ? payload["created"][0] : payload["created"];
+                return envMetadata(created ?? payload);
+            }),
+        },
+        {
+            name: "update_project_env_var",
+            description: "Update one Vercel project environment variable by id, sending only the fields that change. Deployments keep their previous values.",
+            annotations: { readOnlyHint: false, destructiveHint: true },
+            inputSchema: closed({
+                projectId: PROJECT_ID,
+                teamId: TEAM_ID,
+                slug: {
+                    type: "string",
+                    minLength: 1,
+                    description: "Team slug; overrides the routing default when teamId is omitted.",
+                },
+                envVarId: ENV_VAR_ID,
+                key: { type: "string", minLength: 1, maxLength: 256, description: "Replacement variable name." },
+                value: {
+                    type: "string",
+                    writeOnly: true,
+                    maxLength: 65536,
+                    description: "Replacement value; write input only.",
+                },
+                type: { type: "string", enum: ["plain", "encrypted", "sensitive"], description: "Replacement storage type." },
+                targets: { ...TARGETS, description: "Replacement default environments." },
+                gitBranch: { type: ["string", "null"], description: "Replacement preview branch, or null to clear it." },
+                customEnvironmentIds: { ...CUSTOM_ENVIRONMENT_IDS, description: "Replacement custom environment ids." },
+                comment: { type: "string", maxLength: 500, description: "Replacement operator-facing note." },
+            }, ["projectId", "envVarId"]),
+            outputSchema: ENV_SCHEMA,
+            run: (args) => Effect.gen(function* () {
+                const body = compact({
+                    key: args["key"],
+                    value: args["value"],
+                    type: args["type"],
+                    target: args["targets"],
+                    gitBranch: args["gitBranch"],
+                    customEnvironmentIds: args["customEnvironmentIds"],
+                    comment: args["comment"],
+                });
+                if (Object.keys(body).length === 0) {
+                    invalid("Nothing to update: provide key, value, type, targets, gitBranch, customEnvironmentIds, or comment.");
+                }
+                const { data } = yield* send("PATCH", `/v9/projects/${segment(args["projectId"])}/env/${segment(args["envVarId"])}`, { query: compact({ slug: args["slug"], teamId: args["teamId"] }), body });
+                return envMetadata(data);
+            }),
+        },
+        {
+            name: "get_deployment_build_logs",
+            description: "Read a deployment's build events and log lines, without following live output. Bounded by limit and 1 MB; filter by build, time, or direction.",
+            annotations: { readOnlyHint: true },
+            inputSchema: closed({
+                deploymentId: { type: "string", minLength: 1, description: "Deployment id (dpl_…) or hostname." },
+                teamId: TEAM_ID,
+                slug: {
+                    type: "string",
+                    minLength: 1,
+                    description: "Team slug; overrides the routing default when teamId is omitted.",
+                },
+                buildId: { type: "string", minLength: 1, description: "Only this build's events (bld_…)." },
+                direction: {
+                    type: "string",
+                    enum: ["forward", "backward"],
+                    description: "forward (default) reads oldest first; backward reads the newest first.",
+                },
+                limit: { type: "integer", minimum: 1, maximum: 2000, description: "Most events; default 200." },
+                since: { type: "number", description: "Only events at or after this millisecond timestamp." },
+                until: { type: "number", description: "Only events at or before this millisecond timestamp." },
+            }, ["deploymentId"]),
+            outputSchema: {
+                type: "object",
+                properties: {
+                    events: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                created: { type: "number" },
+                                type: { type: "string", description: "stdout, stderr, command, exit, deployment-state, and so on." },
+                                text: { type: "string" },
+                                info: {
+                                    type: "object",
+                                    properties: Object.fromEntries(["type", "name", "step", "entrypoint", "path", "readyState"].map((name) => [
+                                        name,
+                                        { type: "string" },
+                                    ])),
+                                    description: "Build step, entrypoint, and path when Vercel sends them.",
+                                },
+                            },
+                        },
+                    },
+                    truncated: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Dot paths cut for size or by the bounded prefix, including events[] and events[].text.",
+                    },
+                },
+                required: ["events", "truncated"],
+            },
+            run: (args) => Effect.gen(function* () {
+                const call = makeCall("GET", `/v3/deployments/${segment(args["deploymentId"])}/events`, {
+                    query: compact({
+                        teamId: args["teamId"],
+                        slug: args["slug"],
+                        name: args["buildId"],
+                        direction: args["direction"],
+                        limit: args["limit"] ?? 200,
+                        since: args["since"],
+                        until: args["until"],
+                        follow: 0,
+                    }),
+                });
+                const { rows, stopped } = yield* boundedRows(call, { waitMs: 20_000 });
+                return {
+                    events: rows.map((row) => {
+                        const event = record(row);
+                        const payload = record(event["payload"]);
+                        const raw = isRecord(payload["info"])
+                            ? payload["info"]
+                            : isRecord(event["info"])
+                                ? event["info"]
+                                : undefined;
+                        const info = raw
+                            ? compact({
+                                type: text(raw["type"]),
+                                name: text(raw["name"]),
+                                step: text(raw["step"]),
+                                entrypoint: text(raw["entrypoint"]),
+                                path: text(raw["path"]),
+                                readyState: text(raw["readyState"]),
+                            })
+                            : undefined;
+                        return compact({
+                            created: event["created"] ?? payload["created"] ?? payload["date"],
+                            type: event["type"],
+                            ...clamp(payload["text"] ?? event["text"]),
+                            info,
+                        });
+                    }),
+                    truncated: [
+                        ...(stopped !== "end" ? ["events[]"] : []),
+                        ...(rows.some((row) => {
+                            const e = record(row);
+                            return String(record(e["payload"])["text"] ?? e["text"] ?? "").length > MAX_LOG_TEXT;
+                        })
+                            ? ["events[].text"]
+                            : []),
+                    ],
+                };
+            }),
+        },
+        {
+            name: "get_runtime_logs",
+            description: "Collect a deployment's runtime log stream for at most waitMs or limit, then stop. Returns level, message, request path, and status per row.",
+            annotations: { readOnlyHint: true },
+            inputSchema: closed({
+                projectId: PROJECT_ID,
+                deploymentId: { type: "string", minLength: 1, description: "Deployment id (dpl_…)." },
+                teamId: TEAM_ID,
+                slug: {
+                    type: "string",
+                    minLength: 1,
+                    description: "Team slug; overrides the routing default when teamId is omitted.",
+                },
+                waitMs: {
+                    type: "integer",
+                    minimum: 1000,
+                    maximum: 20000,
+                    description: "How long to collect the stream; default 5000.",
+                },
+                limit: { type: "integer", minimum: 1, maximum: 1000, description: "Most rows returned; default 200." },
+                levels: {
+                    type: "array",
+                    uniqueItems: true,
+                    items: {
+                        type: "string",
+                        enum: ["debug", "info", "warning", "error", "fatal", "trace"],
+                        description: "A log level to keep.",
+                    },
+                    description: "Keep only these levels.",
+                },
+            }, ["projectId", "deploymentId"]),
+            outputSchema: {
+                type: "object",
+                properties: {
+                    logs: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                timestampInMs: { type: "number" },
+                                level: { type: "string" },
+                                source: { type: "string" },
+                                text: { type: "string" },
+                                requestMethod: { type: "string" },
+                                requestPath: { type: "string" },
+                                responseStatusCode: { type: "number" },
+                                domain: { type: "string" },
+                            },
+                        },
+                    },
+                    truncated: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Dot paths cut for size, including logs[] and logs[].text.",
+                    },
+                    stopped: {
+                        type: "string",
+                        enum: ["end", "time", "bytes", "rows"],
+                        description: "Why collection stopped.",
+                    },
+                },
+                required: ["logs", "stopped"],
+            },
+            run: (args) => Effect.gen(function* () {
+                const call = makeCall("GET", `/v1/projects/${segment(args["projectId"])}/deployments/${segment(args["deploymentId"])}/runtime-logs`, { query: compact({ slug: args["slug"], teamId: args["teamId"] }) });
+                const waitMs = typeof args["waitMs"] === "number" ? args["waitMs"] : 5_000;
+                const maxRows = typeof args["limit"] === "number" ? args["limit"] : 200;
+                const levels = Array.isArray(args["levels"]) ? new Set(args["levels"]) : undefined;
+                const keep = (row) => !levels || levels.has(record(row)["level"]);
+                const { rows, stopped } = yield* boundedRows(call, { waitMs, maxRows, accept: keep });
+                const logs = rows
+                    .map(record)
+                    .filter(keep)
+                    .map((row) => compact({
+                    timestampInMs: row["timestampInMs"],
+                    level: row["level"],
+                    source: row["source"],
+                    ...clamp(row["message"]),
+                    requestMethod: row["requestMethod"],
+                    requestPath: row["requestPath"],
+                    responseStatusCode: row["responseStatusCode"],
+                    domain: row["domain"],
+                }));
+                return {
+                    logs: logs.slice(0, maxRows),
+                    stopped: logs.length > maxRows ? "rows" : stopped,
+                    truncated: [
+                        ...(logs.length > maxRows || stopped === "rows" || stopped === "bytes" ? ["logs[]"] : []),
+                        ...(rows.some((row) => String(record(row)["message"] ?? "").length > MAX_LOG_TEXT)
+                            ? ["logs[].text"]
+                            : []),
+                    ],
+                };
+            }),
+        },
+        {
+            name: "vercel_api_upload",
+            description: "Upload explicit text or base64 bytes to a Vercel octet-stream operation, such as POST /v2/files for deployment files. Reads no local files.",
+            annotations: { readOnlyHint: false, destructiveHint: true },
+            inputSchema: closed({
+                method: { type: "string", enum: ["POST", "PUT"], description: "The operation's HTTP method." },
+                path: {
+                    type: "string",
+                    minLength: 2,
+                    maxLength: 2048,
+                    description: "Concrete path of an octet-stream operation from vercel_api_search, e.g. /v2/files.",
+                },
+                query: { type: "object", description: "Query parameters as JSON, named as vercel_api_details lists them." },
+                contentType: {
+                    type: "string",
+                    minLength: 1,
+                    maxLength: 200,
+                    description: "Content-Type of the bytes; default application/octet-stream.",
+                },
+                textBody: { type: "string", description: "Raw UTF-8 body. Exclusive with base64Body." },
+                base64Body: { type: "string", description: "Base64-encoded bytes. Exclusive with textBody." },
+            }, ["method", "path"]),
+            outputSchema: {
+                type: "object",
+                properties: {
+                    status: { type: "integer", description: "HTTP status." },
+                    data: { description: "Vercel's response body." },
+                    digest: { type: "string", description: "SHA-1 of the bytes, sent as x-vercel-digest for /v2/files." },
+                },
+                required: ["status", "data"],
+            },
+            run: (args) => Effect.gen(function* () {
+                const call = makeCall(args["method"], String(args["path"]), {
+                    query: isRecord(args["query"]) ? args["query"] : {},
+                });
+                const server = checkServer(call.op.server);
+                if (server)
+                    invalid(server);
+                const framing = vercelIndex.bodyType(call.op) ?? "";
+                if (!/octet-stream|^multipart\//.test(framing))
+                    invalid(`${call.method} ${call.op.path} is not an upload; call it with vercel_api_write.`);
+                const refusal = refuse(call);
+                if (refusal)
+                    invalid(refusal);
+                const bytes = decodeUpload(args);
+                yield* admit(call, connection, options);
+                yield* promise(() => refuseWithheldUpload(bytes, "Vercel"));
+                vercelIndex.check(call.op, call.query, String(args["base64Body"] ?? args["textBody"]));
+                const digest = call.op.path === "/v2/files" ? yield* promise(() => sha1(bytes)) : undefined;
+                const answer = yield* connection.sendPath({
+                    method: call.method,
+                    path: call.path,
+                    template: call.op.path,
+                    query: queryPairs(call),
+                    headers: {
+                        "Content-Type": typeof args["contentType"] === "string" ? args["contentType"] : "application/octet-stream",
+                        ...(digest ? { "x-vercel-digest": digest } : {}),
+                    },
+                    rawBody: new Uint8Array(bytes),
+                }, { flags: { upload: true } });
+                return { status: answer.status, data: answer.data ?? null, ...(digest ? { digest } : {}) };
+            }),
+        },
+    ];
+    return [
+        list(connection, {
+            name: "list_teams",
+            description: options.pin
+                ? "Read the deployment's pinned team with its id and slug; returns one terminal item."
+                : "List the teams this token can reach, with ids/slugs for project joins. A configured team is a routing default, not a restriction.",
+            filters: {},
+            row: Schema.Struct({
+                id: Schema.String,
+                slug: Schema.String,
+                name: Schema.NullOr(Schema.String),
+                role: Schema.optionalKey(Schema.String),
+            }),
+            limit: { default: 20, max: 100, description: "Teams per page, default 20, maximum 100." },
+            cursor: "bound",
+            ...(options.pin ? { cursorScope: Object.freeze({ vercelTeamPin: options.pin.teamId }) } : {}),
+            page: (_args, cursor) => Effect.gen(function* () {
+                if (options.pin) {
+                    if (cursor)
+                        invalid("A pinned team list is terminal; omit cursor.");
+                    const team = yield* readPinnedTeam(connection, options.pin);
+                    return {
+                        rows: [
+                            {
+                                id: options.pin.teamId,
+                                slug: team["slug"],
+                                name: text(team["name"]) ?? null,
+                                ...(text(record(team["membership"])["role"])
+                                    ? { role: text(record(team["membership"])["role"]) }
+                                    : {}),
+                            },
+                        ],
+                        page: { hasMore: false, nextCursor: null },
+                    };
+                }
+                const result = yield* send("GET", "/v2/teams", {
+                    query: { limit: _args.limit, ...(cursor ? { until: JSON.parse(cursor) } : {}) },
+                });
+                const body = record(result.data), next = vercelPage.next(body, { path: "/v2/teams", query: {}, headers: {} });
+                const rows = Array.isArray(body["teams"]) ? body["teams"] : [];
+                return {
+                    rows: rows.map((team) => {
+                        const e = record(team);
+                        return {
+                            id: String(e["id"]),
+                            slug: String(e["slug"]),
+                            name: text(e["name"]) ?? null,
+                            ...(text(record(e["membership"])["role"]) ? { role: text(record(e["membership"])["role"]) } : {}),
+                        };
+                    }),
+                    page: {
+                        hasMore: next !== null && next !== undefined,
+                        nextCursor: next === null || next === undefined || typeof next === "object" ? null : JSON.stringify(next),
+                    },
+                };
+            }),
+        }),
+        ...declarations.map((declaration) => {
+            const spec = {
+                writeSteps: PIN_WRITE_STEPS,
+                name: declaration.name,
+                description: declaration.description,
+                input: schema(declaration.inputSchema),
+                output: schema(declaration.outputSchema),
+                run: (args) => declaration
+                    .run(args)
+                    .pipe(Effect.catchDefect((error) => error instanceof ConnectorCallError ? Effect.fail(new Refusal({ error })) : Effect.die(error))),
+            };
+            const tool = declaration.annotations.readOnlyHint
+                ? read(connection, {
+                    ...spec,
+                    ...(declaration.name === "list_project_env_vars" ? {} : { fields: true }),
+                })
+                : write(connection, { ...spec, destructive: true });
+            return tool;
+        }),
+    ];
+}