@lacneu/openclaw-knowledge 3.1.2 → 3.2.1

package/dist/index.d.ts

@@ -1,10 +1,12 @@
 import type { OpenClawPluginApi, PluginLogger } from "openclaw/plugin-sdk/plugin-entry";
-import type { BeforePromptBuildEvent, BeforePromptBuildResult, PgPoolLike, ResolvedKnowledgeConfig } from "./types.js";
+import type { Route } from "./router/types.js";
+import type { BeforePromptBuildEvent, BeforePromptBuildResult, PgPoolLike, PluginHookAgentContext, PromptMessage, ResolvedKnowledgeConfig } from "./types.js";
 export { resolveEnv, resolveConfig } from "./config.js";
 export { embedQuery } from "./embeddings.js";
-export { searchCollection, formatPgvectorResults } from "./pgvector.js";
+export { searchCollection, formatPgvectorResults, rerankPgvectorResults, } from "./pgvector.js";
 export { queryLightRAG, truncateLightRAG, formatLightRAGResults } from "./lightrag.js";
-export type { BeforePromptBuildEvent, BeforePromptBuildResult, KnowledgePluginConfig, LightRAGQueryMode, PgPoolLike, PgvectorResult, PgvectorRow, PromptContentPart, PromptMessage, ResolvedKnowledgeConfig, } from "./types.js";
+export { decideRoute } from "./router/index.js";
+export type { BeforePromptBuildEvent, BeforePromptBuildResult, JinaPluginConfig, KnowledgePluginConfig, LightRAGQueryMode, PgPoolLike, PgvectorResult, PgvectorRerankerPluginConfig, PgvectorRow, PluginHookAgentContext, PromptContentPart, PromptMessage, ResolvedKnowledgeConfig, RouterPluginConfig, } from "./types.js";
 interface HookHandlerDeps {
     config: ResolvedKnowledgeConfig;
     pool: PgPoolLike | null;
@@ -14,7 +16,62 @@ interface HookHandlerDeps {
  * Build the `before_prompt_build` handler bound to a specific plugin state.
  * Kept as a pure factory so the handler can be unit-tested with fake deps.
  */
-export declare function createBeforePromptBuildHandler(deps: HookHandlerDeps): (event: BeforePromptBuildEvent) => Promise<BeforePromptBuildResult | undefined>;
+export declare function createBeforePromptBuildHandler(deps: HookHandlerDeps): (event: BeforePromptBuildEvent, ctx?: PluginHookAgentContext) => Promise<BeforePromptBuildResult | undefined>;
+/**
+ * Project a router decision onto the set of sources that are actually
+ * enabled in this deployment. This prevents "silent empty retrieval"
+ * when, for example, a pgvector-only deployment is told to use
+ * `LIGHTRAG_ONLY` for a multi-hop question — without this projection the
+ * task list would be empty and the agent would lose context that
+ * pgvector could have provided.
+ *
+ * Rules:
+ *   - `NONE` → `NONE` (the router deliberately wants no retrieval).
+ *   - `ALL` → `ALL` (downstream `shouldUseX` already skips disabled sources).
+ *   - `PGVECTOR_ONLY` + pgvector disabled:
+ *       - LightRAG available → `LIGHTRAG_ONLY` (best effort)
+ *       - neither available → `NONE` (caller short-circuits)
+ *   - `LIGHTRAG_ONLY` + LightRAG disabled: symmetric.
+ *
+ * Exported for unit testing.
+ */
+export declare function projectRouteOnEnabledSources(route: Route, pgvectorEnabled: boolean, lightragEnabled: boolean): Route;
+/**
+ * Strip the OpenClaw envelope (inbound-context blocks + timestamp
+ * marker) from the START of a raw user prompt and return only the user
+ * utterance. When no envelope is matched, the prompt is returned
+ * unchanged — the router then sees the full user content, which is the
+ * correct behavior for non-OpenClaw inputs.
+ *
+ * @internal exported for unit testing
+ */
+export declare function stripOpenClawHeaders(prompt: string): string;
+/**
+ * Extract the user question from a `before_prompt_build` event.
+ *
+ * - When `event.prompt` is supplied (SDK 2026.5.0+), it is the
+ *   authoritative source for the raw user utterance: this function
+ *   strips the OpenClaw envelope and returns the result, even when the
+ *   result is empty. `event.messages` is NOT consulted in this case
+ *   because it carries the aggregated conversation window (multi-KB
+ *   blob optimized for LLM consumption, not for plugin inspection).
+ * - When `event.prompt` is absent (older SDK), fall back to
+ *   `extractQueryFromMessages(event.messages)`.
+ *
+ * The downstream `MIN_QUERY_LENGTH` check drops empty or near-empty
+ * results, so silently returning `""` from the `prompt` path is safe.
+ *
+ * @internal exported for unit testing
+ */
+export declare function extractUserQuery(event: BeforePromptBuildEvent): string;
+/**
+ * Legacy extraction from `event.messages`, used only when the SDK does
+ * not populate `event.prompt`. On 2026.5.x+ the primary path is
+ * {@link extractUserQuery}.
+ *
+ * @internal exported for unit testing and backward compatibility
+ */
+export declare function extractQueryFromMessages(messages: PromptMessage[] | undefined): string;
 /**
  * Register the plugin against a minimal shape-compatible subset of the
  * OpenClaw plugin API. Returns nothing; side effects are setting a hook and