@almadar/core 10.86.0 → 10.88.0

package/dist/patterns/services-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-09-03T18:48:24.308Z",
+  "exportedAt": "2026-09-07T01:58:57.916Z",
   "services": {
     "llm": {
       "name": "llm",
@@ -115,8 +115,14 @@
                   "required": false
                 },
                 "properties": {
-                  "type": "JsonSchemaDefinition",
-                  "required": false
+                  "type": "object",
+                  "required": false,
+                  "description": "Keyed by field name — each named field carries its OWN nested schema\n(real JSON-Schema semantics; a single un-keyed nested schema here would\nsay every field of an object shares one shape).",
+                  "mapValue": {
+                    "type": "JsonSchemaDefinition",
+                    "cyclic": true,
+                    "cyclicTypeName": "JsonSchemaDefinition"
+                  }
                 },
                 "required": {
                   "type": "string[]",
@@ -124,11 +130,15 @@
                 },
                 "items": {
                   "type": "JsonSchemaDefinition",
-                  "required": false
+                  "required": false,
+                  "cyclic": true,
+                  "cyclicTypeName": "JsonSchemaDefinition"
                 },
                 "additionalProperties": {
                   "type": "JsonSchemaDefinition",
-                  "required": false
+                  "required": false,
+                  "cyclic": true,
+                  "cyclicTypeName": "JsonSchemaDefinition"
                 },
                 "description": {
                   "type": "string",
@@ -149,7 +159,10 @@
             }
           ],
           "responseShape": {
-            "data": "ExtractedData",
+            "data": {
+              "type": "ExtractedData",
+              "shapedBy": "schema"
+            },
             "confidence": "number"
           },
           "synonyms": "parse, structure"
@@ -418,7 +431,12 @@
           "description": "",
           "params": [],
           "responseShape": {
-            "counts": "object"
+            "counts": {
+              "type": "object",
+              "mapValue": {
+                "type": "number"
+              }
+            }
           }
         }
       ],
@@ -572,7 +590,10 @@
               "name": "source",
               "type": "object",
               "required": true,
-              "description": "ImportSource descriptor (kind + source-specific config)"
+              "description": "ImportSource descriptor (kind + source-specific config)",
+              "mapValue": {
+                "type": "string"
+              }
             },
             {
               "name": "connectionRef",
@@ -588,7 +609,15 @@
             }
           ],
           "responseShape": {
-            "documents": "array"
+            "documents": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "mapValue": {
+                  "type": "string"
+                }
+              }
+            }
           }
         },
         {
@@ -599,7 +628,10 @@
               "name": "source",
               "type": "object",
               "required": true,
-              "description": "ImportSource descriptor (kind + source-specific config)"
+              "description": "ImportSource descriptor (kind + source-specific config)",
+              "mapValue": {
+                "type": "string"
+              }
             },
             {
               "name": "documentId",
@@ -615,7 +647,12 @@
             }
           ],
           "responseShape": {
-            "document": "object"
+            "document": {
+              "type": "object",
+              "mapValue": {
+                "type": "string"
+              }
+            }
           }
         },
         {
@@ -632,7 +669,13 @@
               "name": "units",
               "type": "array",
               "required": true,
-              "description": "ImportUnit[] staged for commit"
+              "description": "ImportUnit[] staged for commit",
+              "items": {
+                "type": "object",
+                "mapValue": {
+                  "type": "string"
+                }
+              }
             },
             {
               "name": "connectionRef",
@@ -643,7 +686,15 @@
           ],
           "responseShape": {
             "committed": "number",
-            "failed": "array"
+            "failed": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "mapValue": {
+                  "type": "string"
+                }
+              }
+            }
           }
         }
       ],
@@ -1199,7 +1250,10 @@
               "name": "metadata",
               "type": "object",
               "required": false,
-              "description": "Arbitrary key-value tags attached to the PaymentIntent (string values only)."
+              "description": "Arbitrary key-value tags attached to the PaymentIntent (string values only).",
+              "mapValue": {
+                "type": "string"
+              }
             }
           ],
           "responseShape": {
@@ -1717,7 +1771,10 @@
               "name": "payload",
               "type": "object",
               "required": false,
-              "description": "Event payload; defaults to an empty object."
+              "description": "Event payload; defaults to an empty object.",
+              "mapValue": {
+                "type": "string"
+              }
             },
             {
               "name": "secret",
@@ -2850,7 +2907,10 @@
               "name": "buildArgs",
               "type": "object",
               "required": false,
-              "description": "Build-time --build-arg values."
+              "description": "Build-time --build-arg values.",
+              "mapValue": {
+                "type": "string"
+              }
             }
           ],
           "responseShape": {
@@ -2903,7 +2963,10 @@
               "name": "env",
               "type": "object",
               "required": false,
-              "description": "Environment variables set inside the container."
+              "description": "Environment variables set inside the container.",
+              "mapValue": {
+                "type": "string"
+              }
             },
             {
               "name": "volumes",
@@ -3177,7 +3240,10 @@
             }
           ],
           "responseShape": {
-            "rows": "DatabaseRow[]",
+            "rows": {
+              "type": "DatabaseRow[]",
+              "shapedBy": "rows"
+            },
             "rowCount": "number"
           }
         }
@@ -3258,9 +3324,12 @@
             },
             {
               "name": "metadata",
-              "type": "IntegrationParams",
+              "type": "object",
               "required": false,
-              "description": "Arbitrary metadata stored alongside the object (in-memory backend only)."
+              "description": "Object metadata stored alongside the content (S3-compatible object stores carry metadata as string headers — never structured values).",
+              "mapValue": {
+                "type": "string"
+              }
             }
           ],
           "responseShape": {
@@ -3380,7 +3449,12 @@
             "content": "string",
             "contentType": "string",
             "size": "number",
-            "metadata": "IntegrationParams"
+            "metadata": {
+              "type": "object",
+              "mapValue": {
+                "type": "string"
+              }
+            }
           }
         },
         {
@@ -3548,7 +3622,8 @@
               "name": "payload",
               "type": "ServiceParams",
               "required": true,
-              "description": "Arbitrary job payload."
+              "description": "Job payload — the caller declares its own shape.",
+              "shapedBy": "payload"
             },
             {
               "name": "delay",
@@ -3580,7 +3655,29 @@
             }
           ],
           "responseShape": {
-            "job": "object | null"
+            "job": {
+              "type": "QueueJob | null",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "required": true
+                },
+                "payload": {
+                  "type": "ServiceParams",
+                  "required": true,
+                  "description": "Whatever `enqueue` was given — the caller declares its own shape.",
+                  "shapedBy": "payload"
+                },
+                "enqueuedAt": {
+                  "type": "number",
+                  "required": true
+                },
+                "priority": {
+                  "type": "number",
+                  "required": true
+                }
+              }
+            }
           }
         },
         {
@@ -3596,7 +3693,29 @@
           ],
           "responseShape": {
             "status": "'pending' | 'processing' | 'completed' | 'failed'",
-            "job": "object | null"
+            "job": {
+              "type": "QueueJob | null",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "required": true
+                },
+                "payload": {
+                  "type": "ServiceParams",
+                  "required": true,
+                  "description": "Whatever `enqueue` was given — the caller declares its own shape.",
+                  "shapedBy": "payload"
+                },
+                "enqueuedAt": {
+                  "type": "number",
+                  "required": true
+                },
+                "priority": {
+                  "type": "number",
+                  "required": true
+                }
+              }
+            }
           }
         },
         {
@@ -3613,7 +3732,8 @@
               "name": "result",
               "type": "ServiceParams",
               "required": false,
-              "description": "Result payload to attach to the job."
+              "description": "Result payload to attach to the job — the caller declares its own shape (not necessarily the same shape as the job's `payload`).",
+              "shapedBy": "result"
             }
           ],
           "responseShape": {
@@ -3702,7 +3822,10 @@
             }
           ],
           "responseShape": {
-            "value": "ServiceParams"
+            "value": {
+              "type": "ServiceParams",
+              "shapedBy": "value"
+            }
           }
         },
         {
@@ -3719,7 +3842,8 @@
               "name": "value",
               "type": "ServiceParams",
               "required": true,
-              "description": "Value to store."
+              "description": "Value to store — the caller declares its own shape.",
+              "shapedBy": "value"
             },
             {
               "name": "ttl",
@@ -3846,7 +3970,8 @@
               "name": "message",
               "type": "ServiceParams",
               "required": true,
-              "description": "Message payload."
+              "description": "Message payload — the caller declares its own shape.",
+              "shapedBy": "message"
             }
           ],
           "responseShape": {
@@ -4184,9 +4309,12 @@
             },
             {
               "name": "attributes",
-              "type": "IntegrationParams",
+              "type": "object",
               "required": false,
-              "description": "Key-value attributes attached to the span."
+              "description": "Key-value attributes attached to the span (OTel attribute values are scalar).",
+              "mapValue": {
+                "type": "string | number | boolean"
+              }
             },
             {
               "name": "traceId",
@@ -4239,9 +4367,12 @@
             },
             {
               "name": "attributes",
-              "type": "IntegrationParams",
+              "type": "object",
               "required": false,
-              "description": "Key-value attributes attached to the event."
+              "description": "Key-value attributes attached to the event (OTel attribute values are scalar).",
+              "mapValue": {
+                "type": "string | number | boolean"
+              }
             }
           ],
           "responseShape": {
@@ -4272,9 +4403,12 @@
             },
             {
               "name": "labels",
-              "type": "IntegrationParams",
+              "type": "object",
               "required": false,
-              "description": "Key-value labels attached to the metric (replaces prior labels on the same name)."
+              "description": "Key-value labels attached to the metric (replaces prior labels on the same name; OTel label values are scalar).",
+              "mapValue": {
+                "type": "string | number | boolean"
+              }
             }
           ],
           "responseShape": {
@@ -4377,7 +4511,8 @@
               "name": "context",
               "type": "IntegrationParams",
               "required": false,
-              "description": "Extra context passed through to the agent."
+              "description": "Extra context passed through to the agent — the caller declares its own shape.",
+              "shapedBy": "context"
             }
           ],
           "responseShape": {