@wenathlan/devthink 1.1.16 → 2.0.2

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 (160) hide show
  1. package/CHANGELOG.md +1288 -0
  2. package/README.md +6 -0
  3. package/bridge.d.ts +698 -0
  4. package/bridge.d.ts.map +1 -0
  5. package/bridge.js +1877 -0
  6. package/bun.d.ts +8 -0
  7. package/bun.d.ts.map +1 -0
  8. package/bun.js +52329 -0
  9. package/caps/background.json +712 -0
  10. package/caps/cli.json +360 -0
  11. package/caps/library.json +3611 -0
  12. package/caps/mcp.json +126 -0
  13. package/caps/pagebridge.json +377 -0
  14. package/caps/popup.json +51 -0
  15. package/caps/sidepanel.json +522 -0
  16. package/checksums.txt +142 -0
  17. package/cli.d.ts +187 -0
  18. package/cli.d.ts.map +1 -0
  19. package/cli.js +18197 -0
  20. package/companion.d.ts +19 -0
  21. package/companion.d.ts.map +1 -0
  22. package/companion.js +389 -0
  23. package/crossbrowser.d.ts +277 -0
  24. package/crossbrowser.d.ts.map +1 -0
  25. package/crossbrowser.js +1191 -0
  26. package/dashdone.d.ts +273 -0
  27. package/dashdone.d.ts.map +1 -0
  28. package/dashdone.js +368 -0
  29. package/deno.d.ts +11 -0
  30. package/deno.d.ts.map +1 -0
  31. package/deno.js +52325 -0
  32. package/devthink.umd.js +52346 -0
  33. package/fixtures/bun.ts +7 -0
  34. package/fixtures/cjs.js +6 -0
  35. package/fixtures/deno.ts +6 -0
  36. package/fixtures/example-org-pagestate.json +22 -0
  37. package/fixtures/importers/automa-workflow.json +18 -0
  38. package/fixtures/importers/selenium-side.json +20 -0
  39. package/fixtures/importers/tabular-plan.csv +7 -0
  40. package/fixtures/importers/uivision-macro.json +10 -0
  41. package/fixtures/importers/v1-plan.json +13 -0
  42. package/fixtures/mcp-client.mjs +14 -0
  43. package/fixtures/pages/checkout.html +192 -0
  44. package/fixtures/pages/dashboard.html +110 -0
  45. package/fixtures/pages/feed.html +113 -0
  46. package/fixtures/pages/product-grid.html +150 -0
  47. package/fixtures/plans/form-inventory-plan.json +11 -0
  48. package/fixtures/plans/release-notes-plan.json +11 -0
  49. package/fixtures/recipes/agentscompete.json +11 -0
  50. package/fixtures/recipes/agentsforms.json +11 -0
  51. package/fixtures/recipes/agentsmonitor.json +11 -0
  52. package/fixtures/recipes/agentsreview.json +29 -0
  53. package/fixtures/recipes/agentswarm.json +11 -0
  54. package/fixtures/recipes/fillcalendar.json +12 -0
  55. package/fixtures/recipes/fillcheckout.json +13 -0
  56. package/fixtures/recipes/filldependentdropdowns.json +12 -0
  57. package/fixtures/recipes/fillfromcsv.json +13 -0
  58. package/fixtures/recipes/fillloginform.json +12 -0
  59. package/fixtures/recipes/fillmultistepwizard.json +13 -0
  60. package/fixtures/recipes/fillregistration.json +12 -0
  61. package/fixtures/recipes/fillsearchfilters.json +12 -0
  62. package/fixtures/recipes/filltypeahead.json +11 -0
  63. package/fixtures/recipes/monitoralerts.json +12 -0
  64. package/fixtures/recipes/monitoravailability.json +11 -0
  65. package/fixtures/recipes/monitornetworkquiet.json +12 -0
  66. package/fixtures/recipes/monitorpagechanges.json +11 -0
  67. package/fixtures/recipes/monitorpricechange.json +11 -0
  68. package/fixtures/recipes/monitorschedule.json +12 -0
  69. package/fixtures/recipes/scrapedynamicprices.json +13 -0
  70. package/fixtures/recipes/scrapeimagegallery.json +12 -0
  71. package/fixtures/recipes/scrapeinfinitefeed.json +13 -0
  72. package/fixtures/recipes/scrapenestedlists.json +12 -0
  73. package/fixtures/recipes/scrapeproductgrid.json +12 -0
  74. package/fixtures/recipes/scrapereviews.json +12 -0
  75. package/fixtures/recipes/scrapesearchresults.json +12 -0
  76. package/fixtures/recipes/scrapetablepagination.json +12 -0
  77. package/fixtures/recipes/testaccessibility.json +34 -0
  78. package/fixtures/recipes/testconsoleerrors.json +12 -0
  79. package/fixtures/recipes/testdeeplinks.json +12 -0
  80. package/fixtures/recipes/testformvalidation.json +13 -0
  81. package/fixtures/recipes/testlayoutshift.json +12 -0
  82. package/fixtures/recipes/testlinkcheck.json +12 -0
  83. package/fixtures/recipes/testloadtiming.json +12 -0
  84. package/fixtures/recipes/testvisualdiff.json +12 -0
  85. package/fixtures/workflows/changelog-digest-workflow.json +13 -0
  86. package/fixtures/workflows/form-survey-workflow.json +13 -0
  87. package/gallery.json +706 -0
  88. package/hardening.d.ts +81 -0
  89. package/hardening.d.ts.map +1 -0
  90. package/hardening.js +188 -0
  91. package/headless.d.ts +114 -0
  92. package/headless.d.ts.map +1 -0
  93. package/headless.js +11522 -0
  94. package/http.d.ts +636 -0
  95. package/http.d.ts.map +1 -0
  96. package/http.js +2165 -0
  97. package/index.cjs +54682 -0
  98. package/index.d.ts +40 -0
  99. package/index.d.ts.map +1 -0
  100. package/index.js +52310 -0
  101. package/index.neutral.js +46343 -0
  102. package/manifest.json +199 -0
  103. package/mcp.d.ts +501 -0
  104. package/mcp.d.ts.map +1 -0
  105. package/mcp.js +20515 -0
  106. package/memory.d.ts +2397 -0
  107. package/memory.d.ts.map +1 -0
  108. package/memory.js +5782 -0
  109. package/nativehost.template.json +10 -0
  110. package/node.cjs +54686 -0
  111. package/node.d.ts +8 -0
  112. package/node.d.ts.map +1 -0
  113. package/pack.d.ts +211 -0
  114. package/pack.d.ts.map +1 -0
  115. package/pack.js +805 -0
  116. package/package.json +101 -51
  117. package/policy.d.ts +1854 -0
  118. package/policy.d.ts.map +1 -0
  119. package/policy.js +12580 -0
  120. package/progress.d.ts +390 -0
  121. package/progress.d.ts.map +1 -0
  122. package/progress.js +645 -0
  123. package/protocol.d.ts +2336 -0
  124. package/protocol.d.ts.map +1 -0
  125. package/protocol.js +8334 -0
  126. package/schemas/audit.schema.json +226 -0
  127. package/schemas/capability.schema.json +113 -0
  128. package/schemas/envelope.schema.json +162 -0
  129. package/schemas/memory.schema.json +51 -0
  130. package/schemas/observation.schema.json +113 -0
  131. package/schemas/plan.schema.json +208 -0
  132. package/schemas/progress.schema.json +126 -0
  133. package/schemas/proposal.schema.json +68 -0
  134. package/schemas/session.schema.json +82 -0
  135. package/schemas/tool.schema.json +94 -0
  136. package/server.d.ts +435 -0
  137. package/server.d.ts.map +1 -0
  138. package/server.js +28872 -0
  139. package/umd-example.html +18 -0
  140. package/umd.d.ts +6 -0
  141. package/umd.d.ts.map +1 -0
  142. package/build.ts +0 -41
  143. package/check-secrets.ts +0 -52
  144. package/compatibility.ts +0 -37
  145. package/config.ts +0 -246
  146. package/devthink.ts +0 -397
  147. package/identity.ts +0 -156
  148. package/ids.ts +0 -22
  149. package/memory.ts +0 -95
  150. package/modes.ts +0 -43
  151. package/plugin.ts +0 -68
  152. package/providers.ts +0 -179
  153. package/server.ts +0 -264
  154. package/session.ts +0 -155
  155. package/storage.ts +0 -82
  156. package/stream.ts +0 -130
  157. package/sync.ts +0 -27
  158. package/terminal-ui.tsx +0 -155
  159. package/ui.ts +0 -143
  160. package/workspace.ts +0 -20
package/hardening.d.ts ADDED
@@ -0,0 +1,81 @@
1
+ import type { policyevaluation, redactregion, scanverdict } from "./types.js";
2
+ /** Masks the secret shaped key value pairs of one free form log text: a summary a step, a body or a console line embedded stays masked when its key matches a masked shape, because a log field the families gained since the masking audit never leaks its typed value through the text the audit trail keeps. */
3
+ export declare function masklogtext(input: {
4
+ text: string;
5
+ shapes: string[];
6
+ }): {
7
+ text: string;
8
+ maskedkeys: string[];
9
+ reason: string;
10
+ };
11
+ /** Gates the local signature check option of the virus scanning hook: a scanner configured with a local signature list answers its verdict on the device before any remote endpoint fires, and a digest that matches a local signature flags the file while a digest that matches nothing leaves the verdict to the configured hook. */
12
+ export declare function localscangate(input: {
13
+ hook?: {
14
+ scanner: string;
15
+ localsignatures?: string[];
16
+ };
17
+ digest?: string;
18
+ }): {
19
+ verdict: scanverdict;
20
+ reason: string;
21
+ };
22
+ /** Builds the visible confirmation banner of the escape hatch: one record the surfaces render after the key press, because a halt of every native call at once deserves a confirmation the user sees and the audit trail keeps. */
23
+ export declare function hatchbannerof(input: {
24
+ halted: number;
25
+ at: number;
26
+ }): {
27
+ title: string;
28
+ explanation: string;
29
+ halted: number;
30
+ at: number;
31
+ };
32
+ /** Decides the review mode pause on a new domain: a navigation step that lands on a domain the profile workspace never recorded pauses the run with the explanatory card instead of dispatching silently, because a new domain is a new trust boundary the review walks the user through. */
33
+ export declare function newdomainpausecard(input: {
34
+ origin: string;
35
+ knownorigins: string[];
36
+ kind: string;
37
+ }): {
38
+ pause: boolean;
39
+ card: {
40
+ title: string;
41
+ explanation: string;
42
+ origin: string;
43
+ };
44
+ reason: string;
45
+ };
46
+ /** Selects every stored key that carries the trace of one run: the per run keys the families write end with the run id, so the purge of a run deletes every key that names it and no key survives with the run's data. */
47
+ export declare function runtracekeys(input: {
48
+ runid: string;
49
+ keys: string[];
50
+ }): {
51
+ keys: string[];
52
+ kept: string[];
53
+ reason: string;
54
+ };
55
+ /** Gates the key rotation entry point of the encrypted sync path: the rotation needs both the current passphrase and the next one, and a rotation that reuses the same passphrase rekeys nothing. */
56
+ export declare function syncrotationgate(input: {
57
+ current?: string;
58
+ next?: string;
59
+ }): policyevaluation;
60
+ /** Verifies the client signature of the local stdio bridge: the platform verifier answers when the platform allows signature verification, a presented signature that fails refuses the bridge, and a platform without a verifier keeps the bridge running unverified while the record says so. */
61
+ export declare function stdioclientsignaturegate(input: {
62
+ platformverifier?: (host: string, signature: string) => boolean;
63
+ host: string;
64
+ signature?: string;
65
+ }): {
66
+ verified: boolean;
67
+ allowed: boolean;
68
+ reason: string;
69
+ };
70
+ /** Masks and redacts one transparency export payload: the shape masking covers every typed field of the report while the redact regions of the origin mark the capture derived entries, so an export the transparency page issues leaves with the same masking and redaction the captures carry. */
71
+ export declare function transparencyexportmask(input: {
72
+ report: Record<string, unknown>;
73
+ shapes: string[];
74
+ regions: redactregion[];
75
+ }): {
76
+ payload: Record<string, unknown>;
77
+ maskedfields: string[];
78
+ redactedregions: number;
79
+ reason: string;
80
+ };
81
+ //# sourceMappingURL=hardening.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hardening.d.ts","sourceRoot":"","sources":["../hardening.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9E,mTAAmT;AACnT,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAyBA;AAED,wUAAwU;AACxU,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IACjH,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAsBA;AAED,mOAAmO;AACnO,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ,CAOA;AAED,6RAA6R;AAC7R,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IACnG,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB,CAgBA;AAED,0NAA0N;AAC1N,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IACtE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAcA;AAED,qMAAqM;AACrM,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CAkB7F;AAED,mSAAmS;AACnS,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAmB1D;AAED,oSAAoS;AACpS,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAexG"}
package/hardening.js ADDED
@@ -0,0 +1,188 @@
1
+ /*! devthink 2.0.2 — consent-first browser agent library — GPL-3.0-only — https://github.com/wenathlan/devthink */
2
+
3
+ // security.ts
4
+ var maskmarker = "[redacted]";
5
+ function fieldshapekind(name) {
6
+ const lowered = name.toLowerCase();
7
+ if (lowered.includes("password") || lowered.includes("passwd") || lowered.includes("pwd") || lowered.includes("passphrase"))
8
+ return "password";
9
+ if (lowered.includes("token") || lowered.includes("apikey") || lowered.includes("api_key") || lowered.includes("auth") || lowered.includes("bearer"))
10
+ return "token";
11
+ if (lowered.includes("card") || lowered.includes("cvc") || lowered.includes("cvv") || lowered.includes("expiry") || lowered.includes("pan"))
12
+ return "card";
13
+ if (lowered.includes("secret")) return "secret";
14
+ return void 0;
15
+ }
16
+ function maskingfield(name, shapes) {
17
+ if (fieldshapekind(name) !== void 0) return true;
18
+ const lowered = name.toLowerCase();
19
+ return shapes.some((shape) => shape !== "" && lowered.includes(shape));
20
+ }
21
+ function maskvalue(value) {
22
+ return value === "" ? "" : maskmarker;
23
+ }
24
+ function maskfield(input) {
25
+ return maskingfield(input.name, input.shapes) ? maskvalue(input.value) : input.value;
26
+ }
27
+ function maskrecord(record, shapes) {
28
+ const masked = {};
29
+ for (const [key, value] of Object.entries(record)) {
30
+ if (typeof value === "string") {
31
+ const sibling = record.name;
32
+ masked[key] = key === "value" && typeof sibling === "string" ? maskfield({ name: sibling, value, shapes }) : maskfield({ name: key, value, shapes });
33
+ } else if (Array.isArray(value))
34
+ masked[key] = value.map(
35
+ (item) => Boolean(item) && typeof item === "object" && !Array.isArray(item) ? maskrecord(item, shapes) : item
36
+ );
37
+ else if (Boolean(value) && typeof value === "object")
38
+ masked[key] = maskrecord(value, shapes);
39
+ else masked[key] = value;
40
+ }
41
+ return masked;
42
+ }
43
+ function maskexport(record, shapes) {
44
+ return maskrecord(record, shapes);
45
+ }
46
+
47
+ // hardening.ts
48
+ function masklogtext(input) {
49
+ const maskedkeys = [];
50
+ let text = input.text;
51
+ const patterns = [
52
+ [/(\w+)\s*:\s*"((?:[^"\\]|\\.)*)"/g, (match) => `${match[1]}: "${maskvalue(match[2] ?? "")}"`],
53
+ [/(\w+)\s*=\s*([^\s&;]+)/g, (match) => `${match[1]}=${maskvalue(match[2] ?? "")}`],
54
+ [/(\w+)\s*:\s*([^\s,;]+)/g, (match) => `${match[1]}: ${maskvalue(match[2] ?? "")}`]
55
+ ];
56
+ for (const [pattern, rewrite] of patterns) {
57
+ text = text.replace(pattern, (full, key, ...rest) => {
58
+ if (!maskingfield(String(key), input.shapes)) return full;
59
+ maskedkeys.push(String(key));
60
+ return rewrite([full, String(key), String(rest[0] ?? "")]);
61
+ });
62
+ }
63
+ const unique = [...new Set(maskedkeys)];
64
+ return {
65
+ text,
66
+ maskedkeys: unique,
67
+ reason: unique.length === 0 ? "The log text carries no secret shaped key value pair; the masking pass changed nothing." : `The masking pass covered the log field${unique.length === 1 ? "" : "s"} ${unique.join(", ")} the text carried since the audit; the typed values answer the redaction marker.`
68
+ };
69
+ }
70
+ function localscangate(input) {
71
+ const signatures = input.hook?.localsignatures ?? [];
72
+ if (signatures.length === 0)
73
+ return {
74
+ verdict: "pending",
75
+ reason: "The scanning hook carries no local signature list; the verdict stays with the configured scanner endpoint and the file holds."
76
+ };
77
+ if (input.digest === void 0 || input.digest.trim() === "")
78
+ return {
79
+ verdict: "pending",
80
+ reason: `The local signature check of ${input.hook?.scanner ?? "the scanning hook"} needs the file digest; a digest nobody computed flags nothing.`
81
+ };
82
+ if (signatures.includes(input.digest))
83
+ return {
84
+ verdict: "flagged",
85
+ reason: `The local signature list of ${input.hook?.scanner} matched the file digest; the quarantine deletes the file and no remote endpoint ever fires.`
86
+ };
87
+ return {
88
+ verdict: "pending",
89
+ reason: `The local signature list of ${input.hook?.scanner} matched no signature; the verdict falls back to the configured scanner endpoint and the file holds.`
90
+ };
91
+ }
92
+ function hatchbannerof(input) {
93
+ return {
94
+ title: `Escape hatch: ${input.halted} in flight call${input.halted === 1 ? "" : "s"} halted`,
95
+ explanation: `The escape hatch key stopped every native call in one press at ${new Date(input.at).toISOString()}; the transport detached until you reattach and the halt stays recorded in the audit trail.`,
96
+ halted: input.halted,
97
+ at: input.at
98
+ };
99
+ }
100
+ function newdomainpausecard(input) {
101
+ if (input.knownorigins.includes(input.origin))
102
+ return {
103
+ pause: false,
104
+ card: { title: "", explanation: "", origin: input.origin },
105
+ reason: `The domain ${input.origin} sits inside the recorded origins; the review mode runs the ${input.kind} step without the new domain pause.`
106
+ };
107
+ return {
108
+ pause: true,
109
+ card: {
110
+ title: `New domain: ${input.origin}`,
111
+ explanation: `The ${input.kind} step targets a domain the profile workspace never recorded. The run pauses here so you can review the new trust boundary: the safedefaults profile applied reads only, every sensitive class stays denied, and the next explicit grant opens the domain the same way the first one did.`,
112
+ origin: input.origin
113
+ },
114
+ reason: `The review mode paused the ${input.kind} step on the new domain ${input.origin} with the explanatory card; the run resumes after the domain review.`
115
+ };
116
+ }
117
+ function runtracekeys(input) {
118
+ if (input.runid.trim() === "")
119
+ throw new Error("The run trace purge names its run; a nameless run trace purges nothing.");
120
+ const runid = input.runid.trim();
121
+ const keys = input.keys.filter((key) => key === runid || key.endsWith(runid));
122
+ const kept = input.keys.filter((key) => !keys.includes(key));
123
+ return {
124
+ keys,
125
+ kept,
126
+ reason: keys.length === 0 ? `No stored key carries the trace of the run ${runid}; the run trace purge deletes nothing.` : `The run trace purge deletes ${keys.length} stored key${keys.length === 1 ? "" : "s"} carrying the trace of the run ${runid} \u2014 ${keys.join(", ")} \u2014 while ${kept.length} key${kept.length === 1 ? "" : "s"} of other runs survive.`
127
+ };
128
+ }
129
+ function syncrotationgate(input) {
130
+ if ((input.current ?? "").trim() === "" || (input.next ?? "").trim() === "")
131
+ return {
132
+ allowed: false,
133
+ reason: "The key rotation names both the current passphrase and the next one; a rotation without either passphrase never rekeys because no key ever defaults in code."
134
+ };
135
+ if (input.current === input.next)
136
+ return {
137
+ allowed: false,
138
+ reason: "The key rotation needs a next passphrase that differs from the current one; rotating onto the same key rekeys nothing."
139
+ };
140
+ return {
141
+ allowed: true,
142
+ reason: "The key rotation entry point opens with both passphrases present; the derived key rekeys the sync payloads while the passphrases never persist."
143
+ };
144
+ }
145
+ function stdioclientsignaturegate(input) {
146
+ if (input.signature === void 0 || input.platformverifier === void 0)
147
+ return {
148
+ verified: false,
149
+ allowed: true,
150
+ reason: "The platform carries no signature verifier the bridge can call; the local stdio bridge stays unverified while the record marks it."
151
+ };
152
+ if (!input.platformverifier(input.host, input.signature))
153
+ return {
154
+ verified: false,
155
+ allowed: false,
156
+ reason: `The client signature of the ${input.host} bridge failed the platform verification; the local stdio bridge refuses the client and no frame relays.`
157
+ };
158
+ return {
159
+ verified: true,
160
+ allowed: true,
161
+ reason: `The platform verifier confirmed the client signature of the ${input.host} bridge; the local stdio bridge relays its frames under the verified client.`
162
+ };
163
+ }
164
+ function transparencyexportmask(input) {
165
+ const payload = maskexport(input.report, input.shapes);
166
+ const maskedfields = Object.keys(input.report).filter((key) => maskingfield(key, input.shapes));
167
+ if (input.regions.length > 0 && Array.isArray(payload.captures))
168
+ payload.captures = payload.captures.map(
169
+ (entry) => Boolean(entry) && typeof entry === "object" && !Array.isArray(entry) ? { ...entry, redacted: true, redactedregions: input.regions.length } : entry
170
+ );
171
+ return {
172
+ payload,
173
+ maskedfields,
174
+ redactedregions: input.regions.length,
175
+ reason: `The transparency export left with the masking pass over ${maskedfields.length} shaped field${maskedfields.length === 1 ? "" : "s"} and ${input.regions.length} redact region${input.regions.length === 1 ? "" : "s"} covering its capture derived entries; the raw values stay behind the redaction marker.`
176
+ };
177
+ }
178
+ export {
179
+ hatchbannerof,
180
+ localscangate,
181
+ masklogtext,
182
+ newdomainpausecard,
183
+ runtracekeys,
184
+ stdioclientsignaturegate,
185
+ syncrotationgate,
186
+ transparencyexportmask
187
+ };
188
+ //# sourceMappingURL=hardening.js.map
package/headless.d.ts ADDED
@@ -0,0 +1,114 @@
1
+ /** The headless library entry of the 1.1.80 family: the library runtime without a browser extension, so a host opens the run handle over a plan, a state source and a policy and drives the read only replay against recorded page state fixtures; the 1.1.81 library modes stamp the entry so it reports the bundle it runs from. */
2
+ export { bundlestamp } from "./runtime.js";
3
+ import type { consentprovider, flowrungate, flowrunrequest, headlessevent, headlessfixture, headlessfixtureoutcome, headlesssession, immutablelogentry, jsonrpcframe, libraryrunhandle, planfile, planfilestep, planprogress, storedrunlog, toolstep } from "./types.js";
4
+ import type { memoryadapter } from "./memory.js";
5
+ import { sessionmemory } from "./memory.js";
6
+ /** Executes one read only step against one recorded page state fixture: the fixture consent gate grades the kind against the fixture grants, the read only vocabulary with a recorded projection executes against the observation, and every other kind reports unsupported with the reason a fixture cannot satisfy it. */
7
+ export declare function headlessfixturestep(fixture: headlessfixture, step: planfilestep): headlessfixtureoutcome;
8
+ /** Records the headless outcomes through the same progress model the live runs record: every step records its step mark and its outcome, so a headless replay renders on the progress surfaces a live run renders on. */
9
+ export declare function headlessprogress(input: {
10
+ progress: planprogress | undefined;
11
+ planid: string;
12
+ step: planfilestep;
13
+ outcome: headlessfixtureoutcome;
14
+ now: number;
15
+ }): planprogress;
16
+ /**
17
+ * Headless library logic of the 1.1.67 family.
18
+ * The library drives a remote browser with no chrome surface: a headless session opens on one origin behind the same consent gates, every gate wait routes to the consent provider the host implements (a terminal prompt in the cli, a callback anywhere else), denydefault refuses whatever no provider resolves, the remote session attaches through the same json rpc protocol the extension speaks, and the plan, run, session and memory entry points expose the whole engine to hosts.
19
+ * The audit reader verifies the chain it reads, the policy engine validates for external callers and the typed run subscription emits every step, gate and run event — with telemetry off by default and forever unless the host opts in.
20
+ */
21
+ /** Opens one headless session: the origin it addresses, the consent provider that resolves its gates and the telemetry marker that stays off by default. */
22
+ export declare function openheadlesssession(input: {
23
+ origin: string;
24
+ provider?: consentprovider;
25
+ now: number;
26
+ hostoptin?: boolean;
27
+ }): headlesssession;
28
+ /** Resolves one gate wait through the consent provider: an attached provider resolves the gate with its own human, an absent provider refuses under denydefault, and every resolution counts on the session. */
29
+ export declare function headlessgatewait(input: {
30
+ session: headlesssession;
31
+ gate: flowrungate;
32
+ provider?: consentprovider;
33
+ }): Promise<{
34
+ session: headlesssession;
35
+ resolution: "approve" | "refuse";
36
+ reason: string;
37
+ }>;
38
+ /** Closes one headless session: a closed session resolves no further gate and drives no further step. */
39
+ export declare function closeheadlesssession(session: headlesssession): headlesssession;
40
+ /** Builds the initialize frame of one remote session attach: the same json rpc protocol the extension speaks carries the protocol version, the runtime and the origin the session drives. */
41
+ export declare function remoteattachframes(input: {
42
+ id: number | string;
43
+ session: headlesssession;
44
+ runtime: string;
45
+ }): {
46
+ initialize: jsonrpcframe;
47
+ ready: jsonrpcframe;
48
+ };
49
+ /** Validates one step of an external caller with the same policy engine the extension runs: the validation refuses what the extension refuses, with no browser attached. */
50
+ export declare function headlesspolicyvalidate(step: toolstep, origin: string): {
51
+ allowed: boolean;
52
+ reason?: string;
53
+ };
54
+ /** Reads the audit chain of one stored run log with its verification: the reader returns the verified entries or the reason the chain broke, exactly the way the extension reads its own audit. */
55
+ export declare function headlessauditread(log: storedrunlog): Promise<{
56
+ ok: boolean;
57
+ entries: immutablelogentry[];
58
+ reason: string;
59
+ }>;
60
+ /** Opens the memory entry point over one adapter: the headless host drives the same sessionmemory the extension drives, so the profile store format and the lock protocol stay one. */
61
+ export declare function headlessmemory(adapter: memoryadapter): sessionmemory;
62
+ /** Builds the plan entry point of one plan file: the workflow proposal the headless run executes, validated the same way the extension validates it. */
63
+ export declare function headlessplan(file: planfile, grants: string[]): {
64
+ version: string;
65
+ workflow: {
66
+ name: string;
67
+ origins: string[];
68
+ steps: Array<Record<string, unknown>>;
69
+ };
70
+ };
71
+ /** Reads the run entry point descriptor of one headless run: the request, the plan file and the provider the host attached, so the flowrun pipeline runs headless without any chrome surface. */
72
+ export declare function headlessrun(input: {
73
+ request: flowrunrequest;
74
+ file: planfile;
75
+ provider?: consentprovider;
76
+ }): {
77
+ request: flowrunrequest;
78
+ file: planfile;
79
+ provider?: consentprovider;
80
+ };
81
+ /** Reads the session entry point view of one headless session for the host surfaces: the identity, origin, state and the gates it resolved. */
82
+ export declare function headlesssessionview(session: headlesssession): {
83
+ id: string;
84
+ origin: string;
85
+ state: string;
86
+ gatesresolved: number;
87
+ telemetry: boolean;
88
+ };
89
+ /** Creates one typed run subscription: the host handler receives every step, gate and run event, and the subscription keeps its own event list for replay. */
90
+ export declare function headlesssubscribe(handler: (event: headlessevent) => void): {
91
+ emit(event: headlessevent): void;
92
+ events(): headlessevent[];
93
+ };
94
+ /** Reads the telemetry posture of the library: off by default, on only under the host opt in, so a bundle that reports by default refuses. */
95
+ export declare function headlesstelemetryposture(hostoptin: boolean): {
96
+ telemetry: boolean;
97
+ reason: string;
98
+ };
99
+ /** The library entry point of the 1.1.80 family: one plan, one state source and one policy open a run handle whose progress records through the same progress model the live runs use, with the pause and cancel controls the extension surface offers — the state source resolves the recorded fixture of an origin and the policy narrows the fixture grants to the grants the host attached. */
100
+ export declare function openlibraryrun(input: {
101
+ plan: planfile;
102
+ statesource: (origin: string) => headlessfixture | undefined;
103
+ policy?: {
104
+ grants?: string[];
105
+ };
106
+ now: number;
107
+ }): {
108
+ handle(): libraryrunhandle;
109
+ step(step: planfilestep, now: number): headlessfixtureoutcome;
110
+ pause(now: number): void;
111
+ resume(now: number): void;
112
+ cancel(reason: string, now: number): void;
113
+ };
114
+ //# sourceMappingURL=headless.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../headless.ts"],"names":[],"mappings":"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"}