@framers/agentos 0.1.181 → 0.1.182

package/README.md

@@ -584,6 +584,46 @@ Pass `{}` for all defaults, or omit entirely to disable (zero overhead).
 
 Memory is organized in a 4-tier hierarchy: `core/` (encoding, decay, working memory), `retrieval/` (composite scoring, graph, prospective), `pipeline/` (consolidation, observation, lifecycle), `io/` (ingestion, import/export).
 
+**Automatic Memory Type Decomposition** -- the Observer→Reflector pipeline automatically classifies raw conversation into 5 memory types:
+
+| Type | What it stores | Example |
+|------|---------------|---------|
+| **Episodic** | Autobiographical events | "User and I discussed deployment on March 5th" |
+| **Semantic** | Durable facts | "User is a software engineer" |
+| **Procedural** | Patterns and preferences | "User prefers concise answers" |
+| **Prospective** | Future intentions | "User said they'd check back Friday" |
+| **Relational** | Trust signals and bonds | "User shared vulnerability about work stress" |
+
+The Reflector uses chain-of-thought reasoning and HEXACO personality bias to classify each trace. Commitment notes are auto-registered as prospective reminders.
+
+**KnowledgeGraph** is enabled by default -- spreading activation (Collins & Quillian model), Hebbian co-activation learning, conflict detection, and graph-boosted retrieval scoring. Set `graph: { disabled: true }` to opt out.
+
+**HyDE Memory Retrieval** -- a memory-specific Hypothetical Document Embedding retriever auto-attaches when an LLM invoker is available. Generates hypothetical stored traces for vague queries like "that thing about cats", improving recall. Opt-in per query via `retrieve({ hyde: true })`.
+
+**Prompt Assembly Guidance** -- the `MemoryPromptAssembler` injects a personality-aware preamble that teaches the LLM how to use each memory type differently (semantic as background truth, episodic woven naturally, prospective as action items, relational as tone modulators).
+
+**SqliteBrain Persistence** -- the cognitive memory path writes through to SqliteBrain's SQL tables via `@framers/sql-storage-adapter`. Traces survive process restarts. In-memory vector index is the hot read path; SQL is the durable backing store.
+
+**Full API Surface** via `AgentMemory`:
+
+```typescript
+const memory = AgentMemory.wrap(cognitiveManager);
+
+// Visualization
+const graph = await memory.getGraph();           // nodes, edges, clusters
+const dist = await memory.getStrengthDistribution(); // per-type stats
+const conflicts = await memory.getConflicts();   // contradicting traces
+
+// Inspection
+const relational = await memory.getRelationalMemories();
+const working = await memory.getWorkingMemory(); // in-focus slots
+const stats = await memory.getObservationStats(); // pipeline health
+
+// Portability
+const snapshot = await memory.exportSnapshot();  // full state export
+await memory.importSnapshot(snapshot);           // restore from export
+```
+
 See [`docs/memory/COGNITIVE_MECHANISMS.md`](./docs/memory/COGNITIVE_MECHANISMS.md) for API reference and 30+ APA citations.
 
 ### Multimodal RAG
@@ -599,6 +639,67 @@ Complete retrieval-augmented generation pipeline:
 
 See [`docs/memory/RAG_MEMORY_CONFIGURATION.md`](./docs/memory/RAG_MEMORY_CONFIGURATION.md) and [`docs/memory/MULTIMODAL_RAG.md`](./docs/memory/MULTIMODAL_RAG.md).
 
+### LLM Output Validation
+
+Structured LLM outputs are validated with Zod schemas, retried with error feedback on failure, and use provider-native structured output when available.
+
+```typescript
+import { createValidatedInvoker } from '@framers/agentos/core/validation';
+import { z } from 'zod';
+
+const PersonalitySchema = z.object({
+  honesty: z.number().min(0).max(100),
+  emotionality: z.number().min(0).max(100),
+  extraversion: z.number().min(0).max(100),
+});
+
+// Wrap any LLM invoker with Zod validation + retry
+const validated = createValidatedInvoker(llmInvoker, PersonalitySchema, {
+  maxRetries: 2,              // retry with error feedback on failure
+  injectSchemaOnRetry: true,  // include schema description in retry prompt
+});
+
+const personality = await validated(systemPrompt, userPrompt);
+// personality is typed as { honesty: number; emotionality: number; extraversion: number }
+```
+
+**Centralized JSON extraction** handles all messy LLM output formats:
+
+```typescript
+import { extractJson } from '@framers/agentos/core/validation';
+
+extractJson('```json\n{"key": "value"}\n```');     // '{"key": "value"}'
+extractJson('<thinking>hmm</thinking>\n{"a": 1}');  // '{"a": 1}'
+extractJson('Result: {"a": 1} done');               // '{"a": 1}'
+extractJson('{"a":1}\n{"b":2}');                    // '[{"a":1},{"b":2}]' (JSONL)
+```
+
+**Agent-level validation** via `responseSchema`:
+
+```typescript
+const extractor = agent({
+  instructions: 'Extract entities as JSON',
+  responseSchema: z.object({ entities: z.array(z.string()) }),
+});
+
+const result = await extractor.generate('Find entities in: ...');
+// result.parsed?.entities is string[] — typed and validated
+```
+
+**Schema primitives** for composing domain-specific schemas:
+
+```typescript
+import { MemoryTypeEnum, ConfidenceScore, EntityArray } from '@framers/agentos/core/validation';
+
+const MySchema = z.object({
+  type: MemoryTypeEnum,       // 'episodic' | 'semantic' | 'procedural' | 'prospective' | 'relational'
+  confidence: ConfidenceScore, // number 0-1
+  entities: EntityArray,       // string[], defaults to []
+});
+```
+
+When validation fails after all retries, `LlmOutputValidationError` is thrown with the raw output, Zod errors, retry count, and full retry history for debugging.
+
 ### Adaptive Intelligence & Metacognition
 
 Agents don't just respond — they monitor their own performance and adapt their behavior in real-time.

package/dist/api/agent.d.ts

@@ -55,6 +55,30 @@ export interface AgentOptions extends BaseAgentConfig {
     onFallback?: (error: Error, fallbackProvider: string) => void;
     /** Model router for intelligent provider selection per-call. */
     router?: IModelRouter;
+    /**
+     * Optional Zod schema for validating the LLM's structured output.
+     *
+     * When provided, the agent's `generate()` result includes a `parsed` field
+     * with the Zod-validated and typed output. JSON extraction and validation
+     * happen automatically in the `onAfterGeneration` hook. On validation failure,
+     * the agent retries internally (up to `controls.maxValidationRetries ?? 1`).
+     *
+     * When omitted, behavior is unchanged — `result.parsed` is undefined.
+     * This is a non-breaking additive change.
+     *
+     * @example
+     * ```ts
+     * import { z } from 'zod';
+     * const myAgent = agent({
+     *   name: 'Extractor',
+     *   instructions: 'Extract entities as JSON',
+     *   responseSchema: z.object({ entities: z.array(z.string()) }),
+     * });
+     * const result = await myAgent.generate('Find entities in: ...');
+     * console.log(result.parsed?.entities); // string[]
+     * ```
+     */
+    responseSchema?: import('zod').ZodType;
     /** Pre-generation hook, called before each LLM step. */
     onBeforeGeneration?: (context: GenerationHookContext) => Promise<GenerationHookContext | void>;
     /** Post-generation hook, called after each LLM step. */

package/dist/api/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/api/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/api/agent.ts"],"names":[],"mappings":"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"}

package/dist/api/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/api/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/api/agent.ts"],"names":[],"mappings":"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"}

package/dist/core/validation/ValidatedLlmInvoker.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Validated LLM invoker wrapper with Zod schema validation and retry.
+ *
+ * Wraps any `(systemPrompt, userPrompt) => Promise<string>` LLM invoker function
+ * with automatic JSON extraction, Zod validation, and retry-with-feedback on failure.
+ *
+ * Pipeline:
+ * 1. Call LLM via the raw invoker
+ * 2. Extract JSON from response via `extractJson()` (handles markdown fences, thinking blocks, JSONL)
+ * 3. Parse with `JSON.parse`
+ * 4. Validate with Zod `.safeParse()` (applies defaults, type coercion)
+ * 5. If valid: return typed result
+ * 6. If invalid: retry with error feedback + optional schema description
+ * 7. If all retries fail: throw `LlmOutputValidationError` with full history
+ *
+ * @module agentos/core/validation/ValidatedLlmInvoker
+ */
+import { type z } from 'zod';
+/** LLM invoker function with optional capability flags. */
+export interface LlmInvokerWithCapabilities {
+    (systemPrompt: string, userPrompt: string): Promise<string>;
+    /** Provider supports native JSON schema enforcement (Anthropic tool_use, OpenAI json_schema). */
+    supportsStructuredOutput?: boolean;
+    /** Provider ID for telemetry and logging. */
+    providerId?: string;
+}
+/** Options for the validated invoker wrapper. */
+export interface ValidatedInvokerOptions {
+    /**
+     * Maximum number of retry attempts after the initial call fails validation.
+     * Each retry appends error feedback to the system prompt.
+     * @default 1
+     */
+    maxRetries?: number;
+    /**
+     * Whether to inject the JSON Schema description into the retry prompt
+     * so the LLM knows exactly what shape is expected.
+     * @default true
+     */
+    injectSchemaOnRetry?: boolean;
+    /**
+     * Whether to prefer provider-native structured output when available.
+     * When true and the invoker has `supportsStructuredOutput: true`, the
+     * Zod schema is converted to JSON Schema and passed to the provider.
+     * @default true
+     */
+    preferStructuredOutput?: boolean;
+}
+/**
+ * Create a validated LLM invoker that returns typed, Zod-validated results.
+ *
+ * Wraps a raw LLM invoker function with:
+ * 1. JSON extraction from messy LLM output (markdown fences, thinking blocks, etc.)
+ * 2. Zod `.safeParse()` validation with full type inference
+ * 3. Retry with error feedback + schema description on failure
+ * 4. `LlmOutputValidationError` with retry history when all attempts fail
+ *
+ * @param invoker - Raw LLM invoker function `(system, user) => Promise<string>`
+ * @param schema - Zod schema to validate the extracted JSON against
+ * @param options - Retry count, schema injection, structured output preference
+ * @returns A function with the same `(system, user)` signature that returns `z.infer<T>`
+ *
+ * @example
+ * ```ts
+ * const validated = createValidatedInvoker(llmInvoker, PersonalitySchema);
+ * const personality = await validated(systemPrompt, userPrompt);
+ * // personality is typed as z.infer<typeof PersonalitySchema>
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With retry configuration
+ * const validated = createValidatedInvoker(invoker, Schema, {
+ *   maxRetries: 2,
+ *   injectSchemaOnRetry: true,
+ * });
+ * ```
+ */
+export declare function createValidatedInvoker<T extends z.ZodType>(invoker: LlmInvokerWithCapabilities | ((s: string, u: string) => Promise<string>), schema: T, options?: ValidatedInvokerOptions): (systemPrompt: string, userPrompt: string) => Promise<z.infer<T>>;
+//# sourceMappingURL=ValidatedLlmInvoker.d.ts.map

package/dist/core/validation/ValidatedLlmInvoker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidatedLlmInvoker.d.ts","sourceRoot":"","sources":["../../../src/core/validation/ValidatedLlmInvoker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,KAAK,CAAC,EAAY,MAAM,KAAK,CAAC;AAMvC,2DAA2D;AAC3D,MAAM,WAAW,0BAA0B;IACzC,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,iGAAiG;IACjG,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EACxD,OAAO,EAAE,0BAA0B,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,EACjF,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,uBAAuB,GAChC,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAiGnE"}

package/dist/core/validation/ValidatedLlmInvoker.js

@@ -0,0 +1,176 @@
+/**
+ * @fileoverview Validated LLM invoker wrapper with Zod schema validation and retry.
+ *
+ * Wraps any `(systemPrompt, userPrompt) => Promise<string>` LLM invoker function
+ * with automatic JSON extraction, Zod validation, and retry-with-feedback on failure.
+ *
+ * Pipeline:
+ * 1. Call LLM via the raw invoker
+ * 2. Extract JSON from response via `extractJson()` (handles markdown fences, thinking blocks, JSONL)
+ * 3. Parse with `JSON.parse`
+ * 4. Validate with Zod `.safeParse()` (applies defaults, type coercion)
+ * 5. If valid: return typed result
+ * 6. If invalid: retry with error feedback + optional schema description
+ * 7. If all retries fail: throw `LlmOutputValidationError` with full history
+ *
+ * @module agentos/core/validation/ValidatedLlmInvoker
+ */
+import { ZodError } from 'zod';
+import { extractJson } from './extractJson.js';
+import { LlmOutputValidationError } from './errors.js';
+// ── Implementation ───────────────────────────────────────────────────────
+/**
+ * Create a validated LLM invoker that returns typed, Zod-validated results.
+ *
+ * Wraps a raw LLM invoker function with:
+ * 1. JSON extraction from messy LLM output (markdown fences, thinking blocks, etc.)
+ * 2. Zod `.safeParse()` validation with full type inference
+ * 3. Retry with error feedback + schema description on failure
+ * 4. `LlmOutputValidationError` with retry history when all attempts fail
+ *
+ * @param invoker - Raw LLM invoker function `(system, user) => Promise<string>`
+ * @param schema - Zod schema to validate the extracted JSON against
+ * @param options - Retry count, schema injection, structured output preference
+ * @returns A function with the same `(system, user)` signature that returns `z.infer<T>`
+ *
+ * @example
+ * ```ts
+ * const validated = createValidatedInvoker(llmInvoker, PersonalitySchema);
+ * const personality = await validated(systemPrompt, userPrompt);
+ * // personality is typed as z.infer<typeof PersonalitySchema>
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With retry configuration
+ * const validated = createValidatedInvoker(invoker, Schema, {
+ *   maxRetries: 2,
+ *   injectSchemaOnRetry: true,
+ * });
+ * ```
+ */
+export function createValidatedInvoker(invoker, schema, options) {
+    const maxRetries = options?.maxRetries ?? 1;
+    const injectSchema = options?.injectSchemaOnRetry ?? true;
+    // Pre-compute a human-readable schema description for retry prompts.
+    // This is injected into the retry system prompt so the LLM knows
+    // exactly what JSON shape is expected on the next attempt.
+    const schemaDescription = describeSchema(schema);
+    return async (systemPrompt, userPrompt) => {
+        const retryHistory = [];
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            // On retries, append error feedback from the previous attempt
+            // so the LLM can correct its output. This dramatically improves
+            // success rates — most LLMs fix their JSON when told what's wrong.
+            let effectiveSystem = systemPrompt;
+            if (attempt > 0 && retryHistory.length > 0) {
+                const lastError = retryHistory[retryHistory.length - 1];
+                effectiveSystem = systemPrompt + '\n\n' +
+                    `IMPORTANT: Your previous response was not valid. Error: ${lastError.error}\n` +
+                    `Please output ONLY valid JSON matching the required format.` +
+                    (injectSchema ? `\n\nRequired JSON format:\n${schemaDescription}` : '');
+            }
+            // Call the LLM
+            const rawOutput = await invoker(effectiveSystem, userPrompt);
+            // Extract JSON from the raw output using centralized extraction
+            const jsonStr = extractJson(rawOutput);
+            if (!jsonStr) {
+                retryHistory.push({
+                    attempt,
+                    rawOutput,
+                    error: 'No JSON found in LLM output',
+                });
+                continue;
+            }
+            // Parse JSON
+            let parsed;
+            try {
+                parsed = JSON.parse(jsonStr);
+            }
+            catch (parseErr) {
+                retryHistory.push({
+                    attempt,
+                    rawOutput,
+                    error: `JSON parse error: ${parseErr instanceof Error ? parseErr.message : String(parseErr)}`,
+                });
+                continue;
+            }
+            // Validate with Zod — safeParse applies defaults and type coercion
+            const result = schema.safeParse(parsed);
+            if (result.success) {
+                return result.data;
+            }
+            // Validation failed — record the Zod error details for retry feedback
+            retryHistory.push({
+                attempt,
+                rawOutput,
+                error: `Zod validation: ${(result.error.issues ?? []).map((e) => `${(e.path ?? []).join('.')}: ${e.message}`).join('; ')}`,
+            });
+        }
+        // All attempts exhausted — throw with full history for debugging.
+        // The error includes the raw output and Zod errors from the final
+        // attempt, plus the complete retry history.
+        const lastRaw = retryHistory[retryHistory.length - 1]?.rawOutput ?? '';
+        // Build a ZodError from the final attempt's validation.
+        // Try to re-parse so we get the actual Zod errors from the last attempt.
+        let finalZodError;
+        const finalJsonStr = extractJson(lastRaw);
+        if (finalJsonStr) {
+            try {
+                const finalParsed = JSON.parse(finalJsonStr);
+                const finalResult = schema.safeParse(finalParsed);
+                finalZodError = finalResult.success
+                    ? new ZodError([])
+                    : finalResult.error;
+            }
+            catch {
+                finalZodError = new ZodError([]);
+            }
+        }
+        else {
+            finalZodError = new ZodError([]);
+        }
+        throw new LlmOutputValidationError(`LLM output validation failed after ${maxRetries} retries: ${retryHistory[retryHistory.length - 1]?.error ?? 'Unknown error'}`, lastRaw, finalZodError, maxRetries, retryHistory);
+    };
+}
+/**
+ * Generate a human-readable description of a Zod schema for injection
+ * into retry prompts. The LLM sees this and knows what JSON shape to produce.
+ *
+ * Uses `zod-to-json-schema` when available for accurate conversion.
+ * Falls back to a simple string representation when the library is
+ * not installed (non-critical — retry still works with error feedback alone).
+ *
+ * @param schema - Zod schema to describe
+ * @returns Multi-line string describing the expected JSON structure
+ */
+function describeSchema(schema) {
+    // Extract field names from Zod shape for a human-readable description.
+    // Zod v4 stores shape as a plain object on `_def.shape`.
+    // Zod v3 stores it as a function `_def.shape()`.
+    try {
+        const rawShape = schema._def?.shape;
+        const shape = typeof rawShape === 'function' ? rawShape() : rawShape;
+        if (shape && typeof shape === 'object') {
+            const fields = Object.keys(shape).join(', ');
+            return `A JSON object with these fields: ${fields}`;
+        }
+    }
+    catch {
+        // Ignore shape extraction failure
+    }
+    // Try zod-to-json-schema for complex schemas (optional dependency)
+    try {
+        const zodToJsonSchema = require('zod-to-json-schema').zodToJsonSchema;
+        const jsonSchema = zodToJsonSchema(schema);
+        const str = JSON.stringify(jsonSchema, null, 2);
+        // zod-to-json-schema may return {} for Zod v4 — check for useful content
+        if (str.length > 10)
+            return str;
+    }
+    catch {
+        // Not available — use field-name fallback above
+    }
+    return 'A valid JSON object matching the required schema';
+}
+//# sourceMappingURL=ValidatedLlmInvoker.js.map

package/dist/core/validation/ValidatedLlmInvoker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidatedLlmInvoker.js","sourceRoot":"","sources":["../../../src/core/validation/ValidatedLlmInvoker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAU,QAAQ,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAA8B,MAAM,aAAa,CAAC;AAoCnF,4EAA4E;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAiF,EACjF,MAAS,EACT,OAAiC;IAEjC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,OAAO,EAAE,mBAAmB,IAAI,IAAI,CAAC;IAE1D,qEAAqE;IACrE,iEAAiE;IACjE,2DAA2D;IAC3D,MAAM,iBAAiB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEjD,OAAO,KAAK,EAAE,YAAoB,EAAE,UAAkB,EAAuB,EAAE;QAC7E,MAAM,YAAY,GAA4B,EAAE,CAAC;QAEjD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,8DAA8D;YAC9D,gEAAgE;YAChE,mEAAmE;YACnE,IAAI,eAAe,GAAG,YAAY,CAAC;YACnC,IAAI,OAAO,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,SAAS,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACxD,eAAe,GAAG,YAAY,GAAG,MAAM;oBACrC,2DAA2D,SAAS,CAAC,KAAK,IAAI;oBAC9E,6DAA6D;oBAC7D,CAAC,YAAY,CAAC,CAAC,CAAC,8BAA8B,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5E,CAAC;YAED,eAAe;YACf,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;YAE7D,gEAAgE;YAChE,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,YAAY,CAAC,IAAI,CAAC;oBAChB,OAAO;oBACP,SAAS;oBACT,KAAK,EAAE,6BAA6B;iBACrC,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,aAAa;YACb,IAAI,MAAe,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,QAAQ,EAAE,CAAC;gBAClB,YAAY,CAAC,IAAI,CAAC;oBAChB,OAAO;oBACP,SAAS;oBACT,KAAK,EAAE,qBAAqB,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;iBAC9F,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,mEAAmE;YACnE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,MAAM,CAAC,IAAkB,CAAC;YACnC,CAAC;YAED,sEAAsE;YACtE,YAAY,CAAC,IAAI,CAAC;gBAChB,OAAO;gBACP,SAAS;gBACT,KAAK,EAAE,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAChI,CAAC,CAAC;QACL,CAAC;QAED,kEAAkE;QAClE,kEAAkE;QAClE,4CAA4C;QAC5C,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;QAEvE,wDAAwD;QACxD,yEAAyE;QACzE,IAAI,aAAuB,CAAC;QAC5B,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;gBAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;gBAClD,aAAa,GAAG,WAAW,CAAC,OAAO;oBACjC,CAAC,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAa;oBAC9B,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,aAAa,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAa,CAAC;YAC/C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,aAAa,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAa,CAAC;QAC/C,CAAC;QAED,MAAM,IAAI,wBAAwB,CAChC,sCAAsC,UAAU,aAAa,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,eAAe,EAAE,EAC9H,OAAO,EACP,aAAa,EACb,UAAU,EACV,YAAY,CACb,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,cAAc,CAAC,MAAiB;IACvC,uEAAuE;IACvE,yDAAyD;IACzD,iDAAiD;IACjD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAI,MAAc,CAAC,IAAI,EAAE,KAAK,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACrE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,oCAAoC,MAAM,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,mEAAmE;IACnE,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,eAAe,CAAC;QACtE,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChD,yEAAyE;QACzE,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,GAAG,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;IAED,OAAO,kDAAkD,CAAC;AAC5D,CAAC"}

package/dist/core/validation/errors.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Error types for LLM output validation failures.
+ *
+ * {@link LlmOutputValidationError} is thrown when LLM output fails Zod
+ * validation after all retry attempts. It carries the raw output, Zod
+ * errors, retry count, and full retry history so callers can debug,
+ * log, or surface the failure appropriately.
+ *
+ * @module agentos/core/validation/errors
+ */
+import type { ZodError } from 'zod';
+/** A single retry attempt record for debugging and telemetry. */
+export interface ValidationRetryRecord {
+    /** Zero-based attempt index (0 = initial attempt). */
+    attempt: number;
+    /** Raw LLM output from this attempt. */
+    rawOutput: string;
+    /** Human-readable error description (parse error or Zod validation error). */
+    error: string;
+}
+/**
+ * Thrown when LLM output fails Zod validation after all retry attempts.
+ *
+ * Contains the raw LLM response, Zod validation errors, retry count,
+ * and full retry history for debugging and telemetry. Callers can
+ * inspect `retryHistory` to understand what the LLM produced on each
+ * attempt and why it failed.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const result = await validatedInvoker(system, user);
+ * } catch (err) {
+ *   if (err instanceof LlmOutputValidationError) {
+ *     console.error('Validation failed after', err.retryCount, 'retries');
+ *     console.error('Zod errors:', err.zodErrors);
+ *     console.error('Raw output:', err.rawOutput);
+ *   }
+ * }
+ * ```
+ */
+export declare class LlmOutputValidationError extends Error {
+    /** Raw LLM output from the final attempt. */
+    readonly rawOutput: string;
+    /** Zod validation errors from the final attempt. */
+    readonly zodErrors: ZodError;
+    /** Number of retry attempts made (0 = failed on first try with no retries configured). */
+    readonly retryCount: number;
+    /** Full retry history for debugging — each attempt's raw output and error message. */
+    readonly retryHistory: ValidationRetryRecord[];
+    constructor(message: string, rawOutput: string, zodErrors: ZodError, retryCount: number, retryHistory: ValidationRetryRecord[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/validation/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/validation/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAEpC,iEAAiE;AACjE,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC7B,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,YAAY,EAAE,qBAAqB,EAAE,CAAC;gBAG7C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,QAAQ,EACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,qBAAqB,EAAE;CASxC"}

package/dist/core/validation/errors.js

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Error types for LLM output validation failures.
+ *
+ * {@link LlmOutputValidationError} is thrown when LLM output fails Zod
+ * validation after all retry attempts. It carries the raw output, Zod
+ * errors, retry count, and full retry history so callers can debug,
+ * log, or surface the failure appropriately.
+ *
+ * @module agentos/core/validation/errors
+ */
+/**
+ * Thrown when LLM output fails Zod validation after all retry attempts.
+ *
+ * Contains the raw LLM response, Zod validation errors, retry count,
+ * and full retry history for debugging and telemetry. Callers can
+ * inspect `retryHistory` to understand what the LLM produced on each
+ * attempt and why it failed.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const result = await validatedInvoker(system, user);
+ * } catch (err) {
+ *   if (err instanceof LlmOutputValidationError) {
+ *     console.error('Validation failed after', err.retryCount, 'retries');
+ *     console.error('Zod errors:', err.zodErrors);
+ *     console.error('Raw output:', err.rawOutput);
+ *   }
+ * }
+ * ```
+ */
+export class LlmOutputValidationError extends Error {
+    constructor(message, rawOutput, zodErrors, retryCount, retryHistory) {
+        super(message);
+        this.name = 'LlmOutputValidationError';
+        this.rawOutput = rawOutput;
+        this.zodErrors = zodErrors;
+        this.retryCount = retryCount;
+        this.retryHistory = retryHistory;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/validation/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/validation/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAUjD,YACE,OAAe,EACf,SAAiB,EACjB,SAAmB,EACnB,UAAkB,EAClB,YAAqC;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF"}

package/dist/core/validation/extractJson.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Centralized JSON extraction from messy LLM output.
+ *
+ * LLMs return structured data in many formats: raw JSON, markdown-fenced
+ * blocks, JSON wrapped in prose, JSONL, or JSON preceded by chain-of-thought
+ * `<thinking>` blocks. This module handles all of them with a priority-ordered
+ * extraction pipeline.
+ *
+ * Replaces the ad-hoc `JSON.parse` + `match()` + `split('\n')` patterns
+ * duplicated across 30+ files in AgentOS and wilds-ai.
+ *
+ * @module agentos/core/validation/extractJson
+ */
+/**
+ * Extract JSON from raw LLM output text.
+ *
+ * Tries multiple extraction strategies in priority order:
+ * 1. Raw JSON (entire string is valid JSON)
+ * 2. Markdown fenced blocks (```json ... ``` or ``` ... ```)
+ * 3. Strip `<thinking>` blocks, then retry
+ * 4. First `{...}` or `[...]` via greedy brace/bracket matching
+ * 5. JSONL (multiple JSON objects on separate lines → array)
+ *
+ * @param rawText - Raw LLM output that may contain JSON
+ * @returns Extracted JSON string, or null if no valid JSON found
+ *
+ * @example
+ * ```ts
+ * extractJson('```json\n{"key": "value"}\n```') // '{"key": "value"}'
+ * extractJson('<thinking>hmm</thinking>\n{"a":1}') // '{"a":1}'
+ * extractJson('no json here') // null
+ * ```
+ */
+export declare function extractJson(rawText: string): string | null;
+//# sourceMappingURL=extractJson.d.ts.map

package/dist/core/validation/extractJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractJson.d.ts","sourceRoot":"","sources":["../../../src/core/validation/extractJson.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoE1D"}