toolcraft 0.0.93 → 0.0.95

package/node_modules/auth-store/README.md

@@ -45,3 +45,18 @@ await store.delete();
 
 - Uses the `security` CLI (`add-generic-password`, `find-generic-password`, `delete-generic-password`)
 - Configurable service and account names
+
+## Configuration Options
+
+`createSecretStore()` accepts:
+
+- `backendEnvVar`: optional env var name that selects `file` or `keychain`.
+- `fileStore.salt`: application-specific encryption salt.
+- `fileStore.defaultDirectory`: default credential directory.
+- `fileStore.defaultFileName`: encrypted file name.
+- `keychainStore.service`: macOS Keychain service name.
+- `keychainStore.account`: macOS Keychain account name.
+
+## Environment Variables
+
+This package reads only the caller-selected `backendEnvVar`. It does not define a fixed public env var.

package/node_modules/auth-store/package.json

@@ -1,4 +1,6 @@
 {
+  "name": "auth-store",
+  "version": "0.0.1",
   "private": true,
   "license": "MIT",
   "type": "module",

package/node_modules/tiny-mcp-client/README.md

@@ -8,7 +8,7 @@
 import { HttpTransport, McpClient } from "tiny-mcp-client";
 
 const client = new McpClient({
-  clientInfo: { name: "demo", version: "0.1.0" },
+  clientInfo: { name: "demo", version: "0.1.0" }
 });
 
 await client.connect(new HttpTransport({ url: "http://127.0.0.1:3000/mcp" }));
@@ -16,7 +16,7 @@ const tools = await client.listTools();
 console.log(tools);
 const result = await client.callTool({
   name: "search",
-  arguments: { query: "typed outputs" },
+  arguments: { query: "typed outputs" }
 });
 console.log(result.structuredContent);
 await client.close();
@@ -26,11 +26,11 @@ await client.close();
 
 ## Transports
 
-| Transport | Description |
-|-----------|-------------|
-| `StdioTransport` | Spawns an MCP server process and communicates over stdio. |
-| `HttpTransport` | Connects to streamable HTTP MCP endpoints, including session IDs, SSE GET streams, and session termination. |
-| `createInMemoryTransportPair()` | Creates paired streams for in-process tests. |
+| Transport                       | Description                                                                                                 |
+| ------------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| `StdioTransport`                | Spawns an MCP server process and communicates over stdio.                                                   |
+| `HttpTransport`                 | Connects to streamable HTTP MCP endpoints, including session IDs, SSE GET streams, and session termination. |
+| `createInMemoryTransportPair()` | Creates paired streams for in-process tests.                                                                |
 
 ## OAuth HTTP support
 
@@ -46,16 +46,16 @@ const transport = new HttpTransport({
       client: {
         mode: "dynamic",
         metadata: {
-          clientName: "tiny-client",
-        },
+          clientName: "tiny-client"
+        }
       },
       browser: {
         openBrowser: async (url) => {
           console.log(`Open ${url}`);
-        },
-      },
-    }),
-  },
+        }
+      }
+    })
+  }
 });
 ```
 
@@ -67,38 +67,38 @@ You can also call `discoverOAuthMetadata(resourceUrl, options)` directly, or ins
 - `createInMemoryTransportPair()` is useful for fast unit tests without opening sockets or spawning processes.
 - JSON-RPC error constants are exported for assertions: `ERROR_PARSE`, `ERROR_INVALID_REQUEST`, `ERROR_METHOD_NOT_FOUND`, `ERROR_INVALID_PARAMS`, and `ERROR_INTERNAL`.
 
-## Config options
+## Configuration Options
 
 ### `McpClientOptions`
 
-| Option | Type | Description |
-|--------|------|-------------|
-| `clientInfo` | `{ name: string; version: string }` | Required client identity sent during initialize. |
-| `capabilities` | `ClientCapabilities` | Optional MCP client capabilities. |
-| `onToolsChanged`, `onResourcesChanged`, `onPromptsChanged` | callbacks | Optional notification handlers. |
-| `onResourceUpdated`, `onLog`, `onProgress` | callbacks | Optional resource/log/progress handlers. |
-| `onSamplingRequest`, `onRootsList` | callbacks | Optional server-to-client request handlers. |
+| Option                                                     | Type                                | Description                                      |
+| ---------------------------------------------------------- | ----------------------------------- | ------------------------------------------------ |
+| `clientInfo`                                               | `{ name: string; version: string }` | Required client identity sent during initialize. |
+| `capabilities`                                             | `ClientCapabilities`                | Optional MCP client capabilities.                |
+| `onToolsChanged`, `onResourcesChanged`, `onPromptsChanged` | callbacks                           | Optional notification handlers.                  |
+| `onResourceUpdated`, `onLog`, `onProgress`                 | callbacks                           | Optional resource/log/progress handlers.         |
+| `onSamplingRequest`, `onRootsList`                         | callbacks                           | Optional server-to-client request handlers.      |
 
 ### `HttpTransportOptions`
 
-| Option | Type | Description |
-|--------|------|-------------|
-| `url` | `string` | MCP HTTP endpoint URL. |
-| `headers` | `HeadersInit` | Static headers added to requests. |
-| `fetch` | `(input, init?) => Promise<Response>` | Custom fetch implementation. |
-| `oauth` | `OAuthClientProviderOptions` | Enables OAuth authorization handling. |
-| `oauthDiscoveryCache` | `OAuthDiscoveryCache` | Optional shared metadata cache. |
+| Option                | Type                                  | Description                           |
+| --------------------- | ------------------------------------- | ------------------------------------- |
+| `url`                 | `string`                              | MCP HTTP endpoint URL.                |
+| `headers`             | `HeadersInit`                         | Static headers added to requests.     |
+| `fetch`               | `(input, init?) => Promise<Response>` | Custom fetch implementation.          |
+| `oauth`               | `OAuthClientProviderOptions`          | Enables OAuth authorization handling. |
+| `oauthDiscoveryCache` | `OAuthDiscoveryCache`                 | Optional shared metadata cache.       |
 
 ### `StdioTransportOptions`
 
-| Option | Type | Description |
-|--------|------|-------------|
-| `command` | `string` | Server executable. |
-| `args` | `string[]` | Server args. |
-| `cwd` | `string` | Server working directory. |
-| `env` | `NodeJS.ProcessEnv` | Server environment. |
-| `spawn` | `StdioSpawn` | Custom spawn function for tests. |
+| Option    | Type                | Description                      |
+| --------- | ------------------- | -------------------------------- |
+| `command` | `string`            | Server executable.               |
+| `args`    | `string[]`          | Server args.                     |
+| `cwd`     | `string`            | Server working directory.        |
+| `env`     | `NodeJS.ProcessEnv` | Server environment.              |
+| `spawn`   | `StdioSpawn`        | Custom spawn function for tests. |
 
-## Environment variables
+## Environment Variables
 
 This package does not expose public environment variables. Pass process environment explicitly through `StdioTransportOptions.env` when a spawned MCP server needs it.

package/node_modules/tiny-mcp-client/package.json

@@ -1,4 +1,6 @@
 {
+  "name": "tiny-mcp-client",
+  "version": "0.1.0",
   "private": true,
   "license": "MIT",
   "type": "module",

package/node_modules/toolcraft-design/README.md

@@ -118,16 +118,16 @@ Raw HTML in Markdown is escaped by default. Pass `{ allowRawHtml: true }` only w
 
 Fenced code block syntax highlighting is opt-in:
 
-```ts
+````ts
 import { renderMarkdown, renderMarkdownHtml } from "toolcraft-design";
 
-const html = renderMarkdownHtml("```ts\nconst value = \"hello\";\n```", {
+const html = renderMarkdownHtml('```ts\nconst value = "hello";\n```', {
   syntaxHighlight: true
 });
-const terminal = renderMarkdown("```ts\nconst value = \"hello\";\n```", {
+const terminal = renderMarkdown('```ts\nconst value = "hello";\n```', {
   syntaxHighlight: true
 });
-```
+````
 
 HTML highlighting emits escaped code text with neutral Toolcraft-owned `<span>` wrappers. The renderer does not ship or inject CSS, so consumers control the appearance:
 
@@ -340,3 +340,7 @@ nvm exec 18.18 node packages/toolcraft-design/scripts/check-node18.mjs
 - `NO_COLOR`: disables color when `FORCE_COLOR` does not enable it.
 - `TERM`: participates in color support detection; an unset or `dumb` terminal disables color unless forced.
 - `POE_NO_SPINNER`: uses non-animated spinner behavior when set to `1`.
+
+## Configuration Options
+
+Use `configureTheme({ brand?, label? })` for process-local brand settings, `withOutputFormat(format, fn)` for scoped output-format overrides, and component-specific options such as `RenderTableOptions`, `RenderMarkdownOptions`, prompt options, dashboard options, and explorer config. Environment variables above are process defaults, not config files.

package/node_modules/toolcraft-design/dist/dashboard/terminal.js

@@ -118,19 +118,18 @@ export function createTerminalDriver(opts) {
         if (destroyed) {
             return () => { };
         }
-        const listener = (str, key) => {
-            const event = toKeypressEvent(str, key);
-            if (event !== undefined) {
+        const listener = (chunk) => {
+            for (const event of parseKeypressChunk(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk))) {
                 handler(event);
             }
         };
         keypressListeners.add(listener);
-        stdin.on("keypress", listener);
+        stdin.on("data", listener);
         return () => {
             if (!keypressListeners.delete(listener)) {
                 return;
             }
-            stdin.off("keypress", listener);
+            stdin.off("data", listener);
         };
     }
     function destroy() {
@@ -138,7 +137,7 @@ export function createTerminalDriver(opts) {
             return;
         }
         for (const listener of keypressListeners) {
-            stdin.off("keypress", listener);
+            stdin.off("data", listener);
         }
         keypressListeners.clear();
         for (const listener of resizeListeners) {
@@ -173,6 +172,9 @@ export function parseKeypress(data) {
     if (data.length === 0) {
         return undefined;
     }
+    if (data.length === 1 && data[0] === 0x1b) {
+        return { name: "escape", ctrl: false, meta: false, shift: false };
+    }
     const stream = new PassThrough();
     const stdin = stream;
     let event;
@@ -184,6 +186,46 @@ export function parseKeypress(data) {
     stream.destroy();
     return event;
 }
+function parseKeypressChunk(data) {
+    const events = [];
+    const input = data.toString("utf8");
+    let index = 0;
+    while (index < input.length) {
+        const sequence = nextKeySequence(input, index);
+        if (sequence.length === 0) {
+            break;
+        }
+        const event = parseKeypress(Buffer.from(sequence));
+        if (event !== undefined) {
+            events.push(event);
+        }
+        index += sequence.length;
+    }
+    return events;
+}
+function nextKeySequence(input, index) {
+    const character = input[index];
+    if (character === undefined) {
+        return "";
+    }
+    if (character !== "\u001b") {
+        return character;
+    }
+    const next = input[index + 1];
+    if (next === undefined) {
+        return character;
+    }
+    if (next !== "[") {
+        return input.slice(index, index + 2);
+    }
+    for (let cursor = index + 2; cursor < input.length; cursor += 1) {
+        const code = input.charCodeAt(cursor);
+        if ((code >= 0x40 && code <= 0x7e) || input[cursor] === "~") {
+            return input.slice(index, cursor + 1);
+        }
+    }
+    return input.slice(index);
+}
 function toKeypressEvent(str, key) {
     const controlCharacter = controlCharacterToKeypress(key?.sequence);
     if (controlCharacter !== undefined) {

package/node_modules/toolcraft-design/dist/explorer/actions.d.ts

@@ -7,6 +7,10 @@ type ExplorerKeypressEvent = Extract<ExplorerEvent, {
 export type ActionRuntimeHandles = {
     refresh: () => Promise<void>;
     suspendAnd: <T>(fn: () => Promise<T>) => Promise<T>;
+    openModal: (content: {
+        title: string;
+        content: string;
+    }) => void;
     toast: (msg: string, tone?: Tone) => void;
     confirm: (prompt: string) => Promise<boolean>;
     exit: (after?: () => void | Promise<void>) => void;

package/node_modules/toolcraft-design/dist/explorer/actions.js

@@ -20,6 +20,7 @@ export function buildActionContext(state, _action, source, runtimeHandles, rowsO
         filter: state.filter,
         refresh: runtimeHandles.refresh,
         suspendAnd: runtimeHandles.suspendAnd,
+        openModal: runtimeHandles.openModal,
         toast: runtimeHandles.toast,
         confirm: runtimeHandles.confirm,
         exit: runtimeHandles.exit

package/node_modules/toolcraft-design/dist/explorer/events.d.ts

@@ -55,6 +55,10 @@ export type ExplorerEvent = {
     type: "suspendResumed";
     value: unknown;
     emit: ExplorerEvent;
+} | {
+    type: "modalOpened";
+    title: string;
+    content: string;
 } | {
     type: "modalDismissed";
     result: unknown;

package/node_modules/toolcraft-design/dist/explorer/reducer.js

@@ -5,6 +5,7 @@ const NO_EFFECTS = [];
 const DEFAULT_ACTION_HANDLES = {
     refresh: async () => undefined,
     suspendAnd: async (fn) => fn(),
+    openModal: () => undefined,
     toast: () => undefined,
     confirm: async () => false,
     exit: () => undefined
@@ -31,6 +32,13 @@ export function step(state, event, runtimeHandles = DEFAULT_ACTION_HANDLES) {
             return expireToast(state);
         case "suspendResumed":
             return suspendResumed(state, event.emit, runtimeHandles);
+        case "modalOpened":
+            return setModal(state, {
+                kind: "content",
+                title: event.title,
+                content: event.content,
+                scroll: 0
+            });
         case "modalDismissed":
             return modalDismissed(state, event.result, runtimeHandles);
     }
@@ -164,6 +172,26 @@ function stepModalKey(state, key, target, runtimeHandles) {
         }
         return paletteInput(state, key);
     }
+    if (state.modal?.kind === "content") {
+        if (target?.type === "builtin") {
+            switch (target.id) {
+                case "escape":
+                case "confirm":
+                    return modalDismissed(state, false, runtimeHandles);
+                case "cursorDown":
+                case "detailScrollDown":
+                    return scrollContentModal(state, 1);
+                case "cursorUp":
+                case "detailScrollUp":
+                    return scrollContentModal(state, -1);
+                case "pageDown":
+                    return scrollContentModal(state, modalBodyHeight(state));
+                case "pageUp":
+                    return scrollContentModal(state, -modalBodyHeight(state));
+            }
+        }
+        return mark(state, 0);
+    }
     return mark(state, 0);
 }
 function resize(state, cols, rows) {
@@ -287,7 +315,7 @@ function suspendResumed(state, emit, runtimeHandles) {
 }
 function modalDismissed(state, result, runtimeHandles) {
     const modal = state.modal;
-    const closed = { ...state, modal: null, dirty: REGION_MODAL | REGION_FOOTER };
+    const closed = { ...state, modal: null, dirty: REGION_ALL };
     if (modal?.kind === "confirm") {
         modal.resolver(result === true);
     }
@@ -466,9 +494,6 @@ function selectionChanged(state, selected) {
     return { state: next, effects: NO_EFFECTS };
 }
 function detailScroll(state, delta) {
-    if (state.focused !== "detail") {
-        return mark(state, 0);
-    }
     const scroll = clamp(state.detail.scroll + delta, 0, maxDetailScroll(state));
     if (scroll === state.detail.scroll) {
         return mark(state, 0);
@@ -478,6 +503,29 @@ function detailScroll(state, delta) {
         effects: NO_EFFECTS
     };
 }
+function scrollContentModal(state, delta) {
+    if (state.modal?.kind !== "content") {
+        return mark(state, 0);
+    }
+    const scroll = clamp(state.modal.scroll + delta, 0, maxContentModalScroll(state));
+    if (scroll === state.modal.scroll) {
+        return mark(state, 0);
+    }
+    return setModal(state, { ...state.modal, scroll });
+}
+function maxContentModalScroll(state) {
+    if (state.modal?.kind !== "content") {
+        return 0;
+    }
+    return Math.max(0, state.modal.content.split("\n").length - modalBodyHeight(state));
+}
+function modalBodyHeight(state) {
+    const screenHeight = normalizeSize(state.size.rows);
+    if (screenHeight <= 2) {
+        return 0;
+    }
+    return Math.max(0, screenHeight - 4);
+}
 function clampDetailScroll(state) {
     const scroll = clamp(state.detail.scroll, 0, maxDetailScroll(state));
     if (scroll === state.detail.scroll) {

package/node_modules/toolcraft-design/dist/explorer/render/list.js

@@ -28,28 +28,34 @@ export function renderList(state, screen, layout) {
         cache.clear();
         return;
     }
-    let lastGroup;
+    const lines = buildDisplayLines(state);
+    const start = visibleStart(lines, bodyRect.height);
     let y = 0;
-    for (const rowIndex of state.filtered) {
-        if (y >= bodyRect.height) {
-            break;
-        }
-        const row = state.rows[rowIndex];
-        if (!row) {
-            continue;
-        }
-        if (row.group && row.group !== lastGroup && y < bodyRect.height) {
-            const hash = `group:${row.group}`;
+    for (let lineIndex = start; lineIndex < lines.length && y < bodyRect.height; lineIndex += 1) {
+        const line = lines[lineIndex];
+        if (line.kind === "group") {
+            const hash = `group:${line.label}`;
             if (cache.get(y) !== hash) {
-                writeLine(screen, bodyRect, y, formatGroupHeader(row.group, bodyRect), styles.muted);
+                writeLine(screen, bodyRect, y, formatGroupHeader(line.label, bodyRect), styles.muted);
                 cache.set(y, hash);
             }
             y += 1;
-            lastGroup = row.group;
+            continue;
+        }
+        if (line.kind === "subtitle") {
+            const subtitleHash = `subtitle:${line.row.id}:${line.text}`;
+            if (cache.get(y) !== subtitleHash) {
+                writeLine(screen, bodyRect, y, `  ${line.text}`, styles.muted);
+                cache.set(y, subtitleHash);
+            }
+            y += 1;
+            continue;
         }
+        const rowIndex = line.rowIndex;
         if (y >= bodyRect.height) {
             break;
         }
+        const row = line.row;
         const selected = state.multiSelect && state.selected.has(row.id);
         const cursor = rowIndex === state.filtered[state.cursor];
         const positions = state.matchPositions.get(rowIndex) ?? [];
@@ -64,15 +70,36 @@ export function renderList(state, screen, layout) {
             cache.set(y, hash);
         }
         y += 1;
-        if (row.subtitle && y < bodyRect.height) {
-            const subtitleHash = `${hash}:subtitle:${row.subtitle}`;
-            if (cache.get(y) !== subtitleHash) {
-                writeLine(screen, bodyRect, y, `  ${row.subtitle}`, styles.muted);
-                cache.set(y, subtitleHash);
-            }
-            y += 1;
+    }
+}
+function buildDisplayLines(state) {
+    const lines = [];
+    let lastGroup;
+    for (const rowIndex of state.filtered) {
+        const row = state.rows[rowIndex];
+        if (!row) {
+            continue;
+        }
+        if (row.group && row.group !== lastGroup) {
+            lines.push({ kind: "group", label: row.group });
+            lastGroup = row.group;
         }
+        lines.push({ kind: "row", rowIndex, row, cursor: rowIndex === state.filtered[state.cursor] });
+        if (row.subtitle) {
+            lines.push({ kind: "subtitle", row, text: row.subtitle });
+        }
+    }
+    return lines;
+}
+function visibleStart(lines, height) {
+    if (height <= 0) {
+        return 0;
+    }
+    const cursorLine = lines.findIndex((line) => line.kind === "row" && line.cursor);
+    if (cursorLine < 0) {
+        return 0;
     }
+    return Math.max(0, Math.min(cursorLine, cursorLine - height + 1));
 }
 function formatGroupHeader(label, rect) {
     const text = ` ${label} `;

package/node_modules/toolcraft-design/dist/explorer/render/modal.js

@@ -4,7 +4,7 @@ export function renderModal(state, screen) {
     if (state.modal === null || screen.width <= 0 || screen.height <= 0) {
         return;
     }
-    const width = Math.min(screen.width - 2, Math.max(34, Math.floor(screen.width * 0.62)));
+    const width = Math.min(screen.width - 2, Math.max(34, Math.floor(screen.width * modalWidthRatio(state))));
     const height = Math.min(screen.height - 2, modalHeight(state));
     const x = Math.max(0, Math.floor((screen.width - width) / 2));
     const y = Math.max(0, Math.floor((screen.height - height) / 2));
@@ -39,6 +39,9 @@ function modalLines(state) {
             ...paletteLines(state)
         ];
     }
+    if (state.modal?.kind === "content") {
+        return state.modal.content.split("\n").slice(state.modal.scroll);
+    }
     return [];
 }
 function title(state) {
@@ -48,11 +51,20 @@ function title(state) {
     if (state.modal?.kind === "confirm") {
         return "Confirm";
     }
+    if (state.modal?.kind === "content") {
+        return state.modal.title;
+    }
     return "Command Palette";
 }
 function modalHeight(state) {
+    if (state.modal?.kind === "content") {
+        return Math.max(5, state.modal.content.split("\n").length + 2);
+    }
     return Math.max(5, modalLines(state).length + 2);
 }
+function modalWidthRatio(state) {
+    return state.modal?.kind === "content" ? 0.86 : 0.62;
+}
 function drawBox(screen, x, y, width, height, boxTitle, style) {
     screen.clearRect({ x, y, width, height });
     const innerWidth = Math.max(0, width - 2);

package/node_modules/toolcraft-design/dist/explorer/render/test-fixtures.js

@@ -6,7 +6,7 @@ import { renderExplorer } from "./index.js";
 export function renderStateSnapshot(state) {
     const screen = new ScreenBuffer(state.size.cols, state.size.rows);
     renderExplorer(state, screen);
-    return dumpScreen(screen);
+    return dumpScreen(screen).split("\n").map((line) => line.trimEnd()).join("\n");
 }
 export function dumpScreen(screen) {
     const lines = [];

package/node_modules/toolcraft-design/dist/explorer/runtime.js

@@ -45,6 +45,9 @@ class ExplorerRuntime {
                 await this.refreshRowsFromSource();
             },
             suspendAnd: async (fn) => this.suspendAnd(fn),
+            openModal: (content) => {
+                this.dispatch({ type: "modalOpened", title: content.title, content: content.content });
+            },
             toast: (msg, tone) => {
                 this.showToast(msg, tone);
             },

package/node_modules/toolcraft-design/dist/explorer/state.d.ts

@@ -48,6 +48,10 @@ export interface ActionContext<R> {
     filter: string;
     refresh: () => Promise<void>;
     suspendAnd: <T>(fn: () => Promise<T>) => Promise<T>;
+    openModal: (content: {
+        title: string;
+        content: string;
+    }) => void;
     toast: (msg: string, tone?: Tone) => void;
     confirm: (prompt: string) => Promise<boolean>;
     exit: (after?: () => void | Promise<void>) => void;
@@ -114,6 +118,11 @@ export interface ExplorerState {
         kind: "palette";
         query: string;
         cursor: number;
+    } | {
+        kind: "content";
+        title: string;
+        content: string;
+        scroll: number;
     };
     toast: {
         message: string;

package/node_modules/toolcraft-design/package.json

@@ -1,4 +1,6 @@
 {
+  "name": "toolcraft-design",
+  "version": "0.0.2",
   "private": true,
   "license": "MIT",
   "type": "module",
@@ -45,5 +47,8 @@
     "type": "git",
     "url": "git+https://github.com/poe-platform/poe-code.git",
     "directory": "packages/toolcraft-design"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }