@blackbox_ai/blackbox-cli-core 0.0.4

package/dist/src/subagents/validation.js.map

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

package/dist/src/subagents/validation.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Blackbox
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/subagents/validation.test.js

@@ -0,0 +1,330 @@
+/**
+ * @license
+ * Copyright 2025 Blackbox
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { SubagentValidator } from './validation.js';
+import { SubagentError } from './types.js';
+describe('SubagentValidator', () => {
+    let validator;
+    beforeEach(() => {
+        validator = new SubagentValidator();
+    });
+    describe('validateName', () => {
+        it('should accept valid names', () => {
+            const validNames = [
+                'test-agent',
+                'code_reviewer',
+                'agent123',
+                'my-helper',
+            ];
+            for (const name of validNames) {
+                const result = validator.validateName(name);
+                expect(result.isValid).toBe(true);
+                expect(result.errors).toHaveLength(0);
+            }
+        });
+        it('should reject empty or whitespace names', () => {
+            const invalidNames = ['', '   ', '\t', '\n'];
+            for (const name of invalidNames) {
+                const result = validator.validateName(name);
+                expect(result.isValid).toBe(false);
+                expect(result.errors).toContain('Name is required and cannot be empty');
+            }
+        });
+        it('should reject names that are too short', () => {
+            const result = validator.validateName('a');
+            expect(result.isValid).toBe(false);
+            expect(result.errors).toContain('Name must be at least 2 characters long');
+        });
+        it('should reject names that are too long', () => {
+            const longName = 'a'.repeat(51);
+            const result = validator.validateName(longName);
+            expect(result.isValid).toBe(false);
+            expect(result.errors).toContain('Name must be 50 characters or less');
+        });
+        it('should reject names with invalid characters', () => {
+            const invalidNames = ['test@agent', 'agent.name', 'test agent', 'agent!'];
+            for (const name of invalidNames) {
+                const result = validator.validateName(name);
+                expect(result.isValid).toBe(false);
+                expect(result.errors).toContain('Name can only contain letters, numbers, hyphens, and underscores');
+            }
+        });
+        it('should reject names starting with special characters', () => {
+            const invalidNames = ['-agent', '_agent'];
+            for (const name of invalidNames) {
+                const result = validator.validateName(name);
+                expect(result.isValid).toBe(false);
+                expect(result.errors).toContain('Name cannot start with a hyphen or underscore');
+            }
+        });
+        it('should reject names ending with special characters', () => {
+            const invalidNames = ['agent-', 'agent_'];
+            for (const name of invalidNames) {
+                const result = validator.validateName(name);
+                expect(result.isValid).toBe(false);
+                expect(result.errors).toContain('Name cannot end with a hyphen or underscore');
+            }
+        });
+        it('should reject reserved names', () => {
+            const reservedNames = [
+                'self',
+                'system',
+                'user',
+                'model',
+                'tool',
+                'config',
+                'default',
+            ];
+            for (const name of reservedNames) {
+                const result = validator.validateName(name);
+                expect(result.isValid).toBe(false);
+                expect(result.errors).toContain(`"${name}" is a reserved name and cannot be used`);
+            }
+        });
+        it('should warn about naming conventions', () => {
+            const result = validator.validateName('TestAgent');
+            expect(result.isValid).toBe(true);
+            expect(result.warnings).toContain('Consider using lowercase names for consistency');
+        });
+        it('should warn about mixed separators', () => {
+            const result = validator.validateName('test-agent_helper');
+            expect(result.isValid).toBe(true);
+            expect(result.warnings).toContain('Consider using either hyphens or underscores consistently, not both');
+        });
+    });
+    describe('validateSystemPrompt', () => {
+        it('should accept valid system prompts', () => {
+            const validPrompts = [
+                'You are a helpful assistant.',
+                'You are a code reviewer. Analyze the provided code and suggest improvements.',
+                'Help the user with ${task} by using available tools.',
+            ];
+            for (const prompt of validPrompts) {
+                const result = validator.validateSystemPrompt(prompt);
+                expect(result.isValid).toBe(true);
+                expect(result.errors).toHaveLength(0);
+            }
+        });
+        it('should reject empty prompts', () => {
+            const invalidPrompts = ['', '   ', '\t\n'];
+            for (const prompt of invalidPrompts) {
+                const result = validator.validateSystemPrompt(prompt);
+                expect(result.isValid).toBe(false);
+                expect(result.errors).toContain('System prompt is required and cannot be empty');
+            }
+        });
+        it('should reject prompts that are too short', () => {
+            const result = validator.validateSystemPrompt('Short');
+            expect(result.isValid).toBe(false);
+            expect(result.errors).toContain('System prompt must be at least 10 characters long');
+        });
+        it('should reject prompts that are too long', () => {
+            const longPrompt = 'a'.repeat(10001);
+            const result = validator.validateSystemPrompt(longPrompt);
+            expect(result.isValid).toBe(false);
+            expect(result.errors).toContain('System prompt is too long (>10,000 characters)');
+        });
+        it('should warn about long prompts', () => {
+            const longPrompt = 'a'.repeat(5001);
+            const result = validator.validateSystemPrompt(longPrompt);
+            expect(result.isValid).toBe(true);
+            expect(result.warnings).toContain('System prompt is quite long (>5,000 characters), consider shortening');
+        });
+    });
+    describe('validateTools', () => {
+        it('should accept valid tool arrays', () => {
+            const result = validator.validateTools(['read_file', 'write_file']);
+            expect(result.isValid).toBe(true);
+            expect(result.errors).toHaveLength(0);
+        });
+        it('should reject non-array inputs', () => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const result = validator.validateTools('not-an-array');
+            expect(result.isValid).toBe(false);
+            expect(result.errors).toContain('Tools must be an array of strings');
+        });
+        it('should warn about empty arrays', () => {
+            const result = validator.validateTools([]);
+            expect(result.isValid).toBe(true);
+            expect(result.warnings).toContain('Empty tools array - subagent will inherit all available tools');
+        });
+        it('should warn about duplicate tools', () => {
+            const result = validator.validateTools([
+                'read_file',
+                'read_file',
+                'write_file',
+            ]);
+            expect(result.isValid).toBe(true);
+            expect(result.warnings).toContain('Duplicate tool names found in tools array');
+        });
+        it('should reject non-string tool names', () => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const result = validator.validateTools([123, 'read_file']);
+            expect(result.isValid).toBe(false);
+            expect(result.errors).toContain('Tool name must be a string, got: number');
+        });
+        it('should reject empty tool names', () => {
+            const result = validator.validateTools(['', 'read_file']);
+            expect(result.isValid).toBe(false);
+            expect(result.errors).toContain('Tool name cannot be empty');
+        });
+    });
+    describe('validateModelConfig', () => {
+        it('should accept valid model configurations', () => {
+            const validConfigs = [
+                { model: 'gemini-1.5-pro', temp: 0.7, top_p: 0.9 },
+                { temp: 0.5 },
+                { top_p: 1.0 },
+                {},
+            ];
+            for (const config of validConfigs) {
+                const result = validator.validateModelConfig(config);
+                expect(result.isValid).toBe(true);
+                expect(result.errors).toHaveLength(0);
+            }
+        });
+        it('should reject invalid model names', () => {
+            const result = validator.validateModelConfig({ model: '' });
+            expect(result.isValid).toBe(false);
+            expect(result.errors).toContain('Model name must be a non-empty string');
+        });
+        it('should reject invalid temperature values', () => {
+            const invalidTemps = [-0.1, 2.1, 'not-a-number'];
+            for (const temp of invalidTemps) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const result = validator.validateModelConfig({ temp: temp });
+                expect(result.isValid).toBe(false);
+            }
+        });
+        it('should warn about high temperature', () => {
+            const result = validator.validateModelConfig({ temp: 1.5 });
+            expect(result.isValid).toBe(true);
+            expect(result.warnings).toContain('High temperature (>1) may produce very creative but unpredictable results');
+        });
+        it('should reject invalid top_p values', () => {
+            const invalidTopP = [-0.1, 1.1, 'not-a-number'];
+            for (const top_p of invalidTopP) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const result = validator.validateModelConfig({ top_p: top_p });
+                expect(result.isValid).toBe(false);
+            }
+        });
+    });
+    describe('validateRunConfig', () => {
+        it('should accept valid run configurations', () => {
+            const validConfigs = [
+                { max_time_minutes: 10, max_turns: 20 },
+                { max_time_minutes: 5 },
+                { max_turns: 10 },
+                {},
+            ];
+            for (const config of validConfigs) {
+                const result = validator.validateRunConfig(config);
+                expect(result.isValid).toBe(true);
+                expect(result.errors).toHaveLength(0);
+            }
+        });
+        it('should reject invalid max_time_minutes', () => {
+            const invalidTimes = [0, -1, 'not-a-number'];
+            for (const time of invalidTimes) {
+                const result = validator.validateRunConfig({
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    max_time_minutes: time,
+                });
+                expect(result.isValid).toBe(false);
+            }
+        });
+        it('should warn about very long execution times', () => {
+            const result = validator.validateRunConfig({ max_time_minutes: 120 });
+            expect(result.isValid).toBe(true);
+            expect(result.warnings).toContain('Very long execution time (>60 minutes) may cause resource issues');
+        });
+        it('should reject invalid max_turns', () => {
+            const invalidTurns = [0, -1, 1.5, 'not-a-number'];
+            for (const turns of invalidTurns) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const result = validator.validateRunConfig({ max_turns: turns });
+                expect(result.isValid).toBe(false);
+            }
+        });
+        it('should warn about high turn limits', () => {
+            const result = validator.validateRunConfig({ max_turns: 150 });
+            expect(result.isValid).toBe(true);
+            expect(result.warnings).toContain('Very high turn limit (>100) may cause long execution times');
+        });
+    });
+    describe('validateConfig', () => {
+        const validConfig = {
+            name: 'test-agent',
+            description: 'A test subagent',
+            systemPrompt: 'You are a helpful assistant.',
+            level: 'project',
+            filePath: '/path/to/test-agent.md',
+        };
+        it('should accept valid configurations', () => {
+            const result = validator.validateConfig(validConfig);
+            expect(result.isValid).toBe(true);
+            expect(result.errors).toHaveLength(0);
+        });
+        it('should collect errors from all validation steps', () => {
+            const invalidConfig = {
+                name: '',
+                description: '',
+                systemPrompt: '',
+                level: 'project',
+                filePath: '/path/to/invalid.md',
+            };
+            const result = validator.validateConfig(invalidConfig);
+            expect(result.isValid).toBe(false);
+            expect(result.errors.length).toBeGreaterThan(0);
+        });
+        it('should collect warnings from all validation steps', () => {
+            const configWithWarnings = {
+                ...validConfig,
+                name: 'TestAgent', // Will generate warning about case
+                description: 'A'.repeat(501), // Will generate warning about long description
+            };
+            const result = validator.validateConfig(configWithWarnings);
+            expect(result.isValid).toBe(true);
+            expect(result.warnings.length).toBeGreaterThan(0);
+        });
+    });
+    describe('validateOrThrow', () => {
+        const validConfig = {
+            name: 'test-agent',
+            description: 'A test subagent',
+            systemPrompt: 'You are a helpful assistant.',
+            level: 'project',
+            filePath: '/path/to/test-agent.md',
+        };
+        it('should not throw for valid configurations', () => {
+            expect(() => validator.validateOrThrow(validConfig)).not.toThrow();
+        });
+        it('should throw SubagentError for invalid configurations', () => {
+            const invalidConfig = {
+                ...validConfig,
+                name: '',
+            };
+            expect(() => validator.validateOrThrow(invalidConfig)).toThrow(SubagentError);
+            expect(() => validator.validateOrThrow(invalidConfig)).toThrow(/Validation failed/);
+        });
+        it('should include subagent name in error', () => {
+            const invalidConfig = {
+                ...validConfig,
+                name: '',
+            };
+            try {
+                validator.validateOrThrow(invalidConfig, 'custom-name');
+                expect.fail('Should have thrown');
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(SubagentError);
+                expect(error.subagentName).toBe('custom-name');
+            }
+        });
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/src/subagents/validation.test.js.map

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

package/dist/src/telemetry/blackbox-logger/blackbox-logger.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HttpsProxyAgent } from 'https-proxy-agent';
+import type { StartSessionEvent, UserPromptEvent, ToolCallEvent, ApiRequestEvent, ApiResponseEvent, ApiErrorEvent, FileOperationEvent, FlashFallbackEvent, LoopDetectedEvent, NextSpeakerCheckEvent, SlashCommandEvent, MalformedJsonResponseEvent, IdeConnectionEvent, KittySequenceOverflowEvent, ChatCompressionEvent, InvalidChunkEvent, ContentRetryEvent, ContentRetryFailureEvent, ConversationFinishedEvent, SubagentExecutionEvent } from '../types.js';
+import { EndSessionEvent } from '../types.js';
+import type { RumEvent, RumViewEvent, RumActionEvent, RumResourceEvent, RumExceptionEvent, RumPayload } from './event-types.js';
+import type { Config } from '../../config/config.js';
+export interface LogResponse {
+    nextRequestWaitMs?: number;
+}
+export declare class BlackboxLogger {
+    private static instance;
+    private config?;
+    private readonly installationManager;
+    /**
+     * Queue of pending events that need to be flushed to the server. New events
+     * are added to this queue and then flushed on demand (via `flushToRum`)
+     */
+    private readonly events;
+    /**
+     * The last time that the events were successfully flushed to the server.
+     */
+    private lastFlushTime;
+    private userId;
+    private sessionId;
+    /**
+     * The value is true when there is a pending flush happening. This prevents
+     * concurrent flush operations.
+     */
+    private isFlushInProgress;
+    /**
+     * This value is true when a flush was requested during an ongoing flush.
+     */
+    private pendingFlush;
+    private isShutdown;
+    private constructor();
+    private generateUserId;
+    static getInstance(config?: Config): BlackboxLogger | undefined;
+    enqueueLogEvent(event: RumEvent): void;
+    createRumEvent(eventType: 'view' | 'action' | 'exception' | 'resource', type: string, name: string, properties: Partial<RumEvent>): RumEvent;
+    createViewEvent(type: string, name: string, properties: Partial<RumViewEvent>): RumEvent;
+    createActionEvent(type: string, name: string, properties: Partial<RumActionEvent>): RumEvent;
+    createResourceEvent(type: string, name: string, properties: Partial<RumResourceEvent>): RumEvent;
+    createExceptionEvent(type: string, name: string, properties: Partial<RumExceptionEvent>): RumEvent;
+    createRumPayload(): Promise<RumPayload>;
+    flushIfNeeded(): void;
+    flushToRum(): Promise<LogResponse>;
+    logStartSessionEvent(event: StartSessionEvent): void;
+    logNewPromptEvent(event: UserPromptEvent): void;
+    logToolCallEvent(event: ToolCallEvent): void;
+    logFileOperationEvent(event: FileOperationEvent): void;
+    logApiRequestEvent(event: ApiRequestEvent): void;
+    logApiResponseEvent(event: ApiResponseEvent): void;
+    logApiErrorEvent(event: ApiErrorEvent): void;
+    logFlashFallbackEvent(event: FlashFallbackEvent): void;
+    logLoopDetectedEvent(event: LoopDetectedEvent): void;
+    logNextSpeakerCheck(event: NextSpeakerCheckEvent): void;
+    logSlashCommandEvent(event: SlashCommandEvent): void;
+    logMalformedJsonResponseEvent(event: MalformedJsonResponseEvent): void;
+    logIdeConnectionEvent(event: IdeConnectionEvent): void;
+    logConversationFinishedEvent(event: ConversationFinishedEvent): void;
+    logKittySequenceOverflowEvent(event: KittySequenceOverflowEvent): void;
+    logChatCompressionEvent(event: ChatCompressionEvent): void;
+    logInvalidChunkEvent(event: InvalidChunkEvent): void;
+    logContentRetryEvent(event: ContentRetryEvent): void;
+    logContentRetryFailureEvent(event: ContentRetryFailureEvent): void;
+    logSubagentExecutionEvent(event: SubagentExecutionEvent): void;
+    logEndSessionEvent(_event: EndSessionEvent): void;
+    getProxyAgent(): HttpsProxyAgent<string> | undefined;
+    shutdown(): void;
+    private requeueFailedEvents;
+}
+export declare const TEST_ONLY: {
+    MAX_RETRY_EVENTS: number;
+    MAX_EVENTS: number;
+    FLUSH_INTERVAL_MS: number;
+};