@vibesdotdev/kernel-rpc 0.0.0-stage → 1.0.0-rc.2

package/dist/core/lifecycle-repeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-repeat.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle-repeat.ts"],"names":[],"mappings":"AAAA,OAAO,EAKP,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AA6CrF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,OAAO,CAAC,EACvD,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,IAAI,GACd,eAAe,CAUjB"}

package/dist/core/lifecycle-repeat.js

@@ -0,0 +1,59 @@
+import { CaughtFailureSchema, isCapabilityError } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+const FINITE_HOST_REASON = 'lifecycle-interval-finite';
+function isRepeatStopped(error) {
+    return isCapabilityError(error) && (error.reason === 'wait-aborted' || error.reason === 'runtime-disposed');
+}
+/**
+ * A running repeat, or the finite host's typed refusal beside the delay-loop
+ * cadence that keeps the same tick alive on a host that refuses interval.
+ */
+function startFiniteDelay(runtime, lifecycle, ms, tick) {
+    const abort = new AbortController();
+    const logger = getLogger('runtime-plugin.lifecycle-repeat', runtime);
+    const loop = (async () => {
+        while (!abort.signal.aborted) {
+            try {
+                await lifecycle.delay(ms, abort.signal);
+            }
+            catch (cause) {
+                const failure = CaughtFailureSchema.parse(cause);
+                if (isRepeatStopped(failure))
+                    return failure;
+                throw failure;
+            }
+            if (abort.signal.aborted)
+                return;
+            tick();
+        }
+    })();
+    void loop.catch((cause) => {
+        const failure = CaughtFailureSchema.parse(cause);
+        if (isRepeatStopped(failure))
+            return failure;
+        logger.error('lifecycle.delay repeat failed', { error: failure });
+        return failure;
+    });
+    return () => {
+        abort.abort();
+    };
+}
+/**
+ * Repeat `tick` every `ms` on a persistent host via `lifecycle.interval`.
+ * A finite host refuses interval; the same cadence continues on a
+ * `lifecycle.delay` loop bound to the returned stopper. The refusal stays
+ * on the handle.
+ */
+export function startLifecycleRepeat(runtime, lifecycle, ms, tick) {
+    try {
+        return { stop: lifecycle.interval(tick, ms), refusal: null };
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        if (isCapabilityError(failure) && failure.reason === FINITE_HOST_REASON) {
+            return { stop: startFiniteDelay(runtime, lifecycle, ms, tick), refusal: failure };
+        }
+        throw failure;
+    }
+}
+//# sourceMappingURL=lifecycle-repeat.js.map

package/dist/core/lifecycle-repeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-repeat.js","sourceRoot":"","sources":["../../src/core/lifecycle-repeat.ts"],"names":[],"mappings":"AAAA,OAAO,EACP,mBAAmB,EACnB,iBAAiB,EAKhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAIjD,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAEvD,SAAS,eAAe,CAAC,KAAoB;IAC5C,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,cAAc,IAAI,KAAK,CAAC,MAAM,KAAK,kBAAkB,CAAC,CAAC;AAC7G,CAAC;AAED;;;GAGG;AAEH,SAAS,gBAAgB,CACxB,OAAmB,EACnB,SAA0C,EAC1C,EAAU,EACV,IAAgB;IAEhB,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,SAAS,CAAC,iCAAiC,EAAE,OAAO,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACJ,MAAM,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACjD,IAAI,eAAe,CAAC,OAAO,CAAC;oBAAE,OAAO,OAAO,CAAC;gBAC7C,MAAM,OAAO,CAAC;YACf,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;YACjC,IAAI,EAAE,CAAC;QACR,CAAC;IACF,CAAC,CAAC,EAAE,CAAC;IACL,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAClC,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,eAAe,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAClE,OAAO,OAAO,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,EAAE;QACX,KAAK,CAAC,KAAK,EAAE,CAAC;IACf,CAAC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CACnC,OAAmB,EACnB,SAAuD,EACvD,EAAU,EACV,IAAgB;IAEhB,IAAI,CAAC;QACJ,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,iBAAiB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;YACzE,OAAO,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QACnF,CAAC;QACD,MAAM,OAAO,CAAC;IACf,CAAC;AACF,CAAC"}

package/dist/core/protocol/lifecycle/attempt.d.ts

@@ -0,0 +1,23 @@
+import type { Attempt } from "../../../schemas/contracts/protocol/lifecycle/attempt.ts";
+export type { Attempt } from "../../../schemas/contracts/protocol/lifecycle/attempt.ts";
+/**
+ * A failure as a value.
+ *
+ * Where a boundary has to keep going after an operation fails (answer the
+ * peer, keep the failure for the connection's close, try the next candidate),
+ * the operation is run as an {@link Attempt}: its failure is parsed at the
+ * catch and carried whole, to the code that decides what it means. Nothing is
+ * dropped between the throw and that decision.
+ */
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+/** Run a synchronous operation, carrying its failure. */
+export declare function attempt<T>(operation: () => T): Attempt<T>;
+/** Run an operation that may be asynchronous, carrying its failure. */
+export declare function attemptAsync<T>(operation: () => T | PromiseLike<T>): Promise<Attempt<T>>;
+/** Throw a carried failure again, exactly as it was thrown: the Error itself, or the non-Error value. */
+export declare function rethrow(failure: CaughtFailure): never;
+/** Whether a carried failure is exactly `thrown`: the Error itself, or the non-Error value thrown. */
+export declare function isFailureOf<V>(failure: CaughtFailure, thrown: V): boolean;
+/** Observe how a promise settled without letting its rejection escape: the failure is carried, never dropped. */
+export declare function settled<T>(promise: PromiseLike<T>): Promise<Attempt<T>>;
+//# sourceMappingURL=attempt.d.ts.map

package/dist/core/protocol/lifecycle/attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/lifecycle/attempt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0DAA0D,CAAC;AACxF,YAAY,EAAE,OAAO,EAAE,MAAM,0DAA0D,CAAC;AACxF;;;;;;;;GAQG;AAEH,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,yDAAyD;AACzD,wBAAgB,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMzD;AAED,uEAAuE;AACvE,wBAAsB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAM9F;AAED,yGAAyG;AACzG,wBAAgB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAErD;AAED,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAEzE;AAED,iHAAiH;AACjH,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAKvE"}

package/dist/core/protocol/lifecycle/attempt.js

@@ -0,0 +1,41 @@
+/**
+ * A failure as a value.
+ *
+ * Where a boundary has to keep going after an operation fails (answer the
+ * peer, keep the failure for the connection's close, try the next candidate),
+ * the operation is run as an {@link Attempt}: its failure is parsed at the
+ * catch and carried whole, to the code that decides what it means. Nothing is
+ * dropped between the throw and that decision.
+ */
+import { CaughtFailureSchema } from '@vibesdotdev/kernel';
+/** Run a synchronous operation, carrying its failure. */
+export function attempt(operation) {
+    try {
+        return { ok: true, value: operation() };
+    }
+    catch (error) {
+        return { ok: false, failure: CaughtFailureSchema.parse(error) };
+    }
+}
+/** Run an operation that may be asynchronous, carrying its failure. */
+export async function attemptAsync(operation) {
+    try {
+        return { ok: true, value: await operation() };
+    }
+    catch (error) {
+        return { ok: false, failure: CaughtFailureSchema.parse(error) };
+    }
+}
+/** Throw a carried failure again, exactly as it was thrown: the Error itself, or the non-Error value. */
+export function rethrow(failure) {
+    throw failure instanceof Error ? failure : failure.value;
+}
+/** Whether a carried failure is exactly `thrown`: the Error itself, or the non-Error value thrown. */
+export function isFailureOf(failure, thrown) {
+    return (failure instanceof Error ? failure : failure.value) === thrown;
+}
+/** Observe how a promise settled without letting its rejection escape: the failure is carried, never dropped. */
+export function settled(promise) {
+    return Promise.resolve(promise).then((value) => ({ ok: true, value }), (reason) => ({ ok: false, failure: CaughtFailureSchema.parse(reason) }));
+}
+//# sourceMappingURL=attempt.js.map

package/dist/core/protocol/lifecycle/attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.js","sourceRoot":"","sources":["../../../../src/core/protocol/lifecycle/attempt.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAsB,MAAM,qBAAqB,CAAC;AAE9E,yDAAyD;AACzD,MAAM,UAAU,OAAO,CAAI,SAAkB;IAC5C,IAAI,CAAC;QACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IACjE,CAAC;AACF,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,SAAmC;IACxE,IAAI,CAAC;QACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,SAAS,EAAE,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IACjE,CAAC;AACF,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,OAAO,CAAC,OAAsB;IAC7C,MAAM,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;AAC1D,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,WAAW,CAAI,OAAsB,EAAE,MAAS;IAC/D,OAAO,CAAC,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC;AACxE,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,OAAO,CAAI,OAAuB;IACjD,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CACnC,CAAC,KAAK,EAAc,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAC5C,CAAC,MAAM,EAAc,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CACnF,CAAC;AACH,CAAC"}

package/dist/core/protocol/lifecycle/binding-close.d.ts

@@ -0,0 +1,54 @@
+import { CapabilityError, type CaughtFailure } from '@vibesdotdev/kernel';
+import type { StreamBinding } from '../references/dispatch.ts';
+export { CONNECTION_CLOSE_DEADLINE_MS, isAlreadyClosedStatus, LEG_FAILED, LegFailures } from "./leg-failures.ts";
+export { ClosedSubjectSchema, FailedLegSchema } from "../../../schemas/contracts/protocol/lifecycle/binding-close.ts";
+/** The reason a binding's close failure carries, on the owner and across the wire. */
+export declare const CHANNEL_CLOSE_FAILED = "rpc-channel-close-failed";
+/** The typed failure for one channel whose binding did not close cleanly. */
+export declare function channelCloseFailure(channelId: string, cause: CaughtFailure): CapabilityError;
+/** The reason a connection's own close carries when its far side refused or never took it. */
+export declare const CONNECTION_CLOSE_FAILED = "rpc-connection-close-failed";
+/** The typed failure for a connection whose close the host refused or never received. */
+export declare function connectionCloseFailure(connectionId: string, cause: CaughtFailure): CapabilityError;
+/** The subject a kept close failure names in its details: one channel, or one connection. */
+/** The leg a kept leg failure names in its details. */
+/** One connection's binding closes: each started synchronously, each failure kept typed until reported. */
+export declare class BindingCloses {
+    private readonly inFlight;
+    private readonly kept;
+    /**
+     * Close `binding` now and resolve to its typed failure, or `null`. The
+     * failure is also kept for {@link settle}. The returned promise never rejects.
+     */
+    close(binding: StreamBinding, channelId: string): Promise<CapabilityError | null>;
+    /** Close `binding` now; a failure is kept for {@link settle}. */
+    keep(binding: StreamBinding, channelId: string): void;
+    /** Keep a channel failure that happened outside the binding's close (an unsubscribe that threw). */
+    keepFailure(channelId: string, cause: CaughtFailure): void;
+    /** Keep an already typed teardown failure (a connection's own socket end). */
+    keepError(failure: CapabilityError): void;
+    private start;
+    /**
+     * Wait for every close started so far and resolve to the kept failures as
+     * one typed error (`null` when every close was clean). Never rejects.
+     */
+    settle(): Promise<CapabilityError | null>;
+    /** Wait for every close started so far; reject with the kept failures, typed. */
+    drain(): Promise<void>;
+}
+/**
+ * A listener's connection close outcomes. A connection that closed on its own
+ * (its socket went away) hands its outcome here; the listener's `stop()`
+ * reports every failure kept so far together with the connections it closes.
+ */
+export declare class ConnectionCloses {
+    private readonly inFlight;
+    private readonly kept;
+    /** Keep `outcome`'s failure, if any, for {@link drain}. */
+    keep(outcome: Promise<CapabilityError | null>): void;
+    /** Report the kept failures and `outcomes` as one: resolves when all were clean, else rejects typed. */
+    drain(outcomes?: Iterable<Promise<CapabilityError | null>>): Promise<void>;
+}
+/** Report several connections' close outcomes as one: resolves when all were clean, else rejects typed. */
+export declare function drainAll(outcomes: Iterable<Promise<CapabilityError | null>>): Promise<void>;
+//# sourceMappingURL=binding-close.d.ts.map

package/dist/core/protocol/lifecycle/binding-close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-close.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/lifecycle/binding-close.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEjH,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gEAAgE,CAAC;AAEtH,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,6BAA6B,CAAC;AAE/D,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,eAAe,CAO5F;AAED,8FAA8F;AAC9F,eAAO,MAAM,uBAAuB,gCAAgC,CAAC;AAGrE,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,eAAe,CAOlG;AAED,6FAA6F;AAE7F,uDAAuD;AAEvD,2GAA2G;AAC3G,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAE9C;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAWjF,iEAAiE;IACjE,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrD,oGAAoG;IACpG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAI1D,8EAA8E;IAC9E,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIzC,OAAO,CAAC,KAAK;IAQb;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAkB/C,iFAAiF;IAC3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAE9C,2DAA2D;IAC3D,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,IAAI;IAQpD,wGAAwG;IAClG,KAAK,CAAC,QAAQ,GAAE,QAAQ,CAAC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMpF;AAED,2GAA2G;AAC3G,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjG"}

package/dist/core/protocol/lifecycle/binding-close.js

@@ -0,0 +1,137 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { ClosedSubjectSchema } from "../../../schemas/contracts/protocol/lifecycle/binding-close.js";
+import { attempt, settled } from "./attempt.js";
+export { CONNECTION_CLOSE_DEADLINE_MS, isAlreadyClosedStatus, LEG_FAILED, LegFailures } from "./leg-failures.js";
+export { ClosedSubjectSchema, FailedLegSchema } from "../../../schemas/contracts/protocol/lifecycle/binding-close.js";
+/** The reason a binding's close failure carries, on the owner and across the wire. */
+export const CHANNEL_CLOSE_FAILED = 'rpc-channel-close-failed';
+/** The typed failure for one channel whose binding did not close cleanly. */
+export function channelCloseFailure(channelId, cause) {
+    return new CapabilityError(`Stream channel '${channelId}' did not close cleanly.`, 'UNAVAILABLE', {
+        reason: CHANNEL_CLOSE_FAILED,
+        retryable: false,
+        details: { channelId },
+        cause
+    });
+}
+/** The reason a connection's own close carries when its far side refused or never took it. */
+export const CONNECTION_CLOSE_FAILED = 'rpc-connection-close-failed';
+/** The typed failure for a connection whose close the host refused or never received. */
+export function connectionCloseFailure(connectionId, cause) {
+    return new CapabilityError(`Connection '${connectionId}' did not close cleanly.`, 'UNAVAILABLE', {
+        reason: CONNECTION_CLOSE_FAILED,
+        retryable: false,
+        details: { connectionId },
+        cause
+    });
+}
+/** The subject a kept close failure names in its details: one channel, or one connection. */
+/** The leg a kept leg failure names in its details. */
+/** One connection's binding closes: each started synchronously, each failure kept typed until reported. */
+export class BindingCloses {
+    inFlight = new Set();
+    kept = [];
+    /**
+     * Close `binding` now and resolve to its typed failure, or `null`. The
+     * failure is also kept for {@link settle}. The returned promise never rejects.
+     */
+    close(binding, channelId) {
+        const settled = this.start(binding, channelId).then((failure) => {
+            if (failure)
+                this.kept.push(failure);
+            return failure;
+        });
+        const tracked = settled.then(() => undefined);
+        this.inFlight.add(tracked);
+        void tracked.then(() => this.inFlight.delete(tracked));
+        return settled;
+    }
+    /** Close `binding` now; a failure is kept for {@link settle}. */
+    keep(binding, channelId) {
+        void this.close(binding, channelId);
+    }
+    /** Keep a channel failure that happened outside the binding's close (an unsubscribe that threw). */
+    keepFailure(channelId, cause) {
+        this.kept.push(channelCloseFailure(channelId, cause));
+    }
+    /** Keep an already typed teardown failure (a connection's own socket end). */
+    keepError(failure) {
+        this.kept.push(failure);
+    }
+    start(binding, channelId) {
+        const closing = attempt(() => binding.close());
+        if (!closing.ok)
+            return Promise.resolve(channelCloseFailure(channelId, closing.failure));
+        return settled(Promise.resolve(closing.value)).then((closed) => (closed.ok ? null : channelCloseFailure(channelId, closed.failure)));
+    }
+    /**
+     * Wait for every close started so far and resolve to the kept failures as
+     * one typed error (`null` when every close was clean). Never rejects.
+     */
+    async settle() {
+        while (this.inFlight.size > 0)
+            await Promise.all(this.inFlight);
+        const failures = this.kept.splice(0);
+        if (failures.length === 0)
+            return null;
+        if (failures.length === 1)
+            return failures[0];
+        return new CapabilityError(`${failures.length} stream channels did not close cleanly.`, 'UNAVAILABLE', {
+            reason: CHANNEL_CLOSE_FAILED,
+            retryable: false,
+            details: {
+                channelIds: failures.map((failure) => {
+                    const subject = ClosedSubjectSchema.safeParse(failure.details);
+                    return subject.data?.channelId ?? subject.data?.connectionId ?? null;
+                })
+            },
+            cause: new AggregateError(failures)
+        });
+    }
+    /** Wait for every close started so far; reject with the kept failures, typed. */
+    async drain() {
+        const failure = await this.settle();
+        if (failure)
+            throw failure;
+    }
+}
+/**
+ * A listener's connection close outcomes. A connection that closed on its own
+ * (its socket went away) hands its outcome here; the listener's `stop()`
+ * reports every failure kept so far together with the connections it closes.
+ */
+export class ConnectionCloses {
+    inFlight = new Set();
+    kept = [];
+    /** Keep `outcome`'s failure, if any, for {@link drain}. */
+    keep(outcome) {
+        const settled = outcome.then((failure) => {
+            if (failure)
+                this.kept.push(failure);
+        });
+        this.inFlight.add(settled);
+        void settled.then(() => this.inFlight.delete(settled));
+    }
+    /** Report the kept failures and `outcomes` as one: resolves when all were clean, else rejects typed. */
+    async drain(outcomes = []) {
+        const current = [...outcomes];
+        while (this.inFlight.size > 0)
+            await Promise.all(this.inFlight);
+        const kept = this.kept.splice(0);
+        await drainAll([...kept.map((failure) => Promise.resolve(failure)), ...current]);
+    }
+}
+/** Report several connections' close outcomes as one: resolves when all were clean, else rejects typed. */
+export async function drainAll(outcomes) {
+    const failures = (await Promise.all(outcomes)).filter((failure) => failure !== null);
+    if (failures.length === 1)
+        throw failures[0];
+    if (failures.length > 1) {
+        throw new CapabilityError(`${failures.length} connections did not close cleanly.`, 'UNAVAILABLE', {
+            reason: CHANNEL_CLOSE_FAILED,
+            retryable: false,
+            cause: new AggregateError(failures)
+        });
+    }
+}
+//# sourceMappingURL=binding-close.js.map

package/dist/core/protocol/lifecycle/binding-close.js.map

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

package/dist/core/protocol/lifecycle/channel-close.d.ts

@@ -0,0 +1,39 @@
+import type { CloseRefusalCause, RpcChannelCloseAck } from "../../../schemas/contracts/protocol/lifecycle/channel-close.ts";
+export { CloseAnswerSchema, CloseRefusalSchema } from "../../../schemas/contracts/protocol/lifecycle/channel-close.ts";
+export type { CloseRefusalCause, RpcChannelCloseAck } from "../../../schemas/contracts/protocol/lifecycle/channel-close.ts";
+/**
+ * What a consumer's `RpcChannel.close()` settles to: whether the owner
+ * acknowledged the close, or why this transport cannot say.
+ *
+ * A close always discards locally and sends its close in frame order at once;
+ * only the returned promise waits. It resolves `{ acknowledged: true }` when
+ * the owner confirmed its binding closed, and `{ acknowledged: false, reason }`
+ * when the transport has no acknowledgement to give — never a void read as
+ * confirmed. It rejects with the typed `rpc-channel-close-failed`
+ * `CapabilityError` when the close was refused (a non-2xx answer) or could not
+ * be delivered (a network failure), or the owner's binding close failed.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+export declare const CLOSE_ACKNOWLEDGED: RpcChannelCloseAck;
+export declare function closeUnacknowledged(reason: Extract<RpcChannelCloseAck, {
+    acknowledged: false;
+}>['reason']): RpcChannelCloseAck;
+/** The typed failure for a consumer close the far side refused or never received. */
+export declare function channelCloseRefused(channelId: string, detail: {
+    status?: number;
+    cause?: CloseRefusalCause;
+}): CapabilityError;
+/**
+ * Settle a POSTed close. A 2xx settles to `onSuccess`, or with `'owner-answer'`
+ * to the acknowledgement the owner put in its body (`{ ack }`) — a bare 2xx
+ * with no ack is `unacknowledged-transport`, never read as acknowledged. Any
+ * other status rejects typed (carrying the owner's typed error body, when it
+ * sent one, as the cause); a fetch failure rejects typed.
+ */
+export declare function postedCloseAck(channelId: string, posted: Promise<Response>, onSuccess: RpcChannelCloseAck | 'owner-answer'): Promise<RpcChannelCloseAck>;
+/**
+ * The promise a `close()` returns. A caller observes the outcome by awaiting
+ * it; one that does not await still gets no unhandled rejection.
+ */
+export declare function observableClose(outcome: Promise<RpcChannelCloseAck>): Promise<RpcChannelCloseAck>;
+//# sourceMappingURL=channel-close.d.ts.map

package/dist/core/protocol/lifecycle/channel-close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-close.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/lifecycle/channel-close.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gEAAgE,CAAC;AAE5H,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gEAAgE,CAAC;AACvH,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gEAAgE,CAAC;AAC5H;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAWtD,eAAO,MAAM,kBAAkB,EAAE,kBAA6C,CAAC;AAE/E,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,OAAO,CAAC,kBAAkB,EAAE;IAAE,YAAY,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC,QAAQ,CAAC,GACpE,kBAAkB,CAEpB;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACpD,eAAe,CAajB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,EACzB,SAAS,EAAE,kBAAkB,GAAG,cAAc,GAC5C,OAAO,CAAC,kBAAkB,CAAC,CAkB7B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIjG"}

package/dist/core/protocol/lifecycle/channel-close.js

@@ -0,0 +1,75 @@
+import { CloseAnswerSchema, CloseRefusalSchema } from "../../../schemas/contracts/protocol/lifecycle/channel-close.js";
+export { CloseAnswerSchema, CloseRefusalSchema } from "../../../schemas/contracts/protocol/lifecycle/channel-close.js";
+/**
+ * What a consumer's `RpcChannel.close()` settles to: whether the owner
+ * acknowledged the close, or why this transport cannot say.
+ *
+ * A close always discards locally and sends its close in frame order at once;
+ * only the returned promise waits. It resolves `{ acknowledged: true }` when
+ * the owner confirmed its binding closed, and `{ acknowledged: false, reason }`
+ * when the transport has no acknowledgement to give — never a void read as
+ * confirmed. It rejects with the typed `rpc-channel-close-failed`
+ * `CapabilityError` when the close was refused (a non-2xx answer) or could not
+ * be delivered (a network failure), or the owner's binding close failed.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { attemptAsync, settled } from "./attempt.js";
+import { CHANNEL_CLOSE_FAILED } from "./binding-close.js";
+/** An owner's close body (`{ ack }`): a confirmation, or the reason it can give none. */
+/** An owner's error body: the typed error it answered a refused close with. */
+/** What a refused close names as its cause: a local failure, or the error the owner answered with. */
+const CLOSE_ACKNOWLEDGED_VALUE = Object.freeze({ acknowledged: true });
+export const CLOSE_ACKNOWLEDGED = CLOSE_ACKNOWLEDGED_VALUE;
+export function closeUnacknowledged(reason) {
+    return Object.freeze({ acknowledged: false, reason });
+}
+/** The typed failure for a consumer close the far side refused or never received. */
+export function channelCloseRefused(channelId, detail) {
+    return new CapabilityError(detail.status !== undefined
+        ? `Stream channel '${channelId}' close was refused (http ${detail.status}).`
+        : `Stream channel '${channelId}' close could not be delivered.`, 'UNAVAILABLE', {
+        reason: CHANNEL_CLOSE_FAILED,
+        retryable: false,
+        details: { channelId, status: detail.status },
+        cause: detail.cause
+    });
+}
+/**
+ * Settle a POSTed close. A 2xx settles to `onSuccess`, or with `'owner-answer'`
+ * to the acknowledgement the owner put in its body (`{ ack }`) — a bare 2xx
+ * with no ack is `unacknowledged-transport`, never read as acknowledged. Any
+ * other status rejects typed (carrying the owner's typed error body, when it
+ * sent one, as the cause); a fetch failure rejects typed.
+ */
+export async function postedCloseAck(channelId, posted, onSuccess) {
+    const sent = await settled(posted);
+    if (!sent.ok)
+        throw channelCloseRefused(channelId, { cause: sent.failure });
+    const response = sent.value;
+    if (response.ok) {
+        if (onSuccess !== 'owner-answer')
+            return onSuccess;
+        // A 2xx whose body carries no parseable ack gave no acknowledgement:
+        // it settles `unacknowledged-transport`, never as acknowledged.
+        const read = await attemptAsync(() => response.json());
+        const answer = read.ok ? CloseAnswerSchema.safeParse(read.value) : undefined;
+        if (!answer?.success)
+            return closeUnacknowledged('unacknowledged-transport');
+        return answer.data.ack.acknowledged ? CLOSE_ACKNOWLEDGED_VALUE : closeUnacknowledged(answer.data.ack.reason);
+    }
+    // The refusal below carries the status; an unparseable error body only means
+    // there is no owner error to attach as its cause.
+    const read = await attemptAsync(() => response.json());
+    const refusal = read.ok ? CloseRefusalSchema.safeParse(read.value) : undefined;
+    throw channelCloseRefused(channelId, { status: response.status, cause: refusal?.data?.error });
+}
+/**
+ * The promise a `close()` returns. A caller observes the outcome by awaiting
+ * it; one that does not await still gets no unhandled rejection.
+ */
+export function observableClose(outcome) {
+    // Marks the rejection observed; the caller receives this same promise and sees the failure.
+    void settled(outcome);
+    return outcome;
+}
+//# sourceMappingURL=channel-close.js.map

package/dist/core/protocol/lifecycle/channel-close.js.map

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

package/dist/core/protocol/lifecycle/channel-end.d.ts

@@ -0,0 +1,53 @@
+/**
+ * A byte channel's end-of-stream completion (the consumer half of EOF).
+ *
+ * The owner ends a channel by sending its CLOSE frame after the channel's last
+ * DATA frame (a binding's `onEnd`). Frames arrive in order, so when CLOSE is
+ * read every byte before it has already been dispatched: to the subscribers,
+ * or into the channel's pre-attach buffer. `ended` resolves only once those
+ * bytes have reached a subscriber, so a consumer that joins `ended` with the
+ * process's exit reads the whole output before it sees the exit.
+ *
+ * An owner that ends the channel typed (a credit-governed source that failed,
+ * or an event that broke its policy) sends the ending on its CLOSE frame:
+ * `ended` then rejects with that code and reason, once the bytes before it
+ * reached a subscriber, exactly as a clean end resolves.
+ *
+ * `ended` rejects `RPC_DISCONNECTED` only when the connection drops before
+ * the owner's EOF arrived (the output is incomplete). Once the owner's EOF is
+ * accepted the output is complete: a later connection end leaves the
+ * buffered bytes to drain, and `ended` resolves when they reach a subscriber
+ * or the consumer closes the channel itself.
+ */
+import type { CaughtFailure } from '@vibesdotdev/kernel';
+import { FailureDescriber } from '../transport/failure-describer.ts';
+import type { StreamEnding } from '../wire/frame.ts';
+/** The consumer's failure for an owner's typed ending: its code and reason, nothing more. */
+export declare function streamEndingFailure(ending: StreamEnding): Error;
+export declare class ChannelEnd {
+    private readonly describer;
+    readonly ended: Promise<void>;
+    private resolveEnded;
+    private rejectEnded;
+    private eof;
+    private settled;
+    private ending;
+    /** @param describer the connection's failure describer: a disconnect's cause passes through it, never kept raw. */
+    constructor(describer?: FailureDescriber);
+    /**
+     * The owner's EOF arrived; `drained` is whether every byte before it reached a subscriber.
+     * `ending`, when the owner ended it typed, is what `ended` rejects with.
+     */
+    remoteEnded(drained: boolean, ending?: StreamEnding): void;
+    /** The first subscriber attached and received every buffered byte. */
+    flushed(): void;
+    /** The consumer closed the channel itself. */
+    closedLocally(): void;
+    /**
+     * The connection closed. Before the owner's EOF the output is incomplete; after it, nothing is lost. `cause` (a
+     * read error, say) travels on the rejection, described: its typed fields only, with every configured secret removed.
+     */
+    disconnected(cause?: CaughtFailure): void;
+    private settle;
+}
+//# sourceMappingURL=channel-end.d.ts.map

package/dist/core/protocol/lifecycle/channel-end.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-end.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/lifecycle/channel-end.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAiB,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIrD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAE/D;AAED,qBAAa,UAAU;IASV,OAAO,CAAC,QAAQ,CAAC,SAAS;IARtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAA2B;IAEzC,mHAAmH;gBACtF,SAAS,GAAE,gBAAgC;IAUxE;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAO1D,sEAAsE;IACtE,OAAO,IAAI,IAAI;IAIf,8CAA8C;IAC9C,aAAa,IAAI,IAAI;IAMrB;;;OAGG;IACH,YAAY,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI;IAOzC,OAAO,CAAC,MAAM;CAMd"}

package/dist/core/protocol/lifecycle/channel-end.js

@@ -0,0 +1,71 @@
+import { FailureDescriber, HOST_FAILURES } from "../transport/failure-describer.js";
+import { RPC_ERROR, rpcFailure } from "../wire/verbs.js";
+import { settled } from "./attempt.js";
+/** The consumer's failure for an owner's typed ending: its code and reason, nothing more. */
+export function streamEndingFailure(ending) {
+    return rpcFailure(ending.code, 'The owner ended the stream channel.', undefined, ending.reason);
+}
+export class ChannelEnd {
+    describer;
+    ended;
+    resolveEnded;
+    rejectEnded;
+    eof = false;
+    settled = false;
+    ending;
+    /** @param describer the connection's failure describer: a disconnect's cause passes through it, never kept raw. */
+    constructor(describer = HOST_FAILURES) {
+        this.describer = describer;
+        this.ended = new Promise((resolve, reject) => {
+            this.resolveEnded = resolve;
+            this.rejectEnded = reject;
+        });
+        // A consumer that never joins `ended` must not surface an unhandled rejection;
+        // observing it here leaves the rejection on `ended` for a consumer that joins it.
+        void settled(this.ended);
+    }
+    /**
+     * The owner's EOF arrived; `drained` is whether every byte before it reached a subscriber.
+     * `ending`, when the owner ended it typed, is what `ended` rejects with.
+     */
+    remoteEnded(drained, ending) {
+        if (this.eof || this.settled)
+            return;
+        this.eof = true;
+        this.ending = ending;
+        if (drained)
+            this.settle();
+    }
+    /** The first subscriber attached and received every buffered byte. */
+    flushed() {
+        if (this.eof)
+            this.settle();
+    }
+    /** The consumer closed the channel itself. */
+    closedLocally() {
+        // The consumer chose to stop: its own close resolves, whatever the owner's ending was.
+        this.ending = undefined;
+        this.settle();
+    }
+    /**
+     * The connection closed. Before the owner's EOF the output is incomplete; after it, nothing is lost. `cause` (a
+     * read error, say) travels on the rejection, described: its typed fields only, with every configured secret removed.
+     */
+    disconnected(cause) {
+        if (this.settled || this.eof)
+            return;
+        this.settled = true;
+        const failure = rpcFailure(RPC_ERROR.DISCONNECTED, 'The connection closed before the channel ended.');
+        this.rejectEnded(cause === undefined ? failure : Object.assign(failure, { cause: this.describer.describe(cause) }));
+    }
+    settle() {
+        if (this.settled)
+            return;
+        this.settled = true;
+        if (this.ending)
+            this.rejectEnded(streamEndingFailure(this.ending));
+        else
+            this.resolveEnded();
+    }
+}
+//# sourceMappingURL=channel-end.js.map

package/dist/core/protocol/lifecycle/channel-end.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-end.js","sourceRoot":"","sources":["../../../../src/core/protocol/lifecycle/channel-end.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEpF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACvD,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,qCAAqC,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,OAAO,UAAU;IASO;IARpB,KAAK,CAAgB;IACtB,YAAY,CAAc;IAC1B,WAAW,CAA0B;IACrC,GAAG,GAAG,KAAK,CAAC;IACZ,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,CAA2B;IAEzC,mHAAmH;IACnH,YAA6B,YAA8B,aAAa;QAA3C,cAAS,GAAT,SAAS,CAAkC;QACvE,IAAI,CAAC,KAAK,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAClD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;YAC5B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,+EAA+E;QAC/E,kFAAkF;QAClF,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,OAAgB,EAAE,MAAqB;QAClD,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACrC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,OAAO;YAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,sEAAsE;IACtE,OAAO;QACN,IAAI,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED,8CAA8C;IAC9C,aAAa;QACZ,uFAAuF;QACvF,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,MAAM,EAAE,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAAqB;QACjC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,YAAY,EAAE,iDAAiD,CAAC,CAAC;QACtG,IAAI,CAAC,WAAW,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACrH,CAAC;IAEO,MAAM;QACb,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;;YAC/D,IAAI,CAAC,YAAY,EAAE,CAAC;IAC1B,CAAC;CACD"}

package/dist/core/protocol/lifecycle/connect-attempt.d.ts

@@ -0,0 +1,12 @@
+import { CapabilityError, type CaughtFailure } from '@vibesdotdev/kernel';
+import type { RpcConnectAttempt } from "../../../schemas/contracts/protocol/lifecycle/connector.ts";
+/** Whether `error` is the lifecycle's own deadline (`TIMEOUT` `wait-timeout`). */
+export declare function isLifecycleDeadline(error: CaughtFailure): error is CapabilityError;
+/**
+ * Run one connect attempt under the owning runtime's lifecycle. Resolves the
+ * dialed connection; rejects with the dial's own failure, the transport's typed
+ * deadline (or the lifecycle's `TIMEOUT` `wait-timeout`), or `CANCELLED`
+ * `wait-aborted` when the caller or the runtime cancelled it.
+ */
+export declare function attemptRpcConnect<T>(attempt: RpcConnectAttempt<T>): Promise<T>;
+//# sourceMappingURL=connect-attempt.d.ts.map

package/dist/core/protocol/lifecycle/connect-attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-attempt.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/lifecycle/connect-attempt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAqB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4DAA4D,CAAC;AAGpG,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,eAAe,CAElF;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBpF"}