@almadar/patterns 2.8.2 → 2.8.4

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,2511 @@
1
+ {
2
+ "version": "1.0.0",
3
+ "exportedAt": "2026-03-23T02:19:16.692Z",
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": "object",
93
+ "required": true,
94
+ "description": ""
95
+ },
96
+ {
97
+ "name": "model",
98
+ "type": "string",
99
+ "required": false,
100
+ "description": ""
101
+ }
102
+ ],
103
+ "responseShape": {
104
+ "data": "object",
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": "unknown[]"
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": "unknown | 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": "object",
211
+ "required": true,
212
+ "description": ""
213
+ }
214
+ ],
215
+ "responseShape": {
216
+ "item": "unknown"
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": "object",
238
+ "required": true,
239
+ "description": ""
240
+ }
241
+ ],
242
+ "responseShape": {
243
+ "item": "unknown | 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": "unknown",
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": "object | 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": "object | 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": "object",
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": "object",
598
+ "required": false,
599
+ "description": ""
600
+ }
601
+ ],
602
+ "responseShape": {
603
+ "response": "string",
604
+ "threadId": "string",
605
+ "toolCalls": "unknown[]"
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
+ "credentials": [
893
+ {
894
+ "envVar": "GITHUB_TOKEN",
895
+ "required": true,
896
+ "description": "GitHub personal access token"
897
+ },
898
+ {
899
+ "envVar": "GITHUB_OWNER",
900
+ "required": false,
901
+ "description": "Default repository owner"
902
+ },
903
+ {
904
+ "envVar": "GITHUB_REPO",
905
+ "required": false,
906
+ "description": "Default repository name"
907
+ }
908
+ ]
909
+ },
910
+ "stripe": {
911
+ "name": "stripe",
912
+ "description": "Stripe integration — payments, subscriptions, invoices",
913
+ "category": "payment",
914
+ "package": "@almadar/integrations",
915
+ "actions": [
916
+ {
917
+ "name": "createPaymentIntent",
918
+ "description": "",
919
+ "params": [
920
+ {
921
+ "name": "amount",
922
+ "type": "number",
923
+ "required": true,
924
+ "description": ""
925
+ },
926
+ {
927
+ "name": "currency",
928
+ "type": "string",
929
+ "required": true,
930
+ "description": ""
931
+ },
932
+ {
933
+ "name": "metadata",
934
+ "type": "object",
935
+ "required": false,
936
+ "description": ""
937
+ }
938
+ ],
939
+ "responseShape": {
940
+ "id": "string",
941
+ "clientSecret": "string",
942
+ "status": "string",
943
+ "amount": "number",
944
+ "currency": "string"
945
+ }
946
+ },
947
+ {
948
+ "name": "confirmPayment",
949
+ "description": "",
950
+ "params": [
951
+ {
952
+ "name": "paymentIntentId",
953
+ "type": "string",
954
+ "required": true,
955
+ "description": ""
956
+ }
957
+ ],
958
+ "responseShape": {
959
+ "id": "string",
960
+ "status": "string"
961
+ }
962
+ },
963
+ {
964
+ "name": "refund",
965
+ "description": "",
966
+ "params": [
967
+ {
968
+ "name": "paymentIntentId",
969
+ "type": "string",
970
+ "required": true,
971
+ "description": ""
972
+ },
973
+ {
974
+ "name": "amount",
975
+ "type": "number",
976
+ "required": false,
977
+ "description": ""
978
+ }
979
+ ],
980
+ "responseShape": {
981
+ "id": "string",
982
+ "status": "string",
983
+ "amount": "number"
984
+ }
985
+ }
986
+ ],
987
+ "credentials": [
988
+ {
989
+ "envVar": "STRIPE_SECRET_KEY",
990
+ "required": true,
991
+ "description": "Stripe secret API key"
992
+ },
993
+ {
994
+ "envVar": "STRIPE_WEBHOOK_SECRET",
995
+ "required": false,
996
+ "description": "Webhook endpoint signing secret"
997
+ }
998
+ ]
999
+ },
1000
+ "llm-integration": {
1001
+ "name": "llm-integration",
1002
+ "description": "LLM integration — generate, embed, classify via external providers",
1003
+ "category": "ai",
1004
+ "package": "@almadar/integrations",
1005
+ "actions": [
1006
+ {
1007
+ "name": "generate",
1008
+ "description": "",
1009
+ "params": [
1010
+ {
1011
+ "name": "userPrompt",
1012
+ "type": "string",
1013
+ "required": true,
1014
+ "description": ""
1015
+ },
1016
+ {
1017
+ "name": "systemPrompt",
1018
+ "type": "string",
1019
+ "required": false,
1020
+ "description": ""
1021
+ },
1022
+ {
1023
+ "name": "model",
1024
+ "type": "string",
1025
+ "required": false,
1026
+ "description": ""
1027
+ },
1028
+ {
1029
+ "name": "temperature",
1030
+ "type": "number",
1031
+ "required": false,
1032
+ "description": ""
1033
+ },
1034
+ {
1035
+ "name": "maxTokens",
1036
+ "type": "number",
1037
+ "required": false,
1038
+ "description": ""
1039
+ }
1040
+ ],
1041
+ "responseShape": {
1042
+ "content": "string",
1043
+ "usage": "object"
1044
+ }
1045
+ },
1046
+ {
1047
+ "name": "classify",
1048
+ "description": "",
1049
+ "params": [
1050
+ {
1051
+ "name": "text",
1052
+ "type": "string",
1053
+ "required": true,
1054
+ "description": ""
1055
+ },
1056
+ {
1057
+ "name": "categories",
1058
+ "type": "string[]",
1059
+ "required": true,
1060
+ "description": ""
1061
+ },
1062
+ {
1063
+ "name": "model",
1064
+ "type": "string",
1065
+ "required": false,
1066
+ "description": ""
1067
+ }
1068
+ ],
1069
+ "responseShape": {
1070
+ "category": "string",
1071
+ "confidence": "number",
1072
+ "reasoning": "string"
1073
+ }
1074
+ },
1075
+ {
1076
+ "name": "extract",
1077
+ "description": "",
1078
+ "params": [
1079
+ {
1080
+ "name": "text",
1081
+ "type": "string",
1082
+ "required": true,
1083
+ "description": ""
1084
+ },
1085
+ {
1086
+ "name": "schema",
1087
+ "type": "object",
1088
+ "required": true,
1089
+ "description": ""
1090
+ },
1091
+ {
1092
+ "name": "model",
1093
+ "type": "string",
1094
+ "required": false,
1095
+ "description": ""
1096
+ }
1097
+ ],
1098
+ "responseShape": {}
1099
+ },
1100
+ {
1101
+ "name": "summarize",
1102
+ "description": "",
1103
+ "params": [
1104
+ {
1105
+ "name": "text",
1106
+ "type": "string",
1107
+ "required": true,
1108
+ "description": ""
1109
+ },
1110
+ {
1111
+ "name": "maxLength",
1112
+ "type": "number",
1113
+ "required": false,
1114
+ "description": ""
1115
+ },
1116
+ {
1117
+ "name": "style",
1118
+ "type": "string",
1119
+ "required": false,
1120
+ "description": ""
1121
+ },
1122
+ {
1123
+ "name": "model",
1124
+ "type": "string",
1125
+ "required": false,
1126
+ "description": ""
1127
+ }
1128
+ ],
1129
+ "responseShape": {
1130
+ "summary": "string",
1131
+ "keyPoints": "string[]"
1132
+ }
1133
+ }
1134
+ ],
1135
+ "credentials": [
1136
+ {
1137
+ "envVar": "ANTHROPIC_API_KEY",
1138
+ "required": false,
1139
+ "description": "Anthropic API key"
1140
+ },
1141
+ {
1142
+ "envVar": "OPENAI_API_KEY",
1143
+ "required": false,
1144
+ "description": "OpenAI API key"
1145
+ }
1146
+ ]
1147
+ },
1148
+ "youtube": {
1149
+ "name": "youtube",
1150
+ "description": "YouTube Data API — search videos, get video/channel details",
1151
+ "category": "media",
1152
+ "package": "@almadar/integrations",
1153
+ "actions": [
1154
+ {
1155
+ "name": "search",
1156
+ "description": "",
1157
+ "params": [
1158
+ {
1159
+ "name": "query",
1160
+ "type": "string",
1161
+ "required": true,
1162
+ "description": ""
1163
+ },
1164
+ {
1165
+ "name": "maxResults",
1166
+ "type": "number",
1167
+ "required": false,
1168
+ "description": ""
1169
+ },
1170
+ {
1171
+ "name": "type",
1172
+ "type": "string",
1173
+ "required": false,
1174
+ "description": ""
1175
+ }
1176
+ ],
1177
+ "responseShape": {}
1178
+ },
1179
+ {
1180
+ "name": "getVideo",
1181
+ "description": "",
1182
+ "params": [
1183
+ {
1184
+ "name": "videoId",
1185
+ "type": "string",
1186
+ "required": true,
1187
+ "description": ""
1188
+ }
1189
+ ],
1190
+ "responseShape": {
1191
+ "title": "string",
1192
+ "description": "string",
1193
+ "viewCount": "string",
1194
+ "likeCount": "string"
1195
+ }
1196
+ },
1197
+ {
1198
+ "name": "getChannel",
1199
+ "description": "",
1200
+ "params": [
1201
+ {
1202
+ "name": "channelId",
1203
+ "type": "string",
1204
+ "required": true,
1205
+ "description": ""
1206
+ }
1207
+ ],
1208
+ "responseShape": {
1209
+ "name": "string",
1210
+ "description": "string",
1211
+ "subscriberCount": "string"
1212
+ }
1213
+ }
1214
+ ],
1215
+ "credentials": [
1216
+ {
1217
+ "envVar": "YOUTUBE_API_KEY",
1218
+ "required": true,
1219
+ "description": "YouTube Data API key"
1220
+ }
1221
+ ]
1222
+ },
1223
+ "twilio": {
1224
+ "name": "twilio",
1225
+ "description": "Twilio — SMS, voice calls, verification",
1226
+ "category": "messaging",
1227
+ "package": "@almadar/integrations",
1228
+ "actions": [
1229
+ {
1230
+ "name": "sendSMS",
1231
+ "description": "",
1232
+ "params": [
1233
+ {
1234
+ "name": "to",
1235
+ "type": "string",
1236
+ "required": true,
1237
+ "description": ""
1238
+ },
1239
+ {
1240
+ "name": "body",
1241
+ "type": "string",
1242
+ "required": true,
1243
+ "description": ""
1244
+ }
1245
+ ],
1246
+ "responseShape": {
1247
+ "sid": "string",
1248
+ "status": "string"
1249
+ }
1250
+ },
1251
+ {
1252
+ "name": "sendWhatsApp",
1253
+ "description": "",
1254
+ "params": [
1255
+ {
1256
+ "name": "to",
1257
+ "type": "string",
1258
+ "required": true,
1259
+ "description": ""
1260
+ },
1261
+ {
1262
+ "name": "body",
1263
+ "type": "string",
1264
+ "required": true,
1265
+ "description": ""
1266
+ }
1267
+ ],
1268
+ "responseShape": {
1269
+ "sid": "string",
1270
+ "status": "string"
1271
+ }
1272
+ }
1273
+ ],
1274
+ "credentials": [
1275
+ {
1276
+ "envVar": "TWILIO_ACCOUNT_SID",
1277
+ "required": true,
1278
+ "description": "Twilio account SID"
1279
+ },
1280
+ {
1281
+ "envVar": "TWILIO_AUTH_TOKEN",
1282
+ "required": true,
1283
+ "description": "Twilio auth token"
1284
+ },
1285
+ {
1286
+ "envVar": "TWILIO_PHONE_NUMBER",
1287
+ "required": false,
1288
+ "description": "Default sender phone number"
1289
+ }
1290
+ ]
1291
+ },
1292
+ "email": {
1293
+ "name": "email",
1294
+ "description": "Email service — send, send with template",
1295
+ "category": "messaging",
1296
+ "package": "@almadar/integrations",
1297
+ "actions": [
1298
+ {
1299
+ "name": "send",
1300
+ "description": "",
1301
+ "params": [
1302
+ {
1303
+ "name": "to",
1304
+ "type": "string",
1305
+ "required": true,
1306
+ "description": ""
1307
+ },
1308
+ {
1309
+ "name": "subject",
1310
+ "type": "string",
1311
+ "required": true,
1312
+ "description": ""
1313
+ },
1314
+ {
1315
+ "name": "body",
1316
+ "type": "string",
1317
+ "required": true,
1318
+ "description": ""
1319
+ },
1320
+ {
1321
+ "name": "from",
1322
+ "type": "string",
1323
+ "required": false,
1324
+ "description": ""
1325
+ }
1326
+ ],
1327
+ "responseShape": {
1328
+ "id": "string",
1329
+ "status": "string"
1330
+ }
1331
+ }
1332
+ ],
1333
+ "credentials": [
1334
+ {
1335
+ "envVar": "SENDGRID_API_KEY",
1336
+ "required": false,
1337
+ "description": "SendGrid API key (use this OR RESEND_API_KEY)"
1338
+ },
1339
+ {
1340
+ "envVar": "RESEND_API_KEY",
1341
+ "required": false,
1342
+ "description": "Resend API key (use this OR SENDGRID_API_KEY)"
1343
+ },
1344
+ {
1345
+ "envVar": "FROM_EMAIL",
1346
+ "required": false,
1347
+ "description": "Default sender email address"
1348
+ }
1349
+ ]
1350
+ },
1351
+ "docker": {
1352
+ "name": "docker",
1353
+ "description": "Docker — container and image management",
1354
+ "category": "devtools",
1355
+ "package": "@almadar/integrations",
1356
+ "actions": [
1357
+ {
1358
+ "name": "build",
1359
+ "description": "",
1360
+ "params": [
1361
+ {
1362
+ "name": "tag",
1363
+ "type": "string",
1364
+ "required": true,
1365
+ "description": ""
1366
+ },
1367
+ {
1368
+ "name": "dockerfile",
1369
+ "type": "string",
1370
+ "required": false,
1371
+ "description": ""
1372
+ },
1373
+ {
1374
+ "name": "context",
1375
+ "type": "string",
1376
+ "required": false,
1377
+ "description": ""
1378
+ },
1379
+ {
1380
+ "name": "buildArgs",
1381
+ "type": "object",
1382
+ "required": false,
1383
+ "description": ""
1384
+ }
1385
+ ],
1386
+ "responseShape": {
1387
+ "imageId": "string",
1388
+ "tag": "string",
1389
+ "size": "number",
1390
+ "buildTime": "number"
1391
+ }
1392
+ },
1393
+ {
1394
+ "name": "run",
1395
+ "description": "",
1396
+ "params": [
1397
+ {
1398
+ "name": "image",
1399
+ "type": "string",
1400
+ "required": true,
1401
+ "description": ""
1402
+ },
1403
+ {
1404
+ "name": "name",
1405
+ "type": "string",
1406
+ "required": false,
1407
+ "description": ""
1408
+ },
1409
+ {
1410
+ "name": "ports",
1411
+ "type": "array",
1412
+ "required": false,
1413
+ "description": ""
1414
+ },
1415
+ {
1416
+ "name": "env",
1417
+ "type": "object",
1418
+ "required": false,
1419
+ "description": ""
1420
+ },
1421
+ {
1422
+ "name": "volumes",
1423
+ "type": "array",
1424
+ "required": false,
1425
+ "description": ""
1426
+ },
1427
+ {
1428
+ "name": "command",
1429
+ "type": "string",
1430
+ "required": false,
1431
+ "description": ""
1432
+ }
1433
+ ],
1434
+ "responseShape": {
1435
+ "containerId": "string",
1436
+ "name": "string",
1437
+ "status": "string",
1438
+ "ports": "array"
1439
+ }
1440
+ },
1441
+ {
1442
+ "name": "stop",
1443
+ "description": "",
1444
+ "params": [
1445
+ {
1446
+ "name": "containerId",
1447
+ "type": "string",
1448
+ "required": true,
1449
+ "description": ""
1450
+ }
1451
+ ],
1452
+ "responseShape": {
1453
+ "containerId": "string",
1454
+ "status": "string",
1455
+ "stoppedAt": "number"
1456
+ }
1457
+ },
1458
+ {
1459
+ "name": "remove",
1460
+ "description": "",
1461
+ "params": [
1462
+ {
1463
+ "name": "containerId",
1464
+ "type": "string",
1465
+ "required": true,
1466
+ "description": ""
1467
+ },
1468
+ {
1469
+ "name": "force",
1470
+ "type": "boolean",
1471
+ "required": false,
1472
+ "description": ""
1473
+ }
1474
+ ],
1475
+ "responseShape": {
1476
+ "containerId": "string",
1477
+ "removed": "boolean"
1478
+ }
1479
+ },
1480
+ {
1481
+ "name": "logs",
1482
+ "description": "",
1483
+ "params": [
1484
+ {
1485
+ "name": "containerId",
1486
+ "type": "string",
1487
+ "required": true,
1488
+ "description": ""
1489
+ },
1490
+ {
1491
+ "name": "tail",
1492
+ "type": "number",
1493
+ "required": false,
1494
+ "description": ""
1495
+ },
1496
+ {
1497
+ "name": "since",
1498
+ "type": "string",
1499
+ "required": false,
1500
+ "description": ""
1501
+ }
1502
+ ],
1503
+ "responseShape": {
1504
+ "containerId": "string",
1505
+ "logs": "string[]",
1506
+ "lineCount": "number"
1507
+ }
1508
+ },
1509
+ {
1510
+ "name": "status",
1511
+ "description": "",
1512
+ "params": [
1513
+ {
1514
+ "name": "containerId",
1515
+ "type": "string",
1516
+ "required": true,
1517
+ "description": ""
1518
+ }
1519
+ ],
1520
+ "responseShape": {
1521
+ "containerId": "string",
1522
+ "name": "string",
1523
+ "image": "string",
1524
+ "status": "string",
1525
+ "ports": "array",
1526
+ "createdAt": "number",
1527
+ "startedAt": "number | null",
1528
+ "stoppedAt": "number | null"
1529
+ }
1530
+ },
1531
+ {
1532
+ "name": "list",
1533
+ "description": "",
1534
+ "params": [
1535
+ {
1536
+ "name": "all",
1537
+ "type": "boolean",
1538
+ "required": false,
1539
+ "description": ""
1540
+ },
1541
+ {
1542
+ "name": "filterByLabel",
1543
+ "type": "string",
1544
+ "required": false,
1545
+ "description": ""
1546
+ }
1547
+ ],
1548
+ "responseShape": {
1549
+ "containers": "array",
1550
+ "total": "number"
1551
+ }
1552
+ }
1553
+ ],
1554
+ "credentials": [
1555
+ {
1556
+ "envVar": "DOCKER_HOST",
1557
+ "required": false,
1558
+ "description": "Docker daemon host URL"
1559
+ }
1560
+ ]
1561
+ },
1562
+ "storage": {
1563
+ "name": "storage",
1564
+ "description": "Object storage — upload, download, delete, list files",
1565
+ "category": "infrastructure",
1566
+ "package": "@almadar/integrations",
1567
+ "actions": [
1568
+ {
1569
+ "name": "upload",
1570
+ "description": "",
1571
+ "params": [
1572
+ {
1573
+ "name": "bucket",
1574
+ "type": "string",
1575
+ "required": true,
1576
+ "description": ""
1577
+ },
1578
+ {
1579
+ "name": "key",
1580
+ "type": "string",
1581
+ "required": true,
1582
+ "description": ""
1583
+ },
1584
+ {
1585
+ "name": "content",
1586
+ "type": "unknown",
1587
+ "required": true,
1588
+ "description": ""
1589
+ },
1590
+ {
1591
+ "name": "contentType",
1592
+ "type": "string",
1593
+ "required": false,
1594
+ "description": ""
1595
+ },
1596
+ {
1597
+ "name": "metadata",
1598
+ "type": "object",
1599
+ "required": false,
1600
+ "description": ""
1601
+ }
1602
+ ],
1603
+ "responseShape": {
1604
+ "key": "string",
1605
+ "bucket": "string",
1606
+ "size": "number",
1607
+ "etag": "string"
1608
+ }
1609
+ },
1610
+ {
1611
+ "name": "download",
1612
+ "description": "",
1613
+ "params": [
1614
+ {
1615
+ "name": "bucket",
1616
+ "type": "string",
1617
+ "required": true,
1618
+ "description": ""
1619
+ },
1620
+ {
1621
+ "name": "key",
1622
+ "type": "string",
1623
+ "required": true,
1624
+ "description": ""
1625
+ }
1626
+ ],
1627
+ "responseShape": {
1628
+ "content": "unknown",
1629
+ "contentType": "string",
1630
+ "size": "number",
1631
+ "metadata": "object"
1632
+ }
1633
+ },
1634
+ {
1635
+ "name": "list",
1636
+ "description": "",
1637
+ "params": [
1638
+ {
1639
+ "name": "bucket",
1640
+ "type": "string",
1641
+ "required": true,
1642
+ "description": ""
1643
+ },
1644
+ {
1645
+ "name": "prefix",
1646
+ "type": "string",
1647
+ "required": false,
1648
+ "description": ""
1649
+ },
1650
+ {
1651
+ "name": "maxKeys",
1652
+ "type": "number",
1653
+ "required": false,
1654
+ "description": ""
1655
+ }
1656
+ ],
1657
+ "responseShape": {
1658
+ "keys": "array",
1659
+ "truncated": "boolean"
1660
+ }
1661
+ },
1662
+ {
1663
+ "name": "delete",
1664
+ "description": "",
1665
+ "params": [
1666
+ {
1667
+ "name": "bucket",
1668
+ "type": "string",
1669
+ "required": true,
1670
+ "description": ""
1671
+ },
1672
+ {
1673
+ "name": "key",
1674
+ "type": "string",
1675
+ "required": true,
1676
+ "description": ""
1677
+ }
1678
+ ],
1679
+ "responseShape": {
1680
+ "deleted": "boolean"
1681
+ }
1682
+ },
1683
+ {
1684
+ "name": "getSignedUrl",
1685
+ "description": "",
1686
+ "params": [
1687
+ {
1688
+ "name": "bucket",
1689
+ "type": "string",
1690
+ "required": true,
1691
+ "description": ""
1692
+ },
1693
+ {
1694
+ "name": "key",
1695
+ "type": "string",
1696
+ "required": true,
1697
+ "description": ""
1698
+ },
1699
+ {
1700
+ "name": "expiresIn",
1701
+ "type": "number",
1702
+ "required": false,
1703
+ "description": ""
1704
+ },
1705
+ {
1706
+ "name": "operation",
1707
+ "type": "'get' | 'put'",
1708
+ "required": false,
1709
+ "description": ""
1710
+ }
1711
+ ],
1712
+ "responseShape": {
1713
+ "url": "string",
1714
+ "expiresAt": "number"
1715
+ }
1716
+ }
1717
+ ],
1718
+ "credentials": [
1719
+ {
1720
+ "envVar": "STORAGE_BUCKET",
1721
+ "required": true,
1722
+ "description": "Cloud storage bucket name"
1723
+ },
1724
+ {
1725
+ "envVar": "STORAGE_REGION",
1726
+ "required": false,
1727
+ "description": "Storage region"
1728
+ }
1729
+ ]
1730
+ },
1731
+ "queue": {
1732
+ "name": "queue",
1733
+ "description": "Message queue — publish, subscribe, acknowledge messages",
1734
+ "category": "infrastructure",
1735
+ "package": "@almadar/integrations",
1736
+ "actions": [
1737
+ {
1738
+ "name": "enqueue",
1739
+ "description": "",
1740
+ "params": [
1741
+ {
1742
+ "name": "queue",
1743
+ "type": "string",
1744
+ "required": true,
1745
+ "description": ""
1746
+ },
1747
+ {
1748
+ "name": "payload",
1749
+ "type": "unknown",
1750
+ "required": true,
1751
+ "description": ""
1752
+ },
1753
+ {
1754
+ "name": "delay",
1755
+ "type": "number",
1756
+ "required": false,
1757
+ "description": ""
1758
+ },
1759
+ {
1760
+ "name": "priority",
1761
+ "type": "number",
1762
+ "required": false,
1763
+ "description": ""
1764
+ }
1765
+ ],
1766
+ "responseShape": {
1767
+ "jobId": "string",
1768
+ "position": "number"
1769
+ }
1770
+ },
1771
+ {
1772
+ "name": "dequeue",
1773
+ "description": "",
1774
+ "params": [
1775
+ {
1776
+ "name": "queue",
1777
+ "type": "string",
1778
+ "required": true,
1779
+ "description": ""
1780
+ }
1781
+ ],
1782
+ "responseShape": {
1783
+ "job": "object | null"
1784
+ }
1785
+ },
1786
+ {
1787
+ "name": "status",
1788
+ "description": "",
1789
+ "params": [
1790
+ {
1791
+ "name": "jobId",
1792
+ "type": "string",
1793
+ "required": true,
1794
+ "description": ""
1795
+ }
1796
+ ],
1797
+ "responseShape": {
1798
+ "status": "'pending' | 'processing' | 'completed' | 'failed'",
1799
+ "job": "object | null"
1800
+ }
1801
+ },
1802
+ {
1803
+ "name": "complete",
1804
+ "description": "",
1805
+ "params": [
1806
+ {
1807
+ "name": "jobId",
1808
+ "type": "string",
1809
+ "required": true,
1810
+ "description": ""
1811
+ },
1812
+ {
1813
+ "name": "result",
1814
+ "type": "unknown",
1815
+ "required": false,
1816
+ "description": ""
1817
+ }
1818
+ ],
1819
+ "responseShape": {
1820
+ "completed": "boolean"
1821
+ }
1822
+ },
1823
+ {
1824
+ "name": "fail",
1825
+ "description": "",
1826
+ "params": [
1827
+ {
1828
+ "name": "jobId",
1829
+ "type": "string",
1830
+ "required": true,
1831
+ "description": ""
1832
+ },
1833
+ {
1834
+ "name": "error",
1835
+ "type": "string",
1836
+ "required": false,
1837
+ "description": ""
1838
+ }
1839
+ ],
1840
+ "responseShape": {
1841
+ "failed": "boolean"
1842
+ }
1843
+ },
1844
+ {
1845
+ "name": "cancel",
1846
+ "description": "",
1847
+ "params": [
1848
+ {
1849
+ "name": "jobId",
1850
+ "type": "string",
1851
+ "required": true,
1852
+ "description": ""
1853
+ }
1854
+ ],
1855
+ "responseShape": {
1856
+ "cancelled": "boolean"
1857
+ }
1858
+ },
1859
+ {
1860
+ "name": "size",
1861
+ "description": "",
1862
+ "params": [
1863
+ {
1864
+ "name": "queue",
1865
+ "type": "string",
1866
+ "required": true,
1867
+ "description": ""
1868
+ }
1869
+ ],
1870
+ "responseShape": {
1871
+ "size": "number",
1872
+ "pending": "number",
1873
+ "processing": "number"
1874
+ }
1875
+ }
1876
+ ],
1877
+ "credentials": [
1878
+ {
1879
+ "envVar": "QUEUE_URL",
1880
+ "required": true,
1881
+ "description": "Message queue connection URL"
1882
+ }
1883
+ ]
1884
+ },
1885
+ "redis": {
1886
+ "name": "redis",
1887
+ "description": "Redis — cache get/set/delete, pub/sub",
1888
+ "category": "infrastructure",
1889
+ "package": "@almadar/integrations",
1890
+ "actions": [
1891
+ {
1892
+ "name": "get",
1893
+ "description": "",
1894
+ "params": [
1895
+ {
1896
+ "name": "key",
1897
+ "type": "string",
1898
+ "required": true,
1899
+ "description": ""
1900
+ }
1901
+ ],
1902
+ "responseShape": {
1903
+ "value": "unknown"
1904
+ }
1905
+ },
1906
+ {
1907
+ "name": "set",
1908
+ "description": "",
1909
+ "params": [
1910
+ {
1911
+ "name": "key",
1912
+ "type": "string",
1913
+ "required": true,
1914
+ "description": ""
1915
+ },
1916
+ {
1917
+ "name": "value",
1918
+ "type": "unknown",
1919
+ "required": true,
1920
+ "description": ""
1921
+ },
1922
+ {
1923
+ "name": "ttl",
1924
+ "type": "number",
1925
+ "required": false,
1926
+ "description": ""
1927
+ }
1928
+ ],
1929
+ "responseShape": {
1930
+ "ok": "boolean"
1931
+ }
1932
+ },
1933
+ {
1934
+ "name": "delete",
1935
+ "description": "",
1936
+ "params": [
1937
+ {
1938
+ "name": "key",
1939
+ "type": "string",
1940
+ "required": true,
1941
+ "description": ""
1942
+ }
1943
+ ],
1944
+ "responseShape": {
1945
+ "deleted": "boolean"
1946
+ }
1947
+ },
1948
+ {
1949
+ "name": "lock",
1950
+ "description": "",
1951
+ "params": [
1952
+ {
1953
+ "name": "key",
1954
+ "type": "string",
1955
+ "required": true,
1956
+ "description": ""
1957
+ },
1958
+ {
1959
+ "name": "ttl",
1960
+ "type": "number",
1961
+ "required": false,
1962
+ "description": ""
1963
+ }
1964
+ ],
1965
+ "responseShape": {
1966
+ "acquired": "boolean",
1967
+ "lockId": "string"
1968
+ }
1969
+ },
1970
+ {
1971
+ "name": "unlock",
1972
+ "description": "",
1973
+ "params": [
1974
+ {
1975
+ "name": "key",
1976
+ "type": "string",
1977
+ "required": true,
1978
+ "description": ""
1979
+ },
1980
+ {
1981
+ "name": "lockId",
1982
+ "type": "string",
1983
+ "required": true,
1984
+ "description": ""
1985
+ }
1986
+ ],
1987
+ "responseShape": {
1988
+ "released": "boolean"
1989
+ }
1990
+ },
1991
+ {
1992
+ "name": "increment",
1993
+ "description": "",
1994
+ "params": [
1995
+ {
1996
+ "name": "key",
1997
+ "type": "string",
1998
+ "required": true,
1999
+ "description": ""
2000
+ },
2001
+ {
2002
+ "name": "by",
2003
+ "type": "number",
2004
+ "required": false,
2005
+ "description": ""
2006
+ }
2007
+ ],
2008
+ "responseShape": {
2009
+ "value": "number"
2010
+ }
2011
+ },
2012
+ {
2013
+ "name": "expire",
2014
+ "description": "",
2015
+ "params": [
2016
+ {
2017
+ "name": "key",
2018
+ "type": "string",
2019
+ "required": true,
2020
+ "description": ""
2021
+ },
2022
+ {
2023
+ "name": "ttl",
2024
+ "type": "number",
2025
+ "required": true,
2026
+ "description": ""
2027
+ }
2028
+ ],
2029
+ "responseShape": {
2030
+ "set": "boolean"
2031
+ }
2032
+ },
2033
+ {
2034
+ "name": "publish",
2035
+ "description": "",
2036
+ "params": [
2037
+ {
2038
+ "name": "channel",
2039
+ "type": "string",
2040
+ "required": true,
2041
+ "description": ""
2042
+ },
2043
+ {
2044
+ "name": "message",
2045
+ "type": "unknown",
2046
+ "required": true,
2047
+ "description": ""
2048
+ }
2049
+ ],
2050
+ "responseShape": {
2051
+ "receivers": "number"
2052
+ }
2053
+ },
2054
+ {
2055
+ "name": "subscribe",
2056
+ "description": "",
2057
+ "params": [
2058
+ {
2059
+ "name": "channel",
2060
+ "type": "string",
2061
+ "required": true,
2062
+ "description": ""
2063
+ }
2064
+ ],
2065
+ "responseShape": {
2066
+ "subscribed": "boolean"
2067
+ }
2068
+ }
2069
+ ],
2070
+ "credentials": [
2071
+ {
2072
+ "envVar": "REDIS_URL",
2073
+ "required": true,
2074
+ "description": "Redis connection URL"
2075
+ }
2076
+ ]
2077
+ },
2078
+ "oauth": {
2079
+ "name": "oauth",
2080
+ "description": "OAuth — authorization flow, token management",
2081
+ "category": "auth",
2082
+ "package": "@almadar/integrations",
2083
+ "actions": [
2084
+ {
2085
+ "name": "authorize",
2086
+ "description": "",
2087
+ "params": [
2088
+ {
2089
+ "name": "provider",
2090
+ "type": "'google' | 'github' | 'auth0'",
2091
+ "required": true,
2092
+ "description": ""
2093
+ },
2094
+ {
2095
+ "name": "scopes",
2096
+ "type": "string[]",
2097
+ "required": true,
2098
+ "description": ""
2099
+ },
2100
+ {
2101
+ "name": "redirectUri",
2102
+ "type": "string",
2103
+ "required": true,
2104
+ "description": ""
2105
+ }
2106
+ ],
2107
+ "responseShape": {
2108
+ "authUrl": "string",
2109
+ "state": "string"
2110
+ }
2111
+ },
2112
+ {
2113
+ "name": "token",
2114
+ "description": "",
2115
+ "params": [
2116
+ {
2117
+ "name": "code",
2118
+ "type": "string",
2119
+ "required": true,
2120
+ "description": ""
2121
+ },
2122
+ {
2123
+ "name": "state",
2124
+ "type": "string",
2125
+ "required": true,
2126
+ "description": ""
2127
+ }
2128
+ ],
2129
+ "responseShape": {
2130
+ "accessToken": "string",
2131
+ "refreshToken": "string",
2132
+ "expiresIn": "number",
2133
+ "tokenType": "'bearer'"
2134
+ }
2135
+ },
2136
+ {
2137
+ "name": "refresh",
2138
+ "description": "",
2139
+ "params": [
2140
+ {
2141
+ "name": "refreshToken",
2142
+ "type": "string",
2143
+ "required": true,
2144
+ "description": ""
2145
+ }
2146
+ ],
2147
+ "responseShape": {
2148
+ "accessToken": "string",
2149
+ "expiresIn": "number"
2150
+ }
2151
+ },
2152
+ {
2153
+ "name": "revoke",
2154
+ "description": "",
2155
+ "params": [
2156
+ {
2157
+ "name": "token",
2158
+ "type": "string",
2159
+ "required": true,
2160
+ "description": ""
2161
+ }
2162
+ ],
2163
+ "responseShape": {
2164
+ "revoked": "boolean"
2165
+ }
2166
+ },
2167
+ {
2168
+ "name": "userinfo",
2169
+ "description": "",
2170
+ "params": [
2171
+ {
2172
+ "name": "accessToken",
2173
+ "type": "string",
2174
+ "required": true,
2175
+ "description": ""
2176
+ }
2177
+ ],
2178
+ "responseShape": {
2179
+ "sub": "string",
2180
+ "email": "string",
2181
+ "name": "string",
2182
+ "picture": "string"
2183
+ }
2184
+ }
2185
+ ],
2186
+ "credentials": [
2187
+ {
2188
+ "envVar": "OAUTH_CLIENT_ID",
2189
+ "required": true,
2190
+ "description": "OAuth2 client ID"
2191
+ },
2192
+ {
2193
+ "envVar": "OAUTH_CLIENT_SECRET",
2194
+ "required": true,
2195
+ "description": "OAuth2 client secret"
2196
+ },
2197
+ {
2198
+ "envVar": "OAUTH_REDIRECT_URI",
2199
+ "required": false,
2200
+ "description": "OAuth2 redirect URI"
2201
+ }
2202
+ ]
2203
+ },
2204
+ "otel": {
2205
+ "name": "otel",
2206
+ "description": "OpenTelemetry — spans, metrics, logs",
2207
+ "category": "infrastructure",
2208
+ "package": "@almadar/integrations",
2209
+ "actions": [
2210
+ {
2211
+ "name": "startSpan",
2212
+ "description": "",
2213
+ "params": [
2214
+ {
2215
+ "name": "name",
2216
+ "type": "string",
2217
+ "required": true,
2218
+ "description": ""
2219
+ },
2220
+ {
2221
+ "name": "attributes",
2222
+ "type": "object",
2223
+ "required": false,
2224
+ "description": ""
2225
+ },
2226
+ {
2227
+ "name": "traceId",
2228
+ "type": "string",
2229
+ "required": false,
2230
+ "description": ""
2231
+ }
2232
+ ],
2233
+ "responseShape": {
2234
+ "spanId": "string",
2235
+ "traceId": "string"
2236
+ }
2237
+ },
2238
+ {
2239
+ "name": "endSpan",
2240
+ "description": "",
2241
+ "params": [
2242
+ {
2243
+ "name": "spanId",
2244
+ "type": "string",
2245
+ "required": true,
2246
+ "description": ""
2247
+ },
2248
+ {
2249
+ "name": "status",
2250
+ "type": "'ok' | 'error'",
2251
+ "required": false,
2252
+ "description": ""
2253
+ }
2254
+ ],
2255
+ "responseShape": {
2256
+ "ended": "boolean"
2257
+ }
2258
+ },
2259
+ {
2260
+ "name": "addEvent",
2261
+ "description": "",
2262
+ "params": [
2263
+ {
2264
+ "name": "spanId",
2265
+ "type": "string",
2266
+ "required": true,
2267
+ "description": ""
2268
+ },
2269
+ {
2270
+ "name": "name",
2271
+ "type": "string",
2272
+ "required": true,
2273
+ "description": ""
2274
+ },
2275
+ {
2276
+ "name": "attributes",
2277
+ "type": "object",
2278
+ "required": false,
2279
+ "description": ""
2280
+ }
2281
+ ],
2282
+ "responseShape": {
2283
+ "added": "boolean"
2284
+ }
2285
+ },
2286
+ {
2287
+ "name": "recordMetric",
2288
+ "description": "",
2289
+ "params": [
2290
+ {
2291
+ "name": "name",
2292
+ "type": "string",
2293
+ "required": true,
2294
+ "description": ""
2295
+ },
2296
+ {
2297
+ "name": "value",
2298
+ "type": "number",
2299
+ "required": true,
2300
+ "description": ""
2301
+ },
2302
+ {
2303
+ "name": "type",
2304
+ "type": "'counter' | 'gauge' | 'histogram'",
2305
+ "required": false,
2306
+ "description": ""
2307
+ },
2308
+ {
2309
+ "name": "labels",
2310
+ "type": "object",
2311
+ "required": false,
2312
+ "description": ""
2313
+ }
2314
+ ],
2315
+ "responseShape": {
2316
+ "recorded": "boolean"
2317
+ }
2318
+ },
2319
+ {
2320
+ "name": "getSpan",
2321
+ "description": "",
2322
+ "params": [
2323
+ {
2324
+ "name": "spanId",
2325
+ "type": "string",
2326
+ "required": true,
2327
+ "description": ""
2328
+ }
2329
+ ],
2330
+ "responseShape": {}
2331
+ },
2332
+ {
2333
+ "name": "getMetrics",
2334
+ "description": "",
2335
+ "params": [],
2336
+ "responseShape": {}
2337
+ }
2338
+ ],
2339
+ "credentials": [
2340
+ {
2341
+ "envVar": "OTEL_EXPORTER_OTLP_ENDPOINT",
2342
+ "required": true,
2343
+ "description": "OpenTelemetry collector endpoint"
2344
+ },
2345
+ {
2346
+ "envVar": "OTEL_SERVICE_NAME",
2347
+ "required": false,
2348
+ "description": "Service name for traces"
2349
+ }
2350
+ ]
2351
+ },
2352
+ "cli": {
2353
+ "name": "cli",
2354
+ "description": "CLI tool execution — run commands, get output",
2355
+ "category": "devtools",
2356
+ "package": "@almadar/integrations",
2357
+ "actions": [
2358
+ {
2359
+ "name": "validate",
2360
+ "description": "",
2361
+ "params": [
2362
+ {
2363
+ "name": "schema",
2364
+ "type": "string",
2365
+ "required": true,
2366
+ "description": ""
2367
+ }
2368
+ ],
2369
+ "responseShape": {
2370
+ "valid": "boolean",
2371
+ "errors": "string[]",
2372
+ "warnings": "string[]",
2373
+ "summary": "string"
2374
+ }
2375
+ }
2376
+ ],
2377
+ "credentials": []
2378
+ },
2379
+ "deepagent": {
2380
+ "name": "deepagent",
2381
+ "description": "DeepAgent — AI agent orchestration",
2382
+ "category": "ai",
2383
+ "package": "@almadar/integrations",
2384
+ "actions": [
2385
+ {
2386
+ "name": "sendMessage",
2387
+ "description": "",
2388
+ "params": [
2389
+ {
2390
+ "name": "message",
2391
+ "type": "string",
2392
+ "required": true,
2393
+ "description": ""
2394
+ },
2395
+ {
2396
+ "name": "threadId",
2397
+ "type": "string",
2398
+ "required": false,
2399
+ "description": ""
2400
+ },
2401
+ {
2402
+ "name": "skill",
2403
+ "type": "string",
2404
+ "required": false,
2405
+ "description": ""
2406
+ },
2407
+ {
2408
+ "name": "context",
2409
+ "type": "object",
2410
+ "required": false,
2411
+ "description": ""
2412
+ }
2413
+ ],
2414
+ "responseShape": {
2415
+ "response": "string",
2416
+ "threadId": "string"
2417
+ }
2418
+ },
2419
+ {
2420
+ "name": "cancelGeneration",
2421
+ "description": "",
2422
+ "params": [
2423
+ {
2424
+ "name": "threadId",
2425
+ "type": "string",
2426
+ "required": true,
2427
+ "description": ""
2428
+ }
2429
+ ],
2430
+ "responseShape": {
2431
+ "cancelled": "boolean"
2432
+ }
2433
+ },
2434
+ {
2435
+ "name": "validateSchema",
2436
+ "description": "",
2437
+ "params": [
2438
+ {
2439
+ "name": "schema",
2440
+ "type": "string",
2441
+ "required": true,
2442
+ "description": ""
2443
+ }
2444
+ ],
2445
+ "responseShape": {
2446
+ "valid": "boolean",
2447
+ "errors": "string[]"
2448
+ }
2449
+ },
2450
+ {
2451
+ "name": "compileSchema",
2452
+ "description": "",
2453
+ "params": [
2454
+ {
2455
+ "name": "schema",
2456
+ "type": "string",
2457
+ "required": true,
2458
+ "description": ""
2459
+ },
2460
+ {
2461
+ "name": "shell",
2462
+ "type": "string",
2463
+ "required": false,
2464
+ "description": ""
2465
+ }
2466
+ ],
2467
+ "responseShape": {
2468
+ "output": "string",
2469
+ "files": "string[]"
2470
+ }
2471
+ },
2472
+ {
2473
+ "name": "getThreadHistory",
2474
+ "description": "",
2475
+ "params": [
2476
+ {
2477
+ "name": "threadId",
2478
+ "type": "string",
2479
+ "required": true,
2480
+ "description": ""
2481
+ }
2482
+ ],
2483
+ "responseShape": {
2484
+ "messages": "array"
2485
+ }
2486
+ }
2487
+ ],
2488
+ "credentials": [
2489
+ {
2490
+ "envVar": "DEEPAGENT_API_URL",
2491
+ "required": true,
2492
+ "description": "DeepAgent server URL"
2493
+ },
2494
+ {
2495
+ "envVar": "DEEPAGENT_API_KEY",
2496
+ "required": false,
2497
+ "description": "DeepAgent API key"
2498
+ }
2499
+ ]
2500
+ }
2501
+ },
2502
+ "categories": [
2503
+ "ai",
2504
+ "auth",
2505
+ "devtools",
2506
+ "infrastructure",
2507
+ "media",
2508
+ "messaging",
2509
+ "payment"
2510
+ ]
2511
+ }