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.
import {
AuthAccessReadScope,
AuthAccessWriteScope,
AuthOrchestrationOperateScope,
AuthOrchestrationReadScope,
WS_METHODS,
WsRpcGroup,
} from "@akeru/contracts";
import { describe, expect, it } from "@effect/vitest";
import { RPC_REQUIRED_SCOPES, requiredScopeForRpcMethod } from "./RpcAuthorization.ts";
describe("RPC authorization scopes", () => {
it("declares exactly one scope for every RPC in the server group", () => {
expect(new Set(Object.keys(RPC_REQUIRED_SCOPES))).toEqual(new Set(WsRpcGroup.requests.keys()));
});
it("authorizes background policy reporting and observation deliberately", () => {
expect(requiredScopeForRpcMethod(WS_METHODS.serverReportClientActivity)).toBe(
AuthOrchestrationReadScope,
);
expect(requiredScopeForRpcMethod(WS_METHODS.serverReportHostPowerState)).toBe(
AuthOrchestrationOperateScope,
);
expect(requiredScopeForRpcMethod(WS_METHODS.serverGetBackgroundPolicy)).toBe(
AuthOrchestrationReadScope,
);
expect(requiredScopeForRpcMethod(WS_METHODS.subscribeBackgroundPolicy)).toBe(
AuthOrchestrationReadScope,
);
});
it("separates memory reads from memory changes", () => {
expect(requiredScopeForRpcMethod(WS_METHODS.memoryExport)).toBe(AuthOrchestrationReadScope);
expect(requiredScopeForRpcMethod(WS_METHODS.memoryImportPreview)).toBe(
AuthOrchestrationReadScope,
);
expect(requiredScopeForRpcMethod(WS_METHODS.memoryImportApply)).toBe(
AuthOrchestrationOperateScope,
);
expect(requiredScopeForRpcMethod(WS_METHODS.memoryDocumentReplace)).toBe(
AuthOrchestrationOperateScope,
);
});
it("allows bot usage reads without granting orchestration changes", () => {
expect(requiredScopeForRpcMethod(WS_METHODS.botUsage)).toBe(AuthOrchestrationReadScope);
});
it("requires permission to operate on a thread before uploading feedback", () => {
expect(requiredScopeForRpcMethod(WS_METHODS.providerUploadFeedback)).toBe(
AuthOrchestrationOperateScope,
);
});
it("keeps the remote doctor behind administrative scopes", () => {
expect(requiredScopeForRpcMethod(WS_METHODS.serverGetRemoteDoctor)).toBe(AuthAccessReadScope);
expect(requiredScopeForRpcMethod(WS_METHODS.serverRepairRemoteDoctor)).toBe(
AuthAccessWriteScope,
);
});
it("rejects unknown RPC method names", () => {
for (const method of ["server.notRegistered", "toString", "constructor"]) {
expect(() => requiredScopeForRpcMethod(method)).toThrow(
`RPC method ${method} has no declared authorization scope.`,
);
}
});
});