@besales/mcp 0.46.0 → 0.47.0

package/dist/server.d.ts

@@ -1,12 +1,14 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { type CallToolResult, type ListResourcesResult, type ListToolsResult, type ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import { type RegisteredPrompt } from './prompts/registry.js';
 import { type RegisteredResource } from './resources/registry.js';
 import { type RegisteredTool } from './tools/registry.js';
 export interface StartMcpServerOptions {
     readonly stdio?: boolean;
     readonly tools?: readonly RegisteredTool[];
     readonly resources?: readonly RegisteredResource[];
+    readonly prompts?: readonly RegisteredPrompt[];
 }
 export interface StartedMcpServer {
     readonly server: Server;

package/dist/server.js

@@ -1,14 +1,16 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ErrorCode, ListResourcesRequestSchema, ListToolsRequestSchema, McpError, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { CallToolRequestSchema, ErrorCode, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, McpError, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { SERVER_INSTRUCTIONS } from './instructions/server-instructions.js';
 import { readPackageVersion } from './package-metadata.js';
+import { getRegisteredPrompt, listRegisteredPrompts, prompts, } from './prompts/registry.js';
 import { resources } from './resources/registry.js';
 import { tools } from './tools/registry.js';
 export function listRegisteredTools(registeredTools = tools) {
     return {
-        tools: registeredTools.map(({ name, description, inputSchema, outputSchema, annotations }) => ({
+        tools: registeredTools.map(({ name, title, description, inputSchema, outputSchema, annotations }) => ({
             name,
+            title,
             description,
             inputSchema,
             outputSchema,
@@ -48,6 +50,7 @@ export async function readRegisteredResource(uri, registeredResources = resource
 export function createMcpServer(options = {}) {
     const registeredTools = options.tools ?? tools;
     const registeredResources = options.resources ?? resources;
+    const registeredPrompts = options.prompts ?? prompts;
     const server = new Server({
         name: '@besales/mcp',
         version: readPackageVersion(),
@@ -56,12 +59,15 @@ export function createMcpServer(options = {}) {
         capabilities: {
             tools: {},
             resources: {},
+            prompts: {},
         },
     });
     server.setRequestHandler(ListToolsRequestSchema, async () => listRegisteredTools(registeredTools));
     server.setRequestHandler(CallToolRequestSchema, async (request) => callRegisteredTool(request.params.name, request.params.arguments ?? {}, registeredTools));
     server.setRequestHandler(ListResourcesRequestSchema, async () => listRegisteredResources(registeredResources));
     server.setRequestHandler(ReadResourceRequestSchema, async (request) => readRegisteredResource(request.params.uri, registeredResources));
+    server.setRequestHandler(ListPromptsRequestSchema, async () => listRegisteredPrompts(registeredPrompts));
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => getRegisteredPrompt(request.params.name, request.params.arguments ?? {}, registeredPrompts));
     return server;
 }
 export async function startMcpServer(options = {}) {

package/dist/server.js.map

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

package/dist/tasks/task-state-store.d.ts

@@ -0,0 +1,68 @@
+export declare const TASK_STATUSES: readonly ["ACTIVE", "COMPLETED", "CANCELLED", "EXPIRED"];
+export type TaskStatus = (typeof TASK_STATUSES)[number];
+export interface TaskObjectRef {
+    readonly type: string;
+    readonly id: string;
+    readonly label?: string;
+}
+export interface TaskCheckpoint {
+    readonly key: string;
+    readonly label: string;
+    readonly status: 'PENDING' | 'COMPLETED' | 'BLOCKED';
+    readonly evidence?: string;
+}
+export interface TaskPendingOperation {
+    readonly operation: string;
+    readonly objectRef?: TaskObjectRef;
+    readonly idempotencyKey?: string;
+    readonly verifyWith?: string;
+    readonly status: 'PLANNED' | 'AWAITING_USER' | 'OUTCOME_UNKNOWN';
+}
+export interface TaskPayload {
+    readonly goal: string;
+    readonly context?: string;
+    readonly constraints: readonly string[];
+    readonly objectRefs: readonly TaskObjectRef[];
+    readonly checkpoints: readonly TaskCheckpoint[];
+    readonly pendingOperations: readonly TaskPendingOperation[];
+    readonly expectedUserAction?: string | null;
+}
+export interface StoredTask extends TaskPayload {
+    readonly taskId: string;
+    readonly workspaceId: string;
+    readonly owner: 'local_os_account';
+    readonly status: Exclude<TaskStatus, 'EXPIRED'>;
+    readonly version: number;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly expiresAt: string;
+}
+export interface TaskView extends Omit<StoredTask, 'status'> {
+    readonly status: TaskStatus;
+}
+export interface TaskStateStoreOptions {
+    readonly filePath?: string;
+    readonly now?: () => Date;
+}
+export declare class TaskVersionConflictError extends Error {
+    constructor(expected: number, actual: number);
+}
+export declare class TaskStateStore {
+    private readonly filePath;
+    private readonly lockPath;
+    private readonly now;
+    constructor(options?: TaskStateStoreOptions);
+    create(workspaceId: string, payload: TaskPayload, retentionDays?: number): Promise<TaskView>;
+    list(workspaceId: string, status?: TaskStatus): Promise<readonly TaskView[]>;
+    get(workspaceId: string, taskId: string): Promise<TaskView>;
+    update(workspaceId: string, taskId: string, expectedVersion: number, patch: Partial<TaskPayload>): Promise<TaskView>;
+    close(workspaceId: string, taskId: string, expectedVersion: number, status: 'COMPLETED' | 'CANCELLED'): Promise<TaskView>;
+    delete(workspaceId: string, taskId: string, expectedVersion: number): Promise<void>;
+    private assertMutable;
+    private requireIndex;
+    private view;
+    private readDocument;
+    private writeDocument;
+    private withLock;
+    private isStaleLock;
+}

package/dist/tasks/task-state-store.js

@@ -0,0 +1,278 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, open, readFile, rename, rm, stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+const TASK_DOCUMENT_SCHEMA_VERSION = 1;
+const DEFAULT_RETENTION_DAYS = 30;
+const MAX_RETENTION_DAYS = 180;
+const LOCK_RETRY_MS = 25;
+const LOCK_ATTEMPTS = 80;
+const STALE_LOCK_MS = 10_000;
+export const TASK_STATUSES = ['ACTIVE', 'COMPLETED', 'CANCELLED', 'EXPIRED'];
+export class TaskVersionConflictError extends Error {
+    constructor(expected, actual) {
+        super(`TASK_VERSION_CONFLICT: expected version ${expected}, actual version ${actual}. ` +
+            'Read the task again, reconcile the fresh state, then retry with its version.');
+        this.name = 'TaskVersionConflictError';
+    }
+}
+export class TaskStateStore {
+    filePath;
+    lockPath;
+    now;
+    constructor(options = {}) {
+        this.filePath = options.filePath ?? join(homedir(), '.besales-mcp', 'tasks-v1.json');
+        this.lockPath = `${this.filePath}.lock`;
+        this.now = options.now ?? (() => new Date());
+    }
+    async create(workspaceId, payload, retentionDays = DEFAULT_RETENTION_DAYS) {
+        if (retentionDays < 1 || retentionDays > MAX_RETENTION_DAYS) {
+            throw new Error(`retention_days must be between 1 and ${MAX_RETENTION_DAYS}.`);
+        }
+        return this.withLock(async () => {
+            const document = await this.readDocument();
+            const now = this.now();
+            const task = {
+                taskId: randomUUID(),
+                workspaceId,
+                owner: 'local_os_account',
+                status: 'ACTIVE',
+                version: 1,
+                createdAt: now.toISOString(),
+                updatedAt: now.toISOString(),
+                expiresAt: new Date(now.getTime() + retentionDays * 24 * 60 * 60 * 1000).toISOString(),
+                ...payload,
+            };
+            await this.writeDocument({ ...document, tasks: [...document.tasks, task] });
+            return this.view(task);
+        });
+    }
+    async list(workspaceId, status) {
+        const document = await this.readDocument();
+        return document.tasks
+            .filter((task) => task.workspaceId === workspaceId)
+            .map((task) => this.view(task))
+            .filter((task) => status === undefined || task.status === status)
+            .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+    }
+    async get(workspaceId, taskId) {
+        const task = (await this.readDocument()).tasks.find((candidate) => candidate.workspaceId === workspaceId && candidate.taskId === taskId);
+        if (!task)
+            throw new Error(`Task ${taskId} was not found in the selected workspace.`);
+        return this.view(task);
+    }
+    async update(workspaceId, taskId, expectedVersion, patch) {
+        return this.withLock(async () => {
+            const document = await this.readDocument();
+            const index = this.requireIndex(document, workspaceId, taskId);
+            const current = document.tasks[index];
+            this.assertMutable(current, expectedVersion);
+            const updated = {
+                ...current,
+                ...patch,
+                version: current.version + 1,
+                updatedAt: this.now().toISOString(),
+            };
+            const tasks = [...document.tasks];
+            tasks[index] = updated;
+            await this.writeDocument({ ...document, tasks });
+            return this.view(updated);
+        });
+    }
+    async close(workspaceId, taskId, expectedVersion, status) {
+        return this.withLock(async () => {
+            const document = await this.readDocument();
+            const index = this.requireIndex(document, workspaceId, taskId);
+            const current = document.tasks[index];
+            this.assertMutable(current, expectedVersion);
+            const updated = {
+                ...current,
+                status,
+                version: current.version + 1,
+                updatedAt: this.now().toISOString(),
+            };
+            const tasks = [...document.tasks];
+            tasks[index] = updated;
+            await this.writeDocument({ ...document, tasks });
+            return this.view(updated);
+        });
+    }
+    async delete(workspaceId, taskId, expectedVersion) {
+        return this.withLock(async () => {
+            const document = await this.readDocument();
+            const index = this.requireIndex(document, workspaceId, taskId);
+            const current = document.tasks[index];
+            if (current.version !== expectedVersion) {
+                throw new TaskVersionConflictError(expectedVersion, current.version);
+            }
+            await this.writeDocument({
+                ...document,
+                tasks: document.tasks.filter((_, taskIndex) => taskIndex !== index),
+            });
+        });
+    }
+    assertMutable(task, expectedVersion) {
+        if (task.version !== expectedVersion) {
+            throw new TaskVersionConflictError(expectedVersion, task.version);
+        }
+        const status = this.view(task).status;
+        if (status !== 'ACTIVE') {
+            throw new Error(`Task ${task.taskId} is ${status} and cannot be changed or resumed.`);
+        }
+    }
+    requireIndex(document, workspaceId, taskId) {
+        const index = document.tasks.findIndex((task) => task.workspaceId === workspaceId && task.taskId === taskId);
+        if (index < 0)
+            throw new Error(`Task ${taskId} was not found in the selected workspace.`);
+        return index;
+    }
+    view(task) {
+        return {
+            ...task,
+            status: Date.parse(task.expiresAt) <= this.now().getTime() ? 'EXPIRED' : task.status,
+        };
+    }
+    async readDocument() {
+        let raw;
+        try {
+            raw = await readFile(this.filePath, 'utf8');
+        }
+        catch (error) {
+            if (isNodeError(error, 'ENOENT')) {
+                return { schemaVersion: TASK_DOCUMENT_SCHEMA_VERSION, tasks: [] };
+            }
+            throw error;
+        }
+        const parsed = JSON.parse(raw);
+        if (!isTaskDocument(parsed)) {
+            throw new Error(`Task state at ${this.filePath} is invalid. It was left untouched; restore or remove it explicitly.`);
+        }
+        return parsed;
+    }
+    async writeDocument(document) {
+        await mkdir(dirname(this.filePath), { recursive: true, mode: 0o700 });
+        const temporaryPath = `${this.filePath}.${process.pid}.${randomUUID()}.tmp`;
+        try {
+            const handle = await open(temporaryPath, 'wx', 0o600);
+            try {
+                await handle.writeFile(`${JSON.stringify(document, null, 2)}\n`, 'utf8');
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            await rename(temporaryPath, this.filePath);
+        }
+        catch (error) {
+            await rm(temporaryPath, { force: true });
+            throw error;
+        }
+    }
+    async withLock(operation) {
+        await mkdir(dirname(this.filePath), { recursive: true, mode: 0o700 });
+        for (let attempt = 0; attempt < LOCK_ATTEMPTS; attempt += 1) {
+            try {
+                await mkdir(this.lockPath, { mode: 0o700 });
+                try {
+                    return await operation();
+                }
+                finally {
+                    await rm(this.lockPath, { recursive: true, force: true });
+                }
+            }
+            catch (error) {
+                if (!isNodeError(error, 'EEXIST'))
+                    throw error;
+                if (await this.isStaleLock()) {
+                    await rm(this.lockPath, { recursive: true, force: true });
+                    continue;
+                }
+                await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_MS));
+            }
+        }
+        throw new Error('Task state is busy. Retry the read or update after the other MCP session finishes.');
+    }
+    async isStaleLock() {
+        try {
+            const lock = await stat(this.lockPath);
+            return this.now().getTime() - lock.mtimeMs > STALE_LOCK_MS;
+        }
+        catch (error) {
+            if (isNodeError(error, 'ENOENT'))
+                return false;
+            throw error;
+        }
+    }
+}
+function isTaskDocument(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const document = value;
+    return (document.schemaVersion === TASK_DOCUMENT_SCHEMA_VERSION &&
+        Array.isArray(document.tasks) &&
+        document.tasks.every(isStoredTask));
+}
+function isStoredTask(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const task = value;
+    return (typeof task.taskId === 'string' &&
+        typeof task.workspaceId === 'string' &&
+        task.owner === 'local_os_account' &&
+        ['ACTIVE', 'COMPLETED', 'CANCELLED'].includes(String(task.status)) &&
+        Number.isInteger(task.version) &&
+        Number(task.version) >= 1 &&
+        isNonEmptyString(task.goal) &&
+        (task.context === undefined || isNonEmptyString(task.context)) &&
+        isIsoDate(task.createdAt) &&
+        isIsoDate(task.updatedAt) &&
+        isIsoDate(task.expiresAt) &&
+        Array.isArray(task.constraints) &&
+        task.constraints.every(isNonEmptyString) &&
+        Array.isArray(task.objectRefs) &&
+        task.objectRefs.every(isTaskObjectRef) &&
+        Array.isArray(task.checkpoints) &&
+        task.checkpoints.every(isTaskCheckpoint) &&
+        Array.isArray(task.pendingOperations) &&
+        task.pendingOperations.every(isTaskPendingOperation) &&
+        (task.expectedUserAction === undefined ||
+            task.expectedUserAction === null ||
+            isNonEmptyString(task.expectedUserAction)));
+}
+function isTaskObjectRef(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const ref = value;
+    return (isNonEmptyString(ref.type) &&
+        isNonEmptyString(ref.id) &&
+        (ref.label === undefined || isNonEmptyString(ref.label)));
+}
+function isTaskCheckpoint(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const checkpoint = value;
+    return (isNonEmptyString(checkpoint.key) &&
+        isNonEmptyString(checkpoint.label) &&
+        ['PENDING', 'COMPLETED', 'BLOCKED'].includes(String(checkpoint.status)) &&
+        (checkpoint.evidence === undefined || isNonEmptyString(checkpoint.evidence)));
+}
+function isTaskPendingOperation(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const operation = value;
+    return (isNonEmptyString(operation.operation) &&
+        (operation.objectRef === undefined || isTaskObjectRef(operation.objectRef)) &&
+        (operation.idempotencyKey === undefined || isNonEmptyString(operation.idempotencyKey)) &&
+        (operation.verifyWith === undefined || isNonEmptyString(operation.verifyWith)) &&
+        ['PLANNED', 'AWAITING_USER', 'OUTCOME_UNKNOWN'].includes(String(operation.status)));
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function isIsoDate(value) {
+    return typeof value === 'string' && Number.isFinite(Date.parse(value));
+}
+function isNodeError(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+//# sourceMappingURL=task-state-store.js.map

package/dist/tasks/task-state-store.js.map

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

package/dist/tools/annotations.d.ts

@@ -0,0 +1,7 @@
+import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolDefinition } from './definitions/shared.js';
+/**
+ * Умолчания — ХУДШИЙ случай, а не «неизвестно»: ошибочное «только чтение» опаснее пропущенной
+ * аннотации, потому что снимает подтверждение там, где оно нужно.
+ */
+export declare function toolAnnotations(definition: ToolDefinition<unknown>): ToolAnnotations;

package/dist/tools/annotations.js

@@ -0,0 +1,16 @@
+/**
+ * Умолчания — ХУДШИЙ случай, а не «неизвестно»: ошибочное «только чтение» опаснее пропущенной
+ * аннотации, потому что снимает подтверждение там, где оно нужно.
+ */
+export function toolAnnotations(definition) {
+    const readOnly = definition.sideEffect === 'none';
+    return {
+        readOnlyHint: readOnly,
+        // У читающего разрушительность бессмысленна; у пишущего она подразумевается истинной
+        // спецификацией MCP, и снять её можно только доказанной обратимостью.
+        destructiveHint: readOnly ? false : definition.reversible !== true,
+        idempotentHint: definition.idempotent === true,
+        openWorldHint: definition.closedWorld !== true,
+    };
+}
+//# sourceMappingURL=annotations.js.map

package/dist/tools/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/tools/annotations.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,UAAmC;IACjE,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,KAAK,MAAM,CAAC;IAElD,OAAO;QACL,YAAY,EAAE,QAAQ;QACtB,qFAAqF;QACrF,sEAAsE;QACtE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,KAAK,IAAI;QAClE,cAAc,EAAE,UAAU,CAAC,UAAU,KAAK,IAAI;QAC9C,aAAa,EAAE,UAAU,CAAC,WAAW,KAAK,IAAI;KAC/C,CAAC;AACJ,CAAC"}

package/dist/tools/contracts.js

@@ -1,11 +1,17 @@
 import { readFileSync } from 'node:fs';
+import { localizeToolContract } from './description-localization.js';
 let cachedContract = null;
 export function getMcpToolsContract() {
     if (cachedContract) {
         return cachedContract;
     }
     const contractUrl = new URL('../schemas/mcp-tools.json', import.meta.url);
-    cachedContract = JSON.parse(readFileSync(contractUrl, 'utf-8'));
+    const parsed = JSON.parse(readFileSync(contractUrl, 'utf-8'));
+    cachedContract = {
+        ...parsed,
+        tools: parsed.tools.map(localizeToolContract),
+        deferred_phase4_setup_tools: parsed.deferred_phase4_setup_tools?.map(localizeToolContract),
+    };
     return cachedContract;
 }
 export function getActiveToolContracts() {

package/dist/tools/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/tools/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAuBvC,IAAI,cAAc,GAA4B,IAAI,CAAC;AAEnD,MAAM,UAAU,mBAAmB;IACjC,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1E,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAqB,CAAC;IACpF,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,mBAAmB,EAAE,CAAC,KAAK,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,mBAAmB,EAAE,CAAC,SAAS,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAE7E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/tools/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAqBrE,IAAI,cAAc,GAA4B,IAAI,CAAC;AAEnD,MAAM,UAAU,mBAAmB;IACjC,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAqB,CAAC;IAClF,cAAc,GAAG;QACf,GAAG,MAAM;QACT,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAC7C,2BAA2B,EAAE,MAAM,CAAC,2BAA2B,EAAE,GAAG,CAAC,oBAAoB,CAAC;KAC3F,CAAC;IACF,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,mBAAmB,EAAE,CAAC,KAAK,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,mBAAmB,EAAE,CAAC,SAAS,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAE7E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/definitions/agent-design.d.ts

@@ -28,6 +28,9 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
     operation_id: string;
     icp_profile_id: string;
     segments: {
+        language_style: {
+            [x: string]: unknown;
+        } | undefined;
         name: string;
         id?: string | undefined;
         description?: string | undefined;
@@ -36,22 +39,19 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
         } | undefined;
         pains?: unknown[] | undefined;
         motivations?: unknown[] | undefined;
-        language_style?: {
-            [x: string]: unknown;
-        } | undefined;
     }[];
     personas: {
+        segment_id: string | undefined;
+        pain_points: unknown[] | undefined;
+        messaging_hints: {
+            [x: string]: unknown;
+        } | undefined;
         name: string;
-        segment_id: string;
         description?: string | undefined;
-        pain_points?: unknown[] | undefined;
         goals?: unknown[] | undefined;
         objections?: {
             [x: string]: unknown;
         } | undefined;
-        messaging_hints?: {
-            [x: string]: unknown;
-        } | undefined;
     }[];
     workspace_id?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
@@ -75,6 +75,7 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
         message_direction?: "INBOUND" | "OUTBOUND" | undefined;
     } | undefined;
 }> | import("./shared.js").ToolDefinition<{
+    final_content: string | undefined;
     agent_id: string;
     operation_id: string;
     stages: {
@@ -83,7 +84,6 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
             [x: string]: unknown;
         };
     }[];
-    final_content: string;
     metadata?: {
         total_tokens?: number | undefined;
         models?: Record<string, string> | undefined;
@@ -93,6 +93,9 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
     version_id: string;
     modes: ("grammar" | "industry" | "structure" | "completeness" | "contradictions")[];
 }> | import("./shared.js").ToolDefinition<{
+    aggregated_issues: {
+        [x: string]: unknown;
+    }[] | undefined;
     agent_id: string;
     operation_id: string;
     stages: {
@@ -101,15 +104,13 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
             [x: string]: unknown;
         };
     }[];
-    aggregated_issues: {
-        [x: string]: unknown;
-    }[];
 }> | import("./shared.js").ToolDefinition<{
     agent_id: string;
     draft_version_id: string;
     changelog_note?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
     agent_id: string;
+    candidate_prompt?: string | undefined;
     scenario_ids?: string[] | undefined;
     options?: {
         mode: "single_agent" | "workflow";
@@ -123,6 +124,19 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
             max_turns?: number | undefined;
         } | undefined;
     } | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    agent_id: string;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    run_id: string;
+    reviewed_issues: {
+        scenario_id?: string | undefined;
+        turn_index?: number | undefined;
+        category?: "other" | "hallucination" | "wrong_action" | "bad_tone" | "missed_context" | undefined;
+        description?: string | undefined;
+    }[];
+    general_comments?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
     agent_id: string;
     run_id: string;
@@ -131,12 +145,17 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
     run_id: string;
     operation_id: string;
     findings: {
-        category: "other" | "hallucination" | "wrong_action" | "bad_tone" | "wrong_routing" | "missed_trigger" | "wrong_pipeline_transition" | "rag_miss";
-        severity: "low" | "medium" | "critical";
-        message: string;
+        category: "other" | "hallucination" | "wrong_action" | "bad_tone" | "missed_context" | "wrong_routing" | "rag_miss";
+        severity: "critical" | "low" | "medium";
         scenario_id?: string | undefined;
+        scenarioId?: string | undefined;
+        description?: string | undefined;
+        message?: string | undefined;
+        evidence?: string | undefined;
+        recommendation?: string | undefined;
         suggestion?: string | undefined;
         turn_index?: number | undefined;
+        turnIndex?: number | undefined;
     }[];
 }> | import("./shared.js").ToolDefinition<{
     agent_id: string;
@@ -146,11 +165,13 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
     operation_id: string;
     findings: {
         category: "other" | "hallucination" | "wrong_action" | "bad_tone" | "missed_context" | "contradiction" | "off_topic";
-        severity: "low" | "medium" | "critical";
+        severity: "critical" | "low" | "medium";
         message: string;
         dialogue_id?: string | undefined;
+        dialogueId?: string | undefined;
         suggestion?: string | undefined;
         reference_message_index?: number | undefined;
+        referenceMessageIndex?: number | undefined;
     }[];
     simulation_id?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
@@ -160,14 +181,14 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
     company_context?: string | undefined;
     icp_profile_id?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
-    agent_id: string;
-    operation_id: string;
+    knowledge_space_id: string | undefined;
     qa_pairs: {
         question: string;
         answer: string;
         tags?: string[] | undefined;
-    }[];
-    knowledge_space_id?: string | undefined;
+    }[] | undefined;
+    agent_id: string;
+    operation_id: string;
 }> | import("./shared.js").ToolDefinition<{
     icp_profile_id: string;
     count: number;