@besales/mcp 0.48.0 → 1.0.0-beta.2

package/dist/network/failed-verifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failed-verifications.js","sourceRoot":"","sources":["../../src/network/failed-verifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAE/G,kFAAkF;AAClF,MAAM,OAAO,mBAAmB;IACb,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhD,UAAU,CAAC,WAAmB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QAC9C,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;QACtC,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,uBAAuB,CAAC,CAAC;IAChE,CAAC;IAED,QAAQ,CAAC,WAAmB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QAC5C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,wBAAwB,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,GAAG,0BAA0B,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,WAAmB,IAAU,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvF,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACpB,KAAK,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,IAAI,GAAG,IAAI,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,KAAK,KAAW,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;CACxC"}

package/dist/network/http-test-fixture.d.ts

@@ -0,0 +1,3 @@
+import { type Server } from 'node:http';
+/** Дополнительный тестовый адаптер: настоящие SDK и HTTP-обработчик без listen в песочнице. */
+export declare function inProcessFetch(server: Server): typeof fetch;

package/dist/network/http-test-fixture.js

@@ -0,0 +1,86 @@
+import { IncomingMessage } from 'node:http';
+import { Socket } from 'node:net';
+import { Writable } from 'node:stream';
+/** Дополнительный тестовый адаптер: настоящие SDK и HTTP-обработчик без listen в песочнице. */
+export function inProcessFetch(server) {
+    return async (input, init) => {
+        const target = new Request(input, init);
+        const body = target.body ? Buffer.from(await target.arrayBuffer()) : undefined;
+        return new Promise((resolve, reject) => {
+            const incoming = new IncomingMessage(new Socket());
+            incoming.method = target.method;
+            incoming.url = new URL(target.url).pathname;
+            incoming.headers = Object.fromEntries(target.headers);
+            incoming.headers.host = new URL(target.url).host;
+            incoming.rawHeaders = Object.entries(incoming.headers).flatMap(([key, value]) => [key, String(value)]);
+            incoming.httpVersion = '1.1';
+            let controller;
+            let ended = false;
+            let published = false;
+            const stream = new ReadableStream({
+                start(value) { controller = value; },
+                cancel() { outgoing.destroy(); },
+            });
+            const headers = new Headers();
+            const publish = () => {
+                if (published)
+                    return;
+                published = true;
+                resolve(new Response(outgoing.statusCode === 204 ? null : stream, {
+                    status: outgoing.statusCode, headers,
+                }));
+            };
+            const outgoing = Object.assign(new Writable({
+                write(chunk, _encoding, callback) {
+                    publish();
+                    if (!ended)
+                        controller.enqueue(new Uint8Array(chunk));
+                    callback();
+                },
+                final(callback) {
+                    publish();
+                    if (!ended)
+                        controller.close();
+                    ended = true;
+                    callback();
+                },
+            }), {
+                statusCode: 200,
+                headersSent: false,
+                setHeader(name, value) { headers.set(name, String(value)); },
+                getHeader(name) { return headers.get(name); },
+                writeHead(status, values) {
+                    outgoing.statusCode = status;
+                    for (const [name, value] of Object.entries(values ?? {}))
+                        headers.set(name, String(value));
+                    outgoing.headersSent = true;
+                    publish();
+                    return outgoing;
+                },
+                flushHeaders: publish,
+            });
+            const abort = () => {
+                outgoing.destroy();
+                if (!ended)
+                    controller.error(new Error('HTTP test connection closed'));
+                ended = true;
+                if (!published)
+                    reject(new Error('HTTP test connection closed'));
+            };
+            outgoing.on('error', reject);
+            outgoing.on('close', () => target.signal.removeEventListener('abort', abort));
+            target.signal.addEventListener('abort', abort, { once: true });
+            if (target.signal.aborted) {
+                abort();
+                return;
+            }
+            server.emit('request', incoming, outgoing);
+            if (body)
+                incoming.push(body);
+            // Настоящий HTTP-парсер отмечает полное тело до end; иначе destroy имитирует обрыв.
+            incoming.complete = true;
+            incoming.push(null);
+        });
+    };
+}
+//# sourceMappingURL=http-test-fixture.js.map

package/dist/network/http-test-fixture.js.map

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

package/dist/network/known-keys.d.ts

@@ -0,0 +1,10 @@
+/** Долгая память подтверждённых ключей: только SHA-256, без секрета и полномочий. */
+export declare class KnownKeys {
+    private readonly entries;
+    get size(): number;
+    has(fingerprint: Buffer, now?: number): boolean;
+    remember(fingerprint: Buffer, now?: number): void;
+    forget(fingerprint: Buffer): void;
+    sweep(now?: number): void;
+    clear(): void;
+}

package/dist/network/known-keys.js

@@ -0,0 +1,38 @@
+import { KNOWN_KEY_TTL_MS, MAX_KNOWN_KEYS } from './constants.js';
+/** Долгая память подтверждённых ключей: только SHA-256, без секрета и полномочий. */
+export class KnownKeys {
+    entries = new Map();
+    get size() { return this.entries.size; }
+    has(fingerprint, now = Date.now()) {
+        const id = fingerprint.toString('hex');
+        const expiresAt = this.entries.get(id);
+        if (expiresAt === undefined)
+            return false;
+        if (now >= expiresAt) {
+            this.entries.delete(id);
+            return false;
+        }
+        return true;
+    }
+    remember(fingerprint, now = Date.now()) {
+        this.sweep(now);
+        const id = fingerprint.toString('hex');
+        // Только новая успешная проверка ядром продлевает срок и меняет порядок вытеснения.
+        this.entries.delete(id);
+        if (this.entries.size >= MAX_KNOWN_KEYS) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest !== undefined)
+                this.entries.delete(oldest);
+        }
+        this.entries.set(id, now + KNOWN_KEY_TTL_MS);
+    }
+    forget(fingerprint) { this.entries.delete(fingerprint.toString('hex')); }
+    sweep(now = Date.now()) {
+        for (const [id, expiresAt] of this.entries) {
+            if (now >= expiresAt)
+                this.entries.delete(id);
+        }
+    }
+    clear() { this.entries.clear(); }
+}
+//# sourceMappingURL=known-keys.js.map

package/dist/network/known-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-keys.js","sourceRoot":"","sources":["../../src/network/known-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElE,qFAAqF;AACrF,MAAM,OAAO,SAAS;IACH,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhD,GAAG,CAAC,WAAmB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACvC,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,WAAmB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QAC5C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,oFAAoF;QACpF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,cAAc,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,GAAG,gBAAgB,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,WAAmB,IAAU,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvF,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACpB,KAAK,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,IAAI,GAAG,IAAI,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,KAAK,KAAW,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;CACxC"}

package/dist/network/memory-credentials.d.ts

@@ -0,0 +1,11 @@
+import type { CredentialStore } from '../auth/token-storage.js';
+/** Секреты существуют только до закрытия одного HTTP-запроса. */
+export declare class MemoryCredentials implements CredentialStore {
+    private readonly values;
+    private closed;
+    set(account: string, value: string): Promise<void>;
+    get(account: string): Promise<string | null>;
+    delete(account: string): Promise<void>;
+    accounts(): Promise<string[]>;
+    clear(): void;
+}

package/dist/network/memory-credentials.js

@@ -0,0 +1,24 @@
+/** Секреты существуют только до закрытия одного HTTP-запроса. */
+export class MemoryCredentials {
+    values = new Map();
+    closed = false;
+    async set(account, value) {
+        if (this.closed)
+            throw new Error('HTTP request is closed');
+        this.values.set(account, value);
+    }
+    async get(account) {
+        return this.values.get(account) ?? null;
+    }
+    async delete(account) {
+        this.values.delete(account);
+    }
+    async accounts() {
+        return [...this.values.keys()];
+    }
+    clear() {
+        this.closed = true;
+        this.values.clear();
+    }
+}
+//# sourceMappingURL=memory-credentials.js.map

package/dist/network/memory-credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-credentials.js","sourceRoot":"","sources":["../../src/network/memory-credentials.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,MAAM,OAAO,iBAAiB;IACX,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,MAAM,GAAG,KAAK,CAAC;IAEvB,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,KAAa;QACtC,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAe;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/network/rate-limit.d.ts

@@ -0,0 +1,23 @@
+/** Общая арифметика ограниченных вёдер; параметры задаются только константами ниже. */
+declare class TokenBuckets {
+    private readonly capacity;
+    private readonly refillMs;
+    private readonly maxBuckets;
+    private readonly buckets;
+    constructor(capacity: number, refillMs: number, maxBuckets: number);
+    get size(): number;
+    protected consumeId(id: string, now: number): number;
+    sweep(now?: number): void;
+    clear(): void;
+}
+/** Ведро хранит только SHA-256, никогда исходный ключ. */
+export declare class KeyRateLimit extends TokenBuckets {
+    constructor();
+    consume(fingerprint: Buffer, now?: number): number;
+}
+/** Адрес живёт только в этой таблице; отсутствие заголовка объединяет клиентов в одно ведро. */
+export declare class VerificationRateLimit extends TokenBuckets {
+    constructor();
+    consume(address: string | undefined, now?: number): number;
+}
+export {};

package/dist/network/rate-limit.js

@@ -0,0 +1,62 @@
+import { MAX_RATE_LIMIT_BUCKETS, MAX_CLIENT_ADDRESS_BUCKETS, MILLISECONDS_PER_SECOND, RATE_LIMIT_CAPACITY, RATE_LIMIT_REFILL_MS, VERIFICATION_ATTEMPT_CAPACITY, VERIFICATION_ATTEMPT_REFILL_MS, } from './constants.js';
+/** Общая арифметика ограниченных вёдер; параметры задаются только константами ниже. */
+class TokenBuckets {
+    capacity;
+    refillMs;
+    maxBuckets;
+    buckets = new Map();
+    constructor(capacity, refillMs, maxBuckets) {
+        this.capacity = capacity;
+        this.refillMs = refillMs;
+        this.maxBuckets = maxBuckets;
+    }
+    get size() { return this.buckets.size; }
+    consumeId(id, now) {
+        let bucket = this.buckets.get(id);
+        if (!bucket) {
+            if (this.buckets.size >= this.maxBuckets)
+                this.sweep(now);
+            if (this.buckets.size >= this.maxBuckets) {
+                return Math.ceil(this.refillMs / MILLISECONDS_PER_SECOND);
+            }
+            bucket = { tokens: this.capacity, updatedAt: now };
+            this.buckets.set(id, bucket);
+        }
+        bucket.tokens = Math.min(this.capacity, bucket.tokens + Math.max(0, now - bucket.updatedAt) / this.refillMs);
+        bucket.updatedAt = now;
+        if (bucket.tokens < 1) {
+            return Math.ceil((1 - bucket.tokens) * this.refillMs / MILLISECONDS_PER_SECOND);
+        }
+        bucket.tokens -= 1;
+        return 0;
+    }
+    sweep(now = Date.now()) {
+        for (const [id, bucket] of this.buckets) {
+            if (now - bucket.updatedAt >= this.capacity * this.refillMs) {
+                this.buckets.delete(id);
+            }
+        }
+    }
+    clear() {
+        this.buckets.clear();
+    }
+}
+/** Ведро хранит только SHA-256, никогда исходный ключ. */
+export class KeyRateLimit extends TokenBuckets {
+    constructor() {
+        super(RATE_LIMIT_CAPACITY, RATE_LIMIT_REFILL_MS, MAX_RATE_LIMIT_BUCKETS);
+    }
+    consume(fingerprint, now = Date.now()) {
+        return super.consumeId(fingerprint.toString('hex'), now);
+    }
+}
+/** Адрес живёт только в этой таблице; отсутствие заголовка объединяет клиентов в одно ведро. */
+export class VerificationRateLimit extends TokenBuckets {
+    constructor() {
+        super(VERIFICATION_ATTEMPT_CAPACITY, VERIFICATION_ATTEMPT_REFILL_MS, MAX_CLIENT_ADDRESS_BUCKETS);
+    }
+    consume(address, now = Date.now()) {
+        return super.consumeId(address || '', now);
+    }
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/network/rate-limit.js.map

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

package/dist/network/rejected-keys.d.ts

@@ -0,0 +1,9 @@
+/** Короткая память только подтверждённых API отказов 401/403; исходных ключей здесь нет. */
+export declare class RejectedKeys {
+    private readonly entries;
+    get size(): number;
+    has(fingerprint: Buffer, now?: number): boolean;
+    remember(fingerprint: Buffer, now?: number): void;
+    sweep(now?: number): void;
+    clear(): void;
+}

package/dist/network/rejected-keys.js

@@ -0,0 +1,39 @@
+import { MAX_REJECTED_KEYS, REJECTED_KEY_TTL_MS } from './constants.js';
+/** Короткая память только подтверждённых API отказов 401/403; исходных ключей здесь нет. */
+export class RejectedKeys {
+    entries = new Map();
+    get size() { return this.entries.size; }
+    has(fingerprint, now = Date.now()) {
+        const id = fingerprint.toString('hex');
+        const expiresAt = this.entries.get(id);
+        if (expiresAt === undefined)
+            return false;
+        if (now >= expiresAt) {
+            this.entries.delete(id);
+            return false;
+        }
+        return true;
+    }
+    remember(fingerprint, now = Date.now()) {
+        const id = fingerprint.toString('hex');
+        this.sweep(now);
+        // Порядок Map соответствует времени последнего подтверждённого отказа.
+        this.entries.delete(id);
+        if (this.entries.size >= MAX_REJECTED_KEYS) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest !== undefined)
+                this.entries.delete(oldest);
+        }
+        this.entries.set(id, now + REJECTED_KEY_TTL_MS);
+    }
+    sweep(now = Date.now()) {
+        for (const [id, expiresAt] of this.entries) {
+            if (now >= expiresAt)
+                this.entries.delete(id);
+        }
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+//# sourceMappingURL=rejected-keys.js.map

package/dist/network/rejected-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rejected-keys.js","sourceRoot":"","sources":["../../src/network/rejected-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAExE,4FAA4F;AAC5F,MAAM,OAAO,YAAY;IACN,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhD,GAAG,CAAC,WAAmB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACvC,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,WAAmB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QAC5C,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChB,uEAAuE;QACvE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,iBAAiB,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,GAAG,mBAAmB,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACpB,KAAK,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,IAAI,GAAG,IAAI,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/network/request-work.d.ts

@@ -0,0 +1,8 @@
+import type { ToolApiClient } from '../http/api-client.js';
+/** Работа запроса переживает закрытие транспорта, включая последовательные обращения инструмента. */
+export declare class RequestWork {
+    private readonly pending;
+    track<T>(promise: Promise<T>): Promise<T>;
+    client(apiClient: ToolApiClient): ToolApiClient;
+    drain(): Promise<void>;
+}

package/dist/network/request-work.js

@@ -0,0 +1,20 @@
+/** Работа запроса переживает закрытие транспорта, включая последовательные обращения инструмента. */
+export class RequestWork {
+    pending = new Set();
+    track(promise) {
+        this.pending.add(promise);
+        void promise.finally(() => { this.pending.delete(promise); }).catch(() => { });
+        return promise;
+    }
+    client(apiClient) {
+        return {
+            request: (...args) => this.track(apiClient.request(...args)),
+            post: (...args) => this.track(apiClient.post(...args)),
+        };
+    }
+    async drain() {
+        while (this.pending.size > 0)
+            await Promise.allSettled([...this.pending]);
+    }
+}
+//# sourceMappingURL=request-work.js.map

package/dist/network/request-work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-work.js","sourceRoot":"","sources":["../../src/network/request-work.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,MAAM,OAAO,WAAW;IACL,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEvD,KAAK,CAAI,OAAmB;QAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9E,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,SAAwB;QAC7B,OAAO;YACL,OAAO,EAAE,CAAI,GAAG,IAA0C,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAI,GAAG,IAAI,CAAC,CAAC;YACxG,IAAI,EAAE,CAAI,GAAG,IAAuC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAI,GAAG,IAAI,CAAC,CAAC;SAChG,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC;YAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/network/successful-keys.d.ts

@@ -0,0 +1,17 @@
+export interface WorkspaceContext {
+    readonly workspace_id: string;
+    readonly workspace_name: string;
+    readonly account_label: string | null;
+    readonly scopes: readonly string[];
+}
+/** Кэш только успешных вердиктов: SHA-256 и контекст области, без исходного ключа. */
+export declare class SuccessfulKeys {
+    private readonly ttlMs;
+    private readonly entries;
+    constructor(ttlMs?: number);
+    get size(): number;
+    get(fingerprint: Buffer, now?: number): WorkspaceContext | undefined;
+    remember(fingerprint: Buffer, context: WorkspaceContext, now?: number): void;
+    sweep(now?: number): void;
+    clear(): void;
+}

package/dist/network/successful-keys.js

@@ -0,0 +1,47 @@
+import { MAX_SUCCESSFUL_KEYS, SUCCESSFUL_KEY_TTL_MS } from './constants.js';
+/** Кэш только успешных вердиктов: SHA-256 и контекст области, без исходного ключа. */
+export class SuccessfulKeys {
+    ttlMs;
+    entries = new Map();
+    constructor(ttlMs = SUCCESSFUL_KEY_TTL_MS) {
+        this.ttlMs = ttlMs;
+    }
+    get size() { return this.entries.size; }
+    get(fingerprint, now = Date.now()) {
+        const id = fingerprint.toString('hex');
+        const entry = this.entries.get(id);
+        if (!entry)
+            return undefined;
+        if (now >= entry.expiresAt) {
+            this.entries.delete(id);
+            return undefined;
+        }
+        return entry.context;
+    }
+    remember(fingerprint, context, now = Date.now()) {
+        // Несколько ожидавших один вердикт не продлевают его TTL.
+        if (this.get(fingerprint, now))
+            return;
+        this.sweep(now);
+        if (this.entries.size >= MAX_SUCCESSFUL_KEYS) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest !== undefined)
+                this.entries.delete(oldest);
+        }
+        this.entries.set(fingerprint.toString('hex'), {
+            context: {
+                workspace_id: context.workspace_id, workspace_name: context.workspace_name,
+                account_label: context.account_label, scopes: [...context.scopes],
+            },
+            expiresAt: now + this.ttlMs,
+        });
+    }
+    sweep(now = Date.now()) {
+        for (const [id, entry] of this.entries) {
+            if (now >= entry.expiresAt)
+                this.entries.delete(id);
+        }
+    }
+    clear() { this.entries.clear(); }
+}
+//# sourceMappingURL=successful-keys.js.map

package/dist/network/successful-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"successful-keys.js","sourceRoot":"","sources":["../../src/network/successful-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAS5E,sFAAsF;AACtF,MAAM,OAAO,cAAc;IAGI;IAFZ,OAAO,GAAG,IAAI,GAAG,EAA4D,CAAC;IAE/F,YAA6B,QAAQ,qBAAqB;QAA7B,UAAK,GAAL,KAAK,CAAwB;IAAG,CAAC;IAE9D,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhD,GAAG,CAAC,WAAmB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACvC,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,QAAQ,CAAC,WAAmB,EAAE,OAAyB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACvE,0DAA0D;QAC1D,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC;YAAE,OAAO;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,mBAAmB,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;YAC5C,OAAO,EAAE;gBACP,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc;gBAC1E,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;aAClE;YACD,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACpB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,IAAI,GAAG,IAAI,KAAK,CAAC,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,KAAK,KAAW,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;CACxC"}

package/dist/resources/concepts/external-execution.md

@@ -14,7 +14,9 @@ Claude должен соблюдать invariants:
 - Не менять `operationId` между get и submit.
 - Выполнять все stages в заданном порядке.
 - Возвращать JSON в форме, которую запросил backend.
-- При 410 expired начинать заново с matching `*_get_instructions`.
+- При отказе приёма сначала проверить известную промптовую операцию. Завершённая операция с тем же телом возвращает сохранённый успех; новый платный запуск не нужен.
+- При неизвестном исходе прежняя работа могла быть оплачена без сохранённого результата. Мост проверяет известную промптовую операцию сам. Сообщи человеку об отдельной оплате нового запуска и получи его решение перед запуском.
+- Предупреждение об оплате в 410 относится к платным операциям и их submit-инструментам. Истёкшая ссылка, настроечный токен или предварительный просмотр получают нейтральную подсказку получить новое значение через соответствующий инструмент.
 - Не отправлять raw secrets, API keys или Authorization headers в submit body.
 
 Связанные external pairs включают prompt generation, prompt iterate, prompt analyze, ICP analysis, sandbox findings, simulation findings и Q&A generation.

package/dist/resources/concepts/feedback-sheets.md

@@ -6,6 +6,8 @@
 
 ## Инструменты
 
+- `besales_feedback_document_access_get` — email до привязки, режим всего документа, все связи и свежая оценка прав Google.
+- `besales_feedback_document_access_update` — подтверждённая смена общего режима существующего документа.
 - `besales_feedback_sheet_link` — привязать таблицу к промпту агента по ссылке.
 - `besales_feedback_sheet_list` — список таблиц, привязанных к агенту.
 - `besales_feedback_sheet_read` — прочитать строки замечаний.
@@ -19,12 +21,18 @@
 с `agent_id` нужного агента и `source_url`. Один файл можно привязать к нескольким промптам:
 повторный вызов с другим `agent_id` создаёт ещё одну привязку, дубликата файла не возникает.
 
-В ответе придёт `serviceAccountEmail` — попроси пользователя расшарить таблицу на этот email
+Email также приходит в list/read и безопасных отказах read. До привязки вызовите document-access-get. В ответе придёт `serviceAccountEmail` — попросите пользователя расшарить таблицу на этот email
 (Viewer достаточно для чтения). Без расшаривания чтение вернёт ошибку доступа.
 
 Поддерживаются только нативные Google Sheets. Ссылка на `.xlsx`/`.csv` в Google Drive вернёт
 ошибку — попроси пользователя открыть файл как Google Sheet.
 
+## Общий режим и подтверждение
+
+Режим действует на весь документ, включая другие вкладки и агентов этой рабочей области. Без access_mode новая связь наследует текущий режим, первый документ начинает с READ_ONLY.
+Перед изменением вызовите besales_feedback_document_access_get и покажите весь affectedLinks с affectedLinksCount: агент, вкладка, закреплённая версия. Только после явного согласия человека передайте confirm_document_access_change=true и expected_document_snapshot из этого ответа. Не подставляйте согласие автоматически. При 409 с устаревшим снимком перечитайте полный список и снова получите согласие. Google ACL инструмент не меняет.
+Повтор link существующей пары даёт 409 с currentLink. Сохраните эту связь и версию; не делайте unlink/link автоматически. Для режима существующего документа используйте отдельный document-access-update.
+
 ## Когда читать
 
 Перед тем как улучшать промпт по замечаниям тестировщиков, вызови
@@ -35,21 +43,22 @@
 
 ## Режимы — различай по `accessMode`
 
-**`READ_ONLY`** — у тебя нет прав на запись в файл. Воркфлоу:
+**`READ_ONLY`** — приложение запрещает запись независимо от роли Google. Воркфлоу:
 1. `besales_feedback_sheet_read` → проанализируй замечания, сгруппируй по смыслу.
-2. Сформулируй конкретные правки промпта.
-3. `besales_prompt_patch_start` → создай черновик и прочитай текущий промпт целиком через
-   `besales_prompt_patch_get`.
-4. Собери точечные patch-операции и примени их через `besales_prompt_patch_apply`.
-   Проверь `appliedCount`, `skippedCount` и diff; при необходимости перечитай черновик.
-5. Покажи пользователю итоговые изменения. **После явного подтверждения пользователя** вызови
-   `besales_prompt_patch_commit`. Если подтверждения нет, черновик можно удалить через
+2. `besales_prompt_patch_start` → `besales_prompt_patch_get`: открой черновик и прочитай его
+   целиком, чтобы менять существующие правила по месту, без дублирующих секций.
+3. Сформулируй конкретные операции и примени их через `besales_prompt_patch_apply`.
+   Проверь `appliedCount`, `skippedCount` и diff; пропущенные операции не считай выполненными.
+4. Покажи пользователю итоговый черновик и **дождись явного подтверждения**.
+5. После подтверждения вызови `besales_prompt_patch_commit`; он запускает полный PromptLint и
+   либо публикует новую версию, либо возвращает ошибки без частичного коммита.
+   Если пользователь не согласовал публикацию, черновик можно удалить через
    `besales_prompt_patch_discard`.
 
 Никогда не финализируй промпт без явного согласия пользователя. В файл при `READ_ONLY`
-ничего не пиши — доступа нет.
+ничего не пиши — локальный режим запрещает запись.
 
-**`EDITABLE`** — у тебя есть права на запись. Воркфлоу тот же по части правки промпта, плюс
+**`EDITABLE`** — приложение допускает запись, если её разрешает Google. Свежий отказ Sheets остаётся отказом, даже при providerAccess.canEdit=true (например, защищённый диапазон). Patch flow тот же, плюс
 после обработки замечаний отметь их статус прямо в таблице через
 `besales_feedback_sheet_row_update`:
 
@@ -72,7 +81,7 @@ read-only режиме: читай замечания и предлагай пр
 - Не меняй ячейки с исходными замечаниями тестировщиков — пиши только в служебные колонки
   статуса/комментария.
 - Если `besales_feedback_sheet_read` вернул ошибку доступа — таблица не расшарена на service
-  account. Сообщи пользователю email из ответа `link` и попроси выдать доступ.
+  account. Сообщите пользователю serviceAccountEmail из ответа чтения и попросите выдать доступ.
 
 ## Отвязка
 

package/dist/resources/concepts/icp.md

@@ -2,7 +2,9 @@
 
 ICP (Ideal Customer Profile) в Besales описывает не абстрактную аудиторию для рассылок, а рабочую модель покупателя, по которой строятся промпты, сценарии проверки и sandbox-симуляции. ICP объединяет сегменты, personas, реальные или импортированные dialogue samples и test scenarios. Он помогает агенту отвечать не "для всех", а под конкретные боли, критерии выбора, возражения и стиль коммуникации целевого клиента.
 
-В v1.5 ICP хранится в новых таблицах `icp_profiles`, `icp_segments`, `icp_dialogue_samples`, `personas`, `test_scenarios` и связывается с агентами через `agent_icp_links`. Эти таблицы создаются сразу в v2-shape, поэтому MCP tools работают с будущей моделью данных без прямого доступа к существующим v1 сущностям.
+ICP хранится в `icp_profiles`, `icp_segments`, `icp_dialogue_samples`, `personas` и
+`test_scenarios`, а с агентами связывается через `agent_icp_links`. MCP работает только с этой
+канонической моделью и не обращается к старым сущностям напрямую.
 
 Когда Claude создаёт ICP через MCP, он должен сначала определить workspace context и выбрать источник: ручное описание, CRM dialogues или AI-generated draft. Для CRM-источника используется импорт samples с анонимизацией и подтверждением GDPR. После накопления samples Claude может запросить analysis instructions, локально выполнить stage-пайплайн сегментации/persona generation и отправить результат через submit tool.
 
@@ -10,7 +12,12 @@ ICP (Ideal Customer Profile) в Besales описывает не абстракт
 
 - `besales_icp_create` — создать ICP-профиль.
 - `besales_icp_import_dialogues` — импортировать и анонимизировать CRM-диалоги.
+- `besales_icp_import_status` и `besales_icp_import_history` — прочитать статус и историю импорта, включая `continuationState` и `remainderExpiredAt`, если сервер их прислал.
 - `besales_icp_analysis_get_instructions` — получить stages для анализа ICP.
 - `besales_icp_analysis_submit` — сохранить сегменты, personas и сценарии после external execution.
 
 Практическое правило: если пользователь просит "создай ICP для SaaS B2B", Claude должен создать профиль, затем уточнить или импортировать samples, после чего выполнить analysis pair. ICP не заменяет prompt generation, а даёт ей качественный контекст.
+
+Продолжение импорта: `AVAILABLE` — сохранённый остаток доступен; `FORWARDED` — уже создан следующий прогон; `EXPIRED` — остаток устарел; `NONE` — продолжения нет. `remainderExpiredAt` — момент удаления старого остатка уборкой; `null` означает, что уборка ещё не удаляла строки, и само по себе не доказывает доступность продолжения. Старые ответы без этих полей остаются допустимыми.
+
+Отказ `409 ICP_INGEST_CONTINUATION_EXPIRED` означает: остаток выборки устарел — начните новый импорт. Продолжение автоматически не повторять. Новый импорт запускается по решению человека с новым `request_key` и явным `gdpr_confirmed=true`.

package/dist/resources/concepts/sandbox.md

@@ -2,7 +2,10 @@
 
 Sandbox в Besales — это контролируемый прогон агента по ICP personas и test scenarios до выката изменений в production. Цель sandbox не в том, чтобы отправить реальные сообщения клиентам, а в том, чтобы проверить промпт, routing, ответы на возражения, handoff-поведение и качество реакции на разные сегменты.
 
-В v1.5 sandbox реализуется как отдельный домен с `sandbox_runs` и `sandbox_run_feedbacks`. Запуск создаёт run для агента и набора сценариев, а дальнейший анализ findings может выполняться через external execution pair. Production runtime остаётся authoritative через `AgentChat.baseSystemPrompt`, но sandbox позволяет безопасно оценить draft или updated prompt до approve/finalize.
+Sandbox хранит прогоны в `sandbox_runs` и обратную связь в `sandbox_run_feedbacks`. Запуск создаёт
+run для агента и набора сценариев, а дальнейший анализ findings может выполняться через external
+execution pair. Источник production-инструкции — опубликованная запись `agent_versions`; sandbox
+позволяет безопасно оценить черновик или новую версию до публикации.
 
 Для Claude важна последовательность:
 
@@ -27,13 +30,19 @@ Sandbox в Besales — это контролируемый прогон аген
 
 Один прогон = один режим. «Прогнать оба режима» = два вызова `besales_sandbox_run_start`.
 
-Выбирай режим по цели. Для детерминированной регрессии используй `scripted` по умолчанию;
-для исследования поведения персоны — `simulated`; для широкой проверки можно предложить оба.
-Уточнение обязательно только когда цель не позволяет выбрать безопасно или стоимость/охват
-заметно различаются. Обычный regression-прогон не нужно останавливать лишним вопросом.
+Без вопроса запускай обычный прогон: `mode=single_agent` и `client_mode=scripted` (умолчания
+схемы) — это дешёвый, воспроизводимый прогон для регрессии и проверки кандидата промпта до
+публикации (`candidate_prompt`). Перед запуском спроси пользователя одним коротким вопросом
+с ценой в одну фразу только если нужен:
+
+- `client_mode=simulated` (LLM играет клиента — дороже и каждый раз по-разному);
+- оба режима клиента (= два прогона);
+- `mode=workflow` (все агенты канала через роутер — шире и дороже).
 
 В findings: если симулированный клиент ушёл с `outcome: refused` или `endReason: gave_up` — это не автоматически провал агента; оценивай по тексту диалога.
 
-Sandbox не должен обращаться к реальным channel adapters и не должен создавать внешние side effects. Если сценарий требует проверки CRM или отправки сообщений, backend должен использовать sandbox adapters/ports или mock behavior.
+Sandbox проходит те же runtime-швы и ActionGovernor, что production, но после governor действует
+белый список допустимых шагов и подавление внешней доставки. Проверка CRM или отправки не должна
+создавать реальных внешних side effects.
 
 Практическое правило: sandbox — это безопасная проверка качества агента. Claude должен использовать его перед финализацией рискованных prompt changes, особенно если ICP содержит несколько сегментов или есть новые handoff/routing правила.