@econ-v1/domain 6.7.0 → 6.10.0

package/src/index.js

@@ -0,0 +1,566 @@
+// @ts-check
+
+/**
+ * @typedef {import("./errors/index.js").ClientError} ClientError
+ */
+/**
+ * @typedef {import("./errors/index.js").DomainErrorCode} DomainErrorCode
+ */
+/**
+ * @template {string} TCode
+ * @typedef {import("./errors/index.js").ErrorOptions<TCode>} ErrorOptions
+ */
+/**
+ * @typedef {import("./errors/index.js").SerializableClientError} SerializableClientError
+ */
+/**
+ * @template {string} TKind
+ * @template {string} TCode
+ * @typedef {import("./errors/index.js").SerializableError<TKind, TCode>} SerializableError
+ */
+/**
+ * @typedef {import("./errors/index.js").SyncErrorCode} SyncErrorCode
+ */
+/**
+ * @typedef {import("./errors/index.js").TransportErrorCode} TransportErrorCode
+ */
+/**
+ * @typedef {import("./events/index.js").DomainEvent} DomainEvent
+ */
+/** @typedef {import("./events/index.js").AppDomainEvent} AppDomainEvent */
+/** @typedef {import("./events/index.js").AppEventPayload} AppEventPayload */
+/** @typedef {import("./events/index.js").AppEventType} AppEventType */
+/** @typedef {import("./events/index.js").CoreKernelEventType} CoreKernelEventType */
+/**
+ * @template {KernelEventType} T
+ * @typedef {import("./events/index.js").KernelEventByType<T>} KernelEventByType
+ */
+/**
+ * @template {KernelEventType} T
+ * @typedef {import("./events/index.js").KernelEventPayload<T>} KernelEventPayload
+ */
+/**
+ * @typedef {import("./events/index.js").KernelEventPayloads} KernelEventPayloads
+ */
+/**
+ * @typedef {import("./events/index.js").KernelEventType} KernelEventType
+ */
+/**
+ * @typedef {import("./events/index.js").QueryName} QueryName
+ */
+/**
+ * @typedef {import("./models/index.js").Agent} Agent
+ */
+/**
+ * @typedef {import("./models/index.js").AgentStatus} AgentStatus
+ */
+/**
+ * @typedef {import("./models/index.js").AgentValue} AgentValue
+ */
+/** @typedef {import("./models/index.js").NodeAppBudgetState} NodeAppBudgetState */
+/** @typedef {import("./models/index.js").NodeAppBudgetVerdict} NodeAppBudgetVerdict */
+/** @typedef {import("./models/index.js").NodeAppDeviceMemory} NodeAppDeviceMemory */
+/** @typedef {import("./models/index.js").NodeAppGovernorRow} NodeAppGovernorRow */
+/** @typedef {import("./models/index.js").NodeAppHeapObjectTypeCount} NodeAppHeapObjectTypeCount */
+/** @typedef {import("./models/index.js").NodeAppHeapSnapshot} NodeAppHeapSnapshot */
+/** @typedef {import("./models/index.js").NodeAppHeapSnapshotState} NodeAppHeapSnapshotState */
+/** @typedef {import("./models/index.js").NodeAppHeapSnapshotSummary} NodeAppHeapSnapshotSummary */
+/** @typedef {import("./models/index.js").NodeAppLaneKind} NodeAppLaneKind */
+/** @typedef {import("./models/index.js").NodeAppLifecycleMemoryObservation} NodeAppLifecycleMemoryObservation */
+/** @typedef {import("./models/index.js").NodeAppMemoryActivityRollup} NodeAppMemoryActivityRollup */
+/** @typedef {import("./models/index.js").NodeAppMemoryApp} NodeAppMemoryApp */
+/** @typedef {import("./models/index.js").NodeAppMemoryAttribution} NodeAppMemoryAttribution */
+/** @typedef {import("./models/index.js").NodeAppMemoryAvailability} NodeAppMemoryAvailability */
+/** @typedef {import("./models/index.js").NodeAppMemoryBudgetBasis} NodeAppMemoryBudgetBasis */
+/** @typedef {import("./models/index.js").NodeAppMemoryCapabilityCallCount} NodeAppMemoryCapabilityCallCount */
+/** @typedef {import("./models/index.js").NodeAppMemoryDownload} NodeAppMemoryDownload */
+/** @typedef {import("./models/index.js").NodeAppMemoryOverview} NodeAppMemoryOverview */
+/** @typedef {import("./models/index.js").NodeAppMemoryOverviewApp} NodeAppMemoryOverviewApp */
+/** @typedef {import("./models/index.js").NodeAppMemoryReading} NodeAppMemoryReading */
+/** @typedef {import("./models/index.js").NodeAppMemoryRepository} NodeAppMemoryRepository */
+/** @typedef {import("./models/index.js").NodeAppMemorySnapshot} NodeAppMemorySnapshot */
+/** @typedef {import("./models/index.js").NodeAppMemorySource} NodeAppMemorySource */
+/** @typedef {import("./models/index.js").NodeAppMemoryTrend} NodeAppMemoryTrend */
+/** @typedef {import("./models/index.js").NodeAppMemoryTrendVerdict} NodeAppMemoryTrendVerdict */
+/** @typedef {import("./models/index.js").NodeAppMemoryUnavailableReason} NodeAppMemoryUnavailableReason */
+/** @typedef {import("./models/index.js").NodeAppPressureState} NodeAppPressureState */
+/** @typedef {import("./models/index.js").NodeAppRuntimeMode} NodeAppRuntimeMode */
+/** @typedef {import("./models/index.js").NodeAppTerminationReason} NodeAppTerminationReason */
+/**
+ * @typedef {import("./models/index.js").Graph} Graph
+ */
+/**
+ * @typedef {import("./models/index.js").GraphEdge} GraphEdge
+ */
+/**
+ * @typedef {import("./models/index.js").GraphNode} GraphNode
+ */
+/**
+ * @typedef {import("./models/index.js").GraphValue} GraphValue
+ */
+/**
+ * @template {JsonValue} TValue
+ * @typedef {import("./models/index.js").RevisionCommand<TValue>} RevisionCommand
+ */
+/**
+ * @template {JsonValue} TValue
+ * @typedef {import("./models/index.js").RevisionConflictPayload<TValue>} RevisionConflictPayload
+ */
+/**
+ * @template {JsonValue} TValue
+ * @typedef {import("./models/index.js").RevisionConflictRecord<TValue>} RevisionConflictRecord
+ */
+/**
+ * @typedef {import("./models/index.js").RevisionResolution} RevisionResolution
+ */
+/**
+ * @typedef {import("./models/index.js").RevisionedDomain} RevisionedDomain
+ */
+/**
+ * @typedef {import("./models/index.js").RevisionedSetting} RevisionedSetting
+ */
+/**
+ * @typedef {import("./models/index.js").SettingValue} SettingValue
+ */
+/**
+ * @typedef {import("./models/index.js").ResolveRevisionConflictCommand} ResolveRevisionConflictCommand
+ */
+/**
+ * @template {JsonValue} [TValue=import("./models/index.js").JsonValue]
+ * @typedef {import("./models/index.js").RevisionUpdateCommand<TValue>} RevisionUpdateCommand
+ */
+/**
+ * @typedef {import("./models/index.js").RevisionUpdateCommandName} RevisionUpdateCommandName
+ */
+/**
+ * @typedef {import("./models/index.js").RevisionedCommandName} RevisionedCommandName
+ */
+/**
+ * @template {JsonValue} [TValue=import("./models/index.js").JsonValue]
+ * @typedef {import("./queries/revisioned.js").RevisionedListRepository<TValue>} RevisionedListRepository
+ */
+/**
+ * @typedef {import("./models/conversation.js").Conversation} Conversation
+ */
+/**
+ * @typedef {import("./models/conversation.js").ConversationListParams} ConversationListParams
+ */
+/**
+ * @typedef {import("./models/conversation.js").ConversationLogDelta} ConversationLogDelta
+ */
+/**
+ * @typedef {import("./models/conversation.js").ConversationMessage} ConversationMessage
+ */
+/**
+ * @typedef {import("./models/conversation.js").ConversationMessageState} ConversationMessageState
+ */
+/**
+ * @typedef {import("./models/conversation.js").MessageListParams} MessageListParams
+ */
+/**
+ * @typedef {import("./models/conversation.js").Notification} Notification
+ */
+/**
+ * @typedef {import("./models/conversation.js").NotificationListParams} NotificationListParams
+ */
+/**
+ * @typedef {import("./models/wallet.js").CreateInvoiceInput} CreateInvoiceInput
+ */
+/**
+ * @typedef {import("./models/wallet.js").PayInvoiceInput} PayInvoiceInput
+ */
+/**
+ * @typedef {import("./models/wallet.js").PaymentHistoryView} PaymentHistoryView
+ */
+/**
+ * @typedef {import("./models/wallet.js").WalletAuthoritativeSnapshot} WalletAuthoritativeSnapshot
+ */
+/**
+ * @typedef {import("./models/wallet.js").WalletBalanceView} WalletBalanceView
+ */
+/**
+ * @typedef {import("./models/wallet.js").WalletCommand} WalletCommand
+ */
+/**
+ * @typedef {import("./models/wallet.js").WalletMirrorRepository} WalletMirrorRepository
+ */
+/**
+ * @typedef {import("./models/wallet.js").WalletSnapshotPayload} WalletSnapshotPayload
+ */
+/**
+ * @typedef {import("./models/payment.js").WalletCommandResult} WalletCommandResult
+ */
+/**
+ * @typedef {import("./models/l402.js").L402HistoryView} L402HistoryView
+ */
+/**
+ * @typedef {import("./models/l402.js").L402Receipt} L402Receipt
+ */
+/**
+ * @typedef {import("./models/payment.js").PaymentRecord} PaymentRecord
+ */
+/**
+ * @typedef {import("./models/payment.js").PaymentStatus} PaymentStatus
+ */
+/**
+ * @typedef {import("./services/conversation-service.js").ConversationServiceOptions} ConversationServiceOptions
+ */
+/** @typedef {import("./services/certificate-trust-service.js").CertificateTrustServiceOptions} CertificateTrustServiceOptions */
+/** @typedef {import("./services/certificate-trust-service.js").CertificateTrustSnapshot} CertificateTrustSnapshot */
+/** @typedef {import("./services/certificate-trust-service.js").CertificateTrustStatus} CertificateTrustStatus */
+/**
+ * @typedef {import("./services/conversation-service.js").SendMessageInput} SendMessageInput
+ */
+/**
+ * @typedef {import("./services/conversation-sync.js").ConversationSyncContext} ConversationSyncContext
+ */
+/**
+ * @typedef {import("./models/index.js").JsonObject} JsonObject
+ */
+/** @typedef {import("./models/index.js").AppDataChangedEvent} AppDataChangedEvent */
+/** @typedef {import("./models/index.js").AppDataFreshness} AppDataFreshness */
+/** @typedef {import("./models/index.js").AppDataManifestRegistration} AppDataManifestRegistration */
+/** @typedef {import("./models/index.js").AppDataQueryDefinition} AppDataQueryDefinition */
+/** @typedef {import("./models/index.js").AppDataStreamDefinition} AppDataStreamDefinition */
+/** @typedef {import("./models/index.js").AppDataSyncResponse} AppDataSyncResponse */
+/** @typedef {import("./models/index.js").AppDataSyncResult} AppDataSyncResult */
+/** @typedef {import("./models/index.js").AppDataTransport} AppDataTransport */
+/** @typedef {import("./models/index.js").CachedAppData} CachedAppData */
+/** @typedef {import("@econ-v1/ports").AppDataManifest} AppDataManifest */
+/** @typedef {import("@econ-v1/ports").AppDataOfflinePolicy} AppDataOfflinePolicy */
+/** @typedef {import("@econ-v1/ports").AppDataQueryDeclaration} AppDataQueryDeclaration */
+/** @typedef {import("@econ-v1/ports").AppDataQueryKind} AppDataQueryKind */
+/** @typedef {import("@econ-v1/ports").AppDataStreamDeclaration} AppDataStreamDeclaration */
+/** @typedef {import("@econ-v1/ports").AppDataStreamKind} AppDataStreamKind */
+/** @typedef {import("@econ-v1/ports").AppDataSyncKind} AppDataSyncKind */
+/** @typedef {import("@econ-v1/ports").AppDataSyncPolicy} AppDataSyncPolicy */
+/**
+ * @typedef {import("./models/index.js").JsonPrimitive} JsonPrimitive
+ */
+/**
+ * @typedef {import("./models/index.js").JsonValue} JsonValue
+ */
+/**
+ * @template TParams
+ * @template TRow
+ * @typedef {import("./models/index.js").LiveQueryDefinition<TParams, TRow>} LiveQueryDefinition
+ */
+/**
+ * @typedef {import("./models/index.js").OutboxIntent} OutboxIntent
+ */
+/**
+ * @typedef {import("./models/index.js").OutboxIntentState} OutboxIntentState
+ */
+/**
+ * @template TRow
+ * @typedef {import("./models/index.js").QueryDiff<TRow>} QueryDiff
+ */
+/**
+ * @template {DomainEvent} TEvent
+ * @typedef {import("./models/index.js").RepositoryWrite<TEvent>} RepositoryWrite
+ */
+/**
+ * @template TPayload
+ * @typedef {import("./services/sync/index.js").AuthoritativeCommand<TPayload>} AuthoritativeCommand
+ */
+/**
+ * @typedef {import("./services/sync/index.js").AuthoritativeCommandOptions} AuthoritativeCommandOptions
+ */
+/**
+ * @template TValue
+ * @template TCommand
+ * @template TResult
+ * @typedef {import("./services/sync/index.js").AuthoritativeMirrorOptions<TValue, TCommand, TResult>} AuthoritativeMirrorOptions
+ */
+/**
+ * @template TValue
+ * @typedef {import("./services/sync/index.js").AuthoritativeSnapshot<TValue>} AuthoritativeSnapshot
+ */
+/**
+ * @template TPayload
+ * @typedef {import("./services/sync/index.js").LogSyncOptions<TPayload>} LogSyncOptions
+ */
+/**
+ * @template TValue
+ * @typedef {import("./services/sync/index.js").RevisionCommandResult<TValue>} RevisionCommandResult
+ */
+/**
+ * @template TValue
+ * @typedef {import("./services/sync/index.js").RevisionConflict<TValue>} RevisionConflict
+ */
+/**
+ * @template TValue
+ * @typedef {import("./services/sync/index.js").RevisionEntity<TValue>} RevisionEntity
+ */
+/**
+ * @template TValue
+ * @typedef {import("./services/sync/index.js").RevisionIntent<TValue>} RevisionIntent
+ */
+/**
+ * @template TValue
+ * @typedef {import("./services/sync/index.js").RevisionMergeOptions<TValue>} RevisionMergeOptions
+ */
+/**
+ * @template TValue
+ * @typedef {import("./services/sync/index.js").RevisionWriteInput<TValue>} RevisionWriteInput
+ */
+/**
+ * @typedef {import("./services/sync/index.js").SyncApplyResult} SyncApplyResult
+ */
+/**
+ * @template TPayload
+ * @typedef {import("./services/sync/index.js").SyncDelta<TPayload>} SyncDelta
+ */
+/**
+ * @typedef {import("./services/sync/index.js").SyncDeltaContext} SyncDeltaContext
+ */
+/**
+ * @template TPayload
+ * @typedef {import("./services/sync/index.js").SyncStrategy<TPayload>} SyncStrategy
+ */
+/**
+ * @typedef {import("./services/sync/index.js").SyncStrategyKind} SyncStrategyKind
+ */
+/**
+ * @template {JsonValue} TValue
+ * @typedef {import("./services/revisioned-domain-service.js").RevisionedDomainRepository<TValue>} RevisionedDomainRepository
+ */
+/**
+ * @template {JsonValue} TValue
+ * @typedef {import("./services/revisioned-domain-service.js").RevisionedDomainServiceOptions<TValue>} RevisionedDomainServiceOptions
+ */
+/**
+ * @template {JsonValue} TValue
+ * @typedef {import("./services/revisioned-domain-service.js").RevisionResolutionResult<TValue>} RevisionResolutionResult
+ */
+/**
+ * @template {JsonValue} TValue
+ * @typedef {import("./services/revisioned-domain-service.js").RevisionedWriteInput<TValue>} RevisionedWriteInput
+ */
+/**
+ * @template {JsonValue} TValue
+ * @typedef {import("./services/revisioned-domain-service.js").RevisionedWriteResult<TValue>} RevisionedWriteResult
+ */
+/**
+ * @typedef {import("@econ-v1/ports").TransportState} TransportState
+ */
+/**
+ * @typedef {import("@econ-v1/ports").TransportOfflineReason} TransportOfflineReason
+ */
+/**
+ * @typedef {import("./services/outbox-service.js").ClaimOptions} ClaimOptions
+ */
+/**
+ * @typedef {import("./services/outbox-service.js").FailureOptions} FailureOptions
+ */
+/**
+ * @typedef {import("./services/outbox-service.js").OutboxPersistence} OutboxPersistence
+ */
+/**
+ * @typedef {import("./services/outbox-service.js").OutboxServiceOptions} OutboxServiceOptions
+ */
+/**
+ * @typedef {import("./services/wallet-mirror-service.js").WalletMirrorServiceOptions} WalletMirrorServiceOptions
+ */
+/**
+ * @typedef {import("./services/transport-manager.js").TransportManagerOptions} TransportManagerOptions
+ */
+/**
+ * @typedef {import("./services/peer-directory-service.js").NodeMetadataWire} NodeMetadataWire
+ */
+/**
+ * @typedef {import("./services/peer-directory-service.js").PeerAdvertisement} PeerAdvertisement
+ */
+/**
+ * @typedef {import("./services/gossip-service.js").GossipAdvertisement} GossipAdvertisement
+ */
+/**
+ * @typedef {import("./services/gossip-service.js").GossipServiceOptions} GossipServiceOptions
+ */
+/**
+ * @typedef {import("./models/owner-views.js").FeedItem} FeedItem
+ */
+/**
+ * @typedef {import("./models/owner-views.js").FeedItemKind} FeedItemKind
+ */
+/**
+ * @typedef {import("./models/owner-views.js").FeedQuery} FeedQuery
+ */
+/**
+ * @typedef {import("./models/owner-views.js").HomeStatus} HomeStatus
+ */
+/**
+ * @typedef {import("./models/owner-views.js").HomeSummary} HomeSummary
+ */
+/**
+ * @typedef {import("./models/owner-views.js").OperationalSummary} OperationalSummary
+ */
+/**
+ * @typedef {import("./models/owner-views.js").OperationalTransport} OperationalTransport
+ */
+/**
+ * @typedef {import("./models/owner-views.js").OwnerViewRepository} OwnerViewRepository
+ */
+/**
+ * @typedef {import("./models/owner-views.js").OwnerViewSyncStrategy} OwnerViewSyncStrategy
+ */
+/**
+ * @typedef {import("./models/owner-views.js").PeerDirectoryEntry} PeerDirectoryEntry
+ */
+/**
+ * @typedef {import("./models/owner-views.js").PeerDirectoryQuery} PeerDirectoryQuery
+ */
+/**
+ * @typedef {import("./models/owner-views.js").PeerStatus} PeerStatus
+ */
+/**
+ * @typedef {import("./models/owner-views.js").StorageStatus} StorageStatus
+ */
+/**
+ * @typedef {import("./models/owner-views.js").SyncStatus} SyncStatus
+ */
+/**
+ * @typedef {import("./services/lan-candidate-refresh-service.js").LanCandidateRefreshServiceOptions} LanCandidateRefreshServiceOptions
+ */
+/**
+ * @typedef {import("./services/discovery-probe-service.js").DiscoveryCandidateRow} DiscoveryCandidateRow
+ */
+/**
+ * @typedef {import("./services/discovery-probe-service.js").DiscoveryCandidateStatus} DiscoveryCandidateStatus
+ */
+/**
+ * @typedef {import("./services/discovery-probe-service.js").DiscoveryFoundNode} DiscoveryFoundNode
+ */
+/**
+ * @typedef {import("./services/discovery-probe-service.js").DiscoveryNodeIdentityWire} DiscoveryNodeIdentityWire
+ */
+/**
+ * @typedef {import("./services/discovery-probe-service.js").DiscoveryProbeServiceOptions} DiscoveryProbeServiceOptions
+ */
+/** @typedef {import("./models/device-boot-state.js").DeviceBootState} DeviceBootState */
+/** @typedef {import("./services/device-boot-state-service.js").DeviceBootStateServiceOptions} DeviceBootStateServiceOptions */
+/**
+ * @typedef {import("./services/onboarding-status-service.js").OnboardingLifecycleState} OnboardingLifecycleState
+ */
+/**
+ * @typedef {import("./services/onboarding-status-service.js").OnboardingLifecycleStatusRow} OnboardingLifecycleStatusRow
+ */
+/**
+ * @typedef {import("./services/onboarding-status-service.js").OnboardingStatusServiceOptions} OnboardingStatusServiceOptions
+ */
+/**
+ * @typedef {import("./services/onboarding-status-service.js").OnboardingStatusWire} OnboardingStatusWire
+ */
+/** @typedef {import("./services/invite-redemption-service.js").InviteRedemptionOutcome} InviteRedemptionOutcome */
+/** @typedef {import("./services/invite-redemption-service.js").InviteRedemptionServiceOptions} InviteRedemptionServiceOptions */
+/** @typedef {import("./services/onboarding-checkpoint-store.js").OnboardingCheckpoint} OnboardingCheckpoint */
+/** @typedef {import("./services/onboarding-checkpoint-store.js").OnboardingCheckpointStoreOptions} OnboardingCheckpointStoreOptions */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowApprovalState} OnboardingFlowApprovalState */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowClaimPort} OnboardingFlowClaimPort */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowInvitePort} OnboardingFlowInvitePort */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowLcdPort} OnboardingFlowLcdPort */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowLcdScreen} OnboardingFlowLcdScreen */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowLcdScreenId} OnboardingFlowLcdScreenId */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowNetwork} OnboardingFlowNetwork */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowPhase} OnboardingFlowPhase */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowReasonCode} OnboardingFlowReasonCode */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowRow} OnboardingFlowRow */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowRowBase} OnboardingFlowRowBase */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowServiceOptions} OnboardingFlowServiceOptions */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowStepId} OnboardingFlowStepId */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowWifiPort} OnboardingFlowWifiPort */
+/** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowWifiSecurity} OnboardingFlowWifiSecurity */
+/** @typedef {import("./queries/onboarding-lcd-screen.js").OnboardingLcdScreenRow} OnboardingLcdScreenRow */
+/** @typedef {import("./queries/onboarding-lcd-screen.js").OnboardingLcdScreenRowBase} OnboardingLcdScreenRowBase */
+/** @typedef {import("./services/wifi-provisioning-service.js").WifiConfigureOutcome} WifiConfigureOutcome */
+/** @typedef {import("./services/wifi-provisioning-service.js").WifiHandoffOutcome} WifiHandoffOutcome */
+/** @typedef {import("./services/wifi-provisioning-service.js").WifiProvisioningNetwork} WifiProvisioningNetwork */
+/** @typedef {import("./services/wifi-provisioning-service.js").WifiProvisioningSecurity} WifiProvisioningSecurity */
+/** @typedef {import("./services/wifi-provisioning-service.js").WifiProvisioningServiceOptions} WifiProvisioningServiceOptions */
+/** @typedef {import("./services/wifi-provisioning-service.js").WifiScanOutcome} WifiScanOutcome */
+/** @typedef {import("./services/lcd-decision-service.js").LcdDecisionOutcome} LcdDecisionOutcome */
+/** @typedef {import("./services/lcd-decision-service.js").LcdDecisionServiceOptions} LcdDecisionServiceOptions */
+/** @typedef {import("./services/owner-claim-service.js").OwnerClaimConfirmation} OwnerClaimConfirmation */
+/** @typedef {import("./services/owner-claim-service.js").OwnerClaimIdentity} OwnerClaimIdentity */
+/** @typedef {import("./services/owner-claim-service.js").OwnerClaimOutcome} OwnerClaimOutcome */
+/** @typedef {import("./services/owner-claim-service.js").OwnerClaimPrepareOutcome} OwnerClaimPrepareOutcome */
+/** @typedef {import("./services/owner-claim-service.js").OwnerClaimServiceOptions} OwnerClaimServiceOptions */
+/**
+ * @typedef {import("./models/release-manifest.js").ReleaseManifestAsset} ReleaseManifestAsset
+ */
+/**
+ * @typedef {import("./models/release-manifest.js").ReleaseManifestVersionRange} ReleaseManifestVersionRange
+ */
+/**
+ * @typedef {import("./models/release-manifest.js").SignedReleaseManifest} SignedReleaseManifest
+ */
+/**
+ * @typedef {import("./models/release-manifest.js").UnsignedReleaseManifest} UnsignedReleaseManifest
+ */
+/**
+ * @typedef {import("./services/release-manifest-verifier.js").ReleaseManifestRejectionReason} ReleaseManifestRejectionReason
+ */
+/**
+ * @typedef {import("./services/release-manifest-verifier.js").ReleaseManifestTrustedKey} ReleaseManifestTrustedKey
+ */
+/**
+ * @typedef {import("./services/release-manifest-verifier.js").ReleaseManifestVerification} ReleaseManifestVerification
+ */
+/**
+ * @typedef {import("./services/release-manifest-verifier.js").ReleaseManifestVerifyOptions} ReleaseManifestVerifyOptions
+ */
+export { DOMAIN_ERROR_CODES, DomainError, SYNC_ERROR_CODES, SyncError, TRANSPORT_ERROR_CODES, TransportError, } from "./errors/index.js";
+export { appEventInstance, appEventResource, appEventScope, appEventType, isAppEventType, isCoreKernelEvent, isCoreKernelEventType, isKernelEventType, isQueryName, KERNEL_EVENT_TYPES } from "./events/index.js";
+export { REVISIONED_DOMAINS } from "./models/index.js";
+export { AGENT_STATUSES, parseAgentValue, parseGraphValue } from "./models/index.js";
+export { APP_DATA_MAX_PAYLOAD_BYTES, assertAppDataPayload, compareAppDataRevision, isAppDataSyncResponse, isNodeAppBudgetState, isNodeAppLaneKind, isNodeAppMemoryAttribution, isNodeAppMemoryAvailability, isNodeAppMemoryBudgetBasis, isNodeAppMemorySource, isNodeAppMemoryTrendVerdict, isNodeAppMemoryUnavailableReason, isNodeAppPressureState, isNodeAppRuntimeMode, isNodeAppTerminationReason, NODE_APP_BUDGET_STATES, NODE_APP_LANE_KINDS, NODE_APP_MEMORY_ATTRIBUTIONS, NODE_APP_MEMORY_AVAILABILITIES, NODE_APP_MEMORY_BUDGET_BASES, NODE_APP_MEMORY_SOURCES, NODE_APP_MEMORY_TREND_VERDICTS, NODE_APP_MEMORY_UNAVAILABLE_REASONS, NODE_APP_PRESSURE_STATES, NODE_APP_RUNTIME_MODES, NODE_APP_TERMINATION_REASONS } from "./models/index.js";
+export { REVISIONED_COMMAND_NAMES, createAgentUpdateCommand, createGraphUpdateCommand, createResolveRevisionConflictCommand, createRevisionedUpdateCommand, } from "./models/index.js";
+export { createAgentDetailQuery, createAgentListQuery, createGraphDetailQuery, createGraphListQuery, createSettingDetailQuery, createSettingsRevisionedListQuery, parseRevisionDetailParams, } from "./queries/revisioned.js";
+export { createConversationListQuery, createConversationMessagesQuery, parseConversationListParams, parseConversationMessagesParams, } from "./queries/conversations.js";
+export { createNotificationsQuery, parseNotificationListParams } from "./queries/notifications.js";
+export { canonicalOutboxPayload } from "./models/index.js";
+export { createL402HistoryQuery, createPaymentHistoryQuery, createWalletBalanceQuery, L402_HISTORY_QUERY, PAYMENT_HISTORY_QUERY, WALLET_BALANCE_QUERY, } from "./queries/wallet.js";
+export { ConversationService } from "./services/conversation-service.js";
+export { CertificateTrustService } from "./services/certificate-trust-service.js";
+export { createCertificateTrustQuery, CERTIFICATE_TRUST_QUERY } from "./queries/certificate-trust.js";
+export { createConversationLogSync } from "./services/conversation-sync.js";
+export { AuthoritativeMirror, AuthoritativeRevalidationRequiredError, LogSync, RevisionMerge, } from "./services/sync/index.js";
+export { RevisionedDomainService, parseRevisionConflictRecord, } from "./services/revisioned-domain-service.js";
+export { isDelegationActive, isDevicePublicIdentity, normalizeDelegation, publicIdentityDiagnostic, } from "./models/index.js";
+export { OutboxIdempotencyConflictError, OutboxRevalidationRequiredError, OutboxService, OutboxTransitionError, } from "./services/outbox-service.js";
+export { SessionService } from "./services/session-service.js";
+export { ExpiredInvoiceError, InsufficientWalletBalanceError, OfflineWalletCommandError, WalletCommandRejectedError, WalletFreshStateRequiredError, WalletMirrorService, } from "./services/wallet-mirror-service.js";
+export { canonicalHttpCandidateOrigin, isPotentiallyTrustworthyOrigin, transportStateChanged, TransportManager } from "./services/transport-manager.js";
+export { normalizeAdvertisement, nodeMetadataCandidates, PeerDirectoryService, uniqueAddresses, } from "./services/peer-directory-service.js";
+export { GossipService } from "./services/gossip-service.js";
+export { OwnerViewService } from "./services/owner-view-service.js";
+export { OwnerViewRefreshService } from "./services/owner-view-refresh-service.js";
+export { OWNER_VIEW_SYNC_STRATEGIES } from "./models/owner-views.js";
+export { LanCandidateRefreshService } from "./services/lan-candidate-refresh-service.js";
+export { DiscoveryProbeService, secureLanOrigin } from "./services/discovery-probe-service.js";
+export { DeviceBootStateService } from "./services/device-boot-state-service.js";
+export { createDiscoveryCandidatesQuery, DISCOVERY_CANDIDATES_QUERY } from "./queries/discovery.js";
+export { OnboardingStatusService } from "./services/onboarding-status-service.js";
+export { createOnboardingStatusQuery, ONBOARDING_STATUS_QUERY } from "./queries/onboarding-status.js";
+export { InviteRedemptionService } from "./services/invite-redemption-service.js";
+export { createInMemoryOnboardingCheckpointStorage, OnboardingCheckpointStore } from "./services/onboarding-checkpoint-store.js";
+export { ONBOARDING_FLOW_STEP_IDS, OnboardingFlowService } from "./services/onboarding-flow-service.js";
+export { createOnboardingFlowQuery, ONBOARDING_FLOW_QUERY_NAME } from "./queries/onboarding-flow.js";
+export { createOnboardingLcdScreenQuery, ONBOARDING_LCD_SCREEN_QUERY_NAME } from "./queries/onboarding-lcd-screen.js";
+export { WifiProvisioningService } from "./services/wifi-provisioning-service.js";
+export { DeviceCleanupService } from "./services/device-cleanup-service.js";
+/** @typedef {import("./services/device-cleanup-service.js").DeviceCleanupPort} DeviceCleanupPort */
+/** @typedef {import("./services/device-cleanup-service.js").DeviceCleanupServiceOptions} DeviceCleanupServiceOptions */
+/** @typedef {import("./services/device-cleanup-service.js").DeviceCleanupState} DeviceCleanupState */
+export { LcdDecisionService } from "./services/lcd-decision-service.js";
+export { OwnerClaimService } from "./services/owner-claim-service.js";
+export {
+  RELEASE_MANIFEST_LIMITS,
+  RELEASE_MANIFEST_VERSION,
+  parseSignedReleaseManifest,
+  unsignedReleaseManifestToJson,
+} from "./models/release-manifest.js";
+export {
+  RELEASE_MANIFEST_REJECTION_REASONS,
+  verifyReleaseManifest,
+} from "./services/release-manifest-verifier.js";

package/src/models/agent.js

@@ -0,0 +1,43 @@
+// @ts-check
+
+/**
+ * @typedef {import("./json.js").JsonObject} JsonObject
+ */
+/**
+ * @template TValue
+ * @typedef {import("./sync.js").RevisionEntity<TValue>} RevisionEntity
+ */
+/**
+ * @typedef {(typeof AGENT_STATUSES)[number]} AgentStatus
+ */
+/**
+ * @typedef {JsonObject & { readonly description?: string; readonly name: string; readonly status?: AgentStatus; }} AgentValue
+ */
+/**
+ * @typedef {RevisionEntity<AgentValue>} Agent
+ */
+/** @type {readonly ["active", "idle", "paused", "stopped"]} */
+export const AGENT_STATUSES = ["active", "idle", "paused", "stopped"];
+/**
+ * @param {unknown} value
+ * @returns {AgentValue}
+ */
+export function parseAgentValue(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        throw invalid();
+    const record = /** @type {Record<string, unknown>} */ (value);
+    if (typeof record.name !== "string" || record.name.trim() === "")
+        throw invalid();
+    if (record.description !== undefined && typeof record.description !== "string")
+        throw invalid();
+    if (record.status !== undefined &&
+        !AGENT_STATUSES.includes(/** @type {AgentStatus} */ (record.status)))
+        throw invalid();
+    return /** @type {AgentValue} */ (value);
+}
+/**
+ * @returns {TypeError}
+ */
+function invalid() {
+    return new TypeError("Invalid agent value");
+}