@iflow-mcp/jkheadley-instar 0.26.2

package/dist/messaging/GitSyncTransport.d.ts

@@ -0,0 +1,120 @@
+/**
+ * GitSyncTransport — offline cross-machine messaging via git-sync.
+ *
+ * Per Phase 4 of INTER-AGENT-MESSAGING-SPEC v3.1:
+ * - Picks up inbound messages from git-synced outbound directories
+ * - Manages outbound queue cleanup after successful relay
+ * - Verifies Ed25519 signatures on inbound cross-machine messages
+ * - Deduplicates against already-received messages
+ * - Provides outbound queue status for monitoring
+ *
+ * Directory layout:
+ *   ~/.instar/messages/outbound/{targetMachineId}/{messageId}.json  — outgoing
+ *   .instar/messages/outbound/{localMachineId}/{messageId}.json     — incoming (via git-sync)
+ *
+ * After git-sync, a remote machine's outbound/{localMachineId}/ directory
+ * appears in our local repo. We scan it, verify signatures, ingest valid
+ * messages, and remove processed files.
+ */
+import type { MessageEnvelope } from './types.js';
+import type { MessageStore } from './MessageStore.js';
+export interface GitSyncPickupResult {
+    /** Number of messages successfully ingested */
+    ingested: number;
+    /** Number of messages rejected (invalid signature, bad format, etc.) */
+    rejected: number;
+    /** Number of messages skipped (already in store — dedup) */
+    duplicates: number;
+    /** Details of rejected messages */
+    rejections: Array<{
+        file: string;
+        reason: string;
+    }>;
+}
+export interface OutboundQueueStatus {
+    /** Messages per target machine */
+    queues: Array<{
+        targetMachine: string;
+        messageCount: number;
+        oldestAt: string | null;
+        newestAt: string | null;
+    }>;
+    /** Total messages awaiting delivery */
+    totalPending: number;
+}
+export interface GitSyncTransportConfig {
+    /** Local machine ID (to locate inbound directory) */
+    localMachineId: string;
+    /** Path to the project's .instar directory (for inbound scan) */
+    stateDir: string;
+    /** The message store to ingest into */
+    store: MessageStore;
+    /** Verify Ed25519 signature on an envelope. Returns true if valid. */
+    verifySignature?: (envelope: MessageEnvelope) => {
+        valid: true;
+    } | {
+        valid: false;
+        reason: string;
+    };
+}
+/**
+ * Scan the git-synced outbound directory for inbound messages and ingest them.
+ *
+ * After git-sync, remote machines' outbound/{localMachineId}/ directories
+ * appear in our local project repo. We scan each one, verify signatures,
+ * dedup against existing store, and ingest valid messages.
+ *
+ * The outbound directories in the PROJECT (not home dir) are the inbound path
+ * after git-sync. The home dir outbound is for messages WE are sending.
+ */
+export declare function pickupGitSyncMessages(config: GitSyncTransportConfig): Promise<GitSyncPickupResult>;
+/**
+ * Get the status of the outbound queue (messages waiting for relay/git-sync).
+ *
+ * Scans ~/.instar/messages/outbound/ for per-machine subdirectories.
+ */
+export declare function getOutboundQueueStatus(): OutboundQueueStatus;
+/**
+ * Clean up delivered messages from the outbound queue.
+ *
+ * After a successful real-time relay, the outbound copy should be removed
+ * to prevent re-delivery on the next git-sync.
+ */
+export declare function cleanupDeliveredOutbound(targetMachine: string, messageId: string): boolean;
+/**
+ * Scan all outbound directories and clean up messages that have been
+ * successfully delivered (exist in the local store with phase 'delivered' or 'acknowledged').
+ */
+export declare function cleanupAllDelivered(store: MessageStore): Promise<number>;
+export interface AgentInfo {
+    /** Agent name */
+    name: string;
+    /** Server port */
+    port: number;
+    /** Current status */
+    status: 'running' | 'stopped' | 'stale';
+}
+export interface HeartbeatAgentExtension {
+    /** List of agents running on this machine */
+    agents: AgentInfo[];
+}
+/**
+ * Build the agent list for heartbeat extensions.
+ * Reads from the machine-wide agent registry.
+ */
+export declare function buildAgentList(): AgentInfo[];
+/**
+ * Resolve which machine an agent is on by scanning received heartbeat data.
+ *
+ * Returns the machine ID and URL if the agent is found in any heartbeat's agent list,
+ * or null if not found.
+ */
+export declare function resolveAgentMachine(agentName: string, heartbeats: Map<string, {
+    agents?: AgentInfo[];
+    url?: string;
+}>): {
+    machineId: string;
+    url: string;
+    port: number;
+} | null;
+//# sourceMappingURL=GitSyncTransport.d.ts.map

package/dist/messaging/GitSyncTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitSyncTransport.d.ts","sourceRoot":"","sources":["../../src/messaging/GitSyncTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,MAAM,EAAE,KAAK,CAAC;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC,CAAC;IACH,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,KAAK,EAAE,YAAY,CAAC;IACpB,sEAAsE;IACtE,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK;QAAE,KAAK,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACrG;AAID;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAmG9B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAoD5D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAeT;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAsC9E;AAID,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAqB5C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9D;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASzD"}

package/dist/messaging/GitSyncTransport.js

@@ -0,0 +1,296 @@
+/**
+ * GitSyncTransport — offline cross-machine messaging via git-sync.
+ *
+ * Per Phase 4 of INTER-AGENT-MESSAGING-SPEC v3.1:
+ * - Picks up inbound messages from git-synced outbound directories
+ * - Manages outbound queue cleanup after successful relay
+ * - Verifies Ed25519 signatures on inbound cross-machine messages
+ * - Deduplicates against already-received messages
+ * - Provides outbound queue status for monitoring
+ *
+ * Directory layout:
+ *   ~/.instar/messages/outbound/{targetMachineId}/{messageId}.json  — outgoing
+ *   .instar/messages/outbound/{localMachineId}/{messageId}.json     — incoming (via git-sync)
+ *
+ * After git-sync, a remote machine's outbound/{localMachineId}/ directory
+ * appears in our local repo. We scan it, verify signatures, ingest valid
+ * messages, and remove processed files.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+// ── Implementation ──────────────────────────────────────────────
+/**
+ * Scan the git-synced outbound directory for inbound messages and ingest them.
+ *
+ * After git-sync, remote machines' outbound/{localMachineId}/ directories
+ * appear in our local project repo. We scan each one, verify signatures,
+ * dedup against existing store, and ingest valid messages.
+ *
+ * The outbound directories in the PROJECT (not home dir) are the inbound path
+ * after git-sync. The home dir outbound is for messages WE are sending.
+ */
+export async function pickupGitSyncMessages(config) {
+    // Inbound path: {stateDir}/messages/outbound/{localMachineId}/
+    const inboundDir = path.join(config.stateDir, 'messages', 'outbound', config.localMachineId);
+    const result = {
+        ingested: 0,
+        rejected: 0,
+        duplicates: 0,
+        rejections: [],
+    };
+    if (!fs.existsSync(inboundDir)) {
+        return result;
+    }
+    let files;
+    try {
+        files = fs.readdirSync(inboundDir).filter(f => f.endsWith('.json'));
+    }
+    catch {
+        // @silent-fallback-ok — directory not readable, nothing to process
+        return result;
+    }
+    for (const file of files) {
+        const filePath = path.join(inboundDir, file);
+        try {
+            const raw = fs.readFileSync(filePath, 'utf-8');
+            const envelope = JSON.parse(raw);
+            // Validate envelope structure
+            if (!envelope?.message?.id || !envelope?.transport || !envelope?.delivery) {
+                result.rejected++;
+                result.rejections.push({ file, reason: 'invalid envelope structure' });
+                unlinkSafe(filePath);
+                continue;
+            }
+            // Deduplication: skip if already in store (may have arrived via real-time relay first)
+            if (await config.store.exists(envelope.message.id)) {
+                result.duplicates++;
+                unlinkSafe(filePath);
+                continue;
+            }
+            // Verify Ed25519 signature if verifier is provided
+            if (config.verifySignature) {
+                const sigResult = config.verifySignature(envelope);
+                if (!sigResult.valid) {
+                    result.rejected++;
+                    result.rejections.push({ file, reason: `invalid signature: ${sigResult.reason}` });
+                    unlinkSafe(filePath);
+                    continue;
+                }
+            }
+            else if (!envelope.transport.signature) {
+                // No verifier and no signature — reject (cross-machine messages must be signed)
+                result.rejected++;
+                result.rejections.push({ file, reason: 'missing signature (cross-machine messages require Ed25519)' });
+                unlinkSafe(filePath);
+                continue;
+            }
+            // Check TTL — don't ingest expired messages
+            if (envelope.message.ttlMinutes) {
+                const sentAt = new Date(envelope.delivery.transitions[0]?.at || envelope.transport.timestamp).getTime();
+                const ttlMs = envelope.message.ttlMinutes * 60_000;
+                if (Date.now() - sentAt > ttlMs) {
+                    result.rejected++;
+                    result.rejections.push({ file, reason: `TTL expired (${envelope.message.ttlMinutes}min)` });
+                    unlinkSafe(filePath);
+                    continue;
+                }
+            }
+            // Update delivery phase to 'received'
+            const now = new Date().toISOString();
+            envelope.delivery = {
+                ...envelope.delivery,
+                phase: 'received',
+                transitions: [
+                    ...envelope.delivery.transitions,
+                    { from: envelope.delivery.phase, to: 'received', at: now, reason: 'picked up from git-sync' },
+                ],
+            };
+            // Ingest into store
+            await config.store.save(envelope);
+            result.ingested++;
+            // Clean up processed file
+            unlinkSafe(filePath);
+        }
+        catch {
+            // @silent-fallback-ok — malformed file, skip it
+            result.rejected++;
+            result.rejections.push({ file, reason: 'parse error or I/O failure' });
+            unlinkSafe(filePath);
+        }
+    }
+    return result;
+}
+/**
+ * Get the status of the outbound queue (messages waiting for relay/git-sync).
+ *
+ * Scans ~/.instar/messages/outbound/ for per-machine subdirectories.
+ */
+export function getOutboundQueueStatus() {
+    const outboundBase = path.join(os.homedir(), '.instar', 'messages', 'outbound');
+    const queues = [];
+    let totalPending = 0;
+    if (!fs.existsSync(outboundBase)) {
+        return { queues, totalPending };
+    }
+    let dirs;
+    try {
+        dirs = fs.readdirSync(outboundBase, { withFileTypes: true })
+            .filter(d => d.isDirectory())
+            .map(d => d.name);
+    }
+    catch {
+        // @silent-fallback-ok — outbound dir not readable
+        return { queues, totalPending };
+    }
+    for (const machineDir of dirs) {
+        const machinePath = path.join(outboundBase, machineDir);
+        try {
+            const files = fs.readdirSync(machinePath).filter(f => f.endsWith('.json'));
+            if (files.length === 0)
+                continue;
+            let oldest = null;
+            let newest = null;
+            for (const file of files) {
+                try {
+                    const stat = fs.statSync(path.join(machinePath, file));
+                    const mtime = stat.mtime.toISOString();
+                    if (!oldest || mtime < oldest)
+                        oldest = mtime;
+                    if (!newest || mtime > newest)
+                        newest = mtime;
+                }
+                catch {
+                    // @silent-fallback-ok — stat failure on single file
+                }
+            }
+            queues.push({
+                targetMachine: machineDir,
+                messageCount: files.length,
+                oldestAt: oldest,
+                newestAt: newest,
+            });
+            totalPending += files.length;
+        }
+        catch {
+            // @silent-fallback-ok — machine dir not readable
+        }
+    }
+    return { queues, totalPending };
+}
+/**
+ * Clean up delivered messages from the outbound queue.
+ *
+ * After a successful real-time relay, the outbound copy should be removed
+ * to prevent re-delivery on the next git-sync.
+ */
+export function cleanupDeliveredOutbound(targetMachine, messageId) {
+    const outboundPath = path.join(os.homedir(), '.instar', 'messages', 'outbound', targetMachine, `${messageId}.json`);
+    try {
+        if (fs.existsSync(outboundPath)) {
+            fs.unlinkSync(outboundPath);
+            return true;
+        }
+        return false;
+    }
+    catch {
+        // @silent-fallback-ok — cleanup failure is non-critical
+        return false;
+    }
+}
+/**
+ * Scan all outbound directories and clean up messages that have been
+ * successfully delivered (exist in the local store with phase 'delivered' or 'acknowledged').
+ */
+export async function cleanupAllDelivered(store) {
+    const outboundBase = path.join(os.homedir(), '.instar', 'messages', 'outbound');
+    let cleaned = 0;
+    if (!fs.existsSync(outboundBase))
+        return 0;
+    let dirs;
+    try {
+        dirs = fs.readdirSync(outboundBase, { withFileTypes: true })
+            .filter(d => d.isDirectory())
+            .map(d => d.name);
+    }
+    catch {
+        // @silent-fallback-ok — outbound dir not readable
+        return 0;
+    }
+    for (const machineDir of dirs) {
+        const machinePath = path.join(outboundBase, machineDir);
+        try {
+            const files = fs.readdirSync(machinePath).filter(f => f.endsWith('.json'));
+            for (const file of files) {
+                const messageId = file.replace('.json', '');
+                try {
+                    const envelope = await store.get(messageId);
+                    if (envelope && (envelope.delivery.phase === 'delivered' || envelope.delivery.phase === 'read')) {
+                        fs.unlinkSync(path.join(machinePath, file));
+                        cleaned++;
+                    }
+                }
+                catch {
+                    // @silent-fallback-ok — individual file cleanup failure
+                }
+            }
+        }
+        catch {
+            // @silent-fallback-ok — directory read failure
+        }
+    }
+    return cleaned;
+}
+/**
+ * Build the agent list for heartbeat extensions.
+ * Reads from the machine-wide agent registry.
+ */
+export function buildAgentList() {
+    const registryPath = path.join(os.homedir(), '.instar', 'registry.json');
+    try {
+        if (!fs.existsSync(registryPath))
+            return [];
+        const raw = fs.readFileSync(registryPath, 'utf-8');
+        const registry = JSON.parse(raw);
+        if (!registry?.agents || !Array.isArray(registry.agents))
+            return [];
+        return registry.agents
+            .filter((a) => a.status === 'running' || a.status === 'registered')
+            .map((a) => ({
+            name: a.name,
+            port: a.port ?? 0,
+            status: a.status === 'running' ? 'running' : 'stale',
+        }));
+    }
+    catch {
+        // @silent-fallback-ok — registry read failure
+        return [];
+    }
+}
+/**
+ * Resolve which machine an agent is on by scanning received heartbeat data.
+ *
+ * Returns the machine ID and URL if the agent is found in any heartbeat's agent list,
+ * or null if not found.
+ */
+export function resolveAgentMachine(agentName, heartbeats) {
+    for (const [machineId, hb] of heartbeats) {
+        if (!hb.agents)
+            continue;
+        const agent = hb.agents.find(a => a.name === agentName && a.status === 'running');
+        if (agent && hb.url) {
+            return { machineId, url: hb.url, port: agent.port };
+        }
+    }
+    return null;
+}
+// ── Helpers ─────────────────────────────────────────────────────
+function unlinkSafe(filePath) {
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch {
+        // @silent-fallback-ok — cleanup failure is non-critical
+    }
+}
+//# sourceMappingURL=GitSyncTransport.js.map

package/dist/messaging/GitSyncTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitSyncTransport.js","sourceRoot":"","sources":["../../src/messaging/GitSyncTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAwC7B,mEAAmE;AAEnE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAA8B;IAE9B,+DAA+D;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAE7F,MAAM,MAAM,GAAwB;QAClC,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,EAAE;KACf,CAAC;IAEF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;QACnE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAoB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAElD,8BAA8B;YAC9B,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;gBAC1E,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAClB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC,CAAC;gBACvE,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,uFAAuF;YACvF,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;gBACnD,MAAM,CAAC,UAAU,EAAE,CAAC;gBACpB,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,mDAAmD;YACnD,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;gBACnD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;oBACrB,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAClB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,sBAAsB,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBACnF,UAAU,CAAC,QAAQ,CAAC,CAAC;oBACrB,SAAS;gBACX,CAAC;YACH,CAAC;iBAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;gBACzC,gFAAgF;gBAChF,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAClB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,4DAA4D,EAAE,CAAC,CAAC;gBACvG,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,4CAA4C;YAC5C,IAAI,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;gBACxG,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC;gBACnD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC;oBAChC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAClB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,QAAQ,CAAC,OAAO,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;oBAC5F,UAAU,CAAC,QAAQ,CAAC,CAAC;oBACrB,SAAS;gBACX,CAAC;YACH,CAAC;YAED,sCAAsC;YACtC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,QAAQ,CAAC,QAAQ,GAAG;gBAClB,GAAG,QAAQ,CAAC,QAAQ;gBACpB,KAAK,EAAE,UAAU;gBACjB,WAAW,EAAE;oBACX,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW;oBAChC,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,yBAAyB,EAAE;iBAC9F;aACF,CAAC;YAEF,oBAAoB;YACpB,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAElB,0BAA0B;YAC1B,UAAU,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,gDAAgD;YAChD,MAAM,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC,CAAC;YACvE,UAAU,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAChF,MAAM,MAAM,GAAkC,EAAE,CAAC;IACjD,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACzD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;QAClD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEjC,IAAI,MAAM,GAAkB,IAAI,CAAC;YACjC,IAAI,MAAM,GAAkB,IAAI,CAAC;YAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;oBACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;oBACvC,IAAI,CAAC,MAAM,IAAI,KAAK,GAAG,MAAM;wBAAE,MAAM,GAAG,KAAK,CAAC;oBAC9C,IAAI,CAAC,MAAM,IAAI,KAAK,GAAG,MAAM;wBAAE,MAAM,GAAG,KAAK,CAAC;gBAChD,CAAC;gBAAC,MAAM,CAAC;oBACP,oDAAoD;gBACtD,CAAC;YACH,CAAC;YAED,MAAM,CAAC,IAAI,CAAC;gBACV,aAAa,EAAE,UAAU;gBACzB,YAAY,EAAE,KAAK,CAAC,MAAM;gBAC1B,QAAQ,EAAE,MAAM;gBAChB,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;YACH,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;QACnD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,aAAqB,EACrB,SAAiB;IAEjB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC5B,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,SAAS,OAAO,CACpF,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAmB;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAChF,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,CAAC,CAAC;IAE3C,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACzD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;QAClD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC5C,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAC5C,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,KAAK,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC,EAAE,CAAC;wBAChG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;wBAC5C,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,wDAAwD;gBAC1D,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAkBD;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpE,OAAO,QAAQ,CAAC,MAAM;aACnB,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC;aACvE,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;YACjB,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAkB,CAAC,CAAC,CAAC,OAAgB;SACvE,CAAC,CAAC,CAAC;IACR,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;QAC9C,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,UAA+D;IAE/D,KAAK,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;QACzC,IAAI,CAAC,EAAE,CAAC,MAAM;YAAE,SAAS;QACzB,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAClF,IAAI,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC;YACpB,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mEAAmE;AAEnE,SAAS,UAAU,CAAC,QAAgB;IAClC,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;IAC1D,CAAC;AACH,CAAC"}

package/dist/messaging/MessageDelivery.d.ts

@@ -0,0 +1,27 @@
+/**
+ * MessageDelivery — safe tmux message injection.
+ *
+ * Checks injection safety (process whitelist, human input detection,
+ * context budget) before delivering messages to Claude sessions via
+ * tmux send-keys. Implements per-session delivery mutex for FIFO ordering.
+ */
+import type { MessageEnvelope, AgentMessage, InjectionSafety, IMessageDelivery, DeliveryResult, MessageThread } from './types.js';
+import { MessageFormatter } from './MessageFormatter.js';
+/** Interface for tmux operations — injectable for testing */
+export interface TmuxOperations {
+    getForegroundProcess(tmuxSession: string): string;
+    isSessionAlive(tmuxSession: string): boolean;
+    hasActiveHumanInput(tmuxSession: string): boolean;
+    sendKeys(tmuxSession: string, text: string): boolean;
+    getOutputLineCount(tmuxSession: string): number;
+}
+export declare class MessageDelivery implements IMessageDelivery {
+    private readonly formatter;
+    private readonly tmux;
+    constructor(formatter: MessageFormatter, tmux: TmuxOperations);
+    checkInjectionSafety(tmuxSession: string): Promise<InjectionSafety>;
+    deliverToSession(sessionId: string, envelope: MessageEnvelope): Promise<DeliveryResult>;
+    formatInline(message: AgentMessage, threadContext?: MessageThread): string;
+    formatPointer(message: AgentMessage): string;
+}
+//# sourceMappingURL=MessageDelivery.d.ts.map

package/dist/messaging/MessageDelivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageDelivery.d.ts","sourceRoot":"","sources":["../../src/messaging/MessageDelivery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAClD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7C,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACrD,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;CACjD;AAKD,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;gBAE1B,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc;IAKvD,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAenE,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IA2D7F,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM;IAI1E,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;CAG7C"}

package/dist/messaging/MessageDelivery.js

@@ -0,0 +1,90 @@
+/**
+ * MessageDelivery — safe tmux message injection.
+ *
+ * Checks injection safety (process whitelist, human input detection,
+ * context budget) before delivering messages to Claude sessions via
+ * tmux send-keys. Implements per-session delivery mutex for FIFO ordering.
+ */
+import { ALLOWED_INJECTION_PROCESSES } from './types.js';
+/** Context budget threshold — if output exceeds this many lines, use pointer delivery */
+const CONTEXT_LINE_THRESHOLD = 10_000;
+export class MessageDelivery {
+    formatter;
+    tmux;
+    constructor(formatter, tmux) {
+        this.formatter = formatter;
+        this.tmux = tmux;
+    }
+    async checkInjectionSafety(tmuxSession) {
+        const foregroundProcess = this.tmux.getForegroundProcess(tmuxSession);
+        const isSafeProcess = ALLOWED_INJECTION_PROCESSES.includes(foregroundProcess);
+        const hasHumanInput = this.tmux.hasActiveHumanInput(tmuxSession);
+        const lineCount = this.tmux.getOutputLineCount(tmuxSession);
+        const contextBudgetExceeded = lineCount > CONTEXT_LINE_THRESHOLD;
+        return {
+            foregroundProcess,
+            isSafeProcess,
+            hasHumanInput,
+            contextBudgetExceeded,
+        };
+    }
+    async deliverToSession(sessionId, envelope) {
+        // Step 1: Is the session alive?
+        if (!this.tmux.isSessionAlive(sessionId)) {
+            return {
+                success: false,
+                phase: 'queued',
+                failureReason: 'Session not alive',
+                shouldRetry: true,
+            };
+        }
+        // Step 2: Check injection safety
+        const safety = await this.checkInjectionSafety(sessionId);
+        if (!safety.isSafeProcess) {
+            return {
+                success: false,
+                phase: 'queued',
+                failureReason: `Unsafe foreground process: ${safety.foregroundProcess}`,
+                shouldRetry: true,
+            };
+        }
+        if (safety.hasHumanInput) {
+            return {
+                success: false,
+                phase: 'queued',
+                failureReason: 'Human input detected',
+                shouldRetry: true,
+            };
+        }
+        // Step 3: Format the message
+        let formatted;
+        if (safety.contextBudgetExceeded && envelope.message.body.length > 1024) {
+            formatted = this.formatter.formatPointer(envelope.message);
+        }
+        else {
+            formatted = this.formatter.formatInline(envelope.message);
+        }
+        // Step 4: Inject via tmux send-keys
+        const success = this.tmux.sendKeys(sessionId, formatted);
+        if (!success) {
+            return {
+                success: false,
+                phase: 'queued',
+                failureReason: 'tmux send-keys failed',
+                shouldRetry: true,
+            };
+        }
+        return {
+            success: true,
+            phase: 'delivered',
+            shouldRetry: false,
+        };
+    }
+    formatInline(message, threadContext) {
+        return this.formatter.formatInline(message, threadContext);
+    }
+    formatPointer(message) {
+        return this.formatter.formatPointer(message);
+    }
+}
+//# sourceMappingURL=MessageDelivery.js.map

package/dist/messaging/MessageDelivery.js.map

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

package/dist/messaging/MessageFormatter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * MessageFormatter — formats messages for tmux delivery.
+ *
+ * Produces formatted text blocks that are injected into Claude sessions
+ * via tmux send-keys. Handles inline delivery, pointer delivery (context-limited),
+ * and delimiter sanitization to prevent injection attacks.
+ */
+import type { AgentMessage, MessageThread } from './types.js';
+export declare class MessageFormatter {
+    /**
+     * Format a message for inline delivery (standard case).
+     * Includes full body, reply/ack instructions, and optional thread context.
+     */
+    formatInline(message: AgentMessage, thread?: MessageThread): string;
+    /**
+     * Format a message as a pointer (context-limited delivery).
+     * Shows subject and commands but not the full body.
+     */
+    formatPointer(message: AgentMessage): string;
+    /**
+     * Sanitize message content to prevent delimiter injection.
+     * Strips patterns that could mimic our message format.
+     */
+    private sanitize;
+    /**
+     * Truncate subject to MAX_SUBJECT_LENGTH.
+     */
+    private truncateSubject;
+}
+//# sourceMappingURL=MessageFormatter.d.ts.map

package/dist/messaging/MessageFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageFormatter.d.ts","sourceRoot":"","sources":["../../src/messaging/MessageFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAO9D,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM;IA+CnE;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;IAmB5C;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACH,OAAO,CAAC,eAAe;CAIxB"}