@reclaimprotocol/agent 0.1.1-dev.1 → 0.1.2

package/lib/consts.js

@@ -0,0 +1,134 @@
+/**
+ * Centralized environment access for `@reclaimprotocol/agent`.
+ *
+ * This is the ONLY non-test source file under `src/` that reads
+ * `process.env`. Every other module imports a getter from here instead of
+ * touching `process.env` directly.
+ *
+ * Almost everything is exposed as a LAZY GETTER FUNCTION rather than an eager
+ * `const`, on purpose: several tests mutate env at runtime (mcp-credentials
+ * sets/deletes RECLAIM_PRIVATE_KEY / RECLAIM_PRIVATE_KEY_FILE / RECLAIM_HOME;
+ * old-devtools sets/deletes USE_OLD_DEVTOOLS), and most of these vars are read
+ * at call time anyway. An eager const captured at import time would freeze the
+ * value and break those tests. The one eager const that's safe is `LOG_LEVEL`,
+ * which is read once at logger construction.
+ *
+ * Each var's default/fallback literal is co-located with its getter.
+ */
+import { DEFAULT_BASE_URL } from '@reclaimprotocol/client';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { DEFAULT_OLD_API_URL } from "./old/client.js";
+// ---------------------------------------------------------------------------
+// Default / fallback literals (used only as env fallbacks).
+// ---------------------------------------------------------------------------
+/** Public attestor websocket URL — fallback for `RECLAIM_ATTESTOR_URL`. */
+export const FALLBACK_ATTESTOR_URL = 'wss://attestor.reclaimprotocol.org:444/ws';
+/** The devtools dashboard login page — fallback for `RECLAIM_OLD_LOGIN_URL`. */
+export const DEFAULT_LOGIN_URL = 'https://dev.reclaimprotocol.org';
+// Re-export the two non-env-fallback defaults so callers can keep importing
+// their URL defaults from a single place if they wish.
+export { DEFAULT_BASE_URL, DEFAULT_OLD_API_URL };
+// ---------------------------------------------------------------------------
+// Logging.
+// ---------------------------------------------------------------------------
+/** Pino log level. Read once at logger construction, so an eager const is
+ *  safe (no test mutates LOG_LEVEL at runtime). */
+export const LOG_LEVEL = process.env.LOG_LEVEL || 'info';
+// ---------------------------------------------------------------------------
+// Paths.
+// ---------------------------------------------------------------------------
+/** Reclaim cache directory (`~/.reclaim`). `RECLAIM_HOME` overrides it so
+ *  tests can sandbox writes. */
+export function reclaimHome() {
+    return process.env.RECLAIM_HOME || join(homedir(), '.reclaim');
+}
+// ---------------------------------------------------------------------------
+// Mode flag.
+// ---------------------------------------------------------------------------
+/**
+ * `USE_OLD_DEVTOOLS` — single source of truth for which backend the MCP
+ * server targets. Defaults to OLD devtools while the builder backend is under
+ * development. Builder mode must be opted into EXPLICITLY with
+ * `USE_OLD_DEVTOOLS=false`; anything else keeps old mode on.
+ */
+export function useOldDevtools() {
+    return (process.env.USE_OLD_DEVTOOLS ?? '').trim().toLowerCase() !== 'false';
+}
+// ---------------------------------------------------------------------------
+// Chrome / CDP launcher.
+// ---------------------------------------------------------------------------
+/** `%LOCALAPPDATA%` on Windows, used to probe a per-user Chrome install. */
+export function localAppData() {
+    return process.env['LOCALAPPDATA'];
+}
+/** Explicit Chrome/Edge/Chromium binary path override. */
+export function chromePath() {
+    return process.env.RECLAIM_AGENT_CHROME_PATH;
+}
+// ---------------------------------------------------------------------------
+// MCP server / API clients.
+// ---------------------------------------------------------------------------
+/** Agent tools (Chrome CDP capture, synthesis, proof) are disabled in hosted
+ *  deployments by setting `RECLAIM_AGENT_DISABLED=1`. Shared by mcp/start and
+ *  the old-mode authenticate tool. */
+export function agentDisabled() {
+    return process.env.RECLAIM_AGENT_DISABLED === '1';
+}
+/** Old-devtools backend base URL. */
+export function oldApiUrl() {
+    return process.env.RECLAIM_OLD_API_URL || DEFAULT_OLD_API_URL;
+}
+/** Builder backend base URL. Shared by mcp/start and the verification tool. */
+export function apiUrl() {
+    return process.env.RECLAIM_API_URL || DEFAULT_BASE_URL;
+}
+/** Explicit builder API token (overrides the cached session token). */
+export function apiToken() {
+    return process.env.RECLAIM_API_TOKEN;
+}
+// ---------------------------------------------------------------------------
+// Proof tracing.
+// ---------------------------------------------------------------------------
+/** Diagnostic trace capture (`RECLAIM_AGENT_TRACE=1`). Shared by the attestor
+ *  logger capture and the proof-run dump. */
+export function agentTraceEnabled() {
+    return process.env['RECLAIM_AGENT_TRACE'] === '1';
+}
+/** Attestor websocket URL override (`RECLAIM_ATTESTOR_URL`). */
+export function attestorUrlOverride() {
+    return process.env['RECLAIM_ATTESTOR_URL'];
+}
+// ---------------------------------------------------------------------------
+// Eth proof-owner key resolution.
+// ---------------------------------------------------------------------------
+/** Raw 0x-hex Ethereum private key (`RECLAIM_PRIVATE_KEY`). */
+export function privateKey() {
+    return process.env.RECLAIM_PRIVATE_KEY;
+}
+/** Path to a raw-hex key file (`RECLAIM_PRIVATE_KEY_FILE`). */
+export function privateKeyFile() {
+    return process.env.RECLAIM_PRIVATE_KEY_FILE;
+}
+// ---------------------------------------------------------------------------
+// Verification reads.
+// ---------------------------------------------------------------------------
+/** Per-org bearer secret (`rorg_…`) used to authenticate verification reads. */
+export function orgSecret() {
+    return process.env.RECLAIM_ORG_SECRET;
+}
+// ---------------------------------------------------------------------------
+// Old-devtools identity / login.
+// ---------------------------------------------------------------------------
+/** Dashboard Firebase bearer token for the old backend. */
+export function oldApiToken() {
+    return process.env.RECLAIM_OLD_API_TOKEN;
+}
+/** An `eth:<addr>` (or bare `0x…`) uid for the old backend. */
+export function oldEthUid() {
+    return process.env.RECLAIM_OLD_ETH_UID;
+}
+/** Override for the old-devtools dashboard login URL. */
+export function oldLoginUrl() {
+    return process.env.RECLAIM_OLD_LOGIN_URL;
+}

package/lib/index.d.ts

@@ -1,3 +1,3 @@
 export * from '@reclaimprotocol/client';
-export { buildAgentTools, } from './mcp/tools/agent/build.ts';
-export type { AgentState } from './mcp/tools/agent/build.ts';
+export { buildAgentTools } from './mcp/tools/agent/index.ts';
+export type { AgentState } from './mcp/tools/agent/index.ts';

package/lib/index.js

@@ -4,4 +4,4 @@
 // only need one package for both the typed HTTP client and the agent tools.
 export * from '@reclaimprotocol/client';
 // Agent — Chrome CDP capture, provider synthesis, replay, proof.
-export { buildAgentTools, } from "./mcp/tools/agent/build.js";
+export { buildAgentTools } from "./mcp/tools/agent/index.js";

package/lib/logger.js

@@ -1,7 +1,8 @@
 import pino, { stdTimeFunctions } from 'pino';
+import { LOG_LEVEL } from "./consts.js";
 export const LOGGER = pino({
     name: '@reclaimprotocol/agent',
     timestamp: stdTimeFunctions.isoTime,
     base: { hostname: undefined, pid: undefined },
 });
-LOGGER.level = process.env.LOG_LEVEL || 'info';
+LOGGER.level = LOG_LEVEL;

package/lib/mcp/api/operations.gen.d.ts

@@ -1,151 +1,203 @@
 export declare const MCP_TOOLS: {
     AddOrgMember: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     AdminOrgs: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     AdminProviders: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     AdminReviews: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    AdminSessions: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     CancelPublicListingRequest: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     CreateAttachSession: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    CreateCallbackSubscription: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     CreateOrg: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    CreateOrgCallbackSubscription: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     CreateProvider: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     CreateProviderVersion: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    CreateVerificationSession: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     DecideProviderVersionReview: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    DeleteProvider: {
+    DeleteCallbackSubscription: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    DeleteProviderVersion: {
+    DeleteOrgCallbackSubscription: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    GetAttachSession: {
+    DeleteOrgKeypair: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    GetCredential: {
+    DeleteProvider: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    GetCredentialByAddress: {
+    DeleteProviderVersion: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    GetAttachSession: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     GetMe: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     GetOrg: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     GetOrgBilling: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    GetOrgKeypair: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    GetOrgToken: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     GetProvider: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     GetProviderVersion: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     GetUser: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    LinkCredential: {
+    GetVerificationSession: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    ListOrgCredentials: {
+    IssueOrgToken: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    ListCallbackDlq: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    ListCallbackSubscriptions: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    ListOrgCallbackSubscriptions: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     ListOrgs: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    ListOrgVerificationSessions: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     ListProviderVersions: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    ListVerificationDeliveries: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
+    ListVerificationEvents: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     MakePrivate: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     Providers: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     PublishProviderVersion: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     RequestPublicListing: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    RevokeCredential: {
+    RetryVerificationCallback: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    SubmitProviderVersionForReview: {
+    SetOrgKeypair: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    TransferProvider: {
+    SubmitProviderVersionForReview: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    UpdateMe: {
+    TransferProvider: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     UpdateOrg: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     UpdateOrgBilling: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     UpdateProvider: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
     UpdateProviderVersion: {
         description: string;
-        inputSchema: import("zod").ZodTypeAny;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
 };
 export type McpToolName = keyof typeof MCP_TOOLS;