@iinm/plain-agent 1.5.4 → 1.6.1

package/src/cliPasteTransform.mjs

@@ -0,0 +1,128 @@
+import { Transform } from "node:stream";
+
+// Bracketed paste mode sequences
+const BRACKETED_PASTE_START = "\x1b[200~";
+const BRACKETED_PASTE_END = "\x1b[201~";
+
+// Store for pasted content
+const pastedContentStore = new Map();
+
+/**
+ * Generate a short hash for paste reference
+ * @param {string} content
+ * @returns {string}
+ */
+function generatePasteHash(content) {
+  let hash = 0;
+  for (let i = 0; i < content.length; i++) {
+    const char = content.charCodeAt(i);
+    hash = (hash << 5) - hash + char;
+    hash = hash & hash; // Convert to 32bit integer
+  }
+  return Math.abs(hash).toString(16).padStart(6, "0").slice(0, 6);
+}
+
+/**
+ * Resolve paste placeholders and append context tags
+ * @param {string} input
+ * @returns {string}
+ */
+export function resolvePastePlaceholders(input) {
+  /** @type {string[]} */
+  const contexts = [];
+
+  // Collect paste content for context tags while keeping placeholders
+  const text = input.replace(/\[pasted#([a-f0-9]{6})\]/g, (match, hash) => {
+    const content = pastedContentStore.get(hash);
+    if (content !== undefined) {
+      pastedContentStore.delete(hash); // Clean up after use
+      contexts.push(
+        `<context location="pasted#${hash}">\n${content}\n</context>`,
+      );
+    }
+    return match; // Keep placeholder in text
+  });
+
+  // Append contexts to the end of input
+  if (contexts.length > 0) {
+    return [text, ...contexts].join("\n\n");
+  }
+
+  return text;
+}
+
+/**
+ * Create a Transform stream to handle bracketed paste before readline.
+ * @param {() => void} onExitRequest - Called when Ctrl-C or Ctrl-D is detected
+ * @returns {Transform}
+ */
+export function createPasteTransform(onExitRequest) {
+  let inPasteMode = false;
+  let pasteBuffer = "";
+
+  return new Transform({
+    transform(chunk, _encoding, callback) {
+      /** @type {string} */
+      let data = chunk.toString("utf8");
+
+      // Handle Ctrl-C and Ctrl-D
+      if (data.includes("\x03") || data.includes("\x04")) {
+        // Ctrl-C / Ctrl-D: request exit (handled by confirmExit)
+        onExitRequest();
+        callback();
+        return;
+      }
+
+      while (data.length > 0) {
+        if (inPasteMode) {
+          const endIdx = data.indexOf(BRACKETED_PASTE_END);
+          if (endIdx !== -1) {
+            // End of paste
+            pasteBuffer += data.slice(0, endIdx);
+            data = data.slice(endIdx + BRACKETED_PASTE_END.length);
+            inPasteMode = false;
+
+            // Handle paste content
+            if (pasteBuffer) {
+              // Remove trailing newline for single-line paste detection
+              const trimmedPaste = pasteBuffer.replace(/\n$/, "");
+
+              // For single-line paste, insert directly without placeholder
+              if (!trimmedPaste.includes("\n")) {
+                this.push(trimmedPaste);
+              } else {
+                // For multi-line paste, use placeholder
+                const hash = generatePasteHash(pasteBuffer);
+                pastedContentStore.set(hash, pasteBuffer);
+                this.push(`[pasted#${hash}] `);
+              }
+            }
+            pasteBuffer = "";
+          } else {
+            // Still in paste mode
+            pasteBuffer += data;
+            break;
+          }
+        } else {
+          const startIdx = data.indexOf(BRACKETED_PASTE_START);
+          if (startIdx !== -1) {
+            // Start of paste
+            // Output any data before the paste
+            if (startIdx > 0) {
+              this.push(data.slice(0, startIdx));
+            }
+            data = data.slice(startIdx + BRACKETED_PASTE_START.length);
+            inPasteMode = true;
+            pasteBuffer = "";
+          } else {
+            // Normal data
+            this.push(data);
+            break;
+          }
+        }
+      }
+
+      callback();
+    },
+  });
+}

package/src/context/loadAgentRoles.mjs

@@ -17,6 +17,7 @@ import {
  * @property {string} description
  * @property {string} content
  * @property {string} filePath
+ * @property {boolean} claudeOriginated
  * @property {string} [import]
  */
 
@@ -224,6 +225,7 @@ async function getMarkdownFiles(dir, baseDir = dir) {
 function parseAgentRole(relativePath, fileContent, fullPath, idPrefix = "") {
   const rawId = relativePath.replace(/\.md$/, "");
   const id = idPrefix + rawId;
+  const claudeOriginated = idPrefix.startsWith("claude");
 
   // Match YAML frontmatter
   const match = fileContent.match(
@@ -236,6 +238,7 @@ function parseAgentRole(relativePath, fileContent, fullPath, idPrefix = "") {
       description: "",
       content: fileContent.trim(),
       filePath: fullPath,
+      claudeOriginated,
     };
   }
 
@@ -251,6 +254,7 @@ function parseAgentRole(relativePath, fileContent, fullPath, idPrefix = "") {
       description: parseFrontmatterField(match[1], "description") ?? "",
       content: fileContent.trim(),
       filePath: fullPath,
+      claudeOriginated,
     };
   }
   const content = match[2].trim();
@@ -260,6 +264,7 @@ function parseAgentRole(relativePath, fileContent, fullPath, idPrefix = "") {
     description: frontmatter.description ?? "",
     content,
     filePath: fullPath,
+    claudeOriginated,
     import: frontmatter.import,
   };
 }

package/src/context/loadPrompts.mjs

@@ -18,6 +18,7 @@ import {
  * @property {string} description
  * @property {string} content
  * @property {string} filePath
+ * @property {boolean} claudeOriginated
  * @property {string} [import]
  * @property {boolean} [userInvocable]
  * @property {boolean} [isShortcut]
@@ -252,6 +253,7 @@ function parsePrompt(relativePath, fileContent, fullPath, idPrefix = "") {
   const id = isShortcut
     ? idPrefix + rawId.replace(/^shortcuts\//, "")
     : idPrefix + rawId;
+  const claudeOriginated = idPrefix.startsWith("claude");
 
   // Match YAML frontmatter
   const match = fileContent.match(
@@ -264,6 +266,7 @@ function parsePrompt(relativePath, fileContent, fullPath, idPrefix = "") {
       description: "",
       content: fileContent.trim(),
       filePath: fullPath,
+      claudeOriginated,
       isShortcut,
       isSkill,
     };
@@ -284,6 +287,7 @@ function parsePrompt(relativePath, fileContent, fullPath, idPrefix = "") {
       description: parseFrontmatterField(match[1], "description") ?? "",
       content,
       filePath: fullPath,
+      claudeOriginated,
       import: parseFrontmatterField(match[1], "import"),
       userInvocable:
         parseFrontmatterField(match[1], "user-invocable") === "true" ||
@@ -299,6 +303,7 @@ function parsePrompt(relativePath, fileContent, fullPath, idPrefix = "") {
     description: frontmatter.description ?? "",
     content,
     filePath: fullPath,
+    claudeOriginated,
     import: frontmatter.import,
     userInvocable: userInvocable ?? undefined,
     isShortcut,

package/src/prompt.mjs

@@ -112,12 +112,6 @@ If skill matches task: read full file and apply the workflow
 
 ${skillDescriptions}
 
-# Claude Code Compatibility Notes
-
-When using a Claude Code-compatible command, agent, or skill, follow these rules:
-- Subagents cannot run in parallel. Delegate to them one at a time.
-- If a Claude Code prompt mentions CLAUDE.md for project rules or conventions, use AGENTS.md instead when CLAUDE.md is absent.
-
 # Environment
 
 - User name: ${username}
@@ -132,3 +126,10 @@ ${agentRoleDescriptions}
 - custom:<role-name>: Use this for ad-hoc roles not listed above (e.g., custom:explore, custom:plan).
 `.trim();
 }
+
+export const CLAUDE_CODE_COMPATIBILITY_NOTES = `# Environment Constraints
+
+- Use memory file to manage todo list.
+- Subagents cannot run in parallel. Delegate to them one at a time.
+- Use AGENTS.md instead when CLAUDE.md is absent.
+- If instructed to use "haiku agent", "sonnet agent", or "opus agent", use "worker" instead.`;

package/src/subagent.mjs

@@ -7,6 +7,7 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import { AGENT_PROJECT_METADATA_DIR } from "./env.mjs";
+import { CLAUDE_CODE_COMPATIBILITY_NOTES } from "./prompt.mjs";
 import { reportAsSubagentToolName } from "./tools/reportAsSubagent.mjs";
 
 /** @typedef {ReturnType<typeof createSubagentManager>} SubagentManager */
@@ -73,7 +74,9 @@ export function createSubagentManager(agentRoles, handlers) {
           error: `Agent role "${name}" not found. Available agent roles:\n${availableRoles}\n\nTo use an ad-hoc role, prefix the name with "custom:" (e.g., "custom:researcher").`,
         };
       }
-      roleContent = role.content;
+      roleContent = role.claudeOriginated
+        ? `${role.content}\n\n---\n\n${CLAUDE_CODE_COMPATIBILITY_NOTES}`
+        : role.content;
     }
 
     subagents.push({