@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/tools/retry.js

@@ -1,85 +1 @@
-export const DEFAULT_FAUCET_RETRY_CONFIG = {
-    maxRetries: 5,
-    intervalMs: 3000,
-};
-export function loadFaucetRetryConfig() {
-    const maxRetries = Number(process.env.WOWOK_FAUCET_RETRY_COUNT);
-    const intervalMs = Number(process.env.WOWOK_FAUCET_RETRY_INTERVAL_MS);
-    return {
-        maxRetries: Number.isFinite(maxRetries) && maxRetries > 0
-            ? Math.floor(maxRetries)
-            : DEFAULT_FAUCET_RETRY_CONFIG.maxRetries,
-        intervalMs: Number.isFinite(intervalMs) && intervalMs > 0
-            ? Math.floor(intervalMs)
-            : DEFAULT_FAUCET_RETRY_CONFIG.intervalMs,
-    };
-}
-export function isFaucetRateLimitError(error) {
-    if (!error)
-        return false;
-    const msg = error instanceof Error ? error.message : String(error);
-    const lower = msg.toLowerCase();
-    if (lower.includes("429"))
-        return true;
-    if (lower.includes("rate limit"))
-        return true;
-    if (lower.includes("rate-limit"))
-        return true;
-    if (lower.includes("too many requests"))
-        return true;
-    if (lower.includes("try again in"))
-        return true;
-    if (lower.includes("throttle"))
-        return true;
-    return false;
-}
-function isFaucetOperation(input) {
-    if (typeof input !== "object" || input === null)
-        return false;
-    const obj = input;
-    return obj.faucet !== undefined && obj.faucet !== null;
-}
-export function withFaucetRetry(fn, config = loadFaucetRetryConfig()) {
-    return async (input) => {
-        if (!isFaucetOperation(input)) {
-            return fn(input);
-        }
-        let lastError;
-        for (let attempt = 1; attempt <= config.maxRetries; attempt++) {
-            try {
-                const result = await fn(input);
-                if (result && typeof result === "object" && !Array.isArray(result)) {
-                    const obj = result;
-                    if (obj.faucet_retry_count === undefined && attempt > 1) {
-                        obj.faucet_retry_count = attempt;
-                    }
-                }
-                return result;
-            }
-            catch (error) {
-                lastError = error;
-                if (!isFaucetRateLimitError(error)) {
-                    throw error;
-                }
-                if (attempt === config.maxRetries) {
-                    break;
-                }
-                await new Promise((resolve) => setTimeout(resolve, config.intervalMs));
-            }
-        }
-        const lastMsg = lastError instanceof Error ? lastError.message : String(lastError);
-        const err = new Error(`Faucet request failed after ${config.maxRetries} attempts ` +
-            `(interval ${config.intervalMs}ms). Last error: ${lastMsg}. ` +
-            `The faucet endpoint is currently rate-limiting this account. ` +
-            `Suggestions:\n` +
-            `  1. Wait a few minutes and try again.\n` +
-            `  2. Use a different faucet network if available.\n` +
-            `  3. Override retry config via env vars: ` +
-            `WOWOK_FAUCET_RETRY_COUNT (default 5), ` +
-            `WOWOK_FAUCET_RETRY_INTERVAL_MS (default 3000).`);
-        if (lastError instanceof Error && lastError.code) {
-            err.code = lastError.code;
-        }
-        throw err;
-    };
-}
+export const DEFAULT_FAUCET_RETRY_CONFIG={'maxRetries':0x5,'intervalMs':0xbb8};export function loadFaucetRetryConfig(){const a=Number(process['env']['WOWOK_FAUCET_RETRY_COUNT']),b=Number(process['env']['WOWOK_FAUCET_RETRY_INTERVAL_MS']);return{'maxRetries':Number['isFinite'](a)&&a>0x0?Math['floor'](a):DEFAULT_FAUCET_RETRY_CONFIG['maxRetries'],'intervalMs':Number['isFinite'](b)&&b>0x0?Math['floor'](b):DEFAULT_FAUCET_RETRY_CONFIG['intervalMs']};}export function isFaucetRateLimitError(a){if(!a)return![];const b=a instanceof Error?a['message']:String(a),c=b['toLowerCase']();if(c['includes']('429'))return!![];if(c['includes']('rate\x20limit'))return!![];if(c['includes']('rate-limit'))return!![];if(c['includes']('too\x20many\x20requests'))return!![];if(c['includes']('try\x20again\x20in'))return!![];if(c['includes']('throttle'))return!![];return![];}function isFaucetOperation(a){if(typeof a!=='object'||a===null)return![];const b=a;return b['faucet']!==undefined&&b['faucet']!==null;}export function withFaucetRetry(a,b=loadFaucetRetryConfig()){return async c=>{if(!isFaucetOperation(c))return a(c);let d;for(let g=0x1;g<=b['maxRetries'];g++){try{const h=await a(c);if(h&&typeof h==='object'&&!Array['isArray'](h)){const i=h;i['faucet_retry_count']===undefined&&g>0x1&&(i['faucet_retry_count']=g);}return h;}catch(j){d=j;if(!isFaucetRateLimitError(j))throw j;if(g===b['maxRetries'])break;await new Promise(k=>setTimeout(k,b['intervalMs']));}}const e=d instanceof Error?d['message']:String(d),f=new Error('Faucet\x20request\x20failed\x20after\x20'+b['maxRetries']+'\x20attempts\x20'+('(interval\x20'+b['intervalMs']+'ms).\x20Last\x20error:\x20'+e+'.\x20')+'The\x20faucet\x20endpoint\x20is\x20currently\x20rate-limiting\x20this\x20account.\x20'+'Suggestions:\x0a'+'\x20\x201.\x20Wait\x20a\x20few\x20minutes\x20and\x20try\x20again.\x0a'+'\x20\x202.\x20Use\x20a\x20different\x20faucet\x20network\x20if\x20available.\x0a'+'\x20\x203.\x20Override\x20retry\x20config\x20via\x20env\x20vars:\x20'+'WOWOK_FAUCET_RETRY_COUNT\x20(default\x205),\x20'+'WOWOK_FAUCET_RETRY_INTERVAL_MS\x20(default\x203000).');d instanceof Error&&d['code']&&(f['code']=d['code']);throw f;};}

package/dist/tools/rules-hook.d.ts

@@ -1,2 +1,2 @@
 import type { ToolDispatchResult } from "./types.js";
-export declare function applyOnchainRules(args: unknown): ToolDispatchResult | null;
+export declare function applyOnchainRules(args: unknown): Promise<ToolDispatchResult | null>;

package/dist/tools/rules-hook.js

@@ -1,23 +1 @@
-import { OnchainOperationsSchema, strictParse, getEnvConfig, } from "../schema/index.js";
-import { buildPendingConfirmation, buildConstraintError } from "./shared.js";
-import { validateOperation, hasBlockingViolations, } from "../knowledge/index.js";
-export function applyOnchainRules(args) {
-    let validated;
-    try {
-        validated = strictParse(OnchainOperationsSchema, args, "onchain_operations input");
-    }
-    catch {
-        return null;
-    }
-    const env = getEnvConfig(validated.env);
-    const data = 'data' in validated ? validated.data : undefined;
-    const gateResult = buildPendingConfirmation(validated.operation_type, data, env);
-    if (gateResult.structuredContent) {
-        return gateResult;
-    }
-    const constraintViolations = validateOperation(validated.operation_type, data);
-    if (hasBlockingViolations(constraintViolations)) {
-        return buildConstraintError(validated.operation_type, constraintViolations);
-    }
-    return null;
-}
+import{OnchainOperationsSchema,strictParse,getEnvConfig}from'../schema/index.js';import{buildPendingConfirmation,buildConstraintError}from'./shared.js';import{validateOperation,hasBlockingViolations}from'../knowledge/index.js';import{resolveEffectiveOverrides}from'../persona/index.js';export async function applyOnchainRules(a){let b;try{b=strictParse(OnchainOperationsSchema,a,'onchain_operations\x20input');}catch{return null;}const c=getEnvConfig(b['env']),d=await resolveEffectiveOverrides(c?.['account']),e='data'in b?b['data']:undefined,f=buildPendingConfirmation(b['operation_type'],e,c,d);if(f['structuredContent'])return f;const g=validateOperation(b['operation_type'],e);if(hasBlockingViolations(g))return buildConstraintError(b['operation_type'],g);return null;}

package/dist/tools/shared.d.ts

@@ -11,7 +11,7 @@ export interface LocalHandlerConfig<S extends z.ZodTypeAny> {
     buildContext: (validated: z.infer<S>) => SemanticContext;
 }
 export declare function wrapLocalHandler<S extends z.ZodTypeAny>(config: LocalHandlerConfig<S>): (args: unknown) => Promise<ToolDispatchResult>;
-export declare function buildPendingConfirmation(operation_type: string, data: unknown, env: CallEnv | undefined): ToolDispatchResult | {
+export declare function buildPendingConfirmation(operation_type: string, data: unknown, env: CallEnv | undefined, overrides?: Record<string, string>): ToolDispatchResult | {
     content: never[];
     structuredContent: null;
 };

package/dist/tools/shared.js

@@ -1,130 +1 @@
-import { confirmGate } from "../safety/confirm-gate.js";
-import { renderPreview } from "../safety/preview.js";
-import { validateOperation, hasBlockingViolations, getWarningViolations, } from "../knowledge/index.js";
-import { getHarness } from "../harness/index.js";
-import { isEnabled as isRuntimeEnabled } from "../config/index.js";
-import { classifyError, buildDataSemantic, } from "../schema/call/semantic.js";
-import { strictParse } from "../schema/index.js";
-export function withHarness(base, operation, intent) {
-    if (!isRuntimeEnabled("harness"))
-        return base;
-    try {
-        const harness = getHarness();
-        const expected = harness.expect(operation, intent, base.operation_type, base.data);
-        return {
-            ...base,
-            harness,
-            expected,
-            operation_id: `${base.operation_type}_${Date.now()}`,
-        };
-    }
-    catch {
-        return base;
-    }
-}
-export function wrapLocalHandler(config) {
-    const { schema, operationFn, parseLabel, buildContext } = config;
-    return async (args) => {
-        let validated;
-        try {
-            validated = strictParse(schema, args, parseLabel);
-            const result = await operationFn(validated);
-            const ctx = buildContext(validated);
-            return {
-                content: [{ type: "text", text: JSON.stringify(result) }],
-                structuredContent: {
-                    result: {
-                        status: "success",
-                        data: result,
-                    },
-                    semantic: buildDataSemantic(result, ctx),
-                },
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            const ctx = validated ? buildContext(validated) : undefined;
-            const classified = classifyError(errorMessage);
-            const errorResult = {
-                status: "error",
-                error: errorMessage,
-            };
-            if (classified.error_code !== undefined)
-                errorResult.error_code = classified.error_code;
-            if (classified.retryable !== undefined)
-                errorResult.retryable = classified.retryable;
-            if (classified.recovery_hint !== undefined)
-                errorResult.recovery_hint = classified.recovery_hint;
-            return {
-                content: [{ type: "text", text: `Error: ${errorMessage}` }],
-                structuredContent: {
-                    result: errorResult,
-                    semantic: buildDataSemantic(undefined, ctx, true, errorMessage),
-                },
-            };
-        }
-    };
-}
-export function buildPendingConfirmation(operation_type, data, env) {
-    const gate = confirmGate(operation_type, data, env, env?.user_intent_phrases);
-    if (gate.pass)
-        return { content: [], structuredContent: null };
-    const preview = gate.preview;
-    const rendered = renderPreview(preview);
-    const output = {
-        message: rendered,
-        result: {
-            type: "pending_confirmation",
-            preview,
-            rule_id: gate.rule_id,
-        },
-        semantic: {
-            intent: `${operation_type}_awaiting_confirmation`,
-            status: "pending_input",
-            summary: `Operation blocked by ConfirmGate (${gate.level}). Review the preview and re-call with env.confirmed=true to proceed.`,
-            next_actions: [
-                {
-                    action: "confirm: re-call the SAME operation with env.confirmed=true",
-                    reason: `ConfirmGate rule '${gate.rule_id}' matched. The operation was NOT executed.`,
-                    tool: "onchain_operations",
-                    priority: "required",
-                },
-            ],
-            warnings: preview.warnings ?? [],
-        },
-    };
-    return {
-        content: [{ type: "text", text: rendered }],
-        structuredContent: output,
-    };
-}
-export function buildConstraintError(operation_type, violations) {
-    const errors = violations.filter((v) => v.severity === "error");
-    const errorList = errors.map((v) => `  • [${v.field}] ${v.message}`).join("\n");
-    const message = `Pre-call constraint violations for '${operation_type}':\n${errorList}\n\nFix the listed field(s) and retry.`;
-    const output = {
-        message,
-        result: {
-            type: "error",
-            error: message,
-            error_code: "invalid_parameter",
-            retryable: false,
-            recovery_hint: "Review the constraint violations above and correct the corresponding fields.",
-        },
-    };
-    return {
-        content: [{ type: "text", text: message }],
-        structuredContent: output,
-    };
-}
-export function buildClassifiedErrorResult(base, error, classified) {
-    const result = { ...base, error };
-    if (classified.error_code !== undefined)
-        result.error_code = classified.error_code;
-    if (classified.retryable !== undefined)
-        result.retryable = classified.retryable;
-    if (classified.recovery_hint !== undefined)
-        result.recovery_hint = classified.recovery_hint;
-    return result;
-}
-export { validateOperation, hasBlockingViolations, getWarningViolations, };
+import{confirmGate}from'../safety/confirm-gate.js';import{renderPreview}from'../safety/preview.js';import{validateOperation,hasBlockingViolations,getWarningViolations}from'../knowledge/index.js';import{getHarness}from'../harness/index.js';import{isEnabled as a370a}from'../config/index.js';import{classifyError,buildDataSemantic}from'../schema/call/semantic.js';import{strictParse}from'../schema/index.js';export function withHarness(a,b,c){if(!a370a('harness'))return a;try{const d=getHarness(),e=d['expect'](b,c,a['operation_type'],a['data']);return{...a,'harness':d,'expected':e,'operation_id':a['operation_type']+'_'+Date['now']()};}catch{return a;}}export function wrapLocalHandler(a){const {schema:b,operationFn:c,parseLabel:d,buildContext:e}=a;return async f=>{let g;try{g=strictParse(b,f,d);const h=await c(g),i=e(g);return{'content':[{'type':'text','text':JSON['stringify'](h)}],'structuredContent':{'result':{'status':'success','data':h},'semantic':buildDataSemantic(h,i)}};}catch(j){const k=j instanceof Error?j['message']:String(j),l=g?e(g):undefined,m=classifyError(k),n={'status':'error','error':k};if(m['error_code']!==undefined)n['error_code']=m['error_code'];if(m['retryable']!==undefined)n['retryable']=m['retryable'];if(m['recovery_hint']!==undefined)n['recovery_hint']=m['recovery_hint'];return{'content':[{'type':'text','text':'Error:\x20'+k}],'structuredContent':{'result':n,'semantic':buildDataSemantic(undefined,l,!![],k)}};}};}export function buildPendingConfirmation(a,b,c,d){const e=confirmGate(a,b,c,c?.['user_intent_phrases'],d);if(e['pass'])return{'content':[],'structuredContent':null};const f=e['preview'],g=renderPreview(f),h={'message':g,'result':{'type':'pending_confirmation','preview':f,'rule_id':e['rule_id']},'semantic':{'intent':a+'_awaiting_confirmation','status':'pending_input','summary':'Operation\x20blocked\x20by\x20ConfirmGate\x20('+e['level']+').\x20Review\x20the\x20preview\x20and\x20re-call\x20with\x20env.confirmed=true\x20to\x20proceed.','next_actions':[{'action':'confirm:\x20re-call\x20the\x20SAME\x20operation\x20with\x20env.confirmed=true','reason':'ConfirmGate\x20rule\x20\x27'+e['rule_id']+'\x27\x20matched.\x20The\x20operation\x20was\x20NOT\x20executed.','tool':'onchain_operations','priority':'required'}],'warnings':f['warnings']??[]}};return{'content':[{'type':'text','text':g}],'structuredContent':h};}export function buildConstraintError(a,b){const c=b['filter'](g=>g['severity']==='error'),d=c['map'](g=>'\x20\x20•\x20['+g['field']+']\x20'+g['message'])['join']('\x0a'),e='Pre-call\x20constraint\x20violations\x20for\x20\x27'+a+'\x27:\x0a'+d+'\x0a\x0aFix\x20the\x20listed\x20field(s)\x20and\x20retry.',f={'message':e,'result':{'type':'error','error':e,'error_code':'invalid_parameter','retryable':![],'recovery_hint':'Review\x20the\x20constraint\x20violations\x20above\x20and\x20correct\x20the\x20corresponding\x20fields.'}};return{'content':[{'type':'text','text':e}],'structuredContent':f};}export function buildClassifiedErrorResult(a,b,c){const d={...a,'error':b};if(c['error_code']!==undefined)d['error_code']=c['error_code'];if(c['retryable']!==undefined)d['retryable']=c['retryable'];if(c['recovery_hint']!==undefined)d['recovery_hint']=c['recovery_hint'];return d;}export{validateOperation,hasBlockingViolations,getWarningViolations};

package/dist/tools/types.d.ts

@@ -4,6 +4,7 @@ import type { SemanticContext } from "../schema/call/semantic.js";
 export interface ToolConfig {
     title: string;
     description: string;
+    summary: string;
     inputSchema: z.ZodTypeAny;
     outputSchema?: z.ZodTypeAny;
     annotations?: {
@@ -28,7 +29,7 @@ export interface ToolEntry {
     config: ToolConfig;
     errorShapeBuilder?: ErrorShapeBuilder;
     timeoutMs?: number;
-    applyRules?: (args: unknown) => ToolDispatchResult | null;
+    applyRules?: (args: unknown) => Promise<ToolDispatchResult | null> | ToolDispatchResult | null;
 }
 export interface DispatchOptions {
     skipRules?: boolean;

package/dist/tools/types.js

@@ -1 +1 @@
-export {};
+export{};

package/dist/tools/upgrade-check.d.ts

@@ -0,0 +1,19 @@
+export interface UpgradeCheckComponent {
+    current: string | null;
+    latest: string | null;
+    outdated: boolean;
+}
+export interface UpgradeCheckResult {
+    mcp: UpgradeCheckComponent;
+    sdk: UpgradeCheckComponent;
+    client_installed: boolean;
+    client_install_hint: string | null;
+    upgrade_available: boolean;
+    reminder: {
+        type: "upgrade" | "install_client" | "none";
+        due: boolean;
+        message: string | null;
+    };
+    checked_at: string;
+}
+export declare function checkUpgrade(): Promise<UpgradeCheckResult>;

package/dist/tools/upgrade-check.js

@@ -0,0 +1 @@
+import{readFileSync,existsSync,writeFileSync,mkdirSync}from'fs';import{join,dirname}from'path';import{fileURLToPath}from'url';import{getWowMcpDir}from'@wowok/wowok';const __dirname=dirname(fileURLToPath(import.meta.url)),MCP_PACKAGE='@wowok/agent-mcp',SDK_PACKAGE='@wowok/wowok',WEEK_MS=0x7*0x18*0x3c*0x3c*0x3e8,REMINDER_FILE=join(getWowMcpDir(),'upgrade-reminder.json');function readMcpVersion(){try{const a=join(__dirname,'..','..','package.json'),b=JSON['parse'](readFileSync(a,'utf-8'));return b['version']??null;}catch{return null;}}function readSdkVersion(){try{const a=fileURLToPath(import.meta.resolve(SDK_PACKAGE));let b=dirname(a);for(let c=0x0;c<0x6;c++){const d=join(b,'package.json');if(existsSync(d)){const e=JSON['parse'](readFileSync(d,'utf-8'));if(e['name']===SDK_PACKAGE)return e['version']??null;}b=dirname(b);}return null;}catch{return null;}}async function fetchNpmLatest(a){const b='https://registry.npmjs.org/'+encodeURIComponent(a)+'/latest',c=new AbortController(),d=setTimeout(()=>c['abort'](),0x1770);try{const e=await fetch(b,{'signal':c['signal']});if(!e['ok'])return null;const f=await e['json']();return f['version']??null;}catch{return null;}finally{clearTimeout(d);}}function compareVersions(c,e){const f=c['split']('.')['map'](h=>parseInt(h,0xa)||0x0),g=e['split']('.')['map'](h=>parseInt(h,0xa)||0x0);for(let h=0x0;h<Math['max'](f['length'],g['length']);h++){const j=(f[h]||0x0)-(g[h]||0x0);if(j!==0x0)return j;}return 0x0;}function detectClientInstall(){const a=[];if(process['platform']==='win32'){const b=process['env']['LOCALAPPDATA'];b&&(a['push'](join(b,'WoWok','WoWok.exe')),a['push'](join(b,'Programs','WoWok','WoWok.exe')));}else{if(process['platform']==='darwin')a['push']('/Applications/WoWok.app');else{const d=process['env']['HOME']||process['env']['USERPROFILE']||'';d&&(a['push'](join(d,'.local','share','applications','wowok.desktop')),a['push'](join(d,'Applications','WoWok.AppImage')),a['push'](join(d,'.local','bin','wowok')));}}for(const e of a){if(e&&existsSync(e))return{'installed':!![],'hint':null};}return{'installed':![],'hint':'https://download.wowok.net'};}function readReminderState(){try{const a=readFileSync(REMINDER_FILE,'utf-8'),b=JSON['parse'](a);return{'lastInstallClientReminderAt':Number(b['lastInstallClientReminderAt'])||0x0};}catch{return{'lastInstallClientReminderAt':0x0};}}function writeReminderState(a){try{mkdirSync(dirname(REMINDER_FILE),{'recursive':!![]}),writeFileSync(REMINDER_FILE,JSON['stringify'](a),'utf-8');}catch{}}export async function checkUpgrade(){const a=readMcpVersion(),b=readSdkVersion(),[c,d]=await Promise['all']([fetchNpmLatest(MCP_PACKAGE),fetchNpmLatest(SDK_PACKAGE)]),e=detectClientInstall(),f=readReminderState(),g=Date['now'](),h=!!(a&&c&&compareVersions(c,a)>0x0),i=!!(b&&d&&compareVersions(d,b)>0x0),j=h||i;let k='none',l=![],m=null;if(j){k='upgrade',l=!![];const n=c??d??'',o=a??'';m='A\x20newer\x20WoWok\x20version\x20is\x20available\x20(current\x20v'+o+'\x20→\x20latest\x20v'+n+').\x20'+('Upgrade\x20for\x20more\x20features\x20and\x20improvements.\x20Run:\x20npm\x20install\x20-g\x20'+MCP_PACKAGE+'@latest');}else!e['installed']&&g-f['lastInstallClientReminderAt']>=WEEK_MS&&(k='install_client',l=!![],m='The\x20WoWok\x20desktop\x20client\x20is\x20not\x20installed\x20yet.\x20It\x20provides\x20wallet\x20management,\x20encrypted\x20Messenger,\x20project\x20management\x20and\x20more.\x20'+'Download\x20it\x20at\x20https://download.wowok.net\x20to\x20get\x20started.',f['lastInstallClientReminderAt']=g,writeReminderState(f));return{'mcp':{'current':a,'latest':c,'outdated':h},'sdk':{'current':b,'latest':d,'outdated':i},'client_installed':e['installed'],'client_install_hint':e['hint'],'upgrade_available':j,'reminder':{'type':k,'due':l,'message':m},'checked_at':new Date()['toISOString']()};}