@fabricorg/platform-host 0.7.0 → 2.0.0

package/dist/index.d.cts

@@ -131,10 +131,78 @@ interface PlatformHostStore<TDb> {
 interface PlatformHostMutationTransaction<TDb> {
     readonly db: TDb;
     appendEvent(event: AssetEventEnvelope): Promise<void>;
+    appendEventWithOutbox?(event: AssetEventEnvelope, metadata: OutboxEventMetadata): Promise<void>;
     nextEventSequence(tenantId: string, spaceId: string): Promise<number>;
     listEvents(tenantId: string, spaceId: string): Promise<AssetEventEnvelope[]>;
     updateActionInvocation(id: string, tenantId: string, spaceId: string, patch: Partial<Pick<ActionInvocationRecord, "status" | "result" | "error">>): Promise<void>;
 }
+type OutboxStatus = "pending" | "published" | "dead_letter";
+type EventPayloadClassification = "public" | "internal" | "confidential" | "restricted";
+interface OutboxEventMetadata {
+    producerModuleVersion: string;
+    payloadClassification: EventPayloadClassification;
+    traceContext?: Record<string, string>;
+}
+interface EnterpriseEventEnvelope {
+    eventId: string;
+    eventType: string;
+    eventSchemaVersion: number;
+    tenantId: string;
+    spaceId: string;
+    subjectType: string;
+    subjectId: string;
+    sequence: number;
+    actionInvocationId?: string;
+    correlationId: string;
+    causationId?: string;
+    occurredAt: Date;
+    recordedAt: Date;
+    producerModuleVersion: string;
+    payloadClassification: EventPayloadClassification;
+    traceContext?: Record<string, string>;
+    payload: unknown;
+}
+interface OutboxRecord {
+    id: string;
+    tenantId: string;
+    spaceId: string;
+    event: EnterpriseEventEnvelope;
+    status: OutboxStatus;
+    attemptCount: number;
+    availableAt: Date;
+    leaseOwner?: string;
+    leaseExpiresAt?: Date;
+    lastError?: string;
+    createdAt: Date;
+    publishedAt?: Date;
+}
+interface ClaimOutboxInput {
+    workerId: string;
+    leaseDurationMs: number;
+    limit?: number;
+    tenantId?: string;
+    spaceId?: string;
+    now?: Date;
+}
+interface OutboxPlatformHostStore<TDb> extends PlatformHostStore<TDb> {
+    /** True only when transactionWithEvents supplies appendEventWithOutbox in the same unit of work. */
+    readonly transactionalOutbox?: boolean;
+    appendEventWithOutbox(event: AssetEventEnvelope, metadata: OutboxEventMetadata): Promise<void>;
+    claimOutbox(input: ClaimOutboxInput): Promise<OutboxRecord[]>;
+    markOutboxPublished(id: string, workerId: string, publishedAt: Date): Promise<void>;
+    markOutboxFailed(input: {
+        id: string;
+        workerId: string;
+        error: string;
+        availableAt: Date;
+        deadLetter: boolean;
+    }): Promise<void>;
+    listOutbox(input?: {
+        tenantId?: string;
+        spaceId?: string;
+        statuses?: OutboxStatus[];
+    }): Promise<OutboxRecord[]>;
+}
 /**
  * Optional production capability for atomic domain/event persistence.
  *
@@ -309,6 +377,12 @@ interface PlatformHostOptions<TDb> {
     adapters?: readonly AdapterImplementation[];
     dispatcher?: PlatformActionDispatcher;
     services?: FabricRuntimeServices;
+    /** Requires an outbox-capable store; every canonical event is then appended with delivery state. */
+    outbox?: {
+        producerModuleVersion(actionId: ActionId, actionVersion: number): string;
+        classifyPayload(event: AssetEventEnvelope): EventPayloadClassification;
+        traceContext?(event: AssetEventEnvelope): Record<string, string> | undefined;
+    };
     /** Optional vertical-owned evaluator. When absent, agent behavior is unchanged. */
     hitlEvaluator?: AgentActionPolicyEvaluator;
     /** Durable evaluator/ruleset version recorded with every HITL decision. */
@@ -359,7 +433,7 @@ interface GovernedActionHost {
 
 declare function createGovernedActionHost<TDb>(options: PlatformHostOptions<TDb>): GovernedActionHost;
 
-declare class MemoryPlatformHostStore<TDb> implements RecoverablePlatformHostStore<TDb>, ApprovalPlatformHostStore<TDb>, GovernancePlatformHostStore<TDb> {
+declare class MemoryPlatformHostStore<TDb> implements RecoverablePlatformHostStore<TDb>, ApprovalPlatformHostStore<TDb>, GovernancePlatformHostStore<TDb>, OutboxPlatformHostStore<TDb> {
     readonly db: TDb;
     readonly invocations: ActionInvocationRecord[];
     readonly policyEvaluations: PolicyEvaluationRecord[];
@@ -368,6 +442,7 @@ declare class MemoryPlatformHostStore<TDb> implements RecoverablePlatformHostSto
     readonly policyObligations: PolicyObligationRecord[];
     readonly executionAttestations: ExecutionAttestationRecord[];
     readonly externalReconciliations: ExternalReconciliationRecord[];
+    readonly outbox: OutboxRecord[];
     constructor(db: TDb);
     transaction<TResult>(run: (db: TDb) => Promise<TResult>): Promise<TResult>;
     createActionInvocation(input: CreateActionInvocationInput): Promise<ActionInvocationRecord>;
@@ -390,6 +465,22 @@ declare class MemoryPlatformHostStore<TDb> implements RecoverablePlatformHostSto
     getAdapterInvocation(id: string): Promise<AdapterInvocationRecord | undefined>;
     updateAdapterInvocation(id: string, patch: Partial<Pick<AdapterInvocationRecord, "status" | "output" | "error" | "attempt" | "updatedAt">>): Promise<void>;
     appendEvent(event: AssetEventEnvelope): Promise<void>;
+    appendEventWithOutbox(event: AssetEventEnvelope, metadata: OutboxEventMetadata): Promise<void>;
+    claimOutbox(input: ClaimOutboxInput): Promise<OutboxRecord[]>;
+    markOutboxPublished(id: string, workerId: string, publishedAt: Date): Promise<void>;
+    markOutboxFailed(input: {
+        id: string;
+        workerId: string;
+        error: string;
+        availableAt: Date;
+        deadLetter: boolean;
+    }): Promise<void>;
+    listOutbox(input?: {
+        tenantId?: string;
+        spaceId?: string;
+        statuses?: OutboxStatus[];
+    }): Promise<OutboxRecord[]>;
+    private requireLeasedOutbox;
     nextEventSequence(tenantId: string, spaceId: string): Promise<number>;
     getEntityState(tenantId: string, spaceId: string, entityType: string, entityId: string): Promise<string | undefined>;
     listActionInvocations(input?: ListActionInvocationsInput): Promise<ActionInvocationRecord[]>;
@@ -397,6 +488,29 @@ declare class MemoryPlatformHostStore<TDb> implements RecoverablePlatformHostSto
     listEvents(tenantId: string, spaceId: string): Promise<AssetEventEnvelope[]>;
 }
 
+declare function toEnterpriseEventEnvelope(event: AssetEventEnvelope, metadata: OutboxEventMetadata): EnterpriseEventEnvelope;
+interface EnterpriseEventPublisher {
+    publish(event: EnterpriseEventEnvelope): Promise<void>;
+}
+interface OutboxRelayOptions<TDb> {
+    store: OutboxPlatformHostStore<TDb>;
+    publisher: EnterpriseEventPublisher;
+    workerId: string;
+    leaseDurationMs?: number;
+    batchSize?: number;
+    maxAttempts?: number;
+    retryDelayMs?: (attempt: number) => number;
+    now?: () => Date;
+}
+interface OutboxRelayResult {
+    claimed: number;
+    published: number;
+    failed: number;
+    deadLettered: number;
+}
+declare function runOutboxRelayCycle<TDb>(options: OutboxRelayOptions<TDb>): Promise<OutboxRelayResult>;
+declare function cloneOutboxRecord(record: OutboxRecord): OutboxRecord;
+
 interface PlatformHostSqlResult<Row = Record<string, unknown>> {
     rows: Row[];
 }
@@ -419,10 +533,11 @@ interface PostgresPlatformHostTransactionProvider<TDb> {
     run<TResult>(run: (context: PostgresPlatformHostTransactionContext<TDb>) => Promise<TResult>): Promise<TResult>;
 }
 /** Durable mutation-pipeline ledger for Databricks Lakebase or standard Postgres. */
-declare class PostgresPlatformHostStore<TDb> implements RecoverablePlatformHostStore<TDb>, ApprovalPlatformHostStore<TDb>, GovernancePlatformHostStore<TDb> {
+declare class PostgresPlatformHostStore<TDb> implements RecoverablePlatformHostStore<TDb>, ApprovalPlatformHostStore<TDb>, GovernancePlatformHostStore<TDb>, OutboxPlatformHostStore<TDb> {
     readonly db: TDb;
     private readonly sql;
     readonly transactionWithEvents?: AtomicMutationPlatformHostStore<TDb>["transactionWithEvents"];
+    readonly transactionalOutbox: boolean;
     constructor(db: TDb, sql: PlatformHostSqlClient, transactionProvider?: PostgresPlatformHostTransactionProvider<TDb>);
     ensureSchema(): Promise<void>;
     transaction<TResult>(run: (db: TDb) => Promise<TResult>): Promise<TResult>;
@@ -446,6 +561,21 @@ declare class PostgresPlatformHostStore<TDb> implements RecoverablePlatformHostS
     getAdapterInvocation(id: string): Promise<AdapterInvocationRecord | undefined>;
     updateAdapterInvocation(id: string, patch: Partial<Pick<AdapterInvocationRecord, "status" | "output" | "error" | "attempt" | "updatedAt">>): Promise<void>;
     appendEvent(event: AssetEventEnvelope): Promise<void>;
+    appendEventWithOutbox(event: AssetEventEnvelope, metadata: OutboxEventMetadata): Promise<void>;
+    claimOutbox(input: ClaimOutboxInput): Promise<OutboxRecord[]>;
+    markOutboxPublished(id: string, workerId: string, publishedAt: Date): Promise<void>;
+    markOutboxFailed(input: {
+        id: string;
+        workerId: string;
+        error: string;
+        availableAt: Date;
+        deadLetter: boolean;
+    }): Promise<void>;
+    listOutbox(input?: {
+        tenantId?: string;
+        spaceId?: string;
+        statuses?: OutboxStatus[];
+    }): Promise<OutboxRecord[]>;
     nextEventSequence(tenantId: string, spaceId: string): Promise<number>;
     getEntityState(tenantId: string, spaceId: string, entityType: string, entityId: string): Promise<string | undefined>;
     listActionInvocations(input?: ListActionInvocationsInput): Promise<ActionInvocationRecord[]>;
@@ -463,4 +593,4 @@ declare function runPlatformActionWorkerCycle<TDb>(options: PlatformActionWorker
 /** Poll until aborted. Each iteration is bounded and waits without busy-spinning. */
 declare function runPlatformActionWorker<TDb>(options: PlatformActionWorkerOptions<TDb>): Promise<void>;
 
-export { type ActionApprovalDecision, type ActionAuthorizationInput, type ActionExecutionAuthorizationInput, type ActionExecutionReason, type ActionInvocationRecord, type AdapterInvocationRecord, type AdapterInvocationStatus, type ApprovalDecisionTransitionResult, type ApprovalPlatformHostStore, type AtomicMutationPlatformHostStore, type BeginApprovalDecisionInput, type ClaimActionInvocationsInput, type CreateActionInvocationInput, type DispatchActionInput, type DispatchActionResult, type ExecuteActionResult, type ExecuteInvocationOptions, type ExecutionAttestationRecord, type ExternalReconciliationRecord, type GovernancePlatformHostStore, type GovernedActionHost, type HitlDecisionEvidence, type ListActionInvocationsInput, MemoryPlatformHostStore, PLATFORM_HOST_CONTRACT_VERSION, type PendingAssetEvent, type PersistedActionApprovalDecision, type PlatformActionDispatcher, type PlatformActionWorkerCycleResult, type PlatformActionWorkerOptions, type PlatformHostAuthorization, type PlatformHostMutationTransaction, type PlatformHostOptions, type PlatformHostSqlClient, type PlatformHostSqlResult, type PlatformHostStore, type PolicyEvaluationRecord, type PolicyObligationRecord, PostgresPlatformHostStore, type PostgresPlatformHostTransactionContext, type PostgresPlatformHostTransactionProvider, type RecoverablePlatformHostStore, type SubmitActionInput, type SubmitActionResult, createGovernedActionHost, createStoreBackedActionDispatcher, runPlatformActionWorker, runPlatformActionWorkerCycle };
+export { type ActionApprovalDecision, type ActionAuthorizationInput, type ActionExecutionAuthorizationInput, type ActionExecutionReason, type ActionInvocationRecord, type AdapterInvocationRecord, type AdapterInvocationStatus, type ApprovalDecisionTransitionResult, type ApprovalPlatformHostStore, type AtomicMutationPlatformHostStore, type BeginApprovalDecisionInput, type ClaimActionInvocationsInput, type ClaimOutboxInput, type CreateActionInvocationInput, type DispatchActionInput, type DispatchActionResult, type EnterpriseEventEnvelope, type EnterpriseEventPublisher, type EventPayloadClassification, type ExecuteActionResult, type ExecuteInvocationOptions, type ExecutionAttestationRecord, type ExternalReconciliationRecord, type GovernancePlatformHostStore, type GovernedActionHost, type HitlDecisionEvidence, type ListActionInvocationsInput, MemoryPlatformHostStore, type OutboxEventMetadata, type OutboxPlatformHostStore, type OutboxRecord, type OutboxRelayOptions, type OutboxRelayResult, type OutboxStatus, PLATFORM_HOST_CONTRACT_VERSION, type PendingAssetEvent, type PersistedActionApprovalDecision, type PlatformActionDispatcher, type PlatformActionWorkerCycleResult, type PlatformActionWorkerOptions, type PlatformHostAuthorization, type PlatformHostMutationTransaction, type PlatformHostOptions, type PlatformHostSqlClient, type PlatformHostSqlResult, type PlatformHostStore, type PolicyEvaluationRecord, type PolicyObligationRecord, PostgresPlatformHostStore, type PostgresPlatformHostTransactionContext, type PostgresPlatformHostTransactionProvider, type RecoverablePlatformHostStore, type SubmitActionInput, type SubmitActionResult, cloneOutboxRecord, createGovernedActionHost, createStoreBackedActionDispatcher, runOutboxRelayCycle, runPlatformActionWorker, runPlatformActionWorkerCycle, toEnterpriseEventEnvelope };

package/dist/index.d.ts

@@ -131,10 +131,78 @@ interface PlatformHostStore<TDb> {
 interface PlatformHostMutationTransaction<TDb> {
     readonly db: TDb;
     appendEvent(event: AssetEventEnvelope): Promise<void>;
+    appendEventWithOutbox?(event: AssetEventEnvelope, metadata: OutboxEventMetadata): Promise<void>;
     nextEventSequence(tenantId: string, spaceId: string): Promise<number>;
     listEvents(tenantId: string, spaceId: string): Promise<AssetEventEnvelope[]>;
     updateActionInvocation(id: string, tenantId: string, spaceId: string, patch: Partial<Pick<ActionInvocationRecord, "status" | "result" | "error">>): Promise<void>;
 }
+type OutboxStatus = "pending" | "published" | "dead_letter";
+type EventPayloadClassification = "public" | "internal" | "confidential" | "restricted";
+interface OutboxEventMetadata {
+    producerModuleVersion: string;
+    payloadClassification: EventPayloadClassification;
+    traceContext?: Record<string, string>;
+}
+interface EnterpriseEventEnvelope {
+    eventId: string;
+    eventType: string;
+    eventSchemaVersion: number;
+    tenantId: string;
+    spaceId: string;
+    subjectType: string;
+    subjectId: string;
+    sequence: number;
+    actionInvocationId?: string;
+    correlationId: string;
+    causationId?: string;
+    occurredAt: Date;
+    recordedAt: Date;
+    producerModuleVersion: string;
+    payloadClassification: EventPayloadClassification;
+    traceContext?: Record<string, string>;
+    payload: unknown;
+}
+interface OutboxRecord {
+    id: string;
+    tenantId: string;
+    spaceId: string;
+    event: EnterpriseEventEnvelope;
+    status: OutboxStatus;
+    attemptCount: number;
+    availableAt: Date;
+    leaseOwner?: string;
+    leaseExpiresAt?: Date;
+    lastError?: string;
+    createdAt: Date;
+    publishedAt?: Date;
+}
+interface ClaimOutboxInput {
+    workerId: string;
+    leaseDurationMs: number;
+    limit?: number;
+    tenantId?: string;
+    spaceId?: string;
+    now?: Date;
+}
+interface OutboxPlatformHostStore<TDb> extends PlatformHostStore<TDb> {
+    /** True only when transactionWithEvents supplies appendEventWithOutbox in the same unit of work. */
+    readonly transactionalOutbox?: boolean;
+    appendEventWithOutbox(event: AssetEventEnvelope, metadata: OutboxEventMetadata): Promise<void>;
+    claimOutbox(input: ClaimOutboxInput): Promise<OutboxRecord[]>;
+    markOutboxPublished(id: string, workerId: string, publishedAt: Date): Promise<void>;
+    markOutboxFailed(input: {
+        id: string;
+        workerId: string;
+        error: string;
+        availableAt: Date;
+        deadLetter: boolean;
+    }): Promise<void>;
+    listOutbox(input?: {
+        tenantId?: string;
+        spaceId?: string;
+        statuses?: OutboxStatus[];
+    }): Promise<OutboxRecord[]>;
+}
 /**
  * Optional production capability for atomic domain/event persistence.
  *
@@ -309,6 +377,12 @@ interface PlatformHostOptions<TDb> {
     adapters?: readonly AdapterImplementation[];
     dispatcher?: PlatformActionDispatcher;
     services?: FabricRuntimeServices;
+    /** Requires an outbox-capable store; every canonical event is then appended with delivery state. */
+    outbox?: {
+        producerModuleVersion(actionId: ActionId, actionVersion: number): string;
+        classifyPayload(event: AssetEventEnvelope): EventPayloadClassification;
+        traceContext?(event: AssetEventEnvelope): Record<string, string> | undefined;
+    };
     /** Optional vertical-owned evaluator. When absent, agent behavior is unchanged. */
     hitlEvaluator?: AgentActionPolicyEvaluator;
     /** Durable evaluator/ruleset version recorded with every HITL decision. */
@@ -359,7 +433,7 @@ interface GovernedActionHost {
 
 declare function createGovernedActionHost<TDb>(options: PlatformHostOptions<TDb>): GovernedActionHost;
 
-declare class MemoryPlatformHostStore<TDb> implements RecoverablePlatformHostStore<TDb>, ApprovalPlatformHostStore<TDb>, GovernancePlatformHostStore<TDb> {
+declare class MemoryPlatformHostStore<TDb> implements RecoverablePlatformHostStore<TDb>, ApprovalPlatformHostStore<TDb>, GovernancePlatformHostStore<TDb>, OutboxPlatformHostStore<TDb> {
     readonly db: TDb;
     readonly invocations: ActionInvocationRecord[];
     readonly policyEvaluations: PolicyEvaluationRecord[];
@@ -368,6 +442,7 @@ declare class MemoryPlatformHostStore<TDb> implements RecoverablePlatformHostSto
     readonly policyObligations: PolicyObligationRecord[];
     readonly executionAttestations: ExecutionAttestationRecord[];
     readonly externalReconciliations: ExternalReconciliationRecord[];
+    readonly outbox: OutboxRecord[];
     constructor(db: TDb);
     transaction<TResult>(run: (db: TDb) => Promise<TResult>): Promise<TResult>;
     createActionInvocation(input: CreateActionInvocationInput): Promise<ActionInvocationRecord>;
@@ -390,6 +465,22 @@ declare class MemoryPlatformHostStore<TDb> implements RecoverablePlatformHostSto
     getAdapterInvocation(id: string): Promise<AdapterInvocationRecord | undefined>;
     updateAdapterInvocation(id: string, patch: Partial<Pick<AdapterInvocationRecord, "status" | "output" | "error" | "attempt" | "updatedAt">>): Promise<void>;
     appendEvent(event: AssetEventEnvelope): Promise<void>;
+    appendEventWithOutbox(event: AssetEventEnvelope, metadata: OutboxEventMetadata): Promise<void>;
+    claimOutbox(input: ClaimOutboxInput): Promise<OutboxRecord[]>;
+    markOutboxPublished(id: string, workerId: string, publishedAt: Date): Promise<void>;
+    markOutboxFailed(input: {
+        id: string;
+        workerId: string;
+        error: string;
+        availableAt: Date;
+        deadLetter: boolean;
+    }): Promise<void>;
+    listOutbox(input?: {
+        tenantId?: string;
+        spaceId?: string;
+        statuses?: OutboxStatus[];
+    }): Promise<OutboxRecord[]>;
+    private requireLeasedOutbox;
     nextEventSequence(tenantId: string, spaceId: string): Promise<number>;
     getEntityState(tenantId: string, spaceId: string, entityType: string, entityId: string): Promise<string | undefined>;
     listActionInvocations(input?: ListActionInvocationsInput): Promise<ActionInvocationRecord[]>;
@@ -397,6 +488,29 @@ declare class MemoryPlatformHostStore<TDb> implements RecoverablePlatformHostSto
     listEvents(tenantId: string, spaceId: string): Promise<AssetEventEnvelope[]>;
 }
 
+declare function toEnterpriseEventEnvelope(event: AssetEventEnvelope, metadata: OutboxEventMetadata): EnterpriseEventEnvelope;
+interface EnterpriseEventPublisher {
+    publish(event: EnterpriseEventEnvelope): Promise<void>;
+}
+interface OutboxRelayOptions<TDb> {
+    store: OutboxPlatformHostStore<TDb>;
+    publisher: EnterpriseEventPublisher;
+    workerId: string;
+    leaseDurationMs?: number;
+    batchSize?: number;
+    maxAttempts?: number;
+    retryDelayMs?: (attempt: number) => number;
+    now?: () => Date;
+}
+interface OutboxRelayResult {
+    claimed: number;
+    published: number;
+    failed: number;
+    deadLettered: number;
+}
+declare function runOutboxRelayCycle<TDb>(options: OutboxRelayOptions<TDb>): Promise<OutboxRelayResult>;
+declare function cloneOutboxRecord(record: OutboxRecord): OutboxRecord;
+
 interface PlatformHostSqlResult<Row = Record<string, unknown>> {
     rows: Row[];
 }
@@ -419,10 +533,11 @@ interface PostgresPlatformHostTransactionProvider<TDb> {
     run<TResult>(run: (context: PostgresPlatformHostTransactionContext<TDb>) => Promise<TResult>): Promise<TResult>;
 }
 /** Durable mutation-pipeline ledger for Databricks Lakebase or standard Postgres. */
-declare class PostgresPlatformHostStore<TDb> implements RecoverablePlatformHostStore<TDb>, ApprovalPlatformHostStore<TDb>, GovernancePlatformHostStore<TDb> {
+declare class PostgresPlatformHostStore<TDb> implements RecoverablePlatformHostStore<TDb>, ApprovalPlatformHostStore<TDb>, GovernancePlatformHostStore<TDb>, OutboxPlatformHostStore<TDb> {
     readonly db: TDb;
     private readonly sql;
     readonly transactionWithEvents?: AtomicMutationPlatformHostStore<TDb>["transactionWithEvents"];
+    readonly transactionalOutbox: boolean;
     constructor(db: TDb, sql: PlatformHostSqlClient, transactionProvider?: PostgresPlatformHostTransactionProvider<TDb>);
     ensureSchema(): Promise<void>;
     transaction<TResult>(run: (db: TDb) => Promise<TResult>): Promise<TResult>;
@@ -446,6 +561,21 @@ declare class PostgresPlatformHostStore<TDb> implements RecoverablePlatformHostS
     getAdapterInvocation(id: string): Promise<AdapterInvocationRecord | undefined>;
     updateAdapterInvocation(id: string, patch: Partial<Pick<AdapterInvocationRecord, "status" | "output" | "error" | "attempt" | "updatedAt">>): Promise<void>;
     appendEvent(event: AssetEventEnvelope): Promise<void>;
+    appendEventWithOutbox(event: AssetEventEnvelope, metadata: OutboxEventMetadata): Promise<void>;
+    claimOutbox(input: ClaimOutboxInput): Promise<OutboxRecord[]>;
+    markOutboxPublished(id: string, workerId: string, publishedAt: Date): Promise<void>;
+    markOutboxFailed(input: {
+        id: string;
+        workerId: string;
+        error: string;
+        availableAt: Date;
+        deadLetter: boolean;
+    }): Promise<void>;
+    listOutbox(input?: {
+        tenantId?: string;
+        spaceId?: string;
+        statuses?: OutboxStatus[];
+    }): Promise<OutboxRecord[]>;
     nextEventSequence(tenantId: string, spaceId: string): Promise<number>;
     getEntityState(tenantId: string, spaceId: string, entityType: string, entityId: string): Promise<string | undefined>;
     listActionInvocations(input?: ListActionInvocationsInput): Promise<ActionInvocationRecord[]>;
@@ -463,4 +593,4 @@ declare function runPlatformActionWorkerCycle<TDb>(options: PlatformActionWorker
 /** Poll until aborted. Each iteration is bounded and waits without busy-spinning. */
 declare function runPlatformActionWorker<TDb>(options: PlatformActionWorkerOptions<TDb>): Promise<void>;
 
-export { type ActionApprovalDecision, type ActionAuthorizationInput, type ActionExecutionAuthorizationInput, type ActionExecutionReason, type ActionInvocationRecord, type AdapterInvocationRecord, type AdapterInvocationStatus, type ApprovalDecisionTransitionResult, type ApprovalPlatformHostStore, type AtomicMutationPlatformHostStore, type BeginApprovalDecisionInput, type ClaimActionInvocationsInput, type CreateActionInvocationInput, type DispatchActionInput, type DispatchActionResult, type ExecuteActionResult, type ExecuteInvocationOptions, type ExecutionAttestationRecord, type ExternalReconciliationRecord, type GovernancePlatformHostStore, type GovernedActionHost, type HitlDecisionEvidence, type ListActionInvocationsInput, MemoryPlatformHostStore, PLATFORM_HOST_CONTRACT_VERSION, type PendingAssetEvent, type PersistedActionApprovalDecision, type PlatformActionDispatcher, type PlatformActionWorkerCycleResult, type PlatformActionWorkerOptions, type PlatformHostAuthorization, type PlatformHostMutationTransaction, type PlatformHostOptions, type PlatformHostSqlClient, type PlatformHostSqlResult, type PlatformHostStore, type PolicyEvaluationRecord, type PolicyObligationRecord, PostgresPlatformHostStore, type PostgresPlatformHostTransactionContext, type PostgresPlatformHostTransactionProvider, type RecoverablePlatformHostStore, type SubmitActionInput, type SubmitActionResult, createGovernedActionHost, createStoreBackedActionDispatcher, runPlatformActionWorker, runPlatformActionWorkerCycle };
+export { type ActionApprovalDecision, type ActionAuthorizationInput, type ActionExecutionAuthorizationInput, type ActionExecutionReason, type ActionInvocationRecord, type AdapterInvocationRecord, type AdapterInvocationStatus, type ApprovalDecisionTransitionResult, type ApprovalPlatformHostStore, type AtomicMutationPlatformHostStore, type BeginApprovalDecisionInput, type ClaimActionInvocationsInput, type ClaimOutboxInput, type CreateActionInvocationInput, type DispatchActionInput, type DispatchActionResult, type EnterpriseEventEnvelope, type EnterpriseEventPublisher, type EventPayloadClassification, type ExecuteActionResult, type ExecuteInvocationOptions, type ExecutionAttestationRecord, type ExternalReconciliationRecord, type GovernancePlatformHostStore, type GovernedActionHost, type HitlDecisionEvidence, type ListActionInvocationsInput, MemoryPlatformHostStore, type OutboxEventMetadata, type OutboxPlatformHostStore, type OutboxRecord, type OutboxRelayOptions, type OutboxRelayResult, type OutboxStatus, PLATFORM_HOST_CONTRACT_VERSION, type PendingAssetEvent, type PersistedActionApprovalDecision, type PlatformActionDispatcher, type PlatformActionWorkerCycleResult, type PlatformActionWorkerOptions, type PlatformHostAuthorization, type PlatformHostMutationTransaction, type PlatformHostOptions, type PlatformHostSqlClient, type PlatformHostSqlResult, type PlatformHostStore, type PolicyEvaluationRecord, type PolicyObligationRecord, PostgresPlatformHostStore, type PostgresPlatformHostTransactionContext, type PostgresPlatformHostTransactionProvider, type RecoverablePlatformHostStore, type SubmitActionInput, type SubmitActionResult, cloneOutboxRecord, createGovernedActionHost, createStoreBackedActionDispatcher, runOutboxRelayCycle, runPlatformActionWorker, runPlatformActionWorkerCycle, toEnterpriseEventEnvelope };