@astrasyncai/verification-gateway 1.0.0 → 2.0.0
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/dist/adapter-interface/interface.d.mts +71 -0
- package/dist/adapter-interface/interface.d.ts +71 -0
- package/dist/adapter-interface/interface.js +36 -0
- package/dist/adapter-interface/interface.js.map +1 -0
- package/dist/adapter-interface/interface.mjs +10 -0
- package/dist/adapter-interface/interface.mjs.map +1 -0
- package/dist/adapter-interface/purpose-mapping.d.mts +28 -0
- package/dist/adapter-interface/purpose-mapping.d.ts +28 -0
- package/dist/adapter-interface/purpose-mapping.js +117 -0
- package/dist/adapter-interface/purpose-mapping.js.map +1 -0
- package/dist/adapter-interface/purpose-mapping.mjs +89 -0
- package/dist/adapter-interface/purpose-mapping.mjs.map +1 -0
- package/dist/adapters/express.d.mts +2 -2
- package/dist/adapters/express.d.ts +2 -2
- package/dist/adapters/express.js +46 -9
- package/dist/adapters/express.js.map +1 -1
- package/dist/adapters/express.mjs +46 -9
- package/dist/adapters/express.mjs.map +1 -1
- package/dist/adapters/nextjs.d.mts +2 -2
- package/dist/adapters/nextjs.d.ts +2 -2
- package/dist/adapters/nextjs.js +19 -9
- package/dist/adapters/nextjs.js.map +1 -1
- package/dist/adapters/nextjs.mjs +19 -9
- package/dist/adapters/nextjs.mjs.map +1 -1
- package/dist/adapters/sdk.d.mts +2 -2
- package/dist/adapters/sdk.d.ts +2 -2
- package/dist/adapters/sdk.js +20 -4
- package/dist/adapters/sdk.js.map +1 -1
- package/dist/adapters/sdk.mjs +20 -4
- package/dist/adapters/sdk.mjs.map +1 -1
- package/dist/agent/index.d.mts +2 -0
- package/dist/agent/index.d.ts +2 -0
- package/dist/agent/index.js +354 -0
- package/dist/agent/index.js.map +1 -0
- package/dist/agent/index.mjs +323 -0
- package/dist/agent/index.mjs.map +1 -0
- package/dist/browser/browser-adapter.d.mts +106 -0
- package/dist/browser/browser-adapter.d.ts +106 -0
- package/dist/browser/browser-adapter.js +286 -0
- package/dist/browser/browser-adapter.js.map +1 -0
- package/dist/browser/browser-adapter.mjs +259 -0
- package/dist/browser/browser-adapter.mjs.map +1 -0
- package/dist/cli/index.d.mts +241 -0
- package/dist/cli/index.d.ts +241 -0
- package/dist/cli/index.js +3734 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/index.mjs +3688 -0
- package/dist/cli/index.mjs.map +1 -0
- package/dist/cursor/cursor-adapter.d.mts +92 -0
- package/dist/cursor/cursor-adapter.d.ts +92 -0
- package/dist/cursor/cursor-adapter.js +273 -0
- package/dist/cursor/cursor-adapter.js.map +1 -0
- package/dist/cursor/cursor-adapter.mjs +246 -0
- package/dist/cursor/cursor-adapter.mjs.map +1 -0
- package/dist/{express-DUDYpvNZ.d.mts → express-Cp4eg77F.d.mts} +1 -1
- package/dist/{express-BhD3mWsL.d.ts → express-DIEyq1Tz.d.ts} +1 -1
- package/dist/gateway/gateway.d.mts +70 -0
- package/dist/gateway/gateway.d.ts +70 -0
- package/dist/gateway/gateway.js +3726 -0
- package/dist/gateway/gateway.js.map +1 -0
- package/dist/gateway/gateway.mjs +3706 -0
- package/dist/gateway/gateway.mjs.map +1 -0
- package/dist/git-trigger/git-hooks.d.mts +69 -0
- package/dist/git-trigger/git-hooks.d.ts +69 -0
- package/dist/git-trigger/git-hooks.js +244 -0
- package/dist/git-trigger/git-hooks.js.map +1 -0
- package/dist/git-trigger/git-hooks.mjs +221 -0
- package/dist/git-trigger/git-hooks.mjs.map +1 -0
- package/dist/index-BhTbGU-o.d.mts +206 -0
- package/dist/index-Bhfxq9xI.d.ts +206 -0
- package/dist/index-CNkmHmpi.d.ts +89 -0
- package/dist/index-CoLebmwv.d.mts +89 -0
- package/dist/index.d.mts +8 -295
- package/dist/index.d.ts +8 -295
- package/dist/index.js +60 -21
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +60 -21
- package/dist/index.mjs.map +1 -1
- package/dist/local-evaluator/evaluator.d.mts +55 -0
- package/dist/local-evaluator/evaluator.d.ts +55 -0
- package/dist/local-evaluator/evaluator.js +272 -0
- package/dist/local-evaluator/evaluator.js.map +1 -0
- package/dist/local-evaluator/evaluator.mjs +244 -0
- package/dist/local-evaluator/evaluator.mjs.map +1 -0
- package/dist/{nextjs-C9FPOjSh.d.ts → nextjs-Cag7libc.d.ts} +1 -1
- package/dist/{nextjs-BtqyLSVQ.d.mts → nextjs-_C_FcJY5.d.mts} +1 -1
- package/dist/{sdk-BkVigGjF.d.ts → sdk-CMPDFUjo.d.ts} +3 -1
- package/dist/{sdk-xCbZgeZx.d.mts → sdk-DAJahT3p.d.mts} +3 -1
- package/dist/transport/index.d.mts +2 -0
- package/dist/transport/index.d.ts +2 -0
- package/dist/transport/index.js +211 -0
- package/dist/transport/index.js.map +1 -0
- package/dist/transport/index.mjs +176 -0
- package/dist/transport/index.mjs.map +1 -0
- package/dist/{types-CS6v75-d.d.mts → types-Bf8pML07.d.mts} +9 -1
- package/dist/{types-CS6v75-d.d.ts → types-Bf8pML07.d.ts} +9 -1
- package/dist/types-BvpGdsv1.d.mts +153 -0
- package/dist/types-Ce2mFJkO.d.ts +153 -0
- package/dist/ui/index.d.mts +1 -1
- package/dist/ui/index.d.ts +1 -1
- package/package.json +46 -1
|
@@ -0,0 +1,286 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __export = (target, all) => {
|
|
7
|
+
for (var name in all)
|
|
8
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
9
|
+
};
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
|
+
|
|
20
|
+
// src/browser/browser-adapter.ts
|
|
21
|
+
var browser_adapter_exports = {};
|
|
22
|
+
__export(browser_adapter_exports, {
|
|
23
|
+
BrowserAdapter: () => BrowserAdapter
|
|
24
|
+
});
|
|
25
|
+
module.exports = __toCommonJS(browser_adapter_exports);
|
|
26
|
+
|
|
27
|
+
// src/adapter-interface/interface.ts
|
|
28
|
+
var ADAPTER_INTERFACE_VERSION = 1;
|
|
29
|
+
|
|
30
|
+
// src/adapter-interface/purpose-mapping.ts
|
|
31
|
+
var TOOL_PURPOSE_MAP = {
|
|
32
|
+
// Shell
|
|
33
|
+
shell_exec: "shell.exec",
|
|
34
|
+
run_command: "shell.exec",
|
|
35
|
+
execute: "shell.exec",
|
|
36
|
+
terminal_exec: "shell.exec",
|
|
37
|
+
run_terminal_command: "shell.exec",
|
|
38
|
+
// File read
|
|
39
|
+
file_read: "file.read",
|
|
40
|
+
read_file: "file.read",
|
|
41
|
+
// File write
|
|
42
|
+
file_write: "file.write",
|
|
43
|
+
write_file: "file.write",
|
|
44
|
+
create_file: "file.write",
|
|
45
|
+
edit_file: "file.write",
|
|
46
|
+
// File delete
|
|
47
|
+
file_delete: "file.delete",
|
|
48
|
+
delete_file: "file.delete",
|
|
49
|
+
// Network
|
|
50
|
+
http_request: "network.request",
|
|
51
|
+
fetch: "network.request",
|
|
52
|
+
web_request: "network.request",
|
|
53
|
+
// Email
|
|
54
|
+
send_email: "email.send",
|
|
55
|
+
read_email: "email.read",
|
|
56
|
+
// Calendar
|
|
57
|
+
create_event: "calendar.create",
|
|
58
|
+
// Database
|
|
59
|
+
query_database: "database.query",
|
|
60
|
+
write_database: "database.write",
|
|
61
|
+
// Payment
|
|
62
|
+
payment_execute: "payment.execute"
|
|
63
|
+
};
|
|
64
|
+
function mapToolToPurpose(toolName) {
|
|
65
|
+
return TOOL_PURPOSE_MAP[toolName] || `tool.${toolName}`;
|
|
66
|
+
}
|
|
67
|
+
function extractTarget(toolName, args) {
|
|
68
|
+
const purpose = mapToolToPurpose(toolName);
|
|
69
|
+
if (purpose.startsWith("shell.")) {
|
|
70
|
+
return String(args.command || args.cmd || args.script || "");
|
|
71
|
+
}
|
|
72
|
+
if (purpose.startsWith("file.")) {
|
|
73
|
+
return String(args.path || args.file || args.filename || args.file_path || "");
|
|
74
|
+
}
|
|
75
|
+
if (purpose.startsWith("network.")) {
|
|
76
|
+
return String(args.url || args.endpoint || args.uri || "");
|
|
77
|
+
}
|
|
78
|
+
if (purpose.startsWith("email.")) {
|
|
79
|
+
return String(args.to || args.recipient || args.address || "");
|
|
80
|
+
}
|
|
81
|
+
if (purpose.startsWith("database.")) {
|
|
82
|
+
return String(args.query || args.table || "");
|
|
83
|
+
}
|
|
84
|
+
if (purpose.startsWith("payment.")) {
|
|
85
|
+
return String(args.description || args.merchant || args.amount || "");
|
|
86
|
+
}
|
|
87
|
+
if (args.command) return String(args.command);
|
|
88
|
+
if (args.path) return String(args.path);
|
|
89
|
+
if (args.url) return String(args.url);
|
|
90
|
+
for (const val of Object.values(args)) {
|
|
91
|
+
if (typeof val === "string" && val.length > 0) return val;
|
|
92
|
+
}
|
|
93
|
+
return toolName;
|
|
94
|
+
}
|
|
95
|
+
function extractNetworkDomains(target) {
|
|
96
|
+
try {
|
|
97
|
+
if (target.startsWith("http://") || target.startsWith("https://")) {
|
|
98
|
+
const url = new URL(target);
|
|
99
|
+
return [url.hostname];
|
|
100
|
+
}
|
|
101
|
+
} catch {
|
|
102
|
+
}
|
|
103
|
+
return void 0;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
// src/browser/browser-adapter.ts
|
|
107
|
+
function mapBrowserActionToPurpose(details) {
|
|
108
|
+
const url = details.url;
|
|
109
|
+
if (details.method === "POST") {
|
|
110
|
+
if (/mail|email|smtp/i.test(url)) {
|
|
111
|
+
return { toolName: "send_email", args: { url, to: url } };
|
|
112
|
+
}
|
|
113
|
+
if (/pay|checkout|stripe|payment/i.test(url)) {
|
|
114
|
+
return { toolName: "payment_execute", args: { url, description: url } };
|
|
115
|
+
}
|
|
116
|
+
return { toolName: "http_request", args: { url } };
|
|
117
|
+
}
|
|
118
|
+
if (details.type === "main_frame") {
|
|
119
|
+
return { toolName: "http_request", args: { url } };
|
|
120
|
+
}
|
|
121
|
+
return { toolName: "http_request", args: { url } };
|
|
122
|
+
}
|
|
123
|
+
var BrowserAdapter = class {
|
|
124
|
+
constructor(options) {
|
|
125
|
+
this.interfaceVersion = ADAPTER_INTERFACE_VERSION;
|
|
126
|
+
this.requestListener = null;
|
|
127
|
+
this.navigationListener = null;
|
|
128
|
+
this.messageListener = null;
|
|
129
|
+
this._isRunning = false;
|
|
130
|
+
this.options = {
|
|
131
|
+
urlPatterns: options?.urlPatterns ?? ["<all_urls>"],
|
|
132
|
+
requestTypes: options?.requestTypes ?? ["main_frame", "xmlhttprequest", "sub_frame"],
|
|
133
|
+
onApprovalRequired: options?.onApprovalRequired ?? (async () => false),
|
|
134
|
+
browserAPI: options?.browserAPI
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
get isRunning() {
|
|
138
|
+
return this._isRunning;
|
|
139
|
+
}
|
|
140
|
+
async initialize(config) {
|
|
141
|
+
this.gateway = config.gateway;
|
|
142
|
+
if (config.adapterOptions.browserAPI) {
|
|
143
|
+
this.browserAPI = config.adapterOptions.browserAPI;
|
|
144
|
+
} else if (this.options.browserAPI) {
|
|
145
|
+
this.browserAPI = this.options.browserAPI;
|
|
146
|
+
}
|
|
147
|
+
if (!this.browserAPI) {
|
|
148
|
+
throw new Error("BrowserAdapter requires browser extension API \u2014 pass via adapterOptions.browserAPI");
|
|
149
|
+
}
|
|
150
|
+
this.requestListener = (details) => {
|
|
151
|
+
return this.handleWebRequest(details);
|
|
152
|
+
};
|
|
153
|
+
this.browserAPI.webRequest.onBeforeRequest.addListener(
|
|
154
|
+
this.requestListener,
|
|
155
|
+
{
|
|
156
|
+
urls: this.options.urlPatterns,
|
|
157
|
+
types: this.options.requestTypes
|
|
158
|
+
},
|
|
159
|
+
["blocking"]
|
|
160
|
+
);
|
|
161
|
+
this.navigationListener = (details) => {
|
|
162
|
+
this.handleNavigation(details);
|
|
163
|
+
};
|
|
164
|
+
this.browserAPI.webNavigation.onBeforeNavigate.addListener(this.navigationListener);
|
|
165
|
+
this.messageListener = (message, _sender, sendResponse) => {
|
|
166
|
+
const msg = message;
|
|
167
|
+
if (msg?.type === "astrasync-evaluate") {
|
|
168
|
+
this.handleContentScriptAction(msg.action).then(sendResponse);
|
|
169
|
+
return true;
|
|
170
|
+
}
|
|
171
|
+
};
|
|
172
|
+
this.browserAPI.runtime.onMessage.addListener(this.messageListener);
|
|
173
|
+
this._isRunning = true;
|
|
174
|
+
}
|
|
175
|
+
async shutdown() {
|
|
176
|
+
if (this.requestListener) {
|
|
177
|
+
this.browserAPI.webRequest.onBeforeRequest.removeListener(this.requestListener);
|
|
178
|
+
this.requestListener = null;
|
|
179
|
+
}
|
|
180
|
+
if (this.navigationListener) {
|
|
181
|
+
this.browserAPI.webNavigation.onBeforeNavigate.removeListener(this.navigationListener);
|
|
182
|
+
this.navigationListener = null;
|
|
183
|
+
}
|
|
184
|
+
if (this.messageListener) {
|
|
185
|
+
this.browserAPI.runtime.onMessage.removeListener(this.messageListener);
|
|
186
|
+
this.messageListener = null;
|
|
187
|
+
}
|
|
188
|
+
this._isRunning = false;
|
|
189
|
+
}
|
|
190
|
+
async interceptAction(action) {
|
|
191
|
+
const raw = action.raw;
|
|
192
|
+
if (!raw) {
|
|
193
|
+
return { intercepted: false, skipReason: "No action data" };
|
|
194
|
+
}
|
|
195
|
+
const context = this.extractContext(action);
|
|
196
|
+
return { intercepted: true, context };
|
|
197
|
+
}
|
|
198
|
+
extractContext(action) {
|
|
199
|
+
const raw = action.raw;
|
|
200
|
+
const { toolName, args } = mapBrowserActionToPurpose(raw);
|
|
201
|
+
const purpose = mapToolToPurpose(toolName);
|
|
202
|
+
const target = extractTarget(toolName, args);
|
|
203
|
+
const networkAccess = extractNetworkDomains(target);
|
|
204
|
+
return {
|
|
205
|
+
purpose,
|
|
206
|
+
action: toolName,
|
|
207
|
+
target,
|
|
208
|
+
...networkAccess && { networkAccess }
|
|
209
|
+
};
|
|
210
|
+
}
|
|
211
|
+
async enforceDecision(decision) {
|
|
212
|
+
if (decision.recommendation === "DENY" && this.browserAPI.notifications) {
|
|
213
|
+
this.browserAPI.notifications.create(`astrasync-${Date.now()}`, {
|
|
214
|
+
type: "basic",
|
|
215
|
+
title: "AstraSync Local Guard",
|
|
216
|
+
message: `Blocked: ${decision.reason}`
|
|
217
|
+
});
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
// =====================================================================
|
|
221
|
+
// Internal handlers
|
|
222
|
+
// =====================================================================
|
|
223
|
+
handleWebRequest(details) {
|
|
224
|
+
const action = {
|
|
225
|
+
raw: details,
|
|
226
|
+
platform: "browser",
|
|
227
|
+
timestamp: /* @__PURE__ */ new Date()
|
|
228
|
+
};
|
|
229
|
+
const context = this.extractContext(action);
|
|
230
|
+
const decision = this.evaluateSync(context);
|
|
231
|
+
if (decision.recommendation === "DENY") {
|
|
232
|
+
this.enforceDecision(decision);
|
|
233
|
+
return { cancel: true };
|
|
234
|
+
}
|
|
235
|
+
if (decision.recommendation === "MANUAL_REVIEW") {
|
|
236
|
+
this.enforceDecision({
|
|
237
|
+
...decision,
|
|
238
|
+
recommendation: "DENY",
|
|
239
|
+
reason: `Requires approval (auto-blocked in browser): ${decision.reason}`
|
|
240
|
+
});
|
|
241
|
+
return { cancel: true };
|
|
242
|
+
}
|
|
243
|
+
return void 0;
|
|
244
|
+
}
|
|
245
|
+
handleNavigation(details) {
|
|
246
|
+
const action = {
|
|
247
|
+
raw: {
|
|
248
|
+
requestId: `nav-${details.tabId}-${details.frameId}`,
|
|
249
|
+
url: details.url,
|
|
250
|
+
method: "GET",
|
|
251
|
+
type: "main_frame",
|
|
252
|
+
tabId: details.tabId
|
|
253
|
+
},
|
|
254
|
+
platform: "browser",
|
|
255
|
+
timestamp: /* @__PURE__ */ new Date()
|
|
256
|
+
};
|
|
257
|
+
this.interceptAction(action).then(async (result) => {
|
|
258
|
+
if (result.intercepted && result.context) {
|
|
259
|
+
await this.gateway.evaluate(result.context);
|
|
260
|
+
}
|
|
261
|
+
});
|
|
262
|
+
}
|
|
263
|
+
async handleContentScriptAction(action) {
|
|
264
|
+
const interception = await this.interceptAction(action);
|
|
265
|
+
if (!interception.intercepted || !interception.context) {
|
|
266
|
+
return { recommendation: "ALLOW", reason: "Not intercepted" };
|
|
267
|
+
}
|
|
268
|
+
return this.gateway.evaluate(interception.context);
|
|
269
|
+
}
|
|
270
|
+
/**
|
|
271
|
+
* Synchronous evaluation using the gateway's local evaluator.
|
|
272
|
+
* Falls back to ALLOW if async-only (online mode).
|
|
273
|
+
*/
|
|
274
|
+
evaluateSync(context) {
|
|
275
|
+
const gw = this.gateway;
|
|
276
|
+
if (gw.evaluator) {
|
|
277
|
+
return gw.evaluator.evaluate(context);
|
|
278
|
+
}
|
|
279
|
+
return { recommendation: "ALLOW", reason: "Async-only mode \u2014 allowed by default" };
|
|
280
|
+
}
|
|
281
|
+
};
|
|
282
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
283
|
+
0 && (module.exports = {
|
|
284
|
+
BrowserAdapter
|
|
285
|
+
});
|
|
286
|
+
//# sourceMappingURL=browser-adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/browser/browser-adapter.ts","../../src/adapter-interface/interface.ts","../../src/adapter-interface/purpose-mapping.ts"],"sourcesContent":["/**\n * @astrasyncai/adapter-openclaw-browser\n *\n * Layer 4 adapter for browser-based AI agents (e.g. OpenClaw browser extension).\n * Intercepts page navigation, form submissions, and network requests\n * made by the agent in the browser DOM.\n *\n * The adapter does NOT depend on chrome types. The browser extension\n * passes the chrome/browser API via a minimal interface at initialize() time.\n *\n * ~300 lines — thin, disposable, platform-specific.\n */\n\nimport type { PlatformAdapter, AdapterConfig } from '../adapter-interface/interface';\nimport type { PDLSSContext, VerificationDecision, AgentAction, InterceptResult } from '../gateway/types';\nimport type { AstraSyncGateway } from '../gateway/gateway';\nimport { ADAPTER_INTERFACE_VERSION } from '../adapter-interface/interface';\nimport { mapToolToPurpose, extractTarget, extractNetworkDomains } from '../adapter-interface/purpose-mapping';\n\n// -----------------------------------------------------------------------\n// Minimal browser extension type stubs (injected at runtime)\n// -----------------------------------------------------------------------\n\nexport interface WebRequestDetails {\n requestId: string;\n url: string;\n method: string;\n type: string; // 'main_frame' | 'sub_frame' | 'xmlhttprequest' | 'script' etc.\n tabId: number;\n initiator?: string;\n documentUrl?: string;\n}\n\nexport interface BlockingResponse {\n cancel?: boolean;\n redirectUrl?: string;\n}\n\nexport interface RequestFilter {\n urls: string[];\n types?: string[];\n}\n\nexport interface BrowserExtensionAPI {\n webRequest: {\n onBeforeRequest: {\n addListener(\n callback: (details: WebRequestDetails) => BlockingResponse | void,\n filter: RequestFilter,\n extraInfoSpec?: string[],\n ): void;\n removeListener(callback: (details: WebRequestDetails) => BlockingResponse | void): void;\n };\n };\n webNavigation: {\n onBeforeNavigate: {\n addListener(callback: (details: NavigationDetails) => void): void;\n removeListener(callback: (details: NavigationDetails) => void): void;\n };\n };\n runtime: {\n sendMessage(message: unknown): Promise<unknown>;\n onMessage: {\n addListener(\n callback: (message: unknown, sender: unknown, sendResponse: (response: unknown) => void) => boolean | void,\n ): void;\n removeListener(callback: (...args: unknown[]) => void): void;\n };\n };\n notifications?: {\n create(id: string, options: { type: string; title: string; message: string; iconUrl?: string }): void;\n };\n}\n\nexport interface NavigationDetails {\n tabId: number;\n url: string;\n frameId: number;\n}\n\n// -----------------------------------------------------------------------\n// Configuration\n// -----------------------------------------------------------------------\n\nexport interface BrowserAdapterOptions {\n /** The browser extension API object (chrome or browser) */\n browserAPI: BrowserExtensionAPI;\n /** URL patterns to intercept (default: ['<all_urls>']) */\n urlPatterns?: string[];\n /** Request types to intercept (default: main_frame, xmlhttprequest, sub_frame) */\n requestTypes?: string[];\n /** Callback for MANUAL_REVIEW decisions */\n onApprovalRequired?: (context: PDLSSContext, decision: VerificationDecision) => Promise<boolean>;\n}\n\n// -----------------------------------------------------------------------\n// Purpose mapping for browser actions\n// -----------------------------------------------------------------------\n\nfunction mapBrowserActionToPurpose(details: WebRequestDetails): { toolName: string; args: Record<string, unknown> } {\n const url = details.url;\n\n // Form submissions\n if (details.method === 'POST') {\n // Check for email-related URLs\n if (/mail|email|smtp/i.test(url)) {\n return { toolName: 'send_email', args: { url, to: url } };\n }\n // Check for payment-related URLs\n if (/pay|checkout|stripe|payment/i.test(url)) {\n return { toolName: 'payment_execute', args: { url, description: url } };\n }\n // Generic form submission\n return { toolName: 'http_request', args: { url } };\n }\n\n // Navigation\n if (details.type === 'main_frame') {\n return { toolName: 'http_request', args: { url } };\n }\n\n // XHR / fetch requests\n return { toolName: 'http_request', args: { url } };\n}\n\n// -----------------------------------------------------------------------\n// Adapter implementation\n// -----------------------------------------------------------------------\n\nexport class BrowserAdapter implements PlatformAdapter {\n readonly interfaceVersion = ADAPTER_INTERFACE_VERSION;\n\n private gateway!: AstraSyncGateway;\n private browserAPI!: BrowserExtensionAPI;\n private options: Required<Omit<BrowserAdapterOptions, 'browserAPI'>> & { browserAPI?: BrowserExtensionAPI };\n private requestListener: ((details: WebRequestDetails) => BlockingResponse | void) | null = null;\n private navigationListener: ((details: NavigationDetails) => void) | null = null;\n private messageListener: ((message: unknown, sender: unknown, sendResponse: (response: unknown) => void) => boolean | void) | null = null;\n private _isRunning = false;\n\n constructor(options?: Partial<BrowserAdapterOptions>) {\n this.options = {\n urlPatterns: options?.urlPatterns ?? ['<all_urls>'],\n requestTypes: options?.requestTypes ?? ['main_frame', 'xmlhttprequest', 'sub_frame'],\n onApprovalRequired: options?.onApprovalRequired ?? (async () => false),\n browserAPI: options?.browserAPI,\n };\n }\n\n get isRunning(): boolean {\n return this._isRunning;\n }\n\n async initialize(config: AdapterConfig): Promise<void> {\n this.gateway = config.gateway as AstraSyncGateway;\n\n if (config.adapterOptions.browserAPI) {\n this.browserAPI = config.adapterOptions.browserAPI as BrowserExtensionAPI;\n } else if (this.options.browserAPI) {\n this.browserAPI = this.options.browserAPI;\n }\n\n if (!this.browserAPI) {\n throw new Error('BrowserAdapter requires browser extension API — pass via adapterOptions.browserAPI');\n }\n\n // Register web request interceptor\n this.requestListener = (details: WebRequestDetails): BlockingResponse | void => {\n return this.handleWebRequest(details);\n };\n\n this.browserAPI.webRequest.onBeforeRequest.addListener(\n this.requestListener,\n {\n urls: this.options.urlPatterns,\n types: this.options.requestTypes,\n },\n ['blocking'],\n );\n\n // Register navigation interceptor\n this.navigationListener = (details: NavigationDetails): void => {\n this.handleNavigation(details);\n };\n\n this.browserAPI.webNavigation.onBeforeNavigate.addListener(this.navigationListener);\n\n // Listen for messages from content scripts\n this.messageListener = (message: unknown, _sender: unknown, sendResponse: (response: unknown) => void): boolean | void => {\n const msg = message as { type?: string; action?: AgentAction };\n if (msg?.type === 'astrasync-evaluate') {\n this.handleContentScriptAction(msg.action!).then(sendResponse);\n return true; // async response\n }\n };\n\n this.browserAPI.runtime.onMessage.addListener(this.messageListener as (message: unknown, sender: unknown, sendResponse: (response: unknown) => void) => void);\n\n this._isRunning = true;\n }\n\n async shutdown(): Promise<void> {\n if (this.requestListener) {\n this.browserAPI.webRequest.onBeforeRequest.removeListener(this.requestListener);\n this.requestListener = null;\n }\n if (this.navigationListener) {\n this.browserAPI.webNavigation.onBeforeNavigate.removeListener(this.navigationListener);\n this.navigationListener = null;\n }\n if (this.messageListener) {\n this.browserAPI.runtime.onMessage.removeListener(this.messageListener as (...args: unknown[]) => void);\n this.messageListener = null;\n }\n this._isRunning = false;\n }\n\n async interceptAction(action: AgentAction): Promise<InterceptResult> {\n const raw = action.raw as WebRequestDetails | { type: string };\n\n if (!raw) {\n return { intercepted: false, skipReason: 'No action data' };\n }\n\n const context = this.extractContext(action);\n return { intercepted: true, context };\n }\n\n extractContext(action: AgentAction): PDLSSContext {\n const raw = action.raw as WebRequestDetails;\n\n const { toolName, args } = mapBrowserActionToPurpose(raw);\n const purpose = mapToolToPurpose(toolName);\n const target = extractTarget(toolName, args);\n const networkAccess = extractNetworkDomains(target);\n\n return {\n purpose,\n action: toolName,\n target,\n ...(networkAccess && { networkAccess }),\n };\n }\n\n async enforceDecision(decision: VerificationDecision): Promise<void> {\n if (decision.recommendation === 'DENY' && this.browserAPI.notifications) {\n this.browserAPI.notifications.create(`astrasync-${Date.now()}`, {\n type: 'basic',\n title: 'AstraSync Local Guard',\n message: `Blocked: ${decision.reason}`,\n });\n }\n }\n\n // =====================================================================\n // Internal handlers\n // =====================================================================\n\n private handleWebRequest(details: WebRequestDetails): BlockingResponse | void {\n const action: AgentAction = {\n raw: details,\n platform: 'browser',\n timestamp: new Date(),\n };\n\n const context = this.extractContext(action);\n\n // Synchronous evaluation — browser webRequest requires sync return.\n // We use a cached/pre-computed decision if available, otherwise allow.\n // The gateway's evaluate() is async, so for blocking we need the\n // synchronous local evaluator path.\n const decision = this.evaluateSync(context);\n\n if (decision.recommendation === 'DENY') {\n this.enforceDecision(decision);\n return { cancel: true };\n }\n\n if (decision.recommendation === 'MANUAL_REVIEW') {\n // Can't show async prompt in synchronous handler — block by default\n this.enforceDecision({\n ...decision,\n recommendation: 'DENY',\n reason: `Requires approval (auto-blocked in browser): ${decision.reason}`,\n });\n return { cancel: true };\n }\n\n // ALLOW — don't cancel\n return undefined;\n }\n\n private handleNavigation(details: NavigationDetails): void {\n // Navigation events are informational — evaluate async\n const action: AgentAction = {\n raw: {\n requestId: `nav-${details.tabId}-${details.frameId}`,\n url: details.url,\n method: 'GET',\n type: 'main_frame',\n tabId: details.tabId,\n } as WebRequestDetails,\n platform: 'browser',\n timestamp: new Date(),\n };\n\n // Fire-and-forget async evaluation for logging/traces\n this.interceptAction(action).then(async (result) => {\n if (result.intercepted && result.context) {\n await this.gateway.evaluate(result.context);\n }\n });\n }\n\n private async handleContentScriptAction(action: AgentAction): Promise<VerificationDecision> {\n const interception = await this.interceptAction(action);\n if (!interception.intercepted || !interception.context) {\n return { recommendation: 'ALLOW', reason: 'Not intercepted' };\n }\n\n return this.gateway.evaluate(interception.context);\n }\n\n /**\n * Synchronous evaluation using the gateway's local evaluator.\n * Falls back to ALLOW if async-only (online mode).\n */\n private evaluateSync(context: PDLSSContext): VerificationDecision {\n // The gateway.evaluate() is async, but the local evaluator is synchronous.\n // We access the evaluator directly for browser webRequest handlers.\n // This only works in local/hybrid mode — online mode falls through to ALLOW.\n const gw = this.gateway as unknown as { evaluator?: { evaluate(ctx: PDLSSContext): VerificationDecision } };\n if (gw.evaluator) {\n return gw.evaluator.evaluate(context);\n }\n\n return { recommendation: 'ALLOW', reason: 'Async-only mode — allowed by default' };\n }\n}\n","/**\n * PlatformAdapter Interface\n *\n * The contract that Layer 4 platform adapters implement.\n * Agent-side interception: governs what agents are allowed to do before they do it.\n *\n * Each adapter is 200-500 lines of platform-specific code.\n * All verification logic lives in the gateway — adapters just translate\n * between the platform's world and AstraSync's world.\n */\n\nimport type { AstraSyncGateway } from '../gateway/gateway';\nimport type { PDLSSContext, VerificationDecision, AgentAction, InterceptResult } from '../gateway/types';\n\nexport interface AdapterConfig {\n /** The AstraSyncGateway instance (handles mode routing) */\n gateway: AstraSyncGateway;\n /** Platform-specific configuration */\n adapterOptions: Record<string, unknown>;\n}\n\nexport interface PlatformAdapter {\n /**\n * Interface version for compatibility checking.\n * Current version: 1.\n */\n readonly interfaceVersion: number;\n\n /**\n * Platform-specific initialization.\n * Load config, register hooks, establish connections.\n */\n initialize(config: AdapterConfig): Promise<void>;\n\n /**\n * Graceful shutdown.\n * Drain in-flight verifications, deregister hooks, close connections.\n */\n shutdown(): Promise<void>;\n\n /**\n * Intercept an agent action before execution.\n *\n * How this works depends on the platform:\n * - CLI adapter: proxy server captures outbound request\n * - Browser adapter: content script intercepts DOM interaction\n * - Express: middleware captures inbound request\n */\n interceptAction(action: AgentAction): Promise<InterceptResult>;\n\n /**\n * Extract PDLSS-compatible context from a platform-specific action.\n * Maps platform-native action format to the universal PDLSSContext.\n */\n extractContext(action: AgentAction): PDLSSContext;\n\n /**\n * Enforce the verification decision in a platform-specific way.\n *\n * How this works depends on the platform:\n * - CLI: block command / allow command / prompt for approval\n * - Browser: block navigation / show confirmation dialog\n * - Express: return 403 / pass through / inject headers\n */\n enforceDecision(decision: VerificationDecision): Promise<void>;\n}\n\n/**\n * Current adapter interface version.\n */\nexport const ADAPTER_INTERFACE_VERSION = 1;\n\n/**\n * Check if an adapter is compatible with the current interface version.\n */\nexport function isCompatibleAdapter(adapter: PlatformAdapter): boolean {\n return adapter.interfaceVersion === ADAPTER_INTERFACE_VERSION;\n}\n","/**\n * Shared purpose mapping utilities for Layer 4 platform adapters.\n *\n * Maps platform-native action names to PDLSS purpose categories.\n * Used by OpenClaw CLI, Cursor, browser, and future adapters.\n */\n\n// -----------------------------------------------------------------------\n// Tool → Purpose mapping\n// -----------------------------------------------------------------------\n\n/** Standard tool name → PDLSS purpose mapping used by all adapters */\nconst TOOL_PURPOSE_MAP: Record<string, string> = {\n // Shell\n shell_exec: 'shell.exec',\n run_command: 'shell.exec',\n execute: 'shell.exec',\n terminal_exec: 'shell.exec',\n run_terminal_command: 'shell.exec',\n\n // File read\n file_read: 'file.read',\n read_file: 'file.read',\n\n // File write\n file_write: 'file.write',\n write_file: 'file.write',\n create_file: 'file.write',\n edit_file: 'file.write',\n\n // File delete\n file_delete: 'file.delete',\n delete_file: 'file.delete',\n\n // Network\n http_request: 'network.request',\n fetch: 'network.request',\n web_request: 'network.request',\n\n // Email\n send_email: 'email.send',\n read_email: 'email.read',\n\n // Calendar\n create_event: 'calendar.create',\n\n // Database\n query_database: 'database.query',\n write_database: 'database.write',\n\n // Payment\n payment_execute: 'payment.execute',\n};\n\n/**\n * Map a tool/action name to a PDLSS purpose category.\n * Returns `tool.<name>` for unmapped tools (denied by default).\n */\nexport function mapToolToPurpose(toolName: string): string {\n return TOOL_PURPOSE_MAP[toolName] || `tool.${toolName}`;\n}\n\n/**\n * Register additional tool → purpose mappings (e.g. from a platform adapter).\n * Does not overwrite existing mappings.\n */\nexport function registerToolMappings(mappings: Record<string, string>): void {\n for (const [tool, purpose] of Object.entries(mappings)) {\n if (!(tool in TOOL_PURPOSE_MAP)) {\n TOOL_PURPOSE_MAP[tool] = purpose;\n }\n }\n}\n\n// -----------------------------------------------------------------------\n// Target extraction\n// -----------------------------------------------------------------------\n\n/**\n * Extract the meaningful target string from tool arguments.\n * Uses the purpose category to determine which argument field is relevant.\n */\nexport function extractTarget(toolName: string, args: Record<string, unknown>): string {\n const purpose = mapToolToPurpose(toolName);\n\n if (purpose.startsWith('shell.')) {\n return String(args.command || args.cmd || args.script || '');\n }\n\n if (purpose.startsWith('file.')) {\n return String(args.path || args.file || args.filename || args.file_path || '');\n }\n\n if (purpose.startsWith('network.')) {\n return String(args.url || args.endpoint || args.uri || '');\n }\n\n if (purpose.startsWith('email.')) {\n return String(args.to || args.recipient || args.address || '');\n }\n\n if (purpose.startsWith('database.')) {\n return String(args.query || args.table || '');\n }\n\n if (purpose.startsWith('payment.')) {\n return String(args.description || args.merchant || args.amount || '');\n }\n\n // Fallback: try common field names\n if (args.command) return String(args.command);\n if (args.path) return String(args.path);\n if (args.url) return String(args.url);\n\n // Default: use first non-empty string argument or tool name\n for (const val of Object.values(args)) {\n if (typeof val === 'string' && val.length > 0) return val;\n }\n return toolName;\n}\n\n// -----------------------------------------------------------------------\n// Network domain extraction\n// -----------------------------------------------------------------------\n\n/**\n * Extract network domains from a URL target.\n * Returns undefined if the target is not a URL.\n */\nexport function extractNetworkDomains(target: string): string[] | undefined {\n try {\n if (target.startsWith('http://') || target.startsWith('https://')) {\n const url = new URL(target);\n return [url.hostname];\n }\n } catch {\n // Not a URL\n }\n return undefined;\n}\n"],"mappings":"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","names":[]}
|
|
@@ -0,0 +1,259 @@
|
|
|
1
|
+
// src/adapter-interface/interface.ts
|
|
2
|
+
var ADAPTER_INTERFACE_VERSION = 1;
|
|
3
|
+
|
|
4
|
+
// src/adapter-interface/purpose-mapping.ts
|
|
5
|
+
var TOOL_PURPOSE_MAP = {
|
|
6
|
+
// Shell
|
|
7
|
+
shell_exec: "shell.exec",
|
|
8
|
+
run_command: "shell.exec",
|
|
9
|
+
execute: "shell.exec",
|
|
10
|
+
terminal_exec: "shell.exec",
|
|
11
|
+
run_terminal_command: "shell.exec",
|
|
12
|
+
// File read
|
|
13
|
+
file_read: "file.read",
|
|
14
|
+
read_file: "file.read",
|
|
15
|
+
// File write
|
|
16
|
+
file_write: "file.write",
|
|
17
|
+
write_file: "file.write",
|
|
18
|
+
create_file: "file.write",
|
|
19
|
+
edit_file: "file.write",
|
|
20
|
+
// File delete
|
|
21
|
+
file_delete: "file.delete",
|
|
22
|
+
delete_file: "file.delete",
|
|
23
|
+
// Network
|
|
24
|
+
http_request: "network.request",
|
|
25
|
+
fetch: "network.request",
|
|
26
|
+
web_request: "network.request",
|
|
27
|
+
// Email
|
|
28
|
+
send_email: "email.send",
|
|
29
|
+
read_email: "email.read",
|
|
30
|
+
// Calendar
|
|
31
|
+
create_event: "calendar.create",
|
|
32
|
+
// Database
|
|
33
|
+
query_database: "database.query",
|
|
34
|
+
write_database: "database.write",
|
|
35
|
+
// Payment
|
|
36
|
+
payment_execute: "payment.execute"
|
|
37
|
+
};
|
|
38
|
+
function mapToolToPurpose(toolName) {
|
|
39
|
+
return TOOL_PURPOSE_MAP[toolName] || `tool.${toolName}`;
|
|
40
|
+
}
|
|
41
|
+
function extractTarget(toolName, args) {
|
|
42
|
+
const purpose = mapToolToPurpose(toolName);
|
|
43
|
+
if (purpose.startsWith("shell.")) {
|
|
44
|
+
return String(args.command || args.cmd || args.script || "");
|
|
45
|
+
}
|
|
46
|
+
if (purpose.startsWith("file.")) {
|
|
47
|
+
return String(args.path || args.file || args.filename || args.file_path || "");
|
|
48
|
+
}
|
|
49
|
+
if (purpose.startsWith("network.")) {
|
|
50
|
+
return String(args.url || args.endpoint || args.uri || "");
|
|
51
|
+
}
|
|
52
|
+
if (purpose.startsWith("email.")) {
|
|
53
|
+
return String(args.to || args.recipient || args.address || "");
|
|
54
|
+
}
|
|
55
|
+
if (purpose.startsWith("database.")) {
|
|
56
|
+
return String(args.query || args.table || "");
|
|
57
|
+
}
|
|
58
|
+
if (purpose.startsWith("payment.")) {
|
|
59
|
+
return String(args.description || args.merchant || args.amount || "");
|
|
60
|
+
}
|
|
61
|
+
if (args.command) return String(args.command);
|
|
62
|
+
if (args.path) return String(args.path);
|
|
63
|
+
if (args.url) return String(args.url);
|
|
64
|
+
for (const val of Object.values(args)) {
|
|
65
|
+
if (typeof val === "string" && val.length > 0) return val;
|
|
66
|
+
}
|
|
67
|
+
return toolName;
|
|
68
|
+
}
|
|
69
|
+
function extractNetworkDomains(target) {
|
|
70
|
+
try {
|
|
71
|
+
if (target.startsWith("http://") || target.startsWith("https://")) {
|
|
72
|
+
const url = new URL(target);
|
|
73
|
+
return [url.hostname];
|
|
74
|
+
}
|
|
75
|
+
} catch {
|
|
76
|
+
}
|
|
77
|
+
return void 0;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
// src/browser/browser-adapter.ts
|
|
81
|
+
function mapBrowserActionToPurpose(details) {
|
|
82
|
+
const url = details.url;
|
|
83
|
+
if (details.method === "POST") {
|
|
84
|
+
if (/mail|email|smtp/i.test(url)) {
|
|
85
|
+
return { toolName: "send_email", args: { url, to: url } };
|
|
86
|
+
}
|
|
87
|
+
if (/pay|checkout|stripe|payment/i.test(url)) {
|
|
88
|
+
return { toolName: "payment_execute", args: { url, description: url } };
|
|
89
|
+
}
|
|
90
|
+
return { toolName: "http_request", args: { url } };
|
|
91
|
+
}
|
|
92
|
+
if (details.type === "main_frame") {
|
|
93
|
+
return { toolName: "http_request", args: { url } };
|
|
94
|
+
}
|
|
95
|
+
return { toolName: "http_request", args: { url } };
|
|
96
|
+
}
|
|
97
|
+
var BrowserAdapter = class {
|
|
98
|
+
constructor(options) {
|
|
99
|
+
this.interfaceVersion = ADAPTER_INTERFACE_VERSION;
|
|
100
|
+
this.requestListener = null;
|
|
101
|
+
this.navigationListener = null;
|
|
102
|
+
this.messageListener = null;
|
|
103
|
+
this._isRunning = false;
|
|
104
|
+
this.options = {
|
|
105
|
+
urlPatterns: options?.urlPatterns ?? ["<all_urls>"],
|
|
106
|
+
requestTypes: options?.requestTypes ?? ["main_frame", "xmlhttprequest", "sub_frame"],
|
|
107
|
+
onApprovalRequired: options?.onApprovalRequired ?? (async () => false),
|
|
108
|
+
browserAPI: options?.browserAPI
|
|
109
|
+
};
|
|
110
|
+
}
|
|
111
|
+
get isRunning() {
|
|
112
|
+
return this._isRunning;
|
|
113
|
+
}
|
|
114
|
+
async initialize(config) {
|
|
115
|
+
this.gateway = config.gateway;
|
|
116
|
+
if (config.adapterOptions.browserAPI) {
|
|
117
|
+
this.browserAPI = config.adapterOptions.browserAPI;
|
|
118
|
+
} else if (this.options.browserAPI) {
|
|
119
|
+
this.browserAPI = this.options.browserAPI;
|
|
120
|
+
}
|
|
121
|
+
if (!this.browserAPI) {
|
|
122
|
+
throw new Error("BrowserAdapter requires browser extension API \u2014 pass via adapterOptions.browserAPI");
|
|
123
|
+
}
|
|
124
|
+
this.requestListener = (details) => {
|
|
125
|
+
return this.handleWebRequest(details);
|
|
126
|
+
};
|
|
127
|
+
this.browserAPI.webRequest.onBeforeRequest.addListener(
|
|
128
|
+
this.requestListener,
|
|
129
|
+
{
|
|
130
|
+
urls: this.options.urlPatterns,
|
|
131
|
+
types: this.options.requestTypes
|
|
132
|
+
},
|
|
133
|
+
["blocking"]
|
|
134
|
+
);
|
|
135
|
+
this.navigationListener = (details) => {
|
|
136
|
+
this.handleNavigation(details);
|
|
137
|
+
};
|
|
138
|
+
this.browserAPI.webNavigation.onBeforeNavigate.addListener(this.navigationListener);
|
|
139
|
+
this.messageListener = (message, _sender, sendResponse) => {
|
|
140
|
+
const msg = message;
|
|
141
|
+
if (msg?.type === "astrasync-evaluate") {
|
|
142
|
+
this.handleContentScriptAction(msg.action).then(sendResponse);
|
|
143
|
+
return true;
|
|
144
|
+
}
|
|
145
|
+
};
|
|
146
|
+
this.browserAPI.runtime.onMessage.addListener(this.messageListener);
|
|
147
|
+
this._isRunning = true;
|
|
148
|
+
}
|
|
149
|
+
async shutdown() {
|
|
150
|
+
if (this.requestListener) {
|
|
151
|
+
this.browserAPI.webRequest.onBeforeRequest.removeListener(this.requestListener);
|
|
152
|
+
this.requestListener = null;
|
|
153
|
+
}
|
|
154
|
+
if (this.navigationListener) {
|
|
155
|
+
this.browserAPI.webNavigation.onBeforeNavigate.removeListener(this.navigationListener);
|
|
156
|
+
this.navigationListener = null;
|
|
157
|
+
}
|
|
158
|
+
if (this.messageListener) {
|
|
159
|
+
this.browserAPI.runtime.onMessage.removeListener(this.messageListener);
|
|
160
|
+
this.messageListener = null;
|
|
161
|
+
}
|
|
162
|
+
this._isRunning = false;
|
|
163
|
+
}
|
|
164
|
+
async interceptAction(action) {
|
|
165
|
+
const raw = action.raw;
|
|
166
|
+
if (!raw) {
|
|
167
|
+
return { intercepted: false, skipReason: "No action data" };
|
|
168
|
+
}
|
|
169
|
+
const context = this.extractContext(action);
|
|
170
|
+
return { intercepted: true, context };
|
|
171
|
+
}
|
|
172
|
+
extractContext(action) {
|
|
173
|
+
const raw = action.raw;
|
|
174
|
+
const { toolName, args } = mapBrowserActionToPurpose(raw);
|
|
175
|
+
const purpose = mapToolToPurpose(toolName);
|
|
176
|
+
const target = extractTarget(toolName, args);
|
|
177
|
+
const networkAccess = extractNetworkDomains(target);
|
|
178
|
+
return {
|
|
179
|
+
purpose,
|
|
180
|
+
action: toolName,
|
|
181
|
+
target,
|
|
182
|
+
...networkAccess && { networkAccess }
|
|
183
|
+
};
|
|
184
|
+
}
|
|
185
|
+
async enforceDecision(decision) {
|
|
186
|
+
if (decision.recommendation === "DENY" && this.browserAPI.notifications) {
|
|
187
|
+
this.browserAPI.notifications.create(`astrasync-${Date.now()}`, {
|
|
188
|
+
type: "basic",
|
|
189
|
+
title: "AstraSync Local Guard",
|
|
190
|
+
message: `Blocked: ${decision.reason}`
|
|
191
|
+
});
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
// =====================================================================
|
|
195
|
+
// Internal handlers
|
|
196
|
+
// =====================================================================
|
|
197
|
+
handleWebRequest(details) {
|
|
198
|
+
const action = {
|
|
199
|
+
raw: details,
|
|
200
|
+
platform: "browser",
|
|
201
|
+
timestamp: /* @__PURE__ */ new Date()
|
|
202
|
+
};
|
|
203
|
+
const context = this.extractContext(action);
|
|
204
|
+
const decision = this.evaluateSync(context);
|
|
205
|
+
if (decision.recommendation === "DENY") {
|
|
206
|
+
this.enforceDecision(decision);
|
|
207
|
+
return { cancel: true };
|
|
208
|
+
}
|
|
209
|
+
if (decision.recommendation === "MANUAL_REVIEW") {
|
|
210
|
+
this.enforceDecision({
|
|
211
|
+
...decision,
|
|
212
|
+
recommendation: "DENY",
|
|
213
|
+
reason: `Requires approval (auto-blocked in browser): ${decision.reason}`
|
|
214
|
+
});
|
|
215
|
+
return { cancel: true };
|
|
216
|
+
}
|
|
217
|
+
return void 0;
|
|
218
|
+
}
|
|
219
|
+
handleNavigation(details) {
|
|
220
|
+
const action = {
|
|
221
|
+
raw: {
|
|
222
|
+
requestId: `nav-${details.tabId}-${details.frameId}`,
|
|
223
|
+
url: details.url,
|
|
224
|
+
method: "GET",
|
|
225
|
+
type: "main_frame",
|
|
226
|
+
tabId: details.tabId
|
|
227
|
+
},
|
|
228
|
+
platform: "browser",
|
|
229
|
+
timestamp: /* @__PURE__ */ new Date()
|
|
230
|
+
};
|
|
231
|
+
this.interceptAction(action).then(async (result) => {
|
|
232
|
+
if (result.intercepted && result.context) {
|
|
233
|
+
await this.gateway.evaluate(result.context);
|
|
234
|
+
}
|
|
235
|
+
});
|
|
236
|
+
}
|
|
237
|
+
async handleContentScriptAction(action) {
|
|
238
|
+
const interception = await this.interceptAction(action);
|
|
239
|
+
if (!interception.intercepted || !interception.context) {
|
|
240
|
+
return { recommendation: "ALLOW", reason: "Not intercepted" };
|
|
241
|
+
}
|
|
242
|
+
return this.gateway.evaluate(interception.context);
|
|
243
|
+
}
|
|
244
|
+
/**
|
|
245
|
+
* Synchronous evaluation using the gateway's local evaluator.
|
|
246
|
+
* Falls back to ALLOW if async-only (online mode).
|
|
247
|
+
*/
|
|
248
|
+
evaluateSync(context) {
|
|
249
|
+
const gw = this.gateway;
|
|
250
|
+
if (gw.evaluator) {
|
|
251
|
+
return gw.evaluator.evaluate(context);
|
|
252
|
+
}
|
|
253
|
+
return { recommendation: "ALLOW", reason: "Async-only mode \u2014 allowed by default" };
|
|
254
|
+
}
|
|
255
|
+
};
|
|
256
|
+
export {
|
|
257
|
+
BrowserAdapter
|
|
258
|
+
};
|
|
259
|
+
//# sourceMappingURL=browser-adapter.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/adapter-interface/interface.ts","../../src/adapter-interface/purpose-mapping.ts","../../src/browser/browser-adapter.ts"],"sourcesContent":["/**\n * PlatformAdapter Interface\n *\n * The contract that Layer 4 platform adapters implement.\n * Agent-side interception: governs what agents are allowed to do before they do it.\n *\n * Each adapter is 200-500 lines of platform-specific code.\n * All verification logic lives in the gateway — adapters just translate\n * between the platform's world and AstraSync's world.\n */\n\nimport type { AstraSyncGateway } from '../gateway/gateway';\nimport type { PDLSSContext, VerificationDecision, AgentAction, InterceptResult } from '../gateway/types';\n\nexport interface AdapterConfig {\n /** The AstraSyncGateway instance (handles mode routing) */\n gateway: AstraSyncGateway;\n /** Platform-specific configuration */\n adapterOptions: Record<string, unknown>;\n}\n\nexport interface PlatformAdapter {\n /**\n * Interface version for compatibility checking.\n * Current version: 1.\n */\n readonly interfaceVersion: number;\n\n /**\n * Platform-specific initialization.\n * Load config, register hooks, establish connections.\n */\n initialize(config: AdapterConfig): Promise<void>;\n\n /**\n * Graceful shutdown.\n * Drain in-flight verifications, deregister hooks, close connections.\n */\n shutdown(): Promise<void>;\n\n /**\n * Intercept an agent action before execution.\n *\n * How this works depends on the platform:\n * - CLI adapter: proxy server captures outbound request\n * - Browser adapter: content script intercepts DOM interaction\n * - Express: middleware captures inbound request\n */\n interceptAction(action: AgentAction): Promise<InterceptResult>;\n\n /**\n * Extract PDLSS-compatible context from a platform-specific action.\n * Maps platform-native action format to the universal PDLSSContext.\n */\n extractContext(action: AgentAction): PDLSSContext;\n\n /**\n * Enforce the verification decision in a platform-specific way.\n *\n * How this works depends on the platform:\n * - CLI: block command / allow command / prompt for approval\n * - Browser: block navigation / show confirmation dialog\n * - Express: return 403 / pass through / inject headers\n */\n enforceDecision(decision: VerificationDecision): Promise<void>;\n}\n\n/**\n * Current adapter interface version.\n */\nexport const ADAPTER_INTERFACE_VERSION = 1;\n\n/**\n * Check if an adapter is compatible with the current interface version.\n */\nexport function isCompatibleAdapter(adapter: PlatformAdapter): boolean {\n return adapter.interfaceVersion === ADAPTER_INTERFACE_VERSION;\n}\n","/**\n * Shared purpose mapping utilities for Layer 4 platform adapters.\n *\n * Maps platform-native action names to PDLSS purpose categories.\n * Used by OpenClaw CLI, Cursor, browser, and future adapters.\n */\n\n// -----------------------------------------------------------------------\n// Tool → Purpose mapping\n// -----------------------------------------------------------------------\n\n/** Standard tool name → PDLSS purpose mapping used by all adapters */\nconst TOOL_PURPOSE_MAP: Record<string, string> = {\n // Shell\n shell_exec: 'shell.exec',\n run_command: 'shell.exec',\n execute: 'shell.exec',\n terminal_exec: 'shell.exec',\n run_terminal_command: 'shell.exec',\n\n // File read\n file_read: 'file.read',\n read_file: 'file.read',\n\n // File write\n file_write: 'file.write',\n write_file: 'file.write',\n create_file: 'file.write',\n edit_file: 'file.write',\n\n // File delete\n file_delete: 'file.delete',\n delete_file: 'file.delete',\n\n // Network\n http_request: 'network.request',\n fetch: 'network.request',\n web_request: 'network.request',\n\n // Email\n send_email: 'email.send',\n read_email: 'email.read',\n\n // Calendar\n create_event: 'calendar.create',\n\n // Database\n query_database: 'database.query',\n write_database: 'database.write',\n\n // Payment\n payment_execute: 'payment.execute',\n};\n\n/**\n * Map a tool/action name to a PDLSS purpose category.\n * Returns `tool.<name>` for unmapped tools (denied by default).\n */\nexport function mapToolToPurpose(toolName: string): string {\n return TOOL_PURPOSE_MAP[toolName] || `tool.${toolName}`;\n}\n\n/**\n * Register additional tool → purpose mappings (e.g. from a platform adapter).\n * Does not overwrite existing mappings.\n */\nexport function registerToolMappings(mappings: Record<string, string>): void {\n for (const [tool, purpose] of Object.entries(mappings)) {\n if (!(tool in TOOL_PURPOSE_MAP)) {\n TOOL_PURPOSE_MAP[tool] = purpose;\n }\n }\n}\n\n// -----------------------------------------------------------------------\n// Target extraction\n// -----------------------------------------------------------------------\n\n/**\n * Extract the meaningful target string from tool arguments.\n * Uses the purpose category to determine which argument field is relevant.\n */\nexport function extractTarget(toolName: string, args: Record<string, unknown>): string {\n const purpose = mapToolToPurpose(toolName);\n\n if (purpose.startsWith('shell.')) {\n return String(args.command || args.cmd || args.script || '');\n }\n\n if (purpose.startsWith('file.')) {\n return String(args.path || args.file || args.filename || args.file_path || '');\n }\n\n if (purpose.startsWith('network.')) {\n return String(args.url || args.endpoint || args.uri || '');\n }\n\n if (purpose.startsWith('email.')) {\n return String(args.to || args.recipient || args.address || '');\n }\n\n if (purpose.startsWith('database.')) {\n return String(args.query || args.table || '');\n }\n\n if (purpose.startsWith('payment.')) {\n return String(args.description || args.merchant || args.amount || '');\n }\n\n // Fallback: try common field names\n if (args.command) return String(args.command);\n if (args.path) return String(args.path);\n if (args.url) return String(args.url);\n\n // Default: use first non-empty string argument or tool name\n for (const val of Object.values(args)) {\n if (typeof val === 'string' && val.length > 0) return val;\n }\n return toolName;\n}\n\n// -----------------------------------------------------------------------\n// Network domain extraction\n// -----------------------------------------------------------------------\n\n/**\n * Extract network domains from a URL target.\n * Returns undefined if the target is not a URL.\n */\nexport function extractNetworkDomains(target: string): string[] | undefined {\n try {\n if (target.startsWith('http://') || target.startsWith('https://')) {\n const url = new URL(target);\n return [url.hostname];\n }\n } catch {\n // Not a URL\n }\n return undefined;\n}\n","/**\n * @astrasyncai/adapter-openclaw-browser\n *\n * Layer 4 adapter for browser-based AI agents (e.g. OpenClaw browser extension).\n * Intercepts page navigation, form submissions, and network requests\n * made by the agent in the browser DOM.\n *\n * The adapter does NOT depend on chrome types. The browser extension\n * passes the chrome/browser API via a minimal interface at initialize() time.\n *\n * ~300 lines — thin, disposable, platform-specific.\n */\n\nimport type { PlatformAdapter, AdapterConfig } from '../adapter-interface/interface';\nimport type { PDLSSContext, VerificationDecision, AgentAction, InterceptResult } from '../gateway/types';\nimport type { AstraSyncGateway } from '../gateway/gateway';\nimport { ADAPTER_INTERFACE_VERSION } from '../adapter-interface/interface';\nimport { mapToolToPurpose, extractTarget, extractNetworkDomains } from '../adapter-interface/purpose-mapping';\n\n// -----------------------------------------------------------------------\n// Minimal browser extension type stubs (injected at runtime)\n// -----------------------------------------------------------------------\n\nexport interface WebRequestDetails {\n requestId: string;\n url: string;\n method: string;\n type: string; // 'main_frame' | 'sub_frame' | 'xmlhttprequest' | 'script' etc.\n tabId: number;\n initiator?: string;\n documentUrl?: string;\n}\n\nexport interface BlockingResponse {\n cancel?: boolean;\n redirectUrl?: string;\n}\n\nexport interface RequestFilter {\n urls: string[];\n types?: string[];\n}\n\nexport interface BrowserExtensionAPI {\n webRequest: {\n onBeforeRequest: {\n addListener(\n callback: (details: WebRequestDetails) => BlockingResponse | void,\n filter: RequestFilter,\n extraInfoSpec?: string[],\n ): void;\n removeListener(callback: (details: WebRequestDetails) => BlockingResponse | void): void;\n };\n };\n webNavigation: {\n onBeforeNavigate: {\n addListener(callback: (details: NavigationDetails) => void): void;\n removeListener(callback: (details: NavigationDetails) => void): void;\n };\n };\n runtime: {\n sendMessage(message: unknown): Promise<unknown>;\n onMessage: {\n addListener(\n callback: (message: unknown, sender: unknown, sendResponse: (response: unknown) => void) => boolean | void,\n ): void;\n removeListener(callback: (...args: unknown[]) => void): void;\n };\n };\n notifications?: {\n create(id: string, options: { type: string; title: string; message: string; iconUrl?: string }): void;\n };\n}\n\nexport interface NavigationDetails {\n tabId: number;\n url: string;\n frameId: number;\n}\n\n// -----------------------------------------------------------------------\n// Configuration\n// -----------------------------------------------------------------------\n\nexport interface BrowserAdapterOptions {\n /** The browser extension API object (chrome or browser) */\n browserAPI: BrowserExtensionAPI;\n /** URL patterns to intercept (default: ['<all_urls>']) */\n urlPatterns?: string[];\n /** Request types to intercept (default: main_frame, xmlhttprequest, sub_frame) */\n requestTypes?: string[];\n /** Callback for MANUAL_REVIEW decisions */\n onApprovalRequired?: (context: PDLSSContext, decision: VerificationDecision) => Promise<boolean>;\n}\n\n// -----------------------------------------------------------------------\n// Purpose mapping for browser actions\n// -----------------------------------------------------------------------\n\nfunction mapBrowserActionToPurpose(details: WebRequestDetails): { toolName: string; args: Record<string, unknown> } {\n const url = details.url;\n\n // Form submissions\n if (details.method === 'POST') {\n // Check for email-related URLs\n if (/mail|email|smtp/i.test(url)) {\n return { toolName: 'send_email', args: { url, to: url } };\n }\n // Check for payment-related URLs\n if (/pay|checkout|stripe|payment/i.test(url)) {\n return { toolName: 'payment_execute', args: { url, description: url } };\n }\n // Generic form submission\n return { toolName: 'http_request', args: { url } };\n }\n\n // Navigation\n if (details.type === 'main_frame') {\n return { toolName: 'http_request', args: { url } };\n }\n\n // XHR / fetch requests\n return { toolName: 'http_request', args: { url } };\n}\n\n// -----------------------------------------------------------------------\n// Adapter implementation\n// -----------------------------------------------------------------------\n\nexport class BrowserAdapter implements PlatformAdapter {\n readonly interfaceVersion = ADAPTER_INTERFACE_VERSION;\n\n private gateway!: AstraSyncGateway;\n private browserAPI!: BrowserExtensionAPI;\n private options: Required<Omit<BrowserAdapterOptions, 'browserAPI'>> & { browserAPI?: BrowserExtensionAPI };\n private requestListener: ((details: WebRequestDetails) => BlockingResponse | void) | null = null;\n private navigationListener: ((details: NavigationDetails) => void) | null = null;\n private messageListener: ((message: unknown, sender: unknown, sendResponse: (response: unknown) => void) => boolean | void) | null = null;\n private _isRunning = false;\n\n constructor(options?: Partial<BrowserAdapterOptions>) {\n this.options = {\n urlPatterns: options?.urlPatterns ?? ['<all_urls>'],\n requestTypes: options?.requestTypes ?? ['main_frame', 'xmlhttprequest', 'sub_frame'],\n onApprovalRequired: options?.onApprovalRequired ?? (async () => false),\n browserAPI: options?.browserAPI,\n };\n }\n\n get isRunning(): boolean {\n return this._isRunning;\n }\n\n async initialize(config: AdapterConfig): Promise<void> {\n this.gateway = config.gateway as AstraSyncGateway;\n\n if (config.adapterOptions.browserAPI) {\n this.browserAPI = config.adapterOptions.browserAPI as BrowserExtensionAPI;\n } else if (this.options.browserAPI) {\n this.browserAPI = this.options.browserAPI;\n }\n\n if (!this.browserAPI) {\n throw new Error('BrowserAdapter requires browser extension API — pass via adapterOptions.browserAPI');\n }\n\n // Register web request interceptor\n this.requestListener = (details: WebRequestDetails): BlockingResponse | void => {\n return this.handleWebRequest(details);\n };\n\n this.browserAPI.webRequest.onBeforeRequest.addListener(\n this.requestListener,\n {\n urls: this.options.urlPatterns,\n types: this.options.requestTypes,\n },\n ['blocking'],\n );\n\n // Register navigation interceptor\n this.navigationListener = (details: NavigationDetails): void => {\n this.handleNavigation(details);\n };\n\n this.browserAPI.webNavigation.onBeforeNavigate.addListener(this.navigationListener);\n\n // Listen for messages from content scripts\n this.messageListener = (message: unknown, _sender: unknown, sendResponse: (response: unknown) => void): boolean | void => {\n const msg = message as { type?: string; action?: AgentAction };\n if (msg?.type === 'astrasync-evaluate') {\n this.handleContentScriptAction(msg.action!).then(sendResponse);\n return true; // async response\n }\n };\n\n this.browserAPI.runtime.onMessage.addListener(this.messageListener as (message: unknown, sender: unknown, sendResponse: (response: unknown) => void) => void);\n\n this._isRunning = true;\n }\n\n async shutdown(): Promise<void> {\n if (this.requestListener) {\n this.browserAPI.webRequest.onBeforeRequest.removeListener(this.requestListener);\n this.requestListener = null;\n }\n if (this.navigationListener) {\n this.browserAPI.webNavigation.onBeforeNavigate.removeListener(this.navigationListener);\n this.navigationListener = null;\n }\n if (this.messageListener) {\n this.browserAPI.runtime.onMessage.removeListener(this.messageListener as (...args: unknown[]) => void);\n this.messageListener = null;\n }\n this._isRunning = false;\n }\n\n async interceptAction(action: AgentAction): Promise<InterceptResult> {\n const raw = action.raw as WebRequestDetails | { type: string };\n\n if (!raw) {\n return { intercepted: false, skipReason: 'No action data' };\n }\n\n const context = this.extractContext(action);\n return { intercepted: true, context };\n }\n\n extractContext(action: AgentAction): PDLSSContext {\n const raw = action.raw as WebRequestDetails;\n\n const { toolName, args } = mapBrowserActionToPurpose(raw);\n const purpose = mapToolToPurpose(toolName);\n const target = extractTarget(toolName, args);\n const networkAccess = extractNetworkDomains(target);\n\n return {\n purpose,\n action: toolName,\n target,\n ...(networkAccess && { networkAccess }),\n };\n }\n\n async enforceDecision(decision: VerificationDecision): Promise<void> {\n if (decision.recommendation === 'DENY' && this.browserAPI.notifications) {\n this.browserAPI.notifications.create(`astrasync-${Date.now()}`, {\n type: 'basic',\n title: 'AstraSync Local Guard',\n message: `Blocked: ${decision.reason}`,\n });\n }\n }\n\n // =====================================================================\n // Internal handlers\n // =====================================================================\n\n private handleWebRequest(details: WebRequestDetails): BlockingResponse | void {\n const action: AgentAction = {\n raw: details,\n platform: 'browser',\n timestamp: new Date(),\n };\n\n const context = this.extractContext(action);\n\n // Synchronous evaluation — browser webRequest requires sync return.\n // We use a cached/pre-computed decision if available, otherwise allow.\n // The gateway's evaluate() is async, so for blocking we need the\n // synchronous local evaluator path.\n const decision = this.evaluateSync(context);\n\n if (decision.recommendation === 'DENY') {\n this.enforceDecision(decision);\n return { cancel: true };\n }\n\n if (decision.recommendation === 'MANUAL_REVIEW') {\n // Can't show async prompt in synchronous handler — block by default\n this.enforceDecision({\n ...decision,\n recommendation: 'DENY',\n reason: `Requires approval (auto-blocked in browser): ${decision.reason}`,\n });\n return { cancel: true };\n }\n\n // ALLOW — don't cancel\n return undefined;\n }\n\n private handleNavigation(details: NavigationDetails): void {\n // Navigation events are informational — evaluate async\n const action: AgentAction = {\n raw: {\n requestId: `nav-${details.tabId}-${details.frameId}`,\n url: details.url,\n method: 'GET',\n type: 'main_frame',\n tabId: details.tabId,\n } as WebRequestDetails,\n platform: 'browser',\n timestamp: new Date(),\n };\n\n // Fire-and-forget async evaluation for logging/traces\n this.interceptAction(action).then(async (result) => {\n if (result.intercepted && result.context) {\n await this.gateway.evaluate(result.context);\n }\n });\n }\n\n private async handleContentScriptAction(action: AgentAction): Promise<VerificationDecision> {\n const interception = await this.interceptAction(action);\n if (!interception.intercepted || !interception.context) {\n return { recommendation: 'ALLOW', reason: 'Not intercepted' };\n }\n\n return this.gateway.evaluate(interception.context);\n }\n\n /**\n * Synchronous evaluation using the gateway's local evaluator.\n * Falls back to ALLOW if async-only (online mode).\n */\n private evaluateSync(context: PDLSSContext): VerificationDecision {\n // The gateway.evaluate() is async, but the local evaluator is synchronous.\n // We access the evaluator directly for browser webRequest handlers.\n // This only works in local/hybrid mode — online mode falls through to ALLOW.\n const gw = this.gateway as unknown as { evaluator?: { evaluate(ctx: PDLSSContext): VerificationDecision } };\n if (gw.evaluator) {\n return gw.evaluator.evaluate(context);\n }\n\n return { recommendation: 'ALLOW', reason: 'Async-only mode — allowed by default' };\n }\n}\n"],"mappings":"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","names":[]}
|