@proofhound/core 0.1.6

package/dist/server/channels/mcp/canary-release.tools.js

@@ -0,0 +1,279 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCanaryReleaseTools = createCanaryReleaseTools;
+/**
+ * MCP tool definitions for canary releases.
+ * Each tool delegates to CanaryReleaseService, matching the REST surface 1:1.
+ * See docs/specs/00-overview.md §5 (three-channel parity) + docs/specs/27-releases.md.
+ */
+const shared_1 = require("@proofhound/shared");
+const zod_1 = require("zod");
+const mcp_context_1 = require("./mcp-context");
+const uuidParam = zod_1.z.string().uuid();
+function createCanaryReleaseTools(service) {
+    return [
+        {
+            name: 'canary_release_list',
+            description: '列出所有灰度发布及标注进度',
+            inputSchema: { type: 'object', properties: {} },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                return service.list(projectId, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'canary_release_get',
+            description: '读取单个灰度发布详情',
+            inputSchema: {
+                type: 'object',
+                required: ['canaryId'],
+                properties: {
+                    canaryId: { type: 'string', format: 'uuid' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const canaryId = uuidParam.parse(input.canaryId);
+                return service.getDetail(projectId, canaryId, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'canary_release_create',
+            description: '新建灰度发布；提交后直接进入 running',
+            inputSchema: {
+                type: 'object',
+                required: [
+                    'promptVersionId',
+                    'modelId',
+                    'inputConnectorId',
+                    'trafficRatio',
+                    'runMode',
+                    'variableMapping',
+                    'externalIdField',
+                    'runConfig',
+                ],
+                properties: {
+                    name: { type: ['string', 'null'], minLength: 1, maxLength: 120 },
+                    description: { type: ['string', 'null'], maxLength: 500 },
+                    promptVersionId: { type: 'string', format: 'uuid' },
+                    modelId: { type: 'string', format: 'uuid' },
+                    inputConnectorId: { type: 'string', format: 'uuid' },
+                    outputConnectorIds: { type: 'array', items: { type: 'string', format: 'uuid' } },
+                    trafficRatio: { type: 'number', exclusiveMinimum: 0, maximum: 1 },
+                    trafficMode: { type: 'string', enum: ['split', 'dual_run'] },
+                    runMode: { type: 'string', enum: ['fixed_duration', 'manual'] },
+                    recordMode: { type: 'string', enum: ['all', 'correct_only'] },
+                    variableMapping: { type: 'array', items: { type: 'object' } },
+                    outputMapping: { type: 'array', items: { type: 'object' } },
+                    filterRules: {},
+                    stopConditions: { type: 'object' },
+                    externalIdField: { type: 'string', minLength: 1 },
+                    annotationSchema: { type: 'array', items: { type: 'object' } },
+                    storageCategories: { type: 'array', items: { type: 'string' } },
+                    targetDatasetId: { type: 'string', format: 'uuid' },
+                    runConfig: { type: 'object' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId, orgId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const dto = shared_1.createCanaryReleaseInputSchema.parse(input);
+                return service.create(projectId, dto, (0, mcp_context_1.getMcpActor)(ctx), orgId);
+            },
+        },
+        {
+            name: 'canary_release_start',
+            description: '兼容旧数据：将历史 pending 灰度发布转为 running',
+            inputSchema: {
+                type: 'object',
+                required: ['canaryId'],
+                properties: {
+                    canaryId: { type: 'string', format: 'uuid' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId, orgId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const canaryId = uuidParam.parse(input.canaryId);
+                return service.start(projectId, canaryId, (0, mcp_context_1.getMcpActor)(ctx), orgId);
+            },
+        },
+        {
+            name: 'canary_release_stop',
+            description: '停止 running 灰度发布',
+            inputSchema: {
+                type: 'object',
+                required: ['canaryId'],
+                properties: {
+                    canaryId: { type: 'string', format: 'uuid' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const canaryId = uuidParam.parse(input.canaryId);
+                shared_1.stopCanaryReleaseInputSchema.parse({});
+                return service.stop(projectId, canaryId, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'canary_release_resume',
+            description: '将 stopped 灰度发布恢复为 running',
+            inputSchema: {
+                type: 'object',
+                required: ['canaryId'],
+                properties: {
+                    canaryId: { type: 'string', format: 'uuid' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId, orgId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const canaryId = uuidParam.parse(input.canaryId);
+                shared_1.resumeCanaryReleaseInputSchema.parse({});
+                return service.resume(projectId, canaryId, (0, mcp_context_1.getMcpActor)(ctx), orgId);
+            },
+        },
+        {
+            name: 'canary_release_cancel',
+            description: '取消 running 灰度发布（兼容历史 pending）',
+            inputSchema: {
+                type: 'object',
+                required: ['canaryId'],
+                properties: {
+                    canaryId: { type: 'string', format: 'uuid' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const canaryId = uuidParam.parse(input.canaryId);
+                shared_1.cancelCanaryReleaseInputSchema.parse({});
+                return service.cancel(projectId, canaryId, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'canary_release_update_traffic_ratio',
+            description: '调整 running / stopped 灰度发布的流量比例；split 模式 running 且 trafficRatio=1 会触发 from_canary 晋升',
+            inputSchema: {
+                type: 'object',
+                required: ['canaryId', 'trafficRatio'],
+                properties: {
+                    canaryId: { type: 'string', format: 'uuid' },
+                    trafficRatio: { type: 'number', exclusiveMinimum: 0, maximum: 1 },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const canaryId = uuidParam.parse(input.canaryId);
+                const payload = shared_1.updateCanaryTrafficRatioInputSchema.parse({ trafficRatio: input.trafficRatio });
+                return service.updateTrafficRatio(projectId, canaryId, payload, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'canary_release_delete',
+            description: '删除灰度发布；若被正式发布事件引用需 force=true 跳过引用预检',
+            inputSchema: {
+                type: 'object',
+                required: ['canaryId'],
+                properties: {
+                    canaryId: { type: 'string', format: 'uuid' },
+                    force: { type: 'boolean' },
+                    reason: { type: 'string', maxLength: 2000 },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const canaryId = uuidParam.parse(input.canaryId);
+                return service.softDelete(projectId, canaryId, {
+                    force: Boolean(input.force),
+                    reason: typeof input.reason === 'string' ? input.reason : undefined,
+                }, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'canary_release_annotation_list',
+            description: '列出灰度发布的标注样本（pending / claimed / submitted 三种状态可筛）',
+            inputSchema: {
+                type: 'object',
+                required: ['canaryId'],
+                properties: {
+                    canaryId: { type: 'string', format: 'uuid' },
+                    status: { type: 'string', enum: ['pending', 'claimed', 'submitted'] },
+                    limit: { type: 'integer', minimum: 1, maximum: 200 },
+                    offset: { type: 'integer', minimum: 0 },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const canaryId = uuidParam.parse(input.canaryId);
+                const limit = typeof input.limit === 'number' ? input.limit : 20;
+                const offset = typeof input.offset === 'number' ? input.offset : 0;
+                const status = input.status === 'pending' || input.status === 'claimed' || input.status === 'submitted'
+                    ? input.status
+                    : undefined;
+                return service.listAnnotations(projectId, canaryId, { status, limit, offset }, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'canary_release_annotation_claim',
+            description: '抢占式批量领取灰度标注样本（最多 100 条；5 分钟无心跳自动归还）',
+            inputSchema: {
+                type: 'object',
+                required: ['canaryId', 'batchSize'],
+                properties: {
+                    canaryId: { type: 'string', format: 'uuid' },
+                    batchSize: { type: 'integer', minimum: 1, maximum: 100 },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const canaryId = uuidParam.parse(input.canaryId);
+                const payload = shared_1.claimCanaryAnnotationsInputSchema.parse({ batchSize: input.batchSize });
+                return service.claimAnnotations(projectId, canaryId, payload, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'canary_release_annotation_submit',
+            description: '提交灰度标注样本（仅本人锁定的样本可提交）',
+            inputSchema: {
+                type: 'object',
+                required: ['canaryId', 'annotationId'],
+                properties: {
+                    canaryId: { type: 'string', format: 'uuid' },
+                    annotationId: { type: 'string', format: 'uuid' },
+                    isCorrect: { type: ['boolean', 'null'] },
+                    notes: { type: ['string', 'null'] },
+                    fields: { type: 'object', additionalProperties: true },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const canaryId = uuidParam.parse(input.canaryId);
+                const payload = shared_1.submitCanaryAnnotationInputSchema.parse({
+                    annotationId: input.annotationId,
+                    isCorrect: input.isCorrect ?? null,
+                    notes: input.notes ?? null,
+                    fields: input.fields ?? {},
+                });
+                return service.submitAnnotation(projectId, canaryId, payload, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'canary_release_annotation_release',
+            description: '释放当前用户锁定的灰度标注样本回队列',
+            inputSchema: {
+                type: 'object',
+                required: ['canaryId', 'annotationId'],
+                properties: {
+                    canaryId: { type: 'string', format: 'uuid' },
+                    annotationId: { type: 'string', format: 'uuid' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const canaryId = uuidParam.parse(input.canaryId);
+                const payload = shared_1.releaseCanaryAnnotationInputSchema.parse({
+                    annotationId: input.annotationId,
+                });
+                return service.releaseAnnotation(projectId, canaryId, payload, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+    ];
+}
+//# sourceMappingURL=canary-release.tools.js.map

package/dist/server/channels/mcp/canary-release.tools.js.map

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

package/dist/server/channels/mcp/connector.tools.d.ts

@@ -0,0 +1,4 @@
+import type { ConnectorService } from '../../modules/connector/connector.service';
+import type { McpToolDefinition } from './mcp.types';
+export declare function createConnectorTools(service: ConnectorService): McpToolDefinition[];
+//# sourceMappingURL=connector.tools.d.ts.map

package/dist/server/channels/mcp/connector.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.tools.d.ts","sourceRoot":"","sources":["../../../../src/server/channels/mcp/connector.tools.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAUrD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,EAAE,CAoNnF"}

package/dist/server/channels/mcp/connector.tools.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConnectorTools = createConnectorTools;
+/**
+ * MCP tool definitions for the connector domain.
+ * Each tool delegates to ConnectorService, matching the REST surface 1:1.
+ * See docs/specs/00-overview.md §5 (three-channel parity) / docs/specs/26-connectors.md §3
+ */
+const shared_1 = require("@proofhound/shared");
+const zod_1 = require("zod");
+const mcp_context_1 = require("./mcp-context");
+const connectorIdInputSchema = {
+    type: 'object',
+    required: ['connectorId'],
+    properties: {
+        connectorId: { type: 'string', format: 'uuid' },
+    },
+};
+function createConnectorTools(service) {
+    return [
+        {
+            name: 'connector_list',
+            description: '列出连接器',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    direction: { type: 'string', enum: ['input', 'output'] },
+                    type: { type: 'string', enum: ['redis', 'kafka', 'webhook'] },
+                    healthStatus: { type: 'string', enum: ['healthy', 'degraded', 'unhealthy', 'unknown'] },
+                    search: { type: 'string' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const query = shared_1.connectorListQuerySchema.parse({
+                    direction: input.direction,
+                    type: input.type,
+                    healthStatus: input.healthStatus,
+                    search: input.search,
+                });
+                return service.list(projectId, (0, mcp_context_1.getMcpActor)(ctx), query);
+            },
+        },
+        {
+            name: 'connector_get',
+            description: '读取连接器详情',
+            inputSchema: connectorIdInputSchema,
+            handler: async (input, ctx) => service.getDetail((0, mcp_context_1.resolveMcpProjectContext)(ctx).projectId, shared_1.connectorIdParamSchema.parse(input.connectorId), (0, mcp_context_1.getMcpActor)(ctx)),
+        },
+        {
+            name: 'connector_get_references',
+            description: '获取连接器引用统计(被哪些灰度 / 正式发布占用)',
+            inputSchema: connectorIdInputSchema,
+            handler: async (input, ctx) => service.getReferences((0, mcp_context_1.resolveMcpProjectContext)(ctx).projectId, shared_1.connectorIdParamSchema.parse(input.connectorId), (0, mcp_context_1.getMcpActor)(ctx)),
+        },
+        {
+            name: 'connector_create',
+            description: '创建连接器',
+            inputSchema: { type: 'object', properties: {} },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const dto = shared_1.createConnectorSchema.parse(input);
+                return service.create(projectId, dto, (0, mcp_context_1.getMcpActor)(ctx), 'mcp');
+            },
+        },
+        {
+            name: 'connector_update',
+            description: '更新连接器(direction / type 不可改)',
+            inputSchema: connectorIdInputSchema,
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const connectorId = shared_1.connectorIdParamSchema.parse(input.connectorId);
+                const { connectorId: _c, ...rest } = input;
+                const dto = shared_1.updateConnectorSchema.parse(rest);
+                return service.update(projectId, connectorId, dto, (0, mcp_context_1.getMcpActor)(ctx), 'mcp');
+            },
+        },
+        {
+            name: 'connector_delete',
+            description: '删除连接器(被运行中发布占用时拒绝,force=true 强删)',
+            inputSchema: {
+                type: 'object',
+                required: ['connectorId'],
+                properties: {
+                    connectorId: { type: 'string', format: 'uuid' },
+                    force: { type: 'boolean' },
+                    reason: { type: 'string' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const connectorId = shared_1.connectorIdParamSchema.parse(input.connectorId);
+                const query = shared_1.connectorDeleteQuerySchema.parse({ force: input.force, reason: input.reason });
+                await service.delete(projectId, connectorId, query, (0, mcp_context_1.getMcpActor)(ctx), 'mcp');
+                return { ok: true };
+            },
+        },
+        {
+            name: 'connector_bulk_delete',
+            description: '批量删除连接器(返回 deletedIds / rejected)',
+            inputSchema: {
+                type: 'object',
+                required: ['ids'],
+                properties: {
+                    ids: { type: 'array', items: { type: 'string', format: 'uuid' } },
+                    force: { type: 'boolean' },
+                    reason: { type: 'string' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const dto = shared_1.bulkDeleteConnectorsRequestSchema.parse({
+                    ids: input.ids,
+                    force: input.force,
+                    reason: input.reason,
+                });
+                return service.bulkDelete(projectId, dto, (0, mcp_context_1.getMcpActor)(ctx), 'mcp');
+            },
+        },
+        {
+            name: 'connector_probe',
+            description: '对连接器发起健康探测(本期 stub,返回 driver not implemented)',
+            inputSchema: connectorIdInputSchema,
+            handler: async (input, ctx) => {
+                const { projectId, orgId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                return service.probe(projectId, shared_1.connectorIdParamSchema.parse(input.connectorId), (0, mcp_context_1.getMcpActor)(ctx), 'mcp', orgId);
+            },
+        },
+        {
+            name: 'connector_list_webhook_tokens',
+            description: '列出该 webhook 输入 connector 的全部 active webhook token',
+            inputSchema: connectorIdInputSchema,
+            handler: async (input, ctx) => service.listWebhookTokens((0, mcp_context_1.resolveMcpProjectContext)(ctx).projectId, shared_1.connectorIdParamSchema.parse(input.connectorId), (0, mcp_context_1.getMcpActor)(ctx)),
+        },
+        {
+            name: 'connector_create_webhook_token',
+            description: '为 webhook 输入 connector 生成新的入站凭证(明文只在响应里出现一次)',
+            inputSchema: {
+                type: 'object',
+                required: ['connectorId'],
+                properties: {
+                    connectorId: { type: 'string', format: 'uuid' },
+                    name: { type: 'string' },
+                    expiresAt: { type: 'string', format: 'date-time' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const connectorId = shared_1.connectorIdParamSchema.parse(input.connectorId);
+                const dto = shared_1.createWebhookTokenSchema.parse({ name: input.name, expiresAt: input.expiresAt });
+                return service.createWebhookToken(projectId, connectorId, dto, (0, mcp_context_1.getMcpActor)(ctx), 'mcp');
+            },
+        },
+        {
+            name: 'connector_revoke_webhook_token',
+            description: '吊销 webhook connector 的指定 token(立即生效)',
+            inputSchema: {
+                type: 'object',
+                required: ['connectorId', 'tokenId'],
+                properties: {
+                    connectorId: { type: 'string', format: 'uuid' },
+                    tokenId: { type: 'string', format: 'uuid' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const connectorId = shared_1.connectorIdParamSchema.parse(input.connectorId);
+                const tokenId = zod_1.z.string().uuid().parse(input.tokenId);
+                await service.revokeWebhookToken(projectId, connectorId, tokenId, (0, mcp_context_1.getMcpActor)(ctx), 'mcp');
+                return { ok: true };
+            },
+        },
+        {
+            name: 'connector_reveal_webhook_token',
+            description: '查看 webhook connector 指定 token 的明文(从 token_encrypted 解密)',
+            inputSchema: {
+                type: 'object',
+                required: ['connectorId', 'tokenId'],
+                properties: {
+                    connectorId: { type: 'string', format: 'uuid' },
+                    tokenId: { type: 'string', format: 'uuid' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const connectorId = shared_1.connectorIdParamSchema.parse(input.connectorId);
+                const tokenId = zod_1.z.string().uuid().parse(input.tokenId);
+                return service.revealWebhookToken(projectId, connectorId, tokenId, (0, mcp_context_1.getMcpActor)(ctx), 'mcp');
+            },
+        },
+        {
+            name: 'connector_peek',
+            description: '抽样调试:不消费前提下读取最近 N 条消息(仅输入连接器,N≤10),并保存最近一次探测结果',
+            inputSchema: {
+                type: 'object',
+                required: ['connectorId'],
+                properties: {
+                    connectorId: { type: 'string', format: 'uuid' },
+                    limit: { type: 'integer', minimum: 1, maximum: 10 },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const connectorId = shared_1.connectorIdParamSchema.parse(input.connectorId);
+                const body = shared_1.peekConnectorRequestSchema.parse({ limit: input.limit });
+                return service.peek(projectId, connectorId, body, (0, mcp_context_1.getMcpActor)(ctx), 'mcp');
+            },
+        },
+    ];
+}
+//# sourceMappingURL=connector.tools.js.map

package/dist/server/channels/mcp/connector.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.tools.js","sourceRoot":"","sources":["../../../../src/server/channels/mcp/connector.tools.ts"],"names":[],"mappings":";;AA4BA,oDAoNC;AAhPD;;;;GAIG;AACH,+CAS4B;AAC5B,6BAAwB;AACxB,+CAAsE;AAItE,MAAM,sBAAsB,GAAG;IAC7B,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,aAAa,CAAC;IACzB,UAAU,EAAE;QACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;KAChD;CACO,CAAC;AAEX,SAAgB,oBAAoB,CAAC,OAAyB;IAC5D,OAAO;QACL;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,OAAO;YACpB,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE;oBACxD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE;oBAC7D,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE;oBACvF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC3B;aACF;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,KAAK,GAAG,iCAAwB,CAAC,KAAK,CAAC;oBAC3C,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,YAAY,EAAE,KAAK,CAAC,YAAY;oBAChC,MAAM,EAAE,KAAK,CAAC,MAAM;iBACrB,CAAC,CAAC;gBACH,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAA,yBAAW,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAC1D,CAAC;SACF;QACD;YACE,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAC5B,OAAO,CAAC,SAAS,CACf,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC,SAAS,EACvC,+BAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAC/C,IAAA,yBAAW,EAAC,GAAG,CAAC,CACjB;SACJ;QACD;YACE,IAAI,EAAE,0BAA0B;YAChC,WAAW,EAAE,2BAA2B;YACxC,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAC5B,OAAO,CAAC,aAAa,CACnB,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC,SAAS,EACvC,+BAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAC/C,IAAA,yBAAW,EAAC,GAAG,CAAC,CACjB;SACJ;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,OAAO;YACpB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;YAC/C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,GAAG,GAAG,8BAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC/C,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,IAAA,yBAAW,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YACjE,CAAC;SACF;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,6BAA6B;YAC1C,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,WAAW,GAAG,+BAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACpE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;gBAC3C,MAAM,GAAG,GAAG,8BAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9C,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,IAAA,yBAAW,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAC9E,CAAC;SACF;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,kCAAkC;YAC/C,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,aAAa,CAAC;gBACzB,UAAU,EAAE;oBACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;oBAC/C,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC3B;aACF;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,WAAW,GAAG,+BAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACpE,MAAM,KAAK,GAAG,mCAA0B,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7F,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,IAAA,yBAAW,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC7E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACtB,CAAC;SACF;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EAAE,mCAAmC;YAChD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,KAAK,CAAC;gBACjB,UAAU,EAAE;oBACV,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;oBACjE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC3B;aACF;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,GAAG,GAAG,0CAAiC,CAAC,KAAK,CAAC;oBAClD,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,MAAM,EAAE,KAAK,CAAC,MAAM;iBACrB,CAAC,CAAC;gBACH,OAAO,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,EAAE,IAAA,yBAAW,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YACrE,CAAC;SACF;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,+CAA+C;YAC5D,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC;gBAC3D,OAAO,OAAO,CAAC,KAAK,CAClB,SAAS,EACT,+BAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAC/C,IAAA,yBAAW,EAAC,GAAG,CAAC,EAChB,KAAK,EACL,KAAK,CACN,CAAC;YACJ,CAAC;SACF;QACD;YACE,IAAI,EAAE,+BAA+B;YACrC,WAAW,EAAE,mDAAmD;YAChE,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAC5B,OAAO,CAAC,iBAAiB,CACvB,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC,SAAS,EACvC,+BAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAC/C,IAAA,yBAAW,EAAC,GAAG,CAAC,CACjB;SACJ;QACD;YACE,IAAI,EAAE,gCAAgC;YACtC,WAAW,EAAE,8CAA8C;YAC3D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,aAAa,CAAC;gBACzB,UAAU,EAAE;oBACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;oBAC/C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;iBACnD;aACF;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,WAAW,GAAG,+BAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACpE,MAAM,GAAG,GAAG,iCAAwB,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC7F,OAAO,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,IAAA,yBAAW,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAC1F,CAAC;SACF;QACD;YACE,IAAI,EAAE,gCAAgC;YACtC,WAAW,EAAE,sCAAsC;YACnD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC;gBACpC,UAAU,EAAE;oBACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;oBAC/C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;iBAC5C;aACF;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,WAAW,GAAG,+BAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACpE,MAAM,OAAO,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvD,MAAM,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,IAAA,yBAAW,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC3F,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACtB,CAAC;SACF;QACD;YACE,IAAI,EAAE,gCAAgC;YACtC,WAAW,EAAE,yDAAyD;YACtE,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC;gBACpC,UAAU,EAAE;oBACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;oBAC/C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;iBAC5C;aACF;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,WAAW,GAAG,+BAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACpE,MAAM,OAAO,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvD,OAAO,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,IAAA,yBAAW,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAC9F,CAAC;SACF;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,gDAAgD;YAC7D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,aAAa,CAAC;gBACzB,UAAU,EAAE;oBACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;oBAC/C,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;iBACpD;aACF;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC5B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,sCAAwB,EAAC,GAAG,CAAC,CAAC;gBACpD,MAAM,WAAW,GAAG,+BAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACpE,MAAM,IAAI,GAAG,mCAA0B,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;gBACtE,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,IAAA,yBAAW,EAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAC7E,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/server/channels/mcp/dataset-import.tools.d.ts

@@ -0,0 +1,4 @@
+import type { DatasetImportService } from '../../modules/dataset/dataset-import.service';
+import type { McpToolDefinition } from './mcp.types';
+export declare function createDatasetImportTools(datasetImportService: DatasetImportService): McpToolDefinition[];
+//# sourceMappingURL=dataset-import.tools.d.ts.map

package/dist/server/channels/mcp/dataset-import.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-import.tools.d.ts","sourceRoot":"","sources":["../../../../src/server/channels/mcp/dataset-import.tools.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,wBAAgB,wBAAwB,CAAC,oBAAoB,EAAE,oBAAoB,GAAG,iBAAiB,EAAE,CA+FxG"}

package/dist/server/channels/mcp/dataset-import.tools.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDatasetImportTools = createDatasetImportTools;
+/**
+ * MCP tool definitions for large-file dataset import (streaming batch ingestion).
+ * Delegates to DatasetImportService, matching the REST surface 1:1.
+ * See docs/specs/22-datasets.md §3.1.2 and docs/specs/00-overview.md §5 (three-channel parity).
+ */
+const shared_1 = require("@proofhound/shared");
+const mcp_context_1 = require("./mcp-context");
+function createDatasetImportTools(datasetImportService) {
+    return [
+        {
+            name: 'dataset_import_create',
+            description: '创建大文件流式导入会话（暂不创建数据集行）',
+            inputSchema: {
+                type: 'object',
+                required: ['name', 'fieldMappings', 'sourceFile', 'sourceFormat'],
+                properties: {
+                    name: { type: 'string' },
+                    description: { type: 'string' },
+                    fieldMappings: { type: 'array' },
+                    sourceFile: { type: 'object' },
+                    sourceFormat: { type: 'string', enum: ['jsonl', 'csv', 'tsv'] },
+                    declaredTotalRows: { type: 'integer' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const dto = shared_1.createDatasetImportSchema.parse(input);
+                return datasetImportService.createImport(projectId, dto, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'dataset_import_get',
+            description: '读取导入会话状态与进度',
+            inputSchema: {
+                type: 'object',
+                required: ['importId'],
+                properties: {
+                    importId: { type: 'string', format: 'uuid' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const importId = shared_1.datasetIdParamSchema.parse(input.importId);
+                return datasetImportService.getImport(projectId, importId, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'dataset_import_append_batch',
+            description: '向导入会话追加一批样本到暂存表',
+            inputSchema: {
+                type: 'object',
+                required: ['importId', 'batchStartIndex', 'samples'],
+                properties: {
+                    importId: { type: 'string', format: 'uuid' },
+                    batchStartIndex: { type: 'integer' },
+                    samples: { type: 'array' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const importId = shared_1.datasetIdParamSchema.parse(input.importId);
+                const dto = shared_1.datasetImportBatchSchema.parse({
+                    batchStartIndex: input.batchStartIndex,
+                    samples: input.samples,
+                });
+                return datasetImportService.appendBatch(projectId, importId, dto, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'dataset_import_complete',
+            description: '完成导入：单事务原子提升暂存样本为正式数据集',
+            inputSchema: {
+                type: 'object',
+                required: ['importId'],
+                properties: {
+                    importId: { type: 'string', format: 'uuid' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const importId = shared_1.datasetIdParamSchema.parse(input.importId);
+                return datasetImportService.complete(projectId, importId, (0, mcp_context_1.getMcpActor)(ctx));
+            },
+        },
+        {
+            name: 'dataset_import_abort',
+            description: '取消导入会话并清除已暂存样本（中断即删干净）',
+            inputSchema: {
+                type: 'object',
+                required: ['importId'],
+                properties: {
+                    importId: { type: 'string', format: 'uuid' },
+                },
+            },
+            handler: async (input, ctx) => {
+                const { projectId } = (0, mcp_context_1.resolveMcpProjectContext)(ctx);
+                const importId = shared_1.datasetIdParamSchema.parse(input.importId);
+                await datasetImportService.abort(projectId, importId, (0, mcp_context_1.getMcpActor)(ctx));
+                return { ok: true };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=dataset-import.tools.js.map