toolcraft 0.0.146 → 0.0.147

package/README.md

@@ -334,6 +334,28 @@ defineCommand({
 });
 ```
 
+MCP assumes an unannotated tool may mutate data destructively, is not safe to retry, and can
+interact with an open world. Declare the standard hints on each MCP command so clients can present
+the operation accurately:
+
+```ts
+defineCommand({
+  name: "inspect",
+  title: "Inspect deployment",
+  description: "Inspect a deployment without changing it.",
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+  },
+  scope: ["mcp"],
+  params: S.Object({ deploymentId: S.String() }),
+  result: S.Object({ status: S.String() }),
+  handler: async ({ params }) => inspectDeployment(params.deploymentId)
+});
+```
+
 ## HTTP errors
 
 Toolcraft exports a fixed HTTP error hierarchy for transports and generated API clients:
@@ -554,7 +576,9 @@ Toolcraft configuration is code-first. Use `defineCommand(config)` and `defineGr
 ### `defineCommand(config)`
 
 - `name: string`
+- `title?: string` — human-readable MCP display name.
 - `description?: string`
+- `annotations?: { title?; readOnlyHint?; destructiveHint?; idempotentHint?; openWorldHint? }` — standard MCP behavior hints passed through unchanged.
 - `aliases?: string[]`
 - `positional?: string[]` — parameter names mapped from CLI argv order.
 - `params: S.Object(...)` — input schema from `toolcraft-schema`.

package/composition.json

@@ -98,7 +98,7 @@
     },
     {
       "name": "tiny-http-mcp-server",
-      "version": "0.1.6",
+      "version": "0.1.7",
       "license": "MIT"
     },
     {
@@ -113,7 +113,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.146",
+      "version": "0.0.147",
       "license": "MIT"
     },
     {
@@ -123,7 +123,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.146",
+      "version": "0.0.147",
       "license": "MIT"
     },
     {

package/dist/composition.json

@@ -98,7 +98,7 @@
     },
     {
       "name": "tiny-http-mcp-server",
-      "version": "0.1.6",
+      "version": "0.1.7",
       "license": "MIT"
     },
     {
@@ -113,7 +113,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.146",
+      "version": "0.0.147",
       "license": "MIT"
     },
     {
@@ -123,7 +123,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.146",
+      "version": "0.0.147",
       "license": "MIT"
     },
     {

package/dist/index.d.ts

@@ -95,7 +95,9 @@ export interface Renderers<TResult> {
     markdown?: (result: TResult, primitives: RenderPrimitives) => string;
     json?: (result: TResult, primitives: RenderPrimitives) => unknown;
 }
+/** Standard MCP hints that describe a tool's behavior to clients. */
 export interface ToolAnnotations {
+    title?: string;
     readOnlyHint?: boolean;
     destructiveHint?: boolean;
     idempotentHint?: boolean;

package/dist/mcp-proxy.js

@@ -78,7 +78,9 @@ function createProxyCommand(parent, tool, commandName, connection) {
     return markProxyNode({
         kind: "command",
         name: commandName,
+        title: tool.title,
         description: tool.description,
+        annotations: tool.annotations === undefined ? undefined : { ...tool.annotations },
         hidden: false,
         examples: [],
         aliases: [],

package/dist/mcp.js

@@ -219,11 +219,11 @@ function enumerateTools(root, casing, allowlist, omitRootToolNamePrefix) {
             }
             commandPathsByToolName.set(name, resolvedCommandPath);
             tools.push({
+                ...(node.annotations === undefined ? {} : { annotations: { ...node.annotations } }),
                 command: node,
                 commandPath: resolvedCommandPath,
                 name,
                 ...(node.title === undefined ? {} : { title: node.title }),
-                ...(node.annotations === undefined ? {} : { annotations: { ...node.annotations } }),
                 description: buildToolDescription(node.description, params, node.examples, node.name, casing),
                 inputSchema: applySchemaCasing(toJsonSchema(params), casing),
                 ...(node.result === undefined

package/node_modules/tiny-http-mcp-server/dist/composition.json

@@ -18,7 +18,7 @@
     },
     {
       "name": "tiny-http-mcp-server",
-      "version": "0.1.6",
+      "version": "0.1.7",
       "license": "MIT"
     },
     {

package/node_modules/tiny-http-mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-http-mcp-server",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Minimal MCP server over HTTP built on tiny-stdio-mcp-server",
   "type": "module",
   "main": "dist/index.js",

package/node_modules/tiny-mcp-client/dist/index.d.ts

@@ -304,6 +304,7 @@ declare class McpClient {
 }
 interface Tool {
     name: string;
+    title?: string;
     description?: string;
     inputSchema: Record<string, unknown>;
     outputSchema?: Record<string, unknown>;

package/node_modules/tiny-stdio-mcp-server/dist/composition.json

@@ -8,7 +8,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.146",
+      "version": "0.0.147",
       "license": "MIT"
     }
   ]

package/node_modules/toolcraft-schema/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft-schema",
-  "version": "0.0.146",
+  "version": "0.0.147",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft",
-  "version": "0.0.146",
+  "version": "0.0.147",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -158,7 +158,7 @@
     "yaml"
   ],
   "optionalDependencies": {
-    "toolcraft-schema": "0.0.146",
+    "toolcraft-schema": "0.0.147",
     "toolcraft-design": "*",
     "@poe-code/frontmatter": "*",
     "@poe-code/agent-mcp-config": "*",