toolcraft 0.0.148 → 0.0.150

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.150",
       "license": "MIT"
     },
     {
@@ -123,7 +123,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.148",
+      "version": "0.0.150",
       "license": "MIT"
     },
     {

package/dist/composition.json

@@ -113,7 +113,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.148",
+      "version": "0.0.150",
       "license": "MIT"
     },
     {
@@ -123,7 +123,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.148",
+      "version": "0.0.150",
       "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/dist/sdk.compile-check.js

@@ -33,6 +33,17 @@ const ignoredRoot = defineGroup({
                                 apiKey: params.APIKey,
                             }),
                         }),
+                        defineCommand({
+                            name: "json-payload",
+                            scope: ["sdk"],
+                            params: S.Object({
+                                payload_json: S.Json(),
+                                items_by_id: S.Record(S.Object({
+                                    display_name: S.String(),
+                                })),
+                            }),
+                            handler: async ({ params }) => params,
+                        }),
                         defineCommand({
                             name: "cli-only",
                             scope: ["cli"],
@@ -116,6 +127,22 @@ const ignoredHttpServerResult = ignoredSdk.poeCode.generate.httpServer({
 void ignoredHttpServerResult.then((value) => {
     void value.apiKey;
 });
+void ignoredSdk.poeCode.generate.jsonPayload({
+    payloadJson: {
+        file_upload: "upload-1",
+        nested_value: { preserve_this_key: true },
+    },
+    itemsById: {
+        "item-1": { displayName: "One" },
+    },
+});
+ignoredSdk.poeCode.generate.jsonPayload({
+    payloadJson: null,
+    itemsById: {
+        // @ts-expect-error declared fields inside arbitrary-key records are still camel-cased
+        "item-1": { display_name: "One" },
+    },
+});
 const ignoredQueuedResult = ignoredSdk.poeCode.generate.queued({
     promptText: "hello",
 });

package/dist/sdk.d.ts

@@ -30,7 +30,9 @@ type CapitalizeJoinCamelWords<TWords extends readonly string[]> = TWords extends
     ...infer TTail extends readonly string[]
 ] ? `${Capitalize<THead>}${CapitalizeJoinCamelWords<TTail>}` : "";
 type CamelCase<TValue extends string> = JoinCamelWords<SplitCamelWords<TValue>>;
-type Camelize<TValue> = TValue extends Primitive ? TValue : TValue extends readonly (infer TItem)[] ? Array<Camelize<TItem>> : TValue extends object ? {
+type Camelize<TValue> = TValue extends Primitive ? TValue : TValue extends readonly (infer TItem)[] ? Array<Camelize<TItem>> : TValue extends object ? string extends keyof TValue ? {
+    [TKey in keyof TValue]: Camelize<TValue[TKey]>;
+} : {
     [TKey in keyof TValue as TKey extends string ? CamelCase<TKey> : TKey]: Camelize<TValue[TKey]>;
 } : TValue;
 type SDKResult<TResult, THumanInLoopMode extends HumanInLoopMode | undefined> = [THumanInLoopMode] extends ["async"] ? ["async"] extends [THumanInLoopMode] ? HumanInLoopPending : TResult : TResult;

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

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

package/node_modules/toolcraft-schema/package.json

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

package/package.json

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