@reclaimprotocol/agent 0.1.18 → 0.1.20

package/lib/mcp/tools/verification/diagnose.js

@@ -1,132 +0,0 @@
-import { buildAuthHeaders } from '@reclaimprotocol/client';
-import { defineTool } from "../../server.js";
-import { resolveActivePrivateKey } from "./result.js";
-const TERMINAL = new Set(['success', 'rejected', 'error']);
-/**
- * `diagnose_verification_session` — one call that answers "what's wrong
- * with this session?". Pulls the session, its full event log, and its
- * callback-delivery diagnostics, then derives findings (where the flow
- * stalled or failed) and concrete suggestions (what to check or do next).
- * Read-only; authenticates with the active eth credential like
- * `get_verification_result`.
- */
-export function verificationDiagnoseTool(client) {
-    return defineTool({
-        name: 'diagnose_verification_session',
-        description: 'Diagnose a verification session: fetches its status, event ' +
-            'timeline, and callback-delivery state, then reports findings ' +
-            '(where the flow stalled or failed — link never opened, proof ' +
-            'failed, callback endpoint erroring, dead-lettered delivery, ' +
-            'expiry) and suggested next steps. Read-only. Use ' +
-            'get_verification_result to fetch and decrypt the actual result.',
-        inputSchema: {
-            type: 'object',
-            required: ['sessionId'],
-            properties: {
-                sessionId: {
-                    type: 'string',
-                    description: 'The verification session id to diagnose.',
-                },
-            },
-        },
-    }, async (args) => {
-        const privateKey = resolveActivePrivateKey();
-        const auth = () => buildAuthHeaders(privateKey, 'VerificationAuth');
-        const params = { sessionId: args.sessionId };
-        const [session, events, deliveries] = await Promise.all([
-            client.call('GetVerificationSession', { params, headers: auth() })
-                .then((r) => r.data),
-            client.call('ListVerificationEvents', { params, headers: auth() })
-                .then((r) => r.data.items),
-            client.call('ListVerificationDeliveries', { params, headers: auth() })
-                .then((r) => r.data.items),
-        ]);
-        const seen = new Set(events.map((e) => e.event));
-        const last = events[events.length - 1];
-        const findings = [];
-        const suggestions = [];
-        // Where did the flow get to?
-        if (session.status === 'pending') {
-            if (new Date(session.expiresAt).getTime() < Date.now()) {
-                findings.push('Session is past expiresAt — it will flip to expired on the ' +
-                    'next sweep; the end-user can no longer complete it.');
-                suggestions.push('Create a new session and share a fresh link.');
-            }
-            else if (!seen.has('verification_client_opened')) {
-                findings.push('The end-user has not opened the verification link yet.');
-                suggestions.push(`Re-share the link (${session.verificationUrl}) before ` +
-                    `it expires at ${session.expiresAt}.`);
-            }
-            else if (!seen.has('request_matched')) {
-                findings.push('The page was opened but the target request was never ' +
-                    'captured — the end-user likely has not completed the ' +
-                    'login/journey on the provider site.');
-            }
-            else {
-                findings.push('Proof flow is in progress — the target request was ' +
-                    'captured and the run has not reached a terminal event.');
-            }
-        }
-        if (session.status === 'expired') {
-            findings.push(seen.has('verification_client_opened')
-                ? 'Session expired mid-flow — the end-user started but did ' +
-                    'not finish before expiresAt.'
-                : 'Session expired without the link ever being opened.');
-            suggestions.push('Create a new session and share a fresh link.');
-        }
-        // Surface failure detail from the event log.
-        for (const e of events) {
-            if (e.event === 'request_claim_failed' ||
-                e.event === 'request_claim_rejected' ||
-                e.event === 'verification_error' ||
-                e.event === 'verification_rejected') {
-                findings.push(`${e.event} at ${e.createdAt}` +
-                    (e.eventData ? `: ${JSON.stringify(e.eventData)}` : ''));
-            }
-        }
-        // Callback delivery health (only meaningful after a terminal event).
-        for (const d of deliveries) {
-            if (d.deliveryStatus === 'delivered') {
-                continue;
-            }
-            findings.push(`Callback to ${d.callbackUrl} is ${d.deliveryStatus} after ` +
-                `${d.attempts} attempt(s)` +
-                (d.lastError ? ` — last error: ${d.lastError}` : '') +
-                (d.deadLettered ? ' (dead-lettered; retries exhausted)' : ''));
-            suggestions.push(`Check that ${d.callbackUrl} is reachable and answers 2xx.`);
-            if (d.deadLettered) {
-                suggestions.push('Once the endpoint is fixed, re-deliver via ' +
-                    'POST /verifications/sessions/{sessionId}/retry-callback ' +
-                    '(or ask an admin to retry it from the Callback DLQ).');
-            }
-        }
-        if (TERMINAL.has(session.status) &&
-            deliveries.every((d) => d.deliveryStatus === 'delivered')) {
-            suggestions.push('Result delivered. Use get_verification_result to fetch and ' +
-                'decrypt it locally.');
-        }
-        if (!findings.length) {
-            findings.push('No problems detected.');
-        }
-        return {
-            sessionId: session.id,
-            status: session.status,
-            callbackDeliveryStatus: session.callbackDeliveryStatus,
-            mode: session.mode,
-            createdAt: session.createdAt,
-            expiresAt: session.expiresAt,
-            completedAt: session.completedAt,
-            lastEvent: last
-                ? { event: last.event, at: last.createdAt }
-                : undefined,
-            events: events.map((e) => ({
-                event: e.event,
-                at: e.createdAt,
-                ...(e.eventData ? { data: e.eventData } : {}),
-            })),
-            deliveries,
-            findings,
-            suggestions,
-        };
-    });
-}

package/lib/mcp/verifications/build.d.ts

@@ -1,5 +0,0 @@
-import type { ReclaimClient } from '@reclaimprotocol/client';
-import type { RegisteredTool } from '../server.ts';
-/** Verification CRUD tools — build the flat list of RegisteredTool
- *  entries. Mirrors buildAgentTools() in mcp/register.ts. */
-export declare function buildVerificationTools(client: ReclaimClient): RegisteredTool[];

package/lib/mcp/verifications/build.js

@@ -1,14 +0,0 @@
-import { createTool } from "./create.js";
-import { findTool } from "./find.js";
-import { getTool } from "./get.js";
-import { updateTool } from "./update.js";
-/** Verification CRUD tools — build the flat list of RegisteredTool
- *  entries. Mirrors buildAgentTools() in mcp/register.ts. */
-export function buildVerificationTools(client) {
-    return [
-        findTool(client),
-        getTool(client),
-        createTool(client),
-        updateTool(client),
-    ];
-}

package/lib/mcp/verifications/create.d.ts

@@ -1,3 +0,0 @@
-import type { ReclaimClient } from '@reclaimprotocol/client';
-import { type RegisteredTool } from '../server.ts';
-export declare function createTool(client: ReclaimClient): RegisteredTool;

package/lib/mcp/verifications/create.js

@@ -1,57 +0,0 @@
-import { defineTool } from "../server.js";
-export function createTool(client) {
-    return defineTool({
-        name: 'create_verification',
-        description: 'Create a new Reclaim verification. Use this only ' +
-            'after `find_verification` returned nothing useful ' +
-            'for the domain. The caller must be an active ' +
-            'member of the target organization.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                orgId: {
-                    type: 'string',
-                    description: 'uuid identifier of the organization ' +
-                        'that will own the verification.'
-                },
-                domain: {
-                    type: 'string',
-                    minLength: 1,
-                    maxLength: 200,
-                    description: 'Canonical root domain (e.g. `github.com`). ' +
-                        'No scheme, no port, no path.',
-                },
-                slug: {
-                    type: 'string',
-                    pattern: '^[a-z0-9]+(?:-[a-z0-9]+)*$',
-                    minLength: 1,
-                    maxLength: 100,
-                    description: 'URL-safe identifier. Globally unique — pick ' +
-                        'something domain-specific like `github-followers`.',
-                },
-                title: {
-                    type: 'string',
-                    minLength: 1,
-                    maxLength: 100,
-                    description: 'Short headline shown to end-users. Defaults ' +
-                        'to a domain-derived brand name.',
-                },
-                description: { type: 'string', minLength: 1, maxLength: 2000 },
-                iconUrl: { type: 'string', description: 'uri of the icon' },
-                tags: { type: 'array', items: { type: 'string' }, maxItems: 50 },
-            },
-            required: ['orgId', 'domain', 'slug'],
-        },
-    }, async (args) => client.call('CreateProvider', {
-        body: {
-            orgId: args.orgId,
-            domain: args.domain,
-            slug: args.slug,
-            title: args.title,
-            description: args.description,
-            iconUrl: args.iconUrl,
-            tags: args.tags ?? [],
-            visibility: 'PRIVATE'
-        },
-    }));
-}

package/lib/mcp/verifications/find.d.ts

@@ -1,3 +0,0 @@
-import type { ReclaimClient } from '@reclaimprotocol/client';
-import { type RegisteredTool } from '../server.ts';
-export declare function findTool(client: ReclaimClient): RegisteredTool;

package/lib/mcp/verifications/find.js

@@ -1,37 +0,0 @@
-import { defineTool } from "../server.js";
-export function findTool(client) {
-    return defineTool({
-        name: 'find_verification',
-        description: 'Search published Reclaim verifications by domain or ' +
-            'data point. A verification is the recipe an end-user ' +
-            'follows to prove something about themselves (e.g. ' +
-            '"I have N followers on Twitter"). Returns a list of ' +
-            'matches. Call this BEFORE `create_verification` — ' +
-            'most popular domains already have a public ' +
-            'verification you can reuse.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                query: {
-                    type: 'string',
-                    minLength: 1,
-                    maxLength: 200,
-                    description: 'Free-text query. Matches domain (e.g. ' +
-                        '"github.com"), title, description, and the ' +
-                        'data points a verification can prove.',
-                },
-                tags: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Restrict to verifications carrying every tag.',
-                },
-                limit: { type: 'number', minimum: 1, maximum: 100 },
-            },
-        },
-    }, async (args) => client.call('Providers', {
-        query: {
-            q: args.query,
-            tag: args.tags ?? [],
-        },
-    }));
-}

package/lib/mcp/verifications/get.d.ts

@@ -1,3 +0,0 @@
-import type { ReclaimClient } from '@reclaimprotocol/client';
-import { type RegisteredTool } from '../server.ts';
-export declare function getTool(client: ReclaimClient): RegisteredTool;

package/lib/mcp/verifications/get.js

@@ -1,26 +0,0 @@
-import { defineTool } from "../server.js";
-export function getTool(client) {
-    return defineTool({
-        name: 'get_verification',
-        description: 'Fetch a single Reclaim verification by id. Returns ' +
-            'every field needed to integrate it into a flow: ' +
-            'domain, the live version (initialUrl + requests), ' +
-            'and the data points it can prove. Use ' +
-            '`find_verification` first if you only have a query ' +
-            'string.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                providerId: {
-                    type: 'string',
-                    description: 'UUID of the verification. (Internally stored ' +
-                        'as `providerId` — the field name reflects ' +
-                        'the openapi schema.)',
-                },
-            },
-            required: ['providerId'],
-        },
-    }, async (args) => client.call('GetProvider', {
-        params: { providerId: args.providerId },
-    }));
-}

package/lib/mcp/verifications/update.d.ts

@@ -1,3 +0,0 @@
-import type { ReclaimClient } from '@reclaimprotocol/client';
-import { type RegisteredTool } from '../server.ts';
-export declare function updateTool(client: ReclaimClient): RegisteredTool;

package/lib/mcp/verifications/update.js

@@ -1,78 +0,0 @@
-import { defineTool } from "../server.js";
-export function updateTool(client) {
-    return defineTool({
-        name: 'update_verification',
-        description: "Update a Reclaim verification's metadata. Partial " +
-            'PATCH — pass only fields you want to change. The ' +
-            'caller must be an active member of the owning ' +
-            "organization. To change the verification's " +
-            'recipe (initialUrl, requests, …) cut a new ' +
-            'version via the dashboard. Use `seo` to control how ' +
-            'the verification appears in search results and social ' +
-            'shares; omit a subfield to keep the server default.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                providerId: {
-                    type: 'string',
-                    description: 'UUID of the verification. (Internally stored ' +
-                        'as `providerId` — the field name reflects ' +
-                        'the openapi schema.)',
-                },
-                title: { type: 'string', minLength: 1, maxLength: 100 },
-                description: { type: 'string', minLength: 1, maxLength: 2000 },
-                iconUrl: { type: 'string', description: 'uri of icon' },
-                clearIcon: {
-                    type: 'boolean',
-                    description: 'Set true to wipe the icon explicitly.',
-                },
-                visibility: { type: 'string', enum: ['PRIVATE', 'PUBLIC'] },
-                status: { type: 'string', enum: ['ACTIVE', 'ARCHIVED'] },
-                tags: { type: 'array', items: { type: 'string' }, maxItems: 50 },
-                seo: {
-                    type: 'object',
-                    additionalProperties: false,
-                    description: 'Author SEO overrides. Each field falls back to a ' +
-                        'server-derived suggestion when unset.',
-                    properties: {
-                        brandUrl: {
-                            type: 'string',
-                            maxLength: 2000,
-                            description: 'Canonical homepage url of the brand.',
-                        },
-                        primaryDataPoint: {
-                            type: 'string',
-                            maxLength: 200,
-                            description: 'Headline data point (e.g. "subscriber ' +
-                                'count"); used in the SEO title.',
-                        },
-                        dataPoints: {
-                            type: 'array',
-                            items: { type: 'string', maxLength: 200 },
-                            maxItems: 50,
-                            description: 'Full list of verifiable data points.',
-                        },
-                        titleOverride: {
-                            type: 'string',
-                            maxLength: 200,
-                            description: 'Replaces the composed page title.',
-                        },
-                        descriptionOverride: {
-                            type: 'string',
-                            maxLength: 320,
-                            description: 'Replaces the composed meta description.',
-                        },
-                    },
-                },
-            },
-            required: ['providerId'],
-        },
-    }, async (args) => {
-        const { providerId, ...rest } = args;
-        return client.call('UpdateProvider', {
-            params: { providerId },
-            headers: {},
-            body: rest,
-        });
-    });
-}

package/lib/old/tools/get-version-config.d.ts

@@ -1,17 +0,0 @@
-import { type RegisteredTool } from '../../mcp/server.ts';
-import type { ReclaimOldClient } from '../client.ts';
-/**
- * Read the full `providerConfig` (loginUrl, customInjection, requestData,
- * geoLocation, ...) of one provider version on the old devtools backend —
- * the latest version when `version` is omitted.
- *
- * Exists so a dev/agent can see what's CURRENTLY published before adding a
- * new version with `create_provider_version_from_capture`. That tool always
- * takes a FULL replacement `providerConfig` (no partial-patch endpoint on
- * this backend), so a version added without knowing the current
- * `customInjection` would silently publish it blank — wiping a working
- * login script instead of preserving it. Read it here first, then pass it
- * straight through (or omit `customInjection` on publish to have it carried
- * forward automatically).
- */
-export declare function getProviderVersionConfigTool(client: ReclaimOldClient): RegisteredTool;

package/lib/old/tools/get-version-config.js

@@ -1,47 +0,0 @@
-import { defineTool } from "../../mcp/server.js";
-/**
- * Read the full `providerConfig` (loginUrl, customInjection, requestData,
- * geoLocation, ...) of one provider version on the old devtools backend —
- * the latest version when `version` is omitted.
- *
- * Exists so a dev/agent can see what's CURRENTLY published before adding a
- * new version with `create_provider_version_from_capture`. That tool always
- * takes a FULL replacement `providerConfig` (no partial-patch endpoint on
- * this backend), so a version added without knowing the current
- * `customInjection` would silently publish it blank — wiping a working
- * login script instead of preserving it. Read it here first, then pass it
- * straight through (or omit `customInjection` on publish to have it carried
- * forward automatically).
- */
-export function getProviderVersionConfigTool(client) {
-    return defineTool({
-        name: 'get_provider_version_config',
-        description: 'Fetch the full providerConfig (loginUrl, customInjection, ' +
-            'requestData, geoLocation, ...) of one version on the old devtools ' +
-            'backend — the latest version when `version` is omitted. Readable ' +
-            'for any non-archived provider, not just ones you own. Use this ' +
-            'BEFORE calling create_provider_version_from_capture with a ' +
-            '`providerId` to see the currently-published customInjection/' +
-            'requestData so you know what you would be changing — that tool ' +
-            'replaces the whole providerConfig, so a field you never see and ' +
-            "never pass comes out blank in the new version, even if it's set " +
-            'today.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                providerId: {
-                    type: 'string',
-                    description: 'UUID of the provider (from get_me_providers).',
-                },
-                version: {
-                    type: 'string',
-                    description: 'Specific version to fetch, e.g. "1.0.2". Omit for the ' +
-                        "provider's current latest version.",
-                },
-            },
-            required: ['providerId'],
-        },
-    }, async ({ providerId, version }) => {
-        return client.getProviderConfig(providerId, version);
-    });
-}