@machina.ai/cell-cli-core 1.10.0-rc1 → 1.13.0-rc1

package/dist/src/telemetry/types.d.ts

@@ -3,13 +3,13 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { GenerateContentResponseUsageMetadata } from '@google/genai';
+import type { Candidate, Content, GenerateContentConfig, GenerateContentResponseUsageMetadata } from '@google/genai';
 import type { Config } from '../config/config.js';
-import type { ApprovalMode } from '../config/config.js';
+import type { ApprovalMode } from '../policy/types.js';
 import type { CompletedToolCall } from '../core/coreToolScheduler.js';
-import type { LogAttributes } from '@opentelemetry/api-logs';
+import type { LogAttributes, LogRecord } from '@opentelemetry/api-logs';
 import { ToolCallDecision } from './tool-call-decision.js';
-import type { FileOperation } from './metrics.js';
+import { type FileOperation } from './metrics.js';
 export { ToolCallDecision };
 import type { ToolRegistry } from '../tools/tool-registry.js';
 import type { OutputFormat } from '../output/types.js';
@@ -40,6 +40,10 @@ export declare class StartSessionEvent implements BaseTelemetryEvent {
     mcp_tools_count?: number;
     mcp_tools?: string;
     output_format: OutputFormat;
+    extensions_count: number;
+    extensions: string;
+    extension_ids: string;
+    auth_type?: string;
     constructor(config: Config, toolRegistry?: ToolRegistry);
     toOpenTelemetryAttributes(config: Config): LogAttributes;
     toLogBody(): string;
@@ -77,6 +81,8 @@ export declare class ToolCallEvent implements BaseTelemetryEvent {
     tool_type: 'native' | 'mcp';
     content_length?: number;
     mcp_server_name?: string;
+    extension_name?: string;
+    extension_id?: string;
     metadata?: {
         [key: string]: any;
     };
@@ -101,35 +107,54 @@ export declare class ApiErrorEvent implements BaseTelemetryEvent {
     'event.name': 'api_error';
     'event.timestamp': string;
     model: string;
+    prompt: GenAIPromptDetails;
     error: string;
     error_type?: string;
     status_code?: number | string;
     duration_ms: number;
-    prompt_id: string;
     auth_type?: string;
-    constructor(model: string, error: string, duration_ms: number, prompt_id: string, auth_type?: string, error_type?: string, status_code?: number | string);
-    toOpenTelemetryAttributes(config: Config): LogAttributes;
-    toLogBody(): string;
+    constructor(model: string, error: string, duration_ms: number, prompt_details: GenAIPromptDetails, auth_type?: string, error_type?: string, status_code?: number | string);
+    toLogRecord(config: Config): LogRecord;
+    toSemanticLogRecord(config: Config): LogRecord;
 }
-export declare const EVENT_API_RESPONSE = "gemini_cli.api_response";
-export declare class ApiResponseEvent implements BaseTelemetryEvent {
-    'event.name': 'api_response';
-    'event.timestamp': string;
-    model: string;
-    status_code?: number | string;
-    duration_ms: number;
+export interface ServerDetails {
+    address: string;
+    port: number;
+}
+export interface GenAIPromptDetails {
+    prompt_id: string;
+    contents: Content[];
+    generate_content_config?: GenerateContentConfig;
+    server?: ServerDetails;
+}
+export interface GenAIResponseDetails {
+    response_id?: string;
+    candidates?: Candidate[];
+}
+export interface GenAIUsageDetails {
     input_token_count: number;
     output_token_count: number;
     cached_content_token_count: number;
     thoughts_token_count: number;
     tool_token_count: number;
     total_token_count: number;
+}
+export declare const EVENT_API_RESPONSE = "gemini_cli.api_response";
+export declare const EVENT_GEN_AI_OPERATION_DETAILS = "gen_ai.client.inference.operation.details";
+export declare class ApiResponseEvent implements BaseTelemetryEvent {
+    'event.name': 'api_response';
+    'event.timestamp': string;
+    status_code?: number | string;
+    duration_ms: number;
     response_text?: string;
-    prompt_id: string;
     auth_type?: string;
-    constructor(model: string, duration_ms: number, prompt_id: string, auth_type?: string, usage_data?: GenerateContentResponseUsageMetadata, response_text?: string);
-    toOpenTelemetryAttributes(config: Config): LogAttributes;
-    toLogBody(): string;
+    model: string;
+    prompt: GenAIPromptDetails;
+    response: GenAIResponseDetails;
+    usage: GenAIUsageDetails;
+    constructor(model: string, duration_ms: number, prompt_details: GenAIPromptDetails, response_details: GenAIResponseDetails, auth_type?: string, usage_data?: GenerateContentResponseUsageMetadata, response_text?: string);
+    toLogRecord(config: Config): LogRecord;
+    toSemanticLogRecord(config: Config): LogRecord;
 }
 export declare const EVENT_FLASH_FALLBACK = "gemini_cli.flash_fallback";
 export declare class FlashFallbackEvent implements BaseTelemetryEvent {
@@ -189,10 +214,11 @@ export interface SlashCommandEvent extends BaseTelemetryEvent {
     command: string;
     subcommand?: string;
     status?: SlashCommandStatus;
+    extension_id?: string;
     toOpenTelemetryAttributes(config: Config): LogAttributes;
     toLogBody(): string;
 }
-export declare function makeSlashCommandEvent({ command, subcommand, status, }: Omit<SlashCommandEvent, CommonFields | 'toOpenTelemetryAttributes' | 'toLogBody'>): SlashCommandEvent;
+export declare function makeSlashCommandEvent({ command, subcommand, status, extension_id, }: Omit<SlashCommandEvent, CommonFields | 'toOpenTelemetryAttributes' | 'toLogBody'>): SlashCommandEvent;
 export declare enum SlashCommandStatus {
     SUCCESS = "success",
     ERROR = "error"
@@ -314,10 +340,11 @@ export declare class ExtensionInstallEvent implements BaseTelemetryEvent {
     'event.name': 'extension_install';
     'event.timestamp': string;
     extension_name: string;
+    extension_id: string;
     extension_version: string;
     extension_source: string;
     status: 'success' | 'error';
-    constructor(extension_name: string, extension_version: string, extension_source: string, status: 'success' | 'error');
+    constructor(extension_name: string, extension_id: string, extension_version: string, extension_source: string, status: 'success' | 'error');
     toOpenTelemetryAttributes(config: Config): LogAttributes;
     toLogBody(): string;
 }
@@ -347,8 +374,9 @@ export declare class ExtensionUninstallEvent implements BaseTelemetryEvent {
     'event.name': 'extension_uninstall';
     'event.timestamp': string;
     extension_name: string;
+    extension_id: string;
     status: 'success' | 'error';
-    constructor(extension_name: string, status: 'success' | 'error');
+    constructor(extension_name: string, extension_id: string, status: 'success' | 'error');
     toOpenTelemetryAttributes(config: Config): LogAttributes;
     toLogBody(): string;
 }
@@ -357,11 +385,12 @@ export declare class ExtensionUpdateEvent implements BaseTelemetryEvent {
     'event.name': 'extension_update';
     'event.timestamp': string;
     extension_name: string;
+    extension_id: string;
     extension_previous_version: string;
     extension_version: string;
     extension_source: string;
     status: 'success' | 'error';
-    constructor(extension_name: string, extension_version: string, extension_previous_version: string, extension_source: string, status: 'success' | 'error');
+    constructor(extension_name: string, extension_id: string, extension_version: string, extension_previous_version: string, extension_source: string, status: 'success' | 'error');
     toOpenTelemetryAttributes(config: Config): LogAttributes;
     toLogBody(): string;
 }
@@ -370,8 +399,9 @@ export declare class ExtensionEnableEvent implements BaseTelemetryEvent {
     'event.name': 'extension_enable';
     'event.timestamp': string;
     extension_name: string;
+    extension_id: string;
     setting_scope: string;
-    constructor(extension_name: string, settingScope: string);
+    constructor(extension_name: string, extension_id: string, settingScope: string);
     toOpenTelemetryAttributes(config: Config): LogAttributes;
     toLogBody(): string;
 }
@@ -384,14 +414,15 @@ export declare class ModelSlashCommandEvent implements BaseTelemetryEvent {
     toOpenTelemetryAttributes(config: Config): LogAttributes;
     toLogBody(): string;
 }
-export type TelemetryEvent = StartSessionEvent | EndSessionEvent | UserPromptEvent | ToolCallEvent | ApiRequestEvent | ApiErrorEvent | ApiResponseEvent | FlashFallbackEvent | LoopDetectedEvent | LoopDetectionDisabledEvent | NextSpeakerCheckEvent | KittySequenceOverflowEvent | MalformedJsonResponseEvent | IdeConnectionEvent | ConversationFinishedEvent | SlashCommandEvent | FileOperationEvent | InvalidChunkEvent | ContentRetryEvent | ContentRetryFailureEvent | ExtensionEnableEvent | ExtensionInstallEvent | ExtensionUninstallEvent | ModelRoutingEvent | ToolOutputTruncatedEvent | ModelSlashCommandEvent | AgentStartEvent | AgentFinishEvent | WebFetchFallbackAttemptEvent;
+export type TelemetryEvent = StartSessionEvent | EndSessionEvent | UserPromptEvent | ToolCallEvent | ApiRequestEvent | ApiErrorEvent | ApiResponseEvent | FlashFallbackEvent | LoopDetectedEvent | LoopDetectionDisabledEvent | NextSpeakerCheckEvent | KittySequenceOverflowEvent | MalformedJsonResponseEvent | IdeConnectionEvent | ConversationFinishedEvent | SlashCommandEvent | FileOperationEvent | InvalidChunkEvent | ContentRetryEvent | ContentRetryFailureEvent | ExtensionEnableEvent | ExtensionInstallEvent | ExtensionUninstallEvent | ModelRoutingEvent | ToolOutputTruncatedEvent | ModelSlashCommandEvent | AgentStartEvent | AgentFinishEvent | RecoveryAttemptEvent | WebFetchFallbackAttemptEvent;
 export declare const EVENT_EXTENSION_DISABLE = "gemini_cli.extension_disable";
 export declare class ExtensionDisableEvent implements BaseTelemetryEvent {
     'event.name': 'extension_disable';
     'event.timestamp': string;
     extension_name: string;
+    extension_id: string;
     setting_scope: string;
-    constructor(extension_name: string, settingScope: string);
+    constructor(extension_name: string, extension_id: string, settingScope: string);
     toOpenTelemetryAttributes(config: Config): LogAttributes;
     toLogBody(): string;
 }
@@ -413,22 +444,25 @@ export declare class SmartEditCorrectionEvent implements BaseTelemetryEvent {
     toOpenTelemetryAttributes(config: Config): LogAttributes;
     toLogBody(): string;
 }
-export declare const EVENT_AGENT_START = "gemini_cli.agent.start";
-export declare class AgentStartEvent implements BaseTelemetryEvent {
-    'event.name': 'agent_start';
+declare abstract class BaseAgentEvent implements BaseTelemetryEvent {
+    abstract 'event.name': 'agent_start' | 'agent_finish' | 'agent_recovery_attempt';
     'event.timestamp': string;
     agent_id: string;
     agent_name: string;
     constructor(agent_id: string, agent_name: string);
     toOpenTelemetryAttributes(config: Config): LogAttributes;
+    abstract toLogBody(): string;
+}
+export declare const EVENT_AGENT_START = "gemini_cli.agent.start";
+export declare class AgentStartEvent extends BaseAgentEvent {
+    'event.name': "agent_start";
+    constructor(agent_id: string, agent_name: string);
+    toOpenTelemetryAttributes(config: Config): LogAttributes;
     toLogBody(): string;
 }
 export declare const EVENT_AGENT_FINISH = "gemini_cli.agent.finish";
-export declare class AgentFinishEvent implements BaseTelemetryEvent {
-    'event.name': 'agent_finish';
-    'event.timestamp': string;
-    agent_id: string;
-    agent_name: string;
+export declare class AgentFinishEvent extends BaseAgentEvent {
+    'event.name': "agent_finish";
     duration_ms: number;
     turn_count: number;
     terminate_reason: AgentTerminateMode;
@@ -436,6 +470,17 @@ export declare class AgentFinishEvent implements BaseTelemetryEvent {
     toOpenTelemetryAttributes(config: Config): LogAttributes;
     toLogBody(): string;
 }
+export declare const EVENT_AGENT_RECOVERY_ATTEMPT = "gemini_cli.agent.recovery_attempt";
+export declare class RecoveryAttemptEvent extends BaseAgentEvent {
+    'event.name': "agent_recovery_attempt";
+    reason: AgentTerminateMode;
+    duration_ms: number;
+    success: boolean;
+    turn_count: number;
+    constructor(agent_id: string, agent_name: string, reason: AgentTerminateMode, duration_ms: number, success: boolean, turn_count: number);
+    toOpenTelemetryAttributes(config: Config): LogAttributes;
+    toLogBody(): string;
+}
 export declare const EVENT_WEB_FETCH_FALLBACK_ATTEMPT = "gemini_cli.web_fetch_fallback_attempt";
 export declare class WebFetchFallbackAttemptEvent implements BaseTelemetryEvent {
     'event.name': 'web_fetch_fallback_attempt';