@vibeframe/cli 0.110.0 → 0.111.0

package/dist/tools/adapters/mcp.d.ts

@@ -17,10 +17,20 @@ export interface McpInputSchema {
     required: string[];
     description?: string;
 }
+/** MCP spec ToolAnnotations — safety hints surfaced to hosts. */
+export interface McpToolAnnotations {
+    readOnlyHint: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint: boolean;
+}
 export interface McpTool {
     name: string;
+    /** Human-readable display name (MCP BaseMetadata.title). */
+    title: string;
     description: string;
     inputSchema: McpInputSchema;
+    annotations: McpToolAnnotations;
 }
 /**
  * Structural mirror of the MCP elicitation form request/result (the CLI

package/dist/tools/adapters/mcp.js

@@ -211,16 +211,29 @@ function manifestToMcpTools(manifest) {
     const inputSchema = zodToJsonSchema(t.schema);
     return {
       name: t.name,
+      title: t.title,
       description: t.description,
       inputSchema: {
         type: "object",
         properties: inputSchema.properties ?? {},
         required: inputSchema.required ?? [],
         ...inputSchema.description ? { description: inputSchema.description } : {}
-      }
+      },
+      annotations: toMcpAnnotations(t.annotations)
     };
   });
 }
+function toMcpAnnotations(a) {
+  if (a.readOnly) {
+    return { readOnlyHint: true, openWorldHint: a.openWorld };
+  }
+  return {
+    readOnlyHint: false,
+    destructiveHint: a.destructive ?? true,
+    ...a.idempotent !== void 0 ? { idempotentHint: a.idempotent } : {},
+    openWorldHint: a.openWorld
+  };
+}
 function buildMcpDispatcher(manifest) {
   const byName = /* @__PURE__ */ new Map();
   for (const t of manifest) {

package/dist/tools/define-tool.d.ts

@@ -88,6 +88,32 @@ export interface ToolDefinition<S extends ZodTypeAny = ZodTypeAny> {
     replacement?: string;
     /** Short explanation for product-surface routing. */
     note?: string;
+    /**
+     * Human-readable display name shown by MCP hosts, e.g. "Add Clip to
+     * Timeline". Required by the Anthropic extension directory.
+     */
+    title: string;
+    /**
+     * MCP safety annotations (directory requirement: every tool declares
+     * readOnlyHint or destructiveHint).
+     * - `readOnly: true` — the tool never modifies files or project state.
+     * - `readOnly: false` — the tool writes; `destructive` defaults to true
+     *   (may overwrite/modify existing data), set false for purely additive
+     *   tools; `idempotent: true` when re-running with identical args has no
+     *   additional effect.
+     * - `openWorld` — true when the tool calls external provider APIs; false
+     *   for purely local work (ffmpeg, filesystem). Always stated explicitly
+     *   because the MCP spec default is true.
+     */
+    annotations: {
+        readOnly: true;
+        openWorld: boolean;
+    } | {
+        readOnly: false;
+        destructive?: boolean;
+        idempotent?: boolean;
+        openWorld: boolean;
+    };
     /** Identical for MCP description and Agent description. One paragraph. */
     description: string;
     /** Single source of truth for argument shape. Must be a `z.object({...})`. */