Skip to content

Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.

8.5 KB
Raw Blame
import {
  AuthAccessReadScope,
  AuthAccessWriteScope,
  AuthOrchestrationOperateScope,
  AuthOrchestrationReadScope,
  ORCHESTRATION_WS_METHODS,
  type AuthEnvironmentScope,
  WS_METHODS,
  WsRpcGroup,
} from "@akeru/contracts";
import type * as RpcGroup from "effect/unstable/rpc/RpcGroup";

type WsRpcMethod = RpcGroup.Rpcs<typeof WsRpcGroup>["_tag"];

/**
 * Keep authorization coverage coupled to the RPC group itself. Adding an RPC to
 * `WsRpcGroup` without choosing a scope is a type error instead of a production
 * runtime failure.
 */
export const RPC_REQUIRED_SCOPES = {
  [ORCHESTRATION_WS_METHODS.dispatchCommand]: AuthOrchestrationOperateScope,
  [ORCHESTRATION_WS_METHODS.getWorkflowScript]: AuthOrchestrationReadScope,
  [ORCHESTRATION_WS_METHODS.getTurnDiff]: AuthOrchestrationReadScope,
  [ORCHESTRATION_WS_METHODS.getFullThreadDiff]: AuthOrchestrationReadScope,
  [ORCHESTRATION_WS_METHODS.searchThreads]: AuthOrchestrationReadScope,
  [ORCHESTRATION_WS_METHODS.subscribeShell]: AuthOrchestrationReadScope,
  [ORCHESTRATION_WS_METHODS.getArchivedShellSnapshot]: AuthOrchestrationReadScope,
  [ORCHESTRATION_WS_METHODS.subscribeThread]: AuthOrchestrationReadScope,
  [WS_METHODS.serverProbe]: AuthOrchestrationReadScope,
  [WS_METHODS.serverGetConfig]: AuthOrchestrationReadScope,
  [WS_METHODS.serverRefreshProviders]: AuthOrchestrationOperateScope,
  [WS_METHODS.serverUpdateProvider]: AuthOrchestrationOperateScope,
  [WS_METHODS.serverUpdateServer]: AuthOrchestrationOperateScope,
  [WS_METHODS.serverUpdateServerWithProgress]: AuthOrchestrationOperateScope,
  [WS_METHODS.serverUpsertKeybinding]: AuthOrchestrationOperateScope,
  [WS_METHODS.serverRemoveKeybinding]: AuthOrchestrationOperateScope,
  [WS_METHODS.serverGetSettings]: AuthOrchestrationReadScope,
  [WS_METHODS.serverUpdateSettings]: AuthOrchestrationOperateScope,
  [WS_METHODS.composioGetStatus]: AuthOrchestrationReadScope,
  [WS_METHODS.composioConfigure]: AuthOrchestrationOperateScope,
  [WS_METHODS.composioRemove]: AuthOrchestrationOperateScope,
  [WS_METHODS.composioSearchToolkits]: AuthOrchestrationReadScope,
  [WS_METHODS.composioAuthorize]: AuthOrchestrationOperateScope,
  [WS_METHODS.composioDisconnect]: AuthOrchestrationOperateScope,
  [WS_METHODS.subscriptionAuthList]: AuthOrchestrationReadScope,
  [WS_METHODS.subscriptionAuthStart]: AuthOrchestrationOperateScope,
  [WS_METHODS.subscriptionAuthPoll]: AuthOrchestrationOperateScope,
  [WS_METHODS.subscriptionAuthComplete]: AuthOrchestrationOperateScope,
  [WS_METHODS.subscriptionAuthCancel]: AuthOrchestrationOperateScope,
  [WS_METHODS.subscriptionAuthLogout]: AuthOrchestrationOperateScope,
  [WS_METHODS.subscriptionAuthHealthTest]: AuthOrchestrationOperateScope,
  [WS_METHODS.subscriptionAuthSetAccountOrder]: AuthOrchestrationOperateScope,
  [WS_METHODS.imageProviderList]: AuthOrchestrationReadScope,
  [WS_METHODS.imageProviderHealthTest]: AuthOrchestrationOperateScope,
  [WS_METHODS.mcpServerAuthenticate]: AuthOrchestrationOperateScope,
  [WS_METHODS.botInboxList]: AuthOrchestrationReadScope,
  [WS_METHODS.botInboxResolve]: AuthOrchestrationOperateScope,
  [WS_METHODS.voiceProviders]: AuthOrchestrationReadScope,
  [WS_METHODS.voiceConnect]: AuthOrchestrationOperateScope,
  [WS_METHODS.voiceDisconnect]: AuthOrchestrationOperateScope,
  [WS_METHODS.voiceTest]: AuthOrchestrationOperateScope,
  [WS_METHODS.voiceListVoices]: AuthOrchestrationReadScope,
  [WS_METHODS.voiceTranscribe]: AuthOrchestrationOperateScope,
  [WS_METHODS.voiceSynthesize]: AuthOrchestrationOperateScope,
  [WS_METHODS.voiceCancel]: AuthOrchestrationOperateScope,
  [WS_METHODS.voiceCallGet]: AuthOrchestrationReadScope,
  [WS_METHODS.voiceCallStart]: AuthOrchestrationOperateScope,
  [WS_METHODS.voiceCallHangup]: AuthOrchestrationOperateScope,
  [WS_METHODS.serverGetTraceDiagnostics]: AuthOrchestrationReadScope,
  [WS_METHODS.serverGetProcessDiagnostics]: AuthOrchestrationReadScope,
  [WS_METHODS.serverGetProcessResourceHistory]: AuthOrchestrationReadScope,
  [WS_METHODS.serverGetResourceTelemetryHistory]: AuthOrchestrationReadScope,
  [WS_METHODS.serverRetryResourceTelemetry]: AuthOrchestrationOperateScope,
  [WS_METHODS.serverGetUsageSummary]: AuthOrchestrationReadScope,
  // Remote health exposes host paths and repairs files, so it needs administrative scopes.
  [WS_METHODS.serverGetRemoteDoctor]: AuthAccessReadScope,
  [WS_METHODS.serverRepairRemoteDoctor]: AuthAccessWriteScope,
  [WS_METHODS.serverSignalProcess]: AuthOrchestrationOperateScope,
  [WS_METHODS.serverReportClientActivity]: AuthOrchestrationReadScope,
  [WS_METHODS.serverReportHostPowerState]: AuthOrchestrationOperateScope,
  [WS_METHODS.serverGetBackgroundPolicy]: AuthOrchestrationReadScope,
  [WS_METHODS.memoryExport]: AuthOrchestrationReadScope,
  [WS_METHODS.memoryImportPreview]: AuthOrchestrationReadScope,
  [WS_METHODS.memoryImportApply]: AuthOrchestrationOperateScope,
  [WS_METHODS.memoryArchiveExport]: AuthOrchestrationReadScope,
  [WS_METHODS.memoryArchivePreviewImport]: AuthOrchestrationReadScope,
  [WS_METHODS.memoryArchiveApplyImport]: AuthOrchestrationOperateScope,
  [WS_METHODS.memoryFactsList]: AuthOrchestrationReadScope,
  [WS_METHODS.memoryFactMutate]: AuthOrchestrationOperateScope,
  [WS_METHODS.memoryDocumentsInspect]: AuthOrchestrationReadScope,
  [WS_METHODS.memoryDocumentReplace]: AuthOrchestrationOperateScope,
  [WS_METHODS.memoryObservationsClear]: AuthOrchestrationOperateScope,
  [WS_METHODS.botUsage]: AuthOrchestrationReadScope,
  [WS_METHODS.portabilityExport]: AuthOrchestrationReadScope,
  [WS_METHODS.portabilityPreviewImport]: AuthOrchestrationReadScope,
  [WS_METHODS.portabilityApplyImport]: AuthOrchestrationOperateScope,
  [WS_METHODS.routinesListRuns]: AuthOrchestrationReadScope,
  [WS_METHODS.routinesListThreadRuns]: AuthOrchestrationReadScope,
  [WS_METHODS.projectsListEntries]: AuthOrchestrationReadScope,
  [WS_METHODS.projectsReadFile]: AuthOrchestrationReadScope,
  [WS_METHODS.projectsSearchEntries]: AuthOrchestrationReadScope,
  [WS_METHODS.projectsWriteFile]: AuthOrchestrationOperateScope,
  [WS_METHODS.shellOpenInEditor]: AuthOrchestrationOperateScope,
  [WS_METHODS.shellRevealAttachment]: AuthOrchestrationOperateScope,
  [WS_METHODS.assetsCreateUrl]: AuthOrchestrationReadScope,
  [WS_METHODS.attachmentsCreateUploadUrl]: AuthOrchestrationOperateScope,
  [WS_METHODS.attachmentsDelete]: AuthOrchestrationOperateScope,
  [WS_METHODS.providerUploadFeedback]: AuthOrchestrationOperateScope,
  [WS_METHODS.subscribeResourceTelemetry]: AuthOrchestrationReadScope,
  [WS_METHODS.computerGetState]: AuthOrchestrationReadScope,
  [WS_METHODS.computerOpen]: AuthOrchestrationOperateScope,
  [WS_METHODS.computerAcquire]: AuthOrchestrationOperateScope,
  [WS_METHODS.computerInput]: AuthOrchestrationOperateScope,
  [WS_METHODS.computerRelease]: AuthOrchestrationOperateScope,
  [WS_METHODS.computerClose]: AuthOrchestrationOperateScope,
  [WS_METHODS.computerStop]: AuthOrchestrationOperateScope,
  [WS_METHODS.computerEvents]: AuthOrchestrationOperateScope,
  [WS_METHODS.previewOpen]: AuthOrchestrationOperateScope,
  [WS_METHODS.previewNavigate]: AuthOrchestrationOperateScope,
  [WS_METHODS.previewResize]: AuthOrchestrationOperateScope,
  [WS_METHODS.previewRefresh]: AuthOrchestrationOperateScope,
  [WS_METHODS.previewClose]: AuthOrchestrationOperateScope,
  [WS_METHODS.previewList]: AuthOrchestrationReadScope,
  [WS_METHODS.previewReportStatus]: AuthOrchestrationOperateScope,
  [WS_METHODS.previewAutomationConnect]: AuthOrchestrationOperateScope,
  [WS_METHODS.previewAutomationRespond]: AuthOrchestrationOperateScope,
  [WS_METHODS.previewAutomationFocusHost]: AuthOrchestrationOperateScope,
  [WS_METHODS.subscribePreviewEvents]: AuthOrchestrationReadScope,
  [WS_METHODS.subscribeDiscoveredLocalServers]: AuthOrchestrationReadScope,
  [WS_METHODS.subscribeServerConfig]: AuthOrchestrationReadScope,
  [WS_METHODS.subscribeServerLifecycle]: AuthOrchestrationReadScope,
  [WS_METHODS.subscribeAuthAccess]: AuthAccessReadScope,
  [WS_METHODS.subscribeBackgroundPolicy]: AuthOrchestrationReadScope,
} as const satisfies Readonly<Record<WsRpcMethod, AuthEnvironmentScope>>;

export function requiredScopeForRpcMethod(method: string): AuthEnvironmentScope {
  if (!Object.hasOwn(RPC_REQUIRED_SCOPES, method)) {
    throw new Error(`RPC method ${method} has no declared authorization scope.`);
  }

  const requiredScope = Object.entries(RPC_REQUIRED_SCOPES).find(([key]) => key === method)?.[1];

  if (requiredScope === undefined) {
    throw new Error(`RPC method ${method} has no declared authorization scope.`);
  }

  return requiredScope;
}