@memtensor/memos-local-openclaw-plugin 1.0.3 → 1.0.4-beta.1

package/src/tools/index.ts

@@ -1,3 +1,4 @@
 export { createMemorySearchTool } from "./memory-search";
 export { createMemoryTimelineTool } from "./memory-timeline";
 export { createMemoryGetTool } from "./memory-get";
+export { createNetworkMemoryDetailTool } from "./network-memory-detail";

package/src/tools/memory-search.ts

@@ -1,12 +1,30 @@
+import { hubSearchMemories } from "../client/hub";
+import type { HubScope, HubSearchResult } from "../sharing/types";
 import type { RecallEngine } from "../recall/engine";
-import type { ToolDefinition } from "../types";
+import type { PluginContext, ToolDefinition } from "../types";
+import type { SqliteStore } from "../storage/sqlite";
 
 function resolveOwnerFilter(owner: unknown): string[] {
   const resolvedOwner = typeof owner === "string" && owner.trim().length > 0 ? owner : "agent:main";
   return resolvedOwner === "public" ? ["public"] : [resolvedOwner, "public"];
 }
 
-export function createMemorySearchTool(engine: RecallEngine): ToolDefinition {
+function resolveScope(scope: unknown): HubScope {
+  return scope === "group" || scope === "all" ? scope : "local";
+}
+
+function emptyHubResult(scope: HubScope): HubSearchResult {
+  return {
+    hits: [],
+    meta: {
+      totalCandidates: 0,
+      searchedGroups: [],
+      includedPublic: scope === "all",
+    },
+  };
+}
+
+export function createMemorySearchTool(engine: RecallEngine, store?: SqliteStore, ctx?: PluginContext): ToolDefinition {
   return {
     name: "memory_search",
     description:
@@ -27,16 +45,47 @@ export function createMemorySearchTool(engine: RecallEngine): ToolDefinition {
           type: "number",
           description: "Minimum relevance score threshold 0-1 (default 0.45, floor 0.35).",
         },
+        scope: {
+          type: "string",
+          description: "Search scope: local (default), group, or all. Group/all return split local and hub sections.",
+        },
+        hubAddress: {
+          type: "string",
+          description: "Optional hub address override for group/all search, integration tests, or manual routing.",
+        },
+        userToken: {
+          type: "string",
+          description: "Optional hub bearer token override for group/all search or integration tests.",
+        },
       },
     },
     handler: async (input) => {
-      const result = await engine.search({
-        query: (input.query as string) ?? "",
-        maxResults: input.maxResults as number | undefined,
-        minScore: input.minScore as number | undefined,
-        ownerFilter: resolveOwnerFilter(input.owner),
+      const query = (input.query as string) ?? "";
+      const maxResults = input.maxResults as number | undefined;
+      const minScore = input.minScore as number | undefined;
+      const ownerFilter = resolveOwnerFilter(input.owner);
+      const scope = resolveScope(input.scope);
+
+      const localSearch = engine.search({
+        query,
+        maxResults,
+        minScore,
+        ownerFilter,
       });
-      return result;
+
+      if (scope === "local" || !store || !ctx) {
+        return localSearch;
+      }
+
+      const [local, hub] = await Promise.all([
+        localSearch,
+        hubSearchMemories(store, ctx, { query, maxResults, scope, hubAddress: input.hubAddress as string | undefined, userToken: input.userToken as string | undefined }).catch((err) => {
+          ctx.log.warn(`Hub search failed, using local-only results: ${err}`);
+          return emptyHubResult(scope);
+        }),
+      ]);
+
+      return { local, hub };
     },
   };
 }

package/src/tools/network-memory-detail.ts

@@ -0,0 +1,34 @@
+import { hubGetMemoryDetail } from "../client/hub";
+import type { PluginContext, ToolDefinition } from "../types";
+import type { SqliteStore } from "../storage/sqlite";
+
+export function createNetworkMemoryDetailTool(store: SqliteStore, ctx: PluginContext): ToolDefinition {
+  return {
+    name: "network_memory_detail",
+    description:
+      "Fetch the full detail for one Hub search hit using its remoteHitId. Use this after memory_search(scope=group|all) when you need the full shared content.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        remoteHitId: {
+          type: "string",
+          description: "The remoteHitId returned by memory_search hub results.",
+        },
+        hubAddress: {
+          type: "string",
+          description: "Optional hub address override for integration tests or manual routing.",
+        },
+        userToken: {
+          type: "string",
+          description: "Optional hub bearer token override for integration tests.",
+        },
+      },
+      required: ["remoteHitId"],
+    },
+    handler: async (input) => hubGetMemoryDetail(store, ctx, {
+      remoteHitId: String(input.remoteHitId ?? ""),
+      hubAddress: input.hubAddress as string | undefined,
+      userToken: input.userToken as string | undefined,
+    }),
+  };
+}

package/src/types.ts

@@ -150,7 +150,8 @@ export type SummaryProvider =
   | "bailian"
   | "cohere"
   | "mistral"
-  | "voyage";
+  | "voyage"
+  | "openclaw";
 
 export type EmbeddingProvider =
   | "openai"
@@ -160,7 +161,8 @@ export type EmbeddingProvider =
   | "cohere"
   | "mistral"
   | "voyage"
-  | "local";
+  | "local"
+  | "openclaw";
 
 export interface ProviderConfig {
   provider: string;
@@ -170,6 +172,7 @@ export interface ProviderConfig {
   headers?: Record<string, string>;
   timeoutMs?: number;
   temperature?: number;
+  capabilities?: SharingCapabilities;
 }
 
 export interface SummarizerConfig extends ProviderConfig {
@@ -246,6 +249,7 @@ export interface SkillEvolutionConfig {
   minConfidence?: number;
   maxSkillLines?: number;
   autoInstall?: boolean;
+  /** Optional independent LLM config for skill evaluation/validation. Falls back to main summarizer if not set. */
   summarizer?: SummarizerConfig;
 }
 
@@ -255,6 +259,35 @@ export interface TelemetryConfig {
   posthogHost?: string;
 }
 
+export type SharingRole = "hub" | "client";
+
+export interface SharingCapabilities {
+  hostEmbedding?: boolean;
+  hostCompletion?: boolean;
+  hostSkill?: boolean;
+}
+
+export interface HubModeConfig {
+  port?: number;
+  teamName?: string;
+  teamToken?: string;
+}
+
+export interface ClientModeConfig {
+  hubAddress?: string;
+  userToken?: string;
+  teamToken?: string;
+  pendingUserId?: string;
+}
+
+export interface SharingConfig {
+  enabled?: boolean;
+  role?: SharingRole;
+  hub?: HubModeConfig;
+  client?: ClientModeConfig;
+  capabilities?: SharingCapabilities;
+}
+
 export interface MemosLocalConfig {
   summarizer?: SummarizerConfig;
   embedding?: EmbeddingConfig;
@@ -280,6 +313,7 @@ export interface MemosLocalConfig {
   };
   skillEvolution?: SkillEvolutionConfig;
   telemetry?: TelemetryConfig;
+  sharing?: SharingConfig;
 }
 
 // ─── Defaults ───
@@ -320,6 +354,12 @@ export interface PluginContext {
   workspaceDir: string;
   config: MemosLocalConfig;
   log: Logger;
+  openclawAPI?: OpenClawAPI;
+}
+
+export interface OpenClawAPI {
+  embed(request: { texts: string[]; model?: string }): Promise<{ embeddings: number[][]; dimensions: number }>;
+  complete(request: { prompt: string; maxTokens?: number; temperature?: number; model?: string }): Promise<{ text: string }>;
 }
 
 export interface Logger {