@wowok/agent-mcp 2.7.0 → 2.7.2

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.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';export function applyOnchainRules(a){let b;try{b=strictParse(OnchainOperationsSchema,a,'onchain_operations\x20input');}catch{return null;}const c=getEnvConfig(b['env']),d='data'in b?b['data']:undefined,e=buildPendingConfirmation(b['operation_type'],d,c);if(e['structuredContent'])return e;const f=validateOperation(b['operation_type'],d);if(hasBlockingViolations(f))return buildConstraintError(b['operation_type'],f);return 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 a317a}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(!a317a('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){const d=confirmGate(a,b,c,c?.['user_intent_phrases']);if(d['pass'])return{'content':[],'structuredContent':null};const e=d['preview'],f=renderPreview(e),g={'message':f,'result':{'type':'pending_confirmation','preview':e,'rule_id':d['rule_id']},'semantic':{'intent':a+'_awaiting_confirmation','status':'pending_input','summary':'Operation\x20blocked\x20by\x20ConfirmGate\x20('+d['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'+d['rule_id']+'\x27\x20matched.\x20The\x20operation\x20was\x20NOT\x20executed.','tool':'onchain_operations','priority':'required'}],'warnings':e['warnings']??[]}};return{'content':[{'type':'text','text':f}],'structuredContent':g};}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.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']()};}

package/dist/tools/wip-deploy-assist.d.ts

@@ -1,4 +1,4 @@
-export type WipPathType = "local_unix" | "local_windows" | "local_relative" | "http_url" | "ipfs" | "data_url" | "unknown";
+export type WipPathType = "local_unix" | "local_windows" | "local_relative" | "local_http" | "http_url" | "ipfs" | "data_url" | "unknown";
 export interface WipPathClassification {
     type: WipPathType;
     is_local: boolean;

package/dist/tools/wip-deploy-assist.js

@@ -1,278 +1 @@
-export function classifyWipPath(path) {
-    if (!path || typeof path !== "string") {
-        return {
-            type: "unknown",
-            is_local: false,
-            is_network: false,
-            description: "Empty or invalid path",
-        };
-    }
-    if (path.startsWith("data:")) {
-        return {
-            type: "data_url",
-            is_local: false,
-            is_network: true,
-            description: "Data URL — embedded content, globally reachable",
-        };
-    }
-    if (path.startsWith("ipfs://")) {
-        return {
-            type: "ipfs",
-            is_local: false,
-            is_network: true,
-            description: "IPFS URI — resolve via any public gateway",
-        };
-    }
-    const ipfsGateways = [
-        /^https?:\/\/ipfs\.io\//i,
-        /^https?:\/\/cloudflare-ipfs\.com\//i,
-        /^https?:\/\/gateway\.pinata\.cloud\//i,
-        /^https?:\/\/dweb\.link\//i,
-        /^https?:\/\/[^/]*pinata\.cloud\//i,
-    ];
-    if (ipfsGateways.some((re) => re.test(path))) {
-        return {
-            type: "ipfs",
-            is_local: false,
-            is_network: true,
-            description: "IPFS HTTP gateway URL — globally reachable",
-        };
-    }
-    if (/^https?:\/\//i.test(path)) {
-        return {
-            type: "http_url",
-            is_local: false,
-            is_network: true,
-            description: "HTTP(S) URL — globally reachable if server returns 200",
-        };
-    }
-    if (/^[A-Za-z]:[\\/]/.test(path)) {
-        return {
-            type: "local_windows",
-            is_local: true,
-            is_network: false,
-            description: "Windows local path — NOT reachable by customers/AI",
-        };
-    }
-    if (path.startsWith("/")) {
-        return {
-            type: "local_unix",
-            is_local: true,
-            is_network: false,
-            description: "Unix local path — NOT reachable by customers/AI",
-        };
-    }
-    if (path.startsWith("./") || path.startsWith("../") || path === "." || path === "..") {
-        return {
-            type: "local_relative",
-            is_local: true,
-            is_network: false,
-            description: "Relative local path — NOT reachable by customers/AI",
-        };
-    }
-    if (!path.includes("://") && !path.startsWith("data:")) {
-        return {
-            type: "local_relative",
-            is_local: true,
-            is_network: false,
-            description: "Local file path (no scheme) — NOT reachable by customers/AI",
-        };
-    }
-    return {
-        type: "unknown",
-        is_local: false,
-        is_network: false,
-        description: "Unrecognized path format",
-    };
-}
-export function getDeployOptions(localFilePath) {
-    const safePath = localFilePath.replace(/'/g, "'\\''");
-    const basename = localFilePath.split(/[\\/]/).pop() || "file.wip";
-    return [
-        {
-            name: "GitHub Pages (Recommended)",
-            description: "Upload the .wip file to a GitHub repository and serve it via GitHub Pages. " +
-                "Free, stable, HTTPS-enabled, no expiration.",
-            difficulty: "easy",
-            free: true,
-            result_url_pattern: "https://<your-username>.github.io/<repo>/<file>.wip",
-            steps: [
-                "// 1. Create a new GitHub repository (e.g., 'wowok-wip') via https://github.com/new",
-                "// 2. Make it PUBLIC so the file is world-readable.",
-                `// 3. Copy your local WIP file into the repo:`,
-                `git clone https://github.com/<your-username>/wowok-wip.git`,
-                `cp '${safePath}' wowok-wip/${basename}`,
-                `cd wowok-wip`,
-                `git add ${basename}`,
-                `git commit -m "Add WIP file"`,
-                `git push origin main`,
-                "// 4. Enable GitHub Pages: repo → Settings → Pages → Source → 'main' branch → /(root) → Save",
-                "// 5. Wait 30-60 seconds for deployment, then verify the URL is reachable:",
-                `curl -I https://<your-username>.github.io/wowok-wip/${basename}`,
-                "// 6. Update your Service on-chain with the new public URL:",
-                "//    Call onchain_operations { operation_type: 'service', data: { object: '<service-id>', sales: { op: 'set', sales: [{ ..., wip_url: 'https://...', wip_hash: '<hash>' }] } } }",
-            ],
-            notes: [
-                "If the repo already has Pages enabled on the main branch, step 4 can be skipped.",
-                "GitHub Pages serves files up to 25 MB — well above typical WIP sizes (< 1 MB).",
-                "URL is case-sensitive; ensure the filename in the URL matches exactly.",
-            ],
-        },
-        {
-            name: "IPFS via Pinata (Free gateway)",
-            description: "Upload the .wip file to IPFS through Pinata's free gateway. " +
-                "Content-addressed — the CID hash also serves as an integrity check.",
-            difficulty: "medium",
-            free: true,
-            result_url_pattern: "https://gateway.pinata.cloud/ipfs/<CID>  (or  https://ipfs.io/ipfs/<CID>)",
-            steps: [
-                "// 1. Sign up for a free Pinata account at https://app.pinata.cloud/ (1 GB free storage).",
-                "// 2. Get your API key from https://app.pinata.cloud/keys (generate a new key with 'pinFileToIPFS' scope).",
-                `// 3. Upload your local WIP file via curl:`,
-                `curl -X POST https://api.pinata.cloud/pinning/pinFileToIPFS \\`,
-                `  -H "Authorization: Bearer <YOUR_PINATA_API_KEY>" \\`,
-                `  -F "file=@'${safePath}'"`,
-                "// 4. Pinata returns JSON with 'IpfsHash' (the CID). Extract it:",
-                `//    Example response: { "IpfsHash": "QmXYZ...", "PinSize": 12345, "Timestamp": "..." }`,
-                "// 5. Verify the file is reachable via the public gateway:",
-                `curl -I https://gateway.pinata.cloud/ipfs/<CID>`,
-                "// 6. (Optional) Use ipfs://<CID> as the wip_url — the SDK resolves it.",
-                "// 7. Update your Service on-chain with the IPFS URL or CID:",
-                "//    Call onchain_operations { operation_type: 'service', data: { object: '<service-id>', sales: { op: 'set', sales: [{ ..., wip_url: 'https://gateway.pinata.cloud/ipfs/<CID>', wip_hash: '<hash>' }] } } }",
-            ],
-            notes: [
-                "Pinata free tier: 1 GB storage, 100 uploads/day — sufficient for WIP files.",
-                "For long-term durability, also pin via another gateway (e.g., nft.storage).",
-                "IPFS CIDs are content-addressed — if the file changes, the CID changes. This is a feature, not a bug.",
-            ],
-        },
-        {
-            name: "User's own website / static host",
-            description: "If you already operate a website or static host (e.g., nginx, Vercel, Netlify, Cloudflare Pages), " +
-                "upload the .wip file there and use its public URL.",
-            difficulty: "medium",
-            free: true,
-            result_url_pattern: "https://<your-domain>/<path>/<file>.wip",
-            steps: [
-                `// 1. Copy your local WIP file to your web server's static directory:`,
-                `scp '${safePath}' user@your-server:/var/www/html/wowok/${basename}`,
-                "// 2. Ensure the server sets Content-Type: application/json (or application/octet-stream) for .wip files.",
-                "//    For nginx, add to your server block:",
-                "//        location ~ \\.wip$ { default_type application/json; }",
-                "// 3. Verify the file is reachable:",
-                `curl -I https://<your-domain>/wowok/${basename}`,
-                "// 4. Update your Service on-chain with the new public URL:",
-                "//    Call onchain_operations { operation_type: 'service', data: { object: '<service-id>', sales: { op: 'set', sales: [{ ..., wip_url: 'https://<your-domain>/wowok/<file>.wip', wip_hash: '<hash>' }] } } }",
-            ],
-            notes: [
-                "Make sure CORS is permissive if the verifier fetches via browser (Access-Control-Allow-Origin: *).",
-                "Ensure HTTPS is enabled — most verifiers reject plain HTTP.",
-            ],
-        },
-        {
-            name: "Data URL embedding (small files only)",
-            description: "Embed the entire WIP file as a base64 data URL directly in the wip_url field. " +
-                "No external hosting required, but on-chain storage cost grows with file size.",
-            difficulty: "easy",
-            free: true,
-            result_url_pattern: "data:application/json;base64,<base64-encoded-content>",
-            steps: [
-                `// 1. Encode your local WIP file as a base64 data URL:`,
-                `//    On Linux/macOS:`,
-                `echo "data:application/json;base64,$(base64 -w0 '${safePath}')"`,
-                `//    On Windows (PowerShell):`,
-                `$bytes = [System.IO.File]::ReadAllBytes('${localFilePath}'); $b64 = [System.Convert]::ToBase64String($bytes); Write-Output "data:application/json;base64,$b64"`,
-                "// 2. Use the resulting data URL as the wip_url field when updating the Service.",
-                "// 3. Note: data URLs are NOT recommended for files > 50 KB due to on-chain storage cost.",
-            ],
-            notes: [
-                "Only suitable for very small WIP files (typically < 10 KB).",
-                "Data URLs cannot be updated without an on-chain transaction — content is literally embedded.",
-                "Prefer GitHub Pages or IPFS for files > 10 KB.",
-            ],
-        },
-    ];
-}
-export function analyzeWipDeployment(path) {
-    const classification = classifyWipPath(path);
-    const needsDeployment = classification.is_local;
-    let reason;
-    let options = [];
-    if (needsDeployment) {
-        reason =
-            `The WIP path '${path}' is a LOCAL ${classification.type} path. ` +
-                "Local paths stored on-chain are unreachable by customers and verifiers. " +
-                "Deploy the .wip file to a public host (GitHub Pages, IPFS, or your own website) " +
-                "and update the Service's wip_url with the public URL.";
-        options = getDeployOptions(path);
-    }
-    else if (classification.type === "http_url") {
-        reason =
-            "The WIP path is an HTTP(S) URL — verify the server returns 200. " +
-                "If the URL returns 404/403, the file may have been moved or deleted.";
-        options = [];
-    }
-    else if (classification.type === "ipfs") {
-        reason =
-            "The WIP path is an IPFS URL — verify the gateway is responsive. " +
-                "If the CID is unreachable, the file may have been unpinned.";
-        options = [];
-    }
-    else if (classification.type === "data_url") {
-        reason = "The WIP path is a data URL — content is embedded, no deployment needed.";
-        options = [];
-    }
-    else {
-        reason = `Unrecognized WIP path format: '${path}'`;
-        options = [];
-    }
-    return {
-        path,
-        classification,
-        needs_deployment: needsDeployment,
-        reason,
-        options,
-        remind_update_hash: needsDeployment,
-    };
-}
-export function formatDeployHints(suggestion) {
-    if (!suggestion.needs_deployment && suggestion.options.length === 0) {
-        return "";
-    }
-    const lines = [];
-    lines.push("=== WIP Deployment Assistance ===");
-    lines.push("");
-    lines.push(`Path: ${suggestion.path}`);
-    lines.push(`Type: ${suggestion.classification.description}`);
-    lines.push(`Reason: ${suggestion.reason}`);
-    lines.push("");
-    if (suggestion.options.length > 0) {
-        lines.push("Recommended deployment options:");
-        lines.push("");
-        for (const opt of suggestion.options) {
-            lines.push(`▶ ${opt.name} (difficulty: ${opt.difficulty}, free: ${opt.free})`);
-            lines.push(`  ${opt.description}`);
-            lines.push(`  Resulting URL pattern: ${opt.result_url_pattern}`);
-            lines.push("  Steps:");
-            for (const step of opt.steps) {
-                lines.push(`    ${step}`);
-            }
-            if (opt.notes && opt.notes.length > 0) {
-                lines.push("  Notes:");
-                for (const note of opt.notes) {
-                    lines.push(`    - ${note}`);
-                }
-            }
-            lines.push("");
-        }
-    }
-    if (suggestion.remind_update_hash) {
-        lines.push("⚠️ After deploying, compute the new WIP hash and update the Service:");
-        lines.push("  1. Re-run wip_file { type: 'verify', wipFilePath: '<new-public-url>' } to confirm the file is reachable.");
-        lines.push("  2. Extract the meta.hash from the WIP file (or use wip_file { type: 'verify' } result).");
-        lines.push("  3. Update the Service on-chain: onchain_operations { operation_type: 'service', data: { object: '<service-id>', sales: { op: 'set', sales: [{ ..., wip_url: '<new-public-url>', wip_hash: '<hash>' }] } } }");
-        lines.push("");
-    }
-    lines.push("===============================");
-    return lines.join("\n");
-}
+export function classifyWipPath(a){if(!a||typeof a!=='string')return{'type':'unknown','is_local':![],'is_network':![],'description':'Empty\x20or\x20invalid\x20path'};if(a['startsWith']('data:'))return{'type':'data_url','is_local':![],'is_network':!![],'description':'Data\x20URL\x20—\x20embedded\x20content,\x20globally\x20reachable'};if(a['startsWith']('ipfs://'))return{'type':'ipfs','is_local':![],'is_network':!![],'description':'IPFS\x20URI\x20—\x20resolve\x20via\x20any\x20public\x20gateway'};const b=[/^https?:\/\/ipfs\.io\//i,/^https?:\/\/cloudflare-ipfs\.com\//i,/^https?:\/\/gateway\.pinata\.cloud\//i,/^https?:\/\/dweb\.link\//i,/^https?:\/\/[^/]*pinata\.cloud\//i];if(b['some'](d=>d['test'](a)))return{'type':'ipfs','is_local':![],'is_network':!![],'description':'IPFS\x20HTTP\x20gateway\x20URL\x20—\x20globally\x20reachable'};if(/^https?:\/\/(localhost|127\.0\.0\.1|\[::1\]|0\.0\.0\.0)([:/]|$)/i['test'](a))return{'type':'local_http','is_local':!![],'is_network':![],'description':'Local\x20HTTP\x20URL\x20(localhost/loopback)\x20—\x20reachable\x20only\x20on\x20this\x20machine,\x20NOT\x20by\x20customers'};const c=/^https?:\/\/(10\.\d{1,3}\.\d{1,3}\.\d{1,3}|172\.(1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}|192\.168\.\d{1,3}\.\d{1,3})([:/]|$)/i;if(c['test'](a))return{'type':'local_http','is_local':!![],'is_network':![],'description':'LAN\x20HTTP\x20URL\x20(private\x20IP)\x20—\x20reachable\x20only\x20on\x20the\x20local\x20network,\x20NOT\x20by\x20customers'};if(/^https?:\/\//i['test'](a))return{'type':'http_url','is_local':![],'is_network':!![],'description':'HTTP(S)\x20URL\x20—\x20globally\x20reachable\x20if\x20server\x20returns\x20200'};if(/^[A-Za-z]:[\\/]/['test'](a))return{'type':'local_windows','is_local':!![],'is_network':![],'description':'Windows\x20local\x20path\x20—\x20NOT\x20reachable\x20by\x20customers/AI'};if(a['startsWith']('/'))return{'type':'local_unix','is_local':!![],'is_network':![],'description':'Unix\x20local\x20path\x20—\x20NOT\x20reachable\x20by\x20customers/AI'};if(a['startsWith']('./')||a['startsWith']('../')||a==='.'||a==='..')return{'type':'local_relative','is_local':!![],'is_network':![],'description':'Relative\x20local\x20path\x20—\x20NOT\x20reachable\x20by\x20customers/AI'};if(!a['includes']('://')&&!a['startsWith']('data:'))return{'type':'local_relative','is_local':!![],'is_network':![],'description':'Local\x20file\x20path\x20(no\x20scheme)\x20—\x20NOT\x20reachable\x20by\x20customers/AI'};return{'type':'unknown','is_local':![],'is_network':![],'description':'Unrecognized\x20path\x20format'};}export function getDeployOptions(a){const b=a['replace'](/'/g,'\x27\x5c\x27\x27'),c=a['split'](/[\\/]/)['pop']()||'file.wip';return[{'name':'GitHub\x20Pages\x20(Recommended)','description':'Upload\x20the\x20.wip\x20file\x20to\x20a\x20GitHub\x20repository\x20and\x20serve\x20it\x20via\x20GitHub\x20Pages.\x20'+'Free,\x20stable,\x20HTTPS-enabled,\x20no\x20expiration.','difficulty':'easy','free':!![],'result_url_pattern':'https://<your-username>.github.io/<repo>/<file>.wip','steps':['//\x201.\x20Create\x20a\x20new\x20GitHub\x20repository\x20(e.g.,\x20\x27wowok-wip\x27)\x20via\x20https://github.com/new','//\x202.\x20Make\x20it\x20PUBLIC\x20so\x20the\x20file\x20is\x20world-readable.','//\x203.\x20Copy\x20your\x20local\x20WIP\x20file\x20into\x20the\x20repo:','git\x20clone\x20https://github.com/<your-username>/wowok-wip.git','cp\x20\x27'+b+'\x27\x20wowok-wip/'+c,'cd\x20wowok-wip','git\x20add\x20'+c,'git\x20commit\x20-m\x20\x22Add\x20WIP\x20file\x22','git\x20push\x20origin\x20main','//\x204.\x20Enable\x20GitHub\x20Pages:\x20repo\x20→\x20Settings\x20→\x20Pages\x20→\x20Source\x20→\x20\x27main\x27\x20branch\x20→\x20/(root)\x20→\x20Save','//\x205.\x20Wait\x2030-60\x20seconds\x20for\x20deployment,\x20then\x20verify\x20the\x20URL\x20is\x20reachable:','curl\x20-I\x20https://<your-username>.github.io/wowok-wip/'+c,'//\x206.\x20Update\x20your\x20Service\x20on-chain\x20with\x20the\x20new\x20public\x20URL:','//\x20\x20\x20\x20Call\x20onchain_operations\x20{\x20operation_type:\x20\x27service\x27,\x20data:\x20{\x20object:\x20\x27<service-id>\x27,\x20sales:\x20{\x20op:\x20\x27set\x27,\x20sales:\x20[{\x20...,\x20wip_url:\x20\x27https://...\x27,\x20wip_hash:\x20\x27<hash>\x27\x20}]\x20}\x20}\x20}'],'notes':['If\x20the\x20repo\x20already\x20has\x20Pages\x20enabled\x20on\x20the\x20main\x20branch,\x20step\x204\x20can\x20be\x20skipped.','GitHub\x20Pages\x20serves\x20files\x20up\x20to\x2025\x20MB\x20—\x20well\x20above\x20typical\x20WIP\x20sizes\x20(<\x201\x20MB).','URL\x20is\x20case-sensitive;\x20ensure\x20the\x20filename\x20in\x20the\x20URL\x20matches\x20exactly.']},{'name':'IPFS\x20via\x20Pinata\x20(Free\x20gateway)','description':'Upload\x20the\x20.wip\x20file\x20to\x20IPFS\x20through\x20Pinata\x27s\x20free\x20gateway.\x20'+'Content-addressed\x20—\x20the\x20CID\x20hash\x20also\x20serves\x20as\x20an\x20integrity\x20check.','difficulty':'medium','free':!![],'result_url_pattern':'https://gateway.pinata.cloud/ipfs/<CID>\x20\x20(or\x20\x20https://ipfs.io/ipfs/<CID>)','steps':['//\x201.\x20Sign\x20up\x20for\x20a\x20free\x20Pinata\x20account\x20at\x20https://app.pinata.cloud/\x20(1\x20GB\x20free\x20storage).','//\x202.\x20Get\x20your\x20API\x20key\x20from\x20https://app.pinata.cloud/keys\x20(generate\x20a\x20new\x20key\x20with\x20\x27pinFileToIPFS\x27\x20scope).','//\x203.\x20Upload\x20your\x20local\x20WIP\x20file\x20via\x20curl:','curl\x20-X\x20POST\x20https://api.pinata.cloud/pinning/pinFileToIPFS\x20\x5c','\x20\x20-H\x20\x22Authorization:\x20Bearer\x20<YOUR_PINATA_API_KEY>\x22\x20\x5c','\x20\x20-F\x20\x22file=@\x27'+b+'\x27\x22','//\x204.\x20Pinata\x20returns\x20JSON\x20with\x20\x27IpfsHash\x27\x20(the\x20CID).\x20Extract\x20it:','//\x20\x20\x20\x20Example\x20response:\x20{\x20\x22IpfsHash\x22:\x20\x22QmXYZ...\x22,\x20\x22PinSize\x22:\x2012345,\x20\x22Timestamp\x22:\x20\x22...\x22\x20}','//\x205.\x20Verify\x20the\x20file\x20is\x20reachable\x20via\x20the\x20public\x20gateway:','curl\x20-I\x20https://gateway.pinata.cloud/ipfs/<CID>','//\x206.\x20(Optional)\x20Use\x20ipfs://<CID>\x20as\x20the\x20wip_url\x20—\x20the\x20SDK\x20resolves\x20it.','//\x207.\x20Update\x20your\x20Service\x20on-chain\x20with\x20the\x20IPFS\x20URL\x20or\x20CID:','//\x20\x20\x20\x20Call\x20onchain_operations\x20{\x20operation_type:\x20\x27service\x27,\x20data:\x20{\x20object:\x20\x27<service-id>\x27,\x20sales:\x20{\x20op:\x20\x27set\x27,\x20sales:\x20[{\x20...,\x20wip_url:\x20\x27https://gateway.pinata.cloud/ipfs/<CID>\x27,\x20wip_hash:\x20\x27<hash>\x27\x20}]\x20}\x20}\x20}'],'notes':['Pinata\x20free\x20tier:\x201\x20GB\x20storage,\x20100\x20uploads/day\x20—\x20sufficient\x20for\x20WIP\x20files.','For\x20long-term\x20durability,\x20also\x20pin\x20via\x20another\x20gateway\x20(e.g.,\x20nft.storage).','IPFS\x20CIDs\x20are\x20content-addressed\x20—\x20if\x20the\x20file\x20changes,\x20the\x20CID\x20changes.\x20This\x20is\x20a\x20feature,\x20not\x20a\x20bug.']},{'name':'User\x27s\x20own\x20website\x20/\x20static\x20host','description':'If\x20you\x20already\x20operate\x20a\x20website\x20or\x20static\x20host\x20(e.g.,\x20nginx,\x20Vercel,\x20Netlify,\x20Cloudflare\x20Pages),\x20'+'upload\x20the\x20.wip\x20file\x20there\x20and\x20use\x20its\x20public\x20URL.','difficulty':'medium','free':!![],'result_url_pattern':'https://<your-domain>/<path>/<file>.wip','steps':['//\x201.\x20Copy\x20your\x20local\x20WIP\x20file\x20to\x20your\x20web\x20server\x27s\x20static\x20directory:','scp\x20\x27'+b+'\x27\x20user@your-server:/var/www/html/wowok/'+c,'//\x202.\x20Ensure\x20the\x20server\x20sets\x20Content-Type:\x20application/json\x20(or\x20application/octet-stream)\x20for\x20.wip\x20files.','//\x20\x20\x20\x20For\x20nginx,\x20add\x20to\x20your\x20server\x20block:','//\x20\x20\x20\x20\x20\x20\x20\x20location\x20~\x20\x5c.wip$\x20{\x20default_type\x20application/json;\x20}','//\x203.\x20Verify\x20the\x20file\x20is\x20reachable:','curl\x20-I\x20https://<your-domain>/wowok/'+c,'//\x204.\x20Update\x20your\x20Service\x20on-chain\x20with\x20the\x20new\x20public\x20URL:','//\x20\x20\x20\x20Call\x20onchain_operations\x20{\x20operation_type:\x20\x27service\x27,\x20data:\x20{\x20object:\x20\x27<service-id>\x27,\x20sales:\x20{\x20op:\x20\x27set\x27,\x20sales:\x20[{\x20...,\x20wip_url:\x20\x27https://<your-domain>/wowok/<file>.wip\x27,\x20wip_hash:\x20\x27<hash>\x27\x20}]\x20}\x20}\x20}'],'notes':['Make\x20sure\x20CORS\x20is\x20permissive\x20if\x20the\x20verifier\x20fetches\x20via\x20browser\x20(Access-Control-Allow-Origin:\x20*).','Ensure\x20HTTPS\x20is\x20enabled\x20—\x20most\x20verifiers\x20reject\x20plain\x20HTTP.']},{'name':'Data\x20URL\x20embedding\x20(small\x20files\x20only)','description':'Embed\x20the\x20entire\x20WIP\x20file\x20as\x20a\x20base64\x20data\x20URL\x20directly\x20in\x20the\x20wip_url\x20field.\x20'+'No\x20external\x20hosting\x20required,\x20but\x20on-chain\x20storage\x20cost\x20grows\x20with\x20file\x20size.','difficulty':'easy','free':!![],'result_url_pattern':'data:application/json;base64,<base64-encoded-content>','steps':['//\x201.\x20Encode\x20your\x20local\x20WIP\x20file\x20as\x20a\x20base64\x20data\x20URL:','//\x20\x20\x20\x20On\x20Linux/macOS:','echo\x20\x22data:application/json;base64,$(base64\x20-w0\x20\x27'+b+'\x27)\x22','//\x20\x20\x20\x20On\x20Windows\x20(PowerShell):','$bytes\x20=\x20[System.IO.File]::ReadAllBytes(\x27'+a+'\x27);\x20$b64\x20=\x20[System.Convert]::ToBase64String($bytes);\x20Write-Output\x20\x22data:application/json;base64,$b64\x22','//\x202.\x20Use\x20the\x20resulting\x20data\x20URL\x20as\x20the\x20wip_url\x20field\x20when\x20updating\x20the\x20Service.','//\x203.\x20Note:\x20data\x20URLs\x20are\x20NOT\x20recommended\x20for\x20files\x20>\x2050\x20KB\x20due\x20to\x20on-chain\x20storage\x20cost.'],'notes':['Only\x20suitable\x20for\x20very\x20small\x20WIP\x20files\x20(typically\x20<\x2010\x20KB).','Data\x20URLs\x20cannot\x20be\x20updated\x20without\x20an\x20on-chain\x20transaction\x20—\x20content\x20is\x20literally\x20embedded.','Prefer\x20GitHub\x20Pages\x20or\x20IPFS\x20for\x20files\x20>\x2010\x20KB.']}];}export function analyzeWipDeployment(a){const b=classifyWipPath(a),c=b['is_local'];let d,e=[];if(c)b['type']==='local_http'?d='The\x20WIP\x20URL\x20\x27'+a+'\x27\x20is\x20a\x20'+b['description']+'.\x20'+'It\x20is\x20reachable\x20only\x20from\x20the\x20merchant\x27s\x20own\x20machine/LAN\x20—\x20customers\x20and\x20'+'on-chain\x20verifiers\x20on\x20other\x20machines\x20CANNOT\x20fetch\x20it.\x20Storing\x20it\x20on-chain\x20'+'makes\x20every\x20customer\x20order\x20fail.\x20'+'Deploy\x20the\x20.wip\x20file\x20to\x20a\x20public\x20host\x20(GitHub\x20Pages,\x20IPFS,\x20or\x20your\x20own\x20website)\x20'+'and\x20update\x20the\x20Service\x27s\x20wip_url\x20with\x20the\x20public\x20URL.':d='The\x20WIP\x20path\x20\x27'+a+'\x27\x20is\x20a\x20LOCAL\x20'+b['type']+'\x20path.\x20'+'Local\x20paths\x20stored\x20on-chain\x20are\x20unreachable\x20by\x20customers\x20and\x20verifiers.\x20'+'Deploy\x20the\x20.wip\x20file\x20to\x20a\x20public\x20host\x20(GitHub\x20Pages,\x20IPFS,\x20or\x20your\x20own\x20website)\x20'+'and\x20update\x20the\x20Service\x27s\x20wip_url\x20with\x20the\x20public\x20URL.',e=getDeployOptions(a);else{if(b['type']==='http_url')d='The\x20WIP\x20path\x20is\x20an\x20HTTP(S)\x20URL\x20—\x20verify\x20the\x20server\x20returns\x20200.\x20'+'If\x20the\x20URL\x20returns\x20404/403,\x20the\x20file\x20may\x20have\x20been\x20moved\x20or\x20deleted.',e=[];else{if(b['type']==='ipfs')d='The\x20WIP\x20path\x20is\x20an\x20IPFS\x20URL\x20—\x20verify\x20the\x20gateway\x20is\x20responsive.\x20'+'If\x20the\x20CID\x20is\x20unreachable,\x20the\x20file\x20may\x20have\x20been\x20unpinned.',e=[];else b['type']==='data_url'?(d='The\x20WIP\x20path\x20is\x20a\x20data\x20URL\x20—\x20content\x20is\x20embedded,\x20no\x20deployment\x20needed.',e=[]):(d='Unrecognized\x20WIP\x20path\x20format:\x20\x27'+a+'\x27',e=[]);}}return{'path':a,'classification':b,'needs_deployment':c,'reason':d,'options':e,'remind_update_hash':c};}export function formatDeployHints(a){if(!a['needs_deployment']&&a['options']['length']===0x0)return'';const b=[];b['push']('===\x20WIP\x20Deployment\x20Assistance\x20==='),b['push'](''),b['push']('Path:\x20'+a['path']),b['push']('Type:\x20'+a['classification']['description']),b['push']('Reason:\x20'+a['reason']),b['push']('');if(a['options']['length']>0x0){b['push']('Recommended\x20deployment\x20options:'),b['push']('');for(const c of a['options']){b['push']('▶\x20'+c['name']+'\x20(difficulty:\x20'+c['difficulty']+',\x20free:\x20'+c['free']+')'),b['push']('\x20\x20'+c['description']),b['push']('\x20\x20Resulting\x20URL\x20pattern:\x20'+c['result_url_pattern']),b['push']('\x20\x20Steps:');for(const d of c['steps']){b['push']('\x20\x20\x20\x20'+d);}if(c['notes']&&c['notes']['length']>0x0){b['push']('\x20\x20Notes:');for(const e of c['notes']){b['push']('\x20\x20\x20\x20-\x20'+e);}}b['push']('');}}return a['remind_update_hash']&&(b['push']('⚠️\x20After\x20deploying,\x20compute\x20the\x20new\x20WIP\x20hash\x20and\x20update\x20the\x20Service:'),b['push']('\x20\x201.\x20Re-run\x20wip_file\x20{\x20type:\x20\x27verify\x27,\x20wipFilePath:\x20\x27<new-public-url>\x27\x20}\x20to\x20confirm\x20the\x20file\x20is\x20reachable.'),b['push']('\x20\x202.\x20Extract\x20the\x20meta.hash\x20from\x20the\x20WIP\x20file\x20(or\x20use\x20wip_file\x20{\x20type:\x20\x27verify\x27\x20}\x20result).'),b['push']('\x20\x203.\x20Update\x20the\x20Service\x20on-chain:\x20onchain_operations\x20{\x20operation_type:\x20\x27service\x27,\x20data:\x20{\x20object:\x20\x27<service-id>\x27,\x20sales:\x20{\x20op:\x20\x27set\x27,\x20sales:\x20[{\x20...,\x20wip_url:\x20\x27<new-public-url>\x27,\x20wip_hash:\x20\x27<hash>\x27\x20}]\x20}\x20}\x20}'),b['push']('')),b['push']('==============================='),b['join']('\x0a');}