@celljs/ta-rooms 4.24.0 → 4.25.0

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.en.md CHANGED
@@ -1,31 +1,31 @@
1
- # Cell - Ta Rooms
1
+ # Cell - Ta Group chats
2
2
 
3
- A pi package that comes with Ta (on by default; Settings → Extensions turns it off): rooms shared with other Ta. The design is in [docs/design/ta-link.md](../../docs/design/ta-link.md), sections 3, 4 and 5.
3
+ A pi package that comes with Ta (on by default; Settings → Extensions turns it off): group chats shared with other Ta. The design is in [docs/design/ta-link.md](../../docs/design/ta-link.md), sections 3, 4 and 5.
4
4
 
5
- The rooms themselves are the Ta service's (`TaRoomServer`, `pi.rooms` for web extensions); this package is what the user sees of them:
5
+ The group chats themselves are the Ta service's (`TaRoomServer`, `pi.rooms` for web extensions); this package is what the user sees of them:
6
6
 
7
- - **The Rooms page** (Discover → Rooms), as a messenger lists its chats: who asks to join on top; a row for each room (the faces of its members, its name, the time, who said the last thing and what, an amber dot for what you have not read); the way to your friends and your name in rooms under them. The + of its head: a new room, join by a link, scan a code, add a friend, your name. The page knows no extension: a room an extension made shows the icon and the name of its page (the Town); one it keeps for itself (`unlisted`, as the room of the user's computers of Sync) is not listed, nor a group chat, nor a room of doubles, nor who asks to join it: the extension asks the user itself.
8
- - **Group chat**: on a computer or a tablet beside the list; on a phone, pushed over it (back in the head or a swipe from the left edge). Every room has one, the Town's too: others on the left, you on the right, and above it, for a room of an extension, Open Town. What is said is kept in the shared state of the room, for those who come later; each member writes keys of its own alone, so nobody speaks as another.
7
+ - **The Group chats page** (Discover → Group chats), as a messenger lists its chats: who asks to join on top; a row for each group chat (the faces of its members, its name, the time, who said the last thing and what, an amber dot for what you have not read); the way to your friends and your name in group chats under them. The + of its head: a new group chat, join by a link, scan a code, add a friend, your name. The page knows no extension: a group chat an extension made shows the icon and the name of its page (the Town); one it keeps for itself (`unlisted`, as the group chat of the user's computers of Sync) is not listed, has no chat and no doubles, nor who asks to join it: the extension asks the user itself.
8
+ - **The chat**: on a computer or a tablet beside the list; on a phone, pushed over it (back in the head or a swipe from the left edge). A group chat of an extension has one too, the Town's: others on the left, you on the right, and above it, for a group chat of an extension, Open Town. What is said is kept in the shared state of the group chat, for those who come later; each member writes keys of its own alone, so nobody speaks as another.
9
9
  - **Web guests**: one without Ta who opens a link that invites in a browser asks to join there; the dialog of asks and the members say so (Web guest). Let in, they only chat.
10
- - **Members of the room** (··· of the chat, in the workbench): who is in it and online, invite and take out (the owner), open its page, your name, and leave or close the room.
11
- - **Asking to join**: when someone asks to join a room of yours by its link or code, a dialog says whether they are your friend, for you to let them in or refuse. Asks that came while you were away are shown when Ta opens.
12
- - **Links that invite**: it opens `https://<relay>/r#…` links (clicked, scanned or pasted in Quick open), asking you first, and saying that your name goes to the owner; once let in, you are told, and a room you just asked to join opens its page (the Ta town).
10
+ - **Members of the group chat** (··· of the chat, in the workbench): who is in it and online, invite and take out (the owner), open its page, your name, and leave or close the group chat.
11
+ - **Asking to join**: when someone asks to join a group chat of yours by its link or code, a dialog says whether they are your friend, for you to let them in or refuse. Asks that came while you were away are shown when Ta opens.
12
+ - **Links that invite**: it opens `https://<relay>/r#…` links (clicked, scanned or pasted in Quick open), asking you first, and saying that your name goes to the owner; once let in, you are told, and a group chat you just asked to join opens its page (the Ta town).
13
13
  - **Invite**: the owner gets the link and its QR code, to copy, send or make anew (the old one stops working).
14
- - **Doubles in rooms**: @ someone's double in a chat (`@Ann's double`) and their Ta answers in the room, with no page open, if they let it; yours answers others the same way, as `Your double`, and you turn it off per room in its members. By default a double only chats and reads or sets the shared state of the room. To work on your computer for someone it asks you, or you give it with the key by a member: read and change the files of one directory, run commands there, for an hour, a day or a week. What your double did (the + of the Rooms page, or the members) lists the permissions, takes them back, stops all for one, and every answer it gave.
15
- - **Agents in rooms**: Invite an agent in the members of a room (an empty room has the button too) to bring one of the agents of your double's side bar in, so that you try a room on your own. Whoever @s it in the room (`@Designer`) gets an answer: when you ask, it works as usual, with its tools in its directory; when others ask, it only chats, as your double, unless you let it do more for them. Ask it to leave in the members.
16
- - **Rooms on the double's home**: with rooms, the double's side bar has a Rooms section, which Settings → Rooms turns off.
17
- - **Your conversations in rooms**: your double and conversations have `list_rooms`, `read_room` and `say_in_room`, to tell a room something for you or to ask another's double.
18
- - **Tasks between doubles**: tell your double "have Ann's double count her reading notes" and it hands the task to hers with `hand_task`. Her Ta does it with what she lets it do for you (asking her first when she has not, and going on by itself once she says yes), and the result comes back to the conversation that handed it, where your double tells you. In the room the line of the task shows how it goes (queued, working on it, waiting for a permission, done); both doubles' homes list it under Tasks, where the one who handed it calls it off and the one doing it stops it.
14
+ - **Doubles in group chats**: @ someone's double in a chat (`@Ann's double`) and their Ta answers in the group chat, with no page open, if they let it; yours answers others the same way, as `Your double`, and you turn it off per group chat in its members. By default a double only chats and reads or sets the shared state of the group chat. To work on your computer for someone it asks you, or you give it with the key by a member: read and change the files of one directory, run commands there, for an hour, a day or a week. What your double did (the + of the Group chats page, or the members) lists the permissions, takes them back, stops all for one, and every answer it gave.
15
+ - **Agents in group chats**: Invite an agent in the members of a group chat (an empty group chat has the button too) to bring one of the agents of your double's side bar in, so that you try a group chat on your own. Whoever @s it in the group chat (`@Designer`) gets an answer: when you ask, it works as usual, with its tools in its directory; when others ask, it only chats, as your double, unless you let it do more for them. Ask it to leave in the members.
16
+ - **Group chats on the double's home**: with group chats, the double's side bar has a Group chats section, which Settings → Group chats turns off.
17
+ - **Your conversations in group chats**: your double and conversations have `list_groups`, `read_group` and `say_in_group`, to tell a group chat something for you or to ask another's double.
18
+ - **Tasks between doubles**: tell your double "have Ann's double count her reading notes" and it hands the task to hers with `hand_task`. Her Ta does it with what she lets it do for you (asking her first when she has not, and going on by itself once she says yes), and the result comes back to the conversation that handed it, where your double tells you. In the group chat the line of the task shows how it goes (queued, working on it, waiting for a permission, done); both doubles' homes list it under Tasks, where the one who handed it calls it off and the one doing it stops it.
19
19
 
20
20
  ## Safety
21
21
 
22
22
  - A link or a code only asks to join: the owner lets one in, in their own Ta; neither a double nor a tool can say yes for them.
23
- - Messages, the shared state and the roster of a room are signed and sealed on the members' computers before they pass the relay, which sees ciphertext and ids of members of one room each.
23
+ - Messages, the shared state and the roster of a group chat are signed and sealed on the members' computers before they pass the relay, which sees ciphertext and ids of members of one group chat each.
24
24
  - A double answers others in a session of its own, never in your conversations: what they wrote is untrusted input to it, it reads none of your AGENTS.md or skills, and the tools it may use are held to in the session (others are refused), the files to the directory given. Only you give a permission, in a dialog; a double only asks.
25
- - When others ask your agent, it is held as your double is (tools, directory, permissions); only when you ask it in a room does it use its usual tools.
25
+ - When others ask your agent, it is held as your double is (tools, directory, permissions); only when you ask it in a group chat does it use its usual tools.
26
26
  - A task others hand your double is held as a question is: only what you let it do for that person, one at a time for each, five waiting at most, an hour at most each; taking a permission back, or stopping all for one, stops what it does for them at once. Its result reaches their conversation marked as written by another's Ta, untrusted.
27
- - **Friends** (Discover → Friends): Ta has one kind of friend, on the word of both; being in a room together is not enough. Add one by a code or a link, or from the members of a room (they agree in their own Ta). New friends show on top of the page, and you are told. Removing one ends it on both sides; the rooms you share stay. Moments, shares to chosen friends and Nearby all use these friends.
28
- - The keys of your identity (`identity.json`), of your rooms (`rooms.json`) and your friends (`friends.json`) are in the agent directory, readable by you alone.
27
+ - **Friends** (Discover → Friends): Ta has one kind of friend, on the word of both; being in a group chat together is not enough. Add one by a code or a link, or from the members of a group chat (they agree in their own Ta). New friends show on top of the page, and you are told. Removing one ends it on both sides; the group chats you share stay. Moments, shares to chosen friends and Nearby all use these friends.
28
+ - The keys of your identity (`identity.json`), of your group chats (`rooms.json`) and your friends (`friends.json`) are in the agent directory, readable by you alone.
29
29
 
30
30
  ## Development
31
31
 
package/README.md CHANGED
@@ -1,31 +1,31 @@
1
- # Cell - Ta Rooms
1
+ # Cell - Ta Group chats
2
2
 
3
- Ta 自带的 pi 包(默认开启,可在 设置 → 扩展 关闭):和别人的 Ta 共用的房间。设计记录见 [docs/design/ta-link.md](../../docs/design/ta-link.md) 第 3、4、5 节。
3
+ Ta 自带的 pi 包(默认开启,可在 设置 → 扩展 关闭):和别人的 Ta 共用的群聊。设计记录见 [docs/design/ta-link.md](../../docs/design/ta-link.md) 第 3、4、5 节。
4
4
 
5
- 房间本身由 Ta 服务持有(`TaRoomServer`,Web 扩展的 `pi.rooms`),这个包只负责界面:
5
+ 群聊本身由 Ta 服务持有(`TaRoomServer`,Web 扩展的 `pi.rooms`),这个包只负责界面:
6
6
 
7
- - **房间页**(发现 → 房间):照微信的会话列表。待处理的加入申请在最上面;每个房间一行(成员拼图头像、名字、时间、"谁:最后一句",有新消息时头像角上有黄点);下面是"好友"入口和你在房间里的名字。顶栏 + 号:新建房间、用邀请链接加入、扫一扫、加好友、改名字。房间页不认识具体扩展:扩展建的房间显示它页面的图标和名字(如"小镇");扩展自己用的房间(`unlisted`,如设备同步里只有你自己几台电脑的房间)不列出、不当群聊、分身也不进,加入申请也由那个扩展自己问你。
8
- - **群聊**:电脑和平板上列表和群聊左右并排,手机上点房间推入群聊(顶栏返回或左边缘右滑回到列表)。每个房间都有群聊,小镇的房间也是:别人在左、自己在右,扩展建的房间上方有"打开小镇"。聊天记录存在房间的共享状态里,后来的人也看得到;每人只写自己的键,谁也不能冒充别人。
7
+ - **群聊列表**(发现 → 群聊):照微信的会话列表。待处理的加入申请在最上面;每个群聊一行(成员拼图头像、名字、时间、"谁:最后一句",有新消息时头像角上有黄点);下面是"好友"入口和你在群聊里的名字。顶栏 + 号:新建群聊、用邀请链接加入、扫一扫、加好友、改名字。群聊列表不认识具体扩展:扩展建的群聊显示它页面的图标和名字(如"小镇");扩展自己用的群聊(`unlisted`,如设备同步里只有你自己几台电脑的群聊)不列出、没有聊天、分身也不进,加入申请也由那个扩展自己问你。
8
+ - **聊天**:电脑和平板上列表和聊天左右并排,手机上点一行推入聊天(顶栏返回或左边缘右滑回到列表)。扩展建的群聊也能聊天,小镇的也是:别人在左、自己在右,扩展建的群聊上方有"打开小镇"。聊天记录存在群聊的共享状态里,后来的人也看得到;每人只写自己的键,谁也不能冒充别人。
9
9
  - **网页访客**:没装 Ta 的人在浏览器里打开邀请链接,也能申请加入;申请框和成员列表里标着"网页访客"。进来后只能聊天。
10
- - **房间成员**(群聊右上角 ···,在右侧工作台打开):成员与在线状态、邀请和移出(房主)、打开小镇、我的名字,以及退出或解散房间。
11
- - **加入申请**:有人用邀请链接或扫码申请加入你的房间时弹出确认框,写明对方是不是你的好友,由你同意或拒绝。离线期间收到的申请,下次打开 Ta 时提示。
12
- - **邀请链接**:认领 `https://<中继>/r#…` 链接(点击、扫码、在快捷打开里粘贴)。先问你是否申请加入、会把你的名字发给房主;房主同意后提示"已加入",刚申请过的房间自动打开它的页面(如 Ta 小镇)。
13
- - **邀请框**:房主点"邀请"看到链接和二维码,可复制、发送或换一个链接(旧链接作废)。
14
- - **房间里的分身**:在群聊里 @ 某人的分身(`@小林的分身`),对方允许时,TA 的 Ta 就在房间里回答,不需要开着页面;你的分身也这样回答别人(显示为"我的分身"),可以在房间成员里按房间关掉。分身默认只能聊天和读写房间共享内容;要在你的电脑上替某人做事,它会来请求,或者你点成员旁的钥匙主动给:在一个目录里读写文件、运行命令,1 小时、1 天或 7 天。"分身记录"(房间页 + 号或房间成员里)列出授权,可以收回、停掉某人的全部授权,也能看到分身的每次回答。
15
- - **房间里的智能体**:在房间成员里"邀请智能体"(空房间里也有按钮),把你在分身侧栏建的智能体拉进房间,一个人也能试房间。房间里谁 @ 它(`@设计师`)它就回答:你自己问时,它像平常一样在自己的目录里用工具做事;别人问时,和分身一样只能聊天,除非你授权。在成员里可以请它离开。
16
- - **分身首页的房间**:有房间时分身侧栏多一个"房间"分类,设置 → 房间里可以关掉。
17
- - **对话里用房间**:分身和你的对话有 `list_rooms`、`read_room`、`say_in_room` 三个工具,可以替你在房间里说话,或去问别人的分身。
18
- - **分身之间派任务**:对分身说"让小林的分身帮我统计下他的读书笔记",它用 `hand_task` 把任务交给对方的分身。对方的 Ta 按你得到的授权去做(没授权时先请对方同意,同意后自动接着做),做完结果回到交出任务的对话里,分身接着告诉你。房间里任务那句话下面显示进度(排队中、进行中、等待授权、已完成);两边分身首页的"任务"里都列着,交出的一方可以取消,做事的一方可以停止。
10
+ - **群聊成员**(群聊右上角 ···,在右侧工作台打开):成员与在线状态、邀请和移出(群主)、打开小镇、我的名字,以及退出或解散群聊。
11
+ - **加入申请**:有人用邀请链接或扫码申请加入你的群聊时弹出确认框,写明对方是不是你的好友,由你同意或拒绝。离线期间收到的申请,下次打开 Ta 时提示。
12
+ - **邀请链接**:认领 `https://<中继>/r#…` 链接(点击、扫码、在快捷打开里粘贴)。先问你是否申请加入、会把你的名字发给群主;群主同意后提示"已加入",刚申请过的群聊自动打开它的页面(如 Ta 小镇)。
13
+ - **邀请框**:群主点"邀请"看到链接和二维码,可复制、发送或换一个链接(旧链接作废)。
14
+ - **群聊里的分身**:在群聊里 @ 某人的分身(`@小林的分身`),对方允许时,TA 的 Ta 就在群聊里回答,不需要开着页面;你的分身也这样回答别人(显示为"我的分身"),可以在群聊成员里按群聊关掉。分身默认只能聊天和读写群聊共享内容;要在你的电脑上替某人做事,它会来请求,或者你点成员旁的钥匙主动给:在一个目录里读写文件、运行命令,1 小时、1 天或 7 天。"分身记录"(群聊列表 + 号或群聊成员里)列出授权,可以收回、停掉某人的全部授权,也能看到分身的每次回答。
15
+ - **群聊里的智能体**:在群聊成员里"邀请智能体"(空群聊里也有按钮),把你在分身侧栏建的智能体拉进群聊,一个人也能试群聊。群聊里谁 @ 它(`@设计师`)它就回答:你自己问时,它像平常一样在自己的目录里用工具做事;别人问时,和分身一样只能聊天,除非你授权。在成员里可以请它离开。
16
+ - **分身首页的群聊**:有群聊时分身侧栏多一个"群聊"分类,设置 → 群聊里可以关掉。
17
+ - **对话里用群聊**:分身和你的对话有 `list_groups`、`read_group`、`say_in_group` 三个工具,可以替你在群聊里说话,或去问别人的分身。
18
+ - **分身之间派任务**:对分身说"让小林的分身帮我统计下他的读书笔记",它用 `hand_task` 把任务交给对方的分身。对方的 Ta 按你得到的授权去做(没授权时先请对方同意,同意后自动接着做),做完结果回到交出任务的对话里,分身接着告诉你。群聊里任务那句话下面显示进度(排队中、进行中、等待授权、已完成);两边分身首页的"任务"里都列着,交出的一方可以取消,做事的一方可以停止。
19
19
 
20
20
  ## 安全
21
21
 
22
- - 链接和扫码只能发出申请,只有房主本人在界面上同意才能进;分身和工具都不能替你同意。
23
- - 房间里的消息、共享状态和成员名单都在成员的电脑上签名、加密后才经过中继,中继只看到密文和每个房间各自的随机成员 id。
22
+ - 链接和扫码只能发出申请,只有群主本人在界面上同意才能进;分身和工具都不能替你同意。
23
+ - 群聊里的消息、共享状态和成员名单都在成员的电脑上签名、加密后才经过中继,中继只看到密文和每个群聊各自的随机成员 id。
24
24
  - 分身在专门的会话里回答别人,不进你的对话:别人的话对它来说是不可信的输入;它读不到你的 AGENTS.md 和技能;能用哪些工具在会话里强制执行(其余的一律拒绝),文件限在授权目录里。授权只能由你在对话框里给,分身只能请求。
25
- - 别人问你的智能体时,它和分身一样受限(工具、目录、授权都一样);只有你自己在房间里问它时,它才用平常的工具。
25
+ - 别人问你的智能体时,它和分身一样受限(工具、目录、授权都一样);只有你自己在群聊里问它时,它才用平常的工具。
26
26
  - 别人交来的任务和问题一样受限:只能用你给那个人的授权,一次替一个人做一件,最多同时排 5 件,一件最长 1 小时;收回授权或"停掉全部"时正在做的任务立刻停下。任务的结果回到对方的对话时标明是别人的 Ta 写的,不可信。
27
- - **好友**(发现 → 好友):Ta 只有一种好友,双方都同意才算;只是同在一个房间不算。用二维码或链接加,或在房间成员面板里点"加好友"(对方在自己的 Ta 里同意)。新的好友在页面顶部,也会提醒你。删除后两边一起断开,一起所在的房间不受影响。动态、指定好友的分享、附近都用这一份好友。
28
- - 身份密钥(`identity.json`)、房间密钥(`rooms.json`)和好友(`friends.json`)存在 agent 目录,只有你自己可读。
27
+ - **好友**(发现 → 好友):Ta 只有一种好友,双方都同意才算;只是同在一个群聊不算。用二维码或链接加,或在群聊成员面板里点"加好友"(对方在自己的 Ta 里同意)。新的好友在页面顶部,也会提醒你。删除后两边一起断开,一起所在的群聊不受影响。动态、指定好友的分享、附近都用这一份好友。
28
+ - 身份密钥(`identity.json`)、群聊密钥(`rooms.json`)和好友(`friends.json`)存在 agent 目录,只有你自己可读。
29
29
 
30
30
  ## 开发
31
31