pi-harness-runtime 1.1.341 → 1.1.342

package/README.md

@@ -679,6 +679,9 @@ Your local machine clipboard
 
 Get notified on your phone when tasks complete! LINE notifications via the LINE Messaging API.
 
+> **Self-Hosting Required**: LINE webhooks require your own server. This is NOT a hosted service.
+> You must **clone this repository** and deploy your own webhook server. See [LINE Voice/Webhook Setup](#line-voicewebhook-setup) below.
+
 #### Step-by-Step Setup
 
 **1. Create a LINE Messaging API channel**
@@ -754,6 +757,118 @@ Task: Implement login flow
 Job: feature-auth
 ```
 
+### LINE Voice/Webhook Setup (Voice Commands)
+
+> **Self-Hosting Required**: LINE voice messages require your own server with HTTPS.
+> This is NOT a hosted service. You must **clone this repository** and deploy your own webhook server.
+
+Voice messages from LINE are transcribed via OpenAI Whisper API and executed as commands.
+
+#### Requirements
+
+- **Own server** (VPS, cloud VM) with public IP
+- **Domain** with DNS A record pointing to your server
+- **SSL certificate** (Let's Encrypt via certbot)
+- **Clone this repository** on your server
+
+#### Setup Steps
+
+**1. Clone and Build**
+
+```bash
+# Clone on your server
+git clone https://github.com/ManotLuijiu/pi-harness-runtime.git
+cd pi-harness-runtime
+bun install
+bun run build
+```
+
+**2. Configure DNS**
+
+Create an A record: `line-api.your-domain.com` → `YOUR_SERVER_IP`
+
+**3. Setup Nginx + SSL**
+
+```bash
+# Install certbot
+sudo apt install certbot python3-certbot-nginx
+
+# Create nginx config
+sudo tee /etc/nginx/sites-available/line-api.your-domain.com > /dev/null << 'NGINX'
+server {
+    listen 80;
+    server_name line-api.your-domain.com;
+    location / {
+        proxy_pass http://127.0.0.1:3900;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+    }
+}
+NGINX
+
+# Enable and get SSL
+sudo ln -sf /etc/nginx/sites-available/line-api.your-domain.com /etc/nginx/sites-enabled/
+sudo certbot --nginx -d line-api.your-domain.com --noninteractive --agree-tos -m admin@your-domain.com --redirect
+```
+
+**4. Configure LINE Webhook**
+
+```bash
+# Set credentials
+mkdir -p ~/.pi-harness-runtime/keys
+
+# Get from LINE Developers Console > Messaging API > Basic settings
+cp YOUR_ACCESS_TOKEN ~/.pi-harness-runtime/keys/line-access-token.txt
+cp YOUR_CHANNEL_SECRET ~/.pi-harness-runtime/keys/line-channel-secret.txt
+
+# Get from LINE Developers Console > Messaging API > Webhook URL
+# Set to: https://line-api.your-domain.com/webhook/line
+```
+
+**5. Create Webhook Server**
+
+```bash
+# Create startup script
+mkdir -p ~/line-webhook
+cp pi-harness-runtime/packages/voice-api/dist/*.js ~/line-webhook/
+
+# Run server
+bun run ~/line-webhook/server.ts
+```
+
+**6. Set Webhook URL in LINE Console**
+
+1. Go to LINE Developers Console → Messaging API → Messaging settings
+2. Set Webhook URL: `https://line-api.your-domain.com/webhook/line`
+3. Click Verify
+
+#### Systemd Service (Auto-Restart)
+
+```bash
+sudo tee /etc/systemd/system/line-webhook.service > /dev/null << 'SERVICE'
+[Unit]
+Description=LINE Webhook Server for pi-harness
+After=network.target
+
+[Service]
+Type=simple
+User=YOUR_USER
+WorkingDirectory=/home/YOUR_USER/line-webhook
+ExecStart=/home/YOUR_USER/.bun/bin/bun run /home/YOUR_USER/line-webhook/server.ts
+Restart=always
+RestartSec=5
+StandardOutput=journal
+StandardError=journal
+
+[Install]
+WantedBy=multi-user.target
+SERVICE
+
+sudo systemctl daemon-reload
+sudo systemctl enable line-webhook.service
+sudo systemctl start line-webhook.service
+```
+
 ### Other Providers
 
 No setup needed. The runtime reads TUI messages and captures quota-exhaustion signals.
@@ -780,6 +895,9 @@ footer updates immediately and the data persists in `mirror.json`.
 
 Enable interactive Yes/No buttons in Telegram notifications for human approval.
 
+> **Self-Hosting Required**: Telegram webhooks require your own server with HTTPS.
+> This is NOT a hosted service. You must **clone this repository** and deploy your own webhook server.
+
 ### Architecture (Per-User Setup)
 
 ```

package/index.ts

@@ -2396,6 +2396,61 @@ function initJobPipeWatcher(pi: ExtensionAPI): void {
 	logToFile("[JobPipe]", "Watching for Telegram approval commands via API (polling every 60s)");
 }
 
+// --- LINE Voice Queue Watcher: Listen for LINE voice commands ---------
+// Watches the LINE voice queue file and injects transcribed prompts into pi.
+//
+// Flow:
+//   User sends voice message in LINE
+//   → LINE sends webhook to our VPS
+//   → VPS transcribes via Whisper API
+//   → VPS writes command to line-voice-queue.jsonl
+//   → pi-harness polls this file
+//   → pi-harness injects prompt via steer
+function initLineVoiceQueue(pi: ExtensionAPI): void {
+	const homedir = process.env.HOME || process.env.USERPROFILE || "/home/frappe";
+	const queueFile = join(homedir, ".pi-harness-runtime", "line-voice-queue.jsonl");
+
+	const processLineVoiceQueue = async () => {
+		try {
+			const { existsSync, readFileSync, writeFileSync } = await import("node:fs");
+
+			if (!existsSync(queueFile)) {
+				return;
+			}
+
+			const content = readFileSync(queueFile, "utf-8");
+			const lines = content.split("\n").filter((l) => l.trim());
+
+			if (lines.length === 0) {
+				return;
+			}
+
+			// Clear queue
+			writeFileSync(queueFile, "", "utf-8");
+
+			for (const line of lines) {
+				try {
+					const cmd = JSON.parse(line) as { type: string; text: string; userId: string; timestamp: string };
+
+					if (cmd.type === "voice-prompt" && cmd.text) {
+						logToFile("[LineVoice]", `Injecting voice prompt: "${cmd.text}"`);
+						pi.sendUserMessage(cmd.text, { deliverAs: "steer" });
+						logToFile("[LineVoice]", "Voice prompt injected via steer");
+					}
+				} catch {
+					// Skip malformed lines
+				}
+			}
+		} catch {
+			// Ignore errors
+		}
+	};
+
+	// Poll every 5 seconds for new voice commands (voice is more time-sensitive than approvals)
+	setInterval(processLineVoiceQueue, 5_000);
+	logToFile("[LineVoice]", `Watching LINE voice queue: ${queueFile} (polling every 5s)`);
+}
+
 export default async function (pi: ExtensionAPI) {
 	const tracker = new UsageTracker();
 	const mirrorStore = new MirrorStore();
@@ -2442,6 +2497,9 @@ export default async function (pi: ExtensionAPI) {
 	// Collect promise so we can wait for initialization before showing startup notification
 	asyncInitPromises.push(initTelegram(pi));
 
+	// --- line-voice-queue: Watch for LINE voice commands ----
+	void initLineVoiceQueue(pi);
+
 		// --- codex-watcher: Auto-trigger Pi when Codex finishes a plan ---
 		// Flow: detect plan -> settle timer -> file stability check -> cwd match -> trigger
 		try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "[BETA] Codex-style /usage status + autonomous coding harness for pi. Not production ready — expect breaking changes.",
   "type": "module",
   "scripts": {

package/packages/a2a-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/a2a-adapter",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "description": "Google Agent-to-Agent (A2A) protocol adapter for pi-harness",
   "main": "dist/index.js",

package/packages/agent-policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/agent-policy",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Agent policy runtime for pi-harness - enforces mandatory rule delivery and mutation gating",
   "type": "module",
   "main": "./dist/index.js",

package/packages/architecture-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/architecture-generator",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Generate ADR and Mermaid diagrams from project analysis",
   "type": "module",
   "main": "./dist/index.js",

package/packages/auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/auth",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "pi-harness-runtime — auth",
   "type": "module",
   "main": "./dist/index.js",

package/packages/autonomous-refactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-refactor",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "description": "Autonomous refactoring engine",
   "main": "dist/index.js",

package/packages/autonomous-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-runtime",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Autonomous Operations Runtime — task inbox, lease management, and worker lifecycle (RFC-0101)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cache-strategy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/cache-strategy",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "description": "Smart caching with TTL and invalidation strategies (RFC-0022)",
   "main": "dist/index.js",

package/packages/capability-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/capability-registry",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Capability Registry for pi-harness-runtime — tracks model capabilities and enables capability-based routing",
   "type": "module",
   "main": "./dist/index.js",

package/packages/checkpoint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/checkpoint",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Enhanced checkpoint system with incremental snapshots, diff-based storage, and recovery strategies",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cli-plugin-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/cli-plugin-sdk",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "description": "CLI Plugin SDK for pi-harness — install, list, remove, update, invoke plugins",
   "main": "dist/index.js",

package/packages/clipboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/clipboard",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/clipboard-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/clipboard-plugin",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Code generation pipeline for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/code-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-review",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Automated code review engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/codex-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/codex-adapter",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "description": "OpenAI Codex provider adapter for pi-harness",
   "main": "dist/index.js",

package/packages/codex-watcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/codex-watcher",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Watches Codex CLI sessions and emits visible messages for PING-PONG monitoring",
   "type": "module",
   "main": "./dist/src/index.js",

package/packages/config-capture/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/config-capture",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Auto-capture API-fetched configuration values to AGENTS.md",
   "type": "module",
   "main": "src/index.ts",

package/packages/connection-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/connection-runtime",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "description": "Connection management with jittered exponential backoff for pi-harness",
   "main": "./dist/index.js",

package/packages/context-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-compiler",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Bounded context selection engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/context-discovery/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-discovery",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/context-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/context-manager",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Context Window Manager — prevents model context overflow via compaction and resume prompts (RFC-0010)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/contracts",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "description": "RPC schema definitions for pi-harness runtime",
   "main": "./dist/index.js",

package/packages/cookie-sanitizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cookie-sanitizer",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "pi-harness-runtime — cookie sanitizer (provider-quota cookie file normaliser)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cost-optimizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cost-optimizer",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Cost Optimizer for pi-harness-runtime — budget tracking, forecasting, and model selection optimization",
   "type": "module",
   "main": "./dist/index.js",

package/packages/dependency-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/dependency-analyzer",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/django-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/django-plugin",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Django framework analysis — models, management commands, settings",
   "type": "module",
   "main": "./dist/index.js",

package/packages/doc-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/doc-generator",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Auto-Doc Generator — generate documentation from source code (RFC-0014)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/durable-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/durable-review",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "SQLite-backed durable reviewer using @earendil-works/pi-durable",
   "type": "module",
   "main": "src/index.ts",

package/packages/e2e-tester/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/e2e-tester",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "WebMCP-powered E2E testing for pi-harness - natural language test scenarios",
   "type": "module",
   "main": "./dist/index.js",

package/packages/evaluation-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/evaluation-engine",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Evaluation engine for pi-harness runtime (RFC-0057)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/evaluation-runner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/evaluation-runner",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "description": "Framework-agnostic evaluation framework for AI outputs (RFC-0020)",
   "main": "dist/index.js",

package/packages/event-bus/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-bus",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/event-sink/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/event-sink",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "description": "Atomic event sourcing with SQLite transactions for pi-harness",
   "main": "./dist/index.js",

package/packages/event-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-store",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/experience-replay/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/experience-replay",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Experience replay for debugging and reproducibility (RFC-0059)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/feedback-collector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/feedback-collector",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "description": "Collect and aggregate human/automated feedback (RFC-0021)",
   "main": "dist/index.js",

package/packages/file-copy-helper/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/file-copy-helper",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Injects cp/sudo cp rule when user asks to mimic/copy files",
   "type": "module",
   "main": "dist/index.js",

package/packages/framework-detector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/framework-detector",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Framework detection system for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/framework-plugin-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/framework-plugin-sdk",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Framework plugin SDK for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/frappe-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/frappe-plugin",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Frappe/ERPNext framework analysis — DocTypes, hooks, bench sites, site config",
   "type": "module",
   "main": "./dist/index.js",

package/packages/generic-web-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/generic-web-plugin",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Generic web framework analysis — REST/GraphQL endpoints, OpenAPI, auth",
   "type": "module",
   "main": "./dist/index.js",

package/packages/health-monitor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/health-monitor",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "description": "Health monitoring and auto-healing",
   "main": "dist/index.js",

package/packages/intent-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/intent-analyzer",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/jev-judge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/jev-judge",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Jev Judge - Structured decision model for agent routing, E2E testing, and automated decisions",
   "type": "module",
   "main": "./dist/index.js",

package/packages/knowledge-graph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/knowledge-graph",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Knowledge Graph extraction and provenance linking for SKILL.md files",
   "type": "module",
   "main": "./dist/index.js",

package/packages/knowledge-retrieval/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/knowledge-retrieval",
-  "version": "1.1.341",
+  "version": "1.1.342",
   "description": "Knowledge retrieval via TencentDB-Agent-Memory MCP (RFC-0105)",
   "type": "module",
   "main": "./dist/index.js",