@zhin.js/agent 1.1.2 → 1.1.5

package/lib/plugin-runtime/deferred-capability-plan.js

@@ -0,0 +1,152 @@
+import { addSkillToSnapshot, getLoadedToolNamesFromSnapshot, touchToolInSnapshot, } from '@zhin.js/ai';
+import { toolInputSchemaToParameters } from '@zhin.js/core/tool-zod';
+import { buildDeferredStats, buildToolCatalog, discoverInCatalog, resolveDeferredApiTools } from '../tool-catalog/tool-catalog.js';
+import { resolveDeferredToolsConfig } from '../tool-catalog/resolve-config.js';
+import { DEFERRED_META_TOOL_NAMES } from '../tool-catalog/types.js';
+/**
+ * Turn-owned deferred capability authority. It has no filesystem, registry,
+ * AsyncLocalStorage, or classic Tool dependency: everything comes from the
+ * immutable generation projection and the session snapshot.
+ */
+export function createDeferredCapabilityPlan(options) {
+    const config = resolveDeferredToolsConfig(options.config);
+    const alwaysLoaded = new Set(config.alwaysLoadedTools);
+    const baseCapabilities = options.capabilities.tools.filter((tool) => !DEFERRED_META_TOOL_NAMES.has(tool.name));
+    const baseTools = baseCapabilities.map(capabilityAsAgentTool);
+    const baseCatalog = buildToolCatalog({ tools: baseTools, alwaysLoaded });
+    let snapshot = structuredClone(options.sessionSnapshot);
+    const persist = async (next) => {
+        snapshot = next;
+        await options.persistSnapshot(structuredClone(snapshot));
+    };
+    const metaCapabilities = createMetaCapabilities({
+        owner: options.capabilities.owner,
+        catalog: baseCatalog,
+        skills: options.capabilities.skills,
+        platform: options.platform,
+        topK: config.discoverTopK,
+        maxLoaded: config.maxLoadedPerSession,
+        getSnapshot: () => snapshot,
+        persist,
+    });
+    const capabilities = Object.freeze([...baseCapabilities, ...metaCapabilities]);
+    const allTools = capabilities.map(capabilityAsAgentTool);
+    const catalog = buildToolCatalog({ tools: allTools, alwaysLoaded });
+    const controller = Object.freeze({
+        loadedToolNames: () => getLoadedToolNamesFromSnapshot(snapshot),
+        loadedSkillInstructions: () => loadedSkillInstructions(options.capabilities.skills, snapshot),
+    });
+    const resolvedTools = resolveDeferredApiTools(catalog, alwaysLoaded, controller.loadedToolNames());
+    return Object.freeze({
+        capabilities,
+        allTools: Object.freeze(allTools),
+        resolvedTools: Object.freeze(resolvedTools),
+        catalog: Object.freeze(catalog),
+        deferredStats: buildDeferredStats(catalog, resolvedTools),
+        controller,
+    });
+}
+function capabilityAsAgentTool(tool) {
+    const parameters = toolInputSchemaToParameters(tool.inputSchema);
+    return Object.freeze({
+        name: tool.name,
+        description: tool.description,
+        parameters: {
+            type: 'object',
+            properties: parameters.properties ?? {},
+            ...(parameters.required?.length ? { required: parameters.required } : {}),
+        },
+        source: tool.source,
+        permissions: tool.permissions,
+        approval: tool.approval,
+        execute: async () => {
+            throw new Error(`AgentCore must execute capability ${tool.name} through ToolExecutionAuthority`);
+        },
+    });
+}
+function createMetaCapabilities(options) {
+    const byName = new Map(options.catalog.map((item) => [item.name, item]));
+    return Object.freeze([
+        metaCapability(options.owner, 'discover', 'Search deferred tools and skills by intent.', {
+            type: 'object',
+            properties: {
+                query: { type: 'string' },
+                kind: { type: 'string', enum: ['tool', 'skill', 'all'] },
+            },
+        }, async (raw) => {
+            const input = recordOf(raw);
+            const query = typeof input.query === 'string' ? input.query.trim() : '';
+            const kind = input.kind === 'tool' || input.kind === 'skill' ? input.kind : 'all';
+            const tools = kind === 'skill' ? [] : discoverInCatalog({
+                query,
+                kind: 'tool',
+                topK: options.topK,
+                platform: options.platform,
+                skillRegistry: null,
+                catalog: [...options.catalog],
+            });
+            const skills = kind === 'tool' ? [] : discoverSkills(options.skills, query, options.topK);
+            const rows = [...tools, ...skills];
+            return rows.length > 0
+                ? rows.map((item) => `- [${item.kind}] ${item.name}: ${item.brief}`).join('\n')
+                : 'No matches.';
+        }),
+        metaCapability(options.owner, 'load_tool', 'Load a deferred tool schema into this session.', {
+            type: 'object',
+            properties: { name: { type: 'string' } },
+            required: ['name'],
+        }, async (raw) => {
+            const name = String(recordOf(raw).name ?? '');
+            const item = byName.get(name);
+            if (!item)
+                return `Tool "${name}" not found in catalog.`;
+            await options.persist(touchToolInSnapshot(options.getSnapshot(), name, options.maxLoaded));
+            return `Loaded tool "${name}".\nParameters schema:\n${JSON.stringify(item.fullTool.parameters, null, 2)}\n__zhin_tools_mutated__`;
+        }),
+        metaCapability(options.owner, 'load_skill', 'Load projected skill instructions into this session.', {
+            type: 'object',
+            properties: { name: { type: 'string' } },
+            required: ['name'],
+        }, async (raw) => {
+            const name = String(recordOf(raw).name ?? '');
+            const skill = resolveSkill(options.skills, name);
+            if (!skill)
+                return `Skill '${name}' not found in the active generation.`;
+            await options.persist(addSkillToSnapshot(options.getSnapshot(), skill.qualifiedName));
+            return `${skill.instructions}\n__zhin_tools_mutated__`;
+        }),
+    ]);
+}
+function metaCapability(owner, name, description, inputSchema, execute) {
+    return Object.freeze({
+        owner,
+        name,
+        qualifiedName: name,
+        description,
+        inputSchema,
+        approval: 'never',
+        source: 'builtin:agent-runtime',
+        execute: (input, context) => execute(input, context),
+    });
+}
+function discoverSkills(skills, query, topK) {
+    const needle = query.toLocaleLowerCase();
+    return skills
+        .filter((skill) => !needle || `${skill.qualifiedName} ${skill.description}`.toLocaleLowerCase().includes(needle))
+        .slice(0, topK)
+        .map((skill) => ({ kind: 'skill', name: skill.qualifiedName, brief: skill.description }));
+}
+function resolveSkill(skills, name) {
+    const matches = skills.filter((skill) => skill.qualifiedName === name || skill.name === name);
+    return matches.length === 1 ? matches[0] : undefined;
+}
+function loadedSkillInstructions(skills, snapshot) {
+    const loaded = new Set(snapshot.loadedSkills);
+    return skills
+        .filter((skill) => loaded.has(skill.qualifiedName) || loaded.has(skill.name))
+        .map((skill) => skill.instructions);
+}
+function recordOf(value) {
+    return value && typeof value === 'object' ? value : {};
+}
+//# sourceMappingURL=deferred-capability-plan.js.map

package/lib/plugin-runtime/deferred-capability-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-capability-plan.js","sourceRoot":"","sources":["../../src/plugin-runtime/deferred-capability-plan.ts"],"names":[],"mappings":"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"}

package/lib/plugin-runtime/full-agent-turn-engine.d.ts

@@ -0,0 +1,17 @@
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+import type { PluginAILoopHookRegistry } from '../plugin-loop-hooks.js';
+import type { AgentCore } from '../core/agent-core.js';
+import type { ContextSystem } from '../context/context-system.js';
+import type { SessionSystem } from '../session/session-system.js';
+import type { AgentTurnEngine } from './agent-runtime.js';
+export interface FullAgentTurnEngineOptions {
+    readonly host: ZhinAgentPrivate;
+    readonly core: AgentCore;
+    readonly sessionSystem: SessionSystem;
+    readonly contextSystem: ContextSystem;
+    readonly loopHooks?: PluginAILoopHookRegistry;
+    readonly bootstrapContext?: string;
+}
+/** Generation-owned adapter from canonical TurnIngress to the one full AgentCore. */
+export declare function createFullAgentTurnEngine(options: FullAgentTurnEngineOptions): AgentTurnEngine;
+//# sourceMappingURL=full-agent-turn-engine.d.ts.map

package/lib/plugin-runtime/full-agent-turn-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-agent-turn-engine.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/full-agent-turn-engine.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,eAAe,CAI9F"}

package/lib/plugin-runtime/full-agent-turn-engine.js

@@ -0,0 +1,174 @@
+import { applyInboundMediaInjection, resolveTurnMediaInjection } from '../turn/inbound-media.js';
+import { isTurnTerminalEvent } from '../event/turn-event.js';
+import { turnToolExecutionAuthority, TurnToolRuntime } from '../tool/turn-tool-runtime.js';
+import { createDeferredCapabilityPlan } from './deferred-capability-plan.js';
+/** Generation-owned adapter from canonical TurnIngress to the one full AgentCore. */
+export function createFullAgentTurnEngine(options) {
+    return Object.freeze({
+        run: (context) => runFullAgentTurn(options, context),
+    });
+}
+async function* runFullAgentTurn(options, context) {
+    const { host, sessionSystem, contextSystem } = options;
+    const prep = await sessionSystem.prepareIngressTurn(host, context.turn);
+    const rate = host.rateLimiter.check(prep.userId);
+    if (!rate.allowed) {
+        const text = rate.message || '请稍后再试';
+        const end = terminal(text, zeroUsage());
+        yield end;
+        return {
+            project: async () => {
+                await sessionSystem.touchAfterTurn(host, prep.sessionId);
+                if (context.turn.ports.reply)
+                    await context.turn.ports.reply.send(end.output);
+            },
+        };
+    }
+    const snapshot = await host.contextRepository.getDeferredToolSnapshot(prep.sessionId);
+    const projected = {
+        ...context.capabilities,
+        tools: context.toolCapabilities,
+    };
+    const plan = createDeferredCapabilityPlan({
+        capabilities: projected,
+        sessionSnapshot: snapshot,
+        config: host.config,
+        platform: context.turn.origin.kind === 'im' ? context.turn.origin.platform : undefined,
+        persistSnapshot: (next) => host.contextRepository.setDeferredToolSnapshot(prep.sessionId, next),
+    });
+    const activeSkillsContext = plan.controller.loadedSkillInstructions().join('\n\n');
+    const media = await resolveTurnMediaInjection(context.turn.input.media);
+    const prompt = await contextSystem.buildTextTurnContext({
+        host,
+        turn: context.turn,
+        content: prep.turnUser.rawContent,
+        turnUser: prep.turnUser,
+        deferredStats: plan.deferredStats,
+        mode: media.blocks.length > 0 ? 'vision' : undefined,
+        activeSkillsContext,
+    });
+    const userMessages = applyInboundMediaInjection(prompt.userMessages, media);
+    const toolRuntime = new TurnToolRuntime(context.turn, plan.capabilities);
+    const promptRuntime = Object.freeze({
+        bootstrapContext: buildCapabilityBootstrap(options.bootstrapContext, context.capabilities.agents, context.capabilities.skills, context.selection.agent),
+        activeSkillsContext,
+        agentNickname: host.activeBinding?.nickname,
+        modelId: host.activeBinding?.model,
+        providerAlias: host.activeBinding?.providerAlias,
+    });
+    const stream = host.promptController.scheduleStream({
+        sessionKey: prep.sessionKey,
+        sessionId: prep.sessionId,
+        userMessages,
+        signal: context.turn.signal,
+        execute: (initialMessages, hooks, signal) => options.core.runText({
+            host,
+            sessionId: prep.sessionId,
+            userMessageExtra: prep.turnUser.userMessageExtra,
+            rawContent: prep.turnUser.rawContent,
+            promptProfile: { kind: 'interactive' },
+            turnContext: context.turn,
+            allTools: [...plan.allTools],
+            resolvedTools: [...plan.resolvedTools],
+            toolExecution: turnToolExecutionAuthority(toolRuntime),
+            toolEventSource: 'authority',
+            loopHooks: options.loopHooks,
+            promptRuntime,
+            personaEnhanced: prompt.personaEnhanced,
+            modelId: prompt.modelId,
+            modelCandidates: prompt.modelCandidates,
+            initialMessages,
+            promptHooks: hooks,
+            signal,
+            deferredStats: plan.deferredStats,
+            deferredController: plan.controller,
+            toolCatalog: plan.catalog,
+            toolLoading: 'deferred',
+            conversationPersistence: 'session',
+            generation: context.turn.identity.generation,
+        }),
+    });
+    const completion = yield* bufferTerminal(stream);
+    yield completion.terminal;
+    return {
+        project: async () => {
+            await completion.result.projectConversation?.();
+            await sessionSystem.touchAfterTurn(host, prep.sessionId);
+            await host.finalizeActiveTurn({
+                usage: completion.result.usage,
+                path: completion.result.path,
+                iterations: completion.result.iterations,
+                model: completion.result.model,
+                userInput: prep.turnUser.rawContent,
+                output: completion.result.reply,
+                thinking: completion.result.thinking,
+            });
+            if (completion.terminal.type === 'turn_end' && context.turn.ports.reply) {
+                const delivery = await context.turn.ports.reply.send(completion.terminal.output);
+                if (delivery.status === 'failed' || delivery.status === 'rejected') {
+                    throw new Error(`Synchronous reply projection failed: ${delivery.code}`);
+                }
+            }
+        },
+    };
+}
+async function* bufferTerminal(stream) {
+    let buffered;
+    while (true) {
+        const step = await stream.next();
+        if (step.done) {
+            if (!buffered)
+                throw new Error('Full AgentCore completed without a terminal TurnEvent');
+            return { terminal: buffered, result: step.value };
+        }
+        if (isTurnTerminalEvent(step.value)) {
+            if (buffered)
+                throw new Error('Full AgentCore emitted more than one terminal TurnEvent');
+            buffered = step.value;
+            continue;
+        }
+        if (buffered)
+            throw new Error('Full AgentCore emitted an event after its terminal');
+        yield step.value;
+    }
+}
+function buildCapabilityBootstrap(base, agents, skills, selectedName) {
+    const parts = base?.trim() ? [base.trim()] : [];
+    const selected = selectedName
+        ? agents.find((agent) => agent.qualifiedName === selectedName || agent.name === selectedName)
+        : undefined;
+    if (selectedName && !selected) {
+        throw new Error(`Selected Agent capability is not visible: ${selectedName}`);
+    }
+    if (selected) {
+        parts.push(`## Active specialist: ${selected.qualifiedName}\n${selected.description}\n${selected.instructions}`);
+    }
+    else if (agents.length > 0) {
+        parts.push([
+            '## Available specialist agents',
+            ...agents.map((agent) => `- ${agent.qualifiedName}: ${agent.description}`),
+        ].join('\n'));
+    }
+    if (skills.length > 0) {
+        parts.push([
+            '## Available skills',
+            ...skills.map((skill) => `- ${skill.qualifiedName}: ${skill.description}`),
+        ].join('\n'));
+    }
+    return parts.join('\n\n');
+}
+function terminal(text, usage) {
+    return {
+        type: 'turn_end',
+        output: [{ type: 'text', content: text }],
+        usage: {
+            promptTokens: usage.prompt_tokens,
+            completionTokens: usage.completion_tokens,
+            totalTokens: usage.total_tokens,
+        },
+    };
+}
+function zeroUsage() {
+    return { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 };
+}
+//# sourceMappingURL=full-agent-turn-engine.js.map

package/lib/plugin-runtime/full-agent-turn-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-agent-turn-engine.js","sourceRoot":"","sources":["../../src/plugin-runtime/full-agent-turn-engine.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,EAAE,mBAAmB,EAA6D,MAAM,wBAAwB,CAAC;AAKxH,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG3F,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAgB7E,qFAAqF;AACrF,MAAM,UAAU,yBAAyB,CAAC,OAAmC;IAC3E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,EAAE,CAAC,OAAkC,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC;KAChF,CAAC,CAAC;AACL,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,gBAAgB,CAC9B,OAAmC,EACnC,OAAkC;IAElC,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IACvD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC;QACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACxC,MAAM,GAAG,CAAC;QACV,OAAO;YACL,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,aAAa,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBACzD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK;oBAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChF,CAAC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG;QAChB,GAAG,OAAO,CAAC,YAAY;QACvB,KAAK,EAAE,OAAO,CAAC,gBAAgB;KAChC,CAAC;IACF,MAAM,IAAI,GAAG,4BAA4B,CAAC;QACxC,YAAY,EAAE,SAAS;QACvB,eAAe,EAAE,QAAQ;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QACtF,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;KAChG,CAAC,CAAC;IACH,MAAM,mBAAmB,GAAG,IAAI,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,oBAAoB,CAAC;QACtD,IAAI;QACJ,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU;QACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QACpD,mBAAmB;KACpB,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,0BAA0B,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;QAClC,gBAAgB,EAAE,wBAAwB,CACxC,OAAO,CAAC,gBAAgB,EACxB,OAAO,CAAC,YAAY,CAAC,MAAM,EAC3B,OAAO,CAAC,YAAY,CAAC,MAAM,EAC3B,OAAO,CAAC,SAAS,CAAC,KAAK,CACxB;QACD,mBAAmB;QACnB,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ;QAC3C,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK;QAClC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa;KACjD,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC;QAClD,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY;QACZ,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM;QAC3B,OAAO,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAChE,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB;YAChD,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU;YACpC,aAAa,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;YACtC,WAAW,EAAE,OAAO,CAAC,IAAI;YACzB,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5B,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;YACtC,aAAa,EAAE,0BAA0B,CAAC,WAAW,CAAC;YACtD,eAAe,EAAE,WAAW;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,aAAa;YACb,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,eAAe;YACf,WAAW,EAAE,KAAK;YAClB,MAAM;YACN,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,kBAAkB,EAAE,IAAI,CAAC,UAAU;YACnC,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,WAAW,EAAE,UAAU;YACvB,uBAAuB,EAAE,SAAS;YAClC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU;SAC7C,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,UAAU,CAAC,QAAQ,CAAC;IAC1B,OAAO;QACL,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,UAAU,CAAC,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAChD,MAAM,aAAa,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACzD,MAAM,IAAI,CAAC,kBAAkB,CAAC;gBAC5B,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK;gBAC9B,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI;gBAC5B,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,UAAU;gBACxC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK;gBAC9B,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU;gBACnC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK;gBAC/B,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ;aACrC,CAAC,CAAC;YACH,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACxE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACjF,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;oBACnE,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3E,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,cAAc,CAC5B,MAAsD;IAEtD,IAAI,QAAuC,CAAC;IAC5C,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;YACxF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACpD,CAAC;QACD,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;YACzF,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACpF,MAAM,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAC/B,IAAwB,EACxB,MAAkC,EAClC,MAAkC,EAClC,YAAqB;IAErB,MAAM,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,YAAY;QAC3B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;QAC7F,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,YAAY,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,6CAA6C,YAAY,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,aAAa,KAAK,QAAQ,CAAC,WAAW,KAAK,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACnH,CAAC;SAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC;YACT,gCAAgC;YAChC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,aAAa,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC;SAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChB,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC;YACT,qBAAqB;YACrB,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,aAAa,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC;SAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAY;IAC1C,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACzC,KAAK,EAAE;YACL,YAAY,EAAE,KAAK,CAAC,aAAa;YACjC,gBAAgB,EAAE,KAAK,CAAC,iBAAiB;YACzC,WAAW,EAAE,KAAK,CAAC,YAAY;SAChC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;AACrE,CAAC"}

package/lib/plugin-runtime/host-mcp-projection.d.ts

@@ -0,0 +1,10 @@
+import { mcpFeatureId, type McpDefinition } from '@zhin.js/mcp-feature';
+import type { McpServerEntry } from '../orchestrator/types.js';
+export interface HostMcpProjection {
+    readonly feature: typeof mcpFeatureId;
+    readonly name: string;
+    readonly definition: Readonly<McpDefinition>;
+}
+/** Projects configured MCP transport into the generation activation lifecycle. */
+export declare function projectHostMcp(entry: McpServerEntry): HostMcpProjection;
+//# sourceMappingURL=host-mcp-projection.d.ts.map

package/lib/plugin-runtime/host-mcp-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-mcp-projection.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/host-mcp-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,YAAY,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;CAC9C;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CA2BvE"}

package/lib/plugin-runtime/host-mcp-projection.js

@@ -0,0 +1,33 @@
+import { defineMcp, mcpFeatureId } from '@zhin.js/mcp-feature';
+import { McpClientConnection } from '../mcp-client/index.js';
+/** Projects configured MCP transport into the generation activation lifecycle. */
+export function projectHostMcp(entry) {
+    if (!entry.name.trim())
+        throw new TypeError('Host MCP name cannot be empty');
+    return Object.freeze({
+        feature: mcpFeatureId,
+        name: entry.name,
+        definition: defineMcp({
+            description: `Configured MCP server ${entry.name}`,
+            create: () => {
+                const connection = new McpClientConnection(entry);
+                return {
+                    start: async () => {
+                        const state = await connection.connect();
+                        if (!state.connected) {
+                            throw new Error(state.error || `Configured MCP server "${entry.name}" did not become ready`);
+                        }
+                    },
+                    stop: () => connection.disconnect(),
+                    listTools: () => connection.tools.map((tool) => Object.freeze({
+                        name: tool.name,
+                        description: tool.description,
+                        inputSchema: tool.parameters,
+                    })),
+                    callTool: (name, input) => connection.callTool(name, input),
+                };
+            },
+        }),
+    });
+}
+//# sourceMappingURL=host-mcp-projection.js.map

package/lib/plugin-runtime/host-mcp-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-mcp-projection.js","sourceRoot":"","sources":["../../src/plugin-runtime/host-mcp-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAsB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAS7D,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAC7E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,YAAY;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,SAAS,CAAC;YACpB,WAAW,EAAE,yBAAyB,KAAK,CAAC,IAAI,EAAE;YAClD,MAAM,EAAE,GAAG,EAAE;gBACX,MAAM,UAAU,GAAG,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;gBAClD,OAAO;oBACL,KAAK,EAAE,KAAK,IAAI,EAAE;wBAChB,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;wBACzC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;4BACrB,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,0BAA0B,KAAK,CAAC,IAAI,wBAAwB,CAAC,CAAC;wBAC/F,CAAC;oBACH,CAAC;oBACD,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE;oBACnC,SAAS,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;wBAC5D,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC7B,WAAW,EAAE,IAAI,CAAC,UAAU;qBAC7B,CAAC,CAAC;oBACH,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAgC,CAAC;iBACvF,CAAC;YACJ,CAAC;SACF,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/lib/plugin-runtime/host-tool-projection.d.ts

@@ -0,0 +1,21 @@
+import { toolFeatureId, type AgentToolDefinition, type ToolApproval, type ToolScope } from '@zhin.js/tool';
+export { toolFeatureId };
+export interface HostToolProjectionInput {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters?: unknown;
+    readonly approval?: ToolApproval;
+    readonly platforms?: readonly string[];
+    readonly scopes?: readonly ToolScope[];
+    readonly permissions?: readonly string[];
+    readonly hidden?: boolean;
+    execute(input: Record<string, unknown>, context: import('@zhin.js/tool').ToolExecutionContext): unknown | Promise<unknown>;
+}
+export interface HostToolProjection {
+    readonly feature: typeof toolFeatureId;
+    readonly name: string;
+    readonly definition: Readonly<AgentToolDefinition<Record<string, unknown>, unknown>>;
+}
+/** Converts a Host-owned tool into the same candidate ToolFeature used by plugins. */
+export declare function projectHostTool(input: HostToolProjectionInput): HostToolProjection;
+//# sourceMappingURL=host-tool-projection.d.ts.map

package/lib/plugin-runtime/host-tool-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-tool-projection.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/host-tool-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,eAAe,EAAE,oBAAoB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5H;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,aAAa,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;CACtF;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAgBlF"}

package/lib/plugin-runtime/host-tool-projection.js

@@ -0,0 +1,22 @@
+import { defineAgentTool, toolFeatureId, } from '@zhin.js/tool';
+export { toolFeatureId };
+/** Converts a Host-owned tool into the same candidate ToolFeature used by plugins. */
+export function projectHostTool(input) {
+    if (!input.name.trim())
+        throw new TypeError('Host Tool name cannot be empty');
+    return Object.freeze({
+        feature: toolFeatureId,
+        name: input.name,
+        definition: defineAgentTool({
+            description: input.description,
+            inputSchema: input.parameters,
+            approval: input.approval,
+            platforms: input.platforms,
+            scopes: input.scopes,
+            permissions: input.permissions,
+            hidden: input.hidden,
+            execute: (value, context) => input.execute(value, context),
+        }),
+    });
+}
+//# sourceMappingURL=host-tool-projection.js.map

package/lib/plugin-runtime/host-tool-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-tool-projection.js","sourceRoot":"","sources":["../../src/plugin-runtime/host-tool-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,aAAa,GAId,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,CAAC;AAoBzB,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAC,KAA8B;IAC5D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,eAAe,CAAmC;YAC5D,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,WAAW,EAAE,KAAK,CAAC,UAAU;YAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;SAC3D,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/lib/plugin-runtime/index.d.ts

@@ -1,4 +1,14 @@
 export * from './agent-runtime.js';
 export * from './agent-host-port.js';
 export * from './capability-ingress.js';
+export * from './deferred-capability-plan.js';
+export * from './full-agent-turn-engine.js';
+export * from './host-tool-projection.js';
+export * from './host-mcp-projection.js';
+export * from './native-file-tools.js';
+export * from './native-web-tools.js';
+export * from './native-todo-tools.js';
+export * from './native-interaction-tools.js';
+export { FileJournalStore } from '../journal/file-journal-store.js';
+export { capabilityToTool, toolInvocationFromTurn, toolsFromCapabilities, type GenerationStampedTool, } from './capability-tools.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/plugin-runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC"}

package/lib/plugin-runtime/index.js

@@ -1,4 +1,14 @@
 export * from './agent-runtime.js';
 export * from './agent-host-port.js';
 export * from './capability-ingress.js';
+export * from './deferred-capability-plan.js';
+export * from './full-agent-turn-engine.js';
+export * from './host-tool-projection.js';
+export * from './host-mcp-projection.js';
+export * from './native-file-tools.js';
+export * from './native-web-tools.js';
+export * from './native-todo-tools.js';
+export * from './native-interaction-tools.js';
+export { FileJournalStore } from '../journal/file-journal-store.js';
+export { capabilityToTool, toolInvocationFromTurn, toolsFromCapabilities, } from './capability-tools.js';
 //# sourceMappingURL=index.js.map

package/lib/plugin-runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC"}

package/lib/plugin-runtime/native-file-tools.d.ts

@@ -0,0 +1,9 @@
+import { toolFeatureId, type AgentToolDefinition } from '@zhin.js/tool';
+export interface NativeFileToolFeature {
+    readonly feature: typeof toolFeatureId;
+    readonly name: string;
+    readonly definition: Readonly<AgentToolDefinition<Record<string, unknown>, string>>;
+}
+/** Native ToolFeature definitions; no classic Tool, Message, or process cwd dependency. */
+export declare function createNativeFileToolFeatures(): readonly NativeFileToolFeature[];
+//# sourceMappingURL=native-file-tools.d.ts.map

package/lib/plugin-runtime/native-file-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-file-tools.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-file-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EAEzB,MAAM,eAAe,CAAC;AAIvB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,aAAa,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACrF;AAED,2FAA2F;AAC3F,wBAAgB,4BAA4B,IAAI,SAAS,qBAAqB,EAAE,CA2D/E"}