@ai.ntellect/core 1.1.0 → 1.1.2

package/README.md

@@ -75,15 +75,14 @@ pnpm add @ai.ntellect/core zod
 ## Table of Contents
 
 - [Core Thesis](#core-thesis)
-- [Source Structure](#source-structure)
-- [GraphFlow — Typed Execution](#graphflow--typed-execution)
-- [CortexFlow — Intent Routing](#cortexflow--intent-routing)
-- [Agent — Cognitive Loop](#agent--cognitive-loop)
-- [AgentPipeline — Declarative Pipelines](#agentpipeline--declarative-pipelines)
-- [Persistence — Memory & Checkpoints](#persistence--memory--checkpoints)
+- [GraphFlow](#graphflow)
+- [CortexFlow](#cortexflow)
+- [Agent](#agent)
+- [Pipelines](#pipelines)
+- [Persistence](#persistence)
 - [Planner & Compiler](#planner--compiler)
-- [CLI (Interactive REPL)](#cli-interactive-repl)
-- [Testing & Build](#testing--build)
+- [CLI](#cli)
+- [GraphController](#graphcontroller)
 
 ---
 
@@ -101,31 +100,6 @@ This split means the LLM is called exactly **once per turn** for intent classifi
 
 ---
 
-## Source Structure
-
-```
-@ai.ntellect/core
-├── execution/         # GraphFlow engine (typed nodes, events, checkpoints, planner, compiler)
-├── routing/           # PetriNet, CortexFlowOrchestrator, IntentClassifier
-├── agent/             # Agent, GenericExecutor, handlers, tools
-├── persistence/       # Barrel: Memory + checkpoint adapters
-├── pipeline/          # AgentPipeline (trigger → stages → gate)
-├── modules/           # Plugins: agenda, cli, embedding, memory, nlp
-├── interfaces/        # Contract interfaces
-├── types/             # Zod schemas
-└── index.ts           # Barrel: all public API exports
-```
-
-### Path Aliases
-
-- `@ai.ntellect/core` — root barrel (all major exports)
-- `@ai.ntellect/core/execution/...` — deep imports for GraphFlow internals
-- `@ai.ntellect/core/routing/...` — deep imports for PetriNet / CortexFlow
-- `@ai.ntellect/core/agent/...` — deep imports for Agent module
-- `@ai.ntellect/core/pipeline/...` — deep imports for AgentPipeline
-
----
-
 ## GraphFlow — Typed Execution
 
 A `GraphFlow` is a **typed state machine** where each node is a discrete unit of logic.
@@ -227,12 +201,12 @@ const result = await orchestrator.orchestrate("Summarise my last 5 emails", sess
 
 ### Key Components
 
-| Export | Source | Description |
-|--------|--------|-------------|
-| `PetriNet` | `@ai.ntellect/core` | Core Petri Net engine |
-| `CortexFlowOrchestrator` | `@ai.ntellect/core/routing` | Intent → routing → execution |
-| `IntentClassifier` | `@ai.ntellect/core/routing` | LLM-based intent classification |
-| `HybridIntentClassifier` | `@ai.ntellect/core/routing` | Keyword + LLM fallback |
+| Component | Description |
+|--------|-------------|
+| `PetriNet` | Core Petri Net engine |
+| `CortexFlowOrchestrator` | Intent → routing → execution |
+| `IntentClassifier` | LLM-based intent classification |
+| `HybridIntentClassifier` | Keyword + LLM fallback |
 
 ### Advanced Features
 
@@ -265,15 +239,14 @@ const result = await agent.process("What is 25 + 7?");
 
 ### Cognitive Loop Components
 
-| Component | Location | Description |
-|-----------|----------|-------------|
-| `Agent` | `agent/agent.ts` | Public API: orchestrates the cognitive loop |
-| `GenericExecutor` | `agent/generic-executor.ts` | Decision-making + action execution |
-| `DynamicGoalHandler` | `agent/handlers/` | Context-aware goal computation |
-| `DynamicNextHandler` | `agent/handlers/` | Next-state routing |
-| `LLMFactory` | `agent/llm-factory.ts` | Multi-provider LLM client |
-| `PromptBuilder` | `agent/prompt-builder.ts` | Structured prompt construction |
-| Tools (`file-system`, etc.) | `agent/tools/` | Prebuilt agent tools |
+| Component | Description |
+|-----------|-------------|
+| `Agent` | Public API: orchestrates the cognitive loop |
+| `GenericExecutor` | Decision-making + action execution |
+| `CognitiveHandler` | Context-aware goal computation and next-state routing |
+| `LLMFactory` | Multi-provider LLM client (OpenAI, Groq, Ollama, etc.) |
+| `PromptBuilder` | Structured prompt construction |
+| Tools | Prebuilt agent utilities (`file-system`, `shell`, etc.) |
 
 ### Built-in Agent Tools
 
@@ -290,7 +263,7 @@ import {
 
 ---
 
-## AgentPipeline — Declarative Pipelines
+## Pipelines
 
 Declarative pipelines with triggers, typed stages, and human gates.
 
@@ -435,28 +408,9 @@ await controller.sequential("workflow_a", "workflow_b");
 
 ---
 
-## Testing & Build
-
-```sh
-pnpm run build                  # tsc → dist/
-pnpm test                       # Mocha via ts-node (5s timeout)
-pnpm run test:all               # Full suite (test/**/*.test.ts)
-pnpm test --grep "suite name"   # Focused suite
-pnpm run test:watch             # Watch mode
-```
-
-**Real LLM tests**: `pnpm test --grep "CortexFlow Real LLM"` (requires Ollama `llama3:latest` on `localhost:11434`).
-
-**Examples**:
-
-```sh
-pnpm run example:hello
-pnpm run example:agent
-pnpm run example:onchain
-```
-
----
-
 ## License
 
 MIT
+cense
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai.ntellect/core",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "In-process workflow engine with typed graphs, events, and LLM agent support",
   "main": "dist/index.js",
   "packageManager": "pnpm@10.33.0",