@casys/mcp-erpnext 3.2.2 → 3.3.0

package/README.md

@@ -10,13 +10,16 @@ English | [繁體中文](README.zh-TW.md)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
 > [!IMPORTANT]
-> **Installing 3.2:** for npm/Node use `npx -y @casys/mcp-erpnext@latest`; for
-> Deno use `deno run -A jsr:@casys/mcp-erpnext@3.2.2/server`. 3.2.2 is the
+> **Installing 3.3:** for npm/Node use `npx -y @casys/mcp-erpnext@latest`; for
+> Deno use `deno run -A jsr:@casys/mcp-erpnext@3.3.0/server`. 3.3.0 is the
 > stable release and carries npm's `latest` tag; prereleases, when published,
-> use the `next` tag. 3.2 adds the generic document viewer and attachment
-> workflows, so test it with the MCP host your users actually run before
-> replacing an existing deployment. See the [CHANGELOG](CHANGELOG.md) for
-> release history.
+> use the `next` tag. 3.3 adds graduated selection to the active context: list
+> checkboxes, select-all over the filtered rows, Shift-click ranges and
+> Ctrl/Cmd-click toggles, compact records for one to three selections,
+> references up to eight and a single `erpnext_doc_list` query item beyond.
+> Chart clicks snap to the nearest point in their column. Test it with the MCP
+> host your users actually run before replacing an existing deployment. See the
+> [CHANGELOG](CHANGELOG.md) for release history.
 
 Let any MCP-compatible AI agent operate your [ERPNext](https://erpnext.com) /
 Frappe instance — documents, workflows, and interactive viewers inside the host
@@ -96,7 +99,7 @@ stable 3.0.5 and 3.1.0 releases. Features remain capability-gated by the MCP
 host; Buy evidence does not purchase or qualify a live ERP.
 
 For stable npm installations use `@casys/mcp-erpnext@latest`; for Deno use
-`jsr:@casys/mcp-erpnext@3.2.2/server`.
+`jsr:@casys/mcp-erpnext@3.3.0/server`.
 
 See the [CHANGELOG](CHANGELOG.md) for the full release history, or the
 [latest release](https://github.com/Casys-AI/mcp-erpnext/releases/latest) for

package/mcp-erpnext.mjs

@@ -42720,6 +42720,7 @@ var FrappeClient = class {
   async requestOnce(method, path, body, multipart = false, signal) {
     const controller = new AbortController();
     const detach = relayAbort(signal, controller);
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
     try {
       return await this.sendOnce(
         method,
@@ -42730,12 +42731,12 @@ var FrappeClient = class {
         signal
       );
     } finally {
+      clearTimeout(timer);
       detach();
     }
   }
   async sendOnce(method, path, body, multipart, controller, callerSignal) {
     const url2 = `${this.baseUrl}${path}`;
-    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
     let response;
     try {
       response = await fetch(url2, {
@@ -42745,7 +42746,6 @@ var FrappeClient = class {
         signal: controller.signal
       });
     } catch (err) {
-      clearTimeout(timer);
       if (err instanceof Error && err.name === "AbortError") {
         if (callerSignal?.aborted) throw callerAbortError(method, path);
         throw new FrappeAPIError(
@@ -42760,12 +42760,18 @@ var FrappeClient = class {
         null
       );
     }
-    clearTimeout(timer);
     let rawText;
     try {
       rawText = await response.text();
     } catch (err) {
       if (callerSignal?.aborted) throw callerAbortError(method, path);
+      if (err instanceof Error && err.name === "AbortError") {
+        throw new FrappeAPIError(
+          `Request timed out after ${this.timeoutMs}ms: ${method} ${path}`,
+          408,
+          null
+        );
+      }
       throw err;
     }
     const contentType = response.headers.get("content-type") ?? "";
@@ -44473,6 +44479,9 @@ var salesTools = [
   }
 ];
 
+// src/ui/doc-list-defaults.ts
+var DOC_LIST_DEFAULT_LIMIT = 20;
+
 // src/tools/errors.ts
 var ToolInputError = class extends Error {
   tool;
@@ -44506,7 +44515,6 @@ function formatToolInputError(tool, code, detail, recovery) {
 }
 
 // src/tools/doc-list-query.ts
-var DOC_LIST_DEFAULT_LIMIT = 20;
 var DEFAULT_ORDER_BY = "modified desc";
 var FILTER_FORMS = "[fieldname, operator, value] or [child doctype, fieldname, operator, value]";
 var FRAPPE_FILTERS_INPUT_SCHEMA = {
@@ -54854,7 +54862,7 @@ var VIEWER_TOOL_CANDIDATES = {
     "erpnext_file_upload",
     "erpnext_file_download"
   ],
-  "ui://mcp-erpnext/doclist-viewer": [],
+  "ui://mcp-erpnext/doclist-viewer": ["erpnext_doc_list"],
   "ui://mcp-erpnext/doc-viewer": [
     "erpnext_file_list",
     "erpnext_file_upload",
@@ -56140,6 +56148,9 @@ function loadMrtrConfig() {
   return { signingKey };
 }
 
+// src/server-instructions.ts
+var ACTIVE_CONTEXT_INSTRUCTIONS = 'User selections in ERPNext viewers are shared as model context on compatible hosts with schema "casys.erpnext/active-context", version 3, and an items array of {id, view, label, value?, fields?, query?}. This context identifies the documents and values the user is referring to. Document selections have IDs of the form record:<doctype>:<name>. Their <name> component is accepted as the name argument by the matching *_get tool; erpnext_doc_get accepts <doctype> and <name> as separate arguments. Child-row selections add :row:<table>:<row> to the document ID. fields holds a compact record. A query item represents selected rows: call query.tool with query.args to read them. truncated: true means only the first includedCount of selectedCount rows are listed.';
+
 // server.ts
 var DEFAULT_HTTP_PORT = 3012;
 function registerBuyViewAppManifest(server) {
@@ -56201,7 +56212,8 @@ async function main() {
   assertNonEmptySelection(toolsClient.selection);
   const server = new McpApp({
     name: "mcp-erpnext",
-    version: "3.2.2",
+    version: "3.3.0",
+    instructions: ACTIVE_CONTEXT_INSTRUCTIONS,
     transport: "stateless",
     cache: {
       ttlMs: 36e5,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@casys/mcp-erpnext",
-  "version": "3.2.2",
+  "version": "3.3.0",
   "description": "MCP server for ERPNext with interactive UI viewers",
   "type": "module",
   "bin": {