@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.
- package/README.md +14 -62
- 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
|
-
|
|
|
231
|
-
|
|
232
|
-
| `PetriNet` |
|
|
233
|
-
| `CortexFlowOrchestrator` |
|
|
234
|
-
| `IntentClassifier` |
|
|
235
|
-
| `HybridIntentClassifier` |
|
|
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 |
|
|
269
|
-
|
|
270
|
-
| `Agent` |
|
|
271
|
-
| `GenericExecutor` |
|
|
272
|
-
| `
|
|
273
|
-
| `
|
|
274
|
-
| `
|
|
275
|
-
|
|
|
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
|