@dxos/plugin-file 0.10.0 → 0.11.1

package/dist/lib/chunk-create.mjs

@@ -0,0 +1,78 @@
+import { c as SettingsAtom, d as isAcceptedMimeType, o as Backend, r as Create, t as File } from "./chunk-types.mjs";
+import { Operation } from "@dxos/compute";
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { Blob, Database } from "@dxos/echo";
+import * as Effect from "effect/Effect";
+//#region src/operations/create.ts
+var UnsupportedFileTypeError = class extends Error {
+	type;
+	constructor(type) {
+		super(`Unsupported file type: ${type}`);
+		this.type = type;
+		this.name = "UnsupportedFileTypeError";
+	}
+};
+var FileTooLargeError = class extends Error {
+	size;
+	limit;
+	constructor(size, limit = Blob.MAX_INLINE_SIZE) {
+		super(`File is too large: ${size} bytes (limit: ${limit} bytes)`);
+		this.size = size;
+		this.limit = limit;
+		this.name = "FileTooLargeError";
+	}
+};
+var NoBackendError = class extends Error {
+	constructor() {
+		super("No file storage backend is registered.");
+		this.name = "NoBackendError";
+	}
+};
+var FileReadError = class extends Error {
+	constructor(cause) {
+		super("Failed to read file contents.");
+		this.name = "FileReadError";
+		this.cause = cause;
+	}
+};
+/**
+* Resolves the storage name to force for an upload:
+* - the storage name the user explicitly configured in Settings.backend, if it matches a
+*   registered {@link FileCapabilities.Backend} descriptor
+* - otherwise `undefined`, leaving `File.fromBytes`'s `storage` option unset so it falls through
+*   to the Blob registry's own configured default (edge when configured, inline otherwise)
+*   instead of hardcoding `inline`
+*
+* Still requires at least one descriptor to be registered, as a sanity check that the plugin's
+* settings UI has something to show.
+*/
+var resolveActiveStorage = Effect.gen(function* () {
+	const backends = yield* Capability.getAll(Backend);
+	if (backends.length === 0) return yield* Effect.fail(new NoBackendError());
+	const settingsAtomOpt = yield* Capability.get(SettingsAtom).pipe(Effect.option);
+	const registryOpt = yield* Capability.get(Capabilities.AtomRegistry).pipe(Effect.option);
+	if (settingsAtomOpt._tag === "Some" && registryOpt._tag === "Some") {
+		const settings = registryOpt.value.get(settingsAtomOpt.value);
+		if (settings.backend) {
+			const match = backends.find((b) => b.storage === settings.backend);
+			if (match) return match.storage;
+		}
+	}
+});
+var handler = Create.pipe(Operation.withHandler(Effect.fnUntraced(function* ({ file, db }) {
+	if (!isAcceptedMimeType(file.type)) return yield* Effect.fail(new UnsupportedFileTypeError(file.type));
+	const storage = yield* resolveActiveStorage;
+	const bytes = new Uint8Array(yield* Effect.tryPromise({
+		try: () => file.arrayBuffer(),
+		catch: (error) => new FileReadError(error)
+	}));
+	return { object: yield* File.fromBytes(bytes, {
+		name: file.name,
+		type: file.type,
+		storage
+	}).pipe(Effect.provide(Database.layer(db)), Effect.catchTag("BlobTooLargeError", () => Effect.fail(new FileTooLargeError(bytes.byteLength)))) };
+})));
+//#endregion
+export { FileReadError, FileTooLargeError, NoBackendError, UnsupportedFileTypeError, handler as default, resolveActiveStorage };
+
+//# sourceMappingURL=chunk-create.mjs.map

package/dist/lib/chunk-create.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-create.mjs","names":[],"sources":["../../src/operations/create.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { Operation } from '@dxos/compute';\nimport { Blob, Database } from '@dxos/echo';\n\nimport { File, FileCapabilities, FileOperation, Settings, isAcceptedMimeType } from '../types';\n\nexport class UnsupportedFileTypeError extends Error {\n  constructor(public readonly type: string) {\n    super(`Unsupported file type: ${type}`);\n    this.name = 'UnsupportedFileTypeError';\n  }\n}\n\nexport class FileTooLargeError extends Error {\n  constructor(\n    public readonly size: number,\n    public readonly limit: number = Blob.MAX_INLINE_SIZE,\n  ) {\n    super(`File is too large: ${size} bytes (limit: ${limit} bytes)`);\n    this.name = 'FileTooLargeError';\n  }\n}\n\nexport class NoBackendError extends Error {\n  constructor() {\n    super('No file storage backend is registered.');\n    this.name = 'NoBackendError';\n  }\n}\n\nexport class FileReadError extends Error {\n  constructor(cause: unknown) {\n    super('Failed to read file contents.');\n    this.name = 'FileReadError';\n    this.cause = cause;\n  }\n}\n\n/**\n * Resolves the storage name to force for an upload:\n * - the storage name the user explicitly configured in Settings.backend, if it matches a\n *   registered {@link FileCapabilities.Backend} descriptor\n * - otherwise `undefined`, leaving `File.fromBytes`'s `storage` option unset so it falls through\n *   to the Blob registry's own configured default (edge when configured, inline otherwise)\n *   instead of hardcoding `inline`\n *\n * Still requires at least one descriptor to be registered, as a sanity check that the plugin's\n * settings UI has something to show.\n */\nexport const resolveActiveStorage = Effect.gen(function* () {\n  const backends = yield* Capability.getAll(FileCapabilities.Backend);\n  if (backends.length === 0) {\n    return yield* Effect.fail(new NoBackendError());\n  }\n\n  const settingsAtomOpt = yield* Capability.get(FileCapabilities.SettingsAtom).pipe(Effect.option);\n  const registryOpt = yield* Capability.get(Capabilities.AtomRegistry).pipe(Effect.option);\n\n  if (settingsAtomOpt._tag === 'Some' && registryOpt._tag === 'Some') {\n    const settings = registryOpt.value.get(settingsAtomOpt.value) as Settings.Settings;\n    if (settings.backend) {\n      const match = backends.find((b) => b.storage === settings.backend);\n      if (match) {\n        return match.storage;\n      }\n    }\n  }\n\n  return undefined;\n});\n\nconst handler: Operation.WithHandler<typeof FileOperation.Create> = FileOperation.Create.pipe(\n  Operation.withHandler(\n    Effect.fnUntraced(function* ({ file, db }) {\n      // Validate before hitting the backend so the contract is consistent regardless of backend.\n      if (!isAcceptedMimeType(file.type)) {\n        return yield* Effect.fail(new UnsupportedFileTypeError(file.type));\n      }\n      const storage = yield* resolveActiveStorage;\n      const bytes = new Uint8Array(\n        yield* Effect.tryPromise({\n          try: () => file.arrayBuffer(),\n          catch: (error) => new FileReadError(error),\n        }),\n      );\n      // The size cap only applies to `inline` storage — `Blob.fromBytes` enforces it internally;\n      // other backends scale beyond it.\n      const object = yield* File.fromBytes(bytes, {\n        name: file.name,\n        type: file.type,\n        storage,\n      }).pipe(\n        Effect.provide(Database.layer(db)),\n        Effect.catchTag('BlobTooLargeError', () => Effect.fail(new FileTooLargeError(bytes.byteLength))),\n      );\n      return { object };\n    }),\n  ),\n);\n\nexport default handler;\n"],"mappings":";;;;;;AAYA,IAAa,2BAAb,cAA8C,MAAM;CACtB;CAA5B,YAAY,MAA8B;EACxC,MAAM,0BAA0B,MAAM;EADZ,KAAA,OAAA;EAE1B,KAAK,OAAO;CACd;AACF;AAEA,IAAa,oBAAb,cAAuC,MAAM;CAEzB;CACA;CAFlB,YACE,MACA,QAAgC,KAAK,iBACrC;EACA,MAAM,sBAAsB,KAAK,iBAAiB,MAAM,QAAQ;EAHhD,KAAA,OAAA;EACA,KAAA,QAAA;EAGhB,KAAK,OAAO;CACd;AACF;AAEA,IAAa,iBAAb,cAAoC,MAAM;CACxC,cAAc;EACZ,MAAM,wCAAwC;EAC9C,KAAK,OAAO;CACd;AACF;AAEA,IAAa,gBAAb,cAAmC,MAAM;CACvC,YAAY,OAAgB;EAC1B,MAAM,+BAA+B;EACrC,KAAK,OAAO;EACZ,KAAK,QAAQ;CACf;AACF;;;;;;;;;;;;AAaA,IAAa,uBAAuB,OAAO,IAAI,aAAa;CAC1D,MAAM,WAAW,OAAO,WAAW,OAAO,OAAwB;CAClE,IAAI,SAAS,WAAW,GACtB,OAAO,OAAO,OAAO,KAAK,IAAI,eAAe,CAAC;CAGhD,MAAM,kBAAkB,OAAO,WAAW,IAAI,YAA6B,CAAC,CAAC,KAAK,OAAO,MAAM;CAC/F,MAAM,cAAc,OAAO,WAAW,IAAI,aAAa,YAAY,CAAC,CAAC,KAAK,OAAO,MAAM;CAEvF,IAAI,gBAAgB,SAAS,UAAU,YAAY,SAAS,QAAQ;EAClE,MAAM,WAAW,YAAY,MAAM,IAAI,gBAAgB,KAAK;EAC5D,IAAI,SAAS,SAAS;GACpB,MAAM,QAAQ,SAAS,MAAM,MAAM,EAAE,YAAY,SAAS,OAAO;GACjE,IAAI,OACF,OAAO,MAAM;EAEjB;CACF;AAGF,CAAC;AAED,IAAM,UAAA,OAAmF,KACvF,UAAU,YACR,OAAO,WAAW,WAAW,EAAE,MAAM,MAAM;CAEzC,IAAI,CAAC,mBAAmB,KAAK,IAAI,GAC/B,OAAO,OAAO,OAAO,KAAK,IAAI,yBAAyB,KAAK,IAAI,CAAC;CAEnE,MAAM,UAAU,OAAO;CACvB,MAAM,QAAQ,IAAI,WAChB,OAAO,OAAO,WAAW;EACvB,WAAW,KAAK,YAAY;EAC5B,QAAQ,UAAU,IAAI,cAAc,KAAK;CAC3C,CAAC,CACH;CAWA,OAAO,EAAE,QAAA,OARa,KAAK,UAAU,OAAO;EAC1C,MAAM,KAAK;EACX,MAAM,KAAK;EACX;CACF,CAAC,CAAC,CAAC,KACD,OAAO,QAAQ,SAAS,MAAM,EAAE,CAAC,GACjC,OAAO,SAAS,2BAA2B,OAAO,KAAK,IAAI,kBAAkB,MAAM,UAAU,CAAC,CAAC,CACjG,EACgB;AAClB,CAAC,CACH,CACF"}

package/dist/lib/chunk-edge-backend.mjs

@@ -0,0 +1,18 @@
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { Blob } from "@dxos/echo";
+import { ClientCapabilities } from "@dxos/plugin-client";
+import { FileCapabilities } from "#types";
+import * as Effect from "effect/Effect";
+//#region src/capabilities/edge-backend.ts
+var edge_backend_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	if (!(yield* Capability.get(ClientCapabilities.Client)).config.values.runtime?.services?.edge?.url) return Capability.contributes(Capabilities.Null, null);
+	return Capability.contributes(FileCapabilities.Backend, {
+		name: "Edge",
+		description: "Store files on the DXOS edge network. Scales beyond the inline size cap.",
+		storage: Blob.Storage.edge
+	});
+}));
+//#endregion
+export { edge_backend_default as default };
+
+//# sourceMappingURL=chunk-edge-backend.mjs.map

package/dist/lib/chunk-edge-backend.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-edge-backend.mjs","names":[],"sources":["../../src/capabilities/edge-backend.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { Blob } from '@dxos/echo';\nimport { ClientCapabilities } from '@dxos/plugin-client';\n\nimport { FileCapabilities } from '#types';\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const client = yield* Capability.get(ClientCapabilities.Client);\n    const edgeUrl = client.config.values.runtime?.services?.edge?.url;\n    if (!edgeUrl) {\n      return Capability.contributes(Capabilities.Null, null);\n    }\n\n    return Capability.contributes(FileCapabilities.Backend, {\n      name: 'Edge',\n      description: 'Store files on the DXOS edge network. Scales beyond the inline size cap.',\n      storage: Blob.Storage.edge,\n    });\n  }),\n);\n"],"mappings":";;;;;;AAYA,IAAA,uBAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAG7B,IAAI,EADY,OADM,WAAW,IAAI,mBAAmB,MAAM,EAAA,CACvC,OAAO,OAAO,SAAS,UAAU,MAAM,KAE5D,OAAO,WAAW,YAAY,aAAa,MAAM,IAAI;CAGvD,OAAO,WAAW,YAAY,iBAAiB,SAAS;EACtD,MAAM;EACN,aAAa;EACb,SAAS,KAAK,QAAQ;CACxB,CAAC;AACH,CAAC,CACH"}

package/dist/lib/chunk-file-uploader.mjs

@@ -0,0 +1,37 @@
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { Blob, Database } from "@dxos/echo";
+import { AppCapabilities } from "@dxos/app-toolkit";
+import { FileOperation } from "#types";
+import { EffectEx } from "@dxos/effect";
+import * as Effect from "effect/Effect";
+import { SpaceOperation } from "@dxos/plugin-space";
+import * as Option from "effect/Option";
+//#region src/capabilities/file-uploader.ts
+var file_uploader_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	const capabilities = yield* Capability.Service;
+	return Capability.contributes(AppCapabilities.FileUploader, (db, file) => {
+		const { invoke } = capabilities.get(Capabilities.OperationInvoker);
+		const program = Effect.gen(function* () {
+			const { object } = yield* invoke(FileOperation.Create, {
+				db,
+				file
+			});
+			yield* invoke(SpaceOperation.AddObject, {
+				target: db,
+				object
+			});
+			const blob = yield* Database.load(object.data);
+			const urlOption = yield* Blob.url(blob).pipe(Effect.provide(Database.layer(db)));
+			return {
+				name: object.name ?? file.name,
+				type: blob.type ?? "application/octet-stream",
+				...Option.isSome(urlOption) ? { url: urlOption.value } : {}
+			};
+		});
+		return EffectEx.runAndForwardErrors(program);
+	});
+}));
+//#endregion
+export { file_uploader_default as default };
+
+//# sourceMappingURL=chunk-file-uploader.mjs.map

package/dist/lib/chunk-file-uploader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-file-uploader.mjs","names":[],"sources":["../../src/capabilities/file-uploader.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { AppCapabilities } from '@dxos/app-toolkit';\nimport { Blob, Database } from '@dxos/echo';\nimport { EffectEx } from '@dxos/effect';\nimport { SpaceOperation } from '@dxos/plugin-space';\n\nimport { FileOperation } from '#types';\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const capabilities = yield* Capability.Service;\n\n    return Capability.contributes(AppCapabilities.FileUploader, (db, file) => {\n      const { invoke } = capabilities.get(Capabilities.OperationInvoker);\n      const program = Effect.gen(function* () {\n        const { object } = yield* invoke(FileOperation.Create, { db, file });\n        yield* invoke(SpaceOperation.AddObject, { target: db, object });\n        const blob = yield* Database.load(object.data);\n        const urlOption = yield* Blob.url(blob).pipe(Effect.provide(Database.layer(db)));\n        return {\n          name: object.name ?? file.name,\n          type: blob.type ?? 'application/octet-stream',\n          ...(Option.isSome(urlOption) ? { url: urlOption.value } : {}),\n        };\n      });\n\n      return EffectEx.runAndForwardErrors(program);\n    });\n  }),\n);\n"],"mappings":";;;;;;;;;AAeA,IAAA,wBAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,MAAM,eAAe,OAAO,WAAW;CAEvC,OAAO,WAAW,YAAY,gBAAgB,eAAe,IAAI,SAAS;EACxE,MAAM,EAAE,WAAW,aAAa,IAAI,aAAa,gBAAgB;EACjE,MAAM,UAAU,OAAO,IAAI,aAAa;GACtC,MAAM,EAAE,WAAW,OAAO,OAAO,cAAc,QAAQ;IAAE;IAAI;GAAK,CAAC;GACnE,OAAO,OAAO,eAAe,WAAW;IAAE,QAAQ;IAAI;GAAO,CAAC;GAC9D,MAAM,OAAO,OAAO,SAAS,KAAK,OAAO,IAAI;GAC7C,MAAM,YAAY,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,OAAO,QAAQ,SAAS,MAAM,EAAE,CAAC,CAAC;GAC/E,OAAO;IACL,MAAM,OAAO,QAAQ,KAAK;IAC1B,MAAM,KAAK,QAAQ;IACnB,GAAI,OAAO,OAAO,SAAS,IAAI,EAAE,KAAK,UAAU,MAAM,IAAI,CAAC;GAC7D;EACF,CAAC;EAED,OAAO,SAAS,oBAAoB,OAAO;CAC7C,CAAC;AACH,CAAC,CACH"}

package/dist/lib/chunk-inline-backend.mjs

@@ -0,0 +1,19 @@
+import { Capability } from "@dxos/app-framework";
+import { Blob } from "@dxos/echo";
+import { FileCapabilities } from "#types";
+import * as Effect from "effect/Effect";
+//#region src/capabilities/inline-backend.ts
+/**
+* Inline backend descriptor: file bytes are stored on the ECHO object itself.
+* Exported standalone for direct testing.
+*/
+var inlineBackend = {
+	name: "Inline (ECHO)",
+	description: "Store the file bytes directly inside the ECHO document. Capped at 4MB; images, videos, and PDFs only.",
+	storage: Blob.Storage.inline
+};
+var inline_backend_default = Capability.makeModule(() => Effect.succeed(Capability.contributes(FileCapabilities.Backend, inlineBackend)));
+//#endregion
+export { inline_backend_default as default, inlineBackend };
+
+//# sourceMappingURL=chunk-inline-backend.mjs.map

package/dist/lib/chunk-inline-backend.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-inline-backend.mjs","names":[],"sources":["../../src/capabilities/inline-backend.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { Blob } from '@dxos/echo';\n\nimport { FileCapabilities } from '#types';\n\n/**\n * Inline backend descriptor: file bytes are stored on the ECHO object itself.\n * Exported standalone for direct testing.\n */\nexport const inlineBackend: FileCapabilities.Backend = {\n  name: 'Inline (ECHO)',\n  description: 'Store the file bytes directly inside the ECHO document. Capped at 4MB; images, videos, and PDFs only.',\n  storage: Blob.Storage.inline,\n};\n\nexport default Capability.makeModule(() =>\n  Effect.succeed(Capability.contributes(FileCapabilities.Backend, inlineBackend)),\n);\n"],"mappings":";;;;;;;;;AAeA,IAAa,gBAA0C;CACrD,MAAM;CACN,aAAa;CACb,SAAS,KAAK,QAAQ;AACxB;AAEA,IAAA,yBAAe,WAAW,iBACxB,OAAO,QAAQ,WAAW,YAAY,iBAAiB,SAAS,aAAa,CAAC,CAChF"}

package/dist/lib/chunk-markdown-extension.mjs

@@ -0,0 +1,182 @@
+import { Capability } from "@dxos/app-framework";
+import { Blob, Database, Filter, Obj } from "@dxos/echo";
+import { File } from "#types";
+import "react";
+import { EffectEx } from "@dxos/effect";
+import { Status, ThemeProvider, defaultTx } from "@dxos/react-ui";
+import { jsx } from "react/jsx-runtime";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { MarkdownCapabilities } from "@dxos/plugin-markdown/types";
+import { getSpace } from "@dxos/react-client/echo";
+import { syntaxTree } from "@codemirror/language";
+import { StateField } from "@codemirror/state";
+import { Decoration, EditorView, WidgetType } from "@codemirror/view";
+import { createRoot } from "react-dom/client";
+import { EID } from "@dxos/keys";
+import { focusField } from "@dxos/ui-editor";
+//#region src/extensions/image.tsx
+var WAIT_UNTIL_LOADER = 1500;
+/**
+* Decorate `![](echo:...)` references that resolve to File objects with inline image previews.
+*/
+var image = (options) => {
+	const blobUrlCache = {};
+	const preloaded = /* @__PURE__ */ new Set();
+	const preload = (url) => {
+		if (!preloaded.has(url)) {
+			const img = document.createElement("img");
+			img.src = url;
+			preloaded.add(url);
+		}
+	};
+	return [StateField.define({
+		create: (state) => Decoration.set(buildDecorations({
+			from: 0,
+			to: state.doc.length,
+			state,
+			blobUrlCache,
+			preload,
+			options
+		})),
+		update: (value, tr) => {
+			if (!tr.docChanged && !tr.selection) return value;
+			const cursor = tr.state.selection.main.head;
+			const oldCursor = tr.changes.mapPos(tr.startState.selection.main.head);
+			let from = Math.min(cursor, oldCursor);
+			let to = Math.max(cursor, oldCursor);
+			tr.changes.iterChangedRanges((_fromA, _toA, fromB, toB) => {
+				from = Math.min(from, fromB);
+				to = Math.max(to, toB);
+			});
+			from = tr.state.doc.lineAt(from).from;
+			to = tr.state.doc.lineAt(to).to;
+			return value.map(tr.changes).update({
+				filterFrom: from,
+				filterTo: to,
+				filter: () => false,
+				add: buildDecorations({
+					from,
+					to,
+					state: tr.state,
+					blobUrlCache,
+					preload,
+					options
+				})
+			});
+		},
+		provide: (field) => EditorView.decorations.from(field)
+	})];
+};
+var buildDecorations = ({ state, from, to, blobUrlCache, preload, options: { space } }) => {
+	const decorations = [];
+	const cursor = state.selection.main.head;
+	syntaxTree(state).iterate({
+		enter: (node) => {
+			if (node.name !== "Image") return;
+			const urlNode = node.node.getChild("URL");
+			if (!urlNode) return;
+			const hide = state.readOnly || cursor < node.from || cursor > node.to;
+			const urlText = state.sliceDoc(urlNode.from, urlNode.to);
+			if (!EID.isEID(urlText)) return;
+			let echoUri;
+			let echoSpaceId;
+			try {
+				const parsed = EID.parse(urlText);
+				echoUri = EID.getEntityId(parsed);
+				echoSpaceId = EID.getSpaceId(parsed);
+			} catch {
+				return;
+			}
+			if (!echoUri) return;
+			if (echoSpaceId && echoSpaceId !== space.id) return;
+			const cacheKey = urlText;
+			const blobUrlPromise = blobUrlCache[cacheKey] ?? (async () => {
+				const matched = await space.db.query(Filter.id(echoUri)).first();
+				if (!matched || !Obj.instanceOf(File.File, matched)) return;
+				const url = await EffectEx.runPromise(Effect.gen(function* () {
+					const blob = yield* Database.load(matched.data);
+					const urlOption = yield* Blob.url(blob);
+					if (Option.isSome(urlOption)) return urlOption.value;
+					const bytes = yield* Blob.read(blob);
+					return URL.createObjectURL(new globalThis.Blob([bytes], { type: blob.type }));
+				}).pipe(Effect.provide(Database.layer(space.db)), Effect.catchAll(() => Effect.succeed(void 0))));
+				if (!url) return;
+				const previous = blobUrlCache[cacheKey];
+				if (previous?.startsWith("blob:")) URL.revokeObjectURL(previous);
+				blobUrlCache[cacheKey] = url;
+				preload(url);
+				return url;
+			})();
+			decorations.push(Decoration.replace({
+				block: true,
+				widget: new DxnImageWidget(urlText, blobUrlPromise)
+			}).range(hide ? node.from : node.to, node.to));
+		},
+		from,
+		to
+	});
+	return decorations;
+};
+var createImg = (view, url) => {
+	const img = document.createElement("img");
+	img.setAttribute("src", url);
+	img.setAttribute("class", "cm-image-with-loader");
+	if (view.state.field(focusField)) img.onload = () => img.classList.add("cm-loaded-image");
+	else img.classList.add("cm-loaded-image");
+	return img;
+};
+var DxnImageWidget = class extends WidgetType {
+	_dxnUrl;
+	_url;
+	constructor(_dxnUrl, _url) {
+		super();
+		this._dxnUrl = _dxnUrl;
+		this._url = _url;
+	}
+	eq(other) {
+		return this._dxnUrl === other._dxnUrl;
+	}
+	toDOM(view) {
+		if (typeof this._url === "string") return createImg(view, this._url);
+		const widget = document.createElement("div");
+		widget.className = "cm-image-wrapper";
+		const loader = document.createElement("div");
+		loader.className = "mx-auto transition-opacity";
+		let loaderAdded = false;
+		const timeout = setTimeout(() => {
+			createRoot(loader).render(/* @__PURE__ */ jsx(ThemeProvider, {
+				tx: defaultTx,
+				children: /* @__PURE__ */ jsx(Status, { indeterminate: true })
+			}));
+			widget.appendChild(loader);
+			loaderAdded = true;
+		}, WAIT_UNTIL_LOADER);
+		Promise.resolve(this._url).then((url) => {
+			clearTimeout(timeout);
+			if (loaderAdded) widget.removeChild(loader);
+			if (url) widget.appendChild(createImg(view, url));
+		}).catch(() => {
+			clearTimeout(timeout);
+			if (loaderAdded) widget.removeChild(loader);
+		});
+		return widget;
+	}
+};
+//#endregion
+//#region src/capabilities/markdown-extension.ts
+var markdown_extension_default = Capability.makeModule(() => Effect.sync(() => {
+	const provider = ({ document, viewMode }) => {
+		if (viewMode === "source") return;
+		if (document) {
+			const space = getSpace(document);
+			if (!space) return;
+			return [image({ space })];
+		}
+	};
+	return Capability.contributes(MarkdownCapabilities.ExtensionProvider, [provider]);
+}));
+//#endregion
+export { markdown_extension_default as default };
+
+//# sourceMappingURL=chunk-markdown-extension.mjs.map

package/dist/lib/chunk-markdown-extension.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-markdown-extension.mjs","names":[],"sources":["../../src/extensions/image.tsx","../../src/capabilities/markdown-extension.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { syntaxTree } from '@codemirror/language';\nimport { type EditorState, type Extension, type Range, StateField } from '@codemirror/state';\nimport { Decoration, EditorView, WidgetType } from '@codemirror/view';\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\nimport React from 'react';\nimport { createRoot } from 'react-dom/client';\n\nimport { Blob, Database, Filter, Obj } from '@dxos/echo';\nimport { EffectEx } from '@dxos/effect';\nimport { EID } from '@dxos/keys';\nimport { type Space } from '@dxos/react-client/echo';\nimport { Status, ThemeProvider } from '@dxos/react-ui';\nimport { defaultTx } from '@dxos/react-ui';\nimport { focusField } from '@dxos/ui-editor';\nimport { type MaybePromise } from '@dxos/util';\n\nimport { File } from '#types';\n\nconst WAIT_UNTIL_LOADER = 1500;\n\nexport type ImageOptions = {\n  space: Space;\n};\n\n/**\n * Decorate `![](echo:...)` references that resolve to File objects with inline image previews.\n */\nexport const image = (options: ImageOptions): Extension[] => {\n  const blobUrlCache: Record<string, string> = {};\n  const preloaded = new Set<string>();\n\n  const preload = (url: string) => {\n    if (!preloaded.has(url)) {\n      const img = document.createElement('img');\n      img.src = url;\n      preloaded.add(url);\n    }\n  };\n\n  return [\n    StateField.define({\n      create: (state) =>\n        Decoration.set(buildDecorations({ from: 0, to: state.doc.length, state, blobUrlCache, preload, options })),\n      update: (value, tr) => {\n        if (!tr.docChanged && !tr.selection) {\n          return value;\n        }\n\n        const cursor = tr.state.selection.main.head;\n        const oldCursor = tr.changes.mapPos(tr.startState.selection.main.head);\n        let from = Math.min(cursor, oldCursor);\n        let to = Math.max(cursor, oldCursor);\n        tr.changes.iterChangedRanges((_fromA, _toA, fromB, toB) => {\n          from = Math.min(from, fromB);\n          to = Math.max(to, toB);\n        });\n\n        from = tr.state.doc.lineAt(from).from;\n        to = tr.state.doc.lineAt(to).to;\n\n        return value.map(tr.changes).update({\n          filterFrom: from,\n          filterTo: to,\n          filter: () => false,\n          add: buildDecorations({ from, to, state: tr.state, blobUrlCache, preload, options }),\n        });\n      },\n      provide: (field) => EditorView.decorations.from(field),\n    }),\n  ];\n};\n\nconst buildDecorations = ({\n  state,\n  from,\n  to,\n  blobUrlCache,\n  preload,\n  options: { space },\n}: {\n  state: EditorState;\n  from: number;\n  to: number;\n  blobUrlCache: Record<string, string>;\n  preload: (url: string) => void;\n  options: ImageOptions;\n}) => {\n  const decorations: Range<Decoration>[] = [];\n  const cursor = state.selection.main.head;\n  syntaxTree(state).iterate({\n    enter: (node) => {\n      if (node.name !== 'Image') {\n        return;\n      }\n\n      const urlNode = node.node.getChild('URL');\n      if (!urlNode) {\n        return;\n      }\n\n      const hide = state.readOnly || cursor < node.from || cursor > node.to;\n      const urlText = state.sliceDoc(urlNode.from, urlNode.to);\n      if (!EID.isEID(urlText)) {\n        return;\n      }\n\n      let echoUri: string | undefined;\n      let echoSpaceId: string | undefined;\n      try {\n        const parsed = EID.parse(urlText);\n        echoUri = EID.getEntityId(parsed);\n        echoSpaceId = EID.getSpaceId(parsed);\n      } catch {\n        return;\n      }\n      if (!echoUri) {\n        return;\n      }\n\n      // Skip references to objects in other spaces.\n      if (echoSpaceId && echoSpaceId !== space.id) {\n        return;\n      }\n\n      const cacheKey = urlText;\n      const cached = blobUrlCache[cacheKey];\n      // Skip the DB query and Blob resolution entirely once a URL is cached — otherwise every\n      // decoration rebuild (e.g. on cursor movement) re-fetches and, on the object-URL fallback\n      // path, mints and leaks a new `blob:` URL even though the cached one is still valid.\n      const blobUrlPromise =\n        cached ??\n        (async () => {\n          const matched = await space.db.query(Filter.id(echoUri!)).first();\n          if (!matched || !Obj.instanceOf(File.File, matched)) {\n            return undefined;\n          }\n\n          const url = await EffectEx.runPromise(\n            Effect.gen(function* () {\n              const blob = yield* Database.load(matched.data);\n              const urlOption = yield* Blob.url(blob);\n              if (Option.isSome(urlOption)) {\n                return urlOption.value;\n              }\n              const bytes = yield* Blob.read(blob);\n              // `Uint8Array` is generic over `ArrayBufferLike` (incl. `SharedArrayBuffer`) while\n              // DOM's `BlobPart` only covers `ArrayBuffer`-backed views — a gap between the DOM lib\n              // types and the TS standard lib, not fixable by typing `bytes` differently.\n              return URL.createObjectURL(new globalThis.Blob([bytes as BlobPart], { type: blob.type }));\n            }).pipe(\n              Effect.provide(Database.layer(space.db)),\n              Effect.catchAll(() => Effect.succeed(undefined)),\n            ),\n          );\n          if (!url) {\n            return undefined;\n          }\n          // Only object URLs we minted via `createObjectURL` above need revoking — `Blob.url()`\n          // results (data:/https: URLs) aren't owned by this cache.\n          const previous = blobUrlCache[cacheKey];\n          if (previous?.startsWith('blob:')) {\n            URL.revokeObjectURL(previous);\n          }\n          blobUrlCache[cacheKey] = url;\n          preload(url);\n          return url;\n        })();\n\n      decorations.push(\n        Decoration.replace({\n          block: true,\n          widget: new DxnImageWidget(urlText, blobUrlPromise),\n        }).range(hide ? node.from : node.to, node.to),\n      );\n    },\n    from,\n    to,\n  });\n\n  return decorations;\n};\n\nconst createImg = (view: EditorView, url: string) => {\n  const img = document.createElement('img');\n  img.setAttribute('src', url);\n  img.setAttribute('class', 'cm-image-with-loader');\n  if (view.state.field(focusField)) {\n    img.onload = () => img.classList.add('cm-loaded-image');\n  } else {\n    img.classList.add('cm-loaded-image');\n  }\n  return img;\n};\n\nclass DxnImageWidget extends WidgetType {\n  constructor(\n    readonly _dxnUrl: string,\n    readonly _url: MaybePromise<string | undefined>,\n  ) {\n    super();\n  }\n\n  override eq(other: this) {\n    return this._dxnUrl === other._dxnUrl;\n  }\n\n  override toDOM(view: EditorView) {\n    if (typeof this._url === 'string') {\n      return createImg(view, this._url);\n    }\n\n    const widget = document.createElement('div');\n    widget.className = 'cm-image-wrapper';\n    const loader = document.createElement('div');\n    loader.className = 'mx-auto transition-opacity';\n    let loaderAdded = false;\n\n    const timeout = setTimeout(() => {\n      const root = createRoot(loader);\n      root.render(\n        <ThemeProvider tx={defaultTx}>\n          <Status indeterminate />\n        </ThemeProvider>,\n      );\n      widget.appendChild(loader);\n      loaderAdded = true;\n    }, WAIT_UNTIL_LOADER);\n\n    void Promise.resolve(this._url)\n      .then((url) => {\n        clearTimeout(timeout);\n        if (loaderAdded) {\n          widget.removeChild(loader);\n        }\n        if (url) {\n          widget.appendChild(createImg(view, url));\n        }\n      })\n      .catch(() => {\n        clearTimeout(timeout);\n        if (loaderAdded) {\n          widget.removeChild(loader);\n        }\n      });\n\n    return widget;\n  }\n}\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { MarkdownCapabilities, type MarkdownExtensionProvider } from '@dxos/plugin-markdown/types';\nimport { getSpace } from '@dxos/react-client/echo';\n\nimport { image } from '../extensions';\n\nexport default Capability.makeModule(() =>\n  Effect.sync(() => {\n    const provider: MarkdownExtensionProvider = ({ document, viewMode }) => {\n      if (viewMode === 'source') {\n        return undefined;\n      }\n\n      if (document) {\n        const space = getSpace(document);\n        if (!space) {\n          return undefined;\n        }\n        return [image({ space })];\n      }\n\n      return undefined;\n    };\n\n    return Capability.contributes(MarkdownCapabilities.ExtensionProvider, [provider]);\n  }),\n);\n"],"mappings":"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"}

package/dist/lib/chunk-meta.mjs

@@ -0,0 +1,44 @@
+import { trim } from "@dxos/util";
+import { Plugin } from "@dxos/app-framework";
+import { Config2 } from "@dxos/app-framework/config";
+//#region dx.config.ts
+var dx_config_default = Config2.make({ plugin: {
+	key: "org.dxos.plugin.file",
+	name: "File",
+	author: "DXOS",
+	description: trim`
+      FilePlugin enables DXOS Composer to store and preview binary files — images, videos, and PDFs — as
+      first-class ECHO objects. Uploaded bytes are routed through a pluggable backend system: the built-in
+      inline backend serialises the file directly onto the ECHO document, while external backends (e.g. WNFS)
+      can be contributed by other plugins.
+
+      Accepted formats are images (jpg, jpeg, png, gif, webp, svg), videos (mp4, webm, mov), and PDFs,
+      up to a 4 MB limit per file for the inline backend (other backends scale beyond it). The preview
+      surface renders the appropriate HTML element for each MIME class and surfaces inside article,
+      section, and slide roles.
+
+      A File object's \`data\` field is a reference to a \`Blob\` ECHO object (from \`@dxos/echo\`), which
+      abstracts where bytes actually live. \`Blob.url\`/\`Blob.read\` resolve a renderable URL or the raw
+      bytes regardless of backend, keeping the File object schema backend-agnostic without a separate
+      URL-resolver capability. A companion Markdown extension allows file objects to be embedded directly
+      in Markdown documents.
+
+      Backend selection is user-configurable in the plugin settings panel, which lists all registered
+      backends with their descriptions. Selecting a backend persists the choice to the ECHO-backed settings
+      atom so the preference is shared across devices.
+    `,
+	icon: {
+		key: "ph--file--regular",
+		hue: "indigo"
+	},
+	source: "https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-file",
+	spec: "PLUGIN.mdl",
+	tags: ["alpha"]
+} });
+//#endregion
+//#region src/meta.ts
+var meta = Plugin.getMetaFromConfig(dx_config_default);
+//#endregion
+export { meta as t };
+
+//# sourceMappingURL=chunk-meta.mjs.map

package/dist/lib/chunk-meta.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-meta.mjs","names":[],"sources":["../../dx.config.ts","../../src/meta.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Config2 } from '@dxos/app-framework/config';\nimport { trim } from '@dxos/util';\n\nexport default Config2.make({\n  plugin: {\n    key: 'org.dxos.plugin.file',\n    name: 'File',\n    author: 'DXOS',\n    description: trim`\n      FilePlugin enables DXOS Composer to store and preview binary files — images, videos, and PDFs — as\n      first-class ECHO objects. Uploaded bytes are routed through a pluggable backend system: the built-in\n      inline backend serialises the file directly onto the ECHO document, while external backends (e.g. WNFS)\n      can be contributed by other plugins.\n\n      Accepted formats are images (jpg, jpeg, png, gif, webp, svg), videos (mp4, webm, mov), and PDFs,\n      up to a 4 MB limit per file for the inline backend (other backends scale beyond it). The preview\n      surface renders the appropriate HTML element for each MIME class and surfaces inside article,\n      section, and slide roles.\n\n      A File object's \\`data\\` field is a reference to a \\`Blob\\` ECHO object (from \\`@dxos/echo\\`), which\n      abstracts where bytes actually live. \\`Blob.url\\`/\\`Blob.read\\` resolve a renderable URL or the raw\n      bytes regardless of backend, keeping the File object schema backend-agnostic without a separate\n      URL-resolver capability. A companion Markdown extension allows file objects to be embedded directly\n      in Markdown documents.\n\n      Backend selection is user-configurable in the plugin settings panel, which lists all registered\n      backends with their descriptions. Selecting a backend persists the choice to the ECHO-backed settings\n      atom so the preference is shared across devices.\n    `,\n    icon: { key: 'ph--file--regular', hue: 'indigo' },\n    source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-file',\n    spec: 'PLUGIN.mdl',\n    tags: ['alpha'],\n  },\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport config from '../dx.config';\n\nexport const meta = Plugin.getMetaFromConfig(config);\n"],"mappings":";;;;AAOA,IAAA,oBAAe,QAAQ,KAAK,EAC1B,QAAQ;CACN,KAAK;CACL,MAAM;CACN,QAAQ;CACR,aAAa,IAAI;;;;;;;;;;;;;;;;;;;;;CAqBjB,MAAM;EAAE,KAAK;EAAqB,KAAK;CAAS;CAChD,QAAQ;CACR,MAAM;CACN,MAAM,CAAC,OAAO;AAChB,EACF,CAAC;;;AC9BD,IAAa,OAAO,OAAO,kBAAkB,iBAAM"}

package/dist/lib/chunk-operation-handler.mjs

@@ -0,0 +1,11 @@
+import { Capabilities, Capability } from "@dxos/app-framework";
+import * as Effect from "effect/Effect";
+import { FileOperationHandlerSet } from "#operations";
+//#region src/capabilities/operation-handler.ts
+var operation_handler_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	return Capability.contributes(Capabilities.OperationHandler, FileOperationHandlerSet);
+}));
+//#endregion
+export { operation_handler_default as default };
+
+//# sourceMappingURL=chunk-operation-handler.mjs.map

package/dist/lib/chunk-operation-handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-operation-handler.mjs","names":[],"sources":["../../src/capabilities/operation-handler.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport type { OperationHandlerSet } from '@dxos/compute';\n\nimport { FileOperationHandlerSet } from '#operations';\n\nexport default Capability.makeModule<OperationHandlerSet.OperationHandlerSet>(\n  Effect.fnUntraced(function* () {\n    return Capability.contributes(Capabilities.OperationHandler, FileOperationHandlerSet);\n  }),\n);\n"],"mappings":";;;;AAWA,IAAA,4BAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,OAAO,WAAW,YAAY,aAAa,kBAAkB,uBAAuB;AACtF,CAAC,CACH"}

package/dist/lib/chunk-react-surface.mjs

@@ -0,0 +1,55 @@
+import { meta } from "#meta";
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { File, FileAction } from "#types";
+import { useCallback } from "react";
+import { SchemaEx } from "@dxos/effect";
+import { jsx } from "react/jsx-runtime";
+import { Surface } from "@dxos/app-framework/ui";
+import * as Effect from "effect/Effect";
+import { AppSurface } from "@dxos/app-toolkit/ui";
+import { FileArticle, FileSettings } from "#containers";
+import { FileInput } from "#components";
+//#region src/capabilities/FileUploadField.tsx
+/**
+* Form field that uploads a file for an upload-annotated property. It consumes the whole surface
+* envelope, so it is registered without a `props` mapper.
+*/
+var FileUploadField = ({ data, onValueChange }) => {
+	const ast = data.fieldPropertyAst;
+	const handleChange = useCallback((file) => {
+		if (ast) onValueChange?.(ast, file);
+	}, [ast, onValueChange]);
+	if (!ast) return null;
+	return /* @__PURE__ */ jsx(FileInput, {
+		schema: data.schema,
+		onChange: handleChange
+	});
+};
+//#endregion
+//#region src/capabilities/react-surface.ts
+var react_surface_default = Capability.makeModule(() => Effect.succeed(Capability.contributes(Capabilities.ReactSurface, [
+	Surface.create({
+		id: "article",
+		filter: AppSurface.oneOf(AppSurface.object(AppSurface.Article, File.File), AppSurface.object(AppSurface.Section, File.File), AppSurface.object(AppSurface.Slide, File.File)),
+		component: FileArticle,
+		props: ({ role, data: { subject } }) => ({
+			role,
+			subject
+		})
+	}),
+	Surface.create({
+		id: "createForm",
+		filter: AppSurface.formInputBySchema((ast) => !!SchemaEx.findAnnotation(ast, FileAction.UploadAnnotationId)),
+		component: FileUploadField
+	}),
+	Surface.create({
+		id: "pluginSettings",
+		filter: AppSurface.settings(AppSurface.Article, meta.profile.key),
+		component: FileSettings,
+		props: ({ data: { subject } }) => ({ subject })
+	})
+])));
+//#endregion
+export { react_surface_default as default };
+
+//# sourceMappingURL=chunk-react-surface.mjs.map

package/dist/lib/chunk-react-surface.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-react-surface.mjs","names":[],"sources":["../../src/capabilities/FileUploadField.tsx","../../src/capabilities/react-surface.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { useCallback } from 'react';\n\nimport { type Surface } from '@dxos/app-framework/ui';\nimport { type AppSurface } from '@dxos/app-toolkit/ui';\nimport { type FormFieldRendererProps } from '@dxos/react-ui-form';\n\nimport { FileInput } from '#components';\n\n/** The form renderer's own props ride alongside `data` on the surface envelope. */\nexport type FileUploadFieldProps = Surface.ComponentProps<AppSurface.FormInputData> &\n  Pick<FormFieldRendererProps<File>, 'onValueChange'>;\n\n/**\n * Form field that uploads a file for an upload-annotated property. It consumes the whole surface\n * envelope, so it is registered without a `props` mapper.\n */\nexport const FileUploadField = ({ data, onValueChange }: FileUploadFieldProps) => {\n  const ast = data.fieldPropertyAst;\n  const handleChange = useCallback(\n    (file: File) => {\n      if (ast) {\n        onValueChange?.(ast, file);\n      }\n    },\n    [ast, onValueChange],\n  );\n\n  if (!ast) {\n    return null;\n  }\n\n  return <FileInput schema={data.schema} onChange={handleChange} />;\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { Surface } from '@dxos/app-framework/ui';\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { SchemaEx } from '@dxos/effect';\n\nimport { FileArticle, FileSettings } from '#containers';\nimport { meta } from '#meta';\nimport { File, FileAction } from '#types';\n\nimport { FileUploadField } from './FileUploadField';\n\nexport default Capability.makeModule(() =>\n  Effect.succeed(\n    Capability.contributes(Capabilities.ReactSurface, [\n      Surface.create({\n        id: 'article',\n        filter: AppSurface.oneOf(\n          AppSurface.object(AppSurface.Article, File.File),\n          AppSurface.object(AppSurface.Section, File.File),\n          AppSurface.object(AppSurface.Slide, File.File),\n        ),\n        component: FileArticle,\n        props: ({ role, data: { subject } }) => ({ role, subject }),\n      }),\n      Surface.create({\n        id: 'createForm',\n        filter: AppSurface.formInputBySchema(\n          (ast) => !!SchemaEx.findAnnotation<Record<string, string[]>>(ast, FileAction.UploadAnnotationId),\n        ),\n        component: FileUploadField,\n      }),\n      Surface.create({\n        id: 'pluginSettings',\n        filter: AppSurface.settings(AppSurface.Article, meta.profile.key),\n        component: FileSettings,\n        props: ({ data: { subject } }) => ({ subject }),\n      }),\n    ]),\n  ),\n);\n"],"mappings":";;;;;;;;;;;;;;;;AAoBA,IAAa,mBAAmB,EAAE,MAAM,oBAA0C;CAChF,MAAM,MAAM,KAAK;CACjB,MAAM,eAAe,aAClB,SAAe;EACd,IAAI,KACF,gBAAgB,KAAK,IAAI;CAE7B,GACA,CAAC,KAAK,aAAa,CACrB;CAEA,IAAI,CAAC,KACH,OAAO;CAGT,OAAO,oBAAC,WAAD;EAAW,QAAQ,KAAK;EAAQ,UAAU;CAAe,CAAA;AAClE;;;ACnBA,IAAA,wBAAe,WAAW,iBACxB,OAAO,QACL,WAAW,YAAY,aAAa,cAAc;CAChD,QAAQ,OAAO;EACb,IAAI;EACJ,QAAQ,WAAW,MACjB,WAAW,OAAO,WAAW,SAAS,KAAK,IAAI,GAC/C,WAAW,OAAO,WAAW,SAAS,KAAK,IAAI,GAC/C,WAAW,OAAO,WAAW,OAAO,KAAK,IAAI,CAC/C;EACA,WAAW;EACX,QAAQ,EAAE,MAAM,MAAM,EAAE,iBAAiB;GAAE;GAAM;EAAQ;CAC3D,CAAC;CACD,QAAQ,OAAO;EACb,IAAI;EACJ,QAAQ,WAAW,mBAChB,QAAQ,CAAC,CAAC,SAAS,eAAyC,KAAK,WAAW,kBAAkB,CACjG;EACA,WAAW;CACb,CAAC;CACD,QAAQ,OAAO;EACb,IAAI;EACJ,QAAQ,WAAW,SAAS,WAAW,SAAS,KAAK,QAAQ,GAAG;EAChE,WAAW;EACX,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ;CAC/C,CAAC;AACH,CAAC,CACH,CACF"}

package/dist/lib/chunk-read.mjs

@@ -0,0 +1,32 @@
+import { a as Read } from "./chunk-types.mjs";
+import { Operation } from "@dxos/compute";
+import { ContentBlock } from "@dxos/types";
+import { Blob, Database } from "@dxos/echo";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+//#region src/operations/read.ts
+var BASE64_CHUNK_SIZE = 32768;
+var bytesToBase64 = (bytes) => {
+	let binary = "";
+	for (let offset = 0; offset < bytes.length; offset += BASE64_CHUNK_SIZE) binary += String.fromCharCode(...bytes.subarray(offset, offset + BASE64_CHUNK_SIZE));
+	return btoa(binary);
+};
+var handler = Read.pipe(Operation.withHandler(Effect.fn(function* ({ file }) {
+	const obj = yield* Database.load(file);
+	const blob = yield* Database.load(obj.data);
+	const type = blob.type ?? "application/octet-stream";
+	const urlOption = yield* Blob.url(blob);
+	const url = yield* Option.match(urlOption, {
+		onSome: Effect.succeed,
+		onNone: () => Blob.read(blob).pipe(Effect.map((bytes) => `data:${type};base64,${bytesToBase64(bytes)}`))
+	});
+	return ContentBlock.ContentBlockResult.make({ content: [ContentBlock.File.make({
+		url,
+		name: obj.name,
+		mediaType: type
+	})] });
+})));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-read.mjs.map

package/dist/lib/chunk-read.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-read.mjs","names":[],"sources":["../../src/operations/read.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\n\nimport { Operation } from '@dxos/compute';\nimport { Blob, Database } from '@dxos/echo';\nimport { ContentBlock } from '@dxos/types';\n\nimport { FileOperation } from '../types';\n\nconst BASE64_CHUNK_SIZE = 0x8000;\n\n// `String.fromCharCode(...bytes)` blows the call stack / argument limit for large arrays, so the\n// bytes are base64-encoded in chunks. `Buffer` isn't available in browser bundles.\nconst bytesToBase64 = (bytes: Uint8Array): string => {\n  let binary = '';\n  for (let offset = 0; offset < bytes.length; offset += BASE64_CHUNK_SIZE) {\n    binary += String.fromCharCode(...bytes.subarray(offset, offset + BASE64_CHUNK_SIZE));\n  }\n  return btoa(binary);\n};\n\nconst handler: Operation.WithHandler<typeof FileOperation.Read> = FileOperation.Read.pipe(\n  Operation.withHandler(\n    Effect.fn(function* ({ file }) {\n      const obj = yield* Database.load(file);\n      const blob = yield* Database.load(obj.data);\n      const type = blob.type ?? 'application/octet-stream';\n      const urlOption = yield* Blob.url(blob);\n      const url = yield* Option.match(urlOption, {\n        onSome: Effect.succeed,\n        // No renderable URL from the backend (e.g. external storage without `getUrl`) — fall back\n        // to reading the bytes directly and encoding them as a `data:` URL.\n        onNone: () => Blob.read(blob).pipe(Effect.map((bytes) => `data:${type};base64,${bytesToBase64(bytes)}`)),\n      });\n\n      return ContentBlock.ContentBlockResult.make({\n        content: [\n          ContentBlock.File.make({\n            url,\n            name: obj.name,\n            mediaType: type,\n          }),\n        ],\n      });\n    }),\n  ),\n);\n\nexport default handler;\n"],"mappings":";;;;;;;AAaA,IAAM,oBAAoB;AAI1B,IAAM,iBAAiB,UAA8B;CACnD,IAAI,SAAS;CACb,KAAK,IAAI,SAAS,GAAG,SAAS,MAAM,QAAQ,UAAU,mBACpD,UAAU,OAAO,aAAa,GAAG,MAAM,SAAS,QAAQ,SAAS,iBAAiB,CAAC;CAErF,OAAO,KAAK,MAAM;AACpB;AAEA,IAAM,UAAA,KAA+E,KACnF,UAAU,YACR,OAAO,GAAG,WAAW,EAAE,QAAQ;CAC7B,MAAM,MAAM,OAAO,SAAS,KAAK,IAAI;CACrC,MAAM,OAAO,OAAO,SAAS,KAAK,IAAI,IAAI;CAC1C,MAAM,OAAO,KAAK,QAAQ;CAC1B,MAAM,YAAY,OAAO,KAAK,IAAI,IAAI;CACtC,MAAM,MAAM,OAAO,OAAO,MAAM,WAAW;EACzC,QAAQ,OAAO;EAGf,cAAc,KAAK,KAAK,IAAI,CAAC,CAAC,KAAK,OAAO,KAAK,UAAU,QAAQ,KAAK,UAAU,cAAc,KAAK,GAAG,CAAC;CACzG,CAAC;CAED,OAAO,aAAa,mBAAmB,KAAK,EAC1C,SAAS,CACP,aAAa,KAAK,KAAK;EACrB;EACA,MAAM,IAAI;EACV,WAAW;CACb,CAAC,CACH,EACF,CAAC;AACH,CAAC,CACH,CACF"}

package/dist/lib/chunk-settings.mjs

@@ -0,0 +1,23 @@
+import { meta } from "#meta";
+import { Capability } from "@dxos/app-framework";
+import { AppCapabilities } from "@dxos/app-toolkit";
+import { FileCapabilities, Settings } from "#types";
+import { createKvsStore } from "@dxos/effect";
+import * as Effect from "effect/Effect";
+//#region src/capabilities/settings.ts
+var settings_default = Capability.makeModule(() => Effect.sync(() => {
+	const settingsAtom = createKvsStore({
+		key: meta.profile.key,
+		schema: Settings.Settings,
+		defaultValue: () => ({})
+	});
+	return [Capability.contributes(FileCapabilities.SettingsAtom, settingsAtom), Capability.contributes(AppCapabilities.Settings, {
+		prefix: meta.profile.key,
+		schema: Settings.Settings,
+		atom: settingsAtom
+	})];
+}));
+//#endregion
+export { settings_default as default };
+
+//# sourceMappingURL=chunk-settings.mjs.map

package/dist/lib/chunk-settings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-settings.mjs","names":[],"sources":["../../src/capabilities/settings.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { AppCapabilities } from '@dxos/app-toolkit';\nimport { createKvsStore } from '@dxos/effect';\n\nimport { meta } from '#meta';\nimport { FileCapabilities, Settings } from '#types';\n\nexport default Capability.makeModule(() =>\n  Effect.sync(() => {\n    const settingsAtom = createKvsStore({\n      key: meta.profile.key,\n      schema: Settings.Settings,\n      defaultValue: () => ({}),\n    });\n\n    return [\n      Capability.contributes(FileCapabilities.SettingsAtom, settingsAtom),\n      Capability.contributes(AppCapabilities.Settings, {\n        prefix: meta.profile.key,\n        schema: Settings.Settings,\n        atom: settingsAtom,\n      }),\n    ];\n  }),\n);\n"],"mappings":";;;;;;;AAaA,IAAA,mBAAe,WAAW,iBACxB,OAAO,WAAW;CAChB,MAAM,eAAe,eAAe;EAClC,KAAK,KAAK,QAAQ;EAClB,QAAQ,SAAS;EACjB,qBAAqB,CAAC;CACxB,CAAC;CAED,OAAO,CACL,WAAW,YAAY,iBAAiB,cAAc,YAAY,GAClE,WAAW,YAAY,gBAAgB,UAAU;EAC/C,QAAQ,KAAK,QAAQ;EACrB,QAAQ,SAAS;EACjB,MAAM;CACR,CAAC,CACH;AACF,CAAC,CACH"}

package/dist/lib/chunk-skill-definition.mjs

@@ -0,0 +1,10 @@
+import { Capability } from "@dxos/app-framework";
+import { AppCapabilities } from "@dxos/app-toolkit";
+import * as Effect from "effect/Effect";
+import { FileSkill } from "#skills";
+//#region src/capabilities/skill-definition.ts
+var skillDefinition = () => Effect.succeed([Capability.contributes(AppCapabilities.SkillDefinition, FileSkill)]);
+//#endregion
+export { skillDefinition as default };
+
+//# sourceMappingURL=chunk-skill-definition.mjs.map

package/dist/lib/chunk-skill-definition.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-skill-definition.mjs","names":[],"sources":["../../src/capabilities/skill-definition.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { AppCapabilities } from '@dxos/app-toolkit';\n\nimport { FileSkill } from '#skills';\n\nconst skillDefinition = () => Effect.succeed([Capability.contributes(AppCapabilities.SkillDefinition, FileSkill)]);\n\nexport default skillDefinition;\n"],"mappings":";;;;;AAWA,IAAM,wBAAwB,OAAO,QAAQ,CAAC,WAAW,YAAY,gBAAgB,iBAAiB,SAAS,CAAC,CAAC"}