@whereamimentioned/api-client 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1374 @@
+import { z } from 'zod';
+
+/**
+ * The const tuples that appear on the wire of the public API (08-PUBLIC-API section 4), each a
+ * `const` tuple so one value serves Zod `z.enum(...)`, the TypeScript union and, in the app, the
+ * Drizzle `pgEnum(...)` of the same column.
+ *
+ * This file is the single source of truth for these fifteen. The app's `src/types/enums.ts`
+ * re-exports them from here BY IDENTITY (never a copy), so the database enum, the API contract
+ * and every client agree by construction. The direction matters: the package must build on its
+ * own in the public mirror (10-CLI section 10.2), which carries `packages/**` and nothing of
+ * `src/`, so nothing in this package may import from the app. App-only enums (subscription
+ * statuses, credit reasons, alert channels) stay in the app.
+ */
+declare const ORG_TYPES: readonly ["agency", "brand"];
+type OrgType = (typeof ORG_TYPES)[number];
+declare const ORG_ROLES: readonly ["owner", "admin", "member", "viewer"];
+type OrgRole = (typeof ORG_ROLES)[number];
+declare const TIERS: readonly ["free", "single", "pro", "agency", "enterprise"];
+type Tier = (typeof TIERS)[number];
+declare const INTENT_STAGES: readonly ["awareness", "research", "comparison", "purchase", "branded"];
+type IntentStage = (typeof INTENT_STAGES)[number];
+declare const PROMPT_TYPES: readonly ["category", "competitor_comparison", "use_case", "persona_need", "branded"];
+type PromptType = (typeof PROMPT_TYPES)[number];
+declare const PROMPT_SOURCES: readonly ["generated", "template", "custom"];
+type PromptSource = (typeof PROMPT_SOURCES)[number];
+declare const SENTIMENTS: readonly ["positive", "neutral", "negative", "not_present"];
+type Sentiment = (typeof SENTIMENTS)[number];
+declare const SCAN_STATUSES: readonly ["queued", "running", "done", "failed"];
+type ScanStatus$1 = (typeof SCAN_STATUSES)[number];
+declare const SCAN_MODES: readonly ["grounded", "raw", "both"];
+type ScanMode = (typeof SCAN_MODES)[number];
+declare const CITATION_BUCKETS: readonly ["owned", "competitor", "third_party"];
+type CitationBucket = (typeof CITATION_BUCKETS)[number];
+declare const RECOMMENDATION_STATUSES: readonly ["open", "done", "dismissed"];
+type RecommendationStatus = (typeof RECOMMENDATION_STATUSES)[number];
+declare const RECOMMENDATION_TYPES: readonly ["losing_prompt", "power_source", "low_prominence", "reputation_risk", "citation_gap", "ai_readiness"];
+type RecommendationType = (typeof RECOMMENDATION_TYPES)[number];
+declare const REPORT_FORMATS: readonly ["pdf", "csv", "json"];
+type ReportFormat = (typeof REPORT_FORMATS)[number];
+/** API key scopes (08 section 2.5). A scope RESTRICTS the minting member, it never grants. */
+declare const API_SCOPES: readonly ["workspaces:read", "workspaces:write", "scans:read", "scans:write", "reports:read", "prompts:read", "prompts:write", "competitors:read", "competitors:write", "orgs:write"];
+type ApiScope = (typeof API_SCOPES)[number];
+/** The default set offered as "Read only" in the dashboard. */
+declare const READ_ONLY_SCOPES: readonly ["workspaces:read", "scans:read", "reports:read", "prompts:read", "competitors:read"];
+
+/**
+ * The canonical response schema of a visibility report (08 section 4.8). Served VERBATIM by
+ * GET /api/v1/scans/{scanId}/report?format=json, built by the app's `buildReportData`
+ * (src/reports/report-data.ts, which imports this type and so cannot drift from it), mirrored
+ * field for field by the `reportData` zod schema in contract.ts (a type-level assertion there
+ * fails typecheck on drift), and never re-shaped by the MCP server or the CLI.
+ *
+ * It lives in the package rather than the app because the package must build on its own in the
+ * public mirror (10-CLI section 10.2), where `src/` does not exist.
+ */
+interface ReportData {
+    /** The scan this report describes (08 section 4.8). buildReportData already receives it as arg 1. */
+    scanId: string;
+    brandName: string;
+    workspaceName: string;
+    scanDate: string;
+    score: number;
+    presenceRate: number;
+    presenceCiLow: number;
+    presenceCiHigh: number;
+    sov: number;
+    sentimentScore: number | null;
+    brandCitationShare: number;
+    perModel: Array<{
+        model: string;
+        score: number;
+    }>;
+    /** Top REPORT_COMPETITORS_MAX (20) by mentions; the cap is applied by the app. */
+    competitors: Array<{
+        name: string;
+        mentions: number;
+        sov: number;
+        isTarget: boolean;
+    }>;
+    /** Top REPORT_CITATIONS_MAX (25) by count. `bucket` is exactly CITATION_BUCKETS, never a wider string. */
+    citations: Array<{
+        domain: string;
+        count: number;
+        share: number;
+        bucket: CitationBucket;
+    }>;
+    /** Top REPORT_RECOMMENDATIONS_MAX (10) by priority. */
+    recommendations: Array<{
+        title: string;
+        body: string;
+        priority: number;
+    }>;
+    methodologyVersion: string;
+}
+
+/**
+ * The wire contract of the whereamimentioned public API (08-PUBLIC-API section 4) and of the
+ * no-account site tools (09-MCP-SERVER section 6.1, served at POST /api/site/*).
+ *
+ * Single source of truth, shared by the REST routes, the MCP tools and the CLI (10-CLI section 12).
+ * Rules:
+ *  - The const tuples live in ./enums.ts, and the app's src/types/enums.ts re-exports them from
+ *    there by identity. Never retype them, and never import them from the app: this package must
+ *    build alone in the public mirror (10-CLI section 10.2), which has no src/.
+ *  - `ReportData` is declared in ./report-data.ts and never redeclared: the app's buildReportData
+ *    imports it, and the `reportData` schema below is pinned to it by a type-level assertion, so
+ *    any drift between the two fails `pnpm typecheck` instead of a customer's CI.
+ *  - Every object schema that is a REQUEST body is `.strict()`, per 08 section 4.8.
+ */
+
+/** `api_keys.kind` (08 section 2.3). A server-side property of the row, never encoded in the token. */
+declare const API_KEY_KINDS: readonly ["org", "user"];
+type ApiKeyKind = (typeof API_KEY_KINDS)[number];
+/** The environment a key was minted against (08 section 2.1): `wam_live_` or `wam_test_`. */
+declare const API_KEY_ENVS: readonly ["live", "test"];
+type ApiKeyEnv = (typeof API_KEY_ENVS)[number];
+/** The API surface version carried in `X-Wam-Api-Version` (08 section 4.3). One integer, not semver. */
+declare const API_VERSION: 1;
+declare const API_VERSION_HEADER = "X-Wam-Api-Version";
+/**
+ * `true` on the 200 an idempotent replay returns (08 section 7.1 step 4, section 7.3 step 1). The
+ * replay body carries no flag of its own: the status and this header are the signal.
+ */
+declare const IDEMPOTENT_REPLAY_HEADER = "X-Idempotent-Replay";
+declare const API_ERROR_CODES: readonly ["bad_request", "unauthorized", "insufficient_role", "insufficient_scope", "feature_not_available", "not_found", "conflict", "scan_already_running", "validation_failed", "insufficient_credits", "rate_limited", "internal_error"];
+type ApiErrorCode = (typeof API_ERROR_CODES)[number];
+/** `req_` plus a 26-character Crockford base32 ULID (08 section 4.2). */
+declare const requestId: z.ZodString;
+declare const apiErrorBody: z.ZodObject<{
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            bad_request: "bad_request";
+            unauthorized: "unauthorized";
+            insufficient_role: "insufficient_role";
+            insufficient_scope: "insufficient_scope";
+            feature_not_available: "feature_not_available";
+            not_found: "not_found";
+            conflict: "conflict";
+            scan_already_running: "scan_already_running";
+            validation_failed: "validation_failed";
+            insufficient_credits: "insufficient_credits";
+            rate_limited: "rate_limited";
+            internal_error: "internal_error";
+        }>;
+        message: z.ZodString;
+        requestId: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type ApiErrorBody = z.infer<typeof apiErrorBody>;
+/** `details` of the 402 on scan creation (08 sections 4.8 and 6.4). */
+declare const insufficientCreditsDetails: z.ZodObject<{
+    required: z.ZodNumber;
+    available: z.ZodNumber;
+    billingUrl: z.ZodString;
+}, z.core.$strip>;
+type InsufficientCreditsDetails = z.infer<typeof insufficientCreditsDetails>;
+/** `details` of every 429 (08 section 5.4). */
+declare const rateLimitedDetails: z.ZodObject<{
+    retryAfterSeconds: z.ZodNumber;
+}, z.core.$strip>;
+type RateLimitedDetails = z.infer<typeof rateLimitedDetails>;
+/** `details` of the 409 `scan_already_running` (08 section 7.2). An adoption signal: poll `scanId`. */
+declare const scanAlreadyRunningDetails: z.ZodObject<{
+    scanId: z.ZodString;
+    pollUrl: z.ZodString;
+}, z.core.$strip>;
+type ScanAlreadyRunningDetails = z.infer<typeof scanAlreadyRunningDetails>;
+/**
+ * `details` of a 409 `conflict`, one arm per cause (08 sections 4.8, 6.5, 7.1 and 7.3):
+ *  - `originalScanId`: the same `Idempotency-Key` replayed with different scan terms;
+ *  - `originalOrgId`: the same `Idempotency-Key` replayed with a different org `name` or `type`.
+ *    10-CLI section 3.1 branches on its presence (exit 9) against the ceiling (exit 10);
+ *  - `limit`, `current`, `tier`, `billingUrl`: the plan's workspace cap;
+ *  - `fields`: the priced terms of a scan quote that moved since it was minted.
+ */
+declare const conflictDetails: z.ZodObject<{
+    originalScanId: z.ZodOptional<z.ZodString>;
+    originalOrgId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    current: z.ZodOptional<z.ZodNumber>;
+    tier: z.ZodOptional<z.ZodEnum<{
+        agency: "agency";
+        free: "free";
+        single: "single";
+        pro: "pro";
+        enterprise: "enterprise";
+    }>>;
+    billingUrl: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type ConflictDetails = z.infer<typeof conflictDetails>;
+/**
+ * `details` of a 403 `feature_not_available` (08 sections 4.8 and 6.2): `billingUrl` when a human
+ * with no paid org creates an organization, `limit` and `current` at the prompt cap,
+ * `allowedFormats` on a report format the tier does not export.
+ */
+declare const featureNotAvailableDetails: z.ZodObject<{
+    billingUrl: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    current: z.ZodOptional<z.ZodNumber>;
+    allowedFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        pdf: "pdf";
+        csv: "csv";
+        json: "json";
+    }>>>;
+}, z.core.$strip>;
+type FeatureNotAvailableDetails = z.infer<typeof featureNotAvailableDetails>;
+/**
+ * `details` of a 422 `validation_failed` (08 sections 3.4 rule 2 and 4.3): `hint` names
+ * `GET /api/v1/organizations` when a user key named no org; `issues` carries the Zod issues of a
+ * body, query or cursor that failed its schema.
+ */
+declare const validationFailedDetails: z.ZodObject<{
+    hint: z.ZodOptional<z.ZodString>;
+    issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type ValidationFailedDetails = z.infer<typeof validationFailedDetails>;
+/** `details` of the 404 on GET /api/v1/scans/{scanId}/report while the scan is not `done` (08 section 4.8). */
+declare const reportNotFoundDetails: z.ZodObject<{
+    status: z.ZodEnum<{
+        queued: "queued";
+        running: "running";
+        done: "done";
+        failed: "failed";
+    }>;
+}, z.core.$strip>;
+type ReportNotFoundDetails = z.infer<typeof reportNotFoundDetails>;
+/**
+ * The `details` schema per error code, for the codes 08 defines one for. `not_found` is deliberately
+ * absent: a plain 404 carries no details, and only the report route's (`reportNotFoundDetails`) does.
+ */
+declare const API_ERROR_DETAILS: {
+    readonly insufficient_credits: z.ZodObject<{
+        required: z.ZodNumber;
+        available: z.ZodNumber;
+        billingUrl: z.ZodString;
+    }, z.core.$strip>;
+    readonly rate_limited: z.ZodObject<{
+        retryAfterSeconds: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly scan_already_running: z.ZodObject<{
+        scanId: z.ZodString;
+        pollUrl: z.ZodString;
+    }, z.core.$strip>;
+    readonly conflict: z.ZodObject<{
+        originalScanId: z.ZodOptional<z.ZodString>;
+        originalOrgId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        current: z.ZodOptional<z.ZodNumber>;
+        tier: z.ZodOptional<z.ZodEnum<{
+            agency: "agency";
+            free: "free";
+            single: "single";
+            pro: "pro";
+            enterprise: "enterprise";
+        }>>;
+        billingUrl: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    readonly feature_not_available: z.ZodObject<{
+        billingUrl: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        current: z.ZodOptional<z.ZodNumber>;
+        allowedFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            pdf: "pdf";
+            csv: "csv";
+            json: "json";
+        }>>>;
+    }, z.core.$strip>;
+    readonly validation_failed: z.ZodObject<{
+        hint: z.ZodOptional<z.ZodString>;
+        issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            message: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+};
+/**
+ * Narrow an envelope's `details` by its `code`. Undefined when the payload does not match the shape
+ * 08 defines for that code: a client branches on what the API defines, never on a locally guessed
+ * shape (10-CLI section 12.2 rule 2).
+ */
+declare function parseErrorDetails<C extends keyof typeof API_ERROR_DETAILS>(code: C, details: unknown): z.infer<(typeof API_ERROR_DETAILS)[C]> | undefined;
+declare const pagination: z.ZodObject<{
+    nextCursor: z.ZodNullable<z.ZodString>;
+    hasMore: z.ZodBoolean;
+    limit: z.ZodNumber;
+}, z.core.$strip>;
+type Pagination = z.infer<typeof pagination>;
+/** The `{ data, pagination }` envelope every list endpoint returns. */
+declare function page<T extends z.ZodTypeAny>(item: T): z.ZodObject<{
+    data: z.ZodArray<T>;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        hasMore: z.ZodBoolean;
+        limit: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type Page<T> = {
+    data: T[];
+    pagination: Pagination;
+};
+/** Client-side query for a paginated list. The 1..100 bound is fixed on every endpoint. */
+declare const pageQuery: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+type PageQuery = z.infer<typeof pageQuery>;
+declare const scanListQuery: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        queued: "queued";
+        running: "running";
+        done: "done";
+        failed: "failed";
+    }>>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type ScanListQuery = z.infer<typeof scanListQuery>;
+declare const promptListQuery: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    source: z.ZodOptional<z.ZodEnum<{
+        generated: "generated";
+        template: "template";
+        custom: "custom";
+    }>>;
+    stage: z.ZodOptional<z.ZodEnum<{
+        awareness: "awareness";
+        research: "research";
+        comparison: "comparison";
+        purchase: "purchase";
+        branded: "branded";
+    }>>;
+}, z.core.$strict>;
+type PromptListQuery = z.infer<typeof promptListQuery>;
+/** The three filters of GET /api/v1/scans/{scanId}/answers, applied server side in SQL. */
+declare const answerListQuery: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    modelId: z.ZodOptional<z.ZodString>;
+    mentioned: z.ZodOptional<z.ZodBoolean>;
+    lowConfidence: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type AnswerListQuery = z.infer<typeof answerListQuery>;
+declare const recommendationListQuery: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    scanId: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        done: "done";
+        open: "open";
+        dismissed: "dismissed";
+    }>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        losing_prompt: "losing_prompt";
+        power_source: "power_source";
+        low_prominence: "low_prominence";
+        reputation_risk: "reputation_risk";
+        citation_gap: "citation_gap";
+        ai_readiness: "ai_readiness";
+    }>>;
+}, z.core.$strict>;
+type RecommendationListQuery = z.infer<typeof recommendationListQuery>;
+declare const citationListQuery: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    scanId: z.ZodOptional<z.ZodString>;
+    bucket: z.ZodOptional<z.ZodEnum<{
+        owned: "owned";
+        competitor: "competitor";
+        third_party: "third_party";
+    }>>;
+}, z.core.$strict>;
+type CitationListQuery = z.infer<typeof citationListQuery>;
+declare const meResponse: z.ZodObject<{
+    key: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        prefix: z.ZodString;
+        last4: z.ZodString;
+        kind: z.ZodEnum<{
+            org: "org";
+            user: "user";
+        }>;
+        env: z.ZodEnum<{
+            live: "live";
+            test: "test";
+        }>;
+        scopes: z.ZodArray<z.ZodEnum<{
+            "workspaces:read": "workspaces:read";
+            "workspaces:write": "workspaces:write";
+            "scans:read": "scans:read";
+            "scans:write": "scans:write";
+            "reports:read": "reports:read";
+            "prompts:read": "prompts:read";
+            "prompts:write": "prompts:write";
+            "competitors:read": "competitors:read";
+            "competitors:write": "competitors:write";
+            "orgs:write": "orgs:write";
+        }>>;
+        roleCeiling: z.ZodEnum<{
+            owner: "owner";
+            admin: "admin";
+            member: "member";
+            viewer: "viewer";
+        }>;
+        expiresAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    org: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            agency: "agency";
+            brand: "brand";
+        }>;
+    }, z.core.$strip>;
+    actor: z.ZodObject<{
+        userId: z.ZodString;
+        role: z.ZodEnum<{
+            owner: "owner";
+            admin: "admin";
+            member: "member";
+            viewer: "viewer";
+        }>;
+        effectiveRole: z.ZodEnum<{
+            owner: "owner";
+            admin: "admin";
+            member: "member";
+            viewer: "viewer";
+        }>;
+    }, z.core.$strip>;
+    plan: z.ZodObject<{
+        tier: z.ZodEnum<{
+            agency: "agency";
+            free: "free";
+            single: "single";
+            pro: "pro";
+            enterprise: "enterprise";
+        }>;
+        label: z.ZodString;
+        mcp: z.ZodBoolean;
+        exportFormats: z.ZodArray<z.ZodEnum<{
+            pdf: "pdf";
+            csv: "csv";
+            json: "json";
+        }>>;
+        promptsPerWorkspace: z.ZodNumber;
+        maxScanPrompts: z.ZodNumber;
+    }, z.core.$strip>;
+    credits: z.ZodObject<{
+        balance: z.ZodNumber;
+        unit: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type Me = z.infer<typeof meResponse>;
+declare const organizationSummary: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    tier: z.ZodEnum<{
+        agency: "agency";
+        free: "free";
+        single: "single";
+        pro: "pro";
+        enterprise: "enterprise";
+    }>;
+    effectiveRole: z.ZodEnum<{
+        owner: "owner";
+        admin: "admin";
+        member: "member";
+        viewer: "viewer";
+    }>;
+    workspaceCount: z.ZodNumber;
+}, z.core.$strip>;
+type OrganizationSummary = z.infer<typeof organizationSummary>;
+declare const createOrganizationBody: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        agency: "agency";
+        brand: "brand";
+    }>;
+}, z.core.$strict>;
+type CreateOrganizationBody = z.infer<typeof createOrganizationBody>;
+declare const createOrganizationResult: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        agency: "agency";
+        brand: "brand";
+    }>;
+    tier: z.ZodEnum<{
+        agency: "agency";
+        free: "free";
+        single: "single";
+        pro: "pro";
+        enterprise: "enterprise";
+    }>;
+    usable: z.ZodBoolean;
+    subscribeUrl: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type CreateOrganizationResult = z.infer<typeof createOrganizationResult>;
+declare const latestScanRef: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        running: "running";
+        done: "done";
+        failed: "failed";
+    }>;
+    finishedAt: z.ZodNullable<z.ZodString>;
+    score: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+type LatestScanRef = z.infer<typeof latestScanRef>;
+/** Exactly WORKSPACE_FIELDS (08 section 4.7), in that order. */
+declare const workspaceSummary: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    brandName: z.ZodNullable<z.ZodString>;
+    defaultRegion: z.ZodString;
+    defaultLanguage: z.ZodString;
+    usesOwnKey: z.ZodBoolean;
+    promptCount: z.ZodNumber;
+    enabledPromptCount: z.ZodNumber;
+    latestScan: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            queued: "queued";
+            running: "running";
+            done: "done";
+            failed: "failed";
+        }>;
+        finishedAt: z.ZodNullable<z.ZodString>;
+        score: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    activeScanId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+type WorkspaceSummary = z.infer<typeof workspaceSummary>;
+/** Exactly WORKSPACE_DETAIL_FIELDS: the list entry plus `competitorCount`. */
+declare const workspaceDetail: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    brandName: z.ZodNullable<z.ZodString>;
+    defaultRegion: z.ZodString;
+    defaultLanguage: z.ZodString;
+    usesOwnKey: z.ZodBoolean;
+    promptCount: z.ZodNumber;
+    enabledPromptCount: z.ZodNumber;
+    latestScan: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            queued: "queued";
+            running: "running";
+            done: "done";
+            failed: "failed";
+        }>;
+        finishedAt: z.ZodNullable<z.ZodString>;
+        score: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    activeScanId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    competitorCount: z.ZodNumber;
+}, z.core.$strip>;
+type WorkspaceDetail = z.infer<typeof workspaceDetail>;
+/**
+ * Only `name`. The org is never read from the body (08 section 3.5(a)): it travels as
+ * `X-Wam-Org`, and `.strict()` makes an `orgSlug` field a 422.
+ */
+declare const createWorkspaceBody: z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$strict>;
+type CreateWorkspaceBody = z.infer<typeof createWorkspaceBody>;
+declare const competitor: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    domain: z.ZodNullable<z.ZodString>;
+    aliases: z.ZodArray<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type Competitor = z.infer<typeof competitor>;
+declare const createCompetitorBody: z.ZodObject<{
+    name: z.ZodString;
+    domain: z.ZodOptional<z.ZodString>;
+    aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+type CreateCompetitorBody = z.input<typeof createCompetitorBody>;
+declare const prompt: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+    intentStage: z.ZodEnum<{
+        awareness: "awareness";
+        research: "research";
+        comparison: "comparison";
+        purchase: "purchase";
+        branded: "branded";
+    }>;
+    persona: z.ZodString;
+    type: z.ZodEnum<{
+        branded: "branded";
+        category: "category";
+        competitor_comparison: "competitor_comparison";
+        use_case: "use_case";
+        persona_need: "persona_need";
+    }>;
+    topic: z.ZodNullable<z.ZodString>;
+    isBranded: z.ZodBoolean;
+    tags: z.ZodArray<z.ZodString>;
+    source: z.ZodEnum<{
+        generated: "generated";
+        template: "template";
+        custom: "custom";
+    }>;
+    enabled: z.ZodBoolean;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type Prompt = z.infer<typeof prompt>;
+/** The only list envelope with extra keys: the cap is meaningless without the list beside it. */
+declare const promptListResponse: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        intentStage: z.ZodEnum<{
+            awareness: "awareness";
+            research: "research";
+            comparison: "comparison";
+            purchase: "purchase";
+            branded: "branded";
+        }>;
+        persona: z.ZodString;
+        type: z.ZodEnum<{
+            branded: "branded";
+            category: "category";
+            competitor_comparison: "competitor_comparison";
+            use_case: "use_case";
+            persona_need: "persona_need";
+        }>;
+        topic: z.ZodNullable<z.ZodString>;
+        isBranded: z.ZodBoolean;
+        tags: z.ZodArray<z.ZodString>;
+        source: z.ZodEnum<{
+            generated: "generated";
+            template: "template";
+            custom: "custom";
+        }>;
+        enabled: z.ZodBoolean;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        hasMore: z.ZodBoolean;
+        limit: z.ZodNumber;
+    }, z.core.$strip>;
+    promptsPerWorkspace: z.ZodNumber;
+    maxScanPrompts: z.ZodNumber;
+}, z.core.$strip>;
+type PromptListResponse = z.infer<typeof promptListResponse>;
+declare const createPromptBody: z.ZodObject<{
+    text: z.ZodString;
+    intentStage: z.ZodDefault<z.ZodEnum<{
+        awareness: "awareness";
+        research: "research";
+        comparison: "comparison";
+        purchase: "purchase";
+        branded: "branded";
+    }>>;
+    persona: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type CreatePromptBody = z.input<typeof createPromptBody>;
+declare const patchPromptBody: z.ZodObject<{
+    enabled: z.ZodBoolean;
+}, z.core.$strict>;
+type PatchPromptBody = z.infer<typeof patchPromptBody>;
+declare const deletePromptResult: z.ZodObject<{
+    deleted: z.ZodLiteral<true>;
+    id: z.ZodString;
+}, z.core.$strip>;
+type DeletePromptResult = z.infer<typeof deletePromptResult>;
+declare const scanSummary: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        running: "running";
+        done: "done";
+        failed: "failed";
+    }>;
+    mode: z.ZodEnum<{
+        grounded: "grounded";
+        raw: "raw";
+        both: "both";
+    }>;
+    repetitions: z.ZodNumber;
+    modelCount: z.ZodNumber;
+    promptCount: z.ZodNumber;
+    creditsSpent: z.ZodNullable<z.ZodNumber>;
+    score: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodString;
+    startedAt: z.ZodNullable<z.ZodString>;
+    finishedAt: z.ZodNullable<z.ZodString>;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type ScanSummary = z.infer<typeof scanSummary>;
+declare const scanProgress: z.ZodObject<{
+    done: z.ZodNumber;
+    total: z.ZodNumber;
+    totalIsFinal: z.ZodBoolean;
+}, z.core.$strip>;
+type ScanProgress = z.infer<typeof scanProgress>;
+declare const scanStatus: z.ZodObject<{
+    id: z.ZodString;
+    workspaceSlug: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        running: "running";
+        done: "done";
+        failed: "failed";
+    }>;
+    mode: z.ZodEnum<{
+        grounded: "grounded";
+        raw: "raw";
+        both: "both";
+    }>;
+    repetitions: z.ZodNumber;
+    progress: z.ZodObject<{
+        done: z.ZodNumber;
+        total: z.ZodNumber;
+        totalIsFinal: z.ZodBoolean;
+    }, z.core.$strip>;
+    creditsReserved: z.ZodNumber;
+    creditsSpent: z.ZodNullable<z.ZodNumber>;
+    score: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodString;
+    startedAt: z.ZodNullable<z.ZodString>;
+    finishedAt: z.ZodNullable<z.ZodString>;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type ScanStatus = z.infer<typeof scanStatus>;
+declare const scanModelRef: z.ZodObject<{
+    id: z.ZodString;
+    displayName: z.ZodString;
+}, z.core.$strip>;
+type ScanModelRef = z.infer<typeof scanModelRef>;
+/** POST /api/v1/workspaces/{ws}/scans/estimate: free, charges nothing, touches no ledger. */
+declare const scanEstimate: z.ZodObject<{
+    credits: z.ZodNumber;
+    prompts: z.ZodNumber;
+    models: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+    }, z.core.$strip>>;
+    repetitions: z.ZodNumber;
+    mode: z.ZodEnum<{
+        grounded: "grounded";
+        raw: "raw";
+        both: "both";
+    }>;
+    balance: z.ZodNumber;
+    sufficient: z.ZodBoolean;
+    usesOwnKey: z.ZodBoolean;
+    quote: z.ZodObject<{
+        token: z.ZodString;
+        expiresAt: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type ScanEstimate = z.infer<typeof scanEstimate>;
+/** Body of the estimate call: reserved for future options. */
+declare const estimateScanBody: z.ZodObject<{}, z.core.$strict>;
+type EstimateScanBody = z.infer<typeof estimateScanBody>;
+/** `mode` and `repetitions` are deliberately NOT accepted (08 section 6.3): `.strict()` 422s them. */
+declare const createScanBody: z.ZodObject<{
+    quote: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type CreateScanBody = z.infer<typeof createScanBody>;
+declare const createScanResult: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        running: "running";
+        done: "done";
+        failed: "failed";
+    }>;
+    credits: z.ZodNumber;
+    prompts: z.ZodNumber;
+    models: z.ZodNumber;
+    balanceAfter: z.ZodNumber;
+    pollUrl: z.ZodString;
+}, z.core.$strip>;
+type CreateScanResult = z.infer<typeof createScanResult>;
+/** `Idempotency-Key` header value: 1..128 chars of [A-Za-z0-9_.:-] (08 section 7.1). */
+declare const idempotencyKey: z.ZodString;
+/** 1200 characters and 25 citations are the numbers everywhere. They are not tuning knobs. */
+declare const ANSWER_TEXT_MAX_CHARS = 1200;
+declare const ANSWER_CITATIONS_MAX = 25;
+declare const answerCitation: z.ZodObject<{
+    url: z.ZodString;
+    domain: z.ZodString;
+}, z.core.$strip>;
+type AnswerCitation = z.infer<typeof answerCitation>;
+declare const brandPresent: z.ZodObject<{
+    name: z.ZodString;
+    is_target: z.ZodBoolean;
+    rank: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+type BrandPresent = z.infer<typeof brandPresent>;
+declare const scanAnswer: z.ZodObject<{
+    answerId: z.ZodString;
+    promptId: z.ZodString;
+    promptText: z.ZodString;
+    intentStage: z.ZodEnum<{
+        awareness: "awareness";
+        research: "research";
+        comparison: "comparison";
+        purchase: "purchase";
+        branded: "branded";
+    }>;
+    modelId: z.ZodString;
+    modelName: z.ZodString;
+    grounded: z.ZodBoolean;
+    brandMentioned: z.ZodBoolean;
+    brandPosition: z.ZodNullable<z.ZodNumber>;
+    sentiment: z.ZodEnum<{
+        positive: "positive";
+        neutral: "neutral";
+        negative: "negative";
+        not_present: "not_present";
+    }>;
+    brandsPresent: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        is_target: z.ZodBoolean;
+        rank: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    citations: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        domain: z.ZodString;
+    }, z.core.$strip>>;
+    confidence: z.ZodNumber;
+    lowConfidence: z.ZodBoolean;
+    answerText: z.ZodString;
+    answerTextTruncated: z.ZodBoolean;
+}, z.core.$strip>;
+type ScanAnswer = z.infer<typeof scanAnswer>;
+declare const recommendation: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        losing_prompt: "losing_prompt";
+        power_source: "power_source";
+        low_prominence: "low_prominence";
+        reputation_risk: "reputation_risk";
+        citation_gap: "citation_gap";
+        ai_readiness: "ai_readiness";
+    }>;
+    title: z.ZodString;
+    body: z.ZodString;
+    impact: z.ZodNumber;
+    effort: z.ZodNumber;
+    priority: z.ZodNumber;
+    status: z.ZodEnum<{
+        done: "done";
+        open: "open";
+        dismissed: "dismissed";
+    }>;
+    scanId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type Recommendation = z.infer<typeof recommendation>;
+declare const citation: z.ZodObject<{
+    domain: z.ZodString;
+    count: z.ZodNumber;
+    share: z.ZodNumber;
+    bucket: z.ZodEnum<{
+        owned: "owned";
+        competitor: "competitor";
+        third_party: "third_party";
+    }>;
+}, z.core.$strip>;
+type Citation = z.infer<typeof citation>;
+declare const credits: z.ZodObject<{
+    balance: z.ZodNumber;
+    tier: z.ZodEnum<{
+        agency: "agency";
+        free: "free";
+        single: "single";
+        pro: "pro";
+        enterprise: "enterprise";
+    }>;
+    monthlyCredits: z.ZodNumber;
+    unit: z.ZodString;
+    estimatedScansRemaining: z.ZodNumber;
+}, z.core.$strip>;
+type Credits = z.infer<typeof credits>;
+/** `all` is the literal string "cli" or nothing. The server 422s on any other value. */
+declare const revokeSelfQuery: z.ZodObject<{
+    all: z.ZodOptional<z.ZodLiteral<"cli">>;
+}, z.core.$strict>;
+declare const revokeSelfResult: z.ZodObject<{
+    revoked: z.ZodNumber;
+    self: z.ZodLiteral<true>;
+    scope: z.ZodOptional<z.ZodLiteral<"cli">>;
+}, z.core.$strip>;
+type RevokeSelfResult = z.infer<typeof revokeSelfResult>;
+/**
+ * The signed payload behind `scanEstimate.quote.token`: base64url(payload) + "." + base64url(mac),
+ * HMAC-SHA256 over the canonical JSON, 5 minute TTL, `modelIds` sorted lexically before signing.
+ * Minting and verification live in src/api/quote.ts; this is the shape only.
+ */
+declare const quotePayload: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    orgId: z.ZodString;
+    workspaceId: z.ZodString;
+    keyId: z.ZodString;
+    promptCount: z.ZodNumber;
+    modelIds: z.ZodArray<z.ZodString>;
+    repetitions: z.ZodNumber;
+    mode: z.ZodEnum<{
+        grounded: "grounded";
+        raw: "raw";
+        both: "both";
+    }>;
+    creditCost: z.ZodNumber;
+    byok: z.ZodBoolean;
+    iat: z.ZodNumber;
+    exp: z.ZodNumber;
+}, z.core.$strip>;
+type QuotePayload = z.infer<typeof quotePayload>;
+declare const QUOTE_TTL_SECONDS = 300;
+/**
+ * Mirrors `ReportData` from ./report-data.ts field for field. That interface is the canonical
+ * response schema and is served verbatim; this zod schema exists so the wire can be validated in
+ * tests. The assertion below makes the two inseparable: change one and the other fails to
+ * typecheck.
+ */
+declare const reportData: z.ZodObject<{
+    scanId: z.ZodString;
+    brandName: z.ZodString;
+    workspaceName: z.ZodString;
+    scanDate: z.ZodString;
+    score: z.ZodNumber;
+    presenceRate: z.ZodNumber;
+    presenceCiLow: z.ZodNumber;
+    presenceCiHigh: z.ZodNumber;
+    sov: z.ZodNumber;
+    sentimentScore: z.ZodNullable<z.ZodNumber>;
+    brandCitationShare: z.ZodNumber;
+    perModel: z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        score: z.ZodNumber;
+    }, z.core.$strip>>;
+    competitors: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        mentions: z.ZodNumber;
+        sov: z.ZodNumber;
+        isTarget: z.ZodBoolean;
+    }, z.core.$strip>>;
+    citations: z.ZodArray<z.ZodObject<{
+        domain: z.ZodString;
+        count: z.ZodNumber;
+        share: z.ZodNumber;
+        bucket: z.ZodEnum<{
+            owned: "owned";
+            competitor: "competitor";
+            third_party: "third_party";
+        }>;
+    }, z.core.$strip>>;
+    recommendations: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        body: z.ZodString;
+        priority: z.ZodNumber;
+    }, z.core.$strip>>;
+    methodologyVersion: z.ZodString;
+}, z.core.$strip>;
+declare const siteUrlInput: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strict>;
+/** T1 check_ai_crawler_access / POST /api/site/check-crawlers */
+declare const crawlerAccessResult: z.ZodObject<{
+    origin: z.ZodString;
+    robotsStatus: z.ZodNumber;
+    robotsMissing: z.ZodBoolean;
+    robotsServerError: z.ZodBoolean;
+    truncated: z.ZodBoolean;
+    sitemaps: z.ZodArray<z.ZodString>;
+    bots: z.ZodArray<z.ZodObject<{
+        token: z.ZodString;
+        operator: z.ZodString;
+        category: z.ZodString;
+        respectsRobots: z.ZodEnum<{
+            yes: "yes";
+            no: "no";
+            unverified: "unverified";
+        }>;
+        allowed: z.ZodBoolean;
+        via: z.ZodEnum<{
+            named: "named";
+            wildcard: "wildcard";
+            none: "none";
+        }>;
+        matchedLine: z.ZodNullable<z.ZodNumber>;
+        note: z.ZodNullable<z.ZodString>;
+        untrusted: z.ZodObject<{
+            matchedRule: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        allowed: z.ZodNumber;
+        blocked: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type CrawlerAccessResult = z.infer<typeof crawlerAccessResult>;
+/** T2 validate_llms_txt / POST /api/site/validate-llms-txt */
+declare const llmsTxtValidation: z.ZodObject<{
+    origin: z.ZodString;
+    status: z.ZodNumber;
+    missing: z.ZodBoolean;
+    score: z.ZodNullable<z.ZodNumber>;
+    findings: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            info: "info";
+        }>;
+        message: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    stats: z.ZodNullable<z.ZodObject<{
+        lines: z.ZodNumber;
+        bytes: z.ZodNumber;
+        sections: z.ZodNumber;
+        entries: z.ZodNumber;
+        entriesWithDescription: z.ZodNumber;
+    }, z.core.$strip>>;
+    linksChecked: z.ZodNumber;
+    brokenLinks: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        status: z.ZodNumber;
+    }, z.core.$strip>>;
+    hasLlmsFullTxt: z.ZodBoolean;
+}, z.core.$strip>;
+type LlmsTxtValidation = z.infer<typeof llmsTxtValidation>;
+declare const LLMS_TXT_DEPTHS: readonly ["index", "full"];
+type LlmsTxtDepth = (typeof LLMS_TXT_DEPTHS)[number];
+declare const generateLlmsTxtInput: z.ZodObject<{
+    url: z.ZodString;
+    depth: z.ZodDefault<z.ZodEnum<{
+        index: "index";
+        full: "full";
+    }>>;
+    siteName: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type GenerateLlmsTxtInput = z.input<typeof generateLlmsTxtInput>;
+/** T3 generate_llms_txt / POST /api/site/generate-llms-txt */
+declare const llmsTxtGeneration: z.ZodObject<{
+    untrusted: z.ZodObject<{
+        content: z.ZodString;
+    }, z.core.$strip>;
+    depth: z.ZodEnum<{
+        index: "index";
+        full: "full";
+    }>;
+    pageCount: z.ZodNumber;
+    skippedCount: z.ZodNumber;
+    discoveredVia: z.ZodEnum<{
+        sitemap: "sitemap";
+        links: "links";
+        "sitemap+links": "sitemap+links";
+    }>;
+    timedOut: z.ZodBoolean;
+    notices: z.ZodArray<z.ZodString>;
+    totalWords: z.ZodOptional<z.ZodNumber>;
+    estTokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type LlmsTxtGeneration = z.infer<typeof llmsTxtGeneration>;
+/** T4 generate_sitemap / POST /api/site/generate-sitemap */
+declare const sitemapGeneration: z.ZodObject<{
+    untrusted: z.ZodObject<{
+        xml: z.ZodString;
+    }, z.core.$strip>;
+    urlCount: z.ZodNumber;
+    skipped: z.ZodNumber;
+    discoveredVia: z.ZodEnum<{
+        sitemap: "sitemap";
+        links: "links";
+        "sitemap+links": "sitemap+links";
+    }>;
+    timedOut: z.ZodBoolean;
+}, z.core.$strip>;
+type SitemapGeneration = z.infer<typeof sitemapGeneration>;
+/** T5 analyze_content_chunking / POST /api/site/analyze-chunks. Never carries `html`. */
+declare const chunkAnalysisResult: z.ZodObject<{
+    url: z.ZodString;
+    mode: z.ZodEnum<{
+        text: "text";
+        html: "html";
+    }>;
+    score: z.ZodNumber;
+    errors: z.ZodNumber;
+    warnings: z.ZodNumber;
+    strengthCount: z.ZodNumber;
+    totalWords: z.ZodNumber;
+    totalTokens: z.ZodNumber;
+    topFixes: z.ZodArray<z.ZodString>;
+    docFindings: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    chunks: z.ZodArray<z.ZodObject<{
+        level: z.ZodNumber;
+        untrusted: z.ZodObject<{
+            heading: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        words: z.ZodNumber;
+        tokens: z.ZodNumber;
+        paragraphs: z.ZodNumber;
+        longestParagraphWords: z.ZodNumber;
+        findings: z.ZodArray<z.ZodObject<{
+            severity: z.ZodEnum<{
+                error: "error";
+                warning: "warning";
+            }>;
+            message: z.ZodString;
+        }, z.core.$strip>>;
+        strengths: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type ChunkAnalysisResult = z.infer<typeof chunkAnalysisResult>;
+/** T6 validate_structured_data / POST /api/site/validate-structured-data. Never raw JSON-LD. */
+declare const structuredDataValidation: z.ZodObject<{
+    url: z.ZodString;
+    score: z.ZodNumber;
+    entityCount: z.ZodNumber;
+    errors: z.ZodNumber;
+    warnings: z.ZodNumber;
+    passes: z.ZodNumber;
+    microdataCount: z.ZodNumber;
+    rdfaCount: z.ZodNumber;
+    blocks: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        syntaxError: z.ZodOptional<z.ZodString>;
+        entities: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            untrusted: z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            aiNote: z.ZodOptional<z.ZodString>;
+            findings: z.ZodArray<z.ZodObject<{
+                severity: z.ZodEnum<{
+                    error: "error";
+                    warning: "warning";
+                    info: "info";
+                    pass: "pass";
+                }>;
+                message: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type StructuredDataValidation = z.infer<typeof structuredDataValidation>;
+declare const checkMetaInput: z.ZodObject<{
+    url: z.ZodString;
+    keyword: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type CheckMetaInput = z.infer<typeof checkMetaInput>;
+/** T7 check_meta_description / POST /api/site/check-meta */
+declare const metaAnalysisResult: z.ZodObject<{
+    url: z.ZodString;
+    untrusted: z.ZodObject<{
+        title: z.ZodNullable<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        ogDescription: z.ZodNullable<z.ZodString>;
+        firstParagraph: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    score: z.ZodNumber;
+    chars: z.ZodNumber;
+    pixels: z.ZodNumber;
+    desktopCutoff: z.ZodNullable<z.ZodNumber>;
+    mobileCutoff: z.ZodNullable<z.ZodNumber>;
+    checks: z.ZodArray<z.ZodObject<{
+        level: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            pass: "pass";
+            suggestion: "suggestion";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    openingParagraphChecks: z.ZodArray<z.ZodObject<{
+        level: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            pass: "pass";
+            suggestion: "suggestion";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type MetaAnalysisResult = z.infer<typeof metaAnalysisResult>;
+/**
+ * The seven no-account routes, by client method name. One table so a rename happens in one place.
+ * They live at /api/site/*, deliberately outside /api/v1 (08 section 1.2, 10 section 3.9).
+ */
+declare const SITE_ROUTES: {
+    readonly checkCrawlers: "check-crawlers";
+    readonly validateLlmsTxt: "validate-llms-txt";
+    readonly generateLlmsTxt: "generate-llms-txt";
+    readonly generateSitemap: "generate-sitemap";
+    readonly validateStructuredData: "validate-structured-data";
+    readonly checkMeta: "check-meta";
+    readonly analyzeChunks: "analyze-chunks";
+};
+type SiteRoute = (typeof SITE_ROUTES)[keyof typeof SITE_ROUTES];
+
+/**
+ * The typed fetch wrapper every machine client of whereamimentioned goes through (10-CLI section
+ * 12.1). Neither the CLI nor the MCP server calls `fetch` against /api/v1 directly.
+ *
+ * What it does, and nothing more:
+ *  - attaches `Authorization: Bearer` and `X-Wam-Api-Version` on every /api/v1 call;
+ *  - sends `X-Wam-Org` on org-scoped calls and SUPPRESSES it on the three routes that resolve no
+ *    organization (`organizations.list`, `organizations.create`, `keys.revokeSelf`);
+ *  - sends `Idempotency-Key` on the two routes that require it (`scans.create`,
+ *    `organizations.create`) and on no other;
+ *  - maps the 08 section 4.2 error envelope to a typed `ApiError`, reading `X-Request-Id` and
+ *    `Retry-After`; a 2xx whose body is not JSON becomes the same `ApiError` (code `unknown`);
+ *  - exposes the last response's status and headers as `lastResponse`, including whether it was an
+ *    idempotent replay (`X-Idempotent-Replay`), because the 08 bodies deliberately carry no replay
+ *    flag and the status plus that header are the only signal (08 sections 7.1 and 7.3);
+ *  - retries idempotent GETs only, at most twice, with exponential backoff, on 502/503/504 and on
+ *    network-level failures. A POST is never retried. A 429 is never retried: the server has
+ *    already said stop, and `retryAfterSeconds` on the error tells the caller when.
+ *  - aborts any request after `timeoutMs` (default 30 s).
+ *
+ * It does not validate response bodies against the contract at runtime: the routes are asserted
+ * against the contract schemas in the server's own tests, and a client that re-serialised a parsed
+ * copy could never promise "byte-identical to the API body" to `--json` consumers.
+ */
+
+declare const DEFAULT_BASE_URL = "https://whereamimentioned.com";
+declare const DEFAULT_TIMEOUT_MS = 30000;
+/** The /api/v1 surface version this client was built against (08 section 4.3, 10 section 9.1). */
+declare const SUPPORTED_API_VERSION: number;
+/** Idempotent GETs only: at most this many retries, so three attempts in total. */
+declare const MAX_GET_RETRIES = 2;
+interface WamClientOptions {
+    baseUrl: string;
+    token?: string;
+    org?: string;
+    fetch?: typeof globalThis.fetch;
+    userAgent: string;
+    timeoutMs?: number;
+}
+declare class ApiError extends Error {
+    readonly status: number;
+    readonly code: ApiErrorCode | string;
+    readonly requestId: string | null;
+    readonly details: Record<string, unknown> | undefined;
+    readonly retryAfterSeconds: number | null;
+    constructor(init: {
+        status: number;
+        code: ApiErrorCode | string;
+        message: string;
+        requestId: string | null;
+        details?: Record<string, unknown>;
+        retryAfterSeconds: number | null;
+    });
+}
+/** The request exceeded `timeoutMs`. Not retried: the caller set that budget deliberately. */
+declare class ApiTimeoutError extends Error {
+    readonly timeoutMs: number;
+    readonly method: string;
+    readonly path: string;
+    constructor(method: string, path: string, timeoutMs: number);
+}
+/**
+ * What the last completed request answered with, beyond its body. The 08 bodies deliberately carry
+ * no replay flag (the signal is the status and `X-Idempotent-Replay`), so this is where a caller
+ * reads it: `scans.create` or `organizations.create` resolves with the body, and `lastResponse.replayed`
+ * then says whether it was the original 201 or the 200 of 08 sections 7.1 and 7.3. It is per client
+ * instance and describes the most recent completed request (null before the first, and null again
+ * while a request is in flight or after one failed at the network level), so a caller running
+ * concurrent requests on one instance must read it before issuing the next call. The CLI is
+ * sequential (estimate, confirm, create); the MCP server reads `replayed` in-process instead.
+ */
+interface WamResponseMeta {
+    status: number;
+    headers: Headers;
+    /** `X-Idempotent-Replay: true` was present. Always false on a 201. */
+    replayed: boolean;
+}
+interface WamClient {
+    /** The integer from the last `X-Wam-Api-Version` response header seen, success or failure. */
+    readonly lastApiVersion: number | null;
+    /** The last `X-Request-Id` seen. For `--debug` output and support tickets. */
+    readonly lastRequestId: string | null;
+    /** Status, headers and the replay flag of the last completed request, success or failure. */
+    readonly lastResponse: WamResponseMeta | null;
+    me(): Promise<Me>;
+    credits(): Promise<Credits>;
+    organizations: {
+        list(q?: PageQuery): Promise<Page<OrganizationSummary>>;
+        create(body: CreateOrganizationBody, idempotencyKey: string): Promise<CreateOrganizationResult>;
+    };
+    workspaces: {
+        list(q?: PageQuery): Promise<Page<WorkspaceSummary>>;
+        get(slug: string): Promise<WorkspaceDetail>;
+        create(orgSlug: string, body: CreateWorkspaceBody): Promise<WorkspaceDetail>;
+    };
+    scans: {
+        list(ws: string, q?: ScanListQuery): Promise<Page<ScanSummary>>;
+        estimate(ws: string): Promise<ScanEstimate>;
+        create(ws: string, body: CreateScanBody, idempotencyKey: string): Promise<CreateScanResult>;
+        get(scanId: string): Promise<ScanStatus>;
+        answers(scanId: string, q?: AnswerListQuery): Promise<Page<ScanAnswer>>;
+        report(scanId: string, format: ReportFormat): Promise<ReportData | Uint8Array>;
+    };
+    prompts: {
+        list(ws: string, q?: PromptListQuery): Promise<PromptListResponse>;
+        create(ws: string, body: CreatePromptBody): Promise<Prompt>;
+        patch(ws: string, promptId: string, body: PatchPromptBody): Promise<Prompt>;
+        /** A 404 here is success: the prompt is already gone (08 section 4.8). */
+        remove(ws: string, promptId: string): Promise<void>;
+    };
+    competitors: {
+        list(ws: string, q?: PageQuery): Promise<Page<Competitor>>;
+        create(ws: string, body: CreateCompetitorBody): Promise<Competitor>;
+    };
+    recommendations: {
+        list(ws: string, q?: RecommendationListQuery): Promise<Page<Recommendation>>;
+    };
+    citations: {
+        list(ws: string, q?: CitationListQuery): Promise<Page<Citation>>;
+    };
+    site: {
+        checkCrawlers(url: string): Promise<CrawlerAccessResult>;
+        validateLlmsTxt(url: string): Promise<LlmsTxtValidation>;
+        generateLlmsTxt(url: string, opts?: {
+            full?: boolean;
+        }): Promise<LlmsTxtGeneration>;
+        generateSitemap(url: string): Promise<SitemapGeneration>;
+        validateStructuredData(url: string): Promise<StructuredDataValidation>;
+        checkMeta(url: string, keyword?: string): Promise<MetaAnalysisResult>;
+        analyzeChunks(url: string): Promise<ChunkAnalysisResult>;
+    };
+    keys: {
+        revokeSelf(all?: "cli"): Promise<RevokeSelfResult>;
+    };
+}
+declare function createWamClient(opts: WamClientOptions): WamClient;
+
+export { ANSWER_CITATIONS_MAX, ANSWER_TEXT_MAX_CHARS, API_ERROR_CODES, API_ERROR_DETAILS, API_KEY_ENVS, API_KEY_KINDS, API_SCOPES, API_VERSION, API_VERSION_HEADER, type AnswerCitation, type AnswerListQuery, ApiError, type ApiErrorBody, type ApiErrorCode, type ApiKeyEnv, type ApiKeyKind, type ApiScope, ApiTimeoutError, type BrandPresent, CITATION_BUCKETS, type CheckMetaInput, type ChunkAnalysisResult, type Citation, type CitationBucket, type CitationListQuery, type Competitor, type ConflictDetails, type CrawlerAccessResult, type CreateCompetitorBody, type CreateOrganizationBody, type CreateOrganizationResult, type CreatePromptBody, type CreateScanBody, type CreateScanResult, type CreateWorkspaceBody, type Credits, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type DeletePromptResult, type EstimateScanBody, type FeatureNotAvailableDetails, type GenerateLlmsTxtInput, IDEMPOTENT_REPLAY_HEADER, INTENT_STAGES, type InsufficientCreditsDetails, type IntentStage, LLMS_TXT_DEPTHS, type LatestScanRef, type LlmsTxtDepth, type LlmsTxtGeneration, type LlmsTxtValidation, MAX_GET_RETRIES, type Me, type MetaAnalysisResult, ORG_ROLES, ORG_TYPES, type OrgRole, type OrgType, type OrganizationSummary, PROMPT_SOURCES, PROMPT_TYPES, type Page, type PageQuery, type Pagination, type PatchPromptBody, type Prompt, type PromptListQuery, type PromptListResponse, type PromptSource, type PromptType, QUOTE_TTL_SECONDS, type QuotePayload, READ_ONLY_SCOPES, RECOMMENDATION_STATUSES, RECOMMENDATION_TYPES, REPORT_FORMATS, type RateLimitedDetails, type Recommendation, type RecommendationListQuery, type RecommendationStatus, type RecommendationType, type ReportData, type ReportFormat, type ReportNotFoundDetails, type RevokeSelfResult, SCAN_MODES, SCAN_STATUSES, SENTIMENTS, SITE_ROUTES, SUPPORTED_API_VERSION, type ScanAlreadyRunningDetails, type ScanAnswer, type ScanEstimate, type ScanListQuery, type ScanMode, type ScanModelRef, type ScanProgress, type ScanStatus, type ScanStatus$1 as ScanStatusValue, type ScanSummary, type Sentiment, type SiteRoute, type SitemapGeneration, type StructuredDataValidation, TIERS, type Tier, type ValidationFailedDetails, type WamClient, type WamClientOptions, type WamResponseMeta, type WorkspaceDetail, type WorkspaceSummary, answerCitation, answerListQuery, apiErrorBody, brandPresent, checkMetaInput, chunkAnalysisResult, citation, citationListQuery, competitor, conflictDetails, crawlerAccessResult, createCompetitorBody, createOrganizationBody, createOrganizationResult, createPromptBody, createScanBody, createScanResult, createWamClient, createWorkspaceBody, credits, deletePromptResult, estimateScanBody, featureNotAvailableDetails, generateLlmsTxtInput, idempotencyKey, insufficientCreditsDetails, latestScanRef, llmsTxtGeneration, llmsTxtValidation, meResponse, metaAnalysisResult, organizationSummary, page, pageQuery, pagination, parseErrorDetails, patchPromptBody, prompt, promptListQuery, promptListResponse, quotePayload, rateLimitedDetails, recommendation, recommendationListQuery, reportData, reportNotFoundDetails, requestId, revokeSelfQuery, revokeSelfResult, scanAlreadyRunningDetails, scanAnswer, scanEstimate, scanListQuery, scanModelRef, scanProgress, scanStatus, scanSummary, siteUrlInput, sitemapGeneration, structuredDataValidation, validationFailedDetails, workspaceDetail, workspaceSummary };