affiliate-networks-mcp 0.1.0

package/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robert Berrisford
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+# affiliate-mcp
+
+> An MCP server for affiliate networks. Bring your own keys.
+
+**Status:** pre-launch. The five bundled adapters ship as `claim_status: partial` (or `experimental`, for the most recent addition) until they have been exercised against real publisher accounts.
+
+## What this is
+
+`affiliate-mcp` is a Model Context Protocol server that exposes affiliate
+network APIs as MCP tools. It bundles five networks — Awin, CJ Affiliate,
+eBay Partner Network, Impact, and Rakuten Advertising — so a publisher can ask
+an MCP client (Claude Desktop, Claude Code, others) questions like "which
+programmes are still pending after 90 days?" across all of them without
+opening five dashboards.
+
+The server runs locally. There is no hosted service, no account, and no
+telemetry. Credentials live in `~/.affiliate-mcp/.env` at file mode `0600`
+and never leave your host. You bring your own publisher keys for each
+network you want wired in.
+
+For per-network capability, known limitations, and the editorial baseline,
+see [`REPORT.md`](./REPORT.md). It is regenerated from each adapter's
+`network.json` and findings docs, so it stays in step with the code.
+
+## Quick-start
+
+Requires Node.js 20 or newer.
+
+Run the interactive setup wizard:
+
+```
+npx affiliate-networks-mcp setup
+```
+
+The wizard walks one network at a time, validates each credential against the
+live API as you enter it, and writes the configuration to
+`~/.affiliate-mcp/.env` at file mode `0600`.
+
+Check that everything is wired up:
+
+```
+npx affiliate-networks-mcp test
+```
+
+Then point your MCP client at the server. A sample Claude Desktop config
+lives at [`examples/claude-desktop-config.json`](./examples/claude-desktop-config.json)
+(with notes at [`examples/claude-desktop-config.md`](./examples/claude-desktop-config.md)):
+
+```json
+{
+  "mcpServers": {
+    "affiliate": {
+      "command": "npx",
+      "args": ["affiliate-networks-mcp"]
+    }
+  }
+}
+```
+
+Restart your client. The configured networks appear as tool calls prefixed
+`affiliate_<network>_…`.
+
+## Networks
+
+<!-- AFFILIATE_MCP_NETWORK_TABLE_START -->
+| Network | Setup time | Approval required | Supported ops | Notes |
+| --- | ---: | --- | ---: | --- |
+| Awin | 5 min | no | 6 / 7 | no clicks |
+| CJ Affiliate | 8 min | no | 6 / 7 | no clicks |
+| eBay Partner Network | 10 min | yes (~3 days) | 7 / 7 | see notes |
+| Impact | 6 min | no | 7 / 7 | upstream variability |
+| Rakuten Advertising | 12 min | yes (~5 days) | 6 / 7 | clicks gated |
+<!-- AFFILIATE_MCP_NETWORK_TABLE_END -->
+
+The table above is regenerated from each adapter's `network.json` by
+`npm run generate:readme`. For a per-network breakdown — operation-level
+support, latency, known limitations, and full findings prose — see
+[`REPORT.md`](./REPORT.md).
+
+## Per-network setup
+
+Each bundled network has a short setup document covering dashboard navigation,
+credential locations, and common stumbling blocks:
+
+- [Awin](./docs/networks/awin.md) — API token + publisher ID.
+- [CJ Affiliate](./docs/networks/cj.md) — Developer Key (GraphQL).
+- [eBay Partner Network](./docs/networks/ebay.md) — OAuth client + secret + campaign ID; approval required.
+- [Impact](./docs/networks/impact.md) — Account SID + Auth Token.
+- [Rakuten Advertising](./docs/networks/rakuten.md) — OAuth client + SID; approval required.
+
+## Tool surface
+
+Each registered network exposes the seven canonical publisher operations as
+MCP tools, named `affiliate_<network>_<snake_case_op>`:
+
+- `list_programmes`, `get_programme` — programmes (joined or available).
+- `list_transactions`, `get_earnings_summary` — transactions and aggregates.
+- `list_clicks` — click-level data, where the network exposes it.
+- `generate_tracking_link` — mint or construct a deeplink.
+- `verify_auth` — confirm credentials and surface the publisher identity.
+
+Two meta tools are always present: `affiliate_list_networks` and
+`affiliate_run_diagnostic`. They let a client enumerate the active adapters
+and check live capabilities in a single call.
+
+## Skills
+
+Four packaged skills wrap common workflows so the client picks the right
+tools without you naming them. Each lives under `src/skills/<name>/`:
+
+- [`affiliate-earnings-report`](./src/skills/affiliate-earnings-report/SKILL.md)
+  — consolidated period earnings across every configured network.
+- [`affiliate-network-status`](./src/skills/affiliate-network-status/SKILL.md)
+  — health check: auth, reachability, supported operations.
+- [`affiliate-network-setup-help`](./src/skills/affiliate-network-setup-help/SKILL.md)
+  — guides the user through setup for a specific network.
+- [`audit-affiliate-links`](./src/skills/audit-affiliate-links/SKILL.md)
+  — checks that affiliate links on a page or sitemap still resolve to active
+  programmes.
+
+## Status report
+
+[`REPORT.md`](./REPORT.md) is the editorial position: per-network capability,
+known limitations, and where the upstream API surprised us. Regenerated on
+every adapter merge. Treat it as the source of truth before opening an issue.
+
+## For developers
+
+Contributions are welcome — especially new network adapters. Start with
+[`CONTRIBUTING.md`](./CONTRIBUTING.md) for the human-side workflow, then read
+[`AGENTS.md`](./AGENTS.md) (the primer for AI coding agents — file layout,
+conventions, "what not to do") and `.claude/skills/contribute/SKILL.md` (the
+playbook a Claude Code session loads automatically when you open this repo).
+[`templates/new-network/`](./templates/new-network/) is the scaffold to copy.
+[`WANTED.md`](./WANTED.md) lists networks and ideas explicitly on the
+roadmap, and [`REPORT.md`](./REPORT.md) is the editorial baseline for any
+new claim about a network's API.
+
+Local development:
+
+```
+npm install
+npm test
+npm run typecheck
+npm run lint
+npm run build
+```
+
+Generators:
+
+```
+npm run generate:report       # writes REPORT.md
+npm run generate:readme       # updates the table block in this README
+npm run generate:report-image # renders the summary table as a PNG (needs Playwright)
+```
+
+## Licence
+
+MIT. See [`LICENCE`](./LICENCE).
+
+## Acknowledgements
+
+This project is only possible because the engineering teams at Awin, CJ
+Affiliate, eBay Partner Network, Impact, and Rakuten Advertising publish
+public, documented APIs for their publisher data. The adapters here read
+those APIs; they do not scrape, simulate, or work around any rate or access
+limits.

package/dist/cli/doctor.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `affiliate-mcp doctor [slug]` — verbose diagnostic.
+ *
+ * Same data as `test` but JSON, plus environment context (Node version,
+ * platform, config path + presence, masked variable list, per-operation
+ * resilience config). Designed for users to paste into a GitHub issue.
+ *
+ * Critical: variable VALUES must never be printed. Only NAMES and presence.
+ * The Pino redactor protects logs; this surface enforces the same rule
+ * explicitly because it dumps JSON to stdout for human consumption.
+ */
+import { runDiagnostic } from '../shared/diagnostic.js';
+import type { ResilienceConfigMap } from '../shared/types.js';
+export interface DoctorOptions {
+    slug?: string;
+}
+export interface DoctorReport {
+    generatedAt: string;
+    environment: {
+        nodeVersion: string;
+        platform: string;
+        arch: string;
+        affiliateMcpVersion: string;
+    };
+    config: {
+        path: string;
+        present: boolean;
+        /** Names only — never values. */
+        keys: string[];
+    };
+    adapters: Array<{
+        slug: string;
+        name: string;
+        claimStatus: string;
+        knownLimitations: string[];
+        resilience: ResilienceConfigMap;
+    }>;
+    diagnostic: Awaited<ReturnType<typeof runDiagnostic>>;
+}
+export declare function buildReport(opts?: DoctorOptions): Promise<DoctorReport>;
+export declare function runDoctor(opts?: DoctorOptions): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAIxD,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAM9E,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,iCAAiC;QACjC,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,UAAU,EAAE,mBAAmB,CAAC;KACjC,CAAC,CAAC;IACH,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC;CACvD;AAED,wBAAsB,WAAW,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAyCjF;AAED,wBAAsB,SAAS,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzE"}

package/dist/cli/doctor.js

@@ -0,0 +1,74 @@
+/**
+ * `affiliate-mcp doctor [slug]` — verbose diagnostic.
+ *
+ * Same data as `test` but JSON, plus environment context (Node version,
+ * platform, config path + presence, masked variable list, per-operation
+ * resilience config). Designed for users to paste into a GitHub issue.
+ *
+ * Critical: variable VALUES must never be printed. Only NAMES and presence.
+ * The Pino redactor protects logs; this surface enforces the same rule
+ * explicitly because it dumps JSON to stdout for human consumption.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { runDiagnostic } from '../shared/diagnostic.js';
+import { getAdapter, getAdapters } from '../shared/registry.js';
+import { resolveConfigPaths } from './wizard/paths.js';
+import { parseEnvFile } from '../shared/config.js';
+function out(line) {
+    process.stdout.write(line.endsWith('\n') ? line : `${line}\n`);
+}
+export async function buildReport(opts = {}) {
+    const paths = resolveConfigPaths();
+    const present = existsSync(paths.envFile);
+    let keys = [];
+    if (present) {
+        try {
+            const text = readFileSync(paths.envFile, 'utf8');
+            keys = Object.keys(parseEnvFile(text)).sort();
+        }
+        catch {
+            keys = [];
+        }
+    }
+    const targets = opts.slug
+        ? [getAdapter(opts.slug)].filter((a) => Boolean(a))
+        : getAdapters();
+    const diagnostic = await runDiagnostic(opts.slug);
+    return {
+        generatedAt: new Date().toISOString(),
+        environment: {
+            nodeVersion: process.version,
+            platform: process.platform,
+            arch: process.arch,
+            affiliateMcpVersion: readPackageVersion(),
+        },
+        config: {
+            path: paths.envFile,
+            present,
+            keys,
+        },
+        adapters: targets.map((a) => ({
+            slug: a.slug,
+            name: a.name,
+            claimStatus: a.meta.claimStatus,
+            knownLimitations: a.meta.knownLimitations,
+            resilience: a.resilienceConfig,
+        })),
+        diagnostic,
+    };
+}
+export async function runDoctor(opts = {}) {
+    const report = await buildReport(opts);
+    out(JSON.stringify(report, null, 2));
+    // Exit code: 0 if every diagnostic result has capabilities (no error) and
+    // every supported op is actually supported; 1 otherwise.
+    const anyError = report.diagnostic.results.some((r) => r.error);
+    return anyError ? 1 : 0;
+}
+function readPackageVersion() {
+    // Best-effort. We don't import package.json directly because the rootDir
+    // is `src` and the build would not copy it into dist. Use AFFILIATE_MCP_VERSION
+    // if the launcher set it; otherwise "unknown".
+    return process.env['AFFILIATE_MCP_VERSION'] ?? 'unknown';
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/setup.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `affiliate-mcp setup` — interactive setup wizard.
+ *
+ * Per PRD §4.3, setup is part of the product, not a side activity. Every
+ * surface here is user-facing copy. Errors name the network, name the field,
+ * and surface the verbatim underlying reason. No retries hidden, no silent
+ * fallbacks.
+ *
+ * Flow:
+ *   1. Detect first-run vs existing config. First-run jumps straight into
+ *      network selection; existing config offers setup / reset / add / quit.
+ *   2. Pick networks (multi-select).
+ *   3. For each picked network: walk `setupSteps()`, prompt per step, call
+ *      `validateCredential` on entry where requested, run `verifyAuth()` at
+ *      the end and merge any `derivedValues` from the underlying result.
+ *   4. Write `~/.affiliate-mcp/.env` (or `$AFFILIATE_MCP_CONFIG_DIR/.env`),
+ *      mode 0600. Reset replaces; add merges.
+ *   5. Print the absolute path written and a pointer to `affiliate-mcp test`.
+ *
+ * Output channel: this module writes to STDOUT because the wizard is an
+ * interactive surface — the JSON-RPC protocol is not active during `setup`.
+ * The shared Pino logger continues to write to stderr only.
+ */
+import { type Prompter } from './wizard/prompts.js';
+export interface SetupOptions {
+    /** Override the prompter (tests). Falls back to the shared singleton. */
+    prompter?: Prompter;
+    /**
+     * When true, skip the interactive top-level menu and go straight into
+     * configuration. Used by tests and by future flags like `--add`.
+     */
+    mode?: 'auto' | 'setup' | 'reset' | 'add';
+}
+export declare function runSetup(opts?: SetupOptions): Promise<number>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAsBjE,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;CAC3C;AAED,wBAAsB,QAAQ,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+EvE"}

package/dist/cli/setup.js

@@ -0,0 +1,254 @@
+/**
+ * `affiliate-mcp setup` — interactive setup wizard.
+ *
+ * Per PRD §4.3, setup is part of the product, not a side activity. Every
+ * surface here is user-facing copy. Errors name the network, name the field,
+ * and surface the verbatim underlying reason. No retries hidden, no silent
+ * fallbacks.
+ *
+ * Flow:
+ *   1. Detect first-run vs existing config. First-run jumps straight into
+ *      network selection; existing config offers setup / reset / add / quit.
+ *   2. Pick networks (multi-select).
+ *   3. For each picked network: walk `setupSteps()`, prompt per step, call
+ *      `validateCredential` on entry where requested, run `verifyAuth()` at
+ *      the end and merge any `derivedValues` from the underlying result.
+ *   4. Write `~/.affiliate-mcp/.env` (or `$AFFILIATE_MCP_CONFIG_DIR/.env`),
+ *      mode 0600. Reset replaces; add merges.
+ *   5. Print the absolute path written and a pointer to `affiliate-mcp test`.
+ *
+ * Output channel: this module writes to STDOUT because the wizard is an
+ * interactive surface — the JSON-RPC protocol is not active during `setup`.
+ * The shared Pino logger continues to write to stderr only.
+ */
+import { existsSync } from 'node:fs';
+import { getAdapters } from '../shared/registry.js';
+import { getPrompter } from './wizard/prompts.js';
+import { resolveConfigPaths } from './wizard/paths.js';
+import { filterOutKeys, mergeEnv, readEnv, writeEnv } from './wizard/envfile.js';
+function out(line = '') {
+    process.stdout.write(line.endsWith('\n') ? line : `${line}\n`);
+}
+function banner() {
+    out('');
+    out('  affiliate-mcp — setup wizard');
+    out('  ----------------------------');
+    out('  This wizard collects API credentials for each affiliate network you want');
+    out('  to use and writes them to a single config file. Tokens are validated as');
+    out('  you enter them so problems surface immediately, not at first call.');
+    out('');
+}
+export async function runSetup(opts = {}) {
+    const prompter = opts.prompter ?? getPrompter();
+    const paths = resolveConfigPaths();
+    const hasConfig = existsSync(paths.envFile);
+    banner();
+    // Decide the top-level action.
+    let mode = opts.mode ?? 'auto';
+    if (mode === 'auto') {
+        if (!hasConfig) {
+            out(`No config file at ${paths.envFile}.`);
+            out('');
+            mode = 'setup';
+        }
+        else {
+            out(`Existing config at ${paths.envFile}.`);
+            const choice = await prompter.menu('What would you like to do?', [
+                { key: 'add', label: 'add — configure an additional network' },
+                { key: 'reset', label: 'reset — wipe and start over' },
+                { key: 'quit', label: 'quit — exit without changes' },
+            ]);
+            if (choice === 'quit') {
+                out('No changes made.');
+                return 0;
+            }
+            mode = choice;
+        }
+    }
+    const adapters = getAdapters();
+    if (adapters.length === 0) {
+        out('No network adapters are registered. This is a build problem, not a config one.');
+        out('Reinstall affiliate-mcp or report this at https://github.com/atolls/affiliate-mcp.');
+        return 1;
+    }
+    // Network picker.
+    const selected = await pickNetworks(prompter, adapters);
+    if (selected.length === 0) {
+        out('No networks selected. No changes made.');
+        return 0;
+    }
+    // Existing env — read once. Reset drops the chosen networks' keys; add keeps
+    // every existing entry.
+    let existing = readEnv(paths.envFile);
+    if (mode === 'reset') {
+        const drop = [];
+        for (const adapter of selected) {
+            for (const step of adapter.setupSteps())
+                drop.push(step.field);
+        }
+        existing = filterOutKeys(existing, drop);
+    }
+    // Walk each network.
+    const newEntries = {};
+    for (const adapter of selected) {
+        out('');
+        out(`Configuring ${adapter.name} (${adapter.slug})`);
+        out('-'.repeat(`Configuring ${adapter.name} (${adapter.slug})`.length));
+        if (adapter.meta.setupRequiresApproval) {
+            const days = adapter.meta.setupApprovalDaysTypical ?? 0;
+            out(`Note: ${adapter.name} requires partner approval before API access is granted.` +
+                (days > 0 ? ` Typical turnaround is ~${days} business days.` : ''));
+        }
+        const captured = await runNetworkSetup(prompter, adapter);
+        Object.assign(newEntries, captured);
+    }
+    // Merge and write.
+    const merged = mergeEnv(existing, newEntries);
+    writeEnv(paths.envFile, merged);
+    out('');
+    out(`Wrote ${paths.envFile}.`);
+    out('You are set up. Test with `affiliate-mcp test`.');
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Network picker
+// ---------------------------------------------------------------------------
+async function pickNetworks(prompter, adapters) {
+    const choices = adapters.map((a) => {
+        const minutes = a.meta.setupTimeEstimateMinutes;
+        const approval = a.meta.setupRequiresApproval ? ', approval required' : '';
+        return {
+            key: a.slug,
+            label: `${a.name} — ~${minutes} min${approval}`,
+        };
+    });
+    const slugs = await prompter.selectMany('Which networks would you like to configure?', choices);
+    const set = new Set(slugs);
+    return adapters.filter((a) => set.has(a.slug));
+}
+// ---------------------------------------------------------------------------
+// Per-network walk
+// ---------------------------------------------------------------------------
+/**
+ * Drive a single network adapter through its steps. Returns the captured
+ * field → value map. Calls `verifyAuth()` at the end and merges any
+ * `derivedValues` from the underlying result.
+ */
+async function runNetworkSetup(prompter, adapter) {
+    const captured = {};
+    const steps = adapter.setupSteps();
+    for (const step of steps) {
+        const value = await runStep(prompter, adapter, step, captured);
+        if (value === null) {
+            out(`Skipped ${step.field}. You can edit it later in the config file.`);
+            continue;
+        }
+        captured[step.field] = value;
+        // Stash into process.env so the subsequent verifyAuth() picks it up.
+        process.env[step.field] = value;
+    }
+    // End-to-end auth verify + derived values merge.
+    out('');
+    out(`Verifying ${adapter.name} credentials…`);
+    try {
+        const result = await adapter.verifyAuth();
+        if (result.ok) {
+            const id = 'identity' in result && result.identity ? ` (${result.identity})` : '';
+            out(`Verified${id}.`);
+            // Duck-type derivedValues — the public adapter interface does not
+            // expose them, but the underlying auth module returns them. See the
+            // wizard handoff for why this is an Option B duck-type rather than an
+            // interface change.
+            const derived = result
+                .derivedValues;
+            if (derived) {
+                for (const [k, v] of Object.entries(derived)) {
+                    if (typeof v !== 'string' || v === '')
+                        continue;
+                    if (captured[k] && captured[k] === v)
+                        continue;
+                    captured[k] = v;
+                    process.env[k] = v;
+                    out(`Derived ${k} = ${v} from your credentials (no manual entry needed).`);
+                }
+            }
+        }
+        else {
+            out(`${adapter.name} verifyAuth failed: ${result.reason}`);
+            out('Credentials saved anyway so you can edit and re-run `affiliate-mcp test`.');
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        out(`${adapter.name} verifyAuth raised an error: ${msg}`);
+        out('Credentials saved anyway so you can edit and re-run `affiliate-mcp test`.');
+    }
+    return captured;
+}
+/**
+ * Run a single step: render description verbatim, prompt for input, call
+ * `validateOnEntry` if present, offer retry/edit/skip on failure.
+ *
+ * Returns the captured value, or null if the user skipped.
+ */
+async function runStep(prompter, adapter, step, _captured) {
+    out('');
+    // Verbatim description — written by the network's adapter author.
+    for (const line of step.description.split('\n'))
+        out(line);
+    for (;;) {
+        const value = await promptForStep(prompter, step);
+        if (value === '') {
+            out(`${step.field} is empty. Skipping is allowed; you can add it later.`);
+            const skip = await prompter.confirm('Skip this field?');
+            if (skip)
+                return null;
+            continue;
+        }
+        // validateOnEntry — if defined, run it and surface the verbatim reason.
+        if (step.validateOnEntry) {
+            let result;
+            try {
+                result = await step.validateOnEntry(value);
+            }
+            catch (err) {
+                result = {
+                    ok: false,
+                    message: err instanceof Error ? err.message : String(err),
+                };
+            }
+            if (!result.ok) {
+                // PRD §4.1: name the network, name the field, surface the reason.
+                out(`${adapter.name} rejected ${step.field}: ${result.message ?? 'invalid value'}`);
+                if (result.hint)
+                    out(`Hint: ${result.hint}`);
+                const next = await prompter.menu('What next?', [
+                    { key: 'retry', label: 'retry — enter again' },
+                    { key: 'skip', label: 'skip — leave blank for now' },
+                ]);
+                if (next === 'skip')
+                    return null;
+                continue;
+            }
+            if (result.message)
+                out(`OK: ${result.message}`);
+        }
+        return value;
+    }
+}
+async function promptForStep(prompter, step) {
+    const label = step.label;
+    if (step.type === 'password') {
+        return await prompter.password(label);
+    }
+    if (step.type === 'number') {
+        const example = step.example;
+        const n = await prompter.number(label, example ? { example } : undefined);
+        return String(n);
+    }
+    const opts = {};
+    if (step.example)
+        opts.example = step.example;
+    return await prompter.text(label, opts);
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

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

package/dist/cli/test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `affiliate-mcp test [slug]` — friendly diagnostic.
+ *
+ * Drives `runDiagnostic` and prints a human-readable summary. Designed for the
+ * common "is it working?" question — no JSON, no stack traces, just one line
+ * per network plus an extra line per failing operation.
+ *
+ * Output is to stdout (user-facing CLI text on an interactive surface). Pino
+ * still logs to stderr.
+ */
+import { type DiagnosticResult } from '../shared/diagnostic.js';
+export interface TestOptions {
+    slug?: string;
+}
+export declare function runTest(opts?: TestOptions): Promise<number>;
+/** Exposed for tests so they can assert the formatter output directly. */
+export declare function formatDiagnostic(result: DiagnosticResult): string;
+//# sourceMappingURL=test.d.ts.map

package/dist/cli/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/cli/test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAO/E,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,OAAO,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BrE;AA6DD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgBjE"}