codex-grok-mcp 0.2.0-beta.1

package/dist/grok-bot-gateway.d.ts

@@ -0,0 +1,204 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import { z } from "zod";
+export declare const MAX_PING_BOTS = 50;
+export type GrokBotGatewayErrorCode = "AUTH_FAILED" | "BOT_NOT_FOUND" | "CANCELLED" | "CONFIG_INVALID" | "GATEWAY_REJECTED" | "INVALID_RESPONSE" | "OUTPUT_LIMIT" | "RATE_LIMITED" | "ROSTER_CHANGED" | "TIMEOUT" | "UPGRADE_REQUIRED" | "UNAVAILABLE";
+export declare class GrokBotGatewayError extends Error {
+    readonly code: GrokBotGatewayErrorCode;
+    readonly deliveryMayHaveOccurred: boolean;
+    readonly requestId: string | undefined;
+    constructor(code: GrokBotGatewayErrorCode, message: string, options?: {
+        deliveryMayHaveOccurred?: boolean;
+        requestId?: string;
+    });
+}
+export type GrokBotSummary = {
+    id: string;
+    name: string;
+    is_running: boolean | null;
+};
+export type GrokBotRoster = {
+    bot_count: number;
+    bots: GrokBotSummary[];
+    roster_fingerprint: string;
+};
+export type GrokBotSendReceipt = {
+    accepted: true;
+    requestId: string;
+};
+export type GrokBotReadMessage = {
+    speaker: "user" | "bot" | "peer";
+    text: string;
+    timestamp_ms: number | null;
+};
+export type GrokBotReadSnapshot = {
+    bot_id: string;
+    is_running: boolean | null;
+    is_composing: boolean | null;
+    awaiting_user: boolean | null;
+    async_task_count: number | null;
+    running_subagent_count: number | null;
+    messages: GrokBotReadMessage[];
+    next_before_sequence: number | null;
+    truncated: boolean;
+};
+export type GrokBotReadOptions = {
+    limit: number;
+    beforeSequence?: number;
+};
+export type GrokBotTransport = {
+    listBots(signal?: AbortSignal): Promise<GrokBotSummary[]>;
+    readBot(botId: string, options: GrokBotReadOptions, signal?: AbortSignal): Promise<GrokBotReadSnapshot>;
+    sendMessage(botId: string, message: string, signal?: AbortSignal): Promise<GrokBotSendReceipt>;
+};
+export declare const grokListBotsInputSchema: z.ZodObject<{}, z.core.$strict>;
+export declare const grokListBotsOutputSchema: z.ZodObject<{
+    experimental: z.ZodLiteral<true>;
+    bot_count: z.ZodNumber;
+    bots: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        is_running: z.ZodNullable<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    roster_fingerprint: z.ZodString;
+}, z.core.$strict>;
+export declare const grokSendBotMessageInputSchema: z.ZodObject<{
+    bot_id: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const grokSendBotMessageOutputSchema: z.ZodObject<{
+    experimental: z.ZodLiteral<true>;
+    bot_id: z.ZodString;
+    bot_name: z.ZodString;
+    accepted: z.ZodLiteral<true>;
+    request_id: z.ZodString;
+    completion_boundary: z.ZodLiteral<"gateway_accepted_not_bot_reply">;
+}, z.core.$strict>;
+export declare const grokReadBotInputSchema: z.ZodObject<{
+    bot_id: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const grokWaitForBotInputSchema: z.ZodObject<{
+    bot_id: z.ZodString;
+    timeout_seconds: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const grokReadBotOutputSchema: z.ZodObject<{
+    experimental: z.ZodLiteral<true>;
+    bot_id: z.ZodString;
+    bot_name: z.ZodString;
+    is_running: z.ZodNullable<z.ZodBoolean>;
+    is_composing: z.ZodNullable<z.ZodBoolean>;
+    awaiting_user: z.ZodNullable<z.ZodBoolean>;
+    async_task_count: z.ZodNullable<z.ZodNumber>;
+    running_subagent_count: z.ZodNullable<z.ZodNumber>;
+    activity_state: z.ZodEnum<{
+        awaiting_user: "awaiting_user";
+        idle: "idle";
+        unknown: "unknown";
+        working: "working";
+    }>;
+    messages: z.ZodArray<z.ZodObject<{
+        speaker: z.ZodEnum<{
+            bot: "bot";
+            peer: "peer";
+            user: "user";
+        }>;
+        text: z.ZodString;
+        timestamp_ms: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    message_count: z.ZodNumber;
+    has_more: z.ZodBoolean;
+    next_cursor: z.ZodNullable<z.ZodString>;
+    truncated: z.ZodBoolean;
+    correlation: z.ZodLiteral<"not_claimed">;
+    content_boundary: z.ZodLiteral<"sanitized_text_only">;
+    completion_boundary: z.ZodLiteral<"activity_snapshot_not_task_completion">;
+    untrusted_external_content: z.ZodLiteral<true>;
+}, z.core.$strict>;
+export declare const grokWaitForBotOutputSchema: z.ZodObject<{
+    experimental: z.ZodLiteral<true>;
+    bot_id: z.ZodString;
+    bot_name: z.ZodString;
+    is_running: z.ZodNullable<z.ZodBoolean>;
+    is_composing: z.ZodNullable<z.ZodBoolean>;
+    awaiting_user: z.ZodNullable<z.ZodBoolean>;
+    async_task_count: z.ZodNullable<z.ZodNumber>;
+    running_subagent_count: z.ZodNullable<z.ZodNumber>;
+    activity_state: z.ZodEnum<{
+        awaiting_user: "awaiting_user";
+        idle: "idle";
+        unknown: "unknown";
+        working: "working";
+    }>;
+    messages: z.ZodArray<z.ZodObject<{
+        speaker: z.ZodEnum<{
+            bot: "bot";
+            peer: "peer";
+            user: "user";
+        }>;
+        text: z.ZodString;
+        timestamp_ms: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    message_count: z.ZodNumber;
+    has_more: z.ZodBoolean;
+    next_cursor: z.ZodNullable<z.ZodString>;
+    truncated: z.ZodBoolean;
+    correlation: z.ZodLiteral<"not_claimed">;
+    content_boundary: z.ZodLiteral<"sanitized_text_only">;
+    completion_boundary: z.ZodLiteral<"activity_snapshot_not_task_completion">;
+    untrusted_external_content: z.ZodLiteral<true>;
+    stop_reason: z.ZodEnum<{
+        awaiting_user: "awaiting_user";
+        idle: "idle";
+        timeout: "timeout";
+    }>;
+    observed_working: z.ZodBoolean;
+    observations: z.ZodNumber;
+    elapsed_ms: z.ZodNumber;
+}, z.core.$strict>;
+export declare const grokPingAllBotsInputSchema: z.ZodObject<{
+    roster_fingerprint: z.ZodOptional<z.ZodString>;
+    bot_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    confirmation: z.ZodOptional<z.ZodLiteral<"PING_ALL">>;
+}, z.core.$strict>;
+export declare const grokPingAllBotsOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    experimental: z.ZodLiteral<true>;
+    requires_confirmation: z.ZodLiteral<true>;
+    message: z.ZodLiteral<"PING">;
+    bot_count: z.ZodNumber;
+    bots: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        is_running: z.ZodNullable<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    roster_fingerprint: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    experimental: z.ZodLiteral<true>;
+    requires_confirmation: z.ZodLiteral<false>;
+    message: z.ZodLiteral<"PING">;
+    roster_fingerprint: z.ZodString;
+    receipts: z.ZodArray<z.ZodObject<{
+        bot_id: z.ZodString;
+        bot_name: z.ZodString;
+        status: z.ZodEnum<{
+            accepted: "accepted";
+            failed: "failed";
+            not_attempted: "not_attempted";
+            outcome_unknown: "outcome_unknown";
+        }>;
+        request_id: z.ZodOptional<z.ZodString>;
+        error_code: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    accepted_count: z.ZodNumber;
+    failed_count: z.ZodNumber;
+    outcome_unknown_count: z.ZodNumber;
+    not_attempted_count: z.ZodNumber;
+    completion_boundary: z.ZodLiteral<"gateway_accepted_not_bot_reply">;
+}, z.core.$strict>], "requires_confirmation">;
+export declare function rosterFingerprint(bots: GrokBotSummary[]): string;
+export declare function listGrokBots(transport: GrokBotTransport, signal?: AbortSignal): Promise<GrokBotRoster>;
+export declare function encodeGrokBotReadCursor(botId: string, beforeSequence: number): string;
+export declare function decodeGrokBotReadCursor(cursor: string, botId: string): number;
+export declare function readGrokBot(transport: GrokBotTransport, botId: string, options: GrokBotReadOptions, signal?: AbortSignal): Promise<GrokBotReadSnapshot>;
+export declare function registerGrokBotTools(server: McpServer, transport: GrokBotTransport): void;