@aaronsb/google-workspace-mcp 3.0.0 → 4.0.1

package/build/factory/manifest/tasks.yaml

@@ -1,7 +1,7 @@
 tool_name: manage_tasks
 description: "Manage task lists and tasks in Google Tasks."
 requires_email: true
-gws_service: tasks
+google_service: tasks
 operations:
 
   # --- Task lists ---
@@ -22,10 +22,18 @@ operations:
         required: true
         maps_to: tasklist
 
+  # A TaskList's only meaningful field is its title, and it rides in the BODY —
+  # tasklists.insert declares no parameters. Without it this could only ever create
+  # nameless task lists, and did so without complaint.
   createTaskList:
     type: action
     description: "create a new task list"
     resource: tasklists.insert
+    params:
+      title:
+        type: string
+        description: "Task list name"
+        required: true
 
   deleteTaskList:
     type: action
@@ -75,6 +83,10 @@ operations:
         required: true
         maps_to: task
 
+  # title / notes / due are BODY fields (the Task resource). tasks.insert declares only
+  # `tasklist` (path) and `parent`/`previous` (query), so anything else goes in the body.
+  # Without them, `create` sent an empty Task and produced a BLANK task — no title, no
+  # content, no error. A titleless task is not a degraded task; it is a useless one.
   create:
     type: action
     description: "create a new task"
@@ -85,10 +97,23 @@ operations:
         description: "Task list ID"
         required: true
         maps_to: tasklist
+      title:
+        type: string
+        description: "Task title"
+        required: true
+      notes:
+        type: string
+        description: "Task notes / details"
+      due:
+        type: string
+        description: "Due date (RFC 3339, e.g. 2026-07-20T00:00:00.000Z — Google stores the date, not the time)"
 
+  # An `update` with no updatable fields could only ever PATCH an empty body, which
+  # Google Tasks answers with a 500 "Internal error encountered". So this operation did
+  # not merely fail to update — it failed EVERY time, and blamed Google while doing it.
   update:
     type: action
-    description: "update a task (patch semantics)"
+    description: "update a task (patch semantics — only the fields you pass are changed)"
     resource: tasks.patch
     params:
       taskListId:
@@ -101,6 +126,19 @@ operations:
         description: "Task ID"
         required: true
         maps_to: task
+      title:
+        type: string
+        description: "New task title"
+      notes:
+        type: string
+        description: "New task notes / details"
+      due:
+        type: string
+        description: "New due date (RFC 3339)"
+      status:
+        type: string
+        description: "Task status"
+        enum: [needsAction, completed]
 
   complete:
     type: action

package/build/factory/patches.js

@@ -8,6 +8,7 @@ import { drivePatch } from '../services/drive/patch.js';
 import { docsPatch } from '../services/docs/patch.js';
 import { meetPatch } from '../services/meet/patch.js';
 import { sheetsPatch } from '../services/sheets/patch.js';
+import { tasksPatch } from '../services/tasks/patch.js';
 export const patches = {
     gmail: gmailPatch,
     calendar: calendarPatch,
@@ -15,5 +16,6 @@ export const patches = {
     docs: docsPatch,
     meet: meetPatch,
     sheets: sheetsPatch,
+    tasks: tasksPatch,
 };
 //# sourceMappingURL=patches.js.map

package/build/factory/patches.js.map

@@ -1 +1 @@
-{"version":3,"file":"patches.js","sourceRoot":"","sources":["../../src/factory/patches.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D,MAAM,CAAC,MAAM,OAAO,GAAiC;IACnD,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,aAAa;IACvB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;CACpB,CAAC"}
+{"version":3,"file":"patches.js","sourceRoot":"","sources":["../../src/factory/patches.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAGxD,MAAM,CAAC,MAAM,OAAO,GAAiC;IACnD,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,aAAa;IACvB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,UAAU;CAClB,CAAC"}

package/build/factory/safety.js

@@ -113,7 +113,7 @@ export const auditLog = {
     applies: () => true,
     evaluate: (_args, ctx, service) => {
         if (!isReadOperation(ctx.operation)) {
-            process.stderr.write(`[gws-mcp] AUDIT: ${service}.${ctx.operation} account=${ctx.account} ` +
+            process.stderr.write(`[google-workspace-mcp] AUDIT: ${service}.${ctx.operation} account=${ctx.account} ` +
                 `args=${JSON.stringify(ctx.params)}\n`);
         }
         return { action: 'allow' };
@@ -126,7 +126,7 @@ let activePolicies = [];
 export function configurePolicies(policies) {
     activePolicies = policies;
     if (policies.length > 0) {
-        process.stderr.write(`[gws-mcp] safety: ${policies.length} policy(ies) active: ` +
+        process.stderr.write(`[google-workspace-mcp] safety: ${policies.length} policy(ies) active: ` +
             `${policies.map(p => p.name).join(', ')}\n`);
     }
 }
@@ -144,11 +144,11 @@ export function evaluatePolicies(args, ctx, service) {
             continue;
         const result = policy.evaluate(args, ctx, service);
         if (result.action === 'block') {
-            process.stderr.write(`[gws-mcp] safety: BLOCKED ${service}.${ctx.operation} by ${policy.name}: ${result.reason}\n`);
+            process.stderr.write(`[google-workspace-mcp] safety: BLOCKED ${service}.${ctx.operation} by ${policy.name}: ${result.reason}\n`);
             return result;
         }
         if (result.action === 'downgrade' && result.replacementArgs) {
-            process.stderr.write(`[gws-mcp] safety: DOWNGRADED ${service}.${ctx.operation} by ${policy.name}: ${result.reason}\n`);
+            process.stderr.write(`[google-workspace-mcp] safety: DOWNGRADED ${service}.${ctx.operation} by ${policy.name}: ${result.reason}\n`);
             return result;
         }
     }

package/build/factory/safety.js.map

@@ -1 +1 @@
-{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/factory/safety.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/factory/safety.ts"],"names":[],"mappings":"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"}

package/build/factory/types.d.ts

@@ -10,19 +10,19 @@ export interface ParamDef {
     required?: boolean;
     default?: string | number | boolean;
     max?: number;
-    /** Maps this param name to a different key in the gws --params JSON. */
+    /** Maps this param name to a different key in the params sent to Google. */
     maps_to?: string;
     enum?: string[];
     /**
      * If true, the param is for the formatter/handler only and is NOT forwarded
-     * to the gws CLI. Used for client-side controls like `bodyFormat` (ADR-305)
+     * to Google. Used for client-side controls like `bodyFormat` (ADR-305)
      * that affect rendering, not the API call itself.
      */
     client_only?: boolean;
 }
 /** Hydration config — fetch detail for each item in a list result. */
 export interface HydrationDef {
-    /** gws resource path for the detail call (e.g. "users.messages.get"). */
+    /** Google resource path for the detail call (e.g. "users.messages.get"). */
     resource: string;
     /** Format parameter passed to the detail call. */
     format?: string;
@@ -34,20 +34,16 @@ export interface OperationDef {
     /** Categorizes the operation for default formatting. */
     type: 'list' | 'detail' | 'action';
     description: string;
-    /** gws resource path (e.g. "users.messages.list"). */
+    /** Google resource path (e.g. "users.messages.list"). */
     resource?: string;
-    /** gws helper shorthand (e.g. "+triage", "+send"). */
-    helper?: string;
     /** Named parameters the caller can provide. */
     params?: Record<string, ParamDef>;
-    /** Default values merged into the gws --params JSON. */
+    /** Default values merged into the params sent to Google. */
     defaults?: Record<string, unknown>;
     /** Post-fetch hydration (list operations only). */
     hydration?: HydrationDef;
-    /** Fields to extract from the gws response for the result. */
+    /** Fields to extract from Google's response for the result. */
     fields?: string;
-    /** CLI-style args instead of --params JSON (for helpers). */
-    cli_args?: Record<string, string>;
 }
 /** A service declaration in the manifest. */
 export interface ServiceDef {
@@ -55,8 +51,8 @@ export interface ServiceDef {
     description: string;
     /** Whether this service requires an email account param. */
     requires_email: boolean;
-    /** The gws service name (e.g. "gmail", "calendar", "drive"). */
-    gws_service: string;
+    /** The Google service name (e.g. "gmail", "calendar", "drive"). */
+    google_service: string;
     operations: Record<string, OperationDef>;
 }
 /** Top-level manifest shape. */
@@ -69,9 +65,14 @@ export interface PatchContext {
     params: Record<string, unknown>;
     account: string;
 }
-/** A patch hook that runs after arg construction, before gws execution. */
-export type BeforeExecuteHook = (args: string[], ctx: PatchContext) => Promise<string[]> | string[];
-/** A patch hook that runs after gws returns, before formatting. */
+/**
+ * A patch hook that runs after the manifest's param mapping, before the call.
+ *
+ * It receives the PARAMS Google will be sent. Hooks operate on the param object
+ * directly — never on a serialised command line. See ADR-103.
+ */
+export type BeforeExecuteHook = (params: Record<string, unknown>, ctx: PatchContext) => Promise<Record<string, unknown>> | Record<string, unknown>;
+/** A patch hook that runs after Google returns, before formatting. */
 export type AfterExecuteHook = (result: unknown, ctx: PatchContext) => Promise<unknown> | unknown;
 /** A formatter override for a specific operation type. */
 export type FormatHook = (data: unknown, ctx: PatchContext) => HandlerResponse;

package/build/google/client.d.ts

@@ -0,0 +1,45 @@
+import { type ApiDescriptor } from './descriptor.js';
+import type { GoogleService, ServiceMethods } from './methods.js';
+export interface CallOptions {
+    /** Account email — the token is minted for this identity. */
+    account: string;
+    descriptor?: ApiDescriptor;
+    fetchImpl?: typeof fetch;
+}
+export interface BuiltRequest {
+    url: string;
+    method: string;
+    body?: Record<string, unknown>;
+}
+/** Pure: descriptor + params -> the request. No I/O, so it is testable offline. */
+export declare function buildRequest(descriptor: ApiDescriptor, service: string, resourcePath: string, params?: Record<string, unknown>): BuiltRequest;
+/**
+ * Call a Google API method. Returns RAW Google JSON — no envelope, no reshaping.
+ * Throws GoogleApiError carrying Google's real error body.
+ */
+export declare function call<S extends GoogleService>(service: S, resourcePath: ServiceMethods[S], params: Record<string, unknown>, options: CallOptions): Promise<unknown>;
+/**
+ * Download media to disk.
+ *
+ * STREAMED, deliberately. The bytes go from the socket to the file and are never a
+ * string at all. Never buffer a download through an in-memory string: accumulating
+ * the whole response and JSON.parse-ing it turns a 30 MB attachment into a ~40 MB
+ * string, then an object, then a Buffer — uncapped, for every download.
+ */
+export declare function download<S extends GoogleService>(service: S, resourcePath: ServiceMethods[S], params: Record<string, unknown>, outputPath: string, options: CallOptions): Promise<string>;
+export interface UploadOptions extends CallOptions {
+    media: Buffer;
+    contentType: string;
+    metadata?: Record<string, unknown>;
+    /** Non-final chunks must be a multiple of 256 KiB. */
+    chunkSize?: number;
+}
+/**
+ * Resumable, chunked media upload.
+ *
+ * The descriptor carries the upload paths for both protocols because Discovery
+ * DECLARES them. Verified live (ADR-103 item 4): a 25 MB attachment — 34.2 MB as
+ * RFC822, 93% of Google's declared 36,700,160-byte cap — uploaded in 5 chunks and
+ * read back byte-for-byte identical.
+ */
+export declare function upload<S extends GoogleService>(service: S, resourcePath: ServiceMethods[S], params: Record<string, unknown>, options: UploadOptions): Promise<unknown>;

package/build/google/client.js

@@ -0,0 +1,283 @@
+/**
+ * The Google API client.
+ *
+ * The whole of a resource operation: get a token, make the call, hand back the JSON.
+ *
+ * LOAD-BEARING CONSTRAINT — this layer has NO OPINIONS. It never reshapes, never
+ * "fixes", never fills in. It returns exactly what Google returned. Interpretation
+ * happens ABOVE it, in the layer we already own and aim at the MCP contract
+ * (patches / formatters / next-steps). The moment this file gets helpful, it
+ * becomes something that can be subtly wrong in a way no test catches — the exact
+ * defect class ADR-101 spent six review rounds learning to fear.
+ *
+ * Everything here is a consequence of something the DESCRIPTOR said. Where a rule
+ * looks arbitrary, it is not: it is a fact we learned by being wrong first, live,
+ * against Google (ADR-103, item 2).
+ *
+ * See ADR-103.
+ */
+import { createWriteStream } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { getAccessToken } from '../accounts/token-service.js';
+import { GoogleApiError } from './errors.js';
+import { loadDescriptor } from './descriptor.js';
+function resolve(descriptor, service, resourcePath) {
+    const svc = descriptor.services[service];
+    if (!svc)
+        throw new Error(`descriptor has no service '${service}'`);
+    const method = svc.methods[resourcePath];
+    if (!method)
+        throw new Error(`descriptor has no method '${service}.${resourcePath}'`);
+    return { svc, method };
+}
+/**
+ * Expand a path template.
+ *
+ * `{+var}` is RFC 6570 RESERVED expansion — reserved characters, notably `/`,
+ * must NOT be percent-encoded. Meet's identifiers ARE paths
+ * ("conferenceRecords/abc"), so encoding that slash to %2F 404s every Meet
+ * sub-resource operation. The `+` is the descriptor telling us this. Honour it.
+ */
+function expandPath(template, pathParams) {
+    return template.replace(/\{(\+?)([^}]+)\}/g, (_m, reserved, name) => {
+        if (!(name in pathParams))
+            throw new Error(`missing required path param '${name}'`);
+        const raw = String(pathParams[name]);
+        return reserved
+            ? raw.split('/').map(encodeURIComponent).join('/')
+            : encodeURIComponent(raw);
+    });
+}
+/**
+ * Split params into path / query / body by what the descriptor DECLARES.
+ *
+ * Global parameters (`fields`, `alt`, `quotaUser`, `prettyPrint`) are declared
+ * ONCE at the document root, not per method. A dispatcher that consults only the
+ * method's parameters cannot place `fields`, drops it into the body, and a GET
+ * silently discards it — which is exactly how drive.listComments died with
+ * "The 'fields' parameter is required". Merge both; the method wins on conflict.
+ */
+function splitParams(svc, method, params) {
+    const declared = { ...svc.globalParameters, ...method.parameters };
+    const path = {};
+    const query = {};
+    const body = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        const decl = declared[key];
+        const location = decl?.location;
+        // A REPEATED parameter is sent once per value (`?h=From&h=Subject`), never as one
+        // comma-joined string. Google does not split it for us: asked for the single header
+        // named "From,Subject,Date,To", it finds none and returns a payload with no headers
+        // at all — which rendered a whole mail thread with empty senders and empty subjects,
+        // and raised no error. The descriptor already records which params are repeated, so
+        // accept a comma-separated string and expand it rather than trusting every caller
+        // to remember.
+        const coerced = decl?.repeated && typeof value === 'string'
+            ? value.split(',').map((v) => v.trim()).filter(Boolean)
+            : value;
+        if (location === 'path')
+            path[key] = coerced;
+        else if (location === 'query')
+            query[key] = coerced;
+        else
+            body[key] = coerced; // undeclared -> request body; Google validates it, not us
+    }
+    return { path, query, body };
+}
+function applyQuery(url, query) {
+    for (const [key, value] of Object.entries(query)) {
+        if (Array.isArray(value))
+            value.forEach((v) => url.searchParams.append(key, String(v)));
+        else
+            url.searchParams.set(key, String(value));
+    }
+    return url;
+}
+/** Pure: descriptor + params -> the request. No I/O, so it is testable offline. */
+export function buildRequest(descriptor, service, resourcePath, params = {}) {
+    const { svc, method } = resolve(descriptor, service, resourcePath);
+    const { path, query, body } = splitParams(svc, method, params);
+    const base = svc.rootUrl.replace(/\/$/, '') + '/' + svc.servicePath.replace(/^\//, '');
+    const url = applyQuery(new URL((base.replace(/\/$/, '') + '/' + expandPath(method.path, path)).replace(/\/+$/, '')), query);
+    const hasBody = Object.keys(body).length > 0 && method.httpMethod !== 'GET';
+    return { url: url.toString(), method: method.httpMethod, body: hasBody ? body : undefined };
+}
+function parseJson(text) {
+    if (!text)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return { error: { message: text.slice(0, 300) } };
+    }
+}
+/**
+ * Call a Google API method. Returns RAW Google JSON — no envelope, no reshaping.
+ * Throws GoogleApiError carrying Google's real error body.
+ */
+export async function call(service, resourcePath, params, options) {
+    const descriptor = options.descriptor ?? await loadDescriptor();
+    const doFetch = options.fetchImpl ?? fetch;
+    const request = buildRequest(descriptor, service, resourcePath, params);
+    const token = await getAccessToken(options.account);
+    for (let attempt = 0;; attempt++) {
+        const response = await doFetch(request.url, {
+            method: request.method,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                ...(request.body ? { 'Content-Type': 'application/json' } : {}),
+            },
+            ...(request.body ? { body: JSON.stringify(request.body) } : {}),
+        });
+        const text = await response.text();
+        const json = parseJson(text);
+        if (response.ok)
+            return json;
+        // Google throttles per user, not per process. Two clients on one account — a
+        // desktop app and an editor, say — share the quota, so a burst of reads can be
+        // rejected even though nothing is wrong with the request. That is a TRANSIENT
+        // condition and the documented response to it is to back off and try again:
+        // https://developers.google.com/workspace/gmail/api/guides/handle-errors
+        //
+        // Retrying belongs here rather than in each caller. A caller that must decide
+        // for itself whether a 429 is fatal will get it wrong somewhere, and the way it
+        // gets it wrong is by treating "I could not read this" as "there is nothing to
+        // read" — which is how a rate-limited inbox rendered as rows with no sender and
+        // no subject.
+        if (shouldRetry(response.status) && attempt < RETRY_ATTEMPTS) {
+            await sleep(retryDelayMs(attempt, response.headers.get('retry-after')));
+            continue;
+        }
+        throw new GoogleApiError(response.status, json, {
+            url: request.url,
+            method: request.method,
+        });
+    }
+}
+/** 429 = rate limited. 5xx = Google having a moment. Both are worth another go. */
+const RETRY_ATTEMPTS = 4;
+function shouldRetry(status) {
+    return status === 429 || status === 500 || status === 502 || status === 503 || status === 504;
+}
+/**
+ * Exponential backoff with full jitter. The jitter is not decoration: without it, a
+ * batch of calls throttled together retries together, re-creating the burst that
+ * caused the throttling.
+ *
+ * `Retry-After` wins when Google sends one — it is Google telling us what it wants.
+ */
+function retryDelayMs(attempt, retryAfter) {
+    if (retryAfter) {
+        const seconds = Number(retryAfter);
+        if (Number.isFinite(seconds) && seconds >= 0)
+            return Math.min(seconds * 1000, 30_000);
+    }
+    const ceiling = Math.min(1000 * 2 ** attempt, 16_000);
+    return Math.random() * ceiling;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Download media to disk.
+ *
+ * STREAMED, deliberately. The bytes go from the socket to the file and are never a
+ * string at all. Never buffer a download through an in-memory string: accumulating
+ * the whole response and JSON.parse-ing it turns a 30 MB attachment into a ~40 MB
+ * string, then an object, then a Buffer — uncapped, for every download.
+ */
+export async function download(service, resourcePath, params, outputPath, options) {
+    const descriptor = options.descriptor ?? await loadDescriptor();
+    const doFetch = options.fetchImpl ?? fetch;
+    const request = buildRequest(descriptor, service, resourcePath, params);
+    const token = await getAccessToken(options.account);
+    const response = await doFetch(request.url, {
+        method: request.method,
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!response.ok) {
+        const json = parseJson(await response.text());
+        throw new GoogleApiError(response.status, json, {
+            url: request.url,
+            method: request.method,
+        });
+    }
+    if (!response.body)
+        throw new Error(`no response body for ${service}.${resourcePath}`);
+    await mkdir(dirname(outputPath), { recursive: true });
+    await pipeline(Readable.fromWeb(response.body), createWriteStream(outputPath));
+    return outputPath;
+}
+/**
+ * Resumable, chunked media upload.
+ *
+ * The descriptor carries the upload paths for both protocols because Discovery
+ * DECLARES them. Verified live (ADR-103 item 4): a 25 MB attachment — 34.2 MB as
+ * RFC822, 93% of Google's declared 36,700,160-byte cap — uploaded in 5 chunks and
+ * read back byte-for-byte identical.
+ */
+export async function upload(service, resourcePath, params, options) {
+    const descriptor = options.descriptor ?? await loadDescriptor();
+    const doFetch = options.fetchImpl ?? fetch;
+    const { svc, method } = resolve(descriptor, service, resourcePath);
+    if (!method.mediaUpload)
+        throw new Error(`${service}.${resourcePath} does not support media upload`);
+    // Google DECLARES the ceiling. Refusing locally beats a confusing 400 from a
+    // 35 MB request that already crossed the wire.
+    const max = Number(method.mediaUpload.maxSize);
+    if (max && options.media.length > max) {
+        throw new Error(`${service}.${resourcePath}: payload is ${options.media.length} bytes; ` +
+            `Google's declared limit is ${max} bytes`);
+    }
+    const token = await getAccessToken(options.account);
+    const { path, query } = splitParams(svc, method, params);
+    const uploadPath = method.mediaUpload.resumable ?? method.mediaUpload.simple;
+    if (!uploadPath)
+        throw new Error(`${service}.${resourcePath} declares no upload protocol`);
+    const initiateUrl = applyQuery(new URL(expandPath(uploadPath, path), svc.rootUrl), { ...query, uploadType: 'resumable' }).toString();
+    const initiate = await doFetch(initiateUrl, {
+        method: method.httpMethod,
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json; charset=UTF-8',
+            'X-Upload-Content-Type': options.contentType,
+            'X-Upload-Content-Length': String(options.media.length),
+        },
+        body: JSON.stringify(options.metadata ?? {}),
+    });
+    if (!initiate.ok) {
+        const json = parseJson(await initiate.text());
+        throw new GoogleApiError(initiate.status, json, { url: initiateUrl, method: method.httpMethod });
+    }
+    const session = initiate.headers.get('location');
+    if (!session)
+        throw new Error('resumable upload: initiate returned no Location header');
+    const chunkSize = options.chunkSize ?? 8 * 1024 * 1024;
+    let offset = 0;
+    while (offset < options.media.length) {
+        const end = Math.min(offset + chunkSize, options.media.length);
+        const response = await doFetch(session, {
+            method: 'PUT',
+            headers: { 'Content-Range': `bytes ${offset}-${end - 1}/${options.media.length}` },
+            body: options.media.subarray(offset, end),
+        });
+        // 308 "Resume Incomplete" is the protocol working, not an error.
+        if (response.status === 308) {
+            offset = end;
+            continue;
+        }
+        const text = await response.text();
+        if (!response.ok) {
+            throw new GoogleApiError(response.status, parseJson(text), { url: session, method: 'PUT' });
+        }
+        return parseJson(text);
+    }
+    throw new Error('resumable upload: media consumed without a terminal response');
+}
+//# sourceMappingURL=client.js.map

package/build/google/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/google/client.ts"],"names":[],"mappings":"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"}

package/build/google/descriptor.d.ts

@@ -0,0 +1,40 @@
+export interface ApiParam {
+    location: 'path' | 'query';
+    required?: boolean;
+    repeated?: boolean;
+}
+export interface ApiMediaUpload {
+    maxSize?: string;
+    accept?: string[];
+    simple?: string;
+    resumable?: string;
+}
+export interface ApiMethod {
+    path: string;
+    httpMethod: string;
+    parameters: Record<string, ApiParam>;
+    scopes?: string[];
+    supportsMediaDownload?: boolean;
+    mediaUpload?: ApiMediaUpload;
+}
+export interface ApiService {
+    version: string;
+    rootUrl: string;
+    servicePath: string;
+    discoveryUrl: string;
+    /** `fields`, `alt`, `quotaUser`… declared once at the document root, not per method. */
+    globalParameters: Record<string, ApiParam>;
+    methods: Record<string, ApiMethod>;
+}
+export interface ApiDescriptor {
+    generatedFrom: string;
+    services: Record<string, ApiService>;
+}
+/**
+ * Load the descriptor. Resolved as a sibling of this module, which makes it work
+ * under `src/` (vitest) and under `build/` (the shipped server) alike — the same
+ * trick `loadManifest()` uses, and the reason `npx` works.
+ */
+export declare function loadDescriptor(): Promise<ApiDescriptor>;
+/** Tests only: drop the memoised descriptor. */
+export declare function resetDescriptorCache(): void;

package/build/google/descriptor.js

@@ -0,0 +1,37 @@
+/**
+ * The API descriptor: a generated, committed transcription of Google's Discovery
+ * documents, pruned to what making a REQUEST needs.
+ *
+ * Generated at BUILD time by `scripts/generate-descriptor.mjs` and committed, so
+ * there is no network dependency at startup and nothing breaks offline. Drift is a
+ * CI check, not a production surprise.
+ *
+ * It records what Discovery says about how to CALL Google. It records nothing
+ * about what a RESPONSE means — Discovery's `schemas` block (~90% of the raw
+ * document) is deliberately DISCARDED. A descriptor that knows response shapes is
+ * a descriptor that can start helpfully reshaping them.
+ *
+ * See ADR-103.
+ */
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+let cached;
+/**
+ * Load the descriptor. Resolved as a sibling of this module, which makes it work
+ * under `src/` (vitest) and under `build/` (the shipped server) alike — the same
+ * trick `loadManifest()` uses, and the reason `npx` works.
+ */
+export async function loadDescriptor() {
+    if (cached)
+        return cached;
+    const here = dirname(fileURLToPath(import.meta.url));
+    const raw = await readFile(resolve(here, 'descriptor.json'), 'utf-8');
+    cached = JSON.parse(raw);
+    return cached;
+}
+/** Tests only: drop the memoised descriptor. */
+export function resetDescriptorCache() {
+    cached = undefined;
+}
+//# sourceMappingURL=descriptor.js.map