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

package/dist/ai/providers/grok/grok.provider.impl.d.ts

@@ -0,0 +1,47 @@
+import type { ProviderOperationOptions, AIProviderTypeContext, AIProviderTypeInterface, ConnectionValidationResult, DetectedProviderInstance, ModelRecommendation, ProviderGenerateOptions, ProviderGenerateResult, ProviderHealthCheckResult } from '@vibesdotdev/ai/interfaces/provider-type';
+import type { GenerationRequest } from '@vibesdotdev/ai/interfaces/adapter';
+import type { AIModelDescriptor, Modality } from '@vibesdotdev/ai/models/schemas';
+import type { AIProviderDescriptor } from '@vibesdotdev/ai/providers-runtime/schemas/provider-descriptor';
+import type { AIProviderTypeDescriptor } from '@vibesdotdev/ai/providers-runtime/schemas/type-descriptor';
+/** The connection configuration the provider-type interface hands to health, authentication and validation. */
+type ProviderConnectionConfig = Parameters<AIProviderTypeInterface['checkHealth']>[0];
+export interface GrokAuthenticateOptions extends ProviderOperationOptions {
+    /**
+     * Receives the device-code sign-in prompt (URL + code) for headless callers.
+     * Without it Grok Build opens the system browser itself.
+     */
+    onMessage?: (message: string) => void;
+}
+export declare class GrokProviderType implements AIProviderTypeInterface {
+    readonly descriptor: AIProviderTypeDescriptor;
+    private readonly context;
+    constructor(descriptor: AIProviderTypeDescriptor, context: AIProviderTypeContext);
+    generate<T extends Modality>(provider: AIProviderDescriptor, model: AIModelDescriptor, request: GenerationRequest<T>, options?: ProviderGenerateOptions): Promise<ProviderGenerateResult<T>>;
+    detectInstalled(): Promise<DetectedProviderInstance[]>;
+    /** The recommendation owner's scoring, shaped for the provider type: one source for the flagship model. */
+    recommendModels(useCase?: string): Promise<ModelRecommendation[]>;
+    /** The connection as health and authentication read it, or the typed refusal for one that cannot be read. */
+    private readHealthConfig;
+    private resolveCredential;
+    checkHealth(config: ProviderConnectionConfig, options?: ProviderOperationOptions): Promise<ProviderHealthCheckResult>;
+    /**
+     * The one shared probe: no redirect following, the body cancelled, the caller's
+     * signal and the connection's `timeout` honoured, and only a status and a fixed
+     * sentence in the result (never the reason phrase, a body or a fetch error's
+     * text, which quotes the URL). The connections host's own typed refusal is the
+     * owner speaking and reaches the caller from the probe.
+     */
+    private probeApi;
+    private checkSubscription;
+    authenticate(config: ProviderConnectionConfig, options?: GrokAuthenticateOptions): Promise<ProviderHealthCheckResult>;
+    private signIn;
+    /** Validation is the connection schema's: the same rules the connection form enforces, with its fixed sentences. */
+    validateConnection(config: ProviderConnectionConfig): Promise<ConnectionValidationResult>;
+    /** The owner's report of a failed subscription operation: its own refusal, else the fixed unavailability sentence. */
+    private subscriptionFailure;
+    private subscriptionHealthy;
+    private unhealthy;
+    dispose(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=grok.provider.impl.d.ts.map

package/dist/ai/providers/grok/grok.provider.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok.provider.impl.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/grok/grok.provider.impl.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACX,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+DAA+D,CAAC;AAC1G,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2DAA2D,CAAC;AAmB1G,+GAA+G;AAC/G,KAAK,wBAAwB,GAAG,UAAU,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAMtF,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACxE;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,qBAAa,gBAAiB,YAAW,uBAAuB;IAE9D,QAAQ,CAAC,UAAU,EAAE,wBAAwB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADf,UAAU,EAAE,wBAAwB,EAC5B,OAAO,EAAE,qBAAqB;IAEhD,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAC1B,QAAQ,EAAE,oBAAoB,EAC9B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC7B,OAAO,CAAC,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAG/B,eAAe,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAqB5D,2GAA2G;IACrG,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAoBvE,6GAA6G;IAC7G,OAAO,CAAC,gBAAgB;YASV,iBAAiB;IAUzB,WAAW,CAChB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,yBAAyB,CAAC;IAoBrC;;;;;;OAMG;YACW,QAAQ;YAiCR,iBAAiB;IAazB,YAAY,CACjB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,uBAAuB,GAC/B,OAAO,CAAC,yBAAyB,CAAC;YAQvB,MAAM;IAqBpB,oHAAoH;IAC9G,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAM/F,sHAAsH;IACtH,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,SAAS;IAGX,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAC9B"}

package/dist/ai/providers/grok/grok.provider.impl.js

@@ -0,0 +1,202 @@
+import { ProbeTimeoutSchema, BaseUrlSchema, HealthConfigSchema } from "../../../schemas/health.js";
+import { findGrokCredentialKey } from "./detection/system.js";
+import { assertNoPlaintextCredentials, CredentialReferenceSchema, resolveSecretReference } from '@vibesdotdev/ai/providers-runtime';
+import { probeProviderHealth } from '@vibesdotdev/ai/providers-runtime/client';
+import { executeGeneration } from '@vibesdotdev/ai/providers-runtime/utils/provider-type-helpers';
+import { GROK_DEFAULT_BASE_URL, readGrokConnection } from "../cloud/frontier/grok/config/schemas/index.js";
+import { checkGrokSubscription, describeGrokSubscriptionFailure, GROK_SUBSCRIPTION_LOGIN_COMMAND, GROK_SUBSCRIPTION_LOGIN_TIMEOUT_MS, loginGrokSubscription, prepareGrokSubscription } from "./grok-subscription.js";
+import { grokRefusal } from "./grok-refusals.js";
+import { attempt, settle } from "../../../outcome.js";
+/** The deadline of an API health probe that neither the caller nor the connection declares. */
+const DEFAULT_HEALTH_TIMEOUT_MS = 5_000;
+const USE_CASES = ['chat', 'development', 'research', 'images', 'video', 'audio', 'organization'];
+export class GrokProviderType {
+    descriptor;
+    context;
+    constructor(descriptor, context) {
+        this.descriptor = descriptor;
+        this.context = context;
+    }
+    generate(provider, model, request, options) {
+        return executeGeneration(this.context, provider, model, request, options);
+    }
+    async detectInstalled() {
+        const instances = [];
+        const credentialKey = await findGrokCredentialKey(this.context.runtime);
+        if (credentialKey)
+            instances.push({
+                name: `Grok (${credentialKey})`,
+                source: 'system',
+                config: {
+                    authMethod: 'api-key',
+                    apiKey: { source: 'secret', key: credentialKey },
+                    baseUrl: GROK_DEFAULT_BASE_URL
+                }
+            });
+        if ((await this.checkHealth({ authMethod: 'grok-cli' })).healthy)
+            instances.push({
+                name: 'Grok subscription (Grok Build)',
+                source: 'system',
+                config: { authMethod: 'grok-cli', tokenSource: 'oauth-browser' }
+            });
+        return instances;
+    }
+    /** The recommendation owner's scoring, shaped for the provider type: one source for the flagship model. */
+    async recommendModels(useCase) {
+        const known = USE_CASES.find((candidate) => candidate === useCase) ?? 'chat';
+        const recommendation = await this.context.runtime
+            .query('ai/provider-recommendation')
+            .withId('grok')
+            .resolve();
+        const recommended = await recommendation.recommendModels(null, { useCase: known });
+        return recommended.map((model) => {
+            const recommendation = {
+                modelId: `grok:${model.modelId}`,
+                modelName: model.modelName,
+                score: model.score,
+                reason: model.reason,
+                useCaseFit: model.useCaseFit ?? model.score
+            };
+            if (model.capabilities)
+                recommendation.capabilities = model.capabilities;
+            if (model.contextWindow !== undefined)
+                recommendation.contextWindow = model.contextWindow;
+            return recommendation;
+        });
+    }
+    /** The connection as health and authentication read it, or the typed refusal for one that cannot be read. */
+    readHealthConfig(config) {
+        const read = attempt(() => HealthConfigSchema.safeParse(config));
+        if (!read.ok)
+            throw grokRefusal('invalid-connection', { details: { stage: 'read' }, cause: read.cause });
+        if (!read.value.success) {
+            const method = read.value.error.issues.some((issue) => issue.path[0] === 'authMethod');
+            throw grokRefusal(method ? 'invalid-auth-method' : 'invalid-connection', { details: { stage: 'schema' } });
+        }
+        return read.value.data;
+    }
+    async resolveCredential(connection, options) {
+        assertNoPlaintextCredentials({ apiKey: connection.apiKey });
+        const reference = CredentialReferenceSchema.safeParse(connection.apiKey);
+        if (!reference.success || reference.data.source === 'inline')
+            return undefined;
+        if (options?.resolveCredential)
+            return options.resolveCredential(reference.data);
+        return resolveSecretReference(reference.data, this.context.runtime);
+    }
+    async checkHealth(config, options) {
+        const start = Date.now();
+        const connection = this.readHealthConfig(config);
+        if (connection.authMethod === 'grok-cli') {
+            const outcome = await settle(() => this.checkSubscription(options, start));
+            return !outcome.ok ? this.subscriptionFailure(outcome, start) : outcome.value;
+        }
+        const apiKey = await this.resolveCredential(connection, options);
+        if (!apiKey)
+            return {
+                healthy: false,
+                message: 'xAI credential is unavailable',
+                error: {
+                    code: 'MISSING_API_KEY',
+                    message: 'Resolve apiKey through the runtime credential boundary'
+                },
+                checkedAt: new Date()
+            };
+        return this.probeApi(connection, apiKey, options, start);
+    }
+    /**
+     * The one shared probe: no redirect following, the body cancelled, the caller's
+     * signal and the connection's `timeout` honoured, and only a status and a fixed
+     * sentence in the result (never the reason phrase, a body or a fetch error's
+     * text, which quotes the URL). The connections host's own typed refusal is the
+     * owner speaking and reaches the caller from the probe.
+     */
+    async probeApi(connection, apiKey, options, start) {
+        const configured = BaseUrlSchema.safeParse(connection.baseUrl);
+        const baseUrl = connection.baseUrl === undefined ? GROK_DEFAULT_BASE_URL : configured.success ? configured.data : '';
+        const timeoutMs = ProbeTimeoutSchema.safeParse(options?.timeout ?? connection.timeout);
+        const result = await probeProviderHealth({
+            runtime: this.context.runtime,
+            url: `${baseUrl.replace(/\/$/, '')}/models`,
+            headers: { authorization: `Bearer ${apiKey}` },
+            signal: options?.signal,
+            timeoutMs: timeoutMs.success ? timeoutMs.data : DEFAULT_HEALTH_TIMEOUT_MS
+        });
+        if (result.ok) {
+            return {
+                healthy: true,
+                latencyMs: Date.now() - start,
+                message: 'xAI API connection successful',
+                checkedAt: new Date(),
+                availableModalities: ['text', 'image']
+            };
+        }
+        return {
+            healthy: false,
+            latencyMs: Date.now() - start,
+            message: result.status !== undefined ? `xAI API returned ${result.status}` : result.message,
+            error: { code: result.code, message: result.message },
+            checkedAt: new Date()
+        };
+    }
+    async checkSubscription(options, start) {
+        const session = await prepareGrokSubscription(this.context.runtime);
+        return (await checkGrokSubscription(session, options?.timeout ?? 5_000))
+            ? this.subscriptionHealthy(Date.now() - start)
+            : this.unhealthy('SUBSCRIPTION_REQUIRED', `Grok subscription profile is not signed in on this device. Run: ${GROK_SUBSCRIPTION_LOGIN_COMMAND}`, Date.now() - start);
+    }
+    async authenticate(config, options) {
+        if (this.readHealthConfig(config).authMethod !== 'grok-cli')
+            return this.checkHealth(config, options);
+        if (options?.signal?.aborted)
+            return this.unhealthy('AUTH_CANCELLED', 'Authentication cancelled');
+        const start = Date.now();
+        const outcome = await settle(() => this.signIn(options, start));
+        return !outcome.ok ? this.subscriptionFailure(outcome, start) : outcome.value;
+    }
+    async signIn(options, start) {
+        const session = await prepareGrokSubscription(this.context.runtime);
+        if (await checkGrokSubscription(session, 5_000))
+            return this.subscriptionHealthy(Date.now() - start);
+        const login = await loginGrokSubscription(session, {
+            timeout: options?.timeout ?? GROK_SUBSCRIPTION_LOGIN_TIMEOUT_MS,
+            signal: options?.signal,
+            onMessage: options?.onMessage
+        });
+        if (login.timedOut)
+            return this.unhealthy('AUTH_TIMEOUT', 'Grok subscription login timed out');
+        if (login.exitCode !== 0)
+            return this.unhealthy('AUTH_FAILED', 'Grok subscription login failed');
+        return (await checkGrokSubscription(session, 5_000))
+            ? this.subscriptionHealthy(Date.now() - start)
+            : this.unhealthy('SUBSCRIPTION_REQUIRED', `Grok subscription sign-in has not completed. Run: ${GROK_SUBSCRIPTION_LOGIN_COMMAND}`);
+    }
+    /** Validation is the connection schema's: the same rules the connection form enforces, with its fixed sentences. */
+    async validateConnection(config) {
+        const read = attempt(() => readGrokConnection(config));
+        if (!read.ok)
+            return { valid: false, errors: ['The connection configuration cannot be read'] };
+        if (read.value.valid)
+            return { valid: true, errors: undefined };
+        return { valid: false, errors: [...new Set(read.value.issues.map((issue) => issue.message))] };
+    }
+    /** The owner's report of a failed subscription operation: its own refusal, else the fixed unavailability sentence. */
+    subscriptionFailure(failure, start) {
+        const described = describeGrokSubscriptionFailure(failure);
+        return this.unhealthy(described.code, described.error.message, Date.now() - start);
+    }
+    subscriptionHealthy(latencyMs) {
+        return {
+            healthy: true,
+            message: 'Grok subscription is authenticated',
+            checkedAt: new Date(),
+            latencyMs,
+            availableModalities: ['text']
+        };
+    }
+    unhealthy(code, message, latencyMs) {
+        return { healthy: false, message, error: { code, message }, checkedAt: new Date(), latencyMs };
+    }
+    async dispose() { }
+}
+//# sourceMappingURL=grok.provider.impl.js.map

package/dist/ai/providers/grok/grok.provider.impl.js.map

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

package/dist/ai/providers/grok/index.d.ts

@@ -0,0 +1,3 @@
+export { detectGrokSystem } from './detection/system.ts';
+export { default as grokDocsDescriptor } from './docs/ai.providers.grok.docs.descriptor.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/grok/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/ai/providers/grok/index.js

@@ -0,0 +1,3 @@
+export { detectGrokSystem } from "./detection/system.js";
+export { default as grokDocsDescriptor } from "./docs/ai.providers.grok.docs.descriptor.js";
+//# sourceMappingURL=index.js.map

package/dist/ai/providers/grok/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ai/providers/grok/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/ai/providers/grok/recommendations.d.ts

@@ -0,0 +1,23 @@
+import { ProviderRecommendation, type ModelAdapter } from '@vibesdotdev/ai/recommendations/base';
+import type { ModelRecommendation, RecommendationContext, SetupMethod, SetupStep, UseCase } from '@vibesdotdev/ai/recommendations/schemas';
+export declare class GrokRecommendation extends ProviderRecommendation {
+    readonly providerType = "grok";
+    readonly displayName = "Grok (xAI)";
+    getUseCaseScore(useCase: UseCase): number;
+    getStageScore(stage: RecommendationContext['stage']): number;
+    getRequiredEnvironmentVariables(): string[];
+    getReason(useCase: UseCase): string;
+    getStrengths(): string[];
+    getWeaknesses(context: RecommendationContext): string[];
+    getSupportedSetupMethods(): SetupMethod[];
+    getSetupSteps(method: SetupMethod): Promise<SetupStep[]>;
+    recommendModels(_adapter: ModelAdapter | null, context: RecommendationContext): Promise<ModelRecommendation[]>;
+    getExecutionContext(): {
+        recommendModels: "server";
+        getSetupSteps: "both";
+    };
+    supportsOAuth(): boolean;
+    supportsLocal(): boolean;
+    requiresGPU(): boolean;
+}
+//# sourceMappingURL=recommendations.d.ts.map

package/dist/ai/providers/grok/recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/grok/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACjG,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAE3I,qBAAa,kBAAmB,SAAQ,sBAAsB;IAC7D,QAAQ,CAAC,YAAY,UAAU;IAAC,QAAQ,CAAC,WAAW,gBAAgB;IACpE,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IACzC,aAAa,CAAC,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,MAAM;IAC5D,+BAA+B,IAAI,MAAM,EAAE;IAC3C,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IACnC,YAAY,IAAI,MAAM,EAAE;IACxB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,EAAE;IACvD,wBAAwB,IAAI,WAAW,EAAE;IACnC,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACxD,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IACpH,mBAAmB;;;;IACnB,aAAa,IAAI,OAAO;IAAkB,aAAa,IAAI,OAAO;IAAmB,WAAW,IAAI,OAAO;CAC3G"}

package/dist/ai/providers/grok/recommendations.js

@@ -0,0 +1,21 @@
+import { ProviderRecommendation } from '@vibesdotdev/ai/recommendations/base';
+export class GrokRecommendation extends ProviderRecommendation {
+    providerType = 'grok';
+    displayName = 'Grok (xAI)';
+    getUseCaseScore(useCase) { return ({ chat: 47, development: 49, research: 46, images: 10, video: 0, audio: 0, organization: 42 })[useCase]; }
+    getStageScore(stage) { return stage === 'production' ? 20 : 0; }
+    getRequiredEnvironmentVariables() { return ['XAI_API_KEY']; }
+    getReason(useCase) { return useCase === 'development' ? 'Grok 4.7 targets coding and agentic engineering' : 'Current frontier text, vision, reasoning, and tool use'; }
+    getStrengths() { return ['Agentic coding', '500k context', 'Function calling and structured outputs']; }
+    getWeaknesses(context) { return context.requiresLocal ? ['No local inference deployment'] : []; }
+    getSupportedSetupMethods() { return ['oauth', 'api_key', 'env_var']; }
+    async getSetupSteps(method) { if (method === 'oauth')
+        return [{ step: 'Authenticate Grok Build', description: 'Run `vibes dev external grok login` and confirm the device code Grok prints. The Grok CLI keeps the session.' }]; if (method === 'api_key')
+        return [{ step: 'Store xAI API key', description: 'Create and store an xAI key through the Vibes credential boundary.', action: 'https://console.x.ai/' }]; return [{ step: 'Bind environment credential', description: 'Store the xAI key in the secret store as XAI_API_KEY and reference it as { source: "secret", key: "XAI_API_KEY" }.' }]; }
+    async recommendModels(_adapter, context) { return [{ modelId: 'grok-4.7', modelName: 'Grok 4.7', score: context.useCase === 'development' ? 98 : 95, reason: 'Current xAI flagship for coding and agentic work', contextWindow: 500_000, capabilities: ['chat', 'vision', 'tools'], isAvailable: true, requiresUpgrade: false, useCaseFit: context.useCase === 'development' ? 98 : 95 }]; }
+    getExecutionContext() { return { recommendModels: 'server', getSetupSteps: 'both' }; }
+    supportsOAuth() { return true; }
+    supportsLocal() { return false; }
+    requiresGPU() { return false; }
+}
+//# sourceMappingURL=recommendations.js.map

package/dist/ai/providers/grok/recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.js","sourceRoot":"","sources":["../../../../src/ai/providers/grok/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAqB,MAAM,sCAAsC,CAAC;AAGjG,MAAM,OAAO,kBAAmB,SAAQ,sBAAsB;IACpD,YAAY,GAAG,MAAM,CAAC;IAAU,WAAW,GAAG,YAAY,CAAC;IACpE,eAAe,CAAC,OAAgB,IAAY,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9J,aAAa,CAAC,KAAqC,IAAY,OAAO,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxG,+BAA+B,KAAe,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IACvE,SAAS,CAAC,OAAgB,IAAY,OAAO,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,iDAAiD,CAAC,CAAC,CAAC,wDAAwD,CAAC,CAAC,CAAC;IACxL,YAAY,KAAe,OAAO,CAAC,gBAAgB,EAAE,cAAc,EAAE,yCAAyC,CAAC,CAAC,CAAC,CAAC;IAClH,aAAa,CAAC,OAA8B,IAAc,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClI,wBAAwB,KAAoB,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACrF,KAAK,CAAC,aAAa,CAAC,MAAmB,IAA0B,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,WAAW,EAAE,8GAA8G,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,WAAW,EAAE,oEAAoE,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,6BAA6B,EAAE,WAAW,EAAE,oHAAoH,EAAE,CAAC,CAAC,CAAC,CAAC;IAChnB,KAAK,CAAC,eAAe,CAAC,QAA6B,EAAE,OAA8B,IAAoC,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,kDAAkD,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACxc,mBAAmB,KAAK,OAAO,EAAE,eAAe,EAAE,QAAiB,EAAE,aAAa,EAAE,MAAe,EAAE,CAAC,CAAC,CAAC;IACxG,aAAa,KAAc,OAAO,IAAI,CAAC,CAAC,CAAC;IAAC,aAAa,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;IAAC,WAAW,KAAc,OAAO,KAAK,CAAC,CAAC,CAAC;CAC7H"}

package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.descriptor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `spec-grok-build-exec` — xAI Grok Build CLI subscription-backed text generation.
+ *
+ * Consumer scope only. The paired provider variant uses the Grok-owned transport
+ * and the local `grok` binary. Authentication is owned by the Grok Build CLI
+ * (`grok login` / browser auth), so this spec does not accept or persist tokens.
+ */
+declare const _default: {
+    id: string;
+    kind: "ai/spec";
+    name: string;
+    description: string;
+    modalities: ("image" | "text" | "audio" | "video" | "embedding" | "transcription" | "evaluation" | "speech" | "ocr")[];
+    streamFraming: "none" | "sse" | "sse-named" | "ndjson" | "binary-chunked" | "ws-frame";
+    toolCallEnvelope: string;
+    transports: string[];
+    external: boolean;
+    priority: number;
+    enabled: boolean;
+    capabilities?: ("streaming" | "json_mode" | "text_generation" | "chat_completion" | "function_calling" | "embedding_generation" | "image_generation_text_to_image" | "image_generation_image_to_image" | "image_generation_inpainting" | "image_generation_outpainting" | "image_upscaling" | "image_editing_via_instructions" | "audio_generation_text_to_speech" | "audio_generation_voice_cloning" | "audio_generation_music" | "audio_generation_sound_effects" | "audio_transcription" | "audio_transcription_realtime" | "video_generation_text_to_video" | "workflow_execution" | "code_generation" | "image_understanding" | "structured_evaluation")[] | undefined;
+    imageControls?: {
+        steps: boolean;
+        cfg: boolean;
+        sampler: boolean;
+        scheduler: boolean;
+        negativePrompt: boolean;
+        seed: boolean;
+    } | undefined;
+    tags?: string[] | undefined;
+};
+export default _default;
+//# sourceMappingURL=grok-build-exec.spec.descriptor.d.ts.map

package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-build-exec.spec.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/ai/specs/grok-build-exec/grok-build-exec.spec.descriptor.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;AACH,wBAYG"}

package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.descriptor.js

@@ -0,0 +1,21 @@
+import { createAISpecDescriptor } from '@vibesdotdev/ai/specs/schemas/descriptor';
+/**
+ * `spec-grok-build-exec` — xAI Grok Build CLI subscription-backed text generation.
+ *
+ * Consumer scope only. The paired provider variant uses the Grok-owned transport
+ * and the local `grok` binary. Authentication is owned by the Grok Build CLI
+ * (`grok login` / browser auth), so this spec does not accept or persist tokens.
+ */
+export default createAISpecDescriptor({
+    id: 'grok-build-exec',
+    name: 'Grok Build CLI',
+    description: 'Runs `grok` headlessly through the official Grok Build CLI using local browser-authenticated subscription state.',
+    modalities: ['text'],
+    streamFraming: 'none',
+    toolCallEnvelope: 'none',
+    transports: ['grok-build'],
+    capabilities: ['text_generation'],
+    priority: 100,
+    tags: ['grok', 'xai', 'grok-build', 'browser-auth', 'subscription', 'consumer-only']
+});
+//# sourceMappingURL=grok-build-exec.spec.descriptor.js.map

package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-build-exec.spec.descriptor.js","sourceRoot":"","sources":["../../../../src/ai/specs/grok-build-exec/grok-build-exec.spec.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF;;;;;;GAMG;AACH,eAAe,sBAAsB,CAAC;IACrC,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACV,kHAAkH;IACnH,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM;IACrB,gBAAgB,EAAE,MAAM;IACxB,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,YAAY,EAAE,CAAC,iBAAiB,CAAC;IACjC,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,CAAC;CACpF,CAAC,CAAC"}

package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.impl.d.ts

@@ -0,0 +1,36 @@
+import type { AISpecInterface, DecodedEvent, SpecCallContext, WireRequest, WireResponseChunk } from '@vibesdotdev/ai/specs/interfaces';
+import type { GenerationRequest } from '@vibesdotdev/ai/interfaces';
+import type { Modality } from '@vibesdotdev/ai/models/schemas';
+/**
+ * Grok's documented --output-format json emits one final object. Diagnostic
+ * lines and error.message are never assistant content.
+ */
+export declare class GrokBuildExecSpec implements AISpecInterface {
+    readonly descriptor: {
+        id: string;
+        kind: "ai/spec";
+        name: string;
+        description: string;
+        modalities: ("image" | "text" | "audio" | "video" | "embedding" | "transcription" | "evaluation" | "speech" | "ocr")[];
+        streamFraming: "none" | "sse" | "sse-named" | "ndjson" | "binary-chunked" | "ws-frame";
+        toolCallEnvelope: string;
+        transports: string[];
+        external: boolean;
+        priority: number;
+        enabled: boolean;
+        capabilities?: ("streaming" | "json_mode" | "text_generation" | "chat_completion" | "function_calling" | "embedding_generation" | "image_generation_text_to_image" | "image_generation_image_to_image" | "image_generation_inpainting" | "image_generation_outpainting" | "image_upscaling" | "image_editing_via_instructions" | "audio_generation_text_to_speech" | "audio_generation_voice_cloning" | "audio_generation_music" | "audio_generation_sound_effects" | "audio_transcription" | "audio_transcription_realtime" | "video_generation_text_to_video" | "workflow_execution" | "code_generation" | "image_understanding" | "structured_evaluation")[] | undefined;
+        imageControls?: {
+            steps: boolean;
+            cfg: boolean;
+            sampler: boolean;
+            scheduler: boolean;
+            negativePrompt: boolean;
+            seed: boolean;
+        } | undefined;
+        tags?: string[] | undefined;
+    };
+    encodeRequest<M extends Modality>(request: GenerationRequest<M>, context: SpecCallContext): WireRequest;
+    decodeResponse<M extends Modality>(chunks: AsyncIterable<WireResponseChunk>, request: GenerationRequest<M>, context: SpecCallContext): AsyncIterable<DecodedEvent<M>>;
+}
+export default GrokBuildExecSpec;
+//# sourceMappingURL=grok-build-exec.spec.impl.d.ts.map

package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-build-exec.spec.impl.d.ts","sourceRoot":"","sources":["../../../../src/ai/specs/grok-build-exec/grok-build-exec.spec.impl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,eAAe,EACf,YAAY,EACZ,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,iBAAiB,EAA0B,MAAM,4BAA4B,CAAC;AAC5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAQ/D;;;GAGG;AAGH,qBAAa,iBAAkB,YAAW,eAAe;IACxD,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;MAAc;IAEjC,aAAa,CAAC,CAAC,SAAS,QAAQ,EAC/B,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC7B,OAAO,EAAE,eAAe,GACtB,WAAW;IAeP,cAAc,CAAC,CAAC,SAAS,QAAQ,EACvC,MAAM,EAAE,aAAa,CAAC,iBAAiB,CAAC,EACxC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC7B,OAAO,EAAE,eAAe,GACtB,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAwCjC;AAUD,eAAe,iBAAiB,CAAC"}

package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.impl.js

@@ -0,0 +1,78 @@
+import { GrokBuildOutputSchema } from "../../../schemas/output.js";
+import { concatAll, textResultEvent } from '@vibesdotdev/ai/specs/interfaces';
+import { grokRefusal } from "../../providers/grok/grok-refusals.js";
+import { GROK_PROCESS_OUTPUT_LIMITS } from "../../providers/grok/grok-subscription.js";
+import { attempt } from "../../../outcome.js";
+import { encodeGrokMessage, readGrokTextMessages } from "../grok-messages.js";
+import descriptor from "./grok-build-exec.spec.descriptor.js";
+/**
+ * Grok's documented --output-format json emits one final object. Diagnostic
+ * lines and error.message are never assistant content.
+ */
+export class GrokBuildExecSpec {
+    descriptor = descriptor;
+    encodeRequest(request, context) {
+        // Refuses images, tool calls and tool results typed: the CLI takes one text prompt, and nothing is dropped.
+        const messages = readGrokTextMessages(request);
+        const body = { prompt: messages.map(encodeGrokMessage).join('\n\n') };
+        if (context.wireModelId && context.wireModelId !== 'grok')
+            body.model = context.wireModelId;
+        return {
+            method: 'POST',
+            path: '',
+            headers: {},
+            body,
+            streaming: false
+        };
+    }
+    async *decodeResponse(chunks, request, context) {
+        const stdoutChunks = [];
+        let stdoutBytes = 0;
+        for await (const chunk of chunks) {
+            if (chunk.kind === 'bytes') {
+                stdoutBytes += chunk.data.length;
+                if (stdoutBytes > GROK_PROCESS_OUTPUT_LIMITS.maxStdoutBytes) {
+                    yield { kind: 'error', error: grokRefusal('agent-output-too-large', { details: { stage: 'decode', what: 'stdout' } }) };
+                    return;
+                }
+                stdoutChunks.push(chunk.data);
+            }
+            else if (chunk.kind === 'error') {
+                yield { kind: 'error', error: chunk.error };
+                return;
+            }
+        }
+        // The stream's end is the end of the output, whether or not the transport sent its `end` chunk:
+        // output that never completes into a result is an error, never an empty success.
+        const decoded = new TextDecoder().decode(concatAll(stdoutChunks)).trim();
+        const response = extractResponse(decoded);
+        if (!response) {
+            yield { kind: 'error', error: grokRefusal('empty-assistant-content') };
+            return;
+        }
+        const result = {
+            id: `${context.providerId}.${context.variantId}.${Date.now()}`,
+            timestamp: new Date(),
+            content: response.text,
+            metadata: {
+                modelVersion: context.wireModelId,
+                finishReason: response.stopReason === 'end_turn'
+                    ? 'stop'
+                    : ['max_tokens', 'max_turn_requests'].includes(response.stopReason)
+                        ? 'length'
+                        : response.stopReason
+            }
+        };
+        yield textResultEvent(request, result);
+    }
+}
+function extractResponse(stdout) {
+    const decoded = attempt(() => JSON.parse(stdout));
+    // Output that is not one JSON object is no assistant content; the text is the child's and is never echoed.
+    if (!decoded.ok)
+        return undefined;
+    const output = GrokBuildOutputSchema.safeParse(decoded.value);
+    return output.success ? { text: output.data.text, stopReason: output.data.stopReason } : undefined;
+}
+export default GrokBuildExecSpec;
+//# sourceMappingURL=grok-build-exec.spec.impl.js.map

package/dist/ai/specs/grok-build-exec/grok-build-exec.spec.impl.js.map

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

package/dist/ai/specs/grok-messages.d.ts

@@ -0,0 +1,20 @@
+import type { GenerationRequest } from '@vibesdotdev/ai/interfaces';
+import type { Modality } from '@vibesdotdev/ai/models/schemas';
+/** Characters of prompt one request may carry (the sum of every message's content). */
+export declare const GROK_MAX_PROMPT_CHARS = 4194304;
+export interface GrokTextMessage {
+    readonly role: 'system' | 'user' | 'assistant';
+    readonly content: string;
+}
+/**
+ * The conversation of a text request, or a typed refusal. A request that is not
+ * a text request (or cannot be read at all: a throwing getter, a trapping
+ * Proxy) is `unsupported-modality`; a malformed message list is
+ * `invalid-request`; content the text session cannot carry is
+ * `unsupported-content` (never dropped); an oversize prompt is
+ * `request-too-large`. Nothing the request said is echoed into a message.
+ */
+export declare function readGrokTextMessages<M extends Modality>(request: GenerationRequest<M>): GrokTextMessage[];
+/** The `<role>` framing both Grok text specs flatten a conversation to. */
+export declare function encodeGrokMessage(message: GrokTextMessage): string;
+//# sourceMappingURL=grok-messages.d.ts.map

package/dist/ai/specs/grok-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-messages.d.ts","sourceRoot":"","sources":["../../../src/ai/specs/grok-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAM/D,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,UAAY,CAAC;AAoB/C,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,eAAe,EAAE,CAsBzG;AAgBD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAElE"}