@vibe-forge/tsconfigs 0.7.1 → 0.8.0

package/dist/packages/core/src/controllers/task/run.js

@@ -0,0 +1,229 @@
+import { loadAdapter } from '#~/adapter/index.js';
+import { createAdapterHookBridge } from '#~/hooks/bridge.js';
+import { callHook } from '#~/hooks/call.js';
+import { listServiceModels, mergeAdapterConfigs, normalizeNonEmptyString, resolveAdapterConfiguredDefaultModel, resolveAdapterModelCompatibility, resolveDefaultModelSelection, resolveModelDefaultAdapter, resolveModelSelection } from '#~/utils/model-selection.js';
+import { buildAdapterAssetPlan } from '#~/utils/workspace-assets.js';
+import { prepare } from './prepare';
+const pickFirstNonEmptyString = (values) => values
+    .map(normalizeNonEmptyString)
+    .find((value) => value != null);
+const formatAdapterModelRuleSuffix = (params) => {
+    const parts = [];
+    if (params.includeModels != null && params.includeModels.length > 0) {
+        parts.push(`includeModels=${params.includeModels.join(', ')}`);
+    }
+    if (params.excludeModels != null && params.excludeModels.length > 0) {
+        parts.push(`excludeModels=${params.excludeModels.join(', ')}`);
+    }
+    return parts.length > 0 ? ` (${parts.join('; ')})` : '';
+};
+const formatAdapterModelFallbackError = (error) => {
+    const ruleSuffix = formatAdapterModelRuleSuffix({
+        includeModels: error.includeModels,
+        excludeModels: error.excludeModels
+    });
+    if (error.type === 'missing_default_model') {
+        return `Model "${error.requestedModel}" is not allowed for adapter "${error.adapter}"${ruleSuffix}. Configure adapters.${error.adapter}.defaultModel to continue.`;
+    }
+    return `Adapter "${error.adapter}" defaultModel "${error.defaultModel}" is also not allowed${ruleSuffix}.`;
+};
+const resolveQuerySelection = (params) => {
+    const mergedAdapters = mergeAdapterConfigs(params.config?.adapters, params.userConfig?.adapters);
+    const mergedModels = {
+        ...(params.config?.models ?? {}),
+        ...(params.userConfig?.models ?? {})
+    };
+    const mergedModelServices = {
+        ...(params.config?.modelServices ?? {}),
+        ...(params.userConfig?.modelServices ?? {})
+    };
+    const availableAdapters = Object.keys(mergedAdapters ?? {});
+    const serviceModels = listServiceModels(mergedModelServices);
+    const explicitAdapter = normalizeNonEmptyString(params.inputAdapter);
+    const explicitModel = resolveModelSelection({
+        value: params.inputModel,
+        serviceModels,
+        preserveUnknown: true
+    });
+    const mergedDefaultAdapter = pickFirstNonEmptyString([
+        params.userConfig?.defaultAdapter,
+        params.config?.defaultAdapter
+    ]);
+    const mergedDefaultModel = pickFirstNonEmptyString([
+        params.userConfig?.defaultModel,
+        params.config?.defaultModel
+    ]);
+    const mergedDefaultModelService = pickFirstNonEmptyString([
+        params.userConfig?.defaultModelService,
+        params.config?.defaultModelService
+    ]);
+    const resolvedDefaultModel = resolveDefaultModelSelection({
+        defaultModel: mergedDefaultModel,
+        defaultModelService: mergedDefaultModelService,
+        serviceModels,
+        preserveUnknownDefaultModel: true
+    });
+    const resolveAdapterFallback = () => explicitAdapter ?? mergedDefaultAdapter ?? availableAdapters[0];
+    const resolveAdapterForModel = (model) => (explicitAdapter ??
+        resolveModelDefaultAdapter({
+            model,
+            models: mergedModels
+        }) ??
+        mergedDefaultAdapter ??
+        availableAdapters[0]);
+    const resolveModelForAdapter = (adapter) => {
+        const adapterConfiguredModel = resolveAdapterConfiguredDefaultModel({
+            adapterConfig: adapter != null ? mergedAdapters?.[adapter] : undefined,
+            serviceModels,
+            preferredServiceKey: mergedDefaultModelService,
+            preserveUnknown: true
+        });
+        return adapterConfiguredModel ?? resolvedDefaultModel;
+    };
+    if (explicitModel != null) {
+        return {
+            adapter: resolveAdapterForModel(explicitModel),
+            model: explicitModel
+        };
+    }
+    if (explicitAdapter != null) {
+        return {
+            adapter: explicitAdapter,
+            model: resolveModelForAdapter(explicitAdapter)
+        };
+    }
+    if (resolvedDefaultModel != null) {
+        return {
+            adapter: resolveAdapterForModel(resolvedDefaultModel),
+            model: resolvedDefaultModel
+        };
+    }
+    const adapter = resolveAdapterFallback();
+    return {
+        adapter,
+        model: resolveModelForAdapter(adapter)
+    };
+};
+const BASE_NATIVE_BRIDGE_DISABLED_EVENTS = ['SessionStart', 'UserPromptSubmit', 'PreToolUse', 'PostToolUse', 'Stop'];
+const OPENCODE_NATIVE_BRIDGE_DISABLED_EVENTS = ['SessionStart', 'PreToolUse', 'PostToolUse', 'Stop'];
+export const run = async (options, adapterOptions) => {
+    const [ctx] = await prepare(options, adapterOptions);
+    const { configs: [config, userConfig] } = ctx;
+    const { logger, cache, ...base } = ctx;
+    await cache.set('base', base);
+    const resolvedSelection = resolveQuerySelection({
+        config,
+        userConfig,
+        inputAdapter: options.adapter,
+        inputModel: adapterOptions.model
+    });
+    const adapterType = resolvedSelection.adapter;
+    if (adapterType == null) {
+        throw new Error('No adapter found in config, please set adapters in config file');
+    }
+    const mergedAdapters = mergeAdapterConfigs(config?.adapters, userConfig?.adapters);
+    const mergedModelServices = {
+        ...(config?.modelServices ?? {}),
+        ...(userConfig?.modelServices ?? {})
+    };
+    const serviceModels = listServiceModels(mergedModelServices);
+    const mergedDefaultModelService = pickFirstNonEmptyString([
+        userConfig?.defaultModelService,
+        config?.defaultModelService
+    ]);
+    const compatibilityResult = resolveAdapterModelCompatibility({
+        adapter: adapterType,
+        model: resolvedSelection.model,
+        adapterConfig: mergedAdapters?.[adapterType],
+        serviceModels,
+        preferredServiceKey: mergedDefaultModelService,
+        preserveUnknownDefaultModel: true
+    });
+    if (compatibilityResult.error) {
+        throw new Error(formatAdapterModelFallbackError(compatibilityResult.error));
+    }
+    const adapter = await loadAdapter(adapterType);
+    await adapter.init?.(ctx);
+    const resolvedModel = compatibilityResult.model ?? resolvedSelection.model;
+    const selectionWarnings = compatibilityResult.warning != null ? [compatibilityResult.warning] : undefined;
+    const originalOnEvent = adapterOptions.onEvent;
+    const supportedAssetPlanAdapters = new Set(['claude-code', 'codex', 'opencode']);
+    const assetPlan = ctx.assets == null || !supportedAssetPlanAdapters.has(adapterType)
+        ? undefined
+        : buildAdapterAssetPlan({
+            adapter: adapterType,
+            bundle: ctx.assets,
+            options: {
+                mcpServers: adapterOptions.mcpServers,
+                skills: adapterOptions.skills,
+                promptAssetIds: adapterOptions.promptAssetIds
+            }
+        });
+    const nativeBridgeDisabledEvents = adapterType === 'codex' && ctx.env.__VF_PROJECT_AI_CODEX_NATIVE_HOOKS_AVAILABLE__ === '1'
+        ? BASE_NATIVE_BRIDGE_DISABLED_EVENTS
+        : adapterType === 'claude-code' && ctx.env.__VF_PROJECT_AI_CLAUDE_NATIVE_HOOKS_AVAILABLE__ === '1'
+            ? BASE_NATIVE_BRIDGE_DISABLED_EVENTS
+            : adapterType === 'opencode' && ctx.env.__VF_PROJECT_AI_OPENCODE_NATIVE_HOOKS_AVAILABLE__ === '1'
+                ? OPENCODE_NATIVE_BRIDGE_DISABLED_EVENTS
+                : [];
+    const hookBridge = createAdapterHookBridge({
+        ctx,
+        adapter: adapterType,
+        runtime: adapterOptions.runtime,
+        sessionId: adapterOptions.sessionId,
+        type: adapterOptions.type,
+        model: resolvedModel,
+        disabledEvents: nativeBridgeDisabledEvents
+    });
+    const wrappedOnEvent = (event) => {
+        hookBridge.handleOutput(event);
+        if (event.type === 'init') {
+            originalOnEvent({
+                ...event,
+                data: {
+                    ...event.data,
+                    adapter: adapterType,
+                    selectionWarnings: selectionWarnings ?? event.data.selectionWarnings,
+                    assetDiagnostics: assetPlan?.diagnostics ?? event.data.assetDiagnostics
+                }
+            });
+            return;
+        }
+        if (event.type === 'exit') {
+            const { data } = event;
+            void callHook('TaskStop', {
+                adapter: adapterType,
+                cwd: ctx.cwd,
+                sessionId: adapterOptions.sessionId,
+                options,
+                adapterOptions,
+                exitCode: data.exitCode,
+                stderr: data.stderr
+            }, ctx.env)
+                .catch((e) => {
+                logger.error('[Hook] TaskStop failed', e);
+            });
+        }
+        originalOnEvent(event);
+    };
+    const taskStartOutput = await callHook('TaskStart', {
+        adapter: adapterType,
+        cwd: ctx.cwd,
+        sessionId: adapterOptions.sessionId,
+        options,
+        adapterOptions
+    }, ctx.env);
+    if (taskStartOutput?.continue === false) {
+        throw new Error(taskStartOutput.stopReason ?? 'TaskStart hook blocked task startup');
+    }
+    await hookBridge.start();
+    const description = await hookBridge.prepareInitialPrompt(adapterOptions.description);
+    const session = await adapter.query(ctx, {
+        ...adapterOptions,
+        assetPlan,
+        description,
+        model: resolvedModel,
+        onEvent: wrappedOnEvent
+    });
+    return { session: hookBridge.wrapSession(session), ctx };
+};

package/dist/packages/core/src/controllers/task/schema.d.ts

@@ -0,0 +1,338 @@
+import z from 'zod';
+export declare const TaskOptions: z.ZodObject<{
+    type: z.ZodUnion<[z.ZodLiteral<"entity">, z.ZodLiteral<"spec">]>;
+    name: z.ZodString;
+    specParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    runtime: z.ZodObject<{
+        type: z.ZodString;
+        noDefaultSystemPrompt: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        noDefaultSystemPrompt?: boolean | undefined;
+    }, {
+        type: string;
+        noDefaultSystemPrompt?: boolean | undefined;
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    frontendTimeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    defaultModel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "spec" | "entity";
+    name: string;
+    runtime: {
+        type: string;
+        noDefaultSystemPrompt?: boolean | undefined;
+    };
+    description?: string | undefined;
+    sessionId?: string | undefined;
+    defaultModel?: string | undefined;
+    specParams?: Record<string, string> | undefined;
+    frontendTimeout?: number | undefined;
+}, {
+    type: "spec" | "entity";
+    name: string;
+    runtime: {
+        type: string;
+        noDefaultSystemPrompt?: boolean | undefined;
+    };
+    description?: string | undefined;
+    sessionId?: string | undefined;
+    defaultModel?: string | undefined;
+    specParams?: Record<string, string> | undefined;
+    frontendTimeout?: number | undefined;
+}>;
+export type TaskOptions = z.infer<typeof TaskOptions>;
+export declare const MCPRunTasksOptions: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodObject<{
+        type: z.ZodUnion<[z.ZodLiteral<"entity">, z.ZodLiteral<"spec">]>;
+        name: z.ZodString;
+        specParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        runtime: z.ZodObject<{
+            type: z.ZodString;
+            noDefaultSystemPrompt: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        }, {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        frontendTimeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        defaultModel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "spec" | "entity";
+        name: string;
+        runtime: {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        };
+        description?: string | undefined;
+        sessionId?: string | undefined;
+        defaultModel?: string | undefined;
+        specParams?: Record<string, string> | undefined;
+        frontendTimeout?: number | undefined;
+    }, {
+        type: "spec" | "entity";
+        name: string;
+        runtime: {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        };
+        description?: string | undefined;
+        sessionId?: string | undefined;
+        defaultModel?: string | undefined;
+        specParams?: Record<string, string> | undefined;
+        frontendTimeout?: number | undefined;
+    }>, "many">;
+    bashDefaultTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    bashMaxTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    maxMcpOutputTokens: z.ZodOptional<z.ZodNumber>;
+    mcpTimeout: z.ZodOptional<z.ZodNumber>;
+    mcpToolTimeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    tasks: {
+        type: "spec" | "entity";
+        name: string;
+        runtime: {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        };
+        description?: string | undefined;
+        sessionId?: string | undefined;
+        defaultModel?: string | undefined;
+        specParams?: Record<string, string> | undefined;
+        frontendTimeout?: number | undefined;
+    }[];
+    bashDefaultTimeoutMs?: number | undefined;
+    bashMaxTimeoutMs?: number | undefined;
+    maxMcpOutputTokens?: number | undefined;
+    mcpTimeout?: number | undefined;
+    mcpToolTimeout?: number | undefined;
+}, {
+    tasks: {
+        type: "spec" | "entity";
+        name: string;
+        runtime: {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        };
+        description?: string | undefined;
+        sessionId?: string | undefined;
+        defaultModel?: string | undefined;
+        specParams?: Record<string, string> | undefined;
+        frontendTimeout?: number | undefined;
+    }[];
+    bashDefaultTimeoutMs?: number | undefined;
+    bashMaxTimeoutMs?: number | undefined;
+    maxMcpOutputTokens?: number | undefined;
+    mcpTimeout?: number | undefined;
+    mcpToolTimeout?: number | undefined;
+}>;
+export type MCPRunTasksOptions = z.infer<typeof MCPRunTasksOptions>;
+export declare const Options: z.ZodObject<{
+    taskId: z.ZodOptional<z.ZodString>;
+} & {
+    tasks: z.ZodArray<z.ZodObject<{
+        type: z.ZodUnion<[z.ZodLiteral<"entity">, z.ZodLiteral<"spec">]>;
+        name: z.ZodString;
+        specParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        runtime: z.ZodObject<{
+            type: z.ZodString;
+            noDefaultSystemPrompt: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        }, {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        frontendTimeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        defaultModel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "spec" | "entity";
+        name: string;
+        runtime: {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        };
+        description?: string | undefined;
+        sessionId?: string | undefined;
+        defaultModel?: string | undefined;
+        specParams?: Record<string, string> | undefined;
+        frontendTimeout?: number | undefined;
+    }, {
+        type: "spec" | "entity";
+        name: string;
+        runtime: {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        };
+        description?: string | undefined;
+        sessionId?: string | undefined;
+        defaultModel?: string | undefined;
+        specParams?: Record<string, string> | undefined;
+        frontendTimeout?: number | undefined;
+    }>, "many">;
+    bashDefaultTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    bashMaxTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    maxMcpOutputTokens: z.ZodOptional<z.ZodNumber>;
+    mcpTimeout: z.ZodOptional<z.ZodNumber>;
+    mcpToolTimeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    tasks: {
+        type: "spec" | "entity";
+        name: string;
+        runtime: {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        };
+        description?: string | undefined;
+        sessionId?: string | undefined;
+        defaultModel?: string | undefined;
+        specParams?: Record<string, string> | undefined;
+        frontendTimeout?: number | undefined;
+    }[];
+    bashDefaultTimeoutMs?: number | undefined;
+    bashMaxTimeoutMs?: number | undefined;
+    maxMcpOutputTokens?: number | undefined;
+    mcpTimeout?: number | undefined;
+    mcpToolTimeout?: number | undefined;
+    taskId?: string | undefined;
+}, {
+    tasks: {
+        type: "spec" | "entity";
+        name: string;
+        runtime: {
+            type: string;
+            noDefaultSystemPrompt?: boolean | undefined;
+        };
+        description?: string | undefined;
+        sessionId?: string | undefined;
+        defaultModel?: string | undefined;
+        specParams?: Record<string, string> | undefined;
+        frontendTimeout?: number | undefined;
+    }[];
+    bashDefaultTimeoutMs?: number | undefined;
+    bashMaxTimeoutMs?: number | undefined;
+    maxMcpOutputTokens?: number | undefined;
+    mcpTimeout?: number | undefined;
+    mcpToolTimeout?: number | undefined;
+    taskId?: string | undefined;
+}>;
+export type Options = z.infer<typeof Options>;
+export declare const Entity: z.ZodObject<{
+    prompt: z.ZodOptional<z.ZodString>;
+    promptPath: z.ZodOptional<z.ZodString>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodOptional<z.ZodLiteral<"local">>;
+        path: z.ZodString;
+        desc: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        type?: "local" | undefined;
+        desc?: string | undefined;
+    }, {
+        path: string;
+        type?: "local" | undefined;
+        desc?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"remote">;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        desc: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "remote";
+        desc?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        type: "remote";
+        desc?: string | undefined;
+        tags?: string[] | undefined;
+    }>]>]>, "many">>;
+    skills: z.ZodOptional<z.ZodObject<{
+        type: z.ZodUnion<[z.ZodLiteral<"include">, z.ZodLiteral<"exclude">]>;
+        list: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "include" | "exclude";
+        list: string[];
+    }, {
+        type: "include" | "exclude";
+        list: string[];
+    }>>;
+    mcpServers: z.ZodOptional<z.ZodObject<{
+        include: z.ZodArray<z.ZodString, "many">;
+        exclude: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        include: string[];
+        exclude: string[];
+    }, {
+        include: string[];
+        exclude: string[];
+    }>>;
+    tools: z.ZodOptional<z.ZodObject<{
+        include: z.ZodArray<z.ZodString, "many">;
+        exclude: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        include: string[];
+        exclude: string[];
+    }, {
+        include: string[];
+        exclude: string[];
+    }>>;
+    defaultModel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    prompt?: string | undefined;
+    mcpServers?: {
+        include: string[];
+        exclude: string[];
+    } | undefined;
+    rules?: (string | {
+        path: string;
+        type?: "local" | undefined;
+        desc?: string | undefined;
+    } | {
+        type: "remote";
+        desc?: string | undefined;
+        tags?: string[] | undefined;
+    })[] | undefined;
+    skills?: {
+        type: "include" | "exclude";
+        list: string[];
+    } | undefined;
+    tools?: {
+        include: string[];
+        exclude: string[];
+    } | undefined;
+    defaultModel?: string | undefined;
+    promptPath?: string | undefined;
+}, {
+    prompt?: string | undefined;
+    mcpServers?: {
+        include: string[];
+        exclude: string[];
+    } | undefined;
+    rules?: (string | {
+        path: string;
+        type?: "local" | undefined;
+        desc?: string | undefined;
+    } | {
+        type: "remote";
+        desc?: string | undefined;
+        tags?: string[] | undefined;
+    })[] | undefined;
+    skills?: {
+        type: "include" | "exclude";
+        list: string[];
+    } | undefined;
+    tools?: {
+        include: string[];
+        exclude: string[];
+    } | undefined;
+    defaultModel?: string | undefined;
+    promptPath?: string | undefined;
+}>;
+export type Entity = z.infer<typeof Entity>;

package/dist/packages/core/src/controllers/task/schema.js

@@ -0,0 +1,106 @@
+import z from 'zod';
+export const TaskOptions = z.object({
+    type: z
+        .union([
+        z.literal('entity'),
+        // 基础库 API 能力开发
+        z.literal('spec')
+    ])
+        .describe('任务模式'),
+    name: z.string().describe('垂类知识库基准目标'),
+    specParams: z.record(z.string()).describe('SPEC 执行时的参数').optional(),
+    runtime: z
+        .object({
+        type: z
+            .string()
+            .describe('选择特定的 AI CLI 类型'),
+        noDefaultSystemPrompt: z
+            .boolean()
+            .describe('是否禁用默认的系统提示')
+            .optional()
+    }),
+    description: z
+        .string()
+        .describe('本次任务的描述，介绍关于本次任务需要进行的工作')
+        .optional(),
+    sessionId: z
+        .string()
+        .describe('复用上次会话的历史消息作为本次任务的上下文。\n' +
+        '- 通常如果某个任务在执行的时候出现了非预期的错误，那么你可以通过传入相同的 sessionID 来继续这个会话\n' +
+        '- 如果有一个步骤需要间隔执行，比如说先执行任务 A 的 A-1，然后完成后执行 B 的 B-1，等 B-1 这个完成后回到 A-1 继续执行 A-2 时也可以使用')
+        .optional(),
+    frontendTimeout: z
+        .number()
+        .describe('前台等待时间的上限，单位秒，默认值为 8 分钟。' +
+        '在超过这个时间后该任务会被转化为一个后台任务，并直接返回当前的输出以及 sessionId，你可以通过 sessionId 来继续这个任务，或者查询任务的状态')
+        .default(8 * 60)
+        .optional(),
+    defaultModel: z.string().describe('默认的模型').optional()
+});
+export const MCPRunTasksOptions = z.object({
+    tasks: z
+        .array(TaskOptions)
+        .describe('子任务列表。传递多个子任务时会并发执行多个，可用于优化整体任务效率。'),
+    bashDefaultTimeoutMs: z.number().optional(),
+    bashMaxTimeoutMs: z.number().optional(),
+    maxMcpOutputTokens: z.number().optional(),
+    mcpTimeout: z.number().optional(),
+    mcpToolTimeout: z.number().optional()
+});
+export const Options = z
+    .object({
+    taskId: z
+        .string()
+        .describe('唯一 id，会用于关联多个任务相关信息。\n' +
+        '如果是第一次执行，则不需要传入，会在返回值中自动生成一个，在下次创建或复用的时候必须传入该值以供记录相关上下文。\n' +
+        '用户指定了 taskId，则以用户指定的 taskId 为准，在创建任务时则必须要指定对应的 taskId 参数。')
+        .optional()
+})
+    .extend(MCPRunTasksOptions.shape);
+export const Entity = z.object({
+    prompt: z
+        .string()
+        .describe('实体的描述，简单介绍一下当前实体的作用。')
+        .optional(),
+    promptPath: z
+        .string()
+        .describe('实体的描述文件路径，文件内容为实体的描述。默认为当前目录下的 AGENTS.md 文件。')
+        .optional(),
+    rules: z
+        .array(z.union([
+        z.string(),
+        z.discriminatedUnion('type', [
+            z.object({
+                type: z.literal('local').optional(),
+                path: z.string(),
+                desc: z.string().optional()
+            }),
+            z.object({
+                type: z.literal('remote'),
+                tags: z.array(z.string()).describe('关键 tag').optional(),
+                desc: z.string().describe('知识库的描述').optional()
+            })
+        ])
+    ]))
+        .optional()
+        .describe('垂类 agent 的规则集合'),
+    skills: z
+        .object({
+        type: z.union([z.literal('include'), z.literal('exclude')]),
+        list: z.array(z.string()).describe('技能列表')
+    })
+        .optional(),
+    mcpServers: z
+        .object({
+        include: z.array(z.string()).describe('包含的服务名称列表'),
+        exclude: z.array(z.string()).describe('排除的服务名称列表')
+    })
+        .optional(),
+    tools: z
+        .object({
+        include: z.array(z.string()).describe('包含的工具名称列表'),
+        exclude: z.array(z.string()).describe('排除的工具名称列表')
+    })
+        .optional(),
+    defaultModel: z.string().optional()
+});

package/dist/packages/core/src/controllers/task/type.d.ts

@@ -0,0 +1,6 @@
+export interface RunTaskOptions {
+    ctxId?: string;
+    adapter?: string;
+    env?: Record<string, string | undefined | null>;
+    cwd?: string;
+}

package/dist/packages/core/src/controllers/task/type.js

@@ -0,0 +1 @@
+export {};