@dudousxd/nestjs-agent-store-drizzle 0.27.1 → 0.28.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
-import { MessageRole, ToolCallRequest, ToolResult, MessageAttachment, MessageUsage, AgentUiComponent, MessageFeedback, AgentHostContext, Actor, PageContext, QueuePause, ActionProposal, ToolKind, ToolCallStatus, ToolConfirmation, UsagePurpose, AgentStore, ThreadTurnReader, ChatQueueStore, ActionProposalStore, ActionProposalWorkerStore, ActionProposalDiscoveryIndexStore, ActionProposalOutcomeStore, ActionProposalStoreOptions, ActionProposalSupersessionStore, CreateThreadInput, ThreadSummary, ThreadDetail, ThreadTurnQuery, ThreadTurnPage, ToolCallApprovalState, EnqueueMessageInput, QueuedMessage, QueuedMessagePatch, UpdateThreadInput, RecordRunStartInput, AppendMessageInput, StoredMessage, RecordToolCallInput, UpdateToolCallInput, ToolCallOutcome, RecordUsageInput, CreateActionProposal, CreateActionProposalResult, ActionProposalScope, ActionProposalMutationResult, ListActionProposals, ActionProposalDecisionCommand, ClaimActionProposal, ExtendActionProposalLease, SettleActionProposal, ActionProposalOutcomeLease, AgentGovernanceQueries, AgentPricingStore, GovernanceRange, ModelSpendRow, ActorSpendRow, ThreadSpendRow, UsageTrendPoint, ToolCallActivityRow, ThreadActivityRow, RunMetrics, RunAgentBreakdownRow, RunErrorBreakdownRow, RunTrendPoint, RecentRunRow, PendingApprovalRow, ToolStatRow, GovernancePageQuery, ToolCallWhere, GovernancePage, ThreadWhere, RunWhere, ApprovalWhere, GovernanceRunDetail, GovernanceThreadDetailQuery, GovernanceThreadDetail, MemoryProvider, ListMemoriesInput, MemoryRecord, ForgetMemoryInput, StoreMemoryInput, ModelPriceInput, CurrentModelPrice, StreamFrameTable, StreamFrameRow, SqlTokenStreamSink, SqlTokenStreamSinkOptions, ConfirmTokenStore, ConfirmTokenClaim } from '@dudousxd/nestjs-agent-core';
+import { MessageRole, ToolCallRequest, ToolResult, MessageAttachment, MessageUsage, AgentUiComponent, MessageFeedback, AgentHostContext, Actor, PageContext, QueuePause, ActionProposal, ToolKind, ToolCallStatus, ToolConfirmation, UsagePurpose, AgentStore, ThreadTurnReader, ChatQueueStore, ActionProposalStore, ActionProposalWorkerStore, ActionProposalDiscoveryIndexStore, ActionProposalOutcomeStore, ActionProposalStoreOptions, ActionProposalSupersessionStore, CreateThreadInput, ThreadSummary, ThreadDetail, ThreadTurnQuery, ThreadTurnPage, ToolCallApprovalState, EnqueueMessageInput, QueuedMessage, QueuedMessagePatch, UpdateThreadInput, RecordRunStartInput, AppendMessageInput, StoredMessage, RecordToolCallInput, UpdateToolCallInput, ToolCallOutcome, RecordUsageInput, CreateActionProposal, CreateActionProposalResult, ActionProposalScope, ActionProposalMutationResult, ListActionProposals, ActionProposalDecisionCommand, ClaimActionProposal, ExtendActionProposalLease, SettleActionProposal, ActionProposalOutcomeLease, AgentGovernanceQueries, AgentPricingStore, GovernanceRange, ModelSpendRow, ActorSpendRow, ThreadSpendRow, UsageTrendPoint, ToolCallActivityRow, ThreadActivityRow, RunMetrics, RunAgentBreakdownRow, RunErrorBreakdownRow, RunTrendPoint, RecentRunRow, PendingApprovalRow, ToolStatRow, GovernancePageQuery, ToolCallWhere, GovernancePage, ThreadWhere, RunWhere, ApprovalWhere, GovernanceRunDetail, GovernanceThreadDetailQuery, GovernanceThreadDetail, MemoryProvider, ListMemoriesInput, MemoryRecord, ForgetMemoryInput, StoreMemoryInput, ModelPriceInput, CurrentModelPrice, StreamFrameTable, StreamFrameRow, SqlTokenStreamSink, SqlTokenStreamSinkOptions, ConfirmTokenStore, ConfirmTokenClaim, ChannelStore } from '@dudousxd/nestjs-agent-core';
 export { ThreadTurnPage, ThreadTurnQuery } from '@dudousxd/nestjs-agent-core';
 import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
 import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
@@ -2436,6 +2436,92 @@ declare const ragIngestionLog: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
     };
     dialect: "sqlite";
 }>;
+/**
+ * Text channels' short-lived state (`@dudousxd/nestjs-agent-channels`), one row per key: the provider
+ * message ids already answered, a question waiting for the person's answer, an outcome already
+ * relayed. The primary key is the lock a claim takes; `expires_at` is epoch-ms, and past it the row
+ * is free again and dead weight for `DrizzleChannelStore.purgeExpired`. Keys longer than 255
+ * characters are stored by their SHA-256.
+ */
+declare const agentChannelState: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
+    name: "agent_channel_state";
+    schema: undefined;
+    columns: {
+        key: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "key";
+            tableName: "agent_channel_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        value: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "value";
+            tableName: "agent_channel_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        expiresAt: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "expires_at";
+            tableName: "agent_channel_state";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "created_at";
+            tableName: "agent_channel_state";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "sqlite";
+}>;
 /**
  * Spent confirm tokens (`defineConfirmedTool`), one row per token, keyed by its SHA-256 — the
  * primary key is the lock that makes a confirmation single use across replicas. Only the hash, the
@@ -5671,6 +5757,85 @@ declare const agentSchema: {
         };
         dialect: "sqlite";
     }>;
+    agentChannelState: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
+        name: "agent_channel_state";
+        schema: undefined;
+        columns: {
+            key: drizzle_orm_sqlite_core.SQLiteColumn<{
+                name: "key";
+                tableName: "agent_channel_state";
+                dataType: "string";
+                columnType: "SQLiteText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: true;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {
+                length: number | undefined;
+            }>;
+            value: drizzle_orm_sqlite_core.SQLiteColumn<{
+                name: "value";
+                tableName: "agent_channel_state";
+                dataType: "string";
+                columnType: "SQLiteText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {
+                length: number | undefined;
+            }>;
+            expiresAt: drizzle_orm_sqlite_core.SQLiteColumn<{
+                name: "expires_at";
+                tableName: "agent_channel_state";
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            createdAt: drizzle_orm_sqlite_core.SQLiteColumn<{
+                name: "created_at";
+                tableName: "agent_channel_state";
+                dataType: "number";
+                columnType: "SQLiteInteger";
+                data: number;
+                driverParam: number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+        };
+        dialect: "sqlite";
+    }>;
     agentStreamFrame: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
         name: "agent_stream_frame";
         schema: undefined;
@@ -6291,6 +6456,34 @@ declare class DrizzleConfirmTokenStore implements ConfirmTokenStore {
     purgeExpired(now?: number): Promise<number>;
 }
 
+interface DrizzleChannelStoreOptions {
+    /** How often a claim also deletes expired rows. Default 10 minutes; `0` → never (purge yourself). */
+    purgeEveryMs?: number;
+}
+/**
+ * A `ChannelStore` (text channels, `@dudousxd/nestjs-agent-channels`) over the `agent_channel_state`
+ * table — shared by every replica, no Redis needed.
+ *
+ * A claim deletes the key's row when it expired, then inserts it skipping a duplicate key —
+ * `ON CONFLICT DO NOTHING` on SQLite and Postgres, `INSERT IGNORE` on MySQL — so the primary key is
+ * the lock: of two concurrent claims one inserts and the other touches no row. Expired rows are
+ * deleted as claims arrive (`purgeEveryMs`), or by {@link purgeExpired} from a job. The table comes
+ * from `ensureAgentSchema` (or your own migration).
+ */
+declare class DrizzleChannelStore implements ChannelStore {
+    private readonly db;
+    private readonly dialect;
+    private readonly t;
+    private readonly purgeEveryMs;
+    private lastPurge;
+    constructor(db: AgentDrizzleDb, options?: DrizzleChannelStoreOptions);
+    claim(key: string, ttlMs: number): Promise<boolean>;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttlMs: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    purgeExpired(now?: number): Promise<number>;
+}
+
 /**
  * The paging order: newest first, tiebroken on the primary key.
  *
@@ -6508,7 +6701,8 @@ interface DrizzleAgentStoreModuleOptions {
  * `@dudousxd/nestjs-agent`, plus {@link DrizzleGovernanceQueries} to
  * {@link AGENT_GOVERNANCE_QUERIES} (the read-model the dashboard/telescope surfaces consume) and
  * {@link DrizzlePricingStore} to {@link AGENT_PRICING_STORE} (the write side of that pricing table),
- * and {@link DrizzleConfirmTokenStore} to {@link AGENT_CONFIRM_TOKEN_STORE} (confirmed writes).
+ * {@link DrizzleConfirmTokenStore} to {@link AGENT_CONFIRM_TOKEN_STORE} (confirmed writes), and
+ * {@link DrizzleChannelStore} to {@link AGENT_CHANNEL_STORE} (text channels' state).
  * The host app supplies an already-opened Drizzle db — this module never opens a connection itself.
  *
  * The returned module is global, so {@link AGENT_STORE}, {@link AGENT_GOVERNANCE_QUERIES} and
@@ -9100,6 +9294,81 @@ declare const pgAgentSchema: {
         };
         dialect: "pg";
     }>;
+    agentChannelState: drizzle_orm_pg_core.PgTableWithColumns<{
+        name: "agent_channel_state";
+        schema: undefined;
+        columns: {
+            key: drizzle_orm_pg_core.PgColumn<{
+                name: "key";
+                tableName: "agent_channel_state";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: true;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            value: drizzle_orm_pg_core.PgColumn<{
+                name: "value";
+                tableName: "agent_channel_state";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            expiresAt: drizzle_orm_pg_core.PgColumn<{
+                name: "expires_at";
+                tableName: "agent_channel_state";
+                dataType: "number";
+                columnType: "PgBigInt53";
+                data: number;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            createdAt: drizzle_orm_pg_core.PgColumn<{
+                name: "created_at";
+                tableName: "agent_channel_state";
+                dataType: "number";
+                columnType: "PgBigInt53";
+                data: number;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+        };
+        dialect: "pg";
+    }>;
     agentStreamFrame: drizzle_orm_pg_core.PgTableWithColumns<{
         name: "agent_stream_frame";
         schema: undefined;
@@ -11767,6 +12036,81 @@ declare const mysqlAgentSchema: {
         };
         dialect: "mysql";
     }>;
+    agentChannelState: drizzle_orm_mysql_core.MySqlTableWithColumns<{
+        name: "agent_channel_state";
+        schema: undefined;
+        columns: {
+            key: drizzle_orm_mysql_core.MySqlColumn<{
+                name: string;
+                tableName: "agent_channel_state";
+                dataType: "string";
+                columnType: "MySqlVarChar";
+                data: string;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: true;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            value: drizzle_orm_mysql_core.MySqlColumn<{
+                name: "value";
+                tableName: "agent_channel_state";
+                dataType: "string";
+                columnType: "MySqlText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            expiresAt: drizzle_orm_mysql_core.MySqlColumn<{
+                name: "expires_at";
+                tableName: "agent_channel_state";
+                dataType: "number";
+                columnType: "MySqlBigInt53";
+                data: number;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            createdAt: drizzle_orm_mysql_core.MySqlColumn<{
+                name: "created_at";
+                tableName: "agent_channel_state";
+                dataType: "number";
+                columnType: "MySqlBigInt53";
+                data: number;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+        };
+        dialect: "mysql";
+    }>;
     agentStreamFrame: drizzle_orm_mysql_core.MySqlTableWithColumns<{
         name: "agent_stream_frame";
         schema: undefined;
@@ -11861,4 +12205,4 @@ declare const mysqlAgentSchema: {
     }>;
 };
 
-export { type AgentDialect, type AgentDrizzleDb, type AgentMemoryRow, type AgentMessageRow, type AgentMySqlDb, type AgentPgDb, type AgentQueuedMessageRow, type AgentRunRow, type AgentRunStatus, type AgentSqliteDb, type AgentThreadRow, DrizzleActionProposalStore, DrizzleAgentStore, DrizzleAgentStoreModule, type DrizzleAgentStoreModuleOptions, DrizzleConfirmTokenStore, DrizzleGovernanceQueries, DrizzleMemoryProvider, DrizzlePricingStore, DrizzleRagIngestionLog, DrizzleStreamFrameTable, DrizzleTokenStreamSink, RAG_INGESTION_LOG_PAGE_ORDER, type RagIngestionLogCursor, type RagIngestionLogIterateOptions, type RagIngestionLogQuery, type RagIngestionLogRow, type RagIngestionLogWhere, type RagIngestionStatus, agentActionProposal, agentConfirmToken, agentDialectOf, agentMemory, agentMessage, agentModelPricing, agentQueuedMessage, agentRun, agentSchema, agentSchemaDdl, agentStreamFrame, agentThread, agentTokenUsage, agentToolCall, ensureAgentSchema, mysqlAgentSchema, pgAgentSchema, ragIngestionLog };
+export { type AgentDialect, type AgentDrizzleDb, type AgentMemoryRow, type AgentMessageRow, type AgentMySqlDb, type AgentPgDb, type AgentQueuedMessageRow, type AgentRunRow, type AgentRunStatus, type AgentSqliteDb, type AgentThreadRow, DrizzleActionProposalStore, DrizzleAgentStore, DrizzleAgentStoreModule, type DrizzleAgentStoreModuleOptions, DrizzleChannelStore, type DrizzleChannelStoreOptions, DrizzleConfirmTokenStore, DrizzleGovernanceQueries, DrizzleMemoryProvider, DrizzlePricingStore, DrizzleRagIngestionLog, DrizzleStreamFrameTable, DrizzleTokenStreamSink, RAG_INGESTION_LOG_PAGE_ORDER, type RagIngestionLogCursor, type RagIngestionLogIterateOptions, type RagIngestionLogQuery, type RagIngestionLogRow, type RagIngestionLogWhere, type RagIngestionStatus, agentActionProposal, agentChannelState, agentConfirmToken, agentDialectOf, agentMemory, agentMessage, agentModelPricing, agentQueuedMessage, agentRun, agentSchema, agentSchemaDdl, agentStreamFrame, agentThread, agentTokenUsage, agentToolCall, ensureAgentSchema, mysqlAgentSchema, pgAgentSchema, ragIngestionLog };

package/dist/index.js

@@ -290,6 +290,14 @@ var ragIngestionLog = sqliteTable("rag_ingestion_log", {
 }, (table) => [
   index("rag_ingestion_log_collection_idx").on(table.collection, table.updatedAt)
 ]);
+var agentChannelState = sqliteTable("agent_channel_state", {
+  key: text("key").primaryKey(),
+  value: text("value"),
+  expiresAt: integer("expires_at").notNull(),
+  createdAt: integer("created_at").notNull()
+}, (table) => [
+  index("agent_channel_state_expires_idx").on(table.expiresAt)
+]);
 var agentConfirmToken = sqliteTable("agent_confirm_token", {
   hash: text("hash").primaryKey(),
   actorRef: text("actor_ref").notNull(),
@@ -352,6 +360,7 @@ var agentSchema = {
   agentMemory,
   ragIngestionLog,
   agentConfirmToken,
+  agentChannelState,
   agentStreamFrame
 };
 
@@ -548,6 +557,18 @@ var ragIngestionLog2 = mysqlTable("rag_ingestion_log", {
 }, (table) => [
   index2("rag_ingestion_log_collection_idx").on(table.collection, table.updatedAt)
 ]);
+var agentChannelState2 = mysqlTable("agent_channel_state", {
+  key: key("key").primaryKey(),
+  value: longtext("value"),
+  expiresAt: bigint("expires_at", {
+    mode: "number"
+  }).notNull(),
+  createdAt: bigint("created_at", {
+    mode: "number"
+  }).notNull()
+}, (table) => [
+  index2("agent_channel_state_expires_idx").on(table.expiresAt)
+]);
 var agentConfirmToken2 = mysqlTable("agent_confirm_token", {
   hash: key("hash").primaryKey(),
   actorRef: key("actor_ref").notNull(),
@@ -633,6 +654,7 @@ var mysqlAgentSchema = {
   agentMemory: agentMemory2,
   ragIngestionLog: ragIngestionLog2,
   agentConfirmToken: agentConfirmToken2,
+  agentChannelState: agentChannelState2,
   agentStreamFrame: agentStreamFrame2
 };
 
@@ -816,6 +838,18 @@ var ragIngestionLog3 = pgTable("rag_ingestion_log", {
 }, (table) => [
   index3("rag_ingestion_log_collection_idx").on(table.collection, table.updatedAt)
 ]);
+var agentChannelState3 = pgTable("agent_channel_state", {
+  key: text2("key").primaryKey(),
+  value: text2("value"),
+  expiresAt: bigint2("expires_at", {
+    mode: "number"
+  }).notNull(),
+  createdAt: bigint2("created_at", {
+    mode: "number"
+  }).notNull()
+}, (table) => [
+  index3("agent_channel_state_expires_idx").on(table.expiresAt)
+]);
 var agentConfirmToken3 = pgTable("agent_confirm_token", {
   hash: text2("hash").primaryKey(),
   actorRef: text2("actor_ref").notNull(),
@@ -899,6 +933,7 @@ var pgAgentSchema = {
   agentMemory: agentMemory3,
   ragIngestionLog: ragIngestionLog3,
   agentConfirmToken: agentConfirmToken3,
+  agentChannelState: agentChannelState3,
   agentStreamFrame: agentStreamFrame3
 };
 
@@ -3531,10 +3566,82 @@ var DrizzleConfirmTokenStore = class {
   }
 };
 
+// src/drizzle-channel-store.ts
+import { createHash as createHash2 } from "crypto";
+import { and as and7, eq as eq8, gt as gt3, lte as lte4 } from "drizzle-orm";
+var channelStateKey = /* @__PURE__ */ __name((key2) => key2.length <= 255 ? key2 : `sha256:${createHash2("sha256").update(key2).digest("hex")}`, "channelStateKey");
+var DrizzleChannelStore = class {
+  static {
+    __name(this, "DrizzleChannelStore");
+  }
+  db;
+  dialect;
+  t;
+  purgeEveryMs;
+  lastPurge = 0;
+  constructor(db, options = {}) {
+    this.dialect = agentDialectOf(db);
+    this.t = agentTablesFor(this.dialect);
+    this.db = asBuilder(db);
+    this.purgeEveryMs = options.purgeEveryMs ?? 10 * 60 * 1e3;
+  }
+  async claim(key2, ttlMs) {
+    const table = this.t.agentChannelState;
+    const now = Date.now();
+    if (this.purgeEveryMs > 0 && now - this.lastPurge >= this.purgeEveryMs) {
+      this.lastPurge = now;
+      await this.purgeExpired(now);
+    }
+    const id = channelStateKey(key2);
+    await this.db.delete(table).where(and7(eq8(table.key, id), lte4(table.expiresAt, now)));
+    const row = {
+      key: id,
+      value: null,
+      expiresAt: now + ttlMs,
+      createdAt: now
+    };
+    if (this.dialect === "mysql") {
+      const insert = this.db.insert(table);
+      return mysqlAffectedRows(await insert.ignore().values(row)) === 1;
+    }
+    const inserted = await affectedRows(this.dialect, this.db.insert(table).values(row).onConflictDoNothing(), table.key);
+    return inserted === 1;
+  }
+  async get(key2) {
+    const table = this.t.agentChannelState;
+    const rows = await this.db.select({
+      value: table.value
+    }).from(table).where(and7(eq8(table.key, channelStateKey(key2)), gt3(table.expiresAt, Date.now())));
+    const value = rows[0]?.value;
+    return typeof value === "string" ? value : null;
+  }
+  async set(key2, value, ttlMs) {
+    const table = this.t.agentChannelState;
+    const now = Date.now();
+    await upsert(this.dialect, this.db.insert(table).values({
+      key: channelStateKey(key2),
+      value,
+      expiresAt: now + ttlMs,
+      createdAt: now
+    }), table.key, {
+      value,
+      expiresAt: now + ttlMs
+    });
+  }
+  async delete(key2) {
+    const table = this.t.agentChannelState;
+    await this.db.delete(table).where(eq8(table.key, channelStateKey(key2)));
+  }
+  async purgeExpired(now = Date.now()) {
+    const table = this.t.agentChannelState;
+    return affectedRows(this.dialect, this.db.delete(table).where(lte4(table.expiresAt, now)), table.key);
+  }
+};
+
 // src/drizzle-rag-ingestion-log.ts
 import { subscribe, unsubscribe } from "diagnostics_channel";
 import { Injectable, Logger } from "@nestjs/common";
-import { and as and7, asc as asc5, count as count2, desc as desc3, eq as eq8, gt as gt3, lt as lt3, or as or3 } from "drizzle-orm";
+import { and as and8, asc as asc5, count as count2, desc as desc3, eq as eq9, gt as gt4, lt as lt3, or as or3 } from "drizzle-orm";
 function _ts_decorate(decorators, target, key2, desc4) {
   var c = arguments.length, r = c < 3 ? target : desc4 === null ? desc4 = Object.getOwnPropertyDescriptor(target, key2) : desc4, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
@@ -3733,17 +3840,17 @@ var DrizzleRagIngestionLog = class _DrizzleRagIngestionLog {
   }
   /** The latest recorded outcome for one document, or null if it was never attempted. */
   async get(documentId) {
-    const [row] = await this.db.select().from(this.t.ragIngestionLog).where(eq8(this.t.ragIngestionLog.documentId, documentId));
+    const [row] = await this.db.select().from(this.t.ragIngestionLog).where(eq9(this.t.ragIngestionLog.documentId, documentId));
     return row ?? null;
   }
   /** Forget one document's record. Returns whether a row was actually removed. */
   async remove(documentId) {
-    const removed = await affectedRows(this.dialect, this.db.delete(this.t.ragIngestionLog).where(eq8(this.t.ragIngestionLog.documentId, documentId)), this.t.ragIngestionLog.documentId);
+    const removed = await affectedRows(this.dialect, this.db.delete(this.t.ragIngestionLog).where(eq9(this.t.ragIngestionLog.documentId, documentId)), this.t.ragIngestionLog.documentId);
     return removed > 0;
   }
   /** Forget every record for a collection — for when the collection itself is deleted. */
   async removeByCollection(collection) {
-    const removed = await affectedRows(this.dialect, this.db.delete(this.t.ragIngestionLog).where(eq8(this.t.ragIngestionLog.collection, collection)), this.t.ragIngestionLog.documentId);
+    const removed = await affectedRows(this.dialect, this.db.delete(this.t.ragIngestionLog).where(eq9(this.t.ragIngestionLog.collection, collection)), this.t.ragIngestionLog.documentId);
     return removed;
   }
   /**
@@ -3773,7 +3880,7 @@ var DrizzleRagIngestionLog = class _DrizzleRagIngestionLog {
     }
   }
   where(query) {
-    return and7(query.collection !== void 0 ? eq8(this.t.ragIngestionLog.collection, query.collection) : void 0, query.status !== void 0 ? eq8(this.t.ragIngestionLog.status, query.status) : void 0);
+    return and8(query.collection !== void 0 ? eq9(this.t.ragIngestionLog.collection, query.collection) : void 0, query.status !== void 0 ? eq9(this.t.ragIngestionLog.status, query.status) : void 0);
   }
   /**
   * The coordinates filter AND'd with "strictly after `cursor` in
@@ -3788,7 +3895,7 @@ var DrizzleRagIngestionLog = class _DrizzleRagIngestionLog {
     if (cursor === void 0) {
       return base;
     }
-    return and7(base, or3(lt3(this.t.ragIngestionLog.updatedAt, cursor.updatedAt), and7(eq8(this.t.ragIngestionLog.updatedAt, cursor.updatedAt), gt3(this.t.ragIngestionLog.documentId, cursor.documentId))));
+    return and8(base, or3(lt3(this.t.ragIngestionLog.updatedAt, cursor.updatedAt), and8(eq9(this.t.ragIngestionLog.updatedAt, cursor.updatedAt), gt4(this.t.ragIngestionLog.documentId, cursor.documentId))));
   }
   /**
   * Upsert one outcome. Keyed by document id so the row always reflects the *current* state — a
@@ -3861,7 +3968,7 @@ DrizzleRagIngestionLog = _ts_decorate([
 ], DrizzleRagIngestionLog);
 
 // src/drizzle-agent-store.module.ts
-import { AGENT_CONFIRM_TOKEN_STORE, AGENT_GOVERNANCE_QUERIES, AGENT_PRICING_STORE, AGENT_STORE } from "@dudousxd/nestjs-agent-core";
+import { AGENT_CHANNEL_STORE, AGENT_CONFIRM_TOKEN_STORE, AGENT_GOVERNANCE_QUERIES, AGENT_PRICING_STORE, AGENT_STORE } from "@dudousxd/nestjs-agent-core";
 import { Module } from "@nestjs/common";
 function _ts_decorate2(decorators, target, key2, desc4) {
   var c = arguments.length, r = c < 3 ? target : desc4 === null ? desc4 = Object.getOwnPropertyDescriptor(target, key2) : desc4, d;
@@ -3940,6 +4047,15 @@ var DrizzleAgentStoreModule = class _DrizzleAgentStoreModule {
         {
           provide: AGENT_CONFIRM_TOKEN_STORE,
           useExisting: DrizzleConfirmTokenStore
+        },
+        // Text channels' state (`@dudousxd/nestjs-agent-channels`), shared by every replica.
+        {
+          provide: DrizzleChannelStore,
+          useFactory: /* @__PURE__ */ __name(() => new DrizzleChannelStore(options.db), "useFactory")
+        },
+        {
+          provide: AGENT_CHANNEL_STORE,
+          useExisting: DrizzleChannelStore
         }
       ],
       exports: [
@@ -3954,7 +4070,9 @@ var DrizzleAgentStoreModule = class _DrizzleAgentStoreModule {
         DrizzlePricingStore,
         AGENT_PRICING_STORE,
         DrizzleConfirmTokenStore,
-        AGENT_CONFIRM_TOKEN_STORE
+        AGENT_CONFIRM_TOKEN_STORE,
+        DrizzleChannelStore,
+        AGENT_CHANNEL_STORE
       ]
     };
   }
@@ -3966,6 +4084,7 @@ export {
   DrizzleActionProposalStore,
   DrizzleAgentStore,
   DrizzleAgentStoreModule,
+  DrizzleChannelStore,
   DrizzleConfirmTokenStore,
   DrizzleGovernanceQueries,
   DrizzleMemoryProvider,
@@ -3975,6 +4094,7 @@ export {
   DrizzleTokenStreamSink,
   RAG_INGESTION_LOG_PAGE_ORDER,
   agentActionProposal,
+  agentChannelState,
   agentConfirmToken,
   agentDialectOf,
   agentMemory,