@iflow-mcp/jkheadley-instar 0.26.2

package/dist/memory/WorkingMemoryAssembler.js

@@ -0,0 +1,406 @@
+/**
+ * Working Memory Assembler — Token-budgeted context assembly from all memory layers.
+ *
+ * Queries SemanticMemory, EpisodicMemory, and other sources to build
+ * the right context for a session at startup or after compaction.
+ *
+ * The goal is: right context, right amount, right moment.
+ *
+ * Assembly strategy (from PROP-memory-architecture Phase 3):
+ *   1. Parse the session trigger (prompt, job slug, topic) to identify topics
+ *   2. Query SemanticMemory for relevant entities
+ *   3. Check for related people (person entities)
+ *   4. Load recent episode digests for continuity
+ *   5. Budget tokens across sources
+ *   6. Return formatted context for hook injection
+ *
+ * Render strategy within token budgets:
+ *   - Top 3: Full content (name + content + confidence + connections summary)
+ *   - Next 7: Compact (name + first sentence of content + confidence)
+ *   - Remainder: Name-only list ("Also related: X, Y, Z")
+ *
+ * Implements Phase 4 of PROP-memory-architecture v3.1.
+ */
+import { estimateTokens } from './Chunker.js';
+// ─── Constants ──────────────────────────────────────────────────────
+const DEFAULT_BUDGETS = {
+    knowledge: 800,
+    episodes: 400,
+    relationships: 300,
+    total: 2000,
+};
+// ─── Assembler ──────────────────────────────────────────────────────
+export class WorkingMemoryAssembler {
+    semanticMemory;
+    episodicMemory;
+    budgets;
+    constructor(config) {
+        this.semanticMemory = config.semanticMemory;
+        this.episodicMemory = config.episodicMemory;
+        this.budgets = { ...DEFAULT_BUDGETS, ...config.tokenBudgets };
+    }
+    /**
+     * Assemble working memory context for a session.
+     *
+     * Returns a formatted context string and metadata about what was included.
+     * Gracefully degrades: if a memory system is unavailable, that section is
+     * simply empty — no errors thrown.
+     */
+    assemble(trigger) {
+        const queryTerms = this.extractQueryTerms(trigger);
+        const query = queryTerms.join(' ');
+        const sections = [];
+        let totalTokens = 0;
+        // 1. Semantic knowledge (highest priority — the agent's learned knowledge)
+        if (this.semanticMemory && query) {
+            const knowledgeSection = this.assembleKnowledge(query, this.budgets.knowledge);
+            if (knowledgeSection.content) {
+                sections.push(knowledgeSection);
+                totalTokens += knowledgeSection.tokens;
+            }
+        }
+        // 2. Recent episodes (what happened recently — continuity)
+        if (this.episodicMemory) {
+            const remainingBudget = Math.min(this.budgets.episodes, this.budgets.total - totalTokens);
+            if (remainingBudget > 50) {
+                const episodeSection = this.assembleEpisodes(query, remainingBudget);
+                if (episodeSection.content) {
+                    sections.push(episodeSection);
+                    totalTokens += episodeSection.tokens;
+                }
+            }
+        }
+        // 3. Relationships (people context — only if person-related entities found)
+        if (this.semanticMemory && query) {
+            const remainingBudget = Math.min(this.budgets.relationships, this.budgets.total - totalTokens);
+            if (remainingBudget > 50) {
+                const relationshipSection = this.assembleRelationships(query, remainingBudget);
+                if (relationshipSection.content) {
+                    sections.push(relationshipSection);
+                    totalTokens += relationshipSection.tokens;
+                }
+            }
+        }
+        // Build final context string
+        const context = this.formatAssembly(sections);
+        return {
+            context,
+            estimatedTokens: totalTokens || estimateTokens(context),
+            sources: sections.map(s => ({ name: s.name, tokens: s.tokens, count: s.count })),
+            queryTerms,
+            assembledAt: new Date().toISOString(),
+        };
+    }
+    // ─── Knowledge Assembly ───────────────────────────────────────────
+    assembleKnowledge(query, budget) {
+        if (!this.semanticMemory) {
+            return { name: 'knowledge', content: '', tokens: 0, count: 0 };
+        }
+        // Search per-term and merge — FTS5 defaults to AND which requires all
+        // terms in a single entity (too restrictive for assembly). Per-term
+        // search with deduplication gives OR-like recall.
+        const results = this.searchAndMerge(query, { limit: 15 });
+        if (results.length === 0) {
+            return { name: 'knowledge', content: '', tokens: 0, count: 0 };
+        }
+        return this.renderEntities(results, budget, 'knowledge');
+    }
+    // ─── Episode Assembly ─────────────────────────────────────────────
+    assembleEpisodes(query, budget) {
+        if (!this.episodicMemory) {
+            return { name: 'episodes', content: '', tokens: 0, count: 0 };
+        }
+        // Get recent activity (last 24h, up to 10 digests)
+        const recent = this.episodicMemory.getRecentActivity(24, 10);
+        // If we have a query, also search by themes
+        let themeResults = [];
+        if (query) {
+            const terms = query.split(/\s+/).filter(t => t.length > 3);
+            for (const term of terms.slice(0, 3)) {
+                const themed = this.episodicMemory.getByTheme(term);
+                themeResults.push(...themed);
+            }
+        }
+        // Merge and deduplicate, preferring recent
+        const seen = new Set();
+        const digests = [];
+        for (const d of [...recent, ...themeResults]) {
+            if (!seen.has(d.id)) {
+                seen.add(d.id);
+                digests.push(d);
+            }
+        }
+        if (digests.length === 0) {
+            return { name: 'episodes', content: '', tokens: 0, count: 0 };
+        }
+        // Sort by significance (descending), then by recency
+        digests.sort((a, b) => {
+            if (b.significance !== a.significance)
+                return b.significance - a.significance;
+            return b.startedAt.localeCompare(a.startedAt);
+        });
+        return this.renderDigests(digests, budget);
+    }
+    // ─── Relationship Assembly ────────────────────────────────────────
+    assembleRelationships(query, budget) {
+        if (!this.semanticMemory) {
+            return { name: 'relationships', content: '', tokens: 0, count: 0 };
+        }
+        // Search for person entities specifically (per-term for recall)
+        const people = this.searchAndMerge(query, {
+            types: ['person'],
+            limit: 5,
+        });
+        if (people.length === 0) {
+            return { name: 'relationships', content: '', tokens: 0, count: 0 };
+        }
+        return this.renderEntities(people, budget, 'relationships');
+    }
+    // ─── Rendering ────────────────────────────────────────────────────
+    /**
+     * Render entities with the tiered strategy:
+     * - Top 3: Full content (name + content + confidence + connections)
+     * - Next 7: Compact (name + first sentence + confidence)
+     * - Remainder: Name-only list
+     */
+    renderEntities(entities, budget, sectionName) {
+        const lines = [];
+        let tokens = 0;
+        let count = 0;
+        // Tier 1: Full detail (top 3)
+        const fullEntities = entities.slice(0, 3);
+        for (const entity of fullEntities) {
+            const entry = this.renderEntityFull(entity);
+            const entryTokens = estimateTokens(entry);
+            if (tokens + entryTokens > budget)
+                break;
+            lines.push(entry);
+            tokens += entryTokens;
+            count++;
+        }
+        // Tier 2: Compact (next 7)
+        const compactEntities = entities.slice(3, 10);
+        for (const entity of compactEntities) {
+            const entry = this.renderEntityCompact(entity);
+            const entryTokens = estimateTokens(entry);
+            if (tokens + entryTokens > budget)
+                break;
+            lines.push(entry);
+            tokens += entryTokens;
+            count++;
+        }
+        // Tier 3: Name-only (remainder)
+        const remainingEntities = entities.slice(10);
+        if (remainingEntities.length > 0) {
+            const names = remainingEntities.map(e => e.name).join(', ');
+            const nameEntry = `Also related: ${names}`;
+            const nameTokens = estimateTokens(nameEntry);
+            if (tokens + nameTokens <= budget) {
+                lines.push(nameEntry);
+                tokens += nameTokens;
+                count += remainingEntities.length;
+            }
+        }
+        return {
+            name: sectionName,
+            content: lines.join('\n'),
+            tokens,
+            count,
+        };
+    }
+    renderEntityFull(entity) {
+        const confidence = Math.round(entity.confidence * 100);
+        const lines = [
+            `### ${entity.name} (${entity.type})`,
+            entity.content,
+            `_Confidence: ${confidence}% | Score: ${entity.score.toFixed(2)}_`,
+        ];
+        return lines.join('\n');
+    }
+    renderEntityCompact(entity) {
+        const confidence = Math.round(entity.confidence * 100);
+        const firstSentence = entity.content.split(/[.!?]\s/)[0] + '.';
+        return `- **${entity.name}** (${entity.type}, ${confidence}%): ${firstSentence}`;
+    }
+    /**
+     * Render episode digests with budget awareness.
+     * Top 3 get full detail, rest get one-line summaries.
+     */
+    renderDigests(digests, budget) {
+        const lines = [];
+        let tokens = 0;
+        let count = 0;
+        // Top 3: Full detail
+        for (const digest of digests.slice(0, 3)) {
+            const entry = this.renderDigestFull(digest);
+            const entryTokens = estimateTokens(entry);
+            if (tokens + entryTokens > budget)
+                break;
+            lines.push(entry);
+            tokens += entryTokens;
+            count++;
+        }
+        // Rest: One-line summary
+        for (const digest of digests.slice(3)) {
+            const entry = `- [${digest.sessionName}] ${digest.summary}`;
+            const entryTokens = estimateTokens(entry);
+            if (tokens + entryTokens > budget)
+                break;
+            lines.push(entry);
+            tokens += entryTokens;
+            count++;
+        }
+        return {
+            name: 'episodes',
+            content: lines.join('\n'),
+            tokens,
+            count,
+        };
+    }
+    renderDigestFull(digest) {
+        const lines = [
+            `### ${digest.sessionName} (${this.relativeTime(digest.startedAt)})`,
+            digest.summary,
+        ];
+        if (digest.actions.length > 0) {
+            lines.push(`Actions: ${digest.actions.join(', ')}`);
+        }
+        if (digest.learnings.length > 0) {
+            lines.push(`Learnings: ${digest.learnings.join(', ')}`);
+        }
+        if (digest.themes.length > 0) {
+            lines.push(`Themes: ${digest.themes.join(', ')}`);
+        }
+        return lines.join('\n');
+    }
+    // ─── Formatting ───────────────────────────────────────────────────
+    formatAssembly(sections) {
+        if (sections.length === 0)
+            return '';
+        const parts = [];
+        for (const section of sections) {
+            if (!section.content)
+                continue;
+            const header = this.sectionHeader(section.name);
+            parts.push(`## ${header}\n\n${section.content}`);
+        }
+        if (parts.length === 0)
+            return '';
+        return parts.join('\n\n');
+    }
+    sectionHeader(name) {
+        switch (name) {
+            case 'knowledge': return 'Relevant Knowledge';
+            case 'episodes': return 'Recent Activity';
+            case 'relationships': return 'People Context';
+            default: return name;
+        }
+    }
+    // ─── Query Extraction ─────────────────────────────────────────────
+    /**
+     * Extract search terms from the assembly trigger.
+     * Combines prompt words, job slug, and topic context.
+     */
+    extractQueryTerms(trigger) {
+        const terms = [];
+        // From prompt: extract significant words (>3 chars, not stop words)
+        if (trigger.prompt) {
+            const words = trigger.prompt
+                .toLowerCase()
+                .replace(/[^a-z0-9\s-]/g, ' ')
+                .split(/\s+/)
+                .filter(w => w.length > 3)
+                .filter(w => !STOP_WORDS.has(w));
+            // Take up to 8 most unique terms
+            const unique = [...new Set(words)];
+            terms.push(...unique.slice(0, 8));
+        }
+        // From job slug: split on hyphens
+        if (trigger.jobSlug) {
+            const slugTerms = trigger.jobSlug
+                .split('-')
+                .filter(t => t.length > 2);
+            terms.push(...slugTerms);
+        }
+        return [...new Set(terms)];
+    }
+    // ─── Search Helpers ─────────────────────────────────────────────
+    /**
+     * Search per-term and merge results by ID. Avoids FTS5 implicit-AND
+     * which requires all terms in a single entity (too restrictive).
+     * Entities matching more terms rank higher via accumulated score.
+     */
+    searchAndMerge(query, options) {
+        if (!this.semanticMemory)
+            return [];
+        const terms = query.split(/\s+/).filter(t => t.length > 2);
+        if (terms.length === 0)
+            return [];
+        const limit = options?.limit ?? 15;
+        const merged = new Map();
+        // Also try the full query first (exact multi-word match is best signal)
+        if (terms.length > 1) {
+            const fullResults = this.semanticMemory.search(query, {
+                types: options?.types,
+                limit,
+            });
+            for (const entity of fullResults) {
+                merged.set(entity.id, entity);
+            }
+        }
+        // Then search per-term and merge
+        for (const term of terms.slice(0, 5)) {
+            const results = this.semanticMemory.search(term, {
+                types: options?.types,
+                limit: Math.ceil(limit / 2),
+            });
+            for (const entity of results) {
+                if (merged.has(entity.id)) {
+                    // Boost score for entities matching multiple terms
+                    const existing = merged.get(entity.id);
+                    existing.score = Math.max(existing.score, entity.score) * 1.1;
+                }
+                else {
+                    merged.set(entity.id, entity);
+                }
+            }
+        }
+        // Sort by score descending and limit
+        return Array.from(merged.values())
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit);
+    }
+    // ─── Helpers ──────────────────────────────────────────────────────
+    relativeTime(isoDate) {
+        const diff = Date.now() - new Date(isoDate).getTime();
+        const hours = Math.floor(diff / (60 * 60 * 1000));
+        if (hours < 1)
+            return 'just now';
+        if (hours < 24)
+            return `${hours}h ago`;
+        const days = Math.floor(hours / 24);
+        return `${days}d ago`;
+    }
+    /** Get the current token budgets (for testing/inspection). */
+    getBudgets() {
+        return { ...this.budgets };
+    }
+}
+// ─── Stop Words ─────────────────────────────────────────────────────
+const STOP_WORDS = new Set([
+    'about', 'after', 'also', 'been', 'before', 'between', 'both',
+    'came', 'come', 'could', 'does', 'each', 'even', 'every',
+    'first', 'from', 'good', 'have', 'here', 'into', 'just',
+    'keep', 'know', 'last', 'like', 'long', 'look', 'made',
+    'make', 'many', 'most', 'much', 'must', 'need', 'only',
+    'other', 'over', 'part', 'said', 'same', 'show', 'side',
+    'some', 'still', 'such', 'take', 'tell', 'than', 'that',
+    'their', 'them', 'then', 'there', 'these', 'they', 'this',
+    'through', 'time', 'under', 'very', 'want', 'well', 'were',
+    'what', 'when', 'where', 'which', 'while', 'will', 'with',
+    'work', 'would', 'your',
+    // Task-generic words that don't help search
+    'please', 'should', 'implement', 'build', 'create', 'update',
+    'check', 'write', 'test', 'help', 'start', 'begin',
+]);
+//# sourceMappingURL=WorkingMemoryAssembler.js.map

package/dist/memory/WorkingMemoryAssembler.js.map

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

package/dist/messaging/AdapterRegistry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * AdapterRegistry — Factory pattern for messaging adapters.
+ *
+ * Replaces hardcoded adapter creation in server.ts with a registry that
+ * any adapter type can register into. Future-proofs for community-contributed
+ * adapters (Discord, Slack, etc.)
+ */
+import type { MessagingAdapter } from '../core/types.js';
+type AdapterConstructor = new (config: Record<string, unknown>, stateDir: string) => MessagingAdapter;
+/** Register an adapter type. Call at module load time. */
+export declare function registerAdapter(type: string, ctor: AdapterConstructor): void;
+/** Create an adapter instance from config. Throws if type is unknown. */
+export declare function createAdapter(config: {
+    type: string;
+    enabled: boolean;
+    config: Record<string, unknown>;
+}, stateDir: string): MessagingAdapter;
+/** Check if an adapter type is registered. */
+export declare function hasAdapter(type: string): boolean;
+/** Get all registered adapter type names. */
+export declare function getRegisteredAdapters(): string[];
+/** Remove an adapter registration (mainly for testing). */
+export declare function unregisterAdapter(type: string): boolean;
+/** Clear all registrations (mainly for testing). */
+export declare function clearRegistry(): void;
+export {};
+//# sourceMappingURL=AdapterRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterRegistry.d.ts","sourceRoot":"","sources":["../../src/messaging/AdapterRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,KAAK,kBAAkB,GAAG,KAAK,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,gBAAgB,CAAC;AAItG,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAK5E;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAC3B,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAC3E,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAQlB;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,oDAAoD;AACpD,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/messaging/AdapterRegistry.js

@@ -0,0 +1,40 @@
+/**
+ * AdapterRegistry — Factory pattern for messaging adapters.
+ *
+ * Replaces hardcoded adapter creation in server.ts with a registry that
+ * any adapter type can register into. Future-proofs for community-contributed
+ * adapters (Discord, Slack, etc.)
+ */
+const registry = new Map();
+/** Register an adapter type. Call at module load time. */
+export function registerAdapter(type, ctor) {
+    if (registry.has(type)) {
+        console.warn(`[adapter-registry] Overwriting existing adapter type: ${type}`);
+    }
+    registry.set(type, ctor);
+}
+/** Create an adapter instance from config. Throws if type is unknown. */
+export function createAdapter(config, stateDir) {
+    const Ctor = registry.get(config.type);
+    if (!Ctor) {
+        throw new Error(`Unknown messaging adapter: "${config.type}". Available: ${[...registry.keys()].join(', ') || 'none'}`);
+    }
+    return new Ctor(config.config, stateDir);
+}
+/** Check if an adapter type is registered. */
+export function hasAdapter(type) {
+    return registry.has(type);
+}
+/** Get all registered adapter type names. */
+export function getRegisteredAdapters() {
+    return [...registry.keys()];
+}
+/** Remove an adapter registration (mainly for testing). */
+export function unregisterAdapter(type) {
+    return registry.delete(type);
+}
+/** Clear all registrations (mainly for testing). */
+export function clearRegistry() {
+    registry.clear();
+}
+//# sourceMappingURL=AdapterRegistry.js.map

package/dist/messaging/AdapterRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterRegistry.js","sourceRoot":"","sources":["../../src/messaging/AdapterRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;AAEvD,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAwB;IACpE,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,yDAAyD,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAC3B,MAA2E,EAC3E,QAAgB;IAEhB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,CAAC,IAAI,iBAAiB,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CACvG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,aAAa;IAC3B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/messaging/AgentTokenManager.d.ts

@@ -0,0 +1,86 @@
+/**
+ * AgentTokenManager — per-agent authentication tokens for cross-agent messaging.
+ *
+ * Each agent on the machine gets a 256-bit random token stored at:
+ *   ~/.instar/agent-tokens/{agentName}.token
+ *
+ * Tokens are generated on first agent registration and persist across restarts.
+ * Used for:
+ *   - Bearer auth on relay-agent endpoint (proving sender identity)
+ *   - HMAC computation on message drops (tamper protection for offline delivery)
+ *
+ * Security properties:
+ *   - Tokens are file-permission protected (0600 — owner read/write only)
+ *   - Token directory is 0700
+ *   - Agent names are validated to prevent path traversal
+ *
+ * Derived from: docs/specs/INTER-AGENT-MESSAGING-SPEC.md v3.1 §Cross-Agent Resolution
+ */
+/**
+ * Ensure the token directory exists with proper permissions.
+ */
+export declare function ensureTokenDir(): void;
+/**
+ * Generate a new agent token and persist it to disk.
+ * If a token already exists for this agent, returns the existing token.
+ *
+ * @param agentName - The agent's canonical name (validated for path safety)
+ * @returns The hex-encoded token string
+ */
+export declare function generateAgentToken(agentName: string): string;
+/**
+ * Read an agent's token from disk.
+ * Used by the sending agent to authenticate with the target agent's relay endpoint.
+ *
+ * @param agentName - The target agent's name
+ * @returns The hex-encoded token, or null if no token exists
+ */
+export declare function getAgentToken(agentName: string): string | null;
+/**
+ * Verify a bearer token matches the expected agent token.
+ * Used by the relay-agent endpoint to authenticate incoming requests.
+ *
+ * @param agentName - The agent whose token to check against
+ * @param bearerToken - The token provided in the Authorization header
+ * @returns true if the token matches
+ */
+export declare function verifyAgentToken(agentName: string, bearerToken: string): boolean;
+/**
+ * Compute HMAC-SHA256 for a message drop envelope.
+ * Used when writing to the drop directory for offline same-machine delivery.
+ *
+ * The HMAC covers the same core fields as the cross-machine SignedPayload
+ * (minus relayChain and signature which don't apply to same-machine drops).
+ *
+ * @param agentToken - The sending agent's token
+ * @param fields - The fields to sign: { message, originServer, nonce, timestamp }
+ */
+export declare function computeDropHmac(agentToken: string, fields: {
+    message: unknown;
+    originServer: string;
+    nonce: string;
+    timestamp: string;
+}): string;
+/**
+ * Verify HMAC on a received drop envelope.
+ *
+ * @param senderAgent - Name of the agent that wrote the drop
+ * @param hmac - The HMAC value from the envelope
+ * @param fields - The fields that were signed
+ * @returns true if the HMAC is valid
+ */
+export declare function verifyDropHmac(senderAgent: string, hmac: string, fields: {
+    message: unknown;
+    originServer: string;
+    nonce: string;
+    timestamp: string;
+}): boolean;
+/**
+ * Delete an agent's token. Used during agent unregistration.
+ */
+export declare function deleteAgentToken(agentName: string): boolean;
+/**
+ * List all agents that have tokens.
+ */
+export declare function listAgentTokens(): string[];
+//# sourceMappingURL=AgentTokenManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentTokenManager.d.ts","sourceRoot":"","sources":["../../src/messaging/AgentTokenManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA8BH;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAWrC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAqB5D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU9D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAUhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnF,MAAM,CAMR;AAqBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnF,OAAO,CAYT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAW3D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAW1C"}