grokbox 0.1.0-alpha.6 → 0.1.0-alpha.7

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 CHANGED
@@ -10,9 +10,9 @@ This project is not affiliated with or endorsed by Anysphere, Cursor, xAI, or
10
10
  Grok Bot. Grok Bot, Cursor, and related names identify compatible products and
11
11
  remain the property of their respective owners.
12
12
 
13
- > **Alpha:** current source is `0.1.0-alpha.6`. npm `next` currently points to
14
- > `0.1.0-alpha.5`; `0.0.1` remains `latest`. `v0.1.0-alpha.1` through
15
- > `v0.1.0-alpha.4` exist as Git tags only. Prereleases publish only after
13
+ > **Alpha:** current source is `0.1.0-alpha.7`. npm `next` currently points to
14
+ > `0.1.0-alpha.6`; `0.0.1` remains `latest`. `v0.1.0-alpha.1` through
15
+ > `v0.1.0-alpha.6` exist as Git tags only. Prereleases publish only after
16
16
  > release checks and explicitly scoped external acceptance.
17
17
 
18
18
  ## What it does
@@ -36,7 +36,7 @@ Highlights:
36
36
 
37
37
  - strict local and remote Profiles with separate credential authorities;
38
38
  - finite Unix-socket/loopback daemon and private Tailscale Serve mapping;
39
- - agent/group management, send, transcript, Memory, and bounded events;
39
+ - agent/group and native Routine lifecycle management, send, transcript, Memory, and bounded events;
40
40
  - named-root governed file reads and mutations;
41
41
  - literal structured execution with durable Jobs and bounded logs;
42
42
  - layered read-only diagnosis and explicit recovery;
@@ -138,14 +138,18 @@ grokbox profile list --table
138
138
  grokbox doctor
139
139
  grokbox daemon status
140
140
  grokbox agents list --table
141
+ grokbox agents routines list <agent> --table
141
142
  grokbox groups list --table
142
143
  grokbox history tail <target> --limit 20
143
144
  grokbox memory list <agent>
145
+ grokbox export agent <agent> --out ./export
144
146
  grokbox fs stat workspace:/artifact.txt
145
147
  grokbox jobs list --table
146
148
  grokbox desktop status --table
147
149
  ```
148
150
 
151
+ Routine reads expose bounded metadata only: prompt bodies, webhook credentials, native paths, and unknown provider fields stay private. Routine create always writes a disabled definition; update/enable/disable/delete require explicit confirmation, and all mutations other than create also require the exact revision from a fresh `agents routines list/show`. Upstream Routine writes have no native compare-and-swap or idempotency contract, so an uncertain acknowledgement is never replayed automatically.
152
+
149
153
  Mutating commands require explicit capability and, where destructive, explicit
150
154
  confirmation. `desktop prune run` defaults to dry-run; `--yes` invokes the
151
155
  upstream stop-window path and deletes that fork's Chrome profile.
package/README.zh-CN.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  本项目与 Anysphere、Cursor、xAI 或 Grok Bot 没有隶属或背书关系。Grok Bot、Cursor 及相关名称仅用于标识兼容产品,其权利归各自所有者。
8
8
 
9
- > **Alpha:** 当前源码版本是 `0.1.0-alpha.6`。npm 的 `next` dist-tag 目前指向 `0.1.0-alpha.5`;`0.0.1` 仍是 `latest`。`v0.1.0-alpha.1` 到 `v0.1.0-alpha.4` 只存在于 Git tag。只有通过发布检查及明确范围的外部验收后,才会发布新的预发布版本。
9
+ > **Alpha:** 当前源码版本是 `0.1.0-alpha.7`。npm 的 `next` dist-tag 目前指向 `0.1.0-alpha.6`;`0.0.1` 仍是 `latest`。`v0.1.0-alpha.1` 到 `v0.1.0-alpha.6` 已有 Git tag。只有通过发布检查及明确范围的外部验收后,才会发布新的预发布版本。
10
10
 
11
11
  ## 它能做什么
12
12
 
@@ -29,7 +29,7 @@ fs exec jobs desktop
29
29
 
30
30
  - 严格区分本机与远端 Profile,并分离不同凭据权威;
31
31
  - 有限的 Unix socket/loopback daemon 与私有 Tailscale Serve 映射;
32
- - Agent/Group 管理、消息发送、Transcript、Memory 和有界事件读取;
32
+ - Agent/Group 与原生 Routine 全生命周期管理、消息发送、Transcript、Memory 和有界事件读取;
33
33
  - 通过命名根目录治理文件读取与变更;
34
34
  - 字面量结构化执行、持久 Job 和有界日志;
35
35
  - 分层只读诊断与显式恢复;
@@ -118,14 +118,18 @@ grokbox profile list --table
118
118
  grokbox doctor
119
119
  grokbox daemon status
120
120
  grokbox agents list --table
121
+ grokbox agents routines list <agent> --table
121
122
  grokbox groups list --table
122
123
  grokbox history tail <target> --limit 20
123
124
  grokbox memory list <agent>
125
+ grokbox export agent <agent> --out ./export
124
126
  grokbox fs stat workspace:/artifact.txt
125
127
  grokbox jobs list --table
126
128
  grokbox desktop status --table
127
129
  ```
128
130
 
131
+ Routine 读取只输出有界元数据,不暴露 prompt 正文、Webhook credential、原生路径或未知 provider 字段。Routine create 始终只创建 disabled definition;update/enable/disable/delete 需要显式确认,create 之外的 mutation 还必须携带刚从 `agents routines list/show` 读到的精确 revision。上游 Routine 写接口没有 native compare-and-swap 或 idempotency 合同,因此回执不确定时不会自动重放。
132
+
129
133
  变更命令需要显式 capability;破坏性操作还需要显式确认。`desktop prune run` 默认 dry-run;传入 `--yes` 后会调用上游 stop-window 路径,并删除该 fork 的 Chrome profile。
130
134
 
131
135
  ## 凭据