import { i as OpenClawConfig } from "./types.openclaw-oSBece7v.js"; import { M as MemoryCitationsMode } from "./types.tools-DoY4arSR.js"; //#region packages/memory-host-sdk/src/host/types.d.ts type MemorySource = "memory" | "sessions"; /** One ranked memory search hit with optional vector/text scoring details. */ type MemorySearchResult = { path: string; startLine: number; endLine: number; score: number; vectorScore?: number; textScore?: number; snippet: string; source: MemorySource; citation?: string; }; /** Cached/probed embedding availability status. */ type MemoryEmbeddingProbeResult = { ok: boolean; error?: string; checked?: boolean; cached?: boolean; checkedAtMs?: number; cacheExpiresAtMs?: number; }; /** Progress event emitted during memory sync. */ type MemorySyncProgressUpdate = { completed: number; total: number; label?: string; }; /** Runtime backend/mode diagnostics for memory search. */ type MemorySearchRuntimeDebug = { backend: "builtin" | "qmd"; configuredMode?: string; effectiveMode?: string; fallback?: string; }; /** Result of reading a memory file, optionally paginated/truncated. */ type MemoryReadResult = { text: string; path: string; truncated?: boolean; from?: number; lines?: number; nextFrom?: number; }; /** Aggregated memory backend status for CLI/UI diagnostics. */ type MemoryProviderStatus = { backend: "builtin" | "qmd"; provider: string; model?: string; requestedProvider?: string; files?: number; chunks?: number; dirty?: boolean; workspaceDir?: string; dbPath?: string; extraPaths?: string[]; sources?: MemorySource[]; sourceCounts?: Array<{ source: MemorySource; files: number; chunks: number; }>; cache?: { enabled: boolean; entries?: number; maxEntries?: number; }; fts?: { enabled: boolean; available: boolean; error?: string; }; fallback?: { from: string; reason?: string; }; vector?: { enabled: boolean; storeAvailable?: boolean; semanticAvailable?: boolean; available?: boolean; extensionPath?: string; loadError?: string; dims?: number; }; batch?: { enabled: boolean; failures: number; limit: number; wait: boolean; concurrency: number; pollIntervalMs: number; timeoutMs: number; lastError?: string; lastProvider?: string; }; custom?: Record; }; /** Search/read/sync/status contract implemented by memory managers. */ interface MemorySearchManager { search(query: string, opts?: { maxResults?: number; minScore?: number; sessionKey?: string; qmdSearchModeOverride?: "query" | "search" | "vsearch"; onDebug?: (debug: MemorySearchRuntimeDebug) => void; sources?: MemorySource[]; /** Optional caller cancellation; managers consume it where their runtime supports cancellation. */ signal?: AbortSignal; }): Promise; readFile(params: { relPath: string; from?: number; lines?: number; }): Promise; status(): MemoryProviderStatus; sync?(params?: { reason?: string; force?: boolean; sessionFiles?: string[]; progress?: (update: MemorySyncProgressUpdate) => void; }): Promise; getCachedEmbeddingAvailability?(): MemoryEmbeddingProbeResult | null; probeEmbeddingAvailability(): Promise; probeVectorStoreAvailability?(): Promise; probeVectorAvailability(): Promise; close?(): Promise; } //#endregion //#region src/plugins/memory-state.d.ts type MemoryPromptSectionBuilder = (params: { availableTools: Set; citationsMode?: MemoryCitationsMode; }) => string[]; type MemoryCorpusSearchResult = { corpus: string; path: string; title?: string; kind?: string; score: number; snippet: string; id?: string; startLine?: number; endLine?: number; citation?: string; source?: string; provenanceLabel?: string; sourceType?: string; sourcePath?: string; updatedAt?: string; }; type MemoryCorpusGetResult = { corpus: string; path: string; title?: string; kind?: string; content: string; fromLine: number; lineCount: number; id?: string; provenanceLabel?: string; sourceType?: string; sourcePath?: string; updatedAt?: string; }; type MemoryCorpusSupplement = { search(params: { query: string; maxResults?: number; agentSessionKey?: string; }): Promise; get(params: { lookup: string; fromLine?: number; lineCount?: number; agentSessionKey?: string; }): Promise; }; type MemoryCorpusSupplementRegistration = { pluginId: string; supplement: MemoryCorpusSupplement; }; type MemoryPromptSupplementRegistration = { pluginId: string; builder: MemoryPromptSectionBuilder; }; type MemoryFlushPlan = { softThresholdTokens: number; forceFlushTranscriptBytes: number; reserveTokensFloor: number; model?: string; prompt: string; systemPrompt: string; relativePath: string; }; type MemoryFlushPlanResolver = (params: { cfg?: OpenClawConfig; nowMs?: number; }) => MemoryFlushPlan | null; type RegisteredMemorySearchManager = MemorySearchManager; type MemoryRuntimeQmdConfig = { command?: string; }; type MemoryRuntimeBackendConfig = { backend: "builtin"; } | { backend: "qmd"; qmd?: MemoryRuntimeQmdConfig; }; type MemoryPluginRuntime = { getMemorySearchManager(params: { cfg: OpenClawConfig; agentId: string; purpose?: "default" | "status" | "cli"; }): Promise<{ manager: RegisteredMemorySearchManager | null; error?: string; }>; resolveMemoryBackendConfig(params: { cfg: OpenClawConfig; agentId: string; }): MemoryRuntimeBackendConfig; closeMemorySearchManager?(params: { cfg: OpenClawConfig; agentId: string; }): Promise; closeAllMemorySearchManagers?(): Promise; }; type MemoryPluginPublicArtifactContentType = "markdown" | "json" | "text"; type MemoryPluginPublicArtifact = { kind: string; workspaceDir: string; relativePath: string; absolutePath: string; agentIds: string[]; contentType: MemoryPluginPublicArtifactContentType; }; type MemoryPluginPublicArtifactsProvider = { listArtifacts(params: { cfg: OpenClawConfig; }): Promise; }; type MemoryPluginCapability = { promptBuilder?: MemoryPromptSectionBuilder; flushPlanResolver?: MemoryFlushPlanResolver; runtime?: MemoryPluginRuntime; publicArtifacts?: MemoryPluginPublicArtifactsProvider; }; type MemoryPluginCapabilityRegistration = { pluginId: string; capability: MemoryPluginCapability; }; type MemoryPluginState = { capability?: MemoryPluginCapabilityRegistration; corpusSupplements: MemoryCorpusSupplementRegistration[]; promptSupplements: MemoryPromptSupplementRegistration[]; }; declare function registerMemoryCorpusSupplement(pluginId: string, supplement: MemoryCorpusSupplement): void; declare function registerMemoryCapability(pluginId: string, capability: MemoryPluginCapability): void; declare function getMemoryCapabilityRegistration(): MemoryPluginCapabilityRegistration | undefined; declare function listMemoryCorpusSupplements(): MemoryCorpusSupplementRegistration[]; /** @deprecated Use registerMemoryCapability(pluginId, { promptBuilder }) instead. */ declare function registerMemoryPromptSection(builder: MemoryPromptSectionBuilder): void; declare function registerMemoryPromptSectionForPlugin(pluginId: string, builder: MemoryPromptSectionBuilder): void; declare function registerMemoryPromptSupplement(pluginId: string, builder: MemoryPromptSectionBuilder): void; declare function buildMemoryPromptSection(params: { availableTools: Set; citationsMode?: MemoryCitationsMode; }): string[]; declare function listMemoryPromptSupplements(): MemoryPromptSupplementRegistration[]; /** @deprecated Use registerMemoryCapability(pluginId, { flushPlanResolver }) instead. */ declare function registerMemoryFlushPlanResolver(resolver: MemoryFlushPlanResolver): void; declare function registerMemoryFlushPlanResolverForPlugin(pluginId: string, resolver: MemoryFlushPlanResolver): void; declare function resolveMemoryFlushPlan(params: { cfg?: OpenClawConfig; nowMs?: number; }): MemoryFlushPlan | null; /** @deprecated Use registerMemoryCapability(pluginId, { runtime }) instead. */ declare function registerMemoryRuntime(runtime: MemoryPluginRuntime): void; declare function registerMemoryRuntimeForPlugin(pluginId: string, runtime: MemoryPluginRuntime): void; declare function getMemoryRuntime(): MemoryPluginRuntime | undefined; declare function hasMemoryRuntime(): boolean; declare function listActiveMemoryPublicArtifacts(params: { cfg: OpenClawConfig; }): Promise; declare function restoreMemoryPluginState(state: MemoryPluginState): void; declare function clearMemoryPluginState(): void; //#endregion export { registerMemoryPromptSection as A, MemorySearchResult as B, listActiveMemoryPublicArtifacts as C, registerMemoryCorpusSupplement as D, registerMemoryCapability as E, resolveMemoryFlushPlan as F, MemorySyncProgressUpdate as H, restoreMemoryPluginState as I, MemoryProviderStatus as L, registerMemoryPromptSupplement as M, registerMemoryRuntime as N, registerMemoryFlushPlanResolver as O, registerMemoryRuntimeForPlugin as P, MemoryReadResult as R, hasMemoryRuntime as S, listMemoryPromptSupplements as T, MemorySearchRuntimeDebug as V, RegisteredMemorySearchManager as _, MemoryFlushPlan as a, getMemoryCapabilityRegistration as b, MemoryPluginCapabilityRegistration as c, MemoryPluginPublicArtifactsProvider as d, MemoryPluginRuntime as f, MemoryRuntimeQmdConfig as g, MemoryRuntimeBackendConfig as h, MemoryCorpusSupplementRegistration as i, registerMemoryPromptSectionForPlugin as j, registerMemoryFlushPlanResolverForPlugin as k, MemoryPluginPublicArtifact as l, MemoryPromptSupplementRegistration as m, MemoryCorpusSearchResult as n, MemoryFlushPlanResolver as o, MemoryPromptSectionBuilder as p, MemoryCorpusSupplement as r, MemoryPluginCapability as s, MemoryCorpusGetResult as t, MemoryPluginPublicArtifactContentType as u, buildMemoryPromptSection as v, listMemoryCorpusSupplements as w, getMemoryRuntime as x, clearMemoryPluginState as y, MemorySearchManager as z };