turboflux 1.0.0

package/dist/core/runtime/agentRuntime.d.ts

@@ -0,0 +1,43 @@
+import { type AgentMode, type ApprovalPolicy, type CapabilityProfile } from '../../shared/agentTypes';
+import { AgentEngine } from '../agentEngine';
+import { McpClient } from '../mcp/client';
+import { SkillRuntime } from '../skills/runtime';
+import { NodeToolExecutor } from './nodeToolExecutor';
+import { RuntimeTaskManager } from './runtimeTaskManager';
+import { SubAgentTaskManager } from './subAgentTaskManager';
+import { DefaultAgentStateProvider, type AgentRuntimeConfig } from './stateProvider';
+import { type TurboFluxProfile } from '../profile';
+import { SessionRegistry } from './sessionRegistry';
+export interface CreateAgentRuntimeOptions {
+    workspacePath: string;
+    workspaceName: string;
+    config: AgentRuntimeConfig;
+    conversationId?: string;
+    conversationPrefix?: string;
+    mode?: AgentMode;
+    approvalPolicy?: ApprovalPolicy;
+    capabilityProfile?: CapabilityProfile;
+    shell?: string;
+    connectMcp?: boolean;
+    mcpServers?: string[];
+    registerSkills?: (skillRuntime: SkillRuntime) => void;
+    profile?: TurboFluxProfile;
+}
+export interface AgentRuntime {
+    engine: AgentEngine;
+    stateProvider: DefaultAgentStateProvider;
+    toolExecutor: NodeToolExecutor;
+    runtimeTaskManager: RuntimeTaskManager;
+    subAgentTaskManager: SubAgentTaskManager;
+    skillRuntime: SkillRuntime;
+    mcpClient: McpClient;
+    sessionRegistry: SessionRegistry;
+    applyConfiguration: (config: AgentRuntimeConfig, options?: {
+        profile?: TurboFluxProfile;
+        approvalPolicy?: ApprovalPolicy;
+        capabilityProfile?: CapabilityProfile;
+    }) => void;
+    disconnect: () => Promise<void>;
+    destroy: () => Promise<void>;
+}
+export declare function createAgentRuntime(options: CreateAgentRuntimeOptions): AgentRuntime;

package/dist/core/runtime/agentRuntime.js

@@ -0,0 +1,137 @@
+import { resolveCapabilityProfileForApproval, } from '../../shared/agentTypes';
+import { join } from 'node:path';
+import { AgentEngine } from '../agentEngine';
+import { McpClient } from '../mcp/client';
+import { loadMcpSettings } from '../mcp/settings';
+import { SkillRuntime } from '../skills/runtime';
+import { syncAgentSkills } from '../subAgent';
+import { NodeToolExecutor } from './nodeToolExecutor';
+import { RuntimeTaskManager } from './runtimeTaskManager';
+import { SubAgentTaskManager } from './subAgentTaskManager';
+import { DefaultAgentStateProvider } from './stateProvider';
+import { buildProfileSystemPromptSection, loadProfile } from '../profile';
+import { SessionRegistry } from './sessionRegistry';
+function getDefaultShell() {
+    return process.platform === 'win32' ? 'powershell' : 'bash';
+}
+function toEngineConfig(options) {
+    const approvalPolicy = options.approvalPolicy || options.config.approvalPolicy || 'ask';
+    const capabilityProfile = resolveCapabilityProfileForApproval(approvalPolicy, options.capabilityProfile || options.config.capabilityProfile);
+    return {
+        mode: options.mode || 'vibe',
+        approvalPolicy,
+        capabilityProfile,
+        gitEnabled: options.config.gitEnabled !== false,
+        temperature: 0.7,
+        workspacePath: options.workspacePath,
+        workspaceName: options.workspaceName,
+        profileSystemPrompt: buildProfileSystemPromptSection(options.profile ?? loadProfile()),
+        conversationId: options.conversationId || `${options.conversationPrefix || 'agent'}-${Date.now()}`,
+        contextWindow: options.config.contextWindow,
+        contextPolicy: 'normal',
+        maxTokens: options.config.maxTokens,
+        shell: options.shell || getDefaultShell(),
+    };
+}
+export function createAgentRuntime(options) {
+    const conversationId = options.conversationId || `${options.conversationPrefix || 'agent'}-${Date.now()}`;
+    const engineConfig = toEngineConfig(options);
+    const sessionRegistry = new SessionRegistry(conversationId);
+    const stateProvider = new DefaultAgentStateProvider({
+        ...options.config,
+        approvalPolicy: engineConfig.approvalPolicy,
+        capabilityProfile: engineConfig.capabilityProfile,
+    }, options.workspacePath, { conversationId });
+    const runtimeTaskManager = new RuntimeTaskManager({
+        defaultOwnerSessionId: conversationId,
+        journalPath: join(options.workspacePath, '.turboflux', 'runtime', 'journal.jsonl'),
+    });
+    const subAgentTaskManager = new SubAgentTaskManager({
+        workspacePath: options.workspacePath,
+        runtimeTaskManager,
+        ownerSessionId: conversationId,
+    });
+    const toolExecutor = new NodeToolExecutor(options.workspacePath, {
+        runtimeTaskManager,
+        capabilityProfile: engineConfig.capabilityProfile,
+    });
+    const engine = new AgentEngine({
+        ...engineConfig,
+        conversationId,
+    }, toolExecutor, stateProvider, subAgentTaskManager);
+    const unsubscribeRuntimeTasks = runtimeTaskManager.subscribe(event => {
+        if (event.type === 'runtime-task:finished')
+            engine.publishRuntimeTaskFinished(event.task);
+    });
+    const removeSessionGuard = sessionRegistry.addGuard(() => {
+        if (engine.isRunning())
+            throw new Error('Cannot switch conversations while the agent is running');
+    });
+    const unsubscribeSessionIdentity = sessionRegistry.subscribe(({ currentId }) => {
+        engine.setConversationId(currentId);
+        stateProvider.setConversationId(currentId);
+        runtimeTaskManager.setDefaultOwnerSessionId(currentId);
+        subAgentTaskManager.setOwnerSessionId(currentId);
+    });
+    const skillRuntime = new SkillRuntime(options.workspacePath);
+    options.registerSkills?.(skillRuntime);
+    syncAgentSkills(skillRuntime);
+    engine.setEnabledSkills(skillRuntime.getAll().map(skill => ({
+        id: skill.id,
+        name: skill.name,
+        command: skill.command,
+        description: skill.description,
+        systemPrompt: skill.systemPrompt,
+        capabilities: skill.capabilities,
+        principles: skill.principles,
+    })));
+    const mcpClient = new McpClient();
+    engine.setMcpClient(mcpClient);
+    if (options.connectMcp === true) {
+        const mcpSettings = loadMcpSettings(options.workspacePath);
+        const selected = new Set(options.mcpServers || ['all']);
+        const servers = Object.entries(mcpSettings.mcpServers).filter(([name, config]) => config.enabled && (selected.has('all') || selected.has(name)));
+        for (const [name, config] of servers) {
+            mcpClient.connect(name, config).catch(() => { });
+        }
+    }
+    const disconnect = async () => {
+        await mcpClient.disconnectAll();
+    };
+    const applyConfiguration = (config, updateOptions = {}) => {
+        const approvalPolicy = updateOptions.approvalPolicy ?? config.approvalPolicy ?? 'ask';
+        const capabilityProfile = resolveCapabilityProfileForApproval(approvalPolicy, updateOptions.capabilityProfile ?? config.capabilityProfile);
+        stateProvider.updateConfig({ ...config, approvalPolicy, capabilityProfile });
+        toolExecutor.setCapabilityProfile(capabilityProfile);
+        engine.updateRuntimeConfiguration({
+            approvalPolicy,
+            capabilityProfile,
+            gitEnabled: config.gitEnabled !== false,
+            contextWindow: config.contextWindow,
+            maxTokens: config.maxTokens,
+            profileSystemPrompt: buildProfileSystemPromptSection(updateOptions.profile ?? loadProfile()),
+        });
+    };
+    return {
+        engine,
+        stateProvider,
+        toolExecutor,
+        runtimeTaskManager,
+        subAgentTaskManager,
+        skillRuntime,
+        mcpClient,
+        sessionRegistry,
+        applyConfiguration,
+        disconnect,
+        destroy: async () => {
+            await disconnect();
+            await runtimeTaskManager.stopAll('Agent runtime destroyed');
+            await toolExecutor.ptyKillAll?.();
+            unsubscribeSessionIdentity();
+            removeSessionGuard();
+            unsubscribeRuntimeTasks();
+            engine.destroy();
+        },
+    };
+}
+//# sourceMappingURL=agentRuntime.js.map

package/dist/core/runtime/agentRuntime.js.map

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

package/dist/core/runtime/approvalCoordinator.d.ts

@@ -0,0 +1,36 @@
+export interface ApprovalRequestIdentity {
+    id: string;
+}
+export interface ApprovalRequestOptions<Decision> {
+    signal?: AbortSignal;
+    cancelDecision: Decision;
+}
+export interface ApprovalRequestSnapshot<Request> {
+    active: Request | null;
+    queued: Request[];
+    pendingCount: number;
+}
+export type ApprovalLifecycleState = 'requested' | 'resolved' | 'cancelled';
+export interface ApprovalLifecycleEvent<Request, Decision> {
+    request: Request;
+    state: ApprovalLifecycleState;
+    decision?: Decision;
+}
+export declare class ApprovalCoordinator<Request extends ApprovalRequestIdentity, Decision> {
+    private readonly present;
+    private readonly lifecycle?;
+    private readonly pending;
+    private readonly order;
+    private activeId;
+    constructor(present: (request: Request, queuedCount: number) => void, lifecycle?: ((event: ApprovalLifecycleEvent<Request, Decision>) => void) | undefined);
+    request(request: Request, options: ApprovalRequestOptions<Decision>): Promise<Decision>;
+    wait(requestId: string): Promise<Decision>;
+    resolve(requestId: string, decision: Decision): boolean;
+    cancel(requestId: string, decision: Decision): boolean;
+    cancelAll(decision?: Decision): number;
+    has(requestId: string): boolean;
+    getActiveRequest(): Request | null;
+    getSnapshot(): ApprovalRequestSnapshot<Request>;
+    private settle;
+    private presentNext;
+}

package/dist/core/runtime/approvalCoordinator.js

@@ -0,0 +1,113 @@
+export class ApprovalCoordinator {
+    present;
+    lifecycle;
+    pending = new Map();
+    order = [];
+    activeId = null;
+    constructor(present, lifecycle) {
+        this.present = present;
+        this.lifecycle = lifecycle;
+    }
+    request(request, options) {
+        if (this.pending.has(request.id)) {
+            throw new Error(`Approval request already exists: ${request.id}`);
+        }
+        let settle;
+        const promise = new Promise(resolve => {
+            settle = resolve;
+        });
+        const entry = {
+            request,
+            promise,
+            resolve: settle,
+            cancelDecision: options.cancelDecision,
+            signal: options.signal,
+        };
+        this.lifecycle?.({ request, state: 'requested' });
+        this.pending.set(request.id, entry);
+        this.order.push(request.id);
+        if (options.signal?.aborted) {
+            this.cancel(request.id, options.cancelDecision);
+            return promise;
+        }
+        if (options.signal) {
+            entry.abortListener = () => this.cancel(request.id, options.cancelDecision);
+            options.signal.addEventListener('abort', entry.abortListener, { once: true });
+        }
+        this.presentNext();
+        return promise;
+    }
+    wait(requestId) {
+        const entry = this.pending.get(requestId);
+        if (!entry)
+            throw new Error(`Unknown approval request: ${requestId}`);
+        return entry.promise;
+    }
+    resolve(requestId, decision) {
+        if (requestId !== this.activeId)
+            return false;
+        return this.settle(requestId, decision, 'resolved');
+    }
+    cancel(requestId, decision) {
+        return this.settle(requestId, decision, 'cancelled');
+    }
+    cancelAll(decision) {
+        const requestIds = [...this.order];
+        let cancelled = 0;
+        for (const requestId of requestIds) {
+            const entry = this.pending.get(requestId);
+            if (entry && this.cancel(requestId, decision ?? entry.cancelDecision))
+                cancelled += 1;
+        }
+        return cancelled;
+    }
+    has(requestId) {
+        return this.pending.has(requestId);
+    }
+    getActiveRequest() {
+        return this.activeId ? this.pending.get(this.activeId)?.request ?? null : null;
+    }
+    getSnapshot() {
+        const active = this.getActiveRequest();
+        const queued = this.order
+            .filter(requestId => requestId !== this.activeId)
+            .map(requestId => this.pending.get(requestId)?.request)
+            .filter((request) => Boolean(request));
+        return { active, queued, pendingCount: this.pending.size };
+    }
+    settle(requestId, decision, state) {
+        const entry = this.pending.get(requestId);
+        if (!entry)
+            return false;
+        this.lifecycle?.({ request: entry.request, state, decision });
+        if (entry.signal && entry.abortListener) {
+            entry.signal.removeEventListener('abort', entry.abortListener);
+        }
+        this.pending.delete(requestId);
+        const index = this.order.indexOf(requestId);
+        if (index >= 0)
+            this.order.splice(index, 1);
+        if (this.activeId === requestId)
+            this.activeId = null;
+        entry.resolve(decision);
+        this.presentNext();
+        return true;
+    }
+    presentNext() {
+        if (this.activeId !== null)
+            return;
+        const nextId = this.order.find(requestId => this.pending.has(requestId));
+        if (!nextId)
+            return;
+        this.activeId = nextId;
+        const entry = this.pending.get(nextId);
+        if (!entry)
+            return;
+        if (entry.signal?.aborted) {
+            this.cancel(nextId, entry.cancelDecision);
+            return;
+        }
+        this.present(entry.request, Math.max(0, this.pending.size - 1));
+    }
+}
+//# sourceMappingURL=approvalCoordinator.js.map

package/dist/core/runtime/approvalCoordinator.js.map

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

package/dist/core/runtime/capabilityBoundary.d.ts

@@ -0,0 +1,18 @@
+import type { CapabilityProfile } from '../../shared/agentTypes';
+export type FilesystemAccess = 'read' | 'write';
+export declare class CapabilityViolationError extends Error {
+    readonly profile: CapabilityProfile;
+    readonly operation: FilesystemAccess | 'command';
+    readonly target?: string | undefined;
+    readonly code = "CAPABILITY_VIOLATION";
+    constructor(profile: CapabilityProfile, operation: FilesystemAccess | 'command', target?: string | undefined);
+}
+export declare class CapabilityBoundary {
+    readonly workspaceRoot: string;
+    private profile;
+    constructor(workspacePath: string, profile?: CapabilityProfile);
+    getProfile(): CapabilityProfile;
+    setProfile(profile: CapabilityProfile): void;
+    resolvePath(inputPath: string, access?: FilesystemAccess): string;
+    assertCommandAllowed(): void;
+}

package/dist/core/runtime/capabilityBoundary.js

@@ -0,0 +1,89 @@
+import { existsSync, realpathSync } from 'node:fs';
+import { basename, dirname, isAbsolute, parse, relative, resolve, sep } from 'node:path';
+export class CapabilityViolationError extends Error {
+    profile;
+    operation;
+    target;
+    code = 'CAPABILITY_VIOLATION';
+    constructor(profile, operation, target) {
+        const detail = target ? `: ${target}` : '';
+        super(`Capability profile "${profile}" does not allow ${operation}${detail}`);
+        this.profile = profile;
+        this.operation = operation;
+        this.target = target;
+        this.name = 'CapabilityViolationError';
+    }
+}
+function resolveInputPath(workspaceRoot, inputPath) {
+    if (inputPath.includes('\0'))
+        throw new Error('Path contains a null byte');
+    if (/^[A-Za-z]:(?![\\/])/.test(inputPath)) {
+        throw new Error(`Drive-relative paths are not supported: ${inputPath}`);
+    }
+    const value = inputPath || '.';
+    const windowsWorkspace = /^[A-Za-z]:[\\/]/.test(workspaceRoot);
+    const modelStyleRootedPath = windowsWorkspace && /^[\\/](?![\\/])/.test(value);
+    if (modelStyleRootedPath)
+        return resolve(workspaceRoot, value.replace(/^[\\/]+/, ''));
+    return isAbsolute(value) ? resolve(value) : resolve(workspaceRoot, value);
+}
+function canonicalizeWithExistingAncestor(inputPath) {
+    let cursor = resolve(inputPath);
+    const missingSegments = [];
+    while (!existsSync(cursor)) {
+        const parent = dirname(cursor);
+        if (parent === cursor)
+            return resolve(cursor, ...missingSegments);
+        missingSegments.unshift(basename(cursor));
+        cursor = parent;
+    }
+    const canonicalAncestor = realpathSync.native(cursor);
+    return resolve(canonicalAncestor, ...missingSegments);
+}
+function isContainedBy(root, target) {
+    const relativePath = relative(root, target);
+    return relativePath === ''
+        || (!isAbsolute(relativePath) && relativePath !== '..' && !relativePath.startsWith(`..${sep}`));
+}
+function hasDifferentFilesystemRoot(root, target) {
+    const rootVolume = parse(root).root;
+    const targetVolume = parse(target).root;
+    if (process.platform === 'win32') {
+        return rootVolume.toLowerCase() !== targetVolume.toLowerCase();
+    }
+    return rootVolume !== targetVolume;
+}
+export class CapabilityBoundary {
+    workspaceRoot;
+    profile;
+    constructor(workspacePath, profile = 'workspace-write') {
+        this.workspaceRoot = canonicalizeWithExistingAncestor(resolve(workspacePath));
+        this.profile = profile;
+    }
+    getProfile() {
+        return this.profile;
+    }
+    setProfile(profile) {
+        this.profile = profile;
+    }
+    resolvePath(inputPath, access = 'read') {
+        const resolvedPath = resolveInputPath(this.workspaceRoot, inputPath);
+        if (access === 'write' && this.profile === 'read-only') {
+            throw new CapabilityViolationError(this.profile, access, resolvedPath);
+        }
+        if (this.profile !== 'danger-full-access' && hasDifferentFilesystemRoot(this.workspaceRoot, resolvedPath)) {
+            throw new CapabilityViolationError(this.profile, access, resolvedPath);
+        }
+        const canonicalPath = canonicalizeWithExistingAncestor(resolvedPath);
+        if (this.profile !== 'danger-full-access' && !isContainedBy(this.workspaceRoot, canonicalPath)) {
+            throw new CapabilityViolationError(this.profile, access, canonicalPath);
+        }
+        return canonicalPath;
+    }
+    assertCommandAllowed() {
+        if (this.profile !== 'danger-full-access') {
+            throw new CapabilityViolationError(this.profile, 'command');
+        }
+    }
+}
+//# sourceMappingURL=capabilityBoundary.js.map

package/dist/core/runtime/capabilityBoundary.js.map

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

package/dist/core/runtime/nodeToolExecutor.d.ts

@@ -0,0 +1,200 @@
+import type { ToolExecutor, Result, SearchContentHit, SearchContentBatchRequest, SearchContentOptions, SearchFilesOptions, SearchContentPage, FileRangeResult, CommandOutput, RequestOptions, ListTreeOptions, WebSearchResult } from '../../tools/executor';
+import type { TreeNode } from '../../shared/types';
+import type { CodeMapNode, CodeSearchHit } from '../../shared/codeIndexTypes';
+import type { MemoryConfidence, MemoryKind, MemoryScope, MemorySnapshot } from '../../shared/memoryTypes';
+import type { TerminalSessionInfo, TerminalStartCommandResult } from '../../shared/terminalTypes';
+import type { CapabilityProfile } from '../../shared/agentTypes';
+import { RuntimeTaskManager } from './runtimeTaskManager';
+import { type FilesystemAccess } from './capabilityBoundary';
+export interface NodeToolExecutorOptions {
+    runtimeTaskManager?: RuntimeTaskManager;
+    ownerSessionId?: string;
+    capabilityProfile?: CapabilityProfile;
+}
+export declare class NodeToolExecutor implements ToolExecutor {
+    private workspacePath;
+    private memoryService;
+    private workspaceRoot;
+    private capabilityBoundary;
+    private backgroundTerminals;
+    private activeStreams;
+    private runtimeTaskManager;
+    constructor(workspacePath: string, options?: NodeToolExecutorOptions);
+    getRuntimeTaskManager(): RuntimeTaskManager;
+    getCapabilityProfile(): CapabilityProfile;
+    setCapabilityProfile(profile: CapabilityProfile): void;
+    private createRuntimeTaskLog;
+    readFile(path: string): Promise<Result<string>>;
+    readFileRange(path: string, offset?: number, limit?: number, maxBytes?: number): Promise<Result<FileRangeResult>>;
+    writeFile(path: string, content: string, metadata?: Record<string, unknown>): Promise<Result<void>>;
+    deleteFile(path: string, options?: {
+        recursive?: boolean;
+        expectedHash?: string;
+    }): Promise<Result<void>>;
+    moveFile(sourcePath: string, destinationPath: string, options?: {
+        expectedHash?: string;
+        expectedDestinationHash?: string;
+    }): Promise<Result<void>>;
+    listTree(path: string, options?: ListTreeOptions): Promise<Result<TreeNode>>;
+    searchFiles(pattern: string, basePath: string, options?: SearchFilesOptions): Promise<Result<{
+        matches: string[];
+        truncated?: boolean;
+        offset?: number;
+        limit?: number;
+    }>>;
+    searchContent(pattern: string, basePath: string, filePattern?: string, caseInsensitive?: boolean): Promise<Result<SearchContentHit[]>>;
+    searchContentBatch(requests: SearchContentBatchRequest[]): Promise<Array<Result<SearchContentPage>>>;
+    searchContentPage(pattern: string, basePath: string, filePattern?: string, caseInsensitive?: boolean, options?: SearchContentOptions): Promise<Result<SearchContentPage>>;
+    webSearch(query: {
+        query: string;
+        limit?: number;
+        region?: string;
+        freshness?: string;
+        domains?: string[];
+    }): Promise<Result<{
+        results: WebSearchResult[];
+        provider: string;
+        query: string;
+    }>>;
+    searchCodeSymbols(query: {
+        query: string;
+        workspacePath: string;
+        kind?: string;
+        limit?: number;
+        exact?: boolean;
+    }): Promise<Result<CodeSearchHit[]>>;
+    private inferSymbolKind;
+    private extractSymbolDeclaration;
+    private escapeRegex;
+    getCodeMap(query: {
+        workspacePath: string;
+        targetPaths?: string[];
+        path?: string;
+        query?: string;
+        depth?: number;
+        maxPaths?: number;
+        maxChildrenPerPath?: number;
+    }): Promise<Result<{
+        map: CodeMapNode[];
+        relatedPaths?: string[];
+        source?: 'filesystem';
+    }>>;
+    private resolveCodeMapTargets;
+    private buildCodeMapNode;
+    private extractExports;
+    memoryQuery(query: {
+        query?: string;
+        workspacePath: string;
+        kind?: MemoryKind;
+        scope?: MemoryScope;
+        limit?: number;
+    }): Promise<Result<{
+        items: Array<{
+            id: string;
+            text: string;
+            content: string;
+            kind: string;
+            confidence: string;
+            source: string;
+            tags: string[];
+            score: number;
+        }>;
+    }>>;
+    memoryRemember(data: {
+        content?: string;
+        text?: string;
+        kind?: MemoryKind;
+        scope?: MemoryScope;
+        tags?: string[];
+        confidence?: MemoryConfidence;
+        workspacePath: string;
+        conversationId?: string;
+        messageId?: string;
+    }): Promise<Result<{
+        id: string;
+        deduplicated?: boolean;
+    }>>;
+    memoryForget(data: {
+        id: string;
+        workspacePath: string;
+        reason?: string;
+    }): Promise<Result<void>>;
+    memoryList(workspacePath: string): Promise<Result<{
+        snapshot: MemorySnapshot;
+        items: Array<{
+            id: string;
+            content: string;
+            kind: string;
+        }>;
+    }>>;
+    memoryGetRelevantInjection(params: {
+        workspacePath: string;
+        query: string;
+    }): Promise<Result<{
+        text: string;
+        tokens: number;
+    }>>;
+    runCommand(command: string, cwd: string, env?: Record<string, string>, timeout?: number, approved?: boolean, signal?: AbortSignal): Promise<Result<CommandOutput>>;
+    private executeCommand;
+    readOnlyProcess(command: string, args: string[], cwd: string, env?: Record<string, string>, timeout?: number, signal?: AbortSignal): Promise<Result<CommandOutput>>;
+    runProcess(command: string, args: string[], cwd: string, env?: Record<string, string>, timeout?: number, signal?: AbortSignal, access?: FilesystemAccess): Promise<Result<CommandOutput>>;
+    private collectProcess;
+    private terminateProcessTree;
+    private stopProcessAndWait;
+    private finishProcessRuntimeTask;
+    validateCommand(command: string, cwd: string): Promise<Result<void>>;
+    private validateCommandSync;
+    startBackgroundCommand(command: string, cwd: string, env?: Record<string, string>, approved?: boolean): Promise<Result<TerminalStartCommandResult>>;
+    ptyCreate(options?: {
+        shell?: string;
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<Result<{
+        sessionId: string;
+        session: TerminalSessionInfo;
+    }>>;
+    private spawnTerminalSession;
+    ptyWrite(sessionId: string, data: string): Promise<Result<void>>;
+    ptyGetBuffer(sessionId: string, sinceSeq?: number): Promise<Result<string>>;
+    ptyInterruptCommand(sessionId: string): Promise<Result<void>>;
+    ptyKill(sessionId: string): Promise<Result<void>>;
+    ptyList(): Promise<Result<TerminalSessionInfo[]>>;
+    private readRecoveredTerminal;
+    private runtimeTaskToSession;
+    ptyKillAll(): Promise<Result<void>>;
+    private killTerminalProcessTree;
+    private waitForTerminalClose;
+    sendMessage(url: string, headers: Record<string, string>, body: string, options?: RequestOptions): Promise<Result<string>>;
+    streamMessage(url: string, headers: Record<string, string>, body: string, onLine: (line: string) => void, options?: RequestOptions): Promise<Result<string>>;
+    streamAbort(streamId: number): Promise<void>;
+    private createRequestController;
+    private isAbortError;
+    private searchDuckDuckGoInstant;
+    private searchDuckDuckGoHtml;
+    private searchBingHtml;
+    private fetchJsonWithTimeout;
+    private fetchTextWithTimeout;
+    private dedupeWebResults;
+    private normalizeDuckDuckGoUrl;
+    private normalizeBingUrl;
+    private decodeBingEncodedUrl;
+    private normalizeDomainFilter;
+    private freshnessToDuckDuckGoDf;
+    private freshnessToBingFilter;
+    private stripHtml;
+    private decodeHtml;
+    private cleanText;
+    private resolvePath;
+    private buildTree;
+    private globSync;
+    private searchContentFallback;
+    private searchCodeSymbolsFallback;
+    private walkDir;
+    private globToRegex;
+    private expandGlobBraces;
+    private shouldSkipEntry;
+    private buildChildEnvironment;
+    private delay;
+    private formatHttpError;
+    private formatNetworkError;
+}