@terminai/core 0.21.0

package/dist/src/telemetry/semantic.js.map

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

package/dist/src/telemetry/semantic.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/telemetry/semantic.test.js

@@ -0,0 +1,388 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { toChatMessage, toInputMessages, toSystemInstruction, toOutputMessages, toFinishReasons, OTelFinishReason, toOutputType, OTelOutputType, } from './semantic.js';
+import { Language, Outcome, FinishReason, } from '@google/genai';
+describe('toChatMessage', () => {
+    it('should correctly handle text parts', () => {
+        const content = {
+            role: 'user',
+            parts: [{ text: 'Hello' }],
+        };
+        expect(toChatMessage(content)).toEqual({
+            role: 'user',
+            parts: [
+                {
+                    type: 'text',
+                    content: 'Hello',
+                },
+            ],
+        });
+    });
+    it('should correctly handle function call parts', () => {
+        const content = {
+            role: 'model',
+            parts: [
+                {
+                    functionCall: {
+                        name: 'test-function',
+                        args: {
+                            arg1: 'test-value',
+                        },
+                        id: '12345',
+                    },
+                    // include field not specified in semantic specification that could be present
+                    thoughtSignature: '1234',
+                },
+            ],
+        };
+        expect(toChatMessage(content)).toEqual({
+            role: 'system',
+            parts: [
+                {
+                    type: 'tool_call',
+                    name: 'test-function',
+                    arguments: '{"arg1":"test-value"}',
+                    id: '12345',
+                },
+            ],
+        });
+    });
+    it('should correctly handle function response parts', () => {
+        const content = {
+            role: 'user',
+            parts: [
+                {
+                    functionResponse: {
+                        name: 'test-function',
+                        response: {
+                            result: 'success',
+                        },
+                        id: '12345',
+                    },
+                    // include field not specified in semantic specification that could be present
+                    fileData: {
+                        displayName: 'greatfile',
+                    },
+                },
+            ],
+        };
+        expect(toChatMessage(content)).toEqual({
+            role: 'user',
+            parts: [
+                {
+                    type: 'tool_call_response',
+                    response: '{"result":"success"}',
+                    id: '12345',
+                },
+            ],
+        });
+    });
+    it('should correctly handle reasoning parts with text', () => {
+        const content = {
+            role: 'system',
+            parts: [{ text: 'Hmm', thought: true }],
+        };
+        expect(toChatMessage(content)).toEqual({
+            role: 'system',
+            parts: [
+                {
+                    type: 'reasoning',
+                    content: 'Hmm',
+                },
+            ],
+        });
+    });
+    it('should correctly handle reasoning parts without text', () => {
+        const content = {
+            role: 'system',
+            parts: [
+                {
+                    thought: true,
+                    // include field not specified in semantic specification that could be present
+                    inlineData: {
+                        displayName: 'wowdata',
+                    },
+                },
+            ],
+        };
+        expect(toChatMessage(content)).toEqual({
+            role: 'system',
+            parts: [
+                {
+                    type: 'reasoning',
+                    content: '',
+                },
+            ],
+        });
+    });
+    it('should correctly handle text parts that are not reasoning parts', () => {
+        const content = {
+            role: 'user',
+            parts: [{ text: 'what a nice day', thought: false }],
+        };
+        expect(toChatMessage(content)).toEqual({
+            role: 'user',
+            parts: [
+                {
+                    type: 'text',
+                    content: 'what a nice day',
+                },
+            ],
+        });
+    });
+    it('should correctly handle "generic" parts', () => {
+        const content = {
+            role: 'model',
+            parts: [
+                {
+                    executableCode: {
+                        code: 'print("foo")',
+                        language: Language.PYTHON,
+                    },
+                },
+                {
+                    codeExecutionResult: {
+                        outcome: Outcome.OUTCOME_OK,
+                        output: 'foo',
+                    },
+                    // include field not specified in semantic specification that could be present
+                    videoMetadata: {
+                        fps: 5,
+                    },
+                },
+            ],
+        };
+        expect(toChatMessage(content)).toEqual({
+            role: 'system',
+            parts: [
+                {
+                    type: 'executableCode',
+                    code: 'print("foo")',
+                    language: 'PYTHON',
+                },
+                {
+                    type: 'codeExecutionResult',
+                    outcome: 'OUTCOME_OK',
+                    output: 'foo',
+                    videoMetadata: {
+                        fps: 5,
+                    },
+                },
+            ],
+        });
+    });
+    it('should correctly handle unknown parts', () => {
+        const content = {
+            role: 'model',
+            parts: [
+                {
+                    fileData: {
+                        displayName: 'superfile',
+                    },
+                },
+            ],
+        };
+        expect(toChatMessage(content)).toEqual({
+            role: 'system',
+            parts: [
+                {
+                    type: 'unknown',
+                    fileData: {
+                        displayName: 'superfile',
+                    },
+                },
+            ],
+        });
+    });
+});
+describe('toSystemInstruction', () => {
+    it('should correctly handle a string', () => {
+        const content = 'Hello';
+        expect(toSystemInstruction(content)).toEqual([
+            {
+                type: 'text',
+                content: 'Hello',
+            },
+        ]);
+    });
+    it('should correctly handle a Content object with a text part', () => {
+        const content = {
+            role: 'user',
+            parts: [{ text: 'Hello' }],
+        };
+        expect(toSystemInstruction(content)).toEqual([
+            {
+                type: 'text',
+                content: 'Hello',
+            },
+        ]);
+    });
+    it('should correctly handle a Content object with multiple parts', () => {
+        const content = {
+            role: 'user',
+            parts: [{ text: 'Hello' }, { text: 'Hmm', thought: true }],
+        };
+        expect(toSystemInstruction(content)).toEqual([
+            {
+                type: 'text',
+                content: 'Hello',
+            },
+            {
+                type: 'reasoning',
+                content: 'Hmm',
+            },
+        ]);
+    });
+});
+describe('toInputMessages', () => {
+    it('should correctly convert an array of Content objects', () => {
+        const contents = [
+            {
+                role: 'user',
+                parts: [{ text: 'Hello' }],
+            },
+            {
+                role: 'model',
+                parts: [{ text: 'Hi there!' }],
+            },
+        ];
+        expect(toInputMessages(contents)).toEqual([
+            {
+                role: 'user',
+                parts: [
+                    {
+                        type: 'text',
+                        content: 'Hello',
+                    },
+                ],
+            },
+            {
+                role: 'system',
+                parts: [
+                    {
+                        type: 'text',
+                        content: 'Hi there!',
+                    },
+                ],
+            },
+        ]);
+    });
+});
+describe('toOutputMessages', () => {
+    it('should correctly convert an array of Candidate objects', () => {
+        const candidates = [
+            {
+                index: 0,
+                finishReason: FinishReason.STOP,
+                content: {
+                    role: 'model',
+                    parts: [{ text: 'This is the first candidate.' }],
+                },
+            },
+            {
+                index: 1,
+                finishReason: FinishReason.MAX_TOKENS,
+                content: {
+                    role: 'model',
+                    parts: [{ text: 'This is the second candidate.' }],
+                },
+            },
+        ];
+        expect(toOutputMessages(candidates)).toEqual([
+            {
+                role: 'system',
+                finish_reason: 'stop',
+                parts: [
+                    {
+                        type: 'text',
+                        content: 'This is the first candidate.',
+                    },
+                ],
+            },
+            {
+                role: 'system',
+                finish_reason: 'length',
+                parts: [
+                    {
+                        type: 'text',
+                        content: 'This is the second candidate.',
+                    },
+                ],
+            },
+        ]);
+    });
+});
+describe('toFinishReasons', () => {
+    it('should return an empty array if candidates is undefined', () => {
+        expect(toFinishReasons(undefined)).toEqual([]);
+    });
+    it('should return an empty array if candidates is an empty array', () => {
+        expect(toFinishReasons([])).toEqual([]);
+    });
+    it('should correctly convert a single candidate', () => {
+        const candidates = [
+            {
+                index: 0,
+                finishReason: FinishReason.STOP,
+                content: {
+                    role: 'model',
+                    parts: [{ text: 'This is the first candidate.' }],
+                },
+            },
+        ];
+        expect(toFinishReasons(candidates)).toEqual([OTelFinishReason.STOP]);
+    });
+    it('should correctly convert multiple candidates', () => {
+        const candidates = [
+            {
+                index: 0,
+                finishReason: FinishReason.STOP,
+                content: {
+                    role: 'model',
+                    parts: [{ text: 'This is the first candidate.' }],
+                },
+            },
+            {
+                index: 1,
+                finishReason: FinishReason.MAX_TOKENS,
+                content: {
+                    role: 'model',
+                    parts: [{ text: 'This is the second candidate.' }],
+                },
+            },
+            {
+                index: 2,
+                finishReason: FinishReason.SAFETY,
+                content: {
+                    role: 'model',
+                    parts: [{ text: 'This is the third candidate.' }],
+                },
+            },
+        ];
+        expect(toFinishReasons(candidates)).toEqual([
+            OTelFinishReason.STOP,
+            OTelFinishReason.LENGTH,
+            OTelFinishReason.CONTENT_FILTER,
+        ]);
+    });
+});
+describe('toOutputType', () => {
+    it('should return TEXT for text/plain', () => {
+        expect(toOutputType('text/plain')).toBe(OTelOutputType.TEXT);
+    });
+    it('should return JSON for application/json', () => {
+        expect(toOutputType('application/json')).toBe(OTelOutputType.JSON);
+    });
+    it('should return the custom mime type for other strings', () => {
+        expect(toOutputType('application/vnd.custom-type')).toBe('application/vnd.custom-type');
+    });
+    it('should return undefined for undefined input', () => {
+        expect(toOutputType(undefined)).toBeUndefined();
+    });
+});
+//# sourceMappingURL=semantic.test.js.map

package/dist/src/telemetry/semantic.test.js.map

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

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

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+/**
+ * Handle returned by start() that allows ending the phase without repeating the phase name.
+ */
+export interface StartupPhaseHandle {
+    end(details?: Record<string, string | number | boolean>): void;
+}
+/**
+ * Buffers startup performance metrics until the telemetry system is fully initialized.
+ */
+export declare class StartupProfiler {
+    private phases;
+    private static instance;
+    private constructor();
+    static getInstance(): StartupProfiler;
+    /**
+     * Returns the mark name for the start of a phase.
+     */
+    private getStartMarkName;
+    /**
+     * Returns the mark name for the end of a phase.
+     */
+    private getEndMarkName;
+    /**
+     * Marks the start of a phase and returns a handle to end it.
+     *
+     * If a phase with the same name is already active (started but not ended),
+     * this method will log a warning and return `undefined`. This allows for
+     * idempotent calls in environments where initialization might happen multiple
+     * times.
+     *
+     * Callers should handle the potential `undefined` return value, typically
+     * by using optional chaining: `handle?.end()`.
+     */
+    start(phaseName: string, details?: Record<string, string | number | boolean>): StartupPhaseHandle | undefined;
+    /**
+     * Marks the end of a phase and calculates duration.
+     * This is now a private method; callers should use the handle returned by start().
+     */
+    private _end;
+    /**
+     * Flushes buffered metrics to the telemetry system.
+     */
+    flush(config: Config): void;
+}
+export declare const startupProfiler: StartupProfiler;

package/dist/src/telemetry/startupProfiler.js

@@ -0,0 +1,171 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { performance } from 'node:perf_hooks';
+import * as os from 'node:os';
+import * as fs from 'node:fs';
+import { recordStartupPerformance } from './metrics.js';
+import { debugLogger } from '../utils/debugLogger.js';
+import { StartupStatsEvent } from './types.js';
+import { logStartupStats } from './loggers.js';
+/**
+ * Buffers startup performance metrics until the telemetry system is fully initialized.
+ */
+export class StartupProfiler {
+    phases = new Map();
+    static instance;
+    constructor() { }
+    static getInstance() {
+        if (!StartupProfiler.instance) {
+            StartupProfiler.instance = new StartupProfiler();
+        }
+        return StartupProfiler.instance;
+    }
+    /**
+     * Returns the mark name for the start of a phase.
+     */
+    getStartMarkName(phaseName) {
+        return `startup:${phaseName}:start`;
+    }
+    /**
+     * Returns the mark name for the end of a phase.
+     */
+    getEndMarkName(phaseName) {
+        return `startup:${phaseName}:end`;
+    }
+    /**
+     * Marks the start of a phase and returns a handle to end it.
+     *
+     * If a phase with the same name is already active (started but not ended),
+     * this method will log a warning and return `undefined`. This allows for
+     * idempotent calls in environments where initialization might happen multiple
+     * times.
+     *
+     * Callers should handle the potential `undefined` return value, typically
+     * by using optional chaining: `handle?.end()`.
+     */
+    start(phaseName, details) {
+        const existingPhase = this.phases.get(phaseName);
+        // Error if starting a phase that's already active.
+        if (existingPhase && !existingPhase.ended) {
+            debugLogger.warn(`[STARTUP] Cannot start phase '${phaseName}': phase is already active. Call end() before starting again.`);
+            return undefined;
+        }
+        const startMarkName = this.getStartMarkName(phaseName);
+        performance.mark(startMarkName, { detail: details });
+        const phase = {
+            name: phaseName,
+            startCpuUsage: process.cpuUsage(),
+            details,
+            ended: false,
+        };
+        this.phases.set(phaseName, phase);
+        // Return a handle that allows ending the phase without repeating the name
+        return {
+            end: (endDetails) => {
+                this._end(phase, endDetails);
+            },
+        };
+    }
+    /**
+     * Marks the end of a phase and calculates duration.
+     * This is now a private method; callers should use the handle returned by start().
+     */
+    _end(phase, details) {
+        // Error if ending a phase that's already ended.
+        if (phase.ended) {
+            debugLogger.warn(`[STARTUP] Cannot end phase '${phase.name}': phase was already ended.`);
+            return;
+        }
+        const startMarkName = this.getStartMarkName(phase.name);
+        const endMarkName = this.getEndMarkName(phase.name);
+        // Check if start mark exists before measuring
+        if (performance.getEntriesByName(startMarkName).length === 0) {
+            debugLogger.warn(`[STARTUP] Cannot measure phase '${phase.name}': start mark '${startMarkName}' not found (likely cleared by reset).`);
+            phase.ended = true;
+            return;
+        }
+        performance.mark(endMarkName, { detail: details });
+        performance.measure(phase.name, startMarkName, endMarkName);
+        phase.cpuUsage = process.cpuUsage(phase.startCpuUsage);
+        phase.ended = true;
+        if (details) {
+            phase.details = { ...phase.details, ...details };
+        }
+    }
+    /**
+     * Flushes buffered metrics to the telemetry system.
+     */
+    flush(config) {
+        debugLogger.log('[STARTUP] StartupProfiler.flush() called with', this.phases.size, 'phases');
+        const commonDetails = {
+            os_platform: os.platform(),
+            os_arch: os.arch(),
+            os_release: os.release(),
+            is_docker: fs.existsSync('/.dockerenv'),
+        };
+        // Get all performance measures.
+        const measures = performance.getEntriesByType('measure');
+        for (const phase of this.phases.values()) {
+            // Warn about incomplete phases.
+            if (!phase.ended) {
+                debugLogger.warn(`[STARTUP] Phase '${phase.name}' was started but never ended. Skipping metrics.`);
+                continue;
+            }
+            // Find the corresponding measure.
+            const measure = measures.find((m) => m.name === phase.name);
+            if (measure && phase.cpuUsage) {
+                const details = {
+                    ...commonDetails,
+                    cpu_usage_user: phase.cpuUsage.user,
+                    cpu_usage_system: phase.cpuUsage.system,
+                    ...phase.details,
+                };
+                debugLogger.log('[STARTUP] Recording metric for phase:', phase.name, 'duration:', measure.duration);
+                recordStartupPerformance(config, measure.duration, {
+                    phase: phase.name,
+                    details,
+                });
+            }
+            else {
+                debugLogger.log('[STARTUP] Skipping phase without measure:', phase.name);
+            }
+        }
+        // Emit StartupStats event
+        const startupPhases = [];
+        for (const phase of this.phases.values()) {
+            if (!phase.ended)
+                continue;
+            const measure = measures.find((m) => m.name === phase.name);
+            if (measure && phase.cpuUsage) {
+                startupPhases.push({
+                    name: phase.name,
+                    duration_ms: measure.duration,
+                    cpu_usage_user_usec: phase.cpuUsage.user,
+                    cpu_usage_system_usec: phase.cpuUsage.system,
+                    start_time_usec: (performance.timeOrigin + measure.startTime) * 1000,
+                    end_time_usec: (performance.timeOrigin + measure.startTime + measure.duration) *
+                        1000,
+                });
+            }
+        }
+        if (startupPhases.length > 0) {
+            logStartupStats(config, new StartupStatsEvent(startupPhases, os.platform(), os.release(), fs.existsSync('/.dockerenv')));
+        }
+        // Clear performance marks and measures for all tracked phases.
+        for (const phaseName of this.phases.keys()) {
+            const startMarkName = this.getStartMarkName(phaseName);
+            const endMarkName = this.getEndMarkName(phaseName);
+            performance.clearMarks(startMarkName);
+            performance.clearMarks(endMarkName);
+            performance.clearMeasures(phaseName);
+        }
+        // Clear all phases.
+        this.phases.clear();
+    }
+}
+export const startupProfiler = StartupProfiler.getInstance();
+//# sourceMappingURL=startupProfiler.js.map

package/dist/src/telemetry/startupProfiler.js.map

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

package/dist/src/telemetry/startupProfiler.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};