swarmbox 0.0.0-stage → 0.12.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/LICENSE +21 -0
- package/README.md +121 -2
- package/dist/checks.d.ts +48 -0
- package/dist/checks.d.ts.map +1 -0
- package/dist/checks.js +43 -0
- package/dist/checks.js.map +1 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +48 -0
- package/dist/cli.js.map +1 -0
- package/dist/control-room/page.d.ts +2 -0
- package/dist/control-room/page.d.ts.map +1 -0
- package/dist/control-room/page.js +212 -0
- package/dist/control-room/page.js.map +1 -0
- package/dist/control-room/server.d.ts +8 -0
- package/dist/control-room/server.d.ts.map +1 -0
- package/dist/control-room/server.js +180 -0
- package/dist/control-room/server.js.map +1 -0
- package/dist/device/device.d.ts +20 -0
- package/dist/device/device.d.ts.map +1 -0
- package/dist/device/device.js +108 -0
- package/dist/device/device.js.map +1 -0
- package/dist/device/props.d.ts +31 -0
- package/dist/device/props.d.ts.map +1 -0
- package/dist/device/props.js +143 -0
- package/dist/device/props.js.map +1 -0
- package/dist/fleet/browser.d.ts +116 -0
- package/dist/fleet/browser.d.ts.map +1 -0
- package/dist/fleet/browser.js +298 -0
- package/dist/fleet/browser.js.map +1 -0
- package/dist/fleet/sight.d.ts +70 -0
- package/dist/fleet/sight.d.ts.map +1 -0
- package/dist/fleet/sight.js +288 -0
- package/dist/fleet/sight.js.map +1 -0
- package/dist/harness.d.ts +258 -0
- package/dist/harness.d.ts.map +1 -0
- package/dist/harness.js +907 -0
- package/dist/harness.js.map +1 -0
- package/dist/hooks.d.ts +69 -0
- package/dist/hooks.d.ts.map +1 -0
- package/dist/hooks.js +80 -0
- package/dist/hooks.js.map +1 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +24 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/device.d.ts +6 -0
- package/dist/mcp/device.d.ts.map +1 -0
- package/dist/mcp/device.js +61 -0
- package/dist/mcp/device.js.map +1 -0
- package/dist/mcp/server.d.ts +15 -0
- package/dist/mcp/server.d.ts.map +1 -0
- package/dist/mcp/server.js +670 -0
- package/dist/mcp/server.js.map +1 -0
- package/dist/mcp/standins.d.ts +11 -0
- package/dist/mcp/standins.d.ts.map +1 -0
- package/dist/mcp/standins.js +142 -0
- package/dist/mcp/standins.js.map +1 -0
- package/dist/product.d.ts +226 -0
- package/dist/product.d.ts.map +1 -0
- package/dist/product.js +10 -0
- package/dist/product.js.map +1 -0
- package/dist/provenance.d.ts +22 -0
- package/dist/provenance.d.ts.map +1 -0
- package/dist/provenance.js +55 -0
- package/dist/provenance.js.map +1 -0
- package/dist/runs/budget.d.ts +23 -0
- package/dist/runs/budget.d.ts.map +1 -0
- package/dist/runs/budget.js +56 -0
- package/dist/runs/budget.js.map +1 -0
- package/dist/runs/report.d.ts +3 -0
- package/dist/runs/report.d.ts.map +1 -0
- package/dist/runs/report.js +125 -0
- package/dist/runs/report.js.map +1 -0
- package/dist/runs/run.d.ts +86 -0
- package/dist/runs/run.d.ts.map +1 -0
- package/dist/runs/run.js +227 -0
- package/dist/runs/run.js.map +1 -0
- package/dist/scenarios/spec.d.ts +33 -0
- package/dist/scenarios/spec.d.ts.map +1 -0
- package/dist/scenarios/spec.js +89 -0
- package/dist/scenarios/spec.js.map +1 -0
- package/dist/serve.d.ts +31 -0
- package/dist/serve.d.ts.map +1 -0
- package/dist/serve.js +39 -0
- package/dist/serve.js.map +1 -0
- package/dist/standins/builtin/email/index.d.ts +2 -0
- package/dist/standins/builtin/email/index.d.ts.map +1 -0
- package/dist/standins/builtin/email/index.js +213 -0
- package/dist/standins/builtin/email/index.js.map +1 -0
- package/dist/standins/builtin/email/manifest.json +41 -0
- package/dist/standins/builtin/expo-push/index.d.ts +2 -0
- package/dist/standins/builtin/expo-push/index.d.ts.map +1 -0
- package/dist/standins/builtin/expo-push/index.js +203 -0
- package/dist/standins/builtin/expo-push/index.js.map +1 -0
- package/dist/standins/builtin/expo-push/manifest.json +45 -0
- package/dist/standins/builtin/helcim/index.d.ts +7 -0
- package/dist/standins/builtin/helcim/index.d.ts.map +1 -0
- package/dist/standins/builtin/helcim/index.js +438 -0
- package/dist/standins/builtin/helcim/index.js.map +1 -0
- package/dist/standins/builtin/helcim/manifest.json +37 -0
- package/dist/standins/builtin/index.d.ts +8 -0
- package/dist/standins/builtin/index.d.ts.map +1 -0
- package/dist/standins/builtin/index.js +22 -0
- package/dist/standins/builtin/index.js.map +1 -0
- package/dist/standins/builtin/s3/checksums.d.ts +8 -0
- package/dist/standins/builtin/s3/checksums.d.ts.map +1 -0
- package/dist/standins/builtin/s3/checksums.js +67 -0
- package/dist/standins/builtin/s3/checksums.js.map +1 -0
- package/dist/standins/builtin/s3/index.d.ts +6 -0
- package/dist/standins/builtin/s3/index.d.ts.map +1 -0
- package/dist/standins/builtin/s3/index.js +688 -0
- package/dist/standins/builtin/s3/index.js.map +1 -0
- package/dist/standins/builtin/s3/manifest.json +35 -0
- package/dist/standins/builtin/twilio/index.d.ts +10 -0
- package/dist/standins/builtin/twilio/index.d.ts.map +1 -0
- package/dist/standins/builtin/twilio/index.js +477 -0
- package/dist/standins/builtin/twilio/index.js.map +1 -0
- package/dist/standins/builtin/twilio/manifest.json +133 -0
- package/dist/standins/guard.d.ts +16 -0
- package/dist/standins/guard.d.ts.map +1 -0
- package/dist/standins/guard.js +78 -0
- package/dist/standins/guard.js.map +1 -0
- package/dist/standins/manifest.d.ts +94 -0
- package/dist/standins/manifest.d.ts.map +1 -0
- package/dist/standins/manifest.js +121 -0
- package/dist/standins/manifest.js.map +1 -0
- package/dist/standins/protocol.d.ts +114 -0
- package/dist/standins/protocol.d.ts.map +1 -0
- package/dist/standins/protocol.js +11 -0
- package/dist/standins/protocol.js.map +1 -0
- package/dist/standins/runner.d.ts +78 -0
- package/dist/standins/runner.d.ts.map +1 -0
- package/dist/standins/runner.js +746 -0
- package/dist/standins/runner.js.map +1 -0
- package/dist/standins/sdk.d.ts +73 -0
- package/dist/standins/sdk.d.ts.map +1 -0
- package/dist/standins/sdk.js +217 -0
- package/dist/standins/sdk.js.map +1 -0
- package/dist/standins/shape.d.ts +25 -0
- package/dist/standins/shape.d.ts.map +1 -0
- package/dist/standins/shape.js +131 -0
- package/dist/standins/shape.js.map +1 -0
- package/dist/time.d.ts +12 -0
- package/dist/time.d.ts.map +1 -0
- package/dist/time.js +64 -0
- package/dist/time.js.map +1 -0
- package/package.json +71 -4
|
@@ -0,0 +1,288 @@
|
|
|
1
|
+
// What an agent needs to see on a screen that a person sees at a glance (on the first long run, a "Send
|
|
2
|
+
// estimate" dialog was open the whole time and the agent never knew).
|
|
3
|
+
//
|
|
4
|
+
// A screen is read as its accessibility tree, cut at a limit. Apps draw their dialogs at the end of the
|
|
5
|
+
// page, so on a long page the one thing a person can use, the open dialog, was what got cut. Here:
|
|
6
|
+
// open dialogs come first and whole; an action says what it changed (a dialog opened or closed, a status
|
|
7
|
+
// line, the address); a click that can't land says what is in the way; and when two controls share a name,
|
|
8
|
+
// the one in the open dialog is the one meant.
|
|
9
|
+
/** Dialogs, open and showing: `<dialog open>` and anything with a dialog role. */
|
|
10
|
+
const DIALOGS = 'dialog[open], [role="dialog"], [role="alertdialog"]';
|
|
11
|
+
/** What a page says without being asked: status lines, alerts, live regions. */
|
|
12
|
+
const LIVE = '[role="status"], [role="alert"], [aria-live="polite"], [aria-live="assertive"], output';
|
|
13
|
+
/** A whole dialog is kept even on a long page; past this it is cut, and says so. */
|
|
14
|
+
const DIALOG_LIMIT = 20_000;
|
|
15
|
+
/** In the page: a dialog's name as a person would say it, and whether it holds the screen. */
|
|
16
|
+
function describeDialogs(els) {
|
|
17
|
+
const text = (e) => (e?.textContent ?? '').replace(/\s+/g, ' ').trim();
|
|
18
|
+
return els.map((el) => {
|
|
19
|
+
const labelled = el.getAttribute('aria-labelledby');
|
|
20
|
+
const byId = labelled
|
|
21
|
+
? labelled
|
|
22
|
+
.split(/\s+/)
|
|
23
|
+
.map((id) => text(document.getElementById(id)))
|
|
24
|
+
.join(' ')
|
|
25
|
+
.trim()
|
|
26
|
+
: '';
|
|
27
|
+
const heading = el.querySelector('h1, h2, h3, h4, [role="heading"]');
|
|
28
|
+
const title = el.getAttribute('aria-label') || byId || text(heading) || text(el).slice(0, 60);
|
|
29
|
+
const style = getComputedStyle(el);
|
|
30
|
+
const box = el.getBoundingClientRect();
|
|
31
|
+
return {
|
|
32
|
+
title,
|
|
33
|
+
modal: el.matches(':modal') || el.getAttribute('aria-modal') === 'true',
|
|
34
|
+
visible: style.visibility !== 'hidden' && style.display !== 'none' && box.width > 0 && box.height > 0,
|
|
35
|
+
};
|
|
36
|
+
});
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* The dialogs a person can see, the ones holding the screen first, the most recently opened (latest in
|
|
40
|
+
* the page) first among those.
|
|
41
|
+
*/
|
|
42
|
+
export async function openDialogs(page) {
|
|
43
|
+
const all = page.locator(DIALOGS);
|
|
44
|
+
const info = await all.evaluateAll(describeDialogs);
|
|
45
|
+
const shown = info.map((d, i) => ({ ...d, i })).filter((d) => d.visible);
|
|
46
|
+
// A dialog inside another (a confirm inside a drawer) shows in its parent's tree too; that's fine.
|
|
47
|
+
shown.sort((a, b) => Number(b.modal) - Number(a.modal) || b.i - a.i);
|
|
48
|
+
const out = [];
|
|
49
|
+
for (const d of shown) {
|
|
50
|
+
const tree = await all
|
|
51
|
+
.nth(d.i)
|
|
52
|
+
.ariaSnapshot({ timeout: 5_000 })
|
|
53
|
+
.catch(() => '');
|
|
54
|
+
out.push({
|
|
55
|
+
title: d.title,
|
|
56
|
+
modal: d.modal,
|
|
57
|
+
tree: tree.length > DIALOG_LIMIT
|
|
58
|
+
? `${tree.slice(0, DIALOG_LIMIT)}\n… (${tree.length - DIALOG_LIMIT} more characters)`
|
|
59
|
+
: tree,
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
return out;
|
|
63
|
+
}
|
|
64
|
+
/** The dialogs, written for the top of a read: what can be used right now. */
|
|
65
|
+
export function dialogsText(dialogs) {
|
|
66
|
+
if (!dialogs.length)
|
|
67
|
+
return '';
|
|
68
|
+
const modal = dialogs.find((d) => d.modal);
|
|
69
|
+
const lines = dialogs.map((d) => {
|
|
70
|
+
const head = d === modal
|
|
71
|
+
? `OPEN DIALOG "${d.title}" (modal: only this can be used until it closes)`
|
|
72
|
+
: `open ${d.modal ? 'modal dialog' : 'panel'} "${d.title}"`;
|
|
73
|
+
return `${head}\n${d.tree}`;
|
|
74
|
+
});
|
|
75
|
+
return `${lines.join('\n')}\n--- the page${modal ? ' behind it' : ''} ---`;
|
|
76
|
+
}
|
|
77
|
+
export async function glance(page) {
|
|
78
|
+
const [info, said] = await Promise.all([
|
|
79
|
+
page.locator(DIALOGS).evaluateAll(describeDialogs),
|
|
80
|
+
page.locator(LIVE).evaluateAll((els) => els
|
|
81
|
+
.filter((e) => {
|
|
82
|
+
const b = e.getBoundingClientRect();
|
|
83
|
+
return b.width > 0 && b.height > 0 && getComputedStyle(e).visibility !== 'hidden';
|
|
84
|
+
})
|
|
85
|
+
// innerText, as laid out: textContent runs "1:05 p.m." into the next line's "Lakeside".
|
|
86
|
+
.map((e) => (e.innerText ?? e.textContent ?? '').replace(/\s+/g, ' ').trim())
|
|
87
|
+
.filter((t) => t.length > 0)),
|
|
88
|
+
]);
|
|
89
|
+
return {
|
|
90
|
+
url: page.url(),
|
|
91
|
+
dialogs: info.filter((d) => d.visible).map((d) => (d.modal ? `${d.title} (modal)` : d.title)),
|
|
92
|
+
said: [...new Set(said)].map((t) => (t.length > 200 ? `${t.slice(0, 200)}…` : t)),
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
/** Lines saying what moved between two glances; empty when nothing a person would notice did. */
|
|
96
|
+
export function changes(before, after) {
|
|
97
|
+
const lines = [];
|
|
98
|
+
const gone = (a, b) => a.filter((x) => !b.includes(x));
|
|
99
|
+
for (const d of gone(after.dialogs, before.dialogs))
|
|
100
|
+
lines.push(`dialog opened: "${d}"`);
|
|
101
|
+
for (const d of gone(before.dialogs, after.dialogs))
|
|
102
|
+
lines.push(`dialog closed: "${d}"`);
|
|
103
|
+
for (const t of gone(after.said, before.said))
|
|
104
|
+
lines.push(`says: "${t}"`);
|
|
105
|
+
if (before.url !== after.url)
|
|
106
|
+
lines.push(`address: ${pathOf(before.url)} → ${pathOf(after.url)}`);
|
|
107
|
+
return lines;
|
|
108
|
+
}
|
|
109
|
+
/** A web address without its origin, which never changes on a screen; anything else as it is. */
|
|
110
|
+
const pathOf = (u) => {
|
|
111
|
+
try {
|
|
112
|
+
const x = new URL(u);
|
|
113
|
+
return x.protocol === 'http:' || x.protocol === 'https:' ? `${x.pathname}${x.search}${x.hash}` : u;
|
|
114
|
+
}
|
|
115
|
+
catch {
|
|
116
|
+
return u;
|
|
117
|
+
}
|
|
118
|
+
};
|
|
119
|
+
/**
|
|
120
|
+
* Of several controls an action's words match, the one meant: the only one in the dialog in front.
|
|
121
|
+
* Dialogs stack (a job's panel, then "Send estimate" over it), and only the one in front can be used:
|
|
122
|
+
* the innermost of the open modal ones, the latest opened among equals. Null when that doesn't settle
|
|
123
|
+
* it, with each match described for the agent to pick by index.
|
|
124
|
+
*/
|
|
125
|
+
export async function pickAmong(matches, count) {
|
|
126
|
+
const { top, info } = await matches.evaluateAll((els) => {
|
|
127
|
+
// Repeated in behindModal: a function handed to the page can't call one of ours.
|
|
128
|
+
const name = (d) => d.getAttribute('aria-label') ||
|
|
129
|
+
(d.querySelector('h1, h2, h3, h4, [role="heading"]')?.textContent ?? '').replace(/\s+/g, ' ').trim();
|
|
130
|
+
const modals = [...document.querySelectorAll('dialog, [aria-modal="true"]')].filter((d) => d.matches(':modal') || d.getAttribute('aria-modal') === 'true');
|
|
131
|
+
const front = modals.filter((m) => !modals.some((o) => o !== m && m.contains(o))).at(-1) ?? null;
|
|
132
|
+
return {
|
|
133
|
+
top: front ? name(front) : null,
|
|
134
|
+
info: els.map((el) => {
|
|
135
|
+
const d = el.closest('dialog, [role="dialog"], [role="alertdialog"]');
|
|
136
|
+
const b = el.getBoundingClientRect();
|
|
137
|
+
// What a pointer at its middle would land on: itself (or its own label), or something over it,
|
|
138
|
+
// such as the scrim a non-modal layer puts over the page behind it.
|
|
139
|
+
const hit = document.elementFromPoint(b.left + b.width / 2, b.top + b.height / 2);
|
|
140
|
+
const label = hit?.closest('label');
|
|
141
|
+
return {
|
|
142
|
+
dialog: d ? name(d) : null,
|
|
143
|
+
inFront: Boolean(front?.contains(el)),
|
|
144
|
+
visible: b.width > 0 && b.height > 0,
|
|
145
|
+
onTop: Boolean(hit && (el.contains(hit) || label?.contains(el) || label?.control === el)),
|
|
146
|
+
};
|
|
147
|
+
}),
|
|
148
|
+
};
|
|
149
|
+
});
|
|
150
|
+
const each = info.map((m, i) => ({ ...m, i }));
|
|
151
|
+
if (top !== null) {
|
|
152
|
+
const usable = each.filter((m) => m.inFront && m.visible);
|
|
153
|
+
if (usable.length === 1)
|
|
154
|
+
return { index: usable[0].i, why: `the one in dialog "${top}"` };
|
|
155
|
+
}
|
|
156
|
+
else {
|
|
157
|
+
const visible = each.filter((m) => m.visible);
|
|
158
|
+
if (visible.length === 1 && count > 1)
|
|
159
|
+
return { index: visible[0].i, why: 'the only one showing; the others are hidden' };
|
|
160
|
+
// Layers that don't say they are modal (a panel, then a dialog over it with a scrim): the one not covered.
|
|
161
|
+
const onTop = visible.filter((m) => m.onTop);
|
|
162
|
+
if (onTop.length === 1 && visible.length > 1)
|
|
163
|
+
return { index: onTop[0].i, why: 'the only one not covered by another layer' };
|
|
164
|
+
}
|
|
165
|
+
return {
|
|
166
|
+
index: null,
|
|
167
|
+
described: each.map((m) => `${m.i}: ${m.dialog ? `in "${m.dialog}"` : 'on the page'}${m.visible ? '' : ', hidden'}` +
|
|
168
|
+
`${top !== null && !m.inFront ? `, behind the dialog "${top}"` : ''}` +
|
|
169
|
+
`${m.visible && !m.onTop ? ', covered' : ''}`),
|
|
170
|
+
};
|
|
171
|
+
}
|
|
172
|
+
/** When the element is behind the modal dialog in front, that dialog's title: a click there can't land. */
|
|
173
|
+
export async function behindModal(el) {
|
|
174
|
+
return el
|
|
175
|
+
.evaluate((e) => {
|
|
176
|
+
const name = (d) => d.getAttribute('aria-label') ||
|
|
177
|
+
(d.querySelector('h1, h2, h3, h4, [role="heading"]')?.textContent ?? '').replace(/\s+/g, ' ').trim();
|
|
178
|
+
const modals = [...document.querySelectorAll('dialog, [aria-modal="true"]')].filter((d) => d.matches(':modal') || d.getAttribute('aria-modal') === 'true');
|
|
179
|
+
const front = modals.filter((m) => !modals.some((o) => o !== m && m.contains(o))).at(-1);
|
|
180
|
+
if (!front || front.contains(e))
|
|
181
|
+
return null;
|
|
182
|
+
return name(front) || 'a dialog';
|
|
183
|
+
})
|
|
184
|
+
.catch(() => null);
|
|
185
|
+
}
|
|
186
|
+
/** Why a click failed, in a sentence, from Playwright's log of what it tried. */
|
|
187
|
+
export function whyNotClicked(e) {
|
|
188
|
+
// Playwright colours its call log for a terminal; the codes would split every line we look for.
|
|
189
|
+
// eslint-disable-next-line no-control-regex
|
|
190
|
+
const msg = String(e?.message ?? e).replace(/\u001b\[[0-9;]*m/g, '');
|
|
191
|
+
const over = /\n\s*-\s*(<[^\n]+?)\s+(?:from <[^\n]+?>\s+subtree\s+)?intercepts pointer events/.exec(msg);
|
|
192
|
+
if (over)
|
|
193
|
+
return `something is in front of it: ${over[1].slice(0, 200)}`;
|
|
194
|
+
if (/element is not enabled|element is disabled/.test(msg))
|
|
195
|
+
return 'it is disabled';
|
|
196
|
+
if (/element is not visible/.test(msg))
|
|
197
|
+
return 'it is not showing';
|
|
198
|
+
if (/element is not stable/.test(msg))
|
|
199
|
+
return 'it kept moving (an animation that did not finish)';
|
|
200
|
+
if (/Timeout \d+ms exceeded/.test(msg))
|
|
201
|
+
return 'it never became clickable within 10 s';
|
|
202
|
+
return msg.split('\n')[0].slice(0, 300);
|
|
203
|
+
}
|
|
204
|
+
/**
|
|
205
|
+
* Whether what is in front of a control is its own label: a styled radio or checkbox draws its label (or a
|
|
206
|
+
* box inside it) over the real input, and a person clicks that. Clicking the label is then the same click.
|
|
207
|
+
*/
|
|
208
|
+
export async function coveredByOwnLabel(el) {
|
|
209
|
+
return el
|
|
210
|
+
.evaluate((n) => {
|
|
211
|
+
const b = n.getBoundingClientRect();
|
|
212
|
+
const hit = document.elementFromPoint(b.left + b.width / 2, b.top + b.height / 2);
|
|
213
|
+
const label = hit?.closest('label');
|
|
214
|
+
return Boolean(label && (label.contains(n) || label.control === n));
|
|
215
|
+
})
|
|
216
|
+
.catch(() => false);
|
|
217
|
+
}
|
|
218
|
+
/** A signature-like scribble, for a pad that only needs one. */
|
|
219
|
+
export const SIGNATURE = [
|
|
220
|
+
[
|
|
221
|
+
[0.08, 0.62],
|
|
222
|
+
[0.14, 0.3],
|
|
223
|
+
[0.2, 0.7],
|
|
224
|
+
[0.27, 0.35],
|
|
225
|
+
[0.33, 0.66],
|
|
226
|
+
[0.4, 0.42],
|
|
227
|
+
[0.48, 0.6],
|
|
228
|
+
],
|
|
229
|
+
[
|
|
230
|
+
[0.52, 0.55],
|
|
231
|
+
[0.6, 0.32],
|
|
232
|
+
[0.66, 0.68],
|
|
233
|
+
[0.74, 0.4],
|
|
234
|
+
[0.82, 0.58],
|
|
235
|
+
[0.9, 0.45],
|
|
236
|
+
],
|
|
237
|
+
];
|
|
238
|
+
/** Draws strokes on an element with the pointer, as a finger or a mouse would: down, moves, up. */
|
|
239
|
+
export async function draw(page, el, strokes = SIGNATURE) {
|
|
240
|
+
await el.scrollIntoViewIfNeeded({ timeout: 10_000 });
|
|
241
|
+
const box = await el.boundingBox({ timeout: 10_000 });
|
|
242
|
+
if (!box)
|
|
243
|
+
throw new Error('it has no size on screen');
|
|
244
|
+
const at = ([x, y]) => ({ x: box.x + x * box.width, y: box.y + y * box.height });
|
|
245
|
+
for (const stroke of strokes) {
|
|
246
|
+
if (!stroke.length)
|
|
247
|
+
continue;
|
|
248
|
+
const first = at(stroke[0]);
|
|
249
|
+
await page.mouse.move(first.x, first.y);
|
|
250
|
+
await page.mouse.down();
|
|
251
|
+
for (const p of stroke.slice(1)) {
|
|
252
|
+
const q = at(p);
|
|
253
|
+
await page.mouse.move(q.x, q.y, { steps: 6 });
|
|
254
|
+
}
|
|
255
|
+
await page.mouse.up();
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
* Drags with the pointer, as a person would: press at a point on the element (fractions of its box), move
|
|
260
|
+
* a little first (a drag library starts a drag only once the pointer has moved), then on to the drop in small
|
|
261
|
+
* steps, pause over it (a drop target answers hovering), and let go. Both ends must be on screen.
|
|
262
|
+
*/
|
|
263
|
+
export async function drag(page, el, grab, to) {
|
|
264
|
+
await el.scrollIntoViewIfNeeded({ timeout: 10_000 });
|
|
265
|
+
const box = await el.boundingBox({ timeout: 10_000 });
|
|
266
|
+
if (!box)
|
|
267
|
+
throw new Error('it has no size on screen');
|
|
268
|
+
const from = { x: box.x + grab[0] * box.width, y: box.y + grab[1] * box.height };
|
|
269
|
+
let dest;
|
|
270
|
+
if ('by' in to)
|
|
271
|
+
dest = { x: from.x + to.by.x, y: from.y + to.by.y };
|
|
272
|
+
else {
|
|
273
|
+
const b = await to.el.boundingBox({ timeout: 10_000 });
|
|
274
|
+
if (!b)
|
|
275
|
+
throw new Error('where it goes has no size on screen');
|
|
276
|
+
dest = { x: b.x + to.at[0] * b.width, y: b.y + to.at[1] * b.height };
|
|
277
|
+
}
|
|
278
|
+
const view = page.viewportSize();
|
|
279
|
+
if (view && (dest.x < 0 || dest.y < 0 || dest.x > view.width || dest.y > view.height))
|
|
280
|
+
throw new Error(`the drop point (${Math.round(dest.x)}, ${Math.round(dest.y)}) is off the screen (${view.width}×${view.height}); scroll or drag in steps`);
|
|
281
|
+
await page.mouse.move(from.x, from.y);
|
|
282
|
+
await page.mouse.down();
|
|
283
|
+
await page.mouse.move(from.x + 6, from.y, { steps: 3 });
|
|
284
|
+
await page.mouse.move(dest.x, dest.y, { steps: 24 });
|
|
285
|
+
await page.waitForTimeout(150);
|
|
286
|
+
await page.mouse.up();
|
|
287
|
+
}
|
|
288
|
+
//# sourceMappingURL=sight.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sight.js","sourceRoot":"","sources":["../../src/fleet/sight.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,258 @@
|
|
|
1
|
+
import type { CDPSession } from 'playwright-core';
|
|
2
|
+
import type { CheckResult, Settled } from './checks.ts';
|
|
3
|
+
import { type Appearance, type Fleet, type Screen } from './fleet/browser.ts';
|
|
4
|
+
import { type Stroke } from './fleet/sight.ts';
|
|
5
|
+
import type { ClockMove, ClockState, FeedItem, Hooks } from './hooks.ts';
|
|
6
|
+
import type { Persona, Product, ProductWorld, WorldSpec } from './product.ts';
|
|
7
|
+
import { type StandIn } from './standins/runner.ts';
|
|
8
|
+
import { type DeviceState } from './device/device.ts';
|
|
9
|
+
import { type Prop, type PropKind } from './device/props.ts';
|
|
10
|
+
export type Controller = 'agent' | 'person';
|
|
11
|
+
export interface WorldEntry<W extends ProductWorld = ProductWorld> {
|
|
12
|
+
id: string;
|
|
13
|
+
spec: WorldSpec;
|
|
14
|
+
world: W;
|
|
15
|
+
fleet: Fleet;
|
|
16
|
+
createdAt: Date;
|
|
17
|
+
/** Sandbox time, once the world's clock has been moved: screens' browsers follow it. Null at rest. */
|
|
18
|
+
clock: {
|
|
19
|
+
at: string;
|
|
20
|
+
paused: boolean;
|
|
21
|
+
} | null;
|
|
22
|
+
/** Where each tenant's feed has been read to, so an action reports what happened after it, only. */
|
|
23
|
+
feedAt: Map<string, string>;
|
|
24
|
+
/** The world's stand-ins, by name. */
|
|
25
|
+
standins: Map<string, StandIn>;
|
|
26
|
+
}
|
|
27
|
+
export interface ScreenEntry {
|
|
28
|
+
id: string;
|
|
29
|
+
worldId: string;
|
|
30
|
+
/** For a customer's screen, a stand-in: the tenant, and "Customer (link)" as who. */
|
|
31
|
+
persona: Persona;
|
|
32
|
+
/** Opened at a customer's link, with no sign-in (openLink). */
|
|
33
|
+
customer: boolean;
|
|
34
|
+
/** The app it was opened in; undefined for the product's main one. */
|
|
35
|
+
app: string | undefined;
|
|
36
|
+
screen: Screen;
|
|
37
|
+
controller: Controller;
|
|
38
|
+
cdp: CDPSession;
|
|
39
|
+
/** The most recent screencast frame, JPEG. Undefined until the first frame arrives. */
|
|
40
|
+
frame: Buffer | undefined;
|
|
41
|
+
/** Counts frames, so the control room fetches a picture only when there is a new one. */
|
|
42
|
+
frameSeq: number;
|
|
43
|
+
/** Called with each new frame: the control room's live streams. */
|
|
44
|
+
watchers: Set<(frame: Buffer) => void>;
|
|
45
|
+
/** What the screen's browser reported going wrong, newest last (bounded). */
|
|
46
|
+
signals: Signal[];
|
|
47
|
+
/** Whether this screen's browser clock follows the world's (once the world's clock has moved). */
|
|
48
|
+
clockInstalled?: boolean;
|
|
49
|
+
network: NetworkMode;
|
|
50
|
+
/** Cut off every request the screen's network is holding (a stall), as a dropped connection does. */
|
|
51
|
+
releaseStalled(): void;
|
|
52
|
+
/** Its camera and the files queued for its file choosers. */
|
|
53
|
+
device: DeviceState;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Something a screen's browser saw go wrong without anyone asking: an error in the console or an uncaught
|
|
57
|
+
* one, a server error, a request that failed. Collected on every screen from its first request; a run's
|
|
58
|
+
* report lists the ones from its own time.
|
|
59
|
+
*/
|
|
60
|
+
export interface Signal {
|
|
61
|
+
at: string;
|
|
62
|
+
screen: string;
|
|
63
|
+
/** device: something the device couldn't do for the app, e.g. a file chooser with nothing put in it. */
|
|
64
|
+
kind: 'console-error' | 'page-error' | 'server-error' | 'request-failed' | 'device';
|
|
65
|
+
text: string;
|
|
66
|
+
url?: string;
|
|
67
|
+
}
|
|
68
|
+
export type NetworkMode = {
|
|
69
|
+
mode: 'online';
|
|
70
|
+
} | {
|
|
71
|
+
mode: 'offline';
|
|
72
|
+
}
|
|
73
|
+
/** Matching requests get no answer and no error, until the screen is set online again. */
|
|
74
|
+
| {
|
|
75
|
+
mode: 'stall';
|
|
76
|
+
match: string;
|
|
77
|
+
}
|
|
78
|
+
/** Matching requests are answered late. */
|
|
79
|
+
| {
|
|
80
|
+
mode: 'slow';
|
|
81
|
+
match: string;
|
|
82
|
+
delayMs: number;
|
|
83
|
+
};
|
|
84
|
+
export interface HarnessOptions {
|
|
85
|
+
/** Headed by default: the screens are meant to be watched and taken over. */
|
|
86
|
+
headless?: boolean;
|
|
87
|
+
/** Slows every browser action, so a person can follow along. */
|
|
88
|
+
slowMo?: number;
|
|
89
|
+
/** Stand-ins run in the operating-system sandbox; "off" only for Swarmbox's own tests where there is none. */
|
|
90
|
+
standinSandbox?: 'required' | 'off';
|
|
91
|
+
}
|
|
92
|
+
/** A refusal the caller can show as-is: wrong arguments, a screen someone else has, and so on. */
|
|
93
|
+
export declare class HarnessError extends Error {
|
|
94
|
+
}
|
|
95
|
+
export interface OpenScreenOptions extends Appearance {
|
|
96
|
+
address?: string;
|
|
97
|
+
/** One of the product's apps (Product.apps); default its main one. */
|
|
98
|
+
app?: string;
|
|
99
|
+
}
|
|
100
|
+
export interface Harness<W extends ProductWorld = ProductWorld> {
|
|
101
|
+
readonly product: Product<W>;
|
|
102
|
+
createWorld(spec?: Partial<WorldSpec>): Promise<WorldEntry<W>>;
|
|
103
|
+
/** A full rebuild: the same spec on the same port. */
|
|
104
|
+
resetWorld(worldId: string): Promise<WorldEntry<W>>;
|
|
105
|
+
destroyWorld(worldId: string): Promise<void>;
|
|
106
|
+
worlds(): WorldEntry<W>[];
|
|
107
|
+
world(worldId: string): WorldEntry<W>;
|
|
108
|
+
people(worldId: string): Promise<Persona[]>;
|
|
109
|
+
openScreen(worldId: string, personId: string, path?: string, options?: OpenScreenOptions): Promise<ScreenEntry>;
|
|
110
|
+
/**
|
|
111
|
+
* Open a customer's link (an estimate, an invoice, an invitation) as the customer would: a browser with no
|
|
112
|
+
* sign-in, on the tenant's own host. The full link or just its path.
|
|
113
|
+
*/
|
|
114
|
+
openLink(worldId: string, link: string, options?: Appearance & {
|
|
115
|
+
address?: string;
|
|
116
|
+
}): Promise<ScreenEntry>;
|
|
117
|
+
/** Change what a screen's network does: airplane mode, a signal that stalls, a slow one, or back to normal. */
|
|
118
|
+
setNetwork(screenId: string, mode: NetworkMode): Promise<void>;
|
|
119
|
+
screens(): ScreenEntry[];
|
|
120
|
+
screen(screenId: string): ScreenEntry;
|
|
121
|
+
read(screenId: string): Promise<string>;
|
|
122
|
+
act(screenId: string, action: Action): Promise<string>;
|
|
123
|
+
image(screenId: string): Promise<Buffer>;
|
|
124
|
+
setController(screenId: string, controller: Controller): Promise<void>;
|
|
125
|
+
/**
|
|
126
|
+
* What a person does on a tile they have taken over, sent to that screen's browser: a click or a wheel at
|
|
127
|
+
* a point given as a fraction of the picture (so any tile size works), a key, or text. Refused unless the
|
|
128
|
+
* person has the screen, as the agent's actions are refused while they do.
|
|
129
|
+
*/
|
|
130
|
+
personInput(screenId: string, input: PersonInput): Promise<void>;
|
|
131
|
+
closeScreen(screenId: string): Promise<void>;
|
|
132
|
+
/**
|
|
133
|
+
* Read the world's clock, or move it (forward only), through the product's hooks, and bring every screen's
|
|
134
|
+
* browser to the same time: "today" and a byline's date are decided in the browser.
|
|
135
|
+
*/
|
|
136
|
+
moveClock(worldId: string, move?: ClockMove): Promise<ClockState>;
|
|
137
|
+
/** Wait for the product's background work to catch up, then run its checks against the world. */
|
|
138
|
+
check(worldId: string): Promise<{
|
|
139
|
+
settled: Record<string, Settled>;
|
|
140
|
+
results: CheckResult[];
|
|
141
|
+
}>;
|
|
142
|
+
/** The world's hooks, or a refusal saying why there are none. */
|
|
143
|
+
hooks(worldId: string): Promise<Hooks>;
|
|
144
|
+
/** Make a prop: a photo, a document or a signature, tagged with its id. */
|
|
145
|
+
makeProp(kind: PropKind, about: string): Promise<Prop>;
|
|
146
|
+
props(): Prop[];
|
|
147
|
+
/** Queue a prop for the screen's next file chooser (a camera button on a phone or tablet is one). */
|
|
148
|
+
pickFile(screenId: string, propId: string): Prop;
|
|
149
|
+
/** Put a prop in front of the screen's camera; null for nothing. */
|
|
150
|
+
showCamera(screenId: string, propId: string | null): Promise<void>;
|
|
151
|
+
setLocation(screenId: string, latitude: number, longitude: number): Promise<void>;
|
|
152
|
+
setNotifications(screenId: string, allow: boolean): Promise<void>;
|
|
153
|
+
shutdown(): Promise<void>;
|
|
154
|
+
}
|
|
155
|
+
export type PersonInput = {
|
|
156
|
+
type: 'click';
|
|
157
|
+
x: number;
|
|
158
|
+
y: number;
|
|
159
|
+
} | {
|
|
160
|
+
type: 'wheel';
|
|
161
|
+
x: number;
|
|
162
|
+
y: number;
|
|
163
|
+
dy: number;
|
|
164
|
+
} | {
|
|
165
|
+
type: 'key';
|
|
166
|
+
key: string;
|
|
167
|
+
} | {
|
|
168
|
+
type: 'text';
|
|
169
|
+
text: string;
|
|
170
|
+
};
|
|
171
|
+
export type Action = {
|
|
172
|
+
kind: 'click';
|
|
173
|
+
role: string;
|
|
174
|
+
name: string;
|
|
175
|
+
exact?: boolean;
|
|
176
|
+
index?: number;
|
|
177
|
+
} | {
|
|
178
|
+
kind: 'fill';
|
|
179
|
+
label: string;
|
|
180
|
+
text: string;
|
|
181
|
+
exact?: boolean;
|
|
182
|
+
index?: number;
|
|
183
|
+
} | {
|
|
184
|
+
kind: 'select';
|
|
185
|
+
label: string;
|
|
186
|
+
option: string;
|
|
187
|
+
exact?: boolean;
|
|
188
|
+
index?: number;
|
|
189
|
+
} | {
|
|
190
|
+
kind: 'press';
|
|
191
|
+
key: string;
|
|
192
|
+
}
|
|
193
|
+
/** A path on the tenant's host, or a full link to it (as a text or email gives one), port or not. */
|
|
194
|
+
| {
|
|
195
|
+
kind: 'goto';
|
|
196
|
+
path: string;
|
|
197
|
+
}
|
|
198
|
+
/** Pointer strokes on an element found by its label (a signature pad), as fractions of its box. */
|
|
199
|
+
| {
|
|
200
|
+
kind: 'draw';
|
|
201
|
+
label: string;
|
|
202
|
+
exact?: boolean;
|
|
203
|
+
index?: number;
|
|
204
|
+
strokes?: Stroke[];
|
|
205
|
+
}
|
|
206
|
+
/**
|
|
207
|
+
* Drag an element found by role and name with the pointer: pressed at grab (fractions of its box, default
|
|
208
|
+
* its middle; an edge to resize), dropped on another element (at, fractions of its box, default its middle)
|
|
209
|
+
* or moved by a distance in CSS pixels.
|
|
210
|
+
*/
|
|
211
|
+
| {
|
|
212
|
+
kind: 'drag';
|
|
213
|
+
role: string;
|
|
214
|
+
name: string;
|
|
215
|
+
exact?: boolean;
|
|
216
|
+
index?: number;
|
|
217
|
+
grab?: [number, number];
|
|
218
|
+
to?: {
|
|
219
|
+
role: string;
|
|
220
|
+
name: string;
|
|
221
|
+
exact?: boolean;
|
|
222
|
+
index?: number;
|
|
223
|
+
at?: [number, number];
|
|
224
|
+
};
|
|
225
|
+
by?: {
|
|
226
|
+
x: number;
|
|
227
|
+
y: number;
|
|
228
|
+
};
|
|
229
|
+
};
|
|
230
|
+
/**
|
|
231
|
+
* Playwright's URL glob, for matching inside one route: ** is anything, * is anything but a slash,
|
|
232
|
+
* ? is one character. A pattern with no scheme matches the URL's path and what follows it.
|
|
233
|
+
*/
|
|
234
|
+
export declare function globMatches(glob: string, url: string): boolean;
|
|
235
|
+
export interface LinkWorld {
|
|
236
|
+
baseDomain: string;
|
|
237
|
+
tenants: readonly string[];
|
|
238
|
+
tenantOfPath?(path: string): string | undefined;
|
|
239
|
+
}
|
|
240
|
+
/**
|
|
241
|
+
* A link or path on a tenant's own host, as the path to open there. A full link must be on the tenant's
|
|
242
|
+
* host (`<tenant>.<baseDomain>`, with or without the world's port: products write links without it). A
|
|
243
|
+
* bare path names its tenant the way the product's links do (tenantOfPath), or is on the only tenant.
|
|
244
|
+
*/
|
|
245
|
+
export declare function linkPath(link: string, world: LinkWorld, only?: string, noun?: string): {
|
|
246
|
+
tenant: string;
|
|
247
|
+
path: string;
|
|
248
|
+
};
|
|
249
|
+
/**
|
|
250
|
+
* One line for the agent about something the server did, or null when it's nothing to tell: this
|
|
251
|
+
* screen's own commands (with what they set off), and anything anywhere in the tenant that failed or
|
|
252
|
+
* was refused, such as a text the worker couldn't send a second after the office was told it went.
|
|
253
|
+
*/
|
|
254
|
+
export declare function feedLine(it: FeedItem, s: Pick<ScreenEntry, 'customer' | 'persona'>): string | null;
|
|
255
|
+
/** Whether a world's clock stands anywhere but on this machine's: moved, or paused. */
|
|
256
|
+
export declare function clockMoved(state: ClockState): boolean;
|
|
257
|
+
export declare function createHarness<W extends ProductWorld>(product: Product<W>, options?: HarnessOptions): Harness<W>;
|
|
258
|
+
//# sourceMappingURL=harness.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"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"}
|