@axiom-lattice/pg-stores 3.1.0 → 3.1.2

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/pg-stores@3.1.0 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
-CJS dist/index.js     307.76 KB
-CJS dist/index.js.map 570.33 KB
-CJS ⚡️ Build success in 696ms
-ESM dist/index.mjs     300.95 KB
-ESM dist/index.mjs.map 570.04 KB
-ESM ⚡️ Build success in 717ms
+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 16916ms
-DTS dist/index.d.ts  65.28 KB
-DTS dist/index.d.mts 65.28 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,23 @@
 # @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
+
+- 8db9937: huge enhance
+- Updated dependencies [8db9937]
+  - @axiom-lattice/core@4.2.1
+  - @axiom-lattice/protocols@4.1.1
+
 ## 3.1.0
 
 ### Minor Changes

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 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, 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, SkillStore, Skill, CreateSkillRequest } from '@axiom-lattice/protocols';
-export { AgentWebApp, AgentWebAppAppearance, AgentWebAppFeatures, AgentWebAppScope, AgentWebAppStatus, AgentWebAppStore, Assistant, AssistantStore, Binding, BindingRegistry, ChannelInstallation, ChannelInstallationStore, ConnectionEntry, ConnectionStore, CreateAgentWebAppInput, CreateAssistantRequest, CreateBindingInput, 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, 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, ThreadInfo } from '@axiom-lattice/core';
+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';
 import { DocumentInterface } from '@langchain/core/documents';
@@ -620,6 +620,8 @@ declare class PostgreSQLProjectStore implements ProjectStore {
      * Delete a project by ID
      */
     deleteProject(tenantId: string, id: string): Promise<boolean>;
+    updateCapabilityBundleIds(tenantId: string, projectId: string, bundleIds: string[], expectedRevisions?: Record<string, string>): Promise<UpdateProjectCapabilityBundlesResult>;
+    isCapabilityBundleReferenced(tenantId: string, bundleId: string): Promise<boolean>;
 }
 
 interface PostgreSQLUserStoreOptions {
@@ -913,6 +915,7 @@ declare class ThreadMessageQueueStore implements IMessageQueueStore {
      * Add message to queue
      */
     addMessage(params: AddMessageParams): Promise<PendingMessage>;
+    addMessageIfCapacity(params: AddMessageParams, maxSize: number): Promise<boolean>;
     /**
      * Add message at head of queue (high priority, e.g., STEER/Command messages)
      * Uses priority=100 to ensure message is processed first
@@ -921,15 +924,15 @@ declare class ThreadMessageQueueStore implements IMessageQueueStore {
     /**
      * Get pending messages for thread
      */
-    getPendingMessages(threadId: string): Promise<PendingMessage[]>;
+    getPendingMessages(threadId: string, scope?: QueueScope): Promise<PendingMessage[]>;
     /**
      * Get processing messages for a thread
      */
-    getProcessingMessages(threadId: string): Promise<PendingMessage[]>;
+    getProcessingMessages(threadId: string, scope?: QueueScope): Promise<PendingMessage[]>;
     /**
      * Get queue size
      */
-    getQueueSize(threadId: string): Promise<number>;
+    getQueueSize(threadId: string, scope?: QueueScope): Promise<number>;
     /**
      * Get all threads with pending or processing messages
      */
@@ -937,20 +940,20 @@ declare class ThreadMessageQueueStore implements IMessageQueueStore {
     /**
      * Remove message
      */
-    removeMessage(messageId: string): Promise<boolean>;
+    removeMessage(messageId: string, scope?: QueueScope): Promise<boolean>;
     /**
      * Clear all messages for thread
      */
-    clearMessages(threadId: string): Promise<void>;
+    clearMessages(threadId: string, scope?: QueueScope): Promise<void>;
     /**
      * Mark message as processing
      */
-    markProcessing(messageId: string): Promise<void>;
+    markProcessing(messageId: string, customRunConfig?: unknown, scope?: QueueScope): Promise<void>;
     /**
      * Reset all processing messages to pending state for a thread
      * Returns the number of messages reset
      */
-    resetProcessingToPending(threadId: string): Promise<number>;
+    resetProcessingToPending(threadId: string, scope?: QueueScope): Promise<number>;
     private rowToMessage;
 }
 
@@ -974,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[]>;
@@ -1010,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;
@@ -1219,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.
@@ -1234,22 +1239,58 @@ 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. */
     createIfAbsentByEventKey(params: CreateWorkItemIfAbsentRequest): Promise<TaskWorkItem>;
     list(filter: TaskWorkItemListFilter): Promise<TaskWorkItem[]>;
+    /** List pending execution results using one bounded PostgreSQL anti-join query. */
+    listPendingExecutionResults(params: {
+        tenantId: string;
+        taskId: string;
+        limit: number;
+    }): Promise<TaskWorkItem[]>;
+    /** Lists canonical project lifecycle events with an exclusive cursor. */
+    listProjectLifecycleEvents(query: ProjectLifecycleEventQuery): Promise<TaskWorkItem[]>;
+    private assertProjectLifecycleEvent;
     private rowToItem;
 }
 
@@ -1360,6 +1401,214 @@ declare function createPGVectorStoreProvider(connectionString: string): {
     pool: Pool;
 };
 
+/**
+ * Configures PostgreSQL connectivity and migration behavior for capability bundles.
+ *
+ * @remarks
+ * An injected `pool` is externally managed and assumed to have migrations applied.
+ * When `poolConfig` is used, the store owns the pool and runs migrations eagerly
+ * unless `autoMigrate` is false. Call `initialize()` before use in that case.
+ */
+interface PostgreSQLCapabilityBundleStoreOptions {
+    /** Externally managed PostgreSQL pool. */
+    pool?: Pool;
+    /** Connection string or pool configuration used to create an owned pool. */
+    poolConfig?: string | PoolConfig;
+    /** Whether an owned pool should run migrations during construction. @default true */
+    autoMigrate?: boolean;
+}
+/**
+ * Persists tenant-scoped capability bundles in PostgreSQL.
+ *
+ * @example
+ * ```ts
+ * const store = new PostgreSQLCapabilityBundleStore({ poolConfig: connectionString });
+ * await store.initialize();
+ * const bundles = await store.listByTenant("tenant-1");
+ * await store.dispose();
+ * ```
+ *
+ * @remarks
+ * Stores created from `poolConfig` own their pool and must be disposed. Stores
+ * created with an injected pool neither migrate nor close that pool.
+ */
+declare class PostgreSQLCapabilityBundleStore implements CapabilityBundleStore {
+    private readonly pool;
+    private migrationManager;
+    private initialized;
+    private ownsPool;
+    private initPromise;
+    /**
+     * Creates a PostgreSQL capability bundle store.
+     *
+     * @param options - Pool ownership, connection, and migration options.
+     */
+    constructor(options: PostgreSQLCapabilityBundleStoreOptions);
+    /**
+     * Applies pending migrations for an internally managed pool.
+     *
+     * @returns A shared promise that resolves when initialization completes.
+     */
+    initialize(): Promise<void>;
+    private startInitialization;
+    /**
+     * Closes the pool when it was created by this store.
+     *
+     * @returns A promise that resolves after owned resources are released.
+     */
+    dispose(): Promise<void>;
+    private ready;
+    listByTenant(tenantId: string): Promise<CapabilityBundle[]>;
+    getById(tenantId: string, id: string): Promise<CapabilityBundle | null>;
+    getManyByIds(tenantId: string, ids: string[]): Promise<CapabilityBundle[]>;
+    create(tenantId: string, input: InternalCreateCapabilityBundleInput): Promise<CapabilityBundle>;
+    update(tenantId: string, id: string, input: InternalUpdateCapabilityBundleInput): Promise<CapabilityBundle | {
+        status: "conflict";
+    } | null>;
+    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;
@@ -1381,10 +1630,15 @@ declare function createPgStoreConfig(connectionString: string): Promise<{
     taskWorkItem: PostgreSQLTaskWorkItemStore;
     a2aApiKey: PostgreSQLA2AApiKeyStore;
     agentWebApp: PostgreSQLAgentWebAppStore;
+    capabilityBundle: PostgreSQLCapabilityBundleStore;
     schedule: PostgreSQLScheduleStorage;
     menu: MenuStore;
     sharedResource: PostgresSharedResourceStore;
     collection: PostgreSQLCollectionStore;
+    projectRoom: PostgreSQLProjectRoomStore;
+    projectMembership: PostgreSQLProjectMembershipStore;
+    projectBotMembership: PostgreSQLProjectBotMembershipStore;
+    projectRoomMessage: PostgreSQLProjectRoomMessageStore;
     vectorStoreProvider: PGVectorStoreProvider;
     checkpoint: PostgresSaver;
 }>;
@@ -1828,6 +2082,9 @@ declare class ChannelIdentityMappingStore {
     private ensureInitialized;
 }
 
+/** Creates the tenant-scoped capability bundle table. */
+declare const createCapabilityBundlesTable: Migration;
+
 /**
  * Eval table migrations
  */
@@ -1867,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, 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, 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 };