clawdbot-penfield 1.0.1 → 1.0.2

package/README.md

@@ -38,14 +38,14 @@ Penfield is in **free beta**. Sign up for access:
 
 Native Clawdbot 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**: Complete 1:1 feature parity with Penfield MCP server
+- **16 Memory Tools**
 - **OAuth Device Code Flow**: Secure authentication following RFC 8628
-- **Automatic Token Refresh**: Transparent token management with 240-minute expiry buffer
 - **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
 
@@ -67,35 +67,6 @@ clawdbot plugins install -l .
 
 The plugin is **auto-enabled when loaded**. No configuration required for production use.
 
-**Default URLs (production):**
-- API: `https://api.penfield.app`
-- Auth: `https://auth.penfield.app`
-
-**Override with environment variables (for development):**
-
-```bash
-export PENFIELD_API_URL="https://api-dev.penfield.app"
-export PENFIELD_AUTH_URL="https://auth-dev.penfield.app"
-```
-
-**Or with config in `~/.clawdbot/clawdbot.json`:**
-
-```json
-{
-  "plugins": {
-    "entries": {
-      "penfield": {
-        "enabled": true,
-        "config": {
-          "apiUrl": "https://api-dev.penfield.app",
-          "authUrl": "https://auth-dev.penfield.app"
-        }
-      }
-    }
-  }
-}
-```
-
 ## Authentication
 
 The plugin uses OAuth 2.0 Device Code Flow (RFC 8628) with automatic token refresh.
@@ -125,7 +96,7 @@ This will:
 }
 ```
 
-Location: `~/.clawdbot/extensions/penfield/credentials.json`
+Location: `~/.clawdbot/extensions/clawdbot-penfield/credentials.json`
 File permissions: `0o600` (owner-only read/write)
 
 ## Available Tools

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

@@ -28,6 +28,7 @@ interface AuthServiceOptions {
     clientId?: string;
 }
 export declare function createAuthService(api: {
+    id: string;
     logger: Logger;
     resolvePath: (path: string) => string;
 }, options: AuthServiceOptions): AuthService;

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

@@ -1 +1 @@
-{"version":3,"file":"auth-service.d.ts","sourceRoot":"","sources":["../../src/auth-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAKzC,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,mCAAmC;IACnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,qDAAqD;IACrD,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,oDAAoD;IACpD,eAAe,IAAI,OAAO,CAAC;CAC5B;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,EAC9D,OAAO,EAAE,kBAAkB,GAC1B,WAAW,CAsMb"}
+{"version":3,"file":"auth-service.d.ts","sourceRoot":"","sources":["../../src/auth-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAKzC,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,mCAAmC;IACnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,qDAAqD;IACrD,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,oDAAoD;IACpD,eAAe,IAAI,OAAO,CAAC;CAC5B;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,EAC1E,OAAO,EAAE,kBAAkB,GAC1B,WAAW,CAsMb"}

package/dist/src/store.d.ts

@@ -1,13 +1,22 @@
 /**
  * File-based credential storage for Penfield plugin
  *
- * Credentials are stored at: ~/.clawdbot/extensions/penfield/credentials.json
+ * Credentials are stored at: ~/.clawdbot/extensions/{pluginId}/credentials.json
  * Directory permissions: 0o700 (only owner can access)
  * File permissions: 0o600 (only owner can read/write)
+ *
+ * The path is derived from the plugin ID, so credentials follow the plugin
+ * installation automatically (future-proofing for potential folder renames).
  */
-export declare const CRED_DIR = "~/.clawdbot/extensions/penfield";
-export declare const CRED_FILE = "~/.clawdbot/extensions/penfield/credentials.json";
 export declare const TOKEN_EXPIRY_BUFFER_MS: number;
+/**
+ * Get credential directory path for the plugin
+ */
+export declare function getCredDir(pluginId: string): string;
+/**
+ * Get credential file path for the plugin
+ */
+export declare function getCredFile(pluginId: string): string;
 export interface CredentialFile {
     version: number;
     clientId: string;
@@ -20,6 +29,7 @@ export interface CredentialFile {
  * Save credentials to file with schema versioning
  */
 export declare function saveCredential(api: {
+    id: string;
     resolvePath(path: string): string;
     logger?: {
         info(...args: unknown[]): void;
@@ -32,18 +42,21 @@ export declare function saveCredential(api: {
  * Returns null if file doesn't exist or is corrupted
  */
 export declare function loadCredential(api: {
+    id: string;
     resolvePath(path: string): string;
 }): CredentialFile | null;
 /**
  * Check if we have valid (non-expired) credentials
  */
 export declare function hasValidCredentials(api: {
+    id: string;
     resolvePath(path: string): string;
 }): boolean;
 /**
  * Get refresh token if available
  */
 export declare function getRefreshToken(api: {
+    id: string;
     resolvePath(path: string): string;
 }): string | null;
 //# sourceMappingURL=store.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,eAAO,MAAM,QAAQ,oCAAoC,CAAC;AAC1D,eAAO,MAAM,SAAS,qDAAiC,CAAC;AAGxD,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE;IAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,EACxJ,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,WAAW,CAAC,GAClD,IAAI,CAiBN;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE;IAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACzC,cAAc,GAAG,IAAI,CAevB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE;IAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACzC,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE;IAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACzC,MAAM,GAAG,IAAI,CAGf"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,EACpK,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,WAAW,CAAC,GAClD,IAAI,CAiBN;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACrD,cAAc,GAAG,IAAI,CAevB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACrD,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACrD,MAAM,GAAG,IAAI,CAGf"}

package/dist/src/store.js

@@ -1,22 +1,34 @@
 /**
  * File-based credential storage for Penfield plugin
  *
- * Credentials are stored at: ~/.clawdbot/extensions/penfield/credentials.json
+ * Credentials are stored at: ~/.clawdbot/extensions/{pluginId}/credentials.json
  * Directory permissions: 0o700 (only owner can access)
  * File permissions: 0o600 (only owner can read/write)
+ *
+ * The path is derived from the plugin ID, so credentials follow the plugin
+ * installation automatically (future-proofing for potential folder renames).
  */
 import * as fs from 'fs';
-// Credential storage paths
-export const CRED_DIR = '~/.clawdbot/extensions/penfield';
-export const CRED_FILE = `${CRED_DIR}/credentials.json`;
 // Token buffer: refresh if token expires within 240 minutes (4 hours)
 export const TOKEN_EXPIRY_BUFFER_MS = 240 * 60 * 1000;
+/**
+ * Get credential directory path for the plugin
+ */
+export function getCredDir(pluginId) {
+    return `~/.clawdbot/extensions/${pluginId}`;
+}
+/**
+ * Get credential file path for the plugin
+ */
+export function getCredFile(pluginId) {
+    return `${getCredDir(pluginId)}/credentials.json`;
+}
 /**
  * Save credentials to file with schema versioning
  */
 export function saveCredential(api, cred) {
-    const dirPath = api.resolvePath(CRED_DIR);
-    const filePath = api.resolvePath(CRED_FILE);
+    const dirPath = api.resolvePath(getCredDir(api.id));
+    const filePath = api.resolvePath(getCredFile(api.id));
     const content = {
         version: 1,
         ...cred,
@@ -34,7 +46,7 @@ export function saveCredential(api, cred) {
  * Returns null if file doesn't exist or is corrupted
  */
 export function loadCredential(api) {
-    const filePath = api.resolvePath(CRED_FILE);
+    const filePath = api.resolvePath(getCredFile(api.id));
     try {
         const raw = fs.readFileSync(filePath, 'utf8');
         const content = JSON.parse(raw);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawdbot-penfield",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "type": "module",
   "description": "Native Clawdbot plugin for Penfield memory integration",
   "main": "dist/index.js",