@aria-cli/tools 1.0.10 → 1.0.12

package/dist-cjs/network-runtime/local-control-contract.js

@@ -0,0 +1,633 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalControlSocketRequestSchema = exports.LocalControlSocketMethodSchema = exports.LocalControlSocketDetachClientResponseSchema = exports.LocalControlSocketDetachClientRequestSchema = exports.LocalControlSocketAttachClientResponseSchema = exports.LocalControlSocketAttachClientRequestSchema = exports.AttachedClientAuthSchema = exports.AttachedClientLeaseGrantSchema = exports.AttachedClientViewSchema = exports.LocalControlClientKindSchema = exports.RepairPeerResponseSchema = exports.RepairPeerRequestSchema = exports.RevokePeerResponseSchema = exports.RevokePeerRequestSchema = exports.DirectPairResponseSchema = exports.DirectPairRequestJsonSchema = exports.DirectPairRequestSchema = exports.CancelInviteResponseSchema = exports.CancelInviteRequestSchema = exports.AcceptInviteTokenResponseSchema = exports.AcceptInviteTokenRequestSchema = exports.AcceptInviteResponseSchema = exports.InvitePeerResultSchema = exports.PairingProofStateSchema = exports.InvitePeerRequestSchema = exports.CreateInviteResponseSchema = exports.CreateInviteRequestSchema = exports.PairRequestResponseSchema = exports.PairRequestDecisionSchema = exports.PendingInviteViewSchema = exports.PendingPairRequestViewSchema = exports.RuntimeAutonomousLoopCommandSchema = exports.RuntimeStatusSchema = exports.RuntimeAutonomousLoopStatusSchema = exports.RuntimeAutonomousLoopSafetyPolicySummarySchema = exports.NearbyPeerViewSchema = exports.PeerViewEventSchema = exports.PersistedInboxEventSchema = exports.InboxListRequestSchema = exports.InboxCursorSchema = exports.RuntimeEventCursorSchema = exports.OutboundMessageSchema = exports.RuntimeDeliveryReceiptSchema = exports.RuntimeQueuedReceiptSchema = exports.RuntimeRunEventSchema = exports.ResumeRunRequestSchema = exports.RunResultSchema = exports.RuntimeErrorDiagnosticSchema = exports.RunRequestSchema = exports.AcceptInviteRequestSchema = void 0;
+exports.LocalControlSocketResponseSchema = exports.LocalControlSocketErrorResponseSchema = exports.LocalControlSocketSuccessResponseSchema = void 0;
+exports.resolveTrustedRuntimeErrorMessage = resolveTrustedRuntimeErrorMessage;
+exports.createTrustedRuntimeError = createTrustedRuntimeError;
+const zod_1 = require("zod");
+const address_types_js_1 = require("./address-types.js");
+const delivery_receipts_js_1 = require("./delivery-receipts.js");
+const pair_route_contract_js_1 = require("./pair-route-contract.js");
+Object.defineProperty(exports, "AcceptInviteRequestSchema", { enumerable: true, get: function () { return pair_route_contract_js_1.AcceptInviteRequestSchema; } });
+const peer_state_machine_js_1 = require("./peer-state-machine.js");
+const NonEmptyStringSchema = zod_1.z.string().trim().min(1);
+const AutonomySchema = zod_1.z.enum(["minimal", "balanced", "high", "full"]);
+const ToolNameListSchema = zod_1.z.array(zod_1.z.string()).optional();
+const MessageHistorySchema = zod_1.z.array(zod_1.z.custom()).optional();
+function toFastifyBodyJsonSchema(schema) {
+    const jsonSchema = zod_1.z.toJSONSchema(schema);
+    delete jsonSchema.$schema;
+    return jsonSchema;
+}
+exports.RunRequestSchema = zod_1.z
+    .object({
+    task: NonEmptyStringSchema,
+    arion: NonEmptyStringSchema.optional(),
+    cwd: NonEmptyStringSchema.optional(),
+    history: MessageHistorySchema,
+    requestedModel: NonEmptyStringSchema.optional(),
+    preferredTier: zod_1.z.enum(["fast", "balanced", "powerful", "ensemble"]).optional(),
+    budget: zod_1.z.number().positive().optional(),
+    maxTurns: zod_1.z.number().int().positive().optional(),
+    autonomy: AutonomySchema.optional(),
+    allowedTools: ToolNameListSchema,
+    deniedTools: ToolNameListSchema,
+    noMemory: zod_1.z.boolean().optional(),
+    systemPrompt: zod_1.z.string().optional(),
+    approvalMode: zod_1.z.enum(["pause", "approve", "deny"]).optional(),
+    askUserAnswers: zod_1.z.array(zod_1.z.string()).optional(),
+})
+    .strict();
+exports.RuntimeErrorDiagnosticSchema = zod_1.z.lazy(() => zod_1.z
+    .object({
+    message: zod_1.z.string(),
+    name: zod_1.z.string().optional(),
+    stack: zod_1.z.string().optional(),
+    cause: exports.RuntimeErrorDiagnosticSchema.optional(),
+})
+    .catchall(zod_1.z.unknown()));
+function extractRuntimeDiagnosticMessage(diagnostic) {
+    if (!diagnostic || typeof diagnostic !== "object") {
+        return undefined;
+    }
+    const message = diagnostic.message;
+    if (typeof message !== "string") {
+        return undefined;
+    }
+    const trimmed = message.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function isGenericTrustedRuntimeMessage(message) {
+    const normalized = message.trim().toLowerCase();
+    return (normalized === "internal server error" ||
+        normalized.startsWith("internal server error:") ||
+        normalized.startsWith("http 500"));
+}
+function resolveTrustedRuntimeErrorMessage(message, diagnostic) {
+    const fallback = typeof message === "string" && message.trim().length > 0 ? message : undefined;
+    const diagnosticMessage = extractRuntimeDiagnosticMessage(diagnostic);
+    if (!diagnosticMessage) {
+        return fallback;
+    }
+    if (!fallback || isGenericTrustedRuntimeMessage(fallback)) {
+        return diagnosticMessage;
+    }
+    return fallback;
+}
+function createTrustedRuntimeError(message, diagnostic) {
+    const resolvedMessage = resolveTrustedRuntimeErrorMessage(message, diagnostic) ?? "Trusted runtime error";
+    return Object.assign(new Error(resolvedMessage), {
+        ...(diagnostic === undefined ? {} : { diagnostic }),
+        ...(typeof message === "string" && message.trim().length > 0 && message !== resolvedMessage
+            ? { publicMessage: message }
+            : {}),
+    });
+}
+exports.RunResultSchema = zod_1.z
+    .object({
+    success: zod_1.z.boolean(),
+    output: zod_1.z.string().optional(),
+    messages: zod_1.z.array(zod_1.z.unknown()).optional(),
+    toolCalls: zod_1.z.array(zod_1.z.unknown()).optional(),
+    usage: zod_1.z.unknown().optional(),
+    turnCount: zod_1.z.number().int().nonnegative().optional(),
+    thinking: zod_1.z.array(zod_1.z.unknown()).optional(),
+    nativeToolResults: zod_1.z.array(zod_1.z.unknown()).optional(),
+    traces: zod_1.z.array(zod_1.z.unknown()).optional(),
+    pipelineTiming: zod_1.z.unknown().optional(),
+    guardrailEvents: zod_1.z.array(zod_1.z.unknown()).optional(),
+    handoffs: zod_1.z.array(zod_1.z.unknown()).optional(),
+    state: zod_1.z.unknown().optional(),
+    error: zod_1.z.string().optional(),
+    diagnostic: exports.RuntimeErrorDiagnosticSchema.optional(),
+})
+    .strict();
+exports.ResumeRunRequestSchema = zod_1.z
+    .object({
+    state: zod_1.z.unknown(),
+    arion: NonEmptyStringSchema.optional(),
+    cwd: NonEmptyStringSchema.optional(),
+    requestedModel: NonEmptyStringSchema.optional(),
+    preferredTier: zod_1.z.enum(["fast", "balanced", "powerful", "ensemble"]).optional(),
+    budget: zod_1.z.number().positive().optional(),
+    maxTurns: zod_1.z.number().int().positive().optional(),
+    autonomy: AutonomySchema.optional(),
+    allowedTools: ToolNameListSchema,
+    deniedTools: ToolNameListSchema,
+    noMemory: zod_1.z.boolean().optional(),
+    systemPrompt: zod_1.z.string().optional(),
+    approvalMode: zod_1.z.enum(["pause", "approve", "deny"]).optional(),
+    askUserAnswers: zod_1.z.array(zod_1.z.string()).optional(),
+})
+    .strict();
+exports.RuntimeRunEventSchema = zod_1.z.discriminatedUnion("type", [
+    zod_1.z.object({
+        type: zod_1.z.literal("text_delta"),
+        content: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("tool_start"),
+        id: NonEmptyStringSchema,
+        name: NonEmptyStringSchema,
+        input: zod_1.z.unknown().optional(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("approval_needed"),
+        toolName: NonEmptyStringSchema,
+        toolInput: zod_1.z.unknown().optional(),
+        riskLevel: zod_1.z.string().optional(),
+        issues: zod_1.z.array(zod_1.z.string()).optional(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("tool_result"),
+        id: NonEmptyStringSchema,
+        name: NonEmptyStringSchema,
+        durationMs: zod_1.z.number().nonnegative(),
+        result: zod_1.z.unknown(),
+        input: zod_1.z.unknown().optional(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("usage_update"),
+        usage: zod_1.z.unknown(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("turn_complete"),
+        turnNumber: zod_1.z.number().int().nonnegative(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("guardrail_rejected"),
+        stage: zod_1.z.enum(["input", "output"]),
+        message: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("pipeline_timing"),
+        report: zod_1.z.unknown(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("messages_snapshot"),
+        messages: zod_1.z.array(zod_1.z.unknown()),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("error"),
+        error: zod_1.z.object({
+            message: zod_1.z.string(),
+            diagnostic: exports.RuntimeErrorDiagnosticSchema.optional(),
+        }),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("native_tool_result"),
+        metadata: zod_1.z.unknown(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("thinking_start"),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("thinking_delta"),
+        content: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("thinking_end"),
+        blocks: zod_1.z.array(zod_1.z.unknown()),
+        durationMs: zod_1.z.number().nonnegative(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("tool_args_delta"),
+        id: NonEmptyStringSchema,
+        args: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("span_start"),
+        spanId: NonEmptyStringSchema,
+        spanType: NonEmptyStringSchema,
+        name: NonEmptyStringSchema,
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("span_end"),
+        spanId: NonEmptyStringSchema,
+        durationMs: zod_1.z.number().nonnegative(),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("handoff_start"),
+        target: NonEmptyStringSchema,
+        id: NonEmptyStringSchema,
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("handoff_result"),
+        target: NonEmptyStringSchema,
+        result: zod_1.z.string(),
+        id: NonEmptyStringSchema,
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal("paused"),
+        state: zod_1.z.unknown(),
+    }),
+]);
+exports.RuntimeQueuedReceiptSchema = zod_1.z
+    .object(delivery_receipts_js_1.DeliveryReceiptInputSchema.shape)
+    .strict()
+    .transform((receipt) => (0, delivery_receipts_js_1.canonicalizeDeliveryReceipt)(receipt));
+exports.RuntimeDeliveryReceiptSchema = zod_1.z
+    .object({
+    transport: delivery_receipts_js_1.RuntimeTransportSchema,
+    delivered: zod_1.z.boolean(),
+    queued: zod_1.z.boolean(),
+    accepted: zod_1.z.boolean().optional(),
+    deliveryState: delivery_receipts_js_1.DeliveryStateSchema.optional(),
+    sessionState: delivery_receipts_js_1.SessionStateSchema.optional(),
+    deliveryReadiness: delivery_receipts_js_1.DeliveryReadinessSchema.optional(),
+    queuedReason: delivery_receipts_js_1.QueuedReasonSchema.optional(),
+    storedAt: zod_1.z.number().int().nonnegative().optional(),
+})
+    .strict()
+    .transform(({ storedAt, ...receipt }) => ({
+    ...(0, delivery_receipts_js_1.canonicalizeDeliveryReceipt)(receipt),
+    ...(storedAt !== undefined ? { storedAt } : {}),
+}));
+exports.OutboundMessageSchema = zod_1.z
+    .object({
+    rawMessage: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    recipientInbox: address_types_js_1.InboxAddressSchema.optional(),
+    to: NonEmptyStringSchema.optional(),
+    content: zod_1.z.string().optional(),
+    type: NonEmptyStringSchema.optional(),
+    priority: zod_1.z.number().int().optional(),
+    correlationId: zod_1.z.string().optional(),
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+})
+    .strict()
+    .superRefine((message, ctx) => {
+    if (!message.recipientInbox || message.to === undefined) {
+        return;
+    }
+    if (message.recipientInbox.kind === "client") {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: 'OutboundMessage.to is a compatibility alias for node recipients only; omit it for recipientInbox.kind === "client"',
+            path: ["to"],
+        });
+        return;
+    }
+    if (message.recipientInbox.nodeId !== message.to) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "OutboundMessage.recipientInbox.nodeId must match OutboundMessage.to when both are provided",
+            path: ["to"],
+        });
+    }
+});
+exports.RuntimeEventCursorSchema = zod_1.z
+    .object({
+    afterRevision: zod_1.z.number().int().nonnegative().optional(),
+})
+    .strict();
+exports.InboxCursorSchema = zod_1.z
+    .object({
+    afterCreatedAt: zod_1.z.number().int().nonnegative().optional(),
+})
+    .strict();
+exports.InboxListRequestSchema = zod_1.z
+    .object({
+    cursor: exports.InboxCursorSchema.optional(),
+    limit: zod_1.z.number().int().positive().max(1000).optional(),
+    unreadOnly: zod_1.z.boolean().optional(),
+})
+    .strict();
+exports.PersistedInboxEventSchema = zod_1.z
+    .object({
+    id: NonEmptyStringSchema,
+    senderNodeId: address_types_js_1.NodeIdSchema,
+    senderDisplayNameSnapshot: NonEmptyStringSchema.optional(),
+    senderType: NonEmptyStringSchema.optional(),
+    senderClientId: zod_1.z.string().nullable().optional(),
+    recipientClientId: zod_1.z.string().nullable().optional(),
+    inboxAddress: address_types_js_1.InboxAddressSchema,
+    type: NonEmptyStringSchema,
+    content: zod_1.z.string(),
+    priority: zod_1.z.number().int(),
+    createdAt: zod_1.z.number().int().nonnegative(),
+    correlationId: zod_1.z.string().nullable().optional(),
+    replyTo: zod_1.z.string().nullable().optional(),
+})
+    .strict();
+exports.PeerViewEventSchema = zod_1.z
+    .object({
+    nodeId: address_types_js_1.NodeIdSchema,
+    transportPublicKey: address_types_js_1.PeerTransportIdSchema,
+    displayNameSnapshot: NonEmptyStringSchema.optional(),
+    identityState: peer_state_machine_js_1.PeerIdentityStateSchema,
+    transportState: peer_state_machine_js_1.PeerTransportStateSchema,
+    endpointRevision: address_types_js_1.EndpointRevisionSchema,
+    updatedAt: zod_1.z.string(),
+    lastSeenAt: zod_1.z.string().optional(),
+})
+    .strict();
+exports.NearbyPeerViewSchema = zod_1.z
+    .object({
+    displayNameSnapshot: NonEmptyStringSchema,
+    nodeId: address_types_js_1.NodeIdSchema,
+    host: NonEmptyStringSchema,
+    port: zod_1.z.number().int().min(1).max(65535),
+    principalFingerprint: address_types_js_1.PrincipalFingerprintSchema,
+    version: NonEmptyStringSchema,
+    tlsCaFingerprint: address_types_js_1.TlsCaFingerprintSchema.optional(),
+    transport: zod_1.z.enum(["lan", "wan"]).optional(),
+    status: zod_1.z.enum(["discovered", "connected"]).optional(),
+})
+    .strict();
+exports.RuntimeAutonomousLoopSafetyPolicySummarySchema = zod_1.z
+    .object({
+    allowedToolCategories: zod_1.z.array(NonEmptyStringSchema).optional(),
+    allowedShellCommands: zod_1.z.array(NonEmptyStringSchema).optional(),
+    maxWriteOpsPerMinute: zod_1.z.number().int().positive().optional(),
+    maxGitPushesPerHour: zod_1.z.number().int().positive().optional(),
+})
+    .strict();
+exports.RuntimeAutonomousLoopStatusSchema = zod_1.z
+    .object({
+    status: zod_1.z.enum(["running", "stopped"]),
+    intervalMs: zod_1.z.number().int().positive().nullable(),
+    lastWakeTickAt: zod_1.z.string().nullable(),
+    lastCheckpointResult: zod_1.z.enum(["success", "error", "never"]),
+    safetyPolicySummary: exports.RuntimeAutonomousLoopSafetyPolicySummarySchema,
+    ownerClientKind: NonEmptyStringSchema.nullable(),
+})
+    .strict();
+function createDefaultRuntimeAutonomousLoopStatus() {
+    return {
+        status: "stopped",
+        intervalMs: null,
+        lastWakeTickAt: null,
+        lastCheckpointResult: "never",
+        safetyPolicySummary: {},
+        ownerClientKind: null,
+    };
+}
+exports.RuntimeStatusSchema = zod_1.z
+    .object({
+    nodeId: address_types_js_1.NodeIdSchema,
+    runtimeId: address_types_js_1.RuntimeIdSchema,
+    port: zod_1.z.number().int().min(1).max(65535),
+    attachedClients: zod_1.z.number().int().nonnegative().optional(),
+    autonomousLoop: exports.RuntimeAutonomousLoopStatusSchema.optional().default(createDefaultRuntimeAutonomousLoopStatus()),
+})
+    .strict();
+exports.RuntimeAutonomousLoopCommandSchema = zod_1.z
+    .object({
+    intervalMs: zod_1.z.number().int().positive().optional(),
+    safetyPolicy: exports.RuntimeAutonomousLoopSafetyPolicySummarySchema.optional(),
+})
+    .strict();
+exports.PendingPairRequestViewSchema = zod_1.z
+    .object({
+    id: NonEmptyStringSchema,
+    nodeId: address_types_js_1.NodeIdSchema,
+    displayNameSnapshot: NonEmptyStringSchema.optional(),
+    principalFingerprint: address_types_js_1.PrincipalFingerprintSchema,
+})
+    .strict();
+exports.PendingInviteViewSchema = zod_1.z
+    .object({
+    inviteId: NonEmptyStringSchema,
+    inviteLabel: NonEmptyStringSchema.optional(),
+    createdAt: NonEmptyStringSchema,
+    expiresAt: NonEmptyStringSchema.nullable().optional(),
+})
+    .strict();
+exports.PairRequestDecisionSchema = zod_1.z
+    .object({
+    requestId: NonEmptyStringSchema,
+    accepted: zod_1.z.boolean(),
+})
+    .strict();
+exports.PairRequestResponseSchema = zod_1.z
+    .object({
+    accepted: zod_1.z.boolean().optional(),
+    inviteToken: zod_1.z.string().optional(),
+    error: zod_1.z.string().optional(),
+})
+    .strict();
+exports.CreateInviteRequestSchema = zod_1.z
+    .object({
+    inviteLabel: NonEmptyStringSchema.optional(),
+    durationMs: zod_1.z.number().int().min(0).optional(),
+})
+    .strict();
+exports.CreateInviteResponseSchema = zod_1.z
+    .object({
+    inviteToken: NonEmptyStringSchema,
+    pendingInvite: exports.PendingInviteViewSchema,
+})
+    .strict();
+exports.InvitePeerRequestSchema = zod_1.z
+    .object({
+    nodeId: address_types_js_1.NodeIdSchema,
+    displayName: NonEmptyStringSchema,
+    principalFingerprint: address_types_js_1.PrincipalFingerprintSchema.optional(),
+    controlEndpoint: address_types_js_1.ControlEndpointAdvertisementSchema,
+    transportEndpoint: address_types_js_1.TransportEndpointAdvertisementSchema.optional(),
+    transport: zod_1.z.enum(["lan", "wan"]).optional(),
+})
+    .strict();
+exports.PairingProofStateSchema = zod_1.z.enum(["pending_verification"]);
+exports.InvitePeerResultSchema = zod_1.z.discriminatedUnion("mode", [
+    zod_1.z
+        .object({
+        nodeId: address_types_js_1.NodeIdSchema,
+        displayNameSnapshot: NonEmptyStringSchema.optional(),
+        mode: zod_1.z.literal("lan_direct"),
+        pairingProofState: zod_1.z.literal("pending_verification"),
+    })
+        .strict(),
+    zod_1.z
+        .object({
+        nodeId: address_types_js_1.NodeIdSchema,
+        displayNameSnapshot: NonEmptyStringSchema.optional(),
+        mode: zod_1.z.literal("wan_pair"),
+        pairingProofState: zod_1.z.literal("pending_verification"),
+    })
+        .strict(),
+]);
+exports.AcceptInviteResponseSchema = zod_1.z
+    .object({
+    success: zod_1.z.boolean(),
+    nodeId: address_types_js_1.NodeIdSchema,
+    displayNameSnapshot: NonEmptyStringSchema.optional(),
+})
+    .strict();
+exports.AcceptInviteTokenRequestSchema = zod_1.z
+    .object({
+    inviteToken: NonEmptyStringSchema,
+})
+    .strict();
+exports.AcceptInviteTokenResponseSchema = exports.AcceptInviteResponseSchema;
+exports.CancelInviteRequestSchema = zod_1.z
+    .object({
+    inviteId: NonEmptyStringSchema,
+})
+    .strict();
+exports.CancelInviteResponseSchema = zod_1.z
+    .object({
+    cancelled: zod_1.z.boolean(),
+    inviteId: NonEmptyStringSchema,
+})
+    .strict();
+exports.DirectPairRequestSchema = zod_1.z
+    .object({
+    peerNodeId: address_types_js_1.NodeIdSchema,
+    principalFingerprint: address_types_js_1.PrincipalFingerprintSchema,
+    peerDisplayName: NonEmptyStringSchema.optional(),
+    peerWgPubkey: address_types_js_1.PeerTransportIdSchema,
+    peerSigningPubkey: NonEmptyStringSchema,
+    transportEndpoint: address_types_js_1.TransportEndpointAdvertisementSchema,
+    controlEndpoint: address_types_js_1.ControlEndpointAdvertisementSchema,
+    psk: NonEmptyStringSchema,
+})
+    .strict();
+exports.DirectPairRequestJsonSchema = toFastifyBodyJsonSchema(exports.DirectPairRequestSchema);
+exports.DirectPairResponseSchema = zod_1.z
+    .object({
+    received: zod_1.z.literal(true),
+    pairingProofState: zod_1.z.literal("pending_verification"),
+})
+    .strict();
+exports.RevokePeerRequestSchema = zod_1.z
+    .object({
+    nodeId: address_types_js_1.NodeIdSchema,
+    envelope: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+})
+    .strict();
+exports.RevokePeerResponseSchema = zod_1.z
+    .object({
+    revoked: zod_1.z.boolean(),
+    nodeId: address_types_js_1.NodeIdSchema,
+    displayNameSnapshot: NonEmptyStringSchema.optional(),
+})
+    .strict();
+exports.RepairPeerRequestSchema = zod_1.z
+    .object({
+    nodeId: address_types_js_1.NodeIdSchema,
+    endpointHost: NonEmptyStringSchema,
+    endpointPort: zod_1.z.number().int().min(1).max(65535),
+    endpointRevision: address_types_js_1.EndpointRevisionSchema,
+})
+    .strict();
+exports.RepairPeerResponseSchema = zod_1.z
+    .object({
+    repaired: zod_1.z.boolean(),
+    nodeId: address_types_js_1.NodeIdSchema,
+    endpointHost: NonEmptyStringSchema,
+    endpointPort: zod_1.z.number().int().min(1).max(65535),
+    endpointRevision: address_types_js_1.EndpointRevisionSchema,
+})
+    .strict();
+exports.LocalControlClientKindSchema = zod_1.z.enum(["tui", "daemon-launcher", "pipe", "local-api"]);
+exports.AttachedClientViewSchema = zod_1.z
+    .object({
+    clientId: address_types_js_1.ClientIdSchema,
+    clientKind: exports.LocalControlClientKindSchema,
+    displayLabel: NonEmptyStringSchema,
+    self: zod_1.z.boolean(),
+    attachedAt: NonEmptyStringSchema,
+    lastSeenAt: NonEmptyStringSchema,
+})
+    .strict();
+exports.AttachedClientLeaseGrantSchema = zod_1.z
+    .object({
+    clientId: address_types_js_1.ClientIdSchema,
+    clientAuthToken: NonEmptyStringSchema,
+})
+    .strict();
+exports.AttachedClientAuthSchema = exports.AttachedClientLeaseGrantSchema;
+exports.LocalControlSocketAttachClientRequestSchema = zod_1.z
+    .object({
+    clientKind: exports.LocalControlClientKindSchema,
+    lease: zod_1.z.boolean().optional(),
+    pid: zod_1.z.number().optional(),
+    displayName: zod_1.z.string().optional(),
+})
+    .strict();
+exports.LocalControlSocketAttachClientResponseSchema = exports.AttachedClientLeaseGrantSchema;
+exports.LocalControlSocketDetachClientRequestSchema = zod_1.z
+    .object({
+    clientId: address_types_js_1.ClientIdSchema,
+})
+    .strict();
+exports.LocalControlSocketDetachClientResponseSchema = zod_1.z
+    .object({
+    detached: zod_1.z.boolean(),
+})
+    .strict();
+exports.LocalControlSocketMethodSchema = zod_1.z.enum([
+    "submitRun",
+    "resumeRun",
+    "streamRun",
+    "subscribeRuntimeEvents",
+    "sendBestEffort",
+    "sendDurable",
+    "listInbox",
+    "listDirectClientInbox",
+    "listPeers",
+    "listNearbyPeers",
+    "listAttachedClients",
+    "subscribeDirectClientInbox",
+    "getRuntimeStatus",
+    "startAutonomousLoop",
+    "stopAutonomousLoop",
+    "getRuntimeBootstrap",
+    "listPendingPairRequests",
+    "respondToPairRequest",
+    "createInvite",
+    "listPendingInvites",
+    "acceptInviteToken",
+    "cancelInvite",
+    "invitePeer",
+    "acceptInvite",
+    "directPair",
+    "revokePeer",
+    "repairPeer",
+    "attachClient",
+    "detachClient",
+    "watchInbox",
+]);
+const AttachedClientAuthRequiredSocketMethods = new Set([
+    "listAttachedClients",
+    "listDirectClientInbox",
+    "subscribeDirectClientInbox",
+]);
+exports.LocalControlSocketRequestSchema = zod_1.z
+    .object({
+    id: NonEmptyStringSchema,
+    method: exports.LocalControlSocketMethodSchema,
+    payload: zod_1.z.unknown().optional(),
+    auth: exports.AttachedClientAuthSchema.optional(),
+})
+    .strict()
+    .superRefine((request, ctx) => {
+    if (AttachedClientAuthRequiredSocketMethods.has(request.method) && request.auth === undefined) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: `Local control socket method ${request.method} requires attached-client auth`,
+            path: ["auth"],
+        });
+    }
+});
+exports.LocalControlSocketSuccessResponseSchema = zod_1.z
+    .object({
+    id: NonEmptyStringSchema,
+    ok: zod_1.z.literal(true),
+    payload: zod_1.z.unknown().optional(),
+})
+    .strict();
+exports.LocalControlSocketErrorResponseSchema = zod_1.z
+    .object({
+    id: NonEmptyStringSchema,
+    ok: zod_1.z.literal(false),
+    error: NonEmptyStringSchema,
+    reason: zod_1.z.string().optional(),
+    diagnostic: exports.RuntimeErrorDiagnosticSchema.optional(),
+})
+    .strict();
+exports.LocalControlSocketResponseSchema = zod_1.z.discriminatedUnion("ok", [
+    exports.LocalControlSocketSuccessResponseSchema,
+    exports.LocalControlSocketErrorResponseSchema,
+]);

package/dist-cjs/network-runtime/node-store-contract.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+export { RuntimeOwnerRecordSchema } from "./address-types.js";
+export type { RuntimeOwnerRecord } from "./address-types.js";
+export declare const RuntimeEventKindSchema: z.ZodEnum<{
+    client_attached: "client_attached";
+    client_detached: "client_detached";
+    runtime_started: "runtime_started";
+    runtime_stopped: "runtime_stopped";
+    runtime_stale: "runtime_stale";
+    runtime_restarted: "runtime_restarted";
+    pair_proposed: "pair_proposed";
+    proof_committed: "proof_committed";
+    continuity_bound: "continuity_bound";
+    revocation_committed: "revocation_committed";
+    ingress_accepted: "ingress_accepted";
+    ingress_rejected: "ingress_rejected";
+    durable_send_queued: "durable_send_queued";
+    durable_send_dispatching: "durable_send_dispatching";
+    durable_send_acked: "durable_send_acked";
+    durable_send_expired: "durable_send_expired";
+}>;
+export type RuntimeEventKind = z.infer<typeof RuntimeEventKindSchema>;
+export declare const RuntimeEventSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    runtimeId: z.core.$ZodBranded<z.ZodString, "RuntimeId", "out">;
+    kind: z.ZodEnum<{
+        client_attached: "client_attached";
+        client_detached: "client_detached";
+        runtime_started: "runtime_started";
+        runtime_stopped: "runtime_stopped";
+        runtime_stale: "runtime_stale";
+        runtime_restarted: "runtime_restarted";
+        pair_proposed: "pair_proposed";
+        proof_committed: "proof_committed";
+        continuity_bound: "continuity_bound";
+        revocation_committed: "revocation_committed";
+        ingress_accepted: "ingress_accepted";
+        ingress_rejected: "ingress_rejected";
+        durable_send_queued: "durable_send_queued";
+        durable_send_dispatching: "durable_send_dispatching";
+        durable_send_acked: "durable_send_acked";
+        durable_send_expired: "durable_send_expired";
+    }>;
+    revision: z.ZodOptional<z.ZodNumber>;
+    recordedAt: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type RuntimeEvent = z.infer<typeof RuntimeEventSchema>;