@proletariat/cli 0.3.105 → 0.3.109

package/dist/lib/machine-orchestrator.js

@@ -0,0 +1,139 @@
+/**
+ * Machine Orchestrator — Prompt builder and state reader for machine-level orchestration.
+ *
+ * The machine orchestrator is the root-level supervisor. It reads machine.db
+ * to see ALL sessions across ALL repos on the machine, and can spawn, poke,
+ * kill, and ship agents in any repo.
+ *
+ * Unlike HQ-scoped orchestrators (which read workspace.db and see only one project),
+ * the machine orchestrator operates at the machine level — it's the `init` process
+ * for your development fleet.
+ */
+/**
+ * Read the current machine state from machine.db.
+ */
+export function readMachineState(db) {
+    const activeExecutions = db.getActiveExecutions();
+    const persistentAgents = db.listPersistentAgents();
+    const diedPersistentAgents = db.getDiedPersistentAgents();
+    const recentCompleted = db.listExecutions({ status: 'completed', limit: 10 });
+    const activeRepos = [...new Set(activeExecutions.map(e => e.repoPath))];
+    return {
+        activeExecutions,
+        persistentAgents,
+        diedPersistentAgents,
+        recentCompleted,
+        activeRepos,
+    };
+}
+// =============================================================================
+// Prompt Builder
+// =============================================================================
+/**
+ * Build the system prompt for the machine-level orchestrator.
+ *
+ * This prompt gives the orchestrator visibility into all agents across all repos
+ * and the commands to manage them.
+ */
+export function buildMachineOrchestratorPrompt(state, actionPrompt) {
+    let prompt = '';
+    // ─── Identity ──────────────────────────────────────────────
+    prompt += `# Machine Orchestrator\n\n`;
+    prompt += `You are the **machine-level orchestrator** — the root supervisor for all AI agents across every repository on this machine.\n\n`;
+    prompt += `Unlike HQ-scoped orchestrators (which manage one project), you see and control **all agents, all repos, all sessions**. `;
+    prompt += `You are the \`init\` process for the development fleet.\n\n`;
+    // ��── Capabilities ──────────────────────────────────────────
+    prompt += `## Your Role\n\n`;
+    prompt += `- **Spawn** agents in any repo: \`prlt work run --dir /path/to/repo --prompt "task"\`\n`;
+    prompt += `- **Monitor** all sessions: \`prlt session list\` (reads machine.db, works from anywhere)\n`;
+    prompt += `- **Poke** running agents: \`prlt session poke <session-id> "message"\`\n`;
+    prompt += `- **Stop** agents: \`prlt work stop <execution-id>\`\n`;
+    prompt += `- **Restart** died persistent agents: \`prlt work run --name <name> --keep-alive --prompt "..."\`\n`;
+    prompt += `- **Ship** completed work: \`prlt work ship <ticket-id>\` (when inside an HQ)\n`;
+    prompt += `- **Spawn persistent agents**: \`prlt work run --name reviewer --keep-alive --prompt "..."\`\n\n`;
+    // ─── Current State ─────────────────────────────────────────
+    prompt += `## Current Machine State\n\n`;
+    if (state.activeExecutions.length === 0 && state.persistentAgents.length === 0) {
+        prompt += `No active agents. The machine is idle.\n\n`;
+    }
+    else {
+        // Active executions
+        if (state.activeExecutions.length > 0) {
+            prompt += `### Active Agents (${state.activeExecutions.length})\n\n`;
+            prompt += `| ID | Agent | Status | Repo | Prompt |\n`;
+            prompt += `|----|-------|--------|------|--------|\n`;
+            for (const exec of state.activeExecutions) {
+                const repoShort = exec.repoPath.split('/').slice(-2).join('/');
+                const promptShort = exec.prompt.substring(0, 40) + (exec.prompt.length > 40 ? '...' : '');
+                const persistent = exec.persistent ? ' (persistent)' : '';
+                prompt += `| ${exec.id} | ${exec.agentName}${persistent} | ${exec.status} | ${repoShort} | ${promptShort} |\n`;
+            }
+            prompt += `\n`;
+        }
+        // Persistent agents (all statuses)
+        const stoppedPersistent = state.persistentAgents.filter(a => a.status !== 'running' && a.status !== 'starting');
+        if (stoppedPersistent.length > 0) {
+            prompt += `### Stopped Persistent Agents (restart candidates)\n\n`;
+            for (const agent of stoppedPersistent) {
+                prompt += `- **${agent.agentName}** (${agent.id}): ${agent.status}`;
+                if (agent.errorMessage)
+                    prompt += ` — ${agent.errorMessage}`;
+                prompt += `\n`;
+            }
+            prompt += `\n`;
+        }
+        // Died persistent agents
+        if (state.diedPersistentAgents.length > 0) {
+            prompt += `### Died Persistent Agents (need restart)\n\n`;
+            for (const agent of state.diedPersistentAgents) {
+                const repoShort = agent.repoPath.split('/').slice(-2).join('/');
+                prompt += `- **${agent.agentName}** in ${repoShort}: ${agent.errorMessage || 'died'}\n`;
+                prompt += `  Restart: \`prlt work run --name ${agent.agentName} --keep-alive --dir ${agent.repoPath} --prompt "${agent.prompt.substring(0, 60)}"\`\n`;
+            }
+            prompt += `\n`;
+        }
+    }
+    // Active repos
+    if (state.activeRepos.length > 0) {
+        prompt += `### Active Repos\n\n`;
+        for (const repo of state.activeRepos) {
+            const agentCount = state.activeExecutions.filter(e => e.repoPath === repo).length;
+            prompt += `- \`${repo}\` (${agentCount} agent${agentCount !== 1 ? 's' : ''})\n`;
+        }
+        prompt += `\n`;
+    }
+    // Recent history
+    if (state.recentCompleted.length > 0) {
+        prompt += `### Recent Completions\n\n`;
+        for (const exec of state.recentCompleted.slice(0, 5)) {
+            const repoShort = exec.repoPath.split('/').slice(-2).join('/');
+            const exitInfo = exec.exitCode !== undefined ? ` (exit ${exec.exitCode})` : '';
+            prompt += `- ${exec.agentName} in ${repoShort}: "${exec.prompt.substring(0, 50)}"${exitInfo}\n`;
+        }
+        prompt += `\n`;
+    }
+    // ─── Command Reference ─────────────────────────────────────
+    prompt += `## Command Reference\n\n`;
+    prompt += `### Agent Lifecycle\n`;
+    prompt += `| Command | Description |\n`;
+    prompt += `|---------|-------------|\n`;
+    prompt += `| \`prlt work run --prompt "..." --dir /repo\` | Spawn ephemeral agent in a repo |\n`;
+    prompt += `| \`prlt work run --name X --keep-alive --prompt "..."\` | Spawn persistent named agent |\n`;
+    prompt += `| \`prlt session list\` | List all sessions (machine-wide) |\n`;
+    prompt += `| \`prlt session attach <id>\` | Attach to agent session |\n`;
+    prompt += `| \`prlt session poke <id> "msg"\` | Send message to running agent |\n`;
+    prompt += `| \`prlt session peek <id>\` | View agent output without attaching |\n`;
+    prompt += `| \`prlt work stop <id>\` | Stop a running agent |\n`;
+    prompt += `| \`prlt session prune\` | Clean up stale sessions |\n\n`;
+    prompt += `### Anti-patterns\n\n`;
+    prompt += `- **NEVER** use \`docker exec\` or \`tmux send-keys\` directly — use \`prlt session poke\`\n`;
+    prompt += `- **NEVER** use \`gh pr create\` — use \`prlt work propose\` or \`prlt pr create\`\n`;
+    prompt += `- **NEVER** kill tmux sessions directly — use \`prlt work stop\`\n`;
+    prompt += `- **NEVER** write code yourself — you are a supervisor, delegate to agents\n\n`;
+    // ─── Action prompt ─────────────────────────────────────────
+    if (actionPrompt) {
+        prompt += `## Instructions\n\n${actionPrompt}\n`;
+    }
+    return prompt;
+}
+//# sourceMappingURL=machine-orchestrator.js.map

package/dist/lib/machine-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-orchestrator.js","sourceRoot":"","sources":["../../src/lib/machine-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAa;IAC5C,MAAM,gBAAgB,GAAG,EAAE,CAAC,mBAAmB,EAAE,CAAA;IACjD,MAAM,gBAAgB,GAAG,EAAE,CAAC,oBAAoB,EAAE,CAAA;IAClD,MAAM,oBAAoB,GAAG,EAAE,CAAC,uBAAuB,EAAE,CAAA;IACzD,MAAM,eAAe,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;IAE7E,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAEvE,OAAO;QACL,gBAAgB;QAChB,gBAAgB;QAChB,oBAAoB;QACpB,eAAe;QACf,WAAW;KACZ,CAAA;AACH,CAAC;AAED,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAAC,KAAmB,EAAE,YAAqB;IACvF,IAAI,MAAM,GAAG,EAAE,CAAA;IAEf,8DAA8D;IAC9D,MAAM,IAAI,4BAA4B,CAAA;IACtC,MAAM,IAAI,iIAAiI,CAAA;IAC3I,MAAM,IAAI,0HAA0H,CAAA;IACpI,MAAM,IAAI,6DAA6D,CAAA;IAEvE,+DAA+D;IAC/D,MAAM,IAAI,kBAAkB,CAAA;IAC5B,MAAM,IAAI,yFAAyF,CAAA;IACnG,MAAM,IAAI,6FAA6F,CAAA;IACvG,MAAM,IAAI,2EAA2E,CAAA;IACrF,MAAM,IAAI,wDAAwD,CAAA;IAClE,MAAM,IAAI,qGAAqG,CAAA;IAC/G,MAAM,IAAI,iFAAiF,CAAA;IAC3F,MAAM,IAAI,kGAAkG,CAAA;IAE5G,8DAA8D;IAC9D,MAAM,IAAI,8BAA8B,CAAA;IAExC,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,4CAA4C,CAAA;IACxD,CAAC;SAAM,CAAC;QACN,oBAAoB;QACpB,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,sBAAsB,KAAK,CAAC,gBAAgB,CAAC,MAAM,OAAO,CAAA;YACpE,MAAM,IAAI,2CAA2C,CAAA;YACrD,MAAM,IAAI,2CAA2C,CAAA;YACrD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;gBAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;gBACzF,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;gBACzD,MAAM,IAAI,KAAK,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,SAAS,GAAG,UAAU,MAAM,IAAI,CAAC,MAAM,MAAM,SAAS,MAAM,WAAW,MAAM,CAAA;YAChH,CAAC;YACD,MAAM,IAAI,IAAI,CAAA;QAChB,CAAC;QAED,mCAAmC;QACnC,MAAM,iBAAiB,GAAG,KAAK,CAAC,gBAAgB,CAAC,MAAM,CACrD,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CACvD,CAAA;QACD,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,wDAAwD,CAAA;YAClE,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;gBACtC,MAAM,IAAI,OAAO,KAAK,CAAC,SAAS,OAAO,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC,MAAM,EAAE,CAAA;gBACnE,IAAI,KAAK,CAAC,YAAY;oBAAE,MAAM,IAAI,MAAM,KAAK,CAAC,YAAY,EAAE,CAAA;gBAC5D,MAAM,IAAI,IAAI,CAAA;YAChB,CAAC;YACD,MAAM,IAAI,IAAI,CAAA;QAChB,CAAC;QAED,yBAAyB;QACzB,IAAI,KAAK,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,+CAA+C,CAAA;YACzD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;gBAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBAC/D,MAAM,IAAI,OAAO,KAAK,CAAC,SAAS,SAAS,SAAS,KAAK,KAAK,CAAC,YAAY,IAAI,MAAM,IAAI,CAAA;gBACvF,MAAM,IAAI,qCAAqC,KAAK,CAAC,SAAS,uBAAuB,KAAK,CAAC,QAAQ,cAAc,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAA;YACvJ,CAAC;YACD,MAAM,IAAI,IAAI,CAAA;QAChB,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,sBAAsB,CAAA;QAChC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,UAAU,GAAG,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,MAAM,CAAA;YACjF,MAAM,IAAI,OAAO,IAAI,OAAO,UAAU,SAAS,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAA;QACjF,CAAC;QACD,MAAM,IAAI,IAAI,CAAA;IAChB,CAAC;IAED,iBAAiB;IACjB,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,4BAA4B,CAAA;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;YAC9E,MAAM,IAAI,KAAK,IAAI,CAAC,SAAS,OAAO,SAAS,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ,IAAI,CAAA;QACjG,CAAC;QACD,MAAM,IAAI,IAAI,CAAA;IAChB,CAAC;IAED,8DAA8D;IAC9D,MAAM,IAAI,0BAA0B,CAAA;IACpC,MAAM,IAAI,uBAAuB,CAAA;IACjC,MAAM,IAAI,6BAA6B,CAAA;IACvC,MAAM,IAAI,6BAA6B,CAAA;IACvC,MAAM,IAAI,sFAAsF,CAAA;IAChG,MAAM,IAAI,6FAA6F,CAAA;IACvG,MAAM,IAAI,gEAAgE,CAAA;IAC1E,MAAM,IAAI,8DAA8D,CAAA;IACxE,MAAM,IAAI,wEAAwE,CAAA;IAClF,MAAM,IAAI,wEAAwE,CAAA;IAClF,MAAM,IAAI,sDAAsD,CAAA;IAChE,MAAM,IAAI,0DAA0D,CAAA;IAEpE,MAAM,IAAI,uBAAuB,CAAA;IACjC,MAAM,IAAI,8FAA8F,CAAA;IACxG,MAAM,IAAI,sFAAsF,CAAA;IAChG,MAAM,IAAI,oEAAoE,CAAA;IAC9E,MAAM,IAAI,gFAAgF,CAAA;IAE1F,8DAA8D;IAC9D,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,IAAI,sBAAsB,YAAY,IAAI,CAAA;IAClD,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/lib/notifications/dispatcher.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Notification Dispatcher
+ *
+ * Sends notifications through configured providers. Each provider type
+ * has a handler that formats and delivers the message.
+ *
+ * Handlers:
+ * - slack: POST to webhook URL
+ * - email: POST to SendGrid API
+ * - sms: POST to Twilio API
+ * - terminal: Write to stdout
+ * - browser_push: Placeholder (for prlt web dashboard)
+ */
+import type { NotificationProvider, NotificationContext, NotificationResult } from './types.js';
+declare function buildMessage(context: NotificationContext): string;
+/**
+ * Send a notification through a configured provider.
+ */
+export declare function dispatchNotification(provider: NotificationProvider, context: NotificationContext): Promise<NotificationResult>;
+/**
+ * Send notifications through multiple providers.
+ * Returns results for all providers (does not short-circuit on failure).
+ */
+export declare function dispatchNotifications(providers: NotificationProvider[], context: NotificationContext): Promise<NotificationResult[]>;
+/**
+ * Build a human-readable notification message from context.
+ * Exported for testing and reuse.
+ */
+export { buildMessage };

package/dist/lib/notifications/dispatcher.js

@@ -0,0 +1,281 @@
+/**
+ * Notification Dispatcher
+ *
+ * Sends notifications through configured providers. Each provider type
+ * has a handler that formats and delivers the message.
+ *
+ * Handlers:
+ * - slack: POST to webhook URL
+ * - email: POST to SendGrid API
+ * - sms: POST to Twilio API
+ * - terminal: Write to stdout
+ * - browser_push: Placeholder (for prlt web dashboard)
+ */
+// =============================================================================
+// Handlers
+// =============================================================================
+function buildMessage(context) {
+    const parts = [];
+    if (context.event)
+        parts.push(`[${context.event}]`);
+    if (context.ticket)
+        parts.push(`ticket=${context.ticket}`);
+    if (context.pr)
+        parts.push(`PR=#${context.pr}`);
+    if (context.agent)
+        parts.push(`agent=${context.agent}`);
+    if (context.branch)
+        parts.push(`branch=${context.branch}`);
+    if (context.message)
+        parts.push(context.message);
+    return parts.join(' ') || 'Notification';
+}
+const handleSlack = async (provider, context) => {
+    const start = Date.now();
+    const config = provider.config;
+    if (!config.webhook_url) {
+        return {
+            providerId: provider.id,
+            providerName: provider.name,
+            providerType: provider.type,
+            success: false,
+            error: 'No webhook_url configured',
+            durationMs: Date.now() - start,
+        };
+    }
+    try {
+        const message = buildMessage(context);
+        const payload = {
+            text: message,
+            ...(config.channel ? { channel: config.channel } : {}),
+            ...(config.username ? { username: config.username } : {}),
+        };
+        const response = await fetch(config.webhook_url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!response.ok) {
+            return {
+                providerId: provider.id,
+                providerName: provider.name,
+                providerType: provider.type,
+                success: false,
+                error: `Slack webhook returned ${response.status}: ${await response.text()}`,
+                durationMs: Date.now() - start,
+            };
+        }
+        return {
+            providerId: provider.id,
+            providerName: provider.name,
+            providerType: provider.type,
+            success: true,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        return {
+            providerId: provider.id,
+            providerName: provider.name,
+            providerType: provider.type,
+            success: false,
+            error: err instanceof Error ? err.message : String(err),
+            durationMs: Date.now() - start,
+        };
+    }
+};
+const handleEmail = async (provider, context) => {
+    const start = Date.now();
+    const config = provider.config;
+    if (!config.api_key || !config.from || !config.to?.length) {
+        return {
+            providerId: provider.id,
+            providerName: provider.name,
+            providerType: provider.type,
+            success: false,
+            error: 'Email provider requires api_key, from, and to fields',
+            durationMs: Date.now() - start,
+        };
+    }
+    try {
+        const message = buildMessage(context);
+        const subject = `[prlt] ${context.event || 'Notification'}`;
+        if (config.provider === 'sendgrid') {
+            const payload = {
+                personalizations: [{ to: config.to.map(email => ({ email })) }],
+                from: { email: config.from },
+                subject,
+                content: [{ type: 'text/plain', value: message }],
+            };
+            const response = await fetch('https://api.sendgrid.com/v3/mail/send', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${config.api_key}`,
+                },
+                body: JSON.stringify(payload),
+                signal: AbortSignal.timeout(10_000),
+            });
+            if (!response.ok) {
+                return {
+                    providerId: provider.id,
+                    providerName: provider.name,
+                    providerType: provider.type,
+                    success: false,
+                    error: `SendGrid returned ${response.status}`,
+                    durationMs: Date.now() - start,
+                };
+            }
+        }
+        else {
+            // SES — use AWS SDK-compatible HTTP call
+            // For now, log that SES requires aws-sdk and is not yet fully wired
+            return {
+                providerId: provider.id,
+                providerName: provider.name,
+                providerType: provider.type,
+                success: false,
+                error: 'SES provider requires AWS SDK — use SendGrid for now',
+                durationMs: Date.now() - start,
+            };
+        }
+        return {
+            providerId: provider.id,
+            providerName: provider.name,
+            providerType: provider.type,
+            success: true,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        return {
+            providerId: provider.id,
+            providerName: provider.name,
+            providerType: provider.type,
+            success: false,
+            error: err instanceof Error ? err.message : String(err),
+            durationMs: Date.now() - start,
+        };
+    }
+};
+const handleSms = async (provider, context) => {
+    const start = Date.now();
+    const config = provider.config;
+    if (!config.account_sid || !config.auth_token || !config.from || !config.to?.length) {
+        return {
+            providerId: provider.id,
+            providerName: provider.name,
+            providerType: provider.type,
+            success: false,
+            error: 'SMS provider requires account_sid, auth_token, from, and to fields',
+            durationMs: Date.now() - start,
+        };
+    }
+    try {
+        const message = buildMessage(context);
+        const results = [];
+        for (const to of config.to) {
+            const body = new URLSearchParams({ Body: message, From: config.from, To: to });
+            const response = await fetch(`https://api.twilio.com/2010-04-01/Accounts/${config.account_sid}/Messages.json`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    Authorization: `Basic ${Buffer.from(`${config.account_sid}:${config.auth_token}`).toString('base64')}`,
+                },
+                body: body.toString(),
+                signal: AbortSignal.timeout(10_000),
+            });
+            results.push(response.ok);
+        }
+        const allOk = results.every(Boolean);
+        return {
+            providerId: provider.id,
+            providerName: provider.name,
+            providerType: provider.type,
+            success: allOk,
+            error: allOk ? undefined : `Some SMS messages failed to send`,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        return {
+            providerId: provider.id,
+            providerName: provider.name,
+            providerType: provider.type,
+            success: false,
+            error: err instanceof Error ? err.message : String(err),
+            durationMs: Date.now() - start,
+        };
+    }
+};
+const handleTerminal = async (provider, context) => {
+    const start = Date.now();
+    const config = provider.config;
+    const prefix = config.prefix || '[prlt:notify]';
+    const message = buildMessage(context);
+    // eslint-disable-next-line no-console
+    console.log(`${prefix} ${message}`);
+    return {
+        providerId: provider.id,
+        providerName: provider.name,
+        providerType: provider.type,
+        success: true,
+        durationMs: Date.now() - start,
+    };
+};
+const handleBrowserPush = async (provider, _context) => {
+    const start = Date.now();
+    // Browser push requires the prlt web dashboard to be running.
+    // This is a placeholder that succeeds silently when no endpoint is configured.
+    return {
+        providerId: provider.id,
+        providerName: provider.name,
+        providerType: provider.type,
+        success: true,
+        durationMs: Date.now() - start,
+    };
+};
+// =============================================================================
+// Handler Registry
+// =============================================================================
+const HANDLERS = {
+    slack: handleSlack,
+    email: handleEmail,
+    sms: handleSms,
+    terminal: handleTerminal,
+    browser_push: handleBrowserPush,
+};
+// =============================================================================
+// Dispatcher
+// =============================================================================
+/**
+ * Send a notification through a configured provider.
+ */
+export async function dispatchNotification(provider, context) {
+    const handler = HANDLERS[provider.type];
+    if (!handler) {
+        return {
+            providerId: provider.id,
+            providerName: provider.name,
+            providerType: provider.type,
+            success: false,
+            error: `Unknown provider type: ${provider.type}`,
+            durationMs: 0,
+        };
+    }
+    return handler(provider, context);
+}
+/**
+ * Send notifications through multiple providers.
+ * Returns results for all providers (does not short-circuit on failure).
+ */
+export async function dispatchNotifications(providers, context) {
+    return Promise.all(providers.map(p => dispatchNotification(p, context)));
+}
+/**
+ * Build a human-readable notification message from context.
+ * Exported for testing and reuse.
+ */
+export { buildMessage };
+//# sourceMappingURL=dispatcher.js.map

package/dist/lib/notifications/dispatcher.js.map

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

package/dist/lib/notifications/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Notification Layer
+ *
+ * Outbound notification system for daemon events, hook actions, and escalations.
+ *
+ * Providers: Slack, Email (SendGrid/SES), SMS (Twilio), Terminal, Browser Push
+ * Escalation: Configurable timeout-based escalation chains
+ * Storage: Workspace DB (not YAML), shareable across machines
+ */
+export { type NotificationProviderType, type NotificationProvider, type NotificationRule, type NotificationContext, type NotificationResult, type ProviderConfig, type SlackProviderConfig, type EmailProviderConfig, type SmsProviderConfig, type TerminalProviderConfig, type BrowserPushProviderConfig, type NotificationEvent, type EscalationStep, type ActiveEscalation, NOTIFICATION_PROVIDER_TYPES, } from './types.js';
+export { NotificationStorage } from './storage.js';
+export { dispatchNotification, dispatchNotifications, buildMessage, } from './dispatcher.js';
+export { NotificationManager, type NotificationManagerOptions, initNotificationManager, getNotificationManager, stopNotificationManager, } from './manager.js';

package/dist/lib/notifications/index.js

@@ -0,0 +1,18 @@
+/**
+ * Notification Layer
+ *
+ * Outbound notification system for daemon events, hook actions, and escalations.
+ *
+ * Providers: Slack, Email (SendGrid/SES), SMS (Twilio), Terminal, Browser Push
+ * Escalation: Configurable timeout-based escalation chains
+ * Storage: Workspace DB (not YAML), shareable across machines
+ */
+// Types
+export { NOTIFICATION_PROVIDER_TYPES, } from './types.js';
+// Storage
+export { NotificationStorage } from './storage.js';
+// Dispatcher
+export { dispatchNotification, dispatchNotifications, buildMessage, } from './dispatcher.js';
+// Manager
+export { NotificationManager, initNotificationManager, getNotificationManager, stopNotificationManager, } from './manager.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,QAAQ;AACR,OAAO,EAeL,2BAA2B,GAC5B,MAAM,YAAY,CAAA;AAEnB,UAAU;AACV,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,aAAa;AACb,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,GACb,MAAM,iBAAiB,CAAA;AAExB,UAAU;AACV,OAAO,EACL,mBAAmB,EAEnB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,cAAc,CAAA"}

package/dist/lib/notifications/manager.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Notification Manager
+ *
+ * Integrates with the EventBus and hook system to dispatch notifications.
+ * Subscribes to hookable events, looks up notification rules, and dispatches
+ * through configured providers. Manages escalation chains with timeout-based
+ * escalation (e.g., Slack first, SMS after 10min, email after 30min).
+ */
+import type Database from 'better-sqlite3';
+import type { NotificationContext, NotificationResult, ActiveEscalation } from './types.js';
+export interface NotificationManagerOptions {
+    db: Database.Database;
+    log?: (msg: string) => void;
+}
+export declare class NotificationManager {
+    private storage;
+    private log;
+    private unsubscribers;
+    private activeEscalations;
+    constructor(options: NotificationManagerOptions);
+    /**
+     * Start listening to events on the EventBus.
+     * Dynamically imports event-bus to avoid circular dependency at module load.
+     */
+    start(): Promise<void>;
+    /** Stop listening and clear all escalation timers. */
+    stop(): void;
+    /**
+     * Manually fire a notification for an event.
+     * Returns results for all matched rules.
+     */
+    fireEvent(event: string, context: NotificationContext): Promise<NotificationResult[]>;
+    /**
+     * Acknowledge an escalation chain (stops further escalation).
+     */
+    acknowledgeEscalation(group: string): boolean;
+    /** Get active escalation chains. */
+    getActiveEscalations(): ActiveEscalation[];
+    private handleEvent;
+    private startEscalationChain;
+    private executeEscalationStep;
+    private normalizeContext;
+}
+export declare function initNotificationManager(options: NotificationManagerOptions): NotificationManager;
+export declare function getNotificationManager(): NotificationManager | null;
+export declare function stopNotificationManager(): void;