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

package/dist/ai/providers/grok/docs/ai.providers.grok.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=ai.providers.grok.docs.descriptor.d.ts.map

package/dist/ai/providers/grok/docs/ai.providers.grok.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.providers.grok.docs.descriptor.d.ts","sourceRoot":"","sources":["../../../../../src/ai/providers/grok/docs/ai.providers.grok.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,QAAA,MAAM,UAAU,EAAE,mBAkBjB,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/ai/providers/grok/docs/ai.providers.grok.docs.descriptor.js

@@ -0,0 +1,21 @@
+const descriptor = {
+    kind: 'docs/topic', id: 'ai.providers.grok', title: 'Grok provider', summary: 'Use Grok through Grok Build or runtime-resolved xAI credentials.',
+    body: { type: 'markdown', sourceType: 'raw', source: `# Grok provider
+
+\`@vibesdotdev/integrations-grok\` owns Grok provider assets and the Grok Build
+wire spec. Framework retains provider-neutral kinds. Consumer runtimes can reuse
+the official Grok Build session through its agent protocol; cloud runtimes resolve
+an \`XAI_API_KEY\` credential reference. Generation resolves \`ai/generation\`.
+
+Consumer hosts compose \`/ai/plugin\` (also \`/ai/consumer.plugin\`); cloud/browser
+hosts compose \`/ai/shared.plugin\`. Resolve provider, recommendation, spec and
+transport implementations through their AI kinds. Subscription transports refuse
+cloud resolution with \`NOT_FOUND / not-registered\`.
+
+Current model guidance: https://docs.x.ai/developers/models
+` },
+    tags: ['ai', 'providers', 'grok', 'xai'], parent: 'ai.providers', order: 4,
+    surfaces: ['cli', 'web', 'in-app'], hardware: ['consumer', 'cloud'], enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=ai.providers.grok.docs.descriptor.js.map

package/dist/ai/providers/grok/docs/ai.providers.grok.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.providers.grok.docs.descriptor.js","sourceRoot":"","sources":["../../../../../src/ai/providers/grok/docs/ai.providers.grok.docs.descriptor.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,kEAAkE;IAChJ,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE;;;;;;;;;;;;;CAarD,EAAE;IACF,IAAI,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAC1E,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI;CAClF,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/ai/providers/grok/grok-agent/budget.d.ts

@@ -0,0 +1,14 @@
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+/**
+ * The caller's declared deadline for one generation, spread over the requests
+ * it makes (handshake, `session/new`, `session/prompt`). The deadline is the
+ * caller's `options.timeoutMs` and nothing else: with none declared a request
+ * waits for its answer, its caller's abort, or the agent's end. No ceiling is
+ * hidden here.
+ */
+export interface GrokAgentBudget {
+    /** Milliseconds left for the next request, or `undefined` when the caller declared no deadline. Throws `agent-turn-timeout` once spent. */
+    remaining(stage: string): number | undefined;
+}
+export declare function createGrokAgentBudget(runtime: Pick<RuntimeRef, 'lifecycle'>, timeoutMs: number | undefined): GrokAgentBudget;
+//# sourceMappingURL=budget.d.ts.map

package/dist/ai/providers/grok/grok-agent/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../../../src/ai/providers/grok/grok-agent/budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQtD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC/B,2IAA2I;IAC3I,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EACtC,SAAS,EAAE,MAAM,GAAG,SAAS,GAC3B,eAAe,CAcjB"}

package/dist/ai/providers/grok/grok-agent/budget.js

@@ -0,0 +1,23 @@
+import * as z from 'zod/v4';
+import { grokRefusal } from "../grok-refusals.js";
+/** The most a host timer honours; the shared client refuses a longer deadline. */
+const MAX_DEADLINE_MS = 2_147_483_647;
+const TimeoutMsSchema = z.int().min(1).max(MAX_DEADLINE_MS);
+export function createGrokAgentBudget(runtime, timeoutMs) {
+    if (timeoutMs === undefined)
+        return { remaining: () => undefined };
+    const declared = TimeoutMsSchema.safeParse(timeoutMs);
+    if (!declared.success) {
+        throw grokRefusal('invalid-request', { details: { field: 'timeoutMs' } });
+    }
+    const started = runtime.lifecycle.now();
+    return {
+        remaining(stage) {
+            const left = declared.data - (runtime.lifecycle.now() - started);
+            if (left < 1)
+                throw grokRefusal('agent-turn-timeout', { details: { stage, deadlineMs: declared.data } });
+            return Math.ceil(left);
+        }
+    };
+}
+//# sourceMappingURL=budget.js.map

package/dist/ai/providers/grok/grok-agent/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../../../../src/ai/providers/grok/grok-agent/budget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,kFAAkF;AAClF,MAAM,eAAe,GAAG,aAAa,CAAC;AACtC,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAc5D,MAAM,UAAU,qBAAqB,CACpC,OAAsC,EACtC,SAA6B;IAE7B,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IACnE,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,WAAW,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;IACxC,OAAO;QACN,SAAS,CAAC,KAAK;YACd,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;YACjE,IAAI,IAAI,GAAG,CAAC;gBAAE,MAAM,WAAW,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACzG,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/ai/providers/grok/grok-agent/connection.d.ts

@@ -0,0 +1,36 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type JsonRpcChild, type JsonRpcProcess } from '@vibesdotdev/external/jsonrpc';
+import type { GrokAgentBudget } from './budget.ts';
+/** Starts `grok agent stdio` and returns the process the shared client drives. */
+export type GrokAgentSpawner = () => Promise<JsonRpcProcess> | JsonRpcProcess;
+/** The ACP method the agent uses to ask the client to approve a tool; this client never approves one. */
+export declare const GROK_AGENT_PERMISSION_METHOD = "session/request_permission";
+export interface GrokAgentConnectOptions {
+    /** The runtime whose lifecycle owns the child's timers and whose logger receives the client's value-free diagnostics. */
+    readonly runtime: RuntimeRef;
+    readonly spawn: GrokAgentSpawner;
+    /** The caller's deadline, spread over the handshake and the turn. */
+    readonly budget: GrokAgentBudget;
+    readonly signal?: AbortSignal | undefined;
+}
+/**
+ * One ACP session's process: the shared JSON-RPC client over `grok agent stdio`
+ * after `initialize` and `authenticate`. Authentication is `cached_token`: the
+ * CLI session, never an API key and never a bearer this process reads from disk.
+ *
+ * The client marks itself closed when the child ends or its stream fails, so a
+ * transport drops a dead connection and spawns a new one.
+ */
+export declare class GrokAgentConnection {
+    #private;
+    readonly client: JsonRpcChild;
+    private constructor();
+    /** Whether the agent asked for a permission (answered `-32601`, the turn stopped). */
+    get permissionRequested(): boolean;
+    /** Call `listener` when the agent asks for a permission; once. */
+    onPermissionRequest(listener: () => void): void;
+    /** SIGTERM, grace, SIGKILL and a joined exit, through the shared client. */
+    close(): Promise<void>;
+    static open(options: GrokAgentConnectOptions): Promise<GrokAgentConnection>;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/ai/providers/grok/grok-agent/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../../src/ai/providers/grok/grok-agent/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAGN,KAAK,YAAY,EAEjB,KAAK,cAAc,EACnB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC;AAE9E,yGAAyG;AACzG,eAAO,MAAM,4BAA4B,+BAA+B,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACvC,yHAAyH;IACzH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC1C;AAmBD;;;;;;;GAOG;AACH,qBAAa,mBAAmB;;IAI9B,QAAQ,CAAC,MAAM,EAAE,YAAY;IAD9B,OAAO;IAOP,sFAAsF;IACtF,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED,kEAAkE;IAClE,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI/C,4EAA4E;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;WAIT,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAkEjF"}

package/dist/ai/providers/grok/grok-agent/connection.js

@@ -0,0 +1,137 @@
+import { isCapabilityError } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { boundedExcerpt, createJsonRpcChild } from '@vibesdotdev/external/jsonrpc';
+import { asError, settle } from "../../../../outcome.js";
+import { grokRefusal } from "../grok-refusals.js";
+import { SandboxMarkerWatch, tapSandboxMarker } from "../grok-sandbox-signal.js";
+import { grokAgentFailure } from "./failures.js";
+import { GROK_AGENT_LIMITS, GrokAgentInitializeResultSchema } from "./protocol.js";
+/** The ACP method the agent uses to ask the client to approve a tool; this client never approves one. */
+export const GROK_AGENT_PERMISSION_METHOD = 'session/request_permission';
+/** Whether the agent asked for a permission, and who to tell: the client reports it before the connection exists. */
+class PermissionWatch {
+    requested = false;
+    #listener;
+    asked() {
+        if (this.requested)
+            return;
+        this.requested = true;
+        this.#listener?.();
+    }
+    onAsked(listener) {
+        this.#listener = listener;
+        if (this.requested)
+            listener();
+    }
+}
+/**
+ * One ACP session's process: the shared JSON-RPC client over `grok agent stdio`
+ * after `initialize` and `authenticate`. Authentication is `cached_token`: the
+ * CLI session, never an API key and never a bearer this process reads from disk.
+ *
+ * The client marks itself closed when the child ends or its stream fails, so a
+ * transport drops a dead connection and spawns a new one.
+ */
+export class GrokAgentConnection {
+    client;
+    #watch;
+    constructor(client, watch) {
+        this.client = client;
+        this.#watch = watch;
+    }
+    /** Whether the agent asked for a permission (answered `-32601`, the turn stopped). */
+    get permissionRequested() {
+        return this.#watch.requested;
+    }
+    /** Call `listener` when the agent asks for a permission; once. */
+    onPermissionRequest(listener) {
+        this.#watch.onAsked(listener);
+    }
+    /** SIGTERM, grace, SIGKILL and a joined exit, through the shared client. */
+    close() {
+        return this.client.close();
+    }
+    static async open(options) {
+        const { runtime, budget, signal } = options;
+        if (signal?.aborted)
+            throw grokRefusal('generation-cancelled', { details: { stage: 'connect' } });
+        const logger = getLogger('integrations-grok', runtime);
+        const watch = new PermissionWatch();
+        // Only value-free facts are logged: a method name or a message is the child's text.
+        const diagnostics = (event) => {
+            switch (event.kind) {
+                case 'unhandled-request': {
+                    // The client already answered -32601. A permission request also stops the turn.
+                    const permission = boundedExcerpt(event.method) === GROK_AGENT_PERMISSION_METHOD;
+                    if (permission)
+                        watch.asked();
+                    logger.warn('grok agent request refused', { permission });
+                    return;
+                }
+                case 'unmatched-response':
+                    logger.warn('grok agent client diagnostic', { kind: event.kind, late: event.late });
+                    return;
+                case 'cleanup-failed':
+                    logger.warn('grok agent client diagnostic', { kind: event.kind, stage: event.stage });
+                    return;
+                case 'join-timeout':
+                    logger.warn('grok agent client diagnostic', { kind: event.kind, pending: event.pending });
+                    return;
+                default:
+                    logger.warn('grok agent client diagnostic', { kind: event.kind });
+            }
+        };
+        // stderr is watched for Grok's fixed sandbox refusal (never read for text); the client drains its own branch.
+        const sandbox = new SandboxMarkerWatch();
+        let scanned = Promise.resolve();
+        const spawn = async () => {
+            const process = await options.spawn();
+            const tapped = tapSandboxMarker(process.stderr, sandbox);
+            scanned = tapped.done;
+            return {
+                stdin: process.stdin,
+                stdout: process.stdout,
+                stderr: tapped.forClient,
+                exited: process.exited,
+                kill: (signal) => process.kill(signal)
+            };
+        };
+        const opened = await settle(() => createJsonRpcChild({
+            runtime,
+            spawn,
+            maxLineBytes: GROK_AGENT_LIMITS.maxLineBytes,
+            graceMs: GROK_AGENT_LIMITS.graceMs,
+            envelope: 'jsonrpc-2.0',
+            diagnostics,
+            handshake: (child) => handshake(child, budget, signal)
+        }));
+        if (!opened.ok) {
+            // The child is stopped and joined by now, so its stderr has ended: let the watch finish, bounded.
+            await settle(() => runtime.lifecycle.wait(() => scanned, { timeoutMs: 500, reason: 'grok sandbox marker scan' }));
+            const failure = opened.cause;
+            // Only a child that exited while starting, having said so: a refusal to run unprotected, not a generic start failure.
+            if (sandbox.seen && isCapabilityError(failure) && failure.reason === 'jsonrpc-child-exited') {
+                throw grokRefusal('sandbox-unavailable', { details: { stage: 'connect', exitCode: failure.details?.exitCode }, cause: failure });
+            }
+            throw grokAgentFailure(failure, 'connect');
+        }
+        return new GrokAgentConnection(opened.value, watch);
+    }
+}
+/** `initialize`, then `authenticate` by the saved login. Only a real sign-in need is `AUTH_REQUIRED`. */
+async function handshake(client, budget, signal) {
+    const init = await client.requestParsed('initialize', { protocolVersion: 1, clientCapabilities: {} }, GrokAgentInitializeResultSchema, { signal, deadlineMs: budget.remaining('initialize') });
+    if (!(init.authMethods ?? []).some((method) => method.id === 'cached_token')) {
+        throw grokRefusal('sign-in-required', { details: { stage: 'initialize' } });
+    }
+    const deadlineMs = budget.remaining('authenticate');
+    const authenticated = await settle(() => client.request('authenticate', { methodId: 'cached_token', _meta: { headless: true } }, { signal, deadlineMs }));
+    if (authenticated.ok)
+        return;
+    // The agent advertised the saved login and then declined it: that is the CLI reporting it is signed out.
+    if (isCapabilityError(authenticated.cause) && authenticated.cause.reason === 'jsonrpc-error') {
+        throw grokRefusal('sign-in-required', { details: { stage: 'authenticate' }, cause: authenticated.cause });
+    }
+    throw asError(authenticated.cause);
+}
+//# sourceMappingURL=connection.js.map

package/dist/ai/providers/grok/grok-agent/connection.js.map

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

package/dist/ai/providers/grok/grok-agent/failures.d.ts

@@ -0,0 +1,12 @@
+import { type CapabilityError, type CaughtFailure } from '@vibesdotdev/kernel';
+/** Where in an agent call a failure happened: the handshake, opening the session, or the turn. */
+export type GrokAgentStage = 'connect' | 'session' | 'prompt';
+/**
+ * The Grok refusal for what the shared JSON-RPC client reported. The client's
+ * own typed failure rides as the `cause` (its child text is a bounded excerpt
+ * in its `details`, which no projection prints); the message is this package's
+ * fixed sentence. Whatever is not the client's is this package's own refusal
+ * and passes through; anything else is a failed session with its cause kept.
+ */
+export declare function grokAgentFailure(failure: CaughtFailure, stage: GrokAgentStage): CapabilityError;
+//# sourceMappingURL=failures.d.ts.map

package/dist/ai/providers/grok/grok-agent/failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.d.ts","sourceRoot":"","sources":["../../../../../src/ai/providers/grok/grok-agent/failures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIlG,kGAAkG;AAClG,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AA0B9D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,GAAG,eAAe,CAW/F"}

package/dist/ai/providers/grok/grok-agent/failures.js

@@ -0,0 +1,47 @@
+import { isCapabilityError } from '@vibesdotdev/kernel';
+import { asError } from "../../../../outcome.js";
+import { grokRefusal } from "../grok-refusals.js";
+/** This package's reason for one of the shared JSON-RPC client's reasons, or `undefined` for a reason that is not the client's. */
+function grokReasonFor(reason) {
+    switch (reason) {
+        case 'jsonrpc-cancelled':
+            return 'generation-cancelled';
+        case 'jsonrpc-timeout':
+            return 'agent-turn-timeout';
+        case 'jsonrpc-protocol-invalid':
+            return 'agent-record-invalid';
+        case 'jsonrpc-line-too-large':
+            return 'agent-line-too-long';
+        case 'jsonrpc-notification-overflow':
+            return 'agent-output-too-large';
+        case 'jsonrpc-closed':
+        case 'jsonrpc-kill-failed':
+        case 'jsonrpc-child-exited':
+            return 'agent-closed';
+        case 'jsonrpc-error':
+            return 'agent-request-failed';
+        default:
+            return undefined;
+    }
+}
+/**
+ * The Grok refusal for what the shared JSON-RPC client reported. The client's
+ * own typed failure rides as the `cause` (its child text is a bounded excerpt
+ * in its `details`, which no projection prints); the message is this package's
+ * fixed sentence. Whatever is not the client's is this package's own refusal
+ * and passes through; anything else is a failed session with its cause kept.
+ */
+export function grokAgentFailure(failure, stage) {
+    if (!isCapabilityError(failure)) {
+        return grokRefusal(stage === 'connect' ? 'agent-connect-failed' : 'agent-session-failed', { details: { stage }, cause: asError(failure) });
+    }
+    if (!failure.reason.startsWith('jsonrpc-'))
+        return failure;
+    const details = { stage };
+    // A failure to start is a connect failure whatever the client called it, unless the caller's own deadline or abort ended it.
+    if (stage === 'connect' && failure.reason !== 'jsonrpc-cancelled' && failure.reason !== 'jsonrpc-timeout') {
+        return grokRefusal('agent-connect-failed', { details, cause: failure });
+    }
+    return grokRefusal(grokReasonFor(failure.reason) ?? 'agent-session-failed', { details, cause: failure });
+}
+//# sourceMappingURL=failures.js.map

package/dist/ai/providers/grok/grok-agent/failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.js","sourceRoot":"","sources":["../../../../../src/ai/providers/grok/grok-agent/failures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA4C,MAAM,qBAAqB,CAAC;AAClG,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,WAAW,EAA0B,MAAM,qBAAqB,CAAC;AAK1E,mIAAmI;AACnI,SAAS,aAAa,CAAC,MAAc;IACpC,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,mBAAmB;YACvB,OAAO,sBAAsB,CAAC;QAC/B,KAAK,iBAAiB;YACrB,OAAO,oBAAoB,CAAC;QAC7B,KAAK,0BAA0B;YAC9B,OAAO,sBAAsB,CAAC;QAC/B,KAAK,wBAAwB;YAC5B,OAAO,qBAAqB,CAAC;QAC9B,KAAK,+BAA+B;YACnC,OAAO,wBAAwB,CAAC;QACjC,KAAK,gBAAgB,CAAC;QACtB,KAAK,qBAAqB,CAAC;QAC3B,KAAK,sBAAsB;YAC1B,OAAO,cAAc,CAAC;QACvB,KAAK,eAAe;YACnB,OAAO,sBAAsB,CAAC;QAC/B;YACC,OAAO,SAAS,CAAC;IACnB,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB,EAAE,KAAqB;IAC7E,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5I,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3D,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC;IAC1B,6HAA6H;IAC7H,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,mBAAmB,IAAI,OAAO,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;QAC3G,OAAO,WAAW,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,sBAAsB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1G,CAAC"}

package/dist/ai/providers/grok/grok-agent/grok-agent.spec.descriptor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Subscription turns over Grok's documented ACP session (`grok agent stdio`).
+ * The CLI owns the login. 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-agent.spec.descriptor.d.ts.map

package/dist/ai/providers/grok/grok-agent/grok-agent.spec.descriptor.d.ts.map

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

package/dist/ai/providers/grok/grok-agent/grok-agent.spec.descriptor.js

@@ -0,0 +1,18 @@
+import { createAISpecDescriptor } from '@vibesdotdev/ai/specs/schemas/descriptor';
+/**
+ * Subscription turns over Grok's documented ACP session (`grok agent stdio`).
+ * The CLI owns the login. This spec does not accept or persist tokens.
+ */
+export default createAISpecDescriptor({
+    id: 'grok-agent',
+    name: 'Grok Agent Session',
+    description: 'Subscription-backed, provider-managed agent turns over the Grok ACP stdio session.',
+    modalities: ['text'],
+    streamFraming: 'ndjson',
+    toolCallEnvelope: 'openai-tool-calls',
+    transports: ['grok-agent'],
+    capabilities: ['text_generation', 'function_calling'],
+    priority: 110,
+    tags: ['grok', 'xai', 'acp', 'grok-managed-auth', 'provider-managed-tool-loop', 'consumer-only']
+});
+//# sourceMappingURL=grok-agent.spec.descriptor.js.map

package/dist/ai/providers/grok/grok-agent/grok-agent.spec.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-agent.spec.descriptor.js","sourceRoot":"","sources":["../../../../../src/ai/providers/grok/grok-agent/grok-agent.spec.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF;;;GAGG;AACH,eAAe,sBAAsB,CAAC;IACrC,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACV,oFAAoF;IACrF,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,aAAa,EAAE,QAAQ;IACvB,gBAAgB,EAAE,mBAAmB;IACrC,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,YAAY,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IACrD,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,eAAe,CAAC;CAChG,CAAC,CAAC"}

package/dist/ai/providers/grok/grok-agent/grok-agent.spec.impl.d.ts

@@ -0,0 +1,32 @@
+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';
+export declare class GrokAgentSpec 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 GrokAgentSpec;
+//# sourceMappingURL=grok-agent.spec.impl.d.ts.map

package/dist/ai/providers/grok/grok-agent/grok-agent.spec.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-agent.spec.impl.d.ts","sourceRoot":"","sources":["../../../../../src/ai/providers/grok/grok-agent/grok-agent.spec.impl.ts"],"names":[],"mappings":"AAAA,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;AAgB/D,qBAAa,aAAc,YAAW,eAAe;IACpD,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;MAAc;IAEjC,aAAa,CAAC,CAAC,SAAS,QAAQ,EAC/B,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC7B,OAAO,EAAE,eAAe,GACtB,WAAW;IAkBP,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;CA0DjC;AAyBD,eAAe,aAAa,CAAC"}

package/dist/ai/providers/grok/grok-agent/grok-agent.spec.impl.js

@@ -0,0 +1,113 @@
+import { textResultEvent } from '@vibesdotdev/ai/specs/interfaces';
+import descriptor from "./grok-agent.spec.descriptor.js";
+import { encodeGrokMessage, readGrokTextMessages } from "../../../specs/grok-messages.js";
+import { attempt } from "../../../../outcome.js";
+import { grokRefusal } from "../grok-refusals.js";
+import { createGrokAgentSessionProgram } from "./session.js";
+import { GROK_AGENT_LIMITS, GrokAgentRecordSchema } from "./protocol.js";
+export class GrokAgentSpec {
+    descriptor = descriptor;
+    encodeRequest(request, context) {
+        // Refuses images, tool calls and tool results typed: the session carries text only, and nothing is dropped.
+        const messages = readGrokTextMessages(request);
+        const cwd = context.executionPolicy?.workspacePath ?? '';
+        const prompt = encodePrompt(messages.map(encodeGrokMessage));
+        return {
+            method: 'POST',
+            path: '',
+            headers: { 'content-type': 'application/x-ndjson' },
+            body: {
+                cwd,
+                prompt,
+                sessionProgram: createGrokAgentSessionProgram({ cwd, prompt })
+            },
+            streaming: true
+        };
+    }
+    async *decodeResponse(chunks, request, context) {
+        const content = [];
+        const thinking = [];
+        let contentChars = 0;
+        let thinkingChars = 0;
+        let resultSeen = false;
+        for await (const chunk of chunks) {
+            if (chunk.kind === 'error') {
+                yield { kind: 'error', error: chunk.error };
+                return;
+            }
+            if (chunk.kind !== 'ndjson-record')
+                continue;
+            const record = parseRecord(chunk.data);
+            if (!record) {
+                yield { kind: 'error', error: grokRefusal('agent-record-invalid', { details: { stage: 'decode' } }) };
+                return;
+            }
+            if (record.type === 'text-delta') {
+                contentChars += record.delta.length;
+                if (contentChars > GROK_AGENT_LIMITS.maxTextChars) {
+                    yield { kind: 'error', error: grokRefusal('agent-output-too-large', { details: { stage: 'decode', what: 'text' } }) };
+                    return;
+                }
+                content.push(record.delta);
+                yield { kind: 'text-delta', delta: record.delta };
+                continue;
+            }
+            if (record.type === 'thinking-delta') {
+                thinkingChars += record.delta.length;
+                if (thinkingChars > GROK_AGENT_LIMITS.maxThinkingChars) {
+                    yield { kind: 'error', error: grokRefusal('agent-output-too-large', { details: { stage: 'decode', what: 'thinking' } }) };
+                    return;
+                }
+                thinking.push(record.delta);
+                yield { kind: 'thinking-delta', delta: record.delta };
+                continue;
+            }
+            const result = {
+                id: `${context.providerId}.grok-agent`,
+                timestamp: new Date(),
+                content: content.join(''),
+                metadata: {
+                    modelVersion: context.wireModelId,
+                    finishReason: finishReason(record.stopReason),
+                    providerManagedToolLoop: true
+                }
+            };
+            if (thinking.length > 0)
+                result.thinking = thinking.join('');
+            if (record.toolCalls.length > 0)
+                result.toolCalls = record.toolCalls.map(toTextToolCall);
+            yield textResultEvent(request, result);
+            // The stream is read to its end, so the transport finishes (and stops the agent) in the normal flow.
+            resultSeen = true;
+        }
+        // The session ended without its result record: never an empty success.
+        if (!resultSeen) {
+            yield { kind: 'error', error: grokRefusal('agent-record-invalid', { details: { stage: 'decode', what: 'no-result' } }) };
+        }
+    }
+}
+function toTextToolCall(tool) {
+    const call = { id: tool.id, name: tool.name, arguments: tool.arguments };
+    if (tool.result !== undefined)
+        call.result = tool.result;
+    return call;
+}
+function encodePrompt(framed) {
+    return framed.map((text) => ({ type: 'text', text }));
+}
+function parseRecord(value) {
+    const decoded = attempt(() => JSON.parse(value));
+    if (!decoded.ok)
+        return undefined;
+    const parsed = GrokAgentRecordSchema.safeParse(decoded.value);
+    return parsed.success ? parsed.data : undefined;
+}
+function finishReason(stopReason) {
+    if (stopReason === 'end_turn')
+        return 'stop';
+    if (stopReason === 'max_tokens' || stopReason === 'max_turn_requests')
+        return 'length';
+    return stopReason;
+}
+export default GrokAgentSpec;
+//# sourceMappingURL=grok-agent.spec.impl.js.map

package/dist/ai/providers/grok/grok-agent/grok-agent.spec.impl.js.map

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

package/dist/ai/providers/grok/grok-agent/grok-agent.transport.descriptor.d.ts

@@ -0,0 +1,13 @@
+declare const _default: {
+    id: string;
+    kind: "ai/transport";
+    name: string;
+    description: string;
+    scopes: ("cloud" | "consumer")[];
+    bidirectional: boolean;
+    cancellable: boolean;
+    enabled: boolean;
+    tags?: string[] | undefined;
+};
+export default _default;
+//# sourceMappingURL=grok-agent.transport.descriptor.d.ts.map

package/dist/ai/providers/grok/grok-agent/grok-agent.transport.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-agent.transport.descriptor.d.ts","sourceRoot":"","sources":["../../../../../src/ai/providers/grok/grok-agent/grok-agent.transport.descriptor.ts"],"names":[],"mappings":";;;;;;;;;;;AAEA,wBASG"}

package/dist/ai/providers/grok/grok-agent/grok-agent.transport.descriptor.js

@@ -0,0 +1,11 @@
+import { createAITransportDescriptor } from '@vibesdotdev/ai/transports/schemas/descriptor';
+export default createAITransportDescriptor({
+    id: 'grok-agent',
+    name: 'Grok Agent Session',
+    description: 'Consumer Grok ACP session (`grok agent stdio`) authenticated by the dedicated Grok Build profile.',
+    scopes: ['consumer'],
+    bidirectional: true,
+    cancellable: true,
+    tags: ['grok', 'acp', 'grok-managed-auth', 'consumer-only']
+});
+//# sourceMappingURL=grok-agent.transport.descriptor.js.map

package/dist/ai/providers/grok/grok-agent/grok-agent.transport.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-agent.transport.descriptor.js","sourceRoot":"","sources":["../../../../../src/ai/providers/grok/grok-agent/grok-agent.transport.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAE5F,eAAe,2BAA2B,CAAC;IAC1C,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACV,mGAAmG;IACpG,MAAM,EAAE,CAAC,UAAU,CAAC;IACpB,aAAa,EAAE,IAAI;IACnB,WAAW,EAAE,IAAI;IACjB,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,eAAe,CAAC;CAC3D,CAAC,CAAC"}