@ai.ntellect/core 0.8.3 → 1.1.0

package/test-petri-features.ts

@@ -0,0 +1,218 @@
+import { CortexFlowOrchestrator } from './routing/orchestrator';
+import { IntentClassifier, HybridIntentClassifier } from './routing/intent-classifier';
+import { ToolRegistry } from './execution/registry';
+import { GraphFlow } from './execution/index';
+import { PetriNet } from './routing/index';
+import { z } from 'zod';
+import * as fs from 'fs';
+import * as path from 'path';
+
+// Chargement manuel du .env
+const envPath = path.join(__dirname, '.env');
+const envContent = fs.readFileSync(envPath, 'utf-8');
+const envVars: Record<string, string> = {};
+envContent.split('\n').forEach(line => {
+  const match = line.match(/^([^=]+)=(.*)$/);
+  if (match) envVars[match[1]] = match[2];
+});
+
+const GROQ_API_KEY = envVars['GROQ_API_KEY'];
+
+async function groqCall(prompt: string): Promise<string> {
+  const response = await fetch('https://api.groq.com/openai/v1/chat/completions', {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${GROQ_API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      model: 'llama-3.1-8b-instant',
+      messages: [{ role: 'user', content: prompt }],
+      temperature: 0.1,
+    }),
+  });
+  const data = await response.json();
+  return data.choices?.[0]?.message?.content || '';
+}
+
+// Schéma pour les outils de test
+const TestSchema = z.object({
+  query: z.string().default(''),
+  data: z.string().default(''),
+  result: z.string().default(''),
+  message: z.string().default(''),
+  fetched: z.boolean().default(false),
+  processed: z.boolean().default(false),
+  notified: z.boolean().default(false),
+});
+
+type TestContext = z.infer<typeof TestSchema>;
+
+function createTestTools(): ToolRegistry {
+  const registry = new ToolRegistry();
+
+  const fetchGraph = new GraphFlow<typeof TestSchema>({
+    name: 'fetch_data_graph',
+    schema: TestSchema,
+    context: { query: '', data: '', result: '', message: '', fetched: false, processed: false, notified: false },
+    nodes: [
+      {
+        name: 'fetch_data',
+        execute: async (ctx) => {
+          console.log('  [Tool] fetch_data exécuté');
+          ctx.data = `Données récupérées`;
+          ctx.fetched = true;
+        },
+      },
+    ],
+    entryNode: 'fetch_data',
+  });
+  registry.register({ name: 'fetch_data', description: 'Récupère des données', graph: fetchGraph, startNode: 'fetch_data' });
+
+  const processGraph = new GraphFlow<typeof TestSchema>({
+    name: 'process_data_graph',
+    schema: TestSchema,
+    context: { query: '', data: '', result: '', message: '', fetched: false, processed: false, notified: false },
+    nodes: [
+      {
+        name: 'process_data',
+        execute: async (ctx) => {
+          console.log('  [Tool] process_data exécuté');
+          ctx.result = `Données traitées: ${ctx.data}`;
+          ctx.processed = true;
+        },
+      },
+    ],
+    entryNode: 'process_data',
+  });
+  registry.register({ name: 'process_data', description: 'Traite des données', graph: processGraph, startNode: 'process_data' });
+
+  return registry;
+}
+
+function setupPetriNet(orchestrator: CortexFlowOrchestrator) {
+  const net = orchestrator.petri;
+
+  net.addPlace({ id: 'idle', type: 'initial', tokens: [{ id: 'start', data: {}, createdAt: Date.now() }] });
+  net.addPlace({ id: 'fetching', type: 'normal', tokens: [] });
+  net.addPlace({ id: 'processing', type: 'normal', tokens: [] });
+  net.addPlace({ id: 'done', type: 'final', tokens: [] });
+
+  net.addTransition({
+    id: 'do_fetch',
+    from: ['idle'],
+    to: 'fetching',
+    guard: {
+      type: 'deterministic',
+      condition: "context.intent === 'FETCH_DATA'",
+    },
+    action: { type: 'graphflow', name: 'fetch_data' } as any,
+  });
+
+  net.addTransition({
+    id: 'do_process',
+    from: ['idle'],
+    to: 'processing',
+    guard: {
+      type: 'deterministic',
+      condition: "context.intent === 'PROCESS_DATA'",
+    },
+    action: { type: 'graphflow', name: 'process_data' } as any,
+  });
+
+  net.addTransition({ id: 'fetch_to_done', from: ['fetching'], to: 'done' });
+  net.addTransition({ id: 'process_to_done', from: ['processing'], to: 'done' });
+}
+
+async function testMultiIntents(orchestrator: CortexFlowOrchestrator, sessionId: string) {
+  console.log('\n=== TEST 1: Multi-intents ===');
+  const message = 'Récupère les données et traite-les';
+  console.log(`Message: "${message}"`);
+
+  const result = await orchestrator.orchestrate(message, sessionId);
+  console.log('Intent principal:', result.intent.intent);
+  console.log('Confiance:', result.intent.confidence);
+  console.log('Multi-intents détectés:', result.intent.intents ? result.intent.intents.map(i => i.intent) : 'aucun');
+  console.log('Transition exécutée:', result.transitionResult?.transitionId);
+}
+
+async function testSingleIntent(orchestrator: CortexFlowOrchestrator, sessionId: string) {
+  console.log('\n=== TEST 2: Single intent ===');
+  const message = 'Récupère les données';
+  console.log(`Message: "${message}"`);
+
+  const result = await orchestrator.orchestrate(message, sessionId);
+  console.log('Intent:', result.intent.intent);
+  console.log('Confiance:', result.intent.confidence);
+  console.log('Transition exécutée:', result.transitionResult?.transitionId);
+}
+
+async function testFallbackMode(orchestrator: CortexFlowOrchestrator, sessionId: string) {
+  console.log('\n=== TEST 3: Fallback Mode (confiance faible) ===');
+  const message = 'fais un truc au hasard s\'il te plaît';
+  console.log(`Message: "${message}"`);
+
+  orchestrator.setFallbackLLM(async (message: string, session: any) => {
+    console.log('  [Fallback] Message reçu:', message);
+    return {
+      response: 'Je suis en mode fallback. Je ne peux pas traiter cette demande.',
+      shouldReenterPetri: false,
+    };
+  });
+
+  const result = await orchestrator.orchestrate(message, sessionId);
+  console.log('Intent:', result.intent.intent, '(attendu: UNKNOWN)');
+  console.log('Fallback response:', result.fallbackResponse?.substring(0, 60));
+}
+
+async function testJsonPattern() {
+  console.log('\n=== TEST 4: Chargement pattern JSON ===');
+  const patternPath = path.join(__dirname, 'petri', 'patterns', 'human-approval.json');
+  const pattern = JSON.parse(fs.readFileSync(patternPath, 'utf-8'));
+
+  console.log(`Pattern: ${pattern.name}`);
+  console.log(`Description: ${pattern.description}`);
+  console.log(`Places: ${pattern.places.length}, Transitions: ${pattern.transitions.length}`);
+  console.log('✅ Pattern JSON valide');
+}
+
+async function main() {
+  console.log('🚀 Tests des nouvelles fonctionnalités Petri\n');
+
+  if (!GROQ_API_KEY) {
+    console.error('❌ GROQ_API_KEY manquant');
+    return;
+  }
+
+  const registry = createTestTools();
+  const orchestrator = new CortexFlowOrchestrator('test', registry);
+  orchestrator.setLLMCall(groqCall);
+  setupPetriNet(orchestrator);
+
+  const classifier = new IntentClassifier(groqCall, {
+    intents: ['FETCH_DATA', 'PROCESS_DATA', 'UNKNOWN'],
+    confidenceThreshold: 0.6,
+  });
+  orchestrator.setIntentClassifier(IntentClassifier.toFn(classifier), classifier);
+  orchestrator.setConfidenceThreshold(0.6);
+
+  const sessionId = orchestrator.startSession();
+
+  try {
+    await testMultiIntents(orchestrator, sessionId);
+    await testSingleIntent(orchestrator, sessionId + '_2');
+    await testFallbackMode(orchestrator, sessionId + '_fallback');
+    await testJsonPattern();
+
+    console.log('\n✅ Tests terminés avec succès!');
+    console.log('\nFonctionnalités implémentées:');
+    console.log('1. ✅ Mode hybride/échappatoire (fallback LLM)');
+    console.log('2. ✅ Classifieur multi-intents');
+    console.log('3. ✅ Patterns prêts à l\'emploi (JSON)');
+    console.log('4. ✅ Adapters de persistance (Redis + Postgres)');
+  } catch (error) {
+    console.error('\n❌ Erreur:', error);
+  }
+}
+
+main();

package/test-pipeline-api.ts

@@ -0,0 +1,163 @@
+import * as fs from "fs";
+import * as path from "path";
+
+const envPath = path.resolve(__dirname, ".env");
+if (fs.existsSync(envPath)) {
+  for (const line of fs.readFileSync(envPath, "utf-8").split("\n")) {
+    const t = line.trim();
+    if (!t || t.startsWith("#")) continue;
+    const eq = t.indexOf("=");
+    if (eq === -1) continue;
+    const k = t.slice(0, eq).trim();
+    const v = t.slice(eq + 1).trim();
+    if (k && !process.env[k]) process.env[k] = v;
+  }
+}
+
+import { AgentPipeline, priceZone } from "./pipeline/agent-pipeline";
+
+// ============================================
+// USE CASE 1: Simple 2-stage pipeline (no human gate)
+// ============================================
+async function testSimplePipeline() {
+  console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+  console.log(" USE CASE 1: Simple 2-stage pipeline (auto)");
+  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n");
+
+  const pipeline = new AgentPipeline({
+    name: "simple-analysis",
+    trigger: priceZone("BTC", 78000, 79000),
+    stages: [
+      {
+        id: "fetch",
+        run: async (ctx) => {
+          console.log(`  [fetch] Fetching data for ${ctx.asset}...`);
+          await new Promise(r => setTimeout(r, 500));
+          return { price: 78500, volume: 1000 };
+        },
+      },
+      {
+        id: "analyze",
+        run: async (ctx) => {
+          console.log(`  [analyze] Analyzing price $${ctx.price}...`);
+          await new Promise(r => setTimeout(r, 500));
+          return { signal: "BUY", confidence: 0.85 };
+        },
+      },
+    ],
+    gate: "auto",
+    onApprove: async (ctx) => {
+      console.log(`  [execute] Signal: ${ctx.signal} @ $${ctx.price}`);
+    },
+  });
+
+  console.log(`Initial place: ${pipeline.getPlace()}`);
+  console.log("Pipeline created with auto gate (no human approval needed)\n");
+}
+
+// ============================================
+// USE CASE 2: Pipeline with human approval
+// ============================================
+async function testHumanGatePipeline() {
+  console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+  console.log(" USE CASE 2: Pipeline with human gate");
+  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n");
+
+  const pipeline = new AgentPipeline({
+    name: "trading-approval",
+    trigger: priceZone("ETH", 2300, 2400),
+    stages: [
+      {
+        id: "alpha",
+        run: async (ctx) => {
+          console.log(`  [@Alpha] Analyzing ${ctx.asset}...`);
+          return { signal: "BUY", confidence: 80, entryPrice: 2350 };
+        },
+      },
+      {
+        id: "guardian",
+        run: async (ctx) => {
+          console.log(`  [@Guardian] Auditing...`);
+          return { verdict: "ACCEPTABLE", score: 5 };
+        },
+      },
+      {
+        id: "oracle",
+        run: async (ctx) => {
+          console.log(`  [@Oracle] Deciding...`);
+          return { decision: "EXECUTE", action: { side: "BUY", sizeUsd: 50 } };
+        },
+      },
+    ],
+    gate: "human",
+    onApprove: async (ctx) => {
+      console.log(`  ✓ Human approved! Executing trade: ${ctx.decision}`);
+      console.log(`  → ${ctx.action.side} $${ctx.action.sizeUsd}`);
+    },
+  });
+
+  console.log(`Initial place: ${pipeline.getPlace()}`);
+  console.log("Pipeline created with human gate\n");
+}
+
+// ============================================
+// USE CASE 3: Pipeline with conditional logic
+// ============================================
+async function testConditionalPipeline() {
+  console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+  console.log(" USE CASE 3: Pipeline with conditional execution");
+  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n");
+
+  const pipeline = new AgentPipeline({
+    name: "conditional-trade",
+    trigger: priceZone("SOL", 100, 120),
+    stages: [
+      {
+        id: "analyze",
+        run: async (ctx) => {
+          console.log(`  [analyze] Checking market conditions...`);
+          const shouldTrade = ctx.price > 110;
+          return { shouldTrade, signal: shouldTrade ? "BUY" : "WAIT" };
+        },
+      },
+      {
+        id: "execute_if_approved",
+        run: async (ctx) => {
+          if (!ctx.shouldTrade) {
+            console.log(`  [skip] Conditions not met, skipping trade`);
+            return { skipped: true };
+          }
+          console.log(`  [execute] Placing trade...`);
+          return { executed: true, orderId: "12345" };
+        },
+      },
+    ],
+    gate: "auto",
+  });
+
+  console.log("Pipeline with conditional logic created");
+  console.log("Stage 2 checks ctx.shouldTrade before executing\n");
+}
+
+// ============================================
+// Run all use cases
+// ============================================
+async function main() {
+  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+  console.log("  AgentPipeline API — Multiple Use Cases");
+  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+
+  await testSimplePipeline();
+  await testHumanGatePipeline();
+  await testConditionalPipeline();
+
+  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+  console.log("  All use cases defined successfully!");
+  console.log("  User never sees Petri net, transitions, or fireTransition()");
+  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n");
+}
+
+main().catch((e) => {
+  console.error("Error:", e);
+  process.exit(1);
+});

package/tsconfig.json

@@ -22,10 +22,13 @@
   "include": [
     "index.ts",
     "modules/**/*",
-    "graph/**/*",
+    "execution/**/*",
+    "routing/**/*",
+    "agent/**/*",
+    "persistence/**/*",
     "types/**/*",
     "interfaces/**/*",
     "utils/**/*"
   ],
-  "exclude": ["node_modules", "dist", "test", "examples"]
+  "exclude": ["node_modules", "dist", "test", "examples", "routing/web-server.ts"]
 }

package/types/agent.ts

@@ -1,4 +1,4 @@
-import { GraphFlow } from "@/graph";
+import { GraphFlow } from "@/execution";
 import { z } from "zod";
 
 /**
@@ -12,12 +12,26 @@ import { z } from "zod";
  */
 export type ExecutedAction = {
   name: string;
+  parameters?: Record<string, any>;
   isExecuted: boolean;
   error?: string | null;
   result: any;
   timestamp: string;
 };
 
+export type ChatMessage = {
+  role: "user" | "assistant";
+  content: string;
+};
+
+export type ScratchpadEntry = {
+  turn: number;
+  thought: string;
+  action: string;
+  observation: string;
+  timestamp: string;
+};
+
 /**
  * Represents the context in which an agent operates
  * @interface AgentContext
@@ -28,6 +42,11 @@ export type ExecutedAction = {
  * @property {string} response - The agent's response
  * @property {string} [knowledge] - Optional knowledge base or context
  * @property {ExecutedAction[]} executedActions - History of executed actions
+ * @property {number} [iteration] - Current iteration count (reset per run)
+ * @property {boolean} [progressed] - Whether progress was made in this iteration
+ * @property {ChatMessage[]} [messages] - Conversation history
+ * @property {ScratchpadEntry[]} scratchpad - Structured journal of thoughts
+ * @property {BaseMemoryType[]} memories - Retrieved episodic memories
  */
 export type AgentContext = {
   input: {
@@ -38,6 +57,37 @@ export type AgentContext = {
   response: string;
   knowledge?: string;
   executedActions: ExecutedAction[];
+  iteration?: number;
+  progressed?: boolean;
+  messages?: ChatMessage[];
+  toolResults?: Record<string, any>;
+  scratchpad?: ScratchpadEntry[];
+  memories?: any[];
+  entityState?: {
+    currentTarget?: string;
+    lastEntityType?: string | null;
+    pendingResolutions?: any[];
+    resolutionTrace?: any[];
+    explored?: boolean;
+    handles?: Record<string, { id: string; label: string; path: string; category: string }>;
+  };
+  conversationState?: {
+    currentGoal: string;
+    currentTarget: string | null;
+    lastResolvedEntity: string | null;
+    lastResolvedType: string | null;
+    pendingTask: string | null;
+    turnCount: number;
+    pendingIntent: { action: string | null; unresolvedEntity: string | null; originalInput: string; turn: number; failed: boolean } | null;
+  };
+  explorationBudget?: {
+    maxSteps: number;
+    maxExplorations: number;
+    maxToolCalls: number;
+    stepsUsed: number;
+    explorationsUsed: number;
+    toolCallsUsed: number;
+  };
 };
 
 export const AgentContextSchema = z.object({
@@ -45,6 +95,7 @@ export const AgentContextSchema = z.object({
     raw: z.string(),
     embedding: z.array(z.number()).optional(),
   }),
+  cwd: z.string().optional(),
   actions: z.array(
     z.object({
       name: z.string(),
@@ -69,6 +120,56 @@ export const AgentContextSchema = z.object({
       })
     )
     .optional(),
+  iteration: z.number().optional(),
+  progressed: z.boolean().optional(),
+  messages: z
+    .array(
+      z.object({
+        role: z.enum(["user", "assistant"]),
+        content: z.string(),
+      })
+    )
+    .optional(),
+  toolResults: z.record(z.string(), z.unknown()).optional(),
+  scratchpad: z.array(z.object({
+    turn: z.number(),
+    thought: z.string(),
+    action: z.string(),
+    observation: z.string(),
+    timestamp: z.string(),
+  })).optional().default([]),
+  memories: z.array(z.any()).optional().default([]),
+  entityState: z.object({
+    currentTarget: z.string().optional(),
+    lastEntityType: z.string().nullable().optional(),
+    pendingResolutions: z.array(z.any()).optional(),
+    resolutionTrace: z.array(z.any()).optional(),
+    explored: z.boolean().optional(),
+    handles: z.record(z.string(), z.object({ id: z.string(), label: z.string(), path: z.string(), category: z.string() })).optional(),
+  }).optional(),
+  conversationState: z.object({
+    currentGoal: z.string(),
+    currentTarget: z.string().nullable(),
+    lastResolvedEntity: z.string().nullable(),
+    lastResolvedType: z.string().nullable(),
+    pendingTask: z.string().nullable(),
+    turnCount: z.number(),
+    pendingIntent: z.object({
+      action: z.string().nullable(),
+      unresolvedEntity: z.string().nullable(),
+      originalInput: z.string(),
+      turn: z.number(),
+      failed: z.boolean(),
+    }).nullable(),
+  }).optional(),
+  explorationBudget: z.object({
+    maxSteps: z.number(),
+    maxExplorations: z.number(),
+    maxToolCalls: z.number(),
+    stepsUsed: z.number(),
+    explorationsUsed: z.number(),
+    toolCallsUsed: z.number(),
+  }).optional(),
 });
 
 /**
@@ -85,7 +186,7 @@ export type PromptSection = {
 /**
  * Supported LLM providers
  */
-export type LLMProvider = "openai" | "anthropic" | "custom";
+export type LLMProvider = "openai" | "anthropic" | "ollama" | "groq" | "openrouter" | "google" | "custom";
 
 /**
  * Supported LLM models
@@ -115,7 +216,17 @@ export type AgentConfig = {
   tools: GraphFlow<any>[];
   memory?: any;
   verbose?: boolean;
+  maxIterations?: number;
   llmConfig: ExecutorConfig["llmConfig"];
+  dynamicGoal?: boolean;
+  dynamicGoalPrompt?: string;
+  dynamicNext?: boolean;
+  dynamicNextPrompt?: string;
+  enableSchedule?: boolean;
+  enableClone?: boolean;
+  enableReflection?: boolean;
+  agenda?: any;
+  entityStore?: import("../agent/entity-resolver/entity-index").IEntityStore;
 };
 
 /**
@@ -134,28 +245,39 @@ export type ActionSchema = {
  * @interface DecisionOutput
  * @property {ActionSchema[]} actions - The actions to be executed
  * @property {string} response - The agent's response message
+ * @property {string} [thought] - The agent's internal reasoning for this turn
  */
 export type DecisionOutput = {
   actions: ActionSchema[];
   response: string;
+  thought?: string;
+};
+
+export type LLMCall = {
+  promptTokens: number;
+  completionTokens: number;
+  duration: number;
+  timestamp: string;
 };
 
 /**
  * Configuration for the Language Model
  * @interface LLMConfig
  * @property {LLMProvider} provider - The LLM provider to use
- * @property {string} apiKey - API key for the provider
+ * @property {string} [apiKey] - API key for the provider (not required for Ollama)
  * @property {LLMModel} model - The specific model to use
  * @property {number} [temperature] - Optional temperature parameter for response randomness
  * @property {number} [maxTokens] - Optional maximum tokens for the response
+ * @property {string} [baseUrl] - Optional base URL for local providers (e.g., Ollama)
  * @property {Function} [customCall] - Optional custom implementation for API calls
  */
 export type LLMConfig = {
   provider: LLMProvider;
-  apiKey: string;
+  apiKey?: string;
   model: LLMModel;
   temperature?: number;
   maxTokens?: number;
+  baseUrl?: string;
   customCall?: (
     prompt: string | PromptInput,
     schema: z.ZodType<any>