opencode-puter-auth 1.0.2 → 1.0.3

package/dist/provider.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Puter Provider Integration
+ *
+ * This module provides two transformation paths:
+ *
+ * 1. Google Generative Language API format (for google provider integration)
+ *    - Used when Puter models are configured under provider.google
+ *    - Transforms Google's format to Puter's format
+ *
+ * 2. OpenAI-compatible format (for standalone puter provider)
+ *    - Used when Puter is configured as a separate provider with @ai-sdk/openai-compatible
+ *    - Transforms OpenAI's format to Puter's format
+ *
+ * The custom fetch function intercepts requests and routes them to Puter's API.
+ */
+import type { PuterChatMessage, PuterChatStreamChunk, PuterConfig } from './types.js';
+/**
+ * Check if a request is targeting the Puter provider
+ */
+export declare function isPuterRequest(input: RequestInfo | URL): boolean;
+/**
+ * Check if the request is using OpenAI format (vs Google format)
+ */
+export declare function isOpenAIFormat(url: string): boolean;
+/**
+ * Extract model ID from the request URL
+ */
+export declare function extractModelFromUrl(url: string): string;
+/**
+ * Check if the request is for streaming
+ */
+export declare function isStreamingRequest(url: string): boolean;
+/**
+ * Transform OpenAI chat completion request to Puter format
+ */
+export declare function transformOpenAIToPuter(body: OpenAIChatCompletionRequest, authToken: string): PuterRequestBody;
+/**
+ * Transform Puter response to OpenAI chat completion format
+ */
+export declare function transformPuterToOpenAI(puterResponse: PuterChatResponse): OpenAIChatCompletionResponse;
+/**
+ * Transform Puter stream chunk to OpenAI SSE format
+ */
+export declare function transformPuterStreamToOpenAI(chunk: PuterChatStreamChunk): string;
+/**
+ * Transform Google Generative Language API request body to Puter format
+ */
+export declare function transformRequestToPuter(body: GoogleGenerateContentRequest, model: string, streaming: boolean, authToken: string): PuterRequestBody;
+/**
+ * Transform Puter response to Google Generative Language API format
+ */
+export declare function transformPuterResponseToGoogle(puterResponse: PuterChatResponse): GoogleGenerateContentResponse;
+/**
+ * Transform a Puter streaming chunk to Google SSE format
+ */
+export declare function transformPuterStreamChunkToGoogle(chunk: PuterChatStreamChunk): string;
+/**
+ * Make a request to Puter API and return transformed response
+ */
+export declare function makePuterRequest(input: RequestInfo | URL, init: RequestInit | undefined, authToken: string, config?: Partial<PuterConfig>): Promise<Response>;
+/**
+ * Create a custom fetch function for Puter provider integration.
+ *
+ * This function intercepts requests to Puter endpoints and routes them
+ * through Puter's API with proper request/response transformation.
+ *
+ * Supports both OpenAI-compatible format (for standalone puter provider)
+ * and Google Generative Language API format (for google provider integration).
+ *
+ * @param authToken - The Puter authentication token
+ * @param config - Optional Puter configuration
+ * @returns A fetch function that can be used by OpenCode's AI SDK
+ */
+export declare function createPuterFetch(authToken: string, config?: Partial<PuterConfig>): typeof fetch;
+interface OpenAIChatCompletionRequest {
+    model?: string;
+    messages?: Array<{
+        role: 'system' | 'user' | 'assistant' | 'tool';
+        content: string | null;
+        tool_call_id?: string;
+        tool_calls?: Array<{
+            id: string;
+            type: 'function';
+            function: {
+                name: string;
+                arguments: string;
+            };
+        }>;
+    }>;
+    tools?: Array<{
+        type: 'function';
+        function: {
+            name: string;
+            description?: string;
+            parameters?: Record<string, unknown>;
+        };
+    }>;
+    max_tokens?: number;
+    temperature?: number;
+    stream?: boolean;
+}
+interface OpenAIChatCompletionResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: {
+            role: 'assistant';
+            content: string | null;
+            tool_calls?: Array<{
+                id: string;
+                type: 'function';
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+            }>;
+        };
+        finish_reason: 'stop' | 'tool_calls' | 'length' | null;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+interface GooglePart {
+    text?: string;
+    thought?: boolean;
+    functionCall?: {
+        name: string;
+        args: unknown;
+    };
+    functionResponse?: {
+        name: string;
+        response: unknown;
+        id?: string;
+    };
+}
+interface GoogleContent {
+    role: string;
+    parts: GooglePart[];
+}
+interface GoogleGenerateContentRequest {
+    contents?: GoogleContent[];
+    systemInstruction?: string | {
+        parts: {
+            text: string;
+        }[];
+    };
+    generationConfig?: {
+        maxOutputTokens?: number;
+        temperature?: number;
+        topP?: number;
+        topK?: number;
+        thinkingConfig?: {
+            thinkingBudget?: number;
+        };
+    };
+    tools?: Array<{
+        functionDeclarations?: Array<{
+            name: string;
+            description?: string;
+            parameters?: Record<string, unknown>;
+        }>;
+    }>;
+}
+interface GoogleGenerateContentResponse {
+    candidates: Array<{
+        content: {
+            role: string;
+            parts: GooglePart[];
+        };
+        finishReason?: string;
+        index: number;
+    }>;
+    usageMetadata?: {
+        promptTokenCount?: number;
+        candidatesTokenCount?: number;
+        totalTokenCount?: number;
+    };
+}
+interface PuterTool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+interface PuterRequestBody {
+    interface: string;
+    service: string;
+    method: string;
+    args: {
+        messages: PuterChatMessage[];
+        model: string;
+        stream: boolean;
+        max_tokens?: number;
+        temperature?: number;
+        tools?: PuterTool[];
+    };
+    auth_token: string;
+}
+interface PuterChatResponse {
+    message?: {
+        role: string;
+        content: string | null;
+        tool_calls?: Array<{
+            id: string;
+            type: string;
+            function: {
+                name: string;
+                arguments: string;
+            };
+        }>;
+    };
+    finish_reason?: string;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

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