@mastra/code-sdk 0.0.0-fix-workflow-step-timing-and-parallel-status-20260715180716

package/dist/agents/model.d.ts

@@ -0,0 +1,55 @@
+import type { GatewayLanguageModel, MastraModelGatewayInterface } from '@mastra/core/llm';
+import type { RequestContext } from '@mastra/core/request-context';
+import type { ThinkingLevel } from '../providers/openai-codex.js';
+import { MastraCodeGateway } from './mastracode-gateway.js';
+import type { MastraCodeGatewayOptions } from './mastracode-gateway.js';
+export { getAnthropicApiKey, getOpenAIApiKey, MASTRACODE_GATEWAY_ID, MastraCodeGateway, remapOpenAIModelForCodexOAuth, resolveAuth, } from './mastracode-gateway.js';
+export type { MastraCodeCustomProvider, MastraCodeGatewayOptions } from './mastracode-gateway.js';
+type ResolvedModel = GatewayLanguageModel;
+export declare function createMastraCodeGateway(options: MastraCodeGatewayOptions): MastraCodeGateway;
+export declare function createMastraCodeModelCatalogProvider(gateway: MastraModelGatewayInterface): import("@mastra/core/harness").CustomModelCatalogProvider;
+/**
+ * Placeholder for future model ID normalization.
+ * Currently returns the input unchanged, but exists as a seam
+ * for aliasing, casing fixes, or validation in the future.
+ */
+export declare function resolveModelId(modelId: string): string;
+/**
+ * Resolve a model ID to the correct provider instance.
+ * Shared by the main agent, observer, and reflector.
+ *
+ * - For anthropic/* models: Uses stored OAuth credentials when present, otherwise direct API key
+ * - For openai/* models: Uses OAuth when configured, otherwise direct API key from AuthStorage
+ * - For moonshotai/* models: Uses Moonshot AI Anthropic-compatible endpoint
+ * - For all other providers: Uses Mastra's model router (models.dev gateway)
+ */
+export declare function resolveModel(modelId: string, options?: {
+    thinkingLevel?: ThinkingLevel;
+    remapForCodexOAuth?: boolean;
+    requestContext?: RequestContext;
+}): GatewayLanguageModel;
+/**
+ * Dynamic model function that reads the current model from controller state.
+ * This allows runtime model switching via the /models picker.
+ */
+export declare function getDynamicModel({ requestContext }: {
+    requestContext: RequestContext;
+}): ResolvedModel;
+/**
+ * Goal judge model resolver for the agent's `goal.judge` config. Resolves the
+ * configured goal judge model through mastracode's gateway so provider
+ * credentials (stored in auth storage, not just env) are injected — a bare model
+ * id handed to core's default model router would fail to find the API key.
+ *
+ * Returns `undefined` when no judge model is configured, which keeps the goal
+ * step a complete no-op (the goal mechanism requires a judge to do anything).
+ *
+ * `settingsPath` must be the same source `createMastraCode()` reads from so the
+ * judge model and the goal budget (`goalMaxTurns`) come from one config — with a
+ * custom `settingsPath` a bare `loadSettings()` here could read a different file
+ * and silently turn the goal step into a no-op.
+ */
+export declare function getGoalJudgeModel({ requestContext }: {
+    requestContext: RequestContext;
+}, settingsPath?: string): ResolvedModel | undefined;
+//# sourceMappingURL=model.d.ts.map

package/dist/agents/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/agents/model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAGL,iBAAiB,EAGlB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,6BAA6B,EAC7B,WAAW,GACZ,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAElG,KAAK,aAAa,GAAG,oBAAoB,CAAC;AAa1C,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAE5F;AAED,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,2BAA2B,6DAIxF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,aAAa,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,cAAc,CAAA;CAAE,GACzG,oBAAoB,CA+DtB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,cAAc,EAAE,EAAE;IAAE,cAAc,EAAE,cAAc,CAAA;CAAE,GAAG,aAAa,CAWrG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,cAAc,EAAE,EAAE;IAAE,cAAc,EAAE,cAAc,CAAA;CAAE,EACtD,YAAY,CAAC,EAAE,MAAM,GACpB,aAAa,GAAG,SAAS,CAI3B"}

package/dist/agents/model.js

@@ -0,0 +1,115 @@
+import { loadSettings } from "../onboarding/settings.js";
+import { AMAZON_BEDROCK_GATEWAY_ID, createAmazonBedrockGateway } from "../providers/amazon-bedrock-gateway.js";
+import {
+  MASTRA_GATEWAY_PREFIX,
+  MASTRACODE_GATEWAY_ID,
+  MastraCodeGateway,
+  reloadAuthStorage,
+  stripMastraGatewayPrefix
+} from "./mastracode-gateway.js";
+import {
+  getAnthropicApiKey,
+  getOpenAIApiKey,
+  MASTRACODE_GATEWAY_ID as MASTRACODE_GATEWAY_ID2,
+  MastraCodeGateway as MastraCodeGateway2,
+  remapOpenAIModelForCodexOAuth,
+  resolveAuth
+} from "./mastracode-gateway.js";
+function getAgentControllerHeaders(requestContext) {
+  const agentControllerContext = requestContext?.get("controller");
+  const headers = {
+    ...agentControllerContext?.threadId ? { "x-thread-id": agentControllerContext.threadId } : {},
+    ...agentControllerContext?.resourceId ? { "x-resource-id": agentControllerContext.resourceId } : {}
+  };
+  return Object.keys(headers).length > 0 ? headers : void 0;
+}
+function createMastraCodeGateway(options) {
+  return new MastraCodeGateway(options);
+}
+function createMastraCodeModelCatalogProvider(gateway) {
+  return gateway instanceof MastraCodeGateway ? gateway.createModelCatalogProvider() : MastraCodeGateway.createModelCatalogProvider(gateway);
+}
+function resolveModelId(modelId) {
+  return modelId;
+}
+function resolveModel(modelId, options) {
+  reloadAuthStorage();
+  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 isMastraGatewayModel = normalizedInput.startsWith(MASTRA_GATEWAY_PREFIX);
+  const normalizedModelId = stripMastraGatewayPrefix(normalizedInput);
+  const [providerId, ...modelParts] = normalizedModelId.split("/");
+  const bareModelId = modelParts.join("/");
+  if (!providerId || !bareModelId) {
+    throw new Error(`Invalid model id: ${modelId}`);
+  }
+  if (providerId === AMAZON_BEDROCK_GATEWAY_ID) {
+    const bedrockGateway = createAmazonBedrockGateway();
+    const routerId2 = `${AMAZON_BEDROCK_GATEWAY_ID}/${bareModelId}`;
+    const auth2 = bedrockGateway.resolveAuth({
+      gatewayId: AMAZON_BEDROCK_GATEWAY_ID,
+      providerId: AMAZON_BEDROCK_GATEWAY_ID,
+      modelId: bareModelId,
+      routerId: routerId2
+    });
+    return bedrockGateway.resolveLanguageModel({
+      providerId: AMAZON_BEDROCK_GATEWAY_ID,
+      modelId: bareModelId,
+      apiKey: auth2?.apiKey ?? "",
+      headers
+    });
+  }
+  const routerId = `${MASTRACODE_GATEWAY_ID}/${normalizedModelId}`;
+  const mgApiKey = MastraCodeGateway.getMastraGatewayApiKey();
+  const rawGatewayBase = settings.memoryGateway?.baseUrl ?? process.env["MASTRA_GATEWAY_URL"] ?? "https://gateway-api.mastra.ai";
+  const gateway = createMastraCodeGateway({
+    mastraGatewayBaseUrl: rawGatewayBase.replace(/\/+$/, "").replace(/\/v1$/, ""),
+    mastraGatewayApiKey: mgApiKey,
+    routeThroughMastraGateway: Boolean(mgApiKey && isMastraGatewayModel),
+    thinkingLevel: options?.thinkingLevel,
+    customProviders: settings.customProviders
+  });
+  const auth = gateway.resolveAuth({
+    gatewayId: MASTRACODE_GATEWAY_ID,
+    providerId,
+    modelId: bareModelId,
+    routerId
+  });
+  return gateway.resolveLanguageModel({
+    providerId,
+    modelId: bareModelId,
+    apiKey: auth?.apiKey ?? mgApiKey ?? "",
+    headers
+  });
+}
+function getDynamicModel({ requestContext }) {
+  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, remapForCodexOAuth: true, requestContext });
+}
+function getGoalJudgeModel({ requestContext }, settingsPath) {
+  const judgeModelId = loadSettings(settingsPath).models.goalJudgeModel;
+  if (!judgeModelId) return void 0;
+  return resolveModel(judgeModelId, { remapForCodexOAuth: true, requestContext });
+}
+export {
+  MASTRACODE_GATEWAY_ID2 as MASTRACODE_GATEWAY_ID,
+  MastraCodeGateway2 as MastraCodeGateway,
+  createMastraCodeGateway,
+  createMastraCodeModelCatalogProvider,
+  getAnthropicApiKey,
+  getDynamicModel,
+  getGoalJudgeModel,
+  getOpenAIApiKey,
+  remapOpenAIModelForCodexOAuth,
+  resolveAuth,
+  resolveModel,
+  resolveModelId
+};
+//# sourceMappingURL=model.js.map

package/dist/agents/model.js.map

@@ -0,0 +1 @@
+{"version":3,"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 {\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';\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  const gateway = createMastraCodeGateway({\n    mastraGatewayBaseUrl: rawGatewayBase.replace(/\\/+$/, '').replace(/\\/v1$/, ''),\n    mastraGatewayApiKey: mgApiKey,\n    routeThroughMastraGateway: Boolean(mgApiKey && isMastraGatewayModel),\n    thinkingLevel: options?.thinkingLevel,\n    customProviders: settings.customProviders,\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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","names":["MASTRACODE_GATEWAY_ID","MastraCodeGateway","routerId","auth"]}

package/dist/agents/modes/build.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Execute subagent — focused task execution with write capabilities.
+ *
+ * This subagent is given a specific implementation task and uses both
+ * read and write tools to complete it. It can modify files, run commands,
+ * and perform actual development work within a constrained scope.
+ */
+import type { AgentControllerMode } from '@mastra/core/agent-controller';
+export declare const buildMode: AgentControllerMode;
+//# sourceMappingURL=build.d.ts.map

package/dist/agents/modes/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/agents/modes/build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,eAAO,MAAM,SAAS,EAAE,mBAyCvB,CAAC"}

package/dist/agents/modes/build.js

@@ -0,0 +1,45 @@
+const buildMode = {
+  id: "build",
+  name: "Build",
+  description: "Task execution with write capabilities. Use for 'implement feature X', 'fix bug Y', 'refactor module Z'.",
+  instructions: `You are a focused execution agent. Your job is to complete a specific, well-defined task by making the necessary changes to the codebase.
+
+## Rules
+- You have FULL ACCESS to read, write, and execute within your task scope.
+- Stay focused on the specific task given. Do not make unrelated changes.
+- Read files before modifying them \u2014 use view first, then string_replace_lsp or write_file.
+- Verify your changes work by running relevant tests or checking for errors.
+
+## Tool Strategy
+- **Read first**: Always view a file before editing it
+- **Edit precisely**: Use string_replace_lsp with enough context to match uniquely
+- **Use specialized tools**: Prefer view/search_content/find_files over shell commands for reading
+- **Parallelize**: Make independent tool calls together (e.g., view multiple files at once)
+
+## Workflow
+. Understand the task and explore relevant code
+. For complex tasks (3+ steps): track progress internally and summarize it in your final answer
+. Make changes incrementally \u2014 verify each change before moving on
+. Run tests or type-check to verify
+
+## Efficiency
+Your output returns to the parent agent. Be concise:
+- Don't repeat file contents in your response
+- Summarize what changed, don't narrate each step
+- Keep your final summary under 300 words
+
+## Output Format
+End with a structured summary:
+. **Completed**: What you implemented (1-2 sentences)
+. **Changes**: Files modified/created
+. **Verification**: How you verified it works
+. **Notes**: Follow-up needed (if any)`,
+  defaultModelId: "openai/gpt-5.5",
+  metadata: {
+    default: true
+  }
+};
+export {
+  buildMode
+};
+//# sourceMappingURL=build.js.map

package/dist/agents/modes/build.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/agents/modes/build.ts"],"sourcesContent":["/**\n * Execute subagent — focused task execution with write capabilities.\n *\n * This subagent is given a specific implementation task and uses both\n * read and write tools to complete it. It can modify files, run commands,\n * and perform actual development work within a constrained scope.\n */\nimport type { AgentControllerMode } from '@mastra/core/agent-controller';\n\nexport const buildMode: AgentControllerMode = {\n  id: 'build',\n  name: 'Build',\n  description:\n    \"Task execution with write capabilities. Use for 'implement feature X', 'fix bug Y', 'refactor module Z'.\",\n  instructions: `You are a focused execution agent. Your job is to complete a specific, well-defined task by making the necessary changes to the codebase.\n\n## Rules\n- You have FULL ACCESS to read, write, and execute within your task scope.\n- Stay focused on the specific task given. Do not make unrelated changes.\n- Read files before modifying them — use view first, then string_replace_lsp or write_file.\n- Verify your changes work by running relevant tests or checking for errors.\n\n## Tool Strategy\n- **Read first**: Always view a file before editing it\n- **Edit precisely**: Use string_replace_lsp with enough context to match uniquely\n- **Use specialized tools**: Prefer view/search_content/find_files over shell commands for reading\n- **Parallelize**: Make independent tool calls together (e.g., view multiple files at once)\n\n## Workflow\n. Understand the task and explore relevant code\n. For complex tasks (3+ steps): track progress internally and summarize it in your final answer\n. Make changes incrementally — verify each change before moving on\n. Run tests or type-check to verify\n\n## Efficiency\nYour output returns to the parent agent. Be concise:\n- Don't repeat file contents in your response\n- Summarize what changed, don't narrate each step\n- Keep your final summary under 300 words\n\n## Output Format\nEnd with a structured summary:\n. **Completed**: What you implemented (1-2 sentences)\n. **Changes**: Files modified/created\n. **Verification**: How you verified it works\n. **Notes**: Follow-up needed (if any)`,\n  defaultModelId: 'openai/gpt-5.5',\n  metadata: {\n    default: true,\n  },\n};\n"],"mappings":"AASO,MAAM,YAAiC;AAAA,EAC5C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,aACE;AAAA,EACF,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgCd,gBAAgB;AAAA,EAChB,UAAU;AAAA,IACR,SAAS;AAAA,EACX;AACF;","names":[]}

package/dist/agents/modes/explore.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Explore subagent — read-only codebase exploration.
+ *
+ * This subagent is given a focused task (e.g., "find all usages of X",
+ * "understand how module Y works") and uses read-only tools to explore
+ * the codebase, then returns a concise summary of its findings.
+ */
+import type { AgentControllerMode } from '@mastra/core/agent-controller';
+export declare const fastMode: AgentControllerMode;
+//# sourceMappingURL=explore.d.ts.map

package/dist/agents/modes/explore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../../src/agents/modes/explore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,eAAO,MAAM,QAAQ,EAAE,mBAkCtB,CAAC"}

package/dist/agents/modes/explore.js

@@ -0,0 +1,38 @@
+import { EXPLORE_MODE_AVAILABLE_TOOLS } from "../tool-availability.js";
+const fastMode = {
+  id: "fast",
+  name: "Explore",
+  description: "Read-only codebase exploration. Use for questions like 'find all usages of X', 'how does module Y work'.",
+  defaultModelId: "openai/gpt-5.4-mini",
+  instructions: `You are an expert code explorer. Your job is to investigate a codebase and answer a specific question or gather specific information.
+
+## Rules
+- You have READ-ONLY access. You cannot modify files or run commands.
+- Be thorough \u2014 search broadly first, then drill into relevant files.
+- After gathering enough information, produce a clear, concise summary of your findings.
+
+## Tool Strategy
+- **Start broad**: Use find_files (glob) to understand project structure
+- **Search smart**: Use search_content (grep) with specific patterns \u2014 avoid overly broad searches
+- **Read efficiently**: Use view with view_range for large files \u2014 don't read entire files if you only need a section
+- **Parallelize**: Make multiple independent tool calls in one round when exploring different areas
+
+## Efficiency
+Your output returns to the parent agent. Be concise:
+- Don't include raw file contents in your response \u2014 summarize what you found
+- Reference files by path and line number, not by copying code
+- If a search returns many results, report the count and key examples, not every match
+
+## Output Format
+End with a structured summary:
+. **Answer**: Direct answer to the question (1-2 sentences)
+. **Key Files**: Most relevant files with line numbers
+. **Details**: Additional context if needed
+
+Keep your summary under 300 words.`,
+  availableTools: [...EXPLORE_MODE_AVAILABLE_TOOLS]
+};
+export {
+  fastMode
+};
+//# sourceMappingURL=explore.js.map

package/dist/agents/modes/explore.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/agents/modes/explore.ts"],"sourcesContent":["/**\n * Explore subagent — read-only codebase exploration.\n *\n * This subagent is given a focused task (e.g., \"find all usages of X\",\n * \"understand how module Y works\") and uses read-only tools to explore\n * the codebase, then returns a concise summary of its findings.\n */\nimport type { AgentControllerMode } from '@mastra/core/agent-controller';\nimport { EXPLORE_MODE_AVAILABLE_TOOLS } from '../tool-availability.js';\n\nexport const fastMode: AgentControllerMode = {\n  id: 'fast',\n  name: 'Explore',\n  description:\n    \"Read-only codebase exploration. Use for questions like 'find all usages of X', 'how does module Y work'.\",\n  defaultModelId: 'openai/gpt-5.4-mini',\n  instructions: `You are an expert code explorer. Your job is to investigate a codebase and answer a specific question or gather specific information.\n\n## Rules\n- You have READ-ONLY access. You cannot modify files or run commands.\n- Be thorough — search broadly first, then drill into relevant files.\n- After gathering enough information, produce a clear, concise summary of your findings.\n\n## Tool Strategy\n- **Start broad**: Use find_files (glob) to understand project structure\n- **Search smart**: Use search_content (grep) with specific patterns — avoid overly broad searches\n- **Read efficiently**: Use view with view_range for large files — don't read entire files if you only need a section\n- **Parallelize**: Make multiple independent tool calls in one round when exploring different areas\n\n## Efficiency\nYour output returns to the parent agent. Be concise:\n- Don't include raw file contents in your response — summarize what you found\n- Reference files by path and line number, not by copying code\n- If a search returns many results, report the count and key examples, not every match\n\n## Output Format\nEnd with a structured summary:\n. **Answer**: Direct answer to the question (1-2 sentences)\n. **Key Files**: Most relevant files with line numbers\n. **Details**: Additional context if needed\n\nKeep your summary under 300 words.`,\n\n  availableTools: [...EXPLORE_MODE_AVAILABLE_TOOLS],\n};\n"],"mappings":"AAQA,SAAS,oCAAoC;AAEtC,MAAM,WAAgC;AAAA,EAC3C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,aACE;AAAA,EACF,gBAAgB;AAAA,EAChB,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA2Bd,gBAAgB,CAAC,GAAG,4BAA4B;AAClD;","names":[]}

package/dist/agents/modes/plan.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Plan mode — read-only analysis and planning.
+ */
+import type { AgentControllerMode } from '@mastra/core/agent-controller';
+export declare const planMode: AgentControllerMode;
+//# sourceMappingURL=plan.d.ts.map

package/dist/agents/modes/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/agents/modes/plan.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,eAAO,MAAM,QAAQ,EAAE,mBAmCtB,CAAC"}

package/dist/agents/modes/plan.js

@@ -0,0 +1,38 @@
+import { PLAN_MODE_AVAILABLE_TOOLS } from "../tool-availability.js";
+const planMode = {
+  id: "plan",
+  name: "Plan",
+  transitionsTo: "build",
+  defaultModelId: "openai/gpt-5.5",
+  description: "Read-only analysis and planning. Use for 'create an implementation plan for X', 'analyze the architecture of Y'.",
+  instructions: `You are an expert software architect and planner. Your job is to analyze a codebase and produce a detailed implementation plan for a given task.
+
+## Rules
+- You have READ-ONLY access to the project. You cannot modify project files or run commands.
+- The one exception is plan files: you can create and edit markdown files inside \`.mastracode/plans/\` using \`write_file\`, \`view\`, and \`string_replace_lsp\`. You may not write anywhere else.
+- First, explore the codebase to understand existing patterns, architecture, and conventions.
+- Produce a concrete, actionable plan \u2014 not vague suggestions.
+
+## Tool Strategy
+- **Discover structure**: Use find_files (glob) to understand project layout and find relevant files
+- **Find patterns**: Use search_content (grep) to locate existing implementations, imports, and conventions
+- **Understand deeply**: Use view with view_range to read specific sections of key files
+- **Parallelize**: Make multiple independent tool calls when exploring different areas
+
+## Plan Delivery
+- Write your plan to a markdown file under \`.mastracode/plans/\` (e.g. \`.mastracode/plans/add-dark-mode.md\`) using \`write_file\`, then call \`submit_plan({ path })\` with the path to that file (never the plan body).
+- Start the file with a \`# Title\` heading describing the plan.
+- Reuse the same file while iterating on the same plan; only create a new file for a genuinely different plan so each plan stays available to review.
+- Do NOT output the plan as text \u2014 it MUST live in the plan file.
+- Be concise: reference files by path and line number, don't include raw contents.
+- Focus on actionable details, not general observations.
+- To revise after "Request changes", edit the same file in place with \`string_replace_lsp\`, and call \`submit_plan\` again with the same path.`,
+  metadata: {
+    default: false
+  },
+  availableTools: [...PLAN_MODE_AVAILABLE_TOOLS]
+};
+export {
+  planMode
+};
+//# sourceMappingURL=plan.js.map

package/dist/agents/modes/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/agents/modes/plan.ts"],"sourcesContent":["/**\n * Plan mode — read-only analysis and planning.\n */\nimport type { AgentControllerMode } from '@mastra/core/agent-controller';\nimport { PLAN_MODE_AVAILABLE_TOOLS } from '../tool-availability.js';\n\nexport const planMode: AgentControllerMode = {\n  id: 'plan',\n  name: 'Plan',\n  transitionsTo: 'build',\n  defaultModelId: 'openai/gpt-5.5',\n  description:\n    \"Read-only analysis and planning. Use for 'create an implementation plan for X', 'analyze the architecture of Y'.\",\n  instructions: `You are an expert software architect and planner. Your job is to analyze a codebase and produce a detailed implementation plan for a given task.\n\n## Rules\n- You have READ-ONLY access to the project. You cannot modify project files or run commands.\n- The one exception is plan files: you can create and edit markdown files inside \\`.mastracode/plans/\\` using \\`write_file\\`, \\`view\\`, and \\`string_replace_lsp\\`. You may not write anywhere else.\n- First, explore the codebase to understand existing patterns, architecture, and conventions.\n- Produce a concrete, actionable plan — not vague suggestions.\n\n## Tool Strategy\n- **Discover structure**: Use find_files (glob) to understand project layout and find relevant files\n- **Find patterns**: Use search_content (grep) to locate existing implementations, imports, and conventions\n- **Understand deeply**: Use view with view_range to read specific sections of key files\n- **Parallelize**: Make multiple independent tool calls when exploring different areas\n\n## Plan Delivery\n- Write your plan to a markdown file under \\`.mastracode/plans/\\` (e.g. \\`.mastracode/plans/add-dark-mode.md\\`) using \\`write_file\\`, then call \\`submit_plan({ path })\\` with the path to that file (never the plan body).\n- Start the file with a \\`# Title\\` heading describing the plan.\n- Reuse the same file while iterating on the same plan; only create a new file for a genuinely different plan so each plan stays available to review.\n- Do NOT output the plan as text — it MUST live in the plan file.\n- Be concise: reference files by path and line number, don't include raw contents.\n- Focus on actionable details, not general observations.\n- To revise after \"Request changes\", edit the same file in place with \\`string_replace_lsp\\`, and call \\`submit_plan\\` again with the same path.`,\n\n  metadata: {\n    default: false,\n  },\n\n  availableTools: [...PLAN_MODE_AVAILABLE_TOOLS],\n};\n"],"mappings":"AAIA,SAAS,iCAAiC;AAEnC,MAAM,WAAgC;AAAA,EAC3C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,aACE;AAAA,EACF,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBd,UAAU;AAAA,IACR,SAAS;AAAA,EACX;AAAA,EAEA,gBAAgB,CAAC,GAAG,yBAAyB;AAC/C;","names":[]}

package/dist/agents/prompts/agent-instructions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Load project and global agent instruction files (AGENTS.md, CLAUDE.md).
+ * Prefers AGENTS.md over CLAUDE.md when multiple exist at the same location.
+ */
+export interface InstructionSource {
+    path: string;
+    content: string;
+    scope: 'global' | 'project';
+}
+/**
+ * Load all agent instruction files from global and project locations.
+ * Returns an array of instruction sources, with global ones first.
+ */
+export declare function loadAgentInstructions(projectPath: string, configDirName?: string): InstructionSource[];
+export declare function getStaticallyLoadedInstructionPaths(projectPath: string): string[];
+/**
+ * Format loaded instructions into a string for the system prompt.
+ */
+export declare function formatAgentInstructions(sources: InstructionSource[]): string;
+//# sourceMappingURL=agent-instructions.d.ts.map

package/dist/agents/prompts/agent-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-instructions.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/agent-instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC7B;AAgBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,SAAqB,GAAG,iBAAiB,EAAE,CAiDlH;AAED,wBAAgB,mCAAmC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAS5E"}

package/dist/agents/prompts/agent-instructions.js

@@ -0,0 +1,82 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, normalize } from "node:path";
+import { DEFAULT_CONFIG_DIR } from "../../constants.js";
+const INSTRUCTION_FILES = ["AGENTS.md", "CLAUDE.md"];
+const PROJECT_LOCATIONS = [
+  "",
+  // project root
+  ".claude",
+  ".mastracode"
+];
+const GLOBAL_LOCATIONS = [".claude", ".mastracode", ".config/claude", ".config/mastracode"];
+function findInstructionFile(basePath) {
+  for (const filename of INSTRUCTION_FILES) {
+    const fullPath = join(basePath, filename);
+    if (existsSync(fullPath)) {
+      return fullPath;
+    }
+  }
+  return null;
+}
+function loadAgentInstructions(projectPath, configDirName = DEFAULT_CONFIG_DIR) {
+  const sources = [];
+  const home = homedir();
+  const projectLocations = PROJECT_LOCATIONS.map((loc) => loc === ".mastracode" ? configDirName : loc);
+  const globalLocations = GLOBAL_LOCATIONS.map((loc) => {
+    if (loc === ".mastracode") return configDirName;
+    if (loc === ".config/mastracode") return ".config/" + configDirName.replace(/^\./, "");
+    return loc;
+  });
+  for (const location of globalLocations) {
+    const basePath = join(home, location);
+    const filePath = findInstructionFile(basePath);
+    if (filePath) {
+      try {
+        const content = readFileSync(filePath, "utf-8").trim();
+        if (content) {
+          sources.push({ path: filePath, content, scope: "global" });
+          break;
+        }
+      } catch {
+      }
+    }
+  }
+  for (const location of projectLocations) {
+    const basePath = location ? join(projectPath, location) : projectPath;
+    const filePath = findInstructionFile(basePath);
+    if (filePath) {
+      try {
+        const content = readFileSync(filePath, "utf-8").trim();
+        if (content) {
+          sources.push({ path: filePath, content, scope: "project" });
+          break;
+        }
+      } catch {
+      }
+    }
+  }
+  return sources;
+}
+function getStaticallyLoadedInstructionPaths(projectPath) {
+  return loadAgentInstructions(projectPath).map((source) => normalize(source.path));
+}
+function formatAgentInstructions(sources) {
+  if (sources.length === 0) return "";
+  const sections = sources.map((source) => {
+    const label = source.scope === "global" ? "Global" : "Project";
+    return `<!-- ${label} instructions from ${source.path} -->
+${source.content}`;
+  });
+  return `
+# Agent Instructions
+
+${sections.join("\n\n")}
+`;
+}
+export {
+  formatAgentInstructions,
+  getStaticallyLoadedInstructionPaths,
+  loadAgentInstructions
+};
+//# sourceMappingURL=agent-instructions.js.map

package/dist/agents/prompts/agent-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/agents/prompts/agent-instructions.ts"],"sourcesContent":["/**\n * Load project and global agent instruction files (AGENTS.md, CLAUDE.md).\n * Prefers AGENTS.md over CLAUDE.md when multiple exist at the same location.\n */\n\nimport { existsSync, readFileSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join, normalize } from 'node:path';\nimport { DEFAULT_CONFIG_DIR } from '../../constants.js';\n\n// Filenames to check, in order of preference\nconst INSTRUCTION_FILES = ['AGENTS.md', 'CLAUDE.md'];\n\n// Locations to scan (relative to project root or home)\nconst PROJECT_LOCATIONS = [\n  '', // project root\n  '.claude',\n  '.mastracode',\n];\n\nconst GLOBAL_LOCATIONS = ['.claude', '.mastracode', '.config/claude', '.config/mastracode'];\n\nexport interface InstructionSource {\n  path: string;\n  content: string;\n  scope: 'global' | 'project';\n}\n\n/**\n * Find the first existing instruction file at a given base path.\n * Prefers AGENTS.md over CLAUDE.md.\n */\nfunction findInstructionFile(basePath: string): string | null {\n  for (const filename of INSTRUCTION_FILES) {\n    const fullPath = join(basePath, filename);\n    if (existsSync(fullPath)) {\n      return fullPath;\n    }\n  }\n  return null;\n}\n\n/**\n * Load all agent instruction files from global and project locations.\n * Returns an array of instruction sources, with global ones first.\n */\nexport function loadAgentInstructions(projectPath: string, configDirName = DEFAULT_CONFIG_DIR): InstructionSource[] {\n  const sources: InstructionSource[] = [];\n  const home = homedir();\n\n  // Derive location arrays from the base constants, substituting the config dir name\n  const projectLocations = PROJECT_LOCATIONS.map(loc => (loc === '.mastracode' ? configDirName : loc));\n  const globalLocations = GLOBAL_LOCATIONS.map(loc => {\n    if (loc === '.mastracode') return configDirName;\n    // XDG-style path (~/.config/<name>): strip the leading dot since the\n    // .config/ prefix already signals a hidden/config directory.\n    if (loc === '.config/mastracode') return '.config/' + configDirName.replace(/^\\./, '');\n    return loc;\n  });\n\n  // Load global instructions first\n  for (const location of globalLocations) {\n    const basePath = join(home, location);\n    const filePath = findInstructionFile(basePath);\n    if (filePath) {\n      try {\n        const content = readFileSync(filePath, 'utf-8').trim();\n        if (content) {\n          sources.push({ path: filePath, content, scope: 'global' });\n          break; // Only use first found global instruction file\n        }\n      } catch {\n        // Skip unreadable files\n      }\n    }\n  }\n\n  // Load project instructions\n  for (const location of projectLocations) {\n    const basePath = location ? join(projectPath, location) : projectPath;\n    const filePath = findInstructionFile(basePath);\n    if (filePath) {\n      try {\n        const content = readFileSync(filePath, 'utf-8').trim();\n        if (content) {\n          sources.push({ path: filePath, content, scope: 'project' });\n          break; // Only use first found project instruction file\n        }\n      } catch {\n        // Skip unreadable files\n      }\n    }\n  }\n\n  return sources;\n}\n\nexport function getStaticallyLoadedInstructionPaths(projectPath: string): string[] {\n  return loadAgentInstructions(projectPath).map(source => normalize(source.path));\n}\n\n/**\n * Format loaded instructions into a string for the system prompt.\n */\nexport function formatAgentInstructions(sources: InstructionSource[]): string {\n  if (sources.length === 0) return '';\n\n  const sections = sources.map(source => {\n    const label = source.scope === 'global' ? 'Global' : 'Project';\n    return `<!-- ${label} instructions from ${source.path} -->\\n${source.content}`;\n  });\n\n  return `\\n# Agent Instructions\\n\\n${sections.join('\\n\\n')}\\n`;\n}\n"],"mappings":"AAKA,SAAS,YAAY,oBAAoB;AACzC,SAAS,eAAe;AACxB,SAAS,MAAM,iBAAiB;AAChC,SAAS,0BAA0B;AAGnC,MAAM,oBAAoB,CAAC,aAAa,WAAW;AAGnD,MAAM,oBAAoB;AAAA,EACxB;AAAA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,mBAAmB,CAAC,WAAW,eAAe,kBAAkB,oBAAoB;AAY1F,SAAS,oBAAoB,UAAiC;AAC5D,aAAW,YAAY,mBAAmB;AACxC,UAAM,WAAW,KAAK,UAAU,QAAQ;AACxC,QAAI,WAAW,QAAQ,GAAG;AACxB,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAMO,SAAS,sBAAsB,aAAqB,gBAAgB,oBAAyC;AAClH,QAAM,UAA+B,CAAC;AACtC,QAAM,OAAO,QAAQ;AAGrB,QAAM,mBAAmB,kBAAkB,IAAI,SAAQ,QAAQ,gBAAgB,gBAAgB,GAAI;AACnG,QAAM,kBAAkB,iBAAiB,IAAI,SAAO;AAClD,QAAI,QAAQ,cAAe,QAAO;AAGlC,QAAI,QAAQ,qBAAsB,QAAO,aAAa,cAAc,QAAQ,OAAO,EAAE;AACrF,WAAO;AAAA,EACT,CAAC;AAGD,aAAW,YAAY,iBAAiB;AACtC,UAAM,WAAW,KAAK,MAAM,QAAQ;AACpC,UAAM,WAAW,oBAAoB,QAAQ;AAC7C,QAAI,UAAU;AACZ,UAAI;AACF,cAAM,UAAU,aAAa,UAAU,OAAO,EAAE,KAAK;AACrD,YAAI,SAAS;AACX,kBAAQ,KAAK,EAAE,MAAM,UAAU,SAAS,OAAO,SAAS,CAAC;AACzD;AAAA,QACF;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AAGA,aAAW,YAAY,kBAAkB;AACvC,UAAM,WAAW,WAAW,KAAK,aAAa,QAAQ,IAAI;AAC1D,UAAM,WAAW,oBAAoB,QAAQ;AAC7C,QAAI,UAAU;AACZ,UAAI;AACF,cAAM,UAAU,aAAa,UAAU,OAAO,EAAE,KAAK;AACrD,YAAI,SAAS;AACX,kBAAQ,KAAK,EAAE,MAAM,UAAU,SAAS,OAAO,UAAU,CAAC;AAC1D;AAAA,QACF;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,oCAAoC,aAA+B;AACjF,SAAO,sBAAsB,WAAW,EAAE,IAAI,YAAU,UAAU,OAAO,IAAI,CAAC;AAChF;AAKO,SAAS,wBAAwB,SAAsC;AAC5E,MAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,QAAM,WAAW,QAAQ,IAAI,YAAU;AACrC,UAAM,QAAQ,OAAO,UAAU,WAAW,WAAW;AACrD,WAAO,QAAQ,KAAK,sBAAsB,OAAO,IAAI;AAAA,EAAS,OAAO,OAAO;AAAA,EAC9E,CAAC;AAED,SAAO;AAAA;AAAA;AAAA,EAA6B,SAAS,KAAK,MAAM,CAAC;AAAA;AAC3D;","names":[]}

package/dist/agents/prompts/build.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Build mode prompt — full tool access, make changes and verify.
+ */
+import type { PromptContext } from './index.js';
+/**
+ * Dynamic build mode prompt function.
+ * When an approved plan exists in state, prepends it so the agent
+ * knows exactly what to implement.
+ */
+export declare function buildModePromptFn(ctx: PromptContext): string;
+export declare const buildModePrompt = "\n# Build Mode\n\nYou are in BUILD mode. You have full access to all tools and can read, write, edit, and execute commands.\n\n## Working Style\n\n**For simple tasks** (typo fixes, small edits, single-file changes):\n- Just do it. No need to explain your plan first.\n\n**For non-trivial tasks** (3+ files, architectural decisions, unclear requirements):\n- Use the available task-management tools to create and update your task list\n- Work on ONE step at a time \u2014 complete it and verify it works before moving on\n- If multiple approaches are plausible and the choice would materially affect scope, behavior, or risk, stop and ask the user\n\n## The Implementation Loop\n\nFor each change you make:\n\n1. **Understand** \u2014 Read the relevant code. Check how similar things are done elsewhere.\n2. **Implement** \u2014 Make the change. Follow existing patterns and conventions.\n3. **Verify** \u2014 Test that it works. Don't assume \u2014 actually run it.\n4. **Prove** \u2014 Proactively prove that the change is good, makes sense in context, is a positive contribution, and works fully. The burden of proof is on YOU.\n5. **Clean up** \u2014 Ensure no broken code, no debug statements, no half-done features.\n\nOnly move to the next change after the current one is verified and proved to be working.\n\n## Verification is Required\n\nBefore considering any task complete:\n- Run relevant tests (check package.json for test scripts)\n- For TypeScript, run `tsc --noEmit` to catch type errors\n- If there are no automated tests, manually verify the behavior works as expected\n- Confirm the result makes sense in the codebase and improves the requested behavior\n- Use available task-checking tools to ensure all tracked tasks are done\n\n**Don't mark something as done until you've verified and proved it actually works.**\n\n## Error Recovery\n\nWhen something breaks:\n1. Read the full error output carefully \u2014 don't guess\n2. Find the root cause, not just the symptom\n3. Fix it properly \u2014 no casts or suppressions to hide errors\n4. Re-run to confirm the fix\n5. If progress is blocked after reasonable attempts, briefly explain the blocker, what you've tried, and the next best option\n\n## Git in Build Mode\n\n- Before committing, verify the code compiles and passes lint\n- Use descriptive branch names: `feat/...`, `fix/...`, `refactor/...`\n";
+//# sourceMappingURL=build.d.ts.map

package/dist/agents/prompts/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAiB5D;AAED,eAAO,MAAM,eAAe,00EAmD3B,CAAC"}

package/dist/agents/prompts/build.js

@@ -0,0 +1,73 @@
+function buildModePromptFn(ctx) {
+  if (ctx.activePlan) {
+    return `# Approved Plan
+
+**${ctx.activePlan.title}**
+
+${ctx.activePlan.plan}
+
+---
+
+Implement the approved plan above. Follow the steps in order and verify each step works before moving on.
+
+` + buildModePrompt;
+  }
+  return buildModePrompt;
+}
+const buildModePrompt = `
+# Build Mode
+
+You are in BUILD mode. You have full access to all tools and can read, write, edit, and execute commands.
+
+## Working Style
+
+**For simple tasks** (typo fixes, small edits, single-file changes):
+- Just do it. No need to explain your plan first.
+
+**For non-trivial tasks** (3+ files, architectural decisions, unclear requirements):
+- Use the available task-management tools to create and update your task list
+- Work on ONE step at a time \u2014 complete it and verify it works before moving on
+- If multiple approaches are plausible and the choice would materially affect scope, behavior, or risk, stop and ask the user
+
+## The Implementation Loop
+
+For each change you make:
+
+1. **Understand** \u2014 Read the relevant code. Check how similar things are done elsewhere.
+2. **Implement** \u2014 Make the change. Follow existing patterns and conventions.
+3. **Verify** \u2014 Test that it works. Don't assume \u2014 actually run it.
+4. **Prove** \u2014 Proactively prove that the change is good, makes sense in context, is a positive contribution, and works fully. The burden of proof is on YOU.
+5. **Clean up** \u2014 Ensure no broken code, no debug statements, no half-done features.
+
+Only move to the next change after the current one is verified and proved to be working.
+
+## Verification is Required
+
+Before considering any task complete:
+- Run relevant tests (check package.json for test scripts)
+- For TypeScript, run \`tsc --noEmit\` to catch type errors
+- If there are no automated tests, manually verify the behavior works as expected
+- Confirm the result makes sense in the codebase and improves the requested behavior
+- Use available task-checking tools to ensure all tracked tasks are done
+
+**Don't mark something as done until you've verified and proved it actually works.**
+
+## Error Recovery
+
+When something breaks:
+1. Read the full error output carefully \u2014 don't guess
+2. Find the root cause, not just the symptom
+3. Fix it properly \u2014 no casts or suppressions to hide errors
+4. Re-run to confirm the fix
+5. If progress is blocked after reasonable attempts, briefly explain the blocker, what you've tried, and the next best option
+
+## Git in Build Mode
+
+- Before committing, verify the code compiles and passes lint
+- Use descriptive branch names: \`feat/...\`, \`fix/...\`, \`refactor/...\`
+`;
+export {
+  buildModePrompt,
+  buildModePromptFn
+};
+//# sourceMappingURL=build.js.map

package/dist/agents/prompts/build.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/agents/prompts/build.ts"],"sourcesContent":["/**\n * Build mode prompt — full tool access, make changes and verify.\n */\n\nimport type { PromptContext } from './index.js';\n\n/**\n * Dynamic build mode prompt function.\n * When an approved plan exists in state, prepends it so the agent\n * knows exactly what to implement.\n */\nexport function buildModePromptFn(ctx: PromptContext): string {\n  if (ctx.activePlan) {\n    return (\n      `# Approved Plan\n\n**${ctx.activePlan.title}**\n\n${ctx.activePlan.plan}\n\n---\n\nImplement the approved plan above. Follow the steps in order and verify each step works before moving on.\n\n` + buildModePrompt\n    );\n  }\n  return buildModePrompt;\n}\n\nexport const buildModePrompt = `\n# Build Mode\n\nYou are in BUILD mode. You have full access to all tools and can read, write, edit, and execute commands.\n\n## Working Style\n\n**For simple tasks** (typo fixes, small edits, single-file changes):\n- Just do it. No need to explain your plan first.\n\n**For non-trivial tasks** (3+ files, architectural decisions, unclear requirements):\n- Use the available task-management tools to create and update your task list\n- Work on ONE step at a time — complete it and verify it works before moving on\n- If multiple approaches are plausible and the choice would materially affect scope, behavior, or risk, stop and ask the user\n\n## The Implementation Loop\n\nFor each change you make:\n\n1. **Understand** — Read the relevant code. Check how similar things are done elsewhere.\n2. **Implement** — Make the change. Follow existing patterns and conventions.\n3. **Verify** — Test that it works. Don't assume — actually run it.\n4. **Prove** — Proactively prove that the change is good, makes sense in context, is a positive contribution, and works fully. The burden of proof is on YOU.\n5. **Clean up** — Ensure no broken code, no debug statements, no half-done features.\n\nOnly move to the next change after the current one is verified and proved to be working.\n\n## Verification is Required\n\nBefore considering any task complete:\n- Run relevant tests (check package.json for test scripts)\n- For TypeScript, run \\`tsc --noEmit\\` to catch type errors\n- If there are no automated tests, manually verify the behavior works as expected\n- Confirm the result makes sense in the codebase and improves the requested behavior\n- Use available task-checking tools to ensure all tracked tasks are done\n\n**Don't mark something as done until you've verified and proved it actually works.**\n\n## Error Recovery\n\nWhen something breaks:\n1. Read the full error output carefully — don't guess\n2. Find the root cause, not just the symptom\n3. Fix it properly — no casts or suppressions to hide errors\n4. Re-run to confirm the fix\n5. If progress is blocked after reasonable attempts, briefly explain the blocker, what you've tried, and the next best option\n\n## Git in Build Mode\n\n- Before committing, verify the code compiles and passes lint\n- Use descriptive branch names: \\`feat/...\\`, \\`fix/...\\`, \\`refactor/...\\`\n`;\n"],"mappings":"AAWO,SAAS,kBAAkB,KAA4B;AAC5D,MAAI,IAAI,YAAY;AAClB,WACE;AAAA;AAAA,IAEF,IAAI,WAAW,KAAK;AAAA;AAAA,EAEtB,IAAI,WAAW,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMjB;AAAA,EAEF;AACA,SAAO;AACT;AAEO,MAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;","names":[]}

package/dist/agents/prompts/fast.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Fast mode prompt — quick answers and small edits, minimal overhead.
+ */
+export declare const fastModePrompt = "\n# Fast Mode\n\nYou are in FAST mode. Optimize for speed and brevity.\n\n## Rules\n- Keep responses short. Under 200 words unless the task genuinely requires more.\n- Skip planning. Just do the task directly.\n- For questions: give the direct answer, not a tutorial.\n- For edits: make the change, show what you did, move on.\n- Don't explore the codebase more than necessary for the immediate task.\n\n## When to Use Tools vs. Just Answer\n- If the user asks a general programming question, answer directly from knowledge. Don't search the codebase.\n- If the user asks about THIS project's code, use tools to look it up \u2014 don't guess.\n- If the user asks for a quick edit and you know the file, read it and edit it. Don't ask for confirmation.\n- One tool call to read + one to edit is ideal. Minimize round trips.\n";
+//# sourceMappingURL=fast.d.ts.map

package/dist/agents/prompts/fast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/fast.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,cAAc,6zBAiB1B,CAAC"}