@protobase/server 0.40.10 → 0.41.1

package/dist/admin-options.d.ts

@@ -59,6 +59,9 @@ export type AdminOptions = {
    * `writes: true` offers `create_record` and `update_record`, through the REST API's access rules, `validate` and write
    * hooks; the person approves each write in their client, and a client that cannot ask is refused.
    * `writes: { resources: ['tasks'] }` offers them on the listed resources only, and refuses a write to any other.
+   * `writes: { rolesWithoutApproval: ['service'] }` lets a user holding one of those roles, such as a service account
+   * with no person present, write without the approval; any other user is still asked. Each must be a role the app's
+   * users can hold.
    * `false`: the host serves its own MCP endpoint at `auth.mcp.path`, in front of this app. This app then answers 404
    * there and needs no `forAudience`, while the OAuth provider's discovery stays.
    */

package/dist/create-admin.js

@@ -23,7 +23,7 @@ import { realtimePath, restPath, storagePath, supabaseFunctionsPath, supabasePat
 import { goTruePath } from "./gotrue/keys.js";
 import { authBasePath } from "./better-auth/auth-base-path.js";
 import { mcpDiscovery } from "./better-auth/mcp/discovery-routes.js";
-import { checkMcpWrites } from "./mcp/mcp-writes.js";
+import { checkMcpWrites, rolesWithoutApproval } from "./mcp/mcp-writes.js";
 import { mcpAuthenticator } from "./mcp/mcp-authenticator.js";
 import { mcpToolContext } from "./mcp/mcp-context.js";
 import { mcpHandler } from "./mcp/mcp-handler.js";
@@ -128,7 +128,7 @@ const createAdmin = ({ resources: appResources, views: appViews = [], pages = []
 	checkRoleLimits(registry, options.roles?.limits ?? []);
 	checkOwnerFields(registry, authenticate.userIdType, auth);
 	const mcpAuthenticate = mcpAuthenticator(authenticate, auth?.mcp, options.mcp);
-	if (options.mcp) checkMcpWrites(registry, options.mcp.writes);
+	if (options.mcp) checkMcpWrites(registry, declaredRoles(auth, options.roles), options.mcp.writes);
 	checkPositionAfter(registry);
 	checkParents(registry);
 	checkPages(pageModels, {
@@ -299,10 +299,11 @@ const createAdmin = ({ resources: appResources, views: appViews = [], pages = []
 	const report = options.onUnhandledError ?? ((error) => console.error(error));
 	if (auth?.mcp && options.mcp === false) closedMcpRoutes(app, auth.mcp.path);
 	else if (auth?.mcp && mcpAuthenticate) {
+		const writes = options.mcp !== false && options.mcp?.writes || false;
 		const tools = mcpTools({
 			db,
 			sql: options.mcp !== false && options.mcp?.sql === true,
-			writes: options.mcp !== false && options.mcp?.writes || false
+			writes
 		});
 		const server = (session) => mcpServer({
 			info: {
@@ -311,7 +312,8 @@ const createAdmin = ({ resources: appResources, views: appViews = [], pages = []
 			},
 			tools: tools(session),
 			context: mcpToolContext(deps, meta, session),
-			report
+			report,
+			rolesWithoutApproval: rolesWithoutApproval(writes)
 		});
 		mcpRoutes(app, {
 			path: auth.mcp.path,

package/dist/index.d.ts

@@ -125,4 +125,7 @@ import { isSchedule } from "./jobs/schedule.js";
 import { DrainResult, JobsRuntime, StartJobsOptions, startJobs } from "./jobs/runtime.js";
 import { jobsDrainApp } from "./jobs/drain-route.js";
 import { checkJobsSchema, jobsSchema, jobsSchemaMigration } from "./jobs/schema.js";
-export { type Admin, type AdminAuth, type AdminOptions, type ApiFunction, type ApiKeys, type ApiKeysOptions, type AppIcons, type AppIdentity, type ApplyOptions, type ApplyResult, type ApprovalAnswer, type ApprovalRequest, type AssistantBackend, type AssistantOptions, type AssistantSettings, type AssistantTool, type AuditEvent, type AuditQueue, type Authenticator, type BetterAuthAuthenticator, type BetterAuthAuthenticatorOptions, type Caller, type CallerOptions, type CapturedRow, type CascadingKey, type ChatMessage, type ChatTextPart, type CheckAiInput, type CleanupEntry, type CleanupReport, type CleanupSchedule, type CoalescedChange, type CommentItem, type CommentUsers, type Completion, type CompletionOptions, type Conversation, type ConversationRecord, type ConversationStore, type ConversationsOptions, type CorsOptions, type CorsOrigins, type CreateAdminInput, type CreateAuthOptions, type DrainResult, type EmailComponent, type EmailOptions, type EmailTemplate, type EncryptionStatus, type EncryptionTools, type EncryptionToolsInput, type EnqueueOptions, type ErrorReporter, type ErrorReportingOptions, type ErrorReportingSettings, type EventData, type EventsOptions, FatalJobError, type FieldApplied, type FieldStatus, type FileCleanupInput, type FileLimits, type FileObject, type FileProvider, type FileRef, type FileStore, type FileVariantObject, type FilesOptions, type FunctionApp, type FunctionCaller, type FunctionContext, type FunctionEnv, type FunctionHandler, type FunctionOptions, type FunctionRecords, type FunctionSocket, type FunctionSource, type HistoryOptions, HttpProblem, type IssueTokenOptions, type JobContext, type JobDefinition, type JobOptions, type JobsRuntime, type JwtOptions, type JwtVerifyOptions, type KeyFunctionContext, type LinkedAccount, type ListParams, type LocalFilesOptions, type MailMessage, type Mailer, type MapLayer, type MapOptions, type MapSettings, type McpGateInput, type McpHandlerInput, type McpRoutesInput, type McpServerInput, type McpToolsInput, type McpWrites, type MemberInput, MissingCredentials, type MobileConfig, ModelError, type ModelSettings, type NewOrganization, type NewUser, type OperatorProvider, type OrganizationRole, type OrganizationsOptions, type PipelineHook, type PlatformSignIn, type PluginOption, type PluginRef, type PngIcon, type ProjectConfig, type ProtectedFunctionOptions, type PublicFunctionContext, type PublicFunctionEnv, type PublicFunctionHandler, type PublicFunctionOptions, type QueryOptions, type QueryResult, type ReadableResources, type ReasoningDetail, type ReasoningEffort, type RebindOption, type RecordKeyInput, type RecordPage, type RenderedEmail, type ResourceChange, type ResourceSource, type RoleDefinition, type RolesInput, type RunContext, type RuntimeOptions, type S3Bucket, type S3FilesOptions, type S3ListPage, type S3Object, type ScanGuardMode, type ScheduledDelete, type Session, type SessionOrganization, type Sharp, type SignInPolicy, type SignInRule, type SignatureOptions, type SocketEvents, type SourceOption, type SourceRef, type StaffAccessRule, type StaffSignIn, type StandardSchema, type StandardWebhookOptions, type StartJobsOptions, type StoreFileInput, type StoredMember, type StoredObject, type StoredOrganization, type StoredUser, type StrayValues, type SubscriptionDefinition, type SubscriptionEvent, type SubscriptionOptions, type TenantValue, type ToolAnnotations, type ToolCall, type ToolContext, type ToolRecord, type ToolRecords, type ToolSpec, type TrustedApp, type TurnOptions, type UnreadableEntry, type User, type UserCreatedHook, type ViewSource, type WebhooksOptions, type WidgetOptions, type WriteEvent, type WriteOperation, type WriteRecordToolsInput, addAppRoleToOwners, addMember, apiKeyCaller, apiKeySettings, apiKeyVariables, aspectRatio, assistantProtocolRoutes, assistantRoles, assistantSettings, assistantVariables, authSchemaMigration, authStoreTables, backgroundSettled, badRequest, beforeSignInPluginsVariable, betterAuthAuthenticator, betterAuthTokens, capSocketMessages, changesMigration, checkAi, checkAuthSchema, checkChanges, checkComments, checkComputed, checkJobsSchema, checkQueryRunner, checkSourceNames, checkViewQueries, checkWebhooksSchema, coalesce, commentsMigration, computedMigration, configExports, consoleAuditQueue, conversationKey, createAdmin, createAuth, createConversations, createEncryptionTools, createFileCleanup, createOrganization, createRecordTool, createUser, defaultAppName, defaultSignInPolicy, defineConfig, defineEmail, defineFunction, defineJob, defineTool, deleteUser, errorReportingSettings, errorReportingVariable, eventMatcher, fileConversationStore, fileSize, fileType, forbidden, formatUri, functionApp, getRecordTool, goTruePath, handleDroppedConnections, hasUsers, honorSocketMessageCaps, imageSize, isBackgroundWork, isCaptured, isJobDefinition, isOAuthWellKnownPath, isSchedule, issueToken, jobDefinitions, jobsDrainApp, jobsSchema, jobsSchemaMigration, jwtAuthenticator, jwtVerifier, limitedFileStore, listOrganizations, listRecordsTool, listResourcesTool, listUsers, localFileStore, localFiles, mapSettings, mapStyleUrl, mapStyleVariable, maxTokenTtlSeconds, maxWidgetPropsBytes, mcpGate, mcpHandler, mcpRoutes, mcpServer, mcpToolContext, mcpTools, mergeConfig, migrationCommand, newWebhookSecret, normalizeRoles, notFound, oauthWellKnownPaths, objectKey, parseColumns, parseRoles, passwordLength, pluginOptions, pluginsBeforeSignIn, pluginsFor, pluginsVariable, pngIcons, processor, queryRunnerMigration, readJson, readOnlyQueryTool, readOperatorSettings, readOutbox, readPlatformSignIn, readRecordTools, readWriteQueryTool, readableResources, realtimeLimits, recordOf, removeMember, renderVariant, requestApproval, requireEnv, resourceChange, roleChoices, runInBackground, runReadOnlyQuery, runReadWriteQuery, runTurn, runtimeUrl, runtimeVariable, s3FileStore, s3Files, seesAssistant, seesRuntime, sessionOf, setMemberRoles, setUserBanned, setUserRole, signInPolicyMethods, socketMessageCapOf, sourceOptions, sourcesFor, sourcesVariable, startErrorReporting, startJobs, storageCleanupSchedule, storageProvider, storeFile, storeUsage, streamChatCompletion, subscription, supabasePath, thumbHash, unauthorized, updateRecordTool, variantPath, verifySignature, verifyStandardWebhook, waitUntil, webauthnPath, webhooks, webhooksMigration, widget, withCacheBreakpoints, withTrustedApps, writeRecordTools };
+import { MobileRelease, ReleaseFile, ServedReleaseFile, composeRelease, releaseManifest } from "./mobile-release/release.js";
+import { MobileReleaseAppInput, OfferedRelease, mobileReleaseApp } from "./mobile-release/release-app.js";
+import { mobileSigningKeyVariable, readSigningKey } from "./mobile-release/signing-key.js";
+export { type Admin, type AdminAuth, type AdminOptions, type ApiFunction, type ApiKeys, type ApiKeysOptions, type AppIcons, type AppIdentity, type ApplyOptions, type ApplyResult, type ApprovalAnswer, type ApprovalRequest, type AssistantBackend, type AssistantOptions, type AssistantSettings, type AssistantTool, type AuditEvent, type AuditQueue, type Authenticator, type BetterAuthAuthenticator, type BetterAuthAuthenticatorOptions, type Caller, type CallerOptions, type CapturedRow, type CascadingKey, type ChatMessage, type ChatTextPart, type CheckAiInput, type CleanupEntry, type CleanupReport, type CleanupSchedule, type CoalescedChange, type CommentItem, type CommentUsers, type Completion, type CompletionOptions, type Conversation, type ConversationRecord, type ConversationStore, type ConversationsOptions, type CorsOptions, type CorsOrigins, type CreateAdminInput, type CreateAuthOptions, type DrainResult, type EmailComponent, type EmailOptions, type EmailTemplate, type EncryptionStatus, type EncryptionTools, type EncryptionToolsInput, type EnqueueOptions, type ErrorReporter, type ErrorReportingOptions, type ErrorReportingSettings, type EventData, type EventsOptions, FatalJobError, type FieldApplied, type FieldStatus, type FileCleanupInput, type FileLimits, type FileObject, type FileProvider, type FileRef, type FileStore, type FileVariantObject, type FilesOptions, type FunctionApp, type FunctionCaller, type FunctionContext, type FunctionEnv, type FunctionHandler, type FunctionOptions, type FunctionRecords, type FunctionSocket, type FunctionSource, type HistoryOptions, HttpProblem, type IssueTokenOptions, type JobContext, type JobDefinition, type JobOptions, type JobsRuntime, type JwtOptions, type JwtVerifyOptions, type KeyFunctionContext, type LinkedAccount, type ListParams, type LocalFilesOptions, type MailMessage, type Mailer, type MapLayer, type MapOptions, type MapSettings, type McpGateInput, type McpHandlerInput, type McpRoutesInput, type McpServerInput, type McpToolsInput, type McpWrites, type MemberInput, MissingCredentials, type MobileConfig, type MobileRelease, type MobileReleaseAppInput, ModelError, type ModelSettings, type NewOrganization, type NewUser, type OfferedRelease, type OperatorProvider, type OrganizationRole, type OrganizationsOptions, type PipelineHook, type PlatformSignIn, type PluginOption, type PluginRef, type PngIcon, type ProjectConfig, type ProtectedFunctionOptions, type PublicFunctionContext, type PublicFunctionEnv, type PublicFunctionHandler, type PublicFunctionOptions, type QueryOptions, type QueryResult, type ReadableResources, type ReasoningDetail, type ReasoningEffort, type RebindOption, type RecordKeyInput, type RecordPage, type ReleaseFile, type RenderedEmail, type ResourceChange, type ResourceSource, type RoleDefinition, type RolesInput, type RunContext, type RuntimeOptions, type S3Bucket, type S3FilesOptions, type S3ListPage, type S3Object, type ScanGuardMode, type ScheduledDelete, type ServedReleaseFile, type Session, type SessionOrganization, type Sharp, type SignInPolicy, type SignInRule, type SignatureOptions, type SocketEvents, type SourceOption, type SourceRef, type StaffAccessRule, type StaffSignIn, type StandardSchema, type StandardWebhookOptions, type StartJobsOptions, type StoreFileInput, type StoredMember, type StoredObject, type StoredOrganization, type StoredUser, type StrayValues, type SubscriptionDefinition, type SubscriptionEvent, type SubscriptionOptions, type TenantValue, type ToolAnnotations, type ToolCall, type ToolContext, type ToolRecord, type ToolRecords, type ToolSpec, type TrustedApp, type TurnOptions, type UnreadableEntry, type User, type UserCreatedHook, type ViewSource, type WebhooksOptions, type WidgetOptions, type WriteEvent, type WriteOperation, type WriteRecordToolsInput, addAppRoleToOwners, addMember, apiKeyCaller, apiKeySettings, apiKeyVariables, aspectRatio, assistantProtocolRoutes, assistantRoles, assistantSettings, assistantVariables, authSchemaMigration, authStoreTables, backgroundSettled, badRequest, beforeSignInPluginsVariable, betterAuthAuthenticator, betterAuthTokens, capSocketMessages, changesMigration, checkAi, checkAuthSchema, checkChanges, checkComments, checkComputed, checkJobsSchema, checkQueryRunner, checkSourceNames, checkViewQueries, checkWebhooksSchema, coalesce, commentsMigration, composeRelease, computedMigration, configExports, consoleAuditQueue, conversationKey, createAdmin, createAuth, createConversations, createEncryptionTools, createFileCleanup, createOrganization, createRecordTool, createUser, defaultAppName, defaultSignInPolicy, defineConfig, defineEmail, defineFunction, defineJob, defineTool, deleteUser, errorReportingSettings, errorReportingVariable, eventMatcher, fileConversationStore, fileSize, fileType, forbidden, formatUri, functionApp, getRecordTool, goTruePath, handleDroppedConnections, hasUsers, honorSocketMessageCaps, imageSize, isBackgroundWork, isCaptured, isJobDefinition, isOAuthWellKnownPath, isSchedule, issueToken, jobDefinitions, jobsDrainApp, jobsSchema, jobsSchemaMigration, jwtAuthenticator, jwtVerifier, limitedFileStore, listOrganizations, listRecordsTool, listResourcesTool, listUsers, localFileStore, localFiles, mapSettings, mapStyleUrl, mapStyleVariable, maxTokenTtlSeconds, maxWidgetPropsBytes, mcpGate, mcpHandler, mcpRoutes, mcpServer, mcpToolContext, mcpTools, mergeConfig, migrationCommand, mobileReleaseApp, mobileSigningKeyVariable, newWebhookSecret, normalizeRoles, notFound, oauthWellKnownPaths, objectKey, parseColumns, parseRoles, passwordLength, pluginOptions, pluginsBeforeSignIn, pluginsFor, pluginsVariable, pngIcons, processor, queryRunnerMigration, readJson, readOnlyQueryTool, readOperatorSettings, readOutbox, readPlatformSignIn, readRecordTools, readSigningKey, readWriteQueryTool, readableResources, realtimeLimits, recordOf, releaseManifest, removeMember, renderVariant, requestApproval, requireEnv, resourceChange, roleChoices, runInBackground, runReadOnlyQuery, runReadWriteQuery, runTurn, runtimeUrl, runtimeVariable, s3FileStore, s3Files, seesAssistant, seesRuntime, sessionOf, setMemberRoles, setUserBanned, setUserRole, signInPolicyMethods, socketMessageCapOf, sourceOptions, sourcesFor, sourcesVariable, startErrorReporting, startJobs, storageCleanupSchedule, storageProvider, storeFile, storeUsage, streamChatCompletion, subscription, supabasePath, thumbHash, unauthorized, updateRecordTool, variantPath, verifySignature, verifyStandardWebhook, waitUntil, webauthnPath, webhooks, webhooksMigration, widget, withCacheBreakpoints, withTrustedApps, writeRecordTools };

package/dist/index.js

@@ -95,4 +95,7 @@ import { aspectRatio, fileSize, fileType, imageSize, processor } from "./files/p
 import { defineEmail } from "./mail/define-email.js";
 import { startJobs } from "./jobs/runtime.js";
 import { jobsDrainApp } from "./jobs/drain-route.js";
-export { FatalJobError, HttpProblem, MissingCredentials, ModelError, addAppRoleToOwners, addMember, apiKeyCaller, apiKeySettings, apiKeyVariables, aspectRatio, assistantProtocolRoutes, assistantRoles, assistantSettings, assistantVariables, authSchemaMigration, authStoreTables, backgroundSettled, badRequest, beforeSignInPluginsVariable, betterAuthAuthenticator, betterAuthTokens, capSocketMessages, changesMigration, checkAi, checkAuthSchema, checkChanges, checkComments, checkComputed, checkJobsSchema, checkQueryRunner, checkSourceNames, checkViewQueries, checkWebhooksSchema, coalesce, commentsMigration, computedMigration, configExports, consoleAuditQueue, conversationKey, createAdmin, createAuth, createConversations, createEncryptionTools, createFileCleanup, createOrganization, createRecordTool, createUser, defaultAppName, defaultSignInPolicy, defineConfig, defineEmail, defineFunction, defineJob, defineTool, deleteUser, errorReportingSettings, errorReportingVariable, eventMatcher, fileConversationStore, fileSize, fileType, forbidden, formatUri, functionApp, getRecordTool, goTruePath, handleDroppedConnections, hasUsers, honorSocketMessageCaps, imageSize, isBackgroundWork, isCaptured, isJobDefinition, isOAuthWellKnownPath, isSchedule, issueToken, jobDefinitions, jobsDrainApp, jobsSchema, jobsSchemaMigration, jwtAuthenticator, jwtVerifier, limitedFileStore, listOrganizations, listRecordsTool, listResourcesTool, listUsers, localFileStore, localFiles, mapSettings, mapStyleUrl, mapStyleVariable, maxTokenTtlSeconds, maxWidgetPropsBytes, mcpGate, mcpHandler, mcpRoutes, mcpServer, mcpToolContext, mcpTools, mergeConfig, migrationCommand, newWebhookSecret, normalizeRoles, notFound, oauthWellKnownPaths, objectKey, parseColumns, parseRoles, passwordLength, pluginOptions, pluginsBeforeSignIn, pluginsFor, pluginsVariable, pngIcons, processor, queryRunnerMigration, readJson, readOnlyQueryTool, readOperatorSettings, readOutbox, readPlatformSignIn, readRecordTools, readWriteQueryTool, readableResources, realtimeLimits, recordOf, removeMember, renderVariant, requestApproval, requireEnv, resourceChange, roleChoices, runInBackground, runReadOnlyQuery, runReadWriteQuery, runTurn, runtimeUrl, runtimeVariable, s3FileStore, s3Files, seesAssistant, seesRuntime, sessionOf, setMemberRoles, setUserBanned, setUserRole, signInPolicyMethods, socketMessageCapOf, sourceOptions, sourcesFor, sourcesVariable, startErrorReporting, startJobs, storageCleanupSchedule, storageProvider, storeFile, storeUsage, streamChatCompletion, subscription, supabasePath, thumbHash, unauthorized, updateRecordTool, variantPath, verifySignature, verifyStandardWebhook, waitUntil, webauthnPath, webhooks, webhooksMigration, widget, withCacheBreakpoints, withTrustedApps, writeRecordTools };
+import { composeRelease, releaseManifest } from "./mobile-release/release.js";
+import { mobileReleaseApp } from "./mobile-release/release-app.js";
+import { mobileSigningKeyVariable, readSigningKey } from "./mobile-release/signing-key.js";
+export { FatalJobError, HttpProblem, MissingCredentials, ModelError, addAppRoleToOwners, addMember, apiKeyCaller, apiKeySettings, apiKeyVariables, aspectRatio, assistantProtocolRoutes, assistantRoles, assistantSettings, assistantVariables, authSchemaMigration, authStoreTables, backgroundSettled, badRequest, beforeSignInPluginsVariable, betterAuthAuthenticator, betterAuthTokens, capSocketMessages, changesMigration, checkAi, checkAuthSchema, checkChanges, checkComments, checkComputed, checkJobsSchema, checkQueryRunner, checkSourceNames, checkViewQueries, checkWebhooksSchema, coalesce, commentsMigration, composeRelease, computedMigration, configExports, consoleAuditQueue, conversationKey, createAdmin, createAuth, createConversations, createEncryptionTools, createFileCleanup, createOrganization, createRecordTool, createUser, defaultAppName, defaultSignInPolicy, defineConfig, defineEmail, defineFunction, defineJob, defineTool, deleteUser, errorReportingSettings, errorReportingVariable, eventMatcher, fileConversationStore, fileSize, fileType, forbidden, formatUri, functionApp, getRecordTool, goTruePath, handleDroppedConnections, hasUsers, honorSocketMessageCaps, imageSize, isBackgroundWork, isCaptured, isJobDefinition, isOAuthWellKnownPath, isSchedule, issueToken, jobDefinitions, jobsDrainApp, jobsSchema, jobsSchemaMigration, jwtAuthenticator, jwtVerifier, limitedFileStore, listOrganizations, listRecordsTool, listResourcesTool, listUsers, localFileStore, localFiles, mapSettings, mapStyleUrl, mapStyleVariable, maxTokenTtlSeconds, maxWidgetPropsBytes, mcpGate, mcpHandler, mcpRoutes, mcpServer, mcpToolContext, mcpTools, mergeConfig, migrationCommand, mobileReleaseApp, mobileSigningKeyVariable, newWebhookSecret, normalizeRoles, notFound, oauthWellKnownPaths, objectKey, parseColumns, parseRoles, passwordLength, pluginOptions, pluginsBeforeSignIn, pluginsFor, pluginsVariable, pngIcons, processor, queryRunnerMigration, readJson, readOnlyQueryTool, readOperatorSettings, readOutbox, readPlatformSignIn, readRecordTools, readSigningKey, readWriteQueryTool, readableResources, realtimeLimits, recordOf, releaseManifest, removeMember, renderVariant, requestApproval, requireEnv, resourceChange, roleChoices, runInBackground, runReadOnlyQuery, runReadWriteQuery, runTurn, runtimeUrl, runtimeVariable, s3FileStore, s3Files, seesAssistant, seesRuntime, sessionOf, setMemberRoles, setUserBanned, setUserRole, signInPolicyMethods, socketMessageCapOf, sourceOptions, sourcesFor, sourcesVariable, startErrorReporting, startJobs, storageCleanupSchedule, storageProvider, storeFile, storeUsage, streamChatCompletion, subscription, supabasePath, thumbHash, unauthorized, updateRecordTool, variantPath, verifySignature, verifyStandardWebhook, waitUntil, webauthnPath, webhooks, webhooksMigration, widget, withCacheBreakpoints, withTrustedApps, writeRecordTools };

package/dist/mcp/mcp-approval.js

@@ -18,6 +18,13 @@ const mcpApproval = (inputResponses) => (request) => {
 	if (answer.kind === "elicit" && answer.action === "accept" && answer.content?.approve === true) return Promise.resolve("approved");
 	return Promise.resolve("rejected");
 };
+/**
+* Whether `roles`, the roles the signed-in user holds, include one of `exempt`, whose MCP writes need no approval: an
+* exact match, and none for anything but a list.
+*/
+const writesUnasked = (exempt, roles) => Array.isArray(roles) && roles.some((role) => exempt.includes(role));
+/** `ToolContext.approve` over MCP for a user whose writes need no approval: approved, without asking the client. */
+const approvedUnasked = () => Promise.resolve("approved");
 const asksForms = (capabilities) => {
 	const elicitation = capabilities?.elicitation;
 	return elicitation !== void 0 && (elicitation.form !== void 0 || elicitation.url === void 0);
@@ -54,4 +61,4 @@ const approvalAsked = (request, capabilities) => {
 	}) } });
 };
 //#endregion
-export { ApprovalNeeded, approvalAsked, mcpApproval };
+export { ApprovalNeeded, approvalAsked, approvedUnasked, mcpApproval, writesUnasked };

package/dist/mcp/mcp-authenticator.js

@@ -5,11 +5,11 @@ const isMcpOptions = (options) => options === void 0 || options === false || typ
 /**
 * The authenticator of the MCP endpoint's tokens, when MCP is on (`createAuth({ mcp })`); none when the host serves its
 * own (`options.mcp: false`). Stops the server at startup when `options.mcp` is neither `false` nor
-* `{ sql?: boolean; writes?: boolean | { resources: string[] } }`, when it is set without MCP, or when `authenticate` cannot verify tokens for
+* `{ sql?: boolean; writes?: boolean | { resources?: string[]; rolesWithoutApproval?: string[] } }`, when it is set without MCP, or when `authenticate` cannot verify tokens for
 * another audience.
 */
 const mcpAuthenticator = (authenticate, mcp, options) => {
-	if (!isMcpOptions(options)) throw new Error("options.mcp takes false or { sql?: boolean, writes?: boolean | { resources: [<resource>, ...] } }");
+	if (!isMcpOptions(options)) throw new Error("options.mcp takes false or { sql?: boolean, writes?: boolean | { resources?: [<resource>, ...], rolesWithoutApproval?: [<role>, ...] } }");
 	if (options === false) return void 0;
 	if (options && !mcp) throw new Error("options.mcp needs createAuth({ mcp }) passed as auth");
 	if (!mcp) return void 0;

package/dist/mcp/mcp-server.d.ts

@@ -13,10 +13,13 @@ export type McpServerInput = {
   context: Omit<ToolContext, 'approve'>;
   /** Gets the errors a tool throws, which the client only sees as a failure. */
   report: (error: unknown) => void;
+  /** The roles whose calls are approved without asking the client: a user holding one of them is never asked. None by default. */
+  rolesWithoutApproval?: readonly string[];
 };
 /**
  * An MCP server offering `tools` as MCP tools, each with its JSON Schema, its hints, and the text it returns. A tool
- * that asks for approval makes the call ask the client's user, and runs again from the start with their answer.
+ * that asks for approval makes the call ask the client's user, and runs again from the start with their answer; for a
+ * user holding one of `rolesWithoutApproval` it is approved at once, and the client is never asked.
  */
-export declare const mcpServer: ({ info, tools, context, report }: McpServerInput) => McpServer;
+export declare const mcpServer: ({ info, tools, context, report, rolesWithoutApproval }: McpServerInput) => McpServer;
 //#endregion

package/dist/mcp/mcp-server.js

@@ -1,5 +1,5 @@
 import { checkedTools } from "../assistant/checked-tools.js";
-import { ApprovalNeeded, approvalAsked, mcpApproval } from "./mcp-approval.js";
+import { ApprovalNeeded, approvalAsked, approvedUnasked, mcpApproval, writesUnasked } from "./mcp-approval.js";
 import { CLIENT_CAPABILITIES_META_KEY, McpServer, fromJsonSchema } from "@modelcontextprotocol/server";
 //#region src/mcp/mcp-server.ts
 const capabilitiesOf = (envelope) => envelope?.[CLIENT_CAPABILITIES_META_KEY];
@@ -12,10 +12,12 @@ const failed = {
 };
 /**
 * An MCP server offering `tools` as MCP tools, each with its JSON Schema, its hints, and the text it returns. A tool
-* that asks for approval makes the call ask the client's user, and runs again from the start with their answer.
+* that asks for approval makes the call ask the client's user, and runs again from the start with their answer; for a
+* user holding one of `rolesWithoutApproval` it is approved at once, and the client is never asked.
 */
-const mcpServer = ({ info, tools, context, report }) => {
+const mcpServer = ({ info, tools, context, report, rolesWithoutApproval = [] }) => {
 	const server = new McpServer(info);
+	const unasked = writesUnasked(rolesWithoutApproval, context.session.user.roles);
 	for (const tool of checkedTools(tools)) {
 		const config = {
 			description: tool.description,
@@ -28,7 +30,7 @@ const mcpServer = ({ info, tools, context, report }) => {
 					type: "text",
 					text: await tool.run(args, {
 						...context,
-						approve: mcpApproval(ctx.mcpReq.inputResponses)
+						approve: unasked ? approvedUnasked : mcpApproval(ctx.mcpReq.inputResponses)
 					})
 				}] };
 			} catch (error) {

package/dist/mcp/mcp-tools.d.ts

@@ -9,7 +9,7 @@ export type McpToolsInput = {
   sql: boolean;
   /**
    * Offers `create_record` and `update_record`, on the listed resources only when given `{ resources }`; each write still
-   * needs the caller's role and their approval in the client.
+   * needs the caller's role, and their approval in the client unless they hold one of `rolesWithoutApproval`.
    */
   writes: McpWrites;
 };

package/dist/mcp/mcp-tools.js

@@ -9,7 +9,7 @@ import { writeRecordTools } from "../assistant/write-record-tools.js";
 */
 const mcpTools = ({ db, sql, writes }) => (session) => [
 	...readRecordTools(),
-	...writes === false ? [] : writeRecordTools(writes === true ? {} : { resources: writes.resources }),
+	...writes === false ? [] : writeRecordTools(writes === true || !writes.resources ? {} : { resources: writes.resources }),
 	...sql && seesAssistant(session.user.roles) ? [readOnlyQueryTool(db)] : []
 ];
 //#endregion

package/dist/mcp/mcp-writes.d.ts

@@ -1,7 +1,11 @@
 import "../registry.js";
 //#region src/mcp/mcp-writes.d.ts
-/** Which resources the MCP write tools may change: none, every one the caller may write, or the ones named. */
+/**
+ * Which resources the MCP write tools may change: none, every one the caller may write, or the ones named; and the
+ * roles whose writes run without the person's approval in the client.
+ */
 export type McpWrites = boolean | {
-  resources: string[];
+  resources?: string[];
+  rolesWithoutApproval?: string[];
 };
 //#endregion

package/dist/mcp/mcp-writes.js

@@ -1,16 +1,25 @@
+import { anonymousRole } from "@protobase/schema";
 //#region src/mcp/mcp-writes.ts
-const isResourceList = (value) => Array.isArray(value) && value.length > 0 && value.every((name) => typeof name === "string" && name !== "");
+const isNameList = (value) => Array.isArray(value) && value.every((name) => typeof name === "string" && name !== "");
+const isWritesEntry = ([name, value]) => name === "resources" && isNameList(value) && value.length > 0 || name === "rolesWithoutApproval" && isNameList(value);
 const isMcpWrites = (value) => {
 	if (typeof value === "boolean") return true;
 	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
 	const entries = Object.entries(value);
-	return entries.length === 1 && entries[0][0] === "resources" && isResourceList(entries[0][1]);
+	return entries.length > 0 && entries.every(isWritesEntry);
 };
-/** Stops startup when `options.mcp.writes` names a resource the app does not have. */
-const checkMcpWrites = (registry, writes) => {
+/** The roles `writes` lets write without approval; none unless named. */
+const rolesWithoutApproval = (writes) => typeof writes === "object" ? writes.rolesWithoutApproval ?? [] : [];
+/**
+* Stops startup when `options.mcp.writes` names a resource the app does not have, or lets a role write without
+* approval that is not one of `roles`, the roles its users can hold, or is the anonymous role.
+*/
+const checkMcpWrites = (registry, roles, writes) => {
 	if (typeof writes !== "object") return;
-	const unknown = writes.resources.filter((name) => !registry.find(name));
+	const unknown = (writes.resources ?? []).filter((name) => !registry.find(name));
 	if (unknown.length > 0) throw new Error(`options.mcp.writes names resources the app does not have: ${unknown.join(", ")}`);
+	const unheld = rolesWithoutApproval(writes).filter((role) => role === anonymousRole || !(roles ?? []).includes(role));
+	if (unheld.length > 0) throw new Error(`options.mcp.writes.rolesWithoutApproval names roles the app's users cannot hold: ${unheld.join(", ")}`);
 };
 //#endregion
-export { checkMcpWrites, isMcpWrites };
+export { checkMcpWrites, isMcpWrites, rolesWithoutApproval };

package/dist/mobile-release/release-app.d.ts

@@ -0,0 +1,43 @@
+import { MobileRelease } from "./release.js";
+//#region src/mobile-release/release-app.d.ts
+/** The release a server offers: its files, the native fingerprint of the binaries it runs on and the API origin it calls. */
+export type OfferedRelease = MobileRelease & {
+  fingerprint: string;
+  origin: string;
+};
+export type MobileReleaseAppInput = {
+  /** `undefined` when the server serves no release, such as the API alone, whose app files a host serves. */
+  release?: OfferedRelease;
+  /** The server's Protobase version, which the shell a device runs must work with. */
+  serverVersion: string;
+};
+/**
+ * The live updater's routes. `GET /api/mobile/release` tells a device the release it should run: the server's own,
+ * when it runs on the device's binary, and whether the update is required. `GET /api/mobile/releases/<bundle id>?href=`
+ * serves the release's manifest and files, each with its sha256 in `X-Checksum` and, signed, its `X-Signature`, which
+ * the updater checks each file against: it never checks a file against the manifest.
+ */
+export declare const mobileReleaseApp: ({ release, serverVersion }: MobileReleaseAppInput) => import("hono/hono-base").HonoBase<import("hono/types").BlankEnv, {
+  "/api/mobile/release": {
+    $get: {
+      input: {};
+      output: {};
+      outputFormat: string;
+      status: import("hono/utils/http-status").StatusCode;
+    };
+  };
+} & {
+  "/api/mobile/releases/:bundleId": {
+    $get: {
+      input: {
+        param: {
+          bundleId: string;
+        };
+      };
+      output: {};
+      outputFormat: string;
+      status: import("hono/utils/http-status").StatusCode;
+    };
+  };
+}, "/", "/api/mobile/releases/:bundleId">;
+//#endregion

package/dist/mobile-release/release-app.js

@@ -0,0 +1,41 @@
+import { badRequest, notFound, problemResponse } from "../problem.js";
+import { isShellVersion, shellUpdateRequired } from "./shell-update.js";
+import { Hono } from "hono";
+import { mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleasesPath } from "@protobase/schema/internal";
+import { getMimeType } from "hono/utils/mime";
+//#region src/mobile-release/release-app.ts
+/**
+* The live updater's routes. `GET /api/mobile/release` tells a device the release it should run: the server's own,
+* when it runs on the device's binary, and whether the update is required. `GET /api/mobile/releases/<bundle id>?href=`
+* serves the release's manifest and files, each with its sha256 in `X-Checksum` and, signed, its `X-Signature`, which
+* the updater checks each file against: it never checks a file against the manifest.
+*/
+const mobileReleaseApp = ({ release, serverVersion }) => new Hono().get(mobileReleasePath, (c) => {
+	const problem = (error) => problemResponse(error, c.req.path);
+	const fingerprint = c.req.query(mobileReleaseParams.fingerprint);
+	const shellVersion = c.req.query(mobileReleaseParams.shellVersion);
+	if (!fingerprint) return problem(badRequest("invalid-fingerprint", `${mobileReleaseParams.fingerprint} must name the native fingerprint of the app`));
+	if (!shellVersion || !isShellVersion(shellVersion)) return problem(badRequest("invalid-shell-version", `${mobileReleaseParams.shellVersion} must be the x.y.z Protobase version of the shell the app runs`));
+	const offered = release?.fingerprint === fingerprint ? release : void 0;
+	const answer = {
+		bundleId: offered?.bundleId ?? null,
+		url: offered ? `${offered.origin}${mobileReleaseBasePath(offered.bundleId)}` : null,
+		required: shellUpdateRequired(shellVersion, serverVersion)
+	};
+	return c.json(answer, 200, {
+		"cache-control": "no-store",
+		"access-control-allow-origin": "*"
+	});
+}).get(`${mobileReleasesPath}/:bundleId`, (c) => {
+	const href = c.req.query("href") ?? "";
+	const file = release && c.req.param("bundleId") === release.bundleId ? release.files.get(href) : void 0;
+	if (!file) return problemResponse(notFound("The release has no such file, or is no longer served"), c.req.path);
+	return c.body(file.content, 200, {
+		"content-type": getMimeType(href) ?? "application/octet-stream",
+		"cache-control": "public, max-age=31536000, immutable",
+		"x-checksum": file.checksum,
+		...file.signature && { "x-signature": file.signature }
+	});
+});
+//#endregion
+export { mobileReleaseApp };

package/dist/mobile-release/release.d.ts

@@ -0,0 +1,33 @@
+import { KeyObject } from "node:crypto";
+//#region src/mobile-release/release.d.ts
+/** A file of a release: its path inside the app's files, such as `assets/index-abc123.js`, and its bytes. */
+export type ReleaseFile = {
+  href: string;
+  content: Uint8Array;
+};
+/** A file as the updater gets it: its bytes, their sha256 in hex and, with a signing key, their signature. */
+export type ServedReleaseFile = {
+  content: Uint8Array;
+  checksum: string;
+  signature?: string;
+};
+/**
+ * A release of the app's files: its bundle id, a hash of its manifest and of the signing key's public key, and every
+ * file by `href`, the manifest included.
+ */
+export type MobileRelease = {
+  bundleId: string;
+  files: Map<string, ServedReleaseFile>;
+};
+/** The updater's manifest of `files`: each one's `href`, sha256 in hex and size, in the order of their hrefs. */
+export declare const releaseManifest: (files: ReleaseFile[]) => {
+  href: string;
+  checksum: string;
+  sizeInBytes: number;
+}[];
+/**
+ * The release of `files`, each hashed and, with `signingKey`, signed once here. Its manifest is served as a file of
+ * its own, so a file of the app may not have the manifest's name.
+ */
+export declare const composeRelease: (files: ReleaseFile[], signingKey?: KeyObject) => MobileRelease;
+//#endregion

package/dist/mobile-release/release.js

@@ -0,0 +1,34 @@
+import { releaseManifestFile } from "@protobase/schema/internal";
+import { createHash, createPublicKey, sign } from "node:crypto";
+//#region src/mobile-release/release.ts
+const sha256 = (content) => createHash("sha256").update(content).digest("hex");
+/** The updater's manifest of `files`: each one's `href`, sha256 in hex and size, in the order of their hrefs. */
+const releaseManifest = (files) => [...files].sort((a, b) => a.href < b.href ? -1 : a.href > b.href ? 1 : 0).map(({ href, content }) => ({
+	href,
+	checksum: sha256(content),
+	sizeInBytes: content.byteLength
+}));
+const signature = (content, key) => sign("sha256", content, key).toString("base64");
+const signer = (signingKey) => signingKey ? createPublicKey(signingKey).export({
+	type: "spki",
+	format: "der"
+}) : /* @__PURE__ */ new Uint8Array();
+/**
+* The release of `files`, each hashed and, with `signingKey`, signed once here. Its manifest is served as a file of
+* its own, so a file of the app may not have the manifest's name.
+*/
+const composeRelease = (files, signingKey) => {
+	if (files.some((file) => file.href === releaseManifestFile)) throw new Error(`The app's files have a ${releaseManifestFile}, the name of the updater's manifest: rename it`);
+	const manifest = new TextEncoder().encode(JSON.stringify(releaseManifest(files)));
+	const served = (content) => ({
+		content,
+		checksum: sha256(content),
+		...signingKey && { signature: signature(content, signingKey) }
+	});
+	return {
+		bundleId: createHash("sha256").update(manifest).update(signer(signingKey)).digest("hex").slice(0, 16),
+		files: new Map([...files.map(({ href, content }) => [href, served(content)]), [releaseManifestFile, served(manifest)]])
+	};
+};
+//#endregion
+export { composeRelease, releaseManifest };

package/dist/mobile-release/shell-update.js

@@ -0,0 +1,25 @@
+//#region src/mobile-release/shell-update.ts
+const versionPattern = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+const parseVersion = (value) => {
+	const match = versionPattern.exec(value);
+	return match ? {
+		major: Number(match[1]),
+		minor: Number(match[2])
+	} : void 0;
+};
+/** Whether `value` is an x.y.z version, as a shell's Protobase version is. */
+const isShellVersion = (value) => parseVersion(value) !== void 0;
+/**
+* Whether a device running a shell of Protobase `shell` must update before it goes on: its shell no longer works with
+* the API of a server of Protobase `server`. It works on the same major, and below 1.0, where a minor may break, on the
+* same minor, as a bundle does on a runtime.
+*/
+const shellUpdateRequired = (shell, server) => {
+	const own = parseVersion(server);
+	if (!own) throw new Error(`The server's own Protobase version ${JSON.stringify(server)} is no x.y.z version`);
+	const running = parseVersion(shell);
+	if (!running) throw new Error(`The shell's Protobase version ${JSON.stringify(shell)} is no x.y.z version`);
+	return running.major !== own.major || own.major === 0 && running.minor !== own.minor;
+};
+//#endregion
+export { isShellVersion, shellUpdateRequired };

package/dist/mobile-release/signing-key.d.ts

@@ -0,0 +1,14 @@
+import { KeyObject } from "node:crypto";
+//#region src/mobile-release/signing-key.d.ts
+/**
+ * The environment variable holding the RSA private key, PEM, that signs every file of the mobile release, for an app
+ * whose updater has the matching public key. The key is whoever deploys the app's: the signature guards the way from
+ * the server to the device (proxies, a CDN, a router), not a server that is broken into.
+ */
+export declare const mobileSigningKeyVariable = "PROTOBASE_MOBILE_SIGNING_KEY";
+/**
+ * The signing key in `PROTOBASE_MOBILE_SIGNING_KEY`, `undefined` when it is unset. Its newlines may be written `\n`, as
+ * in an env file that holds one line per value. A key that is not PEM, not RSA or under 2048 bits stops startup.
+ */
+export declare const readSigningKey: (env: Record<string, string | undefined>) => KeyObject | undefined;
+//#endregion

package/dist/mobile-release/signing-key.js

@@ -0,0 +1,32 @@
+import { createPrivateKey } from "node:crypto";
+//#region src/mobile-release/signing-key.ts
+/**
+* The environment variable holding the RSA private key, PEM, that signs every file of the mobile release, for an app
+* whose updater has the matching public key. The key is whoever deploys the app's: the signature guards the way from
+* the server to the device (proxies, a CDN, a router), not a server that is broken into.
+*/
+const mobileSigningKeyVariable = "PROTOBASE_MOBILE_SIGNING_KEY";
+const minimumBits = 2048;
+/**
+* The signing key in `PROTOBASE_MOBILE_SIGNING_KEY`, `undefined` when it is unset. Its newlines may be written `\n`, as
+* in an env file that holds one line per value. A key that is not PEM, not RSA or under 2048 bits stops startup.
+*/
+const readSigningKey = (env) => {
+	const value = env[mobileSigningKeyVariable]?.trim();
+	if (!value) return void 0;
+	const key = parsePrivateKey(value.replace(/\\n/g, "\n"));
+	if (key.asymmetricKeyType !== "rsa") throw new Error(`${mobileSigningKeyVariable} must be an RSA private key, which the app's updater verifies, not ${key.asymmetricKeyType ?? "another kind of key"}`);
+	const bits = key.asymmetricKeyDetails?.modulusLength ?? 0;
+	if (bits < minimumBits) throw new Error(`${mobileSigningKeyVariable} must be an RSA key of at least ${minimumBits} bits, not ${bits}`);
+	return key;
+};
+const parsePrivateKey = (pem) => {
+	try {
+		return createPrivateKey(pem);
+	} catch (error) {
+		if (error instanceof Error && String(error.code).startsWith("ERR_OSSL_")) throw new Error(`${mobileSigningKeyVariable} is no PEM private key: give the whole key, from -----BEGIN PRIVATE KEY----- to its END line`);
+		throw error;
+	}
+};
+//#endregion
+export { mobileSigningKeyVariable, readSigningKey };

package/dist/package.js

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.40.10";
+var version = "0.41.1";
 //#endregion
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protobase/server",
-  "version": "0.40.10",
+  "version": "0.41.1",
   "description": "The Protobase REST API as a Hono app, with Better Auth sign-in.",
   "license": "Apache-2.0",
   "repository": {
@@ -36,9 +36,9 @@
     "@better-auth/passkey": "^1.7.12",
     "@better-auth/sso": "^1.7.12",
     "@modelcontextprotocol/server": "^2.3.1",
-    "@protobase/layout": "0.40.10",
-    "@protobase/query": "0.40.10",
-    "@protobase/schema": "0.40.10",
+    "@protobase/layout": "0.41.1",
+    "@protobase/query": "0.41.1",
+    "@protobase/schema": "0.41.1",
     "@react-email/render": "^2.1.0",
     "@scalar/hono-api-reference": "^0.12.10",
     "@sentry/core": "^11.7.0",