@aria-cli/tools 1.0.19 → 1.0.33

package/dist/network-runtime/delivery-receipts.js

@@ -0,0 +1,270 @@
+import { z } from "zod";
+export const RuntimeTransportSchema = z.enum(["in_process", "local_runtime", "tunnel", "relay"]);
+export const DeliveryStateSchema = z.enum([
+    "accepted",
+    "queued_for_route",
+    "dispatching",
+    "sent",
+    "acked",
+    "expired",
+    "failed",
+    "rejected",
+]);
+export const SessionStateSchema = z.enum([
+    "none",
+    "handshaking",
+    "connected",
+    "reconnecting",
+    "dead",
+]);
+export const DeliveryReadinessSchema = z.enum(["cannot_address", "can_queue_only", "can_send_now"]);
+export const QueuedReasonSchema = z.enum([
+    "route_not_established",
+    "awaiting_remote_ack",
+    "transport_unavailable",
+]);
+export const OutboxReceiptStatusSchema = z.enum([
+    "queued_for_route",
+    "dispatching",
+    "acked",
+    "expired",
+]);
+export const DeliveryReceiptInputSchema = z
+    .object({
+    transport: RuntimeTransportSchema,
+    delivered: z.boolean(),
+    queued: z.boolean(),
+    accepted: z.boolean().optional(),
+    deliveryState: DeliveryStateSchema.optional(),
+    sessionState: SessionStateSchema.optional(),
+    deliveryReadiness: DeliveryReadinessSchema.optional(),
+    queuedReason: QueuedReasonSchema.optional(),
+})
+    .strict();
+const DELIVERY_STATE_RESTRICTIVENESS = {
+    rejected: 0,
+    failed: 1,
+    expired: 2,
+    queued_for_route: 3,
+    dispatching: 4,
+    accepted: 5,
+    sent: 6,
+    acked: 7,
+};
+const SESSION_STATE_RESTRICTIVENESS = {
+    dead: 0,
+    none: 1,
+    handshaking: 2,
+    reconnecting: 3,
+    connected: 4,
+};
+const DELIVERY_READINESS_RESTRICTIVENESS = {
+    cannot_address: 0,
+    can_queue_only: 1,
+    can_send_now: 2,
+};
+function inferLegacyDeliveryState(input, accepted) {
+    if (!accepted) {
+        return input.deliveryState === "rejected" ? "rejected" : "failed";
+    }
+    if (input.delivered) {
+        return "acked";
+    }
+    if (input.queued) {
+        if (input.queuedReason === "awaiting_remote_ack" ||
+            input.deliveryState === "dispatching" ||
+            input.deliveryState === "sent") {
+            return "dispatching";
+        }
+        return "queued_for_route";
+    }
+    if (input.deliveryState === "expired") {
+        return "expired";
+    }
+    return "sent";
+}
+function normalizeExplicitDeliveryState(input) {
+    if (!input.deliveryState) {
+        return undefined;
+    }
+    if (input.deliveryState === "sent" &&
+        input.queued &&
+        input.queuedReason === "awaiting_remote_ack") {
+        return "dispatching";
+    }
+    return input.deliveryState;
+}
+function chooseMoreRestrictiveDeliveryState(left, right) {
+    return DELIVERY_STATE_RESTRICTIVENESS[left] <= DELIVERY_STATE_RESTRICTIVENESS[right]
+        ? left
+        : right;
+}
+function inferSessionStateFromDeliveryState(transport, deliveryState) {
+    if (transport === "local_runtime") {
+        return "none";
+    }
+    switch (deliveryState) {
+        case "queued_for_route":
+            return "handshaking";
+        case "dispatching":
+            return "connected";
+        case "failed":
+        case "rejected":
+        case "expired":
+            return "none";
+        case "acked":
+            return "connected";
+        case "accepted":
+        case "sent":
+            return "connected";
+        default:
+            return "none";
+    }
+}
+function chooseMoreRestrictiveSessionState(transport, explicit, inferred) {
+    if (transport === "local_runtime") {
+        return "none";
+    }
+    if (!explicit) {
+        return inferred;
+    }
+    return SESSION_STATE_RESTRICTIVENESS[explicit] <= SESSION_STATE_RESTRICTIVENESS[inferred]
+        ? explicit
+        : inferred;
+}
+function inferDeliveryReadinessFromState(transport, deliveryState, sessionState) {
+    if (deliveryState === "failed" || deliveryState === "rejected") {
+        return "cannot_address";
+    }
+    if (transport === "local_runtime" && deliveryState === "acked") {
+        return "can_queue_only";
+    }
+    if (deliveryState === "queued_for_route") {
+        return "can_queue_only";
+    }
+    if (deliveryState === "dispatching") {
+        return sessionState === "reconnecting" ? "can_queue_only" : "can_send_now";
+    }
+    if (deliveryState === "expired") {
+        return "cannot_address";
+    }
+    return sessionState === "connected" ? "can_send_now" : "can_queue_only";
+}
+function chooseMoreRestrictiveDeliveryReadiness(explicit, inferred) {
+    if (!explicit) {
+        return inferred;
+    }
+    return DELIVERY_READINESS_RESTRICTIVENESS[explicit] <=
+        DELIVERY_READINESS_RESTRICTIVENESS[inferred]
+        ? explicit
+        : inferred;
+}
+function deriveCanonicalAccepted(input, deliveryState) {
+    if (deliveryState === "rejected") {
+        return false;
+    }
+    return input.accepted ?? true;
+}
+function isQueuedDeliveryState(deliveryState) {
+    return deliveryState === "queued_for_route" || deliveryState === "dispatching";
+}
+function inferQueuedReason(input, deliveryState, queued) {
+    if (!queued) {
+        return undefined;
+    }
+    if (input.queuedReason) {
+        return input.queuedReason;
+    }
+    if (deliveryState === "dispatching") {
+        return "awaiting_remote_ack";
+    }
+    if (deliveryState === "queued_for_route") {
+        return "route_not_established";
+    }
+    return undefined;
+}
+export function canonicalizeDeliveryReceipt(input) {
+    const inferredDeliveryState = inferLegacyDeliveryState(input, input.accepted ?? true);
+    const explicitDeliveryState = normalizeExplicitDeliveryState(input);
+    const deliveryState = explicitDeliveryState
+        ? chooseMoreRestrictiveDeliveryState(explicitDeliveryState, inferredDeliveryState)
+        : inferredDeliveryState;
+    const accepted = deriveCanonicalAccepted(input, deliveryState);
+    const delivered = deliveryState === "acked";
+    const queued = isQueuedDeliveryState(deliveryState);
+    const inferredSessionState = inferSessionStateFromDeliveryState(input.transport, deliveryState);
+    const sessionState = chooseMoreRestrictiveSessionState(input.transport, input.sessionState, inferredSessionState);
+    const inferredDeliveryReadiness = inferDeliveryReadinessFromState(input.transport, deliveryState, sessionState);
+    const deliveryReadiness = chooseMoreRestrictiveDeliveryReadiness(input.deliveryReadiness, inferredDeliveryReadiness);
+    const queuedReason = inferQueuedReason(input, deliveryState, queued);
+    return {
+        transport: input.transport,
+        delivered,
+        queued,
+        accepted,
+        deliveryState,
+        sessionState,
+        deliveryReadiness,
+        ...(queuedReason ? { queuedReason } : {}),
+    };
+}
+export function createAckedDeliveryReceipt(input) {
+    return canonicalizeDeliveryReceipt({
+        transport: input.transport,
+        delivered: true,
+        queued: false,
+        accepted: true,
+        deliveryState: "acked",
+        ...(input.sessionState ? { sessionState: input.sessionState } : {}),
+        ...(input.deliveryReadiness ? { deliveryReadiness: input.deliveryReadiness } : {}),
+    });
+}
+export function createQueuedForRouteReceipt(input) {
+    return canonicalizeDeliveryReceipt({
+        transport: input.transport,
+        delivered: false,
+        queued: true,
+        accepted: true,
+        deliveryState: "queued_for_route",
+        queuedReason: "route_not_established",
+        ...(input.sessionState ? { sessionState: input.sessionState } : {}),
+        ...(input.deliveryReadiness ? { deliveryReadiness: input.deliveryReadiness } : {}),
+    });
+}
+export function createDispatchingDeliveryReceipt(input) {
+    return canonicalizeDeliveryReceipt({
+        transport: input.transport,
+        delivered: false,
+        queued: true,
+        accepted: true,
+        deliveryState: "dispatching",
+        queuedReason: "awaiting_remote_ack",
+        ...(input.sessionState ? { sessionState: input.sessionState } : {}),
+        ...(input.deliveryReadiness ? { deliveryReadiness: input.deliveryReadiness } : {}),
+    });
+}
+export function createSentDeliveryReceipt(input) {
+    return canonicalizeDeliveryReceipt({
+        transport: input.transport,
+        delivered: false,
+        queued: false,
+        accepted: true,
+        deliveryState: "sent",
+        ...(input.sessionState ? { sessionState: input.sessionState } : {}),
+        ...(input.deliveryReadiness ? { deliveryReadiness: input.deliveryReadiness } : {}),
+    });
+}
+export function canonicalizeOutboxReceiptStatus(status) {
+    switch (status) {
+        case "queued":
+        case "queued_for_route":
+            return "queued_for_route";
+        case "dispatching":
+        case "acked":
+        case "expired":
+            return status;
+        default:
+            throw new Error(`[delivery-receipts] Unsupported outbox status: ${status}`);
+    }
+}
+//# sourceMappingURL=delivery-receipts.js.map

package/dist/network-runtime/direct-endpoint-authority.js

@@ -0,0 +1,26 @@
+function normalizeHost(host) {
+    return host.trim().toLowerCase();
+}
+export function isLoopbackDirectEndpointHost(host) {
+    const normalized = normalizeHost(host);
+    return (normalized === "localhost" ||
+        normalized === "::1" ||
+        normalized === "[::1]" ||
+        normalized.endsWith(".localhost") ||
+        /^127\./.test(normalized));
+}
+export function canonicalizeAuthoritativeDirectEndpoint(input) {
+    const rawHost = input.endpointHost?.trim();
+    const port = input.endpointPort;
+    if (!rawHost || typeof port !== "number" || !Number.isFinite(port)) {
+        return {};
+    }
+    if (isLoopbackDirectEndpointHost(rawHost)) {
+        return {};
+    }
+    return {
+        endpointHost: rawHost,
+        endpointPort: port,
+    };
+}
+//# sourceMappingURL=direct-endpoint-authority.js.map

package/dist/network-runtime/index.js

@@ -1 +1,13 @@
-import{$,$a,A,Aa,Ab,B,Ba,Bb,C,Ca,Cb,D,Da,Db,E,Ea,Eb,F,Fa,Fb,G,Ga,Gb,H,Ha,Hb,I,Ia,Ib,J,Ja,Jb,K,Ka,Kb,L,La,Lb,M,Ma,Mb,N,Na,Nb,O,Oa,Ob,P,Pa,Pb,Q,Qa,Qb,R,Ra,Rb,S,Sa,Sb,T,Ta,Tb,U,Ua,V,Va,W,Wa,X,Xa,Y,Ya,Z,Za,_,_a,a,aa,ab,b,ba,bb,c,ca,cb,d,da,db,e,ea,eb,f,fa,fb,g,ga,gb,h,ha,hb,i,ia,ib,j,ja,jb,k,ka,kb,l,la,lb,m,ma,mb,n,na,nb,o,oa,ob,p,pa,pb,q,qa,qb,r,ra,rb,s,sa,sb,t,ta,tb,u,ua,ub,v,va,vb,w,wa,wb,x,xa,xb,y,ya,yb,z,za,zb}from"../index-e1r4t0h0.js";import"../index-tvryzx00.js";export{Ea as resolveTrustedRuntimeErrorMessage,Aa as isValidPeerTransportTransition,wa as isValidPeerStateCombination,za as isValidPeerIdentityTransition,R as isSupportedNetworkRuntimeProtocolVersion,Ob as isLoopbackDirectEndpointHost,Rb as ensureOwnerEpochTable,ya as derivePeerStateFromLegacyStatus,Fa as createTrustedRuntimeError,K as createSentDeliveryReceipt,I as createQueuedForRouteReceipt,J as createDispatchingDeliveryReceipt,H as createAckedDeliveryReceipt,Ba as comparePeerMutationPrecedence,Sb as claimDbOwnerEpoch,L as canonicalizeOutboxReceiptStatus,G as canonicalizeDeliveryReceipt,Pb as canonicalizeAuthoritativeDirectEndpoint,Jb as canRefreshEndpoint,Hb as canRecordPendingPair,Nb as canMutateTrustedState,Kb as canHeartbeat,Ib as canCommitVerifiedPair,Mb as canAttemptDurableDelivery,Lb as canAttemptBestEffortTransport,S as assertSupportedNetworkRuntimeProtocolVersion,Tb as assertDbOwnership,U as TransportInviteTokenSchema,s as TransportEndpointAdvertisementSchema,p as TlsCaFingerprintSchema,Qb as StaleOwnerError,r as SigningPublicKeySchema,ca as SignedContinuityBindSchema,C as SessionStateSchema,A as RuntimeTransportSchema,Ua as RuntimeStatusSchema,Ia as RuntimeRunEventSchema,$ as RuntimeRegisterRequestSchema,Ja as RuntimeQueuedReceiptSchema,l as RuntimeOwnerRecordSchema,Z as RuntimeNodeAdvertisementSchema,Y as RuntimeIngressEnvelopeSchema,b as RuntimeIdSchema,N as RuntimeEventSchema,M as RuntimeEventKindSchema,Ma as RuntimeEventCursorSchema,Da as RuntimeErrorDiagnosticSchema,_ as RuntimeDiscoveryAdvertisementSchema,Ka as RuntimeDeliveryReceiptSchema,Eb as RuntimeBootstrapTlsSchema,Bb as RuntimeBootstrapRevisionSchema,Gb as RuntimeBootstrapRecordSchema,Cb as RuntimeBootstrapPhaseSchema,Fb as RuntimeBootstrapIdentitySchema,Db as RuntimeBootstrapControlEndpointSchema,Ta as RuntimeAutonomousLoopStatusSchema,Sa as RuntimeAutonomousLoopSafetyPolicySummarySchema,Va as RuntimeAutonomousLoopCommandSchema,Ga as RunResultSchema,Ca as RunRequestSchema,lb as RevokePeerResponseSchema,kb as RevokePeerRequestSchema,h as RevocationOperatorConfirmationSchema,g as RevocationGenerationSchema,i as RevocationDecisionSchema,Ha as ResumeRunRequestSchema,nb as RepairPeerResponseSchema,mb as RepairPeerRequestSchema,qa as RelayPendingResponseSchema,pa as RelayPendingRequestSchema,na as RelayPendingQuerySchema,oa as RelayPendingQueryJsonSchema,E as QueuedReasonSchema,d as PublicationRevisionSchema,n as PrincipalFingerprintSchema,Pa as PersistedInboxEventSchema,Wa as PendingPairRequestViewSchema,Xa as PendingInviteViewSchema,Qa as PeerViewEventSchema,ta as PeerTransportStateSchema,o as PeerTransportIdSchema,xa as PeerStateSnapshotSchema,ua as PeerMutationKindSchema,sa as PeerIdentityStateSchema,ha as PairRequestRouteBodySchema,ia as PairRequestRouteBodyJsonSchema,Za as PairRequestResponseSchema,Ya as PairRequestDecisionSchema,la as PairRelayRouteBodySchema,ma as PairRelayRouteBodyJsonSchema,aa as PairProposalSchema,j as OwnerGenerationSchema,F as OutboxReceiptStatusSchema,La as OutboundMessageSchema,O as NodePrincipalBindingRefSchema,c as NodeMetadataSchema,a as NodeIdSchema,v as NodeAdvertisementSchema,Q as NetworkRuntimeProtocolVersionSchema,fa as NetworkRouteRevokeRequestSchema,ga as NetworkRouteRevokeRequestJsonSchema,Ra as NearbyPeerViewSchema,P as NETWORK_RUNTIME_PROTOCOL_VERSION,da as MutationOperationSchema,ea as MutationEnvelopeSchema,q as LoopbackTlsIdentitySchema,w as LocalRuntimeSummarySchema,yb as LocalControlSocketSuccessResponseSchema,Ab as LocalControlSocketResponseSchema,xb as LocalControlSocketRequestSchema,wb as LocalControlSocketMethodSchema,zb as LocalControlSocketErrorResponseSchema,vb as LocalControlSocketDetachClientResponseSchema,ub as LocalControlSocketDetachClientRequestSchema,tb as LocalControlSocketAttachClientResponseSchema,sb as LocalControlSocketAttachClientRequestSchema,ob as LocalControlClientKindSchema,va as LegacyPeerRuntimeShapeSchema,ra as LegacyPeerRegistryStatusSchema,W as JoinRouteBodySchema,X as JoinRouteBodyJsonSchema,V as JoinRequestSchema,bb as InvitePeerResultSchema,ab as InvitePeerRequestSchema,Oa as InboxListRequestSchema,Na as InboxCursorSchema,t as InboxAddressSchema,e as EndpointRevisionSchema,z as DurableSubmitResultSchema,y as DurableDeliveryResultSchema,x as DurableDeliveryHandleSchema,jb as DirectPairResponseSchema,hb as DirectPairRequestSchema,ib as DirectPairRequestJsonSchema,B as DeliveryStateSchema,D as DeliveryReadinessSchema,k as DeliveryLifecycleRevisionSchema,T as DeliveryAckSchema,$a as CreateInviteResponseSchema,_a as CreateInviteRequestSchema,u as ControlEndpointAdvertisementSchema,ba as ContinuityStatementSchema,m as ClientIdSchema,gb as CancelInviteResponseSchema,fb as CancelInviteRequestSchema,f as BindingGenerationSchema,pb as AttachedClientViewSchema,qb as AttachedClientLeaseGrantSchema,rb as AttachedClientAuthSchema,eb as AcceptInviteTokenResponseSchema,db as AcceptInviteTokenRequestSchema,cb as AcceptInviteResponseSchema,ja as AcceptInviteRequestSchema,ka as AcceptInviteRequestBodyJsonSchema};
+export { RuntimeTransportSchema, DeliveryStateSchema, SessionStateSchema, DeliveryReadinessSchema, QueuedReasonSchema, OutboxReceiptStatusSchema, canonicalizeDeliveryReceipt, canonicalizeOutboxReceiptStatus, createAckedDeliveryReceipt, createQueuedForRouteReceipt, createDispatchingDeliveryReceipt, createSentDeliveryReceipt, } from "./delivery-receipts.js";
+export { NodeIdSchema, NodeMetadataSchema, RuntimeIdSchema, PublicationRevisionSchema, EndpointRevisionSchema, BindingGenerationSchema, RevocationGenerationSchema, RevocationOperatorConfirmationSchema, RevocationDecisionSchema, OwnerGenerationSchema, DeliveryLifecycleRevisionSchema, DurableDeliveryHandleSchema, DurableDeliveryResultSchema, DurableSubmitResultSchema, ClientIdSchema, PrincipalFingerprintSchema, PeerTransportIdSchema, SigningPublicKeySchema, TlsCaFingerprintSchema, LoopbackTlsIdentitySchema, TransportEndpointAdvertisementSchema, InboxAddressSchema, ControlEndpointAdvertisementSchema, NodeAdvertisementSchema, LocalRuntimeSummarySchema, } from "./address-types.js";
+export { NodePrincipalBindingRefSchema } from "./peer-principal-ref.js";
+export { PairRequestRouteBodySchema, PairRequestRouteBodyJsonSchema, AcceptInviteRequestSchema, AcceptInviteRequestBodyJsonSchema, PairRelayRouteBodySchema, PairRelayRouteBodyJsonSchema, RelayPendingQuerySchema, RelayPendingQueryJsonSchema, RelayPendingRequestSchema, RelayPendingResponseSchema, } from "./pair-route-contract.js";
+export { RunRequestSchema, RunResultSchema, RuntimeErrorDiagnosticSchema, createTrustedRuntimeError, resolveTrustedRuntimeErrorMessage, ResumeRunRequestSchema, RuntimeRunEventSchema, RuntimeQueuedReceiptSchema, RuntimeDeliveryReceiptSchema, OutboundMessageSchema, RuntimeEventCursorSchema, InboxCursorSchema, InboxListRequestSchema, AttachedClientViewSchema, AttachedClientLeaseGrantSchema, AttachedClientAuthSchema, PersistedInboxEventSchema, PeerViewEventSchema, NearbyPeerViewSchema, RuntimeAutonomousLoopSafetyPolicySummarySchema, RuntimeAutonomousLoopStatusSchema, RuntimeAutonomousLoopCommandSchema, RuntimeStatusSchema, PendingPairRequestViewSchema, PendingInviteViewSchema, PairRequestDecisionSchema, PairRequestResponseSchema, CreateInviteRequestSchema, CreateInviteResponseSchema, InvitePeerRequestSchema, InvitePeerResultSchema, AcceptInviteResponseSchema, AcceptInviteTokenRequestSchema, AcceptInviteTokenResponseSchema, CancelInviteRequestSchema, CancelInviteResponseSchema, DirectPairRequestSchema, DirectPairRequestJsonSchema, DirectPairResponseSchema, RevokePeerRequestSchema, RevokePeerResponseSchema, RepairPeerRequestSchema, RepairPeerResponseSchema, LocalControlClientKindSchema, LocalControlSocketAttachClientRequestSchema, LocalControlSocketAttachClientResponseSchema, LocalControlSocketDetachClientRequestSchema, LocalControlSocketDetachClientResponseSchema, LocalControlSocketMethodSchema, LocalControlSocketRequestSchema, LocalControlSocketSuccessResponseSchema, LocalControlSocketErrorResponseSchema, LocalControlSocketResponseSchema, } from "./local-control-contract.js";
+export { RuntimeOwnerRecordSchema, RuntimeEventKindSchema, RuntimeEventSchema, } from "./node-store-contract.js";
+export { RuntimeBootstrapRevisionSchema, RuntimeBootstrapPhaseSchema, RuntimeBootstrapControlEndpointSchema, RuntimeBootstrapTlsSchema, RuntimeBootstrapIdentitySchema, RuntimeBootstrapRecordSchema, } from "./runtime-bootstrap-contract.js";
+export { NETWORK_RUNTIME_PROTOCOL_VERSION, NetworkRuntimeProtocolVersionSchema, DeliveryAckSchema, TransportInviteTokenSchema, JoinRequestSchema, JoinRouteBodySchema, JoinRouteBodyJsonSchema, RuntimeIngressEnvelopeSchema, RuntimeNodeAdvertisementSchema, RuntimeDiscoveryAdvertisementSchema, RuntimeRegisterRequestSchema, PairProposalSchema, ContinuityStatementSchema, SignedContinuityBindSchema, MutationOperationSchema, MutationEnvelopeSchema, NetworkRouteRevokeRequestSchema, NetworkRouteRevokeRequestJsonSchema, isSupportedNetworkRuntimeProtocolVersion, assertSupportedNetworkRuntimeProtocolVersion, } from "./protocol-schemas.js";
+export { LegacyPeerRegistryStatusSchema, PeerIdentityStateSchema, PeerTransportStateSchema, PeerMutationKindSchema, LegacyPeerRuntimeShapeSchema, PeerStateSnapshotSchema, derivePeerStateFromLegacyStatus, isValidPeerStateCombination, isValidPeerIdentityTransition, isValidPeerTransportTransition, comparePeerMutationPrecedence, } from "./peer-state-machine.js";
+export { canRecordPendingPair, canCommitVerifiedPair, canRefreshEndpoint, canHeartbeat, canAttemptBestEffortTransport, canAttemptDurableDelivery, canMutateTrustedState, } from "./peer-capabilities.js";
+export { canonicalizeAuthoritativeDirectEndpoint, isLoopbackDirectEndpointHost, } from "./direct-endpoint-authority.js";
+export { StaleOwnerError, ensureOwnerEpochTable, claimDbOwnerEpoch, assertDbOwnership, } from "./db-owner-fencing.js";
+//# sourceMappingURL=index.js.map