@objectstack/service-ai 7.2.1 → 7.3.0

package/dist/index.d.cts

@@ -868,7 +868,7 @@ declare const createObjectTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -901,7 +901,7 @@ declare const addFieldTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -933,7 +933,7 @@ declare const modifyFieldTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -965,7 +965,7 @@ declare const deleteFieldTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -998,7 +998,7 @@ declare const listObjectsTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1031,7 +1031,7 @@ declare const describeObjectTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1147,7 +1147,7 @@ declare const listPackagesTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1178,7 +1178,7 @@ declare const getPackageTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1210,7 +1210,7 @@ declare const createPackageTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1241,7 +1241,7 @@ declare const getActivePackageTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1273,7 +1273,7 @@ declare const setActivePackageTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1737,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;
 
 /**

package/dist/index.d.ts

@@ -868,7 +868,7 @@ declare const createObjectTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -901,7 +901,7 @@ declare const addFieldTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -933,7 +933,7 @@ declare const modifyFieldTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -965,7 +965,7 @@ declare const deleteFieldTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -998,7 +998,7 @@ declare const listObjectsTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1031,7 +1031,7 @@ declare const describeObjectTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1147,7 +1147,7 @@ declare const listPackagesTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1178,7 +1178,7 @@ declare const getPackageTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1210,7 +1210,7 @@ declare const createPackageTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1241,7 +1241,7 @@ declare const getActivePackageTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1273,7 +1273,7 @@ declare const setActivePackageTool: {
     _packageId?: string | undefined;
     _packageVersion?: string | undefined;
     _lockDocsUrl?: string | undefined;
-    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "analytics" | "integration" | undefined;
+    category?: "action" | "flow" | "vector_search" | "data" | "utility" | "integration" | "analytics" | undefined;
     outputSchema?: Record<string, unknown> | undefined;
     objectName?: string | undefined;
     permissions?: string[] | undefined;
@@ -1737,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;
 
 /**

package/dist/index.js

@@ -5718,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;
@@ -5868,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) {
@@ -5881,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);
@@ -6076,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",