pi-harness-runtime 0.9.2 → 0.9.5

package/packages/notification/dist/notification-center.js

@@ -0,0 +1,228 @@
+/**
+ * Notification Center — RFC-0022
+ *
+ * Main orchestration class for sending notifications across multiple channels.
+ *
+ * Security Rules (RFC-0022):
+ * - Do not send raw cookies, passwords, provider tokens
+ * - Redact sensitive data before sending
+ * - Notification failure does not crash runtime
+ */
+import { TelegramAdapter } from "./adapters/telegram-adapter.js";
+import { NtfyAdapter } from "./adapters/ntfy-adapter.js";
+import { EmailAdapter } from "./adapters/email-adapter.js";
+import { WebhookAdapter } from "./adapters/webhook-adapter.js";
+export class NotificationCenter {
+    adapters = new Map();
+    redactPatterns;
+    constructor(config) {
+        this.redactPatterns =
+            config?.redactPatterns ?? this.getDefaultRedactPatterns();
+        if (config?.channels) {
+            for (const channelConfig of config.channels) {
+                if (channelConfig.enabled) {
+                    this.registerAdapter(channelConfig);
+                }
+            }
+        }
+    }
+    /**
+     * Register a new adapter
+     */
+    registerAdapter(config) {
+        try {
+            const adapter = this.createAdapter(config);
+            if (adapter && adapter.isConfigured()) {
+                this.adapters.set(config.id, adapter);
+                return true;
+            }
+        }
+        catch (error) {
+            console.error(`[NotificationCenter] Failed to register adapter: ${error}`);
+        }
+        return false;
+    }
+    /**
+     * Initialize all registered adapters
+     */
+    async initialize() {
+        const adapterEntries = Array.from(this.adapters.entries());
+        for (const [id, adapter] of adapterEntries) {
+            try {
+                const ok = await adapter.initialize();
+                if (!ok) {
+                    console.warn(`[NotificationCenter] Adapter ${id} initialization failed`);
+                }
+            }
+            catch (error) {
+                console.warn(`[NotificationCenter] Adapter ${id} initialization error: ${error}`);
+            }
+        }
+    }
+    /**
+     * Send a notification to all configured channels
+     */
+    async notify(event, context) {
+        const payload = this.buildPayload(event, context);
+        const results = [];
+        // Send to all adapters in parallel
+        const adapterEntries = Array.from(this.adapters.entries());
+        const promises = adapterEntries.map(async ([id, adapter]) => {
+            try {
+                // Redact sensitive data
+                const redactedPayload = this.redact(payload);
+                const result = await adapter.send(redactedPayload);
+                results.push(result);
+            }
+            catch (error) {
+                // Never crash the runtime due to notification failure
+                results.push({
+                    success: false,
+                    channel: id,
+                    error: String(error),
+                });
+            }
+        });
+        await Promise.all(promises);
+        return results;
+    }
+    /**
+     * Send notification to a specific channel
+     */
+    async notifyChannel(channelId, event, context) {
+        const adapter = this.adapters.get(channelId);
+        if (!adapter) {
+            return { success: false, channel: channelId, error: "Adapter not found" };
+        }
+        try {
+            const payload = this.redact(this.buildPayload(event, context));
+            return await adapter.send(payload);
+        }
+        catch (error) {
+            return { success: false, channel: channelId, error: String(error) };
+        }
+    }
+    /**
+     * Check if any notifications are configured
+     */
+    hasChannels() {
+        return this.adapters.size > 0;
+    }
+    /**
+     * List all configured channels
+     */
+    listChannels() {
+        return Array.from(this.adapters.keys());
+    }
+    // ─── Private Methods ────────────────────────────────────────────────
+    createAdapter(config) {
+        switch (config.type) {
+            case "telegram":
+                return new TelegramAdapter(config.config);
+            case "ntfy":
+                return new NtfyAdapter(config.config);
+            case "email":
+                return new EmailAdapter(config.config);
+            case "webhook":
+                return new WebhookAdapter(config.config);
+            default:
+                return null;
+        }
+    }
+    buildPayload(event, context) {
+        const { title, message } = this.getEventContent(event, context);
+        return {
+            event,
+            jobId: context.jobId,
+            timestamp: new Date().toISOString(),
+            title,
+            message,
+            details: {
+                jobId: context.jobId,
+                requirement: context.requirement,
+                ...(context.taskId && { taskId: context.taskId }),
+                ...(context.taskTitle && { taskTitle: context.taskTitle }),
+                ...(context.error && { error: context.error }),
+            },
+        };
+    }
+    getEventContent(event, context) {
+        const requirement = context.requirement.length > 50
+            ? context.requirement.slice(0, 50) + "..."
+            : context.requirement;
+        const map = {
+            JobStarted: {
+                title: "Job Started",
+                message: `Harness job started for: "${requirement}"`,
+            },
+            TaskCompleted: {
+                title: "Task Completed",
+                message: `Task "${context.taskTitle ?? "Unknown"}" completed successfully`,
+            },
+            TaskFailed: {
+                title: "Task Failed",
+                message: `Task "${context.taskTitle ?? "Unknown"}" failed${context.error ? `: ${context.error}` : ""}`,
+            },
+            QuotaPaused: {
+                title: "Quota Paused",
+                message: `Job paused due to quota limit. Will auto-resume when quota resets.`,
+            },
+            ResumeScheduled: {
+                title: "Resume Scheduled",
+                message: `Job will resume work on: "${requirement}"`,
+            },
+            ContextCompacted: {
+                title: "Context Compacted",
+                message: `Session context was compacted to continue work on: "${requirement}"`,
+            },
+            OutputLimitContinued: {
+                title: "Output Limit Continued",
+                message: `Response was continued after hitting output token limit`,
+            },
+            E2EFailed: {
+                title: "E2E Test Failed",
+                message: `End-to-end tests failed for job: "${requirement}"`,
+            },
+            HumanReviewNeeded: {
+                title: "Human Review Needed",
+                message: `Job blocked. Please review and take action.`,
+            },
+            ReadyForClient: {
+                title: "Ready for Review",
+                message: `Job completed successfully and ready for your review: "${requirement}"`,
+            },
+            JobCancelled: {
+                title: "Job Cancelled",
+                message: `Job was cancelled: "${requirement}"`,
+            },
+            Error: {
+                title: "Runtime Error",
+                message: `An error occurred${context.error ? `: ${context.error}` : ""}`,
+            },
+        };
+        return map[event] ?? { title: event, message: `Event: ${event}` };
+    }
+    redact(payload) {
+        const details = payload.details ? { ...payload.details } : {};
+        // Redact sensitive patterns
+        for (const pattern of this.redactPatterns) {
+            for (const [key, value] of Object.entries(details)) {
+                if (typeof value === "string" && pattern.test(value)) {
+                    details[key] = "[REDACTED]";
+                }
+            }
+        }
+        return { ...payload, details };
+    }
+    getDefaultRedactPatterns() {
+        return [
+            /Bearer\s+[\w-]+/gi, // Bearer tokens
+            /password["\s:=]+[^\s,}]+/gi, // passwords
+            /cookie["\s:=]+[^\s,}]+/gi, // cookies
+            /secret["\s:=]+[^\s,}]+/gi, // secrets
+            /api[_-]?key["\s:=]+[^\s,}]+/gi, // API keys
+            /auth["\s:=]+[^\s,}]+/gi, // auth tokens
+        ];
+    }
+}
+//# sourceMappingURL=notification-center.js.map

package/packages/notification/dist/notification-center.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-center.js","sourceRoot":"","sources":["../src/notification-center.ts"],"names":[],"mappings":"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"}

package/packages/notification/dist/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Notification Center Types — RFC-0022
+ *
+ * Type definitions for notification events, channels, and payloads.
+ */
+export type NotificationEvent = "JobStarted" | "TaskCompleted" | "TaskFailed" | "QuotaPaused" | "ResumeScheduled" | "ContextCompacted" | "OutputLimitContinued" | "E2EFailed" | "HumanReviewNeeded" | "ReadyForClient" | "JobCancelled" | "Error";
+export interface NotificationPayload {
+    event: NotificationEvent;
+    jobId: string;
+    timestamp: string;
+    title: string;
+    message: string;
+    details?: Record<string, unknown>;
+    redacted?: string[];
+}
+export interface NotificationConfig {
+    channels: NotificationChannelConfig[];
+    enabled?: boolean;
+    redactPatterns?: RegExp[];
+}
+export interface NotificationChannelConfig {
+    id: string;
+    type: NotificationChannelType;
+    enabled: boolean;
+    config: TelegramConfig | NtfyConfig | EmailConfig | WebhookConfig;
+}
+export type NotificationChannelType = "telegram" | "ntfy" | "email" | "webhook";
+export interface TelegramConfig {
+    botToken: string;
+    chatId: string;
+    parseMode?: "MarkdownV2" | "HTML" | "Markdown";
+}
+export interface NtfyConfig {
+    server: string;
+    topic: string;
+    authToken?: string;
+}
+export interface EmailConfig {
+    smtpHost: string;
+    smtpPort: number;
+    smtpUser: string;
+    smtpPassword: string;
+    from: string;
+    to: string[];
+    tls?: boolean;
+}
+export interface WebhookConfig {
+    url: string;
+    method?: "POST" | "PUT";
+    headers?: Record<string, string>;
+    authToken?: string;
+}
+export interface NotificationResult {
+    success: boolean;
+    channel: string;
+    error?: string;
+}
+export interface NotificationContext {
+    jobId: string;
+    requirement: string;
+    taskId?: string;
+    taskTitle?: string;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/notification/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,iBAAiB,GAC1B,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,sBAAsB,GACtB,WAAW,GACX,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,GACd,OAAO,CAAC;AAEX,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IAEtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC;CAClE;AAED,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhF,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}

package/packages/notification/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Notification Center Types — RFC-0022
+ *
+ * Type definitions for notification events, channels, and payloads.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/notification/dist/types.js.map

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

package/packages/notification/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@pi-harness/notification",
+  "version": "0.9.5",
+  "description": "pi-harness-runtime — notification",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test"
+  },
+  "dependencies": {}
+}

package/packages/notification/src/adapters/email-adapter.ts

@@ -0,0 +1,126 @@
+/**
+ * Email Adapter — RFC-0022
+ *
+ * Sends notifications via SMTP.
+ */
+
+import type {
+	NotificationPayload,
+	NotificationResult,
+	EmailConfig,
+} from "../types.js";
+import { BaseChannelAdapter } from "../base-adapter.js";
+
+// Simple SMTP client using built-in net module
+async function sendSmtpEmail(
+	host: string,
+	port: number,
+	user: string,
+	password: string,
+	from: string,
+	to: string[],
+	subject: string,
+	body: string,
+	tls: boolean = false,
+): Promise<void> {
+	// For a production implementation, you'd use a proper SMTP library
+	// This is a placeholder that logs the email
+	console.log(`[Email] Would send to ${to.join(", ")}`);
+	console.log(`[Email] Subject: ${subject}`);
+	console.log(`[Email] Body: ${body}`);
+
+	// In practice, you'd use something like:
+	// import { createClient } from "nodemailer";
+	// const transporter = nodemailer.createTransport({ ... });
+	// await transporter.sendMail({ ... });
+}
+
+export class EmailAdapter extends BaseChannelAdapter {
+	readonly id = "email";
+	readonly type = "email";
+
+	constructor(config: EmailConfig) {
+		super({ id: "email", type: "email", enabled: true, config });
+	}
+
+	async initialize(): Promise<boolean> {
+		// Verify SMTP connection
+		try {
+			const cfg = this.config.config as EmailConfig;
+			// In production, verify SMTP credentials
+			return Boolean(
+				cfg.smtpHost && cfg.smtpUser && cfg.from && cfg.to.length > 0,
+			);
+		} catch {
+			return false;
+		}
+	}
+
+	async send(payload: NotificationPayload): Promise<NotificationResult> {
+		try {
+			const cfg = this.config.config as EmailConfig;
+			const subject = `${this.getEmoji(payload.event)} ${payload.title}`;
+			const body = this.formatBody(payload);
+
+			await sendSmtpEmail(
+				cfg.smtpHost,
+				cfg.smtpPort,
+				cfg.smtpUser,
+				cfg.smtpPassword,
+				cfg.from,
+				cfg.to,
+				subject,
+				body,
+				cfg.tls,
+			);
+
+			return { success: true, channel: this.id };
+		} catch (error) {
+			return {
+				success: false,
+				channel: this.id,
+				error: String(error),
+			};
+		}
+	}
+
+	private formatBody(payload: NotificationPayload): string {
+		const lines = [
+			payload.message,
+			"",
+			"---",
+			`Event: ${payload.event}`,
+			`Time: ${payload.timestamp}`,
+		];
+
+		if (payload.details?.taskTitle) {
+			lines.push(`Task: ${payload.details.taskTitle}`);
+		}
+		if (payload.details?.jobId) {
+			lines.push(`Job ID: ${payload.details.jobId}`);
+		}
+		if (payload.details?.error) {
+			lines.push("", `Error: ${payload.details.error}`);
+		}
+
+		return lines.join("\n");
+	}
+
+	private getEmoji(event: NotificationPayload["event"]): string {
+		const map: Record<string, string> = {
+			JobStarted: "[🚀]",
+			TaskCompleted: "[✅]",
+			TaskFailed: "[❌]",
+			QuotaPaused: "[⏸]",
+			ResumeScheduled: "[▶]",
+			ContextCompacted: "[📦]",
+			OutputLimitContinued: "[🔄]",
+			E2EFailed: "[🧪]",
+			HumanReviewNeeded: "[👤]",
+			ReadyForClient: "[🎉]",
+			JobCancelled: "[🚫]",
+			Error: "[⚠]",
+		};
+		return map[event] ?? "[📢]";
+	}
+}

package/packages/notification/src/adapters/ntfy-adapter.ts

@@ -0,0 +1,100 @@
+/**
+ * Ntfy Adapter — RFC-0022
+ *
+ * Sends notifications via ntfy.sh (or self-hosted ntfy server).
+ */
+
+import type {
+	NotificationPayload,
+	NotificationResult,
+	NtfyConfig,
+} from "../types.js";
+import { BaseChannelAdapter } from "../base-adapter.js";
+
+export class NtfyAdapter extends BaseChannelAdapter {
+	readonly id = "ntfy";
+	readonly type = "ntfy";
+
+	constructor(config: NtfyConfig) {
+		super({ id: "ntfy", type: "ntfy", enabled: true, config });
+	}
+
+	async initialize(): Promise<boolean> {
+		// Ntfy doesn't require initialization; it's fire-and-forget
+		return true;
+	}
+
+	async send(payload: NotificationPayload): Promise<NotificationResult> {
+		try {
+			const cfg = this.config.config as NtfyConfig;
+			const message = this.formatMessage(payload);
+			const headers: Record<string, string> = {
+				"Content-Type": "text/plain",
+				Title: payload.title,
+				Tags: this.getTags(payload.event),
+			};
+
+			// Add auth if configured
+			if (cfg.authToken) {
+				headers["Authorization"] = `Bearer ${cfg.authToken}`;
+			}
+
+			const response = await fetch(`${cfg.server}/${cfg.topic}`, {
+				method: "POST",
+				headers,
+				body: message,
+			});
+
+			if (!response.ok) {
+				const error = await response.text();
+				return {
+					success: false,
+					channel: this.id,
+					error: `Ntfy error: ${error}`,
+				};
+			}
+
+			return { success: true, channel: this.id };
+		} catch (error) {
+			return {
+				success: false,
+				channel: this.id,
+				error: String(error),
+			};
+		}
+	}
+
+	private formatMessage(payload: NotificationPayload): string {
+		const lines = [payload.message];
+
+		if (payload.details?.taskTitle) {
+			lines.push(`\nTask: ${payload.details.taskTitle}`);
+		}
+		if (payload.details?.jobId) {
+			lines.push(`Job: ${payload.details.jobId}`);
+		}
+		if (payload.details?.error) {
+			lines.push(`\nError: ${payload.details.error}`);
+		}
+
+		return lines.join("");
+	}
+
+	private getTags(event: NotificationPayload["event"]): string {
+		const map: Record<string, string> = {
+			JobStarted: "rocket",
+			TaskCompleted: "white_check_mark",
+			TaskFailed: "x",
+			QuotaPaused: "pause_button",
+			ResumeScheduled: "play_button",
+			ContextCompacted: "package",
+			OutputLimitContinued: "repeat",
+			E2EFailed: "test_tube",
+			HumanReviewNeeded: "bust_in_silhouette",
+			ReadyForClient: "tada",
+			JobCancelled: "no_entry",
+			Error: "warning",
+		};
+		return map[event] ?? "bell";
+	}
+}

package/packages/notification/src/adapters/telegram-adapter.ts

@@ -0,0 +1,107 @@
+/**
+ * Telegram Adapter — RFC-0022
+ *
+ * Sends notifications via Telegram Bot API.
+ */
+
+import type {
+	NotificationPayload,
+	NotificationResult,
+	TelegramConfig,
+} from "../types.js";
+import { BaseChannelAdapter } from "../base-adapter.js";
+
+export class TelegramAdapter extends BaseChannelAdapter {
+	readonly id = "telegram";
+	readonly type = "telegram";
+
+	constructor(config: TelegramConfig) {
+		super({ id: "telegram", type: "telegram", enabled: true, config });
+	}
+
+	async initialize(): Promise<boolean> {
+		try {
+			const cfg = this.config.config as TelegramConfig;
+			// Verify bot token by calling getMe
+			const response = await fetch(
+				`https://api.telegram.org/bot${cfg.botToken}/getMe`,
+			);
+			return response.ok;
+		} catch {
+			return false;
+		}
+	}
+
+	async send(payload: NotificationPayload): Promise<NotificationResult> {
+		try {
+			const cfg = this.config.config as TelegramConfig;
+			const message = this.formatMessage(payload);
+
+			const response = await fetch(
+				`https://api.telegram.org/bot${cfg.botToken}/sendMessage`,
+				{
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({
+						chat_id: cfg.chatId,
+						text: message,
+						parse_mode: cfg.parseMode ?? "MarkdownV2",
+					}),
+				},
+			);
+
+			if (!response.ok) {
+				const error = await response.text();
+				return {
+					success: false,
+					channel: this.id,
+					error: `Telegram API error: ${error}`,
+				};
+			}
+
+			return { success: true, channel: this.id };
+		} catch (error) {
+			return {
+				success: false,
+				channel: this.id,
+				error: String(error),
+			};
+		}
+	}
+
+	private formatMessage(payload: NotificationPayload): string {
+		const emoji = this.getEmoji(payload.event);
+		const title = `${emoji} ${payload.title}`;
+		const lines = [title, "", payload.message];
+
+		if (payload.details?.taskTitle) {
+			lines.push("", `Task: ${payload.details.taskTitle}`);
+		}
+		if (payload.details?.jobId) {
+			lines.push(`Job: ${payload.details.jobId}`);
+		}
+		if (payload.details?.error) {
+			lines.push("", `Error: ${payload.details.error}`);
+		}
+
+		return lines.filter(Boolean).join("\n");
+	}
+
+	private getEmoji(event: NotificationPayload["event"]): string {
+		const map: Record<string, string> = {
+			JobStarted: "🚀",
+			TaskCompleted: "✅",
+			TaskFailed: "❌",
+			QuotaPaused: "⏸️",
+			ResumeScheduled: "▶️",
+			ContextCompacted: "📦",
+			OutputLimitContinued: "🔄",
+			E2EFailed: "🧪",
+			HumanReviewNeeded: "👤",
+			ReadyForClient: "🎉",
+			JobCancelled: "🚫",
+			Error: "⚠️",
+		};
+		return map[event] ?? "📢";
+	}
+}