@telepath-computer/television 0.1.71 → 0.1.72

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.
@@ -4,7 +4,7 @@
4
4
  <meta charset="UTF-8" />
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
6
6
  <title>Television</title>
7
- <script type="module" crossorigin src="./assets/index-DRczTqkZ.js"></script>
7
+ <script type="module" crossorigin src="./assets/index-BdZOFJuB.js"></script>
8
8
  <link rel="stylesheet" crossorigin href="./assets/index-EZh8DmDQ.css">
9
9
  </head>
10
10
  <body></body>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@telepath-computer/television",
3
- "version": "0.1.71",
3
+ "version": "0.1.72",
4
4
  "type": "module",
5
5
  "main": "dist/cli.cjs",
6
6
  "bin": {
package/skill/SKILL.md CHANGED
@@ -58,7 +58,7 @@ State-change commands can optionally trigger focus, but they do not imply it.
58
58
  Agent-facing create and attach commands require an explicit focus decision:
59
59
 
60
60
  - `tv create-screen` requires exactly one of `--focus-screen` or `--no-focus`
61
- - `tv create-internal-artifact`, `tv create-external-artifact`, and `tv attach-artifact` require exactly one of `--focus-artifact` or `--no-focus`
61
+ - `tv create-internal-artifact`, `tv create-external-artifact`, `tv create-url-artifact`, and `tv attach-artifact` require exactly one of `--focus-artifact` or `--no-focus`
62
62
 
63
63
  Use this decision rule:
64
64
 
@@ -486,6 +486,31 @@ Rules:
486
486
  - the extension must match `type`
487
487
  - external artifacts do not use pending create, pending edit, commit, or abandon
488
488
 
489
+ ### Create URL artifact
490
+
491
+ Use this when the artifact should display a live web page (an internal docs
492
+ page, a dashboard, a third-party site) rather than content Television owns or a
493
+ file on disk:
494
+
495
+ ```bash
496
+ tv create-url-artifact --screen "<screen-id>" --title "Artifact title" --url https://example.com --focus-artifact
497
+ ```
498
+
499
+ Or:
500
+
501
+ ```bash
502
+ tv create-url-artifact --screen "<screen-id>" --title "Artifact title" --url https://example.com --no-focus
503
+ ```
504
+
505
+ `--screen` is required for CLI creation so the page has immediate screen membership. `--focus-artifact` or `--no-focus` is also required so you explicitly decide whether the user should be taken to it now.
506
+
507
+ Rules:
508
+
509
+ - `--url` must be `http://` or `https://`
510
+ - the type is always `text/html` — do not pass `--type`
511
+ - URL artifacts are committed immediately on creation; they have no pending create, pending edit, commit, or abandon lifecycle
512
+ - in the desktop app the page renders in a sandboxed `<webview>`; in the browser it renders in an `<iframe>`
513
+
489
514
  ## CLI reference
490
515
 
491
516
  Artifact commands:
@@ -493,7 +518,7 @@ Artifact commands:
493
518
  ```bash
494
519
  tv create-internal-artifact --screen "<screen-id>" --type <text/markdown|text/html> --title "Artifact title" (--focus-artifact|--no-focus)
495
520
  tv create-external-artifact --screen "<screen-id>" --type <text/markdown|text/html> --title "Artifact title" --path /absolute/path (--focus-artifact|--no-focus)
496
- tv create-url-artifact --screen "<screen-id>" --title "Artifact title" --url https://example.com
521
+ tv create-url-artifact --screen "<screen-id>" --title "Artifact title" --url https://example.com (--focus-artifact|--no-focus)
497
522
  tv edit-internal-artifact --id "<artifact-id>"
498
523
  tv commit-pending-artifact --id "<artifact-id>"
499
524
  tv abandon-pending-artifact --id "<artifact-id>"
@@ -539,7 +564,7 @@ tv stop
539
564
  CLI behavior notes:
540
565
 
541
566
  - `--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
542
- - `tv create-screen` requires exactly one of `--focus-screen` or `--no-focus`; `tv create-internal-artifact`, `tv create-external-artifact`, and `tv attach-artifact` require exactly one of `--focus-artifact` or `--no-focus`
567
+ - `tv create-screen` requires exactly one of `--focus-screen` or `--no-focus`; `tv create-internal-artifact`, `tv create-external-artifact`, `tv create-url-artifact`, and `tv attach-artifact` require exactly one of `--focus-artifact` or `--no-focus`
543
568
  - workflow and mutation commands print plain text
544
569
  - read commands print JSON
545
570
  - `tv get-screen` includes artifact `kind` and `status`