@agent-relay/daemon 0.1.0

package/dist/agent-registry.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Agent Registry
+ * Persists agent metadata across daemon restarts.
+ */
+/**
+ * Agent profile information for display and understanding agent behavior
+ */
+export interface AgentProfileRecord {
+    /** Display title/role (e.g., "Lead Developer", "Code Reviewer") */
+    title?: string;
+    /** Short description of what this agent does */
+    description?: string;
+    /** The prompt/task the agent was spawned with */
+    spawnPrompt?: string;
+    /** Agent profile/persona prompt (e.g., lead agent instructions) */
+    personaPrompt?: string;
+    /** Name of the persona preset used (e.g., "lead", "reviewer", "shadow-auditor") */
+    personaName?: string;
+    /** Capabilities or tools available to the agent */
+    capabilities?: string[];
+    /** Tags for categorization */
+    tags?: string[];
+}
+export interface AgentRecord {
+    id: string;
+    name: string;
+    cli?: string;
+    program?: string;
+    model?: string;
+    task?: string;
+    workingDirectory?: string;
+    team?: string;
+    firstSeen: string;
+    lastSeen: string;
+    messagesSent: number;
+    messagesReceived: number;
+    /** Profile information for understanding agent behavior */
+    profile?: AgentProfileRecord;
+}
+type AgentInput = {
+    name: string;
+    cli?: string;
+    program?: string;
+    model?: string;
+    task?: string;
+    workingDirectory?: string;
+    team?: string;
+    profile?: AgentProfileRecord;
+};
+export declare class AgentRegistry {
+    private registryPath;
+    private agents;
+    constructor(teamDir: string);
+    /**
+     * Register or update an agent (public alias for registerOrUpdate to match docs).
+     */
+    register(agent: AgentInput): AgentRecord;
+    /**
+     * Register or update an agent, refreshing lastSeen and metadata.
+     */
+    registerOrUpdate(agent: AgentInput): AgentRecord;
+    /**
+     * Increment sent counter for an agent.
+     */
+    recordSend(agentName: string): void;
+    /**
+     * Increment received counter for an agent.
+     */
+    recordReceive(agentName: string): void;
+    /**
+     * Touch lastSeen for an agent (e.g., on disconnect).
+     */
+    touch(agentName: string): void;
+    /**
+     * Get a snapshot of all agents.
+     */
+    getAgents(): AgentRecord[];
+    /**
+     * Check if an agent exists in the registry (has connected before).
+     * Used by the router to determine if messages should be queued for offline agents.
+     */
+    has(agentName: string): boolean;
+    /**
+     * Remove an agent from the registry.
+     */
+    remove(agentName: string): boolean;
+    /**
+     * Remove agents that haven't been seen for longer than the threshold.
+     * @param thresholdMs - Time in milliseconds (default: 24 hours)
+     * @returns Number of agents removed
+     */
+    pruneStale(thresholdMs?: number): number;
+    private ensureRecord;
+    private ensureDir;
+    load(): void;
+    save(): void;
+}
+export {};
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../src/agent-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAEF,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAuC;gBAEzC,OAAO,EAAE,MAAM;IAM3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW;IAIxC;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW;IA+ChD;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQnC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQtC;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO9B;;OAEG;IACH,SAAS,IAAI,WAAW,EAAE;IAI1B;;;OAGG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAQlC;;;;OAIG;IACH,UAAU,CAAC,WAAW,GAAE,MAA4B,GAAG,MAAM;IAoB7D,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,SAAS;IAMjB,IAAI,IAAI,IAAI;IAqCZ,IAAI,IAAI,IAAI;CAYb"}

package/dist/agent-registry.js

@@ -0,0 +1,213 @@
+/**
+ * Agent Registry
+ * Persists agent metadata across daemon restarts.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { generateId } from '@agent-relay/wrapper';
+import { createLogger } from '@agent-relay/utils/logger';
+const log = createLogger('registry');
+export class AgentRegistry {
+    registryPath;
+    agents = new Map(); // name -> record
+    constructor(teamDir) {
+        this.registryPath = path.join(teamDir, 'agents.json');
+        this.ensureDir(teamDir);
+        this.load();
+    }
+    /**
+     * Register or update an agent (public alias for registerOrUpdate to match docs).
+     */
+    register(agent) {
+        return this.registerOrUpdate(agent);
+    }
+    /**
+     * Register or update an agent, refreshing lastSeen and metadata.
+     */
+    registerOrUpdate(agent) {
+        const now = new Date().toISOString();
+        const existing = this.agents.get(agent.name);
+        if (existing) {
+            // Merge profile data if provided
+            const mergedProfile = agent.profile
+                ? { ...existing.profile, ...agent.profile }
+                : existing.profile;
+            const updated = {
+                ...existing,
+                cli: agent.cli ?? existing.cli,
+                program: agent.program ?? existing.program,
+                model: agent.model ?? existing.model,
+                task: agent.task ?? existing.task,
+                workingDirectory: agent.workingDirectory ?? existing.workingDirectory,
+                team: agent.team ?? existing.team,
+                profile: mergedProfile,
+                lastSeen: now,
+            };
+            this.agents.set(agent.name, updated);
+            this.save();
+            return updated;
+        }
+        const record = {
+            id: `agent-${generateId()}`,
+            name: agent.name,
+            cli: agent.cli,
+            program: agent.program,
+            model: agent.model,
+            task: agent.task,
+            workingDirectory: agent.workingDirectory,
+            team: agent.team,
+            profile: agent.profile,
+            firstSeen: now,
+            lastSeen: now,
+            messagesSent: 0,
+            messagesReceived: 0,
+        };
+        this.agents.set(agent.name, record);
+        this.save();
+        return record;
+    }
+    /**
+     * Increment sent counter for an agent.
+     */
+    recordSend(agentName) {
+        const record = this.ensureRecord(agentName);
+        record.messagesSent += 1;
+        record.lastSeen = new Date().toISOString();
+        this.agents.set(agentName, record);
+        this.save();
+    }
+    /**
+     * Increment received counter for an agent.
+     */
+    recordReceive(agentName) {
+        const record = this.ensureRecord(agentName);
+        record.messagesReceived += 1;
+        record.lastSeen = new Date().toISOString();
+        this.agents.set(agentName, record);
+        this.save();
+    }
+    /**
+     * Touch lastSeen for an agent (e.g., on disconnect).
+     */
+    touch(agentName) {
+        const record = this.ensureRecord(agentName);
+        record.lastSeen = new Date().toISOString();
+        this.agents.set(agentName, record);
+        this.save();
+    }
+    /**
+     * Get a snapshot of all agents.
+     */
+    getAgents() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Check if an agent exists in the registry (has connected before).
+     * Used by the router to determine if messages should be queued for offline agents.
+     */
+    has(agentName) {
+        return this.agents.has(agentName);
+    }
+    /**
+     * Remove an agent from the registry.
+     */
+    remove(agentName) {
+        const deleted = this.agents.delete(agentName);
+        if (deleted) {
+            this.save();
+        }
+        return deleted;
+    }
+    /**
+     * Remove agents that haven't been seen for longer than the threshold.
+     * @param thresholdMs - Time in milliseconds (default: 24 hours)
+     * @returns Number of agents removed
+     */
+    pruneStale(thresholdMs = 24 * 60 * 60 * 1000) {
+        const cutoff = Date.now() - thresholdMs;
+        let removed = 0;
+        for (const [name, record] of this.agents) {
+            const lastSeenTime = new Date(record.lastSeen).getTime();
+            if (lastSeenTime < cutoff) {
+                this.agents.delete(name);
+                removed++;
+                log.info('Pruned stale agent', { name, lastSeen: record.lastSeen });
+            }
+        }
+        if (removed > 0) {
+            this.save();
+        }
+        return removed;
+    }
+    ensureRecord(agentName) {
+        const existing = this.agents.get(agentName);
+        if (existing)
+            return existing;
+        const now = new Date().toISOString();
+        const record = {
+            id: `agent-${generateId()}`,
+            name: agentName,
+            firstSeen: now,
+            lastSeen: now,
+            messagesSent: 0,
+            messagesReceived: 0,
+        };
+        this.agents.set(agentName, record);
+        return record;
+    }
+    ensureDir(dir) {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    load() {
+        if (!fs.existsSync(this.registryPath)) {
+            return;
+        }
+        try {
+            const data = JSON.parse(fs.readFileSync(this.registryPath, 'utf-8'));
+            const rawAgents = Array.isArray(data?.agents)
+                ? data.agents
+                : typeof data?.agents === 'object' && data?.agents !== null
+                    ? Object.values(data.agents)
+                    : [];
+            for (const raw of rawAgents) {
+                if (!raw?.name)
+                    continue;
+                const record = {
+                    id: raw.id ?? `agent-${generateId()}`,
+                    name: raw.name,
+                    cli: raw.cli,
+                    program: raw.program,
+                    model: raw.model,
+                    task: raw.task,
+                    workingDirectory: raw.workingDirectory,
+                    team: raw.team,
+                    profile: raw.profile,
+                    firstSeen: raw.firstSeen ?? new Date().toISOString(),
+                    lastSeen: raw.lastSeen ?? new Date().toISOString(),
+                    messagesSent: typeof raw.messagesSent === 'number' ? raw.messagesSent : 0,
+                    messagesReceived: typeof raw.messagesReceived === 'number' ? raw.messagesReceived : 0,
+                };
+                this.agents.set(record.name, record);
+            }
+        }
+        catch (err) {
+            log.error('Failed to load agents.json', { error: String(err) });
+        }
+    }
+    save() {
+        try {
+            const data = JSON.stringify({ agents: this.getAgents() }, null, 2);
+            // Write atomically: write to temp file first, then rename
+            // This prevents race conditions where readers see partial/empty data
+            const tempPath = `${this.registryPath}.tmp`;
+            fs.writeFileSync(tempPath, data, 'utf-8');
+            fs.renameSync(tempPath, this.registryPath);
+        }
+        catch (err) {
+            log.error('Failed to write agents.json', { error: String(err) });
+        }
+    }
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/agent-registry.js.map

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

package/dist/agent-signing.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Agent Authentication via Cryptographic Signing
+ *
+ * Provides agent identity verification through message signing.
+ * Extends the existing UID/GID-based auth with cryptographic guarantees.
+ *
+ * Features:
+ * - HMAC-SHA256 for shared-secret signing (simpler deployment)
+ * - Ed25519 for asymmetric signing (zero-trust mode)
+ * - Message signature verification
+ * - Key rotation support
+ * - Agent identity attestation
+ */
+export interface AgentKeyPair {
+    /** Agent identifier */
+    agentName: string;
+    /** Public key (hex) for asymmetric, or key ID for HMAC */
+    publicKey: string;
+    /** Private/secret key (hex) - never transmitted */
+    privateKey: string;
+    /** Key creation timestamp */
+    createdAt: number;
+    /** Optional expiry timestamp */
+    expiresAt?: number;
+    /** Signing algorithm */
+    algorithm: 'hmac-sha256' | 'ed25519';
+}
+export interface SignedMessage {
+    /** Original message content */
+    content: string;
+    /** Signature (hex) */
+    signature: string;
+    /** Signing agent */
+    signer: string;
+    /** Timestamp of signing */
+    signedAt: number;
+    /** Key ID used (for rotation support) */
+    keyId: string;
+    /** Algorithm used */
+    algorithm: 'hmac-sha256' | 'ed25519';
+}
+export interface VerificationResult {
+    valid: boolean;
+    error?: string;
+    signer?: string;
+    signedAt?: number;
+}
+export interface AgentSigningConfig {
+    /** Enable message signing (default: false) */
+    enabled: boolean;
+    /** Signing algorithm */
+    algorithm: 'hmac-sha256' | 'ed25519';
+    /** Require signatures on all messages */
+    requireSignatures: boolean;
+    /** Allow unsigned messages from specific agents */
+    allowUnsignedFrom?: string[];
+    /** Key directory path */
+    keyDir?: string;
+    /** Shared secret for HMAC mode (all agents share) */
+    sharedSecret?: string;
+    /** Key rotation interval in hours (0 = no rotation) */
+    keyRotationHours?: number;
+}
+/**
+ * Generate a new agent key pair.
+ */
+export declare function generateAgentKey(agentName: string, algorithm?: 'hmac-sha256' | 'ed25519', expiresInHours?: number): AgentKeyPair;
+/**
+ * Save agent key to disk (private key file).
+ */
+export declare function saveAgentKey(key: AgentKeyPair, keyDir?: string): void;
+/**
+ * Load agent key from disk.
+ */
+export declare function loadAgentKey(agentName: string, keyDir?: string): AgentKeyPair | null;
+/**
+ * Load or generate agent key.
+ */
+export declare function getOrCreateAgentKey(agentName: string, config: AgentSigningConfig, keyDir?: string): AgentKeyPair;
+/**
+ * Sign a message using the agent's private key.
+ */
+export declare function signMessage(content: string, key: AgentKeyPair): SignedMessage;
+/**
+ * Sign with shared secret (HMAC mode where all agents share a secret).
+ */
+export declare function signWithSharedSecret(content: string, agentName: string, sharedSecret: string): SignedMessage;
+/**
+ * Verify a signed message using the agent's public key.
+ */
+export declare function verifyMessage(signed: SignedMessage, key: AgentKeyPair): VerificationResult;
+/**
+ * Verify an Ed25519 signed message using only the public key.
+ * This is the key advantage of asymmetric signing - verifiers don't need the private key.
+ */
+export declare function verifyEd25519WithPublicKey(signed: SignedMessage, publicKeyPem: string, expectedSigner: string): VerificationResult;
+/**
+ * Verify with shared secret.
+ */
+export declare function verifyWithSharedSecret(signed: SignedMessage, sharedSecret: string): VerificationResult;
+/**
+ * Manages agent signing keys and verification.
+ */
+export declare class AgentSigningManager {
+    private config;
+    private keyDir;
+    private keys;
+    constructor(config?: Partial<AgentSigningConfig>, keyDir?: string);
+    /**
+     * Check if signing is enabled.
+     */
+    get enabled(): boolean;
+    /**
+     * Get or load key for an agent.
+     */
+    getKey(agentName: string): AgentKeyPair | null;
+    /**
+     * Register a new agent (generate and save key).
+     */
+    registerAgent(agentName: string): AgentKeyPair;
+    /**
+     * Sign a message for an agent.
+     */
+    sign(agentName: string, content: string): SignedMessage | null;
+    /**
+     * Verify a signed message.
+     */
+    verify(signed: SignedMessage): VerificationResult;
+    /**
+     * Check if a message requires verification.
+     */
+    requiresVerification(agentName: string): boolean;
+    /**
+     * Rotate key for an agent.
+     */
+    rotateKey(agentName: string): AgentKeyPair;
+    /**
+     * Export public key for an agent (for sharing with other systems).
+     */
+    exportPublicKey(agentName: string): {
+        agentName: string;
+        publicKey: string;
+        algorithm: string;
+    } | null;
+}
+/**
+ * Attach signature to protocol envelope.
+ */
+export declare function attachSignature(envelope: Record<string, unknown>, signed: SignedMessage): Record<string, unknown>;
+/**
+ * Extract signature from protocol envelope.
+ */
+export declare function extractSignature(envelope: Record<string, unknown>): SignedMessage | null;
+/**
+ * Load signing configuration from file.
+ */
+export declare function loadSigningConfig(configPath?: string): AgentSigningConfig;
+//# sourceMappingURL=agent-signing.d.ts.map

package/dist/agent-signing.d.ts.map

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