@vybestack/llxprt-code-agents 0.10.0-nightly.260613.1adad3b34

package/dist/src/core/subagentToolProcessing.js

@@ -0,0 +1,359 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { executeToolCall, } from './nonInteractiveToolExecutor.js';
+import { ToolErrorType } from '@vybestack/llxprt-code-tools';
+import { LocalTodoStore as TodoStore } from '@vybestack/llxprt-code-tools';
+import { debugLogger } from '@vybestack/llxprt-code-core/utils/debugLogger.js';
+import { SubagentTerminateMode, } from '@vybestack/llxprt-code-core/core/subagentTypes.js';
+import { createSchedulerConfig } from './subagentRuntimeSetup.js';
+import { getHookRestrictedAllowedToolsForFunctionCall, isHookRestrictedToolCall, } from './hookToolRestrictions.js';
+// ---------------------------------------------------------------------------
+// Pure helpers
+// ---------------------------------------------------------------------------
+export function toSnakeCase(value) {
+    return value
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/[\s-]+/g, '_')
+        .toLowerCase();
+}
+export function isFatalToolError(errorType) {
+    return (errorType === ToolErrorType.TOOL_DISABLED ||
+        errorType === ToolErrorType.TOOL_NOT_REGISTERED);
+}
+export function extractToolDetail(resultDisplay, error) {
+    if (error?.message) {
+        return error.message;
+    }
+    if (typeof resultDisplay === 'string') {
+        return resultDisplay;
+    }
+    if (resultDisplay &&
+        typeof resultDisplay === 'object' &&
+        'message' in resultDisplay &&
+        typeof resultDisplay.message === 'string') {
+        return resultDisplay.message;
+    }
+    const missingResultDisplay = void 0;
+    return missingResultDisplay;
+}
+export function buildToolUnavailableMessage(toolName, resultDisplay, error) {
+    const detail = extractToolDetail(resultDisplay, error);
+    const baseMessage = `Tool "${toolName}" is not available in this environment.`;
+    return detail
+        ? `${baseMessage} ${detail}`
+        : `${baseMessage} Please continue without using it.`;
+}
+// ---------------------------------------------------------------------------
+// Fuzzy tool name resolution
+// ---------------------------------------------------------------------------
+export function resolveToolName(rawName, toolsView) {
+    if (!rawName) {
+        const missingToolName = null;
+        return missingToolName;
+    }
+    const candidates = new Set();
+    const trimmed = rawName.trim();
+    if (trimmed) {
+        candidates.add(trimmed);
+        candidates.add(trimmed.toLowerCase());
+    }
+    if (trimmed.endsWith('Tool')) {
+        const withoutSuffix = trimmed.slice(0, -4);
+        if (withoutSuffix) {
+            candidates.add(withoutSuffix);
+            candidates.add(withoutSuffix.toLowerCase());
+            candidates.add(toSnakeCase(withoutSuffix));
+        }
+    }
+    candidates.add(toSnakeCase(trimmed));
+    for (const candidate of candidates) {
+        if (!candidate) {
+            continue;
+        }
+        if (toolsView.getToolMetadata(candidate)) {
+            return candidate;
+        }
+    }
+    const unresolvedToolName = null;
+    return unresolvedToolName;
+}
+// ---------------------------------------------------------------------------
+// Output finalization
+// ---------------------------------------------------------------------------
+export function finalizeOutput(output) {
+    const message = output.final_message;
+    if (typeof message === 'string' && message.trim().length > 0) {
+        return;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Subagent tool-call runtime payloads.
+    const emittedVars = output.emitted_vars ?? {};
+    const emittedEntries = Object.entries(emittedVars)
+        .filter(([, value]) => 
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Subagent tool-call runtime payloads.
+    value !== undefined &&
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Subagent tool-call runtime payloads.
+        value !== null &&
+        String(value).trim().length > 0)
+        .map(([key, value]) => `${key}=${String(value)}`);
+    let baseMessage;
+    switch (output.terminate_reason) {
+        case SubagentTerminateMode.GOAL:
+            baseMessage = 'Completed the requested task.';
+            break;
+        case SubagentTerminateMode.TIMEOUT:
+            baseMessage = 'Stopped because the time limit was reached.';
+            break;
+        case SubagentTerminateMode.MAX_TURNS:
+            baseMessage = 'Stopped because the maximum number of turns was reached.';
+            break;
+        case SubagentTerminateMode.ERROR:
+        default:
+            baseMessage = 'Stopped due to an unrecoverable error.';
+            break;
+    }
+    const varsSuffix = emittedEntries.length > 0
+        ? ` Emitted variables: ${emittedEntries.join(', ')}.`
+        : '';
+    output.final_message = `${baseMessage}${varsSuffix}`.trim();
+}
+export function handleEmitValueCall(request, ctx) {
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Subagent tool-call runtime payloads.
+    const args = request.args ?? {};
+    const variableName = typeof args.emit_variable_name === 'string'
+        ? args.emit_variable_name
+        : // eslint-disable-next-line sonarjs/no-nested-conditional -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+            typeof args.emitVariableName === 'string'
+                ? args.emitVariableName
+                : '';
+    const variableValue = typeof args.emit_variable_value === 'string'
+        ? args.emit_variable_value
+        : // eslint-disable-next-line sonarjs/no-nested-conditional -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+            typeof args.emitVariableValue === 'string'
+                ? args.emitVariableValue
+                : '';
+    if (variableName && variableValue) {
+        ctx.output.emitted_vars[variableName] = variableValue;
+        const message = `Emitted variable ${variableName} successfully`;
+        if (ctx.onMessage) {
+            ctx.onMessage(`[${ctx.subagentId}] ${message}`);
+        }
+        return [
+            {
+                functionResponse: {
+                    id: request.callId,
+                    name: request.name,
+                    response: {
+                        emit_variable_name: variableName,
+                        emit_variable_value: variableValue,
+                        message,
+                    },
+                },
+            },
+        ];
+    }
+    const errorMessage = 'self_emitvalue requires emit_variable_name and emit_variable_value arguments.';
+    ctx.logger.warn(() => `Subagent ${ctx.subagentId} failed to emit value: ${errorMessage}`);
+    return [
+        {
+            functionResponse: {
+                id: request.callId,
+                name: request.name,
+                response: { error: errorMessage },
+            },
+        },
+    ];
+}
+export function buildPartsFromCompletedCalls(completedCalls, ctx) {
+    const aggregate = [];
+    for (const call of completedCalls) {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Subagent tool-call runtime payloads may be malformed at boundaries.
+        const responseParts = call.response?.responseParts;
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Subagent tool-call runtime payloads may omit response parts.
+        if (responseParts !== undefined && responseParts.length > 0) {
+            for (const part of responseParts) {
+                // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                if ('functionCall' in part) {
+                    continue;
+                }
+                aggregate.push(part);
+            }
+        }
+        else {
+            aggregate.push({
+                functionResponse: {
+                    id: call.request.callId,
+                    name: call.request.name,
+                    response: {
+                        output: `Tool ${call.request.name} completed without response.`,
+                    },
+                },
+            });
+        }
+        if (call.status === 'error') {
+            const errorMessage = 
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Subagent tool-call runtime payloads.
+            call.response?.error?.message ??
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Subagent tool-call runtime payloads.
+                call.response?.resultDisplay ??
+                'Tool execution failed.';
+            ctx.logger.warn(() => `Subagent ${ctx.subagentId} tool '${call.request.name}' failed: ${errorMessage}`);
+        }
+        else if (call.status === 'cancelled') {
+            ctx.logger.warn(() => `Subagent ${ctx.subagentId} tool '${call.request.name}' was cancelled.`);
+        }
+        const toolCanUpdateOutput = 
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Subagent tool-call runtime payloads.
+        call.status === 'success' && call.tool?.canUpdateOutput === true;
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Subagent tool-call runtime payloads.
+        const display = call.response?.resultDisplay;
+        if (typeof display === 'string' &&
+            ctx.onMessage &&
+            display.trim() &&
+            !toolCanUpdateOutput) {
+            ctx.onMessage(display);
+        }
+    }
+    return aggregate;
+}
+export async function processFunctionCalls(functionCalls, abortController, promptId, ctx) {
+    const toolResponseParts = [];
+    let executedFunctionCallCount = 0;
+    for (const functionCall of functionCalls) {
+        const allowedTools = getHookRestrictedAllowedToolsForFunctionCall(functionCall);
+        if (isHookRestrictedToolCall(functionCall, allowedTools)) {
+            ctx.logger.debug(() => `Subagent ${ctx.subagentId} skipped hook-restricted tool '${functionCall.name}'`);
+        }
+        else {
+            executedFunctionCallCount += 1;
+            const callId = functionCall.id ?? `${functionCall.name}-${Date.now()}`;
+            const requestInfo = {
+                callId,
+                name: functionCall.name,
+                args: functionCall.args ?? {},
+                isClientInitiated: true,
+                prompt_id: promptId,
+                agentId: ctx.subagentId,
+                ...(allowedTools !== undefined
+                    ? { hookRestrictedAllowedTools: allowedTools }
+                    : {}),
+            };
+            ctx.logger.debug(() => `Subagent ${ctx.subagentId} executing tool '${requestInfo.name}' with args=${JSON.stringify(requestInfo.args)}`);
+            const toolResponse = await executeNonInteractiveTool(functionCall, requestInfo, callId, abortController, ctx);
+            logToolResult(functionCall, toolResponse, ctx);
+            if (isFatalToolError(toolResponse.errorType)) {
+                const fatalMessage = buildToolUnavailableMessage(functionCall.name, toolResponse.resultDisplay, toolResponse.error);
+                ctx.logger.warn(() => `Subagent ${ctx.subagentId} cannot use tool '${functionCall.name}': ${fatalMessage}`);
+                toolResponseParts.push({ text: fatalMessage });
+                ctx.output.final_message = fatalMessage;
+            }
+            else {
+                pushNonFunctionCallResponseParts(toolResponse.responseParts, toolResponseParts);
+            }
+        }
+    }
+    if (executedFunctionCallCount === 0) {
+        return [];
+    }
+    if (toolResponseParts.length === 0) {
+        toolResponseParts.push({
+            text: 'All tool calls failed. Please analyze the errors and try an alternative approach.',
+        });
+    }
+    return [{ role: 'user', parts: toolResponseParts }];
+}
+function pushNonFunctionCallResponseParts(responseParts, toolResponseParts) {
+    for (const part of responseParts) {
+        if (!('functionCall' in part)) {
+            toolResponseParts.push(part);
+        }
+    }
+}
+async function executeNonInteractiveTool(functionCall, requestInfo, callId, abortController, ctx) {
+    if (functionCall.name === 'self_emitvalue') {
+        const valName = String(requestInfo.args['emit_variable_name']);
+        const valVal = String(requestInfo.args['emit_variable_value']);
+        ctx.output.emitted_vars[valName] = valVal;
+        const successMessage = `Emitted variable ${valName} successfully`;
+        return {
+            callId,
+            responseParts: [
+                {
+                    functionResponse: {
+                        id: callId,
+                        name: requestInfo.name,
+                        response: {
+                            emit_variable_name: valName,
+                            emit_variable_value: valVal,
+                            message: successMessage,
+                        },
+                    },
+                },
+            ],
+            resultDisplay: successMessage,
+            error: undefined,
+            errorType: undefined,
+            agentId: requestInfo.agentId,
+        };
+    }
+    const schedulerConfig = createSchedulerConfig(ctx.toolExecutorContext, ctx.config, { interactive: false });
+    const completed = await executeToolCall(schedulerConfig, requestInfo, abortController.signal, { messageBus: ctx.messageBus });
+    return completed.response;
+}
+function logToolResult(functionCall, toolResponse, ctx) {
+    if (toolResponse.error) {
+        debugLogger.error(`Error executing tool ${functionCall.name}: ${toolResponse.resultDisplay ?? toolResponse.error.message}`);
+        ctx.logger.warn(() => `Subagent ${ctx.subagentId} tool '${functionCall.name}' failed: ${toolResponse.error?.message}`);
+    }
+    else {
+        ctx.logger.debug(() => `Subagent ${ctx.subagentId} tool '${functionCall.name}' completed successfully`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Task-list completion prompt
+// ---------------------------------------------------------------------------
+export async function buildTodoCompletionPrompt(runtimeContext, subagentId, logger) {
+    const sessionId = runtimeContext.state.sessionId;
+    if (!sessionId) {
+        const missingSessionPrompt = null;
+        return missingSessionPrompt;
+    }
+    try {
+        let todos = await new TodoStore(sessionId, subagentId).readTodos();
+        if (todos.length === 0) {
+            todos = await new TodoStore(sessionId).readTodos();
+        }
+        if (todos.length === 0) {
+            const noTodosPrompt = null;
+            return noTodosPrompt;
+        }
+        const outstanding = todos.filter((todo) => todo.status !== 'completed');
+        if (outstanding.length === 0) {
+            const noOutstandingPrompt = null;
+            return noOutstandingPrompt;
+        }
+        const previewCount = Math.min(3, outstanding.length);
+        const previewLines = outstanding
+            .slice(0, previewCount)
+            .map((todo) => `- ${todo.content}`);
+        if (outstanding.length > previewCount) {
+            previewLines.push(`- ... and ${outstanding.length - previewCount} more`);
+        }
+        return [
+            'You still have todos in your todo list. Complete them before finishing.',
+            previewLines.length > 0
+                ? `Outstanding items:\n${previewLines.join('\n')}`
+                : undefined,
+        ]
+            .filter(Boolean)
+            .join('\n\n');
+    }
+    catch (error) {
+        logger.warn(() => `Subagent ${subagentId} could not inspect todos: ${error instanceof Error ? error.message : String(error)}`);
+        const todoInspectionUnavailable = null;
+        return todoInspectionUnavailable;
+    }
+}
+//# sourceMappingURL=subagentToolProcessing.js.map

package/dist/src/core/subagentToolProcessing.js.map

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

package/dist/src/core/toolGovernance.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { canonicalizeToolName } from '@vybestack/llxprt-code-tools';
+export { canonicalizeToolName };
+export interface ToolGovernanceConfig {
+    getEphemeralSettings?: () => Record<string, unknown> | undefined;
+    getExcludeTools?: () => string[] | undefined;
+}
+export interface ToolGovernance {
+    allowed: Set<string>;
+    disabled: Set<string>;
+    excluded: Set<string>;
+}
+export declare function buildToolGovernance(config: ToolGovernanceConfig): ToolGovernance;
+export declare function isToolBlocked(toolName: string, governance: ToolGovernance): boolean;

package/dist/src/core/toolGovernance.js

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { canonicalizeToolName } from '@vybestack/llxprt-code-tools';
+export { canonicalizeToolName };
+function isStringArray(value) {
+    return (Array.isArray(value) && value.every((item) => typeof item === 'string'));
+}
+export function buildToolGovernance(config) {
+    const ephemerals = typeof config.getEphemeralSettings === 'function'
+        ? (config.getEphemeralSettings() ?? {})
+        : {};
+    const allowedRaw = isStringArray(ephemerals['tools.allowed'])
+        ? ephemerals['tools.allowed']
+        : [];
+    let disabledRaw;
+    if (isStringArray(ephemerals['tools.disabled'])) {
+        disabledRaw = ephemerals['tools.disabled'];
+    }
+    else if (isStringArray(ephemerals['disabled-tools'])) {
+        disabledRaw = ephemerals['disabled-tools'];
+    }
+    else {
+        disabledRaw = [];
+    }
+    const excludedRaw = typeof config.getExcludeTools === 'function'
+        ? (config.getExcludeTools() ?? [])
+        : [];
+    return {
+        allowed: new Set(allowedRaw.map(canonicalizeToolName)),
+        disabled: new Set(disabledRaw.map(canonicalizeToolName)),
+        excluded: new Set(excludedRaw.map(canonicalizeToolName)),
+    };
+}
+export function isToolBlocked(toolName, governance) {
+    const canonical = canonicalizeToolName(toolName);
+    if (governance.excluded.has(canonical)) {
+        return true;
+    }
+    if (governance.disabled.has(canonical)) {
+        return true;
+    }
+    if (governance.allowed.size > 0 && !governance.allowed.has(canonical)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=toolGovernance.js.map

package/dist/src/core/toolGovernance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolGovernance.js","sourceRoot":"","sources":["../../../src/core/toolGovernance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CACxE,CAAC;AACJ,CAAC;AAaD,MAAM,UAAU,mBAAmB,CACjC,MAA4B;IAE5B,MAAM,UAAU,GACd,OAAO,MAAM,CAAC,oBAAoB,KAAK,UAAU;QAC/C,CAAC,CAAC,CAAC,MAAM,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC;QACvC,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;QAC3D,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC;QAC7B,CAAC,CAAC,EAAE,CAAC;IAEP,IAAI,WAAqB,CAAC;IAC1B,IAAI,aAAa,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC;QAChD,WAAW,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;SAAM,IAAI,aAAa,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC;QACvD,WAAW,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GACf,OAAO,MAAM,CAAC,eAAe,KAAK,UAAU;QAC1C,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;QAClC,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACL,OAAO,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QACtD,QAAQ,EAAE,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QACxD,QAAQ,EAAE,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,UAA0B;IAE1B,MAAM,SAAS,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAEjD,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/core/turn.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GenerateContentResponse, FinishReason } from '@google/genai';
+import { type PartListUnion } from '@google/genai';
+import type { ChatSession } from './chatSession.js';
+import { type ToolCallRequestInfo, type ServerGeminiStreamEvent } from '@vybestack/llxprt-code-core/core/turn.js';
+/** @deprecated Use DEFAULT_STREAM_IDLE_TIMEOUT_MS from streamIdleTimeout.js instead */
+export declare const TURN_STREAM_IDLE_TIMEOUT_MS = 0;
+export { DEFAULT_AGENT_ID, GeminiEventType, CompressionStatus, PerformCompressionResult, } from '@vybestack/llxprt-code-core/core/turn.js';
+export type { ToolCallRequestInfo, ToolCallResponseInfo, ServerGeminiStreamEvent, ServerGeminiContentEvent, ServerGeminiThoughtEvent, ServerGeminiToolCallRequestEvent, ServerGeminiToolCallResponseEvent, ServerGeminiToolCallConfirmationEvent, ServerGeminiUserCancelledEvent, ServerGeminiStreamIdleTimeoutEvent, ServerGeminiErrorEvent, ServerGeminiChatCompressedEvent, ServerGeminiUsageMetadataEvent, ServerGeminiMaxSessionTurnsEvent, ServerGeminiFinishedEvent, ServerGeminiLoopDetectedEvent, ServerGeminiCitationEvent, ServerGeminiRetryEvent, ServerGeminiInvalidStreamEvent, ServerGeminiAgentExecutionStoppedEvent, ServerGeminiAgentExecutionBlockedEvent, ServerGeminiContextWindowWillOverflowEvent, ServerGeminiModelInfoEvent, ServerToolCallConfirmationDetails, ChatCompressionInfo, ModelInfo, ServerGeminiFinishedOutcome, StructuredError, ServerTool, } from '@vybestack/llxprt-code-core/core/turn.js';
+export declare class Turn {
+    private readonly chat;
+    private readonly prompt_id;
+    private readonly agentId;
+    private readonly providerName;
+    readonly pendingToolCalls: ToolCallRequestInfo[];
+    private debugResponses;
+    finishReason: FinishReason | undefined;
+    private logger;
+    constructor(chat: ChatSession, prompt_id: string, agentId?: string, providerName?: string);
+    /**
+     * Check if citations should be shown for the current user/settings.
+     * Based on the upstream implementation from commit 997136ae.
+     */
+    private shouldShowCitations;
+    /**
+     * Emits a citation event with the given text.
+     * This integrates with llxprt's provider abstraction to work across all providers.
+     */
+    private emitCitation;
+    private emitFinishReason;
+    private logNoFinishReason;
+    private pushFilteredDebugResponse;
+    private processStreamChunk;
+    private createEmptyResponseOutcome;
+    private consumeStreamEvents;
+    private mergeResponseOutcome;
+    private extractErrorStatus;
+    private handleRunError;
+    run(req: PartListUnion, signal: AbortSignal): AsyncGenerator<ServerGeminiStreamEvent>;
+    private handlePendingFunctionCall;
+    private createSyntheticFunctionCallId;
+    getDebugResponses(): GenerateContentResponse[];
+}