@vybestack/llxprt-code-core 0.4.8 → 0.5.0-nightly.251102.e5b51aa3

package/dist/src/config/subagentManager.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SubagentConfig } from '../config/types.js';
+import { ProfileManager } from './profileManager.js';
+/**
+ * Manages subagent configuration files in ~/.llxprt/subagents/
+ *
+ * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+ * @requirement:REQ-002
+ *
+ * Pattern: Follows ProfileManager design
+ * Storage: JSON files in baseDir directory
+ * Naming: <name>.json
+ */
+export declare class SubagentManager {
+    private readonly baseDir;
+    private readonly profileManager;
+    /**
+     * @param baseDir Directory where subagent configs are stored (e.g., ~/.llxprt/subagents/)
+     * @param profileManager ProfileManager instance for validation
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 1-8
+     */
+    constructor(baseDir: string, profileManager: ProfileManager);
+    /**
+     * Save or update a subagent configuration
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 61-128
+     */
+    saveSubagent(name: string, profile: string, systemPrompt: string): Promise<void>;
+    /**
+     * Load a subagent configuration from disk
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 129-180
+     */
+    loadSubagent(name: string): Promise<SubagentConfig>;
+    /**
+     * List all subagent names
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 181-209
+     */
+    listSubagents(): Promise<string[]>;
+    /**
+     * Delete a subagent configuration
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 210-236
+     *
+     * @returns true if deleted, false if not found
+     */
+    deleteSubagent(name: string): Promise<boolean>;
+    /**
+     * Check if a subagent configuration exists
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 237-262
+     */
+    subagentExists(name: string): Promise<boolean>;
+    /**
+     * Validate that a profile exists in ProfileManager
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 263-281
+     */
+    validateProfileReference(profileName: string): Promise<boolean>;
+    /**
+     * Get full path to subagent config file
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 9-43
+     */
+    private getSubagentPath;
+    /**
+     * Ensure subagent directory exists, create if not
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 45-60
+     */
+    private ensureDirectory;
+}

package/dist/src/config/subagentManager.js

@@ -0,0 +1,371 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fsPromises from 'fs/promises';
+import * as path from 'path';
+// Error message templates for consistency
+// @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+const ERROR_MESSAGES = {
+    INVALID_NAME: 'Invalid subagent name. Only alphanumeric, hyphens, and underscores allowed.',
+    NAME_REQUIRED: 'Subagent name is required.',
+    PROFILE_REQUIRED: 'Profile name is required.',
+    PROMPT_REQUIRED: 'Empty system prompt not allowed.',
+    PROFILE_NOT_FOUND: "Profile '{profile}' not found. Use '/profile list' to see available profiles.",
+    SUBAGENT_NOT_FOUND: "Subagent '{name}' not found.",
+    PERMISSION_DENIED: 'Permission denied: {operation}.',
+    DISK_FULL: 'No disk space: {operation}.',
+    CORRUPTED_FILE: "Subagent '{name}' file is corrupted (invalid JSON).",
+    INVALID_CONFIG: "Subagent '{name}' is invalid: {reason}.",
+    DIRECTORY_NOT_FOUND: 'Directory not found: {path}',
+    CANNOT_PERFORM_OP: 'Cannot perform operation: {reason}',
+    MISSING_FIELDS: "Subagent '{name}' file is missing required configuration fields.",
+    INVALID_TIMESTAMP: "Subagent '{name}' has an invalid timestamp format. Expected ISO 8601.",
+    FILENAME_MISMATCH: "Subagent filename mismatch: expected '{expected}', found '{actual}'",
+};
+/**
+ * Manages subagent configuration files in ~/.llxprt/subagents/
+ *
+ * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+ * @requirement:REQ-002
+ *
+ * Pattern: Follows ProfileManager design
+ * Storage: JSON files in baseDir directory
+ * Naming: <name>.json
+ */
+export class SubagentManager {
+    baseDir;
+    profileManager;
+    /**
+     * @param baseDir Directory where subagent configs are stored (e.g., ~/.llxprt/subagents/)
+     * @param profileManager ProfileManager instance for validation
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 1-8
+     */
+    constructor(baseDir, profileManager) {
+        this.baseDir = baseDir;
+        this.profileManager = profileManager;
+    }
+    /**
+     * Save or update a subagent configuration
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 61-128
+     */
+    async saveSubagent(name, profile, systemPrompt) {
+        if (profile === undefined || profile.trim() === '') {
+            throw new Error('Profile name is required.');
+        }
+        if (systemPrompt === undefined || systemPrompt.trim() === '') {
+            throw new Error(ERROR_MESSAGES.PROMPT_REQUIRED);
+        }
+        // Validate profile exists
+        const profileExists = await this.validateProfileReference(profile);
+        if (!profileExists) {
+            throw new Error(ERROR_MESSAGES.PROFILE_NOT_FOUND.replace('{profile}', profile));
+        }
+        // Check if subagent exists for update vs create
+        const exists = await this.subagentExists(name);
+        let config;
+        if (exists) {
+            // Load existing to preserve createdAt
+            const existing = await this.loadSubagent(name);
+            config = {
+                name,
+                profile,
+                systemPrompt,
+                createdAt: existing.createdAt, // Preserve original timestamp
+                updatedAt: new Date().toISOString(), // Update timestamp
+            };
+        }
+        else {
+            // Create new with current timestamps
+            const now = new Date().toISOString();
+            config = {
+                name,
+                profile,
+                systemPrompt,
+                createdAt: now,
+                updatedAt: now,
+            };
+        }
+        // Ensure directory exists
+        await this.ensureDirectory();
+        // Get file path via private helper
+        const filePath = this.getSubagentPath(name);
+        // Prepare JSON content
+        const jsonString = JSON.stringify(config, null, 2);
+        // Write to file
+        try {
+            await fsPromises.writeFile(filePath, jsonString, 'utf-8');
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error) {
+                const code = error.code;
+                if (code === 'EACCES') {
+                    throw new Error(ERROR_MESSAGES.PERMISSION_DENIED.replace('{operation}', `Cannot write subagent file ${filePath}`));
+                }
+                else if (code === 'ENOSPC') {
+                    throw new Error(ERROR_MESSAGES.DISK_FULL.replace('{operation}', `Cannot write subagent file ${filePath}`));
+                }
+                else if (code === 'ENOENT') {
+                    throw new Error(ERROR_MESSAGES.DIRECTORY_NOT_FOUND.replace('{path}', this.baseDir));
+                }
+            }
+            throw new Error(ERROR_MESSAGES.CANNOT_PERFORM_OP.replace('{reason}', error instanceof Error ? error.message : 'Unknown error'));
+        }
+    }
+    /**
+     * Load a subagent configuration from disk
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 129-180
+     */
+    async loadSubagent(name) {
+        // Validate input via private helper
+        const filePath = this.getSubagentPath(name);
+        let content;
+        // Read file
+        try {
+            content = await fsPromises.readFile(filePath, 'utf-8');
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error) {
+                const code = error.code;
+                if (code === 'ENOENT') {
+                    throw new Error(ERROR_MESSAGES.SUBAGENT_NOT_FOUND.replace('{name}', name));
+                }
+                else if (code === 'EACCES') {
+                    throw new Error(ERROR_MESSAGES.PERMISSION_DENIED.replace('{operation}', `Cannot read subagent file ${filePath}`));
+                }
+            }
+            throw new Error(ERROR_MESSAGES.CANNOT_PERFORM_OP.replace('{reason}', error instanceof Error ? error.message : 'Unknown error'));
+        }
+        let config;
+        // Parse JSON
+        try {
+            config = JSON.parse(content);
+        }
+        catch (error) {
+            if (error instanceof SyntaxError) {
+                throw new Error(ERROR_MESSAGES.CORRUPTED_FILE.replace('{name}', name));
+            }
+            throw new Error(ERROR_MESSAGES.CANNOT_PERFORM_OP.replace('{reason}', error instanceof Error ? error.message : 'Unknown error'));
+        }
+        // Validate required fields
+        const { name: configName, profile, systemPrompt, createdAt, updatedAt, } = config;
+        if (!configName || !profile || !systemPrompt) {
+            throw new Error(`Subagent '${name}' file is missing required field(s): name, profile, or systemPrompt.`);
+        }
+        if (!createdAt || !updatedAt) {
+            throw new Error(`Subagent '${name}' file is missing required field(s): createdAt or updatedAt.`);
+        } // @plan:PLAN-20250117-SUBAGENTCONFIG.P05 @requirement:REQ-002
+        // Validate timestamp format
+        if (Number.isNaN(Date.parse(config.createdAt)) ||
+            Number.isNaN(Date.parse(config.updatedAt))) {
+            throw new Error(ERROR_MESSAGES.INVALID_TIMESTAMP.replace('{name}', name));
+        }
+        // Validate name matches filename after sanitization
+        const canonicalName = config.name.replace(/[^a-zA-Z0-9_-]/g, '');
+        if (canonicalName !== path.basename(filePath, '.json')) {
+            throw new Error(ERROR_MESSAGES.FILENAME_MISMATCH.replace('{expected}', canonicalName).replace('{actual}', path.basename(filePath, '.json')));
+        }
+        return config;
+    }
+    /**
+     * List all subagent names
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 181-209
+     */
+    async listSubagents() {
+        try {
+            // Ensure directory exists
+            await this.ensureDirectory();
+            // Read directory contents
+            const files = await fsPromises.readdir(this.baseDir);
+            // Filter for .json files and extract names
+            const subagentFiles = files.filter((file) => file.endsWith('.json'));
+            const subagentNames = subagentFiles.map((file) => file.slice(0, -5)); // Remove .json extension
+            // Sort alphabetically
+            subagentNames.sort();
+            return subagentNames;
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error) {
+                const code = error.code;
+                if (code === 'ENOENT') {
+                    // Directory doesn't exist yet, return empty list
+                    return [];
+                }
+                else if (code === 'EACCES') {
+                    throw new Error(ERROR_MESSAGES.PERMISSION_DENIED.replace('{operation}', `Cannot read subagent directory ${this.baseDir}`));
+                }
+            }
+            throw new Error(ERROR_MESSAGES.CANNOT_PERFORM_OP.replace('{reason}', error instanceof Error ? error.message : 'Unknown error'));
+        }
+    }
+    /**
+     * Delete a subagent configuration
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 210-236
+     *
+     * @returns true if deleted, false if not found
+     */
+    async deleteSubagent(name) {
+        // Validate input via private helper
+        const filePath = this.getSubagentPath(name);
+        // Check if subagent exists
+        const exists = await this.subagentExists(name);
+        if (!exists) {
+            return false;
+        }
+        // Delete file
+        try {
+            await fsPromises.unlink(filePath);
+            return true;
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error) {
+                const code = error.code;
+                if (code === 'ENOENT') {
+                    // File already deleted
+                    return false;
+                }
+                else if (code === 'EACCES') {
+                    throw new Error(ERROR_MESSAGES.PERMISSION_DENIED.replace('{operation}', `Cannot delete subagent file ${filePath}`));
+                }
+            }
+            throw new Error(ERROR_MESSAGES.CANNOT_PERFORM_OP.replace('{reason}', error instanceof Error ? error.message : 'Unknown error'));
+        }
+    }
+    /**
+     * Check if a subagent configuration exists
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 237-262
+     */
+    async subagentExists(name) {
+        // Validate input via private helper
+        // This check will return false for empty or invalid names.
+        let filePath;
+        try {
+            filePath = this.getSubagentPath(name);
+        }
+        catch (_error) {
+            // getSubagentPath throws for invalid names. If it throws here, the agent doesn't exist.
+            return false;
+        }
+        // Check file existence
+        try {
+            await fsPromises.access(filePath);
+            return true;
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error) {
+                const code = error.code;
+                if (code === 'ENOENT') {
+                    return false;
+                }
+            }
+            // For other access errors, treat as not existing to be safe (aligns with pseudocode).
+            return false;
+        }
+    }
+    /**
+     * Validate that a profile exists in ProfileManager
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 263-281
+     */
+    async validateProfileReference(profileName) {
+        // Validate input
+        if (profileName === undefined ||
+            profileName === null ||
+            profileName.trim() === '') {
+            return false;
+        }
+        // Check if profile exists using the injected ProfileManager instance.
+        try {
+            const availableProfiles = await this.profileManager.listProfiles();
+            return availableProfiles.includes(profileName);
+        }
+        catch (error) {
+            // If ProfileManager fails, we cannot validate
+            console.warn(`Cannot validate profile reference '${profileName}': ${error instanceof Error ? error.message : 'unknown error'}`);
+            return false;
+        }
+    }
+    /**
+     * Get full path to subagent config file
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 9-43
+     */
+    getSubagentPath(name) {
+        // Centralize all name validation in this helper
+        // 1. Validate name is not undefined or null
+        if (name === undefined || name === null) {
+            throw new Error(ERROR_MESSAGES.NAME_REQUIRED);
+        }
+        // 2. Validate name is not an empty string or just whitespace
+        if (name.trim() === '') {
+            throw new Error(ERROR_MESSAGES.INVALID_NAME);
+        }
+        // 3. Sanitize filename (prevent path traversal)
+        const sanitizedName = name.replace(/[^a-zA-Z0-9_-]/g, '');
+        // 4. Validate name after sanitization
+        if (sanitizedName !== name) {
+            throw new Error(ERROR_MESSAGES.INVALID_NAME);
+        }
+        // 5. Validate baseDir is provided to the instance
+        if (this.baseDir === undefined ||
+            this.baseDir === null ||
+            this.baseDir.trim() === '') {
+            throw new Error('Base directory is required');
+        }
+        // 6. Validate profileManager is provided to the instance
+        if (this.profileManager === undefined || this.profileManager === null) {
+            throw new Error('ProfileManager instance is required');
+        }
+        // Construct full path
+        return path.join(this.baseDir, `${sanitizedName}.json`);
+    }
+    /**
+     * Ensure subagent directory exists, create if not
+     *
+     * @plan:PLAN-20250117-SUBAGENTCONFIG.P05
+     * @requirement:REQ-002
+     * @pseudocode SubagentManager.md lines 45-60
+     */
+    async ensureDirectory() {
+        try {
+            // Create directory if it doesn't exist
+            await fsPromises.mkdir(this.baseDir, { recursive: true });
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error) {
+                const code = error.code;
+                if (code === 'EACCES') {
+                    throw new Error(ERROR_MESSAGES.PERMISSION_DENIED.replace('{operation}', `Cannot create directory ${this.baseDir}`));
+                }
+                else if (code === 'ENOSPC') {
+                    throw new Error(ERROR_MESSAGES.DISK_FULL.replace('{operation}', `Cannot create directory ${this.baseDir}`));
+                }
+            }
+            throw new Error(ERROR_MESSAGES.CANNOT_PERFORM_OP.replace('{reason}', error instanceof Error ? error.message : 'unknown error'));
+        }
+    }
+}
+//# sourceMappingURL=subagentManager.js.map

package/dist/src/config/subagentManager.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * Subagent configuration stored in ~/.llxprt/subagents/<name>.json
+ * @plan:PLAN-20250117-SUBAGENTCONFIG.P03
+ * @requirement:REQ-001
+ * @requirement:REQ-012
+ */
+export interface SubagentConfig {
+    /** Subagent identifier (matches filename without .json) */
+    name: string;
+    /** Reference to profile name in ~/.llxprt/profiles/ */
+    profile: string;
+    /** System prompt text for this subagent */
+    systemPrompt: string;
+    /** ISO 8601 timestamp when subagent was created */
+    createdAt: string;
+    /** ISO 8601 timestamp when subagent was last updated */
+    updatedAt: string;
+}

package/dist/src/config/types.js

@@ -0,0 +1,3 @@
+export {};
+// _ = SubagentConfig; // Ensure the interface is considered "used" by the compiler
+//# sourceMappingURL=types.js.map

package/dist/src/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/config/types.ts"],"names":[],"mappings":";AAuBA,mFAAmF"}

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

@@ -3,7 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { GenerateContentConfig, PartListUnion, Content, GenerateContentResponse } from '@google/genai';
+import { GenerateContentConfig, PartListUnion, Content, GenerateContentResponse, SendMessageParameters } from '@google/genai';
 import { Turn, ServerGeminiStreamEvent } from './turn.js';
 import type { ChatCompressionInfo } from './turn.js';
 import { Config } from '../config/config.js';
@@ -11,6 +11,7 @@ import { UserTierId } from '../code_assist/types.js';
 import { GeminiChat } from './geminiChat.js';
 import { HistoryService } from '../services/history/HistoryService.js';
 import { ContentGenerator, ContentGeneratorConfig } from './contentGenerator.js';
+import type { AgentRuntimeState } from '../runtime/AgentRuntimeState.js';
 /**
  * Returns the index of the content after the fraction of the total characters in the history.
  *
@@ -33,6 +34,7 @@ export declare class GeminiClient {
     private lastPromptId?;
     private readonly complexityAnalyzer;
     private readonly todoReminderService;
+    private todoToolsAvailable;
     private lastComplexitySuggestionTime;
     private readonly complexitySuggestionCooldown;
     private lastSentIdeContext;
@@ -42,13 +44,30 @@ export declare class GeminiClient {
     private lastComplexitySuggestionTurn?;
     private toolActivityCount;
     private toolCallReminderLevel;
-    private pendingInstallerNotices;
     /**
      * At any point in this conversation, was compression triggered without
      * being forced and did it fail?
      */
     private hasFailedCompressionAttempt;
-    constructor(config: Config);
+    /**
+     * Runtime state for stateless operation (Phase 5)
+     * @plan PLAN-20251027-STATELESS5.P10
+     * @requirement REQ-STAT5-003.1
+     * @pseudocode gemini-runtime.md lines 21-42
+     */
+    private readonly runtimeState;
+    private _historyService?;
+    private _unsubscribe?;
+    /**
+     * @plan PLAN-20251027-STATELESS5.P10
+     * @requirement REQ-STAT5-003.1
+     * @pseudocode gemini-runtime.md lines 11-66
+     *
+     * Phase 5 constructor: Accept optional AgentRuntimeState and HistoryService
+     * When provided, client operates in stateless mode using runtime state
+     * Otherwise falls back to Config-based operation (backward compatibility)
+     */
+    constructor(config: Config, runtimeState: AgentRuntimeState, historyService?: HistoryService);
     initialize(contentGeneratorConfig: ContentGeneratorConfig): Promise<void>;
     private lazyInitialize;
     getContentGenerator(): ContentGenerator;
@@ -58,10 +77,6 @@ export declare class GeminiClient {
     private isTodoToolCall;
     private appendTodoSuffixToRequest;
     private recordModelActivity;
-    /**
-     * Analyzes the current user request to determine if it's complex enough
-     * to warrant todo reminders
-     */
     addHistory(content: Content): Promise<void>;
     getChat(): GeminiChat;
     /**
@@ -89,6 +104,7 @@ export declare class GeminiClient {
     setTools(): Promise<void>;
     resetChat(): Promise<void>;
     addDirectoryContext(): Promise<void>;
+    generateDirectMessage(params: SendMessageParameters, promptId: string): Promise<GenerateContentResponse>;
     startChat(extraHistory?: Content[]): Promise<GeminiChat>;
     private getIdeContextParts;
     sendMessageStream(request: PartListUnion, signal: AbortSignal, prompt_id: string, turns?: number, originalModel?: string): AsyncGenerator<ServerGeminiStreamEvent, Turn>;
@@ -100,5 +116,9 @@ export declare class GeminiClient {
      * Returns compression info if successful, null if not needed
      */
     tryCompressChat(prompt_id: string, force?: boolean): Promise<ChatCompressionInfo>;
+    private getToolGovernanceEphemerals;
+    private readToolList;
+    private buildToolDeclarationsFromView;
     private getEnabledToolNamesForPrompt;
+    private updateTodoToolAvailabilityFromDeclarations;
 }