@better-agent/core 0.1.0-beta.1

package/dist/plugins/runtime.mjs

@@ -0,0 +1,456 @@
+import { resolveToolsForRun } from "../tools/resolve-tools.mjs";
+import { BetterAgentError } from "@better-agent/shared/errors";
+import { logger } from "@better-agent/shared/logger";
+
+//#region src/plugins/runtime.ts
+/**
+* Defines a plugin.
+*
+* Plugin hook contexts are intentionally broad at authoring time. Some
+* capability-sensitive controls may be omitted at runtime for models that do
+* not support them.
+*
+* @param config Plugin configuration.
+* @returns The plugin definition with preserved literal types.
+*/
+function definePlugin(config) {
+	return config;
+}
+/**
+* Builds validated plugin runtime metadata for the runner and server.
+*/
+function createPluginRuntime(plugins) {
+	const source = plugins ?? [];
+	const seenPluginIds = /* @__PURE__ */ new Set();
+	const seenEndpoints = /* @__PURE__ */ new Set();
+	const eventMiddlewares = [];
+	const guards = [];
+	const endpoints = [];
+	const onEventHandlers = [];
+	const toolSources = [];
+	const onStepHooks = [];
+	const beforeModelHooks = [];
+	const afterModelHooks = [];
+	const beforeToolHooks = [];
+	const afterToolHooks = [];
+	const beforeSaveHooks = [];
+	for (const plugin of source) {
+		const pluginId = plugin.id.trim();
+		if (pluginId.length === 0) throw BetterAgentError.fromCode("VALIDATION_FAILED", "Plugin id must be a non-empty string.", { trace: [{ at: "core.plugins.createPluginRuntime" }] });
+		if (seenPluginIds.has(pluginId)) throw BetterAgentError.fromCode("VALIDATION_FAILED", `Duplicate plugin id '${pluginId}'.`, {
+			context: { pluginId },
+			trace: [{ at: "core.plugins.createPluginRuntime" }]
+		});
+		seenPluginIds.add(pluginId);
+		if (plugin.events?.middleware) for (const middleware of plugin.events.middleware) eventMiddlewares.push({
+			pluginId,
+			middleware,
+			...plugin.events.subscribe !== void 0 ? { subscribe: plugin.events.subscribe } : {}
+		});
+		if (plugin.guards) for (const guard of plugin.guards) guards.push({
+			pluginId,
+			guard
+		});
+		for (const endpoint of plugin.endpoints ?? []) validateAndExpandEndpoint(endpoint, pluginId, seenEndpoints, endpoints);
+		if (plugin.onEvent) onEventHandlers.push(plugin.onEvent);
+		if (plugin.tools) toolSources.push(plugin.tools);
+		if (plugin.onStep) onStepHooks.push({
+			pluginId,
+			hook: plugin.onStep
+		});
+		if (plugin.onBeforeModelCall) beforeModelHooks.push({
+			pluginId,
+			hook: plugin.onBeforeModelCall
+		});
+		if (plugin.onAfterModelCall) afterModelHooks.push({
+			pluginId,
+			hook: plugin.onAfterModelCall
+		});
+		if (plugin.onBeforeToolCall) beforeToolHooks.push({
+			pluginId,
+			hook: plugin.onBeforeToolCall
+		});
+		if (plugin.onAfterToolCall) afterToolHooks.push({
+			pluginId,
+			hook: plugin.onAfterToolCall
+		});
+		if (plugin.onBeforeSave) beforeSaveHooks.push({
+			pluginId,
+			hook: plugin.onBeforeSave
+		});
+	}
+	const reportPluginRuntimeError = (params) => {
+		logger.error(`[better-agent] Plugin '${params.pluginId}' failed during ${params.phase}.`, params.error);
+	};
+	return {
+		plugins: source,
+		endpoints,
+		hasEventMiddleware: eventMiddlewares.length > 0,
+		hasOnEvent: onEventHandlers.length > 0,
+		hasGuards: guards.length > 0,
+		hasTools: toolSources.length > 0,
+		hasOnStep: onStepHooks.length > 0,
+		hasModelHooks: beforeModelHooks.length > 0 || afterModelHooks.length > 0,
+		hasToolHooks: beforeToolHooks.length > 0 || afterToolHooks.length > 0,
+		hasOnBeforeSave: beforeSaveHooks.length > 0,
+		async dispatchEvent(event, ctx) {
+			const run = async (index, current) => {
+				for (let i = index; i < eventMiddlewares.length; i++) {
+					const item = eventMiddlewares[i];
+					if (!item) continue;
+					if (item.subscribe && !item.subscribe.includes(current.type)) continue;
+					try {
+						return await item.middleware(current, ctx, async (nextEvent) => {
+							return run(i + 1, nextEvent);
+						});
+					} catch (error) {
+						reportPluginRuntimeError({
+							pluginId: item.pluginId,
+							phase: "event_middleware",
+							error
+						});
+						return run(i + 1, current);
+					}
+				}
+				return current;
+			};
+			return run(0, event);
+		},
+		async dispatchOnEvent(event, ctx) {
+			for (let i = 0; i < source.length; i += 1) {
+				const plugin = source[i];
+				if (!plugin?.onEvent) continue;
+				try {
+					await plugin.onEvent(event, ctx);
+				} catch (error) {
+					reportPluginRuntimeError({
+						pluginId: plugin.id,
+						phase: "on_event",
+						error
+					});
+				}
+			}
+		},
+		async dispatchRun(ctx) {
+			for (const entry of guards) try {
+				const response = await entry.guard(ctx);
+				if (response) return response;
+			} catch (error) {
+				reportPluginRuntimeError({
+					pluginId: entry.pluginId,
+					phase: "guard",
+					error
+				});
+				throw BetterAgentError.wrap({
+					err: error,
+					message: `Plugin '${entry.pluginId}' guard failed.`,
+					opts: {
+						code: "INTERNAL",
+						context: {
+							pluginId: entry.pluginId,
+							mode: ctx.mode,
+							agentName: ctx.agentName
+						},
+						trace: [{ at: "core.plugins.createPluginRuntime.dispatchRun" }]
+					}
+				});
+			}
+			return null;
+		},
+		async resolveTools(context) {
+			if (toolSources.length === 0) return {
+				tools: [],
+				runCleanup: async () => {}
+			};
+			const cleanupTasks = [];
+			const deduped = /* @__PURE__ */ new Map();
+			for (const source of toolSources) {
+				const resolved = await resolveToolsForRun({
+					agentTools: source,
+					...context !== void 0 ? { context } : {}
+				});
+				cleanupTasks.push(resolved.runCleanup);
+				for (const tool of resolved.tools) {
+					if (typeof tool.name !== "string") continue;
+					if (deduped.has(tool.name)) deduped.delete(tool.name);
+					deduped.set(tool.name, tool);
+				}
+			}
+			return {
+				tools: [...deduped.values()],
+				runCleanup: async () => {
+					await Promise.allSettled(cleanupTasks.map(async (cleanup) => await cleanup()));
+				}
+			};
+		},
+		async applyOnStep(params) {
+			const prepared = { messages: [...params.messages] };
+			if (onStepHooks.length === 0) return prepared;
+			const supportsTools = params.modelCaps?.tools === true;
+			const supportsInstructionControl = params.modelCaps === void 0 ? true : params.modelCaps.inputShape !== "prompt" && params.modelCaps.supportsInstruction === true;
+			const baseHookContext = {
+				runId: params.runId,
+				agentName: params.agentName,
+				stepIndex: params.stepIndex,
+				maxSteps: params.maxSteps,
+				messages: prepared.messages,
+				...params.conversationId !== void 0 ? { conversationId: params.conversationId } : {},
+				...params.context !== void 0 ? { context: params.context } : {},
+				...params.previousStep !== void 0 ? { previousStep: params.previousStep } : {},
+				updateMessages: (updater) => {
+					prepared.messages = updater([...prepared.messages]);
+					baseHookContext.messages = prepared.messages;
+				}
+			};
+			const withInstructionControl = supportsInstructionControl ? {
+				...baseHookContext,
+				setSystemInstruction: (instruction) => {
+					prepared.systemInstruction = instruction;
+				}
+			} : baseHookContext;
+			const hookContext = supportsTools ? {
+				...withInstructionControl,
+				setToolChoice: (choice) => {
+					prepared.toolChoice = choice;
+				},
+				setActiveTools: (names) => {
+					prepared.activeTools = [...names];
+				}
+			} : withInstructionControl;
+			for (const entry of onStepHooks) try {
+				await entry.hook(hookContext);
+			} catch (error) {
+				reportPluginRuntimeError({
+					pluginId: entry.pluginId,
+					phase: "on_step",
+					error
+				});
+			}
+			return prepared;
+		},
+		async applyBeforeModelCall(params) {
+			const prepared = {
+				input: [...params.input],
+				tools: [...params.tools],
+				toolChoice: params.toolChoice
+			};
+			if (beforeModelHooks.length === 0) return {
+				input: prepared.input,
+				tools: prepared.tools,
+				...prepared.toolChoice !== void 0 ? { toolChoice: prepared.toolChoice } : {}
+			};
+			const supportsTools = params.modelCaps?.tools === true;
+			const baseHookContext = {
+				runId: params.runId,
+				agentName: params.agentName,
+				stepIndex: params.stepIndex,
+				input: prepared.input,
+				...params.conversationId !== void 0 ? { conversationId: params.conversationId } : {},
+				setInput: (input) => {
+					prepared.input = [...input];
+					baseHookContext.input = prepared.input;
+				}
+			};
+			if (supportsTools) {
+				const toolHookContext = {
+					...baseHookContext,
+					tools: prepared.tools,
+					...prepared.toolChoice !== void 0 ? { toolChoice: prepared.toolChoice } : {},
+					setTools: (tools) => {
+						prepared.tools = [...tools];
+						toolHookContext.tools = prepared.tools;
+					},
+					setToolChoice: (choice) => {
+						prepared.toolChoice = choice;
+						if (choice === void 0) delete toolHookContext.toolChoice;
+						else toolHookContext.toolChoice = choice;
+					}
+				};
+				for (const entry of beforeModelHooks) try {
+					await entry.hook(toolHookContext);
+				} catch (error) {
+					reportPluginRuntimeError({
+						pluginId: entry.pluginId,
+						phase: "before_model_call",
+						error
+					});
+				}
+			} else for (const entry of beforeModelHooks) try {
+				await entry.hook(baseHookContext);
+			} catch (error) {
+				reportPluginRuntimeError({
+					pluginId: entry.pluginId,
+					phase: "before_model_call",
+					error
+				});
+			}
+			return {
+				input: prepared.input,
+				tools: prepared.tools,
+				...prepared.toolChoice !== void 0 ? { toolChoice: prepared.toolChoice } : {}
+			};
+		},
+		async applyAfterModelCall(params) {
+			if (afterModelHooks.length === 0) return;
+			const hookContext = {
+				runId: params.runId,
+				agentName: params.agentName,
+				stepIndex: params.stepIndex,
+				response: params.response,
+				...params.conversationId !== void 0 ? { conversationId: params.conversationId } : {}
+			};
+			for (const entry of afterModelHooks) try {
+				await entry.hook(hookContext);
+			} catch (error) {
+				reportPluginRuntimeError({
+					pluginId: entry.pluginId,
+					phase: "after_model_call",
+					error
+				});
+			}
+		},
+		async applyBeforeToolCall(params) {
+			const prepared = { args: params.args };
+			if (beforeToolHooks.length === 0) return prepared;
+			const hookContext = {
+				runId: params.runId,
+				agentName: params.agentName,
+				toolName: params.toolName,
+				toolCallId: params.toolCallId,
+				args: prepared.args,
+				...params.conversationId !== void 0 ? { conversationId: params.conversationId } : {},
+				setArgs: (args) => {
+					prepared.args = args;
+					hookContext.args = args;
+				}
+			};
+			for (const entry of beforeToolHooks) try {
+				const decision = await entry.hook(hookContext);
+				if (decision && decision.skip === true) return {
+					args: prepared.args,
+					decision
+				};
+			} catch (error) {
+				reportPluginRuntimeError({
+					pluginId: entry.pluginId,
+					phase: "before_tool_call",
+					error
+				});
+			}
+			return { args: prepared.args };
+		},
+		async applyAfterToolCall(params) {
+			const prepared = { result: params.result };
+			if (afterToolHooks.length === 0) return prepared;
+			const hookContext = {
+				runId: params.runId,
+				agentName: params.agentName,
+				toolName: params.toolName,
+				toolCallId: params.toolCallId,
+				args: params.args,
+				result: prepared.result,
+				...params.conversationId !== void 0 ? { conversationId: params.conversationId } : {},
+				...params.error !== void 0 ? { error: params.error } : {},
+				setResult: (result) => {
+					prepared.result = result;
+					hookContext.result = result;
+				}
+			};
+			for (const entry of afterToolHooks) try {
+				await entry.hook(hookContext);
+			} catch (error) {
+				reportPluginRuntimeError({
+					pluginId: entry.pluginId,
+					phase: "after_tool_call",
+					error
+				});
+			}
+			return prepared;
+		},
+		async applyBeforeSave(params) {
+			let items = [...params.items];
+			if (beforeSaveHooks.length === 0) return items;
+			const hookContext = {
+				runId: params.runId,
+				agentName: params.agentName,
+				items,
+				...params.conversationId !== void 0 ? { conversationId: params.conversationId } : {},
+				setItems: (nextItems) => {
+					items = [...nextItems];
+					hookContext.items = items;
+				}
+			};
+			for (const entry of beforeSaveHooks) try {
+				await entry.hook(hookContext);
+			} catch (error) {
+				reportPluginRuntimeError({
+					pluginId: entry.pluginId,
+					phase: "before_save",
+					error
+				});
+			}
+			return items;
+		}
+	};
+}
+/**
+* Validates and expands a plugin endpoint definition.
+*/
+function validateAndExpandEndpoint(endpoint, pluginId, seenEndpoints, endpoints) {
+	const path = endpoint.path.trim();
+	if (path.length === 0 || !path.startsWith("/")) throw BetterAgentError.fromCode("VALIDATION_FAILED", `Plugin '${pluginId}' endpoint path must start with '/'.`, {
+		context: {
+			pluginId,
+			path: endpoint.path
+		},
+		trace: [{ at: "core.plugins.createPluginRuntime" }]
+	});
+	const methods = Array.isArray(endpoint.method) ? endpoint.method : [endpoint.method];
+	if (methods.length === 0) throw BetterAgentError.fromCode("VALIDATION_FAILED", `Plugin '${pluginId}' endpoint must declare at least one method.`, {
+		context: {
+			pluginId,
+			path
+		},
+		trace: [{ at: "core.plugins.createPluginRuntime" }]
+	});
+	/** Allowed HTTP methods for plugin endpoints. */
+	const ALLOWED_METHODS = new Set([
+		"GET",
+		"POST",
+		"PUT",
+		"PATCH",
+		"DELETE",
+		"OPTIONS"
+	]);
+	for (const method of methods) {
+		if (!ALLOWED_METHODS.has(method)) throw BetterAgentError.fromCode("VALIDATION_FAILED", `Plugin '${pluginId}' endpoint has unsupported HTTP method '${method}'.`, {
+			context: {
+				pluginId,
+				path,
+				method
+			},
+			trace: [{ at: "core.plugins.createPluginRuntime" }]
+		});
+		const key = `${method} ${path}`;
+		if (seenEndpoints.has(key)) throw BetterAgentError.fromCode("VALIDATION_FAILED", `Duplicate plugin endpoint '${key}'.`, {
+			context: {
+				pluginId,
+				method,
+				path
+			},
+			trace: [{ at: "core.plugins.createPluginRuntime" }]
+		});
+		seenEndpoints.add(key);
+		endpoints.push({
+			pluginId,
+			method,
+			path,
+			...endpoint.public === true ? { public: true } : {},
+			handler: endpoint.handler
+		});
+	}
+}
+
+//#endregion
+export { createPluginRuntime, definePlugin };
+//# sourceMappingURL=runtime.mjs.map

package/dist/plugins/runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.mjs","names":[],"sources":["../../src/plugins/runtime.ts"],"sourcesContent":["import { BetterAgentError } from \"@better-agent/shared/errors\";\nimport { logger } from \"@better-agent/shared/logger\";\nimport type { HttpMethod } from \"../api\";\nimport type { Event } from \"../events\";\nimport type {\n    Capabilities,\n    GenerativeModelInputItem,\n    GenerativeModelInputMessageContent,\n    ToolChoice,\n} from \"../providers\";\nimport type { PreviousStepResult } from \"../run\";\nimport { resolveToolsForRun } from \"../tools\";\nimport type { AgentToolDefinition, ToolSource } from \"../tools\";\nimport type {\n    Plugin,\n    PluginEndpoint,\n    PluginEventMiddleware,\n    PluginGuard,\n    PluginModelCallContext,\n    PluginModelResponseContext,\n    PluginOnStepContext,\n    PluginRuntime,\n    PluginRuntimeEndpoint,\n    PluginSaveContext,\n    PluginToolCallContext,\n    PluginToolResultContext,\n} from \"./types\";\n\n/**\n * Defines a plugin.\n *\n * Plugin hook contexts are intentionally broad at authoring time. Some\n * capability-sensitive controls may be omitted at runtime for models that do\n * not support them.\n *\n * @param config Plugin configuration.\n * @returns The plugin definition with preserved literal types.\n */\nexport function definePlugin<const T extends Plugin>(config: T): T {\n    return config;\n}\n\n/**\n * Builds validated plugin runtime metadata for the runner and server.\n */\nexport function createPluginRuntime(plugins?: readonly Plugin[]): PluginRuntime {\n    const source = plugins ?? [];\n\n    const seenPluginIds = new Set<string>();\n    const seenEndpoints = new Set<string>();\n\n    const eventMiddlewares: Array<{\n        pluginId: string;\n        subscribe?: readonly Event[\"type\"][];\n        middleware: PluginEventMiddleware;\n    }> = [];\n    const guards: Array<{ pluginId: string; guard: PluginGuard }> = [];\n    const endpoints: PluginRuntimeEndpoint[] = [];\n    const onEventHandlers: Array<NonNullable<Plugin[\"onEvent\"]>> = [];\n    const toolSources: ToolSource<unknown>[] = [];\n    const onStepHooks: Array<{ pluginId: string; hook: NonNullable<Plugin[\"onStep\"]> }> = [];\n    const beforeModelHooks: Array<{\n        pluginId: string;\n        hook: NonNullable<Plugin[\"onBeforeModelCall\"]>;\n    }> = [];\n    const afterModelHooks: Array<{\n        pluginId: string;\n        hook: NonNullable<Plugin[\"onAfterModelCall\"]>;\n    }> = [];\n    const beforeToolHooks: Array<{\n        pluginId: string;\n        hook: NonNullable<Plugin[\"onBeforeToolCall\"]>;\n    }> = [];\n    const afterToolHooks: Array<{\n        pluginId: string;\n        hook: NonNullable<Plugin[\"onAfterToolCall\"]>;\n    }> = [];\n    const beforeSaveHooks: Array<{\n        pluginId: string;\n        hook: NonNullable<Plugin[\"onBeforeSave\"]>;\n    }> = [];\n\n    for (const plugin of source) {\n        const pluginId = plugin.id.trim();\n\n        // Validate plugin id before any hooks are collected.\n        if (pluginId.length === 0) {\n            throw BetterAgentError.fromCode(\n                \"VALIDATION_FAILED\",\n                \"Plugin id must be a non-empty string.\",\n                {\n                    trace: [{ at: \"core.plugins.createPluginRuntime\" }],\n                },\n            );\n        }\n\n        if (seenPluginIds.has(pluginId)) {\n            throw BetterAgentError.fromCode(\n                \"VALIDATION_FAILED\",\n                `Duplicate plugin id '${pluginId}'.`,\n                {\n                    context: { pluginId },\n                    trace: [{ at: \"core.plugins.createPluginRuntime\" }],\n                },\n            );\n        }\n\n        seenPluginIds.add(pluginId);\n\n        // Collect event middleware in registration order.\n        if (plugin.events?.middleware) {\n            for (const middleware of plugin.events.middleware) {\n                eventMiddlewares.push({\n                    pluginId,\n                    middleware,\n                    ...(plugin.events.subscribe !== undefined\n                        ? { subscribe: plugin.events.subscribe }\n                        : {}),\n                });\n            }\n        }\n\n        // Collect guards in registration order.\n        if (plugin.guards) {\n            for (const guard of plugin.guards) {\n                guards.push({ pluginId, guard });\n            }\n        }\n\n        // Collect and validate endpoints up front so the server can mount them safely.\n        for (const endpoint of plugin.endpoints ?? []) {\n            validateAndExpandEndpoint(endpoint, pluginId, seenEndpoints, endpoints);\n        }\n\n        if (plugin.onEvent) {\n            onEventHandlers.push(plugin.onEvent);\n        }\n\n        if (plugin.tools) {\n            toolSources.push(plugin.tools);\n        }\n\n        if (plugin.onStep) {\n            onStepHooks.push({ pluginId, hook: plugin.onStep });\n        }\n\n        if (plugin.onBeforeModelCall) {\n            beforeModelHooks.push({ pluginId, hook: plugin.onBeforeModelCall });\n        }\n\n        if (plugin.onAfterModelCall) {\n            afterModelHooks.push({ pluginId, hook: plugin.onAfterModelCall });\n        }\n\n        if (plugin.onBeforeToolCall) {\n            beforeToolHooks.push({ pluginId, hook: plugin.onBeforeToolCall });\n        }\n\n        if (plugin.onAfterToolCall) {\n            afterToolHooks.push({ pluginId, hook: plugin.onAfterToolCall });\n        }\n\n        if (plugin.onBeforeSave) {\n            beforeSaveHooks.push({ pluginId, hook: plugin.onBeforeSave });\n        }\n    }\n\n    const reportPluginRuntimeError = (params: {\n        pluginId: string;\n        phase:\n            | \"event_middleware\"\n            | \"guard\"\n            | \"on_event\"\n            | \"on_step\"\n            | \"before_model_call\"\n            | \"after_model_call\"\n            | \"before_tool_call\"\n            | \"after_tool_call\"\n            | \"before_save\";\n        error: unknown;\n    }) => {\n        logger.error(\n            `[better-agent] Plugin '${params.pluginId}' failed during ${params.phase}.`,\n            params.error,\n        );\n    };\n\n    return {\n        plugins: source,\n        endpoints,\n        hasEventMiddleware: eventMiddlewares.length > 0,\n        hasOnEvent: onEventHandlers.length > 0,\n        hasGuards: guards.length > 0,\n        hasTools: toolSources.length > 0,\n        hasOnStep: onStepHooks.length > 0,\n        hasModelHooks: beforeModelHooks.length > 0 || afterModelHooks.length > 0,\n        hasToolHooks: beforeToolHooks.length > 0 || afterToolHooks.length > 0,\n        hasOnBeforeSave: beforeSaveHooks.length > 0,\n\n        async dispatchEvent(event, ctx) {\n            const run = async (index: number, current: Event): Promise<Event | null> => {\n                for (let i = index; i < eventMiddlewares.length; i++) {\n                    const item = eventMiddlewares[i];\n                    if (!item) continue;\n\n                    if (item.subscribe && !item.subscribe.includes(current.type)) {\n                        continue;\n                    }\n\n                    try {\n                        const result = await item.middleware(current, ctx, async (nextEvent) => {\n                            return run(i + 1, nextEvent);\n                        });\n                        return result;\n                    } catch (error) {\n                        reportPluginRuntimeError({\n                            pluginId: item.pluginId,\n                            phase: \"event_middleware\",\n                            error,\n                        });\n                        return run(i + 1, current);\n                    }\n                }\n                return current;\n            };\n\n            return run(0, event);\n        },\n\n        async dispatchOnEvent(event, ctx) {\n            for (let i = 0; i < source.length; i += 1) {\n                const plugin = source[i];\n                if (!plugin?.onEvent) continue;\n\n                try {\n                    await plugin.onEvent(event, ctx);\n                } catch (error) {\n                    reportPluginRuntimeError({\n                        pluginId: plugin.id,\n                        phase: \"on_event\",\n                        error,\n                    });\n                }\n            }\n        },\n\n        async dispatchRun(ctx) {\n            for (const entry of guards) {\n                try {\n                    const response = await entry.guard(ctx);\n                    if (response) {\n                        // Guard rejected the request\n                        return response;\n                    }\n                } catch (error) {\n                    reportPluginRuntimeError({\n                        pluginId: entry.pluginId,\n                        phase: \"guard\",\n                        error,\n                    });\n                    throw BetterAgentError.wrap({\n                        err: error,\n                        message: `Plugin '${entry.pluginId}' guard failed.`,\n                        opts: {\n                            code: \"INTERNAL\",\n                            context: {\n                                pluginId: entry.pluginId,\n                                mode: ctx.mode,\n                                agentName: ctx.agentName,\n                            },\n                            trace: [{ at: \"core.plugins.createPluginRuntime.dispatchRun\" }],\n                        },\n                    });\n                }\n            }\n            // All guards passed\n            return null;\n        },\n\n        async resolveTools<TContext>(context?: TContext) {\n            if (toolSources.length === 0) {\n                return {\n                    tools: [],\n                    runCleanup: async () => {},\n                };\n            }\n\n            const cleanupTasks: Array<() => Promise<void> | void> = [];\n            const deduped = new Map<string, AgentToolDefinition>();\n\n            for (const source of toolSources) {\n                const resolved = await resolveToolsForRun<unknown>({\n                    agentTools: source,\n                    ...(context !== undefined ? { context: context as unknown } : {}),\n                });\n\n                cleanupTasks.push(resolved.runCleanup);\n                for (const tool of resolved.tools) {\n                    if (typeof tool.name !== \"string\") {\n                        continue;\n                    }\n\n                    if (deduped.has(tool.name)) {\n                        deduped.delete(tool.name);\n                    }\n                    deduped.set(tool.name, tool);\n                }\n            }\n\n            return {\n                tools: [...deduped.values()],\n                runCleanup: async () => {\n                    await Promise.allSettled(cleanupTasks.map(async (cleanup) => await cleanup()));\n                },\n            };\n        },\n\n        async applyOnStep<\n            TContext,\n            TToolName extends string = string,\n            TModelCaps extends Capabilities = Capabilities,\n        >(params: {\n            runId: string;\n            agentName: string;\n            conversationId?: string;\n            stepIndex: number;\n            maxSteps: number | undefined;\n            messages: GenerativeModelInputItem<TModelCaps>[];\n            context?: TContext;\n            previousStep?: PreviousStepResult;\n            /** Model capabilities to determine if setActiveTools should work */\n            modelCaps?: TModelCaps;\n        }) {\n            const prepared: {\n                messages: typeof params.messages;\n                toolChoice?: ToolChoice;\n                activeTools?: TToolName[];\n                systemInstruction?: GenerativeModelInputMessageContent<TModelCaps>;\n            } = {\n                messages: [...params.messages],\n            };\n\n            if (onStepHooks.length === 0) {\n                return prepared;\n            }\n\n            // Check if model supports tools\n            const supportsTools = params.modelCaps?.tools === true;\n            const supportsInstructionControl =\n                params.modelCaps === undefined\n                    ? true\n                    : params.modelCaps.inputShape !== \"prompt\" &&\n                      params.modelCaps.supportsInstruction === true;\n\n            const baseHookContext = {\n                runId: params.runId,\n                agentName: params.agentName,\n                stepIndex: params.stepIndex,\n                maxSteps: params.maxSteps,\n                messages: prepared.messages,\n                ...(params.conversationId !== undefined\n                    ? { conversationId: params.conversationId }\n                    : {}),\n                ...(params.context !== undefined ? { context: params.context as unknown } : {}),\n                ...(params.previousStep !== undefined ? { previousStep: params.previousStep } : {}),\n                updateMessages: (\n                    updater: (\n                        messages: GenerativeModelInputItem<TModelCaps>[],\n                    ) => GenerativeModelInputItem<TModelCaps>[],\n                ) => {\n                    prepared.messages = updater([...prepared.messages]);\n                    (baseHookContext as typeof hookContext).messages = prepared.messages;\n                },\n            };\n\n            const withInstructionControl = supportsInstructionControl\n                ? {\n                      ...baseHookContext,\n                      setSystemInstruction: (\n                          instruction: GenerativeModelInputMessageContent<TModelCaps>,\n                      ) => {\n                          prepared.systemInstruction = instruction;\n                      },\n                  }\n                : baseHookContext;\n\n            const hookContext = supportsTools\n                ? {\n                      ...withInstructionControl,\n                      setToolChoice: (choice: ToolChoice) => {\n                          prepared.toolChoice = choice;\n                      },\n                      setActiveTools: (names: readonly TToolName[]) => {\n                          prepared.activeTools = [...names];\n                      },\n                  }\n                : withInstructionControl;\n\n            for (const entry of onStepHooks) {\n                try {\n                    await entry.hook(hookContext as unknown as PluginOnStepContext);\n                } catch (error) {\n                    reportPluginRuntimeError({\n                        pluginId: entry.pluginId,\n                        phase: \"on_step\",\n                        error,\n                    });\n                }\n            }\n\n            return prepared;\n        },\n\n        async applyBeforeModelCall(params) {\n            const prepared: {\n                input: GenerativeModelInputItem[];\n                tools: AgentToolDefinition[];\n                toolChoice: ToolChoice | undefined;\n            } = {\n                input: [...params.input],\n                tools: [...params.tools],\n                toolChoice: params.toolChoice,\n            };\n\n            if (beforeModelHooks.length === 0) {\n                return {\n                    input: prepared.input,\n                    tools: prepared.tools,\n                    ...(prepared.toolChoice !== undefined\n                        ? { toolChoice: prepared.toolChoice }\n                        : {}),\n                };\n            }\n\n            const supportsTools = params.modelCaps?.tools === true;\n\n            const baseHookContext = {\n                runId: params.runId,\n                agentName: params.agentName,\n                stepIndex: params.stepIndex,\n                input: prepared.input,\n                ...(params.conversationId !== undefined\n                    ? { conversationId: params.conversationId }\n                    : {}),\n                setInput: (input: GenerativeModelInputItem[]) => {\n                    prepared.input = [...input];\n                    baseHookContext.input = prepared.input;\n                },\n            };\n\n            if (supportsTools) {\n                const toolHookContext = {\n                    ...baseHookContext,\n                    tools: prepared.tools,\n                    ...(prepared.toolChoice !== undefined\n                        ? { toolChoice: prepared.toolChoice }\n                        : {}),\n                    setTools: (tools: AgentToolDefinition[]) => {\n                        prepared.tools = [...tools];\n                        toolHookContext.tools = prepared.tools;\n                    },\n                    setToolChoice: (choice: ToolChoice | undefined) => {\n                        prepared.toolChoice = choice;\n                        if (choice === undefined) {\n                            // biome-ignore lint/performance/noDelete: <explanation>\n                            delete toolHookContext.toolChoice;\n                        } else {\n                            toolHookContext.toolChoice = choice;\n                        }\n                    },\n                };\n\n                for (const entry of beforeModelHooks) {\n                    try {\n                        await entry.hook(toolHookContext as PluginModelCallContext);\n                    } catch (error) {\n                        reportPluginRuntimeError({\n                            pluginId: entry.pluginId,\n                            phase: \"before_model_call\",\n                            error,\n                        });\n                    }\n                }\n            } else {\n                for (const entry of beforeModelHooks) {\n                    try {\n                        await entry.hook(baseHookContext as PluginModelCallContext);\n                    } catch (error) {\n                        reportPluginRuntimeError({\n                            pluginId: entry.pluginId,\n                            phase: \"before_model_call\",\n                            error,\n                        });\n                    }\n                }\n            }\n\n            return {\n                input: prepared.input,\n                tools: prepared.tools,\n                ...(prepared.toolChoice !== undefined ? { toolChoice: prepared.toolChoice } : {}),\n            };\n        },\n\n        async applyAfterModelCall(params) {\n            if (afterModelHooks.length === 0) {\n                return;\n            }\n\n            const hookContext: PluginModelResponseContext = {\n                runId: params.runId,\n                agentName: params.agentName,\n                stepIndex: params.stepIndex,\n                response: params.response,\n                ...(params.conversationId !== undefined\n                    ? { conversationId: params.conversationId }\n                    : {}),\n            };\n\n            for (const entry of afterModelHooks) {\n                try {\n                    await entry.hook(hookContext);\n                } catch (error) {\n                    reportPluginRuntimeError({\n                        pluginId: entry.pluginId,\n                        phase: \"after_model_call\",\n                        error,\n                    });\n                }\n            }\n        },\n\n        async applyBeforeToolCall(params) {\n            const prepared = { args: params.args };\n\n            if (beforeToolHooks.length === 0) {\n                return prepared;\n            }\n\n            const hookContext: PluginToolCallContext = {\n                runId: params.runId,\n                agentName: params.agentName,\n                toolName: params.toolName,\n                toolCallId: params.toolCallId,\n                args: prepared.args,\n                ...(params.conversationId !== undefined\n                    ? { conversationId: params.conversationId }\n                    : {}),\n                setArgs: (args) => {\n                    prepared.args = args;\n                    hookContext.args = args;\n                },\n            };\n\n            for (const entry of beforeToolHooks) {\n                try {\n                    const decision = await entry.hook(hookContext);\n                    if (decision && decision.skip === true) {\n                        return { args: prepared.args, decision };\n                    }\n                } catch (error) {\n                    reportPluginRuntimeError({\n                        pluginId: entry.pluginId,\n                        phase: \"before_tool_call\",\n                        error,\n                    });\n                }\n            }\n\n            return { args: prepared.args };\n        },\n\n        async applyAfterToolCall(params) {\n            const prepared = { result: params.result };\n\n            if (afterToolHooks.length === 0) {\n                return prepared;\n            }\n\n            const hookContext: PluginToolResultContext = {\n                runId: params.runId,\n                agentName: params.agentName,\n                toolName: params.toolName,\n                toolCallId: params.toolCallId,\n                args: params.args,\n                result: prepared.result,\n                ...(params.conversationId !== undefined\n                    ? { conversationId: params.conversationId }\n                    : {}),\n                ...(params.error !== undefined ? { error: params.error } : {}),\n                setResult: (result) => {\n                    prepared.result = result;\n                    hookContext.result = result;\n                },\n            };\n\n            for (const entry of afterToolHooks) {\n                try {\n                    await entry.hook(hookContext);\n                } catch (error) {\n                    reportPluginRuntimeError({\n                        pluginId: entry.pluginId,\n                        phase: \"after_tool_call\",\n                        error,\n                    });\n                }\n            }\n\n            return prepared;\n        },\n\n        async applyBeforeSave(params) {\n            let items = [...params.items];\n            if (beforeSaveHooks.length === 0) {\n                return items;\n            }\n\n            const hookContext: PluginSaveContext = {\n                runId: params.runId,\n                agentName: params.agentName,\n                items,\n                ...(params.conversationId !== undefined\n                    ? { conversationId: params.conversationId }\n                    : {}),\n                setItems: (nextItems) => {\n                    items = [...nextItems];\n                    hookContext.items = items;\n                },\n            };\n\n            for (const entry of beforeSaveHooks) {\n                try {\n                    await entry.hook(hookContext);\n                } catch (error) {\n                    reportPluginRuntimeError({\n                        pluginId: entry.pluginId,\n                        phase: \"before_save\",\n                        error,\n                    });\n                }\n            }\n\n            return items;\n        },\n    };\n}\n\n/**\n * Validates and expands a plugin endpoint definition.\n */\nfunction validateAndExpandEndpoint(\n    endpoint: PluginEndpoint,\n    pluginId: string,\n    seenEndpoints: Set<string>,\n    endpoints: PluginRuntimeEndpoint[],\n): void {\n    const path = endpoint.path.trim();\n\n    // Endpoint paths are always absolute route patterns.\n    if (path.length === 0 || !path.startsWith(\"/\")) {\n        throw BetterAgentError.fromCode(\n            \"VALIDATION_FAILED\",\n            `Plugin '${pluginId}' endpoint path must start with '/'.`,\n            {\n                context: { pluginId, path: endpoint.path },\n                trace: [{ at: \"core.plugins.createPluginRuntime\" }],\n            },\n        );\n    }\n\n    // Normalize methods into a flat list.\n    const methods = Array.isArray(endpoint.method) ? endpoint.method : [endpoint.method];\n\n    // Endpoints must declare at least one method.\n    if (methods.length === 0) {\n        throw BetterAgentError.fromCode(\n            \"VALIDATION_FAILED\",\n            `Plugin '${pluginId}' endpoint must declare at least one method.`,\n            {\n                context: { pluginId, path },\n                trace: [{ at: \"core.plugins.createPluginRuntime\" }],\n            },\n        );\n    }\n\n    /** Allowed HTTP methods for plugin endpoints. */\n    const ALLOWED_METHODS: Set<HttpMethod> = new Set([\n        \"GET\",\n        \"POST\",\n        \"PUT\",\n        \"PATCH\",\n        \"DELETE\",\n        \"OPTIONS\",\n    ]);\n\n    // Expand one endpoint per HTTP method.\n    for (const method of methods) {\n        if (!ALLOWED_METHODS.has(method)) {\n            throw BetterAgentError.fromCode(\n                \"VALIDATION_FAILED\",\n                `Plugin '${pluginId}' endpoint has unsupported HTTP method '${method}'.`,\n                {\n                    context: { pluginId, path, method },\n                    trace: [{ at: \"core.plugins.createPluginRuntime\" }],\n                },\n            );\n        }\n\n        // Duplicate method/path pairs are rejected at runtime construction time.\n        const key = `${method} ${path}`;\n        if (seenEndpoints.has(key)) {\n            throw BetterAgentError.fromCode(\n                \"VALIDATION_FAILED\",\n                `Duplicate plugin endpoint '${key}'.`,\n                {\n                    context: { pluginId, method, path },\n                    trace: [{ at: \"core.plugins.createPluginRuntime\" }],\n                },\n            );\n        }\n\n        seenEndpoints.add(key);\n        endpoints.push({\n            pluginId,\n            method,\n            path,\n            ...(endpoint.public === true ? { public: true } : {}),\n            handler: endpoint.handler,\n        });\n    }\n}\n"],"mappings":"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"}