@axiom-lattice/pg-stores 3.1.1 → 3.1.2

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/pg-stores@3.1.1 build /home/runner/work/agentic/agentic/packages/pg-stores
+> @axiom-lattice/pg-stores@3.1.2 build /home/runner/work/agentic/agentic/packages/pg-stores
 > tsup src/index.ts --format cjs,esm --dts --sourcemap
 
 CLI Building entry: src/index.ts
@@ -8,13 +8,13 @@
 CLI Target: es2020
 CJS Build start
 ESM Build start
-ESM dist/index.mjs     323.12 KB
-ESM dist/index.mjs.map 608.59 KB
-ESM ⚡️ Build success in 787ms
-CJS dist/index.js     330.16 KB
-CJS dist/index.js.map 608.90 KB
-CJS ⚡️ Build success in 787ms
+ESM dist/index.mjs     372.32 KB
+ESM dist/index.mjs.map 692.52 KB
+ESM ⚡️ Build success in 1081ms
+CJS dist/index.js     380.26 KB
+CJS dist/index.js.map 692.90 KB
+CJS ⚡️ Build success in 1137ms
 DTS Build start
-DTS ⚡️ Build success in 18255ms
-DTS dist/index.d.ts  69.14 KB
-DTS dist/index.d.mts 69.14 KB
+DTS ⚡️ Build success in 18304ms
+DTS dist/index.d.ts  78.61 KB
+DTS dist/index.d.mts 78.61 KB

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @axiom-lattice/pg-stores
 
+## 3.1.2
+
+### Patch Changes
+
+- 08bf26a: update metric builder
+- Updated dependencies [08bf26a]
+  - @axiom-lattice/core@4.2.2
+  - @axiom-lattice/protocols@4.1.2
+
 ## 3.1.1
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { Pool, PoolConfig, PoolClient } from 'pg';
 export { Pool, PoolConfig } from 'pg';
-import { ThreadStore, Thread, CreateThreadRequest, AssistantStore, Assistant, CreateAssistantRequest, DatabaseConfigStore, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, ConnectionStore, ConnectionEntry, MetricsServerConfigStore, MetricsServerConfigEntry, CreateMetricsServerConfigRequest, UpdateMetricsServerConfigRequest, McpServerConfigStore, McpServerConfigEntry, CreateMcpServerConfigRequest, UpdateMcpServerConfigRequest, WorkspaceStore, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, ProjectStore, ProjectFilter, Project, CreateProjectRequest, UpdateProjectRequest, UpdateProjectCapabilityBundlesResult, UserStore, User, CreateUserRequest, UpdateUserRequest, TenantStore, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLinkStore, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, WorkflowTrackingStore, CreateWorkflowRunRequest, WorkflowRun, UpdateWorkflowRunRequest, QueryWorkflowRunsOptions, QueryWorkflowRunsResult, CreateRunStepRequest, RunStep, UpdateRunStepRequest, StepType, EvalStore, EvalProject, CreateEvalProjectRequest, EvalSuite, CreateEvalSuiteRequest, EvalCase, CreateEvalCaseRequest, EvalRun, CreateEvalRunRequest, EvalRunResult, EvalProjectReport, BindingRegistry, Binding, CreateBindingInput, ChannelInstallationStore, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationRequest, UpdateChannelInstallationRequest, A2AApiKeyStore, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, AgentWebAppStore, AgentWebApp, CreateAgentWebAppInput, AgentWebAppStorePatch, AgentWebAppUpdateOptions, ScheduleStorage, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, TaskStore, CreateTaskRequest, TaskItem, TaskListFilter, UpdateTaskRequest, TaskWorkItemStore, CreateWorkItemRequest, TaskWorkItem, CreateWorkItemIfAbsentRequest, TaskWorkItemListFilter, MenuRegistry, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, SharedResourceStore, ShareRecord, CollectionStore, Collection, CreateCollectionRequest, UpdateCollectionRequest, VectorStoreProvider, VectorStoreCreateParams, CapabilityBundleStore, CapabilityBundle, InternalCreateCapabilityBundleInput, InternalUpdateCapabilityBundleInput, CapabilityBundleDeleteResult, SkillStore, Skill, CreateSkillRequest } from '@axiom-lattice/protocols';
-export { AgentWebApp, AgentWebAppAppearance, AgentWebAppFeatures, AgentWebAppScope, AgentWebAppStatus, AgentWebAppStore, Assistant, AssistantStore, Binding, BindingRegistry, CapabilityBundle, CapabilityBundleStore, ChannelInstallation, ChannelInstallationStore, ConnectionEntry, ConnectionStore, CreateAgentWebAppInput, CreateAssistantRequest, CreateBindingInput, CreateCapabilityBundleInput, CreateChannelInstallationRequest, CreateDatabaseConfigRequest, CreateEvalCaseRequest, CreateEvalProjectRequest, CreateEvalRunRequest, CreateEvalSuiteRequest, CreateMcpServerConfigRequest, CreateMenuItemInput, CreateMetricsServerConfigRequest, CreateProjectRequest, CreateRunStepRequest, CreateShareRequest, CreateSkillRequest, CreateTenantRequest, CreateThreadRequest, CreateUserRequest, CreateUserTenantLinkRequest, CreateWorkflowRunRequest, CreateWorkspaceRequest, DatabaseConfig, DatabaseConfigEntry, DatabaseConfigStore, DatabaseType, EvalCase, EvalProject, EvalProjectReport, EvalRun, EvalRunResult, EvalStore, EvalSuite, LarkChannelInstallationConfig, McpServerConfigEntry, McpServerConfigStore, MenuItem, MenuRegistry, MetricsServerConfig, MetricsServerConfigEntry, MetricsServerConfigStore, Project, ProjectStore, ResourceAddress, RunStep, ScheduleExecutionType, ScheduleStorage, ScheduledTaskDefinition, ScheduledTaskStatus, ShareRecord, ShareResult, ShareVisibility, SharedResourceStore, Skill, SkillStore, StorageType, Tenant, TenantStatus, TenantStore, Thread, ThreadStore, UpdateAgentWebAppInput, UpdateCapabilityBundleInput, UpdateChannelInstallationRequest, UpdateDatabaseConfigRequest, UpdateMcpServerConfigRequest, UpdateMetricsServerConfigRequest, UpdateProjectRequest, UpdateRunStepRequest, UpdateTenantRequest, UpdateUserRequest, UpdateUserTenantLinkRequest, UpdateWorkflowRunRequest, UpdateWorkspaceRequest, User, UserStore, UserTenantLink, UserTenantLinkStore, UserTenantRole, WorkflowRun, WorkflowTrackingStore, Workspace, WorkspaceStore } from '@axiom-lattice/protocols';
+import { ThreadStore, Thread, CreateThreadRequest, AssistantStore, Assistant, CreateAssistantRequest, DatabaseConfigStore, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, ConnectionStore, ConnectionEntry, MetricsServerConfigStore, MetricsServerConfigEntry, CreateMetricsServerConfigRequest, UpdateMetricsServerConfigRequest, McpServerConfigStore, McpServerConfigEntry, CreateMcpServerConfigRequest, UpdateMcpServerConfigRequest, WorkspaceStore, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, ProjectStore, ProjectFilter, Project, CreateProjectRequest, UpdateProjectRequest, UpdateProjectCapabilityBundlesResult, UserStore, User, CreateUserRequest, UpdateUserRequest, TenantStore, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLinkStore, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, WorkflowTrackingStore, CreateWorkflowRunRequest, WorkflowRun, UpdateWorkflowRunRequest, QueryWorkflowRunsOptions, QueryWorkflowRunsResult, CreateRunStepRequest, RunStep, UpdateRunStepRequest, StepType, EvalStore, EvalProject, CreateEvalProjectRequest, EvalSuite, CreateEvalSuiteRequest, EvalCase, CreateEvalCaseRequest, EvalRun, CreateEvalRunRequest, EvalRunResult, EvalProjectReport, BindingRegistry, Binding, CreateBindingInput, BindingMutablePatch, BindingListParams, ChannelInstallationStore, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationInput, UpdateChannelInstallationRequest, A2AApiKeyStore, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, AgentWebAppStore, AgentWebApp, CreateAgentWebAppInput, AgentWebAppStorePatch, AgentWebAppUpdateOptions, ScheduleStorage, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, TaskStore, CreateTaskRequest, TaskItem, TaskListFilter, TaskDependentListQuery, UpdateTaskRequest, TaskMutationSnapshot, TaskWorkItemStore, CreateWorkItemRequest, TaskWorkItem, CreateWorkItemIfAbsentRequest, TaskWorkItemListFilter, ProjectLifecycleEventQuery, MenuRegistry, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, SharedResourceStore, ShareRecord, CollectionStore, Collection, CreateCollectionRequest, UpdateCollectionRequest, VectorStoreProvider, VectorStoreCreateParams, CapabilityBundleStore, CapabilityBundle, InternalCreateCapabilityBundleInput, InternalUpdateCapabilityBundleInput, CapabilityBundleDeleteResult, ProjectRoomStore, ProjectRoom, ProjectMembershipStore, ProjectMembership, ProjectHumanRole, ProjectMembershipMutationResult, ProjectBotMembershipStore, ProjectBotMembership, ProjectRoomMessageStore, ProjectRoomMessage, SkillStore, Skill, CreateSkillRequest } from '@axiom-lattice/protocols';
+export { AgentWebApp, AgentWebAppAppearance, AgentWebAppFeatures, AgentWebAppScope, AgentWebAppStatus, AgentWebAppStore, Assistant, AssistantStore, Binding, BindingRegistry, CapabilityBundle, CapabilityBundleStore, ChannelInstallation, ChannelInstallationStore, ConnectionEntry, ConnectionStore, CreateAgentWebAppInput, CreateAssistantRequest, CreateBindingInput, CreateCapabilityBundleInput, CreateChannelInstallationInput, CreateChannelInstallationRequest, CreateDatabaseConfigRequest, CreateEvalCaseRequest, CreateEvalProjectRequest, CreateEvalRunRequest, CreateEvalSuiteRequest, CreateMcpServerConfigRequest, CreateMenuItemInput, CreateMetricsServerConfigRequest, CreateProjectRequest, CreateRunStepRequest, CreateShareRequest, CreateSkillRequest, CreateTenantRequest, CreateThreadRequest, CreateUserRequest, CreateUserTenantLinkRequest, CreateWorkflowRunRequest, CreateWorkspaceRequest, DatabaseConfig, DatabaseConfigEntry, DatabaseConfigStore, DatabaseType, EvalCase, EvalProject, EvalProjectReport, EvalRun, EvalRunResult, EvalStore, EvalSuite, LarkChannelInstallationConfig, McpServerConfigEntry, McpServerConfigStore, MenuItem, MenuRegistry, MetricsServerConfig, MetricsServerConfigEntry, MetricsServerConfigStore, Project, ProjectStore, ResourceAddress, RunStep, ScheduleExecutionType, ScheduleStorage, ScheduledTaskDefinition, ScheduledTaskStatus, ShareRecord, ShareResult, ShareVisibility, SharedResourceStore, Skill, SkillStore, StorageType, Tenant, TenantStatus, TenantStore, Thread, ThreadStore, UpdateAgentWebAppInput, UpdateCapabilityBundleInput, UpdateChannelInstallationRequest, UpdateDatabaseConfigRequest, UpdateMcpServerConfigRequest, UpdateMetricsServerConfigRequest, UpdateProjectRequest, UpdateRunStepRequest, UpdateTenantRequest, UpdateUserRequest, UpdateUserTenantLinkRequest, UpdateWorkflowRunRequest, UpdateWorkspaceRequest, User, UserStore, UserTenantLink, UserTenantLinkStore, UserTenantRole, WorkflowRun, WorkflowTrackingStore, Workspace, WorkspaceStore } from '@axiom-lattice/protocols';
 import { IMessageQueueStore, AddMessageParams, PendingMessage, QueueScope, ThreadInfo } from '@axiom-lattice/core';
 export { AddMessageParams, PendingMessage, ThreadInfo } from '@axiom-lattice/core';
 import { PostgresSaver } from '@langchain/langgraph-checkpoint-postgres';
@@ -977,18 +977,18 @@ declare class ChannelBindingStore implements BindingRegistry {
         channelInstallationId: string;
         tenantId: string;
     }): Promise<Binding | null>;
-    create(input: CreateBindingInput): Promise<Binding>;
-    update(id: string, patch: Partial<Binding>): Promise<Binding>;
-    delete(id: string): Promise<void>;
-    list(params: {
-        channel?: string;
-        agentId?: string;
+    findById(tenantId: string, id: string): Promise<Binding | null>;
+    findBySubject(params: {
         tenantId: string;
-        channelInstallationId?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<Binding[]>;
-    import(bindings: CreateBindingInput[]): Promise<Binding[]>;
+        channel: string;
+        channelInstallationId: string;
+        senderId: string;
+    }): Promise<Binding | null>;
+    create(input: CreateBindingInput): Promise<Binding>;
+    update(tenantId: string, id: string, patch: BindingMutablePatch): Promise<Binding>;
+    delete(tenantId: string, id: string): Promise<void>;
+    list(params: BindingListParams): Promise<Binding[]>;
+    import(tenantId: string, bindings: CreateBindingInput[]): Promise<Binding[]>;
     export(params: {
         tenantId: string;
     }): Promise<Binding[]>;
@@ -1013,7 +1013,7 @@ declare class PostgreSQLChannelInstallationStore implements ChannelInstallationS
     getInstallationById(installationId: string): Promise<ChannelInstallation | null>;
     getInstallationsByTenant(tenantId: string, channel?: ChannelInstallationType): Promise<ChannelInstallation[]>;
     getAllInstallations(channel?: ChannelInstallationType): Promise<ChannelInstallation[]>;
-    createInstallation(tenantId: string, installationId: string, data: CreateChannelInstallationRequest): Promise<ChannelInstallation>;
+    createInstallation(tenantId: string, installationId: string, data: CreateChannelInstallationInput): Promise<ChannelInstallation>;
     updateInstallation(tenantId: string, installationId: string, updates: UpdateChannelInstallationRequest): Promise<ChannelInstallation | null>;
     deleteInstallation(tenantId: string, installationId: string): Promise<boolean>;
     private ensureInitialized;
@@ -1222,6 +1222,8 @@ declare class PostgreSQLTaskStore implements TaskStore {
     }): Promise<TaskItem>;
     getById(tenantId: string, id: string): Promise<TaskItem | null>;
     list(filter: TaskListFilter): Promise<TaskItem[]>;
+    /** Lists exact project tasks containing a JSON string dependency. */
+    listDependents(query: TaskDependentListQuery): Promise<TaskItem[]>;
     update(tenantId: string, id: string, updates: UpdateTaskRequest): Promise<TaskItem | null>;
     /**
      * Atomically update a task unless its current status is blocked.
@@ -1237,17 +1239,44 @@ declare class PostgreSQLTaskStore implements TaskStore {
     updateIfStatusIn(tenantId: string, id: string, updates: UpdateTaskRequest, expectedStatuses: TaskItem["status"][]): Promise<TaskItem | null>;
     /** Atomically update a task only when status and updatedAt match a read snapshot. */
     updateIfStatusAndUpdatedAt(tenantId: string, id: string, updates: UpdateTaskRequest, expectedStatuses: TaskItem["status"][], expectedUpdatedAt: Date | string): Promise<TaskItem | null>;
+    /** Atomically update only while status, timestamp, owner, and Project scope match. */
+    updateIfSnapshot(tenantId: string, id: string, updates: UpdateTaskRequest, snapshot: TaskMutationSnapshot): Promise<TaskItem | null>;
     /** Atomically update a child only when both child and parent snapshots match. */
     updateIfStatusUpdatedAtAndParentUpdatedAt(tenantId: string, id: string, updates: UpdateTaskRequest, expectedStatuses: TaskItem["status"][], expectedUpdatedAt: Date | string, parentId: string, expectedParentUpdatedAt: Date | string): Promise<TaskItem | null>;
     delete(tenantId: string, id: string): Promise<boolean>;
+    /** Atomically delete only while status, timestamp, owner, and Project scope match. */
+    deleteIfSnapshot(tenantId: string, id: string, snapshot: TaskMutationSnapshot): Promise<boolean>;
     dispose(): Promise<void>;
     private ensureInitialized;
 }
 
+/** PostgreSQL TaskWorkItem store connection and migration options. */
+interface PostgreSQLTaskWorkItemStoreOptions {
+    /** External caller-owned pool; central migrations must already be applied. */
+    pool?: Pool;
+    /** Connection configuration for a standalone, store-owned pool. */
+    poolConfig?: string | PoolConfig;
+    /** Whether a standalone store eagerly applies migrations. Defaults to true. */
+    autoMigrate?: boolean;
+}
+/** PostgreSQL TaskWorkItem persistence with optional standalone migrations. */
 declare class PostgreSQLTaskWorkItemStore implements TaskWorkItemStore {
     private pool;
+    private migrationManager;
+    private initialized;
+    private ownsPool;
+    private initPromise;
     constructor(pool: Pool);
+    constructor(options: PostgreSQLTaskWorkItemStoreOptions);
+    /** Applies the complete standalone TaskWorkItem migration chain once. */
+    initialize(): Promise<void>;
+    /** Closes the pool only when this store created it from connection configuration. */
+    dispose(): Promise<void>;
+    private startInitialization;
+    private ensureInitialized;
     create(params: CreateWorkItemRequest): Promise<TaskWorkItem>;
+    /** Atomically inserts a work item by selecting one exact task snapshot. */
+    createIfTaskSnapshot(params: CreateWorkItemRequest, snapshot: TaskMutationSnapshot): Promise<TaskWorkItem | null>;
     /** Find an event by its tenant- and task-scoped key without pagination. */
     findByEventKey(tenantId: string, taskId: string, eventKey: string): Promise<TaskWorkItem | null>;
     /** Atomically return an existing event or create it once. */
@@ -1259,6 +1288,9 @@ declare class PostgreSQLTaskWorkItemStore implements TaskWorkItemStore {
         taskId: string;
         limit: number;
     }): Promise<TaskWorkItem[]>;
+    /** Lists canonical project lifecycle events with an exclusive cursor. */
+    listProjectLifecycleEvents(query: ProjectLifecycleEventQuery): Promise<TaskWorkItem[]>;
+    private assertProjectLifecycleEvent;
     private rowToItem;
 }
 
@@ -1436,6 +1468,147 @@ declare class PostgreSQLCapabilityBundleStore implements CapabilityBundleStore {
     deleteIfUnreferenced(tenantId: string, id: string): Promise<CapabilityBundleDeleteResult>;
 }
 
+/** Persists tenant-isolated canonical project main rooms in PostgreSQL. */
+declare class PostgreSQLProjectRoomStore implements ProjectRoomStore {
+    /** Creates a store using an externally managed pool; the pool is not migrated or closed. */
+    constructor(options: {
+        pool: Pool;
+    });
+    private readonly pool;
+    /** Creates or returns the single persisted main room for a project. */
+    ensureMainRoom(input: {
+        id: string;
+        tenantId: string;
+        workspaceId: string;
+        projectId: string;
+        name: string;
+    }): Promise<ProjectRoom>;
+    /** Finds a tenant-scoped project's main room, or returns null. */
+    getMainRoom(tenantId: string, projectId: string): Promise<ProjectRoom | null>;
+}
+
+/** Indicates that a tenant/project/user membership already exists. */
+declare class DuplicateProjectMembershipError extends Error {
+    constructor();
+}
+/** Indicates that a membership ID already exists in the tenant. */
+declare class ProjectMembershipIdConflictError extends Error {
+    constructor();
+}
+/** Persists tenant-isolated human project memberships in PostgreSQL. */
+declare class PostgreSQLProjectMembershipStore implements ProjectMembershipStore {
+    /** Creates a store using an externally managed pool; the pool is not migrated or closed. */
+    constructor(options: {
+        pool: Pool;
+    });
+    private readonly pool;
+    /** Lists memberships in stable joined-time and ID order. */
+    list(tenantId: string, projectId: string): Promise<ProjectMembership[]>;
+    /** Finds a membership by exact tenant, project, and user identity. */
+    findByUser(tenantId: string, projectId: string, userId: string): Promise<ProjectMembership | null>;
+    /** Inserts a membership and maps database uniqueness errors to stable typed errors. */
+    create(input: Omit<ProjectMembership, "joinedAt" | "updatedAt">): Promise<ProjectMembership>;
+    /** Atomically creates the first active owner while serializing the project scope. */
+    createInitialOwner(input: Omit<ProjectMembership, "role" | "status" | "joinedAt" | "updatedAt">): Promise<{
+        kind: "created" | "existing";
+        membership: ProjectMembership;
+    } | {
+        kind: "already_initialized";
+    }>;
+    /** Updates a role under a project lock with exact timestamp and owner safeguards. */
+    updateRole(input: {
+        tenantId: string;
+        id: string;
+        role: ProjectHumanRole;
+        expectedUpdatedAt: Date;
+    }): Promise<ProjectMembershipMutationResult>;
+    /** Marks a membership removed under a project lock with exact timestamp and owner safeguards. */
+    remove(input: {
+        tenantId: string;
+        id: string;
+        expectedUpdatedAt: Date;
+    }): Promise<ProjectMembershipMutationResult>;
+    private mutate;
+}
+
+type ConstraintConflict = "coordinator_conflict" | "mention_conflict";
+/** Indicates that a new bot membership ID already exists in the tenant. */
+declare class ProjectBotMembershipIdConflictError extends Error {
+    /** Creates an accurate tenant-scoped membership ID collision error. */
+    constructor(tenantId: string, id: string);
+}
+/** Persists tenant-isolated project bot roster memberships in PostgreSQL. */
+declare class PostgreSQLProjectBotMembershipStore implements ProjectBotMembershipStore {
+    /** Creates a store using an externally managed shared pool. */
+    constructor(options: {
+        pool: Pool;
+    });
+    private readonly pool;
+    /** Lists retained memberships in stable join order. */
+    list(tenantId: string, projectId: string): Promise<ProjectBotMembership[]>;
+    /** Finds a membership by tenant-scoped ID. */
+    findById(tenantId: string, id: string): Promise<ProjectBotMembership | null>;
+    /** Finds an assistant's durable membership in a tenant-scoped project. */
+    findByAssistant(tenantId: string, projectId: string, assistantId: string): Promise<ProjectBotMembership | null>;
+    /** Inserts a new membership or reactivates the assistant's durable membership atomically. */
+    save(input: Omit<ProjectBotMembership, "joinedAt" | "updatedAt">): Promise<{
+        kind: "created" | "updated" | "reactivated";
+        membership: ProjectBotMembership;
+    } | {
+        kind: ConstraintConflict;
+    }>;
+    /** Applies a mutable-field patch with project serialization and millisecond-safe optimistic concurrency. */
+    update(input: {
+        tenantId: string;
+        id: string;
+        patch: Partial<Pick<ProjectBotMembership, "role" | "title" | "responsibility" | "mentionName" | "status">>;
+        expectedUpdatedAt: Date;
+    }): Promise<{
+        kind: "updated";
+        membership: ProjectBotMembership;
+    } | {
+        kind: "not_found" | "conflict" | ConstraintConflict;
+    }>;
+}
+
+/** Indicates that a tenant-scoped room message ID already exists. */
+declare class ProjectRoomMessageIdConflictError extends Error {
+    /** Creates an accurate tenant-scoped message ID collision error. */
+    constructor(tenantId: string, id: string);
+}
+/** Indicates that ordinary creation reused a room-scoped idempotency key. */
+declare class DuplicateProjectRoomMessageIdempotencyKeyError extends Error {
+    /** Creates an accurate tenant and room-scoped idempotency collision error. */
+    constructor(tenantId: string, roomId: string, idempotencyKey: string);
+}
+/** Persists tenant-isolated project room messages in PostgreSQL. */
+declare class PostgreSQLProjectRoomMessageStore implements ProjectRoomMessageStore {
+    /** Creates a store using an externally managed shared pool. */
+    constructor(options: {
+        pool: Pool;
+    });
+    private readonly pool;
+    /** Creates a room message and maps known uniqueness failures to typed errors. */
+    create(input: Omit<ProjectRoomMessage, "createdAt">): Promise<ProjectRoomMessage>;
+    /** Atomically creates or returns the canonical message for a room-scoped idempotency key. */
+    createIdempotent(input: Omit<ProjectRoomMessage, "createdAt"> & {
+        idempotencyKey: string;
+    }): Promise<ProjectRoomMessage>;
+    /** Lists messages newest first using an exclusive stable cursor and a clamped limit. */
+    list(input: {
+        tenantId: string;
+        roomId: string;
+        before?: {
+            createdAt: Date;
+            id: string;
+        };
+        limit: number;
+    }): Promise<ProjectRoomMessage[]>;
+    /** Finds a message by tenant-scoped ID. */
+    findById(tenantId: string, id: string): Promise<ProjectRoomMessage | null>;
+    private parameters;
+}
+
 declare function createPgStoreConfig(connectionString: string): Promise<{
     workspace: PostgreSQLWorkspaceStore;
     project: PostgreSQLProjectStore;
@@ -1462,6 +1635,10 @@ declare function createPgStoreConfig(connectionString: string): Promise<{
     menu: MenuStore;
     sharedResource: PostgresSharedResourceStore;
     collection: PostgreSQLCollectionStore;
+    projectRoom: PostgreSQLProjectRoomStore;
+    projectMembership: PostgreSQLProjectMembershipStore;
+    projectBotMembership: PostgreSQLProjectBotMembershipStore;
+    projectRoomMessage: PostgreSQLProjectRoomMessageStore;
     vectorStoreProvider: PGVectorStoreProvider;
     checkpoint: PostgresSaver;
 }>;
@@ -1947,4 +2124,7 @@ declare const addFileContentType: Migration;
 
 declare const createCollectionsTable: Migration;
 
-export { ChannelBindingStore, type ChannelBindingStoreOptions, type ChannelIdentityMapping, ChannelIdentityMappingStore, type ChannelIdentityMappingStoreOptions, type CreateChannelIdentityMappingInput, MenuStore, type MenuStoreOptions, type Migration, MigrationManager, PGVectorStoreProvider, PostgreSQLA2AApiKeyStore, type PostgreSQLA2AApiKeyStoreOptions, PostgreSQLAgentWebAppStore, type PostgreSQLAgentWebAppStoreOptions, PostgreSQLAssistantStore, type PostgreSQLAssistantStoreOptions, PostgreSQLCapabilityBundleStore, type PostgreSQLCapabilityBundleStoreOptions, PostgreSQLChannelInstallationStore, type PostgreSQLChannelInstallationStoreOptions, PostgreSQLCollectionStore, type PostgreSQLCollectionStoreOptions, PostgreSQLConnectionStore, PostgreSQLDatabaseConfigStore, type PostgreSQLDatabaseConfigStoreOptions, PostgreSQLEvalStore, type PostgreSQLEvalStoreOptions, PostgreSQLMcpServerConfigStore, type PostgreSQLMcpServerConfigStoreOptions, PostgreSQLMetricsServerConfigStore, type PostgreSQLMetricsServerConfigStoreOptions, PostgreSQLProjectStore, type PostgreSQLProjectStoreOptions, PostgreSQLScheduleStorage, type PostgreSQLScheduleStorageOptions, PostgreSQLSkillStore, type PostgreSQLSkillStoreOptions, PostgreSQLTenantStore, type PostgreSQLTenantStoreOptions, type PostgreSQLThreadMessageQueueStoreOptions, PostgreSQLThreadStore, type PostgreSQLThreadStoreOptions, PostgreSQLUserStore, type PostgreSQLUserStoreOptions, PostgreSQLUserTenantLinkStore, type PostgreSQLUserTenantLinkStoreOptions, PostgreSQLWorkflowTrackingStore, type PostgreSQLWorkflowTrackingStoreOptions, PostgreSQLWorkspaceStore, type PostgreSQLWorkspaceStoreOptions, PostgresSharedResourceStore, type PostgresSharedResourceStoreOptions, ThreadMessageQueueStore, addAssistantTenantId, addEnvToEvalRuns, addFileContentType, addHoldoutToEvalRuns, addInterruptColumnsToEval, addInterruptPolicyToEvalCases, addProjectConfigColumn, addScheduleTenantId, addSkillTenantId, addStepThreadId, addTaskIdToEvalRuns, addThreadTenantId, addWorkflowRunsTenantStatusUpdatedIndex, alterChannelInstallationsTable, changeAssistantPrimaryKey, changeSkillPrimaryKey, changeThreadPrimaryKey, createA2AApiKeysTable, createAgentWebAppsTable, createAssistantsTable, createCapabilityBundlesTable, createChannelBindingsTable, createChannelIdentityMappingTables, createChannelInstallationsTable, createCollectionsTable, createDatabaseConfigsTable, createEvalCasesTable, createEvalProjectsTable, createEvalRunResultsTable, createEvalRunsTable, createEvalSuitesTable, createMcpServerConfigsTable, createMenuItemsTable, createMetricsConfigsTable, createPGVectorStoreProvider, createPgStoreConfig, createProjectsTable, createScheduledTasksTable, createSharedResourcesTable, createSkillsTable, createTenantsTable, createThreadMessageQueueTable, createThreadsTable, createUsersTable, createWorkflowTrackingTables, createWorkspacesTable, enforceUniqueEvalProjectName, evalMigrations, mapRowToRunStep, mapRowToWorkflowRun, safeParse };
+/** Creates the tenant-scoped project room, roster, and message tables. */
+declare const createProjectRoomTables: Migration;
+
+export { ChannelBindingStore, type ChannelBindingStoreOptions, type ChannelIdentityMapping, ChannelIdentityMappingStore, type ChannelIdentityMappingStoreOptions, type CreateChannelIdentityMappingInput, DuplicateProjectMembershipError, DuplicateProjectRoomMessageIdempotencyKeyError, MenuStore, type MenuStoreOptions, type Migration, MigrationManager, PGVectorStoreProvider, PostgreSQLA2AApiKeyStore, type PostgreSQLA2AApiKeyStoreOptions, PostgreSQLAgentWebAppStore, type PostgreSQLAgentWebAppStoreOptions, PostgreSQLAssistantStore, type PostgreSQLAssistantStoreOptions, PostgreSQLCapabilityBundleStore, type PostgreSQLCapabilityBundleStoreOptions, PostgreSQLChannelInstallationStore, type PostgreSQLChannelInstallationStoreOptions, PostgreSQLCollectionStore, type PostgreSQLCollectionStoreOptions, PostgreSQLConnectionStore, PostgreSQLDatabaseConfigStore, type PostgreSQLDatabaseConfigStoreOptions, PostgreSQLEvalStore, type PostgreSQLEvalStoreOptions, PostgreSQLMcpServerConfigStore, type PostgreSQLMcpServerConfigStoreOptions, PostgreSQLMetricsServerConfigStore, type PostgreSQLMetricsServerConfigStoreOptions, PostgreSQLProjectBotMembershipStore, PostgreSQLProjectMembershipStore, PostgreSQLProjectRoomMessageStore, PostgreSQLProjectRoomStore, PostgreSQLProjectStore, type PostgreSQLProjectStoreOptions, PostgreSQLScheduleStorage, type PostgreSQLScheduleStorageOptions, PostgreSQLSkillStore, type PostgreSQLSkillStoreOptions, PostgreSQLTaskWorkItemStore, type PostgreSQLTaskWorkItemStoreOptions, PostgreSQLTenantStore, type PostgreSQLTenantStoreOptions, type PostgreSQLThreadMessageQueueStoreOptions, PostgreSQLThreadStore, type PostgreSQLThreadStoreOptions, PostgreSQLUserStore, type PostgreSQLUserStoreOptions, PostgreSQLUserTenantLinkStore, type PostgreSQLUserTenantLinkStoreOptions, PostgreSQLWorkflowTrackingStore, type PostgreSQLWorkflowTrackingStoreOptions, PostgreSQLWorkspaceStore, type PostgreSQLWorkspaceStoreOptions, PostgresSharedResourceStore, type PostgresSharedResourceStoreOptions, ProjectBotMembershipIdConflictError, ProjectMembershipIdConflictError, ProjectRoomMessageIdConflictError, ThreadMessageQueueStore, addAssistantTenantId, addEnvToEvalRuns, addFileContentType, addHoldoutToEvalRuns, addInterruptColumnsToEval, addInterruptPolicyToEvalCases, addProjectConfigColumn, addScheduleTenantId, addSkillTenantId, addStepThreadId, addTaskIdToEvalRuns, addThreadTenantId, addWorkflowRunsTenantStatusUpdatedIndex, alterChannelInstallationsTable, changeAssistantPrimaryKey, changeSkillPrimaryKey, changeThreadPrimaryKey, createA2AApiKeysTable, createAgentWebAppsTable, createAssistantsTable, createCapabilityBundlesTable, createChannelBindingsTable, createChannelIdentityMappingTables, createChannelInstallationsTable, createCollectionsTable, createDatabaseConfigsTable, createEvalCasesTable, createEvalProjectsTable, createEvalRunResultsTable, createEvalRunsTable, createEvalSuitesTable, createMcpServerConfigsTable, createMenuItemsTable, createMetricsConfigsTable, createPGVectorStoreProvider, createPgStoreConfig, createProjectRoomTables, createProjectsTable, createScheduledTasksTable, createSharedResourcesTable, createSkillsTable, createTenantsTable, createThreadMessageQueueTable, createThreadsTable, createUsersTable, createWorkflowTrackingTables, createWorkspacesTable, enforceUniqueEvalProjectName, evalMigrations, mapRowToRunStep, mapRowToWorkflowRun, safeParse };