@xiaozhiclaw/provider-core 0.1.0

package/dist/transports/volcengine-responses.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Volcengine Responses API TransportSSE streaming implementation.
+ *
+ * Implements the fire mountain ark Responses API (`/api/v3/responses`),
+ * which is the officially recommended primary path for Doubao LLM text generation
+ * (250615+ models: doubao-seed-2.0 series).
+ *
+ * Key differences from OpenAI Chat Completions:
+ *   - Endpoint: POST {baseUrl}/v3/responses
+ *   - Request body uses `input` (not `messages`), `instructions`, `thinking`, `reasoning`
+ *   - SSE events: response.output_text.delta, response.reasoning_summary_text.delta,
+ *     response.function_call_arguments.delta, response.completed, etc.
+ *   - Tool calling: function_call / function_call_output with call_id
+ *   - Context persistence: previous_response_id for server-side session continuation
+ *   - Deep thinking: thinking.type (enabled/disabled/auto) + reasoning.effort
+ *
+ * Docs: https://www.volcengine.com/docs/82379/1399008
+ */
+import type { LLMChunk, LLMRequest, LLMTransport } from "../transport.js";
+import type { ProviderQuirks } from "../provider-def.js";
+import type { FileUploadAdapter } from "../file-upload-service.js";
+export interface VolcengineResponsesTransportConfig {
+    baseUrl: string;
+    extraHeaders?: Record<string, string>;
+    timeoutMs?: number;
+    quirks?: ProviderQuirks;
+    /** File upload adapter for resolving local media URLs via upload instead of base64. */
+    fileUploadAdapter?: FileUploadAdapter;
+}
+export declare class VolcengineResponsesTransport implements LLMTransport {
+    private baseUrl;
+    private extraHeaders;
+    private timeoutMs;
+    private quirks;
+    private fileUploadAdapter?;
+    constructor(config: VolcengineResponsesTransportConfig);
+    stream(request: LLMRequest, apiKey: string, signal?: AbortSignal): AsyncGenerator<LLMChunk>;
+    /**
+     * Resolve known Volcengine Responses API incompatibilities:
+     *   - instructions + caching 閳?drop caching (鎼?0.7)
+     *   - caching + json_schema 閳?downgrade to json_object (鎼?0.10)
+     *   - caching + builtin_web_search/image_process 閳?drop those builtin tools
+     * Returns a shallow copy with fields adjusted; never mutates the original.
+     */
+    private resolveConstraints;
+    private buildRequestBody;
+    private fetchAndStream;
+    private handleNonStreamingResponse;
+    /**
+     * Parse Volcengine Responses API SSE stream.
+     *
+     * Event format: "event: <type>\ndata: <json>\n\n"
+     * Key events:
+     *   - response.output_text.delta           閳?text content delta
+     *   - response.reasoning_summary_text.delta 閳?thinking/reasoning text
+     *   - response.function_call_arguments.delta 閳?tool call arguments streaming
+     *   - response.output_item.added           閳?new output item started
+     *   - response.output_item.done            閳?output item completed
+     *   - response.completed                   閳?full response complete with usage
+     *   - response.failed                      閳?error
+     */
+    private parseSSEStream;
+    private processEvent;
+}