aui-agent-builder 0.4.31 → 0.4.32

package/dist/services/kb-identity.js

@@ -1,152 +0,0 @@
-/**
- * RAG knowledge-base rename guard.
- *
- * A RAG KB is identified by its name: AS provisions it under
- * to_screaming_snake_case(integration name) and KBM resolves it by that name at
- * runtime. Renaming a provisioned integration between pushes forks that identity
- * — a new empty KB is provisioned (or the old one deleted) while the content
- * stays in the original — so runtime RAG silently returns nothing. The guard
- * anchors on the stable knowledge_base_id the CLI writes into kb.json: if its
- * server KB no longer resolves from the local name, the name was changed.
- */
-import fs from "fs";
-import path from "path";
-/** Mirror agent-settings-transcoder `to_screaming_snake_case` — keep in sync. */
-function toScreamingSnake(name) {
-    if (!name)
-        return "";
-    let code = name.replace(/-/g, "_").replace(/ /g, "_").toUpperCase();
-    code = code.replace(/^[_| ]+/, "");
-    code = code.replace(/[^A-Z0-9_]+/g, "");
-    code = code.replace(/_+/g, "_");
-    return code;
-}
-/** Mirror knowledge-base-manager `name_to_kebab` (the runtime KB-name lookup key). */
-function nameToKebab(name) {
-    return name
-        .trim()
-        .replace(/[\s\-_]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .toLowerCase();
-}
-/**
- * The key a name resolves a KB to at runtime — provisioning's
- * to_screaming_snake_case composed with KBM's name_to_kebab. Two names share a
- * key IFF they resolve to the same KB, so separator / case / punctuation
- * differences never produce a false-positive rename.
- */
-export function kbResolutionKey(name) {
-    return nameToKebab(toScreamingSnake(name));
-}
-/**
- * Flag each provisioned local KB whose name no longer resolves to the server KB
- * its id points at. Skips unprovisioned bindings (no id — first push) and ids
- * absent from the server (deleted/foreign — nothing to orphan).
- */
-export function detectKbRenames(bindings, serverKbNameById) {
-    const violations = [];
-    for (const b of bindings) {
-        if (!b.knowledgeBaseId)
-            continue;
-        const serverName = serverKbNameById.get(b.knowledgeBaseId);
-        if (!serverName)
-            continue;
-        const bound = kbResolutionKey(serverName);
-        // kb.json name drives content upload; integration name drives provisioning
-        // + runtime resolution — either renamed away from the bound KB forks it.
-        if (kbResolutionKey(b.kbJsonName) !== bound) {
-            violations.push({
-                dir: b.dir,
-                knowledgeBaseId: b.knowledgeBaseId,
-                boundName: serverName,
-                localName: b.kbJsonName,
-                source: "kb.json name",
-            });
-        }
-        if (b.integrationName !== undefined &&
-            kbResolutionKey(b.integrationName) !== bound) {
-            violations.push({
-                dir: b.dir,
-                knowledgeBaseId: b.knowledgeBaseId,
-                boundName: serverName,
-                localName: b.integrationName,
-                source: "integration name",
-            });
-        }
-    }
-    return violations;
-}
-/**
- * Scan `knowledge-hubs/<dir>/kb.json` and `integrations.aui.json` (RAG
- * entries) into the bindings the guard checks. Folder name == integration
- * `code`. Returns [] when there are no knowledge-hub folders.
- */
-export function loadKbBindings(projectRoot) {
-    const hubsRoot = path.join(projectRoot, "knowledge-hubs");
-    if (!fs.existsSync(hubsRoot))
-        return [];
-    const ragNameByCode = readRagIntegrationNames(projectRoot);
-    const bindings = [];
-    for (const dir of fs.readdirSync(hubsRoot)) {
-        const kbJsonPath = path.join(hubsRoot, dir, "kb.json");
-        if (!fs.existsSync(kbJsonPath))
-            continue;
-        let raw;
-        try {
-            raw = JSON.parse(fs.readFileSync(kbJsonPath, "utf-8"));
-        }
-        catch {
-            continue; // unreadable kb.json — readKbFolder surfaces this elsewhere
-        }
-        if (!raw.name)
-            continue;
-        bindings.push({
-            dir,
-            kbJsonName: raw.name,
-            knowledgeBaseId: raw.knowledge_base_id,
-            integrationName: ragNameByCode.get(dir),
-        });
-    }
-    return bindings;
-}
-/** code -> display name for every RAG entry in integrations.aui.json. */
-function readRagIntegrationNames(projectRoot) {
-    const out = new Map();
-    const integPath = path.join(projectRoot, "integrations.aui.json");
-    if (!fs.existsSync(integPath))
-        return out;
-    try {
-        const parsed = JSON.parse(fs.readFileSync(integPath, "utf-8"));
-        for (const i of parsed.integrations ?? []) {
-            if (i.type === "RAG" && i.code && i.name)
-                out.set(i.code, i.name);
-        }
-    }
-    catch {
-        // malformed integrations.aui.json — schema validation surfaces it
-    }
-    return out;
-}
-/** Build the actionable error shown when a rename is blocked. */
-export function formatRenameLockError(violations) {
-    const byDir = new Map();
-    for (const v of violations)
-        if (!byDir.has(v.dir))
-            byDir.set(v.dir, v);
-    const lines = [...byDir.values()].map((v) => `  • knowledge-hubs/${v.dir} is bound to knowledge base ${v.boundName} ` +
-        `[id ${v.knowledgeBaseId}], but the local ${v.source} "${v.localName}" no longer resolves to it.`);
-    return [
-        "Knowledge base rename blocked.",
-        "",
-        "A RAG knowledge base is identified by its name. Renaming it provisions a",
-        "new, empty knowledge base and orphans the indexed content — runtime RAG",
-        "then returns nothing.",
-        "",
-        ...lines,
-        "",
-        "To proceed, either:",
-        "  - revert the name(s) above to match the bound knowledge base, or",
-        "  - delete this integration and create a new one to start a fresh knowledge base.",
-    ].join("\n");
-}
-//# sourceMappingURL=kb-identity.js.map

package/dist/services/kb-identity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"kb-identity.js","sourceRoot":"","sources":["../../src/services/kb-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,iFAAiF;AACjF,SAAS,gBAAgB,CAAC,IAAY;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACpE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sFAAsF;AACtF,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI;SACR,IAAI,EAAE;SACN,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;SACzB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,WAAW,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC;AAyBD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAqB,EACrB,gBAAqC;IAErC,MAAM,UAAU,GAAsB,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,eAAe;YAAE,SAAS;QACjC,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAE1C,2EAA2E;QAC3E,yEAAyE;QACzE,IAAI,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,KAAK,EAAE,CAAC;YAC5C,UAAU,CAAC,IAAI,CAAC;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,eAAe,EAAE,CAAC,CAAC,eAAe;gBAClC,SAAS,EAAE,UAAU;gBACrB,SAAS,EAAE,CAAC,CAAC,UAAU;gBACvB,MAAM,EAAE,cAAc;aACvB,CAAC,CAAC;QACL,CAAC;QACD,IACE,CAAC,CAAC,eAAe,KAAK,SAAS;YAC/B,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,KAAK,EAC5C,CAAC;YACD,UAAU,CAAC,IAAI,CAAC;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,eAAe,EAAE,CAAC,CAAC,eAAe;gBAClC,SAAS,EAAE,UAAU;gBACrB,SAAS,EAAE,CAAC,CAAC,eAAe;gBAC5B,MAAM,EAAE,kBAAkB;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAC1D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,MAAM,aAAa,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAE3D,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QACzC,IAAI,GAAkD,CAAC;QACvD,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,4DAA4D;QACxE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,SAAS;QACxB,QAAQ,CAAC,IAAI,CAAC;YACZ,GAAG;YACH,UAAU,EAAE,GAAG,CAAC,IAAI;YACpB,eAAe,EAAE,GAAG,CAAC,iBAAiB;YACtC,eAAe,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,yEAAyE;AACzE,SAAS,uBAAuB,CAAC,WAAmB;IAClD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;IAClE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAE5D,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI;gBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;IACpE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,qBAAqB,CAAC,UAA6B;IACjE,MAAM,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAEvE,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CACnC,CAAC,CAAC,EAAE,EAAE,CACJ,sBAAsB,CAAC,CAAC,GAAG,+BAA+B,CAAC,CAAC,SAAS,GAAG;QACxE,OAAO,CAAC,CAAC,eAAe,oBAAoB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,SAAS,6BAA6B,CACpG,CAAC;IAEF,OAAO;QACL,gCAAgC;QAChC,EAAE;QACF,0EAA0E;QAC1E,yEAAyE;QACzE,uBAAuB;QACvB,EAAE;QACF,GAAG,KAAK;QACR,EAAE;QACF,qBAAqB;QACrB,oEAAoE;QACpE,mFAAmF;KACpF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}