@widgex/wgx 0.0.0-stage → 0.4.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 (130) hide show
  1. package/LICENSE.txt +49 -0
  2. package/README.md +33 -2
  3. package/ThirdPartyNotices.txt +4802 -0
  4. package/package.json +29 -4
  5. package/python/XACTOR.md +146 -0
  6. package/python/browser_actor_host.py +456 -0
  7. package/python/cdp_page.py +363 -0
  8. package/python/harness_check.py +77 -0
  9. package/python/requirements.txt +1 -0
  10. package/python/test_line_endings.py +185 -0
  11. package/python/xactor/__init__.py +18 -0
  12. package/python/xactor/__main__.py +226 -0
  13. package/python/xactor/api.py +882 -0
  14. package/python/xactor/bridge.py +784 -0
  15. package/python/xactor/dom.py +117 -0
  16. package/python/xactor/man/add_card.md +89 -0
  17. package/python/xactor/man/agent-vs-fork.md +108 -0
  18. package/python/xactor/man/agent.md +333 -0
  19. package/python/xactor/man/ask_model.md +110 -0
  20. package/python/xactor/man/ask_reference.md +56 -0
  21. package/python/xactor/man/ask_user.md +103 -0
  22. package/python/xactor/man/attach_app.md +595 -0
  23. package/python/xactor/man/attach_ide.md +65 -0
  24. package/python/xactor/man/attach_ide_surface.md +31 -0
  25. package/python/xactor/man/await_user.md +214 -0
  26. package/python/xactor/man/bash.md +142 -0
  27. package/python/xactor/man/browser-driver.md +137 -0
  28. package/python/xactor/man/browser_activity.md +53 -0
  29. package/python/xactor/man/browser_attach.md +84 -0
  30. package/python/xactor/man/browser_close_tab.md +50 -0
  31. package/python/xactor/man/browser_detach.md +50 -0
  32. package/python/xactor/man/browser_exec.md +66 -0
  33. package/python/xactor/man/browser_focus_tab.md +47 -0
  34. package/python/xactor/man/browser_hybrid.md +47 -0
  35. package/python/xactor/man/browser_open.md +50 -0
  36. package/python/xactor/man/browser_open_tab.md +58 -0
  37. package/python/xactor/man/browser_plumbing.md +107 -0
  38. package/python/xactor/man/browser_screenshot.md +56 -0
  39. package/python/xactor/man/browser_snapshot.md +52 -0
  40. package/python/xactor/man/browser_tabs.md +67 -0
  41. package/python/xactor/man/bulletin.md +88 -0
  42. package/python/xactor/man/capture_page.md +54 -0
  43. package/python/xactor/man/cd.md +64 -0
  44. package/python/xactor/man/chess_move.md +53 -0
  45. package/python/xactor/man/children.md +89 -0
  46. package/python/xactor/man/close_task.md +14 -0
  47. package/python/xactor/man/compact.md +75 -0
  48. package/python/xactor/man/drive.md +140 -0
  49. package/python/xactor/man/drive_space.md +72 -0
  50. package/python/xactor/man/driving.md +168 -0
  51. package/python/xactor/man/edit_file.md +112 -0
  52. package/python/xactor/man/finding.md +194 -0
  53. package/python/xactor/man/fork_agent.md +45 -0
  54. package/python/xactor/man/glob.md +83 -0
  55. package/python/xactor/man/grep.md +115 -0
  56. package/python/xactor/man/harness.md +165 -0
  57. package/python/xactor/man/harness_check.md +70 -0
  58. package/python/xactor/man/harness_format.md +257 -0
  59. package/python/xactor/man/highlight.md +66 -0
  60. package/python/xactor/man/instruct.md +111 -0
  61. package/python/xactor/man/ls.md +63 -0
  62. package/python/xactor/man/man.md +86 -0
  63. package/python/xactor/man/merge_wiz.md +40 -0
  64. package/python/xactor/man/notebook.md +98 -0
  65. package/python/xactor/man/overview.md +89 -0
  66. package/python/xactor/man/permissions.md +137 -0
  67. package/python/xactor/man/phase.md +150 -0
  68. package/python/xactor/man/powershell.md +74 -0
  69. package/python/xactor/man/profiles.md +60 -0
  70. package/python/xactor/man/project_drive.md +49 -0
  71. package/python/xactor/man/read_bulletin.md +89 -0
  72. package/python/xactor/man/read_file.md +90 -0
  73. package/python/xactor/man/relay.md +216 -0
  74. package/python/xactor/man/reply.md +72 -0
  75. package/python/xactor/man/reply_message.md +78 -0
  76. package/python/xactor/man/report_bug.md +118 -0
  77. package/python/xactor/man/request_answer.md +142 -0
  78. package/python/xactor/man/request_merge_decisions.md +121 -0
  79. package/python/xactor/man/request_operator_action.md +152 -0
  80. package/python/xactor/man/request_review.md +122 -0
  81. package/python/xactor/man/request_user_action.md +126 -0
  82. package/python/xactor/man/return_card.md +71 -0
  83. package/python/xactor/man/run.md +99 -0
  84. package/python/xactor/man/sandbox.md +144 -0
  85. package/python/xactor/man/session_fork.md +74 -0
  86. package/python/xactor/man/session_harness.md +109 -0
  87. package/python/xactor/man/session_join.md +102 -0
  88. package/python/xactor/man/session_land.md +73 -0
  89. package/python/xactor/man/session_nudge.md +73 -0
  90. package/python/xactor/man/session_rest.md +73 -0
  91. package/python/xactor/man/session_scope.md +84 -0
  92. package/python/xactor/man/session_terminate.md +58 -0
  93. package/python/xactor/man/session_token.md +78 -0
  94. package/python/xactor/man/sessions.md +93 -0
  95. package/python/xactor/man/set_harness.md +15 -0
  96. package/python/xactor/man/spawn_swarm.md +80 -0
  97. package/python/xactor/man/submit_evidence.md +54 -0
  98. package/python/xactor/man/swarm_brief.md +30 -0
  99. package/python/xactor/man/task_status.md +82 -0
  100. package/python/xactor/man/tasks.md +47 -0
  101. package/python/xactor/man/todo_write.md +104 -0
  102. package/python/xactor/man/update_card.md +70 -0
  103. package/python/xactor/man/use_profile.md +90 -0
  104. package/python/xactor/man/use_widget.md +82 -0
  105. package/python/xactor/man/wait_for_task.md +105 -0
  106. package/python/xactor/man/widget-model.md +284 -0
  107. package/python/xactor/man/widgets.md +59 -0
  108. package/python/xactor/man/write_file.md +76 -0
  109. package/python/xactor/man/writing-a-widget.md +142 -0
  110. package/python/xactor/man/xylon.md +120 -0
  111. package/python/xactor/man/xylon_blame.md +80 -0
  112. package/python/xactor/man/xylon_read.md +131 -0
  113. package/python/xactor/man/xylon_search.md +125 -0
  114. package/python/xactor/manual.py +195 -0
  115. package/python/xactor/parent_watch.py +115 -0
  116. package/python/xactor/plan_mode.py +350 -0
  117. package/python/xactor/sandbox.py +856 -0
  118. package/python/xactor/seals.py +438 -0
  119. package/python/xactor/shell_hints.py +210 -0
  120. package/python/xactor/states/__init__.py +13 -0
  121. package/python/xactor/states/base.py +523 -0
  122. package/python/xactor/states/registry.py +274 -0
  123. package/python/xactor/stdlib_api.py +6345 -0
  124. package/python/xactor/widgets/__init__.py +1 -0
  125. package/python/xactor/widgets/github_tokens.py +314 -0
  126. package/python/xactor/widgets/google_aistudio.py +365 -0
  127. package/settings-schema.json +403 -0
  128. package/viewer/index.css +160 -0
  129. package/viewer/index.js +15 -0
  130. package/wgx.mjs +273753 -0
package/LICENSE.txt ADDED
@@ -0,0 +1,49 @@
1
+ WidgeX IDE License
2
+
3
+ Copyright (c) 2026 WidgeX Inc. All rights reserved.
4
+
5
+ WidgeX IDE (the "Software") is licensed, not sold, by WidgeX Inc. ("WidgeX").
6
+ Your use of the Software is governed by the WidgeX Terms of Service at
7
+ https://www.widgex.ai/terms (the "Terms"), including the license in section 9
8
+ of the Terms: while you follow the Terms, WidgeX gives you a personal,
9
+ non-exclusive, non-transferable license to install and use the Software.
10
+
11
+ By accepting this agreement, or by installing or using the Software, you agree
12
+ to the Terms. If you do not agree, do not install or use the Software.
13
+
14
+ Open-source components
15
+
16
+ The Software is built on Visual Studio Code - Open Source ("Code - OSS") and
17
+ includes other open-source components. Those components are licensed to you
18
+ under their own licenses, and nothing in this license or the Terms limits your
19
+ rights under them. The license for Code - OSS is reproduced below. Notices for
20
+ the other components are distributed with the Software, beside this file:
21
+ ThirdPartyNotices.txt for the components Code - OSS includes, and
22
+ ThirdPartyNotices.WidgeX.txt for the components WidgeX adds, which also points
23
+ to the notices for the WidgeX extension and its remote host daemon.
24
+
25
+ --------------------------------------------------------------------------------
26
+ Code - OSS
27
+ --------------------------------------------------------------------------------
28
+
29
+ MIT License
30
+
31
+ Copyright (c) 2015 - present Microsoft Corporation
32
+
33
+ Permission is hereby granted, free of charge, to any person obtaining a copy
34
+ of this software and associated documentation files (the "Software"), to deal
35
+ in the Software without restriction, including without limitation the rights
36
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
37
+ copies of the Software, and to permit persons to whom the Software is
38
+ furnished to do so, subject to the following conditions:
39
+
40
+ The above copyright notice and this permission notice shall be included in all
41
+ copies or substantial portions of the Software.
42
+
43
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
44
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
45
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
46
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
47
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
48
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
49
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,34 @@
1
- # Temporary Holding Version
1
+ # wgx
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ widgex: the WidgeX agent, in your terminal. The same engine as the
4
+ [WidgeX IDE](https://www.widgex.ai/), sharing its projects, channels, tasks and
5
+ sync — a terminal and an IDE window on one repository see one set of tasks.
6
+
7
+ ```sh
8
+ npm install -g @widgex/wgx
9
+ wgx # start, in the repository you are in
10
+ wgx --setup-claude # switch on Claude through your Claude Code login
11
+ wgx -p "a question" # ask once, print the answer, exit
12
+ wgx --help
13
+ ```
14
+
15
+ The WidgeX IDE carries the same `wgx`: installing the IDE puts it beside
16
+ `wgx-ide` on your PATH, and nothing from npm is needed.
17
+
18
+ ## Needs
19
+
20
+ - Node.js 20 or newer.
21
+ - Python 3.10 or newer on your PATH: the agent's tool shell runs in it.
22
+ - Git, for tasks: each one is a branch and a working copy of its own.
23
+
24
+ Settings and keys live in `~/.widgex` (`WIDGEX_HOME` moves it). `/login` in
25
+ widgex signs in to a WidgeX account, which sharing a project needs.
26
+
27
+ ## Licence
28
+
29
+ The WidgeX License (LICENSE.txt). The open-source components bundled in
30
+ `wgx.mjs` and their licences are listed in ThirdPartyNotices.txt.
31
+
32
+ Claude sessions run Claude Code, which npm installs beside wgx as
33
+ `@anthropic-ai/claude-code`, unmodified and under Anthropic's own terms
34
+ (https://code.claude.com/docs/en/legal-and-compliance).