@cyanheads/mcp-ts-core 0.1.8 → 0.1.9

package/CLAUDE.md

@@ -1,6 +1,6 @@
 # Agent Protocol
 
-**Package:** `@cyanheads/mcp-ts-core` · **Version:** 0.1.8
+**Package:** `@cyanheads/mcp-ts-core` · **Version:** 0.1.9
 **npm:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) · **Docker:** [ghcr.io/cyanheads/mcp-ts-core](https://ghcr.io/cyanheads/mcp-ts-core)
 
 > **Developer note:** Never assume. Read related files and docs before making changes. Read full file content for context. Never edit a file before reading it.
@@ -128,7 +128,7 @@ interface ServerHandle {
 
 ## Server Structure
 
-```
+```text
 src/
   index.ts                              # createApp() entry point
   worker.ts                             # createWorkerHandler() (if using Workers)

package/README.md

@@ -5,7 +5,7 @@
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-0.1.8-blue.svg?style=flat-square)](./CHANGELOG.md) [![MCP Spec](https://img.shields.io/badge/MCP%20Spec-2025--11--25-8A2BE2.svg?style=flat-square)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-11-25/changelog.mdx) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.27.1-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE)
+[![Version](https://img.shields.io/badge/Version-0.1.9-blue.svg?style=flat-square)](./CHANGELOG.md) [![MCP Spec](https://img.shields.io/badge/MCP%20Spec-2025--11--25-8A2BE2.svg?style=flat-square)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-11-25/changelog.mdx) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.27.1-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE)
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-^5.9.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
 
@@ -107,7 +107,7 @@ It also works on Cloudflare Workers with `createWorkerHandler()` — same defini
 
 ## Server structure
 
-```
+```text
 my-mcp-server/
   src/
     index.ts                              # createApp() entry point

package/biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.4.7/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.8/schema.json",
   "vcs": {
     "enabled": true,
     "clientKind": "git",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/mcp-ts-core",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "mcpName": "io.github.cyanheads/mcp-ts-core",
   "description": "TypeScript framework for building Model Context Protocol (MCP) servers. Declarative tool/resource/prompt definitions, pluggable auth, multi-backend storage, OpenTelemetry observability, and support for both local (stdio/HTTP) and edge (Cloudflare Workers) runtimes.",
   "main": "dist/core/app.js",

package/scripts/tree.ts

@@ -241,7 +241,7 @@ function buildOutputContent(projectName: string, treeContent: string, maxDepth:
   const timestamp = new Date().toISOString().replace(/T/, ' ').replace(/\..+/, '');
   const header = `# ${projectName} - Directory Structure\n\nGenerated on: ${timestamp}\n`;
   const depthInfo = maxDepth !== Infinity ? `\n_Depth limited to ${maxDepth} levels_\n\n` : '\n';
-  const treeBlock = `\`\`\`\n${projectName}/\n${treeContent}\`\`\`\n`;
+  const treeBlock = `\`\`\`text\n${projectName}/\n${treeContent}\`\`\`\n`;
   const footer = `\n_Note: This tree excludes files and directories matched by .gitignore and default patterns._\n`;
   return header + depthInfo + treeBlock + footer;
 }

package/skills/README.md

@@ -14,7 +14,7 @@ Skills flow through three locations. Each tier has a distinct role:
 
 ### Flow
 
-```
+```text
 npm publish                    init CLI                    agent sync
 [package skills/] ──────────> [project skills/] ──────────> [.claude/skills/]
                                      │

package/skills/add-export/SKILL.md

@@ -19,6 +19,7 @@ The build uses `tsconfig.build.json` (not `tsconfig.json`) with `rootDir: ./src`
 
 1. **Create the entry point** source file under `src/` (e.g., `src/utils/new-util.ts`)
 2. **Add the subpath** to `package.json` `exports`, mirroring the source path:
+
    ```jsonc
    // source: src/utils/new-util.ts → dist: dist/utils/new-util.js
    "./newutil": {
@@ -26,9 +27,11 @@ The build uses `tsconfig.build.json` (not `tsconfig.json`) with `rootDir: ./src`
      "import": "./dist/utils/new-util.js"
    }
    ```
+
 3. **Update the exports catalog** in `CLAUDE.md` — add a row to the table
 4. **Build** with `bun run build` to generate `dist/` output
 5. **Verify the export** by inspecting the compiled output directly:
+
    ```bash
    # Confirm the compiled file exists at the expected dist path
    ls dist/utils/new-util.js
@@ -36,6 +39,7 @@ The build uses `tsconfig.build.json` (not `tsconfig.json`) with `rootDir: ./src`
    # Confirm the declared exports resolve to real files
    bun -e "import('./dist/utils/new-util.js').then(m => console.log(Object.keys(m)))"
    ```
+
 6. **Run `bun run devcheck`** to verify
 
 ## Naming conventions

package/skills/add-provider/SKILL.md

@@ -49,6 +49,7 @@ Provider file location and naming differ by domain:
 2. **Create the provider file** following the file convention for its domain (see above).
 3. **Implement the interface** — all methods must be implemented.
 4. **Lazy-load dependencies** if Tier 3:
+
    ```typescript
    let _client: SomeClient | undefined;
    async function getClient(): Promise<SomeClient> {
@@ -59,6 +60,7 @@ Provider file location and naming differ by domain:
      return _client;
    }
    ```
+
 5. **Register the provider** — the registration point differs by domain:
 
    - **Storage** — add a `case` to the `switch` in `src/storage/core/storageFactory.ts`
@@ -79,10 +81,12 @@ Provider file location and naming differ by domain:
 6. **Update the Worker-compatible provider list** if the new storage provider runs in
    Cloudflare Workers. The list is an inline array in `storageFactory.ts` at the
    `isServerless()` guard:
+
    ```typescript
    // src/storage/core/storageFactory.ts ~line 112
    !['in-memory', 'cloudflare-r2', 'cloudflare-kv', 'cloudflare-d1'].includes(providerType)
    ```
+
    Add the new provider string to this array. Non-storage providers have no equivalent
    gate.
 

package/skills/api-auth/SKILL.md

@@ -50,6 +50,7 @@ handler: async (input, ctx) => {
 **Signature:** `checkScopes(ctx: Context, requiredScopes: string[]): void`
 
 **Throws:**
+
 - `McpError(Forbidden)` — auth is active and one or more required scopes are missing
 - `McpError(Unauthorized)` — auth is enabled but no auth context exists on the request
 - No-ops when `MCP_AUTH_MODE=none`

package/skills/api-utils/SKILL.md

@@ -56,7 +56,7 @@ Utility exports from `@cyanheads/mcp-ts-core/utils`. Utilities with complex APIs
 
 | Export | API | Notes |
 |:-------|:----|:------|
-| `schedulerService` | `.schedule(id, schedule, taskFunction, description) -> Promise<Job>` `.start(id) -> void` `.stop(id) -> void` `.remove(id) -> void` `.listJobs() -> Job[]` | **Async** `schedule()` — Tier 3 peer: `node-cron`. **Node-only** (throws `ConfigurationError` in Workers). Jobs start in stopped state; call `start(id)` to activate. Skips overlapping executions. Each tick gets fresh `RequestContext`. `Job: { id, schedule, description, isRunning, task }`. `taskFunction: (context: RequestContext) => void | Promise<void>`. |
+| `schedulerService` | `.schedule(id, schedule, taskFunction, description) -> Promise<Job>` `.start(id) -> void` `.stop(id) -> void` `.remove(id) -> void` `.listJobs() -> Job[]` | **Async** `schedule()` — Tier 3 peer: `node-cron`. **Node-only** (throws `ConfigurationError` in Workers). Jobs start in stopped state; call `start(id)` to activate. Skips overlapping executions. Each tick gets fresh `RequestContext`. `Job: { id, schedule, description, isRunning, task }`. `taskFunction: (context: RequestContext) => void` \| `Promise<void>`. |
 
 ---
 

package/skills/api-utils/references/formatting.md

@@ -24,7 +24,7 @@ import { markdown, MarkdownBuilder, diffFormatter, tableFormatter, treeFormatter
 | `codeBlock` | `(content, language?) -> this` | Fenced block; `language` defaults to `''` |
 | `inlineCode` | `(code) -> this` | Backtick-wrapped; no trailing newline |
 | `paragraph` | `(text) -> this` | Text + `\n\n` |
-| `blockquote` | `(text) -> this` | Each line prefixed with `> ` |
+| `blockquote` | `(text) -> this` | Each line prefixed with `>` + space |
 | `hr` | `() -> this` | `---` |
 | `link` | `(text, url) -> this` | `[text](url)`; no trailing newline |
 | `table` | `(headers, rows) -> this` | GFM table; no-ops if headers or rows empty |
@@ -150,7 +150,7 @@ interface TableFormatterOptions {
 | Style | Description |
 |:------|:------------|
 | `markdown` | GFM pipes with alignment indicators in separator row |
-| `ascii` | `+`/`-`/`|` box drawing |
+| `ascii` | `+`/`-`/`\|` box drawing |
 | `grid` | Unicode box drawing (`┌─┬─┐` / `│` / `├─┼─┤` / `└─┴─┘`) |
 | `compact` | Space-separated, no borders |
 
@@ -211,7 +211,7 @@ interface TreeFormatterOptions {
 | Style | Connectors |
 |:------|:-----------|
 | `unicode` | `├──` / `└──` / `│` |
-| `ascii` | `+--` / `\--` / `|` |
+| `ascii` | `+--` / `\--` / `\|` |
 | `compact` | Indented list, no connectors |
 
 ### Usage

package/skills/api-utils/references/parsing.md

@@ -7,6 +7,7 @@ import { yamlParser, xmlParser, csvParser, jsonParser, pdfParser, dateParser, fr
 All parsers are **Tier 3** — lazy-load their peer dependency on first call. All methods are **async** unless noted.
 
 **Common behavior:**
+
 - Singleton instances exported alongside classes
 - `<think>...</think>` blocks at the start of input are automatically stripped and logged at `debug` level (except `dateParser` and `pdfParser`)
 - All `context?: RequestContext` parameters are optional (synthetic context created if omitted)

package/skills/design-mcp-server/SKILL.md

@@ -240,6 +240,7 @@ For each resource:
 ### 6. Design Prompts (if needed)
 
 Optional. Use when the server has recurring interaction patterns worth structuring:
+
 - Analysis frameworks, report templates, multi-step workflows
 
 Skip for purely data/action-oriented servers.

package/skills/polish-docs-meta/SKILL.md

@@ -34,6 +34,7 @@ If these aren't met, address them first.
 Read all tool, resource, and prompt definitions. Build a mental model of what the server actually does — names, descriptions, input/output shapes, auth scopes. This inventory drives every document below.
 
 Read:
+
 - `src/index.ts` (what's registered in `createApp()`)
 - All files in `src/mcp-server/tools/definitions/`
 - All files in `src/mcp-server/resources/definitions/`

package/skills/polish-docs-meta/references/agent-protocol.md

@@ -27,6 +27,7 @@ The scaffolded template includes a `## First Session` section with one-time onbo
 Check the Patterns section for generic template examples (e.g., `searchItems`, `itemData`, `reviewCode`). If still present, replace them with actual tool/resource/prompt definitions from the server — or the most representative ones if there are many. If the examples already reflect real definitions, verify they're still accurate.
 
 Pick examples that:
+
 - Show the most common or important capability
 - Demonstrate any non-trivial patterns the server uses (e.g., `ctx.state`, `ctx.elicit`, `task: true`, services)
 - Include a handler with real business logic, not just passthrough

package/skills/release/SKILL.md

@@ -82,7 +82,7 @@ bun run build
 
 ### 9. Commit
 
-```
+```text
 chore: release v{{VERSION}}
 ```
 
@@ -96,7 +96,7 @@ git tag -a v{{VERSION}} -m "v{{VERSION}}: <one-line summary of key changes>"
 
 The tag message should capture the most important change(s) — not the full changelog, just enough to orient someone browsing tags. Examples:
 
-```
+```text
 v0.2.0: Cloudflare Workers support, task tools, Graph service
 v0.1.7: OTel instrumentation refactor, lighter semconv
 v0.1.6: Error factory functions, auto-classification patterns

package/skills/setup/SKILL.md

@@ -32,7 +32,7 @@ Read that file once per session. It contains the exports catalog, tool/resource/
 
 What `init` actually creates:
 
-```
+```text
 CLAUDE.md                                       # Agent protocol (project-specific)
 AGENTS.md                                       # Same content — delete whichever you don't use
 skills/                                         # Project skills (source of truth)
@@ -49,7 +49,7 @@ src/
 
 Add these as needed:
 
-```
+```text
 src/
   worker.ts                                     # createWorkerHandler() — only for Cloudflare Workers
   config/

package/templates/AGENTS.md

@@ -156,7 +156,7 @@ Plain `Error` is fine for most cases. Use factories when the error code matters.
 
 ## Structure
 
-```
+```text
 src/
   index.ts                              # createApp() entry point
   config/

package/templates/CLAUDE.md

@@ -156,7 +156,7 @@ Plain `Error` is fine for most cases. Use factories when the error code matters.
 
 ## Structure
 
-```
+```text
 src/
   index.ts                              # createApp() entry point
   config/