@iflow-mcp/jkheadley-instar 0.26.2

package/dist/core/PlatformActivityRegistry.js

@@ -0,0 +1,307 @@
+/**
+ * PlatformActivityRegistry — Durable, file-based record of external platform actions.
+ *
+ * Born from a blindspot in Dawn's Portal project: activity caches (x-activity.json, etc.)
+ * were incomplete because recording was manual and ephemeral sessions could skip it.
+ * The fix was an append-only JSONL event log that survives session death, with query
+ * methods for duplicate detection and session injection.
+ *
+ * This module gives every Instar agent the same capability:
+ *   1. Append-only JSONL log (`platform-activity.jsonl`) — survives crashes and session death
+ *   2. Query by platform, time window, session, action type
+ *   3. Duplicate detection — "was this already posted?" before publishing
+ *   4. Compact summary generation for session context injection
+ *
+ * File locking: Uses proper-lockfile for concurrent safety when multiple sessions
+ * may record actions simultaneously.
+ *
+ * Integration: Optionally links to CanonicalState to auto-update quick-facts
+ * about recent platform activity.
+ *
+ * Storage: {stateDir}/platform-activity.jsonl
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import lockfile from 'proper-lockfile';
+import { maybeRotateJsonl } from '../utils/jsonl-rotation.js';
+// ── Constants ────────────────────────────────────────────────────────
+const ACTIVITY_FILE = 'platform-activity.jsonl';
+const DEFAULT_DUPLICATE_WINDOW_HOURS = 48;
+const LOCK_OPTIONS = {
+    stale: 10000, // 10s — lockfiles older than this are considered stale
+    retries: {
+        retries: 3,
+        minTimeout: 100,
+        maxTimeout: 1000,
+    },
+};
+// ── PlatformActivityRegistry ─────────────────────────────────────────
+export class PlatformActivityRegistry {
+    stateDir;
+    activityFile;
+    canonicalState;
+    rotateAfterHours;
+    constructor(config) {
+        this.stateDir = config.stateDir;
+        this.activityFile = path.join(config.stateDir, ACTIVITY_FILE);
+        this.canonicalState = config.canonicalState;
+        this.rotateAfterHours = config.rotateAfterHours;
+        // Ensure state directory exists
+        if (!fs.existsSync(this.stateDir)) {
+            fs.mkdirSync(this.stateDir, { recursive: true });
+        }
+    }
+    // ── Recording ───────────────────────────────────────────────────────
+    /**
+     * Record a platform action to the append-only JSONL log.
+     *
+     * Uses file locking for concurrent safety. If the lock cannot be acquired,
+     * falls back to direct append (append is atomic on most filesystems for
+     * small writes).
+     *
+     * Optionally updates CanonicalState quick-facts with latest activity summary.
+     */
+    async record(action) {
+        const entry = {
+            timestamp: action.timestamp ?? new Date().toISOString(),
+            platform: action.platform,
+            type: action.type,
+            summary: action.summary,
+            sessionId: action.sessionId,
+            contentId: action.contentId,
+            url: action.url,
+            status: action.status,
+            metadata: action.metadata,
+        };
+        const line = JSON.stringify(entry) + '\n';
+        // Ensure file exists before locking (proper-lockfile needs it)
+        if (!fs.existsSync(this.activityFile)) {
+            fs.writeFileSync(this.activityFile, '');
+        }
+        maybeRotateJsonl(this.activityFile);
+        try {
+            const release = await lockfile.lock(this.activityFile, LOCK_OPTIONS);
+            try {
+                fs.appendFileSync(this.activityFile, line);
+            }
+            finally {
+                await release();
+            }
+        }
+        catch {
+            // @silent-fallback-ok — lock contention fallback; appendFileSync is atomic for small writes
+            fs.appendFileSync(this.activityFile, line);
+        }
+        // Update canonical state if linked
+        this.updateCanonicalState(entry);
+        return entry;
+    }
+    /**
+     * Record a platform action synchronously.
+     *
+     * For use in sync contexts (hooks, CLI commands). No file locking —
+     * relies on appendFileSync atomicity for small writes.
+     */
+    recordSync(action) {
+        const entry = {
+            timestamp: action.timestamp ?? new Date().toISOString(),
+            platform: action.platform,
+            type: action.type,
+            summary: action.summary,
+            sessionId: action.sessionId,
+            contentId: action.contentId,
+            url: action.url,
+            status: action.status,
+            metadata: action.metadata,
+        };
+        const line = JSON.stringify(entry) + '\n';
+        // Ensure directory exists
+        const dir = path.dirname(this.activityFile);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        maybeRotateJsonl(this.activityFile);
+        fs.appendFileSync(this.activityFile, line);
+        // Update canonical state if linked
+        this.updateCanonicalState(entry);
+        return entry;
+    }
+    // ── Querying ────────────────────────────────────────────────────────
+    /**
+     * Query platform actions with filters.
+     *
+     * Returns entries sorted most-recent-first. All filters are AND-combined.
+     */
+    query(opts) {
+        let entries = this.readLines();
+        if (opts?.platform) {
+            entries = entries.filter(e => e.platform === opts.platform);
+        }
+        if (opts?.type) {
+            entries = entries.filter(e => e.type === opts.type);
+        }
+        if (opts?.sessionId) {
+            entries = entries.filter(e => e.sessionId === opts.sessionId);
+        }
+        if (opts?.status) {
+            entries = entries.filter(e => e.status === opts.status);
+        }
+        if (opts?.since) {
+            entries = entries.filter(e => e.timestamp >= opts.since);
+        }
+        if (opts?.before) {
+            entries = entries.filter(e => e.timestamp < opts.before);
+        }
+        // Most recent first
+        entries.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+        if (opts?.limit) {
+            entries = entries.slice(0, opts.limit);
+        }
+        return entries;
+    }
+    // ── Duplicate Detection ─────────────────────────────────────────────
+    /**
+     * Check if similar content was already posted to a platform within a time window.
+     *
+     * Uses case-insensitive substring matching on the summary field. This catches
+     * exact duplicates and near-duplicates where the summary is reused.
+     *
+     * @param platform - Platform to check (e.g., 'x', 'reddit')
+     * @param contentSummary - Summary text to check for duplicates
+     * @param windowHours - How far back to look (default: 48 hours)
+     * @returns The matching action if found, or null
+     */
+    wasAlreadyPosted(platform, contentSummary, windowHours = DEFAULT_DUPLICATE_WINDOW_HOURS) {
+        const since = new Date(Date.now() - windowHours * 60 * 60 * 1000).toISOString();
+        const recent = this.query({
+            platform,
+            since,
+            status: 'posted',
+        });
+        const needle = contentSummary.toLowerCase();
+        return recent.find(action => {
+            const haystack = action.summary.toLowerCase();
+            // Check both directions: content contains summary OR summary contains content
+            return haystack.includes(needle) || needle.includes(haystack);
+        }) ?? null;
+    }
+    // ── Summary Generation ──────────────────────────────────────────────
+    /**
+     * Generate a compact summary of recent platform activity.
+     *
+     * Designed for session context injection — gives a new session instant
+     * awareness of what has been posted recently without loading the full log.
+     */
+    getRecentSummary(windowHours = 24) {
+        const since = new Date(Date.now() - windowHours * 60 * 60 * 1000).toISOString();
+        const allEntries = this.readLines();
+        const recentEntries = allEntries.filter(e => e.timestamp >= since && e.status === 'posted');
+        const byPlatform = {};
+        const byType = {};
+        const latestByPlatform = {};
+        for (const entry of recentEntries) {
+            byPlatform[entry.platform] = (byPlatform[entry.platform] ?? 0) + 1;
+            byType[entry.type] = (byType[entry.type] ?? 0) + 1;
+            const current = latestByPlatform[entry.platform];
+            if (!current || entry.timestamp > current.timestamp) {
+                latestByPlatform[entry.platform] = {
+                    timestamp: entry.timestamp,
+                    summary: entry.summary,
+                };
+            }
+        }
+        // Build compact text for session injection
+        const lines = [];
+        lines.push(`Platform Activity (last ${windowHours}h):`);
+        if (recentEntries.length === 0) {
+            lines.push('  No recent activity.');
+        }
+        else {
+            for (const [platform, count] of Object.entries(byPlatform).sort((a, b) => b[1] - a[1])) {
+                const latest = latestByPlatform[platform];
+                const truncated = latest.summary.length > 80
+                    ? latest.summary.slice(0, 77) + '...'
+                    : latest.summary;
+                lines.push(`  ${platform}: ${count} action(s), latest: "${truncated}"`);
+            }
+        }
+        return {
+            totalActions: allEntries.filter(e => e.status === 'posted').length,
+            last24h: recentEntries.length,
+            byPlatform,
+            byType,
+            latestByPlatform,
+            text: lines.join('\n'),
+        };
+    }
+    // ── Stats ───────────────────────────────────────────────────────────
+    /**
+     * Get the total count of recorded actions.
+     */
+    count(opts) {
+        let entries = this.readLines();
+        if (opts?.platform) {
+            entries = entries.filter(e => e.platform === opts.platform);
+        }
+        if (opts?.status) {
+            entries = entries.filter(e => e.status === opts.status);
+        }
+        return entries.length;
+    }
+    /**
+     * Get the path to the activity log file.
+     */
+    get filePath() {
+        return this.activityFile;
+    }
+    // ── Private Helpers ─────────────────────────────────────────────────
+    /**
+     * Read all entries from the JSONL file.
+     * Gracefully handles corrupt lines by skipping them.
+     */
+    readLines() {
+        if (!fs.existsSync(this.activityFile))
+            return [];
+        try {
+            const content = fs.readFileSync(this.activityFile, 'utf-8').trim();
+            if (!content)
+                return [];
+            return content.split('\n').map(line => {
+                try {
+                    return JSON.parse(line);
+                }
+                catch {
+                    // @silent-fallback-ok — skip corrupted JSONL lines
+                    return null;
+                }
+            }).filter(Boolean);
+        }
+        catch {
+            // @silent-fallback-ok — file read failure; empty array is the natural default
+            return [];
+        }
+    }
+    /**
+     * Update CanonicalState with latest platform activity summary.
+     *
+     * Sets a quick-fact answering "What has been posted recently?" so that
+     * sessions can check canonical state instead of loading the full log.
+     */
+    updateCanonicalState(action) {
+        if (!this.canonicalState)
+            return;
+        if (action.status !== 'posted')
+            return;
+        try {
+            const summary = this.getRecentSummary(24);
+            const platforms = Object.entries(summary.byPlatform)
+                .map(([p, c]) => `${p}: ${c}`)
+                .join(', ');
+            this.canonicalState.setFact('What has been posted recently?', `Last 24h: ${summary.last24h} actions (${platforms || 'none'}). Total all-time: ${summary.totalActions}.`, 'PlatformActivityRegistry');
+        }
+        catch {
+            // @silent-fallback-ok — canonical state update is optional enhancement
+        }
+    }
+}
+//# sourceMappingURL=PlatformActivityRegistry.js.map

package/dist/core/PlatformActivityRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformActivityRegistry.js","sourceRoot":"","sources":["../../src/core/PlatformActivityRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAqE9D,wEAAwE;AAExE,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAChD,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAC1C,MAAM,YAAY,GAAG;IACnB,KAAK,EAAE,KAAK,EAAI,uDAAuD;IACvE,OAAO,EAAE;QACP,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,IAAI;KACjB;CACF,CAAC;AAEF,wEAAwE;AAExE,MAAM,OAAO,wBAAwB;IAC3B,QAAQ,CAAS;IACjB,YAAY,CAAS;IACrB,cAAc,CAAkB;IAChC,gBAAgB,CAAU;IAElC,YAAY,MAAsC;QAChD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC9D,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAEhD,gCAAgC;QAChC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,uEAAuE;IAEvE;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,MAAkE;QAC7E,MAAM,KAAK,GAAmB;YAC5B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACvD,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;QAEF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAE1C,+DAA+D;QAC/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEpC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;YACrE,IAAI,CAAC;gBACH,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAC7C,CAAC;oBAAS,CAAC;gBACT,MAAM,OAAO,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4FAA4F;YAC5F,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAC7C,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAEjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,MAAkE;QAC3E,MAAM,KAAK,GAAmB;YAC5B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACvD,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;QAEF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAE1C,0BAA0B;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAE3C,mCAAmC;QACnC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAEjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uEAAuE;IAEvE;;;;OAIG;IACH,KAAK,CAAC,IAA4B;QAChC,IAAI,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAE/B,IAAI,IAAI,EAAE,QAAQ,EAAE,CAAC;YACnB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;YACf,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,IAAI,EAAE,SAAS,EAAE,CAAC;YACpB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;YACjB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;YAChB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,KAAM,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;YACjB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,MAAO,CAAC,CAAC;QAC5D,CAAC;QAED,oBAAoB;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAE/D,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;YAChB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,uEAAuE;IAEvE;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,QAAgB,EAChB,cAAsB,EACtB,cAAsB,8BAA8B;QAEpD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAChF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;YACxB,QAAQ;YACR,KAAK;YACL,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;QAE5C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;YAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC9C,8EAA8E;YAC9E,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAChE,CAAC,CAAC,IAAI,IAAI,CAAC;IACb,CAAC;IAED,uEAAuE;IAEvE;;;;;OAKG;IACH,gBAAgB,CAAC,cAAsB,EAAE;QACvC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAChF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACpC,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QAE5F,MAAM,UAAU,GAA2B,EAAE,CAAC;QAC9C,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,MAAM,gBAAgB,GAA2D,EAAE,CAAC;QAEpF,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACnE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAEnD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACjD,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;gBACpD,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG;oBACjC,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;iBACvB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,2BAA2B,WAAW,KAAK,CAAC,CAAC;QAExD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvF,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE;oBAC1C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK;oBACrC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,KAAK,KAAK,wBAAwB,SAAS,GAAG,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,OAAO;YACL,YAAY,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;YAClE,OAAO,EAAE,aAAa,CAAC,MAAM;YAC7B,UAAU;YACV,MAAM;YACN,gBAAgB;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;SACvB,CAAC;IACJ,CAAC;IAED,uEAAuE;IAEvE;;OAEG;IACH,KAAK,CAAC,IAA2D;QAC/D,IAAI,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,IAAI,IAAI,EAAE,QAAQ,EAAE,CAAC;YACnB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;YACjB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,uEAAuE;IAEvE;;;OAGG;IACK,SAAS;QACf,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QAEjD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YACnE,IAAI,CAAC,OAAO;gBAAE,OAAO,EAAE,CAAC;YAExB,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBACpC,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;gBAC5C,CAAC;gBAAC,MAAM,CAAC;oBACP,mDAAmD;oBACnD,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAqB,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,8EAA8E;YAC9E,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,oBAAoB,CAAC,MAAsB;QACjD,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO;QACjC,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO;QAEvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;iBACjD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;iBAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,IAAI,CAAC,cAAc,CAAC,OAAO,CACzB,gCAAgC,EAChC,aAAa,OAAO,CAAC,OAAO,aAAa,SAAS,IAAI,MAAM,sBAAsB,OAAO,CAAC,YAAY,GAAG,EACzG,0BAA0B,CAC3B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;QACzE,CAAC;IACH,CAAC;CACF"}

package/dist/core/PolicyEnforcementLayer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Policy Enforcement Layer (PEL) — Deterministic hard policy checks for
+ * the response review pipeline.
+ *
+ * Runs BEFORE any LLM-based review. Cannot be overridden. All rules are
+ * regex-based and complete in <5ms. Even in observeOnly mode, PEL violations
+ * are enforced — they represent non-negotiable safety boundaries.
+ *
+ * Checks for:
+ * - Credential / API key leakage
+ * - PII patterns (email, phone, SSN)
+ * - Agent auth token leakage
+ * - Internal URL exposure on external channels
+ * - File path exposure on external channels
+ * - Environment variable patterns
+ */
+export interface PELResult {
+    pass: boolean;
+    violations: PELViolation[];
+    /** 'hard_block' = must block, 'warn' = advisory, 'pass' = clean */
+    outcome: 'pass' | 'warn' | 'hard_block';
+}
+export interface PELViolation {
+    rule: string;
+    severity: 'hard_block' | 'warn';
+    detail: string;
+    /** Matched pattern (for debugging, not sent to agent) */
+    match?: string;
+}
+export interface PELContext {
+    channel: string;
+    isExternalFacing: boolean;
+    recipientType: 'primary-user' | 'secondary-user' | 'agent' | 'external-contact';
+    stateDir: string;
+}
+export declare class PolicyEnforcementLayer {
+    private stateDir;
+    private cachedAuthToken;
+    private configWatcher;
+    private configPath;
+    constructor(stateDir: string);
+    /**
+     * Enforce all policy rules against a message. Returns within 5ms.
+     * No I/O during enforcement — all state is pre-cached.
+     */
+    enforce(message: string, context: PELContext): PELResult;
+    /**
+     * Clean up resources (file watcher).
+     */
+    destroy(): void;
+    /**
+     * Get the cached auth token (for testing).
+     */
+    getAuthToken(): string | null;
+    private loadAuthToken;
+    private watchConfig;
+    /**
+     * All rules as a flat array. Each rule is a pure function that tests
+     * a message and returns a violation or null.
+     */
+    private rules;
+}
+//# sourceMappingURL=PolicyEnforcementLayer.d.ts.map

package/dist/core/PolicyEnforcementLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolicyEnforcementLayer.d.ts","sourceRoot":"","sources":["../../src/core/PolicyEnforcementLayer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,mEAAmE;IACnE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,GAAG,MAAM,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,cAAc,GAAG,gBAAgB,GAAG,OAAO,GAAG,kBAAkB,CAAC;IAChF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAiED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,UAAU,CAAS;gBAEf,QAAQ,EAAE,MAAM;IAO5B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS;IAuBxD;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAM7B,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,WAAW;IAcnB;;;OAGG;IACH,OAAO,CAAC,KAAK,CAiHX;CACH"}

package/dist/core/PolicyEnforcementLayer.js

@@ -0,0 +1,250 @@
+/**
+ * Policy Enforcement Layer (PEL) — Deterministic hard policy checks for
+ * the response review pipeline.
+ *
+ * Runs BEFORE any LLM-based review. Cannot be overridden. All rules are
+ * regex-based and complete in <5ms. Even in observeOnly mode, PEL violations
+ * are enforced — they represent non-negotiable safety boundaries.
+ *
+ * Checks for:
+ * - Credential / API key leakage
+ * - PII patterns (email, phone, SSN)
+ * - Agent auth token leakage
+ * - Internal URL exposure on external channels
+ * - File path exposure on external channels
+ * - Environment variable patterns
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+// ── Credential Patterns ──────────────────────────────────────────────
+/** Regex patterns for common API key / credential formats */
+const CREDENTIAL_PATTERNS = [
+    { name: 'OpenAI API key', pattern: /\bsk-[A-Za-z0-9_-]{20,}\b/ },
+    { name: 'GitHub personal access token', pattern: /\bghp_[A-Za-z0-9]{36,}\b/ },
+    { name: 'GitHub OAuth token', pattern: /\bgho_[A-Za-z0-9]{36,}\b/ },
+    { name: 'GitHub user-to-server token', pattern: /\bghu_[A-Za-z0-9]{36,}\b/ },
+    { name: 'GitHub server-to-server token', pattern: /\bghs_[A-Za-z0-9]{36,}\b/ },
+    { name: 'GitHub refresh token', pattern: /\bghr_[A-Za-z0-9]{36,}\b/ },
+    { name: 'Slack bot token', pattern: /\bxoxb-[0-9]{10,}-[A-Za-z0-9-]+\b/ },
+    { name: 'Slack user token', pattern: /\bxoxp-[0-9]{10,}-[A-Za-z0-9-]+\b/ },
+    { name: 'AWS access key', pattern: /\bAKIA[0-9A-Z]{16}\b/ },
+    { name: 'Stripe secret key', pattern: /\bsk_live_[A-Za-z0-9]{24,}\b/ },
+    { name: 'Stripe test key', pattern: /\bsk_test_[A-Za-z0-9]{24,}\b/ },
+    { name: 'Anthropic API key', pattern: /\bsk-ant-[A-Za-z0-9_-]{20,}\b/ },
+    { name: 'Generic bearer token', pattern: /Bearer\s+[A-Za-z0-9_\-.]{20,}/ },
+    { name: 'Password assignment', pattern: /(?:password|passwd|pwd)\s*[:=]\s*["']?[^\s"']{8,}/i },
+    { name: 'Private key block', pattern: /-----BEGIN\s+(RSA\s+)?PRIVATE\s+KEY-----/ },
+];
+// ── PII Patterns ─────────────────────────────────────────────────────
+const PII_PATTERNS = [
+    { name: 'Email address', pattern: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z]{2,}\b/i },
+    { name: 'US phone number', pattern: /\b(?:\+?1[-.\s]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}\b/ },
+    { name: 'SSN pattern', pattern: /\b\d{3}-\d{2}-\d{4}\b/ },
+];
+// ── Internal URL Patterns ────────────────────────────────────────────
+const INTERNAL_URL_PATTERN = /\bhttps?:\/\/(?:localhost|127\.0\.0\.1|0\.0\.0\.0)(?::\d+)?[^\s)]*/i;
+// ── File Path Patterns ───────────────────────────────────────────────
+const SENSITIVE_PATH_PATTERNS = [
+    /\/?\.instar\/[^\s)"]*/,
+    /\/?\.claude\/[^\s)"]*/,
+    /\/Users\/[^\s)"]*/,
+    /\/home\/[^\s)"]*/,
+];
+// ── Environment Variable Patterns ────────────────────────────────────
+const ENV_VAR_PATTERNS = [
+    { name: '$AUTH variable', pattern: /\$AUTH\b/ },
+    { name: '$API_KEY variable', pattern: /\$API_KEY\b/ },
+    { name: '$SECRET variable', pattern: /\$(?:SECRET|TOKEN|PASSWORD)\b/i },
+    { name: 'process.env reference', pattern: /process\.env\.[A-Z_]{2,}/ },
+];
+// ── Implementation ───────────────────────────────────────────────────
+export class PolicyEnforcementLayer {
+    stateDir;
+    cachedAuthToken = null;
+    configWatcher = null;
+    configPath;
+    constructor(stateDir) {
+        this.stateDir = stateDir;
+        this.configPath = path.join(stateDir, 'config.json');
+        this.loadAuthToken();
+        this.watchConfig();
+    }
+    /**
+     * Enforce all policy rules against a message. Returns within 5ms.
+     * No I/O during enforcement — all state is pre-cached.
+     */
+    enforce(message, context) {
+        const violations = [];
+        for (const rule of this.rules) {
+            if (rule.externalOnly && !context.isExternalFacing) {
+                continue;
+            }
+            const violation = rule.test(message, context, this.cachedAuthToken);
+            if (violation) {
+                violations.push(violation);
+            }
+        }
+        const hasHardBlock = violations.some(v => v.severity === 'hard_block');
+        const hasWarn = violations.some(v => v.severity === 'warn');
+        return {
+            pass: violations.length === 0,
+            violations,
+            outcome: hasHardBlock ? 'hard_block' : hasWarn ? 'warn' : 'pass',
+        };
+    }
+    /**
+     * Clean up resources (file watcher).
+     */
+    destroy() {
+        if (this.configWatcher) {
+            this.configWatcher.close();
+            this.configWatcher = null;
+        }
+    }
+    /**
+     * Get the cached auth token (for testing).
+     */
+    getAuthToken() {
+        return this.cachedAuthToken;
+    }
+    // ── Private ──────────────────────────────────────────────────────
+    loadAuthToken() {
+        try {
+            if (fs.existsSync(this.configPath)) {
+                const config = JSON.parse(fs.readFileSync(this.configPath, 'utf-8'));
+                this.cachedAuthToken = config.authToken || null;
+            }
+        }
+        catch {
+            this.cachedAuthToken = null;
+        }
+    }
+    watchConfig() {
+        try {
+            if (fs.existsSync(this.configPath)) {
+                this.configWatcher = fs.watch(this.configPath, () => {
+                    this.loadAuthToken();
+                });
+                // Don't let the watcher keep the process alive
+                this.configWatcher.unref();
+            }
+        }
+        catch {
+            // Silently ignore watch failures — token will be stale but enforcement still works
+        }
+    }
+    /**
+     * All rules as a flat array. Each rule is a pure function that tests
+     * a message and returns a violation or null.
+     */
+    rules = [
+        // ── Credential Patterns ──────────────────────────────────────
+        ...CREDENTIAL_PATTERNS.map(({ name, pattern }) => ({
+            name: 'credential-leak',
+            severity: 'hard_block',
+            externalOnly: false,
+            test: (message) => {
+                const match = message.match(pattern);
+                if (match) {
+                    return {
+                        rule: 'credential-leak',
+                        severity: 'hard_block',
+                        detail: `Detected ${name} pattern in message`,
+                        match: match[0],
+                    };
+                }
+                return null;
+            },
+        })),
+        // ── PII Detection ────────────────────────────────────────────
+        ...PII_PATTERNS.map(({ name, pattern }) => ({
+            name: 'pii-detection',
+            severity: 'hard_block',
+            externalOnly: true,
+            test: (message) => {
+                const match = message.match(pattern);
+                if (match) {
+                    return {
+                        rule: 'pii-detection',
+                        severity: 'hard_block',
+                        detail: `Detected ${name} pattern in external-facing message`,
+                        match: match[0],
+                    };
+                }
+                return null;
+            },
+        })),
+        // ── Auth Token Leakage ───────────────────────────────────────
+        {
+            name: 'auth-token-leak',
+            severity: 'hard_block',
+            externalOnly: false,
+            test: (message, _context, authToken) => {
+                if (authToken && authToken.length >= 8 && message.includes(authToken)) {
+                    return {
+                        rule: 'auth-token-leak',
+                        severity: 'hard_block',
+                        detail: 'Message contains the agent\'s own auth token',
+                        match: authToken.substring(0, 4) + '...',
+                    };
+                }
+                return null;
+            },
+        },
+        // ── Internal URL Detection ───────────────────────────────────
+        {
+            name: 'internal-url-leak',
+            severity: 'hard_block',
+            externalOnly: true,
+            test: (message) => {
+                const match = message.match(INTERNAL_URL_PATTERN);
+                if (match) {
+                    return {
+                        rule: 'internal-url-leak',
+                        severity: 'hard_block',
+                        detail: 'Internal URL detected in external-facing message',
+                        match: match[0],
+                    };
+                }
+                return null;
+            },
+        },
+        // ── File Path Detection ──────────────────────────────────────
+        ...SENSITIVE_PATH_PATTERNS.map((pattern, i) => ({
+            name: 'file-path-leak',
+            severity: 'warn',
+            externalOnly: true,
+            test: (message) => {
+                const match = message.match(pattern);
+                if (match) {
+                    return {
+                        rule: 'file-path-leak',
+                        severity: 'warn',
+                        detail: 'Sensitive file path detected in external-facing message',
+                        match: match[0],
+                    };
+                }
+                return null;
+            },
+        })),
+        // ── Environment Variable Patterns ────────────────────────────
+        ...ENV_VAR_PATTERNS.map(({ name, pattern }) => ({
+            name: 'env-var-leak',
+            severity: 'warn',
+            externalOnly: false,
+            test: (message) => {
+                const match = message.match(pattern);
+                if (match) {
+                    return {
+                        rule: 'env-var-leak',
+                        severity: 'warn',
+                        detail: `Environment variable reference detected: ${name}`,
+                        match: match[0],
+                    };
+                }
+                return null;
+            },
+        })),
+    ];
+}
+//# sourceMappingURL=PolicyEnforcementLayer.js.map

package/dist/core/PolicyEnforcementLayer.js.map

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

package/dist/core/PortRegistry.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Port Registry — DEPRECATED. Re-exports from AgentRegistry.
+ *
+ * @deprecated Use AgentRegistry instead. This file exists only for
+ * backward compatibility during the migration period.
+ */
+export { registerPort, unregisterPort, startHeartbeatByName as startHeartbeat, listInstances, allocatePortByName as allocatePort, } from './AgentRegistry.js';
+export type { AgentRegistryEntry as PortEntry } from './types.js';
+//# sourceMappingURL=PortRegistry.d.ts.map

package/dist/core/PortRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortRegistry.d.ts","sourceRoot":"","sources":["../../src/core/PortRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,oBAAoB,IAAI,cAAc,EACtC,aAAa,EACb,kBAAkB,IAAI,YAAY,GACnC,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,kBAAkB,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC"}