@almadar/core 10.57.0 → 10.59.0

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 (34) hide show
  1. package/dist/builders.d.ts +3 -3
  2. package/dist/builders.js +5 -2
  3. package/dist/builders.js.map +1 -1
  4. package/dist/{effect-D-_fm4No.d.ts → effect-CK9fn56C.d.ts} +40 -14
  5. package/dist/{entityAccess-kTNoti84.d.ts → entityAccess-pgfWacod.d.ts} +1 -1
  6. package/dist/factory/index.d.ts +4 -4
  7. package/dist/factory/index.js +2 -0
  8. package/dist/factory/index.js.map +1 -1
  9. package/dist/factory-runtime/index.d.ts +3 -3
  10. package/dist/factory-runtime/index.js +5 -2
  11. package/dist/factory-runtime/index.js.map +1 -1
  12. package/dist/index-DMUBu17o.d.ts +3178 -0
  13. package/dist/index.d.ts +11 -98
  14. package/dist/index.js +925 -67
  15. package/dist/index.js.map +1 -1
  16. package/dist/mock/index.d.ts +4 -4
  17. package/dist/mock/index.js +8 -2
  18. package/dist/mock/index.js.map +1 -1
  19. package/dist/patterns/component-mapping.json +1 -1
  20. package/dist/patterns/event-contracts.json +1 -1
  21. package/dist/patterns/index.d.ts +1860 -80
  22. package/dist/patterns/index.js +913 -64
  23. package/dist/patterns/index.js.map +1 -1
  24. package/dist/patterns/integrators-registry.json +42 -0
  25. package/dist/patterns/patterns-registry.json +869 -62
  26. package/dist/patterns/registry.json +869 -62
  27. package/dist/patterns/services-registry.json +141 -253
  28. package/dist/{schema-CrUFqWXN.d.ts → schema-CVTOy4at.d.ts} +506 -506
  29. package/dist/{trait-A4_OlY_l.d.ts → trait-BjPraUgs.d.ts} +2 -2
  30. package/dist/types/index.d.ts +8 -3095
  31. package/dist/types/index.js +10 -3
  32. package/dist/types/index.js.map +1 -1
  33. package/dist/{types-AHD31Gn-.d.ts → types-Dopw3s2O.d.ts} +3 -3
  34. package/package.json +1 -1
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": "1.0.0",
3
- "exportedAt": "2026-05-20T19:26:16.363Z",
3
+ "exportedAt": "2026-08-16T04:55:02.135Z",
4
4
  "services": {
5
5
  "llm": {
6
6
  "name": "llm",
@@ -138,39 +138,61 @@
138
138
  "summary": "string",
139
139
  "keyPoints": "string[]"
140
140
  }
141
+ }
142
+ ],
143
+ "credentials": [
144
+ {
145
+ "envVar": "ANTHROPIC_API_KEY",
146
+ "required": false,
147
+ "description": "Anthropic API key (use this OR OPENAI_API_KEY)"
141
148
  },
142
149
  {
143
- "name": "embed",
144
- "description": "Generate embeddings for an array of texts.",
150
+ "envVar": "OPENAI_API_KEY",
151
+ "required": false,
152
+ "description": "OpenAI API key (use this OR ANTHROPIC_API_KEY)"
153
+ }
154
+ ]
155
+ },
156
+ "ml": {
157
+ "name": "ml",
158
+ "description": "ML service — model inference on a trained or off-the-shelf model",
159
+ "category": "ai",
160
+ "package": "@almadar/llm",
161
+ "actions": [
162
+ {
163
+ "name": "infer",
164
+ "description": "Run inference against a deployed model checkpoint.",
145
165
  "params": [
146
166
  {
147
- "name": "texts",
148
- "type": "string[]",
167
+ "name": "model",
168
+ "type": "string",
149
169
  "required": true,
150
- "description": ""
170
+ "description": "`hf:<id>` for off-the-shelf weights, or a masar checkpoint id."
151
171
  },
152
172
  {
153
- "name": "model",
154
- "type": "string",
155
- "required": false,
156
- "description": ""
173
+ "name": "input",
174
+ "type": "ServiceParamsValue",
175
+ "required": true,
176
+ "description": "JSON-safe model input (tensor-shaped payload from `contract/entity-to-tensor`)."
157
177
  }
158
178
  ],
159
179
  "responseShape": {
160
- "embeddings": "number[][]"
180
+ "output": "ServiceParamsValue",
181
+ "confidence": "number",
182
+ "violations": "ServiceParamsValue[]"
161
183
  }
162
184
  }
163
185
  ],
164
186
  "credentials": [
165
187
  {
166
- "envVar": "ANTHROPIC_API_KEY",
167
- "required": false,
168
- "description": "Anthropic API key (use this OR OPENAI_API_KEY)"
188
+ "envVar": "MASAR_URL",
189
+ "required": true,
190
+ "description": "Base URL of the deployed model-serving orbital"
169
191
  },
170
192
  {
171
- "envVar": "OPENAI_API_KEY",
172
- "required": false,
173
- "description": "OpenAI API key (use this OR ANTHROPIC_API_KEY)"
193
+ "envVar": "MASAR_ML_TRAIT",
194
+ "required": true,
195
+ "description": "Kebab-case trait name the serving orbital exposes its /events route under"
174
196
  }
175
197
  ]
176
198
  },
@@ -410,240 +432,6 @@
410
432
  ],
411
433
  "credentials": []
412
434
  },
413
- "session": {
414
- "name": "session",
415
- "description": "Session management — create, get, list, clear agent sessions",
416
- "category": "ai",
417
- "package": "@almadar/agent",
418
- "actions": [
419
- {
420
- "name": "create",
421
- "description": "",
422
- "params": [
423
- {
424
- "name": "threadId",
425
- "type": "string",
426
- "required": true,
427
- "description": ""
428
- },
429
- {
430
- "name": "userId",
431
- "type": "string",
432
- "required": false,
433
- "description": ""
434
- }
435
- ],
436
- "responseShape": {
437
- "threadId": "string",
438
- "created": "boolean"
439
- }
440
- },
441
- {
442
- "name": "get",
443
- "description": "",
444
- "params": [
445
- {
446
- "name": "threadId",
447
- "type": "string",
448
- "required": true,
449
- "description": ""
450
- }
451
- ],
452
- "responseShape": {
453
- "session": "EventPayload | null"
454
- }
455
- },
456
- {
457
- "name": "list",
458
- "description": "",
459
- "params": [
460
- {
461
- "name": "userId",
462
- "type": "string",
463
- "required": false,
464
- "description": ""
465
- }
466
- ],
467
- "responseShape": {
468
- "sessions": "array"
469
- }
470
- },
471
- {
472
- "name": "clear",
473
- "description": "",
474
- "params": [
475
- {
476
- "name": "threadId",
477
- "type": "string",
478
- "required": true,
479
- "description": ""
480
- }
481
- ],
482
- "responseShape": {
483
- "cleared": "boolean"
484
- }
485
- }
486
- ],
487
- "credentials": []
488
- },
489
- "memory": {
490
- "name": "memory",
491
- "description": "Memory service — user preferences and generation history",
492
- "category": "ai",
493
- "package": "@almadar/agent",
494
- "actions": [
495
- {
496
- "name": "getUserPreferences",
497
- "description": "",
498
- "params": [
499
- {
500
- "name": "userId",
501
- "type": "string",
502
- "required": true,
503
- "description": ""
504
- }
505
- ],
506
- "responseShape": {
507
- "preferences": "EventPayload | null"
508
- }
509
- },
510
- {
511
- "name": "updateUserPreferences",
512
- "description": "",
513
- "params": [
514
- {
515
- "name": "userId",
516
- "type": "string",
517
- "required": true,
518
- "description": ""
519
- },
520
- {
521
- "name": "preferences",
522
- "type": "ServiceParams",
523
- "required": true,
524
- "description": ""
525
- }
526
- ],
527
- "responseShape": {
528
- "updated": "boolean"
529
- }
530
- },
531
- {
532
- "name": "recordGeneration",
533
- "description": "",
534
- "params": [
535
- {
536
- "name": "userId",
537
- "type": "string",
538
- "required": true,
539
- "description": ""
540
- },
541
- {
542
- "name": "prompt",
543
- "type": "string",
544
- "required": true,
545
- "description": ""
546
- },
547
- {
548
- "name": "result",
549
- "type": "string",
550
- "required": true,
551
- "description": ""
552
- },
553
- {
554
- "name": "skill",
555
- "type": "string",
556
- "required": false,
557
- "description": ""
558
- }
559
- ],
560
- "responseShape": {
561
- "sessionId": "string"
562
- }
563
- },
564
- {
565
- "name": "getGenerationHistory",
566
- "description": "",
567
- "params": [
568
- {
569
- "name": "userId",
570
- "type": "string",
571
- "required": true,
572
- "description": ""
573
- },
574
- {
575
- "name": "limit",
576
- "type": "number",
577
- "required": false,
578
- "description": ""
579
- }
580
- ],
581
- "responseShape": {
582
- "sessions": "array"
583
- }
584
- }
585
- ],
586
- "credentials": []
587
- },
588
- "agent": {
589
- "name": "agent",
590
- "description": "Agent service — send messages and manage generation",
591
- "category": "ai",
592
- "package": "@almadar/agent",
593
- "actions": [
594
- {
595
- "name": "sendMessage",
596
- "description": "",
597
- "params": [
598
- {
599
- "name": "message",
600
- "type": "string",
601
- "required": true,
602
- "description": ""
603
- },
604
- {
605
- "name": "threadId",
606
- "type": "string",
607
- "required": false,
608
- "description": ""
609
- },
610
- {
611
- "name": "skill",
612
- "type": "string",
613
- "required": false,
614
- "description": ""
615
- },
616
- {
617
- "name": "context",
618
- "type": "ServiceParams",
619
- "required": false,
620
- "description": ""
621
- }
622
- ],
623
- "responseShape": {
624
- "response": "string",
625
- "threadId": "string",
626
- "toolCalls": "readonly EventPayloadValue[]"
627
- }
628
- },
629
- {
630
- "name": "cancelGeneration",
631
- "description": "",
632
- "params": [
633
- {
634
- "name": "threadId",
635
- "type": "string",
636
- "required": true,
637
- "description": ""
638
- }
639
- ],
640
- "responseShape": {
641
- "cancelled": "boolean"
642
- }
643
- }
644
- ],
645
- "credentials": []
646
- },
647
435
  "migration": {
648
436
  "name": "migration",
649
437
  "description": "Migration service — import external data (notes, docs, references) into the system",
@@ -656,9 +444,21 @@
656
444
  "params": [
657
445
  {
658
446
  "name": "source",
659
- "type": "ServiceParams",
447
+ "type": "object",
660
448
  "required": true,
661
449
  "description": "ImportSource descriptor (kind + source-specific config)"
450
+ },
451
+ {
452
+ "name": "connectionRef",
453
+ "type": "string",
454
+ "required": false,
455
+ "description": "Host-side credential reference (a name, never the secret)"
456
+ },
457
+ {
458
+ "name": "files",
459
+ "type": "string[]",
460
+ "required": false,
461
+ "description": "Optional explicit file list to restrict the listing"
662
462
  }
663
463
  ],
664
464
  "responseShape": {
@@ -671,7 +471,7 @@
671
471
  "params": [
672
472
  {
673
473
  "name": "source",
674
- "type": "ServiceParams",
474
+ "type": "object",
675
475
  "required": true,
676
476
  "description": "ImportSource descriptor (kind + source-specific config)"
677
477
  },
@@ -680,6 +480,12 @@
680
480
  "type": "string",
681
481
  "required": true,
682
482
  "description": ""
483
+ },
484
+ {
485
+ "name": "connectionRef",
486
+ "type": "string",
487
+ "required": false,
488
+ "description": "Host-side credential reference (a name, never the secret)"
683
489
  }
684
490
  ],
685
491
  "responseShape": {
@@ -701,6 +507,12 @@
701
507
  "type": "array",
702
508
  "required": true,
703
509
  "description": "ImportUnit[] staged for commit"
510
+ },
511
+ {
512
+ "name": "connectionRef",
513
+ "type": "string",
514
+ "required": false,
515
+ "description": "Host-side credential reference (a name, never the secret)"
704
516
  }
705
517
  ],
706
518
  "responseShape": {
@@ -1334,6 +1146,27 @@
1334
1146
  "summary": "string",
1335
1147
  "keyPoints": "string[]"
1336
1148
  }
1149
+ },
1150
+ {
1151
+ "name": "embed",
1152
+ "description": "",
1153
+ "params": [
1154
+ {
1155
+ "name": "texts",
1156
+ "type": "string[]",
1157
+ "required": true,
1158
+ "description": ""
1159
+ },
1160
+ {
1161
+ "name": "model",
1162
+ "type": "string",
1163
+ "required": false,
1164
+ "description": ""
1165
+ }
1166
+ ],
1167
+ "responseShape": {
1168
+ "embeddings": "number[][]"
1169
+ }
1337
1170
  }
1338
1171
  ],
1339
1172
  "credentials": [
@@ -1552,6 +1385,61 @@
1552
1385
  }
1553
1386
  ]
1554
1387
  },
1388
+ "webhook": {
1389
+ "name": "webhook",
1390
+ "description": "Outbound webhook — signed HTTP POST notifications to external endpoints",
1391
+ "category": "messaging",
1392
+ "package": "@almadar/integrations",
1393
+ "actions": [
1394
+ {
1395
+ "name": "send",
1396
+ "description": "",
1397
+ "params": [
1398
+ {
1399
+ "name": "url",
1400
+ "type": "string",
1401
+ "required": true,
1402
+ "description": ""
1403
+ },
1404
+ {
1405
+ "name": "event",
1406
+ "type": "string",
1407
+ "required": true,
1408
+ "description": ""
1409
+ },
1410
+ {
1411
+ "name": "payload",
1412
+ "type": "object",
1413
+ "required": false,
1414
+ "description": ""
1415
+ },
1416
+ {
1417
+ "name": "secret",
1418
+ "type": "string",
1419
+ "required": false,
1420
+ "description": ""
1421
+ }
1422
+ ],
1423
+ "responseShape": {
1424
+ "status": "number",
1425
+ "ok": "boolean",
1426
+ "durationMs": "number"
1427
+ }
1428
+ }
1429
+ ],
1430
+ "credentials": [
1431
+ {
1432
+ "envVar": "WEBHOOK_SIGNING_SECRET",
1433
+ "required": false,
1434
+ "description": "Default HMAC-SHA256 signing secret (per-call secret overrides)"
1435
+ },
1436
+ {
1437
+ "envVar": "WEBHOOK_TIMEOUT_MS",
1438
+ "required": false,
1439
+ "description": "Per-request timeout (ms, default 10000)"
1440
+ }
1441
+ ]
1442
+ },
1555
1443
  "docker": {
1556
1444
  "name": "docker",
1557
1445
  "description": "Docker — container and image management",