@telepath-computer/television 0.1.60 → 0.1.62
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/web/index.html
CHANGED
|
@@ -4,8 +4,8 @@
|
|
|
4
4
|
<meta charset="UTF-8" />
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
6
6
|
<title>Television</title>
|
|
7
|
-
<script type="module" crossorigin src="./assets/index-
|
|
8
|
-
<link rel="stylesheet" crossorigin href="./assets/index-
|
|
7
|
+
<script type="module" crossorigin src="./assets/index-cboIVKVn.js"></script>
|
|
8
|
+
<link rel="stylesheet" crossorigin href="./assets/index-BGAVNFjb.css">
|
|
9
9
|
</head>
|
|
10
10
|
<body></body>
|
|
11
11
|
</html>
|
package/package.json
CHANGED
package/skill/SKILL.md
CHANGED
|
@@ -34,9 +34,48 @@ in the current implementation.
|
|
|
34
34
|
The core workflow is:
|
|
35
35
|
|
|
36
36
|
1. Decide whether the result should be internal or external.
|
|
37
|
-
2.
|
|
38
|
-
3.
|
|
39
|
-
4.
|
|
37
|
+
2. Decide whether the user should be taken to the new screen or artifact now, or whether the work should happen in the background.
|
|
38
|
+
3. Create or stage the artifact with the CLI.
|
|
39
|
+
4. For internal artifacts, edit files in the pending bundle.
|
|
40
|
+
5. Commit when the validation rules are satisfied.
|
|
41
|
+
|
|
42
|
+
## Focus and viewer attention
|
|
43
|
+
|
|
44
|
+
Television separates state changes from viewer attention.
|
|
45
|
+
|
|
46
|
+
State changes:
|
|
47
|
+
|
|
48
|
+
- create a screen
|
|
49
|
+
- create an artifact on a screen
|
|
50
|
+
- attach an existing artifact to another screen
|
|
51
|
+
|
|
52
|
+
Viewer-attention changes:
|
|
53
|
+
|
|
54
|
+
- switch to a screen
|
|
55
|
+
- focus an artifact so clients switch screens if needed, scroll it into view, and highlight it
|
|
56
|
+
|
|
57
|
+
Agent-facing create and attach commands require **exactly one** of `--focus` or `--no-focus`:
|
|
58
|
+
|
|
59
|
+
- `tv create-screen`
|
|
60
|
+
- `tv create-internal-artifact`
|
|
61
|
+
- `tv create-external-artifact`
|
|
62
|
+
- `tv attach-artifact`
|
|
63
|
+
|
|
64
|
+
Use this decision rule:
|
|
65
|
+
|
|
66
|
+
- use `--focus` when the user likely wants to inspect the new screen or artifact right away
|
|
67
|
+
- use `--no-focus` when the user likely wants background setup while keeping attention on the current screen or on some other task
|
|
68
|
+
|
|
69
|
+
Heuristic examples:
|
|
70
|
+
|
|
71
|
+
- use `--focus` for requests like "show me", "open it", "put it on screen", "let me review it", or when the created thing is the obvious next object of attention
|
|
72
|
+
- use `--no-focus` for requests like "set this up", "make it in the background", "prepare it", "wire this in", or when the user is still focused on something else
|
|
73
|
+
|
|
74
|
+
Important communication rule:
|
|
75
|
+
|
|
76
|
+
- when you use `--no-focus`, explicitly say what you did in chat so the user knows the work happened even though Television did not switch views
|
|
77
|
+
|
|
78
|
+
If you forget these rules or the CLI rejects a command for missing focus intent, run `tv help` and reread this section before retrying.
|
|
40
79
|
|
|
41
80
|
## User communication during multi-step workflows
|
|
42
81
|
|
|
@@ -339,16 +378,16 @@ Radius:
|
|
|
339
378
|
2. Start the pending bundle:
|
|
340
379
|
|
|
341
380
|
```bash
|
|
342
|
-
tv create-internal-artifact --screen "<screen-id>" --type text/markdown --title "Artifact title"
|
|
381
|
+
tv create-internal-artifact --screen "<screen-id>" --type text/markdown --title "Artifact title" --focus
|
|
343
382
|
```
|
|
344
383
|
|
|
345
384
|
Or:
|
|
346
385
|
|
|
347
386
|
```bash
|
|
348
|
-
tv create-internal-artifact --screen "<screen-id>" --type text/html --title "Artifact title"
|
|
387
|
+
tv create-internal-artifact --screen "<screen-id>" --type text/html --title "Artifact title" --no-focus
|
|
349
388
|
```
|
|
350
389
|
|
|
351
|
-
`--screen` is required for internal artifact creation so the
|
|
390
|
+
`--screen` is required for internal artifact creation so the artifact has immediate screen membership. `--focus` or `--no-focus` is also required so you explicitly decide whether the user should be taken to it now.
|
|
352
391
|
|
|
353
392
|
3. Read the returned pending path and edit files there.
|
|
354
393
|
4. Write `artifact.md`.
|
|
@@ -420,16 +459,16 @@ Use this when the file already exists on disk and Television should display it
|
|
|
420
459
|
without owning a bundle:
|
|
421
460
|
|
|
422
461
|
```bash
|
|
423
|
-
tv create-external-artifact --screen "<screen-id>" --type text/markdown --title "Artifact title" --path /absolute/path/to/file.md
|
|
462
|
+
tv create-external-artifact --screen "<screen-id>" --type text/markdown --title "Artifact title" --path /absolute/path/to/file.md --focus
|
|
424
463
|
```
|
|
425
464
|
|
|
426
465
|
Or:
|
|
427
466
|
|
|
428
467
|
```bash
|
|
429
|
-
tv create-external-artifact --screen "<screen-id>" --type text/html --title "Artifact title" --path /absolute/path/to/file.html
|
|
468
|
+
tv create-external-artifact --screen "<screen-id>" --type text/html --title "Artifact title" --path /absolute/path/to/file.html --no-focus
|
|
430
469
|
```
|
|
431
470
|
|
|
432
|
-
`--screen` is required for CLI creation so the file
|
|
471
|
+
`--screen` is required for CLI creation so the file has immediate screen membership. `--focus` or `--no-focus` is also required so you explicitly decide whether the user should be taken to it now.
|
|
433
472
|
|
|
434
473
|
Rules:
|
|
435
474
|
|
|
@@ -443,8 +482,8 @@ Rules:
|
|
|
443
482
|
Artifact commands:
|
|
444
483
|
|
|
445
484
|
```bash
|
|
446
|
-
tv create-internal-artifact --screen "<screen-id>" --type <text/markdown|text/html> --title "Artifact title"
|
|
447
|
-
tv create-external-artifact --screen "<screen-id>" --type <text/markdown|text/html> --title "Artifact title" --path /absolute/path
|
|
485
|
+
tv create-internal-artifact --screen "<screen-id>" --type <text/markdown|text/html> --title "Artifact title" (--focus|--no-focus)
|
|
486
|
+
tv create-external-artifact --screen "<screen-id>" --type <text/markdown|text/html> --title "Artifact title" --path /absolute/path (--focus|--no-focus)
|
|
448
487
|
tv edit-internal-artifact --id "<artifact-id>"
|
|
449
488
|
tv commit-pending-artifact --id "<artifact-id>"
|
|
450
489
|
tv abandon-pending-artifact --id "<artifact-id>"
|
|
@@ -457,7 +496,7 @@ tv delete-artifact --id "<artifact-id>"
|
|
|
457
496
|
Screen commands:
|
|
458
497
|
|
|
459
498
|
```bash
|
|
460
|
-
tv create-screen --name "Screen name"
|
|
499
|
+
tv create-screen --name "Screen name" (--focus|--no-focus)
|
|
461
500
|
tv list-screens
|
|
462
501
|
tv get-screen --id "<screen-id>"
|
|
463
502
|
tv remove-screen --id "<screen-id>"
|
|
@@ -466,7 +505,7 @@ tv remove-screen --id "<screen-id>"
|
|
|
466
505
|
Screen membership commands:
|
|
467
506
|
|
|
468
507
|
```bash
|
|
469
|
-
tv attach-artifact --id "<artifact-id>" --screen "<screen-id>"
|
|
508
|
+
tv attach-artifact --id "<artifact-id>" --screen "<screen-id>" (--focus|--no-focus)
|
|
470
509
|
tv detach-artifact --id "<artifact-id>" --screen "<screen-id>"
|
|
471
510
|
```
|
|
472
511
|
|
|
@@ -489,7 +528,8 @@ tv stop
|
|
|
489
528
|
|
|
490
529
|
CLI behavior notes:
|
|
491
530
|
|
|
492
|
-
- `--screen` is required on CLI create commands so new artifacts
|
|
531
|
+
- `--screen` is required on CLI create commands so new artifacts get immediate screen membership; use `tv attach-artifact` and `tv detach-artifact` for later screen membership changes
|
|
532
|
+
- `tv create-screen`, `tv create-internal-artifact`, `tv create-external-artifact`, and `tv attach-artifact` require exactly one of `--focus` or `--no-focus`
|
|
493
533
|
- workflow and mutation commands print plain text
|
|
494
534
|
- read commands print JSON
|
|
495
535
|
- `tv get-screen` includes artifact `kind` and `status`
|