@dani-builder/strapi-plugin-agent 0.2.0

package/dist/server/src/routes/content-api.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const contentApi = {
+    type: "content-api",
+    routes: [
+        {
+            method: "POST",
+            path: "/chat",
+            handler: "chat.stream",
+            config: { policies: ["plugin::agent.rate-limit"] },
+        },
+    ],
+};
+exports.default = contentApi;
+//# sourceMappingURL=content-api.js.map

package/dist/server/src/routes/content-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-api.js","sourceRoot":"","sources":["../../../../server/src/routes/content-api.ts"],"names":[],"mappings":";;AAAA,MAAM,UAAU,GAAG;IACjB,IAAI,EAAE,aAAsB;IAC5B,MAAM,EAAE;QACN;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,aAAa;YACtB,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,0BAA0B,CAAC,EAAE;SACnD;KACF;CACF,CAAC;AAEF,kBAAe,UAAU,CAAC"}

package/dist/server/src/routes/index.d.ts

@@ -0,0 +1,15 @@
+declare const _default: {
+    "content-api": {
+        type: "content-api";
+        routes: {
+            method: string;
+            path: string;
+            handler: string;
+            config: {
+                policies: string[];
+            };
+        }[];
+    };
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/src/routes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../server/src/routes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAEA,wBAA6C"}

package/dist/server/src/routes/index.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const content_api_1 = __importDefault(require("./content-api"));
+exports.default = { "content-api": content_api_1.default };
+//# sourceMappingURL=index.js.map

package/dist/server/src/routes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/src/routes/index.ts"],"names":[],"mappings":";;;;;AAAA,gEAAuC;AAEvC,kBAAe,EAAE,aAAa,EAAE,qBAAU,EAAE,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare function blocksToText(value: unknown): string;
+//# sourceMappingURL=blocks-serializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blocks-serializer.d.ts","sourceRoot":"","sources":["../../../../server/src/services/blocks-serializer.ts"],"names":[],"mappings":"AAuCA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcnD"}

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

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blocksToText = blocksToText;
+function serializeNode(node) {
+    if (node == null)
+        return "";
+    if (typeof node.text === "string")
+        return node.text;
+    const childText = Array.isArray(node.children)
+        ? node.children.map(serializeNode).join("")
+        : "";
+    switch (node.type) {
+        case "paragraph":
+        case "heading":
+        case "quote":
+        case "list-item":
+        case "code":
+            return `${childText}\n`;
+        case "list":
+            return childText;
+        case "image":
+            return node.image?.alternativeText
+                ? `${node.image.alternativeText}\n`
+                : "";
+        default:
+            return childText;
+    }
+}
+function blocksToText(value) {
+    if (value == null)
+        return "";
+    if (typeof value === "string")
+        return value.trim();
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        return value
+            .map(serializeNode)
+            .join("")
+            .replace(/\n{3,}/g, "\n\n")
+            .trim();
+    }
+    return serializeNode(value).trim();
+}
+//# sourceMappingURL=blocks-serializer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blocks-serializer.js","sourceRoot":"","sources":["../../../../server/src/services/blocks-serializer.ts"],"names":[],"mappings":";;AAuCA,oCAcC;AAxCD,SAAS,aAAa,CAAC,IAAe;IACpC,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC5B,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAEpD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC5C,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,CAAC,CAAC,EAAE,CAAC;IAEP,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS,CAAC;QACf,KAAK,OAAO,CAAC;QACb,KAAK,WAAW,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,GAAG,SAAS,IAAI,CAAC;QAC1B,KAAK,MAAM;YACT,OAAO,SAAS,CAAC;QACnB,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,KAAK,EAAE,eAAe;gBAChC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI;gBACnC,CAAC,CAAC,EAAE,CAAC;QACT;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAgB,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAQ,KAAqB;aAC1B,GAAG,CAAC,aAAa,CAAC;aAClB,IAAI,CAAC,EAAE,CAAC;aACR,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;aAC1B,IAAI,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,aAAa,CAAC,KAAkB,CAAC,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/dist/server/src/services/canonical-json.d.ts

@@ -0,0 +1,4 @@
+/** Deterministic JSON: object keys sorted, arrays retained, undefined dropped. */
+export declare function canonicalJson(value: unknown): string;
+export declare function checksum(value: unknown): string;
+//# sourceMappingURL=canonical-json.d.ts.map

package/dist/server/src/services/canonical-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.d.ts","sourceRoot":"","sources":["../../../../server/src/services/canonical-json.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAsBpD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C"}

package/dist/server/src/services/canonical-json.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalJson = canonicalJson;
+exports.checksum = checksum;
+const node_crypto_1 = require("node:crypto");
+/** Deterministic JSON: object keys sorted, arrays retained, undefined dropped. */
+function canonicalJson(value) {
+    if (value === null)
+        return "null";
+    if (typeof value === "object" &&
+        typeof value.toJSON === "function") {
+        return canonicalJson(value.toJSON());
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => canonicalJson(entry)).join(",")}]`;
+    }
+    if (typeof value === "object") {
+        const entries = Object.entries(value)
+            .filter(([, entryValue]) => entryValue !== undefined)
+            .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+            .map(([key, entryValue]) => `${JSON.stringify(key)}:${canonicalJson(entryValue)}`);
+        return `{${entries.join(",")}}`;
+    }
+    return JSON.stringify(value) ?? "null";
+}
+function checksum(value) {
+    return (0, node_crypto_1.createHash)("sha256").update(canonicalJson(value)).digest("hex");
+}
+//# sourceMappingURL=canonical-json.js.map

package/dist/server/src/services/canonical-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.js","sourceRoot":"","sources":["../../../../server/src/services/canonical-json.ts"],"names":[],"mappings":";;AAGA,sCAsBC;AAED,4BAEC;AA7BD,6CAAyC;AAEzC,kFAAkF;AAClF,SAAgB,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAQ,KAA8B,CAAC,MAAM,KAAK,UAAU,EAC5D,CAAC;QACD,OAAO,aAAa,CAAE,KAAmC,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrE,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;aAC7D,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC;aACpD,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aACrE,GAAG,CACF,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,CACpB,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CACxD,CAAC;QACJ,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;AACzC,CAAC;AAED,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC"}

package/dist/server/src/services/chat-service.d.ts

@@ -0,0 +1,27 @@
+import type { Core } from "@strapi/strapi";
+import type { ChatRequest } from "@dani-builder/agent-contract";
+import { createChatRuntime } from "./chat";
+import { type ProviderConfig } from "./provider";
+import type { QdrantLogger } from "./qdrant-store";
+import { type RetrievalSource } from "./retrieval";
+interface RuntimeConfig extends ProviderConfig {
+    qdrant?: {
+        url: string;
+        apiKey?: string;
+        collection: string;
+    };
+    retrieval?: {
+        topK?: number;
+        sources?: RetrievalSource[];
+    };
+}
+export declare function createConfiguredChatRuntime(config: RuntimeConfig, logger?: QdrantLogger): {
+    stream(input: ChatRequest, emit: (event: import("@dani-builder/agent-contract", { with: { "resolution-mode": "import" } }).ChatEvent) => void, signal?: AbortSignal): Promise<void>;
+};
+declare const chatService: ({ strapi }: {
+    strapi: Core.Strapi;
+}) => {
+    stream(input: ChatRequest, emit: Parameters<ReturnType<typeof createChatRuntime>["stream"]>[1], signal: AbortSignal): Promise<void>;
+};
+export default chatService;
+//# sourceMappingURL=chat-service.d.ts.map

package/dist/server/src/services/chat-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-service.d.ts","sourceRoot":"","sources":["../../../../server/src/services/chat-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpE,UAAU,aAAc,SAAQ,cAAc;IAC5C,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC;CAC5D;AAMD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,aAAa,EACrB,MAAM,CAAC,EAAE,YAAY;;EA2BtB;AAED,QAAA,MAAM,WAAW,GAAI,YAAY;IAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAA;CAAE;kBAE7C,WAAW,QACZ,UAAU,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAC3D,WAAW;CASrB,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/server/src/services/chat-service.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConfiguredChatRuntime = createConfiguredChatRuntime;
+const embeddings_1 = require("./embeddings");
+const chat_1 = require("./chat");
+const provider_1 = require("./provider");
+const qdrant_store_1 = require("./qdrant-store");
+const retrieval_1 = require("./retrieval");
+function runtimeConfig(value) {
+    return value && typeof value === "object" ? value : {};
+}
+function createConfiguredChatRuntime(config, logger) {
+    const sources = config.retrieval?.sources ?? [];
+    const topK = config.retrieval?.topK ?? 6;
+    const retrieval = config.qdrant?.url && config.qdrant.collection && config.openaiApiKey
+        ? (0, retrieval_1.createRetrieval)({
+            embeddings: (0, embeddings_1.createOpenAiEmbeddings)({ apiKey: config.openaiApiKey }),
+            store: (0, qdrant_store_1.createQdrantStore)({
+                ...config.qdrant,
+                ...(logger ? { logger } : {}),
+            }),
+        })
+        : null;
+    return (0, chat_1.createChatRuntime)({
+        provider: (0, provider_1.selectProvider)(config),
+        retrieve: async ({ query, locale, anchor }) => retrieval
+            ? retrieval.query({
+                query,
+                locale,
+                topK,
+                sources,
+                ...(anchor ? { anchor } : {}),
+            })
+            : { sources: [], chunks: [] },
+    });
+}
+const chatService = ({ strapi }) => ({
+    stream(input, emit, signal) {
+        const config = runtimeConfig(strapi.config.get("plugin::agent"));
+        return createConfiguredChatRuntime(config, {
+            warn(warning) {
+                strapi.log.warn(JSON.stringify(warning));
+            },
+        }).stream(input, emit, signal);
+    },
+});
+exports.default = chatService;
+//# sourceMappingURL=chat-service.js.map

package/dist/server/src/services/chat-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-service.js","sourceRoot":"","sources":["../../../../server/src/services/chat-service.ts"],"names":[],"mappings":";;AAkBA,kEA6BC;AA7CD,6CAAsD;AACtD,iCAA2C;AAC3C,yCAAiE;AACjE,iDAAmD;AAEnD,2CAAoE;AAOpE,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,SAAgB,2BAA2B,CACzC,MAAqB,EACrB,MAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC;IACzC,MAAM,SAAS,GACb,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,YAAY;QACnE,CAAC,CAAC,IAAA,2BAAe,EAAC;YACd,UAAU,EAAE,IAAA,mCAAsB,EAAC,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;YACnE,KAAK,EAAE,IAAA,gCAAiB,EAAC;gBACvB,GAAG,MAAM,CAAC,MAAM;gBAChB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9B,CAAC;SACH,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IACX,OAAO,IAAA,wBAAiB,EAAC;QACvB,QAAQ,EAAE,IAAA,yBAAc,EAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAC5C,SAAS;YACP,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;gBACd,KAAK;gBACL,MAAM;gBACN,IAAI;gBACJ,OAAO;gBACP,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9B,CAAC;YACJ,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,EAAE,MAAM,EAA2B,EAAE,EAAE,CAAC,CAAC;IAC5D,MAAM,CACJ,KAAkB,EAClB,IAAmE,EACnE,MAAmB;QAEnB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;QACjE,OAAO,2BAA2B,CAAC,MAAM,EAAE;YACzC,IAAI,CAAC,OAAO;gBACV,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3C,CAAC;SACF,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;CACF,CAAC,CAAC;AAEH,kBAAe,WAAW,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { ChatEvent, ChatRequest } from "@dani-builder/agent-contract";
+import type { RetrievalResult } from "./retrieval";
+import type { ChatProvider } from "./provider";
+export interface ChatRuntimeDependencies {
+    provider: ChatProvider | null;
+    retrieve(input: {
+        query: string;
+        locale: string;
+        anchor?: {
+            sourceUid: string;
+            documentId: string;
+            topK: number;
+        };
+    }): Promise<RetrievalResult>;
+    newId?: () => string;
+}
+export declare function createChatRuntime(dependencies: ChatRuntimeDependencies): {
+    stream(input: ChatRequest, emit: (event: ChatEvent) => void, signal?: AbortSignal): Promise<void>;
+};
+//# sourceMappingURL=chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../../server/src/services/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EAEZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KAClE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAsBD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,uBAAuB;kBAG1D,WAAW,QACZ,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,WACvB,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;EA0EnB"}

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

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createChatRuntime = createChatRuntime;
+function rewriteQuery(message) {
+    return message.replace(/\s+/g, " ").trim();
+}
+function assemblePrompt(sources) {
+    const context = sources
+        .map((source) => `[${source.n}] ${source.title}\n${source.excerpts.join("\n")}`)
+        .join("\n\n");
+    return [
+        "Answer only from the supplied knowledge-base context.",
+        "Cite supporting sources using their bracketed number.",
+        context
+            ? `Knowledge base:\n${context}`
+            : "No matching knowledge-base context was found.",
+    ].join("\n\n");
+}
+function createChatRuntime(dependencies) {
+    return {
+        async stream(input, emit, signal) {
+            const message = rewriteQuery(input.message);
+            if (!message) {
+                emit({
+                    event: "error",
+                    data: { code: "invalid_message", message: "message is required" },
+                });
+                return;
+            }
+            const sessionId = input.sessionId ??
+                (dependencies.newId ?? (() => crypto.randomUUID()))();
+            const agentId = input.agentId ?? "@default";
+            const locale = input.locale?.trim() || "en";
+            emit({ event: "session", data: { sessionId, agentId } });
+            if (!dependencies.provider) {
+                emit({
+                    event: "error",
+                    data: { code: "provider_unconfigured", message: "" },
+                });
+                return;
+            }
+            let retrieved;
+            try {
+                retrieved = await dependencies.retrieve({
+                    query: message,
+                    locale,
+                    ...(input.context
+                        ? {
+                            anchor: {
+                                sourceUid: input.context.sourceUid,
+                                documentId: input.context.documentId,
+                                topK: 3,
+                            },
+                        }
+                        : {}),
+                });
+            }
+            catch {
+                emit({
+                    event: "error",
+                    data: { code: "retrieval_failed", message: "" },
+                });
+                return;
+            }
+            emit({ event: "sources", data: retrieved.sources });
+            let text = "";
+            try {
+                for await (const delta of dependencies.provider.stream({
+                    system: assemblePrompt(retrieved.sources),
+                    message,
+                    signal,
+                })) {
+                    text += delta;
+                    emit({ event: "delta", data: { text: delta } });
+                }
+                emit({
+                    event: "done",
+                    data: {
+                        sessionId,
+                        agentId,
+                        text,
+                        sources: retrieved.sources,
+                        extensions: [],
+                    },
+                });
+            }
+            catch {
+                if (signal?.aborted)
+                    return;
+                emit({
+                    event: "error",
+                    data: { code: "provider_failed", message: "" },
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=chat.js.map

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

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

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

@@ -0,0 +1,11 @@
+/** Split text into overlapping chunks using a four-characters-per-token heuristic. */
+export interface Chunk {
+    index: number;
+    text: string;
+}
+export interface ChunkOptions {
+    targetTokens: number;
+    overlapTokens: number;
+}
+export declare function chunkText(text: string, options?: Partial<ChunkOptions>): Chunk[];
+//# sourceMappingURL=chunker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../../../server/src/services/chunker.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAqCD,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAClC,KAAK,EAAE,CA+BT"}

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

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chunkText = chunkText;
+const charsPerToken = 4;
+const defaults = { targetTokens: 800, overlapTokens: 120 };
+function splitLongParagraph(paragraph, maxChars) {
+    if (paragraph.length <= maxChars)
+        return [paragraph];
+    const sentences = paragraph.match(/[^.!?。\n]+[.!?。]?\s*/g) ?? [paragraph];
+    const output = [];
+    let buffer = "";
+    for (const sentence of sentences) {
+        if (buffer.length + sentence.length > maxChars && buffer) {
+            output.push(buffer.trim());
+            buffer = "";
+        }
+        if (sentence.length > maxChars) {
+            for (const word of sentence.split(/(\s+)/)) {
+                if (buffer.length + word.length > maxChars && buffer) {
+                    output.push(buffer.trim());
+                    buffer = "";
+                }
+                if (word.length > maxChars) {
+                    for (let index = 0; index < word.length; index += maxChars) {
+                        output.push(word.slice(index, index + maxChars));
+                    }
+                }
+                else {
+                    buffer += word;
+                }
+            }
+        }
+        else {
+            buffer += sentence;
+        }
+    }
+    if (buffer.trim())
+        output.push(buffer.trim());
+    return output;
+}
+function chunkText(text, options = {}) {
+    const { targetTokens, overlapTokens } = { ...defaults, ...options };
+    const maxChars = targetTokens * charsPerToken;
+    const overlapChars = Math.min(overlapTokens * charsPerToken, Math.max(0, maxChars - 3));
+    const unitMaxChars = Math.max(1, maxChars - (overlapChars > 0 ? overlapChars + 2 : 0));
+    const clean = text.replace(/\r\n/g, "\n").trim();
+    if (!clean)
+        return [];
+    const units = clean
+        .split(/\n{2,}/)
+        .map((paragraph) => paragraph.trim())
+        .filter(Boolean)
+        .flatMap((paragraph) => splitLongParagraph(paragraph, unitMaxChars));
+    const chunks = [];
+    let current = "";
+    for (const unit of units) {
+        if (current.length + unit.length + 2 > maxChars && current) {
+            chunks.push(current.trim());
+            current = overlapChars > 0 ? current.slice(-overlapChars).trim() : "";
+        }
+        current += `${current ? "\n\n" : ""}${unit}`;
+    }
+    if (current.trim())
+        chunks.push(current.trim());
+    return chunks.map((chunk, index) => ({ index, text: chunk }));
+}
+//# sourceMappingURL=chunker.js.map

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

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

package/dist/server/src/services/control-plane.d.ts

@@ -0,0 +1,13 @@
+export interface ControlPlaneConfig {
+    url?: string;
+    token?: string;
+}
+export interface ControlPlaneClient {
+    get(path: string): Promise<unknown | null>;
+}
+/**
+ * The control plane is optional for self-hosted plugin deployments. Returning
+ * null rather than attempting a request makes the unconfigured path inert.
+ */
+export declare function selectControlPlane(config: ControlPlaneConfig, request?: typeof fetch): ControlPlaneClient | null;
+//# sourceMappingURL=control-plane.d.ts.map

package/dist/server/src/services/control-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../../../../server/src/services/control-plane.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC5C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,OAAO,KAAa,GAC5B,kBAAkB,GAAG,IAAI,CAc3B"}

package/dist/server/src/services/control-plane.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectControlPlane = selectControlPlane;
+/**
+ * The control plane is optional for self-hosted plugin deployments. Returning
+ * null rather than attempting a request makes the unconfigured path inert.
+ */
+function selectControlPlane(config, request = fetch) {
+    if (!config.url || !config.token)
+        return null;
+    const baseUrl = config.url.replace(/\/+$/, "");
+    return {
+        async get(path) {
+            const response = await request(`${baseUrl}/${path.replace(/^\/+/, "")}`, {
+                headers: { Authorization: `Bearer ${config.token}` },
+            });
+            if (response.status === 404)
+                return null;
+            if (!response.ok)
+                throw new Error(`Control-plane request failed (${response.status})`);
+            return response.json();
+        },
+    };
+}
+//# sourceMappingURL=control-plane.js.map

package/dist/server/src/services/control-plane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane.js","sourceRoot":"","sources":["../../../../server/src/services/control-plane.ts"],"names":[],"mappings":";;AAaA,gDAiBC;AArBD;;;GAGG;AACH,SAAgB,kBAAkB,CAChC,MAA0B,EAC1B,UAAwB,KAAK;IAE7B,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,IAAY;YACpB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;gBACvE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE;aACrD,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBACd,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YACvE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,10 @@
+export interface EmbeddingsClient {
+    embed(texts: string[]): Promise<number[][]>;
+}
+export interface OpenAiEmbeddingsOptions {
+    apiKey: string;
+    model?: string;
+    fetch?: typeof globalThis.fetch;
+}
+export declare function createOpenAiEmbeddings(options: OpenAiEmbeddingsOptions): EmbeddingsClient;
+//# sourceMappingURL=embeddings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../../../server/src/services/embeddings.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AA0BD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,gBAAgB,CA6ClB"}

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

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenAiEmbeddings = createOpenAiEmbeddings;
+function isVector(value) {
+    return (Array.isArray(value) &&
+        value.length > 0 &&
+        value.every((dimension) => typeof dimension === "number" && Number.isFinite(dimension)));
+}
+function isIndex(value, length) {
+    return (typeof value === "number" &&
+        Number.isInteger(value) &&
+        value >= 0 &&
+        value < length);
+}
+function createOpenAiEmbeddings(options) {
+    const request = options.fetch ?? globalThis.fetch;
+    const model = options.model ?? "text-embedding-3-small";
+    return {
+        async embed(texts) {
+            if (texts.length === 0)
+                return [];
+            const response = await request("https://api.openai.com/v1/embeddings", {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${options.apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({ input: texts, model }),
+            });
+            if (!response.ok) {
+                throw new Error(`OpenAI embeddings request failed (${response.status})`);
+            }
+            const payload = (await response.json());
+            const indexedVectors = payload.data ?? [];
+            const vectors = Array.from({
+                length: texts.length,
+            });
+            for (const item of indexedVectors) {
+                if (!isIndex(item.index, texts.length) ||
+                    !isVector(item.embedding) ||
+                    vectors[item.index] !== undefined) {
+                    throw new Error("OpenAI embeddings response has invalid vectors");
+                }
+                vectors[item.index] = item.embedding;
+            }
+            const orderedVectors = vectors.filter(isVector);
+            if (indexedVectors.length !== texts.length ||
+                orderedVectors.length !== texts.length) {
+                throw new Error("OpenAI embeddings response has invalid vectors");
+            }
+            return orderedVectors;
+        },
+    };
+}
+//# sourceMappingURL=embeddings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../../../server/src/services/embeddings.ts"],"names":[],"mappings":";;AAkCA,wDA+CC;AAnED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,KAAK,CAAC,KAAK,CACT,CAAC,SAAS,EAAE,EAAE,CACZ,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC9D,CACF,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,KAAc,EAAE,MAAc;IAC7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QACvB,KAAK,IAAI,CAAC;QACV,KAAK,GAAG,MAAM,CACf,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CACpC,OAAgC;IAEhC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAAC;IAExD,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,KAAe;YACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,sCAAsC,EAAE;gBACrE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,OAAO,CAAC,MAAM,EAAE;oBACzC,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;aAC9C,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,qCAAqC,QAAQ,CAAC,MAAM,GAAG,CACxD,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAuB,CAAC;YAC9D,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAgC,KAAK,CAAC,IAAI,CAAC;gBACtD,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;YACH,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;gBAClC,IACE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;oBAClC,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;oBACzB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,EACjC,CAAC;oBACD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;gBACpE,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YACvC,CAAC;YACD,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChD,IACE,cAAc,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;gBACtC,cAAc,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EACtC,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,cAAc,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,20 @@
+import { type SchemaRegistry, type SerializationContext } from "./schema-serializer";
+export interface KbSourceExtraction {
+    uid: string;
+    bodyFields: string[];
+    extractionMode?: "flat" | "schema";
+    excludedFields?: string[];
+    titleField: string;
+    descriptionField?: string;
+    slugField?: string;
+    urlPattern?: string;
+}
+export interface ExtractedDocument {
+    title: string;
+    description?: string;
+    text: string;
+    url?: string;
+}
+/** Extract a stable text document from either flat field mappings or a schema. */
+export declare function extractDocument(entry: Record<string, unknown>, source: KbSourceExtraction, registry?: SchemaRegistry, componentSerializer?: SerializationContext["componentSerializer"]): ExtractedDocument;
+//# sourceMappingURL=extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../../server/src/services/extractor.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,CAAC,EAAE,cAAc,EACzB,mBAAmB,CAAC,EAAE,oBAAoB,CAAC,qBAAqB,CAAC,GAChE,iBAAiB,CAsCnB"}