@dcyfr/ai 3.0.2 → 3.0.3

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 (57) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/README.md +12 -14
  3. package/dist/.tsbuildinfo +1 -1
  4. package/dist/ai/agents/agent-router.d.ts.map +1 -1
  5. package/dist/ai/agents/agent-router.js +3 -1
  6. package/dist/ai/agents/agent-router.js.map +1 -1
  7. package/dist/ai/config/loader.d.ts +5 -1
  8. package/dist/ai/config/loader.d.ts.map +1 -1
  9. package/dist/ai/config/loader.js +24 -4
  10. package/dist/ai/config/loader.js.map +1 -1
  11. package/dist/ai/core/provider-registry.d.ts +1 -1
  12. package/dist/ai/core/provider-registry.d.ts.map +1 -1
  13. package/dist/ai/core/provider-registry.js +86 -142
  14. package/dist/ai/core/provider-registry.js.map +1 -1
  15. package/dist/ai/core/telemetry-engine.d.ts +1 -1
  16. package/dist/ai/core/telemetry-engine.d.ts.map +1 -1
  17. package/dist/ai/core/telemetry-engine.js +14 -10
  18. package/dist/ai/core/telemetry-engine.js.map +1 -1
  19. package/dist/ai/delegation/contract-manager.d.ts.map +1 -1
  20. package/dist/ai/delegation/contract-manager.js +5 -2
  21. package/dist/ai/delegation/contract-manager.js.map +1 -1
  22. package/dist/ai/delegation/execution-mode-dashboard.d.ts.map +1 -1
  23. package/dist/ai/delegation/execution-mode-dashboard.js +4 -2
  24. package/dist/ai/delegation/execution-mode-dashboard.js.map +1 -1
  25. package/dist/ai/mcp/servers/shared/utils.d.ts.map +1 -1
  26. package/dist/ai/mcp/servers/shared/utils.js +4 -2
  27. package/dist/ai/mcp/servers/shared/utils.js.map +1 -1
  28. package/dist/ai/memory/file-memory-adapter.d.ts.map +1 -1
  29. package/dist/ai/memory/file-memory-adapter.js +11 -13
  30. package/dist/ai/memory/file-memory-adapter.js.map +1 -1
  31. package/dist/ai/memory/working-memory-persistence.d.ts.map +1 -1
  32. package/dist/ai/memory/working-memory-persistence.js +4 -2
  33. package/dist/ai/memory/working-memory-persistence.js.map +1 -1
  34. package/dist/ai/runtime/agent-runtime.d.ts.map +1 -1
  35. package/dist/ai/runtime/agent-runtime.js +12 -18
  36. package/dist/ai/runtime/agent-runtime.js.map +1 -1
  37. package/dist/ai/src/capability-manifest-generator.d.ts.map +1 -1
  38. package/dist/ai/src/capability-manifest-generator.js +11 -5
  39. package/dist/ai/src/capability-manifest-generator.js.map +1 -1
  40. package/dist/ai/src/cli/telemetry-dashboard.js +3 -3
  41. package/dist/ai/src/cli/telemetry-dashboard.js.map +1 -1
  42. package/dist/ai/src/compaction/memory-compaction.d.ts.map +1 -1
  43. package/dist/ai/src/compaction/memory-compaction.js +5 -4
  44. package/dist/ai/src/compaction/memory-compaction.js.map +1 -1
  45. package/dist/ai/src/plugins/security/secret-detector.js +3 -3
  46. package/dist/ai/src/plugins/security/secret-detector.js.map +1 -1
  47. package/dist/ai/src/security/prompt-scan-worker.d.ts.map +1 -1
  48. package/dist/ai/src/security/prompt-scan-worker.js +4 -1
  49. package/dist/ai/src/security/prompt-scan-worker.js.map +1 -1
  50. package/dist/ai/types/index.d.ts +8 -3
  51. package/dist/ai/types/index.d.ts.map +1 -1
  52. package/dist/ai/types/index.js.map +1 -1
  53. package/dist/ai/utils/safe-fs.d.ts +19 -0
  54. package/dist/ai/utils/safe-fs.d.ts.map +1 -0
  55. package/dist/ai/utils/safe-fs.js +64 -0
  56. package/dist/ai/utils/safe-fs.js.map +1 -0
  57. package/package.json +18 -17
package/CHANGELOG.md CHANGED
@@ -1,5 +1,15 @@
1
1
  # Changelog
2
2
 
3
+ ## 3.0.3
4
+
5
+ ### Patch Changes
6
+
7
+ - [#173](https://github.com/dcyfr-labs/dcyfr-ai/pull/173) [`6c50c05`](https://github.com/dcyfr-labs/dcyfr-ai/commit/6c50c05f7c598f678907f43385eb653f0d2a341b) Thanks [@dcyfr](https://github.com/dcyfr)! - Remove unused `@mistralai/mistralai` dependency.
8
+
9
+ The Mistral SDK is not imported anywhere in the codebase — only a description string in `packages/ai/core/provider-registry.ts` references Mistral models served via the GitHub Models API, which doesn't require this SDK.
10
+
11
+ Clears downstream Dependabot alert [GHSA-3q49-cfcf-g5fm](https://github.com/advisories/GHSA-3q49-cfcf-g5fm) (malware in `@mistralai/mistralai` 2.2.2 / 2.2.3 / 2.2.4 with an overbroad `>= 0` blanket range that flags safe versions too) for downstream consumers like `dcyfr-labs/dcyfr-labs`.
12
+
3
13
  ## 3.0.1
4
14
 
5
15
  ### Patch Changes
package/README.md CHANGED
@@ -1,4 +1,8 @@
1
- # @dcyfr/ai
1
+ <div align="center">
2
+ <img src="https://raw.githubusercontent.com/dcyfr-labs/dcyfr-labs/main/public/images/dcyfr-avatar.svg" alt="DCYFR Logo" width="120" height="120" />
3
+ <h1>@dcyfr/ai</h1>
4
+ <p><em>Portable AI agent harness with plugin architecture for multi-provider integration, telemetry tracking, and quality validation.</em></p>
5
+ </div>
2
6
 
3
7
  <!-- README-META
4
8
  tlp_clearance: GREEN
@@ -10,8 +14,6 @@
10
14
 
11
15
  [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/dcyfr/dcyfr-ai)
12
16
 
13
- > Portable AI agent harness with plugin architecture for multi-provider integration, telemetry tracking, and quality validation.
14
-
15
17
  [![npm](https://img.shields.io/npm/v/@dcyfr/ai?logo=npm&logoColor=white)](https://www.npmjs.com/package/@dcyfr/ai)
16
18
  [![Downloads](https://img.shields.io/npm/dm/@dcyfr/ai?logo=npm&logoColor=white)](https://www.npmjs.com/package/@dcyfr/ai)
17
19
  [![License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](https://opensource.org/licenses/MIT)
@@ -37,7 +39,7 @@ Portable AI agent harness with plugin architecture for managing multiple AI prov
37
39
  | Plugin System | ✅ Custom | ✅ Complex | ❌ | ❌ |
38
40
  | Telemetry | ✅ Built-in | ❌ | ❌ | ❌ |
39
41
  | Zero Config | ✅ | ❌ | ✅ | ❌ |
40
- | Bundle Size | Live Bundlephobia minzip badge | ~2.3MB | ~450KB | N/A |
42
+ | Bundle Size | [![](https://img.shields.io/bundlephobia/minzip/@dcyfr/ai)](https://bundlephobia.com/package/@dcyfr/ai) | ~2.3MB | ~450KB | N/A |
41
43
  | TypeScript | ✅ Strict | Partial | ✅ | ❌ |
42
44
  | Quality Gates | ✅ | ❌ | ❌ | ❌ |
43
45
  | Config System | YAML/JSON/package | Code-only | Code-only | JSON |
@@ -53,7 +55,7 @@ Portable AI agent harness with plugin architecture for managing multiple AI prov
53
55
 
54
56
  - **Weekly Downloads:** Check [npm stats](https://www.npmjs.com/package/@dcyfr/ai)
55
57
  - **Dependencies:** 28 production dependencies
56
- - **Bundle Size:** Live Bundlephobia minzip badge (see above)
58
+ - **Bundle Size:** See badge above ([![minzip](https://img.shields.io/bundlephobia/minzip/@dcyfr/ai)](https://bundlephobia.com/package/@dcyfr/ai))
57
59
  - **TypeScript:** Full type definitions included
58
60
  - **ESM Support:** ✅ Full ESM modules with tree shaking
59
61
 
@@ -100,10 +102,6 @@ Portable AI agent harness with plugin architecture for managing multiple AI prov
100
102
  - ⚙️ **Configuration System** - YAML/JSON config with three-layer merge
101
103
  - 📊 **Comprehensive Telemetry** - Track usage, costs, quality metrics, performance
102
104
  - ✅ **Validation Harness** - Quality gates with parallel/serial execution
103
- - 💾 **Pluggable Storage** - Memory, file-based, or custom adapters
104
- - ⚡ **Type-Safe** - Full TypeScript support with Zod validation
105
- - 📦 **Bundle Profile** - Live Bundlephobia minzip badge
106
- - 🛠️ **CLI Tools** - Config validation and initialization
107
105
 
108
106
  ## Installation
109
107
 
@@ -178,7 +176,7 @@ npx @dcyfr/ai config:validate --verbose
178
176
 
179
177
  ### Migrating from LangChain
180
178
 
181
- **Why migrate:** Smaller bundle footprint than LangChain (see live Bundlephobia badge), built-in telemetry, simpler API
179
+ **Why migrate:** Smaller bundle footprint than LangChain (see [bundlephobia](https://bundlephobia.com/package/@dcyfr/ai)), built-in telemetry, simpler API
182
180
 
183
181
  ```typescript
184
182
  // LangChain (before)
@@ -206,7 +204,7 @@ const response = await runtime.chat({
206
204
 
207
205
  - Simpler configuration (YAML/JSON vs code-only)
208
206
  - Built-in telemetry tracking (no additional setup)
209
- - Smaller bundle size than LangChain (see live Bundlephobia badge)
207
+ - Smaller bundle size than LangChain (see [bundlephobia](https://bundlephobia.com/package/@dcyfr/ai))
210
208
  - Type-safe validation with Zod
211
209
  - Quality gates included out of the box
212
210
 
@@ -260,7 +258,7 @@ const report = await validator.validate({
260
258
  ### Prerequisites
261
259
 
262
260
  ```bash
263
- # Node.js 18+ required
261
+ # Node.js 24+ required
264
262
  node --version
265
263
 
266
264
  # Install @dcyfr/ai
@@ -944,7 +942,7 @@ A: Yes! @dcyfr/ai is used in production at dcyfr-labs and other projects. It has
944
942
  - **Config Loading:** ~10ms (cached), ~50ms (first load with file I/O)
945
943
  - **Validation Framework:** Parallel execution 2-5x faster than serial (depends on plugin count)
946
944
  - **Plugin System:** Minimal overhead ~5ms per plugin registration
947
- - **Bundle Size:** Live Bundlephobia minzip badge
945
+ - **Bundle Size:** See [bundlephobia.com/@dcyfr/ai](https://bundlephobia.com/package/@dcyfr/ai) for current minzip size
948
946
 
949
947
  ### Recommended Usage Patterns
950
948
 
@@ -957,7 +955,7 @@ A: Yes! @dcyfr/ai is used in production at dcyfr-labs and other projects. It has
957
955
 
958
956
  - **vs. Custom Scripts:** 10-20x faster due to optimized plugin execution
959
957
  - **vs. Serial Validation:** 2-5x faster with parallel execution mode
960
- - **vs. LangChain:** Smaller bundle footprint (live Bundlephobia tracking)
958
+ - **vs. LangChain:** Smaller bundle footprint ([bundlephobia](https://bundlephobia.com/package/@dcyfr/ai))
961
959
 
962
960
  [⬆️ Back to top](#dcyfr-ai)
963
961