pi-harness-runtime 0.10.27 → 0.10.43

package/packages/clipboard-plugin/dist/index.js

@@ -0,0 +1,64 @@
+/**
+ * Clipboard Bridge Plugin — Main Entry
+ *
+ * Provides clipboard bridge functionality as a pi plugin.
+ * Integrates paste-from-bridge and paste shortcut registration.
+ */
+import { pasteFromBridge, registerPasteShortcut } from "@pi/clipboard";
+/**
+ * Create a clipboard bridge tool plugin.
+ * Provides paste-from-bridge functionality.
+ */
+export function createClipboardBridgeTool() {
+    return {
+        capability: "tool",
+        name: "Clipboard Bridge",
+        tools: [
+            {
+                name: "paste-from-bridge",
+                description: "Read content from the clipboard bridge file (~/.herdr-clipboard)",
+                parameters: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+                execute: async () => {
+                    const content = pasteFromBridge();
+                    return { content };
+                },
+            },
+        ],
+        config: {},
+    };
+}
+/**
+ * Create a clipboard bridge framework extension.
+ * For framework detection compatibility.
+ */
+export function createClipboardBridgePlugin() {
+    return {
+        capability: "framework",
+        name: "Clipboard Bridge Plugin",
+        detector: {
+            detect: async () => {
+                // This plugin doesn't detect frameworks, it's a utility plugin
+                return false;
+            },
+            signals: [],
+        },
+        config: {},
+    };
+}
+/**
+ * Register the paste shortcut with pi runtime.
+ * Call this during plugin activation.
+ */
+export function registerPasteShortcutHandler(pi, Key) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    registerPasteShortcut(pi, Key);
+}
+/**
+ * Default plugin export.
+ */
+export default createClipboardBridgeTool;
+//# sourceMappingURL=index.js.map

package/packages/clipboard-plugin/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAIvE;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACxC,OAAO;QACN,UAAU,EAAE,MAAM;QAClB,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE;YACN;gBACC,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EAAE,kEAAkE;gBAC/E,UAAU,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;oBACd,QAAQ,EAAE,EAAE;iBACZ;gBACD,OAAO,EAAE,KAAK,IAAI,EAAE;oBACnB,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;oBAClC,OAAO,EAAE,OAAO,EAAE,CAAC;gBACpB,CAAC;aACD;SACD;QACD,MAAM,EAAE,EAAE;KACV,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IAC1C,OAAO;QACN,UAAU,EAAE,WAAW;QACvB,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE;YACT,MAAM,EAAE,KAAK,IAAI,EAAE;gBAClB,+DAA+D;gBAC/D,OAAO,KAAK,CAAC;YACd,CAAC;YACD,OAAO,EAAE,EAAE;SACX;QACD,MAAM,EAAE,EAAE;KACV,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC3C,EAAW,EACX,GAAY;IAEZ,8DAA8D;IAC9D,qBAAqB,CAAC,EAAS,EAAE,GAAU,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,eAAe,yBAAyB,CAAC"}

package/packages/clipboard-plugin/dist/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Clipboard Bridge Plugin — Types
+ */
+import type { ToolExtension } from "@pi/framework-plugin-sdk";
+export interface ClipboardBridgeConfig {
+    /** Enable the paste shortcut (default: true) */
+    enablePasteShortcut?: boolean;
+    /** Bridge file path (default: ~/.herdr-clipboard) */
+    bridgePath?: string;
+    /** Auto-sync to clipboard (default: true) */
+    autoSync?: boolean;
+}
+export interface ClipboardBridgeTool extends ToolExtension {
+    capability: "tool";
+    name: "Clipboard Bridge";
+    tools: {
+        name: "paste-from-bridge";
+        description: "Read content from the clipboard bridge file and return it";
+        parameters: {
+            type: "object";
+            properties: {};
+            required: [];
+        };
+        execute: () => Promise<{
+            content: string | null;
+        }>;
+    }[];
+    config: ClipboardBridgeConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/clipboard-plugin/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACrC,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE;QACN,IAAI,EAAE,mBAAmB,CAAC;QAC1B,WAAW,EAAE,2DAA2D,CAAC;QACzE,UAAU,EAAE;YACX,IAAI,EAAE,QAAQ,CAAC;YACf,UAAU,EAAE,EAAE,CAAC;YACf,QAAQ,EAAE,EAAE,CAAC;SACb,CAAC;QACF,OAAO,EAAE,MAAM,OAAO,CAAC;YAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC,CAAC;KACnD,EAAE,CAAC;IACJ,MAAM,EAAE,qBAAqB,CAAC;CAC9B"}

package/packages/clipboard-plugin/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Clipboard Bridge Plugin — Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/clipboard-plugin/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/packages/clipboard-plugin/src/index.ts

@@ -0,0 +1,74 @@
+/**
+ * Clipboard Bridge Plugin — Main Entry
+ *
+ * Provides clipboard bridge functionality as a pi plugin.
+ * Integrates paste-from-bridge and paste shortcut registration.
+ */
+
+import type { FrameworkExtension, ToolExtension } from "@pi/framework-plugin-sdk";
+import { pasteFromBridge, registerPasteShortcut } from "@pi/clipboard";
+
+export type { ClipboardBridgeConfig } from "./types.js";
+
+/**
+ * Create a clipboard bridge tool plugin.
+ * Provides paste-from-bridge functionality.
+ */
+export function createClipboardBridgeTool(): ToolExtension {
+	return {
+		capability: "tool",
+		name: "Clipboard Bridge",
+		tools: [
+			{
+				name: "paste-from-bridge",
+				description: "Read content from the clipboard bridge file (~/.herdr-clipboard)",
+				parameters: {
+					type: "object",
+					properties: {},
+					required: [],
+				},
+				execute: async () => {
+					const content = pasteFromBridge();
+					return { content };
+				},
+			},
+		],
+		config: {},
+	};
+}
+
+/**
+ * Create a clipboard bridge framework extension.
+ * For framework detection compatibility.
+ */
+export function createClipboardBridgePlugin(): FrameworkExtension {
+	return {
+		capability: "framework",
+		name: "Clipboard Bridge Plugin",
+		detector: {
+			detect: async () => {
+				// This plugin doesn't detect frameworks, it's a utility plugin
+				return false;
+			},
+			signals: [],
+		},
+		config: {},
+	};
+}
+
+/**
+ * Register the paste shortcut with pi runtime.
+ * Call this during plugin activation.
+ */
+export function registerPasteShortcutHandler(
+	pi: unknown,
+	Key: unknown,
+): void {
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	registerPasteShortcut(pi as any, Key as any);
+}
+
+/**
+ * Default plugin export.
+ */
+export default createClipboardBridgeTool;

package/packages/clipboard-plugin/src/types.ts

@@ -0,0 +1,30 @@
+/**
+ * Clipboard Bridge Plugin — Types
+ */
+
+import type { ToolExtension } from "@pi/framework-plugin-sdk";
+
+export interface ClipboardBridgeConfig {
+	/** Enable the paste shortcut (default: true) */
+	enablePasteShortcut?: boolean;
+	/** Bridge file path (default: ~/.herdr-clipboard) */
+	bridgePath?: string;
+	/** Auto-sync to clipboard (default: true) */
+	autoSync?: boolean;
+}
+
+export interface ClipboardBridgeTool extends ToolExtension {
+	capability: "tool";
+	name: "Clipboard Bridge";
+	tools: {
+		name: "paste-from-bridge";
+		description: "Read content from the clipboard bridge file and return it";
+		parameters: {
+			type: "object";
+			properties: {};
+			required: [];
+		};
+		execute: () => Promise<{ content: string | null }>;
+	}[];
+	config: ClipboardBridgeConfig;
+}

package/packages/file-copy-helper/dist/src/extension.js

@@ -1,39 +1,92 @@
-// packages/file-copy-helper/src/extension.ts
-var COPY_KEYWORDS = [
-  "mimic",
-  "copy from",
-  "copy to",
-  "clone from",
-  "clone to",
-  "replicate",
-  "port from",
-  "migrate from",
-  "bring from",
-  "move from"
+// src/extension.ts
+var COPY_KEYWORDS = ["mimic", "replicate", "clone"];
+var COPY_DEST_CONTEXT = ["to ", "into ", "/dest/", "/target/", "over to"];
+var COPY_SOURCE_CONTEXT = ["from ", "source", "/source/", "orig"];
+var IMPORT_ERROR_TRIGGERS = [
+  "import error",
+  "import errors",
+  "cannot find module",
+  "cannot resolve",
+  "module not found",
+  "missing import",
+  "missing file",
+  "does not exist",
+  "@repo/",
+  "error one by one",
+  "fix errors one by one",
+  "fix imports one by one",
+  "roll back"
 ];
 var COPY_RULE = `
-## File Copy Rule (CRITICAL)
+## COPY FILES DIRECTLY (CRITICAL)
 
-When copying files between folders, ALWAYS use \`cp\` or \`sudo cp\` instead of writing from scratch:
+When asked to mimic, copy, clone, or replicate files:
 
-\`\`\`bash
-# Direct copy (if you have permission)
-cp /path/to/source/file.ts /path/to/dest/file.ts
+1. **DO NOT read the source files** - just copy them directly
+2. **Run \`sudo cp\` immediately** - no reading needed
+3. **If files have different owners**, use sudo
 
-# With sudo (if permission denied)
-sudo cp /path/to/source/file.ts /path/to/dest/file.ts
+Examples:
+\`\`\`bash
+# Copy single file
+sudo cp /source/file.ts /dest/file.ts
 
 # Copy entire folder
-sudo cp -r /path/to/source/folder /path/to/dest/
+sudo cp -r /source/folder/ /dest/folder/
+
+# Copy matching pattern
+sudo cp /source/*.tsx /dest/
 \`\`\`
 
-**NEVER write files from scratch when copying is available** - it causes incomplete/imprecise code.
+**STOP**: Do NOT use \`read\`, \`expand\`, or \`cat\` on source files. Just copy.
 
-The source files already exist. Just copy them directly.
+**Why**: Reading wastes time. The source files are complete - copying preserves everything exactly.
 `;
-function shouldInject(text) {
+var IMPORT_ERROR_RULE = `
+## IMPORT ERRORS? COPY THOSE FILES TOO!
+
+When you see import/module errors after copying a file:
+
+1. **STOP fixing imports one by one**
+2. **STOP rolling back**
+3. **LIST all missing import files** for the user
+4. **Ask user which to copy**, then copy them via sudo cp
+
+Example:
+\`\`\`bash
+# If error shows missing:
+# - @repo/auth/server
+# - @repo/design-system/components/ui/sidebar
+# - ./components/notifications-provider
+
+# Then copy these files the same way:
+sudo cp /source/path/@repo/auth/server.ts /dest/path/@repo/auth/server.ts
+sudo cp -r /source/path/@repo/design-system/components/ui/sidebar /dest/path/@repo/design-system/components/ui/sidebar
+sudo cp /source/path/components/notifications-provider.tsx /dest/path/components/notifications-provider.tsx
+\`\`\`
+
+**NEVER fix imports one by one** - copy the missing files instead!
+**NEVER roll back** - keep the copied file and copy its dependencies!
+`;
+function shouldInjectCopyRule(text) {
+  const lower = text.toLowerCase();
+  const hasIntent = COPY_KEYWORDS.some((keyword) => lower.includes(keyword));
+  if (!hasIntent) {
+    return false;
+  }
+  const hasDest = COPY_DEST_CONTEXT.some((ctx) => lower.includes(ctx));
+  if (!hasDest) {
+    return false;
+  }
+  const hasSource = COPY_SOURCE_CONTEXT.some((ctx) => lower.includes(ctx));
+  if (!hasSource) {
+    return false;
+  }
+  return true;
+}
+function shouldInjectImportErrorRule(text) {
   const lower = text.toLowerCase();
-  return COPY_KEYWORDS.some((keyword) => lower.includes(keyword));
+  return IMPORT_ERROR_TRIGGERS.some((t) => lower.includes(t));
 }
 function registerFileCopyHelper(pi) {
   pi.on("input", (event) => {
@@ -44,12 +97,18 @@ function registerFileCopyHelper(pi) {
     if (!text || text.length < 10) {
       return;
     }
-    if (shouldInject(text)) {
+    if (shouldInjectCopyRule(text)) {
       return {
         action: "transform",
         text: text + COPY_RULE
       };
     }
+    if (shouldInjectImportErrorRule(text)) {
+      return {
+        action: "transform",
+        text: text + IMPORT_ERROR_RULE
+      };
+    }
     return;
   });
 }

package/packages/file-copy-helper/src/extension.debug.ts

@@ -0,0 +1,226 @@
+/**
+ * file-copy-helper extension (DEBUG VERSION)
+ *
+ * Injects "use cp instead of writing from scratch" reminder when user
+ * asks to mimic, copy, clone, or replicate files/folders between locations.
+ * 
+ * DEBUG: All events and rule evaluations logged to /tmp/file-copy-helper-debug.log
+ */
+
+import type {
+	ExtensionAPI,
+	InputEvent,
+	InputEventResult,
+} from "@earendil-works/pi-coding-agent";
+import * as fs from "fs";
+
+// DEBUG: Write to file instead of TUI
+const DEBUG_LOG = "/tmp/file-copy-helper-debug.log";
+
+function debugLog(label: string, data: unknown): void {
+	const timestamp = new Date().toISOString();
+	const entry = `[${timestamp}] ${label}: ${JSON.stringify(data, null, 2)}\n`;
+	fs.appendFileSync(DEBUG_LOG, entry);
+}
+
+// Keywords that trigger the copy rule injection
+// MUST have explicit mimic/copy/clone/replicate intent + source/dest context
+const COPY_KEYWORDS = ["mimic", "replicate", "clone"];
+
+// Must have destination context to trigger (avoids false positives)
+const COPY_DEST_CONTEXT = ["to ", "into ", "/dest/", "/target/", "over to"];
+
+// Must have source context to trigger
+const COPY_SOURCE_CONTEXT = ["from ", "source", "/source/", "orig"];
+
+// When agent sees import/module errors (needs to copy those files too)
+const IMPORT_ERROR_TRIGGERS = [
+	"import error",
+	"import errors",
+	"cannot find module",
+	"cannot resolve",
+	"module not found",
+	"missing import",
+	"missing file",
+	"does not exist",
+	"@repo/",
+	"error one by one",
+	"fix errors one by one",
+	"fix imports one by one",
+	"roll back",
+];
+
+// Extract source and destination from user request
+const COPY_RULE = `
+## COPY FILES DIRECTLY (CRITICAL)
+
+When asked to mimic, copy, clone, or replicate files:
+
+1. **DO NOT read the source files** - just copy them directly
+2. **Run \`sudo cp\` immediately** - no reading needed
+3. **If files have different owners**, use sudo
+
+Examples:
+\`\`\`bash
+# Copy single file
+sudo cp /source/file.ts /dest/file.ts
+
+# Copy entire folder
+sudo cp -r /source/folder/ /dest/folder/
+
+# Copy matching pattern
+sudo cp /source/*.tsx /dest/
+\`\`\`
+
+**STOP**: Do NOT use \`read\`, \`expand\`, or \`cat\` on source files. Just copy.
+
+**Why**: Reading wastes time. The source files are complete - copying preserves everything exactly.
+`;
+
+// When agent sees import errors - copy those files too!
+const IMPORT_ERROR_RULE = `
+## IMPORT ERRORS? COPY THOSE FILES TOO!
+
+When you see import/module errors after copying a file:
+
+1. **STOP fixing imports one by one**
+2. **STOP rolling back**
+3. **LIST all missing import files** for the user
+4. **Ask user which to copy**, then copy them via sudo cp
+
+Example:
+\`\`\`bash
+# If error shows missing:
+# - @repo/auth/server
+# - @repo/design-system/components/ui/sidebar
+# - ./components/notifications-provider
+
+# Then copy these files the same way:
+sudo cp /source/path/@repo/auth/server.ts /dest/path/@repo/auth/server.ts
+sudo cp -r /source/path/@repo/design-system/components/ui/sidebar /dest/path/@repo/design-system/components/ui/sidebar
+sudo cp /source/path/components/notifications-provider.tsx /dest/path/components/notifications-provider.tsx
+\`\`\`
+
+**NEVER fix imports one by one** - copy the missing files instead!
+**NEVER roll back** - keep the copied file and copy its dependencies!
+`;
+
+/**
+ * Check if text contains copy-related keywords
+ * Requires: explicit intent (mimic/copy/clone/replicate) AND destination context
+ */
+function shouldInjectCopyRule(text: string): { triggered: boolean; reason: string } {
+	const lower = text.toLowerCase();
+
+	// Must have explicit mimic/copy/clone/replicate intent
+	const hasIntent = COPY_KEYWORDS.some((keyword) => lower.includes(keyword));
+	if (!hasIntent) {
+		return { triggered: false, reason: `No intent keyword found. Keywords: ${COPY_KEYWORDS.join(", ")}` };
+	}
+
+	// Must have destination context (avoids false positives on "copy this code" etc)
+	const hasDest = COPY_DEST_CONTEXT.some((ctx) => lower.includes(ctx));
+	if (!hasDest) {
+		return { triggered: false, reason: `No destination context found. Dest contexts: ${COPY_DEST_CONTEXT.join(", ")}` };
+	}
+
+	// Should have source context for full mimic behavior
+	const hasSource = COPY_SOURCE_CONTEXT.some((ctx) => lower.includes(ctx));
+	if (!hasSource) {
+		return { triggered: false, reason: `No source context found. Source contexts: ${COPY_SOURCE_CONTEXT.join(", ")}` };
+	}
+
+	return { triggered: true, reason: `All conditions met: hasIntent=${hasIntent}, hasDest=${hasDest}, hasSource=${hasSource}` };
+}
+
+/**
+ * Check if text contains import error triggers
+ */
+function shouldInjectImportErrorRule(text: string): { triggered: boolean; reason: string } {
+	const lower = text.toLowerCase();
+	const matchingTriggers = IMPORT_ERROR_TRIGGERS.filter((t) => lower.includes(t));
+	
+	if (matchingTriggers.length === 0) {
+		return { triggered: false, reason: "No import error triggers found" };
+	}
+
+	return { triggered: true, reason: `Matched triggers: ${matchingTriggers.join(", ")}` };
+}
+
+/**
+ * Register the file-copy-helper extension
+ */
+export function registerFileCopyHelper(pi: ExtensionAPI): void {
+	// Clear debug log on startup
+	fs.writeFileSync(DEBUG_LOG, `[${new Date().toISOString()}] === DEBUG SESSION STARTED ===\n`);
+
+	pi.on("input", (event: InputEvent): InputEventResult | undefined => {
+		// DEBUG: Log what we receive
+		debugLog("INPUT_EVENT", {
+			source: event.source,
+			textLength: event.text?.length,
+			textPreview: event.text?.substring(0, 200),
+			fullText: event.text,
+		});
+
+		// Only process user input (not from extensions or RPC)
+		if (event.source !== "interactive") {
+			debugLog("SKIP", "not interactive input - skipping");
+			return;
+		}
+
+		const text = event.text.trim();
+		debugLog("PROCESSING_TEXT", {
+			text,
+			length: text.length,
+			hasMinLength: text.length >= 10,
+		});
+
+		if (!text || text.length < 10) {
+			debugLog("SKIP", "text too short (< 10 chars)");
+			return;
+		}
+
+		// Check if this is a copy/mimic request
+		const copyCheck = shouldInjectCopyRule(text);
+		debugLog("COPY_RULE_CHECK", {
+			triggered: copyCheck.triggered,
+			reason: copyCheck.reason,
+			matchingKeywords: COPY_KEYWORDS.filter(k => text.toLowerCase().includes(k)),
+			matchingDest: COPY_DEST_CONTEXT.filter(ctx => text.toLowerCase().includes(ctx)),
+			matchingSource: COPY_SOURCE_CONTEXT.filter(ctx => text.toLowerCase().includes(ctx)),
+		});
+
+		if (copyCheck.triggered) {
+			debugLog("INJECT", { rule: "COPY_RULE", reason: copyCheck.reason });
+			return {
+				action: "transform",
+				text: text + COPY_RULE,
+			};
+		}
+
+		// Inject import error rule when agent sees missing imports
+		const importCheck = shouldInjectImportErrorRule(text);
+		debugLog("IMPORT_ERROR_CHECK", {
+			triggered: importCheck.triggered,
+			reason: importCheck.reason,
+			matchingTriggers: IMPORT_ERROR_TRIGGERS.filter(t => text.toLowerCase().includes(t)),
+		});
+
+		if (importCheck.triggered) {
+			debugLog("INJECT", { rule: "IMPORT_ERROR_RULE", reason: importCheck.reason });
+			return {
+				action: "transform",
+				text: text + IMPORT_ERROR_RULE,
+			};
+		}
+
+		debugLog("NO_INJECTION", "no rule matched - passing through");
+		return;
+	});
+}
+
+// Default export for pi extension loading
+export default function fileCopyHelperExtension(pi: ExtensionAPI): void {
+	registerFileCopyHelper(pi);
+}