project-cpu-mcp 0.7.1

package/dist/utils/retry.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.utils.js","sourceRoot":"","sources":["../../src/utils/retry.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEjE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACH,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,GACrB,MAAM,sBAAsB,CAAC;AAa9B,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,kBAA4C,CAAC,QAAQ,CAAE,CAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5G,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,gBAAgB,IAAI,CAAC,YAAY,YAAY,CAAC,CAAC;QAChG,IAAI,SAAS,YAAY,YAAY,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,SAAS,YAAY,gBAAgB,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3F,CAAC;IACL,CAAC;IACD,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IACzC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAoB,EAAE,UAAiC,EAAE;IACxF,MAAM,IAAI,GAAiB;QACvB,GAAG,qBAAqB;QACxB,WAAW,EAAE,mBAAmB;QAChC,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,UAAU;QACjB,GAAG,OAAO;KACb,CAAC;IAEF,IAAI,SAAkB,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,OAAO,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1D,MAAM;YACV,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;YACzF,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE;gBAC5C,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO;gBACP,WAAW,EAAE,KAAK;gBAClB,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;aAC7B,CAAC,CAAC;YACH,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IACD,MAAM,SAAS,CAAC;AACpB,CAAC"}

package/dist/version/backend-version.d.ts

@@ -0,0 +1,20 @@
+import { type BackendVersionOptions, type IBackendVersionSignal, type ProbeBackendVersion, type ToolGate, type VersionProbeApi } from './types.js';
+export declare class BackendVersion implements IBackendVersionSignal {
+    private readonly probe;
+    private readonly nowMs;
+    private readonly ttlMs;
+    private readonly onChange;
+    private readonly logger;
+    private sha;
+    private lastAttemptMs;
+    private inFlight;
+    private resetPending;
+    constructor(options: BackendVersionOptions);
+    ensureFresh(): Promise<void>;
+    takeResetNotice(): boolean;
+    private attempt;
+    private revalidate;
+}
+export declare function createBackendVersionGate(version: IBackendVersionSignal): ToolGate;
+export declare function createBackendVersionProbe(api: VersionProbeApi): ProbeBackendVersion;
+//# sourceMappingURL=backend-version.d.ts.map

package/dist/version/backend-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-version.d.ts","sourceRoot":"","sources":["../../src/version/backend-version.ts"],"names":[],"mappings":"AACA,OAAO,EACH,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAG1B,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,eAAe,EACvB,MAAM,YAAY,CAAC;AAIpB,qBAAa,cAAe,YAAW,qBAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,qBAAqB;IAQpC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,eAAe,IAAI,OAAO;YAMZ,OAAO;YAqBP,UAAU;CAuB3B;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,qBAAqB,GAAG,QAAQ,CAOjF;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,eAAe,GAAG,mBAAmB,CAgBnF"}

package/dist/version/backend-version.js

@@ -0,0 +1,92 @@
+import { BACKEND_RESET_NOTICE, BACKEND_VERSION_PATH, BACKEND_VERSION_TIMEOUT_MS } from './constants.js';
+import { backendVersionResponseSchema, HttpStatus } from '../api/types.js';
+export class BackendVersion {
+    probe;
+    nowMs;
+    ttlMs;
+    onChange;
+    logger;
+    sha = null;
+    lastAttemptMs = null;
+    inFlight = null;
+    resetPending = false;
+    constructor(options) {
+        this.probe = options.probe;
+        this.nowMs = options.nowMs;
+        this.ttlMs = options.ttlMs;
+        this.onChange = options.onChange;
+        this.logger = options.logger;
+    }
+    async ensureFresh() {
+        await this.attempt();
+    }
+    takeResetNotice() {
+        const pending = this.resetPending;
+        this.resetPending = false;
+        return pending;
+    }
+    async attempt() {
+        if (this.inFlight !== null) {
+            await this.inFlight;
+            return;
+        }
+        const now = this.nowMs();
+        if (this.lastAttemptMs !== null && now - this.lastAttemptMs < this.ttlMs) {
+            return;
+        }
+        this.lastAttemptMs = now;
+        const flight = this.revalidate();
+        this.inFlight = flight;
+        try {
+            await flight;
+        }
+        finally {
+            this.inFlight = null;
+        }
+    }
+    async revalidate() {
+        const observed = await this.probe();
+        if (observed === null || observed === this.sha) {
+            return;
+        }
+        if (this.sha === null) {
+            this.sha = observed;
+            return;
+        }
+        this.logger.info('game API build changed — reloading config and map');
+        try {
+            await this.onChange();
+        }
+        catch (error) {
+            this.lastAttemptMs = null;
+            throw error;
+        }
+        this.sha = observed;
+        this.resetPending = true;
+        this.logger.info('local state reloaded for the new game API build');
+    }
+}
+export function createBackendVersionGate(version) {
+    return {
+        check: async () => {
+            await version.ensureFresh();
+            return version.takeResetNotice() ? [BACKEND_RESET_NOTICE] : [];
+        },
+    };
+}
+export function createBackendVersionProbe(api) {
+    return async () => {
+        try {
+            const { status, data } = await api.requestWithTimeout(BACKEND_VERSION_PATH, BACKEND_VERSION_TIMEOUT_MS);
+            if (status !== HttpStatus.Ok) {
+                return null;
+            }
+            const parsed = backendVersionResponseSchema.safeParse(data);
+            return parsed.success ? parsed.data.versionSha : null;
+        }
+        catch {
+            return null;
+        }
+    };
+}
+//# sourceMappingURL=backend-version.js.map

package/dist/version/backend-version.js.map

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

package/dist/version/constants.d.ts

@@ -0,0 +1,12 @@
+export declare const PACKAGE_VERSION_TTL_MS: number;
+export declare const BACKEND_VERSION_TTL_MS: number;
+export declare const BACKEND_VERSION_PATH = "/api/version";
+export declare const BACKEND_VERSION_TIMEOUT_MS = 5000;
+export declare const BACKEND_RESET_NOTICE: string;
+export declare const REGISTRY_DIST_TAGS_URL = "https://registry.npmjs.org/-/package/project-cpu-mcp/dist-tags";
+export declare const REGISTRY_FETCH_TIMEOUT_MS = 5000;
+export declare const LATEST_PLACEHOLDER = "{latest}";
+export declare const CURRENT_PLACEHOLDER = "{current}";
+export declare const BLOCKED_ERROR_TEMPLATE: string;
+export declare const UPDATE_NOTICE_TEMPLATE: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/version/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/version/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,QAAqB,CAAC;AAEzD,eAAO,MAAM,sBAAsB,QAAY,CAAC;AAEhD,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAEnD,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,eAAO,MAAM,oBAAoB,QAKtB,CAAC;AAEZ,eAAO,MAAM,sBAAsB,mEAAmE,CAAC;AAEvG,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAC7C,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAE/C,eAAO,MAAM,sBAAsB,QAKxB,CAAC;AAEZ,eAAO,MAAM,sBAAsB,QAIxB,CAAC"}

package/dist/version/constants.js

@@ -0,0 +1,26 @@
+export const PACKAGE_VERSION_TTL_MS = 2 * 60 * 60 * 1000;
+export const BACKEND_VERSION_TTL_MS = 60 * 1000;
+export const BACKEND_VERSION_PATH = '/api/version';
+export const BACKEND_VERSION_TIMEOUT_MS = 5_000;
+export const BACKEND_RESET_NOTICE = [
+    'Note: the game API is running a new build, so this server reloaded its game config and world map from it.',
+    'Rules, contract addresses and cell state may all have moved.',
+    'Anything computed before this reset — routes, quotes, costs, plans — may be stale; re-check it before spending.',
+    'This notice is shown once.',
+].join(' ');
+export const REGISTRY_DIST_TAGS_URL = 'https://registry.npmjs.org/-/package/project-cpu-mcp/dist-tags';
+export const REGISTRY_FETCH_TIMEOUT_MS = 5_000;
+export const LATEST_PLACEHOLDER = '{latest}';
+export const CURRENT_PLACEHOLDER = '{current}';
+export const BLOCKED_ERROR_TEMPLATE = [
+    `Version ${LATEST_PLACEHOLDER} of this MCP server has been published; this process runs ${CURRENT_PLACEHOLDER}.`,
+    'The change is breaking, so results produced by this build can no longer be trusted.',
+    'Ask the user to restart the MCP server now — the next start pulls the new version in through the package manager.',
+    'Until that restart every tool of this server refuses to answer, so do not retry and do not plan around it.',
+].join(' ');
+export const UPDATE_NOTICE_TEMPLATE = [
+    `Note: version ${LATEST_PLACEHOLDER} of this MCP server has been published; this process runs ${CURRENT_PLACEHOLDER}.`,
+    'The change is backwards compatible — keep working as usual.',
+    'Mention it once to the user so they can restart the server when convenient to pick it up.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/version/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/version/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAC;AAEhD,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAEhD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,2GAA2G;IAC3G,8DAA8D;IAC9D,iHAAiH;IACjH,4BAA4B;CAC/B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,sBAAsB,GAAG,gEAAgE,CAAC;AAEvG,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAE/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAC7C,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAE/C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,WAAW,kBAAkB,6DAA6D,mBAAmB,GAAG;IAChH,qFAAqF;IACrF,mHAAmH;IACnH,4GAA4G;CAC/G,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,iBAAiB,kBAAkB,6DAA6D,mBAAmB,GAAG;IACtH,6DAA6D;IAC7D,2FAA2F;CAC9F,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/version/package-version.d.ts

@@ -0,0 +1,17 @@
+import { type IPackageVersionSignal, type PackageVersionOptions, type PackageVersionStatus, type ToolGate } from './types.js';
+export declare class PackageVersion implements IPackageVersionSignal {
+    readonly currentVersion: string;
+    private readonly fetchLatest;
+    private readonly nowMs;
+    private readonly ttlMs;
+    private readonly logger;
+    private lastAttemptMs;
+    private reportedVersion;
+    private blockedBy;
+    constructor(options: PackageVersionOptions);
+    check(): Promise<PackageVersionStatus>;
+    private readLatest;
+}
+export declare function createPackageVersionGate(version: IPackageVersionSignal): ToolGate;
+export declare function fetchLatestFromRegistry(): Promise<string | null>;
+//# sourceMappingURL=package-version.d.ts.map

package/dist/version/package-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../../src/version/package-version.ts"],"names":[],"mappings":"AAEA,OAAO,EAGH,KAAK,qBAAqB,EAE1B,KAAK,qBAAqB,EAE1B,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EAChB,MAAM,YAAY,CAAC;AAMpB,qBAAa,cAAe,YAAW,qBAAqB;IACxD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,SAAS,CAAuB;gBAE5B,OAAO,EAAE,qBAAqB;IAQpC,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;YAmC9B,UAAU;CAQ3B;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,qBAAqB,GAAG,QAAQ,CAejF;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWtE"}

package/dist/version/package-version.js

@@ -0,0 +1,87 @@
+import { REGISTRY_DIST_TAGS_URL, REGISTRY_FETCH_TIMEOUT_MS } from './constants.js';
+import { formatBlockedError, formatUpdateNotice, resolveVersionSignal } from './package-version.utils.js';
+import { distTagsSchema, PackageVersionSignal, } from './types.js';
+import { errorMessage } from '../utils/error.utils.js';
+const SILENT = { signal: PackageVersionSignal.Silent, latest: null };
+export class PackageVersion {
+    currentVersion;
+    fetchLatest;
+    nowMs;
+    ttlMs;
+    logger;
+    lastAttemptMs = null;
+    reportedVersion = null;
+    blockedBy = null;
+    constructor(options) {
+        this.currentVersion = options.currentVersion;
+        this.fetchLatest = options.fetchLatest;
+        this.nowMs = options.nowMs;
+        this.ttlMs = options.ttlMs;
+        this.logger = options.logger;
+    }
+    async check() {
+        if (this.blockedBy !== null) {
+            return { signal: PackageVersionSignal.Blocked, latest: this.blockedBy };
+        }
+        const now = this.nowMs();
+        if (this.lastAttemptMs !== null && now - this.lastAttemptMs < this.ttlMs) {
+            return SILENT;
+        }
+        this.lastAttemptMs = now;
+        const latest = await this.readLatest();
+        if (latest === null) {
+            return SILENT;
+        }
+        const signal = resolveVersionSignal(latest, this.currentVersion);
+        if (signal === PackageVersionSignal.Blocked) {
+            this.blockedBy = latest;
+            this.logger.warn('published version is not compatible with this build', {
+                latest,
+                current: this.currentVersion,
+            });
+            return { signal, latest };
+        }
+        if (signal === PackageVersionSignal.UpdateAvailable && this.reportedVersion !== latest) {
+            this.reportedVersion = latest;
+            this.logger.info('compatible update available', { latest, current: this.currentVersion });
+            return { signal, latest };
+        }
+        return SILENT;
+    }
+    async readLatest() {
+        try {
+            return await this.fetchLatest();
+        }
+        catch (error) {
+            this.logger.debug('registry lookup failed', { error: errorMessage(error) });
+            return null;
+        }
+    }
+}
+export function createPackageVersionGate(version) {
+    return {
+        check: async () => {
+            const status = await version.check();
+            const latest = status.latest ?? '';
+            if (status.signal === PackageVersionSignal.Blocked) {
+                throw new Error(formatBlockedError(latest, version.currentVersion));
+            }
+            if (status.signal === PackageVersionSignal.UpdateAvailable) {
+                return [formatUpdateNotice(latest, version.currentVersion)];
+            }
+            return [];
+        },
+    };
+}
+export async function fetchLatestFromRegistry() {
+    const response = await fetch(REGISTRY_DIST_TAGS_URL, {
+        headers: { Accept: 'application/json' },
+        signal: AbortSignal.timeout(REGISTRY_FETCH_TIMEOUT_MS),
+    });
+    if (!response.ok) {
+        return null;
+    }
+    const parsed = distTagsSchema.safeParse(await response.json());
+    return parsed.success ? parsed.data.latest : null;
+}
+//# sourceMappingURL=package-version.js.map

package/dist/version/package-version.js.map

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

package/dist/version/package-version.utils.d.ts

@@ -0,0 +1,8 @@
+import { PackageVersionSignal, type SemanticVersion } from './types.js';
+export declare function parseVersion(value: string): SemanticVersion | null;
+export declare function compareVersions(left: SemanticVersion, right: SemanticVersion): number;
+export declare function isSameRange(left: SemanticVersion, right: SemanticVersion): boolean;
+export declare function resolveVersionSignal(latest: string, current: string): PackageVersionSignal;
+export declare function formatBlockedError(latest: string, current: string): string;
+export declare function formatUpdateNotice(latest: string, current: string): string;
+//# sourceMappingURL=package-version.utils.d.ts.map

package/dist/version/package-version.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.utils.d.ts","sourceRoot":"","sources":["../../src/version/package-version.utils.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAIxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAWlE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,CAoBrF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAKlF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAU1F;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E"}

package/dist/version/package-version.utils.js

@@ -0,0 +1,60 @@
+import { BLOCKED_ERROR_TEMPLATE, CURRENT_PLACEHOLDER, LATEST_PLACEHOLDER, UPDATE_NOTICE_TEMPLATE, } from './constants.js';
+import { PackageVersionSignal } from './types.js';
+const VERSION_PATTERN = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+export function parseVersion(value) {
+    const match = VERSION_PATTERN.exec(value.trim());
+    if (match === null) {
+        return null;
+    }
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        prerelease: match[4] ?? '',
+    };
+}
+export function compareVersions(left, right) {
+    if (left.major !== right.major) {
+        return left.major > right.major ? 1 : -1;
+    }
+    if (left.minor !== right.minor) {
+        return left.minor > right.minor ? 1 : -1;
+    }
+    if (left.patch !== right.patch) {
+        return left.patch > right.patch ? 1 : -1;
+    }
+    if (left.prerelease === right.prerelease) {
+        return 0;
+    }
+    if (left.prerelease === '') {
+        return 1;
+    }
+    if (right.prerelease === '') {
+        return -1;
+    }
+    return left.prerelease > right.prerelease ? 1 : -1;
+}
+export function isSameRange(left, right) {
+    if (left.major !== right.major) {
+        return false;
+    }
+    return left.major !== 0 || left.minor === right.minor;
+}
+export function resolveVersionSignal(latest, current) {
+    const published = parseVersion(latest);
+    const running = parseVersion(current);
+    if (published === null || running === null) {
+        return PackageVersionSignal.Silent;
+    }
+    if (published.prerelease !== '' || compareVersions(published, running) <= 0) {
+        return PackageVersionSignal.Silent;
+    }
+    return isSameRange(published, running) ? PackageVersionSignal.UpdateAvailable : PackageVersionSignal.Blocked;
+}
+export function formatBlockedError(latest, current) {
+    return BLOCKED_ERROR_TEMPLATE.replace(LATEST_PLACEHOLDER, latest).replace(CURRENT_PLACEHOLDER, current);
+}
+export function formatUpdateNotice(latest, current) {
+    return UPDATE_NOTICE_TEMPLATE.replace(LATEST_PLACEHOLDER, latest).replace(CURRENT_PLACEHOLDER, current);
+}
+//# sourceMappingURL=package-version.utils.js.map

package/dist/version/package-version.utils.js.map

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

package/dist/version/reset-coordinator.d.ts

@@ -0,0 +1,11 @@
+import type { ResetCoordinatorOptions } from './types.js';
+export declare class ResetCoordinator {
+    private readonly appConfig;
+    private readonly mapSync;
+    private readonly swap;
+    private readonly syndicate;
+    private readonly logger;
+    constructor(options: ResetCoordinatorOptions);
+    reset(): Promise<void>;
+}
+//# sourceMappingURL=reset-coordinator.d.ts.map

package/dist/version/reset-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset-coordinator.d.ts","sourceRoot":"","sources":["../../src/version/reset-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4D,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGpH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,EAAE,uBAAuB;IAQtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAY/B"}

package/dist/version/reset-coordinator.js

@@ -0,0 +1,26 @@
+export class ResetCoordinator {
+    appConfig;
+    mapSync;
+    swap;
+    syndicate;
+    logger;
+    constructor(options) {
+        this.appConfig = options.appConfig;
+        this.mapSync = options.mapSync;
+        this.swap = options.swap;
+        this.syndicate = options.syndicate;
+        this.logger = options.logger;
+    }
+    async reset() {
+        await this.mapSync.pauseResync(async () => {
+            const config = await this.appConfig.fetch();
+            const snapshot = await this.mapSync.fetchFullSnapshot();
+            this.appConfig.replace(config);
+            this.mapSync.applyFullSnapshot(snapshot);
+            this.swap.invalidateCache();
+            this.syndicate.invalidateCache();
+        });
+        this.logger.info('config, map and config-derived caches replaced');
+    }
+}
+//# sourceMappingURL=reset-coordinator.js.map

package/dist/version/reset-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset-coordinator.js","sourceRoot":"","sources":["../../src/version/reset-coordinator.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,gBAAgB;IACR,SAAS,CAAwB;IACjC,OAAO,CAAiB;IACxB,IAAI,CAAoB;IACxB,SAAS,CAAoB;IAC7B,MAAM,CAAU;IAEjC,YAAY,OAAgC;QACxC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,KAAK;QACP,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAExD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IACvE,CAAC;CACJ"}

package/dist/version/tool-guard.d.ts

@@ -0,0 +1,7 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { NoticeBuffer, ToolGate } from './types.js';
+import type { ToolHandler, ToolRegistrar } from '../tools/types.js';
+export declare function createNoticeBuffer(): NoticeBuffer;
+export declare function guardToolHandler<TArgs extends Array<unknown>>(gates: ReadonlyArray<ToolGate>, handler: ToolHandler<TArgs>, buffer: NoticeBuffer): (...args: TArgs) => Promise<CallToolResult>;
+export declare function createGuardedRegistrar(server: ToolRegistrar, gates: ReadonlyArray<ToolGate>): ToolRegistrar;
+//# sourceMappingURL=tool-guard.d.ts.map

package/dist/version/tool-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-guard.d.ts","sourceRoot":"","sources":["../../src/version/tool-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpE,wBAAgB,kBAAkB,IAAI,YAAY,CAYjD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,KAAK,CAAC,OAAO,CAAC,EACzD,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC9B,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAC3B,MAAM,EAAE,YAAY,GACrB,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,cAAc,CAAC,CA8B7C;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,aAAa,CAU3G"}

package/dist/version/tool-guard.js

@@ -0,0 +1,49 @@
+export function createNoticeBuffer() {
+    let pending = [];
+    return {
+        take: () => {
+            const taken = pending;
+            pending = [];
+            return taken;
+        },
+        keep: (notices) => {
+            pending = [...notices, ...pending];
+        },
+    };
+}
+export function guardToolHandler(gates, handler, buffer) {
+    return async (...args) => {
+        const collected = buffer.take();
+        try {
+            for (const gate of gates) {
+                collected.push(...(await gate.check()));
+            }
+        }
+        catch (error) {
+            buffer.keep(collected);
+            throw error;
+        }
+        const notices = [...new Set(collected)];
+        let result;
+        try {
+            result = await handler(...args);
+        }
+        catch (error) {
+            buffer.keep(notices);
+            throw error;
+        }
+        if (notices.length === 0) {
+            return result;
+        }
+        return {
+            ...result,
+            content: [...(result.content ?? []), ...notices.map((text) => ({ type: 'text', text }))],
+        };
+    };
+}
+export function createGuardedRegistrar(server, gates) {
+    const buffer = createNoticeBuffer();
+    const registerTool = (name, config, callback) => server.registerTool(name, config, guardToolHandler(gates, callback, buffer));
+    return { registerTool };
+}
+//# sourceMappingURL=tool-guard.js.map

package/dist/version/tool-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-guard.js","sourceRoot":"","sources":["../../src/version/tool-guard.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,kBAAkB;IAC9B,IAAI,OAAO,GAAkB,EAAE,CAAC;IAChC,OAAO;QACH,IAAI,EAAE,GAAkB,EAAE;YACtB,MAAM,KAAK,GAAG,OAAO,CAAC;YACtB,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,EAAE,CAAC,OAA8B,EAAQ,EAAE;YAC3C,OAAO,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC;QACvC,CAAC;KACJ,CAAC;AACN,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC5B,KAA8B,EAC9B,OAA2B,EAC3B,MAAoB;IAEpB,OAAO,KAAK,EAAE,GAAG,IAAW,EAA2B,EAAE;QACrD,MAAM,SAAS,GAAkB,MAAM,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvB,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,MAAM,KAAK,CAAC;QAChB,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QAExC,IAAI,MAAsB,CAAC;QAC3B,IAAI,CAAC;YACD,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,MAAM,KAAK,CAAC;QAChB,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,OAAO;YACH,GAAG,MAAM;YACT,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;SACpG,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAqB,EAAE,KAA8B;IACxF,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACpC,MAAM,YAAY,GAAkC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAC3E,MAAM,CAAC,YAAY,CACf,IAAI,EACJ,MAAM,EACN,gBAAgB,CAAC,KAAK,EAAE,QAAkC,EAAE,MAAM,CAA+B,CACpG,CAAC;IAEN,OAAO,EAAE,YAAY,EAAE,CAAC;AAC5B,CAAC"}

package/dist/version/types.d.ts

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+import type { ILogger } from '../logger/types.js';
+import type { MapSnapshotResponse } from '../map/types.js';
+import type { AppConfig, IAppConfig } from '../services/types.js';
+export interface ToolGate {
+    check(): Promise<Array<string>>;
+}
+export interface NoticeBuffer {
+    take(): Array<string>;
+    keep(notices: ReadonlyArray<string>): void;
+}
+export declare enum PackageVersionSignal {
+    Silent = "silent",
+    UpdateAvailable = "update-available",
+    Blocked = "blocked"
+}
+export interface PackageVersionStatus {
+    signal: PackageVersionSignal;
+    latest: string | null;
+}
+export interface SemanticVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease: string;
+}
+export type FetchLatestVersion = () => Promise<string | null>;
+export type NowMs = () => number;
+export interface PackageVersionOptions {
+    currentVersion: string;
+    fetchLatest: FetchLatestVersion;
+    nowMs: NowMs;
+    ttlMs: number;
+    logger: ILogger;
+}
+export interface IPackageVersionSignal {
+    readonly currentVersion: string;
+    check(): Promise<PackageVersionStatus>;
+}
+export declare const distTagsSchema: z.ZodObject<{
+    latest: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    latest: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    latest: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+export interface VersionProbeApi {
+    requestWithTimeout<T>(path: string, timeoutMs: number): Promise<{
+        status: number;
+        data: T;
+    }>;
+}
+export type ProbeBackendVersion = () => Promise<string | null>;
+export type OnBackendVersionChange = () => Promise<void>;
+export interface BackendVersionOptions {
+    probe: ProbeBackendVersion;
+    nowMs: NowMs;
+    ttlMs: number;
+    onChange: OnBackendVersionChange;
+    logger: ILogger;
+}
+export interface IBackendVersion {
+    ensureFresh(): Promise<void>;
+}
+export interface IBackendVersionSignal extends IBackendVersion {
+    takeResetNotice(): boolean;
+}
+export interface IReplaceableAppConfig extends IAppConfig {
+    fetch(): Promise<AppConfig>;
+    replace(config: AppConfig): void;
+}
+export interface IFullMapLoader {
+    fetchFullSnapshot(): Promise<MapSnapshotResponse>;
+    applyFullSnapshot(snapshot: MapSnapshotResponse): void;
+    pauseResync(run: () => Promise<void>): Promise<void>;
+}
+export interface ICachedFromConfig {
+    invalidateCache(): void;
+}
+export interface ResetCoordinatorOptions {
+    appConfig: IReplaceableAppConfig;
+    mapSync: IFullMapLoader;
+    swap: ICachedFromConfig;
+    syndicate: ICachedFromConfig;
+    logger: ILogger;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/version/types.d.ts.map

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

package/dist/version/types.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export var PackageVersionSignal;
+(function (PackageVersionSignal) {
+    PackageVersionSignal["Silent"] = "silent";
+    PackageVersionSignal["UpdateAvailable"] = "update-available";
+    PackageVersionSignal["Blocked"] = "blocked";
+})(PackageVersionSignal || (PackageVersionSignal = {}));
+export const distTagsSchema = z.object({ latest: z.string().min(1) }).passthrough();
+//# sourceMappingURL=types.js.map

package/dist/version/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/version/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,MAAM,CAAN,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC5B,yCAAiB,CAAA;IACjB,4DAAoC,CAAA;IACpC,2CAAmB,CAAA;AACvB,CAAC,EAJW,oBAAoB,KAApB,oBAAoB,QAI/B;AA+BD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC"}

package/dist/wallet/agw.manager.d.ts

@@ -0,0 +1,20 @@
+import { type Address, type Hash, type Hex } from 'viem';
+import { type AgwWalletManagerOptions, type GasEstimateRequest, type ReadContractParams, type TransactionRequest, type TxReceipt, type WalletManager } from './types.js';
+export declare class AgwWalletManager implements WalletManager {
+    private readonly logger;
+    private readonly sessionClient;
+    private readonly accountAddress;
+    private readonly rpcUrl;
+    constructor(options: AgwWalletManagerOptions);
+    getAddress(): Address;
+    getChainId(): number;
+    sendTransaction(tx: TransactionRequest): Promise<Hash>;
+    estimateGas(tx: GasEstimateRequest): Promise<bigint>;
+    getGasPrice(): Promise<bigint>;
+    waitForReceipt(hash: Hash): Promise<TxReceipt>;
+    readContract(params: ReadContractParams): Promise<unknown>;
+    getBalance(): Promise<bigint>;
+    private publicClient;
+    signMessage(_message: string): Promise<Hex>;
+}
+//# sourceMappingURL=agw.manager.d.ts.map

package/dist/wallet/agw.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agw.manager.d.ts","sourceRoot":"","sources":["../../src/wallet/agw.manager.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAInF,OAAO,EACH,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EAEd,KAAK,aAAa,EACrB,MAAM,YAAY,CAAC;AAKpB,qBAAa,gBAAiB,YAAW,aAAa;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,OAAO,EAAE,uBAAuB;IAmB5C,UAAU,IAAI,OAAO;IAIrB,UAAU,IAAI,MAAM;IAId,eAAe,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtD,WAAW,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IASpD,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAI9B,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC;IAU9C,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1D,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC,OAAO,CAAC,YAAY;IAOd,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAGpD"}