@inkeep/agents-run-api 0.2.0 → 0.2.2

package/dist/index.cjs

@@ -2,11 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var fs = require('fs');
-var path = require('path');
-var dotenv = require('dotenv');
-var z5 = require('zod');
 var agentsCore = require('@inkeep/agents-core');
+var z5 = require('zod');
 var nanoid = require('nanoid');
 var autoInstrumentationsNode = require('@opentelemetry/auto-instrumentations-node');
 var baggageSpanProcessor = require('@opentelemetry/baggage-span-processor');
@@ -30,6 +27,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');
@@ -40,27 +38,6 @@ var otel = require('@hono/otel');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-function _interopNamespace(e) {
-  if (e && e.__esModule) return e;
-  var n = Object.create(null);
-  if (e) {
-    Object.keys(e).forEach(function (k) {
-      if (k !== 'default') {
-        var d = Object.getOwnPropertyDescriptor(e, k);
-        Object.defineProperty(n, k, d.get ? d : {
-          enumerable: true,
-          get: function () { return e[k]; }
-        });
-      }
-    });
-  }
-  n.default = e;
-  return Object.freeze(n);
-}
-
-var fs__default = /*#__PURE__*/_interopDefault(fs);
-var path__default = /*#__PURE__*/_interopDefault(path);
-var dotenv__namespace = /*#__PURE__*/_interopNamespace(dotenv);
 var z5__default = /*#__PURE__*/_interopDefault(z5);
 var destr__default = /*#__PURE__*/_interopDefault(destr);
 var traverse__default = /*#__PURE__*/_interopDefault(traverse);
@@ -77,31 +54,14 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-var environmentSchema, criticalEnv, loadEnvFile, envSchema, parseEnv, env;
+var envSchema, parseEnv, env;
 var init_env = __esm({
   "src/env.ts"() {
-    dotenv__namespace.config({ quiet: true });
-    z5.z.enum(["development", "production"]).default("development");
-    environmentSchema = z5.z.enum(["development", "pentest", "production", "test"]);
-    criticalEnv = z5.z.object({
-      ENVIRONMENT: environmentSchema
-    }).parse(process.env);
-    loadEnvFile = () => {
-      const envPath = path__default.default.resolve(process.cwd(), `.env.${criticalEnv.ENVIRONMENT}.nonsecret`);
-      if (fs__default.default.existsSync(envPath)) {
-        const envConfig = dotenv__namespace.parse(fs__default.default.readFileSync(envPath));
-        for (const k in envConfig) {
-          if (!(k in process.env)) {
-            process.env[k] = envConfig[k];
-          }
-        }
-      }
-    };
-    loadEnvFile();
+    agentsCore.loadEnvironmentFiles();
     envSchema = z5.z.object({
       NODE_ENV: z5.z.enum(["development", "production", "test"]).optional(),
       ENVIRONMENT: z5.z.enum(["development", "production", "pentest", "test"]).optional().default("development"),
-      DB_FILE_NAME: z5.z.string().default("file:../local.db"),
+      DB_FILE_NAME: z5.z.string(),
       AGENTS_RUN_API_URL: z5.z.string().optional().default("http://localhost:3003"),
       LOG_LEVEL: z5.z.enum(["trace", "debug", "info", "warn", "error"]).optional().default("debug"),
       NANGO_SECRET_KEY: z5.z.string().optional(),
@@ -355,9 +315,9 @@ var sdk = new sdkNode.NodeSDK({
         requestHook: (span) => {
           const method = span.attributes?.["http.request.method"];
           const host = span.attributes?.["server.address"];
-          const path2 = span.attributes?.["url.path"];
-          if (method && path2)
-            span.updateName(host ? `${method} ${host}${path2}` : `${method} ${path2}`);
+          const path = span.attributes?.["url.path"];
+          if (method && path)
+            span.updateName(host ? `${method} ${host}${path}` : `${method} ${path}`);
         }
       }
     })
@@ -461,6 +421,7 @@ var apiKeyAuth = () => factory.createMiddleware(async (c, next) => {
       return;
     } else if (apiKey) {
       const executionContext = await extractContextFromApiKey(apiKey);
+      executionContext.agentId = agentId;
       c.set("executionContext", executionContext);
       logger.info({}, "API key authenticated successfully");
       await next();
@@ -478,12 +439,14 @@ var apiKeyAuth = () => factory.createMiddleware(async (c, next) => {
   }
   try {
     const executionContext = await extractContextFromApiKey(apiKey);
+    executionContext.agentId = agentId;
     c.set("executionContext", executionContext);
     logger.debug(
       {
         tenantId: executionContext.tenantId,
         projectId: executionContext.projectId,
-        graphId: executionContext.graphId
+        graphId: executionContext.graphId,
+        agentId: executionContext.agentId
       },
       "API key authenticated successfully"
     );
@@ -1156,6 +1119,128 @@ async function handleTasksResubscribe(c, agent, request) {
     });
   }
 }
+init_dbClient();
+agentsCore.getLogger("agents");
+function createAgentCard({
+  dbAgent,
+  baseUrl
+}) {
+  const description = dbAgent.description || "AI Agent";
+  return {
+    name: dbAgent.name,
+    description,
+    url: baseUrl ? `${baseUrl}/a2a` : "",
+    version: "1.0.0",
+    capabilities: {
+      streaming: true,
+      // Enable streaming for A2A compliance
+      pushNotifications: false,
+      stateTransitionHistory: false
+    },
+    defaultInputModes: ["text", "text/plain"],
+    defaultOutputModes: ["text", "text/plain"],
+    skills: [],
+    // Add provider info if available
+    ...baseUrl && {
+      provider: {
+        organization: "Inkeep",
+        url: baseUrl
+      }
+    }
+  };
+}
+function generateDescriptionWithTransfers(baseDescription, internalRelations, externalRelations) {
+  const transfers = [
+    ...internalRelations.filter((rel) => rel.relationType === "transfer"),
+    ...externalRelations.filter((rel) => rel.relationType === "transfer")
+  ];
+  const delegates = [
+    ...internalRelations.filter((rel) => rel.relationType === "delegate"),
+    ...externalRelations.filter((rel) => rel.relationType === "delegate")
+  ];
+  if (transfers.length === 0 && delegates.length === 0) {
+    return baseDescription;
+  }
+  let enhancedDescription = baseDescription;
+  if (transfers.length > 0) {
+    const transferList = transfers.map((rel) => {
+      const name = rel.externalAgent?.name || rel.name;
+      const desc = rel.externalAgent?.description || rel.description || "";
+      return `- ${name}: ${desc}`;
+    }).join("\n");
+    enhancedDescription += `
+
+Can transfer to:
+${transferList}`;
+  }
+  if (delegates.length > 0) {
+    const delegateList = delegates.map((rel) => {
+      const name = rel.externalAgent?.name || rel.name;
+      const desc = rel.externalAgent?.description || rel.description || "";
+      return `- ${name}: ${desc}`;
+    }).join("\n");
+    enhancedDescription += `
+
+Can delegate to:
+${delegateList}`;
+  }
+  return enhancedDescription;
+}
+async function hydrateAgent({
+  dbAgent,
+  graphId,
+  baseUrl,
+  apiKey,
+  credentialStoreRegistry
+}) {
+  try {
+    const taskHandlerConfig = await createTaskHandlerConfig({
+      tenantId: dbAgent.tenantId,
+      projectId: dbAgent.projectId,
+      graphId,
+      agentId: dbAgent.id,
+      baseUrl,
+      apiKey
+    });
+    const taskHandler = createTaskHandler(taskHandlerConfig, credentialStoreRegistry);
+    const agentCard = createAgentCard({
+      dbAgent,
+      baseUrl
+    });
+    return {
+      agentId: dbAgent.id,
+      tenantId: dbAgent.tenantId,
+      projectId: dbAgent.projectId,
+      graphId,
+      agentCard,
+      taskHandler
+    };
+  } catch (error) {
+    console.error(`\u274C Failed to hydrate agent ${dbAgent.id}:`, error);
+    throw error;
+  }
+}
+async function getRegisteredAgent(executionContext, credentialStoreRegistry) {
+  const { tenantId, projectId, graphId, agentId, baseUrl, apiKey } = executionContext;
+  if (!agentId) {
+    throw new Error("Agent ID is required");
+  }
+  const dbAgent = await agentsCore.getAgentById(dbClient_default)({
+    scopes: { tenantId, projectId },
+    agentId
+  });
+  if (!dbAgent) {
+    return null;
+  }
+  const agentFrameworkBaseUrl = `${baseUrl}/agents`;
+  return hydrateAgent({
+    dbAgent,
+    graphId,
+    baseUrl: agentFrameworkBaseUrl,
+    credentialStoreRegistry,
+    apiKey
+  });
+}
 
 // src/agents/generateTaskHandler.ts
 init_dbClient();
@@ -1199,10 +1284,10 @@ function statusUpdateOp(ctx) {
     ctx
   };
 }
-var logger3 = agentsCore.getLogger("DataComponentSchema");
+var logger4 = agentsCore.getLogger("DataComponentSchema");
 function jsonSchemaToZod(jsonSchema) {
   if (!jsonSchema || typeof jsonSchema !== "object") {
-    logger3.warn({ jsonSchema }, "Invalid JSON schema provided, using string fallback");
+    logger4.warn({ jsonSchema }, "Invalid JSON schema provided, using string fallback");
     return z5.z.string();
   }
   switch (jsonSchema.type) {
@@ -1229,7 +1314,7 @@ function jsonSchemaToZod(jsonSchema) {
     case "null":
       return z5.z.null();
     default:
-      logger3.warn(
+      logger4.warn(
         {
           unsupportedType: jsonSchema.type,
           schema: jsonSchema
@@ -1283,22 +1368,54 @@ __publicField(_ArtifactReferenceSchema, "ARTIFACT_PROPS_SCHEMA", {
   required: ["artifact_id", "task_id"]
 });
 var ArtifactReferenceSchema = _ArtifactReferenceSchema;
-var logger4 = agentsCore.getLogger("ModelFactory");
+var logger5 = agentsCore.getLogger("ModelFactory");
 var _ModelFactory = class _ModelFactory {
+  /**
+   * Create a provider instance with custom configuration
+   */
+  static createProvider(provider, config) {
+    switch (provider) {
+      case "anthropic":
+        return anthropic.createAnthropic(config);
+      case "openai":
+        return openai.createOpenAI(config);
+      case "google":
+        return google.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
    */
-  static createModel(config2) {
-    if (!config2?.model?.trim()) {
+  static createModel(config) {
+    if (!config?.model?.trim()) {
       throw new Error(
         "Model configuration is required. Please configure models at the project level."
       );
     }
-    const modelSettings = config2;
+    const modelSettings = config;
     const modelString = modelSettings.model.trim();
     const { provider, modelName } = _ModelFactory.parseModelString(modelString);
-    logger4.debug(
+    logger5.debug(
       {
         provider,
         model: modelName,
@@ -1307,49 +1424,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) {
-      logger4.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)) {
-        logger4.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,
@@ -1357,51 +1465,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) {
-      logger4.info(
-        { gateway: providerOptions.gateway },
-        "Setting up AI Gateway for Anthropic model"
-      );
-      Object.assign(anthropicConfig, providerOptions.gateway);
-    }
-    if (Object.keys(anthropicConfig).length > 0) {
-      logger4.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) {
-      logger4.info({ gateway: providerOptions.gateway }, "Setting up AI Gateway for OpenAI model");
-      Object.assign(openaiConfig, providerOptions.gateway);
-    }
-    if (Object.keys(openaiConfig).length > 0) {
-      logger4.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
@@ -1426,7 +1492,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
@@ -1443,19 +1509,19 @@ var _ModelFactory = class _ModelFactory {
    * Validate model settingsuration
    * Basic validation only - let AI SDK handle parameter-specific validation
    */
-  static validateConfig(config2) {
+  static validateConfig(config) {
     const errors = [];
-    if (!config2.model) {
+    if (!config.model) {
       errors.push("Model name is required");
     }
-    if (config2.providerOptions) {
-      if (config2.providerOptions.apiKey) {
+    if (config.providerOptions) {
+      if (config.providerOptions.apiKey) {
         errors.push(
           "API keys should not be stored in provider options. Use environment variables (ANTHROPIC_API_KEY, OPENAI_API_KEY) or credential store instead."
         );
       }
-      if (config2.providerOptions.maxDuration !== void 0) {
-        const maxDuration = config2.providerOptions.maxDuration;
+      if (config.providerOptions.maxDuration !== void 0) {
+        const maxDuration = config.providerOptions.maxDuration;
         if (typeof maxDuration !== "number" || maxDuration <= 0) {
           errors.push("maxDuration must be a positive number (in seconds)");
         }
@@ -1467,7 +1533,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
@@ -1491,7 +1557,7 @@ function unregisterStreamHelper(requestId2) {
 }
 
 // src/utils/graph-session.ts
-var logger5 = agentsCore.getLogger("GraphSession");
+var logger6 = agentsCore.getLogger("GraphSession");
 var GraphSession = class {
   // Track scheduled timeouts for cleanup
   constructor(sessionId, messageId, graphId, tenantId, projectId) {
@@ -1515,12 +1581,12 @@ var GraphSession = class {
     __publicField(this, "MAX_PENDING_ARTIFACTS", 100);
     // Prevent unbounded growth
     __publicField(this, "scheduledTimeouts");
-    logger5.debug({ sessionId, messageId, graphId }, "GraphSession created");
+    logger6.debug({ sessionId, messageId, graphId }, "GraphSession created");
   }
   /**
    * Initialize status updates for this session
    */
-  initializeStatusUpdates(config2, summarizerModel, baseModel) {
+  initializeStatusUpdates(config, summarizerModel, baseModel) {
     const now = Date.now();
     this.statusUpdateState = {
       lastUpdateTime: now,
@@ -1529,15 +1595,15 @@ var GraphSession = class {
       summarizerModel,
       baseModel,
       config: {
-        numEvents: config2.numEvents || 10,
-        timeInSeconds: config2.timeInSeconds || 30,
-        ...config2
+        numEvents: config.numEvents || 1,
+        timeInSeconds: config.timeInSeconds || 2,
+        ...config
       }
     };
     if (this.statusUpdateState.config.timeInSeconds) {
       this.statusUpdateTimer = setInterval(async () => {
         if (!this.statusUpdateState || this.isEnded) {
-          logger5.debug(
+          logger6.debug(
             { sessionId: this.sessionId },
             "Timer triggered but session already cleaned up or ended"
           );
@@ -1549,7 +1615,7 @@ var GraphSession = class {
         }
         await this.checkAndSendTimeBasedUpdate();
       }, this.statusUpdateState.config.timeInSeconds * 1e3);
-      logger5.info(
+      logger6.info(
         {
           sessionId: this.sessionId,
           intervalMs: this.statusUpdateState.config.timeInSeconds * 1e3
@@ -1563,7 +1629,7 @@ var GraphSession = class {
    */
   recordEvent(eventType, agentId, data) {
     if (this.isEnded) {
-      logger5.debug(
+      logger6.debug(
         {
           sessionId: this.sessionId,
           eventType,
@@ -1583,7 +1649,7 @@ var GraphSession = class {
     if (eventType === "artifact_saved" && data.pendingGeneration) {
       const artifactId = data.artifactId;
       if (this.pendingArtifacts.size >= this.MAX_PENDING_ARTIFACTS) {
-        logger5.warn(
+        logger6.warn(
           {
             sessionId: this.sessionId,
             artifactId,
@@ -1604,7 +1670,7 @@ var GraphSession = class {
           this.artifactProcessingErrors.set(artifactId, errorCount);
           if (errorCount >= this.MAX_ARTIFACT_RETRIES) {
             this.pendingArtifacts.delete(artifactId);
-            logger5.error(
+            logger6.error(
               {
                 sessionId: this.sessionId,
                 artifactId,
@@ -1616,7 +1682,7 @@ var GraphSession = class {
               "Artifact processing failed after max retries, giving up"
             );
           } else {
-            logger5.warn(
+            logger6.warn(
               {
                 sessionId: this.sessionId,
                 artifactId,
@@ -1638,14 +1704,14 @@ var GraphSession = class {
    */
   checkStatusUpdates() {
     if (this.isEnded) {
-      logger5.debug(
+      logger6.debug(
         { sessionId: this.sessionId },
         "Session has ended - skipping status update check"
       );
       return;
     }
     if (!this.statusUpdateState) {
-      logger5.debug({ sessionId: this.sessionId }, "No status update state - skipping check");
+      logger6.debug({ sessionId: this.sessionId }, "No status update state - skipping check");
       return;
     }
     const statusUpdateState = this.statusUpdateState;
@@ -1656,11 +1722,11 @@ var GraphSession = class {
    */
   async checkAndSendTimeBasedUpdate() {
     if (this.isEnded) {
-      logger5.debug({ sessionId: this.sessionId }, "Session has ended - skipping time-based update");
+      logger6.debug({ sessionId: this.sessionId }, "Session has ended - skipping time-based update");
       return;
     }
     if (!this.statusUpdateState) {
-      logger5.debug(
+      logger6.debug(
         { sessionId: this.sessionId },
         "No status updates configured for time-based check"
       );
@@ -1673,7 +1739,7 @@ var GraphSession = class {
     try {
       await this.generateAndSendUpdate();
     } catch (error) {
-      logger5.error(
+      logger6.error(
         {
           sessionId: this.sessionId,
           error: error instanceof Error ? error.message : "Unknown error"
@@ -1766,29 +1832,29 @@ var GraphSession = class {
    */
   async generateAndSendUpdate() {
     if (this.isEnded) {
-      logger5.debug({ sessionId: this.sessionId }, "Session has ended - not generating update");
+      logger6.debug({ sessionId: this.sessionId }, "Session has ended - not generating update");
       return;
     }
     if (this.isTextStreaming) {
-      logger5.debug(
+      logger6.debug(
         { sessionId: this.sessionId },
         "Text is currently streaming - skipping status update"
       );
       return;
     }
     if (this.isGeneratingUpdate) {
-      logger5.debug(
+      logger6.debug(
         { sessionId: this.sessionId },
         "Update already in progress - skipping duplicate generation"
       );
       return;
     }
     if (!this.statusUpdateState) {
-      logger5.warn({ sessionId: this.sessionId }, "No status update state - cannot generate update");
+      logger6.warn({ sessionId: this.sessionId }, "No status update state - cannot generate update");
       return;
     }
     if (!this.graphId) {
-      logger5.warn({ sessionId: this.sessionId }, "No graph ID - cannot generate update");
+      logger6.warn({ sessionId: this.sessionId }, "No graph ID - cannot generate update");
       return;
     }
     const newEventCount = this.events.length - this.statusUpdateState.lastEventCount;
@@ -1801,7 +1867,7 @@ var GraphSession = class {
     try {
       const streamHelper = getStreamHelper(this.sessionId);
       if (!streamHelper) {
-        logger5.warn(
+        logger6.warn(
           { sessionId: this.sessionId },
           "No stream helper found - cannot send status update"
         );
@@ -1822,7 +1888,7 @@ var GraphSession = class {
         if (result.operations && result.operations.length > 0) {
           for (const op of result.operations) {
             if (!op || !op.type || !op.data || Object.keys(op.data).length === 0) {
-              logger5.warn(
+              logger6.warn(
                 {
                   sessionId: this.sessionId,
                   operation: op
@@ -1875,7 +1941,7 @@ var GraphSession = class {
         this.previousSummaries.shift();
       }
       if (!operation || !operation.type || !operation.ctx) {
-        logger5.warn(
+        logger6.warn(
           {
             sessionId: this.sessionId,
             operation
@@ -1890,7 +1956,7 @@ var GraphSession = class {
         this.statusUpdateState.lastEventCount = this.events.length;
       }
     } catch (error) {
-      logger5.error(
+      logger6.error(
         {
           sessionId: this.sessionId,
           error: error instanceof Error ? error.message : "Unknown error",
@@ -1928,7 +1994,7 @@ var GraphSession = class {
           this.releaseUpdateLock();
         }
       } catch (error) {
-        logger5.error(
+        logger6.error(
           {
             sessionId: this.sessionId,
             error: error instanceof Error ? error.message : "Unknown error"
@@ -2005,7 +2071,7 @@ User's Question/Context:
 ${conversationHistory}
 ` : "";
             } catch (error) {
-              logger5.warn(
+              logger6.warn(
                 { sessionId: this.sessionId, error },
                 "Failed to fetch conversation history for status update"
               );
@@ -2057,7 +2123,7 @@ ${this.statusUpdateState?.config.prompt?.trim() || ""}`;
           return text.trim();
         } catch (error) {
           agentsCore.setSpanWithError(span, error);
-          logger5.error({ error }, "Failed to generate summary, using fallback");
+          logger6.error({ error }, "Failed to generate summary, using fallback");
           return this.generateFallbackSummary(newEvents, elapsedTime);
         } finally {
           span.end();
@@ -2103,7 +2169,7 @@ User's Question/Context:
 ${conversationHistory}
 ` : "";
             } catch (error) {
-              logger5.warn(
+              logger6.warn(
                 { sessionId: this.sessionId, error },
                 "Failed to fetch conversation history for structured status update"
               );
@@ -2146,9 +2212,11 @@ Rules:
 - Labels MUST contain the ACTUAL information discovered ("Found X", "Learned Y", "Discovered Z requires A")
 - DO NOT use action words like "Searching", "Processing", "Analyzing" - state what was FOUND
 - Include specific details, numbers, requirements, or insights discovered
-- You are ONE AI (no agents/delegations)
-- Anonymize all internal operations so that the information appears descriptive and USER FRIENDLY. HIDE INTERNAL OPERATIONS!
-- Bad examples: "Searching docs", "Processing request", "Status update", or not using the no_relevant_updates: e.g. "No New Updates", "No new info to report"
+- You are ONE unified AI system - NEVER mention agents, transfers, delegations, or routing
+- CRITICAL: NEVER use the words "transfer", "delegation", "agent", "routing", or any internal system terminology in labels
+- Present all operations as seamless actions by a single system
+- Anonymize all internal operations so that the information appears descriptive and USER FRIENDLY. HIDE ALL INTERNAL OPERATIONS!
+- Bad examples: "Transferring to search agent", "Delegating task", "Routing request", "Processing request", or not using the no_relevant_updates
 - Good examples: "Slack bot needs admin privileges", "Found 3-step OAuth flow required", "Channel limit is 500 per workspace", or use the no_relevant_updates component if nothing new to report.
 
 REMEMBER YOU CAN ONLY USE 'no_relevant_updates' ALONE! IT CANNOT BE CONCATENATED WITH OTHER STATUS UPDATES!
@@ -2202,7 +2270,7 @@ ${this.statusUpdateState?.config.prompt?.trim() || ""}`;
           return { operations };
         } catch (error) {
           agentsCore.setSpanWithError(span, error);
-          logger5.error({ error }, "Failed to generate structured update, using fallback");
+          logger6.error({ error }, "Failed to generate structured update, using fallback");
           return { operations: [] };
         } finally {
           span.end();
@@ -2309,8 +2377,7 @@ ${this.statusUpdateState?.config.prompt?.trim() || ""}`;
         case "transfer": {
           const data = event.data;
           activities.push(
-            `\u{1F504} **Transfer**: ${data.fromAgent} \u2192 ${data.targetAgent}
-   ${data.reason ? `Reason: ${data.reason}` : "Control transfer"}
+            `\u{1F504} **Continuing**: ${data.reason || "Processing request"}
    ${data.context ? `Context: ${JSON.stringify(data.context, null, 2)}` : ""}`
           );
           break;
@@ -2318,8 +2385,7 @@ ${this.statusUpdateState?.config.prompt?.trim() || ""}`;
         case "delegation_sent": {
           const data = event.data;
           activities.push(
-            `\u{1F4E4} **Delegation Sent** [${data.delegationId}]: ${data.fromAgent} \u2192 ${data.targetAgent}
-   Task: ${data.taskDescription}
+            `\u{1F4E4} **Processing**: ${data.taskDescription}
    ${data.context ? `Context: ${JSON.stringify(data.context, null, 2)}` : ""}`
           );
           break;
@@ -2327,7 +2393,7 @@ ${this.statusUpdateState?.config.prompt?.trim() || ""}`;
         case "delegation_returned": {
           const data = event.data;
           activities.push(
-            `\u{1F4E5} **Delegation Returned** [${data.delegationId}]: ${data.fromAgent} \u2190 ${data.targetAgent}
+            `\u{1F4E5} **Completed subtask**
    Result: ${JSON.stringify(data.result, null, 2)}`
           );
           break;
@@ -2346,16 +2412,16 @@ ${this.statusUpdateState?.config.prompt?.trim() || ""}`;
         case "agent_reasoning": {
           const data = event.data;
           activities.push(
-            `\u2699\uFE0F **Reasoning**: reasoning
-   Full Details: ${JSON.stringify(data.parts, null, 2)}`
+            `\u2699\uFE0F **Analyzing request**
+   Details: ${JSON.stringify(data.parts, null, 2)}`
           );
           break;
         }
         case "agent_generate": {
           const data = event.data;
           activities.push(
-            `\u2699\uFE0F **Generation**: ${data.generationType}
-   Full Details: ${JSON.stringify(data.parts, null, 2)}`
+            `\u2699\uFE0F **Preparing response**
+   Details: ${JSON.stringify(data.parts, null, 2)}`
           );
           break;
         }
@@ -2529,7 +2595,7 @@ Make it specific and relevant.`;
             taskId: artifactData.taskId,
             artifacts: [artifactToSave]
           });
-          logger5.info(
+          logger6.info(
             {
               sessionId: this.sessionId,
               artifactId: artifactData.artifactId,
@@ -2546,7 +2612,7 @@ Make it specific and relevant.`;
           span.setStatus({ code: api.SpanStatusCode.OK });
         } catch (error) {
           agentsCore.setSpanWithError(span, error);
-          logger5.error(
+          logger6.error(
             {
               sessionId: this.sessionId,
               artifactId: artifactData.artifactId,
@@ -2582,7 +2648,7 @@ Make it specific and relevant.`;
                 taskId: artifactData.taskId,
                 artifacts: [fallbackArtifact]
               });
-              logger5.info(
+              logger6.info(
                 {
                   sessionId: this.sessionId,
                   artifactId: artifactData.artifactId
@@ -2591,7 +2657,7 @@ Make it specific and relevant.`;
               );
             }
           } catch (fallbackError) {
-            logger5.error(
+            logger6.error(
               {
                 sessionId: this.sessionId,
                 artifactId: artifactData.artifactId,
@@ -2618,18 +2684,18 @@ var GraphSessionManager = class {
     const sessionId = messageId;
     const session = new GraphSession(sessionId, messageId, graphId, tenantId, projectId);
     this.sessions.set(sessionId, session);
-    logger5.info({ sessionId, messageId, graphId, tenantId, projectId }, "GraphSession created");
+    logger6.info({ sessionId, messageId, graphId, tenantId, projectId }, "GraphSession created");
     return sessionId;
   }
   /**
    * Initialize status updates for a session
    */
-  initializeStatusUpdates(sessionId, config2, summarizerModel) {
+  initializeStatusUpdates(sessionId, config, summarizerModel) {
     const session = this.sessions.get(sessionId);
     if (session) {
-      session.initializeStatusUpdates(config2, summarizerModel);
+      session.initializeStatusUpdates(config, summarizerModel);
     } else {
-      logger5.error(
+      logger6.error(
         {
           sessionId,
           availableSessions: Array.from(this.sessions.keys())
@@ -2650,7 +2716,7 @@ var GraphSessionManager = class {
   recordEvent(sessionId, eventType, agentId, data) {
     const session = this.sessions.get(sessionId);
     if (!session) {
-      logger5.warn({ sessionId }, "Attempted to record event in non-existent session");
+      logger6.warn({ sessionId }, "Attempted to record event in non-existent session");
       return;
     }
     session.recordEvent(eventType, agentId, data);
@@ -2661,12 +2727,12 @@ var GraphSessionManager = class {
   endSession(sessionId) {
     const session = this.sessions.get(sessionId);
     if (!session) {
-      logger5.warn({ sessionId }, "Attempted to end non-existent session");
+      logger6.warn({ sessionId }, "Attempted to end non-existent session");
       return [];
     }
     const events = session.getEvents();
     const summary = session.getSummary();
-    logger5.info({ sessionId, summary }, "GraphSession ended");
+    logger6.info({ sessionId, summary }, "GraphSession ended");
     session.cleanup();
     this.sessions.delete(sessionId);
     return events;
@@ -2695,7 +2761,7 @@ var graphSessionManager = new GraphSessionManager();
 
 // src/utils/artifact-parser.ts
 init_dbClient();
-var logger6 = agentsCore.getLogger("ArtifactParser");
+var logger7 = agentsCore.getLogger("ArtifactParser");
 var _ArtifactParser = class _ArtifactParser {
   constructor(tenantId) {
     this.tenantId = tenantId;
@@ -2711,9 +2777,7 @@ var _ArtifactParser = class _ArtifactParser {
    * More robust detection that handles streaming fragments
    */
   hasIncompleteArtifact(text) {
-    return /^.*<(?:artifact(?::ref)?|a(?:r(?:t(?:i(?:f(?:a(?:c(?:t(?::(?:r(?:e(?:f)?)?)?)?)?)?)?)?)?)?)?)?$/.test(
-      text
-    ) || /^.*<artifact:ref(?:[^>]*)$/.test(text) || // Incomplete artifact:ref at end
+    return /<(a(r(t(i(f(a(c(t(:?(r(e(f)?)?)?)?)?)?)?)?)?)?)?)?$/.test(text) || /<artifact:ref[^>]+$/.test(text) || // Incomplete artifact ref at end
     this.findSafeTextBoundary(text) < text.length;
   }
   /**
@@ -2722,10 +2786,10 @@ var _ArtifactParser = class _ArtifactParser {
    */
   findSafeTextBoundary(text) {
     const endPatterns = [
-      /^.*<artifact:ref(?:[^/>]+(?:[^>]*[^/])?)?$/,
+      /<artifact:ref(?![^>]*\/>).*$/,
       // artifact:ref that doesn't end with />
-      /^.*<(?:artifact(?::ref)?|a(?:r(?:t(?:i(?:f(?:a(?:c(?:t(?::(?:r(?:e(?:f)?)?)?)?)?)?)?)?)?)?)?)?$/
-      // Safe partial artifact pattern
+      /<(a(r(t(i(f(a(c(t(:?(r(e(f)?)?)?)?)?)?)?)?)?)?)?)?$/
+      // Any partial artifact pattern at end
     ];
     for (const pattern of endPatterns) {
       const match = text.match(pattern);
@@ -2761,7 +2825,7 @@ var _ArtifactParser = class _ArtifactParser {
           id: taskId
         });
         if (!task) {
-          logger6.warn({ taskId }, "Task not found when fetching artifacts");
+          logger7.warn({ taskId }, "Task not found when fetching artifacts");
           continue;
         }
         const taskArtifacts = await agentsCore.getLedgerArtifacts(dbClient_default)({
@@ -2773,9 +2837,9 @@ var _ArtifactParser = class _ArtifactParser {
           artifacts.set(key, artifact);
         }
       }
-      logger6.debug({ contextId, count: artifacts.size }, "Loaded context artifacts");
+      logger7.debug({ contextId, count: artifacts.size }, "Loaded context artifacts");
     } catch (error) {
-      logger6.error({ error, contextId }, "Error loading context artifacts");
+      logger7.error({ error, contextId }, "Error loading context artifacts");
     }
     return artifacts;
   }
@@ -2878,7 +2942,7 @@ var _ArtifactParser = class _ArtifactParser {
         id: taskId
       });
       if (!task) {
-        logger6.warn({ taskId }, "Task not found when fetching artifact");
+        logger7.warn({ taskId }, "Task not found when fetching artifact");
         return null;
       }
       const artifacts = await agentsCore.getLedgerArtifacts(dbClient_default)({
@@ -2890,7 +2954,7 @@ var _ArtifactParser = class _ArtifactParser {
         return this.formatArtifactData(artifacts[0], artifactId, taskId);
       }
     } catch (error) {
-      logger6.warn({ artifactId, taskId, error }, "Failed to fetch artifact");
+      logger7.warn({ artifactId, taskId, error }, "Failed to fetch artifact");
     }
     return null;
   }
@@ -2926,11 +2990,11 @@ var _ArtifactParser = class _ArtifactParser {
 __publicField(_ArtifactParser, "ARTIFACT_REGEX", /<artifact:ref\s+id="([^"]*?)"\s+task="([^"]*?)"\s*\/>/gs);
 __publicField(_ArtifactParser, "ARTIFACT_CHECK_REGEX", /<artifact:ref\s+(?=.*id="[^"]+")(?=.*task="[^"]+")[^>]*\/>/);
 // Regex for catching any partial artifact pattern (< + any prefix of "artifact:ref")
-__publicField(_ArtifactParser, "INCOMPLETE_ARTIFACT_REGEX", /<(a(r(t(i(f(a(c(t(:(r(e(f?)?)?)?)?)?)?)?)?)?)?)?)?$/g);
+__publicField(_ArtifactParser, "INCOMPLETE_ARTIFACT_REGEX", /<(a(r(t(i(f(a(c(t(:?(r(e(f)?)?)?)?)?)?)?)?)?)?)?)?$/g);
 var ArtifactParser = _ArtifactParser;
 
 // src/utils/incremental-stream-parser.ts
-var logger7 = agentsCore.getLogger("IncrementalStreamParser");
+var logger8 = agentsCore.getLogger("IncrementalStreamParser");
 var IncrementalStreamParser = class {
   constructor(streamHelper, tenantId, contextId) {
     __publicField(this, "buffer", "");
@@ -2990,13 +3054,19 @@ var IncrementalStreamParser = class {
       if (part.type === "tool-call-delta" && part.toolName === targetToolName) {
         const delta = part.argsTextDelta || "";
         if (jsonBuffer.length + delta.length > MAX_BUFFER_SIZE) {
-          logger7.warn({ bufferSize: jsonBuffer.length + delta.length, maxSize: MAX_BUFFER_SIZE }, "JSON buffer exceeded maximum size, truncating");
+          logger8.warn(
+            { bufferSize: jsonBuffer.length + delta.length, maxSize: MAX_BUFFER_SIZE },
+            "JSON buffer exceeded maximum size, truncating"
+          );
           jsonBuffer = jsonBuffer.slice(-MAX_BUFFER_SIZE / 2);
         }
         jsonBuffer += delta;
         for (const char of delta) {
           if (componentBuffer.length > MAX_BUFFER_SIZE) {
-            logger7.warn({ bufferSize: componentBuffer.length, maxSize: MAX_BUFFER_SIZE }, "Component buffer exceeded maximum size, resetting");
+            logger8.warn(
+              { bufferSize: componentBuffer.length, maxSize: MAX_BUFFER_SIZE },
+              "Component buffer exceeded maximum size, resetting"
+            );
             componentBuffer = "";
             depth = 0;
             continue;
@@ -3011,7 +3081,7 @@ var IncrementalStreamParser = class {
               if (componentMatch) {
                 const MAX_COMPONENT_SIZE = 1024 * 1024;
                 if (componentMatch[0].length > MAX_COMPONENT_SIZE) {
-                  logger7.warn(
+                  logger8.warn(
                     {
                       size: componentMatch[0].length,
                       maxSize: MAX_COMPONENT_SIZE
@@ -3024,7 +3094,7 @@ var IncrementalStreamParser = class {
                 try {
                   const component = JSON.parse(componentMatch[0]);
                   if (typeof component !== "object" || !component.id) {
-                    logger7.warn({ component }, "Invalid component structure, skipping");
+                    logger8.warn({ component }, "Invalid component structure, skipping");
                     componentBuffer = "";
                     continue;
                   }
@@ -3037,7 +3107,7 @@ var IncrementalStreamParser = class {
                   componentsStreamed++;
                   componentBuffer = "";
                 } catch (e) {
-                  logger7.debug({ error: e }, "Failed to parse component, continuing to accumulate");
+                  logger8.debug({ error: e }, "Failed to parse component, continuing to accumulate");
                 }
               }
             }
@@ -3054,7 +3124,7 @@ var IncrementalStreamParser = class {
         break;
       }
     }
-    logger7.debug({ componentsStreamed }, "Finished streaming components");
+    logger8.debug({ componentsStreamed }, "Finished streaming components");
   }
   /**
    * Legacy method for backward compatibility - defaults to text processing
@@ -3198,7 +3268,7 @@ var IncrementalStreamParser = class {
 };
 
 // src/utils/response-formatter.ts
-var logger8 = agentsCore.getLogger("ResponseFormatter");
+var logger9 = agentsCore.getLogger("ResponseFormatter");
 var ResponseFormatter = class {
   constructor(tenantId) {
     __publicField(this, "artifactParser");
@@ -3229,7 +3299,7 @@ var ResponseFormatter = class {
         return { parts };
       } catch (error) {
         agentsCore.setSpanWithError(span, error);
-        logger8.error({ error, responseObject }, "Error formatting object response");
+        logger9.error({ error, responseObject }, "Error formatting object response");
         return {
           parts: [{ kind: "data", data: responseObject }]
         };
@@ -3280,7 +3350,7 @@ var ResponseFormatter = class {
         return { parts };
       } catch (error) {
         agentsCore.setSpanWithError(span, error);
-        logger8.error({ error, responseText }, "Error formatting response");
+        logger9.error({ error, responseText }, "Error formatting response");
         return { text: responseText };
       } finally {
         span.end();
@@ -3325,7 +3395,7 @@ var ResponseFormatter = class {
     }
   }
 };
-var logger9 = agentsCore.getLogger("ToolSessionManager");
+var logger10 = agentsCore.getLogger("ToolSessionManager");
 var _ToolSessionManager = class _ToolSessionManager {
   // 5 minutes
   constructor() {
@@ -3354,7 +3424,7 @@ var _ToolSessionManager = class _ToolSessionManager {
       createdAt: Date.now()
     };
     this.sessions.set(sessionId, session);
-    logger9.debug({ sessionId, tenantId, contextId, taskId }, "Created tool session");
+    logger10.debug({ sessionId, tenantId, contextId, taskId }, "Created tool session");
     return sessionId;
   }
   /**
@@ -3363,7 +3433,7 @@ var _ToolSessionManager = class _ToolSessionManager {
   recordToolResult(sessionId, toolResult) {
     const session = this.sessions.get(sessionId);
     if (!session) {
-      logger9.warn(
+      logger10.warn(
         { sessionId, toolCallId: toolResult.toolCallId },
         "Tool result recorded for unknown session"
       );
@@ -3377,12 +3447,12 @@ var _ToolSessionManager = class _ToolSessionManager {
   getToolResult(sessionId, toolCallId) {
     const session = this.sessions.get(sessionId);
     if (!session) {
-      logger9.warn({ sessionId, toolCallId }, "Requested tool result for unknown session");
+      logger10.warn({ sessionId, toolCallId }, "Requested tool result for unknown session");
       return void 0;
     }
     const result = session.toolResults.get(toolCallId);
     if (!result) {
-      logger9.warn(
+      logger10.warn(
         {
           sessionId,
           toolCallId,
@@ -3421,10 +3491,10 @@ var _ToolSessionManager = class _ToolSessionManager {
     }
     for (const sessionId of expiredSessions) {
       this.sessions.delete(sessionId);
-      logger9.debug({ sessionId }, "Cleaned up expired tool session");
+      logger10.debug({ sessionId }, "Cleaned up expired tool session");
     }
     if (expiredSessions.length > 0) {
-      logger9.info({ expiredCount: expiredSessions.length }, "Cleaned up expired tool sessions");
+      logger10.info({ expiredCount: expiredSessions.length }, "Cleaned up expired tool sessions");
     }
   }
 };
@@ -3433,7 +3503,7 @@ var ToolSessionManager = _ToolSessionManager;
 var toolSessionManager = ToolSessionManager.getInstance();
 
 // src/agents/artifactTools.ts
-var logger10 = agentsCore.getLogger("artifactTools");
+var logger11 = agentsCore.getLogger("artifactTools");
 function buildKeyNestingMap(data, prefix = "", map = /* @__PURE__ */ new Map()) {
   if (typeof data === "object" && data !== null) {
     if (Array.isArray(data)) {
@@ -3487,7 +3557,7 @@ function analyzeSelectorFailure(data, selector) {
           if (keyNestingMap.has(part)) {
             const allPaths = keyNestingMap.get(part);
             const relevantPaths = allPaths.filter(
-              (path2) => path2.includes(validPath) || validPath === ""
+              (path) => path.includes(validPath) || validPath === ""
             );
             if (relevantPaths.length > 0) {
               suggestions.push(`"${part}" exists at: ${relevantPaths.slice(0, 3).join(", ")}`);
@@ -3504,7 +3574,7 @@ function analyzeSelectorFailure(data, selector) {
       analysis.push("PATH VALID BUT FILTER FAILED");
       const allPaths = keyNestingMap.get(targetKey);
       const deeperPaths = allPaths.filter(
-        (path2) => path2.length > selector.replace(/\[.*?\]/g, "").length
+        (path) => path.length > selector.replace(/\[.*?\]/g, "").length
       );
       if (deeperPaths.length > 0) {
         suggestions.push(
@@ -3536,7 +3606,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.`
           );
         });
       }
@@ -3548,7 +3618,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"`
             );
           }
         });
@@ -3562,7 +3632,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) {
@@ -3571,7 +3660,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)
   });
@@ -3590,6 +3690,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}
 
@@ -3601,26 +3704,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]"
@@ -3630,9 +3713,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
 
@@ -3641,20 +3726,12 @@ 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;
       if (!sessionId) {
-        logger10.warn({ toolCallId }, "No session ID provided to save_tool_result");
+        logger11.warn({ toolCallId }, "No session ID provided to save_tool_result");
         return {
           saved: false,
           error: `[toolCallId: ${toolCallId}] No session context available`,
@@ -3664,7 +3741,7 @@ Remember: Each time you call this tool, you create a separate data component. Ca
       }
       const toolResult = toolSessionManager.getToolResult(sessionId, toolCallId);
       if (!toolResult) {
-        logger10.warn({ toolCallId, sessionId }, "Tool result not found in session");
+        logger11.warn({ toolCallId, sessionId }, "Tool result not found in session");
         return {
           saved: false,
           error: `[toolCallId: ${toolCallId}] Tool result not found`,
@@ -3677,7 +3754,7 @@ Remember: Each time you call this tool, you create a separate data component. Ca
         const baseData = jmespath__default.default.search(parsedResult, baseSelector);
         if (!baseData || Array.isArray(baseData) && baseData.length === 0) {
           const debugInfo = analyzeSelectorFailure(parsedResult, baseSelector);
-          logger10.warn(
+          logger11.warn(
             {
               baseSelector,
               toolCallId,
@@ -3720,7 +3797,7 @@ Remember: Each time you call this tool, you create a separate data component. Ca
                     const fallbackValue = item[propName];
                     if (fallbackValue !== null && fallbackValue !== void 0) {
                       extractedItem[propName] = fallbackValue;
-                      logger10.info(
+                      logger11.info(
                         { propName, propSelector, context },
                         `PropSelector failed, used fallback direct property access`
                       );
@@ -3732,7 +3809,7 @@ Remember: Each time you call this tool, you create a separate data component. Ca
                   const fallbackValue = item[propName];
                   if (fallbackValue !== null && fallbackValue !== void 0) {
                     extractedItem[propName] = fallbackValue;
-                    logger10.warn(
+                    logger11.warn(
                       { propName, propSelector, context, error: error.message },
                       `PropSelector syntax error, used fallback direct property access`
                     );
@@ -3845,7 +3922,7 @@ Remember: Each time you call this tool, you create a separate data component. Ca
           warnings
         };
       } catch (error) {
-        logger10.error({ error, toolCallId, sessionId }, "Error processing save_tool_result");
+        logger11.error({ error, toolCallId, sessionId }, "Error processing save_tool_result");
         return {
           saved: false,
           error: `[toolCallId: ${toolCallId}] ${error instanceof Error ? error.message : "Unknown error"}`,
@@ -3857,7 +3934,7 @@ Remember: Each time you call this tool, you create a separate data component. Ca
 }
 
 // src/a2a/client.ts
-var logger11 = agentsCore.getLogger("a2aClient");
+var logger12 = agentsCore.getLogger("a2aClient");
 var DEFAULT_BACKOFF = {
   initialInterval: 500,
   maxInterval: 6e4,
@@ -3998,17 +4075,17 @@ var A2AClient = class {
    * Retry utility functions
    */
   async retry(fetchFn) {
-    const config2 = this.options.retryConfig;
-    if (!config2 || config2.strategy === "none") {
+    const config = this.options.retryConfig;
+    if (!config || config.strategy === "none") {
       return await fetchFn();
     }
-    const statusCodes = config2.statusCodes || DEFAULT_RETRY_STATUS_CODES;
+    const statusCodes = config.statusCodes || DEFAULT_RETRY_STATUS_CODES;
     return this.retryBackoff(
       this.wrapFetcher(fetchFn, {
         statusCodes,
-        retryConnectionErrors: !!config2.retryConnectionErrors
+        retryConnectionErrors: !!config.retryConnectionErrors
       }),
-      config2.backoff ?? DEFAULT_BACKOFF
+      config.backoff ?? DEFAULT_BACKOFF
     );
   }
   wrapFetcher(fn, options) {
@@ -4063,7 +4140,7 @@ var A2AClient = class {
       try {
         const res = await fn();
         if (attempt > 0) {
-          logger11.info(
+          logger12.info(
             {
               attempts: attempt + 1,
               elapsedTime: Date.now() - start
@@ -4078,7 +4155,7 @@ var A2AClient = class {
         }
         const elapsed = Date.now() - start;
         if (elapsed > maxElapsedTime) {
-          logger11.warn(
+          logger12.warn(
             {
               attempts: attempt + 1,
               elapsedTime: elapsed,
@@ -4099,7 +4176,7 @@ var A2AClient = class {
           retryInterval = initialInterval * attempt ** exponent + Math.random() * 1e3;
         }
         const delayMs = Math.min(retryInterval, maxInterval);
-        logger11.info(
+        logger12.info(
           {
             attempt: attempt + 1,
             delayMs,
@@ -4184,7 +4261,7 @@ var A2AClient = class {
     }
     const rpcResponse = await httpResponse.json();
     if (rpcResponse.id !== requestId2) {
-      logger11.warn(
+      logger12.warn(
         {
           method,
           expectedId: requestId2,
@@ -4383,7 +4460,7 @@ var A2AClient = class {
     try {
       while (true) {
         const { done, value } = await reader.read();
-        logger11.info({ done, value }, "parseA2ASseStream");
+        logger12.info({ done, value }, "parseA2ASseStream");
         if (done) {
           if (eventDataBuffer.trim()) {
             const result = this._processSseEventData(
@@ -4472,26 +4549,26 @@ var A2AClient = class {
 // src/agents/relationTools.ts
 init_conversations();
 init_dbClient();
-var logger12 = agentsCore.getLogger("relationships Tools");
-var generateTransferToolDescription = (config2) => {
-  return `Hand off the conversation to agent ${config2.id}.
+var logger13 = agentsCore.getLogger("relationships Tools");
+var generateTransferToolDescription = (config) => {
+  return `Hand off the conversation to agent ${config.id}.
 
 Agent Information:
-- ID: ${config2.id}
-- Name: ${config2.name ?? "No name provided"}
-- Description: ${config2.description ?? "No description provided"}
+- ID: ${config.id}
+- Name: ${config.name ?? "No name provided"}
+- Description: ${config.description ?? "No description provided"}
 
-Hand off the conversation to agent ${config2.id} when the user's request would be better handled by this specialized agent.`;
+Hand off the conversation to agent ${config.id} when the user's request would be better handled by this specialized agent.`;
 };
-var generateDelegateToolDescription = (config2) => {
+var generateDelegateToolDescription = (config) => {
   return `Delegate a specific task to another agent.
 
 Agent Information:
-- ID: ${config2.id}
-- Name: ${config2.name}
-- Description: ${config2.description || "No description provided"}
+- ID: ${config.id}
+- Name: ${config.name}
+- Description: ${config.description || "No description provided"}
 
-Delegate a specific task to agent ${config2.id} when it seems like the agent can do relevant work.`;
+Delegate a specific task to agent ${config.id} when it seems like the agent can do relevant work.`;
 };
 var createTransferToAgentTool = ({
   transferConfig,
@@ -4510,7 +4587,7 @@ var createTransferToAgentTool = ({
           "transfer.to_agent_id": transferConfig.id ?? "unknown"
         });
       }
-      logger12.info(
+      logger13.info(
         {
           transferTo: transferConfig.id ?? "unknown",
           fromAgent: callingAgentId
@@ -4658,7 +4735,7 @@ function createDelegateToAgentTool({
           ...isInternal ? { fromAgentId: callingAgentId } : { fromExternalAgentId: callingAgentId }
         }
       };
-      logger12.info({ messageToSend }, "messageToSend");
+      logger13.info({ messageToSend }, "messageToSend");
       await agentsCore.createMessage(dbClient_default)({
         id: nanoid.nanoid(),
         tenantId,
@@ -4720,7 +4797,7 @@ function createDelegateToAgentTool({
 }
 
 // src/agents/SystemPromptBuilder.ts
-var logger13 = agentsCore.getLogger("SystemPromptBuilder");
+var logger14 = agentsCore.getLogger("SystemPromptBuilder");
 var SystemPromptBuilder = class {
   constructor(version, versionConfig) {
     this.version = version;
@@ -4736,22 +4813,25 @@ var SystemPromptBuilder = class {
         this.templates.set(name, content);
       }
       this.loaded = true;
-      logger13.debug({ templateCount: this.templates.size, version: this.version }, `Loaded ${this.templates.size} templates for version ${this.version}`);
+      logger14.debug(
+        { templateCount: this.templates.size, version: this.version },
+        `Loaded ${this.templates.size} templates for version ${this.version}`
+      );
     } catch (error) {
-      logger13.error({ error }, `Failed to load templates for version ${this.version}`);
+      logger14.error({ error }, `Failed to load templates for version ${this.version}`);
       throw new Error(`Template loading failed: ${error}`);
     }
   }
-  buildSystemPrompt(config2) {
+  buildSystemPrompt(config) {
     this.loadTemplates();
-    this.validateTemplateVariables(config2);
-    return this.versionConfig.assemble(this.templates, config2);
+    this.validateTemplateVariables(config);
+    return this.versionConfig.assemble(this.templates, config);
   }
-  validateTemplateVariables(config2) {
-    if (!config2) {
+  validateTemplateVariables(config) {
+    if (!config) {
       throw new Error("Configuration object is required");
     }
-    if (typeof config2 !== "object") {
+    if (typeof config !== "object") {
       throw new Error("Configuration must be an object");
     }
   }
@@ -4864,20 +4944,20 @@ var V1Config = class _V1Config {
     const firstItem = tools[0];
     return "usageGuidelines" in firstItem && !("config" in firstItem);
   }
-  assemble(templates, config2) {
+  assemble(templates, config) {
     const systemPromptTemplate = templates.get("system-prompt");
     if (!systemPromptTemplate) {
       throw new Error("System prompt template not loaded");
     }
     let systemPrompt = systemPromptTemplate;
-    systemPrompt = systemPrompt.replace("{{CORE_INSTRUCTIONS}}", config2.corePrompt);
-    const graphContextSection = this.generateGraphContextSection(config2.graphPrompt);
+    systemPrompt = systemPrompt.replace("{{CORE_INSTRUCTIONS}}", config.corePrompt);
+    const graphContextSection = this.generateGraphContextSection(config.graphPrompt);
     systemPrompt = systemPrompt.replace("{{GRAPH_CONTEXT_SECTION}}", graphContextSection);
-    const toolData = this.isToolDataArray(config2.tools) ? config2.tools : _V1Config.convertMcpToolsToToolData(config2.tools);
-    const hasDataComponents = config2.dataComponents && config2.dataComponents.length > 0;
+    const toolData = this.isToolDataArray(config.tools) ? config.tools : _V1Config.convertMcpToolsToToolData(config.tools);
+    const hasDataComponents = config.dataComponents && config.dataComponents.length > 0;
     const artifactsSection = this.generateArtifactsSection(
       templates,
-      config2.artifacts,
+      config.artifacts,
       hasDataComponents
     );
     systemPrompt = systemPrompt.replace("{{ARTIFACTS_SECTION}}", artifactsSection);
@@ -4885,20 +4965,20 @@ var V1Config = class _V1Config {
     systemPrompt = systemPrompt.replace("{{TOOLS_SECTION}}", toolsSection);
     const dataComponentsSection = this.generateDataComponentsSection(
       templates,
-      config2.dataComponents
+      config.dataComponents
     );
     systemPrompt = systemPrompt.replace("{{DATA_COMPONENTS_SECTION}}", dataComponentsSection);
     const thinkingPreparationSection = this.generateThinkingPreparationSection(
       templates,
-      config2.isThinkingPreparation
+      config.isThinkingPreparation
     );
     systemPrompt = systemPrompt.replace(
       "{{THINKING_PREPARATION_INSTRUCTIONS}}",
       thinkingPreparationSection
     );
-    const transferSection = this.generateTransferInstructions(config2.hasTransferRelations);
+    const transferSection = this.generateTransferInstructions(config.hasTransferRelations);
     systemPrompt = systemPrompt.replace("{{TRANSFER_INSTRUCTIONS}}", transferSection);
-    const delegationSection = this.generateDelegationInstructions(config2.hasDelegateRelations);
+    const delegationSection = this.generateDelegationInstructions(config.hasDelegateRelations);
     systemPrompt = systemPrompt.replace("{{DELEGATION_INSTRUCTIONS}}", delegationSection);
     return systemPrompt;
   }
@@ -5140,7 +5220,7 @@ function hasToolCallWithPrefix(prefix) {
     return false;
   };
 }
-var logger14 = agentsCore.getLogger("Agent");
+var logger15 = agentsCore.getLogger("Agent");
 var CONSTANTS = {
   MAX_GENERATION_STEPS: 12,
   PHASE_1_TIMEOUT_MS: 27e4,
@@ -5162,7 +5242,7 @@ function isValidTool(tool4) {
   return tool4 && typeof tool4 === "object" && typeof tool4.description === "string" && tool4.inputSchema && typeof tool4.execute === "function";
 }
 var Agent = class {
-  constructor(config2, credentialStoreRegistry) {
+  constructor(config, credentialStoreRegistry) {
     __publicField(this, "config");
     __publicField(this, "systemPromptBuilder", new SystemPromptBuilder("v1", new V1Config()));
     __publicField(this, "responseFormatter");
@@ -5174,26 +5254,26 @@ var Agent = class {
     __publicField(this, "isDelegatedAgent", false);
     __publicField(this, "contextResolver");
     __publicField(this, "credentialStoreRegistry");
-    this.artifactComponents = config2.artifactComponents || [];
-    let processedDataComponents = config2.dataComponents || [];
-    if (this.artifactComponents.length > 0 && config2.dataComponents && config2.dataComponents.length > 0) {
+    this.artifactComponents = config.artifactComponents || [];
+    let processedDataComponents = config.dataComponents || [];
+    if (this.artifactComponents.length > 0 && config.dataComponents && config.dataComponents.length > 0) {
       processedDataComponents = [
-        ArtifactReferenceSchema.getDataComponent(config2.tenantId, config2.projectId),
+        ArtifactReferenceSchema.getDataComponent(config.tenantId, config.projectId),
         ...processedDataComponents
       ];
     }
     this.config = {
-      ...config2,
+      ...config,
       dataComponents: processedDataComponents,
       // Set default conversation history if not provided
-      conversationHistoryConfig: config2.conversationHistoryConfig || createDefaultConversationHistoryConfig()
+      conversationHistoryConfig: config.conversationHistoryConfig || createDefaultConversationHistoryConfig()
     };
-    this.responseFormatter = new ResponseFormatter(config2.tenantId);
+    this.responseFormatter = new ResponseFormatter(config.tenantId);
     this.credentialStoreRegistry = credentialStoreRegistry;
     if (credentialStoreRegistry) {
       this.contextResolver = new agentsCore.ContextResolver(
-        config2.tenantId,
-        config2.projectId,
+        config.tenantId,
+        config.projectId,
         dbClient_default,
         credentialStoreRegistry
       );
@@ -5393,14 +5473,14 @@ var Agent = class {
     for (const toolSet of tools) {
       for (const [toolName, originalTool] of Object.entries(toolSet)) {
         if (!isValidTool(originalTool)) {
-          logger14.error({ toolName }, "Invalid MCP tool structure - missing required properties");
+          logger15.error({ toolName }, "Invalid MCP tool structure - missing required properties");
           continue;
         }
         const sessionWrappedTool = ai.tool({
           description: originalTool.description,
           inputSchema: originalTool.inputSchema,
           execute: async (args, { toolCallId }) => {
-            logger14.debug({ toolName, toolCallId }, "MCP Tool Called");
+            logger15.debug({ toolName, toolCallId }, "MCP Tool Called");
             try {
               const result = await originalTool.execute(args, { toolCallId });
               toolSessionManager.recordToolResult(sessionId, {
@@ -5412,7 +5492,7 @@ var Agent = class {
               });
               return { result, toolCallId };
             } catch (error) {
-              logger14.error({ toolName, toolCallId, error }, "MCP tool execution failed");
+              logger15.error({ toolName, toolCallId, error }, "MCP tool execution failed");
               throw error;
             }
           }
@@ -5497,7 +5577,7 @@ var Agent = class {
         selectedTools
       };
     }
-    logger14.info(
+    logger15.info(
       {
         toolName: tool4.name,
         credentialReferenceId,
@@ -5537,7 +5617,7 @@ var Agent = class {
   async getResolvedContext(conversationId, requestContext) {
     try {
       if (!this.config.contextConfigId) {
-        logger14.debug({ graphId: this.config.graphId }, "No context config found for graph");
+        logger15.debug({ graphId: this.config.graphId }, "No context config found for graph");
         return null;
       }
       const contextConfig = await agentsCore.getContextConfigById(dbClient_default)({
@@ -5545,7 +5625,7 @@ var Agent = class {
         id: this.config.contextConfigId
       });
       if (!contextConfig) {
-        logger14.warn({ contextConfigId: this.config.contextConfigId }, "Context config not found");
+        logger15.warn({ contextConfigId: this.config.contextConfigId }, "Context config not found");
         return null;
       }
       if (!this.contextResolver) {
@@ -5562,7 +5642,7 @@ var Agent = class {
         $now: (/* @__PURE__ */ new Date()).toISOString(),
         $env: process.env
       };
-      logger14.debug(
+      logger15.debug(
         {
           conversationId,
           contextConfigId: contextConfig.id,
@@ -5576,7 +5656,7 @@ var Agent = class {
       );
       return contextWithBuiltins;
     } catch (error) {
-      logger14.error(
+      logger15.error(
         {
           conversationId,
           error: error instanceof Error ? error.message : "Unknown error"
@@ -5600,7 +5680,7 @@ var Agent = class {
       });
       return graphDefinition?.graphPrompt || void 0;
     } catch (error) {
-      logger14.warn(
+      logger15.warn(
         {
           graphId: this.config.graphId,
           error: error instanceof Error ? error.message : "Unknown error"
@@ -5627,7 +5707,7 @@ var Agent = class {
       }
       return !!(graphDefinition.artifactComponents && Object.keys(graphDefinition.artifactComponents).length > 0);
     } catch (error) {
-      logger14.warn(
+      logger15.warn(
         {
           graphId: this.config.graphId,
           tenantId: this.config.tenantId,
@@ -5687,7 +5767,7 @@ Key requirements:
           preserveUnresolved: false
         });
       } catch (error) {
-        logger14.error(
+        logger15.error(
           {
             conversationId,
             error: error instanceof Error ? error.message : "Unknown error"
@@ -5732,7 +5812,7 @@ Key requirements:
           preserveUnresolved: false
         });
       } catch (error) {
-        logger14.error(
+        logger15.error(
           {
             conversationId,
             error: error instanceof Error ? error.message : "Unknown error"
@@ -5741,7 +5821,7 @@ Key requirements:
         );
       }
     }
-    const config2 = {
+    const config = {
       corePrompt: processedPrompt,
       graphPrompt,
       tools: toolDefinitions,
@@ -5751,7 +5831,7 @@ Key requirements:
       hasTransferRelations: (this.config.transferRelations?.length ?? 0) > 0,
       hasDelegateRelations: (this.config.delegateRelations?.length ?? 0) > 0
     };
-    return await this.systemPromptBuilder.buildSystemPrompt(config2);
+    return await this.systemPromptBuilder.buildSystemPrompt(config);
   }
   getArtifactTools() {
     return ai.tool({
@@ -5760,7 +5840,7 @@ Key requirements:
         artifactId: z5.z.string().describe("The unique identifier of the artifact to get.")
       }),
       execute: async ({ artifactId }) => {
-        logger14.info({ artifactId }, "get_artifact executed");
+        logger15.info({ artifactId }, "get_artifact executed");
         const artifact = await agentsCore.getLedgerArtifacts(dbClient_default)({
           scopes: {
             tenantId: this.config.tenantId,
@@ -5827,7 +5907,7 @@ Key requirements:
         graphId: this.config.graphId
       });
     } catch (error) {
-      logger14.error(
+      logger15.error(
         { error, graphId: this.config.graphId },
         "Failed to check graph artifact components"
       );
@@ -5931,7 +6011,7 @@ Key requirements:
         const configuredTimeout = modelSettings.maxDuration ? Math.min(modelSettings.maxDuration * 1e3, MAX_ALLOWED_TIMEOUT_MS) : shouldStreamPhase1 ? CONSTANTS.PHASE_1_TIMEOUT_MS : CONSTANTS.NON_STREAMING_PHASE_1_TIMEOUT_MS;
         const timeoutMs = Math.min(configuredTimeout, MAX_ALLOWED_TIMEOUT_MS);
         if (modelSettings.maxDuration && modelSettings.maxDuration * 1e3 > MAX_ALLOWED_TIMEOUT_MS) {
-          logger14.warn(
+          logger15.warn(
             {
               requestedTimeout: modelSettings.maxDuration * 1e3,
               appliedTimeout: timeoutMs,
@@ -5973,7 +6053,7 @@ Key requirements:
                     }
                   );
                 } catch (error) {
-                  logger14.debug({ error }, "Failed to track agent reasoning");
+                  logger15.debug({ error }, "Failed to track agent reasoning");
                 }
               }
               if (last && "toolCalls" in last && last.toolCalls) {
@@ -6056,7 +6136,7 @@ Key requirements:
                     }
                   );
                 } catch (error) {
-                  logger14.debug({ error }, "Failed to track agent reasoning");
+                  logger15.debug({ error }, "Failed to track agent reasoning");
                 }
               }
               if (last && "toolCalls" in last && last.toolCalls) {
@@ -6101,7 +6181,7 @@ Key requirements:
                         return;
                       }
                       if (toolName === "save_artifact_tool" || toolName === "save_tool_result") {
-                        logger14.info({ result }, "save_artifact_tool or save_tool_result");
+                        logger15.info({ result }, "save_artifact_tool or save_tool_result");
                         if (result.output.artifacts) {
                           for (const artifact of result.output.artifacts) {
                             const artifactId = artifact?.artifactId || "N/A";
@@ -6176,7 +6256,7 @@ ${output}`;
                 { role: "user", content: userMessage },
                 ...reasoningFlow,
                 {
-                  role: "system",
+                  role: "user",
                   content: await this.buildPhase2SystemPrompt()
                 }
               ],
@@ -6275,7 +6355,9 @@ async function resolveModelConfig(graphId, agent) {
       summarizer: agent.models?.summarizer || project.models.summarizer || project.models.base
     };
   }
-  throw new Error("Base model configuration is required. Please configure models at the project level.");
+  throw new Error(
+    "Base model configuration is required. Please configure models at the project level."
+  );
 }
 
 // src/agents/generateTaskHandler.ts
@@ -6289,8 +6371,8 @@ function parseEmbeddedJson(data) {
     }
   });
 }
-var logger15 = agentsCore.getLogger("generateTaskHandler");
-var createTaskHandler = (config2, credentialStoreRegistry) => {
+var logger16 = agentsCore.getLogger("generateTaskHandler");
+var createTaskHandler = (config, credentialStoreRegistry) => {
   return async (task) => {
     try {
       const userMessage = task.input.parts.filter((part) => part.text).map((part) => part.text).join(" ");
@@ -6311,58 +6393,84 @@ var createTaskHandler = (config2, credentialStoreRegistry) => {
       ] = await Promise.all([
         agentsCore.getRelatedAgentsForGraph(dbClient_default)({
           scopes: {
-            tenantId: config2.tenantId,
-            projectId: config2.projectId
+            tenantId: config.tenantId,
+            projectId: config.projectId
           },
-          graphId: config2.graphId,
-          agentId: config2.agentId
+          graphId: config.graphId,
+          agentId: config.agentId
         }),
         agentsCore.getToolsForAgent(dbClient_default)({
           scopes: {
-            tenantId: config2.tenantId,
-            projectId: config2.projectId
+            tenantId: config.tenantId,
+            projectId: config.projectId
           },
-          agentId: config2.agentId
+          agentId: config.agentId
         }),
         agentsCore.getDataComponentsForAgent(dbClient_default)({
           scopes: {
-            tenantId: config2.tenantId,
-            projectId: config2.projectId
+            tenantId: config.tenantId,
+            projectId: config.projectId
           },
-          agentId: config2.agentId
+          agentId: config.agentId
         }),
         agentsCore.getArtifactComponentsForAgent(dbClient_default)({
           scopes: {
-            tenantId: config2.tenantId,
-            projectId: config2.projectId
+            tenantId: config.tenantId,
+            projectId: config.projectId
           },
-          agentId: config2.agentId
+          agentId: config.agentId
         })
       ]);
-      logger15.info({ toolsForAgent, internalRelations, externalRelations }, "agent stuff");
-      const agentPrompt = "prompt" in config2.agentSchema ? config2.agentSchema.prompt : "";
-      const models = "models" in config2.agentSchema ? config2.agentSchema.models : void 0;
-      const stopWhen = "stopWhen" in config2.agentSchema ? config2.agentSchema.stopWhen : void 0;
+      logger16.info({ toolsForAgent, internalRelations, externalRelations }, "agent stuff");
+      const enhancedInternalRelations = await Promise.all(
+        internalRelations.map(async (relation) => {
+          try {
+            const relatedAgent = await agentsCore.getAgentById(dbClient_default)({
+              scopes: { tenantId: config.tenantId, projectId: config.projectId },
+              agentId: relation.id
+            });
+            if (relatedAgent) {
+              const relatedAgentRelations = await agentsCore.getRelatedAgentsForGraph(dbClient_default)({
+                scopes: { tenantId: config.tenantId, projectId: config.projectId },
+                graphId: config.graphId,
+                agentId: relation.id
+              });
+              const enhancedDescription = generateDescriptionWithTransfers(
+                relation.description || "",
+                relatedAgentRelations.internalRelations,
+                relatedAgentRelations.externalRelations
+              );
+              return { ...relation, description: enhancedDescription };
+            }
+          } catch (error) {
+            logger16.warn({ agentId: relation.id, error }, "Failed to enhance agent description");
+          }
+          return relation;
+        })
+      );
+      const agentPrompt = "prompt" in config.agentSchema ? config.agentSchema.prompt : "";
+      const models = "models" in config.agentSchema ? config.agentSchema.models : void 0;
+      const stopWhen = "stopWhen" in config.agentSchema ? config.agentSchema.stopWhen : void 0;
       const agent = new Agent(
         {
-          id: config2.agentId,
-          tenantId: config2.tenantId,
-          projectId: config2.projectId,
-          graphId: config2.graphId,
-          baseUrl: config2.baseUrl,
-          apiKey: config2.apiKey,
-          name: config2.name,
-          description: config2.description || "",
+          id: config.agentId,
+          tenantId: config.tenantId,
+          projectId: config.projectId,
+          graphId: config.graphId,
+          baseUrl: config.baseUrl,
+          apiKey: config.apiKey,
+          name: config.name,
+          description: config.description || "",
           agentPrompt,
           models: models || void 0,
           stopWhen: stopWhen || void 0,
-          agentRelations: internalRelations.map((relation) => ({
+          agentRelations: enhancedInternalRelations.map((relation) => ({
             id: relation.id,
-            tenantId: config2.tenantId,
-            projectId: config2.projectId,
-            graphId: config2.graphId,
-            baseUrl: config2.baseUrl,
-            apiKey: config2.apiKey,
+            tenantId: config.tenantId,
+            projectId: config.projectId,
+            graphId: config.graphId,
+            baseUrl: config.baseUrl,
+            apiKey: config.apiKey,
             name: relation.name,
             description: relation.description,
             agentPrompt: "",
@@ -6370,13 +6478,13 @@ var createTaskHandler = (config2, credentialStoreRegistry) => {
             agentRelations: [],
             transferRelations: []
           })),
-          transferRelations: internalRelations.filter((relation) => relation.relationType === "transfer").map((relation) => ({
-            baseUrl: config2.baseUrl,
-            apiKey: config2.apiKey,
+          transferRelations: enhancedInternalRelations.filter((relation) => relation.relationType === "transfer").map((relation) => ({
+            baseUrl: config.baseUrl,
+            apiKey: config.apiKey,
             id: relation.id,
-            tenantId: config2.tenantId,
-            projectId: config2.projectId,
-            graphId: config2.graphId,
+            tenantId: config.tenantId,
+            projectId: config.projectId,
+            graphId: config.graphId,
             name: relation.name,
             description: relation.description,
             agentPrompt: "",
@@ -6386,15 +6494,15 @@ var createTaskHandler = (config2, credentialStoreRegistry) => {
           })),
           delegateRelations: [
             // Internal delegate relations
-            ...internalRelations.filter((relation) => relation.relationType === "delegate").map((relation) => ({
+            ...enhancedInternalRelations.filter((relation) => relation.relationType === "delegate").map((relation) => ({
               type: "internal",
               config: {
                 id: relation.id,
-                tenantId: config2.tenantId,
-                projectId: config2.projectId,
-                graphId: config2.graphId,
-                baseUrl: config2.baseUrl,
-                apiKey: config2.apiKey,
+                tenantId: config.tenantId,
+                projectId: config.projectId,
+                graphId: config.graphId,
+                baseUrl: config.baseUrl,
+                apiKey: config.apiKey,
                 name: relation.name,
                 description: relation.description,
                 agentPrompt: "",
@@ -6429,8 +6537,8 @@ var createTaskHandler = (config2, credentialStoreRegistry) => {
           // All tools are now handled via MCP servers
           dataComponents,
           artifactComponents,
-          contextConfigId: config2.contextConfigId || void 0,
-          conversationHistoryConfig: config2.conversationHistoryConfig
+          contextConfigId: config.contextConfigId || void 0,
+          conversationHistoryConfig: config.conversationHistoryConfig
         },
         credentialStoreRegistry
       );
@@ -6439,11 +6547,11 @@ var createTaskHandler = (config2, credentialStoreRegistry) => {
         const taskIdMatch = task.id.match(/^task_([^-]+-[^-]+-\d+)-/);
         if (taskIdMatch) {
           contextId = taskIdMatch[1];
-          logger15.info(
+          logger16.info(
             {
               taskId: task.id,
               extractedContextId: contextId,
-              agentId: config2.agentId
+              agentId: config.agentId
             },
             "Extracted contextId from task ID for delegation"
           );
@@ -6455,8 +6563,8 @@ var createTaskHandler = (config2, credentialStoreRegistry) => {
       const isDelegation = task.context?.metadata?.isDelegation === true;
       agent.setDelegationStatus(isDelegation);
       if (isDelegation) {
-        logger15.info(
-          { agentId: config2.agentId, taskId: task.id },
+        logger16.info(
+          { agentId: config.agentId, taskId: task.id },
           "Delegated agent - streaming disabled"
         );
       }
@@ -6468,7 +6576,7 @@ var createTaskHandler = (config2, credentialStoreRegistry) => {
           threadId: contextId,
           // using conversationId as threadId for now
           streamRequestId,
-          ...config2.apiKey ? { apiKey: config2.apiKey } : {}
+          ...config.apiKey ? { apiKey: config.apiKey } : {}
         }
       });
       const stepContents = response.steps && Array.isArray(response.steps) ? response.steps.flatMap((step) => {
@@ -6661,86 +6769,11 @@ async function getRegisteredGraph(executionContext) {
   const agentFrameworkBaseUrl = `${baseUrl}/agents`;
   return hydrateGraph({ dbGraph, baseUrl: agentFrameworkBaseUrl, apiKey });
 }
-init_dbClient();
-agentsCore.getLogger("agents");
-async function hydrateAgent({
-  dbAgent,
-  graphId,
-  baseUrl,
-  apiKey,
-  credentialStoreRegistry
-}) {
-  try {
-    const taskHandlerConfig = await createTaskHandlerConfig({
-      tenantId: dbAgent.tenantId,
-      projectId: dbAgent.projectId,
-      graphId,
-      agentId: dbAgent.id,
-      baseUrl,
-      apiKey
-    });
-    const taskHandler = createTaskHandler(taskHandlerConfig, credentialStoreRegistry);
-    const agentCard = {
-      name: dbAgent.name,
-      description: dbAgent.description || "AI Agent",
-      url: baseUrl ? `${baseUrl}/a2a` : "",
-      version: "1.0.0",
-      capabilities: {
-        streaming: true,
-        // Enable streaming for A2A compliance
-        pushNotifications: false,
-        stateTransitionHistory: false
-      },
-      defaultInputModes: ["text", "text/plain"],
-      defaultOutputModes: ["text", "text/plain"],
-      skills: [],
-      // Add provider info if available
-      ...baseUrl && {
-        provider: {
-          organization: "Inkeep",
-          url: baseUrl
-        }
-      }
-    };
-    return {
-      agentId: dbAgent.id,
-      tenantId: dbAgent.tenantId,
-      projectId: dbAgent.projectId,
-      graphId,
-      agentCard,
-      taskHandler
-    };
-  } catch (error) {
-    console.error(`\u274C Failed to hydrate agent ${dbAgent.id}:`, error);
-    throw error;
-  }
-}
-async function getRegisteredAgent(executionContext, credentialStoreRegistry) {
-  const { tenantId, projectId, graphId, agentId, baseUrl, apiKey } = executionContext;
-  if (!agentId) {
-    throw new Error("Agent ID is required");
-  }
-  const dbAgent = await agentsCore.getAgentById(dbClient_default)({
-    scopes: { tenantId, projectId },
-    agentId
-  });
-  if (!dbAgent) {
-    return null;
-  }
-  const agentFrameworkBaseUrl = `${baseUrl}/agents`;
-  return hydrateAgent({
-    dbAgent,
-    graphId,
-    baseUrl: agentFrameworkBaseUrl,
-    credentialStoreRegistry,
-    apiKey
-  });
-}
 
 // src/routes/agents.ts
 init_dbClient();
 var app = new zodOpenapi.OpenAPIHono();
-var logger16 = agentsCore.getLogger("agents");
+var logger17 = agentsCore.getLogger("agents");
 app.openapi(
   zodOpenapi.createRoute({
     method: "get",
@@ -6778,7 +6811,7 @@ app.openapi(
       tracestate: c.req.header("tracestate"),
       baggage: c.req.header("baggage")
     };
-    logger16.info(
+    logger17.info(
       {
         otelHeaders,
         path: c.req.path,
@@ -6789,7 +6822,7 @@ app.openapi(
     const executionContext = agentsCore.getRequestExecutionContext(c);
     const { tenantId, projectId, graphId, agentId } = executionContext;
     if (agentId) {
-      logger16.info(
+      logger17.info(
         {
           message: "getRegisteredAgent (agent-level)",
           tenantId,
@@ -6801,13 +6834,13 @@ app.openapi(
       );
       const credentialStores = c.get("credentialStores");
       const agent = await getRegisteredAgent(executionContext, credentialStores);
-      logger16.info({ agent }, "agent registered: well-known agent.json");
+      logger17.info({ agent }, "agent registered: well-known agent.json");
       if (!agent) {
         return c.json({ error: "Agent not found" }, 404);
       }
       return c.json(agent.agentCard);
     } else {
-      logger16.info(
+      logger17.info(
         {
           message: "getRegisteredGraph (graph-level)",
           tenantId,
@@ -6830,7 +6863,7 @@ app.post("/a2a", async (c) => {
     tracestate: c.req.header("tracestate"),
     baggage: c.req.header("baggage")
   };
-  logger16.info(
+  logger17.info(
     {
       otelHeaders,
       path: c.req.path,
@@ -6841,7 +6874,7 @@ app.post("/a2a", async (c) => {
   const executionContext = agentsCore.getRequestExecutionContext(c);
   const { tenantId, projectId, graphId, agentId } = executionContext;
   if (agentId) {
-    logger16.info(
+    logger17.info(
       {
         message: "a2a (agent-level)",
         tenantId,
@@ -6865,7 +6898,7 @@ app.post("/a2a", async (c) => {
     }
     return a2aHandler(c, agent);
   } else {
-    logger16.info(
+    logger17.info(
       {
         message: "a2a (graph-level)",
         tenantId,
@@ -6911,14 +6944,14 @@ init_dbClient();
 
 // src/a2a/transfer.ts
 init_dbClient();
-var logger17 = agentsCore.getLogger("Transfer");
+var logger18 = agentsCore.getLogger("Transfer");
 async function executeTransfer({
   tenantId,
   threadId,
   projectId,
   targetAgentId
 }) {
-  logger17.info({ targetAgent: targetAgentId }, "Executing transfer to agent");
+  logger18.info({ targetAgent: targetAgentId }, "Executing transfer to agent");
   await agentsCore.setActiveAgentForThread(dbClient_default)({
     scopes: { tenantId, projectId },
     threadId,
@@ -7113,7 +7146,7 @@ var _VercelDataStreamHelper = class _VercelDataStreamHelper {
     __publicField(this, "queuedOperations", []);
     // Timing tracking for text sequences (text-end to text-start gap)
     __publicField(this, "lastTextEndTimestamp", 0);
-    __publicField(this, "TEXT_GAP_THRESHOLD", 1e3);
+    __publicField(this, "TEXT_GAP_THRESHOLD", 50);
     // milliseconds - if gap between text sequences is less than this, queue operations
     // Connection management and forced cleanup
     __publicField(this, "connectionDropTimer");
@@ -7462,7 +7495,7 @@ function createMCPStreamHelper() {
 
 // src/handlers/executionHandler.ts
 init_dbClient();
-var logger18 = agentsCore.getLogger("ExecutionHandler");
+var logger19 = agentsCore.getLogger("ExecutionHandler");
 var ExecutionHandler = class {
   constructor() {
     // Hardcoded error limit - separate from configurable stopWhen
@@ -7487,7 +7520,7 @@ var ExecutionHandler = class {
     const { tenantId, projectId, graphId, apiKey, baseUrl } = executionContext;
     registerStreamHelper(requestId2, sseHelper);
     graphSessionManager.createSession(requestId2, graphId, tenantId, projectId);
-    logger18.info({ sessionId: requestId2, graphId }, "Created GraphSession for message execution");
+    logger19.info({ sessionId: requestId2, graphId }, "Created GraphSession for message execution");
     let graphConfig = null;
     try {
       graphConfig = await agentsCore.getFullGraph(dbClient_default)({ scopes: { tenantId, projectId }, graphId });
@@ -7499,7 +7532,7 @@ var ExecutionHandler = class {
         );
       }
     } catch (error) {
-      logger18.error(
+      logger19.error(
         {
           error: error instanceof Error ? error.message : "Unknown error",
           stack: error instanceof Error ? error.stack : void 0
@@ -7515,7 +7548,7 @@ var ExecutionHandler = class {
     try {
       await sseHelper.writeOperation(agentInitializingOp(requestId2, graphId));
       const taskId = `task_${conversationId}-${requestId2}`;
-      logger18.info(
+      logger19.info(
         { taskId, currentAgentId, conversationId, requestId: requestId2 },
         "Attempting to create or reuse existing task"
       );
@@ -7538,7 +7571,7 @@ var ExecutionHandler = class {
             agent_id: currentAgentId
           }
         });
-        logger18.info(
+        logger19.info(
           {
             taskId,
             createdTaskMetadata: Array.isArray(task) ? task[0]?.metadata : task?.metadata
@@ -7547,27 +7580,27 @@ var ExecutionHandler = class {
         );
       } catch (error) {
         if (error?.message?.includes("UNIQUE constraint failed") || error?.message?.includes("PRIMARY KEY constraint failed") || error?.code === "SQLITE_CONSTRAINT_PRIMARYKEY") {
-          logger18.info(
+          logger19.info(
             { taskId, error: error.message },
             "Task already exists, fetching existing task"
           );
           const existingTask = await agentsCore.getTask(dbClient_default)({ id: taskId });
           if (existingTask) {
             task = existingTask;
-            logger18.info(
+            logger19.info(
               { taskId, existingTask },
               "Successfully reused existing task from race condition"
             );
           } else {
-            logger18.error({ taskId, error }, "Task constraint failed but task not found");
+            logger19.error({ taskId, error }, "Task constraint failed but task not found");
             throw error;
           }
         } else {
-          logger18.error({ taskId, error }, "Failed to create task due to non-constraint error");
+          logger19.error({ taskId, error }, "Failed to create task due to non-constraint error");
           throw error;
         }
       }
-      logger18.debug(
+      logger19.debug(
         {
           timestamp: (/* @__PURE__ */ new Date()).toISOString(),
           executionType: "create_initial_task",
@@ -7585,7 +7618,7 @@ var ExecutionHandler = class {
       const maxTransfers = graphConfig?.stopWhen?.transferCountIs ?? 10;
       while (iterations < maxTransfers) {
         iterations++;
-        logger18.info(
+        logger19.info(
           { iterations, currentAgentId, graphId, conversationId, fromAgentId },
           `Execution loop iteration ${iterations} with agent ${currentAgentId}, transfer from: ${fromAgentId || "none"}`
         );
@@ -7593,10 +7626,10 @@ var ExecutionHandler = class {
           scopes: { tenantId, projectId },
           conversationId
         });
-        logger18.info({ activeAgent }, "activeAgent");
+        logger19.info({ activeAgent }, "activeAgent");
         if (activeAgent && activeAgent.activeAgentId !== currentAgentId) {
           currentAgentId = activeAgent.activeAgentId;
-          logger18.info({ currentAgentId }, `Updated current agent to: ${currentAgentId}`);
+          logger19.info({ currentAgentId }, `Updated current agent to: ${currentAgentId}`);
         }
         const agentBaseUrl = `${baseUrl}/agents`;
         const a2aClient = new A2AClient(agentBaseUrl, {
@@ -7637,13 +7670,13 @@ var ExecutionHandler = class {
         });
         if (!messageResponse?.result) {
           errorCount++;
-          logger18.error(
+          logger19.error(
             { currentAgentId, iterations, errorCount },
             `No response from agent ${currentAgentId} on iteration ${iterations} (error ${errorCount}/${this.MAX_ERRORS})`
           );
           if (errorCount >= this.MAX_ERRORS) {
             const errorMessage2 = `Maximum error limit (${this.MAX_ERRORS}) reached`;
-            logger18.error({ maxErrors: this.MAX_ERRORS, errorCount }, errorMessage2);
+            logger19.error({ maxErrors: this.MAX_ERRORS, errorCount }, errorMessage2);
             await sseHelper.writeError(errorMessage2);
             await sseHelper.writeOperation(errorOp(errorMessage2, currentAgentId || "system"));
             if (task) {
@@ -7669,7 +7702,7 @@ var ExecutionHandler = class {
           const transferResponse = messageResponse.result;
           const targetAgentId = transferResponse.artifacts?.[0]?.parts?.[0]?.data?.targetAgentId;
           const transferReason = transferResponse.artifacts?.[0]?.parts?.[1]?.text;
-          logger18.info({ targetAgentId, transferReason }, "transfer response");
+          logger19.info({ targetAgentId, transferReason }, "transfer response");
           currentMessage = `<transfer_context> ${transferReason} </transfer_context>`;
           const { success, targetAgentId: newAgentId } = await executeTransfer({
             projectId,
@@ -7680,7 +7713,7 @@ var ExecutionHandler = class {
           if (success) {
             fromAgentId = currentAgentId;
             currentAgentId = newAgentId;
-            logger18.info(
+            logger19.info(
               {
                 transferFrom: fromAgentId,
                 transferTo: currentAgentId,
@@ -7698,7 +7731,7 @@ var ExecutionHandler = class {
           const graphSessionData = graphSessionManager.getSession(requestId2);
           if (graphSessionData) {
             const sessionSummary = graphSessionData.getSummary();
-            logger18.info(sessionSummary, "GraphSession data after completion");
+            logger19.info(sessionSummary, "GraphSession data after completion");
           }
           let textContent = "";
           for (const part of responseParts) {
@@ -7707,78 +7740,84 @@ var ExecutionHandler = class {
               textContent += part.text;
             }
           }
-          const activeSpan = api.trace.getActiveSpan();
-          if (activeSpan) {
-            activeSpan.setAttributes({
-              "ai.response.content": textContent || "No response content",
-              "ai.response.timestamp": (/* @__PURE__ */ new Date()).toISOString(),
-              "ai.agent.name": currentAgentId
-            });
-          }
-          await agentsCore.createMessage(dbClient_default)({
-            id: nanoid.nanoid(),
-            tenantId,
-            projectId,
-            conversationId,
-            role: "agent",
-            content: {
-              text: textContent || void 0,
-              parts: responseParts.map((part) => ({
-                type: part.kind === "text" ? "text" : "data",
-                text: part.kind === "text" ? part.text : void 0,
-                data: part.kind === "data" ? JSON.stringify(part.data) : void 0
-              }))
-            },
-            visibility: "user-facing",
-            messageType: "chat",
-            agentId: currentAgentId,
-            fromAgentId: currentAgentId,
-            taskId: task.id
-          });
-          const updateTaskStart = Date.now();
-          await agentsCore.updateTask(dbClient_default)({
-            taskId: task.id,
-            data: {
-              status: "completed",
-              metadata: {
-                ...task.metadata,
-                completed_at: (/* @__PURE__ */ new Date()).toISOString(),
-                response: {
-                  text: textContent,
-                  parts: responseParts,
-                  hasText: !!textContent,
-                  hasData: responseParts.some((p) => p.kind === "data")
+          return tracer.startActiveSpan("execution_handler.execute", {}, async (span) => {
+            try {
+              span.setAttributes({
+                "ai.response.content": textContent || "No response content",
+                "ai.response.timestamp": (/* @__PURE__ */ new Date()).toISOString(),
+                "ai.agent.name": currentAgentId
+              });
+              await agentsCore.createMessage(dbClient_default)({
+                id: nanoid.nanoid(),
+                tenantId,
+                projectId,
+                conversationId,
+                role: "agent",
+                content: {
+                  text: textContent || void 0,
+                  parts: responseParts.map((part) => ({
+                    type: part.kind === "text" ? "text" : "data",
+                    text: part.kind === "text" ? part.text : void 0,
+                    data: part.kind === "data" ? JSON.stringify(part.data) : void 0
+                  }))
+                },
+                visibility: "user-facing",
+                messageType: "chat",
+                agentId: currentAgentId,
+                fromAgentId: currentAgentId,
+                taskId: task.id
+              });
+              const updateTaskStart = Date.now();
+              await agentsCore.updateTask(dbClient_default)({
+                taskId: task.id,
+                data: {
+                  status: "completed",
+                  metadata: {
+                    ...task.metadata,
+                    completed_at: (/* @__PURE__ */ new Date()).toISOString(),
+                    response: {
+                      text: textContent,
+                      parts: responseParts,
+                      hasText: !!textContent,
+                      hasData: responseParts.some((p) => p.kind === "data")
+                    }
+                  }
                 }
+              });
+              const updateTaskEnd = Date.now();
+              logger19.info(
+                { duration: updateTaskEnd - updateTaskStart },
+                "Completed updateTask operation"
+              );
+              await sseHelper.writeOperation(completionOp(currentAgentId, iterations));
+              await sseHelper.complete();
+              logger19.info({}, "Ending GraphSession and cleaning up");
+              graphSessionManager.endSession(requestId2);
+              logger19.info({}, "Cleaning up streamHelper");
+              unregisterStreamHelper(requestId2);
+              let response;
+              if (sseHelper instanceof MCPStreamHelper) {
+                const captured = sseHelper.getCapturedResponse();
+                response = captured.text || "No response content";
               }
+              logger19.info({}, "ExecutionHandler returning success");
+              return { success: true, iterations, response };
+            } catch (error) {
+              agentsCore.setSpanWithError(span, error);
+              throw error;
+            } finally {
+              span.end();
             }
           });
-          const updateTaskEnd = Date.now();
-          logger18.info(
-            { duration: updateTaskEnd - updateTaskStart },
-            "Completed updateTask operation"
-          );
-          await sseHelper.writeOperation(completionOp(currentAgentId, iterations));
-          await sseHelper.complete();
-          logger18.info({}, "Ending GraphSession and cleaning up");
-          graphSessionManager.endSession(requestId2);
-          logger18.info({}, "Cleaning up streamHelper");
-          unregisterStreamHelper(requestId2);
-          let response;
-          if (sseHelper instanceof MCPStreamHelper) {
-            const captured = sseHelper.getCapturedResponse();
-            response = captured.text || "No response content";
-          }
-          logger18.info({}, "ExecutionHandler returning success");
-          return { success: true, iterations, response };
         }
         errorCount++;
-        logger18.warn(
+        logger19.warn(
           { iterations, errorCount },
           `No valid response or transfer on iteration ${iterations} (error ${errorCount}/${this.MAX_ERRORS})`
         );
         if (errorCount >= this.MAX_ERRORS) {
           const errorMessage2 = `Maximum error limit (${this.MAX_ERRORS}) reached`;
-          logger18.error({ maxErrors: this.MAX_ERRORS, errorCount }, errorMessage2);
+          logger19.error({ maxErrors: this.MAX_ERRORS, errorCount }, errorMessage2);
           await sseHelper.writeError(errorMessage2);
           await sseHelper.writeOperation(errorOp(errorMessage2, currentAgentId || "system"));
           if (task) {
@@ -7800,7 +7839,7 @@ var ExecutionHandler = class {
         }
       }
       const errorMessage = `Maximum transfer limit (${maxTransfers}) reached without completion`;
-      logger18.error({ maxTransfers, iterations }, errorMessage);
+      logger19.error({ maxTransfers, iterations }, errorMessage);
       await sseHelper.writeError(errorMessage);
       await sseHelper.writeOperation(errorOp(errorMessage, currentAgentId || "system"));
       if (task) {
@@ -7820,7 +7859,7 @@ var ExecutionHandler = class {
       unregisterStreamHelper(requestId2);
       return { success: false, error: errorMessage, iterations };
     } catch (error) {
-      logger18.error({ error }, "Error in execution handler");
+      logger19.error({ error }, "Error in execution handler");
       const errorMessage = error instanceof Error ? error.message : "Unknown execution error";
       await sseHelper.writeError(`Execution error: ${errorMessage}`);
       await sseHelper.writeOperation(errorOp(errorMessage, currentAgentId || "system"));
@@ -7846,7 +7885,7 @@ var ExecutionHandler = class {
 
 // src/routes/chat.ts
 var app2 = new zodOpenapi.OpenAPIHono();
-var logger19 = agentsCore.getLogger("completionsHandler");
+var logger20 = agentsCore.getLogger("completionsHandler");
 var chatCompletionsRoute = zodOpenapi.createRoute({
   method: "post",
   path: "/completions",
@@ -7964,7 +8003,7 @@ app2.openapi(chatCompletionsRoute, async (c) => {
     tracestate: c.req.header("tracestate"),
     baggage: c.req.header("baggage")
   };
-  logger19.info(
+  logger20.info(
     {
       otelHeaders,
       path: c.req.path,
@@ -8050,7 +8089,7 @@ app2.openapi(chatCompletionsRoute, async (c) => {
       dbClient_default,
       credentialStores
     );
-    logger19.info(
+    logger20.info(
       {
         tenantId,
         graphId,
@@ -8096,7 +8135,7 @@ app2.openapi(chatCompletionsRoute, async (c) => {
     return streaming.streamSSE(c, async (stream2) => {
       const sseHelper = createSSEStreamHelper(stream2, requestId2, timestamp);
       await sseHelper.writeRole();
-      logger19.info({ agentId }, "Starting execution");
+      logger20.info({ agentId }, "Starting execution");
       const executionHandler = new ExecutionHandler();
       const result = await executionHandler.execute({
         executionContext,
@@ -8106,7 +8145,7 @@ app2.openapi(chatCompletionsRoute, async (c) => {
         requestId: requestId2,
         sseHelper
       });
-      logger19.info(
+      logger20.info(
         { result },
         `Execution completed: ${result.success ? "success" : "failed"} after ${result.iterations} iterations`
       );
@@ -8142,7 +8181,7 @@ var chat_default = app2;
 // src/routes/chatDataStream.ts
 init_dbClient();
 var app3 = new zodOpenapi.OpenAPIHono();
-var logger20 = agentsCore.getLogger("chatDataStream");
+var logger21 = agentsCore.getLogger("chatDataStream");
 var chatDataStreamRoute = zodOpenapi.createRoute({
   method: "post",
   path: "/chat",
@@ -8247,7 +8286,7 @@ app3.openapi(chatDataStreamRoute, async (c) => {
     );
     const lastUserMessage = body.messages.filter((m) => m.role === "user").slice(-1)[0];
     const userText = typeof lastUserMessage?.content === "string" ? lastUserMessage.content : lastUserMessage?.parts?.map((p) => p.text).join("") || "";
-    logger20.info({ userText, lastUserMessage }, "userText");
+    logger21.info({ userText, lastUserMessage }, "userText");
     const messageSpan = api.trace.getActiveSpan();
     if (messageSpan) {
       messageSpan.setAttributes({
@@ -8289,7 +8328,7 @@ app3.openapi(chatDataStreamRoute, async (c) => {
             await streamHelper.writeError("Unable to process request");
           }
         } catch (err) {
-          logger20.error({ err }, "Streaming error");
+          logger21.error({ err }, "Streaming error");
           await streamHelper.writeError("Internal server error");
         } finally {
           if ("cleanup" in streamHelper && typeof streamHelper.cleanup === "function") {
@@ -8310,7 +8349,7 @@ app3.openapi(chatDataStreamRoute, async (c) => {
       )
     );
   } catch (error) {
-    logger20.error({ error }, "chatDataStream error");
+    logger21.error({ error }, "chatDataStream error");
     return c.json({ error: "Failed to process chat completion" }, 500);
   }
 });
@@ -8321,7 +8360,7 @@ init_dbClient();
 function createMCPSchema(schema) {
   return schema;
 }
-var logger21 = agentsCore.getLogger("mcp");
+var logger22 = agentsCore.getLogger("mcp");
 var _MockResponseSingleton = class _MockResponseSingleton {
   constructor() {
     __publicField(this, "mockRes");
@@ -8376,21 +8415,21 @@ var createSpoofInitMessage = (mcpProtocolVersion) => ({
   id: 0
 });
 var spoofTransportInitialization = async (transport, req, sessionId, mcpProtocolVersion) => {
-  logger21.info({ sessionId }, "Spoofing initialization message to set transport state");
+  logger22.info({ sessionId }, "Spoofing initialization message to set transport state");
   const spoofInitMessage = createSpoofInitMessage(mcpProtocolVersion);
   const mockRes = MockResponseSingleton.getInstance().getMockResponse();
   try {
     await transport.handleRequest(req, mockRes, spoofInitMessage);
-    logger21.info({ sessionId }, "Successfully spoofed initialization");
+    logger22.info({ sessionId }, "Successfully spoofed initialization");
   } catch (spoofError) {
-    logger21.warn({ sessionId, error: spoofError }, "Spoof initialization failed, continuing anyway");
+    logger22.warn({ sessionId, error: spoofError }, "Spoof initialization failed, continuing anyway");
   }
 };
 var validateSession = async (req, res, body, tenantId, projectId, graphId) => {
   const sessionId = req.headers["mcp-session-id"];
-  logger21.info({ sessionId }, "Received MCP session ID");
+  logger22.info({ sessionId }, "Received MCP session ID");
   if (!sessionId) {
-    logger21.info({ body }, "Missing session ID");
+    logger22.info({ body }, "Missing session ID");
     res.writeHead(400).end(
       JSON.stringify({
         jsonrpc: "2.0",
@@ -8416,7 +8455,7 @@ var validateSession = async (req, res, body, tenantId, projectId, graphId) => {
     scopes: { tenantId, projectId },
     conversationId: sessionId
   });
-  logger21.info(
+  logger22.info(
     {
       sessionId,
       conversationFound: !!conversation,
@@ -8427,7 +8466,7 @@ var validateSession = async (req, res, body, tenantId, projectId, graphId) => {
     "Conversation lookup result"
   );
   if (!conversation || conversation.metadata?.sessionData?.sessionType !== "mcp" || conversation.metadata?.sessionData?.graphId !== graphId) {
-    logger21.info(
+    logger22.info(
       { sessionId, conversationId: conversation?.id },
       "MCP session not found or invalid"
     );
@@ -8488,7 +8527,7 @@ var executeAgentQuery = async (executionContext, conversationId, query, defaultA
     requestId: requestId2,
     sseHelper: mcpStreamHelper
   });
-  logger21.info(
+  logger22.info(
     { result },
     `Execution completed: ${result.success ? "success" : "failed"} after ${result.iterations} iterations`
   );
@@ -8562,7 +8601,7 @@ var getServer = async (requestContext, executionContext, conversationId, credent
           dbClient_default,
           credentialStores
         );
-        logger21.info(
+        logger22.info(
           {
             tenantId,
             graphId,
@@ -8623,7 +8662,7 @@ var validateRequestParameters = (c) => {
 };
 var handleInitializationRequest = async (body, executionContext, validatedContext, req, res, c, credentialStores) => {
   const { tenantId, projectId, graphId } = executionContext;
-  logger21.info({ body }, "Received initialization request");
+  logger22.info({ body }, "Received initialization request");
   const sessionId = nanoid.nanoid();
   const agentGraph = await agentsCore.getAgentGraphWithDefaultAgent(dbClient_default)({
     scopes: { tenantId, projectId },
@@ -8654,7 +8693,7 @@ var handleInitializationRequest = async (body, executionContext, validatedContex
       }
     }
   });
-  logger21.info(
+  logger22.info(
     { sessionId, conversationId: conversation.id },
     "Created MCP session as conversation"
   );
@@ -8663,9 +8702,9 @@ var handleInitializationRequest = async (body, executionContext, validatedContex
   });
   const server = await getServer(validatedContext, executionContext, sessionId, credentialStores);
   await server.connect(transport);
-  logger21.info({ sessionId }, "Server connected for initialization");
+  logger22.info({ sessionId }, "Server connected for initialization");
   res.setHeader("Mcp-Session-Id", sessionId);
-  logger21.info(
+  logger22.info(
     {
       sessionId,
       bodyMethod: body?.method,
@@ -8674,7 +8713,7 @@ var handleInitializationRequest = async (body, executionContext, validatedContex
     "About to handle initialization request"
   );
   await transport.handleRequest(req, res, body);
-  logger21.info({ sessionId }, "Successfully handled initialization request");
+  logger22.info({ sessionId }, "Successfully handled initialization request");
   return fetchToNode.toFetchResponse(res);
 };
 var handleExistingSessionRequest = async (body, executionContext, validatedContext, req, res, credentialStores) => {
@@ -8702,8 +8741,8 @@ var handleExistingSessionRequest = async (body, executionContext, validatedConte
     sessionId,
     conversation.metadata?.session_data?.mcpProtocolVersion
   );
-  logger21.info({ sessionId }, "Server connected and transport initialized");
-  logger21.info(
+  logger22.info({ sessionId }, "Server connected and transport initialized");
+  logger22.info(
     {
       sessionId,
       bodyKeys: Object.keys(body || {}),
@@ -8717,9 +8756,9 @@ var handleExistingSessionRequest = async (body, executionContext, validatedConte
   );
   try {
     await transport.handleRequest(req, res, body);
-    logger21.info({ sessionId }, "Successfully handled MCP request");
+    logger22.info({ sessionId }, "Successfully handled MCP request");
   } catch (transportError) {
-    logger21.error(
+    logger22.error(
       {
         sessionId,
         error: transportError,
@@ -8770,13 +8809,13 @@ app4.openapi(
       }
       const { executionContext } = paramValidation;
       const body = c.get("requestBody") || {};
-      logger21.info({ body, bodyKeys: Object.keys(body || {}) }, "Parsed request body");
+      logger22.info({ body, bodyKeys: Object.keys(body || {}) }, "Parsed request body");
       const isInitRequest = body.method === "initialize";
       const { req, res } = fetchToNode.toReqRes(c.req.raw);
       const validatedContext = c.get("validatedContext") || {};
       const credentialStores = c.get("credentialStores");
-      logger21.info({ validatedContext }, "Validated context");
-      logger21.info({ req }, "request");
+      logger22.info({ validatedContext }, "Validated context");
+      logger22.info({ req }, "request");
       if (isInitRequest) {
         return await handleInitializationRequest(
           body,
@@ -8798,7 +8837,7 @@ app4.openapi(
         );
       }
     } catch (e) {
-      logger21.error(
+      logger22.error(
         {
           error: e instanceof Error ? e.message : e,
           stack: e instanceof Error ? e.stack : void 0
@@ -8810,7 +8849,7 @@ app4.openapi(
   }
 );
 app4.get("/", async (c) => {
-  logger21.info({}, "Received GET MCP request");
+  logger22.info({}, "Received GET MCP request");
   return c.json(
     {
       jsonrpc: "2.0",
@@ -8824,7 +8863,7 @@ app4.get("/", async (c) => {
   );
 });
 app4.delete("/", async (c) => {
-  logger21.info({}, "Received DELETE MCP request");
+  logger22.info({}, "Received DELETE MCP request");
   return c.json(
     {
       jsonrpc: "2.0",
@@ -8835,7 +8874,7 @@ app4.delete("/", async (c) => {
   );
 });
 var mcp_default = app4;
-var logger22 = agentsCore.getLogger("agents-run-api");
+var logger23 = agentsCore.getLogger("agents-run-api");
 function createExecutionHono(serverConfig, credentialStores) {
   const app6 = new zodOpenapi.OpenAPIHono();
   app6.use("*", otel.otel());
@@ -8851,7 +8890,7 @@ function createExecutionHono(serverConfig, credentialStores) {
         const body = await c.req.json();
         c.set("requestBody", body);
       } catch (error) {
-        logger22.debug({ error }, "Failed to parse JSON body, continuing without parsed body");
+        logger23.debug({ error }, "Failed to parse JSON body, continuing without parsed body");
       }
     }
     return next();
@@ -8902,8 +8941,8 @@ function createExecutionHono(serverConfig, credentialStores) {
       if (!isExpectedError) {
         const errorMessage = err instanceof Error ? err.message : String(err);
         const errorStack = err instanceof Error ? err.stack : void 0;
-        if (logger22) {
-          logger22.error(
+        if (logger23) {
+          logger23.error(
             {
               error: err,
               message: errorMessage,
@@ -8915,8 +8954,8 @@ function createExecutionHono(serverConfig, credentialStores) {
           );
         }
       } else {
-        if (logger22) {
-          logger22.error(
+        if (logger23) {
+          logger23.error(
             {
               error: err,
               path: c.req.path,
@@ -8933,8 +8972,8 @@ function createExecutionHono(serverConfig, credentialStores) {
         const response = err.getResponse();
         return response;
       } catch (responseError) {
-        if (logger22) {
-          logger22.error({ error: responseError }, "Error while handling HTTPException response");
+        if (logger23) {
+          logger23.error({ error: responseError }, "Error while handling HTTPException response");
         }
       }
     }
@@ -8968,7 +9007,7 @@ function createExecutionHono(serverConfig, credentialStores) {
   app6.use("*", async (c, next) => {
     const executionContext = c.get("executionContext");
     if (!executionContext) {
-      logger22.debug({}, "Empty execution context");
+      logger23.debug({}, "Empty execution context");
       return next();
     }
     const { tenantId, projectId, graphId } = executionContext;
@@ -8977,7 +9016,7 @@ function createExecutionHono(serverConfig, credentialStores) {
     if (requestBody) {
       conversationId = requestBody.conversationId;
       if (!conversationId) {
-        logger22.debug({ requestBody }, "No conversation ID found in request body");
+        logger23.debug({ requestBody }, "No conversation ID found in request body");
       }
     }
     const entries = Object.fromEntries(
@@ -8992,7 +9031,7 @@ function createExecutionHono(serverConfig, credentialStores) {
       })
     );
     if (!Object.keys(entries).length) {
-      logger22.debug({}, "Empty entries for baggage");
+      logger23.debug({}, "Empty entries for baggage");
       return next();
     }
     const bag = Object.entries(entries).reduce(
@@ -9059,9 +9098,9 @@ var defaultStores = agentsCore.createDefaultCredentialStores();
 var defaultRegistry = new agentsCore.CredentialStoreRegistry(defaultStores);
 var app5 = createExecutionHono(defaultConfig, defaultRegistry);
 var index_default = app5;
-function createExecutionApp(config2) {
-  const serverConfig = config2?.serverConfig ?? defaultConfig;
-  const stores = config2?.credentialStores ?? defaultStores;
+function createExecutionApp(config) {
+  const serverConfig = config?.serverConfig ?? defaultConfig;
+  const stores = config?.credentialStores ?? defaultStores;
   const registry = new agentsCore.CredentialStoreRegistry(stores);
   return createExecutionHono(serverConfig, registry);
 }