@mastra/code-sdk 1.2.0-alpha.1 → 1.2.0-alpha.13

package/dist/hooks/types.d.ts

@@ -66,8 +66,28 @@ export interface HookStdinStop extends HookStdinBase {
     assistant_message?: string;
     stop_reason: 'complete' | 'aborted' | 'error';
 }
+/**
+ * Describes the git worktree a session is running in. Absent for sessions
+ * started in an ordinary checkout.
+ */
+export interface SessionWorktreeInfo {
+    /** Absolute path to the worktree root. */
+    path: string;
+    /** Branch checked out in the worktree, when it can be resolved. */
+    branch?: string;
+    /** Absolute path to the main repository the worktree is linked to. */
+    mainRepoPath?: string;
+}
 export interface HookStdinSession extends HookStdinBase {
     hook_event_name: 'SessionStart' | 'SessionEnd';
+    /**
+     * Set only when the session's project directory is a git worktree, so a hook
+     * can provision or tear down per-worktree resources (a database, a bucket, a
+     * dev server) and distinguish that from a session in the main checkout.
+     */
+    worktree_path?: string;
+    branch?: string;
+    main_repo_path?: string;
 }
 export interface HookStdinNotification extends HookStdinBase {
     hook_event_name: 'Notification';

package/dist/hooks/types.d.ts.map

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

package/dist/hooks/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/hooks/types.ts"],"sourcesContent":["/**\n * Type definitions for the hooks system.\n * Hooks are user-configured shell commands that run at lifecycle events.\n */\n\n// =============================================================================\n// Hook Event Names\n// =============================================================================\nexport type HookEventName =\n  | 'PreToolUse'\n  | 'PostToolUse'\n  | 'Stop'\n  | 'UserPromptSubmit'\n  | 'SessionStart'\n  | 'SessionEnd'\n  | 'Notification'\n  | 'AgentStart'\n  | 'AgentEnd'\n  | 'PermissionRequest'\n  | 'PermissionResult'\n  | 'Interrupt'\n  | 'SubagentStart'\n  | 'SubagentEnd';\n\nexport type BlockingHookEvent = 'PreToolUse' | 'Stop' | 'UserPromptSubmit';\n\n/** Lifecycle hook events are non-blocking: they observe behavior without changing it. */\nexport type LifecycleHookEvent =\n  | 'AgentStart'\n  | 'AgentEnd'\n  | 'PermissionRequest'\n  | 'PermissionResult'\n  | 'Interrupt'\n  | 'SubagentStart'\n  | 'SubagentEnd';\n\nexport function isBlockingEvent(event: HookEventName): event is BlockingHookEvent {\n  return event === 'PreToolUse' || event === 'Stop' || event === 'UserPromptSubmit';\n}\n\n// =============================================================================\n// Hook Configuration\n// =============================================================================\n\nexport interface HookMatcher {\n  /** Regex pattern matched against tool_name (PreToolUse/PostToolUse only). */\n  tool_name?: string;\n}\n\nexport interface HookDefinition {\n  /** Hook type. Only \"command\" supported in phase 1. */\n  type: 'command';\n  /** Shell command to execute via /bin/sh -c. */\n  command: string;\n  /** Optional matcher to filter when this hook runs. */\n  matcher?: HookMatcher;\n  /** Timeout in ms. Default 10000. Process killed after timeout. */\n  timeout?: number;\n  /** Human-readable description for /hooks display. */\n  description?: string;\n}\nexport interface HooksConfig {\n  PreToolUse?: HookDefinition[];\n  PostToolUse?: HookDefinition[];\n  Stop?: HookDefinition[];\n  UserPromptSubmit?: HookDefinition[];\n  SessionStart?: HookDefinition[];\n  SessionEnd?: HookDefinition[];\n  Notification?: HookDefinition[];\n  AgentStart?: HookDefinition[];\n  AgentEnd?: HookDefinition[];\n  PermissionRequest?: HookDefinition[];\n  PermissionResult?: HookDefinition[];\n  Interrupt?: HookDefinition[];\n  SubagentStart?: HookDefinition[];\n  SubagentEnd?: HookDefinition[];\n}\n\n// =============================================================================\n// Stdin Protocol (JSON sent to hook process)\n// =============================================================================\n\nexport interface HookStdinBase {\n  session_id: string;\n  cwd: string;\n  hook_event_name: HookEventName;\n  /**\n   * Stable MastraCode-generated id for the active agent run. Present on events\n   * emitted while a run is active (AgentStart..AgentEnd, tool hooks, Stop).\n   * Absent outside a run (SessionStart, SessionEnd, Notification fired idle).\n   */\n  run_id?: string;\n}\n\nexport interface HookStdinToolEvent extends HookStdinBase {\n  hook_event_name: 'PreToolUse' | 'PostToolUse';\n  tool_name: string;\n  tool_input: unknown;\n  tool_output?: unknown;\n  tool_error?: boolean;\n}\n\nexport interface HookStdinUserPrompt extends HookStdinBase {\n  hook_event_name: 'UserPromptSubmit';\n  user_message: string;\n}\n\nexport interface HookStdinStop extends HookStdinBase {\n  hook_event_name: 'Stop';\n  assistant_message?: string;\n  stop_reason: 'complete' | 'aborted' | 'error';\n}\nexport interface HookStdinSession extends HookStdinBase {\n  hook_event_name: 'SessionStart' | 'SessionEnd';\n}\n\nexport interface HookStdinNotification extends HookStdinBase {\n  hook_event_name: 'Notification';\n  /** Why the notification fired: agent_done, ask_question, tool_approval, plan_approval, sandbox_access */\n  reason: string;\n  /** Optional human-readable message for the notification. */\n  message?: string;\n}\n\nexport interface HookStdinAgentStart extends HookStdinBase {\n  hook_event_name: 'AgentStart';\n  run_id: string;\n}\n\nexport interface HookStdinAgentEnd extends HookStdinBase {\n  hook_event_name: 'AgentEnd';\n  run_id: string;\n  stop_reason: 'complete' | 'aborted' | 'error' | 'suspended';\n}\n\nexport type PermissionKind = 'tool_approval' | 'sandbox_access' | 'plan_approval';\n\nexport interface HookStdinPermissionRequest extends HookStdinBase {\n  hook_event_name: 'PermissionRequest';\n  run_id: string;\n  permission_kind: PermissionKind;\n  tool_call_id: string;\n  tool_name: string;\n  tool_input?: unknown;\n}\n\nexport type PermissionDecision = 'approved' | 'declined' | 'dismissed' | 'auto_approved' | 'auto_declined';\n\nexport interface HookStdinPermissionResult extends HookStdinBase {\n  hook_event_name: 'PermissionResult';\n  run_id: string;\n  permission_kind: PermissionKind;\n  tool_call_id: string;\n  tool_name: string;\n  tool_input?: unknown;\n  decision: PermissionDecision;\n}\n\nexport type InterruptReason = 'user_interrupt' | 'goal_judge_interrupt' | 'process_sigint';\n\nexport interface HookStdinInterrupt extends HookStdinBase {\n  hook_event_name: 'Interrupt';\n  run_id: string;\n  reason: InterruptReason;\n}\n\nexport interface HookStdinSubagentStart extends HookStdinBase {\n  hook_event_name: 'SubagentStart';\n  run_id: string;\n  tool_call_id: string;\n  agent_type: string;\n  task: string;\n  model_id?: string;\n  forked?: boolean;\n}\n\nexport interface HookStdinSubagentEnd extends HookStdinBase {\n  hook_event_name: 'SubagentEnd';\n  run_id: string;\n  tool_call_id: string;\n  agent_type: string;\n  result: unknown;\n  is_error: boolean;\n  duration_ms: number;\n}\n\nexport type HookStdin =\n  | HookStdinToolEvent\n  | HookStdinUserPrompt\n  | HookStdinStop\n  | HookStdinSession\n  | HookStdinNotification\n  | HookStdinAgentStart\n  | HookStdinAgentEnd\n  | HookStdinPermissionRequest\n  | HookStdinPermissionResult\n  | HookStdinInterrupt\n  | HookStdinSubagentStart\n  | HookStdinSubagentEnd;\n\n// =============================================================================\n// Stdout Protocol (JSON read from hook process)\n// =============================================================================\n\nexport interface HookStdout {\n  decision?: 'allow' | 'block';\n  reason?: string;\n  additionalContext?: string;\n}\n\n// =============================================================================\n// Execution Results\n// =============================================================================\n\nexport interface HookResult {\n  hook: HookDefinition;\n  exitCode: number;\n  stdout?: HookStdout;\n  stderr?: string;\n  timedOut: boolean;\n  durationMs: number;\n}\n\nexport interface HookEventResult {\n  allowed: boolean;\n  blockReason?: string;\n  additionalContext?: string;\n  results: HookResult[];\n  warnings: string[];\n}\n"],"mappings":";AAoCA,SAAgB,gBAAgB,OAAkD;CAChF,OAAO,UAAU,gBAAgB,UAAU,UAAU,UAAU;AACjE"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/hooks/types.ts"],"sourcesContent":["/**\n * Type definitions for the hooks system.\n * Hooks are user-configured shell commands that run at lifecycle events.\n */\n\n// =============================================================================\n// Hook Event Names\n// =============================================================================\nexport type HookEventName =\n  | 'PreToolUse'\n  | 'PostToolUse'\n  | 'Stop'\n  | 'UserPromptSubmit'\n  | 'SessionStart'\n  | 'SessionEnd'\n  | 'Notification'\n  | 'AgentStart'\n  | 'AgentEnd'\n  | 'PermissionRequest'\n  | 'PermissionResult'\n  | 'Interrupt'\n  | 'SubagentStart'\n  | 'SubagentEnd';\n\nexport type BlockingHookEvent = 'PreToolUse' | 'Stop' | 'UserPromptSubmit';\n\n/** Lifecycle hook events are non-blocking: they observe behavior without changing it. */\nexport type LifecycleHookEvent =\n  | 'AgentStart'\n  | 'AgentEnd'\n  | 'PermissionRequest'\n  | 'PermissionResult'\n  | 'Interrupt'\n  | 'SubagentStart'\n  | 'SubagentEnd';\n\nexport function isBlockingEvent(event: HookEventName): event is BlockingHookEvent {\n  return event === 'PreToolUse' || event === 'Stop' || event === 'UserPromptSubmit';\n}\n\n// =============================================================================\n// Hook Configuration\n// =============================================================================\n\nexport interface HookMatcher {\n  /** Regex pattern matched against tool_name (PreToolUse/PostToolUse only). */\n  tool_name?: string;\n}\n\nexport interface HookDefinition {\n  /** Hook type. Only \"command\" supported in phase 1. */\n  type: 'command';\n  /** Shell command to execute via /bin/sh -c. */\n  command: string;\n  /** Optional matcher to filter when this hook runs. */\n  matcher?: HookMatcher;\n  /** Timeout in ms. Default 10000. Process killed after timeout. */\n  timeout?: number;\n  /** Human-readable description for /hooks display. */\n  description?: string;\n}\nexport interface HooksConfig {\n  PreToolUse?: HookDefinition[];\n  PostToolUse?: HookDefinition[];\n  Stop?: HookDefinition[];\n  UserPromptSubmit?: HookDefinition[];\n  SessionStart?: HookDefinition[];\n  SessionEnd?: HookDefinition[];\n  Notification?: HookDefinition[];\n  AgentStart?: HookDefinition[];\n  AgentEnd?: HookDefinition[];\n  PermissionRequest?: HookDefinition[];\n  PermissionResult?: HookDefinition[];\n  Interrupt?: HookDefinition[];\n  SubagentStart?: HookDefinition[];\n  SubagentEnd?: HookDefinition[];\n}\n\n// =============================================================================\n// Stdin Protocol (JSON sent to hook process)\n// =============================================================================\n\nexport interface HookStdinBase {\n  session_id: string;\n  cwd: string;\n  hook_event_name: HookEventName;\n  /**\n   * Stable MastraCode-generated id for the active agent run. Present on events\n   * emitted while a run is active (AgentStart..AgentEnd, tool hooks, Stop).\n   * Absent outside a run (SessionStart, SessionEnd, Notification fired idle).\n   */\n  run_id?: string;\n}\n\nexport interface HookStdinToolEvent extends HookStdinBase {\n  hook_event_name: 'PreToolUse' | 'PostToolUse';\n  tool_name: string;\n  tool_input: unknown;\n  tool_output?: unknown;\n  tool_error?: boolean;\n}\n\nexport interface HookStdinUserPrompt extends HookStdinBase {\n  hook_event_name: 'UserPromptSubmit';\n  user_message: string;\n}\n\nexport interface HookStdinStop extends HookStdinBase {\n  hook_event_name: 'Stop';\n  assistant_message?: string;\n  stop_reason: 'complete' | 'aborted' | 'error';\n}\n/**\n * Describes the git worktree a session is running in. Absent for sessions\n * started in an ordinary checkout.\n */\nexport interface SessionWorktreeInfo {\n  /** Absolute path to the worktree root. */\n  path: string;\n  /** Branch checked out in the worktree, when it can be resolved. */\n  branch?: string;\n  /** Absolute path to the main repository the worktree is linked to. */\n  mainRepoPath?: string;\n}\n\nexport interface HookStdinSession extends HookStdinBase {\n  hook_event_name: 'SessionStart' | 'SessionEnd';\n  /**\n   * Set only when the session's project directory is a git worktree, so a hook\n   * can provision or tear down per-worktree resources (a database, a bucket, a\n   * dev server) and distinguish that from a session in the main checkout.\n   */\n  worktree_path?: string;\n  branch?: string;\n  main_repo_path?: string;\n}\n\nexport interface HookStdinNotification extends HookStdinBase {\n  hook_event_name: 'Notification';\n  /** Why the notification fired: agent_done, ask_question, tool_approval, plan_approval, sandbox_access */\n  reason: string;\n  /** Optional human-readable message for the notification. */\n  message?: string;\n}\n\nexport interface HookStdinAgentStart extends HookStdinBase {\n  hook_event_name: 'AgentStart';\n  run_id: string;\n}\n\nexport interface HookStdinAgentEnd extends HookStdinBase {\n  hook_event_name: 'AgentEnd';\n  run_id: string;\n  stop_reason: 'complete' | 'aborted' | 'error' | 'suspended';\n}\n\nexport type PermissionKind = 'tool_approval' | 'sandbox_access' | 'plan_approval';\n\nexport interface HookStdinPermissionRequest extends HookStdinBase {\n  hook_event_name: 'PermissionRequest';\n  run_id: string;\n  permission_kind: PermissionKind;\n  tool_call_id: string;\n  tool_name: string;\n  tool_input?: unknown;\n}\n\nexport type PermissionDecision = 'approved' | 'declined' | 'dismissed' | 'auto_approved' | 'auto_declined';\n\nexport interface HookStdinPermissionResult extends HookStdinBase {\n  hook_event_name: 'PermissionResult';\n  run_id: string;\n  permission_kind: PermissionKind;\n  tool_call_id: string;\n  tool_name: string;\n  tool_input?: unknown;\n  decision: PermissionDecision;\n}\n\nexport type InterruptReason = 'user_interrupt' | 'goal_judge_interrupt' | 'process_sigint';\n\nexport interface HookStdinInterrupt extends HookStdinBase {\n  hook_event_name: 'Interrupt';\n  run_id: string;\n  reason: InterruptReason;\n}\n\nexport interface HookStdinSubagentStart extends HookStdinBase {\n  hook_event_name: 'SubagentStart';\n  run_id: string;\n  tool_call_id: string;\n  agent_type: string;\n  task: string;\n  model_id?: string;\n  forked?: boolean;\n}\n\nexport interface HookStdinSubagentEnd extends HookStdinBase {\n  hook_event_name: 'SubagentEnd';\n  run_id: string;\n  tool_call_id: string;\n  agent_type: string;\n  result: unknown;\n  is_error: boolean;\n  duration_ms: number;\n}\n\nexport type HookStdin =\n  | HookStdinToolEvent\n  | HookStdinUserPrompt\n  | HookStdinStop\n  | HookStdinSession\n  | HookStdinNotification\n  | HookStdinAgentStart\n  | HookStdinAgentEnd\n  | HookStdinPermissionRequest\n  | HookStdinPermissionResult\n  | HookStdinInterrupt\n  | HookStdinSubagentStart\n  | HookStdinSubagentEnd;\n\n// =============================================================================\n// Stdout Protocol (JSON read from hook process)\n// =============================================================================\n\nexport interface HookStdout {\n  decision?: 'allow' | 'block';\n  reason?: string;\n  additionalContext?: string;\n}\n\n// =============================================================================\n// Execution Results\n// =============================================================================\n\nexport interface HookResult {\n  hook: HookDefinition;\n  exitCode: number;\n  stdout?: HookStdout;\n  stderr?: string;\n  timedOut: boolean;\n  durationMs: number;\n}\n\nexport interface HookEventResult {\n  allowed: boolean;\n  blockReason?: string;\n  additionalContext?: string;\n  results: HookResult[];\n  warnings: string[];\n}\n"],"mappings":";AAoCA,SAAgB,gBAAgB,OAAkD;CAChF,OAAO,UAAU,gBAAgB,UAAU,UAAU,UAAU;AACjE"}

package/dist/index.d.ts

@@ -128,6 +128,40 @@ export declare function createMastraCodeAgentController(config?: MastraCodeConfi
     sessionId: string;
     ownerId: string;
     setActiveSession: (session: Session<MastraCodeState>) => void;
+    /**
+     * Starts the signal providers contributed by plugins. Called by the
+     * composition layer once the controller is inited, because that is when a
+     * Mastra instance exists — a provider without one has no storage, and
+     * nothing else will hand it one: the Agent propagates Mastra only to the
+     * providers in its own `signals` array, which these deliberately are not in.
+     */
+    startPluginSignalProviders: () => void;
+    /**
+     * Stops every plugin-contributed signal provider and stops listening for
+     * plugin reloads. The inverse of `startPluginSignalProviders`, for an
+     * embedder that is done with this controller: a `pluginManager` shared
+     * across controllers (`MastraCodeConfig.pluginManager`) outlives any one of
+     * them, so without this its providers keep polling and its reload listener
+     * keeps firing for a controller that is gone.
+     */
+    stopPluginSignalProviders: () => void;
+    /**
+     * Hands Mastra to the statically configured input processors.
+     *
+     * The Agent does this itself, but only for processors configured as a
+     * plain array (`Array.isArray` in `__registerMastra`). This lane is a
+     * function so plugins can contribute to it, which takes those processors
+     * out of that branch — including any an embedder passed as
+     * `config.inputProcessors`, some of which need Mastra to work at all
+     * (`CostGuardProcessor` reads observability storage there). Doing it here
+     * keeps that unchanged.
+     *
+     * Plugin processors are deliberately not included: they come and go with
+     * their plugin, and the registry keeps the first instance registered under
+     * an id forever, which would leave a retired instance behind. Plugins
+     * reach Mastra through `getController()` on the plugin context instead.
+     */
+    registerConfiguredProcessorsWithMastra: () => void;
 }>;
 /**
  * Result of {@link createMastraCodeAgentController}: every shared resource plus the
@@ -175,6 +209,40 @@ export declare function bootLocalAgentController(config?: MastraCodeConfig): Pro
     sessionId: string;
     ownerId: string;
     setActiveSession: (session: Session<MastraCodeState>) => void;
+    /**
+     * Starts the signal providers contributed by plugins. Called by the
+     * composition layer once the controller is inited, because that is when a
+     * Mastra instance exists — a provider without one has no storage, and
+     * nothing else will hand it one: the Agent propagates Mastra only to the
+     * providers in its own `signals` array, which these deliberately are not in.
+     */
+    startPluginSignalProviders: () => void;
+    /**
+     * Stops every plugin-contributed signal provider and stops listening for
+     * plugin reloads. The inverse of `startPluginSignalProviders`, for an
+     * embedder that is done with this controller: a `pluginManager` shared
+     * across controllers (`MastraCodeConfig.pluginManager`) outlives any one of
+     * them, so without this its providers keep polling and its reload listener
+     * keeps firing for a controller that is gone.
+     */
+    stopPluginSignalProviders: () => void;
+    /**
+     * Hands Mastra to the statically configured input processors.
+     *
+     * The Agent does this itself, but only for processors configured as a
+     * plain array (`Array.isArray` in `__registerMastra`). This lane is a
+     * function so plugins can contribute to it, which takes those processors
+     * out of that branch — including any an embedder passed as
+     * `config.inputProcessors`, some of which need Mastra to work at all
+     * (`CostGuardProcessor` reads observability storage there). Doing it here
+     * keeps that unchanged.
+     *
+     * Plugin processors are deliberately not included: they come and go with
+     * their plugin, and the registry keeps the first instance registered under
+     * an id forever, which would leave a retired instance behind. Plugins
+     * reach Mastra through `getController()` on the plugin context instead.
+     */
+    registerConfiguredProcessorsWithMastra: () => void;
 }>;
 /** Result of {@link mountAgentControllerOnMastra}: shared handles plus the owning Mastra. */
 export type MountedMastraCode = MastraCodeAgentController & {

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -29,6 +29,7 @@ import { hasExplicitOMConfiguration } from "./onboarding/om-settings.js";
 import { getAvailableModePacks, getAvailableOmPacks, selectPreferredOMPack } from "./onboarding/packs.js";
 import { getToolCategory } from "./permissions.js";
 import { PluginManager } from "./plugins/manager.js";
+import { PluginSignalLane } from "./plugins/signal-lane.js";
 import { PlanRejectionAbortProcessor } from "./processors/plan-rejection-abort.js";
 import { stateSchema } from "./schema.js";
 import { mastraBrand } from "./theme-palette.js";
@@ -50,6 +51,7 @@ import { AgentController } from "@mastra/core/agent-controller";
 import { createCodingAgent } from "@mastra/core/coding-agent";
 import { PROVIDER_REGISTRY } from "@mastra/core/llm";
 import { Mastra } from "@mastra/core/mastra";
+import { defaultNotificationDeliveryDecision } from "@mastra/core/notifications";
 import { AgentsMDInjector, PrefillErrorHandler, ProviderHistoryCompat, StreamErrorRetryProcessor, isBadRequestError } from "@mastra/core/processors";
 import { RequestContext } from "@mastra/core/request-context";
 import { InMemoryHarness, MastraCompositeStore } from "@mastra/core/storage";
@@ -201,6 +203,7 @@ async function createMastraCodeAgentController(config) {
 	const homeDir = config?.homeDir ?? config?.initialState?.homeDir;
 	const configDir = config?.configDir ?? ".mastracode";
 	let activeSession;
+	let pluginRuntimeController;
 	if (configDir !== ".mastracode") validateConfigDirName(configDir);
 	try {
 		process.loadEnvFile(path.join(cwd, ".env"));
@@ -314,66 +317,136 @@ async function createMastraCodeAgentController(config) {
 	});
 	const memory = config?.memory === false ? void 0 : config?.memory ?? getDynamicMemory(storage, vector);
 	const mcpManager = config?.disableMcp ? void 0 : createMcpManager(project.rootPath, configDir, config?.mcpServers);
-	const hookManager = config?.disableHooks ? void 0 : new HookManager(project.rootPath, "session-init", configDir, homeDir);
+	const hookManager = config?.disableHooks ? void 0 : new HookManager(project.rootPath, "session-init", configDir, homeDir, project.isWorktree ? {
+		path: project.rootPath,
+		branch: project.gitBranch,
+		mainRepoPath: project.mainRepoPath
+	} : void 0);
 	const pluginManager = config?.disablePlugins ? void 0 : config?.pluginManager ?? new PluginManager({
 		projectRoot: project.rootPath,
 		configDir,
 		homeDir
 	});
+	pluginManager?.setRuntime({
+		getController: () => pluginRuntimeController,
+		getActiveSession: () => activeSession
+	});
 	const loadedPlugins = pluginManager ? await pluginManager.reload() : [];
 	const pluginTools = pluginManager?.getPluginTools() ?? {};
 	const outcomeScorer = createOutcomeScorer();
 	const efficiencyScorer = createEfficiencyScorer();
+	const getNotificationStreamOptions = async ({ resourceId, threadId }) => {
+		const session = await controller.getSessionByResource(resourceId) ?? activeSession;
+		if (!session) return void 0;
+		const modeId = session.mode.get();
+		const defaultModeModelId = controller.listModes().find((mode) => mode.id === modeId)?.defaultModelId;
+		const modelId = session.model.get() || activeSession?.model.get() || defaultModeModelId || "";
+		const requestContext = new RequestContext();
+		const agentControllerContext = {
+			controllerId: controller.id,
+			state: session.state.get(),
+			getState: () => session.state.get(),
+			setState: (updates) => session.state.set(updates),
+			threadId,
+			resourceId,
+			session: {
+				id: session.identity.getId(),
+				ownerId: session.identity.getOwnerId(),
+				modeId,
+				modelId,
+				state: {
+					get: () => session.state.get(),
+					set: (updates) => session.state.set(updates),
+					update: (updater) => session.state.update(updater)
+				}
+			},
+			workspace: session.getWorkspace(),
+			getSubagentModelId: (params) => session.subagents.model.get(params ?? {})
+		};
+		requestContext.set("controller", agentControllerContext);
+		return {
+			memory: {
+				thread: threadId,
+				resource: resourceId
+			},
+			requestContext,
+			maxSteps: 1e3,
+			savePerStep: false,
+			requireToolApproval: session.state.get().yolo !== true,
+			modelSettings: { temperature: 1 }
+		};
+	};
 	const githubSignals = globalSettings.signals?.experimentalGithubSignals && !config?.disableGithubSignals ? new GithubSignals({
 		cwd: project.rootPath,
 		gitcrawlCommand: process.env.MASTRACODE_GITCRAWL_BIN ?? process.env.GITCRAWL_BIN ?? process.env.MASTRACODE_GITCRAWL_COMMAND ?? process.env.GITCRAWL_COMMAND,
-		getNotificationStreamOptions: async ({ resourceId, threadId }) => {
-			const session = await controller.getSessionByResource(resourceId) ?? activeSession;
-			const modeId = session.mode.get();
-			const defaultModeModelId = controller.listModes().find((mode) => mode.id === modeId)?.defaultModelId;
-			const modelId = session.model.get() || activeSession?.model.get() || defaultModeModelId || "";
-			const requestContext = new RequestContext();
-			const agentControllerContext = {
-				controllerId: controller.id,
-				state: session.state.get(),
-				getState: () => session.state.get(),
-				setState: (updates) => session.state.set(updates),
-				threadId,
-				resourceId,
-				session: {
-					id: session.identity.getId(),
-					ownerId: session.identity.getOwnerId(),
-					modeId,
-					modelId,
-					state: {
-						get: () => session.state.get(),
-						set: (updates) => session.state.set(updates),
-						update: (updater) => session.state.update(updater)
-					}
-				},
-				workspace: controller.getWorkspace(),
-				getSubagentModelId: (params) => session.subagents.model.get(params ?? {})
-			};
-			requestContext.set("controller", agentControllerContext);
-			return {
-				memory: {
-					thread: threadId,
-					resource: resourceId
-				},
-				requestContext,
-				maxSteps: 1e3,
-				savePerStep: false,
-				requireToolApproval: session.state.get().yolo !== true,
-				modelSettings: { temperature: 1 }
-			};
-		}
+		getNotificationStreamOptions
 	}) : void 0;
+	const mastraCodeInputProcessors = [
+		...config?.inputProcessors ?? [],
+		new PlanRejectionAbortProcessor(),
+		new AgentsMDInjector({
+			isEnabled: ({ requestContext }) => {
+				const state = getInjectorSessionState(requestContext);
+				return state?.untrustedCheckout !== true || typeof state?.baseRef === "string";
+			},
+			getReader: ({ requestContext }) => {
+				const state = getInjectorSessionState(requestContext);
+				if (state?.untrustedCheckout !== true || typeof state?.baseRef !== "string") return void 0;
+				return createGitRefReminderReader(state?.projectPath ?? project.rootPath, state.baseRef);
+			},
+			getIgnoredInstructionPaths: ({ requestContext }) => {
+				const state = getInjectorSessionState(requestContext);
+				const projectPath = state?.projectPath ?? project.rootPath;
+				return getStaticallyLoadedInstructionPaths(projectPath, void 0, state?.untrustedCheckout === true && typeof state?.baseRef === "string" ? createGitRefInstructionReader(projectPath, state.baseRef) : void 0);
+			}
+		}),
+		new ProviderHistoryCompat()
+	];
+	const taskSignalProvider = new TaskSignalProvider();
+	const NO_PLUGIN_PROCESSORS = {
+		input: [],
+		output: []
+	};
+	let pluginProcessorReadWarned = false;
+	const pluginSignalLane = pluginManager ? new PluginSignalLane({ reservedProviderIds: [taskSignalProvider.id, ...githubSignals ? [githubSignals.id] : []] }) : void 0;
+	let unsubscribePluginReload;
+	/**
+	* Plugin processors are read through a function so that enabling, disabling or
+	* updating a plugin takes effect on the next request rather than requiring a
+	* new agent. This runs before every LLM call, and also outside the request
+	* path when the Agent catalogues its configured processors — where a throw is
+	* swallowed into a debug log. So it only reads already-resolved state: no
+	* filesystem, no network, no construction, and it never throws.
+	*/
+	const readPluginProcessors = () => {
+		try {
+			return pluginManager?.getPluginProcessors() ?? NO_PLUGIN_PROCESSORS;
+		} catch (error) {
+			if (!pluginProcessorReadWarned) {
+				pluginProcessorReadWarned = true;
+				console.warn("Failed to read plugin processors:", error);
+			}
+			return NO_PLUGIN_PROCESSORS;
+		}
+	};
 	const codeAgent = createCodingAgent({
 		id: CODE_AGENT_ID,
 		name: "Code Agent",
 		workspace: void 0,
 		instructions: getDynamicInstructions,
-		model: getDynamicModel,
+		model: (ctx) => getDynamicModel(ctx, config?.settingsPath),
+		notifications: { deliveryPolicy: { decide: async (input) => {
+			const decision = defaultNotificationDeliveryDecision(input);
+			if (!input.record.resourceId) return decision;
+			const streamOptions = await getNotificationStreamOptions({
+				resourceId: input.record.resourceId,
+				threadId: input.record.threadId
+			});
+			return streamOptions ? {
+				...decision,
+				streamOptions
+			} : decision;
+		} } },
 		tools: createDynamicTools(mcpManager, config?.extraTools, config?.disabledTools, storage, pluginTools),
 		hooks: createToolHooks(hookManager, config?.postToolObserver),
 		scorers: {
@@ -389,7 +462,7 @@ async function createMastraCodeAgentController(config) {
 				}
 			}
 		},
-		signals: [new TaskSignalProvider(), ...githubSignals ? [githubSignals] : []],
+		signals: [taskSignalProvider, ...githubSignals ? [githubSignals] : []],
 		goal: {
 			judge: (ctx) => getGoalJudgeModel(ctx, config?.settingsPath),
 			maxRuns: globalSettings.models.goalMaxTurns ?? 50,
@@ -397,27 +470,12 @@ async function createMastraCodeAgentController(config) {
 			prompt: DEFAULT_GOAL_JUDGE_PROMPT,
 			tools: getGoalJudgeTools
 		},
-		inputProcessors: [
-			...config?.inputProcessors ?? [],
-			new PlanRejectionAbortProcessor(),
-			new AgentsMDInjector({
-				isEnabled: ({ requestContext }) => {
-					const state = getInjectorSessionState(requestContext);
-					return state?.untrustedCheckout !== true || typeof state?.baseRef === "string";
-				},
-				getReader: ({ requestContext }) => {
-					const state = getInjectorSessionState(requestContext);
-					if (state?.untrustedCheckout !== true || typeof state?.baseRef !== "string") return void 0;
-					return createGitRefReminderReader(state?.projectPath ?? project.rootPath, state.baseRef);
-				},
-				getIgnoredInstructionPaths: ({ requestContext }) => {
-					const state = getInjectorSessionState(requestContext);
-					const projectPath = state?.projectPath ?? project.rootPath;
-					return getStaticallyLoadedInstructionPaths(projectPath, void 0, state?.untrustedCheckout === true && typeof state?.baseRef === "string" ? createGitRefInstructionReader(projectPath, state.baseRef) : void 0);
-				}
-			}),
-			new ProviderHistoryCompat()
+		inputProcessors: () => [
+			...mastraCodeInputProcessors,
+			...readPluginProcessors().input.map((entry) => entry.value),
+			...pluginSignalLane?.getInputProcessors() ?? []
 		],
+		outputProcessors: () => [...readPluginProcessors().output.map((entry) => entry.value), ...pluginSignalLane?.getOutputProcessors() ?? []],
 		errorProcessors: [
 			new ProviderHistoryCompat(),
 			new StreamErrorRetryProcessor({ matchers: [
@@ -518,7 +576,6 @@ async function createMastraCodeAgentController(config) {
 		if (effectiveObserveAttachments !== void 0) globalInitialState.observeAttachments = effectiveObserveAttachments;
 	}
 	if (globalSettings.preferences.yolo !== null) globalInitialState.yolo = globalSettings.preferences.yolo;
-	globalInitialState.thinkingLevel = globalSettings.preferences.thinkingLevel;
 	if (config?.omScope) globalInitialState.omScope = config.omScope;
 	for (const [key, modelId] of Object.entries(globalSettings.models.subagentModels)) if (key === "default" || key === "_default") globalInitialState.subagentModelId = modelId;
 	else globalInitialState[`subagentModelId_${key}`] = modelId;
@@ -567,6 +624,11 @@ async function createMastraCodeAgentController(config) {
 			release: releaseThreadLock
 		}
 	});
+	pluginRuntimeController = controller;
+	if (pluginSignalLane && pluginManager) {
+		pluginSignalLane.sync(pluginManager.getPluginSignalProviders());
+		unsubscribePluginReload = pluginManager.onReload(() => pluginSignalLane.sync(pluginManager.getPluginSignalProviders()));
+	}
 	return {
 		controller,
 		storage,
@@ -591,6 +653,55 @@ async function createMastraCodeAgentController(config) {
 		ownerId,
 		setActiveSession: (session) => {
 			activeSession = session;
+		},
+		/**
+		* Starts the signal providers contributed by plugins. Called by the
+		* composition layer once the controller is inited, because that is when a
+		* Mastra instance exists — a provider without one has no storage, and
+		* nothing else will hand it one: the Agent propagates Mastra only to the
+		* providers in its own `signals` array, which these deliberately are not in.
+		*/
+		startPluginSignalProviders: () => {
+			const mastra = controller.getMastra();
+			if (!pluginSignalLane || !mastra) return;
+			pluginSignalLane.setMastra(mastra, codeAgent);
+		},
+		/**
+		* Stops every plugin-contributed signal provider and stops listening for
+		* plugin reloads. The inverse of `startPluginSignalProviders`, for an
+		* embedder that is done with this controller: a `pluginManager` shared
+		* across controllers (`MastraCodeConfig.pluginManager`) outlives any one of
+		* them, so without this its providers keep polling and its reload listener
+		* keeps firing for a controller that is gone.
+		*/
+		stopPluginSignalProviders: () => {
+			unsubscribePluginReload?.();
+			unsubscribePluginReload = void 0;
+			pluginSignalLane?.stopAll();
+		},
+		/**
+		* Hands Mastra to the statically configured input processors.
+		*
+		* The Agent does this itself, but only for processors configured as a
+		* plain array (`Array.isArray` in `__registerMastra`). This lane is a
+		* function so plugins can contribute to it, which takes those processors
+		* out of that branch — including any an embedder passed as
+		* `config.inputProcessors`, some of which need Mastra to work at all
+		* (`CostGuardProcessor` reads observability storage there). Doing it here
+		* keeps that unchanged.
+		*
+		* Plugin processors are deliberately not included: they come and go with
+		* their plugin, and the registry keeps the first instance registered under
+		* an id forever, which would leave a retired instance behind. Plugins
+		* reach Mastra through `getController()` on the plugin context instead.
+		*/
+		registerConfiguredProcessorsWithMastra: () => {
+			const mastra = controller.getMastra();
+			if (!mastra) return;
+			for (const processor of mastraCodeInputProcessors) {
+				mastra.addProcessor(processor);
+				mastra.addProcessorConfiguration(processor, CODE_AGENT_ID, "input");
+			}
 		}
 	};
 }
@@ -643,6 +754,8 @@ async function bootLocalAgentController(config) {
 	const { controller, sessionId, ownerId } = base;
 	await controller.init();
 	await controller.getMastra()?.startWorkers();
+	base.registerConfiguredProcessorsWithMastra();
+	base.startPluginSignalProviders();
 	const session = await controller.createSession({
 		id: sessionId,
 		ownerId
@@ -720,6 +833,8 @@ async function prepareAgentControllerMount(config) {
 	const finalize = async () => {
 		await controller.init();
 		await controller.getMastra()?.startWorkers();
+		base.registerConfiguredProcessorsWithMastra();
+		base.startPluginSignalProviders();
 	};
 	return {
 		base,