crewly 1.13.1 → 1.14.0

package/dist/backend/backend/src/types/knowledge.types.d.ts

@@ -1,195 +0,0 @@
-/**
- * Knowledge Document Types
- *
- * Type definitions for the Company Knowledge system, which stores
- * markdown documents with YAML frontmatter for team documentation,
- * SOPs, architecture notes, runbooks, and other company knowledge.
- *
- * @module types/knowledge.types
- */
-/**
- * Scope of a knowledge document — global (company-wide) or project-specific.
- */
-export type KnowledgeScope = 'global' | 'project';
-/**
- * Default document categories available in the knowledge system.
- */
-export declare const DEFAULT_KNOWLEDGE_CATEGORIES: readonly ["SOPs", "Team Norms", "Architecture", "Onboarding", "Runbooks", "General"];
-/**
- * Type for default knowledge categories.
- */
-export type DefaultKnowledgeCategory = (typeof DEFAULT_KNOWLEDGE_CATEGORIES)[number];
-/**
- * Constants for the knowledge document system.
- */
-export declare const KNOWLEDGE_CONSTANTS: {
-    /** Maximum content length for a document (500KB) */
-    readonly MAX_CONTENT_LENGTH: 512000;
-    /** Maximum title length */
-    readonly MAX_TITLE_LENGTH: 200;
-    /** Maximum number of tags per document */
-    readonly MAX_TAGS: 20;
-    /** Maximum tag length */
-    readonly MAX_TAG_LENGTH: 50;
-    /** Maximum category name length */
-    readonly MAX_CATEGORY_LENGTH: 50;
-    /** Preview length for document summaries */
-    readonly PREVIEW_LENGTH: 200;
-};
-/**
- * YAML frontmatter stored at the top of each knowledge document file.
- */
-export interface KnowledgeFrontmatter {
-    /** Unique document identifier */
-    id: string;
-    /** Document title */
-    title: string;
-    /** Document category (from defaults or custom) */
-    category: string;
-    /** Optional tags for filtering/search */
-    tags: string[];
-    /** Who created the document (user or agent session name) */
-    createdBy: string;
-    /** Who last updated the document */
-    updatedBy: string;
-    /** ISO timestamp of creation */
-    createdAt: string;
-    /** ISO timestamp of last update */
-    updatedAt: string;
-}
-/**
- * Full knowledge document including frontmatter and markdown content.
- */
-export interface KnowledgeDocument {
-    /** Unique document identifier */
-    id: string;
-    /** Document title */
-    title: string;
-    /** Document category */
-    category: string;
-    /** Tags for filtering/search */
-    tags: string[];
-    /** Full markdown content (body only, excluding frontmatter) */
-    content: string;
-    /** Document scope */
-    scope: KnowledgeScope;
-    /** Project path if scope is 'project' */
-    projectPath?: string;
-    /** Who created the document */
-    createdBy: string;
-    /** Who last updated the document */
-    updatedBy: string;
-    /** ISO timestamp of creation */
-    createdAt: string;
-    /** ISO timestamp of last update */
-    updatedAt: string;
-}
-/**
- * Summary of a knowledge document for list views (no full content).
- */
-export interface KnowledgeDocumentSummary {
-    /** Unique document identifier */
-    id: string;
-    /** Document title */
-    title: string;
-    /** Document category */
-    category: string;
-    /** Tags for filtering/search */
-    tags: string[];
-    /** First N characters of content for preview */
-    preview: string;
-    /** Document scope */
-    scope: KnowledgeScope;
-    /** Who created the document */
-    createdBy: string;
-    /** Who last updated the document */
-    updatedBy: string;
-    /** ISO timestamp of creation */
-    createdAt: string;
-    /** ISO timestamp of last update */
-    updatedAt: string;
-}
-/**
- * Entry in the knowledge index file for fast listing.
- */
-export interface KnowledgeIndexEntry {
-    /** Document identifier */
-    id: string;
-    /** Document title */
-    title: string;
-    /** Document category */
-    category: string;
-    /** Tags */
-    tags: string[];
-    /** Content preview */
-    preview: string;
-    /** Who created the document */
-    createdBy: string;
-    /** Who last updated the document */
-    updatedBy: string;
-    /** ISO timestamp of creation */
-    createdAt: string;
-    /** ISO timestamp of last update */
-    updatedAt: string;
-    /** Cached embedding vector for semantic search (set by GeminiEmbeddingStrategy) */
-    embedding?: number[];
-}
-/**
- * JSON index stored per scope for fast document listing.
- */
-export interface KnowledgeIndex {
-    /** Schema version for future migrations */
-    version: number;
-    /** Last time the index was updated */
-    updatedAt: string;
-    /** Array of document index entries */
-    entries: KnowledgeIndexEntry[];
-}
-/**
- * Parameters for creating a new knowledge document.
- */
-export interface CreateKnowledgeDocumentParams {
-    /** Document title */
-    title: string;
-    /** Markdown content */
-    content: string;
-    /** Document category */
-    category: string;
-    /** Document scope */
-    scope: KnowledgeScope;
-    /** Project path (required when scope is 'project') */
-    projectPath?: string;
-    /** Tags for filtering/search */
-    tags?: string[];
-    /** Who is creating the document */
-    createdBy: string;
-}
-/**
- * Parameters for updating an existing knowledge document.
- */
-export interface UpdateKnowledgeDocumentParams {
-    /** Updated title */
-    title?: string;
-    /** Updated markdown content */
-    content?: string;
-    /** Updated category */
-    category?: string;
-    /** Updated tags */
-    tags?: string[];
-    /** Document scope */
-    scope: KnowledgeScope;
-    /** Project path (required when scope is 'project') */
-    projectPath?: string;
-    /** Who is updating the document */
-    updatedBy: string;
-}
-/**
- * Filters for listing knowledge documents.
- */
-export interface KnowledgeDocumentFilters {
-    /** Filter by category */
-    category?: string;
-    /** Search query (matches title, tags, preview) */
-    search?: string;
-}
-//# sourceMappingURL=knowledge.types.d.ts.map

package/dist/backend/backend/src/types/knowledge.types.d.ts.map

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

package/dist/backend/backend/src/types/knowledge.types.js

@@ -1,38 +0,0 @@
-/**
- * Knowledge Document Types
- *
- * Type definitions for the Company Knowledge system, which stores
- * markdown documents with YAML frontmatter for team documentation,
- * SOPs, architecture notes, runbooks, and other company knowledge.
- *
- * @module types/knowledge.types
- */
-/**
- * Default document categories available in the knowledge system.
- */
-export const DEFAULT_KNOWLEDGE_CATEGORIES = [
-    'SOPs',
-    'Team Norms',
-    'Architecture',
-    'Onboarding',
-    'Runbooks',
-    'General',
-];
-/**
- * Constants for the knowledge document system.
- */
-export const KNOWLEDGE_CONSTANTS = {
-    /** Maximum content length for a document (500KB) */
-    MAX_CONTENT_LENGTH: 512000,
-    /** Maximum title length */
-    MAX_TITLE_LENGTH: 200,
-    /** Maximum number of tags per document */
-    MAX_TAGS: 20,
-    /** Maximum tag length */
-    MAX_TAG_LENGTH: 50,
-    /** Maximum category name length */
-    MAX_CATEGORY_LENGTH: 50,
-    /** Preview length for document summaries */
-    PREVIEW_LENGTH: 200,
-};
-//# sourceMappingURL=knowledge.types.js.map

package/dist/backend/backend/src/types/knowledge.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge.types.js","sourceRoot":"","sources":["../../../../../backend/src/types/knowledge.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,MAAM;IACN,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,UAAU;IACV,SAAS;CACD,CAAC;AAOX;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,oDAAoD;IACpD,kBAAkB,EAAE,MAAM;IAC1B,2BAA2B;IAC3B,gBAAgB,EAAE,GAAG;IACrB,0CAA0C;IAC1C,QAAQ,EAAE,EAAE;IACZ,yBAAyB;IACzB,cAAc,EAAE,EAAE;IAClB,mCAAmC;IACnC,mBAAmB,EAAE,EAAE;IACvB,4CAA4C;IAC5C,cAAc,EAAE,GAAG;CACX,CAAC"}

package/dist/backend/backend/src/utils/esm-require.utils.d.ts

@@ -1,111 +0,0 @@
-/**
- * ESM/CJS-dual-mode helpers for the lazy `nodeRequire` pattern.
- *
- * Background
- * ----------
- * Several services in this codebase use the canonical `nodeRequire` pattern
- * (commit `070cd3e5` — `fix(esm): anchor createRequire to process.argv[1]`)
- * to lazily load modules without forcing every test that transitively imports
- * them to mock the dependency. The pattern looks like:
- *
- *     const nodeRequire: NodeRequire =
- *       typeof require === 'function'
- *         ? require
- *         : createRequire(pathToFileURL(process.argv[1] || process.cwd()).href);
- *
- * That pattern works **only** for npm-package targets (e.g.
- * `nodeRequire('better-sqlite3')`) — Node's resolver walks UP from the anchor
- * (`process.argv[1]`) to find `node_modules`, so the anchor's exact location
- * does not matter for package resolution.
- *
- * It silently breaks for **relative project paths** like
- * `nodeRequire('../v3/request.service.js')`. In production ESM, the relative
- * spec is resolved against `process.argv[1]` (the entry script) — NOT against
- * the calling module — so the require fails with `Cannot find module …`. In
- * tests (ts-jest CJS transpile) the per-module `require` parameter is used
- * instead, so the relative spec resolves correctly against the calling file
- * and the bug stays hidden.
- *
- * Symptom that motivated this helper: `core/get-my-active-work` returned 500
- * with "Cannot find module '../v3/request.service.js'" because
- * `ActiveWorkBriefingService.getInstance()` called
- * `nodeRequire('../v3/request.service.js')` from
- * `services/agent/active-work-briefing.service.js` while `nodeRequire` was
- * anchored to `dist/backend/backend/src/index.js`.
- *
- * What this helper does
- * ---------------------
- * `resolveProjectModulePath(testRelativePath, prodPathFromEntryDir)` returns:
- *
- * 1. In test mode (`typeof require === 'function'` — ts-jest CJS) — the
- *    `testRelativePath` unchanged, so the per-module CJS require resolves it
- *    relative to the calling file (its existing, working behavior).
- * 2. In production ESM — an absolute path computed by joining
- *    `path.dirname(process.argv[1])` with `prodPathFromEntryDir`.
- *    Absolute paths are accepted by `nodeRequire` regardless of anchor.
- *
- * Why this is two-arg rather than one
- * -----------------------------------
- * We considered single-arg variants:
- *   • `import.meta.url` — triggers TS1343 under ts-jest's CJS target. Even with
- *     `// @ts-expect-error`, ts-jest's transpile may still fail at parse.
- *   • `new Function('return import.meta.url')()` — was tried (PR #323) and is
- *     forbidden — `new Function` evaluates in non-module scope where
- *     `import.meta` is a SyntaxError. Crashed production at startup.
- *   • `eval('import.meta.url')` — works at runtime via direct-eval scope
- *     inheritance, but trips ESLint `no-eval` and is fragile across engines.
- *   • Stack-trace introspection — gross and slow.
- *
- * Asking the caller to spell out **two** equivalent paths (one usable from the
- * caller's perspective, one usable from the entry script's perspective) is
- * verbose but unambiguous, parse-clean under both TS targets, and free of any
- * runtime tricks.
- *
- * Usage
- * -----
- *     // Caller is at `backend/src/services/agent/active-work-briefing.service.ts`
- *     // Target is at `backend/src/services/v3/request.service.ts`
- *     // Entry script (process.argv[1]) is `dist/backend/backend/src/index.js`
- *     // → from the caller's perspective: `../v3/request.service.js`
- *     // → from the entry-script-dir's perspective: `services/v3/request.service.js`
- *
- *     const spec = resolveProjectModulePath(
- *       '../v3/request.service.js',
- *       'services/v3/request.service.js',
- *     );
- *     const { RequestService } = nodeRequire(spec);
- *
- * Test guard
- * ----------
- * `esm-require.utils.test.ts` exercises both branches and locks the contract
- * (test branch ↔ untouched relative path; prod branch ↔ absolute path joined
- * to `process.argv[1]`'s dirname).
- *
- * @module utils/esm-require.utils
- */
-/**
- * Resolves a project-relative require spec to a string safe to pass to
- * `nodeRequire` in both ts-jest CJS test mode and production ESM mode.
- *
- * @param testRelativePath - The require spec written from the calling file's
- *   perspective. Used verbatim in test mode (ts-jest CJS) where each module
- *   gets its own `require` and relative resolution Just Works. Example:
- *   `'../v3/request.service.js'`.
- * @param prodPathFromEntryDir - The require spec rewritten as a path under
- *   `path.dirname(process.argv[1])`. Used in production ESM where
- *   `nodeRequire` is anchored to the entry script. Example:
- *   `'services/v3/request.service.js'` (under `dist/backend/backend/src/`).
- * @returns A string suitable for `nodeRequire(...)`.
- *
- * @example
- * ```typescript
- * const { RequestService } = nodeRequire(
- *   resolveProjectModulePath(
- *     '../v3/request.service.js',
- *     'services/v3/request.service.js',
- *   ),
- * );
- * ```
- */
-export declare function resolveProjectModulePath(testRelativePath: string, prodPathFromEntryDir: string): string;
-//# sourceMappingURL=esm-require.utils.d.ts.map

package/dist/backend/backend/src/utils/esm-require.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"esm-require.utils.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/esm-require.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AAIH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,MAAM,EACxB,oBAAoB,EAAE,MAAM,GAC3B,MAAM,CAYR"}

package/dist/backend/backend/src/utils/esm-require.utils.js

@@ -1,124 +0,0 @@
-/**
- * ESM/CJS-dual-mode helpers for the lazy `nodeRequire` pattern.
- *
- * Background
- * ----------
- * Several services in this codebase use the canonical `nodeRequire` pattern
- * (commit `070cd3e5` — `fix(esm): anchor createRequire to process.argv[1]`)
- * to lazily load modules without forcing every test that transitively imports
- * them to mock the dependency. The pattern looks like:
- *
- *     const nodeRequire: NodeRequire =
- *       typeof require === 'function'
- *         ? require
- *         : createRequire(pathToFileURL(process.argv[1] || process.cwd()).href);
- *
- * That pattern works **only** for npm-package targets (e.g.
- * `nodeRequire('better-sqlite3')`) — Node's resolver walks UP from the anchor
- * (`process.argv[1]`) to find `node_modules`, so the anchor's exact location
- * does not matter for package resolution.
- *
- * It silently breaks for **relative project paths** like
- * `nodeRequire('../v3/request.service.js')`. In production ESM, the relative
- * spec is resolved against `process.argv[1]` (the entry script) — NOT against
- * the calling module — so the require fails with `Cannot find module …`. In
- * tests (ts-jest CJS transpile) the per-module `require` parameter is used
- * instead, so the relative spec resolves correctly against the calling file
- * and the bug stays hidden.
- *
- * Symptom that motivated this helper: `core/get-my-active-work` returned 500
- * with "Cannot find module '../v3/request.service.js'" because
- * `ActiveWorkBriefingService.getInstance()` called
- * `nodeRequire('../v3/request.service.js')` from
- * `services/agent/active-work-briefing.service.js` while `nodeRequire` was
- * anchored to `dist/backend/backend/src/index.js`.
- *
- * What this helper does
- * ---------------------
- * `resolveProjectModulePath(testRelativePath, prodPathFromEntryDir)` returns:
- *
- * 1. In test mode (`typeof require === 'function'` — ts-jest CJS) — the
- *    `testRelativePath` unchanged, so the per-module CJS require resolves it
- *    relative to the calling file (its existing, working behavior).
- * 2. In production ESM — an absolute path computed by joining
- *    `path.dirname(process.argv[1])` with `prodPathFromEntryDir`.
- *    Absolute paths are accepted by `nodeRequire` regardless of anchor.
- *
- * Why this is two-arg rather than one
- * -----------------------------------
- * We considered single-arg variants:
- *   • `import.meta.url` — triggers TS1343 under ts-jest's CJS target. Even with
- *     `// @ts-expect-error`, ts-jest's transpile may still fail at parse.
- *   • `new Function('return import.meta.url')()` — was tried (PR #323) and is
- *     forbidden — `new Function` evaluates in non-module scope where
- *     `import.meta` is a SyntaxError. Crashed production at startup.
- *   • `eval('import.meta.url')` — works at runtime via direct-eval scope
- *     inheritance, but trips ESLint `no-eval` and is fragile across engines.
- *   • Stack-trace introspection — gross and slow.
- *
- * Asking the caller to spell out **two** equivalent paths (one usable from the
- * caller's perspective, one usable from the entry script's perspective) is
- * verbose but unambiguous, parse-clean under both TS targets, and free of any
- * runtime tricks.
- *
- * Usage
- * -----
- *     // Caller is at `backend/src/services/agent/active-work-briefing.service.ts`
- *     // Target is at `backend/src/services/v3/request.service.ts`
- *     // Entry script (process.argv[1]) is `dist/backend/backend/src/index.js`
- *     // → from the caller's perspective: `../v3/request.service.js`
- *     // → from the entry-script-dir's perspective: `services/v3/request.service.js`
- *
- *     const spec = resolveProjectModulePath(
- *       '../v3/request.service.js',
- *       'services/v3/request.service.js',
- *     );
- *     const { RequestService } = nodeRequire(spec);
- *
- * Test guard
- * ----------
- * `esm-require.utils.test.ts` exercises both branches and locks the contract
- * (test branch ↔ untouched relative path; prod branch ↔ absolute path joined
- * to `process.argv[1]`'s dirname).
- *
- * @module utils/esm-require.utils
- */
-import path from 'path';
-/**
- * Resolves a project-relative require spec to a string safe to pass to
- * `nodeRequire` in both ts-jest CJS test mode and production ESM mode.
- *
- * @param testRelativePath - The require spec written from the calling file's
- *   perspective. Used verbatim in test mode (ts-jest CJS) where each module
- *   gets its own `require` and relative resolution Just Works. Example:
- *   `'../v3/request.service.js'`.
- * @param prodPathFromEntryDir - The require spec rewritten as a path under
- *   `path.dirname(process.argv[1])`. Used in production ESM where
- *   `nodeRequire` is anchored to the entry script. Example:
- *   `'services/v3/request.service.js'` (under `dist/backend/backend/src/`).
- * @returns A string suitable for `nodeRequire(...)`.
- *
- * @example
- * ```typescript
- * const { RequestService } = nodeRequire(
- *   resolveProjectModulePath(
- *     '../v3/request.service.js',
- *     'services/v3/request.service.js',
- *   ),
- * );
- * ```
- */
-export function resolveProjectModulePath(testRelativePath, prodPathFromEntryDir) {
-    // The same `typeof require` probe the canonical `nodeRequire` pattern uses.
-    // Under ts-jest's CJS transpile, the per-module `require` parameter is
-    // defined and is the correct anchor for relative resolution. Under
-    // production ESM, `require` is undefined globally and we must hand
-    // `nodeRequire` an absolute path.
-    if (typeof require === 'function') {
-        return testRelativePath;
-    }
-    const entryScript = process.argv[1] || process.cwd();
-    const entryDir = path.dirname(entryScript);
-    return path.join(entryDir, prodPathFromEntryDir);
-}
-//# sourceMappingURL=esm-require.utils.js.map

package/dist/backend/backend/src/utils/esm-require.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"esm-require.utils.js","sourceRoot":"","sources":["../../../../../backend/src/utils/esm-require.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,wBAAwB,CACtC,gBAAwB,EACxB,oBAA4B;IAE5B,4EAA4E;IAC5E,uEAAuE;IACvE,mEAAmE;IACnE,mEAAmE;IACnE,kCAAkC;IAClC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;AACnD,CAAC"}

package/dist/cli/backend/src/services/knowledge/embedding-provider.d.ts

@@ -1,78 +0,0 @@
-/**
- * Embedding Provider Abstraction (#155)
- *
- * Decouples embedding logic from specific APIs. Supports:
- * - Cloud: Gemini (default), OpenAI, Voyage
- * - Local: Ollama (for air-gapped/high-security environments)
- *
- * Provider selection via environment variables:
- * - GEMINI_API_KEY → GeminiEmbeddingProvider
- * - OPENAI_API_KEY → OpenAIEmbeddingProvider
- * - OLLAMA_HOST → OllamaEmbeddingProvider
- *
- * @see https://github.com/stevehuang0115/crewly/issues/155
- * @module services/knowledge/embedding-provider
- */
-/**
- * Abstract interface for embedding providers.
- * All providers must implement the embed() method.
- */
-export interface EmbeddingProvider {
-    /** Provider name for logging */
-    readonly name: string;
-    /** Embedding vector dimensions */
-    readonly dimensions: number;
-    /**
-     * Generate an embedding vector for the given text.
-     *
-     * @param text - Text to embed
-     * @returns Embedding vector, or null on failure
-     */
-    embed(text: string): Promise<number[] | null>;
-}
-/**
- * Gemini embedding provider (default cloud provider).
- */
-export declare class GeminiEmbeddingProvider implements EmbeddingProvider {
-    readonly name = "gemini";
-    readonly dimensions = 768;
-    private readonly apiKey;
-    private readonly logger;
-    constructor(apiKey: string);
-    embed(text: string): Promise<number[] | null>;
-}
-/**
- * OpenAI embedding provider.
- * Uses the text-embedding-3-small model by default.
- */
-export declare class OpenAIEmbeddingProvider implements EmbeddingProvider {
-    readonly name = "openai";
-    readonly dimensions = 1536;
-    private readonly apiKey;
-    private readonly model;
-    private readonly logger;
-    constructor(apiKey: string, model?: string);
-    embed(text: string): Promise<number[] | null>;
-}
-/**
- * Ollama local embedding provider.
- * Runs entirely on-device for air-gapped environments.
- */
-export declare class OllamaEmbeddingProvider implements EmbeddingProvider {
-    readonly name = "ollama";
-    readonly dimensions = 768;
-    private readonly host;
-    private readonly model;
-    private readonly logger;
-    constructor(host?: string, model?: string);
-    embed(text: string): Promise<number[] | null>;
-}
-/**
- * Create the best available embedding provider based on environment config.
- *
- * Priority: GEMINI_API_KEY > OPENAI_API_KEY > OLLAMA_HOST > null
- *
- * @returns EmbeddingProvider instance, or null if none configured
- */
-export declare function createEmbeddingProvider(): EmbeddingProvider | null;
-//# sourceMappingURL=embedding-provider.d.ts.map

package/dist/cli/backend/src/services/knowledge/embedding-provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/knowledge/embedding-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAChE,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,OAAO;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,MAAM;IAKpB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;CA2CnD;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAChE,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,QAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,MAAM,EAAE,KAAK,SAA2B;IAMtD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;CA0BnD;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAChE,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,OAAO;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,IAAI,SAA2B,EAAE,KAAK,SAAqB;IAMjE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;CAuBnD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,GAAG,IAAI,CAiBlE"}