@reclaimprotocol/agent 0.1.15 → 0.1.17

package/src/authoring/util.ts

@@ -21,6 +21,9 @@ export function objectSchema(
 	properties: Record<string, unknown>,
 	required?: string[],
 ): JSONSchema.ObjectSchema {
+	// `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/src/cdp/launcher.ts

@@ -113,7 +113,7 @@ export function launchChrome(opts: LaunchOptions): ChildProcess {
 export async function waitForCdpReady(
 	port: number,
 	timeoutMs = 10_000,
-): Promise<void> {
+) {
 	const deadline = Date.now() + timeoutMs
 	while(Date.now() < deadline) {
 		try {

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,30 @@ 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
+}
+
 // ---------------------------------------------------------------------------
 // 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.