macp-sdk-typescript 0.7.0 → 0.8.0

package/dist/projections/handoff.js

@@ -2,14 +2,61 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HandoffProjection = void 0;
 const constants_1 = require("../constants");
+const logging_1 = require("../logging");
 class HandoffProjection {
     handoffs = new Map();
+    /**
+     * The session's accepted history, one envelope per unique `message_id`. See
+     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
     transcript = [];
+    /**
+     * Cardinality anomalies recorded while replaying this projection's accepted
+     * transcript. See `BaseProjection.anomalies` (`src/projections/base.ts`)
+     * for the canonical description; duplicated here only as a one-line
+     * pointer. No built-in detection populates this for Handoff mode.
+     */
+    anomalies = [];
     phase = 'Pending';
     commitment;
+    /**
+     * `message_id`s already applied to this projection. See
+     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
+    seenMessageIds = new Set();
+    /**
+     * Apply one envelope to this projection's in-process state.
+     *
+     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
+     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
+     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
+     * mode are documented once, on `BaseProjection.applyEnvelope`
+     * (`src/projections/base.ts`), and duplicated here only as a one-line
+     * pointer so six independent copies of the same prose cannot drift.
+     *
+     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
+     * non-event — not appended to `transcript`, not passed to the `switch`.
+     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
+     * citation; duplicated here only as a one-line pointer.
+     */
     applyEnvelope(envelope, protoRegistry) {
         if (envelope.mode !== constants_1.MODE_HANDOFF)
             return;
+        if (envelope.messageId) {
+            if (this.seenMessageIds.has(envelope.messageId)) {
+                logging_1.logger.debug('projection redelivery ignored', {
+                    messageId: envelope.messageId,
+                    mode: envelope.mode,
+                    messageType: envelope.messageType,
+                });
+                return;
+            }
+            this.seenMessageIds.add(envelope.messageId);
+        }
         this.transcript.push(envelope);
         const payload = protoRegistry.decodeKnownPayload(envelope.mode, envelope.messageType, envelope.payload);
         switch (envelope.messageType) {
@@ -74,6 +121,14 @@ class HandoffProjection {
                 break;
         }
     }
+    /**
+     * True once at least one `ProjectionAnomaly` has been recorded. See
+     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
+     * canonical description; duplicated here only as a one-line pointer.
+     */
+    get hasAnomalies() {
+        return this.anomalies.length > 0;
+    }
     get isCommitted() {
         return this.commitment !== undefined;
     }

package/dist/projections/proposal.d.ts

@@ -1,3 +1,4 @@
+import type { ProjectionAnomaly } from './base';
 import type { Envelope } from '../types';
 import type { ProtoRegistry } from '../proto-registry';
 export interface ProposalRecord {
@@ -24,10 +25,51 @@ export declare class ProposalProjection {
     readonly proposals: Map<string, ProposalRecord>;
     readonly accepts: ProposalAcceptRecord[];
     readonly rejections: ProposalRejectRecord[];
+    /**
+     * The session's accepted history, one envelope per unique `message_id`. See
+     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
     readonly transcript: Envelope[];
+    /**
+     * Cardinality anomalies recorded while replaying this projection's accepted
+     * transcript. See `BaseProjection.anomalies` (`src/projections/base.ts`)
+     * for the canonical description; duplicated here only as a one-line
+     * pointer. No built-in detection populates this for Proposal mode.
+     */
+    readonly anomalies: ProjectionAnomaly[];
     phase: 'Negotiating' | 'TerminalRejected' | 'Committed';
     commitment?: Record<string, unknown>;
+    /**
+     * `message_id`s already applied to this projection. See
+     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
+    private readonly seenMessageIds;
+    /**
+     * Apply one envelope to this projection's in-process state.
+     *
+     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
+     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
+     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
+     * mode are documented once, on `BaseProjection.applyEnvelope`
+     * (`src/projections/base.ts`), and duplicated here only as a one-line
+     * pointer so six independent copies of the same prose cannot drift.
+     *
+     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
+     * non-event — not appended to `transcript`, not passed to the `switch`.
+     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
+     * citation; duplicated here only as a one-line pointer.
+     */
     applyEnvelope(envelope: Envelope, protoRegistry: ProtoRegistry): void;
+    /**
+     * True once at least one `ProjectionAnomaly` has been recorded. See
+     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
+     * canonical description; duplicated here only as a one-line pointer.
+     */
+    get hasAnomalies(): boolean;
     get isCommitted(): boolean;
     get isPositiveOutcome(): boolean | undefined;
     activeProposals(): ProposalRecord[];

package/dist/projections/proposal.js

@@ -2,16 +2,63 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProposalProjection = void 0;
 const constants_1 = require("../constants");
+const logging_1 = require("../logging");
 class ProposalProjection {
     proposals = new Map();
     accepts = [];
     rejections = [];
+    /**
+     * The session's accepted history, one envelope per unique `message_id`. See
+     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
     transcript = [];
+    /**
+     * Cardinality anomalies recorded while replaying this projection's accepted
+     * transcript. See `BaseProjection.anomalies` (`src/projections/base.ts`)
+     * for the canonical description; duplicated here only as a one-line
+     * pointer. No built-in detection populates this for Proposal mode.
+     */
+    anomalies = [];
     phase = 'Negotiating';
     commitment;
+    /**
+     * `message_id`s already applied to this projection. See
+     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
+    seenMessageIds = new Set();
+    /**
+     * Apply one envelope to this projection's in-process state.
+     *
+     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
+     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
+     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
+     * mode are documented once, on `BaseProjection.applyEnvelope`
+     * (`src/projections/base.ts`), and duplicated here only as a one-line
+     * pointer so six independent copies of the same prose cannot drift.
+     *
+     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
+     * non-event — not appended to `transcript`, not passed to the `switch`.
+     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
+     * citation; duplicated here only as a one-line pointer.
+     */
     applyEnvelope(envelope, protoRegistry) {
         if (envelope.mode !== constants_1.MODE_PROPOSAL)
             return;
+        if (envelope.messageId) {
+            if (this.seenMessageIds.has(envelope.messageId)) {
+                logging_1.logger.debug('projection redelivery ignored', {
+                    messageId: envelope.messageId,
+                    mode: envelope.mode,
+                    messageType: envelope.messageType,
+                });
+                return;
+            }
+            this.seenMessageIds.add(envelope.messageId);
+        }
         this.transcript.push(envelope);
         const payload = protoRegistry.decodeKnownPayload(envelope.mode, envelope.messageType, envelope.payload);
         switch (envelope.messageType) {
@@ -77,6 +124,14 @@ class ProposalProjection {
                 break;
         }
     }
+    /**
+     * True once at least one `ProjectionAnomaly` has been recorded. See
+     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
+     * canonical description; duplicated here only as a one-line pointer.
+     */
+    get hasAnomalies() {
+        return this.anomalies.length > 0;
+    }
     get isCommitted() {
         return this.commitment !== undefined;
     }

package/dist/projections/quorum.d.ts

@@ -1,3 +1,4 @@
+import type { ProjectionAnomaly } from './base';
 import type { Envelope } from '../types';
 import type { ProtoRegistry } from '../proto-registry';
 export interface ApprovalRequestRecord {
@@ -16,10 +17,52 @@ export interface BallotRecord {
 export declare class QuorumProjection {
     readonly requests: Map<string, ApprovalRequestRecord>;
     readonly ballots: Map<string, Map<string, BallotRecord>>;
+    /**
+     * The session's accepted history, one envelope per unique `message_id`. See
+     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
     readonly transcript: Envelope[];
+    /**
+     * Cardinality anomalies recorded while replaying this projection's accepted
+     * transcript (e.g. a duplicate ballot across `Approve`/`Reject`/`Abstain`
+     * from the same sender for the same `request_id`). See
+     * `BaseProjection.anomalies` (`src/projections/base.ts`) for the canonical
+     * description; duplicated here only as a one-line pointer.
+     */
+    readonly anomalies: ProjectionAnomaly[];
     phase: 'Pending' | 'Voting' | 'Committed';
     commitment?: Record<string, unknown>;
+    /**
+     * `message_id`s already applied to this projection. See
+     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
+    private readonly seenMessageIds;
+    /**
+     * Apply one envelope to this projection's in-process state.
+     *
+     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
+     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
+     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
+     * mode are documented once, on `BaseProjection.applyEnvelope`
+     * (`src/projections/base.ts`), and duplicated here only as a one-line
+     * pointer so six independent copies of the same prose cannot drift.
+     *
+     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
+     * non-event — not appended to `transcript`, not passed to the `switch`.
+     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
+     * citation; duplicated here only as a one-line pointer.
+     */
     applyEnvelope(envelope: Envelope, protoRegistry: ProtoRegistry): void;
+    /**
+     * True once at least one `ProjectionAnomaly` has been recorded. See
+     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
+     * canonical description; duplicated here only as a one-line pointer.
+     */
+    get hasAnomalies(): boolean;
     get isCommitted(): boolean;
     get isPositiveOutcome(): boolean | undefined;
     private setBallot;

package/dist/projections/quorum.js

@@ -2,15 +2,63 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.QuorumProjection = void 0;
 const constants_1 = require("../constants");
+const logging_1 = require("../logging");
 class QuorumProjection {
     requests = new Map();
     ballots = new Map();
+    /**
+     * The session's accepted history, one envelope per unique `message_id`. See
+     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
     transcript = [];
+    /**
+     * Cardinality anomalies recorded while replaying this projection's accepted
+     * transcript (e.g. a duplicate ballot across `Approve`/`Reject`/`Abstain`
+     * from the same sender for the same `request_id`). See
+     * `BaseProjection.anomalies` (`src/projections/base.ts`) for the canonical
+     * description; duplicated here only as a one-line pointer.
+     */
+    anomalies = [];
     phase = 'Pending';
     commitment;
+    /**
+     * `message_id`s already applied to this projection. See
+     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
+    seenMessageIds = new Set();
+    /**
+     * Apply one envelope to this projection's in-process state.
+     *
+     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
+     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
+     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
+     * mode are documented once, on `BaseProjection.applyEnvelope`
+     * (`src/projections/base.ts`), and duplicated here only as a one-line
+     * pointer so six independent copies of the same prose cannot drift.
+     *
+     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
+     * non-event — not appended to `transcript`, not passed to the `switch`.
+     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
+     * citation; duplicated here only as a one-line pointer.
+     */
     applyEnvelope(envelope, protoRegistry) {
         if (envelope.mode !== constants_1.MODE_QUORUM)
             return;
+        if (envelope.messageId) {
+            if (this.seenMessageIds.has(envelope.messageId)) {
+                logging_1.logger.debug('projection redelivery ignored', {
+                    messageId: envelope.messageId,
+                    mode: envelope.mode,
+                    messageType: envelope.messageType,
+                });
+                return;
+            }
+            this.seenMessageIds.add(envelope.messageId);
+        }
         this.transcript.push(envelope);
         const payload = protoRegistry.decodeKnownPayload(envelope.mode, envelope.messageType, envelope.payload);
         switch (envelope.messageType) {
@@ -22,17 +70,17 @@ class QuorumProjection {
             }
             case 'Approve': {
                 const record = payload;
-                this.setBallot(record.requestId, envelope.sender, 'approve', record.reason);
+                this.setBallot(envelope, record.requestId, 'approve', record.reason);
                 break;
             }
             case 'Reject': {
                 const record = payload;
-                this.setBallot(record.requestId, envelope.sender, 'reject', record.reason);
+                this.setBallot(envelope, record.requestId, 'reject', record.reason);
                 break;
             }
             case 'Abstain': {
                 const record = payload;
-                this.setBallot(record.requestId, envelope.sender, 'abstain', record.reason);
+                this.setBallot(envelope, record.requestId, 'abstain', record.reason);
                 break;
             }
             case 'Commitment': {
@@ -44,6 +92,14 @@ class QuorumProjection {
                 break;
         }
     }
+    /**
+     * True once at least one `ProjectionAnomaly` has been recorded. See
+     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
+     * canonical description; duplicated here only as a one-line pointer.
+     */
+    get hasAnomalies() {
+        return this.anomalies.length > 0;
+    }
     get isCommitted() {
         return this.commitment !== undefined;
     }
@@ -54,9 +110,39 @@ class QuorumProjection {
             this.commitment.outcome_positive;
         return val !== undefined ? Boolean(val) : true;
     }
-    setBallot(requestId, sender, vote, reason) {
+    setBallot(envelope, requestId, vote, reason) {
         const senderMap = this.ballots.get(requestId) ?? new Map();
-        senderMap.set(sender, { requestId, vote, reason, sender });
+        const kept = senderMap.get(envelope.sender);
+        if (kept !== undefined) {
+            // RFC-MACP-0011 §5 rule 3 (`:67`): participation is MAY (a participant need
+            // not cast a ballot), but the cap of one ballot per participant ACROSS
+            // Approve, Reject, and Abstain is enforced under §5's opening sentence,
+            // "Implementations MUST enforce the following:" (`:63`). Do NOT phrase this
+            // as "a participant MUST cast at most one ballot" — RFC-0011 puts the MUST
+            // on the implementation, not the participant (contrast RFC-MACP-0007 §5.3,
+            // which puts it directly on the participant; same obligation, different
+            // addressee). A later ballot of a *different* type is still a duplicate,
+            // not a change of vote, so this guard is keyed on the sender ALONE within
+            // the request — never on sender + vote. macp-runtime enforces this
+            // identically in all three arms (quorum.rs:164/184/204).
+            // Keeping the sender's FIRST ballot (rather than the last) is not stated
+            // by RFC-0011 either; it is parity with RFC-MACP-0007 §5 item 3's
+            // explicit first-stands rule for `Vote`, plus macp-runtime's enforced
+            // first-wins behaviour.
+            const anomaly = {
+                kind: 'duplicate_ballot',
+                mode: envelope.mode,
+                messageType: envelope.messageType,
+                messageId: envelope.messageId,
+                sender: envelope.sender,
+                subjectId: requestId,
+                detail: `sender ${envelope.sender} already cast '${kept.vote}' on request ${requestId}; discarded '${vote}'`,
+            };
+            this.anomalies.push(anomaly);
+            logging_1.logger.warn('projection anomaly', anomaly);
+            return;
+        }
+        senderMap.set(envelope.sender, { requestId, vote, reason, sender: envelope.sender });
         this.ballots.set(requestId, senderMap);
     }
     approvalCount(requestId) {

package/dist/projections/task.d.ts

@@ -1,3 +1,4 @@
+import type { ProjectionAnomaly } from './base';
 import type { Envelope } from '../types';
 import type { ProtoRegistry } from '../proto-registry';
 export interface TaskRecord {
@@ -37,10 +38,51 @@ export declare class TaskProjection {
     readonly updates: TaskUpdateRecord[];
     readonly completions: TaskCompletionRecord[];
     readonly failures: TaskFailureRecord[];
+    /**
+     * The session's accepted history, one envelope per unique `message_id`. See
+     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
     readonly transcript: Envelope[];
+    /**
+     * Cardinality anomalies recorded while replaying this projection's accepted
+     * transcript. See `BaseProjection.anomalies` (`src/projections/base.ts`)
+     * for the canonical description; duplicated here only as a one-line
+     * pointer. No built-in detection populates this for Task mode.
+     */
+    readonly anomalies: ProjectionAnomaly[];
     phase: 'Pending' | 'Requested' | 'InProgress' | 'Completed' | 'Failed' | 'Committed';
     commitment?: Record<string, unknown>;
+    /**
+     * `message_id`s already applied to this projection. See
+     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
+    private readonly seenMessageIds;
+    /**
+     * Apply one envelope to this projection's in-process state.
+     *
+     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
+     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
+     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
+     * mode are documented once, on `BaseProjection.applyEnvelope`
+     * (`src/projections/base.ts`), and duplicated here only as a one-line
+     * pointer so six independent copies of the same prose cannot drift.
+     *
+     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
+     * non-event — not appended to `transcript`, not passed to the `switch`.
+     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
+     * citation; duplicated here only as a one-line pointer.
+     */
     applyEnvelope(envelope: Envelope, protoRegistry: ProtoRegistry): void;
+    /**
+     * True once at least one `ProjectionAnomaly` has been recorded. See
+     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
+     * canonical description; duplicated here only as a one-line pointer.
+     */
+    get hasAnomalies(): boolean;
     get isCommitted(): boolean;
     get isPositiveOutcome(): boolean | undefined;
     getTask(taskId: string): TaskRecord | undefined;

package/dist/projections/task.js

@@ -2,17 +2,64 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskProjection = void 0;
 const constants_1 = require("../constants");
+const logging_1 = require("../logging");
 class TaskProjection {
     tasks = new Map();
     updates = [];
     completions = [];
     failures = [];
+    /**
+     * The session's accepted history, one envelope per unique `message_id`. See
+     * `BaseProjection.transcript` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence contract (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
     transcript = [];
+    /**
+     * Cardinality anomalies recorded while replaying this projection's accepted
+     * transcript. See `BaseProjection.anomalies` (`src/projections/base.ts`)
+     * for the canonical description; duplicated here only as a one-line
+     * pointer. No built-in detection populates this for Task mode.
+     */
+    anomalies = [];
     phase = 'Pending';
     commitment;
+    /**
+     * `message_id`s already applied to this projection. See
+     * `BaseProjection.seenMessageIds` (`src/projections/base.ts`) for the full
+     * redelivery-idempotence rationale (RFC-MACP-0006 §3.2); duplicated here
+     * only as a one-line pointer.
+     */
+    seenMessageIds = new Set();
+    /**
+     * Apply one envelope to this projection's in-process state.
+     *
+     * Input contract: **accepted-only**, caller-maintained (`Envelope` carries
+     * no acceptance marker). Canonical source: `schemas/conformance/README.md`
+     * "Notes:", RFC-MACP-0007 §5.3, RFC-MACP-0011 §5. Full rationale and failure
+     * mode are documented once, on `BaseProjection.applyEnvelope`
+     * (`src/projections/base.ts`), and duplicated here only as a one-line
+     * pointer so six independent copies of the same prose cannot drift.
+     *
+     * Redelivery idempotence: a redelivered envelope (same `message_id`) is a
+     * non-event — not appended to `transcript`, not passed to the `switch`.
+     * See `BaseProjection.applyEnvelope` for the full RFC-MACP-0006 §3.2
+     * citation; duplicated here only as a one-line pointer.
+     */
     applyEnvelope(envelope, protoRegistry) {
         if (envelope.mode !== constants_1.MODE_TASK)
             return;
+        if (envelope.messageId) {
+            if (this.seenMessageIds.has(envelope.messageId)) {
+                logging_1.logger.debug('projection redelivery ignored', {
+                    messageId: envelope.messageId,
+                    mode: envelope.mode,
+                    messageType: envelope.messageType,
+                });
+                return;
+            }
+            this.seenMessageIds.add(envelope.messageId);
+        }
         this.transcript.push(envelope);
         const payload = protoRegistry.decodeKnownPayload(envelope.mode, envelope.messageType, envelope.payload);
         switch (envelope.messageType) {
@@ -87,6 +134,14 @@ class TaskProjection {
                 break;
         }
     }
+    /**
+     * True once at least one `ProjectionAnomaly` has been recorded. See
+     * `BaseProjection.hasAnomalies` (`src/projections/base.ts`) for the
+     * canonical description; duplicated here only as a one-line pointer.
+     */
+    get hasAnomalies() {
+        return this.anomalies.length > 0;
+    }
     get isCommitted() {
         return this.commitment !== undefined;
     }

package/dist/proposal.js

@@ -16,7 +16,7 @@ class ProposalSession {
     projection = new proposal_1.ProposalProjection();
     constructor(client, options = {}) {
         this.client = client;
-        if (options.sessionId)
+        if (options.sessionId !== undefined)
             (0, validation_1.validateSessionId)(options.sessionId);
         this.sessionId = options.sessionId ?? (0, envelope_1.newSessionId)();
         this.modeVersion = options.modeVersion ?? constants_1.DEFAULT_MODE_VERSION;

package/dist/quorum.js

@@ -16,7 +16,7 @@ class QuorumSession {
     projection = new quorum_1.QuorumProjection();
     constructor(client, options = {}) {
         this.client = client;
-        if (options.sessionId)
+        if (options.sessionId !== undefined)
             (0, validation_1.validateSessionId)(options.sessionId);
         this.sessionId = options.sessionId ?? (0, envelope_1.newSessionId)();
         this.modeVersion = options.modeVersion ?? constants_1.DEFAULT_MODE_VERSION;

package/dist/task.js

@@ -16,7 +16,7 @@ class TaskSession {
     projection = new task_1.TaskProjection();
     constructor(client, options = {}) {
         this.client = client;
-        if (options.sessionId)
+        if (options.sessionId !== undefined)
             (0, validation_1.validateSessionId)(options.sessionId);
         this.sessionId = options.sessionId ?? (0, envelope_1.newSessionId)();
         this.modeVersion = options.modeVersion ?? constants_1.DEFAULT_MODE_VERSION;

package/dist/version.d.ts

@@ -4,4 +4,4 @@
  * Kept in sync with package.json by release-please (see the
  * `x-release-please-version` annotation).
  */
-export declare const VERSION = "0.7.0";
+export declare const VERSION = "0.8.0";

package/dist/version.js

@@ -7,4 +7,4 @@ exports.VERSION = void 0;
  * Kept in sync with package.json by release-please (see the
  * `x-release-please-version` annotation).
  */
-exports.VERSION = '0.7.0'; // x-release-please-version
+exports.VERSION = '0.8.0'; // x-release-please-version

package/dist/watchers.js

@@ -96,6 +96,14 @@ function serverStreamToAsyncGenerator(stream) {
             stream.cancel();
             throw err;
         },
+        // Required since TypeScript 6 / @types/node 26, which make `AsyncGenerator`
+        // extend `AsyncDisposable` (lib.esnext.disposable). Native `async function*`
+        // generators get this for free; this hand-rolled one has to declare it. It
+        // also makes every watcher stream usable with `await using`, which cancels
+        // the underlying gRPC stream on scope exit exactly like `return()` does.
+        async [Symbol.asyncDispose]() {
+            stream.cancel();
+        },
     };
 }
 class ModeRegistryWatcher {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "macp-sdk-typescript",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "TypeScript SDK for the MACP Rust runtime",
   "license": "Apache-2.0",
   "type": "commonjs",
@@ -55,18 +55,18 @@
   "dependencies": {
     "@grpc/grpc-js": "^1.14.3",
     "@grpc/proto-loader": "^0.8.0",
-    "@multiagentcoordinationprotocol/proto": "^0.1.8",
+    "@multiagentcoordinationprotocol/proto": "^0.1.9",
     "protobufjs": "^8.6.5"
   },
   "devDependencies": {
-    "@types/node": "^22.14.0",
-    "@typescript-eslint/eslint-plugin": "^8.0.0",
-    "@typescript-eslint/parser": "^8.0.0",
-    "@vitest/coverage-v8": "^3.0.0",
-    "eslint": "^9.0.0",
+    "@types/node": "^26.4.0",
+    "@typescript-eslint/eslint-plugin": "^8.68.0",
+    "@typescript-eslint/parser": "^8.68.0",
+    "@vitest/coverage-v8": "^4.1.11",
+    "eslint": "^10.9.1",
     "prettier": "^3.0.0",
     "tsx": "^4.21.0",
-    "typescript": "^5.8.3",
-    "vitest": "^3.0.0"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11"
   }
 }