Skip to content

The all-in-one local AI studio for your desktop: chat, image and video generation and a coding agent in one free, open source app. Windows and Linux. No Docker, no terminal, no cloud required.

2.9 KB
Raw Blame
/**
 * Der Käfig-Eingang der fünf `/local-api/fs-*`-Endpunkte.
 *
 * WARUM DIESE DATEI: `fs-read`, `fs-write`, `fs-list`, `fs-search` und
 * `fs-info` haben den Pfad aus dem Request bis zu diesem Commit GAR NICHT
 * geprüft. Jeder von ihnen stand als
 *
 *     isAbsolute(p) ? p : join(os.homedir(), AGENT_WORKSPACE_DIR, p)
 *
 * da — ein absoluter Pfad wurde also wörtlich übernommen (`/etc/passwd`), und
 * ein relativer durfte mit `../../` aus dem Arbeitsordner klettern. `fs-write`
 * schrieb auf diesem Weg auf jeden Pfad, den der Prozess öffnen darf. Im
 * gepackten Build geht dieselbe Operation durch `resolve_path` in
 * `src-tauri/src/commands/filesystem.rs` und wird dort abgelehnt; der
 * Dev-Server war die schwächere Tür in dieselbe Operation.
 *
 * Der Käfig selbst wird hier NICHT neu gebaut — er liegt seit dem
 * `fs-read-bytes`-Port in `src/lib/dev-fs-jail.ts` und ist die Übersetzung von
 * `workspace_root` + `contain_within`. Diese Datei ist nur der eine Eingang:
 * sie liest die drei Felder, die der Käfig braucht, aus dem Request-Körper,
 * damit kein Endpunkt eines davon vergessen kann.
 *
 * DIE FELDNAMEN SIND ABSICHTLICH GENAU DIE DER TAURI-BEFEHLE. `filesystem.rs`
 * deklariert `chatId` und `workingDirectory` (camelCase, `#[allow(
 * non_snake_case)]`) und kennt keine Alternativschreibweise. Eine zusätzliche
 * `working_directory`-Schreibweise hier wäre ein zweiter Weg, die Käfigwurzel
 * zu setzen, den es auf der Rust-Seite nicht gibt — also wieder eine
 * schwächere Tür.
 *
 * REIN WIE ALLES UNTER src/dev: kein `node:*`-Import. `homeDir` kommt vom
 * Aufrufer (`os.homedir()` in vite.config.ts), damit der Test die Wurzel
 * setzen kann, ohne das echte Heimatverzeichnis zu treffen.
 */

import { devResolveWithinJail, type DevJailOptions } from '../lib/dev-fs-jail'
import { bodyString } from './http-body'

/**
 * Der Pfad EINES `/local-api/fs-*`-Requests, aufgelöst und im Käfig — oder ein
 * geworfener `JailEscapeError`, den `withJsonBody` in vite.config.ts als 403
 * beantwortet.
 *
 * Ein fehlendes `path` wird zu `''` und löst damit auf die Käfigwurzel selbst
 * auf, genau wie `resolve_path("")` auf der Rust-Seite: die Endpunkte haben
 * ihre eigene Meldung für „nichts angegeben", und der Käfig ist nicht der Ort,
 * an dem sie erfunden wird.
 *
 * `opts` reicht die beiden Dinge durch, die der reine Käfig nicht selbst haben
 * darf: den Symlink-Auflöser (`fs.realpathSync`) und `process.env.SystemDrive`.
 * Ohne den Auflöser prüft der Käfig nur lexikalisch — dass alle fünf Endpunkte
 * ihn mitgeben, hält dev-server-shape.test.ts fest.
 */
export function resolveFsRequestPath(
  body: unknown,
  homeDir: string,
  opts?: DevJailOptions,
): string {
  return devResolveWithinJail({
    path: bodyString(body, 'path') ?? '',
    homeDir,
    chatId: bodyString(body, 'chatId'),
    workingDirectory: bodyString(body, 'workingDirectory'),
    ...opts,
  })
}