@almadar/core 10.25.0 → 10.26.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.
@@ -0,0 +1,2645 @@
1
+ {
2
+ "version": "1.0.0",
3
+ "exportedAt": "2026-05-20T19:26:16.363Z",
4
+ "services": {
5
+ "llm": {
6
+ "name": "llm",
7
+ "description": "LLM service — text generation, classification, extraction, summarization",
8
+ "category": "ai",
9
+ "package": "@almadar/llm",
10
+ "actions": [
11
+ {
12
+ "name": "generate",
13
+ "description": "Generate text from a prompt.",
14
+ "params": [
15
+ {
16
+ "name": "systemPrompt",
17
+ "type": "string",
18
+ "required": false,
19
+ "description": ""
20
+ },
21
+ {
22
+ "name": "userPrompt",
23
+ "type": "string",
24
+ "required": true,
25
+ "description": ""
26
+ },
27
+ {
28
+ "name": "model",
29
+ "type": "string",
30
+ "required": false,
31
+ "description": ""
32
+ },
33
+ {
34
+ "name": "temperature",
35
+ "type": "number",
36
+ "required": false,
37
+ "description": ""
38
+ },
39
+ {
40
+ "name": "maxTokens",
41
+ "type": "number",
42
+ "required": false,
43
+ "description": ""
44
+ }
45
+ ],
46
+ "responseShape": {
47
+ "content": "string",
48
+ "usage": "object"
49
+ }
50
+ },
51
+ {
52
+ "name": "classify",
53
+ "description": "Classify text into one of the given categories.",
54
+ "params": [
55
+ {
56
+ "name": "text",
57
+ "type": "string",
58
+ "required": true,
59
+ "description": ""
60
+ },
61
+ {
62
+ "name": "categories",
63
+ "type": "string[]",
64
+ "required": true,
65
+ "description": ""
66
+ },
67
+ {
68
+ "name": "model",
69
+ "type": "string",
70
+ "required": false,
71
+ "description": ""
72
+ }
73
+ ],
74
+ "responseShape": {
75
+ "category": "string",
76
+ "confidence": "number",
77
+ "reasoning": "string"
78
+ }
79
+ },
80
+ {
81
+ "name": "extract",
82
+ "description": "Extract structured data from text according to a JSON schema.",
83
+ "params": [
84
+ {
85
+ "name": "text",
86
+ "type": "string",
87
+ "required": true,
88
+ "description": ""
89
+ },
90
+ {
91
+ "name": "schema",
92
+ "type": "JsonSchemaDefinition",
93
+ "required": true,
94
+ "description": ""
95
+ },
96
+ {
97
+ "name": "model",
98
+ "type": "string",
99
+ "required": false,
100
+ "description": ""
101
+ }
102
+ ],
103
+ "responseShape": {
104
+ "data": "ExtractedData",
105
+ "confidence": "number"
106
+ }
107
+ },
108
+ {
109
+ "name": "summarize",
110
+ "description": "Summarize text with optional length and style constraints.",
111
+ "params": [
112
+ {
113
+ "name": "text",
114
+ "type": "string",
115
+ "required": true,
116
+ "description": ""
117
+ },
118
+ {
119
+ "name": "maxLength",
120
+ "type": "number",
121
+ "required": false,
122
+ "description": ""
123
+ },
124
+ {
125
+ "name": "style",
126
+ "type": "string",
127
+ "required": false,
128
+ "description": ""
129
+ },
130
+ {
131
+ "name": "model",
132
+ "type": "string",
133
+ "required": false,
134
+ "description": ""
135
+ }
136
+ ],
137
+ "responseShape": {
138
+ "summary": "string",
139
+ "keyPoints": "string[]"
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)"
148
+ },
149
+ {
150
+ "envVar": "OPENAI_API_KEY",
151
+ "required": false,
152
+ "description": "OpenAI API key (use this OR ANTHROPIC_API_KEY)"
153
+ }
154
+ ]
155
+ },
156
+ "data": {
157
+ "name": "data",
158
+ "description": "Data service — CRUD operations on entities",
159
+ "category": "infrastructure",
160
+ "package": "@almadar/server",
161
+ "actions": [
162
+ {
163
+ "name": "list",
164
+ "description": "",
165
+ "params": [
166
+ {
167
+ "name": "collection",
168
+ "type": "string",
169
+ "required": true,
170
+ "description": ""
171
+ }
172
+ ],
173
+ "responseShape": {
174
+ "items": "EntityRow[]"
175
+ }
176
+ },
177
+ {
178
+ "name": "getById",
179
+ "description": "",
180
+ "params": [
181
+ {
182
+ "name": "collection",
183
+ "type": "string",
184
+ "required": true,
185
+ "description": ""
186
+ },
187
+ {
188
+ "name": "id",
189
+ "type": "string",
190
+ "required": true,
191
+ "description": ""
192
+ }
193
+ ],
194
+ "responseShape": {
195
+ "item": "EntityRow | null"
196
+ }
197
+ },
198
+ {
199
+ "name": "create",
200
+ "description": "",
201
+ "params": [
202
+ {
203
+ "name": "collection",
204
+ "type": "string",
205
+ "required": true,
206
+ "description": ""
207
+ },
208
+ {
209
+ "name": "data",
210
+ "type": "ServiceParams",
211
+ "required": true,
212
+ "description": ""
213
+ }
214
+ ],
215
+ "responseShape": {
216
+ "item": "EntityRow"
217
+ }
218
+ },
219
+ {
220
+ "name": "update",
221
+ "description": "",
222
+ "params": [
223
+ {
224
+ "name": "collection",
225
+ "type": "string",
226
+ "required": true,
227
+ "description": ""
228
+ },
229
+ {
230
+ "name": "id",
231
+ "type": "string",
232
+ "required": true,
233
+ "description": ""
234
+ },
235
+ {
236
+ "name": "data",
237
+ "type": "ServiceParams",
238
+ "required": true,
239
+ "description": ""
240
+ }
241
+ ],
242
+ "responseShape": {
243
+ "item": "EntityRow | null"
244
+ }
245
+ },
246
+ {
247
+ "name": "delete",
248
+ "description": "",
249
+ "params": [
250
+ {
251
+ "name": "collection",
252
+ "type": "string",
253
+ "required": true,
254
+ "description": ""
255
+ },
256
+ {
257
+ "name": "id",
258
+ "type": "string",
259
+ "required": true,
260
+ "description": ""
261
+ }
262
+ ],
263
+ "responseShape": {
264
+ "deleted": "boolean"
265
+ }
266
+ }
267
+ ],
268
+ "credentials": []
269
+ },
270
+ "eventbus": {
271
+ "name": "eventbus",
272
+ "description": "Event bus — cross-trait pub/sub messaging",
273
+ "category": "infrastructure",
274
+ "package": "@almadar/server",
275
+ "actions": [
276
+ {
277
+ "name": "emit",
278
+ "description": "",
279
+ "params": [
280
+ {
281
+ "name": "event",
282
+ "type": "string",
283
+ "required": true,
284
+ "description": ""
285
+ },
286
+ {
287
+ "name": "payload",
288
+ "type": "ServiceParams",
289
+ "required": false,
290
+ "description": ""
291
+ }
292
+ ],
293
+ "responseShape": {
294
+ "delivered": "number"
295
+ }
296
+ },
297
+ {
298
+ "name": "getListenerCounts",
299
+ "description": "",
300
+ "params": [],
301
+ "responseShape": {
302
+ "counts": "object"
303
+ }
304
+ }
305
+ ],
306
+ "credentials": []
307
+ },
308
+ "discovery": {
309
+ "name": "discovery",
310
+ "description": "Service discovery — register and find services",
311
+ "category": "infrastructure",
312
+ "package": "@almadar/server",
313
+ "actions": [
314
+ {
315
+ "name": "register",
316
+ "description": "",
317
+ "params": [
318
+ {
319
+ "name": "name",
320
+ "type": "string",
321
+ "required": true,
322
+ "description": ""
323
+ },
324
+ {
325
+ "name": "instanceId",
326
+ "type": "string",
327
+ "required": true,
328
+ "description": ""
329
+ },
330
+ {
331
+ "name": "host",
332
+ "type": "string",
333
+ "required": true,
334
+ "description": ""
335
+ },
336
+ {
337
+ "name": "port",
338
+ "type": "number",
339
+ "required": true,
340
+ "description": ""
341
+ },
342
+ {
343
+ "name": "emits",
344
+ "type": "string[]",
345
+ "required": true,
346
+ "description": ""
347
+ },
348
+ {
349
+ "name": "listens",
350
+ "type": "string[]",
351
+ "required": true,
352
+ "description": ""
353
+ }
354
+ ],
355
+ "responseShape": {
356
+ "registered": "boolean"
357
+ }
358
+ },
359
+ {
360
+ "name": "findListeners",
361
+ "description": "",
362
+ "params": [
363
+ {
364
+ "name": "event",
365
+ "type": "string",
366
+ "required": true,
367
+ "description": ""
368
+ }
369
+ ],
370
+ "responseShape": {
371
+ "services": "DiscoveredService[]"
372
+ }
373
+ },
374
+ {
375
+ "name": "findEmitters",
376
+ "description": "",
377
+ "params": [
378
+ {
379
+ "name": "event",
380
+ "type": "string",
381
+ "required": true,
382
+ "description": ""
383
+ }
384
+ ],
385
+ "responseShape": {
386
+ "services": "DiscoveredService[]"
387
+ }
388
+ }
389
+ ],
390
+ "credentials": []
391
+ },
392
+ "session": {
393
+ "name": "session",
394
+ "description": "Session management — create, get, list, clear agent sessions",
395
+ "category": "ai",
396
+ "package": "@almadar/agent",
397
+ "actions": [
398
+ {
399
+ "name": "create",
400
+ "description": "",
401
+ "params": [
402
+ {
403
+ "name": "threadId",
404
+ "type": "string",
405
+ "required": true,
406
+ "description": ""
407
+ },
408
+ {
409
+ "name": "userId",
410
+ "type": "string",
411
+ "required": false,
412
+ "description": ""
413
+ }
414
+ ],
415
+ "responseShape": {
416
+ "threadId": "string",
417
+ "created": "boolean"
418
+ }
419
+ },
420
+ {
421
+ "name": "get",
422
+ "description": "",
423
+ "params": [
424
+ {
425
+ "name": "threadId",
426
+ "type": "string",
427
+ "required": true,
428
+ "description": ""
429
+ }
430
+ ],
431
+ "responseShape": {
432
+ "session": "EventPayload | null"
433
+ }
434
+ },
435
+ {
436
+ "name": "list",
437
+ "description": "",
438
+ "params": [
439
+ {
440
+ "name": "userId",
441
+ "type": "string",
442
+ "required": false,
443
+ "description": ""
444
+ }
445
+ ],
446
+ "responseShape": {
447
+ "sessions": "array"
448
+ }
449
+ },
450
+ {
451
+ "name": "clear",
452
+ "description": "",
453
+ "params": [
454
+ {
455
+ "name": "threadId",
456
+ "type": "string",
457
+ "required": true,
458
+ "description": ""
459
+ }
460
+ ],
461
+ "responseShape": {
462
+ "cleared": "boolean"
463
+ }
464
+ }
465
+ ],
466
+ "credentials": []
467
+ },
468
+ "memory": {
469
+ "name": "memory",
470
+ "description": "Memory service — user preferences and generation history",
471
+ "category": "ai",
472
+ "package": "@almadar/agent",
473
+ "actions": [
474
+ {
475
+ "name": "getUserPreferences",
476
+ "description": "",
477
+ "params": [
478
+ {
479
+ "name": "userId",
480
+ "type": "string",
481
+ "required": true,
482
+ "description": ""
483
+ }
484
+ ],
485
+ "responseShape": {
486
+ "preferences": "EventPayload | null"
487
+ }
488
+ },
489
+ {
490
+ "name": "updateUserPreferences",
491
+ "description": "",
492
+ "params": [
493
+ {
494
+ "name": "userId",
495
+ "type": "string",
496
+ "required": true,
497
+ "description": ""
498
+ },
499
+ {
500
+ "name": "preferences",
501
+ "type": "ServiceParams",
502
+ "required": true,
503
+ "description": ""
504
+ }
505
+ ],
506
+ "responseShape": {
507
+ "updated": "boolean"
508
+ }
509
+ },
510
+ {
511
+ "name": "recordGeneration",
512
+ "description": "",
513
+ "params": [
514
+ {
515
+ "name": "userId",
516
+ "type": "string",
517
+ "required": true,
518
+ "description": ""
519
+ },
520
+ {
521
+ "name": "prompt",
522
+ "type": "string",
523
+ "required": true,
524
+ "description": ""
525
+ },
526
+ {
527
+ "name": "result",
528
+ "type": "string",
529
+ "required": true,
530
+ "description": ""
531
+ },
532
+ {
533
+ "name": "skill",
534
+ "type": "string",
535
+ "required": false,
536
+ "description": ""
537
+ }
538
+ ],
539
+ "responseShape": {
540
+ "sessionId": "string"
541
+ }
542
+ },
543
+ {
544
+ "name": "getGenerationHistory",
545
+ "description": "",
546
+ "params": [
547
+ {
548
+ "name": "userId",
549
+ "type": "string",
550
+ "required": true,
551
+ "description": ""
552
+ },
553
+ {
554
+ "name": "limit",
555
+ "type": "number",
556
+ "required": false,
557
+ "description": ""
558
+ }
559
+ ],
560
+ "responseShape": {
561
+ "sessions": "array"
562
+ }
563
+ }
564
+ ],
565
+ "credentials": []
566
+ },
567
+ "agent": {
568
+ "name": "agent",
569
+ "description": "Agent service — send messages and manage generation",
570
+ "category": "ai",
571
+ "package": "@almadar/agent",
572
+ "actions": [
573
+ {
574
+ "name": "sendMessage",
575
+ "description": "",
576
+ "params": [
577
+ {
578
+ "name": "message",
579
+ "type": "string",
580
+ "required": true,
581
+ "description": ""
582
+ },
583
+ {
584
+ "name": "threadId",
585
+ "type": "string",
586
+ "required": false,
587
+ "description": ""
588
+ },
589
+ {
590
+ "name": "skill",
591
+ "type": "string",
592
+ "required": false,
593
+ "description": ""
594
+ },
595
+ {
596
+ "name": "context",
597
+ "type": "ServiceParams",
598
+ "required": false,
599
+ "description": ""
600
+ }
601
+ ],
602
+ "responseShape": {
603
+ "response": "string",
604
+ "threadId": "string",
605
+ "toolCalls": "readonly EventPayloadValue[]"
606
+ }
607
+ },
608
+ {
609
+ "name": "cancelGeneration",
610
+ "description": "",
611
+ "params": [
612
+ {
613
+ "name": "threadId",
614
+ "type": "string",
615
+ "required": true,
616
+ "description": ""
617
+ }
618
+ ],
619
+ "responseShape": {
620
+ "cancelled": "boolean"
621
+ }
622
+ }
623
+ ],
624
+ "credentials": []
625
+ },
626
+ "skills": {
627
+ "name": "skills",
628
+ "description": "Skills service — AI-powered schema generation",
629
+ "category": "ai",
630
+ "package": "@almadar/skills",
631
+ "actions": [
632
+ {
633
+ "name": "generateOrbitals",
634
+ "description": "Generate Orbital schemas from a natural-language prompt.",
635
+ "params": [
636
+ {
637
+ "name": "prompt",
638
+ "type": "string",
639
+ "required": true,
640
+ "description": ""
641
+ },
642
+ {
643
+ "name": "compact",
644
+ "type": "boolean",
645
+ "required": false,
646
+ "description": ""
647
+ }
648
+ ],
649
+ "responseShape": {
650
+ "skill": "object"
651
+ }
652
+ },
653
+ {
654
+ "name": "generateFix",
655
+ "description": "Generate a fix for an existing schema given validation errors.",
656
+ "params": [
657
+ {
658
+ "name": "schema",
659
+ "type": "string",
660
+ "required": true,
661
+ "description": ""
662
+ },
663
+ {
664
+ "name": "errors",
665
+ "type": "string[]",
666
+ "required": true,
667
+ "description": ""
668
+ }
669
+ ],
670
+ "responseShape": {
671
+ "skill": "object"
672
+ }
673
+ },
674
+ {
675
+ "name": "generateDomainLanguage",
676
+ "description": "Generate a domain language definition from a description.",
677
+ "params": [
678
+ {
679
+ "name": "description",
680
+ "type": "string",
681
+ "required": true,
682
+ "description": ""
683
+ }
684
+ ],
685
+ "responseShape": {
686
+ "skill": "object"
687
+ }
688
+ },
689
+ {
690
+ "name": "generateAll",
691
+ "description": "Generate all available skills.",
692
+ "params": [],
693
+ "responseShape": {
694
+ "skills": "array"
695
+ }
696
+ }
697
+ ],
698
+ "credentials": []
699
+ },
700
+ "github": {
701
+ "name": "github",
702
+ "description": "GitHub integration — repos, issues, PRs",
703
+ "category": "devtools",
704
+ "package": "@almadar/integrations",
705
+ "actions": [
706
+ {
707
+ "name": "cloneRepo",
708
+ "description": "",
709
+ "params": [
710
+ {
711
+ "name": "repoUrl",
712
+ "type": "string",
713
+ "required": true,
714
+ "description": ""
715
+ },
716
+ {
717
+ "name": "targetDir",
718
+ "type": "string",
719
+ "required": true,
720
+ "description": ""
721
+ },
722
+ {
723
+ "name": "branch",
724
+ "type": "string",
725
+ "required": false,
726
+ "description": ""
727
+ }
728
+ ],
729
+ "responseShape": {
730
+ "message": "string"
731
+ }
732
+ },
733
+ {
734
+ "name": "createBranch",
735
+ "description": "",
736
+ "params": [
737
+ {
738
+ "name": "branchName",
739
+ "type": "string",
740
+ "required": true,
741
+ "description": ""
742
+ },
743
+ {
744
+ "name": "baseBranch",
745
+ "type": "string",
746
+ "required": false,
747
+ "description": ""
748
+ }
749
+ ],
750
+ "responseShape": {
751
+ "message": "string"
752
+ }
753
+ },
754
+ {
755
+ "name": "commit",
756
+ "description": "",
757
+ "params": [
758
+ {
759
+ "name": "message",
760
+ "type": "string",
761
+ "required": true,
762
+ "description": ""
763
+ },
764
+ {
765
+ "name": "files",
766
+ "type": "string[]",
767
+ "required": false,
768
+ "description": ""
769
+ }
770
+ ],
771
+ "responseShape": {
772
+ "message": "string"
773
+ }
774
+ },
775
+ {
776
+ "name": "push",
777
+ "description": "",
778
+ "params": [
779
+ {
780
+ "name": "branchName",
781
+ "type": "string",
782
+ "required": true,
783
+ "description": ""
784
+ },
785
+ {
786
+ "name": "force",
787
+ "type": "boolean",
788
+ "required": false,
789
+ "description": ""
790
+ }
791
+ ],
792
+ "responseShape": {
793
+ "message": "string"
794
+ }
795
+ },
796
+ {
797
+ "name": "createPR",
798
+ "description": "",
799
+ "params": [
800
+ {
801
+ "name": "title",
802
+ "type": "string",
803
+ "required": true,
804
+ "description": ""
805
+ },
806
+ {
807
+ "name": "body",
808
+ "type": "string",
809
+ "required": true,
810
+ "description": ""
811
+ },
812
+ {
813
+ "name": "head",
814
+ "type": "string",
815
+ "required": true,
816
+ "description": ""
817
+ },
818
+ {
819
+ "name": "base",
820
+ "type": "string",
821
+ "required": true,
822
+ "description": ""
823
+ }
824
+ ],
825
+ "responseShape": {
826
+ "number": "number",
827
+ "url": "string",
828
+ "title": "string"
829
+ }
830
+ },
831
+ {
832
+ "name": "getPRComments",
833
+ "description": "",
834
+ "params": [
835
+ {
836
+ "name": "prNumber",
837
+ "type": "number",
838
+ "required": true,
839
+ "description": ""
840
+ }
841
+ ],
842
+ "responseShape": {
843
+ "comments": "array"
844
+ }
845
+ },
846
+ {
847
+ "name": "listIssues",
848
+ "description": "",
849
+ "params": [
850
+ {
851
+ "name": "state",
852
+ "type": "string",
853
+ "required": false,
854
+ "description": ""
855
+ },
856
+ {
857
+ "name": "labels",
858
+ "type": "string[]",
859
+ "required": false,
860
+ "description": ""
861
+ },
862
+ {
863
+ "name": "per_page",
864
+ "type": "number",
865
+ "required": false,
866
+ "description": ""
867
+ }
868
+ ],
869
+ "responseShape": {
870
+ "issues": "array"
871
+ }
872
+ },
873
+ {
874
+ "name": "getIssue",
875
+ "description": "",
876
+ "params": [
877
+ {
878
+ "name": "issueNumber",
879
+ "type": "number",
880
+ "required": true,
881
+ "description": ""
882
+ }
883
+ ],
884
+ "responseShape": {
885
+ "number": "number",
886
+ "title": "string",
887
+ "body": "string",
888
+ "state": "string"
889
+ }
890
+ },
891
+ {
892
+ "name": "getFile",
893
+ "description": "",
894
+ "params": [
895
+ {
896
+ "name": "owner",
897
+ "type": "string",
898
+ "required": true,
899
+ "description": ""
900
+ },
901
+ {
902
+ "name": "repo",
903
+ "type": "string",
904
+ "required": true,
905
+ "description": ""
906
+ },
907
+ {
908
+ "name": "path",
909
+ "type": "string",
910
+ "required": true,
911
+ "description": ""
912
+ },
913
+ {
914
+ "name": "ref",
915
+ "type": "string",
916
+ "required": false,
917
+ "description": ""
918
+ }
919
+ ],
920
+ "responseShape": {
921
+ "path": "string",
922
+ "content": "string",
923
+ "sha": "string",
924
+ "size": "number"
925
+ }
926
+ },
927
+ {
928
+ "name": "listCommits",
929
+ "description": "",
930
+ "params": [
931
+ {
932
+ "name": "owner",
933
+ "type": "string",
934
+ "required": true,
935
+ "description": ""
936
+ },
937
+ {
938
+ "name": "repo",
939
+ "type": "string",
940
+ "required": true,
941
+ "description": ""
942
+ },
943
+ {
944
+ "name": "path",
945
+ "type": "string",
946
+ "required": false,
947
+ "description": ""
948
+ },
949
+ {
950
+ "name": "ref",
951
+ "type": "string",
952
+ "required": false,
953
+ "description": ""
954
+ },
955
+ {
956
+ "name": "per_page",
957
+ "type": "number",
958
+ "required": false,
959
+ "description": ""
960
+ }
961
+ ],
962
+ "responseShape": {
963
+ "commits": "array"
964
+ }
965
+ },
966
+ {
967
+ "name": "createIssue",
968
+ "description": "",
969
+ "params": [
970
+ {
971
+ "name": "owner",
972
+ "type": "string",
973
+ "required": true,
974
+ "description": ""
975
+ },
976
+ {
977
+ "name": "repo",
978
+ "type": "string",
979
+ "required": true,
980
+ "description": ""
981
+ },
982
+ {
983
+ "name": "title",
984
+ "type": "string",
985
+ "required": true,
986
+ "description": ""
987
+ },
988
+ {
989
+ "name": "body",
990
+ "type": "string",
991
+ "required": false,
992
+ "description": ""
993
+ },
994
+ {
995
+ "name": "labels",
996
+ "type": "string[]",
997
+ "required": false,
998
+ "description": ""
999
+ }
1000
+ ],
1001
+ "responseShape": {
1002
+ "number": "number",
1003
+ "title": "string",
1004
+ "url": "string"
1005
+ }
1006
+ }
1007
+ ],
1008
+ "credentials": [
1009
+ {
1010
+ "envVar": "GITHUB_TOKEN",
1011
+ "required": true,
1012
+ "description": "GitHub personal access token"
1013
+ },
1014
+ {
1015
+ "envVar": "GITHUB_OWNER",
1016
+ "required": false,
1017
+ "description": "Default repository owner"
1018
+ },
1019
+ {
1020
+ "envVar": "GITHUB_REPO",
1021
+ "required": false,
1022
+ "description": "Default repository name"
1023
+ }
1024
+ ]
1025
+ },
1026
+ "stripe": {
1027
+ "name": "stripe",
1028
+ "description": "Stripe integration — payments, subscriptions, invoices",
1029
+ "category": "payment",
1030
+ "package": "@almadar/integrations",
1031
+ "actions": [
1032
+ {
1033
+ "name": "createPaymentIntent",
1034
+ "description": "",
1035
+ "params": [
1036
+ {
1037
+ "name": "amount",
1038
+ "type": "number",
1039
+ "required": true,
1040
+ "description": ""
1041
+ },
1042
+ {
1043
+ "name": "currency",
1044
+ "type": "string",
1045
+ "required": true,
1046
+ "description": ""
1047
+ },
1048
+ {
1049
+ "name": "metadata",
1050
+ "type": "object",
1051
+ "required": false,
1052
+ "description": ""
1053
+ }
1054
+ ],
1055
+ "responseShape": {
1056
+ "id": "string",
1057
+ "clientSecret": "string",
1058
+ "status": "string",
1059
+ "amount": "number",
1060
+ "currency": "string"
1061
+ }
1062
+ },
1063
+ {
1064
+ "name": "confirmPayment",
1065
+ "description": "",
1066
+ "params": [
1067
+ {
1068
+ "name": "paymentIntentId",
1069
+ "type": "string",
1070
+ "required": true,
1071
+ "description": ""
1072
+ }
1073
+ ],
1074
+ "responseShape": {
1075
+ "id": "string",
1076
+ "status": "string"
1077
+ }
1078
+ },
1079
+ {
1080
+ "name": "refund",
1081
+ "description": "",
1082
+ "params": [
1083
+ {
1084
+ "name": "paymentIntentId",
1085
+ "type": "string",
1086
+ "required": true,
1087
+ "description": ""
1088
+ },
1089
+ {
1090
+ "name": "amount",
1091
+ "type": "number",
1092
+ "required": false,
1093
+ "description": ""
1094
+ }
1095
+ ],
1096
+ "responseShape": {
1097
+ "id": "string",
1098
+ "status": "string",
1099
+ "amount": "number"
1100
+ }
1101
+ }
1102
+ ],
1103
+ "credentials": [
1104
+ {
1105
+ "envVar": "STRIPE_SECRET_KEY",
1106
+ "required": true,
1107
+ "description": "Stripe secret API key"
1108
+ },
1109
+ {
1110
+ "envVar": "STRIPE_WEBHOOK_SECRET",
1111
+ "required": false,
1112
+ "description": "Webhook endpoint signing secret"
1113
+ }
1114
+ ]
1115
+ },
1116
+ "llm-integration": {
1117
+ "name": "llm-integration",
1118
+ "description": "LLM integration — generate, embed, classify via external providers",
1119
+ "category": "ai",
1120
+ "package": "@almadar/integrations",
1121
+ "actions": [
1122
+ {
1123
+ "name": "generate",
1124
+ "description": "",
1125
+ "params": [
1126
+ {
1127
+ "name": "userPrompt",
1128
+ "type": "string",
1129
+ "required": true,
1130
+ "description": ""
1131
+ },
1132
+ {
1133
+ "name": "systemPrompt",
1134
+ "type": "string",
1135
+ "required": false,
1136
+ "description": ""
1137
+ },
1138
+ {
1139
+ "name": "model",
1140
+ "type": "string",
1141
+ "required": false,
1142
+ "description": ""
1143
+ },
1144
+ {
1145
+ "name": "temperature",
1146
+ "type": "number",
1147
+ "required": false,
1148
+ "description": ""
1149
+ },
1150
+ {
1151
+ "name": "maxTokens",
1152
+ "type": "number",
1153
+ "required": false,
1154
+ "description": ""
1155
+ }
1156
+ ],
1157
+ "responseShape": {
1158
+ "content": "string",
1159
+ "usage": "object"
1160
+ }
1161
+ },
1162
+ {
1163
+ "name": "classify",
1164
+ "description": "",
1165
+ "params": [
1166
+ {
1167
+ "name": "text",
1168
+ "type": "string",
1169
+ "required": true,
1170
+ "description": ""
1171
+ },
1172
+ {
1173
+ "name": "categories",
1174
+ "type": "string[]",
1175
+ "required": true,
1176
+ "description": ""
1177
+ },
1178
+ {
1179
+ "name": "model",
1180
+ "type": "string",
1181
+ "required": false,
1182
+ "description": ""
1183
+ }
1184
+ ],
1185
+ "responseShape": {
1186
+ "category": "string",
1187
+ "confidence": "number",
1188
+ "reasoning": "string"
1189
+ }
1190
+ },
1191
+ {
1192
+ "name": "extract",
1193
+ "description": "",
1194
+ "params": [
1195
+ {
1196
+ "name": "text",
1197
+ "type": "string",
1198
+ "required": true,
1199
+ "description": ""
1200
+ },
1201
+ {
1202
+ "name": "schema",
1203
+ "type": "IntegrationParams",
1204
+ "required": true,
1205
+ "description": ""
1206
+ },
1207
+ {
1208
+ "name": "model",
1209
+ "type": "string",
1210
+ "required": false,
1211
+ "description": ""
1212
+ }
1213
+ ],
1214
+ "responseShape": {}
1215
+ },
1216
+ {
1217
+ "name": "summarize",
1218
+ "description": "",
1219
+ "params": [
1220
+ {
1221
+ "name": "text",
1222
+ "type": "string",
1223
+ "required": true,
1224
+ "description": ""
1225
+ },
1226
+ {
1227
+ "name": "maxLength",
1228
+ "type": "number",
1229
+ "required": false,
1230
+ "description": ""
1231
+ },
1232
+ {
1233
+ "name": "style",
1234
+ "type": "string",
1235
+ "required": false,
1236
+ "description": ""
1237
+ },
1238
+ {
1239
+ "name": "model",
1240
+ "type": "string",
1241
+ "required": false,
1242
+ "description": ""
1243
+ }
1244
+ ],
1245
+ "responseShape": {
1246
+ "summary": "string",
1247
+ "keyPoints": "string[]"
1248
+ }
1249
+ }
1250
+ ],
1251
+ "credentials": [
1252
+ {
1253
+ "envVar": "ANTHROPIC_API_KEY",
1254
+ "required": false,
1255
+ "description": "Anthropic API key"
1256
+ },
1257
+ {
1258
+ "envVar": "OPENAI_API_KEY",
1259
+ "required": false,
1260
+ "description": "OpenAI API key"
1261
+ }
1262
+ ]
1263
+ },
1264
+ "youtube": {
1265
+ "name": "youtube",
1266
+ "description": "YouTube Data API — search videos, get video/channel details",
1267
+ "category": "media",
1268
+ "package": "@almadar/integrations",
1269
+ "actions": [
1270
+ {
1271
+ "name": "search",
1272
+ "description": "",
1273
+ "params": [
1274
+ {
1275
+ "name": "query",
1276
+ "type": "string",
1277
+ "required": true,
1278
+ "description": ""
1279
+ },
1280
+ {
1281
+ "name": "maxResults",
1282
+ "type": "number",
1283
+ "required": false,
1284
+ "description": ""
1285
+ },
1286
+ {
1287
+ "name": "type",
1288
+ "type": "string",
1289
+ "required": false,
1290
+ "description": ""
1291
+ }
1292
+ ],
1293
+ "responseShape": {}
1294
+ },
1295
+ {
1296
+ "name": "getVideo",
1297
+ "description": "",
1298
+ "params": [
1299
+ {
1300
+ "name": "videoId",
1301
+ "type": "string",
1302
+ "required": true,
1303
+ "description": ""
1304
+ }
1305
+ ],
1306
+ "responseShape": {
1307
+ "title": "string",
1308
+ "description": "string",
1309
+ "viewCount": "string",
1310
+ "likeCount": "string"
1311
+ }
1312
+ },
1313
+ {
1314
+ "name": "getChannel",
1315
+ "description": "",
1316
+ "params": [
1317
+ {
1318
+ "name": "channelId",
1319
+ "type": "string",
1320
+ "required": true,
1321
+ "description": ""
1322
+ }
1323
+ ],
1324
+ "responseShape": {
1325
+ "name": "string",
1326
+ "description": "string",
1327
+ "subscriberCount": "string"
1328
+ }
1329
+ }
1330
+ ],
1331
+ "credentials": [
1332
+ {
1333
+ "envVar": "YOUTUBE_API_KEY",
1334
+ "required": true,
1335
+ "description": "YouTube Data API key"
1336
+ }
1337
+ ]
1338
+ },
1339
+ "twilio": {
1340
+ "name": "twilio",
1341
+ "description": "Twilio — SMS, voice calls, verification",
1342
+ "category": "messaging",
1343
+ "package": "@almadar/integrations",
1344
+ "actions": [
1345
+ {
1346
+ "name": "sendSMS",
1347
+ "description": "",
1348
+ "params": [
1349
+ {
1350
+ "name": "to",
1351
+ "type": "string",
1352
+ "required": true,
1353
+ "description": ""
1354
+ },
1355
+ {
1356
+ "name": "body",
1357
+ "type": "string",
1358
+ "required": true,
1359
+ "description": ""
1360
+ }
1361
+ ],
1362
+ "responseShape": {
1363
+ "sid": "string",
1364
+ "status": "string"
1365
+ }
1366
+ },
1367
+ {
1368
+ "name": "sendWhatsApp",
1369
+ "description": "",
1370
+ "params": [
1371
+ {
1372
+ "name": "to",
1373
+ "type": "string",
1374
+ "required": true,
1375
+ "description": ""
1376
+ },
1377
+ {
1378
+ "name": "body",
1379
+ "type": "string",
1380
+ "required": true,
1381
+ "description": ""
1382
+ }
1383
+ ],
1384
+ "responseShape": {
1385
+ "sid": "string",
1386
+ "status": "string"
1387
+ }
1388
+ }
1389
+ ],
1390
+ "credentials": [
1391
+ {
1392
+ "envVar": "TWILIO_ACCOUNT_SID",
1393
+ "required": true,
1394
+ "description": "Twilio account SID"
1395
+ },
1396
+ {
1397
+ "envVar": "TWILIO_AUTH_TOKEN",
1398
+ "required": true,
1399
+ "description": "Twilio auth token"
1400
+ },
1401
+ {
1402
+ "envVar": "TWILIO_PHONE_NUMBER",
1403
+ "required": false,
1404
+ "description": "Default sender phone number"
1405
+ }
1406
+ ]
1407
+ },
1408
+ "email": {
1409
+ "name": "email",
1410
+ "description": "Email service — send, send with template",
1411
+ "category": "messaging",
1412
+ "package": "@almadar/integrations",
1413
+ "actions": [
1414
+ {
1415
+ "name": "send",
1416
+ "description": "",
1417
+ "params": [
1418
+ {
1419
+ "name": "to",
1420
+ "type": "string",
1421
+ "required": true,
1422
+ "description": ""
1423
+ },
1424
+ {
1425
+ "name": "subject",
1426
+ "type": "string",
1427
+ "required": true,
1428
+ "description": ""
1429
+ },
1430
+ {
1431
+ "name": "body",
1432
+ "type": "string",
1433
+ "required": true,
1434
+ "description": ""
1435
+ },
1436
+ {
1437
+ "name": "from",
1438
+ "type": "string",
1439
+ "required": false,
1440
+ "description": ""
1441
+ }
1442
+ ],
1443
+ "responseShape": {
1444
+ "id": "string",
1445
+ "status": "string"
1446
+ }
1447
+ }
1448
+ ],
1449
+ "credentials": [
1450
+ {
1451
+ "envVar": "SENDGRID_API_KEY",
1452
+ "required": false,
1453
+ "description": "SendGrid API key (use this OR RESEND_API_KEY)"
1454
+ },
1455
+ {
1456
+ "envVar": "RESEND_API_KEY",
1457
+ "required": false,
1458
+ "description": "Resend API key (use this OR SENDGRID_API_KEY)"
1459
+ },
1460
+ {
1461
+ "envVar": "FROM_EMAIL",
1462
+ "required": false,
1463
+ "description": "Default sender email address"
1464
+ }
1465
+ ]
1466
+ },
1467
+ "docker": {
1468
+ "name": "docker",
1469
+ "description": "Docker — container and image management",
1470
+ "category": "devtools",
1471
+ "package": "@almadar/integrations",
1472
+ "actions": [
1473
+ {
1474
+ "name": "build",
1475
+ "description": "",
1476
+ "params": [
1477
+ {
1478
+ "name": "tag",
1479
+ "type": "string",
1480
+ "required": true,
1481
+ "description": ""
1482
+ },
1483
+ {
1484
+ "name": "dockerfile",
1485
+ "type": "string",
1486
+ "required": false,
1487
+ "description": ""
1488
+ },
1489
+ {
1490
+ "name": "context",
1491
+ "type": "string",
1492
+ "required": false,
1493
+ "description": ""
1494
+ },
1495
+ {
1496
+ "name": "buildArgs",
1497
+ "type": "object",
1498
+ "required": false,
1499
+ "description": ""
1500
+ }
1501
+ ],
1502
+ "responseShape": {
1503
+ "imageId": "string",
1504
+ "tag": "string",
1505
+ "size": "number",
1506
+ "buildTime": "number"
1507
+ }
1508
+ },
1509
+ {
1510
+ "name": "run",
1511
+ "description": "",
1512
+ "params": [
1513
+ {
1514
+ "name": "image",
1515
+ "type": "string",
1516
+ "required": true,
1517
+ "description": ""
1518
+ },
1519
+ {
1520
+ "name": "name",
1521
+ "type": "string",
1522
+ "required": false,
1523
+ "description": ""
1524
+ },
1525
+ {
1526
+ "name": "ports",
1527
+ "type": "array",
1528
+ "required": false,
1529
+ "description": ""
1530
+ },
1531
+ {
1532
+ "name": "env",
1533
+ "type": "object",
1534
+ "required": false,
1535
+ "description": ""
1536
+ },
1537
+ {
1538
+ "name": "volumes",
1539
+ "type": "array",
1540
+ "required": false,
1541
+ "description": ""
1542
+ },
1543
+ {
1544
+ "name": "command",
1545
+ "type": "string",
1546
+ "required": false,
1547
+ "description": ""
1548
+ }
1549
+ ],
1550
+ "responseShape": {
1551
+ "containerId": "string",
1552
+ "name": "string",
1553
+ "status": "string",
1554
+ "ports": "array"
1555
+ }
1556
+ },
1557
+ {
1558
+ "name": "stop",
1559
+ "description": "",
1560
+ "params": [
1561
+ {
1562
+ "name": "containerId",
1563
+ "type": "string",
1564
+ "required": true,
1565
+ "description": ""
1566
+ }
1567
+ ],
1568
+ "responseShape": {
1569
+ "containerId": "string",
1570
+ "status": "string",
1571
+ "stoppedAt": "number"
1572
+ }
1573
+ },
1574
+ {
1575
+ "name": "remove",
1576
+ "description": "",
1577
+ "params": [
1578
+ {
1579
+ "name": "containerId",
1580
+ "type": "string",
1581
+ "required": true,
1582
+ "description": ""
1583
+ },
1584
+ {
1585
+ "name": "force",
1586
+ "type": "boolean",
1587
+ "required": false,
1588
+ "description": ""
1589
+ }
1590
+ ],
1591
+ "responseShape": {
1592
+ "containerId": "string",
1593
+ "removed": "boolean"
1594
+ }
1595
+ },
1596
+ {
1597
+ "name": "logs",
1598
+ "description": "",
1599
+ "params": [
1600
+ {
1601
+ "name": "containerId",
1602
+ "type": "string",
1603
+ "required": true,
1604
+ "description": ""
1605
+ },
1606
+ {
1607
+ "name": "tail",
1608
+ "type": "number",
1609
+ "required": false,
1610
+ "description": ""
1611
+ },
1612
+ {
1613
+ "name": "since",
1614
+ "type": "string",
1615
+ "required": false,
1616
+ "description": ""
1617
+ }
1618
+ ],
1619
+ "responseShape": {
1620
+ "containerId": "string",
1621
+ "logs": "string[]",
1622
+ "lineCount": "number"
1623
+ }
1624
+ },
1625
+ {
1626
+ "name": "status",
1627
+ "description": "",
1628
+ "params": [
1629
+ {
1630
+ "name": "containerId",
1631
+ "type": "string",
1632
+ "required": true,
1633
+ "description": ""
1634
+ }
1635
+ ],
1636
+ "responseShape": {
1637
+ "containerId": "string",
1638
+ "name": "string",
1639
+ "image": "string",
1640
+ "status": "string",
1641
+ "ports": "array",
1642
+ "createdAt": "number",
1643
+ "startedAt": "number | null",
1644
+ "stoppedAt": "number | null"
1645
+ }
1646
+ },
1647
+ {
1648
+ "name": "list",
1649
+ "description": "",
1650
+ "params": [
1651
+ {
1652
+ "name": "all",
1653
+ "type": "boolean",
1654
+ "required": false,
1655
+ "description": ""
1656
+ },
1657
+ {
1658
+ "name": "filterByLabel",
1659
+ "type": "string",
1660
+ "required": false,
1661
+ "description": ""
1662
+ }
1663
+ ],
1664
+ "responseShape": {
1665
+ "containers": "array",
1666
+ "total": "number"
1667
+ }
1668
+ }
1669
+ ],
1670
+ "credentials": [
1671
+ {
1672
+ "envVar": "DOCKER_HOST",
1673
+ "required": false,
1674
+ "description": "Docker daemon host URL"
1675
+ }
1676
+ ]
1677
+ },
1678
+ "storage": {
1679
+ "name": "storage",
1680
+ "description": "Object storage — upload, download, delete, list files",
1681
+ "category": "infrastructure",
1682
+ "package": "@almadar/integrations",
1683
+ "actions": [
1684
+ {
1685
+ "name": "upload",
1686
+ "description": "",
1687
+ "params": [
1688
+ {
1689
+ "name": "bucket",
1690
+ "type": "string",
1691
+ "required": true,
1692
+ "description": ""
1693
+ },
1694
+ {
1695
+ "name": "key",
1696
+ "type": "string",
1697
+ "required": false,
1698
+ "description": ""
1699
+ },
1700
+ {
1701
+ "name": "content",
1702
+ "type": "string",
1703
+ "required": false,
1704
+ "description": ""
1705
+ },
1706
+ {
1707
+ "name": "contentType",
1708
+ "type": "string",
1709
+ "required": false,
1710
+ "description": ""
1711
+ },
1712
+ {
1713
+ "name": "file",
1714
+ "type": "IntegrationParams",
1715
+ "required": false,
1716
+ "description": ""
1717
+ },
1718
+ {
1719
+ "name": "acl",
1720
+ "type": "'public' | 'private'",
1721
+ "required": false,
1722
+ "description": ""
1723
+ },
1724
+ {
1725
+ "name": "maxSize",
1726
+ "type": "number",
1727
+ "required": false,
1728
+ "description": ""
1729
+ },
1730
+ {
1731
+ "name": "metadata",
1732
+ "type": "IntegrationParams",
1733
+ "required": false,
1734
+ "description": ""
1735
+ }
1736
+ ],
1737
+ "responseShape": {
1738
+ "key": "string",
1739
+ "bucket": "string",
1740
+ "size": "number",
1741
+ "etag": "string"
1742
+ }
1743
+ },
1744
+ {
1745
+ "name": "download",
1746
+ "description": "",
1747
+ "params": [
1748
+ {
1749
+ "name": "bucket",
1750
+ "type": "string",
1751
+ "required": true,
1752
+ "description": ""
1753
+ },
1754
+ {
1755
+ "name": "key",
1756
+ "type": "string",
1757
+ "required": true,
1758
+ "description": ""
1759
+ }
1760
+ ],
1761
+ "responseShape": {
1762
+ "content": "string",
1763
+ "contentType": "string",
1764
+ "size": "number",
1765
+ "metadata": "IntegrationParams"
1766
+ }
1767
+ },
1768
+ {
1769
+ "name": "list",
1770
+ "description": "",
1771
+ "params": [
1772
+ {
1773
+ "name": "bucket",
1774
+ "type": "string",
1775
+ "required": true,
1776
+ "description": ""
1777
+ },
1778
+ {
1779
+ "name": "prefix",
1780
+ "type": "string",
1781
+ "required": false,
1782
+ "description": ""
1783
+ },
1784
+ {
1785
+ "name": "maxKeys",
1786
+ "type": "number",
1787
+ "required": false,
1788
+ "description": ""
1789
+ }
1790
+ ],
1791
+ "responseShape": {
1792
+ "keys": "array",
1793
+ "truncated": "boolean"
1794
+ }
1795
+ },
1796
+ {
1797
+ "name": "delete",
1798
+ "description": "",
1799
+ "params": [
1800
+ {
1801
+ "name": "bucket",
1802
+ "type": "string",
1803
+ "required": true,
1804
+ "description": ""
1805
+ },
1806
+ {
1807
+ "name": "key",
1808
+ "type": "string",
1809
+ "required": true,
1810
+ "description": ""
1811
+ }
1812
+ ],
1813
+ "responseShape": {
1814
+ "deleted": "boolean"
1815
+ }
1816
+ },
1817
+ {
1818
+ "name": "getSignedUrl",
1819
+ "description": "",
1820
+ "params": [
1821
+ {
1822
+ "name": "bucket",
1823
+ "type": "string",
1824
+ "required": true,
1825
+ "description": ""
1826
+ },
1827
+ {
1828
+ "name": "key",
1829
+ "type": "string",
1830
+ "required": true,
1831
+ "description": ""
1832
+ },
1833
+ {
1834
+ "name": "expiresIn",
1835
+ "type": "number",
1836
+ "required": false,
1837
+ "description": ""
1838
+ },
1839
+ {
1840
+ "name": "operation",
1841
+ "type": "'get' | 'put'",
1842
+ "required": false,
1843
+ "description": ""
1844
+ }
1845
+ ],
1846
+ "responseShape": {
1847
+ "url": "string",
1848
+ "expiresAt": "number"
1849
+ }
1850
+ }
1851
+ ],
1852
+ "credentials": [
1853
+ {
1854
+ "envVar": "STORAGE_BUCKET",
1855
+ "required": true,
1856
+ "description": "Cloud storage bucket name"
1857
+ },
1858
+ {
1859
+ "envVar": "STORAGE_REGION",
1860
+ "required": false,
1861
+ "description": "Storage region"
1862
+ }
1863
+ ]
1864
+ },
1865
+ "queue": {
1866
+ "name": "queue",
1867
+ "description": "Message queue — publish, subscribe, acknowledge messages",
1868
+ "category": "infrastructure",
1869
+ "package": "@almadar/integrations",
1870
+ "actions": [
1871
+ {
1872
+ "name": "enqueue",
1873
+ "description": "",
1874
+ "params": [
1875
+ {
1876
+ "name": "queue",
1877
+ "type": "string",
1878
+ "required": true,
1879
+ "description": ""
1880
+ },
1881
+ {
1882
+ "name": "payload",
1883
+ "type": "ServiceParams",
1884
+ "required": true,
1885
+ "description": ""
1886
+ },
1887
+ {
1888
+ "name": "delay",
1889
+ "type": "number",
1890
+ "required": false,
1891
+ "description": ""
1892
+ },
1893
+ {
1894
+ "name": "priority",
1895
+ "type": "number",
1896
+ "required": false,
1897
+ "description": ""
1898
+ }
1899
+ ],
1900
+ "responseShape": {
1901
+ "jobId": "string",
1902
+ "position": "number"
1903
+ }
1904
+ },
1905
+ {
1906
+ "name": "dequeue",
1907
+ "description": "",
1908
+ "params": [
1909
+ {
1910
+ "name": "queue",
1911
+ "type": "string",
1912
+ "required": true,
1913
+ "description": ""
1914
+ }
1915
+ ],
1916
+ "responseShape": {
1917
+ "job": "object | null"
1918
+ }
1919
+ },
1920
+ {
1921
+ "name": "status",
1922
+ "description": "",
1923
+ "params": [
1924
+ {
1925
+ "name": "jobId",
1926
+ "type": "string",
1927
+ "required": true,
1928
+ "description": ""
1929
+ }
1930
+ ],
1931
+ "responseShape": {
1932
+ "status": "'pending' | 'processing' | 'completed' | 'failed'",
1933
+ "job": "object | null"
1934
+ }
1935
+ },
1936
+ {
1937
+ "name": "complete",
1938
+ "description": "",
1939
+ "params": [
1940
+ {
1941
+ "name": "jobId",
1942
+ "type": "string",
1943
+ "required": true,
1944
+ "description": ""
1945
+ },
1946
+ {
1947
+ "name": "result",
1948
+ "type": "ServiceParams",
1949
+ "required": false,
1950
+ "description": ""
1951
+ }
1952
+ ],
1953
+ "responseShape": {
1954
+ "completed": "boolean"
1955
+ }
1956
+ },
1957
+ {
1958
+ "name": "fail",
1959
+ "description": "",
1960
+ "params": [
1961
+ {
1962
+ "name": "jobId",
1963
+ "type": "string",
1964
+ "required": true,
1965
+ "description": ""
1966
+ },
1967
+ {
1968
+ "name": "error",
1969
+ "type": "string",
1970
+ "required": false,
1971
+ "description": ""
1972
+ }
1973
+ ],
1974
+ "responseShape": {
1975
+ "failed": "boolean"
1976
+ }
1977
+ },
1978
+ {
1979
+ "name": "cancel",
1980
+ "description": "",
1981
+ "params": [
1982
+ {
1983
+ "name": "jobId",
1984
+ "type": "string",
1985
+ "required": true,
1986
+ "description": ""
1987
+ }
1988
+ ],
1989
+ "responseShape": {
1990
+ "cancelled": "boolean"
1991
+ }
1992
+ },
1993
+ {
1994
+ "name": "size",
1995
+ "description": "",
1996
+ "params": [
1997
+ {
1998
+ "name": "queue",
1999
+ "type": "string",
2000
+ "required": true,
2001
+ "description": ""
2002
+ }
2003
+ ],
2004
+ "responseShape": {
2005
+ "size": "number",
2006
+ "pending": "number",
2007
+ "processing": "number"
2008
+ }
2009
+ }
2010
+ ],
2011
+ "credentials": [
2012
+ {
2013
+ "envVar": "QUEUE_URL",
2014
+ "required": true,
2015
+ "description": "Message queue connection URL"
2016
+ }
2017
+ ]
2018
+ },
2019
+ "redis": {
2020
+ "name": "redis",
2021
+ "description": "Redis — cache get/set/delete, pub/sub",
2022
+ "category": "infrastructure",
2023
+ "package": "@almadar/integrations",
2024
+ "actions": [
2025
+ {
2026
+ "name": "get",
2027
+ "description": "",
2028
+ "params": [
2029
+ {
2030
+ "name": "key",
2031
+ "type": "string",
2032
+ "required": true,
2033
+ "description": ""
2034
+ }
2035
+ ],
2036
+ "responseShape": {
2037
+ "value": "ServiceParams"
2038
+ }
2039
+ },
2040
+ {
2041
+ "name": "set",
2042
+ "description": "",
2043
+ "params": [
2044
+ {
2045
+ "name": "key",
2046
+ "type": "string",
2047
+ "required": true,
2048
+ "description": ""
2049
+ },
2050
+ {
2051
+ "name": "value",
2052
+ "type": "ServiceParams",
2053
+ "required": true,
2054
+ "description": ""
2055
+ },
2056
+ {
2057
+ "name": "ttl",
2058
+ "type": "number",
2059
+ "required": false,
2060
+ "description": ""
2061
+ }
2062
+ ],
2063
+ "responseShape": {
2064
+ "ok": "boolean"
2065
+ }
2066
+ },
2067
+ {
2068
+ "name": "delete",
2069
+ "description": "",
2070
+ "params": [
2071
+ {
2072
+ "name": "key",
2073
+ "type": "string",
2074
+ "required": true,
2075
+ "description": ""
2076
+ }
2077
+ ],
2078
+ "responseShape": {
2079
+ "deleted": "boolean"
2080
+ }
2081
+ },
2082
+ {
2083
+ "name": "lock",
2084
+ "description": "",
2085
+ "params": [
2086
+ {
2087
+ "name": "key",
2088
+ "type": "string",
2089
+ "required": true,
2090
+ "description": ""
2091
+ },
2092
+ {
2093
+ "name": "ttl",
2094
+ "type": "number",
2095
+ "required": false,
2096
+ "description": ""
2097
+ }
2098
+ ],
2099
+ "responseShape": {
2100
+ "acquired": "boolean",
2101
+ "lockId": "string"
2102
+ }
2103
+ },
2104
+ {
2105
+ "name": "unlock",
2106
+ "description": "",
2107
+ "params": [
2108
+ {
2109
+ "name": "key",
2110
+ "type": "string",
2111
+ "required": true,
2112
+ "description": ""
2113
+ },
2114
+ {
2115
+ "name": "lockId",
2116
+ "type": "string",
2117
+ "required": true,
2118
+ "description": ""
2119
+ }
2120
+ ],
2121
+ "responseShape": {
2122
+ "released": "boolean"
2123
+ }
2124
+ },
2125
+ {
2126
+ "name": "increment",
2127
+ "description": "",
2128
+ "params": [
2129
+ {
2130
+ "name": "key",
2131
+ "type": "string",
2132
+ "required": true,
2133
+ "description": ""
2134
+ },
2135
+ {
2136
+ "name": "by",
2137
+ "type": "number",
2138
+ "required": false,
2139
+ "description": ""
2140
+ }
2141
+ ],
2142
+ "responseShape": {
2143
+ "value": "number"
2144
+ }
2145
+ },
2146
+ {
2147
+ "name": "expire",
2148
+ "description": "",
2149
+ "params": [
2150
+ {
2151
+ "name": "key",
2152
+ "type": "string",
2153
+ "required": true,
2154
+ "description": ""
2155
+ },
2156
+ {
2157
+ "name": "ttl",
2158
+ "type": "number",
2159
+ "required": true,
2160
+ "description": ""
2161
+ }
2162
+ ],
2163
+ "responseShape": {
2164
+ "set": "boolean"
2165
+ }
2166
+ },
2167
+ {
2168
+ "name": "publish",
2169
+ "description": "",
2170
+ "params": [
2171
+ {
2172
+ "name": "channel",
2173
+ "type": "string",
2174
+ "required": true,
2175
+ "description": ""
2176
+ },
2177
+ {
2178
+ "name": "message",
2179
+ "type": "ServiceParams",
2180
+ "required": true,
2181
+ "description": ""
2182
+ }
2183
+ ],
2184
+ "responseShape": {
2185
+ "receivers": "number"
2186
+ }
2187
+ },
2188
+ {
2189
+ "name": "subscribe",
2190
+ "description": "",
2191
+ "params": [
2192
+ {
2193
+ "name": "channel",
2194
+ "type": "string",
2195
+ "required": true,
2196
+ "description": ""
2197
+ }
2198
+ ],
2199
+ "responseShape": {
2200
+ "subscribed": "boolean"
2201
+ }
2202
+ }
2203
+ ],
2204
+ "credentials": [
2205
+ {
2206
+ "envVar": "REDIS_URL",
2207
+ "required": true,
2208
+ "description": "Redis connection URL"
2209
+ }
2210
+ ]
2211
+ },
2212
+ "oauth": {
2213
+ "name": "oauth",
2214
+ "description": "OAuth — authorization flow, token management",
2215
+ "category": "auth",
2216
+ "package": "@almadar/integrations",
2217
+ "actions": [
2218
+ {
2219
+ "name": "authorize",
2220
+ "description": "",
2221
+ "params": [
2222
+ {
2223
+ "name": "provider",
2224
+ "type": "'google' | 'github' | 'auth0'",
2225
+ "required": true,
2226
+ "description": ""
2227
+ },
2228
+ {
2229
+ "name": "scopes",
2230
+ "type": "string[]",
2231
+ "required": true,
2232
+ "description": ""
2233
+ },
2234
+ {
2235
+ "name": "redirectUri",
2236
+ "type": "string",
2237
+ "required": true,
2238
+ "description": ""
2239
+ }
2240
+ ],
2241
+ "responseShape": {
2242
+ "authUrl": "string",
2243
+ "state": "string"
2244
+ }
2245
+ },
2246
+ {
2247
+ "name": "token",
2248
+ "description": "",
2249
+ "params": [
2250
+ {
2251
+ "name": "code",
2252
+ "type": "string",
2253
+ "required": true,
2254
+ "description": ""
2255
+ },
2256
+ {
2257
+ "name": "state",
2258
+ "type": "string",
2259
+ "required": true,
2260
+ "description": ""
2261
+ }
2262
+ ],
2263
+ "responseShape": {
2264
+ "accessToken": "string",
2265
+ "refreshToken": "string",
2266
+ "expiresIn": "number",
2267
+ "tokenType": "'bearer'"
2268
+ }
2269
+ },
2270
+ {
2271
+ "name": "refresh",
2272
+ "description": "",
2273
+ "params": [
2274
+ {
2275
+ "name": "refreshToken",
2276
+ "type": "string",
2277
+ "required": true,
2278
+ "description": ""
2279
+ }
2280
+ ],
2281
+ "responseShape": {
2282
+ "accessToken": "string",
2283
+ "expiresIn": "number"
2284
+ }
2285
+ },
2286
+ {
2287
+ "name": "revoke",
2288
+ "description": "",
2289
+ "params": [
2290
+ {
2291
+ "name": "token",
2292
+ "type": "string",
2293
+ "required": true,
2294
+ "description": ""
2295
+ }
2296
+ ],
2297
+ "responseShape": {
2298
+ "revoked": "boolean"
2299
+ }
2300
+ },
2301
+ {
2302
+ "name": "userinfo",
2303
+ "description": "",
2304
+ "params": [
2305
+ {
2306
+ "name": "accessToken",
2307
+ "type": "string",
2308
+ "required": true,
2309
+ "description": ""
2310
+ }
2311
+ ],
2312
+ "responseShape": {
2313
+ "sub": "string",
2314
+ "email": "string",
2315
+ "name": "string",
2316
+ "picture": "string"
2317
+ }
2318
+ }
2319
+ ],
2320
+ "credentials": [
2321
+ {
2322
+ "envVar": "OAUTH_CLIENT_ID",
2323
+ "required": true,
2324
+ "description": "OAuth2 client ID"
2325
+ },
2326
+ {
2327
+ "envVar": "OAUTH_CLIENT_SECRET",
2328
+ "required": true,
2329
+ "description": "OAuth2 client secret"
2330
+ },
2331
+ {
2332
+ "envVar": "OAUTH_REDIRECT_URI",
2333
+ "required": false,
2334
+ "description": "OAuth2 redirect URI"
2335
+ }
2336
+ ]
2337
+ },
2338
+ "otel": {
2339
+ "name": "otel",
2340
+ "description": "OpenTelemetry — spans, metrics, logs",
2341
+ "category": "infrastructure",
2342
+ "package": "@almadar/integrations",
2343
+ "actions": [
2344
+ {
2345
+ "name": "startSpan",
2346
+ "description": "",
2347
+ "params": [
2348
+ {
2349
+ "name": "name",
2350
+ "type": "string",
2351
+ "required": true,
2352
+ "description": ""
2353
+ },
2354
+ {
2355
+ "name": "attributes",
2356
+ "type": "IntegrationParams",
2357
+ "required": false,
2358
+ "description": ""
2359
+ },
2360
+ {
2361
+ "name": "traceId",
2362
+ "type": "string",
2363
+ "required": false,
2364
+ "description": ""
2365
+ }
2366
+ ],
2367
+ "responseShape": {
2368
+ "spanId": "string",
2369
+ "traceId": "string"
2370
+ }
2371
+ },
2372
+ {
2373
+ "name": "endSpan",
2374
+ "description": "",
2375
+ "params": [
2376
+ {
2377
+ "name": "spanId",
2378
+ "type": "string",
2379
+ "required": true,
2380
+ "description": ""
2381
+ },
2382
+ {
2383
+ "name": "status",
2384
+ "type": "'ok' | 'error'",
2385
+ "required": false,
2386
+ "description": ""
2387
+ }
2388
+ ],
2389
+ "responseShape": {
2390
+ "ended": "boolean"
2391
+ }
2392
+ },
2393
+ {
2394
+ "name": "addEvent",
2395
+ "description": "",
2396
+ "params": [
2397
+ {
2398
+ "name": "spanId",
2399
+ "type": "string",
2400
+ "required": true,
2401
+ "description": ""
2402
+ },
2403
+ {
2404
+ "name": "name",
2405
+ "type": "string",
2406
+ "required": true,
2407
+ "description": ""
2408
+ },
2409
+ {
2410
+ "name": "attributes",
2411
+ "type": "IntegrationParams",
2412
+ "required": false,
2413
+ "description": ""
2414
+ }
2415
+ ],
2416
+ "responseShape": {
2417
+ "added": "boolean"
2418
+ }
2419
+ },
2420
+ {
2421
+ "name": "recordMetric",
2422
+ "description": "",
2423
+ "params": [
2424
+ {
2425
+ "name": "name",
2426
+ "type": "string",
2427
+ "required": true,
2428
+ "description": ""
2429
+ },
2430
+ {
2431
+ "name": "value",
2432
+ "type": "number",
2433
+ "required": true,
2434
+ "description": ""
2435
+ },
2436
+ {
2437
+ "name": "type",
2438
+ "type": "'counter' | 'gauge' | 'histogram'",
2439
+ "required": false,
2440
+ "description": ""
2441
+ },
2442
+ {
2443
+ "name": "labels",
2444
+ "type": "IntegrationParams",
2445
+ "required": false,
2446
+ "description": ""
2447
+ }
2448
+ ],
2449
+ "responseShape": {
2450
+ "recorded": "boolean"
2451
+ }
2452
+ },
2453
+ {
2454
+ "name": "getSpan",
2455
+ "description": "",
2456
+ "params": [
2457
+ {
2458
+ "name": "spanId",
2459
+ "type": "string",
2460
+ "required": true,
2461
+ "description": ""
2462
+ }
2463
+ ],
2464
+ "responseShape": {}
2465
+ },
2466
+ {
2467
+ "name": "getMetrics",
2468
+ "description": "",
2469
+ "params": [],
2470
+ "responseShape": {}
2471
+ }
2472
+ ],
2473
+ "credentials": [
2474
+ {
2475
+ "envVar": "OTEL_EXPORTER_OTLP_ENDPOINT",
2476
+ "required": true,
2477
+ "description": "OpenTelemetry collector endpoint"
2478
+ },
2479
+ {
2480
+ "envVar": "OTEL_SERVICE_NAME",
2481
+ "required": false,
2482
+ "description": "Service name for traces"
2483
+ }
2484
+ ]
2485
+ },
2486
+ "cli": {
2487
+ "name": "cli",
2488
+ "description": "CLI tool execution — run commands, get output",
2489
+ "category": "devtools",
2490
+ "package": "@almadar/integrations",
2491
+ "actions": [
2492
+ {
2493
+ "name": "validate",
2494
+ "description": "",
2495
+ "params": [
2496
+ {
2497
+ "name": "schema",
2498
+ "type": "string",
2499
+ "required": true,
2500
+ "description": ""
2501
+ }
2502
+ ],
2503
+ "responseShape": {
2504
+ "valid": "boolean",
2505
+ "errors": "string[]",
2506
+ "warnings": "string[]",
2507
+ "summary": "string"
2508
+ }
2509
+ }
2510
+ ],
2511
+ "credentials": []
2512
+ },
2513
+ "deepagent": {
2514
+ "name": "deepagent",
2515
+ "description": "DeepAgent — AI agent orchestration",
2516
+ "category": "ai",
2517
+ "package": "@almadar/integrations",
2518
+ "actions": [
2519
+ {
2520
+ "name": "sendMessage",
2521
+ "description": "",
2522
+ "params": [
2523
+ {
2524
+ "name": "message",
2525
+ "type": "string",
2526
+ "required": true,
2527
+ "description": ""
2528
+ },
2529
+ {
2530
+ "name": "threadId",
2531
+ "type": "string",
2532
+ "required": false,
2533
+ "description": ""
2534
+ },
2535
+ {
2536
+ "name": "skill",
2537
+ "type": "string",
2538
+ "required": false,
2539
+ "description": ""
2540
+ },
2541
+ {
2542
+ "name": "context",
2543
+ "type": "IntegrationParams",
2544
+ "required": false,
2545
+ "description": ""
2546
+ }
2547
+ ],
2548
+ "responseShape": {
2549
+ "response": "string",
2550
+ "threadId": "string"
2551
+ }
2552
+ },
2553
+ {
2554
+ "name": "cancelGeneration",
2555
+ "description": "",
2556
+ "params": [
2557
+ {
2558
+ "name": "threadId",
2559
+ "type": "string",
2560
+ "required": true,
2561
+ "description": ""
2562
+ }
2563
+ ],
2564
+ "responseShape": {
2565
+ "cancelled": "boolean"
2566
+ }
2567
+ },
2568
+ {
2569
+ "name": "validateSchema",
2570
+ "description": "",
2571
+ "params": [
2572
+ {
2573
+ "name": "schema",
2574
+ "type": "string",
2575
+ "required": true,
2576
+ "description": ""
2577
+ }
2578
+ ],
2579
+ "responseShape": {
2580
+ "valid": "boolean",
2581
+ "errors": "string[]"
2582
+ }
2583
+ },
2584
+ {
2585
+ "name": "compileSchema",
2586
+ "description": "",
2587
+ "params": [
2588
+ {
2589
+ "name": "schema",
2590
+ "type": "string",
2591
+ "required": true,
2592
+ "description": ""
2593
+ },
2594
+ {
2595
+ "name": "shell",
2596
+ "type": "string",
2597
+ "required": false,
2598
+ "description": ""
2599
+ }
2600
+ ],
2601
+ "responseShape": {
2602
+ "output": "string",
2603
+ "files": "string[]"
2604
+ }
2605
+ },
2606
+ {
2607
+ "name": "getThreadHistory",
2608
+ "description": "",
2609
+ "params": [
2610
+ {
2611
+ "name": "threadId",
2612
+ "type": "string",
2613
+ "required": true,
2614
+ "description": ""
2615
+ }
2616
+ ],
2617
+ "responseShape": {
2618
+ "messages": "array"
2619
+ }
2620
+ }
2621
+ ],
2622
+ "credentials": [
2623
+ {
2624
+ "envVar": "DEEPAGENT_API_URL",
2625
+ "required": true,
2626
+ "description": "DeepAgent server URL"
2627
+ },
2628
+ {
2629
+ "envVar": "DEEPAGENT_API_KEY",
2630
+ "required": false,
2631
+ "description": "DeepAgent API key"
2632
+ }
2633
+ ]
2634
+ }
2635
+ },
2636
+ "categories": [
2637
+ "ai",
2638
+ "auth",
2639
+ "devtools",
2640
+ "infrastructure",
2641
+ "media",
2642
+ "messaging",
2643
+ "payment"
2644
+ ]
2645
+ }