{"_id":"@alex-apps/ng-token-saver","_rev":"9-772f139427e149b1b21aa919d0f5bb10","name":"@alex-apps/ng-token-saver","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@alex-apps/ng-token-saver","version":"0.1.0","keywords":["angular","mcp","mcp-server","ai-agents","language-server","lsp","tokens"],"author":{"name":"Alex Ryabov"},"license":"GPL-3.0-or-later","_id":"@alex-apps/ng-token-saver@0.1.0","maintainers":[{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"}],"homepage":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver#readme","bugs":{"url":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver/issues"},"bin":{"ng-token-saver":"dist/index.js"},"dist":{"shasum":"c989d2ecdced86c4ed1f9e1fdc79c053492cdcfc","tarball":"https://registry.npmjs.org/@alex-apps/ng-token-saver/-/ng-token-saver-0.1.0.tgz","fileCount":25,"integrity":"sha512-IP5BCoFh1bIy+iaFn4TfLkaJfthAWYe1g3P4FlHkyV2pP8JSjuqybvTIAzLsa7xBaZnWfEZP0wfROt18SmQhOg==","signatures":[{"sig":"MEUCIGK/ysfd9U1l/mnvWe5iyQsR4Gl0PfoTmK9c9sYCLOngAiEA9DjlWAuqvqK5DgoYaQ7pYo2rmFSHcEMhFjSXI5rsQS4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":291899},"type":"module","engines":{"node":">=22.22.3"},"gitHead":"30cd3dac39f4312b7990da9919ec9dda9c17ff65","scripts":{"test":"tsc && node --test tests/*.test.mjs","build":"tsc","smoke":"node tools/mcp-smoke.mjs","start":"node dist/index.js","bench:api":"node tools/probe-api.mjs","bench:matrix":"node tools/lsp-probe.mjs --server tools/servers/ls22 --project fixtures/v22","bench:rename":"node tools/bench-rename.mjs","bench:settle":"node tools/probe-settle.mjs","bench:contract":"node tools/bench-contract.mjs","bench:diagnose":"node tools/bench-diagnose.mjs","bench:negative":"node tools/lsp-negative.mjs","bench:didchange":"node tools/lsp-didchange.mjs --server tools/servers/ls22 --project fixtures/v17","bench:standalone":"node tools/probe-standalone.mjs v17 v18 v19 v20 v21 v22"},"_npmUser":{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"},"repository":{"url":"git+https://github.com/Alex88Ryabov/alex-apps-ng-token-saver.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Angular: compiler-backed template answers, component contracts and version-accurate facts that save AI agents tokens","directories":{},"_nodeVersion":"23.7.0","dependencies":{"zod":"4.4.3","@angular/language-server":"22.0.8","@modelcontextprotocol/sdk":"1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"5.9.3","@types/node":"22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/ng-token-saver_0.1.0_1785477035492_0.6352710350998854","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@alex-apps/ng-token-saver","version":"0.1.1","keywords":["angular","mcp","mcp-server","ai-agents","language-server","lsp","tokens"],"author":{"name":"Alex Ryabov"},"license":"GPL-3.0-or-later","_id":"@alex-apps/ng-token-saver@0.1.1","maintainers":[{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"}],"homepage":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver#readme","bugs":{"url":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver/issues"},"bin":{"ng-token-saver":"dist/index.js"},"dist":{"shasum":"98914b65dcbb5bb0f85015d063e58086d28fef7f","tarball":"https://registry.npmjs.org/@alex-apps/ng-token-saver/-/ng-token-saver-0.1.1.tgz","fileCount":25,"integrity":"sha512-nQeeQSPiIumRfSUW97BPPkaJ1/z8NNhWpXrrTTKnisZb0PwtF4aH23ioFUCZESgT8AvYC3qeEq0VFhgKyVRxiw==","signatures":[{"sig":"MEUCIQDcbustcJbu1n3z7qUE6UUlwfvO875nHJ6+tq3XM0eoyQIgfQrAW7CTBIZzQfJAp7JsifuX3rAtt6eTCpJEuyiqCLo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":292433},"type":"module","engines":{"node":">=18.20.8"},"gitHead":"331222cd73477e15efc2d5da08a4bf4e44cba482","scripts":{"test":"tsc && node --test tests/*.test.mjs","build":"tsc","smoke":"node tools/mcp-smoke.mjs","start":"node dist/index.js","bench:api":"node tools/probe-api.mjs","bench:matrix":"node tools/lsp-probe.mjs --server tools/servers/ls22 --project fixtures/v22","bench:rename":"node tools/bench-rename.mjs","bench:settle":"node tools/probe-settle.mjs","bench:contract":"node tools/bench-contract.mjs","bench:diagnose":"node tools/bench-diagnose.mjs","bench:negative":"node tools/lsp-negative.mjs","bench:didchange":"node tools/lsp-didchange.mjs --server tools/servers/ls22 --project fixtures/v17","bench:standalone":"node tools/probe-standalone.mjs v17 v18 v19 v20 v21 v22"},"_npmUser":{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"},"repository":{"url":"git+https://github.com/Alex88Ryabov/alex-apps-ng-token-saver.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Angular: compiler-backed template answers, component contracts and version-accurate facts that save AI agents tokens","directories":{},"_nodeVersion":"23.7.0","dependencies":{"zod":"4.4.3","@angular/language-server":"22.0.8","@modelcontextprotocol/sdk":"1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"5.9.3","@types/node":"22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/ng-token-saver_0.1.1_1785478509977_0.900388778641332","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@alex-apps/ng-token-saver","version":"0.1.2","keywords":["angular","mcp","mcp-server","ai-agents","language-server","lsp","tokens"],"author":{"name":"Alex Ryabov"},"license":"GPL-3.0-or-later","_id":"@alex-apps/ng-token-saver@0.1.2","maintainers":[{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"}],"homepage":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver#readme","bugs":{"url":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver/issues"},"bin":{"ng-token-saver":"dist/index.js"},"dist":{"shasum":"a3341bd3aef6122b3ef26af331c48544c4921dbe","tarball":"https://registry.npmjs.org/@alex-apps/ng-token-saver/-/ng-token-saver-0.1.2.tgz","fileCount":25,"integrity":"sha512-umfk88P5R43nFd+dQfRsCNsQ8PFrtMcaVuoo8DrEkqeh0d9s3tEYKeWxUZ+5oAW0EtDvSm2EOJJnUs2XV+Vxww==","signatures":[{"sig":"MEUCIQCqe+rJJl66tpOM2wXuhJ+WPgCv0YtnLApALKOaqwIcxgIgI0JxYiPUFjzB+Cv4apu7stV/8PMmUwVELE/p8p+nedk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":303971},"type":"module","engines":{"node":">=18.20.8"},"gitHead":"f6702a72b4aec456a9b109061c4be69731ee6416","scripts":{"test":"tsc && node --test tests/*.test.mjs","build":"tsc","smoke":"node tools/mcp-smoke.mjs","start":"node dist/index.js","bench:api":"node tools/probe-api.mjs","bench:matrix":"node tools/lsp-probe.mjs --server tools/servers/ls22 --project fixtures/v22","bench:rename":"node tools/bench-rename.mjs","bench:settle":"node tools/probe-settle.mjs","bench:contract":"node tools/bench-contract.mjs","bench:diagnose":"node tools/bench-diagnose.mjs","bench:negative":"node tools/lsp-negative.mjs","bench:didchange":"node tools/lsp-didchange.mjs --server tools/servers/ls22 --project fixtures/v17","bench:standalone":"node tools/probe-standalone.mjs v17 v18 v19 v20 v21 v22"},"_npmUser":{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"},"repository":{"url":"git+https://github.com/Alex88Ryabov/alex-apps-ng-token-saver.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Angular: compiler-backed template answers, component contracts and version-accurate facts that save AI agents tokens","directories":{},"_nodeVersion":"23.7.0","dependencies":{"zod":"4.4.3","@angular/language-server":"22.0.8","@modelcontextprotocol/sdk":"1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"5.9.3","@types/node":"22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/ng-token-saver_0.1.2_1785488850736_0.049939922215537225","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@alex-apps/ng-token-saver","version":"0.1.3","keywords":["angular","mcp","mcp-server","ai-agents","language-server","lsp","tokens"],"author":{"name":"Alex Ryabov"},"license":"GPL-3.0-or-later","_id":"@alex-apps/ng-token-saver@0.1.3","maintainers":[{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"}],"homepage":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver#readme","bugs":{"url":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver/issues"},"bin":{"ng-token-saver":"dist/index.js"},"dist":{"shasum":"df7c91614666c11cd37ca045079099339fbc7330","tarball":"https://registry.npmjs.org/@alex-apps/ng-token-saver/-/ng-token-saver-0.1.3.tgz","fileCount":25,"integrity":"sha512-hSd3xjseT7c06o0PX+GxAZ5YkbmxuUC8IjlrsRHT+TCKKLTBIPYlpuVWAAiUjLq0P0Nq1vYh8yVjQCQyi/0WVw==","signatures":[{"sig":"MEUCID+BwF44Y5Ix2uik5HpaJQC/20Hb0/F13dTGS1MgQa/SAiEAkx6HCTraNOd4MPwRLLM9xwzoA7dQ1RvVQenboVNGvP4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":307995},"type":"module","engines":{"node":">=18.20.8"},"gitHead":"f569d1fa949caf5d2f3d8815790188dea15a4e02","scripts":{"test":"tsc && node --test tests/*.test.mjs","build":"tsc","smoke":"node tools/mcp-smoke.mjs","start":"node dist/index.js","bench:api":"node tools/probe-api.mjs","bench:matrix":"node tools/lsp-probe.mjs --server tools/servers/ls22 --project fixtures/v22","bench:rename":"node tools/bench-rename.mjs","bench:settle":"node tools/probe-settle.mjs","bench:contract":"node tools/bench-contract.mjs","bench:diagnose":"node tools/bench-diagnose.mjs","bench:negative":"node tools/lsp-negative.mjs","bench:didchange":"node tools/lsp-didchange.mjs --server tools/servers/ls22 --project fixtures/v17","bench:standalone":"node tools/probe-standalone.mjs v17 v18 v19 v20 v21 v22"},"_npmUser":{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"},"repository":{"url":"git+https://github.com/Alex88Ryabov/alex-apps-ng-token-saver.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Angular: compiler-backed template answers, component contracts and version-accurate facts that save AI agents tokens","directories":{},"_nodeVersion":"23.7.0","dependencies":{"zod":"4.4.3","@angular/language-server":"22.0.8","@modelcontextprotocol/sdk":"1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"5.9.3","@types/node":"22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/ng-token-saver_0.1.3_1785491588034_0.3950903696305559","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@alex-apps/ng-token-saver","version":"0.1.4","keywords":["angular","mcp","mcp-server","ai-agents","language-server","lsp","tokens"],"author":{"name":"Alex Ryabov"},"license":"GPL-3.0-or-later","_id":"@alex-apps/ng-token-saver@0.1.4","maintainers":[{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"}],"homepage":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver#readme","bugs":{"url":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver/issues"},"bin":{"ng-token-saver":"dist/index.js"},"dist":{"shasum":"73a7f5efcde8ede6d63543907807c43f4d46947a","tarball":"https://registry.npmjs.org/@alex-apps/ng-token-saver/-/ng-token-saver-0.1.4.tgz","fileCount":25,"integrity":"sha512-1spYUdoB7w2VYEvMW5Ug1CWUFuVL5LCEu+aas/l0IRwxPVv/85ZHxNgL+O3owLMmaxcqjkLBfKlQ3NCahcgb7Q==","signatures":[{"sig":"MEUCIAwVec179Azs/oZR08TtFWZuFGDBU3XNf0KEtPUg/IIpAiEAqDTM2LBFvJ39w5eBjyJvt2tQgThedfLp8j4yONdzUJ8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":307204},"type":"module","engines":{"node":">=18.20.8"},"gitHead":"b4cf0d5c09d5e50a96c5ee25dc7e7b23b5762ca3","scripts":{"test":"tsc && node --test tests/*.test.mjs","build":"tsc","smoke":"node tools/mcp-smoke.mjs","start":"node dist/index.js","bench:api":"node tools/probe-api.mjs","bench:matrix":"node tools/lsp-probe.mjs --server tools/servers/ls22 --project fixtures/v22","bench:rename":"node tools/bench-rename.mjs","bench:settle":"node tools/probe-settle.mjs","bench:contract":"node tools/bench-contract.mjs","bench:diagnose":"node tools/bench-diagnose.mjs","bench:negative":"node tools/lsp-negative.mjs","bench:didchange":"node tools/lsp-didchange.mjs --server tools/servers/ls22 --project fixtures/v17","bench:standalone":"node tools/probe-standalone.mjs v17 v18 v19 v20 v21 v22"},"_npmUser":{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"},"repository":{"url":"git+https://github.com/Alex88Ryabov/alex-apps-ng-token-saver.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Angular: compiler-backed template answers, component contracts and version-accurate facts that save AI agents tokens","directories":{},"_nodeVersion":"23.7.0","dependencies":{"zod":"4.4.3","@angular/language-server":"22.0.8","@modelcontextprotocol/sdk":"1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"5.9.3","@types/node":"22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/ng-token-saver_0.1.4_1786018043865_0.780594521765948","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@alex-apps/ng-token-saver","version":"0.1.5","keywords":["angular","mcp","mcp-server","ai-agents","language-server","lsp","tokens"],"author":{"name":"Alex Ryabov"},"license":"GPL-3.0-or-later","_id":"@alex-apps/ng-token-saver@0.1.5","maintainers":[{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"}],"homepage":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver#readme","bugs":{"url":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver/issues"},"bin":{"ng-token-saver":"dist/index.js"},"dist":{"shasum":"da9b7c68842b9605155e3e741f7a80fcce2252f1","tarball":"https://registry.npmjs.org/@alex-apps/ng-token-saver/-/ng-token-saver-0.1.5.tgz","fileCount":25,"integrity":"sha512-7Gst964SWa8F69ep45aLz1FMgQkfwmlN3wAKnpJTtl5BZQ9hdf4Rjaidpzq7YlrvEvRa9fCgN41dawVLVYdRiA==","signatures":[{"sig":"MEUCIAr3btLmG9MeOQfQROvA1FHxL9NEJu0N/xBnQhhrYbMoAiEAzZhOk/Z0SnJMSWwmJlvhsnJ6Vul/2hfTIi4BjnaFxlU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alex-apps%2fng-token-saver@0.1.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":307020},"type":"module","engines":{"node":">=18.20.8"},"gitHead":"84e7b8353c5c97b34173485654d8cf1d0dc491ea","scripts":{"test":"tsc && node --test tests/*.test.mjs","build":"tsc","smoke":"node tools/mcp-smoke.mjs","start":"node dist/index.js","bench:api":"node tools/probe-api.mjs","bench:matrix":"node tools/lsp-probe.mjs --server tools/servers/ls22 --project fixtures/v22","bench:rename":"node tools/bench-rename.mjs","bench:settle":"node tools/probe-settle.mjs","bench:contract":"node tools/bench-contract.mjs","bench:diagnose":"node tools/bench-diagnose.mjs","bench:negative":"node tools/lsp-negative.mjs","bench:didchange":"node tools/lsp-didchange.mjs --server tools/servers/ls22 --project fixtures/v17","bench:standalone":"node tools/probe-standalone.mjs v17 v18 v19 v20 v21 v22"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:20baa4d3-151b-43bf-a05c-753eee584187"}},"repository":{"url":"git+https://github.com/Alex88Ryabov/alex-apps-ng-token-saver.git","type":"git"},"_npmVersion":"12.0.2","description":"MCP server for Angular: compiler-backed template answers, component contracts and version-accurate facts that save AI agents tokens","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"4.4.3","@angular/language-server":"22.0.8","@modelcontextprotocol/sdk":"1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"5.9.3","@types/node":"22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/ng-token-saver_0.1.5_1786020049992_0.4129754866576518","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@alex-apps/ng-token-saver","version":"0.1.6","keywords":["angular","mcp","mcp-server","model-context-protocol","ai-agents","language-server","angular-language-service","lsp","tokens","claude","cursor"],"author":{"name":"Alex Ryabov"},"license":"GPL-3.0-or-later","_id":"@alex-apps/ng-token-saver@0.1.6","maintainers":[{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"}],"homepage":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver#readme","bugs":{"url":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver/issues"},"bin":{"ng-token-saver":"dist/index.js"},"dist":{"shasum":"7260e32c6fbaaa55c5cfcf7afef9e296fd16e19d","tarball":"https://registry.npmjs.org/@alex-apps/ng-token-saver/-/ng-token-saver-0.1.6.tgz","fileCount":25,"integrity":"sha512-n7YtltWMbyYz49dNyB/1PxlN50qo2PRH/CVCseg37cyTOHZytanKkXeDHc24eWkq1trotuD+NK0lvtHTXOn9uA==","signatures":[{"sig":"MEQCIDGvhtaIP0fJ3KlMylyeAOekN5uyhd8iLTRV6dRQgOfYAiAfBdaWB7p0G1IqJjDJ1LxlszIvM86Phx2g5YXcoCXW8A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alex-apps%2fng-token-saver@0.1.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":314481},"type":"module","engines":{"node":">=18.20.8"},"gitHead":"51dee40066e31d3998c8e9b94573d8925dfd9838","scripts":{"test":"tsc && node --test tests/*.test.mjs","build":"tsc","smoke":"node tools/mcp-smoke.mjs","start":"node dist/index.js","bench:api":"node tools/probe-api.mjs","bench:matrix":"node tools/lsp-probe.mjs --server tools/servers/ls22 --project fixtures/v22","bench:rename":"node tools/bench-rename.mjs","bench:settle":"node tools/probe-settle.mjs","bench:contract":"node tools/bench-contract.mjs","bench:diagnose":"node tools/bench-diagnose.mjs","bench:negative":"node tools/lsp-negative.mjs","bench:didchange":"node tools/lsp-didchange.mjs --server tools/servers/ls22 --project fixtures/v17","bench:standalone":"node tools/probe-standalone.mjs v17 v18 v19 v20 v21 v22"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:20baa4d3-151b-43bf-a05c-753eee584187"}},"repository":{"url":"git+https://github.com/Alex88Ryabov/alex-apps-ng-token-saver.git","type":"git"},"_npmVersion":"12.0.2","description":"MCP server for Angular: compiler-backed template answers, component contracts and version-accurate facts that save AI agents tokens","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"4.4.3","@angular/language-server":"22.0.8","@modelcontextprotocol/sdk":"1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"5.9.3","@types/node":"22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/ng-token-saver_0.1.6_1786099602324_0.45570174653221507","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@alex-apps/ng-token-saver","version":"0.1.7","keywords":["angular","mcp","mcp-server","model-context-protocol","ai-agents","language-server","angular-language-service","lsp","tokens","claude","cursor"],"author":{"name":"Alex Ryabov"},"license":"GPL-3.0-or-later","_id":"@alex-apps/ng-token-saver@0.1.7","maintainers":[{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"}],"homepage":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver#readme","bugs":{"url":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver/issues"},"bin":{"ng-token-saver":"dist/index.js"},"dist":{"shasum":"39b3677ba36683c0cf5675b84d37fb822abd61b7","tarball":"https://registry.npmjs.org/@alex-apps/ng-token-saver/-/ng-token-saver-0.1.7.tgz","fileCount":25,"integrity":"sha512-yU2GXb5ePzcvf/iXLipH2zOSHuBQFeDhS3UPYk6x5a1/AtDMrebmQI/T2qR9j8nrK5RzwhOTuc8jDBsatL7+pg==","signatures":[{"sig":"MEYCIQCz/qk56z0qh0p/L6KyVGZmJLBD46BRfvwq8mZqOafXywIhAJAzYl8Q772Mf9LxWFiGKd7WBV710+amxKGvtbswvPdE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alex-apps%2fng-token-saver@0.1.7","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":314535},"type":"module","engines":{"node":">=18.20.8"},"gitHead":"1384e1d3a6c8d380012b6d3200e2fe61409d8eb7","mcpName":"io.github.Alex88Ryabov/ng-token-saver","scripts":{"test":"tsc && node --test tests/*.test.mjs","build":"tsc","smoke":"node tools/mcp-smoke.mjs","start":"node dist/index.js","bench:api":"node tools/probe-api.mjs","bench:matrix":"node tools/lsp-probe.mjs --server tools/servers/ls22 --project fixtures/v22","bench:rename":"node tools/bench-rename.mjs","bench:settle":"node tools/probe-settle.mjs","bench:contract":"node tools/bench-contract.mjs","bench:diagnose":"node tools/bench-diagnose.mjs","bench:negative":"node tools/lsp-negative.mjs","bench:didchange":"node tools/lsp-didchange.mjs --server tools/servers/ls22 --project fixtures/v17","bench:standalone":"node tools/probe-standalone.mjs v17 v18 v19 v20 v21 v22"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:20baa4d3-151b-43bf-a05c-753eee584187"}},"repository":{"url":"git+https://github.com/Alex88Ryabov/alex-apps-ng-token-saver.git","type":"git"},"_npmVersion":"12.0.2","description":"MCP server for Angular: compiler-backed template answers, component contracts and version-accurate facts that save AI agents tokens","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"4.4.3","@angular/language-server":"22.0.8","@modelcontextprotocol/sdk":"1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"5.9.3","@types/node":"22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/ng-token-saver_0.1.7_1786107738340_0.9748217239535162","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"_id":"@alex-apps/ng-token-saver@0.2.0","bin":{"ng-token-saver":"dist/index.js"},"bugs":{"url":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver/issues"},"dist":{"shasum":"27ddd13898f304e9c633253b977b860b00e8b0e9","tarball":"https://registry.npmjs.org/@alex-apps/ng-token-saver/-/ng-token-saver-0.2.0.tgz","fileCount":29,"integrity":"sha512-IWokyvmcpBw3pkFCIXz9lgiJLe+1uglg/tt4N5U2NiBmYN9H+/6xxaZkRZJAIbDNqPs+qSFfSSnGM36+T5sHrw==","signatures":[{"sig":"MEYCIQCxboMrMm1gCi+pWZU/3u0GWXlpZmKYLZ1dIs7BSO1zAgIhAJ4svyqT+2j+kjtBkZMQD59m5EQBRszkddVIDosS9kjO","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDDsefOPTFyDnISjPBH3z2SeGLManzwAXPqiZvHlTntpAIhAJGS8Jj/00g8O6GsfzRzGq6UfingAlyn7Nc6mtLrOpvi"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alex-apps%2fng-token-saver@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":334487},"name":"@alex-apps/ng-token-saver","type":"module","author":{"name":"Alex Ryabov"},"engines":{"node":">=18.20.8"},"gitHead":"0120f143599027cac6aedaa3c4d441c4e2598849","license":"GPL-3.0-or-later","mcpName":"io.github.Alex88Ryabov/ng-token-saver","scripts":{"test":"tsc && node --test","build":"tsc","smoke":"node tools/mcp-smoke.mjs","start":"node dist/index.js","bench:api":"node tools/probe-api.mjs","bench:matrix":"node tools/lsp-probe.mjs --server tools/servers/ls22 --project fixtures/v22","bench:rename":"node tools/bench-rename.mjs","bench:settle":"node tools/probe-settle.mjs","bench:contract":"node tools/bench-contract.mjs","bench:defaults":"node tools/probe-defaults.mjs","bench:diagnose":"node tools/bench-diagnose.mjs","bench:negative":"node tools/lsp-negative.mjs","bench:didchange":"node tools/lsp-didchange.mjs --server tools/servers/ls22 --project fixtures/v17","bench:standalone":"node tools/probe-standalone.mjs v17 v18 v19 v20 v21 v22"},"version":"0.2.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:20baa4d3-151b-43bf-a05c-753eee584187"}},"homepage":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver#readme","keywords":["angular","mcp","mcp-server","model-context-protocol","ai-agents","language-server","angular-language-service","lsp","tokens","claude","cursor"],"repository":{"url":"git+https://github.com/Alex88Ryabov/alex-apps-ng-token-saver.git","type":"git"},"_npmVersion":"12.1.0","description":"MCP server for Angular: compiler-backed template answers, component contracts and version-accurate facts that save AI agents tokens","directories":{},"maintainers":[{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"}],"_nodeVersion":"24.21.0","dependencies":{"zod":"4.4.3","@angular/language-server":"22.0.8","@modelcontextprotocol/sdk":"1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"5.9.3","@types/node":"22.10.5"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ng-token-saver_0.2.0_1790333716537_0.2598463792161587"}}},"time":{"created":"2026-07-31T05:50:35.350Z","modified":"2026-09-25T10:55:17.088Z","0.1.0":"2026-07-31T05:50:35.640Z","0.1.1":"2026-07-31T06:15:10.118Z","0.1.2":"2026-07-31T09:07:30.886Z","0.1.3":"2026-07-31T09:53:08.183Z","0.1.4":"2026-08-06T12:07:24.053Z","0.1.5":"2026-08-06T12:40:50.150Z","0.1.6":"2026-08-07T10:46:42.465Z","0.1.7":"2026-08-07T13:02:18.503Z","0.2.0":"2026-09-25T10:55:16.662Z"},"bugs":{"url":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver/issues"},"author":{"name":"Alex Ryabov"},"license":"GPL-3.0-or-later","homepage":"https://github.com/Alex88Ryabov/alex-apps-ng-token-saver#readme","keywords":["angular","mcp","mcp-server","model-context-protocol","ai-agents","language-server","angular-language-service","lsp","tokens","claude","cursor"],"repository":{"url":"git+https://github.com/Alex88Ryabov/alex-apps-ng-token-saver.git","type":"git"},"description":"MCP server for Angular: compiler-backed template answers, component contracts and version-accurate facts that save AI agents tokens","maintainers":[{"name":"alex_rbv","email":"ryabovsasha88@gmail.com"}],"readme":"# ng-token-saver\n\n[![npm version](https://img.shields.io/npm/v/%40alex-apps%2Fng-token-saver)](https://www.npmjs.com/package/@alex-apps/ng-token-saver)\n[![weekly downloads](https://img.shields.io/npm/dw/%40alex-apps%2Fng-token-saver)](https://www.npmjs.com/package/@alex-apps/ng-token-saver)\n[![node](https://img.shields.io/node/v/%40alex-apps%2Fng-token-saver)](#requirements-and-setup)\n[![license](https://img.shields.io/npm/l/%40alex-apps%2Fng-token-saver)](LICENSE)\n\nAn MCP server that lets an AI agent understand Angular **templates** by asking the same\ncompiler that builds the project, instead of guessing from file text. The token saving is\nmeasured, not promised.\n\nAngular ships a first-class language server, but no official AI integration exposes it — the\nAngular CLI MCP (`ng mcp`) works at the docs-and-build level and does not touch templates.\nThis server is that missing layer, and it answers **for the Angular version the project\nactually runs**.\n\nEverything below marked as measured was produced by running code against six real Angular\nworkspaces (17.3.12, 18.2.14, 19.2.25, 20.3.26, 21.2.18, 22.0.8) and two production projects.\nEvery number can be reproduced with the commands in\n[Reproducing the measurements](#reproducing-the-measurements).\n\n## Quick start\n\nThe language server ships as a regular dependency — nothing to install besides the package:\n\n```\nnpm install -g @alex-apps/ng-token-saver\n```\n\nClaude Code:\n\n```\nclaude mcp add ng-token-saver -- ng-token-saver\n```\n\nCodex CLI:\n\n```\ncodex mcp add ng-token-saver -- ng-token-saver\n```\n\nAny other MCP client:\n\n```json\n{ \"mcpServers\": { \"ng-token-saver\": { \"command\": \"ng-token-saver\" } } }\n```\n\nOr skip the install and let the client fetch it through npx:\n\n```json\n{ \"mcpServers\": { \"ng-token-saver\": { \"command\": \"npx\", \"args\": [\"-y\", \"@alex-apps/ng-token-saver\"] } } }\n```\n\nIn Cursor that npx form is one click:\n\n[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=ng-token-saver&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhbGV4LWFwcHMvbmctdG9rZW4tc2F2ZXIiXX0%3D)\n\nThe npm and npx paths are verified by running: the packed tarball (79 kB, dist only) was\ninstalled into a clean prefix and all four tool kinds answered through a real MCP client,\nand the npx form connects in 1.2–2.0 s from a warm npm cache (the very first run on a\nmachine also downloads the dependency tree — the language server alone unpacks to 13.6 MB).\n\nA first question to ask it — the contract of a component whose members are scattered across\nan extends chain. Asked for `fixtures/v17/src/app/derived-card.component.ts` (a fixture in\nthis repository), `ng_component_info` answers, verbatim:\n\n```json\n{\"found\":true,\"angularVersion\":\"17.3.12\",\"className\":\"DerivedCardComponent\",\"kind\":\"component\",\"selector\":\"app-derived-card\",\"standalone\":true,\"inlineTemplate\":true,\"styleUrls\":[],\"imports\":[],\"hostDirectives\":[],\"extends\":\"BasePanel\",\"ancestors\":[{\"name\":\"BasePanel\",\"file\":\"<repo>\\\\fixtures\\\\v17\\\\src\\\\app\\\\base-panel.ts\"},{\"name\":\"BaseWidget\",\"file\":\"<repo>\\\\fixtures\\\\v17\\\\src\\\\app\\\\base-widget.ts\"}],\"inputs\":[{\"name\":\"accent\",\"type\":\"boolean\"},{\"name\":\"heading\",\"type\":\"string\"},{\"name\":\"disabled\",\"type\":\"boolean\"}],\"outputs\":[{\"name\":\"blurred\",\"type\":\"void\"}],\"publicMembers\":[{\"name\":\"focus\",\"kind\":\"method\",\"signature\":\"focus(): void\",\"noop\":true},{\"name\":\"collapse\",\"kind\":\"method\",\"signature\":\"collapse(animated: boolean): void\",\"noop\":true}]}\n```\n\n811 characters with this checkout's absolute paths in place of `<repo>`, 305 ms on the\nsession's first call (it loads the project's own TypeScript), single-digit milliseconds after.\nThe asked file declares one input and an `extends` clause; `heading`, `disabled`, the output\nand both methods live in `BasePanel` and `BaseWidget` and are resolved statically, with their\nfiles named in `ancestors` for the next edit. `\"noop\": true` on `focus()` is the subclass\nshadowing it with an empty body — the kind of fact that otherwise costs a whole file read per\nancestor.\n\nConfigs for Cursor, VS Code, Windsurf, Codex CLI and JetBrains, the Node floor, and running\nfrom source are in [Requirements and setup](#requirements-and-setup).\n\n## The two problems it solves\n\n**1. No template awareness.** `grep` over an `.html` file cannot tell you where\n`{{ user().fullName }}` is declared, and no amount of reading gives you `TS2339 Property\n'emailAddress' does not exist on type 'UserVm'`. That is compiler output, not text.\n\n**2. Version drift.** The AI context files on angular.dev (`llms.txt`) describe only the\nnewest major and carry no version markers; the versioned archive sites serve none at all.\nOn v17–v21 they hand the agent instructions that produce APIs which do not exist. Measured\nexamples are in [Version facts](#version-facts).\n\n## Tools\n\nSix tools, 1040 characters of descriptions in total. Answers are dense JSON with no markdown.\n\n| Tool | What it answers | Needs the language server |\n|---|---|---|\n| `ng_template_definition` | where a symbol on a template line is declared — the line as Read shows it, the symbol by name | yes |\n| `ng_template_diagnostics` | Angular compiler errors for a template, or for a `files` batch; an entry anchored in the companion `.ts` carries `file`, a message repeated on several lines comes once with its `lines` | yes |\n| `ng_component_info` | the public contract of a component or directive | no |\n| `ng_workspace_map` | projects, versions, `strictTemplates` and zone.js per project | no |\n| `ng_version_rules` | what exists and what does not in this project's Angular version | no |\n| `ng_find_usages` | where a component, directive, pipe or service is used; with `input` — where that input is bound | no |\n\nFour of the six never start the language server, so they answer in milliseconds and keep\nworking on workspaces where the server refuses to load.\n\nSince 0.2.0 every position is 1-based, as Read shows it: `ng_template_definition` takes the\nline that way and the symbol by name (`character` is an alternative for a name that repeats on\nthe line). 0.1.x took a 0-based `line` and `character`, the LSP convention — the same numbers\nnow point one line lower.\n\n## Measured: contract instead of the whole file\n\n`ng_component_info` returns the public contract of a component rather than its source.\nMeasured across two production codebases through a real MCP client:\n\n| | Nx monorepo | CLI workspace\\* |\n|---|---|---|\n| Angular / TypeScript | 19.2.18 / 5.8.3 | 17.3.8 / 5.3.3 |\n| Components in the tally | 1298 | 407 |\n| Parse errors | 0 | 0 |\n| Sources | 5 404 708 chars | 1 735 223 chars |\n| Contracts (base-class members included) | 1 759 331 chars | 463 563 chars |\n| **Saved** | **67%** | **73%** |\n| **Saved in tokens** (o200k_base proxy) | **67%** | **71%** |\n| Contract shorter than source | 1201 of 1298 (93%) | 386 of 407 (95%) |\n| Flagged as partial | 1 of 1298 | 3 of 407 |\n| First call (loads the project's TypeScript) | 306 ms | 564 ms |\n\n\\* measured with the pre-0.1.2 wire format; the current format is leaner, so this saving\nis a floor.\n\nThe largest component in the monorepo shrinks from **177 863 to 10 770 characters** while\nlisting 117 contract members. Contracts include members inherited from base classes — the\nextends chain is resolved through relative imports, tsconfig path aliases and barrels.\nBefore that resolver, 91 of 1298 monorepo contracts were flagged as partial; now 1 is.\n\nThree caveats that travel with these numbers:\n\n- **Tokens are counted through a proxy** — OpenAI's `o200k_base`, since Claude's tokenizer\n  is not public; `cl100k_base` agrees within one point on this data. Characters are exact.\n- **The baseline is reading the whole file**, which is what an agent does by default.\n- **JSON tokenizes slightly worse than TypeScript**, so token savings sit a point or two\n  below character savings. The table carries both.\n\nOn small components there is no saving at all: a 17-line component produces a 578-character\ncontract against a 315-character source. The contract grows with the number of members, the\nsource with method bodies — and on production code the second wins almost always.\n\n## Measured: rename and diagnose\n\n**Renaming an input across usages.** The grep path an agent actually takes — read the\ncomponent file to learn the selector, then grep the selector and the binding spellings\nrepo-wide — against `ng_component_info` plus `ng_find_usages` with its `input` filter,\nwhich returns only the tags that bind the name, each entry pointing at the binding itself.\nOn the production monorepo, 6243 files scanned:\n\n| Component | grep path | bridge | saved (o200k) |\n|---|---|---|---|\n| 577 usages, `mask` bound on 5 tags | 50 527 tokens | 1 035 tokens | **98%** |\n| 466 usages, `icon` bound on 463 tags | 41 698 tokens | 22 566 tokens | **46%** |\n| 1211 usages, `name` bound on 1134 tags | 129 227 tokens | 30 650 tokens | 76%\\* |\n\n\\* the tool returns at most 500 entries per answer, and the answer says so.\n\nThe saving is decided by how many of the usages actually bind the input: `mask` is bound on\n5 of 568 tags, and grep still prints every selector line plus 67 binding-shaped lines from\nacross the repo — 62 of them somebody else's `mask` — while the bridge answers with exactly\nthose five sites.\n\n**Diagnosing a template that will not compile.** A whole-project compiler listing costs\n**395 tokens and 1321 ms**; one `ng_template_diagnostics` call answers with the asked\nfile's diagnostics in **81 tokens, 1 ms warm**. The gap only widens with project size: the\nlisting grows with the project, the answer does not. After an edit, fresh diagnostics\narrive as a 340–400 ms push — against a rebuild.\n\n## Version facts\n\n`ng_version_rules` contains no rule taken from documentation: the data comes from importing\nthe packages actually installed in each fixture and from running the compiler.\n\n**The zoneless provider is renamed between v19 and v20.**\n\n| API | v17 | v18 | v19 | v20 | v21 | v22 |\n|---|---|---|---|---|---|---|\n| `provideExperimentalZonelessChangeDetection` | – | yes | yes | – | – | – |\n| `provideZonelessChangeDetection` | – | – | – | yes | yes | yes |\n\nAdvice to \"enable zoneless\" without a version breaks on three majors out of six.\n\n**Existing is not the same as ready.** The `@experimental` and `@developerPreview` tags live\nonly in declaration JSDoc and are invisible at runtime:\n\n| API | v17 | v18 | v19 | v20 | v21 | v22 |\n|---|---|---|---|---|---|---|\n| `input`, `output`, `model`, `viewChild`, `contentChild` | preview | preview | stable | stable | stable | stable |\n| `effect`, `toObservable` | preview | preview | preview | stable | stable | stable |\n| `linkedSignal`, `afterRenderEffect` | – | – | preview | stable | stable | stable |\n| `resource`, `rxResource`, `httpResource` | – | – | **experimental** | **experimental** | **experimental** | stable |\n\nSo \"rewrite `@Input()` as `input()`\" on a v17 or v18 project means moving to a non-public\nAPI, and `resource()` was experimental all the way through v21. A batch of signal APIs\nappears exactly at v19: `linkedSignal`, `resource`, `rxResource`, `httpResource`,\n`afterRenderEffect`, `provideAppInitializer`.\n\n**Two documentation claims that measurement contradicted:** `standalone` becomes the default\nat **v19**, not v20; and `*ngIf` is not removed in 22.0.8 — it reports hint `TS6385` (TypeScript's\ndeprecation hint) and keeps working, with `NgIf` still exported from `@angular/common`.\n\n**Compiler gates**, read in the 22.0.8 bundle and confirmed by running it — keyed on the\nproject's Angular version, which the server detects from `@angular/core` next to the tsconfig\n(`--angularCoreVersion` is passed too, as a fallback):\n\n| Feature | Gate |\n|---|---|\n| `@if` / `@for` / `@switch` blocks | ≥ 17.0.0 |\n| signals in two-way bindings | ≥ 17.2.0-0 |\n| `@let` | ≥ 18.1.0 |\n| implicit `standalone` | ≥ 19.0.0 |\n| DOM event type assertion | ≥ 20.2.0 |\n\nAlso measured: Signal Forms (`@angular/forms/signals`) exist only from v21 and are stable on\n22.0.8; `AbstractControl.events` from v18; `TestBed.tick` from v20.\n\nOutside the measured v17–v22 range `ng_version_rules` returns nothing and says so —\nextrapolating \"it was in v22, so it is in v23\" is exactly the failure it exists to prevent.\n\n## Honesty as a feature\n\nAn incomplete answer says so, in words, inside the answer:\n\n- A contract merges base-class members and host-directive exposures, resolved statically\n  through relative imports, tsconfig aliases and barrels. Where the walk cannot continue —\n  a base class from a package, a mixin call — the answer carries `incomplete`, naming the\n  class and the file to ask about next.\n- `ng_version_rules` reports `notMeasured` topics, and a `caveat` when your minor differs\n  from the measured one.\n- `ng_find_usages` labels declarations as `declaration`, admits when class-name matches were\n  found without resolving imports, and names selector twins — a second declaration of the\n  same selector elsewhere in the workspace — instead of silently mixing their usages.\n- `ng_template_diagnostics` separates three states that all look like an empty list: the\n  template is clean; the server is silently down (caught by a canary probe); or template\n  checking is off for this project — then the answer carries `checksDisabled` naming the\n  tsconfig responsible. In the measured monorepo `strictTemplates` is off in two of seven\n  applications, so the distinction is not theoretical.\n\n## What this is not\n\n- **Not better than a careful `grep` at finding usages.** `grep -rn \"<app-widget\"` finds the\n  same 62 usages. What `ng_find_usages` adds: the selector and class name are derived from\n  the file for you, usage kinds are labelled, all four attribute-binding spellings are\n  covered, and `path` scopes the scan — 33 selectors in the measured monorepo are declared\n  in two applications at once, and an unscoped search would mix them.\n- **Not a replacement for the Angular CLI MCP** — a different layer. `ng mcp` covers docs,\n  best practices and build orchestration; none of its nine tools touches templates or the\n  language server. The two complement each other.\n- **Not a type checker of its own.** The LSP-backed tools deliver the project's own compiler\n  output, undistorted.\n\nKnown gaps are recorded, not hidden: a base class from a package or behind a mixin call\nstops the ancestor walk (1 of 1298 components in the measured monorepo), Nx projects with\ninferred targets come without `tsConfig`, and pipe twins are not detected.\n\n## Requirements and setup\n\n- **Node ≥ 18.20.8** — the measured floor: the published package answered on clean Node\n  18.20.8, 20.20.2 and 22.x. This is about the MCP server process only — **your project\n  keeps building on its own Node**. To give just the server a newer runtime, point the\n  client config at that binary: `\"command\": \"C:\\\\node22\\\\node.exe\"`.\n\n**From source** (instead of npm):\n\n- The project's own dependencies: `npm install`, then `npm run build`.\n- The shipped language-server branch lives in `tools/servers/ls22` and needs `npm ci` there once.\n- In every client config, replace the `ng-token-saver` command with `node <path>/dist/index.js`;\n  for Claude Code: `claude mcp add ng-token-saver -- node <path>/dist/index.js`.\n\n`node_modules` folders are not committed, including the twelve inside the stand. To restore\nthe full measurement environment:\n\n```\nnpm install && npm run build\ncd tools/servers/ls22 && npm ci        # the branch actually shipped\ncd fixtures/v22 && npm ci              # repeat per fixture you want to run\n```\n\n### Clients\n\nThe server is a plain stdio MCP server with no client-specific features, so any MCP client\ncan launch it; installation and Claude Code registration are in [Quick start](#quick-start).\nUsage guidance for the agent travels in the MCP `instructions` field — see\n[Using with agents](#using-with-agents).\n\n**Cursor** — the one-click button in Quick start, or the same `mcpServers` JSON as in\nQuick start, in `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project).\n\n**Windsurf** — the same JSON, in `~/.codeium/windsurf/mcp_config.json`.\n\n**VS Code (Copilot agent mode)** — `.vscode/mcp.json`; the key is `servers` and the entry\ntakes a `type`:\n\n```json\n{ \"servers\": { \"ng-token-saver\": { \"type\": \"stdio\", \"command\": \"ng-token-saver\" } } }\n```\n\n**Codex CLI** — `codex mcp add ng-token-saver -- ng-token-saver`, or `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.ng-token-saver]\ncommand = \"ng-token-saver\"\n```\n\n**JetBrains AI Assistant / Junie** — Settings → Tools → AI Assistant → Model Context\nProtocol accepts the same JSON as Quick start's; for Junie, additionally enable \"Pass\ncustom MCP servers\".\n\nConfiguration, all variables optional:\n\n- `NG_TOKEN_SAVER_IDLE_MS` — a language-server session unused this long shuts its ngserver\n  down; the next call pays the cold start again. Default 900000 (15 minutes); `0` keeps\n  sessions alive until the server exits. A session with a call in flight is never shut down.\n- `NG_TOKEN_SAVER_PREWARM=1` — `ng_workspace_map` with a `path` inside an app starts loading\n  that app into the language server in the background, so the first diagnostics or definition\n  call finds it ready: 21 s → 1.4 s on the production monorepo. The cost is ~1 GB of memory\n  until the idle shutdown, whether or not an LSP tool follows; a folder holding several projects\n  (a workspace root, an Nx `apps/`) is not warmed, since which app to load is unknown.\n- `NG_TOKEN_SAVER_SERVERS_DIR` — where the language-server branch lives, if not in\n  `tools/servers` next to the build.\n\n## Using with agents\n\nThe server sends its usage guidance in the MCP `instructions` field (924 characters), which\nClaude Code keeps in the agent's context even when tool descriptions are deferred until a tool\nsearch (checked on Claude Code 2.1.282: the whole text arrives while the tools show only their\nnames). For a client that ignores `instructions`, the same text goes into `CLAUDE.md` or\n`AGENTS.md`:\n\n> Angular tools that answer from the compiler and the source instead of whole files. Prefer\n> them to reading and grepping: ng_component_info for what a component or directive accepts\n> (inputs, outputs, members, inherited ones included) instead of reading its .ts;\n> ng_find_usages for where a component, directive, pipe or service is used, and with input for\n> where one input is bound, instead of grep; ng_template_diagnostics after editing a template\n> instead of ng build; ng_template_definition for what a template symbol is; ng_version_rules\n> before suggesting an Angular API; ng_workspace_map once for projects, versions and\n> strictTemplates. The first diagnostics or definition call in a workspace loads the project\n> into the Angular language server and takes up to a minute on a large workspace; later calls\n> take milliseconds, so a slow first answer is not a hang. Lines and characters are 1-based\n> everywhere, as Read shows them.\n\n## Reproducing the measurements\n\n```\nnpm test                                  build plus 182 unit tests (node:test, no dependencies)\nnpm run smoke                             end-to-end check with a real MCP client over stdio\nnpm run bench:settle                      whether a pause after didOpen is needed (it is not)\nnpm run bench:standalone                  where standalone becomes the default (v17..v22)\nnpm run bench:api                         which Angular APIs exist in which majors, and their stability\nnpm run bench:contract <project root>     contract size against reading whole files (--tokens adds token counts)\nnpm run bench:rename <component> <input>  the grep path against the bridge for an input rename\nnpm run bench:diagnose                    a compiler listing against one diagnostics call\nnpm run bench:matrix                      resolution probes across a fixture\nnpm run bench:negative                    what the server returns when things break\nnpm run bench:didchange                   diagnostics timing after an edit\n```\n\nThe stand is `fixtures/v17..v22` — six real Angular workspaces, each with its own\n`node_modules` and its own pinned TypeScript, plus `fixtures/negative/*` for failure cases.\n\n## Status\n\nAll six tools verified on the six fixtures and on two production codebases — 1298 and 407\ncomponents, zero parse errors — plus one Angular 16 project to check that out-of-range\nrefusals are structured rather than silent. 182 unit tests, all green.\n\nMeasured latency: the two LSP-backed tools pay 8–28 s of cold start on the first call and\nanswer in 2–9 ms after it; the four static tools answer in 250–600 ms on the first call and\nin milliseconds once the project's TypeScript is cached. A session idle for 15 minutes shuts\nits language server down, and the next call pays the cold start again — see\n`NG_TOKEN_SAVER_IDLE_MS` above.\n\n## License\n\nGPL-3.0-or-later — see [LICENSE](LICENSE). Copyright (C) 2026 Alex Ryabov.\nUse and modify freely; derivative works must stay open under the same license.\n","readmeFilename":"README.md"}