@telepath-computer/television 0.1.21 → 0.1.22
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/dist/browser/assets/index-C0Ygc25s.js +555 -0
- package/dist/browser/index.html +1 -1
- package/dist/cli.cjs +12234 -3399
- package/dist/electron.cjs +16815 -7993
- package/package.json +4 -2
- package/skill/SKILL.md +43 -7
- package/dist/browser/assets/index-DO80WnGA.js +0 -555
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@telepath-computer/television",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.22",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"main": "dist/electron.cjs",
|
|
6
6
|
"bin": {
|
|
@@ -53,7 +53,9 @@
|
|
|
53
53
|
"marked": "^17.0.4",
|
|
54
54
|
"store-thing": "^0.2.0",
|
|
55
55
|
"ulid": "^3.0.2",
|
|
56
|
-
"
|
|
56
|
+
"watcher": "^2.3.1",
|
|
57
|
+
"ws": "^8.19.0",
|
|
58
|
+
"zod": "^4.3.6"
|
|
57
59
|
},
|
|
58
60
|
"devDependencies": {
|
|
59
61
|
"@eslint/js": "^9.39.4",
|
package/skill/SKILL.md
CHANGED
|
@@ -22,6 +22,7 @@ All artifacts have:
|
|
|
22
22
|
|
|
23
23
|
- `type`: the type string (`markdown` or `html`; defaults to `markdown`)
|
|
24
24
|
- `title`: user-visible title shown in the workspace
|
|
25
|
+
- `path`: absolute file path to the artifact source on disk
|
|
25
26
|
|
|
26
27
|
### Markdown (default)
|
|
27
28
|
|
|
@@ -30,7 +31,7 @@ Use this for documents, reports, plans, status updates, or any content that bene
|
|
|
30
31
|
Properties:
|
|
31
32
|
|
|
32
33
|
- `type`: `markdown`
|
|
33
|
-
- `
|
|
34
|
+
- `path`: absolute path to a `.md` file
|
|
34
35
|
|
|
35
36
|
### HTML
|
|
36
37
|
|
|
@@ -39,7 +40,9 @@ Use this for structured layouts, dashboards, data displays, or anything that nee
|
|
|
39
40
|
Properties:
|
|
40
41
|
|
|
41
42
|
- `type`: `html`
|
|
42
|
-
- `
|
|
43
|
+
- `path`: absolute path to an `.html` file
|
|
44
|
+
|
|
45
|
+
HTML files should still be body-fragment style content for Television artifact rendering, not full standalone HTML documents.
|
|
43
46
|
|
|
44
47
|
```html
|
|
45
48
|
<!-- Bad — rejected -->
|
|
@@ -89,19 +92,52 @@ tv get-workspace
|
|
|
89
92
|
tv get-workspace --id "workspace-id"
|
|
90
93
|
```
|
|
91
94
|
|
|
95
|
+
This returns artifact metadata and file paths, not full artifact contents.
|
|
96
|
+
|
|
92
97
|
### Create an artifact
|
|
93
98
|
|
|
94
99
|
```bash
|
|
95
|
-
tv create-artifact --
|
|
96
|
-
tv create-artifact --
|
|
97
|
-
tv create-artifact --
|
|
100
|
+
tv create-artifact --path "/absolute/path/to/plan.md"
|
|
101
|
+
tv create-artifact --type html --path "/absolute/path/to/dashboard.html"
|
|
102
|
+
tv create-artifact --path "/absolute/path/to/plan.md" --workspace "workspace-id"
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Create the file first, then pass its path to Television.
|
|
106
|
+
|
|
107
|
+
Validation rules:
|
|
108
|
+
|
|
109
|
+
- path must be absolute
|
|
110
|
+
- markdown paths must end in `.md`
|
|
111
|
+
- html paths must end in `.html`
|
|
112
|
+
- file must exist
|
|
113
|
+
- file must be readable
|
|
114
|
+
|
|
115
|
+
Television stores artifacts as file pointers. If you need the artifact contents, read the file directly from the path.
|
|
116
|
+
|
|
117
|
+
If validation fails, the CLI exits non-zero with a clear error.
|
|
118
|
+
|
|
119
|
+
### Find the Television data directory
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
tv data-dir
|
|
98
123
|
```
|
|
99
124
|
|
|
125
|
+
Use this when the file belongs specifically to Television workspace state and does not already live in another project.
|
|
126
|
+
|
|
127
|
+
Guidance:
|
|
128
|
+
|
|
129
|
+
- best: put the file somewhere in the user's actual files where it is relevant to the artifact's purpose
|
|
130
|
+
- next best: put workspace-specific generated files in the Television data directory
|
|
131
|
+
- third best: put the file in the OpenClaw workspace if it is just transient working material
|
|
132
|
+
|
|
133
|
+
Do not put Television artifacts in a temp directory. Temp folders are an anti-pattern because the files are easy to lose and not meaningfully located.
|
|
134
|
+
|
|
135
|
+
Television does not own or delete the underlying files when artifacts are removed.
|
|
136
|
+
|
|
100
137
|
### Update an artifact
|
|
101
138
|
|
|
102
139
|
```bash
|
|
103
|
-
tv update-artifact --id "artifact-id" --
|
|
104
|
-
tv update-artifact --id "artifact-id" --title "New title" --content "New content"
|
|
140
|
+
tv update-artifact --id "artifact-id" --title "New title"
|
|
105
141
|
```
|
|
106
142
|
|
|
107
143
|
### Remove an artifact
|