@dudousxd/nestjs-agent-store-drizzle 0.20.2 → 0.22.0

package/dist/index.cjs

@@ -23,17 +23,22 @@ var index_exports = {};
 __export(index_exports, {
   DrizzleAgentStore: () => DrizzleAgentStore,
   DrizzleAgentStoreModule: () => DrizzleAgentStoreModule,
+  DrizzleConfirmTokenStore: () => DrizzleConfirmTokenStore,
   DrizzleGovernanceQueries: () => DrizzleGovernanceQueries,
   DrizzleMemoryProvider: () => DrizzleMemoryProvider,
   DrizzlePricingStore: () => DrizzlePricingStore,
   DrizzleRagIngestionLog: () => DrizzleRagIngestionLog,
+  DrizzleStreamFrameTable: () => DrizzleStreamFrameTable,
+  DrizzleTokenStreamSink: () => DrizzleTokenStreamSink,
   RAG_INGESTION_LOG_PAGE_ORDER: () => RAG_INGESTION_LOG_PAGE_ORDER,
+  agentConfirmToken: () => agentConfirmToken,
   agentMemory: () => agentMemory,
   agentMessage: () => agentMessage,
   agentModelPricing: () => agentModelPricing,
   agentQueuedMessage: () => agentQueuedMessage,
   agentRun: () => agentRun,
   agentSchema: () => agentSchema,
+  agentStreamFrame: () => agentStreamFrame,
   agentThread: () => agentThread,
   agentTokenUsage: () => agentTokenUsage,
   agentToolCall: () => agentToolCall,
@@ -307,6 +312,29 @@ var ragIngestionLog = (0, import_sqlite_core.sqliteTable)("rag_ingestion_log", {
 }, (table) => [
   (0, import_sqlite_core.index)("rag_ingestion_log_collection_idx").on(table.collection, table.updatedAt)
 ]);
+var agentConfirmToken = (0, import_sqlite_core.sqliteTable)("agent_confirm_token", {
+  hash: (0, import_sqlite_core.text)("hash").primaryKey(),
+  actorRef: (0, import_sqlite_core.text)("actor_ref").notNull(),
+  tool: (0, import_sqlite_core.text)("tool").notNull(),
+  expiresAt: (0, import_sqlite_core.integer)("expires_at").notNull(),
+  createdAt: (0, import_sqlite_core.integer)("created_at").notNull()
+}, (table) => [
+  (0, import_sqlite_core.index)("agent_confirm_token_expires_idx").on(table.expiresAt)
+]);
+var agentStreamFrame = (0, import_sqlite_core.sqliteTable)("agent_stream_frame", {
+  runId: (0, import_sqlite_core.text)("run_id").notNull(),
+  seq: (0, import_sqlite_core.integer)("seq").notNull(),
+  frame: (0, import_sqlite_core.text)("frame"),
+  error: (0, import_sqlite_core.text)("error"),
+  createdAt: (0, import_sqlite_core.integer)("created_at").notNull()
+}, (table) => [
+  (0, import_sqlite_core.primaryKey)({
+    columns: [
+      table.runId,
+      table.seq
+    ]
+  })
+]);
 var agentSchema = {
   agentThread,
   agentMessage,
@@ -316,7 +344,8 @@ var agentSchema = {
   agentModelPricing,
   agentRun,
   agentMemory,
-  ragIngestionLog
+  ragIngestionLog,
+  agentConfirmToken
 };
 
 // src/ensure-schema.ts
@@ -471,7 +500,24 @@ var statements = [
     updated_at INTEGER NOT NULL
   )`,
   `CREATE INDEX IF NOT EXISTS rag_ingestion_log_collection_idx
-    ON rag_ingestion_log (collection, updated_at)`
+    ON rag_ingestion_log (collection, updated_at)`,
+  `CREATE TABLE IF NOT EXISTS agent_stream_frame (
+    run_id TEXT NOT NULL,
+    seq INTEGER NOT NULL,
+    frame TEXT,
+    error TEXT,
+    created_at INTEGER NOT NULL,
+    PRIMARY KEY (run_id, seq)
+  )`,
+  `CREATE TABLE IF NOT EXISTS agent_confirm_token (
+    hash TEXT PRIMARY KEY NOT NULL,
+    actor_ref TEXT NOT NULL,
+    tool TEXT NOT NULL,
+    expires_at INTEGER NOT NULL,
+    created_at INTEGER NOT NULL
+  )`,
+  `CREATE INDEX IF NOT EXISTS agent_confirm_token_expires_idx
+    ON agent_confirm_token (expires_at)`
 ];
 var additiveColumns = [
   {
@@ -2172,10 +2218,106 @@ var DrizzlePricingStore = class {
   }
 };
 
+// src/drizzle-token-stream-sink.ts
+var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
+var import_drizzle_orm6 = require("drizzle-orm");
+function isUniqueViolation(error) {
+  for (let current = error; current !== null && typeof current === "object"; ) {
+    const code = current.code;
+    if (typeof code === "string" && code.startsWith("SQLITE_CONSTRAINT")) return true;
+    current = current.cause;
+  }
+  return false;
+}
+__name(isUniqueViolation, "isUniqueViolation");
+var DrizzleStreamFrameTable = class {
+  static {
+    __name(this, "DrizzleStreamFrameTable");
+  }
+  db;
+  constructor(db) {
+    this.db = db;
+  }
+  async append(runId, row) {
+    await this.db.run(import_drizzle_orm6.sql`INSERT INTO agent_stream_frame (run_id, seq, frame, error, created_at)
+          SELECT ${runId}, COALESCE(MAX(seq), 0) + 1, ${row.frame}, ${row.error}, ${row.createdAt}
+          FROM agent_stream_frame WHERE run_id = ${runId}`);
+  }
+  async read(runId, after, limit) {
+    return this.db.select({
+      seq: agentStreamFrame.seq,
+      frame: agentStreamFrame.frame,
+      error: agentStreamFrame.error
+    }).from(agentStreamFrame).where((0, import_drizzle_orm6.and)((0, import_drizzle_orm6.eq)(agentStreamFrame.runId, runId), (0, import_drizzle_orm6.gt)(agentStreamFrame.seq, after))).orderBy((0, import_drizzle_orm6.asc)(agentStreamFrame.seq)).limit(limit);
+  }
+  async has(runId) {
+    const rows = await this.db.select({
+      seq: agentStreamFrame.seq
+    }).from(agentStreamFrame).where((0, import_drizzle_orm6.eq)(agentStreamFrame.runId, runId)).limit(1);
+    return rows.length > 0;
+  }
+  async remove(runIds) {
+    if (runIds.length === 0) return;
+    await this.db.delete(agentStreamFrame).where((0, import_drizzle_orm6.inArray)(agentStreamFrame.runId, [
+      ...runIds
+    ]));
+  }
+  async lapsedRuns(cutoff) {
+    const rows = await this.db.select({
+      runId: agentStreamFrame.runId
+    }).from(agentStreamFrame).groupBy(agentStreamFrame.runId).having((0, import_drizzle_orm6.lt)((0, import_drizzle_orm6.max)(agentStreamFrame.createdAt), cutoff));
+    return rows.map((row) => row.runId);
+  }
+  isUniqueViolation(error) {
+    return isUniqueViolation(error);
+  }
+};
+var DrizzleTokenStreamSink = class extends import_nestjs_agent_core4.SqlTokenStreamSink {
+  static {
+    __name(this, "DrizzleTokenStreamSink");
+  }
+  constructor(db, options = {}) {
+    super(new DrizzleStreamFrameTable(db), options);
+  }
+};
+
+// src/drizzle-confirm-token-store.ts
+var import_drizzle_orm7 = require("drizzle-orm");
+var DrizzleConfirmTokenStore = class {
+  static {
+    __name(this, "DrizzleConfirmTokenStore");
+  }
+  db;
+  constructor(db) {
+    this.db = db;
+  }
+  async claim(input) {
+    const inserted = await this.db.insert(agentConfirmToken).values({
+      hash: input.hash,
+      actorRef: input.actorRef,
+      tool: input.tool,
+      expiresAt: input.expiresAt,
+      createdAt: Date.now()
+    }).onConflictDoNothing().returning({
+      hash: agentConfirmToken.hash
+    });
+    return inserted.length === 1;
+  }
+  async release(hash) {
+    await this.db.delete(agentConfirmToken).where((0, import_drizzle_orm7.eq)(agentConfirmToken.hash, hash));
+  }
+  async purgeExpired(now = Date.now()) {
+    const purged = await this.db.delete(agentConfirmToken).where((0, import_drizzle_orm7.lt)(agentConfirmToken.expiresAt, now)).returning({
+      hash: agentConfirmToken.hash
+    });
+    return purged.length;
+  }
+};
+
 // src/drizzle-rag-ingestion-log.ts
 var import_node_diagnostics_channel = require("diagnostics_channel");
 var import_common = require("@nestjs/common");
-var import_drizzle_orm6 = require("drizzle-orm");
+var import_drizzle_orm8 = require("drizzle-orm");
 function _ts_decorate(decorators, target, key, desc4) {
   var c = arguments.length, r = c < 3 ? target : desc4 === null ? desc4 = Object.getOwnPropertyDescriptor(target, key) : desc4, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
@@ -2223,8 +2365,8 @@ function num(value) {
 }
 __name(num, "num");
 var RAG_INGESTION_LOG_PAGE_ORDER = [
-  (0, import_drizzle_orm6.desc)(ragIngestionLog.updatedAt),
-  (0, import_drizzle_orm6.asc)(ragIngestionLog.documentId)
+  (0, import_drizzle_orm8.desc)(ragIngestionLog.updatedAt),
+  (0, import_drizzle_orm8.asc)(ragIngestionLog.documentId)
 ];
 var DEFAULT_PAGE_SIZE = 200;
 var DEFAULT_BATCH_SIZE = 200;
@@ -2288,7 +2430,7 @@ var DrizzleRagIngestionLog = class _DrizzleRagIngestionLog {
   */
   async listPage(query = {}) {
     const [totalRow] = await this.db.select({
-      value: (0, import_drizzle_orm6.count)()
+      value: (0, import_drizzle_orm8.count)()
     }).from(ragIngestionLog).where(this.where(query));
     return {
       rows: await this.list(query),
@@ -2367,19 +2509,19 @@ 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(ragIngestionLog).where((0, import_drizzle_orm6.eq)(ragIngestionLog.documentId, documentId));
+    const [row] = await this.db.select().from(ragIngestionLog).where((0, import_drizzle_orm8.eq)(ragIngestionLog.documentId, documentId));
     return row ?? null;
   }
   /** Forget one document's record. Returns whether a row was actually removed. */
   async remove(documentId) {
-    const removed = await this.db.delete(ragIngestionLog).where((0, import_drizzle_orm6.eq)(ragIngestionLog.documentId, documentId)).returning({
+    const removed = await this.db.delete(ragIngestionLog).where((0, import_drizzle_orm8.eq)(ragIngestionLog.documentId, documentId)).returning({
       documentId: ragIngestionLog.documentId
     });
     return removed.length > 0;
   }
   /** Forget every record for a collection — for when the collection itself is deleted. */
   async removeByCollection(collection) {
-    const removed = await this.db.delete(ragIngestionLog).where((0, import_drizzle_orm6.eq)(ragIngestionLog.collection, collection)).returning({
+    const removed = await this.db.delete(ragIngestionLog).where((0, import_drizzle_orm8.eq)(ragIngestionLog.collection, collection)).returning({
       documentId: ragIngestionLog.documentId
     });
     return removed.length;
@@ -2411,7 +2553,7 @@ var DrizzleRagIngestionLog = class _DrizzleRagIngestionLog {
     }
   }
   where(query) {
-    return (0, import_drizzle_orm6.and)(query.collection !== void 0 ? (0, import_drizzle_orm6.eq)(ragIngestionLog.collection, query.collection) : void 0, query.status !== void 0 ? (0, import_drizzle_orm6.eq)(ragIngestionLog.status, query.status) : void 0);
+    return (0, import_drizzle_orm8.and)(query.collection !== void 0 ? (0, import_drizzle_orm8.eq)(ragIngestionLog.collection, query.collection) : void 0, query.status !== void 0 ? (0, import_drizzle_orm8.eq)(ragIngestionLog.status, query.status) : void 0);
   }
   /**
   * The coordinates filter AND'd with "strictly after `cursor` in
@@ -2426,7 +2568,7 @@ var DrizzleRagIngestionLog = class _DrizzleRagIngestionLog {
     if (cursor === void 0) {
       return base;
     }
-    return (0, import_drizzle_orm6.and)(base, (0, import_drizzle_orm6.or)((0, import_drizzle_orm6.lt)(ragIngestionLog.updatedAt, cursor.updatedAt), (0, import_drizzle_orm6.and)((0, import_drizzle_orm6.eq)(ragIngestionLog.updatedAt, cursor.updatedAt), (0, import_drizzle_orm6.gt)(ragIngestionLog.documentId, cursor.documentId))));
+    return (0, import_drizzle_orm8.and)(base, (0, import_drizzle_orm8.or)((0, import_drizzle_orm8.lt)(ragIngestionLog.updatedAt, cursor.updatedAt), (0, import_drizzle_orm8.and)((0, import_drizzle_orm8.eq)(ragIngestionLog.updatedAt, cursor.updatedAt), (0, import_drizzle_orm8.gt)(ragIngestionLog.documentId, cursor.documentId))));
   }
   /**
   * Upsert one outcome. Keyed by document id so the row always reflects the *current* state — a
@@ -2502,7 +2644,7 @@ DrizzleRagIngestionLog = _ts_decorate([
 ], DrizzleRagIngestionLog);
 
 // src/drizzle-agent-store.module.ts
-var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
 var import_common2 = require("@nestjs/common");
 function _ts_decorate2(decorators, target, key, desc4) {
   var c = arguments.length, r = c < 3 ? target : desc4 === null ? desc4 = Object.getOwnPropertyDescriptor(target, key) : desc4, d;
@@ -2539,7 +2681,7 @@ var DrizzleAgentStoreModule = class _DrizzleAgentStoreModule {
           useFactory: /* @__PURE__ */ __name(() => new DrizzleAgentStore(options.db), "useFactory")
         },
         {
-          provide: import_nestjs_agent_core4.AGENT_STORE,
+          provide: import_nestjs_agent_core5.AGENT_STORE,
           useExisting: DrizzleAgentStore
         },
         // Exported, never bound to AGENT_MEMORY: that token's PRESENCE is what turns memory on, so
@@ -2556,22 +2698,31 @@ var DrizzleAgentStoreModule = class _DrizzleAgentStoreModule {
         // AGENT_PRICING_STORE: the host's own store when supplied, else the default Drizzle one.
         // DrizzleGovernanceQueries prices usage against whatever is bound here.
         options.pricingStore ? {
-          provide: import_nestjs_agent_core4.AGENT_PRICING_STORE,
+          provide: import_nestjs_agent_core5.AGENT_PRICING_STORE,
           useClass: options.pricingStore
         } : {
-          provide: import_nestjs_agent_core4.AGENT_PRICING_STORE,
+          provide: import_nestjs_agent_core5.AGENT_PRICING_STORE,
           useExisting: DrizzlePricingStore
         },
         {
           provide: DrizzleGovernanceQueries,
           useFactory: /* @__PURE__ */ __name((pricingStore) => new DrizzleGovernanceQueries(options.db, pricingStore), "useFactory"),
           inject: [
-            import_nestjs_agent_core4.AGENT_PRICING_STORE
+            import_nestjs_agent_core5.AGENT_PRICING_STORE
           ]
         },
         {
-          provide: import_nestjs_agent_core4.AGENT_GOVERNANCE_QUERIES,
+          provide: import_nestjs_agent_core5.AGENT_GOVERNANCE_QUERIES,
           useExisting: DrizzleGovernanceQueries
+        },
+        // What makes a `defineConfirmedTool` confirmation single use across replicas.
+        {
+          provide: DrizzleConfirmTokenStore,
+          useFactory: /* @__PURE__ */ __name(() => new DrizzleConfirmTokenStore(options.db), "useFactory")
+        },
+        {
+          provide: import_nestjs_agent_core5.AGENT_CONFIRM_TOKEN_STORE,
+          useExisting: DrizzleConfirmTokenStore
         }
       ],
       exports: [
@@ -2579,12 +2730,14 @@ var DrizzleAgentStoreModule = class _DrizzleAgentStoreModule {
           DrizzleRagIngestionLog
         ],
         DrizzleAgentStore,
-        import_nestjs_agent_core4.AGENT_STORE,
+        import_nestjs_agent_core5.AGENT_STORE,
         DrizzleMemoryProvider,
         DrizzleGovernanceQueries,
-        import_nestjs_agent_core4.AGENT_GOVERNANCE_QUERIES,
+        import_nestjs_agent_core5.AGENT_GOVERNANCE_QUERIES,
         DrizzlePricingStore,
-        import_nestjs_agent_core4.AGENT_PRICING_STORE
+        import_nestjs_agent_core5.AGENT_PRICING_STORE,
+        DrizzleConfirmTokenStore,
+        import_nestjs_agent_core5.AGENT_CONFIRM_TOKEN_STORE
       ]
     };
   }
@@ -2596,17 +2749,22 @@ DrizzleAgentStoreModule = _ts_decorate2([
 0 && (module.exports = {
   DrizzleAgentStore,
   DrizzleAgentStoreModule,
+  DrizzleConfirmTokenStore,
   DrizzleGovernanceQueries,
   DrizzleMemoryProvider,
   DrizzlePricingStore,
   DrizzleRagIngestionLog,
+  DrizzleStreamFrameTable,
+  DrizzleTokenStreamSink,
   RAG_INGESTION_LOG_PAGE_ORDER,
+  agentConfirmToken,
   agentMemory,
   agentMessage,
   agentModelPricing,
   agentQueuedMessage,
   agentRun,
   agentSchema,
+  agentStreamFrame,
   agentThread,
   agentTokenUsage,
   agentToolCall,