@agentforge-io/core 2.0.1 → 2.0.3

package/dist/services/agent.service.js

@@ -315,11 +315,16 @@ exports.AgentService = AgentService;
  * Map a persisted `AgentRecord` to the runtime `AgentDefinition` the runner
  * expects. The `context` column (plain-text knowledge) is prepended to the
  * system prompt — the cheapest path before RAG is implemented.
+ *
+ * Extra host fields (`appearance`, `slug`) are passed through as opaque
+ * properties so callers like `PublicChatController` can surface them to the
+ * widget. The runner ignores anything it doesn't recognize.
  */
 function toAgentDefinition(record) {
     const systemPrompt = record.context
         ? `${record.systemPrompt}\n\n--- Knowledge ---\n${record.context}`
         : record.systemPrompt;
+    const extra = record;
     return {
         id: record.id,
         name: record.name,
@@ -333,5 +338,7 @@ function toAgentDefinition(record) {
         mcpServers: record.mcpServers,
         metadata: record.metadata,
         connectorOwnerUserId: record.connectorOwnerUserId,
+        ...(record.slug !== undefined ? { slug: record.slug } : {}),
+        ...(extra.appearance !== undefined ? { appearance: extra.appearance } : {}),
     };
 }

package/dist/services/mcp-client.service.js

@@ -68,6 +68,9 @@ class McpClientService {
                 execute: async (input) => {
                     return this.callTool(config.name, tool.name, input);
                 },
+                // Carry the MCP origin through to the registry so /tools can label
+                // and group these distinctly from built-ins / connector tools.
+                mcpServerName: config.name,
             };
             this.registry.register(wrapped);
             handles.push({

package/dist/services/mcp-server.service.d.ts

@@ -31,13 +31,26 @@ export declare class McpServerService {
     constructor(repo: McpServerRepository, client?: McpClientService | undefined);
     create(input: CreateMcpServerInput): Promise<McpServerRecord>;
     listForTenant(tenantId: string): Promise<McpServerRecord[]>;
+    /**
+     * Active rows across every tenant. The platform's boot orchestrator uses
+     * this to (re)connect MCPs after a process restart; per-request code
+     * paths should keep using `listForTenant` to avoid leaking other tenants'
+     * configs into a response.
+     */
+    listAllActive(): Promise<McpServerRecord[]>;
     getById(id: string): Promise<McpServerRecord>;
     getByIdForTenant(id: string, tenantId: string): Promise<McpServerRecord>;
     update(id: string, tenantId: string, patch: McpServerRecordPatch): Promise<McpServerRecord>;
     delete(id: string, tenantId: string): Promise<void>;
-    /** Boot path: connect to every active server across tenants. Failures
-     *  are logged but don't abort boot — a broken Notion key shouldn't keep
-     *  the rest of the platform from coming up. */
+    /**
+     * @deprecated Headers are passed through to `McpClientService.register`
+     * exactly as stored — no `{{KEY}}` resolution against the host's vault.
+     * Hosts wiring secrets-in-vault should call `listAllActive()` and run
+     * their own bootstrapper instead (see `apps/server/src/modules/mcp/`).
+     * This method survives only to keep the legacy in-lib `McpModule`
+     * working during the deprecation lap; it will be removed in the same
+     * release that drops `McpModule` itself.
+     */
     registerAllActive(): Promise<void>;
     private assertName;
     private assertUrl;

package/dist/services/mcp-server.service.js

@@ -57,6 +57,15 @@ class McpServerService {
     async listForTenant(tenantId) {
         return this.repo.listForTenant(tenantId);
     }
+    /**
+     * Active rows across every tenant. The platform's boot orchestrator uses
+     * this to (re)connect MCPs after a process restart; per-request code
+     * paths should keep using `listForTenant` to avoid leaking other tenants'
+     * configs into a response.
+     */
+    async listAllActive() {
+        return this.repo.listActive();
+    }
     async getById(id) {
         const r = await this.repo.findById(id);
         if (!r)
@@ -102,9 +111,15 @@ class McpServerService {
         }
         await this.repo.delete(id);
     }
-    /** Boot path: connect to every active server across tenants. Failures
-     *  are logged but don't abort boot — a broken Notion key shouldn't keep
-     *  the rest of the platform from coming up. */
+    /**
+     * @deprecated Headers are passed through to `McpClientService.register`
+     * exactly as stored — no `{{KEY}}` resolution against the host's vault.
+     * Hosts wiring secrets-in-vault should call `listAllActive()` and run
+     * their own bootstrapper instead (see `apps/server/src/modules/mcp/`).
+     * This method survives only to keep the legacy in-lib `McpModule`
+     * working during the deprecation lap; it will be removed in the same
+     * release that drops `McpModule` itself.
+     */
     async registerAllActive() {
         if (!this.client)
             return;

package/dist/services/tool-registry.service.d.ts

@@ -48,4 +48,11 @@ export interface ToolDescription {
     connectorId?: string;
     /** Human-readable connector label paired with `connectorId`. */
     connectorName?: string;
+    /**
+     * Set when this tool was discovered from an MCP server. The tool's
+     * `name` is already prefixed `<server>__<tool>`, but the UI uses this
+     * field to group tools by their MCP origin and label them distinctly
+     * from built-ins / connector tools.
+     */
+    mcpServerName?: string;
 }

package/dist/services/tool-registry.service.js

@@ -95,6 +95,9 @@ class ToolRegistryService {
             description: t.description,
             inputSchema: t.inputSchema,
             agents: t.agents,
+            ...(t.connectorId ? { connectorId: t.connectorId } : {}),
+            ...(t.connectorName ? { connectorName: t.connectorName } : {}),
+            ...(t.mcpServerName ? { mcpServerName: t.mcpServerName } : {}),
         }));
     }
 }

package/dist/types/agent.types.d.ts

@@ -90,6 +90,13 @@ export interface AgentToolDefinition {
     execute: (input: Record<string, unknown>, context: ToolExecutionContext) => Promise<string>;
     /** Restrict to specific agents */
     agents?: string[];
+    /** OAuth connector this tool belongs to. Set by ConnectorRegistryService
+     *  when materializing per-user toolbelts; left undefined for built-ins. */
+    connectorId?: string;
+    connectorName?: string;
+    /** MCP server this tool was discovered from. Set by McpClientService when
+     *  wrapping a remote tool; left undefined for built-ins and connector tools. */
+    mcpServerName?: string;
 }
 export interface ToolExecutionContext {
     userId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge-io/core",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Framework-free AI runtime SDK. Owns: agent loop (Anthropic), conversations, tools, streaming, agent-job queue, SdkHooks. Identity, billing, infra (email/uploads/secrets) live in the host's modules — not here.",
   "license": "MIT",
   "main": "dist/index.js",