@pinepaper.studio/mcp-server 1.5.1 → 1.5.4

package/dist/tools/handlers/tool-guide.js

@@ -0,0 +1,52 @@
+/**
+ * Tool guide handler — extracted from src/tools/handlers.ts.
+ *
+ * Returns the full AI Agent Guide when called with no args, the verbose
+ * description for a specific tool when given a tool name, or every tool in
+ * a category when given a category. Uses dynamic imports for the tool list
+ * + tag map so the module load cost only hits when the guide is actually
+ * requested.
+ */
+import { ToolGuideInputSchema } from '../../types/schemas.js';
+export const toolGuideHandlers = {
+    pinepaper_tool_guide: async (args, _options) => {
+        const input = ToolGuideInputSchema.parse(args);
+        const { PINEPAPER_TOOLS, AI_AGENT_GUIDE } = await import('../definitions.js');
+        const { TOOL_TAGS } = await import('../toolkits.js');
+        // No args → full AI Agent Guide
+        if (!input.tool && !input.category) {
+            return { content: [{ type: 'text', text: AI_AGENT_GUIDE }] };
+        }
+        // Specific tool → full verbose description
+        if (input.tool) {
+            const tool = PINEPAPER_TOOLS.find((t) => t.name === input.tool);
+            if (!tool) {
+                return {
+                    content: [{ type: 'text', text: `Unknown tool: ${input.tool}. Use pinepaper_tool_guide with no args to see the AI Agent Guide.` }],
+                    isError: true,
+                };
+            }
+            return { content: [{ type: 'text', text: `# ${tool.name}\n\n${tool.description}` }] };
+        }
+        // Category → all tools in that tag with descriptions
+        if (input.category) {
+            const toolNames = TOOL_TAGS[input.category];
+            if (!toolNames) {
+                const available = Object.keys(TOOL_TAGS).join(', ');
+                return {
+                    content: [{ type: 'text', text: `Unknown category: ${input.category}. Available: ${available}` }],
+                    isError: true,
+                };
+            }
+            const lines = [`# Category: ${input.category}\n`];
+            for (const name of toolNames) {
+                const tool = PINEPAPER_TOOLS.find((t) => t.name === name);
+                if (tool)
+                    lines.push(`## ${tool.name}\n${tool.description}\n`);
+            }
+            return { content: [{ type: 'text', text: lines.join('\n') }] };
+        }
+        return { content: [{ type: 'text', text: AI_AGENT_GUIDE }] };
+    },
+};
+//# sourceMappingURL=tool-guide.js.map

package/dist/tools/handlers/tool-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-guide.js","sourceRoot":"","sources":["../../../src/tools/handlers/tool-guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAO9D,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,oBAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC7C,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC9E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAErD,gCAAgC;QAChC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAC/D,CAAC;QAED,2CAA2C;QAC3C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC;YAClF,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,KAAK,CAAC,IAAI,oEAAoE,EAAE,CAAC;oBAClI,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC;QACxF,CAAC;QAED,qDAAqD;QACrD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpD,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,KAAK,CAAC,QAAQ,gBAAgB,SAAS,EAAE,EAAE,CAAC;oBACjG,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAa,CAAC,eAAe,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;YAC5D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;gBAC5E,IAAI,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACjE,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;IAC/D,CAAC;CACF,CAAC"}

package/dist/tools/handlers.d.ts

@@ -8,6 +8,7 @@
 import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { I18nManager } from '../i18n/index.js';
 import { PinePaperBrowserController } from '../browser/puppeteer-controller.js';
+import { ErrorContext } from '../execution/index.js';
 /**
  * Screenshot modes for performance optimization.
  * Based on best practices: "Take 1 screenshot per creative task, not per operation"
@@ -51,5 +52,22 @@ export interface HandlerOptions {
     /** Execution mode: 'puppeteer' (default) or 'code' (generate only) */
     executionMode?: ExecutionMode;
 }
+export declare function errorResult(code: string, message: string, details?: unknown, context?: ErrorContext): CallToolResult;
+/**
+ * Execute code in browser if connected, otherwise return generated code.
+ *
+ * Execution mode is controlled by PINEPAPER_EXECUTION_MODE environment variable:
+ * - 'puppeteer': Execute code in browser via Puppeteer (default)
+ * - 'code': Generate code only - user copies/pastes into PinePaper console
+ *
+ * Screenshot behavior is controlled by PINEPAPER_SCREENSHOT_MODE environment variable:
+ * - 'on_request': No automatic screenshots (use pinepaper_browser_screenshot explicitly)
+ * - 'always': Take screenshot after every execution (legacy, slower)
+ * - 'never': Never take screenshots
+ *
+ * Default is 'on_request' for optimal performance per best practices.
+ */
+export declare function executeOrGenerate(code: string, description: string, options: HandlerOptions, toolName: string): Promise<CallToolResult>;
+export declare function getLocalizedSuccessMessage(i18n: I18nManager | undefined, key: string, params: Record<string, string | number>): string;
 export declare function handleToolCall(toolName: string, args: Record<string, unknown>, options?: HandlerOptions): Promise<CallToolResult>;
 //# sourceMappingURL=handlers.d.ts.map

package/dist/tools/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAA6B,MAAM,oCAAoC,CAAC;AAyG/F,OAAO,EAAE,WAAW,EAAW,MAAM,kBAAkB,CAAC;AACxD,OAAO,EACL,0BAA0B,EAG3B,MAAM,oCAAoC,CAAC;AAS5C;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAOlD;AAuFD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAOhD;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;IAC/C,oEAAoE;IACpE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sEAAsE;IACtE,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAoaD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAkBzB"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAA6B,MAAM,oCAAoC,CAAC;AAsI/F,OAAO,EAAE,WAAW,EAAW,MAAM,kBAAkB,CAAC;AACxD,OAAO,EACL,0BAA0B,EAI3B,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,YAAY,EAA0C,MAAM,uBAAuB,CAAC;AA4B7F;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAOlD;AA+CD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAOhD;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;IAC/C,oEAAoE;IACpE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sEAAsE;IACtE,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AA6DD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAwBhB;AAyBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAmMzB;AAMD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,MAAM,CASR;AA0ED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAkBzB"}