pi-paster 0.1.5 → 0.2.1

package/README.md

@@ -87,7 +87,7 @@ On macOS, pi exposes an image paste action through its keybinding system. In the
 
 ## Configuration
 
-By default all editor integrations are enabled.
+By default all editor integrations are enabled, and submitted image previews render in the raw chat-history style.
 
 To customize behavior, load a small wrapper extension:
 
@@ -95,6 +95,8 @@ To customize behavior, load a small wrapper extension:
 import { createPaster } from "pi-paster";
 
 export default createPaster({
+  submittedPreviewStyle: "raw",
+  includeImagePathsInPrompt: true,
   customEditor: {
     enabled: true,
     showImagePreview: true,
@@ -105,11 +107,13 @@ export default createPaster({
 
 ### Options
 
-| Option                                  | Default | Description                                                                                                                 |
-| --------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
-| `customEditor.enabled`                  | `true`  | Replaces pi's input editor with paster's editor integration. Disable this to keep pi's default editor.                      |
-| `customEditor.showImagePreview`         | `true`  | Shows an image preview above the input when the cursor is inside an image placeholder. Requires `customEditor.enabled`.     |
-| `customEditor.deletePlaceholderAsBlock` | `true`  | Makes backspace/delete remove the whole placeholder when editing inside or adjacent to it. Requires `customEditor.enabled`. |
+| Option                                  | Default | Description                                                                                                                             |
+| --------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `submittedPreviewStyle`                 | `"raw"` | How submitted image previews render in chat history. Use `"collapsible"` to wrap them in pi's ctrl+o expandable/collapsible message UI. |
+| `includeImagePathsInPrompt`             | `true`  | Appends placeholder-to-local-path mappings to the submitted prompt so the agent can manipulate the source image files when asked.       |
+| `customEditor.enabled`                  | `true`  | Replaces pi's input editor with paster's editor integration. Disable this to keep pi's default editor.                                  |
+| `customEditor.showImagePreview`         | `true`  | Shows an image preview above the input when the cursor is inside an image placeholder. Requires `customEditor.enabled`.                 |
+| `customEditor.deletePlaceholderAsBlock` | `true`  | Makes backspace/delete remove the whole placeholder when editing inside or adjacent to it. Requires `customEditor.enabled`.             |
 
 When `customEditor.enabled` is `false`, paster still handles bracketed terminal paste/drop image paths, but cursor previews, atomic placeholder deletion, and paster's clipboard-image handler are disabled.
 

package/dist/index.d.mts

@@ -3,7 +3,12 @@ import { Component, EditorTheme, ImageDimensions, ImageTheme, TUI } from "@earen
 import { CustomEditor, ExtensionAPI, KeybindingsManager } from "@earendil-works/pi-coding-agent";
 
 //#region src/config.d.ts
+type SubmittedPreviewStyle = "raw" | "collapsible";
 interface PasterConfig {
+  /** How submitted attachment previews render in chat history. */
+  submittedPreviewStyle?: SubmittedPreviewStyle;
+  /** Append local image paths to the submitted prompt so the agent can manipulate the source files. */
+  includeImagePathsInPrompt?: boolean;
   customEditor?: {
     /** Replace pi's input editor to enable inline image UX features. */enabled?: boolean; /** Show an image preview above the input while the cursor is inside an image placeholder. */
     showImagePreview?: boolean; /** Treat image placeholders as atomic blocks for backspace/delete. */
@@ -11,6 +16,8 @@ interface PasterConfig {
   };
 }
 interface ResolvedPasterConfig {
+  submittedPreviewStyle: SubmittedPreviewStyle;
+  includeImagePathsInPrompt: boolean;
   customEditor: {
     enabled: boolean;
     showImagePreview: boolean;
@@ -23,6 +30,8 @@ declare function resolvePasterConfig(config?: PasterConfig): ResolvedPasterConfi
 //#region src/types.d.ts
 declare const EXTENSION_NAME = "paster";
 declare const MAX_IMAGE_BYTES: number;
+declare const ANTHROPIC_MAX_DIMENSION = 8000;
+declare const ANTHROPIC_MAX_IMAGE_BYTES: number;
 type SupportedImageMimeType = "image/png" | "image/jpeg" | "image/webp" | "image/gif";
 interface ImageAttachment {
   id: number;
@@ -32,6 +41,14 @@ interface ImageAttachment {
   data: string;
   dimensions?: ImageDimensions;
   createdAt: number;
+  /** True once optimizeImageBytes has run on this attachment. */
+  optimized?: boolean;
+  /** Original (pre-optimization) base64 size in bytes — informational. */
+  originalBytes?: number;
+  /** Final (post-optimization) base64 size in bytes — informational. */
+  finalBytes?: number;
+  /** Human-readable trail of optimization actions applied, if any. */
+  optimizeActions?: string[];
 }
 interface LoadedImage {
   originalPath: string;
@@ -66,6 +83,25 @@ type ClipboardImageResult = {
 };
 declare function readClipboardImage(maxBytes?: number): ClipboardImageResult;
 //#endregion
+//#region src/optimize-image.d.ts
+interface OptimizeResult {
+  data: string;
+  mimeType: SupportedImageMimeType;
+  originalBytes: number;
+  finalBytes: number;
+  originalDim?: {
+    width: number;
+    height: number;
+  };
+  finalDim?: {
+    width: number;
+    height: number;
+  };
+  actions: string[];
+  changed: boolean;
+}
+declare function optimizeImageBytes(input: Buffer, mime: SupportedImageMimeType): Promise<OptimizeResult>;
+//#endregion
 //#region src/store.d.ts
 declare class AttachmentStore {
   private nextId;
@@ -80,6 +116,7 @@ declare class AttachmentStore {
 //#region src/editor.d.ts
 declare const PASTE_START = "\u001B[200~";
 declare const PASTE_END = "\u001B[201~";
+declare function segmentTextWithAtomicImages(text: string, store: AttachmentStore, validPasteIds?: Set<number>): Intl.SegmentData[];
 declare class PasterEditor extends CustomEditor {
   private readonly pasterKeybindings;
   private readonly pasterOptions;
@@ -96,9 +133,12 @@ declare class PasterEditor extends CustomEditor {
   insertTextAtCursor(text: string): void;
   handleInput(data: string): void;
   clearCursorPreview(): void;
+  private installAtomicImageSegmentation;
   private handlePasteClipboardImage;
   private handleBracketedPaste;
+  private handleAtomicPlaceholderNavigation;
   private handleAtomicPlaceholderDelete;
+  private setCursor;
   private deleteLineRange;
   private transform;
   private updateCursorPreview;
@@ -110,8 +150,14 @@ interface PathToken {
   value: string;
   start: number;
   end: number;
+  bare: boolean;
 }
 declare function detectImageMimeType(bytes: Uint8Array): SupportedImageMimeType | undefined;
+declare function isWindowsDrivePath(value: string): boolean;
+declare function isWindowsUncPath(value: string): boolean;
+declare function isWindowsLikePath(value: string): boolean;
+declare function isWsl(): boolean;
+declare function windowsToWslPath(windowsPath: string): string;
 declare function resolveImagePath(input: string, cwd: string): string;
 declare function shellUnescape(input: string): string;
 declare function tokenizePathLikeText(text: string): PathToken[];
@@ -130,15 +176,41 @@ declare function replaceImagePathsInText(text: string, options: {
   accepted: ImageAttachment[];
 };
 declare function imagesForText(store: AttachmentStore, text: string, existing?: PasterImageContent[]): PasterImageContent[];
+declare function appendImagePathContext(text: string, attachments: ImageAttachment[]): string;
+/**
+ * Async variant of imagesForText that runs each attachment through the
+ * Anthropic-aware image optimizer (resize to 8000px cap, JPEG ladder to stay
+ * under the 5 MB / 32 MB request caps). Optimization is cached on the
+ * attachment so the cost is paid once per image, not per submit.
+ *
+ * Used by paster's `input` handler; safe to await on the hot path because
+ * sharp is only invoked when the image is actually over the limits.
+ */
+declare function imagesForTextOptimized(store: AttachmentStore, text: string, existing?: PasterImageContent[]): Promise<PasterImageContent[]>;
+declare function describeReject(result: Exclude<LoadImageResult, {
+  ok: true;
+}>, notify?: (message: string) => void): void;
 //#endregion
 //#region src/preview.d.ts
+type ImagePreviewMessageStyle = "raw" | "collapsible";
+interface ImagePreviewMessageTheme extends ImageTheme {
+  background?: (text: string) => string;
+  title?: (text: string) => string;
+  muted?: (text: string) => string;
+}
 declare class ImagePreviewMessage implements Component {
   private readonly attachments;
   private readonly theme;
+  private readonly options;
   private readonly images;
-  constructor(attachments: ImageAttachment[], theme: ImageTheme);
-  render(width: number): string[];
+  constructor(attachments: ImageAttachment[], theme: ImagePreviewMessageTheme, options?: {
+    expanded?: boolean;
+    style?: ImagePreviewMessageStyle;
+  });
   invalidate(): void;
+  render(width: number): string[];
+  private renderRaw;
+  private renderCollapsible;
 }
 interface CursorPreviewTheme {
   title: (text: string) => string;
@@ -174,4 +246,4 @@ declare function createImagePasteTerminalInputHandler(options: {
 declare function createPaster(config?: PasterConfig): (pi: ExtensionAPI) => void;
 declare function paster(pi: ExtensionAPI, config?: PasterConfig): void;
 //#endregion
-export { AttachmentStore, ClipboardImageResult, CursorImagePreviewWidget, DEFAULT_PASTER_CONFIG, EXTENSION_NAME, ImageAttachment, ImagePreviewMessage, LoadImageResult, LoadedImage, MAX_IMAGE_BYTES, PASTE_END, PASTE_START, PasterConfig, PasterEditor, PasterImageContent, PasterPreviewDetails, ResolvedPasterConfig, SupportedImageMimeType, TerminalInputResult, createImagePasteTerminalInputHandler, createPaster, paster as default, detectImageMimeType, dimensionsForImage, imagesForText, loadImageFromPath, readClipboardImage, replaceImagePathsInText, resolveImagePath, resolvePasterConfig, shellUnescape, tokenizePathLikeText };
+export { ANTHROPIC_MAX_DIMENSION, ANTHROPIC_MAX_IMAGE_BYTES, AttachmentStore, ClipboardImageResult, CursorImagePreviewWidget, DEFAULT_PASTER_CONFIG, EXTENSION_NAME, ImageAttachment, ImagePreviewMessage, ImagePreviewMessageStyle, LoadImageResult, LoadedImage, MAX_IMAGE_BYTES, OptimizeResult, PASTE_END, PASTE_START, PasterConfig, PasterEditor, PasterImageContent, PasterPreviewDetails, ResolvedPasterConfig, SubmittedPreviewStyle, SupportedImageMimeType, TerminalInputResult, appendImagePathContext, createImagePasteTerminalInputHandler, createPaster, paster as default, describeReject, detectImageMimeType, dimensionsForImage, imagesForText, imagesForTextOptimized, isWindowsDrivePath, isWindowsLikePath, isWindowsUncPath, isWsl, loadImageFromPath, optimizeImageBytes, readClipboardImage, replaceImagePathsInText, resolveImagePath, resolvePasterConfig, segmentTextWithAtomicImages, shellUnescape, tokenizePathLikeText, windowsToWslPath };