opencode-swarm-plugin 0.30.0 → 0.30.2

package/dist/memory-tools.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Semantic Memory Plugin Tools - Embedded implementation
+ *
+ * Provides semantic memory operations using swarm-mail's MemoryStore + Ollama.
+ * Replaces external MCP-based semantic-memory calls with embedded storage.
+ *
+ * Key features:
+ * - Vector similarity search with Ollama embeddings
+ * - Full-text search fallback
+ * - Memory decay tracking (TODO: implement in MemoryStore)
+ * - Collection-based organization
+ *
+ * Tool signatures maintained for backward compatibility with existing prompts.
+ */
+import { createMemoryAdapter, type MemoryAdapter, type StoreArgs, type FindArgs, type IdArgs, type ListArgs, type StoreResult, type FindResult, type StatsResult, type HealthResult, type OperationResult } from "./memory";
+export type { MemoryAdapter, StoreArgs, FindArgs, IdArgs, ListArgs, StoreResult, FindResult, StatsResult, HealthResult, OperationResult, };
+/**
+ * Reset adapter cache (for testing)
+ */
+export declare function resetMemoryCache(): void;
+export { createMemoryAdapter };
+/**
+ * Store a memory with semantic embedding
+ */
+export declare const semantic_memory_store: {
+    description: string;
+    args: {
+        information: import("zod").ZodString;
+        collection: import("zod").ZodOptional<import("zod").ZodString>;
+        tags: import("zod").ZodOptional<import("zod").ZodString>;
+        metadata: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    execute(args: {
+        information: string;
+        collection?: string | undefined;
+        tags?: string | undefined;
+        metadata?: string | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Find memories by semantic similarity or full-text search
+ */
+export declare const semantic_memory_find: {
+    description: string;
+    args: {
+        query: import("zod").ZodString;
+        limit: import("zod").ZodOptional<import("zod").ZodNumber>;
+        collection: import("zod").ZodOptional<import("zod").ZodString>;
+        expand: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        fts: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    };
+    execute(args: {
+        query: string;
+        limit?: number | undefined;
+        collection?: string | undefined;
+        expand?: boolean | undefined;
+        fts?: boolean | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Get a single memory by ID
+ */
+export declare const semantic_memory_get: {
+    description: string;
+    args: {
+        id: import("zod").ZodString;
+    };
+    execute(args: {
+        id: string;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Remove a memory
+ */
+export declare const semantic_memory_remove: {
+    description: string;
+    args: {
+        id: import("zod").ZodString;
+    };
+    execute(args: {
+        id: string;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Validate a memory (reset decay timer)
+ */
+export declare const semantic_memory_validate: {
+    description: string;
+    args: {
+        id: import("zod").ZodString;
+    };
+    execute(args: {
+        id: string;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * List memories
+ */
+export declare const semantic_memory_list: {
+    description: string;
+    args: {
+        collection: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    execute(args: {
+        collection?: string | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Get memory statistics
+ */
+export declare const semantic_memory_stats: {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Check Ollama health
+ */
+export declare const semantic_memory_check: {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * All semantic memory tools
+ *
+ * Register these in the plugin with spread operator: { ...memoryTools }
+ */
+export declare const memoryTools: {
+    readonly "semantic-memory_store": {
+        description: string;
+        args: {
+            information: import("zod").ZodString;
+            collection: import("zod").ZodOptional<import("zod").ZodString>;
+            tags: import("zod").ZodOptional<import("zod").ZodString>;
+            metadata: import("zod").ZodOptional<import("zod").ZodString>;
+        };
+        execute(args: {
+            information: string;
+            collection?: string | undefined;
+            tags?: string | undefined;
+            metadata?: string | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    readonly "semantic-memory_find": {
+        description: string;
+        args: {
+            query: import("zod").ZodString;
+            limit: import("zod").ZodOptional<import("zod").ZodNumber>;
+            collection: import("zod").ZodOptional<import("zod").ZodString>;
+            expand: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            fts: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        };
+        execute(args: {
+            query: string;
+            limit?: number | undefined;
+            collection?: string | undefined;
+            expand?: boolean | undefined;
+            fts?: boolean | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    readonly "semantic-memory_get": {
+        description: string;
+        args: {
+            id: import("zod").ZodString;
+        };
+        execute(args: {
+            id: string;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    readonly "semantic-memory_remove": {
+        description: string;
+        args: {
+            id: import("zod").ZodString;
+        };
+        execute(args: {
+            id: string;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    readonly "semantic-memory_validate": {
+        description: string;
+        args: {
+            id: import("zod").ZodString;
+        };
+        execute(args: {
+            id: string;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    readonly "semantic-memory_list": {
+        description: string;
+        args: {
+            collection: import("zod").ZodOptional<import("zod").ZodString>;
+        };
+        execute(args: {
+            collection?: string | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    readonly "semantic-memory_stats": {
+        description: string;
+        args: {};
+        execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    readonly "semantic-memory_check": {
+        description: string;
+        args: {};
+        execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+};
+//# sourceMappingURL=memory-tools.d.ts.map

package/dist/memory-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../src/memory-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EACN,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,MAAM,UAAU,CAAC;AAGlB,YAAY,EACX,aAAa,EACb,SAAS,EACT,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,GACf,CAAC;AA2CF;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAGD,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAM/B;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;CAyBhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;CA2B/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;CAU9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;CAUjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;CAWnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;CAa/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;CAQhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;CAShC,CAAC;AAMH;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASd,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Memory Module - Semantic Memory Adapter
+ *
+ * Provides a high-level adapter around swarm-mail's MemoryStore + Ollama.
+ * Used by semantic-memory_* tools in the plugin.
+ *
+ * ## Design
+ * - Wraps MemoryStore (vector storage) + Ollama (embeddings)
+ * - Handles ID generation, metadata parsing, error handling
+ * - Tool-friendly API (string inputs/outputs, no Effect-TS in signatures)
+ *
+ * ## Usage
+ * ```typescript
+ * const adapter = await createMemoryAdapter(swarmMail.db);
+ *
+ * // Store memory
+ * const { id } = await adapter.store({
+ *   information: "OAuth tokens need 5min buffer",
+ *   tags: "auth,tokens",
+ * });
+ *
+ * // Search memories
+ * const results = await adapter.find({
+ *   query: "token refresh",
+ *   limit: 5,
+ * });
+ * ```
+ */
+import { type DatabaseAdapter, type Memory } from "swarm-mail";
+/**
+ * Reset migration check flag (for testing)
+ * @internal
+ */
+export declare function resetMigrationCheck(): void;
+/** Arguments for store operation */
+export interface StoreArgs {
+    readonly information: string;
+    readonly collection?: string;
+    readonly tags?: string;
+    readonly metadata?: string;
+}
+/** Arguments for find operation */
+export interface FindArgs {
+    readonly query: string;
+    readonly limit?: number;
+    readonly collection?: string;
+    readonly expand?: boolean;
+    readonly fts?: boolean;
+}
+/** Arguments for get/remove/validate operations */
+export interface IdArgs {
+    readonly id: string;
+}
+/** Arguments for list operation */
+export interface ListArgs {
+    readonly collection?: string;
+}
+/** Result from store operation */
+export interface StoreResult {
+    readonly id: string;
+    readonly message: string;
+}
+/** Result from find operation */
+export interface FindResult {
+    readonly results: Array<{
+        readonly id: string;
+        readonly content: string;
+        readonly score: number;
+        readonly collection: string;
+        readonly metadata: Record<string, unknown>;
+        readonly createdAt: string;
+    }>;
+    readonly count: number;
+}
+/** Result from stats operation */
+export interface StatsResult {
+    readonly memories: number;
+    readonly embeddings: number;
+}
+/** Result from health check */
+export interface HealthResult {
+    readonly ollama: boolean;
+    readonly message?: string;
+}
+/** Result from validate/remove operations */
+export interface OperationResult {
+    readonly success: boolean;
+    readonly message?: string;
+}
+/**
+ * Memory Adapter Interface
+ *
+ * High-level API for semantic memory operations.
+ */
+export interface MemoryAdapter {
+    readonly store: (args: StoreArgs) => Promise<StoreResult>;
+    readonly find: (args: FindArgs) => Promise<FindResult>;
+    readonly get: (args: IdArgs) => Promise<Memory | null>;
+    readonly remove: (args: IdArgs) => Promise<OperationResult>;
+    readonly validate: (args: IdArgs) => Promise<OperationResult>;
+    readonly list: (args: ListArgs) => Promise<Memory[]>;
+    readonly stats: () => Promise<StatsResult>;
+    readonly checkHealth: () => Promise<HealthResult>;
+}
+/**
+ * Create Memory Adapter
+ *
+ * @param db - DatabaseAdapter (from SwarmMail)
+ * @returns Memory adapter with high-level operations
+ *
+ * @example
+ * ```typescript
+ * import { getSwarmMail } from 'swarm-mail';
+ * import { createMemoryAdapter } from './memory';
+ *
+ * const swarmMail = await getSwarmMail('/path/to/project');
+ * const adapter = await createMemoryAdapter(swarmMail.db);
+ *
+ * await adapter.store({ information: "Learning X" });
+ * const results = await adapter.find({ query: "X" });
+ * ```
+ */
+export declare function createMemoryAdapter(db: DatabaseAdapter): Promise<MemoryAdapter>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

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