@victframework/runtime 0.1.0

package/dist/stream-hub.js

@@ -0,0 +1,402 @@
+import { assertAgentStreamEvent, validateAgentStreamEvent, } from '@victframework/contracts';
+import { isDurableStreamKind, streamEventPayloadOf } from './control-types.js';
+export class AgentStreamHub {
+    #ledger;
+    #clock;
+    #transientBufferSize;
+    #pendingLimit;
+    #replayPageSize;
+    #streams = new Map();
+    constructor(options) {
+        this.#ledger = options.ledger;
+        this.#clock = options.clock ?? (() => Date.now());
+        this.#transientBufferSize = options.transientBufferSize ?? 512;
+        this.#pendingLimit = options.pendingLimit ?? 4096;
+        this.#replayPageSize = options.replayPageSize ?? 256;
+    }
+    /**
+     * Validate and publish one event. Assigns the monotonic sequence via the
+     * durable ledger, persists durable kinds, buffers transient deltas, and
+     * delivers to subscribers. Throws (fail closed) on any schema-invalid
+     * event.
+     */
+    async publish(event) {
+        // Pre-validate the event STRUCTURE with a placeholder sequence (the
+        // durable ledger assigns the authoritative monotonic sequence next).
+        const { seq: _ignored, ...withoutSeq } = event;
+        void _ignored;
+        const validation = validateAgentStreamEvent({ ...withoutSeq, seq: 1 });
+        if (!validation.ok) {
+            throw new Error(`AGENT_STREAM_EVENT_INVALID: event rejected by the vict.agent-stream@1 schema (${validation.issues
+                .map((issue) => issue.code)
+                .join(', ')}).`);
+        }
+        const { seq } = await this.#ledger.appendEvent({
+            streamId: event.streamId,
+            kind: event.kind,
+            payload: streamEventPayloadOf(event),
+            at: this.#clock(),
+        });
+        // The stored event is ONE immutable, frozen copy: the replay buffer and
+        // every subscriber receive their OWN copies, so no delivery path can
+        // ever mutate an event object that another path still reads.
+        const assigned = deepFreezeEvent({ ...event, seq });
+        assertAgentStreamEvent(assigned);
+        const state = this.#stateOf(event.streamId);
+        if (!isDurableStreamKind(event.kind)) {
+            pushBounded(state.buffer, assigned, this.#transientBufferSize);
+        }
+        this.#deliver(state, assigned);
+        return assigned;
+    }
+    /**
+     * Subscribe to a stream and replay everything after the cursor: durable
+     * ledger rows plus buffered transient deltas, in strict sequence order.
+     *
+     * The subscriber is REGISTERED before the ledger is read, so a concurrent
+     * publish can never fall into the gap between the replay read and the
+     * live attachment: events published during the replay read are captured
+     * in the subscriber's private pending queue and delivered in sequence
+     * order as part of the backlog.
+     *
+     * Delivery is at-least-once and CURSOR-DEDUPLICATED. Backpressure NEVER
+     * discards events: the remaining backlog is buffered (bounded) for this
+     * subscriber and delivered through `pull()`. If the bounded pending
+     * queue overflows, the explicit recoverable policy applies: `onOverflow()`
+     * is called and the subscriber is detached (reconnect from the last
+     * acknowledged cursor).
+     */
+    async subscribe(streamId, subscriber, cursor) {
+        const state = this.#stateOf(streamId);
+        if (state.subscribers.has(subscriber.subscriberId)) {
+            throw new Error('AGENT_STREAM_SUBSCRIBER_EXISTS: the subscriber id is already attached.');
+        }
+        const afterSeq = cursor?.lastSeq ?? 0;
+        // Register in the REGISTERING phase: every live event published during
+        // the ledger read lands in this subscriber's private pending queue
+        // (never lost to the replay/live race, never out of order).
+        const entry = {
+            subscriber,
+            registering: true,
+            slow: false,
+            pending: [],
+            detached: false,
+        };
+        state.subscribers.set(subscriber.subscriberId, entry);
+        // Deliver the ordered backlog page by page (bounded memory) plus any
+        // live events that were captured during registration. Everything goes
+        // through the private pending queue during registration so the ordered
+        // backlog and live captures stay strictly ordered relative to each
+        // other; the epilogue then hands them off and leaves the subscriber in
+        // the mode the LAST delivery dictated (fast transport keeps receiving
+        // directly; a saturated transport buffers with coalescing).
+        for await (const event of this.#replayIterator(streamId, afterSeq)) {
+            if (entry.detached) {
+                return;
+            }
+            // Registration buffers EXACTLY (no coalescing): every replayed and
+            // captured event keeps its identity and sequence, and the epilogue
+            // hands each one off individually, in order.
+            if (entry.pending.length < this.#pendingLimit) {
+                entry.pending.push(cloneEvent(event));
+                continue;
+            }
+            // Hard bound reached during registration: explicit recoverable
+            // overflow (never silent loss).
+            this.#overflow(state, entry);
+            return;
+        }
+        this.#flushPending(state, entry);
+    }
+    /** Detach a subscriber (clean completion/cancellation/overflow). */
+    unsubscribe(streamId, subscriberId) {
+        const state = this.#stateOf(streamId);
+        const entry = state.subscribers.get(subscriberId);
+        if (entry !== undefined && !entry.detached) {
+            entry.detached = true;
+            state.subscribers.delete(subscriberId);
+            entry.subscriber.detach?.();
+        }
+    }
+    /** Latest assigned sequence for a stream (ledger high-watermark). */
+    async latestSeq(streamId) {
+        return this.#ledger.latestSeq(streamId);
+    }
+    /**
+     * Drain the pending queue of a slow subscriber. Consecutive pending
+     * `text.delta` events are coalesced into one delta whose sequence is the
+     * LAST combined sequence (complete-range cursor semantics: a client that
+     * acknowledges the coalesced event acknowledges every delta inside it).
+     * Non-delta events are never dropped, reordered, or coalesced. Returned
+     * events are private copies of this subscriber's queue — coalescing never
+     * mutates any event that another consumer can observe.
+     */
+    pull(streamId, subscriberId) {
+        const state = this.#stateOf(streamId);
+        const entry = state.subscribers.get(subscriberId);
+        if (entry === undefined) {
+            return [];
+        }
+        // REGISTRATION phase: the private queue belongs to the ordered backlog
+        // handoff (subscribe epilogue). Draining it here would steal events
+        // mid-handoff and coalesce live captures that must be delivered
+        // exactly — wait until the epilogue completed.
+        if (entry.registering) {
+            return [];
+        }
+        const coalesced = coalesceDeltas(entry.pending);
+        entry.pending = [];
+        entry.slow = false;
+        return coalesced;
+    }
+    /**
+     * Reconnect status WITHOUT materializing the replay: ledger high-watermark
+     * plus exact transient-gap detection against the durable rows. Bounded
+     * memory: the durable coverage is counted page by page.
+     */
+    async replayStatus(cursor) {
+        return this.#computeStatus(cursor);
+    }
+    /**
+     * Materialized replay for reconnect: durable ledger rows plus buffered
+     * transient deltas after the cursor, in strict sequence order. The
+     * returned events are private copies; `olderThanBuffer` is detected
+     * against the authoritative ledger high-watermark (exact, restart-safe).
+     * For arbitrarily large histories prefer `replayIterate`/`replayStatus`,
+     * which never materialize the whole range.
+     */
+    async replay(cursor) {
+        const events = [];
+        for await (const event of this.#replayIterator(cursor.streamId, cursor.lastSeq)) {
+            events.push(event);
+        }
+        const status = await this.#computeStatus(cursor);
+        return { events, newestSeq: status.newestSeq, olderThanBuffer: status.olderThanBuffer };
+    }
+    /**
+     * Bounded-memory replay iterator: merges paged durable ledger reads with
+     * the bounded transient buffer in strict sequence order. Each yielded
+     * event is a private copy for this consumption path.
+     */
+    async *#replayIterator(streamId, afterSeq) {
+        const state = this.#stateOf(streamId);
+        // Buffered transients are bounded by the buffer size: snapshot them
+        // once (private copies; the buffer itself may keep growing).
+        const buffered = state.buffer
+            .filter((event) => event.seq > afterSeq)
+            .map((event) => cloneEvent(event))
+            .sort((a, b) => a.seq - b.seq);
+        let bufferIndex = 0;
+        let after = afterSeq;
+        for (;;) {
+            const page = await this.#ledger.listEventsFrom(streamId, after, this.#replayPageSize);
+            if (page.length === 0) {
+                break;
+            }
+            for (const row of page) {
+                const durableEvent = ledgerRowToEvent(row);
+                while (bufferIndex < buffered.length && buffered[bufferIndex].seq < row.seq) {
+                    yield buffered[bufferIndex];
+                    bufferIndex += 1;
+                }
+                // Durable rows and buffered transients are disjoint sequences
+                // (durable kinds are never buffered); the merge stays strict.
+                yield cloneEvent(durableEvent);
+                after = row.seq;
+            }
+            if (page.length < this.#replayPageSize) {
+                break;
+            }
+        }
+        while (bufferIndex < buffered.length) {
+            yield buffered[bufferIndex];
+            bufferIndex += 1;
+        }
+    }
+    /**
+     * Exact transient-gap detection against the AUTHORITATIVE ledger
+     * high-watermark. Bounded memory: durable coverage is counted page by
+     * page; buffered coverage comes from the bounded buffer.
+     */
+    async #computeStatus(cursor) {
+        const state = this.#stateOf(cursor.streamId);
+        // The high-watermark is read FIRST so every row read afterwards (with a
+        // seq ≤ watermark) is included: no publish can fall into the gap.
+        const ledgerNewest = await this.#ledger.latestSeq(cursor.streamId);
+        const bufferedInRange = state.buffer.filter((event) => event.seq > cursor.lastSeq);
+        const bufferedNewest = bufferedInRange.at(-1)?.seq ?? 0;
+        const newestSeq = Math.max(ledgerNewest, bufferedNewest, cursor.lastSeq);
+        const rangeSize = newestSeq - cursor.lastSeq;
+        let covered = 0;
+        if (rangeSize > 0) {
+            covered += bufferedInRange.length;
+            let after = cursor.lastSeq;
+            for (;;) {
+                const page = await this.#ledger.listEventsFrom(cursor.streamId, after, this.#replayPageSize);
+                if (page.length === 0) {
+                    break;
+                }
+                covered += page.length;
+                after = page.at(-1).seq;
+                if (page.length < this.#replayPageSize) {
+                    break;
+                }
+            }
+        }
+        return { newestSeq, olderThanBuffer: covered < rangeSize };
+    }
+    #stateOf(streamId) {
+        let state = this.#streams.get(streamId);
+        if (state === undefined) {
+            state = { streamId, buffer: [], subscribers: new Map() };
+            this.#streams.set(streamId, state);
+        }
+        return state;
+    }
+    /** Deliver to every subscriber; slow subscribers buffer with coalescing. */
+    #deliver(state, event) {
+        for (const entry of [...state.subscribers.values()]) {
+            if (entry.detached) {
+                continue;
+            }
+            if (entry.registering) {
+                // Registration phase: buffer EXACTLY (no coalescing) so every
+                // captured event keeps its identity and sequence — the epilogue
+                // hands each one off individually, in order with the backlog.
+                if (entry.pending.length < this.#pendingLimit) {
+                    entry.pending.push(cloneEvent(event));
+                    continue;
+                }
+                // Hard bound reached during registration: explicit recoverable
+                // overflow (never silent loss).
+                this.#overflow(state, entry);
+                continue;
+            }
+            if (!entry.slow) {
+                // Each subscriber receives its OWN copy: no delivery path can
+                // mutate an event the replay buffer (or another subscriber) reads.
+                // A `false` return means the event was ACCEPTED and the transport
+                // is saturated: only SUBSEQUENT events buffer.
+                if (!entry.subscriber.deliver(cloneEvent(event))) {
+                    entry.slow = true;
+                }
+                continue;
+            }
+            // Buffered mode: enqueue honoring the hard bound. Overflow follows
+            // the explicit recoverable policy (never silent loss).
+            this.#enqueue(state, entry, event);
+        }
+    }
+    /**
+     * Enqueue one event into a slow subscriber's private pending queue.
+     * Consecutive transient deltas coalesce (the coalesced delta carries the
+     * LAST sequence of its range). A queue overflow detaches the subscriber
+     * through the explicit recoverable policy: `onOverflow()` then detach.
+     * Returns false when the subscriber was detached by overflow.
+     */
+    #enqueue(state, entry, event) {
+        const last = entry.pending.at(-1);
+        if (event.kind === 'text.delta' && last !== undefined && last.kind === 'text.delta') {
+            // Coalesce into the private pending copy; the coalesced delta covers
+            // the complete range (cursor semantics = LAST combined sequence).
+            coalesceInto(last, event);
+            return true;
+        }
+        if (entry.pending.length < this.#pendingLimit) {
+            entry.pending.push(cloneEvent(event));
+            return true;
+        }
+        // Hard bound reached. A further transient delta with no pending delta
+        // neighbor cannot fit: overflow policy. Non-delta (durable, control,
+        // terminal) events are NEVER discarded: overflow policy.
+        this.#overflow(state, entry);
+        return false;
+    }
+    /** The explicit recoverable overflow policy: signal, then detach. */
+    #overflow(state, entry) {
+        if (entry.detached) {
+            return;
+        }
+        entry.subscriber.onOverflow?.();
+        this.unsubscribe(state.streamId, entry.subscriber.subscriberId);
+    }
+    /** Deliver the pending queue of a slow subscriber (subscribe epilogue). */
+    #flushPending(state, entry) {
+        while (entry.pending.length > 0 && !entry.detached) {
+            const next = entry.pending[0];
+            if (!entry.slow) {
+                entry.pending.shift();
+                if (!entry.subscriber.deliver(next)) {
+                    entry.slow = true;
+                }
+                continue;
+            }
+            break;
+        }
+        // Registration is complete: live publishes now follow the mode the
+        // last delivery dictated. A transport that never signaled saturation
+        // receives events DIRECTLY (per-event identity is preserved for the
+        // byte-level transport pump); a saturated transport buffers (with
+        // coalescing) for pull-based draining.
+        entry.registering = false;
+    }
+}
+/** Bounded push; drops the OLDEST transient delta when full. */
+function pushBounded(buffer, event, size) {
+    buffer.push(event);
+    if (buffer.length > size) {
+        buffer.splice(0, buffer.length - size);
+    }
+}
+/** A private deep copy of one event (delivery paths never share objects). */
+function cloneEvent(event) {
+    return JSON.parse(JSON.stringify(event));
+}
+/** Freeze one event deeply (stored events are immutable by construction). */
+function deepFreezeEvent(event) {
+    if (event !== null && typeof event === 'object') {
+        for (const value of Object.values(event)) {
+            if (value !== null && typeof value === 'object') {
+                deepFreezeEvent(value);
+            }
+        }
+        Object.freeze(event);
+    }
+    return event;
+}
+/**
+ * Coalesce one transient delta into a PRIVATE pending copy. The combined
+ * event carries the complete-range cursor semantics: its sequence is the
+ * LAST combined sequence, so acknowledging it acknowledges every delta in
+ * the range and a reconnect cannot re-deliver part of the text.
+ */
+function coalesceInto(target, incoming) {
+    target.delta =
+        target.delta + incoming.delta;
+    target.seq = incoming.seq;
+}
+/** Coalesce CONSECUTIVE text.delta events; all other events pass through. */
+function coalesceDeltas(events) {
+    const result = [];
+    for (const event of events) {
+        const last = result.at(-1);
+        if (event.kind === 'text.delta' && last !== undefined && last.kind === 'text.delta') {
+            coalesceInto(last, event);
+            continue;
+        }
+        result.push(cloneEvent(event));
+    }
+    return result.map((event) => deepFreezeEvent(event));
+}
+/** Reconstruct one full event from a durable ledger row (fail closed). */
+function ledgerRowToEvent(row) {
+    const payload = JSON.parse(row.payload);
+    const event = {
+        ...payload,
+        streamId: row.streamId,
+        seq: row.seq,
+    };
+    assertAgentStreamEvent(event);
+    return event;
+}
+//# sourceMappingURL=stream-hub.js.map

package/dist/stream-hub.js.map

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

package/dist/testing.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Testing utilities for `@victframework/runtime`. Import from `@victframework/runtime/testing`.
+ *
+ * Includes the adapter-neutral store conformance suite: every conforming
+ * store backend (in-memory, SQLite, future adapters) must pass the same
+ * behavioral source.
+ */
+export { runStoreConformanceSuite } from './store-conformance.js';
+export { runOrchestrationConformanceSuite, stringContract, recordContract, decisionGraph, fanoutGraph, signalWaitGraph, timerWaitGraph, retryGraph, unsafeWriteGraph, } from './orchestration-conformance.js';
+export { runOrchestrationJoinSuite } from './orchestration-join-conformance.js';
+export { createManualOrchestrationClock } from './orchestration-race-conformance.js';
+export { runOrchestrationRaceSuite } from './orchestration-race-conformance.js';
+export { runOrchestrationCanarySuite } from './orchestration-canary-conformance.js';
+export { runOrchestrationRemediationSuite } from './orchestration-remediation-conformance.js';
+export type { OrchestrationRemediationFixture, OrchestrationRemediationHandle, OrchestrationRemediationStores, } from './orchestration-remediation-conformance.js';
+export type { OrchestrationCanaryFixture, OrchestrationCanaryStores, } from './orchestration-canary-conformance.js';
+export type { OrchestrationRaceFixture, OrchestrationRaceStores, } from './orchestration-race-conformance.js';
+export type { ConformanceTestRunner as OrchestrationConformanceRunner, ConformanceExpect as OrchestrationConformanceExpect, OrchestrationConformanceFixture, OrchestrationConformanceStores, } from './orchestration-conformance.js';
+export type { StoreConformanceFactory, ConformanceTestRunner, ConformanceStores, ConformanceExpect, } from './store-conformance.js';
+export { runDurableBoundarySuite } from './boundary-conformance.js';
+export type { BoundaryConformanceFactory, BoundaryGates } from './boundary-conformance.js';
+export { RECOVERY_CODE, RECOVERY_REASON, RECOVERY_REMEDIATION } from './runtime.js';
+export { runCapabilityPackConformanceSuite } from './pack-conformance.js';
+export type { CapabilityPackConformanceFixture, CapabilityPackConformanceOptions, } from './pack-conformance.js';
+export { installCapabilityPack } from './pack-install.js';

package/dist/testing.js

@@ -0,0 +1,19 @@
+/**
+ * Testing utilities for `@victframework/runtime`. Import from `@victframework/runtime/testing`.
+ *
+ * Includes the adapter-neutral store conformance suite: every conforming
+ * store backend (in-memory, SQLite, future adapters) must pass the same
+ * behavioral source.
+ */
+export { runStoreConformanceSuite } from './store-conformance.js';
+export { runOrchestrationConformanceSuite, stringContract, recordContract, decisionGraph, fanoutGraph, signalWaitGraph, timerWaitGraph, retryGraph, unsafeWriteGraph, } from './orchestration-conformance.js';
+export { runOrchestrationJoinSuite } from './orchestration-join-conformance.js';
+export { createManualOrchestrationClock } from './orchestration-race-conformance.js';
+export { runOrchestrationRaceSuite } from './orchestration-race-conformance.js';
+export { runOrchestrationCanarySuite } from './orchestration-canary-conformance.js';
+export { runOrchestrationRemediationSuite } from './orchestration-remediation-conformance.js';
+export { runDurableBoundarySuite } from './boundary-conformance.js';
+export { RECOVERY_CODE, RECOVERY_REASON, RECOVERY_REMEDIATION } from './runtime.js';
+export { runCapabilityPackConformanceSuite } from './pack-conformance.js';
+export { installCapabilityPack } from './pack-install.js';
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EACL,gCAAgC,EAChC,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EACd,UAAU,EACV,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EAAE,gCAAgC,EAAE,MAAM,4CAA4C,CAAC;AA0B9F,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAK1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}