@inkeep/agents-run-api 0.0.0-dev-20250916184039 → 0.0.0-dev-20250916192201

package/dist/index.cjs

@@ -30,6 +30,7 @@ var destr = require('destr');
 var traverse = require('traverse');
 var ai = require('ai');
 var anthropic = require('@ai-sdk/anthropic');
+var google = require('@ai-sdk/google');
 var openai = require('@ai-sdk/openai');
 var jmespath = require('jmespath');
 var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
@@ -1410,6 +1411,38 @@ __publicField(_ArtifactReferenceSchema, "ARTIFACT_PROPS_SCHEMA", {
 var ArtifactReferenceSchema = _ArtifactReferenceSchema;
 var logger5 = agentsCore.getLogger("ModelFactory");
 var _ModelFactory = class _ModelFactory {
+  /**
+   * Create a provider instance with custom configuration
+   */
+  static createProvider(provider, config2) {
+    switch (provider) {
+      case "anthropic":
+        return anthropic.createAnthropic(config2);
+      case "openai":
+        return openai.createOpenAI(config2);
+      case "google":
+        return google.createGoogleGenerativeAI(config2);
+      default:
+        throw new Error(`Unsupported provider: ${provider}`);
+    }
+  }
+  /**
+   * Extract provider configuration from providerOptions
+   * Only includes settings that go to the provider constructor (baseURL, apiKey, etc.)
+   */
+  static extractProviderConfig(providerOptions) {
+    if (!providerOptions) {
+      return {};
+    }
+    const providerConfig = {};
+    if (providerOptions.baseUrl || providerOptions.baseURL) {
+      providerConfig.baseURL = providerOptions.baseUrl || providerOptions.baseURL;
+    }
+    if (providerOptions.gateway) {
+      Object.assign(providerConfig, providerOptions.gateway);
+    }
+    return providerConfig;
+  }
   /**
    * Create a language model instance from configuration
    * Throws error if no config provided - models must be configured at project level
@@ -1432,49 +1465,40 @@ var _ModelFactory = class _ModelFactory {
       },
       "Creating language model from config"
     );
-    try {
-      switch (provider) {
-        case "anthropic":
-          return _ModelFactory.createAnthropicModel(modelName, modelSettings.providerOptions);
-        case "openai":
-          return _ModelFactory.createOpenAIModel(modelName, modelSettings.providerOptions);
-        default:
-          throw new Error(
-            `Unsupported provider: ${provider}. Supported providers are: ${_ModelFactory.SUPPORTED_PROVIDERS.join(", ")}`
-          );
-      }
-    } catch (error) {
-      logger5.error(
-        {
-          provider,
-          model: modelName,
-          error: error instanceof Error ? error.message : "Unknown error"
-        },
-        "Failed to create model"
-      );
-      throw new Error(
-        `Failed to create model ${modelString}: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
+    const providerConfig = _ModelFactory.extractProviderConfig(modelSettings.providerOptions);
+    if (Object.keys(providerConfig).length > 0) {
+      logger5.info({ config: providerConfig }, `Applying custom ${provider} provider configuration`);
+      const customProvider = _ModelFactory.createProvider(provider, providerConfig);
+      return customProvider.languageModel(modelName);
+    }
+    switch (provider) {
+      case "anthropic":
+        return anthropic.anthropic(modelName);
+      case "openai":
+        return openai.openai(modelName);
+      case "google":
+        return google.google(modelName);
+      default:
+        throw new Error(`Unsupported provider: ${provider}`);
     }
   }
   /**
    * Parse model string to extract provider and model name
-   * Examples: "anthropic/claude-4-sonnet" -> { provider: "anthropic", modelName: "claude-4-sonnet" }
-   *          "claude-4-sonnet" -> { provider: "anthropic", modelName: "claude-4-sonnet" } (default to anthropic)
+   * Examples: "anthropic/claude-sonnet-4" -> { provider: "anthropic", modelName: "claude-sonnet-4" }
+   *          "claude-sonnet-4" -> { provider: "anthropic", modelName: "claude-sonnet-4" } (default to anthropic)
    */
   static parseModelString(modelString) {
     if (modelString.includes("/")) {
       const [provider, ...modelParts] = modelString.split("/");
       const normalizedProvider = provider.toLowerCase();
       if (!_ModelFactory.SUPPORTED_PROVIDERS.includes(normalizedProvider)) {
-        logger5.warn(
+        logger5.error(
           { provider: normalizedProvider, modelName: modelParts.join("/") },
           "Unsupported provider detected, falling back to anthropic"
         );
-        return {
-          provider: "anthropic",
-          modelName: modelParts.join("/")
-        };
+        throw new Error(
+          `Unsupported provider: ${normalizedProvider}. Please provide a model in the format of provider/model-name.`
+        );
       }
       return {
         provider: normalizedProvider,
@@ -1482,51 +1506,9 @@ var _ModelFactory = class _ModelFactory {
         // In case model name has slashes
       };
     }
-    return {
-      provider: "anthropic",
-      modelName: modelString
-    };
-  }
-  /**
-   * Create an Anthropic model instance
-   */
-  static createAnthropicModel(modelName, providerOptions) {
-    const anthropicConfig = {};
-    if (providerOptions?.baseUrl || providerOptions?.baseURL) {
-      anthropicConfig.baseURL = providerOptions.baseUrl || providerOptions.baseURL;
-    }
-    if (providerOptions?.gateway) {
-      logger5.info(
-        { gateway: providerOptions.gateway },
-        "Setting up AI Gateway for Anthropic model"
-      );
-      Object.assign(anthropicConfig, providerOptions.gateway);
-    }
-    if (Object.keys(anthropicConfig).length > 0) {
-      logger5.info({ config: anthropicConfig }, "Applying custom Anthropic provider configuration");
-      const provider = anthropic.createAnthropic(anthropicConfig);
-      return provider(modelName);
-    }
-    return anthropic.anthropic(modelName);
-  }
-  /**
-   * Create an OpenAI model instance
-   */
-  static createOpenAIModel(modelName, providerOptions) {
-    const openaiConfig = {};
-    if (providerOptions?.baseUrl || providerOptions?.baseURL) {
-      openaiConfig.baseURL = providerOptions.baseUrl || providerOptions.baseURL;
-    }
-    if (providerOptions?.gateway) {
-      logger5.info({ gateway: providerOptions.gateway }, "Setting up AI Gateway for OpenAI model");
-      Object.assign(openaiConfig, providerOptions.gateway);
-    }
-    if (Object.keys(openaiConfig).length > 0) {
-      logger5.info({ config: openaiConfig }, "Applying custom OpenAI provider configuration");
-      const provider = openai.createOpenAI(openaiConfig);
-      return provider(modelName);
-    }
-    return openai.openai(modelName);
+    throw new Error(
+      `Invalid model provided: ${modelString}. Please provide a model in the format of provider/model-name.`
+    );
   }
   /**
    * Get generation parameters from provider options
@@ -1551,7 +1533,7 @@ var _ModelFactory = class _ModelFactory {
    * Includes maxDuration if specified in provider options (in seconds, following Vercel standard)
    */
   static prepareGenerationConfig(modelSettings) {
-    const modelString = modelSettings?.model?.trim() || "anthropic/claude-4-sonnet-20250514";
+    const modelString = modelSettings?.model?.trim();
     const model = _ModelFactory.createModel({
       model: modelString,
       providerOptions: modelSettings?.providerOptions
@@ -1592,7 +1574,7 @@ var _ModelFactory = class _ModelFactory {
 /**
  * Supported providers for security validation
  */
-__publicField(_ModelFactory, "SUPPORTED_PROVIDERS", ["anthropic", "openai"]);
+__publicField(_ModelFactory, "SUPPORTED_PROVIDERS", ["anthropic", "openai", "google"]);
 var ModelFactory = _ModelFactory;
 
 // src/utils/graph-session.ts
@@ -3665,7 +3647,7 @@ function createPropSelectorsSchema(artifactComponents) {
         Object.entries(summaryProps.properties).forEach(([propName, propDef]) => {
           const propDescription = propDef?.description || propDef?.title || `${propName} property`;
           propSchema[propName] = z5__default.default.string().describe(
-            `JMESPath selector for ${propName} (${propDescription}) - summary version, relative to base selector`
+            `JMESPath selector for ${propName} (${propDescription}) - summary version, MUST be relative to your baseSelector target level. Access fields WITHIN the items your baseSelector returns.`
           );
         });
       }
@@ -3677,7 +3659,7 @@ function createPropSelectorsSchema(artifactComponents) {
           if (!propSchema[propName]) {
             const propDescription = propDef?.description || propDef?.title || `${propName} property`;
             propSchema[propName] = z5__default.default.string().describe(
-              `JMESPath selector for ${propName} (${propDescription}) - full version, relative to base selector`
+              `JMESPath selector for ${propName} (${propDescription}) - MUST be relative to your baseSelector target level. If baseSelector stops at a document, this accesses fields WITHIN that document. Examples: "title", "content.body", "metadata.author"`
             );
           }
         });
@@ -3691,7 +3673,26 @@ function createPropSelectorsSchema(artifactComponents) {
     return z5__default.default.union(propSelectorSchemas);
   }
   return z5__default.default.record(z5__default.default.string(), z5__default.default.string()).describe(
-    "Prop selectors mapping schema properties to JMESPath expressions relative to base selector"
+    `Prop selectors mapping schema properties to JMESPath expressions relative to base selector. Each path is relative to the item(s) your baseSelector returns.
+
+\u{1F3AF} CRITICAL: PropSelectors work ONLY on the data your baseSelector returns!
+If baseSelector = "result.docs[0]" \u2192 propSelectors access fields INSIDE that doc
+If baseSelector = "result.docs[0].content[0]" \u2192 propSelectors access fields INSIDE that content item
+
+\u2705 CORRECT EXAMPLES (paths relative to baseSelector target):
+\u2022 baseSelector: "result.documents[?type=='article']" \u2192 propSelectors: {"title": "title", "url": "url"}
+\u2022 baseSelector: "result.content[0].text" \u2192 propSelectors: {"content": "content[0].text", "source": "content[0].source"}
+\u2022 baseSelector: "result.items" \u2192 propSelectors: {"name": "profile.name", "email": "contact.email"}
+
+\u274C WRONG EXAMPLES (accessing data not at baseSelector level):
+\u2022 baseSelector: "result.docs[0].content[0]" \u2192 propSelectors: {"title": "title"} \u2190 title is at doc level, not content level!
+\u2022 baseSelector: "result.source.content" \u2192 propSelectors: {"title": "content[4].text"} \u2190 baseSelector ends at array, can't index into it!
+\u2022 baseSelector: "result.items" \u2192 propSelectors: {"title": "documents[0].title"} \u2190 going deeper when baseSelector should handle depth
+
+\u274C NEVER USE LITERAL VALUES:
+{"title": "Robert Tran", "url": "https://linkedin.com/..."}
+
+\u{1F4A1} TIP: Match your baseSelector depth to where the properties you need actually exist!`
   );
 }
 function createInputSchema(artifactComponents) {
@@ -3700,7 +3701,18 @@ function createInputSchema(artifactComponents) {
       "EXACT toolCallId from a previous tool execution - copy it exactly from the tool call result. NEVER invent or make up tool call IDs."
     ),
     baseSelector: z5__default.default.string().describe(
-      `JMESPath selector to get to the main data array/object. ALWAYS start with "result." Example: "result.content[?type=='text']"`
+      `JMESPath selector to get to the main data array/object. ALWAYS start with "result." That is a mandatory prefix.
+
+Data structures are COMPLEX and NESTED. Examples:
+\u2022 "result.content[0].text.content[2]" - parsed JSON in text field
+\u2022 "result.structuredContent.content[1]" - direct structured data
+\u2022 "result.data.items[?type=='doc']" - filtered array
+
+\u{1F6A8} CRITICAL: If you need data from array[4], your baseSelector must END at array[4], NOT at the array itself!
+\u2705 CORRECT: "result.source.content[4]" \u2192 propSelectors can access fields in that item
+\u274C WRONG: "result.source.content" \u2192 propSelectors can't use content[4] because baseSelector already selected the array
+
+\u{1F525} IF YOUR PATH FAILS: READ THE ERROR MESSAGE! It tells you the correct path! \u{1F525}`
     ),
     propSelectors: createPropSelectorsSchema(artifactComponents)
   });
@@ -3719,6 +3731,9 @@ function createSaveToolResultTool(sessionId, streamRequestId, agentId, artifactC
   return ai.tool({
     description: `Save tool results as structured artifacts. Each artifact should represent ONE SPECIFIC, IMPORTANT, and UNIQUE document or data item.
 
+\u26A1 CRITICAL: JSON-like text content in tool results is AUTOMATICALLY PARSED into proper JSON objects - treat all data as structured, not text strings.
+\u{1F6A8} CRITICAL: Data structures are deeply nested. When your path fails, READ THE ERROR MESSAGE - it shows the correct path!
+
 AVAILABLE ARTIFACT TYPES:
 ${availableTypesWithDescriptions}
 
@@ -3730,26 +3745,6 @@ Each artifact you save becomes a SEPARATE DATA COMPONENT in the structured respo
 \u2705 UNIQUE with distinct value from other artifacts
 \u2705 RENDERED AS INDIVIDUAL DATA COMPONENT in the UI
 
-\u274C DO NOT save multiple different items in one artifact unless they are EXTREMELY SIMILAR
-\u274C DO NOT batch unrelated items together - each item becomes its own data component
-\u274C DO NOT save generic collections - break them into individual data components
-
-\u{1F3AF} STRUCTURED DATA COMPONENT PRINCIPLE:
-Each artifact save creates ONE data component that will be rendered separately in the UI. If you have 5 important items, save them as 5 separate artifacts to create 5 separate data components for better user experience.
-
-THINK: "What is the ONE most important piece of information here that deserves its own data component?"
-
-EXAMPLES OF GOOD INDIVIDUAL ARTIFACTS (SEPARATE DATA COMPONENTS):
-- Nick Gomez's founder profile (specific person) \u2192 Individual data component
-- The /users/create API endpoint documentation (specific endpoint) \u2192 Individual data component  
-- Error message for authentication failure (specific error type) \u2192 Individual data component
-- Configuration for Redis caching (specific config topic) \u2192 Individual data component
-
-EXAMPLES OF BAD BATCHING:
-\u274C "All team members" \u2192 Should be separate artifacts for each important member (separate data components)
-\u274C "All API endpoints" \u2192 Should be separate artifacts for each distinct endpoint (separate data components)
-\u274C "All error types" \u2192 Should be separate artifacts for each error category (separate data components)
-
 USAGE PATTERN:
 1. baseSelector: Navigate through nested structures to target ONE SPECIFIC item
    - Navigate through all necessary levels: "result.data.items.nested[?condition]"
@@ -3759,9 +3754,11 @@ USAGE PATTERN:
    - NOT: "result.items[*]" (too broad, gets everything)
 
 2. propSelectors: Extract properties relative to your selected item
-   - Always relative to the single item that baseSelector returns
-   - Simple paths from that item: { prop1: "field_x", prop2: "nested.field_y", prop3: "deep.nested.field_z" }
-   - The tool handles array iteration - your selectors work on individual items
+   - \u{1F3AF} CRITICAL: Always relative to the single item that baseSelector returns
+   - If baseSelector ends at a document \u2192 propSelectors access document fields
+   - If baseSelector ends at content[0] \u2192 propSelectors access content[0] fields
+   - Simple paths from that exact level: { prop1: "field_x", prop2: "nested.field_y" }
+   - \u274C DON'T try to go back up or deeper - adjust your baseSelector instead!
 
 3. Result: ONE artifact representing ONE important, unique item \u2192 ONE data component
 
@@ -3770,15 +3767,7 @@ USAGE PATTERN:
 - Focus on getting to the right level with baseSelector, then keep propSelectors simple
 - Test your baseSelector: Does it return exactly the items you want?
 
-\u26A0\uFE0F  STRICT SELECTIVITY RULES FOR DATA COMPONENTS:
-- ALWAYS ask: "Is this ONE specific, important thing that deserves its own data component?"
-- If the answer is no, don't save it or find a more specific selector
-- Multiple similar items = Multiple separate artifact saves (use the tool multiple times) \u2192 Multiple data components
-- Each artifact should be independently valuable and uniquely identifiable \u2192 Each data component stands alone
-- BETTER to save 3 individual, specific artifacts (3 data components) than 1 generic collection (1 data component)
-
-\u{1F504} MULTIPLE ARTIFACTS = MULTIPLE DATA COMPONENTS:
-Remember: Each time you call this tool, you create a separate data component. Call it multiple times for multiple items to create a rich, structured response with individual data components for each important piece of information.`,
+Please use Error Messages to Debug when there is an error in the tool call.`,
     inputSchema,
     execute: async ({ toolCallId, baseSelector, propSelectors, ...rest }, _context) => {
       const artifactType = "artifactType" in rest ? rest.artifactType : void 0;
@@ -6308,7 +6297,7 @@ ${output}`;
                 { role: "user", content: userMessage },
                 ...reasoningFlow,
                 {
-                  role: "system",
+                  role: "user",
                   content: await this.buildPhase2SystemPrompt()
                 }
               ],

package/dist/index.js

@@ -24,6 +24,7 @@ import destr from 'destr';
 import traverse from 'traverse';
 import { createUIMessageStream, JsonToSseTransformStream, parsePartialJson, generateText, generateObject, tool, streamText } from 'ai';
 import { createAnthropic, anthropic } from '@ai-sdk/anthropic';
+import { createGoogleGenerativeAI, google } from '@ai-sdk/google';
 import { createOpenAI, openai } from '@ai-sdk/openai';
 import jmespath from 'jmespath';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
@@ -1101,6 +1102,38 @@ __publicField(_ArtifactReferenceSchema, "ARTIFACT_PROPS_SCHEMA", {
 var ArtifactReferenceSchema = _ArtifactReferenceSchema;
 var logger5 = getLogger("ModelFactory");
 var _ModelFactory = class _ModelFactory {
+  /**
+   * Create a provider instance with custom configuration
+   */
+  static createProvider(provider, config) {
+    switch (provider) {
+      case "anthropic":
+        return createAnthropic(config);
+      case "openai":
+        return createOpenAI(config);
+      case "google":
+        return createGoogleGenerativeAI(config);
+      default:
+        throw new Error(`Unsupported provider: ${provider}`);
+    }
+  }
+  /**
+   * Extract provider configuration from providerOptions
+   * Only includes settings that go to the provider constructor (baseURL, apiKey, etc.)
+   */
+  static extractProviderConfig(providerOptions) {
+    if (!providerOptions) {
+      return {};
+    }
+    const providerConfig = {};
+    if (providerOptions.baseUrl || providerOptions.baseURL) {
+      providerConfig.baseURL = providerOptions.baseUrl || providerOptions.baseURL;
+    }
+    if (providerOptions.gateway) {
+      Object.assign(providerConfig, providerOptions.gateway);
+    }
+    return providerConfig;
+  }
   /**
    * Create a language model instance from configuration
    * Throws error if no config provided - models must be configured at project level
@@ -1123,49 +1156,40 @@ var _ModelFactory = class _ModelFactory {
       },
       "Creating language model from config"
     );
-    try {
-      switch (provider) {
-        case "anthropic":
-          return _ModelFactory.createAnthropicModel(modelName, modelSettings.providerOptions);
-        case "openai":
-          return _ModelFactory.createOpenAIModel(modelName, modelSettings.providerOptions);
-        default:
-          throw new Error(
-            `Unsupported provider: ${provider}. Supported providers are: ${_ModelFactory.SUPPORTED_PROVIDERS.join(", ")}`
-          );
-      }
-    } catch (error) {
-      logger5.error(
-        {
-          provider,
-          model: modelName,
-          error: error instanceof Error ? error.message : "Unknown error"
-        },
-        "Failed to create model"
-      );
-      throw new Error(
-        `Failed to create model ${modelString}: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
+    const providerConfig = _ModelFactory.extractProviderConfig(modelSettings.providerOptions);
+    if (Object.keys(providerConfig).length > 0) {
+      logger5.info({ config: providerConfig }, `Applying custom ${provider} provider configuration`);
+      const customProvider = _ModelFactory.createProvider(provider, providerConfig);
+      return customProvider.languageModel(modelName);
+    }
+    switch (provider) {
+      case "anthropic":
+        return anthropic(modelName);
+      case "openai":
+        return openai(modelName);
+      case "google":
+        return google(modelName);
+      default:
+        throw new Error(`Unsupported provider: ${provider}`);
     }
   }
   /**
    * Parse model string to extract provider and model name
-   * Examples: "anthropic/claude-4-sonnet" -> { provider: "anthropic", modelName: "claude-4-sonnet" }
-   *          "claude-4-sonnet" -> { provider: "anthropic", modelName: "claude-4-sonnet" } (default to anthropic)
+   * Examples: "anthropic/claude-sonnet-4" -> { provider: "anthropic", modelName: "claude-sonnet-4" }
+   *          "claude-sonnet-4" -> { provider: "anthropic", modelName: "claude-sonnet-4" } (default to anthropic)
    */
   static parseModelString(modelString) {
     if (modelString.includes("/")) {
       const [provider, ...modelParts] = modelString.split("/");
       const normalizedProvider = provider.toLowerCase();
       if (!_ModelFactory.SUPPORTED_PROVIDERS.includes(normalizedProvider)) {
-        logger5.warn(
+        logger5.error(
           { provider: normalizedProvider, modelName: modelParts.join("/") },
           "Unsupported provider detected, falling back to anthropic"
         );
-        return {
-          provider: "anthropic",
-          modelName: modelParts.join("/")
-        };
+        throw new Error(
+          `Unsupported provider: ${normalizedProvider}. Please provide a model in the format of provider/model-name.`
+        );
       }
       return {
         provider: normalizedProvider,
@@ -1173,51 +1197,9 @@ var _ModelFactory = class _ModelFactory {
         // In case model name has slashes
       };
     }
-    return {
-      provider: "anthropic",
-      modelName: modelString
-    };
-  }
-  /**
-   * Create an Anthropic model instance
-   */
-  static createAnthropicModel(modelName, providerOptions) {
-    const anthropicConfig = {};
-    if (providerOptions?.baseUrl || providerOptions?.baseURL) {
-      anthropicConfig.baseURL = providerOptions.baseUrl || providerOptions.baseURL;
-    }
-    if (providerOptions?.gateway) {
-      logger5.info(
-        { gateway: providerOptions.gateway },
-        "Setting up AI Gateway for Anthropic model"
-      );
-      Object.assign(anthropicConfig, providerOptions.gateway);
-    }
-    if (Object.keys(anthropicConfig).length > 0) {
-      logger5.info({ config: anthropicConfig }, "Applying custom Anthropic provider configuration");
-      const provider = createAnthropic(anthropicConfig);
-      return provider(modelName);
-    }
-    return anthropic(modelName);
-  }
-  /**
-   * Create an OpenAI model instance
-   */
-  static createOpenAIModel(modelName, providerOptions) {
-    const openaiConfig = {};
-    if (providerOptions?.baseUrl || providerOptions?.baseURL) {
-      openaiConfig.baseURL = providerOptions.baseUrl || providerOptions.baseURL;
-    }
-    if (providerOptions?.gateway) {
-      logger5.info({ gateway: providerOptions.gateway }, "Setting up AI Gateway for OpenAI model");
-      Object.assign(openaiConfig, providerOptions.gateway);
-    }
-    if (Object.keys(openaiConfig).length > 0) {
-      logger5.info({ config: openaiConfig }, "Applying custom OpenAI provider configuration");
-      const provider = createOpenAI(openaiConfig);
-      return provider(modelName);
-    }
-    return openai(modelName);
+    throw new Error(
+      `Invalid model provided: ${modelString}. Please provide a model in the format of provider/model-name.`
+    );
   }
   /**
    * Get generation parameters from provider options
@@ -1242,7 +1224,7 @@ var _ModelFactory = class _ModelFactory {
    * Includes maxDuration if specified in provider options (in seconds, following Vercel standard)
    */
   static prepareGenerationConfig(modelSettings) {
-    const modelString = modelSettings?.model?.trim() || "anthropic/claude-4-sonnet-20250514";
+    const modelString = modelSettings?.model?.trim();
     const model = _ModelFactory.createModel({
       model: modelString,
       providerOptions: modelSettings?.providerOptions
@@ -1283,7 +1265,7 @@ var _ModelFactory = class _ModelFactory {
 /**
  * Supported providers for security validation
  */
-__publicField(_ModelFactory, "SUPPORTED_PROVIDERS", ["anthropic", "openai"]);
+__publicField(_ModelFactory, "SUPPORTED_PROVIDERS", ["anthropic", "openai", "google"]);
 var ModelFactory = _ModelFactory;
 var tracer = getTracer("agents-run-api");
 
@@ -3349,7 +3331,7 @@ function createPropSelectorsSchema(artifactComponents) {
         Object.entries(summaryProps.properties).forEach(([propName, propDef]) => {
           const propDescription = propDef?.description || propDef?.title || `${propName} property`;
           propSchema[propName] = z4.string().describe(
-            `JMESPath selector for ${propName} (${propDescription}) - summary version, relative to base selector`
+            `JMESPath selector for ${propName} (${propDescription}) - summary version, MUST be relative to your baseSelector target level. Access fields WITHIN the items your baseSelector returns.`
           );
         });
       }
@@ -3361,7 +3343,7 @@ function createPropSelectorsSchema(artifactComponents) {
           if (!propSchema[propName]) {
             const propDescription = propDef?.description || propDef?.title || `${propName} property`;
             propSchema[propName] = z4.string().describe(
-              `JMESPath selector for ${propName} (${propDescription}) - full version, relative to base selector`
+              `JMESPath selector for ${propName} (${propDescription}) - MUST be relative to your baseSelector target level. If baseSelector stops at a document, this accesses fields WITHIN that document. Examples: "title", "content.body", "metadata.author"`
             );
           }
         });
@@ -3375,7 +3357,26 @@ function createPropSelectorsSchema(artifactComponents) {
     return z4.union(propSelectorSchemas);
   }
   return z4.record(z4.string(), z4.string()).describe(
-    "Prop selectors mapping schema properties to JMESPath expressions relative to base selector"
+    `Prop selectors mapping schema properties to JMESPath expressions relative to base selector. Each path is relative to the item(s) your baseSelector returns.
+
+\u{1F3AF} CRITICAL: PropSelectors work ONLY on the data your baseSelector returns!
+If baseSelector = "result.docs[0]" \u2192 propSelectors access fields INSIDE that doc
+If baseSelector = "result.docs[0].content[0]" \u2192 propSelectors access fields INSIDE that content item
+
+\u2705 CORRECT EXAMPLES (paths relative to baseSelector target):
+\u2022 baseSelector: "result.documents[?type=='article']" \u2192 propSelectors: {"title": "title", "url": "url"}
+\u2022 baseSelector: "result.content[0].text" \u2192 propSelectors: {"content": "content[0].text", "source": "content[0].source"}
+\u2022 baseSelector: "result.items" \u2192 propSelectors: {"name": "profile.name", "email": "contact.email"}
+
+\u274C WRONG EXAMPLES (accessing data not at baseSelector level):
+\u2022 baseSelector: "result.docs[0].content[0]" \u2192 propSelectors: {"title": "title"} \u2190 title is at doc level, not content level!
+\u2022 baseSelector: "result.source.content" \u2192 propSelectors: {"title": "content[4].text"} \u2190 baseSelector ends at array, can't index into it!
+\u2022 baseSelector: "result.items" \u2192 propSelectors: {"title": "documents[0].title"} \u2190 going deeper when baseSelector should handle depth
+
+\u274C NEVER USE LITERAL VALUES:
+{"title": "Robert Tran", "url": "https://linkedin.com/..."}
+
+\u{1F4A1} TIP: Match your baseSelector depth to where the properties you need actually exist!`
   );
 }
 function createInputSchema(artifactComponents) {
@@ -3384,7 +3385,18 @@ function createInputSchema(artifactComponents) {
       "EXACT toolCallId from a previous tool execution - copy it exactly from the tool call result. NEVER invent or make up tool call IDs."
     ),
     baseSelector: z4.string().describe(
-      `JMESPath selector to get to the main data array/object. ALWAYS start with "result." Example: "result.content[?type=='text']"`
+      `JMESPath selector to get to the main data array/object. ALWAYS start with "result." That is a mandatory prefix.
+
+Data structures are COMPLEX and NESTED. Examples:
+\u2022 "result.content[0].text.content[2]" - parsed JSON in text field
+\u2022 "result.structuredContent.content[1]" - direct structured data
+\u2022 "result.data.items[?type=='doc']" - filtered array
+
+\u{1F6A8} CRITICAL: If you need data from array[4], your baseSelector must END at array[4], NOT at the array itself!
+\u2705 CORRECT: "result.source.content[4]" \u2192 propSelectors can access fields in that item
+\u274C WRONG: "result.source.content" \u2192 propSelectors can't use content[4] because baseSelector already selected the array
+
+\u{1F525} IF YOUR PATH FAILS: READ THE ERROR MESSAGE! It tells you the correct path! \u{1F525}`
     ),
     propSelectors: createPropSelectorsSchema(artifactComponents)
   });
@@ -3403,6 +3415,9 @@ function createSaveToolResultTool(sessionId, streamRequestId, agentId, artifactC
   return tool({
     description: `Save tool results as structured artifacts. Each artifact should represent ONE SPECIFIC, IMPORTANT, and UNIQUE document or data item.
 
+\u26A1 CRITICAL: JSON-like text content in tool results is AUTOMATICALLY PARSED into proper JSON objects - treat all data as structured, not text strings.
+\u{1F6A8} CRITICAL: Data structures are deeply nested. When your path fails, READ THE ERROR MESSAGE - it shows the correct path!
+
 AVAILABLE ARTIFACT TYPES:
 ${availableTypesWithDescriptions}
 
@@ -3414,26 +3429,6 @@ Each artifact you save becomes a SEPARATE DATA COMPONENT in the structured respo
 \u2705 UNIQUE with distinct value from other artifacts
 \u2705 RENDERED AS INDIVIDUAL DATA COMPONENT in the UI
 
-\u274C DO NOT save multiple different items in one artifact unless they are EXTREMELY SIMILAR
-\u274C DO NOT batch unrelated items together - each item becomes its own data component
-\u274C DO NOT save generic collections - break them into individual data components
-
-\u{1F3AF} STRUCTURED DATA COMPONENT PRINCIPLE:
-Each artifact save creates ONE data component that will be rendered separately in the UI. If you have 5 important items, save them as 5 separate artifacts to create 5 separate data components for better user experience.
-
-THINK: "What is the ONE most important piece of information here that deserves its own data component?"
-
-EXAMPLES OF GOOD INDIVIDUAL ARTIFACTS (SEPARATE DATA COMPONENTS):
-- Nick Gomez's founder profile (specific person) \u2192 Individual data component
-- The /users/create API endpoint documentation (specific endpoint) \u2192 Individual data component  
-- Error message for authentication failure (specific error type) \u2192 Individual data component
-- Configuration for Redis caching (specific config topic) \u2192 Individual data component
-
-EXAMPLES OF BAD BATCHING:
-\u274C "All team members" \u2192 Should be separate artifacts for each important member (separate data components)
-\u274C "All API endpoints" \u2192 Should be separate artifacts for each distinct endpoint (separate data components)
-\u274C "All error types" \u2192 Should be separate artifacts for each error category (separate data components)
-
 USAGE PATTERN:
 1. baseSelector: Navigate through nested structures to target ONE SPECIFIC item
    - Navigate through all necessary levels: "result.data.items.nested[?condition]"
@@ -3443,9 +3438,11 @@ USAGE PATTERN:
    - NOT: "result.items[*]" (too broad, gets everything)
 
 2. propSelectors: Extract properties relative to your selected item
-   - Always relative to the single item that baseSelector returns
-   - Simple paths from that item: { prop1: "field_x", prop2: "nested.field_y", prop3: "deep.nested.field_z" }
-   - The tool handles array iteration - your selectors work on individual items
+   - \u{1F3AF} CRITICAL: Always relative to the single item that baseSelector returns
+   - If baseSelector ends at a document \u2192 propSelectors access document fields
+   - If baseSelector ends at content[0] \u2192 propSelectors access content[0] fields
+   - Simple paths from that exact level: { prop1: "field_x", prop2: "nested.field_y" }
+   - \u274C DON'T try to go back up or deeper - adjust your baseSelector instead!
 
 3. Result: ONE artifact representing ONE important, unique item \u2192 ONE data component
 
@@ -3454,15 +3451,7 @@ USAGE PATTERN:
 - Focus on getting to the right level with baseSelector, then keep propSelectors simple
 - Test your baseSelector: Does it return exactly the items you want?
 
-\u26A0\uFE0F  STRICT SELECTIVITY RULES FOR DATA COMPONENTS:
-- ALWAYS ask: "Is this ONE specific, important thing that deserves its own data component?"
-- If the answer is no, don't save it or find a more specific selector
-- Multiple similar items = Multiple separate artifact saves (use the tool multiple times) \u2192 Multiple data components
-- Each artifact should be independently valuable and uniquely identifiable \u2192 Each data component stands alone
-- BETTER to save 3 individual, specific artifacts (3 data components) than 1 generic collection (1 data component)
-
-\u{1F504} MULTIPLE ARTIFACTS = MULTIPLE DATA COMPONENTS:
-Remember: Each time you call this tool, you create a separate data component. Call it multiple times for multiple items to create a rich, structured response with individual data components for each important piece of information.`,
+Please use Error Messages to Debug when there is an error in the tool call.`,
     inputSchema,
     execute: async ({ toolCallId, baseSelector, propSelectors, ...rest }, _context) => {
       const artifactType = "artifactType" in rest ? rest.artifactType : void 0;
@@ -5990,7 +5979,7 @@ ${output}`;
                 { role: "user", content: userMessage },
                 ...reasoningFlow,
                 {
-                  role: "system",
+                  role: "user",
                   content: await this.buildPhase2SystemPrompt()
                 }
               ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-run-api",
-  "version": "0.0.0-dev-20250916184039",
+  "version": "0.0.0-dev-20250916192201",
   "description": "Agents Run API for Inkeep Agent Framework - handles chat, agent execution, and streaming",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,6 +11,7 @@
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
     "@ai-sdk/anthropic": "2.0.2",
+    "@ai-sdk/google": "^2.0.14",
     "@ai-sdk/openai": "2.0.11",
     "@ai-sdk/react": "2.0.11",
     "@hono/node-server": "^1.14.3",
@@ -44,7 +45,7 @@
     "traverse": "^0.6.11",
     "ts-pattern": "^5.7.1",
     "zod": "^4.1.5",
-    "@inkeep/agents-core": "^0.0.0-dev-20250916184039"
+    "@inkeep/agents-core": "^0.0.0-dev-20250916192201"
   },
   "devDependencies": {
     "@hono/vite-dev-server": "^0.20.1",