toolcraft-openapi 0.0.130 → 0.0.131

package/dist/composition.json

@@ -38,12 +38,12 @@
     },
     {
       "name": "toolcraft-openapi",
-      "version": "0.0.130",
+      "version": "0.0.131",
       "license": "MIT"
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.130",
+      "version": "0.0.131",
       "license": "MIT"
     },
     {

package/dist/generate.d.ts

@@ -7,6 +7,10 @@ type OpenApiScalarType = "string" | "number" | "integer" | "boolean";
 type OpenApiSchemaType = OpenApiScalarType | "object" | "array";
 type OpenApiJsonSchemaType = OpenApiSchemaType | "null";
 export type GeneratedRequestLocation = Exclude<GeneratedParam["location"], "transport">;
+export interface OpenApiTagObject {
+    name: string;
+    description?: string;
+}
 export interface OpenApiDocument {
     openapi?: string;
     info?: {
@@ -15,6 +19,7 @@ export interface OpenApiDocument {
     };
     servers?: OpenApiServerObject[];
     security?: OpenApiSecurityRequirementObject[];
+    tags?: OpenApiTagObject[];
     paths?: Record<string, OpenApiPathItemObject | undefined>;
     components?: {
         securitySchemes?: Record<string, unknown>;

package/dist/generate.js

@@ -113,7 +113,7 @@ export function generate(document, options) {
             path: command.filePath,
             contents: createCommandFile(command)
         })),
-        createIndexFile(commands),
+        createIndexFile(commands, normalizedDocument),
         createClientFile(),
         createCliFile({ brand, label }),
         createMcpFile()
@@ -1844,8 +1844,22 @@ function resolveQueryObjectSerialization(parameter, operationId) {
     }
     throw new UserError(`Operation ${JSON.stringify(operationId)} uses unsupported query-object serialization for parameter ${JSON.stringify(parameter.name)}. Supported in v1: deepObject with explode true.`);
 }
-function createIndexFile(commands) {
+function collectTagDescriptions(document) {
+    const descriptions = new Map();
+    for (const tag of document.tags ?? []) {
+        if (typeof tag.name !== "string" || tag.name.length === 0) {
+            continue;
+        }
+        if (typeof tag.description !== "string" || tag.description.trim().length === 0) {
+            continue;
+        }
+        descriptions.set(normalizeNoun(tag.name), tag.description.trim());
+    }
+    return descriptions;
+}
+function createIndexFile(commands, document) {
     const groups = groupByNoun(commands);
+    const tagDescriptions = collectTagDescriptions(document);
     if (groups.length === 0) {
         return {
             path: "index.ts",
@@ -1863,8 +1877,12 @@ function createIndexFile(commands) {
         lines.push("");
     }
     for (const { noun, commands: nounCommands } of groups) {
+        const description = tagDescriptions.get(noun);
         lines.push(`export const ${toCamelCase(noun)} = defineGroup({`);
         lines.push(`  name: ${JSON.stringify(noun)},`);
+        if (description !== undefined) {
+            lines.push(`  description: ${JSON.stringify(description)},`);
+        }
         lines.push(`  children: [${nounCommands.map((command) => command.exportName).join(", ")}],`);
         lines.push("});");
         lines.push("");

package/node_modules/toolcraft-design/dist/components/help-formatter-plain.js

@@ -1,3 +1,4 @@
+import { joinHelpTokens } from "./help-formatter.js";
 export function stripAnsi(value) {
     let output = "";
     for (let index = 0; index < value.length; index += 1) {
@@ -54,26 +55,49 @@ function splitWords(value) {
     }
     return words;
 }
-function wrapWords(value, width) {
-    const words = splitWords(value);
+function leadingWhitespace(value) {
+    let index = 0;
+    while (index < value.length && isWhitespace(value[index])) {
+        index += 1;
+    }
+    return { prefix: value.slice(0, index), rest: value.slice(index) };
+}
+function takePrefix(value, width) {
+    return { prefix: value.slice(0, width), rest: value.slice(width) };
+}
+function wrapWords(value, width, continuationWidth = width) {
+    // Preserve leading whitespace only on the first wrapped line so hang-indented
+    // left cells (command depth prefixes) do not re-indent every continuation.
+    const { prefix, rest } = leadingWhitespace(value);
+    const firstContentWidth = Math.max(1, width - prefix.length);
+    const words = splitWords(rest);
     if (words.length === 0) {
-        return [""];
+        return [prefix];
     }
     const lines = [];
     let line = "";
+    let isFirstLine = true;
     for (const word of words) {
-        if (!line) {
-            line = word;
-            continue;
-        }
-        if (line.length + 1 + word.length <= width) {
+        const limit = isFirstLine ? firstContentWidth : continuationWidth;
+        if (line && line.length + 1 + word.length <= limit) {
             line += ` ${word}`;
             continue;
         }
-        lines.push(line);
-        line = word;
+        if (line) {
+            lines.push(isFirstLine ? `${prefix}${line}` : line);
+            isFirstLine = false;
+            line = "";
+        }
+        let remaining = word;
+        while (remaining.length > (isFirstLine ? firstContentWidth : continuationWidth)) {
+            const chunk = takePrefix(remaining, isFirstLine ? firstContentWidth : continuationWidth);
+            lines.push(isFirstLine ? `${prefix}${chunk.prefix}` : chunk.prefix);
+            isFirstLine = false;
+            remaining = chunk.rest;
+        }
+        line = remaining;
     }
-    lines.push(line);
+    lines.push(isFirstLine ? `${prefix}${line}` : line);
     return lines;
 }
 export function formatColumns(opts) {
@@ -91,33 +115,43 @@ export function formatColumns(opts) {
     const indent = opts.indent ?? 2;
     const maxLeftContentWidth = Math.max(...rows.map((row) => row.left.length));
     const leftWidth = clamp(maxLeftContentWidth + gap, minLeftWidth, maxLeftWidth);
-    const rightWidth = Math.max(20, totalWidth - leftWidth - indent);
+    const rightWidth = Math.max(1, totalWidth - leftWidth - indent);
+    const leftWrapWidth = Math.max(1, totalWidth - indent);
     const firstIndent = " ".repeat(indent);
     const continuationIndent = " ".repeat(indent + leftWidth);
     return rows
         .flatMap((row) => {
+        let leftLeadingWidth = 0;
+        while (leftLeadingWidth < row.left.length && isWhitespace(row.left[leftLeadingWidth])) {
+            leftLeadingWidth += 1;
+        }
+        // Continuations hang under the left cell start (including depth prefix) by +2.
+        const leftHangIndent = " ".repeat(indent + leftLeadingWidth + 2);
+        const leftLines = wrapWords(row.left, leftWrapWidth, Math.max(1, totalWidth - leftHangIndent.length));
         if (row.right.length === 0) {
-            return [`${firstIndent}${row.left}`];
+            return leftLines.map((line, index) => index === 0 ? `${firstIndent}${line}` : `${leftHangIndent}${line}`);
         }
         const rightLines = wrapWords(row.right, rightWidth);
-        if (row.left.length >= leftWidth) {
-            return [
-                `${firstIndent}${row.left}`,
-                ...rightLines.map((line) => `${continuationIndent}${line}`)
-            ];
+        const leftFitsInColumn = row.left.length < leftWidth;
+        if (leftFitsInColumn && leftLines.length === 1) {
+            const firstLine = `${firstIndent}${padEndVisible(leftLines[0] ?? "", leftWidth)}${rightLines[0]}`;
+            const continuationLines = rightLines
+                .slice(1)
+                .map((line) => `${continuationIndent}${line}`);
+            return [firstLine, ...continuationLines];
         }
-        const firstLine = `${firstIndent}${padEndVisible(row.left, leftWidth)}${rightLines[0]}`;
-        const continuationLines = rightLines
-            .slice(1)
-            .map((line) => `${continuationIndent}${line}`);
-        return [firstLine, ...continuationLines];
+        const renderedLeft = leftLines.map((line, index) => index === 0 ? `${firstIndent}${line}` : `${leftHangIndent}${line}`);
+        const renderedRight = rightLines.map((line) => `${continuationIndent}${line}`);
+        return [...renderedLeft, ...renderedRight];
     })
         .join("\n");
 }
 export function formatCommandList(commands) {
     return formatColumns({
         rows: commands.map((cmd) => ({
-            left: `${" ".repeat((cmd.depth ?? 0) * 2)}${cmd.name}`,
+            left: `${" ".repeat((cmd.depth ?? 0) * 2)}${cmd.nameTokens !== undefined && cmd.nameTokens.length > 0
+                ? joinHelpTokens(cmd.nameTokens)
+                : cmd.name}`,
             right: cmd.description
         }))
     });
@@ -125,7 +159,9 @@ export function formatCommandList(commands) {
 export function formatOptionList(options) {
     return formatColumns({
         rows: options.map((opt) => ({
-            left: opt.flags,
+            left: opt.flagTokens !== undefined && opt.flagTokens.length > 0
+                ? joinHelpTokens(opt.flagTokens)
+                : opt.flags,
             right: opt.description
         }))
     });

package/node_modules/toolcraft-design/dist/components/help-formatter.d.ts

@@ -1,11 +1,20 @@
+export type HelpTokenRole = "command" | "argument" | "option" | "literal" | "dim";
+export interface HelpToken {
+    text: string;
+    role: HelpTokenRole;
+}
 export interface CommandInfo {
     name: string;
+    /** Structured tokens for TTY/markdown styling. Plain `name` is used when absent. */
+    nameTokens?: HelpToken[];
     description: string;
     /** Nesting depth relative to the help target. Depth 0 is a direct child. */
     depth?: number;
 }
 export interface OptionInfo {
     flags: string;
+    /** Structured tokens for TTY/markdown styling. Plain `flags` is used when absent. */
+    flagTokens?: HelpToken[];
     description: string;
 }
 export interface FormatColumnsOptions {
@@ -20,6 +29,9 @@ export interface FormatColumnsOptions {
     indent?: number;
 }
 export declare function formatColumns(opts: FormatColumnsOptions): string;
+export declare function styleHelpToken(token: HelpToken): string;
+export declare function joinHelpTokens(tokens: HelpToken[]): string;
+export declare function renderHelpTokens(tokens: HelpToken[]): string;
 export declare function formatCommand(name: string, description: string): string;
 export declare function formatUsage(command: string, args?: string): string;
 export declare function formatOption(flags: string, description: string): string;
@@ -32,4 +44,7 @@ export declare const helpFormatter: {
     readonly formatOption: typeof formatOption;
     readonly formatCommandList: typeof formatCommandList;
     readonly formatOptionList: typeof formatOptionList;
+    readonly styleHelpToken: typeof styleHelpToken;
+    readonly joinHelpTokens: typeof joinHelpTokens;
+    readonly renderHelpTokens: typeof renderHelpTokens;
 };

package/node_modules/toolcraft-design/dist/components/help-formatter.js

@@ -1,3 +1,5 @@
+import { resolveOutputFormat } from "../internal/output-format.js";
+import { typography } from "../tokens/typography.js";
 import { text } from "./text.js";
 const graphemeSegmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 function normalizeInline(value) {
@@ -103,26 +105,67 @@ function splitWords(value) {
     }
     return words;
 }
-function wrapWords(value, width) {
-    const words = splitWords(value);
+function leadingWhitespaceWidth(value) {
+    let index = 0;
+    while (index < value.length && isWhitespace(value[index])) {
+        index += 1;
+    }
+    return { prefix: value.slice(0, index), rest: value.slice(index) };
+}
+function takeVisiblePrefix(value, width) {
+    let visible = 0;
+    let index = 0;
+    while (index < value.length) {
+        const controlEnd = readControlSequence(value, index);
+        if (controlEnd !== undefined) {
+            index = controlEnd;
+            continue;
+        }
+        const segment = graphemeSegmenter.segment(value.slice(index))[Symbol.iterator]().next().value;
+        const cluster = segment?.segment ?? value[index] ?? "";
+        const nextWidth = clusterWidth(cluster);
+        if (visible > 0 && visible + nextWidth > width) {
+            break;
+        }
+        visible += nextWidth;
+        index += cluster.length || 1;
+    }
+    return { prefix: value.slice(0, index), rest: value.slice(index) };
+}
+function wrapWords(value, width, continuationWidth = width) {
+    // Preserve leading whitespace only on the first wrapped line so hang-indented
+    // left cells (command depth prefixes) do not re-indent every continuation.
+    const { prefix, rest } = leadingWhitespaceWidth(value);
+    const prefixWidth = visibleWidth(prefix);
+    const firstContentWidth = Math.max(1, width - prefixWidth);
+    const words = splitWords(rest);
     if (words.length === 0) {
-        return [""];
+        return [prefix];
     }
     const lines = [];
     let line = "";
+    let isFirstLine = true;
     for (const word of words) {
-        if (!line) {
-            line = word;
-            continue;
-        }
-        if (visibleWidth(line) + 1 + visibleWidth(word) <= width) {
+        const limit = isFirstLine ? firstContentWidth : continuationWidth;
+        if (line && visibleWidth(line) + 1 + visibleWidth(word) <= limit) {
             line += ` ${word}`;
             continue;
         }
-        lines.push(line);
-        line = word;
+        if (line) {
+            lines.push(isFirstLine ? `${prefix}${line}` : line);
+            isFirstLine = false;
+            line = "";
+        }
+        let remaining = word;
+        while (visibleWidth(remaining) > (isFirstLine ? firstContentWidth : continuationWidth)) {
+            const chunk = takeVisiblePrefix(remaining, isFirstLine ? firstContentWidth : continuationWidth);
+            lines.push(isFirstLine ? `${prefix}${chunk.prefix}` : chunk.prefix);
+            isFirstLine = false;
+            remaining = chunk.rest;
+        }
+        line = remaining;
     }
-    lines.push(line);
+    lines.push(isFirstLine ? `${prefix}${line}` : line);
     return lines;
 }
 function validateLayoutValue(value, name) {
@@ -150,29 +193,74 @@ export function formatColumns(opts) {
     validateLayoutValue(indent, "indent");
     const maxLeftContentWidth = Math.max(...rows.map((row) => visibleWidth(row.left)));
     const leftWidth = clamp(maxLeftContentWidth + gap, minLeftWidth, maxLeftWidth);
-    const rightWidth = Math.max(20, totalWidth - leftWidth - indent);
+    const rightWidth = Math.max(1, totalWidth - leftWidth - indent);
+    const leftWrapWidth = Math.max(1, totalWidth - indent);
     const firstIndent = " ".repeat(indent);
     const continuationIndent = " ".repeat(indent + leftWidth);
     return rows
         .flatMap((row) => {
+        const leftLeading = leadingWhitespaceWidth(row.left).prefix;
+        // Continuations hang under the left cell start (including depth prefix) by +2.
+        const leftHangIndent = " ".repeat(indent + visibleWidth(leftLeading) + 2);
+        const leftLines = wrapWords(row.left, leftWrapWidth, Math.max(1, totalWidth - visibleWidth(leftHangIndent)));
         if (row.right.length === 0) {
-            return [`${firstIndent}${row.left}`];
+            return leftLines.map((line, index) => index === 0 ? `${firstIndent}${line}` : `${leftHangIndent}${line}`);
         }
         const rightLines = wrapWords(row.right, rightWidth);
-        if (visibleWidth(row.left) >= leftWidth) {
-            return [
-                `${firstIndent}${row.left}`,
-                ...rightLines.map((line) => `${continuationIndent}${line}`)
-            ];
+        const leftFitsInColumn = visibleWidth(row.left) < leftWidth;
+        if (leftFitsInColumn && leftLines.length === 1) {
+            const firstLine = `${firstIndent}${padEndVisible(leftLines[0] ?? "", leftWidth)}${rightLines[0]}`;
+            const continuationLines = rightLines
+                .slice(1)
+                .map((line) => `${continuationIndent}${line}`);
+            return [firstLine, ...continuationLines];
         }
-        const firstLine = `${firstIndent}${padEndVisible(row.left, leftWidth)}${rightLines[0]}`;
-        const continuationLines = rightLines
-            .slice(1)
-            .map((line) => `${continuationIndent}${line}`);
-        return [firstLine, ...continuationLines];
+        const renderedLeft = leftLines.map((line, index) => index === 0 ? `${firstIndent}${line}` : `${leftHangIndent}${line}`);
+        const renderedRight = rightLines.map((line) => `${continuationIndent}${line}`);
+        return [...renderedLeft, ...renderedRight];
     })
         .join("\n");
 }
+export function styleHelpToken(token) {
+    switch (token.role) {
+        case "command":
+            return text.command(token.text);
+        case "argument":
+            return styleArgumentToken(token.text);
+        case "option":
+            return text.option(token.text);
+        case "dim":
+            return styleDim(token.text);
+        case "literal":
+            return token.text;
+    }
+}
+function styleArgumentToken(content) {
+    // Token text already includes angle brackets. text.argument re-wraps in markdown,
+    // so strip first there; terminal/json keep the full `<value>` form.
+    const format = resolveOutputFormat();
+    if (format === "markdown" && content.startsWith("<") && content.endsWith(">")) {
+        return text.argument(content.slice(1, -1));
+    }
+    if (format === "json") {
+        return content;
+    }
+    return text.argument(content);
+}
+function styleDim(content) {
+    // Structural brackets stay unstyled in markdown/json; italicizing them as muted is wrong.
+    const format = resolveOutputFormat();
+    if (format === "json" || format === "markdown") {
+        return content;
+    }
+    return typography.dim(content);
+}
+export function joinHelpTokens(tokens) {
+    return tokens.map((token) => token.text).join("");
+}
+export function renderHelpTokens(tokens) {
+    return tokens.map((token) => styleHelpToken(token)).join("");
+}
 export function formatCommand(name, description) {
     return formatColumns({
         rows: [{ left: text.command(name), right: description }]
@@ -189,16 +277,24 @@ export function formatOption(flags, description) {
 }
 export function formatCommandList(commands) {
     return formatColumns({
-        rows: commands.map((cmd) => ({
-            left: `${" ".repeat((cmd.depth ?? 0) * 2)}${text.command(cmd.name)}`,
-            right: cmd.description
-        }))
+        rows: commands.map((cmd) => {
+            const depthPrefix = " ".repeat((cmd.depth ?? 0) * 2);
+            const styledName = cmd.nameTokens !== undefined && cmd.nameTokens.length > 0
+                ? renderHelpTokens(cmd.nameTokens)
+                : text.command(cmd.name);
+            return {
+                left: `${depthPrefix}${styledName}`,
+                right: cmd.description
+            };
+        })
     });
 }
 export function formatOptionList(options) {
     return formatColumns({
         rows: options.map((opt) => ({
-            left: text.option(opt.flags),
+            left: opt.flagTokens !== undefined && opt.flagTokens.length > 0
+                ? renderHelpTokens(opt.flagTokens)
+                : text.option(opt.flags),
             right: opt.description
         }))
     });
@@ -209,5 +305,8 @@ export const helpFormatter = {
     formatUsage,
     formatOption,
     formatCommandList,
-    formatOptionList
+    formatOptionList,
+    styleHelpToken,
+    joinHelpTokens,
+    renderHelpTokens
 };

package/node_modules/toolcraft-design/dist/components/index.d.ts

@@ -4,8 +4,8 @@ export type { Color } from "./color.js";
 export { symbols } from "./symbols.js";
 export { createLogger, logger } from "./logger.js";
 export type { LoggerOutput } from "./logger.js";
-export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./help-formatter.js";
-export type { CommandInfo, OptionInfo, FormatColumnsOptions } from "./help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList, styleHelpToken, joinHelpTokens, renderHelpTokens } from "./help-formatter.js";
+export type { CommandInfo, OptionInfo, FormatColumnsOptions, HelpToken, HelpTokenRole } from "./help-formatter.js";
 export { formatCommandNotFound } from "./command-errors.js";
 export { formatCommandNotFoundPanel } from "./command-errors.js";
 export { renderTable } from "./table.js";

package/node_modules/toolcraft-design/dist/components/index.js

@@ -2,7 +2,7 @@ export { text } from "./text.js";
 export { color } from "./color.js";
 export { symbols } from "./symbols.js";
 export { createLogger, logger } from "./logger.js";
-export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList, styleHelpToken, joinHelpTokens, renderHelpTokens } from "./help-formatter.js";
 export { formatCommandNotFound } from "./command-errors.js";
 export { formatCommandNotFoundPanel } from "./command-errors.js";
 export { renderTable } from "./table.js";

package/node_modules/toolcraft-design/dist/help-formatter.d.ts

@@ -1,2 +1,2 @@
-export { helpFormatter } from "./components/help-formatter.js";
-export type { CommandInfo, FormatColumnsOptions, OptionInfo } from "./components/help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList, styleHelpToken, joinHelpTokens, renderHelpTokens } from "./components/help-formatter.js";
+export type { CommandInfo, FormatColumnsOptions, OptionInfo, HelpToken, HelpTokenRole } from "./components/help-formatter.js";

package/node_modules/toolcraft-design/dist/help-formatter.js

@@ -1 +1 @@
-export { helpFormatter } from "./components/help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList, styleHelpToken, joinHelpTokens, renderHelpTokens } from "./components/help-formatter.js";

package/node_modules/toolcraft-design/dist/index.d.ts

@@ -12,9 +12,9 @@ export type { Color } from "./components/color.js";
 export { symbols } from "./components/symbols.js";
 export { createLogger, logger } from "./components/logger.js";
 export type { LoggerOutput } from "./components/logger.js";
-export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./components/help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList, styleHelpToken, joinHelpTokens, renderHelpTokens } from "./components/help-formatter.js";
 export * as helpFormatterPlain from "./components/help-formatter-plain.js";
-export type { CommandInfo, OptionInfo, FormatColumnsOptions } from "./components/help-formatter.js";
+export type { CommandInfo, OptionInfo, FormatColumnsOptions, HelpToken, HelpTokenRole } from "./components/help-formatter.js";
 export { formatCommandNotFound } from "./components/command-errors.js";
 export { formatCommandNotFoundPanel } from "./components/command-errors.js";
 export { renderTable } from "./components/table.js";

package/node_modules/toolcraft-design/dist/index.js

@@ -10,7 +10,7 @@ export { text } from "./components/text.js";
 export { color } from "./components/color.js";
 export { symbols } from "./components/symbols.js";
 export { createLogger, logger } from "./components/logger.js";
-export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList } from "./components/help-formatter.js";
+export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption, formatCommandList, formatOptionList, styleHelpToken, joinHelpTokens, renderHelpTokens } from "./components/help-formatter.js";
 export * as helpFormatterPlain from "./components/help-formatter-plain.js";
 export { formatCommandNotFound } from "./components/command-errors.js";
 export { formatCommandNotFoundPanel } from "./components/command-errors.js";

package/node_modules/toolcraft-schema/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft-openapi",
-  "version": "0.0.130",
+  "version": "0.0.131",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -30,7 +30,7 @@
     "toolcraft-openapi-generate": "dist/bin/generate.js"
   },
   "dependencies": {
-    "toolcraft": "0.0.130",
+    "toolcraft": "0.0.131",
     "auth-store": "^0.0.1",
     "fast-string-width": "^3.0.2",
     "fast-wrap-ansi": "^0.2.0",
@@ -46,7 +46,7 @@
     "directory": "packages/toolcraft-openapi"
   },
   "optionalDependencies": {
-    "toolcraft-schema": "0.0.130",
+    "toolcraft-schema": "0.0.131",
     "toolcraft-design": "*",
     "@poe-code/frontmatter": "*"
   },