@oda-agent/openclaw-plugin 0.1.4 → 0.1.6

package/dist/entry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * OpenClaw native plugin entry.
+ *
+ * OpenClaw loads `dist/index.js` and expects a **default export** that is a
+ * plugin entry object with `register()` and `activate()` methods.  This file
+ * provides that entrypoint by registering every tool that the Oda shopping
+ * assistant exposes, wired up to a lazily-authenticated OdaClient.
+ *
+ * The `definePluginEntry` helper is defined locally so that this package has
+ * no runtime dependency on the OpenClaw SDK.  When the OpenClaw team publishes
+ * `openclaw/plugin-sdk`, this file can be updated to import from there instead.
+ */
+/**
+ * Minimal OpenClaw plugin API surface passed to the `register()` callback.
+ * The complete interface is defined by the OpenClaw runtime; only the
+ * members used by this plugin are declared here.
+ */
+export interface OpenClawApi {
+    /** Register a named tool with the plugin runtime. */
+    registerTool(name: string, description: string, handler: (params: unknown) => Promise<unknown>): void;
+    /** Return the plugin configuration provided by the user or environment. */
+    getConfig(): Record<string, unknown>;
+}
+/** Shape of an OpenClaw native plugin entry. */
+export interface OpenClawPluginEntry {
+    /** Unique identifier for the plugin (must match `openclaw.plugin.json` id). */
+    id: string;
+    /** Human-readable plugin name. */
+    name: string;
+    /** Short description of the plugin. */
+    description: string;
+    /**
+     * Called once by the OpenClaw runtime during plugin installation.
+     * Use the provided `api` to register all tools this plugin exposes.
+     */
+    register(api: OpenClawApi): void;
+    /** Called once by the OpenClaw runtime when the plugin is activated. */
+    activate(): void;
+}
+declare const pluginEntry: OpenClawPluginEntry;
+export default pluginEntry;
+//# sourceMappingURL=entry.d.ts.map

package/dist/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAC7C,IAAI,CAAC;IACR,2EAA2E;IAC3E,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,wEAAwE;IACxE,QAAQ,IAAI,IAAI,CAAC;CAClB;AAcD,QAAA,MAAM,WAAW,qBA0Jf,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/entry.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * OpenClaw native plugin entry.
+ *
+ * OpenClaw loads `dist/index.js` and expects a **default export** that is a
+ * plugin entry object with `register()` and `activate()` methods.  This file
+ * provides that entrypoint by registering every tool that the Oda shopping
+ * assistant exposes, wired up to a lazily-authenticated OdaClient.
+ *
+ * The `definePluginEntry` helper is defined locally so that this package has
+ * no runtime dependency on the OpenClaw SDK.  When the OpenClaw team publishes
+ * `openclaw/plugin-sdk`, this file can be updated to import from there instead.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oda-agent/core");
+const readOnlyTools = __importStar(require("./tools/readOnlyTools.js"));
+const cartMutationTools = __importStar(require("./tools/cartMutationTools.js"));
+const plugin_js_1 = require("./plugin.js");
+/**
+ * Identity helper that mirrors `definePluginEntry` from the OpenClaw SDK.
+ * Defined locally so the package has no runtime dependency on the OpenClaw SDK.
+ */
+function definePluginEntry(entry) {
+    return entry;
+}
+// ---------------------------------------------------------------------------
+// Plugin entry
+// ---------------------------------------------------------------------------
+const pluginEntry = definePluginEntry({
+    id: '@oda-agent/openclaw-plugin',
+    name: 'oda-shopping-assistant',
+    description: 'Oda grocery shopping assistant — safe cart planning, order history analysis, and delivery slot discovery.',
+    register(api) {
+        const config = api.getConfig();
+        const email = config.email ?? process.env['ODA_EMAIL'] ?? '';
+        const password = config.password ?? process.env['ODA_PASSWORD'] ?? '';
+        if (!email || !password) {
+            throw new Error('Oda credentials are required. ' +
+                'Set the email and password fields in the plugin config, ' +
+                'or export the ODA_EMAIL and ODA_PASSWORD environment variables.');
+        }
+        const client = new core_1.OdaClient({ credentials: { email, password } });
+        const plugin = (0, plugin_js_1.createOpenClawPlugin)(client);
+        // Login is deferred and cached so it only happens on the first tool call.
+        let loginPromise = null;
+        function ensureLoggedIn() {
+            if (loginPromise === null) {
+                loginPromise = client.login();
+            }
+            return loginPromise;
+        }
+        // ── Read-only tools ─────────────────────────────────────────────────────
+        api.registerTool('searchProducts', 'Search for products in the Oda catalogue by keyword.', async (params) => {
+            await ensureLoggedIn();
+            return readOnlyTools.searchProducts(client, params);
+        });
+        api.registerTool('getCart', 'Retrieve the current shopping cart.', async () => {
+            await ensureLoggedIn();
+            return readOnlyTools.getCart(client);
+        });
+        api.registerTool('getOrders', 'Fetch paginated order history.', async (params) => {
+            await ensureLoggedIn();
+            return readOnlyTools.getOrders(client, params);
+        });
+        api.registerTool('getDeliverySlots', 'List available delivery time slots.', async () => {
+            await ensureLoggedIn();
+            return readOnlyTools.getDeliverySlots(client);
+        });
+        api.registerTool('getShoppingLists', "List the user's saved shopping lists.", async () => {
+            await ensureLoggedIn();
+            return readOnlyTools.getShoppingLists(client);
+        });
+        // ── Higher-level read-only helpers ──────────────────────────────────────
+        api.registerTool('analyseOrderHistory', 'Analyse past orders and return a summary of frequently ordered products.', async (params) => {
+            await ensureLoggedIn();
+            const p = params;
+            return plugin.analyseOrderHistory(p?.maxPages);
+        });
+        api.registerTool('buildShoppingList', 'Resolve plain-text queries into a structured shopping list without mutating the cart.', async (params) => {
+            await ensureLoggedIn();
+            const p = params;
+            return plugin.buildShoppingList(p.name, p.items);
+        });
+        api.registerTool('findCheapestDeliverySlot', 'Return the cheapest available delivery slot without booking it.', async () => {
+            await ensureLoggedIn();
+            return plugin.findCheapestDeliverySlot();
+        });
+        // ── Cart-mutation tools (disabled by default in manifest) ───────────────
+        api.registerTool('addToCart', 'Add a single product to the cart. Requires explicit user confirmation before use.', async (params) => {
+            await ensureLoggedIn();
+            const p = params;
+            return cartMutationTools.addToCart(client, p.productId, p.quantity);
+        });
+        api.registerTool('removeFromCart', 'Remove an item from the cart by product ID. Requires explicit user confirmation before use.', async (params) => {
+            await ensureLoggedIn();
+            const p = params;
+            return cartMutationTools.removeFromCart(client, p.productId);
+        });
+        api.registerTool('clearCart', 'Remove all items from the cart. Requires explicit user confirmation before use.', async () => {
+            await ensureLoggedIn();
+            return cartMutationTools.clearCart(client);
+        });
+        api.registerTool('prepareCart', 'Add all items from a shopping list to the cart. Requires explicit user confirmation before use.', async (params) => {
+            await ensureLoggedIn();
+            return cartMutationTools.prepareCart(client, params);
+        });
+    },
+    activate() {
+        // Lifecycle hook called when the plugin is activated by OpenClaw.
+        // No additional setup is required for the Oda shopping assistant.
+    },
+});
+exports.default = pluginEntry;
+//# sourceMappingURL=entry.js.map

package/dist/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { default } from './entry.js';
+export type { OpenClawApi, OpenClawPluginEntry } from './entry.js';
 export { createOpenClawPlugin } from './plugin.js';
 export type { ShoppingList, OrderHistorySummary, OpenClawPlugin } from './plugin.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,6 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createOpenClawPlugin = void 0;
+exports.createOpenClawPlugin = exports.default = void 0;
+var entry_js_1 = require("./entry.js");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(entry_js_1).default; } });
 var plugin_js_1 = require("./plugin.js");
 Object.defineProperty(exports, "createOpenClawPlugin", { enumerable: true, get: function () { return plugin_js_1.createOpenClawPlugin; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAmD;AAA1C,iHAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,uCAAqC;AAA5B,oHAAA,OAAO,OAAA;AAEhB,yCAAmD;AAA1C,iHAAA,oBAAoB,OAAA"}

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "@oda-agent/openclaw-plugin",
   "name": "oda-shopping-assistant",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Oda grocery shopping assistant — safe cart planning, order history analysis, and delivery slot discovery.",
   "author": "oda-agent-kit",
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oda-agent/openclaw-plugin",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "OpenClaw plugin for safe grocery planning and Oda automation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,7 +32,6 @@
   "openclaw": {
     "extensions": [
       "./dist/index.js"
-    ],
-    "hooks": []
+    ]
   }
 }