@oda-agent/openclaw-plugin 0.1.0

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenClawPlugin = void 0;
+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

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

package/dist/plugin.d.ts

@@ -0,0 +1,66 @@
+import type { OdaClient, OdaProduct } from '@oda-agent/core';
+/** A named shopping list with a list of product IDs and desired quantities. */
+export interface ShoppingList {
+    name: string;
+    items: Array<{
+        productId: number;
+        quantity: number;
+    }>;
+}
+/** Summary of a user's order history. */
+export interface OrderHistorySummary {
+    totalOrders: number;
+    totalSpend: string;
+    currency: string;
+    mostOrderedProducts: Array<{
+        product: OdaProduct;
+        timesOrdered: number;
+    }>;
+}
+/** The OpenClaw plugin object returned by the factory. */
+export interface OpenClawPlugin {
+    /**
+     * Search for products and build a shopping list from a plain-text description.
+     * Returns a list of matched products ready to add to cart.
+     */
+    buildShoppingList(name: string, items: Array<{
+        query: string;
+        quantity: number;
+    }>): Promise<ShoppingList>;
+    /**
+     * Analyse the user's past orders and return a summary.
+     */
+    analyseOrderHistory(maxPages?: number): Promise<OrderHistorySummary>;
+    /**
+     * Prepare the cart from a shopping list — adds all items in one call.
+     */
+    prepareCart(list: ShoppingList): Promise<void>;
+    /**
+     * Find the cheapest available delivery slot.
+     * Returns undefined if no slots are available.
+     */
+    findCheapestDeliverySlot(): Promise<{
+        id: number;
+        start: string;
+        end: string;
+        price: string;
+        currency: string;
+    } | undefined>;
+}
+/**
+ * Create an OpenClaw plugin that wraps an authenticated OdaClient.
+ *
+ * @example
+ * ```ts
+ * const client = new OdaClient({ credentials: { email, password } });
+ * await client.login();
+ * const plugin = createOpenClawPlugin(client);
+ * const list = await plugin.buildShoppingList('Weekly shop', [
+ *   { query: 'oat milk', quantity: 2 },
+ *   { query: 'sourdough bread', quantity: 1 },
+ * ]);
+ * await plugin.prepareCart(list);
+ * ```
+ */
+export declare function createOpenClawPlugin(client: OdaClient): OpenClawPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAmB,MAAM,iBAAiB,CAAC;AAM9E,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED,yCAAyC;AACzC,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE1G;;OAEG;IACH,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAErE;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;OAGG;IACH,wBAAwB,IAAI,OAAO,CACjC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CACxF,CAAC;CACH;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,CAwEtE"}

package/dist/plugin.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenClawPlugin = void 0;
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create an OpenClaw plugin that wraps an authenticated OdaClient.
+ *
+ * @example
+ * ```ts
+ * const client = new OdaClient({ credentials: { email, password } });
+ * await client.login();
+ * const plugin = createOpenClawPlugin(client);
+ * const list = await plugin.buildShoppingList('Weekly shop', [
+ *   { query: 'oat milk', quantity: 2 },
+ *   { query: 'sourdough bread', quantity: 1 },
+ * ]);
+ * await plugin.prepareCart(list);
+ * ```
+ */
+function createOpenClawPlugin(client) {
+    return {
+        async buildShoppingList(name, items) {
+            const resolved = [];
+            for (const item of items) {
+                const results = await client.searchProducts(item.query);
+                const first = results.results[0];
+                if (first) {
+                    resolved.push({ productId: first.id, quantity: item.quantity });
+                }
+            }
+            return { name, items: resolved };
+        },
+        async analyseOrderHistory(maxPages = 5) {
+            const productCounts = new Map();
+            let totalOrders = 0;
+            let totalSpendCents = 0;
+            let currency = 'NOK';
+            for (let page = 1; page <= maxPages; page++) {
+                const orderPage = await client.getOrders(page);
+                if (orderPage.results.length === 0)
+                    break;
+                totalOrders += orderPage.results.length;
+                for (const order of orderPage.results) {
+                    currency = order.currency;
+                    totalSpendCents += Math.round(parseFloat(order.total_price) * 100);
+                    for (const item of order.items) {
+                        const existing = productCounts.get(item.product.id);
+                        if (existing) {
+                            existing.count += item.quantity;
+                        }
+                        else {
+                            productCounts.set(item.product.id, { product: item.product, count: item.quantity });
+                        }
+                    }
+                }
+                if (!orderPage.next)
+                    break;
+            }
+            const sorted = [...productCounts.values()]
+                .sort((a, b) => b.count - a.count)
+                .slice(0, 10)
+                .map(({ product, count }) => ({ product, timesOrdered: count }));
+            return {
+                totalOrders,
+                totalSpend: (totalSpendCents / 100).toFixed(2),
+                currency,
+                mostOrderedProducts: sorted,
+            };
+        },
+        async prepareCart(list) {
+            for (const item of list.items) {
+                await client.addToCart(item.productId, item.quantity);
+            }
+        },
+        async findCheapestDeliverySlot() {
+            const slots = await client.getDeliverySlots();
+            const available = slots.filter((s) => s.is_available);
+            if (available.length === 0)
+                return undefined;
+            return available.sort((a, b) => parseFloat(a.price) - parseFloat(b.price))[0];
+        },
+    };
+}
+exports.createOpenClawPlugin = createOpenClawPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/tools/cartMutationTools.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Cart-mutation tools for the Oda shopping assistant.
+ *
+ * These tools are DISABLED by default and must be explicitly enabled by the
+ * user. Each tool mutates the shopping cart and therefore requires explicit
+ * user confirmation before it is invoked.
+ *
+ * Tools exposed:
+ *  - addToCart      — add a single product to the cart
+ *  - removeFromCart — remove a cart item by its product ID (cart.items[].product.id)
+ *  - clearCart      — remove all items from the cart
+ *  - prepareCart    — bulk-add all items from a ShoppingList to the cart
+ *
+ * SAFETY NOTE: The assistant workflow must present a full summary of intended
+ * changes and receive unambiguous user approval before calling any tool in
+ * this module. See SKILL.md for the canonical workflow.
+ */
+import type { OdaClient } from '@oda-agent/core';
+import type { ShoppingList } from '../plugin.js';
+/** Result of a cart mutation operation. */
+export interface CartMutationResult {
+    /** Human-readable description of what changed. */
+    summary: string;
+}
+/**
+ * Add `quantity` units of `productId` to the cart.
+ *
+ * Requires explicit user confirmation before calling.
+ */
+export declare function addToCart(client: OdaClient, productId: number, quantity: number): Promise<CartMutationResult>;
+/**
+ * Remove a product from the cart by its product ID (`cart.items[].product.id`).
+ *
+ * Note: `productId` is the Oda product ID, NOT the cart line-item ID.
+ * The Oda API removes the item by setting its quantity to 0 via the product ID.
+ *
+ * Requires explicit user confirmation before calling.
+ */
+export declare function removeFromCart(client: OdaClient, productId: number): Promise<CartMutationResult>;
+/**
+ * Remove all items from the cart.
+ *
+ * Requires explicit user confirmation before calling.
+ */
+export declare function clearCart(client: OdaClient): Promise<CartMutationResult>;
+/**
+ * Add every item in `list` to the cart, sequentially one item at a time.
+ *
+ * Requires explicit user confirmation before calling. The caller should show
+ * the full shopping list to the user and wait for approval.
+ */
+export declare function prepareCart(client: OdaClient, list: ShoppingList): Promise<CartMutationResult>;
+//# sourceMappingURL=cartMutationTools.d.ts.map

package/dist/tools/cartMutationTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartMutationTools.d.ts","sourceRoot":"","sources":["../../src/tools/cartMutationTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAG7B;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAG7B;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAG9E;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,kBAAkB,CAAC,CAO7B"}

package/dist/tools/cartMutationTools.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Cart-mutation tools for the Oda shopping assistant.
+ *
+ * These tools are DISABLED by default and must be explicitly enabled by the
+ * user. Each tool mutates the shopping cart and therefore requires explicit
+ * user confirmation before it is invoked.
+ *
+ * Tools exposed:
+ *  - addToCart      — add a single product to the cart
+ *  - removeFromCart — remove a cart item by its product ID (cart.items[].product.id)
+ *  - clearCart      — remove all items from the cart
+ *  - prepareCart    — bulk-add all items from a ShoppingList to the cart
+ *
+ * SAFETY NOTE: The assistant workflow must present a full summary of intended
+ * changes and receive unambiguous user approval before calling any tool in
+ * this module. See SKILL.md for the canonical workflow.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareCart = exports.clearCart = exports.removeFromCart = exports.addToCart = void 0;
+// ---------------------------------------------------------------------------
+// Tool implementations
+// ---------------------------------------------------------------------------
+/**
+ * Add `quantity` units of `productId` to the cart.
+ *
+ * Requires explicit user confirmation before calling.
+ */
+async function addToCart(client, productId, quantity) {
+    await client.addToCart(productId, quantity);
+    return { summary: `Added ${quantity}× product #${productId} to cart.` };
+}
+exports.addToCart = addToCart;
+/**
+ * Remove a product from the cart by its product ID (`cart.items[].product.id`).
+ *
+ * Note: `productId` is the Oda product ID, NOT the cart line-item ID.
+ * The Oda API removes the item by setting its quantity to 0 via the product ID.
+ *
+ * Requires explicit user confirmation before calling.
+ */
+async function removeFromCart(client, productId) {
+    await client.removeFromCart(productId);
+    return { summary: `Removed product #${productId} from cart.` };
+}
+exports.removeFromCart = removeFromCart;
+/**
+ * Remove all items from the cart.
+ *
+ * Requires explicit user confirmation before calling.
+ */
+async function clearCart(client) {
+    await client.clearCart();
+    return { summary: 'Cart cleared.' };
+}
+exports.clearCart = clearCart;
+/**
+ * Add every item in `list` to the cart, sequentially one item at a time.
+ *
+ * Requires explicit user confirmation before calling. The caller should show
+ * the full shopping list to the user and wait for approval.
+ */
+async function prepareCart(client, list) {
+    for (const item of list.items) {
+        await client.addToCart(item.productId, item.quantity);
+    }
+    return {
+        summary: `Added ${list.items.length} item(s) from list "${list.name}" to cart.`,
+    };
+}
+exports.prepareCart = prepareCart;
+//# sourceMappingURL=cartMutationTools.js.map

package/dist/tools/cartMutationTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartMutationTools.js","sourceRoot":"","sources":["../../src/tools/cartMutationTools.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAeH,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;GAIG;AACI,KAAK,UAAU,SAAS,CAC7B,MAAiB,EACjB,SAAiB,EACjB,QAAgB;IAEhB,MAAM,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5C,OAAO,EAAE,OAAO,EAAE,SAAS,QAAQ,cAAc,SAAS,WAAW,EAAE,CAAC;AAC1E,CAAC;AAPD,8BAOC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,cAAc,CAClC,MAAiB,EACjB,SAAiB;IAEjB,MAAM,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACvC,OAAO,EAAE,OAAO,EAAE,oBAAoB,SAAS,aAAa,EAAE,CAAC;AACjE,CAAC;AAND,wCAMC;AAED;;;;GAIG;AACI,KAAK,UAAU,SAAS,CAAC,MAAiB;IAC/C,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;AACtC,CAAC;AAHD,8BAGC;AAED;;;;;GAKG;AACI,KAAK,UAAU,WAAW,CAC/B,MAAiB,EACjB,IAAkB;IAElB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;IACD,OAAO;QACL,OAAO,EAAE,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,uBAAuB,IAAI,CAAC,IAAI,YAAY;KAChF,CAAC;AACJ,CAAC;AAVD,kCAUC"}

package/dist/tools/highRiskTools.d.ts

@@ -0,0 +1,31 @@
+/**
+ * High-risk tools — ORDER PLACEMENT IS OUT OF SCOPE FOR v0.
+ *
+ * This module documents the high-risk tool surface for the Oda shopping
+ * assistant. None of the tools in this module are implemented. They exist
+ * solely to make the safety boundary explicit and to reserve the correct
+ * API surface for a future version.
+ *
+ * Rationale
+ * ---------
+ * Placing a grocery order involves real financial transactions. Doing so
+ * automatically, without strong human oversight and a confirmed payment
+ * step, would be unsafe. The v0 assistant is therefore read-and-plan-only,
+ * with cart mutations being the furthest extent of automation.
+ *
+ * Future work
+ * -----------
+ * A future version may expose a `placeOrder` tool behind:
+ *  1. An explicit double-confirmation flow (show full order summary + price).
+ *  2. A separate opt-in feature flag in openclaw.plugin.json.
+ *  3. A mandatory audit-log entry before and after placement.
+ *
+ * Do NOT implement payment logic or final order placement in this package.
+ */
+/**
+ * @throws Always throws — order placement is not implemented in v0.
+ *
+ * @deprecated Not implemented. See module-level documentation.
+ */
+export declare function placeOrder(): never;
+//# sourceMappingURL=highRiskTools.d.ts.map

package/dist/tools/highRiskTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highRiskTools.d.ts","sourceRoot":"","sources":["../../src/tools/highRiskTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,KAAK,CAMlC"}

package/dist/tools/highRiskTools.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * High-risk tools — ORDER PLACEMENT IS OUT OF SCOPE FOR v0.
+ *
+ * This module documents the high-risk tool surface for the Oda shopping
+ * assistant. None of the tools in this module are implemented. They exist
+ * solely to make the safety boundary explicit and to reserve the correct
+ * API surface for a future version.
+ *
+ * Rationale
+ * ---------
+ * Placing a grocery order involves real financial transactions. Doing so
+ * automatically, without strong human oversight and a confirmed payment
+ * step, would be unsafe. The v0 assistant is therefore read-and-plan-only,
+ * with cart mutations being the furthest extent of automation.
+ *
+ * Future work
+ * -----------
+ * A future version may expose a `placeOrder` tool behind:
+ *  1. An explicit double-confirmation flow (show full order summary + price).
+ *  2. A separate opt-in feature flag in openclaw.plugin.json.
+ *  3. A mandatory audit-log entry before and after placement.
+ *
+ * Do NOT implement payment logic or final order placement in this package.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.placeOrder = void 0;
+// ---------------------------------------------------------------------------
+// Placeholder — not implemented
+// ---------------------------------------------------------------------------
+/**
+ * @throws Always throws — order placement is not implemented in v0.
+ *
+ * @deprecated Not implemented. See module-level documentation.
+ */
+function placeOrder() {
+    throw new Error('placeOrder is not implemented. ' +
+        'Final order placement is out of scope for v0 of the Oda shopping assistant. ' +
+        'See the OpenClaw plugin manifest (openclaw.plugin.json) for supported tool capabilities.');
+}
+exports.placeOrder = placeOrder;
+//# sourceMappingURL=highRiskTools.js.map

package/dist/tools/highRiskTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highRiskTools.js","sourceRoot":"","sources":["../../src/tools/highRiskTools.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;AAEH,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E;;;;GAIG;AACH,SAAgB,UAAU;IACxB,MAAM,IAAI,KAAK,CACb,iCAAiC;QAC/B,8EAA8E;QAC9E,0FAA0F,CAC7F,CAAC;AACJ,CAAC;AAND,gCAMC"}

package/dist/tools/readOnlyTools.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Read-only tools for the Oda shopping assistant.
+ *
+ * These tools are ENABLED by default. They do not mutate any state and are
+ * safe to invoke without explicit user confirmation.
+ *
+ * Tools exposed:
+ *  - searchProducts   — search the Oda product catalogue
+ *  - getCart          — read the current shopping cart
+ *  - getOrders        — read paginated order history
+ *  - getDeliverySlots — list available delivery time slots
+ *  - getShoppingLists — list the user's saved shopping lists
+ *
+ * Higher-level helpers (buildShoppingList, analyseOrderHistory,
+ * findCheapestDeliverySlot) are implemented in plugin.ts and compose
+ * these primitives without performing any writes.
+ */
+import type { OdaClient, OdaSearchResponse, OdaCart, OdaPage, OdaOrder, OdaDeliverySlot, OdaShoppingList } from '@oda-agent/core';
+/** Parameters for the searchProducts tool. */
+export interface SearchProductsParams {
+    query: string;
+}
+/** Parameters for the getOrders tool. */
+export interface GetOrdersParams {
+    /** Page number, 1-based. Defaults to 1. */
+    page?: number;
+}
+/**
+ * Search the Oda catalogue for products matching `query`.
+ * Returns the raw search response including matched products and result count.
+ */
+export declare function searchProducts(client: OdaClient, params: SearchProductsParams): Promise<OdaSearchResponse>;
+/**
+ * Retrieve the authenticated user's current shopping cart.
+ */
+export declare function getCart(client: OdaClient): Promise<OdaCart>;
+/**
+ * Fetch a page of the authenticated user's past orders.
+ */
+export declare function getOrders(client: OdaClient, params?: GetOrdersParams): Promise<OdaPage<OdaOrder>>;
+/**
+ * List all delivery time slots, both available and unavailable.
+ */
+export declare function getDeliverySlots(client: OdaClient): Promise<OdaDeliverySlot[]>;
+/**
+ * List the authenticated user's saved shopping lists.
+ */
+export declare function getShoppingLists(client: OdaClient): Promise<OdaShoppingList[]>;
+//# sourceMappingURL=readOnlyTools.d.ts.map

package/dist/tools/readOnlyTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readOnlyTools.d.ts","sourceRoot":"","sources":["../../src/tools/readOnlyTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMlI,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAEjE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,SAAS,EACjB,MAAM,GAAE,eAAoB,GAC3B,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAE5B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAEpF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAEpF"}

package/dist/tools/readOnlyTools.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Read-only tools for the Oda shopping assistant.
+ *
+ * These tools are ENABLED by default. They do not mutate any state and are
+ * safe to invoke without explicit user confirmation.
+ *
+ * Tools exposed:
+ *  - searchProducts   — search the Oda product catalogue
+ *  - getCart          — read the current shopping cart
+ *  - getOrders        — read paginated order history
+ *  - getDeliverySlots — list available delivery time slots
+ *  - getShoppingLists — list the user's saved shopping lists
+ *
+ * Higher-level helpers (buildShoppingList, analyseOrderHistory,
+ * findCheapestDeliverySlot) are implemented in plugin.ts and compose
+ * these primitives without performing any writes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getShoppingLists = exports.getDeliverySlots = exports.getOrders = exports.getCart = exports.searchProducts = void 0;
+// ---------------------------------------------------------------------------
+// Tool implementations
+// ---------------------------------------------------------------------------
+/**
+ * Search the Oda catalogue for products matching `query`.
+ * Returns the raw search response including matched products and result count.
+ */
+async function searchProducts(client, params) {
+    return client.searchProducts(params.query);
+}
+exports.searchProducts = searchProducts;
+/**
+ * Retrieve the authenticated user's current shopping cart.
+ */
+async function getCart(client) {
+    return client.getCart();
+}
+exports.getCart = getCart;
+/**
+ * Fetch a page of the authenticated user's past orders.
+ */
+async function getOrders(client, params = {}) {
+    return client.getOrders(params.page ?? 1);
+}
+exports.getOrders = getOrders;
+/**
+ * List all delivery time slots, both available and unavailable.
+ */
+async function getDeliverySlots(client) {
+    return client.getDeliverySlots();
+}
+exports.getDeliverySlots = getDeliverySlots;
+/**
+ * List the authenticated user's saved shopping lists.
+ */
+async function getShoppingLists(client) {
+    return client.getShoppingLists();
+}
+exports.getShoppingLists = getShoppingLists;
+//# sourceMappingURL=readOnlyTools.js.map

package/dist/tools/readOnlyTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readOnlyTools.js","sourceRoot":"","sources":["../../src/tools/readOnlyTools.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAmBH,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;GAGG;AACI,KAAK,UAAU,cAAc,CAClC,MAAiB,EACjB,MAA4B;IAE5B,OAAO,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AALD,wCAKC;AAED;;GAEG;AACI,KAAK,UAAU,OAAO,CAAC,MAAiB;IAC7C,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC;AAFD,0BAEC;AAED;;GAEG;AACI,KAAK,UAAU,SAAS,CAC7B,MAAiB,EACjB,SAA0B,EAAE;IAE5B,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC;AALD,8BAKC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CAAC,MAAiB;IACtD,OAAO,MAAM,CAAC,gBAAgB,EAAE,CAAC;AACnC,CAAC;AAFD,4CAEC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CAAC,MAAiB;IACtD,OAAO,MAAM,CAAC,gBAAgB,EAAE,CAAC;AACnC,CAAC;AAFD,4CAEC"}

package/openclaw.plugin.json

@@ -0,0 +1,88 @@
+{
+  "name": "oda-shopping-assistant",
+  "version": "0.1.0",
+  "description": "Oda grocery shopping assistant — safe cart planning, order history analysis, and delivery slot discovery.",
+  "author": "oda-agent-kit",
+  "license": "MIT",
+  "toolGroups": [
+    {
+      "name": "read-only",
+      "description": "Safe, read-only tools for browsing products, cart, orders, and delivery slots.",
+      "enabled": true,
+      "tools": [
+        {
+          "name": "searchProducts",
+          "description": "Search for products in the Oda catalogue by keyword."
+        },
+        {
+          "name": "getCart",
+          "description": "Retrieve the current shopping cart."
+        },
+        {
+          "name": "getOrders",
+          "description": "Fetch paginated order history."
+        },
+        {
+          "name": "getDeliverySlots",
+          "description": "List available delivery time slots."
+        },
+        {
+          "name": "getShoppingLists",
+          "description": "List the user's saved shopping lists."
+        },
+        {
+          "name": "analyseOrderHistory",
+          "description": "Analyse past orders and return a summary of frequently ordered products."
+        },
+        {
+          "name": "buildShoppingList",
+          "description": "Resolve plain-text queries into a structured shopping list without mutating the cart."
+        },
+        {
+          "name": "findCheapestDeliverySlot",
+          "description": "Return the cheapest available delivery slot without booking it."
+        }
+      ]
+    },
+    {
+      "name": "cart-mutation",
+      "description": "Optional tools that modify the cart. Must be explicitly enabled by the user.",
+      "enabled": false,
+      "tools": [
+        {
+          "name": "prepareCart",
+          "description": "Add all items from a shopping list to the cart. Requires explicit user confirmation before use."
+        },
+        {
+          "name": "addToCart",
+          "description": "Add a single product to the cart. Requires explicit user confirmation before use."
+        },
+        {
+          "name": "removeFromCart",
+          "description": "Remove an item from the cart by cart-item ID from getCart (`cart.items[].id`). Requires explicit user confirmation before use."
+        },
+        {
+          "name": "clearCart",
+          "description": "Remove all items from the cart. Requires explicit user confirmation before use."
+        }
+      ]
+    },
+    {
+      "name": "high-risk",
+      "description": "High-risk tools for order placement and payment. OUT OF SCOPE for v0 — not implemented.",
+      "enabled": false,
+      "tools": [
+        {
+          "name": "placeOrder",
+          "description": "NOT IMPLEMENTED. Final order placement is out of scope for v0. See highRiskTools.ts."
+        }
+      ]
+    }
+  ],
+  "skills": [
+    {
+      "name": "oda-shopping-assistant",
+      "path": "skills/oda-shopping-assistant/SKILL.md"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@oda-agent/openclaw-plugin",
+  "version": "0.1.0",
+  "description": "OpenClaw plugin for safe grocery planning and Oda automation",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "skills"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "test": "jest"
+  },
+  "dependencies": {
+    "@oda-agent/core": "*"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dinorastoder/oda-agent-kit.git"
+  },
+  "license": "MIT"
+}

package/skills/oda-shopping-assistant/SKILL.md

@@ -0,0 +1,96 @@
+# Oda Shopping Assistant — Skill
+
+## Purpose
+
+The Oda Shopping Assistant helps users plan, review, and (optionally) prepare grocery orders from the Norwegian online supermarket [Oda](https://oda.com). It follows a **safe-by-default** design: it reads and proposes, then waits for explicit user approval before making any changes.
+
+---
+
+## Grocery workflow
+
+The assistant always follows this workflow:
+
+1. **Read** — Fetch the current cart, order history, saved lists, and available delivery slots.
+2. **Propose** — Build a suggested grocery plan based on past purchases, explicit requests, or both.
+3. **Explain** — For each suggested item, briefly explain *why* it is included (staple product, user request, substitute, etc.).
+4. **Confirm before cart changes** — Show a full summary of proposed cart changes and ask the user for approval.
+5. **Confirm before delivery-slot changes** — Ask for a separate, stronger confirmation before reserving or modifying a delivery slot.
+6. **Never place an order automatically** — Final order placement is not implemented in v0. The assistant must stop after cart preparation.
+
+---
+
+## Tool groups
+
+### Read-only tools (enabled by default)
+
+These tools are safe to invoke without user confirmation. They observe but do not mutate.
+
+| Tool | Description |
+|------|-------------|
+| `searchProducts` | Search the Oda catalogue by keyword |
+| `getCart` | Read the current shopping cart |
+| `getOrders` | Fetch paginated order history |
+| `getDeliverySlots` | List available delivery time slots |
+| `getShoppingLists` | List the user's saved shopping lists |
+| `buildShoppingList` | Resolve plain-text queries into a structured shopping list |
+| `analyseOrderHistory` | Summarise past orders and frequently bought products |
+| `findCheapestDeliverySlot` | Find the cheapest available delivery slot (read-only) |
+
+### Cart-mutation tools (disabled by default)
+
+These tools modify the shopping cart. They must be **explicitly enabled** by the user and require **explicit confirmation** before each invocation.
+
+| Tool | Description |
+|------|-------------|
+| `prepareCart` | Bulk-add all items from a shopping list to the cart |
+| `addToCart` | Add a single product to the cart |
+| `removeFromCart` | Remove a cart item by cart-item ID (`cart.items[].id`) |
+| `clearCart` | Remove all items from the cart |
+
+### High-risk tools (not implemented in v0)
+
+Order placement and payment are **out of scope** for v0. The `placeOrder` tool is documented but not implemented. See `src/tools/highRiskTools.ts` for rationale and future-work notes.
+
+---
+
+## Safety model
+
+- **Read first, write second** — never modify cart or delivery state without first showing the user what will change.
+- **One confirmation per mutation class** — a single approval covers one named set of changes. New changes require a new confirmation.
+- **No hidden writes** — the assistant must never add to or clear the cart as a side-effect of a read operation.
+- **No payment logic** — the assistant cannot and must not handle payment information or finalise orders.
+- **Secrets stay out of logs** — session tokens, CSRF tokens, and credentials are never logged or included in tool responses.
+
+---
+
+## Example conversation
+
+```
+User:  Can you suggest a weekly shop based on what I usually buy?
+
+Agent: Sure! Here's a proposed list based on your last 5 orders:
+
+       1. Oat Milk 1L × 2   — ordered 4 times in the last 3 months
+       2. Sourdough Bread × 1 — ordered every week
+       3. Greek Yoghurt 500g × 2 — ordered 3 times recently
+
+       Shall I add these to your cart? (yes / no / edit)
+
+User:  Yes, add them.
+
+Agent: Adding 3 items to your cart…
+       ✓ Oat Milk 1L × 2
+       ✓ Sourdough Bread × 1
+       ✓ Greek Yoghurt 500g × 2
+
+       Done! Your cart now has 3 items. Would you like to browse
+       delivery slots?
+```
+
+---
+
+## Limitations (v0)
+
+- No final order placement — the workflow stops at cart preparation.
+- No payment information is handled.
+- Cart-mutation tools must be enabled by the operator before the assistant can modify the cart.