@ganju/utils 0.0.14 → 0.0.15

package/dist/chunkOverlap.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.overlapTail = void 0;
+// The tail of the previous chunk a chunk opens with, so a sentence cut at the
+// boundary still reads whole on one side of it. `overlap` of zero (or less)
+// borrows nothing — `slice(-0)` is `slice(0)`, the whole previous chunk, which
+// would double every chunk's text.
+const overlapTail = (previous, overlap) => overlap > 0 ? previous.slice(-overlap) : '';
+exports.overlapTail = overlapTail;

package/dist/chunking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunking.d.ts","sourceRoot":"","sources":["../src/chunking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AASpE,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,QAAQ,MAAM,EACd,aAAY,SAAS,SAAS,EAA+B,KAC5D,MAAM,EA8BR,CAAC;AA4BF,eAAO,MAAM,SAAS,GACpB,MAAM,MAAM,EACZ,UAAU;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,KACxD,MAAM,EAAoD,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;AAehD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,KAAG,aAAa,GAAG,IAUnB,CAAC;AAuEF,eAAO,MAAM,WAAW,GAAI,OAAO;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,KAAG,MASW,CAAC;AAIhB,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,yBAAyB,CAAC;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC;AAID,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,WAAW,iBAAiB,EAAE,GAAG,IAAI,EACrC,iBAAiB,MAAM,GAAG,IAAI,EAC9B,UAAU;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,KACA,aAAa,EA4Cf,CAAC"}
+{"version":3,"file":"chunking.d.ts","sourceRoot":"","sources":["../src/chunking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AASpE,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,QAAQ,MAAM,EACd,aAAY,SAAS,SAAS,EAA+B,KAC5D,MAAM,EA8BR,CAAC;AA4BF,eAAO,MAAM,SAAS,GACpB,MAAM,MAAM,EACZ,UAAU;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,KACxD,MAAM,EAAoD,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;AAqBhD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,KAAG,aAAa,GAAG,IAUnB,CAAC;AAqFF,eAAO,MAAM,WAAW,GAAI,OAAO;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,KAAG,MASW,CAAC;AAIhB,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,yBAAyB,CAAC;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC;AAID,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,WAAW,iBAAiB,EAAE,GAAG,IAAI,EACrC,iBAAiB,MAAM,GAAG,IAAI,EAC9B,UAAU;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,KACA,aAAa,EA4Cf,CAAC"}

package/dist/chunking.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.prepareChunks = exports.buildHeader = exports.headingSyntaxFor = exports.chunkText = exports.splitRecursive = void 0;
 const constants_1 = require("./constants");
+const chunkOverlap_1 = require("./chunkOverlap");
 const sanitize_1 = require("./sanitize");
 const trySplit = (text, sep) => {
     if (typeof sep === 'string') {
@@ -55,7 +56,7 @@ const chunkPieces = (text, options) => {
     const rawChunks = (0, exports.splitRecursive)(trimmed, target);
     const pieces = [];
     for (let i = 0; i < rawChunks.length; i++) {
-        const prev = i > 0 ? rawChunks[i - 1].slice(-overlap) : '';
+        const prev = i > 0 ? (0, chunkOverlap_1.overlapTail)(rawChunks[i - 1], overlap) : '';
         pieces.push({
             raw: rawChunks[i],
             content: (prev ? prev + '\n' : '') + rawChunks[i]
@@ -68,6 +69,12 @@ exports.chunkText = chunkText;
 const MARKDOWN_HEADING = /^ {0,3}(#{1,6})[ \t]+(.+?)(?:[ \t]+#+)?[ \t]*$/;
 const MARKDOWN_FENCE = /^ {0,3}(```|~~~)/;
 const HTML_HEADING = /<h([1-6])\b[^>]*>([\s\S]*?)<\/h\1\s*>/gi;
+// A heading tag still open at the end of a piece, from its opening tag on: the
+// chunker split inside it, and the rest of it opens the next piece.
+const OPEN_HTML_HEADING = /<h([1-6])\b[^>]*>(?![\s\S]*<\/h\1\s*>)[\s\S]*$/i;
+// Longer than any heading worth carrying: an opening tag this far back with no
+// close is broken markup, not a heading that happened to be split.
+const MAX_OPEN_HEADING_CHARS = 1000;
 const MAX_HEADING_CHARS = 120;
 const MARKDOWN_FILE_NAME = /\.(md|markdown|mdx)$/i;
 /**
@@ -128,14 +135,27 @@ const scanHtmlHeadings = (text) => [...text.matchAll(HTML_HEADING)]
 const createHeadingTracker = (syntax) => {
     let stack = [];
     const fence = { inFence: false };
+    // The unfinished HTML heading the previous piece ended in, if any.
+    let carry = '';
     const apply = (event) => {
         stack = stack.filter(h => h.level < event.level);
         stack.push({ level: event.level, text: event.text });
     };
+    // An HTML heading split between two pieces is read whole from the second,
+    // where it ends, as if that piece opened with it: it does, mid-heading. The
+    // separator the chunker dropped at the split is restored as a space.
+    const scanHtml = (raw) => {
+        const text = carry ? `${carry} ${raw}` : raw;
+        const shift = text.length - raw.length;
+        const open = OPEN_HTML_HEADING.exec(text)?.[0] ?? '';
+        carry = open.length <= MAX_OPEN_HEADING_CHARS ? open : '';
+        return scanHtmlHeadings(text).map(event => ({
+            ...event,
+            offset: Math.max(0, event.offset - shift)
+        }));
+    };
     return (raw) => {
-        const events = syntax === 'markdown'
-            ? scanMarkdownHeadings(raw, fence)
-            : scanHtmlHeadings(raw);
+        const events = syntax === 'markdown' ? scanMarkdownHeadings(raw, fence) : scanHtml(raw);
         const [first, ...rest] = events;
         // Before a document's first heading there is no section to continue — only
         // the metadata header, or the markup around an HTML body — so a chunk that

package/dist/citations.d.ts

@@ -0,0 +1,28 @@
+import type { Source } from './sources';
+/**
+ * Whether the answer cites this exact URL, not merely one that starts with it:
+ * on a crawled docs site the index page is a prefix of every page beneath it,
+ * so a plain substring test kept "/docs" and the site root in the footer of an
+ * answer that cited "/docs/api". A trailing slash and a #fragment still count
+ * as the same page.
+ */
+export declare const citesUrl: (answer: string, url: string) => boolean;
+/** Every page number the answer cites, ranges expanded. */
+export declare const citedPages: (answer: string) => Set<number>;
+/**
+ * Narrow a turn's sources to the ones its answer actually cites.
+ *
+ * Every search hit used to become a footer line, so an answer drawn from one
+ * handbook section was followed by eight unrelated pages the search had also
+ * returned. A search hit is kept when the answer names its resource — by title,
+ * file name or URL — and, for a paged file, only the pages the answer cites
+ * (or the best-ranked one, when it cites none). Resources the model read whole
+ * are always kept: reading one is itself the citation.
+ *
+ * An answer that names nothing gets no search sources at all. The model is told
+ * to cite what it uses, so a reply that names nothing is a greeting or "I
+ * couldn't find that" — and a footer under it would claim sources it never
+ * used, just because search runs on every message.
+ */
+export declare const selectCitedSources: (sources: Source[], answerText: string) => Source[];
+//# sourceMappingURL=citations.d.ts.map

package/dist/citations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations.d.ts","sourceRoot":"","sources":["../src/citations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAyCxC;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,MAAM,EAAE,KAAK,MAAM,KAAG,OAetD,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,KAAG,GAAG,CAAC,MAAM,CAYrD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,MAAM,EAAE,EACjB,YAAY,MAAM,KACjB,MAAM,EA4BR,CAAC"}

package/dist/citations.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectCitedSources = exports.citedPages = exports.citesUrl = void 0;
+// "p. 125", "pp. 123–126", "page 12", "págs. 4-5", "páginas 3 a 5". An
+// abbreviation counts only with its dot and a number has to stand alone, so
+// "p2p", "mp3" and "pp 2026" are not page references. The lookarounds, not \b,
+// mark the edges: \b sees "á" as a word break.
+const PAGE_REFERENCE = /(?<![\p{L}\p{N}])(?:(?:pp?|p[aá]gs?)\.|pages?|p[aá]ginas?)\s*(\d{1,5})(?![\p{L}\p{N}])(?:(?:\s*[-–—]\s*|\s+(?:to|a)\s+)(\d{1,5})(?![\p{L}\p{N}]))?/giu;
+const MAX_PAGE_RANGE = 50;
+// Lowercased words only, so "ETag header — HTTP | MDN" in an answer matches the
+// title "ETag header - HTTP | MDN", and "mml-book.pdf" matches "mml-book".
+const normalize = (text) => ` ${text
+    .toLowerCase()
+    .normalize('NFKD')
+    .replace(/[̀-ͯ]/g, '')
+    .replace(/[^a-z0-9]+/g, ' ')
+    .trim()} `;
+// The ways an answer refers to a source: its whole title, the title without a
+// parenthetical or a site suffix ("Northwind Handbook (draft)", "ETag header
+// - HTTP | MDN"), its file name with and without the extension, and its URL.
+const namesFor = (source) => {
+    const names = [source.title, source.title.replace(/\s*\([^)]*\)\s*/g, ' ')];
+    const lead = source.title.split(/\s+[|\-–—:]\s+/)[0];
+    // A one-word lead ("Introduction", "Pricing") names half the corpus.
+    if (lead.trim().split(/\s+/).length >= 2)
+        names.push(lead);
+    if (source.fileName) {
+        names.push(source.fileName, source.fileName.replace(/\.[a-z0-9]+$/i, ''));
+    }
+    return names.map(normalize).filter(name => name.trim().length >= 4);
+};
+// The characters that can carry a URL on past the point we matched. Brackets,
+// quotes and whitespace end it — that is how a URL sits inside Markdown links,
+// parentheses and prose.
+const URL_CONTINUATION = /^[^\s<>()[\]{}"'`|]*/;
+// Punctuation that closes a sentence around a URL rather than belonging to it.
+const TRAILING_PUNCTUATION = /[.,;:!?*_]+$/;
+/**
+ * Whether the answer cites this exact URL, not merely one that starts with it:
+ * on a crawled docs site the index page is a prefix of every page beneath it,
+ * so a plain substring test kept "/docs" and the site root in the footer of an
+ * answer that cited "/docs/api". A trailing slash and a #fragment still count
+ * as the same page.
+ */
+const citesUrl = (answer, url) => {
+    const target = url.replace(/\/+$/, '');
+    if (!target)
+        return false;
+    for (let at = answer.indexOf(target); at !== -1; at = answer.indexOf(target, at + 1)) {
+        const rest = answer
+            .slice(at + target.length)
+            .match(URL_CONTINUATION)[0]
+            .replace(TRAILING_PUNCTUATION, '');
+        if (/^\/*(#.*)?$/.test(rest))
+            return true;
+    }
+    return false;
+};
+exports.citesUrl = citesUrl;
+/** Every page number the answer cites, ranges expanded. */
+const citedPages = (answer) => {
+    const pages = new Set();
+    for (const match of answer.matchAll(PAGE_REFERENCE)) {
+        const from = Number(match[1]);
+        const to = match[2] ? Number(match[2]) : from;
+        if (to < from || to - from > MAX_PAGE_RANGE) {
+            pages.add(from);
+            continue;
+        }
+        for (let page = from; page <= to; page++)
+            pages.add(page);
+    }
+    return pages;
+};
+exports.citedPages = citedPages;
+/**
+ * Narrow a turn's sources to the ones its answer actually cites.
+ *
+ * Every search hit used to become a footer line, so an answer drawn from one
+ * handbook section was followed by eight unrelated pages the search had also
+ * returned. A search hit is kept when the answer names its resource — by title,
+ * file name or URL — and, for a paged file, only the pages the answer cites
+ * (or the best-ranked one, when it cites none). Resources the model read whole
+ * are always kept: reading one is itself the citation.
+ *
+ * An answer that names nothing gets no search sources at all. The model is told
+ * to cite what it uses, so a reply that names nothing is a greeting or "I
+ * couldn't find that" — and a footer under it would claim sources it never
+ * used, just because search runs on every message.
+ */
+const selectCitedSources = (sources, answerText) => {
+    const searchEntries = sources.filter(s => s.score !== undefined);
+    const readEntries = sources.filter(s => s.score === undefined);
+    if (searchEntries.length === 0)
+        return sources;
+    const answer = normalize(answerText);
+    const pages = (0, exports.citedPages)(answerText);
+    const citedResources = new Set(searchEntries
+        .filter(s => (0, exports.citesUrl)(answerText, s.uri) ||
+        namesFor(s).some(name => answer.includes(name)))
+        .map(s => s.resourceId));
+    const kept = [];
+    for (const resourceId of citedResources) {
+        const entries = searchEntries.filter(s => s.resourceId === resourceId);
+        const onCitedPage = entries.filter(s => s.pageNumber !== undefined && pages.has(s.pageNumber));
+        kept.push(...(onCitedPage.length > 0 ? onCitedPage : entries.slice(0, 1)));
+    }
+    const cited = searchEntries.filter(s => kept.includes(s));
+    return [...cited, ...readEntries];
+};
+exports.selectCitedSources = selectCitedSources;

package/dist/constants.d.ts

@@ -333,6 +333,7 @@ export declare const constants: {
     CRAWL_DEFAULT_MAX_DEPTH: number;
     CRAWL_MAX_DEPTH_LIMIT: number;
     CRAWL_PAGE_FETCH_TIMEOUT_MS: number;
+    CRAWL_MAX_REDIRECTS: number;
     CRAWL_PAGE_QUEUE_BATCH_SIZE: number;
     CRAWL_USER_AGENT: string;
     RESOURCE_ICON_THEME_DARK: string;
@@ -350,6 +351,7 @@ export declare const constants: {
     TELEGRAM_MAX_FILE_BYTES: number;
     RATE_LIMIT_BACKOFF_SECONDS: number;
     TRANSIENT_BACKOFF_SECONDS: number;
+    QUEUE_MAX_RETRIES: number;
     ENCODINGS: string[];
     ENCODING_UTF8: "utf-8";
     CHANNEL_PLATFORM_TELEGRAM: "telegram";
@@ -395,6 +397,16 @@ export declare const constants: {
     MCP_TOOL_CONFIRMATION_TTL_MS: number;
     MCP_TOOL_CONFIRMATION_ARG: string;
     MCP_TOOL_CONFIRMATION_ARG_DESCRIPTION: string;
+    MCP_TOOL_CONFIRMATION_ARG_DESCRIPTION_CONDITIONAL: string;
+    TOOL_APPROVAL_PATH: string;
+    TOOL_APPROVAL_DECISION_APPROVE: string;
+    TOOL_APPROVAL_DECISION_DENY: string;
+    TOOL_APPROVAL_DECISIONS: readonly ["approve", "deny"];
+    TOOL_APPROVAL_STATUS_PENDING: string;
+    TOOL_APPROVAL_STATUS_APPROVED: string;
+    TOOL_APPROVAL_STATUS_DENIED: string;
+    TOOL_APPROVAL_STATUS_USED: string;
+    TOOL_APPROVAL_STATUS_EXPIRED: string;
     CHANNEL_DEBOUNCE_DEFAULT_MS: number;
     CHANNEL_DEBOUNCE_MIN_MS: number;
     CHANNEL_DEBOUNCE_MAX_MS: number;
@@ -467,6 +479,9 @@ export declare const constants: {
     RESOURCE_SEARCH_COMMON_TERM_MIN: number;
     RESOURCE_SEARCH_RERANK_CANDIDATES: number;
     RESOURCE_SEARCH_RERANK_MODEL: string;
+    RESOURCE_SEARCH_EXACT_MAX_RESOURCES: number;
+    RESOURCE_SEARCH_EXACT_MAX_CHUNKS: number;
+    RESOURCE_SEARCH_SUBSTRING_MAX_CHUNKS: number;
     RESOURCE_HANDLER_SLEEP_AFTER: string;
     DOCS_URL: string;
     BASE64_DATA_URI_RE: RegExp;
@@ -477,6 +492,8 @@ export declare const constants: {
     }[];
     DEFAULT_MAX_TOKENS: number;
     RESOURCE_TOOL_KEY_LIST_RESOURCES: string;
+    LIST_RESOURCES_DEFAULT_LIMIT: number;
+    LIST_RESOURCES_MAX_LIMIT: number;
     RESOURCE_TOOL_KEY_SEARCH_RESOURCES: string;
     RESOURCE_TOOL_KEY_READ_RESOURCE: string;
     RESOURCE_TOOL_KEY_SEND_RESOURCE: string;
@@ -650,6 +667,7 @@ export declare const constants: {
     MCP_INTERNAL_HEADER: string;
     MCP_CHANNEL_ID_HEADER: string;
     MCP_CHANNEL_PLATFORM_HEADER: string;
+    MCP_CHANNEL_CONVERSATION_HEADER: string;
     MCP_CHANNEL_CLIENT_USER_AGENT: string;
     MCP_SESSION_HEADER: string;
     MCP_REQUEST_METHOD_INITIALIZE: "initialize";
@@ -687,6 +705,14 @@ export declare const constants: {
     ACCESS_TOKEN_SCOPE_MESSAGE: string;
     CUSTOM_CODE_LOGS_DEFAULT_LIMIT: number;
     CUSTOM_CODE_LOGS_MAX_LIMIT: number;
+    OBSERVABILITY_RANGE_DAYS: number[];
+    OBSERVABILITY_UNUSED_DAYS: number;
+    OBSERVABILITY_FOLLOW_UP_SECONDS: number;
+    OBSERVABILITY_SCHEMA_REJECTION_PREFIX: string;
+    OBSERVABILITY_TOP_ERRORS: number;
+    OBSERVABILITY_CALLS_DEFAULT_LIMIT: number;
+    OBSERVABILITY_CALLS_MAX_LIMIT: number;
+    OBSERVABILITY_SESSION_MAX_CALLS: number;
     BOT_GRANT_TYPE: string;
     EXTERNAL_LINK_VERIFICATION_PREFIX: string;
     EXTERNAL_LINK_TTL_SECONDS: number;

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/constants.js

@@ -252,6 +252,9 @@ const CRAWL_MAX_PAGES_LIMIT = 1000;
 const CRAWL_DEFAULT_MAX_DEPTH = 3;
 const CRAWL_MAX_DEPTH_LIMIT = 10;
 const CRAWL_PAGE_FETCH_TIMEOUT_MS = 30000;
+// Redirects one crawl fetch may follow. Each hop is screened on its own, so a
+// public URL can't bounce the crawler onto a private address.
+const CRAWL_MAX_REDIRECTS = 5;
 const CRAWL_USER_AGENT = 'Mozilla/5.0 (compatible; GanjuCrawler/1.0; +https://ganju.ai)';
 const CRAWL_PAGE_QUEUE_BATCH_SIZE = 100;
 const RESOURCE_ICON_THEME_DARK = 'dark';
@@ -484,6 +487,10 @@ const RATE_LIMIT_BACKOFF_SECONDS = 60;
 // Short backoff for transient Cloudflare platform errors (e.g. a Durable Object
 // / Container reset) so the retried job lands after the object has recovered.
 const TRANSIENT_BACKOFF_SECONDS = 5;
+// Retries every resource queue consumer is configured with (`max_retries` in
+// the API worker's wrangler config). A job's last delivery is attempt
+// QUEUE_MAX_RETRIES + 1; only then is its work marked failed.
+const QUEUE_MAX_RETRIES = 3;
 const CHANNEL_PLATFORM_TELEGRAM = 'telegram';
 const CHANNEL_PLATFORM_SLACK = 'slack';
 const CHANNEL_PLATFORM_WHATSAPP = 'whatsapp';
@@ -667,14 +674,37 @@ const TOOL_CONFIRMATION_ASK_INSTRUCTION = 'IMPORTANT: these actions have NOT bee
     'confirm, and must not say or suggest that they were done, nor describe ' +
     'or make up any result from them.';
 // For MCP clients, whose chat the server can't see: a sensitive call without a
-// valid confirmation isn't run, and the model is told to ask the user and call
-// again with a token that binds the second call to these exact arguments.
-// How long that token stays good, and the argument that carries it.
+// valid confirmation isn't run. Ordinarily the model is told to ask the user
+// and call again with a token that binds the second call to these exact
+// arguments; once the session has read outside content, the user approves it
+// on a dashboard page instead, and the second call carries that approval's
+// id. How long either stays good, and the argument that carries it.
 const MCP_TOOL_CONFIRMATION_TTL_MS = 10 * 60 * 1000;
 const MCP_TOOL_CONFIRMATION_ARG = 'confirmation';
 const MCP_TOOL_CONFIRMATION_ARG_DESCRIPTION = "Leave out on the first call. This action needs the user's yes: the " +
-    'first call returns a token; after the user says yes, call again with the ' +
-    'same arguments and that token here.';
+    'first call returns a code and says how to get that yes; once the user ' +
+    'has given it, call again with the same arguments and that code here.';
+// The same argument where only some calls ask: those made after the session
+// read outside content.
+const MCP_TOOL_CONFIRMATION_ARG_DESCRIPTION_CONDITIONAL = "Leave out on the first call. If this action needs the user's yes, the " +
+    'first call returns a code instead of running and says how to get that ' +
+    'yes; once the user has given it, call again with the same arguments and ' +
+    'that code here.';
+// The dashboard page where a signed-in user approves or denies one such call,
+// as `${TOOL_APPROVAL_PATH}/<approval id>`, and the two answers it sends.
+const TOOL_APPROVAL_PATH = '/tool-approval';
+const TOOL_APPROVAL_DECISION_APPROVE = 'approve';
+const TOOL_APPROVAL_DECISION_DENY = 'deny';
+const TOOL_APPROVAL_DECISIONS = [
+    TOOL_APPROVAL_DECISION_APPROVE,
+    TOOL_APPROVAL_DECISION_DENY
+];
+// Where an approval stands, as the page shows it.
+const TOOL_APPROVAL_STATUS_PENDING = 'pending';
+const TOOL_APPROVAL_STATUS_APPROVED = 'approved';
+const TOOL_APPROVAL_STATUS_DENIED = 'denied';
+const TOOL_APPROVAL_STATUS_USED = 'used';
+const TOOL_APPROVAL_STATUS_EXPIRED = 'expired';
 // The question when the model wrote none, above the runner's own summary.
 const TOOL_CONFIRMATION_FALLBACK_QUESTION = 'Before I do this, please confirm. Reply yes to go ahead, or no to cancel.';
 const TELEGRAM_SECRET_HEADER = 'x-telegram-bot-api-secret-token';
@@ -695,13 +725,15 @@ const SLACK_MESSAGE_LIMIT = 2900;
 const SLACK_MAX_SOURCE_BUTTONS = 10;
 // The Slack app configuration Ganju needs, surfaced in the UI when connecting a
 // Slack channel. Required scopes back the runner's calls (mentions, DMs,
-// posting, file upload); recommended scopes only enrich names/titles and
-// degrade gracefully; bot events are what the webhook subscribes to.
+// posting, file upload, downloading a voice clip to transcribe it);
+// recommended scopes only enrich names/titles and degrade gracefully; bot
+// events are what the webhook subscribes to.
 const SLACK_REQUIRED_SCOPES = [
     'app_mentions:read',
     'im:history',
     'chat:write',
-    'files:write'
+    'files:write',
+    'files:read'
 ];
 const SLACK_RECOMMENDED_SCOPES = ['users:read', 'channels:read', 'groups:read'];
 const SLACK_BOT_EVENTS = ['app_mention', 'message.im'];
@@ -814,6 +846,19 @@ const RESOURCE_SEARCH_COMMON_TERM_MIN = 5;
 // call per search; a failure falls back to the fused order.
 const RESOURCE_SEARCH_RERANK_CANDIDATES = 30;
 const RESOURCE_SEARCH_RERANK_MODEL = '@cf/baai/bge-reranker-base';
+// An identifier in the query (a code mixing letters and digits, a snake_case
+// name, or a number, dotted or hyphenated name typed on its own) found in at
+// most this many documents is what the user is after: its chunks go first,
+// whatever the reranker thinks. A cross-encoder reads "86400" or "PGRST116" as noise and
+// would bury the one chunk that contains it under pages that merely look
+// related. Past EXACT_MAX_CHUNKS matching chunks the identifier is common
+// enough that the usual ranking is left to decide, and the scan stops there.
+const RESOURCE_SEARCH_EXACT_MAX_RESOURCES = 5;
+const RESOURCE_SEARCH_EXACT_MAX_CHUNKS = 30;
+// An identifier the index never saw is looked for as plain text, which reads
+// every chunk of the artifact when nothing matches. Past this many chunks that
+// costs more than the rare hit is worth, so a large artifact skips it.
+const RESOURCE_SEARCH_SUBSTRING_MAX_CHUNKS = 20000;
 const RESOURCE_HANDLER_SLEEP_AFTER = '10m';
 const DOCS_URL = 'https://ganju.ai/docs/';
 const BASE64_DATA_URI_RE = /data:image\/[a-zA-Z0-9+\-.]+;base64,[A-Za-z0-9+/=\s]+/g;
@@ -826,6 +871,11 @@ const CHUNK_SEPARATORS = [
     { split: ' ', join: ' ' }
 ];
 const DEFAULT_MAX_TOKENS = 4096;
+// One page of `list-resources`. A knowledge base with a crawled site runs to
+// thousands of resources; listed whole, that is one result of several hundred
+// KB in the model's context.
+const LIST_RESOURCES_DEFAULT_LIMIT = 100;
+const LIST_RESOURCES_MAX_LIMIT = 500;
 const RESOURCE_TOOL_KEY_LIST_RESOURCES = 'list-resources';
 const RESOURCE_TOOL_KEY_SEARCH_RESOURCES = 'search-resources';
 const RESOURCE_TOOL_KEY_READ_RESOURCE = 'read-resource';
@@ -1288,7 +1338,9 @@ const RESERVED_TOOL_NAMES = [
     TOOL_DEFINITION_KEY_HTTP_ENDPOINT,
     TOOL_DEFINITION_KEY_MCP_PROXY,
     TOOL_DEFINITION_KEY_CUSTOM_CODE,
-    sdkConstants_1.CUSTOM_CODE_HEALTH_TOOL
+    sdkConstants_1.CUSTOM_CODE_HEALTH_TOOL,
+    // The channel runner's own memory tool (PARTICIPANT_MEMORY_TOOL_NAME).
+    'remember-customer'
 ];
 // Shared by both write paths so there is one string to translate. It has to
 // carry a word `matchStatus` recognises (errorHandler.ts), because the
@@ -1518,6 +1570,10 @@ const MCP_SESSION_HEADER = 'mcp-session-id';
 const MCP_INTERNAL_HEADER = 'x-ganju-internal-secret';
 const MCP_CHANNEL_ID_HEADER = 'x-ganju-channel-id';
 const MCP_CHANNEL_PLATFORM_HEADER = 'x-ganju-channel-platform';
+// The conversation a channel turn belongs to. The MCP worker files that turn's
+// calls under one session per conversation, so a call can be traced back to
+// the chat it ran in.
+const MCP_CHANNEL_CONVERSATION_HEADER = 'x-ganju-channel-conversation-id';
 const MCP_CHANNEL_CLIENT_USER_AGENT = 'ganju-channel/0.0.1';
 const JWKS_KV_KEY = 'jwks:v1';
 const JWKS_TTL_SECONDS = 600;
@@ -1604,6 +1660,22 @@ const ACCESS_TOKEN_SCOPE_MESSAGE = 'This token is scoped to a different project'
 // Recent custom-tool invocations, as `ganju logs` reads them.
 const CUSTOM_CODE_LOGS_DEFAULT_LIMIT = 20;
 const CUSTOM_CODE_LOGS_MAX_LIMIT = 100;
+// Tool observability on the project home. The windows match the activity
+// chart's, and none reaches past `RETENTION_DAYS.mcpRequest`.
+const OBSERVABILITY_RANGE_DAYS = [7, 30, 90];
+// An enabled tool with no call in this many days is offered for disabling.
+const OBSERVABILITY_UNUSED_DAYS = 30;
+// Two calls in one session this close together are one attempt followed by
+// the next: a retry when it's the same tool, a switch when it's another tool
+// after an error.
+const OBSERVABILITY_FOLLOW_UP_SECONDS = 120;
+// How a call rejected by its tool's input schema reads in `error_message`.
+const OBSERVABILITY_SCHEMA_REJECTION_PREFIX = 'Input validation error';
+const OBSERVABILITY_TOP_ERRORS = 8;
+const OBSERVABILITY_CALLS_DEFAULT_LIMIT = 25;
+const OBSERVABILITY_CALLS_MAX_LIMIT = 100;
+// A session timeline is read whole up to this many calls, newest kept.
+const OBSERVABILITY_SESSION_MAX_CALLS = 500;
 const BOT_GRANT_TYPE = 'urn:ganju:bot-on-behalf-of';
 const EXTERNAL_LINK_VERIFICATION_PREFIX = 'external_link:';
 const EXTERNAL_LINK_TTL_SECONDS = 600;
@@ -2251,6 +2323,7 @@ exports.constants = {
     CRAWL_DEFAULT_MAX_DEPTH,
     CRAWL_MAX_DEPTH_LIMIT,
     CRAWL_PAGE_FETCH_TIMEOUT_MS,
+    CRAWL_MAX_REDIRECTS,
     CRAWL_PAGE_QUEUE_BATCH_SIZE,
     CRAWL_USER_AGENT,
     RESOURCE_ICON_THEME_DARK,
@@ -2268,6 +2341,7 @@ exports.constants = {
     TELEGRAM_MAX_FILE_BYTES,
     RATE_LIMIT_BACKOFF_SECONDS,
     TRANSIENT_BACKOFF_SECONDS,
+    QUEUE_MAX_RETRIES,
     ENCODINGS,
     ENCODING_UTF8,
     CHANNEL_PLATFORM_TELEGRAM,
@@ -2309,6 +2383,16 @@ exports.constants = {
     MCP_TOOL_CONFIRMATION_TTL_MS,
     MCP_TOOL_CONFIRMATION_ARG,
     MCP_TOOL_CONFIRMATION_ARG_DESCRIPTION,
+    MCP_TOOL_CONFIRMATION_ARG_DESCRIPTION_CONDITIONAL,
+    TOOL_APPROVAL_PATH,
+    TOOL_APPROVAL_DECISION_APPROVE,
+    TOOL_APPROVAL_DECISION_DENY,
+    TOOL_APPROVAL_DECISIONS,
+    TOOL_APPROVAL_STATUS_PENDING,
+    TOOL_APPROVAL_STATUS_APPROVED,
+    TOOL_APPROVAL_STATUS_DENIED,
+    TOOL_APPROVAL_STATUS_USED,
+    TOOL_APPROVAL_STATUS_EXPIRED,
     CHANNEL_DEBOUNCE_DEFAULT_MS,
     CHANNEL_DEBOUNCE_MIN_MS,
     CHANNEL_DEBOUNCE_MAX_MS,
@@ -2381,6 +2465,9 @@ exports.constants = {
     RESOURCE_SEARCH_COMMON_TERM_MIN,
     RESOURCE_SEARCH_RERANK_CANDIDATES,
     RESOURCE_SEARCH_RERANK_MODEL,
+    RESOURCE_SEARCH_EXACT_MAX_RESOURCES,
+    RESOURCE_SEARCH_EXACT_MAX_CHUNKS,
+    RESOURCE_SEARCH_SUBSTRING_MAX_CHUNKS,
     RESOURCE_HANDLER_SLEEP_AFTER,
     DOCS_URL,
     BASE64_DATA_URI_RE,
@@ -2388,6 +2475,8 @@ exports.constants = {
     CHUNK_SEPARATORS,
     DEFAULT_MAX_TOKENS,
     RESOURCE_TOOL_KEY_LIST_RESOURCES,
+    LIST_RESOURCES_DEFAULT_LIMIT,
+    LIST_RESOURCES_MAX_LIMIT,
     RESOURCE_TOOL_KEY_SEARCH_RESOURCES,
     RESOURCE_TOOL_KEY_READ_RESOURCE,
     RESOURCE_TOOL_KEY_SEND_RESOURCE,
@@ -2561,6 +2650,7 @@ exports.constants = {
     MCP_INTERNAL_HEADER,
     MCP_CHANNEL_ID_HEADER,
     MCP_CHANNEL_PLATFORM_HEADER,
+    MCP_CHANNEL_CONVERSATION_HEADER,
     MCP_CHANNEL_CLIENT_USER_AGENT,
     MCP_SESSION_HEADER,
     MCP_REQUEST_METHOD_INITIALIZE,
@@ -2598,6 +2688,14 @@ exports.constants = {
     ACCESS_TOKEN_SCOPE_MESSAGE,
     CUSTOM_CODE_LOGS_DEFAULT_LIMIT,
     CUSTOM_CODE_LOGS_MAX_LIMIT,
+    OBSERVABILITY_RANGE_DAYS,
+    OBSERVABILITY_UNUSED_DAYS,
+    OBSERVABILITY_FOLLOW_UP_SECONDS,
+    OBSERVABILITY_SCHEMA_REJECTION_PREFIX,
+    OBSERVABILITY_TOP_ERRORS,
+    OBSERVABILITY_CALLS_DEFAULT_LIMIT,
+    OBSERVABILITY_CALLS_MAX_LIMIT,
+    OBSERVABILITY_SESSION_MAX_CALLS,
     BOT_GRANT_TYPE,
     EXTERNAL_LINK_VERIFICATION_PREFIX,
     EXTERNAL_LINK_TTL_SECONDS,