@methodts/runtime 0.1.0

package/dist/cost-governor/signature-builder.test.js

@@ -0,0 +1,58 @@
+// SPDX-License-Identifier: Apache-2.0
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { buildSignature, inputSizeBucket, signatureKey } from './signature-builder.js';
+describe('inputSizeBucket', () => {
+    it('xs for < 1000 chars', () => assert.equal(inputSizeBucket(500), 'xs'));
+    it('s for < 10000 chars', () => assert.equal(inputSizeBucket(5000), 's'));
+    it('m for < 100000 chars', () => assert.equal(inputSizeBucket(50000), 'm'));
+    it('l for < 1000000 chars', () => assert.equal(inputSizeBucket(500000), 'l'));
+    it('xl for >= 1000000 chars', () => assert.equal(inputSizeBucket(1500000), 'xl'));
+    it('boundary: exactly 1000 is s', () => assert.equal(inputSizeBucket(1000), 's'));
+    it('boundary: exactly 0 is xs', () => assert.equal(inputSizeBucket(0), 'xs'));
+});
+describe('buildSignature', () => {
+    it('produces deterministic output', () => {
+        const a = buildSignature({
+            methodologyId: 'P2-SD',
+            capabilities: ['write', 'read', 'analyze'],
+            model: 'claude-opus-4-6',
+            promptCharCount: 5000,
+        });
+        const b = buildSignature({
+            methodologyId: 'P2-SD',
+            capabilities: ['analyze', 'read', 'write'], // different order
+            model: 'claude-opus-4-6',
+            promptCharCount: 5000,
+        });
+        // Capabilities should be sorted
+        assert.deepEqual(a.capabilities, ['analyze', 'read', 'write']);
+        assert.deepEqual(a, b);
+    });
+    it('maps promptCharCount to correct bucket', () => {
+        const sig = buildSignature({
+            methodologyId: 'test',
+            capabilities: [],
+            model: 'test-model',
+            promptCharCount: 150_000,
+        });
+        assert.equal(sig.inputSizeBucket, 'l');
+    });
+});
+describe('signatureKey', () => {
+    it('produces stable key', () => {
+        const sig = buildSignature({
+            methodologyId: 'P2-SD',
+            capabilities: ['b', 'a'],
+            model: 'opus',
+            promptCharCount: 100,
+        });
+        assert.equal(signatureKey(sig), 'P2-SD|a,b|opus|xs');
+    });
+    it('different signatures produce different keys', () => {
+        const a = buildSignature({ methodologyId: 'A', capabilities: [], model: 'x', promptCharCount: 0 });
+        const b = buildSignature({ methodologyId: 'B', capabilities: [], model: 'x', promptCharCount: 0 });
+        assert.notEqual(signatureKey(a), signatureKey(b));
+    });
+});
+//# sourceMappingURL=signature-builder.test.js.map

package/dist/cost-governor/signature-builder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature-builder.test.js","sourceRoot":"","sources":["../../src/cost-governor/signature-builder.test.ts"],"names":[],"mappings":"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"}

package/dist/cost-governor/token-bucket.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Token Bucket — monotonic-clock-based rate limiter.
+ *
+ * Supports a 5h burst window + weekly cap + concurrency cap.
+ * Uses process.hrtime.bigint() for elapsed-time math to avoid
+ * wall-clock drift from system sleep.
+ */
+export interface TokenBucketConfig {
+    /** Max messages in the burst window. */
+    burstCapacity: number;
+    /** Burst window duration in ms (default: 5h = 18_000_000). */
+    burstWindowMs?: number;
+    /** Max messages per week (0 = unlimited). */
+    weeklyCap?: number;
+    /** Max concurrent in-flight slots. */
+    concurrentCap: number;
+}
+export declare class TokenBucket {
+    private burstConsumed;
+    private weeklyConsumed;
+    private inFlight;
+    private lastRefillNs;
+    private weekStartMs;
+    readonly burstCapacity: number;
+    readonly burstWindowMs: number;
+    readonly weeklyCap: number;
+    readonly concurrentCap: number;
+    /** Messages per nanosecond refill rate. */
+    private readonly refillRatePerNs;
+    constructor(config: TokenBucketConfig);
+    /** Refill burst tokens based on elapsed monotonic time. */
+    refill(): void;
+    /** Try to consume one slot. Returns true if allowed. */
+    tryConsume(): boolean;
+    /** Release one in-flight slot. */
+    release(): void;
+    /** Current available burst tokens (after refill). */
+    available(): number;
+    /** Snapshot for persistence / debugging. */
+    snapshot(): TokenBucketSnapshot;
+    /** Restore from a persisted snapshot, clamping by elapsed time. */
+    restore(snap: TokenBucketSnapshot): void;
+    /** Utilization percentages. */
+    utilization(): {
+        burstPct: number;
+        weeklyPct: number;
+        inFlight: number;
+    };
+}
+export interface TokenBucketSnapshot {
+    burstConsumed: number;
+    weeklyConsumed: number;
+    inFlight: number;
+    weekStartMs: number;
+    lastRefillEpochMs: number;
+}
+//# sourceMappingURL=token-bucket.d.ts.map

package/dist/cost-governor/token-bucket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket.d.ts","sourceRoot":"","sources":["../../src/cost-governor/token-bucket.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAS;IAE5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,MAAM,EAAE,iBAAiB;IAYrC,2DAA2D;IAC3D,MAAM,IAAI,IAAI;IA4Bd,wDAAwD;IACxD,UAAU,IAAI,OAAO;IAarB,kCAAkC;IAClC,OAAO,IAAI,IAAI;IAIf,qDAAqD;IACrD,SAAS,IAAI,MAAM;IAKnB,4CAA4C;IAC5C,QAAQ,IAAI,mBAAmB;IAU/B,mEAAmE;IACnE,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAYxC,+BAA+B;IAC/B,WAAW,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;CAYzE;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B"}

package/dist/cost-governor/token-bucket.js

@@ -0,0 +1,109 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Token Bucket — monotonic-clock-based rate limiter.
+ *
+ * Supports a 5h burst window + weekly cap + concurrency cap.
+ * Uses process.hrtime.bigint() for elapsed-time math to avoid
+ * wall-clock drift from system sleep.
+ */
+export class TokenBucket {
+    burstConsumed = 0;
+    weeklyConsumed = 0;
+    inFlight = 0;
+    lastRefillNs;
+    weekStartMs;
+    burstCapacity;
+    burstWindowMs;
+    weeklyCap;
+    concurrentCap;
+    /** Messages per nanosecond refill rate. */
+    refillRatePerNs;
+    constructor(config) {
+        this.burstCapacity = config.burstCapacity;
+        this.burstWindowMs = config.burstWindowMs ?? 18_000_000; // 5h
+        this.weeklyCap = config.weeklyCap ?? 0;
+        this.concurrentCap = config.concurrentCap;
+        this.refillRatePerNs =
+            this.burstCapacity / (this.burstWindowMs * 1_000_000);
+        this.lastRefillNs = process.hrtime.bigint();
+        this.weekStartMs = Date.now();
+    }
+    /** Refill burst tokens based on elapsed monotonic time. */
+    refill() {
+        const now = process.hrtime.bigint();
+        const elapsedNs = now - this.lastRefillNs;
+        // Resume-from-sleep detection: elapsed > 5min → conservative 50% reset
+        const elapsedMs = Number(elapsedNs) / 1_000_000;
+        if (elapsedMs > 300_000) {
+            this.burstConsumed = Math.floor(this.burstCapacity * 0.5);
+            this.lastRefillNs = now;
+            return;
+        }
+        const refilled = Math.min(Number(elapsedNs) * this.refillRatePerNs, this.burstConsumed);
+        this.burstConsumed = Math.max(0, this.burstConsumed - Math.floor(refilled));
+        this.lastRefillNs = now;
+        // Weekly reset check (wall clock — only for week boundary)
+        const weekElapsedMs = Date.now() - this.weekStartMs;
+        if (weekElapsedMs >= 7 * 24 * 60 * 60 * 1000) {
+            this.weeklyConsumed = 0;
+            this.weekStartMs = Date.now();
+        }
+    }
+    /** Try to consume one slot. Returns true if allowed. */
+    tryConsume() {
+        this.refill();
+        if (this.inFlight >= this.concurrentCap)
+            return false;
+        if (this.burstConsumed >= this.burstCapacity)
+            return false;
+        if (this.weeklyCap > 0 && this.weeklyConsumed >= this.weeklyCap)
+            return false;
+        this.burstConsumed++;
+        this.weeklyConsumed++;
+        this.inFlight++;
+        return true;
+    }
+    /** Release one in-flight slot. */
+    release() {
+        this.inFlight = Math.max(0, this.inFlight - 1);
+    }
+    /** Current available burst tokens (after refill). */
+    available() {
+        this.refill();
+        return Math.max(0, this.burstCapacity - this.burstConsumed);
+    }
+    /** Snapshot for persistence / debugging. */
+    snapshot() {
+        return {
+            burstConsumed: this.burstConsumed,
+            weeklyConsumed: this.weeklyConsumed,
+            inFlight: this.inFlight,
+            weekStartMs: this.weekStartMs,
+            lastRefillEpochMs: Date.now(),
+        };
+    }
+    /** Restore from a persisted snapshot, clamping by elapsed time. */
+    restore(snap) {
+        const elapsedMs = Date.now() - snap.lastRefillEpochMs;
+        const refilled = Math.floor((elapsedMs * 1_000_000) * this.refillRatePerNs);
+        this.burstConsumed = Math.max(0, snap.burstConsumed - refilled);
+        this.weeklyConsumed = snap.weeklyConsumed;
+        this.weekStartMs = snap.weekStartMs;
+        this.inFlight = 0; // In-flight slots lost on restart
+        this.lastRefillNs = process.hrtime.bigint();
+    }
+    /** Utilization percentages. */
+    utilization() {
+        this.refill();
+        return {
+            burstPct: this.burstCapacity > 0
+                ? (this.burstConsumed / this.burstCapacity) * 100
+                : 0,
+            weeklyPct: this.weeklyCap > 0
+                ? (this.weeklyConsumed / this.weeklyCap) * 100
+                : 0,
+            inFlight: this.inFlight,
+        };
+    }
+}
+//# sourceMappingURL=token-bucket.js.map

package/dist/cost-governor/token-bucket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket.js","sourceRoot":"","sources":["../../src/cost-governor/token-bucket.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;GAMG;AAaH,MAAM,OAAO,WAAW;IACd,aAAa,GAAG,CAAC,CAAC;IAClB,cAAc,GAAG,CAAC,CAAC;IACnB,QAAQ,GAAG,CAAC,CAAC;IACb,YAAY,CAAS;IACrB,WAAW,CAAS;IAEnB,aAAa,CAAS;IACtB,aAAa,CAAS;IACtB,SAAS,CAAS;IAClB,aAAa,CAAS;IAE/B,2CAA2C;IAC1B,eAAe,CAAS;IAEzC,YAAY,MAAyB;QACnC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,UAAU,CAAC,CAAC,KAAK;QAC9D,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAE1C,IAAI,CAAC,eAAe;YAClB,IAAI,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,2DAA2D;IAC3D,MAAM;QACJ,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC;QAE1C,uEAAuE;QACvE,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;QAChD,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;YAC1D,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;YACxB,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACvB,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,eAAe,EACxC,IAAI,CAAC,aAAa,CACnB,CAAC;QAEF,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;QAExB,2DAA2D;QAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QACpD,IAAI,aAAa,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;YACxB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,UAAU;QACR,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,KAAK,CAAC;QACtD,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,KAAK,CAAC;QAC3D,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAE9E,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,OAAO;QACL,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,qDAAqD;IACrD,SAAS;QACP,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9D,CAAC;IAED,4CAA4C;IAC5C,QAAQ;QACN,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,iBAAiB,EAAE,IAAI,CAAC,GAAG,EAAE;SAC9B,CAAC;IACJ,CAAC;IAED,mEAAmE;IACnE,OAAO,CAAC,IAAyB;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,eAAe,CAC/C,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC,CAAC;QAChE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,kCAAkC;QACrD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED,+BAA+B;IAC/B,WAAW;QACT,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,aAAa,GAAG,CAAC;gBAC9B,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,GAAG;gBACjD,CAAC,CAAC,CAAC;YACL,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,CAAC;gBAC3B,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,GAAG;gBAC9C,CAAC,CAAC,CAAC;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/cost-governor/token-bucket.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=token-bucket.test.d.ts.map

package/dist/cost-governor/token-bucket.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket.test.d.ts","sourceRoot":"","sources":["../../src/cost-governor/token-bucket.test.ts"],"names":[],"mappings":""}

package/dist/cost-governor/token-bucket.test.js

@@ -0,0 +1,67 @@
+// SPDX-License-Identifier: Apache-2.0
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { TokenBucket } from './token-bucket.js';
+describe('TokenBucket', () => {
+    it('allows consumption up to burst capacity', () => {
+        const bucket = new TokenBucket({ burstCapacity: 3, concurrentCap: 10 });
+        assert.ok(bucket.tryConsume());
+        assert.ok(bucket.tryConsume());
+        assert.ok(bucket.tryConsume());
+        assert.ok(!bucket.tryConsume()); // exhausted
+    });
+    it('enforces concurrent cap', () => {
+        const bucket = new TokenBucket({ burstCapacity: 100, concurrentCap: 2 });
+        assert.ok(bucket.tryConsume());
+        assert.ok(bucket.tryConsume());
+        assert.ok(!bucket.tryConsume()); // concurrent cap hit
+        bucket.release();
+        assert.ok(bucket.tryConsume()); // now we have room
+    });
+    it('available never goes negative', () => {
+        const bucket = new TokenBucket({ burstCapacity: 2, concurrentCap: 10 });
+        bucket.tryConsume();
+        bucket.tryConsume();
+        bucket.tryConsume(); // fails but shouldn't break
+        assert.ok(bucket.available() >= 0);
+    });
+    it('release does not underflow inFlight', () => {
+        const bucket = new TokenBucket({ burstCapacity: 10, concurrentCap: 10 });
+        bucket.release(); // release without consume
+        bucket.release();
+        // Should not crash or go negative
+        const snap = bucket.snapshot();
+        assert.equal(snap.inFlight, 0);
+    });
+    it('snapshot and restore round-trip', () => {
+        const bucket = new TokenBucket({ burstCapacity: 100, concurrentCap: 10 });
+        bucket.tryConsume();
+        bucket.tryConsume();
+        const snap = bucket.snapshot();
+        const bucket2 = new TokenBucket({ burstCapacity: 100, concurrentCap: 10 });
+        bucket2.restore(snap);
+        // inFlight is always 0 after restore (in-flight lost on restart)
+        assert.equal(bucket2.snapshot().inFlight, 0);
+        // burstConsumed should be approximately restored (minus refill for elapsed)
+        assert.ok(bucket2.snapshot().burstConsumed <= 2);
+    });
+    it('utilization reports percentages', () => {
+        const bucket = new TokenBucket({ burstCapacity: 10, concurrentCap: 5, weeklyCap: 100 });
+        bucket.tryConsume();
+        const util = bucket.utilization();
+        assert.equal(util.burstPct, 10);
+        assert.equal(util.weeklyPct, 1);
+        assert.equal(util.inFlight, 1);
+    });
+    it('weekly cap enforcement', () => {
+        const bucket = new TokenBucket({ burstCapacity: 1000, concurrentCap: 1000, weeklyCap: 3 });
+        assert.ok(bucket.tryConsume());
+        bucket.release();
+        assert.ok(bucket.tryConsume());
+        bucket.release();
+        assert.ok(bucket.tryConsume());
+        bucket.release();
+        assert.ok(!bucket.tryConsume()); // weekly cap hit
+    });
+});
+//# sourceMappingURL=token-bucket.test.js.map

package/dist/cost-governor/token-bucket.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket.test.js","sourceRoot":"","sources":["../../src/cost-governor/token-bucket.test.ts"],"names":[],"mappings":"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"}

package/dist/dlq/cortex-dlq-observer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CortexDlqObserver — external DLQ emission path for PactDeadLetterEvent.
+ *
+ * PRD-062 / S5 §2.4 + §7. Coordinates single-emit (gate G-DLQ-SINGLE-EMIT)
+ * with the `CortexJobBackedExecutor` so that each sessionId emits at most
+ * ONE `PactDeadLetterEvent` across the union of inline + external paths.
+ */
+import type { PactDeadLetterEvent } from '@methodts/pacta';
+import type { ContinuationEnvelope } from '../ports/continuation-envelope.js';
+import type { DlqObserver, DlqRecord } from '../ports/dlq-observer.js';
+import type { CortexJobBackedExecutor } from '../executors/cortex-job-backed-executor.js';
+export interface CortexDlqObserverOptions {
+    executor: CortexJobBackedExecutor;
+    emitAgentEvent?: (event: PactDeadLetterEvent) => void;
+}
+export declare class CortexDlqObserver implements DlqObserver {
+    private readonly executor;
+    private readonly emit?;
+    constructor(options: CortexDlqObserverOptions);
+    onDeadLetter(envelope: ContinuationEnvelope, record: DlqRecord): Promise<PactDeadLetterEvent | null>;
+}
+//# sourceMappingURL=cortex-dlq-observer.d.ts.map

package/dist/dlq/cortex-dlq-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cortex-dlq-observer.d.ts","sourceRoot":"","sources":["../../src/dlq/cortex-dlq-observer.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACV,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAE1F,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACvD;AAED,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAuC;gBAEjD,OAAO,EAAE,wBAAwB;IAKvC,YAAY,CAChB,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;CAevC"}

package/dist/dlq/cortex-dlq-observer.js

@@ -0,0 +1,29 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * CortexDlqObserver — external DLQ emission path for PactDeadLetterEvent.
+ *
+ * PRD-062 / S5 §2.4 + §7. Coordinates single-emit (gate G-DLQ-SINGLE-EMIT)
+ * with the `CortexJobBackedExecutor` so that each sessionId emits at most
+ * ONE `PactDeadLetterEvent` across the union of inline + external paths.
+ */
+export class CortexDlqObserver {
+    executor;
+    emit;
+    constructor(options) {
+        this.executor = options.executor;
+        this.emit = options.emitAgentEvent;
+    }
+    async onDeadLetter(envelope, record) {
+        if (await this.executor.isDlqEmitted(envelope.sessionId)) {
+            return null;
+        }
+        // Delegate to the executor so the emission + finalization path stays
+        // centralised. The executor persists the DLQ-emitted flag, so
+        // subsequent calls for the same sessionId return null.
+        const event = await this.executor.emitInlineDeadLetter(envelope, record.lastError, record.attempts);
+        if (event && this.emit)
+            this.emit(event);
+        return event;
+    }
+}
+//# sourceMappingURL=cortex-dlq-observer.js.map

package/dist/dlq/cortex-dlq-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cortex-dlq-observer.js","sourceRoot":"","sources":["../../src/dlq/cortex-dlq-observer.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;GAMG;AAeH,MAAM,OAAO,iBAAiB;IACX,QAAQ,CAA0B;IAClC,IAAI,CAAwC;IAE7D,YAAY,OAAiC;QAC3C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,QAA8B,EAC9B,MAAiB;QAEjB,IAAI,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,qEAAqE;QACrE,8DAA8D;QAC9D,uDAAuD;QACvD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CACpD,QAAQ,EACR,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,QAAQ,CAChB,CAAC;QACF,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/dlq/dlq-observer.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * G-DLQ-SINGLE-EMIT — PRD-062 / S5 §7.
+ *
+ * Both inline (from the handler) and external (from CortexDlqObserver)
+ * DLQ paths must produce at most ONE `PactDeadLetterEvent` per sessionId.
+ */
+export {};
+//# sourceMappingURL=dlq-observer.test.d.ts.map

package/dist/dlq/dlq-observer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq-observer.test.d.ts","sourceRoot":"","sources":["../../src/dlq/dlq-observer.test.ts"],"names":[],"mappings":"AACA;;;;;GAKG"}

package/dist/dlq/dlq-observer.test.js

@@ -0,0 +1,103 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * G-DLQ-SINGLE-EMIT — PRD-062 / S5 §7.
+ *
+ * Both inline (from the handler) and external (from CortexDlqObserver)
+ * DLQ paths must produce at most ONE `PactDeadLetterEvent` per sessionId.
+ */
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { CortexJobBackedExecutor } from '../executors/cortex-job-backed-executor.js';
+import { CortexDlqObserver } from './cortex-dlq-observer.js';
+import { makeInMemorySessionStore, sampleEnvelope } from '../__fixtures__/executor-fixtures.js';
+describe('G-DLQ-SINGLE-EMIT — only one PactDeadLetterEvent per sessionId', () => {
+    let events;
+    let executor;
+    let observer;
+    let envelope;
+    beforeEach(async () => {
+        events = [];
+        const store = makeInMemorySessionStore();
+        envelope = sampleEnvelope();
+        await store.create({
+            schemaVersion: 1,
+            sessionId: envelope.sessionId,
+            scopeId: 'scope',
+            pactRef: { id: envelope.pactKey, version: '1', fingerprint: envelope.pactKey },
+            status: 'running',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            latestCheckpointSequence: null,
+            depth: 0,
+            metadata: { '__method.lastAckedTurn': -1 },
+        });
+        executor = new CortexJobBackedExecutor({
+            sessionStore: store,
+            workerId: 'test-worker',
+            emitAgentEvent: (e) => events.push(e),
+        });
+        observer = new CortexDlqObserver({
+            executor,
+            emitAgentEvent: (_e) => {
+                /* counted already by executor.emitAgentEvent */
+            },
+        });
+    });
+    it('inline path emits one event on first fire', async () => {
+        const event = await executor.emitInlineDeadLetter(envelope, 'boom', 1);
+        assert.ok(event);
+        assert.equal(events.length, 1);
+        assert.equal(events[0].type, 'pact.dead_letter');
+        assert.equal(events[0].sessionId, envelope.sessionId);
+        assert.equal(events[0].lastError, 'boom');
+        assert.equal(events[0].attempts, 1);
+    });
+    it('inline path is idempotent — second fire returns null', async () => {
+        await executor.emitInlineDeadLetter(envelope, 'boom', 1);
+        const second = await executor.emitInlineDeadLetter(envelope, 'boom again', 2);
+        assert.equal(second, null);
+        assert.equal(events.length, 1);
+    });
+    it('external DLQ path suppresses when inline already fired', async () => {
+        await executor.emitInlineDeadLetter(envelope, 'inline-boom', 1);
+        const external = await observer.onDeadLetter(envelope, {
+            jobId: 'job-123',
+            attempts: 4,
+            lastError: 'exhausted',
+            deadLetteredAt: Date.now(),
+        });
+        assert.equal(external, null);
+        assert.equal(events.length, 1);
+    });
+    it('external path fires once if inline never did', async () => {
+        const event = await observer.onDeadLetter(envelope, {
+            jobId: 'job-123',
+            attempts: 4,
+            lastError: 'exhausted',
+            deadLetteredAt: Date.now(),
+        });
+        assert.ok(event);
+        assert.equal(events.length, 1);
+        assert.equal(events[0].attempts, 4);
+    });
+    it('both paths firing sequentially for the same sessionId emit exactly one event', async () => {
+        await executor.emitInlineDeadLetter(envelope, 'inline', 1);
+        await observer.onDeadLetter(envelope, {
+            jobId: 'job-123',
+            attempts: 4,
+            lastError: 'external',
+            deadLetteredAt: Date.now(),
+        });
+        assert.equal(events.length, 1, 'exactly one PactDeadLetterEvent per sessionId');
+        // Repeated calls remain idempotent.
+        await executor.emitInlineDeadLetter(envelope, 'again', 5);
+        await observer.onDeadLetter(envelope, {
+            jobId: 'j2',
+            attempts: 4,
+            lastError: 'again',
+            deadLetteredAt: Date.now(),
+        });
+        assert.equal(events.length, 1);
+    });
+});
+//# sourceMappingURL=dlq-observer.test.js.map

package/dist/dlq/dlq-observer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq-observer.test.js","sourceRoot":"","sources":["../../src/dlq/dlq-observer.test.ts"],"names":[],"mappings":"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"}

package/dist/dlq/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @methodts/runtime/dlq — PRD-062 / S5 §2.4 + §7.
+ */
+export { CortexDlqObserver, } from './cortex-dlq-observer.js';
+export type { CortexDlqObserverOptions, } from './cortex-dlq-observer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/dlq/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dlq/index.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,EACL,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,wBAAwB,GACzB,MAAM,0BAA0B,CAAC"}

package/dist/dlq/index.js

@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @methodts/runtime/dlq — PRD-062 / S5 §2.4 + §7.
+ */
+export { CortexDlqObserver, } from './cortex-dlq-observer.js';
+//# sourceMappingURL=index.js.map

package/dist/dlq/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dlq/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;GAEG;AAEH,OAAO,EACL,iBAAiB,GAClB,MAAM,0BAA0B,CAAC"}

package/dist/event-bus/adapters.d.ts

@@ -0,0 +1,50 @@
+/**
+ * PRD 026 Phase 2: MCP Adapter Layer
+ *
+ * Translates RuntimeEvent → legacy channel/event shapes so that
+ * bridge_read_events and bridge_all_events MCP tools return
+ * backward-compatible JSON. Used during the transition from channels
+ * to bus-native reads (Phase 3).
+ */
+import type { RuntimeEvent } from '../ports/event-bus.js';
+/**
+ * Convert a RuntimeEvent to the legacy ChannelMessage shape used by
+ * `bridge_read_events` (session-scoped channel reads).
+ *
+ * Legacy shape:
+ * ```json
+ * { "sequence": N, "timestamp": "...", "sender": "...", "type": "...", "content": {...} }
+ * ```
+ */
+export declare function toChannelMessage(event: RuntimeEvent): {
+    sequence: number;
+    timestamp: string;
+    sender: string;
+    type: string;
+    content: Record<string, unknown>;
+};
+/**
+ * Convert an array of RuntimeEvents to the legacy all-events wrapper shape
+ * used by `bridge_all_events` (cross-session event polling).
+ *
+ * Legacy shape:
+ * ```json
+ * {
+ *   "messages": [...],
+ *   "last_sequence": N,
+ *   "has_more": false
+ * }
+ * ```
+ */
+export declare function toAllEventsWrapper(events: RuntimeEvent[], hasMore?: boolean): {
+    messages: Array<{
+        sequence: number;
+        timestamp: string;
+        sender: string;
+        type: string;
+        content: Record<string, unknown>;
+    }>;
+    last_sequence: number;
+    has_more: boolean;
+};
+//# sourceMappingURL=adapters.d.ts.map

package/dist/event-bus/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/event-bus/adapters.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAQA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,UAAQ,GACd;IACD,QAAQ,EAAE,KAAK,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB,CASA"}

package/dist/event-bus/adapters.js

@@ -0,0 +1,51 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * PRD 026 Phase 2: MCP Adapter Layer
+ *
+ * Translates RuntimeEvent → legacy channel/event shapes so that
+ * bridge_read_events and bridge_all_events MCP tools return
+ * backward-compatible JSON. Used during the transition from channels
+ * to bus-native reads (Phase 3).
+ */
+/**
+ * Convert a RuntimeEvent to the legacy ChannelMessage shape used by
+ * `bridge_read_events` (session-scoped channel reads).
+ *
+ * Legacy shape:
+ * ```json
+ * { "sequence": N, "timestamp": "...", "sender": "...", "type": "...", "content": {...} }
+ * ```
+ */
+export function toChannelMessage(event) {
+    return {
+        sequence: event.sequence,
+        timestamp: event.timestamp,
+        sender: event.source,
+        type: event.type,
+        content: event.payload,
+    };
+}
+/**
+ * Convert an array of RuntimeEvents to the legacy all-events wrapper shape
+ * used by `bridge_all_events` (cross-session event polling).
+ *
+ * Legacy shape:
+ * ```json
+ * {
+ *   "messages": [...],
+ *   "last_sequence": N,
+ *   "has_more": false
+ * }
+ * ```
+ */
+export function toAllEventsWrapper(events, hasMore = false) {
+    const messages = events.map(toChannelMessage);
+    return {
+        messages,
+        last_sequence: messages.length > 0
+            ? messages[messages.length - 1].sequence
+            : 0,
+        has_more: hasMore,
+    };
+}
+//# sourceMappingURL=adapters.js.map