@qduc/term2 0.7.2 → 0.8.0

package/dist/services/subagents/tool-policy.js

@@ -0,0 +1,426 @@
+import { randomUUID } from 'node:crypto';
+import path from 'node:path';
+import { tool as createTool } from '@openai/agents';
+import { getProvider } from '../../providers/index.js';
+import { wrapToolInvoke, wrapNeedsApproval } from '../../lib/tool-invoke.js';
+import { toOpenAIStrictToolSchema } from '../../lib/openai-strict-tool-schema.js';
+import { shouldUseStrictToolSchema, shouldPreferPatchEditingModel } from '../../lib/tool-selection-policy.js';
+import { createReadFileToolDefinition } from '../../tools/file/read-file.js';
+import { createGrepToolDefinition } from '../../tools/system/grep.js';
+import { createFindFilesToolDefinition } from '../../tools/file/find-files.js';
+import { createReadCodeOutlineToolDefinition, createCodeContextSearchToolDefinition, } from '../../tools/system/code-context.js';
+import { createWebSearchToolDefinition } from '../../tools/web/web-search.js';
+import { createWebFetchToolDefinition } from '../../tools/web/web-fetch.js';
+import { createApplyPatchToolDefinition } from '../../tools/file/apply-patch.js';
+import { createSearchReplaceToolDefinition } from '../../tools/file/search-replace.js';
+import { createCreateFileToolDefinition } from '../../tools/file/create-file.js';
+import { createShellToolDefinition } from '../../tools/system/shell.js';
+import { registerToolFormatters } from '../../tools/command-message-formatters.js';
+import { trimToolOutput } from '../../utils/output/trim-tool-output.js';
+import { injectTurnLimitWarning } from '../../utils/inject-warning-into-tool-output.js';
+import { tryAcquireFileLock } from '../../tools/file/file-locks.js';
+import { classifyCommand, SafetyStatus } from '../../utils/shell/command-safety/index.js';
+import { evaluateShellAutoApprovalAdvisories } from '../approval/shell-auto-approval-evaluator.js';
+export function getSubagentRunContext(context) {
+    const candidate = context?.context;
+    if (candidate &&
+        typeof candidate === 'object' &&
+        typeof candidate.agentId === 'string' &&
+        Array.isArray(candidate.filesChanged)) {
+        return candidate;
+    }
+    return undefined;
+}
+export function formatRunningCommandMessages(definition, params) {
+    const callId = `subagent-tool-${randomUUID()}`;
+    const item = {
+        id: callId,
+        rawItem: {
+            id: callId,
+            callId,
+            arguments: params,
+            output: '',
+        },
+    };
+    try {
+        const messages = definition.formatCommandMessage(item, 0, new Map());
+        if (messages.length > 0) {
+            return messages.map((message, index) => ({
+                ...message,
+                id: `${callId}-${index}`,
+                status: 'running',
+                output: '',
+                success: undefined,
+                failureReason: undefined,
+                toolName: message.toolName ?? definition.name,
+                toolArgs: message.toolArgs ?? params,
+            }));
+        }
+    }
+    catch {
+        // Fall back to the tool name if a formatter cannot handle an in-flight item.
+    }
+    return [
+        {
+            id: `${callId}-0`,
+            sender: 'command',
+            status: 'running',
+            command: definition.name,
+            output: '',
+            toolName: definition.name,
+            toolArgs: params,
+        },
+    ];
+}
+export class SubagentToolPolicy {
+    #settings;
+    #logger;
+    #sessionContextService;
+    #executionContext;
+    #agentClient;
+    constructor(deps) {
+        this.#settings = deps.settings;
+        this.#logger = deps.logger;
+        this.#sessionContextService = deps.sessionContextService;
+        this.#executionContext = deps.executionContext;
+        this.#agentClient = deps.agentClient;
+    }
+    isWithinWriteBoundary(filePath, cwd) {
+        const boundaries = [cwd];
+        const resolved = path.resolve(cwd, filePath);
+        return boundaries.some((boundary) => {
+            const resolvedBoundary = path.resolve(cwd, boundary);
+            return resolved === resolvedBoundary || resolved.startsWith(resolvedBoundary + path.sep);
+        });
+    }
+    tryAcquireWorkerWriteLocks(paths, cwd) {
+        const uniqueResolvedPaths = [...new Set(paths.map((filePath) => path.resolve(cwd, filePath)))];
+        const releases = [];
+        for (const resolvedPath of uniqueResolvedPaths) {
+            const release = tryAcquireFileLock(resolvedPath);
+            if (!release) {
+                for (const unlock of releases.reverse()) {
+                    unlock();
+                }
+                return null;
+            }
+            releases.push(release);
+        }
+        return () => {
+            for (const unlock of releases.reverse()) {
+                unlock();
+            }
+        };
+    }
+    extractPathsFromCommand(command, cwd) {
+        const paths = [];
+        try {
+            classifyCommand(command, this.#logger);
+            const tokens = command.match(/>\s*(\S+)|>>\s*(\S+)|tee\s+(\S+)/gi);
+            if (tokens) {
+                for (const token of tokens) {
+                    const match = token.match(/>+\s*(\S+)|tee\s+(\S+)/);
+                    if (match) {
+                        const p = match[1] ?? match[2];
+                        if (p) {
+                            const resolved = path.resolve(cwd, p);
+                            paths.push(resolved);
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Non-fatal
+        }
+        return [...new Set(paths)];
+    }
+    extractSuccessfulWritePaths(result) {
+        if (typeof result !== 'string')
+            return [];
+        // New plain-text outputs: "Created <path>", "Overwrote <path>", "Updated <path>", "Deleted <path>".
+        const successLines = result.split('\n').filter((line) => /^(Created|Overwrote|Updated|Deleted)\s+/.test(line));
+        if (successLines.length > 0) {
+            const paths = successLines.map((line) => line
+                .replace(/^(Created|Overwrote|Updated|Deleted)\s+/, '')
+                .replace(/\s*\(new file\)\s*$/, '')
+                .trim());
+            return paths.filter((p) => p.length > 0);
+        }
+        // Legacy JSON outputs (kept for backward compatibility with old sessions/tests).
+        try {
+            const parsed = JSON.parse(result);
+            if (Array.isArray(parsed?.output)) {
+                return parsed.output
+                    .filter((item) => item?.success === true && typeof item?.path === 'string')
+                    .map((item) => item.path);
+            }
+            if (parsed?.success === true && typeof parsed?.path === 'string') {
+                return [parsed.path];
+            }
+        }
+        catch {
+            // Ignore JSON parse errors.
+        }
+        return [];
+    }
+    async isYellowCommandApproved(command, taskContext) {
+        if (!this.#agentClient)
+            return false;
+        try {
+            const advisories = await evaluateShellAutoApprovalAdvisories({
+                commands: [{ id: '__subagent_worker_shell__', command }],
+                history: taskContext
+                    ? [{ type: 'message', role: 'user', content: [{ type: 'input_text', text: taskContext }] }]
+                    : [],
+                settingsService: this.#settings,
+                agentClient: this.#agentClient,
+                logger: this.#logger,
+                sessionContextService: this.#sessionContextService,
+            });
+            return advisories.get('__subagent_worker_shell__')?.approved === true;
+        }
+        catch (error) {
+            this.#logger.warn('Worker shell YELLOW auto-approval evaluation failed', {
+                error: error?.message || String(error),
+            });
+            return false;
+        }
+    }
+    wrapShellTool(definition, cwd, filesChanged, taskContext) {
+        const originalExecute = definition.execute.bind(definition);
+        return {
+            ...definition,
+            needsApproval: () => false,
+            execute: async (params, context, details) => {
+                const command = typeof params?.command === 'string' ? params.command : '';
+                if (!command) {
+                    return originalExecute(params, context, details);
+                }
+                const status = classifyCommand(command, this.#logger);
+                if (status === SafetyStatus.RED) {
+                    return `Error: command blocked for safety (${status}). Workers cannot run commands that require interactive approval. Command: ${command}`;
+                }
+                if (status === SafetyStatus.YELLOW) {
+                    const approved = await this.isYellowCommandApproved(command, taskContext);
+                    if (!approved) {
+                        return `Error: command blocked for safety (${status}). Workers cannot run commands that require interactive approval. Command: ${command}`;
+                    }
+                }
+                const extractedPaths = this.extractPathsFromCommand(command, cwd);
+                if (extractedPaths.length > 0) {
+                    for (const filePath of extractedPaths) {
+                        if (!this.isWithinWriteBoundary(filePath, cwd)) {
+                            return `Error: command blocked — target path "${filePath}" is outside the allowed write boundary. Command: ${command}`;
+                        }
+                    }
+                    const releaseWorkerLocks = this.tryAcquireWorkerWriteLocks(extractedPaths, cwd);
+                    if (!releaseWorkerLocks) {
+                        return 'Error: command blocked — one or more target files are already being modified by another worker.';
+                    }
+                    try {
+                        const result = await originalExecute(params, context, details);
+                        filesChanged.push(...extractedPaths);
+                        return result;
+                    }
+                    finally {
+                        releaseWorkerLocks();
+                    }
+                }
+                return originalExecute(params, context, details);
+            },
+        };
+    }
+    wrapNestedShellTool(definition, cwd) {
+        const originalExecute = definition.execute.bind(definition);
+        return {
+            ...definition,
+            execute: async (params, context, details) => {
+                const command = typeof params?.command === 'string' ? params.command : '';
+                const extractedPaths = command ? this.extractPathsFromCommand(command, cwd) : [];
+                for (const filePath of extractedPaths) {
+                    if (!this.isWithinWriteBoundary(filePath, cwd)) {
+                        return `Error: command blocked - target path "${filePath}" is outside the allowed write boundary. Command: ${command}`;
+                    }
+                }
+                const releaseWorkerLocks = extractedPaths.length > 0 ? this.tryAcquireWorkerWriteLocks(extractedPaths, cwd) : () => { };
+                if (!releaseWorkerLocks) {
+                    return 'Error: command blocked - one or more target files are already being modified by another worker.';
+                }
+                try {
+                    const result = await originalExecute(params, context, details);
+                    getSubagentRunContext(context)?.filesChanged.push(...extractedPaths);
+                    return result;
+                }
+                finally {
+                    releaseWorkerLocks();
+                }
+            },
+        };
+    }
+    wrapReadOnlyShellTool(definition) {
+        const originalExecute = definition.execute.bind(definition);
+        const cwd = this.#executionContext?.getCwd() ?? process.cwd();
+        return {
+            ...definition,
+            needsApproval: () => false,
+            execute: async (params, context, details) => {
+                const command = typeof params?.command === 'string' ? params.command : '';
+                if (!command) {
+                    return originalExecute(params, context, details);
+                }
+                const status = classifyCommand(command, this.#logger);
+                if (status !== SafetyStatus.GREEN) {
+                    return `Error: command blocked - explorer can only run read-only (GREEN) shell commands. Command: ${command}`;
+                }
+                const writeTargets = this.extractPathsFromCommand(command, cwd);
+                if (writeTargets.length > 0) {
+                    return `Error: command blocked - explorer can only run read-only (GREEN) shell commands. Command: ${command}`;
+                }
+                return originalExecute(params, context, details);
+            },
+        };
+    }
+    wrapWriteTool(definition, cwd, filesChanged, extractPaths, nestedApprovals = false) {
+        const originalExecute = definition.execute.bind(definition);
+        const originalNeedsApproval = definition.needsApproval.bind(definition);
+        return {
+            ...definition,
+            needsApproval: nestedApprovals
+                ? async (params, context) => {
+                    const paths = extractPaths(params);
+                    if (paths.some((filePath) => !this.isWithinWriteBoundary(filePath, cwd))) {
+                        return false;
+                    }
+                    return originalNeedsApproval(params, context);
+                }
+                : () => false,
+            execute: async (params, context, details) => {
+                const paths = extractPaths(params);
+                for (const filePath of paths) {
+                    if (!this.isWithinWriteBoundary(filePath, cwd)) {
+                        return `Error: Write rejected: path "${filePath}" is outside the allowed write boundary.`;
+                    }
+                }
+                const releaseWorkerLocks = this.tryAcquireWorkerWriteLocks(paths, cwd);
+                if (!releaseWorkerLocks) {
+                    return 'Error: Write rejected: one or more target files are already being modified by another worker.';
+                }
+                try {
+                    const result = await originalExecute(params, context, details);
+                    for (const successfulPath of this.extractSuccessfulWritePaths(result)) {
+                        if (nestedApprovals) {
+                            getSubagentRunContext(context)?.filesChanged.push(successfulPath);
+                        }
+                        else {
+                            filesChanged.push(successfulPath);
+                        }
+                    }
+                    return result;
+                }
+                finally {
+                    releaseWorkerLocks();
+                }
+            },
+        };
+    }
+}
+export class SubagentToolFactory {
+    #settings;
+    #logger;
+    #executionContext;
+    #toolPolicy;
+    constructor(deps) {
+        this.#settings = deps.settings;
+        this.#logger = deps.logger;
+        this.#executionContext = deps.executionContext;
+        this.#toolPolicy = deps.toolPolicy;
+    }
+    buildToolDefinitions(definition, filesChanged, taskContext, searchViaShell, nestedApprovals = false) {
+        const tools = [];
+        const cwd = this.#executionContext?.getCwd() ?? process.cwd();
+        const isRemote = this.#executionContext?.isRemote() ?? false;
+        if (definition.canRead) {
+            tools.push(createReadFileToolDefinition({ executionContext: this.#executionContext, allowOutsideWorkspace: false }));
+            if (!searchViaShell) {
+                tools.push(createGrepToolDefinition({ executionContext: this.#executionContext }), createFindFilesToolDefinition({ executionContext: this.#executionContext }));
+            }
+            if (!isRemote) {
+                tools.push(createReadCodeOutlineToolDefinition({ executionContext: this.#executionContext }), createCodeContextSearchToolDefinition({ executionContext: this.#executionContext }));
+            }
+        }
+        if (definition.canSearchWeb) {
+            tools.push(createWebSearchToolDefinition({ settingsService: this.#settings, loggingService: this.#logger }), createWebFetchToolDefinition({ settingsService: this.#settings, loggingService: this.#logger }));
+        }
+        if (definition.canRunShell) {
+            const shellDef = createShellToolDefinition({
+                settingsService: this.#settings,
+                loggingService: this.#logger,
+                executionContext: this.#executionContext,
+            });
+            if (definition.canWrite) {
+                tools.push(nestedApprovals
+                    ? this.#toolPolicy.wrapNestedShellTool(shellDef, cwd)
+                    : this.#toolPolicy.wrapShellTool(shellDef, cwd, filesChanged, taskContext));
+            }
+            else {
+                tools.push(this.#toolPolicy.wrapReadOnlyShellTool(shellDef));
+            }
+        }
+        if (definition.canWrite) {
+            const isGpt5 = shouldPreferPatchEditingModel(definition.model);
+            if (isGpt5) {
+                tools.push(this.#toolPolicy.wrapWriteTool(createApplyPatchToolDefinition({
+                    settingsService: this.#settings,
+                    loggingService: this.#logger,
+                    executionContext: this.#executionContext,
+                }), cwd, filesChanged, (params) => {
+                    if (Array.isArray(params?.operations)) {
+                        return params.operations.map((op) => op?.path).filter(Boolean);
+                    }
+                    return params?.path ? [params.path] : [];
+                }, nestedApprovals));
+            }
+            else {
+                tools.push(this.#toolPolicy.wrapWriteTool(createSearchReplaceToolDefinition({
+                    settingsService: this.#settings,
+                    loggingService: this.#logger,
+                    executionContext: this.#executionContext,
+                }), cwd, filesChanged, (params) => (params?.path ? [params.path] : []), nestedApprovals), this.#toolPolicy.wrapWriteTool(createCreateFileToolDefinition({
+                    settingsService: this.#settings,
+                    loggingService: this.#logger,
+                    executionContext: this.#executionContext,
+                }), cwd, filesChanged, (params) => (params?.path ? [params.path] : []), nestedApprovals));
+            }
+        }
+        registerToolFormatters(tools);
+        return tools;
+    }
+    buildAgentTools(toolDefinitions, options) {
+        const providerDef = getProvider(options.providerId);
+        const capabilities = {
+            supportsConversationChaining: providerDef?.capabilities?.supportsConversationChaining ?? false,
+            supportsTracingControl: providerDef?.capabilities?.supportsTracingControl ?? false,
+            usesStrictToolSchema: providerDef?.capabilities?.usesStrictToolSchema,
+        };
+        const useStrictSchema = shouldUseStrictToolSchema({
+            providerId: options.providerId,
+            capabilities,
+        });
+        return toolDefinitions.map((definition) => wrapToolInvoke(createTool({
+            name: definition.name,
+            description: definition.description,
+            parameters: useStrictSchema ? toOpenAIStrictToolSchema(definition.parameters) : definition.parameters,
+            needsApproval: wrapNeedsApproval(definition),
+            execute: async (params, _context, details) => {
+                options.onToolStart?.(definition.name, params, formatRunningCommandMessages(definition, params), _context, details);
+                const maxOutputLength = this.#settings.get('shell.maxOutputChars');
+                const result = await definition.execute(params, _context, details);
+                options.onToolComplete?.(definition.name, result, _context, details);
+                const trimmedResult = trimToolOutput(result, undefined, maxOutputLength ?? undefined);
+                return injectTurnLimitWarning(trimmedResult, _context?.context);
+            },
+        }), definition.parameters, { argumentParsing: definition.argumentParsing }));
+    }
+}
+//# sourceMappingURL=tool-policy.js.map

package/dist/services/subagents/tool-policy.js.map

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

package/dist/services/subagents/types.d.ts

@@ -1,5 +1,7 @@
-import type { NormalizedUsage } from '../../utils/token-usage.js';
-export type SubagentRole = 'explorer' | 'worker' | 'researcher' | 'mentor' | string;
+import type { NormalizedUsage } from '../../utils/ai/token-usage.js';
+export declare const SUBAGENT_ROLES: readonly ["explorer", "worker", "researcher", "mentor"];
+export type SupportedSubagentRole = (typeof SUBAGENT_ROLES)[number];
+export type SubagentRole = SupportedSubagentRole | string;
 export interface SubagentRequest {
     role: SubagentRole;
     task: string;

package/dist/services/subagents/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../source/services/subagents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../source/services/subagents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,eAAO,MAAM,cAAc,yDAA0D,CAAC;AACtF,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG,qBAAqB,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/services/subagents/types.js

@@ -1,2 +1,2 @@
-export {};
+export const SUBAGENT_ROLES = ['explorer', 'worker', 'researcher', 'mentor'];
 //# sourceMappingURL=types.js.map

package/dist/services/subagents/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../source/services/subagents/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../source/services/subagents/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC"}

package/dist/services/subagents/utils.d.ts

@@ -0,0 +1,26 @@
+export declare function isAbortLike(message: string | undefined, obj?: unknown): boolean;
+export declare function isToolHistoryItem(raw: any): boolean;
+export declare function assistantText(raw: any): string | null;
+export declare function extractFinalText(result: any): string;
+export declare function runWithProvider(providerId: string, runner: any, agent: any, input: any, options: any): Promise<any>;
+export declare function aggregateToolUsage(toolCounts: Map<string, number>): Array<{
+    toolName: string;
+    count: number;
+}>;
+export declare function aggregateContextToolUsage(toolCounts: Record<string, number>): Array<{
+    toolName: string;
+    count: number;
+}>;
+export declare function safeEmit(logger: any, onEvent: any, event: any): void;
+/**
+ * Combines multiple abort signals into one signal that aborts when any source
+ * aborts. Returns undefined when no signals are provided. When only one signal
+ * is provided it is returned directly. The returned cleanup function removes
+ * any listeners that were added to the source signals.
+ */
+export declare function createCompositeAbortSignal(...signals: (AbortSignal | undefined | null)[]): {
+    signal: AbortSignal;
+    cleanup: () => void;
+} | undefined;
+export declare function createAbortError(message?: string): Error;
+//# sourceMappingURL=utils.d.ts.map

package/dist/services/subagents/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../source/services/subagents/utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAK/E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAInD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAWrD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CA2BpD;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAiBnH;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAE9G;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAE5C;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAMpE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,OAAO,EAAE,CAAC,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,GAC7C;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,GAAG,SAAS,CAqC1D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,SAAkC,GAAG,KAAK,CAIjF"}

package/dist/services/subagents/utils.js

@@ -0,0 +1,128 @@
+import { run } from '@openai/agents';
+import { getProvider } from '../../providers/index.js';
+export function isAbortLike(message, obj) {
+    if (message?.includes('abort') || message?.includes('cancel'))
+        return true;
+    const o = obj;
+    if (o && (o['name'] === 'AbortError' || o['code'] === 'ERR_ABORTED' || o['kind'] === 'aborted'))
+        return true;
+    return false;
+}
+export function isToolHistoryItem(raw) {
+    const type = typeof raw?.type === 'string' ? raw.type : '';
+    if (raw?.role === 'tool')
+        return true;
+    return /tool|function_call/i.test(type);
+}
+export function assistantText(raw) {
+    if (raw?.role !== 'assistant')
+        return null;
+    const content = raw?.content;
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .filter((c) => typeof c?.text === 'string')
+            .map((c) => c.text)
+            .join('');
+    }
+    return null;
+}
+export function extractFinalText(result) {
+    if (!result?.interruptions?.length && typeof result.finalOutput === 'string' && result.finalOutput) {
+        return result.finalOutput;
+    }
+    if (Array.isArray(result.history)) {
+        const history = result.history;
+        let lastToolIndex = -1;
+        for (let i = history.length - 1; i >= 0; i--) {
+            if (isToolHistoryItem(history[i]?.rawItem ?? history[i])) {
+                lastToolIndex = i;
+                break;
+            }
+        }
+        for (let i = history.length - 1; i > lastToolIndex; i--) {
+            const text = assistantText(history[i]?.rawItem ?? history[i]);
+            if (text !== null)
+                return text;
+        }
+        for (let i = history.length - 1; i >= 0; i--) {
+            const text = assistantText(history[i]?.rawItem ?? history[i]);
+            if (text !== null)
+                return text;
+        }
+    }
+    return '';
+}
+export function runWithProvider(providerId, runner, agent, input, options) {
+    const providerDef = getProvider(providerId);
+    const supportsTracingControl = providerDef?.capabilities?.supportsTracingControl ?? false;
+    const effectiveOptions = { ...options };
+    if (!supportsTracingControl) {
+        effectiveOptions.tracingDisabled = true;
+    }
+    if (!runner && providerId !== 'openai') {
+        const label = providerDef?.label || providerId;
+        throw new Error(`${label} is configured but could not be initialized. ` +
+            `Please check that all required credentials and provider settings are set.`);
+    }
+    return runner ? runner.run(agent, input, effectiveOptions) : run(agent, input, effectiveOptions);
+}
+export function aggregateToolUsage(toolCounts) {
+    return Array.from(toolCounts.entries()).map(([toolName, count]) => ({ toolName, count }));
+}
+export function aggregateContextToolUsage(toolCounts) {
+    return Object.entries(toolCounts).map(([toolName, count]) => ({ toolName, count }));
+}
+export function safeEmit(logger, onEvent, event) {
+    try {
+        onEvent?.(event);
+    }
+    catch (error) {
+        logger.debug('Subagent event emit failed', { error: error?.message });
+    }
+}
+/**
+ * Combines multiple abort signals into one signal that aborts when any source
+ * aborts. Returns undefined when no signals are provided. When only one signal
+ * is provided it is returned directly. The returned cleanup function removes
+ * any listeners that were added to the source signals.
+ */
+export function createCompositeAbortSignal(...signals) {
+    const validSignals = signals.filter((signal) => signal != null);
+    if (validSignals.length === 0) {
+        return undefined;
+    }
+    const anyAborted = validSignals.some((signal) => signal.aborted);
+    if (anyAborted) {
+        const controller = new AbortController();
+        controller.abort();
+        return { signal: controller.signal, cleanup: () => { } };
+    }
+    if (validSignals.length === 1) {
+        return { signal: validSignals[0], cleanup: () => { } };
+    }
+    const controller = new AbortController();
+    const listeners = new Map();
+    const cleanup = () => {
+        for (const [signal, listener] of listeners) {
+            signal.removeEventListener('abort', listener);
+        }
+        listeners.clear();
+    };
+    for (const signal of validSignals) {
+        const listener = () => {
+            controller.abort();
+            cleanup();
+        };
+        signal.addEventListener('abort', listener, { once: true });
+        listeners.set(signal, listener);
+    }
+    return { signal: controller.signal, cleanup };
+}
+export function createAbortError(message = 'The subagent run was aborted.') {
+    const error = new Error(message);
+    error.name = 'AbortError';
+    return error;
+}
+//# sourceMappingURL=utils.js.map