@ai.ntellect/core 1.1.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +14 -62
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -101,31 +101,6 @@ This split means the LLM is called exactly **once per turn** for intent classifi
101
101
 
102
102
  ---
103
103
 
104
- ## Source Structure
105
-
106
- ```
107
- @ai.ntellect/core
108
- ├── execution/ # GraphFlow engine (typed nodes, events, checkpoints, planner, compiler)
109
- ├── routing/ # PetriNet, CortexFlowOrchestrator, IntentClassifier
110
- ├── agent/ # Agent, GenericExecutor, handlers, tools
111
- ├── persistence/ # Barrel: Memory + checkpoint adapters
112
- ├── pipeline/ # AgentPipeline (trigger → stages → gate)
113
- ├── modules/ # Plugins: agenda, cli, embedding, memory, nlp
114
- ├── interfaces/ # Contract interfaces
115
- ├── types/ # Zod schemas
116
- └── index.ts # Barrel: all public API exports
117
- ```
118
-
119
- ### Path Aliases
120
-
121
- - `@ai.ntellect/core` — root barrel (all major exports)
122
- - `@ai.ntellect/core/execution/...` — deep imports for GraphFlow internals
123
- - `@ai.ntellect/core/routing/...` — deep imports for PetriNet / CortexFlow
124
- - `@ai.ntellect/core/agent/...` — deep imports for Agent module
125
- - `@ai.ntellect/core/pipeline/...` — deep imports for AgentPipeline
126
-
127
- ---
128
-
129
104
  ## GraphFlow — Typed Execution
130
105
 
131
106
  A `GraphFlow` is a **typed state machine** where each node is a discrete unit of logic.
@@ -227,12 +202,12 @@ const result = await orchestrator.orchestrate("Summarise my last 5 emails", sess
227
202
 
228
203
  ### Key Components
229
204
 
230
- | Export | Source | Description |
231
- |--------|--------|-------------|
232
- | `PetriNet` | `@ai.ntellect/core` | Core Petri Net engine |
233
- | `CortexFlowOrchestrator` | `@ai.ntellect/core/routing` | Intent → routing → execution |
234
- | `IntentClassifier` | `@ai.ntellect/core/routing` | LLM-based intent classification |
235
- | `HybridIntentClassifier` | `@ai.ntellect/core/routing` | Keyword + LLM fallback |
205
+ | Component | Description |
206
+ |--------|-------------|
207
+ | `PetriNet` | Core Petri Net engine |
208
+ | `CortexFlowOrchestrator` | Intent → routing → execution |
209
+ | `IntentClassifier` | LLM-based intent classification |
210
+ | `HybridIntentClassifier` | Keyword + LLM fallback |
236
211
 
237
212
  ### Advanced Features
238
213
 
@@ -265,15 +240,14 @@ const result = await agent.process("What is 25 + 7?");
265
240
 
266
241
  ### Cognitive Loop Components
267
242
 
268
- | Component | Location | Description |
269
- |-----------|----------|-------------|
270
- | `Agent` | `agent/agent.ts` | Public API: orchestrates the cognitive loop |
271
- | `GenericExecutor` | `agent/generic-executor.ts` | Decision-making + action execution |
272
- | `DynamicGoalHandler` | `agent/handlers/` | Context-aware goal computation |
273
- | `DynamicNextHandler` | `agent/handlers/` | Next-state routing |
274
- | `LLMFactory` | `agent/llm-factory.ts` | Multi-provider LLM client |
275
- | `PromptBuilder` | `agent/prompt-builder.ts` | Structured prompt construction |
276
- | Tools (`file-system`, etc.) | `agent/tools/` | Prebuilt agent tools |
243
+ | Component | Description |
244
+ |-----------|-------------|
245
+ | `Agent` | Public API: orchestrates the cognitive loop |
246
+ | `GenericExecutor` | Decision-making + action execution |
247
+ | `CognitiveHandler` | Context-aware goal computation and next-state routing |
248
+ | `LLMFactory` | Multi-provider LLM client (OpenAI, Groq, Ollama, etc.) |
249
+ | `PromptBuilder` | Structured prompt construction |
250
+ | Tools | Prebuilt agent utilities (`file-system`, `shell`, etc.) |
277
251
 
278
252
  ### Built-in Agent Tools
279
253
 
@@ -435,28 +409,6 @@ await controller.sequential("workflow_a", "workflow_b");
435
409
 
436
410
  ---
437
411
 
438
- ## Testing & Build
439
-
440
- ```sh
441
- pnpm run build # tsc → dist/
442
- pnpm test # Mocha via ts-node (5s timeout)
443
- pnpm run test:all # Full suite (test/**/*.test.ts)
444
- pnpm test --grep "suite name" # Focused suite
445
- pnpm run test:watch # Watch mode
446
- ```
447
-
448
- **Real LLM tests**: `pnpm test --grep "CortexFlow Real LLM"` (requires Ollama `llama3:latest` on `localhost:11434`).
449
-
450
- **Examples**:
451
-
452
- ```sh
453
- pnpm run example:hello
454
- pnpm run example:agent
455
- pnpm run example:onchain
456
- ```
457
-
458
- ---
459
-
460
412
  ## License
461
413
 
462
414
  MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ai.ntellect/core",
3
- "version": "1.1.0",
3
+ "version": "1.1.1",
4
4
  "description": "In-process workflow engine with typed graphs, events, and LLM agent support",
5
5
  "main": "dist/index.js",
6
6
  "packageManager": "pnpm@10.33.0",