agent-recon 1.0.1

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 (44) hide show
  1. package/.claude/hooks/send-event-wsl.py +339 -0
  2. package/.claude/hooks/send-event.py +334 -0
  3. package/CHANGELOG.md +66 -0
  4. package/CONTRIBUTING.md +70 -0
  5. package/EULA.md +223 -0
  6. package/INSTALL.md +193 -0
  7. package/LICENSE +287 -0
  8. package/LICENSE-COMMERCIAL +241 -0
  9. package/PRIVACY.md +115 -0
  10. package/README.md +182 -0
  11. package/SECURITY.md +63 -0
  12. package/TERMS.md +233 -0
  13. package/install-service.ps1 +302 -0
  14. package/installer/cli.js +177 -0
  15. package/installer/detect.js +355 -0
  16. package/installer/install.js +195 -0
  17. package/installer/manifest.js +140 -0
  18. package/installer/package.json +12 -0
  19. package/installer/steps/api-keys.js +59 -0
  20. package/installer/steps/directory.js +41 -0
  21. package/installer/steps/env-report.js +48 -0
  22. package/installer/steps/hooks.js +149 -0
  23. package/installer/steps/service.js +159 -0
  24. package/installer/steps/tls.js +104 -0
  25. package/installer/steps/verify.js +117 -0
  26. package/installer/steps/welcome.js +46 -0
  27. package/installer/ui.js +133 -0
  28. package/installer/uninstall.js +233 -0
  29. package/installer/upgrade.js +289 -0
  30. package/package.json +58 -0
  31. package/public/index.html +13953 -0
  32. package/server/fixtures/allowlist-profiles.json +185 -0
  33. package/server/package.json +34 -0
  34. package/server/platform.js +270 -0
  35. package/server/rules/gitleaks.toml +3214 -0
  36. package/server/rules/security.yara +579 -0
  37. package/server/start.js +178 -0
  38. package/service/agent-recon.service +30 -0
  39. package/service/com.agent-recon.server.plist +56 -0
  40. package/setup-linux.sh +259 -0
  41. package/setup-macos.sh +264 -0
  42. package/setup-wsl.sh +248 -0
  43. package/setup.ps1 +171 -0
  44. package/start-agent-recon.bat +4 -0
package/LICENSE ADDED
@@ -0,0 +1,287 @@
1
+ Agent Recon™ — Open-Core License
2
+
3
+ Copyright 2026 PNW Great Loop LLC. All rights reserved.
4
+
5
+ Agent Recon™ is an independent product and is not affiliated with, endorsed by,
6
+ or sponsored by Anthropic PBC. Claude, Claude Code, and the Anthropic name and
7
+ logo are trademarks of Anthropic PBC. Agent Recon™ is a trademark of PNW Great
8
+ Loop LLC.
9
+
10
+ =============================================================================
11
+ OPEN-CORE LICENSING OVERVIEW
12
+ =============================================================================
13
+
14
+ This repository uses a dual-license model:
15
+
16
+ 1. CORE COMPONENTS — Licensed under the Apache License, Version 2.0
17
+ (see below). You may freely use, modify, and redistribute these
18
+ components subject to the Apache 2.0 terms.
19
+
20
+ 2. PROPRIETARY COMPONENTS — Licensed under a separate commercial license
21
+ (see LICENSE-COMMERCIAL). These components may not be used, copied, or
22
+ distributed except under the terms of a valid Agent Recon™ license.
23
+
24
+ 3. HOOK SCRIPTS — Licensed under the MIT License (see headers in
25
+ individual files). These may be freely used, modified, and
26
+ redistributed with minimal restriction.
27
+
28
+ See the header comment in each source file to determine which license
29
+ applies. Files without a license header are covered by the Apache License,
30
+ Version 2.0.
31
+
32
+ =============================================================================
33
+ CORE COMPONENTS — Covered files include:
34
+ =============================================================================
35
+
36
+ - server/server.js Event ingestion server
37
+ - server/db.js SQLite database layer
38
+ - server/db-migrations.js Schema migrations
39
+ - server/tokens.js Token cost tracking
40
+ - server/event-types.js Event type constants
41
+ - server/start.js Startup wrapper
42
+ - server/platform.js Cross-platform utilities
43
+ - server/routes.js HTTP route definitions
44
+ - server/providers/ LLM provider abstraction (base layer)
45
+ - src/js/00-config.js Frontend configuration
46
+ - src/js/01-categories.js Event categorization
47
+ - src/js/02-security-engine.js Regex security engine
48
+ - src/js/03-session-colors.js Session display utilities
49
+ - src/js/04-sound.js Sound engine
50
+ - src/js/05-state.js Frontend state
51
+ - src/js/06-dom.js DOM references
52
+ - src/js/07-stats-bar.js Statistics bar
53
+ - src/js/08-feed.js Event feed
54
+ - src/js/10-event-handler.js Event routing
55
+ - src/js/11-websocket.js WebSocket client
56
+ - src/js/12-controls.js UI controls
57
+ - src/js/13-canvas.js Waveform timeline
58
+ - src/js/14-env-widget.js Environment widget
59
+ - src/js/15-main.js App entry point
60
+ - src/js/16-tokens-view.js Token display
61
+ - src/js/20-accessibility.js Accessibility
62
+ - src/template.html HTML template
63
+ - src/css/ All CSS source files
64
+ - build.js Build system
65
+ - public/index.html Built SPA
66
+ - setup.ps1 Windows setup script
67
+ - setup-wsl.sh WSL setup script
68
+ - setup-macos.sh macOS setup script
69
+ - setup-linux.sh Linux setup script
70
+ - package.json Package manifest
71
+ - server/tests/ All test files
72
+ - test/ Platform test infrastructure
73
+
74
+ =============================================================================
75
+ PROPRIETARY COMPONENTS — See LICENSE-COMMERCIAL for terms:
76
+ =============================================================================
77
+
78
+ - server/security-llm.js LLM security chain analysis
79
+ - server/insights-llm.js LLM session insight analysis
80
+ - server/environment-llm.js LLM environment recommendations
81
+ - server/prompt-analysis-llm.js LLM prompt quality analysis
82
+ - server/session-history-llm.js LLM session history narratives
83
+ - server/telemetry.js Telemetry system
84
+ - server/archiver.js Encrypted archive management
85
+ - server/process-monitor.js Process observability
86
+ - server/otel-exporter.js OTLP export
87
+ - server/tls-setup.js TLS certificate management
88
+ - installer/ Guided installer (all files)
89
+ - azure/ Azure telemetry infrastructure
90
+
91
+ =============================================================================
92
+ HOOK SCRIPTS — MIT License (see file headers):
93
+ =============================================================================
94
+
95
+ - .claude/hooks/send-event.py Cross-platform hook forwarder
96
+ - .claude/hooks/send-event-wsl.py WSL-specific hook forwarder
97
+
98
+ =============================================================================
99
+
100
+ Apache License
101
+ Version 2.0, January 2004
102
+ http://www.apache.org/licenses/
103
+
104
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
105
+
106
+ 1. Definitions.
107
+
108
+ "License" shall mean the terms and conditions for use, reproduction,
109
+ and distribution as defined by Sections 1 through 9 of this document.
110
+
111
+ "Licensor" shall mean the copyright owner or entity authorized by
112
+ the copyright owner that is granting the License.
113
+
114
+ "Legal Entity" shall mean the union of the acting entity and all
115
+ other entities that control, are controlled by, or are under common
116
+ control with that entity. For the purposes of this definition,
117
+ "control" means (i) the power, direct or indirect, to cause the
118
+ direction or management of such entity, whether by contract or
119
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
120
+ outstanding shares, or (iii) beneficial ownership of such entity.
121
+
122
+ "You" (or "Your") shall mean an individual or Legal Entity
123
+ exercising permissions granted by this License.
124
+
125
+ "Source" form shall mean the preferred form for making modifications,
126
+ including but not limited to software source code, documentation
127
+ source, and configuration files.
128
+
129
+ "Object" form shall mean any form resulting from mechanical
130
+ transformation or translation of a Source form, including but not
131
+ limited to compiled object code, generated documentation, and
132
+ conversions to other media types.
133
+
134
+ "Work" shall mean the work of authorship, whether in Source or
135
+ Object form, made available under the License, as indicated by a
136
+ copyright notice that is included in or attached to the work.
137
+
138
+ "Derivative Works" shall mean any work, whether in Source or Object
139
+ form, that is based on (or derived from) the Work and for which the
140
+ editorial revisions, annotations, elaborations, or other modifications
141
+ represent, as a whole, an original work of authorship. For the
142
+ purposes of this License, Derivative Works shall not include works
143
+ that remain separable from, or merely link (or bind by name) to the
144
+ interfaces of, the Work and Derivative Works thereof.
145
+
146
+ "Contribution" shall mean any work of authorship, including the
147
+ original version of the Work and any modifications or additions to
148
+ that Work or Derivative Works thereof, that is intentionally submitted
149
+ to the Licensor for inclusion in the Work by the copyright owner or by
150
+ an individual or Legal Entity authorized to submit on behalf of the
151
+ copyright owner. For the purposes of this definition, "submitted"
152
+ means any form of electronic, verbal, or written communication sent to
153
+ the Licensor or its representatives, including but not limited to
154
+ communication on electronic mailing lists, source code control systems,
155
+ and issue tracking systems that are managed by, or on behalf of, the
156
+ Licensor for the purpose of discussing and improving the Work, but
157
+ excluding communication that is conspicuously marked or otherwise
158
+ designated in writing by the copyright owner as "Not a Contribution."
159
+
160
+ "Contributor" shall mean Licensor and any individual or Legal Entity
161
+ on behalf of whom a Contribution has been received by the Licensor and
162
+ subsequently incorporated within the Work.
163
+
164
+ 2. Grant of Copyright License. Subject to the terms and conditions of
165
+ this License, each Contributor hereby grants to You a perpetual,
166
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
167
+ copyright license to reproduce, prepare Derivative Works of, publicly
168
+ display, publicly perform, sublicense, and distribute the Work and
169
+ such Derivative Works in Source or Object form.
170
+
171
+ 3. Grant of Patent License. Subject to the terms and conditions of this
172
+ License, each Contributor hereby grants to You a perpetual, worldwide,
173
+ non-exclusive, no-charge, royalty-free, irrevocable (except as stated
174
+ in this section) patent license to make, have made, use, offer to
175
+ sell, sell, import, and otherwise transfer the Work, where such
176
+ license applies only to those patent claims licensable by such
177
+ Contributor that are necessarily infringed by their Contribution(s)
178
+ alone or by combination of their Contribution(s) with the Work to
179
+ which such Contribution(s) was submitted. If You institute patent
180
+ litigation against any entity (including a cross-claim or counterclaim
181
+ in a lawsuit) alleging that the Work or a Contribution incorporated
182
+ within the Work constitutes direct or contributory patent
183
+ infringement, then any patent licenses granted to You under this
184
+ License for that Work shall terminate as of the date such litigation
185
+ is filed.
186
+
187
+ 4. Redistribution. You may reproduce and distribute copies of the Work
188
+ or Derivative Works thereof in any medium, with or without
189
+ modifications, and in Source or Object form, provided that You meet
190
+ the following conditions:
191
+
192
+ (a) You must give any other recipients of the Work or Derivative
193
+ Works a copy of this License; and
194
+
195
+ (b) You must cause any modified files to carry prominent notices
196
+ stating that You changed the files; and
197
+
198
+ (c) You must retain, in the Source form of any Derivative Works that
199
+ You distribute, all copyright, patent, trademark, and attribution
200
+ notices from the Source form of the Work, excluding those notices
201
+ that do not pertain to any part of the Derivative Works; and
202
+
203
+ (d) If the Work includes a "NOTICE" text file as part of its
204
+ distribution, then any Derivative Works that You distribute must
205
+ include a readable copy of the attribution notices contained
206
+ within such NOTICE file, excluding any notices that do not
207
+ pertain to any part of the Derivative Works, in at least one of
208
+ the following places: within a NOTICE text file distributed as
209
+ part of the Derivative Works; within the Source form or
210
+ documentation, if provided along with the Derivative Works; or,
211
+ within a display generated by the Derivative Works, if and
212
+ wherever such third-party notices normally appear. The contents of
213
+ the NOTICE file are for informational purposes only and do not
214
+ modify the License. You may add Your own attribution notices
215
+ within Derivative Works that You distribute, alongside or as an
216
+ addendum to the NOTICE text from the Work, provided that such
217
+ additional attribution notices cannot be construed as modifying
218
+ the License.
219
+
220
+ You may add Your own copyright statement to Your modifications and
221
+ may provide additional or different license terms and conditions for
222
+ use, reproduction, or distribution of Your modifications, or for any
223
+ such Derivative Works as a whole, provided Your use, reproduction,
224
+ and distribution of the Work otherwise complies with the conditions
225
+ stated in this License.
226
+
227
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
228
+ any Contribution intentionally submitted for inclusion in the Work by
229
+ You to the Licensor shall be under the terms and conditions of this
230
+ License, without any additional terms or conditions. Notwithstanding
231
+ the above, nothing herein shall supersede or modify the terms of any
232
+ separate license agreement you may have executed with Licensor
233
+ regarding such Contributions.
234
+
235
+ 6. Trademarks. This License does not grant permission to use the trade
236
+ names, trademarks, service marks, or product names of the Licensor,
237
+ except as required for reasonable and customary use in describing the
238
+ origin of the Work and reproducing the content of the NOTICE file.
239
+
240
+ 7. Disclaimer of Warranty. Unless required by applicable law or agreed
241
+ to in writing, Licensor provides the Work (and each Contributor
242
+ provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES
243
+ OR CONDITIONS OF ANY KIND, either express or implied, including,
244
+ without limitation, any warranties or conditions of TITLE,
245
+ NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
246
+ PURPOSE. You are solely responsible for determining the appropriateness
247
+ of using or redistributing the Work and assume any risks associated
248
+ with Your exercise of permissions under this License.
249
+
250
+ 8. Limitation of Liability. In no event and under no legal theory,
251
+ whether in tort (including negligence), contract, or otherwise, unless
252
+ required by applicable law (such as deliberate and grossly negligent
253
+ acts) or agreed to in writing, shall any Contributor be liable to You
254
+ for damages, including any direct, indirect, special, incidental, or
255
+ consequential damages of any character arising as a result of this
256
+ License or out of the use or inability to use the Work (including but
257
+ not limited to damages for loss of goodwill, work stoppage, computer
258
+ failure or malfunction, or any and all other commercial damages or
259
+ losses), even if such Contributor has been advised of the possibility
260
+ of such damages.
261
+
262
+ 9. Accepting Warranty or Additional Liability. While redistributing the
263
+ Work or Derivative Works thereof, You may choose to offer, and charge
264
+ a fee for, acceptance of support, warranty, indemnity, or other
265
+ liability obligations and/or rights consistent with this License.
266
+ However, in accepting such obligations, You may act only on Your own
267
+ behalf and on Your sole responsibility, not on behalf of any other
268
+ Contributor, and only if You agree to indemnify, defend, and hold each
269
+ Contributor harmless for any liability incurred by, or claims asserted
270
+ against, such Contributor by reason of your accepting any such
271
+ warranty or additional liability.
272
+
273
+ END OF TERMS AND CONDITIONS
274
+
275
+ Copyright 2026 PNW Great Loop LLC
276
+
277
+ Licensed under the Apache License, Version 2.0 (the "License");
278
+ you may not use this file except in compliance with the License.
279
+ You may obtain a copy of the License at
280
+
281
+ http://www.apache.org/licenses/LICENSE-2.0
282
+
283
+ Unless required by applicable law or agreed to in writing, software
284
+ distributed under the License is distributed on an "AS IS" BASIS,
285
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
286
+ See the License for the specific language governing permissions and
287
+ limitations under the License.
@@ -0,0 +1,241 @@
1
+ Agent Recon™ — Commercial License
2
+
3
+ Copyright 2026 PNW Great Loop LLC. All rights reserved.
4
+
5
+ Agent Recon™ is an independent product and is not affiliated with, endorsed by,
6
+ or sponsored by Anthropic PBC. Claude, Claude Code, and the Anthropic name and
7
+ logo are trademarks of Anthropic PBC. Agent Recon™ is a trademark of PNW Great
8
+ Loop LLC.
9
+
10
+ =============================================================================
11
+ COMMERCIAL LICENSE AGREEMENT
12
+ =============================================================================
13
+
14
+ This Commercial License Agreement ("Agreement") governs the use of the
15
+ proprietary components of Agent Recon™ software ("Proprietary Software")
16
+ developed and owned by PNW Great Loop LLC ("Licensor").
17
+
18
+ By using, installing, or accessing the Proprietary Software, you ("Licensee")
19
+ agree to be bound by the terms of this Agreement. If you do not agree, you
20
+ may not use, install, or access the Proprietary Software.
21
+
22
+ =============================================================================
23
+ 1. COVERED COMPONENTS
24
+ =============================================================================
25
+
26
+ This license applies to the following files, directories, and their contents:
27
+
28
+ LLM Analysis Pipelines:
29
+ - server/security-llm.js LLM security chain analysis
30
+ - server/insights-llm.js LLM session insight analysis
31
+ - server/environment-llm.js LLM environment recommendations
32
+ - server/prompt-analysis-llm.js LLM prompt quality analysis
33
+ - server/session-history-llm.js LLM session history narratives
34
+
35
+ Infrastructure:
36
+ - server/telemetry.js Telemetry system
37
+ - server/archiver.js Encrypted archive management
38
+ - server/process-monitor.js Process observability
39
+ - server/otel-exporter.js OTLP export
40
+ - server/tls-setup.js TLS certificate management
41
+
42
+ Installer:
43
+ - installer/ All files in the installer directory
44
+
45
+ Azure Telemetry Infrastructure:
46
+ - azure/ All files in the azure directory
47
+
48
+ Future Additions:
49
+ - Any files added to this repository bearing the header
50
+ "Licensed under LICENSE-COMMERCIAL" or "Agent Recon™ Commercial License"
51
+
52
+ All other files in this repository are licensed under the Apache License,
53
+ Version 2.0 (see LICENSE) or the MIT License (see individual file headers).
54
+
55
+ =============================================================================
56
+ 2. LICENSE TIERS
57
+ =============================================================================
58
+
59
+ The Proprietary Software is available under three license tiers. Feature
60
+ access is identical for Personal and Professional tiers; the distinction is
61
+ legal terms governing the context of use.
62
+
63
+ COMMUNITY TIER (Free)
64
+ - Proprietary components are included in the distribution but operate
65
+ in a limited mode:
66
+ - LLM-powered analysis features are disabled (security chains,
67
+ insights, prompt coaching, hallucination scoring, environment
68
+ recommendations, session history narratives)
69
+ - Data retention limited to 7 days
70
+ - OTEL export, encrypted archives, and TLS are disabled
71
+ - Multi-environment support is disabled
72
+ - The Licensee may use the Community tier for personal, non-commercial
73
+ development purposes without a license key.
74
+ - The Community tier may not be redistributed as part of a commercial
75
+ product or service.
76
+
77
+ PERSONAL TIER ($9.99/month or $84/year)
78
+ - Full access to all Proprietary Software features.
79
+ - Must be purchased with the Licensee's personal funds.
80
+ - May NOT be reimbursed by or purchased through an employer, client,
81
+ or other business entity.
82
+ - Licensed to a single individual for personal development use.
83
+
84
+ PROFESSIONAL TIER ($29/month or $279/year)
85
+ - Full access to all Proprietary Software features.
86
+ - Required when:
87
+ (a) Use occurs in an employment or contractor context, OR
88
+ (b) Purchase is made by or reimbursed by an employer, client, or
89
+ other business entity, OR
90
+ (c) Use supports revenue-generating commercial activities.
91
+ - Licensed to a single individual.
92
+ - Includes invoice billing and priority support.
93
+
94
+ =============================================================================
95
+ 3. LICENSE KEY
96
+ =============================================================================
97
+
98
+ Personal and Professional tier access requires a valid license key obtained
99
+ through the authorized Agent Recon™ storefront. License keys are:
100
+ - Bound to a single Licensee
101
+ - Validated periodically via the Licensor's API
102
+ - Cached locally for offline operation
103
+ - Non-transferable without written consent from the Licensor
104
+
105
+ Complimentary license keys may be issued at the Licensor's discretion for
106
+ beta testing, community contributions, or promotional purposes. Such keys
107
+ are functionally identical to purchased keys.
108
+
109
+ =============================================================================
110
+ 4. RESTRICTIONS
111
+ =============================================================================
112
+
113
+ The Licensee SHALL NOT:
114
+
115
+ (a) Copy, redistribute, sublicense, sell, lease, or otherwise transfer
116
+ the Proprietary Software or any portion thereof to any third party,
117
+ except as part of a lawful installation on a machine the Licensee
118
+ controls.
119
+
120
+ (b) Reverse engineer, decompile, disassemble, or otherwise attempt to
121
+ derive the source code of the Proprietary Software, except to the
122
+ extent expressly permitted by applicable law notwithstanding this
123
+ limitation.
124
+
125
+ (c) Remove, alter, or obscure any proprietary notices, labels, license
126
+ headers, or trademarks in the Proprietary Software.
127
+
128
+ (d) Remove or disable the telemetry system except through the provided
129
+ opt-out mechanism (Settings > Telemetry > Disable, or
130
+ telemetry_enabled=false in the database).
131
+
132
+ (e) Use the Proprietary Software to create a competing product or
133
+ service that substantially replicates the functionality of
134
+ Agent Recon™.
135
+
136
+ (f) Use the Proprietary Software in any manner that violates applicable
137
+ law or regulation.
138
+
139
+ =============================================================================
140
+ 5. LLM API KEYS AND THIRD-PARTY SERVICES
141
+ =============================================================================
142
+
143
+ The Licensee supplies their own API key(s) for LLM providers (Anthropic,
144
+ OpenAI, Google, or any other supported provider). The Licensor does not
145
+ provide LLM API access. All LLM usage costs — for both the observed AI
146
+ coding agent and Agent Recon™'s analysis pipelines — are the sole
147
+ responsibility of the Licensee.
148
+
149
+ The Licensor is not responsible for the availability, pricing, terms, or
150
+ performance of any third-party LLM provider.
151
+
152
+ =============================================================================
153
+ 6. INTELLECTUAL PROPERTY
154
+ =============================================================================
155
+
156
+ The Proprietary Software, including all modifications, enhancements, and
157
+ derivative works, remains the exclusive property of PNW Great Loop LLC.
158
+ This Agreement does not transfer any ownership rights to the Licensee.
159
+
160
+ "Agent Recon" and the Agent Recon™ logo are trademarks of PNW Great Loop
161
+ LLC. The Licensee may not use these marks except to identify their
162
+ authorized use of the software.
163
+
164
+ =============================================================================
165
+ 7. DISCLAIMER OF WARRANTIES
166
+ =============================================================================
167
+
168
+ THE PROPRIETARY SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
169
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
170
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
171
+
172
+ THE LICENSOR DOES NOT WARRANT THAT THE SOFTWARE WILL BE UNINTERRUPTED,
173
+ ERROR-FREE, OR FREE OF HARMFUL COMPONENTS. THE LICENSOR DOES NOT WARRANT
174
+ THE ACCURACY, COMPLETENESS, OR RELIABILITY OF ANY LLM-GENERATED ANALYSIS,
175
+ INCLUDING BUT NOT LIMITED TO SECURITY CLASSIFICATIONS, INSIGHTS, PROMPT
176
+ QUALITY ASSESSMENTS, OR ENVIRONMENT RECOMMENDATIONS.
177
+
178
+ =============================================================================
179
+ 8. LIMITATION OF LIABILITY
180
+ =============================================================================
181
+
182
+ IN NO EVENT SHALL PNW GREAT LOOP LLC, ITS OFFICERS, DIRECTORS, EMPLOYEES,
183
+ OR AGENTS BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL,
184
+ OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO LOSS OF PROFITS, DATA,
185
+ USE, GOODWILL, OR OTHER INTANGIBLE LOSSES, ARISING OUT OF OR IN CONNECTION
186
+ WITH THE USE OR INABILITY TO USE THE PROPRIETARY SOFTWARE, EVEN IF THE
187
+ LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
188
+
189
+ THE LICENSOR'S TOTAL AGGREGATE LIABILITY SHALL NOT EXCEED THE AMOUNT PAID
190
+ BY THE LICENSEE FOR THE PROPRIETARY SOFTWARE IN THE TWELVE (12) MONTHS
191
+ PRECEDING THE CLAIM.
192
+
193
+ =============================================================================
194
+ 9. TERMINATION
195
+ =============================================================================
196
+
197
+ This Agreement is effective until terminated.
198
+
199
+ (a) The Licensee may terminate at any time by uninstalling the
200
+ Proprietary Software and destroying all copies.
201
+
202
+ (b) The Licensor may terminate this Agreement if the Licensee breaches
203
+ any term and fails to cure the breach within thirty (30) days of
204
+ written notice.
205
+
206
+ (c) Upon termination, the Licensee must cease all use of the
207
+ Proprietary Software and destroy all copies. Sections 4, 6, 7, 8,
208
+ and 10 survive termination.
209
+
210
+ (d) Subscription cancellation reverts the installation to Community
211
+ tier functionality. No data is deleted upon downgrade.
212
+
213
+ =============================================================================
214
+ 10. GOVERNING LAW
215
+ =============================================================================
216
+
217
+ This Agreement shall be governed by and construed in accordance with the
218
+ laws of the State of Washington, United States, without regard to its
219
+ conflict of law provisions. Any dispute arising under this Agreement shall
220
+ be resolved in the state or federal courts located in Washington State,
221
+ and the parties consent to the personal jurisdiction of such courts.
222
+
223
+ =============================================================================
224
+ 11. ENTIRE AGREEMENT
225
+ =============================================================================
226
+
227
+ This Agreement constitutes the entire agreement between the parties
228
+ concerning the Proprietary Software and supersedes all prior agreements,
229
+ understandings, negotiations, and discussions, whether oral or written.
230
+ No amendment to this Agreement shall be effective unless in writing and
231
+ signed by both parties.
232
+
233
+ =============================================================================
234
+ 12. CONTACT
235
+ =============================================================================
236
+
237
+ PNW Great Loop LLC
238
+ Email: license@agent-recon.net
239
+ Web: https://agentrecon.dev
240
+
241
+ Effective Date: March 2026
package/PRIVACY.md ADDED
@@ -0,0 +1,115 @@
1
+ # Agent Recon™ Privacy Policy
2
+
3
+ **Effective date:** March 24, 2026
4
+
5
+ Agent Recon™ respects your privacy. This policy explains what data we collect, how we use it, and your rights.
6
+
7
+ ---
8
+
9
+ ## 1. What We Collect
10
+
11
+ When telemetry is enabled, Agent Recon sends a single heartbeat on startup and once daily. Each heartbeat contains the following fields:
12
+
13
+ - **`install_id`** — a randomly generated UUID, not derived from any personal information (not from hardware IDs, MAC addresses, usernames, or hostnames)
14
+ - **`version`** — the Agent Recon version string (e.g., `"1.5.0"`)
15
+ - **`platform`** — operating system and CPU architecture (e.g., `"darwin-arm64"`)
16
+ - **`timestamp`** — ISO-8601 datetime of the heartbeat
17
+
18
+ Additionally, your source IP address is captured server-side by the Azure infrastructure when the heartbeat is received. The client never sends IP information.
19
+
20
+ ## 2. What We Do NOT Collect
21
+
22
+ Agent Recon does **not** collect any of the following:
23
+
24
+ - No session content (prompts, tool inputs, tool outputs, file contents, code)
25
+ - No personally identifiable information (names, email addresses, usernames, hostnames)
26
+ - No API keys, credentials, or authentication tokens
27
+ - No usage metrics (token counts, session durations, event counts, model names)
28
+ - No file paths, working directories, or project names
29
+ - No browsing history or network activity
30
+ - No hardware identifiers (MAC addresses, serial numbers, device IDs)
31
+
32
+ ## 3. How We Use Collected Data
33
+
34
+ We use the data described in Section 1 for the following purposes:
35
+
36
+ - **Aggregate install counts** — measuring daily active installs
37
+ - **Version distribution analysis** — prioritizing updates and deprecation schedules
38
+ - **Platform distribution analysis** — prioritizing platform support and compatibility testing
39
+ - **IP-to-ASN mapping** — identifying corporate network clusters for license compliance
40
+
41
+ We do **not** sell, rent, or share your data with third parties. We do **not** use your data for advertising or profiling.
42
+
43
+ ## 4. Data Retention
44
+
45
+ - Heartbeat records are retained for **90 days**, then permanently deleted.
46
+ - IP-to-ASN mapping data is retained for **90 days**.
47
+ - After the retention period, data is purged and cannot be recovered.
48
+
49
+ ## 5. How to Opt Out
50
+
51
+ You can disable telemetry at any time:
52
+
53
+ 1. Open the Agent Recon dashboard in your browser.
54
+ 2. Click the gear icon to open **Settings**.
55
+ 3. Toggle **"Send anonymous usage statistics"** to disabled.
56
+
57
+ When disabled, zero telemetry is sent — no heartbeat, no version check, nothing. The opt-out takes effect immediately.
58
+
59
+ You can also set `telemetry_enabled` to `false` directly in the SQLite database settings table.
60
+
61
+ ## 6. How to Delete Your Data
62
+
63
+ Self-service data deletion is built into the dashboard:
64
+
65
+ 1. Open the Agent Recon dashboard in your browser.
66
+ 2. Click the gear icon to open **Settings**.
67
+ 3. Click **"Delete My Data"** in the telemetry section.
68
+ 4. Confirm when prompted.
69
+
70
+ Deletion is **immediate and permanent** — deleted data cannot be recovered. Telemetry is automatically disabled after deletion to prevent new records from being created.
71
+
72
+ ## 7. Your Rights Under GDPR
73
+
74
+ If you are in the European Economic Area, you have the right to:
75
+
76
+ - **Access** — request what data we hold about your install ID
77
+ - **Erasure** — delete all data associated with your install ID (see Section 6)
78
+ - **Object** — opt out of data collection at any time (see Section 5)
79
+ - **Portability** — request your data in a machine-readable format via GitHub Issues
80
+ - **Rectification** — your data consists only of automatically generated fields; there is nothing to correct
81
+
82
+ To exercise these rights, use the self-service deletion endpoint (Section 6) or open a GitHub Issue.
83
+
84
+ ## 8. Your Rights Under CCPA
85
+
86
+ If you are a California resident:
87
+
88
+ - **Right to Know** — you can request what data we collect (described in Section 1)
89
+ - **Right to Delete** — use the self-service deletion endpoint (Section 6)
90
+ - **Right to Opt Out of Sale** — we do not sell your personal information to any third party
91
+ - **Non-Discrimination** — we will not discriminate against you for exercising your rights
92
+
93
+ ## 9. Data Security
94
+
95
+ - All heartbeat data is transmitted over **HTTPS** (TLS encryption in transit).
96
+ - Server-side data is stored in **Azure Table Storage** with managed identity access controls.
97
+ - Secrets (API tokens) are stored in **Azure Key Vault**.
98
+ - Network access to storage and key vault is restricted via **Azure Virtual Network** and firewall rules.
99
+ - No shared access keys — all access uses **Azure Managed Identity** with role-based access control (RBAC).
100
+
101
+ ## 10. Children's Privacy
102
+
103
+ Agent Recon is a software development tool not directed at children under 13. We do not knowingly collect data from children.
104
+
105
+ ## 11. Contact
106
+
107
+ For privacy questions or requests, open a GitHub Issue at:
108
+
109
+ [https://github.com/genxcoder1999/agent-recon/issues](https://github.com/genxcoder1999/agent-recon/issues)
110
+
111
+ ## 12. Changes to This Policy
112
+
113
+ We may update this policy from time to time. Material changes will be noted in release notes and the effective date will be updated. Continued use of Agent Recon after changes constitutes acceptance of the revised policy.
114
+
115
+ ---