@wowok/agent-mcp 2.7.1 → 2.7.3

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

@@ -1,306 +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?:\/\/(localhost|127\.0\.0\.1|\[::1\]|0\.0\.0\.0)([:/]|$)/i.test(path)) {
-        return {
-            type: "local_http",
-            is_local: true,
-            is_network: false,
-            description: "Local HTTP URL (localhost/loopback) — reachable only on this machine, NOT by customers",
-        };
-    }
-    const privateIpRe = /^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 (privateIpRe.test(path)) {
-        return {
-            type: "local_http",
-            is_local: true,
-            is_network: false,
-            description: "LAN HTTP URL (private IP) — reachable only on the local network, NOT by customers",
-        };
-    }
-    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) {
-        if (classification.type === "local_http") {
-            reason =
-                `The WIP URL '${path}' is a ${classification.description}. ` +
-                    "It is reachable only from the merchant's own machine/LAN — customers and " +
-                    "on-chain verifiers on other machines CANNOT fetch it. Storing it on-chain " +
-                    "makes every customer order fail. " +
-                    "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.";
-        }
-        else {
-            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');}