@continuumdao/continuum-node-sdk 1.2.9 → 1.2.11

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

@@ -0,0 +1,69 @@
+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();
+}
+function normalizeEnvironmentVariableRow(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return null;
+    }
+    const row = raw;
+    const parsed = AgentEnvironmentVariableSchema.safeParse({
+        name: String(row.name ?? row.Name ?? '').trim(),
+        value: String(row.value ?? row.Value ?? ''),
+        updatedAt: String(row.updatedAt ?? row.UpdatedAt ?? '').trim() || undefined,
+    });
+    return parsed.success ? parsed.data : null;
+}
+/** GET /getEnvironmentVariable — one agent env var stored on this node. */
+export async function getEnvironmentVariable(config, query) {
+    const parsedQuery = GetEnvironmentVariableQuerySchema.safeParse(query);
+    if (!parsedQuery.success) {
+        return { ok: false, reason: 'Invalid environment variable name.' };
+    }
+    const name = normalizeEnvironmentVariableName(parsedQuery.data.name);
+    const path = buildManagementQueryPath(AGENT_ENVIRONMENT_API_PATHS.get, {
+        name,
+    });
+    const result = await managementGet(config, path);
+    if (!result.ok) {
+        return result;
+    }
+    const row = normalizeEnvironmentVariableRow(result.data);
+    if (!row) {
+        return {
+            ok: false,
+            reason: 'Environment variable response failed validation.',
+        };
+    }
+    return { ok: true, data: row };
+}
+/** GET /listEnvironmentVariables — all agent env vars stored on this node. */
+export async function listEnvironmentVariables(config) {
+    const result = await managementGet(config, AGENT_ENVIRONMENT_API_PATHS.list);
+    if (!result.ok) {
+        return result;
+    }
+    const data = result.data && typeof result.data === 'object' && !Array.isArray(result.data)
+        ? result.data
+        : { variables: result.data };
+    const listRaw = data.variables ?? data.Variables;
+    const variables = [];
+    if (Array.isArray(listRaw)) {
+        for (const item of listRaw) {
+            const row = normalizeEnvironmentVariableRow(item);
+            if (row) {
+                variables.push(row);
+            }
+        }
+    }
+    const parsed = ListEnvironmentVariablesDataSchema.safeParse({ variables });
+    if (!parsed.success) {
+        return {
+            ok: false,
+            reason: 'Environment variable list response failed validation.',
+        };
+    }
+    return { ok: true, data: parsed.data };
+}
+//# sourceMappingURL=environment-variables.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,4 @@
+import type { AddMcpServerInput } from '../../schemas/extended.js';
+/** Bundled optional MCP catalog (keep in sync with mpc-config agent_llm_config/MCP_servers.json). */
+export declare const BUNDLED_MCP_SERVER_TEMPLATES: readonly AddMcpServerInput[];
+//# sourceMappingURL=mcp-servers-catalog.d.ts.map

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

@@ -0,0 +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,qGAAqG;AACrG,eAAO,MAAM,4BAA4B,EAAE,SAAS,iBAAiB,EA2D3D,CAAC"}

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

@@ -0,0 +1,62 @@
+/** Bundled optional MCP catalog (keep in sync with mpc-config agent_llm_config/MCP_servers.json). */
+export const BUNDLED_MCP_SERVER_TEMPLATES = [
+    {
+        id: 'duckduckgo',
+        displayName: 'DuckDuckGo search',
+        transport: 'stdio',
+        command: 'npx',
+        args: ['-y', 'duckduckgo-mcp-server'],
+        initialLoad: false,
+    },
+    {
+        id: 'foundry',
+        displayName: 'Foundry (Forge, Cast, Anvil)',
+        transport: 'stdio',
+        command: 'npx',
+        args: ['-y', '@pranesh.asp/foundry-mcp-server'],
+        useUserFolder: true,
+        runtime: {
+            requireCommands: ['npx', 'forge', 'cast', 'anvil', 'heimdall'],
+        },
+        initialLoad: false,
+    },
+    {
+        id: 'etherscan',
+        displayName: 'Etherscan',
+        transport: 'http',
+        url: 'https://mcp.etherscan.io/mcp',
+        apiKeyEnvVar: 'ETHERSCAN_API_KEY',
+        initialLoad: false,
+    },
+    {
+        id: 'coingecko',
+        displayName: 'CoinGecko (public)',
+        transport: 'http',
+        url: 'https://mcp.api.coingecko.com/mcp',
+        initialLoad: false,
+    },
+    {
+        id: 'coingecko-pro',
+        displayName: 'CoinGecko Pro',
+        transport: 'http',
+        url: 'https://mcp.pro-api.coingecko.com/mcp',
+        apiKeyEnvVar: 'COINGECKO_API_KEY',
+        apiKeyHeader: 'x-cg-pro-api-key',
+        initialLoad: false,
+    },
+    {
+        id: 'x',
+        displayName: 'X (Twitter)',
+        transport: 'stdio',
+        command: 'npx',
+        args: ['-y', '@iflow-mcp/datawhisker-x-mcp-server'],
+        envVars: [
+            'TWITTER_API_KEY',
+            'TWITTER_API_SECRET',
+            'TWITTER_ACCESS_TOKEN',
+            'TWITTER_ACCESS_SECRET',
+        ],
+        initialLoad: false,
+    },
+];
+//# sourceMappingURL=mcp-servers-catalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-servers-catalog.js","sourceRoot":"","sources":["../../../src/core/agent/mcp-servers-catalog.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,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,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,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,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

@@ -0,0 +1,28 @@
+import type { NodeSdkConfig } from '../../config/schema.js';
+import { AgentMcpServerRowSchema, GetMcpServerQuerySchema, ListBundledMcpServerTemplatesDataSchema, ListMcpServersDataSchema, RemoveMcpServerInputSchema, 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';
+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. */
+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>>;
+export declare function addMcpServer(config: NodeSdkConfig, input: AddMcpServerInput, 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;
+    selectedSigningKey?: ReturnType<typeof toSelectedSigningKey>;
+    signingMessage: string;
+}>>;
+//# sourceMappingURL=mcp-servers.d.ts.map

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

@@ -0,0 +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;AAyHD,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"}

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

@@ -0,0 +1,274 @@
+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 { 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
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, '-')
+        .replace(/^-+/, '')
+        .replace(/-+/g, '-');
+}
+export function validateAgentMcpServerId(id) {
+    const normalized = normalizeAgentMcpServerId(id);
+    if (!normalized) {
+        return 'MCP server id is required.';
+    }
+    if (normalized.length > 64) {
+        return 'MCP server id must be at most 64 characters.';
+    }
+    if (!MCP_SERVER_ID_RE.test(normalized)) {
+        return 'MCP server id must start with a-z and use only a-z, 0-9, hyphen, and underscore.';
+    }
+    return null;
+}
+function parseTransport(raw, command) {
+    const t = String(raw ?? '').trim().toLowerCase();
+    if (t === 'stdio' || command) {
+        return 'stdio';
+    }
+    return 'http';
+}
+function parseMcpServerRow(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return null;
+    }
+    const o = raw;
+    const id = String(o.id ?? o.Id ?? '').trim();
+    if (!id) {
+        return null;
+    }
+    const command = String(o.command ?? o.Command ?? '').trim() || undefined;
+    const argsRaw = o.args ?? o.Args;
+    const args = Array.isArray(argsRaw)
+        ? argsRaw.map(a => String(a).trim()).filter(Boolean)
+        : undefined;
+    const sourceRaw = String(o.source ?? o.Source ?? 'user').trim().toLowerCase();
+    const envVarsRaw = o.envVars ?? o.EnvVars;
+    const envVars = Array.isArray(envVarsRaw)
+        ? envVarsRaw.map((v) => String(v).trim()).filter(Boolean)
+        : undefined;
+    const parsed = AgentMcpServerRowSchema.safeParse({
+        id,
+        displayName: String(o.displayName ?? o.DisplayName ?? id).trim(),
+        transport: parseTransport(o.transport ?? o.Transport, command),
+        url: String(o.url ?? o.URL ?? '').trim() || undefined,
+        command,
+        args: args?.length ? args : undefined,
+        envVars: envVars?.length ? envVars : undefined,
+        useUserFolder: Boolean(o.useUserFolder ?? o.UseUserFolder),
+        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',
+        removable: Boolean(o.removable ?? o.Removable),
+        updatedAt: String(o.updatedAt ?? o.UpdatedAt ?? '').trim() || undefined,
+    });
+    return parsed.success ? parsed.data : null;
+}
+function parseMcpServerRows(raw) {
+    if (!Array.isArray(raw)) {
+        return [];
+    }
+    const out = [];
+    for (const item of raw) {
+        const row = parseMcpServerRow(item);
+        if (row) {
+            out.push(row);
+        }
+    }
+    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 }));
+}
+function buildAddMcpServerBodyFields(input) {
+    const id = normalizeAgentMcpServerId(input.id);
+    const body = {
+        id,
+        displayName: input.displayName.trim(),
+        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.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.useUserFolder) {
+            body.useUserFolder = true;
+        }
+        if (input.runtime) {
+            body.runtime = input.runtime;
+        }
+    }
+    else {
+        if (input.url?.trim()) {
+            body.url = input.url.trim();
+        }
+        if (input.apiKeyEnvVar?.trim()) {
+            body.apiKeyEnvVar = input.apiKeyEnvVar.trim();
+        }
+        if (input.apiKeyHeader?.trim()) {
+            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. */
+export async function listMcpServers(config) {
+    const result = await managementGet(config, AGENT_MCP_API_PATHS.list);
+    if (!result.ok) {
+        return result;
+    }
+    const data = result.data && typeof result.data === 'object' && !Array.isArray(result.data)
+        ? result.data
+        : {};
+    const defaultServers = parseMcpServerRows(data.defaultServers ?? data.DefaultServers);
+    const userServers = parseMcpServerRows(data.userServers ?? data.UserServers);
+    const servers = parseMcpServerRows(data.servers ?? data.Servers);
+    const merged = servers.length > 0 ? servers : [...defaultServers, ...userServers];
+    const payload = {
+        defaultServers,
+        userServers,
+        servers: merged,
+        addableTemplates: computeAddableTemplates(merged),
+    };
+    const parsed = ListMcpServersDataSchema.safeParse(payload);
+    if (!parsed.success) {
+        return { ok: false, reason: 'MCP server list response failed validation.' };
+    }
+    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);
+    if (!parsedQuery.success) {
+        return { ok: false, reason: 'Invalid MCP server id.' };
+    }
+    const idErr = validateAgentMcpServerId(parsedQuery.data.id);
+    if (idErr) {
+        return { ok: false, reason: idErr };
+    }
+    const id = normalizeAgentMcpServerId(parsedQuery.data.id);
+    const path = buildManagementQueryPath(AGENT_MCP_API_PATHS.get, { id });
+    const result = await managementGet(config, path);
+    if (!result.ok) {
+        return result;
+    }
+    const row = parseMcpServerRow(result.data);
+    if (!row) {
+        return { ok: false, reason: 'MCP server response failed validation.' };
+    }
+    return { ok: true, data: row };
+}
+export async function buildAddMcpServer(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
+    const parsed = AddMcpServerInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { ok: false, reason: 'Invalid add MCP server input.' };
+    }
+    const idErr = validateAgentMcpServerId(parsed.data.id);
+    if (idErr) {
+        return { ok: false, reason: idErr };
+    }
+    return buildManagementPostRequest(config, {
+        path: AGENT_MCP_API_PATHS.add,
+        buildRequestFields: () => buildAddMcpServerBodyFields(parsed.data),
+    }, signing);
+}
+export async function addMcpServer(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
+    const built = await buildAddMcpServer(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 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) {
+        return { ok: false, reason: 'Invalid remove MCP server input.' };
+    }
+    const idErr = validateAgentMcpServerId(parsed.data.id);
+    if (idErr) {
+        return { ok: false, reason: idErr };
+    }
+    return buildManagementPostRequest(config, {
+        path: AGENT_MCP_API_PATHS.remove,
+        buildRequestFields: () => ({
+            id: normalizeAgentMcpServerId(parsed.data.id),
+        }),
+    }, signing);
+}
+export async function removeMcpServer(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
+    const built = await buildRemoveMcpServer(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;
+    }
+    return {
+        ok: true,
+        data: {
+            message: typeof posted.data === 'string' && posted.data.trim()
+                ? posted.data
+                : 'MCP server removed',
+            selectedSigningKey: built.data.selectedSigningKey
+                ? toSelectedSigningKey(built.data.selectedSigningKey)
+                : undefined,
+            signingMessage: built.data.canonicalJson,
+        },
+    };
+}
+//# sourceMappingURL=mcp-servers.js.map

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

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

package/dist/core/agent/skills.d.ts

@@ -0,0 +1,26 @@
+import type { NodeSdkConfig } from '../../config/schema.js';
+import { AgentSkillDetailSchema, AgentSkillFormatSchema, GetSkillQuerySchema, ListSkillsDataSchema, RemoveSkillInputSchema, type AddSkillInput, 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 AgentSkillDetail = z.infer<typeof AgentSkillDetailSchema>;
+export type AgentSkillFormat = z.infer<typeof AgentSkillFormatSchema>;
+export declare function normalizeSkillName(raw: string): string;
+export declare function validateSkillName(name: string): string | null;
+/** GET /listSkills — agent skill names only (no file content). */
+export declare function listSkills(config: NodeSdkConfig): Promise<SdkResult<z.infer<typeof ListSkillsDataSchema>>>;
+/** GET /getSkill — one skill file by name. */
+export declare function getSkill(config: NodeSdkConfig, query: z.infer<typeof GetSkillQuerySchema>): Promise<SdkResult<AgentSkillDetail>>;
+export declare function buildAddSkill(config: NodeSdkConfig, input: AddSkillInput, signing?: ManagementSigningMethod): Promise<SdkResult<BuiltManagementPostRequest>>;
+export declare function addSkill(config: NodeSdkConfig, input: AddSkillInput, signing?: ManagementSigningMethod): Promise<SdkResult<{
+    skill: AgentSkillDetail;
+    selectedSigningKey?: ReturnType<typeof toSelectedSigningKey>;
+    signingMessage: string;
+}>>;
+export declare function buildRemoveSkill(config: NodeSdkConfig, input: z.infer<typeof RemoveSkillInputSchema>, signing?: ManagementSigningMethod): Promise<SdkResult<BuiltManagementPostRequest>>;
+export declare function removeSkill(config: NodeSdkConfig, input: z.infer<typeof RemoveSkillInputSchema>, signing?: ManagementSigningMethod): Promise<SdkResult<{
+    message: string;
+    selectedSigningKey?: ReturnType<typeof toSelectedSigningKey>;
+    signingMessage: string;
+}>>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/core/agent/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/core/agent/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAM1D,OAAO,EAGN,sBAAsB,EACtB,sBAAsB,EAEtB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,aAAa,EAClB,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,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAKtE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY7D;AAkDD,kEAAkE;AAClE,wBAAsB,UAAU,CAC/B,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAkB1D;AAED,8CAA8C;AAC9C,wBAAsB,QAAQ,CAC7B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GACxC,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAoBtC;AAED,wBAAsB,aAAa,CAClC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,uBAAoD,GAC3D,OAAO,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAqBhD;AAED,wBAAsB,QAAQ,CAC7B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,uBAAoD,GAC3D,OAAO,CACT,SAAS,CAAC;IACT,KAAK,EAAE,gBAAgB,CAAC;IACxB,kBAAkB,CAAC,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC7D,cAAc,EAAE,MAAM,CAAC;CACvB,CAAC,CACF,CA+BA;AAED,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAC7C,OAAO,GAAE,uBAAoD,GAC3D,OAAO,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAmBhD;AAED,wBAAsB,WAAW,CAChC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAC7C,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"}