openclaw-penfield 1.1.2 → 2.0.0

package/README.md

@@ -38,7 +38,7 @@ Penfield is in **free beta**. Sign up for access:
 
 Native OpenClaw plugin providing direct integration with Penfield's memory and knowledge graph API. This plugin offers 4-5x performance improvement over the MCP server approach by eliminating the mcporter → MCP → Penfield stack.
 
-- **16 Memory Tools**
+- **17 Memory Tools**
 - **OAuth 2.1 Device Code Flow**: Secure authentication following RFC 8628
 - **Hybrid Search**: BM25 + vector + graph search capabilities
 - **Knowledge Graph**: Build and traverse relationships between memories
@@ -66,6 +66,20 @@ openclaw plugins install -l .
 
 The plugin is **auto-enabled when loaded**. No configuration required for basic use.
 
+### Plugin Allowlist
+
+OpenClaw recommends explicitly trusting non-bundled plugins. If you see `plugins.allow is empty` warnings on startup, add the plugin to your allowlist in `openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "allow": ["openclaw-penfield"]
+  }
+}
+```
+
+Once the `allow` array exists, future `openclaw plugins install` and `openclaw plugins enable` commands will automatically append to it.
+
 ### Plugin Config
 
 In `openclaw.json` under `plugins.entries`:
@@ -175,7 +189,7 @@ Store a new memory in Penfield.
 ```
 
 #### `penfield_recall`
-Hybrid search using BM25 + vector + graph.
+Hybrid search using BM25 + vector + graph. Returns compact responses (essential fields only).
 
 **Parameters:**
 - `query` (required): Search query (1-4,000 chars)
@@ -186,6 +200,10 @@ Hybrid search using BM25 + vector + graph.
 - `memory_types` (optional): Filter by types
 - `importance_threshold` (optional): Minimum importance
 - `enable_graph_expansion` (optional): Enable traversal (default: true)
+- `start_date` (optional): Filter memories created on or after this date (ISO 8601, e.g. "2025-01-01")
+- `end_date` (optional): Filter memories created on or before this date (ISO 8601, e.g. "2025-12-31")
+- `sort` (optional): Sort order — "relevance" (default), "created_desc", or "created_asc"
+- `max_content_length` (optional): Truncate content to N characters (50-10,000). Full content available via `penfield_fetch`.
 
 **Example:**
 ```typescript
@@ -194,18 +212,23 @@ Hybrid search using BM25 + vector + graph.
   "limit": 10,
   "vector_weight": 0.5,
   "bm25_weight": 0.3,
-  "graph_weight": 0.2
+  "graph_weight": 0.2,
+  "start_date": "2025-06-01"
 }
 ```
 
 #### `penfield_search`
-Semantic search variant (higher vector weight).
+Semantic search variant (higher vector weight). Returns compact responses (essential fields only).
 
 **Parameters:**
-- `query` (required): Search query
-- `limit` (optional): Max results
+- `query` (required): Search query (1-4,000 chars)
+- `limit` (optional): Max results (default: 20, max: 100)
 - `memory_types` (optional): Filter by types
 - `importance_threshold` (optional): Minimum importance
+- `start_date` (optional): Filter memories created on or after this date (ISO 8601)
+- `end_date` (optional): Filter memories created on or before this date (ISO 8601)
+- `sort` (optional): Sort order — "relevance" (default), "created_desc", or "created_asc"
+- `max_content_length` (optional): Truncate content to N characters (50-10,000)
 
 #### `penfield_fetch`
 Get a specific memory by ID.
@@ -253,6 +276,21 @@ Create a relationship between two memories.
 }
 ```
 
+#### `penfield_disconnect`
+Remove a relationship between two memories.
+
+**Parameters:**
+- `from_memory_id` (required): Source memory ID (UUID format)
+- `to_memory_id` (required): Target memory ID (UUID format)
+
+**Example:**
+```typescript
+{
+  "from_memory_id": "22618318-8d82-49c9-8bb8-1cf3a61b3c75",
+  "to_memory_id": "20413926-2446-4f88-bfd6-749b37969f34"
+}
+```
+
 #### `penfield_explore`
 Traverse the knowledge graph from a starting memory.
 
@@ -478,18 +516,20 @@ src/
 ├── hooks.ts                 # Lifecycle hooks (auto-awaken, auto-orient, flush config check)
 ├── auth-service.ts          # Background OAuth token refresh service
 ├── api-client.ts            # HTTP client wrapper
+├── response-compact.ts      # Response compaction (mirrors MCP field-stripping)
 ├── runtime.ts               # Runtime factory (receives authService from index.ts)
 ├── store.ts                 # Credential file I/O with TOKEN_EXPIRY_BUFFER_MS
 ├── cli.ts                   # CLI command registration (penfield login)
 ├── device-flow.ts           # RFC 8628 Device Code Flow implementation
 └── tools/
-    ├── index.ts             # Tool registry (16 tools)
+    ├── index.ts             # Tool registry (17 tools)
     ├── store.ts             # penfield_store
     ├── recall.ts            # penfield_recall
     ├── search.ts            # penfield_search
     ├── fetch.ts             # penfield_fetch
     ├── update-memory.ts     # penfield_update_memory
     ├── connect.ts           # penfield_connect
+    ├── disconnect.ts        # penfield_disconnect
     ├── explore.ts           # penfield_explore
     ├── save-context.ts      # penfield_save_context
     ├── restore-context.ts   # penfield_restore_context
@@ -525,6 +565,7 @@ The plugin uses two services and one hook registered with OpenClaw:
 |------|--------|----------|
 | awaken | GET | /api/v2/personality/awakening |
 | connect | POST | /api/v2/relationships |
+| disconnect | DELETE | /api/v2/relationships/between |
 | delete_artifact | DELETE | /api/v2/artifacts |
 | explore | POST | /api/v2/relationships/traverse |
 | fetch | GET | /api/v2/memories/{id} |

package/dist/index.js

@@ -7,7 +7,7 @@ import { createAuthService } from "./src/auth-service.js";
 const penfieldPlugin = {
     id: "openclaw-penfield",
     name: "Penfield Memory",
-    description: "Native Penfield memory integration with 16 tools for knowledge management",
+    description: "Native Penfield memory integration with 17 tools for knowledge management",
     configSchema: {
         parse(value) {
             return PenfieldConfigSchema.parse(value ?? {});
@@ -79,7 +79,7 @@ const penfieldPlugin = {
                 logger.info("[penfield-auth] Service stopped");
             },
         });
-        // Register all 16 tools
+        // Register all 17 tools
         registerPenfieldTools(api, ensureRuntime);
         // Register lifecycle hooks (auto-awaken + auto-orient, injected every turn)
         registerPenfieldHooks({ api, config: cfg, ensureRuntime, logger });

package/dist/src/api-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM,CAAC;gBAFP,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,YAAY,YAAA;IAGzB,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,OAAO,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,CAAC,CAAC;IAuDP,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1E,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrD,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpD,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAGpF"}
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM,CAAC;gBAFP,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,YAAY,YAAA;IAGzB,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,OAAO,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,CAAC,CAAC;IA2DP,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1E,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrD,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpD,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAGpF"}

package/dist/src/api-client.js

@@ -51,6 +51,9 @@ export class PenfieldApiClient {
             this.logger?.error(`[penfield] ${errorMessage}`);
             throw new Error(errorMessage);
         }
+        if (response.status === 204) {
+            return {};
+        }
         const data = await response.json();
         return (data.data || data);
     }

package/dist/src/response-compact.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Response compaction utilities.
+ *
+ * Mirrors the MCP server's field-stripping patterns so models receive only
+ * the fields they need, saving context tokens and reducing noise.
+ */
+/** Minimum relevance score — results below this are dropped (matches MCP) */
+export declare const RELEVANCE_THRESHOLD = 0.05;
+interface CompactMemory {
+    id: string | undefined;
+    content: string | undefined;
+    type: string;
+    relevance: number;
+    created: string | undefined;
+    tags: string[];
+    source_type?: string;
+    filename?: string;
+    document_title?: string;
+    document_id?: string;
+    content_with_context?: string;
+    chunk_index?: number;
+    total_chunks?: number;
+}
+export interface CompactRecallResponse {
+    query: string;
+    found: number;
+    memories: CompactMemory[];
+}
+/**
+ * Compact a hybrid search response to essential fields.
+ *
+ * Strips: score_breakdown, search_metadata, knowledge_cloud, analyzed_query,
+ * raw metadata objects. Filters results below RELEVANCE_THRESHOLD.
+ *
+ * Optionally sorts by created date and truncates content.
+ */
+export declare function compactRecallResponse(response: any, query: string, options?: {
+    sort?: string;
+    maxContentLength?: number;
+}): CompactRecallResponse;
+interface CompactReflectMemory {
+    content: string | undefined;
+    type: string;
+    importance: number | undefined;
+    score: number | undefined;
+}
+export interface CompactReflectResponse {
+    time_window: string;
+    memories_analyzed: number;
+    active_topics: unknown[];
+    top_memories: CompactReflectMemory[];
+    patterns: unknown[];
+    insights: unknown[];
+}
+/**
+ * Compact a reflect response to essential fields.
+ *
+ * Strips full statistics object. Slices memories to top 5, topics to top 10.
+ */
+export declare function compactReflectResponse(response: any, timeWindow: string): CompactReflectResponse;
+interface CompactNode {
+    id: string;
+    preview?: string;
+    type?: string;
+    tags?: string[];
+}
+interface CompactRelationship {
+    id: string;
+    type?: string;
+    strength?: number;
+}
+interface CompactPath {
+    nodes: CompactNode[];
+    relationships: CompactRelationship[];
+    depth: number;
+}
+export interface CompactExploreResponse {
+    start_memory: string;
+    paths_found: number;
+    max_depth_reached: number;
+    paths: CompactPath[];
+    message?: string;
+}
+/**
+ * Compact a graph traversal response.
+ *
+ * Enriches nodes/relationships with selective fields from detail lookups.
+ */
+export declare function compactExploreResponse(response: any, startMemoryId: string): CompactExploreResponse;
+export {};
+//# sourceMappingURL=response-compact.d.ts.map

package/dist/src/response-compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-compact.d.ts","sourceRoot":"","sources":["../../src/response-compact.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAyBxC,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAEnC,QAAQ,EAAE,GAAG,EACb,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,qBAAqB,CA0DvB;AAMD,UAAU,oBAAoB;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAEpC,QAAQ,EAAE,GAAG,EACb,UAAU,EAAE,MAAM,GACjB,sBAAsB,CAmBxB;AAMD,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAEpC,QAAQ,EAAE,GAAG,EACb,aAAa,EAAE,MAAM,GACpB,sBAAsB,CAiDxB"}

package/dist/src/response-compact.js

@@ -0,0 +1,152 @@
+/**
+ * Response compaction utilities.
+ *
+ * Mirrors the MCP server's field-stripping patterns so models receive only
+ * the fields they need, saving context tokens and reducing noise.
+ */
+/** Minimum relevance score — results below this are dropped (matches MCP) */
+export const RELEVANCE_THRESHOLD = 0.05;
+/** Maximum memories returned in reflect compaction */
+const MAX_REFLECT_MEMORIES = 5;
+/** Maximum active topics returned in reflect compaction */
+const MAX_REFLECT_TOPICS = 10;
+/**
+ * Compact a hybrid search response to essential fields.
+ *
+ * Strips: score_breakdown, search_metadata, knowledge_cloud, analyzed_query,
+ * raw metadata objects. Filters results below RELEVANCE_THRESHOLD.
+ *
+ * Optionally sorts by created date and truncates content.
+ */
+export function compactRecallResponse(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- raw API shape
+response, query, options) {
+    const items = response?.items ?? [];
+    const memories = [];
+    for (const result of items) {
+        const score = result.score ?? 0;
+        if (score < RELEVANCE_THRESHOLD)
+            continue;
+        const metadata = result.metadata ?? {};
+        const memoryType = metadata.memory_type ?? "unknown";
+        const sourceType = result.source_type ?? metadata.source_type;
+        const entry = {
+            id: result.id,
+            content: result.content,
+            type: memoryType,
+            relevance: score,
+            created: result.created_at,
+            tags: result.tags ?? [],
+        };
+        // Include document metadata when applicable
+        if (sourceType === "document_upload") {
+            entry.source_type = "document";
+            if (metadata.filename)
+                entry.filename = metadata.filename;
+            if (metadata.document_title)
+                entry.document_title = metadata.document_title;
+            if (metadata.document_id)
+                entry.document_id = metadata.document_id;
+        }
+        // Include chunk context when present
+        if (result.content_with_context) {
+            entry.content_with_context = result.content_with_context;
+            entry.chunk_index = result.chunk_index;
+            entry.total_chunks = result.total_chunks;
+        }
+        memories.push(entry);
+    }
+    // Client-side sort
+    if (options?.sort === "created_desc") {
+        memories.sort((a, b) => (b.created ?? "").localeCompare(a.created ?? ""));
+    }
+    else if (options?.sort === "created_asc") {
+        memories.sort((a, b) => (a.created ?? "").localeCompare(b.created ?? ""));
+    }
+    // default "relevance" — already sorted by API
+    // Content truncation
+    if (options?.maxContentLength != null && options.maxContentLength > 0) {
+        const max = options.maxContentLength;
+        for (const m of memories) {
+            if (m.content && m.content.length > max) {
+                m.content = m.content.slice(0, max) + "... [truncated, use penfield_fetch for full content]";
+            }
+        }
+    }
+    return { query, found: memories.length, memories };
+}
+/**
+ * Compact a reflect response to essential fields.
+ *
+ * Strips full statistics object. Slices memories to top 5, topics to top 10.
+ */
+export function compactReflectResponse(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- raw API shape
+response, timeWindow) {
+    const rawMemories = response?.memories ?? [];
+    const topMemories = rawMemories.slice(0, MAX_REFLECT_MEMORIES).map((m) => ({
+        content: m.content,
+        type: m.memory_type ?? "unknown",
+        importance: m.importance,
+        score: m.score,
+    }));
+    const activeTopics = (response?.active_topics ?? []).slice(0, MAX_REFLECT_TOPICS);
+    return {
+        time_window: timeWindow,
+        memories_analyzed: response?.statistics?.total_memories_analyzed ?? 0,
+        active_topics: activeTopics,
+        top_memories: topMemories,
+        patterns: response?.emerging_patterns ?? [],
+        insights: response?.relationship_insights ?? [],
+    };
+}
+/**
+ * Compact a graph traversal response.
+ *
+ * Enriches nodes/relationships with selective fields from detail lookups.
+ */
+export function compactExploreResponse(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- raw API shape
+response, startMemoryId) {
+    const nodeDetails = response?.node_details ?? {};
+    const relDetails = response?.relationship_details ?? {};
+    const rawPaths = response?.paths ?? [];
+    const paths = rawPaths.map((path) => {
+        const rawNodes = path.nodes ?? [];
+        const rawRels = path.relationships ?? [];
+        const nodes = rawNodes.map((nid) => {
+            const detail = nodeDetails[nid];
+            if (detail) {
+                return {
+                    id: nid,
+                    preview: detail.preview,
+                    type: detail.type,
+                    tags: detail.tags ?? [],
+                };
+            }
+            return { id: nid };
+        });
+        const relationships = rawRels.map((rid) => {
+            const detail = relDetails[rid];
+            if (detail) {
+                return {
+                    id: rid,
+                    type: detail.type,
+                    strength: detail.strength,
+                };
+            }
+            return { id: rid };
+        });
+        return { nodes, relationships, depth: rawNodes.length - 1 };
+    });
+    const result = {
+        start_memory: startMemoryId,
+        paths_found: paths.length,
+        max_depth_reached: response?.max_depth_reached ?? 0,
+        paths,
+    };
+    if (paths.length === 0) {
+        result.message = "No connections found from this memory";
+    }
+    return result;
+}

package/dist/src/tools/disconnect.d.ts

@@ -0,0 +1,7 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const DisconnectToolSchema: import("@sinclair/typebox").TObject<{
+    from_memory_id: import("@sinclair/typebox").TString;
+    to_memory_id: import("@sinclair/typebox").TString;
+}>;
+export declare function executeDisconnectTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
+//# sourceMappingURL=disconnect.d.ts.map

package/dist/src/tools/disconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnect.d.ts","sourceRoot":"","sources":["../../../src/tools/disconnect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,oBAAoB;;;EASE,CAAC;AAEpC,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CA4Bd"}

package/dist/src/tools/disconnect.js

@@ -0,0 +1,38 @@
+import { Type } from "../types/typebox.js";
+import { validateUuid } from "../validation.js";
+export const DisconnectToolSchema = Type.Object({
+    from_memory_id: Type.String({
+        description: "Source memory ID (UUID format)",
+        examples: ["22618318-8d82-49c9-8bb8-1cf3a61b3c75"],
+    }),
+    to_memory_id: Type.String({
+        description: "Target memory ID (UUID format)",
+        examples: ["20413926-2446-4f88-bfd6-749b37969f34"],
+    }),
+}, { additionalProperties: false });
+export async function executeDisconnectTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    validateUuid(params.from_memory_id, 'from_memory_id');
+    validateUuid(params.to_memory_id, 'to_memory_id');
+    // Map user-friendly field names to API field names
+    const queryParams = {
+        from_id: params.from_memory_id,
+        to_id: params.to_memory_id,
+    };
+    await apiClient.delete("/api/v2/relationships/between", queryParams);
+    const result = {
+        success: true,
+        from_id: params.from_memory_id,
+        to_id: params.to_memory_id,
+        message: "Relationship removed",
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+        details: result,
+    };
+}

package/dist/src/tools/explore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../../src/tools/explore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,iBAAiB;;;;;EAwBK,CAAC;AAEpC,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,GAAG,CAAC,CAcd"}
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../../src/tools/explore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI1D,eAAO,MAAM,iBAAiB;;;;;EAwBK,CAAC;AAEpC,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,GAAG,CAAC,CAgBd"}

package/dist/src/tools/explore.js

@@ -1,5 +1,6 @@
 import { Type, RelationshipTypeSchema } from "../types/typebox.js";
 import { validateUuid } from "../validation.js";
+import { compactExploreResponse } from "../response-compact.js";
 export const ExploreToolSchema = Type.Object({
     start_memory_id: Type.String({
         description: "Starting memory ID for graph traversal (UUID format)",
@@ -23,11 +24,12 @@ export async function executeExploreTool(apiClient, params) {
     const { start_memory_id } = params;
     validateUuid(start_memory_id, 'start_memory_id');
     const response = await apiClient.post("/api/v2/relationships/traverse", params);
+    const compact = compactExploreResponse(response, start_memory_id);
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify(response, null, 2),
+                text: JSON.stringify(compact, null, 2),
             },
         ],
         details: response,

package/dist/src/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA6BrD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,iBAAiB,EACtB,aAAa,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,QAgK9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA8BrD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,iBAAiB,EACtB,aAAa,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,QAwK9C"}

package/dist/src/tools/index.js

@@ -4,6 +4,7 @@ import { SearchToolSchema, executeSearchTool } from "./search.js";
 import { FetchToolSchema, executeFetchTool } from "./fetch.js";
 import { UpdateMemoryToolSchema, executeUpdateMemoryTool } from "./update-memory.js";
 import { ConnectToolSchema, executeConnectTool } from "./connect.js";
+import { DisconnectToolSchema, executeDisconnectTool } from "./disconnect.js";
 import { ExploreToolSchema, executeExploreTool } from "./explore.js";
 import { SaveContextToolSchema, executeSaveContextTool } from "./save-context.js";
 import { RestoreContextToolSchema, executeRestoreContextTool, } from "./restore-context.js";
@@ -38,13 +39,14 @@ export function registerPenfieldTools(api, ensureRuntime) {
             },
         });
     };
-    // Register all 16 tools
+    // Register all 17 tools
     registerTool("penfield_store", "Store Memory", "Store a new memory in Penfield", StoreToolSchema, executeStoreTool);
     registerTool("penfield_recall", "Recall Memories", "Search memories using hybrid BM25 + vector + graph search", RecallToolSchema, executeRecallTool);
     registerTool("penfield_search", "Search Memories", "Semantic search for memories", SearchToolSchema, executeSearchTool);
     registerTool("penfield_fetch", "Fetch Memory", "Get a specific memory by ID", FetchToolSchema, executeFetchTool);
     registerTool("penfield_update_memory", "Update Memory", "Update an existing memory", UpdateMemoryToolSchema, executeUpdateMemoryTool);
     registerTool("penfield_connect", "Connect Memories", "Create a relationship between two memories", ConnectToolSchema, executeConnectTool);
+    registerTool("penfield_disconnect", "Disconnect Memories", "Remove a relationship between two memories", DisconnectToolSchema, executeDisconnectTool);
     registerTool("penfield_explore", "Explore Graph", "Traverse the knowledge graph from a starting memory", ExploreToolSchema, executeExploreTool);
     registerTool("penfield_save_context", "Save Context", "Save a cognitive state checkpoint with name and description for handoff to another agent or future session", SaveContextToolSchema, executeSaveContextTool);
     registerTool("penfield_restore_context", "Restore Context", "Restore a previously saved context checkpoint by name, UUID, or 'awakening' for personality briefing", RestoreContextToolSchema, executeRestoreContextTool);

package/dist/src/tools/recall.d.ts

@@ -8,6 +8,10 @@ export declare const RecallToolSchema: import("@sinclair/typebox").TObject<{
     memory_types: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"fact">, import("@sinclair/typebox").TLiteral<"insight">, import("@sinclair/typebox").TLiteral<"conversation">, import("@sinclair/typebox").TLiteral<"correction">, import("@sinclair/typebox").TLiteral<"reference">, import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"checkpoint">, import("@sinclair/typebox").TLiteral<"identity_core">, import("@sinclair/typebox").TLiteral<"personality_trait">, import("@sinclair/typebox").TLiteral<"relationship">, import("@sinclair/typebox").TLiteral<"strategy">]>>>;
     importance_threshold: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
     enable_graph_expansion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    start_date: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    end_date: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    sort: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"relevance">, import("@sinclair/typebox").TLiteral<"created_desc">, import("@sinclair/typebox").TLiteral<"created_asc">]>>;
+    max_content_length: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
 }>;
 export declare function executeRecallTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
 //# sourceMappingURL=recall.d.ts.map

package/dist/src/tools/recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../../src/tools/recall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;EAuDM,CAAC;AAEpC,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CAqBd"}
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../../src/tools/recall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;EA2DM,CAAC;AAEpC,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CA6Bd"}

package/dist/src/tools/recall.js

@@ -1,4 +1,5 @@
-import { Type, MemoryTypeSchema, ImportanceScoreSchema } from "../types/typebox.js";
+import { Type, MemoryTypeSchema, ImportanceScoreSchema, StartDateSchema, EndDateSchema, SortOrderSchema, MaxContentLengthSchema } from "../types/typebox.js";
+import { compactRecallResponse } from "../response-compact.js";
 export const RecallToolSchema = Type.Object({
     query: Type.String({
         description: "Search query (1-4,000 chars)",
@@ -40,6 +41,10 @@ export const RecallToolSchema = Type.Object({
         description: "Enable graph traversal (default: true)",
         default: true,
     })),
+    start_date: Type.Optional(StartDateSchema),
+    end_date: Type.Optional(EndDateSchema),
+    sort: Type.Optional(SortOrderSchema),
+    max_content_length: Type.Optional(MaxContentLengthSchema),
 }, { additionalProperties: false });
 export async function executeRecallTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
 ) {
@@ -51,12 +56,18 @@ export async function executeRecallTool(apiClient, params // eslint-disable-line
     if (Math.abs(sum - 1.0) > 0.01) {
         throw new Error(`Weights must sum to 1.0 (got ${sum})`);
     }
-    const response = await apiClient.post("/api/v2/search/hybrid", params);
+    // Separate plugin-only params from API params
+    const { sort, max_content_length, ...apiParams } = params;
+    const response = await apiClient.post("/api/v2/search/hybrid", apiParams);
+    const compact = compactRecallResponse(response, params.query, {
+        sort,
+        maxContentLength: max_content_length,
+    });
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify(response, null, 2),
+                text: JSON.stringify(compact, null, 2),
             },
         ],
         details: response,

package/dist/src/tools/reflect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reflect.d.ts","sourceRoot":"","sources":["../../../src/tools/reflect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,iBAAiB;;;;;EAwCK,CAAC;AASpC,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,GAAG,CAAC,CA0Bd"}
+{"version":3,"file":"reflect.d.ts","sourceRoot":"","sources":["../../../src/tools/reflect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,iBAAiB;;;;;EAwCK,CAAC;AASpC,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,GAAG,CAAC,CA8Bd"}

package/dist/src/tools/reflect.js

@@ -1,4 +1,5 @@
 import { Type } from "../types/typebox.js";
+import { compactReflectResponse } from "../response-compact.js";
 export const ReflectToolSchema = Type.Object({
     time_window: Type.Optional(Type.Union([
         Type.Literal("recent"),
@@ -34,6 +35,7 @@ const TIME_WINDOW_ALIASES = {
 export async function executeReflectTool(apiClient, params) {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any -- params validated by schema
     const p = { ...params };
+    const originalTimeWindow = p.time_window ?? "recent";
     if (p.time_window === "90d") {
         // API has no 90d window — convert to explicit date range (matches MCP behavior)
         if (!p.start_date) {
@@ -47,11 +49,12 @@ export async function executeReflectTool(apiClient, params) {
         p.time_window = TIME_WINDOW_ALIASES[p.time_window];
     }
     const response = await apiClient.post("/api/v2/analysis/reflect", p);
+    const compact = compactReflectResponse(response, originalTimeWindow);
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify(response, null, 2),
+                text: JSON.stringify(compact, null, 2),
             },
         ],
         details: response,

package/dist/src/tools/search.d.ts

@@ -4,6 +4,10 @@ export declare const SearchToolSchema: import("@sinclair/typebox").TObject<{
     limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
     memory_types: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"fact">, import("@sinclair/typebox").TLiteral<"insight">, import("@sinclair/typebox").TLiteral<"conversation">, import("@sinclair/typebox").TLiteral<"correction">, import("@sinclair/typebox").TLiteral<"reference">, import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"checkpoint">, import("@sinclair/typebox").TLiteral<"identity_core">, import("@sinclair/typebox").TLiteral<"personality_trait">, import("@sinclair/typebox").TLiteral<"relationship">, import("@sinclair/typebox").TLiteral<"strategy">]>>>;
     importance_threshold: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    start_date: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    end_date: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    sort: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"relevance">, import("@sinclair/typebox").TLiteral<"created_desc">, import("@sinclair/typebox").TLiteral<"created_asc">]>>;
+    max_content_length: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
 }>;
 export declare function executeSearchTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
 //# sourceMappingURL=search.d.ts.map

package/dist/src/tools/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,gBAAgB;;;;;EAyBM,CAAC;AAEpC,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CAmBd"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,gBAAgB;;;;;;;;;EA6BM,CAAC;AAEpC,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CA2Bd"}

package/dist/src/tools/search.js

@@ -1,4 +1,5 @@
-import { Type, MemoryTypeSchema, ImportanceScoreSchema } from "../types/typebox.js";
+import { Type, MemoryTypeSchema, ImportanceScoreSchema, StartDateSchema, EndDateSchema, SortOrderSchema, MaxContentLengthSchema } from "../types/typebox.js";
+import { compactRecallResponse } from "../response-compact.js";
 export const SearchToolSchema = Type.Object({
     query: Type.String({
         description: "Search query (1-4,000 chars)",
@@ -18,22 +19,32 @@ export const SearchToolSchema = Type.Object({
         ...ImportanceScoreSchema,
         description: "Minimum importance (0-1)",
     })),
+    start_date: Type.Optional(StartDateSchema),
+    end_date: Type.Optional(EndDateSchema),
+    sort: Type.Optional(SortOrderSchema),
+    max_content_length: Type.Optional(MaxContentLengthSchema),
 }, { additionalProperties: false });
 export async function executeSearchTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
 ) {
+    // Separate plugin-only params from API params
+    const { sort, max_content_length, ...userParams } = params;
     // Search is a variant of hybrid search with higher vector weight
     const searchParams = {
-        ...params,
+        ...userParams,
         vector_weight: 0.6,
         bm25_weight: 0.3,
         graph_weight: 0.1,
     };
     const response = await apiClient.post("/api/v2/search/hybrid", searchParams);
+    const compact = compactRecallResponse(response, params.query, {
+        sort,
+        maxContentLength: max_content_length,
+    });
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify(response, null, 2),
+                text: JSON.stringify(compact, null, 2),
             },
         ],
         details: response,

package/dist/src/types/typebox.d.ts

@@ -15,5 +15,9 @@ export declare const ImportanceScoreSchema: import("@sinclair/typebox").TNumber;
 export declare const ConfidenceScoreSchema: import("@sinclair/typebox").TNumber;
 export declare const TagsSchema: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
 export declare const MemoryTypeSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"fact">, import("@sinclair/typebox").TLiteral<"insight">, import("@sinclair/typebox").TLiteral<"conversation">, import("@sinclair/typebox").TLiteral<"correction">, import("@sinclair/typebox").TLiteral<"reference">, import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"checkpoint">, import("@sinclair/typebox").TLiteral<"identity_core">, import("@sinclair/typebox").TLiteral<"personality_trait">, import("@sinclair/typebox").TLiteral<"relationship">, import("@sinclair/typebox").TLiteral<"strategy">]>;
+export declare const StartDateSchema: import("@sinclair/typebox").TString;
+export declare const EndDateSchema: import("@sinclair/typebox").TString;
+export declare const SortOrderSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"relevance">, import("@sinclair/typebox").TLiteral<"created_desc">, import("@sinclair/typebox").TLiteral<"created_asc">]>;
+export declare const MaxContentLengthSchema: import("@sinclair/typebox").TNumber;
 export declare const RelationshipTypeSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"supersedes">, import("@sinclair/typebox").TLiteral<"updates">, import("@sinclair/typebox").TLiteral<"evolution_of">, import("@sinclair/typebox").TLiteral<"supports">, import("@sinclair/typebox").TLiteral<"contradicts">, import("@sinclair/typebox").TLiteral<"disputes">, import("@sinclair/typebox").TLiteral<"parent_of">, import("@sinclair/typebox").TLiteral<"child_of">, import("@sinclair/typebox").TLiteral<"sibling_of">, import("@sinclair/typebox").TLiteral<"causes">, import("@sinclair/typebox").TLiteral<"influenced_by">, import("@sinclair/typebox").TLiteral<"prerequisite_for">, import("@sinclair/typebox").TLiteral<"implements">, import("@sinclair/typebox").TLiteral<"documents">, import("@sinclair/typebox").TLiteral<"example_of">, import("@sinclair/typebox").TLiteral<"tests">, import("@sinclair/typebox").TLiteral<"responds_to">, import("@sinclair/typebox").TLiteral<"references">, import("@sinclair/typebox").TLiteral<"inspired_by">, import("@sinclair/typebox").TLiteral<"follows">, import("@sinclair/typebox").TLiteral<"precedes">, import("@sinclair/typebox").TLiteral<"depends_on">, import("@sinclair/typebox").TLiteral<"composed_of">, import("@sinclair/typebox").TLiteral<"part_of">]>;
 //# sourceMappingURL=typebox.d.ts.map

package/dist/src/types/typebox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typebox.d.ts","sourceRoot":"","sources":["../../../src/types/typebox.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;AAG9B,eAAO,MAAM,UAAU,qCAGrB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;EAY3B,CAAC;AAEH,eAAO,MAAM,qBAAqB,qCAIhC,CAAC;AAEH,eAAO,MAAM,qBAAqB,qCAIhC,CAAC;AAEH,eAAO,MAAM,UAAU,yEAGrB,CAAC;AAEH,eAAO,MAAM,gBAAgB,8lBAYQ,CAAC;AAEtC,eAAO,MAAM,sBAAsB,yvCAoCjC,CAAC"}
+{"version":3,"file":"typebox.d.ts","sourceRoot":"","sources":["../../../src/types/typebox.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;AAG9B,eAAO,MAAM,UAAU,qCAGrB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;EAY3B,CAAC;AAEH,eAAO,MAAM,qBAAqB,qCAIhC,CAAC;AAEH,eAAO,MAAM,qBAAqB,qCAIhC,CAAC;AAEH,eAAO,MAAM,UAAU,yEAGrB,CAAC;AAEH,eAAO,MAAM,gBAAgB,8lBAYQ,CAAC;AAGtC,eAAO,MAAM,eAAe,qCAE1B,CAAC;AAEH,eAAO,MAAM,aAAa,qCAExB,CAAC;AAEH,eAAO,MAAM,eAAe,oMAU3B,CAAC;AAEF,eAAO,MAAM,sBAAsB,qCAIjC,CAAC;AAEH,eAAO,MAAM,sBAAsB,yvCAoCjC,CAAC"}

package/dist/src/types/typebox.js

@@ -52,6 +52,26 @@ export const MemoryTypeSchema = Type.Union([
     Type.Literal("relationship"),
     Type.Literal("strategy"),
 ], { description: "Type of memory" });
+// Shared search parameter schemas (used by recall + search)
+export const StartDateSchema = Type.String({
+    description: "Filter memories created on or after this date (ISO 8601, e.g. '2025-01-01')",
+});
+export const EndDateSchema = Type.String({
+    description: "Filter memories created on or before this date (ISO 8601, e.g. '2025-12-31')",
+});
+export const SortOrderSchema = Type.Union([
+    Type.Literal("relevance"),
+    Type.Literal("created_desc"),
+    Type.Literal("created_asc"),
+], {
+    description: 'Sort order: "relevance" (default), "created_desc", or "created_asc"',
+    default: "relevance",
+});
+export const MaxContentLengthSchema = Type.Number({
+    description: "Truncate memory content to this many characters. Full content available via penfield_fetch.",
+    minimum: 50,
+    maximum: 10000,
+});
 export const RelationshipTypeSchema = Type.Union([
     // Knowledge Evolution
     Type.Literal("supersedes"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-penfield",
-  "version": "1.1.2",
+  "version": "2.0.0",
   "type": "module",
   "description": "Native OpenClaw plugin for Penfield memory integration",
   "main": "dist/index.js",
@@ -15,7 +15,7 @@
     "memory",
     "knowledge-graph"
   ],
-  "author": "Frank Fiegel",
+  "author": "Penfield",
   "license": "MIT",
   "repository": {
     "type": "git",