@objectstack/service-ai 7.2.0 → 7.3.0

package/dist/index.cjs

@@ -201,6 +201,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",
@@ -246,6 +247,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",
@@ -270,6 +272,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",
@@ -2379,6 +2382,7 @@ function cryptoRandomId() {
 }
 
 // src/plugin.ts
+var import_types = require("@objectstack/types");
 var import_contracts = require("@objectstack/spec/contracts");
 
 // src/stream/vercel-stream-encoder.ts
@@ -5268,6 +5272,7 @@ var QueryPlanSchema = import_zod2.z.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",
@@ -5787,6 +5792,82 @@ async function registerActionsAsTools(registry, context) {
 
 // src/agent-runtime.ts
 var import_ai7 = require("@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;
@@ -5937,9 +6018,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) {
@@ -5950,6 +6036,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);
@@ -6145,79 +6233,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",
@@ -6784,7 +6799,7 @@ var _AIServicePlugin = class _AIServicePlugin {
           );
           const provider = mod[factory] ?? mod.default;
           if (typeof provider === "function") {
-            const modelId = process.env.AI_MODEL ?? defaultModel;
+            const modelId = (0, import_types.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 });
@@ -6877,7 +6892,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]
@@ -6980,7 +6995,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)",
@@ -7398,6 +7414,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;