@aria-cli/tools 1.0.0

package/dist-cjs/network-runtime/address-types.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DurableSubmitResultSchema = exports.DurableDeliveryResultSchema = exports.DurableDeliveryHandleSchema = exports.LocalRuntimeSummarySchema = exports.NodeAdvertisementSchema = exports.ControlEndpointAdvertisementSchema = exports.InboxAddressSchema = exports.TransportEndpointAdvertisementSchema = exports.SigningPublicKeySchema = exports.LoopbackTlsIdentitySchema = exports.TlsCaFingerprintSchema = exports.PeerTransportIdSchema = exports.PrincipalFingerprintSchema = exports.ClientIdSchema = exports.RuntimeOwnerRecordSchema = exports.DeliveryLifecycleRevisionSchema = exports.OwnerGenerationSchema = exports.RevocationDecisionSchema = exports.RevocationOperatorConfirmationSchema = exports.RevocationGenerationSchema = exports.BindingGenerationSchema = exports.EndpointRevisionSchema = exports.PublicationRevisionSchema = exports.NodeMetadataSchema = exports.RuntimeIdSchema = exports.NodeIdSchema = void 0;
+const zod_1 = require("zod");
+const NonEmptyStringSchema = zod_1.z.string().trim().min(1);
+/**
+ * Stable durable identity for a node.
+ * Semantic rules are enforced by the runtime cutover plan; the contract layer
+ * starts by making the shape canonical everywhere.
+ */
+exports.NodeIdSchema = NonEmptyStringSchema.brand();
+/** One boot of a given node runtime. */
+exports.RuntimeIdSchema = NonEmptyStringSchema.brand();
+exports.NodeMetadataSchema = zod_1.z.object({
+    nodeId: exports.NodeIdSchema,
+    createdAt: NonEmptyStringSchema,
+    schemaVersion: zod_1.z.number().int().positive(),
+    migratedFromLegacy: zod_1.z.boolean(),
+});
+/** Monotonic publication revision for externally visible runtime advertisements. */
+exports.PublicationRevisionSchema = zod_1.z.number().int().nonnegative();
+/** Monotonic endpoint revision for register/discovery refreshes. */
+exports.EndpointRevisionSchema = zod_1.z.number().int().nonnegative();
+/** Monotonic generation for peer-binding continuity transitions. */
+exports.BindingGenerationSchema = zod_1.z.number().int().nonnegative();
+/** Monotonic generation for revocation precedence and continuity conflict checks. */
+exports.RevocationGenerationSchema = zod_1.z.number().int().nonnegative();
+/** How a local operator confirmed a revocation decision. */
+exports.RevocationOperatorConfirmationSchema = zod_1.z.enum([
+    "local_operator_confirmed",
+    "remote_capability_authenticated",
+]);
+/** Structured local authority record for a peer revocation decision. */
+exports.RevocationDecisionSchema = zod_1.z.object({
+    localNodeId: exports.NodeIdSchema,
+    targetNodeId: exports.NodeIdSchema,
+    revocationGeneration: exports.RevocationGenerationSchema,
+    operatorConfirmation: exports.RevocationOperatorConfirmationSchema,
+});
+/** Monotonic owner generation for runtime ownership records. */
+exports.OwnerGenerationSchema = zod_1.z.number().int().positive();
+/** Monotonic revision for durable delivery lifecycle state transitions. */
+exports.DeliveryLifecycleRevisionSchema = zod_1.z.number().int().nonnegative();
+exports.RuntimeOwnerRecordSchema = zod_1.z
+    .object({
+    schemaVersion: zod_1.z.number().int().positive(),
+    nodeId: exports.NodeIdSchema,
+    ariaHome: NonEmptyStringSchema,
+    runtimePid: zod_1.z.number().int().positive(),
+    runtimeId: exports.RuntimeIdSchema,
+    displayNameSnapshot: NonEmptyStringSchema.optional(),
+    runtimeSocket: NonEmptyStringSchema,
+    startedAt: NonEmptyStringSchema,
+    lastHeartbeat: NonEmptyStringSchema,
+    ownerGeneration: exports.OwnerGenerationSchema,
+})
+    .strict();
+/** One attached local client of the runtime. */
+exports.ClientIdSchema = NonEmptyStringSchema.brand();
+/** Durable principal fingerprint (SHA-256 hex of signing public key DER). Signing-key evidence only. */
+exports.PrincipalFingerprintSchema = NonEmptyStringSchema.brand();
+/** Transport public key / transport identity for a peer. */
+exports.PeerTransportIdSchema = NonEmptyStringSchema.brand();
+/** TLS CA certificate fingerprint (SHA-256 hex of CA cert DER). Certificate-authority evidence only — distinct from signing-key evidence. */
+exports.TlsCaFingerprintSchema = NonEmptyStringSchema.brand();
+/** Local-only loopback TLS SAN identity used for same-machine control attachment. */
+exports.LoopbackTlsIdentitySchema = NonEmptyStringSchema.brand();
+/** Base64-encoded signing public key material crossing runtime/shared boundaries. */
+exports.SigningPublicKeySchema = NonEmptyStringSchema.brand();
+/** Explicit network transport endpoint advertisement. */
+exports.TransportEndpointAdvertisementSchema = zod_1.z.object({
+    host: NonEmptyStringSchema,
+    port: zod_1.z.number().int().min(1).max(65535),
+});
+/**
+ * Runtime-owned local inbox addressing.
+ * Same-machine clients are local attachments, not mesh peers.
+ */
+exports.InboxAddressSchema = zod_1.z.discriminatedUnion("kind", [
+    zod_1.z.object({
+        kind: zod_1.z.literal("node"),
+        nodeId: exports.NodeIdSchema,
+    }),
+    zod_1.z.object({
+        kind: zod_1.z.literal("client"),
+        clientId: exports.ClientIdSchema,
+    }),
+]);
+/**
+ * Public control-plane endpoint advertisement used by peers for pinned,
+ * mutating requests.
+ */
+exports.ControlEndpointAdvertisementSchema = zod_1.z.object({
+    host: NonEmptyStringSchema,
+    port: zod_1.z.number().int().min(1).max(65535),
+    tlsCaFingerprint: exports.TlsCaFingerprintSchema,
+    tlsServerIdentity: exports.PrincipalFingerprintSchema,
+    protocolVersion: zod_1.z.number().int().positive(),
+    endpointRevision: exports.EndpointRevisionSchema.optional(),
+});
+/**
+ * Remote/public node advertisement. This deliberately excludes local-only
+ * runtime/session identity like RuntimeId.
+ */
+exports.NodeAdvertisementSchema = zod_1.z.object({
+    nodeId: exports.NodeIdSchema,
+    principalFingerprint: exports.PrincipalFingerprintSchema,
+    transportPublicKey: exports.PeerTransportIdSchema,
+    publicationRevision: exports.PublicationRevisionSchema.optional(),
+    controlEndpoint: exports.ControlEndpointAdvertisementSchema.optional(),
+    displayNameSnapshot: NonEmptyStringSchema.optional(),
+});
+/**
+ * Local-only runtime registry summary. This is not a remote/public mesh
+ * contract and may include RuntimeId.
+ */
+exports.LocalRuntimeSummarySchema = zod_1.z.object({
+    nodeId: exports.NodeIdSchema,
+    runtimeId: exports.RuntimeIdSchema,
+    lastHeartbeat: NonEmptyStringSchema.optional(),
+    controlEndpoint: exports.ControlEndpointAdvertisementSchema.optional(),
+    displayNameSnapshot: NonEmptyStringSchema.optional(),
+});
+// ── Durable Delivery Handle ────────────────────────────────────────
+/**
+ * Branded operation handle for durable delivery.
+ * Produced ONLY by `submitDurable()` — the caller never mints handles.
+ */
+exports.DurableDeliveryHandleSchema = NonEmptyStringSchema.brand();
+/**
+ * Terminal status types for a durable delivery operation.
+ */
+exports.DurableDeliveryResultSchema = zod_1.z.discriminatedUnion("status", [
+    zod_1.z.object({
+        status: zod_1.z.literal("pending"),
+        queuedAt: zod_1.z.string(),
+        nextAttemptAt: zod_1.z.string().optional(),
+        attemptCount: zod_1.z.number(),
+    }),
+    zod_1.z.object({
+        status: zod_1.z.literal("delivered"),
+        deliveredAt: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        status: zod_1.z.literal("expired"),
+        reason: zod_1.z.literal("ttl_exceeded"),
+        queuedAt: zod_1.z.string(),
+        expiredAt: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        status: zod_1.z.literal("rejected"),
+        reason: zod_1.z.enum(["recipient_revoked", "recipient_unknown", "envelope_invalid"]),
+    }),
+]);
+/**
+ * Submit result — returned immediately from `submitDurable()`.
+ */
+exports.DurableSubmitResultSchema = zod_1.z.discriminatedUnion("status", [
+    zod_1.z.object({
+        status: zod_1.z.literal("accepted"),
+        operationId: exports.DurableDeliveryHandleSchema,
+        queuedAt: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        status: zod_1.z.literal("rejected"),
+        reason: zod_1.z.enum(["recipient_revoked", "recipient_unknown", "envelope_invalid"]),
+    }),
+]);
+//# sourceMappingURL=address-types.js.map

package/dist-cjs/network-runtime/address-types.js.map

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

package/dist-cjs/network-runtime/db-owner-fencing.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shared database-level ownership fencing for runtime-owned durable stores.
+ *
+ * All stores backed by the same SQLite database share one `owner_epoch` table.
+ * The runtime claims the epoch once at startup. Each store's write methods
+ * call `assertDbOwnership()` before durable mutations.
+ *
+ * A zombie runtime whose generation is stale gets StaleOwnerError on
+ * its next write — no external kill needed.
+ */
+interface SqliteStatementLike {
+    run(...params: unknown[]): {
+        changes: number;
+    };
+    get(...params: unknown[]): unknown;
+}
+export interface OwnerEpochDb {
+    exec(sql: string): unknown;
+    prepare(sql: string): SqliteStatementLike;
+}
+export declare class StaleOwnerError extends Error {
+    readonly kind: "StaleOwnerError";
+    readonly claimedGeneration: number;
+    readonly currentGeneration: number;
+    constructor(claimed: number, current: number);
+}
+/**
+ * Ensure the owner_epoch table exists in the given database.
+ * Safe to call multiple times (idempotent).
+ */
+export declare function ensureOwnerEpochTable(db: OwnerEpochDb): void;
+/**
+ * Atomically claim the owner epoch for this runtime.
+ * Throws StaleOwnerError if a newer generation already owns the database.
+ */
+export declare function claimDbOwnerEpoch(db: OwnerEpochDb, generation: number): void;
+/**
+ * Assert the calling runtime is still the current owner of this database.
+ * Must be called inside the same SQLite transaction as the write.
+ * Throws StaleOwnerError if superseded.
+ */
+export declare function assertDbOwnership(db: OwnerEpochDb, generation: number): void;
+export {};

package/dist-cjs/network-runtime/db-owner-fencing.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Shared database-level ownership fencing for runtime-owned durable stores.
+ *
+ * All stores backed by the same SQLite database share one `owner_epoch` table.
+ * The runtime claims the epoch once at startup. Each store's write methods
+ * call `assertDbOwnership()` before durable mutations.
+ *
+ * A zombie runtime whose generation is stale gets StaleOwnerError on
+ * its next write — no external kill needed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StaleOwnerError = void 0;
+exports.ensureOwnerEpochTable = ensureOwnerEpochTable;
+exports.claimDbOwnerEpoch = claimDbOwnerEpoch;
+exports.assertDbOwnership = assertDbOwnership;
+class StaleOwnerError extends Error {
+    kind = "StaleOwnerError";
+    claimedGeneration;
+    currentGeneration;
+    constructor(claimed, current) {
+        super(`StaleOwnerError: runtime claims generation ${claimed} but store is at generation ${current}. ` +
+            `This runtime has been superseded and must shut down immediately.`);
+        this.name = "StaleOwnerError";
+        this.claimedGeneration = claimed;
+        this.currentGeneration = current;
+    }
+}
+exports.StaleOwnerError = StaleOwnerError;
+/**
+ * Ensure the owner_epoch table exists in the given database.
+ * Safe to call multiple times (idempotent).
+ */
+function ensureOwnerEpochTable(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS owner_epoch (
+      scope TEXT PRIMARY KEY DEFAULT 'runtime',
+      owner_generation INTEGER NOT NULL
+    )
+  `);
+}
+/**
+ * Atomically claim the owner epoch for this runtime.
+ * Throws StaleOwnerError if a newer generation already owns the database.
+ */
+function claimDbOwnerEpoch(db, generation) {
+    ensureOwnerEpochTable(db);
+    const result = db
+        .prepare(`INSERT INTO owner_epoch (scope, owner_generation) VALUES ('runtime', ?)
+       ON CONFLICT(scope) DO UPDATE SET owner_generation = excluded.owner_generation
+       WHERE excluded.owner_generation > owner_epoch.owner_generation`)
+        .run(generation);
+    if (result.changes === 0) {
+        const row = db
+            .prepare("SELECT owner_generation FROM owner_epoch WHERE scope = 'runtime'")
+            .get();
+        const current = row?.owner_generation ?? 0;
+        if (current > generation) {
+            throw new StaleOwnerError(generation, current);
+        }
+    }
+}
+/**
+ * Assert the calling runtime is still the current owner of this database.
+ * Must be called inside the same SQLite transaction as the write.
+ * Throws StaleOwnerError if superseded.
+ */
+function assertDbOwnership(db, generation) {
+    const row = db
+        .prepare("SELECT owner_generation FROM owner_epoch WHERE scope = 'runtime'")
+        .get();
+    const current = row?.owner_generation ?? 0;
+    if (current > generation) {
+        throw new StaleOwnerError(generation, current);
+    }
+}
+//# sourceMappingURL=db-owner-fencing.js.map

package/dist-cjs/network-runtime/db-owner-fencing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-owner-fencing.js","sourceRoot":"","sources":["../../src/network-runtime/db-owner-fencing.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAgCH,sDAOC;AAMD,8CAoBC;AAOD,8CASC;AArED,MAAa,eAAgB,SAAQ,KAAK;IAC/B,IAAI,GAAG,iBAA0B,CAAC;IAClC,iBAAiB,CAAS;IAC1B,iBAAiB,CAAS;IAEnC,YAAY,OAAe,EAAE,OAAe;QAC1C,KAAK,CACH,8CAA8C,OAAO,+BAA+B,OAAO,IAAI;YAC7F,kEAAkE,CACrE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC;QACjC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC;IACnC,CAAC;CACF;AAdD,0CAcC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,EAAgB;IACpD,EAAE,CAAC,IAAI,CAAC;;;;;GAKP,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,EAAgB,EAAE,UAAkB;IACpE,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,EAAE;SACd,OAAO,CACN;;sEAEgE,CACjE;SACA,GAAG,CAAC,UAAU,CAAC,CAAC;IAEnB,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,EAAE;aACX,OAAO,CAAC,kEAAkE,CAAC;aAC3E,GAAG,EAA8C,CAAC;QACrD,MAAM,OAAO,GAAG,GAAG,EAAE,gBAAgB,IAAI,CAAC,CAAC;QAC3C,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;YACzB,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,EAAgB,EAAE,UAAkB;IACpE,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,kEAAkE,CAAC;SAC3E,GAAG,EAA8C,CAAC;IAErD,MAAM,OAAO,GAAG,GAAG,EAAE,gBAAgB,IAAI,CAAC,CAAC;IAC3C,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist-cjs/network-runtime/delivery-receipts.d.ts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+export declare const RuntimeTransportSchema: z.ZodEnum<{
+    in_process: "in_process";
+    local_runtime: "local_runtime";
+    tunnel: "tunnel";
+    relay: "relay";
+}>;
+export type RuntimeTransport = z.infer<typeof RuntimeTransportSchema>;
+export declare const DeliveryStateSchema: z.ZodEnum<{
+    expired: "expired";
+    rejected: "rejected";
+    accepted: "accepted";
+    queued_for_route: "queued_for_route";
+    dispatching: "dispatching";
+    sent: "sent";
+    acked: "acked";
+    failed: "failed";
+}>;
+export type DeliveryState = z.infer<typeof DeliveryStateSchema>;
+export declare const SessionStateSchema: z.ZodEnum<{
+    none: "none";
+    handshaking: "handshaking";
+    connected: "connected";
+    reconnecting: "reconnecting";
+    dead: "dead";
+}>;
+export type SessionState = z.infer<typeof SessionStateSchema>;
+export declare const DeliveryReadinessSchema: z.ZodEnum<{
+    cannot_address: "cannot_address";
+    can_queue_only: "can_queue_only";
+    can_send_now: "can_send_now";
+}>;
+export type DeliveryReadiness = z.infer<typeof DeliveryReadinessSchema>;
+export declare const QueuedReasonSchema: z.ZodEnum<{
+    route_not_established: "route_not_established";
+    awaiting_remote_ack: "awaiting_remote_ack";
+    transport_unavailable: "transport_unavailable";
+}>;
+export type QueuedReason = z.infer<typeof QueuedReasonSchema>;
+export declare const OutboxReceiptStatusSchema: z.ZodEnum<{
+    expired: "expired";
+    queued_for_route: "queued_for_route";
+    dispatching: "dispatching";
+    acked: "acked";
+}>;
+export type OutboxReceiptStatus = z.infer<typeof OutboxReceiptStatusSchema>;
+export declare const DeliveryReceiptInputSchema: z.ZodObject<{
+    transport: z.ZodEnum<{
+        in_process: "in_process";
+        local_runtime: "local_runtime";
+        tunnel: "tunnel";
+        relay: "relay";
+    }>;
+    delivered: z.ZodBoolean;
+    queued: z.ZodBoolean;
+    accepted: z.ZodOptional<z.ZodBoolean>;
+    deliveryState: z.ZodOptional<z.ZodEnum<{
+        expired: "expired";
+        rejected: "rejected";
+        accepted: "accepted";
+        queued_for_route: "queued_for_route";
+        dispatching: "dispatching";
+        sent: "sent";
+        acked: "acked";
+        failed: "failed";
+    }>>;
+    sessionState: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        handshaking: "handshaking";
+        connected: "connected";
+        reconnecting: "reconnecting";
+        dead: "dead";
+    }>>;
+    deliveryReadiness: z.ZodOptional<z.ZodEnum<{
+        cannot_address: "cannot_address";
+        can_queue_only: "can_queue_only";
+        can_send_now: "can_send_now";
+    }>>;
+    queuedReason: z.ZodOptional<z.ZodEnum<{
+        route_not_established: "route_not_established";
+        awaiting_remote_ack: "awaiting_remote_ack";
+        transport_unavailable: "transport_unavailable";
+    }>>;
+}, z.core.$strict>;
+export type DeliveryReceiptInput = z.input<typeof DeliveryReceiptInputSchema>;
+export interface CanonicalDeliveryReceipt {
+    transport: RuntimeTransport;
+    delivered: boolean;
+    queued: boolean;
+    accepted: boolean;
+    deliveryState: DeliveryState;
+    sessionState: SessionState;
+    deliveryReadiness: DeliveryReadiness;
+    queuedReason?: QueuedReason;
+}
+export declare function canonicalizeDeliveryReceipt(input: DeliveryReceiptInput): CanonicalDeliveryReceipt;
+export declare function createAckedDeliveryReceipt(input: {
+    transport: RuntimeTransport;
+    sessionState?: SessionState;
+    deliveryReadiness?: DeliveryReadiness;
+}): CanonicalDeliveryReceipt;
+export declare function createQueuedForRouteReceipt(input: {
+    transport: RuntimeTransport;
+    sessionState?: SessionState;
+    deliveryReadiness?: DeliveryReadiness;
+}): CanonicalDeliveryReceipt;
+export declare function createDispatchingDeliveryReceipt(input: {
+    transport: RuntimeTransport;
+    sessionState?: SessionState;
+    deliveryReadiness?: DeliveryReadiness;
+}): CanonicalDeliveryReceipt;
+export declare function createSentDeliveryReceipt(input: {
+    transport: RuntimeTransport;
+    sessionState?: SessionState;
+    deliveryReadiness?: DeliveryReadiness;
+}): CanonicalDeliveryReceipt;
+export declare function canonicalizeOutboxReceiptStatus(status: string): OutboxReceiptStatus;