@defai.digital/agent-domain 13.0.3

package/dist/prompt-executor.js

@@ -0,0 +1,211 @@
+/**
+ * Prompt Executor Implementation
+ *
+ * Bridges the agent domain with LLM providers for real prompt execution.
+ * This file provides both a stub executor for testing and a factory
+ * for creating real executors with provider integration.
+ */
+/**
+ * Stub prompt executor for testing and development
+ * Returns mock responses without calling real providers
+ *
+ * WARNING: This executor returns fake responses. For production use,
+ * inject a real PromptExecutor via config.promptExecutor.
+ */
+export class StubPromptExecutor {
+    defaultProvider;
+    hasWarnedOnce = false;
+    constructor(defaultProvider = 'claude') {
+        this.defaultProvider = defaultProvider;
+    }
+    async execute(request) {
+        // Warn once on first use (not on every call to avoid log spam)
+        if (!this.hasWarnedOnce) {
+            console.warn('[WARN] StubPromptExecutor: Using mock responses. ' +
+                'For production, inject a real PromptExecutor via config.promptExecutor.');
+            this.hasWarnedOnce = true;
+        }
+        const startTime = Date.now();
+        // Simulate some processing time
+        await new Promise((resolve) => setTimeout(resolve, 10));
+        return {
+            success: true,
+            content: `[Stub Response] This is a mock response for prompt: "${request.prompt.substring(0, 100)}..."`,
+            provider: request.provider ?? this.defaultProvider,
+            model: request.model ?? 'stub-model',
+            latencyMs: Date.now() - startTime,
+            usage: {
+                inputTokens: Math.ceil(request.prompt.length / 4),
+                outputTokens: 50,
+                totalTokens: Math.ceil(request.prompt.length / 4) + 50,
+            },
+        };
+    }
+    async isProviderAvailable(_providerId) {
+        return true;
+    }
+    async getAvailableProviders() {
+        return [this.defaultProvider];
+    }
+    getDefaultProvider() {
+        return this.defaultProvider;
+    }
+}
+/**
+ * Real prompt executor that uses the provider registry
+ */
+export class ProviderPromptExecutor {
+    registry;
+    config;
+    constructor(registry, config) {
+        this.registry = registry;
+        this.config = config;
+    }
+    async execute(request) {
+        const startTime = Date.now();
+        const providerId = request.provider ?? this.config.defaultProvider;
+        // Get the provider
+        const provider = this.registry.get(providerId);
+        if (provider === undefined) {
+            return {
+                success: false,
+                error: `Provider "${providerId}" not found`,
+                errorCode: 'PROVIDER_NOT_FOUND',
+                latencyMs: Date.now() - startTime,
+            };
+        }
+        // Check if provider is available
+        const isAvailable = await provider.isAvailable();
+        if (!isAvailable) {
+            return {
+                success: false,
+                error: `Provider "${providerId}" is not available (CLI not installed or not in PATH)`,
+                errorCode: 'PROVIDER_UNAVAILABLE',
+                provider: providerId,
+                latencyMs: Date.now() - startTime,
+            };
+        }
+        // Determine model to use
+        let model = request.model;
+        if (!model) {
+            // Use configured default for this provider, or provider's default model
+            model = this.config.defaultModels?.[providerId];
+            if (!model) {
+                const models = provider.getModels();
+                const defaultModel = models.find((m) => m.isDefault) ?? models[0];
+                model = defaultModel?.modelId;
+            }
+        }
+        if (!model) {
+            return {
+                success: false,
+                error: `No model specified and no default model available for provider "${providerId}"`,
+                errorCode: 'NO_MODEL',
+                provider: providerId,
+                latencyMs: Date.now() - startTime,
+            };
+        }
+        try {
+            // Build completion request with only defined properties
+            const completionRequest = {
+                requestId: crypto.randomUUID(),
+                model,
+                messages: [{ role: 'user', content: request.prompt }],
+            };
+            if (request.systemPrompt !== undefined) {
+                completionRequest.systemPrompt = request.systemPrompt;
+            }
+            if (request.maxTokens !== undefined) {
+                completionRequest.maxTokens = request.maxTokens;
+            }
+            if (request.temperature !== undefined) {
+                completionRequest.temperature = request.temperature;
+            }
+            const timeout = request.timeout ?? this.config.defaultTimeout;
+            if (timeout !== undefined) {
+                completionRequest.timeout = timeout;
+            }
+            // Execute the completion
+            const response = await provider.complete(completionRequest);
+            if (response.success) {
+                return {
+                    success: true,
+                    content: response.content,
+                    provider: providerId,
+                    model: response.model ?? model,
+                    latencyMs: response.latencyMs,
+                    usage: response.usage,
+                };
+            }
+            else {
+                return {
+                    success: false,
+                    error: response.error?.message ?? 'Unknown error',
+                    errorCode: response.error?.category ?? 'UNKNOWN',
+                    provider: providerId,
+                    model,
+                    latencyMs: response.latencyMs,
+                };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                errorCode: 'EXECUTION_ERROR',
+                provider: providerId,
+                model,
+                latencyMs: Date.now() - startTime,
+            };
+        }
+    }
+    async isProviderAvailable(providerId) {
+        const provider = this.registry.get(providerId);
+        if (provider === undefined) {
+            return false;
+        }
+        return provider.isAvailable();
+    }
+    async getAvailableProviders() {
+        const providerIds = this.registry.getProviderIds();
+        const available = [];
+        for (const providerId of providerIds) {
+            const provider = this.registry.get(providerId);
+            if (provider !== undefined) {
+                const isAvailable = await provider.isAvailable();
+                if (isAvailable) {
+                    available.push(providerId);
+                }
+            }
+        }
+        return available;
+    }
+    getDefaultProvider() {
+        return this.config.defaultProvider;
+    }
+}
+/**
+ * Creates a stub prompt executor for testing
+ */
+export function createStubPromptExecutor(defaultProvider = 'claude') {
+    return new StubPromptExecutor(defaultProvider);
+}
+/**
+ * Creates a real prompt executor using a provider registry
+ *
+ * @example
+ * ```typescript
+ * import { createProviderRegistry } from '@defai.digital/providers';
+ * import { createProviderPromptExecutor } from '@defai.digital/agent-domain';
+ *
+ * const registry = createProviderRegistry();
+ * const executor = createProviderPromptExecutor(registry, {
+ *   defaultProvider: 'claude',
+ *   defaultTimeout: 120000,
+ * });
+ * ```
+ */
+export function createProviderPromptExecutor(registry, config) {
+    return new ProviderPromptExecutor(registry, config);
+}
+//# sourceMappingURL=prompt-executor.js.map

package/dist/prompt-executor.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Agent Registry Implementation
+ *
+ * Manages agent profile registration, lookup, and lifecycle.
+ */
+import { type AgentProfile } from '@defai.digital/contracts';
+import type { AgentRegistry, AgentFilter } from './types.js';
+/**
+ * In-memory agent registry implementation
+ */
+export declare class InMemoryAgentRegistry implements AgentRegistry {
+    private readonly agents;
+    /**
+     * Register a new agent profile
+     */
+    register(profile: AgentProfile): Promise<void>;
+    /**
+     * Get an agent by ID
+     */
+    get(agentId: string): Promise<AgentProfile | undefined>;
+    /**
+     * List all registered agents with optional filtering
+     */
+    list(filter?: AgentFilter): Promise<AgentProfile[]>;
+    /**
+     * Update an agent profile
+     */
+    update(agentId: string, updates: Partial<AgentProfile>): Promise<void>;
+    /**
+     * Remove an agent
+     */
+    remove(agentId: string): Promise<void>;
+    /**
+     * Check if an agent exists
+     */
+    exists(agentId: string): Promise<boolean>;
+    /**
+     * Clear all agents (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get the count of registered agents
+     */
+    get size(): number;
+}
+/**
+ * Agent registry error
+ */
+export declare class AgentRegistryError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Creates a new in-memory agent registry
+ */
+export declare function createAgentRegistry(): AgentRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAE1D;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBpD;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAI7D;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgCzD;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB5E;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5C;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/registry.js

@@ -0,0 +1,123 @@
+/**
+ * Agent Registry Implementation
+ *
+ * Manages agent profile registration, lookup, and lifecycle.
+ */
+import { validateAgentProfile, AgentErrorCode, } from '@defai.digital/contracts';
+/**
+ * In-memory agent registry implementation
+ */
+export class InMemoryAgentRegistry {
+    agents = new Map();
+    /**
+     * Register a new agent profile
+     */
+    async register(profile) {
+        // Validate the profile
+        const validated = validateAgentProfile(profile);
+        // Check for duplicate
+        if (this.agents.has(validated.agentId)) {
+            throw new AgentRegistryError(AgentErrorCode.AGENT_VALIDATION_ERROR, `Agent with ID "${validated.agentId}" already exists`);
+        }
+        // Add timestamps
+        const now = new Date().toISOString();
+        const withTimestamps = {
+            ...validated,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.agents.set(validated.agentId, withTimestamps);
+    }
+    /**
+     * Get an agent by ID
+     */
+    async get(agentId) {
+        return this.agents.get(agentId);
+    }
+    /**
+     * List all registered agents with optional filtering
+     */
+    async list(filter) {
+        let agents = Array.from(this.agents.values());
+        if (filter !== undefined) {
+            if (filter.team !== undefined) {
+                agents = agents.filter((a) => a.team === filter.team);
+            }
+            if (filter.tags !== undefined && filter.tags.length > 0) {
+                agents = agents.filter((a) => a.tags !== undefined &&
+                    filter.tags.some((tag) => a.tags.includes(tag)));
+            }
+            if (filter.enabled !== undefined) {
+                agents = agents.filter((a) => a.enabled === filter.enabled);
+            }
+            if (filter.capability !== undefined) {
+                agents = agents.filter((a) => a.capabilities !== undefined &&
+                    a.capabilities.includes(filter.capability));
+            }
+        }
+        return agents;
+    }
+    /**
+     * Update an agent profile
+     */
+    async update(agentId, updates) {
+        const existing = this.agents.get(agentId);
+        if (existing === undefined) {
+            throw new AgentRegistryError(AgentErrorCode.AGENT_NOT_FOUND, `Agent with ID "${agentId}" not found`);
+        }
+        // Merge and validate
+        const merged = {
+            ...existing,
+            ...updates,
+            agentId, // Cannot change ID
+            updatedAt: new Date().toISOString(),
+        };
+        const validated = validateAgentProfile(merged);
+        this.agents.set(agentId, validated);
+    }
+    /**
+     * Remove an agent
+     */
+    async remove(agentId) {
+        if (!this.agents.has(agentId)) {
+            throw new AgentRegistryError(AgentErrorCode.AGENT_NOT_FOUND, `Agent with ID "${agentId}" not found`);
+        }
+        this.agents.delete(agentId);
+    }
+    /**
+     * Check if an agent exists
+     */
+    async exists(agentId) {
+        return this.agents.has(agentId);
+    }
+    /**
+     * Clear all agents (useful for testing)
+     */
+    clear() {
+        this.agents.clear();
+    }
+    /**
+     * Get the count of registered agents
+     */
+    get size() {
+        return this.agents.size;
+    }
+}
+/**
+ * Agent registry error
+ */
+export class AgentRegistryError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'AgentRegistryError';
+    }
+}
+/**
+ * Creates a new in-memory agent registry
+ */
+export function createAgentRegistry() {
+    return new InMemoryAgentRegistry();
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/selection-service.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Agent Selection Service
+ *
+ * Domain service for agent recommendation and capability discovery.
+ * Implements contract-defined invariants for agent selection.
+ *
+ * Invariants:
+ * - INV-AGT-SEL-001: Selection is deterministic (same input = same output)
+ * - INV-AGT-SEL-002: Confidence scores must be between 0 and 1
+ * - INV-AGT-SEL-003: Results must be sorted by confidence descending
+ * - INV-AGT-SEL-004: Always returns at least one result (fallback to 'standard')
+ * - INV-AGT-SEL-005: exampleTasks boost confidence when matched
+ * - INV-AGT-SEL-006: notForTasks reduce confidence when matched
+ */
+import type { AgentRecommendRequest, AgentRecommendResult, AgentCapabilitiesRequest, AgentCapabilitiesResult } from '@defai.digital/contracts';
+import type { AgentRegistry } from './types.js';
+/**
+ * Selection service port interface
+ */
+export interface AgentSelectionServicePort {
+    /**
+     * Recommend the best agent for a task
+     */
+    recommend(request: AgentRecommendRequest): Promise<AgentRecommendResult>;
+    /**
+     * Get all agent capabilities
+     */
+    getCapabilities(request: AgentCapabilitiesRequest): Promise<AgentCapabilitiesResult>;
+}
+/**
+ * Agent Selection Service
+ *
+ * Implements deterministic agent selection based on task matching.
+ */
+export declare class AgentSelectionService implements AgentSelectionServicePort {
+    private readonly registry;
+    constructor(registry: AgentRegistry);
+    /**
+     * Recommend the best agent for a task
+     *
+     * Implements:
+     * - INV-AGT-SEL-001: Deterministic selection
+     * - INV-AGT-SEL-002: Confidence range [0,1]
+     * - INV-AGT-SEL-003: Sorted by confidence descending
+     * - INV-AGT-SEL-004: Fallback to 'standard'
+     */
+    recommend(request: AgentRecommendRequest): Promise<AgentRecommendResult>;
+    /**
+     * Get all agent capabilities
+     */
+    getCapabilities(request: AgentCapabilitiesRequest): Promise<AgentCapabilitiesResult>;
+    /**
+     * Score an agent for a task
+     *
+     * Implements:
+     * - INV-AGT-SEL-002: Confidence clamped to [0,1]
+     * - INV-AGT-SEL-005: exampleTasks boost
+     * - INV-AGT-SEL-006: notForTasks penalty
+     */
+    private scoreAgent;
+    /**
+     * Normalize text for comparison
+     */
+    private normalizeText;
+    /**
+     * Extract meaningful words from text
+     */
+    private extractWords;
+}
+/**
+ * Creates an agent selection service
+ */
+export declare function createAgentSelectionService(registry: AgentRegistry): AgentSelectionServicePort;
+//# sourceMappingURL=selection-service.d.ts.map

package/dist/selection-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-service.d.ts","sourceRoot":"","sources":["../src/selection-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAEV,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EAExB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuDhD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEzE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACtF;AAMD;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,yBAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,aAAa;IAEpD;;;;;;;;OAQG;IACG,SAAS,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmD9E;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA6C1F;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IA6JlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,YAAY;CAMrB;AAMD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,aAAa,GACtB,yBAAyB,CAE3B"}