@agimon-ai/po-plan 0.0.0-alpha.28 → 0.0.0-alpha.29

package/README.md

@@ -77,8 +77,9 @@ modes:
 ```
 
 `main` controls the planning model, `subagents` controls delegated research defaults, and
-`plansDirectory` can be absolute, repository-relative, or under `~`. Planning and delegated model
-calls consume provider quota.
+`plansDirectory` can be absolute, repository-relative, or under `~`. When session artifacts are
+available, plans are stored under `<artifactRoot>/plans/` instead; `plansDirectory` is the fallback.
+Planning and delegated model calls consume provider quota.
 
 ## Public API
 

package/dist/extensions/server.cjs

@@ -24,15 +24,14 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_config = require("../config-BjNpZeNO.cjs");
+require("../config-BjNpZeNO.cjs");
 const require_prompts = require("../prompts-xBLz0h6f.cjs");
 let node_buffer = require("node:buffer");
+let _agimon_ai_po_core_config = require("@agimon-ai/po-core/config");
 let _agimon_ai_po_core_serverPlugin = require("@agimon-ai/po-core/serverPlugin");
 let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
 let typebox = require("typebox");
 let node_crypto = require("node:crypto");
-let node_fs_promises = require("node:fs/promises");
-node_fs_promises = __toESM(node_fs_promises, 1);
 let hono = require("hono");
 let node_fs = require("node:fs");
 node_fs = __toESM(node_fs, 1);
@@ -41,6 +40,8 @@ node_os = __toESM(node_os, 1);
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
 let _agimon_ai_po_core_piSettings = require("@agimon-ai/po-core/piSettings");
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = __toESM(node_fs_promises, 1);
 let _agimon_ai_po_core_voiceTools = require("@agimon-ai/po-core/voiceTools");
 let _agimon_ai_po_minor_mode = require("@agimon-ai/po-minor-mode");
 let _agimon_ai_po_config = require("@agimon-ai/po-config");
@@ -215,6 +216,36 @@ function formatPlanStatus(title, stamp) {
 	return `${title}${STATUS_SEPARATOR}${stamp}`;
 }
 //#endregion
+//#region src/services/planFiles/index.ts
+async function writeNewPlanFile(directory, filename, content) {
+	await node_fs_promises.default.mkdir(directory, {
+		recursive: true,
+		mode: 448
+	});
+	const planPath = node_path.default.join(directory, filename);
+	await node_fs_promises.default.writeFile(planPath, content, {
+		encoding: "utf8",
+		flag: "wx",
+		mode: 384
+	});
+	return planPath;
+}
+async function readPlanText(planPath) {
+	return await node_fs_promises.default.readFile(planPath, "utf8");
+}
+async function readPlanBytes(planPath) {
+	return await node_fs_promises.default.readFile(planPath);
+}
+async function overwritePlanFile(planPath, content) {
+	const stats = await node_fs_promises.default.lstat(planPath);
+	if (!stats.isFile() || stats.nlink !== 1) return false;
+	await node_fs_promises.default.writeFile(planPath, content, {
+		encoding: "utf8",
+		mode: 384
+	});
+	return true;
+}
+//#endregion
 //#region src/services/planApi/index.ts
 /**
 * This package's HTTP surface: the session's current plan, and the manual save.
@@ -246,7 +277,7 @@ function hashOf(content) {
 async function readPlan(planPath) {
 	let raw;
 	try {
-		raw = await node_fs_promises.default.readFile(planPath);
+		raw = await readPlanBytes(planPath);
 	} catch {
 		return {
 			content: "",
@@ -270,7 +301,7 @@ async function readPlan(planPath) {
 }
 function createPlanApi(options = {}) {
 	const app = new hono.Hono();
-	const pointers = options.pointers ?? new PlanPointerService({ env: process.env });
+	const pointers = options.pointers ?? new PlanPointerService();
 	const pointerFor = () => options.sessionId === void 0 ? void 0 : pointers.read(options.sessionId);
 	app.get(routes.current.path, async (context) => {
 		const pointer = pointerFor();
@@ -300,12 +331,7 @@ function createPlanApi(options = {}) {
 			error: STALE_SAVE,
 			hash: current.hash
 		}, 409);
-		const stats = await node_fs_promises.default.lstat(pointer.path);
-		if (!stats.isFile() || stats.nlink !== 1) return context.json({ error: NOT_A_FILE }, 409);
-		await node_fs_promises.default.writeFile(pointer.path, request.content, {
-			encoding: "utf8",
-			mode: 384
-		});
+		if (!await overwritePlanFile(pointer.path, request.content)) return context.json({ error: NOT_A_FILE }, 409);
 		return context.json({ hash: hashOf(request.content) });
 	});
 	return app;
@@ -314,7 +340,13 @@ function createPlanApi(options = {}) {
 const api = {
 	basePath: API_BASE_PATH,
 	start(context) {
-		const app = createPlanApi(context.sessionId === void 0 ? {} : { sessionId: context.sessionId });
+		const app = createPlanApi({
+			...context.sessionId === void 0 ? {} : { sessionId: context.sessionId },
+			pointers: new PlanPointerService({
+				env: context.environment ?? {},
+				homeDirectory: context.homeDirectory
+			})
+		});
 		return {
 			fetch: (request) => app.fetch(request),
 			close: () => void 0
@@ -329,6 +361,7 @@ function readPoSubagentPolicyService(ctx) {
 }
 //#endregion
 //#region src/services/planServerSession/index.ts
+const PLAN_ARTIFACT_SERVICE = "po/artifacts";
 const RECORD_DEBUG_EVIDENCE_TOOL = "record_debug_evidence";
 const WRITE_PLAN_TOOL = "write_plan";
 const COMPLETE_PLAN_TOOL = "complete_plan";
@@ -345,15 +378,6 @@ const PLAN_SERVER_CAPABILITIES = {
 };
 const PLAN_SUBAGENT_POLICY = {
 	owner: "@agimon-ai/po-plan",
-	allowedTools: [
-		"read",
-		"bash",
-		"grep",
-		"find",
-		"ls",
-		"mcp"
-	],
-	requiredTools: ["bash"],
 	allowMcpTools: true,
 	allowedExternalProfiles: [],
 	denyExtensions: false
@@ -392,14 +416,24 @@ function output(value, isError = false) {
 		...isError ? { isError: true } : {}
 	};
 }
-function createPlanServerSession(host) {
+function createPlanServerSession(host, options) {
 	let flavor = "normal";
 	let debugEvidence;
 	let modeOwner;
 	const selected = () => modeSelected(host);
-	const homeDirectory = () => host.context.environment.HOME ?? node_os.default.homedir();
-	const plansDirectory = () => (0, _agimon_ai_po_config.resolvePlanningPlansDirectory)(require_config.loadPoConfig(host.context.repoRoot, homeDirectory()).modes?.planning?.plansDirectory, host.context.repoRoot, homeDirectory());
-	const pointers = new PlanPointerService({ env: host.context.environment });
+	let configService;
+	let artifactStorage;
+	const planningConfig = () => configService?.getSnapshot().settings.modes?.planning;
+	const plansDirectory = async () => {
+		const root = await artifactStorage?.rootForSession(host.context.sessionId, host.context.environment);
+		if (root !== void 0) return node_path.default.join(root, "plans");
+		if (options.homeDirectory === void 0) throw new Error("Po needs a home directory to choose the plans folder.");
+		return (0, _agimon_ai_po_config.resolvePlanningPlansDirectory)(planningConfig()?.plansDirectory, host.context.repoRoot, options.homeDirectory);
+	};
+	const pointers = new PlanPointerService({
+		env: host.context.environment,
+		homeDirectory: options.homeDirectory
+	});
 	/**
 	* The activity group's line, and the pointer its panel reads.
 	*
@@ -462,7 +496,7 @@ function createPlanServerSession(host) {
 		const wasEnabled = selected();
 		const session = host.context.session;
 		if (enabled && !wasEnabled) {
-			const config = require_config.loadPoConfig(host.context.repoRoot, homeDirectory()).modes?.planning?.main;
+			const config = planningConfig()?.main;
 			if (config?.model || config?.thinking) {
 				if (!session.readModelSettings || !session.setModelSettings) throw new Error("This session cannot apply planning model settings.");
 				const previous = await session.readModelSettings();
@@ -577,7 +611,26 @@ function createPlanServerSession(host) {
 		}
 	}).createOwner(void 0);
 	return {
-		services: [(0, _agimon_ai_po_minor_mode.serverMinorModes)([modeOwner]), serverPlanSubagentPolicy(host)],
+		services: [
+			(0, _agimon_ai_po_minor_mode.serverMinorModes)([modeOwner]),
+			serverPlanSubagentPolicy(host),
+			(context) => {
+				context.inject([_agimon_ai_po_core_config.PO_CONFIG_SERVICE], (child) => {
+					const service = child.get(_agimon_ai_po_core_config.PO_CONFIG_SERVICE);
+					configService = service;
+					return () => {
+						if (configService === service) configService = void 0;
+					};
+				});
+				context.inject([PLAN_ARTIFACT_SERVICE], (child) => {
+					const storage = child.get(PLAN_ARTIFACT_SERVICE);
+					artifactStorage = storage;
+					return () => {
+						if (artifactStorage === storage) artifactStorage = void 0;
+					};
+				});
+			}
+		],
 		resources: [{
 			when: {
 				state: { "minor-mode": PLAN_MODE_ID },
@@ -671,6 +724,7 @@ function createPlanServerSession(host) {
 				},
 				name: WRITE_PLAN_TOOL,
 				label: "Write Plan",
+				mainAgentOnly: true,
 				description: "Save the supplied Markdown plan, or the plan already presented in the local session.",
 				parameters: writePlanParameters,
 				executionMode: "serial",
@@ -690,20 +744,10 @@ function createPlanServerSession(host) {
 							content = typeof requested === "string" ? requested : "";
 						}
 						if (typeof content !== "string" || !content.trim()) throw new Error("No implementation plan content was supplied.");
-						const directory = plansDirectory();
-						await (0, node_fs_promises.mkdir)(directory, {
-							recursive: true,
-							mode: 448
-						});
+						const directory = await plansDirectory();
 						const title = planTitleOf(content);
 						const writtenAt = (/* @__PURE__ */ new Date()).toISOString();
-						const filename = `${planTitleSlug(content)}-${Date.now()}.md`;
-						const filePath = node_path.default.join(directory, filename);
-						await (0, node_fs_promises.writeFile)(filePath, `${content.trim()}\n`, {
-							encoding: "utf8",
-							mode: 384,
-							flag: "wx"
-						});
+						const filePath = await writeNewPlanFile(directory, `${planTitleSlug(content)}-${Date.now()}.md`, `${content.trim()}\n`);
 						await host.context.session.appendCustomEntry(PLAN_DOCUMENT, {
 							path: filePath,
 							content: content.trim(),
@@ -735,6 +779,7 @@ function createPlanServerSession(host) {
 				},
 				name: COMPLETE_PLAN_TOOL,
 				label: "Complete Plan",
+				mainAgentOnly: true,
 				description: "Request exit-or-continue approval in the local Po UI. Requires the user to interact there; this is not a ChatGPT approval dialog.",
 				parameters: {
 					type: "object",
@@ -777,14 +822,14 @@ function createPlanServerSession(host) {
 				event: "before_agent_start",
 				async handle(event) {
 					const prompt = typeof event.systemPrompt === "string" ? event.systemPrompt : "";
-					const directory = plansDirectory();
+					const directory = await plansDirectory();
 					const sections = [require_prompts.buildPlanModeBasePrompt(directory, PLAN_SERVER_CAPABILITIES), require_prompts.buildFlavorPlanningPrompt(flavor, directory, debugEvidence)];
 					const saved = await latestEntry(PLAN_DOCUMENT);
 					if (saved !== void 0 && saved !== null && typeof saved === "object" && "path" in saved) {
 						const document = saved;
 						let content = document.content ?? "";
 						try {
-							content = await (0, node_fs_promises.readFile)(document.path, "utf8");
+							content = await readPlanText(document.path);
 						} catch {
 							content = document.content ?? "";
 						}
@@ -921,10 +966,10 @@ function parseDebugEvidencePacket(value) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/root.server.ts
-var root_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoot)(({ agent }) => {
+var root_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoot)(({ agent, host }) => {
 	const value = {
 		api: [api],
-		...agent ? createPlanServerSession(agent) : {}
+		...agent ? createPlanServerSession(agent, { homeDirectory: host.context.homeDirectory ?? host.context.environment?.HOME }) : {}
 	};
 	return {
 		value,