@almadar/llm 2.48.0 → 2.49.0

package/dist/index.d.ts

@@ -325,7 +325,10 @@ declare function buildGenericContinuationPrompt(context: string, partialResponse
  */
 interface JsonSchemaDefinition extends ServiceParams {
     type?: string;
-    properties?: JsonSchemaDefinition;
+    /** Keyed by field name — each named field carries its OWN nested schema
+     *  (real JSON-Schema semantics; a single un-keyed nested schema here would
+     *  say every field of an object shares one shape). */
+    properties?: Record<string, JsonSchemaDefinition>;
     required?: string[];
     items?: JsonSchemaDefinition;
     additionalProperties?: JsonSchemaDefinition;
@@ -395,6 +398,8 @@ type LLMServiceActions = {
             model?: string;
         };
         result: {
+            /** The extracted structure follows the caller's `schema` — the consumer declares its shape.
+             *  @shapedBy schema */
             data: ExtractedData;
             confidence: number;
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/llm",
-  "version": "2.48.0",
+  "version": "2.49.0",
   "description": "Multi-provider LLM client with rate limiting, token tracking, structured outputs, and continuation handling",
   "type": "module",
   "main": "./dist/index.js",
@@ -47,11 +47,11 @@
     "zod": "^3.22.0"
   },
   "peerDependencies": {
-    "@almadar/core": "^10.81.0"
+    "@almadar/core": "^10.87.0"
   },
   "devDependencies": {
-    "@almadar/core": "^10.81.0",
-    "@almadar/eslint-plugin": "^2.17.0",
+    "@almadar/core": "^10.87.0",
+    "@almadar/eslint-plugin": "^2.18.0",
     "@types/node": "^22.0.0",
     "@typescript-eslint/parser": "8.65.0",
     "@typescript/native": "npm:typescript@^7.0.2",

package/src/contracts.ts

@@ -21,7 +21,10 @@ import type { ServiceContract, ServiceParams, ServiceParamsValue } from "@almada
  */
 interface JsonSchemaDefinition extends ServiceParams {
   type?: string;
-  properties?: JsonSchemaDefinition;
+  /** Keyed by field name — each named field carries its OWN nested schema
+   *  (real JSON-Schema semantics; a single un-keyed nested schema here would
+   *  say every field of an object shares one shape). */
+  properties?: Record<string, JsonSchemaDefinition>;
   required?: string[];
   items?: JsonSchemaDefinition;
   additionalProperties?: JsonSchemaDefinition;
@@ -93,6 +96,8 @@ export type LLMServiceActions = {
       model?: string;
     };
     result: {
+      /** The extracted structure follows the caller's `schema` — the consumer declares its shape.
+       *  @shapedBy schema */
       data: ExtractedData;
       confidence: number;
     };