@vibesdotdev/integrations-grok 0.0.0-stage → 1.0.0-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (201) hide show
  1. package/LICENSE +126 -0
  2. package/README.md +43 -2
  3. package/dist/ai/index.d.ts +5 -0
  4. package/dist/ai/index.d.ts.map +1 -0
  5. package/dist/ai/index.js +5 -0
  6. package/dist/ai/index.js.map +1 -0
  7. package/dist/ai/metadata/provider-models/grok/grok-grok-3-mini.json +18 -0
  8. package/dist/ai/metadata/provider-models/grok/grok-grok-3.json +18 -0
  9. package/dist/ai/metadata/provider-models/grok/grok-grok-4-5.json +18 -0
  10. package/dist/ai/metadata/provider-models/grok/grok-grok-4-6.json +18 -0
  11. package/dist/ai/metadata/provider-models/grok/grok-grok-4-7.json +18 -0
  12. package/dist/ai/metadata/provider-models/grok/grok-grok-4-fast.json +18 -0
  13. package/dist/ai/metadata/provider-models/grok/grok-grok-4.json +18 -0
  14. package/dist/ai/metadata/provider-models/grok/grok-grok-code-fast.json +18 -0
  15. package/dist/ai/metadata/provider-models/grok/grok-grok-composer-2-5-fast.json +18 -0
  16. package/dist/ai/metadata/providers/grok.json +8 -0
  17. package/dist/ai/provider.consumer.plugin.d.ts +11 -0
  18. package/dist/ai/provider.consumer.plugin.d.ts.map +1 -0
  19. package/dist/ai/provider.consumer.plugin.js +43 -0
  20. package/dist/ai/provider.consumer.plugin.js.map +1 -0
  21. package/dist/ai/provider.plugin.d.ts +3 -0
  22. package/dist/ai/provider.plugin.d.ts.map +1 -0
  23. package/dist/ai/provider.plugin.js +3 -0
  24. package/dist/ai/provider.plugin.js.map +1 -0
  25. package/dist/ai/provider.shared.plugin.d.ts +6 -0
  26. package/dist/ai/provider.shared.plugin.d.ts.map +1 -0
  27. package/dist/ai/provider.shared.plugin.js +118 -0
  28. package/dist/ai/provider.shared.plugin.js.map +1 -0
  29. package/dist/ai/providers/cloud/frontier/grok/config/config.grok.descriptor.d.ts +4194 -0
  30. package/dist/ai/providers/cloud/frontier/grok/config/config.grok.descriptor.d.ts.map +1 -0
  31. package/dist/ai/providers/cloud/frontier/grok/config/config.grok.descriptor.js +15 -0
  32. package/dist/ai/providers/cloud/frontier/grok/config/config.grok.descriptor.js.map +1 -0
  33. package/dist/ai/providers/cloud/frontier/grok/config/schemas/index.d.ts +67 -0
  34. package/dist/ai/providers/cloud/frontier/grok/config/schemas/index.d.ts.map +1 -0
  35. package/dist/ai/providers/cloud/frontier/grok/config/schemas/index.js +70 -0
  36. package/dist/ai/providers/cloud/frontier/grok/config/schemas/index.js.map +1 -0
  37. package/dist/ai/providers/cloud/frontier/grok/index.d.ts +5 -0
  38. package/dist/ai/providers/cloud/frontier/grok/index.d.ts.map +1 -0
  39. package/dist/ai/providers/cloud/frontier/grok/index.js +4 -0
  40. package/dist/ai/providers/cloud/frontier/grok/index.js.map +1 -0
  41. package/dist/ai/providers/cloud/frontier/grok/provider.grok.descriptor.d.ts +183 -0
  42. package/dist/ai/providers/cloud/frontier/grok/provider.grok.descriptor.d.ts.map +1 -0
  43. package/dist/ai/providers/cloud/frontier/grok/provider.grok.descriptor.js +114 -0
  44. package/dist/ai/providers/cloud/frontier/grok/provider.grok.descriptor.js.map +1 -0
  45. package/dist/ai/providers/grok/detection/index.d.ts +2 -0
  46. package/dist/ai/providers/grok/detection/index.d.ts.map +1 -0
  47. package/dist/ai/providers/grok/detection/index.js +2 -0
  48. package/dist/ai/providers/grok/detection/index.js.map +1 -0
  49. package/dist/ai/providers/grok/detection/system.d.ts +11 -0
  50. package/dist/ai/providers/grok/detection/system.d.ts.map +1 -0
  51. package/dist/ai/providers/grok/detection/system.js +78 -0
  52. package/dist/ai/providers/grok/detection/system.js.map +1 -0
  53. package/dist/ai/providers/grok/docs/ai.providers.grok.docs.descriptor.d.ts +4 -0
  54. package/dist/ai/providers/grok/docs/ai.providers.grok.docs.descriptor.d.ts.map +1 -0
  55. package/dist/ai/providers/grok/docs/ai.providers.grok.docs.descriptor.js +21 -0
  56. package/dist/ai/providers/grok/docs/ai.providers.grok.docs.descriptor.js.map +1 -0
  57. package/dist/ai/providers/grok/grok-agent/budget.d.ts +14 -0
  58. package/dist/ai/providers/grok/grok-agent/budget.d.ts.map +1 -0
  59. package/dist/ai/providers/grok/grok-agent/budget.js +23 -0
  60. package/dist/ai/providers/grok/grok-agent/budget.js.map +1 -0
  61. package/dist/ai/providers/grok/grok-agent/connection.d.ts +36 -0
  62. package/dist/ai/providers/grok/grok-agent/connection.d.ts.map +1 -0
  63. package/dist/ai/providers/grok/grok-agent/connection.js +137 -0
  64. package/dist/ai/providers/grok/grok-agent/connection.js.map +1 -0
  65. package/dist/ai/providers/grok/grok-agent/failures.d.ts +12 -0
  66. package/dist/ai/providers/grok/grok-agent/failures.d.ts.map +1 -0
  67. package/dist/ai/providers/grok/grok-agent/failures.js +47 -0
  68. package/dist/ai/providers/grok/grok-agent/failures.js.map +1 -0
  69. package/dist/ai/providers/grok/grok-agent/grok-agent.spec.descriptor.d.ts +29 -0
  70. package/dist/ai/providers/grok/grok-agent/grok-agent.spec.descriptor.d.ts.map +1 -0
  71. package/dist/ai/providers/grok/grok-agent/grok-agent.spec.descriptor.js +18 -0
  72. package/dist/ai/providers/grok/grok-agent/grok-agent.spec.descriptor.js.map +1 -0
  73. package/dist/ai/providers/grok/grok-agent/grok-agent.spec.impl.d.ts +32 -0
  74. package/dist/ai/providers/grok/grok-agent/grok-agent.spec.impl.d.ts.map +1 -0
  75. package/dist/ai/providers/grok/grok-agent/grok-agent.spec.impl.js +113 -0
  76. package/dist/ai/providers/grok/grok-agent/grok-agent.spec.impl.js.map +1 -0
  77. package/dist/ai/providers/grok/grok-agent/grok-agent.transport.descriptor.d.ts +13 -0
  78. package/dist/ai/providers/grok/grok-agent/grok-agent.transport.descriptor.d.ts.map +1 -0
  79. package/dist/ai/providers/grok/grok-agent/grok-agent.transport.descriptor.js +11 -0
  80. package/dist/ai/providers/grok/grok-agent/grok-agent.transport.descriptor.js.map +1 -0
  81. package/dist/ai/providers/grok/grok-agent/grok-agent.transport.impl.consumer.d.ts +39 -0
  82. package/dist/ai/providers/grok/grok-agent/grok-agent.transport.impl.consumer.d.ts.map +1 -0
  83. package/dist/ai/providers/grok/grok-agent/grok-agent.transport.impl.consumer.js +79 -0
  84. package/dist/ai/providers/grok/grok-agent/grok-agent.transport.impl.consumer.js.map +1 -0
  85. package/dist/ai/providers/grok/grok-agent/protocol.d.ts +117 -0
  86. package/dist/ai/providers/grok/grok-agent/protocol.d.ts.map +1 -0
  87. package/dist/ai/providers/grok/grok-agent/protocol.js +84 -0
  88. package/dist/ai/providers/grok/grok-agent/protocol.js.map +1 -0
  89. package/dist/ai/providers/grok/grok-agent/runtime-execution.d.ts +14 -0
  90. package/dist/ai/providers/grok/grok-agent/runtime-execution.d.ts.map +1 -0
  91. package/dist/ai/providers/grok/grok-agent/runtime-execution.js +42 -0
  92. package/dist/ai/providers/grok/grok-agent/runtime-execution.js.map +1 -0
  93. package/dist/ai/providers/grok/grok-agent/session.d.ts +12 -0
  94. package/dist/ai/providers/grok/grok-agent/session.d.ts.map +1 -0
  95. package/dist/ai/providers/grok/grok-agent/session.js +140 -0
  96. package/dist/ai/providers/grok/grok-agent/session.js.map +1 -0
  97. package/dist/ai/providers/grok/grok-build.request.d.ts +7 -0
  98. package/dist/ai/providers/grok/grok-build.request.d.ts.map +1 -0
  99. package/dist/ai/providers/grok/grok-build.request.js +11 -0
  100. package/dist/ai/providers/grok/grok-build.request.js.map +1 -0
  101. package/dist/ai/providers/grok/grok-build.transport.descriptor.d.ts +13 -0
  102. package/dist/ai/providers/grok/grok-build.transport.descriptor.d.ts.map +1 -0
  103. package/dist/ai/providers/grok/grok-build.transport.descriptor.js +11 -0
  104. package/dist/ai/providers/grok/grok-build.transport.descriptor.js.map +1 -0
  105. package/dist/ai/providers/grok/grok-build.transport.impl.consumer.d.ts +23 -0
  106. package/dist/ai/providers/grok/grok-build.transport.impl.consumer.d.ts.map +1 -0
  107. package/dist/ai/providers/grok/grok-build.transport.impl.consumer.js +115 -0
  108. package/dist/ai/providers/grok/grok-build.transport.impl.consumer.js.map +1 -0
  109. package/dist/ai/providers/grok/grok-prompt-file.d.ts +16 -0
  110. package/dist/ai/providers/grok/grok-prompt-file.d.ts.map +1 -0
  111. package/dist/ai/providers/grok/grok-prompt-file.js +43 -0
  112. package/dist/ai/providers/grok/grok-prompt-file.js.map +1 -0
  113. package/dist/ai/providers/grok/grok-refusals.d.ts +149 -0
  114. package/dist/ai/providers/grok/grok-refusals.d.ts.map +1 -0
  115. package/dist/ai/providers/grok/grok-refusals.js +159 -0
  116. package/dist/ai/providers/grok/grok-refusals.js.map +1 -0
  117. package/dist/ai/providers/grok/grok-sandbox-signal.d.ts +30 -0
  118. package/dist/ai/providers/grok/grok-sandbox-signal.d.ts.map +1 -0
  119. package/dist/ai/providers/grok/grok-sandbox-signal.js +46 -0
  120. package/dist/ai/providers/grok/grok-sandbox-signal.js.map +1 -0
  121. package/dist/ai/providers/grok/grok-subscription.d.ts +116 -0
  122. package/dist/ai/providers/grok/grok-subscription.d.ts.map +1 -0
  123. package/dist/ai/providers/grok/grok-subscription.js +473 -0
  124. package/dist/ai/providers/grok/grok-subscription.js.map +1 -0
  125. package/dist/ai/providers/grok/grok.provider.impl.d.ts +47 -0
  126. package/dist/ai/providers/grok/grok.provider.impl.d.ts.map +1 -0
  127. package/dist/ai/providers/grok/grok.provider.impl.js +202 -0
  128. package/dist/ai/providers/grok/grok.provider.impl.js.map +1 -0
  129. package/dist/ai/providers/grok/index.d.ts +3 -0
  130. package/dist/ai/providers/grok/index.d.ts.map +1 -0
  131. package/dist/ai/providers/grok/index.js +3 -0
  132. package/dist/ai/providers/grok/index.js.map +1 -0
  133. package/dist/ai/providers/grok/recommendations.d.ts +23 -0
  134. package/dist/ai/providers/grok/recommendations.d.ts.map +1 -0
  135. package/dist/ai/providers/grok/recommendations.js +21 -0
  136. package/dist/ai/providers/grok/recommendations.js.map +1 -0
  137. package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.descriptor.d.ts +32 -0
  138. package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.descriptor.d.ts.map +1 -0
  139. package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.descriptor.js +21 -0
  140. package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.descriptor.js.map +1 -0
  141. package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.impl.d.ts +36 -0
  142. package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.impl.d.ts.map +1 -0
  143. package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.impl.js +78 -0
  144. package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.impl.js.map +1 -0
  145. package/dist/ai/specs/grok-messages.d.ts +20 -0
  146. package/dist/ai/specs/grok-messages.d.ts.map +1 -0
  147. package/dist/ai/specs/grok-messages.js +79 -0
  148. package/dist/ai/specs/grok-messages.js.map +1 -0
  149. package/dist/external/external.plugin.d.ts +3 -0
  150. package/dist/external/external.plugin.d.ts.map +1 -0
  151. package/dist/external/external.plugin.js +23 -0
  152. package/dist/external/external.plugin.js.map +1 -0
  153. package/dist/external/grok-build/index.d.ts +162 -0
  154. package/dist/external/grok-build/index.d.ts.map +1 -0
  155. package/dist/external/grok-build/index.js +7 -0
  156. package/dist/external/grok-build/index.js.map +1 -0
  157. package/dist/external/grok-build/manifest.d.ts +6 -0
  158. package/dist/external/grok-build/manifest.d.ts.map +1 -0
  159. package/dist/external/grok-build/manifest.js +91 -0
  160. package/dist/external/grok-build/manifest.js.map +1 -0
  161. package/dist/external/grok-build-presets.d.ts +210 -0
  162. package/dist/external/grok-build-presets.d.ts.map +1 -0
  163. package/dist/external/grok-build-presets.js +46 -0
  164. package/dist/external/grok-build-presets.js.map +1 -0
  165. package/dist/external/grok-subscription.operation.descriptors.d.ts +57 -0
  166. package/dist/external/grok-subscription.operation.descriptors.d.ts.map +1 -0
  167. package/dist/external/grok-subscription.operation.descriptors.js +22 -0
  168. package/dist/external/grok-subscription.operation.descriptors.js.map +1 -0
  169. package/dist/external/grok-subscription.operations.d.ts +4 -0
  170. package/dist/external/grok-subscription.operations.d.ts.map +1 -0
  171. package/dist/external/grok-subscription.operations.js +73 -0
  172. package/dist/external/grok-subscription.operations.js.map +1 -0
  173. package/dist/external/index.d.ts +3 -0
  174. package/dist/external/index.d.ts.map +1 -0
  175. package/dist/external/index.js +3 -0
  176. package/dist/external/index.js.map +1 -0
  177. package/dist/index.d.ts +2 -0
  178. package/dist/index.d.ts.map +1 -0
  179. package/dist/index.js +2 -0
  180. package/dist/index.js.map +1 -0
  181. package/dist/outcome.d.ts +9 -0
  182. package/dist/outcome.d.ts.map +1 -0
  183. package/dist/outcome.js +8 -0
  184. package/dist/outcome.js.map +1 -0
  185. package/dist/schemas/health.d.ts +20 -0
  186. package/dist/schemas/health.d.ts.map +1 -0
  187. package/dist/schemas/health.js +17 -0
  188. package/dist/schemas/health.js.map +1 -0
  189. package/dist/schemas/output.d.ts +8 -0
  190. package/dist/schemas/output.d.ts.map +1 -0
  191. package/dist/schemas/output.js +10 -0
  192. package/dist/schemas/output.js.map +1 -0
  193. package/dist/schemas/refusal.d.ts +6 -0
  194. package/dist/schemas/refusal.d.ts.map +1 -0
  195. package/dist/schemas/refusal.js +6 -0
  196. package/dist/schemas/refusal.js.map +1 -0
  197. package/dist/schemas/subscription.d.ts +42 -0
  198. package/dist/schemas/subscription.d.ts.map +1 -0
  199. package/dist/schemas/subscription.js +36 -0
  200. package/dist/schemas/subscription.js.map +1 -0
  201. package/package.json +104 -4
package/LICENSE ADDED
@@ -0,0 +1,126 @@
1
+ Business Source License 1.1
2
+
3
+ Parameters
4
+
5
+ Licensor: VIBES DEV LLC
6
+ Licensed Work: @vibesdotdev/integrations-grok
7
+ The Licensed Work is (c) 2026 VIBES DEV LLC.
8
+ Additional Use Grant: In this grant, "Vibes Platform" means the hosted services VIBES DEV LLC
9
+ operates at vibes.dev and its subdomains.
10
+
11
+ You may make production use of the Licensed Work, including commercial
12
+ use, subject to the limits below. Permitted production use includes:
13
+ building, operating and selling your own applications, agents and services
14
+ on or with the Vibes Platform; self-hosting the Licensed Work for use inside
15
+ your own organization; and providing consulting, integration or development
16
+ services to clients who build on the Vibes Platform.
17
+
18
+ The production use permitted above does not include use that:
19
+
20
+ (a) offers third parties a hosted, managed or embedded service that
21
+ substitutes for the Vibes Platform or a material part of it (including
22
+ agent hosting; fleet, sandbox or container provisioning; package
23
+ registry; source hosting and continuous integration; and managed AI,
24
+ storage, secrets or messaging), where the Licensed Work provides a
25
+ material part of that service's value and that service earns more than
26
+ US$1,000,000 in gross revenue in any twelve-month period;
27
+ (b) sells, rents, sublicenses or white-labels the Licensed Work, or access
28
+ to Vibes Platform functionality, as a product in its own right;
29
+ (c) removes, disables or works around entitlement checks, usage metering,
30
+ quotas or plan limits, or reaches Vibes Platform features the user's
31
+ account is not entitled to;
32
+ (d) scrapes, bulk-exports or harvests data or content from the Vibes
33
+ Platform or its users other than through documented interfaces and
34
+ within their terms, or uses outputs or data obtained from the Vibes
35
+ Platform to train or improve a product that competes with it;
36
+ (e) violates applicable law, infringes anyone's rights, commits fraud or
37
+ deception, conducts unlawful surveillance or harassment, distributes
38
+ malware, or accesses systems without authorization; or
39
+ (f) violates applicable antitrust or competition law.
40
+
41
+ A written permission from the Licensor extends this grant.
42
+ Change Date: Four years from the date the Licensed Work is published.
43
+ Change License: MIT
44
+
45
+ For information about alternative licensing arrangements for the Licensed Work,
46
+ contact VIBES DEV LLC through https://vibes.dev.
47
+
48
+ Notice
49
+
50
+ The Business Source License (this document, or the "License") is not an Open
51
+ Source license. However, the Licensed Work will eventually be made available
52
+ under an Open Source License, as stated in this License.
53
+
54
+ -----------------------------------------------------------------------------
55
+
56
+ Business Source License 1.1
57
+
58
+ License text copyright © 2017 MariaDB Corporation Ab, All Rights Reserved.
59
+ "Business Source License" is a trademark of MariaDB Corporation Ab.
60
+
61
+ Terms
62
+
63
+ The Licensor hereby grants you the right to copy, modify, create derivative
64
+ works, redistribute, and make non-production use of the Licensed Work. The
65
+ Licensor may make an Additional Use Grant, above, permitting limited
66
+ production use.
67
+
68
+ Effective on the Change Date, or the fourth anniversary of the first publicly
69
+ available distribution of a specific version of the Licensed Work under this
70
+ License, whichever comes first, the Licensor hereby grants you rights under
71
+ the terms of the Change License, and the rights granted in the paragraph
72
+ above terminate.
73
+
74
+ If your use of the Licensed Work does not comply with the requirements
75
+ currently in effect as described in this License, you must purchase a
76
+ commercial license from the Licensor, its affiliated entities, or authorized
77
+ resellers, or you must refrain from using the Licensed Work.
78
+
79
+ All copies of the original and modified Licensed Work, and derivative works
80
+ of the Licensed Work, are subject to this License. This License applies
81
+ separately for each version of the Licensed Work and the Change Date may vary
82
+ for each version of the Licensed Work released by Licensor.
83
+
84
+ You must conspicuously display this License on each original or modified copy
85
+ of the Licensed Work. If you receive the Licensed Work in original or
86
+ modified form from a third party, the terms and conditions set forth in this
87
+ License apply to your use of that work.
88
+
89
+ Any use of the Licensed Work in violation of this License will automatically
90
+ terminate your rights under this License for the current and all other
91
+ versions of the Licensed Work.
92
+
93
+ This License does not grant you any right in any trademark or logo of
94
+ Licensor or its affiliates (provided that you may use a trademark or logo of
95
+ Licensor as expressly required by this License).
96
+
97
+ TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
98
+ AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
99
+ EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
100
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
101
+ TITLE.
102
+
103
+ MariaDB hereby grants you permission to use this License’s text to license
104
+ your works, and to refer to it using the trademark “Business Source License”,
105
+ as long as you comply with the Covenants of Licensor below.
106
+
107
+ Covenants of Licensor
108
+
109
+ In consideration of the right to use this License’s text and the “Business
110
+ Source License” name and trademark, Licensor covenants to MariaDB, and to all
111
+ other recipients of the licensed work to be provided by Licensor:
112
+
113
+ 1. To specify as the Change License the GPL Version 2.0 or any later version,
114
+ or a license that is compatible with GPL Version 2.0 or a later version,
115
+ where “compatible” means that software provided under the Change License can
116
+ be included in a program with software provided under GPL Version 2.0 or a
117
+ later version. Licensor may specify additional Change Licenses without
118
+ limitation.
119
+
120
+ 2. To either: (a) specify an additional grant of rights to use that does not
121
+ impose any additional restriction on the right granted in this License, as
122
+ the Additional Use Grant; or (b) insert the text “None”.
123
+
124
+ 3. To specify a Change Date.
125
+
126
+ 4. Not to modify this License in any other way.
package/README.md CHANGED
@@ -1,3 +1,44 @@
1
- # Temporary Holding Version
1
+ # @vibesdotdev/integrations-grok
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ xAI Grok for Vibes: the provider identity, connection schema, detection,
4
+ recommendations, docs, and the two subscription transports that reuse the
5
+ official Grok Build CLI. The contract is [SPEC.md](./SPEC.md); this page is the
6
+ map.
7
+
8
+ ## Entry points
9
+
10
+ | Export | What it is |
11
+ |---|---|
12
+ | `@vibesdotdev/integrations-grok` | Isomorphic connection schemas, descriptors, detection helpers and docs |
13
+ | `@vibesdotdev/integrations-grok/ai/plugin` | Compatible complete consumer plugin: shared assets plus both subscription transports |
14
+ | `@vibesdotdev/integrations-grok/ai/shared.plugin` | Scope-pure shared provider, recommendation, schemas, specs and model assets for cloud/browser hosts; no consumer transport loaders |
15
+ | `@vibesdotdev/integrations-grok/ai/consumer.plugin` | Explicit complete consumer composition (same as `/ai/plugin`) |
16
+ | `@vibesdotdev/integrations-grok/ai/providers/grok/grok.provider.impl` | Explicit concrete provider class compatibility subpath; normal callers resolve `ai/provider` |
17
+ | `@vibesdotdev/integrations-grok/external/plugin` | The `grok-build` external host with `vibes dev external grok login` and `status` |
18
+
19
+ ## Routes
20
+
21
+ - `grok-agent` (priority 200): an ACP session over `grok agent stdio`, driven by
22
+ the shared `@vibesdotdev/external/jsonrpc` client. Sandboxed
23
+ (`--sandbox read-only --permission-mode dontAsk`), one process per call.
24
+ - `grok-build-cli` (priority 100): a tool-less text turn, `grok --prompt-file`,
25
+ with the prompt in a private file inside the dedicated profile.
26
+ - `chat` (priority 10): the metered API-key route, on the OpenAI-compatible chat spec.
27
+
28
+ The subscription routes use a dedicated `GROK_HOME` under the runtime's data
29
+ directory. The package never reads `auth.json`, copies a token, or accepts API
30
+ credentials on a subscription transport.
31
+
32
+ ## Gates
33
+
34
+ ```sh
35
+ bun run check # typechecks source and tests, TS and TSX (tsconfig.json, noEmit)
36
+ bun test src
37
+ bun run test:node # real Node: every export, and the ACP session against a fake agent child
38
+ bun run build # tsconfig.build.json emits production files only
39
+ ```
40
+
41
+ Specs and recommendations are created by runtime loaders. The semantic client is
42
+ `@vibesdotdev/ai`'s `runtime/client` (`ai`); Grok adds no separate client or cache.
43
+ Boundary schemas live in `src/schemas/` and the connection schema directory.
44
+ Cloud transport resolution fails typed with `NOT_FOUND / not-registered`.
@@ -0,0 +1,5 @@
1
+ /** Canonical grok AI schemas. */
2
+ export * from './providers/cloud/frontier/grok/config/schemas/index.ts';
3
+ export * from './providers/cloud/frontier/grok/index.ts';
4
+ export * from './providers/grok/index.ts';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,cAAc,yDAAyD,CAAC;AACxE,cAAc,0CAA0C,CAAC;AACzD,cAAc,2BAA2B,CAAC"}
@@ -0,0 +1,5 @@
1
+ /** Canonical grok AI schemas. */
2
+ export * from "./providers/cloud/frontier/grok/config/schemas/index.js";
3
+ export * from "./providers/cloud/frontier/grok/index.js";
4
+ export * from "./providers/grok/index.js";
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,cAAc,yDAAyD,CAAC;AACxE,cAAc,0CAA0C,CAAC;AACzD,cAAc,2BAA2B,CAAC"}
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "grok:grok-3-mini",
3
+ "providerId": "grok",
4
+ "providerModelId": "grok-3-mini",
5
+ "aliases": ["grok-3-mini", "grok:grok-3-mini"],
6
+ "globalModelId": "grok:grok-3-mini",
7
+ "source": "curated",
8
+ "displayName": "Grok 3 Mini",
9
+ "description": "Lightweight, highly efficient reasoning model for cost-effective execution.",
10
+ "modelType": "llm_chat",
11
+ "capabilities": ["chat_completion", "text_generation", "code_generation", "function_calling"],
12
+ "modalities": ["text"],
13
+ "tokenLimit": 1048576,
14
+ "configuration": { "modelId": "grok-3-mini", "maxTokens": 131072, "contextLength": 1048576 },
15
+ "hardware": ["consumer", "cloud"],
16
+ "enabled": true,
17
+ "tags": ["grok", "xai", "mini", "efficient", "grok-cli", "api-key"]
18
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "grok:grok-3",
3
+ "providerId": "grok",
4
+ "providerModelId": "grok-3",
5
+ "aliases": ["grok-3", "grok:grok-3"],
6
+ "globalModelId": "grok:grok-3",
7
+ "source": "curated",
8
+ "displayName": "Grok 3",
9
+ "description": "Advanced reasoning model with deep knowledge integration.",
10
+ "modelType": "llm_chat",
11
+ "capabilities": ["chat_completion", "text_generation", "code_generation", "function_calling"],
12
+ "modalities": ["text"],
13
+ "tokenLimit": 1048576,
14
+ "configuration": { "modelId": "grok-3", "maxTokens": 131072, "contextLength": 1048576 },
15
+ "hardware": ["consumer", "cloud"],
16
+ "enabled": true,
17
+ "tags": ["grok", "xai", "reasoning", "grok-cli", "api-key"]
18
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "grok:grok-4.5",
3
+ "providerId": "grok",
4
+ "providerModelId": "grok-4.5",
5
+ "aliases": ["grok-4.5", "grok:grok-4.5"],
6
+ "globalModelId": "grok:grok-4.5",
7
+ "source": "curated",
8
+ "displayName": "Grok 4.5",
9
+ "description": "Previous frontier tier of the Grok Build subscription.",
10
+ "modelType": "llm_chat",
11
+ "capabilities": ["chat_completion", "text_generation", "code_generation", "function_calling"],
12
+ "modalities": ["text"],
13
+ "tokenLimit": 2097152,
14
+ "configuration": { "modelId": "grok-4.5", "maxTokens": 131072, "contextLength": 2097152 },
15
+ "hardware": ["consumer", "cloud"],
16
+ "enabled": true,
17
+ "tags": ["grok", "xai", "frontier", "grok-cli", "subscription", "api-key"]
18
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "grok:grok-4.6",
3
+ "providerId": "grok",
4
+ "providerModelId": "grok-4.6",
5
+ "aliases": ["grok-4.6", "grok:grok-4.6"],
6
+ "globalModelId": "grok:grok-4.6",
7
+ "source": "curated",
8
+ "displayName": "Grok 4.6",
9
+ "description": "Default model of the Grok Build subscription; frontier reasoning and coding.",
10
+ "modelType": "llm_chat",
11
+ "capabilities": ["chat_completion", "text_generation", "code_generation", "function_calling"],
12
+ "modalities": ["text"],
13
+ "tokenLimit": 2097152,
14
+ "configuration": { "modelId": "grok-4.6", "maxTokens": 131072, "contextLength": 2097152 },
15
+ "hardware": ["consumer", "cloud"],
16
+ "enabled": true,
17
+ "tags": ["grok", "xai", "frontier", "grok-cli", "subscription", "api-key"]
18
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "grok:grok-4.7",
3
+ "providerId": "grok",
4
+ "providerModelId": "grok-4.7",
5
+ "aliases": ["grok-4.7", "grok:grok-4.7"],
6
+ "globalModelId": "grok:grok-4.7",
7
+ "source": "curated",
8
+ "displayName": "Grok 4.7",
9
+ "description": "Current Grok Build and xAI API flagship for coding and agentic work. 500k context, text and image input.",
10
+ "modelType": "llm_chat",
11
+ "capabilities": ["chat_completion", "text_generation", "code_generation", "function_calling", "image_understanding"],
12
+ "modalities": ["text"],
13
+ "tokenLimit": 500000,
14
+ "configuration": { "modelId": "grok-4.7", "maxTokens": 131072, "contextLength": 500000 },
15
+ "hardware": ["consumer", "cloud"],
16
+ "enabled": true,
17
+ "tags": ["grok", "xai", "frontier", "grok-cli", "subscription", "api-key"]
18
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "grok:grok-4-fast",
3
+ "providerId": "grok",
4
+ "providerModelId": "grok-4-fast",
5
+ "aliases": ["grok-4-fast", "grok:grok-4-fast"],
6
+ "globalModelId": "grok:grok-4-fast",
7
+ "source": "curated",
8
+ "displayName": "Grok 4 Fast",
9
+ "description": "High-speed frontier reasoning model optimized for real-time responsiveness.",
10
+ "modelType": "llm_chat",
11
+ "capabilities": ["chat_completion", "text_generation", "code_generation", "function_calling"],
12
+ "modalities": ["text"],
13
+ "tokenLimit": 2097152,
14
+ "configuration": { "modelId": "grok-4-fast", "maxTokens": 131072, "contextLength": 2097152 },
15
+ "hardware": ["consumer", "cloud"],
16
+ "enabled": true,
17
+ "tags": ["grok", "xai", "fast", "frontier", "grok-cli", "api-key"]
18
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "grok:grok-4",
3
+ "providerId": "grok",
4
+ "providerModelId": "grok-4",
5
+ "aliases": ["grok-4", "grok:grok-4"],
6
+ "globalModelId": "grok:grok-4",
7
+ "source": "curated",
8
+ "displayName": "Grok 4",
9
+ "description": "Flagship frontier multimodal reasoning and text generation model by xAI.",
10
+ "modelType": "llm_chat",
11
+ "capabilities": ["chat_completion", "text_generation", "code_generation", "function_calling"],
12
+ "modalities": ["text"],
13
+ "tokenLimit": 2097152,
14
+ "configuration": { "modelId": "grok-4", "maxTokens": 131072, "contextLength": 2097152 },
15
+ "hardware": ["consumer", "cloud"],
16
+ "enabled": true,
17
+ "tags": ["grok", "xai", "frontier", "grok-cli", "api-key"]
18
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "grok:grok-code-fast",
3
+ "providerId": "grok",
4
+ "providerModelId": "grok-code-fast",
5
+ "aliases": ["grok-code-fast", "grok:grok-code-fast"],
6
+ "globalModelId": "grok:grok-code-fast",
7
+ "source": "curated",
8
+ "displayName": "Grok Code Fast",
9
+ "description": "Specialized high-throughput code synthesis and refactoring model.",
10
+ "modelType": "llm_chat",
11
+ "capabilities": ["chat_completion", "text_generation", "code_generation"],
12
+ "modalities": ["text"],
13
+ "tokenLimit": 524288,
14
+ "configuration": { "modelId": "grok-code-fast", "maxTokens": 65536, "contextLength": 524288 },
15
+ "hardware": ["consumer", "cloud"],
16
+ "enabled": true,
17
+ "tags": ["grok", "xai", "code", "grok-cli", "api-key"]
18
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "grok:grok-composer-2.5-fast",
3
+ "providerId": "grok",
4
+ "providerModelId": "grok-composer-2.5-fast",
5
+ "aliases": ["grok-composer-2.5-fast", "grok:grok-composer-2.5-fast"],
6
+ "globalModelId": "grok:grok-composer-2.5-fast",
7
+ "source": "curated",
8
+ "displayName": "Grok Composer 2.5 Fast",
9
+ "description": "Fast creative and structured generation model.",
10
+ "modelType": "llm_chat",
11
+ "capabilities": ["chat_completion", "text_generation", "code_generation"],
12
+ "modalities": ["text"],
13
+ "tokenLimit": 524288,
14
+ "configuration": { "modelId": "grok-composer-2.5-fast", "maxTokens": 65536, "contextLength": 524288 },
15
+ "hardware": ["consumer", "cloud"],
16
+ "enabled": true,
17
+ "tags": ["grok", "xai", "composer", "grok-cli", "api-key"]
18
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "id": "grok",
3
+ "name": "Grok (xAI)",
4
+ "baseUrl": "https://api.x.ai/v1",
5
+ "compatibleKindId": "openai-compatible",
6
+ "docsUrl": "https://docs.x.ai/developers",
7
+ "sourceUrls": ["https://docs.x.ai/developers/models"]
8
+ }
@@ -0,0 +1,11 @@
1
+ import { type RuntimePlugin } from '@vibesdotdev/kernel';
2
+ /**
3
+ * Complete consumer composition: both subscription transports and the specs
4
+ * that drive them. The specs speak to the local `grok` binary (stdio JSON-RPC,
5
+ * headless prompt files), so they live here, never in the shared slice that
6
+ * cloud and browser hosts compose.
7
+ */
8
+ export declare function createGrokAIPlugin(): RuntimePlugin;
9
+ export declare const grokAIPlugin: RuntimePlugin;
10
+ export default grokAIPlugin;
11
+ //# sourceMappingURL=provider.consumer.plugin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider.consumer.plugin.d.ts","sourceRoot":"","sources":["../../src/ai/provider.consumer.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAO9E;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CAyClD;AACD,eAAO,MAAM,YAAY,eAAuB,CAAC;AACjD,eAAe,YAAY,CAAC"}
@@ -0,0 +1,43 @@
1
+ import { createRuntimePlugin } from '@vibesdotdev/kernel';
2
+ import { createGrokSharedAIPlugin } from "./provider.shared.plugin.js";
3
+ import grokBuildTransportDescriptor from "./providers/grok/grok-build.transport.descriptor.js";
4
+ import grokAgentTransportDescriptor from "./providers/grok/grok-agent/grok-agent.transport.descriptor.js";
5
+ import grokBuildExecDescriptor from "./specs/grok-build-exec/grok-build-exec.spec.descriptor.js";
6
+ import grokAgentSpecDescriptor from "./providers/grok/grok-agent/grok-agent.spec.descriptor.js";
7
+ /**
8
+ * Complete consumer composition: both subscription transports and the specs
9
+ * that drive them. The specs speak to the local `grok` binary (stdio JSON-RPC,
10
+ * headless prompt files), so they live here, never in the shared slice that
11
+ * cloud and browser hosts compose.
12
+ */
13
+ export function createGrokAIPlugin() {
14
+ return createRuntimePlugin({
15
+ id: 'integrations-grok/ai',
16
+ name: 'Grok consumer AI',
17
+ async onRegister(runtime) {
18
+ await runtime.registerPlugin(createGrokSharedAIPlugin());
19
+ runtime.registerDescriptor('ai/transport', grokBuildTransportDescriptor);
20
+ runtime.registerDescriptor('ai/transport', grokAgentTransportDescriptor);
21
+ runtime.registerDescriptor('ai/spec', grokBuildExecDescriptor);
22
+ runtime.registerDescriptor('ai/spec', grokAgentSpecDescriptor);
23
+ },
24
+ onActivate(runtime) {
25
+ runtime.registerLoader('ai/transport', grokBuildTransportDescriptor.id, async () => ({
26
+ impl: new (await import("./providers/grok/grok-build.transport.impl.consumer.js")).GrokBuildTransport(runtime)
27
+ }), { constraint: { hardware: ['consumer'] } });
28
+ runtime.registerLoader('ai/transport', grokAgentTransportDescriptor.id, async () => {
29
+ const { createRuntimeGrokAgentTransport } = await import("./providers/grok/grok-agent/runtime-execution.js");
30
+ return { impl: await createRuntimeGrokAgentTransport(runtime) };
31
+ }, { constraint: { hardware: ['consumer'] } });
32
+ runtime.registerLoader('ai/spec', grokBuildExecDescriptor.id, async () => ({
33
+ impl: new (await import("./specs/grok-build-exec/grok-build-exec.spec.impl.js")).default()
34
+ }));
35
+ runtime.registerLoader('ai/spec', grokAgentSpecDescriptor.id, async () => ({
36
+ impl: new (await import("./providers/grok/grok-agent/grok-agent.spec.impl.js")).default()
37
+ }));
38
+ }
39
+ });
40
+ }
41
+ export const grokAIPlugin = createGrokAIPlugin();
42
+ export default grokAIPlugin;
43
+ //# sourceMappingURL=provider.consumer.plugin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider.consumer.plugin.js","sourceRoot":"","sources":["../../src/ai/provider.consumer.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAsB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,4BAA4B,MAAM,qDAAqD,CAAC;AAC/F,OAAO,4BAA4B,MAAM,gEAAgE,CAAC;AAC1G,OAAO,uBAAuB,MAAM,4DAA4D,CAAC;AACjG,OAAO,uBAAuB,MAAM,2DAA2D,CAAC;AAEhG;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IACjC,OAAO,mBAAmB,CAAC;QAC1B,EAAE,EAAE,sBAAsB;QAC1B,IAAI,EAAE,kBAAkB;QACxB,KAAK,CAAC,UAAU,CAAC,OAAO;YACvB,MAAM,OAAO,CAAC,cAAc,CAAC,wBAAwB,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,kBAAkB,CAAC,cAAc,EAAE,4BAA4B,CAAC,CAAC;YACzE,OAAO,CAAC,kBAAkB,CAAC,cAAc,EAAE,4BAA4B,CAAC,CAAC;YACzE,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;YAC/D,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;QAChE,CAAC;QACD,UAAU,CAAC,OAAO;YACjB,OAAO,CAAC,cAAc,CACrB,cAAc,EACd,4BAA4B,CAAC,EAAE,EAC/B,KAAK,IAAI,EAAE,CAAC,CAAC;gBACZ,IAAI,EAAE,IAAI,CACT,MAAM,MAAM,CAAC,wDAAwD,CAAC,CACtE,CAAC,kBAAkB,CAAC,OAAO,CAAC;aAC7B,CAAC,EACF,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,CAC1C,CAAC;YACF,OAAO,CAAC,cAAc,CACrB,cAAc,EACd,4BAA4B,CAAC,EAAE,EAC/B,KAAK,IAAI,EAAE;gBACV,MAAM,EAAE,+BAA+B,EAAE,GAAG,MAAM,MAAM,CACvD,kDAAkD,CAClD,CAAC;gBACF,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC,OAAO,CAAC,EAAE,CAAC;YACjE,CAAC,EACD,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,CAC1C,CAAC;YACF,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,uBAAuB,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBAC1E,IAAI,EAAE,IAAI,CAAC,MAAM,MAAM,CAAC,sDAAsD,CAAC,CAAC,CAAC,OAAO,EAAE;aAC1F,CAAC,CAAC,CAAC;YACJ,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,uBAAuB,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBAC1E,IAAI,EAAE,IAAI,CAAC,MAAM,MAAM,CAAC,qDAAqD,CAAC,CAAC,CAAC,OAAO,EAAE;aACzF,CAAC,CAAC,CAAC;QACL,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;AACjD,eAAe,YAAY,CAAC"}
@@ -0,0 +1,3 @@
1
+ /** Compatible complete consumer entrypoint. Cloud/browser hosts use ./provider.shared.plugin. */
2
+ export { createGrokAIPlugin, grokAIPlugin, default } from './provider.consumer.plugin.ts';
3
+ //# sourceMappingURL=provider.plugin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider.plugin.d.ts","sourceRoot":"","sources":["../../src/ai/provider.plugin.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC"}
@@ -0,0 +1,3 @@
1
+ /** Compatible complete consumer entrypoint. Cloud/browser hosts use ./provider.shared.plugin. */
2
+ export { createGrokAIPlugin, grokAIPlugin, default } from "./provider.consumer.plugin.js";
3
+ //# sourceMappingURL=provider.plugin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider.plugin.js","sourceRoot":"","sources":["../../src/ai/provider.plugin.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC"}
@@ -0,0 +1,6 @@
1
+ import { type RuntimePlugin } from '@vibesdotdev/kernel';
2
+ /** Complete runtime boundary for Grok-owned AI capabilities. */
3
+ export declare function createGrokSharedAIPlugin(): RuntimePlugin;
4
+ export declare const grokSharedAIPlugin: RuntimePlugin;
5
+ export default grokSharedAIPlugin;
6
+ //# sourceMappingURL=provider.shared.plugin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider.shared.plugin.d.ts","sourceRoot":"","sources":["../../src/ai/provider.shared.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAmG9E,gEAAgE;AAChE,wBAAgB,wBAAwB,IAAI,aAAa,CA6DxD;AAED,eAAO,MAAM,kBAAkB,EAAE,aAA0C,CAAC;AAC5E,eAAe,kBAAkB,CAAC"}
@@ -0,0 +1,118 @@
1
+ import { createRuntimePlugin } from '@vibesdotdev/kernel';
2
+ import { AI_PROVIDER_SCHEMA_KIND } from '@vibesdotdev/ai/providers-runtime';
3
+ import { AI_PROVIDER_RECOMMENDATION_KIND, createAIProviderRecommendationDescriptor } from '@vibesdotdev/ai/recommendations';
4
+ import grokProviderDescriptor from "./providers/cloud/frontier/grok/provider.grok.descriptor.js";
5
+ import grokProviderConfigDescriptor from "./providers/cloud/frontier/grok/config/config.grok.descriptor.js";
6
+ import grokDocsDescriptor from "./providers/grok/docs/ai.providers.grok.docs.descriptor.js";
7
+ import { grokConnectionSchema as schema0 } from "./providers/cloud/frontier/grok/config/schemas/index.js";
8
+ import provider_grok from './metadata/providers/grok.json' with { type: 'json' };
9
+ import providerModel_grok_grok_4 from './metadata/provider-models/grok/grok-grok-4.json' with { type: 'json' };
10
+ import providerModel_grok_grok_4_7 from './metadata/provider-models/grok/grok-grok-4-7.json' with { type: 'json' };
11
+ import providerModel_grok_grok_4_6 from './metadata/provider-models/grok/grok-grok-4-6.json' with { type: 'json' };
12
+ import providerModel_grok_grok_4_5 from './metadata/provider-models/grok/grok-grok-4-5.json' with { type: 'json' };
13
+ import providerModel_grok_grok_4_fast from './metadata/provider-models/grok/grok-grok-4-fast.json' with { type: 'json' };
14
+ import providerModel_grok_grok_3 from './metadata/provider-models/grok/grok-grok-3.json' with { type: 'json' };
15
+ import providerModel_grok_grok_3_mini from './metadata/provider-models/grok/grok-grok-3-mini.json' with { type: 'json' };
16
+ import providerModel_grok_grok_composer_2_5_fast from './metadata/provider-models/grok/grok-grok-composer-2-5-fast.json' with { type: 'json' };
17
+ import providerModel_grok_grok_code_fast from './metadata/provider-models/grok/grok-grok-code-fast.json' with { type: 'json' };
18
+ import { AIProviderMetadataSchema, AIProviderModelMetadataSchema } from '@vibesdotdev/ai/metadata/schemas';
19
+ import { toAIModelDescriptor } from '@vibesdotdev/ai/metadata/models';
20
+ const providerDetectionDescriptor = {
21
+ id: 'grok',
22
+ kind: 'ai/provider-detection',
23
+ providerId: 'grok',
24
+ description: `System detection loader for ${'grok'}`
25
+ };
26
+ const providerRecommendationDescriptor = createAIProviderRecommendationDescriptor({
27
+ id: 'grok',
28
+ providerType: 'grok',
29
+ displayName: 'Grok (xAI)',
30
+ name: 'Grok provider recommendation',
31
+ description: 'Scores Grok without embedding vendor policy in Framework',
32
+ hardware: ['consumer', 'cloud'],
33
+ enabled: true,
34
+ tags: ['grok', 'xai', 'cloud']
35
+ });
36
+ const providerDocsDescriptor = grokDocsDescriptor;
37
+ const providerSchemaDescriptor = {
38
+ id: 'integrations/grok/ai/grok',
39
+ kind: AI_PROVIDER_SCHEMA_KIND,
40
+ providerId: 'grok',
41
+ schemaKind: 'connection',
42
+ sourcePath: 'integrations/grok/src/ai/providers/cloud/frontier/grok/config/schemas/index.ts',
43
+ version: '0.1.0-rc.0',
44
+ name: 'Grok (X AI)',
45
+ description: 'xAI Grok models - real-time knowledge with X platform integration. '
46
+ };
47
+ const providerMetadata = AIProviderMetadataSchema.parse(provider_grok);
48
+ const providerModelDescriptor1 = toAIModelDescriptor(AIProviderModelMetadataSchema.parse(providerModel_grok_grok_4), providerMetadata);
49
+ const providerModelDescriptor2 = toAIModelDescriptor(AIProviderModelMetadataSchema.parse(providerModel_grok_grok_4_fast), providerMetadata);
50
+ const providerModelDescriptor3 = toAIModelDescriptor(AIProviderModelMetadataSchema.parse(providerModel_grok_grok_3), providerMetadata);
51
+ const providerModelDescriptor4 = toAIModelDescriptor(AIProviderModelMetadataSchema.parse(providerModel_grok_grok_3_mini), providerMetadata);
52
+ const providerModelDescriptor5 = toAIModelDescriptor(AIProviderModelMetadataSchema.parse(providerModel_grok_grok_composer_2_5_fast), providerMetadata);
53
+ const providerModelDescriptor6 = toAIModelDescriptor(AIProviderModelMetadataSchema.parse(providerModel_grok_grok_code_fast), providerMetadata);
54
+ // Subscription flagships. Grok 4.7 (2026-09-21) is the current Grok Build and
55
+ // API model; 4.6 and 4.5 remain selectable.
56
+ const providerModelDescriptor9 = toAIModelDescriptor(AIProviderModelMetadataSchema.parse(providerModel_grok_grok_4_7), providerMetadata);
57
+ const providerModelDescriptor7 = toAIModelDescriptor(AIProviderModelMetadataSchema.parse(providerModel_grok_grok_4_6), providerMetadata);
58
+ const providerModelDescriptor8 = toAIModelDescriptor(AIProviderModelMetadataSchema.parse(providerModel_grok_grok_4_5), providerMetadata);
59
+ /** Complete runtime boundary for Grok-owned AI capabilities. */
60
+ export function createGrokSharedAIPlugin() {
61
+ return createRuntimePlugin({
62
+ id: 'integrations-grok/ai/shared',
63
+ name: 'Grok AI Integration',
64
+ description: 'Registers Grok-owned AI descriptors and lazy implementations',
65
+ onRegister(runtime) {
66
+ runtime.registerDescriptor('ai/provider', grokProviderDescriptor);
67
+ runtime.registerDescriptor('config/manifest', grokProviderConfigDescriptor);
68
+ runtime.registerDescriptor('ai/provider-detection', providerDetectionDescriptor);
69
+ runtime.registerDescriptor(AI_PROVIDER_SCHEMA_KIND, providerSchemaDescriptor);
70
+ runtime.registerDescriptor(AI_PROVIDER_RECOMMENDATION_KIND, providerRecommendationDescriptor);
71
+ if (runtime.hasKind('docs/topic'))
72
+ runtime.registerDescriptor('docs/topic', providerDocsDescriptor);
73
+ runtime.registerDescriptor('ai/model', providerModelDescriptor9);
74
+ runtime.registerDescriptor('ai/model', providerModelDescriptor7);
75
+ runtime.registerDescriptor('ai/model', providerModelDescriptor8);
76
+ runtime.registerDescriptor('ai/model', providerModelDescriptor1);
77
+ runtime.registerDescriptor('ai/model', providerModelDescriptor2);
78
+ runtime.registerDescriptor('ai/model', providerModelDescriptor3);
79
+ runtime.registerDescriptor('ai/model', providerModelDescriptor4);
80
+ runtime.registerDescriptor('ai/model', providerModelDescriptor5);
81
+ runtime.registerDescriptor('ai/model', providerModelDescriptor6);
82
+ },
83
+ onActivate(runtime) {
84
+ runtime.registerLoader('ai/provider', 'grok', async () => ({
85
+ meta: { id: 'grok', kind: 'ai/provider', priority: 0 },
86
+ impl: (await import("./providers/grok/grok.provider.impl.js")).GrokProviderType
87
+ }));
88
+ runtime.registerLoader('ai/provider-detection', 'grok', async () => ({
89
+ meta: { id: 'grok', kind: 'ai/provider-detection', priority: 0 },
90
+ impl: { detect: async () => (await import("./providers/grok/detection/system.js")).detectGrokSystem(runtime) }
91
+ }));
92
+ runtime.registerLoader(AI_PROVIDER_SCHEMA_KIND, providerSchemaDescriptor.id, async () => ({
93
+ meta: { id: providerSchemaDescriptor.id, kind: AI_PROVIDER_SCHEMA_KIND, priority: 0 },
94
+ impl: {
95
+ connectionSchema: schema0,
96
+ metadata: {
97
+ name: 'Grok (X AI)',
98
+ description: 'xAI Grok models - real-time knowledge with X platform integration. ',
99
+ category: 'cloud',
100
+ capabilities: ['text', 'connection'],
101
+ fields: []
102
+ }
103
+ }
104
+ }));
105
+ runtime.registerLoader(AI_PROVIDER_RECOMMENDATION_KIND, providerRecommendationDescriptor.id, async () => ({
106
+ meta: {
107
+ id: providerRecommendationDescriptor.id,
108
+ kind: AI_PROVIDER_RECOMMENDATION_KIND,
109
+ priority: providerRecommendationDescriptor.priority ?? 0
110
+ },
111
+ impl: new (await import("./providers/grok/recommendations.js")).GrokRecommendation()
112
+ }));
113
+ }
114
+ });
115
+ }
116
+ export const grokSharedAIPlugin = createGrokSharedAIPlugin();
117
+ export default grokSharedAIPlugin;
118
+ //# sourceMappingURL=provider.shared.plugin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider.shared.plugin.js","sourceRoot":"","sources":["../../src/ai/provider.shared.plugin.ts"],"names":[],"mappings":"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"}