@besales/mcp 0.45.0 → 0.47.0

package/dist/tools/definitions/task-state.js

@@ -0,0 +1,301 @@
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { z } from 'zod';
+import { getSessionWorkspaceId } from '../../auth/session-workspace.js';
+import { TaskStateStore, TASK_STATUSES, } from '../../tasks/task-state-store.js';
+import { WorkspaceResolutionError } from '../../auth/connection-store.js';
+import { defineTool, uuidSchema } from './shared.js';
+const taskObjectRefSchema = z
+    .object({
+    type: z.string().trim().min(1).max(80),
+    id: z.string().trim().min(1).max(200),
+    label: z.string().trim().min(1).max(200).optional(),
+})
+    .strict();
+const taskCheckpointSchema = z
+    .object({
+    key: z.string().trim().min(1).max(80),
+    label: z.string().trim().min(1).max(200),
+    status: z.enum(['PENDING', 'COMPLETED', 'BLOCKED']),
+    evidence: z.string().trim().min(1).max(500).optional(),
+})
+    .strict();
+const taskPendingOperationSchema = z
+    .object({
+    operation: z.string().trim().min(1).max(120),
+    object_ref: taskObjectRefSchema.optional(),
+    idempotency_key: z.string().trim().min(1).max(200).optional(),
+    verify_with: z.string().trim().min(1).max(120).optional(),
+    status: z.enum(['PLANNED', 'AWAITING_USER', 'OUTCOME_UNKNOWN']),
+})
+    .strict();
+const taskPayloadShape = {
+    goal: z.string().trim().min(3).max(500),
+    context: z.string().trim().min(1).max(2000).optional(),
+    constraints: z.array(z.string().trim().min(1).max(500)).max(20).default([]),
+    object_refs: z.array(taskObjectRefSchema).max(100).default([]),
+    checkpoints: z.array(taskCheckpointSchema).max(100).default([]),
+    pending_operations: z.array(taskPendingOperationSchema).max(50).default([]),
+    expected_user_action: z.string().trim().min(1).max(1000).nullable().optional(),
+};
+const optionalTaskPayloadShape = {
+    goal: taskPayloadShape.goal.optional(),
+    context: taskPayloadShape.context,
+    constraints: taskPayloadShape.constraints.optional(),
+    object_refs: taskPayloadShape.object_refs.optional(),
+    checkpoints: taskPayloadShape.checkpoints.optional(),
+    pending_operations: taskPayloadShape.pending_operations.optional(),
+    expected_user_action: taskPayloadShape.expected_user_action,
+};
+export const taskStateTools = [
+    defineTool({
+        name: 'besales_task_create',
+        sideEffect: 'write',
+        reversible: true,
+        closedWorld: true,
+        requiredFields: ['goal'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            ...taskPayloadShape,
+            retention_days: z.number().int().min(1).max(180).optional(),
+        })
+            .strict(),
+        localHandler: async (input, ctx) => {
+            assertNoCredentialLikeValue(input);
+            const workspaceId = await resolveTaskWorkspace(input.workspace_id, ctx);
+            const task = await storeFor(ctx).create(workspaceId, payloadFromInput(input), input.retention_days);
+            return withResumeInstructions(task);
+        },
+    }),
+    defineTool({
+        name: 'besales_task_list',
+        sideEffect: 'none',
+        closedWorld: true,
+        requiredFields: [],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            status: z.enum(TASK_STATUSES).optional(),
+        })
+            .strict(),
+        localHandler: async (input, ctx) => {
+            const workspaceId = await resolveTaskWorkspace(input.workspace_id, ctx);
+            const tasks = await storeFor(ctx).list(workspaceId, input.status);
+            return {
+                workspace_id: workspaceId,
+                tasks: tasks.map(taskSummary),
+                selection_required: tasks.length > 1,
+                next: tasks.length === 0
+                    ? 'Создайте задачу через besales_task_create.'
+                    : 'Выберите task_id явно и вызовите besales_task_get. Задача не выбирается по давности автоматически.',
+            };
+        },
+    }),
+    defineTool({
+        name: 'besales_task_get',
+        sideEffect: 'none',
+        closedWorld: true,
+        requiredFields: ['task_id'],
+        schema: z.object({ workspace_id: uuidSchema.optional(), task_id: uuidSchema }).strict(),
+        localHandler: async (input, ctx) => {
+            const workspaceId = await resolveTaskWorkspace(input.workspace_id, ctx);
+            return withResumeInstructions(await storeFor(ctx).get(workspaceId, input.task_id));
+        },
+    }),
+    defineTool({
+        name: 'besales_task_update',
+        sideEffect: 'write',
+        reversible: true,
+        closedWorld: true,
+        requiredFields: ['task_id', 'expected_version'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            task_id: uuidSchema,
+            expected_version: z.number().int().min(1),
+            ...optionalTaskPayloadShape,
+        })
+            .strict()
+            .refine((input) => Object.keys(optionalTaskPayloadShape).some((field) => input[field] !== undefined), { message: 'At least one task field must be updated.' }),
+        localHandler: async (input, ctx) => {
+            assertNoCredentialLikeValue(input);
+            const workspaceId = await resolveTaskWorkspace(input.workspace_id, ctx);
+            const patch = payloadPatchFromInput(input);
+            return withResumeInstructions(await storeFor(ctx).update(workspaceId, input.task_id, input.expected_version, patch));
+        },
+    }),
+    defineTool({
+        name: 'besales_task_close',
+        sideEffect: 'write',
+        reversible: false,
+        closedWorld: true,
+        requiredFields: ['task_id', 'expected_version', 'outcome'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            task_id: uuidSchema,
+            expected_version: z.number().int().min(1),
+            outcome: z.enum(['COMPLETED', 'CANCELLED']),
+        })
+            .strict(),
+        localHandler: async (input, ctx) => {
+            const workspaceId = await resolveTaskWorkspace(input.workspace_id, ctx);
+            return toPublicTask(await storeFor(ctx).close(workspaceId, input.task_id, input.expected_version, input.outcome));
+        },
+    }),
+    defineTool({
+        name: 'besales_task_delete',
+        sideEffect: 'write',
+        reversible: false,
+        closedWorld: true,
+        requiredFields: ['task_id', 'expected_version', 'explicit_confirmation'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            task_id: uuidSchema,
+            expected_version: z.number().int().min(1),
+            explicit_confirmation: z.literal(true),
+        })
+            .strict(),
+        localHandler: async (input, ctx) => {
+            const workspaceId = await resolveTaskWorkspace(input.workspace_id, ctx);
+            await storeFor(ctx).delete(workspaceId, input.task_id, input.expected_version);
+            return { task_id: input.task_id, workspace_id: workspaceId, deleted: true };
+        },
+    }),
+];
+function storeFor(ctx) {
+    const configured = ctx.env.BESALES_MCP_TASK_STATE_PATH?.trim();
+    return new TaskStateStore({
+        filePath: configured || join(homedir(), '.besales-mcp', 'tasks-v1.json'),
+    });
+}
+async function resolveTaskWorkspace(explicitWorkspaceId, ctx) {
+    const connections = await ctx.store.list();
+    if (connections.length === 0) {
+        throw new WorkspaceResolutionError('Not connected to any workspace. Run `besales-mcp connect` before saving task state.');
+    }
+    const connected = (workspaceId) => connections.some((connection) => connection.workspaceId === workspaceId);
+    const envPin = ctx.env.BESALES_WORKSPACE_ID?.trim();
+    if (envPin) {
+        if (!connected(envPin)) {
+            throw new WorkspaceResolutionError(`Pinned workspace ${envPin} is not connected.`);
+        }
+        if (explicitWorkspaceId && explicitWorkspaceId !== envPin) {
+            throw new WorkspaceResolutionError(`This session is pinned to ${envPin}; cross-workspace task access is refused.`);
+        }
+        return envPin;
+    }
+    if (explicitWorkspaceId) {
+        if (!connected(explicitWorkspaceId)) {
+            throw new WorkspaceResolutionError(`Workspace ${explicitWorkspaceId} is not connected.`);
+        }
+        return explicitWorkspaceId;
+    }
+    const sessionWorkspaceId = getSessionWorkspaceId();
+    if (sessionWorkspaceId && connected(sessionWorkspaceId))
+        return sessionWorkspaceId;
+    if (connections.length === 1)
+        return connections[0].workspaceId;
+    throw new WorkspaceResolutionError('Multiple workspaces are connected. Use besales_workspace_use or pass workspace_id before selecting a task.');
+}
+function payloadFromInput(input) {
+    return {
+        goal: input.goal,
+        context: input.context,
+        constraints: input.constraints,
+        objectRefs: input.object_refs,
+        checkpoints: input.checkpoints,
+        pendingOperations: input.pending_operations.map((operation) => ({
+            operation: operation.operation,
+            objectRef: operation.object_ref,
+            idempotencyKey: operation.idempotency_key,
+            verifyWith: operation.verify_with,
+            status: operation.status,
+        })),
+        expectedUserAction: input.expected_user_action,
+    };
+}
+function payloadPatchFromInput(input) {
+    const patch = {};
+    if (typeof input.goal === 'string')
+        patch.goal = input.goal;
+    if (typeof input.context === 'string')
+        patch.context = input.context;
+    if (Array.isArray(input.constraints))
+        patch.constraints = input.constraints;
+    if (Array.isArray(input.object_refs)) {
+        patch.objectRefs = input.object_refs;
+    }
+    if (Array.isArray(input.checkpoints)) {
+        patch.checkpoints = input.checkpoints;
+    }
+    if (Array.isArray(input.pending_operations)) {
+        patch.pendingOperations = input.pending_operations.map((operation) => ({
+            operation: operation.operation,
+            objectRef: operation.object_ref,
+            idempotencyKey: operation.idempotency_key,
+            verifyWith: operation.verify_with,
+            status: operation.status,
+        }));
+    }
+    if (input.expected_user_action === null || typeof input.expected_user_action === 'string') {
+        patch.expectedUserAction = input.expected_user_action;
+    }
+    return patch;
+}
+function taskSummary(task) {
+    return {
+        task_id: task.taskId,
+        goal: task.goal,
+        status: task.status,
+        version: task.version,
+        updated_at: task.updatedAt,
+        expires_at: task.expiresAt,
+        expected_user_action: task.expectedUserAction ?? null,
+        pending_operation_count: task.pendingOperations.length,
+    };
+}
+function toPublicTask(task) {
+    return {
+        task_id: task.taskId,
+        workspace_id: task.workspaceId,
+        owner: task.owner,
+        status: task.status,
+        version: task.version,
+        goal: task.goal,
+        context: task.context ?? null,
+        constraints: task.constraints,
+        object_refs: task.objectRefs,
+        checkpoints: task.checkpoints,
+        pending_operations: task.pendingOperations.map((operation) => ({
+            operation: operation.operation,
+            object_ref: operation.objectRef,
+            idempotency_key: operation.idempotencyKey,
+            verify_with: operation.verifyWith,
+            status: operation.status,
+        })),
+        expected_user_action: task.expectedUserAction ?? null,
+        created_at: task.createdAt,
+        updated_at: task.updatedAt,
+        expires_at: task.expiresAt,
+    };
+}
+function withResumeInstructions(task) {
+    return {
+        ...toPublicTask(task),
+        resumable: task.status === 'ACTIVE',
+        resume_rule: task.status === 'ACTIVE'
+            ? 'Before any mutation, re-read the referenced objects and besales_workspace_current; saved state is context, not proof of current state or permissions.'
+            : 'This task cannot be resumed. Create a new task if more work is required.',
+    };
+}
+function assertNoCredentialLikeValue(value) {
+    const serialized = JSON.stringify(value);
+    const credentialPattern = /(?:sk-|mcp_|bsl_)[A-Za-z0-9._-]{12,}|Bearer\s+\S{12,}|(?:password|client_secret|api[_-]?key)\s*[:=]\s*\S{8,}/iu;
+    if (credentialPattern.test(serialized)) {
+        throw new Error('Task state refuses credential-like values. Keep secrets in the browser setup flow or keychain.');
+    }
+}
+//# sourceMappingURL=task-state.js.map

package/dist/tools/definitions/task-state.js.map

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

package/dist/tools/definitions/trigger-contact-claims.d.ts

@@ -0,0 +1,7 @@
+export declare const triggerContactClaimTools: (import("./shared.js").ToolDefinition<{
+    chat_user_id: string;
+}> | import("./shared.js").ToolDefinition<{
+    chat_user_id: string;
+    trigger_id: string;
+    explicit_confirmation: true;
+}>)[];

package/dist/tools/definitions/trigger-contact-claims.js

@@ -0,0 +1,60 @@
+// Права одноразовых триггеров. Триггер с «Сработать один раз на контакт» после первого
+// срабатывания исчезает из беседы НАВСЕГДА: право берётся атомарной вставкой и сжигается, как
+// только хоть одно действие отработало во внешней системе. Вернуть его до появления этих
+// инструментов можно было только запросом в БД руками.
+import { z } from 'zod';
+import { defineTool, setupConfirmation, uuidSchema, withInstructions } from './shared.js';
+export const triggerContactClaimTools = [
+    defineTool({
+        name: 'besales_trigger_claim_list',
+        sideEffect: 'none',
+        requiredFields: ['chat_user_id'],
+        schema: z
+            .object({
+            chat_user_id: uuidSchema,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/contacts/${input.chat_user_id}/trigger-claims`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Пустой список — норма: у большинства контактов одноразовых триггеров нет вовсе.',
+            'status=COMPLETED — триггер отработал и право сожжено. status=IN_PROGRESS — право взято прогоном.',
+            'canReset=false у ЛЮБОГО IN_PROGRESS: право держит владелец, и снять его нельзя ни в каком возрасте — закрытие права в оркестраторе адресует пару «триггер+контакт», поэтому удаление такой строки дало бы двух владельцев разом.',
+            'Право, зависшее в IN_PROGRESS надолго (владелец умер, не закрыв его), этим инструментом НЕ лечится: нужен разработчик. Возраст видно по claimedAt.',
+            'Единица — КАНАЛ (ChatUser), а не человек: один клиент в Telegram и WhatsApp имеет два независимых права.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_trigger_claim_reset',
+        sideEffect: 'write',
+        requiredFields: ['chat_user_id', 'trigger_id', 'explicit_confirmation'],
+        schema: z
+            .object({
+            chat_user_id: uuidSchema,
+            trigger_id: uuidSchema,
+            // Снятие права разрешает триггеру ПОВТОРИТЬ необратимые действия во внешних системах
+            // (вторая заметка в CRM, вторая передача оператору) — ровно то, ради чего оператор
+            // включал «один раз». `literal(true)` + `requiredFields`, как у `besales_trigger_delete`:
+            // необязательное поле модель просто опустит и получит отказ уже после вызова.
+            explicit_confirmation: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/contacts/${input.chat_user_id}/trigger-claims/${input.trigger_id}`,
+            // Тело у DELETE — тот же канон, что у `besales_trigger_delete`: подтверждение обязано
+            // доехать до сервера, иначе гейт защищает ровно одного клиента.
+            body: setupConfirmation(input),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Право возвращено: триггер сможет сработать на этом контакте ещё раз и повторить свои действия.',
+            '409 означает, что право держит прогон триггера (status=IN_PROGRESS) — снять его можно только после завершения прогона, это не сбой.',
+            'Брошенное IN_PROGRESS (владелец умер, не закрыв право) этой ручкой НЕ снимается: закрытие права в оркестраторе адресует пару «триггер+контакт», и удаление такой строки дало бы два владельца разом.',
+            '404 означает, что права нет: либо триггер уже разрешён, либо он никогда не срабатывал на этом контакте.',
+            'Снятие НЕ выключает саму настройку «Сработать один раз на контакт» — после следующего срабатывания право сожжётся снова.',
+        ]),
+    }),
+];
+//# sourceMappingURL=trigger-contact-claims.js.map

package/dist/tools/definitions/trigger-contact-claims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-contact-claims.js","sourceRoot":"","sources":["../../../src/tools/definitions/trigger-contact-claims.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,8FAA8F;AAC9F,yFAAyF;AACzF,uDAAuD;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE1F,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU,CAAC;QACT,IAAI,EAAE,4BAA4B;QAClC,UAAU,EAAE,MAAM;QAClB,cAAc,EAAE,CAAC,cAAc,CAAC;QAChC,MAAM,EAAE,CAAC;aACN,MAAM,CAAC;YACN,YAAY,EAAE,UAAU;SACzB,CAAC;aACD,MAAM,EAAE;QACX,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACzB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa,KAAK,CAAC,YAAY,iBAAiB;SACvD,CAAC;QACF,eAAe,EAAE,CAAC,QAAQ,EAAE,EAAE,CAC5B,gBAAgB,CAAC,QAAQ,EAAE;YACzB,iFAAiF;YACjF,kGAAkG;YAClG,kOAAkO;YAClO,oJAAoJ;YACpJ,0GAA0G;SAC3G,CAAC;KACL,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,6BAA6B;QACnC,UAAU,EAAE,OAAO;QACnB,cAAc,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,uBAAuB,CAAC;QACvE,MAAM,EAAE,CAAC;aACN,MAAM,CAAC;YACN,YAAY,EAAE,UAAU;YACxB,UAAU,EAAE,UAAU;YACtB,qFAAqF;YACrF,mFAAmF;YACnF,0FAA0F;YAC1F,8EAA8E;YAC9E,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;SACvC,CAAC;aACD,MAAM,EAAE;QACX,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACzB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,aAAa,KAAK,CAAC,YAAY,mBAAmB,KAAK,CAAC,UAAU,EAAE;YAC1E,sFAAsF;YACtF,gEAAgE;YAChE,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC;SAC/B,CAAC;QACF,eAAe,EAAE,CAAC,QAAQ,EAAE,EAAE,CAC5B,gBAAgB,CAAC,QAAQ,EAAE;YACzB,gGAAgG;YAChG,qIAAqI;YACrI,sMAAsM;YACtM,yGAAyG;YACzG,0HAA0H;SAC3H,CAAC;KACL,CAAC;CACH,CAAC"}