@thieung/agentkit-helper 0.1.2 → 0.1.4
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/README.md +14 -2
- package/README.vi.md +14 -2
- package/bin/agentkit-helper.mjs +0 -4
- package/package.json +2 -2
- package/scripts/test.mjs +15 -0
package/README.md
CHANGED
|
@@ -31,8 +31,11 @@ In the TUI, use:
|
|
|
31
31
|
- Esc to return to the previous step
|
|
32
32
|
|
|
33
33
|
Choose a project or user/global scope, Engineer or Marketing Kit, one or more
|
|
34
|
-
runtimes, and the Stable or Beta channel.
|
|
35
|
-
|
|
34
|
+
runtimes, and the Stable or Beta channel. When the current directory is a safe
|
|
35
|
+
project path (not `/` or your home directory), the TUI offers **Use current
|
|
36
|
+
project**; the equivalent CLI flag is `--project .`. AgentKit remains
|
|
37
|
+
responsible for Kit verification, ownership, snapshots, and runtime-specific
|
|
38
|
+
files.
|
|
36
39
|
|
|
37
40
|
For global install, the helper first runs without `--force`. If the target
|
|
38
41
|
already exists or drift is detected, the TUI shows a WARNING and asks for
|
|
@@ -46,6 +49,15 @@ it passes a real-machine smoke test; the repository includes Windows-oriented
|
|
|
46
49
|
command handling and CI coverage, but does not yet claim provider-backed E2E
|
|
47
50
|
verification.
|
|
48
51
|
|
|
52
|
+
Windows smoke checklist (manual; keep experimental until this passes on a real
|
|
53
|
+
machine):
|
|
54
|
+
|
|
55
|
+
1. Install `ak` with `irm https://agentkit.best/install.ps1 | iex`, then open a
|
|
56
|
+
new terminal.
|
|
57
|
+
2. Run `npx --yes @thieung/agentkit-helper` (or `akh` after a global npm install).
|
|
58
|
+
3. In the TUI, choose **Use current project** (or `akh install --project .`).
|
|
59
|
+
4. Install one runtime, then run `update-all` for that install.
|
|
60
|
+
|
|
49
61
|
<details>
|
|
50
62
|
<summary><strong>Advanced CLI usage</strong></summary>
|
|
51
63
|
|
package/README.vi.md
CHANGED
|
@@ -30,8 +30,10 @@ Trong TUI, dùng:
|
|
|
30
30
|
- Esc để trở về bước trước
|
|
31
31
|
|
|
32
32
|
Bạn chỉ cần chọn scope project hoặc user/global, Engineer hoặc Marketing Kit,
|
|
33
|
-
một hay nhiều runtime và release channel Stable hoặc Beta.
|
|
34
|
-
|
|
33
|
+
một hay nhiều runtime và release channel Stable hoặc Beta. Khi thư mục hiện tại
|
|
34
|
+
là project hợp lệ (không phải `/` hay home), TUI có **Dùng project hiện tại**;
|
|
35
|
+
CLI tương đương là `--project .`. AgentKit vẫn quản lý việc xác minh Kit,
|
|
36
|
+
ownership, snapshot và file riêng của từng runtime.
|
|
35
37
|
|
|
36
38
|
Khi cài global scope, helper chạy trước mà không có `--force`. Nếu target đã
|
|
37
39
|
tồn tại hoặc có drift, TUI hiển thị WARNING và hỏi consent riêng, mặc định No.
|
|
@@ -43,6 +45,16 @@ qua code path Node.js portable. Native Windows PowerShell đang ở mức
|
|
|
43
45
|
experimental cho đến khi được smoke-test trên máy thật; repository đã có xử lý
|
|
44
46
|
command và CI dành cho Windows nhưng chưa claim provider-backed E2E.
|
|
45
47
|
|
|
48
|
+
Checklist smoke Windows (thủ công; giữ experimental cho đến khi chạy xong trên
|
|
49
|
+
máy thật):
|
|
50
|
+
|
|
51
|
+
1. Cài `ak` bằng `irm https://agentkit.best/install.ps1 | iex`, rồi mở terminal
|
|
52
|
+
mới.
|
|
53
|
+
2. Chạy `npx --yes @thieung/agentkit-helper` (hoặc `akh` sau khi npm install
|
|
54
|
+
global).
|
|
55
|
+
3. Trong TUI, chọn **Dùng project hiện tại** (hoặc `akh install --project .`).
|
|
56
|
+
4. Cài một runtime, rồi chạy `update-all` cho install đó.
|
|
57
|
+
|
|
46
58
|
<details>
|
|
47
59
|
<summary><strong>Cách dùng CLI nâng cao</strong></summary>
|
|
48
60
|
|
package/bin/agentkit-helper.mjs
CHANGED
|
@@ -415,10 +415,6 @@ function warnBetaLifecycle(channel) {
|
|
|
415
415
|
}
|
|
416
416
|
|
|
417
417
|
async function prepareBetaBinary(commandOptions, { requiresPreview = false } = {}) {
|
|
418
|
-
const currentVersion = installedAkVersion.replace(/^ak\s+/i, "");
|
|
419
|
-
if (!currentVersion || currentVersion.includes("-")) {
|
|
420
|
-
return { proceed: true, updated: false };
|
|
421
|
-
}
|
|
422
418
|
warnBetaLifecycle("beta");
|
|
423
419
|
const check = parseSelfUpdateOutput((await runCapture(
|
|
424
420
|
akBinary, selfUpdateJsonCheckArgs("beta"),
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@thieung/agentkit-helper",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
4
|
"description": "Community helper for installing and updating AgentKit kits by runtime and channel",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"LICENSE"
|
|
18
18
|
],
|
|
19
19
|
"scripts": {
|
|
20
|
-
"test": "node
|
|
20
|
+
"test": "node scripts/test.mjs",
|
|
21
21
|
"check": "node scripts/check.mjs"
|
|
22
22
|
},
|
|
23
23
|
"engines": {
|
package/scripts/test.mjs
ADDED
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { spawnSync } from "node:child_process";
|
|
2
|
+
import { readdirSync } from "node:fs";
|
|
3
|
+
|
|
4
|
+
const files = readdirSync("test")
|
|
5
|
+
.filter((name) => name.endsWith(".test.mjs"))
|
|
6
|
+
.sort()
|
|
7
|
+
.map((name) => `test/${name}`);
|
|
8
|
+
|
|
9
|
+
const result = spawnSync(
|
|
10
|
+
process.execPath,
|
|
11
|
+
["--test", "--test-concurrency=1", ...files],
|
|
12
|
+
{ stdio: "inherit" },
|
|
13
|
+
);
|
|
14
|
+
if (result.error) throw result.error;
|
|
15
|
+
process.exit(result.status ?? 1);
|