toolcraft 0.0.224 → 0.0.225

package/node_modules/smol-toml/src/util.ts

@@ -0,0 +1,101 @@
+/*!
+ * Copyright (c) Squirrel Chat et al., All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ *    this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ * 3. Neither the name of the copyright holder nor the names of its contributors
+ *    may be used to endorse or promote products derived from this software without
+ *    specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+import type { TomlDate } from './date.js'
+import { TomlError } from './error.js'
+
+export type TomlPrimitive = string | number | bigint | boolean | TomlDate
+export type TomlTable = { [key: string]: TomlValue }
+export type TomlValue = TomlPrimitive | TomlValue[] | TomlTable
+
+export type TomlTableWithoutBigInt = { [key: string]: TomlValueWithoutBigInt }
+export type TomlValueWithoutBigInt = Exclude<TomlPrimitive, bigint> | TomlValueWithoutBigInt[] | TomlTableWithoutBigInt
+
+export function indexOfNewline(str: string, start = 0, end = str.length) {
+	let idx = str.indexOf('\n', start)
+	if (str[idx - 1] === '\r') idx--
+	return idx <= end ? idx : -1
+}
+
+export function skipComment(str: string, ptr: number) {
+	for (let i = ptr; i < str.length; i++) {
+		let c = str[i]!
+		if (c === '\n')
+			return i
+
+		if (c === '\r' && str[i + 1] === '\n')
+			return i + 1
+
+		if ((c < '\x20' && c !== '\t') || c === '\x7f') {
+			throw new TomlError('control characters are not allowed in comments', {
+				toml: str,
+				ptr: ptr,
+			})
+		}
+	}
+
+	return str.length
+}
+
+export function skipVoid(str: string, ptr: number, banNewLines?: boolean, banComments?: boolean): number {
+	let c
+	while (1) {
+		while ((c = str[ptr]) === ' ' || c === '\t' || (!banNewLines && (c === '\n' || (c === '\r' && str[ptr + 1] === '\n')))) ptr++
+
+		// Tucking the return statement here would save 5 characters >:)
+		// But TypeScript fails to detect there is no way to exit the loop so it complains about the lack of final return
+		if (banComments || c !== '#') break
+
+		ptr = skipComment(str, ptr)
+	}
+
+	return ptr
+}
+
+export function skipUntil(str: string, ptr: number, sep: string, end?: string, banNewLines: boolean = false) {
+	if (!end) {
+		ptr = indexOfNewline(str, ptr)
+		return ptr < 0 ? str.length : ptr
+	}
+
+	for (let i = ptr; i < str.length; i++) {
+		let c = str[i]
+		if (c === '#') {
+			i = indexOfNewline(str, i)
+		} else if (c === sep) {
+			return i + 1
+		} else if (c === end || (banNewLines && (c === '\n' || (c === '\r' && str[i + 1] === '\n')))) {
+			return i
+		}
+	}
+
+	throw new TomlError('cannot find end of structure', {
+		toml: str,
+		ptr: ptr,
+	})
+}

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

@@ -18,7 +18,7 @@
     },
     {
       "name": "tiny-http-mcp-server",
-      "version": "0.1.15",
+      "version": "0.1.16",
       "license": "MIT"
     },
     {

package/node_modules/tiny-http-mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-http-mcp-server",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Minimal MCP server over HTTP built on tiny-stdio-mcp-server",
   "type": "module",
   "main": "dist/index.js",

package/node_modules/tiny-stdio-mcp-server/README.md

@@ -95,6 +95,8 @@ Successful structured results must satisfy `outputSchema`. Validation failures u
 
 Tools whose natural result is prose, images, audio, files, or other content blocks should omit `outputSchema` and keep returning content.
 
+Handlers can throw `ToolError` to return a JSON-RPC tool error with a specific code, message, and optional structured `data` payload. The server forwards that `data` field in the JSON-RPC error response so clients can inspect machine-readable failure details.
+
 ### `.listen()`
 
 Start listening on stdin/stdout (standard MCP stdio transport).
@@ -158,7 +160,7 @@ import { Image } from "tiny-stdio-mcp-server";
 
 server.tool("screenshot", "Take a screenshot", schema, async () => {
   return Image.fromBase64(base64Data, "image/png");
-  // or: await Image.fromUrl("https://example.com/image.png")
+  // or: await Image.fromUrl("https://example.com/image.png", { maxBytes: 2 * 1024 * 1024 })
   // or: Image.fromBytes(uint8Array)
 });
 ```
@@ -172,13 +174,17 @@ import { Audio } from "tiny-stdio-mcp-server";
 
 server.tool("speak", "Text to speech", schema, async () => {
   return Audio.fromBase64(base64Data, "audio/mpeg");
-  // or: await Audio.fromUrl("https://example.com/audio.mp3")
+  // or: await Audio.fromUrl("https://example.com/audio.mp3", { maxBytes: 2 * 1024 * 1024 })
   // or: Audio.fromBytes(uint8Array, "mp3")
 });
 ```
 
 Supported formats: MP3, WAV, OGG, M4A.
 
+Remote helpers (`Image.fromUrl`, `Audio.fromUrl`, and `File.fromUrl`) cap downloads at
+`DEFAULT_FROM_URL_MAX_BYTES` (5 MiB). Pass `{ maxBytes }` to set a positive integer byte limit per
+call; responses that exceed the limit are rejected before being converted to content blocks.
+
 ### Files
 
 ```ts
@@ -187,7 +193,7 @@ import { File } from "tiny-stdio-mcp-server";
 server.tool("export", "Export data", schema, async () => {
   return File.fromText(csvContent, "text/csv");
   // or: File.fromBytes(uint8Array, "application/pdf")
-  // or: await File.fromUrl("https://example.com/report.pdf")
+  // or: await File.fromUrl("https://example.com/report.pdf", { maxBytes: 2 * 1024 * 1024 })
 });
 ```
 
@@ -226,6 +232,16 @@ await cleanup();
 
 Requires `@modelcontextprotocol/sdk` as a dev dependency.
 
+## Environment variables
+
+This package exposes no environment variables. Remote content helpers use the runtime `fetch`
+implementation and do not read package-level configuration.
+
+## Configuration
+
+There are no package-level config files. Configure each server in code with `createServer(options)`,
+per-tool schemas, and per-call content helper options such as `maxBytes` for remote files.
+
 ## License
 
 MIT

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

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

package/node_modules/toolcraft-design/README.md

@@ -54,7 +54,7 @@ import { renderTable } from "toolcraft-design/render-table";
 - `helpFormatter`, `helpFormatterPlain`: styled and plain help formatting APIs.
 - `formatColumns`, `formatCommand`, `formatUsage`, `formatOption`, `formatCommandList`, `formatOptionList`: individual help-formatting functions.
 - `formatCommandNotFound`, `formatCommandNotFoundPanel`: command error rendering.
-- `renderTable`, `renderDetailCard`: tabular and detail-card rendering.
+- `renderTable`, `renderDetailCard`, `renderInspectorCard`, `renderResourceBrowser`: tabular, detail-card, inspector-panel, and grouped resource-browser rendering.
 - `getTemplatePartialNames`, `renderTemplate`, `resolveTemplatePartials`: template rendering utilities.
 - `openExternal`: opens a URL or file with the platform browser command.
 - Types: `Color`, `LoggerOutput`, `CommandInfo`, `OptionInfo`, `FormatColumnsOptions`, `TableColumn`, `RenderTableOptions`, `DetailCardRow`, `DetailCardSection`, `RenderDetailCardOptions`, `RenderTemplateOptions`, `TemplateEscape`.
@@ -79,8 +79,8 @@ import { renderTable } from "toolcraft-design/render-table";
 ### Explorer
 
 - `explorer`: namespace containing the complete explorer API.
-- `runExplorer`, `singleDetail`: root-level explorer exports.
-- Root-level types: `Row`, `DetailItem`, `Detail`, `DetailCtx`, `Action`, `ActionContext`, `ExplorerConfig`, `ReorderContext`, `Tone`.
+- `runExplorer`, `runTwoPaneExplorer`, `singleDetail`: root-level explorer exports.
+- Root-level types: `Row`, `DetailItem`, `Detail`, `DetailCtx`, `Action`, `ActionContext`, `ExplorerConfig`, `ReorderContext`, `Tone`, `TwoPaneExplorerConfig`, `TwoPaneRow`, `TwoPaneAction`, `TwoPaneActionContext`.
 - The namespace also exports `createInitialState`, `resolveBindings`, and the remaining explorer event, binding, layout, size, state, and effect types.
 
 Explorers declare one to three list or detail panes. Printable input always filters; actions use optional Ctrl accelerators:

package/node_modules/toolcraft-schema/README.md

@@ -19,10 +19,10 @@ import { S, toJsonSchema, toJsonSchemaDocument, validateValue } from "toolcraft-
 import type { Static } from "toolcraft-schema";
 
 const schema = S.Object({
-  name: S.String({ description: "User name" }),
-  retries: S.Optional(S.Number({ default: 3 })),
+  name: S.String({ description: "User name", minLength: 1 }),
+  retries: S.Optional(S.Number({ default: 3, minimum: 0, jsonType: "integer" })),
   mode: S.Enum(["fast", "safe"] as const, { default: "safe" }),
-  tags: S.Array(S.String(), { default: [] })
+  tags: S.Array(S.String(), { default: [], maxItems: 5 })
 });
 
 type Input = Static<typeof schema>;
@@ -64,15 +64,18 @@ const validation = validateValue(schema, {
 
 - `Static<typeof schema>` infers the runtime TypeScript shape for a schema descriptor.
 - Object properties wrapped in `S.Optional(...)` become optional properties in `Static`.
+- Schemas declared with `nullable: true` infer `null` in `Static` and emit `nullable: true` in JSON Schema.
 
 ### JSON Schema generation
 
 - `toJsonSchema(schema)` converts any schema descriptor to standard JSON Schema.
 - `toJsonSchemaDocument(schema, options)` wraps `toJsonSchema(schema)` in a full JSON Schema document with `$schema`, optional `$id`, `title`, and `description`.
 - Object properties not wrapped in `S.Optional(...)` are emitted in `required`.
-- Defaults provided to schema builders are emitted as JSON Schema `default`.
-- Nested `S.Object(...)` schemas produce nested JSON Schema objects.
+- Defaults provided to schema builders are emitted as JSON Schema `default` and must satisfy the schema.
+- String, number, and array constraints are emitted as JSON Schema validation keywords.
+- Nested `S.Object(...)` schemas produce nested JSON Schema objects. Object schemas default to `additionalProperties: false`; pass `additionalProperties: true` to allow unknown keys.
 - `S.Enum(...)` rejects empty or duplicate values at runtime for JavaScript callers.
+- Invalid builder configuration fails fast, including invalid regex patterns, negative lengths/counts, inverted min/max pairs, non-finite numeric bounds, and integer schemas with non-integer defaults.
 
 ### Runtime validation
 

package/node_modules/toolcraft-schema/package.json

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

package/package.json

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