agentic-flow 2.0.6 → 3.0.0-alpha.1

package/dist/agentic-flow/src/reasoningbank/types/index.d.ts

@@ -0,0 +1,123 @@
+/**
+ * ReasoningBank Type Definitions
+ * Based on arXiv:2509.25140 (Google DeepMind)
+ */
+export interface Memory {
+    id: string;
+    title: string;
+    description: string;
+    content: string;
+    confidence: number;
+    usage_count: number;
+    created_at: string;
+    pattern_data: PatternData;
+}
+export interface PatternData {
+    domain: string;
+    error_type?: string;
+    success_pattern?: boolean;
+    failure_guardrail?: boolean;
+    [key: string]: any;
+}
+export interface PatternEmbedding {
+    pattern_id: string;
+    embedding: number[];
+}
+export interface TaskTrajectory {
+    id: string;
+    task_id: string;
+    trajectory: string;
+    verdict: 'Success' | 'Failure';
+    confidence: number;
+    created_at: string;
+}
+export interface MattsRun {
+    id: string;
+    task_id: string;
+    run_index: number;
+    result: string;
+    verdict: 'Success' | 'Failure';
+    confidence: number;
+    created_at: string;
+}
+export interface RetrievalOptions {
+    query: string;
+    domain?: string;
+    k?: number;
+    minConfidence?: number;
+    lambda?: number;
+}
+export interface ScoringWeights {
+    alpha: number;
+    beta: number;
+    gamma: number;
+    delta: number;
+}
+export interface JudgmentResult {
+    label: 'Success' | 'Failure';
+    confidence: number;
+    rationale?: string;
+}
+export interface ConsolidationOptions {
+    dedupeThreshold?: number;
+    prune?: {
+        maxAgeDays?: number;
+        minConfidence?: number;
+        unusedDays?: number;
+    };
+}
+export interface ConsolidationStats {
+    processed: number;
+    duplicates: number;
+    contradictions: number;
+    pruned: number;
+    durationMs: number;
+}
+export interface ReasoningBankConfig {
+    dbPath: string;
+    embeddings?: {
+        provider?: 'openai' | 'anthropic' | 'hash';
+        model?: string;
+        cache?: {
+            l1?: boolean;
+            l2?: boolean;
+            redisUrl?: string;
+        };
+    };
+    retrieval?: {
+        k?: number;
+        minConfidence?: number;
+        weights?: Partial<ScoringWeights>;
+    };
+    consolidation?: {
+        scheduleEvery?: number;
+        autoRun?: boolean;
+    };
+    piiScrub?: {
+        enabled?: boolean;
+    };
+}
+export interface TaskExecutionOptions {
+    taskId: string;
+    agentId: string;
+    query: string;
+    domain: string;
+    executeFn: (memories: Memory[]) => Promise<{
+        success: boolean;
+        log: string;
+    }>;
+}
+export interface TaskResult {
+    success: boolean;
+    summary: string;
+    memories: Memory[];
+    verdict: JudgmentResult;
+}
+export interface MemoryCandidate extends Memory {
+    score: number;
+    similarity: number;
+    recency: number;
+    reliability: number;
+    diversityPenalty: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/agentic-flow/src/reasoningbank/types/index.d.ts.map

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

package/dist/agentic-flow/src/reasoningbank/types/index.js

@@ -0,0 +1,6 @@
+/**
+ * ReasoningBank Type Definitions
+ * Based on arXiv:2509.25140 (Google DeepMind)
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/agentic-flow/src/reasoningbank/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/reasoningbank/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * ReasoningBank Type Definitions\n * Based on arXiv:2509.25140 (Google DeepMind)\n */\n\nexport interface Memory {\n  id: string;\n  title: string;\n  description: string;\n  content: string;\n  confidence: number;\n  usage_count: number;\n  created_at: string;\n  pattern_data: PatternData;\n}\n\nexport interface PatternData {\n  domain: string;\n  error_type?: string;\n  success_pattern?: boolean;\n  failure_guardrail?: boolean;\n  [key: string]: any;\n}\n\nexport interface PatternEmbedding {\n  pattern_id: string;\n  embedding: number[];\n}\n\nexport interface TaskTrajectory {\n  id: string;\n  task_id: string;\n  trajectory: string;\n  verdict: 'Success' | 'Failure';\n  confidence: number;\n  created_at: string;\n}\n\nexport interface MattsRun {\n  id: string;\n  task_id: string;\n  run_index: number;\n  result: string;\n  verdict: 'Success' | 'Failure';\n  confidence: number;\n  created_at: string;\n}\n\nexport interface RetrievalOptions {\n  query: string;\n  domain?: string;\n  k?: number;\n  minConfidence?: number;\n  lambda?: number; // MMR diversity parameter\n}\n\nexport interface ScoringWeights {\n  alpha: number; // Similarity weight\n  beta: number;  // Recency weight\n  gamma: number; // Reliability weight\n  delta: number; // Diversity penalty weight\n}\n\nexport interface JudgmentResult {\n  label: 'Success' | 'Failure';\n  confidence: number;\n  rationale?: string;\n}\n\nexport interface ConsolidationOptions {\n  dedupeThreshold?: number;\n  prune?: {\n    maxAgeDays?: number;\n    minConfidence?: number;\n    unusedDays?: number;\n  };\n}\n\nexport interface ConsolidationStats {\n  processed: number;\n  duplicates: number;\n  contradictions: number;\n  pruned: number;\n  durationMs: number;\n}\n\nexport interface ReasoningBankConfig {\n  dbPath: string;\n  embeddings?: {\n    provider?: 'openai' | 'anthropic' | 'hash';\n    model?: string;\n    cache?: {\n      l1?: boolean;\n      l2?: boolean;\n      redisUrl?: string;\n    };\n  };\n  retrieval?: {\n    k?: number;\n    minConfidence?: number;\n    weights?: Partial<ScoringWeights>;\n  };\n  consolidation?: {\n    scheduleEvery?: number;\n    autoRun?: boolean;\n  };\n  piiScrub?: {\n    enabled?: boolean;\n  };\n}\n\nexport interface TaskExecutionOptions {\n  taskId: string;\n  agentId: string;\n  query: string;\n  domain: string;\n  executeFn: (memories: Memory[]) => Promise<{ success: boolean; log: string }>;\n}\n\nexport interface TaskResult {\n  success: boolean;\n  summary: string;\n  memories: Memory[];\n  verdict: JudgmentResult;\n}\n\nexport interface MemoryCandidate extends Memory {\n  score: number;\n  similarity: number;\n  recency: number;\n  reliability: number;\n  diversityPenalty: number;\n}\n"]}

package/dist/agentic-flow/src/reasoningbank/utils/config.d.ts

@@ -0,0 +1,61 @@
+export interface ReasoningBankConfig {
+    retrieve: {
+        k: number;
+        alpha: number;
+        beta: number;
+        gamma: number;
+        delta: number;
+        recency_half_life_days: number;
+        min_score: number;
+    };
+    judge: {
+        model: string;
+        max_tokens: number;
+        temperature: number;
+        confidence_threshold?: number;
+    };
+    distill: {
+        model?: string;
+        max_tokens?: number;
+        temperature?: number;
+        max_items_success: number;
+        max_items_failure: number;
+        confidence_prior_success: number;
+        confidence_prior_failure: number;
+    };
+    consolidate: {
+        duplicate_threshold: number;
+        contradiction_threshold: number;
+        trigger_threshold: number;
+        prune_age_days: number;
+        prune_min_confidence: number;
+        min_confidence_keep: number;
+    };
+    matts: {
+        parallel_k: number;
+        sequential_k: number;
+        sequential_r: number;
+        sequential_stop_on_success: boolean;
+        confidence_boost: number;
+    };
+    embeddings: {
+        provider: 'claude' | 'openai';
+        model: string;
+        dims: number;
+        dimensions: number;
+        cache_ttl_seconds: number;
+    };
+    governance: {
+        scrub_pii?: boolean;
+        pii_scrubber: boolean;
+        tenant_scoped?: boolean;
+    };
+    features?: {
+        enable_pre_task_hook?: boolean;
+        enable_post_task_hook?: boolean;
+        enable_matts_parallel?: boolean;
+    };
+}
+export declare function loadConfig(): ReasoningBankConfig;
+export declare function clearConfigCache(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/agentic-flow/src/reasoningbank/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../src/reasoningbank/utils/config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE;QACR,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,sBAAsB,EAAE,MAAM,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,wBAAwB,EAAE,MAAM,CAAC;QACjC,wBAAwB,EAAE,MAAM,CAAC;KAClC,CAAC;IACF,WAAW,EAAE;QACX,mBAAmB,EAAE,MAAM,CAAC;QAC5B,uBAAuB,EAAE,MAAM,CAAC;QAChC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,0BAA0B,EAAE,OAAO,CAAC;QACpC,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,UAAU,EAAE;QACV,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,UAAU,EAAE;QACV,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,YAAY,EAAE,OAAO,CAAC;QACtB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,qBAAqB,CAAC,EAAE,OAAO,CAAC;KACjC,CAAC;CACH;AAqFD,wBAAgB,UAAU,IAAI,mBAAmB,CAqFhD;AAED,wBAAgB,gBAAgB,SAE/B"}

package/dist/agentic-flow/src/reasoningbank/utils/config.js

@@ -0,0 +1,170 @@
+import { parse } from 'yaml';
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+let configCache = null;
+// Default configuration
+const DEFAULT_CONFIG = {
+    retrieve: {
+        k: 3,
+        alpha: 0.65,
+        beta: 0.15,
+        gamma: 0.20,
+        delta: 0.10,
+        recency_half_life_days: 45,
+        min_score: 0.3
+    },
+    judge: {
+        model: 'claude-sonnet-4-5-20250929',
+        max_tokens: 512,
+        temperature: 0,
+        confidence_threshold: 0.5
+    },
+    distill: {
+        model: undefined,
+        max_tokens: undefined,
+        temperature: undefined,
+        max_items_success: 3,
+        max_items_failure: 2,
+        confidence_prior_success: 0.75,
+        confidence_prior_failure: 0.60
+    },
+    consolidate: {
+        duplicate_threshold: 0.95,
+        contradiction_threshold: 0.85,
+        trigger_threshold: 20,
+        prune_age_days: 180,
+        prune_min_confidence: 0.3,
+        min_confidence_keep: 0.5
+    },
+    matts: {
+        parallel_k: 3,
+        sequential_k: 5,
+        sequential_r: 5,
+        sequential_stop_on_success: true,
+        confidence_boost: 0.05
+    },
+    embeddings: {
+        provider: 'claude',
+        model: 'claude-sonnet-4-5-20250929',
+        dims: 1024,
+        dimensions: 1024,
+        cache_ttl_seconds: 3600
+    },
+    governance: {
+        scrub_pii: true,
+        pii_scrubber: true,
+        tenant_scoped: false
+    },
+    features: {
+        enable_pre_task_hook: true,
+        enable_post_task_hook: true,
+        enable_matts_parallel: true
+    }
+};
+// Try multiple paths to find config file
+function findConfigPath() {
+    const paths = [
+        // Development: relative to source file
+        join(__dirname, '../config/reasoningbank.yaml'),
+        // npm package: relative to dist file
+        join(__dirname, '../../config/reasoningbank.yaml'),
+        // User override: current working directory
+        join(process.cwd(), '.swarm/reasoningbank.yaml'),
+        join(process.cwd(), 'reasoningbank.yaml')
+    ];
+    for (const path of paths) {
+        if (existsSync(path)) {
+            return path;
+        }
+    }
+    return null;
+}
+export function loadConfig() {
+    if (configCache)
+        return configCache;
+    const configPath = findConfigPath();
+    // If no config file found, use defaults
+    if (!configPath) {
+        configCache = DEFAULT_CONFIG;
+        return configCache;
+    }
+    try {
+        const yamlContent = readFileSync(configPath, 'utf-8');
+        const parsed = parse(yamlContent);
+        // Handle nested reasoningbank: key
+        const raw = parsed.reasoningbank || parsed;
+        // Map the full config to our simplified interface
+        configCache = {
+            retrieve: {
+                k: raw.retrieve?.k ?? 3,
+                alpha: raw.retrieve?.alpha ?? 0.65,
+                beta: raw.retrieve?.beta ?? 0.15,
+                gamma: raw.retrieve?.gamma ?? 0.20,
+                delta: raw.retrieve?.delta ?? 0.10,
+                recency_half_life_days: raw.retrieve?.recency_half_life_days ?? 45,
+                min_score: raw.retrieve?.min_score ?? 0.3
+            },
+            judge: {
+                model: raw.judge?.model ?? 'claude-sonnet-4-5-20250929',
+                max_tokens: raw.judge?.max_tokens ?? 512,
+                temperature: raw.judge?.temperature ?? 0,
+                confidence_threshold: raw.judge?.fallback_confidence ?? 0.5
+            },
+            distill: {
+                model: raw.distill?.model,
+                max_tokens: raw.distill?.max_tokens,
+                temperature: raw.distill?.temperature,
+                max_items_success: raw.distill?.max_items_per_trajectory ?? 3,
+                max_items_failure: 2,
+                confidence_prior_success: raw.distill?.success_confidence_prior ?? 0.75,
+                confidence_prior_failure: raw.distill?.failure_confidence_prior ?? 0.60
+            },
+            consolidate: {
+                duplicate_threshold: raw.consolidate?.dedup_similarity_threshold ?? 0.95,
+                contradiction_threshold: raw.consolidate?.contradiction_threshold ?? 0.85,
+                trigger_threshold: raw.consolidate?.run_every_new_items ?? 20,
+                prune_age_days: raw.consolidate?.prune_age_days ?? 180,
+                prune_min_confidence: raw.consolidate?.min_confidence_keep ?? 0.3,
+                min_confidence_keep: raw.consolidate?.min_confidence_keep ?? 0.5
+            },
+            matts: {
+                parallel_k: raw.matts?.parallel?.k ?? 3,
+                sequential_k: raw.matts?.sequential?.r ?? 5,
+                sequential_r: raw.matts?.sequential?.r ?? 5,
+                sequential_stop_on_success: raw.matts?.sequential?.stop_on_success ?? true,
+                confidence_boost: 0.05
+            },
+            embeddings: {
+                provider: raw.embeddings?.provider ?? 'claude',
+                model: raw.embeddings?.model ?? 'claude-sonnet-4-5-20250929',
+                dims: raw.embeddings?.dimensions ?? 1024,
+                dimensions: raw.embeddings?.dimensions ?? 1024,
+                cache_ttl_seconds: raw.embeddings?.cache_ttl_seconds ?? 3600
+            },
+            governance: {
+                scrub_pii: raw.governance?.pii_scrubber ?? true,
+                pii_scrubber: raw.governance?.pii_scrubber ?? true,
+                tenant_scoped: raw.governance?.tenant_scoped ?? false
+            },
+            features: {
+                enable_pre_task_hook: raw.features?.enable_pre_task_hook ?? true,
+                enable_post_task_hook: raw.features?.enable_post_task_hook ?? true,
+                enable_matts_parallel: raw.features?.enable_matts_parallel ?? true
+            }
+        };
+        return configCache;
+    }
+    catch (error) {
+        // If config file exists but can't be read, use defaults
+        console.warn(`[ReasoningBank] Could not load config from ${configPath}, using defaults:`, error instanceof Error ? error.message : String(error));
+        configCache = DEFAULT_CONFIG;
+        return configCache;
+    }
+}
+export function clearConfigCache() {
+    configCache = null;
+}
+//# sourceMappingURL=config.js.map

package/dist/agentic-flow/src/reasoningbank/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../src/reasoningbank/utils/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { parse } from 'yaml';\nimport { readFileSync, existsSync } from 'fs';\nimport { join, dirname } from 'path';\nimport { fileURLToPath } from 'url';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nexport interface ReasoningBankConfig {\n  retrieve: {\n    k: number;\n    alpha: number;\n    beta: number;\n    gamma: number;\n    delta: number;\n    recency_half_life_days: number;\n    min_score: number;\n  };\n  judge: {\n    model: string;\n    max_tokens: number;\n    temperature: number;\n    confidence_threshold?: number;\n  };\n  distill: {\n    model?: string;\n    max_tokens?: number;\n    temperature?: number;\n    max_items_success: number;\n    max_items_failure: number;\n    confidence_prior_success: number;\n    confidence_prior_failure: number;\n  };\n  consolidate: {\n    duplicate_threshold: number;\n    contradiction_threshold: number;\n    trigger_threshold: number;\n    prune_age_days: number;\n    prune_min_confidence: number;\n    min_confidence_keep: number;\n  };\n  matts: {\n    parallel_k: number;\n    sequential_k: number;\n    sequential_r: number;\n    sequential_stop_on_success: boolean;\n    confidence_boost: number;\n  };\n  embeddings: {\n    provider: 'claude' | 'openai';\n    model: string;\n    dims: number;\n    dimensions: number;\n    cache_ttl_seconds: number;\n  };\n  governance: {\n    scrub_pii?: boolean;\n    pii_scrubber: boolean;\n    tenant_scoped?: boolean;\n  };\n  features?: {\n    enable_pre_task_hook?: boolean;\n    enable_post_task_hook?: boolean;\n    enable_matts_parallel?: boolean;\n  };\n}\n\nlet configCache: ReasoningBankConfig | null = null;\n\n// Default configuration\nconst DEFAULT_CONFIG: ReasoningBankConfig = {\n  retrieve: {\n    k: 3,\n    alpha: 0.65,\n    beta: 0.15,\n    gamma: 0.20,\n    delta: 0.10,\n    recency_half_life_days: 45,\n    min_score: 0.3\n  },\n  judge: {\n    model: 'claude-sonnet-4-5-20250929',\n    max_tokens: 512,\n    temperature: 0,\n    confidence_threshold: 0.5\n  },\n  distill: {\n    model: undefined,\n    max_tokens: undefined,\n    temperature: undefined,\n    max_items_success: 3,\n    max_items_failure: 2,\n    confidence_prior_success: 0.75,\n    confidence_prior_failure: 0.60\n  },\n  consolidate: {\n    duplicate_threshold: 0.95,\n    contradiction_threshold: 0.85,\n    trigger_threshold: 20,\n    prune_age_days: 180,\n    prune_min_confidence: 0.3,\n    min_confidence_keep: 0.5\n  },\n  matts: {\n    parallel_k: 3,\n    sequential_k: 5,\n    sequential_r: 5,\n    sequential_stop_on_success: true,\n    confidence_boost: 0.05\n  },\n  embeddings: {\n    provider: 'claude',\n    model: 'claude-sonnet-4-5-20250929',\n    dims: 1024,\n    dimensions: 1024,\n    cache_ttl_seconds: 3600\n  },\n  governance: {\n    scrub_pii: true,\n    pii_scrubber: true,\n    tenant_scoped: false\n  },\n  features: {\n    enable_pre_task_hook: true,\n    enable_post_task_hook: true,\n    enable_matts_parallel: true\n  }\n};\n\n// Try multiple paths to find config file\nfunction findConfigPath(): string | null {\n  const paths = [\n    // Development: relative to source file\n    join(__dirname, '../config/reasoningbank.yaml'),\n    // npm package: relative to dist file\n    join(__dirname, '../../config/reasoningbank.yaml'),\n    // User override: current working directory\n    join(process.cwd(), '.swarm/reasoningbank.yaml'),\n    join(process.cwd(), 'reasoningbank.yaml')\n  ];\n\n  for (const path of paths) {\n    if (existsSync(path)) {\n      return path;\n    }\n  }\n\n  return null;\n}\n\nexport function loadConfig(): ReasoningBankConfig {\n  if (configCache) return configCache;\n\n  const configPath = findConfigPath();\n\n  // If no config file found, use defaults\n  if (!configPath) {\n    configCache = DEFAULT_CONFIG;\n    return configCache;\n  }\n\n  try {\n    const yamlContent = readFileSync(configPath, 'utf-8');\n    const parsed = parse(yamlContent) as any;\n\n    // Handle nested reasoningbank: key\n    const raw = parsed.reasoningbank || parsed;\n\n    // Map the full config to our simplified interface\n    configCache = {\n      retrieve: {\n        k: raw.retrieve?.k ?? 3,\n        alpha: raw.retrieve?.alpha ?? 0.65,\n        beta: raw.retrieve?.beta ?? 0.15,\n        gamma: raw.retrieve?.gamma ?? 0.20,\n        delta: raw.retrieve?.delta ?? 0.10,\n        recency_half_life_days: raw.retrieve?.recency_half_life_days ?? 45,\n        min_score: raw.retrieve?.min_score ?? 0.3\n      },\n      judge: {\n        model: raw.judge?.model ?? 'claude-sonnet-4-5-20250929',\n        max_tokens: raw.judge?.max_tokens ?? 512,\n        temperature: raw.judge?.temperature ?? 0,\n        confidence_threshold: raw.judge?.fallback_confidence ?? 0.5\n      },\n      distill: {\n        model: raw.distill?.model,\n        max_tokens: raw.distill?.max_tokens,\n        temperature: raw.distill?.temperature,\n        max_items_success: raw.distill?.max_items_per_trajectory ?? 3,\n        max_items_failure: 2,\n        confidence_prior_success: raw.distill?.success_confidence_prior ?? 0.75,\n        confidence_prior_failure: raw.distill?.failure_confidence_prior ?? 0.60\n      },\n      consolidate: {\n        duplicate_threshold: raw.consolidate?.dedup_similarity_threshold ?? 0.95,\n        contradiction_threshold: raw.consolidate?.contradiction_threshold ?? 0.85,\n        trigger_threshold: raw.consolidate?.run_every_new_items ?? 20,\n        prune_age_days: raw.consolidate?.prune_age_days ?? 180,\n        prune_min_confidence: raw.consolidate?.min_confidence_keep ?? 0.3,\n        min_confidence_keep: raw.consolidate?.min_confidence_keep ?? 0.5\n      },\n      matts: {\n        parallel_k: raw.matts?.parallel?.k ?? 3,\n        sequential_k: raw.matts?.sequential?.r ?? 5,\n        sequential_r: raw.matts?.sequential?.r ?? 5,\n        sequential_stop_on_success: raw.matts?.sequential?.stop_on_success ?? true,\n        confidence_boost: 0.05\n      },\n      embeddings: {\n        provider: raw.embeddings?.provider ?? 'claude',\n        model: raw.embeddings?.model ?? 'claude-sonnet-4-5-20250929',\n        dims: raw.embeddings?.dimensions ?? 1024,\n        dimensions: raw.embeddings?.dimensions ?? 1024,\n        cache_ttl_seconds: raw.embeddings?.cache_ttl_seconds ?? 3600\n      },\n      governance: {\n        scrub_pii: raw.governance?.pii_scrubber ?? true,\n        pii_scrubber: raw.governance?.pii_scrubber ?? true,\n        tenant_scoped: raw.governance?.tenant_scoped ?? false\n      },\n      features: {\n        enable_pre_task_hook: raw.features?.enable_pre_task_hook ?? true,\n        enable_post_task_hook: raw.features?.enable_post_task_hook ?? true,\n        enable_matts_parallel: raw.features?.enable_matts_parallel ?? true\n      }\n    };\n\n    return configCache;\n  } catch (error) {\n    // If config file exists but can't be read, use defaults\n    console.warn(`[ReasoningBank] Could not load config from ${configPath}, using defaults:`, error instanceof Error ? error.message : String(error));\n    configCache = DEFAULT_CONFIG;\n    return configCache;\n  }\n}\n\nexport function clearConfigCache() {\n  configCache = null;\n}\n"]}

package/dist/agentic-flow/src/reasoningbank/utils/embeddings.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Embedding generation for semantic similarity
+ * Uses local transformers.js - no API key required!
+ */
+/**
+ * Compute embedding for text using local model
+ */
+export declare function computeEmbedding(text: string): Promise<Float32Array>;
+/**
+ * Batch compute embeddings (more efficient)
+ */
+export declare function computeEmbeddingBatch(texts: string[]): Promise<Float32Array[]>;
+/**
+ * Get embedding dimensions
+ */
+export declare function getEmbeddingDimensions(): number;
+/**
+ * Clear embedding cache
+ */
+export declare function clearEmbeddingCache(): void;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/agentic-flow/src/reasoningbank/utils/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../../../../src/reasoningbank/utils/embeddings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2DH;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAiD1E;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAEpF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AA+CD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/agentic-flow/src/reasoningbank/utils/embeddings.js

@@ -0,0 +1,156 @@
+/**
+ * Embedding generation for semantic similarity
+ * Uses local transformers.js - no API key required!
+ */
+import { pipeline, env } from '@xenova/transformers';
+import { loadConfig } from './config.js';
+// Configure transformers.js to use WASM backend only (avoid ONNX runtime issues)
+// The native ONNX runtime causes "DefaultLogger not registered" errors in Node.js
+env.backends.onnx.wasm.proxy = false; // Disable ONNX runtime proxy
+env.backends.onnx.wasm.numThreads = 1; // Single thread for stability
+let embeddingPipeline = null;
+let isInitializing = false;
+const embeddingCache = new Map();
+/**
+ * Initialize the embedding pipeline (lazy load)
+ */
+async function initializeEmbeddings() {
+    if (embeddingPipeline)
+        return;
+    if (isInitializing) {
+        // Wait for initialization to complete
+        while (isInitializing) {
+            await new Promise(resolve => setTimeout(resolve, 100));
+        }
+        return;
+    }
+    // Detect npx environment (known transformer initialization issues)
+    const isNpxEnv = process.env.npm_lifecycle_event === 'npx' ||
+        process.env.npm_execpath?.includes('npx') ||
+        process.cwd().includes('/_npx/') ||
+        process.cwd().includes('\\_npx\\');
+    if (isNpxEnv && !process.env.FORCE_TRANSFORMERS) {
+        console.log('[Embeddings] NPX environment detected - using hash-based embeddings');
+        console.log('[Embeddings] For semantic search, install globally: npm install -g claude-flow');
+        isInitializing = false;
+        return;
+    }
+    isInitializing = true;
+    console.log('[Embeddings] Initializing local embedding model (Xenova/all-MiniLM-L6-v2)...');
+    console.log('[Embeddings] First run will download ~23MB model...');
+    try {
+        embeddingPipeline = await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2', { quantized: true } // Smaller, faster
+        );
+        console.log('[Embeddings] Local model ready! (384 dimensions)');
+    }
+    catch (error) {
+        console.error('[Embeddings] Failed to initialize:', error?.message || error);
+        console.warn('[Embeddings] Falling back to hash-based embeddings');
+    }
+    finally {
+        isInitializing = false;
+    }
+}
+/**
+ * Compute embedding for text using local model
+ */
+export async function computeEmbedding(text) {
+    const config = loadConfig();
+    // Check cache
+    const cacheKey = `local:${text}`;
+    if (embeddingCache.has(cacheKey)) {
+        return embeddingCache.get(cacheKey);
+    }
+    let embedding;
+    // Initialize if needed
+    await initializeEmbeddings();
+    if (embeddingPipeline) {
+        try {
+            // Use transformers.js for real embeddings
+            const output = await embeddingPipeline(text, {
+                pooling: 'mean',
+                normalize: true
+            });
+            embedding = new Float32Array(output.data);
+        }
+        catch (error) {
+            console.error('[Embeddings] Generation failed:', error?.message || error);
+            embedding = hashEmbed(text, 384); // Fallback
+        }
+    }
+    else {
+        // Fallback to hash-based embeddings
+        const dims = config?.embeddings?.dimensions || 384;
+        embedding = hashEmbed(text, dims);
+    }
+    // Cache with LRU (limit 1000 entries)
+    if (embeddingCache.size > 1000) {
+        const firstKey = embeddingCache.keys().next().value;
+        if (firstKey) {
+            embeddingCache.delete(firstKey);
+        }
+    }
+    embeddingCache.set(cacheKey, embedding);
+    // Set TTL for cache entry
+    const ttl = config?.embeddings?.cache_ttl_seconds || 3600;
+    setTimeout(() => embeddingCache.delete(cacheKey), ttl * 1000);
+    return embedding;
+}
+/**
+ * Batch compute embeddings (more efficient)
+ */
+export async function computeEmbeddingBatch(texts) {
+    return Promise.all(texts.map(text => computeEmbedding(text)));
+}
+/**
+ * Get embedding dimensions
+ */
+export function getEmbeddingDimensions() {
+    return 384; // all-MiniLM-L6-v2 uses 384 dimensions
+}
+/**
+ * Deterministic hash-based embedding (fallback)
+ */
+function hashEmbed(text, dims) {
+    const hash = simpleHash(text);
+    const vec = new Float32Array(dims);
+    // Generate deterministic pseudo-random vector from hash
+    for (let i = 0; i < dims; i++) {
+        vec[i] = Math.sin(hash * (i + 1) * 0.01) + Math.cos(hash * i * 0.02);
+    }
+    return normalize(vec);
+}
+/**
+ * Simple string hash function
+ */
+function simpleHash(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        hash = ((hash << 5) - hash) + str.charCodeAt(i);
+        hash |= 0;
+    }
+    return Math.abs(hash);
+}
+/**
+ * Normalize vector to unit length
+ */
+function normalize(vec) {
+    let mag = 0;
+    for (let i = 0; i < vec.length; i++) {
+        mag += vec[i] * vec[i];
+    }
+    mag = Math.sqrt(mag);
+    if (mag === 0)
+        return vec;
+    for (let i = 0; i < vec.length; i++) {
+        vec[i] /= mag;
+    }
+    return vec;
+}
+/**
+ * Clear embedding cache
+ */
+export function clearEmbeddingCache() {
+    embeddingCache.clear();
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/agentic-flow/src/reasoningbank/utils/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../../../../src/reasoningbank/utils/embeddings.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Embedding generation for semantic similarity\n * Uses local transformers.js - no API key required!\n */\n\nimport { pipeline, env } from '@xenova/transformers';\nimport { loadConfig } from './config.js';\n\n// Configure transformers.js to use WASM backend only (avoid ONNX runtime issues)\n// The native ONNX runtime causes \"DefaultLogger not registered\" errors in Node.js\nenv.backends.onnx.wasm.proxy = false; // Disable ONNX runtime proxy\nenv.backends.onnx.wasm.numThreads = 1; // Single thread for stability\n\nlet embeddingPipeline: any = null;\nlet isInitializing = false;\nconst embeddingCache = new Map<string, Float32Array>();\n\n/**\n * Initialize the embedding pipeline (lazy load)\n */\nasync function initializeEmbeddings(): Promise<void> {\n  if (embeddingPipeline) return;\n  if (isInitializing) {\n    // Wait for initialization to complete\n    while (isInitializing) {\n      await new Promise(resolve => setTimeout(resolve, 100));\n    }\n    return;\n  }\n\n  // Detect npx environment (known transformer initialization issues)\n  const isNpxEnv = process.env.npm_lifecycle_event === 'npx' ||\n                   process.env.npm_execpath?.includes('npx') ||\n                   process.cwd().includes('/_npx/') ||\n                   process.cwd().includes('\\\\_npx\\\\');\n\n  if (isNpxEnv && !process.env.FORCE_TRANSFORMERS) {\n    console.log('[Embeddings] NPX environment detected - using hash-based embeddings');\n    console.log('[Embeddings] For semantic search, install globally: npm install -g claude-flow');\n    isInitializing = false;\n    return;\n  }\n\n  isInitializing = true;\n  console.log('[Embeddings] Initializing local embedding model (Xenova/all-MiniLM-L6-v2)...');\n  console.log('[Embeddings] First run will download ~23MB model...');\n\n  try {\n    embeddingPipeline = await pipeline(\n      'feature-extraction',\n      'Xenova/all-MiniLM-L6-v2',\n      { quantized: true } // Smaller, faster\n    );\n    console.log('[Embeddings] Local model ready! (384 dimensions)');\n  } catch (error: any) {\n    console.error('[Embeddings] Failed to initialize:', error?.message || error);\n    console.warn('[Embeddings] Falling back to hash-based embeddings');\n  } finally {\n    isInitializing = false;\n  }\n}\n\n/**\n * Compute embedding for text using local model\n */\nexport async function computeEmbedding(text: string): Promise<Float32Array> {\n  const config = loadConfig();\n\n  // Check cache\n  const cacheKey = `local:${text}`;\n  if (embeddingCache.has(cacheKey)) {\n    return embeddingCache.get(cacheKey)!;\n  }\n\n  let embedding: Float32Array;\n\n  // Initialize if needed\n  await initializeEmbeddings();\n\n  if (embeddingPipeline) {\n    try {\n      // Use transformers.js for real embeddings\n      const output = await embeddingPipeline(text, {\n        pooling: 'mean',\n        normalize: true\n      });\n      embedding = new Float32Array(output.data);\n    } catch (error: any) {\n      console.error('[Embeddings] Generation failed:', error?.message || error);\n      embedding = hashEmbed(text, 384); // Fallback\n    }\n  } else {\n    // Fallback to hash-based embeddings\n    const dims = config?.embeddings?.dimensions || 384;\n    embedding = hashEmbed(text, dims);\n  }\n\n  // Cache with LRU (limit 1000 entries)\n  if (embeddingCache.size > 1000) {\n    const firstKey = embeddingCache.keys().next().value;\n    if (firstKey) {\n      embeddingCache.delete(firstKey);\n    }\n  }\n  embeddingCache.set(cacheKey, embedding);\n\n  // Set TTL for cache entry\n  const ttl = config?.embeddings?.cache_ttl_seconds || 3600;\n  setTimeout(\n    () => embeddingCache.delete(cacheKey),\n    ttl * 1000\n  );\n\n  return embedding;\n}\n\n/**\n * Batch compute embeddings (more efficient)\n */\nexport async function computeEmbeddingBatch(texts: string[]): Promise<Float32Array[]> {\n  return Promise.all(texts.map(text => computeEmbedding(text)));\n}\n\n/**\n * Get embedding dimensions\n */\nexport function getEmbeddingDimensions(): number {\n  return 384; // all-MiniLM-L6-v2 uses 384 dimensions\n}\n\n/**\n * Deterministic hash-based embedding (fallback)\n */\nfunction hashEmbed(text: string, dims: number): Float32Array {\n  const hash = simpleHash(text);\n  const vec = new Float32Array(dims);\n\n  // Generate deterministic pseudo-random vector from hash\n  for (let i = 0; i < dims; i++) {\n    vec[i] = Math.sin(hash * (i + 1) * 0.01) + Math.cos(hash * i * 0.02);\n  }\n\n  return normalize(vec);\n}\n\n/**\n * Simple string hash function\n */\nfunction simpleHash(str: string): number {\n  let hash = 0;\n  for (let i = 0; i < str.length; i++) {\n    hash = ((hash << 5) - hash) + str.charCodeAt(i);\n    hash |= 0;\n  }\n  return Math.abs(hash);\n}\n\n/**\n * Normalize vector to unit length\n */\nfunction normalize(vec: Float32Array): Float32Array {\n  let mag = 0;\n  for (let i = 0; i < vec.length; i++) {\n    mag += vec[i] * vec[i];\n  }\n  mag = Math.sqrt(mag);\n\n  if (mag === 0) return vec;\n\n  for (let i = 0; i < vec.length; i++) {\n    vec[i] /= mag;\n  }\n  return vec;\n}\n\n/**\n * Clear embedding cache\n */\nexport function clearEmbeddingCache(): void {\n  embeddingCache.clear();\n}\n"]}

package/dist/agentic-flow/src/reasoningbank/utils/mmr.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Maximal Marginal Relevance (MMR) for diversity in retrieval
+ * Balances relevance and diversity in top-k selection
+ */
+/**
+ * Cosine similarity between two vectors
+ */
+declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+/**
+ * MMR selection for diversity-aware top-k retrieval
+ *
+ * @param candidates - Scored candidates with embeddings
+ * @param queryEmbed - Query embedding for relevance scoring
+ * @param k - Number of items to select
+ * @param lambda - Balance between relevance (1.0) and diversity (0.0)
+ * @returns Selected items with maximum marginal relevance
+ */
+export declare function mmrSelection<T extends {
+    score: number;
+    embedding: Float32Array;
+}>(candidates: T[], queryEmbed: Float32Array, k: number, lambda?: number): T[];
+export { cosineSimilarity };
+//# sourceMappingURL=mmr.d.ts.map

package/dist/agentic-flow/src/reasoningbank/utils/mmr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mmr.d.ts","sourceRoot":"","sources":["../../../../../src/reasoningbank/utils/mmr.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,iBAAS,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAgBlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,YAAY,CAAA;CAAE,EAC/E,UAAU,EAAE,CAAC,EAAE,EACf,UAAU,EAAE,YAAY,EACxB,CAAC,EAAE,MAAM,EACT,MAAM,GAAE,MAAY,GACnB,CAAC,EAAE,CAoCL;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}