@knowledgine/core 0.2.1 → 0.3.0

package/dist/llm/openai-provider.js

@@ -0,0 +1,143 @@
+import { LLMProviderError } from "./errors.js";
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_TIMEOUT_MS = 30000;
+const DEFAULT_RETRY_DELAY_MS = 500;
+export class OpenAICompatibleProvider {
+    baseUrl;
+    model;
+    apiKey;
+    maxRetries;
+    timeoutMs;
+    retryDelayMs;
+    constructor(config) {
+        this.baseUrl = config.baseUrl;
+        this.model = config.model;
+        this.apiKey = config.apiKey ?? process.env["KNOWLEDGINE_LLM_API_KEY"];
+        this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.retryDelayMs = config.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+    }
+    getModelName() {
+        return this.model;
+    }
+    async isAvailable() {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+            try {
+                const res = await fetch(`${this.baseUrl}/v1/chat/completions`, {
+                    method: "POST",
+                    headers: this.buildHeaders(),
+                    body: JSON.stringify({
+                        model: this.model,
+                        messages: [{ role: "user", content: "ping" }],
+                        max_tokens: 1,
+                    }),
+                    signal: controller.signal,
+                });
+                return res.status === 200;
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+    async complete(options) {
+        const timeoutMs = options.timeoutMs ?? this.timeoutMs;
+        const startTime = Date.now();
+        const body = {
+            model: this.model,
+            messages: options.messages,
+            temperature: options.temperature ?? 0.0,
+            max_tokens: options.maxTokens ?? 1024,
+        };
+        if (options.responseFormat === "json") {
+            body.response_format = { type: "json_object" };
+        }
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            if (attempt > 0) {
+                const delay = this.retryDelayMs * Math.pow(2, attempt - 1);
+                await sleep(delay);
+            }
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                const res = await fetch(`${this.baseUrl}/v1/chat/completions`, {
+                    method: "POST",
+                    headers: this.buildHeaders(),
+                    body: JSON.stringify(body),
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (res.status === 404) {
+                    throw new LLMProviderError(`Model not found: ${this.model}`, "model_not_found", {
+                        status: 404,
+                    });
+                }
+                if (res.status === 401) {
+                    throw new LLMProviderError("Unauthorized: invalid API key", "auth", { status: 401 });
+                }
+                if (res.status === 429 || res.status >= 500) {
+                    lastError = new LLMProviderError(`OpenAI request failed with status ${res.status}`, res.status === 429 ? "rate_limit" : "network", { status: res.status });
+                    continue; // retry
+                }
+                if (!res.ok) {
+                    throw new LLMProviderError(`OpenAI request failed with status ${res.status}`, "network", {
+                        status: res.status,
+                    });
+                }
+                const data = (await res.json());
+                const latencyMs = Date.now() - startTime;
+                return {
+                    content: data.choices[0].message.content,
+                    model: data.model,
+                    usage: data.usage
+                        ? {
+                            promptTokens: data.usage.prompt_tokens,
+                            completionTokens: data.usage.completion_tokens,
+                        }
+                        : undefined,
+                    latencyMs,
+                };
+            }
+            catch (err) {
+                clearTimeout(timeoutId);
+                if (err instanceof LLMProviderError) {
+                    if (err.errorCode === "model_not_found" || err.errorCode === "auth") {
+                        throw err;
+                    }
+                    lastError = err;
+                    continue;
+                }
+                if (isAbortError(err)) {
+                    throw new LLMProviderError(`OpenAI request timed out after ${timeoutMs}ms`, "timeout", {
+                        timeoutMs,
+                    });
+                }
+                lastError = new LLMProviderError(`OpenAI network error: ${err instanceof Error ? err.message : String(err)}`, "network", { cause: err });
+                continue;
+            }
+        }
+        throw lastError ?? new LLMProviderError("OpenAI request failed after retries", "network");
+    }
+    buildHeaders() {
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        return headers;
+    }
+}
+function isAbortError(err) {
+    return err instanceof DOMException && err.name === "AbortError";
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=openai-provider.js.map

package/dist/llm/openai-provider.js.map

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

package/dist/llm/provider-factory.d.ts

@@ -0,0 +1,3 @@
+import type { LLMConfig, LLMProvider } from "./types.js";
+export declare function createLLMProvider(config: LLMConfig | undefined): LLMProvider | undefined;
+//# sourceMappingURL=provider-factory.d.ts.map

package/dist/llm/provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.d.ts","sourceRoot":"","sources":["../../src/llm/provider-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIzD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAqBxF"}

package/dist/llm/provider-factory.js

@@ -0,0 +1,25 @@
+import { OllamaProvider } from "./ollama-provider.js";
+import { OpenAICompatibleProvider } from "./openai-provider.js";
+export function createLLMProvider(config) {
+    if (!config)
+        return undefined;
+    switch (config.provider) {
+        case "ollama": {
+            const ollamaConfig = config.ollama ?? {
+                model: config.model ?? "llama3",
+                baseUrl: config.baseUrl,
+            };
+            return new OllamaProvider(ollamaConfig);
+        }
+        case "openai": {
+            const openaiConfig = config.openai ?? {
+                model: config.model ?? "gpt-4o",
+                baseUrl: config.baseUrl ?? "https://api.openai.com",
+            };
+            return new OpenAICompatibleProvider(openaiConfig);
+        }
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=provider-factory.js.map

package/dist/llm/provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.js","sourceRoot":"","sources":["../../src/llm/provider-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,UAAU,iBAAiB,CAAC,MAA6B;IAC7D,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAE9B,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,IAAI;gBACpC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,QAAQ;gBAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC;YACF,OAAO,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,IAAI;gBACpC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,QAAQ;gBAC/B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,wBAAwB;aACpD,CAAC;YACF,OAAO,IAAI,wBAAwB,CAAC,YAAY,CAAC,CAAC;QACpD,CAAC;QACD;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/llm/types.d.ts

@@ -0,0 +1,50 @@
+export interface LLMCompletionMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export interface LLMCompletionOptions {
+    messages: LLMCompletionMessage[];
+    temperature?: number;
+    maxTokens?: number;
+    responseFormat?: "text" | "json";
+    timeoutMs?: number;
+}
+export interface LLMCompletionResult {
+    content: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+    };
+    model: string;
+    latencyMs: number;
+}
+export interface LLMProvider {
+    complete(options: LLMCompletionOptions): Promise<LLMCompletionResult>;
+    isAvailable(): Promise<boolean>;
+    getModelName(): string;
+}
+export interface OllamaProviderConfig {
+    baseUrl?: string;
+    model: string;
+    maxRetries?: number;
+    timeoutMs?: number;
+    retryDelayMs?: number;
+}
+export interface OpenAIProviderConfig {
+    baseUrl: string;
+    model: string;
+    apiKey?: string;
+    maxRetries?: number;
+    timeoutMs?: number;
+    retryDelayMs?: number;
+    rateLimitRPM?: number;
+}
+export type LLMProviderType = "ollama" | "openai";
+export interface LLMConfig {
+    provider: LLMProviderType;
+    model?: string;
+    baseUrl?: string;
+    ollama?: OllamaProviderConfig;
+    openai?: OpenAIProviderConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/llm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B"}

package/dist/llm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":""}

package/dist/provenance/provenance-repository.d.ts

@@ -1,47 +1,48 @@
 import type Database from "better-sqlite3";
 export interface ProvenanceRecord {
-    id: number;
+    id: string;
     entityUri: string;
     activityType: "ingest" | "extract" | "link" | "embed";
-    agent: string;
-    inputUris: string[];
-    outputUris: string[];
-    startedAt: string;
-    endedAt?: string;
+    agent?: string;
+    sourceUri?: string;
+    generatedAt: string;
     metadata?: Record<string, unknown>;
+}
+export interface ProvenanceLink {
+    id: string;
+    fromEntityUri: string;
+    toEntityUri: string;
+    relation: string;
     createdAt: string;
 }
 export interface FileTimelineEntry {
-    id: number;
     filePath: string;
-    eventType: "created" | "modified" | "deleted" | "renamed";
-    eventId?: number;
-    occurredAt: string;
-    metadata?: Record<string, unknown>;
+    eventId: string;
+    changedAt: string;
+    changeType: "created" | "modified" | "deleted" | "renamed";
 }
 export interface Snapshot {
-    id: number;
+    id: string;
     snapshotAt: string;
-    noteCount: number;
-    eventCount: number;
-    entityCount: number;
+    entityCount?: number;
+    eventCount?: number;
     metadata?: Record<string, unknown>;
-    createdAt: string;
 }
 export declare class ProvenanceRepository {
     private db;
     constructor(db: Database.Database);
-    record(entry: Omit<ProvenanceRecord, "id" | "createdAt">): number;
+    record(entry: Omit<ProvenanceRecord, "id">): string;
     getByEntityUri(uri: string): ProvenanceRecord[];
     getByAgent(agent: string, limit?: number): ProvenanceRecord[];
     getByActivity(type: ProvenanceRecord["activityType"], limit?: number): ProvenanceRecord[];
-    recordFileEvent(filePath: string, eventType: FileTimelineEntry["eventType"], eventId?: number, occurredAt?: string): number;
+    createLink(fromEntityUri: string, toEntityUri: string, relation: string, createdAt?: string): string;
+    findLinks(fromEntityUri?: string, toEntityUri?: string): ProvenanceLink[];
+    recordFileEvent(filePath: string, changeType: FileTimelineEntry["changeType"], eventId?: string, changedAt?: string): void;
     getFileTimeline(filePath: string): FileTimelineEntry[];
     createSnapshot(snapshotAt: string, stats: {
-        noteCount: number;
-        eventCount: number;
-        entityCount: number;
-    }): number;
+        entityCount?: number;
+        eventCount?: number;
+    }, metadata?: Record<string, unknown>): string;
     getSnapshots(limit?: number): Snapshot[];
 }
 //# sourceMappingURL=provenance-repository.d.ts.map

package/dist/provenance/provenance-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provenance-repository.d.ts","sourceRoot":"","sources":["../../src/provenance/provenance-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AA8ED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIzC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,MAAM;IAsBjE,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAO/C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,gBAAgB,EAAE;IAO1D,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC,cAAc,CAAC,EAAE,KAAK,SAAM,GAAG,gBAAgB,EAAE;IAStF,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,iBAAiB,CAAC,WAAW,CAAC,EACzC,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM;IAaT,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAStD,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GACpE,MAAM;IAaT,YAAY,CAAC,KAAK,SAAM,GAAG,QAAQ,EAAE;CAMtC"}
+{"version":3,"file":"provenance-repository.d.ts","sourceRoot":"","sources":["../../src/provenance/provenance-repository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;CAC5D;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AA4ED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIzC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,GAAG,MAAM;IAsBnD,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAO/C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,gBAAgB,EAAE;IAO1D,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC,cAAc,CAAC,EAAE,KAAK,SAAM,GAAG,gBAAgB,EAAE;IAWtF,UAAU,CACR,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM;IAgBT,SAAS,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;IA8BzE,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,iBAAiB,CAAC,YAAY,CAAC,EAC3C,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAcP,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAStD,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EACpD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM;IAqBT,YAAY,CAAC,KAAK,SAAM,GAAG,QAAQ,EAAE;CAMtC"}

package/dist/provenance/provenance-repository.js

@@ -1,43 +1,40 @@
+import { randomUUID } from "node:crypto";
 import { DatabaseError } from "../errors.js";
 function rowToProvenance(row) {
     return {
         id: row.id,
         entityUri: row.entity_uri,
         activityType: row.activity_type,
-        agent: row.agent,
-        inputUris: JSON.parse(row.input_uris),
-        outputUris: JSON.parse(row.output_uris),
-        startedAt: row.started_at,
-        endedAt: row.ended_at ?? undefined,
-        metadata: row.metadata_json
-            ? JSON.parse(row.metadata_json)
-            : undefined,
+        agent: row.agent ?? undefined,
+        sourceUri: row.source_uri ?? undefined,
+        generatedAt: row.generated_at,
+        metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+    };
+}
+function rowToProvenanceLink(row) {
+    return {
+        id: row.id,
+        fromEntityUri: row.from_entity_uri,
+        toEntityUri: row.to_entity_uri,
+        relation: row.relation,
         createdAt: row.created_at,
     };
 }
 function rowToFileTimeline(row) {
     return {
-        id: row.id,
         filePath: row.file_path,
-        eventType: row.event_type,
-        eventId: row.event_id ?? undefined,
-        occurredAt: row.occurred_at,
-        metadata: row.metadata_json
-            ? JSON.parse(row.metadata_json)
-            : undefined,
+        eventId: row.event_id,
+        changedAt: row.changed_at,
+        changeType: row.change_type,
     };
 }
 function rowToSnapshot(row) {
     return {
         id: row.id,
         snapshotAt: row.snapshot_at,
-        noteCount: row.note_count,
-        eventCount: row.event_count,
-        entityCount: row.entity_count,
-        metadata: row.metadata_json
-            ? JSON.parse(row.metadata_json)
-            : undefined,
-        createdAt: row.created_at,
+        entityCount: row.entity_count ?? undefined,
+        eventCount: row.event_count ?? undefined,
+        metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
     };
 }
 export class ProvenanceRepository {
@@ -48,12 +45,13 @@ export class ProvenanceRepository {
     // ── 来歴記録 ────────────────────────────────────────────────────
     record(entry) {
         try {
+            const id = randomUUID();
             const stmt = this.db.prepare(`
-        INSERT INTO provenance (entity_uri, activity_type, agent, input_uris, output_uris, started_at, ended_at, metadata_json)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+        INSERT INTO provenance (id, entity_uri, activity_type, agent, source_uri, generated_at, metadata)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
       `);
-            const info = stmt.run(entry.entityUri, entry.activityType, entry.agent, JSON.stringify(entry.inputUris ?? []), JSON.stringify(entry.outputUris ?? []), entry.startedAt, entry.endedAt ?? null, entry.metadata ? JSON.stringify(entry.metadata) : null);
-            return Number(info.lastInsertRowid);
+            stmt.run(id, entry.entityUri, entry.activityType, entry.agent ?? null, entry.sourceUri ?? null, entry.generatedAt, entry.metadata ? JSON.stringify(entry.metadata) : null);
+            return id;
         }
         catch (error) {
             throw new DatabaseError("provenance.record", error, { entityUri: entry.entityUri });
@@ -61,31 +59,71 @@ export class ProvenanceRepository {
     }
     getByEntityUri(uri) {
         const rows = this.db
-            .prepare("SELECT * FROM provenance WHERE entity_uri = ? ORDER BY started_at DESC")
+            .prepare("SELECT * FROM provenance WHERE entity_uri = ? ORDER BY generated_at DESC")
             .all(uri);
         return rows.map(rowToProvenance);
     }
     getByAgent(agent, limit = 100) {
         const rows = this.db
-            .prepare("SELECT * FROM provenance WHERE agent = ? ORDER BY started_at DESC LIMIT ?")
+            .prepare("SELECT * FROM provenance WHERE agent = ? ORDER BY generated_at DESC LIMIT ?")
             .all(agent, limit);
         return rows.map(rowToProvenance);
     }
     getByActivity(type, limit = 100) {
         const rows = this.db
-            .prepare("SELECT * FROM provenance WHERE activity_type = ? ORDER BY started_at DESC LIMIT ?")
+            .prepare("SELECT * FROM provenance WHERE activity_type = ? ORDER BY generated_at DESC LIMIT ?")
             .all(type, limit);
         return rows.map(rowToProvenance);
     }
+    // ── プロベナンスリンク ─────────────────────────────────────────
+    createLink(fromEntityUri, toEntityUri, relation, createdAt) {
+        try {
+            const id = randomUUID();
+            const now = createdAt ?? new Date().toISOString();
+            this.db
+                .prepare(`INSERT INTO provenance_links (id, from_entity_uri, to_entity_uri, relation, created_at)
+           VALUES (?, ?, ?, ?, ?)`)
+                .run(id, fromEntityUri, toEntityUri, relation, now);
+            return id;
+        }
+        catch (error) {
+            throw new DatabaseError("provenance.createLink", error, { fromEntityUri, toEntityUri });
+        }
+    }
+    findLinks(fromEntityUri, toEntityUri) {
+        if (fromEntityUri && toEntityUri) {
+            const rows = this.db
+                .prepare("SELECT * FROM provenance_links WHERE from_entity_uri = ? AND to_entity_uri = ? ORDER BY created_at DESC")
+                .all(fromEntityUri, toEntityUri);
+            return rows.map(rowToProvenanceLink);
+        }
+        else if (fromEntityUri) {
+            const rows = this.db
+                .prepare("SELECT * FROM provenance_links WHERE from_entity_uri = ? ORDER BY created_at DESC")
+                .all(fromEntityUri);
+            return rows.map(rowToProvenanceLink);
+        }
+        else if (toEntityUri) {
+            const rows = this.db
+                .prepare("SELECT * FROM provenance_links WHERE to_entity_uri = ? ORDER BY created_at DESC")
+                .all(toEntityUri);
+            return rows.map(rowToProvenanceLink);
+        }
+        else {
+            const rows = this.db
+                .prepare("SELECT * FROM provenance_links ORDER BY created_at DESC")
+                .all();
+            return rows.map(rowToProvenanceLink);
+        }
+    }
     // ── ファイルタイムライン ──────────────────────────────────────────
-    recordFileEvent(filePath, eventType, eventId, occurredAt) {
+    recordFileEvent(filePath, changeType, eventId, changedAt) {
         try {
-            const stmt = this.db.prepare(`
-        INSERT INTO file_timeline (file_path, event_type, event_id, occurred_at)
-        VALUES (?, ?, ?, COALESCE(?, datetime('now')))
-      `);
-            const info = stmt.run(filePath, eventType, eventId ?? null, occurredAt ?? null);
-            return Number(info.lastInsertRowid);
+            const now = changedAt ?? new Date().toISOString();
+            this.db
+                .prepare(`INSERT INTO file_timeline (file_path, event_id, changed_at, change_type)
+           VALUES (?, ?, ?, ?)`)
+                .run(filePath, eventId ?? "", now, changeType);
         }
         catch (error) {
             throw new DatabaseError("provenance.recordFileEvent", error, { filePath });
@@ -93,19 +131,19 @@ export class ProvenanceRepository {
     }
     getFileTimeline(filePath) {
         const rows = this.db
-            .prepare("SELECT * FROM file_timeline WHERE file_path = ? ORDER BY occurred_at ASC")
+            .prepare("SELECT * FROM file_timeline WHERE file_path = ? ORDER BY changed_at ASC")
             .all(filePath);
         return rows.map(rowToFileTimeline);
     }
     // ── スナップショット ─────────────────────────────────────────────
-    createSnapshot(snapshotAt, stats) {
+    createSnapshot(snapshotAt, stats, metadata) {
         try {
-            const stmt = this.db.prepare(`
-        INSERT INTO snapshots (snapshot_at, note_count, event_count, entity_count)
-        VALUES (?, ?, ?, ?)
-      `);
-            const info = stmt.run(snapshotAt, stats.noteCount, stats.eventCount, stats.entityCount);
-            return Number(info.lastInsertRowid);
+            const id = randomUUID();
+            this.db
+                .prepare(`INSERT INTO snapshots (id, snapshot_at, entity_count, event_count, metadata)
+           VALUES (?, ?, ?, ?, ?)`)
+                .run(id, snapshotAt, stats.entityCount ?? null, stats.eventCount ?? null, metadata ? JSON.stringify(metadata) : null);
+            return id;
         }
         catch (error) {
             throw new DatabaseError("provenance.createSnapshot", error, { snapshotAt });

package/dist/provenance/provenance-repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"provenance-repository.js","sourceRoot":"","sources":["../../src/provenance/provenance-repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAkE7C,SAAS,eAAe,CAAC,GAAkB;IACzC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,YAAY,EAAE,GAAG,CAAC,aAAiD;QACnE,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAa;QACjD,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAa;QACnD,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,OAAO,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;QAClC,QAAQ,EAAE,GAAG,CAAC,aAAa;YACzB,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAA6B;YAC5D,CAAC,CAAC,SAAS;QACb,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAoB;IAC7C,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,SAAS,EAAE,GAAG,CAAC,UAA4C;QAC3D,OAAO,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;QAClC,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,QAAQ,EAAE,GAAG,CAAC,aAAa;YACzB,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAA6B;YAC5D,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,GAAgB;IACrC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,QAAQ,EAAE,GAAG,CAAC,aAAa;YACzB,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAA6B;YAC5D,CAAC,CAAC,SAAS;QACb,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,oBAAoB;IACX;IAApB,YAAoB,EAAqB;QAArB,OAAE,GAAF,EAAE,CAAmB;IAAG,CAAC;IAE7C,+DAA+D;IAE/D,MAAM,CAAC,KAAiD;QACtD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;OAG5B,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CACnB,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,KAAK,EACX,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,EACrC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,EACtC,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,OAAO,IAAI,IAAI,EACrB,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CACvD,CAAC;YACF,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,aAAa,CAAC,mBAAmB,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,cAAc,CAAC,GAAW;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,wEAAwE,CAAC;aACjF,GAAG,CAAC,GAAG,CAAoB,CAAC;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,KAAK,GAAG,GAAG;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,2EAA2E,CAAC;aACpF,GAAG,CAAC,KAAK,EAAE,KAAK,CAAoB,CAAC;QACxC,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,aAAa,CAAC,IAAsC,EAAE,KAAK,GAAG,GAAG;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,mFAAmF,CAAC;aAC5F,GAAG,CAAC,IAAI,EAAE,KAAK,CAAoB,CAAC;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,2DAA2D;IAE3D,eAAe,CACb,QAAgB,EAChB,SAAyC,EACzC,OAAgB,EAChB,UAAmB;QAEnB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;OAG5B,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,IAAI,IAAI,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC;YAChF,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,aAAa,CAAC,4BAA4B,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,eAAe,CAAC,QAAgB;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,0EAA0E,CAAC;aACnF,GAAG,CAAC,QAAQ,CAAsB,CAAC;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,4DAA4D;IAE5D,cAAc,CACZ,UAAkB,EAClB,KAAqE;QAErE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;OAG5B,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;YACxF,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,aAAa,CAAC,2BAA2B,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,YAAY,CAAC,KAAK,GAAG,GAAG;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,2DAA2D,CAAC;aACpE,GAAG,CAAC,KAAK,CAAkB,CAAC;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;CACF"}
+{"version":3,"file":"provenance-repository.js","sourceRoot":"","sources":["../../src/provenance/provenance-repository.ts"],"names":[],"mappings":"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"}

package/dist/search/knowledge-searcher.d.ts

@@ -1,5 +1,7 @@
 import type { KnowledgeRepository, KnowledgeNote } from "../storage/knowledge-repository.js";
 import type { EmbeddingProvider } from "../embedding/embedding-provider.js";
+import type { LLMProvider } from "../llm/types.js";
+import type { RerankerWeights } from "./reasoning-reranker.js";
 export interface SearchOptions {
     query?: string;
     tags?: string[];
@@ -7,17 +9,24 @@ export interface SearchOptions {
     dateTo?: string;
     limit?: number;
     mode?: "keyword" | "semantic" | "hybrid";
+    rerank?: boolean;
+    rerankWeights?: RerankerWeights;
+    includeDeprecated?: boolean;
+    agentic?: boolean;
 }
 export interface SearchResult {
     note: KnowledgeNote;
     score: number;
     matchReason: string[];
+    fellBack?: boolean;
 }
 export declare class KnowledgeSearcher {
     private repository;
     private semanticSearcher?;
     private hybridSearcher?;
-    constructor(repository: KnowledgeRepository, embeddingProvider?: EmbeddingProvider, hybridAlpha?: number);
+    private reranker;
+    private agenticReranker;
+    constructor(repository: KnowledgeRepository, embeddingProvider?: EmbeddingProvider, hybridAlpha?: number, llmProvider?: LLMProvider);
     search(options: SearchOptions): Promise<SearchResult[]>;
     searchByTag(tag: string, limit?: number): Promise<SearchResult[]>;
     searchRecent(days?: number, limit?: number): Promise<SearchResult[]>;

package/dist/search/knowledge-searcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-searcher.d.ts","sourceRoot":"","sources":["../../src/search/knowledge-searcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAI5E,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC1C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,UAAU;IAJpB,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAG9B,UAAU,EAAE,mBAAmB,EACvC,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,WAAW,GAAE,MAAY;IAQrB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmDvD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI7D,YAAY,CAAC,IAAI,SAAI,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAYjE,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG;QACvC,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB;CAWF"}
+{"version":3,"file":"knowledge-searcher.d.ts","sourceRoot":"","sources":["../../src/search/knowledge-searcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,iBAAiB;IAO1B,OAAO,CAAC,UAAU;IANpB,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,eAAe,CAAoB;gBAGjC,UAAU,EAAE,mBAAmB,EACvC,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,WAAW,GAAE,MAAY,EACzB,WAAW,CAAC,EAAE,WAAW;IAUrB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAwGvD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI7D,YAAY,CAAC,IAAI,SAAI,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAYjE,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG;QACvC,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB;CAWF"}