@reclaimprotocol/agent 0.1.15 → 0.1.18

package/src/config/store.ts

@@ -18,6 +18,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
@@ -32,11 +36,15 @@ 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/src/consts.ts

@@ -72,6 +72,50 @@ export function useOldDevtools(): boolean {
 	return (process.env.USE_OLD_DEVTOOLS ?? '').trim().toLowerCase() !== 'false'
 }
 
+/** True when `USE_OLD_DEVTOOLS` is set to a non-empty value (explicit). */
+function oldDevtoolsEnvSet(): boolean {
+	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?: 'old' | 'builder'): boolean {
+	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?: 'old' | 'builder',
+): 'env' | 'config' | 'default' {
+	if(oldDevtoolsEnvSet()) {
+		return 'env'
+	}
+
+	if(persisted) {
+		return 'config'
+	}
+
+	return 'default'
+}
+
 // ---------------------------------------------------------------------------
 // Chrome / CDP launcher.
 // ---------------------------------------------------------------------------

package/src/index.ts

@@ -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.