macp-sdk-typescript 0.4.1 → 0.6.0

package/dist/task.d.ts

@@ -30,6 +30,7 @@ export declare class TaskSession {
             uri: string;
             name?: string;
         }[];
+        maxSuspendMs?: number;
         sender?: string;
     }): Promise<Ack>;
     requestTask(input: TaskRequestPayload & {

package/dist/task.js

@@ -40,6 +40,7 @@ class TaskSession {
             intent: input.intent,
             participants: input.participants,
             ttlMs: input.ttlMs,
+            maxSuspendMs: input.maxSuspendMs,
             modeVersion: this.modeVersion,
             configurationVersion: this.configurationVersion,
         });
@@ -47,6 +48,7 @@ class TaskSession {
             intent: input.intent,
             participants: input.participants,
             ttlMs: input.ttlMs,
+            maxSuspendMs: input.maxSuspendMs,
             contextId: input.contextId,
             extensions: input.extensions,
             roots: input.roots,

package/dist/types.d.ts

@@ -106,6 +106,15 @@ export interface SessionStartPayload {
     configurationVersion: string;
     policyVersion?: string;
     ttlMs: number;
+    /**
+     * Maximum cumulative suspended duration (ms) before a SUSPENDED session
+     * transitions to EXPIRED (RFC-MACP-0001 §7.5, proto ≥ 0.1.5). Bound at
+     * session start like {@link ttlMs}: `0` (or absent) selects the runtime's
+     * configured default (7 days). The runtime records the resolved cap so
+     * replay is deterministic. Negative values are rejected at SessionStart.
+     * Decoded as a string (int64) but accepted as `number` on input.
+     */
+    maxSuspendMs?: number | string;
     contextId?: string;
     extensions?: Record<string, Buffer>;
     roots?: Root[];
@@ -251,6 +260,15 @@ export interface HandoffAcceptPayload {
     handoffId: string;
     acceptedBy: string;
     reason?: string;
+    /**
+     * Runtime-emitted synthetic accepts ONLY (RFC-MACP-0010 §5.1): `true` on the
+     * accept the runtime produces when a handoff's `implicit_accept_timeout_ms`
+     * elapses (`message_id` = `implicit-accept:<handoff_id>`, proto ≥ 0.1.6).
+     * Read-only — clients MUST NOT submit an accept with `implicit = true`; the
+     * runtime rejects it. `HandoffSession.acceptHandoff` strips this field before
+     * encoding so a caller can never produce a rejected envelope.
+     */
+    implicit?: boolean;
 }
 export interface HandoffDeclinePayload {
     handoffId: string;

package/dist/validation.d.ts

@@ -6,12 +6,14 @@ export declare function validateSeverity(value: string): string;
 export declare function validateParticipantCount(count: number): void;
 export declare function validateSignalType(signalType: string, data?: Buffer | Uint8Array): void;
 export declare function validateTtlMs(ttlMs: number): void;
+export declare function validateMaxSuspendMs(maxSuspendMs: number): void;
 export declare function validateParticipants(participants: string[]): void;
 export declare function validateRequiredField(fieldName: string, value: string): void;
 export declare function validateSessionStart(input: {
     intent: string;
     participants: string[];
     ttlMs: number;
+    maxSuspendMs?: number;
     modeVersion: string;
     configurationVersion: string;
 }): void;

package/dist/validation.js

@@ -8,6 +8,7 @@ exports.validateSeverity = validateSeverity;
 exports.validateParticipantCount = validateParticipantCount;
 exports.validateSignalType = validateSignalType;
 exports.validateTtlMs = validateTtlMs;
+exports.validateMaxSuspendMs = validateMaxSuspendMs;
 exports.validateParticipants = validateParticipants;
 exports.validateRequiredField = validateRequiredField;
 exports.validateSessionStart = validateSessionStart;
@@ -65,6 +66,13 @@ function validateTtlMs(ttlMs) {
         throw new errors_1.MacpSessionError(`ttl_ms must be in [1, ${MAX_TTL_MS}], got ${ttlMs}`);
     }
 }
+function validateMaxSuspendMs(maxSuspendMs) {
+    // 0 = "use runtime default"; only negatives are rejected (matches the
+    // runtime, which rejects negative max_suspend_ms at SessionStart).
+    if (!Number.isFinite(maxSuspendMs) || maxSuspendMs < 0) {
+        throw new errors_1.MacpSessionError(`max_suspend_ms must be >= 0 (0 = runtime default), got ${maxSuspendMs}`);
+    }
+}
 function validateParticipants(participants) {
     if (!participants.length) {
         throw new errors_1.MacpSessionError('participants must be non-empty');
@@ -87,6 +95,8 @@ function validateSessionStart(input) {
     validateRequiredField('intent', input.intent);
     validateParticipants(input.participants);
     validateTtlMs(input.ttlMs);
+    if (input.maxSuspendMs !== undefined)
+        validateMaxSuspendMs(input.maxSuspendMs);
     validateRequiredField('modeVersion', input.modeVersion);
     validateRequiredField('configurationVersion', input.configurationVersion);
 }

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/dist/watchers.d.ts

@@ -1,5 +1,5 @@
 import type { AuthConfig } from './auth';
-import type { MacpClient } from './client';
+import { type MacpClient } from './client';
 import type { Envelope, PolicyDescriptor, RegistryChanged, RootsChanged, SessionLifecycleEvent, SessionLifecycleEventType } from './types';
 /**
  * The lifecycle event types after which a session emits no further events.
@@ -43,6 +43,16 @@ export declare class RootsWatcher {
     watch(handler: (change: RootsChanged) => void | Promise<void>): Promise<void>;
     nextChange(): Promise<RootsChanged>;
 }
+/**
+ * Watches the ambient signal plane. **Requires auth** as of runtime 0.5.0: if
+ * no credential is configured on the watcher or the client, iterating
+ * {@link SignalWatcher.signals} throws immediately (via `client.watchSignals`).
+ *
+ * Consumer lag terminates the stream with a coded `MacpTransportError`
+ * (`code === 'RESOURCE_EXHAUSTED'`); the correct response is to reconnect.
+ * A missing/invalid credential surfaces as `code === 'UNAUTHENTICATED'` — fix
+ * auth, do not reconnect.
+ */
 export declare class SignalWatcher {
     private readonly client;
     private readonly auth?;
@@ -67,26 +77,20 @@ export declare class PolicyWatcher {
     watch(handler: (change: PolicyChange) => void | Promise<void>): Promise<void>;
     nextChange(): Promise<PolicyChange>;
 }
+/**
+ * Watches session lifecycle events (`WatchSessions`). Consumer lag terminates
+ * the stream with a coded `MacpTransportError` (`code === 'RESOURCE_EXHAUSTED'`);
+ * the correct response is to reconnect and re-sync current state via
+ * {@link MacpClient.listSessions}, since events emitted during the gap are lost.
+ */
 export declare class SessionLifecycleWatcher {
     private readonly client;
     private readonly auth?;
-    private deprecatedEventsWarned;
-    private deprecatedNextEventWarned;
     constructor(client: MacpClient, options?: {
         auth?: AuthConfig;
     });
     changes(signal?: AbortSignal): AsyncGenerator<SessionLifecycleEvent, void, void>;
     watch(handler: (event: SessionLifecycleEvent) => void | Promise<void>): Promise<void>;
     nextChange(): Promise<SessionLifecycleEvent>;
-    /**
-     * @deprecated Use {@link changes} — renamed for parity with python-sdk's
-     * `SessionLifecycleWatcher.changes()` and the uniform `changes()` name
-     * used by all other watchers in both SDKs. Will be removed in 0.5.0.
-     */
-    events(signal?: AbortSignal): AsyncGenerator<SessionLifecycleEvent, void, void>;
-    /**
-     * @deprecated Use {@link nextChange}. Will be removed in 0.5.0.
-     */
-    nextEvent(): Promise<SessionLifecycleEvent>;
 }
 export {};

package/dist/watchers.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SessionLifecycleWatcher = exports.PolicyWatcher = exports.SignalWatcher = exports.RootsWatcher = exports.ModeRegistryWatcher = exports.isTerminalSessionLifecycleEvent = exports.isSessionResumed = exports.isSessionSuspended = exports.isSessionCancelled = exports.isSessionExpired = exports.isSessionResolved = exports.isSessionCreated = exports.TERMINAL_SESSION_LIFECYCLE_EVENT_TYPES = void 0;
-const logging_1 = require("./logging");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
 /**
  * The lifecycle event types after which a session emits no further events.
  * `EVENT_TYPE_CANCELLED` (proto 0.1.3) is terminal alongside `RESOLVED` and
@@ -48,7 +49,14 @@ function serverStreamToAsyncGenerator(stream) {
         }
     });
     stream.on('error', (error) => {
-        queue.push({ error });
+        // Wrap the raw gRPC ServiceError into a coded MacpTransportError so
+        // consumers can branch on `.code`: consumer lag terminates a watch stream
+        // with RESOURCE_EXHAUSTED (reconnect + re-sync), an unauthenticated
+        // WatchSignals with UNAUTHENTICATED (fix auth, do NOT reconnect).
+        const code = (0, client_1.grpcStatusName)(error.code);
+        const serviceErr = error;
+        const wrapped = new errors_1.MacpTransportError(serviceErr.details || error.message, code);
+        queue.push({ error: wrapped });
         if (resolve) {
             resolve();
             resolve = null;
@@ -148,6 +156,16 @@ class RootsWatcher {
     }
 }
 exports.RootsWatcher = RootsWatcher;
+/**
+ * Watches the ambient signal plane. **Requires auth** as of runtime 0.5.0: if
+ * no credential is configured on the watcher or the client, iterating
+ * {@link SignalWatcher.signals} throws immediately (via `client.watchSignals`).
+ *
+ * Consumer lag terminates the stream with a coded `MacpTransportError`
+ * (`code === 'RESOURCE_EXHAUSTED'`); the correct response is to reconnect.
+ * A missing/invalid credential surfaces as `code === 'UNAUTHENTICATED'` — fix
+ * auth, do not reconnect.
+ */
 class SignalWatcher {
     client;
     auth;
@@ -210,11 +228,15 @@ class PolicyWatcher {
     }
 }
 exports.PolicyWatcher = PolicyWatcher;
+/**
+ * Watches session lifecycle events (`WatchSessions`). Consumer lag terminates
+ * the stream with a coded `MacpTransportError` (`code === 'RESOURCE_EXHAUSTED'`);
+ * the correct response is to reconnect and re-sync current state via
+ * {@link MacpClient.listSessions}, since events emitted during the gap are lost.
+ */
 class SessionLifecycleWatcher {
     client;
     auth;
-    deprecatedEventsWarned = false;
-    deprecatedNextEventWarned = false;
     constructor(client, options) {
         this.client = client;
         this.auth = options?.auth;
@@ -243,27 +265,5 @@ class SessionLifecycleWatcher {
             throw new Error('stream ended before receiving a session lifecycle event');
         return result.value;
     }
-    /**
-     * @deprecated Use {@link changes} — renamed for parity with python-sdk's
-     * `SessionLifecycleWatcher.changes()` and the uniform `changes()` name
-     * used by all other watchers in both SDKs. Will be removed in 0.5.0.
-     */
-    async *events(signal) {
-        if (!this.deprecatedEventsWarned) {
-            this.deprecatedEventsWarned = true;
-            logging_1.logger.warn('[deprecated] SessionLifecycleWatcher.events() — use changes() instead');
-        }
-        yield* this.changes(signal);
-    }
-    /**
-     * @deprecated Use {@link nextChange}. Will be removed in 0.5.0.
-     */
-    async nextEvent() {
-        if (!this.deprecatedNextEventWarned) {
-            this.deprecatedNextEventWarned = true;
-            logging_1.logger.warn('[deprecated] SessionLifecycleWatcher.nextEvent() — use nextChange() instead');
-        }
-        return this.nextChange();
-    }
 }
 exports.SessionLifecycleWatcher = SessionLifecycleWatcher;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "macp-sdk-typescript",
-  "version": "0.4.1",
+  "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.3",
+    "@multiagentcoordinationprotocol/proto": "^0.1.8",
     "protobufjs": "^8.6.5"
   },
   "devDependencies": {