@celljs/ta-extensions 4.7.0 → 4.8.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/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@celljs/ta-extensions",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.8.0",
|
|
4
4
|
"description": "A pi package for Ta: the page of extensions, where the user makes one by saying what it should do, and hands extensions on or takes them in as one file",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"pi-package"
|
|
@@ -27,8 +27,8 @@
|
|
|
27
27
|
"watch": "tsc -b -w --preserveWatchOutput"
|
|
28
28
|
},
|
|
29
29
|
"devDependencies": {
|
|
30
|
-
"@celljs/ta-protocol": "4.
|
|
31
|
-
"@celljs/ta-web": "4.
|
|
30
|
+
"@celljs/ta-protocol": "4.8.0",
|
|
31
|
+
"@celljs/ta-web": "4.8.0",
|
|
32
32
|
"@types/react": "^19.3.0"
|
|
33
33
|
},
|
|
34
34
|
"publishConfig": {
|
|
@@ -55,6 +55,7 @@ export default function (pi) {
|
|
|
55
55
|
- `ui.input(title, placeholder?, { value? })` and `ui.editor(title, prefill?)`: ask for one line or several, as pi's; they resolve with the text, or `undefined` when the user cancelled.
|
|
56
56
|
- `ui.openEditor({ id, title, render, icon?, onClose? }, { preview?, preserveFocus? })`: a tab beside the conversation, for a file, a diff, a page or anything to read at length; opening an id that is open shows it again. With `preview` (a single click), the next preview takes its place until it is kept (`ui.pinEditor(id)`, or a double click on it). `ui.setEditorDirty(id, dirty)` marks it changed and not saved: the user is asked before it closes. `ui.closeEditor(id)` closes it; `onClose` runs when the user does. `ui.useActiveEditor()`: a React hook, the id of the tab shown.
|
|
57
57
|
- `ui.CodeEditor` (`{ path, value, readOnly?, line?, column?, endColumn?, selection?, onChange?, onSave? }`; `selection`, `{ startLine, startColumn?, endLine?, endColumn? }`, selects those lines and shows them in the middle) and `ui.DiffEditor` (`{ path, original, modified, inline?, readOnly?, onChange?, onSave?, onDiff? }`): Monaco, bundled with the page, for the text of a file and the change between two texts.
|
|
58
|
+
- `ui.createTerminal({ cols?, rows?, cwd? })`: a terminal as VS Code's (xterm.js on WebGL, in the page's theme), loaded the first time one is made; URLs and paths of files in it (`src/a.ts:10:5`) open with Cmd or Ctrl + click, paths from `cwd` or the directory the shell reports (OSC 7): `write(data)` the program's output, `onData(listener)` what the user types, `onResize(listener)` its new size in characters, `attach(element)` shows it in an element with a size and `position: relative` (returns the function that takes it out; it keeps its screen meanwhile), `focus()`, `dispose()`. `pi.terminals` runs a shell of the server behind it.
|
|
58
59
|
- `ui.useCwd()`: a React hook, the directory of the conversation shown. `ui.useSessionId()`: the session of the conversation shown.
|
|
59
60
|
- `ui.showView(id)`: shows a view of any extension by its id, a page in the main area or a workbench tool as its tab; `''` shows the conversation again. `ui.useView(id)`: a React hook, `{ title, location, shown, menu? }` while that view is loaded, else `undefined`.
|
|
60
61
|
- `ui.Composer`: the message box of every conversation, `{ placeholder?, onSend(text), mentions?, mentionLabel?, actions? }`: `mentions` (`{ name, detail? }[]`) is what `@` lists; `actions` are sections of its + menu, entries `{ key, label, icon?, detail?, insert? | run() }` (`insert` puts text at the caret). Use it for any conversation an extension shows, rather than a box of its own. `ui.Markdown` (`{ text }`) renders messages as the conversations do. `ui.Dialog` (`{ title, onClose, children }`) is a dialog over the whole page, as Ta's own: use it to make or change things rather than a form in a sidebar.
|
|
@@ -70,7 +71,7 @@ The two halves talk through the conversation: the web extension sends `/command
|
|
|
70
71
|
|
|
71
72
|
## Packages that come with Ta
|
|
72
73
|
|
|
73
|
-
Ta comes with some packages of its own, which are on until the user turns them off in Settings → Extensions: `@celljs/ta-workspace` (the explorer, search, source control, terminals and browser beside the conversation), `@celljs/ta-channels` (agents and channels), `@celljs/ta-computer-use` (desktop apps through Cua Driver) and `@celljs/ta-extensions` (this skill, and the Extensions page in the navigation, which lists the user's packages to change, export or remove and imports others). Do not copy or change them; build a new package for something new. The web page calls packages "extensions": use that word with the user.
|
|
74
|
+
Ta comes with some packages of its own, which are on until the user turns them off in Settings → Extensions: `@celljs/ta-workspace` (the explorer, search, source control, terminals and browser beside the conversation), `@celljs/ta-channels` (agents and channels), `@celljs/ta-computer-use` (desktop apps through Cua Driver), `@celljs/ta-changes` (the files each reply changed, their diffs, and undo), `@celljs/ta-cron` (prompts that run on a schedule, with the Scheduled page, `/loop`, `/remind`, `/schedule` and the tool `schedule_task`), `@celljs/ta-agents` (other coding agents such as CodeBuddy Code, Claude Code and Codex as models) and `@celljs/ta-extensions` (this skill, and the Extensions page in the navigation, which lists the user's packages to change, export or remove and imports others). Do not copy or change them; build a new package for something new. The web page calls packages "extensions": use that word with the user.
|
|
74
75
|
|
|
75
76
|
Under `ta serve`, with `@celljs/ta-channels` on, you have tools to build a team for what the user wants: `create_agent` (a name and a role: another Ta with its own session), `create_channel` (agents, the lead first), `add_to_channel` (agents that exist, after the members; the lead stays), `post_to_channel` (a message; the agents it names with @ answer, or the lead, and they may hand on a few times) and `list_channels`. The agents run in ta serve, so they go on when the page closes. When the user asks for a team, for roles working together or for a review by several hands, create the agents and the channel and post the goal; do not write a package for it. In `ta` without `serve` the tools say they need `ta serve`: tell the user so.
|
|
76
77
|
|
|
@@ -87,4 +88,4 @@ A package travels as one `.tgz` file: a gzipped tar of its directory, the direct
|
|
|
87
88
|
|
|
88
89
|
1. `node --check web.js` and, for the pi extension, read it once more against pi's documentation.
|
|
89
90
|
2. When your reply on the web page ends, the page loads new and changed web extensions and their tools, and reloads the pi extensions of its conversation. Otherwise the page loads them when it is shown again, and `/reload` reloads pi extensions in the terminal. Do not ask the user to restart anything.
|
|
90
|
-
3. Tell the user in one or two sentences what the package does and where it shows. No file listings unless asked.
|
|
91
|
+
3. Tell the user in one or two sentences what the package does and where it shows. No file listings unless asked.
|