@thinkrun/mcp 0.3.8 → 0.3.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +81 -0
- package/dist/bin/thinkrun-mcp.js +26 -2
- package/dist/bin/thinkrun-mcp.js.map +1 -1
- package/dist/shared/audit-state.d.ts +32 -0
- package/dist/shared/audit-state.js +99 -0
- package/dist/shared/local-audit-sync.d.ts +12 -0
- package/dist/shared/local-audit-sync.js +38 -0
- package/dist/shared/sensitive-result-redaction.d.ts +1 -0
- package/dist/shared/sensitive-result-redaction.js +112 -0
- package/dist/src/client.d.ts +107 -0
- package/dist/src/client.d.ts.map +1 -1
- package/dist/src/cloud-client.d.ts +11 -1
- package/dist/src/cloud-client.d.ts.map +1 -1
- package/dist/src/cloud-client.js +73 -23
- package/dist/src/cloud-client.js.map +1 -1
- package/dist/src/extension-proxy-client.d.ts +24 -0
- package/dist/src/extension-proxy-client.d.ts.map +1 -1
- package/dist/src/extension-proxy-client.js +32 -0
- package/dist/src/extension-proxy-client.js.map +1 -1
- package/dist/src/local-client.d.ts +24 -0
- package/dist/src/local-client.d.ts.map +1 -1
- package/dist/src/local-client.js +32 -0
- package/dist/src/local-client.js.map +1 -1
- package/dist/src/server.d.ts +16 -0
- package/dist/src/server.d.ts.map +1 -1
- package/dist/src/server.js +141 -2
- package/dist/src/server.js.map +1 -1
- package/package.json +7 -9
package/README.md
CHANGED
|
@@ -230,6 +230,87 @@ MCP Server ──HTTP──> Native Host ──stdio──> Chrome Extension
|
|
|
230
230
|
| `task_execute` | Execute a task plan | cloud |
|
|
231
231
|
| `task_status` | Check task execution status | cloud |
|
|
232
232
|
|
|
233
|
+
## Hosted Remote Browser Control
|
|
234
|
+
|
|
235
|
+
ThinkRun also supports a hosted remote-agent flow for agents that are not running on the same machine as the browser.
|
|
236
|
+
|
|
237
|
+
This flow does not create a second browser-control surface. Hosted MCP remote browser access still goes through the same ThinkRun backend session APIs and `ext-*` relay path used by the existing browser control layer.
|
|
238
|
+
|
|
239
|
+
### Remote-agent control tools
|
|
240
|
+
|
|
241
|
+
| Tool | Purpose |
|
|
242
|
+
|------|---------|
|
|
243
|
+
| `agent_identity` | Return the remote agent identity and link state |
|
|
244
|
+
| `browser_request_control` | Request a short-lived user-approved browser control grant |
|
|
245
|
+
| `browser_grant_status` | Poll request/grant status |
|
|
246
|
+
| `browser_release_control` | Cancel a pending request or revoke an active grant |
|
|
247
|
+
|
|
248
|
+
### V1 rules
|
|
249
|
+
|
|
250
|
+
- remote agents authenticate as themselves with remote-agent credentials, not with the user's ThinkRun API key
|
|
251
|
+
- the user must already know and link the agent before browser access can be granted
|
|
252
|
+
- approval requires a logged-in ThinkRun session plus a live extension-connected browser session
|
|
253
|
+
- mutating scopes still require extension confirmation before use
|
|
254
|
+
- every remote command is authorized against live backend grant state
|
|
255
|
+
- `evaluate` remains denied for remote agents in v1 even if requested
|
|
256
|
+
|
|
257
|
+
### Hermes / OpenClaw notes
|
|
258
|
+
|
|
259
|
+
For Hermes/OpenClaw-style agents running remotely:
|
|
260
|
+
|
|
261
|
+
1. register the agent and link it to the user account
|
|
262
|
+
2. call `browser_request_control`
|
|
263
|
+
3. wait for app approval and extension confirmation
|
|
264
|
+
4. use normal browser tools once the grant is active
|
|
265
|
+
5. release with `browser_release_control`
|
|
266
|
+
|
|
267
|
+
V1 usefulness is intentionally biased toward non-`evaluate` flows: `snapshot`, `screenshot`, `click`, `fill`, waits, tab tools, and artifact tools.
|
|
268
|
+
|
|
269
|
+
### Remote workflows without `evaluate`
|
|
270
|
+
|
|
271
|
+
Remote-agent workflows in v1 should assume `evaluate` is unavailable even if a requested scope mentions it.
|
|
272
|
+
|
|
273
|
+
Recommended pattern:
|
|
274
|
+
|
|
275
|
+
1. `browser_request_control`
|
|
276
|
+
2. `browser_grant_status`
|
|
277
|
+
3. `snapshot` to inspect page structure
|
|
278
|
+
4. `extract` for text, HTML, or attributes
|
|
279
|
+
5. `click` / `fill` / `type_text`
|
|
280
|
+
6. `wait_for_element` or `wait_for_text`
|
|
281
|
+
7. `screenshot` for visual confirmation
|
|
282
|
+
8. `browser_release_control`
|
|
283
|
+
|
|
284
|
+
Good first-fit remote tasks in v1:
|
|
285
|
+
|
|
286
|
+
- inspect a dashboard and read current status
|
|
287
|
+
- click a refresh button and wait for updated text
|
|
288
|
+
- fill and submit ordinary non-sensitive form fields
|
|
289
|
+
- switch tabs and capture screenshots or artifacts
|
|
290
|
+
|
|
291
|
+
Not part of the default v1 path:
|
|
292
|
+
|
|
293
|
+
- arbitrary script execution
|
|
294
|
+
- password-field automation
|
|
295
|
+
- auth or payment submission flows
|
|
296
|
+
- destructive account actions on sensitive surfaces
|
|
297
|
+
|
|
298
|
+
### Claude.ai compatibility
|
|
299
|
+
|
|
300
|
+
Claude-compatible hosted MCP clients can use the same request/grant/release contract, but v1 does not block release on unverified Claude.ai-specific connector or transport requirements outside the current ThinkRun MCP protocol surface.
|
|
301
|
+
|
|
302
|
+
If a Claude.ai integration has connector-specific auth or transport constraints, treat that as an integration concern rather than a reason to widen the remote browser authorization model.
|
|
303
|
+
|
|
304
|
+
### Safety summary
|
|
305
|
+
|
|
306
|
+
- no remote direct connection to the extension WebSocket
|
|
307
|
+
- no approval authority in email links
|
|
308
|
+
- no `evaluate` for remote agents in v1
|
|
309
|
+
- sensitive-domain and high-risk operation blocking
|
|
310
|
+
- audited request/grant/command lifecycle
|
|
311
|
+
|
|
312
|
+
See [docs/remote-browser-sharing.md](../../docs/remote-browser-sharing.md) for the user/admin model, operator runbook, and release checklist.
|
|
313
|
+
|
|
233
314
|
## Local Session Semantics
|
|
234
315
|
|
|
235
316
|
The new local lifecycle tools intentionally distinguish between **ownership-changing** operations and **focus-only** operations:
|
package/dist/bin/thinkrun-mcp.js
CHANGED
|
@@ -85,6 +85,14 @@ function parseArgs() {
|
|
|
85
85
|
args.sessionId = nextArg(argv, i, '--session-id');
|
|
86
86
|
i++;
|
|
87
87
|
break;
|
|
88
|
+
case '--remote-agent-id':
|
|
89
|
+
args.remoteAgentId = nextArg(argv, i, '--remote-agent-id');
|
|
90
|
+
i++;
|
|
91
|
+
break;
|
|
92
|
+
case '--remote-agent-secret':
|
|
93
|
+
args.remoteAgentSecret = nextArg(argv, i, '--remote-agent-secret');
|
|
94
|
+
i++;
|
|
95
|
+
break;
|
|
88
96
|
case '--help':
|
|
89
97
|
case '-h':
|
|
90
98
|
printHelp();
|
|
@@ -112,6 +120,8 @@ function parseArgs() {
|
|
|
112
120
|
}
|
|
113
121
|
}
|
|
114
122
|
args.sessionId = args.sessionId || process.env.SESSION_ID;
|
|
123
|
+
args.remoteAgentId = args.remoteAgentId || process.env.THINKRUN_REMOTE_AGENT_ID;
|
|
124
|
+
args.remoteAgentSecret = args.remoteAgentSecret || process.env.THINKRUN_REMOTE_AGENT_SECRET;
|
|
115
125
|
if (process.env.THINKRUN_LOCAL === 'true' && !args.mode) {
|
|
116
126
|
args.mode = 'local';
|
|
117
127
|
}
|
|
@@ -130,6 +140,8 @@ Options:
|
|
|
130
140
|
--base-url <url> Cloud API base URL (default: ${DEFAULT_CLOUD_URL})
|
|
131
141
|
--port <port> Native host port (overrides discovery file)
|
|
132
142
|
--session-id <id> Default session ID (enables session_use to switch default)
|
|
143
|
+
--remote-agent-id <id> Hosted remote-agent client id for cloud remote-browser mode
|
|
144
|
+
--remote-agent-secret <secret> Hosted remote-agent client secret for cloud remote-browser mode
|
|
133
145
|
-h, --help Show this help
|
|
134
146
|
-v, --version Show version
|
|
135
147
|
|
|
@@ -143,6 +155,8 @@ Environment Variables:
|
|
|
143
155
|
THINKRUN_BASE_URL Cloud API base URL
|
|
144
156
|
THINKRUN_BRIDGE_PORT Override native host port
|
|
145
157
|
THINKRUN_LOCAL Set to "true" to force local mode
|
|
158
|
+
THINKRUN_REMOTE_AGENT_ID Hosted remote-agent client id
|
|
159
|
+
THINKRUN_REMOTE_AGENT_SECRET Hosted remote-agent client secret
|
|
146
160
|
|
|
147
161
|
Modes:
|
|
148
162
|
cloud Connect to ThinkRun cloud API (requires API key)
|
|
@@ -206,7 +220,12 @@ async function createClient(args) {
|
|
|
206
220
|
process.exit(1);
|
|
207
221
|
}
|
|
208
222
|
console.error(`[thinkrun-mcp] Cloud mode → ${args.baseUrl}`);
|
|
209
|
-
return new CloudClient({
|
|
223
|
+
return new CloudClient({
|
|
224
|
+
baseUrl: args.baseUrl,
|
|
225
|
+
apiKey: args.apiKey,
|
|
226
|
+
remoteAgentId: args.remoteAgentId,
|
|
227
|
+
remoteAgentSecret: args.remoteAgentSecret,
|
|
228
|
+
});
|
|
210
229
|
}
|
|
211
230
|
// Auto-detect: try native host first
|
|
212
231
|
console.error('[thinkrun-mcp] Auto-detecting mode...');
|
|
@@ -217,7 +236,12 @@ async function createClient(args) {
|
|
|
217
236
|
}
|
|
218
237
|
if (args.apiKey) {
|
|
219
238
|
console.error(`[thinkrun-mcp] No native host, using cloud → ${args.baseUrl}`);
|
|
220
|
-
return new CloudClient({
|
|
239
|
+
return new CloudClient({
|
|
240
|
+
baseUrl: args.baseUrl,
|
|
241
|
+
apiKey: args.apiKey,
|
|
242
|
+
remoteAgentId: args.remoteAgentId,
|
|
243
|
+
remoteAgentSecret: args.remoteAgentSecret,
|
|
244
|
+
});
|
|
221
245
|
}
|
|
222
246
|
console.error('[thinkrun-mcp] Error: Native host not running and no API key configured.');
|
|
223
247
|
console.error(' Open Chrome, Helium, or another supported Chromium browser with the ThinkRun extension for local mode, or set THINKRUN_API_KEY for cloud mode.');
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"thinkrun-mcp.js","sourceRoot":"","sources":["../../bin/thinkrun-mcp.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAsC,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AACpD,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,yDAAyD;AACzD,SAAS,kBAAkB;IACzB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CACnB,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,EACrD,cAAc,EACd,MAAM,CACP,CAAC;QACF,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAClE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,KAAK;gBAAE,OAAO,IAAI,CAAC;QAC7D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,aAAa;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;
|
|
1
|
+
{"version":3,"file":"thinkrun-mcp.js","sourceRoot":"","sources":["../../bin/thinkrun-mcp.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
export interface TabAuditState {
|
|
2
|
+
tabId: string;
|
|
3
|
+
enabled: boolean;
|
|
4
|
+
updatedAt: string;
|
|
5
|
+
explicit?: boolean;
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
export type AuditStateSource = 'flag' | 'env' | 'stored' | 'default';
|
|
9
|
+
|
|
10
|
+
export interface ResolveTabAuditStateArgs {
|
|
11
|
+
tabId?: string | number;
|
|
12
|
+
flagEnabled?: boolean;
|
|
13
|
+
envValue?: string | undefined;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
export interface ResolvedTabAuditState {
|
|
17
|
+
enabled: boolean;
|
|
18
|
+
source: AuditStateSource;
|
|
19
|
+
stored?: TabAuditState | undefined;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export function getTabAuditStateFilePath(tabId: string | number): string;
|
|
23
|
+
export function parseAuditPreference(value: string | undefined): boolean | undefined;
|
|
24
|
+
export function readTabAuditState(tabId: string | number): TabAuditState | undefined;
|
|
25
|
+
export function writeTabAuditState(
|
|
26
|
+
tabId: string | number,
|
|
27
|
+
enabled: boolean,
|
|
28
|
+
updatedAt?: string,
|
|
29
|
+
options?: { explicit?: boolean },
|
|
30
|
+
): TabAuditState;
|
|
31
|
+
export function clearTabAuditState(tabId: string | number): void;
|
|
32
|
+
export function resolveTabAuditState(args?: ResolveTabAuditStateArgs): ResolvedTabAuditState;
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
|
|
2
|
+
import { homedir } from 'node:os';
|
|
3
|
+
import { join } from 'node:path';
|
|
4
|
+
|
|
5
|
+
function getLockDir() {
|
|
6
|
+
const configuredDir = process.env.THINKRUN_LOCK_DIR ?? process.env.THINKBROWSE_LOCK_DIR;
|
|
7
|
+
if (configuredDir) return configuredDir;
|
|
8
|
+
|
|
9
|
+
const thinkrunDir = join(homedir(), '.thinkrun');
|
|
10
|
+
const thinkbrowseDir = join(homedir(), '.thinkbrowse');
|
|
11
|
+
if (!existsSync(thinkrunDir) && existsSync(thinkbrowseDir)) {
|
|
12
|
+
return thinkbrowseDir;
|
|
13
|
+
}
|
|
14
|
+
return thinkrunDir;
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
function sanitizeTabId(tabId) {
|
|
18
|
+
return String(tabId).replace(/[^a-zA-Z0-9_-]/g, '_') || 'unknown';
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export function getTabAuditStateFilePath(tabId) {
|
|
22
|
+
return join(getLockDir(), 'audit-states', `${sanitizeTabId(tabId)}.json`);
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
export function parseAuditPreference(value) {
|
|
26
|
+
if (typeof value !== 'string') return undefined;
|
|
27
|
+
const normalized = value.trim().toLowerCase();
|
|
28
|
+
if (!normalized) return undefined;
|
|
29
|
+
if (['1', 'true', 'on', 'yes'].includes(normalized)) return true;
|
|
30
|
+
if (['0', 'false', 'off', 'no'].includes(normalized)) return false;
|
|
31
|
+
return undefined;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export function readTabAuditState(tabId) {
|
|
35
|
+
try {
|
|
36
|
+
const filePath = getTabAuditStateFilePath(tabId);
|
|
37
|
+
if (!existsSync(filePath)) return undefined;
|
|
38
|
+
const data = JSON.parse(readFileSync(filePath, 'utf-8'));
|
|
39
|
+
if (
|
|
40
|
+
!data
|
|
41
|
+
|| typeof data !== 'object'
|
|
42
|
+
|| typeof data.enabled !== 'boolean'
|
|
43
|
+
|| typeof data.updatedAt !== 'string'
|
|
44
|
+
) {
|
|
45
|
+
return undefined;
|
|
46
|
+
}
|
|
47
|
+
return {
|
|
48
|
+
tabId: String(tabId),
|
|
49
|
+
enabled: data.enabled,
|
|
50
|
+
updatedAt: data.updatedAt,
|
|
51
|
+
explicit: data.explicit === true,
|
|
52
|
+
};
|
|
53
|
+
} catch {
|
|
54
|
+
return undefined;
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export function writeTabAuditState(tabId, enabled, updatedAt = new Date().toISOString(), options = {}) {
|
|
59
|
+
const state = {
|
|
60
|
+
tabId: String(tabId),
|
|
61
|
+
enabled: Boolean(enabled),
|
|
62
|
+
updatedAt,
|
|
63
|
+
...(options.explicit === true ? { explicit: true } : {}),
|
|
64
|
+
};
|
|
65
|
+
const filePath = getTabAuditStateFilePath(tabId);
|
|
66
|
+
mkdirSync(join(getLockDir(), 'audit-states'), { recursive: true });
|
|
67
|
+
writeFileSync(filePath, JSON.stringify(state, null, 2), 'utf-8');
|
|
68
|
+
return state;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
export function clearTabAuditState(tabId) {
|
|
72
|
+
try {
|
|
73
|
+
rmSync(getTabAuditStateFilePath(tabId), { force: true });
|
|
74
|
+
} catch {
|
|
75
|
+
// best-effort cleanup
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
export function resolveTabAuditState({
|
|
80
|
+
tabId,
|
|
81
|
+
flagEnabled = false,
|
|
82
|
+
envValue = process.env.THINKRUN_AUDIT,
|
|
83
|
+
} = {}) {
|
|
84
|
+
const stored = tabId !== undefined && tabId !== null ? readTabAuditState(tabId) : undefined;
|
|
85
|
+
if (flagEnabled) {
|
|
86
|
+
return { enabled: true, source: 'flag', stored };
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
const envEnabled = parseAuditPreference(envValue);
|
|
90
|
+
if (envEnabled !== undefined) {
|
|
91
|
+
return { enabled: envEnabled, source: 'env', stored };
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
if (stored) {
|
|
95
|
+
return { enabled: stored.enabled, source: 'stored', stored };
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
return { enabled: false, source: 'default', stored };
|
|
99
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export interface PatchLocalAuditStateArgs {
|
|
2
|
+
sessionId: string;
|
|
3
|
+
enabled: boolean;
|
|
4
|
+
updatedAt?: string | undefined;
|
|
5
|
+
apiKey: string;
|
|
6
|
+
apiUrl?: string | undefined;
|
|
7
|
+
fetchFn?: typeof fetch | undefined;
|
|
8
|
+
timeoutMs?: number | undefined;
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
export function unrefAbortSignal(ms: number): AbortSignal;
|
|
12
|
+
export function patchLocalAuditState(args: PatchLocalAuditStateArgs): Promise<boolean>;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
export function unrefAbortSignal(ms) {
|
|
2
|
+
const controller = new AbortController();
|
|
3
|
+
const timer = setTimeout(() => controller.abort(), ms);
|
|
4
|
+
if (typeof timer?.unref === 'function') timer.unref();
|
|
5
|
+
return controller.signal;
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
export function patchLocalAuditState({
|
|
9
|
+
sessionId,
|
|
10
|
+
enabled,
|
|
11
|
+
updatedAt,
|
|
12
|
+
apiKey,
|
|
13
|
+
apiUrl = 'https://api.thinkrun.ai',
|
|
14
|
+
fetchFn = globalThis.fetch,
|
|
15
|
+
timeoutMs = 10_000,
|
|
16
|
+
} = {}) {
|
|
17
|
+
if (typeof sessionId !== 'string' || sessionId.length === 0) return Promise.resolve(false);
|
|
18
|
+
if (typeof apiKey !== 'string' || apiKey.length === 0) return Promise.resolve(false);
|
|
19
|
+
if (typeof apiUrl !== 'string' || !apiUrl.startsWith('https://')) return Promise.resolve(false);
|
|
20
|
+
|
|
21
|
+
try {
|
|
22
|
+
return fetchFn(`${apiUrl}/api/sessions/${sessionId}/local-audit`, {
|
|
23
|
+
method: 'PATCH',
|
|
24
|
+
headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
|
|
25
|
+
body: JSON.stringify({
|
|
26
|
+
enabled: Boolean(enabled),
|
|
27
|
+
...(typeof updatedAt === 'string' ? { updatedAt } : {}),
|
|
28
|
+
}),
|
|
29
|
+
signal: unrefAbortSignal(timeoutMs),
|
|
30
|
+
}).then((res) => {
|
|
31
|
+
const delivered = res.ok;
|
|
32
|
+
res.body?.cancel?.().catch(() => {});
|
|
33
|
+
return delivered;
|
|
34
|
+
}).catch(() => false);
|
|
35
|
+
} catch {
|
|
36
|
+
return Promise.resolve(false);
|
|
37
|
+
}
|
|
38
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function redactSensitiveResult(value: unknown): unknown;
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
const SENSITIVE_RESULT_PATTERNS = [
|
|
2
|
+
{
|
|
3
|
+
key: /^pass(?:word)?$/i,
|
|
4
|
+
json: /("pass(?:word)?"\s*:\s*)"[^"]*"/gi,
|
|
5
|
+
quotedDouble: /(pass(?:word)?\s*[=:]\s*)"[^"]*"/gi,
|
|
6
|
+
quotedSingle: /(pass(?:word)?\s*[=:]\s*)'[^']*'/gi,
|
|
7
|
+
plain: /(pass(?:word)?\s*[=:]\s*)(?!["'])([^,;&\n]+?)(?=(?:\s+[a-z0-9_-]+\s*[=:])|[,;&]|$)/gi,
|
|
8
|
+
},
|
|
9
|
+
{
|
|
10
|
+
key: /^[a-z0-9_-]*token$/i,
|
|
11
|
+
json: /("[a-z0-9_-]*token"\s*:\s*)"[^"]*"/gi,
|
|
12
|
+
quotedDouble: /([a-z0-9_-]*token\s*[=:]\s*)"[^"]*"/gi,
|
|
13
|
+
quotedSingle: /([a-z0-9_-]*token\s*[=:]\s*)'[^']*'/gi,
|
|
14
|
+
plain: /([a-z0-9_-]*token\s*[=:]\s*)(?!["'])([^,;&\n]+?)(?=(?:\s+[a-z0-9_-]+\s*[=:])|[,;&]|$)/gi,
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
key: /^[a-z0-9_-]*secret$/i,
|
|
18
|
+
json: /("[a-z0-9_-]*secret"\s*:\s*)"[^"]*"/gi,
|
|
19
|
+
quotedDouble: /([a-z0-9_-]*secret\s*[=:]\s*)"[^"]*"/gi,
|
|
20
|
+
quotedSingle: /([a-z0-9_-]*secret\s*[=:]\s*)'[^']*'/gi,
|
|
21
|
+
plain: /([a-z0-9_-]*secret\s*[=:]\s*)(?!["'])([^,;&\n]+?)(?=(?:\s+[a-z0-9_-]+\s*[=:])|[,;&]|$)/gi,
|
|
22
|
+
},
|
|
23
|
+
{
|
|
24
|
+
key: /^[a-z0-9_-]*credential$/i,
|
|
25
|
+
json: /("[a-z0-9_-]*credential"\s*:\s*)"[^"]*"/gi,
|
|
26
|
+
quotedDouble: /([a-z0-9_-]*credential\s*[=:]\s*)"[^"]*"/gi,
|
|
27
|
+
quotedSingle: /([a-z0-9_-]*credential\s*[=:]\s*)'[^']*'/gi,
|
|
28
|
+
plain: /([a-z0-9_-]*credential\s*[=:]\s*)(?!["'])([^,;&\n]+?)(?=(?:\s+[a-z0-9_-]+\s*[=:])|[,;&]|$)/gi,
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
key: /^[a-z0-9_-]*api[-_]?key$/i,
|
|
32
|
+
json: /("[a-z0-9_-]*api[-_]?key"\s*:\s*)"[^"]*"/gi,
|
|
33
|
+
quotedDouble: /([a-z0-9_-]*api[-_]?key\s*[=:]\s*)"[^"]*"/gi,
|
|
34
|
+
quotedSingle: /([a-z0-9_-]*api[-_]?key\s*[=:]\s*)'[^']*'/gi,
|
|
35
|
+
plain: /([a-z0-9_-]*api[-_]?key\s*[=:]\s*)(?!["'])([^,;&\n]+?)(?=(?:\s+[a-z0-9_-]+\s*[=:])|[,;&]|$)/gi,
|
|
36
|
+
},
|
|
37
|
+
{
|
|
38
|
+
key: /^auth(?:orization)?$/i,
|
|
39
|
+
json: /("auth(?:orization)?"\s*:\s*)"[^"]*"/gi,
|
|
40
|
+
quotedDouble: /(auth(?:orization)?\s*[=:]\s*)"[^"]*"/gi,
|
|
41
|
+
quotedSingle: /(auth(?:orization)?\s*[=:]\s*)'[^']*'/gi,
|
|
42
|
+
plain: /(auth(?:orization)?\s*[=:]\s*)(?!["'])([^,;&\n]+?)(?=(?:\s+[a-z0-9_-]+\s*[=:])|[,;&]|$)/gi,
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
key: /^set-cookie$/i,
|
|
46
|
+
json: /("set-cookie"\s*:\s*)"[^"]*"/gi,
|
|
47
|
+
quotedDouble: /(set-cookie\s*[=:]\s*)"[^"]*"/gi,
|
|
48
|
+
quotedSingle: /(set-cookie\s*[=:]\s*)'[^']*'/gi,
|
|
49
|
+
plain: /(set-cookie\s*[=:]\s*)(?!["'])([^,;&\n]+?)(?=(?:\s+[a-z0-9_-]+\s*[=:])|[,;&]|$)/gi,
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
key: /^cookie$/i,
|
|
53
|
+
json: /("cookie"\s*:\s*)"[^"]*"/gi,
|
|
54
|
+
quotedDouble: /(cookie\s*[=:]\s*)"[^"]*"/gi,
|
|
55
|
+
quotedSingle: /(cookie\s*[=:]\s*)'[^']*'/gi,
|
|
56
|
+
plain: /(cookie\s*[=:]\s*)(?!["'])([^,;&\n]+?)(?=(?:\s+[a-z0-9_-]+\s*[=:])|[,;&]|$)/gi,
|
|
57
|
+
},
|
|
58
|
+
];
|
|
59
|
+
|
|
60
|
+
function isSensitiveResultKey(key) {
|
|
61
|
+
return SENSITIVE_RESULT_PATTERNS.some((pattern) => pattern.key.test(key));
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function isPlainObject(value) {
|
|
65
|
+
if (!value || typeof value !== 'object') return false;
|
|
66
|
+
const prototype = Object.getPrototypeOf(value);
|
|
67
|
+
return prototype === Object.prototype || prototype === null;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export function redactSensitiveResult(value) {
|
|
71
|
+
if (typeof value === 'string') {
|
|
72
|
+
let redacted = value;
|
|
73
|
+
for (const pattern of SENSITIVE_RESULT_PATTERNS) {
|
|
74
|
+
redacted = redacted
|
|
75
|
+
.replace(pattern.json, '$1"[REDACTED]"')
|
|
76
|
+
.replace(pattern.quotedDouble, '$1"[REDACTED]"')
|
|
77
|
+
.replace(pattern.quotedSingle, "$1'[REDACTED]'")
|
|
78
|
+
.replace(pattern.plain, '$1[REDACTED]');
|
|
79
|
+
}
|
|
80
|
+
return redacted;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
if (Array.isArray(value)) {
|
|
84
|
+
return value.map((entry) => redactSensitiveResult(entry));
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
if (isPlainObject(value)) {
|
|
88
|
+
const hasSensitiveHeaderName = ['name', 'key', 'header'].some((field) => (
|
|
89
|
+
typeof value[field] === 'string' && isSensitiveResultKey(value[field])
|
|
90
|
+
));
|
|
91
|
+
return Object.fromEntries(
|
|
92
|
+
Object.entries(value).map(([key, entry]) => {
|
|
93
|
+
const lowerKey = key.toLowerCase();
|
|
94
|
+
const redactByContext = hasSensitiveHeaderName && ['value', 'text', 'content'].includes(lowerKey);
|
|
95
|
+
return [
|
|
96
|
+
key,
|
|
97
|
+
isSensitiveResultKey(key) || redactByContext ? '[REDACTED]' : redactSensitiveResult(entry),
|
|
98
|
+
];
|
|
99
|
+
}),
|
|
100
|
+
);
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
if (value && typeof value === 'object' && typeof value.toJSON === 'function') {
|
|
104
|
+
try {
|
|
105
|
+
return redactSensitiveResult(value.toJSON());
|
|
106
|
+
} catch {
|
|
107
|
+
return value;
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
return value;
|
|
112
|
+
}
|
package/dist/src/client.d.ts
CHANGED
|
@@ -102,6 +102,10 @@ export interface ThinkRunClient {
|
|
|
102
102
|
bridgeTimeoutMs?: number;
|
|
103
103
|
}): Promise<LocalDiagnosticsResult>;
|
|
104
104
|
resetLocalConnection(): Promise<LocalResetConnectionResult>;
|
|
105
|
+
getRemoteAgentIdentity(): Promise<RemoteAgentIdentityResult>;
|
|
106
|
+
requestRemoteBrowserControl(params: RemoteBrowserControlRequestParams): Promise<RemoteBrowserControlRequestResult>;
|
|
107
|
+
getRemoteBrowserGrantStatus(requestId: string): Promise<RemoteBrowserGrantStatusResult>;
|
|
108
|
+
releaseRemoteBrowserControl(params: RemoteBrowserReleaseParams): Promise<RemoteBrowserReleaseResult>;
|
|
105
109
|
/**
|
|
106
110
|
* Stateless page cache — POST /api/cache/* on mech-browser-service (no session).
|
|
107
111
|
* Local bridge clients may require THINKRUN_BASE_URL + THINKRUN_API_KEY.
|
|
@@ -230,6 +234,109 @@ export interface LocalActionRunParams {
|
|
|
230
234
|
instruction: string;
|
|
231
235
|
maxIterations?: number;
|
|
232
236
|
}
|
|
237
|
+
export interface RemoteBrowserControlRequestParams {
|
|
238
|
+
requestedScopes: Array<'browser:observe' | 'browser:screenshot' | 'browser:act' | 'browser:navigate' | 'browser:tabs' | 'browser:recording'>;
|
|
239
|
+
requestedDurationMinutes?: number;
|
|
240
|
+
reason?: string;
|
|
241
|
+
targetHint?: string;
|
|
242
|
+
sessionId?: string;
|
|
243
|
+
tabId?: string | number;
|
|
244
|
+
}
|
|
245
|
+
export interface RemoteAgentIdentityResult {
|
|
246
|
+
success: boolean;
|
|
247
|
+
data?: {
|
|
248
|
+
agent: {
|
|
249
|
+
agentId: string;
|
|
250
|
+
displayName?: string;
|
|
251
|
+
publisherName?: string;
|
|
252
|
+
verificationStatus?: 'unverified' | 'verified';
|
|
253
|
+
authType: 'client_credentials';
|
|
254
|
+
status: 'pending' | 'active' | 'suspended' | 'revoked';
|
|
255
|
+
userId?: string;
|
|
256
|
+
createdAt?: string;
|
|
257
|
+
updatedAt?: string;
|
|
258
|
+
lastSeenAt?: string;
|
|
259
|
+
};
|
|
260
|
+
link?: {
|
|
261
|
+
userId: string;
|
|
262
|
+
agentId: string;
|
|
263
|
+
status: 'active' | 'revoked' | 'suspended' | 'pending';
|
|
264
|
+
defaultScopes?: string[];
|
|
265
|
+
approvedAt?: string;
|
|
266
|
+
revokedAt?: string;
|
|
267
|
+
createdAt?: string;
|
|
268
|
+
updatedAt?: string;
|
|
269
|
+
} | null;
|
|
270
|
+
};
|
|
271
|
+
error?: string;
|
|
272
|
+
code?: string;
|
|
273
|
+
hint?: string;
|
|
274
|
+
}
|
|
275
|
+
export interface RemoteBrowserControlRequestResult {
|
|
276
|
+
success: boolean;
|
|
277
|
+
data?: {
|
|
278
|
+
requestId: string;
|
|
279
|
+
userId: string;
|
|
280
|
+
agentId: string;
|
|
281
|
+
status: 'pending' | 'approved' | 'denied' | 'expired' | 'cancelled';
|
|
282
|
+
requestedScopes: string[];
|
|
283
|
+
requestedDurationMinutes: number;
|
|
284
|
+
reason?: string;
|
|
285
|
+
targetHint?: string;
|
|
286
|
+
sessionId?: string;
|
|
287
|
+
tabId?: string | number;
|
|
288
|
+
createdAt: string;
|
|
289
|
+
expiresAt?: string;
|
|
290
|
+
verificationUrl?: string;
|
|
291
|
+
verificationCode?: string;
|
|
292
|
+
requesterNotificationChannel?: 'poll_status';
|
|
293
|
+
resolutionCode?: 'REQUEST_DENIED_BY_USER';
|
|
294
|
+
};
|
|
295
|
+
error?: string;
|
|
296
|
+
code?: string;
|
|
297
|
+
hint?: string;
|
|
298
|
+
}
|
|
299
|
+
export interface RemoteBrowserGrantStatusResult {
|
|
300
|
+
success: boolean;
|
|
301
|
+
data?: {
|
|
302
|
+
requestId: string;
|
|
303
|
+
status: 'pending' | 'approved' | 'denied' | 'expired' | 'cancelled';
|
|
304
|
+
grantId?: string;
|
|
305
|
+
sessionId?: string;
|
|
306
|
+
tabId?: string | number;
|
|
307
|
+
scopes?: string[];
|
|
308
|
+
approvedAt?: string;
|
|
309
|
+
deniedAt?: string;
|
|
310
|
+
expiresAt?: string;
|
|
311
|
+
grantStatus?: 'active' | 'revoked' | 'paused' | 'expired';
|
|
312
|
+
grantExpiresAt?: string;
|
|
313
|
+
requesterNotificationChannel?: 'poll_status';
|
|
314
|
+
resolutionCode?: 'REQUEST_DENIED_BY_USER' | 'REQUEST_EXPIRED' | 'REQUEST_CANCELLED' | 'GRANT_REVOKED';
|
|
315
|
+
resolutionUpdatedAt?: string;
|
|
316
|
+
};
|
|
317
|
+
error?: string;
|
|
318
|
+
code?: string;
|
|
319
|
+
hint?: string;
|
|
320
|
+
}
|
|
321
|
+
export interface RemoteBrowserReleaseParams {
|
|
322
|
+
requestId?: string;
|
|
323
|
+
grantId?: string;
|
|
324
|
+
}
|
|
325
|
+
export interface RemoteBrowserReleaseResult {
|
|
326
|
+
success: boolean;
|
|
327
|
+
data?: {
|
|
328
|
+
requestId?: string;
|
|
329
|
+
grantId?: string;
|
|
330
|
+
status: 'cancelled' | 'revoked';
|
|
331
|
+
revokedAt?: string;
|
|
332
|
+
deniedAt?: string;
|
|
333
|
+
requesterNotificationChannel?: 'poll_status';
|
|
334
|
+
resolutionCode?: 'REQUEST_CANCELLED_BY_AGENT' | 'GRANT_REVOKED_BY_AGENT';
|
|
335
|
+
};
|
|
336
|
+
error?: string;
|
|
337
|
+
code?: string;
|
|
338
|
+
hint?: string;
|
|
339
|
+
}
|
|
233
340
|
export type LocalDiagnosticsContinuityState = 'unbound' | 'same_controller_read_resumable'
|
|
234
341
|
/** Reserved for future mutating-authority tracking parity with the CLI local adapter. */
|
|
235
342
|
| 'same_controller_read_write_resumable' | 'same_controller_missing_runtime_registration'
|