@eum-agent/file-explorer 1.0.0 → 1.1.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { AccessErrorSchema, FileBytesParamsSchema, FileEntrySchema, FileTargetSchema, ListParamsSchema, ListResultSchema, MkdirParamsSchema, MoveParamsSchema, OperationResultSchema, OperationStatusParamsSchema, PathSchema, RemoveParamsSchema, RenameParamsSchema, RootsParamsSchema, RootsResultSchema, SegmentSchema, StatParamsSchema, StatResultSchema } from "./schema.js";
+import { AccessErrorSchema, FileBytesParamsSchema, FileEntrySchema, FileTargetSchema, FilesChangedSchema, ListParamsSchema, ListResultSchema, MkdirParamsSchema, MoveFilesParamsSchema, MoveFilesResultSchema, OperationResultSchema, OperationStatusesParamsSchema, OperationStatusesResultSchema, PathSchema, RemoveFilesParamsSchema, RemoveFilesResultSchema, RenameParamsSchema, RootsParamsSchema, RootsResultSchema, SegmentSchema, StatsParamsSchema, StatsResultSchema } from "./schema.js";
 import { existsSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { randomUUID } from "node:crypto";
@@ -50,6 +50,143 @@ function accessError(error) {
 	return new FileAccessError(business in status ? business : "io-failed", status[business] ?? 500);
 }
 //#endregion
+//#region src/batches.ts
+const encoded = (value) => new TextEncoder().encode(JSON.stringify(value)).byteLength;
+/** Runs independent members with owner cancellation and complete serialized-member limits. */
+async function fileCollection(items, signal, work, maxItemBytes = Math.floor(8380416 / items.length)) {
+	const results = [];
+	for (const [index, target] of items.entries()) {
+		signal.throwIfAborted();
+		try {
+			const value = await work(target);
+			signal.throwIfAborted();
+			const member = {
+				index,
+				target,
+				ok: true,
+				value
+			};
+			if (encoded(member) > maxItemBytes) throw new FileAccessError("read-limit", 413);
+			results.push(member);
+		} catch (error) {
+			signal.throwIfAborted();
+			const failure = accessError(error);
+			results.push({
+				index,
+				target,
+				ok: false,
+				error: {
+					code: failure.code,
+					message: failure.message
+				}
+			});
+		}
+	}
+	return { results };
+}
+//#endregion
+//#region src/listings.ts
+/** Owner-local bounded immutable directory snapshots and opaque page cursors. */
+/** Keeps at most eight sixty-second snapshots; every page still revalidates current scope. */
+var Listings = class {
+	scope;
+	now;
+	snapshots = /* @__PURE__ */ new Map();
+	/** Shares the provider's scope and clock without retaining host descriptors. */
+	constructor(scope, now) {
+		this.scope = scope;
+		this.now = now;
+	}
+	/** Returns a 200-entry page of one immutable generation or refuses an expired/cross-target cursor. */
+	async list(params, signal) {
+		const selection = await this.scope.select(params.target, signal);
+		try {
+			const directory = selection.name ? await selection.parent.openDirectory([selection.name]) : selection.parent;
+			const current = this.scope.fingerprint(await directory.stat());
+			const now = this.now();
+			for (const [id, snapshot] of this.snapshots) if (now - snapshot.snapshotAt >= 6e4) this.snapshots.delete(id);
+			let snapshot;
+			let offset = 0;
+			if (params.cursor !== void 0) {
+				for (const candidate of this.snapshots.values()) for (const [position, cursor] of candidate.cursors) if (cursor === params.cursor) {
+					snapshot = candidate;
+					offset = position;
+				}
+				if (!snapshot || snapshot.target !== JSON.stringify(params.target)) throw new FileAccessError("stale-cursor", 409);
+			} else {
+				const observed = await directory.list(1e4);
+				const entries = [];
+				for (const item of observed) {
+					const path = [params.target.path, item.name].filter(Boolean).join("/");
+					if (item.observation.kind === "symlink") {
+						const linked = await this.scope.select({
+							...params.target,
+							path
+						}, signal);
+						try {
+							entries.push(this.scope.entry(linked));
+						} finally {
+							await linked.close();
+						}
+					} else entries.push(this.scope.entry({
+						...selection,
+						parent: directory,
+						name: item.name,
+						path: join(directory.path, item.name),
+						effectivePath: join(directory.path, item.name),
+						target: {
+							...params.target,
+							path
+						},
+						observation: item.observation
+					}));
+				}
+				if (this.scope.fingerprint(await directory.stat()) !== current) throw new FileAccessError("stale", 409);
+				const order = {
+					directory: 0,
+					file: 1,
+					symlink: 2,
+					other: 3
+				};
+				entries.sort((a, b) => order[a.kind] - order[b.kind] || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+				if (this.snapshots.size === 8) this.snapshots.delete(this.snapshots.keys().next().value);
+				snapshot = {
+					target: JSON.stringify(params.target),
+					entries,
+					listingId: randomUUID(),
+					snapshotAt: now,
+					fingerprint: current,
+					cursors: /* @__PURE__ */ new Map()
+				};
+				this.snapshots.set(snapshot.listingId, snapshot);
+			}
+			await selection.current();
+			const next = offset + 200;
+			let nextCursor;
+			if (next < snapshot.entries.length) {
+				nextCursor = snapshot.cursors.get(next) ?? randomUUID();
+				snapshot.cursors.set(next, nextCursor);
+			}
+			return {
+				entries: snapshot.entries.slice(offset, next),
+				nextCursor,
+				fingerprint: snapshot.fingerprint,
+				listingId: snapshot.listingId,
+				snapshotAt: snapshot.snapshotAt,
+				stale: snapshot.fingerprint !== current
+			};
+		} catch (error) {
+			throw accessError(error);
+		} finally {
+			await selection.close();
+		}
+	}
+	/** Releases in-memory generations on owner shutdown. */
+	close() {
+		this.snapshots.clear();
+	}
+};
+//#endregion
 //#region src/path-semantics.ts
 /** Host path syntax only; resolved object identity remains the platform's responsibility. */
 /** Requires an independent absolute root, excluding Windows drive-relative and root-relative forms. */
@@ -240,7 +377,8 @@ var FileScope = class {
 	referenceUri(selection) {
 		const formatted = this.referenceFormatter?.formatCurrent?.({
 			gatewayId: selection.snapshot.gatewayId,
-			...selection.target
+			pathStyle: this.paths.sep === "\\" ? "windows" : "posix",
+			absolutePath: selection.path
 		});
 		if (!formatted) throw new FileAccessError("unavailable", 503);
 		return formatted.uri;
@@ -256,108 +394,6 @@ var FileScope = class {
 	}
 };
 //#endregion
-//#region src/listings.ts
-/** Owner-local bounded immutable directory snapshots and opaque page cursors. */
-/** Keeps at most eight sixty-second snapshots; every page still revalidates current scope. */
-var Listings = class {
-	scope;
-	now;
-	snapshots = /* @__PURE__ */ new Map();
-	/** Shares the provider's scope and clock without retaining host descriptors. */
-	constructor(scope, now) {
-		this.scope = scope;
-		this.now = now;
-	}
-	/** Returns a 200-entry page of one immutable generation or refuses an expired/cross-target cursor. */
-	async list(params, signal) {
-		const selection = await this.scope.select(params.target, signal);
-		try {
-			const directory = selection.name ? await selection.parent.openDirectory([selection.name]) : selection.parent;
-			const current = this.scope.fingerprint(await directory.stat());
-			const now = this.now();
-			for (const [id, snapshot] of this.snapshots) if (now - snapshot.snapshotAt >= 6e4) this.snapshots.delete(id);
-			let snapshot;
-			let offset = 0;
-			if (params.cursor !== void 0) {
-				for (const candidate of this.snapshots.values()) for (const [position, cursor] of candidate.cursors) if (cursor === params.cursor) {
-					snapshot = candidate;
-					offset = position;
-				}
-				if (!snapshot || snapshot.target !== JSON.stringify(params.target)) throw new FileAccessError("stale-cursor", 409);
-			} else {
-				const observed = await directory.list(1e4);
-				const entries = [];
-				for (const item of observed) {
-					const path = [params.target.path, item.name].filter(Boolean).join("/");
-					if (item.observation.kind === "symlink") {
-						const linked = await this.scope.select({
-							...params.target,
-							path
-						}, signal);
-						try {
-							entries.push(this.scope.entry(linked));
-						} finally {
-							await linked.close();
-						}
-					} else entries.push(this.scope.entry({
-						...selection,
-						parent: directory,
-						name: item.name,
-						path: join(directory.path, item.name),
-						effectivePath: join(directory.path, item.name),
-						target: {
-							...params.target,
-							path
-						},
-						observation: item.observation
-					}));
-				}
-				if (this.scope.fingerprint(await directory.stat()) !== current) throw new FileAccessError("stale", 409);
-				const order = {
-					directory: 0,
-					file: 1,
-					symlink: 2,
-					other: 3
-				};
-				entries.sort((a, b) => order[a.kind] - order[b.kind] || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
-				if (this.snapshots.size === 8) this.snapshots.delete(this.snapshots.keys().next().value);
-				snapshot = {
-					target: JSON.stringify(params.target),
-					entries,
-					listingId: randomUUID(),
-					snapshotAt: now,
-					fingerprint: current,
-					cursors: /* @__PURE__ */ new Map()
-				};
-				this.snapshots.set(snapshot.listingId, snapshot);
-			}
-			await selection.current();
-			const next = offset + 200;
-			let nextCursor;
-			if (next < snapshot.entries.length) {
-				nextCursor = snapshot.cursors.get(next) ?? randomUUID();
-				snapshot.cursors.set(next, nextCursor);
-			}
-			return {
-				entries: snapshot.entries.slice(offset, next),
-				nextCursor,
-				fingerprint: snapshot.fingerprint,
-				listingId: snapshot.listingId,
-				snapshotAt: snapshot.snapshotAt,
-				stale: snapshot.fingerprint !== current
-			};
-		} catch (error) {
-			throw accessError(error);
-		} finally {
-			await selection.close();
-		}
-	}
-	/** Releases in-memory generations on owner shutdown. */
-	close() {
-		this.snapshots.clear();
-	}
-};
-//#endregion
 //#region src/locks.ts
 /** Atomic acquisition of ordered canonical path sets prevents opposing moves from deadlocking. */
 /** Serializes overlapping selected paths, including recursive ancestors. */
@@ -1243,6 +1279,27 @@ function registerFileExplorer(ctx) {
 		signal: ctx.signal,
 		instanceId: identity.instanceId
 	});
+	const changed = ctx.client.registerFrame({
+		name: "changed",
+		delivery: "broadcast",
+		payload: FilesChangedSchema
+	});
+	const announced = /* @__PURE__ */ new WeakSet();
+	async function mutate(items, request, work, workspace) {
+		const workspaces = /* @__PURE__ */ new Set();
+		try {
+			return await fileCollection(items, AbortSignal.any([ctx.signal, request]), async (item) => {
+				const value = await work(item, request);
+				if (!announced.has(value) && (value.status === "succeeded" || value.error?.details?.destinationCommitted)) {
+					announced.add(value);
+					workspaces.add(workspace(item));
+				}
+				return value;
+			});
+		} finally {
+			if (workspaces.size && !ctx.signal.aborted) changed.emit({ workspaces: [...workspaces] });
+		}
+	}
 	const drain = () => provider.close();
 	const unbind = ctx.services.get("work-lifecycle").register(drain);
 	ctx.onDispose(async () => {
@@ -1262,10 +1319,10 @@ function registerFileExplorer(ctx) {
 		handle: (params, call) => provider.list(params, call.signal)
 	});
 	ctx.client.registerMethod({
-		name: "stat",
-		params: StatParamsSchema,
-		result: StatResultSchema,
-		handle: (params, call) => provider.stat(params.target, call.signal)
+		name: "stats",
+		params: StatsParamsSchema,
+		result: StatsResultSchema,
+		handle: (params, call) => fileCollection(params.targets, AbortSignal.any([ctx.signal, call.signal]), (target) => provider.stat(target, call.signal), params.maxItemBytes)
 	});
 	ctx.client.registerMethod({
 		name: "mkdir",
@@ -1280,22 +1337,25 @@ function registerFileExplorer(ctx) {
 		handle: (params, call) => provider.rename(params, call.signal)
 	});
 	ctx.client.registerMethod({
-		name: "move",
-		params: MoveParamsSchema,
-		result: OperationResultSchema,
-		handle: (params, call) => provider.move(params, call.signal)
+		name: "moveFiles",
+		params: MoveFilesParamsSchema,
+		result: MoveFilesResultSchema,
+		handle: (params, call) => mutate(params.items, call.signal, provider.move, (item) => item.source.workspaceId)
 	});
 	ctx.client.registerMethod({
-		name: "remove",
-		params: RemoveParamsSchema,
-		result: OperationResultSchema,
-		handle: (params, call) => provider.remove(params, call.signal)
+		name: "removeFiles",
+		params: RemoveFilesParamsSchema,
+		result: RemoveFilesResultSchema,
+		handle: (params, call) => mutate(params.items, call.signal, provider.remove, (item) => item.target.workspaceId)
 	});
 	ctx.client.registerMethod({
-		name: "operationStatus",
-		params: OperationStatusParamsSchema,
-		result: OperationResultSchema,
-		handle: (params) => provider.operationStatus(params)
+		name: "operationStatuses",
+		params: OperationStatusesParamsSchema,
+		result: OperationStatusesResultSchema,
+		handle: (params, call) => fileCollection(params.operationIds, AbortSignal.any([ctx.signal, call.signal]), (operationId) => provider.operationStatus({
+			instanceId: params.instanceId,
+			operationId
+		}), params.maxItemBytes)
 	});
 	ctx.client.registerResource({
 		name: "fileBytes",
@@ -1314,7 +1374,7 @@ function registerFileExplorer(ctx) {
 }
 const plugin = {
 	name: "@eum-agent/file-explorer",
-	dependencies: { "@eum-agent/file-references": "1.0.0" },
+	dependencies: { "@eum-agent/file-references": "1.1.0" },
 	requires: [
 		"client-files",
 		"workspace-roots",

package/dist/schema.js

@@ -142,5 +142,74 @@ const OperationStatusParamsSchema = z.object({
 	instanceId: GatewayIdSchema,
 	operationId: z.uuid()
 }).strict();
+const encoded = (value) => new TextEncoder().encode(JSON.stringify(value)).byteLength;
+const budget = {
+	maxItemBytes: z.number().int().min(1).max(8388608).default(262144),
+	maxTotalBytes: z.number().int().min(1).max(8388608).default(8388608)
+};
+/** Rejects input and declared normalized response costs before any filesystem work. */
+function admit(input, targets, memberBytes, totalBytes, ctx) {
+	if (encoded(input) * 2 > 8388608 || targets.length * memberBytes + 8192 > totalBytes || targets.some((target) => encoded(target) + 4096 > memberBytes)) ctx.addIssue({
+		code: "custom",
+		message: "File collection exceeds its byte budget"
+	});
+}
+/** Complete file observations with independent encoded response budgets. */
+const StatsParamsSchema = z.object({
+	targets: z.array(FileTargetSchema).min(1).max(64),
+	...budget
+}).strict().superRefine((p, ctx) => admit(p, p.targets, p.maxItemBytes, p.maxTotalBytes, ctx));
+/** Retained operation queries never execute work, including unknown identities. */
+const OperationStatusesParamsSchema = z.object({
+	instanceId: GatewayIdSchema,
+	operationIds: z.array(z.uuid()).min(1).max(64),
+	...budget
+}).strict().superRefine((p, ctx) => admit(p, p.operationIds, p.maxItemBytes, p.maxTotalBytes, ctx));
+/** Validates complete mutation members and refuses conflicting reuse before any member starts. */
+function mutations(schema) {
+	return z.object({ items: z.array(schema).min(1).max(64) }).strict().superRefine((p, ctx) => {
+		if (encoded(p) * 2 > 8388608) ctx.addIssue({
+			code: "custom",
+			message: "File collection exceeds its byte budget"
+		});
+		const identities = /* @__PURE__ */ new Map();
+		for (const member of p.items) {
+			const input = JSON.stringify(member);
+			if (identities.has(member.operationId) && identities.get(member.operationId) !== input) ctx.addIssue({
+				code: "custom",
+				message: "Operation identity has conflicting members"
+			});
+			identities.set(member.operationId, input);
+		}
+	});
+}
+/** Each move retains its own complete operation identity and physical outcome. */
+const MoveFilesParamsSchema = mutations(MoveParamsSchema);
+/** Each removal retains its own selected fingerprint and recursive decision. */
+const RemoveFilesParamsSchema = mutations(RemoveParamsSchema);
+/** One notification lists all workspaces physically changed by this collection. */
+const FilesChangedSchema = z.object({ workspaces: z.array(IdentitySchema).min(1).max(64) }).strict();
+/** Complete successful members and bounded safe refusals retain their original order. */
+function collectionResult(target, value) {
+	return z.object({ results: z.array(z.discriminatedUnion("ok", [z.object({
+		index: z.number().int().min(0).max(63),
+		target,
+		ok: z.literal(true),
+		value
+	}).strict(), z.object({
+		index: z.number().int().min(0).max(63),
+		target,
+		ok: z.literal(false),
+		error: AccessErrorSchema
+	}).strict()])).min(1).max(64) }).strict();
+}
+/** Ordered explicit file observations. */
+const StatsResultSchema = collectionResult(FileTargetSchema, StatResultSchema);
+/** Ordered retained operation facts. */
+const OperationStatusesResultSchema = collectionResult(z.uuid(), OperationResultSchema);
+/** Ordered move results keep complete immutable operation members as their safe target. */
+const MoveFilesResultSchema = collectionResult(MoveParamsSchema, OperationResultSchema);
+/** Ordered removal results keep complete immutable operation members as their safe target. */
+const RemoveFilesResultSchema = collectionResult(RemoveParamsSchema, OperationResultSchema);
 //#endregion
-export { AccessErrorSchema, DigestSchema, ErrorDetailsSchema, FileBytesParamsSchema, FileEntrySchema, FileSourceObservationSchema, FileTargetSchema, GatewayIdSchema, IdentitySchema, ListParamsSchema, ListResultSchema, MkdirParamsSchema, MoveParamsSchema, OperationResultSchema, OperationStatusParamsSchema, PathSchema, RemoveParamsSchema, RenameParamsSchema, RootsParamsSchema, RootsResultSchema, SegmentSchema, StatParamsSchema, StatResultSchema };
+export { AccessErrorSchema, DigestSchema, ErrorDetailsSchema, FileBytesParamsSchema, FileEntrySchema, FileSourceObservationSchema, FileTargetSchema, FilesChangedSchema, GatewayIdSchema, IdentitySchema, ListParamsSchema, ListResultSchema, MkdirParamsSchema, MoveFilesParamsSchema, MoveFilesResultSchema, MoveParamsSchema, OperationResultSchema, OperationStatusParamsSchema, OperationStatusesParamsSchema, OperationStatusesResultSchema, PathSchema, RemoveFilesParamsSchema, RemoveFilesResultSchema, RemoveParamsSchema, RenameParamsSchema, RootsParamsSchema, RootsResultSchema, SegmentSchema, StatParamsSchema, StatResultSchema, StatsParamsSchema, StatsResultSchema, collectionResult };

package/package.json

@@ -4,7 +4,7 @@
     "en-US": "Workspace Files",
     "zh-CN": "工作空间文件"
   },
-  "version": "1.0.0",
+  "version": "1.1.0",
   "type": "module",
   "description": "Sessionless workspace file browsing, transfers and private references",
   "license": "MIT",
@@ -24,14 +24,14 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@eum-agent/plugin": "1.0.0",
+    "@eum-agent/plugin": "1.1.0",
     "@eum-agent/protocol": "1.0.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.5",
     "vite": "^8.2.2",
-    "@eum-agent/infra-local": "1.0.0"
+    "@eum-agent/infra-local": "1.0.1"
   },
   "yaoguang": {
     "description": {
@@ -39,11 +39,11 @@
       "zh-CN": "独立的工作区文件浏览、传输与私有引用"
     },
     "dependencies": {
-      "@eum-agent/file-references": "1.0.0"
+      "@eum-agent/file-references": "1.1.0"
     },
     "kind": "extension",
     "foundationDependencies": {
-      "@eum-agent/infra-local": "1.0.0"
+      "@eum-agent/infra-local": "1.0.1"
     }
   },
   "scripts": {

package/ui/ui.js

@@ -2163,6 +2163,62 @@ var $ZodUnion = /*@__PURE__*/ $constructor("$ZodUnion", (inst, def) => {
 		});
 	};
 });
+var $ZodDiscriminatedUnion = /*@__PURE__*/ $constructor("$ZodDiscriminatedUnion", (inst, def) => {
+	def.inclusive = false;
+	$ZodUnion.init(inst, def);
+	const _super = inst._zod.parse;
+	defineLazy(inst._zod, "propValues", () => {
+		const propValues = {};
+		for (const option of def.options) {
+			const pv = option._zod.propValues;
+			if (!pv || Object.keys(pv).length === 0) throw new Error(`Invalid discriminated union option at index "${def.options.indexOf(option)}"`);
+			for (const [k, v] of Object.entries(pv)) {
+				if (!propValues[k]) propValues[k] = /* @__PURE__ */ new Set();
+				for (const val of v) propValues[k].add(val);
+			}
+		}
+		return propValues;
+	});
+	const disc = cached(() => {
+		const opts = def.options;
+		const map = /* @__PURE__ */ new Map();
+		for (const o of opts) {
+			const values = o._zod.propValues?.[def.discriminator];
+			if (!values || values.size === 0) throw new Error(`Invalid discriminated union option at index "${def.options.indexOf(o)}"`);
+			for (const v of values) {
+				if (map.has(v)) throw new Error(`Duplicate discriminator value "${String(v)}"`);
+				map.set(v, o);
+			}
+		}
+		return map;
+	});
+	inst._zod.parse = (payload, ctx) => {
+		const input = payload.value;
+		if (!isObject(input)) {
+			payload.issues.push({
+				code: "invalid_type",
+				expected: "object",
+				input,
+				inst
+			});
+			return payload;
+		}
+		const opt = disc.value.get(input?.[def.discriminator]);
+		if (opt) return opt._zod.run(payload, ctx);
+		if (def.unionFallback || ctx.direction === "backward") return _super(payload, ctx);
+		payload.issues.push({
+			code: "invalid_union",
+			errors: [],
+			note: "No matching discriminator",
+			discriminator: def.discriminator,
+			options: Array.from(disc.value.keys()),
+			input,
+			path: [def.discriminator],
+			inst
+		});
+		return payload;
+	};
+});
 var $ZodIntersection = /*@__PURE__*/ $constructor("$ZodIntersection", (inst, def) => {
 	$ZodType.init(inst, def);
 	inst._zod.parse = (payload, ctx) => {
@@ -4215,6 +4271,18 @@ function union(options, params) {
 		...normalizeParams(params)
 	});
 }
+var ZodDiscriminatedUnion = /*@__PURE__*/ $constructor("ZodDiscriminatedUnion", (inst, def) => {
+	ZodUnion.init(inst, def);
+	$ZodDiscriminatedUnion.init(inst, def);
+});
+function discriminatedUnion(discriminator, options, params) {
+	return new ZodDiscriminatedUnion({
+		type: "union",
+		options,
+		discriminator,
+		...normalizeParams(params)
+	});
+}
 var ZodIntersection = /*@__PURE__*/ $constructor("ZodIntersection", (inst, def) => {
 	$ZodIntersection.init(inst, def);
 	ZodType.init(inst, def);
@@ -4466,7 +4534,8 @@ var FileTargetSchema = object({
 	path: PathSchema
 }).strict();
 object({ workspaceId: IdentitySchema }).strict();
-object({ target: FileTargetSchema }).strict();
+/** Stat always names one explicit current root-relative selection. */
+var StatParamsSchema = object({ target: FileTargetSchema }).strict();
 /** Display metadata for one current filesystem object. */
 var FileEntrySchema = object({
 	name: string(),
@@ -4518,8 +4587,7 @@ var FileSourceObservationSchema = object({
 	size: number().int().nonnegative().max(Number.MAX_SAFE_INTEGER),
 	modifiedAt: number().min(-864e13).max(864e13)
 }).strict();
-/** File resource business parameters; PUT additionally requires operationId and source. */
-var FileBytesParamsSchema = object({
+object({
 	target: FileTargetSchema,
 	expectedFingerprint: DigestSchema.optional(),
 	operationId: uuid().optional(),
@@ -4564,7 +4632,8 @@ object({
 	replace: boolean().optional(),
 	targetFingerprint: DigestSchema.optional()
 }).strict();
-object({
+/** Same-workspace move to an explicit final target path. */
+var MoveParamsSchema = object({
 	source: FileTargetSchema,
 	destination: FileTargetSchema,
 	sourceFingerprint: DigestSchema,
@@ -4572,30 +4641,206 @@ object({
 	replace: boolean().optional(),
 	targetFingerprint: DigestSchema.optional()
 }).strict();
-object({
+/** Removal requires the selected revision and an explicit recursive choice. */
+var RemoveParamsSchema = object({
 	target: FileTargetSchema,
 	fingerprint: DigestSchema,
 	recursive: boolean(),
 	operationId: uuid()
 }).strict();
-object({
+/** Query retained facts without executing an operation. */
+var OperationStatusParamsSchema = object({
 	instanceId: GatewayIdSchema,
 	operationId: uuid()
 }).strict();
-//#endregion
-//#region ui-src/references.ts
-/** Formats an explicit current file without reading it or changing the selected workspace. */
-function currentReference(ctx, gatewayId, workspaceId, rootId, path) {
-	const reader = ctx.services.get("file-reference-reader");
-	if (!reader) throw Object.assign(/* @__PURE__ */ new Error("Reference reader unavailable"), { code: "unavailable" });
-	return reader.format({
-		kind: "workspace-file",
-		gatewayId,
-		workspaceId,
-		rootId,
-		path
+var encoded = (value) => new TextEncoder().encode(JSON.stringify(value)).byteLength;
+var budget = {
+	maxItemBytes: number().int().min(1).max(8388608).default(262144),
+	maxTotalBytes: number().int().min(1).max(8388608).default(8388608)
+};
+/** Rejects input and declared normalized response costs before any filesystem work. */
+function admit(input, targets, memberBytes, totalBytes, ctx) {
+	if (encoded(input) * 2 > 8388608 || targets.length * memberBytes + 8192 > totalBytes || targets.some((target) => encoded(target) + 4096 > memberBytes)) ctx.addIssue({
+		code: "custom",
+		message: "File collection exceeds its byte budget"
 	});
 }
+object({
+	targets: array(FileTargetSchema).min(1).max(64),
+	...budget
+}).strict().superRefine((p, ctx) => admit(p, p.targets, p.maxItemBytes, p.maxTotalBytes, ctx));
+object({
+	instanceId: GatewayIdSchema,
+	operationIds: array(uuid()).min(1).max(64),
+	...budget
+}).strict().superRefine((p, ctx) => admit(p, p.operationIds, p.maxItemBytes, p.maxTotalBytes, ctx));
+/** Validates complete mutation members and refuses conflicting reuse before any member starts. */
+function mutations(schema) {
+	return object({ items: array(schema).min(1).max(64) }).strict().superRefine((p, ctx) => {
+		if (encoded(p) * 2 > 8388608) ctx.addIssue({
+			code: "custom",
+			message: "File collection exceeds its byte budget"
+		});
+		const identities = /* @__PURE__ */ new Map();
+		for (const member of p.items) {
+			const input = JSON.stringify(member);
+			if (identities.has(member.operationId) && identities.get(member.operationId) !== input) ctx.addIssue({
+				code: "custom",
+				message: "Operation identity has conflicting members"
+			});
+			identities.set(member.operationId, input);
+		}
+	});
+}
+mutations(MoveParamsSchema);
+mutations(RemoveParamsSchema);
+/** One notification lists all workspaces physically changed by this collection. */
+var FilesChangedSchema = object({ workspaces: array(IdentitySchema).min(1).max(64) }).strict();
+/** Complete successful members and bounded safe refusals retain their original order. */
+function collectionResult(target, value) {
+	return object({ results: array(discriminatedUnion("ok", [object({
+		index: number().int().min(0).max(63),
+		target,
+		ok: literal(true),
+		value
+	}).strict(), object({
+		index: number().int().min(0).max(63),
+		target,
+		ok: literal(false),
+		error: AccessErrorSchema
+	}).strict()])).min(1).max(64) }).strict();
+}
+/** Ordered explicit file observations. */
+var StatsResultSchema = collectionResult(FileTargetSchema, StatResultSchema);
+/** Ordered retained operation facts. */
+var OperationStatusesResultSchema = collectionResult(uuid(), OperationResultSchema);
+/** Ordered move results keep complete immutable operation members as their safe target. */
+var MoveFilesResultSchema = collectionResult(MoveParamsSchema, OperationResultSchema);
+/** Ordered removal results keep complete immutable operation members as their safe target. */
+var RemoveFilesResultSchema = collectionResult(RemoveParamsSchema, OperationResultSchema);
+//#endregion
+//#region ui-src/collections.ts
+/** Owner-local coalescing turns concurrent file intents into actual collection RPCs. */
+var inputs = {
+	stat: StatParamsSchema,
+	move: MoveParamsSchema,
+	remove: RemoveParamsSchema,
+	operationStatus: OperationStatusParamsSchema
+};
+var definitions = {
+	stat: {
+		name: "stats",
+		key: "targets",
+		limit: 31,
+		result: StatsResultSchema
+	},
+	move: {
+		name: "moveFiles",
+		key: "items",
+		limit: 64,
+		result: MoveFilesResultSchema
+	},
+	remove: {
+		name: "removeFiles",
+		key: "items",
+		limit: 64,
+		result: RemoveFilesResultSchema
+	},
+	operationStatus: {
+		name: "operationStatuses",
+		key: "operationIds",
+		limit: 31,
+		result: OperationStatusesResultSchema
+	}
+};
+/** Groups only one owner and exact shared startup identity; each consumer retains cancellation. */
+var FileCollections = class {
+	invoke;
+	run;
+	groups = /* @__PURE__ */ new Map();
+	scheduled = false;
+	/** Uses the owner's existing bounded transport admission, with no automatic mutation retries. */
+	constructor(invoke, run) {
+		this.invoke = invoke;
+		this.run = run;
+	}
+	/** Queues one validated control intent and preserves its complete independent operation identity. */
+	enqueue(method, params, signal) {
+		signal.throwIfAborted();
+		const input = inputs[method].parse(params);
+		const instanceId = "instanceId" in input ? input.instanceId : void 0;
+		const target = method === "stat" && "target" in input ? input.target : method === "operationStatus" && "operationId" in input ? input.operationId : input;
+		const key = JSON.stringify([method, instanceId]);
+		const group = this.groups.get(key) ?? {
+			method,
+			instanceId,
+			items: []
+		};
+		this.groups.set(key, group);
+		const promise = new Promise((resolve, reject) => {
+			const item = {
+				input,
+				target,
+				signal,
+				resolve,
+				reject,
+				done: false,
+				abort: () => {
+					if (item.done) return;
+					item.done = true;
+					signal.removeEventListener("abort", item.abort);
+					reject(signal.reason);
+				}
+			};
+			group.items.push(item);
+			signal.addEventListener("abort", item.abort, { once: true });
+		});
+		if (!this.scheduled) {
+			this.scheduled = true;
+			queueMicrotask(() => this.flush());
+		}
+		return promise;
+	}
+	flush() {
+		this.scheduled = false;
+		const groups = this.groups;
+		this.groups = /* @__PURE__ */ new Map();
+		for (const group of groups.values()) {
+			const definition = definitions[group.method];
+			const active = group.items.filter((item) => !item.done);
+			for (let start = 0; start < active.length; start += definition.limit) this.dispatch(group, active.slice(start, start + definition.limit));
+		}
+	}
+	finish(item, value, error) {
+		if (item.done) return;
+		item.done = true;
+		item.signal.removeEventListener("abort", item.abort);
+		if (error !== void 0) item.reject(error);
+		else item.resolve(value);
+	}
+	async dispatch(group, queued) {
+		try {
+			await this.run(async () => {
+				const items = queued.filter((item) => !item.done);
+				if (!items.length) return;
+				const definition = definitions[group.method];
+				const params = {
+					...group.instanceId === void 0 ? {} : { instanceId: group.instanceId },
+					[definition.key]: items.map((item) => item.target)
+				};
+				const result = definition.result.parse(await this.invoke(definition.name, params));
+				if (result.results.length !== items.length || result.results.some((member, index) => member.index !== index || JSON.stringify(member.target) !== JSON.stringify(items[index]?.target))) throw Object.assign(/* @__PURE__ */ new Error("File collection returned unexpected members"), { code: "io-failed" });
+				for (const [index, item] of items.entries()) {
+					const member = result.results[index];
+					if (member.ok) this.finish(item, member.value);
+					else this.finish(item, void 0, Object.assign(new Error(member.error.message), member.error));
+				}
+			});
+		} catch (error) {
+			for (const item of queued) this.finish(item, void 0, error);
+		}
+	}
+};
 //#endregion
 //#region ui-src/api.ts
 var results = {
@@ -4619,10 +4864,20 @@ function errorCode(error) {
 var FileApi = class {
 	active = 0;
 	waiting = [];
+	collections;
 	ctx;
 	/** Receives public browser ports only. */
 	constructor(ctx) {
 		this.ctx = ctx;
+		this.collections = new FileCollections((method, params) => ctx.invoke(method, params), async (work) => {
+			await this.permit(ctx.signal);
+			try {
+				ctx.signal.throwIfAborted();
+				await work();
+			} finally {
+				this.release();
+			}
+		});
 	}
 	/** Reads installation identity and the current authenticated resource surface. */
 	async bootstrap(signal) {
@@ -4676,6 +4931,11 @@ var FileApi = class {
 	/** Validates owner results once against the sole server/browser business schema. */
 	async invoke(method, params, signal) {
 		signal.throwIfAborted();
+		if (method === "stat" || method === "move" || method === "remove" || method === "operationStatus") {
+			const value = await this.collections.enqueue(method, params, signal);
+			signal.throwIfAborted();
+			return results[method].parse(value);
+		}
 		await this.permit(signal);
 		try {
 			signal.throwIfAborted();
@@ -5033,7 +5293,7 @@ var FileActions = class {
 			this.context.signal
 		]);
 		const observed = await this.api.invoke("stat", { target }, signal);
-		const value = kind === "path" ? observed.realPath : currentReference(this.ctx, session.identity.gatewayId, target.workspaceId, target.rootId, target.path);
+		const value = kind === "path" ? observed.realPath : observed.entry.uri;
 		try {
 			await navigator.clipboard.writeText(value);
 			signal.throwIfAborted();
@@ -5182,7 +5442,7 @@ var FileTransfers = class {
 					id: this.ctx.uuid(),
 					batch,
 					name: file.name,
-					reference: currentReference(this.ctx, session.identity.gatewayId, directory.workspaceId, directory.rootId, [directory.path, file.name].filter(Boolean).join("/")),
+					reference: [directory.path, file.name].filter(Boolean).join("/"),
 					size: file.size,
 					modifiedAt: file.lastModified,
 					direction: "upload",
@@ -5203,8 +5463,8 @@ var FileTransfers = class {
 		this.jobs.push(...jobs);
 		this.emit();
 		(async () => {
-			for (const job of jobs) {
-				if (job.record.status !== "waiting") continue;
+			await Promise.all(jobs.map(async (job) => {
+				if (job.record.status !== "waiting") return;
 				try {
 					job.observed = await this.observe(job);
 					if (job.observed) this.update(job, {
@@ -5217,7 +5477,7 @@ var FileTransfers = class {
 						error: errorCode(error)
 					});
 				}
-			}
+			}));
 			for (const job of jobs) job.prepared = true;
 			if (generation === this.generation) this.pump();
 		})();
@@ -5237,8 +5497,8 @@ var FileTransfers = class {
 	* Rejects genuine selection or admission failures without creating a transfer record.
 	*/
 	async download(session, descriptor, params, metadata) {
-		const current = FileBytesParamsSchema.safeParse(params);
-		const reference = current.success ? currentReference(this.ctx, session.identity.gatewayId, current.data.target.workspaceId, current.data.target.rootId, current.data.target.path) : void 0;
+		const current = FileEntrySchema.safeParse(metadata.metadata);
+		const reference = current.success ? current.data.uri : void 0;
 		if (!reference) throw Object.assign(/* @__PURE__ */ new Error("download identity missing"), { code: "invalid-params" });
 		this.capacity(1);
 		const controller = new AbortController();
@@ -5263,7 +5523,7 @@ var FileTransfers = class {
 					direction: "download",
 					status: "waiting",
 					size: metadata.bytes.contentLength,
-					target: current.success ? current.data.target : void 0
+					target: FileTargetSchema.safeParse(params && typeof params === "object" && "target" in params ? params.target : void 0).data
 				},
 				session,
 				controller,
@@ -5434,7 +5694,7 @@ var FileTransfers = class {
 				const path = [target.path.split("/").slice(0, -1).join("/"), valid].filter(Boolean).join("/");
 				this.update(job, {
 					name: valid,
-					reference: currentReference(this.ctx, job.session.identity.gatewayId, target.workspaceId, target.rootId, path),
+					reference: path,
 					target: {
 						...target,
 						path
@@ -5511,117 +5771,40 @@ var FileTransfers = class {
 };
 //#endregion
 //#region ui-src/viewer.ts
-/** Validates decoded raster dimensions without retaining the bitmap or temporary URL. */
-async function decodeImage(blob, signal) {
-	signal.throwIfAborted();
-	if (typeof createImageBitmap === "function") {
-		const bitmap = await createImageBitmap(blob);
-		try {
-			signal.throwIfAborted();
-			if (bitmap.width > 1e4 || bitmap.height > 1e4) throw Object.assign(/* @__PURE__ */ new Error("image side too large"), { code: "preview-too-large" });
-		} finally {
-			bitmap.close();
-		}
-		return;
-	}
-	const url = URL.createObjectURL(blob);
-	try {
-		await new Promise((resolve, reject) => {
-			const image = new Image();
-			const stop = () => {
-				image.src = "";
-				reject(signal.reason);
-			};
-			const clear = () => {
-				signal.removeEventListener("abort", stop);
-				image.onload = null;
-				image.onerror = null;
-			};
-			signal.addEventListener("abort", stop, { once: true });
-			image.onload = () => {
-				clear();
-				if (image.naturalWidth > 1e4 || image.naturalHeight > 1e4) reject(Object.assign(/* @__PURE__ */ new Error("image side too large"), { code: "preview-too-large" }));
-				else resolve();
-			};
-			image.onerror = () => {
-				clear();
-				reject(Object.assign(/* @__PURE__ */ new Error("image decode failed"), { code: "unsupported-preview" }));
-			};
-			image.src = url;
-		});
-		signal.throwIfAborted();
-	} finally {
-		URL.revokeObjectURL(url);
-	}
-}
-var imageTypes = {
-	png: "image/png",
-	jpg: "image/jpeg",
-	jpeg: "image/jpeg",
-	gif: "image/gif",
-	webp: "image/webp",
-	bmp: "image/bmp",
-	avif: "image/avif"
-};
-function rasterBytes(bytes, mime) {
-	const ascii = (start, end) => new TextDecoder("ascii").decode(bytes.subarray(start, end));
-	if (!(mime === "image/png" ? [
-		137,
-		80,
-		78,
-		71,
-		13,
-		10,
-		26,
-		10
-	].every((v, i) => bytes[i] === v) : mime === "image/jpeg" ? bytes[0] === 255 && bytes[1] === 216 && bytes[2] === 255 : mime === "image/gif" ? ["GIF87a", "GIF89a"].includes(ascii(0, 6)) : mime === "image/webp" ? ascii(0, 4) === "RIFF" && ascii(8, 12) === "WEBP" : mime === "image/bmp" ? ascii(0, 2) === "BM" : mime === "image/avif" ? ascii(4, 8) === "ftyp" && ["avif", "avis"].includes(ascii(8, 12)) : false)) throw Object.assign(/* @__PURE__ */ new Error("raster signature mismatch"), { code: "unsupported-preview" });
-}
-var languages = {
-	svg: "xml",
-	html: "html",
-	htm: "html",
-	xml: "xml",
-	json: "json",
-	js: "javascript",
-	ts: "typescript",
-	tsx: "typescript",
-	jsx: "javascript",
-	css: "css",
-	py: "python",
-	sh: "shell",
-	md: "markdown",
-	yaml: "yaml",
-	yml: "yaml",
-	c: "c",
-	h: "c",
-	rs: "rust",
-	go: "go",
-	sql: "sql"
-};
-var textExtensions = /* @__PURE__ */ new Set([
-	"txt",
-	"log",
-	"csv",
-	"ini",
-	"conf",
-	...Object.keys(languages)
-]);
-/** Owns bounded previews of the optional file-management page selection. */
+/** Adapts the shared readonly preview to the Files selection lifetime, without a second renderer. */
 var FileViewer = class {
-	ctx;
-	decode;
-	controller = new AbortController();
 	state;
-	url;
 	listeners = /* @__PURE__ */ new Set();
-	/** Receives public ports and an injectable decoder for DOM-only fixtures. */
-	constructor(ctx, decode = decodeImage) {
+	stop;
+	controller = new AbortController();
+	ctx;
+	/** Reader withdrawal invalidates the sidebar and all its download affordances synchronously. */
+	constructor(ctx) {
 		this.ctx = ctx;
-		this.decode = decode;
+		const off = ctx.services.subscribe("file-reference-reader", () => {
+			if (!ctx.services.get("file-reference-reader") && this.state) {
+				const href = this.state.href, name = this.state.name;
+				this.close();
+				this.state = {
+					href,
+					name,
+					content: {
+						status: "unavailable",
+						lifecycle: "closed",
+						canDownload: false
+					}
+				};
+				this.emit();
+			}
+		});
+		ctx.signal.addEventListener("abort", () => {
+			off();
+			this.close();
+		}, { once: true });
 	}
-	/** Returns this owner's dialog state. */
+	/** Current immutable sidebar projection. */
 	get = () => this.state;
-	/** Observes preview progress and safe failure states. */
+	/** Observes shared content progress and selection changes. */
 	subscribe = (listener) => {
 		this.listeners.add(listener);
 		return () => {
@@ -5631,67 +5814,7 @@ var FileViewer = class {
 	emit() {
 		for (const listener of this.listeners) listener();
 	}
-	patch(value) {
-		if (!this.state) return;
-		this.state = {
-			...this.state,
-			...value
-		};
-		this.emit();
-	}
-	async source(session, href, signal, selected, expectedFingerprint) {
-		const reader = this.ctx.services.get("file-reference-reader");
-		if (!reader) throw Object.assign(/* @__PURE__ */ new Error("Reference reader unavailable"), { code: "unavailable" });
-		const description = await reader.describe(href, signal);
-		signal.throwIfAborted();
-		const entry = description.source.kind === "workspace-file" ? FileEntrySchema.extend({ realPath: string().optional() }).parse(description.metadata.metadata) : void 0;
-		const stat = entry ? {
-			entry,
-			realPath: entry.realPath ?? ""
-		} : void 0;
-		if (expectedFingerprint && stat?.entry.fingerprint !== expectedFingerprint) throw Object.assign(/* @__PURE__ */ new Error("Selected file changed"), { code: "stale" });
-		const metadata = description.metadata;
-		selected?.({
-			stat,
-			params: description.params,
-			descriptor: description.resource,
-			name: description.name
-		});
-		return {
-			stat,
-			params: description.params,
-			descriptor: description.resource,
-			metadata: entry?.kind === "directory" ? void 0 : metadata,
-			name: description.name
-		};
-	}
-	async collect(descriptor, params, metadata, limit, signal) {
-		if (metadata.bytes.contentLength > limit) throw Object.assign(/* @__PURE__ */ new Error("preview input too large"), { code: "preview-too-large" });
-		const read = await this.ctx.bytes.read(descriptor, params, { signal });
-		try {
-			signal.throwIfAborted();
-			if (read.bytes.contentLength > limit || read.bytes.contentLength !== metadata.bytes.contentLength) throw Object.assign(/* @__PURE__ */ new Error("preview changed"), { code: "preview-too-large" });
-			const chunks = [];
-			let length = 0;
-			for await (const chunk of read.body) {
-				signal.throwIfAborted();
-				length += chunk.byteLength;
-				if (length > limit || length > read.bytes.contentLength) throw Object.assign(/* @__PURE__ */ new Error("preview grew"), { code: "preview-too-large" });
-				chunks.push(chunk);
-			}
-			if (length !== read.bytes.contentLength) throw Object.assign(/* @__PURE__ */ new Error("preview length mismatch"), { code: "io-failed" });
-			const result = new Uint8Array(length);
-			let offset = 0;
-			for (const chunk of chunks) {
-				result.set(chunk, offset);
-				offset += chunk.length;
-			}
-			return result;
-		} finally {
-			await read.close();
-		}
-	}
-	/** Reads bounded content for one reference; an optional listing fingerprint refuses changed sources. */
+	/** Creates its own preview, independently of an already open reader dialog. */
 	async open(session, href, expectedFingerprint) {
 		this.close();
 		this.controller = new AbortController();
@@ -5700,84 +5823,60 @@ var FileViewer = class {
 			session.signal,
 			this.controller.signal
 		]);
-		this.state = {
-			href,
-			name: href,
-			content: { status: "loading" },
-			original: false,
-			zoom: 1
+		const reader = this.ctx.services.get("file-reference-reader");
+		if (!reader) {
+			this.state = {
+				href,
+				name: href,
+				content: {
+					status: "unavailable",
+					lifecycle: "closed",
+					canDownload: false
+				}
+			};
+			this.emit();
+			return;
+		}
+		const handle = reader.createPreview({
+			uri: href,
+			expectedFingerprint
+		});
+		const update = () => {
+			if (!signal.aborted) {
+				this.state = {
+					...this.state,
+					href,
+					name: handle.get().metadata?.name ?? href,
+					content: handle.get(),
+					handle,
+					Content: reader.PreviewContent
+				};
+				this.emit();
+			}
 		};
-		this.emit();
+		update();
+		this.stop = handle.subscribe(update);
+		signal.addEventListener("abort", () => {
+			try {
+				handle.close();
+			} catch {}
+		}, { once: true });
 		try {
-			const source = await this.source(session, href, signal, (value) => this.patch(value), expectedFingerprint);
-			signal.throwIfAborted();
-			this.patch(source);
-			if (!source.metadata) {
-				this.patch({ content: { status: "unsupported" } });
-				return;
-			}
-			const extension = source.name.split(".").pop()?.toLowerCase() ?? "";
-			const mediaType = source.metadata.metadata?.mediaType ?? source.metadata.bytes.contentType;
-			const mime = imageTypes[extension] ?? (Object.values(imageTypes).includes(mediaType) ? mediaType : void 0);
-			if (!mime && !textExtensions.has(extension) && source.metadata.bytes.contentLength > 1048576) {
-				this.patch({ content: { status: "unsupported" } });
-				return;
-			}
-			const bytes = await this.collect(source.descriptor, source.params, source.metadata, mime ? 20971520 : 1048576, signal);
-			signal.throwIfAborted();
-			if (mime) {
-				rasterBytes(bytes, mime);
-				const blob = new Blob([bytes], { type: mime });
-				await this.decode(blob, signal);
-				signal.throwIfAborted();
-				this.url = URL.createObjectURL(blob);
-				this.patch({ content: {
-					status: "ready",
-					kind: "image",
-					url: this.url,
-					alt: source.name
-				} });
-			} else {
-				let text;
-				try {
-					text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
-					if ([...text].some((character) => character.charCodeAt(0) < 32 && ![
-						"\n",
-						"\r",
-						"	"
-					].includes(character))) throw new Error("binary control");
-				} catch {
-					this.patch({ content: { status: "unsupported" } });
-					return;
-				}
-				signal.throwIfAborted();
-				this.patch({ content: {
-					status: "ready",
-					kind: languages[extension] ? "code" : "text",
-					text,
-					...languages[extension] ? { language: languages[extension] } : {}
-				} });
+			const description = await reader.describe(href, signal);
+			if (!signal.aborted && this.state) {
+				this.state = {
+					...this.state,
+					description
+				};
+				this.emit();
 			}
-		} catch (error) {
-			if (!signal.aborted) this.patch({ content: {
-				status: "failed",
-				message: this.ctx.i18n.t(`error.${errorCode(error)}`)
-			} });
-		}
-	}
-	/** Toggles owner image layout without changing the readonly input. */
-	toggleOriginal() {
-		if (this.state) this.patch({ original: !this.state.original });
-	}
-	/** Adjusts image zoom within one quarter to four times original size. */
-	zoom(delta) {
-		if (this.state) this.patch({ zoom: Math.max(.25, Math.min(4, this.state.zoom + delta)) });
+		} catch {}
 	}
-	/** Aborts pending IO, releases its owned preview URL, and removes visible dialog state. */
+	/** Withdraws selection immediately while the reader retains any pending cleanup. */
 	close = () => {
+		this.stop?.();
+		this.stop = void 0;
 		this.controller.abort();
-		if (this.url) URL.revokeObjectURL(this.url);
-		this.url = void 0;
 		this.state = void 0;
 		this.emit();
 	};
@@ -5865,6 +5964,10 @@ var FileBrowser = class {
 		this.disposeCallbacks.push(ctx.onCore("config.workspaceChanged", () => {
 			if (this.state.workspaceId) this.syncSelection(true);
 		}));
+		this.disposeCallbacks.push(ctx.on("changed", (event) => {
+			const changed = FilesChangedSchema.safeParse(event.payload);
+			if (changed.success && this.state.workspaceId && changed.data.workspaces.includes(this.state.workspaceId) && this.state.status === "online") this.refresh();
+		}));
 		ctx.signal.addEventListener("abort", this.dispose, { once: true });
 	}
 	/** Returns a stable immutable snapshot until a visible state change. */
@@ -7042,6 +7145,7 @@ function FilePreview({ ctx, model, onClose, onDownload, onCopy, downloading = fa
 	const t = ctx.i18n.t;
 	const selected = browser.selected;
 	const content = state?.content;
+	const Content = state?.Content;
 	return /* @__PURE__ */ jsxs("aside", {
 		className: "fx-preview-pane",
 		"aria-label": t("preview"),
@@ -7109,23 +7213,7 @@ function FilePreview({ ctx, model, onClose, onDownload, onCopy, downloading = fa
 								}) : browser.selectedError ? /* @__PURE__ */ jsx("p", {
 									role: "alert",
 									children: t(`error.${browser.selectedError}`)
-								}) : content?.status === "ready" ? content.kind === "image" ? /* @__PURE__ */ jsx("div", {
-									className: "fx-preview-image",
-									children: /* @__PURE__ */ jsx("img", {
-										src: content.url,
-										alt: state?.name ?? selected?.name ?? ""
-									})
-								}) : /* @__PURE__ */ jsx("pre", {
-									className: "fx-code-preview",
-									children: content.text.split("\n").map((line, index) => /* @__PURE__ */ jsxs("span", {
-										className: "fx-code-line",
-										children: [/* @__PURE__ */ jsx("span", {
-											className: "fx-line-number",
-											"aria-hidden": "true",
-											children: index + 1
-										}), /* @__PURE__ */ jsx("span", { children: line || "\xA0" })]
-									}, `${index}:${line}`))
-								}) : content?.status === "failed" ? /* @__PURE__ */ jsx("p", {
+								}) : state?.handle && Content ? /* @__PURE__ */ jsx(Content, { handle: state.handle }) : content?.status === "failed" ? /* @__PURE__ */ jsx("p", {
 									role: "alert",
 									children: content.message
 								}) : content?.status === "loading" ? /* @__PURE__ */ jsx("p", {
@@ -7133,7 +7221,7 @@ function FilePreview({ ctx, model, onClose, onDownload, onCopy, downloading = fa
 									children: t("loading")
 								}) : /* @__PURE__ */ jsxs("div", {
 									className: "fx-preview-placeholder",
-									children: [/* @__PURE__ */ jsx(Icon, { name: "file-text" }), /* @__PURE__ */ jsx("span", { children: t(selected ? "preview-unsupported" : "select-preview") })]
+									children: [/* @__PURE__ */ jsx(Icon, { name: "file-text" }), /* @__PURE__ */ jsx("span", { children: t(content?.status === "unavailable" ? "unavailable" : selected ? "preview-unsupported" : "select-preview") })]
 								})
 							})
 						}),
@@ -7152,8 +7240,8 @@ function FilePreview({ ctx, model, onClose, onDownload, onCopy, downloading = fa
 										/* @__PURE__ */ jsx("dd", { children: fileSize(selected.size) }),
 										/* @__PURE__ */ jsx("dt", { children: t("modified") }),
 										/* @__PURE__ */ jsx("dd", { children: new Date(selected.modifiedAt).toLocaleString() }),
-										state?.metadata && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("dt", { children: t("body-size") }), /* @__PURE__ */ jsx("dd", { children: fileSize(state.metadata.bytes.contentLength) })] }),
-										state?.stat && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("dt", { children: t("host-path") }), /* @__PURE__ */ jsx("dd", { children: state.stat.realPath })] }),
+										state?.description?.metadata && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("dt", { children: t("body-size") }), /* @__PURE__ */ jsx("dd", { children: fileSize(state.description.metadata.bytes.contentLength) })] }),
+										state?.description?.source.kind === "gateway-file" && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("dt", { children: t("host-path") }), /* @__PURE__ */ jsx("dd", { children: state.description.source.absolutePath })] }),
 										/* @__PURE__ */ jsx("dt", { children: t("uri") }),
 										/* @__PURE__ */ jsx("dd", { children: selected.uri })
 									]
@@ -7171,7 +7259,7 @@ function FilePreview({ ctx, model, onClose, onDownload, onCopy, downloading = fa
 				children: [/* @__PURE__ */ jsxs(Button, {
 					size: "sm",
 					loading: downloading,
-					disabled: downloading || !selected || selected.kind === "directory" || !browser.selectedMetadata,
+					disabled: downloading || !selected || selected.kind === "directory" || !browser.selectedMetadata || !content?.canDownload,
 					onClick: onDownload,
 					children: [/* @__PURE__ */ jsx(Icon, { name: "download" }), t("download")]
 				}), /* @__PURE__ */ jsxs(Button, {
@@ -8430,19 +8518,31 @@ function registerFiles(ctx) {
 	ctx.styles.add(styles);
 	const model = new FileBrowser(ctx);
 	ctx.services.provide("file-reference-actions", { actions(description) {
-		if (description.source.kind !== "workspace-file") return [];
+		if (description.source.kind !== "gateway-file") return [];
 		const source = description.source;
-		const kind = description.metadata.metadata && typeof description.metadata.metadata === "object" && "kind" in description.metadata.metadata ? description.metadata.metadata.kind : void 0;
+		const state = model.get();
+		if (!state.workspaceId) return [];
+		const separator = source.pathStyle === "windows" ? /[\\/]/ : /\//;
+		const parts = source.absolutePath.split(separator);
+		if (parts.some((part) => part === "." || part === "..")) return [];
+		const root = state.roots.find((item) => {
+			const rootParts = item.path.split(separator).filter(Boolean);
+			const pathParts = parts.filter(Boolean);
+			return rootParts.every((part, index) => pathParts[index] === part);
+		});
+		if (!root) return [];
+		const relative = parts.filter(Boolean).slice(root.path.split(separator).filter(Boolean).length);
+		const target = {
+			workspaceId: state.workspaceId,
+			rootId: root.id,
+			path: relative.slice(0, -1).join("/")
+		};
 		return [{
 			id: "locate",
 			label: ctx.i18n.t("locate"),
 			run: () => {
 				if (ctx.signal.aborted || ctx.navigation.openPage("files").status !== "opened") return;
-				model.locate({
-					workspaceId: source.workspaceId,
-					rootId: source.rootId,
-					path: kind === "directory" ? source.path : source.path.split("/").slice(0, -1).join("/")
-				});
+				model.locate(target);
 			}
 		}];
 	} });