@agenticmail/openclaw 0.5.41 → 0.5.42

package/README.md

@@ -364,6 +364,38 @@ The plugin registers three OpenClaw lifecycle hooks:
 
 ---
 
+## Troubleshooting
+
+### Plugin ID mismatch warning
+
+```
+plugins.entries.agenticmail: plugin agenticmail: plugin id mismatch
+(manifest uses "agenticmail", entry hints "openclaw")
+```
+
+This is a harmless warning. OpenClaw infers the expected plugin ID from the npm package name (`@agenticmail/openclaw`) and sees "openclaw", but the plugin manifest declares its ID as `"agenticmail"`. The plugin loads and works correctly — you can safely ignore this warning.
+
+### Plugin path not found
+
+```
+plugins.load.paths: plugin: plugin path not found: /Users/you/node_modules/@agenticmail/openclaw
+```
+
+This means the `plugins.load.paths` entry in your `~/.openclaw/openclaw.json` points to a location where the plugin isn't installed. Find the actual path:
+
+```bash
+# If installed globally
+npm prefix -g
+# Plugin will be at: <prefix>/lib/node_modules/@agenticmail/openclaw
+
+# Or search for it
+find / -name "openclaw.plugin.json" -path "*@agenticmail*" 2>/dev/null
+```
+
+Then update the path in `~/.openclaw/openclaw.json` under `plugins.load.paths`.
+
+---
+
 ## License
 
 [MIT](./LICENSE) - Ope Olatunji ([@ope-olatunji](https://github.com/ope-olatunji))

package/dist/index.cjs

@@ -2188,6 +2188,154 @@ The agent must have browser access and a Google Voice session (logged into Googl
       }
     }
   });
+  reg("agenticmail_storage", {
+    description: `Full database management for agents. Create/alter/drop tables, CRUD rows, manage indexes, run aggregations, import/export data, execute raw SQL, optimize & analyze \u2014 all on whatever database the user deployed (SQLite, Postgres, MySQL, Turso).
+
+Tables are sandboxed per-agent (agt_ prefix) or shared (shared_ prefix). Column types: text, integer, real, boolean, json, blob, timestamp. Auto-adds id + timestamps by default.
+
+WHERE filters support operators: {column: value} for equality, {column: {$gt: 5, $lt: 10}} for comparisons, {column: {$like: "%foo%"}} for pattern matching, {column: {$in: [1,2,3]}} for IN, {column: {$between: [lo, hi]}} for ranges, {column: {$is_null: true}} for null checks. Also: $gte, $lte, $ne, $ilike, $not_like, $not_in.`,
+    parameters: {
+      action: { type: "string", required: true, description: "create_table, list_tables, describe_table, insert, upsert, query, aggregate, update, delete_rows, truncate, drop_table, clone_table, rename_table, rename_column, add_column, drop_column, create_index, list_indexes, drop_index, reindex, archive_table, unarchive_table, export, import, sql, stats, vacuum, analyze, explain" },
+      table: { type: "string", description: "Table name (display name or internal prefixed name)" },
+      description: { type: "string", description: "For create_table: human-readable description" },
+      columns: { type: "array", description: "For create_table: [{name, type, required?, default?, unique?, primaryKey?, references?: {table, column, onDelete?}, check?}]" },
+      indexes: { type: "array", description: "For create_table/create_index: [{columns: string[], unique?: boolean, name?: string, where?: string}]" },
+      shared: { type: "boolean", description: "For create_table: accessible by all agents (default: false)" },
+      timestamps: { type: "boolean", description: "For create_table: auto-add created_at/updated_at (default: true)" },
+      rows: { type: "array", description: "For insert/upsert/import: array of row objects" },
+      where: { type: "object", description: "For query/update/delete_rows/export: filter conditions. Supports operators: {$gt, $gte, $lt, $lte, $ne, $like, $ilike, $not_like, $in, $not_in, $is_null, $between}" },
+      set: { type: "object", description: "For update: {column: newValue}" },
+      orderBy: { type: "string", description: "For query: ORDER BY clause" },
+      limit: { type: "number", description: "For query/export: max rows" },
+      offset: { type: "number", description: "For query: skip N rows" },
+      selectColumns: { type: "array", description: "For query: specific columns to select" },
+      distinct: { type: "boolean", description: "For query: SELECT DISTINCT" },
+      groupBy: { type: "string", description: "For query/aggregate: GROUP BY clause" },
+      having: { type: "string", description: "For query: HAVING clause" },
+      operations: { type: "array", description: 'For aggregate: [{fn: "count"|"sum"|"avg"|"min"|"max"|"count_distinct", column?, alias?}]' },
+      column: { type: "object", description: "For add_column: {name, type, required?, default?, references?, check?}" },
+      columnName: { type: "string", description: "For drop_column: column name to drop" },
+      indexName: { type: "string", description: "For drop_index: index name" },
+      indexColumns: { type: "array", description: "For create_index: column names" },
+      indexUnique: { type: "boolean", description: "For create_index: unique index" },
+      indexWhere: { type: "string", description: "For create_index: partial index condition" },
+      newName: { type: "string", description: "For rename_table/rename_column: new name" },
+      oldName: { type: "string", description: "For rename_column: old column name" },
+      conflictColumn: { type: "string", description: "For upsert/import: column to detect conflicts on" },
+      onConflict: { type: "string", description: 'For import: "skip"|"replace"|"error"' },
+      includeData: { type: "boolean", description: "For clone_table: include data (default: true)" },
+      format: { type: "string", description: 'For export: "json"|"csv"' },
+      sql: { type: "string", description: "For sql/explain: raw SQL query" },
+      params: { type: "array", description: "For sql/explain: query parameters" },
+      includeShared: { type: "boolean", description: "For list_tables: include shared (default: true)" },
+      includeArchived: { type: "boolean", description: "For list_tables: include archived" }
+    },
+    handler: async (params) => {
+      try {
+        const c = await ctxForParams(ctx, params);
+        const action = params.action;
+        const tbl = params.table ? encodeURIComponent(params.table) : "";
+        switch (action) {
+          // ── DDL: Schema Definition ──
+          case "create_table":
+            return await apiRequest(c, "POST", "/storage/tables", {
+              name: params.table,
+              columns: params.columns,
+              indexes: params.indexes,
+              shared: params.shared,
+              description: params.description,
+              timestamps: params.timestamps
+            });
+          case "list_tables":
+            return await apiRequest(c, "GET", `/storage/tables?includeShared=${params.includeShared !== false}&includeArchived=${params.includeArchived === true}`);
+          case "describe_table":
+            return await apiRequest(c, "GET", `/storage/tables/${tbl}/describe`);
+          case "add_column":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/columns`, { column: params.column });
+          case "drop_column":
+            return await apiRequest(c, "DELETE", `/storage/tables/${tbl}/columns/${encodeURIComponent(params.columnName)}`);
+          case "rename_table":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/rename`, { newName: params.newName });
+          case "rename_column":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/rename-column`, { oldName: params.oldName, newName: params.newName });
+          case "drop_table":
+            return await apiRequest(c, "DELETE", `/storage/tables/${tbl}`);
+          case "clone_table":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/clone`, { newName: params.newName, includeData: params.includeData });
+          case "truncate":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/truncate`);
+          // ── Index Management ──
+          case "create_index":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/indexes`, {
+              columns: params.indexColumns || params.columns,
+              unique: params.indexUnique,
+              name: params.indexName,
+              where: params.indexWhere
+            });
+          case "list_indexes":
+            return await apiRequest(c, "GET", `/storage/tables/${tbl}/indexes`);
+          case "drop_index":
+            return await apiRequest(c, "DELETE", `/storage/tables/${tbl}/indexes/${encodeURIComponent(params.indexName)}`);
+          case "reindex":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/reindex`);
+          // ── DML: Data Manipulation ──
+          case "insert":
+            return await apiRequest(c, "POST", "/storage/insert", { table: params.table, rows: params.rows });
+          case "upsert":
+            return await apiRequest(c, "POST", "/storage/upsert", { table: params.table, rows: params.rows, conflictColumn: params.conflictColumn });
+          case "query":
+            return await apiRequest(c, "POST", "/storage/query", {
+              table: params.table,
+              where: params.where,
+              orderBy: params.orderBy,
+              limit: params.limit,
+              offset: params.offset,
+              columns: params.selectColumns,
+              distinct: params.distinct,
+              groupBy: params.groupBy,
+              having: params.having
+            });
+          case "aggregate":
+            return await apiRequest(c, "POST", "/storage/aggregate", {
+              table: params.table,
+              where: params.where,
+              operations: params.operations,
+              groupBy: params.groupBy
+            });
+          case "update":
+            return await apiRequest(c, "POST", "/storage/update", { table: params.table, where: params.where, set: params.set });
+          case "delete_rows":
+            return await apiRequest(c, "POST", "/storage/delete-rows", { table: params.table, where: params.where });
+          // ── Archive & Lifecycle ──
+          case "archive_table":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/archive`);
+          case "unarchive_table":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/unarchive`);
+          // ── Import / Export ──
+          case "export":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/export`, { format: params.format, where: params.where, limit: params.limit });
+          case "import":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/import`, { rows: params.rows, onConflict: params.onConflict, conflictColumn: params.conflictColumn });
+          // ── Raw SQL ──
+          case "sql":
+            return await apiRequest(c, "POST", "/storage/sql", { sql: params.sql, params: params.params });
+          case "explain":
+            return await apiRequest(c, "POST", "/storage/explain", { sql: params.sql, params: params.params });
+          // ── Maintenance ──
+          case "stats":
+            return await apiRequest(c, "GET", "/storage/stats");
+          case "vacuum":
+            return await apiRequest(c, "POST", "/storage/vacuum");
+          case "analyze":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/analyze`);
+          default:
+            return { error: `Unknown action "${action}". Valid actions: create_table, list_tables, describe_table, insert, upsert, query, aggregate, update, delete_rows, truncate, drop_table, clone_table, rename_table, rename_column, add_column, drop_column, create_index, list_indexes, drop_index, reindex, archive_table, unarchive_table, export, import, sql, stats, vacuum, analyze, explain` };
+        }
+      } catch (err) {
+        return { success: false, error: err.message };
+      }
+    }
+  });
   reg("agenticmail_sms_config", {
     description: "Get the current SMS/phone number configuration for this agent. Shows whether SMS is enabled, the phone number, and forwarding email.",
     parameters: {},

package/dist/index.js

@@ -2152,6 +2152,154 @@ The agent must have browser access and a Google Voice session (logged into Googl
       }
     }
   });
+  reg("agenticmail_storage", {
+    description: `Full database management for agents. Create/alter/drop tables, CRUD rows, manage indexes, run aggregations, import/export data, execute raw SQL, optimize & analyze \u2014 all on whatever database the user deployed (SQLite, Postgres, MySQL, Turso).
+
+Tables are sandboxed per-agent (agt_ prefix) or shared (shared_ prefix). Column types: text, integer, real, boolean, json, blob, timestamp. Auto-adds id + timestamps by default.
+
+WHERE filters support operators: {column: value} for equality, {column: {$gt: 5, $lt: 10}} for comparisons, {column: {$like: "%foo%"}} for pattern matching, {column: {$in: [1,2,3]}} for IN, {column: {$between: [lo, hi]}} for ranges, {column: {$is_null: true}} for null checks. Also: $gte, $lte, $ne, $ilike, $not_like, $not_in.`,
+    parameters: {
+      action: { type: "string", required: true, description: "create_table, list_tables, describe_table, insert, upsert, query, aggregate, update, delete_rows, truncate, drop_table, clone_table, rename_table, rename_column, add_column, drop_column, create_index, list_indexes, drop_index, reindex, archive_table, unarchive_table, export, import, sql, stats, vacuum, analyze, explain" },
+      table: { type: "string", description: "Table name (display name or internal prefixed name)" },
+      description: { type: "string", description: "For create_table: human-readable description" },
+      columns: { type: "array", description: "For create_table: [{name, type, required?, default?, unique?, primaryKey?, references?: {table, column, onDelete?}, check?}]" },
+      indexes: { type: "array", description: "For create_table/create_index: [{columns: string[], unique?: boolean, name?: string, where?: string}]" },
+      shared: { type: "boolean", description: "For create_table: accessible by all agents (default: false)" },
+      timestamps: { type: "boolean", description: "For create_table: auto-add created_at/updated_at (default: true)" },
+      rows: { type: "array", description: "For insert/upsert/import: array of row objects" },
+      where: { type: "object", description: "For query/update/delete_rows/export: filter conditions. Supports operators: {$gt, $gte, $lt, $lte, $ne, $like, $ilike, $not_like, $in, $not_in, $is_null, $between}" },
+      set: { type: "object", description: "For update: {column: newValue}" },
+      orderBy: { type: "string", description: "For query: ORDER BY clause" },
+      limit: { type: "number", description: "For query/export: max rows" },
+      offset: { type: "number", description: "For query: skip N rows" },
+      selectColumns: { type: "array", description: "For query: specific columns to select" },
+      distinct: { type: "boolean", description: "For query: SELECT DISTINCT" },
+      groupBy: { type: "string", description: "For query/aggregate: GROUP BY clause" },
+      having: { type: "string", description: "For query: HAVING clause" },
+      operations: { type: "array", description: 'For aggregate: [{fn: "count"|"sum"|"avg"|"min"|"max"|"count_distinct", column?, alias?}]' },
+      column: { type: "object", description: "For add_column: {name, type, required?, default?, references?, check?}" },
+      columnName: { type: "string", description: "For drop_column: column name to drop" },
+      indexName: { type: "string", description: "For drop_index: index name" },
+      indexColumns: { type: "array", description: "For create_index: column names" },
+      indexUnique: { type: "boolean", description: "For create_index: unique index" },
+      indexWhere: { type: "string", description: "For create_index: partial index condition" },
+      newName: { type: "string", description: "For rename_table/rename_column: new name" },
+      oldName: { type: "string", description: "For rename_column: old column name" },
+      conflictColumn: { type: "string", description: "For upsert/import: column to detect conflicts on" },
+      onConflict: { type: "string", description: 'For import: "skip"|"replace"|"error"' },
+      includeData: { type: "boolean", description: "For clone_table: include data (default: true)" },
+      format: { type: "string", description: 'For export: "json"|"csv"' },
+      sql: { type: "string", description: "For sql/explain: raw SQL query" },
+      params: { type: "array", description: "For sql/explain: query parameters" },
+      includeShared: { type: "boolean", description: "For list_tables: include shared (default: true)" },
+      includeArchived: { type: "boolean", description: "For list_tables: include archived" }
+    },
+    handler: async (params) => {
+      try {
+        const c = await ctxForParams(ctx, params);
+        const action = params.action;
+        const tbl = params.table ? encodeURIComponent(params.table) : "";
+        switch (action) {
+          // ── DDL: Schema Definition ──
+          case "create_table":
+            return await apiRequest(c, "POST", "/storage/tables", {
+              name: params.table,
+              columns: params.columns,
+              indexes: params.indexes,
+              shared: params.shared,
+              description: params.description,
+              timestamps: params.timestamps
+            });
+          case "list_tables":
+            return await apiRequest(c, "GET", `/storage/tables?includeShared=${params.includeShared !== false}&includeArchived=${params.includeArchived === true}`);
+          case "describe_table":
+            return await apiRequest(c, "GET", `/storage/tables/${tbl}/describe`);
+          case "add_column":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/columns`, { column: params.column });
+          case "drop_column":
+            return await apiRequest(c, "DELETE", `/storage/tables/${tbl}/columns/${encodeURIComponent(params.columnName)}`);
+          case "rename_table":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/rename`, { newName: params.newName });
+          case "rename_column":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/rename-column`, { oldName: params.oldName, newName: params.newName });
+          case "drop_table":
+            return await apiRequest(c, "DELETE", `/storage/tables/${tbl}`);
+          case "clone_table":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/clone`, { newName: params.newName, includeData: params.includeData });
+          case "truncate":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/truncate`);
+          // ── Index Management ──
+          case "create_index":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/indexes`, {
+              columns: params.indexColumns || params.columns,
+              unique: params.indexUnique,
+              name: params.indexName,
+              where: params.indexWhere
+            });
+          case "list_indexes":
+            return await apiRequest(c, "GET", `/storage/tables/${tbl}/indexes`);
+          case "drop_index":
+            return await apiRequest(c, "DELETE", `/storage/tables/${tbl}/indexes/${encodeURIComponent(params.indexName)}`);
+          case "reindex":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/reindex`);
+          // ── DML: Data Manipulation ──
+          case "insert":
+            return await apiRequest(c, "POST", "/storage/insert", { table: params.table, rows: params.rows });
+          case "upsert":
+            return await apiRequest(c, "POST", "/storage/upsert", { table: params.table, rows: params.rows, conflictColumn: params.conflictColumn });
+          case "query":
+            return await apiRequest(c, "POST", "/storage/query", {
+              table: params.table,
+              where: params.where,
+              orderBy: params.orderBy,
+              limit: params.limit,
+              offset: params.offset,
+              columns: params.selectColumns,
+              distinct: params.distinct,
+              groupBy: params.groupBy,
+              having: params.having
+            });
+          case "aggregate":
+            return await apiRequest(c, "POST", "/storage/aggregate", {
+              table: params.table,
+              where: params.where,
+              operations: params.operations,
+              groupBy: params.groupBy
+            });
+          case "update":
+            return await apiRequest(c, "POST", "/storage/update", { table: params.table, where: params.where, set: params.set });
+          case "delete_rows":
+            return await apiRequest(c, "POST", "/storage/delete-rows", { table: params.table, where: params.where });
+          // ── Archive & Lifecycle ──
+          case "archive_table":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/archive`);
+          case "unarchive_table":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/unarchive`);
+          // ── Import / Export ──
+          case "export":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/export`, { format: params.format, where: params.where, limit: params.limit });
+          case "import":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/import`, { rows: params.rows, onConflict: params.onConflict, conflictColumn: params.conflictColumn });
+          // ── Raw SQL ──
+          case "sql":
+            return await apiRequest(c, "POST", "/storage/sql", { sql: params.sql, params: params.params });
+          case "explain":
+            return await apiRequest(c, "POST", "/storage/explain", { sql: params.sql, params: params.params });
+          // ── Maintenance ──
+          case "stats":
+            return await apiRequest(c, "GET", "/storage/stats");
+          case "vacuum":
+            return await apiRequest(c, "POST", "/storage/vacuum");
+          case "analyze":
+            return await apiRequest(c, "POST", `/storage/tables/${tbl}/analyze`);
+          default:
+            return { error: `Unknown action "${action}". Valid actions: create_table, list_tables, describe_table, insert, upsert, query, aggregate, update, delete_rows, truncate, drop_table, clone_table, rename_table, rename_column, add_column, drop_column, create_index, list_indexes, drop_index, reindex, archive_table, unarchive_table, export, import, sql, stats, vacuum, analyze, explain` };
+        }
+      } catch (err) {
+        return { success: false, error: err.message };
+      }
+    }
+  });
   reg("agenticmail_sms_config", {
     description: "Get the current SMS/phone number configuration for this agent. Shows whether SMS is enabled, the phone number, and forwarding email.",
     parameters: {},

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agenticmail/openclaw",
-  "version": "0.5.41",
-  "description": "OpenClaw plugin for AgenticMail \u2014 email, SMS, and phone number access for OpenClaw agents",
+  "version": "0.5.42",
+  "description": "OpenClaw plugin for AgenticMail — email, SMS, and phone number access for OpenClaw agents",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -68,4 +68,4 @@
   },
   "author": "Ope Olatunji",
   "license": "MIT"
-}
+}