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

package/dist/src/test-utils/runtime.js

@@ -0,0 +1,226 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createProviderRuntimeContext, peekActiveProviderRuntimeContext, setActiveProviderRuntimeContext, } from '../runtime/providerRuntimeContext.js';
+import { SettingsService } from '../settings/SettingsService.js';
+function createSpy(impl) {
+    const calls = [];
+    let implementation = impl ?? (() => undefined);
+    const spy = ((...args) => {
+        calls.push(args);
+        return implementation(...args);
+    });
+    spy.calls = calls;
+    spy.mockImplementation = (fn) => {
+        implementation = fn;
+        return spy;
+    };
+    spy.mockReturnValue = (value) => {
+        implementation = () => value;
+        return spy;
+    };
+    spy.mockReturnValueOnce = (value) => {
+        let called = false;
+        implementation = (..._fnArgs) => {
+            if (called) {
+                return value;
+            }
+            called = true;
+            return value;
+        };
+        return spy;
+    };
+    spy.mockClear = () => {
+        calls.length = 0;
+        implementation = impl ?? (() => undefined);
+        return spy;
+    };
+    return spy;
+}
+/**
+ * Creates a provider instance while binding it to a fresh runtime context.
+ * The runtime is only active during instantiation so the provider captures
+ * the injected settings service without polluting global state.
+ */
+export function createProviderWithRuntime(factory, options = {}) {
+    const previousContext = peekActiveProviderRuntimeContext();
+    const settingsService = options.settingsService ?? new SettingsService();
+    const runtime = createProviderRuntimeContext({
+        settingsService,
+        config: options.config,
+        runtimeId: options.runtimeId ?? 'test.provider.runtime',
+        metadata: {
+            source: 'test-utils#createProviderWithRuntime',
+            ...(options.metadata ?? {}),
+        },
+    });
+    setActiveProviderRuntimeContext(runtime);
+    try {
+        const provider = factory({ runtime, settingsService });
+        return { provider, runtime, settingsService };
+    }
+    finally {
+        setActiveProviderRuntimeContext(previousContext ?? null);
+    }
+}
+/**
+ * Produces a lightweight Config stub sufficient for provider runtime tests.
+ */
+export function createRuntimeConfigStub(settingsService, overrides = {}) {
+    const noop = () => { };
+    const base = {
+        getConversationLoggingEnabled: () => false,
+        setConversationLoggingEnabled: noop,
+        getTelemetryLogPromptsEnabled: () => false,
+        setTelemetryLogPromptsEnabled: noop,
+        getUsageStatisticsEnabled: () => false,
+        setUsageStatisticsEnabled: noop,
+        getDebugMode: () => false,
+        setDebugMode: noop,
+        getSessionId: () => 'test-session',
+        setSessionId: noop,
+        getFlashFallbackMode: () => 'off',
+        setFlashFallbackMode: noop,
+        getProvider: () => 'test-provider',
+        setProvider: noop,
+        getSettingsService: () => settingsService,
+        getProviderSettings: () => ({}),
+        setProviderSettings: noop,
+        getProviderConfig: () => ({}),
+        setProviderConfig: noop,
+        resetProvider: noop,
+        resetProviderSettings: noop,
+        resetProviderConfig: noop,
+        getActiveWorkspace: () => undefined,
+        setActiveWorkspace: noop,
+        clearActiveWorkspace: noop,
+        getExtensionConfig: () => ({}),
+        setExtensionConfig: noop,
+        getFeatures: () => ({}),
+        setFeatures: noop,
+        getRedactionConfig: () => ({ replacements: [] }),
+        setProviderManager: noop,
+        getProviderManager: () => undefined,
+        getProviderSetting: () => undefined,
+        getEphemeralSettings: () => ({ model: 'test-model' }),
+        getEphemeralSetting: () => undefined,
+        setEphemeralSetting: noop,
+        getUserMemory: () => '',
+        setUserMemory: noop,
+        getModel: () => 'test-model',
+        setModel: noop,
+        getQuotaErrorOccurred: () => false,
+        setQuotaErrorOccurred: noop,
+    };
+    return Object.assign(base, overrides);
+}
+/**
+ * Initializes a lightweight provider runtime context for test environments.
+ * Returns the created settings service, config stub, and runtime context.
+ */
+export function initializeTestProviderRuntime(options = {}) {
+    const settingsService = new SettingsService();
+    const config = createRuntimeConfigStub(settingsService, {
+        ...(options.configOverrides ?? {}),
+    });
+    const runtime = createProviderRuntimeContext({
+        settingsService,
+        config,
+        runtimeId: options.runtimeId ??
+            `test.provider.runtime.${Math.random().toString(36).slice(2, 10)}`,
+        metadata: {
+            source: 'test-utils#initializeTestProviderRuntime',
+            ...(options.metadata ?? {}),
+        },
+    });
+    setActiveProviderRuntimeContext(runtime);
+    return { settingsService, config, runtime };
+}
+function requireVi() {
+    const viGlobal = globalThis.vi;
+    if (viGlobal) {
+        return viGlobal;
+    }
+    return {
+        fn: (impl) => createSpy(impl),
+    };
+}
+function createDefaultProvider() {
+    const vi = requireVi();
+    return {
+        name: 'test-provider',
+        isDefault: true,
+        getModels: vi.fn(async () => []),
+        getDefaultModel: () => 'test-model',
+        generateChatCompletion: vi.fn(async function* () {
+            yield { speaker: 'ai', blocks: [] };
+        }),
+        getServerTools: () => [],
+        invokeServerTool: vi.fn(),
+    };
+}
+/**
+ * Creates a Config stub and associated runtime wiring for GeminiChat tests.
+ * The returned config exposes the minimal surface required by the class while
+ * guaranteeing that runtime-aware helpers (e.g. getSettingsService) exist.
+ */
+export function createGeminiChatRuntime(options = {}) {
+    const vi = requireVi();
+    const settingsService = options.settingsService ?? new SettingsService();
+    const runtime = createProviderRuntimeContext({
+        settingsService,
+        runtimeId: options.runtimeId ?? 'test.geminiChat.runtime',
+        metadata: {
+            source: 'test-utils#createGeminiChatRuntime',
+            ...(options.metadata ?? {}),
+        },
+    });
+    const provider = options.provider ?? createDefaultProvider();
+    const providerManager = options.providerManager ??
+        {
+            getActiveProvider: vi.fn().mockReturnValue(provider),
+        };
+    let currentProviderName = provider.name;
+    const getProviderSpy = vi.fn().mockImplementation(() => currentProviderName);
+    const setProviderSpy = vi.fn().mockImplementation((next) => {
+        if (typeof next === 'string') {
+            currentProviderName = next;
+        }
+    });
+    const baseConfig = {
+        getSessionId: () => 'test-session-id',
+        getTelemetryLogPromptsEnabled: () => true,
+        getUsageStatisticsEnabled: () => true,
+        getDebugMode: () => false,
+        getContentGeneratorConfig: () => ({
+            authType: 'oauth-personal',
+            model: 'test-model',
+        }),
+        getModel: vi.fn().mockReturnValue('gemini-pro'),
+        setModel: vi.fn(),
+        getQuotaErrorOccurred: vi.fn().mockReturnValue(false),
+        setQuotaErrorOccurred: vi.fn(),
+        flashFallbackHandler: undefined,
+        getEphemeralSettings: vi.fn().mockReturnValue({}),
+        getEphemeralSetting: vi.fn().mockReturnValue(undefined),
+        getProvider: getProviderSpy,
+        setProvider: setProviderSpy,
+        getProviderManager: vi.fn().mockReturnValue(providerManager),
+        getSettingsService: vi.fn().mockReturnValue(settingsService),
+    };
+    const config = {
+        ...baseConfig,
+        ...(options.configOverrides ?? {}),
+    };
+    Object.assign(runtime, { config: config });
+    return {
+        config: config,
+        provider,
+        providerManager,
+        settingsService,
+        runtime,
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/src/test-utils/runtime.js.map

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

package/dist/src/test-utils/tools.d.ts

@@ -3,15 +3,14 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { vi } from 'vitest';
 import { BaseDeclarativeTool, BaseToolInvocation, ToolCallConfirmationDetails, ToolInvocation, ToolResult } from '../tools/tools.js';
 import { ModifiableDeclarativeTool, ModifyContext } from '../tools/modifiable-tool.js';
-/**
- * A highly configurable mock tool for testing purposes.
- */
+type ToolSpy = ReturnType<(typeof vi)['fn']>;
 export declare class MockTool extends BaseDeclarativeTool<{
     [key: string]: unknown;
 }, ToolResult> {
-    executeFn: import("vitest").Mock<(...args: any[]) => any>;
+    executeFn: ToolSpy;
     shouldConfirm: boolean;
     constructor(name?: string, displayName?: string, description?: string, params?: {
         type: string;
@@ -42,3 +41,4 @@ export declare class MockModifiableTool extends MockTool implements ModifiableDe
     getModifyContext(_abortSignal: AbortSignal): ModifyContext<Record<string, unknown>>;
     protected createInvocation(params: Record<string, unknown>): ToolInvocation<Record<string, unknown>, ToolResult>;
 }
+export {};

package/dist/src/test-utils/tools.js

@@ -12,11 +12,17 @@ class MockToolInvocation extends BaseToolInvocation {
         this.tool = tool;
     }
     async execute(_abortSignal) {
-        const result = this.tool.executeFn(this.params);
-        return (result ?? {
+        const result = await this.tool.executeFn(this.params);
+        if (result &&
+            typeof result === 'object' &&
+            'llmContent' in result &&
+            'returnDisplay' in result) {
+            return result;
+        }
+        return {
             llmContent: `Tool ${this.tool.name} executed successfully.`,
             returnDisplay: `Tool ${this.tool.name} executed successfully.`,
-        });
+        };
     }
     async shouldConfirmExecute(_abortSignal) {
         if (this.tool.shouldConfirm) {
@@ -34,17 +40,15 @@ class MockToolInvocation extends BaseToolInvocation {
         return `A mock tool invocation for ${this.tool.name}`;
     }
 }
-/**
- * A highly configurable mock tool for testing purposes.
- */
 export class MockTool extends BaseDeclarativeTool {
-    executeFn = vi.fn();
+    executeFn;
     shouldConfirm = false;
     constructor(name = 'mock-tool', displayName, description = 'A mock tool for testing.', params = {
         type: 'object',
         properties: { param: { type: 'string' } },
     }) {
         super(name, displayName ?? name, description, Kind.Other, params);
+        this.executeFn = vi.fn();
     }
     createInvocation(params) {
         return new MockToolInvocation(this, params);
@@ -57,11 +61,17 @@ export class MockModifiableToolInvocation extends BaseToolInvocation {
         this.tool = tool;
     }
     async execute(_abortSignal) {
-        const result = this.tool.executeFn(this.params);
-        return (result ?? {
+        const result = await this.tool.executeFn(this.params);
+        if (result &&
+            typeof result === 'object' &&
+            'llmContent' in result &&
+            'returnDisplay' in result) {
+            return result;
+        }
+        return {
             llmContent: `Tool ${this.tool.name} executed successfully.`,
             returnDisplay: `Tool ${this.tool.name} executed successfully.`,
-        });
+        };
     }
     async shouldConfirmExecute(_abortSignal) {
         if (this.tool.shouldConfirm) {

package/dist/src/test-utils/tools.js.map

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

package/dist/src/tools/list-subagents.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, ToolResult } from './tools.js';
+import type { Config } from '../config/config.js';
+import type { SubagentManager } from '../config/subagentManager.js';
+type ListSubagentsParams = Record<string, never>;
+export interface ListSubagentsToolDependencies {
+    getSubagentManager?: () => SubagentManager | undefined;
+}
+declare class ListSubagentsToolInvocation extends BaseToolInvocation<ListSubagentsParams, ToolResult> {
+    private readonly subagentManager;
+    constructor(params: ListSubagentsParams, subagentManager: SubagentManager);
+    getDescription(): string;
+    execute(): Promise<ToolResult>;
+    private buildSummary;
+}
+/**
+ * Tool that enumerates all available subagents and surfaces their metadata.
+ */
+export declare class ListSubagentsTool extends BaseDeclarativeTool<ListSubagentsParams, ToolResult> {
+    private readonly config;
+    private readonly dependencies;
+    static readonly Name = "list_subagents";
+    constructor(config: Config, dependencies?: ListSubagentsToolDependencies);
+    protected createInvocation(params: ListSubagentsParams): ListSubagentsToolInvocation;
+    protected validateToolParamValues(): string | null;
+}
+export {};

package/dist/src/tools/list-subagents.js

@@ -0,0 +1,109 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from './tools.js';
+function summarizePrompt(prompt, maxLength = 160) {
+    if (!prompt) {
+        return '';
+    }
+    const firstLine = prompt
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .find((line) => line.length > 0) ?? prompt.trim();
+    if (firstLine.length <= maxLength) {
+        return firstLine;
+    }
+    const truncated = firstLine.slice(0, maxLength - 1).trimEnd();
+    return `${truncated}…`;
+}
+class ListSubagentsToolInvocation extends BaseToolInvocation {
+    subagentManager;
+    constructor(params, subagentManager) {
+        super(params);
+        this.subagentManager = subagentManager;
+    }
+    getDescription() {
+        return 'Enumerate registered subagents with their profiles and descriptions.';
+    }
+    async execute() {
+        const names = await this.subagentManager.listSubagents();
+        if (names.length === 0) {
+            const message = 'No subagents are currently registered. Use the /subagent CLI command to create one.';
+            return {
+                llmContent: message,
+                returnDisplay: message,
+                metadata: { count: 0 },
+            };
+        }
+        const summaries = [];
+        for (const name of names.sort()) {
+            try {
+                const config = await this.subagentManager.loadSubagent(name);
+                summaries.push(this.buildSummary(config));
+            }
+            catch (error) {
+                const detail = error instanceof Error ? error.message : String(error ?? 'unknown');
+                summaries.push({
+                    name,
+                    profile: 'unknown',
+                    updatedAt: '',
+                    description: `Unable to load subagent: ${detail}`,
+                });
+            }
+        }
+        const display = summaries
+            .map((summary) => {
+            const profilePart = summary.profile && summary.profile !== 'unknown'
+                ? ` (profile: ${summary.profile})`
+                : '';
+            return `- **${summary.name}**${profilePart} — ${summary.description}`;
+        })
+            .join('\n') || 'No subagents are currently registered.';
+        return {
+            llmContent: JSON.stringify(summaries, null, 2),
+            returnDisplay: display,
+            metadata: { count: summaries.length },
+        };
+    }
+    buildSummary(config) {
+        return {
+            name: config.name,
+            profile: config.profile,
+            updatedAt: config.updatedAt,
+            description: summarizePrompt(config.systemPrompt),
+        };
+    }
+}
+/**
+ * Tool that enumerates all available subagents and surfaces their metadata.
+ */
+export class ListSubagentsTool extends BaseDeclarativeTool {
+    config;
+    dependencies;
+    static Name = 'list_subagents';
+    constructor(config, dependencies = {}) {
+        super(ListSubagentsTool.Name, 'ListSubagents', 'Lists all configured subagents with their associated profiles and high-level descriptions.', Kind.Read, {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        });
+        this.config = config;
+        this.dependencies = dependencies;
+    }
+    createInvocation(params) {
+        const manager = this.dependencies.getSubagentManager?.() ??
+            (typeof this.config.getSubagentManager === 'function'
+                ? this.config.getSubagentManager()
+                : undefined);
+        if (!manager) {
+            throw new Error('SubagentManager service is unavailable. Please configure subagents before invoking this tool.');
+        }
+        return new ListSubagentsToolInvocation(params, manager);
+    }
+    validateToolParamValues() {
+        return null;
+    }
+}
+//# sourceMappingURL=list-subagents.js.map

package/dist/src/tools/list-subagents.js.map

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

package/dist/src/tools/task.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, ToolResult } from './tools.js';
+import type { Config } from '../config/config.js';
+import { SubagentOrchestrator } from '../core/subagentOrchestrator.js';
+import type { SubagentSchedulerFactory } from '../core/subagentScheduler.js';
+import type { SubagentManager } from '../config/subagentManager.js';
+import type { ProfileManager } from '../config/profileManager.js';
+import type { ToolRegistry } from './tool-registry.js';
+export interface TaskToolParams {
+    subagent_name?: string;
+    subagentName?: string;
+    goal_prompt?: string;
+    goalPrompt?: string;
+    behaviour_prompts?: string[];
+    behavior_prompts?: string[];
+    behaviourPrompts?: string[];
+    behaviorPrompts?: string[];
+    run_limits?: Partial<RunLimits>;
+    runLimits?: Partial<RunLimits>;
+    tool_whitelist?: string[];
+    toolWhitelist?: string[];
+    output_spec?: Record<string, string>;
+    outputSpec?: Record<string, string>;
+    context?: Record<string, unknown>;
+    context_vars?: Record<string, unknown>;
+    contextVars?: Record<string, unknown>;
+}
+interface RunLimits {
+    max_time_minutes: number;
+    max_turns?: number;
+    interactive?: boolean;
+}
+interface TaskToolInvocationParams {
+    subagentName: string;
+    goalPrompt: string;
+    behaviourPrompts: string[];
+    runConfig?: Partial<RunLimits>;
+    toolWhitelist?: string[];
+    outputSpec?: Record<string, string>;
+    context: Record<string, unknown>;
+    interactive?: boolean;
+}
+export interface TaskToolDependencies {
+    orchestratorFactory?: () => SubagentOrchestrator;
+    profileManager?: ProfileManager;
+    subagentManager?: SubagentManager;
+    schedulerFactoryProvider?: () => SubagentSchedulerFactory | undefined;
+    isInteractiveEnvironment?: () => boolean;
+}
+interface TaskToolInvocationDeps {
+    createOrchestrator: () => SubagentOrchestrator;
+    getToolRegistry?: () => ToolRegistry | undefined;
+    getSchedulerFactory?: () => SubagentSchedulerFactory | undefined;
+    isInteractiveEnvironment?: () => boolean;
+}
+declare class TaskToolInvocation extends BaseToolInvocation<TaskToolParams, ToolResult> {
+    private readonly normalized;
+    private readonly deps;
+    constructor(params: TaskToolParams, normalized: TaskToolInvocationParams, deps: TaskToolInvocationDeps);
+    getDescription(): string;
+    private createLaunchRequest;
+    execute(signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    private buildContextState;
+    private createErrorResult;
+    private createCancelledResult;
+}
+/**
+ * Task tool that launches subagents via SubagentOrchestrator.
+ *
+ * @plan PLAN-20251029-SUBAGENTIC
+ * @requirement REQ-SUBAGENTIC-001, REQ-SUBAGENTIC-002
+ */
+export declare class TaskTool extends BaseDeclarativeTool<TaskToolParams, ToolResult> {
+    private readonly config;
+    private readonly dependencies;
+    static readonly Name = "task";
+    constructor(config: Config, dependencies?: TaskToolDependencies);
+    protected validateToolParamValues(params: TaskToolParams): string | null;
+    protected createInvocation(params: TaskToolParams): TaskToolInvocation;
+    private normalizeParams;
+    private ensureOrchestrator;
+}
+export {};