@vibesdotdev/integrations-groq 0.0.0-stage → 1.0.0-rc.4

package/LICENSE

@@ -0,0 +1,126 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             VIBES DEV LLC
+Licensed Work:        @vibesdotdev/integrations-groq
+                      The Licensed Work is (c) 2026 VIBES DEV LLC.
+Additional Use Grant: In this grant, "Vibes Platform" means the hosted services VIBES DEV LLC
+                      operates at vibes.dev and its subdomains.
+
+                      You may make production use of the Licensed Work, including commercial
+                      use, subject to the limits below. Permitted production use includes:
+                      building, operating and selling your own applications, agents and services
+                      on or with the Vibes Platform; self-hosting the Licensed Work for use inside
+                      your own organization; and providing consulting, integration or development
+                      services to clients who build on the Vibes Platform.
+
+                      The production use permitted above does not include use that:
+
+                      (a) offers third parties a hosted, managed or embedded service that
+                          substitutes for the Vibes Platform or a material part of it (including
+                          agent hosting; fleet, sandbox or container provisioning; package
+                          registry; source hosting and continuous integration; and managed AI,
+                          storage, secrets or messaging), where the Licensed Work provides a
+                          material part of that service's value and that service earns more than
+                          US$1,000,000 in gross revenue in any twelve-month period;
+                      (b) sells, rents, sublicenses or white-labels the Licensed Work, or access
+                          to Vibes Platform functionality, as a product in its own right;
+                      (c) removes, disables or works around entitlement checks, usage metering,
+                          quotas or plan limits, or reaches Vibes Platform features the user's
+                          account is not entitled to;
+                      (d) scrapes, bulk-exports or harvests data or content from the Vibes
+                          Platform or its users other than through documented interfaces and
+                          within their terms, or uses outputs or data obtained from the Vibes
+                          Platform to train or improve a product that competes with it;
+                      (e) violates applicable law, infringes anyone's rights, commits fraud or
+                          deception, conducts unlawful surveillance or harassment, distributes
+                          malware, or accesses systems without authorization; or
+                      (f) violates applicable antitrust or competition law.
+
+                      A written permission from the Licensor extends this grant.
+Change Date:          Four years from the date the Licensed Work is published.
+Change License:       MIT
+
+For information about alternative licensing arrangements for the Licensed Work,
+contact VIBES DEV LLC through https://vibes.dev.
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+License text copyright © 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark “Business Source License”,
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the “Business
+Source License” name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where “compatible” means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text “None”.
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/README.md

@@ -1,3 +1,29 @@
-# Temporary Holding Version
+# @vibesdotdev/integrations-groq
 
-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.
+Compose `@vibesdotdev/integrations-groq/ai/plugin` with AI's runtime and
+`ai/providers` (plus infra), Config and Storage. Use AI's existing semantic client for generation;
+compose an eligible executor, the fetch transport and the separate
+`openai-chat` spec. Optional `docs/topic` composition adds the Groq topic.
+
+Configure a secret reference, never a plaintext or inline API key:
+
+```ts
+const connection = {
+  apiKey: { source: 'secret', key: 'GROQ_API_KEY' },
+  baseUrl: 'https://api.groq.com/openai/v1',
+  timeout: 60000
+};
+```
+
+The last two fields have those defaults. Health uses the same timeout, accepts
+an operation override and cancellation, releases HTTP bodies and returns fixed
+failure messages. Credential and host refusals propagate with their typed reasons;
+detection treats only credential-not-set and empty credentials as absence.
+
+Root exports are schemas and descriptors. Resolve implementations through AI
+kinds and recommendations through AI's recommendation helpers. Explicit
+`/ai/providers/groq/groq.provider.impl`, `/ai/providers/groq/recommendations`
+and `/ai/providers/groq/detection/system` subpaths remain available.
+Recommendation instances belong to the runtime.
+
+See [SPEC.md](SPEC.md) for validation, health outcomes, composition and checks.

package/dist/ai/index.d.ts

@@ -0,0 +1,4 @@
+/** Canonical groq AI schemas. */
+export * from './providers/cloud/frontier/groq/config/schemas/index.ts';
+export * from './providers/cloud/frontier/groq/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +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"}

package/dist/ai/index.js

@@ -0,0 +1,4 @@
+/** Canonical groq AI schemas. */
+export * from "./providers/cloud/frontier/groq/config/schemas/index.js";
+export * from "./providers/cloud/frontier/groq/index.js";
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,cAAc,yDAAyD,CAAC;AACxE,cAAc,0CAA0C,CAAC"}

package/dist/ai/metadata/assets/logos/providers/groq.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" width="33" height="33" viewBox="0 0 33 33"><g clip-path="url(#a)"><path fill="#F43E01" d="M.54.39h32v32h-32z"/><path fill="#fff" d="m18.445 4.406-9.468 13.74 7.341.665-1.69 9.578 9.469-13.74-7.342-.664 1.69-9.579Z"/></g><defs><clipPath id="a"><path fill="#fff" d="M.54.39h32v32h-32z"/></clipPath></defs></svg>

package/dist/ai/provider.plugin.d.ts

@@ -0,0 +1,6 @@
+import { type RuntimePlugin } from '@vibesdotdev/kernel';
+/** Complete runtime boundary for Groq-owned AI capabilities. */
+export declare function createGroqAIPlugin(): RuntimePlugin;
+export declare const groqAIPlugin: RuntimePlugin;
+export default groqAIPlugin;
+//# sourceMappingURL=provider.plugin.d.ts.map

package/dist/ai/provider.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.plugin.d.ts","sourceRoot":"","sources":["../../src/ai/provider.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA8D9E,gEAAgE;AAChE,wBAAgB,kBAAkB,IAAI,aAAa,CAoDlD;AAED,eAAO,MAAM,YAAY,EAAE,aAAoC,CAAC;AAChE,eAAe,YAAY,CAAC"}

package/dist/ai/provider.plugin.js

@@ -0,0 +1,101 @@
+import { createRuntimePlugin } from '@vibesdotdev/kernel';
+import { AI_PROVIDER_SCHEMA_KIND } from '@vibesdotdev/ai/providers-runtime/provider-schema-registration';
+import { AI_PROVIDER_RECOMMENDATION_KIND, createAIProviderRecommendationDescriptor } from '@vibesdotdev/ai/recommendations/runtime';
+import groqProviderDescriptor from "./providers/cloud/frontier/groq/provider.groq.descriptor.js";
+import groqProviderConfigDescriptor from "./providers/cloud/frontier/groq/config/config.groq.descriptor.js";
+import { groqConnectionSchema as schema0 } from "./providers/cloud/frontier/groq/config/schemas/index.js";
+const providerDetectionDescriptor = {
+    id: 'groq',
+    kind: 'ai/provider-detection',
+    providerId: 'groq',
+    description: `System detection loader for ${'groq'}`
+};
+const providerRecommendationDescriptor = createAIProviderRecommendationDescriptor({
+    id: 'groq',
+    providerType: 'groq',
+    displayName: 'Groq',
+    name: 'Groq provider recommendation',
+    description: 'Scores Groq without embedding vendor policy in Framework',
+    hardware: ['consumer', 'cloud'],
+    enabled: true,
+    tags: ['groq', 'cloud', 'fast-inference']
+});
+const providerDocsDescriptor = {
+    kind: 'docs/topic',
+    id: 'ai.providers.groq',
+    title: 'Groq provider',
+    summary: 'Configure Groq inference through runtime-owned credentials.',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: '# Groq provider\n\nCompose this plugin with AI runtime, ai/providers, infra, Config and Storage. Generation uses AI semantic client, an eligible executor, fetch transport and the separately composed `openai-chat` spec. API keys require secret references; plaintext and inline keys fail validation. Base URL defaults to https://api.groq.com/openai/v1 and timeout to 60000 ms for health too. Explicit operation timeouts override it; cancellation uses the runtime lifecycle. Health returns fixed unhealthy messages and propagates credential-store and host refusals. Detection treats credential-not-set as absence and propagates other typed failures. Root exports schemas and descriptors; resolve implementations through AI kinds or explicit /ai/providers/groq implementation subpaths. Recommendations belong to each runtime.\n'
+    },
+    tags: ['ai', 'providers', 'groq'],
+    parent: 'ai.providers',
+    order: 23,
+    surfaces: ['cli', 'web', 'in-app'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+const providerSchemaDescriptor = {
+    id: 'integrations/groq/ai/groq',
+    kind: AI_PROVIDER_SCHEMA_KIND,
+    providerId: 'groq',
+    schemaKind: 'connection',
+    sourcePath: 'integrations/groq/src/ai/providers/cloud/frontier/groq/config/schemas/index.ts',
+    version: '0.1.0-rc.0',
+    name: 'Groq',
+    description: 'Ultra-fast inference on Groq LPU (Language Processing Unit) hardware - fastest in the industry with speeds up to 500+ tokens/sec. Access to open-source models like Llama, Mixtral, and more.'
+};
+/** Complete runtime boundary for Groq-owned AI capabilities. */
+export function createGroqAIPlugin() {
+    return createRuntimePlugin({
+        id: 'integrations-groq/ai',
+        name: 'Groq AI Integration',
+        description: 'Registers Groq-owned AI descriptors and lazy implementations',
+        dependencies: ['ai/providers', 'config'],
+        onRegister(runtime) {
+            runtime.registerDescriptor('ai/provider', groqProviderDescriptor);
+            runtime.registerDescriptor('config/manifest', groqProviderConfigDescriptor);
+            runtime.registerDescriptor('ai/provider-detection', providerDetectionDescriptor);
+            runtime.registerDescriptor(AI_PROVIDER_SCHEMA_KIND, providerSchemaDescriptor);
+            runtime.registerDescriptor(AI_PROVIDER_RECOMMENDATION_KIND, providerRecommendationDescriptor);
+            if (runtime.hasKind('docs/topic'))
+                runtime.registerDescriptor('docs/topic', providerDocsDescriptor);
+        },
+        onActivate(runtime) {
+            runtime.registerLoader('ai/provider', 'groq', async () => ({
+                meta: { id: 'groq', kind: 'ai/provider', priority: 0 },
+                impl: (await import("./providers/groq/groq.provider.impl.js")).GroqProviderType
+            }));
+            runtime.registerLoader('ai/provider-detection', 'groq', async () => ({
+                meta: { id: 'groq', kind: 'ai/provider-detection', priority: 0 },
+                impl: { detect: async () => (await import("./providers/groq/detection/system.js")).detectGroqSystem(runtime) }
+            }));
+            runtime.registerLoader(AI_PROVIDER_SCHEMA_KIND, providerSchemaDescriptor.id, async () => ({
+                meta: { id: providerSchemaDescriptor.id, kind: AI_PROVIDER_SCHEMA_KIND, priority: 0 },
+                impl: {
+                    connectionSchema: schema0,
+                    metadata: {
+                        name: 'Groq',
+                        description: 'Ultra-fast inference on Groq LPU (Language Processing Unit) hardware - fastest in the industry with speeds up to 500+ tokens/sec. Access to open-source models like Llama, Mixtral, and more.',
+                        category: 'cloud',
+                        capabilities: ['text', 'connection'],
+                        fields: []
+                    }
+                }
+            }));
+            runtime.registerLoader(AI_PROVIDER_RECOMMENDATION_KIND, providerRecommendationDescriptor.id, async () => ({
+                meta: {
+                    id: providerRecommendationDescriptor.id,
+                    kind: AI_PROVIDER_RECOMMENDATION_KIND,
+                    priority: providerRecommendationDescriptor.priority ?? 0
+                },
+                impl: new (await import("./providers/groq/recommendations.js")).GroqRecommendation()
+            }));
+        }
+    });
+}
+export const groqAIPlugin = createGroqAIPlugin();
+export default groqAIPlugin;
+//# sourceMappingURL=provider.plugin.js.map

package/dist/ai/provider.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.plugin.js","sourceRoot":"","sources":["../../src/ai/provider.plugin.ts"],"names":[],"mappings":"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"}