@reclaimprotocol/agent 0.1.15 → 0.1.18

package/src/provider/to-version.ts

@@ -4,10 +4,12 @@ import type {
 	ProviderVersionRef,
 } from '@reclaimprotocol/client/openapi'
 import type {
+	DraftResponseMatch,
 	HttpMethod,
+	OldUrlType,
 	ReclaimProvider,
-	ResponseMatch,
 	ResponseRedaction,
+	WebCredentials,
 } from './schema.ts'
 import { DYNAMIC_GEO, normalizeGeoLocation } from './schema.ts'
 
@@ -24,8 +26,15 @@ export interface DraftRequest {
 	body?: string
 	writeRedactionMode?: ReclaimProvider['writeRedactionMode']
 	additionalClientOptions?: ReclaimProvider['additionalClientOptions']
-	responseMatches?: ResponseMatch[]
+	responseMatches?: DraftResponseMatch[]
 	responseRedactions?: ResponseRedaction[]
+	/** How the verification client supplies cookies/auth on replay. Default
+	 *  `include` (both backends). */
+	credentials?: WebCredentials
+	/** Old-devtools `urlType` override. Ignored by THIS translator (the
+	 *  builder backend has no urlType) — read only by the old-devtools
+	 *  translator (`old/to-register.ts`). */
+	urlType?: OldUrlType
 }
 
 /** A request the page's injection script is allowed to fire, plus the
@@ -60,6 +69,16 @@ export interface CreateVersionOptions {
 	jsUserScripts?: string
 	/** Requests the injection script may fire, as `RequestSelectionTemplate`s. */
 	allowedJsRequests?: AllowedJsRequest[]
+	/** In-app interception options, mapped verbatim to
+	 *  `webSettings.clientOptions.inapp.interceptorOptions`. `interceptorType`
+	 *  is required by the backend whenever the object is present.
+	 *  `isDocumentRequestReplayEnabled` is the INVERSE of old-devtools'
+	 *  `disableRequestReplay` (default false). */
+	interceptorOptions?: {
+		interceptorType: 'HAWKEYE' | 'MSWJS' | 'CDP'
+		isDocumentRequestReplayEnabled?: boolean
+		interceptorSettings?: string
+	}
 }
 
 /**
@@ -139,14 +158,14 @@ export function providerToRequestSelection(
 	const responseMatches = (provider.responseMatches ?? []).map((match) => ({
 		type: match.type,
 		value: match.value,
-		isOptional: false,
+		isOptional: match.isOptional ?? false,
 	}))
 	const responseRedactions = provider.responseRedactions ?? []
 
 	return {
 		url: provider.url,
 		method: provider.method,
-		credentials: 'include',
+		credentials: provider.credentials ?? 'include',
 		...(provider.body ? { requestBodyTemplate: provider.body } : {}),
 		...(provider.writeRedactionMode
 			? { writeRedactionMode: provider.writeRedactionMode }
@@ -177,7 +196,9 @@ export function providerToCreateVersionRequest(
 	initialUrl: string,
 	opts: CreateVersionOptions = {},
 ): CreateProviderVersionRequest {
-	const { notes, version, jsUserScripts, allowedJsRequests } = opts
+	const {
+		notes, version, jsUserScripts, allowedJsRequests, interceptorOptions,
+	} = opts
 	const requiredContext = deriveRequiredContext(providers, {
 		allowedJsRequests,
 		jsUserScripts,
@@ -189,6 +210,10 @@ export function providerToCreateVersionRequest(
 		...providerToRequestSelection(req),
 		multiple: req.multiple ?? true,
 		required: req.required ?? true,
+		templateParamsMode: req.templateParamsMode ?? 'separate',
+		...(req.templateParams?.length
+			? { templateParams: req.templateParams }
+			: {}),
 	}))
 	const script = jsUserScripts?.trim()
 
@@ -202,7 +227,21 @@ export function providerToCreateVersionRequest(
 		// apply schema defaults to request bodies.
 		webSettings: {
 			geoLocation: pickGeoLocation(providers),
-			clientOptions: { portal: { useProxy: true } },
+			clientOptions: {
+				portal: { useProxy: true },
+				...(interceptorOptions
+					? {
+						inapp: {
+							interceptorOptions: {
+								// openapi `default: false` — the generated type
+								// requires the key even when the author omits it.
+								isDocumentRequestReplayEnabled: false,
+								...interceptorOptions,
+							},
+						},
+					}
+					: {}),
+			},
 			// Only set when non-empty; an empty string would store a no-op script.
 			...(script ? { jsUserScripts: script } : {}),
 		},

package/src/tools/registry.ts

@@ -11,6 +11,8 @@
  * glue (`registerToolList` onto an `McpServer`) stays in `mcp/server.ts`, which
  * re-exports this primitive for the MCP-side tool files.
  */
+import { type Boom, isBoom } from '@hapi/boom'
+import type { ProblemDetails } from '@reclaimprotocol/client'
 import type { JSONSchema } from 'zod/v4/core'
 import { toZod } from '../mcp/api/to-zod.ts'
 
@@ -51,6 +53,20 @@ export function defineTool<TArgs>(
 	}
 }
 
+/**
+ * Render a tool-handler error as the text every host shows the LLM.
+ * Boom errors carrying an RFC 9457 problem include its `detail`; anything
+ * else falls back to the plain message.
+ */
+export function errorAsToolText(err: unknown): string {
+	if(isBoom(err) && err.output?.statusCode) {
+		const detail = (err as Boom<ProblemDetails>).data?.detail
+		return detail ? `${err.message}: ${detail}` : err.message
+	}
+
+	return err instanceof Error ? err.message : String(err)
+}
+
 /**
  * Adapt a tool to a host by WIDENING its input schema — add properties, mark
  * some required, optionally override the description — without touching the
@@ -73,6 +89,9 @@ export function extendTool(
 		...(base.inputSchema.required ?? []),
 		...(extra.required ?? []),
 	]
+	// The merged `properties` spread carries the base's untyped property values,
+	// which don't structurally match ObjectSchema's strict per-property schema
+	// type — assert the merged shape.
 	const inputSchema = {
 		...base.inputSchema,
 		properties: {

package/src/cli/args.ts

@@ -1,20 +0,0 @@
-import { parseArgs as nodeParseArgs } from 'node:util'
-
-// Placeholder. Final shape decided once the backend openapi stabilises and
-// the CLI surface is fleshed out (see AGENTS.md → "CLI").
-export function parseCliArgs(argv: string[]) {
-	return nodeParseArgs({
-		args: argv,
-		options: {
-			'base-url': { type: 'string' },
-			token: { type: 'string' },
-			param: { type: 'string', multiple: true },
-			query: { type: 'string', multiple: true },
-			body: { type: 'string' },
-			help: { type: 'boolean', short: 'h' },
-			version: { type: 'boolean', short: 'v' },
-		},
-		allowPositionals: true,
-		strict: false,
-	})
-}

package/src/cli/commands.ts

@@ -1,27 +0,0 @@
-import { notImplemented } from '@hapi/boom'
-import { DESCRIPTION, NAME, VERSION } from '../pkg.ts'
-import { parseCliArgs } from './args.ts'
-
-// Entry point for the `reclaim` bin. Placeholder until backend openapi
-// finalises — `--version` and `--help` work; everything else throws.
-export async function run(argv: string[]) {
-	const parsed = parseCliArgs(argv)
-
-	if(parsed.values['version']) {
-		process.stdout.write(`${NAME} ${VERSION}\n`)
-		return
-	}
-
-	if(parsed.values['help']) {
-		process.stdout.write(
-			`${NAME} ${VERSION}\n${DESCRIPTION}\n\n` +
-			'Usage: reclaim call <OperationId> ' +
-			'[--param k=v] [--query k=v] [--body <json>]\n',
-		)
-		return
-	}
-
-	throw notImplemented(
-		'reclaim CLI: pending @reclaimprotocol/app spec finalisation',
-	)
-}

package/src/cli.ts

@@ -1,7 +0,0 @@
-import { run } from './cli/commands.ts'
-import { LOGGER } from './logger.ts'
-
-run(process.argv.slice(2)).catch((err) => {
-	LOGGER.error({ err }, 'cli failed')
-	process.exitCode = 1
-})