Files
orca/cloud/apps/sandbox-control/src/api/access.ts
T

57 lines
2.7 KiB
TypeScript

// Per-member workspace access for the public API and MCP, mirroring W4's team-workspace rule
// (cloud/w4-multiplayer src/workspaces.ts canSee/canOpen): a workspace belongs to the member who
// made it and is private unless its visibility is `team`. Being in the same org is never enough.
// read status/list metadata owner · team-visible · org admin (metadata only)
// open sessions list, messages, wake, owner · team-visible, not archived (W4's canOpen;
// message the agent a teammate's message carries who sent it)
// owner session screens, unarchive owner only (W4: pairing/screen material)
// manage sleep, archive, destroy owner · org admin
// API keys, OAuth tokens and workspace tokens all act as the member who created them.
import { canOpen as w4CanOpen, canSee as w4CanSee, isOrgAdmin as w4IsOrgAdmin, isOwner } from '../workspaces'
import { ApiError, type ApiCaller } from './caller'
import type { WorkspaceRow } from './workspaces'
export type WorkspaceAction = 'read' | 'open' | 'owner' | 'manage'
export function isOrgAdmin(caller: ApiCaller): boolean {
return w4IsOrgAdmin(caller)
}
export function isWorkspaceOwner(caller: ApiCaller, row: WorkspaceRow): boolean {
return isOwner(caller, row)
}
/** In-VM tokens see their own VM and the siblings it created, nothing else. */
function withinTokenReach(caller: ApiCaller, row: WorkspaceRow): boolean {
return caller.via !== 'workspace' || row.id === caller.sandboxId || row.origin_ref === caller.sandboxId
}
/** W4's rule: owner, or every org member when visibility is `team`. */
export function canSee(caller: ApiCaller, row: WorkspaceRow): boolean {
return withinTokenReach(caller, row) && w4CanSee(caller, row)
}
export function allowed(caller: ApiCaller, row: WorkspaceRow, action: WorkspaceAction): boolean {
const adminMetadata = caller.via !== 'workspace' && row.account_id === caller.accountId && isOrgAdmin(caller)
switch (action) {
case 'read':
return canSee(caller, row) || adminMetadata
case 'open':
return withinTokenReach(caller, row) && w4CanOpen(caller, row)
case 'owner':
return isWorkspaceOwner(caller, row) && canSee(caller, row)
case 'manage':
return (isWorkspaceOwner(caller, row) && canSee(caller, row)) || adminMetadata
}
}
/** 404 when the caller may not even know it exists, 403 when it may see but not do this. */
export function authorize(caller: ApiCaller, row: WorkspaceRow, action: WorkspaceAction): void {
if (!allowed(caller, row, 'read')) {
throw new ApiError(404, 'not_found')
}
if (!allowed(caller, row, action)) {
throw new ApiError(403, 'forbidden', action === 'owner' ? 'owner_only' : 'not_allowed')
}
}