@toolgrain/protocol 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @toolgrain/protocol
 
+## 0.1.3
+
+No changes in this release.
+
+## 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

package/README.md

@@ -13,16 +13,17 @@
 Pinned protocol definitions and version constants for Toolgrain, with no runtime
 dependencies. Tool authoring lives in `@toolgrain/mcp`.
 
-[Documentation](https://github.com/keshavkatwe/toolgrain/blob/main/docs/architecture.md) ·
-[Examples](https://github.com/keshavkatwe/toolgrain/blob/main/apps/README.md) ·
+[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
@@ -60,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.1",
+  "version": "0.1.3",
   "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"
   },