@ffschrattenecker/tm1-mcp-server 7.0.2 → 8.1.0

package/dist/tools/ti-development/install-pro-bundle.js

@@ -5,7 +5,7 @@ import { TM1Error, TM1ErrorCode } from "../../types.js";
 import { compileUserRegex } from "../../lib/safe-regex.js";
 import { parseProFile } from "../../lib/pro-parser.js";
 import { resolveLocalPath } from "../local-file.js";
-import { IDEMPOTENT_DESTRUCTIVE, withVersion } from "../annotations.js";
+import { IDEMPOTENT_DESTRUCTIVE } from "../annotations.js";
 import { InstallProBundleResultSchema } from "../schemas/items.js";
 import { defineTool } from "../define-tool.js";
 import { runPreflight } from "./preflight.js";
@@ -13,7 +13,7 @@ import { backupProcess } from "./process-backup.js";
 export const registerInstallProBundle = defineTool({
     name: "tm1_install_pro_bundle",
     description: "Install all .pro files from a directory in one call. Iterates the directory (non-recursive by default), applies tm1_import_pro_file logic per file, and reports per-file outcome. Stops on first failure unless continueOnError=true. Useful for Bedrock or library deployments.",
-    annotations: withVersion(IDEMPOTENT_DESTRUCTIVE, "v11"),
+    annotations: IDEMPOTENT_DESTRUCTIVE,
     output: InstallProBundleResultSchema,
     input: {
         directory: z

package/dist/tools/ti-development/upsert-process.js

@@ -42,7 +42,14 @@ export const registerUpsertProcess = defineTool({
         data: z.string().optional(),
         epilog: z.string().optional(),
         parameters: z.array(parameterSchema).optional(),
-        variables: z.array(variableSchema).optional(),
+        variables: z
+            .array(variableSchema)
+            .optional()
+            .describe("Replaces the complete variable list; [] removes every variable."),
+        variablesUIData: z
+            .array(z.string())
+            .optional()
+            .describe("Raw per-column layout (VariablesUIData), one entry per source column including ignored ones, sent verbatim. Take it from tm1_get_process_variables or an export; do not construct entries. Omitted: the server keeps its current layout."),
         dataSource: dataSourceSchema.optional(),
         hasSecurityAccess: z
             .boolean()
@@ -66,7 +73,7 @@ export const registerUpsertProcess = defineTool({
             .default(false)
             .describe("Write nothing. Run the syntax AND reference check on the process as it would be after this call (both reported, neither stops the other) and diff it against the installed version (credentials masked). Needs no confirm and is not one: the real call still needs it. Replaces a separate check_process_code + validate_process_refs + diff before the risk assessment."),
     },
-    handler: async ({ processName, prolog, metadata, data, epilog, parameters, variables, dataSource, hasSecurityAccess, mode, preflight, autoCompile, dryRun, confirm, }, tm1Client) => {
+    handler: async ({ processName, prolog, metadata, data, epilog, parameters, variables, variablesUIData, dataSource, hasSecurityAccess, mode, preflight, autoCompile, dryRun, confirm, }, tm1Client) => {
         const trail = [];
         const exists = await tm1Client.processes.exists(processName);
         if (mode === "create" && exists) {
@@ -199,8 +206,21 @@ export const registerUpsertProcess = defineTool({
             await tm1Client.processes.updateParameters(processName, parameters);
             trail.push("updateProcessParameters");
         }
-        if (variables !== undefined && variables.length > 0) {
-            await tm1Client.processes.updateVariables(processName, variables);
+        let warning;
+        if (variables !== undefined || variablesUIData !== undefined) {
+            // A Variables PATCH alone leaves the server's VariablesUIData in place
+            // (measured on 11.8 and 12.5). When the new variable count no longer
+            // matches the kept layout's non-ignored columns, the ignore markers
+            // point at the wrong columns — say so rather than guess a layout.
+            if (exists && variables !== undefined && variablesUIData === undefined) {
+                const layout = await tm1Client.processes.getVariableLayout(processName);
+                const kept = layout.variablesUIData?.length ?? 0;
+                const used = kept - layout.ignoredColumns.length;
+                if (kept > 0 && used !== variables.length) {
+                    warning = `VariablesUIData left as on the server: it describes ${used} used and ${layout.ignoredColumns.length} ignored column(s), but ${variables.length} variable(s) were written. Pass variablesUIData to replace the column layout.`;
+                }
+            }
+            await tm1Client.processes.updateVariables(processName, variables, variablesUIData);
             trail.push("updateProcessVariables");
         }
         if (dataSource !== undefined) {
@@ -213,7 +233,7 @@ export const registerUpsertProcess = defineTool({
         }
         // Process body/parameters/datasource may have changed call sites — drop the
         // 60s callgraph TTL so the next analysis sees fresh references instead of stale graph.
-        const { cleared: callgraphEntriesCleared } = invalidateCallgraphCache();
+        const { cleared: callgraphEntriesCleared } = invalidateCallgraphCache(tm1Client.connectionId);
         // Read the code back: TM1 stores what REST sent, so a mismatch means the
         // write did not land as sent. Saves the caller a get_process turn.
         const sent = { prolog, metadata, data, epilog };
@@ -247,6 +267,7 @@ export const registerUpsertProcess = defineTool({
                         ...(backup ? { backup } : {}),
                         ...(verified !== undefined ? { verified } : {}),
                         ...(compile !== undefined ? { compile } : {}),
+                        ...(warning !== undefined ? { warning } : {}),
                     }, null, 2),
                 },
             ],

package/npm-shrinkwrap.json

@@ -1,17 +1,19 @@
 {
   "name": "@ffschrattenecker/tm1-mcp-server",
-  "version": "7.0.2",
+  "version": "8.1.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ffschrattenecker/tm1-mcp-server",
-      "version": "7.0.2",
+      "version": "8.1.0",
       "license": "MIT",
       "dependencies": {
-        "@modelcontextprotocol/sdk": "1.30.0",
+        "@modelcontextprotocol/sdk": "1.30.1",
+        "@napi-rs/keyring": "^2.1.0",
         "dotenv": "^18.0.0",
         "pino": "^10.3.1",
+        "regexp-tree": "^0.1.27",
         "safe-regex": "^2.1.1",
         "undici": "^8.10.2",
         "zod": "4.6.5"
@@ -822,9 +824,9 @@
       "license": "MIT"
     },
     "node_modules/@modelcontextprotocol/sdk": {
-      "version": "1.30.0",
-      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.30.0.tgz",
-      "integrity": "sha512-xKd8OIzlqNzcqcNumGAa6g+PW2kjD5vrpcKOnfldAUPP3j7lnqMPwlTXQm8gF+UwH72z0lqaRbjr9hqGz0eITA==",
+      "version": "1.30.1",
+      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.30.1.tgz",
+      "integrity": "sha512-H2HxLvC3HDNybePJaLdSrU1hhUK5iQw+WvV1b01myFyI7sdVGe1u/IPTE5D9fGCiJDVtgMV/lmFkQXLmQyIFYA==",
       "license": "MIT",
       "dependencies": {
         "@hono/node-server": "^1.19.9 || ^2.0.5",
@@ -861,6 +863,240 @@
         }
       }
     },
+    "node_modules/@napi-rs/keyring": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring/-/keyring-2.1.0.tgz",
+      "integrity": "sha512-km9J3fomkGSLpImpelq0cMvLBrJ5eVlTzuWdG3Iy0laP6gU90MmHYjqhUhG32aYq0/0++r2TLuAA9xlnh4XU1g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      },
+      "optionalDependencies": {
+        "@napi-rs/keyring-darwin-arm64": "2.1.0",
+        "@napi-rs/keyring-darwin-x64": "2.1.0",
+        "@napi-rs/keyring-freebsd-x64": "2.1.0",
+        "@napi-rs/keyring-linux-arm-gnueabihf": "2.1.0",
+        "@napi-rs/keyring-linux-arm64-gnu": "2.1.0",
+        "@napi-rs/keyring-linux-arm64-musl": "2.1.0",
+        "@napi-rs/keyring-linux-riscv64-gnu": "2.1.0",
+        "@napi-rs/keyring-linux-x64-gnu": "2.1.0",
+        "@napi-rs/keyring-linux-x64-musl": "2.1.0",
+        "@napi-rs/keyring-win32-arm64-msvc": "2.1.0",
+        "@napi-rs/keyring-win32-ia32-msvc": "2.1.0",
+        "@napi-rs/keyring-win32-x64-msvc": "2.1.0"
+      }
+    },
+    "node_modules/@napi-rs/keyring-darwin-arm64": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-darwin-arm64/-/keyring-darwin-arm64-2.1.0.tgz",
+      "integrity": "sha512-j6ATTOhmPW+N5EKwi8Yzn6P4Bz/uqnxzyYvqOL73/dgzDSYG5pS5eprqpVmOLse68WUTf79ZMqz97HnfvirJ9g==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@napi-rs/keyring-darwin-x64": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-darwin-x64/-/keyring-darwin-x64-2.1.0.tgz",
+      "integrity": "sha512-54Q803nguiOaQzBG2h4uIkacI0eLGAlzzdpxPNi6IZtXbjqbPI4AQ86GrQy25tw3czBqRPBoGu0lHP2U+/f5iA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@napi-rs/keyring-freebsd-x64": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-freebsd-x64/-/keyring-freebsd-x64-2.1.0.tgz",
+      "integrity": "sha512-BL7ngJAYQBrUp1PTF8enOXOIVfxN51RbwVOEQ+8eAjWypF/5Ipqs8oQoMqkuc0wAbk+vatnNVjdKCIFa/HPglg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@napi-rs/keyring-linux-arm-gnueabihf": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-linux-arm-gnueabihf/-/keyring-linux-arm-gnueabihf-2.1.0.tgz",
+      "integrity": "sha512-JYgbCDk+giss7lKla8NTXhM/fLj+Hrfgr3xwKQ8jKn8qMD6vXLwYcfK8HJ9VoAcjIeYEUpCL6dRszJC5M4zFNg==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@napi-rs/keyring-linux-arm64-gnu": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-linux-arm64-gnu/-/keyring-linux-arm64-gnu-2.1.0.tgz",
+      "integrity": "sha512-+PMONFQ+2GkBXG7vRG2spgR73bNCMeVpNopHoSmhj2E+5Gu6zJooRBjoaIZKj6hCyrOU8pXAhoZ22EEFQ/4YeQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@napi-rs/keyring-linux-arm64-musl": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-linux-arm64-musl/-/keyring-linux-arm64-musl-2.1.0.tgz",
+      "integrity": "sha512-dKjiXKTHQjAS57hL0HVzLpW9XYNGFpfYkr/51FzIIvbZR08PAnzIDYKwShoNYGvjQP6+rDFf1a5Utl0aWwcFrA==",
+      "cpu": [
+        "arm64"
+      ],
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@napi-rs/keyring-linux-riscv64-gnu": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-linux-riscv64-gnu/-/keyring-linux-riscv64-gnu-2.1.0.tgz",
+      "integrity": "sha512-tqhb0ofhtEJ2+ZfmlKTDHbmIoNSz+SSTPWRgMfSVCgI4JVkqDdfcmIOcThZfRffJ3QI9C3Tng+rZL24acmD+GA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@napi-rs/keyring-linux-x64-gnu": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-linux-x64-gnu/-/keyring-linux-x64-gnu-2.1.0.tgz",
+      "integrity": "sha512-7ZA0ssxfpuGXV8S5Ct1ZJoEL3sKg/8u7mIL4SK9/PwKBhxIq7K+FVcjnggNsuFnEhHTX+HYl9hHDrlX0odZnHg==",
+      "cpu": [
+        "x64"
+      ],
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@napi-rs/keyring-linux-x64-musl": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-linux-x64-musl/-/keyring-linux-x64-musl-2.1.0.tgz",
+      "integrity": "sha512-dI74Fzl03CrN2TEP7YVBtUBFgyRTRPyK1LMcIgAUfgW3o6f5SD1a8EsfT82+brpFOltjOhacIlFiYOkYtSI5Fg==",
+      "cpu": [
+        "x64"
+      ],
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@napi-rs/keyring-win32-arm64-msvc": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-win32-arm64-msvc/-/keyring-win32-arm64-msvc-2.1.0.tgz",
+      "integrity": "sha512-SltrXXkEe9a+Jv8ConDkZW2Mdr0srpWurS7oYkYP1Mp07DNBpFyqawRnyo4p7ZvQU3e+R6irj/Fq0epCCvVUXA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@napi-rs/keyring-win32-ia32-msvc": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-win32-ia32-msvc/-/keyring-win32-ia32-msvc-2.1.0.tgz",
+      "integrity": "sha512-l5wJQhqXkAfQ4FGxoRh0wMpL9VxVmfiYI5TTeOGNupuVsQvbHmysh8gfDQBBWVhyMENHJS2OqOSYIuqVjumAtA==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@napi-rs/keyring-win32-x64-msvc": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@napi-rs/keyring-win32-x64-msvc/-/keyring-win32-x64-msvc-2.1.0.tgz",
+      "integrity": "sha512-3zYwO7dhJiUNyv2te81ujXm2vGxHwgx+z2eBm0dTYe3aWpvKQVzpfxCp/7cViJs8duVYE04wVOgXiRhRCMEq2w==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
     "node_modules/@oxc-project/types": {
       "version": "0.150.0",
       "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.150.0.tgz",
@@ -2404,9 +2640,9 @@
       "license": "MIT"
     },
     "node_modules/fast-uri": {
-      "version": "3.1.8",
-      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.8.tgz",
-      "integrity": "sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg==",
+      "version": "4.2.1",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-4.2.1.tgz",
+      "integrity": "sha512-TmHQgewjHtMq1E5QKA0tOE0yeYGQs25KZC/ziJpubRtWI15W92e6vPFydWOeZBVROSHBYw/QhD9d5OefdD6LDg==",
       "funding": [
         {
           "type": "github",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ffschrattenecker/tm1-mcp-server",
-  "version": "7.0.2",
+  "version": "8.1.0",
   "description": "MCP server for IBM Planning Analytics / TM1 — full model lifecycle via REST API",
   "repository": {
     "type": "git",
@@ -43,6 +43,7 @@
     "test:unit": "vitest run tests/unit",
     "test:property": "vitest run tests/property",
     "test:live": "vitest run --config vitest.live.config.ts",
+    "test:live:for": "tsx scripts/run-live-for.ts",
     "test:live:nightly": "node scripts/run-live-nightly.mjs",
     "contracts:record": "node scripts/record-wire-contracts.mjs",
     "contracts:verify": "node scripts/record-wire-contracts.mjs tm1-test --verify",
@@ -58,14 +59,16 @@
     "lint:tool-registration": "node scripts/check-tool-registration.mjs",
     "lint:input-naming": "node scripts/check-no-bare-name-input.mjs",
     "lint:mutation-envelope": "node scripts/check-mutation-envelope.mjs",
+    "lint:no-local-enc": "node scripts/check-no-local-enc.mjs",
     "lint:format": "prettier --check .",
     "format": "prettier --write .",
-    "verify": "npm run typecheck && npm run typecheck:tests && npm run lint:no-flat-api && npm run lint:output-schema-budget && npm run lint:tool-surface-budget && npm run lint:tool-registration && npm run lint:input-naming && npm run lint:mutation-envelope && npm run lint:format && npm run lint:eslint && npm run coverage:check",
+    "audit:prod": "npm audit --omit=dev --audit-level=high",
+    "verify": "npm run audit:prod && npm run typecheck && npm run typecheck:tests && npm run lint:no-flat-api && npm run lint:output-schema-budget && npm run lint:tool-surface-budget && npm run lint:tool-registration && npm run lint:input-naming && npm run lint:mutation-envelope && npm run lint:no-local-enc && npm run lint:format && npm run lint:eslint && npm run coverage:check",
     "tools:list": "node scripts/gen-tool-list.mjs",
     "tools:update-readme": "node scripts/gen-tool-list.mjs --write-readme",
     "lint:eslint": "eslint .",
     "measure:tools": "node scripts/measure-tool-surface.mjs",
-    "lint:tool-surface-budget": "node scripts/measure-tool-surface.mjs --top 0 --budget 133000"
+    "lint:tool-surface-budget": "node scripts/measure-tool-surface.mjs --top 0 --budget 140000"
   },
   "keywords": [
     "mcp",
@@ -78,13 +81,15 @@
     "node": ">=22.19.0"
   },
   "overrides": {
-    "fast-uri": "^3.1.5",
+    "fast-uri": "^4.2.1",
     "ip-address": "^10.4.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.30.0",
+    "@modelcontextprotocol/sdk": "1.30.1",
+    "@napi-rs/keyring": "^2.1.0",
     "dotenv": "^18.0.0",
     "pino": "^10.3.1",
+    "regexp-tree": "^0.1.27",
     "safe-regex": "^2.1.1",
     "undici": "^8.10.2",
     "zod": "4.6.5"

package/dist/tools/dimension-management/move-element.d.ts

@@ -1,2 +0,0 @@
-export declare const registerMoveElement: import("../define-tool.js").ToolRegistrar;
-//# sourceMappingURL=move-element.d.ts.map

package/dist/tools/dimension-management/move-element.js

@@ -1,28 +0,0 @@
-import { z } from "zod";
-import { actionResponse } from "../format.js";
-import { MutationResultSchema } from "../schemas/items.js";
-import { WRITE } from "../annotations.js";
-import { defineTool } from "../define-tool.js";
-import { HIERARCHY_NAME_OPTIONAL, resolveHierarchy } from "../hierarchy.js";
-export const registerMoveElement = defineTool({
-    name: "tm1_move_element",
-    description: "Move an element to a new parent within a TM1 dimension hierarchy",
-    annotations: WRITE,
-    output: MutationResultSchema,
-    input: {
-        dimensionName: z.string().describe("Name of the dimension"),
-        ...HIERARCHY_NAME_OPTIONAL,
-        elementName: z.string().describe("Name of the element to move"),
-        newParent: z.string().describe("Name of the new parent element"),
-        weight: z
-            .number()
-            .optional()
-            .describe("Weight for the parent-child relationship (default: 1)"),
-    },
-    handler: async ({ dimensionName, hierarchyName, elementName, newParent, weight }, tm1Client) => {
-        const hierarchy = resolveHierarchy(dimensionName, hierarchyName);
-        await tm1Client.elements.move(dimensionName, hierarchy, elementName, newParent, weight);
-        return actionResponse({ success: true, elementName, newParent });
-    },
-});
-//# sourceMappingURL=move-element.js.map