@trazum/mcp 2.4.1 → 2.4.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -1
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +35 -0
- package/dist/rpc.js.map +1 -1
- package/package.json +3 -3
- package/src/rpc.ts +43 -0
package/README.md
CHANGED
|
@@ -74,7 +74,10 @@ relaxing it here would have been backwards.
|
|
|
74
74
|
The protocol implementation covers what a tools-only server needs — `initialize`,
|
|
75
75
|
`notifications/initialized`, `tools/list`, `tools/call`, `ping` — and answers
|
|
76
76
|
anything else with `-32601 Method not found`. No resources, no prompts, no
|
|
77
|
-
sampling.
|
|
77
|
+
sampling. An argument a tool's schema does not declare is refused as an
|
|
78
|
+
`isError` result naming it and the declared name it most likely meant
|
|
79
|
+
(`output_tokens` → `outputTokens`), never ignored: a dropped key read as its
|
|
80
|
+
default is how `spend_guard` once said yes to a call over budget. It is driven by a raw newline-delimited client in the tests; it has not
|
|
78
81
|
been driven by every MCP client in existence.
|
|
79
82
|
|
|
80
83
|
Token counts are estimates (±4% on CJK, ±6% on Latin prose, ±26% on code,
|
package/dist/rpc.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,6EAA6E;AAC7E,eAAO,MAAM,KAAK;aAChB,KAAK,EAAE,CAAC,KAAK;aACb,cAAc,EAAE,CAAC,KAAK;aACtB,cAAc,EAAE,CAAC,KAAK;aACtB,aAAa,EAAE,CAAC,KAAK;aACrB,QAAQ,EAAE,CAAC,KAAK;CACR,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;OAGG;IACH,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;CAChD;AAED,iFAAiF;AACjF,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;
|
|
1
|
+
{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,6EAA6E;AAC7E,eAAO,MAAM,KAAK;aAChB,KAAK,EAAE,CAAC,KAAK;aACb,cAAc,EAAE,CAAC,KAAK;aACtB,cAAc,EAAE,CAAC,KAAK;aACtB,aAAa,EAAE,CAAC,KAAK;aACrB,QAAQ,EAAE,CAAC,KAAK;CACR,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;OAGG;IACH,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;CAChD;AAED,iFAAiF;AACjF,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;AA+B9C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,IAAI,EAAE,UAAU,GACf,MAAM,GAAG,IAAI,CAqIf;AAUD;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,CAAC,cAAc,EAC5B,MAAM,EAAE,MAAM,CAAC,cAAc,EAC7B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,IAAI,EAAE,UAAU,GACf,IAAI,CAwCN"}
|
package/dist/rpc.js
CHANGED
|
@@ -37,6 +37,31 @@ export const ERROR = {
|
|
|
37
37
|
/** Thrown by a tool when its arguments are wrong. Distinguished from a crash. */
|
|
38
38
|
export class InvalidArguments extends Error {
|
|
39
39
|
}
|
|
40
|
+
/**
|
|
41
|
+
* Arguments a tool's schema closes the door on, and the declared name each one
|
|
42
|
+
* most likely meant.
|
|
43
|
+
*
|
|
44
|
+
* Every schema says `additionalProperties: false`, and `rpc.test.js` held that
|
|
45
|
+
* it says so, while nothing held that the server did so: `spend_guard` called
|
|
46
|
+
* with `output_tokens` instead of `outputTokens` read zero output tokens and
|
|
47
|
+
* answered "yes" to a call that broke the budget, where the correct spelling
|
|
48
|
+
* answered "no". Agents write snake_case readily. A budget guard that turns a
|
|
49
|
+
* typo into permission is the failure it exists to prevent, so the schema is
|
|
50
|
+
* enforced here, once, for every tool.
|
|
51
|
+
*/
|
|
52
|
+
function undeclaredArguments(schema, args) {
|
|
53
|
+
if (schema['additionalProperties'] !== false)
|
|
54
|
+
return [];
|
|
55
|
+
const properties = schema['properties'];
|
|
56
|
+
const declared = typeof properties === 'object' && properties !== null ? Object.keys(properties) : [];
|
|
57
|
+
/* Case and separators only: `output_tokens`, `OutputTokens` and
|
|
58
|
+
`output-tokens` are one name, and anything further is not a guess worth
|
|
59
|
+
offering. */
|
|
60
|
+
const squash = (name) => name.toLowerCase().replace(/[^a-z0-9]/g, '');
|
|
61
|
+
return Object.keys(args)
|
|
62
|
+
.filter((key) => !declared.includes(key))
|
|
63
|
+
.map((key) => ({ key, meant: declared.find((name) => squash(name) === squash(key)) ?? null }));
|
|
64
|
+
}
|
|
40
65
|
/**
|
|
41
66
|
* Handles one decoded message and returns the response, or `null` for a
|
|
42
67
|
* notification.
|
|
@@ -122,6 +147,16 @@ export function handle(message, tools, info) {
|
|
|
122
147
|
const args = typeof params.arguments === 'object' && params.arguments !== null
|
|
123
148
|
? params.arguments
|
|
124
149
|
: {};
|
|
150
|
+
const undeclared = undeclaredArguments(tool.inputSchema, args);
|
|
151
|
+
if (undeclared.length > 0) {
|
|
152
|
+
const declared = Object.keys(tool.inputSchema['properties'] ?? {});
|
|
153
|
+
const named = undeclared
|
|
154
|
+
.map(({ key, meant }) => (meant ? `"${key}" (did you mean "${meant}"?)` : `"${key}"`))
|
|
155
|
+
.join(', ');
|
|
156
|
+
const text = `${tool.name} does not take ${named}, and guessing what it meant would change the answer.`
|
|
157
|
+
+ ` It takes: ${declared.join(', ') || 'no arguments'}.`;
|
|
158
|
+
return { jsonrpc: '2.0', id, result: { content: [{ type: 'text', text }], isError: true } };
|
|
159
|
+
}
|
|
125
160
|
try {
|
|
126
161
|
return {
|
|
127
162
|
jsonrpc: '2.0',
|
package/dist/rpc.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAS7C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,CAAC,KAAK;IACb,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,aAAa,EAAE,CAAC,KAAK;IACrB,QAAQ,EAAE,CAAC,KAAK;CACR,CAAC;AAeX,iFAAiF;AACjF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;CAAG;
|
|
1
|
+
{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@trazum/mcp",
|
|
3
|
-
"version": "2.4.
|
|
3
|
+
"version": "2.4.2",
|
|
4
4
|
"mcpName": "io.github.Davmunrey/trazum",
|
|
5
5
|
"description": "Trazum as an MCP server: let an agent price and budget its own prompts before it sends them.",
|
|
6
6
|
"license": "MIT",
|
|
@@ -42,10 +42,10 @@
|
|
|
42
42
|
"prepublishOnly": "npm run build && npm test"
|
|
43
43
|
},
|
|
44
44
|
"dependencies": {
|
|
45
|
-
"@trazum/core": "2.4.
|
|
45
|
+
"@trazum/core": "2.4.2"
|
|
46
46
|
},
|
|
47
47
|
"devDependencies": {
|
|
48
|
-
"@types/node": "^26.
|
|
48
|
+
"@types/node": "^26.6.3",
|
|
49
49
|
"typescript": "^7.0.2"
|
|
50
50
|
},
|
|
51
51
|
"engines": {
|
package/src/rpc.ts
CHANGED
|
@@ -60,6 +60,35 @@ export interface ToolDefinition {
|
|
|
60
60
|
/** Thrown by a tool when its arguments are wrong. Distinguished from a crash. */
|
|
61
61
|
export class InvalidArguments extends Error {}
|
|
62
62
|
|
|
63
|
+
/**
|
|
64
|
+
* Arguments a tool's schema closes the door on, and the declared name each one
|
|
65
|
+
* most likely meant.
|
|
66
|
+
*
|
|
67
|
+
* Every schema says `additionalProperties: false`, and `rpc.test.js` held that
|
|
68
|
+
* it says so, while nothing held that the server did so: `spend_guard` called
|
|
69
|
+
* with `output_tokens` instead of `outputTokens` read zero output tokens and
|
|
70
|
+
* answered "yes" to a call that broke the budget, where the correct spelling
|
|
71
|
+
* answered "no". Agents write snake_case readily. A budget guard that turns a
|
|
72
|
+
* typo into permission is the failure it exists to prevent, so the schema is
|
|
73
|
+
* enforced here, once, for every tool.
|
|
74
|
+
*/
|
|
75
|
+
function undeclaredArguments(
|
|
76
|
+
schema: Record<string, unknown>,
|
|
77
|
+
args: Record<string, unknown>,
|
|
78
|
+
): { key: string; meant: string | null }[] {
|
|
79
|
+
if (schema['additionalProperties'] !== false) return [];
|
|
80
|
+
const properties = schema['properties'];
|
|
81
|
+
const declared =
|
|
82
|
+
typeof properties === 'object' && properties !== null ? Object.keys(properties) : [];
|
|
83
|
+
/* Case and separators only: `output_tokens`, `OutputTokens` and
|
|
84
|
+
`output-tokens` are one name, and anything further is not a guess worth
|
|
85
|
+
offering. */
|
|
86
|
+
const squash = (name: string): string => name.toLowerCase().replace(/[^a-z0-9]/g, '');
|
|
87
|
+
return Object.keys(args)
|
|
88
|
+
.filter((key) => !declared.includes(key))
|
|
89
|
+
.map((key) => ({ key, meant: declared.find((name) => squash(name) === squash(key)) ?? null }));
|
|
90
|
+
}
|
|
91
|
+
|
|
63
92
|
export interface ServerInfo {
|
|
64
93
|
name: string;
|
|
65
94
|
version: string;
|
|
@@ -165,6 +194,20 @@ export function handle(
|
|
|
165
194
|
? (params.arguments as Record<string, unknown>)
|
|
166
195
|
: {};
|
|
167
196
|
|
|
197
|
+
const undeclared = undeclaredArguments(tool.inputSchema, args);
|
|
198
|
+
if (undeclared.length > 0) {
|
|
199
|
+
const declared = Object.keys(
|
|
200
|
+
(tool.inputSchema['properties'] as Record<string, unknown> | undefined) ?? {},
|
|
201
|
+
);
|
|
202
|
+
const named = undeclared
|
|
203
|
+
.map(({ key, meant }) => (meant ? `"${key}" (did you mean "${meant}"?)` : `"${key}"`))
|
|
204
|
+
.join(', ');
|
|
205
|
+
const text =
|
|
206
|
+
`${tool.name} does not take ${named}, and guessing what it meant would change the answer.`
|
|
207
|
+
+ ` It takes: ${declared.join(', ') || 'no arguments'}.`;
|
|
208
|
+
return { jsonrpc: '2.0', id, result: { content: [{ type: 'text', text }], isError: true } };
|
|
209
|
+
}
|
|
210
|
+
|
|
168
211
|
try {
|
|
169
212
|
return {
|
|
170
213
|
jsonrpc: '2.0',
|