@heysummon/app 0.1.0 → 0.2.6
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.md +87 -0
- package/README.md +7 -9
- package/dist/commands/init.js +1 -1
- package/dist/commands/status.js +1 -1
- package/dist/index.js +4 -4
- package/dist/lib/download.js +1 -1
- package/package.json +6 -6
- package/bin/CLAUDE.md +0 -11
package/LICENSE.md
ADDED
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# License
|
|
2
|
+
|
|
3
|
+
Portions of this software are licensed as follows:
|
|
4
|
+
|
|
5
|
+
- Source code files that contain ".cloud." in their filename or ".cloud" in their dirname are NOT licensed under
|
|
6
|
+
the Sustainable Use License.
|
|
7
|
+
To use source code files that contain ".cloud." in their filename or ".cloud" in their dirname you must hold a
|
|
8
|
+
valid HeySummon Cloud License specifically allowing you access to such source code files and as defined
|
|
9
|
+
in "LICENSE_CLOUD.md".
|
|
10
|
+
- All third party components incorporated into the HeySummon Software are licensed under the original license
|
|
11
|
+
provided by the owner of the applicable component.
|
|
12
|
+
- Content outside of the above mentioned files or restrictions is available under the "Sustainable Use
|
|
13
|
+
License" as defined below.
|
|
14
|
+
|
|
15
|
+
## Sustainable Use License
|
|
16
|
+
|
|
17
|
+
Version 1.0
|
|
18
|
+
|
|
19
|
+
### Acceptance
|
|
20
|
+
|
|
21
|
+
By using the software, you agree to all of the terms and conditions below.
|
|
22
|
+
|
|
23
|
+
### Copyright License
|
|
24
|
+
|
|
25
|
+
The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license
|
|
26
|
+
to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject
|
|
27
|
+
to the limitations below.
|
|
28
|
+
|
|
29
|
+
### Limitations
|
|
30
|
+
|
|
31
|
+
You may use or modify the software only for your own internal business purposes or for non-commercial or
|
|
32
|
+
personal use. You may distribute the software or provide it to others only if you do so free of charge for
|
|
33
|
+
non-commercial purposes. You may not alter, remove, or obscure any licensing, copyright, or other notices of
|
|
34
|
+
the licensor in the software. Any use of the licensor's trademarks is subject to applicable law.
|
|
35
|
+
|
|
36
|
+
### Patents
|
|
37
|
+
|
|
38
|
+
The licensor grants you a license, under any patent claims the licensor can license, or becomes able to
|
|
39
|
+
license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case
|
|
40
|
+
subject to the limitations and conditions in this license. This license does not cover any patent claims that
|
|
41
|
+
you cause to be infringed by modifications or additions to the software. If you or your company make any
|
|
42
|
+
written claim that the software infringes or contributes to infringement of any patent, your patent license
|
|
43
|
+
for the software granted under these terms ends immediately. If your company makes such a claim, your patent
|
|
44
|
+
license ends immediately for work on behalf of your company.
|
|
45
|
+
|
|
46
|
+
### Notices
|
|
47
|
+
|
|
48
|
+
You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these
|
|
49
|
+
terms. If you modify the software, you must include in any modified copies of the software a prominent notice
|
|
50
|
+
stating that you have modified the software.
|
|
51
|
+
|
|
52
|
+
### No Other Rights
|
|
53
|
+
|
|
54
|
+
These terms do not imply any licenses other than those expressly granted in these terms.
|
|
55
|
+
|
|
56
|
+
### Termination
|
|
57
|
+
|
|
58
|
+
If you use the software in violation of these terms, such use is not licensed, and your license will
|
|
59
|
+
automatically terminate. If the licensor provides you with a notice of your violation, and you cease all
|
|
60
|
+
violation of this license no later than 30 days after you receive that notice, your license will be reinstated
|
|
61
|
+
retroactively. However, if you violate these terms after such reinstatement, any additional violation of these
|
|
62
|
+
terms will cause your license to terminate automatically and permanently.
|
|
63
|
+
|
|
64
|
+
### No Liability
|
|
65
|
+
|
|
66
|
+
As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will
|
|
67
|
+
not be liable to you for any damages arising out of these terms or the use or nature of the software, under
|
|
68
|
+
any kind of legal claim.
|
|
69
|
+
|
|
70
|
+
### Definitions
|
|
71
|
+
|
|
72
|
+
The "licensor" is Thomas Ansems and HeySummon.
|
|
73
|
+
|
|
74
|
+
The "software" is the software the licensor makes available under these terms, including any portion of it.
|
|
75
|
+
|
|
76
|
+
"You" refers to the individual or entity agreeing to these terms.
|
|
77
|
+
|
|
78
|
+
"Your company" is any legal entity, sole proprietorship, or other kind of organization that you work for, plus
|
|
79
|
+
all organizations that have control over, are under the control of, or are under common control with that
|
|
80
|
+
organization. Control means ownership of substantially all the assets of an entity, or the power to direct its
|
|
81
|
+
management and policies by vote, contract, or otherwise. Control can be direct or indirect.
|
|
82
|
+
|
|
83
|
+
"Your license" is the license granted to you for the software under these terms.
|
|
84
|
+
|
|
85
|
+
"Use" means anything you do with the software requiring your license.
|
|
86
|
+
|
|
87
|
+
"Trademark" means trademarks, service marks, and similar rights.
|
package/README.md
CHANGED
|
@@ -45,7 +45,7 @@ One command gets you from zero to a running server.
|
|
|
45
45
|
## Quick Start
|
|
46
46
|
|
|
47
47
|
```bash
|
|
48
|
-
npx heysummon
|
|
48
|
+
npx @heysummon/app
|
|
49
49
|
```
|
|
50
50
|
|
|
51
51
|
The interactive installer walks you through everything. Takes ~2 minutes. No Docker or Git required.
|
|
@@ -116,10 +116,10 @@ heysummon uninstall
|
|
|
116
116
|
Stops the server, offers a database backup, asks for explicit confirmation, and removes `~/.heysummon/`. Then remove the CLI binary:
|
|
117
117
|
|
|
118
118
|
```bash
|
|
119
|
-
|
|
119
|
+
pnpm remove -g heysummon
|
|
120
120
|
```
|
|
121
121
|
|
|
122
|
-
> **Note:** `
|
|
122
|
+
> **Note:** `pnpm remove` alone only removes the CLI binary — it does **not** touch `~/.heysummon/`. Always run `heysummon uninstall` first for a clean removal.
|
|
123
123
|
|
|
124
124
|
---
|
|
125
125
|
|
|
@@ -157,11 +157,9 @@ docker compose --profile cloudflare up -d
|
|
|
157
157
|
# Tailscale Funnel (great for teams, zero config firewall)
|
|
158
158
|
docker compose --profile tailscale up -d
|
|
159
159
|
|
|
160
|
-
# Ngrok (quick testing)
|
|
161
|
-
docker compose --profile ngrok up -d
|
|
162
160
|
```
|
|
163
161
|
|
|
164
|
-
See the [Self-Hosting Guide](https://docs.heysummon.ai/self-hosting) for per-
|
|
162
|
+
See the [Self-Hosting Guide](https://docs.heysummon.ai/self-hosting) for per-expert setup.
|
|
165
163
|
|
|
166
164
|
### Managed Cloud
|
|
167
165
|
|
|
@@ -171,8 +169,8 @@ No self-hosting at all — [cloud.heysummon.ai](https://cloud.heysummon.ai) is t
|
|
|
171
169
|
|
|
172
170
|
| Method | Database | Tunnel | Best for |
|
|
173
171
|
|---|---|---|---|
|
|
174
|
-
| `npx heysummon` (this CLI) | SQLite | Manual / reverse proxy | Quick start, single machine |
|
|
175
|
-
| Docker Compose | PostgreSQL | Cloudflare / Tailscale
|
|
172
|
+
| `npx @heysummon/app` (this CLI) | SQLite | Manual / reverse proxy | Quick start, single machine |
|
|
173
|
+
| Docker Compose | PostgreSQL | Cloudflare / Tailscale | Production, teams |
|
|
176
174
|
| Cloud | Managed | Built-in | Zero ops |
|
|
177
175
|
|
|
178
176
|
---
|
|
@@ -182,7 +180,7 @@ No self-hosting at all — [cloud.heysummon.ai](https://cloud.heysummon.ai) is t
|
|
|
182
180
|
Once your server is running, install the SDK in your agent's project:
|
|
183
181
|
|
|
184
182
|
```bash
|
|
185
|
-
|
|
183
|
+
pnpm install @heysummon/sdk
|
|
186
184
|
```
|
|
187
185
|
|
|
188
186
|
```ts
|
package/dist/commands/init.js
CHANGED
package/dist/commands/status.js
CHANGED
|
@@ -63,7 +63,7 @@ async function status() {
|
|
|
63
63
|
console.log("");
|
|
64
64
|
if (!(0, config_1.isInitialized)()) {
|
|
65
65
|
console.log(` ${ui_1.color.yellow("○")} Not installed`);
|
|
66
|
-
console.log(` ${ui_1.color.dim("Run")} ${ui_1.color.cyan("npx heysummon")} ${ui_1.color.dim("to get started.")}`);
|
|
66
|
+
console.log(` ${ui_1.color.dim("Run")} ${ui_1.color.cyan("npx @heysummon/app")} ${ui_1.color.dim("to get started.")}`);
|
|
67
67
|
console.log("");
|
|
68
68
|
return;
|
|
69
69
|
}
|
package/dist/index.js
CHANGED
|
@@ -36,10 +36,10 @@ function printHelp() {
|
|
|
36
36
|
--daemon, -d Run server in background
|
|
37
37
|
|
|
38
38
|
Examples:
|
|
39
|
-
npx heysummon # First-time setup (interactive)
|
|
40
|
-
npx heysummon --yes # Quickstart with defaults
|
|
41
|
-
npx heysummon start -d # Start in background
|
|
42
|
-
npx heysummon status # Check if running
|
|
39
|
+
npx @heysummon/app # First-time setup (interactive)
|
|
40
|
+
npx @heysummon/app --yes # Quickstart with defaults
|
|
41
|
+
npx @heysummon/app start -d # Start in background
|
|
42
|
+
npx @heysummon/app status # Check if running
|
|
43
43
|
`);
|
|
44
44
|
}
|
|
45
45
|
async function main() {
|
package/dist/lib/download.js
CHANGED
|
@@ -41,7 +41,7 @@ const path = __importStar(require("path"));
|
|
|
41
41
|
const child_process_1 = require("child_process");
|
|
42
42
|
const config_1 = require("./config");
|
|
43
43
|
const GITHUB_API = "https://api.github.com";
|
|
44
|
-
const REPO = "
|
|
44
|
+
const REPO = "@heysummon/app";
|
|
45
45
|
function httpsGet(url) {
|
|
46
46
|
return new Promise((resolve, reject) => {
|
|
47
47
|
const options = {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@heysummon/app",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.6",
|
|
4
4
|
"description": "HeySummon — Human-in-the-loop for AI agents. Install & run with one command.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"heysummon": "./bin/cli.js"
|
|
@@ -9,10 +9,6 @@
|
|
|
9
9
|
"bin/",
|
|
10
10
|
"dist/"
|
|
11
11
|
],
|
|
12
|
-
"scripts": {
|
|
13
|
-
"build": "tsc",
|
|
14
|
-
"test": "node --test dist/__tests__/*.test.js"
|
|
15
|
-
},
|
|
16
12
|
"engines": {
|
|
17
13
|
"node": ">=18"
|
|
18
14
|
},
|
|
@@ -35,5 +31,9 @@
|
|
|
35
31
|
"devDependencies": {
|
|
36
32
|
"@types/node": "^22.19.15",
|
|
37
33
|
"typescript": "^5.9.3"
|
|
34
|
+
},
|
|
35
|
+
"scripts": {
|
|
36
|
+
"build": "tsc",
|
|
37
|
+
"test": "node --test dist/__tests__/*.test.js"
|
|
38
38
|
}
|
|
39
|
-
}
|
|
39
|
+
}
|
package/bin/CLAUDE.md
DELETED
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
<claude-mem-context>
|
|
2
|
-
# Recent Activity
|
|
3
|
-
|
|
4
|
-
<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
|
|
5
|
-
|
|
6
|
-
### Mar 23, 2026
|
|
7
|
-
|
|
8
|
-
| ID | Time | T | Title | Read |
|
|
9
|
-
|----|------|---|-------|------|
|
|
10
|
-
| #3341 | 2:18 PM | 🔵 | HeySummon CLI Wizard Flow Lacks Platform Selection | ~699 |
|
|
11
|
-
</claude-mem-context>
|