@vybestack/llxprt-code-agents 0.10.0-nightly.260613.1adad3b34

package/dist/src/core/hookToolRestrictions.js

@@ -0,0 +1,187 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getFunctionCallsFromParts } from '@vybestack/llxprt-code-core/utils/generateContentResponseUtilities.js';
+import { canonicalizeToolName } from './toolGovernance.js';
+const responseRestrictions = new WeakMap();
+const responseFilteredRestrictedCalls = new WeakMap();
+const functionCallRestrictions = new WeakMap();
+const responseRestrictionsSymbol = Symbol('hookRestrictedAllowedTools');
+const responseFilteredRestrictedCallsSymbol = Symbol('hookRestrictedFilteredCalls');
+const functionCallRestrictionsSymbol = Symbol('hookRestrictedAllowedTools');
+function setResponseRestrictionMetadata(response, allowedTools) {
+    responseRestrictions.set(response, [...allowedTools]);
+    Object.defineProperty(response, responseRestrictionsSymbol, {
+        configurable: true,
+        enumerable: false,
+        value: [...allowedTools],
+    });
+}
+function setResponseFilteredMetadata(response) {
+    responseFilteredRestrictedCalls.set(response, true);
+    Object.defineProperty(response, responseFilteredRestrictedCallsSymbol, {
+        configurable: true,
+        enumerable: false,
+        value: true,
+    });
+}
+function stringifyFunctionCallArgs(args) {
+    try {
+        // JSON.stringify can return undefined at runtime (e.g. for functions or
+        // symbols) even though its type signature says string, so guard the result.
+        const serialized = JSON.stringify(args === undefined ? {} : args);
+        return serialized ?? '{}';
+    }
+    catch {
+        return String(args);
+    }
+}
+function functionCallKey(call) {
+    if (typeof call.id === 'string' && call.id.trim() !== '') {
+        return `id:${call.id}`;
+    }
+    const name = typeof call.name === 'string' ? call.name : '';
+    return `name:${canonicalizeToolName(name)}:args:${stringifyFunctionCallArgs(call.args)}`;
+}
+export function mergeHookRestrictedFunctionCalls(primaryCalls, secondaryCalls) {
+    const seen = new Set(primaryCalls.map(functionCallKey));
+    const merged = [...primaryCalls];
+    for (const call of secondaryCalls) {
+        const key = functionCallKey(call);
+        if (!seen.has(key)) {
+            seen.add(key);
+            merged.push(call);
+        }
+    }
+    return merged;
+}
+export function attachHookRestrictedAllowedTools(response, allowedTools) {
+    if (allowedTools === undefined) {
+        return response;
+    }
+    const restrictedResponse = Object.assign(Object.create(Object.getPrototypeOf(response)), response);
+    restrictedResponse.candidates = response.candidates?.map((candidate) => ({
+        ...candidate,
+        content: candidate.content === undefined
+            ? undefined
+            : {
+                ...candidate.content,
+                parts: candidate.content.parts === undefined
+                    ? undefined
+                    : filterResponseCandidateParts(restrictedResponse, candidate.content.parts, allowedTools),
+            },
+    }));
+    restrictedResponse.automaticFunctionCallingHistory =
+        response.automaticFunctionCallingHistory === undefined
+            ? undefined
+            : filterHookRestrictedContents(response.automaticFunctionCallingHistory, allowedTools).filter((content) => (content.parts?.length ?? 0) > 0);
+    const originalTopLevelCalls = response.functionCalls ?? [];
+    const filteredTopLevelCalls = filterHookRestrictedFunctionCalls(originalTopLevelCalls, allowedTools);
+    if (filteredTopLevelCalls.length < originalTopLevelCalls.length) {
+        setResponseFilteredMetadata(restrictedResponse);
+    }
+    setResponseRestrictionMetadata(restrictedResponse, allowedTools);
+    Object.defineProperty(restrictedResponse, 'functionCalls', {
+        configurable: true,
+        enumerable: true,
+        get() {
+            return filteredTopLevelCalls.length > 0
+                ? filteredTopLevelCalls
+                : undefined;
+        },
+    });
+    return restrictedResponse;
+}
+export function hasFilteredHookRestrictedToolCalls(response) {
+    return (responseFilteredRestrictedCalls.get(response) === true ||
+        response[responseFilteredRestrictedCallsSymbol] === true);
+}
+function filterResponseCandidateParts(response, parts, allowedTools) {
+    const originalCalls = getFunctionCallsFromParts(parts) ?? [];
+    const filteredParts = filterHookRestrictedParts(parts, allowedTools);
+    const filteredCalls = getFunctionCallsFromParts(filteredParts) ?? [];
+    if (filteredCalls.length < originalCalls.length ||
+        filteredParts.length < parts.length) {
+        setResponseFilteredMetadata(response);
+    }
+    return filteredParts;
+}
+export function filterHookRestrictedContent(content, allowedTools) {
+    const parts = content.parts ?? [];
+    return {
+        ...content,
+        parts: filterHookRestrictedParts(parts, allowedTools),
+    };
+}
+export function filterHookRestrictedContents(contents, allowedTools) {
+    if (allowedTools === undefined) {
+        return [...contents];
+    }
+    return contents.map((content) => filterHookRestrictedContent(content, allowedTools));
+}
+export function getHookRestrictedAllowedTools(response) {
+    const allowedTools = responseRestrictions.get(response) ??
+        response[responseRestrictionsSymbol];
+    return allowedTools === undefined ? undefined : [...allowedTools];
+}
+export function setHookRestrictedAllowedToolsOnFunctionCall(functionCall, allowedTools) {
+    if (allowedTools !== undefined) {
+        functionCallRestrictions.set(functionCall, [...allowedTools]);
+        Object.defineProperty(functionCall, functionCallRestrictionsSymbol, {
+            configurable: true,
+            enumerable: false,
+            value: [...allowedTools],
+        });
+    }
+}
+export function getHookRestrictedAllowedToolsForFunctionCall(functionCall) {
+    const allowedTools = functionCallRestrictions.get(functionCall) ??
+        functionCall[functionCallRestrictionsSymbol];
+    return allowedTools === undefined ? undefined : [...allowedTools];
+}
+export function isHookRestrictedToolCall(fnCall, allowedTools) {
+    if (allowedTools === undefined) {
+        return false;
+    }
+    if (typeof fnCall.name !== 'string' || fnCall.name.trim() === '') {
+        return true;
+    }
+    const allowed = new Set(allowedTools.map(canonicalizeToolName));
+    return !allowed.has(canonicalizeToolName(fnCall.name));
+}
+export function filterHookRestrictedParts(parts, allowedTools) {
+    if (allowedTools === undefined) {
+        return [...parts];
+    }
+    return parts.filter((part) => {
+        if (part.functionCall !== undefined) {
+            setHookRestrictedAllowedToolsOnFunctionCall(part.functionCall, allowedTools);
+            return !isHookRestrictedToolCall(part.functionCall, allowedTools);
+        }
+        if (part.functionResponse !== undefined) {
+            const responseAsCall = {
+                id: part.functionResponse.id,
+                name: part.functionResponse.name ?? '',
+                args: {},
+            };
+            return !isHookRestrictedToolCall(responseAsCall, allowedTools);
+        }
+        return true;
+    });
+}
+export function getHookRestrictedFunctionCallsFromParts(parts, allowedTools) {
+    return (getFunctionCallsFromParts(filterHookRestrictedParts(parts, allowedTools)) ??
+        []);
+}
+export function filterHookRestrictedFunctionCalls(calls, allowedTools) {
+    if (allowedTools === undefined) {
+        return [...calls];
+    }
+    return calls.filter((call) => {
+        setHookRestrictedAllowedToolsOnFunctionCall(call, allowedTools);
+        return !isHookRestrictedToolCall(call, allowedTools);
+    });
+}
+//# sourceMappingURL=hookToolRestrictions.js.map

package/dist/src/core/hookToolRestrictions.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type ToolCallRequestInfo } from '@vybestack/llxprt-code-core/core/turn.js';
+import type { MessageBus } from '@vybestack/llxprt-code-core/confirmation-bus/message-bus.js';
+import { type Config } from '@vybestack/llxprt-code-core/config/config.js';
+import { type CompletedToolCall } from './coreToolScheduler.js';
+/**
+ * Configuration subset required for non-interactive tool execution.
+ * Uses the scheduler singleton via getOrCreateScheduler/disposeScheduler.
+ */
+export type ToolExecutionConfig = Pick<Config, 'getToolRegistry' | 'getEphemeralSettings' | 'getEphemeralSetting' | 'getExcludeTools' | 'getSessionId' | 'getTelemetryLogPromptsEnabled' | 'getOrCreateScheduler' | 'disposeScheduler'> & Partial<Pick<Config, 'getAllowedTools' | 'getApprovalMode'>>;
+export declare function executeToolCall(config: ToolExecutionConfig, toolCallRequest: ToolCallRequestInfo, abortSignal?: AbortSignal, dependencies?: {
+    messageBus?: MessageBus;
+}): Promise<CompletedToolCall>;

package/dist/src/core/nonInteractiveToolExecutor.js

@@ -0,0 +1,102 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DEFAULT_AGENT_ID, } from '@vybestack/llxprt-code-core/core/turn.js';
+import { ToolErrorType } from '@vybestack/llxprt-code-tools';
+import { canonicalizeToolName } from './toolGovernance.js';
+async function createScheduler(config, sessionId, completionResolver, dependencies) {
+    return config.getOrCreateScheduler(sessionId, {
+        getPreferredEditor: () => undefined,
+        onEditorClose: () => { },
+        onAllToolCallsComplete: async (completedToolCalls) => {
+            completionResolver?.(completedToolCalls);
+        },
+    }, { interactiveMode: false }, dependencies);
+}
+function isBlockedByHookRestriction(request) {
+    const allowedTools = request.hookRestrictedAllowedTools;
+    if (allowedTools === undefined) {
+        return false;
+    }
+    const allowed = new Set(allowedTools.map(canonicalizeToolName));
+    return !allowed.has(canonicalizeToolName(request.name));
+}
+export async function executeToolCall(config, toolCallRequest, abortSignal, dependencies) {
+    const startTime = Date.now();
+    if (isBlockedByHookRestriction(toolCallRequest)) {
+        return Promise.reject(new Error(`Tool "${toolCallRequest.name}" is disabled by hook restrictions.`));
+    }
+    const agentId = toolCallRequest.agentId ?? DEFAULT_AGENT_ID;
+    toolCallRequest.agentId = agentId;
+    const internalAbortController = new AbortController();
+    let parentAbortHandler = null;
+    if (abortSignal) {
+        if (abortSignal.aborted) {
+            internalAbortController.abort();
+        }
+        else {
+            parentAbortHandler = () => internalAbortController.abort();
+            abortSignal.addEventListener('abort', parentAbortHandler, { once: true });
+        }
+    }
+    let completionResolver = null;
+    const completionPromise = new Promise((resolve) => {
+        completionResolver = resolve;
+    });
+    const sessionId = config.getSessionId();
+    const scheduler = await createScheduler(config, sessionId, completionResolver, dependencies);
+    try {
+        const effectiveSignal = internalAbortController.signal;
+        await scheduler.schedule([toolCallRequest], effectiveSignal);
+        const completedCalls = await completionPromise;
+        if (completedCalls.length !== 1) {
+            throw new Error('Non-interactive executor expects exactly one tool call');
+        }
+        const completed = completedCalls[0];
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty string agentId falls through to default
+        if (!completed.response.agentId) {
+            completed.response.agentId = agentId;
+        }
+        return completed;
+    }
+    catch (e) {
+        return createErrorCompletedToolCall(toolCallRequest, e instanceof Error ? e : new Error(String(e)), ToolErrorType.UNHANDLED_EXCEPTION, Date.now() - startTime);
+    }
+    finally {
+        if (abortSignal && parentAbortHandler) {
+            abortSignal.removeEventListener('abort', parentAbortHandler);
+        }
+        if (internalAbortController.signal.aborted) {
+            scheduler.cancelAll();
+        }
+        config.disposeScheduler(sessionId);
+    }
+}
+function createErrorCompletedToolCall(request, error, errorType, durationMs) {
+    return {
+        status: 'error',
+        request,
+        response: {
+            callId: request.callId,
+            agentId: request.agentId ?? DEFAULT_AGENT_ID,
+            error,
+            errorType,
+            resultDisplay: error.message,
+            responseParts: [
+                // Only functionResponse — the functionCall is already recorded in
+                // history from the model's assistant message (Issue #244).
+                {
+                    functionResponse: {
+                        id: request.callId,
+                        name: request.name,
+                        response: { error: error.message },
+                    },
+                },
+            ],
+        },
+        durationMs,
+    };
+}
+//# sourceMappingURL=nonInteractiveToolExecutor.js.map

package/dist/src/core/nonInteractiveToolExecutor.js.map

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

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

@@ -0,0 +1,105 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '@vybestack/llxprt-code-core/config/config.js';
+import type { AgentRuntimeContext } from '@vybestack/llxprt-code-core/runtime/AgentRuntimeContext.js';
+import type { SubagentSchedulerFactory } from './subagentScheduler.js';
+import type { ContextState } from '@vybestack/llxprt-code-core/core/subagentTypes.js';
+import { type OutputObject, type PromptConfig, type ToolConfig, type OutputConfig, type SubAgentRuntimeOverrides, type ModelConfig, type RunConfig } from '@vybestack/llxprt-code-core/core/subagentTypes.js';
+/**
+ * Represents the scope and execution environment for a subagent.
+ * This class orchestrates the subagent's lifecycle, managing its chat interactions,
+ * runtime context, and the collection of its outputs.
+ *
+ * @plan PLAN-20251028-STATELESS6.P08
+ * @requirement REQ-STAT6-001.1, REQ-STAT6-001.2, REQ-STAT6-003.1, REQ-STAT6-003.2
+ * @pseudocode agent-runtime-context.md line 93 (step 007.1)
+ */
+export declare class SubAgentScope {
+    readonly name: string;
+    readonly runtimeContext: AgentRuntimeContext;
+    private readonly modelConfig;
+    private readonly runConfig;
+    private readonly promptConfig;
+    private readonly contentGenerator;
+    private readonly toolExecutorContext;
+    private readonly environmentContextLoader;
+    private readonly config;
+    private readonly messageBus?;
+    private readonly toolConfig?;
+    private readonly outputConfig?;
+    output: OutputObject;
+    private readonly subagentId;
+    private readonly logger;
+    private readonly textToolParser;
+    private activeAbortController;
+    private readonly parentAbortSignal?;
+    private parentAbortCleanup?;
+    /** Emoji filter instance for subagent output */
+    private readonly emojiFilter?;
+    /** Optional callback for streaming text messages during execution */
+    onMessage?: (message: string) => void;
+    private timeoutHandle;
+    /** @plan PLAN-20251028-STATELESS6.P08, PLAN-20260303-MESSAGEBUS.P01 */
+    private constructor();
+    /**
+     * Returns the unique agent identifier assigned to this subagent scope.
+     */
+    getAgentId(): string;
+    /**
+     * Creates and validates a new SubAgentScope instance.
+     *
+     * @plan PLAN-20251028-STATELESS6.P08
+     * @requirement REQ-STAT6-001.1, REQ-STAT6-003.1, REQ-STAT6-003.2
+     * @plan PLAN-20260309-MESSAGEBUS-DI-REMEDIATION.P05
+     * @requirement REQ-D01-001.1
+     */
+    static create(name: string, foregroundConfig: Config, promptConfig: PromptConfig, modelConfig: ModelConfig, runConfig: RunConfig, toolConfig?: ToolConfig, outputConfig?: OutputConfig, overrides?: SubAgentRuntimeOverrides, parentSignal?: AbortSignal): Promise<SubAgentScope>;
+    private bindParentSignal;
+    private armTimeout;
+    private clearTimeoutHandle;
+    private prepareRun;
+    private buildInitialMessages;
+    /**
+     * Executes the subagent in interactive mode by routing tool calls through the
+     * shared CoreToolScheduler. Tests may supply a custom schedulerFactory to
+     * observe scheduling behaviour without touching the real scheduler.
+     */
+    private runInteractiveGoalCheckLoop;
+    runInteractive(context: ContextState, options?: {
+        schedulerFactory?: SubagentSchedulerFactory;
+    }): Promise<void>;
+    private initScheduler;
+    private runInteractiveTurn;
+    private partitionInteractiveToolRequests;
+    private handleInteractiveToolCalls;
+    private cleanupInteractive;
+    /**
+     * Runs the subagent in a non-interactive mode.
+     *
+     * @plan PLAN-20251028-STATELESS6.P08
+     * @requirement REQ-STAT6-001.1
+     */
+    runNonInteractive(context: ContextState): Promise<void>;
+    private runNonInteractiveTurn;
+    private consumeNonInteractiveStream;
+    private readNextNonInteractiveEvent;
+    private collectNonInteractiveChunk;
+    private dispatchNonInteractiveTurnResult;
+    private buildExecCtx;
+    cancel(reason?: string): void;
+    /**
+     * Dispose of the subagent scope, cleaning up resources and references.
+     * Call this when the subagent is no longer needed to prevent memory leaks.
+     *
+     * Cleanup performed:
+     * - Aborts any active operations
+     * - Removes parent abort signal event listeners
+     * - Nullifies references to allow garbage collection
+     *
+     * Safe to call multiple times.
+     */
+    dispose(): void;
+}