@qduc/term2 0.7.3 → 0.9.0

package/dist/lib/agent-factory.d.ts

@@ -0,0 +1,34 @@
+import { Agent } from '@openai/agents';
+import { type ModelSettingsReasoningEffort } from '@openai/agents-core/model';
+import { createEditorImpl } from './editor-impl.js';
+import type { ILoggingService, ISettingsService } from '../services/service-interfaces.js';
+import { ExecutionContext } from '../services/execution-context.js';
+import { SkillsService } from '../services/skills/skills-service.js';
+export interface AgentFactoryDeps {
+    settings: ISettingsService;
+    logger: ILoggingService;
+    executionContext?: ExecutionContext;
+    editor: ReturnType<typeof createEditorImpl>;
+    providerId: string;
+    serviceTierOverrideForNextRequest: 'standard' | null;
+    createMentor: (task: string) => Promise<string>;
+    runSubagent: (params: {
+        role: string;
+        task: string;
+    }) => Promise<{
+        finalText: string;
+    }>;
+    getAskUserAnswer: (callId?: string) => string | undefined;
+    checkToolInterceptors: (name: string, params: unknown, toolCallId?: string) => Promise<string | null>;
+    skillsService?: SkillsService;
+}
+export interface AgentBuildResult {
+    agent: Agent;
+    resolvedModel: string;
+}
+export declare function buildAgent({ model, reasoningEffort, temperature, }: {
+    model?: string;
+    reasoningEffort?: ModelSettingsReasoningEffort | 'default';
+    temperature?: number;
+}, deps: AgentFactoryDeps): AgentBuildResult;
+//# sourceMappingURL=agent-factory.d.ts.map

package/dist/lib/agent-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-factory.d.ts","sourceRoot":"","sources":["../../source/lib/agent-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAiD,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAG9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAUrE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC,EAAE,UAAU,GAAG,IAAI,CAAC;IACrD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,WAAW,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxF,gBAAgB,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1D,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtG,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAwND,wBAAgB,UAAU,CACxB,EACE,KAAK,EACL,eAAe,EACf,WAAW,GACZ,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,4BAA4B,GAAG,SAAS,CAAC;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,IAAI,EAAE,gBAAgB,GACrB,gBAAgB,CAwElB"}

package/dist/lib/agent-factory.js

@@ -0,0 +1,240 @@
+import path from 'path';
+import { Agent, tool as createTool, applyPatchTool } from '@openai/agents';
+import { getAgentDefinition } from '../agent.js';
+import { getProvider } from '../providers/index.js';
+import { normalizeToolInput, toolErrorFunction, wrapNeedsApproval, wrapToolInvoke } from './tool-invoke.js';
+import { trimToolOutput } from '../utils/output/trim-tool-output.js';
+import { injectTurnLimitWarning } from '../utils/inject-warning-into-tool-output.js';
+import { toOpenAIStrictToolSchema } from './openai-strict-tool-schema.js';
+import { shouldUseNativePatchTool as shouldUseNativePatchToolPolicy, shouldUseStrictToolSchema, } from './tool-selection-policy.js';
+import { getModelDefaultReasoningLevel } from '../services/model-service.js';
+import { toolApprovalPolicyRegistry } from '../services/approval/tool-approval-policy-registry.js';
+function getProviderCapabilities(providerId) {
+    const providerDef = getProvider(providerId);
+    return {
+        supportsConversationChaining: providerDef?.capabilities?.supportsConversationChaining ?? false,
+        supportsTracingControl: providerDef?.capabilities?.supportsTracingControl ?? false,
+        supportsPromptCacheKey: providerDef?.capabilities?.supportsPromptCacheKey,
+        usesStrictToolSchema: providerDef?.capabilities?.usesStrictToolSchema,
+        nativePatchModelPrefixes: providerDef?.capabilities?.nativePatchModelPrefixes,
+    };
+}
+function buildAgentTools({ toolDefinitions, resolvedModel, shouldUseNativePatchTool, deps, }) {
+    const providerCapabilities = getProviderCapabilities(deps.providerId);
+    const useStrictToolSchema = shouldUseStrictToolSchema({
+        providerId: deps.providerId,
+        capabilities: providerCapabilities,
+    });
+    const tools = toolDefinitions
+        .filter((definition) => {
+        // Exclude custom apply_patch if we're using native one
+        if (shouldUseNativePatchTool && definition.name === 'apply_patch') {
+            return false;
+        }
+        return true;
+    })
+        .map((definition) => wrapToolInvoke(createTool({
+        name: definition.name,
+        description: definition.description,
+        parameters: useStrictToolSchema ? toOpenAIStrictToolSchema(definition.parameters) : definition.parameters,
+        // Let schema-validation errors propagate to wrapToolInvoke for Zod
+        // diagnostics; keep other runtime errors as non-fatal strings.
+        errorFunction: toolErrorFunction,
+        needsApproval: wrapNeedsApproval(definition, {
+            checkInterceptors: (params) => deps.checkToolInterceptors(definition.name, params),
+            toolName: definition.name,
+            registry: toolApprovalPolicyRegistry,
+        }),
+        execute: async (params, _context, details) => {
+            const maxOutputLengthValue = deps.settings.get('shell.maxOutputChars');
+            // Extract tool call ID from details if available
+            const toolCallId = details?.toolCall?.callId;
+            // Check if this execution should be intercepted
+            const rejectionMessage = await deps.checkToolInterceptors(definition.name, params, toolCallId);
+            if (rejectionMessage) {
+                deps.logger.debug('Tool execution intercepted', {
+                    tool: definition.name,
+                    params: JSON.stringify(params).substring(0, 100),
+                });
+                // Return a failure response that all tools should understand
+                const rejected = JSON.stringify({
+                    output: [
+                        {
+                            success: false,
+                            error: rejectionMessage,
+                        },
+                    ],
+                });
+                return trimToolOutput(rejected, undefined, maxOutputLengthValue ?? undefined);
+            }
+            const result = await definition.execute(params, _context, details);
+            const trimmedResult = trimToolOutput(result, undefined, maxOutputLengthValue ?? undefined);
+            return injectTurnLimitWarning(trimmedResult, _context?.context);
+        },
+    }), definition.parameters, { argumentParsing: definition.argumentParsing }));
+    // Add native applyPatchTool for gpt-5.1 on OpenAI provider
+    if (shouldUseNativePatchTool) {
+        const nativePatchTool = applyPatchTool({
+            editor: deps.editor,
+            // Require approval for any path that escapes the workspace. Mirrors the
+            // boundary check in `editor-impl.resolveWorkspacePath` so the SDK pauses
+            // for user input before the editor's `createFile` / `updateFile` /
+            // `deleteFile` is invoked. The user-approved path is later permitted
+            // by the editor's `allowOutsideWorkspace` plumbing if/when added.
+            needsApproval: async (_runContext, operation) => {
+                const cwd = deps.executionContext?.getCwd() || process.cwd();
+                const workspaceRoot = path.resolve(cwd);
+                const resolved = path.resolve(workspaceRoot, operation.path);
+                const rootPrefix = workspaceRoot.endsWith(path.sep) ? workspaceRoot : workspaceRoot + path.sep;
+                const isInside = resolved === workspaceRoot || resolved.startsWith(rootPrefix);
+                return !isInside;
+            },
+        }); // Type assertion needed as invoke is not in public API
+        // Wrap the native tool's invoke function to apply interceptor check
+        const originalInvoke = nativePatchTool.invoke;
+        if (originalInvoke) {
+            nativePatchTool.invoke = async (runContext, input, details) => {
+                // Extract tool call ID from details if available
+                const toolCallId = details?.toolCall?.callId;
+                // Parse input to get params for logging
+                const normalizedInput = normalizeToolInput(input);
+                let params;
+                try {
+                    params = typeof input === 'string' ? JSON.parse(input) : input;
+                }
+                catch {
+                    params = input;
+                }
+                const rejectionMessage = await deps.checkToolInterceptors('apply_patch', params, toolCallId);
+                if (rejectionMessage) {
+                    deps.logger.debug('Native tool execution intercepted', {
+                        tool: 'apply_patch',
+                        toolCallId,
+                        params: JSON.stringify(params).substring(0, 100),
+                    });
+                    const rejected = JSON.stringify({
+                        output: [
+                            {
+                                success: false,
+                                error: rejectionMessage,
+                            },
+                        ],
+                    });
+                    const maxOutputLengthValue = deps.settings.get('shell.maxOutputChars');
+                    return trimToolOutput(rejected, undefined, maxOutputLengthValue ?? undefined);
+                }
+                const maxOutputLengthValue = deps.settings.get('shell.maxOutputChars');
+                const result = await originalInvoke.call(nativePatchTool, runContext, normalizedInput, details);
+                const trimmedResult = trimToolOutput(result, undefined, maxOutputLengthValue ?? undefined);
+                return injectTurnLimitWarning(trimmedResult, runContext?.context);
+            };
+        }
+        tools.push(nativePatchTool);
+        deps.logger.debug('Using native applyPatchTool from SDK', {
+            model: resolvedModel,
+            provider: deps.providerId,
+        });
+    }
+    else {
+        deps.logger.debug('Using custom apply_patch implementation', {
+            model: resolvedModel,
+            provider: deps.providerId,
+        });
+    }
+    return tools;
+}
+function buildModelSettings({ reasoningEffort, resolvedTemperature, deps, }) {
+    // Build modelSettings only if an explicit effort value (other than
+    // 'default') was provided. 'default' means we should not pass the
+    // effort param and allow the underlying API to choose the default.
+    const modelSettings = {
+        retry: { maxRetries: deps.settings.get('agent.retryAttempts') ?? 2 },
+    };
+    if (reasoningEffort && reasoningEffort !== 'default') {
+        modelSettings.reasoning = {
+            effort: reasoningEffort,
+            summary: 'auto',
+        };
+    }
+    // Temperature: only pass when explicitly set (number). Undefined means
+    // provider/model default.
+    if (typeof resolvedTemperature === 'number' && Number.isFinite(resolvedTemperature)) {
+        modelSettings.temperature = resolvedTemperature;
+    }
+    // OpenAI Flex Service Tier: only pass when enabled and using OpenAI provider
+    // This reduces costs by using the flex service tier for lower priority requests
+    // See: https://platform.openai.com/docs/guides/service-tier
+    const useFlexServiceTier = deps.settings.get('agent.useFlexServiceTier');
+    if (useFlexServiceTier &&
+        deps.serviceTierOverrideForNextRequest !== 'standard' &&
+        (deps.providerId === 'openai' || deps.providerId === 'openrouter')) {
+        modelSettings.providerData = {
+            ...(modelSettings.providerData || {}),
+            service_tier: 'flex',
+        };
+    }
+    if (deps.providerId === 'codex') {
+        modelSettings.store = false;
+        modelSettings.include = ['reasoning.encrypted_content'];
+    }
+    return modelSettings;
+}
+export function buildAgent({ model, reasoningEffort, temperature, }, deps) {
+    const resolvedModel = model?.trim() || deps.settings.get('agent.model');
+    const resolvedTemperature = temperature ?? deps.settings.get('agent.temperature');
+    const { name, instructions, tools: toolDefinitions, } = getAgentDefinition({
+        settingsService: deps.settings,
+        loggingService: deps.logger,
+        executionContext: deps.executionContext,
+        askMentor: deps.createMentor,
+        runSubagent: deps.runSubagent,
+        getAskUserAnswer: deps.getAskUserAnswer,
+        skillsService: deps.skillsService,
+    }, resolvedModel);
+    const providerCapabilities = getProviderCapabilities(deps.providerId);
+    const shouldUseNativePatchToolForModel = shouldUseNativePatchToolPolicy({
+        providerId: deps.providerId,
+        model: resolvedModel,
+        capabilities: providerCapabilities,
+    });
+    const tools = buildAgentTools({
+        toolDefinitions,
+        resolvedModel,
+        shouldUseNativePatchTool: shouldUseNativePatchToolForModel,
+        deps,
+    });
+    let effectiveReasoningEffort = reasoningEffort;
+    const isDefaultSetting = deps.settings.get('agent.reasoningEffort') === 'default';
+    if (deps.providerId === 'codex' &&
+        isDefaultSetting &&
+        (!effectiveReasoningEffort || effectiveReasoningEffort === 'default')) {
+        const defaultReasoningLevel = getModelDefaultReasoningLevel('codex', resolvedModel);
+        if (defaultReasoningLevel) {
+            effectiveReasoningEffort = defaultReasoningLevel;
+        }
+    }
+    const modelSettings = buildModelSettings({
+        reasoningEffort: effectiveReasoningEffort,
+        resolvedTemperature,
+        deps,
+    });
+    const agent = new Agent({
+        name,
+        model: resolvedModel,
+        ...(Object.keys(modelSettings).length > 0 ? { modelSettings } : {}),
+        instructions,
+        tools,
+    });
+    // Only add defaultRunOptions if an explicit effort is set (not
+    // 'default'). This ensures the API receives the param only when
+    // intended.
+    if (effectiveReasoningEffort && effectiveReasoningEffort !== 'default') {
+        agent.defaultRunOptions = {
+            ...(agent.defaultRunOptions || {}),
+            // Pass through to underlying client for models that support it
+            reasoning: { effort: effectiveReasoningEffort },
+        };
+    }
+    return { agent, resolvedModel };
+}
+//# sourceMappingURL=agent-factory.js.map

package/dist/lib/agent-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-factory.js","sourceRoot":"","sources":["../../source/lib/agent-factory.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,cAAc,EAAa,MAAM,gBAAgB,CAAC;AAEtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG5G,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EACL,wBAAwB,IAAI,8BAA8B,EAC1D,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,uDAAuD,CAAC;AA6BnG,SAAS,uBAAuB,CAAC,UAAkB;IACjD,MAAM,WAAW,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO;QACL,4BAA4B,EAAE,WAAW,EAAE,YAAY,EAAE,4BAA4B,IAAI,KAAK;QAC9F,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,sBAAsB,IAAI,KAAK;QAClF,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,sBAAsB;QACzE,oBAAoB,EAAE,WAAW,EAAE,YAAY,EAAE,oBAAoB;QACrE,wBAAwB,EAAE,WAAW,EAAE,YAAY,EAAE,wBAAwB;KAC9E,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,EACvB,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,IAAI,GAML;IACC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtE,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;QACpD,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,YAAY,EAAE,oBAAoB;KACnC,CAAC,CAAC;IACH,MAAM,KAAK,GAAW,eAAe;SAClC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE;QACrB,uDAAuD;QACvD,IAAI,wBAAwB,IAAI,UAAU,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAClE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAClB,cAAc,CACZ,UAAU,CAAC;QACT,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,wBAAwB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU;QACzG,mEAAmE;QACnE,+DAA+D;QAC/D,aAAa,EAAE,iBAAiB;QAChC,aAAa,EAAE,iBAAiB,CAAC,UAAU,EAAE;YAC3C,iBAAiB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC;YAClF,QAAQ,EAAE,UAAU,CAAC,IAAI;YACzB,QAAQ,EAAE,0BAA0B;SACrC,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;YAC3C,MAAM,oBAAoB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAqB,sBAAsB,CAAC,CAAC;YAC3F,iDAAiD;YACjD,MAAM,UAAU,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;YAC7C,gDAAgD;YAChD,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;YAC/F,IAAI,gBAAgB,EAAE,CAAC;gBACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE;oBAC9C,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;iBACjD,CAAC,CAAC;gBACH,6DAA6D;gBAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;oBAC9B,MAAM,EAAE;wBACN;4BACE,OAAO,EAAE,KAAK;4BACd,KAAK,EAAE,gBAAgB;yBACxB;qBACF;iBACF,CAAC,CAAC;gBACH,OAAO,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,oBAAoB,IAAI,SAAS,CAAC,CAAC;YAChF,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnE,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,oBAAoB,IAAI,SAAS,CAAC,CAAC;YAC3F,OAAO,sBAAsB,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClE,CAAC;KACF,CAAC,EACF,UAAU,CAAC,UAAU,EACrB,EAAE,eAAe,EAAE,UAAU,CAAC,eAAe,EAAE,CAChD,CACF,CAAC;IAEJ,2DAA2D;IAC3D,IAAI,wBAAwB,EAAE,CAAC;QAC7B,MAAM,eAAe,GAAG,cAAc,CAAC;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,wEAAwE;YACxE,yEAAyE;YACzE,mEAAmE;YACnE,qEAAqE;YACrE,kEAAkE;YAClE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE;gBAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC7D,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC;gBAC/F,MAAM,QAAQ,GAAG,QAAQ,KAAK,aAAa,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBAC/E,OAAO,CAAC,QAAQ,CAAC;YACnB,CAAC;SACF,CAAQ,CAAC,CAAC,uDAAuD;QAElE,oEAAoE;QACpE,MAAM,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC;QAC9C,IAAI,cAAc,EAAE,CAAC;YACnB,eAAe,CAAC,MAAM,GAAG,KAAK,EAAE,UAAe,EAAE,KAAU,EAAE,OAAY,EAAE,EAAE;gBAC3E,iDAAiD;gBACjD,MAAM,UAAU,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;gBAC7C,wCAAwC;gBACxC,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBAClD,IAAI,MAAW,CAAC;gBAChB,IAAI,CAAC;oBACH,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBACjE,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,GAAG,KAAK,CAAC;gBACjB,CAAC;gBACD,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;gBAC7F,IAAI,gBAAgB,EAAE,CAAC;oBACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE;wBACrD,IAAI,EAAE,aAAa;wBACnB,UAAU;wBACV,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;qBACjD,CAAC,CAAC;oBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;wBAC9B,MAAM,EAAE;4BACN;gCACE,OAAO,EAAE,KAAK;gCACd,KAAK,EAAE,gBAAgB;6BACxB;yBACF;qBACF,CAAC,CAAC;oBACH,MAAM,oBAAoB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAqB,sBAAsB,CAAC,CAAC;oBAC3F,OAAO,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,oBAAoB,IAAI,SAAS,CAAC,CAAC;gBAChF,CAAC;gBACD,MAAM,oBAAoB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAqB,sBAAsB,CAAC,CAAC;gBAC3F,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;gBAChG,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,oBAAoB,IAAI,SAAS,CAAC,CAAC;gBAC3F,OAAO,sBAAsB,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YACpE,CAAC,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE;YACxD,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE,IAAI,CAAC,UAAU;SAC1B,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE;YAC3D,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE,IAAI,CAAC,UAAU;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,EAC1B,eAAe,EACf,mBAAmB,EACnB,IAAI,GAKL;IACC,mEAAmE;IACnE,kEAAkE;IAClE,mEAAmE;IACnE,MAAM,aAAa,GAAwB;QACzC,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAS,qBAAqB,CAAC,IAAI,CAAC,EAAE;KAC7E,CAAC;IACF,IAAI,eAAe,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QACrD,aAAa,CAAC,SAAS,GAAG;YACxB,MAAM,EAAE,eAAe;YACvB,OAAO,EAAE,MAAM;SAChB,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,0BAA0B;IAC1B,IAAI,OAAO,mBAAmB,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACpF,aAAa,CAAC,WAAW,GAAG,mBAAmB,CAAC;IAClD,CAAC;IAED,6EAA6E;IAC7E,gFAAgF;IAChF,4DAA4D;IAC5D,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAU,0BAA0B,CAAC,CAAC;IAClF,IACE,kBAAkB;QAClB,IAAI,CAAC,iCAAiC,KAAK,UAAU;QACrD,CAAC,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,YAAY,CAAC,EAClE,CAAC;QACD,aAAa,CAAC,YAAY,GAAG;YAC3B,GAAG,CAAC,aAAa,CAAC,YAAY,IAAI,EAAE,CAAC;YACrC,YAAY,EAAE,MAAM;SACrB,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;QAChC,aAAa,CAAC,KAAK,GAAG,KAAK,CAAC;QAC5B,aAAa,CAAC,OAAO,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,EACE,KAAK,EACL,eAAe,EACf,WAAW,GAKZ,EACD,IAAsB;IAEtB,MAAM,aAAa,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAS,aAAa,CAAC,CAAC;IAChF,MAAM,mBAAmB,GAAG,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAqB,mBAAmB,CAAC,CAAC;IACtG,MAAM,EACJ,IAAI,EACJ,YAAY,EACZ,KAAK,EAAE,eAAe,GACvB,GAAG,kBAAkB,CACpB;QACE,eAAe,EAAE,IAAI,CAAC,QAAQ;QAC9B,cAAc,EAAE,IAAI,CAAC,MAAM;QAC3B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,SAAS,EAAE,IAAI,CAAC,YAAY;QAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,EACD,aAAa,CACd,CAAC;IAEF,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtE,MAAM,gCAAgC,GAAG,8BAA8B,CAAC;QACtE,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,aAAa;QACpB,YAAY,EAAE,oBAAoB;KACnC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,eAAe,CAAC;QAC5B,eAAe;QACf,aAAa;QACb,wBAAwB,EAAE,gCAAgC;QAC1D,IAAI;KACL,CAAC,CAAC;IAEH,IAAI,wBAAwB,GAAG,eAAe,CAAC;IAC/C,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAS,uBAAuB,CAAC,KAAK,SAAS,CAAC;IAC1F,IACE,IAAI,CAAC,UAAU,KAAK,OAAO;QAC3B,gBAAgB;QAChB,CAAC,CAAC,wBAAwB,IAAI,wBAAwB,KAAK,SAAS,CAAC,EACrE,CAAC;QACD,MAAM,qBAAqB,GAAG,6BAA6B,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACpF,IAAI,qBAAqB,EAAE,CAAC;YAC1B,wBAAwB,GAAG,qBAAqD,CAAC;QACnF,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,kBAAkB,CAAC;QACvC,eAAe,EAAE,wBAAwB;QACzC,mBAAmB;QACnB,IAAI;KACL,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,IAAI;QACJ,KAAK,EAAE,aAAa;QACpB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,YAAY;QACZ,KAAK;KACN,CAAC,CAAC;IAEH,+DAA+D;IAC/D,gEAAgE;IAChE,YAAY;IACZ,IAAI,wBAAwB,IAAI,wBAAwB,KAAK,SAAS,EAAE,CAAC;QACtE,KAAa,CAAC,iBAAiB,GAAG;YACjC,GAAG,CAAE,KAAa,CAAC,iBAAiB,IAAI,EAAE,CAAC;YAC3C,+DAA+D;YAC/D,SAAS,EAAE,EAAE,MAAM,EAAE,wBAAwB,EAAE;SAChD,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;AAClC,CAAC"}

package/dist/lib/agent-factory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-factory.test.d.ts.map

package/dist/lib/agent-factory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-factory.test.d.ts","sourceRoot":"","sources":["../../source/lib/agent-factory.test.ts"],"names":[],"mappings":""}

package/dist/lib/agent-factory.test.js

@@ -0,0 +1,175 @@
+import { it, expect } from 'vitest';
+import { buildAgent } from './agent-factory.js';
+import { clearModelCache, fetchModels } from '../services/model-service.js';
+import { registerProvider } from '../providers/registry.js';
+import { createEditorImpl } from './editor-impl.js';
+const createMockLogger = () => {
+    const debugCalls = [];
+    return {
+        debugCalls,
+        debug: (...args) => {
+            debugCalls.push(args);
+        },
+        info: () => { },
+        warn: () => { },
+        error: () => { },
+        security: () => { },
+        setCorrelationId: () => { },
+        clearCorrelationId: () => { },
+        getCorrelationId: () => undefined,
+        log: () => { },
+    };
+};
+const createMockSettings = (values = {}) => {
+    const store = {
+        'agent.model': 'gpt-4o',
+        'agent.temperature': undefined,
+        'agent.reasoningEffort': 'default',
+        'agent.provider': 'openai',
+        'agent.useFlexServiceTier': false,
+        'shell.maxOutputChars': undefined,
+        ...values,
+    };
+    return {
+        get: (key) => store[key],
+        set: (key, value) => {
+            store[key] = value;
+        },
+    };
+};
+const createDeps = (overrides = {}) => {
+    const logger = createMockLogger();
+    const settings = createMockSettings(overrides.settingsValues);
+    const editor = createEditorImpl({
+        loggingService: logger,
+        settingsService: settings,
+        executionContext: overrides.executionContext,
+    });
+    return {
+        logger,
+        settings,
+        deps: {
+            settings,
+            logger,
+            editor,
+            providerId: overrides.providerId ?? 'openai',
+            serviceTierOverrideForNextRequest: overrides.serviceTierOverrideForNextRequest ?? null,
+            executionContext: overrides.executionContext,
+            createMentor: overrides.createMentor ?? (async () => 'mentor-response'),
+            runSubagent: overrides.runSubagent ?? (async () => ({ finalText: 'subagent-response' })),
+            getAskUserAnswer: overrides.getAskUserAnswer ?? (() => undefined),
+            checkToolInterceptors: overrides.checkToolInterceptors ?? (async () => null),
+        },
+    };
+};
+it.sequential('buildAgent creates Agent with correct model name', () => {
+    const { deps } = createDeps({ settingsValues: { 'agent.model': 'gpt-4o-mini' } });
+    const result = buildAgent({ model: 'gpt-4o-mini' }, deps);
+    expect(result.agent.model).toBe('gpt-4o-mini');
+    expect(result.resolvedModel).toBe('gpt-4o-mini');
+});
+it.sequential('buildAgent resolves model from settings when model param is omitted', () => {
+    const { deps } = createDeps({ settingsValues: { 'agent.model': 'gpt-4.1-mini' } });
+    const result = buildAgent({}, deps);
+    expect(result.resolvedModel).toBe('gpt-4.1-mini');
+    expect(result.agent.model).toBe('gpt-4.1-mini');
+});
+it.sequential('buildAgent returns resolvedModel', () => {
+    const { deps } = createDeps();
+    const result = buildAgent({ model: 'gpt-4o' }, deps);
+    expect(result.resolvedModel).toBe('gpt-4o');
+});
+it.sequential('buildAgent applies strict tool schema when provider supports it', () => {
+    const { deps } = createDeps({ providerId: 'openai', settingsValues: { 'agent.model': 'gpt-4o' } });
+    const result = buildAgent({ model: 'gpt-4o' }, deps);
+    const readFileTool = result.agent.tools.find((tool) => tool.name === 'read_file');
+    expect(readFileTool).toBeTruthy();
+    expect(Array.isArray(readFileTool.parameters.required)).toBe(true);
+    expect(readFileTool.parameters.required.includes('start_line')).toBe(true);
+    expect(readFileTool.parameters.required.includes('end_line')).toBe(true);
+});
+it.sequential('buildAgent excludes custom apply_patch when native patch tool is enabled', () => {
+    const { deps } = createDeps({ providerId: 'openai' });
+    const result = buildAgent({ model: 'gpt-5.1' }, deps);
+    const toolNames = result.agent.tools.map((tool) => tool.name);
+    expect(toolNames.filter((name) => name === 'apply_patch').length).toBe(1);
+    expect(toolNames.includes('apply_patch')).toBe(true);
+});
+it.sequential('buildAgent includes native applyPatchTool for supported models', () => {
+    const { deps, logger } = createDeps({ providerId: 'openai' });
+    const result = buildAgent({ model: 'gpt-5.1' }, deps);
+    expect(result.agent.tools.some((tool) => tool.name === 'apply_patch')).toBe(true);
+    expect(logger.debugCalls.some(([message]) => message === 'Using native applyPatchTool from SDK')).toBe(true);
+});
+it.sequential('buildAgent resolves codex default_reasoning_level', async () => {
+    clearModelCache();
+    const fakeCodexProvider = {
+        id: 'codex',
+        label: 'Mock Codex',
+        createRunner: () => null,
+        fetchModels: async () => [{ id: 'gpt-5.3-codex', default_reasoning_level: 'medium' }],
+        capabilities: {
+            supportsConversationChaining: true,
+            supportsTracingControl: true,
+        },
+    };
+    registerProvider(fakeCodexProvider, { allowOverride: true });
+    const { deps } = createDeps({
+        providerId: 'codex',
+        settingsValues: {
+            'agent.model': 'gpt-5.3-codex',
+            'agent.reasoningEffort': 'default',
+        },
+    });
+    await fetchModels({ settingsService: deps.settings, loggingService: deps.logger }, 'codex', async () => ({
+        ok: true,
+        json: async () => ({ data: [] }),
+    }));
+    const result = buildAgent({ model: 'gpt-5.3-codex' }, deps);
+    const agent = result.agent;
+    expect(result.resolvedModel).toBe('gpt-5.3-codex');
+    expect(agent.modelSettings?.reasoning?.effort).toBe('medium');
+    expect(agent.defaultRunOptions?.reasoning?.effort).toBe('medium');
+});
+it.sequential('buildAgent sets flex service tier when enabled', () => {
+    const { deps } = createDeps({
+        providerId: 'openai',
+        settingsValues: {
+            'agent.useFlexServiceTier': true,
+        },
+    });
+    const result = buildAgent({ model: 'gpt-4o' }, deps);
+    expect(result.agent.modelSettings?.providerData?.service_tier).toBe('flex');
+});
+it.sequential('buildAgent leaves parallel tool calls enabled by provider policy for Codex', () => {
+    const { deps } = createDeps({
+        providerId: 'codex',
+        settingsValues: {
+            'agent.model': 'gpt-5.4-mini',
+        },
+    });
+    const result = buildAgent({ model: 'gpt-5.4-mini' }, deps);
+    expect('parallelToolCalls' in (result.agent.modelSettings ?? {})).toBe(false);
+});
+it.sequential('buildAgent omits flex service tier when serviceTierOverrideForNextRequest is standard', () => {
+    const { deps } = createDeps({
+        providerId: 'openai',
+        serviceTierOverrideForNextRequest: 'standard',
+        settingsValues: {
+            'agent.useFlexServiceTier': true,
+        },
+    });
+    const result = buildAgent({ model: 'gpt-4o' }, deps);
+    expect(result.agent.modelSettings?.providerData?.service_tier).toBeFalsy();
+});
+it.sequential('buildModelSettings omits reasoning when effort is default', () => {
+    const { deps } = createDeps({
+        providerId: 'openai',
+        settingsValues: {
+            'agent.reasoningEffort': 'default',
+        },
+    });
+    const result = buildAgent({ model: 'gpt-4o', reasoningEffort: 'default' }, deps);
+    expect(result.agent.modelSettings?.reasoning).toBeFalsy();
+});
+//# sourceMappingURL=agent-factory.test.js.map

package/dist/lib/agent-factory.test.js.map

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

package/dist/lib/agent-run-orchestrator.d.ts

@@ -0,0 +1,38 @@
+import { type AgentInputItem, type RunState, type StreamedRunResult } from '@openai/agents';
+import type { ILoggingService, ISettingsService } from '../services/service-interfaces.js';
+import { AgentConfiguration } from './agent-configuration.js';
+import { RunnerManager } from './runner-manager.js';
+type ChainedRunOptions = {
+    previousResponseId?: string | null;
+    sessionId?: string;
+    toolResultCallIds?: readonly string[];
+};
+export interface AgentRunOrchestratorDeps {
+    agentConfig: AgentConfiguration;
+    runnerManager: RunnerManager;
+    settings: ISettingsService;
+    logger: ILoggingService;
+}
+/**
+ * Owns the stream/run lifecycle for an AgentClient.
+ *
+ * Responsibilities:
+ * - Stream lifecycle: startStream(), continueRunStream()
+ * - Abort: abort()
+ * - Conversation state: clearConversations(), supportsConversationChaining()
+ * - Internal: #runAgent(), #runAgentWithProvider(), #filterAndGuardChainedModelInput(), #getMaxParallelToolCalls()
+ */
+export declare class AgentRunOrchestrator {
+    #private;
+    constructor(deps: AgentRunOrchestratorDeps);
+    supportsConversationChaining(): boolean;
+    /**
+     * Abort the current running stream/operation
+     */
+    abort(): void;
+    clearConversations(): void;
+    startStream(userInput: string | AgentInputItem | AgentInputItem[], { previousResponseId, sessionId, toolResultCallIds }?: ChainedRunOptions): Promise<StreamedRunResult<any, any>>;
+    continueRunStream(state: RunState<any, any>, { previousResponseId, sessionId, toolResultCallIds }?: ChainedRunOptions): Promise<StreamedRunResult<any, any>>;
+}
+export {};
+//# sourceMappingURL=agent-run-orchestrator.d.ts.map

package/dist/lib/agent-run-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-orchestrator.d.ts","sourceRoot":"","sources":["../../source/lib/agent-run-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAU,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEhH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAI3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,KAAK,iBAAiB,GAAG;IACvB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,kBAAkB,CAAC;IAChC,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;;gBAUnB,IAAI,EAAE,wBAAwB;IAO1C,4BAA4B,IAAI,OAAO;IAsBvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAkBb,kBAAkB,IAAI,IAAI;IAsCpB,WAAW,CACf,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,EAAE,EACrD,EAAE,kBAAkB,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAE,iBAAsB,GAC3E,OAAO,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAiGjC,iBAAiB,CACrB,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EACzB,EAAE,kBAAkB,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAE,iBAAsB,GAC3E,OAAO,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;CAkGxC"}