@agimon-ai/po-author 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/extensions/server.cjs

@@ -2,9 +2,9 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_structuredDocuments = require("../structuredDocuments-CNac1JmJ.cjs");
-const require_authorFacade = require("../authorFacade-BYvlm8Ff.cjs");
-let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+const require_structuredDocuments = require("../structuredDocuments-OYXnnCrZ.cjs");
+const require_authorFacade = require("../authorFacade-BkIMF1lR.cjs");
+let _agimon_ai_po_core_serverPlugin = require("@agimon-ai/po-core/serverPlugin");
 let _agimon_ai_po_minor_mode = require("@agimon-ai/po-minor-mode");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");
@@ -13,23 +13,89 @@ let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile
 let hono = require("hono");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_structuredDocuments.__toESM(node_fs_promises, 1);
+let _agimon_ai_po_artifact_artifactFiles = require("@agimon-ai/po-artifact/artifactFiles");
 let _agimon_ai_po_core_web = require("@agimon-ai/po-core/web");
 //#region src/services/structuredDocuments/document.ts
 const AUTHOR_DOCUMENT_MAX_BYTES = 26214400;
-async function readDocument(cwd, requestedPath) {
-	if (typeof requestedPath !== "string" || requestedPath.length === 0 || requestedPath.includes("\0") || node_path.default.isAbsolute(requestedPath)) throw new Error("A relative document path is required.");
+function inside(root, candidate) {
+	const relative = node_path.default.relative(root, candidate);
+	return relative !== "" && relative !== ".." && !relative.startsWith(`..${node_path.default.sep}`) && !node_path.default.isAbsolute(relative);
+}
+/**
+* The session artifact folder is the one place outside the working tree Author
+* may read. It is named either `artifact:<relative>` or by the absolute path the
+* agent's prompt gives; po-artifact's guarded open does the containment checks.
+*/
+async function resolveArtifact(requestedPath, sessionId) {
+	const prefixed = requestedPath.startsWith(require_structuredDocuments.AUTHOR_ARTIFACT_PREFIX);
+	if (sessionId === void 0) {
+		if (prefixed) throw new require_structuredDocuments.DocumentRequestError("Artifacts need a session.", 400);
+		return;
+	}
+	const root = (0, _agimon_ai_po_artifact_artifactFiles.artifactRoot)(sessionId, process.env);
+	if (prefixed) return {
+		root,
+		relative: requestedPath.slice(require_structuredDocuments.AUTHOR_ARTIFACT_PREFIX.length)
+	};
+	if (!node_path.default.isAbsolute(requestedPath)) return void 0;
+	const base = [root, await node_fs_promises.default.realpath(root).catch(() => root)].find((candidate) => inside(candidate, requestedPath));
+	if (base === void 0) return void 0;
+	return {
+		root,
+		relative: node_path.default.relative(base, requestedPath).split(node_path.default.sep).join("/")
+	};
+}
+async function resolveDocument(cwd, requestedPath, sessionId) {
+	if (typeof requestedPath !== "string" || requestedPath.length === 0 || requestedPath.includes("\0")) throw new Error("A relative document path is required.");
+	const artifact = await resolveArtifact(requestedPath, sessionId);
+	if (artifact !== void 0) {
+		const realRoot = await node_fs_promises.default.realpath(artifact.root).catch(() => artifact.root);
+		return {
+			kind: "artifact",
+			path: `${require_structuredDocuments.AUTHOR_ARTIFACT_PREFIX}${artifact.relative}`,
+			realPath: node_path.default.join(realRoot, artifact.relative),
+			...artifact
+		};
+	}
+	if (node_path.default.isAbsolute(requestedPath)) throw new Error("A relative document path, or a file in the session artifact folder, is required.");
 	const root = await node_fs_promises.default.realpath(cwd);
 	const candidate = node_path.default.resolve(root, requestedPath);
 	if (candidate !== root && !candidate.startsWith(`${root}${node_path.default.sep}`)) throw new require_structuredDocuments.DocumentRequestError("Document path is outside the working directory.", 403);
 	const realCandidate = await node_fs_promises.default.realpath(candidate);
 	if (realCandidate !== root && !realCandidate.startsWith(`${root}${node_path.default.sep}`)) throw new require_structuredDocuments.DocumentRequestError("Document path is outside the working directory.", 403);
-	if ((await node_fs_promises.default.stat(realCandidate)).size > 26214400) throw require_structuredDocuments.documentTooLarge(`Document exceeds the ${AUTHOR_DOCUMENT_MAX_BYTES} byte preview limit.`);
-	return await node_fs_promises.default.readFile(realCandidate);
+	return {
+		kind: "workspace",
+		path: node_path.default.relative(root, realCandidate).split(node_path.default.sep).join("/"),
+		realPath: realCandidate
+	};
+}
+async function readArtifact(root, relative) {
+	let file;
+	try {
+		file = await (0, _agimon_ai_po_artifact_artifactFiles.openArtifact)(root, relative);
+	} catch (error) {
+		if (error instanceof _agimon_ai_po_artifact_artifactFiles.ArtifactAccessError) throw new require_structuredDocuments.DocumentRequestError(error.message, error.status);
+		throw error;
+	}
+	try {
+		if (file.stat.size > 26214400) throw require_structuredDocuments.documentTooLarge(`Document exceeds the ${AUTHOR_DOCUMENT_MAX_BYTES} byte preview limit.`);
+		return await (0, _agimon_ai_po_artifact_artifactFiles.readArtifactBytes)(file.handle, file.stat.size);
+	} finally {
+		await file.handle.close();
+	}
+}
+async function readSource(source) {
+	if (source.kind === "artifact") return await readArtifact(source.root, source.relative);
+	if ((await node_fs_promises.default.stat(source.realPath)).size > 26214400) throw require_structuredDocuments.documentTooLarge(`Document exceeds the ${AUTHOR_DOCUMENT_MAX_BYTES} byte preview limit.`);
+	return await node_fs_promises.default.readFile(source.realPath);
+}
+async function readDocument(cwd, requestedPath, sessionId) {
+	return await readSource(await resolveDocument(cwd, requestedPath, sessionId));
 }
 //#endregion
 //#region src/services/authorCanvasRegistry/index.ts
 const MAX_CANVASES = 32;
-function createAuthorCanvasRegistry(cwd, createBridge) {
+function createAuthorCanvasRegistry(cwd, createBridge, sessionId) {
 	const byAlias = /* @__PURE__ */ new Map();
 	const byPath = /* @__PURE__ */ new Map();
 	const select = (alias) => {
@@ -69,12 +135,10 @@ function createAuthorCanvasRegistry(cwd, createBridge) {
 		async open(requestedPath, signal, requestedAlias) {
 			signal?.throwIfAborted();
 			if (requestedAlias !== void 0 && !require_structuredDocuments.AUTHOR_ALIAS_PATTERN.test(requestedAlias)) throw new require_structuredDocuments.AuthorBridgeError("Invalid Author canvas alias.", 400);
-			const bytes = await readDocument(cwd, requestedPath);
+			const source = await resolveDocument(cwd, requestedPath, sessionId);
+			const bytes = await readSource(source);
 			signal?.throwIfAborted();
-			const root = await node_fs_promises.default.realpath(cwd);
-			const realPath = await node_fs_promises.default.realpath(node_path.default.resolve(root, requestedPath));
-			if (realPath !== root && !realPath.startsWith(`${root}${node_path.default.sep}`)) throw new require_structuredDocuments.AuthorBridgeError("Document path is outside the working directory.", 400);
-			const canonicalPath = node_path.default.relative(root, realPath).split(node_path.default.sep).join("/");
+			const { realPath, path: canonicalPath } = source;
 			const occupied = requestedAlias === void 0 ? void 0 : byAlias.get(requestedAlias);
 			if (occupied !== void 0 && occupied.realPath !== realPath) throw new require_structuredDocuments.AuthorBridgeError(`Author canvas alias '${requestedAlias}' already names ${occupied.path}.`, 409);
 			const existing = byPath.get(realPath);
@@ -89,8 +153,14 @@ function createAuthorCanvasRegistry(cwd, createBridge) {
 					reused: true
 				};
 			}
-			if (byAlias.size >= MAX_CANVASES) throw new require_structuredDocuments.AuthorBridgeError("Too many Author canvases in this conversation.", 409);
-			const base = node_path.default.basename(canonicalPath).replace(/\.[^.]*$/u, "").toLowerCase().replace(/[^a-z0-9_-]+/gu, "-").replace(/^[^a-z]+/u, "canvas-").slice(0, 48) || "canvas";
+			if (byAlias.size >= MAX_CANVASES) {
+				const reusable = [...byAlias.values()].find((canvas) => canvas.closed);
+				if (reusable === void 0) throw new require_structuredDocuments.AuthorBridgeError("Too many Author canvases in this conversation.", 409);
+				reusable.bridge.close();
+				byAlias.delete(reusable.alias);
+				byPath.delete(reusable.realPath);
+			}
+			const base = node_path.default.basename(realPath).replace(/\.[^.]*$/u, "").toLowerCase().replace(/[^a-z0-9_-]+/gu, "-").replace(/^[^a-z]+/u, "canvas-").slice(0, 48) || "canvas";
 			let alias = requestedAlias ?? base;
 			for (let suffix = 2; byAlias.has(alias); suffix++) alias = `${base.slice(0, 56)}-${suffix}`;
 			const canvas = {
@@ -157,14 +227,6 @@ function createAuthorCanvasRegistry(cwd, createBridge) {
 			canvas.bridge.close();
 			canvas.bridge = createBridge();
 		},
-		closeAll() {
-			for (const canvas of byAlias.values()) {
-				if (canvas.closed) continue;
-				canvas.closed = true;
-				canvas.bridge.close();
-				canvas.bridge = createBridge();
-			}
-		},
 		dispose() {
 			for (const canvas of byAlias.values()) canvas.bridge.close();
 			byAlias.clear();
@@ -399,7 +461,7 @@ function createAuthorDocumentApi(options = {}) {
 		try {
 			const body = await bodyOf(context.req.raw);
 			if (body.format === void 0 && options.open !== void 0) return context.json(await options.open(body.path, context.req.raw.signal, body.alias));
-			const bytes = await readDocument(cwd, body.path);
+			const bytes = await readDocument(cwd, body.path, options.sessionId);
 			if (body.format === void 0) return context.json({
 				path: body.path,
 				byteLength: bytes.byteLength
@@ -412,7 +474,7 @@ function createAuthorDocumentApi(options = {}) {
 	app.post(apiRoutes_default.documentsPreflight.path, async (context) => {
 		try {
 			const body = await bodyOf(context.req.raw);
-			const bytes = await readDocument(cwd, body.path);
+			const bytes = await readDocument(cwd, body.path, options.sessionId);
 			return context.json(await require_structuredDocuments.preflightStructuredDocument(requestFormat(body.format), bytes, requestOperations(body.operations), body.csvDialect));
 		} catch (error) {
 			return errorResponse(context, error);
@@ -422,7 +484,7 @@ function createAuthorDocumentApi(options = {}) {
 		try {
 			const body = await bodyOf(context.req.raw);
 			if (typeof body.preflightDigest !== "string") throw new Error("A preflight report digest is required.");
-			const bytes = await readDocument(cwd, body.path);
+			const bytes = await readDocument(cwd, body.path, options.sessionId);
 			const serialized = await require_structuredDocuments.serializeStructuredDocument(requestFormat(body.format), bytes, requestOperations(body.operations), body.preflightDigest, body.csvDialect);
 			return context.json({
 				bytes: Buffer.from(serialized.bytes).toString("base64"),
@@ -453,7 +515,7 @@ const createBridge = () => require_structuredDocuments.createAuthorBridgeState({
 });
 function createAuthorApi(options = {}) {
 	const app = new hono.Hono();
-	const registry = options.registry ?? createAuthorCanvasRegistry(options.cwd ?? process.cwd(), createBridge);
+	const registry = options.registry ?? createAuthorCanvasRegistry(options.cwd ?? process.cwd(), createBridge, options.sessionId);
 	app.get(apiRoutes_default.state.path, (context) => context.json({
 		sessionId: options.sessionId ?? null,
 		...(options.readState ?? inactiveState)()
@@ -461,6 +523,7 @@ function createAuthorApi(options = {}) {
 	app.route("/", createAuthorBridgeApi(registry));
 	app.route("/", createAuthorDocumentApi({
 		...options.cwd === void 0 ? {} : { cwd: options.cwd },
+		...options.sessionId === void 0 ? {} : { sessionId: options.sessionId },
 		open: (path, signal, alias) => registry.open(path, signal, alias)
 	}));
 	return app;
@@ -469,7 +532,7 @@ const api = {
 	basePath: API_BASE_PATH,
 	start(context) {
 		if (context.cwd === void 0) throw new Error("Author requires the session working directory.");
-		const registry = createAuthorCanvasRegistry(context.cwd, createBridge);
+		const registry = createAuthorCanvasRegistry(context.cwd, createBridge, context.sessionId);
 		const app = createAuthorApi({
 			...context.sessionId === void 0 ? {} : { sessionId: context.sessionId },
 			cwd: context.cwd,
@@ -483,9 +546,8 @@ const api = {
 };
 /** The session API and tools share the same browser ownership and pending requests. */
 function createAuthorSessionApi(cwd, sessionId) {
-	const registry = createAuthorCanvasRegistry(cwd, createBridge);
+	const registry = createAuthorCanvasRegistry(cwd, createBridge, sessionId);
 	return {
-		closeCanvases: () => registry.closeAll(),
 		catalog: {
 			open: (path, signal, alias) => registry.open(path, signal, alias),
 			async describe(signal, alias) {
@@ -525,7 +587,6 @@ var root_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoot)(({ ag
 				key: "minor-mode",
 				values: enabled ? [...modes, require_structuredDocuments.authorMinorMode.descriptor.id] : modes
 			});
-			if (!enabled) session?.closeCanvases();
 		}
 	}) : void 0;
 	return {
@@ -710,7 +771,7 @@ var author_webmcp_server_default = (0, _agimon_ai_po_core_extensionFile.defineCh
 //#endregion
 //#region src/services/authorBridgeMethod/index.ts
 function createAuthorBridgeMethod(scope, host) {
-	return (0, _agimon_ai_po_core_serverFacet.defineServerMethod)(require_authorFacade.authorBridgeMethod(scope), ({ sessionId, message }, caller) => {
+	return (0, _agimon_ai_po_core_serverPlugin.defineServerMethod)(require_authorFacade.authorBridgeMethod(scope), ({ sessionId, message }, caller) => {
 		if (!caller.connectionId) throw new Error("Author bridge requires an authenticated browser connection.");
 		if (!host.context.receiveChannel?.(sessionId, "author_webmcp", message, caller.connectionId)) throw new Error("Author bridge session is outside this mount.");
 		return {};
@@ -752,7 +813,7 @@ var po_use_author_server_default = (0, _agimon_ai_po_core_extensionFile.defineRe
 	},
 	name: "po-use-author",
 	kind: "skill",
-	read: () => (0, _agimon_ai_po_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-author/SKILL.md")
+	read: () => (0, _agimon_ai_po_core_serverPlugin.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-author/SKILL.md")
 });
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/tool/describe-author-tools.server.ts
@@ -775,13 +836,16 @@ var use_author_tools_server_default = (0, _agimon_ai_po_core_extensionFile.defin
 //#endregion
 //#region generated/server.ts
 const at = (value, context) => typeof value === "function" ? value(context) : value;
+/* v8 ignore next -- generated normalization branch */
+const defined = (values) => values.filter((value) => value !== void 0);
 const via = (identity, value) => value === void 0 ? void 0 : {
 	...identity,
 	...value
 };
-const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
+const serverPlugin = (0, _agimon_ai_po_core_serverPlugin.defineServerPlugin)({
 	name: "@agimon-ai/po-author",
-	providerOverrides: (0, _agimon_ai_po_core_serverFacet.composeServerProviderOverrides)(root_server_default),
+	providerOverrides: (0, _agimon_ai_po_core_serverPlugin.composeServerProviderOverrides)(root_server_default),
+	injects: (0, _agimon_ai_po_core_extensionFile.composeRootInjects)({ session: [root_server_default] }),
 	global: (context) => ({
 		get channels() {
 			return [() => via({ frameType: "author_webmcp" }, author_webmcp_server_default())];
@@ -792,14 +856,14 @@ const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
 	}),
 	workspace: (context) => ({
 		get channels() {
-			return [() => via({ frameType: "author_webmcp" }, author_webmcp_server_default())];
+			return defined([context.hosted("global") ? void 0 : () => via({ frameType: "author_webmcp" }, author_webmcp_server_default())]);
 		},
 		get methods() {
 			return [at(bridge_server_default, context)];
 		}
 	}),
 	session: async (context) => {
-		const scopeSession = await root_server_default(context);
+		const scopeSession = await context.scopeRoot("session", root_server_default, context);
 		const contextSession = {
 			...context,
 			root: scopeSession.value
@@ -810,7 +874,7 @@ const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
 				return [at(route_server_default, contextSession)];
 			},
 			get channels() {
-				return [() => via({ frameType: "author_webmcp" }, author_webmcp_server_default())];
+				return defined([context.hosted("global") ? void 0 : () => via({ frameType: "author_webmcp" }, author_webmcp_server_default())]);
 			},
 			get commands() {
 				return [via({ name: "author" }, at(author_server_default, contextSession))];
@@ -839,7 +903,7 @@ const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
 	}
 });
 //#endregion
-exports.default = facet;
-exports.facet = facet;
+exports.default = serverPlugin;
+exports.serverPlugin = serverPlugin;
 
 //# sourceMappingURL=server.cjs.map