@pencil-agent/nano-pencil 2.0.0-beta.2 → 2.0.0-beta.3

package/dist/node_modules/@pencil-agent/ai/dist/providers/azure-openai-responses.d.ts

@@ -0,0 +1,21 @@
+/**
+ * [WHO]: AzureOpenAIResponsesOptions, streamAzureOpenAIResponses, streamSimpleAzureOpenAIResponses
+ * [FROM]: Depends on openai, ../env-api-keys.js, ../models.js, ../utils/event-stream.js, ./openai-responses-shared.js
+ * [TO]: Consumed by core/lib/ai/src/index.ts
+ * [HERE]: core/lib/ai/src/providers/azure-openai-responses.ts -
+ */
+import type { SimpleStreamOptions, StreamFunction, StreamOptions } from "../types.js";
+export interface AzureOpenAIResponsesOptions extends StreamOptions {
+    reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh";
+    reasoningSummary?: "auto" | "detailed" | "concise" | null;
+    toolChoice?: unknown;
+    azureApiVersion?: string;
+    azureResourceName?: string;
+    azureBaseUrl?: string;
+    azureDeploymentName?: string;
+}
+/**
+ * Generate function for Azure OpenAI Responses API
+ */
+export declare const streamAzureOpenAIResponses: StreamFunction<"azure-openai-responses", AzureOpenAIResponsesOptions>;
+export declare const streamSimpleAzureOpenAIResponses: StreamFunction<"azure-openai-responses", SimpleStreamOptions>;

package/dist/node_modules/@pencil-agent/ai/dist/providers/azure-openai-responses.js

@@ -0,0 +1,193 @@
+/**
+ * [WHO]: AzureOpenAIResponsesOptions, streamAzureOpenAIResponses, streamSimpleAzureOpenAIResponses
+ * [FROM]: Depends on openai, ../env-api-keys.js, ../models.js, ../utils/event-stream.js, ./openai-responses-shared.js
+ * [TO]: Consumed by core/lib/ai/src/index.ts
+ * [HERE]: core/lib/ai/src/providers/azure-openai-responses.ts -
+ */
+import { AzureOpenAI } from "openai";
+import { getEnvApiKey } from "../env-api-keys.js";
+import { supportsXhigh } from "../models.js";
+import { AssistantMessageEventStream } from "../utils/event-stream.js";
+import { convertResponsesMessages, convertResponsesTools, processResponsesStream } from "./openai-responses-shared.js";
+import { buildBaseOptions, clampReasoning } from "./simple-options.js";
+const DEFAULT_AZURE_API_VERSION = "v1";
+const AZURE_TOOL_CALL_PROVIDERS = new Set(["openai", "openai-codex", "opencode", "azure-openai-responses"]);
+function parseDeploymentNameMap(value) {
+    const map = new Map();
+    if (!value)
+        return map;
+    for (const entry of value.split(",")) {
+        const trimmed = entry.trim();
+        if (!trimmed)
+            continue;
+        const [modelId, deploymentName] = trimmed.split("=", 2);
+        if (!modelId || !deploymentName)
+            continue;
+        map.set(modelId.trim(), deploymentName.trim());
+    }
+    return map;
+}
+function resolveDeploymentName(model, options) {
+    if (options?.azureDeploymentName) {
+        return options.azureDeploymentName;
+    }
+    const mappedDeployment = parseDeploymentNameMap(process.env.AZURE_OPENAI_DEPLOYMENT_NAME_MAP).get(model.id);
+    return mappedDeployment || model.id;
+}
+/**
+ * Generate function for Azure OpenAI Responses API
+ */
+export const streamAzureOpenAIResponses = (model, context, options) => {
+    const stream = new AssistantMessageEventStream();
+    // Start async processing
+    (async () => {
+        const deploymentName = resolveDeploymentName(model, options);
+        const output = {
+            role: "assistant",
+            content: [],
+            api: "azure-openai-responses",
+            provider: model.provider,
+            model: model.id,
+            usage: {
+                input: 0,
+                output: 0,
+                cacheRead: 0,
+                cacheWrite: 0,
+                totalTokens: 0,
+                cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+            },
+            stopReason: "stop",
+            timestamp: Date.now(),
+        };
+        try {
+            // Create Azure OpenAI client
+            const apiKey = options?.apiKey || getEnvApiKey(model.provider) || "";
+            const client = createClient(model, apiKey, options);
+            const params = buildParams(model, context, options, deploymentName);
+            options?.onPayload?.(params);
+            const openaiStream = await client.responses.create(params, options?.signal ? { signal: options.signal } : undefined);
+            stream.push({ type: "start", partial: output });
+            await processResponsesStream(openaiStream, output, stream, model);
+            if (options?.signal?.aborted) {
+                throw new Error("Request was aborted");
+            }
+            if (output.stopReason === "aborted" || output.stopReason === "error") {
+                throw new Error("An unknown error occurred");
+            }
+            stream.push({ type: "done", reason: output.stopReason, message: output });
+            stream.end();
+        }
+        catch (error) {
+            for (const block of output.content)
+                delete block.index;
+            output.stopReason = options?.signal?.aborted ? "aborted" : "error";
+            output.errorMessage = error instanceof Error ? error.message : JSON.stringify(error);
+            stream.push({ type: "error", reason: output.stopReason, error: output });
+            stream.end();
+        }
+    })();
+    return stream;
+};
+export const streamSimpleAzureOpenAIResponses = (model, context, options) => {
+    const apiKey = options?.apiKey || getEnvApiKey(model.provider);
+    if (!apiKey) {
+        throw new Error(`No API key for provider: ${model.provider}`);
+    }
+    const base = buildBaseOptions(model, options, apiKey);
+    const reasoningEffort = supportsXhigh(model) ? options?.reasoning : clampReasoning(options?.reasoning);
+    return streamAzureOpenAIResponses(model, context, {
+        ...base,
+        reasoningEffort,
+        toolChoice: options?.toolChoice,
+    });
+};
+function normalizeAzureBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, "");
+}
+function buildDefaultBaseUrl(resourceName) {
+    return `https://${resourceName}.openai.azure.com/openai/v1`;
+}
+function resolveAzureConfig(model, options) {
+    const apiVersion = options?.azureApiVersion || process.env.AZURE_OPENAI_API_VERSION || DEFAULT_AZURE_API_VERSION;
+    const baseUrl = options?.azureBaseUrl?.trim() || process.env.AZURE_OPENAI_BASE_URL?.trim() || undefined;
+    const resourceName = options?.azureResourceName || process.env.AZURE_OPENAI_RESOURCE_NAME;
+    let resolvedBaseUrl = baseUrl;
+    if (!resolvedBaseUrl && resourceName) {
+        resolvedBaseUrl = buildDefaultBaseUrl(resourceName);
+    }
+    if (!resolvedBaseUrl && model.baseUrl) {
+        resolvedBaseUrl = model.baseUrl;
+    }
+    if (!resolvedBaseUrl) {
+        throw new Error("Azure OpenAI base URL is required. Set AZURE_OPENAI_BASE_URL or AZURE_OPENAI_RESOURCE_NAME, or pass azureBaseUrl, azureResourceName, or model.baseUrl.");
+    }
+    return {
+        baseUrl: normalizeAzureBaseUrl(resolvedBaseUrl),
+        apiVersion,
+    };
+}
+function createClient(model, apiKey, options) {
+    if (!apiKey) {
+        if (!process.env.AZURE_OPENAI_API_KEY) {
+            throw new Error("Azure OpenAI API key is required. Set AZURE_OPENAI_API_KEY environment variable or pass it as an argument.");
+        }
+        apiKey = process.env.AZURE_OPENAI_API_KEY;
+    }
+    const headers = { ...model.headers };
+    if (options?.headers) {
+        Object.assign(headers, options.headers);
+    }
+    const { baseUrl, apiVersion } = resolveAzureConfig(model, options);
+    return new AzureOpenAI({
+        apiKey,
+        apiVersion,
+        dangerouslyAllowBrowser: true,
+        defaultHeaders: headers,
+        baseURL: baseUrl,
+    });
+}
+function buildParams(model, context, options, deploymentName) {
+    const messages = convertResponsesMessages(model, context, AZURE_TOOL_CALL_PROVIDERS);
+    const params = {
+        model: deploymentName,
+        input: messages,
+        stream: true,
+        prompt_cache_key: options?.sessionId,
+    };
+    if (options?.maxTokens) {
+        params.max_output_tokens = options?.maxTokens;
+    }
+    if (options?.temperature !== undefined) {
+        params.temperature = options?.temperature;
+    }
+    if (context.tools) {
+        params.tools = convertResponsesTools(context.tools);
+    }
+    if (options?.toolChoice !== undefined) {
+        params.tool_choice = options.toolChoice;
+    }
+    if (model.reasoning) {
+        if (options?.reasoningEffort || options?.reasoningSummary) {
+            params.reasoning = {
+                effort: options?.reasoningEffort || "medium",
+                summary: options?.reasoningSummary || "auto",
+            };
+            params.include = ["reasoning.encrypted_content"];
+        }
+        else {
+            if (model.name.toLowerCase().startsWith("gpt-5")) {
+                // Jesus Christ, see https://community.openai.com/t/need-reasoning-false-option-for-gpt-5/1351588/7
+                messages.push({
+                    role: "developer",
+                    content: [
+                        {
+                            type: "input_text",
+                            text: "# Juice: 0 !important",
+                        },
+                    ],
+                });
+            }
+        }
+    }
+    return params;
+}

package/dist/node_modules/@pencil-agent/ai/dist/providers/github-copilot-headers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * [WHO]: inferCopilotInitiator, hasCopilotVisionInput, buildCopilotDynamicHeaders
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/lib/ai/src/index.ts
+ * [HERE]: core/lib/ai/src/providers/github-copilot-headers.ts -
+ */
+import type { Message } from "../types.js";
+export declare function inferCopilotInitiator(messages: Message[]): "user" | "agent";
+export declare function hasCopilotVisionInput(messages: Message[]): boolean;
+export declare function buildCopilotDynamicHeaders(params: {
+    messages: Message[];
+    hasImages: boolean;
+}): Record<string, string>;

package/dist/node_modules/@pencil-agent/ai/dist/providers/github-copilot-headers.js

@@ -0,0 +1,34 @@
+/**
+ * [WHO]: inferCopilotInitiator, hasCopilotVisionInput, buildCopilotDynamicHeaders
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/lib/ai/src/index.ts
+ * [HERE]: core/lib/ai/src/providers/github-copilot-headers.ts -
+ */
+// Copilot expects X-Initiator to indicate whether the request is user-initiated
+// or agent-initiated (e.g. follow-up after assistant/tool messages).
+export function inferCopilotInitiator(messages) {
+    const last = messages[messages.length - 1];
+    return last && last.role !== "user" ? "agent" : "user";
+}
+// Copilot requires Copilot-Vision-Request header when sending images
+export function hasCopilotVisionInput(messages) {
+    return messages.some((msg) => {
+        if (msg.role === "user" && Array.isArray(msg.content)) {
+            return msg.content.some((c) => c.type === "image");
+        }
+        if (msg.role === "toolResult" && Array.isArray(msg.content)) {
+            return msg.content.some((c) => c.type === "image");
+        }
+        return false;
+    });
+}
+export function buildCopilotDynamicHeaders(params) {
+    const headers = {
+        "X-Initiator": inferCopilotInitiator(params.messages),
+        "Openai-Intent": "conversation-edits",
+    };
+    if (params.hasImages) {
+        headers["Copilot-Vision-Request"] = "true";
+    }
+    return headers;
+}

package/dist/node_modules/@pencil-agent/ai/dist/providers/google-gemini-cli.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Google Gemini CLI / Antigravity provider.
+ * Shared implementation for both google-gemini-cli and google-antigravity providers.
+ * Uses the Cloud Code Assist API endpoint to access Gemini and Claude models.
+ */
+/**
+ * [WHO]: GoogleGeminiCliOptions, extractRetryDelay, streamGoogleGeminiCli, streamSimpleGoogleGeminiCli, buildRequest
+ * [FROM]: Depends on ../models.js, ../utils/event-stream.js, ../utils/sanitize-unicode.js, ./simple-options.js
+ * [TO]: Consumed by core/lib/ai/src/index.ts
+ * [HERE]: core/lib/ai/src/providers/google-gemini-cli.ts -
+ */
+import type { Content, ThinkingConfig } from "@google/genai";
+import type { Context, Model, SimpleStreamOptions, StreamFunction, StreamOptions } from "../types.js";
+import { convertTools, mapToolChoice } from "./google-shared.js";
+/**
+ * Thinking level for Gemini 3 models.
+ * Mirrors Google's ThinkingLevel enum values.
+ */
+export type GoogleThinkingLevel = "THINKING_LEVEL_UNSPECIFIED" | "MINIMAL" | "LOW" | "MEDIUM" | "HIGH";
+export interface GoogleGeminiCliOptions extends StreamOptions {
+    toolChoice?: "auto" | "none" | "any";
+    /**
+     * Thinking/reasoning configuration.
+     * - Gemini 2.x models: use `budgetTokens` to set the thinking budget
+     * - Gemini 3 models (gemini-3-pro-*, gemini-3-flash-*): use `level` instead
+     *
+     * When using `streamSimple`, this is handled automatically based on the model.
+     */
+    thinking?: {
+        enabled: boolean;
+        /** Thinking budget in tokens. Use for Gemini 2.x models. */
+        budgetTokens?: number;
+        /** Thinking level. Use for Gemini 3 models (LOW/HIGH for Pro, MINIMAL/LOW/MEDIUM/HIGH for Flash). */
+        level?: GoogleThinkingLevel;
+    };
+    projectId?: string;
+}
+/**
+ * Extract retry delay from Gemini error response (in milliseconds).
+ * Checks headers first (Retry-After, x-ratelimit-reset, x-ratelimit-reset-after),
+ * then parses body patterns like:
+ * - "Your quota will reset after 39s"
+ * - "Your quota will reset after 18h31m10s"
+ * - "Please retry in Xs" or "Please retry in Xms"
+ * - "retryDelay": "34.074824224s" (JSON field)
+ */
+export declare function extractRetryDelay(errorText: string, response?: Response | Headers): number | undefined;
+interface CloudCodeAssistRequest {
+    project: string;
+    model: string;
+    request: {
+        contents: Content[];
+        sessionId?: string;
+        systemInstruction?: {
+            role?: string;
+            parts: {
+                text: string;
+            }[];
+        };
+        generationConfig?: {
+            maxOutputTokens?: number;
+            temperature?: number;
+            thinkingConfig?: ThinkingConfig;
+        };
+        tools?: ReturnType<typeof convertTools>;
+        toolConfig?: {
+            functionCallingConfig: {
+                mode: ReturnType<typeof mapToolChoice>;
+            };
+        };
+    };
+    requestType?: string;
+    userAgent?: string;
+    requestId?: string;
+}
+export declare const streamGoogleGeminiCli: StreamFunction<"google-gemini-cli", GoogleGeminiCliOptions>;
+export declare const streamSimpleGoogleGeminiCli: StreamFunction<"google-gemini-cli", SimpleStreamOptions>;
+export declare function buildRequest(model: Model<"google-gemini-cli">, context: Context, projectId: string, options?: GoogleGeminiCliOptions, isAntigravity?: boolean): CloudCodeAssistRequest;
+export {};