@objectstack/service-ai 7.2.0 → 7.3.0

package/dist/index.d.ts

@@ -861,10 +861,22 @@ declare const createObjectTool: {
     requiresConfirmation: boolean;
     active: boolean;
     builtIn: boolean;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /**
@@ -882,10 +894,22 @@ declare const addFieldTool: {
     requiresConfirmation: boolean;
     active: boolean;
     builtIn: boolean;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /**
@@ -902,10 +926,22 @@ declare const modifyFieldTool: {
     requiresConfirmation: boolean;
     active: boolean;
     builtIn: boolean;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /**
@@ -922,10 +958,22 @@ declare const deleteFieldTool: {
     requiresConfirmation: boolean;
     active: boolean;
     builtIn: boolean;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /**
@@ -943,10 +991,22 @@ declare const listObjectsTool: {
     requiresConfirmation: boolean;
     active: boolean;
     builtIn: boolean;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /**
@@ -964,10 +1024,22 @@ declare const describeObjectTool: {
     requiresConfirmation: boolean;
     active: boolean;
     builtIn: boolean;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /** All built-in metadata management tool definitions (Tool metadata). */
@@ -1068,10 +1140,22 @@ declare const listPackagesTool: {
     requiresConfirmation: boolean;
     active: boolean;
     builtIn: boolean;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /**
@@ -1087,10 +1171,22 @@ declare const getPackageTool: {
     requiresConfirmation: boolean;
     active: boolean;
     builtIn: boolean;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /**
@@ -1107,10 +1203,22 @@ declare const createPackageTool: {
     requiresConfirmation: boolean;
     active: boolean;
     builtIn: boolean;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /**
@@ -1126,10 +1234,22 @@ declare const getActivePackageTool: {
     requiresConfirmation: boolean;
     active: boolean;
     builtIn: boolean;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /**
@@ -1146,10 +1266,22 @@ declare const setActivePackageTool: {
     requiresConfirmation: boolean;
     active: boolean;
     builtIn: boolean;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /** All built-in package management tool definitions (Tool metadata). */
@@ -1605,38 +1737,18 @@ declare class AgentRuntime {
      * chat endpoint when the client doesn't specify an `agentName`.
      *
      * Resolution order:
-     * 1. The `defaultAgent` of the app named by `context.appName`.
-     * 2. The first active agent in the registry (deterministic fallback).
-     * 3. `undefined` if no agents are registered.
+     * 1. The `defaultAgent` of the app named by `context.appName`
+     *    (e.g. Studio → `metadata_assistant`).
+     * 2. The platform data-query agent (`data_chat`) — the implicit
+     *    copilot bound to every app that doesn't pin its own. This is
+     *    what end users get by default, so they never have to choose.
+     * 3. The first active agent in the registry (last-resort fallback,
+     *    e.g. in stripped-down deployments without the data agent).
+     * 4. `undefined` if no agents are registered.
      */
     resolveDefaultAgent(context?: AgentChatContext): Promise<Agent | undefined>;
 }
 
-/**
- * Built-in `data_chat` agent — a thin **persona** record.
- *
- * Following the platform's metadata-driven philosophy, this agent no
- * longer hardcodes the tools it can call. The capability bundle lives
- * on the `data_explorer` *skill* (see `../skills/data-explorer-skill.ts`).
- * The agent record is now just:
- *   - identity (name / label / role)
- *   - persona (system prompt)
- *   - model + safety config
- *   - skills attached → `skills: ['data_explorer']`
- *
- * To grant data-exploration powers to a different agent, just add
- * `data_explorer` to its `skills[]`. To revoke globally, set the
- * skill's `active: false` in metadata.
- *
- * @example
- * ```
- * POST /api/v1/ai/agents/data_chat/chat
- * {
- *   "messages": [{ "role": "user", "content": "Show me all active accounts" }],
- *   "context": { "objectName": "account" }
- * }
- * ```
- */
 declare const DATA_CHAT_AGENT: Agent;
 
 /**
@@ -1964,6 +2076,7 @@ declare const AiConversationObject: Omit<{
     _provenance?: "package" | "env-forced" | "org" | undefined;
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
     label?: string | undefined;
     pluralLabel?: string | undefined;
     description?: string | undefined;
@@ -2353,7 +2466,7 @@ declare const AiConversationObject: Omit<{
         apiMethods?: ("restore" | "export" | "import" | "delete" | "purge" | "upsert" | "search" | "create" | "list" | "get" | "update" | "history" | "bulk" | "aggregate")[] | undefined;
     } | undefined;
     recordTypes?: string[] | undefined;
-    sharingModel?: "private" | "full" | "read" | "read_write" | undefined;
+    sharingModel?: "full" | "private" | "read" | "read_write" | undefined;
     publicSharing?: {
         enabled: boolean;
         allowedAudiences?: ("email" | "public" | "link_only" | "signed_in")[] | undefined;
@@ -2456,6 +2569,11 @@ declare const AiConversationObject: Omit<{
             role?: string | undefined;
         } | undefined;
     }[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 }, "fields"> & Pick<{
     readonly name: "ai_conversations";
     readonly label: "AI Conversation";
@@ -3925,6 +4043,7 @@ declare const AiMessageObject: Omit<{
     _provenance?: "package" | "env-forced" | "org" | undefined;
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
     label?: string | undefined;
     pluralLabel?: string | undefined;
     description?: string | undefined;
@@ -4314,7 +4433,7 @@ declare const AiMessageObject: Omit<{
         apiMethods?: ("restore" | "export" | "import" | "delete" | "purge" | "upsert" | "search" | "create" | "list" | "get" | "update" | "history" | "bulk" | "aggregate")[] | undefined;
     } | undefined;
     recordTypes?: string[] | undefined;
-    sharingModel?: "private" | "full" | "read" | "read_write" | undefined;
+    sharingModel?: "full" | "private" | "read" | "read_write" | undefined;
     publicSharing?: {
         enabled: boolean;
         allowedAudiences?: ("email" | "public" | "link_only" | "signed_in")[] | undefined;
@@ -4417,6 +4536,11 @@ declare const AiMessageObject: Omit<{
             role?: string | undefined;
         } | undefined;
     }[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 }, "fields"> & Pick<{
     readonly name: "ai_messages";
     readonly label: "AI Message";
@@ -6758,6 +6882,7 @@ declare const AiTraceObject: Omit<{
     _provenance?: "package" | "env-forced" | "org" | undefined;
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
     label?: string | undefined;
     pluralLabel?: string | undefined;
     description?: string | undefined;
@@ -7147,7 +7272,7 @@ declare const AiTraceObject: Omit<{
         apiMethods?: ("restore" | "export" | "import" | "delete" | "purge" | "upsert" | "search" | "create" | "list" | "get" | "update" | "history" | "bulk" | "aggregate")[] | undefined;
     } | undefined;
     recordTypes?: string[] | undefined;
-    sharingModel?: "private" | "full" | "read" | "read_write" | undefined;
+    sharingModel?: "full" | "private" | "read" | "read_write" | undefined;
     publicSharing?: {
         enabled: boolean;
         allowedAudiences?: ("email" | "public" | "link_only" | "signed_in")[] | undefined;
@@ -7250,6 +7375,11 @@ declare const AiTraceObject: Omit<{
             role?: string | undefined;
         } | undefined;
     }[] | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 }, "fields"> & Pick<{
     readonly name: "ai_traces";
     readonly label: "AI Trace";
@@ -10447,6 +10577,13 @@ declare const AiTraceObject: Omit<{
  * automatically in Studio when AIService is loaded.
  */
 declare const AiTraceView: {
+    _lock?: "none" | "full" | "no-overlay" | "no-delete" | undefined;
+    _lockReason?: string | undefined;
+    _lockSource?: "artifact" | "package" | "env-forced" | undefined;
+    _provenance?: "package" | "env-forced" | "org" | undefined;
+    _packageId?: string | undefined;
+    _packageVersion?: string | undefined;
+    _lockDocsUrl?: string | undefined;
     list?: {
         type: "map" | "kanban" | "calendar" | "gantt" | "gallery" | "timeline" | "chart" | "grid";
         columns: string[] | {
@@ -11147,6 +11284,11 @@ declare const AiTraceView: {
             role?: string | undefined;
         } | undefined;
     }> | undefined;
+    protection?: {
+        lock: "none" | "full" | "no-overlay" | "no-delete";
+        reason: string;
+        docsUrl?: string | undefined;
+    } | undefined;
 };
 
 /**

package/dist/index.js

@@ -189,6 +189,7 @@ var init_data_tools = __esm({
     DEFAULT_QUERY_LIMIT = 20;
     QUERY_RECORDS_TOOL = {
       name: "query_records",
+      label: "Query Records",
       description: "Query records from a data object with optional filters, field selection, sorting, and pagination. Returns an array of matching records.",
       parameters: {
         type: "object",
@@ -234,6 +235,7 @@ var init_data_tools = __esm({
     };
     GET_RECORD_TOOL = {
       name: "get_record",
+      label: "Get Record",
       description: "Get a single record by its ID from a data object.",
       parameters: {
         type: "object",
@@ -258,6 +260,7 @@ var init_data_tools = __esm({
     };
     AGGREGATE_DATA_TOOL = {
       name: "aggregate_data",
+      label: "Aggregate Data",
       description: "Perform aggregation/statistical operations on a data object. Supports count, sum, avg, min, max with optional groupBy and where filters.",
       parameters: {
         type: "object",
@@ -2305,6 +2308,7 @@ function cryptoRandomId() {
 }
 
 // src/plugin.ts
+import { readEnvWithDeprecation } from "@objectstack/types";
 import { EMBEDDER_SERVICE } from "@objectstack/spec/contracts";
 
 // src/stream/vercel-stream-encoder.ts
@@ -5194,6 +5198,7 @@ var QueryPlanSchema = z2.object({
 });
 var QUERY_DATA_TOOL = {
   name: "query_data",
+  label: "Query Data (Natural Language)",
   description: "Answer a natural-language question about the user's data. Internally retrieves the relevant object schema, generates an ObjectQL query, executes it, and returns the matching records. Prefer this tool over `query_records` / `aggregate_data` when the user's intent is expressed in plain language.",
   parameters: {
     type: "object",
@@ -5713,6 +5718,82 @@ async function registerActionsAsTools(registry, context) {
 
 // src/agent-runtime.ts
 import { AgentSchema } from "@objectstack/spec/ai";
+
+// src/agents/data-chat-agent.ts
+var DEFAULT_DATA_AGENT_NAME = "data_chat";
+var DATA_CHAT_AGENT = {
+  name: DEFAULT_DATA_AGENT_NAME,
+  label: "Data Assistant",
+  role: "Business Data Analyst",
+  instructions: `You are a helpful data assistant that helps users explore and understand their business data through natural language.
+
+Always answer in the same language the user is using. Detailed tool-usage guidance is supplied by the skills attached to this agent.`,
+  model: {
+    provider: "openai",
+    model: "gpt-4",
+    temperature: 0.3,
+    maxTokens: 4096
+  },
+  // Capability bundle lives on the skill; the agent only references it.
+  // `data_explorer` = read side, `actions_executor` = write side.
+  skills: ["data_explorer", "actions_executor"],
+  active: true,
+  visibility: "global",
+  guardrails: {
+    maxTokensPerInvocation: 8192,
+    maxExecutionTimeSec: 30,
+    blockedTopics: ["delete_records", "drop_table", "alter_schema"]
+  },
+  planning: {
+    strategy: "react",
+    maxIterations: 5,
+    allowReplan: false
+  },
+  memory: {
+    shortTerm: {
+      maxMessages: 20,
+      maxTokens: 4096
+    }
+  }
+};
+
+// src/agents/metadata-assistant-agent.ts
+var METADATA_ASSISTANT_AGENT = {
+  name: "metadata_assistant",
+  label: "Metadata Assistant",
+  role: "Schema Architect",
+  instructions: `You are an expert metadata architect that helps users design and manage their data models through natural language.
+
+Always answer in the same language the user is using. If the user's request is ambiguous, ask clarifying questions before proceeding. Detailed tool-usage guidance is supplied by the skills attached to this agent.`,
+  model: {
+    provider: "openai",
+    model: "gpt-4",
+    temperature: 0.2,
+    maxTokens: 4096
+  },
+  // Capability bundle lives on the skill; the agent only references it.
+  skills: ["metadata_authoring"],
+  active: true,
+  visibility: "global",
+  guardrails: {
+    maxTokensPerInvocation: 8192,
+    maxExecutionTimeSec: 60,
+    blockedTopics: ["drop_database", "raw_sql", "system_tables"]
+  },
+  planning: {
+    strategy: "react",
+    maxIterations: 10,
+    allowReplan: true
+  },
+  memory: {
+    shortTerm: {
+      maxMessages: 30,
+      maxTokens: 8192
+    }
+  }
+};
+
+// src/agent-runtime.ts
 var AgentRuntime = class {
   constructor(metadataService, skillRegistry) {
     this.metadataService = metadataService;
@@ -5863,9 +5944,14 @@ var AgentRuntime = class {
    * chat endpoint when the client doesn't specify an `agentName`.
    *
    * Resolution order:
-   * 1. The `defaultAgent` of the app named by `context.appName`.
-   * 2. The first active agent in the registry (deterministic fallback).
-   * 3. `undefined` if no agents are registered.
+   * 1. The `defaultAgent` of the app named by `context.appName`
+   *    (e.g. Studio → `metadata_assistant`).
+   * 2. The platform data-query agent (`data_chat`) — the implicit
+   *    copilot bound to every app that doesn't pin its own. This is
+   *    what end users get by default, so they never have to choose.
+   * 3. The first active agent in the registry (last-resort fallback,
+   *    e.g. in stripped-down deployments without the data agent).
+   * 4. `undefined` if no agents are registered.
    */
   async resolveDefaultAgent(context) {
     if (context?.appName) {
@@ -5876,6 +5962,8 @@ var AgentRuntime = class {
         if (agent && agent.active !== false) return agent;
       }
     }
+    const dataAgent = await this.loadAgent(DEFAULT_DATA_AGENT_NAME);
+    if (dataAgent && dataAgent.active !== false) return dataAgent;
     const summaries = await this.listAgents();
     if (summaries.length === 0) return void 0;
     return this.loadAgent(summaries[0].name);
@@ -6071,79 +6159,6 @@ var SkillRegistry = class {
   }
 };
 
-// src/agents/data-chat-agent.ts
-var DATA_CHAT_AGENT = {
-  name: "data_chat",
-  label: "Data Assistant",
-  role: "Business Data Analyst",
-  instructions: `You are a helpful data assistant that helps users explore and understand their business data through natural language.
-
-Always answer in the same language the user is using. Detailed tool-usage guidance is supplied by the skills attached to this agent.`,
-  model: {
-    provider: "openai",
-    model: "gpt-4",
-    temperature: 0.3,
-    maxTokens: 4096
-  },
-  // Capability bundle lives on the skill; the agent only references it.
-  // `data_explorer` = read side, `actions_executor` = write side.
-  skills: ["data_explorer", "actions_executor"],
-  active: true,
-  visibility: "global",
-  guardrails: {
-    maxTokensPerInvocation: 8192,
-    maxExecutionTimeSec: 30,
-    blockedTopics: ["delete_records", "drop_table", "alter_schema"]
-  },
-  planning: {
-    strategy: "react",
-    maxIterations: 5,
-    allowReplan: false
-  },
-  memory: {
-    shortTerm: {
-      maxMessages: 20,
-      maxTokens: 4096
-    }
-  }
-};
-
-// src/agents/metadata-assistant-agent.ts
-var METADATA_ASSISTANT_AGENT = {
-  name: "metadata_assistant",
-  label: "Metadata Assistant",
-  role: "Schema Architect",
-  instructions: `You are an expert metadata architect that helps users design and manage their data models through natural language.
-
-Always answer in the same language the user is using. If the user's request is ambiguous, ask clarifying questions before proceeding. Detailed tool-usage guidance is supplied by the skills attached to this agent.`,
-  model: {
-    provider: "openai",
-    model: "gpt-4",
-    temperature: 0.2,
-    maxTokens: 4096
-  },
-  // Capability bundle lives on the skill; the agent only references it.
-  skills: ["metadata_authoring"],
-  active: true,
-  visibility: "global",
-  guardrails: {
-    maxTokensPerInvocation: 8192,
-    maxExecutionTimeSec: 60,
-    blockedTopics: ["drop_database", "raw_sql", "system_tables"]
-  },
-  planning: {
-    strategy: "react",
-    maxIterations: 10,
-    allowReplan: true
-  },
-  memory: {
-    shortTerm: {
-      maxMessages: 30,
-      maxTokens: 8192
-    }
-  }
-};
-
 // src/skills/data-explorer-skill.ts
 var DATA_EXPLORER_SKILL = {
   name: "data_explorer",
@@ -6710,7 +6725,7 @@ var _AIServicePlugin = class _AIServicePlugin {
           );
           const provider = mod[factory] ?? mod.default;
           if (typeof provider === "function") {
-            const modelId = process.env.AI_MODEL ?? defaultModel;
+            const modelId = readEnvWithDeprecation("OS_AI_MODEL", "AI_MODEL") ?? defaultModel;
             const useChatApi = factory === "openai" && typeof provider.chat === "function";
             const model = useChatApi ? provider.chat(modelId) : provider(modelId);
             const adapter = new VercelLLMAdapter({ model });
@@ -6803,7 +6818,7 @@ var _AIServicePlugin = class _AIServicePlugin {
       name: "AI Service",
       version: "1.0.0",
       type: "plugin",
-      scope: "project",
+      scope: "system",
       namespace: "ai",
       objects: [AiConversationObject, AiMessageObject, AiTraceObject, AiPendingActionObject, AiEvalCaseObject, AiEvalRunObject],
       views: [AiTraceView, AiMessageView, AiPendingActionView, AiEvalCaseView, AiEvalRunView]
@@ -6906,7 +6921,8 @@ var _AIServicePlugin = class _AIServicePlugin {
             }
             if (!toolExists) {
               try {
-                await withTimeout(metadataService.register("tool", toolDef.name, toolDef));
+                const label = toolDef.label ?? toToolLabel(toolDef.name);
+                await withTimeout(metadataService.register("tool", toolDef.name, { ...toolDef, label }));
               } catch (err) {
                 ctx.logger.warn(
                   "[AI] Failed to persist tool metadata (non-fatal)",
@@ -7324,6 +7340,9 @@ _AIServicePlugin.OPENAI_COMPATIBLE_PRESETS = {
   openrouter: { baseURL: "https://openrouter.ai/api/v1", defaultModel: "openai/gpt-4o-mini" }
 };
 var AIServicePlugin = _AIServicePlugin;
+function toToolLabel(name) {
+  return name.split("_").filter(Boolean).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
 function extractOverrides(payload) {
   if (!payload || typeof payload !== "object") return {};
   const p = payload;