@zhin.js/agent 0.1.31 → 0.1.32

package/lib/orchestrator/remote-agent-registry.d.ts

@@ -0,0 +1,32 @@
+import type { AIConfig } from '@zhin.js/core';
+import { McpClientConnection } from '../mcp-client/connection.js';
+import type { McpServerEntry } from './types.js';
+export interface RemoteAgentEntry {
+    id: string;
+    name: string;
+    url: string;
+    token?: string;
+    roles: string[];
+    description: string;
+}
+export interface RemoteAgentHealth {
+    id: string;
+    healthy: boolean;
+    error?: string;
+}
+export declare class RemoteAgentRegistry {
+    private entries;
+    private health;
+    private connections;
+    loadFromConfig(config: AIConfig | undefined): void;
+    list(): RemoteAgentEntry[];
+    get(id: string): RemoteAgentEntry | undefined;
+    getHealth(id: string): RemoteAgentHealth | undefined;
+    toMcpEntry(agent: RemoteAgentEntry): McpServerEntry;
+    getConnection(agentId: string): Promise<McpClientConnection>;
+    healthCheckAll(): Promise<RemoteAgentHealth[]>;
+    pingAgent(agentId: string): Promise<RemoteAgentHealth>;
+}
+export declare function getRemoteAgentRegistry(): RemoteAgentRegistry;
+export declare function initRemoteAgentRegistry(config: AIConfig | undefined): RemoteAgentRegistry;
+//# sourceMappingURL=remote-agent-registry.d.ts.map

package/lib/orchestrator/remote-agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-agent-registry.d.ts","sourceRoot":"","sources":["../../src/orchestrator/remote-agent-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsBD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,WAAW,CAA0C;IAE7D,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI;IAOlD,IAAI,IAAI,gBAAgB,EAAE;IAI1B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI7C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIpD,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc;IAa7C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAc5D,cAAc,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAS9C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAwB7D;AAID,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,mBAAmB,CAIzF"}

package/lib/orchestrator/remote-agent-registry.js

@@ -0,0 +1,120 @@
+/**
+ * RemoteAgentRegistry — static ai.remoteAgents + health check (Agent Mesh v1).
+ */
+import { Logger } from '@zhin.js/logger';
+import { resolveConfigEnvString } from '../utils/config-env.js';
+import { McpClientConnection } from '../mcp-client/connection.js';
+const logger = new Logger(null, 'RemoteAgentRegistry');
+function parseRemoteAgents(config) {
+    const raw = config?.remoteAgents;
+    if (!raw?.length)
+        return [];
+    const out = [];
+    for (const item of raw) {
+        if (!item?.id?.trim() || !item.url?.trim())
+            continue;
+        const url = resolveConfigEnvString(item.url) ?? item.url;
+        const token = item.token ? (resolveConfigEnvString(item.token) ?? item.token) : undefined;
+        out.push({
+            id: item.id.trim(),
+            name: item.name?.trim() || item.id.trim(),
+            url: url.trim(),
+            token,
+            roles: Array.isArray(item.roles) ? item.roles.map(String) : [],
+            description: item.description?.trim() || '',
+        });
+    }
+    return out;
+}
+export class RemoteAgentRegistry {
+    entries = new Map();
+    health = new Map();
+    connections = new Map();
+    loadFromConfig(config) {
+        this.entries.clear();
+        for (const entry of parseRemoteAgents(config)) {
+            this.entries.set(entry.id, entry);
+        }
+    }
+    list() {
+        return [...this.entries.values()];
+    }
+    get(id) {
+        return this.entries.get(id);
+    }
+    getHealth(id) {
+        return this.health.get(id);
+    }
+    toMcpEntry(agent) {
+        const headers = {};
+        if (agent.token) {
+            headers.Authorization = `Bearer ${agent.token}`;
+        }
+        return {
+            name: `remote-agent:${agent.id}`,
+            transport: 'streamable-http',
+            url: agent.url,
+            headers,
+        };
+    }
+    async getConnection(agentId) {
+        const agent = this.entries.get(agentId);
+        if (!agent)
+            throw new Error(`Remote agent "${agentId}" not registered`);
+        let conn = this.connections.get(agentId);
+        if (!conn) {
+            conn = new McpClientConnection(this.toMcpEntry(agent));
+            this.connections.set(agentId, conn);
+        }
+        if (!conn.isConnected) {
+            await conn.connect();
+        }
+        return conn;
+    }
+    async healthCheckAll() {
+        const results = [];
+        for (const agent of this.entries.values()) {
+            const health = await this.pingAgent(agent.id);
+            results.push(health);
+        }
+        return results;
+    }
+    async pingAgent(agentId) {
+        const agent = this.entries.get(agentId);
+        if (!agent) {
+            const h = { id: agentId, healthy: false, error: 'not registered' };
+            this.health.set(agentId, h);
+            return h;
+        }
+        try {
+            const conn = await this.getConnection(agentId);
+            await conn.ping();
+            const h = { id: agentId, healthy: true };
+            this.health.set(agentId, h);
+            return h;
+        }
+        catch (err) {
+            const h = {
+                id: agentId,
+                healthy: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+            this.health.set(agentId, h);
+            logger.debug(`Remote agent ${agentId} health check failed:`, err);
+            return h;
+        }
+    }
+}
+let globalRegistry = null;
+export function getRemoteAgentRegistry() {
+    if (!globalRegistry) {
+        globalRegistry = new RemoteAgentRegistry();
+    }
+    return globalRegistry;
+}
+export function initRemoteAgentRegistry(config) {
+    const registry = getRemoteAgentRegistry();
+    registry.loadFromConfig(config);
+    return registry;
+}
+//# sourceMappingURL=remote-agent-registry.js.map

package/lib/orchestrator/remote-agent-registry.js.map

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

package/lib/orchestrator/remote-task-executor.d.ts

@@ -0,0 +1,10 @@
+export declare function executeRemoteOrchestrationTask(taskId: string): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+export declare function pollRemoteTaskStatus(taskId: string): Promise<{
+    done: boolean;
+    status: string;
+    result?: string;
+}>;
+//# sourceMappingURL=remote-task-executor.d.ts.map

package/lib/orchestrator/remote-task-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-task-executor.d.ts","sourceRoot":"","sources":["../../src/orchestrator/remote-task-executor.ts"],"names":[],"mappings":"AAmBA,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAwE3C;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkD7D"}

package/lib/orchestrator/remote-task-executor.js

@@ -0,0 +1,142 @@
+/**
+ * Remote task execution via MCP agent.delegate_task (Agent Mesh v1).
+ */
+import { getAgentDispatcher } from './agent-dispatcher.js';
+import { getRemoteAgentRegistry } from './remote-agent-registry.js';
+import { getOrchestrationService } from './orchestration-service.js';
+function extractMcpText(result) {
+    if (typeof result === 'string')
+        return result;
+    const content = result?.content;
+    if (Array.isArray(content)) {
+        return content
+            .filter((c) => c.type === 'text' && c.text)
+            .map((c) => c.text)
+            .join('\n');
+    }
+    return JSON.stringify(result);
+}
+export async function executeRemoteOrchestrationTask(taskId) {
+    const dispatcher = getAgentDispatcher();
+    const orch = getOrchestrationService();
+    const task = dispatcher.getTask(taskId);
+    if (!task) {
+        return { ok: false, message: `任务 ${taskId} 不存在` };
+    }
+    if (task.executorKind !== 'remote' || !task.remoteAgentId) {
+        return { ok: false, message: `任务 ${taskId} 不是远程执行任务` };
+    }
+    const registry = getRemoteAgentRegistry();
+    const agent = registry.get(task.remoteAgentId);
+    if (!agent) {
+        return { ok: false, message: `远程 Agent ${task.remoteAgentId} 未注册` };
+    }
+    const promise = (async () => {
+        try {
+            const conn = await registry.getConnection(task.remoteAgentId);
+            const result = await conn.callTool('agent.delegate_task', {
+                title: task.name,
+                description: task.goal || task.description,
+                acceptance_criteria: task.context?.acceptance_criteria ?? '',
+                artifacts: task.context?.artifacts ?? [],
+            });
+            const text = extractMcpText(result);
+            let remoteTaskId = taskId;
+            try {
+                const parsed = JSON.parse(text);
+                remoteTaskId = parsed.remote_task_id ?? parsed.task_id ?? taskId;
+            }
+            catch {
+                const match = text.match(/remote_task_id["\s:]+([a-zA-Z0-9-]+)/);
+                if (match)
+                    remoteTaskId = match[1];
+            }
+            if (orch) {
+                await orch.repositoryHandle.updateTaskStatus(taskId, 'running', {
+                    remote_task_id: remoteTaskId,
+                    started_at: Date.now(),
+                });
+            }
+            dispatcher.markRunning(taskId, Promise.resolve({
+                taskId,
+                role: task.role,
+                success: true,
+                summary: `delegated to ${task.remoteAgentId}:${remoteTaskId}`,
+                duration: 0,
+            }));
+        }
+        catch (err) {
+            dispatcher.recordResult({
+                taskId,
+                role: task.role,
+                success: false,
+                summary: 'remote delegate failed',
+                error: err instanceof Error ? err.message : String(err),
+                duration: 0,
+            });
+        }
+    })();
+    dispatcher.markRunning(taskId, promise.then(() => ({
+        taskId,
+        role: task.role,
+        success: true,
+        summary: 'remote delegation started',
+        duration: 0,
+    })));
+    return {
+        ok: true,
+        message: `远程任务已委托给 ${task.remoteAgentId}（task ${taskId}），将通过轮询同步状态。`,
+    };
+}
+export async function pollRemoteTaskStatus(taskId) {
+    const dispatcher = getAgentDispatcher();
+    const orch = getOrchestrationService();
+    const task = dispatcher.getTask(taskId);
+    if (!task?.remoteAgentId || !task.remoteTaskId) {
+        return { done: false, status: 'unknown' };
+    }
+    const conn = await getRemoteAgentRegistry().getConnection(task.remoteAgentId);
+    const statusResult = await conn.callTool('agent.query_status', { task_id: task.remoteTaskId });
+    const statusText = extractMcpText(statusResult);
+    let status = 'running';
+    try {
+        const parsed = JSON.parse(statusText);
+        status = parsed.status ?? status;
+    }
+    catch {
+        if (/completed|done|success/i.test(statusText))
+            status = 'completed';
+        if (/failed|error/i.test(statusText))
+            status = 'failed';
+        if (/pending/i.test(statusText))
+            status = 'pending';
+    }
+    if (status === 'completed') {
+        const resultRaw = await conn.callTool('agent.get_result', { task_id: task.remoteTaskId });
+        const resultText = extractMcpText(resultRaw);
+        dispatcher.recordResult({
+            taskId,
+            role: task.role,
+            success: true,
+            summary: resultText.slice(0, 4000),
+            duration: 0,
+        });
+        return { done: true, status, result: resultText };
+    }
+    if (status === 'failed' || status === 'cancelled') {
+        dispatcher.recordResult({
+            taskId,
+            role: task.role,
+            success: false,
+            summary: statusText,
+            error: statusText,
+            duration: 0,
+        });
+        return { done: true, status, result: statusText };
+    }
+    if (orch) {
+        await orch.repositoryHandle.updateTaskStatus(taskId, 'running');
+    }
+    return { done: false, status };
+}
+//# sourceMappingURL=remote-task-executor.js.map

package/lib/orchestrator/remote-task-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-task-executor.js","sourceRoot":"","sources":["../../src/orchestrator/remote-task-executor.ts"],"names":[],"mappings":"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"}

package/lib/orchestrator/remote-task-poller.d.ts

@@ -0,0 +1,16 @@
+export interface RemoteTaskPollerConfig {
+    intervalMs?: number;
+    enabled?: boolean;
+}
+export declare class RemoteTaskPoller {
+    private readonly config;
+    private timer;
+    private polling;
+    constructor(config?: RemoteTaskPollerConfig);
+    start(): void;
+    stop(): void;
+    tick(): Promise<void>;
+}
+export declare function getRemoteTaskPoller(): RemoteTaskPoller;
+export declare function startRemoteTaskPoller(config?: RemoteTaskPollerConfig): RemoteTaskPoller;
+//# sourceMappingURL=remote-task-poller.d.ts.map

package/lib/orchestrator/remote-task-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-task-poller.d.ts","sourceRoot":"","sources":["../../src/orchestrator/remote-task-poller.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;gBAEK,MAAM,GAAE,sBAA2B;IAEhE,KAAK,IAAI,IAAI;IAab,IAAI,IAAI,IAAI;IAON,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAsB5B;AAID,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,gBAAgB,CAIvF"}

package/lib/orchestrator/remote-task-poller.js

@@ -0,0 +1,75 @@
+/**
+ * RemoteTaskPoller — 轮询远程 MCP 任务状态（Agent Mesh v1）。
+ */
+import { Logger } from '@zhin.js/logger';
+import { getOrchestrationService } from './orchestration-service.js';
+import { getAgentDispatcher } from './agent-dispatcher.js';
+import { pollRemoteTaskStatus } from './remote-task-executor.js';
+const logger = new Logger(null, 'RemoteTaskPoller');
+export class RemoteTaskPoller {
+    config;
+    timer = null;
+    polling = false;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    start() {
+        if (this.config.enabled === false)
+            return;
+        if (this.timer)
+            return;
+        const intervalMs = this.config.intervalMs ?? 15_000;
+        this.timer = setInterval(() => {
+            void this.tick();
+        }, intervalMs);
+        if (this.timer && typeof this.timer === 'object' && 'unref' in this.timer) {
+            this.timer.unref();
+        }
+        logger.debug(`RemoteTaskPoller started (interval=${intervalMs}ms)`);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    async tick() {
+        if (this.polling)
+            return;
+        this.polling = true;
+        try {
+            const orch = getOrchestrationService();
+            if (!orch)
+                return;
+            const tasks = await orch.repositoryHandle.listActiveRemoteTasks();
+            const dispatcher = getAgentDispatcher();
+            for (const record of tasks) {
+                dispatcher.syncTaskFromRecord(record);
+                if (record.remote_task_id) {
+                    try {
+                        await pollRemoteTaskStatus(record.id);
+                    }
+                    catch (err) {
+                        logger.debug(`poll failed for ${record.id}:`, err);
+                    }
+                }
+            }
+        }
+        finally {
+            this.polling = false;
+        }
+    }
+}
+let globalPoller = null;
+export function getRemoteTaskPoller() {
+    if (!globalPoller) {
+        globalPoller = new RemoteTaskPoller();
+    }
+    return globalPoller;
+}
+export function startRemoteTaskPoller(config) {
+    globalPoller = new RemoteTaskPoller(config);
+    globalPoller.start();
+    return globalPoller;
+}
+//# sourceMappingURL=remote-task-poller.js.map

package/lib/orchestrator/remote-task-poller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-task-poller.js","sourceRoot":"","sources":["../../src/orchestrator/remote-task-poller.ts"],"names":[],"mappings":"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"}

package/lib/plugin-loop-hooks.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Plugin hooks bridged to agentLoop (ADR 0010 D5).
+ */
+import type { AgentMessage, BeforeToolCallResult, ParsedToolCall } from '@zhin.js/ai';
+export interface PluginBeforeToolCallContext {
+    toolCall: ParsedToolCall;
+    sessionId?: string;
+}
+export interface PluginAfterToolCallContext {
+    toolCall: ParsedToolCall;
+    result: AgentMessage;
+    sessionId?: string;
+}
+export interface PluginTransformContextContext {
+    sessionId?: string;
+    signal?: AbortSignal;
+}
+export type PluginBeforeToolCallHandler = (ctx: PluginBeforeToolCallContext) => Promise<BeforeToolCallResult | void> | BeforeToolCallResult | void;
+export type PluginAfterToolCallHandler = (ctx: PluginAfterToolCallContext) => Promise<void> | void;
+export type PluginTransformContextHandler = (messages: AgentMessage[], ctx: PluginTransformContextContext) => Promise<AgentMessage[]> | AgentMessage[];
+export declare class PluginAILoopHookRegistry {
+    private readonly beforeHandlers;
+    private readonly afterHandlers;
+    private readonly transformHandlers;
+    onBeforeToolCall(handler: PluginBeforeToolCallHandler): () => void;
+    onAfterToolCall(handler: PluginAfterToolCallHandler): () => void;
+    onTransformContext(handler: PluginTransformContextHandler): () => void;
+    runBeforeToolCall(ctx: PluginBeforeToolCallContext): Promise<BeforeToolCallResult | void>;
+    runAfterToolCall(ctx: PluginAfterToolCallContext): Promise<void>;
+    runTransformContext(messages: AgentMessage[], ctx: PluginTransformContextContext): Promise<AgentMessage[]>;
+}
+//# sourceMappingURL=plugin-loop-hooks.d.ts.map

package/lib/plugin-loop-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loop-hooks.d.ts","sourceRoot":"","sources":["../src/plugin-loop-hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEtF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,2BAA2B,GAAG,CACxC,GAAG,EAAE,2BAA2B,KAC7B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,GAAG,oBAAoB,GAAG,IAAI,CAAC;AAExE,MAAM,MAAM,0BAA0B,GAAG,CACvC,GAAG,EAAE,0BAA0B,KAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,MAAM,MAAM,6BAA6B,GAAG,CAC1C,QAAQ,EAAE,YAAY,EAAE,EACxB,GAAG,EAAE,6BAA6B,KAC/B,OAAO,CAAC,YAAY,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC;AAE9C,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqC;IACpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;IAClE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IAEzE,gBAAgB,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,IAAI;IAQlE,eAAe,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,IAAI;IAQhE,kBAAkB,CAAC,OAAO,EAAE,6BAA6B,GAAG,MAAM,IAAI;IAQhE,iBAAiB,CACrB,GAAG,EAAE,2BAA2B,GAC/B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAgBjC,gBAAgB,CAAC,GAAG,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhE,mBAAmB,CACvB,QAAQ,EAAE,YAAY,EAAE,EACxB,GAAG,EAAE,6BAA6B,GACjC,OAAO,CAAC,YAAY,EAAE,CAAC;CAW3B"}

package/lib/plugin-loop-hooks.js

@@ -0,0 +1,69 @@
+export class PluginAILoopHookRegistry {
+    beforeHandlers = [];
+    afterHandlers = [];
+    transformHandlers = [];
+    onBeforeToolCall(handler) {
+        this.beforeHandlers.push(handler);
+        return () => {
+            const i = this.beforeHandlers.indexOf(handler);
+            if (i >= 0)
+                this.beforeHandlers.splice(i, 1);
+        };
+    }
+    onAfterToolCall(handler) {
+        this.afterHandlers.push(handler);
+        return () => {
+            const i = this.afterHandlers.indexOf(handler);
+            if (i >= 0)
+                this.afterHandlers.splice(i, 1);
+        };
+    }
+    onTransformContext(handler) {
+        this.transformHandlers.push(handler);
+        return () => {
+            const i = this.transformHandlers.indexOf(handler);
+            if (i >= 0)
+                this.transformHandlers.splice(i, 1);
+        };
+    }
+    async runBeforeToolCall(ctx) {
+        let merged;
+        for (const handler of this.beforeHandlers) {
+            try {
+                const result = await handler(ctx);
+                if (result) {
+                    merged = { ...(merged ?? {}), ...result };
+                    if (result.allowed === false)
+                        return merged;
+                }
+            }
+            catch {
+                // isolate plugin errors
+            }
+        }
+        return merged;
+    }
+    async runAfterToolCall(ctx) {
+        for (const handler of this.afterHandlers) {
+            try {
+                await handler(ctx);
+            }
+            catch {
+                // isolate
+            }
+        }
+    }
+    async runTransformContext(messages, ctx) {
+        let out = messages;
+        for (const handler of this.transformHandlers) {
+            try {
+                out = await handler(out, ctx);
+            }
+            catch {
+                // isolate
+            }
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=plugin-loop-hooks.js.map

package/lib/plugin-loop-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loop-hooks.js","sourceRoot":"","sources":["../src/plugin-loop-hooks.ts"],"names":[],"mappings":"AAkCA,MAAM,OAAO,wBAAwB;IAClB,cAAc,GAAkC,EAAE,CAAC;IACnD,aAAa,GAAiC,EAAE,CAAC;IACjD,iBAAiB,GAAoC,EAAE,CAAC;IAEzE,gBAAgB,CAAC,OAAoC;QACnD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,OAAmC;QACjD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,OAAsC;QACvD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,GAAgC;QAEhC,IAAI,MAAwC,CAAC;QAC7C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,GAAG,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;oBAC1C,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;wBAAE,OAAO,MAAM,CAAC;gBAC9C,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,GAA+B;QACpD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,QAAwB,EACxB,GAAkC;QAElC,IAAI,GAAG,GAAG,QAAQ,CAAC;QACnB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/lib/service.d.ts

@@ -10,6 +10,7 @@ import type { ContextManager, ContextConfig } from '@zhin.js/ai';
 import { type NormalizedAiRoutingConfig } from './config/normalize-ai-config.js';
 import { AgentBindingRegistry } from './config/agent-binding-registry.js';
 import type { ToolCallRecord } from './zhin-agent/tool-calls-user-format.js';
+import { PluginAILoopHookRegistry, type PluginAfterToolCallHandler, type PluginBeforeToolCallHandler, type PluginTransformContextHandler } from './plugin-loop-hooks.js';
 /** AIService 程序化 Agent 句柄（agentLoop 隔离上下文，非 legacy `Agent` 类） */
 export interface ServiceAgent {
     run(userInput: string | ContentPart[]): Promise<ServiceAgentResult>;
@@ -48,6 +49,7 @@ export declare class AIService {
     private plugin?;
     private customTools;
     private _modelRegistry;
+    readonly loopHooks: PluginAILoopHookRegistry;
     constructor(config?: AIConfig);
     getRoutingConfig(): NormalizedAiRoutingConfig;
     getBindingRegistry(): AgentBindingRegistry;
@@ -60,6 +62,11 @@ export declare class AIService {
     setModelRegistry(registry: ModelRegistry): void;
     getModelRegistry(): ModelRegistry | null;
     registerTool(tool: AgentTool): () => void;
+    /** ADR 0010 — bridge plugin beforeToolCall hooks to agentLoop. */
+    onBeforeToolCall(handler: PluginBeforeToolCallHandler): () => void;
+    onAfterToolCall(handler: PluginAfterToolCallHandler): () => void;
+    /** Run after built-in compaction in transformContext chain. */
+    onTransformContext(handler: PluginTransformContextHandler): () => void;
     collectAllTools(): AgentTool[];
     /**
      * IM / ZhinAgent 流水线用的常驻 Tool 实例（未经 normalize；与 ToolFeature 工具合并后由 collectRelevantTools 绑定 context）。

package/lib/service.d.ts.map

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

package/lib/service.js

@@ -14,6 +14,7 @@ import { registerLlmApiFromProviders } from '@zhin.js/ai';
 import { AgentBindingRegistry } from './config/agent-binding-registry.js';
 import { DEFAULT_ZHIN_AGENT_NAME } from './config/types.js';
 import { runAgentLoopStandaloneTurn, } from './zhin-agent/agent-loop-standalone.js';
+import { PluginAILoopHookRegistry, } from './plugin-loop-hooks.js';
 export class AIService {
     providers = new Map();
     defaultProvider;
@@ -30,6 +31,7 @@ export class AIService {
     plugin;
     customTools = new Map();
     _modelRegistry = null;
+    loopHooks = new PluginAILoopHookRegistry();
     constructor(config = {}) {
         this.routing = normalizeAiRoutingConfig(config);
         const validationErrors = validateAiRoutingConfig(this.routing);
@@ -80,6 +82,17 @@ export class AIService {
     setModelRegistry(registry) { this._modelRegistry = registry; }
     getModelRegistry() { return this._modelRegistry; }
     registerTool(tool) { this.customTools.set(tool.name, tool); return () => { this.customTools.delete(tool.name); }; }
+    /** ADR 0010 — bridge plugin beforeToolCall hooks to agentLoop. */
+    onBeforeToolCall(handler) {
+        return this.loopHooks.onBeforeToolCall(handler);
+    }
+    onAfterToolCall(handler) {
+        return this.loopHooks.onAfterToolCall(handler);
+    }
+    /** Run after built-in compaction in transformContext chain. */
+    onTransformContext(handler) {
+        return this.loopHooks.onTransformContext(handler);
+    }
     collectAllTools() {
         const tools = [...this.builtinTools, ...this.customTools.values()];
         return tools;