@clien-ai/mcp 0.2.0 → 0.3.0

package/README.md

@@ -1,12 +1,16 @@
 # @clien-ai/mcp
 
-Run a full Clien.ai product-research pass from Claude Code. One tool —
-`clien_research` — that takes an idea, runs a 15-25 minute deep research pass
+Run a full Clien.ai product-research pass from Claude Code. The hero tool —
+`clien_research` — takes an idea, runs a 15-25 minute deep research pass
 on our sandbox, and hands you back a markdown report plus structured
 `report_data` (hypotheses, competitors, key findings) with a typed
 [trust layer](#trust-signals) — per-claim GROUNDED/SPECULATION/NO_RECEIPT
 classifications, source receipts, and robustness survival counts.
 
+Alongside it, [19 more tools](#tools) let an agent read and edit what a project
+already holds — projects, personas, interviews, reports, competitors, and
+community signals — most of them free.
+
 ---
 
 ## Quick start
@@ -98,13 +102,92 @@ simply omits them. The full Zod schema lives in
 
 ---
 
+## Tools
+
+Twenty tools. `clien_research` is the hero — the recommended default for
+validating an idea end to end. Everything else is either a **free read** for
+orienting on what a project already holds, or a **targeted primitive** for a
+narrow, cheaper probe.
+
+Descriptions below are condensed from each tool's own registered description in
+[`src/tools/registry.ts`](src/tools/registry.ts) — that file is the source of
+truth, and the server advertises the full text over `tools/list`.
+
+**Params are `snake_case`.** Five tools (`create_persona`, `generate_persona`,
+`enrich_persona`, `update_persona`, `interview_persona`) also still accept their
+pre-1.0 camelCase spellings (`projectId`, `companySize`, …) as deprecated
+aliases. They resolve to the same request and the same result; passing both
+spellings of one field with *different* values is rejected rather than silently
+resolved.
+
+An alias-only call is valid against the advertised schema too, not just honoured
+at call time — including on a client that pre-validates outgoing arguments. To
+make that true, the three ids that have an alias (`project_id` on
+`create_persona` / `generate_persona`, `persona_id` on `enrich_persona`) are no
+longer in their schema's `required` list; they are still mandatory, enforced
+when the call is handled, and omitting one fails with an error naming the param
+before anything is written. The **Required** columns below list what each tool
+actually needs, `required` list or not. New code should send the snake_case
+name — the aliases exist for callers written before the rename.
+
+### Research
+
+| Tool | Required | Cost | What it does |
+|------|----------|------|--------------|
+| `clien_research` | `idea` | debits credits | The full pass: markdown report + structured `report_data` with the typed [trust layer](#trust-signals). Typical wall time 15–25 min, progress streamed. Attach it to a project with `project_id` or `project_name` — a run with neither is refused. |
+| `clien_research_status` | — | free | Re-attach to an existing job by `job_id` — recovers a run that dropped with `-32000` and polls for completion. Called with no arguments it discovers your recent runs. |
+| `scan_competitors` | `topic` | debits credits | One web researcher over the COMPETITOR dimension only (2–10 min). Returns competitor profiles in `_meta.competitors`. Check the free `list_competitors` first. |
+| `search_forums` | `topic` | debits credits | One forum researcher over the COMMUNITY dimension only (2–10 min). Returns threads in `_meta.threads`. Check the free `list_community_signals` first. Run sequentially with `scan_competitors` on the same project — a parallel second call gets a 409. |
+
+### Projects
+
+| Tool | Required | Cost | What it does |
+|------|----------|------|--------------|
+| `get_project` | `project_id` | free | **Start here on an existing project.** Metadata plus counts, ids, and one-line summaries of its personas, interviews, competitors, community signals, and reports — replacing five `list_*` calls. Pass `include` to inline full records. A failed collection returns `{ error: "unavailable" }` under its key, which is *not* the same as empty. |
+| `list_projects` | — | free | Your projects, newest first, paginated. |
+| `create_project` | `name` | free | Create a project to group runs, personas, and reports. |
+
+### Personas
+
+| Tool | Required | Cost | What it does |
+|------|----------|------|--------------|
+| `list_personas` | `project_id` | free | The project's personas, newest first, paginated — including ones created in the web app. The entity list, not the grounding surface. |
+| `get_persona` | `persona_id` | free | One persona entity in full. Grounding (`sources[]`, `identityPriors`) lives on `report_data`, via `get_report`. |
+| `create_persona` | `project_id`, `name`, `role` | free | Create a persona from fields you already know. No AI, no credit. |
+| `update_persona` | `persona_id` | free | Correct explicit scalar fields on an existing persona. No AI, no credit. |
+| `generate_persona` | `project_id`, `name`, `role` | 1 credit | AI-generate a persona from a short brief, grounded by default in real user-voice evidence. A failed generation is never charged. |
+| `enrich_persona` | `persona_id` | 1 credit | AI-fill only the fields that are currently BLANK on an existing persona (or the ones named in `refresh`). A no-op charges nothing; a failure is refunded. |
+
+### Interviews
+
+| Tool | Required | Cost | What it does |
+|------|----------|------|--------------|
+| `interview_persona` | `action` | see note | Stateful multi-turn interview. `action:start` → `turn` (repeatedly) → `complete`, plus `transcript` and `reopen`. Each `turn` generates a real AI reply, metered by your monthly usage; per-turn credit pricing is not yet applied. |
+| `list_interviews` | `project_id` | free | The project's interviews, newest first, paginated — recovers ids for interviews started in the web app. |
+| `get_interview` | `interview_id` | free | One interview's full transcript, from just an id. |
+
+### Reports & collections
+
+| Tool | Required | Cost | What it does |
+|------|----------|------|--------------|
+| `list_reports` | — | free | Past `clien_research` runs, newest first. Optionally scoped to one `project_id`. |
+| `get_report` | `job_id` | free | A past run's full report + `report_data`, same shape `clien_research` returns. Use this instead of re-running. |
+| `list_competitors` | `project_id` | free | The project's deduped, accumulated competitor set, most-recently-seen first. Each of the four company facts carries a sibling `<fact>Grounding` — key on its `state`. |
+| `list_community_signals` | `project_id` | free | The project's deduped, accumulated thread set, newest-**discovered** first (a stable order — a thread seen again does not move back to page one). Carries the verbatim `relevantQuotes[]` cached at collection. |
+
+"free" above means what each tool's own description states: no credit cost and
+no side effects.
+
+**Not covered:** there is no delete tool. Projects and personas can be deleted
+in the web app, but not from here — an agent can create, read, and correct them,
+not remove them.
+
+---
+
 ## Recipes: composing beyond the hero
 
-`clien_research` is the hero — the recommended default for validating an idea
-end to end. Alongside it, the server exposes granular primitives (`create_persona`,
-`generate_persona`, `enrich_persona`, `interview_persona`, `scan_competitors`, `search_forums`,
-`list_projects` / `create_project`, `list_reports` / `get_report`,
-`clien_research_status`) you can sequence for targeted, cheaper checks.
+For a **full** validation, call the hero. Reach for a primitive composition only
+for a **narrow, cheaper probe**.
 
 See [`docs/recipes/`](../docs/recipes/) for the supported compositions:
 
@@ -112,12 +195,9 @@ See [`docs/recipes/`](../docs/recipes/) for the supported compositions:
 - [Pivot viability](../docs/recipes/pivot-viability.md) — research a pivot and compare it against the original
 - [New-market persona validation](../docs/recipes/new-market-persona-validation.md) — `create_persona` → `interview_persona`, no credits, no full run
 
-Rule of thumb: for a **full** validation, call the hero; reach for a primitive
-composition only for a **narrow, cheaper probe**.
-
 ---
 
-## Inputs
+## `clien_research` inputs
 
 | Field          | Type                     | Required | Default | Notes                                                                                            |
 |----------------|--------------------------|----------|---------|--------------------------------------------------------------------------------------------------|
@@ -125,6 +205,11 @@ composition only for a **narrow, cheaper probe**.
 | `depth`        | `"quick"` \| `"deep"`    | no       | `deep`  | `quick` caps cost; `deep` is the full 15-25 min pass                                             |
 | `project_id`   | UUID                     | no       |         | Existing Clien.ai project to attach the run to (returned in `_meta.project_id` from prior runs)  |
 | `project_name` | string (1-100 chars)     | no       |         | Name for a new project. Supply when `project_id` is not set so the report is discoverable in the web UI. Ignored when `project_id` is also provided. |
+| `confirm_spend` | boolean                 | no       |         | Leave unset on a first attempt. Set true only to confirm a run after a prior call returned the soft daily-spend-guard prompt. |
+| `run_anyway`   | boolean                  | no       |         | Leave unset on a first attempt. Set true only to override the soft task guard that refuses off-script inputs. |
+
+A run with neither `project_id` nor `project_name` is refused, so every report
+stays discoverable in the web UI.
 
 ## Outputs
 

package/dist/server.js

@@ -18,6 +18,13 @@ function log(...args) {
     // stderr only — stdout is the MCP transport.
     console.error('[clien-mcp]', ...args);
 }
+function recordToolUsage(toolName) {
+    // Minimal dogfooding telemetry (FUL-212): which tools agents actually call.
+    // stderr only — stdout is the MCP transport. Tool name + timestamp only;
+    // no args, no PII, no payloads. Distinct prefix keeps usage records
+    // greppable and parseable, separate from operational `[clien-mcp]` logs.
+    console.error('[clien-mcp:usage]', JSON.stringify({ tool: toolName, ts: new Date().toISOString() }));
+}
 /**
  * Default browser opener — lazily imports `open` so the package still loads
  * on systems that can't open a browser (we handle the error in OAuth).
@@ -80,6 +87,9 @@ export function createMcpServer() {
         if (!tool) {
             throw new Error(`Unknown tool: ${toolName}`);
         }
+        // Record usage once per valid tool call, before dispatch — a call that
+        // later errors is still usage (the agent reached for the tool).
+        recordToolUsage(toolName);
         // Per MCP spec, `progressToken` may be a string OR a number, and `0` or
         // `''` are valid token values. A truthy check (`progressToken ?`) silently
         // drops progress for those callers. Compare against `undefined` instead.

package/dist/server.js.map

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

package/dist/tools/collections.js

@@ -0,0 +1,433 @@
+/**
+ * `list_competitors` + `list_community_signals` (FUL-215 / U7) — read-only
+ * collection primitives over the project's persisted Research collections.
+ *
+ * Before these tools, a competitor or a community thread was only reachable
+ * NESTED inside a research report (`get_report` → `report_data.webResearch` /
+ * `forumResearch`), which meant an agent could not answer "what competitors does
+ * this project know about?" without picking a run first — and never saw rows
+ * merged from OTHER runs or from the web app. These read the deduped, append-only
+ * collections directly, so they surface the project's whole accumulated set.
+ *
+ * The MCP package is a thin bearer-auth HTTP client: both tools reuse the shared
+ * `apiCall` client from `research.ts` (same 401→refresh→retry behavior,
+ * per-endpoint timeouts) exactly as `personas.ts` / `reports.ts` do. No new HTTP
+ * machinery.
+ *
+ * Contract:
+ *   - list_competitors → GET /api/competitors?projectId&limit&offset →
+ *       { competitors: <raw row>[], pagination: { limit, offset, total } }
+ *   - list_community_signals → GET /api/community?projectId&limit&offset →
+ *       { communitySignals: <raw row>[], pagination: { limit, offset, total } }
+ *
+ * `offset` is an ABSOLUTE row offset honoured exactly by the endpoints (FUL-214),
+ * not rounded to a page boundary — identical semantics to `/api/personas`, so an
+ * agent can page with any offset it likes.
+ *
+ * ⚠️ The two collections do NOT share a sort order, and the difference is
+ * user-visible, so each tool must advertise its own. `listCompetitors` orders by
+ * `last_seen_at DESC` — a competitor re-sighted by a later run moves back to the
+ * top. `listCommunitySignals` orders by `created_at DESC`, the FIRST-sighting
+ * timestamp, precisely so the feed "never reshuffles when a thread is merged
+ * again" (app/lib/db/community-db.ts). Copying the competitor wording onto the
+ * community tool would tell an agent the newest ACTIVITY is on page one when what
+ * it actually gets is the newest DISCOVERY.
+ *
+ * ⚠️ VOCABULARY BOUNDARY (FUL-215 decision). The U6 endpoints return RAW
+ * snake_case database rows (`sentiment_summary`, `comment_count`, `hq_location`).
+ * The rest of the MCP surface speaks camelCase for the very same concepts — see
+ * `CompetitorProfileSchema` / `ForumThreadSchema` in `../types/report.js`, which
+ * back `scan_competitors` and `search_forums`. Shipping both spellings would mean
+ * an agent that ran `scan_competitors` and then `list_competitors` sees
+ * `commentCount` and `comment_count` for one number and cannot tell they are the
+ * same field. So this module maps at the tool boundary, via the two EXPLICIT
+ * named mappers below — deliberately not a generic snake→camel helper: the field
+ * list is part of the public MCP contract, so it must be readable in review and
+ * pinned by a test (`mcp/__tests__/collections.test.ts`), not derived by string
+ * surgery that silently admits whatever column is added next.
+ *
+ * Error mapping mirrors `personas.ts` / `reports.ts`: 401 → invalidate the cached
+ * session and surface a re-auth message; 404 → the project isn't owned by the
+ * caller (the endpoints deliberately make missing and not-owned indistinguishable);
+ * other non-ok → a generic "HTTP <n>" error. Everything here is read-only, so a
+ * timeout or network error is always safe to retry — no work is lost, no credit
+ * is spent.
+ */
+import { z } from 'zod';
+import { ToolError } from './errors.js';
+import { apiCall, categorizeFetchError, truncate, } from './research.js';
+const COLLECTIONS_FETCH_TIMEOUT_MS = 30_000;
+// Mirrors `CollectionListQuerySchema` in app/lib/api/collection-list-query.ts.
+// The MCP package is published separately and cannot import from the Next.js
+// app; the server re-validates regardless — this is the advertised spec.
+const LIST_LIMIT_MAX = 100;
+const LIST_LIMIT_DEFAULT = 20;
+export const ListCompetitorsInputSchema = z.object({
+    project_id: z
+        .string()
+        .uuid()
+        .describe('UUID of the project whose competitor set to list. Get it from ' +
+        '`list_projects` (or `create_project`). Rejected with a 404 if you do not ' +
+        'own the project. Lists the project\'s whole accumulated competitor set — ' +
+        'including competitors found by web-app runs and by earlier ' +
+        '`scan_competitors` / `clien_research` calls, deduped across runs.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(LIST_LIMIT_MAX)
+        .optional()
+        .default(LIST_LIMIT_DEFAULT)
+        .describe(`Maximum number of competitors to return (1-${LIST_LIMIT_MAX}, default ${LIST_LIMIT_DEFAULT}). ` +
+        'Most-recently-seen competitors come first.'),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .default(0)
+        .describe('Number of competitors to skip before returning results (default 0). ' +
+        'An absolute row offset, honoured exactly — combine with `limit` to page ' +
+        'through a large set; the total count is in `_meta.pagination.total`.'),
+});
+export const ListCommunitySignalsInputSchema = z.object({
+    project_id: z
+        .string()
+        .uuid()
+        .describe('UUID of the project whose community signals to list. Get it from ' +
+        '`list_projects` (or `create_project`). Rejected with a 404 if you do not ' +
+        'own the project. Lists the project\'s whole accumulated thread set — ' +
+        'including threads found by web-app runs and by earlier `search_forums` / ' +
+        '`clien_research` calls, deduped by url across runs.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(LIST_LIMIT_MAX)
+        .optional()
+        .default(LIST_LIMIT_DEFAULT)
+        .describe(`Maximum number of community signals to return (1-${LIST_LIMIT_MAX}, default ${LIST_LIMIT_DEFAULT}). ` +
+        'Newest-discovered first. This feed is ordered by when the project FIRST saw a ' +
+        'thread, and that order is stable — a thread seen again by a later run does not ' +
+        'jump back to the top (unlike `list_competitors`, which is ordered by latest sighting).'),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .default(0)
+        .describe('Number of community signals to skip before returning results (default 0). ' +
+        'An absolute row offset, honoured exactly — combine with `limit` to page ' +
+        'through a large feed; the total count is in `_meta.pagination.total`.'),
+});
+function nullableString(value) {
+    return typeof value === 'string' ? value : null;
+}
+function nullableNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+function stringArray(value) {
+    return Array.isArray(value) ? value.filter((v) => typeof v === 'string') : [];
+}
+function factGrounding(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+/**
+ * `competitors` row → the camelCase competitor exposed to agents.
+ *
+ * The field list IS the public contract (FUL-215 decision), so it is written out
+ * rather than derived. Every mapped key exists because an agent can act on it or
+ * reason with it; the columns NOT mapped are listed here so the omissions are as
+ * reviewable as the inclusions:
+ *
+ *   - `dedup_key` — pure write-path machinery (how the merge RPC recognises the
+ *     same competitor across runs). Meaningless to a reader, and exposing it
+ *     invites an agent to construct one.
+ *   - `funding_asserted_at`, `employee_count_asserted_at`, `founded_asserted_at`,
+ *     `hq_location_asserted_at` — FUL-178 merge-arbitration timestamps: they exist
+ *     to decide WHICH RUN'S value wins a conflict, not to tell a reader how fresh
+ *     a fact is. The reader-facing recency signals are already here:
+ *     `<fact>Grounding.sourceRetrievedAt` (when the source was fetched) and the
+ *     row-level `lastSeenAt`.
+ *
+ * Naming follows `CompetitorProfileSchema` (../types/report.ts), the shape
+ * `scan_competitors` already returns — hence `employeeCount` (not `employees`)
+ * and `hqLocation`. `relevantHypotheses` has no column here: it is a per-report
+ * association, not a property of the deduped competitor.
+ */
+export function toCompetitorSummary(row) {
+    return {
+        id: nullableString(row.id),
+        projectId: nullableString(row.project_id),
+        name: nullableString(row.name),
+        url: nullableString(row.url),
+        description: nullableString(row.description),
+        pricing: nullableString(row.pricing),
+        strengths: stringArray(row.strengths),
+        weaknesses: stringArray(row.weaknesses),
+        // FUL-145 (M1b) company metadata + its FUL-201 per-fact grounding. The value
+        // and its grounding are advanced in lockstep at merge time, so a grounding
+        // always describes the value shown beside it — which is exactly why both must
+        // travel together: a funding figure without its state is an un-auditable claim.
+        funding: nullableString(row.funding),
+        employeeCount: nullableString(row.employee_count),
+        founded: nullableString(row.founded),
+        hqLocation: nullableString(row.hq_location),
+        fundingGrounding: factGrounding(row.funding_grounding),
+        employeeCountGrounding: factGrounding(row.employee_count_grounding),
+        foundedGrounding: factGrounding(row.founded_grounding),
+        hqLocationGrounding: factGrounding(row.hq_location_grounding),
+        // Provenance: `source` is the FUL-21 origin ('validation' | 'mcp' | 'web'),
+        // `firstSeenRunId` the job that first surfaced this competitor — an agent can
+        // pass it straight to `get_report`.
+        source: nullableString(row.source),
+        firstSeenRunId: nullableString(row.first_seen_run_id),
+        lastSeenAt: nullableString(row.last_seen_at),
+        createdAt: nullableString(row.created_at),
+    };
+}
+/**
+ * `community_signals` row → the camelCase community signal exposed to agents.
+ *
+ * Two renames worth flagging, both required by the FUL-215 "one spelling per
+ * concept" rule rather than by casing:
+ *   - `sentiment_summary` → `sentimentSummary` (matches `ForumThreadSchema`).
+ *   - `quotes` → `relevantQuotes`. The column is POPULATED from
+ *     `report_data.forumResearch.threads[].relevantQuotes` (see the FUL-60 merge
+ *     RPC), so these are the same concept that lost its adjective on the way into
+ *     Postgres. `search_forums` returns `relevantQuotes`; so does this.
+ *
+ * Every column on the table is mapped — there is no bookkeeping-only column here
+ * apart from the dedup the RPC performs on `url`, which is itself user-facing.
+ */
+export function toCommunitySignalSummary(row) {
+    return {
+        id: nullableString(row.id),
+        projectId: nullableString(row.project_id),
+        title: nullableString(row.title),
+        url: nullableString(row.url),
+        platform: nullableString(row.platform),
+        sentimentSummary: nullableString(row.sentiment_summary),
+        relevantQuotes: stringArray(row.quotes),
+        upvotes: nullableNumber(row.upvotes),
+        commentCount: nullableNumber(row.comment_count),
+        source: nullableString(row.source),
+        firstSeenRunId: nullableString(row.first_seen_run_id),
+        lastSeenAt: nullableString(row.last_seen_at),
+        createdAt: nullableString(row.created_at),
+    };
+}
+export class CollectionToolError extends ToolError {
+}
+function formatZodError(error) {
+    return error.issues.map((i) => `${i.path.join('.') || 'input'}: ${i.message}`).join('; ');
+}
+function makeCtx(deps) {
+    return { config: deps.config, session: deps.session, fetch: deps.fetch ?? fetch };
+}
+/**
+ * Shared non-ok handling, mirroring `personas.ts`: 401 drops the cached session
+ * and surfaces a re-auth message; 404 means the project is missing OR not the
+ * caller's (U6 makes the two indistinguishable on purpose, so a caller cannot
+ * probe for other users' project ids); 400 surfaces the server's validation
+ * detail; everything else surfaces a generic HTTP error.
+ */
+async function throwForResponse(response, deps, action, projectId) {
+    const category = categorizeFetchError(response.status);
+    if (category === 'auth') {
+        if (response.refreshError?.kind !== 'transient')
+            deps.invalidateSession?.();
+        throw new CollectionToolError('Session expired. Re-run any Clien.ai tool to re-authenticate, then try again.');
+    }
+    if (response.status === 404) {
+        throw new CollectionToolError(`Project ${projectId} not found. It may not exist or may belong to a different ` +
+            'account — call list_projects to confirm the id.');
+    }
+    const text = await response.text().catch(() => '');
+    let detail = truncate(text, 200);
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed?.error)
+            detail = `${parsed.error}${parsed.code ? ` (${parsed.code})` : ''}`;
+    }
+    catch {
+        // non-JSON body — fall back to the truncated raw text
+    }
+    if (response.status === 400) {
+        throw new CollectionToolError(`Could not ${action} — ${detail}`);
+    }
+    throw new CollectionToolError(`Failed to ${action} (HTTP ${response.status}): ${detail}`);
+}
+/**
+ * Shared GET + parse for both collections. Keeps the two tools to their
+ * differences (endpoint, collection key, rendering) instead of duplicating the
+ * timeout/auth/error dance.
+ *
+ * `collectionKey` is the array property the endpoint returns (`competitors` /
+ * `communitySignals`). It is checked here rather than defaulted at the call site
+ * ON PURPOSE: a 200 whose body is unreadable — an HTML error page from a proxy, a
+ * truncated response, a reshaped envelope — would otherwise fall through to an
+ * empty array, and an empty array is not neutral in these tools. Both of them
+ * answer an empty collection with "run scan_competitors / search_forums", which
+ * DEBITS CREDITS. So a transport failure that reads as "this project has nothing"
+ * can cost the user real money and put a false "no competitors" claim in front of
+ * an agent. "I could not read the answer" and "the answer is none" must not look
+ * the same.
+ */
+async function fetchCollection(deps, path, collectionKey, projectId, limit, offset, action) {
+    const ctx = makeCtx(deps);
+    const query = new URLSearchParams({
+        projectId,
+        limit: String(limit),
+        offset: String(offset),
+    });
+    let response;
+    try {
+        response = await apiCall(ctx, 'GET', `${path}?${query.toString()}`, {
+            timeoutMs: COLLECTIONS_FETCH_TIMEOUT_MS,
+        });
+    }
+    catch (err) {
+        const e = err;
+        if (e.name === 'AbortError' || e.name === 'TimeoutError') {
+            throw new CollectionToolError(`Timed out after ${COLLECTIONS_FETCH_TIMEOUT_MS / 1000}s trying to ${action}. ` +
+                'Try again in a moment — this is a read, so nothing was spent and nothing was lost.');
+        }
+        throw err;
+    }
+    if (!response.ok)
+        await throwForResponse(response, deps, action, projectId);
+    const json = (await response.json().catch(() => null));
+    const rows = json?.[collectionKey];
+    if (!Array.isArray(rows)) {
+        throw new CollectionToolError(`Could not ${action} — the server returned a 200 with an unreadable body ` +
+            `(no \`${collectionKey}\` array). This is NOT an empty collection: the request ` +
+            'failed and the project may well have data. Retry — this is a read, so nothing ' +
+            'was spent and nothing was lost. Do not run a paid scan on the strength of this.');
+    }
+    const pagination = json?.pagination ?? {};
+    return { rows, pagination };
+}
+/**
+ * The pagination echoed back in `_meta`. Prefers what the server reported (it is
+ * authoritative about `total`) but always yields three defined numbers, so an
+ * agent paging on `_meta.pagination` never has to handle a missing field on a
+ * response the server reshaped.
+ */
+function resolvePagination(serverPagination, limit, offset, total) {
+    return {
+        limit: serverPagination.limit ?? limit,
+        offset: serverPagination.offset ?? offset,
+        total,
+    };
+}
+/** Shared "N more not shown" tail so both lists page identically. */
+function moreLine(offset, shown, total) {
+    const seen = offset + shown;
+    return seen < total ? `\n\n${total - seen} more not shown — page with offset=${seen}.` : '';
+}
+export async function listCompetitors(input, deps) {
+    const parsed = ListCompetitorsInputSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new CollectionToolError(`Invalid input — ${formatZodError(parsed.error)}`);
+    }
+    const { project_id: projectId, limit, offset } = parsed.data;
+    const { rows, pagination } = await fetchCollection(deps, '/api/competitors', 'competitors', projectId, limit, offset, 'list competitors');
+    const competitors = rows.map(toCompetitorSummary);
+    const total = pagination.total ?? competitors.length;
+    let text;
+    if (competitors.length === 0) {
+        text =
+            offset > 0
+                ? `No competitors at offset ${offset} in project ${projectId} (total: ${total}).`
+                : `No competitors recorded for project ${projectId}. Run scan_competitors (or ` +
+                    'clien_research) to populate the project\'s competitor set.';
+    }
+    else {
+        // Numbering is offset-aware so a second page reads as 21., 22., … rather
+        // than restarting at 1 and looking like a different result set.
+        const lines = competitors.map((c, i) => {
+            const header = `${offset + i + 1}. **${c.name ?? 'Unnamed competitor'}**${c.pricing ? ` — ${c.pricing}` : ''}`;
+            const desc = c.description ? `\n   ${truncate(c.description, 240)}` : '';
+            const url = c.url ? `\n   ${c.url}` : '';
+            const meta = [
+                c.funding && `Funding: ${truncate(c.funding, 80)}`,
+                c.employeeCount && `Employees: ${truncate(c.employeeCount, 40)}`,
+                c.founded && `Founded: ${truncate(c.founded, 40)}`,
+                c.hqLocation && `HQ: ${truncate(c.hqLocation, 80)}`,
+            ].filter(Boolean);
+            const metaLine = meta.length ? `\n   ${meta.join(' · ')}` : '';
+            return `${header}${desc}${url}${metaLine}\n   id: ${c.id ?? 'unknown'}`;
+        });
+        // The trust caveat is only worth its length when there is actually a company
+        // fact on this page to be careful about — a set with no M1b facts would just
+        // get a warning about nothing.
+        // `||`, not `??`: this must agree with the `c.funding && …` truthiness guards
+        // above that decide whether each fact RENDERS. With `??`, a competitor whose
+        // funding is '' short-circuits on the empty string and the caveat disappears
+        // even though a later fact is populated and on screen.
+        const hasCompanyFacts = competitors.some((c) => Boolean(c.funding || c.employeeCount || c.founded || c.hqLocation));
+        const trustLine = hasCompanyFacts
+            ? ' The company facts (funding/employees/founded/HQ) are only as trustworthy as their ' +
+                'sibling `<fact>Grounding.state`: treat a missing or non-GROUNDED grounding as ' +
+                'unverified rather than as fact.'
+            : '';
+        text =
+            `Found ${total} competitor${total === 1 ? '' : 's'} in project ${projectId}:\n\n` +
+                `${lines.join('\n\n')}${moreLine(offset, competitors.length, total)}\n\n` +
+                `Full records are in \`_meta.competitors\`.${trustLine}`;
+    }
+    return {
+        content: [{ type: 'text', text }],
+        _meta: { competitors, pagination: resolvePagination(pagination, limit, offset, total) },
+    };
+}
+export async function listCommunitySignals(input, deps) {
+    const parsed = ListCommunitySignalsInputSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new CollectionToolError(`Invalid input — ${formatZodError(parsed.error)}`);
+    }
+    const { project_id: projectId, limit, offset } = parsed.data;
+    const { rows, pagination } = await fetchCollection(deps, '/api/community', 'communitySignals', projectId, limit, offset, 'list community signals');
+    const signals = rows.map(toCommunitySignalSummary);
+    const total = pagination.total ?? signals.length;
+    let text;
+    if (signals.length === 0) {
+        text =
+            offset > 0
+                ? `No community signals at offset ${offset} in project ${projectId} (total: ${total}).`
+                : `No community signals recorded for project ${projectId}. Run search_forums (or ` +
+                    'clien_research) to populate the project\'s community feed.';
+    }
+    else {
+        const lines = signals.map((s, i) => {
+            const platform = s.platform ? ` [${s.platform}]` : '';
+            const header = `${offset + i + 1}. **${truncate(s.title ?? 'Untitled thread', 160)}**${platform}`;
+            const sentiment = s.sentimentSummary ? `\n   ${truncate(s.sentimentSummary, 240)}` : '';
+            const url = s.url ? `\n   ${s.url}` : '';
+            const quote = s.relevantQuotes.length
+                ? `\n   "${truncate(s.relevantQuotes[0] ?? '', 200)}"`
+                : '';
+            const engagement = [
+                s.upvotes !== null && `${s.upvotes} upvotes`,
+                s.commentCount !== null && `${s.commentCount} comments`,
+            ].filter(Boolean);
+            const engagementLine = engagement.length ? `\n   ${engagement.join(' · ')}` : '';
+            return `${header}${sentiment}${url}${quote}${engagementLine}\n   id: ${s.id ?? 'unknown'}`;
+        });
+        text =
+            `Found ${total} community signal${total === 1 ? '' : 's'} in project ${projectId}:\n\n` +
+                `${lines.join('\n\n')}${moreLine(offset, signals.length, total)}\n\n` +
+                'Full records — including every cached quote — are in `_meta.communitySignals`.';
+    }
+    return {
+        content: [{ type: 'text', text }],
+        _meta: {
+            communitySignals: signals,
+            pagination: resolvePagination(pagination, limit, offset, total),
+        },
+    };
+}
+//# sourceMappingURL=collections.js.map

package/dist/tools/collections.js.map

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