@mastra/code-sdk 1.5.0-alpha.11 → 1.5.0-alpha.3

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","names":[],"sources":["../src/schema.ts"],"sourcesContent":["import { z } from 'zod';\nimport { DEFAULT_CONFIG_DIR, DEFAULT_OM_MODEL_ID } from './constants.js';\nimport { THINKING_LEVEL_VALUES } from './thinking.js';\nimport type { ThinkingLevelSetting } from './thinking.js';\n\nexport type PermissionPolicy = 'allow' | 'ask' | 'deny';\n\nexport type MastraCodeSessionState = {\n  currentModelId: string;\n  modeId: string;\n};\n\nexport type MastraCodeComposedState = MastraCodeState & MastraCodeSessionState;\n\nexport interface MastraCodeState {\n  [key: string]: unknown;\n  [key: `subagentModelId_${string}`]: string | undefined;\n  subagentModelId?: string;\n  projectPath?: string;\n  projectName?: string;\n  /** Factory project that owns this session. */\n  factoryProjectId?: string;\n  /** Authoritative organization id seeded by factory at session construction. */\n  factoryOrgId?: string;\n  /** Linked repository used by this session when source-control execution is required. */\n  projectRepositoryId?: string;\n  /** Persisted sandbox id for reattaching the project's cloud workspace. */\n  sandboxId?: string;\n  /** Path inside the sandbox the repo is cloned into. */\n  sandboxWorkdir?: string;\n  /** Active git worktree path inside the sandbox for the current unit of work. */\n  worktreePath?: string;\n  /** Active feature branch checked out in the worktree. */\n  branch?: string;\n  /**\n   * The session's checkout contains third-party content (e.g. a PR branch\n   * under review). Project-level instruction files (AGENTS.md, CLAUDE.md)\n   * are attacker-writable there and must not be ingested into the system\n   * prompt or injected as reminders.\n   */\n  untrustedCheckout?: boolean;\n  /**\n   * Trusted git ref (typically the PR's base branch) to serve project\n   * instruction files from when the checkout is untrusted. Without it,\n   * project-scope instruction files are skipped entirely.\n   */\n  baseRef?: string;\n  /**\n   * Skip the home-directory instruction files (~/.claude/AGENTS.md and\n   * friends). Hosts running sessions for someone else set this so a run never\n   * inherits the machine owner's personal configuration.\n   */\n  skipGlobalInstructions?: boolean;\n  configDir: string;\n  homeDir?: string;\n  gitBranch?: string;\n  lastCommand?: string;\n  observerModelId: string;\n  reflectorModelId: string;\n  observationThreshold: number;\n  reflectionThreshold: number;\n  cavemanObservations: boolean;\n  observeAttachments: 'auto' | boolean;\n  omScope?: 'thread' | 'resource';\n  /**\n   * Session-level reasoning-effort override. When unset, the effective level is\n   * resolved at request time from settings (`models.modeThinkingDefaults[mode]`\n   * falling back to `preferences.thinkingLevel`).\n   */\n  thinkingLevel?: ThinkingLevelSetting;\n  yolo: boolean;\n  permissionRules: {\n    categories: Record<string, PermissionPolicy>;\n    tools: Record<string, PermissionPolicy>;\n  };\n  smartEditing: boolean;\n  notifications: 'bell' | 'system' | 'both' | 'off';\n  tasks: Array<{\n    id?: string;\n    content: string;\n    status: 'pending' | 'in_progress' | 'completed';\n    activeForm: string;\n  }>;\n  sandboxAllowedPaths: string[];\n  pluginSkillPaths: string[];\n  pluginCommandPaths: string[];\n  pluginInstructions: string[];\n  activePlan: {\n    title: string;\n    plan: string;\n    approvedAt: string;\n  } | null;\n  activeBrowserSettings?: {\n    enabled: boolean;\n    provider: 'stagehand' | 'agent-browser';\n    headless?: boolean;\n    viewport?: { width: number; height: number } | 'window';\n    cdpUrl?: string;\n    stagehand?: {\n      env: 'LOCAL' | 'BROWSERBASE';\n      apiKey?: string;\n      projectId?: string;\n    };\n  };\n}\n\nexport const stateSchema = z.object({\n  // Session-scoped selection.\n  // validates state against this schema, so they MUST be declared here — Zod\n  // strips unknown keys on parse, which would otherwise silently discard the\n  // seeded model and leave the controller with no model selected.\n  currentModelId: z.string().optional(),\n  modeId: z.string().optional(),\n  subagentModelId: z.string().optional(),\n  projectPath: z.string().optional(),\n  projectName: z.string().optional(),\n  factoryProjectId: z.string().optional(),\n  factoryOrgId: z.string().optional(),\n  projectRepositoryId: z.string().optional(),\n  sandboxId: z.string().optional(),\n  sandboxWorkdir: z.string().optional(),\n  worktreePath: z.string().optional(),\n  branch: z.string().optional(),\n  // Session operates on an untrusted checkout — suppress AGENTS.md ingestion.\n  untrustedCheckout: z.boolean().optional(),\n  // Trusted ref to serve instruction files from on untrusted checkouts.\n  baseRef: z.string().optional(),\n  // Skip the operator machine's home-directory instruction files.\n  skipGlobalInstructions: z.boolean().optional(),\n  configDir: z.string().default(DEFAULT_CONFIG_DIR),\n  homeDir: z.string().optional(),\n  gitBranch: z.string().optional(),\n  lastCommand: z.string().optional(),\n  // Observational Memory model settings\n  observerModelId: z.string().default(DEFAULT_OM_MODEL_ID),\n  reflectorModelId: z.string().default(DEFAULT_OM_MODEL_ID),\n  // Observational Memory threshold settings\n  observationThreshold: z.number().default(30_000),\n  reflectionThreshold: z.number().default(40_000),\n  // Whether observations and reflections use the terse caveman-style instruction.\n  // Off by default — caveman style is opt-in via `/om` settings; observers and\n  // reflectors fall back to their built-in (prose) behavior unless enabled.\n  cavemanObservations: z.boolean().default(false),\n  // Whether OM forwards image/file attachment parts to the Observer LLM.\n  // 'auto' (default) checks the provider capabilities registry to decide.\n  // true/false forces the setting regardless of model capabilities.\n  observeAttachments: z.union([z.literal('auto'), z.boolean()]).default('auto'),\n  // Observational Memory scope — 'thread' (per-conversation) or 'resource' (shared across threads)\n  omScope: z.enum(['thread', 'resource']).optional(),\n  // Thinking level for model reasoning effort. Optional: absent means \"no\n  // session override\" — the effective level is resolved from settings\n  // (per-mode defaults, then the global preference) at request time.\n  thinkingLevel: z.preprocess(value => (value === null ? undefined : value), z.enum(THINKING_LEVEL_VALUES).optional()),\n  // YOLO mode — auto-approve all tool calls\n  yolo: z.boolean().default(false),\n  // Permission rules — per-category and per-tool approval policies\n  permissionRules: z\n    .object({\n      categories: z.record(z.string(), z.enum(['allow', 'ask', 'deny'])).default({}),\n      tools: z.record(z.string(), z.enum(['allow', 'ask', 'deny'])).default({}),\n    })\n    .default({ categories: {}, tools: {} }),\n  // Smart editing mode — use AST-based analysis for code edits\n  smartEditing: z.boolean().default(true),\n  // Notification mode — alert when TUI needs user attention\n  notifications: z.enum(['bell', 'system', 'both', 'off']).default('off'),\n  // Task list (ephemeral per-thread, cleared on thread switch/creation)\n  tasks: z\n    .array(\n      z.object({\n        id: z.string().optional(),\n        content: z.string(),\n        status: z.enum(['pending', 'in_progress', 'completed']),\n        activeForm: z.string(),\n      }),\n    )\n    .default([]),\n  // Sandbox allowed paths (per-thread, absolute paths allowed in addition to project root)\n  sandboxAllowedPaths: z.array(z.string()).default([]),\n  // Asset directories contributed by active plugins.\n  pluginSkillPaths: z.array(z.string()).default([]),\n  pluginCommandPaths: z.array(z.string()).default([]),\n  pluginInstructions: z.array(z.string()).default([]),\n  // Active plan (set when a plan is approved in Plan mode)\n  activePlan: z\n    .object({\n      title: z.string(),\n      plan: z.string(),\n      approvedAt: z.string(),\n    })\n    .nullable()\n    .default(null),\n  // Active browser settings (tracks what's actually running vs. what's in the settings file)\n  activeBrowserSettings: z\n    .object({\n      enabled: z.boolean(),\n      provider: z.enum(['stagehand', 'agent-browser']),\n      headless: z.boolean().optional(),\n      viewport: z\n        .union([\n          z.object({\n            width: z.number(),\n            height: z.number(),\n          }),\n          z.literal('window'),\n        ])\n        .optional(),\n      cdpUrl: z.string().optional(),\n      stagehand: z\n        .object({\n          env: z.enum(['LOCAL', 'BROWSERBASE']),\n          apiKey: z.string().optional(),\n          projectId: z.string().optional(),\n        })\n        .optional(),\n    })\n    .optional(),\n});\n"],"mappings":"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"}
+{"version":3,"file":"schema.js","names":[],"sources":["../src/schema.ts"],"sourcesContent":["import { z } from 'zod';\nimport { DEFAULT_CONFIG_DIR, DEFAULT_OM_MODEL_ID } from './constants.js';\n\nexport type PermissionPolicy = 'allow' | 'ask' | 'deny';\n\nexport type MastraCodeSessionState = {\n  currentModelId: string;\n  modeId: string;\n};\n\nexport type MastraCodeComposedState = MastraCodeState & MastraCodeSessionState;\n\nexport interface MastraCodeState {\n  [key: string]: unknown;\n  [key: `subagentModelId_${string}`]: string | undefined;\n  subagentModelId?: string;\n  projectPath?: string;\n  projectName?: string;\n  /** Factory project that owns this session. */\n  factoryProjectId?: string;\n  /** Authoritative organization id seeded by factory at session construction. */\n  factoryOrgId?: string;\n  /** Linked repository used by this session when source-control execution is required. */\n  projectRepositoryId?: string;\n  /** Persisted sandbox id for reattaching the project's cloud workspace. */\n  sandboxId?: string;\n  /** Path inside the sandbox the repo is cloned into. */\n  sandboxWorkdir?: string;\n  /** Active git worktree path inside the sandbox for the current unit of work. */\n  worktreePath?: string;\n  /** Active feature branch checked out in the worktree. */\n  branch?: string;\n  /**\n   * The session's checkout contains third-party content (e.g. a PR branch\n   * under review). Project-level instruction files (AGENTS.md, CLAUDE.md)\n   * are attacker-writable there and must not be ingested into the system\n   * prompt or injected as reminders.\n   */\n  untrustedCheckout?: boolean;\n  /**\n   * Trusted git ref (typically the PR's base branch) to serve project\n   * instruction files from when the checkout is untrusted. Without it,\n   * project-scope instruction files are skipped entirely.\n   */\n  baseRef?: string;\n  /**\n   * Skip the home-directory instruction files (~/.claude/AGENTS.md and\n   * friends). Hosts running sessions for someone else set this so a run never\n   * inherits the machine owner's personal configuration.\n   */\n  skipGlobalInstructions?: boolean;\n  configDir: string;\n  homeDir?: string;\n  gitBranch?: string;\n  lastCommand?: string;\n  observerModelId: string;\n  reflectorModelId: string;\n  observationThreshold: number;\n  reflectionThreshold: number;\n  cavemanObservations: boolean;\n  observeAttachments: 'auto' | boolean;\n  omScope?: 'thread' | 'resource';\n  /**\n   * Session-level reasoning-effort override. When unset, the effective level is\n   * resolved at request time from settings (`models.modeThinkingDefaults[mode]`\n   * falling back to `preferences.thinkingLevel`).\n   */\n  thinkingLevel?: 'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';\n  yolo: boolean;\n  permissionRules: {\n    categories: Record<string, PermissionPolicy>;\n    tools: Record<string, PermissionPolicy>;\n  };\n  smartEditing: boolean;\n  notifications: 'bell' | 'system' | 'both' | 'off';\n  tasks: Array<{\n    id?: string;\n    content: string;\n    status: 'pending' | 'in_progress' | 'completed';\n    activeForm: string;\n  }>;\n  sandboxAllowedPaths: string[];\n  pluginSkillPaths: string[];\n  pluginCommandPaths: string[];\n  pluginInstructions: string[];\n  activePlan: {\n    title: string;\n    plan: string;\n    approvedAt: string;\n  } | null;\n  activeBrowserSettings?: {\n    enabled: boolean;\n    provider: 'stagehand' | 'agent-browser';\n    headless?: boolean;\n    viewport?: { width: number; height: number } | 'window';\n    cdpUrl?: string;\n    stagehand?: {\n      env: 'LOCAL' | 'BROWSERBASE';\n      apiKey?: string;\n      projectId?: string;\n    };\n  };\n}\n\nexport const stateSchema = z.object({\n  // Session-scoped selection.\n  // validates state against this schema, so they MUST be declared here — Zod\n  // strips unknown keys on parse, which would otherwise silently discard the\n  // seeded model and leave the controller with no model selected.\n  currentModelId: z.string().optional(),\n  modeId: z.string().optional(),\n  subagentModelId: z.string().optional(),\n  projectPath: z.string().optional(),\n  projectName: z.string().optional(),\n  factoryProjectId: z.string().optional(),\n  factoryOrgId: z.string().optional(),\n  projectRepositoryId: z.string().optional(),\n  sandboxId: z.string().optional(),\n  sandboxWorkdir: z.string().optional(),\n  worktreePath: z.string().optional(),\n  branch: z.string().optional(),\n  // Session operates on an untrusted checkout — suppress AGENTS.md ingestion.\n  untrustedCheckout: z.boolean().optional(),\n  // Trusted ref to serve instruction files from on untrusted checkouts.\n  baseRef: z.string().optional(),\n  // Skip the operator machine's home-directory instruction files.\n  skipGlobalInstructions: z.boolean().optional(),\n  configDir: z.string().default(DEFAULT_CONFIG_DIR),\n  homeDir: z.string().optional(),\n  gitBranch: z.string().optional(),\n  lastCommand: z.string().optional(),\n  // Observational Memory model settings\n  observerModelId: z.string().default(DEFAULT_OM_MODEL_ID),\n  reflectorModelId: z.string().default(DEFAULT_OM_MODEL_ID),\n  // Observational Memory threshold settings\n  observationThreshold: z.number().default(30_000),\n  reflectionThreshold: z.number().default(40_000),\n  // Whether observations and reflections use the terse caveman-style instruction.\n  // Off by default — caveman style is opt-in via `/om` settings; observers and\n  // reflectors fall back to their built-in (prose) behavior unless enabled.\n  cavemanObservations: z.boolean().default(false),\n  // Whether OM forwards image/file attachment parts to the Observer LLM.\n  // 'auto' (default) checks the provider capabilities registry to decide.\n  // true/false forces the setting regardless of model capabilities.\n  observeAttachments: z.union([z.literal('auto'), z.boolean()]).default('auto'),\n  // Observational Memory scope — 'thread' (per-conversation) or 'resource' (shared across threads)\n  omScope: z.enum(['thread', 'resource']).optional(),\n  // Thinking level for model reasoning effort. Optional: absent means \"no\n  // session override\" — the effective level is resolved from settings\n  // (per-mode defaults, then the global preference) at request time.\n  thinkingLevel: z.enum(['off', 'low', 'medium', 'high', 'xhigh', 'max']).optional(),\n  // YOLO mode — auto-approve all tool calls\n  yolo: z.boolean().default(false),\n  // Permission rules — per-category and per-tool approval policies\n  permissionRules: z\n    .object({\n      categories: z.record(z.string(), z.enum(['allow', 'ask', 'deny'])).default({}),\n      tools: z.record(z.string(), z.enum(['allow', 'ask', 'deny'])).default({}),\n    })\n    .default({ categories: {}, tools: {} }),\n  // Smart editing mode — use AST-based analysis for code edits\n  smartEditing: z.boolean().default(true),\n  // Notification mode — alert when TUI needs user attention\n  notifications: z.enum(['bell', 'system', 'both', 'off']).default('off'),\n  // Task list (ephemeral per-thread, cleared on thread switch/creation)\n  tasks: z\n    .array(\n      z.object({\n        id: z.string().optional(),\n        content: z.string(),\n        status: z.enum(['pending', 'in_progress', 'completed']),\n        activeForm: z.string(),\n      }),\n    )\n    .default([]),\n  // Sandbox allowed paths (per-thread, absolute paths allowed in addition to project root)\n  sandboxAllowedPaths: z.array(z.string()).default([]),\n  // Asset directories contributed by active plugins.\n  pluginSkillPaths: z.array(z.string()).default([]),\n  pluginCommandPaths: z.array(z.string()).default([]),\n  pluginInstructions: z.array(z.string()).default([]),\n  // Active plan (set when a plan is approved in Plan mode)\n  activePlan: z\n    .object({\n      title: z.string(),\n      plan: z.string(),\n      approvedAt: z.string(),\n    })\n    .nullable()\n    .default(null),\n  // Active browser settings (tracks what's actually running vs. what's in the settings file)\n  activeBrowserSettings: z\n    .object({\n      enabled: z.boolean(),\n      provider: z.enum(['stagehand', 'agent-browser']),\n      headless: z.boolean().optional(),\n      viewport: z\n        .union([\n          z.object({\n            width: z.number(),\n            height: z.number(),\n          }),\n          z.literal('window'),\n        ])\n        .optional(),\n      cdpUrl: z.string().optional(),\n      stagehand: z\n        .object({\n          env: z.enum(['LOCAL', 'BROWSERBASE']),\n          apiKey: z.string().optional(),\n          projectId: z.string().optional(),\n        })\n        .optional(),\n    })\n    .optional(),\n});\n"],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Tool exports for Mastra Code
  */
-export { createConfiguredWebTools, createParallelWebExtractTool, createParallelWebSearchTool, createWebExtractTool, createWebSearchTool, hasParallelKey, hasTavilyKey, resolveWebSearchProvider, } from './web-search.js';
+export { createWebSearchTool, createWebExtractTool, hasTavilyKey } from './web-search.js';
 export { requestSandboxAccessTool } from './request-sandbox-access.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/tools/index.js

@@ -1,3 +1,3 @@
-import { createConfiguredWebTools, createParallelWebExtractTool, createParallelWebSearchTool, createWebExtractTool, createWebSearchTool, hasParallelKey, hasTavilyKey, resolveWebSearchProvider } from "./web-search.js";
+import { createWebExtractTool, createWebSearchTool, hasTavilyKey } from "./web-search.js";
 import { requestSandboxAccessTool } from "./request-sandbox-access.js";
-export { createConfiguredWebTools, createParallelWebExtractTool, createParallelWebSearchTool, createWebExtractTool, createWebSearchTool, hasParallelKey, hasTavilyKey, requestSandboxAccessTool, resolveWebSearchProvider };
+export { createWebExtractTool, createWebSearchTool, hasTavilyKey, requestSandboxAccessTool };

package/dist/tools/web-search.d.ts

@@ -1,12 +1,9 @@
-import { type WebSearchProviderSetting } from '../onboarding/settings.js';
 /**
  * Check whether a Tavily API key is available in the environment.
- * Used to select model-independent web tools before falling back to
- * model-native web search.
+ * Used by main.ts to decide whether to include Tavily tools or fall back
+ * to Anthropic's native web search.
  */
 export declare function hasTavilyKey(): boolean;
-/** Check whether a Parallel API key is available in the environment. */
-export declare function hasParallelKey(): boolean;
 /**
  * Wraps the @mastra/tavily search tool with mastracode-specific behavior:
  * relevance filtering, markdown string formatting, and token truncation.
@@ -35,80 +32,4 @@ export declare function createWebExtractTool(): import("@mastra/core/tools").Too
     includeImages?: boolean | undefined;
     format?: "markdown" | "text" | undefined;
 }, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-extract", unknown>;
-/**
- * Wraps the @mastra/parallel search tool with Mastra Code's standard tool id,
- * markdown string output, and token truncation.
- */
-export declare function createParallelWebSearchTool(): import("@mastra/core/tools").Tool<{
-    query: string;
-}, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-search", unknown>;
-/**
- * Wraps the @mastra/parallel extract tool with Mastra Code's standard tool id,
- * markdown string output, and token truncation.
- */
-export declare function createParallelWebExtractTool(): import("@mastra/core/tools").Tool<{
-    urls: string[];
-    objective?: string | undefined;
-    searchQueries?: string[] | undefined;
-    excerptMaxCharsPerResult?: number | undefined;
-    clientModel?: string | undefined;
-    fullContent?: number | boolean | undefined;
-    maxCharsTotal?: number | undefined;
-    fetchPolicy?: {
-        maxAgeSeconds?: number | undefined;
-        timeoutSeconds?: number | undefined;
-        disableCacheFallback?: boolean | undefined;
-    } | undefined;
-    sessionId?: string | undefined;
-}, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-extract", unknown>;
-/**
- * Resolve which model-independent web provider to use. An explicit user
- * preference wins while its API key is configured; otherwise `auto` picks the
- * first configured provider key (Tavily, then Parallel).
- */
-export declare function resolveWebSearchProvider(preference?: WebSearchProviderSetting): 'tavily' | 'parallel' | undefined;
-/**
- * Create the configured model-independent web tools for the provider selected
- * via the `webSearchProvider` preference (set in the TUI settings panel).
- */
-export declare function createConfiguredWebTools(): {
-    web_search: import("@mastra/core/tools").Tool<{
-        query: string;
-    }, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-search", unknown>;
-    web_extract: import("@mastra/core/tools").Tool<{
-        urls: string[];
-        objective?: string | undefined;
-        searchQueries?: string[] | undefined;
-        excerptMaxCharsPerResult?: number | undefined;
-        clientModel?: string | undefined;
-        fullContent?: number | boolean | undefined;
-        maxCharsTotal?: number | undefined;
-        fetchPolicy?: {
-            maxAgeSeconds?: number | undefined;
-            timeoutSeconds?: number | undefined;
-            disableCacheFallback?: boolean | undefined;
-        } | undefined;
-        sessionId?: string | undefined;
-    }, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-extract", unknown>;
-} | {
-    web_search: import("@mastra/core/tools").Tool<{
-        query: string;
-        searchDepth?: "basic" | "advanced" | "fast" | "ultra-fast" | undefined;
-        maxResults?: number | undefined;
-        includeAnswer?: boolean | "basic" | "advanced" | undefined;
-        includeImages?: boolean | undefined;
-        includeImageDescriptions?: boolean | undefined;
-        includeRawContent?: false | "markdown" | "text" | undefined;
-        includeDomains?: string[] | undefined;
-        excludeDomains?: string[] | undefined;
-        timeRange?: "day" | "week" | "month" | "year" | undefined;
-    }, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-search", unknown>;
-    web_extract: import("@mastra/core/tools").Tool<{
-        urls: string[];
-        extractDepth?: "basic" | "advanced" | undefined;
-        query?: string | undefined;
-        includeImages?: boolean | undefined;
-        format?: "markdown" | "text" | undefined;
-    }, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-extract", unknown>;
-} | undefined;
 //# sourceMappingURL=web-search.d.ts.map

package/dist/tools/web-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,KAAK,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAwBxF;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wEAAwE;AACxE,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB;;;;;;;;;;;mIA8BlC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB;;;;;;oIAwBnC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B;;mIAuB1C;AAED;;;GAGG;AACH,wBAAgB,4BAA4B;;;;;;;;;qBAtI1C,CAAC;sBAEK,CAAC;4BAEe,CAAC;;;oIA0JxB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,GAAE,wBAAiC,GAC5C,QAAQ,GAAG,UAAU,GAAG,SAAS,CAQnC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB;;;;;;;;;;;;;yBArLtC,CAAC;0BAEK,CAAC;gCAEe,CAAC;;;;;;;;;;;;;;;;;;;;;;;;cAmMxB"}
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB;;;;;;;;;;;mIA8BlC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB;;;;;;oIAwBnC"}

package/dist/tools/web-search.js

@@ -1,31 +1,18 @@
-import { loadSettings } from "../onboarding/settings.js";
 import { truncateStringForTokenEstimate } from "../utils/token-estimator.js";
-import { createTool, isValidationError } from "@mastra/core/tools";
-import { createParallelExtractTool, createParallelSearchTool } from "@mastra/parallel";
+import { createTool } from "@mastra/core/tools";
 import { createTavilyExtractTool, createTavilySearchTool } from "@mastra/tavily";
-import { z } from "zod";
 //#region src/tools/web-search.ts
 const MAX_WEB_SEARCH_TOKENS = 2e3;
 const MAX_WEB_EXTRACT_TOKENS = 2e3;
 const MIN_RELEVANCE_SCORE = .25;
-const parallelWebSearchInputSchema = z.object({ query: z.string().min(1).describe("The search query") });
-function requireParallelOutput(output, operation) {
-	if (output === void 0) throw new Error(`Parallel ${operation} returned no output`);
-	if (isValidationError(output)) throw new Error(output.message);
-	return output;
-}
 /**
 * Check whether a Tavily API key is available in the environment.
-* Used to select model-independent web tools before falling back to
-* model-native web search.
+* Used by main.ts to decide whether to include Tavily tools or fall back
+* to Anthropic's native web search.
 */
 function hasTavilyKey() {
 	return !!process.env.TAVILY_API_KEY;
 }
-/** Check whether a Parallel API key is available in the environment. */
-function hasParallelKey() {
-	return !!process.env.PARALLEL_API_KEY;
-}
 /**
 * Wraps the @mastra/tavily search tool with mastracode-specific behavior:
 * relevance filtering, markdown string formatting, and token truncation.
@@ -68,88 +55,7 @@ function createWebExtractTool() {
 		}
 	});
 }
-/**
-* Wraps the @mastra/parallel search tool with Mastra Code's standard tool id,
-* markdown string output, and token truncation.
-*/
-function createParallelWebSearchTool() {
-	const parallelSearchTool = createParallelSearchTool();
-	return createTool({
-		id: "web-search",
-		description: parallelSearchTool.description,
-		inputSchema: parallelWebSearchInputSchema,
-		execute: async (input, context) => {
-			const output = requireParallelOutput(await parallelSearchTool.execute({ searchQueries: [input.query] }, context), "search");
-			const parts = [];
-			for (const result of output.results) {
-				const title = result.title || result.url;
-				const excerpts = (result.excerpts || []).filter(Boolean).join("\n");
-				parts.push([
-					`## ${title}`,
-					result.url,
-					excerpts
-				].filter(Boolean).join("\n"));
-			}
-			return truncateStringForTokenEstimate(parts.join("\n\n"), MAX_WEB_SEARCH_TOKENS);
-		}
-	});
-}
-/**
-* Wraps the @mastra/parallel extract tool with Mastra Code's standard tool id,
-* markdown string output, and token truncation.
-*/
-function createParallelWebExtractTool() {
-	const parallelExtractTool = createParallelExtractTool();
-	return createTool({
-		id: "web-extract",
-		description: parallelExtractTool.description,
-		inputSchema: parallelExtractTool.inputSchema,
-		execute: async (input, context) => {
-			const output = requireParallelOutput(await parallelExtractTool.execute(input, context), "extract");
-			const parts = [];
-			for (const result of output.results) {
-				const content = result.fullContent || (result.excerpts || []).filter(Boolean).join("\n");
-				parts.push([`## ${result.url}`, content].filter(Boolean).join("\n"));
-			}
-			for (const error of output.errors) {
-				const status = error.httpStatusCode ? ` (${error.httpStatusCode})` : "";
-				parts.push([
-					`## ${error.url}`,
-					`Error: ${error.errorType}${status}`,
-					error.content
-				].filter(Boolean).join("\n"));
-			}
-			return truncateStringForTokenEstimate(parts.join("\n\n"), MAX_WEB_EXTRACT_TOKENS);
-		}
-	});
-}
-/**
-* Resolve which model-independent web provider to use. An explicit user
-* preference wins while its API key is configured; otherwise `auto` picks the
-* first configured provider key (Tavily, then Parallel).
-*/
-function resolveWebSearchProvider(preference = "auto") {
-	if (preference === "tavily" && hasTavilyKey()) return "tavily";
-	if (preference === "parallel" && hasParallelKey()) return "parallel";
-	if (hasTavilyKey()) return "tavily";
-	if (hasParallelKey()) return "parallel";
-}
-/**
-* Create the configured model-independent web tools for the provider selected
-* via the `webSearchProvider` preference (set in the TUI settings panel).
-*/
-function createConfiguredWebTools() {
-	const provider = resolveWebSearchProvider(loadSettings().preferences.webSearchProvider);
-	if (provider === "parallel") return {
-		web_search: createParallelWebSearchTool(),
-		web_extract: createParallelWebExtractTool()
-	};
-	if (provider === "tavily") return {
-		web_search: createWebSearchTool(),
-		web_extract: createWebExtractTool()
-	};
-}
 //#endregion
-export { createConfiguredWebTools, createParallelWebExtractTool, createParallelWebSearchTool, createWebExtractTool, createWebSearchTool, hasParallelKey, hasTavilyKey, resolveWebSearchProvider };
+export { createWebExtractTool, createWebSearchTool, hasTavilyKey };
 
 //# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-search.js","names":[],"sources":["../../src/tools/web-search.ts"],"sourcesContent":["import { createTool, isValidationError, type ValidationError } from '@mastra/core/tools';\nimport { createParallelSearchTool, createParallelExtractTool } from '@mastra/parallel';\nimport { createTavilySearchTool, createTavilyExtractTool } from '@mastra/tavily';\nimport { z } from 'zod';\n\nimport { loadSettings, type WebSearchProviderSetting } from '../onboarding/settings.js';\nimport { truncateStringForTokenEstimate } from '../utils/token-estimator.js';\n\nconst MAX_WEB_SEARCH_TOKENS = 2_000;\nconst MAX_WEB_EXTRACT_TOKENS = 2_000;\n\nconst MIN_RELEVANCE_SCORE = 0.25;\n\nconst parallelWebSearchInputSchema = z.object({\n  query: z.string().min(1).describe('The search query'),\n});\n\nfunction requireParallelOutput<T>(output: T | ValidationError | void, operation: 'search' | 'extract'): T {\n  if (output === undefined) {\n    throw new Error(`Parallel ${operation} returned no output`);\n  }\n\n  if (isValidationError(output)) {\n    throw new Error(output.message);\n  }\n\n  return output;\n}\n\n/**\n * Check whether a Tavily API key is available in the environment.\n * Used to select model-independent web tools before falling back to\n * model-native web search.\n */\nexport function hasTavilyKey(): boolean {\n  return !!process.env.TAVILY_API_KEY;\n}\n\n/** Check whether a Parallel API key is available in the environment. */\nexport function hasParallelKey(): boolean {\n  return !!process.env.PARALLEL_API_KEY;\n}\n\n/**\n * Wraps the @mastra/tavily search tool with mastracode-specific behavior:\n * relevance filtering, markdown string formatting, and token truncation.\n * The underlying Tavily tool handles client init, input validation, and the API call.\n */\nexport function createWebSearchTool() {\n  const tavilySearchTool = createTavilySearchTool();\n\n  return createTool({\n    id: 'web-search',\n    description: tavilySearchTool.description!,\n    inputSchema: tavilySearchTool.inputSchema!,\n    execute: async (input, context) => {\n      const output: any = await tavilySearchTool.execute!(input as any, context as any);\n\n      const parts: string[] = [];\n\n      if (output.answer) {\n        parts.push(`Answer: ${output.answer}`);\n      }\n\n      const filtered = output.results.filter((r: any) => (r.score ?? 1) >= MIN_RELEVANCE_SCORE);\n      for (const r of filtered) {\n        parts.push(`## ${r.title}\\n${r.url}\\n${r.content}`);\n      }\n\n      const images = (output.images || []).map((img: any) => img.url).filter(Boolean);\n      if (images.length > 0) {\n        parts.push(`Images:\\n${images.join('\\n')}`);\n      }\n\n      const text = parts.join('\\n\\n');\n      return truncateStringForTokenEstimate(text, MAX_WEB_SEARCH_TOKENS);\n    },\n  });\n}\n\n/**\n * Wraps the @mastra/tavily extract tool with mastracode-specific behavior:\n * markdown string formatting and token truncation.\n */\nexport function createWebExtractTool() {\n  const tavilyExtractTool = createTavilyExtractTool();\n\n  return createTool({\n    id: 'web-extract',\n    description: tavilyExtractTool.description!,\n    inputSchema: tavilyExtractTool.inputSchema!,\n    execute: async (input, context) => {\n      const output: any = await tavilyExtractTool.execute!(input as any, context as any);\n\n      const parts: string[] = [];\n\n      for (const r of output.results) {\n        parts.push(`## ${r.url}\\n${r.rawContent}`);\n      }\n\n      for (const r of output.failedResults) {\n        parts.push(`## ${r.url}\\nError: ${r.error}`);\n      }\n\n      const text = parts.join('\\n\\n');\n      return truncateStringForTokenEstimate(text, MAX_WEB_EXTRACT_TOKENS);\n    },\n  });\n}\n\n/**\n * Wraps the @mastra/parallel search tool with Mastra Code's standard tool id,\n * markdown string output, and token truncation.\n */\nexport function createParallelWebSearchTool() {\n  const parallelSearchTool = createParallelSearchTool();\n\n  return createTool({\n    id: 'web-search',\n    description: parallelSearchTool.description!,\n    inputSchema: parallelWebSearchInputSchema,\n    execute: async (input, context) => {\n      const output = requireParallelOutput(\n        await parallelSearchTool.execute!({ searchQueries: [input.query] }, context),\n        'search',\n      );\n      const parts: string[] = [];\n\n      for (const result of output.results) {\n        const title = result.title || result.url;\n        const excerpts = (result.excerpts || []).filter(Boolean).join('\\n');\n        parts.push([`## ${title}`, result.url, excerpts].filter(Boolean).join('\\n'));\n      }\n\n      return truncateStringForTokenEstimate(parts.join('\\n\\n'), MAX_WEB_SEARCH_TOKENS);\n    },\n  });\n}\n\n/**\n * Wraps the @mastra/parallel extract tool with Mastra Code's standard tool id,\n * markdown string output, and token truncation.\n */\nexport function createParallelWebExtractTool() {\n  const parallelExtractTool = createParallelExtractTool();\n\n  return createTool({\n    id: 'web-extract',\n    description: parallelExtractTool.description!,\n    inputSchema: parallelExtractTool.inputSchema!,\n    execute: async (input, context) => {\n      const output = requireParallelOutput(await parallelExtractTool.execute!(input, context), 'extract');\n      const parts: string[] = [];\n\n      for (const result of output.results) {\n        const content = result.fullContent || (result.excerpts || []).filter(Boolean).join('\\n');\n        parts.push([`## ${result.url}`, content].filter(Boolean).join('\\n'));\n      }\n\n      for (const error of output.errors) {\n        const status = error.httpStatusCode ? ` (${error.httpStatusCode})` : '';\n        parts.push([`## ${error.url}`, `Error: ${error.errorType}${status}`, error.content].filter(Boolean).join('\\n'));\n      }\n\n      return truncateStringForTokenEstimate(parts.join('\\n\\n'), MAX_WEB_EXTRACT_TOKENS);\n    },\n  });\n}\n\n/**\n * Resolve which model-independent web provider to use. An explicit user\n * preference wins while its API key is configured; otherwise `auto` picks the\n * first configured provider key (Tavily, then Parallel).\n */\nexport function resolveWebSearchProvider(\n  preference: WebSearchProviderSetting = 'auto',\n): 'tavily' | 'parallel' | undefined {\n  if (preference === 'tavily' && hasTavilyKey()) return 'tavily';\n  if (preference === 'parallel' && hasParallelKey()) return 'parallel';\n\n  // `auto`, or an explicit choice whose key is no longer configured.\n  if (hasTavilyKey()) return 'tavily';\n  if (hasParallelKey()) return 'parallel';\n  return undefined;\n}\n\n/**\n * Create the configured model-independent web tools for the provider selected\n * via the `webSearchProvider` preference (set in the TUI settings panel).\n */\nexport function createConfiguredWebTools() {\n  const provider = resolveWebSearchProvider(loadSettings().preferences.webSearchProvider);\n\n  if (provider === 'parallel') {\n    return {\n      web_search: createParallelWebSearchTool(),\n      web_extract: createParallelWebExtractTool(),\n    };\n  }\n\n  if (provider === 'tavily') {\n    return {\n      web_search: createWebSearchTool(),\n      web_extract: createWebExtractTool(),\n    };\n  }\n\n  return undefined;\n}\n"],"mappings":"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"}
+{"version":3,"file":"web-search.js","names":[],"sources":["../../src/tools/web-search.ts"],"sourcesContent":["import { createTool } from '@mastra/core/tools';\nimport { createTavilySearchTool, createTavilyExtractTool } from '@mastra/tavily';\n\nimport { truncateStringForTokenEstimate } from '../utils/token-estimator.js';\n\nconst MAX_WEB_SEARCH_TOKENS = 2_000;\nconst MAX_WEB_EXTRACT_TOKENS = 2_000;\n\nconst MIN_RELEVANCE_SCORE = 0.25;\n\n/**\n * Check whether a Tavily API key is available in the environment.\n * Used by main.ts to decide whether to include Tavily tools or fall back\n * to Anthropic's native web search.\n */\nexport function hasTavilyKey(): boolean {\n  return !!process.env.TAVILY_API_KEY;\n}\n\n/**\n * Wraps the @mastra/tavily search tool with mastracode-specific behavior:\n * relevance filtering, markdown string formatting, and token truncation.\n * The underlying Tavily tool handles client init, input validation, and the API call.\n */\nexport function createWebSearchTool() {\n  const tavilySearchTool = createTavilySearchTool();\n\n  return createTool({\n    id: 'web-search',\n    description: tavilySearchTool.description!,\n    inputSchema: tavilySearchTool.inputSchema!,\n    execute: async (input, context) => {\n      const output: any = await tavilySearchTool.execute!(input as any, context as any);\n\n      const parts: string[] = [];\n\n      if (output.answer) {\n        parts.push(`Answer: ${output.answer}`);\n      }\n\n      const filtered = output.results.filter((r: any) => (r.score ?? 1) >= MIN_RELEVANCE_SCORE);\n      for (const r of filtered) {\n        parts.push(`## ${r.title}\\n${r.url}\\n${r.content}`);\n      }\n\n      const images = (output.images || []).map((img: any) => img.url).filter(Boolean);\n      if (images.length > 0) {\n        parts.push(`Images:\\n${images.join('\\n')}`);\n      }\n\n      const text = parts.join('\\n\\n');\n      return truncateStringForTokenEstimate(text, MAX_WEB_SEARCH_TOKENS);\n    },\n  });\n}\n\n/**\n * Wraps the @mastra/tavily extract tool with mastracode-specific behavior:\n * markdown string formatting and token truncation.\n */\nexport function createWebExtractTool() {\n  const tavilyExtractTool = createTavilyExtractTool();\n\n  return createTool({\n    id: 'web-extract',\n    description: tavilyExtractTool.description!,\n    inputSchema: tavilyExtractTool.inputSchema!,\n    execute: async (input, context) => {\n      const output: any = await tavilyExtractTool.execute!(input as any, context as any);\n\n      const parts: string[] = [];\n\n      for (const r of output.results) {\n        parts.push(`## ${r.url}\\n${r.rawContent}`);\n      }\n\n      for (const r of output.failedResults) {\n        parts.push(`## ${r.url}\\nError: ${r.error}`);\n      }\n\n      const text = parts.join('\\n\\n');\n      return truncateStringForTokenEstimate(text, MAX_WEB_EXTRACT_TOKENS);\n    },\n  });\n}\n"],"mappings":";;;;AAKA,MAAM,wBAAwB;AAC9B,MAAM,yBAAyB;AAE/B,MAAM,sBAAsB;;;;;;AAO5B,SAAgB,eAAwB;CACtC,OAAO,CAAC,CAAC,QAAQ,IAAI;AACvB;;;;;;AAOA,SAAgB,sBAAsB;CACpC,MAAM,mBAAmB,uBAAuB;CAEhD,OAAO,WAAW;EAChB,IAAI;EACJ,aAAa,iBAAiB;EAC9B,aAAa,iBAAiB;EAC9B,SAAS,OAAO,OAAO,YAAY;GACjC,MAAM,SAAc,MAAM,iBAAiB,QAAS,OAAc,OAAc;GAEhF,MAAM,QAAkB,CAAC;GAEzB,IAAI,OAAO,QACT,MAAM,KAAK,WAAW,OAAO,QAAQ;GAGvC,MAAM,WAAW,OAAO,QAAQ,QAAQ,OAAY,EAAE,SAAS,MAAM,mBAAmB;GACxF,KAAK,MAAM,KAAK,UACd,MAAM,KAAK,MAAM,EAAE,MAAM,IAAI,EAAE,IAAI,IAAI,EAAE,SAAS;GAGpD,MAAM,UAAU,OAAO,UAAU,CAAC,EAAA,CAAG,KAAK,QAAa,IAAI,GAAG,CAAC,CAAC,OAAO,OAAO;GAC9E,IAAI,OAAO,SAAS,GAClB,MAAM,KAAK,YAAY,OAAO,KAAK,IAAI,GAAG;GAI5C,OAAO,+BADM,MAAM,KAAK,MACiB,GAAG,qBAAqB;EACnE;CACF,CAAC;AACH;;;;;AAMA,SAAgB,uBAAuB;CACrC,MAAM,oBAAoB,wBAAwB;CAElD,OAAO,WAAW;EAChB,IAAI;EACJ,aAAa,kBAAkB;EAC/B,aAAa,kBAAkB;EAC/B,SAAS,OAAO,OAAO,YAAY;GACjC,MAAM,SAAc,MAAM,kBAAkB,QAAS,OAAc,OAAc;GAEjF,MAAM,QAAkB,CAAC;GAEzB,KAAK,MAAM,KAAK,OAAO,SACrB,MAAM,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,YAAY;GAG3C,KAAK,MAAM,KAAK,OAAO,eACrB,MAAM,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,OAAO;GAI7C,OAAO,+BADM,MAAM,KAAK,MACiB,GAAG,sBAAsB;EACpE;CACF,CAAC;AACH"}

package/dist/workflows/register-primitives.d.ts

@@ -7,7 +7,7 @@
  *   - workflow-builder sub-agent (so `create-workflow` can delegate)
  *   - code-agent (as a plain agent, callable via agent steps)
  *   - workspace tools (view/write/edit/find_files/execute_command/etc.)
- *   - configured model-independent web tools so workflows can compose search/extract steps
+ *   - web tools (Tavily-gated) so workflows can compose search/extract steps
  *   - notification_inbox
  *   - snapshot of MCP tools from mcpManager
  *
@@ -18,10 +18,10 @@
  * Tradeoffs:
  *   - MCP tools are snapshotted. Servers added after boot are invisible to
  *     the workflow-builder until restart.
- *   - Provider-native (Anthropic/OpenAI) web
+ *   - Web tool flavor is Tavily-only. Provider-native (Anthropic/OpenAI) web
  *     tools are skipped because they'd freeze workflows to one model provider.
- *   - Workflow tool steps get the closed-over workspace + auth (web provider
- *     key, MCP server credentials), not per-request permissions — deliberate; if
+ *   - Workflow tool steps get the closed-over workspace + auth (Tavily key,
+ *     MCP server credentials), not per-request permissions — deliberate; if
  *     the user built + saved the workflow they meant to run it.
  */
 import type { Agent } from '@mastra/core/agent';

package/dist/workflows/register-primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-primitives.d.ts","sourceRoot":"","sources":["../../src/workflows/register-primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAMlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIzC,MAAM,WAAW,wCAAwC;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,SAAS,EAAE,KAAK,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,wCAAwC,GAChD,OAAO,CAAC,IAAI,CAAC,CAkDf"}
+{"version":3,"file":"register-primitives.d.ts","sourceRoot":"","sources":["../../src/workflows/register-primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAMlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIzC,MAAM,WAAW,wCAAwC;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,SAAS,EAAE,KAAK,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,wCAAwC,GAChD,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/dist/workflows/register-primitives.js

@@ -1,5 +1,5 @@
 import { MC_TOOLS } from "../tool-names.js";
-import { createConfiguredWebTools } from "../tools/web-search.js";
+import { createWebExtractTool, createWebSearchTool, hasTavilyKey } from "../tools/web-search.js";
 import { MASTRACODE_WORKSPACE_TOOLS } from "../agents/tool-availability.js";
 import { LazyNotificationsStorage } from "../agents/tools.js";
 import { workflowBuilderAgent } from "../agents/workflow-builder-agent.js";
@@ -22,10 +22,9 @@ async function registerWorkflowBuilderPrimitives(mastra, options) {
 	});
 	const workspaceTools = await createWorkspaceTools(workspace, { workspace });
 	for (const [toolId, tool] of Object.entries(workspaceTools)) mastra.addTool(tool, toolId);
-	const configuredWebTools = createConfiguredWebTools();
-	if (configuredWebTools) {
-		mastra.addTool(configuredWebTools.web_search, "web-search");
-		mastra.addTool(configuredWebTools.web_extract, "web-extract");
+	if (hasTavilyKey()) {
+		mastra.addTool(createWebSearchTool(), "web-search");
+		mastra.addTool(createWebExtractTool(), "web-extract");
 	}
 	const storage = mastra.getStorage();
 	if (storage) {

package/dist/workflows/register-primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-primitives.js","names":[],"sources":["../../src/workflows/register-primitives.ts"],"sourcesContent":["/**\n * Statically register workflow-related primitives on the mastracode Mastra\n * instance so `mastra.listTools()` + `mastra.listAgents()` — and, therefore,\n * the workflow-builder's discovery + the workflow rehydrator — see everything\n * a workflow might want to compose:\n *\n *   - workflow-builder sub-agent (so `create-workflow` can delegate)\n *   - code-agent (as a plain agent, callable via agent steps)\n *   - workspace tools (view/write/edit/find_files/execute_command/etc.)\n *   - configured model-independent web tools so workflows can compose search/extract steps\n *   - notification_inbox\n *   - snapshot of MCP tools from mcpManager\n *\n * Called after `controller.init()` but before `startWorkers()` in both boot\n * paths, so `loadStoredWorkflows()` (inside startWorkers) sees the full\n * registry when rehydrating previously-saved workflows.\n *\n * Tradeoffs:\n *   - MCP tools are snapshotted. Servers added after boot are invisible to\n *     the workflow-builder until restart.\n *   - Provider-native (Anthropic/OpenAI) web\n *     tools are skipped because they'd freeze workflows to one model provider.\n *   - Workflow tool steps get the closed-over workspace + auth (web provider\n *     key, MCP server credentials), not per-request permissions — deliberate; if\n *     the user built + saved the workflow they meant to run it.\n */\nimport type { Agent } from '@mastra/core/agent';\nimport type { Mastra } from '@mastra/core/mastra';\nimport { createNotificationInboxTool } from '@mastra/core/notifications';\nimport { LocalFilesystem, LocalSandbox, Workspace, createWorkspaceTools } from '@mastra/core/workspace';\nimport { MASTRACODE_WORKSPACE_TOOLS } from '../agents/tool-availability.js';\nimport { LazyNotificationsStorage } from '../agents/tools.js';\nimport { workflowBuilderAgent } from '../agents/workflow-builder-agent.js';\nimport type { McpManager } from '../mcp';\nimport { MC_TOOLS } from '../tool-names.js';\nimport { createConfiguredWebTools } from '../tools/web-search.js';\n\nexport interface RegisterWorkflowBuilderPrimitivesOptions {\n  projectPath: string;\n  /**\n   * Extra allowed paths the workspace can read/write. Mastracode normally\n   * collects skill paths + sandboxAllowedPaths per-request; for the workflow\n   * workspace we accept anything the caller wants up-front and trust the\n   * worker process to honour the user's intent.\n   */\n  allowedPaths?: string[];\n  /**\n   * The code-agent Agent instance. Registered as `code-agent` so workflows\n   * can compose it in agent steps. It already has full dynamic tool access\n   * (workspace/MCP/web/etc.) via its own `tools: createDynamicTools(...)`.\n   */\n  codeAgent: Agent;\n  /**\n   * McpManager for snapshotting MCP tools at boot. Omit or pass undefined\n   * if MCP is disabled — workflow-builder will just see fewer tools.\n   */\n  mcpManager?: McpManager;\n}\n\nexport async function registerWorkflowBuilderPrimitives(\n  mastra: Mastra,\n  options: RegisterWorkflowBuilderPrimitivesOptions,\n): Promise<void> {\n  const { projectPath, allowedPaths = [], codeAgent, mcpManager } = options;\n\n  // 1. Agents workflows can compose.\n  mastra.addAgent(workflowBuilderAgent, 'workflow-builder');\n  mastra.addAgent(codeAgent, 'code-agent');\n\n  // 2. Workspace tools — bound to a project-rooted local workspace.\n  const workspace = new Workspace({\n    id: 'workflow-builder-workspace',\n    name: 'Mastra Code Workspace (workflows)',\n    filesystem: new LocalFilesystem({\n      basePath: projectPath,\n      allowedPaths: [projectPath, ...allowedPaths],\n    }),\n    sandbox: new LocalSandbox({ workingDirectory: projectPath }),\n    tools: MASTRACODE_WORKSPACE_TOOLS,\n  });\n  const workspaceTools = await createWorkspaceTools(workspace, { workspace });\n  for (const [toolId, tool] of Object.entries(workspaceTools)) {\n    mastra.addTool(tool, toolId);\n  }\n\n  // 3. Model-independent web tools. Provider-native web tools (Anthropic/OpenAI)\n  //    are model-locked and would freeze workflows to one provider.\n  const configuredWebTools = createConfiguredWebTools();\n  if (configuredWebTools) {\n    mastra.addTool(configuredWebTools.web_search, 'web-search');\n    mastra.addTool(configuredWebTools.web_extract, 'web-extract');\n  }\n\n  // 4. notification_inbox — LazyNotificationsStorage resolves the notifications\n  //    domain per-call rather than at boot, so it works even when the domain\n  //    isn't fully initialised yet.\n  const storage = mastra.getStorage();\n  if (storage) {\n    const notificationInbox = createNotificationInboxTool({\n      storage: new LazyNotificationsStorage(storage as never),\n    });\n    mastra.addTool(notificationInbox, MC_TOOLS.NOTIFICATION_INBOX);\n  }\n\n  // 5. MCP tools — snapshot the current set. Ids are already server-namespaced\n  //    (`${serverName}_${toolName}`), so the workflow rehydrator's\n  //    `mastra.getTool(id)` resolves them at run time.\n  if (mcpManager) {\n    for (const [toolId, tool] of Object.entries(mcpManager.getTools())) {\n      mastra.addTool(tool, toolId);\n    }\n  }\n}\n"],"mappings":";;;;;;;;AA2DA,eAAsB,kCACpB,QACA,SACe;CACf,MAAM,EAAE,aAAa,eAAe,CAAC,GAAG,WAAW,eAAe;CAGlE,OAAO,SAAS,sBAAsB,kBAAkB;CACxD,OAAO,SAAS,WAAW,YAAY;CAGvC,MAAM,YAAY,IAAI,UAAU;EAC9B,IAAI;EACJ,MAAM;EACN,YAAY,IAAI,gBAAgB;GAC9B,UAAU;GACV,cAAc,CAAC,aAAa,GAAG,YAAY;EAC7C,CAAC;EACD,SAAS,IAAI,aAAa,EAAE,kBAAkB,YAAY,CAAC;EAC3D,OAAO;CACT,CAAC;CACD,MAAM,iBAAiB,MAAM,qBAAqB,WAAW,EAAE,UAAU,CAAC;CAC1E,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,cAAc,GACxD,OAAO,QAAQ,MAAM,MAAM;CAK7B,MAAM,qBAAqB,yBAAyB;CACpD,IAAI,oBAAoB;EACtB,OAAO,QAAQ,mBAAmB,YAAY,YAAY;EAC1D,OAAO,QAAQ,mBAAmB,aAAa,aAAa;CAC9D;CAKA,MAAM,UAAU,OAAO,WAAW;CAClC,IAAI,SAAS;EACX,MAAM,oBAAoB,4BAA4B,EACpD,SAAS,IAAI,yBAAyB,OAAgB,EACxD,CAAC;EACD,OAAO,QAAQ,mBAAmB,SAAS,kBAAkB;CAC/D;CAKA,IAAI,YACF,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,WAAW,SAAS,CAAC,GAC/D,OAAO,QAAQ,MAAM,MAAM;AAGjC"}
+{"version":3,"file":"register-primitives.js","names":[],"sources":["../../src/workflows/register-primitives.ts"],"sourcesContent":["/**\n * Statically register workflow-related primitives on the mastracode Mastra\n * instance so `mastra.listTools()` + `mastra.listAgents()` — and, therefore,\n * the workflow-builder's discovery + the workflow rehydrator — see everything\n * a workflow might want to compose:\n *\n *   - workflow-builder sub-agent (so `create-workflow` can delegate)\n *   - code-agent (as a plain agent, callable via agent steps)\n *   - workspace tools (view/write/edit/find_files/execute_command/etc.)\n *   - web tools (Tavily-gated) so workflows can compose search/extract steps\n *   - notification_inbox\n *   - snapshot of MCP tools from mcpManager\n *\n * Called after `controller.init()` but before `startWorkers()` in both boot\n * paths, so `loadStoredWorkflows()` (inside startWorkers) sees the full\n * registry when rehydrating previously-saved workflows.\n *\n * Tradeoffs:\n *   - MCP tools are snapshotted. Servers added after boot are invisible to\n *     the workflow-builder until restart.\n *   - Web tool flavor is Tavily-only. Provider-native (Anthropic/OpenAI) web\n *     tools are skipped because they'd freeze workflows to one model provider.\n *   - Workflow tool steps get the closed-over workspace + auth (Tavily key,\n *     MCP server credentials), not per-request permissions — deliberate; if\n *     the user built + saved the workflow they meant to run it.\n */\nimport type { Agent } from '@mastra/core/agent';\nimport type { Mastra } from '@mastra/core/mastra';\nimport { createNotificationInboxTool } from '@mastra/core/notifications';\nimport { LocalFilesystem, LocalSandbox, Workspace, createWorkspaceTools } from '@mastra/core/workspace';\nimport { MASTRACODE_WORKSPACE_TOOLS } from '../agents/tool-availability.js';\nimport { LazyNotificationsStorage } from '../agents/tools.js';\nimport { workflowBuilderAgent } from '../agents/workflow-builder-agent.js';\nimport type { McpManager } from '../mcp';\nimport { MC_TOOLS } from '../tool-names.js';\nimport { createWebExtractTool, createWebSearchTool, hasTavilyKey } from '../tools/web-search.js';\n\nexport interface RegisterWorkflowBuilderPrimitivesOptions {\n  projectPath: string;\n  /**\n   * Extra allowed paths the workspace can read/write. Mastracode normally\n   * collects skill paths + sandboxAllowedPaths per-request; for the workflow\n   * workspace we accept anything the caller wants up-front and trust the\n   * worker process to honour the user's intent.\n   */\n  allowedPaths?: string[];\n  /**\n   * The code-agent Agent instance. Registered as `code-agent` so workflows\n   * can compose it in agent steps. It already has full dynamic tool access\n   * (workspace/MCP/web/etc.) via its own `tools: createDynamicTools(...)`.\n   */\n  codeAgent: Agent;\n  /**\n   * McpManager for snapshotting MCP tools at boot. Omit or pass undefined\n   * if MCP is disabled — workflow-builder will just see fewer tools.\n   */\n  mcpManager?: McpManager;\n}\n\nexport async function registerWorkflowBuilderPrimitives(\n  mastra: Mastra,\n  options: RegisterWorkflowBuilderPrimitivesOptions,\n): Promise<void> {\n  const { projectPath, allowedPaths = [], codeAgent, mcpManager } = options;\n\n  // 1. Agents workflows can compose.\n  mastra.addAgent(workflowBuilderAgent, 'workflow-builder');\n  mastra.addAgent(codeAgent, 'code-agent');\n\n  // 2. Workspace tools — bound to a project-rooted local workspace.\n  const workspace = new Workspace({\n    id: 'workflow-builder-workspace',\n    name: 'Mastra Code Workspace (workflows)',\n    filesystem: new LocalFilesystem({\n      basePath: projectPath,\n      allowedPaths: [projectPath, ...allowedPaths],\n    }),\n    sandbox: new LocalSandbox({ workingDirectory: projectPath }),\n    tools: MASTRACODE_WORKSPACE_TOOLS,\n  });\n  const workspaceTools = await createWorkspaceTools(workspace, { workspace });\n  for (const [toolId, tool] of Object.entries(workspaceTools)) {\n    mastra.addTool(tool, toolId);\n  }\n\n  // 3. Web tools — Tavily only. Provider-native web tools (Anthropic/OpenAI)\n  //    are model-locked and would freeze workflows to one provider.\n  if (hasTavilyKey()) {\n    mastra.addTool(createWebSearchTool(), 'web-search');\n    mastra.addTool(createWebExtractTool(), 'web-extract');\n  }\n\n  // 4. notification_inbox — LazyNotificationsStorage resolves the notifications\n  //    domain per-call rather than at boot, so it works even when the domain\n  //    isn't fully initialised yet.\n  const storage = mastra.getStorage();\n  if (storage) {\n    const notificationInbox = createNotificationInboxTool({\n      storage: new LazyNotificationsStorage(storage as never),\n    });\n    mastra.addTool(notificationInbox, MC_TOOLS.NOTIFICATION_INBOX);\n  }\n\n  // 5. MCP tools — snapshot the current set. Ids are already server-namespaced\n  //    (`${serverName}_${toolName}`), so the workflow rehydrator's\n  //    `mastra.getTool(id)` resolves them at run time.\n  if (mcpManager) {\n    for (const [toolId, tool] of Object.entries(mcpManager.getTools())) {\n      mastra.addTool(tool, toolId);\n    }\n  }\n}\n"],"mappings":";;;;;;;;AA2DA,eAAsB,kCACpB,QACA,SACe;CACf,MAAM,EAAE,aAAa,eAAe,CAAC,GAAG,WAAW,eAAe;CAGlE,OAAO,SAAS,sBAAsB,kBAAkB;CACxD,OAAO,SAAS,WAAW,YAAY;CAGvC,MAAM,YAAY,IAAI,UAAU;EAC9B,IAAI;EACJ,MAAM;EACN,YAAY,IAAI,gBAAgB;GAC9B,UAAU;GACV,cAAc,CAAC,aAAa,GAAG,YAAY;EAC7C,CAAC;EACD,SAAS,IAAI,aAAa,EAAE,kBAAkB,YAAY,CAAC;EAC3D,OAAO;CACT,CAAC;CACD,MAAM,iBAAiB,MAAM,qBAAqB,WAAW,EAAE,UAAU,CAAC;CAC1E,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,cAAc,GACxD,OAAO,QAAQ,MAAM,MAAM;CAK7B,IAAI,aAAa,GAAG;EAClB,OAAO,QAAQ,oBAAoB,GAAG,YAAY;EAClD,OAAO,QAAQ,qBAAqB,GAAG,aAAa;CACtD;CAKA,MAAM,UAAU,OAAO,WAAW;CAClC,IAAI,SAAS;EACX,MAAM,oBAAoB,4BAA4B,EACpD,SAAS,IAAI,yBAAyB,OAAgB,EACxD,CAAC;EACD,OAAO,QAAQ,mBAAmB,SAAS,kBAAkB;CAC/D;CAKA,IAAI,YACF,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,WAAW,SAAS,CAAC,GAC/D,OAAO,QAAQ,MAAM,MAAM;AAGjC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/code-sdk",
-  "version": "1.5.0-alpha.11",
+  "version": "1.5.0-alpha.3",
   "description": "Mastra Code SDK: the agent core behind Mastra Code (everything except the TUI) — build your own UIs and surfaces on top of it",
   "type": "module",
   "publishConfig": {
@@ -57,17 +57,16 @@
     "vscode-languageserver-protocol": "^3.17.5",
     "yaml": "^2.7.1",
     "zod": "^4.3.6",
-    "@mastra/agent-browser": "0.5.1",
-    "@mastra/core": "1.62.0-alpha.11",
+    "@mastra/core": "1.62.0-alpha.3",
     "@mastra/duckdb": "1.6.3-alpha.0",
-    "@mastra/libsql": "1.22.0-alpha.2",
-    "@mastra/mcp": "1.17.2-alpha.2",
-    "@mastra/github-signals": "0.3.0-alpha.0",
-    "@mastra/memory": "1.28.0-alpha.4",
-    "@mastra/observability": "1.17.2-alpha.2",
-    "@mastra/fastembed": "1.3.0-alpha.0",
-    "@mastra/pg": "1.22.0-alpha.4",
-    "@mastra/parallel": "0.1.0-alpha.0",
+    "@mastra/fastembed": "1.2.0",
+    "@mastra/libsql": "1.22.0-alpha.0",
+    "@mastra/agent-browser": "0.5.1",
+    "@mastra/github-signals": "0.2.5",
+    "@mastra/mcp": "1.17.2-alpha.0",
+    "@mastra/memory": "1.27.1-alpha.0",
+    "@mastra/pg": "1.22.0-alpha.1",
+    "@mastra/observability": "1.17.2-alpha.1",
     "@mastra/schema-compat": "1.3.7",
     "@mastra/stagehand": "0.3.3",
     "@mastra/tavily": "1.1.1"
@@ -81,8 +80,8 @@
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.57.0",
     "vitest": "4.1.10",
-    "@internal/lint": "0.0.125",
     "@internal/types-builder": "0.0.100",
+    "@internal/lint": "0.0.125",
     "@internal/workspace-test-utils": "0.0.69"
   },
   "engines": {

package/dist/agents/context-audit.d.ts

@@ -1,84 +0,0 @@
-import type { PromptSection } from './prompts/index.js';
-/** A single measured contributor to the context window. */
-export interface ContextAuditEntry {
-    id: string;
-    label: string;
-    /** Provenance: file path, server name, model id — whatever identifies the source. */
-    detail?: string;
-    tokens: number;
-    characters: number;
-    /** Share of the audit total, 0-100. */
-    percent: number;
-}
-/** A category of contributors (e.g. all agent instruction files). */
-export interface ContextAuditGroup {
-    id: string;
-    label: string;
-    tokens: number;
-    /** Share of the audit total, 0-100. */
-    percent: number;
-    entries: ContextAuditEntry[];
-    /** Shown alongside the group when its numbers need qualifying. */
-    note?: string;
-}
-export interface ContextAudit {
-    /** Context present before the first message: system prompt, skills, tools. */
-    startup: {
-        tokens: number;
-        percent: number;
-        groups: ContextAuditGroup[];
-    };
-    /** Context accumulated by the session: conversation and observation memory. */
-    accumulated: {
-        tokens: number;
-        percent: number;
-        groups: ContextAuditGroup[];
-    };
-    /** Startup + accumulated. Percentages elsewhere are shares of this. */
-    totalTokens: number;
-    /** Estimated rather than measured: token counts come from a heuristic estimator. */
-    estimated: true;
-}
-/** A tool definition as advertised to the model. */
-export interface ContextAuditTool {
-    name: string;
-    description?: string;
-    /** JSON schema (or any serializable shape) sent with the definition. */
-    parameters?: unknown;
-    /** MCP server that provides the tool, when it is not built in. */
-    server?: string;
-}
-export interface ContextAuditInput {
-    /** Labeled sections of the assembled system prompt. */
-    promptSections?: PromptSection[];
-    /** Labeled sections of the per-request dynamic instructions. */
-    instructionSections?: PromptSection[];
-    /** The skills catalog exactly as injected into the system message. */
-    skillsCatalog?: string;
-    /** Tool definitions advertised to the model. */
-    tools?: ContextAuditTool[];
-    /**
-     * Observation memory currently occupying the context window, either as the
-     * injected text or as a token count reported by the memory subsystem.
-     *
-     * Only observations that are actually in the context belong here.
-     * Observations that merely sit in storage cost nothing until recalled, and
-     * conflating the two is exactly the confusion this audit exists to resolve.
-     */
-    injectedObservations?: string | {
-        tokens: number;
-    };
-    /** Prompt tokens the provider reported for the most recent request. */
-    conversation?: {
-        promptTokens?: number;
-    };
-}
-/**
- * Build a context audit from already-collected context.
- *
- * Percentages are shares of the audited total, not of the model's context
- * window: window size is not exposed by the model registry, and inventing one
- * would make every number wrong for models that disagree with the guess.
- */
-export declare function buildContextAudit(input: ContextAuditInput): ContextAudit;
-//# sourceMappingURL=context-audit.d.ts.map

package/dist/agents/context-audit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-audit.d.ts","sourceRoot":"","sources":["../../src/agents/context-audit.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC;IAC1E,+EAA+E;IAC/E,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC;IAC9E,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,aAAa,EAAE,CAAC;IACtC,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,uEAAuE;IACvE,YAAY,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AA2CD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAsFxE"}