macp-sdk-typescript 0.4.0 → 0.5.0

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.0",
+  "version": "0.5.0",
   "description": "TypeScript SDK for the MACP Rust runtime",
   "license": "Apache-2.0",
   "type": "commonjs",
@@ -50,13 +50,13 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/multiagentcoordinationprotocol/typescript-sdk.git"
+    "url": "https://github.com/multiagentcoordinationprotocol/macp-sdk-typescript.git"
   },
   "dependencies": {
     "@grpc/grpc-js": "^1.14.3",
     "@grpc/proto-loader": "^0.8.0",
-    "@multiagentcoordinationprotocol/proto": "^0.1.3",
-    "protobufjs": "^8.0.0"
+    "@multiagentcoordinationprotocol/proto": "^0.1.6",
+    "protobufjs": "^8.6.5"
   },
   "devDependencies": {
     "@types/node": "^22.14.0",