Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
/**
* #5963 Part A: raw files are not coordinated on managed brains yet. A
* git-storage `gbrain files upload-raw` whose destination lies in a managed
* canonical worktree is refused before anything is created; a configured
* storage backend (`gbrain files upload`) is the working path.
*/
import type { BrainEngine } from './engine.ts';
import { opError, type OperationError } from './ops/contract.ts';
import { managedFilesystemRootFor } from './persistence/filesystem-guard.ts';
export function managedRawUploadRefusal(dest: string, filePath: string, pageSlug: string): OperationError | null {
const managed = managedFilesystemRootFor(dest);
if (!managed) return null;
const error = opError('writer_coordinator_required',
`gbrain files upload-raw cannot bank ${filePath} next to ${pageSlug}: that path is in the managed canonical worktree ${managed.root}${managed.sourceId ? ` (source ${managed.sourceId})` : ''}. Nothing was created.`,
'Store the file in a configured storage backend instead: configure `storage` (supabase | s3 | local) in the gbrain config, then run the command in fix. Starting a gbrain serve owner does not help.',
{ why: 'Raw file uploads are not supported on a managed brain in this release: the persistence coordinator does not publish raw files yet, so the managed worktree refuses writes from outside it.',
docs: 'docs/guides/write-refusals.md#managed_raw_upload',
fix: { argv: ['gbrain', 'files', 'upload', filePath, '--page', pageSlug], consent: [], actor: 'agent', requires_exclusive: false,
why: 'Uploads the file to the configured storage backend and links it to the page; it needs `storage` configured first.',
verify: { argv: ['gbrain', 'files', 'list', pageSlug] } } });
error.detail = `root=${managed.root} source=${managed.sourceId ?? 'unknown'} evidence=${managed.evidence}`;
return error;
}
/** #7346: an object-storage upload-raw whose `.redirect.yaml` pointer would land in a managed worktree, refused before any byte is uploaded. */
export function managedPointerRefusal(filePath: string, pageSlug: string, fileType: string | null): OperationError | null {
const pointerPath = filePath + '.redirect.yaml';
const managed = managedFilesystemRootFor(pointerPath);
if (!managed) return null;
const error = opError('writer_coordinator_required',
`gbrain files upload-raw cannot write the pointer ${pointerPath}: that path is in the managed canonical worktree ${managed.root}${managed.sourceId ? ` (source ${managed.sourceId})` : ''}. Nothing was uploaded.`,
'Upload without the pointer file: the command in fix stores the file in the configured backend and links it to the page in the database.',
{ why: 'The persistence coordinator does not publish raw files or pointer files yet, so the managed worktree refuses writes from outside it.',
docs: 'docs/guides/write-refusals.md#managed_raw_upload',
fix: { argv: ['gbrain', 'files', 'upload-raw', filePath, '--page', pageSlug, ...(fileType ? ['--type', fileType] : []), '--no-pointer'], consent: [], actor: 'agent', requires_exclusive: false,
why: 'Uploads the file to the configured storage backend and records it for the page, without writing a pointer into the managed worktree.',
verify: { argv: ['gbrain', 'files', 'list', pageSlug] } } });
error.detail = `root=${managed.root} source=${managed.sourceId ?? 'unknown'} evidence=${managed.evidence}`;
return error;
}
/** True when a git-storage upload for this page would land in a managed worktree (so upload-raw is refused). */
export async function rawUploadRefusedFor(engine: BrainEngine, pageSlug: string, sourceId: string): Promise<boolean> {
const { resolvePageWriteTarget } = await import('./write-through.ts');
const target = await resolvePageWriteTarget(engine, pageSlug, sourceId).catch(() => null);
return !!target?.ok && managedFilesystemRootFor(target.filePath) !== null;
}