@zackbart/connecta 0.24.3 → 0.25.0

package/dist/providers/vercel.js

@@ -1,4 +1,14 @@
-/** See documentation/vercel.md#no-sdk-on-purpose. */
+/**
+ * No `@vercel/sdk` on purpose — not a dependency and not an optional peer.
+ * Direct fetch keeps the root Workers-safe, avoids shipping the SDK's generated
+ * model graph, and lets the reviewed named operations and the REST hatches share
+ * one guarded transport. The trade is API drift, handled explicitly rather than
+ * by the SDK's version bumps: `scripts/drift/vercel-endpoints.json` records the
+ * method, versioned path, spec revision, and request/response digest for every
+ * fixed endpoint, and `npm run providers:check -- --provider vercel` compares
+ * those rows with Vercel's published OpenAPI document at
+ * https://openapi.vercel.sh/ without needing a credential.
+ */
 import { api, defined } from "../connectors/api.js";
 import { remoteMcp } from "../connectors/remote-mcp.js";
 import { vettedCatalog, withVettedCatalog } from "../catalog-drift.js";
@@ -128,7 +138,7 @@ function vercelTransport(baseUrl) {
         authenticate: async (ctx) => {
             const token = (await ctx.credential?.get())?.trim();
             if (!token) {
-                throw new ConnectorCallError("auth_required", "No Vercel access token is configured for this connector. An operator must add one on /credentials before any Vercel call can run.");
+                throw new ConnectorCallError("auth_required", "No Vercel access token is configured for this connector. Call authorize_connector for recovery options. When available, an operator can add the token in this connection in the operator UI.");
             }
             return { Authorization: `Bearer ${token}` };
         },

package/dist/registry.d.ts

@@ -58,7 +58,7 @@ export interface RegistryOptions {
     /**
      * Cap on inline result size before truncation + get_result paging. Must be a
      * whole number of bytes >= 1; anything else warns at startup and falls back
-     * to the default 50_000.
+     * to the default 24_000.
      */
     maxResultBytes?: number | undefined;
     results?: {
@@ -107,8 +107,8 @@ export interface RegistryView {
         signal?: AbortSignal;
     }): Promise<CallAdmissionPermit>;
     resultsStorage(): KVStorage;
-    /** Reserve runtime-wide capacity before writing a paging envelope. */
-    stashResult(key: string, value: string, ttlSeconds: number): Promise<boolean>;
+    /** Reserve runtime-wide capacity before writing a paging envelope's chunks. */
+    stashResult(key: string, chunks: readonly string[], ttlSeconds: number): Promise<boolean>;
     /** Local declared-vs-stored credential mismatch, with no downstream I/O. */
     credentialDriftFor(id: string): Promise<string | undefined>;
     /** Value-free shape learned from successful calls, never a provider declaration. */
@@ -240,8 +240,16 @@ export declare class Registry implements RegistryView {
     private observeCatalogDrift;
     /** Reject queued/future downstream admission; active permits release safely. */
     closeCallAdmission(): void;
-    /** Reserve capacity and write one ASCII paging envelope in this runtime. */
-    stashResult(key: string, value: string, ttlSeconds: number, prefix?: string): Promise<boolean>;
+    /**
+     * Reserve capacity and write one ASCII paging envelope in this runtime.
+     *
+     * `chunks[0]` lands on `<prefix><key>` and `chunks[n]` on `<prefix><key>#<n>`
+     * — the layout get_result reads back, so a page fetches only the chunks it
+     * covers instead of the whole stored result (issue #540). Chunking is a
+     * read-cost decision, not a capacity one: however many keys an envelope
+     * occupies, it is one stash entry charged its total ASCII length.
+     */
+    stashResult(key: string, chunks: readonly string[], ttlSeconds: number, prefix?: string): Promise<boolean>;
     /**
      * Storage namespaced to the meta-tool result store (`results:` prefix), kept
      * separate from any connector's `conn:<id>:` namespace. Backs get_result.