@kooka/agent-sdk 0.1.3 → 0.1.5

package/README.md

@@ -111,11 +111,11 @@ import { createLingyunAgent, type ToolDefinition } from '@kooka/agent-sdk';
 const { agent, registry } = createLingyunAgent({ /* ... */ });
 
 const timeTool: ToolDefinition = {
-  id: 'time.now',
-  name: 'time.now',
+  id: 'time_now',
+  name: 'time_now',
   description: 'Get the current time as an ISO string.',
   parameters: { type: 'object', properties: {} },
-  execution: { type: 'function', handler: 'time.now' },
+  execution: { type: 'function', handler: 'time_now' },
   metadata: { readOnly: true },
 };
 
@@ -162,7 +162,7 @@ Useful event types:
 
 - `assistant_token`: user-facing assistant text (with `<think>` and tool-call markers removed)
 - `thought_token`: model “thinking” tokens (only if the provider emits them)
-- `notice`: user-facing notices from the runtime (e.g. unknown `$skill-name`)
+- `notice`: user-facing notices from the runtime (e.g. subagent model fallback warnings)
 - `tool_call` / `tool_result` / `tool_blocked`: tool lifecycle
 - `compaction_start` / `compaction_end`: context overflow mitigation
 
@@ -188,7 +188,7 @@ If a user message includes `$<skill-name>`, LingYun:
 1. Looks up the skill by `name:` in discovered `SKILL.md` files
 2. Injects the skill body as a synthetic `<skill>...</skill>` user message before calling the model
 
-Unknown skills are ignored and emitted as `notice` events (`callbacks.onNotice`).
+Unknown skills are ignored.
 
 Configure discovery/injection via `tools.builtinOptions.skills`:
 
@@ -233,7 +233,7 @@ const { registry } = createLingyunAgent({
 
 registry.registerTool(
   {
-    id: 'demo.echo',
+    id: 'demo_echo',
     name: 'Echo',
     description: 'Echo back the message argument',
     parameters: {
@@ -241,7 +241,7 @@ registry.registerTool(
       properties: { message: { type: 'string' } },
       required: ['message'],
     },
-    execution: { type: 'function', handler: 'demo.echo' },
+    execution: { type: 'function', handler: 'demo_echo' },
     metadata: { requiresApproval: false, permission: 'read', readOnly: true },
   },
   async (args) => ({ success: true, data: `Echo: ${String(args.message ?? '')}` })
@@ -276,9 +276,9 @@ registerAgentBrowserTools(registry, {
 ```
 
 Tools:
-- `browser.startSession` / `browser.closeSession`
-- `browser.snapshot` (read-only; returns accessibility tree with refs like `@e2`)
-- `browser.run` (requires approval; runs click/fill/type/wait/get/screenshot/pdf/trace actions)
+- `browser_start_session` / `browser_close_session`
+- `browser_snapshot` (read-only; returns accessibility tree with refs like `@e2`)
+- `browser_run` (requires approval; runs click/fill/type/wait/get/screenshot/pdf/trace actions)
 
 Security defaults:
 - HTTPS-only and blocks private hosts / IPs by default

package/dist/agent/agent.d.ts

@@ -6,11 +6,15 @@ export declare class LingyunSession {
     history: AgentHistoryMessage[];
     pendingPlan?: string;
     sessionId?: string;
+    parentSessionId?: string;
+    subagentType?: string;
+    modelId?: string;
+    mentionedSkills: string[];
     fileHandles?: {
         nextId: number;
         byId: Record<string, string>;
     };
-    constructor(init?: Partial<Pick<LingyunSession, 'history' | 'pendingPlan' | 'sessionId' | 'fileHandles'>>);
+    constructor(init?: Partial<Pick<LingyunSession, 'history' | 'pendingPlan' | 'sessionId' | 'parentSessionId' | 'subagentType' | 'modelId' | 'mentionedSkills' | 'fileHandles'>>);
     getHistory(): AgentHistoryMessage[];
 }
 export type LingyunAgentRuntimeOptions = {
@@ -39,6 +43,8 @@ export declare class LingyunAgent {
     private readonly modelLimits?;
     private readonly compactionConfig;
     private registeredPluginTools;
+    private readonly taskSessions;
+    private readonly maxTaskSessions;
     constructor(llm: LLMProvider, config: AgentConfig, registry: ToolRegistry, runtime?: LingyunAgentRuntimeOptions);
     updateConfig(config: Partial<AgentConfig>): void;
     setAllowExternalPaths(allow: boolean): void;

package/dist/agent/agent.d.ts.map

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

package/dist/agent/agent.js

@@ -1,7 +1,7 @@
 import * as path from 'path';
 import { convertToModelMessages, extractReasoningMiddleware, jsonSchema, streamText, tool as aiTool, wrapLanguageModel, } from 'ai';
 import { combineAbortSignals } from '../abort.js';
-import { COMPACTION_AUTO_CONTINUE_TEXT, COMPACTION_MARKER_TEXT, COMPACTION_PROMPT_TEXT, COMPACTION_SYSTEM_PROMPT, createAssistantHistoryMessage, createHistoryForCompactionPrompt, createHistoryForModel, createUserHistoryMessage, evaluatePermission, evaluateShellCommand, extractSkillMentions, extractUsageTokens, finalizeStreamingParts, findExternalPathReferencesInShellCommand, getEffectiveHistory, getMessageText, getReservedOutputTokens, isOverflow as isContextOverflow, isPathInsideWorkspace, markPreviousAssistantToolOutputs, redactFsPathForPrompt, renderSkillsSectionForPrompt, selectSkillsForText, setDynamicToolError, setDynamicToolOutput, upsertDynamicToolCall, } from '@kooka/core';
+import { COMPACTION_AUTO_CONTINUE_TEXT, COMPACTION_MARKER_TEXT, COMPACTION_PROMPT_TEXT, COMPACTION_SYSTEM_PROMPT, createAssistantHistoryMessage, applyAssistantReplayForPrompt, applyCopilotImageInputPattern, applyOpenAICompatibleReasoningField, createHistoryForCompactionPrompt, createHistoryForModel, createUserHistoryMessage, evaluatePermission, evaluateShellCommand, extractSkillMentions, extractUsageTokens, finalizeStreamingParts, findExternalPathReferencesInShellCommand, getEffectiveHistory, getMessageText, getReservedOutputTokens, isOverflow as isContextOverflow, isPathInsideWorkspace, listBuiltinSubagents, normalizeSessionId, markPreviousAssistantToolOutputs, redactFsPathForPrompt, renderSkillsSectionForPrompt, requireString, resolveBuiltinSubagent, selectSkillsForText, setDynamicToolError, setDynamicToolOutput, upsertDynamicToolCall, } from '@kooka/core';
 import { PluginManager } from '../plugins/pluginManager.js';
 import { insertModeReminders } from './reminders.js';
 import { DEFAULT_SYSTEM_PROMPT } from './prompts.js';
@@ -107,6 +107,10 @@ export class LingyunSession {
     history = [];
     pendingPlan;
     sessionId;
+    parentSessionId;
+    subagentType;
+    modelId;
+    mentionedSkills = [];
     fileHandles;
     constructor(init) {
         if (init?.history)
@@ -115,6 +119,14 @@ export class LingyunSession {
             this.pendingPlan = init.pendingPlan;
         if (init?.sessionId)
             this.sessionId = init.sessionId;
+        if (init?.parentSessionId)
+            this.parentSessionId = init.parentSessionId;
+        if (init?.subagentType)
+            this.subagentType = init.subagentType;
+        if (init?.modelId)
+            this.modelId = init.modelId;
+        if (init?.mentionedSkills)
+            this.mentionedSkills = [...init.mentionedSkills];
         if (init?.fileHandles)
             this.fileHandles = init.fileHandles;
     }
@@ -134,6 +146,8 @@ export class LingyunAgent {
     modelLimits;
     compactionConfig;
     registeredPluginTools = new Set();
+    taskSessions = new Map();
+    maxTaskSessions = 50;
     constructor(llm, config, registry, runtime) {
         this.llm = llm;
         this.config = config;
@@ -335,11 +349,16 @@ export class LingyunAgent {
     async toModelMessages(session, tools, modelId) {
         const effective = getEffectiveHistory(session.history);
         const prepared = createHistoryForModel(effective);
-        const reminded = insertModeReminders(prepared, this.getMode());
+        const reminded = insertModeReminders(prepared, this.getMode(), { allowExternalPaths: this.allowExternalPaths });
         const withoutIds = reminded.map(({ id: _id, ...rest }) => rest);
         const messagesOutput = await this.plugins.trigger('experimental.chat.messages.transform', { sessionId: session.sessionId ?? this.config.sessionId, mode: this.getMode(), modelId }, { messages: [...withoutIds] });
         const messages = Array.isArray(messagesOutput.messages) ? messagesOutput.messages : withoutIds;
-        return convertToModelMessages(messages, { tools: tools });
+        const replayed = this.llm.id === 'openaiCompatible'
+            ? applyAssistantReplayForPrompt(messages)
+            : messages;
+        const converted = await convertToModelMessages(replayed, { tools: tools });
+        const withReasoning = this.llm.id === 'openaiCompatible' ? applyOpenAICompatibleReasoningField(converted) : converted;
+        return this.llm.id === 'copilot' ? applyCopilotImageInputPattern(withReasoning) : withReasoning;
     }
     createToolContext(signal, session, callbacks) {
         return {
@@ -504,6 +523,213 @@ export class LingyunAgent {
         for (const def of tools) {
             const toolName = def.id;
             toolNameToDefinition.set(toolName, def);
+            if (toolName === 'task') {
+                out[toolName] = aiTool({
+                    id: toolName,
+                    description: def.description,
+                    inputSchema: jsonSchema(def.parameters),
+                    execute: async (args, options) => {
+                        const resolvedArgs = args ?? {};
+                        if (session.parentSessionId || session.subagentType) {
+                            return {
+                                success: false,
+                                error: 'Subagents cannot spawn other subagents via task.',
+                                metadata: { errorType: 'task_recursion_denied' },
+                            };
+                        }
+                        const parentMode = this.getMode();
+                        const descriptionResult = requireString(resolvedArgs, 'description');
+                        if ('error' in descriptionResult)
+                            return { success: false, error: descriptionResult.error };
+                        const promptResult = requireString(resolvedArgs, 'prompt');
+                        if ('error' in promptResult)
+                            return { success: false, error: promptResult.error };
+                        const typeResult = requireString(resolvedArgs, 'subagent_type');
+                        if ('error' in typeResult)
+                            return { success: false, error: typeResult.error };
+                        const subagentTypeRaw = typeResult.value.trim();
+                        const subagent = resolveBuiltinSubagent(subagentTypeRaw);
+                        if (!subagent) {
+                            const names = listBuiltinSubagents().map((a) => a.name).join(', ');
+                            return {
+                                success: false,
+                                error: `Unknown subagent_type: ${subagentTypeRaw}. Available: ${names || '(none)'}`,
+                                metadata: { errorType: 'unknown_subagent_type', subagentType: subagentTypeRaw },
+                            };
+                        }
+                        if (parentMode === 'plan' && subagent.name !== 'explore') {
+                            return {
+                                success: false,
+                                error: 'Only the explore subagent is allowed in Plan mode.',
+                                metadata: { errorType: 'subagent_denied_in_plan', subagentType: subagent.name },
+                            };
+                        }
+                        const sessionIdRaw = typeof resolvedArgs.session_id === 'string' && resolvedArgs.session_id.trim()
+                            ? String(resolvedArgs.session_id).trim()
+                            : '';
+                        const parentSessionId = session.sessionId ?? this.config.sessionId;
+                        const requestedSessionId = normalizeSessionId(sessionIdRaw) || '';
+                        const childSessionId = requestedSessionId || crypto.randomUUID();
+                        const existing = this.taskSessions.get(childSessionId);
+                        const childSession = existing ??
+                            new LingyunSession({
+                                sessionId: childSessionId,
+                                parentSessionId,
+                                subagentType: subagent.name,
+                            });
+                        if (!existing) {
+                            this.taskSessions.set(childSessionId, childSession);
+                            while (this.taskSessions.size > this.maxTaskSessions) {
+                                const oldestKey = this.taskSessions.keys().next().value;
+                                if (!oldestKey)
+                                    break;
+                                if (oldestKey === childSessionId)
+                                    break;
+                                this.taskSessions.delete(oldestKey);
+                            }
+                        }
+                        else {
+                            childSession.parentSessionId = parentSessionId;
+                            childSession.subagentType = subagent.name;
+                            // Refresh LRU order.
+                            this.taskSessions.delete(childSessionId);
+                            this.taskSessions.set(childSessionId, childSession);
+                        }
+                        const parentModelId = this.config.model;
+                        if (!parentModelId) {
+                            return {
+                                success: false,
+                                error: 'No model configured. Set AgentConfig.model.',
+                                metadata: { errorType: 'missing_model' },
+                            };
+                        }
+                        const configuredSubagentModel = typeof this.config.subagentModel === 'string' ? this.config.subagentModel.trim() : '';
+                        const desiredChildModelId = childSession.modelId || configuredSubagentModel || parentModelId;
+                        let childModelId = parentModelId;
+                        let childModelWarning;
+                        if (desiredChildModelId !== parentModelId) {
+                            try {
+                                await this.llm.getModel(desiredChildModelId);
+                                childModelId = desiredChildModelId;
+                            }
+                            catch (error) {
+                                childModelWarning =
+                                    `Subagent model "${desiredChildModelId}" is unavailable; ` +
+                                        `using parent model "${parentModelId}".`;
+                                callbacks?.onNotice?.({ level: 'warning', message: childModelWarning });
+                                callbacks?.onDebug?.(`[Task] subagent model fallback requested=${desiredChildModelId} using=${parentModelId} error=${error instanceof Error ? error.message : String(error)}`);
+                                childModelId = parentModelId;
+                            }
+                        }
+                        childSession.modelId = childModelId;
+                        const basePrompt = this.config.systemPrompt || DEFAULT_SYSTEM_PROMPT;
+                        const subagentConfig = {
+                            model: childModelId,
+                            mode: 'build',
+                            temperature: this.config.temperature,
+                            maxRetries: this.config.maxRetries,
+                            maxOutputTokens: this.config.maxOutputTokens,
+                            autoApprove: this.config.autoApprove,
+                            toolFilter: subagent.toolFilter?.length ? subagent.toolFilter : undefined,
+                            systemPrompt: `${basePrompt}\n\n${subagent.prompt}`,
+                            sessionId: childSessionId,
+                        };
+                        const subagentRunner = new LingyunAgent(this.llm, subagentConfig, this.registry, {
+                            plugins: this.plugins,
+                            workspaceRoot: this.workspaceRoot,
+                            allowExternalPaths: this.allowExternalPaths,
+                            skills: this.skillsConfig,
+                            modelLimits: this.modelLimits,
+                            compaction: this.compactionConfig,
+                        });
+                        const toolSummary = new Map();
+                        const childCallbacks = {
+                            onRequestApproval: callbacks?.onRequestApproval,
+                            onToolCall: (tool, definition) => {
+                                toolSummary.set(tool.id, { id: tool.id, tool: definition.id, status: 'running' });
+                            },
+                            onToolResult: (tool, result) => {
+                                const prev = toolSummary.get(tool.id);
+                                const nextStatus = result.success ? 'success' : 'error';
+                                toolSummary.set(tool.id, {
+                                    id: tool.id,
+                                    tool: prev?.tool ?? tool.function.name,
+                                    status: nextStatus,
+                                });
+                            },
+                        };
+                        try {
+                            const run = subagentRunner.run({
+                                session: childSession,
+                                input: promptResult.value,
+                                callbacks: childCallbacks,
+                                signal: options.abortSignal,
+                            });
+                            const drain = (async () => {
+                                for await (const _event of run.events) {
+                                    // drain
+                                }
+                            })();
+                            const done = await run.done;
+                            await drain;
+                            const text = done.text || '';
+                            const outputText = text.trimEnd() +
+                                '\n\n' +
+                                ['<task_metadata>', `session_id: ${childSessionId}`, '</task_metadata>'].join('\n');
+                            const summary = [...toolSummary.values()].sort((a, b) => a.id.localeCompare(b.id));
+                            return {
+                                success: true,
+                                data: {
+                                    session_id: childSessionId,
+                                    subagent_type: subagent.name,
+                                    text,
+                                },
+                                metadata: {
+                                    title: descriptionResult.value,
+                                    outputText,
+                                    task: {
+                                        description: descriptionResult.value,
+                                        subagent_type: subagent.name,
+                                        session_id: childSessionId,
+                                        parent_session_id: parentSessionId,
+                                        summary,
+                                        model_id: childModelId,
+                                        ...(childModelWarning
+                                            ? { model_warning: childModelWarning, requested_model_id: desiredChildModelId }
+                                            : {}),
+                                    },
+                                    childSession: {
+                                        sessionId: childSessionId,
+                                        parentSessionId,
+                                        subagentType: subagent.name,
+                                        modelId: childModelId,
+                                        history: childSession.getHistory(),
+                                        pendingPlan: childSession.pendingPlan,
+                                        fileHandles: childSession.fileHandles,
+                                    },
+                                },
+                            };
+                        }
+                        catch (error) {
+                            return {
+                                success: false,
+                                error: error instanceof Error ? error.message : String(error),
+                                metadata: { errorType: 'task_subagent_failed' },
+                            };
+                        }
+                        finally {
+                            // Avoid leaking subagent's temporary skill injection messages to later turns.
+                            childSession.history = childSession.history.filter((msg) => !(msg.role === 'user' && msg.metadata?.skill));
+                        }
+                    },
+                    toModelOutput: async (options) => {
+                        const output = options.output;
+                        const content = await this.formatToolResult(output, def.name);
+                        return { type: 'text', value: content };
+                    },
+                });
+                continue;
+            }
             out[toolName] = aiTool({
                 id: toolName,
                 description: def.description,
@@ -768,7 +994,10 @@ export class LingyunAgent {
             const prepared = createHistoryForCompactionPrompt(effective, this.compactionConfig);
             const withoutIds = prepared.map(({ id: _id, ...rest }) => rest);
             const compactionUser = createUserHistoryMessage(promptText, { synthetic: true });
-            const compactionModelMessages = await convertToModelMessages([...withoutIds, compactionUser], { tools: {} });
+            const convertedCompactionModelMessages = await convertToModelMessages([...withoutIds, compactionUser], { tools: {} });
+            const compactionModelMessages = this.llm.id === 'copilot'
+                ? applyCopilotImageInputPattern(convertedCompactionModelMessages)
+                : convertedCompactionModelMessages;
             const stream = streamText({
                 model: compactionModel,
                 system: COMPACTION_SYSTEM_PROMPT,
@@ -929,7 +1158,16 @@ export class LingyunAgent {
                                 const toolCallId = String(part.toolCallId);
                                 const def = toolNameToDefinition.get(toolName);
                                 const toolLabel = def?.name || toolName;
-                                const output = await this.pruneToolResultForHistory(part.output, toolLabel);
+                                const rawOutput = part.output;
+                                let output = await this.pruneToolResultForHistory(rawOutput, toolLabel);
+                                const isTaskTool = def?.id === 'task' || toolName === 'task';
+                                if (isTaskTool && output.metadata && typeof output.metadata === 'object') {
+                                    // Do not persist child session snapshots inside the parent session history.
+                                    const meta = { ...output.metadata };
+                                    delete meta.childSession;
+                                    delete meta.task;
+                                    output = { ...output, metadata: meta };
+                                }
                                 setDynamicToolOutput(assistantMessage, {
                                     toolName,
                                     toolCallId,
@@ -937,7 +1175,12 @@ export class LingyunAgent {
                                     output,
                                 });
                                 const tc = toToolCall(toolCallId, toolName, part.input);
-                                callbacksSafe?.onToolResult?.(tc, output);
+                                if (isTaskTool && rawOutput && typeof rawOutput === 'object' && typeof rawOutput.success === 'boolean') {
+                                    callbacksSafe?.onToolResult?.(tc, rawOutput);
+                                }
+                                else {
+                                    callbacksSafe?.onToolResult?.(tc, output);
+                                }
                                 callbacksSafe?.onStatusChange?.({ type: 'running', message: '' });
                                 break;
                             }
@@ -992,6 +1235,7 @@ export class LingyunAgent {
             assistantMessage.metadata = {
                 mode: this.getMode(),
                 finishReason: streamFinishReason,
+                replay: { text: attemptText, reasoning: attemptReasoning },
                 ...(tokens ? { tokens } : {}),
             };
             const cleanedText = stripToolBlocks(stripThinkBlocks(attemptText)).trim();
@@ -1004,6 +1248,9 @@ export class LingyunAgent {
             if (finalText) {
                 assistantMessage.parts.unshift({ type: 'text', text: finalText, state: 'streaming' });
             }
+            if (attemptReasoning.trim()) {
+                assistantMessage.parts.unshift({ type: 'reasoning', text: attemptReasoning, state: 'streaming' });
+            }
             finalizeStreamingParts(assistantMessage);
             session.history.push(assistantMessage);
             const lastAssistantText = getMessageText(assistantMessage).trim();
@@ -1048,19 +1295,7 @@ export class LingyunAgent {
             allowExternalPaths: this.allowExternalPaths,
             signal,
         });
-        const { selected, unknown } = selectSkillsForText(text, index);
-        if (unknown.length > 0) {
-            const availableSample = index.skills
-                .map((s) => s.name)
-                .slice(0, 20);
-            const availableLabel = availableSample.length > 0
-                ? ` Available: ${availableSample.map((n) => `$${n}`).join(', ')}${index.skills.length > availableSample.length ? ', ...' : ''}`
-                : '';
-            callbacks?.onNotice?.({
-                level: 'warning',
-                message: `Unknown skills: ${unknown.map((n) => `$${n}`).join(', ')}.${availableLabel}`,
-            });
-        }
+        const { selected } = selectSkillsForText(text, index);
         if (selected.length === 0)
             return;
         const maxSkills = this.skillsConfig.maxInjectSkills;
@@ -1080,6 +1315,9 @@ export class LingyunAgent {
         for (const skill of selectedForInject) {
             if (signal?.aborted)
                 break;
+            if (!session.mentionedSkills.includes(skill.name)) {
+                session.mentionedSkills.push(skill.name);
+            }
             let body;
             try {
                 body = (await loadSkillFile(skill)).content;