toolcraft 0.0.145 → 0.0.146

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/composition.json CHANGED
@@ -113,7 +113,7 @@
113
113
  },
114
114
  {
115
115
  "name": "toolcraft",
116
- "version": "0.0.145",
116
+ "version": "0.0.146",
117
117
  "license": "MIT"
118
118
  },
119
119
  {
@@ -123,7 +123,7 @@
123
123
  },
124
124
  {
125
125
  "name": "toolcraft-schema",
126
- "version": "0.0.145",
126
+ "version": "0.0.146",
127
127
  "license": "MIT"
128
128
  },
129
129
  {
@@ -113,7 +113,7 @@
113
113
  },
114
114
  {
115
115
  "name": "toolcraft",
116
- "version": "0.0.145",
116
+ "version": "0.0.146",
117
117
  "license": "MIT"
118
118
  },
119
119
  {
@@ -123,7 +123,7 @@
123
123
  },
124
124
  {
125
125
  "name": "toolcraft-schema",
126
- "version": "0.0.145",
126
+ "version": "0.0.146",
127
127
  "license": "MIT"
128
128
  },
129
129
  {
package/dist/index.d.ts CHANGED
@@ -95,6 +95,12 @@ export interface Renderers<TResult> {
95
95
  markdown?: (result: TResult, primitives: RenderPrimitives) => string;
96
96
  json?: (result: TResult, primitives: RenderPrimitives) => unknown;
97
97
  }
98
+ export interface ToolAnnotations {
99
+ readOnlyHint?: boolean;
100
+ destructiveHint?: boolean;
101
+ idempotentHint?: boolean;
102
+ openWorldHint?: boolean;
103
+ }
98
104
  export type HandlerContext<TParamsSchema extends ObjectSchema<any> = AnyObjectSchema, TSecrets extends SecretDeclarations | undefined = undefined, TServices extends object = EmptyServices> = TServices & {
99
105
  params: Static<TParamsSchema>;
100
106
  secrets: InferSecrets<TSecrets>;
@@ -106,7 +112,9 @@ export type HandlerContext<TParamsSchema extends ObjectSchema<any> = AnyObjectSc
106
112
  };
107
113
  export interface CommandConfig<TServices extends object, TParamsSchema extends ObjectSchema<any>, TSecrets extends SecretDeclarations | undefined, TResult> {
108
114
  name: string;
115
+ title?: string;
109
116
  description?: string;
117
+ annotations?: ToolAnnotations;
110
118
  hidden?: boolean;
111
119
  examples?: CommandExample[];
112
120
  aliases?: string[];
@@ -138,7 +146,9 @@ export interface StreamCommandConfig<TServices extends object, TParamsSchema ext
138
146
  export interface Command<TServices extends object = EmptyServices, TParamsSchema extends ObjectSchema<any> = AnyObjectSchema, TSecrets extends SecretDeclarations | undefined = undefined, TResult = unknown> {
139
147
  kind: "command";
140
148
  name: string;
149
+ title?: string;
141
150
  description?: string;
151
+ annotations?: ToolAnnotations;
142
152
  hidden: boolean;
143
153
  examples: CommandExample[];
144
154
  aliases: string[];
package/dist/index.js CHANGED
@@ -33,6 +33,9 @@ function cloneRequires(requires) {
33
33
  check: requires.check
34
34
  };
35
35
  }
36
+ function cloneToolAnnotations(annotations) {
37
+ return annotations === undefined ? undefined : { ...annotations };
38
+ }
36
39
  function cloneStringArray(values) {
37
40
  return values === undefined ? undefined : [...values];
38
41
  }
@@ -291,7 +294,9 @@ function createBaseCommand(config) {
291
294
  const command = {
292
295
  kind: "command",
293
296
  name: config.name,
297
+ title: config.title,
294
298
  description: config.description,
299
+ annotations: cloneToolAnnotations(config.annotations),
295
300
  hidden: config.hidden ?? false,
296
301
  examples: cloneCommandExamples(config.examples),
297
302
  aliases: [...(config.aliases ?? [])],
@@ -309,6 +314,8 @@ function createBaseCommand(config) {
309
314
  };
310
315
  Object.defineProperty(command, commandConfigSymbol, {
311
316
  value: {
317
+ title: config.title,
318
+ annotations: cloneToolAnnotations(config.annotations),
312
319
  scope: cloneScope(config.scope),
313
320
  hidden: config.hidden ?? false,
314
321
  examples: cloneCommandExamples(config.examples),
@@ -360,7 +367,9 @@ function materializeCommand(command, inherited) {
360
367
  const materialized = {
361
368
  kind: "command",
362
369
  name: command.name,
370
+ title: internal.title,
363
371
  description: command.description,
372
+ annotations: cloneToolAnnotations(internal.annotations),
364
373
  hidden: internal.hidden,
365
374
  examples: cloneCommandExamples(internal.examples),
366
375
  aliases: [...command.aliases],
@@ -378,6 +387,8 @@ function materializeCommand(command, inherited) {
378
387
  };
379
388
  Object.defineProperty(materialized, commandConfigSymbol, {
380
389
  value: {
390
+ title: internal.title,
391
+ annotations: cloneToolAnnotations(internal.annotations),
381
392
  scope: cloneScope(internal.scope),
382
393
  hidden: internal.hidden,
383
394
  examples: cloneCommandExamples(internal.examples),
package/dist/mcp.js CHANGED
@@ -222,6 +222,8 @@ function enumerateTools(root, casing, allowlist, omitRootToolNamePrefix) {
222
222
  command: node,
223
223
  commandPath: resolvedCommandPath,
224
224
  name,
225
+ ...(node.title === undefined ? {} : { title: node.title }),
226
+ ...(node.annotations === undefined ? {} : { annotations: { ...node.annotations } }),
225
227
  description: buildToolDescription(node.description, params, node.examples, node.name, casing),
226
228
  inputSchema: applySchemaCasing(toJsonSchema(params), casing),
227
229
  ...(node.result === undefined
@@ -915,12 +917,18 @@ function createResolvedMCPServer(root, options, runtime = {}) {
915
917
  throw toToolError(error, report?.displayPath);
916
918
  }
917
919
  };
918
- if (tool.outputSchema === undefined) {
919
- server.tool(tool.name, tool.description, tool.inputSchema, handler);
920
- }
921
- else {
922
- server.tool(tool.name, tool.description, tool.inputSchema, handler, tool.outputSchema);
923
- }
920
+ server.registerTool({
921
+ name: tool.name,
922
+ ...(tool.title === undefined ? {} : { title: tool.title }),
923
+ description: tool.description,
924
+ inputSchema: tool.inputSchema,
925
+ ...(tool.outputSchema === undefined
926
+ ? {}
927
+ : {
928
+ outputSchema: tool.outputSchema
929
+ }),
930
+ ...(tool.annotations === undefined ? {} : { annotations: tool.annotations })
931
+ }, handler);
924
932
  }
925
933
  return {
926
934
  ...server,
@@ -8,7 +8,7 @@
8
8
  },
9
9
  {
10
10
  "name": "toolcraft-schema",
11
- "version": "0.0.145",
11
+ "version": "0.0.146",
12
12
  "license": "MIT"
13
13
  }
14
14
  ]
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "toolcraft-schema",
3
- "version": "0.0.145",
3
+ "version": "0.0.146",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "toolcraft",
3
- "version": "0.0.145",
3
+ "version": "0.0.146",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -158,7 +158,7 @@
158
158
  "yaml"
159
159
  ],
160
160
  "optionalDependencies": {
161
- "toolcraft-schema": "0.0.145",
161
+ "toolcraft-schema": "0.0.146",
162
162
  "toolcraft-design": "*",
163
163
  "@poe-code/frontmatter": "*",
164
164
  "@poe-code/agent-mcp-config": "*",