@axiom-lattice/core 2.1.96 → 2.1.98

package/dist/index.mjs

@@ -7088,8 +7088,18 @@ var codeEvalPlugin = {
     description: "Enables safe code execution",
     configSchema: {
       type: "object",
+      title: "Code Evaluation Configuration",
+      description: "Configure code execution sandbox settings",
+      required: ["vmIsolation"],
       properties: {
-        vmIsolation: { type: "string" }
+        vmIsolation: {
+          type: "string",
+          title: "VM Isolation",
+          description: "Controls how code execution is isolated between agents and projects",
+          enum: ["global", "agent", "project"],
+          default: "global",
+          widget: "segmented"
+        }
       }
     },
     defaultConfig: { vmIsolation: "global" }
@@ -7138,9 +7148,18 @@ var browserPlugin = {
     description: "Provides browser automation capabilities",
     configSchema: {
       type: "object",
+      title: "Browser Configuration",
+      description: "Configure browser automation settings",
+      required: ["vmIsolation"],
       properties: {
-        vmIsolation: { type: "string" },
-        headless: { type: "boolean" }
+        vmIsolation: {
+          type: "string",
+          title: "VM Isolation",
+          description: "Controls how browser instances are isolated between agents and projects",
+          enum: ["global", "agent", "project"],
+          default: "agent",
+          widget: "segmented"
+        }
       }
     },
     defaultConfig: { headless: true, vmIsolation: "agent" }
@@ -7186,8 +7205,17 @@ var sqlPlugin = {
     ],
     configSchema: {
       type: "object",
+      title: "SQL Configuration",
+      description: "Configure database connection settings",
+      required: ["databaseKeys"],
       properties: {
-        databaseKeys: { type: "array", items: { type: "string" }, widget: "databaseSelect" }
+        databaseKeys: {
+          type: "array",
+          title: "Select Databases",
+          description: "Select databases this agent can access (multi-select from registered databases)",
+          items: { type: "string" },
+          widget: "databaseSelect"
+        }
       }
     },
     defaultConfig: { databaseKeys: [] }
@@ -8201,7 +8229,32 @@ var skillPlugin = {
   meta: {
     type: "skill",
     name: "Skills",
-    description: "Provides skill loading capabilities for the agent"
+    description: "Provides skill loading capabilities for the agent",
+    configSchema: {
+      type: "object",
+      title: "Skills Configuration",
+      description: "Configure which skills this agent can use",
+      properties: {
+        readAll: {
+          type: "boolean",
+          title: "Read All Skills",
+          description: "When enabled, the agent will have access to all available skills automatically",
+          default: false,
+          widget: "switch"
+        },
+        skills: {
+          type: "array",
+          title: "Select Skills",
+          description: "Select which skills this agent can use (ignored if 'Read All Skills' is enabled)",
+          items: { type: "string" },
+          widget: "skillSelect"
+        }
+      }
+    },
+    defaultConfig: {
+      readAll: false,
+      skills: []
+    }
   },
   middleware: (cfg) => createSkillMiddleware(cfg)
 };
@@ -9079,8 +9132,18 @@ var filesystemPlugin = {
     description: "Provides file system operations for reading, writing, and managing files",
     configSchema: {
       type: "object",
+      title: "Filesystem Configuration",
+      description: "Configure filesystem isolation and access settings",
+      required: ["vmIsolation"],
       properties: {
-        vmIsolation: { type: "string" }
+        vmIsolation: {
+          type: "string",
+          title: "VM Isolation",
+          description: "Controls how filesystem access is isolated between agents and projects",
+          enum: ["global", "agent", "project"],
+          default: "global",
+          widget: "segmented"
+        }
       }
     },
     defaultConfig: { vmIsolation: "global" }
@@ -9137,9 +9200,23 @@ var metricsPlugin = {
     ],
     configSchema: {
       type: "object",
+      title: "Metrics Configuration",
+      description: "Configure metrics server access settings",
       properties: {
-        connectAll: { type: "boolean" },
-        serverKeys: { type: "array", items: { type: "string" } }
+        connectAll: {
+          type: "boolean",
+          title: "Connect All Servers",
+          description: "When enabled, the agent will connect to all available metrics servers automatically",
+          default: false,
+          widget: "switch"
+        },
+        serverKeys: {
+          type: "array",
+          title: "Select Metrics Servers",
+          description: "Select metrics servers this agent can query (ignored if 'Connect All Servers' is enabled)",
+          items: { type: "string" },
+          widget: "metricsSelect"
+        }
       }
     },
     defaultConfig: { connectAll: false, serverKeys: [] }
@@ -9748,9 +9825,23 @@ var collectionPlugin = {
     ],
     configSchema: {
       type: "object",
+      title: "Collection Configuration",
+      description: "Configure collection access for this agent",
       properties: {
-        connectAll: { type: "boolean" },
-        collectionKeys: { type: "array", items: { type: "string" } }
+        connectAll: {
+          type: "boolean",
+          title: "Connect All Collections",
+          description: "When enabled, the agent will have access to all collections automatically",
+          default: false,
+          widget: "switch"
+        },
+        collectionKeys: {
+          type: "array",
+          title: "Select Collections",
+          description: "Select which collections this agent can access",
+          items: { type: "string" },
+          widget: "collectionSelect"
+        }
       }
     },
     defaultConfig: { connectAll: false, collectionKeys: [] }
@@ -9767,10 +9858,10 @@ import { tool as tool51 } from "langchain";
 import z54 from "zod";
 var questionSchema = z54.object({
   question: z54.string().describe("The question text to ask the user"),
-  options: z54.array(z54.string()).optional().default([]).describe("List of EXACT, selectable values. Maximum 3 options allowed. DO NOT include any 'placeholder' options that require the user to type (e.g., do NOT add 'Enter manual value'). If manual input is needed, set allowOther to true instead. For file_upload questions, pass an empty array."),
-  type: z54.enum(["single", "multiple", "file_upload"]).describe("Whether the question allows single selection, multiple selections, or expects a file upload. file_upload questions render a file picker component and the uploaded file path is returned as the answer."),
+  options: z54.array(z54.string()).optional().default([]).describe("List of EXACT, selectable values. Maximum 3 options allowed. DO NOT include placeholder values like 'Other' or 'Enter manually'. For free-text with predefined choices, use allowOther=true (works with 'single' and 'multiple'). For pure free-text without choices, use type='input' instead. For file_upload and input, pass an empty array."),
+  type: z54.enum(["single", "multiple", "file_upload", "input"]).describe("The question format. 'single' = pick one from options (default, see tool description for guidance). 'multiple' = pick several from options. 'input' = free-text field (only when options cannot express the answer). 'file_upload' = file picker."),
   required: z54.boolean().optional().default(false).describe("Whether this question must be answered"),
-  allowOther: z54.boolean().optional().default(true).describe("Set to true to append an 'Other' option that opens a free-text input field. Use this for open-ended answers or when the 3 options cannot cover all possibilities.")
+  allowOther: z54.boolean().optional().default(true).describe("Set to true to append an 'Other' checkbox with a free-text input field. Works with 'single' and 'multiple' types. Use for open-ended answers or when the options cannot cover all possibilities. Not applicable for 'input' or 'file_upload' types.")
 });
 var inputSchema = z54.object({
   questions: z54.array(questionSchema).min(1, "At least one question is required").describe("A structured sequence of clarification questions. Use these to gather missing parameters or disambiguate user intent before proceeding.")
@@ -9782,7 +9873,7 @@ function createAskUserToClarifyTool() {
     },
     {
       name: "ask_user_to_clarify",
-      description: "Prompts the user to choose from a list of predefined values, provide custom input, or upload a file. USE CASES: 1. Use 'options' ONLY for distinct, mutually exclusive choices (e.g., ['Standard', 'Express']). 2. Set 'allowOther: true' ONLY when you need to capture free-text information that doesn't fit into the predefined options. 3. Use type: 'file_upload' to ask the user to upload a file \u2014 options can be an empty array for this type. IMPORTANT: Never put placeholders like 'Please specify' or 'Other' inside the 'options' list. ",
+      description: "Ask the user clarifying questions using the most appropriate question type. TYPE SELECTION GUIDE (in priority order \u2014 prefer earlier types when possible):\n1. type: 'single' \u2014 DEFAULT for most cases. Use when the user must pick ONE from a known set (e.g., ['Yes', 'No'], ['Standard', 'Express', 'Priority']). Max 3 options. Best UX: click, no typing.\n2. type: 'multiple' \u2014 Use when the user can select SEVERAL from a known set (e.g., ['Email', 'SMS', 'Push']).\n3. type: 'input' \u2014 Use when the answer is purely free-text and CANNOT be enumerated (e.g., name, email, arbitrary description). Only use this when 'single' + options is not feasible.\n4. type: 'file_upload' \u2014 Use ONLY when the user needs to upload a file. Do NOT use for text input.\n\nallowOther: true \u2014 Escape hatch for 'single' and 'multiple' types. Adds an 'Other' checkbox with a text field. Use when the options MIGHT not cover everything. Do NOT set allowOther on 'input' or 'file_upload' types.\n\nANTI-PATTERNS: Never put 'Other' or 'Enter manually' inside the options array. Never use 'input' when 'single' + options would work. Never use 'file_upload' for text input.",
       schema: inputSchema
     }
   );
@@ -9859,7 +9950,11 @@ function createAskUserClarifyMiddleware() {
           parts.push(...answer.selectedOptions ?? []);
         }
         if (answer.otherText && answer.otherText.trim() !== "") {
-          parts.push(`Other: ${answer.otherText.trim()}`);
+          if (question.type === "input") {
+            parts.push(answer.otherText.trim());
+          } else {
+            parts.push(`Other: ${answer.otherText.trim()}`);
+          }
         }
         if (answer.filePath && answer.filePath.trim() !== "") {
           parts.push(`File: ${answer.filePath.trim()}`);
@@ -9881,7 +9976,14 @@ var askUserClarifyPlugin = {
   meta: {
     type: "ask_user_to_clarify",
     name: "Ask User To Clarify",
-    description: "Enables the agent to ask users clarifying questions"
+    description: "Enables the agent to ask users clarifying questions",
+    configSchema: {
+      type: "object",
+      title: "Ask User To Clarify Configuration",
+      description: "Configure user clarification settings",
+      properties: {}
+    },
+    defaultConfig: {}
   },
   middleware: () => createAskUserClarifyMiddleware()
 };
@@ -10779,7 +10881,14 @@ var widgetPlugin = {
   meta: {
     type: "widget",
     name: "Widget",
-    description: "Enables the agent to render interactive HTML widgets"
+    description: "Enables the agent to render interactive HTML widgets",
+    configSchema: {
+      type: "object",
+      title: "Widget Configuration",
+      description: "Configure widget rendering capabilities (zero configuration required)",
+      properties: {}
+    },
+    defaultConfig: {}
   },
   middleware: () => createWidgetMiddleware()
 };
@@ -11402,7 +11511,24 @@ var clawPlugin = {
   meta: {
     type: "claw",
     name: "Memory",
-    description: "Injects and manages memory/bootstrap files in the runtime workspace"
+    description: "Injects and manages memory/bootstrap files in the runtime workspace",
+    configSchema: {
+      type: "object",
+      title: "Memory Configuration",
+      description: "Configure bootstrap file injection behavior",
+      properties: {
+        injectBootstrapFiles: {
+          type: "boolean",
+          title: "Inject Bootstrap Files",
+          description: "Automatically inject default bootstrap files into the workspace context",
+          default: true,
+          widget: "switch"
+        }
+      }
+    },
+    defaultConfig: {
+      injectBootstrapFiles: true
+    }
   },
   middleware: (cfg) => createClawMiddleware(cfg)
 };
@@ -11598,7 +11724,46 @@ var datePlugin = {
   meta: {
     type: "date",
     name: "Current Date",
-    description: "Injects the current date into the agent system prompt"
+    description: "Injects the current date into the agent system prompt",
+    configSchema: {
+      type: "object",
+      title: "Date Configuration",
+      description: "Configure timezone for the current date",
+      properties: {
+        timezone: {
+          type: "string",
+          title: "Timezone",
+          description: "Select timezone for displaying the current date",
+          default: "UTC",
+          enumLabels: {
+            "UTC": "UTC (Coordinated Universal Time)",
+            "America/New_York": "New York (EST/EDT)",
+            "America/Chicago": "Chicago (CST/CDT)",
+            "America/Denver": "Denver (MST/MDT)",
+            "America/Los_Angeles": "Los Angeles (PST/PDT)",
+            "America/Toronto": "Toronto (EST/EDT)",
+            "America/Sao_Paulo": "S\xE3o Paulo (BRT)",
+            "Europe/London": "London (GMT/BST)",
+            "Europe/Paris": "Paris (CET/CEST)",
+            "Europe/Berlin": "Berlin (CET/CEST)",
+            "Europe/Moscow": "Moscow (MSK)",
+            "Asia/Dubai": "Dubai (GST)",
+            "Asia/Kolkata": "Kolkata (IST)",
+            "Asia/Shanghai": "Shanghai (CST)",
+            "Asia/Hong_Kong": "Hong Kong (HKT)",
+            "Asia/Singapore": "Singapore (SGT)",
+            "Asia/Tokyo": "Tokyo (JST)",
+            "Asia/Seoul": "Seoul (KST)",
+            "Australia/Sydney": "Sydney (AEDT/AEST)",
+            "Pacific/Auckland": "Auckland (NZDT/NZST)"
+          },
+          widget: "select"
+        }
+      }
+    },
+    defaultConfig: {
+      timezone: "UTC"
+    }
   },
   middleware: (cfg) => createDateMiddleware(cfg)
 };
@@ -14622,7 +14787,25 @@ var schedulerPlugin = {
   meta: {
     type: "scheduler",
     name: "Scheduler",
-    description: "Enables the agent to schedule future work"
+    description: "Enables the agent to schedule future work",
+    configSchema: {
+      type: "object",
+      title: "Scheduler Configuration",
+      description: "Configure retry behavior for scheduled tasks",
+      properties: {
+        defaultMaxRetries: {
+          type: "integer",
+          title: "Default Max Retries",
+          description: "Default retry count for scheduled tasks created through the middleware",
+          default: 0,
+          minimum: 0,
+          widget: "numberInput"
+        }
+      }
+    },
+    defaultConfig: {
+      defaultMaxRetries: 0
+    }
   },
   middleware: (cfg) => createSchedulerMiddleware(cfg)
 };
@@ -14762,7 +14945,14 @@ var taskPlugin = {
   meta: {
     type: "task",
     name: "Task Management",
-    description: "Enables persistent task management with delegation and tracking"
+    description: "Enables persistent task management with delegation and tracking",
+    configSchema: {
+      type: "object",
+      title: "Task Management Configuration",
+      description: "Zero-configuration task management",
+      properties: {}
+    },
+    defaultConfig: {}
   },
   middleware: () => createTaskMiddleware()
 };
@@ -15760,17 +15950,17 @@ function getAsyncPromptText() {
 
 ## Async Task Usage
 
-When tasks are independent and can run in parallel, use \`async: true\` to launch
-background tasks. The task returns immediately with a task ID.
+**IMPORTANT: Only use \`async: true\` when the USER explicitly requests it.** Do NOT set \`async: true\` on your own initiative, even if tasks appear independent or parallelizable. The user must explicitly ask for background/async execution, for example: "run this in the background", "do this asynchronously", "fire and forget", or "let me know when it's done".
+
+If the user does NOT explicitly request async execution, always use \`async: false\` (the default) so the task runs synchronously and the result is available immediately.
 
-CRITICAL: After launching with \`async: true\`, move on immediately.
-- NEVER call check_async_task or list_async_tasks right after starting a task.
+When \`async: true\` IS explicitly requested by the user:
+- The task returns immediately with a task ID.
+- Move on immediately after launching. NEVER call check_async_task or list_async_tasks right after starting a task.
 - NEVER poll for task completion. The result will arrive as a notification.
 - Only check task status when the USER explicitly asks for an update.
-- If you receive an [Async task completed] notification, read it and incorporate
-  the result into your next response. Do not then call check_async_task repeatedly.
-- Task statuses in conversation history are stale \u2014 always use fresh tool calls
-  when the user asks.
+- If you receive an [Async task completed] notification, read it and incorporate the result into your next response. Do not then call check_async_task repeatedly.
+- Task statuses in conversation history are stale \u2014 always use fresh tool calls when the user asks.
 - Use cancel_async_task if the user wants to stop a running task.
 - Keep the full task_id: never truncate or abbreviate it.`;
 }
@@ -21662,7 +21852,10 @@ registerToolLattice(
   },
   async (input, exeConfig) => {
     try {
-      const tenantId = getTenantId(exeConfig);
+      const parentRunConfig = exeConfig?.configurable?.runConfig || {};
+      const tenantId = parentRunConfig.tenantId || "default";
+      const workspaceId = parentRunConfig.workspaceId;
+      const projectId = parentRunConfig.projectId;
       const { id, message } = input;
       const store = getAssistStore();
       const existing = await store.getAssistantById(tenantId, id);
@@ -21673,7 +21866,9 @@ registerToolLattice(
       const agent = new Agent({
         tenant_id: tenantId,
         assistant_id: id,
-        thread_id: threadId
+        thread_id: threadId,
+        workspace_id: workspaceId,
+        project_id: projectId
       });
       const result = await agent.invokeWithState({ input: { message } });
       return JSON.stringify({ agentId: id, threadId, result });