@plannotator/opencode 0.28.38 → 0.28.39

package/dist/index.js

@@ -12348,6 +12348,11 @@ import { readFile } from "node:fs/promises";
 import path5 from "node:path";
 import { fileURLToPath as fileURLToPath2, pathToFileURL } from "node:url";
 
+// ../../packages/shared/child-env.ts
+function isAskAiChild(env = process.env) {
+  return env.PLANNOTATOR_ASK_AI_CHILD === "1";
+}
+
 // ../../packages/shared/config.ts
 import { join as join2 } from "path";
 
@@ -12510,7 +12515,7 @@ var INBOX_TOOL_ACTIONS = [
 ];
 var INBOX_FILLED_ARGUMENTS = ["project_path", "agent_session", "agent_host", "agent_name"];
 var INBOX_AGENT_PROJECT_PATH = "project_path";
-var INBOX_AGENT_PROJECT_PATH_DESCRIPTION = "The repository or folder this is about; defaults to your working folder.";
+var INBOX_AGENT_PROJECT_PATH_DESCRIPTION = "The repository or folder this is about; defaults to the folder your session started in. Pass it only when the message is about another repository or folder.";
 function inboxProjectPathShapeRefusal(value) {
   if (typeof value !== "string" || value.trim() === "")
     return "project_path: a folder path (absolute, or relative to your working folder).";
@@ -12521,8 +12526,13 @@ function inboxProjectPathShapeRefusal(value) {
   return null;
 }
 var INBOX_WAKES_META_KEY = "ai.plannotator/inbox-wakes";
+var INBOX_WORKING_FOLDER_META_KEY = "ai.plannotator/working-folder";
 function inboxToolCallParams(call, options) {
-  return { name: call.name, arguments: call.arguments, ...options.wakes ? { _meta: { [INBOX_WAKES_META_KEY]: true } } : {} };
+  const meta = {
+    ...options.wakes ? { [INBOX_WAKES_META_KEY]: true } : {},
+    ...options.workingFolder ? { [INBOX_WORKING_FOLDER_META_KEY]: options.workingFolder } : {}
+  };
+  return { name: call.name, arguments: call.arguments, ...Object.keys(meta).length > 0 ? { _meta: meta } : {} };
 }
 var INBOX_REPLY_TO_CHECK = "Before reply_to into a thread you have not read in this context window, call read_thread with no id and match the subject.";
 var INBOX_REF_LINK_RULE = "A bare #123 links to this project's repository. For an issue or PR in another repo, write owner/repo#123 or its full URL (in a GitLab project, a GitHub one needs its URL).";
@@ -12618,12 +12628,13 @@ function leadOf(description) {
 var INBOX_CHANNEL_RULE = "A decision in the Inbox stays there: when the person writes in the chat, say what waits and link its thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar). Ask in the chat only about something new they raised there that needs no pictures or files, or when they ask.";
 var INBOX_SESSION_THREADS_CHANNEL = "Their decisions stay in these threads: when the person writes in the chat, say what waits and link the thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar).";
 var INBOX_USE_RULE = "Use it for a decision only they can make (a :::question block; go on with other work), finished long work (a short summary, files in `attachments`), or when they ask.";
+var INBOX_THREAD_RULE = "One thread per work stream, unless the person says otherwise.";
 var INBOX_FOLLOW_THROUGH_RULE = "Be proactive about Inbox updates and about replying to the person through the Inbox when you think they would want you to. Don't withhold important updates or decisions, and don't batch updates to send later: proactivity is better than procrastination.";
 var INBOX_SUBAGENT_RULE = "If another agent started you, report to it instead.";
-var INBOX_AGENT_RULES = `${INBOX_USE_RULE} ${INBOX_CHANNEL_RULE} ${INBOX_FOLLOW_THROUGH_RULE} ${INBOX_SUBAGENT_RULE}`;
-var INBOX_TOOL_LEAD = `The Plannotator Inbox on this machine: message the person and get their answer later, without blocking this session. ${INBOX_AGENT_RULES} Set \`action\` to a tool below, with its fields.`;
+var INBOX_AGENT_RULES = `${INBOX_USE_RULE} ${INBOX_THREAD_RULE} ${INBOX_CHANNEL_RULE} ${INBOX_FOLLOW_THROUGH_RULE} ${INBOX_SUBAGENT_RULE}`;
+var INBOX_TOOL_LEAD = `The Plannotator Inbox on this machine: message the person, get their answer later; nothing blocks. ${INBOX_AGENT_RULES} Set \`action\` to a tool below, with its fields.`;
 var INBOX_TOOL_WAKE_NOTE = "A reply arrives in this session by itself once it is idle, headed `Plannotator Inbox: <subject> (<reply id>)`: end your turn or keep working; do not call wait_for_reply. To answer it, send_message with reply_to set to that reply id, never one from memory.";
-var INBOX_TOOL_HELP_NOTE = "Every field and the full question syntax: `plannotator inbox --help`.";
+var INBOX_TOOL_HELP_NOTE = "Every field and question syntax: `plannotator inbox --help`.";
 var INBOX_TOOL_BOARD_OFF_NOTE = "The Board (cards for work that outlasts a reply) is off until the person turns it on; see `plannotator card --help`.";
 var INBOX_AGENT_ACTION_LEADS = {
   send_message: "Message the person (markdown), in your session's open thread (see `thread`).",
@@ -12631,7 +12642,7 @@ var INBOX_AGENT_ACTION_LEADS = {
   resolve_message: "Archive a message's thread, only when nothing in it is left for the person to read or answer.",
   read_thread: 'Read a thread (thread_id); with no id, list your threads (asked_by "anyone": all).',
   search: "Find messages by words, older ones too (read-only).",
-  get_guide_brief: "How to write a guided review: method, JSON shape, rules, a worked submit_guide call.",
+  get_guide_brief: "How to write a guided review, with a worked submit_guide call.",
   card: "A Board card for work that outlasts this reply: create it, then move it and say where it is as the work moves."
 };
 var INBOX_AGENT_FIELD_DESCRIPTIONS = {
@@ -12676,8 +12687,8 @@ var INBOX_AGENT_FIELD_DESCRIPTIONS = {
     snapshot: "Instead of guide and patch: a complete Plannotator guide snapshot, as an object or its JSON."
   }
 };
-var INBOX_REMINDER_TEXT = `Plannotator Inbox is on: when you finish long work, or need a decision only the person can make, send it with plannotator_inbox send_message and keep going. ${INBOX_FOLLOW_THROUGH_RULE} Their reply comes back here. A decision in the Inbox stays there: when the person writes here, say what waits and link its thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar). Run \`plannotator inbox --help\` for how it works.`;
-var INBOX_REMINDER_TEXT_NO_WAKE = `Plannotator Inbox is on: when you finish long work, or need a decision only the person can make, send it with plannotator_inbox send_message and keep going. ${INBOX_FOLLOW_THROUGH_RULE} Call wait_for_reply when you need their answer. A decision in the Inbox stays there: when the person writes here, say what waits and link its thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar). Run \`plannotator inbox --help\` for how it works.`;
+var INBOX_REMINDER_TEXT = `Plannotator Inbox is on: when you finish long work, or need a decision only the person can make, send it with plannotator_inbox send_message and keep going. ${INBOX_FOLLOW_THROUGH_RULE} ${INBOX_THREAD_RULE} Their reply comes back here. A decision in the Inbox stays there: when the person writes here, say what waits and link its thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar). Run \`plannotator inbox --help\` for how it works.`;
+var INBOX_REMINDER_TEXT_NO_WAKE = `Plannotator Inbox is on: when you finish long work, or need a decision only the person can make, send it with plannotator_inbox send_message and keep going. ${INBOX_FOLLOW_THROUGH_RULE} ${INBOX_THREAD_RULE} Call wait_for_reply when you need their answer. A decision in the Inbox stays there: when the person writes here, say what waits and link its thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar). Run \`plannotator inbox --help\` for how it works.`;
 function inboxReminderText(toolName = INBOX_TOOL_NAME, options = {}) {
   const text = options.wakes === false ? INBOX_REMINDER_TEXT_NO_WAKE : INBOX_REMINDER_TEXT;
   return text.replace(INBOX_TOOL_NAME, toolName);
@@ -12688,6 +12699,7 @@ var INBOX_COMMAND_BRIEFING = [
   "The person opened their Plannotator Inbox with /plannotator-inbox and has its address. The Plannotator Inbox is one window on this computer where you leave the person messages, `:::question` blocks they answer with a click, and files. They answer when they can. Nothing blocks: you send, then keep working or end your turn.",
   "",
   `- ${INBOX_USE_RULE}`,
+  `- ${INBOX_THREAD_RULE}`,
   "- Send with a `plannotator_inbox` tool when you have one (it can be listed with a prefix and may need loading through tool search first): `action` `send_message`, with a markdown `body`. Otherwise call `send_message` on the Inbox's MCP server, `plannotator inbox mcp`.",
   "- send_message's result says whether the person's reply arrives in this session by itself. When it does, do not wait or poll for it: end your turn or go on with other work. When it does not, call wait_for_reply when you need the answer.",
   `- ${INBOX_CHANNEL_RULE}`,
@@ -16490,6 +16502,8 @@ async function runPlanReview(input) {
   });
 }
 var PlannotatorPlugin = async (ctx, rawOptions) => {
+  if (isAskAiChild(process.env))
+    return {};
   const workflowOptions = normalizeWorkflowOptions(rawOptions);
   preloadBundledHtml("plannotator.html", (html) => {
     _planHtml = html;

package/dist/server.js

@@ -3,6 +3,11 @@ import { existsSync as existsSync9, readFileSync as readFileSync7 } from "node:f
 import path6 from "node:path";
 import { fileURLToPath as fileURLToPath2, pathToFileURL } from "node:url";
 
+// ../../packages/shared/child-env.ts
+function isAskAiChild(env = process.env) {
+  return env.PLANNOTATOR_ASK_AI_CHILD === "1";
+}
+
 // ../../packages/shared/config.ts
 import { join as join2 } from "path";
 
@@ -165,7 +170,7 @@ var INBOX_TOOL_ACTIONS = [
 ];
 var INBOX_FILLED_ARGUMENTS = ["project_path", "agent_session", "agent_host", "agent_name"];
 var INBOX_AGENT_PROJECT_PATH = "project_path";
-var INBOX_AGENT_PROJECT_PATH_DESCRIPTION = "The repository or folder this is about; defaults to your working folder.";
+var INBOX_AGENT_PROJECT_PATH_DESCRIPTION = "The repository or folder this is about; defaults to the folder your session started in. Pass it only when the message is about another repository or folder.";
 function inboxProjectPathShapeRefusal(value) {
   if (typeof value !== "string" || value.trim() === "")
     return "project_path: a folder path (absolute, or relative to your working folder).";
@@ -176,8 +181,13 @@ function inboxProjectPathShapeRefusal(value) {
   return null;
 }
 var INBOX_WAKES_META_KEY = "ai.plannotator/inbox-wakes";
+var INBOX_WORKING_FOLDER_META_KEY = "ai.plannotator/working-folder";
 function inboxToolCallParams(call, options) {
-  return { name: call.name, arguments: call.arguments, ...options.wakes ? { _meta: { [INBOX_WAKES_META_KEY]: true } } : {} };
+  const meta = {
+    ...options.wakes ? { [INBOX_WAKES_META_KEY]: true } : {},
+    ...options.workingFolder ? { [INBOX_WORKING_FOLDER_META_KEY]: options.workingFolder } : {}
+  };
+  return { name: call.name, arguments: call.arguments, ...Object.keys(meta).length > 0 ? { _meta: meta } : {} };
 }
 var INBOX_REPLY_TO_CHECK = "Before reply_to into a thread you have not read in this context window, call read_thread with no id and match the subject.";
 var INBOX_REF_LINK_RULE = "A bare #123 links to this project's repository. For an issue or PR in another repo, write owner/repo#123 or its full URL (in a GitLab project, a GitHub one needs its URL).";
@@ -275,12 +285,13 @@ function leadOf(description) {
 var INBOX_CHANNEL_RULE = "A decision in the Inbox stays there: when the person writes in the chat, say what waits and link its thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar). Ask in the chat only about something new they raised there that needs no pictures or files, or when they ask.";
 var INBOX_SESSION_THREADS_CHANNEL = "Their decisions stay in these threads: when the person writes in the chat, say what waits and link the thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar).";
 var INBOX_USE_RULE = "Use it for a decision only they can make (a :::question block; go on with other work), finished long work (a short summary, files in `attachments`), or when they ask.";
+var INBOX_THREAD_RULE = "One thread per work stream, unless the person says otherwise.";
 var INBOX_FOLLOW_THROUGH_RULE = "Be proactive about Inbox updates and about replying to the person through the Inbox when you think they would want you to. Don't withhold important updates or decisions, and don't batch updates to send later: proactivity is better than procrastination.";
 var INBOX_SUBAGENT_RULE = "If another agent started you, report to it instead.";
-var INBOX_AGENT_RULES = `${INBOX_USE_RULE} ${INBOX_CHANNEL_RULE} ${INBOX_FOLLOW_THROUGH_RULE} ${INBOX_SUBAGENT_RULE}`;
-var INBOX_TOOL_LEAD = `The Plannotator Inbox on this machine: message the person and get their answer later, without blocking this session. ${INBOX_AGENT_RULES} Set \`action\` to a tool below, with its fields.`;
+var INBOX_AGENT_RULES = `${INBOX_USE_RULE} ${INBOX_THREAD_RULE} ${INBOX_CHANNEL_RULE} ${INBOX_FOLLOW_THROUGH_RULE} ${INBOX_SUBAGENT_RULE}`;
+var INBOX_TOOL_LEAD = `The Plannotator Inbox on this machine: message the person, get their answer later; nothing blocks. ${INBOX_AGENT_RULES} Set \`action\` to a tool below, with its fields.`;
 var INBOX_TOOL_WAKE_NOTE = "A reply arrives in this session by itself once it is idle, headed `Plannotator Inbox: <subject> (<reply id>)`: end your turn or keep working; do not call wait_for_reply. To answer it, send_message with reply_to set to that reply id, never one from memory.";
-var INBOX_TOOL_HELP_NOTE = "Every field and the full question syntax: `plannotator inbox --help`.";
+var INBOX_TOOL_HELP_NOTE = "Every field and question syntax: `plannotator inbox --help`.";
 var INBOX_TOOL_BOARD_OFF_NOTE = "The Board (cards for work that outlasts a reply) is off until the person turns it on; see `plannotator card --help`.";
 var INBOX_AGENT_ACTION_LEADS = {
   send_message: "Message the person (markdown), in your session's open thread (see `thread`).",
@@ -288,7 +299,7 @@ var INBOX_AGENT_ACTION_LEADS = {
   resolve_message: "Archive a message's thread, only when nothing in it is left for the person to read or answer.",
   read_thread: 'Read a thread (thread_id); with no id, list your threads (asked_by "anyone": all).',
   search: "Find messages by words, older ones too (read-only).",
-  get_guide_brief: "How to write a guided review: method, JSON shape, rules, a worked submit_guide call.",
+  get_guide_brief: "How to write a guided review, with a worked submit_guide call.",
   card: "A Board card for work that outlasts this reply: create it, then move it and say where it is as the work moves."
 };
 var INBOX_AGENT_FIELD_DESCRIPTIONS = {
@@ -333,8 +344,8 @@ var INBOX_AGENT_FIELD_DESCRIPTIONS = {
     snapshot: "Instead of guide and patch: a complete Plannotator guide snapshot, as an object or its JSON."
   }
 };
-var INBOX_REMINDER_TEXT = `Plannotator Inbox is on: when you finish long work, or need a decision only the person can make, send it with plannotator_inbox send_message and keep going. ${INBOX_FOLLOW_THROUGH_RULE} Their reply comes back here. A decision in the Inbox stays there: when the person writes here, say what waits and link its thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar). Run \`plannotator inbox --help\` for how it works.`;
-var INBOX_REMINDER_TEXT_NO_WAKE = `Plannotator Inbox is on: when you finish long work, or need a decision only the person can make, send it with plannotator_inbox send_message and keep going. ${INBOX_FOLLOW_THROUGH_RULE} Call wait_for_reply when you need their answer. A decision in the Inbox stays there: when the person writes here, say what waits and link its thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar). Run \`plannotator inbox --help\` for how it works.`;
+var INBOX_REMINDER_TEXT = `Plannotator Inbox is on: when you finish long work, or need a decision only the person can make, send it with plannotator_inbox send_message and keep going. ${INBOX_FOLLOW_THROUGH_RULE} ${INBOX_THREAD_RULE} Their reply comes back here. A decision in the Inbox stays there: when the person writes here, say what waits and link its thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar). Run \`plannotator inbox --help\` for how it works.`;
+var INBOX_REMINDER_TEXT_NO_WAKE = `Plannotator Inbox is on: when you finish long work, or need a decision only the person can make, send it with plannotator_inbox send_message and keep going. ${INBOX_FOLLOW_THROUGH_RULE} ${INBOX_THREAD_RULE} Call wait_for_reply when you need their answer. A decision in the Inbox stays there: when the person writes here, say what waits and link its thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar). Run \`plannotator inbox --help\` for how it works.`;
 function inboxReminderText(toolName = INBOX_TOOL_NAME, options = {}) {
   const text = options.wakes === false ? INBOX_REMINDER_TEXT_NO_WAKE : INBOX_REMINDER_TEXT;
   return text.replace(INBOX_TOOL_NAME, toolName);
@@ -345,6 +356,7 @@ var INBOX_COMMAND_BRIEFING = [
   "The person opened their Plannotator Inbox with /plannotator-inbox and has its address. The Plannotator Inbox is one window on this computer where you leave the person messages, `:::question` blocks they answer with a click, and files. They answer when they can. Nothing blocks: you send, then keep working or end your turn.",
   "",
   `- ${INBOX_USE_RULE}`,
+  `- ${INBOX_THREAD_RULE}`,
   "- Send with a `plannotator_inbox` tool when you have one (it can be listed with a prefix and may need loading through tool search first): `action` `send_message`, with a markdown `body`. Otherwise call `send_message` on the Inbox's MCP server, `plannotator inbox mcp`.",
   "- send_message's result says whether the person's reply arrives in this session by itself. When it does, do not wait or poll for it: end your turn or go on with other work. When it does not, call wait_for_reply when you need the answer.",
   `- ${INBOX_CHANNEL_RULE}`,
@@ -6370,6 +6382,8 @@ var planHtml;
 var serverPlugin = {
   id: "plannotator",
   setup: async (ctx) => {
+    if (isAskAiChild(process.env))
+      return;
     const lifetime = new AbortController;
     const cleanup = () => {
       lifetime.abort();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plannotator/opencode",
-  "version": "0.28.38",
+  "version": "0.28.39",
   "type": "module",
   "description": "Plannotator plugin for OpenCode - interactive plan review with visual annotation",
   "author": "backnotprop",
@@ -50,7 +50,7 @@
     "@opencode-ai/plugin": "1.19.3",
     "@opencode/plugin": "2.0.32",
     "@plannotator/ai": "0.0.1",
-    "@plannotator/server": "0.28.38",
+    "@plannotator/server": "0.28.39",
     "@plannotator/shared": "0.0.1"
   },
   "engines": {