@agenticmail/openclaw 0.5.40 → 0.5.42

package/dist/index.d.cts

@@ -0,0 +1,12 @@
+declare function activate(api: any): void;
+/**
+ * OpenClaw plugin module export.
+ * Must export an object with `id` and `register` — OpenClaw reads `id` for identification
+ * and calls `register(api)` during plugin activation.
+ */
+declare const _default: {
+    id: string;
+    register: typeof activate;
+};
+
+export { _default as default };

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,13 +1,15 @@
 {
   "name": "@agenticmail/openclaw",
-  "version": "0.5.40",
-  "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",
   "exports": {
     ".": {
       "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js",
       "types": "./dist/index.d.ts"
     }
   },
@@ -26,7 +28,7 @@
     ]
   },
   "scripts": {
-    "build": "tsup index.ts --format esm --dts --clean",
+    "build": "tsup index.ts --format esm,cjs --dts --clean",
     "test": "vitest run --passWithNoTests",
     "preuninstall": "node scripts/uninstall.mjs",
     "prepublishOnly": "npm run build"
@@ -66,4 +68,4 @@
   },
   "author": "Ope Olatunji",
   "license": "MIT"
-}
+}