@continuumdao/continuum-node-sdk 1.2.12 → 1.2.14

package/dist/api/node-read.d.ts

@@ -1,4 +1,4 @@
-/** GET and JWT-protected DELETE to mpc-auth with optional Bearer JWT (browser HTTPS / loopback). */
+/** GET, JWT-protected DELETE, and POST /agent/* with optional Bearer JWT (browser HTTPS / loopback). */
 export type NodeReadAuth = {
     bearerOnGet: boolean;
     jwt: string | null;

package/dist/api/node-read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-read.d.ts","sourceRoot":"","sources":["../../src/api/node-read.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB,CAAC;AAIF,wBAAgB,qBAAqB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,IAAI,EAAE,YAAY,GAChB,OAAO,CAAC,QAAQ,CAAC,CAOnB"}
+{"version":3,"file":"node-read.d.ts","sourceRoot":"","sources":["../../src/api/node-read.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,MAAM,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB,CAAC;AAyBF,wBAAgB,qBAAqB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,IAAI,EAAE,YAAY,GAChB,OAAO,CAAC,QAAQ,CAAC,CAOnB"}

package/dist/api/node-read.js

@@ -1,8 +1,31 @@
 const READ_JWT_METHODS = new Set(['GET', 'DELETE']);
+function requestPathname(url) {
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        try {
+            return new URL(url, 'http://localhost').pathname;
+        }
+        catch {
+            return '';
+        }
+    }
+}
+/** Management POSTs use signatures only; agent POSTs on browser HTTPS / loopback need the read JWT too. */
+function readJwtBearerRequired(method, url) {
+    const m = method.toUpperCase();
+    if (READ_JWT_METHODS.has(m))
+        return true;
+    if (m !== 'POST')
+        return false;
+    const path = requestPathname(url);
+    return path === '/agent' || path.startsWith('/agent/');
+}
 export function nodeFetchWithReadAuth(url, init, auth) {
     const method = (init?.method ?? 'GET').toUpperCase();
     const headers = new Headers(init?.headers);
-    if (auth.bearerOnGet && READ_JWT_METHODS.has(method) && auth.jwt?.trim()) {
+    if (auth.bearerOnGet && auth.jwt?.trim() && readJwtBearerRequired(method, url)) {
         headers.set('Authorization', `Bearer ${auth.jwt.trim()}`);
     }
     return fetch(url, { ...init, headers });

package/dist/api/node-read.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-read.js","sourceRoot":"","sources":["../../src/api/node-read.ts"],"names":[],"mappings":"AAMA,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CACpC,GAAW,EACX,IAA6B,EAC7B,IAAkB;IAElB,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,WAAW,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,EAAE,EAAC,GAAG,IAAI,EAAE,OAAO,EAAC,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"node-read.js","sourceRoot":"","sources":["../../src/api/node-read.ts"],"names":[],"mappings":"AAMA,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEpD,SAAS,eAAe,CAAC,GAAW;IACnC,IAAI,CAAC;QACJ,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACR,IAAI,CAAC;YACJ,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,QAAQ,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC;AACF,CAAC;AAED,2GAA2G;AAC3G,SAAS,qBAAqB,CAAC,MAAc,EAAE,GAAW;IACzD,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAC/B,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC/B,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACpC,GAAW,EACX,IAA6B,EAC7B,IAAkB;IAElB,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;QAChF,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,EAAE,EAAC,GAAG,IAAI,EAAE,OAAO,EAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/core/agent/environment-variables.d.ts

@@ -1,12 +1,22 @@
 import type { NodeSdkConfig } from '../../config/schema.js';
-import { AgentEnvironmentVariableSchema, GetEnvironmentVariableQuerySchema } from '../../schemas/extended.js';
+import { AddEnvironmentVariableInputSchema, AgentEnvironmentVariableSchema, AgentEnvironmentVariableUpsertResultSchema, GetEnvironmentVariableQuerySchema, type ManagementSigningMethod } from '../../schemas/extended.js';
 import type { SdkResult } from '../result.js';
+import { toSelectedSigningKey, type BuiltManagementPostRequest } from '../management-signer.js';
 import { z } from 'zod';
 export type AgentEnvironmentVariable = z.infer<typeof AgentEnvironmentVariableSchema>;
+export declare function normalizeAgentEnvironmentVariableName(raw: string): string;
+export declare function validateAgentEnvironmentVariableName(name: string): string | null;
 /** GET /getEnvironmentVariable — one agent env var stored on this node. */
 export declare function getEnvironmentVariable(config: NodeSdkConfig, query: z.infer<typeof GetEnvironmentVariableQuerySchema>): Promise<SdkResult<AgentEnvironmentVariable>>;
 /** GET /listEnvironmentVariables — all agent env vars stored on this node. */
 export declare function listEnvironmentVariables(config: NodeSdkConfig): Promise<SdkResult<{
     variables: AgentEnvironmentVariable[];
 }>>;
+export declare function buildAddEnvironmentVariable(config: NodeSdkConfig, input: z.infer<typeof AddEnvironmentVariableInputSchema>, signing?: ManagementSigningMethod): Promise<SdkResult<BuiltManagementPostRequest>>;
+/** POST /addEnvironmentVariable — upsert one agent Variable (MCP output omits value). */
+export declare function addEnvironmentVariable(config: NodeSdkConfig, input: z.infer<typeof AddEnvironmentVariableInputSchema>, signing?: ManagementSigningMethod): Promise<SdkResult<{
+    variable: z.infer<typeof AgentEnvironmentVariableUpsertResultSchema>;
+    selectedSigningKey?: ReturnType<typeof toSelectedSigningKey>;
+    signingMessage: string;
+}>>;
 //# sourceMappingURL=environment-variables.d.ts.map

package/dist/core/agent/environment-variables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment-variables.d.ts","sourceRoot":"","sources":["../../../src/core/agent/environment-variables.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAEN,8BAA8B,EAC9B,iCAAiC,EAEjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,8BAA8B,CACrC,CAAC;AAsBF,2EAA2E;AAC3E,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,GACtD,OAAO,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC,CAuB9C;AAED,8EAA8E;AAC9E,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC;IAAC,SAAS,EAAE,wBAAwB,EAAE,CAAA;CAAC,CAAC,CAAC,CAgC7D"}
+{"version":3,"file":"environment-variables.d.ts","sourceRoot":"","sources":["../../../src/core/agent/environment-variables.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAEN,iCAAiC,EACjC,8BAA8B,EAC9B,0CAA0C,EAC1C,iCAAiC,EAGjC,KAAK,uBAAuB,EAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,EAGN,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,8BAA8B,CACrC,CAAC;AAIF,wBAAgB,qCAAqC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYhF;AAmCD,2EAA2E;AAC3E,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,GACtD,OAAO,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC,CA4B9C;AAED,8EAA8E;AAC9E,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC;IAAC,SAAS,EAAE,wBAAwB,EAAE,CAAA;CAAC,CAAC,CAAC,CAgC7D;AAED,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,EACxD,OAAO,GAAE,uBAAoD,GAC3D,OAAO,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAqBhD;AAED,yFAAyF;AACzF,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,EACxD,OAAO,GAAE,uBAAoD,GAC3D,OAAO,CACT,SAAS,CAAC;IACT,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0CAA0C,CAAC,CAAC;IACrE,kBAAkB,CAAC,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC7D,cAAc,EAAE,MAAM,CAAC;CACvB,CAAC,CACF,CAsCA"}

package/dist/core/agent/environment-variables.js

@@ -1,7 +1,22 @@
-import { buildManagementQueryPath, managementGet, } from '../../api/management-api.js';
-import { AGENT_ENVIRONMENT_API_PATHS, AgentEnvironmentVariableSchema, GetEnvironmentVariableQuerySchema, ListEnvironmentVariablesDataSchema, } from '../../schemas/extended.js';
-function normalizeEnvironmentVariableName(name) {
-    return name.trim().toUpperCase();
+import { buildManagementQueryPath, managementGet, managementPost, } from '../../api/management-api.js';
+import { AGENT_ENVIRONMENT_API_PATHS, AddEnvironmentVariableInputSchema, AgentEnvironmentVariableSchema, AgentEnvironmentVariableUpsertResultSchema, GetEnvironmentVariableQuerySchema, ListEnvironmentVariablesDataSchema, DEFAULT_MANAGEMENT_SIGNING, } from '../../schemas/extended.js';
+import { buildManagementPostRequest, managementSign, toSelectedSigningKey, } from '../management-signer.js';
+const ENVIRONMENT_VARIABLE_NAME_RE = /^[A-Z][A-Z0-9_]*$/;
+export function normalizeAgentEnvironmentVariableName(raw) {
+    return raw.trim().toUpperCase();
+}
+export function validateAgentEnvironmentVariableName(name) {
+    const normalized = normalizeAgentEnvironmentVariableName(name);
+    if (!normalized) {
+        return 'Environment variable name is required.';
+    }
+    if (normalized.length > 128) {
+        return 'Environment variable name must be at most 128 characters.';
+    }
+    if (!ENVIRONMENT_VARIABLE_NAME_RE.test(normalized)) {
+        return 'Environment variable name must start with A-Z and contain only A-Z, 0-9, and underscore.';
+    }
+    return null;
 }
 function normalizeEnvironmentVariableRow(raw) {
     if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
@@ -12,6 +27,19 @@ function normalizeEnvironmentVariableRow(raw) {
         name: String(row.name ?? row.Name ?? '').trim(),
         value: String(row.value ?? row.Value ?? ''),
         updatedAt: String(row.updatedAt ?? row.UpdatedAt ?? '').trim() || undefined,
+        sensitive: Boolean(row.sensitive ?? row.Sensitive),
+    });
+    return parsed.success ? parsed.data : null;
+}
+function toUpsertResult(row, fallbackName) {
+    const name = row?.name ?? fallbackName;
+    if (!name) {
+        return null;
+    }
+    const parsed = AgentEnvironmentVariableUpsertResultSchema.safeParse({
+        name,
+        updatedAt: row?.updatedAt,
+        sensitive: row?.sensitive,
     });
     return parsed.success ? parsed.data : null;
 }
@@ -21,7 +49,11 @@ export async function getEnvironmentVariable(config, query) {
     if (!parsedQuery.success) {
         return { ok: false, reason: 'Invalid environment variable name.' };
     }
-    const name = normalizeEnvironmentVariableName(parsedQuery.data.name);
+    const nameErr = validateAgentEnvironmentVariableName(parsedQuery.data.name);
+    if (nameErr) {
+        return { ok: false, reason: nameErr };
+    }
+    const name = normalizeAgentEnvironmentVariableName(parsedQuery.data.name);
     const path = buildManagementQueryPath(AGENT_ENVIRONMENT_API_PATHS.get, {
         name,
     });
@@ -66,4 +98,56 @@ export async function listEnvironmentVariables(config) {
     }
     return { ok: true, data: parsed.data };
 }
+export async function buildAddEnvironmentVariable(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
+    const parsed = AddEnvironmentVariableInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { ok: false, reason: 'Invalid add environment variable input.' };
+    }
+    const nameErr = validateAgentEnvironmentVariableName(parsed.data.name);
+    if (nameErr) {
+        return { ok: false, reason: nameErr };
+    }
+    const name = normalizeAgentEnvironmentVariableName(parsed.data.name);
+    return buildManagementPostRequest(config, {
+        path: AGENT_ENVIRONMENT_API_PATHS.add,
+        buildRequestFields: () => ({
+            name,
+            value: parsed.data.value,
+        }),
+    }, signing);
+}
+/** POST /addEnvironmentVariable — upsert one agent Variable (MCP output omits value). */
+export async function addEnvironmentVariable(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
+    const built = await buildAddEnvironmentVariable(config, input, signing);
+    if (!built.ok) {
+        return built;
+    }
+    const signed = await managementSign(config, signing, built.data.unsignedBody);
+    if (!signed.ok) {
+        return signed;
+    }
+    const posted = await managementPost(config, built.data.path, signed.data);
+    if (!posted.ok) {
+        return posted;
+    }
+    const row = normalizeEnvironmentVariableRow(posted.data);
+    const name = normalizeAgentEnvironmentVariableName(AddEnvironmentVariableInputSchema.parse(input).name);
+    const variable = toUpsertResult(row, name);
+    if (!variable) {
+        return {
+            ok: false,
+            reason: 'Add environment variable response failed validation.',
+        };
+    }
+    return {
+        ok: true,
+        data: {
+            variable,
+            selectedSigningKey: built.data.selectedSigningKey
+                ? toSelectedSigningKey(built.data.selectedSigningKey)
+                : undefined,
+            signingMessage: built.data.canonicalJson,
+        },
+    };
+}
 //# sourceMappingURL=environment-variables.js.map

package/dist/core/agent/environment-variables.js.map

@@ -1 +1 @@
-{"version":3,"file":"environment-variables.js","sourceRoot":"","sources":["../../../src/core/agent/environment-variables.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"environment-variables.js","sourceRoot":"","sources":["../../../src/core/agent/environment-variables.ts"],"names":[],"mappings":"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"}

package/dist/core/agent/mcp-servers-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-servers-catalog.d.ts","sourceRoot":"","sources":["../../../src/core/agent/mcp-servers-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,2BAA2B,CAAC;AAEjE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,iBAAiB,EA+F3D,CAAC"}
+{"version":3,"file":"mcp-servers-catalog.d.ts","sourceRoot":"","sources":["../../../src/core/agent/mcp-servers-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,2BAA2B,CAAC;AAEjE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,iBAAiB,EA+G3D,CAAC"}

package/dist/core/agent/mcp-servers-catalog.js

@@ -51,10 +51,15 @@ export const BUNDLED_MCP_SERVER_TEMPLATES = [
     },
     {
         id: 'etherscan',
-        displayName: 'Etherscan',
-        transport: 'http',
-        url: 'https://mcp.etherscan.io/mcp',
+        displayName: 'Etherscan (API v2)',
+        transport: 'stdio',
+        command: 'npx',
+        args: ['-y', 'mcp-etherscan-server'],
         apiKeyEnvVar: 'ETHERSCAN_API_KEY',
+        envVars: ['ETHERSCAN_API_KEY'],
+        runtime: {
+            requireCommands: ['npx'],
+        },
         initialLoad: false,
     },
     {
@@ -86,9 +91,20 @@ export const BUNDLED_MCP_SERVER_TEMPLATES = [
         id: 'binance',
         displayName: 'Binance (public market data)',
         transport: 'stdio',
-        command: 'npx',
-        args: ['-y', '@snjyor/binance-mcp@latest'],
-        apiKeyEnvVar: 'BINANCE_API_KEY',
+        command: 'uv',
+        args: [
+            'run',
+            '--with',
+            'fastmcp>=0.1.0',
+            '--with',
+            'httpx>=0.27.0',
+            '--with',
+            'pydantic>=2.0.0',
+            'https://raw.githubusercontent.com/danishashko/binance-mcp-server/main/binance_mcp.py',
+        ],
+        runtime: {
+            requireCommands: ['uv'],
+        },
         initialLoad: false,
     },
     {

package/dist/core/agent/mcp-servers-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-servers-catalog.js","sourceRoot":"","sources":["../../../src/core/agent/mcp-servers-catalog.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAiC;IACzE;QACC,EAAE,EAAE,YAAY;QAChB,WAAW,EAAE,mBAAmB;QAChC,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,uBAAuB,CAAC;QACrC,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,cAAc;QAClB,WAAW,EAAE,kBAAkB;QAC/B,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE;YACL,KAAK;YACL,QAAQ;YACR,yDAAyD;YACzD,SAAS;YACT,KAAK;YACL,sEAAsE;SACtE;QACD,OAAO,EAAE;YACR,eAAe,EAAE,CAAC,IAAI,CAAC;SACvB;QACD,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,8BAA8B;QAC3C,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,iCAAiC,CAAC;QAC/C,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE;YACR,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC;SAC9D;QACD,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,WAAW;QACxB,SAAS,EAAE,MAAM;QACjB,GAAG,EAAE,8BAA8B;QACnC,YAAY,EAAE,mBAAmB;QACjC,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,MAAM;QACV,WAAW,EAAE,gBAAgB;QAC7B,SAAS,EAAE,MAAM;QACjB,GAAG,EAAE,6BAA6B;QAClC,YAAY,EAAE,cAAc;QAC5B,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,oBAAoB;QACjC,SAAS,EAAE,MAAM;QACjB,GAAG,EAAE,mCAAmC;QACxC,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,eAAe;QACnB,WAAW,EAAE,eAAe;QAC5B,SAAS,EAAE,MAAM;QACjB,GAAG,EAAE,uCAAuC;QAC5C,YAAY,EAAE,mBAAmB;QACjC,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,8BAA8B;QAC3C,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,4BAA4B,CAAC;QAC1C,YAAY,EAAE,iBAAiB;QAC/B,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,GAAG;QACP,WAAW,EAAE,aAAa;QAC1B,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,qCAAqC,CAAC;QACnD,OAAO,EAAE;YACR,iBAAiB;YACjB,oBAAoB;YACpB,sBAAsB;YACtB,uBAAuB;SACvB;QACD,WAAW,EAAE,KAAK;KAClB;CACQ,CAAC"}
+{"version":3,"file":"mcp-servers-catalog.js","sourceRoot":"","sources":["../../../src/core/agent/mcp-servers-catalog.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAiC;IACzE;QACC,EAAE,EAAE,YAAY;QAChB,WAAW,EAAE,mBAAmB;QAChC,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,uBAAuB,CAAC;QACrC,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,cAAc;QAClB,WAAW,EAAE,kBAAkB;QAC/B,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE;YACL,KAAK;YACL,QAAQ;YACR,yDAAyD;YACzD,SAAS;YACT,KAAK;YACL,sEAAsE;SACtE;QACD,OAAO,EAAE;YACR,eAAe,EAAE,CAAC,IAAI,CAAC;SACvB;QACD,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,8BAA8B;QAC3C,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,iCAAiC,CAAC;QAC/C,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE;YACR,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC;SAC9D;QACD,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,oBAAoB;QACjC,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,sBAAsB,CAAC;QACpC,YAAY,EAAE,mBAAmB;QACjC,OAAO,EAAE,CAAC,mBAAmB,CAAC;QAC9B,OAAO,EAAE;YACR,eAAe,EAAE,CAAC,KAAK,CAAC;SACxB;QACD,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,MAAM;QACV,WAAW,EAAE,gBAAgB;QAC7B,SAAS,EAAE,MAAM;QACjB,GAAG,EAAE,6BAA6B;QAClC,YAAY,EAAE,cAAc;QAC5B,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,oBAAoB;QACjC,SAAS,EAAE,MAAM;QACjB,GAAG,EAAE,mCAAmC;QACxC,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,eAAe;QACnB,WAAW,EAAE,eAAe;QAC5B,SAAS,EAAE,MAAM;QACjB,GAAG,EAAE,uCAAuC;QAC5C,YAAY,EAAE,mBAAmB;QACjC,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,8BAA8B;QAC3C,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE;YACL,KAAK;YACL,QAAQ;YACR,gBAAgB;YAChB,QAAQ;YACR,eAAe;YACf,QAAQ;YACR,iBAAiB;YACjB,sFAAsF;SACtF;QACD,OAAO,EAAE;YACR,eAAe,EAAE,CAAC,IAAI,CAAC;SACvB;QACD,WAAW,EAAE,KAAK;KAClB;IACD;QACC,EAAE,EAAE,GAAG;QACP,WAAW,EAAE,aAAa;QAC1B,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,qCAAqC,CAAC;QACnD,OAAO,EAAE;YACR,iBAAiB;YACjB,oBAAoB;YACpB,sBAAsB;YACtB,uBAAuB;SACvB;QACD,WAAW,EAAE,KAAK;KAClB;CACQ,CAAC"}

package/dist/core/agent/mcp-servers.d.ts

@@ -1,5 +1,5 @@
 import type { NodeSdkConfig } from '../../config/schema.js';
-import { AgentMcpServerRowSchema, GetMcpServerQuerySchema, ListBundledMcpServerTemplatesDataSchema, ListMcpServersDataSchema, RemoveMcpServerInputSchema, type AddMcpServerInput, type ManagementSigningMethod } from '../../schemas/extended.js';
+import { AgentMcpServerRowSchema, GetMcpServerQuerySchema, ListMcpServersDataSchema, RemoveMcpServerInputSchema, type AddMcpServerFromCatalogInput, type AddMcpServerInput, type ManagementSigningMethod } from '../../schemas/extended.js';
 import type { SdkResult } from '../result.js';
 import { toSelectedSigningKey, type BuiltManagementPostRequest } from '../management-signer.js';
 import { z } from 'zod';
@@ -7,10 +7,8 @@ export type AgentMcpServerRow = z.infer<typeof AgentMcpServerRowSchema>;
 export type ListMcpServersData = z.infer<typeof ListMcpServersDataSchema>;
 export declare function normalizeAgentMcpServerId(raw: string): string;
 export declare function validateAgentMcpServerId(id: string): string | null;
-/** GET /listMcpServers — configured defaults + user servers, plus bundled templates not yet on the node. */
+/** GET /listMcpServers — active servers plus availableCatalog from mpc-config agent_llm_config.defaults/MCP_servers.json. */
 export declare function listMcpServers(config: NodeSdkConfig): Promise<SdkResult<ListMcpServersData>>;
-/** Bundled optional MCP catalog from mpc-config (for suggesting add_mcp_server). */
-export declare function listBundledMcpServerTemplates(): SdkResult<z.infer<typeof ListBundledMcpServerTemplatesDataSchema>>;
 /** GET /getMcpServer?id= */
 export declare function getMcpServer(config: NodeSdkConfig, query: z.infer<typeof GetMcpServerQuerySchema>): Promise<SdkResult<AgentMcpServerRow>>;
 export declare function buildAddMcpServer(config: NodeSdkConfig, input: AddMcpServerInput, signing?: ManagementSigningMethod): Promise<SdkResult<BuiltManagementPostRequest>>;
@@ -19,6 +17,12 @@ export declare function addMcpServer(config: NodeSdkConfig, input: AddMcpServerI
     selectedSigningKey?: ReturnType<typeof toSelectedSigningKey>;
     signingMessage: string;
 }>>;
+export declare function buildAddMcpServerFromCatalog(config: NodeSdkConfig, input: AddMcpServerFromCatalogInput, signing?: ManagementSigningMethod): Promise<SdkResult<BuiltManagementPostRequest>>;
+export declare function addMcpServerFromCatalog(config: NodeSdkConfig, input: AddMcpServerFromCatalogInput, signing?: ManagementSigningMethod): Promise<SdkResult<{
+    server: AgentMcpServerRow;
+    selectedSigningKey?: ReturnType<typeof toSelectedSigningKey>;
+    signingMessage: string;
+}>>;
 export declare function buildRemoveMcpServer(config: NodeSdkConfig, input: z.infer<typeof RemoveMcpServerInputSchema>, signing?: ManagementSigningMethod): Promise<SdkResult<BuiltManagementPostRequest>>;
 export declare function removeMcpServer(config: NodeSdkConfig, input: z.infer<typeof RemoveMcpServerInputSchema>, signing?: ManagementSigningMethod): Promise<SdkResult<{
     message: string;

package/dist/core/agent/mcp-servers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-servers.d.ts","sourceRoot":"","sources":["../../../src/core/agent/mcp-servers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAM1D,OAAO,EAGN,uBAAuB,EAEvB,uBAAuB,EACvB,uCAAuC,EACvC,wBAAwB,EACxB,0BAA0B,EAC1B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAE5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,EAGN,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYlE;AA0HD,4GAA4G;AAC5G,wBAAsB,cAAc,CACnC,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,CA2BxC;AAED,oFAAoF;AACpF,wBAAgB,6BAA6B,IAAI,SAAS,CACzD,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,CACvD,CAQA;AAED,4BAA4B;AAC5B,wBAAsB,YAAY,CACjC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,GAC5C,OAAO,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAoBvC;AAED,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE,uBAAoD,GAC3D,OAAO,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAiBhD;AAED,wBAAsB,YAAY,CACjC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE,uBAAoD,GAC3D,OAAO,CACT,SAAS,CAAC;IACT,MAAM,EAAE,iBAAiB,CAAC;IAC1B,kBAAkB,CAAC,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC7D,cAAc,EAAE,MAAM,CAAC;CACvB,CAAC,CACF,CA+BA;AAED,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,EACjD,OAAO,GAAE,uBAAoD,GAC3D,OAAO,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAmBhD;AAED,wBAAsB,eAAe,CACpC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,EACjD,OAAO,GAAE,uBAAoD,GAC3D,OAAO,CACT,SAAS,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC7D,cAAc,EAAE,MAAM,CAAC;CACvB,CAAC,CACF,CA8BA"}
+{"version":3,"file":"mcp-servers.d.ts","sourceRoot":"","sources":["../../../src/core/agent/mcp-servers.ts"],"names":[],"mappings":"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"}

package/dist/core/agent/mcp-servers.js

@@ -1,7 +1,6 @@
 import { buildManagementQueryPath, managementGet, managementPost, } from '../../api/management-api.js';
-import { AGENT_MCP_API_PATHS, AddMcpServerInputSchema, AgentMcpServerRowSchema, GetMcpServerQuerySchema, ListBundledMcpServerTemplatesDataSchema, ListMcpServersDataSchema, RemoveMcpServerInputSchema, DEFAULT_MANAGEMENT_SIGNING, } from '../../schemas/extended.js';
+import { AGENT_MCP_API_PATHS, AddMcpServerFromCatalogInputSchema, AddMcpServerInputSchema, AgentMcpRuntimeSpecSchema, AgentMcpServerRowSchema, GetMcpServerQuerySchema, ListMcpServersDataSchema, RemoveMcpServerInputSchema, DEFAULT_MANAGEMENT_SIGNING, } from '../../schemas/extended.js';
 import { buildManagementPostRequest, managementSign, toSelectedSigningKey, } from '../management-signer.js';
-import { BUNDLED_MCP_SERVER_TEMPLATES } from './mcp-servers-catalog.js';
 const MCP_SERVER_ID_RE = /^[a-z][a-z0-9_-]*$/;
 export function normalizeAgentMcpServerId(raw) {
     return raw
@@ -46,10 +45,19 @@ function parseMcpServerRow(raw) {
         ? argsRaw.map(a => String(a).trim()).filter(Boolean)
         : undefined;
     const sourceRaw = String(o.source ?? o.Source ?? 'user').trim().toLowerCase();
+    const source = sourceRaw === 'default'
+        ? 'default'
+        : sourceRaw === 'catalog'
+            ? 'catalog'
+            : 'user';
     const envVarsRaw = o.envVars ?? o.EnvVars;
     const envVars = Array.isArray(envVarsRaw)
         ? envVarsRaw.map((v) => String(v).trim()).filter(Boolean)
         : undefined;
+    const runtimeRaw = o.runtime ?? o.Runtime;
+    const runtimeParsed = AgentMcpRuntimeSpecSchema.safeParse(runtimeRaw);
+    const runtime = runtimeParsed.success ? runtimeParsed.data : undefined;
+    const setupUrlRaw = String(o.setupUrl ?? o.SetupUrl ?? '').trim();
     const parsed = AgentMcpServerRowSchema.safeParse({
         id,
         displayName: String(o.displayName ?? o.DisplayName ?? id).trim(),
@@ -59,13 +67,17 @@ function parseMcpServerRow(raw) {
         args: args?.length ? args : undefined,
         envVars: envVars?.length ? envVars : undefined,
         useUserFolder: Boolean(o.useUserFolder ?? o.UseUserFolder),
+        runtime,
+        setupUrl: setupUrlRaw || undefined,
         apiKeyEnvVar: String(o.apiKeyEnvVar ?? o.APIKeyEnvVar ?? '').trim() || undefined,
         apiKeyHeader: String(o.apiKeyHeader ?? o.APIKeyHeader ?? '').trim() || undefined,
         apiKeyPresent: Boolean(o.apiKeyPresent ?? o.APIKeyPresent),
         apiKeyMasked: String(o.apiKeyMasked ?? o.APIKeyMasked ?? '').trim() || undefined,
         envConfigured: Boolean(o.envConfigured ?? o.EnvConfigured),
         initialLoad: Boolean(o.initialLoad ?? o.InitialLoad),
-        source: sourceRaw === 'default' ? 'default' : 'user',
+        aiReady: Boolean(o.aiReady ?? o.AiReady),
+        builtin: Boolean(o.builtin ?? o.Builtin),
+        source,
         removable: Boolean(o.removable ?? o.Removable),
         updatedAt: String(o.updatedAt ?? o.UpdatedAt ?? '').trim() || undefined,
     });
@@ -84,30 +96,68 @@ function parseMcpServerRows(raw) {
     }
     return out;
 }
-function computeAddableTemplates(configured) {
-    const configuredIds = new Set(configured.map(s => s.id));
-    return BUNDLED_MCP_SERVER_TEMPLATES.filter(t => !configuredIds.has(t.id)).map(t => ({ ...t }));
+/** Map GET /listMcpServers availableCatalog rows to add_mcp_server-shaped templates. */
+function catalogRowsToAddableTemplates(rows) {
+    const out = [];
+    for (const row of rows) {
+        if (row.transport === 'http') {
+            if (!row.url?.trim()) {
+                continue;
+            }
+            out.push({
+                id: row.id,
+                displayName: row.displayName,
+                transport: 'http',
+                url: row.url,
+                apiKeyEnvVar: row.apiKeyEnvVar,
+                apiKeyHeader: row.apiKeyHeader,
+                initialLoad: row.initialLoad,
+                aiReady: row.aiReady,
+            });
+            continue;
+        }
+        if (!row.command?.trim()) {
+            continue;
+        }
+        out.push({
+            id: row.id,
+            displayName: row.displayName,
+            transport: 'stdio',
+            command: row.command,
+            args: row.args,
+            apiKeyEnvVar: row.apiKeyEnvVar,
+            envVars: row.envVars,
+            useUserFolder: row.useUserFolder,
+            runtime: row.runtime,
+            initialLoad: row.initialLoad,
+            aiReady: row.aiReady,
+        });
+    }
+    return out;
 }
-/** POST /addMcpServer body. Prefer apiKeyEnvVar / envVars (Variables); avoid apiKey — agent must not see secret values. */
+/** POST /addMcpServer body. Prefer apiKeyEnvVar / envVars (Variables); never inline apiKey — agent must not see secret values. */
 function buildAddMcpServerBodyFields(input) {
     const id = normalizeAgentMcpServerId(input.id);
     const body = {
         id,
         displayName: input.displayName.trim(),
+        transport: input.transport,
         initialLoad: input.initialLoad ?? false,
     };
-    const transport = input.transport ?? (input.command ? 'stdio' : 'http');
-    body.transport = transport;
-    if (transport === 'stdio') {
-        if (input.command?.trim()) {
-            body.command = input.command.trim();
-        }
+    if (input.aiReady) {
+        body.aiReady = true;
+    }
+    if (input.transport === 'stdio') {
+        body.command = input.command.trim();
         if (input.args?.length) {
             body.args = input.args.map(a => a.trim()).filter(Boolean);
         }
         if (input.envVars?.length) {
             body.envVars = input.envVars.map(v => v.trim()).filter(Boolean);
         }
+        if (input.apiKeyEnvVar?.trim()) {
+            body.apiKeyEnvVar = input.apiKeyEnvVar.trim();
+        }
         if (input.useUserFolder) {
             body.useUserFolder = true;
         }
@@ -116,9 +166,7 @@ function buildAddMcpServerBodyFields(input) {
         }
     }
     else {
-        if (input.url?.trim()) {
-            body.url = input.url.trim();
-        }
+        body.url = input.url.trim();
         if (input.apiKeyEnvVar?.trim()) {
             body.apiKeyEnvVar = input.apiKeyEnvVar.trim();
         }
@@ -126,12 +174,9 @@ function buildAddMcpServerBodyFields(input) {
             body.apiKeyHeader = input.apiKeyHeader.trim();
         }
     }
-    if (input.apiKey !== undefined && input.apiKey !== '') {
-        body.apiKey = input.apiKey;
-    }
     return body;
 }
-/** GET /listMcpServers — configured defaults + user servers, plus bundled templates not yet on the node. */
+/** GET /listMcpServers — active servers plus availableCatalog from mpc-config agent_llm_config.defaults/MCP_servers.json. */
 export async function listMcpServers(config) {
     const result = await managementGet(config, AGENT_MCP_API_PATHS.list);
     if (!result.ok) {
@@ -142,13 +187,21 @@ export async function listMcpServers(config) {
         : {};
     const defaultServers = parseMcpServerRows(data.defaultServers ?? data.DefaultServers);
     const userServers = parseMcpServerRows(data.userServers ?? data.UserServers);
+    const activeServers = parseMcpServerRows(data.activeServers ?? data.ActiveServers);
+    const availableCatalog = parseMcpServerRows(data.availableCatalog ?? data.AvailableCatalog);
     const servers = parseMcpServerRows(data.servers ?? data.Servers);
-    const merged = servers.length > 0 ? servers : [...defaultServers, ...userServers];
+    const merged = activeServers.length > 0
+        ? activeServers
+        : servers.length > 0
+            ? servers
+            : [...defaultServers, ...userServers];
     const payload = {
+        activeServers: activeServers.length > 0 ? activeServers : merged,
+        availableCatalog,
         defaultServers,
         userServers,
         servers: merged,
-        addableTemplates: computeAddableTemplates(merged),
+        addableTemplates: catalogRowsToAddableTemplates(availableCatalog),
     };
     const parsed = ListMcpServersDataSchema.safeParse(payload);
     if (!parsed.success) {
@@ -156,16 +209,6 @@ export async function listMcpServers(config) {
     }
     return { ok: true, data: parsed.data };
 }
-/** Bundled optional MCP catalog from mpc-config (for suggesting add_mcp_server). */
-export function listBundledMcpServerTemplates() {
-    const parsed = ListBundledMcpServerTemplatesDataSchema.safeParse({
-        templates: BUNDLED_MCP_SERVER_TEMPLATES.map(t => ({ ...t })),
-    });
-    if (!parsed.success) {
-        return { ok: false, reason: 'Bundled MCP template catalog failed validation.' };
-    }
-    return { ok: true, data: parsed.data };
-}
 /** GET /getMcpServer?id= */
 export async function getMcpServer(config, query) {
     const parsedQuery = GetMcpServerQuerySchema.safeParse(query);
@@ -197,6 +240,12 @@ export async function buildAddMcpServer(config, input, signing = DEFAULT_MANAGEM
     if (idErr) {
         return { ok: false, reason: idErr };
     }
+    if (normalizeAgentMcpServerId(parsed.data.id) === 'continuum') {
+        return {
+            ok: false,
+            reason: 'id "continuum" is reserved for the builtin MCP server.',
+        };
+    }
     return buildManagementPostRequest(config, {
         path: AGENT_MCP_API_PATHS.add,
         buildRequestFields: () => buildAddMcpServerBodyFields(parsed.data),
@@ -230,6 +279,63 @@ export async function addMcpServer(config, input, signing = DEFAULT_MANAGEMENT_S
         },
     };
 }
+export async function buildAddMcpServerFromCatalog(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
+    const parsed = AddMcpServerFromCatalogInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { ok: false, reason: 'Invalid add MCP server from catalog input.' };
+    }
+    const idErr = validateAgentMcpServerId(parsed.data.id);
+    if (idErr) {
+        return { ok: false, reason: idErr };
+    }
+    if (normalizeAgentMcpServerId(parsed.data.id) === 'continuum') {
+        return {
+            ok: false,
+            reason: 'id "continuum" is reserved for the builtin MCP server.',
+        };
+    }
+    return buildManagementPostRequest(config, {
+        path: AGENT_MCP_API_PATHS.addFromCatalog,
+        buildRequestFields: () => ({
+            id: normalizeAgentMcpServerId(parsed.data.id),
+            ...(parsed.data.initialLoad !== undefined
+                ? { initialLoad: parsed.data.initialLoad }
+                : {}),
+            ...(parsed.data.aiReady !== undefined ? { aiReady: parsed.data.aiReady } : {}),
+        }),
+    }, signing);
+}
+export async function addMcpServerFromCatalog(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
+    const built = await buildAddMcpServerFromCatalog(config, input, signing);
+    if (!built.ok) {
+        return built;
+    }
+    const signed = await managementSign(config, signing, built.data.unsignedBody);
+    if (!signed.ok) {
+        return signed;
+    }
+    const posted = await managementPost(config, built.data.path, signed.data);
+    if (!posted.ok) {
+        return posted;
+    }
+    const row = parseMcpServerRow(posted.data);
+    if (!row) {
+        return {
+            ok: false,
+            reason: 'Add MCP server from catalog response failed validation.',
+        };
+    }
+    return {
+        ok: true,
+        data: {
+            server: row,
+            selectedSigningKey: built.data.selectedSigningKey
+                ? toSelectedSigningKey(built.data.selectedSigningKey)
+                : undefined,
+            signingMessage: built.data.canonicalJson,
+        },
+    };
+}
 export async function buildRemoveMcpServer(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
     const parsed = RemoveMcpServerInputSchema.safeParse(input);
     if (!parsed.success) {