@reclaimprotocol/agent 0.1.15 → 0.1.18

package/lib/authoring/index.d.ts

@@ -1,4 +1,4 @@
 export type { AuthoringBackend, Draft, DraftStore, ProveOptions, SecretParams, } from './backend.ts';
 export { makeDraftStore } from './backend.ts';
 export { authoringTools } from './tools.ts';
-export { defineTool, extendTool, type RegisteredTool, type ToolDefinition, } from '../tools/registry.ts';
+export { defineTool, errorAsToolText, extendTool, type RegisteredTool, type ToolDefinition, } from '../tools/registry.ts';

package/lib/authoring/index.js

@@ -3,4 +3,4 @@ export { authoringTools } from "./tools.js";
 // The shared tool primitive — re-exported so consumers (the cloud loop) get the
 // RegisteredTool type/`defineTool`/`extendTool` without importing the MCP
 // subsystem.
-export { defineTool, extendTool, } from "../tools/registry.js";
+export { defineTool, errorAsToolText, extendTool, } from "../tools/registry.js";

package/lib/authoring/util.js

@@ -1,6 +1,9 @@
 /** Build an `object` JSON Schema for a tool input — a small literal shortener,
  *  not a tool abstraction. */
 export function objectSchema(properties, required) {
+    // `properties` is an untyped Record here (this is a literal shortener, not a
+    // schema validator), so it doesn't structurally match ObjectSchema's strict
+    // per-property schema type — assert the shape.
     return {
         type: 'object',
         properties,

package/lib/config/store.d.ts

@@ -7,6 +7,10 @@ export interface ReclaimAgentConfig {
 /**
  * The single on-disk document at `~/.reclaim/config.json`. Each top-level
  * key is an independent section owned by a different subsystem:
+ *   - `mode`          — persisted backend preference (old-devtools vs builder),
+ *                       set via the `set_devtools_mode` tool. Applied at server
+ *                       start; an explicit `USE_OLD_DEVTOOLS` env var overrides
+ *                       it (see `resolveOldMode` in consts.ts).
  *   - `browser_agent` — Chrome attach mode/port (the agent tools)
  *   - `session`       — the auth bearer token (authenticate)
  *   - `old_devtools`  — externally-supplied identity for OLD-devtools mode
@@ -21,10 +25,13 @@ export interface ReclaimAgentConfig {
  */
 export interface ReclaimConfig {
     version: 1;
+    mode?: DevtoolsMode;
     browser_agent?: ReclaimAgentConfig;
     session?: CachedSession;
     old_devtools?: OldIdentity;
 }
+/** Which backend the MCP server targets. See `resolveOldMode` in consts.ts. */
+export type DevtoolsMode = 'old' | 'builder';
 /**
  * Read/write the unified Reclaim config document. The file holds the
  * (short-lived) session bearer token, so it is always locked to `0600` and

package/lib/consts.d.ts

@@ -36,6 +36,21 @@ export declare function reclaimHome(): string;
  * `USE_OLD_DEVTOOLS=false`; anything else keeps old mode on.
  */
 export declare function useOldDevtools(): boolean;
+/**
+ * Effective mode, layering the persisted preference under the env var:
+ * explicit `USE_OLD_DEVTOOLS` wins → persisted config `mode` → default (old).
+ * The persisted value comes from `~/.reclaim/config.json` (set via the
+ * `set_devtools_mode` tool); the caller reads it so this module needn't import
+ * `ConfigStore` (which would create an import cycle).
+ */
+export declare function resolveOldMode(persisted?: 'old' | 'builder'): boolean;
+/**
+ * Where the effective mode came from — the same precedence as
+ * `resolveOldMode`: explicit `USE_OLD_DEVTOOLS` env var → persisted config
+ * `mode` → default (old). Surfaced by the `get_devtools_mode` tool so the
+ * user can tell why the server is in the mode it reports.
+ */
+export declare function oldModeSource(persisted?: 'old' | 'builder'): 'env' | 'config' | 'default';
 /** `%LOCALAPPDATA%` on Windows, used to probe a per-user Chrome install. */
 export declare function localAppData(): string | undefined;
 /** Explicit Chrome/Edge/Chromium binary path override. */

package/lib/consts.js

@@ -56,6 +56,41 @@ export function reclaimHome() {
 export function useOldDevtools() {
     return (process.env.USE_OLD_DEVTOOLS ?? '').trim().toLowerCase() !== 'false';
 }
+/** True when `USE_OLD_DEVTOOLS` is set to a non-empty value (explicit). */
+function oldDevtoolsEnvSet() {
+    return (process.env.USE_OLD_DEVTOOLS ?? '').trim() !== '';
+}
+/**
+ * Effective mode, layering the persisted preference under the env var:
+ * explicit `USE_OLD_DEVTOOLS` wins → persisted config `mode` → default (old).
+ * The persisted value comes from `~/.reclaim/config.json` (set via the
+ * `set_devtools_mode` tool); the caller reads it so this module needn't import
+ * `ConfigStore` (which would create an import cycle).
+ */
+export function resolveOldMode(persisted) {
+    if (oldDevtoolsEnvSet()) {
+        return useOldDevtools();
+    }
+    if (persisted) {
+        return persisted === 'old';
+    }
+    return true;
+}
+/**
+ * Where the effective mode came from — the same precedence as
+ * `resolveOldMode`: explicit `USE_OLD_DEVTOOLS` env var → persisted config
+ * `mode` → default (old). Surfaced by the `get_devtools_mode` tool so the
+ * user can tell why the server is in the mode it reports.
+ */
+export function oldModeSource(persisted) {
+    if (oldDevtoolsEnvSet()) {
+        return 'env';
+    }
+    if (persisted) {
+        return 'config';
+    }
+    return 'default';
+}
 // ---------------------------------------------------------------------------
 // Chrome / CDP launcher.
 // ---------------------------------------------------------------------------

package/lib/index.js

@@ -1,5 +1,5 @@
 // Package entry — SDK re-exports + agent public API.
-// The CLI lives at ./cli.ts, the MCP server bin at ./mcp-bin.ts.
+// The MCP server bin lives at ./mcp-bin.ts.
 // SDK — re-export everything from @reclaimprotocol/client so consumers
 // only need one package for both the typed HTTP client and the agent tools.
 export * from '@reclaimprotocol/client';

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

@@ -23,10 +23,6 @@ export declare const MCP_TOOLS: {
         description: string;
         inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    CreateAttachSession: {
-        description: string;
-        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>>;
@@ -83,10 +79,6 @@ export declare const MCP_TOOLS: {
         description: string;
         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").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
@@ -103,10 +95,6 @@ export declare const MCP_TOOLS: {
         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").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
@@ -143,6 +131,10 @@ export declare const MCP_TOOLS: {
         description: string;
         inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
+    ListOrgTokens: {
+        description: string;
+        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>>;
@@ -179,6 +171,10 @@ export declare const MCP_TOOLS: {
         description: string;
         inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
+    RevokeOrgToken: {
+        description: string;
+        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+    };
     SetOrgKeypair: {
         description: string;
         inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
@@ -195,10 +191,6 @@ export declare const MCP_TOOLS: {
         description: string;
         inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
     };
-    UpdateOrgBilling: {
-        description: string;
-        inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
-    };
     UpdateProvider: {
         description: string;
         inputSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;