macp-sdk-typescript 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -4,6 +4,47 @@ All notable changes to `macp-sdk-typescript` are documented here. The format
 follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the
 project uses [Semantic Versioning](https://semver.org/).
 
+## [0.6.0](https://github.com/multiagentcoordinationprotocol/macp-sdk-typescript/compare/v0.5.0...v0.6.0) (2026-07-10)
+
+
+### Features
+
+* export package VERSION constant ([#37](https://github.com/multiagentcoordinationprotocol/macp-sdk-typescript/issues/37)) ([4ae5cda](https://github.com/multiagentcoordinationprotocol/macp-sdk-typescript/commit/4ae5cda23255b82339490f740a30ca0b7fee0d5a))
+
+## [Unreleased]
+
+### Changed
+
+- **BREAKING: requires Node.js >= 20** (`engines.node`). Node 18 reached
+  end-of-life in April 2025 and was never exercised in CI; the CI matrix now
+  tests Node 20, 22, and 24.
+- CI installs with `npm ci` against the committed lockfile (regenerated so all
+  platform-specific optional binaries are recorded), with npm caching and a
+  concurrency group that cancels superseded PR runs. The advisory-only
+  `npm audit` job is replaced by Dependabot (weekly grouped npm and
+  github-actions updates). All workflow actions are pinned by commit SHA.
+- Publishing now runs the full `prepublishOnly` gate (check + lint +
+  format:check + test + build) against the exact tree being published —
+  the `--ignore-scripts` workaround is gone.
+- Pull requests get a coverage summary comment from CI.
+
+### Added
+
+- Extensive unit coverage for previously integration-only surface: the
+  `MacpStream` data path (envelope unwrapping, inline errors, timeouts,
+  end-of-stream semantics), the entire `MacpClient` unary RPC surface and its
+  metadata/deadline dispatch, the `watch*` stream factories, session
+  `cancel`/`suspend`/`resume` delegation for all five modes, `BaseSession`/
+  `BaseProjection` extension-point behavior, and the `Participant` run loop
+  (terminal dispatch, cancel-callback wiring, initiator kickoff defaults).
+  Coverage thresholds raised to lines 94 / branches 88 / functions 90 /
+  statements 94.
+- Conformance: `ext.multi_round.v1` fixtures now replay with real assertions
+  (previously silently skipped); fixtures for unmapped modes fail loudly; and
+  reject-path fixtures are contract-checked (canonical `expected_error_code`,
+  resolvable `payload_type`) with explicit skip markers pointing at the
+  runtime conformance oracle for the NACK behavior itself.
+
 ## [0.5.0] - 2026-07-06
 
 Absorbs `macp-runtime` 0.5.0 and `@multiagentcoordinationprotocol/proto` 0.1.6

package/README.md

@@ -2,8 +2,14 @@
 
 TypeScript SDK for the [Multi-Agent Coordination Protocol (MACP)](https://github.com/multiagentcoordinationprotocol/multiagentcoordinationprotocol) runtime. Connects TypeScript/Node.js applications to the Rust MACP runtime over gRPC.
 
+SDK documentation lives in [`docs/`](docs/index.md) and covers the TypeScript API.
+Protocol semantics are normative in the [spec repo's docs and RFCs](https://github.com/multiagentcoordinationprotocol/multiagentcoordinationprotocol/tree/main/rfcs);
+runtime behavior is documented in the [runtime repo's docs](https://github.com/multiagentcoordinationprotocol/macp-runtime/blob/main/docs/getting-started.md).
+
 ## Install
 
+Requires Node.js >= 20.
+
 ```bash
 npm install macp-sdk-typescript
 ```
@@ -287,7 +293,7 @@ reference: [`docs/api/strategies.md`](docs/api/strategies.md).
 ### Cancel Callback
 
 Long-running agents can expose an HTTP endpoint that an orchestrator POSTs to
-in order to request a clean shutdown (RFC-MACP-0001 §7.2 Option A). Bootstrap
+in order to request a clean shutdown ([RFC-MACP-0001 (Core)](https://github.com/multiagentcoordinationprotocol/multiagentcoordinationprotocol/blob/main/rfcs/RFC-MACP-0001-core.md) §7.2 Option A). Bootstrap
 JSON with a `cancel_callback: { host, port, path }` block auto-wires the
 server via `fromBootstrap()`; for the manual path use
 `startCancelCallbackServer(...)` + `Participant.attachCancelCallbackServer(...)`.
@@ -323,7 +329,7 @@ await session.vote({
 
 ## TLS
 
-TLS is on by default (RFC-MACP-0006 §3). To connect to an insecure runtime
+TLS is on by default ([RFC-MACP-0006 (Transport Bindings)](https://github.com/multiagentcoordinationprotocol/multiagentcoordinationprotocol/blob/main/rfcs/RFC-MACP-0006-transport-bindings.md) §3). To connect to an insecure runtime
 during local development, you must opt out explicitly:
 
 ```typescript
@@ -405,10 +411,14 @@ npm run lint               # ESLint
 npm run format             # Prettier
 npm test                   # Run unit + conformance tests
 npm run test:watch         # Watch mode
-npm run test:coverage      # With coverage
-npm run test:integration   # Integration tests (requires Docker runtime)
+npm run test:coverage      # With coverage (CI enforces thresholds from vitest.config.ts)
+npm run test:integration   # Integration tests (requires Docker runtime; not run in CI)
 ```
 
+CI (GitHub Actions) runs type-check, lint, format check, the coverage-gated
+test suite, and the build on Node 20, 22, and 24 for every push and pull
+request, and posts a coverage summary comment on PRs.
+
 ### Integration Tests
 
 Run the full SDK against a live MACP runtime:

package/dist/index.d.ts

@@ -16,5 +16,6 @@ export * from './quorum';
 export * from './task';
 export * from './types';
 export * from './validation';
+export { VERSION } from './version';
 export * from './watchers';
 export * as agent from './agent';

package/dist/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.agent = exports.Auth = void 0;
+exports.agent = exports.VERSION = exports.Auth = void 0;
 // Auth: export only the public constructors and types. The helpers
 // `validateAuth`, `authSender`, `assertSenderMatchesIdentity`, and
 // `metadataFromAuth` are SDK-internal — importable from the `./auth`
@@ -61,5 +61,7 @@ __exportStar(require("./quorum"), exports);
 __exportStar(require("./task"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./validation"), exports);
+var version_1 = require("./version");
+Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });
 __exportStar(require("./watchers"), exports);
 exports.agent = __importStar(require("./agent"));

package/dist/version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The installed `macp-sdk-typescript` package version.
+ *
+ * Kept in sync with package.json by release-please (see the
+ * `x-release-please-version` annotation).
+ */
+export declare const VERSION = "0.6.0";

package/dist/version.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+/**
+ * The installed `macp-sdk-typescript` package version.
+ *
+ * Kept in sync with package.json by release-please (see the
+ * `x-release-please-version` annotation).
+ */
+exports.VERSION = '0.6.0'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "macp-sdk-typescript",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "TypeScript SDK for the MACP Rust runtime",
   "license": "Apache-2.0",
   "type": "commonjs",
@@ -39,7 +39,7 @@
     "prepublishOnly": "npm run check && npm run lint && npm run format:check && npm test && npm run build"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "keywords": [
     "macp",
@@ -55,7 +55,7 @@
   "dependencies": {
     "@grpc/grpc-js": "^1.14.3",
     "@grpc/proto-loader": "^0.8.0",
-    "@multiagentcoordinationprotocol/proto": "^0.1.6",
+    "@multiagentcoordinationprotocol/proto": "^0.1.8",
     "protobufjs": "^8.6.5"
   },
   "devDependencies": {