@dani-builder/strapi-plugin-agent 0.2.0

package/dist/server/src/services/qdrant-store.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createQdrantStore = createQdrantStore;
+function withoutTrailingSlash(url) {
+    return url.replace(/\/+$/, "");
+}
+function filterFor(scope) {
+    return {
+        must: Object.entries(scope).map(([key, value]) => ({
+            key,
+            match: { value },
+        })),
+    };
+}
+function searchFilterFor(filter) {
+    return {
+        must: [
+            { key: "locale", match: { value: filter.locale } },
+            ...(filter.document
+                ? [
+                    {
+                        key: "sourceUid",
+                        match: { value: filter.document.sourceUid },
+                    },
+                    {
+                        key: "documentId",
+                        match: { value: filter.document.documentId },
+                    },
+                ]
+                : []),
+            {
+                should: filter.scopes.map((scope) => ({
+                    must: [
+                        { key: "sourceUid", match: { value: scope.sourceUid } },
+                        {
+                            key: "configRevision",
+                            match: { value: scope.configRevision },
+                        },
+                        {
+                            key: "serializerRevision",
+                            match: { value: scope.serializerRevision },
+                        },
+                    ],
+                })),
+            },
+        ],
+    };
+}
+function isVectorPayload(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const payload = value;
+    return (typeof payload.sourceUid === "string" &&
+        typeof payload.documentId === "string" &&
+        typeof payload.locale === "string" &&
+        typeof payload.chunkIndex === "number" &&
+        typeof payload.text === "string" &&
+        typeof payload.title === "string" &&
+        typeof payload.configRevision === "number" &&
+        typeof payload.serializerRevision === "number");
+}
+function valueType(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+function payloadKeys(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? Object.keys(value).sort()
+        : [];
+}
+function createQdrantStore(options) {
+    const request = options.fetch ?? globalThis.fetch;
+    const logger = options.logger ?? console;
+    const baseUrl = withoutTrailingSlash(options.url);
+    const headers = {
+        "Content-Type": "application/json",
+        ...(options.apiKey ? { "api-key": options.apiKey } : {}),
+    };
+    async function send(method, path, body) {
+        const response = await request(`${baseUrl}${path}`, {
+            method,
+            headers,
+            body: JSON.stringify(body),
+        });
+        if (!response.ok)
+            throw new Error(`Qdrant request failed (${response.status})`);
+    }
+    return {
+        async replaceDocument(scope, points) {
+            await send("POST", `/collections/${options.collection}/points/delete?wait=true`, {
+                filter: filterFor(scope),
+            });
+            if (points.length > 0) {
+                await send("PUT", `/collections/${options.collection}/points?wait=true`, {
+                    points,
+                });
+            }
+        },
+        async search(vector, topK, filter) {
+            const response = await request(`${baseUrl}/collections/${options.collection}/points/search`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({
+                    vector,
+                    limit: topK,
+                    with_payload: true,
+                    filter: searchFilterFor(filter),
+                }),
+            });
+            if (!response.ok)
+                throw new Error(`Qdrant request failed (${response.status})`);
+            const responseBody = (await response.json());
+            return (responseBody.result ?? []).flatMap((entry, hitIndex) => {
+                if (typeof entry.score === "number" && isVectorPayload(entry.payload)) {
+                    return [{ score: entry.score, payload: entry.payload }];
+                }
+                logger.warn({
+                    event: "agent.qdrant.search_hit_excluded",
+                    reason: typeof entry.score === "number"
+                        ? "invalid_payload"
+                        : "invalid_score",
+                    collection: options.collection,
+                    hitIndex,
+                    scoreType: valueType(entry.score),
+                    payloadType: valueType(entry.payload),
+                    payloadKeys: payloadKeys(entry.payload),
+                    locale: filter.locale,
+                    sourceUids: filter.scopes.map((scope) => scope.sourceUid).sort(),
+                });
+                return [];
+            });
+        },
+    };
+}
+//# sourceMappingURL=qdrant-store.js.map

package/dist/server/src/services/qdrant-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-store.js","sourceRoot":"","sources":["../../../../server/src/services/qdrant-store.ts"],"names":[],"mappings":"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"}

package/dist/server/src/services/retrieval.d.ts

@@ -0,0 +1,49 @@
+import type { Core } from "@strapi/strapi";
+import type { CitedSource } from "@dani-builder/agent-contract";
+import type { EmbeddingsClient } from "./embeddings";
+import type { VectorStore } from "./qdrant-store";
+export interface RetrievalSource {
+    uid: string;
+    configRevision: number;
+    serializerRevision: number;
+}
+export interface RetrievalDependencies {
+    embeddings: EmbeddingsClient;
+    store: VectorStore;
+}
+export interface RetrievalQuery {
+    query: string;
+    locale: string;
+    topK: number;
+    sources: RetrievalSource[];
+    anchor?: {
+        sourceUid: string;
+        documentId: string;
+        topK: number;
+    };
+}
+export interface RetrievedChunk {
+    n: number;
+    sourceUid: string;
+    documentId: string;
+    chunkIndex: number;
+    title: string;
+    url?: string;
+    text: string;
+}
+export interface RetrievalResult {
+    sources: CitedSource[];
+    chunks: RetrievedChunk[];
+}
+export declare function createRetrieval(dependencies: RetrievalDependencies): {
+    query(input: RetrievalQuery): Promise<RetrievalResult>;
+};
+declare const retrieval: (_: {
+    strapi: Core.Strapi;
+}) => {
+    create(dependencies: RetrievalDependencies): {
+        query(input: RetrievalQuery): Promise<RetrievalResult>;
+    };
+};
+export default retrieval;
+//# sourceMappingURL=retrieval.d.ts.map

package/dist/server/src/services/retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../../../server/src/services/retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAClE;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AA6ED,wBAAgB,eAAe,CAAC,YAAY,EAAE,qBAAqB;iBAE5C,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;EA8B/D;AAED,QAAA,MAAM,SAAS,GAAI,GAAG;IAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAA;CAAE;yBACtB,qBAAqB;qBAjCrB,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;;CAoC9D,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/dist/server/src/services/retrieval.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRetrieval = createRetrieval;
+function excerpt(text) {
+    const collapsed = text.replace(/\s+/g, " ").trim();
+    const characters = [...collapsed];
+    return characters.length <= 200
+        ? collapsed
+        : `${characters.slice(0, 199).join("")}…`;
+}
+function groupHits(hits) {
+    const groups = new Map();
+    for (const hit of hits) {
+        const key = `${hit.payload.sourceUid}:${hit.payload.documentId}`;
+        const group = groups.get(key);
+        if (group)
+            group.push(hit);
+        else
+            groups.set(key, [hit]);
+    }
+    const ordered = [...groups.values()]
+        .map((group) => group.sort((left, right) => right.score - left.score))
+        .sort((left, right) => (right[0]?.score ?? 0) - (left[0]?.score ?? 0));
+    const sources = [];
+    const chunks = [];
+    ordered.forEach((group, index) => {
+        const first = group[0];
+        if (!first)
+            return;
+        const n = index + 1;
+        const citedChunks = group.map((hit) => ({
+            excerpt: excerpt(hit.payload.text),
+            chunkIndex: hit.payload.chunkIndex,
+        }));
+        const nonEmptyCitedChunks = citedChunks.filter((chunk) => chunk.excerpt);
+        sources.push({
+            n,
+            sourceUid: first.payload.sourceUid,
+            documentId: first.payload.documentId,
+            title: first.payload.title,
+            ...(first.payload.description
+                ? { description: first.payload.description }
+                : {}),
+            ...(first.payload.url ? { url: first.payload.url } : {}),
+            excerpts: nonEmptyCitedChunks.map((chunk) => chunk.excerpt),
+            chunkIndexes: nonEmptyCitedChunks.map((chunk) => chunk.chunkIndex),
+            score: first.score,
+        });
+        chunks.push(...group.map((hit) => ({
+            n,
+            sourceUid: hit.payload.sourceUid,
+            documentId: hit.payload.documentId,
+            chunkIndex: hit.payload.chunkIndex,
+            title: hit.payload.title,
+            ...(hit.payload.url ? { url: hit.payload.url } : {}),
+            text: hit.payload.text,
+        })));
+    });
+    return { sources, chunks };
+}
+function mergeHits(anchorHits, globalHits, topK) {
+    const byChunk = new Map();
+    for (const hit of [...anchorHits, ...globalHits]) {
+        const key = `${hit.payload.sourceUid}:${hit.payload.documentId}:${hit.payload.locale}:${hit.payload.chunkIndex}`;
+        const current = byChunk.get(key);
+        if (!current || current.score < hit.score)
+            byChunk.set(key, hit);
+    }
+    return [...byChunk.values()]
+        .sort((left, right) => right.score - left.score)
+        .slice(0, topK);
+}
+function createRetrieval(dependencies) {
+    return {
+        async query(input) {
+            if (input.sources.length === 0)
+                return { sources: [], chunks: [] };
+            const [vector] = await dependencies.embeddings.embed([input.query]);
+            if (!vector)
+                throw new Error("Embedding request returned no vector");
+            const globalFilter = {
+                locale: input.locale,
+                scopes: input.sources.map((source) => ({
+                    sourceUid: source.uid,
+                    configRevision: source.configRevision,
+                    serializerRevision: source.serializerRevision,
+                })),
+            };
+            const global = dependencies.store.search(vector, input.topK, globalFilter);
+            const anchored = input.anchor
+                ? dependencies.store.search(vector, input.anchor.topK, {
+                    ...globalFilter,
+                    document: {
+                        sourceUid: input.anchor.sourceUid,
+                        documentId: input.anchor.documentId,
+                    },
+                })
+                : Promise.resolve([]);
+            const [globalHits, anchorHits] = await Promise.all([global, anchored]);
+            return groupHits(mergeHits(anchorHits, globalHits, input.topK));
+        },
+    };
+}
+const retrieval = (_) => ({
+    create(dependencies) {
+        return createRetrieval(dependencies);
+    },
+});
+exports.default = retrieval;
+//# sourceMappingURL=retrieval.js.map

package/dist/server/src/services/retrieval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.js","sourceRoot":"","sources":["../../../../server/src/services/retrieval.ts"],"names":[],"mappings":";;AAkHA,0CAgCC;AA3GD,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAClC,OAAO,UAAU,CAAC,MAAM,IAAI,GAAG;QAC7B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC;AAC9C,CAAC;AAED,SAAS,SAAS,CAAC,IAAiB;IAClC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;;YACtB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;SACjC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;SACrE,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;IAEzE,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QACpB,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACtC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;YAClC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU;SACnC,CAAC,CAAC,CAAC;QACJ,MAAM,mBAAmB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC;YACX,CAAC;YACD,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS;YAClC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU;YACpC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK;YAC1B,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW;gBAC3B,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE;gBAC5C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,QAAQ,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;YAC3D,YAAY,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;YAClE,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CACT,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACrB,CAAC;YACD,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS;YAChC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU;YAClC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU;YAClC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK;YACxB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI;SACvB,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,SAAS,CAChB,UAAuB,EACvB,UAAuB,EACvB,IAAY;IAEZ,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,UAAU,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACjH,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;SACzB,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;SAC/C,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACpB,CAAC;AAED,SAAgB,eAAe,CAAC,YAAmC;IACjE,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,KAAqB;YAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YACnE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACpE,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACrE,MAAM,YAAY,GAAG;gBACnB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBACrC,SAAS,EAAE,MAAM,CAAC,GAAG;oBACrB,cAAc,EAAE,MAAM,CAAC,cAAc;oBACrC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;iBAC9C,CAAC,CAAC;aACJ,CAAC;YACF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CACtC,MAAM,EACN,KAAK,CAAC,IAAI,EACV,YAAY,CACb,CAAC;YACF,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM;gBAC3B,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;oBACnD,GAAG,YAAY;oBACf,QAAQ,EAAE;wBACR,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;wBACjC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;qBACpC;iBACF,CAAC;gBACJ,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACxB,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;YACvE,OAAO,SAAS,CAAC,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,CAAC,YAAmC;QACxC,OAAO,eAAe,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;CACF,CAAC,CAAC;AAEH,kBAAe,SAAS,CAAC"}

package/dist/server/src/services/schema-serializer.d.ts

@@ -0,0 +1,27 @@
+export interface StrapiAttribute {
+    type: string;
+    component?: string;
+    components?: string[];
+    repeatable?: boolean;
+}
+export interface StrapiSchema {
+    attributes?: Record<string, StrapiAttribute>;
+}
+export interface SchemaRegistry {
+    contentTypes: Record<string, StrapiSchema>;
+    components: Record<string, StrapiSchema>;
+}
+export interface SerializationContext {
+    registry: SchemaRegistry;
+    excludedFields?: ReadonlySet<string>;
+    rootExcludedFields?: ReadonlySet<string>;
+    componentSerializer?: (componentUid: string, value: unknown, context: SerializationContext) => string;
+}
+export declare function strings(values: unknown[]): string;
+export declare function serializeComponent(componentUid: string, value: unknown, context: SerializationContext): string;
+export declare function serializeComponentFallback(componentUid: string, value: unknown, context: SerializationContext): string;
+export declare function serializeContentType(contentTypeUid: string, value: unknown, context: SerializationContext): string;
+export declare function serializeAttribute(attribute: StrapiAttribute, value: unknown, context: SerializationContext): string;
+/** Build the Documents API populate shape, intentionally excluding relations. */
+export declare function derivePopulate(schema: StrapiSchema, registry: SchemaRegistry, seen?: Set<string>): Record<string, unknown>;
+//# sourceMappingURL=schema-serializer.d.ts.map

package/dist/server/src/services/schema-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-serializer.d.ts","sourceRoot":"","sources":["../../../../server/src/services/schema-serializer.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,mBAAmB,CAAC,EAAE,CACpB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,oBAAoB,KAC1B,MAAM,CAAC;CACb;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAMjD;AAED,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAKR;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAGR;AAED,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAGR;AAaD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAoCR;AAuBD,iFAAiF;AACjF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,cAAc,EACxB,IAAI,cAAoB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuCzB"}

package/dist/server/src/services/schema-serializer.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.strings = strings;
+exports.serializeComponent = serializeComponent;
+exports.serializeComponentFallback = serializeComponentFallback;
+exports.serializeContentType = serializeContentType;
+exports.serializeAttribute = serializeAttribute;
+exports.derivePopulate = derivePopulate;
+const blocks_serializer_1 = require("./blocks-serializer");
+function strings(values) {
+    return values
+        .filter((value) => typeof value === "string")
+        .map((value) => value.trim())
+        .filter(Boolean)
+        .join("\n\n");
+}
+function serializeComponent(componentUid, value, context) {
+    if (context.componentSerializer) {
+        return context.componentSerializer(componentUid, value, context);
+    }
+    return serializeComponentFallback(componentUid, value, context);
+}
+function serializeComponentFallback(componentUid, value, context) {
+    const schema = context.registry.components[componentUid];
+    return schema ? walkSchema(value, schema, context) : "";
+}
+function serializeContentType(contentTypeUid, value, context) {
+    const schema = context.registry.contentTypes[contentTypeUid];
+    return schema ? walkSchema(value, schema, context, true) : "";
+}
+function serializeMedia(value) {
+    const items = Array.isArray(value) ? value : [value];
+    return strings(items.map((item) => item && typeof item === "object"
+        ? item.alternativeText
+        : undefined));
+}
+function serializeAttribute(attribute, value, context) {
+    switch (attribute.type) {
+        case "string":
+        case "text":
+        case "richtext":
+            return typeof value === "string" ? value.trim() : "";
+        case "blocks":
+            return (0, blocks_serializer_1.blocksToText)(value);
+        case "media":
+            return serializeMedia(value);
+        case "component": {
+            if (!attribute.component)
+                return "";
+            const values = Array.isArray(value)
+                ? value
+                : value == null
+                    ? []
+                    : [value];
+            return strings(values.map((item) => serializeComponent(attribute.component, item, context)));
+        }
+        case "dynamiczone":
+            return strings((Array.isArray(value) ? value : []).map((item) => {
+                if (!item || typeof item !== "object")
+                    return "";
+                const record = item;
+                return typeof record.__component === "string"
+                    ? serializeComponent(record.__component, record, context)
+                    : "";
+            }));
+        default:
+            return "";
+    }
+}
+function walkSchema(value, schema, context, isRoot = false) {
+    if (!value || typeof value !== "object")
+        return "";
+    const record = value;
+    return Object.entries(schema.attributes ?? {})
+        .filter(([field]) => !context.excludedFields?.has(field) &&
+        !(isRoot && context.rootExcludedFields?.has(field)))
+        .map(([field, attribute]) => serializeAttribute(attribute, record[field], context))
+        .filter(Boolean)
+        .join("\n\n");
+}
+/** Build the Documents API populate shape, intentionally excluding relations. */
+function derivePopulate(schema, registry, seen = new Set()) {
+    const populate = {};
+    for (const [field, attribute] of Object.entries(schema.attributes ?? {})) {
+        if (attribute.type === "media") {
+            populate[field] = true;
+        }
+        else if (attribute.type === "component" && attribute.component) {
+            if (seen.has(attribute.component)) {
+                populate[field] = true;
+            }
+            else {
+                const nested = derivePopulate(registry.components[attribute.component] ?? {}, registry, new Set([...seen, attribute.component]));
+                populate[field] = Object.keys(nested).length
+                    ? { populate: nested }
+                    : true;
+            }
+        }
+        else if (attribute.type === "dynamiczone") {
+            const on = {};
+            for (const uid of attribute.components ??
+                Object.keys(registry.components)) {
+                const component = registry.components[uid];
+                if (!component)
+                    continue;
+                if (seen.has(uid)) {
+                    on[uid] = true;
+                }
+                else {
+                    const nested = derivePopulate(component, registry, new Set([...seen, uid]));
+                    on[uid] = Object.keys(nested).length ? { populate: nested } : true;
+                }
+            }
+            populate[field] = { on };
+        }
+    }
+    return populate;
+}
+//# sourceMappingURL=schema-serializer.js.map

package/dist/server/src/services/schema-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-serializer.js","sourceRoot":"","sources":["../../../../server/src/services/schema-serializer.ts"],"names":[],"mappings":"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"}

package/dist/server/src/services/serializer.d.ts

@@ -0,0 +1,26 @@
+import type { Core } from "@strapi/strapi";
+import { type SerializationContext } from "./schema-serializer";
+/** Bump when the built-in serializer output semantics change. */
+export declare const SERIALIZER_VERSION = "1";
+export interface SerializerOverrideContext {
+    walk(value: unknown, fieldOrComponentUid?: string): string;
+    text(value: unknown): string;
+}
+export type SerializerOverride = (value: Record<string, unknown>, context: SerializerOverrideContext) => string;
+export type SerializerOverrides = Record<string, SerializerOverride>;
+declare const serializer: ({ strapi }: {
+    strapi: Core.Strapi;
+}) => {
+    registerOverrides(entries: SerializerOverrides): void;
+    hasOverride(componentUid: string): boolean;
+    /**
+     * Returns a diagnostic checksum, not the persisted integer revision used
+     * by knowledge-source records and Qdrant filters. Captured closure state
+     * is not represented; bump and reindex affected sources explicitly.
+     */
+    getSerializerRevision: () => string;
+    getSerializerFingerprint: () => string;
+    serializeComponent: (componentUid: string, value: unknown, context: SerializationContext) => string;
+};
+export default serializer;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/server/src/services/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../../../server/src/services/serializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAKL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3D,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,yBAAyB,KAC/B,MAAM,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAsDrE,QAAA,MAAM,UAAU,GAAI,YAAY;IAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAA;CAAE;+BAwCxB,mBAAmB,GAAG,IAAI;8BAU3B,MAAM,GAAG,OAAO;IAG1C;;;;OAIG;iCAtDgC,MAAM;oCAAN,MAAM;uCAY3B,MAAM,SACb,OAAO,WACL,oBAAoB,KAC5B,MAAM;CA4CV,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/server/src/services/serializer.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERIALIZER_VERSION = void 0;
+const blocks_serializer_1 = require("./blocks-serializer");
+const canonical_json_1 = require("./canonical-json");
+const schema_serializer_1 = require("./schema-serializer");
+/** Bump when the built-in serializer output semantics change. */
+exports.SERIALIZER_VERSION = "1";
+function isBlockNode(value) {
+    return Boolean(value &&
+        typeof value === "object" &&
+        typeof value.type === "string" &&
+        Array.isArray(value.children));
+}
+function walkValue(value, context, fieldOrComponentUid, parentComponentUid) {
+    if (value == null)
+        return "";
+    if (fieldOrComponentUid) {
+        if (context.registry.components[fieldOrComponentUid]) {
+            const values = Array.isArray(value) ? value : [value];
+            return (0, schema_serializer_1.strings)(values.map((item) => (0, schema_serializer_1.serializeComponent)(fieldOrComponentUid, item, context)));
+        }
+        const attribute = parentComponentUid
+            ? context.registry.components[parentComponentUid]?.attributes?.[fieldOrComponentUid]
+            : undefined;
+        if (attribute)
+            return (0, schema_serializer_1.serializeAttribute)(attribute, value, context);
+    }
+    if (typeof value === "string")
+        return (0, blocks_serializer_1.blocksToText)(value);
+    if (typeof value !== "object")
+        return "";
+    if (Array.isArray(value)) {
+        if (value.some(isBlockNode))
+            return (0, blocks_serializer_1.blocksToText)(value);
+        return (0, schema_serializer_1.strings)(value.map((item) => walkValue(item, context)));
+    }
+    const record = value;
+    if (typeof record.__component === "string") {
+        return (0, schema_serializer_1.serializeComponent)(record.__component, record, context);
+    }
+    if (isBlockNode(record))
+        return (0, blocks_serializer_1.blocksToText)(record);
+    return (0, schema_serializer_1.strings)(Object.entries(record)
+        .filter(([key]) => key !== "__component" && !context.excludedFields?.has(key))
+        .map(([, nested]) => walkValue(nested, context)));
+}
+const serializer = ({ strapi }) => {
+    const overrides = new Map();
+    const getSerializerFingerprint = () => (0, canonical_json_1.checksum)({
+        version: exports.SERIALIZER_VERSION,
+        overrides: [...overrides.entries()]
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([componentUid, override]) => ({
+            componentUid,
+            implementation: override.toString(),
+        })),
+    });
+    const serializeComponent = (componentUid, value, context) => {
+        const fallback = () => (0, schema_serializer_1.serializeComponentFallback)(componentUid, value, context);
+        const override = overrides.get(componentUid);
+        if (!override || !value || typeof value !== "object")
+            return fallback();
+        try {
+            return String(override(value, {
+                walk: (nested, fieldOrComponentUid) => walkValue(nested, context, fieldOrComponentUid, componentUid),
+                text: blocks_serializer_1.blocksToText,
+            }) ?? "").trim();
+        }
+        catch (error) {
+            strapi.log.warn(`[agent] serializer override failed for ${componentUid}: ${error instanceof Error ? error.message : String(error)}`);
+            return fallback();
+        }
+    };
+    return {
+        registerOverrides(entries) {
+            for (const [componentUid, override] of Object.entries(entries)) {
+                if (typeof override !== "function") {
+                    throw new TypeError(`serializer override for ${componentUid} must be a function`);
+                }
+                overrides.set(componentUid, override);
+            }
+        },
+        hasOverride(componentUid) {
+            return overrides.has(componentUid);
+        },
+        /**
+         * Returns a diagnostic checksum, not the persisted integer revision used
+         * by knowledge-source records and Qdrant filters. Captured closure state
+         * is not represented; bump and reindex affected sources explicitly.
+         */
+        getSerializerRevision: getSerializerFingerprint,
+        getSerializerFingerprint,
+        serializeComponent,
+    };
+};
+exports.default = serializer;
+//# sourceMappingURL=serializer.js.map

package/dist/server/src/services/serializer.js.map

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

package/dist/server/src/services/sse.d.ts

@@ -0,0 +1,8 @@
+import type { ChatEvent } from "@dani-builder/agent-contract";
+export interface SseStream {
+    readable: ReadableStream<Uint8Array>;
+    write(event: ChatEvent): void;
+    close(): void;
+}
+export declare function createSseStream(): SseStream;
+//# sourceMappingURL=sse.d.ts.map

package/dist/server/src/services/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../../server/src/services/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACrC,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,eAAe,IAAI,SAAS,CAkC3C"}