@jetcrab/pi-desk-subagent 0.0.0-stage → 1.0.1

package/dist/global-settings.js

@@ -0,0 +1,100 @@
+import { readFile, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getAgentDir, ModelRuntime, withFileMutationQueue } from '@earendil-works/pi-coding-agent';
+import { PluginMethodError } from '@jetcrab/pi-desk-sdk/session';
+import { listGlobalSubagentSettings } from './agent-config.js';
+const levels = new Set(['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max']);
+function parseSettings(input) {
+    if (!input || typeof input !== 'object' || !('agents' in input) || !Array.isArray(input.agents)) {
+        throw new PluginMethodError(400, '子代理设置参数无效');
+    }
+    const names = new Set(listGlobalSubagentSettings().map((agent) => agent.name));
+    const seen = new Set();
+    return input.agents.map((item) => {
+        if (!item || typeof item !== 'object')
+            throw new PluginMethodError(400, '子代理设置参数无效');
+        const value = item;
+        if (typeof value.name !== 'string' ||
+            !names.has(value.name) ||
+            seen.has(value.name) ||
+            typeof value.model !== 'string' ||
+            (value.model !== '' && !/^[^/\s]+\/\S+$/.test(value.model)) ||
+            (value.thinking !== null && !levels.has(String(value.thinking))) ||
+            typeof value.disabled !== 'boolean') {
+            throw new PluginMethodError(400, '子代理设置参数无效');
+        }
+        seen.add(value.name);
+        return value;
+    });
+}
+async function availableModels() {
+    const runtime = await ModelRuntime.create({ allowModelNetwork: false });
+    const error = runtime.getError();
+    if (error)
+        throw new Error(error);
+    return (await runtime.getAvailable())
+        .filter((model) => model.input.includes('text'))
+        .map((model) => ({ provider: model.provider, modelId: model.id, name: model.name }))
+        .sort((a, b) => `${a.provider}/${a.modelId}`.localeCompare(`${b.provider}/${b.modelId}`));
+}
+export async function getGlobalSubagentSettings() {
+    return { agents: listGlobalSubagentSettings(), models: await availableModels() };
+}
+export async function saveGlobalSubagentSettings(input) {
+    const changes = parseSettings(input);
+    const models = changes.some((item) => item.model && !item.disabled)
+        ? new Set((await availableModels()).map((model) => `${model.provider}/${model.modelId}`))
+        : null;
+    for (const item of changes) {
+        if (item.model && !item.disabled && !models?.has(item.model)) {
+            throw new PluginMethodError(400, `模型当前不可用：${item.model}`);
+        }
+    }
+    const path = join(getAgentDir(), 'settings.json');
+    await withFileMutationQueue(path, async () => {
+        const settings = JSON.parse(await readFile(path, 'utf8'));
+        const agents = settings.agents;
+        if (agents !== undefined && (!agents || typeof agents !== 'object' || Array.isArray(agents))) {
+            throw new Error('全局 agents 配置不是对象');
+        }
+        const next = { ...agents };
+        for (const item of changes) {
+            const previous = next[item.name];
+            const original = previous && typeof previous === 'object' && !Array.isArray(previous)
+                ? previous
+                : {};
+            const entry = { ...original };
+            if (item.model)
+                entry.model = item.model;
+            else
+                delete entry.model;
+            if (item.thinking !== null && item.model)
+                entry.thinking = item.thinking;
+            else
+                delete entry.thinking;
+            if (item.disabled)
+                entry.disabled = true;
+            else
+                delete entry.disabled;
+            if (Object.keys(entry).length)
+                next[item.name] = entry;
+            else
+                delete next[item.name];
+        }
+        settings.agents = next;
+        const temporary = `${path}.${process.pid}.${crypto.randomUUID()}.tmp`;
+        try {
+            await writeFile(temporary, `${JSON.stringify(settings, null, 2)}\n`, 'utf8');
+            await rename(temporary, path);
+        }
+        catch (error) {
+            const { rm } = await import('node:fs/promises');
+            await rm(temporary, { force: true });
+            throw error;
+        }
+    });
+    console.info('[pi-desk-subagent] 全局子代理配置已保存', {
+        agents: changes.map((item) => item.name)
+    });
+    return { agents: listGlobalSubagentSettings() };
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export default function tempLocalSubagent(pi: ExtensionAPI): void;

package/dist/index.js

@@ -0,0 +1,4 @@
+import { registerSubagentExtension } from './subagent-runtime.js';
+export default function tempLocalSubagent(pi) {
+    registerSubagentExtension(pi);
+}

package/dist/pi-desk.d.ts

@@ -0,0 +1,7 @@
+import { type PluginMessageDeclarationInput, type PluginMessageProjectionResult } from '@jetcrab/pi-desk-sdk/entry';
+export declare function projectSubagentStartMessage(input: PluginMessageDeclarationInput): PluginMessageProjectionResult;
+export declare function projectSubagentReturnMessage(input: PluginMessageDeclarationInput): PluginMessageProjectionResult;
+export declare function projectSubagentListMessage(input: PluginMessageDeclarationInput): PluginMessageProjectionResult;
+export declare function projectSubagentControlMessage(input: PluginMessageDeclarationInput): PluginMessageProjectionResult;
+declare const _default: import("@jetcrab/pi-desk-sdk/entry").PiDeskPluginDefinition;
+export default _default;

package/dist/pi-desk.js

@@ -0,0 +1,164 @@
+import { definePiDeskPlugin } from '@jetcrab/pi-desk-sdk/entry';
+import { collectSubagentCapabilityOptions } from './agent-config.js';
+import { getGlobalSubagentSettings, saveGlobalSubagentSettings } from './global-settings.js';
+import { SUBAGENT_COMPLETION_CUSTOM_TYPE, parseSubagentCompletionContent } from './subagent-message.js';
+function record(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+}
+function text(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+function resultDetails(value) {
+    return record(record(value)?.details ?? null);
+}
+function resultOutput(value) {
+    const result = record(value);
+    const output = text(result?.output);
+    if (output)
+        return output;
+    const content = result?.content;
+    if (!Array.isArray(content))
+        return text(content);
+    const parts = content.flatMap((part) => {
+        const item = record(part);
+        return item?.type === 'text' && typeof item.text === 'string' ? [item.text] : [];
+    });
+    const combined = parts.join('\n').trim();
+    return combined || null;
+}
+function terminalStatus(value) {
+    return value === 'completed' ||
+        value === 'failed' ||
+        value === 'stopped' ||
+        value === 'interrupted'
+        ? value
+        : null;
+}
+export function projectSubagentStartMessage(input) {
+    if (input.message.kind !== 'tool')
+        return input.defaultProjection;
+    const argumentsValue = input.message.arguments;
+    const details = resultDetails(input.message.result);
+    const action = input.message.toolName === 'agent_resume' ? 'resume' : 'start';
+    const agentType = text(argumentsValue.subagent_type) ?? text(details?.agentType);
+    const resumeId = text(argumentsValue.agent_id);
+    const title = text(argumentsValue.description) ?? text(details?.title) ?? '子代理任务';
+    const prompt = text(argumentsValue.prompt);
+    return {
+        viewKey: 'subagent/start',
+        summary: {
+            action,
+            taskId: text(details?.taskId) ?? resumeId,
+            agentType,
+            title,
+            error: input.message.isError ? resultOutput(input.message.result) : null
+        },
+        detail: prompt ? { markdown: prompt } : null
+    };
+}
+export function projectSubagentReturnMessage(input) {
+    if (input.message.kind !== 'custom')
+        return input.defaultProjection;
+    const details = record(input.message.details);
+    const content = parseSubagentCompletionContent(input.message.content);
+    return {
+        viewKey: 'subagent/return',
+        summary: {
+            taskId: text(details?.taskId),
+            agentType: content.agentType,
+            title: content.title ?? '子代理任务',
+            status: terminalStatus(details?.status) ?? 'failed'
+        },
+        detail: content.result ? { markdown: content.result } : null
+    };
+}
+export function projectSubagentListMessage(input) {
+    if (input.message.kind !== 'tool')
+        return input.defaultProjection;
+    const details = resultDetails(input.message.result);
+    const agents = Array.isArray(details?.agents) ? details.agents : null;
+    const output = resultOutput(input.message.result);
+    return {
+        viewKey: 'subagent/list',
+        summary: {
+            query: text(input.message.arguments.agent_id),
+            agents,
+            error: input.message.isError ? output : null
+        },
+        detail: !agents && !input.message.isError && output ? { output } : null
+    };
+}
+export function projectSubagentControlMessage(input) {
+    if (input.message.kind !== 'tool')
+        return input.defaultProjection;
+    const details = resultDetails(input.message.result);
+    const action = input.message.toolName === 'agent_stop' ? 'stop' : 'steer';
+    const taskId = text(details?.taskId) ?? text(input.message.arguments.agent_id);
+    const output = resultOutput(input.message.result);
+    const prompt = text(input.message.arguments.prompt);
+    const preview = prompt ? Array.from(prompt.replace(/\s+/gu, ' ')) : null;
+    return {
+        viewKey: 'subagent/control',
+        summary: {
+            action,
+            taskId,
+            agentType: text(details?.agentType),
+            title: text(details?.title) ?? '子代理任务',
+            ...(action === 'steer'
+                ? {
+                    preview: preview
+                        ? preview.length > 160
+                            ? `${preview.slice(0, 159).join('')}…`
+                            : preview.join('')
+                        : null
+                }
+                : {}),
+            delivery: action === 'steer'
+                ? (text(details?.delivery) ?? (output?.startsWith('补充条件已排队') ? 'queued' : null))
+                : null,
+            error: input.message.isError ? output : null
+        },
+        detail: prompt ? { markdown: prompt } : null
+    };
+}
+export default definePiDeskPlugin({
+    name: 'subagent',
+    setup(plugin) {
+        plugin.registerMethod('settings-get', () => getGlobalSubagentSettings());
+        plugin.registerMethod('settings-save', (input) => saveGlobalSubagentSettings(input));
+        plugin.registerBrowserEntry('./dist/browser/entry.js');
+        plugin.declareCapabilities(async ({ signal }) => {
+            const workSessions = await plugin.host.workSessions.listWorkSessions();
+            return {
+                agents: {
+                    label: '子代理',
+                    options: collectSubagentCapabilityOptions(workSessions.map((session) => session.cwd), signal)
+                }
+            };
+        });
+        plugin.declareMessage('start', {
+            priority: 100,
+            match: (input) => input.message.kind === 'tool' &&
+                (input.message.toolName === 'agent' || input.message.toolName === 'agent_resume'),
+            project: projectSubagentStartMessage
+        });
+        plugin.declareMessage('list', {
+            priority: 100,
+            match: (input) => input.message.kind === 'tool' && input.message.toolName === 'agent_list',
+            project: projectSubagentListMessage
+        });
+        plugin.declareMessage('control', {
+            priority: 100,
+            match: (input) => input.message.kind === 'tool' &&
+                (input.message.toolName === 'agent_stop' || input.message.toolName === 'agent_steer'),
+            project: projectSubagentControlMessage
+        });
+        plugin.declareMessage('return', {
+            priority: 100,
+            match: (input) => input.message.kind === 'custom' &&
+                (input.message.customType === SUBAGENT_COMPLETION_CUSTOM_TYPE ||
+                    input.message.customType === 'pi-super-subagent:completion:v1'),
+            project: projectSubagentReturnMessage
+        });
+    }
+});

package/dist/research-runtime.d.ts

@@ -0,0 +1,23 @@
+import type { ExtensionFactory } from '@earendil-works/pi-coding-agent';
+import type { SubagentConfig } from './agent-config.js';
+export declare const RESEARCH_WORKER_AGENT_TYPE = "research-worker";
+export interface ResearchDelegateTask {
+    title: string;
+    prompt: string;
+}
+export type ResearchWorkerStatus = 'completed' | 'failed' | 'stopped' | 'interrupted';
+export interface ResearchWorkerOutcome {
+    taskId: string | null;
+    title: string;
+    status: ResearchWorkerStatus;
+    result: string | null;
+    error: string | null;
+    sessionFile: string | null;
+}
+export interface ResearchDelegateProgress {
+    completed: number;
+    total: number;
+}
+export type ResearchWorkerDelegate = (tasks: readonly ResearchDelegateTask[], signal: AbortSignal | undefined, onProgress: (progress: ResearchDelegateProgress) => void) => Promise<ResearchWorkerOutcome[]>;
+export declare function createResearchWorkerConfig(research: SubagentConfig): SubagentConfig;
+export declare function createResearchCoordinatorExtension(delegate: ResearchWorkerDelegate): ExtensionFactory;

package/dist/research-runtime.js

@@ -0,0 +1,101 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { Type } from 'typebox';
+export const RESEARCH_WORKER_AGENT_TYPE = 'research-worker';
+const RESEARCH_WORKER_PROMPT = readFileSync(fileURLToPath(new URL('../agents/internal/research-worker.md', import.meta.url)), 'utf8').trim();
+const RESEARCH_WORKER_TOOLS = new Set(['external_research', 'read', 'grep', 'find', 'ls']);
+const MAX_WORKER_RESULT_BYTES = 20_000;
+const MAX_DELEGATE_OUTPUT_BYTES = 50 * 1024;
+function requireText(value, field) {
+    const text = value.trim();
+    if (!text)
+        throw new Error(`${field} 不能为空`);
+    return text;
+}
+function truncateUtf8(value, maxBytes) {
+    const content = Buffer.from(value, 'utf8');
+    if (content.byteLength <= maxBytes)
+        return value;
+    let end = Math.max(0, maxBytes);
+    while (end > 0 && (content[end] & 0xc0) === 0x80)
+        end -= 1;
+    return content.subarray(0, end).toString('utf8');
+}
+function visibleWorkerResult(outcome, maxBytes) {
+    const body = outcome.result ?? outcome.error ?? '(没有结果)';
+    if (Buffer.byteLength(body, 'utf8') <= maxBytes)
+        return body;
+    const marker = `\n\n[结果已截断；完整 Conversation：${outcome.sessionFile ?? '未保存'}]`;
+    return `${truncateUtf8(body, Math.max(0, maxBytes - Buffer.byteLength(marker, 'utf8')))}${marker}`;
+}
+function formatOutcomes(outcomes) {
+    const completed = outcomes.filter((outcome) => outcome.status === 'completed').length;
+    const header = `Research Worker：${completed}/${outcomes.length} 完成\n\n`;
+    const perWorkerBytes = Math.min(MAX_WORKER_RESULT_BYTES, Math.max(256, Math.floor((MAX_DELEGATE_OUTPUT_BYTES - Buffer.byteLength(header)) / outcomes.length)));
+    const sections = outcomes.map((outcome) => `### [${outcome.title}] ${outcome.status}\n\n${visibleWorkerResult(outcome, perWorkerBytes)}`);
+    const content = `${header}${sections.join('\n\n---\n\n')}`;
+    if (Buffer.byteLength(content, 'utf8') <= MAX_DELEGATE_OUTPUT_BYTES)
+        return content;
+    const marker = '\n\n[聚合结果已截断；完整结果保留在各 Worker Conversation。]';
+    return `${truncateUtf8(content, MAX_DELEGATE_OUTPUT_BYTES - Buffer.byteLength(marker, 'utf8'))}${marker}`;
+}
+export function createResearchWorkerConfig(research) {
+    return {
+        name: RESEARCH_WORKER_AGENT_TYPE,
+        description: '执行 Root research 派发的单个独立外部研究轨道。',
+        tools: research.tools.filter((tool) => RESEARCH_WORKER_TOOLS.has(tool)),
+        model: research.model,
+        thinking: research.thinking,
+        systemPrompt: RESEARCH_WORKER_PROMPT
+    };
+}
+export function createResearchCoordinatorExtension(delegate) {
+    return (pi) => {
+        pi.registerTool({
+            name: 'research_delegate',
+            label: 'Research Delegate',
+            description: '将至少两个范围互不依赖的外部研究轨道并行交给叶子 Research Worker，并等待全部 Worker 进入终态。',
+            promptSnippet: '并行委派至少两个互不依赖的外部研究轨道，并等待全部结果。',
+            promptGuidelines: [
+                '研究对象未知的模糊需求先做表层探索，只获取候选清单和分片依据；发现至少两个独立对象或问题后再调用 research_delegate。',
+                '尽量拆分到一个 Worker 只负责一个明确对象或一个单一可交付问题；不要把可独立研究的多个对象打包给同一个 Worker，也不要机械切碎同一个不可分问题。',
+                'research_delegate 返回前 Root research 停止重复研究相同范围，并等待全部 Worker 进入终态。'
+            ],
+            parameters: Type.Object({
+                tasks: Type.Array(Type.Object({
+                    title: Type.String({ description: '任务中心展示的简短研究标题' }),
+                    prompt: Type.String({ description: '完整、自包含的单轨道研究任务' })
+                }), { minItems: 2, description: '至少两个互不依赖的研究轨道' })
+            }),
+            async execute(_toolCallId, params, signal, onUpdate) {
+                const tasks = params.tasks.map((task, index) => ({
+                    title: requireText(task.title, `tasks[${index}].title`),
+                    prompt: requireText(task.prompt, `tasks[${index}].prompt`)
+                }));
+                const outcomes = await delegate(tasks, signal, (progress) => {
+                    onUpdate?.({
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Research Worker：${progress.completed}/${progress.total} 已进入终态`
+                            }
+                        ],
+                        details: progress
+                    });
+                });
+                return {
+                    content: [{ type: 'text', text: formatOutcomes(outcomes) }],
+                    details: {
+                        version: 1,
+                        workers: outcomes.map((outcome) => ({
+                            taskId: outcome.taskId,
+                            title: outcome.title,
+                            status: outcome.status,
+                            sessionFile: outcome.sessionFile
+                        }))
+                    }
+                };
+            }
+        });
+    };
+}

package/dist/subagent-capabilities.d.ts

@@ -0,0 +1,18 @@
+import type { AgentSession, ExtensionAPI, ResourceLoader } from '@earendil-works/pi-coding-agent';
+import { type SessionCapabilityRules } from '@jetcrab/pi-desk-sdk/capabilities';
+/** Child sessions keep their role registry; a mode only filters its current view. */
+export declare class SubagentCapabilities {
+    private readonly rules;
+    private session;
+    private requested;
+    private appliedToolsRules;
+    private setTools;
+    private originalSetTools;
+    constructor(rules: () => SessionCapabilityRules);
+    extension(pi: ExtensionAPI): void;
+    resources(base: ResourceLoader, appendPrompt: () => string[]): ResourceLoader;
+    attach(session: AgentSession): void;
+    refresh(): void;
+    private applyTools;
+    private dispose;
+}

package/dist/subagent-capabilities.js

@@ -0,0 +1,83 @@
+import { isCapabilityAllowed } from '@jetcrab/pi-desk-sdk/capabilities';
+/** Child sessions keep their role registry; a mode only filters its current view. */
+export class SubagentCapabilities {
+    rules;
+    session = null;
+    requested = new Set();
+    // Current rules cannot distinguish a previously masked tool from an explicit deactivation.
+    appliedToolsRules = {};
+    setTools = null;
+    originalSetTools = null;
+    constructor(rules) {
+        this.rules = rules;
+    }
+    extension(pi) {
+        pi.on('tool_call', (event) => {
+            if (!isCapabilityAllowed(this.rules().tools, event.toolName)) {
+                return { block: true, reason: `当前能力模式不允许工具：${event.toolName}` };
+            }
+        });
+        pi.on('session_shutdown', () => this.dispose());
+    }
+    resources(base, appendPrompt) {
+        return new Proxy(base, {
+            get: (target, property) => {
+                if (property === 'getSkills') {
+                    return () => {
+                        const result = target.getSkills();
+                        return {
+                            ...result,
+                            skills: result.skills.filter((skill) => isCapabilityAllowed(this.rules().skills, skill.name))
+                        };
+                    };
+                }
+                if (property === 'getAppendSystemPrompt') {
+                    return () => [...target.getAppendSystemPrompt(), ...appendPrompt()];
+                }
+                const value = Reflect.get(target, property, target);
+                return typeof value === 'function' ? value.bind(target) : value;
+            }
+        });
+    }
+    attach(session) {
+        this.session = session;
+        this.requested = new Set(session.getActiveToolNames());
+        this.originalSetTools = session.setActiveToolsByName;
+        this.setTools = session.setActiveToolsByName.bind(session);
+        session.setActiveToolsByName = (names) => {
+            this.applyTools(names);
+        };
+        this.refresh();
+    }
+    refresh() {
+        if (this.session)
+            this.applyTools(this.session.getActiveToolNames());
+    }
+    applyTools(names) {
+        if (!this.session || !this.setTools)
+            return;
+        const registered = new Set(this.session
+            .getAllTools()
+            .filter((tool) => tool.exposure !== 'hidden')
+            .map((tool) => tool.name));
+        const masked = [...this.requested].filter((name) => registered.has(name) && !isCapabilityAllowed(this.appliedToolsRules, name));
+        const selected = new Set([...names, ...masked]);
+        this.requested = new Set([...this.requested, ...names].filter((name) => registered.has(name) && selected.has(name)));
+        const rules = this.rules().tools;
+        this.appliedToolsRules = {
+            allow: rules.allow ? [...rules.allow] : undefined,
+            deny: rules.deny ? [...rules.deny] : undefined
+        };
+        this.setTools([...this.requested].filter((name) => isCapabilityAllowed(rules, name)));
+    }
+    dispose() {
+        if (this.session && this.originalSetTools) {
+            this.session.setActiveToolsByName = this.originalSetTools;
+        }
+        this.session = null;
+        this.setTools = null;
+        this.originalSetTools = null;
+        this.requested.clear();
+        this.appliedToolsRules = {};
+    }
+}

package/dist/subagent-message.d.ts

@@ -0,0 +1,10 @@
+export declare const SUBAGENT_COMPLETION_CUSTOM_TYPE = "pi-desk-subagent:completion:v1";
+export declare const SUBAGENT_LAUNCH_STATE_CUSTOM_TYPE = "pi-desk-subagent:launch:v1";
+export declare const SUBAGENT_SHUTDOWN_STATE_CUSTOM_TYPE = "pi-desk-subagent:state:v1";
+export declare const SUBAGENT_RECORD_VERSION = 1;
+export interface SubagentCompletionContent {
+    agentType: string | null;
+    title: string | null;
+    result: string;
+}
+export declare function parseSubagentCompletionContent(content: string): SubagentCompletionContent;

package/dist/subagent-message.js

@@ -0,0 +1,24 @@
+export const SUBAGENT_COMPLETION_CUSTOM_TYPE = 'pi-desk-subagent:completion:v1';
+export const SUBAGENT_LAUNCH_STATE_CUSTOM_TYPE = 'pi-desk-subagent:launch:v1';
+export const SUBAGENT_SHUTDOWN_STATE_CUSTOM_TYPE = 'pi-desk-subagent:state:v1';
+export const SUBAGENT_RECORD_VERSION = 1;
+export function parseSubagentCompletionContent(content) {
+    const resultMarker = '\n\n结果:\n';
+    const markerIndex = content.indexOf(resultMarker);
+    const header = markerIndex >= 0 ? content.slice(0, markerIndex) : content;
+    const result = markerIndex >= 0 ? content.slice(markerIndex + resultMarker.length).trim() : '';
+    const lines = header.split('\n');
+    const agentType = lines
+        .find((line) => line.startsWith('类型: '))
+        ?.slice('类型: '.length)
+        .trim();
+    const title = lines
+        .find((line) => line.startsWith('任务: '))
+        ?.slice('任务: '.length)
+        .trim();
+    return {
+        agentType: agentType || null,
+        title: title || null,
+        result
+    };
+}

package/dist/subagent-runtime.d.ts

@@ -0,0 +1,93 @@
+import type { AgentSession } from '@earendil-works/pi-coding-agent';
+import { type ExtensionAPI, type ExtensionContext, type ExtensionFactory, type LoadExtensionsResult, ModelRuntime, SessionManager, type SessionEntry } from '@earendil-works/pi-coding-agent';
+import { type AssistantMessage } from '@earendil-works/pi-ai';
+import { type TaskHandle, type TaskStatus } from '@jetcrab/pi-desk-sdk';
+import { type SubagentConfig, type SubagentName } from './agent-config.js';
+import { type ResearchDelegateTask, type ResearchWorkerOutcome } from './research-runtime.js';
+export declare const CHILD_BOUNDARY = "# \u5B50\u4EE3\u7406\u8FB9\u754C\n\n- \u4F60\u662F\u7531\u9876\u5C42\u4E3B\u4F1A\u8BDD\u6D3E\u53D1\u4EFB\u52A1\u7684 child subagent\uFF0C\u53EA\u6267\u884C\u5F53\u524D\u4EFB\u52A1\u3002\n- \u4E0D\u542F\u52A8\u3001\u5EFA\u8BAE\u6216\u7F16\u6392\u5176\u4ED6\u5B50\u4EE3\u7406\u3002\n- \u53EA\u5728\u4EFB\u52A1\u6388\u6743\u8303\u56F4\u5185\u64CD\u4F5C\uFF1B\u9047\u5230\u672A\u6388\u6743\u7684\u4EA7\u54C1\u3001\u67B6\u6784\u6216\u8303\u56F4\u51B3\u7B56\u65F6\u505C\u6B62\u5E76\u5728\u7ED3\u679C\u4E2D\u8BF4\u660E\u3002\n- \u6700\u7EC8\u56DE\u590D\u9075\u5FAA\u5F53\u524D\u89D2\u8272\u7684\u8F93\u51FA\u8981\u6C42\uFF1B\u5F00\u53D1\u4EFB\u52A1\u8BF4\u660E\u5B8C\u6210\u5185\u5BB9\u3001\u4FEE\u6539\u6587\u4EF6\u548C\u9A8C\u8BC1\u60C5\u51B5\uFF0C\u53EA\u8BFB\u4EFB\u52A1\u76F4\u63A5\u8FD4\u56DE\u5206\u6790\u6216\u5BA1\u67E5\u7ED3\u679C\u3002";
+export declare const RESEARCH_COORDINATOR_BOUNDARY = "# \u5B50\u4EE3\u7406\u8FB9\u754C\n\n- \u4F60\u662F\u7531\u9876\u5C42\u4E3B\u4F1A\u8BDD\u6D3E\u53D1\u4EFB\u52A1\u7684 child subagent\uFF0C\u53EA\u6267\u884C\u5F53\u524D\u4EFB\u52A1\u3002\n- \u4EC5\u53EF\u901A\u8FC7 `research_delegate` \u542F\u52A8\u53F6\u5B50 Research Worker\uFF1B\u4E0D\u5F97\u4F7F\u7528\u6216\u6A21\u62DF\u901A\u7528 Agent \u59D4\u6D3E\u3002\n- \u53EA\u6709\u81F3\u5C11\u4E24\u4E2A\u8303\u56F4\u4E92\u4E0D\u4F9D\u8D56\u7684\u7814\u7A76\u8F68\u9053\u624D\u53EF\u59D4\u6D3E\uFF0CWorker \u6570\u91CF\u7531\u5B9E\u9645\u8303\u56F4\u51B3\u5B9A\u3002\n- \u8C03\u7528 `research_delegate` \u540E\u7B49\u5F85\u5168\u90E8 Worker \u7EC8\u6001\uFF0C\u4E0D\u5728\u7B49\u5F85\u671F\u95F4\u91CD\u590D\u7814\u7A76\u76F8\u540C\u8303\u56F4\u3002\n- \u53EA\u5728\u4EFB\u52A1\u6388\u6743\u8303\u56F4\u5185\u64CD\u4F5C\uFF1B\u9047\u5230\u672A\u6388\u6743\u7684\u4EA7\u54C1\u3001\u67B6\u6784\u6216\u8303\u56F4\u51B3\u7B56\u65F6\u505C\u6B62\u5E76\u5728\u7ED3\u679C\u4E2D\u8BF4\u660E\u3002\n- \u6700\u7EC8\u56DE\u590D\u9075\u5FAA\u5F53\u524D\u89D2\u8272\u7684\u8F93\u51FA\u8981\u6C42\uFF1B\u53EA\u8BFB\u4EFB\u52A1\u76F4\u63A5\u8FD4\u56DE\u7814\u7A76\u7ED3\u679C\u3002";
+export interface SubagentRecord {
+    taskId: string;
+    agentType: SubagentName;
+    title: string;
+    status: TaskStatus;
+    sessionFile: string;
+    startedAt: number;
+    endedAt: number | null;
+    session: AgentSession | null;
+    taskHandle: TaskHandle | null;
+    taskInfoUnsubscribe: (() => void) | null;
+    pendingSteers: string[];
+    steerReady: boolean;
+    stopRequested: boolean;
+    ownerTaskId: string | null;
+    notifyParent: boolean;
+    persistLifecycle: boolean;
+    resolveRun: ((outcome: ResearchWorkerOutcome) => void) | null;
+}
+export type SubagentParentContext = {
+    cwd: string;
+    sessionId: string;
+    sessionDir: string;
+    sessionFile?: string;
+    model: ExtensionContext['model'];
+    thinkingLevel: ExtensionContext['thinkingLevel'];
+    projectTrusted: boolean;
+};
+export declare function excludeSubagentPackageExtensions(result: LoadExtensionsResult, packageRoot?: string): LoadExtensionsResult;
+export declare function childAllowedTools(tools: readonly string[]): string[];
+export declare function restoreSubagentRecords(branch: readonly SessionEntry[]): Map<string, SubagentRecord>;
+export declare function normalizeRetryableAbortedAssistantMessage(message: AssistantMessage, stopRequested: boolean): AssistantMessage | undefined;
+export declare function createRetryCompatibilityExtension(isStopRequested: (sessionId: string) => boolean): ExtensionFactory;
+export declare class SubagentRuntime {
+    private readonly pi;
+    private readonly modelRuntime;
+    private readonly agentDir;
+    private readonly plugin;
+    private readonly records;
+    private readonly activeRuns;
+    private readonly pendingCreates;
+    private stopping;
+    private configs;
+    private capabilityRules;
+    private readonly childCapabilities;
+    private activeParent;
+    private sessionActive;
+    constructor(pi: ExtensionAPI, modelRuntime: ModelRuntime, agentDir?: string);
+    startSession(ctx: ExtensionContext): Promise<void>;
+    refreshConfigs(): void;
+    beforeTree(signal: AbortSignal): Promise<{
+        cancel: true;
+    } | undefined>;
+    shutdown(): Promise<void>;
+    private stopAndWait;
+    private registerTools;
+    private requireParent;
+    private requireText;
+    private resolveRecord;
+    private agentAllowed;
+    private resolveAgentConfig;
+    private createSessionManager;
+    private startRecord;
+    private startAgent;
+    private resumeAgent;
+    private steerAgent;
+    private stopAgent;
+    private requestStop;
+    private stopOwnedRecords;
+    private updateRootActivity;
+    private runDelegatedResearchWorker;
+    protected delegateResearchWorkers(ownerTaskId: string, tasks: readonly ResearchDelegateTask[], signal: AbortSignal | undefined, onProgress: (completed: number, total: number) => void): Promise<ResearchWorkerOutcome[]>;
+    private listAgents;
+    private createOwnedChildSession;
+    protected createChildSession(config: SubagentConfig, parent: SubagentParentContext, sessionManager: SessionManager): Promise<AgentSession>;
+    private resolveModel;
+    private launchRecord;
+    private flushPendingSteers;
+    private finishRun;
+    private finishRecord;
+    private notifyCompletion;
+    private makeLaunchDetails;
+    private makeTerminalDetails;
+}
+export declare function registerSubagentExtension(pi: ExtensionAPI): void;