@mastra/code-sdk 1.1.4-alpha.0 → 1.2.0-alpha.10

package/dist/agents/model.js

@@ -1,4 +1,4 @@
-import { loadSettings } from "../onboarding/settings.js";
+import { loadSettings, resolveDefaultThinkingLevel, stripMastraCodeCustomProviderPrefix } from "../onboarding/settings.js";
 import { hasCredentialStoreProvider, resolveCredentialStore, resolveTenantFromRequestContext, setCredentialStoreProvider } from "./credential-resolver.js";
 import { AMAZON_BEDROCK_GATEWAY_ID, createAmazonBedrockGateway } from "../providers/amazon-bedrock-gateway.js";
 import { hasCustomProvidersSource, resolveCustomProviders, setCustomProvidersSource } from "./custom-provider-source.js";
@@ -40,7 +40,9 @@ function resolveModel(modelId, options) {
 	const headers = getAgentControllerHeaders(options?.requestContext);
 	const settings = loadSettings();
 	const bedrockLegacyPrefix = `${MASTRACODE_GATEWAY_ID}/amazon-bedrock/`;
-	const normalizedInput = modelId.startsWith(bedrockLegacyPrefix) ? modelId.slice(MASTRACODE_GATEWAY_ID.length + 1) : modelId;
+	const bedrockNormalizedInput = modelId.startsWith(bedrockLegacyPrefix) ? modelId.slice(MASTRACODE_GATEWAY_ID.length + 1) : modelId;
+	const customProviders = resolveCustomProviders(options?.requestContext) ?? settings.customProviders;
+	const normalizedInput = stripMastraCodeCustomProviderPrefix(bedrockNormalizedInput, customProviders);
 	const isMastraGatewayModel = normalizedInput.startsWith(MASTRA_GATEWAY_PREFIX);
 	const normalizedModelId = stripMastraGatewayPrefix(normalizedInput);
 	const [providerId, ...modelParts] = normalizedModelId.split("/");
@@ -66,7 +68,6 @@ function resolveModel(modelId, options) {
 	const mgApiKey = MastraCodeGateway.getMastraGatewayApiKey();
 	const rawGatewayBase = settings.memoryGateway?.baseUrl ?? process.env["MASTRA_GATEWAY_URL"] ?? "https://gateway-api.mastra.ai";
 	const credentialStore = resolveCredentialStore(options?.requestContext);
-	const customProviders = resolveCustomProviders(options?.requestContext) ?? settings.customProviders;
 	const gateway = createMastraCodeGateway({
 		mastraGatewayBaseUrl: rawGatewayBase.replace(/\/+$/, "").replace(/\/v1$/, ""),
 		mastraGatewayApiKey: mgApiKey,
@@ -89,16 +90,34 @@ function resolveModel(modelId, options) {
 	});
 }
 /**
+* Resolve the effective thinking level for the current request.
+*
+* Precedence:
+*   1. Session override (`state.thinkingLevel`, set via /think or the session
+*      settings panel).
+*   2. Per-mode default from settings (`models.modeThinkingDefaults[mode]`).
+*   3. Global default (`preferences.thinkingLevel`).
+*
+* Resolved per-request (not seeded at session start) so configuration changes
+* apply to the next request of every session — including automated
+* (rule-driven) Factory runs that nobody ever opens interactively.
+*/
+function resolveRequestThinkingLevel(agentControllerContext, settingsPath) {
+	const override = agentControllerContext?.state?.thinkingLevel;
+	if (override !== void 0) return override;
+	const modeId = agentControllerContext?.session?.modeId;
+	return resolveDefaultThinkingLevel(loadSettings(settingsPath), modeId).level;
+}
+/**
 * Dynamic model function that reads the current model from controller state.
 * This allows runtime model switching via the /models picker.
 */
-function getDynamicModel({ requestContext }) {
+function getDynamicModel({ requestContext }, settingsPath) {
 	const agentControllerContext = requestContext.get("controller");
 	const modelId = agentControllerContext?.session?.modelId;
 	if (!modelId) throw new Error("No model selected. Use /models to select a model first.");
-	const thinkingLevel = agentControllerContext?.state?.thinkingLevel;
 	return resolveModel(modelId, {
-		thinkingLevel,
+		thinkingLevel: resolveRequestThinkingLevel(agentControllerContext, settingsPath),
 		remapForCodexOAuth: true,
 		requestContext
 	});
@@ -126,6 +145,6 @@ function getGoalJudgeModel({ requestContext }, settingsPath) {
 	});
 }
 //#endregion
-export { MASTRACODE_GATEWAY_ID, MastraCodeGateway, createMastraCodeGateway, createMastraCodeModelCatalogProvider, getAnthropicApiKey, getDynamicModel, getGoalJudgeModel, getOpenAIApiKey, hasCredentialStoreProvider, hasCustomProvidersSource, remapOpenAIModelForCodexOAuth, resolveAuth, resolveCustomProviders, resolveModel, resolveModelId, resolveTenantFromRequestContext, setCredentialStoreProvider, setCustomProvidersSource };
+export { MASTRACODE_GATEWAY_ID, MastraCodeGateway, createMastraCodeGateway, createMastraCodeModelCatalogProvider, getAnthropicApiKey, getDynamicModel, getGoalJudgeModel, getOpenAIApiKey, hasCredentialStoreProvider, hasCustomProvidersSource, remapOpenAIModelForCodexOAuth, resolveAuth, resolveCustomProviders, resolveModel, resolveModelId, resolveRequestThinkingLevel, resolveTenantFromRequestContext, setCredentialStoreProvider, setCustomProvidersSource };
 
 //# sourceMappingURL=model.js.map

package/dist/agents/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","names":[],"sources":["../../src/agents/model.ts"],"sourcesContent":["import type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport type { GatewayLanguageModel, MastraModelGatewayInterface } from '@mastra/core/llm';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport { loadSettings } from '../onboarding/settings.js';\nimport { AMAZON_BEDROCK_GATEWAY_ID, createAmazonBedrockGateway } from '../providers/amazon-bedrock-gateway.js';\nimport type { ThinkingLevel } from '../providers/openai-codex.js';\nimport { resolveCredentialStore } from './credential-resolver.js';\nimport { resolveCustomProviders } from './custom-provider-source.js';\nimport {\n  MASTRA_GATEWAY_PREFIX,\n  MASTRACODE_GATEWAY_ID,\n  MastraCodeGateway,\n  reloadAuthStorage,\n  stripMastraGatewayPrefix,\n} from './mastracode-gateway.js';\nimport type { MastraCodeGatewayOptions } from './mastracode-gateway.js';\n\nexport {\n  getAnthropicApiKey,\n  getOpenAIApiKey,\n  MASTRACODE_GATEWAY_ID,\n  MastraCodeGateway,\n  remapOpenAIModelForCodexOAuth,\n  resolveAuth,\n} from './mastracode-gateway.js';\nexport type { MastraCodeCustomProvider, MastraCodeGatewayOptions } from './mastracode-gateway.js';\nexport {\n  setCredentialStoreProvider,\n  hasCredentialStoreProvider,\n  resolveTenantFromRequestContext,\n} from './credential-resolver.js';\nexport type { CredentialTenant, CredentialStoreProvider } from './credential-resolver.js';\nexport {\n  setCustomProvidersSource,\n  hasCustomProvidersSource,\n  resolveCustomProviders,\n} from './custom-provider-source.js';\nexport type { CustomProvidersSource } from './custom-provider-source.js';\n\ntype ResolvedModel = GatewayLanguageModel;\ntype ModelRequestHeaders = Record<string, string>;\n\nfunction getAgentControllerHeaders(requestContext?: RequestContext): ModelRequestHeaders | undefined {\n  const agentControllerContext = requestContext?.get('controller') as AgentControllerRequestContext<any> | undefined;\n  const headers = {\n    ...(agentControllerContext?.threadId ? { 'x-thread-id': agentControllerContext.threadId } : {}),\n    ...(agentControllerContext?.resourceId ? { 'x-resource-id': agentControllerContext.resourceId } : {}),\n  };\n\n  return Object.keys(headers).length > 0 ? headers : undefined;\n}\n\nexport function createMastraCodeGateway(options: MastraCodeGatewayOptions): MastraCodeGateway {\n  return new MastraCodeGateway(options);\n}\n\nexport function createMastraCodeModelCatalogProvider(gateway: MastraModelGatewayInterface) {\n  return gateway instanceof MastraCodeGateway\n    ? gateway.createModelCatalogProvider()\n    : MastraCodeGateway.createModelCatalogProvider(gateway);\n}\n\n/**\n * Placeholder for future model ID normalization.\n * Currently returns the input unchanged, but exists as a seam\n * for aliasing, casing fixes, or validation in the future.\n */\nexport function resolveModelId(modelId: string): string {\n  return modelId;\n}\n\n/**\n * Resolve a model ID to the correct provider instance.\n * Shared by the main agent, observer, and reflector.\n *\n * - For anthropic/* models: Uses stored OAuth credentials when present, otherwise direct API key\n * - For openai/* models: Uses OAuth when configured, otherwise direct API key from AuthStorage\n * - For moonshotai/* models: Uses Moonshot AI Anthropic-compatible endpoint\n * - For all other providers: Uses Mastra's model router (models.dev gateway)\n */\nexport function resolveModel(\n  modelId: string,\n  options?: { thinkingLevel?: ThinkingLevel; remapForCodexOAuth?: boolean; requestContext?: RequestContext },\n): GatewayLanguageModel {\n  reloadAuthStorage();\n  const headers = getAgentControllerHeaders(options?.requestContext);\n  const settings = loadSettings();\n  // Bedrock was previously cataloged under the MastraCode gateway namespace\n  // (`mastracode/amazon-bedrock/<model>`). Normalize any legacy saved ids to the\n  // standalone `amazon-bedrock/<model>` form so they resolve through the\n  // dedicated Bedrock gateway.\n  const bedrockLegacyPrefix = `${MASTRACODE_GATEWAY_ID}/amazon-bedrock/`;\n  const normalizedInput = modelId.startsWith(bedrockLegacyPrefix)\n    ? modelId.slice(MASTRACODE_GATEWAY_ID.length + 1)\n    : modelId;\n  const isMastraGatewayModel = normalizedInput.startsWith(MASTRA_GATEWAY_PREFIX);\n  const normalizedModelId = stripMastraGatewayPrefix(normalizedInput);\n  const [providerId, ...modelParts] = normalizedModelId.split('/');\n  const bareModelId = modelParts.join('/');\n  if (!providerId || !bareModelId) {\n    throw new Error(`Invalid model id: ${modelId}`);\n  }\n\n  if (providerId === AMAZON_BEDROCK_GATEWAY_ID) {\n    const bedrockGateway = createAmazonBedrockGateway();\n    const routerId = `${AMAZON_BEDROCK_GATEWAY_ID}/${bareModelId}`;\n    const auth = bedrockGateway.resolveAuth({\n      gatewayId: AMAZON_BEDROCK_GATEWAY_ID,\n      providerId: AMAZON_BEDROCK_GATEWAY_ID,\n      modelId: bareModelId,\n      routerId,\n    });\n    return bedrockGateway.resolveLanguageModel({\n      providerId: AMAZON_BEDROCK_GATEWAY_ID,\n      modelId: bareModelId,\n      apiKey: auth?.apiKey ?? '',\n      headers,\n    });\n  }\n\n  const routerId = `${MASTRACODE_GATEWAY_ID}/${normalizedModelId}`;\n\n  const mgApiKey = MastraCodeGateway.getMastraGatewayApiKey();\n  const rawGatewayBase =\n    settings.memoryGateway?.baseUrl ?? process.env['MASTRA_GATEWAY_URL'] ?? 'https://gateway-api.mastra.ai';\n  // Deployed web registers a per-tenant credential store provider; when the\n  // request carries an authenticated tenant, resolve credentials through the\n  // caller's own store (user > org > env). Undefined = global AuthStorage.\n  const credentialStore = resolveCredentialStore(options?.requestContext);\n  // Deployed web registers a custom providers source (DB-backed, tenant\n  // scoped); when registered it is authoritative and settings.json custom\n  // providers are ignored. Undefined = local settings-based behavior.\n  const customProviders = resolveCustomProviders(options?.requestContext) ?? settings.customProviders;\n  const gateway = createMastraCodeGateway({\n    mastraGatewayBaseUrl: rawGatewayBase.replace(/\\/+$/, '').replace(/\\/v1$/, ''),\n    mastraGatewayApiKey: mgApiKey,\n    routeThroughMastraGateway: Boolean(mgApiKey && isMastraGatewayModel),\n    thinkingLevel: options?.thinkingLevel,\n    customProviders,\n    credentialStore,\n  });\n\n  const auth = gateway.resolveAuth({\n    gatewayId: MASTRACODE_GATEWAY_ID,\n    providerId,\n    modelId: bareModelId,\n    routerId,\n  });\n\n  return gateway.resolveLanguageModel({\n    providerId,\n    modelId: bareModelId,\n    apiKey: auth?.apiKey ?? mgApiKey ?? '',\n    headers,\n  });\n}\n\n/**\n * Dynamic model function that reads the current model from controller state.\n * This allows runtime model switching via the /models picker.\n */\nexport function getDynamicModel({ requestContext }: { requestContext: RequestContext }): ResolvedModel {\n  const agentControllerContext = requestContext.get('controller') as AgentControllerRequestContext<any> | undefined;\n\n  const modelId = agentControllerContext?.session?.modelId;\n  if (!modelId) {\n    throw new Error('No model selected. Use /models to select a model first.');\n  }\n\n  const thinkingLevel = agentControllerContext?.state?.thinkingLevel as ThinkingLevel | undefined;\n\n  return resolveModel(modelId, { thinkingLevel, remapForCodexOAuth: true, requestContext });\n}\n\n/**\n * Goal judge model resolver for the agent's `goal.judge` config. Resolves the\n * configured goal judge model through mastracode's gateway so provider\n * credentials (stored in auth storage, not just env) are injected — a bare model\n * id handed to core's default model router would fail to find the API key.\n *\n * Returns `undefined` when no judge model is configured, which keeps the goal\n * step a complete no-op (the goal mechanism requires a judge to do anything).\n *\n * `settingsPath` must be the same source `createMastraCode()` reads from so the\n * judge model and the goal budget (`goalMaxTurns`) come from one config — with a\n * custom `settingsPath` a bare `loadSettings()` here could read a different file\n * and silently turn the goal step into a no-op.\n */\nexport function getGoalJudgeModel(\n  { requestContext }: { requestContext: RequestContext },\n  settingsPath?: string,\n): ResolvedModel | undefined {\n  const judgeModelId = loadSettings(settingsPath).models.goalJudgeModel;\n  if (!judgeModelId) return undefined;\n  return resolveModel(judgeModelId, { remapForCodexOAuth: true, requestContext });\n}\n"],"mappings":"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"}
+{"version":3,"file":"model.js","names":[],"sources":["../../src/agents/model.ts"],"sourcesContent":["import type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport type { GatewayLanguageModel, MastraModelGatewayInterface } from '@mastra/core/llm';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport {\n  loadSettings,\n  resolveDefaultThinkingLevel,\n  stripMastraCodeCustomProviderPrefix,\n} from '../onboarding/settings.js';\nimport { AMAZON_BEDROCK_GATEWAY_ID, createAmazonBedrockGateway } from '../providers/amazon-bedrock-gateway.js';\nimport type { ThinkingLevel } from '../providers/openai-codex.js';\nimport { resolveCredentialStore } from './credential-resolver.js';\nimport { resolveCustomProviders } from './custom-provider-source.js';\nimport {\n  MASTRA_GATEWAY_PREFIX,\n  MASTRACODE_GATEWAY_ID,\n  MastraCodeGateway,\n  reloadAuthStorage,\n  stripMastraGatewayPrefix,\n} from './mastracode-gateway.js';\nimport type { MastraCodeGatewayOptions } from './mastracode-gateway.js';\n\nexport {\n  getAnthropicApiKey,\n  getOpenAIApiKey,\n  MASTRACODE_GATEWAY_ID,\n  MastraCodeGateway,\n  remapOpenAIModelForCodexOAuth,\n  resolveAuth,\n} from './mastracode-gateway.js';\nexport type { MastraCodeCustomProvider, MastraCodeGatewayOptions } from './mastracode-gateway.js';\nexport {\n  setCredentialStoreProvider,\n  hasCredentialStoreProvider,\n  resolveTenantFromRequestContext,\n} from './credential-resolver.js';\nexport type { CredentialTenant, CredentialStoreProvider } from './credential-resolver.js';\nexport {\n  setCustomProvidersSource,\n  hasCustomProvidersSource,\n  resolveCustomProviders,\n} from './custom-provider-source.js';\nexport type { CustomProvidersSource } from './custom-provider-source.js';\n\ntype ResolvedModel = GatewayLanguageModel;\ntype ModelRequestHeaders = Record<string, string>;\n\nfunction getAgentControllerHeaders(requestContext?: RequestContext): ModelRequestHeaders | undefined {\n  const agentControllerContext = requestContext?.get('controller') as AgentControllerRequestContext<any> | undefined;\n  const headers = {\n    ...(agentControllerContext?.threadId ? { 'x-thread-id': agentControllerContext.threadId } : {}),\n    ...(agentControllerContext?.resourceId ? { 'x-resource-id': agentControllerContext.resourceId } : {}),\n  };\n\n  return Object.keys(headers).length > 0 ? headers : undefined;\n}\n\nexport function createMastraCodeGateway(options: MastraCodeGatewayOptions): MastraCodeGateway {\n  return new MastraCodeGateway(options);\n}\n\nexport function createMastraCodeModelCatalogProvider(gateway: MastraModelGatewayInterface) {\n  return gateway instanceof MastraCodeGateway\n    ? gateway.createModelCatalogProvider()\n    : MastraCodeGateway.createModelCatalogProvider(gateway);\n}\n\n/**\n * Placeholder for future model ID normalization.\n * Currently returns the input unchanged, but exists as a seam\n * for aliasing, casing fixes, or validation in the future.\n */\nexport function resolveModelId(modelId: string): string {\n  return modelId;\n}\n\n/**\n * Resolve a model ID to the correct provider instance.\n * Shared by the main agent, observer, and reflector.\n *\n * - For anthropic/* models: Uses stored OAuth credentials when present, otherwise direct API key\n * - For openai/* models: Uses OAuth when configured, otherwise direct API key from AuthStorage\n * - For moonshotai/* models: Uses Moonshot AI Anthropic-compatible endpoint\n * - For all other providers: Uses Mastra's model router (models.dev gateway)\n */\nexport function resolveModel(\n  modelId: string,\n  options?: { thinkingLevel?: ThinkingLevel; remapForCodexOAuth?: boolean; requestContext?: RequestContext },\n): GatewayLanguageModel {\n  reloadAuthStorage();\n  const headers = getAgentControllerHeaders(options?.requestContext);\n  const settings = loadSettings();\n  // Bedrock was previously cataloged under the MastraCode gateway namespace\n  // (`mastracode/amazon-bedrock/<model>`). Normalize any legacy saved ids to the\n  // standalone `amazon-bedrock/<model>` form so they resolve through the\n  // dedicated Bedrock gateway.\n  const bedrockLegacyPrefix = `${MASTRACODE_GATEWAY_ID}/amazon-bedrock/`;\n  const bedrockNormalizedInput = modelId.startsWith(bedrockLegacyPrefix)\n    ? modelId.slice(MASTRACODE_GATEWAY_ID.length + 1)\n    : modelId;\n  // Deployed web registers a custom providers source (DB-backed, tenant\n  // scoped); when registered it is authoritative and settings.json custom\n  // providers are ignored. Undefined = local settings-based behavior.\n  const customProviders = resolveCustomProviders(options?.requestContext) ?? settings.customProviders;\n  // Ids selected from the shared /models catalog were previously persisted in\n  // the gateway-qualified `mastracode/<customProviderId>/<model>` form, which\n  // parses the provider as `mastracode` and breaks provider config lookup.\n  // Normalize at resolution time (in addition to stripping at selection time)\n  // so already-saved ids and any surface that persists the raw catalog id\n  // still resolve to the custom provider.\n  const normalizedInput = stripMastraCodeCustomProviderPrefix(bedrockNormalizedInput, customProviders);\n  const isMastraGatewayModel = normalizedInput.startsWith(MASTRA_GATEWAY_PREFIX);\n  const normalizedModelId = stripMastraGatewayPrefix(normalizedInput);\n  const [providerId, ...modelParts] = normalizedModelId.split('/');\n  const bareModelId = modelParts.join('/');\n  if (!providerId || !bareModelId) {\n    throw new Error(`Invalid model id: ${modelId}`);\n  }\n\n  if (providerId === AMAZON_BEDROCK_GATEWAY_ID) {\n    const bedrockGateway = createAmazonBedrockGateway();\n    const routerId = `${AMAZON_BEDROCK_GATEWAY_ID}/${bareModelId}`;\n    const auth = bedrockGateway.resolveAuth({\n      gatewayId: AMAZON_BEDROCK_GATEWAY_ID,\n      providerId: AMAZON_BEDROCK_GATEWAY_ID,\n      modelId: bareModelId,\n      routerId,\n    });\n    return bedrockGateway.resolveLanguageModel({\n      providerId: AMAZON_BEDROCK_GATEWAY_ID,\n      modelId: bareModelId,\n      apiKey: auth?.apiKey ?? '',\n      headers,\n    });\n  }\n\n  const routerId = `${MASTRACODE_GATEWAY_ID}/${normalizedModelId}`;\n\n  const mgApiKey = MastraCodeGateway.getMastraGatewayApiKey();\n  const rawGatewayBase =\n    settings.memoryGateway?.baseUrl ?? process.env['MASTRA_GATEWAY_URL'] ?? 'https://gateway-api.mastra.ai';\n  // Deployed web registers a per-tenant credential store provider; when the\n  // request carries an authenticated tenant, resolve credentials through the\n  // caller's own store (user > org > env). Undefined = global AuthStorage.\n  const credentialStore = resolveCredentialStore(options?.requestContext);\n  const gateway = createMastraCodeGateway({\n    mastraGatewayBaseUrl: rawGatewayBase.replace(/\\/+$/, '').replace(/\\/v1$/, ''),\n    mastraGatewayApiKey: mgApiKey,\n    routeThroughMastraGateway: Boolean(mgApiKey && isMastraGatewayModel),\n    thinkingLevel: options?.thinkingLevel,\n    customProviders,\n    credentialStore,\n  });\n\n  const auth = gateway.resolveAuth({\n    gatewayId: MASTRACODE_GATEWAY_ID,\n    providerId,\n    modelId: bareModelId,\n    routerId,\n  });\n\n  return gateway.resolveLanguageModel({\n    providerId,\n    modelId: bareModelId,\n    apiKey: auth?.apiKey ?? mgApiKey ?? '',\n    headers,\n  });\n}\n\n/**\n * Resolve the effective thinking level for the current request.\n *\n * Precedence:\n *   1. Session override (`state.thinkingLevel`, set via /think or the session\n *      settings panel).\n *   2. Per-mode default from settings (`models.modeThinkingDefaults[mode]`).\n *   3. Global default (`preferences.thinkingLevel`).\n *\n * Resolved per-request (not seeded at session start) so configuration changes\n * apply to the next request of every session — including automated\n * (rule-driven) Factory runs that nobody ever opens interactively.\n */\nexport function resolveRequestThinkingLevel(\n  agentControllerContext: AgentControllerRequestContext<any> | undefined,\n  settingsPath?: string,\n): ThinkingLevel {\n  const override = agentControllerContext?.state?.thinkingLevel as ThinkingLevel | undefined;\n  if (override !== undefined) return override;\n  const modeId = agentControllerContext?.session?.modeId;\n  return resolveDefaultThinkingLevel(loadSettings(settingsPath), modeId).level;\n}\n\n/**\n * Dynamic model function that reads the current model from controller state.\n * This allows runtime model switching via the /models picker.\n */\nexport function getDynamicModel(\n  { requestContext }: { requestContext: RequestContext },\n  settingsPath?: string,\n): ResolvedModel {\n  const agentControllerContext = requestContext.get('controller') as AgentControllerRequestContext<any> | undefined;\n\n  const modelId = agentControllerContext?.session?.modelId;\n  if (!modelId) {\n    throw new Error('No model selected. Use /models to select a model first.');\n  }\n\n  const thinkingLevel = resolveRequestThinkingLevel(agentControllerContext, settingsPath);\n\n  return resolveModel(modelId, { thinkingLevel, remapForCodexOAuth: true, requestContext });\n}\n\n/**\n * Goal judge model resolver for the agent's `goal.judge` config. Resolves the\n * configured goal judge model through mastracode's gateway so provider\n * credentials (stored in auth storage, not just env) are injected — a bare model\n * id handed to core's default model router would fail to find the API key.\n *\n * Returns `undefined` when no judge model is configured, which keeps the goal\n * step a complete no-op (the goal mechanism requires a judge to do anything).\n *\n * `settingsPath` must be the same source `createMastraCode()` reads from so the\n * judge model and the goal budget (`goalMaxTurns`) come from one config — with a\n * custom `settingsPath` a bare `loadSettings()` here could read a different file\n * and silently turn the goal step into a no-op.\n */\nexport function getGoalJudgeModel(\n  { requestContext }: { requestContext: RequestContext },\n  settingsPath?: string,\n): ResolvedModel | undefined {\n  const judgeModelId = loadSettings(settingsPath).models.goalJudgeModel;\n  if (!judgeModelId) return undefined;\n  return resolveModel(judgeModelId, { remapForCodexOAuth: true, requestContext });\n}\n"],"mappings":";;;;;;AA8CA,SAAS,0BAA0B,gBAAkE;CACnG,MAAM,yBAAyB,gBAAgB,IAAI,YAAY;CAC/D,MAAM,UAAU;EACd,GAAI,wBAAwB,WAAW,EAAE,eAAe,uBAAuB,SAAS,IAAI,CAAC;EAC7F,GAAI,wBAAwB,aAAa,EAAE,iBAAiB,uBAAuB,WAAW,IAAI,CAAC;CACrG;CAEA,OAAO,OAAO,KAAK,OAAO,CAAC,CAAC,SAAS,IAAI,UAAU,KAAA;AACrD;AAEA,SAAgB,wBAAwB,SAAsD;CAC5F,OAAO,IAAI,kBAAkB,OAAO;AACtC;AAEA,SAAgB,qCAAqC,SAAsC;CACzF,OAAO,mBAAmB,oBACtB,QAAQ,2BAA2B,IACnC,kBAAkB,2BAA2B,OAAO;AAC1D;;;;;;AAOA,SAAgB,eAAe,SAAyB;CACtD,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,aACd,SACA,SACsB;CACtB,kBAAkB;CAClB,MAAM,UAAU,0BAA0B,SAAS,cAAc;CACjE,MAAM,WAAW,aAAa;CAK9B,MAAM,sBAAsB,GAAG,sBAAsB;CACrD,MAAM,yBAAyB,QAAQ,WAAW,mBAAmB,IACjE,QAAQ,MAAM,sBAAsB,SAAS,CAAC,IAC9C;CAIJ,MAAM,kBAAkB,uBAAuB,SAAS,cAAc,KAAK,SAAS;CAOpF,MAAM,kBAAkB,oCAAoC,wBAAwB,eAAe;CACnG,MAAM,uBAAuB,gBAAgB,WAAW,qBAAqB;CAC7E,MAAM,oBAAoB,yBAAyB,eAAe;CAClE,MAAM,CAAC,YAAY,GAAG,cAAc,kBAAkB,MAAM,GAAG;CAC/D,MAAM,cAAc,WAAW,KAAK,GAAG;CACvC,IAAI,CAAC,cAAc,CAAC,aAClB,MAAM,IAAI,MAAM,qBAAqB,SAAS;CAGhD,IAAI,eAAA,kBAA0C;EAC5C,MAAM,iBAAiB,2BAA2B;EAClD,MAAM,WAAW,GAAG,0BAA0B,GAAG;EACjD,MAAM,OAAO,eAAe,YAAY;GACtC,WAAW;GACX,YAAY;GACZ,SAAS;GACT;EACF,CAAC;EACD,OAAO,eAAe,qBAAqB;GACzC,YAAY;GACZ,SAAS;GACT,QAAQ,MAAM,UAAU;GACxB;EACF,CAAC;CACH;CAEA,MAAM,WAAW,GAAG,sBAAsB,GAAG;CAE7C,MAAM,WAAW,kBAAkB,uBAAuB;CAC1D,MAAM,iBACJ,SAAS,eAAe,WAAW,QAAQ,IAAI,yBAAyB;CAI1E,MAAM,kBAAkB,uBAAuB,SAAS,cAAc;CACtE,MAAM,UAAU,wBAAwB;EACtC,sBAAsB,eAAe,QAAQ,QAAQ,EAAE,CAAC,CAAC,QAAQ,SAAS,EAAE;EAC5E,qBAAqB;EACrB,2BAA2B,QAAQ,YAAY,oBAAoB;EACnE,eAAe,SAAS;EACxB;EACA;CACF,CAAC;CAED,MAAM,OAAO,QAAQ,YAAY;EAC/B,WAAW;EACX;EACA,SAAS;EACT;CACF,CAAC;CAED,OAAO,QAAQ,qBAAqB;EAClC;EACA,SAAS;EACT,QAAQ,MAAM,UAAU,YAAY;EACpC;CACF,CAAC;AACH;;;;;;;;;;;;;;AAeA,SAAgB,4BACd,wBACA,cACe;CACf,MAAM,WAAW,wBAAwB,OAAO;CAChD,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,MAAM,SAAS,wBAAwB,SAAS;CAChD,OAAO,4BAA4B,aAAa,YAAY,GAAG,MAAM,CAAC,CAAC;AACzE;;;;;AAMA,SAAgB,gBACd,EAAE,kBACF,cACe;CACf,MAAM,yBAAyB,eAAe,IAAI,YAAY;CAE9D,MAAM,UAAU,wBAAwB,SAAS;CACjD,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,yDAAyD;CAK3E,OAAO,aAAa,SAAS;EAAE,eAFT,4BAA4B,wBAAwB,YAE/B;EAAG,oBAAoB;EAAM;CAAe,CAAC;AAC1F;;;;;;;;;;;;;;;AAgBA,SAAgB,kBACd,EAAE,kBACF,cAC2B;CAC3B,MAAM,eAAe,aAAa,YAAY,CAAC,CAAC,OAAO;CACvD,IAAI,CAAC,cAAc,OAAO,KAAA;CAC1B,OAAO,aAAa,cAAc;EAAE,oBAAoB;EAAM;CAAe,CAAC;AAChF"}

package/dist/headless/flags.js

@@ -140,7 +140,7 @@ const FLAGS = [
 		field: "thinkingLevel",
 		coerce: validate.enum("--thinking-level", VALID_THINKING_LEVELS),
 		placeholder: "<level>",
-		help: "Thinking level: off, low, medium, high, xhigh"
+		help: "Thinking level: off, low, medium, high, xhigh, max"
 	},
 	{
 		key: "settings",

package/dist/headless/flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"flags.js","names":[],"sources":["../../src/headless/flags.ts"],"sourcesContent":["/**\n * Declarative flag specification for the headless CLI.\n *\n * A single table is the source of truth for three things that previously drifted\n * apart in `cli.ts`:\n *   1. the `node:util` `parseArgs` option config,\n *   2. per-flag value coercion + validation, and\n *   3. the `--help` usage text.\n *\n * Adding a flag means adding one row here; parsing, validation, and the usage\n * listing all follow automatically.\n */\nimport type { OutputMode } from './cli.js';\nimport type { PermissionMode, RunMode, ThinkingLevel } from './types.js';\nimport { VALID_MODES, VALID_PERMISSION_MODES, VALID_THINKING_LEVELS } from './types.js';\n\nexport const VALID_OUTPUTS = ['human', 'json', 'jsonl'] as const;\n\n/** Reusable validators. Each throws a descriptive Error or returns the typed value. */\nconst validate = {\n  /** Restrict to a fixed set of string literals. */\n  enum<T extends string>(flag: string, allowed: readonly T[]) {\n    return (raw: string): T => {\n      if (!(allowed as readonly string[]).includes(raw)) {\n        throw new Error(`${flag} must be one of: ${allowed.join(', ')}`);\n      }\n      return raw as T;\n    };\n  },\n  /** Require a positive (>0) integer. */\n  positiveInt(flag: string) {\n    return (raw: string): number => {\n      const parsed = Number(raw);\n      if (!Number.isInteger(parsed) || parsed <= 0) {\n        throw new Error(`${flag} must be a positive integer`);\n      }\n      return parsed;\n    };\n  },\n  /** Pass a string through unchanged. */\n  string(raw: string): string {\n    return raw;\n  },\n};\n\n/**\n * One CLI flag. `key` is the long name (e.g. `output`); `field` is the\n * {@link import('./cli.js').HeadlessArgs} property it populates. `coerce`\n * converts the raw string and validates it. Boolean flags omit `coerce` and set\n * `field` to `true` when present.\n */\nexport interface FlagSpec {\n  /** Long flag name without the leading `--`. */\n  key: string;\n  /** Single-character alias (without the leading `-`), if any. */\n  short?: string;\n  /** Whether the flag takes a value (`string`) or is a switch (`boolean`). */\n  type: 'string' | 'boolean';\n  /** Target field on `HeadlessArgs`. Omit for flags handled out-of-band (e.g. help). */\n  field?: string;\n  /** Coerce/validate a string value. Required for `type: 'string'` flags that map to a field. */\n  coerce?: (raw: string) => unknown;\n  /** `<...>` value placeholder shown in usage, e.g. `<text>`. */\n  placeholder?: string;\n  /** One-line (or multi-line) help description shown in usage. */\n  help: string | string[];\n}\n\nexport const FLAGS: FlagSpec[] = [\n  {\n    key: 'prompt',\n    short: 'p',\n    type: 'string',\n    field: 'prompt',\n    coerce: validate.string,\n    placeholder: '<text>',\n    help: 'The task to execute (required, or pipe via stdin)',\n  },\n  {\n    key: 'continue',\n    short: 'c',\n    type: 'boolean',\n    field: 'continue_',\n    help: 'Resume the most recent thread instead of creating a new one',\n  },\n  {\n    key: 'thread',\n    short: 't',\n    type: 'string',\n    field: 'thread',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Resume a specific thread by ID',\n  },\n  {\n    key: 'title',\n    type: 'string',\n    field: 'title',\n    coerce: validate.string,\n    placeholder: '<title>',\n    help: 'Set or rename the thread title',\n  },\n  {\n    key: 'clone-thread',\n    type: 'boolean',\n    field: 'cloneThread',\n    help: 'Clone the current thread before running (work on a copy)',\n  },\n  {\n    key: 'resource-id',\n    type: 'string',\n    field: 'resourceId',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Set the resource ID for thread scoping',\n  },\n  {\n    key: 'timeout',\n    type: 'string',\n    field: 'timeout',\n    coerce: validate.positiveInt('--timeout'),\n    placeholder: '<seconds>',\n    help: 'Exit with code 2 if not complete within timeout',\n  },\n  {\n    key: 'max-turns',\n    type: 'string',\n    field: 'maxTurns',\n    coerce: validate.positiveInt('--max-turns'),\n    placeholder: '<n>',\n    help: 'Abort after N agentic turns (exit code 1)',\n  },\n  {\n    key: 'permission-mode',\n    type: 'string',\n    field: 'permissionMode',\n    coerce: validate.enum<PermissionMode>('--permission-mode', VALID_PERMISSION_MODES),\n    placeholder: '<mode>',\n    help: [\n      'How tool approvals/suspensions resolve:',\n      '  auto   approve everything (default)',\n      '  deny   refuse approvals, abort on suspension',\n    ],\n  },\n  {\n    key: 'output',\n    short: 'o',\n    type: 'string',\n    field: 'output',\n    coerce: validate.enum<OutputMode>('--output', VALID_OUTPUTS),\n    placeholder: '<mode>',\n    help: [\n      'Output mode: \"human\" (default), \"json\", or \"jsonl\"',\n      '  human  streaming text to stdout, activity to stderr',\n      '  json   single final JSON object (text, usage, tools)',\n      '  jsonl  newline-delimited JSON event stream',\n    ],\n  },\n  {\n    key: 'model',\n    short: 'm',\n    type: 'string',\n    field: 'model',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Model override (e.g., a provider/model id)',\n  },\n  {\n    key: 'mode',\n    type: 'string',\n    field: 'mode',\n    coerce: validate.enum<RunMode>('--mode', VALID_MODES),\n    placeholder: '{build|plan|fast}',\n    help: 'Execution mode — defaults to \"build\" if omitted',\n  },\n  {\n    key: 'thinking-level',\n    type: 'string',\n    field: 'thinkingLevel',\n    coerce: validate.enum<ThinkingLevel>('--thinking-level', VALID_THINKING_LEVELS),\n    placeholder: '<level>',\n    help: 'Thinking level: off, low, medium, high, xhigh',\n  },\n  {\n    key: 'settings',\n    type: 'string',\n    field: 'settings',\n    coerce: validate.string,\n    placeholder: '<path>',\n    help: 'Path to settings.json file (default: global settings)',\n  },\n  {\n    key: 'help',\n    short: 'h',\n    type: 'boolean',\n    help: 'Show this help and exit',\n  },\n];\n\n/** `parseArgs` option config derived from {@link FLAGS}. */\nexport function buildParseArgsOptions() {\n  const options: Record<string, { type: 'string' | 'boolean'; short?: string; default?: boolean }> = {};\n  for (const flag of FLAGS) {\n    options[flag.key] = flag.type === 'boolean' ? { type: 'boolean', default: false } : { type: 'string' };\n    if (flag.short) options[flag.key]!.short = flag.short;\n  }\n  return options;\n}\n\n/** Render the aligned `--flag  description` block of the usage text from {@link FLAGS}. */\nexport function renderFlagUsage(): string {\n  const left = (flag: FlagSpec): string => {\n    const long = `--${flag.key}`;\n    const short = flag.short ? `, -${flag.short}` : '';\n    const value = flag.placeholder ? ` ${flag.placeholder}` : '';\n    return `  ${long}${short}${value}`;\n  };\n\n  const rows = FLAGS.map(flag => ({ flag, label: left(flag) }));\n  const width = Math.max(...rows.map(r => r.label.length)) + 2;\n\n  return rows\n    .map(({ flag, label }) => {\n      const lines = Array.isArray(flag.help) ? flag.help : [flag.help];\n      const first = `${label.padEnd(width)}${lines[0]}`;\n      const rest = lines.slice(1).map(line => `${' '.repeat(width)}${line}`);\n      return [first, ...rest].join('\\n');\n    })\n    .join('\\n');\n}\n"],"mappings":"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"}
+{"version":3,"file":"flags.js","names":[],"sources":["../../src/headless/flags.ts"],"sourcesContent":["/**\n * Declarative flag specification for the headless CLI.\n *\n * A single table is the source of truth for three things that previously drifted\n * apart in `cli.ts`:\n *   1. the `node:util` `parseArgs` option config,\n *   2. per-flag value coercion + validation, and\n *   3. the `--help` usage text.\n *\n * Adding a flag means adding one row here; parsing, validation, and the usage\n * listing all follow automatically.\n */\nimport type { OutputMode } from './cli.js';\nimport type { PermissionMode, RunMode, ThinkingLevel } from './types.js';\nimport { VALID_MODES, VALID_PERMISSION_MODES, VALID_THINKING_LEVELS } from './types.js';\n\nexport const VALID_OUTPUTS = ['human', 'json', 'jsonl'] as const;\n\n/** Reusable validators. Each throws a descriptive Error or returns the typed value. */\nconst validate = {\n  /** Restrict to a fixed set of string literals. */\n  enum<T extends string>(flag: string, allowed: readonly T[]) {\n    return (raw: string): T => {\n      if (!(allowed as readonly string[]).includes(raw)) {\n        throw new Error(`${flag} must be one of: ${allowed.join(', ')}`);\n      }\n      return raw as T;\n    };\n  },\n  /** Require a positive (>0) integer. */\n  positiveInt(flag: string) {\n    return (raw: string): number => {\n      const parsed = Number(raw);\n      if (!Number.isInteger(parsed) || parsed <= 0) {\n        throw new Error(`${flag} must be a positive integer`);\n      }\n      return parsed;\n    };\n  },\n  /** Pass a string through unchanged. */\n  string(raw: string): string {\n    return raw;\n  },\n};\n\n/**\n * One CLI flag. `key` is the long name (e.g. `output`); `field` is the\n * {@link import('./cli.js').HeadlessArgs} property it populates. `coerce`\n * converts the raw string and validates it. Boolean flags omit `coerce` and set\n * `field` to `true` when present.\n */\nexport interface FlagSpec {\n  /** Long flag name without the leading `--`. */\n  key: string;\n  /** Single-character alias (without the leading `-`), if any. */\n  short?: string;\n  /** Whether the flag takes a value (`string`) or is a switch (`boolean`). */\n  type: 'string' | 'boolean';\n  /** Target field on `HeadlessArgs`. Omit for flags handled out-of-band (e.g. help). */\n  field?: string;\n  /** Coerce/validate a string value. Required for `type: 'string'` flags that map to a field. */\n  coerce?: (raw: string) => unknown;\n  /** `<...>` value placeholder shown in usage, e.g. `<text>`. */\n  placeholder?: string;\n  /** One-line (or multi-line) help description shown in usage. */\n  help: string | string[];\n}\n\nexport const FLAGS: FlagSpec[] = [\n  {\n    key: 'prompt',\n    short: 'p',\n    type: 'string',\n    field: 'prompt',\n    coerce: validate.string,\n    placeholder: '<text>',\n    help: 'The task to execute (required, or pipe via stdin)',\n  },\n  {\n    key: 'continue',\n    short: 'c',\n    type: 'boolean',\n    field: 'continue_',\n    help: 'Resume the most recent thread instead of creating a new one',\n  },\n  {\n    key: 'thread',\n    short: 't',\n    type: 'string',\n    field: 'thread',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Resume a specific thread by ID',\n  },\n  {\n    key: 'title',\n    type: 'string',\n    field: 'title',\n    coerce: validate.string,\n    placeholder: '<title>',\n    help: 'Set or rename the thread title',\n  },\n  {\n    key: 'clone-thread',\n    type: 'boolean',\n    field: 'cloneThread',\n    help: 'Clone the current thread before running (work on a copy)',\n  },\n  {\n    key: 'resource-id',\n    type: 'string',\n    field: 'resourceId',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Set the resource ID for thread scoping',\n  },\n  {\n    key: 'timeout',\n    type: 'string',\n    field: 'timeout',\n    coerce: validate.positiveInt('--timeout'),\n    placeholder: '<seconds>',\n    help: 'Exit with code 2 if not complete within timeout',\n  },\n  {\n    key: 'max-turns',\n    type: 'string',\n    field: 'maxTurns',\n    coerce: validate.positiveInt('--max-turns'),\n    placeholder: '<n>',\n    help: 'Abort after N agentic turns (exit code 1)',\n  },\n  {\n    key: 'permission-mode',\n    type: 'string',\n    field: 'permissionMode',\n    coerce: validate.enum<PermissionMode>('--permission-mode', VALID_PERMISSION_MODES),\n    placeholder: '<mode>',\n    help: [\n      'How tool approvals/suspensions resolve:',\n      '  auto   approve everything (default)',\n      '  deny   refuse approvals, abort on suspension',\n    ],\n  },\n  {\n    key: 'output',\n    short: 'o',\n    type: 'string',\n    field: 'output',\n    coerce: validate.enum<OutputMode>('--output', VALID_OUTPUTS),\n    placeholder: '<mode>',\n    help: [\n      'Output mode: \"human\" (default), \"json\", or \"jsonl\"',\n      '  human  streaming text to stdout, activity to stderr',\n      '  json   single final JSON object (text, usage, tools)',\n      '  jsonl  newline-delimited JSON event stream',\n    ],\n  },\n  {\n    key: 'model',\n    short: 'm',\n    type: 'string',\n    field: 'model',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Model override (e.g., a provider/model id)',\n  },\n  {\n    key: 'mode',\n    type: 'string',\n    field: 'mode',\n    coerce: validate.enum<RunMode>('--mode', VALID_MODES),\n    placeholder: '{build|plan|fast}',\n    help: 'Execution mode — defaults to \"build\" if omitted',\n  },\n  {\n    key: 'thinking-level',\n    type: 'string',\n    field: 'thinkingLevel',\n    coerce: validate.enum<ThinkingLevel>('--thinking-level', VALID_THINKING_LEVELS),\n    placeholder: '<level>',\n    help: 'Thinking level: off, low, medium, high, xhigh, max',\n  },\n  {\n    key: 'settings',\n    type: 'string',\n    field: 'settings',\n    coerce: validate.string,\n    placeholder: '<path>',\n    help: 'Path to settings.json file (default: global settings)',\n  },\n  {\n    key: 'help',\n    short: 'h',\n    type: 'boolean',\n    help: 'Show this help and exit',\n  },\n];\n\n/** `parseArgs` option config derived from {@link FLAGS}. */\nexport function buildParseArgsOptions() {\n  const options: Record<string, { type: 'string' | 'boolean'; short?: string; default?: boolean }> = {};\n  for (const flag of FLAGS) {\n    options[flag.key] = flag.type === 'boolean' ? { type: 'boolean', default: false } : { type: 'string' };\n    if (flag.short) options[flag.key]!.short = flag.short;\n  }\n  return options;\n}\n\n/** Render the aligned `--flag  description` block of the usage text from {@link FLAGS}. */\nexport function renderFlagUsage(): string {\n  const left = (flag: FlagSpec): string => {\n    const long = `--${flag.key}`;\n    const short = flag.short ? `, -${flag.short}` : '';\n    const value = flag.placeholder ? ` ${flag.placeholder}` : '';\n    return `  ${long}${short}${value}`;\n  };\n\n  const rows = FLAGS.map(flag => ({ flag, label: left(flag) }));\n  const width = Math.max(...rows.map(r => r.label.length)) + 2;\n\n  return rows\n    .map(({ flag, label }) => {\n      const lines = Array.isArray(flag.help) ? flag.help : [flag.help];\n      const first = `${label.padEnd(width)}${lines[0]}`;\n      const rest = lines.slice(1).map(line => `${' '.repeat(width)}${line}`);\n      return [first, ...rest].join('\\n');\n    })\n    .join('\\n');\n}\n"],"mappings":";;AAgBA,MAAa,gBAAgB;CAAC;CAAS;CAAQ;AAAO;;AAGtD,MAAM,WAAW;;CAEf,KAAuB,MAAc,SAAuB;EAC1D,QAAQ,QAAmB;GACzB,IAAI,CAAE,QAA8B,SAAS,GAAG,GAC9C,MAAM,IAAI,MAAM,GAAG,KAAK,mBAAmB,QAAQ,KAAK,IAAI,GAAG;GAEjE,OAAO;EACT;CACF;;CAEA,YAAY,MAAc;EACxB,QAAQ,QAAwB;GAC9B,MAAM,SAAS,OAAO,GAAG;GACzB,IAAI,CAAC,OAAO,UAAU,MAAM,KAAK,UAAU,GACzC,MAAM,IAAI,MAAM,GAAG,KAAK,4BAA4B;GAEtD,OAAO;EACT;CACF;;CAEA,OAAO,KAAqB;EAC1B,OAAO;CACT;AACF;AAyBA,MAAa,QAAoB;CAC/B;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;EACP,MAAM;CACR;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,YAAY,WAAW;EACxC,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,YAAY,aAAa;EAC1C,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,KAAqB,qBAAqB,sBAAsB;EACjF,aAAa;EACb,MAAM;GACJ;GACA;GACA;EACF;CACF;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,KAAiB,YAAY,aAAa;EAC3D,aAAa;EACb,MAAM;GACJ;GACA;GACA;GACA;EACF;CACF;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,KAAc,UAAU,WAAW;EACpD,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,KAAoB,oBAAoB,qBAAqB;EAC9E,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,MAAM;CACR;AACF;;AAGA,SAAgB,wBAAwB;CACtC,MAAM,UAA6F,CAAC;CACpG,KAAK,MAAM,QAAQ,OAAO;EACxB,QAAQ,KAAK,OAAO,KAAK,SAAS,YAAY;GAAE,MAAM;GAAW,SAAS;EAAM,IAAI,EAAE,MAAM,SAAS;EACrG,IAAI,KAAK,OAAO,QAAQ,KAAK,IAAI,CAAE,QAAQ,KAAK;CAClD;CACA,OAAO;AACT;;AAGA,SAAgB,kBAA0B;CACxC,MAAM,QAAQ,SAA2B;EAIvC,OAAO,KAAK,KAHM,KAAK,QACT,KAAK,QAAQ,MAAM,KAAK,UAAU,KAClC,KAAK,cAAc,IAAI,KAAK,gBAAgB;CAE5D;CAEA,MAAM,OAAO,MAAM,KAAI,UAAS;EAAE;EAAM,OAAO,KAAK,IAAI;CAAE,EAAE;CAC5D,MAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,KAAI,MAAK,EAAE,MAAM,MAAM,CAAC,IAAI;CAE3D,OAAO,KACJ,KAAK,EAAE,MAAM,YAAY;EACxB,MAAM,QAAQ,MAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,OAAO,CAAC,KAAK,IAAI;EAG/D,OAAO,CAAC,GAFS,MAAM,OAAO,KAAK,IAAI,MAAM,MAE9B,GADF,MAAM,MAAM,CAAC,CAAC,CAAC,KAAI,SAAQ,GAAG,IAAI,OAAO,KAAK,IAAI,MAC1C,CAAC,CAAC,CAAC,KAAK,IAAI;CACnC,CAAC,CAAC,CACD,KAAK,IAAI;AACd"}

package/dist/headless/types.d.ts

@@ -8,9 +8,9 @@
 import type { AgentController, AgentControllerEvent, Session } from '@mastra/core/agent-controller';
 import type { GoalManager } from '../goal-manager.js';
 export type RunMode = 'build' | 'plan' | 'fast';
-export type ThinkingLevel = 'off' | 'low' | 'medium' | 'high' | 'xhigh';
+export type ThinkingLevel = 'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 export declare const VALID_MODES: readonly ["build", "plan", "fast"];
-export declare const VALID_THINKING_LEVELS: readonly ["off", "low", "medium", "high", "xhigh"];
+export declare const VALID_THINKING_LEVELS: readonly ["off", "low", "medium", "high", "xhigh", "max"];
 /**
  * Named permission modes for non-interactive runs. Maps to a built-in
  * {@link ResolutionPolicy}:

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

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

package/dist/headless/types.js

@@ -9,7 +9,8 @@ const VALID_THINKING_LEVELS = [
 	"low",
 	"medium",
 	"high",
-	"xhigh"
+	"xhigh",
+	"max"
 ];
 const VALID_PERMISSION_MODES = ["auto", "deny"];
 //#endregion

package/dist/headless/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/headless/types.ts"],"sourcesContent":["/**\n * Shared types for the headless / programmatic MastraCode API.\n *\n * These types are consumed by the core runner (`runMC`), the resolution policy,\n * the output formatters, and the CLI adapter. They are intentionally free of any\n * `process.*` access so the core API is usable from CI / Node code.\n */\nimport type { AgentController, AgentControllerEvent, Session } from '@mastra/core/agent-controller';\n\nimport type { GoalManager } from '../goal-manager.js';\n\nexport type RunMode = 'build' | 'plan' | 'fast';\nexport type ThinkingLevel = 'off' | 'low' | 'medium' | 'high' | 'xhigh';\n\nexport const VALID_MODES = ['build', 'plan', 'fast'] as const;\nexport const VALID_THINKING_LEVELS = ['off', 'low', 'medium', 'high', 'xhigh'] as const;\n\n/**\n * Named permission modes for non-interactive runs. Maps to a built-in\n * {@link ResolutionPolicy}:\n *  - `auto`   — approve every tool and auto-resolve suspensions (the default).\n *  - `deny`   — refuse every tool approval and abort on any suspension.\n */\nexport type PermissionMode = 'auto' | 'deny';\nexport const VALID_PERMISSION_MODES = ['auto', 'deny'] as const;\n\n/** How `runMC` should resume `tool_approval_required` and `tool_suspended` events. */\nexport interface ResolutionPolicy {\n  /**\n   * Called for every `tool_approval_required` event. Return the decision; the\n   * runner forwards it to `session.respondToToolApproval`.\n   */\n  onToolApproval(event: Extract<AgentControllerEvent, { type: 'tool_approval_required' }>): 'approve' | 'deny';\n  /**\n   * Called for every `tool_suspended` event. Return `resumeData` to resume the\n   * tool, or `{ abort: true }` to abort the run.\n   */\n  onSuspension(\n    event: Extract<AgentControllerEvent, { type: 'tool_suspended' }>,\n  ): { resumeData: unknown } | { abort: true };\n}\n\n/** Thread selection / mutation options resolved up front by `runMC`. */\nexport interface RunMCThreadOptions {\n  /** Resume a specific thread by its exact id. */\n  id?: string;\n  /** Resume the most recently updated thread instead of creating a new one. */\n  continueLatest?: boolean;\n  /** Clone the resolved (or current) thread before running — work on a copy. */\n  clone?: boolean;\n}\n\ninterface RunMCBaseOptions<TState extends Record<string, unknown> = Record<string, unknown>> {\n  /** Controller built via `createMastraCode(...)`. */\n  controller: AgentController<TState>;\n  /** Session built via `createMastraCode(...)`. */\n  session: Session<TState>;\n\n  /** Explicit model id override. Takes precedence over `mode`. */\n  model?: string;\n  /** Execution mode; resolves a model from `modeDefaults` when `model` is absent. */\n  mode?: RunMode;\n  /** Per-mode default model ids (resolved from settings at startup). */\n  modeDefaults?: Record<string, string>;\n  /** Thinking-effort level. */\n  thinkingLevel?: ThinkingLevel;\n  /** Thread selection / mutation. */\n  thread?: RunMCThreadOptions;\n  /** Resource id for thread scoping. */\n  resourceId?: string;\n  /** Set or rename the thread title before running. */\n  title?: string;\n  /** Abort with `status: 'timeout'` (exit code 2) after this many ms without an event. */\n  timeoutMs?: number;\n  /**\n   * Maximum number of agentic turns (assistant responses). When the limit is\n   * reached the run aborts with `status: 'max_turns'` (exit code 1). No limit\n   * by default.\n   */\n  maxTurns?: number;\n  /** How approvals / suspensions are resolved. Defaults to {@link autoApprovePolicy}. */\n  policy?: ResolutionPolicy;\n  /** External abort signal; aborting it aborts the run. */\n  signal?: AbortSignal;\n}\n\nexport interface RunMCGoalOptions {\n  objective: string;\n  judgeModelId: string;\n  maxRuns: number;\n  goalManager?: GoalManager;\n}\n\nexport type RunMCOptions<TState extends Record<string, unknown> = Record<string, unknown>> = RunMCBaseOptions<TState> &\n  (\n    | {\n        /** The task to run as a regular headless turn. */\n        prompt: string;\n        goal?: never;\n      }\n    | {\n        prompt?: never;\n        /** Run a persisted goal instead of a regular prompt. */\n        goal: RunMCGoalOptions;\n      }\n  );\n\nexport type RunMCStatus = 'completed' | 'done' | 'paused' | 'error' | 'aborted' | 'timeout' | 'max_turns';\n\nexport interface RunMCUsage {\n  inputTokens?: number;\n  outputTokens?: number;\n  totalTokens?: number;\n}\n\nexport interface RunMCToolCall {\n  id: string;\n  name: string;\n  args: unknown;\n}\n\nexport interface RunMCToolResult {\n  id: string;\n  name: string;\n  result: unknown;\n  isError: boolean;\n}\n\nexport interface RunMCError {\n  name: string;\n  message: string;\n  stack?: string;\n}\n\nexport interface RunMCResult {\n  status: RunMCStatus;\n  /** Aggregated assistant text across all message_end events. */\n  text: string;\n  /** Goal objective when this was a goal run. */\n  objective?: string;\n  /** Terminal goal evaluation when this was a goal run. */\n  goalEvent?: Extract<AgentControllerEvent, { type: 'goal_evaluation' }>;\n  reason?: string;\n  iterations?: number;\n  maxRuns?: number;\n  /** Underlying finish reason from `agent_end`, when the run finished normally. */\n  finishReason?: string;\n  usage?: RunMCUsage;\n  toolCalls: RunMCToolCall[];\n  toolResults: RunMCToolResult[];\n  threadId?: string;\n  error?: RunMCError;\n  /** 0 success, 1 error/aborted/max_turns, 2 timeout. */\n  exitCode: number;\n}\n\n/**\n * A handle to an in-flight `runMC` run. It is async-iterable over controller\n * events and also resolves to a final {@link RunMCResult} via `result`.\n *\n * Both `for await (const e of run)` and `await run.result` work on the same run;\n * awaiting `result` without iterating still drains events internally.\n */\nexport interface MCRun extends AsyncIterable<AgentControllerEvent> {\n  /** Resolves once the run completes, times out, errors, or is aborted. */\n  result: Promise<RunMCResult>;\n  /** Abort the in-flight run. */\n  abort(): void;\n}\n"],"mappings":";AAcA,MAAa,cAAc;CAAC;CAAS;CAAQ;AAAM;AACnD,MAAa,wBAAwB;CAAC;CAAO;CAAO;CAAU;CAAQ;AAAO;AAS7E,MAAa,yBAAyB,CAAC,QAAQ,MAAM"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/headless/types.ts"],"sourcesContent":["/**\n * Shared types for the headless / programmatic MastraCode API.\n *\n * These types are consumed by the core runner (`runMC`), the resolution policy,\n * the output formatters, and the CLI adapter. They are intentionally free of any\n * `process.*` access so the core API is usable from CI / Node code.\n */\nimport type { AgentController, AgentControllerEvent, Session } from '@mastra/core/agent-controller';\n\nimport type { GoalManager } from '../goal-manager.js';\n\nexport type RunMode = 'build' | 'plan' | 'fast';\nexport type ThinkingLevel = 'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';\n\nexport const VALID_MODES = ['build', 'plan', 'fast'] as const;\nexport const VALID_THINKING_LEVELS = ['off', 'low', 'medium', 'high', 'xhigh', 'max'] as const;\n\n/**\n * Named permission modes for non-interactive runs. Maps to a built-in\n * {@link ResolutionPolicy}:\n *  - `auto`   — approve every tool and auto-resolve suspensions (the default).\n *  - `deny`   — refuse every tool approval and abort on any suspension.\n */\nexport type PermissionMode = 'auto' | 'deny';\nexport const VALID_PERMISSION_MODES = ['auto', 'deny'] as const;\n\n/** How `runMC` should resume `tool_approval_required` and `tool_suspended` events. */\nexport interface ResolutionPolicy {\n  /**\n   * Called for every `tool_approval_required` event. Return the decision; the\n   * runner forwards it to `session.respondToToolApproval`.\n   */\n  onToolApproval(event: Extract<AgentControllerEvent, { type: 'tool_approval_required' }>): 'approve' | 'deny';\n  /**\n   * Called for every `tool_suspended` event. Return `resumeData` to resume the\n   * tool, or `{ abort: true }` to abort the run.\n   */\n  onSuspension(\n    event: Extract<AgentControllerEvent, { type: 'tool_suspended' }>,\n  ): { resumeData: unknown } | { abort: true };\n}\n\n/** Thread selection / mutation options resolved up front by `runMC`. */\nexport interface RunMCThreadOptions {\n  /** Resume a specific thread by its exact id. */\n  id?: string;\n  /** Resume the most recently updated thread instead of creating a new one. */\n  continueLatest?: boolean;\n  /** Clone the resolved (or current) thread before running — work on a copy. */\n  clone?: boolean;\n}\n\ninterface RunMCBaseOptions<TState extends Record<string, unknown> = Record<string, unknown>> {\n  /** Controller built via `createMastraCode(...)`. */\n  controller: AgentController<TState>;\n  /** Session built via `createMastraCode(...)`. */\n  session: Session<TState>;\n\n  /** Explicit model id override. Takes precedence over `mode`. */\n  model?: string;\n  /** Execution mode; resolves a model from `modeDefaults` when `model` is absent. */\n  mode?: RunMode;\n  /** Per-mode default model ids (resolved from settings at startup). */\n  modeDefaults?: Record<string, string>;\n  /** Thinking-effort level. */\n  thinkingLevel?: ThinkingLevel;\n  /** Thread selection / mutation. */\n  thread?: RunMCThreadOptions;\n  /** Resource id for thread scoping. */\n  resourceId?: string;\n  /** Set or rename the thread title before running. */\n  title?: string;\n  /** Abort with `status: 'timeout'` (exit code 2) after this many ms without an event. */\n  timeoutMs?: number;\n  /**\n   * Maximum number of agentic turns (assistant responses). When the limit is\n   * reached the run aborts with `status: 'max_turns'` (exit code 1). No limit\n   * by default.\n   */\n  maxTurns?: number;\n  /** How approvals / suspensions are resolved. Defaults to {@link autoApprovePolicy}. */\n  policy?: ResolutionPolicy;\n  /** External abort signal; aborting it aborts the run. */\n  signal?: AbortSignal;\n}\n\nexport interface RunMCGoalOptions {\n  objective: string;\n  judgeModelId: string;\n  maxRuns: number;\n  goalManager?: GoalManager;\n}\n\nexport type RunMCOptions<TState extends Record<string, unknown> = Record<string, unknown>> = RunMCBaseOptions<TState> &\n  (\n    | {\n        /** The task to run as a regular headless turn. */\n        prompt: string;\n        goal?: never;\n      }\n    | {\n        prompt?: never;\n        /** Run a persisted goal instead of a regular prompt. */\n        goal: RunMCGoalOptions;\n      }\n  );\n\nexport type RunMCStatus = 'completed' | 'done' | 'paused' | 'error' | 'aborted' | 'timeout' | 'max_turns';\n\nexport interface RunMCUsage {\n  inputTokens?: number;\n  outputTokens?: number;\n  totalTokens?: number;\n}\n\nexport interface RunMCToolCall {\n  id: string;\n  name: string;\n  args: unknown;\n}\n\nexport interface RunMCToolResult {\n  id: string;\n  name: string;\n  result: unknown;\n  isError: boolean;\n}\n\nexport interface RunMCError {\n  name: string;\n  message: string;\n  stack?: string;\n}\n\nexport interface RunMCResult {\n  status: RunMCStatus;\n  /** Aggregated assistant text across all message_end events. */\n  text: string;\n  /** Goal objective when this was a goal run. */\n  objective?: string;\n  /** Terminal goal evaluation when this was a goal run. */\n  goalEvent?: Extract<AgentControllerEvent, { type: 'goal_evaluation' }>;\n  reason?: string;\n  iterations?: number;\n  maxRuns?: number;\n  /** Underlying finish reason from `agent_end`, when the run finished normally. */\n  finishReason?: string;\n  usage?: RunMCUsage;\n  toolCalls: RunMCToolCall[];\n  toolResults: RunMCToolResult[];\n  threadId?: string;\n  error?: RunMCError;\n  /** 0 success, 1 error/aborted/max_turns, 2 timeout. */\n  exitCode: number;\n}\n\n/**\n * A handle to an in-flight `runMC` run. It is async-iterable over controller\n * events and also resolves to a final {@link RunMCResult} via `result`.\n *\n * Both `for await (const e of run)` and `await run.result` work on the same run;\n * awaiting `result` without iterating still drains events internally.\n */\nexport interface MCRun extends AsyncIterable<AgentControllerEvent> {\n  /** Resolves once the run completes, times out, errors, or is aborted. */\n  result: Promise<RunMCResult>;\n  /** Abort the in-flight run. */\n  abort(): void;\n}\n"],"mappings":";AAcA,MAAa,cAAc;CAAC;CAAS;CAAQ;AAAM;AACnD,MAAa,wBAAwB;CAAC;CAAO;CAAO;CAAU;CAAQ;CAAS;AAAK;AASpF,MAAa,yBAAyB,CAAC,QAAQ,MAAM"}

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

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/hooks/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAc,eAAe,EAAE,MAAM,YAAY,CAAC;AAKrG,wBAAsB,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAiFpG;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAa1F;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,SAAS,EACvB,YAAY,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,OAAO,CAAC,eAAe,CAAC,CA8C1B"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/hooks/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAc,eAAe,EAAE,MAAM,YAAY,CAAC;AAKrG,wBAAsB,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAuFpG;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAa1F;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,SAAS,EACvB,YAAY,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,OAAO,CAAC,eAAe,CAAC,CA8C1B"}

package/dist/hooks/executor.js

@@ -18,6 +18,7 @@ async function executeHook(hook, stdinPayload) {
 				"pipe"
 			],
 			cwd: stdinPayload.cwd,
+			...isWindows ? { windowsVerbatimArguments: true } : {},
 			env: {
 				...process.env,
 				MASTRA_HOOK_EVENT: stdinPayload.hook_event_name

package/dist/hooks/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","names":[],"sources":["../../src/hooks/executor.ts"],"sourcesContent":["/**\n * Hook process execution.\n * Spawns shell commands, handles stdin/stdout/exit-code protocol.\n */\n\nimport { spawn } from 'node:child_process';\nimport type { HookDefinition, HookStdin, HookResult, HookStdout, HookEventResult } from './types.js';\nimport { isBlockingEvent } from './types.js';\n\nconst DEFAULT_TIMEOUT = 10_000;\n\nexport async function executeHook(hook: HookDefinition, stdinPayload: HookStdin): Promise<HookResult> {\n  const timeout = hook.timeout ?? DEFAULT_TIMEOUT;\n  const startTime = Date.now();\n\n  return new Promise<HookResult>(resolve => {\n    const isWindows = process.platform === 'win32';\n    const shell = isWindows ? 'cmd' : '/bin/sh';\n    const shellArgs = isWindows ? ['/c', hook.command] : ['-c', hook.command];\n\n    const child = spawn(shell, shellArgs, {\n      stdio: ['pipe', 'pipe', 'pipe'],\n      cwd: stdinPayload.cwd,\n      env: {\n        ...process.env,\n        MASTRA_HOOK_EVENT: stdinPayload.hook_event_name,\n      },\n    });\n\n    let stdout = '';\n    let stderr = '';\n    let timedOut = false;\n    let resolved = false;\n\n    const timer = setTimeout(() => {\n      timedOut = true;\n      child.kill('SIGKILL');\n    }, timeout);\n\n    child.stdout?.on('data', (data: Buffer) => {\n      stdout += data.toString();\n    });\n\n    child.stderr?.on('data', (data: Buffer) => {\n      stderr += data.toString();\n    });\n\n    child.on('close', exitCode => {\n      clearTimeout(timer);\n      if (resolved) return;\n      resolved = true;\n\n      let parsedStdout: HookStdout | undefined;\n      if (stdout.trim()) {\n        try {\n          parsedStdout = JSON.parse(stdout.trim()) as HookStdout;\n        } catch {\n          // Not valid JSON — ignore\n        }\n      }\n\n      resolve({\n        hook,\n        exitCode: exitCode ?? 1,\n        stdout: parsedStdout,\n        stderr: stderr.trim() || undefined,\n        timedOut,\n        durationMs: Date.now() - startTime,\n      });\n    });\n\n    child.on('error', error => {\n      clearTimeout(timer);\n      if (resolved) return;\n      resolved = true;\n\n      resolve({\n        hook,\n        exitCode: 1,\n        stderr: error.message,\n        timedOut: false,\n        durationMs: Date.now() - startTime,\n      });\n    });\n\n    try {\n      child.stdin?.write(JSON.stringify(stdinPayload));\n      child.stdin?.end();\n    } catch {\n      // stdin write failure — process continues\n    }\n  });\n}\n\nexport function matchesHook(hook: HookDefinition, context: { tool_name?: string }): boolean {\n  if (!hook.matcher) return true;\n\n  if (hook.matcher.tool_name) {\n    if (!context.tool_name) return false;\n    try {\n      return new RegExp(hook.matcher.tool_name).test(context.tool_name);\n    } catch {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nexport async function runHooksForEvent(\n  hooks: HookDefinition[],\n  stdinPayload: HookStdin,\n  matchContext: { tool_name?: string } = {},\n): Promise<HookEventResult> {\n  const results: HookResult[] = [];\n  const warnings: string[] = [];\n  let additionalContext: string | undefined;\n\n  const applicable = hooks.filter(h => matchesHook(h, matchContext));\n  if (applicable.length === 0) {\n    return { allowed: true, results: [], warnings: [] };\n  }\n\n  const blocking = isBlockingEvent(stdinPayload.hook_event_name);\n\n  for (const hook of applicable) {\n    const result = await executeHook(hook, stdinPayload);\n    results.push(result);\n\n    if (result.stdout?.additionalContext) {\n      additionalContext = additionalContext\n        ? `${additionalContext}\\n${result.stdout.additionalContext}`\n        : result.stdout.additionalContext;\n    }\n\n    if (result.timedOut) {\n      warnings.push(`Hook timed out after ${hook.timeout ?? DEFAULT_TIMEOUT}ms: ${hook.command}`);\n      continue;\n    }\n\n    if (result.exitCode === 2 && blocking) {\n      const reason = result.stdout?.reason || result.stderr || `Blocked by hook: ${hook.description || hook.command}`;\n\n      return {\n        allowed: false,\n        blockReason: reason,\n        additionalContext,\n        results,\n        warnings,\n      };\n    }\n\n    if (result.exitCode === 0) continue;\n\n    const warnMsg = result.stderr || `Hook exited with code ${result.exitCode}`;\n    warnings.push(`${hook.description || hook.command}: ${warnMsg}`);\n  }\n\n  return { allowed: true, additionalContext, results, warnings };\n}\n"],"mappings":"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"}
+{"version":3,"file":"executor.js","names":[],"sources":["../../src/hooks/executor.ts"],"sourcesContent":["/**\n * Hook process execution.\n * Spawns shell commands, handles stdin/stdout/exit-code protocol.\n */\n\nimport { spawn } from 'node:child_process';\nimport type { HookDefinition, HookStdin, HookResult, HookStdout, HookEventResult } from './types.js';\nimport { isBlockingEvent } from './types.js';\n\nconst DEFAULT_TIMEOUT = 10_000;\n\nexport async function executeHook(hook: HookDefinition, stdinPayload: HookStdin): Promise<HookResult> {\n  const timeout = hook.timeout ?? DEFAULT_TIMEOUT;\n  const startTime = Date.now();\n\n  return new Promise<HookResult>(resolve => {\n    const isWindows = process.platform === 'win32';\n    const shell = isWindows ? 'cmd' : '/bin/sh';\n    const shellArgs = isWindows ? ['/c', hook.command] : ['-c', hook.command];\n\n    const child = spawn(shell, shellArgs, {\n      stdio: ['pipe', 'pipe', 'pipe'],\n      cwd: stdinPayload.cwd,\n      // Without this, Node's default Windows argument escaping re-quotes\n      // hook.command before cmd.exe ever sees it, so a quoted path (or any\n      // path containing spaces) reaches the child process with literal \"\n      // characters embedded in it. mastracode/tui's shell-runner.ts already\n      // sets this for its own cmd invocations; this call site just missed it.\n      ...(isWindows ? { windowsVerbatimArguments: true } : {}),\n      env: {\n        ...process.env,\n        MASTRA_HOOK_EVENT: stdinPayload.hook_event_name,\n      },\n    });\n\n    let stdout = '';\n    let stderr = '';\n    let timedOut = false;\n    let resolved = false;\n\n    const timer = setTimeout(() => {\n      timedOut = true;\n      child.kill('SIGKILL');\n    }, timeout);\n\n    child.stdout?.on('data', (data: Buffer) => {\n      stdout += data.toString();\n    });\n\n    child.stderr?.on('data', (data: Buffer) => {\n      stderr += data.toString();\n    });\n\n    child.on('close', exitCode => {\n      clearTimeout(timer);\n      if (resolved) return;\n      resolved = true;\n\n      let parsedStdout: HookStdout | undefined;\n      if (stdout.trim()) {\n        try {\n          parsedStdout = JSON.parse(stdout.trim()) as HookStdout;\n        } catch {\n          // Not valid JSON — ignore\n        }\n      }\n\n      resolve({\n        hook,\n        exitCode: exitCode ?? 1,\n        stdout: parsedStdout,\n        stderr: stderr.trim() || undefined,\n        timedOut,\n        durationMs: Date.now() - startTime,\n      });\n    });\n\n    child.on('error', error => {\n      clearTimeout(timer);\n      if (resolved) return;\n      resolved = true;\n\n      resolve({\n        hook,\n        exitCode: 1,\n        stderr: error.message,\n        timedOut: false,\n        durationMs: Date.now() - startTime,\n      });\n    });\n\n    try {\n      child.stdin?.write(JSON.stringify(stdinPayload));\n      child.stdin?.end();\n    } catch {\n      // stdin write failure — process continues\n    }\n  });\n}\n\nexport function matchesHook(hook: HookDefinition, context: { tool_name?: string }): boolean {\n  if (!hook.matcher) return true;\n\n  if (hook.matcher.tool_name) {\n    if (!context.tool_name) return false;\n    try {\n      return new RegExp(hook.matcher.tool_name).test(context.tool_name);\n    } catch {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nexport async function runHooksForEvent(\n  hooks: HookDefinition[],\n  stdinPayload: HookStdin,\n  matchContext: { tool_name?: string } = {},\n): Promise<HookEventResult> {\n  const results: HookResult[] = [];\n  const warnings: string[] = [];\n  let additionalContext: string | undefined;\n\n  const applicable = hooks.filter(h => matchesHook(h, matchContext));\n  if (applicable.length === 0) {\n    return { allowed: true, results: [], warnings: [] };\n  }\n\n  const blocking = isBlockingEvent(stdinPayload.hook_event_name);\n\n  for (const hook of applicable) {\n    const result = await executeHook(hook, stdinPayload);\n    results.push(result);\n\n    if (result.stdout?.additionalContext) {\n      additionalContext = additionalContext\n        ? `${additionalContext}\\n${result.stdout.additionalContext}`\n        : result.stdout.additionalContext;\n    }\n\n    if (result.timedOut) {\n      warnings.push(`Hook timed out after ${hook.timeout ?? DEFAULT_TIMEOUT}ms: ${hook.command}`);\n      continue;\n    }\n\n    if (result.exitCode === 2 && blocking) {\n      const reason = result.stdout?.reason || result.stderr || `Blocked by hook: ${hook.description || hook.command}`;\n\n      return {\n        allowed: false,\n        blockReason: reason,\n        additionalContext,\n        results,\n        warnings,\n      };\n    }\n\n    if (result.exitCode === 0) continue;\n\n    const warnMsg = result.stderr || `Hook exited with code ${result.exitCode}`;\n    warnings.push(`${hook.description || hook.command}: ${warnMsg}`);\n  }\n\n  return { allowed: true, additionalContext, results, warnings };\n}\n"],"mappings":"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"}

package/dist/hooks/manager.d.ts

@@ -1,4 +1,4 @@
-import type { HooksConfig, HookEventResult, PermissionKind, PermissionDecision, InterruptReason } from './types.js';
+import type { HooksConfig, HookEventResult, PermissionKind, PermissionDecision, InterruptReason, SessionWorktreeInfo } from './types.js';
 export declare class HookManager {
     private config;
     private projectDir;
@@ -6,7 +6,8 @@ export declare class HookManager {
     private configDirName;
     private homeDir?;
     private runId?;
-    constructor(projectDir: string, sessionId: string, configDirName?: string, homeDir?: string);
+    private worktree?;
+    constructor(projectDir: string, sessionId: string, configDirName?: string, homeDir?: string, worktree?: SessionWorktreeInfo);
     reload(): void;
     setSessionId(sessionId: string): void;
     /** Set the active agent run id. Included as `run_id` in all hook stdin while a run is active. */
@@ -25,6 +26,12 @@ export declare class HookManager {
      * is set, so every event dispatched during a run carries the same identifier.
      */
     private baseStdinFields;
+    /**
+     * Session stdin, carrying worktree identity when there is one. Emitted on both
+     * session events so a hook that provisions on start can tear down on end using
+     * the same fields.
+     */
+    private sessionStdin;
     runPreToolUse(toolName: string, toolInput: unknown): Promise<HookEventResult>;
     runPostToolUse(toolName: string, toolInput: unknown, toolOutput: unknown, toolError: boolean): Promise<HookEventResult>;
     runUserPromptSubmit(userMessage: string): Promise<HookEventResult>;

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

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/hooks/manager.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EAcf,cAAc,EACd,kBAAkB,EAClB,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,SAAqB,EAAE,OAAO,CAAC,EAAE,MAAM;IAQvG,MAAM,IAAI,IAAI;IAId,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC,iGAAiG;IACjG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,uGAAuG;IACvG,UAAU,IAAI,IAAI;IAIlB,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B,QAAQ,IAAI,OAAO;IAInB,SAAS,IAAI,WAAW;IAIxB,cAAc,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAWrD;;;OAGG;IACH,OAAO,CAAC,eAAe;IAqBjB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAe7E,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,eAAe,CAAC;IAiBrB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAclE,OAAO,CACX,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAC3C,OAAO,CAAC,eAAe,CAAC;IAerB,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IAY3C,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAa/C;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAkBjD,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAkBzC,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAmBjG,oBAAoB,CACxB,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,eAAe,CAAC;IAsBrB,mBAAmB,CACvB,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,eAAe,CAAC;IAwBrB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAoB/D,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,eAAe,CAAC;IAuBrB,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC;CAsB5B"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/hooks/manager.ts"],"names":[],"mappings":"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"}

package/dist/hooks/manager.js

@@ -18,7 +18,9 @@ var HookManager = class {
 	configDirName;
 	homeDir;
 	runId;
-	constructor(projectDir, sessionId, configDirName = DEFAULT_CONFIG_DIR, homeDir) {
+	worktree;
+	constructor(projectDir, sessionId, configDirName = DEFAULT_CONFIG_DIR, homeDir, worktree) {
+		this.worktree = worktree;
 		this.projectDir = projectDir;
 		this.sessionId = sessionId;
 		this.configDirName = configDirName;
@@ -67,6 +69,20 @@ var HookManager = class {
 		if (this.runId) base.run_id = this.runId;
 		return base;
 	}
+	/**
+	* Session stdin, carrying worktree identity when there is one. Emitted on both
+	* session events so a hook that provisions on start can tear down on end using
+	* the same fields.
+	*/
+	sessionStdin(hook_event_name) {
+		const stdin = this.baseStdinFields(hook_event_name);
+		if (this.worktree) {
+			stdin.worktree_path = this.worktree.path;
+			if (this.worktree.branch) stdin.branch = this.worktree.branch;
+			if (this.worktree.mainRepoPath) stdin.main_repo_path = this.worktree.mainRepoPath;
+		}
+		return stdin;
+	}
 	async runPreToolUse(toolName, toolInput) {
 		const hooks = this.config.PreToolUse;
 		if (!hooks || hooks.length === 0) return emptyResult();
@@ -107,12 +123,12 @@ var HookManager = class {
 	async runSessionStart() {
 		const hooks = this.config.SessionStart;
 		if (!hooks || hooks.length === 0) return emptyResult();
-		return runHooksForEvent(hooks, { ...this.baseStdinFields("SessionStart") });
+		return runHooksForEvent(hooks, this.sessionStdin("SessionStart"));
 	}
 	async runSessionEnd() {
 		const hooks = this.config.SessionEnd;
 		if (!hooks || hooks.length === 0) return emptyResult();
-		return runHooksForEvent(hooks, { ...this.baseStdinFields("SessionEnd") });
+		return runHooksForEvent(hooks, this.sessionStdin("SessionEnd"));
 	}
 	/**
 	* Fire notification hooks (non-blocking, fire-and-forget).

package/dist/hooks/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","names":[],"sources":["../../src/hooks/manager.ts"],"sourcesContent":["/**\n * HookManager — high-level orchestration for the hooks system.\n * Created once at startup, provides methods for each lifecycle event.\n */\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nimport { loadHooksConfig, getProjectHooksPath, getGlobalHooksPath } from './config.js';\nimport { runHooksForEvent } from './executor.js';\nimport type {\n  HooksConfig,\n  HookEventResult,\n  HookEventName,\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  PermissionKind,\n  PermissionDecision,\n  InterruptReason,\n} from './types.js';\n\nconst emptyResult = (): HookEventResult => ({ allowed: true, results: [], warnings: [] });\n\nexport class HookManager {\n  private config: HooksConfig;\n  private projectDir: string;\n  private sessionId: string;\n  private configDirName: string;\n  private homeDir?: string;\n  private runId?: string;\n\n  constructor(projectDir: string, sessionId: string, configDirName = DEFAULT_CONFIG_DIR, homeDir?: string) {\n    this.projectDir = projectDir;\n    this.sessionId = sessionId;\n    this.configDirName = configDirName;\n    this.homeDir = homeDir;\n    this.config = loadHooksConfig(projectDir, configDirName, homeDir);\n  }\n\n  reload(): void {\n    this.config = loadHooksConfig(this.projectDir, this.configDirName, this.homeDir);\n  }\n\n  setSessionId(sessionId: string): void {\n    this.sessionId = sessionId;\n  }\n\n  /** Set the active agent run id. Included as `run_id` in all hook stdin while a run is active. */\n  setRunId(runId: string): void {\n    this.runId = runId;\n  }\n\n  /** Clear the active run id. Call only after end-of-run hooks (AgentEnd, Stop) have been dispatched. */\n  clearRunId(): void {\n    this.runId = undefined;\n  }\n\n  getRunId(): string | undefined {\n    return this.runId;\n  }\n\n  hasHooks(): boolean {\n    return Object.keys(this.config).length > 0;\n  }\n\n  getConfig(): HooksConfig {\n    return this.config;\n  }\n\n  getConfigPaths(): { project: string; global: string } {\n    return {\n      project: getProjectHooksPath(this.projectDir, this.configDirName),\n      global: getGlobalHooksPath(this.configDirName, this.homeDir),\n    };\n  }\n\n  // =========================================================================\n  // Stdin Helpers\n  // =========================================================================\n\n  /**\n   * Build the common stdin base fields. `run_id` is included when an active run\n   * is set, so every event dispatched during a run carries the same identifier.\n   */\n  private baseStdinFields<T extends HookEventName>(\n    hook_event_name: T,\n  ): {\n    session_id: string;\n    cwd: string;\n    hook_event_name: T;\n    run_id?: string;\n  } {\n    const base: { session_id: string; cwd: string; hook_event_name: T; run_id?: string } = {\n      session_id: this.sessionId,\n      cwd: this.projectDir,\n      hook_event_name,\n    };\n    if (this.runId) base.run_id = this.runId;\n    return base;\n  }\n\n  // =========================================================================\n  // Blocking Event Methods (decisions enforced by callers)\n  // =========================================================================\n\n  async runPreToolUse(toolName: string, toolInput: unknown): Promise<HookEventResult> {\n    const hooks = this.config.PreToolUse;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinToolEvent = {\n      ...this.baseStdinFields('PreToolUse'),\n      tool_name: toolName,\n      tool_input: toolInput,\n    };\n\n    return runHooksForEvent(hooks, stdin, { tool_name: toolName });\n  }\n\n  async runPostToolUse(\n    toolName: string,\n    toolInput: unknown,\n    toolOutput: unknown,\n    toolError: boolean,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.PostToolUse;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinToolEvent = {\n      ...this.baseStdinFields('PostToolUse'),\n      tool_name: toolName,\n      tool_input: toolInput,\n      tool_output: toolOutput,\n      tool_error: toolError,\n    };\n\n    return runHooksForEvent(hooks, stdin, { tool_name: toolName });\n  }\n\n  async runUserPromptSubmit(userMessage: string): Promise<HookEventResult> {\n    const hooks = this.config.UserPromptSubmit;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinUserPrompt = {\n      ...this.baseStdinFields('UserPromptSubmit'),\n      user_message: userMessage,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runStop(\n    assistantMessage: string | undefined,\n    stopReason: 'complete' | 'aborted' | 'error',\n  ): Promise<HookEventResult> {\n    const hooks = this.config.Stop;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinStop = {\n      ...this.baseStdinFields('Stop'),\n      assistant_message: assistantMessage,\n      stop_reason: stopReason,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runSessionStart(): Promise<HookEventResult> {\n    const hooks = this.config.SessionStart;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSession = {\n      ...this.baseStdinFields('SessionStart'),\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n  async runSessionEnd(): Promise<HookEventResult> {\n    const hooks = this.config.SessionEnd;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSession = {\n      ...this.baseStdinFields('SessionEnd'),\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  /**\n   * Fire notification hooks (non-blocking, fire-and-forget).\n   * Called when the TUI is waiting for user input.\n   */\n  runNotification(reason: string, message?: string): void {\n    const hooks = this.config.Notification;\n    if (!hooks || hooks.length === 0) return;\n\n    const stdin: HookStdinNotification = {\n      ...this.baseStdinFields('Notification'),\n      reason,\n      message,\n    };\n\n    // Fire-and-forget — don't await\n    runHooksForEvent(hooks, stdin).catch(() => {});\n  }\n\n  // =========================================================================\n  // Lifecycle Event Methods (non-blocking: observe behavior, never enforce)\n  // =========================================================================\n\n  async runAgentStart(): Promise<HookEventResult> {\n    const hooks = this.config.AgentStart;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinAgentStart = {\n      ...this.baseStdinFields('AgentStart'),\n      run_id: runId,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runAgentEnd(stopReason: 'complete' | 'aborted' | 'error' | 'suspended'): Promise<HookEventResult> {\n    const hooks = this.config.AgentEnd;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinAgentEnd = {\n      ...this.baseStdinFields('AgentEnd'),\n      run_id: runId,\n      stop_reason: stopReason,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runPermissionRequest(\n    permissionKind: PermissionKind,\n    toolCallId: string,\n    toolName: string,\n    toolInput?: unknown,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.PermissionRequest;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinPermissionRequest = {\n      ...this.baseStdinFields('PermissionRequest'),\n      run_id: runId,\n      permission_kind: permissionKind,\n      tool_call_id: toolCallId,\n      tool_name: toolName,\n      ...(toolInput !== undefined ? { tool_input: toolInput } : {}),\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runPermissionResult(\n    permissionKind: PermissionKind,\n    toolCallId: string,\n    toolName: string,\n    decision: PermissionDecision,\n    toolInput?: unknown,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.PermissionResult;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinPermissionResult = {\n      ...this.baseStdinFields('PermissionResult'),\n      run_id: runId,\n      permission_kind: permissionKind,\n      tool_call_id: toolCallId,\n      tool_name: toolName,\n      decision,\n      ...(toolInput !== undefined ? { tool_input: toolInput } : {}),\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runInterrupt(reason: InterruptReason): Promise<HookEventResult> {\n    const hooks = this.config.Interrupt;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinInterrupt = {\n      ...this.baseStdinFields('Interrupt'),\n      run_id: runId,\n      reason,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runSubagentStart(\n    toolCallId: string,\n    agentType: string,\n    task: string,\n    modelId?: string,\n    forked?: boolean,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.SubagentStart;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSubagentStart = {\n      ...this.baseStdinFields('SubagentStart'),\n      run_id: runId,\n      tool_call_id: toolCallId,\n      agent_type: agentType,\n      task,\n      ...(modelId !== undefined ? { model_id: modelId } : {}),\n      ...(forked !== undefined ? { forked } : {}),\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runSubagentEnd(\n    toolCallId: string,\n    agentType: string,\n    result: unknown,\n    isError: boolean,\n    durationMs: number,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.SubagentEnd;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSubagentEnd = {\n      ...this.baseStdinFields('SubagentEnd'),\n      run_id: runId,\n      tool_call_id: toolCallId,\n      agent_type: agentType,\n      result,\n      is_error: isError,\n      duration_ms: durationMs,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"manager.js","names":[],"sources":["../../src/hooks/manager.ts"],"sourcesContent":["/**\n * HookManager — high-level orchestration for the hooks system.\n * Created once at startup, provides methods for each lifecycle event.\n */\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nimport { loadHooksConfig, getProjectHooksPath, getGlobalHooksPath } from './config.js';\nimport { runHooksForEvent } from './executor.js';\nimport type {\n  HooksConfig,\n  HookEventResult,\n  HookEventName,\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  PermissionKind,\n  PermissionDecision,\n  InterruptReason,\n  SessionWorktreeInfo,\n} from './types.js';\n\nconst emptyResult = (): HookEventResult => ({ allowed: true, results: [], warnings: [] });\n\nexport class HookManager {\n  private config: HooksConfig;\n  private projectDir: string;\n  private sessionId: string;\n  private configDirName: string;\n  private homeDir?: string;\n  private runId?: string;\n  private worktree?: SessionWorktreeInfo;\n\n  constructor(\n    projectDir: string,\n    sessionId: string,\n    configDirName = DEFAULT_CONFIG_DIR,\n    homeDir?: string,\n    worktree?: SessionWorktreeInfo,\n  ) {\n    this.worktree = worktree;\n    this.projectDir = projectDir;\n    this.sessionId = sessionId;\n    this.configDirName = configDirName;\n    this.homeDir = homeDir;\n    this.config = loadHooksConfig(projectDir, configDirName, homeDir);\n  }\n\n  reload(): void {\n    this.config = loadHooksConfig(this.projectDir, this.configDirName, this.homeDir);\n  }\n\n  setSessionId(sessionId: string): void {\n    this.sessionId = sessionId;\n  }\n\n  /** Set the active agent run id. Included as `run_id` in all hook stdin while a run is active. */\n  setRunId(runId: string): void {\n    this.runId = runId;\n  }\n\n  /** Clear the active run id. Call only after end-of-run hooks (AgentEnd, Stop) have been dispatched. */\n  clearRunId(): void {\n    this.runId = undefined;\n  }\n\n  getRunId(): string | undefined {\n    return this.runId;\n  }\n\n  hasHooks(): boolean {\n    return Object.keys(this.config).length > 0;\n  }\n\n  getConfig(): HooksConfig {\n    return this.config;\n  }\n\n  getConfigPaths(): { project: string; global: string } {\n    return {\n      project: getProjectHooksPath(this.projectDir, this.configDirName),\n      global: getGlobalHooksPath(this.configDirName, this.homeDir),\n    };\n  }\n\n  // =========================================================================\n  // Stdin Helpers\n  // =========================================================================\n\n  /**\n   * Build the common stdin base fields. `run_id` is included when an active run\n   * is set, so every event dispatched during a run carries the same identifier.\n   */\n  private baseStdinFields<T extends HookEventName>(\n    hook_event_name: T,\n  ): {\n    session_id: string;\n    cwd: string;\n    hook_event_name: T;\n    run_id?: string;\n  } {\n    const base: { session_id: string; cwd: string; hook_event_name: T; run_id?: string } = {\n      session_id: this.sessionId,\n      cwd: this.projectDir,\n      hook_event_name,\n    };\n    if (this.runId) base.run_id = this.runId;\n    return base;\n  }\n\n  /**\n   * Session stdin, carrying worktree identity when there is one. Emitted on both\n   * session events so a hook that provisions on start can tear down on end using\n   * the same fields.\n   */\n  private sessionStdin(hook_event_name: 'SessionStart' | 'SessionEnd'): HookStdinSession {\n    const stdin: HookStdinSession = this.baseStdinFields(hook_event_name);\n    if (this.worktree) {\n      stdin.worktree_path = this.worktree.path;\n      if (this.worktree.branch) stdin.branch = this.worktree.branch;\n      if (this.worktree.mainRepoPath) stdin.main_repo_path = this.worktree.mainRepoPath;\n    }\n    return stdin;\n  }\n\n  // =========================================================================\n  // Blocking Event Methods (decisions enforced by callers)\n  // =========================================================================\n\n  async runPreToolUse(toolName: string, toolInput: unknown): Promise<HookEventResult> {\n    const hooks = this.config.PreToolUse;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinToolEvent = {\n      ...this.baseStdinFields('PreToolUse'),\n      tool_name: toolName,\n      tool_input: toolInput,\n    };\n\n    return runHooksForEvent(hooks, stdin, { tool_name: toolName });\n  }\n\n  async runPostToolUse(\n    toolName: string,\n    toolInput: unknown,\n    toolOutput: unknown,\n    toolError: boolean,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.PostToolUse;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinToolEvent = {\n      ...this.baseStdinFields('PostToolUse'),\n      tool_name: toolName,\n      tool_input: toolInput,\n      tool_output: toolOutput,\n      tool_error: toolError,\n    };\n\n    return runHooksForEvent(hooks, stdin, { tool_name: toolName });\n  }\n\n  async runUserPromptSubmit(userMessage: string): Promise<HookEventResult> {\n    const hooks = this.config.UserPromptSubmit;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinUserPrompt = {\n      ...this.baseStdinFields('UserPromptSubmit'),\n      user_message: userMessage,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runStop(\n    assistantMessage: string | undefined,\n    stopReason: 'complete' | 'aborted' | 'error',\n  ): Promise<HookEventResult> {\n    const hooks = this.config.Stop;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinStop = {\n      ...this.baseStdinFields('Stop'),\n      assistant_message: assistantMessage,\n      stop_reason: stopReason,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runSessionStart(): Promise<HookEventResult> {\n    const hooks = this.config.SessionStart;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSession = this.sessionStdin('SessionStart');\n\n    return runHooksForEvent(hooks, stdin);\n  }\n  async runSessionEnd(): Promise<HookEventResult> {\n    const hooks = this.config.SessionEnd;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSession = this.sessionStdin('SessionEnd');\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  /**\n   * Fire notification hooks (non-blocking, fire-and-forget).\n   * Called when the TUI is waiting for user input.\n   */\n  runNotification(reason: string, message?: string): void {\n    const hooks = this.config.Notification;\n    if (!hooks || hooks.length === 0) return;\n\n    const stdin: HookStdinNotification = {\n      ...this.baseStdinFields('Notification'),\n      reason,\n      message,\n    };\n\n    // Fire-and-forget — don't await\n    runHooksForEvent(hooks, stdin).catch(() => {});\n  }\n\n  // =========================================================================\n  // Lifecycle Event Methods (non-blocking: observe behavior, never enforce)\n  // =========================================================================\n\n  async runAgentStart(): Promise<HookEventResult> {\n    const hooks = this.config.AgentStart;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinAgentStart = {\n      ...this.baseStdinFields('AgentStart'),\n      run_id: runId,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runAgentEnd(stopReason: 'complete' | 'aborted' | 'error' | 'suspended'): Promise<HookEventResult> {\n    const hooks = this.config.AgentEnd;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinAgentEnd = {\n      ...this.baseStdinFields('AgentEnd'),\n      run_id: runId,\n      stop_reason: stopReason,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runPermissionRequest(\n    permissionKind: PermissionKind,\n    toolCallId: string,\n    toolName: string,\n    toolInput?: unknown,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.PermissionRequest;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinPermissionRequest = {\n      ...this.baseStdinFields('PermissionRequest'),\n      run_id: runId,\n      permission_kind: permissionKind,\n      tool_call_id: toolCallId,\n      tool_name: toolName,\n      ...(toolInput !== undefined ? { tool_input: toolInput } : {}),\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runPermissionResult(\n    permissionKind: PermissionKind,\n    toolCallId: string,\n    toolName: string,\n    decision: PermissionDecision,\n    toolInput?: unknown,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.PermissionResult;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinPermissionResult = {\n      ...this.baseStdinFields('PermissionResult'),\n      run_id: runId,\n      permission_kind: permissionKind,\n      tool_call_id: toolCallId,\n      tool_name: toolName,\n      decision,\n      ...(toolInput !== undefined ? { tool_input: toolInput } : {}),\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runInterrupt(reason: InterruptReason): Promise<HookEventResult> {\n    const hooks = this.config.Interrupt;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinInterrupt = {\n      ...this.baseStdinFields('Interrupt'),\n      run_id: runId,\n      reason,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runSubagentStart(\n    toolCallId: string,\n    agentType: string,\n    task: string,\n    modelId?: string,\n    forked?: boolean,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.SubagentStart;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSubagentStart = {\n      ...this.baseStdinFields('SubagentStart'),\n      run_id: runId,\n      tool_call_id: toolCallId,\n      agent_type: agentType,\n      task,\n      ...(modelId !== undefined ? { model_id: modelId } : {}),\n      ...(forked !== undefined ? { forked } : {}),\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runSubagentEnd(\n    toolCallId: string,\n    agentType: string,\n    result: unknown,\n    isError: boolean,\n    durationMs: number,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.SubagentEnd;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSubagentEnd = {\n      ...this.baseStdinFields('SubagentEnd'),\n      run_id: runId,\n      tool_call_id: toolCallId,\n      agent_type: agentType,\n      result,\n      is_error: isError,\n      duration_ms: durationMs,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n}\n"],"mappings":"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"}

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"}