@futdevpro/fsm-dynamo 1.16.39 → 1.20.2

package/README.md

@@ -384,6 +384,9 @@ Deterministic encryption and decryption utilities using AES-256-CBC.
 - Cross-platform compatibility
 - URL-safe base64 encoding
 - Secure random key generation
+- Cross-runtime ECDSA P-256 artifact signing and public-key verification
+- Strict 64-byte IEEE P1363 signatures with unpadded Base64URL transport
+- Content-free verification codes and canonical public-JWK fingerprints
 
 **Important:** This implementation produces identical encrypted output for identical input data and key. Use when consistency across systems is more important than cryptographic security.
 
@@ -395,6 +398,11 @@ const encrypted = DyFM_Crypto.encrypt('sensitive data', 'my-secret-key');
 const decrypted = DyFM_Crypto.decrypt(encrypted, 'my-secret-key');
 ```
 
+For publication authenticity, `DyFM_ArtifactSignature_ControlService` signs exact caller-provided bytes with a
+PKCS#8 private key and verifies them with a public P-256 JWK. Private material belongs in the consuming server's
+FDP Keystore configuration and is never returned in signature evidence or sent to a browser. The verifier works
+through Web Crypto in secure browser contexts and supported Node.js runtimes.
+
 ### 9. Custom Data Module
 
 **Import:** `@futdevpro/fsm-dynamo/custom-data`

package/__documentations/2026-05-17-oai-compatible-providers-howto.md

@@ -0,0 +1,282 @@
+# 2026-05-17 — OpenAI-compatible providers (Hunglish how-to)
+
+**Spec:** `__agent/feature-requests/FR-005-oai-compat-provider-docs.md` (workspace root)
+**Scope:** docs-only, LOW priority. Nincs API-változás.
+
+---
+
+## Mire jó ez?
+
+A `DyFM_OAI_ClientOptions.baseURL` mező (`fsm-dynamo/_modules/ai/_modules/open-ai/_models/oai-client-options.interface.ts:25`) lehetővé teszi **tetszőleges OpenAI-API-kompatibilis endpoint** használatát az `openai` npm SDK-n keresztül — anélkül, hogy a Dynamo OAI service-eket (`DyFM_OAI_Settings`, downstream `DyNTS_OAI_Embedding_ControlService` / `DyNTS_OAI_LLM_ServiceBase`) bármi módon kellene módosítani.
+
+Tipikus use-case-ek:
+- **Lokál fejlesztés**: `OPENAI_API_KEY` nélkül, lokál LLM-mel (LM Studio, Ollama)
+- **Self-hosted production**: vLLM / LocalAI klaszter saját infrán
+- **Cost-control**: nyílt-súlyú modellek (Llama, Mistral, Qwen) drága API helyett
+
+A `baseURL`-override `openai` SDK-natív feature — Dynamo csak átadja a config-ot (`oai-llm.service-base.ts:91-98`):
+
+```typescript
+this.openai = new OpenAI(
+  set?.config ?? {
+    organization: DyNTS_global_settings.env_settings.openAi.organization,
+    apiKey: DyNTS_global_settings.env_settings.openAi.apiKey,
+    project: DyNTS_global_settings.env_settings.openAi.project,
+  }
+);
+```
+
+→ ha a `set.config.baseURL` ki van töltve, az SDK arra megy. Minden más változatlan.
+
+---
+
+## Általános minta
+
+```typescript
+import { DyFM_OAI_Settings, DyFM_OAI_CallSettings } from '@futdevpro/fsm-dynamo/ai/open-ai';
+import { DyNTS_OAI_LLM_ChatServiceBase } from '@futdevpro/dynamo-nts/ai/open-ai';
+
+const settings: DyFM_OAI_Settings = new DyFM_OAI_Settings({
+  config: {
+    baseURL: 'http://<provider-host>:<port>/v1',
+    apiKey: '<placeholder-or-real>',
+  },
+  defaultSettings: new DyFM_OAI_CallSettings({
+    useModel: '<provider-specific-model-id>',
+  }),
+});
+
+// Use with any Dynamo OAI service:
+class MyChat extends DyNTS_OAI_LLM_ChatServiceBase {}
+const chat: MyChat = new MyChat(settings);
+```
+
+A kulcs: `config.baseURL` + `config.apiKey` + `defaultSettings.useModel`. A többi mező (organization, project) lokál provider-eknél figyelmen kívül marad.
+
+---
+
+## Provider-szekciók
+
+### 1. LM Studio — desktop GUI lokál LLM-hez
+
+[LM Studio](https://lmstudio.ai) Mac/Windows/Linux desktop app, beépített OAI-compat szerverrel. Default port: `1234`.
+
+**Beállítás**:
+1. LM Studio-ban betölteni egy modellt (pl. `nomic-embed-text-v1.5` embedding-hez, `llama-3.2-3b-instruct` chat-hez)
+2. "Local Server" tab → "Start Server"
+
+**Code**:
+```typescript
+const lmStudio: DyFM_OAI_Settings = new DyFM_OAI_Settings({
+  config: {
+    baseURL: 'http://localhost:1234/v1',
+    apiKey: 'lm-studio',  // tetszőleges placeholder — LM Studio ignorálja
+  },
+  defaultSettings: new DyFM_OAI_CallSettings({
+    useModel: 'nomic-embed-text-v1.5',  // ahogy a Local Server megjeleníti
+  }),
+});
+```
+
+**Tipikus jellemzők**:
+- ✅ GUI a modell-letöltéshez (HuggingFace integráció)
+- ✅ Streaming chat completion support
+- ⚠️ Embedding limit: a UI-n külön kell betölteni embedding modellt
+- ❌ Multi-tenant / production-flow nem támogatott
+
+---
+
+### 2. Ollama — CLI-driven lokál LLM (OAI-compat layer ≥ v0.1.14)
+
+[Ollama](https://ollama.com) parancssoros LLM-runner, OAI-compat layerrel. Default port: `11434`.
+
+**Beállítás**:
+```bash
+ollama pull llama3.2:3b
+ollama pull nomic-embed-text
+ollama serve  # vagy ha service-ként fut, már megy
+```
+
+**Code**:
+```typescript
+const ollama: DyFM_OAI_Settings = new DyFM_OAI_Settings({
+  config: {
+    baseURL: 'http://localhost:11434/v1',
+    apiKey: 'ollama',  // szintén placeholder — Ollama nem ellenőrzi
+  },
+  defaultSettings: new DyFM_OAI_CallSettings({
+    useModel: 'nomic-embed-text',
+  }),
+});
+```
+
+**Tipikus jellemzők**:
+- ✅ Multi-modell support (`ollama pull <name>` → azonnal elérhető endpointon)
+- ✅ Embedding endpoint OAI-compat formában működik (v0.1.14+ óta)
+- ✅ Streaming chat completion OK
+- ⚠️ `function_call` / `tools` API csak részben támogatott a tool-aware modelleknél (Llama-3 family OK; small instruct modellek may not)
+- ⚠️ Context-window provider-szintű limit (általában 2048-8192 tokens default-tal — `OLLAMA_NUM_CTX` env-var)
+
+---
+
+### 3. vLLM — production-grade GPU inference server
+
+[vLLM](https://docs.vllm.ai) Python alapú, batched + PagedAttention GPU-inference. OAI-compatible REST endpoint beépítve. Default port: `8000`.
+
+**Beállítás**:
+```bash
+pip install vllm
+python -m vllm.entrypoints.openai.api_server \
+  --model meta-llama/Meta-Llama-3-8B-Instruct \
+  --port 8000 \
+  --api-key local-secret-token
+```
+
+**Code**:
+```typescript
+const vllm: DyFM_OAI_Settings = new DyFM_OAI_Settings({
+  config: {
+    baseURL: 'http://gpu-server:8000/v1',
+    apiKey: process.env.VLLM_API_KEY ?? 'local-secret-token',  // ha --api-key beállítva
+  },
+  defaultSettings: new DyFM_OAI_CallSettings({
+    useModel: 'meta-llama/Meta-Llama-3-8B-Instruct',  // a `--model` érték
+  }),
+});
+```
+
+**Tipikus jellemzők**:
+- ✅ Magas throughput (batched inference) — production scaling
+- ✅ Tool-calling support latest verziókban
+- ✅ Streaming OK
+- ⚠️ Egyszerre **egy** modell van memóriában (több modell = több instance)
+- ⚠️ Embedding endpoint NEM all modellnél — csak ha a model dedikált embedding (pl. `intfloat/e5-mistral-7b-instruct`)
+- ⚠️ GPU-szintű mem-management — OOM-ra dob, ha context-len túl nagy
+
+---
+
+### 4. LocalAI — REST-only multi-model platform
+
+[LocalAI](https://localai.io) Go-alapú, multi-backend (llama.cpp, whisper.cpp, stable-diffusion) REST szerver. OAI-compatible chat + embedding endpointokkal. Default port: `8080`.
+
+**Beállítás**:
+```bash
+docker run -p 8080:8080 \
+  -v $PWD/models:/build/models \
+  localai/localai:latest
+```
+
+Modellt vagy `models.yaml`-ban vagy runtime-on (`POST /models/apply`) lehet hozzáadni.
+
+**Code**:
+```typescript
+const localai: DyFM_OAI_Settings = new DyFM_OAI_Settings({
+  config: {
+    baseURL: 'http://localai:8080/v1',
+    apiKey: 'sk-local',  // placeholder
+  },
+  defaultSettings: new DyFM_OAI_CallSettings({
+    useModel: 'gpt-4',  // LocalAI alias → konfigban mapped a tényleges modellre
+  }),
+});
+```
+
+**Tipikus jellemzők**:
+- ✅ Egyszerre több modell loadolva — modell-aliasok
+- ✅ Multi-backend (LLM + Whisper transcribe + image-gen ugyanazon szerverről)
+- ✅ Streaming OK
+- ⚠️ A modell-aliasok kézi konfig kérdése — a `useModel` ID-nek pontosan match-elnie kell a `models.yaml`-ban definiálttal
+- ⚠️ Lassabb felpörgés gpu-acceleration nélkül (CPU-fallback default)
+
+---
+
+## Embedding modellek — provider-specifikus
+
+Az embedding-modell nevének **pontos egyezést** kell mutatnia a provider által regisztrált name-mel. Példák:
+
+| Provider | Embedding model ID | Megjegyzés |
+|---|---|---|
+| OpenAI (cloud) | `text-embedding-3-small`, `text-embedding-3-large` | Default |
+| LM Studio | `nomic-embed-text-v1.5`, `BAAI/bge-large-en-v1.5` | A betöltött modell ID-jét a Local Server tab írja ki |
+| Ollama | `nomic-embed-text`, `mxbai-embed-large` | `ollama list` mutatja |
+| vLLM | `intfloat/e5-mistral-7b-instruct` | Csak ha az indítási `--model` embedding-képes |
+| LocalAI | `text-embedding-ada-002` (aliasként) | A `models.yaml`-ban definiált alias |
+
+A `DyNTS_OAI_Embedding_ControlService` API-szintjén nem érzékeli a különbséget — a `useModel` field határoz meg mindent.
+
+---
+
+## Caveats — amire figyelni kell
+
+### Rate limits
+- **OpenAI**: tier-szintű, API-doc-ban
+- **LM Studio / Ollama / LocalAI**: nincs natív rate-limit — single-user dev tool
+- **vLLM**: konfigurálható (`--max-num-seqs` flag), default kvázi-unlimited
+
+### Max tokens / context window
+A `DyFM_OAI_CallSettings.maxTokens` provider-szintű limit alá kell hogy essen, különben az SDK 400/422-t kap:
+
+| Provider | Default context-window | Override |
+|---|---|---|
+| OpenAI gpt-4o | 128K | API tier-függő |
+| LM Studio | a betöltött modell native context-je | UI slider |
+| Ollama | 2048 (legacy default!) → `num_ctx` paraméter | `OLLAMA_NUM_CTX` env-var vagy `Modelfile` `PARAMETER num_ctx` |
+| vLLM | a modell native context-je | `--max-model-len` flag |
+| LocalAI | `models.yaml` `context_size` field | per-model konfig |
+
+### Error-handling különbségek
+- **OpenAI**: standard 400/401/403/429/500 + structured error body
+- **Lokál providerek**: gyakran **404 a modell-name-re** (ha rosszul ID-zed), **timeout** (modell-loadolás közben), **OOM** (vLLM)
+- **Ollama-specifikus**: ha a modell még nem `ollama pull`-olt, az endpoint csendben várakozik a pull-ig (lassú first-call)
+- **LocalAI**: model-name mismatch → 422-t dob OAI-szerű error-body-val
+
+### Function-calling / tool-use
+- **OpenAI**: teljes function-calling support
+- **Ollama**: model-függő — Llama-3.1+ és Mistral tool-aware modellek igen, kicsi instruct modellek nem
+- **vLLM**: support latest (v0.6+), de chat-template-mappel paraméterezni kell
+- **LM Studio / LocalAI**: parciális, model-függő
+
+### Streaming
+Mind a 4 provider támogat OAI-compat SSE streaming-et, **de**:
+- Ollama legacy verziók (< v0.1.20) `stream: false`-cal stabilabb
+- LocalAI streaming-rate alacsonyabb mint a token-emission
+
+---
+
+## Quick recipe — Dynamo-szintű váltás dev → cloud
+
+```typescript
+const isDev: boolean = process.env.NODE_ENV === 'development';
+
+const aiSettings: DyFM_OAI_Settings = new DyFM_OAI_Settings({
+  config: isDev
+    ? {
+        baseURL: 'http://localhost:11434/v1',  // Ollama
+        apiKey: 'dev',
+      }
+    : {
+        apiKey: process.env.OPENAI_API_KEY,
+        organization: process.env.OPENAI_ORG_ID,
+      },
+  defaultSettings: new DyFM_OAI_CallSettings({
+    useModel: isDev ? 'llama3.2:3b' : 'gpt-4o',
+  }),
+});
+```
+
+A Dynamo OAI service-ek mindkét beállítással ugyanúgy működnek.
+
+---
+
+## Hivatkozott source-fájlok
+
+| Fájl | Mit ad |
+|---|---|
+| `fsm-dynamo/src/_modules/ai/_modules/open-ai/_models/oai-client-options.interface.ts` | `DyFM_OAI_ClientOptions.baseURL` mező |
+| `fsm-dynamo/src/_modules/ai/_modules/open-ai/_models/oai-settings.control-model.ts` | `DyFM_OAI_Settings` wrapper |
+| `dynamo-nts/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts` | OpenAI SDK instantiation (config átadás) |
+| `dynamo-nts/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.ts` | Embedding endpoint usage |
+
+## Backward compatibility
+
+A `baseURL` mező mindig is létezett az OpenAI SDK-ban — a Dynamo egyetlen változtatása ehhez a docs-ot tisztázza, nem feature.

package/__documentations/2026-06-01-fr047-fc-foundation.md

@@ -0,0 +1,48 @@
+# FR-047 — function-calling foundation in dynamo-fsm (2026-06-01)
+
+**Parent**: `__agent/feature-requests/FR-047-provider-agnostic-function-calling.md` (+ Phase 1) and `FR-048-per-model-agnostic-settings.md`
+**Versions**: `01.15.17` (Phase 1 + registry), `01.15.18` (adultContent), `01.15.19` (export-bug fix)
+**Scope**: `src/_modules/ai` (agnostic core + provider model submodules), `package.json` (exports)
+
+## What
+
+The SDK-free agnostic AI core gained the full function-calling vocabulary + a per-model capability registry, plus a reserved per-model settings extension point. No execution logic here — that lives in dynamo-nts (Phase 2+).
+
+### 01.15.17 — Phase 1 vocabulary + registry foundation + FR-048 reservation
+- Tool models: `DyFM_AI_Tool`, `DyFM_AI_ToolCall`, `DyFM_AI_ToolResult`, `DyFM_AI_ToolHandler`/`DyFM_AI_ToolHandlers`.
+- `DyFM_AI_Message` + `DyFM_AI_LLM_Response` gained optional tool fields (`toolCalls`, `toolCallId`, `stopReason`); `DyFM_AI_MessageRole.tool` added.
+- `DyFM_AI_ModelType` extended: `Image`, `Audio`.
+- Per-model registry: `DyFM_AI_ModelInfo` + `DyFM_AI_ModelCapabilities` + the 5 provider const arrays (`DyFM_OAI_Models`, `DyFM_AAI_Models`, `DyFM_GAI_Models`, `DyFM_LAI_Models`, `DyFM_FdpAI_Models`) — verified 2026-06-01 against official provider docs.
+- `DyFM_AI_ModelRegistry_Util` (`findModelInfo`, `modelSupportsTools`) — takes the registry array as a param so the agnostic core imports NO provider submodule (keeps it SDK-free).
+- FR-048: `DyFM_AI_ModelSettingsSchema` reserved field on `DyFM_AI_ModelInfo` + thorough docs (per-model settings system; NOT implemented).
+
+### 01.15.18 — adultContent capability
+- `DyFM_AI_ModelCapabilities.adultContent: boolean` — can the model generate adult / uncensored / NSFW content. For content-routing + age-gating (e.g. Adventor mature mode). All 21 registered models = `false` (mainstream cloud is content-filtered; local/FdpAI conservative / model-dependent).
+
+### 01.15.19 — subpath export-bug fix
+- `package.json` `exports` + `typesVersions`: `./ai/google` and `./ai/local` pointed at non-existent `_modules/ai/_modules/google`/`local` folders; the real folders are `google-ai`/`local-ai`. Fixed the targets → `@futdevpro/fsm-dynamo/ai/google` and `./ai/local` now resolve. Unblocks dynamo-nts Phase 5 (Google).
+
+## Why
+
+Function calling needed to live in the strategic provider-agnostic layer (not only the legacy OpenAI-specific `FDPNTS_GPT_ControlService`). dynamo-fsm owns the vendor-neutral vocabulary + the model registry; dynamo-nts owns the execution (agent-loop + per-provider translators). This commit set delivers the fsm half so nts can build against it.
+
+## Design notes
+
+- All changes additive/non-breaking except the export-path fix (corrects a latent resolution bug) and the new required `adultContent` capability (all registry consts updated in the same release).
+- Capability honesty: `functionCalling` (and `adultContent`) are per-model; unknown/local models default conservative (`false`) — never assume capability.
+- Tool-handler runner semantics (never-throw, errors returned as strings to the model) are defined by the type + implemented in dynamo-nts.
+
+## Tests
+
+`pnpm test` (build-base + jasmine): **1302 specs / 0 failures / 70 pending** across the releases. New: `ai-model-registry.util.spec.ts` (findModelInfo + modelSupportsTools, incl. unknown-id → false).
+
+## What's NOT here
+
+- The agent-loop + provider translators (`requestWithTools`, `runToolLoop`, OpenAI/Anthropic/Gemini tool translators) — dynamo-nts (FR-047 Phase 2–5).
+- The per-model settings reconciler — FR-048 (reserved only).
+
+## Cross-references
+
+- `__agent/feature-requests/FR-047-*.md`, `FR-048-per-model-agnostic-settings.md`
+- `fdp-documentations/guidelines/development/ai-per-model-settings.md`
+- dynamo-nts Phase 2+3 (agent-loop + OpenAI translator) — implemented in parallel.

package/__documentations/2026-06-01-fr047-fr048-code-review.md

@@ -0,0 +1,153 @@
+# 2026-06-01 — Code Review: FR-047 + FR-048 (provider-agnostic AI vocabulary)
+
+## Summary
+
+Code review futott a `dynamo-fsm` master branchen az utolsó 3 commit-ra (FR-047 + FR-048) + 1 uncommitted root pipeline-config deletion-re. Az effort-szint **high**: 7 finder angle × ≤6 candidate → 1-vote verify (recall-biased) → top-10 finding.
+
+### Scope
+
+- **Range**: `HEAD~3..HEAD` (master, no upstream divergence)
+- **Commits**:
+  - `08e8859` feat(ai): FR-047 P1 provider-agnostic function-calling vocabulary + per-model registry; FR-048 settings-schema reservation
+  - `de1da9b` feat(ai): add adultContent (uncensored/NSFW) per-model capability
+  - `6a4ce9c` fix(ai): FR-047 P5 — correct ./ai/google + ./ai/local subpath export targets
+- **Uncommitted**: `pipeline.cicd.config.json` (root) -128 sor delete (dmc migracio takaritas)
+- **Source-diff stat**: 30 fajl, 940 inserciol / 12 deletes (build/ artifact kizarva)
+
+### Tool
+
+A `/code-review` skill (high effort), local execution. Phase 1 — 7 párhuzamos finder agent (Explore type):
+- **3 correctness angle**: line-by-line scan, removed-behavior auditor, cross-file tracer
+- **3 cleanup angle**: reuse, simplification, efficiency
+- **1 altitude angle**: depth check
+
+Phase 2 — 1-vote verifier batch agent (recall-biased), 17 candidate → 16 survivor (1 REFUTED).
+
+## Top-10 Finding (ranked most-severe first)
+
+A teljes JSON output `__documentations/2026-06-01-fr047-fr048-code-review-findings.json`-ben. Itt a Hunglish summary:
+
+### 1. `gptImage_1` enum-entry registry-mentes (CONFIRMED)
+
+**Fajl**: `src/_modules/ai/_modules/open-ai/_enums/oai-model.enum.ts:19`
+
+A `DyFM_OAI_Model.gptImage_1 = 'gpt-image-1'` enum-ben szerepel + komment szerint **"current"** (nem deprecated), de a `DyFM_OAI_Models` registry-ben NEM kap entry-t.
+
+**Failure scenario**: `modelSupportsTools(DyFM_OAI_Models, DyFM_OAI_Model.gptImage_1)` → false (a util `?? false`-szal default-ol). `findModelInfo` undefined. Az image generation tools-on-keresztul rutalas silent-skip.
+
+### 2. `claude_3_5_sonnet_latest` enum + nincs registry (CONFIRMED)
+
+**Fajl**: `src/_modules/ai/_modules/anthropic/_enums/aai-model.enum.ts:11`
+
+A `DyFM_AAI_Models` registry csak 3 GA entry-t tartalmaz; a deprecated `claude_3_5_sonnet_latest` az enum-ben van, registry-bol kimaradt.
+
+**Failure scenario**: Default `DyFM_AI_CallSettings` ami a `claude_3_5_sonnet_latest`-et hasznalja → `modelSupportsTools` false → tool-calling silent-disable egy meg-mindig-elo API modelen.
+
+### 3. `gemini_1_5_pro_latest` enum + nincs registry (CONFIRMED)
+
+**Fajl**: `src/_modules/ai/_modules/google-ai/_enums/gai-model.enum.ts:11`
+
+Ugyanaz a minta mint #2 — google oldalon.
+
+### 4. `modelSupportsTools` silent-false unknown-ID-ra (CONFIRMED)
+
+**Fajl**: `src/_modules/ai/_collections/ai-model-registry.util.ts:27`
+
+`Array.find()` → `?? false` minta. Tipo, deprecated, vagy live-but-unregistered model esten → `false` warn/log nelkul.
+
+**Failure scenario**: Diagnozis nelkul lehetetlen kideriteni miert nem hivodik a tool-routing. Egy `{ strict: true }` mode vagy `DyFM_Log.warn` flegging hianyzik.
+
+### 5. Legacy + active enum-tagok keveredtek (CONFIRMED)
+
+**Fajlok**: `aai/gai/oai-model.enum.ts`
+
+Csak komment kulonbozteti meg az active es retired model-ID-kat. Az enum public API-jaban mindketto egyformanak latszik. A #1-3 ennek tuneti megnyilvanulasa.
+
+**Tervezet fix**: `*-legacy.enum.ts` kulon fajl, vagy minden retired enum-tag mellé `@deprecated` JSDoc tag.
+
+### 6. `DyFM_AI_Message.content` required, de tool-calls esetn ures (CONFIRMED)
+
+**Fajl**: `src/_modules/ai/_models/ai-message.interface.ts:6`
+
+`content: string` (non-optional). Mikor `role='assistant'` + `toolCalls` populalva → a content semantically ures OpenAI/Anthropic/Gemini API-knal.
+
+**Failure scenario**: Caller hard-coded `content: ''` workaround minden tool-call message-en; downstream "content empty" validator visszadobhatja a tool-request message-eket.
+
+### 7. `settingsSchema` ghost contract (CONFIRMED)
+
+**Fajl**: `src/_modules/ai/_models/ai-model-info.interface.ts:37`
+
+`settingsSchema?: DyFM_AI_ModelSettingsSchema` reserved minden modelen, de a 21 registry entry kozul EGYIK SEM populalja.
+
+**Failure scenario**: Phase 2 (FR-048) reconciler reading `settingsSchema` undefined → "no constraints" semantikat olvas a "constraints not yet modeled" helyett → silent-accept `temperature` parameter Opus 4.7+ hivason → HTTP 400 hard-fail.
+
+### 8. `finishReason` vs `stopReason` dual-field (PLAUSIBLE)
+
+**Fajl**: `src/_modules/ai/_models/ai-llm-response.interface.ts:16`
+
+Mindketto optional. Legacy `finishReason` + new `stopReason`. Doc-mentes melyik az authoritative.
+
+**Failure scenario**: Provider translator csak `stopReason`-t populalja → legacy consumer `finishReason === 'tool_use'`-t check-el → condition false → tool flow miss.
+
+### 9. Tool-vocab interfaces 0-caller (PLAUSIBLE)
+
+**Fajl**: `src/_modules/ai/_models/ai-tool.interface.ts`
+
+Uj `DyFM_AI_Tool`, `DyFM_AI_ToolCall`, `DyFM_AI_ToolResult`, `DyFM_AI_ToolHandler` exportalt **dynamo-fsm-bol**, de **ZERO caller** sajat-projekten belul. Az abstrakcio nem validalt.
+
+**Failure scenario**: A shape lehet hogy nem fer ra a 5 provider mind-egyikere (OpenAI `type:'function'` wrapper, Anthropic `input_schema`, Gemini `functionDeclarations`). FR-048 mid-flight API redesign-kenyszer.
+
+### 10. Root pipeline.cicd.config.json -128 sor (CONFIRMED, uncommitted)
+
+**Fajl**: `pipeline.cicd.config.json` (root, delete)
+
+A `.dynamo/pipeline.cicd.config.json` fully fedi, DE barmely external workflow / GitHub Actions / script ami hardcoded `./pipeline.cicd.config.json` ref-fel → 404.
+
+## Levágott (cleanup-class — kovetkezo iteracio)
+
+A skill rule: "Correctness bugs always outrank cleanup and altitude findings when the output cap forces a cut." Ezert a top-10 keret felett kihagyott 6 valid finding:
+
+| # | Fajl | Issue |
+|---|---|---|
+| 11 | `src/_modules/ai/index.ts` | No meta-barrel a 5 provider model-registry-re; Phase 2 hardcodes 5 imports |
+| 12 | `ai-model-capabilities.interface.ts` + 5 const-fajl | Capability matrix copy-paste 21 model × 9 mező — N+1 edit kotelezo |
+| 13 | `ai-model-capabilities.interface.ts:31` | `adultContent` policy-flag feature-capabilities matrix-ban; jovobeli policy flags scatterolnek |
+| 14 | `package.json` exports | Naming inconsistency: `anthropic` (no hyphen) vs `open-ai/google-ai/local-ai/fdp-ai` |
+| 15 | `ai-model-registry.util.ts:17` | O(N) `Array.find` registry lookup vs O(1) Map |
+| 16 | Provider `index.ts` (×5) | Tree-shake loss: barrel pulls all 5 const-tables (~519 lines) for single-provider consumer |
+
+## REFUTED (1 db)
+
+| # | Fajl | Reason |
+|---|---|---|
+| - | `oai-models.const.ts:235` gptImage_2 missing maxOutputTokens | Verified: `maxOutputTokens?` optional a `DyFM_AI_ModelInfo` interface-en, no type-level contract violation, no crash |
+
+## Strukturalis tanulsag (kozos pattern a #1-5 mogott)
+
+A top-10 elso 5 finding mind UGYANARRA a strukturalis hiba-mintara mutat: **az enum-tagok es a registry-entries nincsenek szinkronban**. Tervezet javitas:
+
+**Opció A** (defensive): minden enum-entry-nek legyen registry-entry, deprecated-eket `*-legacy.enum.ts`-be kulonitsd el.
+
+**Opció B** (strict-mode): `modelSupportsTools(models, id, { strict: true })` — unknown ID-ra throw vagy `DyFM_Log.warn`.
+
+**Opció C** (build-time validation): TS guard-test ami compile-time verifikalja hogy minden enum-tag registry-entry-vel jar.
+
+Mind a 3 megoldhato — a #1-5 + #11 (meta-barrel) kombo eseten egy follow-up commit lefedi.
+
+## Stat
+
+| | |
+|---|---|
+| **Specs** | 1302 spec / 0 failure (TypeScript + jasmine) |
+| **TS compile** | ✓ (0 error) |
+| **Diff scope** | 30 src fajl / 940 ins / 12 del (build/ kizarva) |
+| **Finder agents** | 7 (parallel) |
+| **Verifier agents** | 1 (batch over 17 candidates) |
+| **Output cap** | 10 finding (skill default) |
+| **Time** | ~15 min full pipeline |
+
+## Reference
+
+- Skill: `code-review` (high effort)
+- Skill instrukciok: 3 correctness + 3 cleanup + 1 altitude angle × ≤6 candidates per angle; 1-vote verify per candidate; recall-biased PLAUSIBLE default; REFUTED only constructible from code
+- Workflow: lokal jasmine `npx jasmine --config=spec/support/jasmine.json` → 1302/0

package/__documentations/2026-06-01-fr047-p1-function-calling-vocabulary.md

@@ -0,0 +1,75 @@
+# FR-047 P1 — Provider-agnostic function-calling vocabulary + per-model registry (2026-06-01)
+
+**Commit**: `08e8859` — v01.15.16 → v01.15.17 (published)
+**Parent**: `__agent/feature-requests/FR-047-phase-1-tool-abstraction.md` (master: `FR-047-provider-agnostic-function-calling.md`)
+**Pattern**: `fdp-documentations/guidelines/development/ai-function-calling.md`
+**Also in this commit**: FR-048 settings-schema reservation (`FR-048-per-model-agnostic-settings.md`)
+
+## What
+
+Adds the SDK-free, vendor-neutral vocabulary for LLM function calling to `@futdevpro/fsm-dynamo/ai`,
+plus a per-model capability registry. After this, the execution layer (`nts-dynamo`, FR-047 P2+P3)
+can speak one tool shape across providers.
+
+## Why
+
+Function calling existed ONLY in the legacy OpenAI-only `FDPNTS_GPT_ControlService.getAnswerWithTools`
+(nts-fdp-templates). The strategic provider-agnostic layer had ZERO tool support: `DyFM_AI_Message`
+was `{role,content}`, `DyFM_AI_LLM_Response` had no `toolCalls`, and the `functionCalling` provider-
+capability flag was dead. This commit is the foundation for moving tool use into the strategic layer.
+
+## Design
+
+### Tool models (`src/_modules/ai/_models/`)
+```ts
+DyFM_AI_Tool          // { name, description, parameters: object /* JSON Schema */ }
+DyFM_AI_ToolCall      // { id, name, arguments: Record<string,unknown> } (normalized; OpenAI JSON-string parsed at boundary)
+DyFM_AI_ToolResult    // { toolCallId, content: string, isError? }
+DyFM_AI_ToolHandler / DyFM_AI_ToolHandlers   // lifted from legacy FDPNTS_GPT_ToolHandler(s)
+```
+
+### Additive extensions (non-breaking, optional fields)
+- `DyFM_AI_Message` + `toolCalls?` (assistant tool-call turn) + `toolCallId?` (tool-result message)
+- `DyFM_AI_LLM_Response` + `toolCalls?` + `stopReason?`
+- `DyFM_AI_MessageRole.tool`
+- `DyFM_AI_ModelType` + `Image`, `Audio`
+
+### Per-model registry
+- `DyFM_AI_ModelInfo` (id / provider / modelType / capabilities / contextWindow / maxOutputTokens
+  + lifecycle: status / successorId / sunsetDate + displayName / tier)
+- `DyFM_AI_ModelCapabilities` (functionCalling / vision / streaming / jsonMode / audioInput /
+  audioOutput / imageGeneration / embeddings)
+- Per-provider const arrays: `DyFM_OAI_Models`, `DyFM_AAI_Models`, `DyFM_GAI_Models`, `DyFM_LAI_Models`,
+  `DyFM_FdpAI_Models` (2026-06 verified data — see `[[reference_ai_provider_model_registry_research]]`)
+- `DyFM_AI_ModelRegistry_Util.findModelInfo(models, id)` / `modelSupportsTools(models, id)` — the
+  registry array is **passed in**, so the agnostic `./ai` core imports NO provider submodule
+  (keeps it SDK-free). Unknown id → `false` (honesty).
+
+### FR-048 reservation (space left, NOT implemented)
+- `DyFM_AI_ModelSettingsSchema` + `DyFM_AI_SettingConstraint` (reserved placeholder)
+- `DyFM_AI_ModelInfo.settingsSchema?` + thorough doc on `DyFM_AI_CallSettings` — the per-model
+  "which params does this model accept/reject" system. Sibling of capabilities. See `ai-per-model-settings.md`.
+
+## Spec coverage
+
+`src/_modules/ai/_collections/ai-model-registry.util.spec.ts` — findModelInfo (known/unknown) +
+modelSupportsTools (tool-capable chat / embedding=false / unknown=false). `pnpm test`: **1302/0** (70 pending).
+
+## Optional-SDK discipline
+
+The agnostic `./ai` index imports no provider submodule → `import '@futdevpro/fsm-dynamo/ai'` pulls
+zero AI SDKs. Provider model data lives under `./ai/<provider>` subpaths.
+
+## What's NOT in this commit
+
+- The agent-loop / execution (nts-dynamo P2+P3 — `requestWithTools`).
+- `adultContent` capability (added later, `de1da9b`, v01.15.18).
+- `./ai/google` + `./ai/local` subpath export-bug fix (FR-047 P5, `6a4ce9c`).
+- FR-048 runtime reconciler (reserved only).
+
+## Cross-references
+
+- `fdp-documentations/guidelines/development/ai-function-calling.md` (pattern)
+- `fdp-documentations/guidelines/development/ai-per-model-settings.md` (FR-048)
+- `NPM-packages/dynamo-nts/__documentations/2026-06-01-fr047-p2p3-function-calling.md` (the consumer)
+- legacy `NPM-packages/fdp-templates-nts/src/_modules/gpt/_services/gpt-handler.control-service.ts`

package/__documentations/2026-06-05-secret-mask-url-cred-any-scheme.md

@@ -0,0 +1,37 @@
+# 2026-06-05 — DyFM_SecretMask: url-cred pattern BARMELY scheme-re (+ elso spec)
+
+## Problema
+
+A `DyFM_SECRET_PATTERNS` `url-cred` pattern-je CSAK `http(s)://user:pass@`-t fogott
+(`/\b(https?:\/\/)([^/\s:@]+):([^\s@]+)@/g`). A `mongodb://user:pass@host` / `postgres://` /
+`redis://` connection-string jelszo — a leggyakoribb DB-secret-leak vektor a CI-logokban, es
+az FDP-stack MongoDB-t hasznal — NEM maszkolodott (runtime-igazolt gap a `fdp pipeline` secret-
+maszkolas bekotesekor).
+
+## Fix
+
+- A scheme kiszelesitve BARMELY URL-protokollra: `https?` → `[a-z][a-z0-9+.-]*` + `i` flag.
+- A user-resz `+` → `*` (ures user is): a `redis://:password@host` (username nelkuli, csak jelszo)
+  valos redis/DB auth-format.
+- A `user:pass@` szerkezet KOTELEZO marad → nincs false-positive: sima URL (`https://h:8080/path`,
+  port-tal, de `@` nelkul) NEM matchel; a `mongodb://db:27017/app` (nincs cred) NEM matchel.
+- A `$1` (scheme) + host megorzodik: `mongodb://[redacted-url-cred]@db:27017/app`.
+
+Uj regex: `/\b([a-z][a-z0-9+.-]*:\/\/)([^/\s:@]*):([^\s@]+)@/gi`
+
+## Test (uj — eddig NEM volt spec a maskerhez)
+
+Uj `secret-mask.util.spec.ts` (16 assert):
+- url-cred: http/https/mongodb/postgres/redis + case-insensitive + ures-user;
+  no-false-positive (port / cred-less URL);
+- token-regresszio: github-pat + env-style-secret;
+- non-secret: commit-SHA + verzio erintetlen;
+- `DyFM_maskSecretsDeep`: rekurziv string-maszkolas + strukturа-megorzes.
+
+`npx tsc` (exit 0) + `npx jasmine`: **1443 specs, 0 failures**, 72 pending.
+
+## Consumer
+
+Az `fdp-cli` (`pipeline-notify` Discord + `pipeline-report` Overseer-POST) mar hasznalja a
+`DyFM_maskSecrets`/`DyFM_maskSecretsDeep`-et; a broadened url-cred a kovetkezo fsm-dynamo
+dep-bump utan lep eletbe a fleeten (nem fleet-bump-olunk kezzel).