@omnicross/core 0.1.0

package/dist/transformer/transformers/GeminiCodeAssistTransformer.d.cts

@@ -0,0 +1,102 @@
+import { Transformer, TransformerLogger, UnifiedChatRequest, LLMProvider, TransformerContext } from '../types.cjs';
+
+/**
+ * GeminiCodeAssistTransformer — Google **Code Assist** envelope for the gemini
+ * SUBSCRIPTION path (`cloudcode-pa.googleapis.com`).
+ *
+ * The gemini-CLI OAuth subscription tokens are minted for Google's internal
+ * Code Assist API, NOT the public Gemini API. Code Assist wraps the standard
+ * `generateContent` body in a project/session envelope and uses a different
+ * URL shape (version segment + colon-method, NO `/models/<model>` path). This
+ * transformer does ONLY that envelope work and DELEGATES all inner encoding /
+ * parsing to the existing gemini utils (`buildRequestBody`,
+ * `transformResponseOut`) so the two stay in lock-step.
+ *
+ * Envelope spec — verified against gemini-cli
+ * `packages/core/src/code_assist/{server,converter,setup,types}.ts`:
+ *
+ *   Request (CAGenerateContentRequest):
+ *     {
+ *       model: "gemini-2.5-pro",        // TOP-LEVEL (NOT inside `request`)
+ *       project: <resolved project id>, // TOP-LEVEL, undefined for fresh free-tier
+ *       user_prompt_id: <per-turn id>,  // TOP-LEVEL, snake_case
+ *       request: { contents, systemInstruction, tools, toolConfig,
+ *                  generationConfig, ... }   // standard public-Gemini body
+ *     }
+ *
+ *   URL: `${base}/${version}:${method}` — colon AFTER the version segment, NO
+ *        `/models/<model>` (model lives in the body). `base` defaults to
+ *        `https://cloudcode-pa.googleapis.com`, `version` to `v1internal`;
+ *        both overridable via `CODE_ASSIST_ENDPOINT` / `CODE_ASSIST_API_VERSION`.
+ *        Stream method `streamGenerateContent?alt=sse`, non-stream
+ *        `generateContent`.
+ *
+ *   Auth: `Authorization: Bearer <oauth access token>` ONLY (no x-goog-api-key).
+ *         The actual Bearer is injected downstream by the subscription
+ *         `OAuthBearerAuthStrategy`; this transformer just clears x-goog-api-key.
+ *
+ *   Response (CaGenerateContentResponse): the standard `GenerateContentResponse`
+ *     is nested under a top-level `response` key. We PEEL `.response` from the
+ *     body / each SSE `data:` chunk, then hand the unwrapped stream/JSON to the
+ *     existing gemini response parser (`transformResponseOut`).
+ *
+ * @module transformer/transformers/GeminiCodeAssistTransformer
+ */
+
+/** Resolve the Code Assist base URL (env override allowed). */
+declare function resolveCodeAssistEndpoint(): string;
+/** Resolve the Code Assist API version segment (env override allowed). */
+declare function resolveCodeAssistApiVersion(): string;
+/**
+ * Build the Code Assist URL: `${base}/${version}:${method}`.
+ * NOTE: no `/models/<model>` segment — the model goes in the body.
+ */
+declare function buildCodeAssistUrl(stream: boolean): string;
+/**
+ * GeminiCodeAssistTransformer — extends `GeminiTransformer`'s inner encoding by
+ * wrapping it in the Code Assist envelope. Registered under
+ * `gemini-code-assist` so `getTransformer('gemini-code-assist')` resolves.
+ */
+declare class GeminiCodeAssistTransformer implements Transformer {
+    static TransformerName: string;
+    name: string;
+    logger?: TransformerLogger;
+    /** Code Assist has no fixed `/models/:modelAndAction` endpoint pattern — the
+     *  URL is built per-request in `transformRequestIn`. Left undefined so the
+     *  TransformerService does NOT treat this as an endpoint (reverse) transformer. */
+    endPoint: undefined;
+    /**
+     * unified → Code Assist envelope.
+     *
+     * Builds the inner public-Gemini body via the shared `buildRequestBody`, then
+     * wraps it as `{ model, project, user_prompt_id, request: <inner> }` and sets
+     * the Code Assist URL + Bearer-only headers.
+     *
+     * The resolved Code Assist `project` is threaded in via `provider.geminiProject`
+     * (stashed by the subscription dispatch seam — see SubscriptionDispatcher /
+     * openaiResponsesIngress). `undefined` is the valid fresh free-tier value.
+     */
+    transformRequestIn(request: UnifiedChatRequest, provider: LLMProvider, _context: TransformerContext): Promise<Record<string, unknown>>;
+    /**
+     * Code Assist request → unified (endpoint-decode parity with GeminiTransformer).
+     * Peels the top-level `request` envelope first, then delegates to the shared
+     * gemini request decoder. Not used on the subscription dispatch path (the
+     * endpoint transformer there is Anthropic/OpenAI-Response), but provided for
+     * completeness so this transformer is a drop-in for the gemini one.
+     */
+    transformRequestOut(request: unknown, _context: TransformerContext): Promise<UnifiedChatRequest>;
+    /**
+     * Code Assist response → OpenAI-compatible. PEEL the `.response` envelope from
+     * the body / each SSE chunk, then DELEGATE to the existing gemini parser.
+     */
+    transformResponseOut(response: Response, _context: TransformerContext): Promise<Response>;
+    /**
+     * OpenAI-compatible response → Code Assist (endpoint-encode parity). Re-wraps
+     * the standard gemini response under the top-level `response` key after the
+     * shared gemini encoder produces a public-Gemini body. Symmetric with
+     * `transformResponseOut`'s peel.
+     */
+    transformResponseIn(response: Response, _context?: TransformerContext): Promise<Response>;
+}
+
+export { GeminiCodeAssistTransformer, buildCodeAssistUrl, resolveCodeAssistApiVersion, resolveCodeAssistEndpoint };

package/dist/transformer/transformers/GeminiCodeAssistTransformer.d.ts

@@ -0,0 +1,102 @@
+import { Transformer, TransformerLogger, UnifiedChatRequest, LLMProvider, TransformerContext } from '../types.js';
+
+/**
+ * GeminiCodeAssistTransformer — Google **Code Assist** envelope for the gemini
+ * SUBSCRIPTION path (`cloudcode-pa.googleapis.com`).
+ *
+ * The gemini-CLI OAuth subscription tokens are minted for Google's internal
+ * Code Assist API, NOT the public Gemini API. Code Assist wraps the standard
+ * `generateContent` body in a project/session envelope and uses a different
+ * URL shape (version segment + colon-method, NO `/models/<model>` path). This
+ * transformer does ONLY that envelope work and DELEGATES all inner encoding /
+ * parsing to the existing gemini utils (`buildRequestBody`,
+ * `transformResponseOut`) so the two stay in lock-step.
+ *
+ * Envelope spec — verified against gemini-cli
+ * `packages/core/src/code_assist/{server,converter,setup,types}.ts`:
+ *
+ *   Request (CAGenerateContentRequest):
+ *     {
+ *       model: "gemini-2.5-pro",        // TOP-LEVEL (NOT inside `request`)
+ *       project: <resolved project id>, // TOP-LEVEL, undefined for fresh free-tier
+ *       user_prompt_id: <per-turn id>,  // TOP-LEVEL, snake_case
+ *       request: { contents, systemInstruction, tools, toolConfig,
+ *                  generationConfig, ... }   // standard public-Gemini body
+ *     }
+ *
+ *   URL: `${base}/${version}:${method}` — colon AFTER the version segment, NO
+ *        `/models/<model>` (model lives in the body). `base` defaults to
+ *        `https://cloudcode-pa.googleapis.com`, `version` to `v1internal`;
+ *        both overridable via `CODE_ASSIST_ENDPOINT` / `CODE_ASSIST_API_VERSION`.
+ *        Stream method `streamGenerateContent?alt=sse`, non-stream
+ *        `generateContent`.
+ *
+ *   Auth: `Authorization: Bearer <oauth access token>` ONLY (no x-goog-api-key).
+ *         The actual Bearer is injected downstream by the subscription
+ *         `OAuthBearerAuthStrategy`; this transformer just clears x-goog-api-key.
+ *
+ *   Response (CaGenerateContentResponse): the standard `GenerateContentResponse`
+ *     is nested under a top-level `response` key. We PEEL `.response` from the
+ *     body / each SSE `data:` chunk, then hand the unwrapped stream/JSON to the
+ *     existing gemini response parser (`transformResponseOut`).
+ *
+ * @module transformer/transformers/GeminiCodeAssistTransformer
+ */
+
+/** Resolve the Code Assist base URL (env override allowed). */
+declare function resolveCodeAssistEndpoint(): string;
+/** Resolve the Code Assist API version segment (env override allowed). */
+declare function resolveCodeAssistApiVersion(): string;
+/**
+ * Build the Code Assist URL: `${base}/${version}:${method}`.
+ * NOTE: no `/models/<model>` segment — the model goes in the body.
+ */
+declare function buildCodeAssistUrl(stream: boolean): string;
+/**
+ * GeminiCodeAssistTransformer — extends `GeminiTransformer`'s inner encoding by
+ * wrapping it in the Code Assist envelope. Registered under
+ * `gemini-code-assist` so `getTransformer('gemini-code-assist')` resolves.
+ */
+declare class GeminiCodeAssistTransformer implements Transformer {
+    static TransformerName: string;
+    name: string;
+    logger?: TransformerLogger;
+    /** Code Assist has no fixed `/models/:modelAndAction` endpoint pattern — the
+     *  URL is built per-request in `transformRequestIn`. Left undefined so the
+     *  TransformerService does NOT treat this as an endpoint (reverse) transformer. */
+    endPoint: undefined;
+    /**
+     * unified → Code Assist envelope.
+     *
+     * Builds the inner public-Gemini body via the shared `buildRequestBody`, then
+     * wraps it as `{ model, project, user_prompt_id, request: <inner> }` and sets
+     * the Code Assist URL + Bearer-only headers.
+     *
+     * The resolved Code Assist `project` is threaded in via `provider.geminiProject`
+     * (stashed by the subscription dispatch seam — see SubscriptionDispatcher /
+     * openaiResponsesIngress). `undefined` is the valid fresh free-tier value.
+     */
+    transformRequestIn(request: UnifiedChatRequest, provider: LLMProvider, _context: TransformerContext): Promise<Record<string, unknown>>;
+    /**
+     * Code Assist request → unified (endpoint-decode parity with GeminiTransformer).
+     * Peels the top-level `request` envelope first, then delegates to the shared
+     * gemini request decoder. Not used on the subscription dispatch path (the
+     * endpoint transformer there is Anthropic/OpenAI-Response), but provided for
+     * completeness so this transformer is a drop-in for the gemini one.
+     */
+    transformRequestOut(request: unknown, _context: TransformerContext): Promise<UnifiedChatRequest>;
+    /**
+     * Code Assist response → OpenAI-compatible. PEEL the `.response` envelope from
+     * the body / each SSE chunk, then DELEGATE to the existing gemini parser.
+     */
+    transformResponseOut(response: Response, _context: TransformerContext): Promise<Response>;
+    /**
+     * OpenAI-compatible response → Code Assist (endpoint-encode parity). Re-wraps
+     * the standard gemini response under the top-level `response` key after the
+     * shared gemini encoder produces a public-Gemini body. Symmetric with
+     * `transformResponseOut`'s peel.
+     */
+    transformResponseIn(response: Response, _context?: TransformerContext): Promise<Response>;
+}
+
+export { GeminiCodeAssistTransformer, buildCodeAssistUrl, resolveCodeAssistApiVersion, resolveCodeAssistEndpoint };