agent-relay 1.0.22 → 1.2.0

package/dist/memory/service.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Memory Service
+ *
+ * A simplified service wrapper around memory adapters for use in hooks.
+ * Provides a consistent interface and handles common operations.
+ */
+import type { MemoryAdapter, MemoryService, MemoryConfig } from './types.js';
+/**
+ * Options for creating a memory service
+ */
+export interface MemoryServiceOptions {
+    /** Pre-configured adapter to use */
+    adapter?: MemoryAdapter;
+    /** Configuration for creating a new adapter */
+    config?: Partial<MemoryConfig>;
+    /** Default agent ID for all operations */
+    agentId?: string;
+    /** Default project ID for all operations */
+    projectId?: string;
+    /** Default session ID for all operations */
+    sessionId?: string;
+}
+/**
+ * Create a memory service instance
+ *
+ * @param options - Service configuration
+ * @returns Memory service instance
+ *
+ * @example
+ * ```typescript
+ * // Create with default in-memory adapter
+ * const memory = createMemoryService();
+ *
+ * // Create with specific adapter
+ * const adapter = await createMemoryAdapter({ type: 'supermemory', apiKey });
+ * const memory = createMemoryService({ adapter });
+ *
+ * // Create with config
+ * const memory = createMemoryService({
+ *   config: { type: 'supermemory' },
+ *   agentId: 'my-agent',
+ * });
+ * ```
+ */
+export declare function createMemoryService(options?: MemoryServiceOptions): MemoryService & {
+    getUnderlyingAdapter(): MemoryAdapter | null;
+    close(): Promise<void>;
+};
+//# sourceMappingURL=service.d.ts.map

package/dist/memory/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/memory/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EAKb,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,GAAG;IACnF,oBAAoB,IAAI,aAAa,GAAG,IAAI,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAEA"}

package/dist/memory/service.js

@@ -0,0 +1,146 @@
+/**
+ * Memory Service
+ *
+ * A simplified service wrapper around memory adapters for use in hooks.
+ * Provides a consistent interface and handles common operations.
+ */
+import { createMemoryAdapter } from './factory.js';
+/**
+ * Internal memory service implementation
+ */
+class MemoryServiceImpl {
+    adapter = null;
+    adapterPromise = null;
+    options;
+    available = false;
+    constructor(options = {}) {
+        this.options = options;
+        if (options.adapter) {
+            this.adapter = options.adapter;
+            this.available = true;
+        }
+    }
+    /**
+     * Lazily initialize the adapter
+     */
+    async getAdapter() {
+        if (this.adapter) {
+            return this.adapter;
+        }
+        if (!this.adapterPromise) {
+            this.adapterPromise = this.initAdapter();
+        }
+        return this.adapterPromise;
+    }
+    async initAdapter() {
+        try {
+            const config = this.options.config ?? {};
+            this.adapter = await createMemoryAdapter({
+                ...config,
+                defaultAgentId: config.defaultAgentId ?? this.options.agentId,
+                defaultProjectId: config.defaultProjectId ?? this.options.projectId,
+            });
+            this.available = true;
+            return this.adapter;
+        }
+        catch (error) {
+            console.error('[memory] Failed to initialize adapter:', error);
+            this.available = false;
+            return null;
+        }
+    }
+    async add(content, options) {
+        const adapter = await this.getAdapter();
+        if (!adapter) {
+            return { success: false, error: 'Memory adapter not available' };
+        }
+        return adapter.add(content, {
+            ...options,
+            agentId: options?.agentId ?? this.options.agentId,
+            projectId: options?.projectId ?? this.options.projectId,
+            sessionId: options?.sessionId ?? this.options.sessionId,
+        });
+    }
+    async search(query) {
+        const adapter = await this.getAdapter();
+        if (!adapter) {
+            return [];
+        }
+        const searchQuery = typeof query === 'string'
+            ? {
+                query,
+                agentId: this.options.agentId,
+                projectId: this.options.projectId,
+            }
+            : {
+                ...query,
+                agentId: query.agentId ?? this.options.agentId,
+                projectId: query.projectId ?? this.options.projectId,
+            };
+        return adapter.search(searchQuery);
+    }
+    async delete(id) {
+        const adapter = await this.getAdapter();
+        if (!adapter) {
+            return { success: false, error: 'Memory adapter not available' };
+        }
+        return adapter.delete(id);
+    }
+    async list(limit) {
+        const adapter = await this.getAdapter();
+        if (!adapter || !adapter.list) {
+            return [];
+        }
+        return adapter.list({
+            limit,
+            agentId: this.options.agentId,
+            projectId: this.options.projectId,
+        });
+    }
+    isAvailable() {
+        return this.available;
+    }
+    /**
+     * Get the underlying adapter (for advanced use)
+     */
+    getUnderlyingAdapter() {
+        return this.adapter;
+    }
+    /**
+     * Close the adapter
+     */
+    async close() {
+        if (this.adapter?.close) {
+            await this.adapter.close();
+        }
+        this.adapter = null;
+        this.adapterPromise = null;
+        this.available = false;
+    }
+}
+/**
+ * Create a memory service instance
+ *
+ * @param options - Service configuration
+ * @returns Memory service instance
+ *
+ * @example
+ * ```typescript
+ * // Create with default in-memory adapter
+ * const memory = createMemoryService();
+ *
+ * // Create with specific adapter
+ * const adapter = await createMemoryAdapter({ type: 'supermemory', apiKey });
+ * const memory = createMemoryService({ adapter });
+ *
+ * // Create with config
+ * const memory = createMemoryService({
+ *   config: { type: 'supermemory' },
+ *   agentId: 'my-agent',
+ * });
+ * ```
+ */
+export function createMemoryService(options) {
+    return new MemoryServiceImpl(options);
+}
+//# sourceMappingURL=service.js.map

package/dist/memory/service.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Agent Relay Memory Types
+ *
+ * Core types for the memory adapter system. Memory adapters provide
+ * semantic storage and retrieval of agent learnings and context.
+ */
+/**
+ * A memory entry stored in the system
+ */
+export interface MemoryEntry {
+    /** Unique identifier for the memory */
+    id: string;
+    /** The actual content of the memory */
+    content: string;
+    /** Timestamp when memory was created */
+    createdAt: number;
+    /** Timestamp when memory was last accessed */
+    lastAccessedAt?: number;
+    /** Optional metadata tags */
+    tags?: string[];
+    /** Source of the memory (e.g., 'agent', 'user', 'session') */
+    source?: string;
+    /** Agent that created the memory */
+    agentId?: string;
+    /** Project associated with this memory */
+    projectId?: string;
+    /** Session ID where memory was created */
+    sessionId?: string;
+    /** Relevance score (when returned from search) */
+    score?: number;
+    /** Additional structured metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Query options for searching memories
+ */
+export interface MemorySearchQuery {
+    /** Semantic search query text */
+    query: string;
+    /** Maximum number of results to return */
+    limit?: number;
+    /** Minimum relevance score threshold (0-1) */
+    minScore?: number;
+    /** Filter by tags */
+    tags?: string[];
+    /** Filter by agent ID */
+    agentId?: string;
+    /** Filter by project ID */
+    projectId?: string;
+    /** Filter by memories created after this timestamp */
+    since?: number;
+    /** Filter by memories created before this timestamp */
+    before?: number;
+}
+/**
+ * Options for adding a memory
+ */
+export interface AddMemoryOptions {
+    /** Optional tags for the memory */
+    tags?: string[];
+    /** Source of the memory */
+    source?: string;
+    /** Agent creating the memory */
+    agentId?: string;
+    /** Project context */
+    projectId?: string;
+    /** Session context */
+    sessionId?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of a memory operation
+ */
+export interface MemoryResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** ID of the affected memory (if applicable) */
+    id?: string;
+    /** Error message if operation failed */
+    error?: string;
+}
+/**
+ * Memory adapter interface
+ *
+ * All memory backends must implement this interface to be used
+ * with the agent-relay memory system.
+ */
+export interface MemoryAdapter {
+    /** Unique identifier for this adapter type */
+    readonly type: string;
+    /**
+     * Initialize the adapter (connect to backend, etc.)
+     */
+    init(): Promise<void>;
+    /**
+     * Add a new memory to the system
+     * @param content - The content to remember
+     * @param options - Optional metadata and context
+     * @returns Result with the new memory's ID
+     */
+    add(content: string, options?: AddMemoryOptions): Promise<MemoryResult>;
+    /**
+     * Search for relevant memories
+     * @param query - Search parameters
+     * @returns Array of matching memories, ordered by relevance
+     */
+    search(query: MemorySearchQuery): Promise<MemoryEntry[]>;
+    /**
+     * Get a specific memory by ID
+     * @param id - The memory ID
+     * @returns The memory entry or null if not found
+     */
+    get(id: string): Promise<MemoryEntry | null>;
+    /**
+     * Delete a memory
+     * @param id - The memory ID to delete
+     * @returns Result indicating success/failure
+     */
+    delete(id: string): Promise<MemoryResult>;
+    /**
+     * Update an existing memory
+     * @param id - The memory ID
+     * @param content - New content
+     * @param options - Optional updated metadata
+     * @returns Result indicating success/failure
+     */
+    update?(id: string, content: string, options?: Partial<AddMemoryOptions>): Promise<MemoryResult>;
+    /**
+     * List recent memories
+     * @param options - Filter options
+     * @returns Array of recent memories
+     */
+    list?(options?: {
+        limit?: number;
+        agentId?: string;
+        projectId?: string;
+    }): Promise<MemoryEntry[]>;
+    /**
+     * Clear all memories matching criteria
+     * @param options - Filter for what to clear
+     */
+    clear?(options?: {
+        agentId?: string;
+        projectId?: string;
+        before?: number;
+    }): Promise<MemoryResult>;
+    /**
+     * Get statistics about stored memories
+     */
+    stats?(): Promise<{
+        totalCount: number;
+        byAgent?: Record<string, number>;
+        byProject?: Record<string, number>;
+    }>;
+    /**
+     * Close the adapter and release resources
+     */
+    close?(): Promise<void>;
+}
+/**
+ * Configuration for memory adapters
+ */
+export interface MemoryConfig {
+    /** Adapter type: 'inmemory', 'supermemory', 'claude', etc. */
+    type: string;
+    /** API key for external services */
+    apiKey?: string;
+    /** API endpoint URL (for supermemory, etc.) */
+    endpoint?: string;
+    /** Default agent ID to use */
+    defaultAgentId?: string;
+    /** Default project ID to use */
+    defaultProjectId?: string;
+    /** Additional adapter-specific options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Memory service interface for hooks
+ *
+ * This is a simplified interface exposed to hooks for memory operations.
+ */
+export interface MemoryService {
+    /** Add a memory */
+    add(content: string, options?: AddMemoryOptions): Promise<MemoryResult>;
+    /** Search for memories */
+    search(query: string | MemorySearchQuery): Promise<MemoryEntry[]>;
+    /** Delete a memory */
+    delete(id: string): Promise<MemoryResult>;
+    /** List recent memories */
+    list(limit?: number): Promise<MemoryEntry[]>;
+    /** Check if memory service is available */
+    isAvailable(): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

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

package/dist/memory/types.js

@@ -0,0 +1,8 @@
+/**
+ * Agent Relay Memory Types
+ *
+ * Core types for the memory adapter system. Memory adapters provide
+ * semantic storage and retrieval of agent learnings and context.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/policy/agent-policy.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Agent Policy Service
+ *
+ * Manages agent permissions and rules with multi-level fallback:
+ * 1. Repo-level policy (.claude/agents/*.md)
+ * 2. Workspace-level policy (from cloud API)
+ * 3. Built-in safe defaults
+ *
+ * Provides spawn authorization, tool permission checks, and audit logging.
+ */
+/**
+ * PRPM-style policy file format (YAML or JSON)
+ *
+ * Policy files are loaded from (in order of precedence):
+ * 1. User-level: ~/.config/agent-relay/policies/*.yaml (NOT in source control)
+ * 2. Cloud: Workspace config from dashboard (stored in database)
+ *
+ * PRPM packages install to the user-level location to avoid polluting repos.
+ * Install via: prpm install @org/strict-agent-rules --global
+ *
+ * Example policy file (~/.config/agent-relay/policies/strict-rules.yaml):
+ * ```yaml
+ * name: strict-spawn-rules
+ * version: 1.0.0
+ * description: Restrict agent spawning to leads only
+ *
+ * agents:
+ *   - name: Lead
+ *     canSpawn: ["*"]
+ *     canMessage: ["*"]
+ *   - name: Worker*
+ *     canSpawn: []
+ *     canMessage: ["Lead", "Coordinator"]
+ *
+ * settings:
+ *   requireExplicitAgents: false
+ *   auditEnabled: true
+ * ```
+ */
+/**
+ * Agent policy definition
+ */
+export interface AgentPolicy {
+    /** Agent name pattern (supports wildcards: "Lead", "Worker*", "*") */
+    name: string;
+    /** Allowed tools (empty = all allowed, ["none"] = no tools) */
+    allowedTools?: string[];
+    /** Agents this agent can spawn (empty = can spawn any) */
+    canSpawn?: string[];
+    /** Agents this agent can message (empty = can message any) */
+    canMessage?: string[];
+    /** Maximum concurrent spawns allowed */
+    maxSpawns?: number;
+    /** Rate limit: messages per minute */
+    rateLimit?: number;
+    /** Whether this agent can be spawned by others */
+    canBeSpawned?: boolean;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Workspace-level policy configuration
+ */
+export interface WorkspacePolicy {
+    /** Default policy for agents without explicit config */
+    defaultPolicy: AgentPolicy;
+    /** Named agent policies */
+    agents: AgentPolicy[];
+    /** Global settings */
+    settings: {
+        /** Require explicit agent definitions (reject unknown agents) */
+        requireExplicitAgents: boolean;
+        /** Enable audit logging */
+        auditEnabled: boolean;
+        /** Maximum total agents */
+        maxTotalAgents: number;
+    };
+}
+/**
+ * Policy decision with reasoning
+ */
+export interface PolicyDecision {
+    allowed: boolean;
+    reason: string;
+    policySource: 'repo' | 'local' | 'workspace' | 'default';
+    matchedPolicy?: AgentPolicy;
+}
+/**
+ * Audit log entry
+ */
+export interface AuditEntry {
+    timestamp: number;
+    action: 'spawn' | 'message' | 'tool' | 'release';
+    actor: string;
+    target?: string;
+    decision: PolicyDecision;
+    context?: Record<string, unknown>;
+}
+/**
+ * Cloud policy fetcher interface
+ * Implement this to fetch workspace policies from cloud API
+ */
+export interface CloudPolicyFetcher {
+    getWorkspacePolicy(workspaceId: string): Promise<WorkspacePolicy | null>;
+}
+export declare class AgentPolicyService {
+    private projectRoot;
+    private workspaceId?;
+    private cloudFetcher?;
+    private cachedWorkspacePolicy?;
+    private cachedLocalPolicy?;
+    private policyCacheExpiry;
+    private localPolicyCacheExpiry;
+    private auditLog;
+    private strictMode;
+    /** Cache TTL in milliseconds (5 minutes) */
+    private static readonly CACHE_TTL_MS;
+    /** Local policy cache TTL (1 minute - files can change) */
+    private static readonly LOCAL_CACHE_TTL_MS;
+    /** Maximum audit log entries to keep in memory */
+    private static readonly MAX_AUDIT_ENTRIES;
+    constructor(options: {
+        projectRoot: string;
+        workspaceId?: string;
+        cloudFetcher?: CloudPolicyFetcher;
+        strictMode?: boolean;
+    });
+    /**
+     * Get the user-level policies directory
+     * Uses ~/.config/agent-relay/policies/ (not in source control)
+     */
+    private getUserPoliciesDir;
+    /**
+     * Load policies from user-level directory (PRPM-installable)
+     * Files are YAML/JSON with agent policy definitions
+     * Location: ~/.config/agent-relay/policies/*.yaml
+     */
+    private loadLocalPolicies;
+    /**
+     * Simple YAML parser for policy files
+     * Handles basic key: value and arrays
+     */
+    private parseSimpleYaml;
+    /**
+     * Parse a YAML value string
+     */
+    private parseValue;
+    /**
+     * Check if an agent can spawn another agent
+     */
+    canSpawn(spawnerName: string, targetName: string, targetCli: string): Promise<PolicyDecision>;
+    /**
+     * Check if an agent can send a message to another agent
+     */
+    canMessage(senderName: string, recipientName: string): Promise<PolicyDecision>;
+    /**
+     * Check if an agent can use a specific tool
+     */
+    canUseTool(agentName: string, toolName: string): Promise<PolicyDecision>;
+    /**
+     * Get the effective policy for an agent
+     * Fallback chain: repo config → user PRPM policies → cloud workspace → defaults
+     */
+    getAgentPolicy(agentName: string): Promise<{
+        matchedPolicy: AgentPolicy;
+        policySource: 'repo' | 'local' | 'workspace' | 'default';
+    }>;
+    /**
+     * Get workspace policy from cloud (with caching)
+     */
+    private getWorkspacePolicy;
+    /**
+     * Find matching policy from a list (supports wildcards)
+     */
+    private findMatchingPolicy;
+    /**
+     * Check if a name matches any pattern in the list
+     * Supports: exact match, prefix* match, *suffix match, * (all)
+     */
+    private matchesPattern;
+    /**
+     * Convert AgentConfig to AgentPolicy
+     */
+    private configToPolicy;
+    /**
+     * Record an audit entry
+     */
+    private audit;
+    /**
+     * Get audit log entries
+     */
+    getAuditLog(options?: {
+        limit?: number;
+        action?: AuditEntry['action'];
+        actor?: string;
+        deniedOnly?: boolean;
+    }): AuditEntry[];
+    /**
+     * Clear audit log
+     */
+    clearAuditLog(): void;
+    /**
+     * Invalidate cached workspace policy
+     */
+    invalidateCache(): void;
+    /**
+     * Get a human-readable policy summary for an agent
+     * This can be injected into agent prompts to inform them of their permissions
+     */
+    getPolicySummary(agentName: string): Promise<string>;
+    /**
+     * Get a concise policy instruction for injection into agent prompts
+     */
+    getPolicyInstruction(agentName: string): Promise<string | null>;
+}
+/**
+ * Create a policy service for a project
+ */
+export declare function createPolicyService(options: {
+    projectRoot: string;
+    workspaceId?: string;
+    cloudFetcher?: CloudPolicyFetcher;
+    strictMode?: boolean;
+}): AgentPolicyService;
+//# sourceMappingURL=agent-policy.d.ts.map

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

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