toolcraft-openapi 0.0.136 → 0.0.137

package/dist/composition.json

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

package/node_modules/@poe-code/frontmatter/README.md

@@ -6,7 +6,9 @@ Shared YAML frontmatter parsing for poe-code packages.
 
 ```ts
 import {
+  FrontmatterKindError,
   FrontmatterParseError,
+  isFrontmatterKindError,
   parseFrontmatter,
   parseFrontmatterDocument,
   stringifyFrontmatter
@@ -17,6 +19,7 @@ import {
 - `parseFrontmatterDocument(source)` returns `{ frontmatter, body, errors, lineCounter }` for callers that need YAML diagnostics.
 - `stringifyFrontmatter(frontmatter, body)` writes `---` fences, YAML, and the body.
 - `FrontmatterParseError` is thrown for malformed frontmatter, invalid YAML, non-object frontmatter, and stringify failures.
+- `FrontmatterKindError` extends `FrontmatterParseError` and carries `expectedKind` / `foundKind` so callers can report a document kind mismatch instead of a missing file. `isFrontmatterKindError(error)` narrows to it.
 
 When no leading frontmatter block exists, parsing returns `{ frontmatter: {}, body: source }`.
 The returned `body` is sliced from the original input and is otherwise byte-for-byte unchanged.

package/node_modules/@poe-code/frontmatter/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { splitFrontmatterBlock, type FrontmatterBlock, type SplitFrontmatterResult } from "./fences.js";
-export { FrontmatterParseError, parseFrontmatter, parseFrontmatterDocument, type ParsedFrontmatter, type ParsedFrontmatterDocument, type ParseFrontmatterOptions } from "./parse.js";
+export { FrontmatterKindError, FrontmatterParseError, isFrontmatterKindError, parseFrontmatter, parseFrontmatterDocument, type ParsedFrontmatter, type ParsedFrontmatterDocument, type ParseFrontmatterOptions } from "./parse.js";
 export { stringifyFrontmatter } from "./stringify.js";

package/node_modules/@poe-code/frontmatter/dist/index.js

@@ -1,3 +1,3 @@
 export { splitFrontmatterBlock } from "./fences.js";
-export { FrontmatterParseError, parseFrontmatter, parseFrontmatterDocument } from "./parse.js";
+export { FrontmatterKindError, FrontmatterParseError, isFrontmatterKindError, parseFrontmatter, parseFrontmatterDocument } from "./parse.js";
 export { stringifyFrontmatter } from "./stringify.js";

package/node_modules/@poe-code/frontmatter/dist/parse.d.ts

@@ -16,5 +16,14 @@ export interface ParseFrontmatterOptions {
 export declare class FrontmatterParseError extends Error {
     constructor(message: string);
 }
+export declare class FrontmatterKindError extends FrontmatterParseError {
+    readonly expectedKind: string;
+    readonly foundKind: string;
+    constructor(message: string, kinds: {
+        expected: string;
+        found: string;
+    });
+}
+export declare function isFrontmatterKindError(error: unknown): error is FrontmatterKindError;
 export declare function parseFrontmatter(source: string, options?: ParseFrontmatterOptions): ParsedFrontmatter;
 export declare function parseFrontmatterDocument(source: string, options?: ParseFrontmatterOptions): ParsedFrontmatterDocument;

package/node_modules/@poe-code/frontmatter/dist/parse.js

@@ -6,6 +6,22 @@ export class FrontmatterParseError extends Error {
         this.name = "FrontmatterParseError";
     }
 }
+export class FrontmatterKindError extends FrontmatterParseError {
+    expectedKind;
+    foundKind;
+    constructor(message, kinds) {
+        super(message);
+        this.name = "FrontmatterKindError";
+        this.expectedKind = kinds.expected;
+        this.foundKind = kinds.found;
+    }
+}
+export function isFrontmatterKindError(error) {
+    return (error instanceof Error &&
+        error.name === "FrontmatterKindError" &&
+        typeof error.expectedKind === "string" &&
+        typeof error.foundKind === "string");
+}
 export function parseFrontmatter(source, options = {}) {
     const split = splitFrontmatter(source);
     if (split.raw === undefined) {

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

@@ -1,4 +1,11 @@
-export declare function renderAgentMessage(text: string): void;
+/**
+ * Status of the agent output being rendered.
+ *
+ * `streaming` covers partial/in-progress content, which has not reached any outcome yet and so must not
+ * claim success. `success`/`error` are terminal outcomes known to the caller.
+ */
+export type AcpOutputState = "streaming" | "success" | "error";
+export declare function renderAgentMessage(text: string, state?: AcpOutputState): void;
 export declare function renderToolStart(kind: string, title: string): void;
 export declare function renderToolComplete(kind: string): void;
 export declare function renderReasoning(text: string): void;

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

@@ -25,8 +25,13 @@ function colorForKind(kind) {
 function writeLine(line) {
     getAcpWriter()(line);
 }
-function agentPrefix() {
-    return `${color.green.bold("✓")} agent: `;
+const STATE_GLYPHS = {
+    streaming: () => color.dim("·"),
+    success: () => color.green.bold("✓"),
+    error: () => color.red.bold("✗")
+};
+function agentPrefix(state) {
+    return `${STATE_GLYPHS[state]()} agent: `;
 }
 function formatCost(costUsd) {
     return new Intl.NumberFormat("en-US", {
@@ -36,7 +41,7 @@ function formatCost(costUsd) {
         maximumFractionDigits: 6
     }).format(costUsd);
 }
-export function renderAgentMessage(text) {
+export function renderAgentMessage(text, state = "streaming") {
     const format = resolveOutputFormat();
     if (format === "markdown") {
         writeLine(`- **agent:** ${text}`);
@@ -47,7 +52,7 @@ export function renderAgentMessage(text) {
         return;
     }
     const rendered = renderMarkdown(text).trimEnd();
-    writeLine(`${agentPrefix()}${rendered}`);
+    writeLine(`${agentPrefix(state)}${rendered}`);
 }
 export function renderToolStart(kind, title) {
     const format = resolveOutputFormat();
@@ -85,7 +90,7 @@ export function renderReasoning(text) {
         writeLine(JSON.stringify({ event: "reasoning", text }));
         return;
     }
-    writeLine(color.dim(`  ✓ ${truncate(text, 80)}`));
+    writeLine(color.dim(`  · ${truncate(text, 80)}`));
 }
 export function renderUsage(tokens) {
     const format = resolveOutputFormat();
@@ -109,7 +114,7 @@ export function renderUsage(tokens) {
         return;
     }
     writeLine("");
-    writeLine(color.green(`✓ tokens: ${tokens.input} in${cached} → ${tokens.output} out${cost}`));
+    writeLine(color.dim(`· tokens: ${tokens.input} in${cached} → ${tokens.output} out${cost}`));
 }
 export function renderPermissionRejected(title) {
     const format = resolveOutputFormat();

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

@@ -1,3 +1,4 @@
 export { renderAgentMessage, renderToolStart, renderToolComplete, renderReasoning, renderUsage, renderError, renderPermissionRejected } from "./components.js";
+export type { AcpOutputState } from "./components.js";
 export { getAcpWriter, withAcpWriter } from "./writer.js";
 export type { AcpLineWriter } from "./writer.js";

package/node_modules/toolcraft-design/dist/components/command-errors.d.ts

@@ -1,6 +1,7 @@
 export declare function formatCommandNotFound(input: {
     unknownCommand: string;
     helpCommand: string;
+    suggestions?: readonly string[];
 }): {
     label: string;
     hint: string;
@@ -8,6 +9,7 @@ export declare function formatCommandNotFound(input: {
 export declare function formatCommandNotFoundPanel(input: {
     unknownCommand: string;
     helpCommand: string;
+    suggestions?: readonly string[];
     title?: string;
 }): {
     title: string;

package/node_modules/toolcraft-design/dist/components/command-errors.js

@@ -5,15 +5,21 @@ export function formatCommandNotFound(input) {
     const unknown = unknownInput.length > 0
         ? unknownInput
         : "<command>";
+    const suggestions = input.suggestions ?? [];
+    const didYouMean = suggestions.length > 0
+        ? `
+${text.muted("Did you mean:")} ${suggestions.map((suggestion) => text.command(suggestion)).join(text.muted(", "))}${text.muted("?")}`
+        : "";
     return {
-        label: `${typography.bold("Unknown command:")} ${text.command(unknown)}`,
+        label: `${typography.bold("Unknown command:")} ${text.command(unknown)}${didYouMean}`,
         hint: `${text.muted("Run")} ${text.usageCommand(input.helpCommand)} ${text.muted("for available commands.")}`
     };
 }
 export function formatCommandNotFoundPanel(input) {
     const message = formatCommandNotFound({
         unknownCommand: input.unknownCommand,
-        helpCommand: input.helpCommand
+        helpCommand: input.helpCommand,
+        suggestions: input.suggestions
     });
     return {
         title: input.title ?? "command not found",

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

@@ -8,7 +8,7 @@ export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption,
 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";
+export { loggerTableWidth, renderTable } from "./table.js";
 export type { TableColumn, RenderTableOptions } from "./table.js";
 export { renderFileChanges } from "./file-changes.js";
 export type { FileChange, FileChangeDisplayMode, FileChangeKind, FileChangeOutputFormat, RenderFileChangesOptions } from "./file-changes.js";

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

@@ -5,7 +5,7 @@ export { createLogger, logger } from "./logger.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";
+export { loggerTableWidth, renderTable } from "./table.js";
 export { renderFileChanges } from "./file-changes.js";
 export { renderCatalog } from "./catalog.js";
 export { getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./template.js";

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

@@ -12,4 +12,5 @@ export interface RenderTableOptions {
     variant?: "table" | "detail";
     maxWidth?: number;
 }
+export declare function loggerTableWidth(): number | undefined;
 export declare function renderTable(options: RenderTableOptions): string;

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

@@ -3,6 +3,7 @@ import { resolveOutputFormat } from "../internal/output-format.js";
 import { stripAnsi } from "../internal/strip-ansi.js";
 const reset = "\x1b[0m";
 const ellipsis = "…";
+const minCellWidth = 4;
 const graphemeSegmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 function getCell(row, name) {
     return Object.prototype.hasOwnProperty.call(row, name) ? row[name] ?? "" : "";
@@ -161,6 +162,51 @@ function computeColumns(columns) {
         width: getColumnWidth(column)
     }));
 }
+// Each column is framed as "│ cell ", plus the closing "│".
+function frameWidth(columnCount) {
+    return columnCount * 3 + 1;
+}
+// Log output indents every line with a "│  " guide, so a table emitted through the
+// logger has that much less room than the terminal. Undefined without a terminal:
+// piped output has no width to fit.
+export function loggerTableWidth() {
+    const columns = process.stdout.columns;
+    return columns === undefined ? undefined : columns - 3;
+}
+// Without an explicit budget or a TTY there is no width to fit: the consumer of the
+// piped output decides, so columns keep their declared widths.
+function budgetColumns(columns, maxWidth) {
+    if (maxWidth === undefined) {
+        return columns;
+    }
+    const available = maxWidth - frameWidth(columns.length);
+    const contentWidth = (cap) => columns.reduce((total, column) => total + Math.min(column.width, cap), 0);
+    if (columns.reduce((total, column) => total + column.width, 0) <= available) {
+        return columns;
+    }
+    // Widest-first: raise a shared cap as far as the budget allows, so narrow columns
+    // keep their declared width and only the columns above the cap lose room.
+    let cap = minCellWidth;
+    while (contentWidth(cap + 1) <= available) {
+        cap += 1;
+    }
+    const budgeted = columns.map((column) => ({ ...column, width: Math.min(column.width, cap) }));
+    let slack = available - contentWidth(cap);
+    while (slack > 0) {
+        const growable = budgeted.filter((column, index) => column.width < columns[index].width);
+        if (growable.length === 0) {
+            break;
+        }
+        for (const column of growable) {
+            if (slack === 0) {
+                break;
+            }
+            column.width += 1;
+            slack -= 1;
+        }
+    }
+    return budgeted;
+}
 function renderBorder(columns, theme, parts) {
     const horizontal = theme.muted("─");
     const segments = columns.map((column) => horizontal.repeat(column.width + 2));
@@ -247,16 +293,17 @@ function renderTableTerminal(options) {
     }
     const separatorOptions = options;
     const includeRowSeparators = separatorOptions.rowSeparator === true || separatorOptions.rowSeparators === true;
-    const top = renderBorder(computedColumns, theme, { left: "┌", mid: "┬", right: "┐" });
-    const header = renderTerminalRow(computedColumns.map((column) => theme.header(column.title)), computedColumns, theme);
-    const headerBottom = renderBorder(computedColumns, theme, { left: "├", mid: "┼", right: "┤" });
-    const bottom = renderBorder(computedColumns, theme, { left: "└", mid: "┴", right: "┘" });
+    const budgetedColumns = budgetColumns(computedColumns, options.maxWidth ?? process.stdout.columns);
+    const top = renderBorder(budgetedColumns, theme, { left: "┌", mid: "┬", right: "┐" });
+    const header = renderTerminalRow(budgetedColumns.map((column) => theme.header(column.title)), budgetedColumns, theme);
+    const headerBottom = renderBorder(budgetedColumns, theme, { left: "├", mid: "┼", right: "┤" });
+    const bottom = renderBorder(budgetedColumns, theme, { left: "└", mid: "┴", right: "┘" });
     const renderedRows = [];
     for (const [index, row] of rows.entries()) {
         if (includeRowSeparators && index > 0) {
             renderedRows.push(headerBottom);
         }
-        renderedRows.push(renderTerminalRow(computedColumns.map((column) => getCell(row, column.name)), computedColumns, theme));
+        renderedRows.push(renderTerminalRow(budgetedColumns.map((column) => getCell(row, column.name)), budgetedColumns, theme));
     }
     return [top, header, headerBottom, ...renderedRows, bottom].join("\n");
 }

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

@@ -5,6 +5,15 @@ export interface RenderTemplateOptions {
     validate?: boolean;
     yield?: string;
 }
+export declare class TemplateParseError extends Error {
+    readonly description: string;
+    readonly line: number;
+    readonly column: number;
+    constructor(description: string, position: {
+        line: number;
+        column: number;
+    });
+}
 export declare function renderTemplate(template: string, view: Record<string, unknown>, options?: RenderTemplateOptions): string;
 export declare function getTemplatePartialNames(template: string): string[];
 export declare function resolveTemplatePartials(template: string, partials: Record<string, string>): string;

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

@@ -1,4 +1,17 @@
 const MAX_PARTIAL_DEPTH = 100;
+const MAX_TAG_EXCERPT_LENGTH = 40;
+export class TemplateParseError extends Error {
+    description;
+    line;
+    column;
+    constructor(description, position) {
+        super(`${description} at line ${position.line}, column ${position.column}`);
+        this.name = "TemplateParseError";
+        this.description = description;
+        this.line = position.line;
+        this.column = position.column;
+    }
+}
 const HTML_ESCAPE = {
     "&": "&",
     "<": "&lt;",
@@ -114,13 +127,13 @@ function parseTag(template, open) {
     if (template.startsWith("{{{", open)) {
         const close = template.indexOf("}}}", open + 3);
         if (close === -1) {
-            throw new Error("Unclosed unescaped tag");
+            throw unclosedTagError(template, open, "}}}");
         }
         return { kind: "unescaped", name: template.slice(open + 3, close).trim(), end: close + 3 };
     }
     const close = template.indexOf("}}", open + 2);
     if (close === -1) {
-        throw new Error("Unclosed tag");
+        throw unclosedTagError(template, open, "}}");
     }
     const raw = template.slice(open + 2, close).trim();
     const sigil = raw[0];
@@ -142,6 +155,18 @@ function parseTag(template, open) {
         return { kind: "delimiter", name, end };
     return { kind: "name", name: raw, end };
 }
+function unclosedTagError(template, open, expected) {
+    const before = template.slice(0, open);
+    const lineEnd = template.indexOf("\n", open);
+    const opened = template.slice(open, lineEnd === -1 ? template.length : lineEnd).trimEnd();
+    const tag = opened.length > MAX_TAG_EXCERPT_LENGTH
+        ? `${opened.slice(0, MAX_TAG_EXCERPT_LENGTH)}...`
+        : opened;
+    return new TemplateParseError(`Unclosed tag "${tag}": expected "${expected}"`, {
+        line: before.split("\n").length,
+        column: open - (before.lastIndexOf("\n") + 1) + 1
+    });
+}
 function getStandalone(template, tagStart, tagEnd, kind) {
     if (!["section", "inverted", "close", "comment", "partial", "delimiter"].includes(kind)) {
         return undefined;

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

@@ -17,7 +17,7 @@ export * as helpFormatterPlain from "./components/help-formatter-plain.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";
+export { loggerTableWidth, renderTable } from "./components/table.js";
 export type { TableColumn, RenderTableOptions } from "./components/table.js";
 export { renderFileChanges } from "./components/file-changes.js";
 export type { FileChange, FileChangeDisplayMode, FileChangeKind, FileChangeOutputFormat, RenderFileChangesOptions } from "./components/file-changes.js";
@@ -29,7 +29,7 @@ export { renderInspectorCard } from "./components/inspector-card.js";
 export type { InspectorField, InspectorSection, RenderInspectorCardOptions } from "./components/inspector-card.js";
 export { renderResourceBrowser } from "./components/resource-browser.js";
 export type { RenderResourceBrowserOptions, ResourceBrowserGroup, ResourceBrowserItem } from "./components/resource-browser.js";
-export { getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./components/template.js";
+export { TemplateParseError, getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./components/template.js";
 export type { RenderTemplateOptions, TemplateEscape } from "./components/template.js";
 export { openExternal } from "./components/browser.js";
 export * as acp from "./acp/index.js";

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

@@ -14,13 +14,13 @@ export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption,
 export * as helpFormatterPlain from "./components/help-formatter-plain.js";
 export { formatCommandNotFound } from "./components/command-errors.js";
 export { formatCommandNotFoundPanel } from "./components/command-errors.js";
-export { renderTable } from "./components/table.js";
+export { loggerTableWidth, renderTable } from "./components/table.js";
 export { renderFileChanges } from "./components/file-changes.js";
 export { renderCatalog } from "./components/catalog.js";
 export { renderDetailCard } from "./components/detail-card.js";
 export { renderInspectorCard } from "./components/inspector-card.js";
 export { renderResourceBrowser } from "./components/resource-browser.js";
-export { getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./components/template.js";
+export { TemplateParseError, getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./components/template.js";
 export { openExternal } from "./components/browser.js";
 // ACP rendering
 export * as acp from "./acp/index.js";

package/node_modules/toolcraft-design/dist/prompts/interactive/core.d.ts

@@ -1,6 +1,11 @@
 import { EventEmitter } from "node:events";
 import { CANCEL } from "./cancel-symbol.js";
 export type PromptStateName = "initial" | "active" | "submit" | "cancel" | "error";
+/**
+ * Builds the non-TTY rejection message, naming the documented `--yes` flag for the
+ * command being run and keeping `POE_NO_PROMPT=1` as the secondary CI alternative.
+ */
+export declare function nonTtyPromptMessage(argv?: string[]): string;
 export interface PromptState<Value> {
     state: PromptStateName;
     value: Value | undefined;

package/node_modules/toolcraft-design/dist/prompts/interactive/core.js

@@ -22,6 +22,20 @@ const cursor = {
 const erase = {
     down: "\x1b[J"
 };
+/**
+ * Builds the non-TTY rejection message, naming the documented `--yes` flag for the
+ * command being run and keeping `POE_NO_PROMPT=1` as the secondary CI alternative.
+ */
+export function nonTtyPromptMessage(argv = process.argv) {
+    const tokens = [];
+    for (const arg of argv.slice(2)) {
+        if (arg.startsWith("-"))
+            break;
+        tokens.push(arg);
+    }
+    const retry = [...tokens, "--yes"].join(" ");
+    return `Interactive prompt requires a TTY. Re-run with \`${retry}\` to accept defaults non-interactively, or set POE_NO_PROMPT=1 in CI.`;
+}
 export class Prompt extends EventEmitter {
     state = "initial";
     value;
@@ -92,7 +106,7 @@ export class Prompt extends EventEmitter {
         });
     }
     promptNonTty() {
-        return Promise.reject(new Error("Interactive prompt requires a TTY. Set POE_NO_PROMPT=1 to accept defaults non-interactively."));
+        return Promise.reject(new Error(nonTtyPromptMessage()));
     }
     readNonTtyLine() {
         return new Promise((resolve) => {

package/node_modules/toolcraft-design/dist/prompts/primitives/spinner.js

@@ -33,7 +33,7 @@ export function spinner() {
             }
             fallback = process.env.POE_NO_SPINNER === "1" || !process.stdout.isTTY;
             if (fallback) {
-                process.stdout.write(`${currentMessage}\n`);
+                process.stdout.write(`${color.gray("│")}  ${currentMessage}\n`);
                 return;
             }
             frameIndex = 0;

package/node_modules/toolcraft-schema/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft-openapi",
-  "version": "0.0.136",
+  "version": "0.0.137",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -30,7 +30,7 @@
     "toolcraft-openapi-generate": "dist/bin/generate.js"
   },
   "dependencies": {
-    "toolcraft": "0.0.136",
+    "toolcraft": "0.0.137",
     "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.136",
+    "toolcraft-schema": "0.0.137",
     "toolcraft-design": "*",
     "@poe-code/frontmatter": "*"
   },