@prjct.app/pi-clipboard 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [0.1.6](https://github.com/prjct-app/pi-clipboard/compare/v0.1.5...v0.1.6) (2026-09-10)
+
+## [0.1.5](https://github.com/prjct-app/pi-clipboard/compare/v0.1.4...v0.1.5) (2026-09-10)
+
+### Bug Fixes
+
+* recognize timestamped Pi clipboard attachments ([f9769f4](https://github.com/prjct-app/pi-clipboard/commit/f9769f46d25cb90a19913b2486d0bbd61f6a4c9d))
+
 ## [0.1.4](https://github.com/prjct-app/pi-clipboard/compare/v0.1.3...v0.1.4) (2026-09-10)
 
 ### Bug Fixes

package/README.md

@@ -6,6 +6,12 @@ Preview pasted images in PI Agent before sending them, with inline thumbnails an
 
 `@prjct.app/pi-clipboard` · Clipboard image previews; one extension.
 
+## Demo
+
+[![Watch the pi-clipboard promotional demo](media/pi-clipboard-demo/poster.png)](https://github.com/prjct-app/pi-clipboard/raw/refs/heads/main/media/pi-clipboard-demo/pi-clipboard-demo.mp4)
+
+[Watch or download the 40-second demo](https://github.com/prjct-app/pi-clipboard/raw/refs/heads/main/media/pi-clipboard-demo/pi-clipboard-demo.mp4). It shows the native PI Agent workflow for pasting, previewing, and reviewing one or several images before sending. The film uses the package's monochrome cover identity and an original instrumental soundtrack with no voice-over or external samples.
+
 ## Install
 
 Requires Pi installed separately and Node.js **22.19 or later**. Compatibility is tested with **Pi 0.85.1**; newer versions are not yet verified. This is an independent community package.
@@ -26,7 +32,7 @@ For project-only installation, add `-l`: `pi install -l npm:@prjct.app/pi-clipbo
 
 Previews appear automatically; there is no slash command to enable them. Removing an attachment path from the editor removes its preview. Each attachment renders as its own preview.
 
-Only Pi-created temporary clipboard attachments are eligible. Arbitrary image paths do not produce previews. Supported filenames end in PNG, JPEG, WebP, or GIF; individual files over 50 MiB and symbolic links are rejected. Clipboard images stay on disk as the temporary files Pi created; the files this session previewed are deleted when the Pi session ends. Previews render through Pi's native terminal image support; terminals without it show Pi's native `[Image: ...]` text fallback. The extension itself makes no network requests. Submitting an image still follows Pi's normal model-provider attachment flow.
+Only Pi-created temporary clipboard attachments are eligible. The extension recognizes Pi's UUID (`pi-clipboard-<UUID>`) and timestamped (`clipboard-<date>-<time>-<hex>`) temporary filename forms; arbitrary image paths do not produce previews. Supported filenames end in PNG, JPEG, WebP, or GIF; individual files over 50 MiB and symbolic links are rejected. Clipboard images stay on disk as the temporary files Pi created; the files this session previewed are deleted when the Pi session ends. Previews render through Pi's native terminal image support; terminals without it show Pi's native `[Image: ...]` text fallback. The extension itself makes no network requests. Submitting an image still follows Pi's normal model-provider attachment flow.
 
 
 ## Manage the package

package/docs/package.md

@@ -35,7 +35,7 @@ Third-party runtime dependencies belong in `dependencies`. Companion extensions
 
 ## Public interfaces
 
-Uses `session_start`, `session_shutdown`, `ctx.ui.getEditorText()`, `ctx.ui.setWidget()`, and Pi TUI `Image`/`Container` components. Kitty placements receive PNG payloads through Pi's native `convertToPng`. Clipboard files previewed by the session are deleted on `session_shutdown` after revalidating that they are still Pi-owned temporary files. It retains the native editor and attachment submission flow.
+Uses `session_start`, `session_shutdown`, `ctx.ui.getEditorText()`, `ctx.ui.setWidget()`, and Pi TUI `Image`/`Container` components. It recognizes Pi's UUID and timestamped temporary clipboard filename forms in the system temporary directory. Kitty placements receive PNG payloads through Pi's native `convertToPng`. Clipboard files previewed by the session are deleted on `session_shutdown` after revalidating that they are still Pi-owned temporary files. It retains the native editor and attachment submission flow.
 
 ## Published contents
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prjct.app/pi-clipboard",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Preview pasted images in PI Agent before sending them, with inline thumbnails and a compact attachment gallery.",
   "type": "module",
   "keywords": [

package/src/index.ts

@@ -19,7 +19,10 @@ import {
   type ImageDimensions,
 } from "@earendil-works/pi-tui";
 
-const CLIPBOARD_IMAGE_NAME_SOURCE = "pi-clipboard-[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\\.(?:png|jpe?g|webp|gif)";
+const IMAGE_EXTENSION_SOURCE = "(?:png|jpe?g|webp|gif)";
+const UUID_CLIPBOARD_IMAGE_NAME_SOURCE = `pi-clipboard-[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\\.${IMAGE_EXTENSION_SOURCE}`;
+const TIMESTAMPED_CLIPBOARD_IMAGE_NAME_SOURCE = `clipboard-[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])-(?:[01][0-9]|2[0-3])[0-5][0-9][0-5][0-9]-[0-9a-f]{8}\\.${IMAGE_EXTENSION_SOURCE}`;
+const CLIPBOARD_IMAGE_NAME_SOURCE = `(?:${UUID_CLIPBOARD_IMAGE_NAME_SOURCE}|${TIMESTAMPED_CLIPBOARD_IMAGE_NAME_SOURCE})`;
 const CLIPBOARD_IMAGE_FILENAME = new RegExp(CLIPBOARD_IMAGE_NAME_SOURCE, "gi");
 const CLIPBOARD_IMAGE_BASENAME = new RegExp(`^${CLIPBOARD_IMAGE_NAME_SOURCE}$`, "i");
 const IMAGE_MIME_TYPES: Record<string, string> = {
@@ -60,7 +63,7 @@ const systemScheduler: Scheduler = {
   clearInterval: (handle) => clearInterval(handle),
 };
 
-/** Resolve only filenames produced by Pi's native clipboard flow. */
+/** Resolve only filenames produced by Pi's native clipboard flows. */
 export function clipboardImagePaths(editorText: string): string[] {
   const paths = new Set<string>();
   const matcher = new RegExp(CLIPBOARD_IMAGE_FILENAME.source, CLIPBOARD_IMAGE_FILENAME.flags);