@okf/ootils 1.41.0 → 1.41.2

package/dist/node.d.mts

@@ -495,7 +495,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_4 as workerConfig };
     }
-    namespace AI_AUTO_ANNOTATE_QUEUE {
+    namespace AI_AUTO_ANNOTATE_PREP_QUEUE {
         let id_5: string;
         export { id_5 as id };
         export namespace queueConfig_5 {
@@ -535,7 +535,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_5 as workerConfig };
     }
-    namespace AI_AUTO_ANNOTATE_CHUNK_QUEUE {
+    namespace AI_AUTO_ANNOTATE_QUEUE {
         let id_6: string;
         export { id_6 as id };
         export namespace queueConfig_6 {
@@ -575,7 +575,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_6 as workerConfig };
     }
-    namespace ANNOS_ELASTIC_SYNC_QUEUE {
+    namespace AI_AUTO_ANNOTATE_CHUNK_QUEUE {
         let id_7: string;
         export { id_7 as id };
         export namespace queueConfig_7 {
@@ -615,7 +615,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_7 as workerConfig };
     }
-    namespace CHUNKS_ELASTIC_SYNC_QUEUE {
+    namespace ANNOS_ELASTIC_SYNC_QUEUE {
         let id_8: string;
         export { id_8 as id };
         export namespace queueConfig_8 {
@@ -655,7 +655,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_8 as workerConfig };
     }
-    namespace USERS_ELASTIC_SYNC_QUEUE {
+    namespace CHUNKS_ELASTIC_SYNC_QUEUE {
         let id_9: string;
         export { id_9 as id };
         export namespace queueConfig_9 {
@@ -695,7 +695,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_9 as workerConfig };
     }
-    namespace CONTENT_ELASTIC_SYNC_QUEUE {
+    namespace USERS_ELASTIC_SYNC_QUEUE {
         let id_10: string;
         export { id_10 as id };
         export namespace queueConfig_10 {
@@ -735,7 +735,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_10 as workerConfig };
     }
-    namespace SARVAM_TRANSCRIPTION_QUEUE {
+    namespace CONTENT_ELASTIC_SYNC_QUEUE {
         let id_11: string;
         export { id_11 as id };
         export namespace queueConfig_11 {
@@ -775,7 +775,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_11 as workerConfig };
     }
-    namespace INTERCOM_CONVERSATIONS_QUEUE {
+    namespace SARVAM_TRANSCRIPTION_QUEUE {
         let id_12: string;
         export { id_12 as id };
         export namespace queueConfig_12 {
@@ -815,7 +815,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_12 as workerConfig };
     }
-    namespace TAG_SYNC_PLAN_QUEUE {
+    namespace INTERCOM_CONVERSATIONS_QUEUE {
         let id_13: string;
         export { id_13 as id };
         export namespace queueConfig_13 {
@@ -855,7 +855,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_13 as workerConfig };
     }
-    namespace TAG_SYNC_BATCH_QUEUE {
+    namespace TAG_SYNC_PLAN_QUEUE {
         let id_14: string;
         export { id_14 as id };
         export namespace queueConfig_14 {
@@ -895,11 +895,13 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_14 as workerConfig };
     }
-    namespace SCHEDULED_EXTERNAL_SYNC_QUEUE {
+    namespace TAG_SYNC_BATCH_QUEUE {
         let id_15: string;
         export { id_15 as id };
         export namespace queueConfig_15 {
             export namespace defaultJobOptions_15 {
+                let attempts_15: number;
+                export { attempts_15 as attempts };
                 export namespace backoff_15 {
                     let type_15: string;
                     export { type_15 as type };
@@ -907,8 +909,6 @@ declare namespace BASE_BULLMQ_CONFIG {
                     export { delay_15 as delay };
                 }
                 export { backoff_15 as backoff };
-                let attempts_15: number;
-                export { attempts_15 as attempts };
                 let removeOnComplete_15: number;
                 export { removeOnComplete_15 as removeOnComplete };
                 let removeOnFail_15: number;
@@ -935,13 +935,11 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_15 as workerConfig };
     }
-    namespace REINDEX_QUEUE {
+    namespace SCHEDULED_EXTERNAL_SYNC_QUEUE {
         let id_16: string;
         export { id_16 as id };
         export namespace queueConfig_16 {
             export namespace defaultJobOptions_16 {
-                let attempts_16: number;
-                export { attempts_16 as attempts };
                 export namespace backoff_16 {
                     let type_16: string;
                     export { type_16 as type };
@@ -949,8 +947,8 @@ declare namespace BASE_BULLMQ_CONFIG {
                     export { delay_16 as delay };
                 }
                 export { backoff_16 as backoff };
-                let delay_17: number;
-                export { delay_17 as delay };
+                let attempts_16: number;
+                export { attempts_16 as attempts };
                 let removeOnComplete_16: number;
                 export { removeOnComplete_16 as removeOnComplete };
                 let removeOnFail_16: number;
@@ -977,6 +975,48 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_16 as workerConfig };
     }
+    namespace REINDEX_QUEUE {
+        let id_17: string;
+        export { id_17 as id };
+        export namespace queueConfig_17 {
+            export namespace defaultJobOptions_17 {
+                let attempts_17: number;
+                export { attempts_17 as attempts };
+                export namespace backoff_17 {
+                    let type_17: string;
+                    export { type_17 as type };
+                    let delay_17: number;
+                    export { delay_17 as delay };
+                }
+                export { backoff_17 as backoff };
+                let delay_18: number;
+                export { delay_18 as delay };
+                let removeOnComplete_17: number;
+                export { removeOnComplete_17 as removeOnComplete };
+                let removeOnFail_17: number;
+                export { removeOnFail_17 as removeOnFail };
+            }
+            export { defaultJobOptions_17 as defaultJobOptions };
+            export namespace streams_17 {
+                export namespace events_17 {
+                    let maxLen_17: number;
+                    export { maxLen_17 as maxLen };
+                }
+                export { events_17 as events };
+            }
+            export { streams_17 as streams };
+        }
+        export { queueConfig_17 as queueConfig };
+        export namespace workerConfig_17 {
+            let concurrency_17: number;
+            export { concurrency_17 as concurrency };
+            let lockDuration_17: number;
+            export { lockDuration_17 as lockDuration };
+            let maxStalledCount_17: number;
+            export { maxStalledCount_17 as maxStalledCount };
+        }
+        export { workerConfig_17 as workerConfig };
+    }
 }
 
 interface PlatformContextContentItem {

package/dist/node.d.ts

@@ -495,7 +495,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_4 as workerConfig };
     }
-    namespace AI_AUTO_ANNOTATE_QUEUE {
+    namespace AI_AUTO_ANNOTATE_PREP_QUEUE {
         let id_5: string;
         export { id_5 as id };
         export namespace queueConfig_5 {
@@ -535,7 +535,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_5 as workerConfig };
     }
-    namespace AI_AUTO_ANNOTATE_CHUNK_QUEUE {
+    namespace AI_AUTO_ANNOTATE_QUEUE {
         let id_6: string;
         export { id_6 as id };
         export namespace queueConfig_6 {
@@ -575,7 +575,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_6 as workerConfig };
     }
-    namespace ANNOS_ELASTIC_SYNC_QUEUE {
+    namespace AI_AUTO_ANNOTATE_CHUNK_QUEUE {
         let id_7: string;
         export { id_7 as id };
         export namespace queueConfig_7 {
@@ -615,7 +615,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_7 as workerConfig };
     }
-    namespace CHUNKS_ELASTIC_SYNC_QUEUE {
+    namespace ANNOS_ELASTIC_SYNC_QUEUE {
         let id_8: string;
         export { id_8 as id };
         export namespace queueConfig_8 {
@@ -655,7 +655,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_8 as workerConfig };
     }
-    namespace USERS_ELASTIC_SYNC_QUEUE {
+    namespace CHUNKS_ELASTIC_SYNC_QUEUE {
         let id_9: string;
         export { id_9 as id };
         export namespace queueConfig_9 {
@@ -695,7 +695,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_9 as workerConfig };
     }
-    namespace CONTENT_ELASTIC_SYNC_QUEUE {
+    namespace USERS_ELASTIC_SYNC_QUEUE {
         let id_10: string;
         export { id_10 as id };
         export namespace queueConfig_10 {
@@ -735,7 +735,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_10 as workerConfig };
     }
-    namespace SARVAM_TRANSCRIPTION_QUEUE {
+    namespace CONTENT_ELASTIC_SYNC_QUEUE {
         let id_11: string;
         export { id_11 as id };
         export namespace queueConfig_11 {
@@ -775,7 +775,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_11 as workerConfig };
     }
-    namespace INTERCOM_CONVERSATIONS_QUEUE {
+    namespace SARVAM_TRANSCRIPTION_QUEUE {
         let id_12: string;
         export { id_12 as id };
         export namespace queueConfig_12 {
@@ -815,7 +815,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_12 as workerConfig };
     }
-    namespace TAG_SYNC_PLAN_QUEUE {
+    namespace INTERCOM_CONVERSATIONS_QUEUE {
         let id_13: string;
         export { id_13 as id };
         export namespace queueConfig_13 {
@@ -855,7 +855,7 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_13 as workerConfig };
     }
-    namespace TAG_SYNC_BATCH_QUEUE {
+    namespace TAG_SYNC_PLAN_QUEUE {
         let id_14: string;
         export { id_14 as id };
         export namespace queueConfig_14 {
@@ -895,11 +895,13 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_14 as workerConfig };
     }
-    namespace SCHEDULED_EXTERNAL_SYNC_QUEUE {
+    namespace TAG_SYNC_BATCH_QUEUE {
         let id_15: string;
         export { id_15 as id };
         export namespace queueConfig_15 {
             export namespace defaultJobOptions_15 {
+                let attempts_15: number;
+                export { attempts_15 as attempts };
                 export namespace backoff_15 {
                     let type_15: string;
                     export { type_15 as type };
@@ -907,8 +909,6 @@ declare namespace BASE_BULLMQ_CONFIG {
                     export { delay_15 as delay };
                 }
                 export { backoff_15 as backoff };
-                let attempts_15: number;
-                export { attempts_15 as attempts };
                 let removeOnComplete_15: number;
                 export { removeOnComplete_15 as removeOnComplete };
                 let removeOnFail_15: number;
@@ -935,13 +935,11 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_15 as workerConfig };
     }
-    namespace REINDEX_QUEUE {
+    namespace SCHEDULED_EXTERNAL_SYNC_QUEUE {
         let id_16: string;
         export { id_16 as id };
         export namespace queueConfig_16 {
             export namespace defaultJobOptions_16 {
-                let attempts_16: number;
-                export { attempts_16 as attempts };
                 export namespace backoff_16 {
                     let type_16: string;
                     export { type_16 as type };
@@ -949,8 +947,8 @@ declare namespace BASE_BULLMQ_CONFIG {
                     export { delay_16 as delay };
                 }
                 export { backoff_16 as backoff };
-                let delay_17: number;
-                export { delay_17 as delay };
+                let attempts_16: number;
+                export { attempts_16 as attempts };
                 let removeOnComplete_16: number;
                 export { removeOnComplete_16 as removeOnComplete };
                 let removeOnFail_16: number;
@@ -977,6 +975,48 @@ declare namespace BASE_BULLMQ_CONFIG {
         }
         export { workerConfig_16 as workerConfig };
     }
+    namespace REINDEX_QUEUE {
+        let id_17: string;
+        export { id_17 as id };
+        export namespace queueConfig_17 {
+            export namespace defaultJobOptions_17 {
+                let attempts_17: number;
+                export { attempts_17 as attempts };
+                export namespace backoff_17 {
+                    let type_17: string;
+                    export { type_17 as type };
+                    let delay_17: number;
+                    export { delay_17 as delay };
+                }
+                export { backoff_17 as backoff };
+                let delay_18: number;
+                export { delay_18 as delay };
+                let removeOnComplete_17: number;
+                export { removeOnComplete_17 as removeOnComplete };
+                let removeOnFail_17: number;
+                export { removeOnFail_17 as removeOnFail };
+            }
+            export { defaultJobOptions_17 as defaultJobOptions };
+            export namespace streams_17 {
+                export namespace events_17 {
+                    let maxLen_17: number;
+                    export { maxLen_17 as maxLen };
+                }
+                export { events_17 as events };
+            }
+            export { streams_17 as streams };
+        }
+        export { queueConfig_17 as queueConfig };
+        export namespace workerConfig_17 {
+            let concurrency_17: number;
+            export { concurrency_17 as concurrency };
+            let lockDuration_17: number;
+            export { lockDuration_17 as lockDuration };
+            let maxStalledCount_17: number;
+            export { maxStalledCount_17 as maxStalledCount };
+        }
+        export { workerConfig_17 as workerConfig };
+    }
 }
 
 interface PlatformContextContentItem {

package/dist/node.js

@@ -193,6 +193,58 @@ var init_GLOBAL_BULLMQ_CONFIG = __esm({
           }
         }
       },
+      AI_AUTO_ANNOTATE_PREP_QUEUE: {
+        // PREP queue — the front of the per-doc Flow pipeline. The FE-facing
+        // /AIAutoAnnotate handler no longer fetches + summarizes + chunks +
+        // enqueues each doc inline (that serial, LLM-heavy loop blocked the HTTP
+        // request and risked App Engine clipping large batches mid-loop, silently
+        // dropping every doc past the cutoff). Instead the handler computes the
+        // batch-level prereqs ONCE (7th criterion + platform-derived categories)
+        // and enqueues one PREP job per doc here, then returns fast.
+        //
+        // Each prep job's worker (okf-sub) calls okf-be /internal/prepDoc, which
+        // does the per-doc work: fetch → summarizeDocument (warms the doc-level
+        // summary cache) → chunk fields → enqueue that doc's Flow (parent on
+        // AI_AUTO_ANNOTATE_QUEUE + one child per chunk on the CHUNK queue). So the
+        // Flow parents now get created rolling, as each prep job completes, rather
+        // than all up-front in the request. A prep failure isolates to its one doc
+        // (that doc is skipped); sibling prep jobs keep going.
+        id: "ai-auto-annotate-prep-queue",
+        queueConfig: {
+          defaultJobOptions: {
+            // attempts:1 — a retry would re-summarize (cache-HIT, cheap) but then
+            // re-enqueue the doc's Flow, double-annotating the doc. The rest of
+            // the per-doc Flow pipeline is attempts:1 for the same fail-loud
+            // reason (a retry just re-fires expensive LLM work).
+            attempts: 1,
+            backoff: {
+              type: "exponential",
+              delay: 5e3
+            },
+            removeOnComplete: 30,
+            removeOnFail: 100
+          },
+          streams: {
+            events: {
+              maxLen: 10
+            }
+          }
+        },
+        workerConfig: {
+          // Each prep job = one Mongo doc fetch + ONE summarize LLM call + a
+          // deterministic chunk + a Flow enqueue. It's lighter than a chunk job
+          // (which does ~4 LLM calls), so we can run more in parallel — 10 keeps
+          // prep comfortably AHEAD of the downstream chunk queue (concurrency 5),
+          // which is the real throughput cap. Going much higher than that buys
+          // little: prep would just drain faster into a chunk queue that still
+          // processes 5 at a time, while adding concurrent okf-be /internal/prepDoc
+          // load + concurrent summarize calls against the shared OpenAI TPM budget.
+          concurrency: 10,
+          lockDuration: 3e5,
+          // 5 min — generous ceiling over the 180s summarizer timeout
+          maxStalledCount: 1
+        }
+      },
       AI_AUTO_ANNOTATE_QUEUE: {
         // PARENT queue in the per-doc Flow. One job per doc; child jobs (one
         // per chunk) live on AI_AUTO_ANNOTATE_CHUNK_QUEUE. BullMQ Flow fires
@@ -3509,6 +3561,7 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
             scope: section.filterScope
           };
         };
+        const isSelfTerminalTag = element.rollupPath.length === 1 && !isLastTagProfile && !isTerminalValuePath;
         return {
           filterId: `ROLLUP_${section.filterScope}_${element.rollupPath.join(
             "_"
@@ -3522,9 +3575,14 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
             scope: section.filterScope
           }),
           contentType: element.rollupPath[0],
-          path: `tags.${element.rollupPath[1]}`,
+          path: `tags.${isSelfTerminalTag ? element.rollupPath[0] : element.rollupPath[1]}`,
           source: getSourceConfig(),
-          target: {
+          target: isSelfTerminalTag ? {
+            filterType: "tagType",
+            tagType: element.rollupPath[0],
+            rollupPath: element.rollupPath,
+            ...isAnno && { isAnno: true }
+          } : {
             filterType: "nestedRollupTagType",
             rollupPath: element.rollupPath,
             ...isAnno && { isAnno: true }

package/dist/node.mjs

@@ -198,6 +198,58 @@ var init_GLOBAL_BULLMQ_CONFIG = __esm({
           }
         }
       },
+      AI_AUTO_ANNOTATE_PREP_QUEUE: {
+        // PREP queue — the front of the per-doc Flow pipeline. The FE-facing
+        // /AIAutoAnnotate handler no longer fetches + summarizes + chunks +
+        // enqueues each doc inline (that serial, LLM-heavy loop blocked the HTTP
+        // request and risked App Engine clipping large batches mid-loop, silently
+        // dropping every doc past the cutoff). Instead the handler computes the
+        // batch-level prereqs ONCE (7th criterion + platform-derived categories)
+        // and enqueues one PREP job per doc here, then returns fast.
+        //
+        // Each prep job's worker (okf-sub) calls okf-be /internal/prepDoc, which
+        // does the per-doc work: fetch → summarizeDocument (warms the doc-level
+        // summary cache) → chunk fields → enqueue that doc's Flow (parent on
+        // AI_AUTO_ANNOTATE_QUEUE + one child per chunk on the CHUNK queue). So the
+        // Flow parents now get created rolling, as each prep job completes, rather
+        // than all up-front in the request. A prep failure isolates to its one doc
+        // (that doc is skipped); sibling prep jobs keep going.
+        id: "ai-auto-annotate-prep-queue",
+        queueConfig: {
+          defaultJobOptions: {
+            // attempts:1 — a retry would re-summarize (cache-HIT, cheap) but then
+            // re-enqueue the doc's Flow, double-annotating the doc. The rest of
+            // the per-doc Flow pipeline is attempts:1 for the same fail-loud
+            // reason (a retry just re-fires expensive LLM work).
+            attempts: 1,
+            backoff: {
+              type: "exponential",
+              delay: 5e3
+            },
+            removeOnComplete: 30,
+            removeOnFail: 100
+          },
+          streams: {
+            events: {
+              maxLen: 10
+            }
+          }
+        },
+        workerConfig: {
+          // Each prep job = one Mongo doc fetch + ONE summarize LLM call + a
+          // deterministic chunk + a Flow enqueue. It's lighter than a chunk job
+          // (which does ~4 LLM calls), so we can run more in parallel — 10 keeps
+          // prep comfortably AHEAD of the downstream chunk queue (concurrency 5),
+          // which is the real throughput cap. Going much higher than that buys
+          // little: prep would just drain faster into a chunk queue that still
+          // processes 5 at a time, while adding concurrent okf-be /internal/prepDoc
+          // load + concurrent summarize calls against the shared OpenAI TPM budget.
+          concurrency: 10,
+          lockDuration: 3e5,
+          // 5 min — generous ceiling over the 180s summarizer timeout
+          maxStalledCount: 1
+        }
+      },
       AI_AUTO_ANNOTATE_QUEUE: {
         // PARENT queue in the per-doc Flow. One job per doc; child jobs (one
         // per chunk) live on AI_AUTO_ANNOTATE_CHUNK_QUEUE. BullMQ Flow fires
@@ -3437,6 +3489,7 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
             scope: section.filterScope
           };
         };
+        const isSelfTerminalTag = element.rollupPath.length === 1 && !isLastTagProfile && !isTerminalValuePath;
         return {
           filterId: `ROLLUP_${section.filterScope}_${element.rollupPath.join(
             "_"
@@ -3450,9 +3503,14 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
             scope: section.filterScope
           }),
           contentType: element.rollupPath[0],
-          path: `tags.${element.rollupPath[1]}`,
+          path: `tags.${isSelfTerminalTag ? element.rollupPath[0] : element.rollupPath[1]}`,
           source: getSourceConfig(),
-          target: {
+          target: isSelfTerminalTag ? {
+            filterType: "tagType",
+            tagType: element.rollupPath[0],
+            rollupPath: element.rollupPath,
+            ...isAnno && { isAnno: true }
+          } : {
             filterType: "nestedRollupTagType",
             rollupPath: element.rollupPath,
             ...isAnno && { isAnno: true }