toolcraft 0.0.148 → 0.0.149

package/README.md

@@ -583,6 +583,7 @@ Toolcraft configuration is code-first. Use `defineCommand(config)` and `defineGr
 - `positional?: string[]` — parameter names mapped from CLI argv order.
 - `params: S.Object(...)` — input schema from `toolcraft-schema`.
 - `result?: S.Object(...)` — structured result schema for MCP `outputSchema`; must be a root object.
+- `mcpResult?: (result) => Record<string, unknown>` — optional MCP-only projection applied before `result` validation; CLI and SDK still return the raw handler result. Requires `result`.
 - `secrets?: Record<string, { env: string; description?: string; optional?: boolean }>`
 - `scope?: Array<"cli" | "mcp" | "sdk">` — defaults to `["cli", "sdk"]`.
 - `confirm?: boolean` — deprecated CLI-only TTY confirmation; use `humanInLoop` instead. Cannot be combined with `humanInLoop`.

package/composition.json

@@ -113,7 +113,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.148",
+      "version": "0.0.149",
       "license": "MIT"
     },
     {
@@ -123,7 +123,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.148",
+      "version": "0.0.149",
       "license": "MIT"
     },
     {

package/dist/composition.json

@@ -113,7 +113,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.148",
+      "version": "0.0.149",
       "license": "MIT"
     },
     {
@@ -123,7 +123,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.148",
+      "version": "0.0.149",
       "license": "MIT"
     },
     {

package/dist/index.d.ts

@@ -123,6 +123,7 @@ export interface CommandConfig<TServices extends object, TParamsSchema extends O
     positional?: string[];
     params: TParamsSchema;
     result?: ObjectSchema<any>;
+    mcpResult?: (result: TResult) => Record<string, unknown>;
     secrets?: TSecrets;
     scope?: Scope[];
     confirm?: boolean;
@@ -140,7 +141,7 @@ export type StreamHandlerContext<TParamsSchema extends ObjectSchema<any>, TSecre
     status(event: StreamStatusEvent): void;
     refreshSecrets(): Promise<InferSecrets<TSecrets>>;
 };
-export interface StreamCommandConfig<TServices extends object, TParamsSchema extends ObjectSchema<any>, TSecrets extends SecretDeclarations | undefined, TEventSchema extends AnySchema> extends Omit<CommandConfig<TServices, TParamsSchema, TSecrets, AsyncIterable<Static<TEventSchema>>>, "handler" | "render" | "result" | "humanInLoop" | "confirm"> {
+export interface StreamCommandConfig<TServices extends object, TParamsSchema extends ObjectSchema<any>, TSecrets extends SecretDeclarations | undefined, TEventSchema extends AnySchema> extends Omit<CommandConfig<TServices, TParamsSchema, TSecrets, AsyncIterable<Static<TEventSchema>>>, "handler" | "render" | "result" | "mcpResult" | "humanInLoop" | "confirm"> {
     event: TEventSchema;
     handler: (ctx: StreamHandlerContext<TParamsSchema, TSecrets, TServices>) => AsyncIterable<Static<TEventSchema>> | Promise<AsyncIterable<Static<TEventSchema>>>;
     render?: Renderers<Static<TEventSchema>>;
@@ -157,6 +158,7 @@ export interface Command<TServices extends object = EmptyServices, TParamsSchema
     positional: string[];
     params: TParamsSchema;
     result?: ObjectSchema<any>;
+    mcpResult?: (result: TResult) => Record<string, unknown>;
     stream?: StreamDefinition<any>;
     secrets: SecretDeclarations;
     scope: Scope[];

package/dist/index.js

@@ -291,6 +291,9 @@ function resolveGroupScope(ownScope, inheritedScope) {
     return cloneScope(ownScope ?? inheritedScope);
 }
 function createBaseCommand(config) {
+    if (config.mcpResult !== undefined && config.result === undefined) {
+        throw new ToolcraftBugError(`Command "${config.name}" defines mcpResult without a result schema.`);
+    }
     const command = {
         kind: "command",
         name: config.name,
@@ -303,6 +306,7 @@ function createBaseCommand(config) {
         positional: [...(config.positional ?? [])],
         params: config.params,
         result: config.result,
+        mcpResult: config.mcpResult,
         stream: undefined,
         secrets: cloneSecrets(config.secrets),
         scope: resolveCommandScope(config.scope, undefined),
@@ -320,6 +324,7 @@ function createBaseCommand(config) {
             hidden: config.hidden ?? false,
             examples: cloneCommandExamples(config.examples),
             result: config.result,
+            mcpResult: config.mcpResult,
             humanInLoop: config.humanInLoop,
             secrets: cloneSecrets(config.secrets),
             requires: cloneRequires(config.requires),
@@ -376,6 +381,7 @@ function materializeCommand(command, inherited) {
         positional: [...command.positional],
         params: command.params,
         result: internal.result,
+        mcpResult: internal.mcpResult,
         stream: command.stream,
         secrets: mergeSecrets(inherited.secrets, internal.secrets),
         scope: resolveCommandScope(internal.scope, inherited.scope),
@@ -393,6 +399,7 @@ function materializeCommand(command, inherited) {
             hidden: internal.hidden,
             examples: cloneCommandExamples(internal.examples),
             result: internal.result,
+            mcpResult: internal.mcpResult,
             humanInLoop: internal.humanInLoop,
             secrets: cloneSecrets(internal.secrets),
             requires: cloneRequires(internal.requires),

package/dist/mcp.js

@@ -892,7 +892,8 @@ function createResolvedMCPServer(root, options, runtime = {}) {
                     return renderPendingApproval(result);
                 }
                 if (tool.resultSchema !== undefined) {
-                    const structuredContent = validateCommandResult(tool.resultSchema, result, casing);
+                    const mcpResult = tool.command.mcpResult === undefined ? result : tool.command.mcpResult(result);
+                    const structuredContent = validateCommandResult(tool.resultSchema, mcpResult, casing);
                     return {
                         content: [{ type: "text", text: JSON.stringify(structuredContent) }],
                         structuredContent

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

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

package/node_modules/toolcraft-schema/package.json

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

package/package.json

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