@cicctencent/agent-server 0.1.1

package/dist/cjs/mcp/body-template.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * @file Body 模板引擎 — 通用 ${param|default} 参数解析
+ * @description 将模板对象中的 ${param} / ${param|default} 占位符替换为实际参数值，
+ *              支持递归解析嵌套对象和数组，类型跟随默认值。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBodyTemplate = resolveBodyTemplate;
+/**
+ * 解析 body 模板：将 ${param|default} 替换为实际参数值
+ *
+ * 规则：
+ * - ${code}       → args.code（必须提供，否则返回空字符串）
+ * - ${market|0}   → args.market ?? '0'（可选，带默认值）
+ * - 类型跟随默认值：默认值是字符串则结果也是字符串，数字则数字
+ * - 非模板值（number, boolean, null）保持原样
+ */
+function resolveBodyTemplate(template, args) {
+    const result = {};
+    for (const [key, val] of Object.entries(template)) {
+        result[key] = resolveValue(val, args);
+    }
+    return result;
+}
+function resolveValue(val, args) {
+    if (typeof val === 'string') {
+        return resolveString(val, args);
+    }
+    if (Array.isArray(val)) {
+        return val.map(v => resolveValue(v, args));
+    }
+    if (val !== null && typeof val === 'object') {
+        const obj = {};
+        for (const [k, v] of Object.entries(val)) {
+            obj[k] = resolveValue(v, args);
+        }
+        return obj;
+    }
+    return val; // number, boolean, null → 保持原样
+}
+/** 解析字符串中的 ${param|default} 模板 */
+function resolveString(str, args) {
+    // 整串匹配：整个字符串就是一个模板变量
+    const fullMatch = str.match(/^\$\{(\w+)(?:\|([^}]*))?\}$/);
+    if (fullMatch) {
+        const [, paramName, defaultStr] = fullMatch;
+        if (args[paramName] !== undefined && args[paramName] !== null) {
+            // 如果默认值是字符串，将参数转为字符串
+            return defaultStr !== undefined ? String(args[paramName]) : args[paramName];
+        }
+        // 使用默认值
+        return defaultStr !== undefined ? defaultStr : '';
+    }
+    // 部分替换：字符串中包含多个 ${} 模板
+    return str.replace(/\$\{(\w+)(?:\|([^}]*))?\}/g, (_, paramName, defaultStr) => {
+        if (args[paramName] !== undefined && args[paramName] !== null) {
+            return String(args[paramName]);
+        }
+        return defaultStr !== undefined ? defaultStr : '';
+    });
+}
+//# sourceMappingURL=body-template.js.map

package/dist/cjs/mcp/body-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-template.js","sourceRoot":"","sources":["../../../src/mcp/body-template.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAWH,kDASC;AAlBD;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CACjC,QAAiC,EACjC,IAA6B;IAE7B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,GAAY,EAAE,IAA6B;IAC/D,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,+BAA+B;AAC7C,CAAC;AAED,kCAAkC;AAClC,SAAS,aAAa,CAAC,GAAW,EAAE,IAA6B;IAC/D,qBAAqB;IACrB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,GAAG,SAAS,CAAC;QAC5C,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9D,qBAAqB;YACrB,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9E,CAAC;QACD,QAAQ;QACR,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC;IACD,uBAAuB;IACvB,OAAO,GAAG,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE;QAC5E,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9D,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cjs/mcp/openapi-importer.d.ts

@@ -0,0 +1,24 @@
+import type { MCPToolDefinition } from '../types.js';
+/** OpenAPI 导入结果 */
+export interface OpenAPIImportResult {
+    /** 生成的 MCP 工具定义列表 */
+    toolDefinitions: MCPToolDefinition[];
+    /** 生成的 apiMapping（工具名 → 请求映射配置） */
+    apiMapping: Record<string, Record<string, unknown>>;
+}
+/** 导入选项 */
+export interface OpenAPIImportOptions {
+    /** 工具名前缀（如 "petstore_"），避免多 spec 命名冲突 */
+    prefix?: string;
+    /** 仅导入包含指定 tag 的 operation */
+    tagFilter?: string[];
+}
+/**
+ * 从 OpenAPI spec（URL 或本地路径）自动导入工具定义和 apiMapping
+ *
+ * @param specUrlOrPath OpenAPI spec 的 URL 或本地文件路径
+ * @param options 导入选项
+ * @returns toolDefinitions + apiMapping
+ */
+export declare function importFromOpenAPI(specUrlOrPath: string, options?: OpenAPIImportOptions): Promise<OpenAPIImportResult>;
+//# sourceMappingURL=openapi-importer.d.ts.map

package/dist/cjs/mcp/openapi-importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-importer.d.ts","sourceRoot":"","sources":["../../../src/mcp/openapi-importer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,mBAAmB;AACnB,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,eAAe,EAAE,iBAAiB,EAAE,CAAC;IACrC,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,WAAW;AACX,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAqE9B"}

package/dist/cjs/mcp/openapi-importer.js

@@ -0,0 +1,183 @@
+"use strict";
+// ============================================================
+// OpenAPI Importer — 从 OpenAPI 3.x / Swagger 2.0 spec 自动生成 MCP 工具定义
+// ============================================================
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importFromOpenAPI = importFromOpenAPI;
+const swagger_parser_1 = __importDefault(require("@apidevtools/swagger-parser"));
+/**
+ * 从 OpenAPI spec（URL 或本地路径）自动导入工具定义和 apiMapping
+ *
+ * @param specUrlOrPath OpenAPI spec 的 URL 或本地文件路径
+ * @param options 导入选项
+ * @returns toolDefinitions + apiMapping
+ */
+async function importFromOpenAPI(specUrlOrPath, options) {
+    const api = await swagger_parser_1.default.dereference(specUrlOrPath);
+    const paths = api.paths || {};
+    const prefix = options?.prefix || '';
+    const tagFilter = options?.tagFilter;
+    const toolDefinitions = [];
+    const apiMapping = {};
+    for (const [pathStr, pathItem] of Object.entries(paths)) {
+        if (!pathItem || typeof pathItem !== 'object')
+            continue;
+        for (const method of ['get', 'post', 'put', 'delete', 'patch']) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            // tag 过滤
+            if (tagFilter?.length) {
+                const opTags = operation.tags || [];
+                if (!opTags.some(t => tagFilter.includes(t)))
+                    continue;
+            }
+            // 1. 生成工具名
+            const rawName = operation.operationId || generateToolName(method, pathStr);
+            const toolName = prefix + sanitizeName(rawName);
+            // 2. 生成 description
+            const description = operation.summary || operation.description || `${method.toUpperCase()} ${pathStr}`;
+            // 3. 生成 parameters schema
+            const { properties, required } = buildParameterSchema(operation, pathItem, pathStr);
+            const parameters = {
+                type: 'object',
+                properties,
+                ...(required.length > 0 ? { required } : {}),
+            };
+            toolDefinitions.push({ name: toolName, description, parameters });
+            // 4. 生成 apiMapping 条目
+            const entry = pathStr.startsWith('/') ? pathStr.slice(1) : pathStr;
+            const mapping = {
+                entry,
+                method: method.toUpperCase(),
+            };
+            // body 模板（POST/PUT/PATCH → requestBody properties）
+            if (['post', 'put', 'patch'].includes(method)) {
+                const bodyTemplate = buildBodyTemplate(operation);
+                if (bodyTemplate && Object.keys(bodyTemplate).length > 0) {
+                    mapping.body = bodyTemplate;
+                }
+            }
+            // query/path 参数 → body 模板（GET/DELETE → query string 化）
+            if (['get', 'delete'].includes(method)) {
+                const queryTemplate = buildQueryTemplate(operation, pathItem, pathStr);
+                if (queryTemplate && Object.keys(queryTemplate).length > 0) {
+                    mapping.body = queryTemplate;
+                }
+            }
+            apiMapping[toolName] = mapping;
+        }
+    }
+    console.log(`[OpenAPI:Import] ${specUrlOrPath}: ${toolDefinitions.length} tools generated`);
+    return { toolDefinitions, apiMapping };
+}
+// ===== 内部辅助函数 =====
+/**
+ * 从 HTTP method + path 自动生成工具名
+ * GET /users/{id} → get_users_by_id
+ */
+function generateToolName(method, path) {
+    const parts = path.split('/').filter(Boolean).map(segment => {
+        if (segment.startsWith('{') && segment.endsWith('}')) {
+            return 'by_' + segment.slice(1, -1);
+        }
+        return segment;
+    });
+    return `${method}_${parts.join('_')}`;
+}
+/** 清理名称为合法标识符（仅保留字母、数字、下划线） */
+function sanitizeName(name) {
+    return name.replace(/[^a-zA-Z0-9_]/g, '_').replace(/_+/g, '_').replace(/^_|_$/g, '');
+}
+/**
+ * 从 operation 的 parameters + requestBody 构建 JSON Schema
+ */
+function buildParameterSchema(operation, pathItem, pathStr) {
+    const properties = {};
+    const required = [];
+    // 合并 path-level + operation-level parameters
+    const allParams = [
+        ...(pathItem.parameters || []),
+        ...(operation.parameters || []),
+    ];
+    for (const param of allParams) {
+        const name = param.name;
+        if (!name)
+            continue;
+        const schema = param.schema || {};
+        properties[name] = {
+            type: schema.type || 'string',
+            description: param.description || `${param.in} parameter: ${name}`,
+            ...(schema.enum ? { enum: schema.enum } : {}),
+        };
+        if (param.required) {
+            required.push(name);
+        }
+    }
+    // requestBody → 提取顶层 properties
+    const requestBody = operation.requestBody;
+    if (requestBody) {
+        const content = requestBody.content || {};
+        const mediaType = content['application/json'] || content['application/x-www-form-urlencoded'] || Object.values(content)[0];
+        if (mediaType?.schema?.properties) {
+            for (const [propName, propSchema] of Object.entries(mediaType.schema.properties)) {
+                if (!properties[propName]) {
+                    const ps = propSchema;
+                    properties[propName] = {
+                        type: ps.type || 'string',
+                        description: ps.description || '',
+                        ...(ps.enum ? { enum: ps.enum } : {}),
+                    };
+                }
+            }
+            if (mediaType.schema.required?.length) {
+                for (const r of mediaType.schema.required) {
+                    if (!required.includes(r))
+                        required.push(r);
+                }
+            }
+        }
+        if (requestBody.required && required.length === 0) {
+            // requestBody 整体 required 但无具体字段，跳过
+        }
+    }
+    return { properties, required };
+}
+/**
+ * 从 requestBody 构建 POST body 模板（${param} 占位符）
+ */
+function buildBodyTemplate(operation) {
+    const requestBody = operation.requestBody;
+    if (!requestBody)
+        return undefined;
+    const content = requestBody.content || {};
+    const mediaType = content['application/json'] || Object.values(content)[0];
+    if (!mediaType?.schema?.properties)
+        return undefined;
+    const template = {};
+    for (const propName of Object.keys(mediaType.schema.properties)) {
+        template[propName] = `\${${propName}}`;
+    }
+    return template;
+}
+/**
+ * 从 query/path parameters 构建 GET query 模板
+ */
+function buildQueryTemplate(operation, pathItem, pathStr) {
+    const allParams = [
+        ...(pathItem.parameters || []),
+        ...(operation.parameters || []),
+    ];
+    const queryParams = allParams.filter((p) => p.in === 'query');
+    if (queryParams.length === 0)
+        return undefined;
+    const template = {};
+    for (const param of queryParams) {
+        template[param.name] = `\${${param.name}}`;
+    }
+    return template;
+}
+//# sourceMappingURL=openapi-importer.js.map

package/dist/cjs/mcp/openapi-importer.js.map

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

package/dist/cjs/mcp/template-builder.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @file 通用模板请求构建器
+ * @description 配置驱动的 HTTP 请求构建，从 manifest/extra 中读取 URL 模板、body 模板、relay、认证和响应配置。
+ *              适用于所有“模板化 HTTP API → MCP”的连接器，无需编写连接器专属 builder 代码。
+ *
+ * 配置字段（来自 MCPServerEntity / manifest extra）：
+ * - urlTemplate: URL 构建模板，支持 {apiRoot} {entry} 占位符
+ * - apiRoot:     API 根 URL
+ * - apiMapping:  工具名 → { entry, body, method?, url? } 映射
+ * - relay:       可选的业务级代理转发配置（url + headers，通过 target-url header 转发）
+ * - auth:        可选的认证配置（bearer/basic/apiKey/custom）
+ * - response:    可选的响应处理配置（JSONPath 提取 + 错误码检测）
+ *
+ * 映射扩展字段：
+ * - method:  'GET' | 'POST'（默认 'POST'）
+ * - url:     直接覆盖 urlTemplate（支持 {apiRoot} 占位符）
+ * - entry:   支持 ${param} 路径参数（如 v8/finance/chart/${symbol}）
+ */
+import type { RequestBuilderFn, AuthConfig, ResponseConfig } from './api-bridge-types.js';
+/** 通用模板构建器的 extra 配置结构 */
+export interface TemplateBuilderExtra {
+    /** API 根 URL */
+    apiRoot: string;
+    /** URL 构建模板，支持 {apiRoot} 和 {entry} 占位符 */
+    urlTemplate: string;
+    /** 工具名 → 映射配置（含 entry + body 模板 + 可选 method/url） */
+    apiMapping: Record<string, {
+        entry: string;
+        body?: Record<string, unknown>;
+        /** HTTP 方法，默认 'POST' */
+        method?: 'GET' | 'POST';
+        /** 直接覆盖 urlTemplate（支持 {apiRoot} 占位符） */
+        url?: string;
+    }>;
+    /**
+     * 业务级代理转发配置（可选）
+     *
+     * 与网络级 `proxy`（undici ProxyAgent）不同，
+     * relay 通过 HTTP header（target-url / target-headers）将请求转发给中间服务。
+     */
+    relay?: {
+        url: string;
+        headers?: Record<string, string>;
+    };
+    /** 认证配置（支持 bearer/basic/apiKey/custom） */
+    auth?: AuthConfig;
+    /** 全局响应处理配置（可被 mapping 级 response 覆盖） */
+    response?: ResponseConfig;
+    /** 自定义默认请求头（如 User-Agent），连接器级可覆盖全局默认 */
+    headers?: Record<string, string>;
+}
+export declare const buildFromTemplate: RequestBuilderFn;
+//# sourceMappingURL=template-builder.d.ts.map

package/dist/cjs/mcp/template-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-builder.d.ts","sourceRoot":"","sources":["../../../src/mcp/template-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG1F,0BAA0B;AAC1B,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,wBAAwB;QACxB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;QACxB,yCAAyC;QACzC,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH;;;;;OAKG;IACH,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;IACF,0CAA0C;IAC1C,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAmDD,eAAO,MAAM,iBAAiB,EAAE,gBA2G/B,CAAC"}

package/dist/cjs/mcp/template-builder.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * @file 通用模板请求构建器
+ * @description 配置驱动的 HTTP 请求构建，从 manifest/extra 中读取 URL 模板、body 模板、relay、认证和响应配置。
+ *              适用于所有“模板化 HTTP API → MCP”的连接器，无需编写连接器专属 builder 代码。
+ *
+ * 配置字段（来自 MCPServerEntity / manifest extra）：
+ * - urlTemplate: URL 构建模板，支持 {apiRoot} {entry} 占位符
+ * - apiRoot:     API 根 URL
+ * - apiMapping:  工具名 → { entry, body, method?, url? } 映射
+ * - relay:       可选的业务级代理转发配置（url + headers，通过 target-url header 转发）
+ * - auth:        可选的认证配置（bearer/basic/apiKey/custom）
+ * - response:    可选的响应处理配置（JSONPath 提取 + 错误码检测）
+ *
+ * 映射扩展字段：
+ * - method:  'GET' | 'POST'（默认 'POST'）
+ * - url:     直接覆盖 urlTemplate（支持 {apiRoot} 占位符）
+ * - entry:   支持 ${param} 路径参数（如 v8/finance/chart/${symbol}）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFromTemplate = void 0;
+const body_template_ts_1 = require("./body-template.js");
+/**
+ * 从 AuthConfig 构建认证 headers
+ *
+ * 支持 `${env.VAR_NAME}` 模板：运行时从环境变量读取凭证。
+ */
+function buildAuthHeaders(auth) {
+    if (!auth?.value)
+        return {};
+    const val = resolveEnvTemplate(auth.value);
+    switch (auth.type) {
+        case 'bearer': return { 'Authorization': `Bearer ${val}` };
+        case 'basic': return { 'Authorization': `Basic ${val}` };
+        case 'apiKey': return { [auth.name || 'X-API-Key']: val };
+        case 'custom': return { [auth.name || 'X-Custom-Auth']: val };
+        default: return {};
+    }
+}
+/**
+ * 解析 `${env.VAR_NAME}` 模板，从环境变量读取值
+ *
+ * - `${env.MY_API_KEY}` → process.env.MY_API_KEY
+ * - 普通字符串原样返回
+ */
+function resolveEnvTemplate(str) {
+    return str.replace(/\$\{env\.(\w+)\}/g, (_, name) => process.env[name] || '');
+}
+/**
+ * 通用模板请求构建器
+ *
+ * 纯配置驱动，从 extra 中读取所有构建参数：
+ * - URL 构建：urlTemplate 占位符替换 / mapping.url 直接覆盖
+ * - Body 构建：${param|default} 模板解析
+ * - GET 模式：body 模板 → query string
+ * - Relay 转发：relay 配置 → target-url / target-headers
+ * - Auth 认证：auth 配置 → Authorization / 自定义 headers
+ *
+ * 连接器只需在 manifest.json 中声明配置，无需编写专属 builder。
+ */
+/**
+ * 默认浏览器请求头
+ * 很多公开 API（如 Yahoo Finance）需要 User-Agent 才能返回 JSON 而非 HTML consent 页面
+ */
+const DEFAULT_BROWSER_HEADERS = {
+    'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36',
+    'Accept': 'application/json, text/plain, */*',
+    'Accept-Language': 'en-US,en;q=0.9',
+};
+const buildFromTemplate = async (ctx) => {
+    const { toolName, args, mapping, extra } = ctx;
+    const config = extra;
+    const m = mapping;
+    // 1. 解析 entry（支持 ${param} 路径参数，如 v8/finance/chart/${symbol}）
+    const entryRaw = m.entry;
+    if (!entryRaw && !m.url) {
+        throw new Error(`Tool '${toolName}' has no 'entry' or 'url' defined in apiMapping`);
+    }
+    const entry = entryRaw
+        ? resolveString(entryRaw, args)
+        : '';
+    // 2. 构建目标 URL（mapping.url 优先，否则用全局 urlTemplate）
+    let targetUrl;
+    if (m.url) {
+        // mapping 级 url 覆盖：支持 {apiRoot} 占位符
+        targetUrl = m.url
+            .replace('{apiRoot}', config.apiRoot || '')
+            .replace('{entry}', encodeURIComponent(String(entry)));
+    }
+    else {
+        const urlTemplate = config.urlTemplate || '{apiRoot}?Entry={entry}';
+        targetUrl = urlTemplate
+            .replace('{apiRoot}', config.apiRoot || '')
+            .replace('{entry}', encodeURIComponent(String(entry)));
+    }
+    // 3. 解析 body 模板
+    const bodyTemplate = m.body;
+    const bodyObj = bodyTemplate ? (0, body_template_ts_1.resolveBodyTemplate)(bodyTemplate, args) : {};
+    // 4. 确定 HTTP 方法（mapping 级 > 全局级 > 默认 POST）
+    const method = (m.method || config['method'] || 'POST').toUpperCase();
+    // 4.5 构建认证 headers
+    const authHeaders = buildAuthHeaders(config.auth);
+    // 4.6 合并默认浏览器头 + 连接器自定义头 + 认证头（后者优先级高）
+    const baseHeaders = {
+        ...DEFAULT_BROWSER_HEADERS,
+        ...(config.headers || {}),
+        ...authHeaders,
+    };
+    // 5. GET 模式：body 模板 → query string
+    if (method === 'GET') {
+        const params = new URLSearchParams();
+        for (const [k, v] of Object.entries(bodyObj)) {
+            if (v !== undefined && v !== null && v !== '') {
+                params.set(k, String(v));
+            }
+        }
+        const qs = params.toString();
+        const finalUrl = qs ? `${targetUrl}?${qs}` : targetUrl;
+        if (config.relay) {
+            return {
+                url: config.relay.url,
+                init: {
+                    method: 'GET',
+                    headers: {
+                        ...baseHeaders,
+                        ...(config.relay.headers || {}),
+                        'target-url': finalUrl,
+                    },
+                },
+            };
+        }
+        return {
+            url: finalUrl,
+            init: { method: 'GET', headers: { ...baseHeaders } },
+        };
+    }
+    // 6. POST 模式：body → JSON
+    const body = JSON.stringify(bodyObj);
+    if (config.relay) {
+        return {
+            url: config.relay.url,
+            init: {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...baseHeaders,
+                    ...(config.relay.headers || {}),
+                    'target-url': targetUrl,
+                    'target-headers': JSON.stringify({ 'Content-Type': 'application/json' }),
+                },
+                body,
+            },
+        };
+    }
+    return {
+        url: targetUrl,
+        init: {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...baseHeaders,
+            },
+            body,
+        },
+    };
+};
+exports.buildFromTemplate = buildFromTemplate;
+/** 解析字符串中的 ${param|default} 模板（复用 body-template 的逻辑） */
+function resolveString(str, args) {
+    return str.replace(/\$\{(\w+)(?:\|([^}]*))?\}/g, (_, paramName, defaultStr) => {
+        if (args[paramName] !== undefined && args[paramName] !== null) {
+            return String(args[paramName]);
+        }
+        return defaultStr !== undefined ? defaultStr : '';
+    });
+}
+//# sourceMappingURL=template-builder.js.map

package/dist/cjs/mcp/template-builder.js.map

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

package/dist/cjs/model/automation.d.ts

@@ -0,0 +1,34 @@
+/** 自动化任务运行状态 */
+export type AutomationStatus = 'idle' | 'running' | 'success' | 'error';
+/** 自动化定时任务实体 */
+export interface AutomationEntity {
+    id: number;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    schedule: string;
+    prompt: string;
+    agentProfileId?: number;
+    workspaceId?: number;
+    lastRunAt?: string;
+    lastStatus?: AutomationStatus;
+    lastResult?: string;
+    nextRunAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** 自动化任务执行记录 */
+export interface AutomationRunEntity {
+    id: number;
+    automationId: number;
+    status: AutomationStatus;
+    triggerType: 'schedule' | 'manual';
+    prompt: string;
+    result: string;
+    errors: string[];
+    startedAt: string;
+    finishedAt: string;
+    duration: number;
+    sessionId: string;
+}
+//# sourceMappingURL=automation.d.ts.map

package/dist/cjs/model/automation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../../src/model/automation.ts"],"names":[],"mappings":"AAIA,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAExE,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/cjs/model/automation.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================
+// AutomationEntity — 自动化定时任务数据模型
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=automation.js.map

package/dist/cjs/model/automation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.js","sourceRoot":"","sources":["../../../src/model/automation.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,iCAAiC;AACjC,+DAA+D"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/prompt/prompt-builder.d.ts

@@ -0,0 +1,14 @@
+import type { ToolRegistry, SkillManager } from '@cicctencent/agent-core';
+import type { AgentProfileEntity, PromptBuilderProvider, SpecialistResourceContext } from '../types.js';
+/**
+ * 默认 PromptBuilderProvider 实现
+ */
+export declare class DefaultPromptBuilder implements PromptBuilderProvider {
+    resolveToolDisplayName(toolName: string, _registry: ToolRegistry): string;
+    buildDefaultPrompt(profile: AgentProfileEntity, tools: ToolRegistry, memory?: string, specialists?: AgentProfileEntity[], specialistResourceMap?: Record<string, SpecialistResourceContext>): string;
+    buildSpecialistPrompt(profile: AgentProfileEntity, tools: ToolRegistry, skills: SkillManager, memory?: string): string;
+    buildToolDescList(registry: ToolRegistry): string;
+    buildMCPToolDescList(registry: ToolRegistry): string;
+}
+export declare const RESULT_SYNTHESIS_PROMPT = "Based on the specialist agents' outputs above, provide a comprehensive synthesis:\n1. Summarize key findings from each agent\n2. Identify any conflicts or contradictions\n3. Provide a unified recommendation\n4. Highlight any risks or caveats\nRespond in the same language as the user.";
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/cjs/prompt/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../../src/prompt/prompt-builder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AA2BxG;;GAEG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,MAAM;IAIzE,kBAAkB,CAChB,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,YAAY,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,kBAAkB,EAAE,EAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,GAChE,MAAM;IAkCT,qBAAqB,CACnB,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM;IAuBT,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;IAYjD,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;CASrD;AAED,eAAO,MAAM,uBAAuB,iSAKM,CAAC"}