universal-agent-memory 1.0.16 → 1.0.18

package/dist/models/types.d.ts

@@ -0,0 +1,370 @@
+/**
+ * Multi-Model Architecture Types
+ *
+ * Defines types for the two-tier agentic architecture:
+ * - Tier 1 (Planner): High-level reasoning and task decomposition
+ * - Tier 2 (Executor): Concrete implementation following planner specs
+ */
+import { z } from 'zod';
+export type ModelProvider = 'anthropic' | 'deepseek' | 'openai' | 'zhipu' | 'ollama' | 'custom';
+export type ModelRole = 'planner' | 'executor' | 'reviewer' | 'fallback';
+export type TaskComplexity = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Model configuration for a specific provider/model combination
+ */
+export declare const ModelConfigSchemaModels: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    provider: z.ZodEnum<["anthropic", "deepseek", "openai", "zhipu", "ollama", "custom"]>;
+    apiModel: z.ZodString;
+    endpoint: z.ZodOptional<z.ZodString>;
+    apiKeyEnvVar: z.ZodOptional<z.ZodString>;
+    maxContextTokens: z.ZodDefault<z.ZodNumber>;
+    costPer1MInput: z.ZodOptional<z.ZodNumber>;
+    costPer1MOutput: z.ZodOptional<z.ZodNumber>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+    name: string;
+    maxContextTokens: number;
+    id: string;
+    apiModel: string;
+    capabilities: string[];
+    endpoint?: string | undefined;
+    apiKeyEnvVar?: string | undefined;
+    costPer1MInput?: number | undefined;
+    costPer1MOutput?: number | undefined;
+}, {
+    provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+    name: string;
+    id: string;
+    apiModel: string;
+    endpoint?: string | undefined;
+    maxContextTokens?: number | undefined;
+    apiKeyEnvVar?: string | undefined;
+    costPer1MInput?: number | undefined;
+    costPer1MOutput?: number | undefined;
+    capabilities?: string[] | undefined;
+}>;
+export type ModelConfig = z.infer<typeof ModelConfigSchemaModels>;
+/**
+ * Pre-defined model presets for common configurations
+ */
+export declare const ModelPresets: Record<string, ModelConfig>;
+export type ModelPresetId = keyof typeof ModelPresets;
+/**
+ * Role assignment configuration - maps roles to models
+ */
+export declare const RoleAssignmentSchema: z.ZodObject<{
+    role: z.ZodEnum<["planner", "executor", "reviewer", "fallback"]>;
+    modelId: z.ZodString;
+    maxTokensPerRequest: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    role: "planner" | "executor" | "reviewer" | "fallback";
+    modelId: string;
+    timeout: number;
+    maxTokensPerRequest?: number | undefined;
+}, {
+    role: "planner" | "executor" | "reviewer" | "fallback";
+    modelId: string;
+    maxTokensPerRequest?: number | undefined;
+    timeout?: number | undefined;
+}>;
+export type RoleAssignment = z.infer<typeof RoleAssignmentSchema>;
+/**
+ * Routing rule for task-to-model mapping
+ */
+export declare const RoutingRuleSchema: z.ZodObject<{
+    complexity: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "critical"]>>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    taskType: z.ZodOptional<z.ZodEnum<["planning", "coding", "refactoring", "bug-fix", "review", "documentation"]>>;
+    targetRole: z.ZodEnum<["planner", "executor", "reviewer", "fallback"]>;
+    priority: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    targetRole: "planner" | "executor" | "reviewer" | "fallback";
+    priority: number;
+    complexity?: "low" | "medium" | "high" | "critical" | undefined;
+    keywords?: string[] | undefined;
+    taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+}, {
+    targetRole: "planner" | "executor" | "reviewer" | "fallback";
+    complexity?: "low" | "medium" | "high" | "critical" | undefined;
+    keywords?: string[] | undefined;
+    taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+    priority?: number | undefined;
+}>;
+export type RoutingRule = z.infer<typeof RoutingRuleSchema>;
+/**
+ * Multi-Model Architecture configuration schema for .uam.json
+ */
+export declare const MultiModelConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    models: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        provider: z.ZodEnum<["anthropic", "deepseek", "openai", "zhipu", "ollama", "custom"]>;
+        apiModel: z.ZodString;
+        endpoint: z.ZodOptional<z.ZodString>;
+        apiKeyEnvVar: z.ZodOptional<z.ZodString>;
+        maxContextTokens: z.ZodDefault<z.ZodNumber>;
+        costPer1MInput: z.ZodOptional<z.ZodNumber>;
+        costPer1MOutput: z.ZodOptional<z.ZodNumber>;
+        capabilities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+        name: string;
+        maxContextTokens: number;
+        id: string;
+        apiModel: string;
+        capabilities: string[];
+        endpoint?: string | undefined;
+        apiKeyEnvVar?: string | undefined;
+        costPer1MInput?: number | undefined;
+        costPer1MOutput?: number | undefined;
+    }, {
+        provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+        name: string;
+        id: string;
+        apiModel: string;
+        endpoint?: string | undefined;
+        maxContextTokens?: number | undefined;
+        apiKeyEnvVar?: string | undefined;
+        costPer1MInput?: number | undefined;
+        costPer1MOutput?: number | undefined;
+        capabilities?: string[] | undefined;
+    }>]>, "many">>;
+    roles: z.ZodOptional<z.ZodObject<{
+        planner: z.ZodDefault<z.ZodString>;
+        executor: z.ZodDefault<z.ZodString>;
+        reviewer: z.ZodOptional<z.ZodString>;
+        fallback: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        planner: string;
+        executor: string;
+        fallback: string;
+        reviewer?: string | undefined;
+    }, {
+        planner?: string | undefined;
+        executor?: string | undefined;
+        reviewer?: string | undefined;
+        fallback?: string | undefined;
+    }>>;
+    routing: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        complexity: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "critical"]>>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        taskType: z.ZodOptional<z.ZodEnum<["planning", "coding", "refactoring", "bug-fix", "review", "documentation"]>>;
+        targetRole: z.ZodEnum<["planner", "executor", "reviewer", "fallback"]>;
+        priority: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        targetRole: "planner" | "executor" | "reviewer" | "fallback";
+        priority: number;
+        complexity?: "low" | "medium" | "high" | "critical" | undefined;
+        keywords?: string[] | undefined;
+        taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+    }, {
+        targetRole: "planner" | "executor" | "reviewer" | "fallback";
+        complexity?: "low" | "medium" | "high" | "critical" | undefined;
+        keywords?: string[] | undefined;
+        taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+        priority?: number | undefined;
+    }>, "many">>;
+    costOptimization: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        targetReduction: z.ZodDefault<z.ZodNumber>;
+        maxPerformanceDegradation: z.ZodDefault<z.ZodNumber>;
+        fallbackThreshold: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        targetReduction: number;
+        maxPerformanceDegradation: number;
+        fallbackThreshold: number;
+    }, {
+        enabled?: boolean | undefined;
+        targetReduction?: number | undefined;
+        maxPerformanceDegradation?: number | undefined;
+        fallbackThreshold?: number | undefined;
+    }>>;
+    routingStrategy: z.ZodDefault<z.ZodEnum<["cost-optimized", "performance-first", "balanced", "adaptive"]>>;
+    plannerSettings: z.ZodOptional<z.ZodObject<{
+        complexityThreshold: z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>;
+        maxPlanningTokens: z.ZodDefault<z.ZodNumber>;
+        enableDecomposition: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        complexityThreshold: "low" | "medium" | "high";
+        maxPlanningTokens: number;
+        enableDecomposition: boolean;
+    }, {
+        complexityThreshold?: "low" | "medium" | "high" | undefined;
+        maxPlanningTokens?: number | undefined;
+        enableDecomposition?: boolean | undefined;
+    }>>;
+    executorSettings: z.ZodOptional<z.ZodObject<{
+        retryWithFallback: z.ZodDefault<z.ZodBoolean>;
+        maxRetries: z.ZodDefault<z.ZodNumber>;
+        stepTimeout: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        retryWithFallback: boolean;
+        maxRetries: number;
+        stepTimeout: number;
+    }, {
+        retryWithFallback?: boolean | undefined;
+        maxRetries?: number | undefined;
+        stepTimeout?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    models: (string | {
+        provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+        name: string;
+        maxContextTokens: number;
+        id: string;
+        apiModel: string;
+        capabilities: string[];
+        endpoint?: string | undefined;
+        apiKeyEnvVar?: string | undefined;
+        costPer1MInput?: number | undefined;
+        costPer1MOutput?: number | undefined;
+    })[];
+    routingStrategy: "cost-optimized" | "performance-first" | "balanced" | "adaptive";
+    roles?: {
+        planner: string;
+        executor: string;
+        fallback: string;
+        reviewer?: string | undefined;
+    } | undefined;
+    routing?: {
+        targetRole: "planner" | "executor" | "reviewer" | "fallback";
+        priority: number;
+        complexity?: "low" | "medium" | "high" | "critical" | undefined;
+        keywords?: string[] | undefined;
+        taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+    }[] | undefined;
+    costOptimization?: {
+        enabled: boolean;
+        targetReduction: number;
+        maxPerformanceDegradation: number;
+        fallbackThreshold: number;
+    } | undefined;
+    plannerSettings?: {
+        complexityThreshold: "low" | "medium" | "high";
+        maxPlanningTokens: number;
+        enableDecomposition: boolean;
+    } | undefined;
+    executorSettings?: {
+        retryWithFallback: boolean;
+        maxRetries: number;
+        stepTimeout: number;
+    } | undefined;
+}, {
+    enabled?: boolean | undefined;
+    models?: (string | {
+        provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+        name: string;
+        id: string;
+        apiModel: string;
+        endpoint?: string | undefined;
+        maxContextTokens?: number | undefined;
+        apiKeyEnvVar?: string | undefined;
+        costPer1MInput?: number | undefined;
+        costPer1MOutput?: number | undefined;
+        capabilities?: string[] | undefined;
+    })[] | undefined;
+    roles?: {
+        planner?: string | undefined;
+        executor?: string | undefined;
+        reviewer?: string | undefined;
+        fallback?: string | undefined;
+    } | undefined;
+    routing?: {
+        targetRole: "planner" | "executor" | "reviewer" | "fallback";
+        complexity?: "low" | "medium" | "high" | "critical" | undefined;
+        keywords?: string[] | undefined;
+        taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+        priority?: number | undefined;
+    }[] | undefined;
+    routingStrategy?: "cost-optimized" | "performance-first" | "balanced" | "adaptive" | undefined;
+    costOptimization?: {
+        enabled?: boolean | undefined;
+        targetReduction?: number | undefined;
+        maxPerformanceDegradation?: number | undefined;
+        fallbackThreshold?: number | undefined;
+    } | undefined;
+    plannerSettings?: {
+        complexityThreshold?: "low" | "medium" | "high" | undefined;
+        maxPlanningTokens?: number | undefined;
+        enableDecomposition?: boolean | undefined;
+    } | undefined;
+    executorSettings?: {
+        retryWithFallback?: boolean | undefined;
+        maxRetries?: number | undefined;
+        stepTimeout?: number | undefined;
+    } | undefined;
+}>;
+export type MultiModelConfig = z.infer<typeof MultiModelConfigSchema>;
+/**
+ * Task classification result from the router
+ */
+export interface TaskClassificationResult {
+    complexity: TaskComplexity;
+    taskType: 'planning' | 'coding' | 'refactoring' | 'bug-fix' | 'review' | 'documentation';
+    keywords: string[];
+    estimatedTokens: number;
+    requiresPlanning: boolean;
+    suggestedModel: string;
+    fallbackModel: string;
+    reasoning: string;
+}
+/**
+ * Execution plan from the planner
+ */
+export interface ExecutionPlan {
+    id: string;
+    originalTask: string;
+    subtasks: Subtask[];
+    dependencies: Map<string, string[]>;
+    modelAssignments: Map<string, string>;
+    estimatedCost: number;
+    estimatedDuration: number;
+    created: Date;
+}
+export interface Subtask {
+    id: string;
+    title: string;
+    description: string;
+    type: 'planning' | 'coding' | 'refactoring' | 'bug-fix' | 'review' | 'documentation';
+    complexity: TaskComplexity;
+    inputs: string[];
+    outputs: string[];
+    constraints: string[];
+}
+/**
+ * Execution result for tracking
+ */
+export interface ExecutionResult {
+    planId: string;
+    subtaskId: string;
+    modelUsed: string;
+    success: boolean;
+    output: string;
+    error?: string;
+    tokensUsed: {
+        input: number;
+        output: number;
+    };
+    cost: number;
+    duration: number;
+    retryCount: number;
+}
+/**
+ * Model selection result from the router
+ */
+export interface ModelSelection {
+    model: ModelConfig;
+    fallback?: ModelConfig;
+    role: ModelRole;
+    reasoning: string;
+    estimatedCost: number;
+}
+export declare const DEFAULT_ROUTING_RULES: RoutingRule[];
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/models/types.js

@@ -0,0 +1,181 @@
+/**
+ * Multi-Model Architecture Types
+ *
+ * Defines types for the two-tier agentic architecture:
+ * - Tier 1 (Planner): High-level reasoning and task decomposition
+ * - Tier 2 (Executor): Concrete implementation following planner specs
+ */
+import { z } from 'zod';
+/**
+ * Model configuration for a specific provider/model combination
+ */
+export const ModelConfigSchemaModels = z.object({
+    id: z.string(),
+    name: z.string(),
+    provider: z.enum(['anthropic', 'deepseek', 'openai', 'zhipu', 'ollama', 'custom']),
+    apiModel: z.string(),
+    endpoint: z.string().optional(),
+    apiKeyEnvVar: z.string().optional(),
+    maxContextTokens: z.number().default(128000),
+    costPer1MInput: z.number().optional(),
+    costPer1MOutput: z.number().optional(),
+    capabilities: z.array(z.string()).default([]),
+});
+/**
+ * Pre-defined model presets for common configurations
+ */
+export const ModelPresets = {
+    'opus-4.5': {
+        id: 'opus-4.5',
+        name: 'Claude Opus 4.5',
+        provider: 'anthropic',
+        apiModel: 'claude-opus-4-5-20251101',
+        apiKeyEnvVar: 'ANTHROPIC_API_KEY',
+        maxContextTokens: 200000,
+        costPer1MInput: 5.0,
+        costPer1MOutput: 25.0,
+        capabilities: ['planning', 'complex-reasoning', 'code-generation', 'review'],
+    },
+    'deepseek-v3.2': {
+        id: 'deepseek-v3.2',
+        name: 'DeepSeek V3.2 Speciale',
+        provider: 'deepseek',
+        apiModel: 'deepseek-chat',
+        apiKeyEnvVar: 'DEEPSEEK_API_KEY',
+        maxContextTokens: 164000,
+        costPer1MInput: 0.25,
+        costPer1MOutput: 0.38,
+        capabilities: ['planning', 'code-generation', 'complex-reasoning'],
+    },
+    'deepseek-v3.2-exp': {
+        id: 'deepseek-v3.2-exp',
+        name: 'DeepSeek V3.2 Experimental',
+        provider: 'deepseek',
+        apiModel: 'deepseek-coder',
+        apiKeyEnvVar: 'DEEPSEEK_API_KEY',
+        maxContextTokens: 164000,
+        costPer1MInput: 0.21,
+        costPer1MOutput: 0.32,
+        capabilities: ['code-generation', 'execution'],
+    },
+    'glm-4.7': {
+        id: 'glm-4.7',
+        name: 'GLM 4.7',
+        provider: 'zhipu',
+        apiModel: 'glm-4.7',
+        apiKeyEnvVar: 'ZHIPU_API_KEY',
+        maxContextTokens: 128000,
+        costPer1MInput: 1.0,
+        costPer1MOutput: 2.0,
+        capabilities: ['code-generation', 'execution', 'simple-tasks'],
+    },
+    'gpt-5.2': {
+        id: 'gpt-5.2',
+        name: 'GPT 5.2',
+        provider: 'openai',
+        apiModel: 'gpt-5.2',
+        apiKeyEnvVar: 'OPENAI_API_KEY',
+        maxContextTokens: 128000,
+        costPer1MInput: 2.5,
+        costPer1MOutput: 10.0,
+        capabilities: ['planning', 'code-generation', 'complex-reasoning'],
+    },
+};
+/**
+ * Role assignment configuration - maps roles to models
+ */
+export const RoleAssignmentSchema = z.object({
+    role: z.enum(['planner', 'executor', 'reviewer', 'fallback']),
+    modelId: z.string(),
+    // Optional constraints for this role
+    maxTokensPerRequest: z.number().optional(),
+    timeout: z.number().default(300000), // 5 min default
+});
+/**
+ * Routing rule for task-to-model mapping
+ */
+export const RoutingRuleSchema = z.object({
+    // Condition matching
+    complexity: z.enum(['low', 'medium', 'high', 'critical']).optional(),
+    keywords: z.array(z.string()).optional(),
+    taskType: z.enum(['planning', 'coding', 'refactoring', 'bug-fix', 'review', 'documentation']).optional(),
+    // Target model
+    targetRole: z.enum(['planner', 'executor', 'reviewer', 'fallback']),
+    // Priority (higher = evaluated first)
+    priority: z.number().default(0),
+});
+/**
+ * Multi-Model Architecture configuration schema for .uam.json
+ */
+export const MultiModelConfigSchema = z.object({
+    enabled: z.boolean().default(false),
+    // Model definitions (can use presets or custom)
+    models: z.array(z.union([
+        z.string(), // Preset ID like 'opus-4.5'
+        ModelConfigSchemaModels, // Full custom config
+    ])).default(['opus-4.5']),
+    // Role assignments
+    roles: z.object({
+        planner: z.string().default('opus-4.5'),
+        executor: z.string().default('glm-4.7'),
+        reviewer: z.string().optional(),
+        fallback: z.string().default('opus-4.5'),
+    }).optional(),
+    // Routing rules (optional - uses defaults if not specified)
+    routing: z.array(RoutingRuleSchema).optional(),
+    // Cost optimization settings
+    costOptimization: z.object({
+        enabled: z.boolean().default(true),
+        // Target cost reduction percentage
+        targetReduction: z.number().default(90),
+        // Max performance degradation allowed
+        maxPerformanceDegradation: z.number().default(20),
+        // Auto-fallback threshold (failures before escalating)
+        fallbackThreshold: z.number().default(3),
+    }).optional(),
+    // Routing behavior
+    routingStrategy: z.enum([
+        'cost-optimized', // Minimize cost, use cheapest capable model
+        'performance-first', // Maximize quality, use best model
+        'balanced', // Balance cost and performance
+        'adaptive', // Learn from task results
+    ]).default('balanced'),
+    // Planner-specific settings
+    plannerSettings: z.object({
+        // When to invoke planner vs direct execution
+        complexityThreshold: z.enum(['low', 'medium', 'high']).default('medium'),
+        // Max tokens for planning phase
+        maxPlanningTokens: z.number().default(10000),
+        // Decompose tasks into subtasks
+        enableDecomposition: z.boolean().default(true),
+    }).optional(),
+    // Executor settings
+    executorSettings: z.object({
+        // Retry failed executions with fallback model
+        retryWithFallback: z.boolean().default(true),
+        // Max retries before escalating
+        maxRetries: z.number().default(2),
+        // Timeout per execution step
+        stepTimeout: z.number().default(120000), // 2 min
+    }).optional(),
+});
+// Default routing rules
+export const DEFAULT_ROUTING_RULES = [
+    // Critical tasks always use planner + fallback
+    { complexity: 'critical', targetRole: 'planner', priority: 100 },
+    { keywords: ['security', 'authentication', 'deployment', 'migration'], targetRole: 'planner', priority: 90 },
+    // High complexity uses planner
+    { complexity: 'high', targetRole: 'planner', priority: 80 },
+    { keywords: ['architecture', 'design', 'refactor'], targetRole: 'planner', priority: 70 },
+    { taskType: 'planning', targetRole: 'planner', priority: 70 },
+    // Medium complexity can go to executor directly
+    { complexity: 'medium', targetRole: 'executor', priority: 50 },
+    { taskType: 'coding', targetRole: 'executor', priority: 50 },
+    { taskType: 'bug-fix', targetRole: 'executor', priority: 50 },
+    // Low complexity always executor
+    { complexity: 'low', targetRole: 'executor', priority: 30 },
+    { taskType: 'documentation', targetRole: 'executor', priority: 30 },
+    // Review tasks use reviewer or planner
+    { taskType: 'review', targetRole: 'reviewer', priority: 60 },
+];
+//# sourceMappingURL=types.js.map

package/dist/models/types.js.map

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