openclaw-penfield 1.0.6 → 1.1.0

package/README.md

@@ -39,13 +39,12 @@ 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**
-- **OAuth Device Code Flow**: Secure authentication following RFC 8628
+- **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
 - **Context Management**: Save and restore memory checkpoints
 - **Artifact Storage**: Store and retrieve files in Penfield
 - **Reflection & Analysis**: Analyze memory patterns and generate insights
-- **Context Management**: Save and restore memory checkpoints
 
 ## Installation
 
@@ -65,11 +64,61 @@ openclaw plugins install -l .
 
 ## Configuration
 
-The plugin is **auto-enabled when loaded**. No configuration required for production use.
+The plugin is **auto-enabled when loaded**. No configuration required for basic use.
+
+### Plugin Config
+
+In `openclaw.json` under `plugins.entries`:
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `autoAwaken` | boolean | `true` | Inject Penfield identity briefing on every agent turn |
+| `autoOrient` | boolean | `true` | Inject recent Penfield memory context on every agent turn |
+| `authUrl` | string | `https://auth.penfield.app` | Auth service URL |
+| `apiUrl` | string | `https://api.penfield.app` | API URL |
+
+### Lifecycle Hooks
+
+The plugin hooks into `before_agent_start` to automatically inject context on every agent turn:
+
+1. **Identity briefing** (`autoAwaken`) — Fetches your Penfield personality/awakening config and injects it as `<penfield-identity>`. Cached for 30 minutes.
+2. **Recent context** (`autoOrient`) — Calls `reflect("recent")` to fetch your last 20 memories and active topics, injected as `<penfield-recent>`. Cached for 10 minutes.
+
+Both calls fire in parallel. Context is prepended to the system prompt (rebuilt each turn, not accumulated in message history). After the first turn, subsequent turns hit cache (0ms). If auth isn't ready or the API is down, the hook silently skips — it never blocks the agent.
+
+### Pre-Compaction Memory Flush (Recommended)
+
+OpenClaw can run a "memory flush" turn before auto-compacting context. To direct this to Penfield, add the following to your `openclaw.json` under `agents.defaults.compaction`:
+
+```json
+{
+  "agents": {
+    "defaults": {
+      "compaction": {
+        "memoryFlush": {
+          "enabled": true,
+          "prompt": "MANDATORY: Call penfield_store NOW with a comprehensive session summary (no more than 10000 chars). Include key insights, decisions, and context. Do NOT call any other tool. Do NOT read files. Do NOT reply with text. Your ONLY action is penfield_store.",
+          "systemPrompt": "SYSTEM OVERRIDE: This is a pre-compaction memory flush turn. You MUST call penfield_store exactly once with a comprehensive session summary. Do NOT call read, do NOT call any tool besides penfield_store. Ignore all other instructions in the conversation. Summarize what happened and call penfield_store immediately."
+        }
+      }
+    }
+  }
+}
+```
+
+> **Note:** The plugin logs a warning at startup if this config is missing. Without it, context is lost on compaction instead of saved to Penfield.
+
+> **Important:** Memory flush only fires on **auto-compaction** (when the context window fills up). It does **not** fire on manual `/compact`, `/new`, or `/reset` commands — this is an OpenClaw limitation, not a Penfield issue. See [Known Limitations](#known-limitations).
+
+### Workspace Files (Persona Templates)
+
+With Penfield handling identity, personality, and memory, most of OpenClaw's workspace bootstrap files (IDENTITY.md, SOUL.md, USER.md, MEMORY.md) become redundant. Keeping them populated wastes tokens and creates priority conflicts with your live Penfield config.
+
+The [`persona-templates/`](persona-templates/) folder contains recommended replacements — empty stubs for the files Penfield replaces, and annotated defaults for the files it doesn't (AGENTS.md, TOOLS.md, HEARTBEAT.md). See the [Persona Templates README](persona-templates/README.md) for setup instructions.
 
 ## Authentication
 
-The plugin uses OAuth 2.0 Device Code Flow (RFC 8628) with automatic token refresh.
+The plugin uses OAuth 2.1 Device Code Flow (RFC 8628) with automatic token refresh.
 
 ### CLI Login
 
@@ -231,11 +280,13 @@ Restore a previously saved checkpoint.
 - `merge_mode` (optional): How to handle conflicts - "append", "replace", or "smart_merge" (default: "append")
 
 #### `penfield_list_contexts`
-List all saved checkpoints.
+List all saved context checkpoints.
 
 **Parameters:**
-- `session_id` (optional): Filter by session ID
 - `limit` (optional): Max results (default: 20, max: 100)
+- `offset` (optional): Number of results to skip for pagination (default: 0)
+- `name_pattern` (optional): Filter by name (case-insensitive substring match)
+- `include_descriptions` (optional): Include full descriptions (default: false)
 
 ### Analysis
 
@@ -243,9 +294,10 @@ List all saved checkpoints.
 Analyze memory patterns and generate insights.
 
 **Parameters:**
-- `time_window` (optional): Time window - "1d", "7d", "30d", or "90d" (default: "7d")
-- `focus_areas` (optional): Areas to analyze - "memory_usage", "relationships", "importance", "topics", "patterns"
-- `memory_types` (optional): Filter by memory types - "fact", "insight", "conversation", "correction", "reference", "task", "checkpoint", "identity_core", "personality_trait", "relationship", "strategy"
+- `time_window` (optional): Time period - "recent" (default), "today"/"1d", "week"/"7d", "month"/"30d", or "90d"
+- `start_date` (optional): Filter memories on or after this date (ISO 8601, e.g. "2025-01-01"). Overrides time_window.
+- `end_date` (optional): Filter memories on or before this date (ISO 8601, e.g. "2025-01-31"). Overrides time_window.
+- `include_documents` (optional): Include document chunks in analysis (default: false)
 
 ### Artifact Storage
 
@@ -348,6 +400,24 @@ await penfield_restore_context({
 });
 ```
 
+## Known Limitations
+
+### Memory flush only fires on auto-compaction
+
+OpenClaw's `memoryFlush` config only triggers when the context window fills up and auto-compaction kicks in. The following commands **bypass** memory flush entirely:
+
+- `/compact` — compacts immediately, no flush
+- `/new` — resets session, no flush
+- `/reset` — resets session, no flush
+
+This means context from shorter sessions (that never hit the auto-compaction threshold) won't be automatically saved to Penfield. To preserve important context before ending a session, tell your agent: *"Save this session to Penfield before we end."*
+
+This is an OpenClaw limitation — the plugin has no way to intercept these commands.
+
+### Auto-compaction threshold
+
+Auto-compaction triggers when token usage reaches approximately `contextWindow - reserveTokensFloor - softThresholdTokens`. With defaults (200K context, 20K reserve, 4K soft threshold), flush fires around 176K tokens (~88% full). You can tune `softThresholdTokens` in `agents.defaults.compaction` to trigger earlier.
+
 ## Development
 
 ### Setup
@@ -390,6 +460,7 @@ src/
 ├── config.ts                # Zod configuration schema with DEFAULT_AUTH_URL/DEFAULT_API_URL
 ├── types.ts                 # TypeScript type definitions (OpenClaw plugin API types)
 ├── types/typebox.ts         # Centralized TypeBox exports
+├── 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
 ├── runtime.ts               # Runtime factory (receives authService from index.ts)
@@ -418,7 +489,7 @@ src/
 
 ## Service Lifecycle
 
-The plugin uses two services registered with OpenClaw:
+The plugin uses two services and one hook registered with OpenClaw:
 
 1. **penfield-auth**: Background token refresh service
    - Started when plugin loads
@@ -429,6 +500,10 @@ The plugin uses two services registered with OpenClaw:
    - Manages runtime initialization
    - Handles cleanup on shutdown
 
+3. **before_agent_start hook**: Context injection
+   - Injects identity briefing + recent memories on every turn (cached)
+   - Checks memory flush config at startup and warns if not configured for Penfield
+
 ## API Endpoint Mapping
 
 | Tool | Method | Endpoint |
@@ -439,7 +514,7 @@ The plugin uses two services registered with OpenClaw:
 | explore | POST | /api/v2/relationships/traverse |
 | fetch | GET | /api/v2/memories/{id} |
 | list_artifacts | GET | /api/v2/artifacts/list |
-| list_contexts | GET | /api/v2/checkpoint |
+| list_contexts | GET | /api/v2/memories?memory_type=checkpoint |
 | recall | POST | /api/v2/search/hybrid |
 | reflect | POST | /api/v2/analysis/reflect |
 | restore_context | POST | /api/v2/checkpoint/{id}/recall |

package/dist/index.d.ts

@@ -19,6 +19,14 @@ declare const penfieldPlugin: {
                 label: string;
                 help: string;
             };
+            autoAwaken: {
+                label: string;
+                help: string;
+            };
+            autoOrient: {
+                label: string;
+                help: string;
+            };
         };
     };
     register(api: OpenClawPluginApi): void;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAK9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,QAAA,MAAM,cAAc;;;;;qBAMH,OAAO,GAAG,cAAc;;;;;;;;;;;;;;;;kBAuBzB,iBAAiB;CAkEhC,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAM9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,QAAA,MAAM,cAAc;;;;;qBAMH,OAAO,GAAG,cAAc;;;;;;;;;;;;;;;;;;;;;;;;kBA2BzB,iBAAiB;CAyEhC,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 import { DEFAULT_AUTH_URL, PenfieldConfigSchema } from "./src/config.js";
 import { createPenfieldRuntime } from "./src/runtime.js";
 import { registerPenfieldTools } from "./src/tools/index.js";
+import { registerPenfieldHooks, resetHookCaches } from "./src/hooks.js";
 import { registerLoginCommand } from "./src/cli.js";
 import { createAuthService } from "./src/auth-service.js";
 const penfieldPlugin = {
@@ -9,11 +10,7 @@ const penfieldPlugin = {
     description: "Native Penfield memory integration with 16 tools for knowledge management",
     configSchema: {
         parse(value) {
-            // Handle undefined/null when no config section exists
-            if (value === undefined || value === null) {
-                return {};
-            }
-            return PenfieldConfigSchema.parse(value);
+            return PenfieldConfigSchema.parse(value ?? {});
         },
         uiHints: {
             enabled: {
@@ -28,6 +25,14 @@ const penfieldPlugin = {
                 label: "API URL",
                 help: "Penfield API URL (default: https://api.penfield.app)",
             },
+            autoAwaken: {
+                label: "Auto-Awaken",
+                help: "Inject Penfield identity briefing on every agent turn (default: true)",
+            },
+            autoOrient: {
+                label: "Auto-Orient",
+                help: "Inject recent Penfield memory context on every agent turn (default: true)",
+            },
         },
     },
     register(api) {
@@ -52,6 +57,9 @@ const penfieldPlugin = {
                     config: cfg,
                     authService,
                     logger,
+                }).catch((err) => {
+                    runtimePromise = null;
+                    throw err;
                 });
             }
             runtime = await runtimePromise;
@@ -73,6 +81,8 @@ const penfieldPlugin = {
         });
         // Register all 16 tools
         registerPenfieldTools(api, ensureRuntime);
+        // Register lifecycle hooks (auto-awaken + auto-orient, injected every turn)
+        registerPenfieldHooks({ api, config: cfg, ensureRuntime, logger });
         // Register service for runtime lifecycle
         api.registerService({
             id: "penfield",
@@ -80,6 +90,7 @@ const penfieldPlugin = {
                 logger.info("[penfield] Service started");
             },
             async stop(_ctx) {
+                resetHookCaches();
                 if (runtime) {
                     await runtime.stop();
                     runtime = null;

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;IAuCP,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;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"}

package/dist/src/api-client.js

@@ -15,14 +15,30 @@ export class PenfieldApiClient {
             url += `?${params.toString()}`;
         }
         this.logger?.debug?.(`[penfield] ${method} ${endpoint}`);
-        const response = await fetch(url, {
-            method,
-            headers: {
-                Authorization: `Bearer ${token}`,
-                "Content-Type": "application/json",
-            },
-            body: body ? JSON.stringify(body) : undefined,
-        });
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), 30_000);
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    "Content-Type": "application/json",
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            if (err instanceof Error && err.name === "AbortError") {
+                const msg = `Request timed out after 30s: ${method} ${endpoint}`;
+                this.logger?.error?.(`[penfield] ${msg}`);
+                throw new Error(msg);
+            }
+            throw err;
+        }
+        clearTimeout(timeoutId);
         // Handle rate limiting
         if (response.status === 429) {
             const retryAfter = response.headers.get("Retry-After");

package/dist/src/auth-service.d.ts

@@ -1,7 +1,7 @@
 /**
  * Background authentication service for Penfield plugin
  *
- * Handles OAuth 2.0 token refresh silently in the background
+ * Handles OAuth 2.1 token refresh silently in the background
  * without agent involvement. Registered as an OpenClaw service.
  *
  * Supports RFC 8628 Device Code Flow and RFC 9700 Token Rotation.

package/dist/src/auth-service.js

@@ -1,7 +1,7 @@
 /**
  * Background authentication service for Penfield plugin
  *
- * Handles OAuth 2.0 token refresh silently in the background
+ * Handles OAuth 2.1 token refresh silently in the background
  * without agent involvement. Registered as an OpenClaw service.
  *
  * Supports RFC 8628 Device Code Flow and RFC 9700 Token Rotation.

package/dist/src/config.d.ts

@@ -5,12 +5,18 @@ export { DEFAULT_AUTH_URL, DEFAULT_API_URL };
 export declare const PenfieldConfigSchema: z.ZodObject<{
     authUrl: z.ZodOptional<z.ZodString>;
     apiUrl: z.ZodOptional<z.ZodString>;
+    autoAwaken: z.ZodDefault<z.ZodBoolean>;
+    autoOrient: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
+    autoAwaken: boolean;
+    autoOrient: boolean;
     authUrl?: string | undefined;
     apiUrl?: string | undefined;
 }, {
     authUrl?: string | undefined;
     apiUrl?: string | undefined;
+    autoAwaken?: boolean | undefined;
+    autoOrient?: boolean | undefined;
 }>;
 export type PenfieldConfig = z.infer<typeof PenfieldConfigSchema>;
 //# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,QAAA,MAAM,gBAAgB,QAA+D,CAAC;AACtF,QAAA,MAAM,eAAe,QAA6D,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAO7C,eAAO,MAAM,oBAAoB;;;;;;;;;EAGtB,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,QAAA,MAAM,gBAAgB,QAA+D,CAAC;AACtF,QAAA,MAAM,eAAe,QAA6D,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAO7C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAKtB,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/src/config.js

@@ -11,4 +11,6 @@ export { DEFAULT_AUTH_URL, DEFAULT_API_URL };
 export const PenfieldConfigSchema = z.object({
     authUrl: z.string().optional(),
     apiUrl: z.string().optional(),
+    autoAwaken: z.boolean().default(true),
+    autoOrient: z.boolean().default(true),
 }).strict();

package/dist/src/hooks.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Penfield lifecycle hooks for OpenClaw
+ *
+ * Hooks into OpenClaw's typed plugin hook system (api.on) to provide:
+ *   - Auto-awaken: inject identity briefing via prependContext
+ *   - Auto-orient: inject recent memory context via prependContext
+ *
+ * Uses before_agent_start hook (dispatched on every agent turn).
+ * prependContext is prepended to the system prompt (rebuilt each turn),
+ * so it does NOT accumulate in message history. This matches the pattern
+ * used by OpenClaw's own memory-lancedb plugin.
+ *
+ * Both the awaken briefing and recent context are cached to avoid
+ * redundant API calls on subsequent turns.
+ *
+ * Pre-compaction memory save is handled by OpenClaw's built-in memory flush,
+ * configured via agents.defaults.compaction.memoryFlush in openclaw.json.
+ */
+import type { PenfieldRuntime } from "./runtime.js";
+import type { PenfieldConfig } from "./config.js";
+import type { PluginLogger, OpenClawPluginApi } from "./types.js";
+/** Clear hook caches — called on plugin stop to prevent stale state across restarts */
+export declare function resetHookCaches(): void;
+export interface RegisterHooksParams {
+    api: OpenClawPluginApi;
+    config: PenfieldConfig;
+    ensureRuntime: () => Promise<PenfieldRuntime>;
+    logger: PluginLogger;
+}
+export declare function registerPenfieldHooks(params: RegisterHooksParams): void;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/src/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAmBpB,uFAAuF;AACvF,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAMD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,iBAAiB,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9C,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAQvE"}

package/dist/src/hooks.js

@@ -0,0 +1,180 @@
+/**
+ * Penfield lifecycle hooks for OpenClaw
+ *
+ * Hooks into OpenClaw's typed plugin hook system (api.on) to provide:
+ *   - Auto-awaken: inject identity briefing via prependContext
+ *   - Auto-orient: inject recent memory context via prependContext
+ *
+ * Uses before_agent_start hook (dispatched on every agent turn).
+ * prependContext is prepended to the system prompt (rebuilt each turn),
+ * so it does NOT accumulate in message history. This matches the pattern
+ * used by OpenClaw's own memory-lancedb plugin.
+ *
+ * Both the awaken briefing and recent context are cached to avoid
+ * redundant API calls on subsequent turns.
+ *
+ * Pre-compaction memory save is handled by OpenClaw's built-in memory flush,
+ * configured via agents.defaults.compaction.memoryFlush in openclaw.json.
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const AWAKEN_CACHE_TTL_MS = 30 * 60 * 1000; // 30 minutes
+const AWAKEN_MAX_CHARS = 30_000; // 30K char safety limit
+const REFLECT_MAX_CHARS = 30_000; // 30K char safety limit
+const REFLECT_CACHE_TTL_MS = 10 * 60 * 1000; // 10 minutes
+const REFLECT_RECENT_LIMIT = 20;
+// ---------------------------------------------------------------------------
+// Module-level state
+// ---------------------------------------------------------------------------
+let awakenCache = null;
+let reflectCache = null;
+/** Clear hook caches — called on plugin stop to prevent stale state across restarts */
+export function resetHookCaches() {
+    awakenCache = null;
+    reflectCache = null;
+}
+export function registerPenfieldHooks(params) {
+    const { api, config, ensureRuntime, logger } = params;
+    if (config.autoAwaken || config.autoOrient) {
+        registerBeforeAgentStartHook(api, config, ensureRuntime, logger);
+    }
+    checkMemoryFlushConfig(api, logger);
+}
+// ---------------------------------------------------------------------------
+// before_agent_start: awaken + orient (injected every turn, cached)
+// ---------------------------------------------------------------------------
+function registerBeforeAgentStartHook(api, config, ensureRuntime, logger) {
+    api.on("before_agent_start", async (_event, _ctx) => {
+        try {
+            let runtime;
+            try {
+                runtime = await ensureRuntime();
+            }
+            catch {
+                logger.debug?.("[penfield] runtime not ready, skipping hook");
+                return undefined;
+            }
+            // Fire awaken and reflect in parallel (both cached after first call)
+            const [briefing, recentContext] = await Promise.all([
+                config.autoAwaken ? fetchAwakenBriefing(runtime, logger) : null,
+                config.autoOrient ? fetchRecentContext(runtime, logger) : null,
+            ]);
+            const parts = [];
+            if (briefing) {
+                parts.push(`<penfield-identity>\n${briefing}\n</penfield-identity>`);
+            }
+            if (recentContext) {
+                parts.push(`<penfield-recent>\nRecent work context from Penfield:\n${recentContext}\n</penfield-recent>`);
+            }
+            if (parts.length === 0) {
+                return undefined;
+            }
+            return { prependContext: parts.join("\n\n") };
+        }
+        catch (err) {
+            logger.warn(`[penfield] before_agent_start hook failed: ${err instanceof Error ? err.message : String(err)}`);
+            return undefined;
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Awaken: fetch and cache identity briefing
+// ---------------------------------------------------------------------------
+async function fetchAwakenBriefing(runtime, logger) {
+    if (awakenCache && Date.now() - awakenCache.timestamp < AWAKEN_CACHE_TTL_MS) {
+        return awakenCache.briefing;
+    }
+    try {
+        const response = await runtime.apiClient.get("/api/v2/personality/awakening");
+        if (!response || typeof response !== "object") {
+            logger.warn(`[penfield] auto-awaken: unexpected response type: ${typeof response}`);
+            return null;
+        }
+        const briefing = response.briefing || "";
+        if (!briefing) {
+            logger.warn(`[penfield] auto-awaken: API returned empty briefing (keys: ${Object.keys(response).join(", ")})`);
+            return null;
+        }
+        if (briefing.length > AWAKEN_MAX_CHARS) {
+            logger.warn(`[penfield] auto-awaken: briefing exceeds size limit (${briefing.length} > ${AWAKEN_MAX_CHARS}), skipping`);
+            return null;
+        }
+        awakenCache = { briefing, timestamp: Date.now() };
+        logger.info(`[penfield] auto-awaken: identity briefing loaded (${briefing.length} chars)`);
+        return briefing;
+    }
+    catch (err) {
+        logger.warn(`[penfield] auto-awaken: failed to fetch briefing: ${err instanceof Error ? err.message : String(err)}`);
+        return awakenCache?.briefing ?? null;
+    }
+}
+async function fetchRecentContext(runtime, logger) {
+    if (reflectCache && Date.now() - reflectCache.timestamp < REFLECT_CACHE_TTL_MS) {
+        return reflectCache.context;
+    }
+    try {
+        const response = await runtime.apiClient.post("/api/v2/analysis/reflect", {
+            time_window: "recent",
+            max_memories: REFLECT_RECENT_LIMIT,
+        });
+        const memories = response.memories ?? [];
+        if (memories.length === 0) {
+            return null;
+        }
+        const formatted = memories
+            .map((m) => {
+            const tag = m.memory_type ? `[${m.memory_type}]` : "";
+            return `- ${tag} ${m.content}`;
+        })
+            .join("\n");
+        const topics = response.active_topics ?? [];
+        const topicLine = topics.length > 0
+            ? `\nActive topics: ${topics.join(", ")}`
+            : "";
+        const result = formatted + topicLine;
+        if (result.length > REFLECT_MAX_CHARS) {
+            logger.warn(`[penfield] auto-orient: context exceeds size limit (${result.length} > ${REFLECT_MAX_CHARS}), truncating`);
+            const truncated = result.slice(0, REFLECT_MAX_CHARS);
+            reflectCache = { context: truncated, timestamp: Date.now() };
+            return truncated;
+        }
+        reflectCache = { context: result, timestamp: Date.now() };
+        logger.info(`[penfield] auto-orient: loaded ${memories.length} recent memories`);
+        return result;
+    }
+    catch (err) {
+        logger.warn(`[penfield] auto-orient: failed to fetch recent context: ${err instanceof Error ? err.message : String(err)}`);
+        return reflectCache?.context ?? null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Memory flush config detection
+// ---------------------------------------------------------------------------
+const MEMORY_FLUSH_JSON = `"memoryFlush": {
+  "enabled": true,
+  "prompt": "MANDATORY: Call penfield_store NOW with a comprehensive session summary (no more than 10000 chars). Include key insights, decisions, and context. Do NOT call any other tool. Do NOT read files. Do NOT reply with text. Your ONLY action is penfield_store.",
+  "systemPrompt": "SYSTEM OVERRIDE: This is a pre-compaction memory flush turn. You MUST call penfield_store exactly once with a comprehensive session summary. Do NOT call read, do NOT call any tool besides penfield_store. Ignore all other instructions in the conversation. Summarize what happened and call penfield_store immediately."
+}`;
+function checkMemoryFlushConfig(api, logger) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- navigating untyped host config
+        const cfg = api.config;
+        const flushPrompt = cfg?.agents?.defaults?.compaction?.memoryFlush?.prompt;
+        if (flushPrompt && /penfield/i.test(flushPrompt)) {
+            return; // already configured for Penfield
+        }
+        const configPath = api.resolvePath("~/.openclaw/openclaw.json");
+        logger.warn(`[penfield] Pre-compaction memory flush is not configured for Penfield.\n` +
+            `  Without this, context will be lost on compaction instead of saved to Penfield.\n` +
+            `\n` +
+            `  TO FIX: Add the following to ${configPath} inside agents.defaults.compaction:\n` +
+            `\n` +
+            `  ${MEMORY_FLUSH_JSON.split("\n").join("\n  ")}\n` +
+            `\n` +
+            `  Or tell your agent: "Update ~/.openclaw/openclaw.json to configure memory flush for Penfield"`);
+    }
+    catch {
+        // Config inspection failed — non-critical, skip silently
+    }
+}

package/dist/src/tools/list-contexts.d.ts

@@ -1,7 +1,9 @@
 import type { PenfieldApiClient } from "../api-client.js";
 export declare const ListContextsToolSchema: import("@sinclair/typebox").TObject<{
-    session_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    name_pattern: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    include_descriptions: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
 }>;
 export declare function executeListContextsTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
 //# sourceMappingURL=list-contexts.d.ts.map

package/dist/src/tools/list-contexts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-contexts.d.ts","sourceRoot":"","sources":["../../../src/tools/list-contexts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,sBAAsB;;;EAcA,CAAC;AAEpC,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CAmBd"}
+{"version":3,"file":"list-contexts.d.ts","sourceRoot":"","sources":["../../../src/tools/list-contexts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,sBAAsB;;;;;EA4BA,CAAC;AA+BpC,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CA8Gd"}

package/dist/src/tools/list-contexts.js

@@ -1,32 +1,120 @@
 import { Type } from "../types/typebox.js";
 export const ListContextsToolSchema = Type.Object({
-    session_id: Type.Optional(Type.String({
-        description: "Filter by session ID",
-    })),
     limit: Type.Optional(Type.Number({
-        description: "Max results (default: 20, max: 100)",
+        description: "Max results to return (default: 20, max: 100)",
         minimum: 1,
         maximum: 100,
         default: 20,
     })),
+    offset: Type.Optional(Type.Number({
+        description: "Number of results to skip for pagination (default: 0)",
+        minimum: 0,
+        default: 0,
+    })),
+    name_pattern: Type.Optional(Type.String({
+        description: "Filter contexts by name (case-insensitive substring match)",
+    })),
+    include_descriptions: Type.Optional(Type.Boolean({
+        description: "Include full descriptions in output (default: false for compact listing)",
+    })),
 }, { additionalProperties: false });
 export async function executeListContextsTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
 ) {
-    const queryParams = {};
-    if (params.session_id) {
-        queryParams.session_id = params.session_id;
+    const limit = params.limit || 20;
+    const offset = params.offset || 0;
+    const namePattern = params.name_pattern;
+    const lowerPattern = namePattern?.toLowerCase();
+    const includeDescriptions = params.include_descriptions;
+    // Without name_pattern: use API-side pagination directly (no cap)
+    // With name_pattern: fetch in bulk for client-side filtering
+    const queryParams = { memory_type: "checkpoint" };
+    if (!namePattern) {
+        // Translate offset/limit to page/per_page
+        const page = Math.floor(offset / limit) + 1;
+        queryParams.per_page = String(limit);
+        queryParams.page = String(page);
     }
-    if (params.limit) {
-        queryParams.limit = String(params.limit);
+    else {
+        // Fetch enough to cover filtering + pagination headroom
+        queryParams.per_page = String(Math.min(limit + offset + 50, 250));
     }
-    const response = await apiClient.get("/api/v2/checkpoint", queryParams);
+    const response = await apiClient.get("/api/v2/memories", queryParams);
+    const items = response.items ?? [];
+    const contexts = [];
+    for (const mem of items) {
+        // Extract checkpoint name from metadata (preferred) or content JSON (legacy)
+        let name = mem.metadata?.checkpoint_name;
+        let memoryCount = mem.metadata?.memory_count ?? 0;
+        let description;
+        if (!name) {
+            try {
+                const parsed = JSON.parse(mem.content);
+                name = parsed.checkpoint_name;
+                memoryCount = parsed.memory_count ?? memoryCount;
+                description = parsed.description;
+            }
+            catch {
+                // Legacy format without JSON — use content as-is
+                name = undefined;
+            }
+        }
+        else if (includeDescriptions) {
+            try {
+                const parsed = JSON.parse(mem.content);
+                description = parsed.description;
+            }
+            catch {
+                // Content not JSON — no description available
+            }
+        }
+        // Apply name_pattern filter (case-insensitive substring)
+        if (lowerPattern) {
+            const haystack = (name ?? "").toLowerCase();
+            if (!haystack.includes(lowerPattern)) {
+                continue;
+            }
+        }
+        const entry = {
+            id: mem.id,
+            name: name ?? "(unnamed)",
+            memory_count: memoryCount,
+            created: mem.created_at,
+        };
+        if (includeDescriptions && description) {
+            entry.description = description;
+        }
+        contexts.push(entry);
+    }
+    // Pagination: API-side when no filter, client-side when filtering
+    const apiTotal = response.pagination?.total ?? 0;
+    let paged;
+    let total;
+    if (!namePattern) {
+        // API already paginated — trim misaligned leading items
+        const skip = offset % limit;
+        paged = skip > 0 ? contexts.slice(skip) : contexts;
+        total = apiTotal;
+    }
+    else {
+        // Client-side pagination on filtered results
+        total = contexts.length;
+        paged = contexts.slice(offset, offset + limit);
+    }
+    const result = {
+        success: true,
+        contexts: paged,
+        total,
+        limit,
+        offset,
+        has_more: total > offset + paged.length,
+    };
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify(response, null, 2),
+                text: JSON.stringify(result, null, 2),
             },
         ],
-        details: response,
+        details: result,
     };
 }

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

@@ -1,8 +1,9 @@
 import type { PenfieldApiClient } from "../api-client.js";
 export declare const ReflectToolSchema: import("@sinclair/typebox").TObject<{
-    time_window: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"1d">, import("@sinclair/typebox").TLiteral<"7d">, import("@sinclair/typebox").TLiteral<"30d">, import("@sinclair/typebox").TLiteral<"90d">]>>;
-    focus_areas: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"memory_usage">, import("@sinclair/typebox").TLiteral<"relationships">, import("@sinclair/typebox").TLiteral<"importance">, import("@sinclair/typebox").TLiteral<"topics">, import("@sinclair/typebox").TLiteral<"patterns">]>>>;
-    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">]>>>;
+    time_window: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"recent">, import("@sinclair/typebox").TLiteral<"today">, import("@sinclair/typebox").TLiteral<"week">, import("@sinclair/typebox").TLiteral<"month">, import("@sinclair/typebox").TLiteral<"1d">, import("@sinclair/typebox").TLiteral<"7d">, import("@sinclair/typebox").TLiteral<"30d">, import("@sinclair/typebox").TLiteral<"90d">]>>;
+    start_date: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    end_date: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    include_documents: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
 }>;
 export declare function executeReflectTool(apiClient: PenfieldApiClient, params: unknown): Promise<any>;
 //# sourceMappingURL=reflect.d.ts.map

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;;;;EAoCK,CAAC;AAEpC,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,GAAG,CAAC,CAWd"}
+{"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"}

package/dist/src/tools/reflect.js

@@ -1,31 +1,52 @@
-import { Type, MemoryTypeSchema } from "../types/typebox.js";
+import { Type } from "../types/typebox.js";
 export const ReflectToolSchema = Type.Object({
     time_window: Type.Optional(Type.Union([
+        Type.Literal("recent"),
+        Type.Literal("today"),
+        Type.Literal("week"),
+        Type.Literal("month"),
         Type.Literal("1d"),
         Type.Literal("7d"),
         Type.Literal("30d"),
         Type.Literal("90d"),
     ], {
-        description: "Time period to analyze. Defaults to last 7 days.",
-        examples: ["7d", "30d"],
+        description: 'Time period to analyze: "recent" (default, no time cutoff), "today"/"1d", "week"/"7d", "month"/"30d", or "90d".',
+        examples: ["recent", "week", "30d"],
     })),
-    focus_areas: Type.Optional(Type.Array(Type.Union([
-        Type.Literal("memory_usage"),
-        Type.Literal("relationships"),
-        Type.Literal("importance"),
-        Type.Literal("topics"),
-        Type.Literal("patterns"),
-    ]), {
-        description: "Areas to focus analysis on. Omit for full analysis.",
-        examples: [["memory_usage", "relationships"], ["topics"]],
+    start_date: Type.Optional(Type.String({
+        description: "Filter memories created on or after this date (ISO 8601, e.g. '2025-01-01'). Overrides time_window when set.",
+        examples: ["2025-01-01"],
     })),
-    memory_types: Type.Optional(Type.Array(MemoryTypeSchema, {
-        description: "Filter by memory types. Defaults to all types.",
-        examples: [["fact", "insight"], ["identity_core", "personality_trait"]],
+    end_date: Type.Optional(Type.String({
+        description: "Filter memories created on or before this date (ISO 8601, e.g. '2025-01-31'). Overrides time_window when set.",
+        examples: ["2025-01-31"],
+    })),
+    include_documents: Type.Optional(Type.Boolean({
+        description: "Include document chunks in analysis. Default false (only user-created memories).",
     })),
 }, { additionalProperties: false });
+/** Map shorthand aliases to API-native time_window values */
+const TIME_WINDOW_ALIASES = {
+    "1d": "today",
+    "7d": "week",
+    "30d": "month",
+};
 export async function executeReflectTool(apiClient, params) {
-    const response = await apiClient.post("/api/v2/analysis/reflect", params);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- params validated by schema
+    const p = { ...params };
+    if (p.time_window === "90d") {
+        // API has no 90d window — convert to explicit date range (matches MCP behavior)
+        if (!p.start_date) {
+            const d = new Date();
+            d.setDate(d.getDate() - 90);
+            p.start_date = d.toISOString().slice(0, 10);
+        }
+        p.time_window = "recent";
+    }
+    else if (p.time_window && p.time_window in TIME_WINDOW_ALIASES) {
+        p.time_window = TIME_WINDOW_ALIASES[p.time_window];
+    }
+    const response = await apiClient.post("/api/v2/analysis/reflect", p);
     return {
         content: [
             {

package/dist/src/types.d.ts

@@ -40,6 +40,16 @@ export interface OpenClawPluginCliContext {
     workspaceDir?: string;
     logger: PluginLogger;
 }
+/** Event for before_agent_start hook */
+export interface PluginHookBeforeAgentStartEvent {
+    prompt: string;
+    messages?: unknown[];
+}
+/** Result for before_agent_start hook — prependContext is injected before the agent prompt */
+export interface PluginHookBeforeAgentStartResult {
+    systemPrompt?: string;
+    prependContext?: string;
+}
 export interface OpenClawPluginApi {
     /** Plugin identifier */
     id: string;
@@ -77,6 +87,10 @@ export interface OpenClawPluginApi {
     }): void;
     /** Register service lifecycle */
     registerService(service: OpenClawPluginService): void;
+    /** Register a typed plugin lifecycle hook (always available, no config gate) */
+    on(hookName: string, handler: (...args: any[]) => any, opts?: {
+        priority?: number;
+    }): void;
     /** Runtime context */
     runtime?: {
         prompter?: {

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAClC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;IACrC,MAAM,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;IAC5C,WAAW,CACT,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,EACvD,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,CAAC,GAC3C,UAAU,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,CAAC,GAAG,EAAE,4BAA4B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,4BAA4B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC,wCAAwC;IACxC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnC,sBAAsB;IACtB,MAAM,EAAE,YAAY,CAAC;IAErB,4BAA4B;IAC5B,WAAW,CACT,EAAE,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC3D,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC7B,IAAI,CAAC;IAER,sBAAsB;IACtB,YAAY,CACV,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KACnE,EACD,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7D,IAAI,CAAC;IAER,iCAAiC;IACjC,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAEtD,sBAAsB;IACtB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE;YACT,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;YACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;SAC1B,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1C,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/openclaw.plugin.json

@@ -6,7 +6,9 @@
     "additionalProperties": false,
     "properties": {
       "authUrl": { "type": "string" },
-      "apiUrl": { "type": "string" }
+      "apiUrl": { "type": "string" },
+      "autoAwaken": { "type": "boolean", "default": true },
+      "autoOrient": { "type": "boolean", "default": true }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-penfield",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "type": "module",
   "description": "Native OpenClaw plugin for Penfield memory integration",
   "main": "dist/index.js",
@@ -39,16 +39,15 @@
   },
   "devDependencies": {
     "@types/node": "^25.0.9",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "eslint": "^8.56.0",
+    "eslint": "^9.39.2",
     "prettier": "^3.2.5",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "typescript-eslint": "^8.54.0"
   },
   "scripts": {
     "build": "tsc",
-    "lint": "eslint . --ext .ts",
-    "lint:fix": "eslint . --ext .ts --fix",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "format": "prettier --write \"**/*.{ts,json,md}\"",
     "format:check": "prettier --check \"**/*.{ts,json,md}\"",
     "typecheck": "tsc --noEmit"