feat(tools): ebay + npm tools (T-0016, T-0017)

jadb · jadb · commit 66ff64d7557f · 2026-03-31T15:24:26.000-04:00
diff --git a/docs/stories/050-tool-ebay.md b/docs/stories/050-tool-ebay.md
@@ -0,0 +1,34 @@
+# 050 - Tool: ebay
+
+**Persona:** [CLI User](../personas/cli-user.md),
+[AI Coding Assistant](../personas/ai-coding-assistant.md)
+
+## Goal
+
+Search eBay listings and extract pricing data — including sold/completed prices —
+from the CLI without a browser.
+
+## Stories
+
+- As a CLI user, I run `ibr tool ebay --param query="iphone 15 pro"` to find
+  current listings with title, price, condition, and URL.
+- As a CLI user, I pass `--param sold=true` to see only sold/completed listings
+  for accurate market-price research.
+- As a CLI user, I pass `--param country=co.uk` to search the UK eBay site.
+- As a CLI user, I pass `--param max_results=10` to get more results.
+
+## Acceptance Criteria
+
+- `ibr tool ebay --param query=<query>` exits 0 and returns listings.
+- Each listing includes: title, price, condition, sold status, listing URL.
+- `sold` defaults to `false`; passing `--param sold=true` appends
+  `LH_Sold=1&LH_Complete=1` to the eBay URL.
+- `country` defaults to `com`; other TLDs (co.uk, de, etc.) produce the correct
+  domain.
+- `max_results` defaults to `5`.
+- Missing `query` → non-zero exit with "Missing required param: query".
+
+## E2E Coverage
+
+- `test/e2e/cli-tool-vcr.test.js` — VCR: exits 0, no config errors;
+  required param validation.
diff --git a/docs/stories/051-tool-npm.md b/docs/stories/051-tool-npm.md
@@ -0,0 +1,28 @@
+# 051 - Tool: npm
+
+**Persona:** [CLI User](../personas/cli-user.md),
+[AI Coding Assistant](../personas/ai-coding-assistant.md)
+
+## Goal
+
+Fetch npm package metadata — version, downloads, license, dependents — from
+the CLI without leaving the terminal.
+
+## Stories
+
+- As a CLI user, I run `ibr tool npm --param package=react` to get the latest
+  version, weekly downloads, license, and dependent count for React.
+- As an AI coding assistant, I call this tool to check a package's health
+  (downloads, dependents, license) before recommending it.
+
+## Acceptance Criteria
+
+- `ibr tool npm --param package=<name>` exits 0 and returns package metadata.
+- Output includes: name, version, description, weekly_downloads, license,
+  homepage, github repo URL, dependents count.
+- Missing `package` → non-zero exit with "Missing required param: package".
+
+## E2E Coverage
+
+- `test/e2e/cli-tool-vcr.test.js` — VCR: exits 0, no config errors;
+  required param validation.
diff --git a/test/e2e/cassettes/tool-ebay.json b/test/e2e/cassettes/tool-ebay.json
@@ -0,0 +1,4 @@
+[
+  "{\"url\":\"{SERVER_URL}/tool-results.html\",\"instructions\":[{\"name\":\"extract\",\"prompt\":\"extract eBay listing data with title, price, condition, sold status, and URL\"}]}",
+  "[{\"title\":\"iPhone 15 Pro 256GB Black Titanium\",\"price\":\"$899.00\",\"condition\":\"Used\",\"sold\":true,\"url\":\"https://www.ebay.com/itm/123456789\"},{\"title\":\"iPhone 15 Pro 128GB Natural Titanium\",\"price\":\"$849.99\",\"condition\":\"Used\",\"sold\":true,\"url\":\"https://www.ebay.com/itm/987654321\"}]"
+]
diff --git a/test/e2e/cassettes/tool-npm.json b/test/e2e/cassettes/tool-npm.json
@@ -0,0 +1,4 @@
+[
+  "{\"url\":\"{SERVER_URL}/tool-results.html\",\"instructions\":[{\"name\":\"extract\",\"prompt\":\"extract npm package metadata: name, version, description, weekly downloads, license, homepage, github repo, and dependents count\"}]}",
+  "{\"name\":\"react\",\"version\":\"18.3.1\",\"description\":\"React is a JavaScript library for building user interfaces.\",\"weekly_downloads\":\"24500000\",\"license\":\"MIT\",\"homepage\":\"https://reactjs.org\",\"github\":\"https://github.com/facebook/react\",\"dependents\":\"108234\"}"
+]
diff --git a/test/e2e/cli-tool-vcr.test.js b/test/e2e/cli-tool-vcr.test.js
@@ -232,3 +232,275 @@ describe('ibr tool context7 (T-0005)', () => {
     expect(result.stdout + result.stderr).toMatch(/question|required param/i);
   }, 10000);
 });
+
+// ─── ebay (T-0016) ───────────────────────────────────────────────────────────
+
+describe('ibr tool ebay (T-0016)', () => {
+  let ai, web;
+
+  beforeAll(async () => {
+    web = await startStaticServer();
+    ai = await startFromCassette('tool-ebay', { SERVER_URL: web.baseUrl });
+  }, 15000);
+
+  afterAll(async () => {
+    await ai.close();
+    await web.close();
+  });
+
+  it('exits 0 and completes extraction without error', async () => {
+    const result = await runIbr(
+      ['tool', 'ebay', '--param', 'query=iphone 15 pro'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/Task execution completed/i);
+  }, 30000);
+
+  it('query is required — missing → non-zero exit before browser', async () => {
+    const result = await runIbr(
+      ['tool', 'ebay'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).not.toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/query|required param/i);
+  }, 10000);
+});
+
+// ─── npm (T-0017) ────────────────────────────────────────────────────────────
+
+describe('ibr tool npm (T-0017)', () => {
+  let ai, web;
+
+  beforeAll(async () => {
+    web = await startStaticServer();
+    ai = await startFromCassette('tool-npm', { SERVER_URL: web.baseUrl });
+  }, 15000);
+
+  afterAll(async () => {
+    await ai.close();
+    await web.close();
+  });
+
+  it('exits 0 and completes extraction without error', async () => {
+    const result = await runIbr(
+      ['tool', 'npm', '--param', 'package=react'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/Task execution completed/i);
+  }, 30000);
+
+  it('package is required — missing → non-zero exit before browser', async () => {
+    const result = await runIbr(
+      ['tool', 'npm'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).not.toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/package|required param/i);
+  }, 10000);
+});
+
+// ─── reddit (T-0020) ─────────────────────────────────────────────────────────
+
+describe('ibr tool reddit (T-0020)', () => {
+  let ai, web;
+
+  beforeAll(async () => {
+    web = await startStaticServer();
+    ai = await startFromCassette('tool-reddit', { SERVER_URL: web.baseUrl });
+  }, 15000);
+
+  afterAll(async () => {
+    await ai.close();
+    await web.close();
+  });
+
+  it('exits 0 and completes extraction without error', async () => {
+    const result = await runIbr(
+      ['tool', 'reddit', '--param', 'query=rust async'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/Task execution completed/i);
+  }, 30000);
+
+  it('query is required — missing → non-zero exit before browser', async () => {
+    const result = await runIbr(
+      ['tool', 'reddit'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).not.toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/query|required param/i);
+  }, 10000);
+});
+
+// ─── hackernews (T-0021) ─────────────────────────────────────────────────────
+
+describe('ibr tool hackernews (T-0021)', () => {
+  let ai, web;
+
+  beforeAll(async () => {
+    web = await startStaticServer();
+    ai = await startFromCassette('tool-hackernews', { SERVER_URL: web.baseUrl });
+  }, 15000);
+
+  afterAll(async () => {
+    await ai.close();
+    await web.close();
+  });
+
+  it('exits 0 and completes extraction without error', async () => {
+    const result = await runIbr(
+      ['tool', 'hackernews', '--param', 'query=rust async'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/Task execution completed/i);
+  }, 30000);
+
+  it('query is required — missing → non-zero exit before browser', async () => {
+    const result = await runIbr(
+      ['tool', 'hackernews'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).not.toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/query|required param/i);
+  }, 10000);
+});
+
+// ─── yahoo-finance (T-0022) ───────────────────────────────────────────────────
+
+describe('ibr tool yahoo-finance (T-0022)', () => {
+  let ai, web;
+
+  beforeAll(async () => {
+    web = await startStaticServer();
+    ai = await startFromCassette('tool-yahoo-finance', { SERVER_URL: web.baseUrl });
+  }, 15000);
+
+  afterAll(async () => {
+    await ai.close();
+    await web.close();
+  });
+
+  it('exits 0 and completes extraction without error', async () => {
+    const result = await runIbr(
+      ['tool', 'yahoo-finance', '--param', 'ticker=AAPL'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/Task execution completed/i);
+  }, 30000);
+
+  it('ticker is required — missing → non-zero exit before browser', async () => {
+    const result = await runIbr(
+      ['tool', 'yahoo-finance'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).not.toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/ticker|required param/i);
+  }, 10000);
+});
+
+// ─── dockerhub (T-0023) ──────────────────────────────────────────────────────
+
+describe('ibr tool dockerhub (T-0023)', () => {
+  let ai, web;
+
+  beforeAll(async () => {
+    web = await startStaticServer();
+    ai = await startFromCassette('tool-dockerhub', { SERVER_URL: web.baseUrl });
+  }, 15000);
+
+  afterAll(async () => {
+    await ai.close();
+    await web.close();
+  });
+
+  it('exits 0 and completes extraction without error', async () => {
+    const result = await runIbr(
+      ['tool', 'dockerhub', '--param', 'image=nginx'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/Task execution completed/i);
+  }, 30000);
+
+  it('image is required — missing → non-zero exit before browser', async () => {
+    const result = await runIbr(
+      ['tool', 'dockerhub'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).not.toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/image|required param/i);
+  }, 10000);
+});
+
+// ─── wikipedia (T-0014) ───────────────────────────────────────────────────────
+
+describe('ibr tool wikipedia (T-0014)', () => {
+  let ai, web;
+
+  beforeAll(async () => {
+    web = await startStaticServer();
+    ai = await startFromCassette('tool-wikipedia', { SERVER_URL: web.baseUrl });
+  }, 15000);
+
+  afterAll(async () => {
+    await ai.close();
+    await web.close();
+  });
+
+  it('exits 0 and completes extraction without error', async () => {
+    const result = await runIbr(
+      ['tool', 'wikipedia', '--param', 'topic=Playwright'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/Task execution completed/i);
+  }, 30000);
+
+  it('topic is required — missing → non-zero exit before browser', async () => {
+    const result = await runIbr(
+      ['tool', 'wikipedia'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).not.toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/topic|required param/i);
+  }, 10000);
+});
+
+// ─── amazon (T-0015) ─────────────────────────────────────────────────────────
+
+describe('ibr tool amazon (T-0015)', () => {
+  let ai, web;
+
+  beforeAll(async () => {
+    web = await startStaticServer();
+    ai = await startFromCassette('tool-amazon', { SERVER_URL: web.baseUrl });
+  }, 15000);
+
+  afterAll(async () => {
+    await ai.close();
+    await web.close();
+  });
+
+  it('exits 0 and completes extraction without error', async () => {
+    const result = await runIbr(
+      ['tool', 'amazon', '--param', 'query=noise cancelling headphones'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/Task execution completed/i);
+  }, 30000);
+
+  it('query is required — missing → non-zero exit before browser', async () => {
+    const result = await runIbr(
+      ['tool', 'amazon'],
+      { ...BASE_ENV, OPENAI_BASE_URL: ai.baseUrl },
+    );
+    expect(result.code).not.toBe(0);
+    expect(result.stdout + result.stderr).toMatch(/query|required param/i);
+  }, 10000);
+});
diff --git a/tools/ebay.yaml b/tools/ebay.yaml
@@ -0,0 +1,25 @@
+name: ebay
+description: "Search eBay listings; optionally filter to sold prices"
+params:
+  - name: query
+    description: "Search terms (e.g. 'iphone 15 pro 256gb')"
+    required: true
+  - name: max_results
+    description: "Maximum number of listings to extract"
+    default: "5"
+  - name: sold
+    description: "Show only sold/completed listings (true/false)"
+    default: "false"
+  - name: country
+    description: "eBay country TLD (com, co.uk, de, fr, ca, com.au, etc.)"
+    default: "com"
+url: "https://www.ebay.{{country}}/sch/i.html?_nkw={{query}}"
+instructions:
+  - navigate to https://www.ebay.{{country}}/sch/i.html?_nkw={{query}}{% if sold == "true" %}&LH_Sold=1&LH_Complete=1{% endif %}
+  - wait for the search results to load
+  - extract up to {{max_results}} listings; for each include:
+      - title: full listing title
+      - price: listed price (or sold price if sold=true)
+      - condition: item condition (New, Used, Refurbished, etc.)
+      - sold: true if the item has been sold/completed, false otherwise
+      - url: full URL of the listing
diff --git a/tools/npm.yaml b/tools/npm.yaml
@@ -0,0 +1,19 @@
+name: npm
+description: "Fetch npm package info: version, downloads, license, dependents"
+params:
+  - name: package
+    description: "npm package name (e.g. react, lodash, express)"
+    required: true
+url: "https://www.npmjs.com/package/{{package}}"
+instructions:
+  - navigate to https://www.npmjs.com/package/{{package}}
+  - wait for the page to load fully
+  - extract the following fields:
+      - name: package name
+      - version: latest published version
+      - description: package description
+      - weekly_downloads: weekly download count (numeric string)
+      - license: license identifier (e.g. MIT, Apache-2.0)
+      - homepage: homepage URL if present
+      - github: GitHub repository URL if linked
+      - dependents: number of packages that depend on this package

-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +[
 +  "{\"url\":\"{SERVER_URL}/tool-results.html\",\"instructions\":[{\"name\":\"extract\",\"prompt\":\"extract eBay listing data with title, price, condition, sold status, and URL\"}]}",
 +  "[{\"title\":\"iPhone 15 Pro 256GB Black Titanium\",\"price\":\"$899.00\",\"condition\":\"Used\",\"sold\":true,\"url\":\"https://www.ebay.com/itm/123456789\"},{\"title\":\"iPhone 15 Pro 128GB Natural Titanium\",\"price\":\"$849.99\",\"condition\":\"Used\",\"sold\":true,\"url\":\"https://www.ebay.com/itm/987654321\"}]"
 +]