nagoc-zerowork 1.1.18 → 1.1.20

package/README.md

@@ -86,7 +86,7 @@ Just ask:
 
 Claude will pause and ask you to choose between two styles:
 1. **Interactive HTML**: Claude writes a premium, self-contained HTML file. Save it and open it in your browser to see a stunning Interactive Blueprint where you can click on any block to see the exact ZeroWork settings!
-2. **Mermaid Flowchart**: Claude renders a visual, native Mermaid flowchart directly inside your chat window so you can view it instantly without leaving the app.
+2. **Mermaid Flowchart**: Claude outputs the raw copyable Mermaid code block as text, so you can easily copy and paste it into Draw.io, Mermaid Live Editor, or any other software.
 
 Because this MCP enforces strict ZeroWork naming rules, Claude will always use the exact building block names (e.g., *Launch Browser*, *Start Repeat*) in its diagrams.
 

package/dist/index.js

@@ -9309,7 +9309,7 @@ Like this, you can just run it, you can schedule it to run as much as you like.
 When a user asks you to build, draw, or generate a diagram or flowchart for a ZeroWork workflow, you MUST follow these instructions STRICTLY:
 
 #### 1. ASK FOR THE FORMAT BEFORE GENERATING
-You must STOP and ask the user: "Would you like a native Mermaid chart rendered here in the chat, or a premium interactive HTML file that you can save to your computer?"
+You must STOP and ask the user: "Would you like a copyable Mermaid chart code as text, or a premium interactive HTML file that you can save to your computer?"
 DO NOT generate any code until the user answers this question.
 
 #### 2. EXACT ZERO-WORK BLOCK NAMES
@@ -9332,11 +9332,12 @@ Do not invent block names. Use the exact UI names found in ZeroWork.
 
 ### If the User Chooses: MERMAID CHART
 Generate a production-ready Mermaid.js diagram adhering strictly to these standards:
-1. **Orientation & Flow:** Use \`graph LR\` (Left-to-Right) for logical, sequential, or decision-heavy workflows to prevent vertical stretching. Only use \`graph TD\` if the process is strictly hierarchical.
-2. **Visual Hierarchy (Subgraphs):** Cluster related steps into logical phases using \`subgraph\` blocks (e.g., [Setup/Auth], [Core Processing], [Error Handling]).
-3. **Routing & Branching Logic:** Keep the primary "Happy Path" moving linearly through the center. Route alternative paths and errors cleanly to the sides.
-4. **Clarity:** Keep text inside shapes short and action-oriented. Use standard shapes: \`[Rectangles]\` for actions, \`{"Diamonds"}\` for decisions, \`([Ovals])\` for start/end.
-5. **Modern Styling:** Apply a clean, professional color palette using Mermaid \`style\` or \`classDef\`. Use muted green for success, soft blue for operations, light yellow for decisions, and soft red for errors.
+1. **Output Format:** You MUST wrap the Mermaid code inside a standard text code block (using \`\`\`text ... \`\`\`) rather than \`\`\`mermaid. This ensures the chat client displays the raw Mermaid syntax as copyable text instead of rendering it visually, so the user can easily copy and paste the code into Draw.io, Mermaid Live Editor, or other software.
+2. **Orientation & Flow:** Use \`graph LR\` (Left-to-Right) for logical, sequential, or decision-heavy workflows to prevent vertical stretching. Only use \`graph TD\` if the process is strictly hierarchical.
+3. **Visual Hierarchy (Subgraphs):** Cluster related steps into logical phases using \`subgraph\` blocks (e.g., [Setup/Auth], [Core Processing], [Error Handling]).
+4. **Routing & Branching Logic:** Keep the primary "Happy Path" moving linearly through the center. Route alternative paths and errors cleanly to the sides.
+5. **Clarity:** Keep text inside shapes short and action-oriented. Use standard shapes: \`[Rectangles]\` for actions, \`{"Diamonds"}\` for decisions, \`([Ovals])\` for start/end.
+6. **Modern Styling:** Apply a clean, professional color palette using Mermaid \`style\` or \`classDef\`. Use muted green for success, soft blue for operations, light yellow for decisions, and soft red for errors.
 
 ---
 
@@ -9346,7 +9347,8 @@ You must use the EXACT HTML, CSS, and JS structure provided in the template belo
 Your job is to:
 1. Update the \`<header>\` and \`<footer>\` titles/descriptions.
 2. Mathematically generate the SVG \`<path>\` (edges) and \`<g>\` (nodes) coordinates so they form a beautiful flowchart matching the workflow logic. Ensure lines connect properly without crossing poorly.
-3. Update the \`const DATA = { ... }\` block in the JavaScript with the exact configurations of the blocks you plotted in the SVG (ensure the \`data-id\` in the SVG matches the keys in the \`DATA\` object).
+3. **Dynamic viewBox & Padding**: Calculate the total bounding box of all plotted nodes, paths, and swimlanes. You MUST dynamically update the SVG \`viewBox="0 0 [width] [calculated_height]"\` attribute so that all elements fit perfectly, leaving at least 60px-100px of extra padding/margin at the bottom and sides. Absolutely no element should be cut off or clipped at the borders.
+4. Update the \`const DATA = { ... }\` block in the JavaScript with the exact configurations of the blocks you plotted in the SVG (ensure the \`data-id\` in the SVG matches the keys in the \`DATA\` object).
 
 **HTML BLUEPRINT TEMPLATE:**
 \`\`\`html
@@ -9373,7 +9375,7 @@ Your job is to:
   .wrap{display:grid;grid-template-columns:minmax(0,1fr) 380px;gap:18px;padding:18px 28px 28px}
   @media (max-width:1100px){.wrap{grid-template-columns:1fr}}
   .canvas{background:var(--panel);border:1px solid var(--line);border-radius:16px;overflow:hidden;position:relative;min-height:760px}
-  .canvas svg{display:block;width:100%;height:100%}
+  .canvas svg{display:block;width:100%;height:auto}
   .panel{background:var(--panel);border:1px solid var(--line);border-radius:16px;padding:18px;position:sticky;top:18px;height:max-content;max-height:calc(100vh - 36px);overflow:auto}
   .panel h2{margin:0 0 4px;font-size:16px}
   .panel .sub{color:var(--muted);font-size:12px;margin-bottom:14px}
@@ -9419,7 +9421,7 @@ Your job is to:
 <div class="wrap">
   <div class="canvas">
     <!-- YOU MUST PLOT THE SVG NODES, EDGES, AND SWIMLANES HERE -->
-    <svg viewBox="0 0 1100 1480" preserveAspectRatio="xMidYMin meet" id="flow">
+    <svg viewBox="0 0 1100 [Calculated Height]" preserveAspectRatio="xMidYMin meet" id="flow">
       <defs>
         <marker id="arr" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" class="arrow"/></marker>
         <marker id="arrT" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" class="arrow true"/></marker>
@@ -9487,7 +9489,7 @@ render('n1');
 </body>
 </html>
 \`\`\`
-`;var N_=()=>{let t=process.env.ZEROWORK_BOTS;if(!t)return{};try{return JSON.parse(t)}catch{return console.error("Failed to parse ZEROWORK_BOTS environment variable. Must be valid JSON."),{}}},ho=new Er({name:"nagoc-zerowork",version:"1.1.18"},{capabilities:{tools:{},resources:{}}});function Ui(){return af}ho.setRequestHandler(Na,async()=>{let e=Ui().map(n=>({uri:`resource://zerowork/tutorials/${n.id}`,name:`ZeroWork Video Tutorial: ${n.title}`,mimeType:"text/plain",description:`Official video masterclass transcript for: ${n.title}`}));return{resources:[{uri:"resource://zerowork/general",name:"ZeroWork General Knowledge",mimeType:"text/plain",description:"General concepts about ZeroWork RPA, TaskBots, and Architecture"},{uri:"resource://zerowork/webhooks",name:"ZeroWork Webhooks Guide",mimeType:"text/plain",description:"How to trigger ZeroWork bots and pass dynamic data via webhooks"},{uri:"resource://zerowork/variables",name:"ZeroWork Variables Guide",mimeType:"text/plain",description:"How variables work in ZeroWork"},{uri:"resource://zerowork/tables",name:"ZeroWork Tables Guide",mimeType:"text/plain",description:"How data tables work in ZeroWork"},{uri:"resource://zerowork/selectors",name:"ZeroWork Selectors Guide",mimeType:"text/plain",description:"How CSS and XPath selectors work in ZeroWork"},{uri:"resource://zerowork/loops",name:"ZeroWork Loops Guide",mimeType:"text/plain",description:"How loops and repeats work in ZeroWork"},{uri:"resource://zerowork/chatgpt",name:"ZeroWork ChatGPT Guide",mimeType:"text/plain",description:"How to integrate ChatGPT via Ask ChatGPT block"},{uri:"resource://zerowork/anti_bot",name:"ZeroWork Anti-Bot Guide",mimeType:"text/plain",description:"Best practices to avoid bot detection and handle dynamic states"},{uri:"resource://zerowork/troubleshooting",name:"ZeroWork Troubleshooting Guide",mimeType:"text/plain",description:"Common problems and troubleshooting steps"},{uri:"resource://zerowork/building_blocks",name:"ZeroWork Building Blocks Guide",mimeType:"text/plain",description:"Comprehensive catalog of all ZeroWork building blocks and their options"},{uri:"resource://zerowork/dynamic_inputs",name:"ZeroWork Dynamic Inputs Guide",mimeType:"text/plain",description:"How to use dynamic inputs: variable/table references, code expressions, code blocks, and spintax in ZeroWork building blocks"},{uri:"resource://zerowork/visual_insights",name:"ZeroWork Visual Insights and Troubleshooting",mimeType:"text/plain",description:"Comprehensive visual documentation and troubleshooting guide for ZeroWork covering over 140 common scenarios."},...e]}});ho.setRequestHandler(Ma,async t=>{let e=t.params.uri,n="";if(e.startsWith("resource://zerowork/tutorials/")){let o=e.replace("resource://zerowork/tutorials/",""),a=Ui().find(s=>s.id===o);if(!a)throw new Error(`Tutorial resource not found: ${e}`);n=`=== ${a.title} ===
+`;var N_=()=>{let t=process.env.ZEROWORK_BOTS;if(!t)return{};try{return JSON.parse(t)}catch{return console.error("Failed to parse ZEROWORK_BOTS environment variable. Must be valid JSON."),{}}},ho=new Er({name:"nagoc-zerowork",version:"1.1.20"},{capabilities:{tools:{},resources:{}}});function Ui(){return af}ho.setRequestHandler(Na,async()=>{let e=Ui().map(n=>({uri:`resource://zerowork/tutorials/${n.id}`,name:`ZeroWork Video Tutorial: ${n.title}`,mimeType:"text/plain",description:`Official video masterclass transcript for: ${n.title}`}));return{resources:[{uri:"resource://zerowork/general",name:"ZeroWork General Knowledge",mimeType:"text/plain",description:"General concepts about ZeroWork RPA, TaskBots, and Architecture"},{uri:"resource://zerowork/webhooks",name:"ZeroWork Webhooks Guide",mimeType:"text/plain",description:"How to trigger ZeroWork bots and pass dynamic data via webhooks"},{uri:"resource://zerowork/variables",name:"ZeroWork Variables Guide",mimeType:"text/plain",description:"How variables work in ZeroWork"},{uri:"resource://zerowork/tables",name:"ZeroWork Tables Guide",mimeType:"text/plain",description:"How data tables work in ZeroWork"},{uri:"resource://zerowork/selectors",name:"ZeroWork Selectors Guide",mimeType:"text/plain",description:"How CSS and XPath selectors work in ZeroWork"},{uri:"resource://zerowork/loops",name:"ZeroWork Loops Guide",mimeType:"text/plain",description:"How loops and repeats work in ZeroWork"},{uri:"resource://zerowork/chatgpt",name:"ZeroWork ChatGPT Guide",mimeType:"text/plain",description:"How to integrate ChatGPT via Ask ChatGPT block"},{uri:"resource://zerowork/anti_bot",name:"ZeroWork Anti-Bot Guide",mimeType:"text/plain",description:"Best practices to avoid bot detection and handle dynamic states"},{uri:"resource://zerowork/troubleshooting",name:"ZeroWork Troubleshooting Guide",mimeType:"text/plain",description:"Common problems and troubleshooting steps"},{uri:"resource://zerowork/building_blocks",name:"ZeroWork Building Blocks Guide",mimeType:"text/plain",description:"Comprehensive catalog of all ZeroWork building blocks and their options"},{uri:"resource://zerowork/dynamic_inputs",name:"ZeroWork Dynamic Inputs Guide",mimeType:"text/plain",description:"How to use dynamic inputs: variable/table references, code expressions, code blocks, and spintax in ZeroWork building blocks"},{uri:"resource://zerowork/visual_insights",name:"ZeroWork Visual Insights and Troubleshooting",mimeType:"text/plain",description:"Comprehensive visual documentation and troubleshooting guide for ZeroWork covering over 140 common scenarios."},...e]}});ho.setRequestHandler(Ma,async t=>{let e=t.params.uri,n="";if(e.startsWith("resource://zerowork/tutorials/")){let o=e.replace("resource://zerowork/tutorials/",""),a=Ui().find(s=>s.id===o);if(!a)throw new Error(`Tutorial resource not found: ${e}`);n=`=== ${a.title} ===
 
 ${a.content}`}else if(e==="resource://zerowork/general")n=_e.general;else if(e==="resource://zerowork/webhooks")n=_e.webhooks;else if(e==="resource://zerowork/variables")n=_e.variables;else if(e==="resource://zerowork/tables")n=_e.tables;else if(e==="resource://zerowork/selectors")n=_e.selectors;else if(e==="resource://zerowork/loops")n=_e.loops;else if(e==="resource://zerowork/chatgpt")n=_e.chatgpt;else if(e==="resource://zerowork/anti_bot")n=_e.anti_bot;else if(e==="resource://zerowork/troubleshooting")n=_e.troubleshooting;else if(e==="resource://zerowork/building_blocks")n=_e.building_blocks;else if(e==="resource://zerowork/dynamic_inputs")n=_e.dynamic_inputs;else if(e==="resource://zerowork/visual_insights")n=_e.visual_insights;else throw new Error(`Resource not found: ${e}`);return{contents:[{uri:e,mimeType:"text/plain",text:n}]}});ho.setRequestHandler(Fa,async()=>({tools:[{name:"list_taskbots",description:"Lists all configured TaskBots and their names that are available to trigger.",inputSchema:{type:"object",properties:{}}},{name:"trigger_taskbot",description:"Triggers a specific ZeroWork TaskBot by its configured name. Does not send data.",inputSchema:{type:"object",properties:{botName:{type:"string",description:"The name of the TaskBot to trigger (must be one from list_taskbots)"}},required:["botName"]}},{name:"trigger_taskbot_with_data",description:"Triggers a specific ZeroWork TaskBot and sends dynamic JSON data to its zw_webhook_data variable.",inputSchema:{type:"object",properties:{botName:{type:"string",description:"The name of the TaskBot to trigger"},payload:{type:"object",description:"The JSON object payload to send to the bot"}},required:["botName","payload"]}},{name:"trigger_webhook_url",description:"Triggers an arbitrary ZeroWork webhook URL directly.",inputSchema:{type:"object",properties:{url:{type:"string",description:"The full ZeroWork webhook URL"},payload:{type:"object",description:"Optional JSON object payload to send to the bot"}},required:["url"]}},{name:"generate_robust_selector",description:"Analyzes an HTML snippet and target requirements to generate robust, non-brittle CSS and XPath selectors tailored for ZeroWork TaskBots.",inputSchema:{type:"object",properties:{htmlSnippet:{type:"string",description:"The raw HTML snippet containing the target element and its surrounding container hierarchy."},targetText:{type:"string",description:"Optional exact or partial visible text of the target element (e.g., 'Connect', 'Follow')."},description:{type:"string",description:"Optional description of what the element is or its context (e.g., 'The experience list container on LinkedIn', 'Submit button on a dynamic form')."}},required:["htmlSnippet"]}},{name:"get_mcp_version",description:"Returns the version of this MCP server package currently running.",inputSchema:{type:"object",properties:{}}},{name:"search_zerowork_docs",description:"Search and query the ENTIRE ZeroWork official documentation at docs.zerowork.io. Use this tool for ANY question about ZeroWork including features, building blocks, dynamic inputs, TaskBots, spintax, variables, code in inputs, agents, triggers, actions, conditions, loops, integrations, webhooks, selectors, device storage, or any how-to guides. ALWAYS use this tool before answering any ZeroWork-related questions. IMPORTANT: If the user is asking about specific automation workflows, step-by-step use cases (e.g. WhatsApp, LinkedIn, cold outreach), or advanced selector strategies, you MUST ALSO call search_zerowork_tutorials to check the expert video masterclass knowledge base!",inputSchema:{type:"object",properties:{question:{type:"string",description:"The natural language question to search the docs for"}},required:["question"]}},{name:"search_zerowork_tutorials",description:"Search and query the complete library of official ZeroWork video masterclasses, tutorial transcripts, and expert automation guides. ALWAYS call this tool when the user asks about specific automation workflows, step-by-step use cases (e.g., WhatsApp, LinkedIn, cold outreach, lead generation), advanced CSS selector walkthroughs, or dynamic loop setups, EVEN IF the user does not explicitly mention the words 'tutorials', 'videos', or 'guides'.",inputSchema:{type:"object",properties:{query:{type:"string",description:"The natural language search query or keywords to find in the video tutorials"}},required:["query"]}},{name:"get_diagram_design_rules",description:"Call this tool IMMEDIATELY whenever the user asks you to generate, draw, or build a diagram or flowchart for a ZeroWork workflow. It contains the routing instructions, HTML templates, and Mermaid rules you must follow.",inputSchema:{type:"object",properties:{}}}]}));ho.setRequestHandler(Rn,async t=>{let{name:e,arguments:n}=t.params,o=N_();try{if(e==="list_taskbots"){let r=Object.keys(o);return r.length===0?{content:[{type:"text",text:'No TaskBots are configured. Please set the ZEROWORK_BOTS environment variable in your Claude config (e.g., {"myBot": "https://hook.zerowork.io/..."}).'}]}:{content:[{type:"text",text:`Configured TaskBots:
 ${r.map(a=>`- ${a}`).join(`
@@ -9528,7 +9530,7 @@ ${r.slice(0,500)}${r.length>500?`
 ... (truncated)`:""}
 \`\`\`
 
-`,i+="*Guidance*: Use the strategies above to construct your selector in ZeroWork. Test the selector in your browser console using `document.querySelectorAll('your-selector')` to verify uniqueness before adding it to your TaskBot.",{content:[{type:"text",text:i}]}}if(e==="get_mcp_version")return{content:[{type:"text",text:"nagoc-zerowork version 1.1.18"}]};if(e==="get_diagram_design_rules")return{content:[{type:"text",text:sf}]};if(e==="search_zerowork_tutorials"){let r=String(n?.query||"");if(!r)throw new Error("The 'query' parameter is required.");let a=Ui();if(a.length===0)return{content:[{type:"text",text:"No video tutorial subtitles found. Please check that subtitle files are bundled correctly."}]};let s=r.toLowerCase(),i=s.split(/\s+/).filter(h=>h.length>1),l=a.map(h=>{let d=0,p=h.title.toLowerCase(),m=h.content.toLowerCase();return p.includes(s)&&(d+=10),m.includes(s)&&(d+=5),i.forEach(w=>{p.includes(w)&&(d+=3);let y=m.match(new RegExp(w,"g"));y&&(d+=y.length)}),{tutorial:h,score:d}}).filter(h=>h.score>0).sort((h,d)=>d.score-h.score);if(l.length===0)return{content:[{type:"text",text:`No tutorial subtitles matched the query "${r}". Try searching with different keywords or use search_zerowork_docs for official written documentation.`}]};let c=l.slice(0,5),u=`### \u{1F3AC} ZeroWork Video Tutorial Search Results
+`,i+="*Guidance*: Use the strategies above to construct your selector in ZeroWork. Test the selector in your browser console using `document.querySelectorAll('your-selector')` to verify uniqueness before adding it to your TaskBot.",{content:[{type:"text",text:i}]}}if(e==="get_mcp_version")return{content:[{type:"text",text:"nagoc-zerowork version 1.1.20"}]};if(e==="get_diagram_design_rules")return{content:[{type:"text",text:sf}]};if(e==="search_zerowork_tutorials"){let r=String(n?.query||"");if(!r)throw new Error("The 'query' parameter is required.");let a=Ui();if(a.length===0)return{content:[{type:"text",text:"No video tutorial subtitles found. Please check that subtitle files are bundled correctly."}]};let s=r.toLowerCase(),i=s.split(/\s+/).filter(h=>h.length>1),l=a.map(h=>{let d=0,p=h.title.toLowerCase(),m=h.content.toLowerCase();return p.includes(s)&&(d+=10),m.includes(s)&&(d+=5),i.forEach(w=>{p.includes(w)&&(d+=3);let y=m.match(new RegExp(w,"g"));y&&(d+=y.length)}),{tutorial:h,score:d}}).filter(h=>h.score>0).sort((h,d)=>d.score-h.score);if(l.length===0)return{content:[{type:"text",text:`No tutorial subtitles matched the query "${r}". Try searching with different keywords or use search_zerowork_docs for official written documentation.`}]};let c=l.slice(0,5),u=`### \u{1F3AC} ZeroWork Video Tutorial Search Results
 
 *Crawled from official video masterclasses and automation guides*
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nagoc-zerowork",
-  "version": "1.1.18",
+  "version": "1.1.20",
   "description": "An MCP Server for ZeroWork.io — trigger TaskBots, send dynamic data via webhooks, and get full ZeroWork documentation",
   "main": "dist/index.js",
   "type": "module",