@predicatelabs/sdk 0.99.9

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.
Files changed (302) hide show
  1. package/LICENSE +24 -0
  2. package/README.md +252 -0
  3. package/dist/actions.d.ts +185 -0
  4. package/dist/actions.d.ts.map +1 -0
  5. package/dist/actions.js +1120 -0
  6. package/dist/actions.js.map +1 -0
  7. package/dist/agent-runtime.d.ts +352 -0
  8. package/dist/agent-runtime.d.ts.map +1 -0
  9. package/dist/agent-runtime.js +1170 -0
  10. package/dist/agent-runtime.js.map +1 -0
  11. package/dist/agent.d.ts +164 -0
  12. package/dist/agent.d.ts.map +1 -0
  13. package/dist/agent.js +408 -0
  14. package/dist/agent.js.map +1 -0
  15. package/dist/asserts/expect.d.ts +159 -0
  16. package/dist/asserts/expect.d.ts.map +1 -0
  17. package/dist/asserts/expect.js +547 -0
  18. package/dist/asserts/expect.js.map +1 -0
  19. package/dist/asserts/index.d.ts +58 -0
  20. package/dist/asserts/index.d.ts.map +1 -0
  21. package/dist/asserts/index.js +70 -0
  22. package/dist/asserts/index.js.map +1 -0
  23. package/dist/asserts/query.d.ts +199 -0
  24. package/dist/asserts/query.d.ts.map +1 -0
  25. package/dist/asserts/query.js +288 -0
  26. package/dist/asserts/query.js.map +1 -0
  27. package/dist/backends/actions.d.ts +119 -0
  28. package/dist/backends/actions.d.ts.map +1 -0
  29. package/dist/backends/actions.js +291 -0
  30. package/dist/backends/actions.js.map +1 -0
  31. package/dist/backends/browser-use-adapter.d.ts +131 -0
  32. package/dist/backends/browser-use-adapter.d.ts.map +1 -0
  33. package/dist/backends/browser-use-adapter.js +219 -0
  34. package/dist/backends/browser-use-adapter.js.map +1 -0
  35. package/dist/backends/cdp-backend.d.ts +66 -0
  36. package/dist/backends/cdp-backend.d.ts.map +1 -0
  37. package/dist/backends/cdp-backend.js +273 -0
  38. package/dist/backends/cdp-backend.js.map +1 -0
  39. package/dist/backends/index.d.ts +80 -0
  40. package/dist/backends/index.d.ts.map +1 -0
  41. package/dist/backends/index.js +101 -0
  42. package/dist/backends/index.js.map +1 -0
  43. package/dist/backends/protocol.d.ts +156 -0
  44. package/dist/backends/protocol.d.ts.map +1 -0
  45. package/dist/backends/protocol.js +16 -0
  46. package/dist/backends/protocol.js.map +1 -0
  47. package/dist/backends/sentience-context.d.ts +143 -0
  48. package/dist/backends/sentience-context.d.ts.map +1 -0
  49. package/dist/backends/sentience-context.js +359 -0
  50. package/dist/backends/sentience-context.js.map +1 -0
  51. package/dist/backends/snapshot.d.ts +188 -0
  52. package/dist/backends/snapshot.d.ts.map +1 -0
  53. package/dist/backends/snapshot.js +360 -0
  54. package/dist/backends/snapshot.js.map +1 -0
  55. package/dist/browser.d.ts +154 -0
  56. package/dist/browser.d.ts.map +1 -0
  57. package/dist/browser.js +920 -0
  58. package/dist/browser.js.map +1 -0
  59. package/dist/canonicalization.d.ts +126 -0
  60. package/dist/canonicalization.d.ts.map +1 -0
  61. package/dist/canonicalization.js +161 -0
  62. package/dist/canonicalization.js.map +1 -0
  63. package/dist/captcha/strategies.d.ts +12 -0
  64. package/dist/captcha/strategies.d.ts.map +1 -0
  65. package/dist/captcha/strategies.js +43 -0
  66. package/dist/captcha/strategies.js.map +1 -0
  67. package/dist/captcha/types.d.ts +45 -0
  68. package/dist/captcha/types.d.ts.map +1 -0
  69. package/dist/captcha/types.js +12 -0
  70. package/dist/captcha/types.js.map +1 -0
  71. package/dist/cli.d.ts +5 -0
  72. package/dist/cli.d.ts.map +1 -0
  73. package/dist/cli.js +422 -0
  74. package/dist/cli.js.map +1 -0
  75. package/dist/conversational-agent.d.ts +123 -0
  76. package/dist/conversational-agent.d.ts.map +1 -0
  77. package/dist/conversational-agent.js +341 -0
  78. package/dist/conversational-agent.js.map +1 -0
  79. package/dist/cursor-policy.d.ts +41 -0
  80. package/dist/cursor-policy.d.ts.map +1 -0
  81. package/dist/cursor-policy.js +81 -0
  82. package/dist/cursor-policy.js.map +1 -0
  83. package/dist/debugger.d.ts +28 -0
  84. package/dist/debugger.d.ts.map +1 -0
  85. package/dist/debugger.js +107 -0
  86. package/dist/debugger.js.map +1 -0
  87. package/dist/expect.d.ts +16 -0
  88. package/dist/expect.d.ts.map +1 -0
  89. package/dist/expect.js +67 -0
  90. package/dist/expect.js.map +1 -0
  91. package/dist/failure-artifacts.d.ts +95 -0
  92. package/dist/failure-artifacts.d.ts.map +1 -0
  93. package/dist/failure-artifacts.js +805 -0
  94. package/dist/failure-artifacts.js.map +1 -0
  95. package/dist/generator.d.ts +16 -0
  96. package/dist/generator.d.ts.map +1 -0
  97. package/dist/generator.js +205 -0
  98. package/dist/generator.js.map +1 -0
  99. package/dist/index.d.ts +37 -0
  100. package/dist/index.d.ts.map +1 -0
  101. package/dist/index.js +160 -0
  102. package/dist/index.js.map +1 -0
  103. package/dist/inspector.d.ts +13 -0
  104. package/dist/inspector.d.ts.map +1 -0
  105. package/dist/inspector.js +153 -0
  106. package/dist/inspector.js.map +1 -0
  107. package/dist/llm-provider.d.ts +144 -0
  108. package/dist/llm-provider.d.ts.map +1 -0
  109. package/dist/llm-provider.js +460 -0
  110. package/dist/llm-provider.js.map +1 -0
  111. package/dist/ordinal.d.ts +90 -0
  112. package/dist/ordinal.d.ts.map +1 -0
  113. package/dist/ordinal.js +249 -0
  114. package/dist/ordinal.js.map +1 -0
  115. package/dist/overlay.d.ts +63 -0
  116. package/dist/overlay.d.ts.map +1 -0
  117. package/dist/overlay.js +102 -0
  118. package/dist/overlay.js.map +1 -0
  119. package/dist/protocols/browser-protocol.d.ts +79 -0
  120. package/dist/protocols/browser-protocol.d.ts.map +1 -0
  121. package/dist/protocols/browser-protocol.js +9 -0
  122. package/dist/protocols/browser-protocol.js.map +1 -0
  123. package/dist/query.d.ts +66 -0
  124. package/dist/query.d.ts.map +1 -0
  125. package/dist/query.js +482 -0
  126. package/dist/query.js.map +1 -0
  127. package/dist/read.d.ts +47 -0
  128. package/dist/read.d.ts.map +1 -0
  129. package/dist/read.js +128 -0
  130. package/dist/read.js.map +1 -0
  131. package/dist/recorder.d.ts +44 -0
  132. package/dist/recorder.d.ts.map +1 -0
  133. package/dist/recorder.js +262 -0
  134. package/dist/recorder.js.map +1 -0
  135. package/dist/runtime-agent.d.ts +72 -0
  136. package/dist/runtime-agent.d.ts.map +1 -0
  137. package/dist/runtime-agent.js +357 -0
  138. package/dist/runtime-agent.js.map +1 -0
  139. package/dist/screenshot.d.ts +17 -0
  140. package/dist/screenshot.d.ts.map +1 -0
  141. package/dist/screenshot.js +40 -0
  142. package/dist/screenshot.js.map +1 -0
  143. package/dist/snapshot-diff.d.ts +23 -0
  144. package/dist/snapshot-diff.d.ts.map +1 -0
  145. package/dist/snapshot-diff.js +119 -0
  146. package/dist/snapshot-diff.js.map +1 -0
  147. package/dist/snapshot.d.ts +47 -0
  148. package/dist/snapshot.d.ts.map +1 -0
  149. package/dist/snapshot.js +358 -0
  150. package/dist/snapshot.js.map +1 -0
  151. package/dist/textSearch.d.ts +64 -0
  152. package/dist/textSearch.d.ts.map +1 -0
  153. package/dist/textSearch.js +113 -0
  154. package/dist/textSearch.js.map +1 -0
  155. package/dist/tools/context.d.ts +18 -0
  156. package/dist/tools/context.d.ts.map +1 -0
  157. package/dist/tools/context.js +40 -0
  158. package/dist/tools/context.js.map +1 -0
  159. package/dist/tools/defaults.d.ts +5 -0
  160. package/dist/tools/defaults.d.ts.map +1 -0
  161. package/dist/tools/defaults.js +368 -0
  162. package/dist/tools/defaults.js.map +1 -0
  163. package/dist/tools/filesystem.d.ts +12 -0
  164. package/dist/tools/filesystem.d.ts.map +1 -0
  165. package/dist/tools/filesystem.js +137 -0
  166. package/dist/tools/filesystem.js.map +1 -0
  167. package/dist/tools/index.d.ts +5 -0
  168. package/dist/tools/index.d.ts.map +1 -0
  169. package/dist/tools/index.js +15 -0
  170. package/dist/tools/index.js.map +1 -0
  171. package/dist/tools/registry.d.ts +38 -0
  172. package/dist/tools/registry.d.ts.map +1 -0
  173. package/dist/tools/registry.js +100 -0
  174. package/dist/tools/registry.js.map +1 -0
  175. package/dist/tracing/cloud-sink.d.ts +189 -0
  176. package/dist/tracing/cloud-sink.d.ts.map +1 -0
  177. package/dist/tracing/cloud-sink.js +1067 -0
  178. package/dist/tracing/cloud-sink.js.map +1 -0
  179. package/dist/tracing/index-schema.d.ts +231 -0
  180. package/dist/tracing/index-schema.d.ts.map +1 -0
  181. package/dist/tracing/index-schema.js +235 -0
  182. package/dist/tracing/index-schema.js.map +1 -0
  183. package/dist/tracing/index.d.ts +12 -0
  184. package/dist/tracing/index.d.ts.map +1 -0
  185. package/dist/tracing/index.js +28 -0
  186. package/dist/tracing/index.js.map +1 -0
  187. package/dist/tracing/indexer.d.ts +20 -0
  188. package/dist/tracing/indexer.d.ts.map +1 -0
  189. package/dist/tracing/indexer.js +347 -0
  190. package/dist/tracing/indexer.js.map +1 -0
  191. package/dist/tracing/jsonl-sink.d.ts +51 -0
  192. package/dist/tracing/jsonl-sink.d.ts.map +1 -0
  193. package/dist/tracing/jsonl-sink.js +329 -0
  194. package/dist/tracing/jsonl-sink.js.map +1 -0
  195. package/dist/tracing/sink.d.ts +25 -0
  196. package/dist/tracing/sink.d.ts.map +1 -0
  197. package/dist/tracing/sink.js +15 -0
  198. package/dist/tracing/sink.js.map +1 -0
  199. package/dist/tracing/tracer-factory.d.ts +102 -0
  200. package/dist/tracing/tracer-factory.d.ts.map +1 -0
  201. package/dist/tracing/tracer-factory.js +375 -0
  202. package/dist/tracing/tracer-factory.js.map +1 -0
  203. package/dist/tracing/tracer.d.ts +140 -0
  204. package/dist/tracing/tracer.d.ts.map +1 -0
  205. package/dist/tracing/tracer.js +336 -0
  206. package/dist/tracing/tracer.js.map +1 -0
  207. package/dist/tracing/types.d.ts +203 -0
  208. package/dist/tracing/types.d.ts.map +1 -0
  209. package/dist/tracing/types.js +8 -0
  210. package/dist/tracing/types.js.map +1 -0
  211. package/dist/types.d.ts +422 -0
  212. package/dist/types.d.ts.map +1 -0
  213. package/dist/types.js +6 -0
  214. package/dist/types.js.map +1 -0
  215. package/dist/utils/action-executor.d.ts +25 -0
  216. package/dist/utils/action-executor.d.ts.map +1 -0
  217. package/dist/utils/action-executor.js +121 -0
  218. package/dist/utils/action-executor.js.map +1 -0
  219. package/dist/utils/browser-evaluator.d.ts +76 -0
  220. package/dist/utils/browser-evaluator.d.ts.map +1 -0
  221. package/dist/utils/browser-evaluator.js +130 -0
  222. package/dist/utils/browser-evaluator.js.map +1 -0
  223. package/dist/utils/browser.d.ts +30 -0
  224. package/dist/utils/browser.d.ts.map +1 -0
  225. package/dist/utils/browser.js +75 -0
  226. package/dist/utils/browser.js.map +1 -0
  227. package/dist/utils/element-filter.d.ts +76 -0
  228. package/dist/utils/element-filter.d.ts.map +1 -0
  229. package/dist/utils/element-filter.js +195 -0
  230. package/dist/utils/element-filter.js.map +1 -0
  231. package/dist/utils/grid-utils.d.ts +37 -0
  232. package/dist/utils/grid-utils.d.ts.map +1 -0
  233. package/dist/utils/grid-utils.js +283 -0
  234. package/dist/utils/grid-utils.js.map +1 -0
  235. package/dist/utils/llm-interaction-handler.d.ts +41 -0
  236. package/dist/utils/llm-interaction-handler.d.ts.map +1 -0
  237. package/dist/utils/llm-interaction-handler.js +171 -0
  238. package/dist/utils/llm-interaction-handler.js.map +1 -0
  239. package/dist/utils/llm-response-builder.d.ts +56 -0
  240. package/dist/utils/llm-response-builder.d.ts.map +1 -0
  241. package/dist/utils/llm-response-builder.js +130 -0
  242. package/dist/utils/llm-response-builder.js.map +1 -0
  243. package/dist/utils/selector-utils.d.ts +12 -0
  244. package/dist/utils/selector-utils.d.ts.map +1 -0
  245. package/dist/utils/selector-utils.js +32 -0
  246. package/dist/utils/selector-utils.js.map +1 -0
  247. package/dist/utils/snapshot-event-builder.d.ts +28 -0
  248. package/dist/utils/snapshot-event-builder.d.ts.map +1 -0
  249. package/dist/utils/snapshot-event-builder.js +88 -0
  250. package/dist/utils/snapshot-event-builder.js.map +1 -0
  251. package/dist/utils/snapshot-processor.d.ts +27 -0
  252. package/dist/utils/snapshot-processor.d.ts.map +1 -0
  253. package/dist/utils/snapshot-processor.js +47 -0
  254. package/dist/utils/snapshot-processor.js.map +1 -0
  255. package/dist/utils/trace-event-builder.d.ts +122 -0
  256. package/dist/utils/trace-event-builder.d.ts.map +1 -0
  257. package/dist/utils/trace-event-builder.js +365 -0
  258. package/dist/utils/trace-event-builder.js.map +1 -0
  259. package/dist/utils/trace-file-manager.d.ts +70 -0
  260. package/dist/utils/trace-file-manager.d.ts.map +1 -0
  261. package/dist/utils/trace-file-manager.js +194 -0
  262. package/dist/utils/trace-file-manager.js.map +1 -0
  263. package/dist/utils/zod.d.ts +5 -0
  264. package/dist/utils/zod.d.ts.map +1 -0
  265. package/dist/utils/zod.js +80 -0
  266. package/dist/utils/zod.js.map +1 -0
  267. package/dist/utils.d.ts +8 -0
  268. package/dist/utils.d.ts.map +1 -0
  269. package/dist/utils.js +13 -0
  270. package/dist/utils.js.map +1 -0
  271. package/dist/verification.d.ts +194 -0
  272. package/dist/verification.d.ts.map +1 -0
  273. package/dist/verification.js +530 -0
  274. package/dist/verification.js.map +1 -0
  275. package/dist/vision-executor.d.ts +18 -0
  276. package/dist/vision-executor.d.ts.map +1 -0
  277. package/dist/vision-executor.js +60 -0
  278. package/dist/vision-executor.js.map +1 -0
  279. package/dist/visual-agent.d.ts +120 -0
  280. package/dist/visual-agent.d.ts.map +1 -0
  281. package/dist/visual-agent.js +796 -0
  282. package/dist/visual-agent.js.map +1 -0
  283. package/dist/wait.d.ts +35 -0
  284. package/dist/wait.d.ts.map +1 -0
  285. package/dist/wait.js +76 -0
  286. package/dist/wait.js.map +1 -0
  287. package/package.json +94 -0
  288. package/spec/README.md +72 -0
  289. package/spec/SNAPSHOT_V1.md +208 -0
  290. package/spec/sdk-types.md +259 -0
  291. package/spec/snapshot.schema.json +148 -0
  292. package/src/extension/background.js +104 -0
  293. package/src/extension/content.js +162 -0
  294. package/src/extension/injected_api.js +1399 -0
  295. package/src/extension/manifest.json +36 -0
  296. package/src/extension/pkg/README.md +1340 -0
  297. package/src/extension/pkg/package.json +15 -0
  298. package/src/extension/pkg/sentience_core.d.ts +51 -0
  299. package/src/extension/pkg/sentience_core.js +371 -0
  300. package/src/extension/pkg/sentience_core_bg.wasm +0 -0
  301. package/src/extension/pkg/sentience_core_bg.wasm.d.ts +10 -0
  302. package/src/extension/release.json +116 -0
@@ -0,0 +1,368 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.registerDefaultTools = registerDefaultTools;
4
+ const zod_1 = require("zod");
5
+ const context_1 = require("./context");
6
+ const registry_1 = require("./registry");
7
+ const snapshotSchema = zod_1.z
8
+ .object({
9
+ status: zod_1.z.enum(['success', 'error']),
10
+ url: zod_1.z.string(),
11
+ elements: zod_1.z.array(zod_1.z.any()),
12
+ })
13
+ .passthrough();
14
+ const actionResultSchema = zod_1.z
15
+ .object({
16
+ success: zod_1.z.boolean(),
17
+ duration_ms: zod_1.z.number(),
18
+ outcome: zod_1.z.enum(['navigated', 'dom_updated', 'no_change', 'error']).optional(),
19
+ url_changed: zod_1.z.boolean().optional(),
20
+ snapshot_after: zod_1.z.any().optional(),
21
+ cursor: zod_1.z.record(zod_1.z.any()).optional(),
22
+ error: zod_1.z
23
+ .object({
24
+ code: zod_1.z.string(),
25
+ reason: zod_1.z.string(),
26
+ recovery_hint: zod_1.z.string().optional(),
27
+ })
28
+ .optional(),
29
+ })
30
+ .passthrough();
31
+ const evaluateJsOutput = zod_1.z
32
+ .object({
33
+ ok: zod_1.z.boolean(),
34
+ value: zod_1.z.any().optional(),
35
+ text: zod_1.z.string().nullable().optional(),
36
+ truncated: zod_1.z.boolean().optional(),
37
+ error: zod_1.z.string().nullable().optional(),
38
+ })
39
+ .passthrough();
40
+ const snapshotInput = zod_1.z.object({
41
+ limit: zod_1.z.number().int().min(1).max(500).default(50),
42
+ });
43
+ const clickInput = zod_1.z.object({
44
+ element_id: zod_1.z.number().int().min(1),
45
+ });
46
+ const typeInput = zod_1.z.object({
47
+ element_id: zod_1.z.number().int().min(1),
48
+ text: zod_1.z.string().min(1),
49
+ clear_first: zod_1.z.boolean().default(false),
50
+ });
51
+ const scrollInput = zod_1.z.object({
52
+ delta_y: zod_1.z.number(),
53
+ x: zod_1.z.number().optional(),
54
+ y: zod_1.z.number().optional(),
55
+ });
56
+ const scrollToElementInput = zod_1.z.object({
57
+ element_id: zod_1.z.number().int().min(1),
58
+ behavior: zod_1.z.string().default('instant'),
59
+ block: zod_1.z.string().default('center'),
60
+ });
61
+ const clickRectInput = zod_1.z.object({
62
+ x: zod_1.z.number(),
63
+ y: zod_1.z.number(),
64
+ width: zod_1.z.number().min(0),
65
+ height: zod_1.z.number().min(0),
66
+ });
67
+ const pressInput = zod_1.z.object({
68
+ key: zod_1.z.string().min(1),
69
+ });
70
+ const evaluateJsInput = zod_1.z.object({
71
+ code: zod_1.z.string().min(1).max(8000),
72
+ max_output_chars: zod_1.z.number().int().min(1).max(20000).default(4000),
73
+ truncate: zod_1.z.boolean().default(true),
74
+ });
75
+ const grantPermissionsInput = zod_1.z.object({
76
+ permissions: zod_1.z.array(zod_1.z.string()).min(1),
77
+ origin: zod_1.z.string().optional(),
78
+ });
79
+ const clearPermissionsInput = zod_1.z.object({});
80
+ const setGeolocationInput = zod_1.z.object({
81
+ latitude: zod_1.z.number(),
82
+ longitude: zod_1.z.number(),
83
+ accuracy: zod_1.z.number().optional(),
84
+ });
85
+ function getRuntime(ctx, runtime) {
86
+ if (ctx)
87
+ return ctx.runtime;
88
+ if (runtime instanceof context_1.ToolContext)
89
+ return runtime.runtime;
90
+ if (runtime)
91
+ return runtime;
92
+ throw new Error('ToolContext with runtime is required');
93
+ }
94
+ function buildOutcome(urlBefore, urlAfter, success) {
95
+ const urlChanged = urlBefore !== urlAfter;
96
+ const outcome = urlChanged ? 'navigated' : success ? 'dom_updated' : 'error';
97
+ return { outcome, url_changed: urlChanged };
98
+ }
99
+ function bboxCenter(bbox) {
100
+ return [bbox.x + bbox.width / 2, bbox.y + bbox.height / 2];
101
+ }
102
+ function registerDefaultTools(registry, runtime) {
103
+ registry.register((0, registry_1.defineTool)({
104
+ name: 'snapshot_state',
105
+ description: 'Capture a snapshot of the current page state.',
106
+ input: snapshotInput,
107
+ output: snapshotSchema,
108
+ handler: async (ctx, params) => {
109
+ const runtimeRef = getRuntime(ctx, runtime);
110
+ const snap = await runtimeRef.snapshot({
111
+ limit: params.limit,
112
+ goal: 'tool_snapshot_state',
113
+ });
114
+ if (!snap) {
115
+ throw new Error('snapshot() returned null');
116
+ }
117
+ return snap;
118
+ },
119
+ }));
120
+ registry.register((0, registry_1.defineTool)({
121
+ name: 'click',
122
+ description: 'Click an element by id from the latest snapshot.',
123
+ input: clickInput,
124
+ output: actionResultSchema,
125
+ handler: async (ctx, params) => {
126
+ const runtimeRef = getRuntime(ctx, runtime);
127
+ const page = runtimeRef.page;
128
+ const snap = runtimeRef.lastSnapshot ?? (await runtimeRef.snapshot({ goal: 'tool_click' }));
129
+ if (!snap)
130
+ throw new Error('snapshot() returned null');
131
+ const el = snap.elements.find(e => e.id === params.element_id);
132
+ if (!el)
133
+ throw new Error(`element_id not found: ${params.element_id}`);
134
+ const [x, y] = bboxCenter(el.bbox);
135
+ const start = Date.now();
136
+ const urlBefore = page.url();
137
+ await page.mouse.click(x, y);
138
+ try {
139
+ await page.waitForTimeout(250);
140
+ }
141
+ catch {
142
+ /* best-effort */
143
+ }
144
+ const urlAfter = page.url();
145
+ return {
146
+ success: true,
147
+ duration_ms: Date.now() - start,
148
+ ...buildOutcome(urlBefore, urlAfter, true),
149
+ };
150
+ },
151
+ }));
152
+ registry.register((0, registry_1.defineTool)({
153
+ name: 'type',
154
+ description: 'Type text into an element by id from the latest snapshot.',
155
+ input: typeInput,
156
+ output: actionResultSchema,
157
+ handler: async (ctx, params) => {
158
+ const runtimeRef = getRuntime(ctx, runtime);
159
+ const page = runtimeRef.page;
160
+ const snap = runtimeRef.lastSnapshot ?? (await runtimeRef.snapshot({ goal: 'tool_type' }));
161
+ if (!snap)
162
+ throw new Error('snapshot() returned null');
163
+ const el = snap.elements.find(e => e.id === params.element_id);
164
+ if (!el)
165
+ throw new Error(`element_id not found: ${params.element_id}`);
166
+ const [x, y] = bboxCenter(el.bbox);
167
+ const start = Date.now();
168
+ const urlBefore = page.url();
169
+ await page.mouse.click(x, y);
170
+ if (params.clear_first) {
171
+ const selectAll = process.platform === 'darwin' ? 'Meta+A' : 'Control+A';
172
+ await page.keyboard.press(selectAll);
173
+ await page.keyboard.press('Backspace');
174
+ }
175
+ await page.keyboard.type(params.text);
176
+ const urlAfter = page.url();
177
+ return {
178
+ success: true,
179
+ duration_ms: Date.now() - start,
180
+ ...buildOutcome(urlBefore, urlAfter, true),
181
+ };
182
+ },
183
+ }));
184
+ registry.register((0, registry_1.defineTool)({
185
+ name: 'scroll',
186
+ description: 'Scroll the page by a delta amount.',
187
+ input: scrollInput,
188
+ output: actionResultSchema,
189
+ handler: async (ctx, params) => {
190
+ const runtimeRef = getRuntime(ctx, runtime);
191
+ const page = runtimeRef.page;
192
+ const start = Date.now();
193
+ const urlBefore = page.url();
194
+ try {
195
+ if (page.mouse?.wheel) {
196
+ await page.mouse.wheel(params.x ?? 0, params.delta_y);
197
+ }
198
+ else {
199
+ await page.evaluate(({ dx, dy }) => {
200
+ window.scrollBy(dx || 0, dy || 0);
201
+ }, { dx: params.x ?? 0, dy: params.delta_y });
202
+ }
203
+ }
204
+ catch {
205
+ // best-effort
206
+ }
207
+ const urlAfter = page.url();
208
+ return {
209
+ success: true,
210
+ duration_ms: Date.now() - start,
211
+ ...buildOutcome(urlBefore, urlAfter, true),
212
+ };
213
+ },
214
+ }));
215
+ registry.register((0, registry_1.defineTool)({
216
+ name: 'scroll_to_element',
217
+ description: 'Scroll the page to bring an element into view.',
218
+ input: scrollToElementInput,
219
+ output: actionResultSchema,
220
+ handler: async (ctx, params) => {
221
+ const runtimeRef = getRuntime(ctx, runtime);
222
+ const page = runtimeRef.page;
223
+ const start = Date.now();
224
+ const urlBefore = page.url();
225
+ await page.evaluate(({ id, behavior, block }) => {
226
+ const el = window.sentience_registry?.[id];
227
+ if (el && el.scrollIntoView) {
228
+ el.scrollIntoView({ behavior, block, inline: 'nearest' });
229
+ }
230
+ }, { id: params.element_id, behavior: params.behavior, block: params.block });
231
+ const urlAfter = page.url();
232
+ return {
233
+ success: true,
234
+ duration_ms: Date.now() - start,
235
+ ...buildOutcome(urlBefore, urlAfter, true),
236
+ };
237
+ },
238
+ }));
239
+ registry.register((0, registry_1.defineTool)({
240
+ name: 'click_rect',
241
+ description: 'Click at the center of a rectangle.',
242
+ input: clickRectInput,
243
+ output: actionResultSchema,
244
+ handler: async (ctx, params) => {
245
+ const runtimeRef = getRuntime(ctx, runtime);
246
+ const page = runtimeRef.page;
247
+ const start = Date.now();
248
+ const urlBefore = page.url();
249
+ const x = params.x + params.width / 2;
250
+ const y = params.y + params.height / 2;
251
+ await page.mouse.click(x, y);
252
+ const urlAfter = page.url();
253
+ return {
254
+ success: true,
255
+ duration_ms: Date.now() - start,
256
+ ...buildOutcome(urlBefore, urlAfter, true),
257
+ };
258
+ },
259
+ }));
260
+ registry.register((0, registry_1.defineTool)({
261
+ name: 'press',
262
+ description: 'Press a key (e.g., Enter).',
263
+ input: pressInput,
264
+ output: actionResultSchema,
265
+ handler: async (ctx, params) => {
266
+ const runtimeRef = getRuntime(ctx, runtime);
267
+ const page = runtimeRef.page;
268
+ const start = Date.now();
269
+ const urlBefore = page.url();
270
+ await page.keyboard.press(params.key);
271
+ const urlAfter = page.url();
272
+ return {
273
+ success: true,
274
+ duration_ms: Date.now() - start,
275
+ ...buildOutcome(urlBefore, urlAfter, true),
276
+ };
277
+ },
278
+ }));
279
+ registry.register((0, registry_1.defineTool)({
280
+ name: 'evaluate_js',
281
+ description: 'Execute JavaScript in the browser context.',
282
+ input: evaluateJsInput,
283
+ output: evaluateJsOutput,
284
+ handler: async (ctx, params) => {
285
+ const runtimeRef = getRuntime(ctx, runtime);
286
+ return await runtimeRef.evaluateJs({
287
+ code: params.code,
288
+ max_output_chars: params.max_output_chars,
289
+ truncate: params.truncate,
290
+ });
291
+ },
292
+ }));
293
+ registry.register((0, registry_1.defineTool)({
294
+ name: 'grant_permissions',
295
+ description: 'Grant browser permissions for the current context.',
296
+ input: grantPermissionsInput,
297
+ output: actionResultSchema,
298
+ handler: async (ctx, params) => {
299
+ const runtimeRef = getRuntime(ctx, runtime);
300
+ if (ctx) {
301
+ ctx.require('permissions');
302
+ }
303
+ else if (!runtimeRef.can('permissions')) {
304
+ throw new context_1.UnsupportedCapabilityError('permissions');
305
+ }
306
+ const context = typeof runtimeRef.page?.context === 'function'
307
+ ? runtimeRef.page.context()
308
+ : null;
309
+ if (!context) {
310
+ throw new Error('Permission context unavailable');
311
+ }
312
+ await context.grantPermissions(params.permissions, params.origin);
313
+ return { success: true, duration_ms: 0, outcome: 'dom_updated' };
314
+ },
315
+ }));
316
+ registry.register((0, registry_1.defineTool)({
317
+ name: 'clear_permissions',
318
+ description: 'Clear browser permissions for the current context.',
319
+ input: clearPermissionsInput,
320
+ output: actionResultSchema,
321
+ handler: async (ctx) => {
322
+ const runtimeRef = getRuntime(ctx, runtime);
323
+ if (ctx) {
324
+ ctx.require('permissions');
325
+ }
326
+ else if (!runtimeRef.can('permissions')) {
327
+ throw new context_1.UnsupportedCapabilityError('permissions');
328
+ }
329
+ const context = typeof runtimeRef.page?.context === 'function'
330
+ ? runtimeRef.page.context()
331
+ : null;
332
+ if (!context) {
333
+ throw new Error('Permission context unavailable');
334
+ }
335
+ await context.clearPermissions();
336
+ return { success: true, duration_ms: 0, outcome: 'dom_updated' };
337
+ },
338
+ }));
339
+ registry.register((0, registry_1.defineTool)({
340
+ name: 'set_geolocation',
341
+ description: 'Set geolocation for the current browser context.',
342
+ input: setGeolocationInput,
343
+ output: actionResultSchema,
344
+ handler: async (ctx, params) => {
345
+ const runtimeRef = getRuntime(ctx, runtime);
346
+ if (ctx) {
347
+ ctx.require('permissions');
348
+ }
349
+ else if (!runtimeRef.can('permissions')) {
350
+ throw new context_1.UnsupportedCapabilityError('permissions');
351
+ }
352
+ const context = typeof runtimeRef.page?.context === 'function'
353
+ ? runtimeRef.page.context()
354
+ : null;
355
+ if (!context) {
356
+ throw new Error('Permission context unavailable');
357
+ }
358
+ await context.setGeolocation({
359
+ latitude: params.latitude,
360
+ longitude: params.longitude,
361
+ accuracy: params.accuracy,
362
+ });
363
+ return { success: true, duration_ms: 0, outcome: 'dom_updated' };
364
+ },
365
+ }));
366
+ return registry;
367
+ }
368
+ //# sourceMappingURL=defaults.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/tools/defaults.ts"],"names":[],"mappings":";;AA4HA,oDA4TC;AAxbD,6BAAwB;AAGxB,uCAAoE;AACpE,yCAAsD;AAEtD,MAAM,cAAc,GAAG,OAAC;KACrB,MAAM,CAAC;IACN,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpC,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;IACf,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,GAAG,EAAE,CAAC;CAC3B,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,kBAAkB,GAAG,OAAC;KACzB,MAAM,CAAC;IACN,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9E,WAAW,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnC,cAAc,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,KAAK,EAAE,OAAC;SACL,MAAM,CAAC;QACN,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;QAClB,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACrC,CAAC;SACD,QAAQ,EAAE;CACd,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,gBAAgB,GAAG,OAAC;KACvB,MAAM,CAAC;IACN,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE;IACf,KAAK,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACzB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,aAAa,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACpD,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1B,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,OAAC,CAAC,MAAM,CAAC;IACzB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxB,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACzB,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACvC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9B,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE;IACb,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE;IACb,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1B,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACvB,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACjC,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAClE,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE3C,MAAM,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH,SAAS,UAAU,CAAC,GAAuB,EAAE,OAAoC;IAC/E,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC5B,IAAI,OAAO,YAAY,qBAAW;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC3D,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,YAAY,CACnB,SAAiB,EACjB,QAAgB,EAChB,OAAgB;IAEhB,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC;IAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7E,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,UAAU,CAAC,IAKnB;IACC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,SAAgB,oBAAoB,CAClC,QAAsB,EACtB,OAAoC;IAEpC,QAAQ,CAAC,QAAQ,CACf,IAAA,qBAAU,EAAkD;QAC1D,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,+CAA+C;QAC5D,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAqB,EAAE;YAChD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC;gBACrC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,qBAAqB;aAC5B,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC9C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC,CACH,CAAC;IAEF,QAAQ,CAAC,QAAQ,CACf,IAAA,qBAAU,EAA2D;QACnE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,kDAAkD;QAC/D,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAyB,EAAE;YACpD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;YAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,IAAI,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAC5F,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YACvD,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC;YAC/D,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACvE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC/B,GAAG,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC;aAC3C,CAAC;QACJ,CAAC;KACF,CAAC,CACH,CAAC;IAEF,QAAQ,CAAC,QAAQ,CACf,IAAA,qBAAU,EAIR;QACA,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,2DAA2D;QACxE,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAyB,EAAE;YACpD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;YAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,IAAI,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YAC3F,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YACvD,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC;YAC/D,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACvE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7B,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC;gBACzE,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACrC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC/B,GAAG,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC;aAC3C,CAAC;QACJ,CAAC;KACF,CAAC,CACH,CAAC;IAEF,QAAQ,CAAC,QAAQ,CACf,IAAA,qBAAU,EAAgF;QACxF,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,oCAAoC;QACjD,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAyB,EAAE;YACpD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,IAAI,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;oBACtB,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBACxD,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,CAAC,QAAQ,CACjB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;wBACb,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;oBACpC,CAAC,EACD,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,CAC1C,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC/B,GAAG,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC;aAC3C,CAAC;QACJ,CAAC;KACF,CAAC,CACH,CAAC;IAEF,QAAQ,CAAC,QAAQ,CACf,IAAA,qBAAU,EAIR;QACA,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,gDAAgD;QAC7D,KAAK,EAAE,oBAAoB;QAC3B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAyB,EAAE;YACpD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,QAAQ,CACjB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC1B,MAAM,EAAE,GAAI,MAAc,CAAC,kBAAkB,EAAE,CAAC,EAAE,CAAC,CAAC;gBACpD,IAAI,EAAE,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC;oBAC5B,EAAE,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC,EACD,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAC1E,CAAC;YACF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC/B,GAAG,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC;aAC3C,CAAC;QACJ,CAAC;KACF,CAAC,CACH,CAAC;IAEF,QAAQ,CAAC,QAAQ,CACf,IAAA,qBAAU,EAIR;QACA,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,qCAAqC;QAClD,KAAK,EAAE,cAAc;QACrB,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAyB,EAAE;YACpD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YACvC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC/B,GAAG,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC;aAC3C,CAAC;QACJ,CAAC;KACF,CAAC,CACH,CAAC;IAEF,QAAQ,CAAC,QAAQ,CACf,IAAA,qBAAU,EAAoD;QAC5D,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAyB,EAAE;YACpD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC/B,GAAG,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC;aAC3C,CAAC;QACJ,CAAC;KACF,CAAC,CACH,CAAC;IAEF,QAAQ,CAAC,QAAQ,CACf,IAAA,qBAAU,EAIR;QACA,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,4CAA4C;QACzD,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAA6B,EAAE;YACxD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,MAAM,UAAU,CAAC,UAAU,CAAC;gBACjC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;gBACzC,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CACH,CAAC;IAEF,QAAQ,CAAC,QAAQ,CACf,IAAA,qBAAU,EAA0E;QAClF,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,oDAAoD;QACjE,KAAK,EAAE,qBAAqB;QAC5B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAyB,EAAE;YACpD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC7B,CAAC;iBAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,oCAA0B,CAAC,aAAa,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,OAAO,GACX,OAAQ,UAAU,CAAC,IAAY,EAAE,OAAO,KAAK,UAAU;gBACrD,CAAC,CAAE,UAAU,CAAC,IAAY,CAAC,OAAO,EAAE;gBACpC,CAAC,CAAC,IAAI,CAAC;YACX,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAClE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;QACnE,CAAC;KACF,CAAC,CACH,CAAC;IAEF,QAAQ,CAAC,QAAQ,CACf,IAAA,qBAAU,EAA0E;QAClF,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,oDAAoD;QACjE,KAAK,EAAE,qBAAqB;QAC5B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAyB,EAAE;YAC5C,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC7B,CAAC;iBAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,oCAA0B,CAAC,aAAa,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,OAAO,GACX,OAAQ,UAAU,CAAC,IAAY,EAAE,OAAO,KAAK,UAAU;gBACrD,CAAC,CAAE,UAAU,CAAC,IAAY,CAAC,OAAO,EAAE;gBACpC,CAAC,CAAC,IAAI,CAAC;YACX,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC;YACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;QACnE,CAAC;KACF,CAAC,CACH,CAAC;IAEF,QAAQ,CAAC,QAAQ,CACf,IAAA,qBAAU,EAAwE;QAChF,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,kDAAkD;QAC/D,KAAK,EAAE,mBAAmB;QAC1B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAyB,EAAE;YACpD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC7B,CAAC;iBAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,oCAA0B,CAAC,aAAa,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,OAAO,GACX,OAAQ,UAAU,CAAC,IAAY,EAAE,OAAO,KAAK,UAAU;gBACrD,CAAC,CAAE,UAAU,CAAC,IAAY,CAAC,OAAO,EAAE;gBACpC,CAAC,CAAC,IAAI,CAAC;YACX,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,OAAO,CAAC,cAAc,CAAC;gBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;QACnE,CAAC;KACF,CAAC,CACH,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC"}
@@ -0,0 +1,12 @@
1
+ import { ToolRegistry } from './registry';
2
+ export declare class FileSandbox {
3
+ readonly baseDir: string;
4
+ constructor(baseDir: string);
5
+ private resolvePath;
6
+ readText(relPath: string): string;
7
+ writeText(relPath: string, content: string, overwrite?: boolean): number;
8
+ appendText(relPath: string, content: string): number;
9
+ replaceText(relPath: string, oldText: string, newText: string): number;
10
+ }
11
+ export declare function registerFilesystemTools(registry: ToolRegistry, sandbox?: FileSandbox): ToolRegistry;
12
+ //# sourceMappingURL=filesystem.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/tools/filesystem.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtD,qBAAa,WAAW;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM;IAK3B,OAAO,CAAC,WAAW;IASnB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIjC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,OAAc,GAAG,MAAM;IAU9E,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAOpD,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;CAOvE;AA0CD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,WAAW,GACpB,YAAY,CA2Ed"}
@@ -0,0 +1,137 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.FileSandbox = void 0;
7
+ exports.registerFilesystemTools = registerFilesystemTools;
8
+ const fs_1 = __importDefault(require("fs"));
9
+ const path_1 = __importDefault(require("path"));
10
+ const zod_1 = require("zod");
11
+ const registry_1 = require("./registry");
12
+ class FileSandbox {
13
+ constructor(baseDir) {
14
+ this.baseDir = path_1.default.resolve(baseDir);
15
+ fs_1.default.mkdirSync(this.baseDir, { recursive: true });
16
+ }
17
+ resolvePath(relPath) {
18
+ const candidate = path_1.default.resolve(this.baseDir, relPath);
19
+ const relative = path_1.default.relative(this.baseDir, candidate);
20
+ if (relative.startsWith('..') || path_1.default.isAbsolute(relative)) {
21
+ throw new Error('path escapes sandbox root');
22
+ }
23
+ return candidate;
24
+ }
25
+ readText(relPath) {
26
+ return fs_1.default.readFileSync(this.resolvePath(relPath), 'utf-8');
27
+ }
28
+ writeText(relPath, content, overwrite = true) {
29
+ const target = this.resolvePath(relPath);
30
+ if (fs_1.default.existsSync(target) && !overwrite) {
31
+ throw new Error('file exists and overwrite is false');
32
+ }
33
+ fs_1.default.mkdirSync(path_1.default.dirname(target), { recursive: true });
34
+ fs_1.default.writeFileSync(target, content, 'utf-8');
35
+ return Buffer.byteLength(content, 'utf-8');
36
+ }
37
+ appendText(relPath, content) {
38
+ const target = this.resolvePath(relPath);
39
+ fs_1.default.mkdirSync(path_1.default.dirname(target), { recursive: true });
40
+ fs_1.default.appendFileSync(target, content, 'utf-8');
41
+ return Buffer.byteLength(content, 'utf-8');
42
+ }
43
+ replaceText(relPath, oldText, newText) {
44
+ const target = this.resolvePath(relPath);
45
+ const data = fs_1.default.readFileSync(target, 'utf-8');
46
+ const replaced = data.split(oldText).length - 1;
47
+ fs_1.default.writeFileSync(target, data.split(oldText).join(newText), 'utf-8');
48
+ return replaced;
49
+ }
50
+ }
51
+ exports.FileSandbox = FileSandbox;
52
+ const readFileInput = zod_1.z.object({
53
+ path: zod_1.z.string().min(1),
54
+ });
55
+ const readFileOutput = zod_1.z.object({
56
+ content: zod_1.z.string(),
57
+ });
58
+ const writeFileInput = zod_1.z.object({
59
+ path: zod_1.z.string().min(1),
60
+ content: zod_1.z.string(),
61
+ overwrite: zod_1.z.boolean().default(true),
62
+ });
63
+ const writeFileOutput = zod_1.z.object({
64
+ path: zod_1.z.string(),
65
+ bytes_written: zod_1.z.number(),
66
+ });
67
+ const appendFileInput = zod_1.z.object({
68
+ path: zod_1.z.string().min(1),
69
+ content: zod_1.z.string(),
70
+ });
71
+ const appendFileOutput = zod_1.z.object({
72
+ path: zod_1.z.string(),
73
+ bytes_written: zod_1.z.number(),
74
+ });
75
+ const replaceFileInput = zod_1.z.object({
76
+ path: zod_1.z.string().min(1),
77
+ old: zod_1.z.string(),
78
+ new: zod_1.z.string(),
79
+ });
80
+ const replaceFileOutput = zod_1.z.object({
81
+ path: zod_1.z.string(),
82
+ replaced: zod_1.z.number(),
83
+ });
84
+ function registerFilesystemTools(registry, sandbox) {
85
+ const getFiles = (ctx) => {
86
+ if (ctx)
87
+ return ctx.files;
88
+ if (sandbox)
89
+ return sandbox;
90
+ throw new Error('FileSandbox is required for filesystem tools');
91
+ };
92
+ registry.register((0, registry_1.defineTool)({
93
+ name: 'read_file',
94
+ description: 'Read a file from the sandbox.',
95
+ input: readFileInput,
96
+ output: readFileOutput,
97
+ handler: (ctx, params) => {
98
+ const files = getFiles(ctx);
99
+ return { content: files.readText(params.path) };
100
+ },
101
+ }));
102
+ registry.register((0, registry_1.defineTool)({
103
+ name: 'write_file',
104
+ description: 'Write a file to the sandbox.',
105
+ input: writeFileInput,
106
+ output: writeFileOutput,
107
+ handler: (ctx, params) => {
108
+ const files = getFiles(ctx);
109
+ const bytes = files.writeText(params.path, params.content, params.overwrite);
110
+ return { path: params.path, bytes_written: bytes };
111
+ },
112
+ }));
113
+ registry.register((0, registry_1.defineTool)({
114
+ name: 'append_file',
115
+ description: 'Append text to a file in the sandbox.',
116
+ input: appendFileInput,
117
+ output: appendFileOutput,
118
+ handler: (ctx, params) => {
119
+ const files = getFiles(ctx);
120
+ const bytes = files.appendText(params.path, params.content);
121
+ return { path: params.path, bytes_written: bytes };
122
+ },
123
+ }));
124
+ registry.register((0, registry_1.defineTool)({
125
+ name: 'replace_file',
126
+ description: 'Replace text in a file in the sandbox.',
127
+ input: replaceFileInput,
128
+ output: replaceFileOutput,
129
+ handler: (ctx, params) => {
130
+ const files = getFiles(ctx);
131
+ const replaced = files.replaceText(params.path, params.old, params.new);
132
+ return { path: params.path, replaced };
133
+ },
134
+ }));
135
+ return registry;
136
+ }
137
+ //# sourceMappingURL=filesystem.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../src/tools/filesystem.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ export { ToolRegistry, defineTool } from './registry';
2
+ export { ToolContext, UnsupportedCapabilityError } from './context';
3
+ export { FileSandbox, registerFilesystemTools } from './filesystem';
4
+ export { registerDefaultTools } from './defaults';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.registerDefaultTools = exports.registerFilesystemTools = exports.FileSandbox = exports.UnsupportedCapabilityError = exports.ToolContext = exports.defineTool = exports.ToolRegistry = void 0;
4
+ var registry_1 = require("./registry");
5
+ Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return registry_1.ToolRegistry; } });
6
+ Object.defineProperty(exports, "defineTool", { enumerable: true, get: function () { return registry_1.defineTool; } });
7
+ var context_1 = require("./context");
8
+ Object.defineProperty(exports, "ToolContext", { enumerable: true, get: function () { return context_1.ToolContext; } });
9
+ Object.defineProperty(exports, "UnsupportedCapabilityError", { enumerable: true, get: function () { return context_1.UnsupportedCapabilityError; } });
10
+ var filesystem_1 = require("./filesystem");
11
+ Object.defineProperty(exports, "FileSandbox", { enumerable: true, get: function () { return filesystem_1.FileSandbox; } });
12
+ Object.defineProperty(exports, "registerFilesystemTools", { enumerable: true, get: function () { return filesystem_1.registerFilesystemTools; } });
13
+ var defaults_1 = require("./defaults");
14
+ Object.defineProperty(exports, "registerDefaultTools", { enumerable: true, get: function () { return defaults_1.registerDefaultTools; } });
15
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAAA,uCAAsD;AAA7C,wGAAA,YAAY,OAAA;AAAE,sGAAA,UAAU,OAAA;AACjC,qCAAoE;AAA3D,sGAAA,WAAW,OAAA;AAAE,qHAAA,0BAA0B,OAAA;AAChD,2CAAoE;AAA3D,yGAAA,WAAW,OAAA;AAAE,qHAAA,uBAAuB,OAAA;AAC7C,uCAAkD;AAAzC,gHAAA,oBAAoB,OAAA"}
@@ -0,0 +1,38 @@
1
+ import { ZodTypeAny } from 'zod';
2
+ export type ToolHandler<TInput, TOutput, TContext> = (ctx: TContext | null, params: TInput) => Promise<TOutput> | TOutput;
3
+ export interface ToolSpec<TInput = unknown, TOutput = unknown, TContext = unknown> {
4
+ name: string;
5
+ description?: string;
6
+ input: ZodTypeAny;
7
+ output: ZodTypeAny;
8
+ handler?: ToolHandler<TInput, TOutput, TContext>;
9
+ parameters?: Record<string, any>;
10
+ }
11
+ export declare function defineTool<TInput, TOutput, TContext>(spec: ToolSpec<TInput, TOutput, TContext>): ToolSpec<TInput, TOutput, TContext>;
12
+ export declare class ToolRegistry {
13
+ private tools;
14
+ register<TInput, TOutput, TContext>(spec: ToolSpec<TInput, TOutput, TContext>): ToolRegistry;
15
+ get(name: string): ToolSpec | undefined;
16
+ list(): ToolSpec[];
17
+ llmTools(): Array<{
18
+ name: string;
19
+ description: string;
20
+ parameters: Record<string, any>;
21
+ }>;
22
+ validateInput<TInput>(name: string, payload: unknown): TInput;
23
+ validateOutput<TOutput>(name: string, payload: unknown): TOutput;
24
+ validateCall<TInput>(name: string, payload: unknown): {
25
+ input: TInput;
26
+ spec: ToolSpec;
27
+ };
28
+ execute<TOutput>(name: string, payload: unknown, ctx?: {
29
+ runtime?: {
30
+ tracer?: {
31
+ emit: (...args: any[]) => void;
32
+ };
33
+ stepId?: string | null;
34
+ step_id?: string | null;
35
+ };
36
+ } | null): Promise<TOutput>;
37
+ }
38
+ //# sourceMappingURL=registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAGjC,MAAM,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,IAAI,CACnD,GAAG,EAAE,QAAQ,GAAG,IAAI,EACpB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEhC,MAAM,WAAW,QAAQ,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAClD,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,GACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAErC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA8C;IAE3D,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,YAAY;IAQ5F,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC,IAAI,IAAI,QAAQ,EAAE;IAIlB,QAAQ,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC;IAQzF,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM;IAY7D,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAYhE,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE;IAQjF,OAAO,CAAC,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,GAAG,GAAE;QACH,OAAO,CAAC,EAAE;YACR,MAAM,CAAC,EAAE;gBAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;aAAE,CAAC;YAC5C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SACzB,CAAC;KACH,GAAG,IAAW,GACd,OAAO,CAAC,OAAO,CAAC;CA6CpB"}