primitive-admin 1.1.0-alpha.74 → 1.1.0-alpha.76

package/dist/src/lib/generated-sdk-types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * GENERATED FILE — DO NOT EDIT BY HAND.
+ *
+ * Vendored from `packages/primitive-functions/index.d.ts` by
+ * `cli/scripts/gen-sdk-types.mjs` (runs at CLI prebuild). `config push`
+ * writes this text into the config tree's `functions/` directory so an
+ * author's editor and `tsc` can resolve the `primitive-functions` specifier.
+ *
+ * Regenerate with:
+ *   node cli/scripts/gen-sdk-types.mjs
+ */
+export declare const SDK_TYPES_SOURCE = "// GENERATED by scripts/generate-function-profile.mjs from openapi.json.\n// DO NOT EDIT. Run `pnpm functions:profile` and commit the result; the\n// freshness guard in tests/api/spec/function-profile.test.ts fails when this\n// file and a fresh generation diverge.\n\n/**\n * Type surface of `primitive-functions` \u2014 what a server function's author writes\n * against (#3180). The published package's RUNTIME is a stub that throws from\n * every export on purpose: the platform substitutes its own copy at invoke\n * time, and reaching the stub means it did not.\n */\n\n/**\n * The signed-in user who invoked the function over HTTP.\n *\n * Attribution, never authority (#3279): function code acts as the system\n * whoever called it, so this says WHO asked, and the rows the function writes\n * are attributed to them. A trigger fire has no caller and `ctx.user` is\n * null.\n */\nexport interface FunctionUser {\n  userId: string;\n  email: string | null;\n}\n\n/** What started this invocation. */\nexport type FunctionTrigger =\n  | { kind: \"http\" }\n  | { kind: \"webhook\"; [key: string]: unknown }\n  | { kind: \"cron\"; [key: string]: unknown }\n  | { kind: \"database\"; databaseId: string; databaseType: string; [key: string]: unknown }\n  /**\n   * A DSL workflow's `workflow.call` step reached this function (#3288).\n   *\n   * TRANSITIONAL: the bridge exists so a workflow tree can migrate leaf-first\n   * during the transition, and it retires with the workflow engine in phase 7,\n   * taking this variant with it. `workflowKey` names the PARENT workflow, and\n   * `runId`/`stepId` locate the step inside its run.\n   */\n  | { kind: \"workflow\"; workflowKey: string; runId: string; stepId: string };\n\n/** The result shape of an operation that answers in response headers. */\nexport interface HeaderResult {\n  status: number;\n  headers: Record<string, string>;\n}\n\n/**\n * A platform call that was refused. `errorCode` carries the gateway's own\n * codes (`FUNCTION_ROUTE_NOT_ALLOWED`, `FUNCTION_EGRESS_DENIED`, \u2026) as well\n * as the route's.\n */\nexport interface PrimitivePlatformError extends Error {\n  status: number;\n  errorCode: string | null;\n}\n\n/**\n * The typed HTTP profile, generated from the platform's OpenAPI document. Its\n * namespaces mirror the operation ids: analytics, blobBuckets, channels, collections, configVars, connections, databaseTypeConfigs, databases, documents, email, functions, gemini, groups, integrations, iterations, llm, locks, notifications, prompts, resourceMetadata, secrets, users.\n * Methods take one options object carrying the operation's path parameters,\n * query parameters, request headers (under their wire names) and `body`.\n *\n * Generated from the same operations as the runtime profile, so a method that\n * type-checks is a method the platform publishes \u2014 and a missing path\n * parameter or a missing required header is a compile error rather than a\n * `TypeError` at invoke time. Every call runs with the app's own SYSTEM\n * authority (#3279): the invocation gate was the authorization. The three\n * namespaces the gateway does not admit (`functions`, `iterations`,\n * `databaseTypeConfigs`) are still declared: they exist, they answer the\n * gateway's structured denial, and hiding them would make a route's\n * availability look like a typo.\n */\nexport interface FunctionApi {\n  \"analytics\": {\n    /** `analytics.cohortRetention` \u2014 GET /analytics/cohort-retention. Cohort retention metrics */\n    \"cohortRetention\"(args?: {\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.dailyActive` \u2014 GET /analytics/daily-active. Daily active user time series */\n    \"dailyActive\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.errorGroups` \u2014 GET /analytics/errors/groups. Group failure events by fingerprint with per-day count buckets */\n    \"errorGroups\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n      \"filter\"?: Record<string, Record<string, string | number | boolean | Array<string | number | boolean>>>;\n    }): Promise<any>;\n    /** `analytics.integrationUsage` \u2014 GET /analytics/integrations. Integration usage metrics */\n    \"integrationUsage\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.listEvents` \u2014 GET /analytics/events. List analytics events */\n    \"listEvents\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"page\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n      \"filter\"?: Record<string, Record<string, string | number | boolean | Array<string | number | boolean>>>;\n    }): Promise<any>;\n    /** `analytics.listEventsGrouped` \u2014 GET /analytics/events/grouped. List analytics events grouped by dimension */\n    \"listEventsGrouped\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"groupBy\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n      \"filter\"?: Record<string, Record<string, string | number | boolean | Array<string | number | boolean>>>;\n    }): Promise<any>;\n    /** `analytics.overviewDau` \u2014 GET /analytics/overview/dau. Daily active users overview */\n    \"overviewDau\"(args?: {\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.overviewGrowth` \u2014 GET /analytics/overview/growth. User growth overview */\n    \"overviewGrowth\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.overviewMau` \u2014 GET /analytics/overview/mau. Monthly active users overview */\n    \"overviewMau\"(args?: {\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.overviewWau` \u2014 GET /analytics/overview/wau. Weekly active users overview */\n    \"overviewWau\"(args?: {\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.rollingActive` \u2014 GET /analytics/rolling-active. Rolling active user time series */\n    \"rollingActive\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.searchUsers` \u2014 GET /analytics/users/search. Search app users for analytics */\n    \"searchUsers\"(args?: {\n      \"q\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.topPrompts` \u2014 GET /analytics/prompts/top. List the most-executed prompts */\n    \"topPrompts\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.topUsers` \u2014 GET /analytics/users/top. List the most active users */\n    \"topUsers\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.topWorkflows` \u2014 GET /analytics/workflows/top. List the most-run workflows */\n    \"topWorkflows\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.userDetail` \u2014 GET /analytics/users/{userUlid}/detail. Detailed analytics for a single user */\n    \"userDetail\"(args: {\n      \"userUlid\": string | number;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.userSnapshot` \u2014 GET /analytics/users/{userUlid}/snapshot. Activity snapshot for a single user */\n    \"userSnapshot\"(args: {\n      \"userUlid\": string | number;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.writeForUser` \u2014 POST /analytics/write-for-user. Write an analytics event for a subject user under a grant */\n    \"writeForUser\"(args: {\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"blobBuckets\": {\n    /** `blobBuckets.createBucket` \u2014 POST /blob-buckets. Create a blob bucket */\n    \"createBucket\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `blobBuckets.delete` \u2014 DELETE /blob-buckets/{bucketId}/blobs/{blobId}. Delete a blob */\n    \"delete\"(args: {\n      \"bucketId\": string | number;\n      \"blobId\": string | number;\n    }): Promise<any>;\n    /** `blobBuckets.deleteBatch` \u2014 POST /blob-buckets/{bucketId}/blobs/delete. Batch delete blobs from a bucket */\n    \"deleteBatch\"(args: {\n      \"bucketId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `blobBuckets.deleteBucket` \u2014 DELETE /blob-buckets/{bucketId}. Delete a blob bucket */\n    \"deleteBucket\"(args: {\n      \"bucketId\": string | number;\n    }): Promise<any>;\n    /** `blobBuckets.download` \u2014 GET /blob-buckets/{bucketId}/blobs/{blobId}. Download a blob (anonymous allowed for public buckets) */\n    \"download\"(args: {\n      \"bucketId\": string | number;\n      \"blobId\": string | number;\n      \"disposition\"?: string | number | boolean;\n    }): Promise<Uint8Array>;\n    /** `blobBuckets.downloadSigned` \u2014 GET /blob-buckets/{bucketId}/blobs/{blobId}/signed. Download a blob via a signed URL token */\n    \"downloadSigned\"(args: {\n      \"bucketId\": string | number;\n      \"blobId\": string | number;\n      \"token\"?: string | number | boolean;\n    }): Promise<Uint8Array>;\n    /** `blobBuckets.getBucket` \u2014 GET /blob-buckets/{bucketId}. Get a blob bucket by id */\n    \"getBucket\"(args: {\n      \"bucketId\": string | number;\n    }): Promise<any>;\n    /** `blobBuckets.getMetadata` \u2014 GET /blob-buckets/{bucketId}/blobs/{blobId}/metadata. Get blob metadata (anonymous allowed for public buckets) */\n    \"getMetadata\"(args: {\n      \"bucketId\": string | number;\n      \"blobId\": string | number;\n    }): Promise<any>;\n    /** `blobBuckets.getSignedUrl` \u2014 POST /blob-buckets/{bucketId}/blobs/{blobId}/signed-url. Create a signed download URL for a blob */\n    \"getSignedUrl\"(args: {\n      \"bucketId\": string | number;\n      \"blobId\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `blobBuckets.list` \u2014 GET /blob-buckets/{bucketId}/blobs. List blobs in a bucket (anonymous allowed for public buckets) */\n    \"list\"(args: {\n      \"bucketId\": string | number;\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `blobBuckets.listBuckets` \u2014 GET /blob-buckets. List blob buckets */\n    \"listBuckets\"(args?: Record<string, never>): Promise<any>;\n    /** `blobBuckets.updateBucket` \u2014 PATCH /blob-buckets/{bucketId}. Update a blob bucket */\n    \"updateBucket\"(args: {\n      \"bucketId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `blobBuckets.upload` \u2014 POST /blob-buckets/{bucketId}/blobs. Upload a blob to a bucket */\n    \"upload\"(args: {\n      \"bucketId\": string | number;\n      \"X-Blob-Filename\": string | number;\n      \"X-Blob-Tags\"?: string | number;\n      \"Content-Type\"?: string | number;\n      body: ArrayBuffer | Uint8Array | string;\n    }): Promise<any>;\n  };\n  \"channels\": {\n    /** `channels.authorize` \u2014 POST /channels/{channel}/grants. Issue a channel grant under a server function's grant */\n    \"authorize\"(args: {\n      \"channel\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `channels.publish` \u2014 POST /channels/{channel}/publish. Publish a message to a channel under a server function's grant */\n    \"publish\"(args: {\n      \"channel\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"collections\": {\n    /** `collections.addDocument` \u2014 POST /collections/{collectionId}/documents. Add a document to a collection */\n    \"addDocument\"(args: {\n      \"collectionId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `collections.addMember` \u2014 POST /collections/{collectionId}/members. Add a member to a collection */\n    \"addMember\"(args: {\n      \"collectionId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `collections.create` \u2014 POST /collections. Create a collection */\n    \"create\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `collections.delete` \u2014 DELETE /collections/{collectionId}. Delete a collection */\n    \"delete\"(args: {\n      \"collectionId\": string | number;\n    }): Promise<any>;\n    /** `collections.get` \u2014 GET /collections/{collectionId}. Get a collection by id */\n    \"get\"(args: {\n      \"collectionId\": string | number;\n    }): Promise<any>;\n    /** `collections.getAccess` \u2014 GET /collections/{collectionId}/access. Get a collection's access summary */\n    \"getAccess\"(args: {\n      \"collectionId\": string | number;\n    }): Promise<any>;\n    /** `collections.grantGroupPermission` \u2014 POST /collections/{collectionId}/group-permissions. Grant a group permission on a collection */\n    \"grantGroupPermission\"(args: {\n      \"collectionId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `collections.list` \u2014 GET /collections. List collections */\n    \"list\"(args?: {\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `collections.listCollectionsForDocument` \u2014 GET /documents/{documentId}/collections. List collections a document belongs to (reverse lookup) */\n    \"listCollectionsForDocument\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `collections.listDocuments` \u2014 GET /collections/{collectionId}/documents. List documents in a collection */\n    \"listDocuments\"(args: {\n      \"collectionId\": string | number;\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `collections.listPendingInvitations` \u2014 GET /collections/{collectionId}/pending-invitations. List a collection's pending invitations */\n    \"listPendingInvitations\"(args: {\n      \"collectionId\": string | number;\n    }): Promise<any>;\n    /** `collections.removeDocument` \u2014 DELETE /collections/{collectionId}/documents/{documentId}. Remove a document from a collection */\n    \"removeDocument\"(args: {\n      \"collectionId\": string | number;\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `collections.removeMember` \u2014 DELETE /collections/{collectionId}/members/{userId}. Remove a member from a collection */\n    \"removeMember\"(args: {\n      \"collectionId\": string | number;\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `collections.revokeGroupPermission` \u2014 DELETE /collections/{collectionId}/group-permissions/{groupType}/{groupId}. Revoke a group permission on a collection */\n    \"revokeGroupPermission\"(args: {\n      \"collectionId\": string | number;\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `collections.update` \u2014 PATCH /collections/{collectionId}. Update a collection */\n    \"update\"(args: {\n      \"collectionId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"configVars\": {\n    /** `configVars.get` \u2014 GET /config-vars/{name}. Read an app config var under a server function's grants */\n    \"get\"(args: {\n      \"name\": string | number;\n    }): Promise<any>;\n  };\n  \"connections\": {\n    /** `connections.send` \u2014 POST /connections/{connectionId}/send. Send a realtime message to one connection of this app */\n    \"send\"(args: {\n      \"connectionId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"databaseTypeConfigs\": {\n    /** `databaseTypeConfigs.create` \u2014 POST /databases/types. Create a database type */\n    \"create\"(args: {\n      \"dryRun\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.createOperation` \u2014 POST /databases/types/{databaseType}/operations. Create an operation for a database type */\n    \"createOperation\"(args: {\n      \"databaseType\": string | number;\n      \"dryRun\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.delete` \u2014 DELETE /databases/types/{databaseType}. Delete a database type */\n    \"delete\"(args: {\n      \"databaseType\": string | number;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.deleteOperation` \u2014 DELETE /databases/types/{databaseType}/operations/{name}. Delete an operation for a database type */\n    \"deleteOperation\"(args: {\n      \"databaseType\": string | number;\n      \"name\": string | number;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.get` \u2014 GET /databases/types/{databaseType}. Get a database type */\n    \"get\"(args: {\n      \"databaseType\": string | number;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.getOperation` \u2014 GET /databases/types/{databaseType}/operations/{name}. Get an operation for a database type */\n    \"getOperation\"(args: {\n      \"databaseType\": string | number;\n      \"name\": string | number;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.getReindexStatus` \u2014 GET /databases/types/{databaseType}/reindex-status. Status of the index back-provision fan-out for a type */\n    \"getReindexStatus\"(args: {\n      \"databaseType\": string | number;\n      \"runId\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.list` \u2014 GET /databases/types. List database types */\n    \"list\"(args?: Record<string, never>): Promise<any>;\n    /** `databaseTypeConfigs.listOperations` \u2014 GET /databases/types/{databaseType}/operations. List operations for a database type */\n    \"listOperations\"(args: {\n      \"databaseType\": string | number;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.scaffoldSchema` \u2014 POST /databases/types/{databaseType}/schema:scaffold. Scaffold a starter schema for a database type */\n    \"scaffoldSchema\"(args: {\n      \"databaseType\": string | number;\n    }): Promise<any>;\n    \"subscriptions\": {\n      /** `databaseTypeConfigs.subscriptions.create` \u2014 POST /databases/types/{databaseType}/subscriptions. Create a subscription for a database type */\n      \"create\"(args: {\n        \"databaseType\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databaseTypeConfigs.subscriptions.delete` \u2014 DELETE /databases/types/{databaseType}/subscriptions/{subscriptionKey}. Delete a database type subscription */\n      \"delete\"(args: {\n        \"databaseType\": string | number;\n        \"subscriptionKey\": string | number;\n      }): Promise<any>;\n      /** `databaseTypeConfigs.subscriptions.get` \u2014 GET /databases/types/{databaseType}/subscriptions/{subscriptionKey}. Get a database type subscription */\n      \"get\"(args: {\n        \"databaseType\": string | number;\n        \"subscriptionKey\": string | number;\n      }): Promise<any>;\n      /** `databaseTypeConfigs.subscriptions.list` \u2014 GET /databases/types/{databaseType}/subscriptions. List subscriptions for a database type */\n      \"list\"(args: {\n        \"databaseType\": string | number;\n      }): Promise<any>;\n      /** `databaseTypeConfigs.subscriptions.update` \u2014 PUT /databases/types/{databaseType}/subscriptions/{subscriptionKey}. Update a database type subscription */\n      \"update\"(args: {\n        \"databaseType\": string | number;\n        \"subscriptionKey\": string | number;\n        body: unknown;\n      }): Promise<any>;\n    };\n    /** `databaseTypeConfigs.update` \u2014 PATCH /databases/types/{databaseType}. Update a database type */\n    \"update\"(args: {\n      \"databaseType\": string | number;\n      \"dryRun\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.updateOperation` \u2014 PATCH /databases/types/{databaseType}/operations/{name}. Update an operation for a database type */\n    \"updateOperation\"(args: {\n      \"databaseType\": string | number;\n      \"name\": string | number;\n      \"dryRun\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"databases\": {\n    /** `databases.addManager` \u2014 PUT /databases/{databaseId}/permissions. Set a user's database permission */\n    \"addManager\"(args: {\n      \"databaseId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    \"adminData\": {\n      /** `databases.adminData.batch` \u2014 POST /databases/{databaseId}/admin-data/batch. DEPRECATED \u2014 direct database batch; use databases/{databaseId}/records/batch */\n      \"batch\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.adminData.count` \u2014 POST /databases/{databaseId}/admin-data/count. DEPRECATED \u2014 direct database count; use databases/{databaseId}/records/count */\n      \"count\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.adminData.delete` \u2014 POST /databases/{databaseId}/admin-data/delete. DEPRECATED \u2014 direct database delete; use databases/{databaseId}/records/delete */\n      \"delete\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.adminData.patch` \u2014 POST /databases/{databaseId}/admin-data/patch. DEPRECATED \u2014 direct database patch; use databases/{databaseId}/records/patch */\n      \"patch\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.adminData.query` \u2014 POST /databases/{databaseId}/admin-data/query. DEPRECATED \u2014 direct database query; use databases/{databaseId}/records/query */\n      \"query\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.adminData.save` \u2014 POST /databases/{databaseId}/admin-data/save. DEPRECATED \u2014 direct database save; use databases/{databaseId}/records/save */\n      \"save\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n    };\n    /** `databases.create` \u2014 POST /databases. Create a database */\n    \"create\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.delete` \u2014 DELETE /databases/{databaseId}. Delete a database */\n    \"delete\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.executeBatch` \u2014 POST /databases/{databaseId}/operations/{name}/batch. Execute a database operation in batch */\n    \"executeBatch\"(args: {\n      \"databaseId\": string | number;\n      \"name\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.executeOperation` \u2014 POST /databases/{databaseId}/operations/{name}/execute. Execute a database operation */\n    \"executeOperation\"(args: {\n      \"databaseId\": string | number;\n      \"name\": string | number;\n      \"dryRun\"?: string | number | boolean;\n      body?: unknown;\n    }): Promise<any>;\n    /** `databases.get` \u2014 GET /databases/{databaseId}. Get a database by id */\n    \"get\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.getMetadata` \u2014 GET /databases/{databaseId}/metadata. Get database metadata */\n    \"getMetadata\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.grantGroupPermission` \u2014 POST /databases/{databaseId}/group-permissions. Grant a group permission on a database */\n    \"grantGroupPermission\"(args: {\n      \"databaseId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.importBulk` \u2014 POST /databases/{databaseId}/operations/{name}/import-bulk. Bulk-import records via a database operation */\n    \"importBulk\"(args: {\n      \"databaseId\": string | number;\n      \"name\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.list` \u2014 GET /databases. List databases */\n    \"list\"(args?: Record<string, never>): Promise<any>;\n    /** `databases.listGroupPermissions` \u2014 GET /databases/{databaseId}/group-permissions. List a database's group permissions */\n    \"listGroupPermissions\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.listOperations` \u2014 GET /databases/{databaseId}/operations. List operations runnable on a database */\n    \"listOperations\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.listPermissions` \u2014 GET /databases/{databaseId}/permissions. List a database's user permissions */\n    \"listPermissions\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    \"records\": {\n      /** `databases.records.addToSet` \u2014 POST /databases/{databaseId}/records/stringset/add. Database records: stringset/add (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"addToSet\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.aggregate` \u2014 POST /databases/{databaseId}/records/aggregate. Database records: aggregate (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"aggregate\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.batch` \u2014 POST /databases/{databaseId}/records/batch. Database records: batch (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"batch\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.count` \u2014 POST /databases/{databaseId}/records/count. Database records: count (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"count\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.delete` \u2014 POST /databases/{databaseId}/records/delete. Database records: delete (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"delete\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.describe` \u2014 GET /databases/{databaseId}/records/describe. Database records: describe (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"describe\"(args: {\n        \"databaseId\": string | number;\n        \"modelName\"?: string | number | boolean;\n      }): Promise<any>;\n      /** `databases.records.dropIndex` \u2014 POST /databases/{databaseId}/records/index/drop. Database records: index/drop (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"dropIndex\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.dropUniqueConstraint` \u2014 POST /databases/{databaseId}/records/unique-constraint/drop. Database records: unique-constraint/drop (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"dropUniqueConstraint\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.increment` \u2014 POST /databases/{databaseId}/records/increment. Database records: increment (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"increment\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.listIndexes` \u2014 GET /databases/{databaseId}/records/indexes. Database records: indexes (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"listIndexes\"(args: {\n        \"databaseId\": string | number;\n        \"modelName\"?: string | number | boolean;\n      }): Promise<any>;\n      /** `databases.records.listUniqueConstraints` \u2014 GET /databases/{databaseId}/records/unique-constraints. Database records: unique-constraints (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"listUniqueConstraints\"(args: {\n        \"databaseId\": string | number;\n        \"modelName\"?: string | number | boolean;\n      }): Promise<any>;\n      /** `databases.records.models` \u2014 GET /databases/{databaseId}/records/models. Database records: models (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"models\"(args: {\n        \"databaseId\": string | number;\n        \"modelName\"?: string | number | boolean;\n      }): Promise<any>;\n      /** `databases.records.patch` \u2014 POST /databases/{databaseId}/records/patch. Database records: patch (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"patch\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.query` \u2014 POST /databases/{databaseId}/records/query. Database records: query (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"query\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.registerIndex` \u2014 POST /databases/{databaseId}/records/index/register. Database records: index/register (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"registerIndex\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.registerUniqueConstraint` \u2014 POST /databases/{databaseId}/records/unique-constraint/register. Database records: unique-constraint/register (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"registerUniqueConstraint\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.removeFromSet` \u2014 POST /databases/{databaseId}/records/stringset/remove. Database records: stringset/remove (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"removeFromSet\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.save` \u2014 POST /databases/{databaseId}/records/save. Database records: save (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"save\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.syncIndexes` \u2014 POST /databases/{databaseId}/records/indexes/sync. Database records: indexes/sync (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"syncIndexes\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n    };\n    /** `databases.reindex` \u2014 POST /databases/{databaseId}/reindex. Reindex a database */\n    \"reindex\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.revokeGroupPermission` \u2014 DELETE /databases/{databaseId}/group-permissions/{groupType}/{groupId}. Revoke a group permission on a database */\n    \"revokeGroupPermission\"(args: {\n      \"databaseId\": string | number;\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `databases.revokePermission` \u2014 DELETE /databases/{databaseId}/permissions/{userId}. Remove a user's database permission */\n    \"revokePermission\"(args: {\n      \"databaseId\": string | number;\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `databases.runOperation` \u2014 POST /databases/{databaseId}/operations/{name}/run. Run a database operation under a server function's grants */\n    \"runOperation\"(args: {\n      \"databaseId\": string | number;\n      \"name\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `databases.transferOwnership` \u2014 POST /databases/{databaseId}/permissions/transfer. Transfer database ownership */\n    \"transferOwnership\"(args: {\n      \"databaseId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.update` \u2014 PATCH /databases/{databaseId}. Update a database */\n    \"update\"(args: {\n      \"databaseId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.updateMetadata` \u2014 PATCH /databases/{databaseId}/metadata. Update database metadata */\n    \"updateMetadata\"(args: {\n      \"databaseId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"documents\": {\n    /** `documents.addTag` \u2014 POST /documents/{documentId}/tags. Add a tag to a document */\n    \"addTag\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    \"aliases\": {\n      /** `documents.aliases.delete` \u2014 DELETE /document-aliases/{scope}/{aliasKey}. Delete a (scope, aliasKey) document alias binding */\n      \"delete\"(args: {\n        \"scope\": string | number;\n        \"aliasKey\": string | number;\n      }): Promise<any>;\n      /** `documents.aliases.listForDocument` \u2014 GET /documents/{documentId}/aliases. List aliases bound to a document */\n      \"listForDocument\"(args: {\n        \"documentId\": string | number;\n      }): Promise<any>;\n      /** `documents.aliases.resolve` \u2014 GET /document-aliases/{scope}/{aliasKey}. Resolve the document bound to a (scope, aliasKey) alias */\n      \"resolve\"(args: {\n        \"scope\": string | number;\n        \"aliasKey\": string | number;\n      }): Promise<any>;\n      /** `documents.aliases.set` \u2014 PUT /document-aliases/{scope}/{aliasKey}. Bind a (scope, aliasKey) alias to a document */\n      \"set\"(args: {\n        \"scope\": string | number;\n        \"aliasKey\": string | number;\n        body: unknown;\n      }): Promise<any>;\n    };\n    /** `documents.approveAccessRequest` \u2014 POST /documents/{documentId}/access-requests/{requestId}/approve. Approve a document access request */\n    \"approveAccessRequest\"(args: {\n      \"documentId\": string | number;\n      \"requestId\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    \"blobs\": {\n      /** `documents.blobs.delete` \u2014 DELETE /documents/{documentId}/blobs/{blobId}. Delete a document blob */\n      \"delete\"(args: {\n        \"documentId\": string | number;\n        \"blobId\": string | number;\n      }): Promise<any>;\n      /** `documents.blobs.downloadHeaders` \u2014 HEAD /documents/{documentId}/blobs/{blobId}/download. Get document blob download headers (ETag/304 support) */\n      \"downloadHeaders\"(args: {\n        \"documentId\": string | number;\n        \"blobId\": string | number;\n      }): Promise<HeaderResult>;\n      /** `documents.blobs.downloadUrl` \u2014 GET /documents/{documentId}/blobs/{blobId}/download. Download a document blob's bytes */\n      \"downloadUrl\"(args: {\n        \"documentId\": string | number;\n        \"blobId\": string | number;\n        \"disposition\"?: string | number | boolean;\n      }): Promise<Uint8Array>;\n      /** `documents.blobs.get` \u2014 GET /documents/{documentId}/blobs/{blobId}. Get a document blob's metadata */\n      \"get\"(args: {\n        \"documentId\": string | number;\n        \"blobId\": string | number;\n      }): Promise<any>;\n      /** `documents.blobs.list` \u2014 GET /documents/{documentId}/blobs. List blobs attached to a document */\n      \"list\"(args: {\n        \"documentId\": string | number;\n      }): Promise<any>;\n      /** `documents.blobs.upload` \u2014 PUT /documents/{documentId}/blobs/{blobId}. Upload a document blob with a client-specified id (immutable + idempotent) */\n      \"upload\"(args: {\n        \"documentId\": string | number;\n        \"blobId\": string | number;\n        \"X-Blob-Filename\": string | number;\n        \"X-Blob-Size\": string | number;\n        \"X-Blob-Sha256\": string | number;\n        body: ArrayBuffer | Uint8Array | string;\n      }): Promise<any>;\n      /** `documents.blobs.uploadWithoutId` \u2014 PUT /documents/{documentId}/blobs. Deprecated: upload a document blob without a client-specified id */\n      \"uploadWithoutId\"(args: {\n        \"documentId\": string | number;\n      }): Promise<any>;\n    };\n    /** `documents.clearLinkAccess` \u2014 DELETE /documents/{documentId}/link-access. Turn off the document's link access */\n    \"clearLinkAccess\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.create` \u2014 POST /documents. Create a new document */\n    \"create\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.createWithAlias` \u2014 POST /documents/create-with-alias. Create a document and bind it to an alias */\n    \"createWithAlias\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.debugDumpUpdates` \u2014 POST /documents/{documentId}/debug/dump-updates. Dump a document's raw CRDT update log (debug) */\n    \"debugDumpUpdates\"(args: {\n      \"documentId\": string | number;\n      \"limit\"?: string | number | boolean;\n      \"offset\"?: string | number | boolean;\n      \"includeData\"?: string | number | boolean;\n      \"includeR2Data\"?: string | number | boolean;\n      body?: unknown;\n    }): Promise<any>;\n    /** `documents.debugMerge` \u2014 POST /documents/{documentId}/debug/merge. Force-merge a document's pending updates (debug) */\n    \"debugMerge\"(args: {\n      \"documentId\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `documents.debugMergeBlock` \u2014 POST /documents/{documentId}/debug/merge-block. Merge a specific update block of a document (debug) */\n    \"debugMergeBlock\"(args: {\n      \"documentId\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `documents.debugRestore` \u2014 POST /documents/debug/restore. Restore a document from a prior state snapshot (debug) */\n    \"debugRestore\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.debugStats` \u2014 GET /documents/{documentId}/debug/stats. Get document storage/update stats (debug) */\n    \"debugStats\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.delete` \u2014 DELETE /documents/{documentId}. Delete a document */\n    \"delete\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.denyAccessRequest` \u2014 POST /documents/{documentId}/access-requests/{requestId}/deny. Deny a document access request */\n    \"denyAccessRequest\"(args: {\n      \"documentId\": string | number;\n      \"requestId\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `documents.exportChain` \u2014 GET /documents/{documentId}/export/chain. Export chain of a large document (snapshot + sealed overlays + open epoch) */\n    \"exportChain\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.exportState` \u2014 GET /documents/{documentId}/export/state. Export a document's encoded CRDT state */\n    \"exportState\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.get` \u2014 GET /documents/{documentId}. Get a single document by id */\n    \"get\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.getImportChainStatus` \u2014 GET /documents/{documentId}/import/chain. How far a large document's chain import has got */\n    \"getImportChainStatus\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.getLinkAccess` \u2014 GET /documents/{documentId}/link-access. Get the document's \"anyone with the link\" access level */\n    \"getLinkAccess\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.getOrCreateWithAlias` \u2014 POST /documents/get-or-create-with-alias. Get the document bound to an alias, creating it if absent (idempotent) */\n    \"getOrCreateWithAlias\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.getPermissions` \u2014 GET /documents/{documentId}/permissions. List a document's user permissions */\n    \"getPermissions\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.getSchema` \u2014 GET /documents/{documentId}/schema. Introspect a document's model schema */\n    \"getSchema\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.getStats` \u2014 GET /documents/{documentId}/stats. Document statistics (record/model/blob counts, approximate size) */\n    \"getStats\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.grantGroupPermission` \u2014 POST /documents/{documentId}/group-permissions. Grant a group permission on a document */\n    \"grantGroupPermission\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.importChain` \u2014 POST /documents/{documentId}/import/chain. Install an uploaded chain into a large document */\n    \"importChain\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.importChainArtifact` \u2014 POST /documents/{documentId}/import/chain/artifact. Upload one artifact of a large document's import chain */\n    \"importChainArtifact\"(args: {\n      \"documentId\": string | number;\n      \"kind\"?: string | number | boolean;\n      \"epoch\"?: string | number | boolean;\n      \"buildId\"?: string | number | boolean;\n      \"model\"?: string | number | boolean;\n      \"index\"?: string | number | boolean;\n      body: ArrayBuffer | Uint8Array | string;\n    }): Promise<any>;\n    /** `documents.importState` \u2014 POST /documents/{documentId}/import/state. Import encoded CRDT state into a document */\n    \"importState\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.listAccessRequests` \u2014 GET /documents/{documentId}/access-requests. List access requests for a document */\n    \"listAccessRequests\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.listGroupPermissions` \u2014 GET /documents/{documentId}/group-permissions. List a document's group permissions */\n    \"listGroupPermissions\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.listPendingInvitations` \u2014 GET /documents/{documentId}/pending-invitations. List a document's pending (deferred) invitations */\n    \"listPendingInvitations\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.open` \u2014 POST /documents/open. Open a document for collaboration (resolves access + alias) */\n    \"open\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    \"records\": {\n      /** `documents.records.aggregate` \u2014 POST /documents/{documentId}/records/{model}/aggregate. Aggregate records in a document model (count/sum/avg/min/max, optional grouping) */\n      \"aggregate\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `documents.records.bulk` \u2014 POST /documents/{documentId}/records/bulk. Apply an atomic multi-model record blob to a document (create/patch/delete) */\n      \"bulk\"(args: {\n        \"documentId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `documents.records.count` \u2014 GET /documents/{documentId}/records/{model}/count. Count records in a document model */\n      \"count\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        \"filter\"?: Record<string, unknown> | string;\n      }): Promise<any>;\n      /** `documents.records.delete` \u2014 DELETE /documents/{documentId}/records/{model}/{recordId}. Delete a record from a document model */\n      \"delete\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        \"recordId\": string | number;\n      }): Promise<any>;\n      /** `documents.records.patch` \u2014 PATCH /documents/{documentId}/records/{model}/{recordId}. Merge fields into an existing record in a document model */\n      \"patch\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        \"recordId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `documents.records.query` \u2014 GET /documents/{documentId}/records/{model}. Query records in a document model */\n      \"query\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        \"limit\"?: string | number | boolean;\n        \"cursor\"?: string | number | boolean;\n        \"filter\"?: Record<string, unknown> | string;\n      }): Promise<any>;\n      /** `documents.records.save` \u2014 POST /documents/{documentId}/records/{model}. Create or replace a record in a document model */\n      \"save\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        body: unknown;\n      }): Promise<any>;\n    };\n    /** `documents.removePermissionByEmail` \u2014 DELETE /documents/{documentId}/permissions. Revoke a user's permission on a document by email (?email=) */\n    \"removePermissionByEmail\"(args: {\n      \"documentId\": string | number;\n      \"email\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `documents.removePermissionByUserId` \u2014 DELETE /documents/{documentId}/permissions/{userId}. Revoke a user's permission on a document by user id */\n    \"removePermissionByUserId\"(args: {\n      \"documentId\": string | number;\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `documents.removeTag` \u2014 DELETE /documents/{documentId}/tags/{tag}. Remove a tag from a document */\n    \"removeTag\"(args: {\n      \"documentId\": string | number;\n      \"tag\": string | number;\n    }): Promise<any>;\n    /** `documents.requestAccess` \u2014 POST /documents/{documentId}/access-requests. Request access to a document */\n    \"requestAccess\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.revokeGroupPermission` \u2014 DELETE /documents/{documentId}/group-permissions/{groupType}/{groupId}. Revoke a group permission on a document */\n    \"revokeGroupPermission\"(args: {\n      \"documentId\": string | number;\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `documents.setLinkAccess` \u2014 PUT /documents/{documentId}/link-access. Set the document's \"anyone with the link\" access level */\n    \"setLinkAccess\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.transferOwnership` \u2014 POST /documents/{documentId}/permissions/transfer. Transfer ownership of a document to another user */\n    \"transferOwnership\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.update` \u2014 PUT /documents/{documentId}. Update a document's metadata */\n    \"update\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.updatePermissions` \u2014 PUT /documents/{documentId}/permissions. Grant or update a user's permission on a document */\n    \"updatePermissions\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.validateAccess` \u2014 POST /documents/{documentId}/validate-access. Resolve the caller's effective access level for a document */\n    \"validateAccess\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n  };\n  \"email\": {\n    /** `email.send` \u2014 POST /emails/send. Send an application email under a server function's grant */\n    \"send\"(args: {\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"functions\": {\n    /** `functions.invoke` \u2014 POST /functions/{functionKey}. Invoke a server function: a synchronous one returns its result, a durable one starts a run */\n    \"invoke\"(args: {\n      \"functionKey\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n  };\n  \"gemini\": {\n    /** `gemini.countTokens` \u2014 POST /gemini/count-tokens. Count tokens for a Gemini request */\n    \"countTokens\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `gemini.generate` \u2014 POST /gemini/generate. Generate content with Gemini */\n    \"generate\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `gemini.generateRaw` \u2014 POST /gemini/generate-raw. Generate content with Gemini (raw passthrough) */\n    \"generateRaw\"(args: {\n      \"model\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n    /** `gemini.models` \u2014 GET /gemini/models. List available Gemini models */\n    \"models\"(args?: Record<string, never>): Promise<any>;\n  };\n  \"groups\": {\n    /** `groups.addMember` \u2014 POST /groups/{groupType}/{groupId}/members. Add a member to a group */\n    \"addMember\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `groups.create` \u2014 POST /groups. Create a group */\n    \"create\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `groups.delete` \u2014 DELETE /groups/{groupType}/{groupId}. Delete a group */\n    \"delete\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `groups.get` \u2014 GET /groups/{groupType}/{groupId}. Get a group by type and id */\n    \"get\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `groups.list` \u2014 GET /groups. List groups */\n    \"list\"(args?: {\n      \"type\"?: string | number | boolean;\n      \"includeSystem\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `groups.listDatabases` \u2014 GET /groups/{groupType}/{groupId}/databases. List databases shared with a group */\n    \"listDatabases\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `groups.listDocuments` \u2014 GET /groups/{groupType}/{groupId}/documents. List documents shared with a group */\n    \"listDocuments\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `groups.listMembers` \u2014 GET /groups/{groupType}/{groupId}/members. List a group's members */\n    \"listMembers\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n      \"include\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `groups.listPendingInvitations` \u2014 GET /groups/{groupType}/{groupId}/pending-invitations. List a group's pending invitations */\n    \"listPendingInvitations\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `groups.listUserMemberships` \u2014 GET /users/{userId}/memberships. List a user's group memberships */\n    \"listUserMemberships\"(args: {\n      \"userId\": string | number;\n      \"includeSystem\"?: string | number | boolean;\n      \"type\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `groups.removeMember` \u2014 DELETE /groups/{groupType}/{groupId}/members/{userId}. Remove a specific member from a group */\n    \"removeMember\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `groups.removeMemberByEmail` \u2014 DELETE /groups/{groupType}/{groupId}/members. Remove a group member or pending invitation by email */\n    \"removeMemberByEmail\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n      \"email\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `groups.update` \u2014 PATCH /groups/{groupType}/{groupId}. Update a group */\n    \"update\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"integrations\": {\n    /** `integrations.call` \u2014 POST /integrations/{integrationKey}/call. Call an integration under a server function's grants */\n    \"call\"(args: {\n      \"integrationKey\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `integrations.list` \u2014 GET /integrations. List integrations configured for the app */\n    \"list\"(args?: Record<string, never>): Promise<any>;\n    /** `integrations.proxy` \u2014 POST /integrations/{integrationKey}/proxy. Proxy a request through a configured integration */\n    \"proxy\"(args: {\n      \"integrationKey\": string | number;\n    }): Promise<any>;\n  };\n  \"iterations\": {\n    /** `iterations.get` \u2014 GET /iterations/{iterationName}. Get details for a single iteration */\n    \"get\"(args: {\n      \"iterationName\": string | number;\n    }): Promise<any>;\n    /** `iterations.list` \u2014 GET /iterations. List iteration runs */\n    \"list\"(args?: Record<string, never>): Promise<any>;\n    /** `iterations.reset` \u2014 POST /iterations/{iterationName}/reset. Reset a terminal iteration so the next trigger runs fresh */\n    \"reset\"(args: {\n      \"iterationName\": string | number;\n    }): Promise<any>;\n  };\n  \"llm\": {\n    /** `llm.chat` \u2014 POST /llm/chat. Run an LLM chat completion */\n    \"chat\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `llm.models` \u2014 GET /llm/models. List available LLM models */\n    \"models\"(args?: Record<string, never>): Promise<any>;\n  };\n  \"locks\": {\n    /** `locks.list` \u2014 GET /locks. List all currently-held named locks in the app */\n    \"list\"(args?: Record<string, never>): Promise<any>;\n    /** `locks.release` \u2014 POST /locks/release. Release a held named lock (requires the acquire handle) */\n    \"release\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `locks.renew` \u2014 POST /locks/renew. Extend the lease on a held named lock */\n    \"renew\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `locks.status` \u2014 POST /locks/status. Report the current holder of a named lock */\n    \"status\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `locks.tryAcquire` \u2014 POST /locks/acquire. Attempt to acquire a named lock (single non-blocking attempt) */\n    \"tryAcquire\"(args: {\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"notifications\": {\n    /** `notifications.list` \u2014 GET /notifications. List the caller's in-app notification inbox (newest first) */\n    \"list\"(args?: {\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `notifications.listDevices` \u2014 GET /me/push-tokens. List the caller's registered push devices */\n    \"listDevices\"(args?: Record<string, never>): Promise<any>;\n    /** `notifications.markAllRead` \u2014 POST /notifications/read-all. Mark all of the caller's notifications as read */\n    \"markAllRead\"(args?: Record<string, never>): Promise<any>;\n    /** `notifications.markRead` \u2014 PATCH /notifications/{notificationId}/read. Mark one of the caller's notifications as read */\n    \"markRead\"(args: {\n      \"notificationId\": string | number;\n    }): Promise<any>;\n    /** `notifications.registerDevice` \u2014 POST /me/push-tokens. Register (upsert) the caller's device push token */\n    \"registerDevice\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `notifications.send` \u2014 POST /notifications/send. Send a notification to an app user (durable in-app inbox row + live WS frame) */\n    \"send\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `notifications.unreadCount` \u2014 GET /notifications/unread-count. Count the caller's unread notifications */\n    \"unreadCount\"(args?: Record<string, never>): Promise<any>;\n    /** `notifications.unregisterDevice` \u2014 DELETE /me/push-tokens/{token}. Unregister one of the caller's device push tokens */\n    \"unregisterDevice\"(args: {\n      \"token\": string | number;\n    }): Promise<any>;\n  };\n  \"prompts\": {\n    /** `prompts.execute` \u2014 POST /prompts/{promptKey}/execute. Execute a saved prompt */\n    \"execute\"(args: {\n      \"promptKey\": string | number;\n    }): Promise<any>;\n    /** `prompts.run` \u2014 POST /prompts/{promptKey}/run. Run a prompt under a server function's grants */\n    \"run\"(args: {\n      \"promptKey\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n  };\n  \"resourceMetadata\": {\n    /** `resourceMetadata.delete` \u2014 DELETE /resources/{resourceType}/{resourceId}/metadata/{category}. Delete a resource's metadata for a category (idempotent) */\n    \"delete\"(args: {\n      \"resourceType\": string | number;\n      \"resourceId\": string | number;\n      \"category\": string | number;\n    }): Promise<any>;\n    /** `resourceMetadata.get` \u2014 GET /resources/{resourceType}/{resourceId}/metadata/{category}. Read a resource's metadata for a category */\n    \"get\"(args: {\n      \"resourceType\": string | number;\n      \"resourceId\": string | number;\n      \"category\": string | number;\n    }): Promise<any>;\n    /** `resourceMetadata.getBatch` \u2014 POST /resources/metadata/batch. Batch-read resource metadata (partial success) */\n    \"getBatch\"(args: {\n      \"debug\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n    /** `resourceMetadata.list` \u2014 GET /resources/{resourceType}/{resourceId}/metadata. List all metadata categories on a resource */\n    \"list\"(args: {\n      \"resourceType\": string | number;\n      \"resourceId\": string | number;\n    }): Promise<any>;\n    /** `resourceMetadata.resolve` \u2014 POST /metadata/resolve. Resolve a resource by a category's unique metadata value */\n    \"resolve\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `resourceMetadata.set` \u2014 PUT /resources/{resourceType}/{resourceId}/metadata/{category}. Write a resource's metadata for a category */\n    \"set\"(args: {\n      \"resourceType\": string | number;\n      \"resourceId\": string | number;\n      \"category\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"secrets\": {\n    /** `secrets.get` \u2014 GET /secrets/{name}. Read an app secret under a server function's grants */\n    \"get\"(args: {\n      \"name\": string | number;\n    }): Promise<any>;\n  };\n  \"users\": {\n    /** `users.getBasic` \u2014 GET /users/{userId}/basic. Get a user's basic public profile */\n    \"getBasic\"(args: {\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `users.getProfiles` \u2014 POST /users/profiles. Look up user profiles in bulk */\n    \"getProfiles\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `users.list` \u2014 GET /users. List app users */\n    \"list\"(args?: {\n      \"email\"?: string | number | boolean;\n      \"userId\"?: string | number | boolean;\n      \"name\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `users.lookup` \u2014 GET /users/lookup. Look up a user by identifier */\n    \"lookup\"(args?: {\n      \"email\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `users.remove` \u2014 DELETE /users/{userId}. Remove a user from the app */\n    \"remove\"(args: {\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `users.send` \u2014 POST /users/{userId}/send. Send a realtime message to a member of this app */\n    \"send\"(args: {\n      \"userId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `users.setRole` \u2014 PUT /users/{userId}/role. Set a user's app role */\n    \"setRole\"(args: {\n      \"userId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n}\n\n/**\n * The app's database types, model by model \u2014 EMPTY here and filled by the\n * declaration `primitive config push` writes into the config tree's\n * `functions/` directory (#3182). A tree that has pushed once therefore types\n * `ctx.db` against its own schemas; one that has not gets the open form and\n * still compiles.\n */\nexport interface DatabaseSchemas {}\n\n/**\n * The type keys `ctx.db` accepts.\n *\n * Every key the augmentation declares, and NOTHING else, once a tree has\n * pushed: naming a type the app does not have is a compile error. Before that\n * \u2014 an unaugmented tree, a function written before the first push \u2014\n * `DatabaseSchemas` is empty and `keyof` it is `never`, which would make the\n * argument unwritable rather than open. So the empty case widens to `string`\n * and the handle is untyped instead of unusable.\n */\nexport type DatabaseTypeKeys = [keyof DatabaseSchemas] extends [never]\n  ? string\n  : keyof DatabaseSchemas & string;\n\n/** A model's row shape, or an open record for a type with no schema. */\nexport type DatabaseModels<K extends string> = K extends keyof DatabaseSchemas\n  ? DatabaseSchemas[K]\n  : Record<string, Record<string, unknown>>;\n\n/**\n * The model names one database type addresses \u2014 its own, or any name at all\n * for a type that declares no schema (the DO is schemaless, so a grant on such\n * a type is legal and there is simply nothing to narrow to).\n */\nexport type DatabaseModelNames<TModels> = [keyof TModels] extends [never]\n  ? string\n  : keyof TModels & string;\n\n/** One model's row shape, open when the type declares no schema. */\nexport type DatabaseModelRow<TModels, M extends string> =\n  M extends keyof TModels ? TModels[M] : Record<string, unknown>;\n\n/**\n * One model of one database, scoped: the `modelName` every records call needs\n * is bound once, so a call names an operation and its own arguments.\n *\n * Filters and options are ordinary objects. Inline filter typing arrives with\n * unified schemas \u2014 the intent's decision, not an omission \u2014 so what is typed\n * today is the model name and the row shape a read hands back.\n */\nexport type ModelScopedBody<TBody = Record<string, unknown>> = TBody & {\n  /**\n   * Bound by the handle. Reserved so a body cannot look like a second way to\n   * choose a model: the runtime assigns the handle's own model last, and a row\n   * type that said otherwise would be a lie about what came back.\n   */\n  modelName?: never;\n};\n\n/**\n * One write inside a model-scoped batch. Every batch verb is a write, so a\n * batch on a model needs that model's write grant whatever the ops are.\n */\nexport type ModelBatchOperation<TRow> = {\n  op: \"save\" | \"patch\" | \"delete\" | \"increment\" | \"addToSet\" | \"removeFromSet\";\n  id?: string;\n  data?: Partial<TRow>;\n  /** Bound by the handle, for the same reason every other call's is. */\n  modelName?: never;\n  [key: string]: unknown;\n};\n\nexport interface DatabaseModelHandle<TRow> {\n  query(body?: ModelScopedBody): Promise<{ data: TRow[]; hasMore?: boolean; nextCursor?: string }>;\n  count(body?: ModelScopedBody): Promise<any>;\n  aggregate(body: ModelScopedBody): Promise<any>;\n  save(body: ModelScopedBody<{ id?: string; data: Partial<TRow>; [key: string]: unknown }>): Promise<any>;\n  /** Several writes to THIS model in one request; the binding is per item. */\n  batch(body: {\n    operations: Array<ModelBatchOperation<TRow>>;\n    atomic?: boolean;\n  }): Promise<any>;\n}\n\n/** One database, typed by the database TYPE key its grant names. */\nexport interface DatabaseHandle<TModels> {\n  /** The database this handle addresses \u2014 part of every query cache key. */\n  databaseId: string;\n  /** The type key this handle was opened with. */\n  databaseType: string;\n  model<M extends DatabaseModelNames<TModels>>(\n    modelName: M\n  ): DatabaseModelHandle<DatabaseModelRow<TModels, M>>;\n  /**\n   * A batch may also SPAN models, and then it names each one itself \u2014 the\n   * model-scoped form above is the typed way to write the common case.\n   */\n  batch(body: {\n    operations: Array<Record<string, unknown>>;\n    atomic?: boolean;\n  }): Promise<any>;\n  /** Run one of the database type's prepared operations under this function's grants. */\n  runOperation(name: string, params?: Record<string, unknown>): Promise<any>;\n}\n\n/**\n * One call through a granted integration \u2014 #3183.\n *\n * `path` is RELATIVE to the integration's `baseUrl`, and the host is the\n * integration's: the platform resolves and normalizes the path before checking\n * it against `allowedPaths`, so a protocol-relative path or a `..` segment is\n * refused rather than silently sending the request somewhere else.\n */\nexport interface IntegrationCallRequest {\n  /** Must be in the integration's `allowedMethods`. Defaults to its own default. */\n  method?: string;\n  /** Relative to the integration's `baseUrl`. */\n  path?: string;\n  query?: Record<string, unknown>;\n  headers?: Record<string, string>;\n  body?: unknown;\n  /** form-urlencoded body; not combinable with `body`. */\n  form?: Record<string, unknown>;\n  bodyMode?: \"json\" | \"raw\" | \"multipart\";\n}\n\n/** What the upstream answered, as the platform saw it. */\nexport interface IntegrationCallResult {\n  status: number;\n  headers: Record<string, string>;\n  body: unknown;\n  durationMs: number;\n  traceId: string;\n  /** Set when the platform or the upstream refused; absent on success. */\n  errorCode?: string;\n}\n\n/** What a prompt run is given \u2014 the member execute route's own body. */\nexport interface PromptRunArgs {\n  variables?: Record<string, unknown>;\n  /** Run against a different model for this call only. */\n  modelOverride?: string;\n  /** Pin a specific config OF THIS PROMPT; defaults to its active one. */\n  configId?: string;\n}\n\n/** The member execute envelope, unchanged on the function path. */\nexport interface PromptRunResult {\n  success: boolean;\n  output: string;\n  error?: string | null;\n  metrics?: Record<string, unknown>;\n  configId: string;\n}\n\n/** What a send delivered to. */\nexport interface SendResult {\n  /** Unique live connections the frame was sent to. Zero is a success. */\n  connections: number;\n  /** True when the per-user connection ceiling stopped the fanout. */\n  truncated: boolean;\n}\n\n/** Who a channel grant is for, and for how long \u2014 #3184. */\nexport interface ChannelAuthorizeOptions {\n  /**\n   * The member the grant names. Caller mode defaults to the invoking caller;\n   * system mode has no caller and must say.\n   */\n  userId?: string;\n  /** Default 300 s, clamped to the platform ceiling of 900 s. */\n  ttlSeconds?: number;\n}\n\n/** The credential a client presents on the WebSocket it already has. */\nexport interface ChannelGrantResult {\n  channel: string;\n  /** The signed grant. Hand it to the client; it is not readable here. */\n  grant: string;\n  /** Epoch milliseconds. Expiry is the only revocation a channel has. */\n  expiresAt: number;\n}\n\nexport interface FunctionContext {\n  /** The HTTP caller, or null for a webhook, cron or database-change fire. */\n  user: FunctionUser | null;\n  trigger: FunctionTrigger;\n  api: FunctionApi;\n  /**\n   * A typed handle over one database. The second argument is the database TYPE\n   * key \u2014 the same key a `database:<type>/<model>:read|write` grant names \u2014\n   * and it is what selects the models this handle knows (#3182).\n   */\n  db<K extends DatabaseTypeKeys>(\n    databaseId: string,\n    databaseType: K\n  ): DatabaseHandle<DatabaseModels<K>>;\n  /**\n   * Outbound HTTP, through a granted integration and nowhere else (#3183).\n   *\n   * A function has no raw network access: every `fetch` to a host that is not\n   * the platform answers `FUNCTION_EGRESS_DENIED`, grant or no grant. What an\n   * `integration:<key>` grant buys is this call, which the MAIN WORKER makes on\n   * the function's behalf \u2014 which is why the integration's `{{secrets.*}}`\n   * credentials can be injected into the request without ever being visible to\n   * the code that asked for it.\n   */\n  integrations: {\n    call(\n      integrationKey: string,\n      request?: IntegrationCallRequest\n    ): Promise<IntegrationCallResult>;\n  };\n  /**\n   * Run one of the app's prompts, under a `prompt:<key>` grant (#3183).\n   *\n   * The prompt's `accessRule` is not consulted \u2014 it states which MEMBERS may\n   * execute the prompt from a client, and the grant is what authorizes this\n   * call. The provider request is bounded by the invocation's own deadline.\n   */\n  prompts: {\n    run(promptKey: string, args?: PromptRunArgs): Promise<PromptRunResult>;\n  };\n  /**\n   * The value of one app secret, under a `secret:<NAME>` grant (#3183).\n   *\n   * Prefer `ctx.integrations.call` when the secret is a credential FOR an\n   * integration: there the value is injected by the platform and never enters\n   * the sandbox at all. This is for the cases an integration cannot express.\n   *\n   * Rejects with `FUNCTION_SECRET_NOT_FOUND` when the grant names a value\n   * this environment has not been given \u2014 secrets are provisioned per\n   * environment, out of band from the push.\n   */\n  secret(name: string): Promise<string>;\n  /** The value of one app config var, under a `var:<NAME>` grant (#3183). */\n  configVar(name: string): Promise<string>;\n  /**\n   * Realtime messages to this app's clients, under a `users:send` grant\n   * (#3183).\n   *\n   * The recipient's client receives a `direct.message` frame carrying this\n   * payload and the sending function's key. Presence is not guaranteed: a\n   * member with no live socket answers `{ connections: 0 }` rather than an\n   * error.\n   */\n  users: {\n    send(userId: string, payload: unknown): Promise<SendResult>;\n  };\n  /** The same frame to ONE connection, under a `connections:send` grant. */\n  connections: {\n    send(connectionId: string, payload: unknown): Promise<SendResult>;\n  };\n  /**\n   * Realtime channels, under a `channel:<namespace>` grant that COVERS the\n   * channel \u2014 #3184.\n   *\n   * `authorize` hands back a short-lived grant for ONE member to present on\n   * the socket it already has; `publish` delivers a `channel.message` frame to\n   * every connection that has joined and whose grant has not expired. Expiry is\n   * the only revocation, so `expiresAt` comes back for the client to renew\n   * ahead of \u2014 a renewal is another authorize and another subscribe.\n   */\n  channels: {\n    authorize(\n      channel: string,\n      options?: ChannelAuthorizeOptions\n    ): Promise<ChannelGrantResult>;\n    publish(channel: string, payload: unknown): Promise<SendResult>;\n  };\n}\n\n/**\n * The durable step handle \u2014 Cloudflare Workflows' `WorkflowStep`, forwarded\n * untouched, so `step.do` results are memoized and `step.sleep` hibernates.\n *\n * A SYNCHRONOUS invocation gets a passthrough shim of the same shape, so a body\n * written for durable mode runs either way: `do` executes the body (nothing to\n * memoize into without an engine), `sleep` resolves immediately (the sync\n * ceiling is seconds), and `waitForEvent` throws `STEP_NOT_AVAILABLE`.\n */\nexport interface FunctionStep {\n  do<T>(name: string, body: () => T | Promise<T>): Promise<T>;\n  do<T>(\n    name: string,\n    config: Record<string, unknown>,\n    body: () => T | Promise<T>\n  ): Promise<T>;\n  sleep(name: string, duration: number | string): Promise<void>;\n  sleepUntil(name: string, timestamp: Date | number): Promise<void>;\n  waitForEvent<T = unknown>(\n    name: string,\n    options: Record<string, unknown>\n  ): Promise<T>;\n}\n\nexport declare const SDK_STUB_VERSION: string;\n\n/**\n * Declare a server function's handler.\n *\n * Both authoring styles reach the platform bootstrap identically \u2014 a plain\n * default export taking `(input, ctx, step)` runs exactly as a wrapped one\n * does \u2014 so this is a typing and intent marker, not a different calling\n * convention.\n *\n * `step` is the third argument in BOTH modes (#3186). A durable run gets the\n * engine's live `WorkflowStep`; a synchronous one gets a passthrough shim\n * (`do` runs the body, `sleep` resolves at once, `waitForEvent` throws a\n * named error), so a durable-authored body can be exercised synchronously.\n */\nexport declare function defineFunction<TInput = unknown, TOutput = unknown>(\n  handler: (\n    input: TInput,\n    ctx: FunctionContext,\n    step: FunctionStep\n  ) => TOutput | Promise<TOutput>\n): (\n  input: TInput,\n  ctx: FunctionContext,\n  step: FunctionStep\n) => Promise<TOutput>;\n\n/**\n * One declared parameter of a registered query.\n *\n * `caller: true` (or `type: \"$caller\"`) is the intent's IMMUTABLE binding:\n * the platform injects the invocation's user and refuses a call that supplies\n * the parameter itself.\n */\nexport interface QueryParamSpec {\n  type?: \"string\" | \"number\" | \"boolean\" | \"any\" | \"$caller\";\n  caller?: boolean;\n  optional?: boolean;\n  default?: unknown;\n}\n\nexport interface QueryDefinition<TDb, TParams, TResult> {\n  /** The models this query touches. Caching is off unless the run matches. */\n  models: string[];\n  params?: Record<string, QueryParamSpec>;\n  /**\n   * Cache the answer for `ttlMs` \u2014 capped by the platform, and applied ONLY\n   * when the run is verified: every model the body touched was declared, and\n   * no prepared operation was used. A write through the handle drops the\n   * entries that read the written model.\n   */\n  cache?: { ttlMs: number };\n  run: (db: TDb, params: TParams) => TResult | Promise<TResult>;\n}\n\n/**\n * Register a named query over a database handle (#3187).\n *\n * A registration helper, not a language: `run` is ordinary code over the same\n * typed handle, and what registration adds is a name, declared parameters\n * (validated, coerced and defaulted), the `$caller` binding, and a cache the\n * platform may use when it can verify what the run touched.\n *\n * Register at MODULE scope: a registration made inside the handler still works\n * for direct calls but is invisible to `config push`'s manifest.\n */\nexport declare function defineQuery<\n  TDb = DatabaseHandle<any>,\n  TParams = Record<string, any>,\n  TResult = any\n>(\n  name: string,\n  definition: QueryDefinition<TDb, TParams, TResult>\n): (db: TDb, params?: Record<string, unknown>) => Promise<TResult>;\n\n/** The same, for a registration that writes. A mutation is never cached. */\nexport declare function defineMutation<\n  TDb = DatabaseHandle<any>,\n  TParams = Record<string, any>,\n  TResult = any\n>(\n  name: string,\n  definition: QueryDefinition<TDb, TParams, TResult>\n): (db: TDb, params?: Record<string, unknown>) => Promise<TResult>;\n\n/** The platform's cap on a registered query's cache TTL, in milliseconds. */\nexport declare const MAX_QUERY_CACHE_TTL_MS: number;\n\n/**\n * Map over items with BOUNDED concurrency (#3187). Results come back in the\n * input's order; the first rejection wins and nothing new is started after it.\n *\n * The bound matters inside a sandbox: an unbounded fan-out over a page of rows\n * spends the whole subrequest ceiling in one line.\n */\nexport declare function pMap<T, R>(\n  items: Iterable<T>,\n  mapper: (item: T, index: number) => R | Promise<R>,\n  options?: { concurrency?: number }\n): Promise<R[]>;\n\n/** The default concurrency `pMap` applies when none is given. */\nexport declare const PMAP_DEFAULT_CONCURRENCY: number;\n\n/**\n * A time-ordered ULID.\n *\n * GENERATE IT INSIDE `step.do`. A durable run re-executes its handler on\n * every resume and memoizes only what a step returned, so an id minted at the\n * top of a handler is a different id after a sleep \u2014 and whatever it was\n * written into is orphaned.\n */\nexport declare function ulid(): string;\n\n/** One family's durable `step.do` configuration. */\nexport interface StepPolicy {\n  retries: { limit: number; delay: string; backoff: string };\n  timeout: string;\n}\n\n/**\n * The per-family step policies the DSL runners use, generated from their own\n * timeout module (#3187):\n *\n *   await step.do(\"send-receipt\", stepPolicy.email, () =>\n *     ctx.api.email.send({ body: { to, subject, htmlBody } }));\n *\n * `retries: 0` on email and the AI families is deliberate \u2014 a retried timeout\n * would send the same email twice or bill the same generation twice.\n */\nexport declare const stepPolicy: {\n  email: StepPolicy;\n  llm: StepPolicy;\n  gemini: StepPolicy;\n  database: StepPolicy;\n};\n\ndeclare const _default: {\n  SDK_STUB_VERSION: string;\n  defineFunction: typeof defineFunction;\n  defineQuery: typeof defineQuery;\n  defineMutation: typeof defineMutation;\n  pMap: typeof pMap;\n  ulid: typeof ulid;\n};\nexport default _default;\n";

package/dist/src/lib/generated-sdk-types.js

@@ -0,0 +1,13 @@
+/**
+ * GENERATED FILE — DO NOT EDIT BY HAND.
+ *
+ * Vendored from `packages/primitive-functions/index.d.ts` by
+ * `cli/scripts/gen-sdk-types.mjs` (runs at CLI prebuild). `config push`
+ * writes this text into the config tree's `functions/` directory so an
+ * author's editor and `tsc` can resolve the `primitive-functions` specifier.
+ *
+ * Regenerate with:
+ *   node cli/scripts/gen-sdk-types.mjs
+ */
+export const SDK_TYPES_SOURCE = "// GENERATED by scripts/generate-function-profile.mjs from openapi.json.\n// DO NOT EDIT. Run `pnpm functions:profile` and commit the result; the\n// freshness guard in tests/api/spec/function-profile.test.ts fails when this\n// file and a fresh generation diverge.\n\n/**\n * Type surface of `primitive-functions` — what a server function's author writes\n * against (#3180). The published package's RUNTIME is a stub that throws from\n * every export on purpose: the platform substitutes its own copy at invoke\n * time, and reaching the stub means it did not.\n */\n\n/**\n * The signed-in user who invoked the function over HTTP.\n *\n * Attribution, never authority (#3279): function code acts as the system\n * whoever called it, so this says WHO asked, and the rows the function writes\n * are attributed to them. A trigger fire has no caller and `ctx.user` is\n * null.\n */\nexport interface FunctionUser {\n  userId: string;\n  email: string | null;\n}\n\n/** What started this invocation. */\nexport type FunctionTrigger =\n  | { kind: \"http\" }\n  | { kind: \"webhook\"; [key: string]: unknown }\n  | { kind: \"cron\"; [key: string]: unknown }\n  | { kind: \"database\"; databaseId: string; databaseType: string; [key: string]: unknown }\n  /**\n   * A DSL workflow's `workflow.call` step reached this function (#3288).\n   *\n   * TRANSITIONAL: the bridge exists so a workflow tree can migrate leaf-first\n   * during the transition, and it retires with the workflow engine in phase 7,\n   * taking this variant with it. `workflowKey` names the PARENT workflow, and\n   * `runId`/`stepId` locate the step inside its run.\n   */\n  | { kind: \"workflow\"; workflowKey: string; runId: string; stepId: string };\n\n/** The result shape of an operation that answers in response headers. */\nexport interface HeaderResult {\n  status: number;\n  headers: Record<string, string>;\n}\n\n/**\n * A platform call that was refused. `errorCode` carries the gateway's own\n * codes (`FUNCTION_ROUTE_NOT_ALLOWED`, `FUNCTION_EGRESS_DENIED`, …) as well\n * as the route's.\n */\nexport interface PrimitivePlatformError extends Error {\n  status: number;\n  errorCode: string | null;\n}\n\n/**\n * The typed HTTP profile, generated from the platform's OpenAPI document. Its\n * namespaces mirror the operation ids: analytics, blobBuckets, channels, collections, configVars, connections, databaseTypeConfigs, databases, documents, email, functions, gemini, groups, integrations, iterations, llm, locks, notifications, prompts, resourceMetadata, secrets, users.\n * Methods take one options object carrying the operation's path parameters,\n * query parameters, request headers (under their wire names) and `body`.\n *\n * Generated from the same operations as the runtime profile, so a method that\n * type-checks is a method the platform publishes — and a missing path\n * parameter or a missing required header is a compile error rather than a\n * `TypeError` at invoke time. Every call runs with the app's own SYSTEM\n * authority (#3279): the invocation gate was the authorization. The three\n * namespaces the gateway does not admit (`functions`, `iterations`,\n * `databaseTypeConfigs`) are still declared: they exist, they answer the\n * gateway's structured denial, and hiding them would make a route's\n * availability look like a typo.\n */\nexport interface FunctionApi {\n  \"analytics\": {\n    /** `analytics.cohortRetention` — GET /analytics/cohort-retention. Cohort retention metrics */\n    \"cohortRetention\"(args?: {\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.dailyActive` — GET /analytics/daily-active. Daily active user time series */\n    \"dailyActive\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.errorGroups` — GET /analytics/errors/groups. Group failure events by fingerprint with per-day count buckets */\n    \"errorGroups\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n      \"filter\"?: Record<string, Record<string, string | number | boolean | Array<string | number | boolean>>>;\n    }): Promise<any>;\n    /** `analytics.integrationUsage` — GET /analytics/integrations. Integration usage metrics */\n    \"integrationUsage\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.listEvents` — GET /analytics/events. List analytics events */\n    \"listEvents\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"page\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n      \"filter\"?: Record<string, Record<string, string | number | boolean | Array<string | number | boolean>>>;\n    }): Promise<any>;\n    /** `analytics.listEventsGrouped` — GET /analytics/events/grouped. List analytics events grouped by dimension */\n    \"listEventsGrouped\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"groupBy\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n      \"filter\"?: Record<string, Record<string, string | number | boolean | Array<string | number | boolean>>>;\n    }): Promise<any>;\n    /** `analytics.overviewDau` — GET /analytics/overview/dau. Daily active users overview */\n    \"overviewDau\"(args?: {\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.overviewGrowth` — GET /analytics/overview/growth. User growth overview */\n    \"overviewGrowth\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.overviewMau` — GET /analytics/overview/mau. Monthly active users overview */\n    \"overviewMau\"(args?: {\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.overviewWau` — GET /analytics/overview/wau. Weekly active users overview */\n    \"overviewWau\"(args?: {\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.rollingActive` — GET /analytics/rolling-active. Rolling active user time series */\n    \"rollingActive\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.searchUsers` — GET /analytics/users/search. Search app users for analytics */\n    \"searchUsers\"(args?: {\n      \"q\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.topPrompts` — GET /analytics/prompts/top. List the most-executed prompts */\n    \"topPrompts\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.topUsers` — GET /analytics/users/top. List the most active users */\n    \"topUsers\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.topWorkflows` — GET /analytics/workflows/top. List the most-run workflows */\n    \"topWorkflows\"(args?: {\n      \"windowDays\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.userDetail` — GET /analytics/users/{userUlid}/detail. Detailed analytics for a single user */\n    \"userDetail\"(args: {\n      \"userUlid\": string | number;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.userSnapshot` — GET /analytics/users/{userUlid}/snapshot. Activity snapshot for a single user */\n    \"userSnapshot\"(args: {\n      \"userUlid\": string | number;\n      \"current_timestamp\"?: string | number | boolean;\n      \"_bust\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `analytics.writeForUser` — POST /analytics/write-for-user. Write an analytics event for a subject user under a grant */\n    \"writeForUser\"(args: {\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"blobBuckets\": {\n    /** `blobBuckets.createBucket` — POST /blob-buckets. Create a blob bucket */\n    \"createBucket\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `blobBuckets.delete` — DELETE /blob-buckets/{bucketId}/blobs/{blobId}. Delete a blob */\n    \"delete\"(args: {\n      \"bucketId\": string | number;\n      \"blobId\": string | number;\n    }): Promise<any>;\n    /** `blobBuckets.deleteBatch` — POST /blob-buckets/{bucketId}/blobs/delete. Batch delete blobs from a bucket */\n    \"deleteBatch\"(args: {\n      \"bucketId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `blobBuckets.deleteBucket` — DELETE /blob-buckets/{bucketId}. Delete a blob bucket */\n    \"deleteBucket\"(args: {\n      \"bucketId\": string | number;\n    }): Promise<any>;\n    /** `blobBuckets.download` — GET /blob-buckets/{bucketId}/blobs/{blobId}. Download a blob (anonymous allowed for public buckets) */\n    \"download\"(args: {\n      \"bucketId\": string | number;\n      \"blobId\": string | number;\n      \"disposition\"?: string | number | boolean;\n    }): Promise<Uint8Array>;\n    /** `blobBuckets.downloadSigned` — GET /blob-buckets/{bucketId}/blobs/{blobId}/signed. Download a blob via a signed URL token */\n    \"downloadSigned\"(args: {\n      \"bucketId\": string | number;\n      \"blobId\": string | number;\n      \"token\"?: string | number | boolean;\n    }): Promise<Uint8Array>;\n    /** `blobBuckets.getBucket` — GET /blob-buckets/{bucketId}. Get a blob bucket by id */\n    \"getBucket\"(args: {\n      \"bucketId\": string | number;\n    }): Promise<any>;\n    /** `blobBuckets.getMetadata` — GET /blob-buckets/{bucketId}/blobs/{blobId}/metadata. Get blob metadata (anonymous allowed for public buckets) */\n    \"getMetadata\"(args: {\n      \"bucketId\": string | number;\n      \"blobId\": string | number;\n    }): Promise<any>;\n    /** `blobBuckets.getSignedUrl` — POST /blob-buckets/{bucketId}/blobs/{blobId}/signed-url. Create a signed download URL for a blob */\n    \"getSignedUrl\"(args: {\n      \"bucketId\": string | number;\n      \"blobId\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `blobBuckets.list` — GET /blob-buckets/{bucketId}/blobs. List blobs in a bucket (anonymous allowed for public buckets) */\n    \"list\"(args: {\n      \"bucketId\": string | number;\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `blobBuckets.listBuckets` — GET /blob-buckets. List blob buckets */\n    \"listBuckets\"(args?: Record<string, never>): Promise<any>;\n    /** `blobBuckets.updateBucket` — PATCH /blob-buckets/{bucketId}. Update a blob bucket */\n    \"updateBucket\"(args: {\n      \"bucketId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `blobBuckets.upload` — POST /blob-buckets/{bucketId}/blobs. Upload a blob to a bucket */\n    \"upload\"(args: {\n      \"bucketId\": string | number;\n      \"X-Blob-Filename\": string | number;\n      \"X-Blob-Tags\"?: string | number;\n      \"Content-Type\"?: string | number;\n      body: ArrayBuffer | Uint8Array | string;\n    }): Promise<any>;\n  };\n  \"channels\": {\n    /** `channels.authorize` — POST /channels/{channel}/grants. Issue a channel grant under a server function's grant */\n    \"authorize\"(args: {\n      \"channel\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `channels.publish` — POST /channels/{channel}/publish. Publish a message to a channel under a server function's grant */\n    \"publish\"(args: {\n      \"channel\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"collections\": {\n    /** `collections.addDocument` — POST /collections/{collectionId}/documents. Add a document to a collection */\n    \"addDocument\"(args: {\n      \"collectionId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `collections.addMember` — POST /collections/{collectionId}/members. Add a member to a collection */\n    \"addMember\"(args: {\n      \"collectionId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `collections.create` — POST /collections. Create a collection */\n    \"create\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `collections.delete` — DELETE /collections/{collectionId}. Delete a collection */\n    \"delete\"(args: {\n      \"collectionId\": string | number;\n    }): Promise<any>;\n    /** `collections.get` — GET /collections/{collectionId}. Get a collection by id */\n    \"get\"(args: {\n      \"collectionId\": string | number;\n    }): Promise<any>;\n    /** `collections.getAccess` — GET /collections/{collectionId}/access. Get a collection's access summary */\n    \"getAccess\"(args: {\n      \"collectionId\": string | number;\n    }): Promise<any>;\n    /** `collections.grantGroupPermission` — POST /collections/{collectionId}/group-permissions. Grant a group permission on a collection */\n    \"grantGroupPermission\"(args: {\n      \"collectionId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `collections.list` — GET /collections. List collections */\n    \"list\"(args?: {\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `collections.listCollectionsForDocument` — GET /documents/{documentId}/collections. List collections a document belongs to (reverse lookup) */\n    \"listCollectionsForDocument\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `collections.listDocuments` — GET /collections/{collectionId}/documents. List documents in a collection */\n    \"listDocuments\"(args: {\n      \"collectionId\": string | number;\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `collections.listPendingInvitations` — GET /collections/{collectionId}/pending-invitations. List a collection's pending invitations */\n    \"listPendingInvitations\"(args: {\n      \"collectionId\": string | number;\n    }): Promise<any>;\n    /** `collections.removeDocument` — DELETE /collections/{collectionId}/documents/{documentId}. Remove a document from a collection */\n    \"removeDocument\"(args: {\n      \"collectionId\": string | number;\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `collections.removeMember` — DELETE /collections/{collectionId}/members/{userId}. Remove a member from a collection */\n    \"removeMember\"(args: {\n      \"collectionId\": string | number;\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `collections.revokeGroupPermission` — DELETE /collections/{collectionId}/group-permissions/{groupType}/{groupId}. Revoke a group permission on a collection */\n    \"revokeGroupPermission\"(args: {\n      \"collectionId\": string | number;\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `collections.update` — PATCH /collections/{collectionId}. Update a collection */\n    \"update\"(args: {\n      \"collectionId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"configVars\": {\n    /** `configVars.get` — GET /config-vars/{name}. Read an app config var under a server function's grants */\n    \"get\"(args: {\n      \"name\": string | number;\n    }): Promise<any>;\n  };\n  \"connections\": {\n    /** `connections.send` — POST /connections/{connectionId}/send. Send a realtime message to one connection of this app */\n    \"send\"(args: {\n      \"connectionId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"databaseTypeConfigs\": {\n    /** `databaseTypeConfigs.create` — POST /databases/types. Create a database type */\n    \"create\"(args: {\n      \"dryRun\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.createOperation` — POST /databases/types/{databaseType}/operations. Create an operation for a database type */\n    \"createOperation\"(args: {\n      \"databaseType\": string | number;\n      \"dryRun\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.delete` — DELETE /databases/types/{databaseType}. Delete a database type */\n    \"delete\"(args: {\n      \"databaseType\": string | number;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.deleteOperation` — DELETE /databases/types/{databaseType}/operations/{name}. Delete an operation for a database type */\n    \"deleteOperation\"(args: {\n      \"databaseType\": string | number;\n      \"name\": string | number;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.get` — GET /databases/types/{databaseType}. Get a database type */\n    \"get\"(args: {\n      \"databaseType\": string | number;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.getOperation` — GET /databases/types/{databaseType}/operations/{name}. Get an operation for a database type */\n    \"getOperation\"(args: {\n      \"databaseType\": string | number;\n      \"name\": string | number;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.getReindexStatus` — GET /databases/types/{databaseType}/reindex-status. Status of the index back-provision fan-out for a type */\n    \"getReindexStatus\"(args: {\n      \"databaseType\": string | number;\n      \"runId\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.list` — GET /databases/types. List database types */\n    \"list\"(args?: Record<string, never>): Promise<any>;\n    /** `databaseTypeConfigs.listOperations` — GET /databases/types/{databaseType}/operations. List operations for a database type */\n    \"listOperations\"(args: {\n      \"databaseType\": string | number;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.scaffoldSchema` — POST /databases/types/{databaseType}/schema:scaffold. Scaffold a starter schema for a database type */\n    \"scaffoldSchema\"(args: {\n      \"databaseType\": string | number;\n    }): Promise<any>;\n    \"subscriptions\": {\n      /** `databaseTypeConfigs.subscriptions.create` — POST /databases/types/{databaseType}/subscriptions. Create a subscription for a database type */\n      \"create\"(args: {\n        \"databaseType\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databaseTypeConfigs.subscriptions.delete` — DELETE /databases/types/{databaseType}/subscriptions/{subscriptionKey}. Delete a database type subscription */\n      \"delete\"(args: {\n        \"databaseType\": string | number;\n        \"subscriptionKey\": string | number;\n      }): Promise<any>;\n      /** `databaseTypeConfigs.subscriptions.get` — GET /databases/types/{databaseType}/subscriptions/{subscriptionKey}. Get a database type subscription */\n      \"get\"(args: {\n        \"databaseType\": string | number;\n        \"subscriptionKey\": string | number;\n      }): Promise<any>;\n      /** `databaseTypeConfigs.subscriptions.list` — GET /databases/types/{databaseType}/subscriptions. List subscriptions for a database type */\n      \"list\"(args: {\n        \"databaseType\": string | number;\n      }): Promise<any>;\n      /** `databaseTypeConfigs.subscriptions.update` — PUT /databases/types/{databaseType}/subscriptions/{subscriptionKey}. Update a database type subscription */\n      \"update\"(args: {\n        \"databaseType\": string | number;\n        \"subscriptionKey\": string | number;\n        body: unknown;\n      }): Promise<any>;\n    };\n    /** `databaseTypeConfigs.update` — PATCH /databases/types/{databaseType}. Update a database type */\n    \"update\"(args: {\n      \"databaseType\": string | number;\n      \"dryRun\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n    /** `databaseTypeConfigs.updateOperation` — PATCH /databases/types/{databaseType}/operations/{name}. Update an operation for a database type */\n    \"updateOperation\"(args: {\n      \"databaseType\": string | number;\n      \"name\": string | number;\n      \"dryRun\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"databases\": {\n    /** `databases.addManager` — PUT /databases/{databaseId}/permissions. Set a user's database permission */\n    \"addManager\"(args: {\n      \"databaseId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    \"adminData\": {\n      /** `databases.adminData.batch` — POST /databases/{databaseId}/admin-data/batch. DEPRECATED — direct database batch; use databases/{databaseId}/records/batch */\n      \"batch\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.adminData.count` — POST /databases/{databaseId}/admin-data/count. DEPRECATED — direct database count; use databases/{databaseId}/records/count */\n      \"count\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.adminData.delete` — POST /databases/{databaseId}/admin-data/delete. DEPRECATED — direct database delete; use databases/{databaseId}/records/delete */\n      \"delete\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.adminData.patch` — POST /databases/{databaseId}/admin-data/patch. DEPRECATED — direct database patch; use databases/{databaseId}/records/patch */\n      \"patch\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.adminData.query` — POST /databases/{databaseId}/admin-data/query. DEPRECATED — direct database query; use databases/{databaseId}/records/query */\n      \"query\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.adminData.save` — POST /databases/{databaseId}/admin-data/save. DEPRECATED — direct database save; use databases/{databaseId}/records/save */\n      \"save\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n    };\n    /** `databases.create` — POST /databases. Create a database */\n    \"create\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.delete` — DELETE /databases/{databaseId}. Delete a database */\n    \"delete\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.executeBatch` — POST /databases/{databaseId}/operations/{name}/batch. Execute a database operation in batch */\n    \"executeBatch\"(args: {\n      \"databaseId\": string | number;\n      \"name\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.executeOperation` — POST /databases/{databaseId}/operations/{name}/execute. Execute a database operation */\n    \"executeOperation\"(args: {\n      \"databaseId\": string | number;\n      \"name\": string | number;\n      \"dryRun\"?: string | number | boolean;\n      body?: unknown;\n    }): Promise<any>;\n    /** `databases.get` — GET /databases/{databaseId}. Get a database by id */\n    \"get\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.getMetadata` — GET /databases/{databaseId}/metadata. Get database metadata */\n    \"getMetadata\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.grantGroupPermission` — POST /databases/{databaseId}/group-permissions. Grant a group permission on a database */\n    \"grantGroupPermission\"(args: {\n      \"databaseId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.importBulk` — POST /databases/{databaseId}/operations/{name}/import-bulk. Bulk-import records via a database operation */\n    \"importBulk\"(args: {\n      \"databaseId\": string | number;\n      \"name\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.list` — GET /databases. List databases */\n    \"list\"(args?: Record<string, never>): Promise<any>;\n    /** `databases.listGroupPermissions` — GET /databases/{databaseId}/group-permissions. List a database's group permissions */\n    \"listGroupPermissions\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.listOperations` — GET /databases/{databaseId}/operations. List operations runnable on a database */\n    \"listOperations\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.listPermissions` — GET /databases/{databaseId}/permissions. List a database's user permissions */\n    \"listPermissions\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    \"records\": {\n      /** `databases.records.addToSet` — POST /databases/{databaseId}/records/stringset/add. Database records: stringset/add (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"addToSet\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.aggregate` — POST /databases/{databaseId}/records/aggregate. Database records: aggregate (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"aggregate\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.batch` — POST /databases/{databaseId}/records/batch. Database records: batch (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"batch\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.count` — POST /databases/{databaseId}/records/count. Database records: count (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"count\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.delete` — POST /databases/{databaseId}/records/delete. Database records: delete (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"delete\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.describe` — GET /databases/{databaseId}/records/describe. Database records: describe (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"describe\"(args: {\n        \"databaseId\": string | number;\n        \"modelName\"?: string | number | boolean;\n      }): Promise<any>;\n      /** `databases.records.dropIndex` — POST /databases/{databaseId}/records/index/drop. Database records: index/drop (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"dropIndex\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.dropUniqueConstraint` — POST /databases/{databaseId}/records/unique-constraint/drop. Database records: unique-constraint/drop (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"dropUniqueConstraint\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.increment` — POST /databases/{databaseId}/records/increment. Database records: increment (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"increment\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.listIndexes` — GET /databases/{databaseId}/records/indexes. Database records: indexes (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"listIndexes\"(args: {\n        \"databaseId\": string | number;\n        \"modelName\"?: string | number | boolean;\n      }): Promise<any>;\n      /** `databases.records.listUniqueConstraints` — GET /databases/{databaseId}/records/unique-constraints. Database records: unique-constraints (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"listUniqueConstraints\"(args: {\n        \"databaseId\": string | number;\n        \"modelName\"?: string | number | boolean;\n      }): Promise<any>;\n      /** `databases.records.models` — GET /databases/{databaseId}/records/models. Database records: models (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"models\"(args: {\n        \"databaseId\": string | number;\n        \"modelName\"?: string | number | boolean;\n      }): Promise<any>;\n      /** `databases.records.patch` — POST /databases/{databaseId}/records/patch. Database records: patch (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"patch\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.query` — POST /databases/{databaseId}/records/query. Database records: query (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"query\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.registerIndex` — POST /databases/{databaseId}/records/index/register. Database records: index/register (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"registerIndex\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.registerUniqueConstraint` — POST /databases/{databaseId}/records/unique-constraint/register. Database records: unique-constraint/register (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"registerUniqueConstraint\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.removeFromSet` — POST /databases/{databaseId}/records/stringset/remove. Database records: stringset/remove (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"removeFromSet\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.save` — POST /databases/{databaseId}/records/save. Database records: save (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"save\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `databases.records.syncIndexes` — POST /databases/{databaseId}/records/indexes/sync. Database records: indexes/sync (requires manager-or-higher on the database, or an app-admin/owner role) */\n      \"syncIndexes\"(args: {\n        \"databaseId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n    };\n    /** `databases.reindex` — POST /databases/{databaseId}/reindex. Reindex a database */\n    \"reindex\"(args: {\n      \"databaseId\": string | number;\n    }): Promise<any>;\n    /** `databases.revokeGroupPermission` — DELETE /databases/{databaseId}/group-permissions/{groupType}/{groupId}. Revoke a group permission on a database */\n    \"revokeGroupPermission\"(args: {\n      \"databaseId\": string | number;\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `databases.revokePermission` — DELETE /databases/{databaseId}/permissions/{userId}. Remove a user's database permission */\n    \"revokePermission\"(args: {\n      \"databaseId\": string | number;\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `databases.runOperation` — POST /databases/{databaseId}/operations/{name}/run. Run a database operation under a server function's grants */\n    \"runOperation\"(args: {\n      \"databaseId\": string | number;\n      \"name\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `databases.transferOwnership` — POST /databases/{databaseId}/permissions/transfer. Transfer database ownership */\n    \"transferOwnership\"(args: {\n      \"databaseId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.update` — PATCH /databases/{databaseId}. Update a database */\n    \"update\"(args: {\n      \"databaseId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `databases.updateMetadata` — PATCH /databases/{databaseId}/metadata. Update database metadata */\n    \"updateMetadata\"(args: {\n      \"databaseId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"documents\": {\n    /** `documents.addTag` — POST /documents/{documentId}/tags. Add a tag to a document */\n    \"addTag\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    \"aliases\": {\n      /** `documents.aliases.delete` — DELETE /document-aliases/{scope}/{aliasKey}. Delete a (scope, aliasKey) document alias binding */\n      \"delete\"(args: {\n        \"scope\": string | number;\n        \"aliasKey\": string | number;\n      }): Promise<any>;\n      /** `documents.aliases.listForDocument` — GET /documents/{documentId}/aliases. List aliases bound to a document */\n      \"listForDocument\"(args: {\n        \"documentId\": string | number;\n      }): Promise<any>;\n      /** `documents.aliases.resolve` — GET /document-aliases/{scope}/{aliasKey}. Resolve the document bound to a (scope, aliasKey) alias */\n      \"resolve\"(args: {\n        \"scope\": string | number;\n        \"aliasKey\": string | number;\n      }): Promise<any>;\n      /** `documents.aliases.set` — PUT /document-aliases/{scope}/{aliasKey}. Bind a (scope, aliasKey) alias to a document */\n      \"set\"(args: {\n        \"scope\": string | number;\n        \"aliasKey\": string | number;\n        body: unknown;\n      }): Promise<any>;\n    };\n    /** `documents.approveAccessRequest` — POST /documents/{documentId}/access-requests/{requestId}/approve. Approve a document access request */\n    \"approveAccessRequest\"(args: {\n      \"documentId\": string | number;\n      \"requestId\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    \"blobs\": {\n      /** `documents.blobs.delete` — DELETE /documents/{documentId}/blobs/{blobId}. Delete a document blob */\n      \"delete\"(args: {\n        \"documentId\": string | number;\n        \"blobId\": string | number;\n      }): Promise<any>;\n      /** `documents.blobs.downloadHeaders` — HEAD /documents/{documentId}/blobs/{blobId}/download. Get document blob download headers (ETag/304 support) */\n      \"downloadHeaders\"(args: {\n        \"documentId\": string | number;\n        \"blobId\": string | number;\n      }): Promise<HeaderResult>;\n      /** `documents.blobs.downloadUrl` — GET /documents/{documentId}/blobs/{blobId}/download. Download a document blob's bytes */\n      \"downloadUrl\"(args: {\n        \"documentId\": string | number;\n        \"blobId\": string | number;\n        \"disposition\"?: string | number | boolean;\n      }): Promise<Uint8Array>;\n      /** `documents.blobs.get` — GET /documents/{documentId}/blobs/{blobId}. Get a document blob's metadata */\n      \"get\"(args: {\n        \"documentId\": string | number;\n        \"blobId\": string | number;\n      }): Promise<any>;\n      /** `documents.blobs.list` — GET /documents/{documentId}/blobs. List blobs attached to a document */\n      \"list\"(args: {\n        \"documentId\": string | number;\n      }): Promise<any>;\n      /** `documents.blobs.upload` — PUT /documents/{documentId}/blobs/{blobId}. Upload a document blob with a client-specified id (immutable + idempotent) */\n      \"upload\"(args: {\n        \"documentId\": string | number;\n        \"blobId\": string | number;\n        \"X-Blob-Filename\": string | number;\n        \"X-Blob-Size\": string | number;\n        \"X-Blob-Sha256\": string | number;\n        body: ArrayBuffer | Uint8Array | string;\n      }): Promise<any>;\n      /** `documents.blobs.uploadWithoutId` — PUT /documents/{documentId}/blobs. Deprecated: upload a document blob without a client-specified id */\n      \"uploadWithoutId\"(args: {\n        \"documentId\": string | number;\n      }): Promise<any>;\n    };\n    /** `documents.clearLinkAccess` — DELETE /documents/{documentId}/link-access. Turn off the document's link access */\n    \"clearLinkAccess\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.create` — POST /documents. Create a new document */\n    \"create\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.createWithAlias` — POST /documents/create-with-alias. Create a document and bind it to an alias */\n    \"createWithAlias\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.debugDumpUpdates` — POST /documents/{documentId}/debug/dump-updates. Dump a document's raw CRDT update log (debug) */\n    \"debugDumpUpdates\"(args: {\n      \"documentId\": string | number;\n      \"limit\"?: string | number | boolean;\n      \"offset\"?: string | number | boolean;\n      \"includeData\"?: string | number | boolean;\n      \"includeR2Data\"?: string | number | boolean;\n      body?: unknown;\n    }): Promise<any>;\n    /** `documents.debugMerge` — POST /documents/{documentId}/debug/merge. Force-merge a document's pending updates (debug) */\n    \"debugMerge\"(args: {\n      \"documentId\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `documents.debugMergeBlock` — POST /documents/{documentId}/debug/merge-block. Merge a specific update block of a document (debug) */\n    \"debugMergeBlock\"(args: {\n      \"documentId\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `documents.debugRestore` — POST /documents/debug/restore. Restore a document from a prior state snapshot (debug) */\n    \"debugRestore\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.debugStats` — GET /documents/{documentId}/debug/stats. Get document storage/update stats (debug) */\n    \"debugStats\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.delete` — DELETE /documents/{documentId}. Delete a document */\n    \"delete\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.denyAccessRequest` — POST /documents/{documentId}/access-requests/{requestId}/deny. Deny a document access request */\n    \"denyAccessRequest\"(args: {\n      \"documentId\": string | number;\n      \"requestId\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `documents.exportChain` — GET /documents/{documentId}/export/chain. Export chain of a large document (snapshot + sealed overlays + open epoch) */\n    \"exportChain\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.exportState` — GET /documents/{documentId}/export/state. Export a document's encoded CRDT state */\n    \"exportState\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.get` — GET /documents/{documentId}. Get a single document by id */\n    \"get\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.getImportChainStatus` — GET /documents/{documentId}/import/chain. How far a large document's chain import has got */\n    \"getImportChainStatus\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.getLinkAccess` — GET /documents/{documentId}/link-access. Get the document's \"anyone with the link\" access level */\n    \"getLinkAccess\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.getOrCreateWithAlias` — POST /documents/get-or-create-with-alias. Get the document bound to an alias, creating it if absent (idempotent) */\n    \"getOrCreateWithAlias\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.getPermissions` — GET /documents/{documentId}/permissions. List a document's user permissions */\n    \"getPermissions\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.getSchema` — GET /documents/{documentId}/schema. Introspect a document's model schema */\n    \"getSchema\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.getStats` — GET /documents/{documentId}/stats. Document statistics (record/model/blob counts, approximate size) */\n    \"getStats\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.grantGroupPermission` — POST /documents/{documentId}/group-permissions. Grant a group permission on a document */\n    \"grantGroupPermission\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.importChain` — POST /documents/{documentId}/import/chain. Install an uploaded chain into a large document */\n    \"importChain\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.importChainArtifact` — POST /documents/{documentId}/import/chain/artifact. Upload one artifact of a large document's import chain */\n    \"importChainArtifact\"(args: {\n      \"documentId\": string | number;\n      \"kind\"?: string | number | boolean;\n      \"epoch\"?: string | number | boolean;\n      \"buildId\"?: string | number | boolean;\n      \"model\"?: string | number | boolean;\n      \"index\"?: string | number | boolean;\n      body: ArrayBuffer | Uint8Array | string;\n    }): Promise<any>;\n    /** `documents.importState` — POST /documents/{documentId}/import/state. Import encoded CRDT state into a document */\n    \"importState\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.listAccessRequests` — GET /documents/{documentId}/access-requests. List access requests for a document */\n    \"listAccessRequests\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.listGroupPermissions` — GET /documents/{documentId}/group-permissions. List a document's group permissions */\n    \"listGroupPermissions\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.listPendingInvitations` — GET /documents/{documentId}/pending-invitations. List a document's pending (deferred) invitations */\n    \"listPendingInvitations\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n    /** `documents.open` — POST /documents/open. Open a document for collaboration (resolves access + alias) */\n    \"open\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    \"records\": {\n      /** `documents.records.aggregate` — POST /documents/{documentId}/records/{model}/aggregate. Aggregate records in a document model (count/sum/avg/min/max, optional grouping) */\n      \"aggregate\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `documents.records.bulk` — POST /documents/{documentId}/records/bulk. Apply an atomic multi-model record blob to a document (create/patch/delete) */\n      \"bulk\"(args: {\n        \"documentId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `documents.records.count` — GET /documents/{documentId}/records/{model}/count. Count records in a document model */\n      \"count\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        \"filter\"?: Record<string, unknown> | string;\n      }): Promise<any>;\n      /** `documents.records.delete` — DELETE /documents/{documentId}/records/{model}/{recordId}. Delete a record from a document model */\n      \"delete\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        \"recordId\": string | number;\n      }): Promise<any>;\n      /** `documents.records.patch` — PATCH /documents/{documentId}/records/{model}/{recordId}. Merge fields into an existing record in a document model */\n      \"patch\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        \"recordId\": string | number;\n        body: unknown;\n      }): Promise<any>;\n      /** `documents.records.query` — GET /documents/{documentId}/records/{model}. Query records in a document model */\n      \"query\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        \"limit\"?: string | number | boolean;\n        \"cursor\"?: string | number | boolean;\n        \"filter\"?: Record<string, unknown> | string;\n      }): Promise<any>;\n      /** `documents.records.save` — POST /documents/{documentId}/records/{model}. Create or replace a record in a document model */\n      \"save\"(args: {\n        \"documentId\": string | number;\n        \"model\": string | number;\n        body: unknown;\n      }): Promise<any>;\n    };\n    /** `documents.removePermissionByEmail` — DELETE /documents/{documentId}/permissions. Revoke a user's permission on a document by email (?email=) */\n    \"removePermissionByEmail\"(args: {\n      \"documentId\": string | number;\n      \"email\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `documents.removePermissionByUserId` — DELETE /documents/{documentId}/permissions/{userId}. Revoke a user's permission on a document by user id */\n    \"removePermissionByUserId\"(args: {\n      \"documentId\": string | number;\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `documents.removeTag` — DELETE /documents/{documentId}/tags/{tag}. Remove a tag from a document */\n    \"removeTag\"(args: {\n      \"documentId\": string | number;\n      \"tag\": string | number;\n    }): Promise<any>;\n    /** `documents.requestAccess` — POST /documents/{documentId}/access-requests. Request access to a document */\n    \"requestAccess\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.revokeGroupPermission` — DELETE /documents/{documentId}/group-permissions/{groupType}/{groupId}. Revoke a group permission on a document */\n    \"revokeGroupPermission\"(args: {\n      \"documentId\": string | number;\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `documents.setLinkAccess` — PUT /documents/{documentId}/link-access. Set the document's \"anyone with the link\" access level */\n    \"setLinkAccess\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.transferOwnership` — POST /documents/{documentId}/permissions/transfer. Transfer ownership of a document to another user */\n    \"transferOwnership\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.update` — PUT /documents/{documentId}. Update a document's metadata */\n    \"update\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.updatePermissions` — PUT /documents/{documentId}/permissions. Grant or update a user's permission on a document */\n    \"updatePermissions\"(args: {\n      \"documentId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `documents.validateAccess` — POST /documents/{documentId}/validate-access. Resolve the caller's effective access level for a document */\n    \"validateAccess\"(args: {\n      \"documentId\": string | number;\n    }): Promise<any>;\n  };\n  \"email\": {\n    /** `email.send` — POST /emails/send. Send an application email under a server function's grant */\n    \"send\"(args: {\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"functions\": {\n    /** `functions.invoke` — POST /functions/{functionKey}. Invoke a server function: a synchronous one returns its result, a durable one starts a run */\n    \"invoke\"(args: {\n      \"functionKey\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n  };\n  \"gemini\": {\n    /** `gemini.countTokens` — POST /gemini/count-tokens. Count tokens for a Gemini request */\n    \"countTokens\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `gemini.generate` — POST /gemini/generate. Generate content with Gemini */\n    \"generate\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `gemini.generateRaw` — POST /gemini/generate-raw. Generate content with Gemini (raw passthrough) */\n    \"generateRaw\"(args: {\n      \"model\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n    /** `gemini.models` — GET /gemini/models. List available Gemini models */\n    \"models\"(args?: Record<string, never>): Promise<any>;\n  };\n  \"groups\": {\n    /** `groups.addMember` — POST /groups/{groupType}/{groupId}/members. Add a member to a group */\n    \"addMember\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `groups.create` — POST /groups. Create a group */\n    \"create\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `groups.delete` — DELETE /groups/{groupType}/{groupId}. Delete a group */\n    \"delete\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `groups.get` — GET /groups/{groupType}/{groupId}. Get a group by type and id */\n    \"get\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `groups.list` — GET /groups. List groups */\n    \"list\"(args?: {\n      \"type\"?: string | number | boolean;\n      \"includeSystem\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `groups.listDatabases` — GET /groups/{groupType}/{groupId}/databases. List databases shared with a group */\n    \"listDatabases\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `groups.listDocuments` — GET /groups/{groupType}/{groupId}/documents. List documents shared with a group */\n    \"listDocuments\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `groups.listMembers` — GET /groups/{groupType}/{groupId}/members. List a group's members */\n    \"listMembers\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n      \"include\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `groups.listPendingInvitations` — GET /groups/{groupType}/{groupId}/pending-invitations. List a group's pending invitations */\n    \"listPendingInvitations\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n    }): Promise<any>;\n    /** `groups.listUserMemberships` — GET /users/{userId}/memberships. List a user's group memberships */\n    \"listUserMemberships\"(args: {\n      \"userId\": string | number;\n      \"includeSystem\"?: string | number | boolean;\n      \"type\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `groups.removeMember` — DELETE /groups/{groupType}/{groupId}/members/{userId}. Remove a specific member from a group */\n    \"removeMember\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `groups.removeMemberByEmail` — DELETE /groups/{groupType}/{groupId}/members. Remove a group member or pending invitation by email */\n    \"removeMemberByEmail\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n      \"email\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `groups.update` — PATCH /groups/{groupType}/{groupId}. Update a group */\n    \"update\"(args: {\n      \"groupType\": string | number;\n      \"groupId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"integrations\": {\n    /** `integrations.call` — POST /integrations/{integrationKey}/call. Call an integration under a server function's grants */\n    \"call\"(args: {\n      \"integrationKey\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n    /** `integrations.list` — GET /integrations. List integrations configured for the app */\n    \"list\"(args?: Record<string, never>): Promise<any>;\n    /** `integrations.proxy` — POST /integrations/{integrationKey}/proxy. Proxy a request through a configured integration */\n    \"proxy\"(args: {\n      \"integrationKey\": string | number;\n    }): Promise<any>;\n  };\n  \"iterations\": {\n    /** `iterations.get` — GET /iterations/{iterationName}. Get details for a single iteration */\n    \"get\"(args: {\n      \"iterationName\": string | number;\n    }): Promise<any>;\n    /** `iterations.list` — GET /iterations. List iteration runs */\n    \"list\"(args?: Record<string, never>): Promise<any>;\n    /** `iterations.reset` — POST /iterations/{iterationName}/reset. Reset a terminal iteration so the next trigger runs fresh */\n    \"reset\"(args: {\n      \"iterationName\": string | number;\n    }): Promise<any>;\n  };\n  \"llm\": {\n    /** `llm.chat` — POST /llm/chat. Run an LLM chat completion */\n    \"chat\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `llm.models` — GET /llm/models. List available LLM models */\n    \"models\"(args?: Record<string, never>): Promise<any>;\n  };\n  \"locks\": {\n    /** `locks.list` — GET /locks. List all currently-held named locks in the app */\n    \"list\"(args?: Record<string, never>): Promise<any>;\n    /** `locks.release` — POST /locks/release. Release a held named lock (requires the acquire handle) */\n    \"release\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `locks.renew` — POST /locks/renew. Extend the lease on a held named lock */\n    \"renew\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `locks.status` — POST /locks/status. Report the current holder of a named lock */\n    \"status\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `locks.tryAcquire` — POST /locks/acquire. Attempt to acquire a named lock (single non-blocking attempt) */\n    \"tryAcquire\"(args: {\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"notifications\": {\n    /** `notifications.list` — GET /notifications. List the caller's in-app notification inbox (newest first) */\n    \"list\"(args?: {\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `notifications.listDevices` — GET /me/push-tokens. List the caller's registered push devices */\n    \"listDevices\"(args?: Record<string, never>): Promise<any>;\n    /** `notifications.markAllRead` — POST /notifications/read-all. Mark all of the caller's notifications as read */\n    \"markAllRead\"(args?: Record<string, never>): Promise<any>;\n    /** `notifications.markRead` — PATCH /notifications/{notificationId}/read. Mark one of the caller's notifications as read */\n    \"markRead\"(args: {\n      \"notificationId\": string | number;\n    }): Promise<any>;\n    /** `notifications.registerDevice` — POST /me/push-tokens. Register (upsert) the caller's device push token */\n    \"registerDevice\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `notifications.send` — POST /notifications/send. Send a notification to an app user (durable in-app inbox row + live WS frame) */\n    \"send\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `notifications.unreadCount` — GET /notifications/unread-count. Count the caller's unread notifications */\n    \"unreadCount\"(args?: Record<string, never>): Promise<any>;\n    /** `notifications.unregisterDevice` — DELETE /me/push-tokens/{token}. Unregister one of the caller's device push tokens */\n    \"unregisterDevice\"(args: {\n      \"token\": string | number;\n    }): Promise<any>;\n  };\n  \"prompts\": {\n    /** `prompts.execute` — POST /prompts/{promptKey}/execute. Execute a saved prompt */\n    \"execute\"(args: {\n      \"promptKey\": string | number;\n    }): Promise<any>;\n    /** `prompts.run` — POST /prompts/{promptKey}/run. Run a prompt under a server function's grants */\n    \"run\"(args: {\n      \"promptKey\": string | number;\n      body?: unknown;\n    }): Promise<any>;\n  };\n  \"resourceMetadata\": {\n    /** `resourceMetadata.delete` — DELETE /resources/{resourceType}/{resourceId}/metadata/{category}. Delete a resource's metadata for a category (idempotent) */\n    \"delete\"(args: {\n      \"resourceType\": string | number;\n      \"resourceId\": string | number;\n      \"category\": string | number;\n    }): Promise<any>;\n    /** `resourceMetadata.get` — GET /resources/{resourceType}/{resourceId}/metadata/{category}. Read a resource's metadata for a category */\n    \"get\"(args: {\n      \"resourceType\": string | number;\n      \"resourceId\": string | number;\n      \"category\": string | number;\n    }): Promise<any>;\n    /** `resourceMetadata.getBatch` — POST /resources/metadata/batch. Batch-read resource metadata (partial success) */\n    \"getBatch\"(args: {\n      \"debug\"?: string | number | boolean;\n      body: unknown;\n    }): Promise<any>;\n    /** `resourceMetadata.list` — GET /resources/{resourceType}/{resourceId}/metadata. List all metadata categories on a resource */\n    \"list\"(args: {\n      \"resourceType\": string | number;\n      \"resourceId\": string | number;\n    }): Promise<any>;\n    /** `resourceMetadata.resolve` — POST /metadata/resolve. Resolve a resource by a category's unique metadata value */\n    \"resolve\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `resourceMetadata.set` — PUT /resources/{resourceType}/{resourceId}/metadata/{category}. Write a resource's metadata for a category */\n    \"set\"(args: {\n      \"resourceType\": string | number;\n      \"resourceId\": string | number;\n      \"category\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n  \"secrets\": {\n    /** `secrets.get` — GET /secrets/{name}. Read an app secret under a server function's grants */\n    \"get\"(args: {\n      \"name\": string | number;\n    }): Promise<any>;\n  };\n  \"users\": {\n    /** `users.getBasic` — GET /users/{userId}/basic. Get a user's basic public profile */\n    \"getBasic\"(args: {\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `users.getProfiles` — POST /users/profiles. Look up user profiles in bulk */\n    \"getProfiles\"(args: {\n      body: unknown;\n    }): Promise<any>;\n    /** `users.list` — GET /users. List app users */\n    \"list\"(args?: {\n      \"email\"?: string | number | boolean;\n      \"userId\"?: string | number | boolean;\n      \"name\"?: string | number | boolean;\n      \"limit\"?: string | number | boolean;\n      \"cursor\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `users.lookup` — GET /users/lookup. Look up a user by identifier */\n    \"lookup\"(args?: {\n      \"email\"?: string | number | boolean;\n    }): Promise<any>;\n    /** `users.remove` — DELETE /users/{userId}. Remove a user from the app */\n    \"remove\"(args: {\n      \"userId\": string | number;\n    }): Promise<any>;\n    /** `users.send` — POST /users/{userId}/send. Send a realtime message to a member of this app */\n    \"send\"(args: {\n      \"userId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n    /** `users.setRole` — PUT /users/{userId}/role. Set a user's app role */\n    \"setRole\"(args: {\n      \"userId\": string | number;\n      body: unknown;\n    }): Promise<any>;\n  };\n}\n\n/**\n * The app's database types, model by model — EMPTY here and filled by the\n * declaration `primitive config push` writes into the config tree's\n * `functions/` directory (#3182). A tree that has pushed once therefore types\n * `ctx.db` against its own schemas; one that has not gets the open form and\n * still compiles.\n */\nexport interface DatabaseSchemas {}\n\n/**\n * The type keys `ctx.db` accepts.\n *\n * Every key the augmentation declares, and NOTHING else, once a tree has\n * pushed: naming a type the app does not have is a compile error. Before that\n * — an unaugmented tree, a function written before the first push —\n * `DatabaseSchemas` is empty and `keyof` it is `never`, which would make the\n * argument unwritable rather than open. So the empty case widens to `string`\n * and the handle is untyped instead of unusable.\n */\nexport type DatabaseTypeKeys = [keyof DatabaseSchemas] extends [never]\n  ? string\n  : keyof DatabaseSchemas & string;\n\n/** A model's row shape, or an open record for a type with no schema. */\nexport type DatabaseModels<K extends string> = K extends keyof DatabaseSchemas\n  ? DatabaseSchemas[K]\n  : Record<string, Record<string, unknown>>;\n\n/**\n * The model names one database type addresses — its own, or any name at all\n * for a type that declares no schema (the DO is schemaless, so a grant on such\n * a type is legal and there is simply nothing to narrow to).\n */\nexport type DatabaseModelNames<TModels> = [keyof TModels] extends [never]\n  ? string\n  : keyof TModels & string;\n\n/** One model's row shape, open when the type declares no schema. */\nexport type DatabaseModelRow<TModels, M extends string> =\n  M extends keyof TModels ? TModels[M] : Record<string, unknown>;\n\n/**\n * One model of one database, scoped: the `modelName` every records call needs\n * is bound once, so a call names an operation and its own arguments.\n *\n * Filters and options are ordinary objects. Inline filter typing arrives with\n * unified schemas — the intent's decision, not an omission — so what is typed\n * today is the model name and the row shape a read hands back.\n */\nexport type ModelScopedBody<TBody = Record<string, unknown>> = TBody & {\n  /**\n   * Bound by the handle. Reserved so a body cannot look like a second way to\n   * choose a model: the runtime assigns the handle's own model last, and a row\n   * type that said otherwise would be a lie about what came back.\n   */\n  modelName?: never;\n};\n\n/**\n * One write inside a model-scoped batch. Every batch verb is a write, so a\n * batch on a model needs that model's write grant whatever the ops are.\n */\nexport type ModelBatchOperation<TRow> = {\n  op: \"save\" | \"patch\" | \"delete\" | \"increment\" | \"addToSet\" | \"removeFromSet\";\n  id?: string;\n  data?: Partial<TRow>;\n  /** Bound by the handle, for the same reason every other call's is. */\n  modelName?: never;\n  [key: string]: unknown;\n};\n\nexport interface DatabaseModelHandle<TRow> {\n  query(body?: ModelScopedBody): Promise<{ data: TRow[]; hasMore?: boolean; nextCursor?: string }>;\n  count(body?: ModelScopedBody): Promise<any>;\n  aggregate(body: ModelScopedBody): Promise<any>;\n  save(body: ModelScopedBody<{ id?: string; data: Partial<TRow>; [key: string]: unknown }>): Promise<any>;\n  /** Several writes to THIS model in one request; the binding is per item. */\n  batch(body: {\n    operations: Array<ModelBatchOperation<TRow>>;\n    atomic?: boolean;\n  }): Promise<any>;\n}\n\n/** One database, typed by the database TYPE key its grant names. */\nexport interface DatabaseHandle<TModels> {\n  /** The database this handle addresses — part of every query cache key. */\n  databaseId: string;\n  /** The type key this handle was opened with. */\n  databaseType: string;\n  model<M extends DatabaseModelNames<TModels>>(\n    modelName: M\n  ): DatabaseModelHandle<DatabaseModelRow<TModels, M>>;\n  /**\n   * A batch may also SPAN models, and then it names each one itself — the\n   * model-scoped form above is the typed way to write the common case.\n   */\n  batch(body: {\n    operations: Array<Record<string, unknown>>;\n    atomic?: boolean;\n  }): Promise<any>;\n  /** Run one of the database type's prepared operations under this function's grants. */\n  runOperation(name: string, params?: Record<string, unknown>): Promise<any>;\n}\n\n/**\n * One call through a granted integration — #3183.\n *\n * `path` is RELATIVE to the integration's `baseUrl`, and the host is the\n * integration's: the platform resolves and normalizes the path before checking\n * it against `allowedPaths`, so a protocol-relative path or a `..` segment is\n * refused rather than silently sending the request somewhere else.\n */\nexport interface IntegrationCallRequest {\n  /** Must be in the integration's `allowedMethods`. Defaults to its own default. */\n  method?: string;\n  /** Relative to the integration's `baseUrl`. */\n  path?: string;\n  query?: Record<string, unknown>;\n  headers?: Record<string, string>;\n  body?: unknown;\n  /** form-urlencoded body; not combinable with `body`. */\n  form?: Record<string, unknown>;\n  bodyMode?: \"json\" | \"raw\" | \"multipart\";\n}\n\n/** What the upstream answered, as the platform saw it. */\nexport interface IntegrationCallResult {\n  status: number;\n  headers: Record<string, string>;\n  body: unknown;\n  durationMs: number;\n  traceId: string;\n  /** Set when the platform or the upstream refused; absent on success. */\n  errorCode?: string;\n}\n\n/** What a prompt run is given — the member execute route's own body. */\nexport interface PromptRunArgs {\n  variables?: Record<string, unknown>;\n  /** Run against a different model for this call only. */\n  modelOverride?: string;\n  /** Pin a specific config OF THIS PROMPT; defaults to its active one. */\n  configId?: string;\n}\n\n/** The member execute envelope, unchanged on the function path. */\nexport interface PromptRunResult {\n  success: boolean;\n  output: string;\n  error?: string | null;\n  metrics?: Record<string, unknown>;\n  configId: string;\n}\n\n/** What a send delivered to. */\nexport interface SendResult {\n  /** Unique live connections the frame was sent to. Zero is a success. */\n  connections: number;\n  /** True when the per-user connection ceiling stopped the fanout. */\n  truncated: boolean;\n}\n\n/** Who a channel grant is for, and for how long — #3184. */\nexport interface ChannelAuthorizeOptions {\n  /**\n   * The member the grant names. Caller mode defaults to the invoking caller;\n   * system mode has no caller and must say.\n   */\n  userId?: string;\n  /** Default 300 s, clamped to the platform ceiling of 900 s. */\n  ttlSeconds?: number;\n}\n\n/** The credential a client presents on the WebSocket it already has. */\nexport interface ChannelGrantResult {\n  channel: string;\n  /** The signed grant. Hand it to the client; it is not readable here. */\n  grant: string;\n  /** Epoch milliseconds. Expiry is the only revocation a channel has. */\n  expiresAt: number;\n}\n\nexport interface FunctionContext {\n  /** The HTTP caller, or null for a webhook, cron or database-change fire. */\n  user: FunctionUser | null;\n  trigger: FunctionTrigger;\n  api: FunctionApi;\n  /**\n   * A typed handle over one database. The second argument is the database TYPE\n   * key — the same key a `database:<type>/<model>:read|write` grant names —\n   * and it is what selects the models this handle knows (#3182).\n   */\n  db<K extends DatabaseTypeKeys>(\n    databaseId: string,\n    databaseType: K\n  ): DatabaseHandle<DatabaseModels<K>>;\n  /**\n   * Outbound HTTP, through a granted integration and nowhere else (#3183).\n   *\n   * A function has no raw network access: every `fetch` to a host that is not\n   * the platform answers `FUNCTION_EGRESS_DENIED`, grant or no grant. What an\n   * `integration:<key>` grant buys is this call, which the MAIN WORKER makes on\n   * the function's behalf — which is why the integration's `{{secrets.*}}`\n   * credentials can be injected into the request without ever being visible to\n   * the code that asked for it.\n   */\n  integrations: {\n    call(\n      integrationKey: string,\n      request?: IntegrationCallRequest\n    ): Promise<IntegrationCallResult>;\n  };\n  /**\n   * Run one of the app's prompts, under a `prompt:<key>` grant (#3183).\n   *\n   * The prompt's `accessRule` is not consulted — it states which MEMBERS may\n   * execute the prompt from a client, and the grant is what authorizes this\n   * call. The provider request is bounded by the invocation's own deadline.\n   */\n  prompts: {\n    run(promptKey: string, args?: PromptRunArgs): Promise<PromptRunResult>;\n  };\n  /**\n   * The value of one app secret, under a `secret:<NAME>` grant (#3183).\n   *\n   * Prefer `ctx.integrations.call` when the secret is a credential FOR an\n   * integration: there the value is injected by the platform and never enters\n   * the sandbox at all. This is for the cases an integration cannot express.\n   *\n   * Rejects with `FUNCTION_SECRET_NOT_FOUND` when the grant names a value\n   * this environment has not been given — secrets are provisioned per\n   * environment, out of band from the push.\n   */\n  secret(name: string): Promise<string>;\n  /** The value of one app config var, under a `var:<NAME>` grant (#3183). */\n  configVar(name: string): Promise<string>;\n  /**\n   * Realtime messages to this app's clients, under a `users:send` grant\n   * (#3183).\n   *\n   * The recipient's client receives a `direct.message` frame carrying this\n   * payload and the sending function's key. Presence is not guaranteed: a\n   * member with no live socket answers `{ connections: 0 }` rather than an\n   * error.\n   */\n  users: {\n    send(userId: string, payload: unknown): Promise<SendResult>;\n  };\n  /** The same frame to ONE connection, under a `connections:send` grant. */\n  connections: {\n    send(connectionId: string, payload: unknown): Promise<SendResult>;\n  };\n  /**\n   * Realtime channels, under a `channel:<namespace>` grant that COVERS the\n   * channel — #3184.\n   *\n   * `authorize` hands back a short-lived grant for ONE member to present on\n   * the socket it already has; `publish` delivers a `channel.message` frame to\n   * every connection that has joined and whose grant has not expired. Expiry is\n   * the only revocation, so `expiresAt` comes back for the client to renew\n   * ahead of — a renewal is another authorize and another subscribe.\n   */\n  channels: {\n    authorize(\n      channel: string,\n      options?: ChannelAuthorizeOptions\n    ): Promise<ChannelGrantResult>;\n    publish(channel: string, payload: unknown): Promise<SendResult>;\n  };\n}\n\n/**\n * The durable step handle — Cloudflare Workflows' `WorkflowStep`, forwarded\n * untouched, so `step.do` results are memoized and `step.sleep` hibernates.\n *\n * A SYNCHRONOUS invocation gets a passthrough shim of the same shape, so a body\n * written for durable mode runs either way: `do` executes the body (nothing to\n * memoize into without an engine), `sleep` resolves immediately (the sync\n * ceiling is seconds), and `waitForEvent` throws `STEP_NOT_AVAILABLE`.\n */\nexport interface FunctionStep {\n  do<T>(name: string, body: () => T | Promise<T>): Promise<T>;\n  do<T>(\n    name: string,\n    config: Record<string, unknown>,\n    body: () => T | Promise<T>\n  ): Promise<T>;\n  sleep(name: string, duration: number | string): Promise<void>;\n  sleepUntil(name: string, timestamp: Date | number): Promise<void>;\n  waitForEvent<T = unknown>(\n    name: string,\n    options: Record<string, unknown>\n  ): Promise<T>;\n}\n\nexport declare const SDK_STUB_VERSION: string;\n\n/**\n * Declare a server function's handler.\n *\n * Both authoring styles reach the platform bootstrap identically — a plain\n * default export taking `(input, ctx, step)` runs exactly as a wrapped one\n * does — so this is a typing and intent marker, not a different calling\n * convention.\n *\n * `step` is the third argument in BOTH modes (#3186). A durable run gets the\n * engine's live `WorkflowStep`; a synchronous one gets a passthrough shim\n * (`do` runs the body, `sleep` resolves at once, `waitForEvent` throws a\n * named error), so a durable-authored body can be exercised synchronously.\n */\nexport declare function defineFunction<TInput = unknown, TOutput = unknown>(\n  handler: (\n    input: TInput,\n    ctx: FunctionContext,\n    step: FunctionStep\n  ) => TOutput | Promise<TOutput>\n): (\n  input: TInput,\n  ctx: FunctionContext,\n  step: FunctionStep\n) => Promise<TOutput>;\n\n/**\n * One declared parameter of a registered query.\n *\n * `caller: true` (or `type: \"$caller\"`) is the intent's IMMUTABLE binding:\n * the platform injects the invocation's user and refuses a call that supplies\n * the parameter itself.\n */\nexport interface QueryParamSpec {\n  type?: \"string\" | \"number\" | \"boolean\" | \"any\" | \"$caller\";\n  caller?: boolean;\n  optional?: boolean;\n  default?: unknown;\n}\n\nexport interface QueryDefinition<TDb, TParams, TResult> {\n  /** The models this query touches. Caching is off unless the run matches. */\n  models: string[];\n  params?: Record<string, QueryParamSpec>;\n  /**\n   * Cache the answer for `ttlMs` — capped by the platform, and applied ONLY\n   * when the run is verified: every model the body touched was declared, and\n   * no prepared operation was used. A write through the handle drops the\n   * entries that read the written model.\n   */\n  cache?: { ttlMs: number };\n  run: (db: TDb, params: TParams) => TResult | Promise<TResult>;\n}\n\n/**\n * Register a named query over a database handle (#3187).\n *\n * A registration helper, not a language: `run` is ordinary code over the same\n * typed handle, and what registration adds is a name, declared parameters\n * (validated, coerced and defaulted), the `$caller` binding, and a cache the\n * platform may use when it can verify what the run touched.\n *\n * Register at MODULE scope: a registration made inside the handler still works\n * for direct calls but is invisible to `config push`'s manifest.\n */\nexport declare function defineQuery<\n  TDb = DatabaseHandle<any>,\n  TParams = Record<string, any>,\n  TResult = any\n>(\n  name: string,\n  definition: QueryDefinition<TDb, TParams, TResult>\n): (db: TDb, params?: Record<string, unknown>) => Promise<TResult>;\n\n/** The same, for a registration that writes. A mutation is never cached. */\nexport declare function defineMutation<\n  TDb = DatabaseHandle<any>,\n  TParams = Record<string, any>,\n  TResult = any\n>(\n  name: string,\n  definition: QueryDefinition<TDb, TParams, TResult>\n): (db: TDb, params?: Record<string, unknown>) => Promise<TResult>;\n\n/** The platform's cap on a registered query's cache TTL, in milliseconds. */\nexport declare const MAX_QUERY_CACHE_TTL_MS: number;\n\n/**\n * Map over items with BOUNDED concurrency (#3187). Results come back in the\n * input's order; the first rejection wins and nothing new is started after it.\n *\n * The bound matters inside a sandbox: an unbounded fan-out over a page of rows\n * spends the whole subrequest ceiling in one line.\n */\nexport declare function pMap<T, R>(\n  items: Iterable<T>,\n  mapper: (item: T, index: number) => R | Promise<R>,\n  options?: { concurrency?: number }\n): Promise<R[]>;\n\n/** The default concurrency `pMap` applies when none is given. */\nexport declare const PMAP_DEFAULT_CONCURRENCY: number;\n\n/**\n * A time-ordered ULID.\n *\n * GENERATE IT INSIDE `step.do`. A durable run re-executes its handler on\n * every resume and memoizes only what a step returned, so an id minted at the\n * top of a handler is a different id after a sleep — and whatever it was\n * written into is orphaned.\n */\nexport declare function ulid(): string;\n\n/** One family's durable `step.do` configuration. */\nexport interface StepPolicy {\n  retries: { limit: number; delay: string; backoff: string };\n  timeout: string;\n}\n\n/**\n * The per-family step policies the DSL runners use, generated from their own\n * timeout module (#3187):\n *\n *   await step.do(\"send-receipt\", stepPolicy.email, () =>\n *     ctx.api.email.send({ body: { to, subject, htmlBody } }));\n *\n * `retries: 0` on email and the AI families is deliberate — a retried timeout\n * would send the same email twice or bill the same generation twice.\n */\nexport declare const stepPolicy: {\n  email: StepPolicy;\n  llm: StepPolicy;\n  gemini: StepPolicy;\n  database: StepPolicy;\n};\n\ndeclare const _default: {\n  SDK_STUB_VERSION: string;\n  defineFunction: typeof defineFunction;\n  defineQuery: typeof defineQuery;\n  defineMutation: typeof defineMutation;\n  pMap: typeof pMap;\n  ulid: typeof ulid;\n};\nexport default _default;\n";
+//# sourceMappingURL=generated-sdk-types.js.map

package/dist/src/lib/generated-sdk-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-sdk-types.js","sourceRoot":"","sources":["../../../src/lib/generated-sdk-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,0h5EAA0h5E,CAAC"}

package/dist/src/lib/init-adopt.js

@@ -9,14 +9,14 @@
  */
 import { join } from "path";
 import { readLocalSelection, selectEnvironmentName } from "./env-resolver-core.js";
-import { PROJECT_CONFIG_DIR, PROJECT_CONFIG_FILENAME, loadProjectConfigFromPath, } from "./project-config.js";
+import { PROJECT_TREE_DIR, PROJECT_CONFIG_FILENAME, loadProjectConfigFromPath, } from "./project-config.js";
 /**
  * Resolves the environment `init` adopts from the project rooted at `root`.
  * Throws whatever the loader or the selector throws — a broken or ambiguous
  * project config must stop the run, not be guessed around.
  */
 export function resolveAdoptedEnvironment(root, options = {}) {
-    const projectConfigPath = join(root, PROJECT_CONFIG_DIR, PROJECT_CONFIG_FILENAME);
+    const projectConfigPath = join(root, PROJECT_TREE_DIR, PROJECT_CONFIG_FILENAME);
     const projectConfig = loadProjectConfigFromPath(projectConfigPath);
     const { name } = selectEnvironmentName(projectConfig, {
         explicitEnvName: options.explicitEnvName ?? null,

package/dist/src/lib/init-adopt.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-adopt.js","sourceRoot":"","sources":["../../../src/lib/init-adopt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,GAG1B,MAAM,qBAAqB,CAAC;AAS7B;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAY,EACZ,UAA2E,EAAE;IAE7E,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,uBAAuB,CAAC,CAAC;IAClF,MAAM,aAAa,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;IACnE,MAAM,EAAE,IAAI,EAAE,GAAG,qBAAqB,CAAC,aAAoB,EAAE;QAC3D,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;QAChD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,cAAc,EAAE,kBAAkB,CAAC,iBAAiB,CAAC;QACrD,UAAU,EAAE,iBAAiB;KAC9B,CAAC,CAAC;IACH,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC;QACxC,aAAa;QACb,iBAAiB;KAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"init-adopt.js","sourceRoot":"","sources":["../../../src/lib/init-adopt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,GAG1B,MAAM,qBAAqB,CAAC;AAS7B;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAY,EACZ,UAA2E,EAAE;IAE7E,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;IAChF,MAAM,aAAa,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;IACnE,MAAM,EAAE,IAAI,EAAE,GAAG,qBAAqB,CAAC,aAAoB,EAAE;QAC3D,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;QAChD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,cAAc,EAAE,kBAAkB,CAAC,iBAAiB,CAAC;QACrD,UAAU,EAAE,iBAAiB;KAC9B,CAAC,CAAC;IACH,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC;QACxC,aAAa;QACb,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

package/dist/src/lib/init-assets.js

@@ -56,9 +56,9 @@ file and no root \`package.json\`.
 
 ## Layout
 
-- \`.primitive/config.json\` — the Primitive environments (backend URL + app ID
+- \`primitive/config.json\` — the Primitive environments (backend URL + app ID
   per environment). The single source of truth, for every client.
-- \`.primitive/sync/<env>/<appId>/\` — the exported server config (workflows,
+- \`primitive/<env>/\` — the exported server config (workflows,
   database type configs, app settings) that \`primitive config diff\` and
   \`primitive config push\` read and write.
 - \`models/models.toml\` — the model schema. ONE copy: its keys are the wire
@@ -78,7 +78,7 @@ ${rows}
 
 ## Running commands
 
-Every \`primitive\` command walks up to this directory's \`.primitive/config.json\`,
+Every \`primitive\` command walks up to this directory's \`primitive/config.json\`,
 so it resolves the same app from any client directory and needs no path flag.
 \`primitive env use <name>\` selects the environment every command in this
 repository targets — it is an app-wide selection, not a per-client one.

package/dist/src/lib/init-config.d.ts

@@ -6,7 +6,7 @@ export interface InitConfig {
      *   - `use-existing` — scaffold against an app that already exists (needs `app_id`)
      *   - `add-client`   — add another client to the Primitive app the surrounding
      *     project already targets (#2890). The app comes from the selected
-     *     environment of the nearest ancestor `.primitive/config.json`, so this
+     *     environment of the nearest ancestor `primitive/config.json`, so this
      *     action names no app of its own.
      */
     action: "create" | "use-existing" | "add-client";

package/dist/src/lib/init-ios-links.js

@@ -125,7 +125,7 @@ export function stampCallbackScheme(clientDir, scheme) {
  */
 export function setWebUrlInstruction(origin, indent = "  ") {
     return [
-        `${indent}add "webUrl": "${origin}" to that environment in .primitive/config.json`,
+        `${indent}add "webUrl": "${origin}" to that environment in primitive/config.json`,
         `${indent}(\`primitive env add <name> --api-url … --app-id … --web-url <origin>\` does this only for an`,
         `${indent}environment it CREATES — it cannot edit one that already exists).`,
     ];

package/dist/src/lib/init-ios-links.js.map

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

package/dist/src/lib/init-plan.d.ts

@@ -12,7 +12,7 @@ export interface InitPlan {
     /** The directory holding the ONE `.primitive/` for this app. */
     projectRoot: string;
     /**
-     * Whether this run writes `.primitive/config.json` and seeds the
+     * Whether this run writes `primitive/config.json` and seeds the
      * environment's credential slot. False when adopting: the config is already
      * there and is not this run's to rewrite.
      */

package/dist/src/lib/init-plan.js

@@ -11,7 +11,7 @@
  *   multi-client — several clients, no surrounding project. Each client gets a
  *                  platform-named subdirectory; the project config, the git
  *                  repository and the canonical schema live at the root.
- *   add-client   — an ancestor `.primitive/config.json` already exists. The run
+ *   add-client   — an ancestor `primitive/config.json` already exists. The run
  *                  ADOPTS it: no nested project config, no nested git
  *                  repository, no app creation, no commit. This is the path the
  *                  issue opens with — running init in a subdirectory used to

package/dist/src/lib/init-xcode.d.ts

@@ -18,11 +18,11 @@ export declare function retargetXcodePath(clientDir: string, fromRelative: strin
  */
 export declare function xcodePathsLeftBehind(clientDir: string, fromRelative: string, toRelative: string): string[];
 /**
- * Points the Xcode build phases at the app's `.primitive/config.json` when it
+ * Points the Xcode build phases at the app's `primitive/config.json` when it
  * lives above the client.
  *
  * Without this an Xcode build has no readable config: the phase declares
- * `$(SRCROOT)/.primitive/config.json`, which a composed client does not have,
+ * `$(SRCROOT)/primitive/config.json`, which a composed client does not have,
  * and the sandbox denies everything undeclared. A fresh clone (where
  * `primitive.json` is gitignored) then cannot build at all, and a working copy
  * that still has one keeps whichever environment generated it — so