@toolgrain/protocol 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# @toolgrain/protocol
+
+## 0.1.2
+
+### Patch Changes
+
+- da94c47: Document the public API with JSDoc for exported types, members, options, and functions. Preserve field documentation in auth accessor return types and protocol constant hovers.
+- f199707: Point package homepages and README documentation links to the live Toolgrain documentation site.
+- d0c10ac: Use matching stable Toolgrain packages in installation instructions instead of
+  embedding outdated release pins.
+
+## 0.1.1
+
+### Patch Changes
+
+- 16752a8: Refresh package READMEs with Toolgrain branding, clearer package roles, and direct
+  links to the tool, transport, and authorization guides. Clarify the supported Zod
+  version in installation commands and explicitly load Node types when compiling
+  the Node examples with current TypeScript.
+
+## 0.1.0
+
+Initial stable release. See the [0.1.0 release notes](https://github.com/keshavkatwe/toolgrain/releases/tag/v0.1.0) for installation instructions and known limitations.

package/README.md

@@ -1,15 +1,29 @@
+<a href="https://github.com/keshavkatwe/toolgrain#readme">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/keshavkatwe/toolgrain/main/brand/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/keshavkatwe/toolgrain/main/brand/logo-light.svg">
+    <img src="https://raw.githubusercontent.com/keshavkatwe/toolgrain/main/brand/logo-light.svg" alt="Toolgrain" width="200" height="48">
+  </picture>
+</a>
+
 # @toolgrain/protocol
 
-Pinned MCP wire types, protocol versions, and upstream provenance for Toolgrain.
-This package has no runtime dependencies. Tool authoring lives in
-[@toolgrain/mcp](https://github.com/keshavkatwe/toolgrain/tree/main/packages/mcp#readme).
+**MCP wire types, with provenance.**
+
+Pinned protocol definitions and version constants for Toolgrain, with no runtime
+dependencies. Tool authoring lives in `@toolgrain/mcp`.
+
+[Documentation](https://toolgrain.mintlify.site/reference/protocol) ·
+[Examples](https://toolgrain.mintlify.site/examples) ·
+[npm](https://www.npmjs.com/package/@toolgrain/protocol)
 
 ## Installation
 
-Install the same `0.1.0` version across Toolgrain libraries.
+Install matching stable versions across Toolgrain libraries. These commands
+resolve npm's `latest` tag.
 
 ```sh
-npm install @toolgrain/protocol@0.1.0
+npm install @toolgrain/protocol
 ```
 
 ## Protocol versions and wire types
@@ -47,7 +61,7 @@ These are wire definitions; runtime validation remains in `@toolgrain/mcp`.
 
 ESM only. Supported application runtimes are Node.js `^24.20.0` or Bun
 `>=1.4.4 <2`. TypeScript requires 5.5.4 or later with `strict` enabled. See the
-[support policy](https://github.com/keshavkatwe/toolgrain/blob/main/docs/support-policy.md).
+[support policy](https://toolgrain.mintlify.site/project/support-policy).
 
 ## Upstream provenance and licensing
 

package/dist/index.d.ts

@@ -1,7 +1,10 @@
-import { LATEST_PROTOCOL_VERSION as LEGACY_PROTOCOL_VERSION } from "./vendor/2025-06-18/schema.js";
 export type { LegacyJSONRPCErrorResponse, ProtocolResponse, } from "./responses.js";
 export * from "./vendor/2026-07-28/schema.js";
-export { LATEST_PROTOCOL_VERSION as PROTOCOL_VERSION } from "./vendor/2026-07-28/schema.js";
-export { LEGACY_PROTOCOL_VERSION };
+/** Modern MCP revision used by Toolgrain for initialization-free requests: `2026-07-28`. */
+export declare const PROTOCOL_VERSION = "2026-07-28";
+/** Initialization-based MCP revision supported by the legacy adapter: `2025-06-18`. */
+export declare const LEGACY_PROTOCOL_VERSION = "2025-06-18";
+/** Supported MCP revisions, ordered modern first and legacy second; other revisions are unsupported. */
 export declare const SUPPORTED_PROTOCOL_VERSIONS: readonly ["2026-07-28", "2025-06-18"];
+/** Union of the modern and initialization-based legacy revisions supported by Toolgrain. */
 export type SupportedProtocolVersion = (typeof SUPPORTED_PROTOCOL_VERSIONS)[number];

package/dist/index.js

@@ -1,8 +1,11 @@
-import { LATEST_PROTOCOL_VERSION as LEGACY_PROTOCOL_VERSION } from "./vendor/2025-06-18/schema.js";
+import { LATEST_PROTOCOL_VERSION as LEGACY_VERSION } from "./vendor/2025-06-18/schema.js";
 import { LATEST_PROTOCOL_VERSION } from "./vendor/2026-07-28/schema.js";
 export * from "./vendor/2026-07-28/schema.js";
-export { LATEST_PROTOCOL_VERSION as PROTOCOL_VERSION } from "./vendor/2026-07-28/schema.js";
-export { LEGACY_PROTOCOL_VERSION };
+/** Modern MCP revision used by Toolgrain for initialization-free requests: `2026-07-28`. */
+export const PROTOCOL_VERSION = LATEST_PROTOCOL_VERSION;
+/** Initialization-based MCP revision supported by the legacy adapter: `2025-06-18`. */
+export const LEGACY_PROTOCOL_VERSION = LEGACY_VERSION;
+/** Supported MCP revisions, ordered modern first and legacy second; other revisions are unsupported. */
 export const SUPPORTED_PROTOCOL_VERSIONS = [
     LATEST_PROTOCOL_VERSION,
     LEGACY_PROTOCOL_VERSION,

package/dist/legacy.d.ts

@@ -1,2 +1,3 @@
 export * from "./vendor/2025-06-18/schema.js";
-export { LATEST_PROTOCOL_VERSION as PROTOCOL_VERSION } from "./vendor/2025-06-18/schema.js";
+/** Legacy initialization-based MCP revision for this entry point: `2025-06-18`. */
+export declare const PROTOCOL_VERSION = "2025-06-18";

package/dist/legacy.js

@@ -1,2 +1,4 @@
+import { LATEST_PROTOCOL_VERSION } from "./vendor/2025-06-18/schema.js";
 export * from "./vendor/2025-06-18/schema.js";
-export { LATEST_PROTOCOL_VERSION as PROTOCOL_VERSION } from "./vendor/2025-06-18/schema.js";
+/** Legacy initialization-based MCP revision for this entry point: `2025-06-18`. */
+export const PROTOCOL_VERSION = LATEST_PROTOCOL_VERSION;

package/dist/responses.d.ts

@@ -2,6 +2,7 @@ import type { JSONRPCError as LegacyJSONRPCError, JSONRPCResponse as LegacyJSONR
 import type { JSONRPCResponse } from "./vendor/2026-07-28/schema.js";
 /** JSON-RPC requires a null ID when the request ID cannot be established. */
 export type LegacyJSONRPCErrorResponse = Omit<LegacyJSONRPCError, "id"> & {
+    /** Original request ID, or `null` when parsing/validation could not establish one. */
     id: RequestId | null;
 };
 /** A response envelope in either supported MCP protocol era. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolgrain/protocol",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Pinned MCP wire types, protocol versions, and upstream provenance for Toolgrain.",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
@@ -8,7 +8,7 @@
     "url": "git+https://github.com/keshavkatwe/toolgrain.git",
     "directory": "packages/protocol"
   },
-  "homepage": "https://github.com/keshavkatwe/toolgrain/tree/main/packages/protocol#readme",
+  "homepage": "https://toolgrain.mintlify.site/reference/protocol",
   "bugs": {
     "url": "https://github.com/keshavkatwe/toolgrain/issues"
   },
@@ -36,6 +36,7 @@
     }
   },
   "files": [
+    "CHANGELOG.md",
     "dist",
     "NOTICE"
   ],