@celljs/ta-app-use 0.0.0-stage → 4.18.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 ADDED
@@ -0,0 +1,29 @@
1
+ # @celljs/ta-app-use
2
+
3
+ [简体中文](./README.md)
4
+
5
+ A built-in package of Ta: agents do to Ta what you do with its pages. Say "turn on call captions", "pin that conversation" or "turn the town off" and it runs the action of the catalog of ta serve, with the same result as your tap; every page of yours shows the change at once, with a notice and Undo. Design in [ta-app-use.md](../../docs/design/ta-app-use.md).
6
+
7
+ ## Two kinds of doing
8
+
9
+ - **Direct calls**: what ends as data (settings, pins, stops, extensions on or off, answers to what waits for you to decide) goes through the catalog of actions, no page in between, with the phone locked too.
10
+ - **Operating the screen**: what needs what is on the screen now, a "show me", or a page of an extension with nothing else, is done on a page of Ta as a browser use, with a cursor and motion. By default on **the page you use**, as your shadow: on a phone's page on a phone, a computer's on a computer, with a pill "Ta is at work · Stop"; in a call it takes you to another page and the call goes on. Long work you need not watch (`apart: true`) is done on **Ta's own screen** (a `?ta-screen` frame in your page: in a corner of a computer, to drag, enlarge or put away; on a phone the pill has Watch too).
11
+
12
+ ## Tools
13
+
14
+ | Tool | Does |
15
+ | --- | --- |
16
+ | `app_commands({ query? })` | The actions: id, what each does, its input and risk |
17
+ | `app_run({ command, input? })` | Runs one, checked for who asked the run |
18
+ | `app_look({ part?, apart? })` | What is on the screen: where it is, the places to go, the parts (the list of conversations, the conversation, the settings...) with their rows and what each does, and what else can be clicked or typed into, each with an id |
19
+ | `app_go({ to, apart? })` | Goes to a page, a list, a section of the settings or a conversation (`chat:<name>`), and says what is there |
20
+ | `app_do({ id, action?, input?, show?, apart? })` | Clicks, types, chooses, or does an action of a part, answering only what changed; on Ta's own screen one that stands for an action of the catalog runs as `app_run` unless `show: true` |
21
+ | `app_do({ find, to? })` | Without a look first: goes to `to`, finds what the screen calls so and does it, one step for three; the whole screen when not found |
22
+
23
+ Actions of Ta: `settings.get`, `settings.set`, `chats.list`, `chats.pin`, `chats.stop`, `asks.list`, `asks.answer`, `extensions.list`, `extensions.set`. Other packages add theirs with `host.commands.register(...)` on their server side; they go when the package is turned off.
24
+
25
+ What cannot be undone (`danger`) waits for you to agree on your screen. A call's front has these tools too, so "turn the captions on" is done as it talks, and what waits for you to decide is answered with what you say. A session that speaks with other people for you (a room) has none of them.
26
+
27
+ ## Notices
28
+
29
+ An action that changed something is kept in `done` of the data of this package (the latest 20); a page shows a new one as "Ta changed settings: Call captions on · Undo". Undo goes through `callHost('undo', id)`, checked for who tapped it.
package/README.md CHANGED
@@ -1,3 +1,29 @@
1
- # Temporary Holding Version
1
+ # @celljs/ta-app-use
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
+ [English](./README.en.md)
4
+
5
+ Ta 的内置包:智能体替你操作 Ta。你说"打开通话字幕""把那个对话置顶""关掉小镇",它直接调 ta serve 的动作目录做好,和你在界面上点的结果一样;你的每一页马上看到变化,并弹一行提示,可以撤销。设计见 [ta-app-use.md](../../docs/design/ta-app-use.md)。
6
+
7
+ ## 两类操作
8
+
9
+ - **直接调用**:结果是一份数据的(设置、置顶、停止、开关扩展、替你回答待你决定的),调动作目录,不经过页面,手机锁屏也能做。
10
+ - **界面操作**:要看屏幕上此刻有什么、要"做给你看"、或只有界面的扩展页,像 browser use 一样操作 Ta 的页面,带光标和动画。默认就在**你正在用的那一页**上做,像你的影子:手机上在手机界面点,电脑上在电脑界面点,顶部胶囊"Ta 正在操作 · 停止";打电话时它带你换页,通话不断。不用你看的长活(`apart: true`)在 **Ta 自己的屏幕**上做(你页面里的一个 `?ta-screen` 小窗:电脑上在角落,可拖动、放大、收起;手机上胶囊多一个"看看")。
11
+
12
+ ## 工具
13
+
14
+ | 工具 | 做什么 |
15
+ | --- | --- |
16
+ | `app_commands({ query? })` | 查有哪些动作:id、做什么、参数、风险 |
17
+ | `app_run({ command, input? })` | 执行一个动作,按这一轮的发起人检查权限 |
18
+ | `app_look({ part?, apart? })` | 屏幕上现在有什么:在哪、能去哪、各部分(对话列表、对话、设置……)的行和能做的事、其余能点能输入的,每样带 id |
19
+ | `app_go({ to, apart? })` | 走到一页、一个列表、设置某一节或一个对话(`chat:<名字>`),返回到了以后的样子 |
20
+ | `app_do({ id, action?, input?, show?, apart? })` | 点、输入、选择,或做某一部分的动作,回答只说变了什么;在 Ta 自己的屏幕上时,指向动作目录的直接按 `app_run` 做,除非 `show: true` |
21
+ | `app_do({ find, to? })` | 不先看:`to` 先走过去,按屏幕上的字找到再做,一步顶三步;找不到就给整屏 |
22
+
23
+ 核心动作:`settings.get`、`settings.set`、`chats.list`、`chats.pin`、`chats.stop`、`asks.list`、`asks.answer`、`extensions.list`、`extensions.set`。别的包在服务端用 `host.commands.register(...)` 加自己的动作,包关掉时随之去掉。
24
+
25
+ 不能撤销的(`danger`)一律先在你的屏幕上弹确认框,你点了才做。通话的前台也有这些工具,"把字幕打开"当场就做,"待你决定"的照你说的替你回答。房间里替你和别人说话的会话没有它们。
26
+
27
+ ## 页面提示
28
+
29
+ 改了东西的动作记在本包数据的 `done` 里(最近 20 条);页面看到新的一条就弹提示"Ta 修改了设置:通话字幕 开 · 撤销"。撤销经 `callHost('undo', id)`,按点它的人检查权限。