Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
/**
* GBRA-218 local `--as <member>`: an operation's reads previewed as one member.
* The handler runs under that member's identity with the remote read policy
* (readers and privacy; GST-2059: the brain owner reads with privacy relaxed, and GST-2490: with access.owner_reads_restricted
* on, past readers lists and rules too; GBRA-108: a read previews the lineage the member's own credential gets, owner
* or access.members_read_lineage, and the owner's audience members; GBRA-108 design 1: a labelled-only member's grant), while ctx.remote stays false, so upload confinement
* and write trust are unchanged. An unknown or ill-formed member is refused
* before any work.
*/
import type { BrainEngine } from '../core/engine.ts';
import { isThinClient, loadConfig } from '../core/config.ts';
import { finishCliTeardown } from '../core/cli-force-exit.ts';
import { exitCliError, usageError } from './cli-error.ts';
const NON_OPERATION_SEARCH = new Set(['modes', 'stats', 'tune', 'diagnose']);
/** --as only previews operation reads on a local brain; any other command would ignore it, and a thin client reads as its own credential. */
export function refuseAsOutsideOperations(command: string, subArgs: string[], isOperation: boolean): void {
if (!isOperation || (command === 'search' && NON_OPERATION_SEARCH.has(subArgs[0] ?? ''))) {
exitCliError(usageError(`--as previews member reads for operation commands only; 'gbrain ${command}' does not take it.`,
'Use --as with an operation such as search, query, get or list, or check a credential with gbrain access check --token <name>.'), command);
}
if (isThinClient(loadConfig())) {
exitCliError(usageError('--as previews member reads on a local brain; a thin client reads as its own credential.', 'Run the command on the brain host, or check the credential with gbrain access check there.'), command);
}
}
export interface AsPreview {
run<T>(fn: () => Promise<T>): Promise<T>;
context<C extends object>(ctx: C): C;
}
const PASSTHROUGH: AsPreview = { run: fn => fn(), context: ctx => ctx };
export async function openAsPreview(engine: BrainEngine, member: string | undefined, command: string, readOnly = false): Promise<AsPreview> {
if (member === undefined) return PASSTHROUGH;
let identity: string[];
let owner: boolean;
let ownerReadsRestricted: boolean;
let lineage: boolean;
let audienceKindMembers: string[];
let labelledOnly: boolean;
try {
const membersModule = await import('../core/access/members.ts');
const resolved = await membersModule.memberIdentity(engine, member);
identity = resolved.identity;
const ownerModule = await import('../core/access/owner.ts');
owner = resolved.member === await ownerModule.ownerMemberId(engine);
ownerReadsRestricted = owner && await ownerModule.ownerReadsRestrictedOn(engine);
lineage = readOnly && (owner || await (await import('../core/access/lineage.ts')).membersReadLineageOn(engine));
audienceKindMembers = owner && lineage ? await membersModule.audienceMemberIds(engine) : [];
labelledOnly = !owner && await (await import('../core/access/labelled-only.ts')).labelledOnlyFor(engine, [identity]);
} catch (e: unknown) {
await finishCliTeardown({ engine });
exitCliError(e, command);
}
const { withCallerAccess } = await import('../core/search/private-visibility.ts');
const folder = await (await import('../core/access/caller.ts')).folderAccessFor(engine, identity);
const access = { identity, ...folder, applyRemoteReadPolicy: true, hidePrivate: !owner, owner, lineage, ownerReadsRestricted: ownerReadsRestricted && lineage, audienceKindMembers, labelledOnly, privateReadableSources: [] };
return {
run: fn => withCallerAccess(access, fn),
context: ctx => ({ ...ctx, accessIdentity: identity, applyRemoteReadPolicy: true }),
};
}