@symerian/symi 2.0.6 → 2.0.7

package/dist/{pi-embedded-BJC3CNWN.js → pi-embedded-ZzUH4ioO.js}

@@ -51483,7 +51483,7 @@ function isVoiceChannelType(type) {
 function createDefaultDeps() {
 	return {
 		sendMessageWhatsApp: async (...args) => {
-			const { sendMessageWhatsApp } = await import("./web-D3J3pm9B.js");
+			const { sendMessageWhatsApp } = await import("./web-0bP0TLM2.js");
 			return await sendMessageWhatsApp(...args);
 		},
 		sendMessageTelegram: async (...args) => {
@@ -66762,7 +66762,7 @@ function loadWebLoginQr() {
 	return webLoginQrPromise;
 }
 function loadWebChannel() {
-	webChannelPromise ??= import("./web-D3J3pm9B.js");
+	webChannelPromise ??= import("./web-0bP0TLM2.js");
 	return webChannelPromise;
 }
 function loadWhatsAppActions() {
@@ -74589,6 +74589,152 @@ function subscribeEmbeddedPiSession(params) {
 	};
 }
 
+//#endregion
+//#region src/agents/plan-mode.ts
+/**
+* Plan Mode — automatic complexity detection and structured planning.
+*
+* When a user message is complex (multi-step, multi-file, refactoring, etc.),
+* Symi auto-enters plan mode: read-only investigation → structured plan →
+* user approval → context-cleared execution.
+*/
+const PLAN_KEYWORDS = new Set([
+	"investigate",
+	"refactor",
+	"migrate",
+	"redesign",
+	"set up",
+	"setup",
+	"build",
+	"implement",
+	"architect",
+	"overhaul",
+	"restructure",
+	"rewrite"
+]);
+const ANALYSIS_KEYWORDS = new Set([
+	"analyze",
+	"analyse",
+	"compare",
+	"audit",
+	"review",
+	"evaluate",
+	"assess"
+]);
+const SEQUENTIAL_MARKERS = [
+	/\bthen\b/i,
+	/\bafter that\b/i,
+	/\bonce .+ is done\b/i,
+	/\bnext,?\s/i,
+	/\bfollowed by\b/i,
+	/\bfinally\b/i
+];
+const NUMBERED_LIST_RE = /^\s*\d+[.)]\s/gm;
+const FILE_PATH_RE = /(?:\/[\w.-]+){2,}|[\w.-]+\.[a-z]{1,4}/g;
+/**
+* Score a user message for complexity.
+* Returns a numeric score; >= PLAN_MODE_THRESHOLD triggers plan mode.
+*/
+function scorePlanComplexity(prompt) {
+	let score = 0;
+	const lower = prompt.toLowerCase();
+	if (prompt.length > 500) {
+		if ([...PLAN_KEYWORDS, ...ANALYSIS_KEYWORDS].some((kw) => lower.includes(kw)) || FILE_PATH_RE.test(prompt)) score += 3;
+	}
+	const numberedItems = prompt.match(NUMBERED_LIST_RE);
+	if (numberedItems && numberedItems.length >= 3) score += 2;
+	for (const kw of PLAN_KEYWORDS) if (lower.includes(kw)) {
+		score += 2;
+		break;
+	}
+	for (const re of SEQUENTIAL_MARKERS) if (re.test(prompt)) {
+		score += 2;
+		break;
+	}
+	const filePaths = prompt.match(FILE_PATH_RE);
+	if (filePaths && new Set(filePaths).size >= 2) score += 1;
+	for (const kw of ANALYSIS_KEYWORDS) if (lower.includes(kw)) {
+		score += 1;
+		break;
+	}
+	return score;
+}
+const PLAN_MODE_THRESHOLD = 5;
+/**
+* Determine whether a prompt should trigger plan mode.
+*
+* Priority:
+* 1. /plan prefix → always
+* 2. /noplan prefix → never
+* 3. Subagent/cron sessions → never
+* 4. Heuristic scoring
+*/
+function shouldEnterPlanMode(prompt, opts = {}) {
+	const trimmed = prompt.trim();
+	if (/^\/plan\b/i.test(trimmed)) return {
+		enter: true,
+		reason: "explicit /plan directive",
+		score: 99,
+		stripped: trimmed.replace(/^\/plan\s*/i, "").trim()
+	};
+	if (/^\/noplan\b/i.test(trimmed)) return {
+		enter: false,
+		reason: "explicit /noplan directive",
+		score: 0,
+		stripped: trimmed.replace(/^\/noplan\s*/i, "").trim()
+	};
+	if (opts.isSubagent) return {
+		enter: false,
+		reason: "subagent session",
+		score: 0
+	};
+	if (opts.isCron) return {
+		enter: false,
+		reason: "cron session",
+		score: 0
+	};
+	const score = scorePlanComplexity(trimmed);
+	if (score >= PLAN_MODE_THRESHOLD) return {
+		enter: true,
+		reason: `complexity score ${score} >= ${PLAN_MODE_THRESHOLD}`,
+		score
+	};
+	return {
+		enter: false,
+		reason: `complexity score ${score} < ${PLAN_MODE_THRESHOLD}`,
+		score
+	};
+}
+const PLAN_MODE_SYSTEM_PROMPT = `<plan_mode>
+You have entered PLAN MODE because this task is complex.
+
+RULES:
+- DO NOT write, edit, or create any files yet
+- DO NOT execute destructive commands (rm, mv, git reset, etc.)
+- DO read files, search code, check runtime state
+- DO use memory_search, web_search, exec (read-only commands like ls, cat, git status, git log)
+- Produce a detailed step-by-step implementation plan
+
+OUTPUT FORMAT:
+1. **Summary** — what needs to be done and why
+2. **Investigation** — files read, code searched, state checked
+3. **Files to modify** — list every file that will be created, edited, or deleted
+4. **Implementation phases** — numbered steps with:
+   - What changes in each phase
+   - Which files are touched
+   - Dependencies on prior phases
+5. **Risks & considerations** — things that could go wrong, edge cases, rollback strategy
+
+After presenting the plan, ask the user to choose one of these options.
+Present these as inline buttons if the channel supports them:
+- **Proceed** — clear context and execute the plan
+- **Modify** — adjust the plan based on feedback
+- **Cancel** — abandon the plan
+
+Use the message tool with buttons:
+[{"label": "✅ Proceed", "data": "/plan-proceed"}, {"label": "✏️ Modify", "data": "/plan-modify"}, {"label": "❌ Cancel", "data": "/plan-cancel"}]
+</plan_mode>`;
+
 //#endregion
 //#region src/agents/pi-embedded-runner/abort.ts
 /**
@@ -75842,6 +75988,17 @@ async function runEmbeddedAttempt(params) {
 						log$2.debug(`auto-recall: skipped (${String(recallErr)})`);
 					}
 				}
+				{
+					const planResult = shouldEnterPlanMode(effectivePrompt, {
+						isSubagent: isSubagentSessionKey(params.sessionKey),
+						isCron: isCronSessionKey(params.sessionKey)
+					});
+					if (planResult.enter) {
+						if (planResult.stripped != null) effectivePrompt = planResult.stripped;
+						effectivePrompt = `${PLAN_MODE_SYSTEM_PROMPT}\n\n${effectivePrompt}`;
+						log$2.info(`plan-mode: activated (${planResult.reason}) for runId=${params.runId}`);
+					} else if (planResult.stripped != null) effectivePrompt = planResult.stripped;
+				}
 				log$2.debug(`embedded run prompt start: runId=${params.runId} sessionId=${params.sessionId}`);
 				cacheTrace?.recordStage("prompt:before", {
 					prompt: effectivePrompt,

package/dist/{plugin-registry-KUffgxdX.js → plugin-registry-BAbkdLQ7.js}

@@ -2,7 +2,7 @@ import { t as __exportAll } from "./rolldown-runtime-Cbj13DAv.js";
 import { M as getActivePluginRegistry, o as createSubsystemLogger } from "./entry.js";
 import { c as resolveAgentWorkspaceDir, l as resolveDefaultAgentId } from "./agent-scope-D-jRCY0d.js";
 import { i as loadConfig } from "./config-amjzHiWZ.js";
-import { _ as loadSymiPlugins } from "./subagent-registry-BH79W7i1.js";
+import { _ as loadSymiPlugins } from "./subagent-registry-BR2Qhqjf.js";
 
 //#region src/cli/plugin-registry.ts
 var plugin_registry_exports = /* @__PURE__ */ __exportAll({ ensurePluginRegistryLoaded: () => ensurePluginRegistryLoaded });

package/dist/{plugin-registry-C5KPfoPc.js → plugin-registry-CEoSVvL1.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-Cbj13DAv.js";
-import { gt as loadSymiPlugins } from "./reply-D_FZec1Q.js";
+import { gt as loadSymiPlugins } from "./reply-B9o45s3E.js";
 import { d as getActivePluginRegistry } from "./registry-Cja8eT7G.js";
 import { t as createSubsystemLogger } from "./subsystem-D9vIQve0.js";
 import { c as resolveAgentWorkspaceDir, l as resolveDefaultAgentId } from "./agent-scope-CgUHAtCo.js";

package/dist/plugin-sdk/agents/plan-mode.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Plan Mode — automatic complexity detection and structured planning.
+ *
+ * When a user message is complex (multi-step, multi-file, refactoring, etc.),
+ * Symi auto-enters plan mode: read-only investigation → structured plan →
+ * user approval → context-cleared execution.
+ */
+/**
+ * Score a user message for complexity.
+ * Returns a numeric score; >= PLAN_MODE_THRESHOLD triggers plan mode.
+ */
+export declare function scorePlanComplexity(prompt: string): number;
+export declare const PLAN_MODE_THRESHOLD = 5;
+/**
+ * Determine whether a prompt should trigger plan mode.
+ *
+ * Priority:
+ * 1. /plan prefix → always
+ * 2. /noplan prefix → never
+ * 3. Subagent/cron sessions → never
+ * 4. Heuristic scoring
+ */
+export declare function shouldEnterPlanMode(prompt: string, opts?: {
+    isSubagent?: boolean;
+    isCron?: boolean;
+}): {
+    enter: boolean;
+    reason: string;
+    score: number;
+    stripped?: string;
+};
+export declare const PLAN_MODE_SYSTEM_PROMPT = "<plan_mode>\nYou have entered PLAN MODE because this task is complex.\n\nRULES:\n- DO NOT write, edit, or create any files yet\n- DO NOT execute destructive commands (rm, mv, git reset, etc.)\n- DO read files, search code, check runtime state\n- DO use memory_search, web_search, exec (read-only commands like ls, cat, git status, git log)\n- Produce a detailed step-by-step implementation plan\n\nOUTPUT FORMAT:\n1. **Summary** \u2014 what needs to be done and why\n2. **Investigation** \u2014 files read, code searched, state checked\n3. **Files to modify** \u2014 list every file that will be created, edited, or deleted\n4. **Implementation phases** \u2014 numbered steps with:\n   - What changes in each phase\n   - Which files are touched\n   - Dependencies on prior phases\n5. **Risks & considerations** \u2014 things that could go wrong, edge cases, rollback strategy\n\nAfter presenting the plan, ask the user to choose one of these options.\nPresent these as inline buttons if the channel supports them:\n- **Proceed** \u2014 clear context and execute the plan\n- **Modify** \u2014 adjust the plan based on feedback\n- **Cancel** \u2014 abandon the plan\n\nUse the message tool with buttons:\n[{\"label\": \"\u2705 Proceed\", \"data\": \"/plan-proceed\"}, {\"label\": \"\u270F\uFE0F Modify\", \"data\": \"/plan-modify\"}, {\"label\": \"\u274C Cancel\", \"data\": \"/plan-cancel\"}]\n</plan_mode>";

package/dist/plugin-sdk/{channel-web-DTV6QoJV.js → channel-web-xXTpy0N_.js}

@@ -1,6 +1,6 @@
 import { a as buildGroupHistoryKey, n as DEFAULT_MAIN_KEY, r as buildAgentMainSessionKey, s as normalizeAgentId } from "./session-key-C_0eELjb.js";
 import { f as readWebSelfId, o as getWebAuthAgeMs, r as resolveWhatsAppAccount } from "./accounts-D9zGZU5t.js";
-import { E as enqueueSystemEvent, G as resolveMentionGating, W as shouldAckReactionForWhatsApp, X as buildHistoryContextFromEntries, Y as DEFAULT_GROUP_HISTORY_LIMIT, _ as resolveEnvelopeFormatOptions, c as computeBackoff, d as formatDurationPrecise, f as dispatchReplyWithBufferedBlockDispatcher, g as formatInboundEnvelope, h as resolveInboundDebounceMs, ht as createDedupeCache, l as sleepWithAbort, m as createInboundDebouncer, n as normalizeGroupActivation, nt as buildMentionRegexes, r as parseActivationCommand, rt as normalizeMentionText, t as getReplyFromConfig, tt as recordPendingHistoryEntryIfEnabled, u as buildPairingReply, v as hasControlCommand, y as shouldComputeCommandAuthorized } from "./reply-CzCsghFB.js";
+import { E as enqueueSystemEvent, G as resolveMentionGating, W as shouldAckReactionForWhatsApp, X as buildHistoryContextFromEntries, Y as DEFAULT_GROUP_HISTORY_LIMIT, _ as resolveEnvelopeFormatOptions, c as computeBackoff, d as formatDurationPrecise, f as dispatchReplyWithBufferedBlockDispatcher, g as formatInboundEnvelope, h as resolveInboundDebounceMs, ht as createDedupeCache, l as sleepWithAbort, m as createInboundDebouncer, n as normalizeGroupActivation, nt as buildMentionRegexes, r as parseActivationCommand, rt as normalizeMentionText, t as getReplyFromConfig, tt as recordPendingHistoryEntryIfEnabled, u as buildPairingReply, v as hasControlCommand, y as shouldComputeCommandAuthorized } from "./reply-EEvLfWgt.js";
 import { A as normalizeE164, B as toWhatsappJid, K as logVerbose, N as resolveJidToE164, O as isSelfChatMode, R as sleep, Y as shouldLogVerbose, k as jidToE164, s as normalizeChatChannelId, tt as getChildLogger, x as clamp } from "./registry--_pGht6S.js";
 import { n as loadConfig } from "./config-Do1-fcaS.js";
 import { i as defaultRuntime, t as createSubsystemLogger } from "./subsystem-Coz2AgU8.js";

package/dist/plugin-sdk/index.js

@@ -1,6 +1,6 @@
 import { f as DEFAULT_ACCOUNT_ID, p as normalizeAccountId } from "./session-key-C_0eELjb.js";
 import { _ as createAccountListHelpers, i as resolveWhatsAppAuthDir, n as resolveDefaultWhatsAppAccountId, r as resolveWhatsAppAccount, t as listWhatsAppAccountIds } from "./accounts-D9zGZU5t.js";
-import { $ as clearHistoryEntriesIfEnabled, A as resolveDiscordUserAllowlist, B as logTypingFailure, C as stripMarkdown, Ct as unbindThreadBindingsBySessionKey, D as resolveSlackUserAllowlist, Dt as BLUEBUBBLES_ACTION_NAMES, Et as BLUEBUBBLES_ACTIONS, F as stringEnum, G as resolveMentionGating, H as removeAckReactionAfterReply, I as recordInboundSession, J as summarizeMapping, K as resolveMentionGatingWithBypass, L as resolveControlCommandGate, M as collectDiscordAuditChannelIds, N as formatDocsLink, O as resolveSlackChannelAllowlist, Ot as BLUEBUBBLES_GROUP_ACTIONS, P as optionalStringEnum, Q as clearHistoryEntries, R as logAckFailure, S as processLineMessage, St as listThreadBindingsBySessionKey, T as attachFooterText, Tt as resolveAllowlistMatchSimple, U as shouldAckReaction, V as createTypingCallbacks, W as shouldAckReactionForWhatsApp, Y as DEFAULT_GROUP_HISTORY_LIMIT, Z as buildPendingHistoryContextFromMap, _t as listDevicePairing, a as normalizeAccountId$1, at as isWSLEnv, bt as registerPluginHttpRoute, ct as DEFAULT_WEBHOOK_MAX_BODY_BYTES, dt as isRequestBodyLimitError, et as recordPendingHistoryEntry, ft as readJsonBodyWithLimit, gt as approveDevicePairing, ht as createDedupeCache, i as listLineAccountIds, it as isWSL2Sync, j as resolveDiscordChannelAllowlist, k as detectBinary, kt as CHANNEL_MESSAGE_ACTION_NAMES, lt as RequestBodyLimitError, mt as requestBodyErrorToText, o as resolveDefaultLineAccountId, ot as isWSLSync, pt as readRequestBodyWithLimit, q as mergeAllowlist, s as resolveLineAccount, st as DEFAULT_WEBHOOK_BODY_TIMEOUT_MS, tt as recordPendingHistoryEntryIfEnabled, ut as installRequestBodyLimitGuard, vt as rejectDevicePairing, w as createReceiptCard, wt as formatAllowlistMatchMeta, x as hasMarkdownToConvert, xt as autoBindSpawnedDiscordSubagent, yt as extractToolSend, z as logInboundDrop } from "./reply-CzCsghFB.js";
+import { $ as clearHistoryEntriesIfEnabled, A as resolveDiscordUserAllowlist, B as logTypingFailure, C as stripMarkdown, Ct as unbindThreadBindingsBySessionKey, D as resolveSlackUserAllowlist, Dt as BLUEBUBBLES_ACTION_NAMES, Et as BLUEBUBBLES_ACTIONS, F as stringEnum, G as resolveMentionGating, H as removeAckReactionAfterReply, I as recordInboundSession, J as summarizeMapping, K as resolveMentionGatingWithBypass, L as resolveControlCommandGate, M as collectDiscordAuditChannelIds, N as formatDocsLink, O as resolveSlackChannelAllowlist, Ot as BLUEBUBBLES_GROUP_ACTIONS, P as optionalStringEnum, Q as clearHistoryEntries, R as logAckFailure, S as processLineMessage, St as listThreadBindingsBySessionKey, T as attachFooterText, Tt as resolveAllowlistMatchSimple, U as shouldAckReaction, V as createTypingCallbacks, W as shouldAckReactionForWhatsApp, Y as DEFAULT_GROUP_HISTORY_LIMIT, Z as buildPendingHistoryContextFromMap, _t as listDevicePairing, a as normalizeAccountId$1, at as isWSLEnv, bt as registerPluginHttpRoute, ct as DEFAULT_WEBHOOK_MAX_BODY_BYTES, dt as isRequestBodyLimitError, et as recordPendingHistoryEntry, ft as readJsonBodyWithLimit, gt as approveDevicePairing, ht as createDedupeCache, i as listLineAccountIds, it as isWSL2Sync, j as resolveDiscordChannelAllowlist, k as detectBinary, kt as CHANNEL_MESSAGE_ACTION_NAMES, lt as RequestBodyLimitError, mt as requestBodyErrorToText, o as resolveDefaultLineAccountId, ot as isWSLSync, pt as readRequestBodyWithLimit, q as mergeAllowlist, s as resolveLineAccount, st as DEFAULT_WEBHOOK_BODY_TIMEOUT_MS, tt as recordPendingHistoryEntryIfEnabled, ut as installRequestBodyLimitGuard, vt as rejectDevicePairing, w as createReceiptCard, wt as formatAllowlistMatchMeta, x as hasMarkdownToConvert, xt as autoBindSpawnedDiscordSubagent, yt as extractToolSend, z as logInboundDrop } from "./reply-EEvLfWgt.js";
 import "./paths-DR2yt_mP.js";
 import "./github-copilot-token-D9X2phUj.js";
 import { D as resolveSlackAccount, E as resolveDefaultSlackAccountId, F as resolveDiscordAccount, M as listDiscordAccountIds, O as resolveSlackReplyToMode, P as resolveDefaultDiscordAccountId, S as resolveTelegramAccount, T as listSlackAccountIds, _ as normalizeWhatsAppTarget, a as listDiscordDirectoryPeersFromConfig, b as listTelegramAccountIds, c as listTelegramDirectoryGroupsFromConfig, d as listWhatsAppDirectoryPeersFromConfig, f as looksLikeSlackTargetId, g as isWhatsAppGroupJid, i as listDiscordDirectoryGroupsFromConfig, l as listTelegramDirectoryPeersFromConfig, o as listSlackDirectoryGroupsFromConfig, p as normalizeSlackMessagingTarget, s as listSlackDirectoryPeersFromConfig, u as listWhatsAppDirectoryGroupsFromConfig, w as listEnabledSlackAccounts, x as resolveDefaultTelegramAccountId } from "./plugins-BbAvhC25.js";
@@ -47,7 +47,7 @@ import "./paths-A0xdf3yk.js";
 import { h as onDiagnosticEvent, m as isDiagnosticsEnabled, p as emitDiagnosticEvent } from "./diagnostic-mFf4i4G9.js";
 import { n as extractOriginalFilename } from "./store-Do3t33-c.js";
 import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-BkCUbYGV.js";
-import { r as resolveWhatsAppHeartbeatRecipients } from "./channel-web-DTV6QoJV.js";
+import { r as resolveWhatsAppHeartbeatRecipients } from "./channel-web-xXTpy0N_.js";
 import "./image-k_W1USVr.js";
 import "./pi-model-discovery-LbcEa65a.js";
 import "./api-key-rotation-Qy7QGV8_.js";

package/dist/plugin-sdk/{reply-CzCsghFB.js → reply-EEvLfWgt.js}

@@ -26834,7 +26834,7 @@ async function runWithImageModelFallback(params) {
 function createDefaultDeps() {
 	return {
 		sendMessageWhatsApp: async (...args) => {
-			const { sendMessageWhatsApp } = await import("./web-BLcsH45O.js");
+			const { sendMessageWhatsApp } = await import("./web-COWtpMAH.js");
 			return await sendMessageWhatsApp(...args);
 		},
 		sendMessageTelegram: async (...args) => {
@@ -44457,7 +44457,7 @@ function loadWebLoginQr() {
 	return webLoginQrPromise;
 }
 function loadWebChannel() {
-	webChannelPromise ??= import("./web-BLcsH45O.js");
+	webChannelPromise ??= import("./web-COWtpMAH.js");
 	return webChannelPromise;
 }
 function loadWhatsAppActions() {
@@ -66219,6 +66219,152 @@ function subscribeEmbeddedPiSession(params) {
 	};
 }
 
+//#endregion
+//#region src/agents/plan-mode.ts
+/**
+* Plan Mode — automatic complexity detection and structured planning.
+*
+* When a user message is complex (multi-step, multi-file, refactoring, etc.),
+* Symi auto-enters plan mode: read-only investigation → structured plan →
+* user approval → context-cleared execution.
+*/
+const PLAN_KEYWORDS = new Set([
+	"investigate",
+	"refactor",
+	"migrate",
+	"redesign",
+	"set up",
+	"setup",
+	"build",
+	"implement",
+	"architect",
+	"overhaul",
+	"restructure",
+	"rewrite"
+]);
+const ANALYSIS_KEYWORDS = new Set([
+	"analyze",
+	"analyse",
+	"compare",
+	"audit",
+	"review",
+	"evaluate",
+	"assess"
+]);
+const SEQUENTIAL_MARKERS = [
+	/\bthen\b/i,
+	/\bafter that\b/i,
+	/\bonce .+ is done\b/i,
+	/\bnext,?\s/i,
+	/\bfollowed by\b/i,
+	/\bfinally\b/i
+];
+const NUMBERED_LIST_RE = /^\s*\d+[.)]\s/gm;
+const FILE_PATH_RE = /(?:\/[\w.-]+){2,}|[\w.-]+\.[a-z]{1,4}/g;
+/**
+* Score a user message for complexity.
+* Returns a numeric score; >= PLAN_MODE_THRESHOLD triggers plan mode.
+*/
+function scorePlanComplexity(prompt) {
+	let score = 0;
+	const lower = prompt.toLowerCase();
+	if (prompt.length > 500) {
+		if ([...PLAN_KEYWORDS, ...ANALYSIS_KEYWORDS].some((kw) => lower.includes(kw)) || FILE_PATH_RE.test(prompt)) score += 3;
+	}
+	const numberedItems = prompt.match(NUMBERED_LIST_RE);
+	if (numberedItems && numberedItems.length >= 3) score += 2;
+	for (const kw of PLAN_KEYWORDS) if (lower.includes(kw)) {
+		score += 2;
+		break;
+	}
+	for (const re of SEQUENTIAL_MARKERS) if (re.test(prompt)) {
+		score += 2;
+		break;
+	}
+	const filePaths = prompt.match(FILE_PATH_RE);
+	if (filePaths && new Set(filePaths).size >= 2) score += 1;
+	for (const kw of ANALYSIS_KEYWORDS) if (lower.includes(kw)) {
+		score += 1;
+		break;
+	}
+	return score;
+}
+const PLAN_MODE_THRESHOLD = 5;
+/**
+* Determine whether a prompt should trigger plan mode.
+*
+* Priority:
+* 1. /plan prefix → always
+* 2. /noplan prefix → never
+* 3. Subagent/cron sessions → never
+* 4. Heuristic scoring
+*/
+function shouldEnterPlanMode(prompt, opts = {}) {
+	const trimmed = prompt.trim();
+	if (/^\/plan\b/i.test(trimmed)) return {
+		enter: true,
+		reason: "explicit /plan directive",
+		score: 99,
+		stripped: trimmed.replace(/^\/plan\s*/i, "").trim()
+	};
+	if (/^\/noplan\b/i.test(trimmed)) return {
+		enter: false,
+		reason: "explicit /noplan directive",
+		score: 0,
+		stripped: trimmed.replace(/^\/noplan\s*/i, "").trim()
+	};
+	if (opts.isSubagent) return {
+		enter: false,
+		reason: "subagent session",
+		score: 0
+	};
+	if (opts.isCron) return {
+		enter: false,
+		reason: "cron session",
+		score: 0
+	};
+	const score = scorePlanComplexity(trimmed);
+	if (score >= PLAN_MODE_THRESHOLD) return {
+		enter: true,
+		reason: `complexity score ${score} >= ${PLAN_MODE_THRESHOLD}`,
+		score
+	};
+	return {
+		enter: false,
+		reason: `complexity score ${score} < ${PLAN_MODE_THRESHOLD}`,
+		score
+	};
+}
+const PLAN_MODE_SYSTEM_PROMPT = `<plan_mode>
+You have entered PLAN MODE because this task is complex.
+
+RULES:
+- DO NOT write, edit, or create any files yet
+- DO NOT execute destructive commands (rm, mv, git reset, etc.)
+- DO read files, search code, check runtime state
+- DO use memory_search, web_search, exec (read-only commands like ls, cat, git status, git log)
+- Produce a detailed step-by-step implementation plan
+
+OUTPUT FORMAT:
+1. **Summary** — what needs to be done and why
+2. **Investigation** — files read, code searched, state checked
+3. **Files to modify** — list every file that will be created, edited, or deleted
+4. **Implementation phases** — numbered steps with:
+   - What changes in each phase
+   - Which files are touched
+   - Dependencies on prior phases
+5. **Risks & considerations** — things that could go wrong, edge cases, rollback strategy
+
+After presenting the plan, ask the user to choose one of these options.
+Present these as inline buttons if the channel supports them:
+- **Proceed** — clear context and execute the plan
+- **Modify** — adjust the plan based on feedback
+- **Cancel** — abandon the plan
+
+Use the message tool with buttons:
+[{"label": "✅ Proceed", "data": "/plan-proceed"}, {"label": "✏️ Modify", "data": "/plan-modify"}, {"label": "❌ Cancel", "data": "/plan-cancel"}]
+</plan_mode>`;
+
 //#endregion
 //#region src/agents/pi-embedded-runner/abort.ts
 /**
@@ -67472,6 +67618,17 @@ async function runEmbeddedAttempt(params) {
 						log$2.debug(`auto-recall: skipped (${String(recallErr)})`);
 					}
 				}
+				{
+					const planResult = shouldEnterPlanMode(effectivePrompt, {
+						isSubagent: isSubagentSessionKey(params.sessionKey),
+						isCron: isCronSessionKey(params.sessionKey)
+					});
+					if (planResult.enter) {
+						if (planResult.stripped != null) effectivePrompt = planResult.stripped;
+						effectivePrompt = `${PLAN_MODE_SYSTEM_PROMPT}\n\n${effectivePrompt}`;
+						log$2.info(`plan-mode: activated (${planResult.reason}) for runId=${params.runId}`);
+					} else if (planResult.stripped != null) effectivePrompt = planResult.stripped;
+				}
 				log$2.debug(`embedded run prompt start: runId=${params.runId} sessionId=${params.sessionId}`);
 				cacheTrace?.recordStage("prompt:before", {
 					prompt: effectivePrompt,

package/dist/plugin-sdk/{web-BLcsH45O.js → web-COWtpMAH.js}

@@ -1,5 +1,5 @@
 import { a as WA_WEB_AUTH_DIR, g as webAuthExists, s as logWebSelfId, u as pickWebChannel } from "./accounts-D9zGZU5t.js";
-import "./reply-CzCsghFB.js";
+import "./reply-EEvLfWgt.js";
 import "./paths-DR2yt_mP.js";
 import "./github-copilot-token-D9X2phUj.js";
 import "./plugins-BbAvhC25.js";
@@ -45,7 +45,7 @@ import "./pi-embedded-helpers-Cs2-_EpL.js";
 import "./paths-A0xdf3yk.js";
 import "./diagnostic-mFf4i4G9.js";
 import "./store-Do3t33-c.js";
-import { n as monitorWebInbox, t as monitorWebChannel } from "./channel-web-DTV6QoJV.js";
+import { n as monitorWebInbox, t as monitorWebChannel } from "./channel-web-xXTpy0N_.js";
 import "./image-k_W1USVr.js";
 import "./pi-model-discovery-LbcEa65a.js";
 import "./api-key-rotation-Qy7QGV8_.js";

package/dist/{plugins-cli-BIHhue19.js → plugins-cli-BpuQ7Y9l.js}

@@ -13,7 +13,7 @@ import "./client-LeVQns9-.js";
 import "./call-BQiCOxB6.js";
 import "./message-channel-C9dERklz.js";
 import "./pairing-token-Byh6drgn.js";
-import "./subagent-registry-BH79W7i1.js";
+import "./subagent-registry-BR2Qhqjf.js";
 import "./sessions-DJAxaVI7.js";
 import "./tokens-Csntmwwn.js";
 import "./plugins-CwSlLxM8.js";
@@ -102,7 +102,7 @@ import "./npm-registry-spec-DkaZNHAW.js";
 import "./skill-scanner-BGWOBqLY.js";
 import { i as resolvePluginInstallDir, n as installPluginFromNpmSpec, r as installPluginFromPath, t as recordPluginInstall } from "./installs-CgQpVncj.js";
 import { t as renderTable } from "./table-D01d2GuY.js";
-import { t as buildPluginStatusReport } from "./status-B77mKduK.js";
+import { t as buildPluginStatusReport } from "./status-BTF6_aBO.js";
 import { n as updateNpmInstalledPlugins } from "./update-DEMKx4eC.js";
 import os from "node:os";
 import path from "node:path";

package/dist/{plugins-cli-DRDUAaBR.js → plugins-cli-C_S07pgO.js}

@@ -1,7 +1,7 @@
 import { g as resolveStateDir } from "./paths-Cqn-zk3M.js";
 import { B as theme, S as shortenHomePath, g as resolveConfigDir, x as shortenHomeInString, y as resolveUserPath } from "./utils-B-0b9bGM.js";
 import "./thinking-EAliFiVK.js";
-import "./reply-D_FZec1Q.js";
+import "./reply-B9o45s3E.js";
 import "./registry-Cja8eT7G.js";
 import { f as defaultRuntime } from "./subsystem-D9vIQve0.js";
 import "./exec-CWkblSrI.js";
@@ -106,7 +106,7 @@ import "./npm-registry-spec-C2JDdSZS.js";
 import "./skill-scanner-CLs8u6vQ.js";
 import { i as resolvePluginInstallDir, n as installPluginFromNpmSpec, r as installPluginFromPath, t as recordPluginInstall } from "./installs-C1Cebk97.js";
 import { t as renderTable } from "./table-BTgkRafz.js";
-import { t as buildPluginStatusReport } from "./status-Be3sgGJN.js";
+import { t as buildPluginStatusReport } from "./status-BytVj4kU.js";
 import { n as updateNpmInstalledPlugins } from "./update-rw7wJwHd.js";
 import fs from "node:fs";
 import os from "node:os";

package/dist/{program-BCEnYzi8.js → program-cO9YX6wL.js}

@@ -14,7 +14,7 @@ import "./client-LeVQns9-.js";
 import "./call-BQiCOxB6.js";
 import "./message-channel-C9dERklz.js";
 import "./pairing-token-Byh6drgn.js";
-import "./subagent-registry-BH79W7i1.js";
+import "./subagent-registry-BR2Qhqjf.js";
 import "./sessions-DJAxaVI7.js";
 import "./tokens-Csntmwwn.js";
 import "./plugins-CwSlLxM8.js";
@@ -99,13 +99,13 @@ import "./prompt-style-DwCXob2h.js";
 import "./pairing-labels-sIj1ZLt-.js";
 import "./pi-tools.policy-T6Z5F-_n.js";
 import "./catalog-DLQFKucJ.js";
-import "./plugin-registry-KUffgxdX.js";
-import { n as resolveCliChannelOptions } from "./channel-options-NbbM348A.js";
-import { t as getSubCliCommandsWithSubcommands } from "./register.subclis-BrOWQICr.js";
-import { a as registerProgramCommands, r as getCoreCliCommandsWithSubcommands } from "./command-registry-S2yEeoft.js";
+import "./plugin-registry-BAbkdLQ7.js";
+import { n as resolveCliChannelOptions } from "./channel-options-D74Jofp4.js";
+import { t as getSubCliCommandsWithSubcommands } from "./register.subclis-CqEj9vfW.js";
+import { a as registerProgramCommands, r as getCoreCliCommandsWithSubcommands } from "./command-registry-Cde2LqTh.js";
 import { r as setProgramContext } from "./program-context-CqzR_m-7.js";
 import { t as forceFreePort } from "./ports-Dn122MUd.js";
-import { n as formatCliBannerLine, r as hasEmittedCliBanner, t as emitCliBanner } from "./banner-CV_YEEQe.js";
+import { n as formatCliBannerLine, r as hasEmittedCliBanner, t as emitCliBanner } from "./banner-B-joBGLz.js";
 import { Command } from "commander";
 
 //#region src/cli/program/context.ts
@@ -213,7 +213,7 @@ function registerPreActionHooks(program, programVersion) {
 			commandPath
 		});
 		if (PLUGIN_REQUIRED_COMMANDS.has(commandPath[0])) {
-			const { ensurePluginRegistryLoaded } = await import("./plugin-registry-KUffgxdX.js").then((n) => n.n);
+			const { ensurePluginRegistryLoaded } = await import("./plugin-registry-BAbkdLQ7.js").then((n) => n.n);
 			ensurePluginRegistryLoaded();
 		}
 	});