salai 0.1.4 → 0.1.5

package/README.md

@@ -8,10 +8,10 @@ npx salai retailers
 npx salai cart add 7290019489443
 ```
 
-## What's New in v0.1.4
+## What's New in v0.1.5
 
-- `salai fulfill` — one-call shopping list quotes (MCP `fulfill_shopping_list`)
-- Richer `--help` (including `salai fulfill --help`) and README guidance for AI agents
+- `salai shopping-list` — alias for `salai fulfill`; same MCP tool `fulfill_shopping_list` (shopping list quote)
+- README aligned with the SalAi monorepo package; agent integration section cleanup
 
 ## Agent Integration
 
@@ -29,10 +29,10 @@ See:
 
 ## Using with AI agents
 
-Same idea as [dev-browser’s agent workflow](https://github.com/SawyerHood/dev-browser?tab=readme-ov-file#using-with-ai-agents): **have the agent read `--help`** so it sees every flag and the extra notes we embed for automation.
+**Have the agent read `--help`** so it sees every flag and the extra notes we embed for automation.
 
 1. **`salai --help`** — command list plus a short reminder to use `--json` and subcommand help.
-2. **`salai <command> --help`** — all options for that command. Shopping lists: **`salai fulfill --help`** (includes CLI vs full MCP tool, examples, billing errors).
+2. **`salai <command> --help`** — all options for that command. Shopping lists: **`salai shopping-list --help`** (includes CLI vs full MCP tool, examples, billing errors).
 3. **`salai tools --json`** — tool names and schemas as returned by the live server.
 
 For MCP fields that are not CLI flags (structured `items`, `scope.stores` with `mode: explicit`, `resolution.policy`, `alternatives.maxPerItem`, `llmRawListExtraction`, `includeDiagnostics`, etc.), use:
@@ -55,6 +55,30 @@ To reduce permission prompts, pre-approve the CLI in `.claude/settings.json` (pr
 
 ## Install
 
+### Option 1: Agent skill (recommended)
+
+Skill source: [github.com/Salai-app/salai-cli](https://github.com/Salai-app/salai-cli) (`skills/salai-cli`).
+
+```bash
+npx skills add Salai-app/salai-cli
+```
+
+Uses [`npx skills`](https://github.com/vercel-labs/skills) (Vercel Labs). It detects your installed coding agents (OpenCode, Claude Code, Codex, Cursor, and [40+ more](https://github.com/vercel-labs/skills#supported-agents)) and installs the skill to the right location.
+
+Install globally (available across all projects):
+
+```bash
+npx skills add Salai-app/salai-cli -g
+```
+
+Target a specific agent:
+
+```bash
+npx skills add Salai-app/salai-cli -a claude-code -g
+```
+
+### Option 2: CLI only
+
 ```bash
 # Use directly with npx (no install needed)
 npx salai <command>
@@ -102,12 +126,12 @@ salai ac <query>                  # Alias
   --method <text|semantic>        # Search method (default text)
 ```
 
-### Fulfill (shopping list quote)
+### Shopping list (shopping-list / fulfill)
 
-Resolves a list, compares baskets across stores, returns ranked stores (MCP `fulfill_shopping_list`). **Does not require a selected store.** Prefer **`salai fulfill --help`** for the full agent-oriented help text.
+Resolves a list, compares baskets across stores, returns ranked stores (MCP `fulfill_shopping_list`). **Does not require a selected store.** Prefer **`salai shopping-list --help`** for the full agent-oriented help text.
 
 ```bash
-salai fulfill [items...]          # Inline list (comma-separated) or use --file
+salai shopping-list [items...]    # Inline list (comma-separated) or use --file (alias: salai fulfill)
   --scope <mode>                  # online_only (default) | all_active
   --max-stores <n>                # Cap stores compared (default 10)
   --file <path>                   # Newline-separated list file
@@ -118,6 +142,8 @@ salai fulfill [items...]          # Inline list (comma-separated) or use --file
 salai call fulfill_shopping_list --args '{"items":[...],"scope":{"mode":"explicit","stores":[...]}}' --json
 ```
 
+Same command as `salai fulfill …` (legacy name).
+
 ### Pricing
 
 ```bash

package/dist/commands/fulfill.js

@@ -5,7 +5,8 @@ import { outputResult, outputRaw } from '../formatters/index.js';
 export function registerFulfillCommands(program, getClient, isJson) {
     program
         .command('fulfill [items...]')
-        .description('Find the best store for a shopping list. ' +
+        .alias('shopping-list')
+        .description('Shopping list quote: find the best store for a list. ' +
         'Pass items inline (comma/space separated) or via --file.')
         .addOption(new Option('--scope <mode>', 'Store universe: online_only (default) or all_active. For explicit store IDs use salai call.')
         .choices(['online_only', 'all_active'])
@@ -48,15 +49,17 @@ export function registerFulfillCommands(program, getClient, isJson) {
         await client.close();
     })
         .addHelpText('after', `
-Global options (same as root salai --help; often placed after the subcommand, e.g. salai fulfill "…" --json)
+Global options (same as root salai --help; often placed after the subcommand, e.g. salai shopping-list "…" --json)
   -k, --api-key <key>   Salai API key (or SALAI_API_KEY env)
   --url <url>           MCP endpoint URL (or SALAI_MCP_URL env)
   --json                Raw JSON output instead of formatted tables
 
+  Command names: salai shopping-list and salai fulfill are the same (zero breaking; fulfill is the canonical name in help).
+
 Agent / automation
   Use --json on every invoke so output matches MCP structured payloads.
 
-  fulfill does not use the selected store (quote mode is fully request-scoped).
+  This command does not use the selected store (quote mode is fully request-scoped).
   Higher token cost than search; errors may include TOKEN_LIMIT_REACHED or RATE_LIMIT_EXCEEDED.
 
 CLI vs full MCP tool
@@ -68,9 +71,10 @@ CLI vs full MCP tool
     llmRawListExtraction (default true on server for rawList), includeDiagnostics, mode (quote).
 
 Examples
-  salai fulfill "חלב, לחם, ביצים" --json
-  salai fulfill --file ./list.txt --scope all_active --max-stores 5 --json
-  salai fulfill "חלב" --brand-strict --no-alternatives --json
+  salai shopping-list "חלב, לחם, ביצים" --json
+  salai shopping-list --file ./list.txt --scope all_active --max-stores 5 --json
+  salai shopping-list "חלב" --brand-strict --no-alternatives --json
+  salai fulfill "חלב, לחם" --json
   salai call fulfill_shopping_list --args '{"items":[{"query":"חלב","quantity":2}],"scope":{"mode":"online_only","maxStores":3}}' --json
 `);
 }

package/dist/commands/fulfill.js.map

@@ -1 +1 @@
-{"version":3,"file":"fulfill.js","sourceRoot":"","sources":["../../src/commands/fulfill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAW,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,UAAU,uBAAuB,CACrC,OAAgB,EAChB,SAAgC,EAChC,MAAqB;IAErB,OAAO;SACJ,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CACV,2CAA2C;QACzC,0DAA0D,CAC7D;SACA,SAAS,CACR,IAAI,MAAM,CACR,gBAAgB,EAChB,6FAA6F,CAC9F;SACE,OAAO,CAAC,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;SACtC,OAAO,CAAC,aAAa,CAAC,CAC1B;SACA,MAAM,CAAC,kBAAkB,EAAE,kEAAkE,EAAE,IAAI,CAAC;SACpG,MAAM,CAAC,eAAe,EAAE,kDAAkD,CAAC;SAC3E,MAAM,CAAC,gBAAgB,EAAE,+DAA+D,CAAC;SACzF,MAAM,CAAC,mBAAmB,EAAE,6DAA6D,CAAC;SAC1F,MAAM,CAAC,KAAK,EAAE,WAAqB,EAAE,IAAI,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QAEjC,IAAI,OAA2B,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC3D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAA4B;YACpC,OAAO;YACP,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,KAAK;gBAChB,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,EAAE;aAC9C;YACD,YAAY,EAAE;gBACZ,OAAO,EAAE,IAAI,CAAC,YAAY,KAAK,KAAK;aACrC;YACD,IAAI,EAAE,OAAO;SACd,CAAC;QAEF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,IAAI,CAAC,YAAwC,CAAC,MAAM,GAAG,YAAY,CAAC;QACvE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,uBAAuB,EAAE,IAAI,CAAC,CAAC;QACrE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;QAC7E,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC,CAAC;SACD,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;;;;CAyBL,CACI,CAAC;AACN,CAAC"}
+{"version":3,"file":"fulfill.js","sourceRoot":"","sources":["../../src/commands/fulfill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAW,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,UAAU,uBAAuB,CACrC,OAAgB,EAChB,SAAgC,EAChC,MAAqB;IAErB,OAAO;SACJ,OAAO,CAAC,oBAAoB,CAAC;SAC7B,KAAK,CAAC,eAAe,CAAC;SACtB,WAAW,CACV,uDAAuD;QACrD,0DAA0D,CAC7D;SACA,SAAS,CACR,IAAI,MAAM,CACR,gBAAgB,EAChB,6FAA6F,CAC9F;SACE,OAAO,CAAC,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;SACtC,OAAO,CAAC,aAAa,CAAC,CAC1B;SACA,MAAM,CAAC,kBAAkB,EAAE,kEAAkE,EAAE,IAAI,CAAC;SACpG,MAAM,CAAC,eAAe,EAAE,kDAAkD,CAAC;SAC3E,MAAM,CAAC,gBAAgB,EAAE,+DAA+D,CAAC;SACzF,MAAM,CAAC,mBAAmB,EAAE,6DAA6D,CAAC;SAC1F,MAAM,CAAC,KAAK,EAAE,WAAqB,EAAE,IAAI,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QAEjC,IAAI,OAA2B,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC3D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAA4B;YACpC,OAAO;YACP,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,KAAK;gBAChB,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,EAAE;aAC9C;YACD,YAAY,EAAE;gBACZ,OAAO,EAAE,IAAI,CAAC,YAAY,KAAK,KAAK;aACrC;YACD,IAAI,EAAE,OAAO;SACd,CAAC;QAEF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,IAAI,CAAC,YAAwC,CAAC,MAAM,GAAG,YAAY,CAAC;QACvE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,uBAAuB,EAAE,IAAI,CAAC,CAAC;QACrE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;QAC7E,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC,CAAC;SACD,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BL,CACI,CAAC;AACN,CAAC"}

package/dist/mcpClient.d.ts

@@ -4,7 +4,7 @@
  */
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 export declare const DEFAULT_MCP_URL = "https://mcp.salai.co.il/mcp";
-export declare const PACKAGE_VERSION = "0.1.4";
+export declare const PACKAGE_VERSION = "0.1.5";
 export interface McpClientOptions {
     apiKey: string | null;
     url: string;

package/dist/mcpClient.js

@@ -5,7 +5,7 @@
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 export const DEFAULT_MCP_URL = 'https://mcp.salai.co.il/mcp';
-export const PACKAGE_VERSION = '0.1.4';
+export const PACKAGE_VERSION = '0.1.5';
 export function resolveConfig(overrides) {
     return {
         apiKey: overrides?.apiKey ||

package/dist/salai.js

@@ -60,7 +60,7 @@ registerCallCommands(program, getClient, isJson);
 registerFulfillCommands(program, getClient, isJson);
 program.addHelpText('after', `
 AI agents: use --json on every command. Run salai <command> --help for that command's flags
-(e.g. salai fulfill --help). Full MCP args: salai call <toolName> --args '{"…"}' --json
+(e.g. salai shopping-list --help or salai fulfill --help). Full MCP args: salai call <toolName> --args '{"…"}' --json
 or salai tools --json to list tools from the server.
 `);
 program.exitOverride();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "salai",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Salai grocery CLI for Israeli product search, price comparison, and cart workflows",
   "keywords": [
     "salai",