@clipbus/plugin-sdk 0.9.8 → 0.10.0

package/dist/generated/capabilityClients.generated.d.ts

@@ -1,231 +0,0 @@
-import type { PluginActionResult, PluginAttachmentMutationEntry, PluginConsoleLogLevel, PluginInfoPanelDocument, PluginSearchExtensionEntry } from './data.generated.js';
-export interface PluginRuntimeInvokePayload {
-    key: string;
-    payload: unknown;
-    timeoutMs?: number;
-}
-export interface PluginRuntimeInvokeResponse {
-    response: unknown;
-}
-export interface PluginItemSetTagsPayload {
-    tags: string[];
-}
-export interface PluginItemSetTagsResponse {
-    tags: string[];
-}
-export interface PluginItemAddTagsPayload {
-    tags: string[];
-}
-export interface PluginItemAddTagsResponse {
-    tags: string[];
-}
-export interface PluginItemRemoveTagsPayload {
-    tags: string[];
-}
-export interface PluginItemRemoveTagsResponse {
-    tags: string[];
-}
-export interface PluginItemSetPinnedPayload {
-    pinned: boolean;
-}
-export interface PluginItemSetPinnedResponse {
-    pinned: boolean;
-}
-export interface PluginItemSetAttachmentsPayload {
-    owner: string;
-    attachmentType: string;
-    attachments: PluginAttachmentMutationEntry[];
-}
-export interface PluginItemSetAttachmentsResponse {
-}
-export interface PluginItemSetSearchExtensionPayload {
-    scope: string;
-    owner: string;
-    entries: PluginSearchExtensionEntry[];
-}
-export interface PluginItemSetSearchExtensionResponse {
-}
-export interface PluginItemMaterializeImagePathPayload {
-}
-export interface PluginItemMaterializeImagePathResponse {
-    path: string;
-}
-export interface PluginItemReadAttachmentPayload {
-    attachmentType: string;
-    attachmentKey: string;
-}
-export interface PluginItemReadAttachmentResponse {
-    payloadJson?: string;
-}
-export interface PluginAssetCurrentItemImageUrlPayload {
-}
-export interface PluginAssetCurrentItemImageUrlResponse {
-    url?: string;
-}
-export interface PluginAssetPathReferenceImageUrlPayload {
-    index: number;
-}
-export interface PluginAssetPathReferenceImageUrlResponse {
-    url?: string;
-}
-export interface PluginAssetCurrentActionInputImageUrlPayload {
-}
-export interface PluginAssetCurrentActionInputImageUrlResponse {
-    url?: string;
-}
-export interface PluginAssetCurrentActionInputPathReferenceImageUrlPayload {
-    index: number;
-}
-export interface PluginAssetCurrentActionInputPathReferenceImageUrlResponse {
-    url?: string;
-}
-export interface PluginAssetRegisterImagePayload {
-    path: string;
-}
-export interface PluginAssetRegisterImageResponse {
-    url: string;
-}
-export interface PluginClipboardCopyTextPayload {
-    text: string;
-}
-export interface PluginClipboardCopyTextResponse {
-}
-export interface PluginNavigationOpenUrlPayload {
-    url: string;
-}
-export interface PluginNavigationOpenUrlResponse {
-}
-export interface PluginNavigationRevealInFinderPayload {
-    path: string;
-}
-export interface PluginNavigationRevealInFinderResponse {
-}
-export interface PluginNavigationOpenFilePathPayload {
-    path: string;
-}
-export interface PluginNavigationOpenFilePathResponse {
-}
-export interface PluginActionAllocateImageTempPathPayload {
-    formatHint: string;
-}
-export interface PluginActionAllocateImageTempPathResponse {
-    path: string;
-}
-export interface PluginActionMaterializeInputImagePathPayload {
-}
-export interface PluginActionMaterializeInputImagePathResponse {
-    path: string;
-}
-export interface PluginActionAllocateOutputFilePathPayload {
-    suggestedName?: string;
-}
-export interface PluginActionAllocateOutputFilePathResponse {
-    path: string;
-}
-export interface PluginActionSetButtonsPayload {
-    buttons: {
-        id: string;
-        title: string;
-        isEnabled?: boolean;
-    }[];
-}
-export interface PluginActionSetButtonsResponse {
-}
-export interface PluginActionCompletePayload {
-    result: PluginActionResult;
-    userMessage?: string;
-}
-export interface PluginActionCompleteResponse {
-}
-export interface PluginAttachmentRendererSetButtonsPayload {
-    buttons: {
-        id: string;
-        title: string;
-        isEnabled?: boolean;
-    }[];
-}
-export interface PluginAttachmentRendererSetButtonsResponse {
-}
-export interface PluginWindowSetHeightPayload {
-    height: number;
-}
-export interface PluginWindowSetHeightResponse {
-}
-export interface PluginWindowAutoFitPayload {
-}
-export interface PluginWindowAutoFitResponse {
-}
-export interface PluginInfoPanelOpenPayload {
-    document: PluginInfoPanelDocument;
-}
-export interface PluginInfoPanelOpenResponse {
-    panelID: string;
-}
-export interface PluginInfoPanelClosePayload {
-    panelID: string;
-}
-export interface PluginInfoPanelCloseResponse {
-}
-export interface PluginSettingsGetPayload {
-    key: string;
-}
-export interface PluginSettingsGetResponse {
-    value: unknown | null;
-}
-export interface PluginSettingsGetAllPayload {
-}
-export interface PluginSettingsGetAllResponse {
-    settings: Record<string, unknown>;
-}
-export interface PluginConsoleLogPayload {
-    level: PluginConsoleLogLevel;
-    message: string;
-}
-export interface PluginConsoleLogResponse {
-}
-export interface PluginTextInputStateChangedPayload {
-    isFocused: boolean;
-    isComposing: boolean;
-}
-export interface PluginTextInputStateChangedResponse {
-}
-export interface PluginLocaleGetPayload {
-}
-export interface PluginLocaleGetResponse {
-    locale: string;
-}
-export declare const CAPABILITY_METHOD_NAMES: readonly ["runtime.invoke", "item.setTags", "item.addTags", "item.removeTags", "item.setPinned", "item.setAttachments", "item.setSearchExtension", "item.materializeImagePath", "item.readAttachment", "asset.currentItemImageUrl", "asset.pathReferenceImageUrl", "asset.currentActionInputImageUrl", "asset.currentActionInputPathReferenceImageUrl", "asset.registerImage", "clipboard.copyText", "navigation.openUrl", "navigation.revealInFinder", "navigation.openFilePath", "action.allocateImageTempPath", "action.materializeInputImagePath", "action.allocateOutputFilePath", "action.setButtons", "action.complete", "attachmentRenderer.setButtons", "window.setHeight", "window.autoFit", "infoPanel.open", "infoPanel.close", "settings.get", "settings.getAll", "console.log", "textInput.stateChanged", "locale.get"];
-export type CapabilityMethodName = (typeof CAPABILITY_METHOD_NAMES)[number];
-export declare const callRuntimeInvoke: (payload: PluginRuntimeInvokePayload) => Promise<PluginRuntimeInvokeResponse>;
-export declare const callItemSetTags: (payload: PluginItemSetTagsPayload) => Promise<PluginItemSetTagsResponse>;
-export declare const callItemAddTags: (payload: PluginItemAddTagsPayload) => Promise<PluginItemAddTagsResponse>;
-export declare const callItemRemoveTags: (payload: PluginItemRemoveTagsPayload) => Promise<PluginItemRemoveTagsResponse>;
-export declare const callItemSetPinned: (payload: PluginItemSetPinnedPayload) => Promise<PluginItemSetPinnedResponse>;
-export declare const callItemSetAttachments: (payload: PluginItemSetAttachmentsPayload) => Promise<PluginItemSetAttachmentsResponse>;
-export declare const callItemSetSearchExtension: (payload: PluginItemSetSearchExtensionPayload) => Promise<PluginItemSetSearchExtensionResponse>;
-export declare const callItemMaterializeImagePath: () => Promise<PluginItemMaterializeImagePathResponse>;
-export declare const callItemReadAttachment: (payload: PluginItemReadAttachmentPayload) => Promise<PluginItemReadAttachmentResponse>;
-export declare const callAssetCurrentItemImageUrl: () => Promise<PluginAssetCurrentItemImageUrlResponse>;
-export declare const callAssetPathReferenceImageUrl: (payload: PluginAssetPathReferenceImageUrlPayload) => Promise<PluginAssetPathReferenceImageUrlResponse>;
-export declare const callAssetCurrentActionInputImageUrl: () => Promise<PluginAssetCurrentActionInputImageUrlResponse>;
-export declare const callAssetCurrentActionInputPathReferenceImageUrl: (payload: PluginAssetCurrentActionInputPathReferenceImageUrlPayload) => Promise<PluginAssetCurrentActionInputPathReferenceImageUrlResponse>;
-export declare const callAssetRegisterImage: (payload: PluginAssetRegisterImagePayload) => Promise<PluginAssetRegisterImageResponse>;
-export declare const callClipboardCopyText: (payload: PluginClipboardCopyTextPayload) => Promise<PluginClipboardCopyTextResponse>;
-export declare const callNavigationOpenUrl: (payload: PluginNavigationOpenUrlPayload) => Promise<PluginNavigationOpenUrlResponse>;
-export declare const callNavigationRevealInFinder: (payload: PluginNavigationRevealInFinderPayload) => Promise<PluginNavigationRevealInFinderResponse>;
-export declare const callNavigationOpenFilePath: (payload: PluginNavigationOpenFilePathPayload) => Promise<PluginNavigationOpenFilePathResponse>;
-export declare const callActionAllocateImageTempPath: (payload: PluginActionAllocateImageTempPathPayload) => Promise<PluginActionAllocateImageTempPathResponse>;
-export declare const callActionMaterializeInputImagePath: () => Promise<PluginActionMaterializeInputImagePathResponse>;
-export declare const callActionAllocateOutputFilePath: (payload: PluginActionAllocateOutputFilePathPayload) => Promise<PluginActionAllocateOutputFilePathResponse>;
-export declare const callActionSetButtons: (payload: PluginActionSetButtonsPayload) => Promise<PluginActionSetButtonsResponse>;
-export declare const callActionComplete: (payload: PluginActionCompletePayload) => Promise<PluginActionCompleteResponse>;
-export declare const callAttachmentRendererSetButtons: (payload: PluginAttachmentRendererSetButtonsPayload) => Promise<PluginAttachmentRendererSetButtonsResponse>;
-export declare const callWindowSetHeight: (payload: PluginWindowSetHeightPayload) => Promise<PluginWindowSetHeightResponse>;
-export declare const callWindowAutoFit: () => Promise<PluginWindowAutoFitResponse>;
-export declare const callInfoPanelOpen: (payload: PluginInfoPanelOpenPayload) => Promise<PluginInfoPanelOpenResponse>;
-export declare const callInfoPanelClose: (payload: PluginInfoPanelClosePayload) => Promise<PluginInfoPanelCloseResponse>;
-export declare const callSettingsGet: (payload: PluginSettingsGetPayload) => Promise<PluginSettingsGetResponse>;
-export declare const callSettingsGetAll: () => Promise<PluginSettingsGetAllResponse>;
-export declare const callConsoleLog: (payload: PluginConsoleLogPayload) => Promise<PluginConsoleLogResponse>;
-export declare const callTextInputStateChanged: (payload: PluginTextInputStateChangedPayload) => Promise<PluginTextInputStateChangedResponse>;
-export declare const callLocaleGet: () => Promise<PluginLocaleGetResponse>;

package/dist/generated/hostBootstrap.generated.d.ts

@@ -1,23 +0,0 @@
-import type { PluginActionUIInput, PluginAttachmentPayload, PluginClipboardItem, PluginThemeTokenSnapshot } from './data.generated.js';
-export interface PluginContextPayload {
-    mode: 'attachmentRenderer' | 'action';
-    pluginID: string;
-}
-export interface PluginLocalePayload {
-    locale: string;
-}
-export declare function emitAttachmentBootstrap(p: {
-    context?: PluginContextPayload;
-    item?: PluginClipboardItem;
-    attachment?: PluginAttachmentPayload;
-    theme?: PluginThemeTokenSnapshot;
-    locale?: PluginLocalePayload;
-}): void;
-export declare function emitActionBootstrap(p: {
-    context?: PluginContextPayload;
-    item?: PluginClipboardItem;
-    draft?: Record<string, unknown>;
-    actionInput?: PluginActionUIInput;
-    theme?: PluginThemeTokenSnapshot;
-    locale?: PluginLocalePayload;
-}): void;

package/dist/generated/runtime.host.generated.d.ts

@@ -1,39 +0,0 @@
-import type { PluginActionAllocateImageTempPathPayload, PluginActionAllocateImageTempPathResponse, PluginActionAllocateOutputFilePathPayload, PluginActionAllocateOutputFilePathResponse, PluginActionMaterializeInputImagePathResponse, PluginAssetRegisterImagePayload, PluginAssetRegisterImageResponse, PluginClipboardCopyTextPayload, PluginClipboardCopyTextResponse, PluginConsoleLogPayload, PluginConsoleLogResponse, PluginItemAddTagsPayload, PluginItemAddTagsResponse, PluginItemMaterializeImagePathResponse, PluginItemReadAttachmentPayload, PluginItemReadAttachmentResponse, PluginItemRemoveTagsPayload, PluginItemRemoveTagsResponse, PluginItemSetAttachmentsPayload, PluginItemSetAttachmentsResponse, PluginItemSetPinnedPayload, PluginItemSetPinnedResponse, PluginItemSetSearchExtensionPayload, PluginItemSetSearchExtensionResponse, PluginItemSetTagsPayload, PluginItemSetTagsResponse, PluginLocaleGetResponse, PluginNavigationOpenFilePathPayload, PluginNavigationOpenFilePathResponse, PluginNavigationOpenUrlPayload, PluginNavigationOpenUrlResponse, PluginNavigationRevealInFinderPayload, PluginNavigationRevealInFinderResponse, PluginSettingsGetAllResponse, PluginSettingsGetPayload, PluginSettingsGetResponse } from './capabilityClients.generated.js';
-export declare const host: {
-    item: {
-        setTags: (payload: PluginItemSetTagsPayload) => Promise<PluginItemSetTagsResponse>;
-        addTags: (payload: PluginItemAddTagsPayload) => Promise<PluginItemAddTagsResponse>;
-        removeTags: (payload: PluginItemRemoveTagsPayload) => Promise<PluginItemRemoveTagsResponse>;
-        setPinned: (payload: PluginItemSetPinnedPayload) => Promise<PluginItemSetPinnedResponse>;
-        setAttachments: (payload: PluginItemSetAttachmentsPayload) => Promise<PluginItemSetAttachmentsResponse>;
-        setSearchExtension: (payload: PluginItemSetSearchExtensionPayload) => Promise<PluginItemSetSearchExtensionResponse>;
-        materializeImagePath: () => Promise<PluginItemMaterializeImagePathResponse>;
-        readAttachment: (payload: PluginItemReadAttachmentPayload) => Promise<PluginItemReadAttachmentResponse>;
-    };
-    asset: {
-        registerImage: (payload: PluginAssetRegisterImagePayload) => Promise<PluginAssetRegisterImageResponse>;
-    };
-    clipboard: {
-        copyText: (payload: PluginClipboardCopyTextPayload) => Promise<PluginClipboardCopyTextResponse>;
-    };
-    navigation: {
-        openUrl: (payload: PluginNavigationOpenUrlPayload) => Promise<PluginNavigationOpenUrlResponse>;
-        revealInFinder: (payload: PluginNavigationRevealInFinderPayload) => Promise<PluginNavigationRevealInFinderResponse>;
-        openFilePath: (payload: PluginNavigationOpenFilePathPayload) => Promise<PluginNavigationOpenFilePathResponse>;
-    };
-    action: {
-        allocateImageTempPath: (payload: PluginActionAllocateImageTempPathPayload) => Promise<PluginActionAllocateImageTempPathResponse>;
-        materializeInputImagePath: () => Promise<PluginActionMaterializeInputImagePathResponse>;
-        allocateOutputFilePath: (payload: PluginActionAllocateOutputFilePathPayload) => Promise<PluginActionAllocateOutputFilePathResponse>;
-    };
-    settings: {
-        get: (payload: PluginSettingsGetPayload) => Promise<PluginSettingsGetResponse>;
-        getAll: () => Promise<PluginSettingsGetAllResponse>;
-    };
-    console: {
-        log: (payload: PluginConsoleLogPayload) => Promise<PluginConsoleLogResponse>;
-    };
-    locale: {
-        get: () => Promise<PluginLocaleGetResponse>;
-    };
-};

package/dist/generated/topicSubscribers.generated.d.ts

@@ -1,39 +0,0 @@
-import type { PluginActionUIInput, PluginAttachmentPayload, PluginClipboardItem, PluginThemeTokenSnapshot } from './data.generated.js';
-export interface PluginContextPayload {
-    mode: 'attachmentRenderer' | 'action';
-    pluginID: string;
-}
-export declare function onContext(listener: (payload: PluginContextPayload) => void): () => void;
-export declare function getContextSnapshot(): PluginContextPayload | undefined;
-export declare function onItem(listener: (payload: PluginClipboardItem) => void): () => void;
-export declare function getItemSnapshot(): PluginClipboardItem | undefined;
-export declare function onAttachment(listener: (payload: PluginAttachmentPayload) => void): () => void;
-export declare function getAttachmentSnapshot(): PluginAttachmentPayload | undefined;
-export declare function onDraft(listener: (payload: Record<string, unknown>) => void): () => void;
-export declare function getDraftSnapshot(): Record<string, unknown> | undefined;
-export declare function onActionInput(listener: (payload: PluginActionUIInput) => void): () => void;
-export declare function getActionInputSnapshot(): PluginActionUIInput | undefined;
-export declare function onTheme(listener: (payload: PluginThemeTokenSnapshot) => void): () => void;
-export declare function getThemeSnapshot(): PluginThemeTokenSnapshot | undefined;
-export interface PluginAttachmentHostInvokePayload {
-    buttonID: string;
-}
-export declare function onAttachmentHostInvoke(listener: (payload: PluginAttachmentHostInvokePayload) => void): () => void;
-export interface PluginActionHostInvokePayload {
-    buttonID: string;
-}
-export declare function onActionHostInvoke(listener: (payload: PluginActionHostInvokePayload) => void): () => void;
-export interface PluginInfoPanelOnActionPayload {
-    panelID: string;
-    buttonID: string;
-}
-export declare function onInfoPanelOnAction(listener: (payload: PluginInfoPanelOnActionPayload) => void): () => void;
-export interface PluginInfoPanelOnClosePayload {
-    panelID: string;
-}
-export declare function onInfoPanelOnClose(listener: (payload: PluginInfoPanelOnClosePayload) => void): () => void;
-export interface PluginLocalePayload {
-    locale: string;
-}
-export declare function onLocale(listener: (payload: PluginLocalePayload) => void): () => void;
-export declare function getLocaleSnapshot(): PluginLocalePayload | undefined;

package/dist/generated/ui.bootstrap.generated.d.ts

@@ -1,17 +0,0 @@
-import type { PluginActionUIInput, PluginAttachmentPayload, PluginClipboardItem, PluginThemeTokenSnapshot } from './data.generated.js';
-import type { PluginActionHostInvokePayload, PluginAttachmentHostInvokePayload, PluginContextPayload, PluginInfoPanelOnActionPayload, PluginInfoPanelOnClosePayload, PluginLocalePayload } from './topicSubscribers.generated.js';
-export declare const _pluginContextTopic: import("../internal/topic.js").MutableTopic<PluginContextPayload>;
-export declare const _itemTopic: import("../internal/topic.js").MutableTopic<PluginClipboardItem>;
-export declare const _itemAttachmentTopic: import("../internal/topic.js").MutableTopic<PluginAttachmentPayload>;
-export declare const _actionDraftTopic: import("../internal/topic.js").MutableTopic<Record<string, unknown>>;
-export declare const _actionInputTopic: import("../internal/topic.js").MutableTopic<PluginActionUIInput>;
-export declare const _themeTopic: import("../internal/topic.js").MutableTopic<PluginThemeTokenSnapshot>;
-export declare const _attachmentRendererOnHostInvokeStream: import("../internal/topic.js").MutableStream<PluginAttachmentHostInvokePayload>;
-export declare const _actionOnHostInvokeStream: import("../internal/topic.js").MutableStream<PluginActionHostInvokePayload>;
-export declare const _infoPanelOnActionStream: import("../internal/topic.js").MutableStream<PluginInfoPanelOnActionPayload>;
-export declare const _infoPanelOnCloseStream: import("../internal/topic.js").MutableStream<PluginInfoPanelOnClosePayload>;
-export declare const _localeTopic: import("../internal/topic.js").MutableTopic<PluginLocalePayload>;
-export declare class PluginContextError extends Error {
-    constructor(message: string);
-}
-export declare function guardContext<A extends unknown[], R>(expected: 'attachmentRenderer' | 'action', run: (...args: A) => R): (...args: A) => R;

package/dist/internal/ipcBus.d.ts

@@ -1,48 +0,0 @@
-export interface IPCBusIO {
-    write(line: string): void;
-    onLine(handler: (line: string) => void): void;
-}
-export interface InboundHandler<Req, Resp> {
-    (request: Req): Promise<Resp> | Resp;
-}
-export interface IPCBus {
-    request<Req, Resp>(method: string, payload: Req): Promise<Resp>;
-    onMethod<Req, Resp>(method: string, handler: InboundHandler<Req, Resp>): void;
-    start(): void;
-}
-/**
- * Structured error frame shape (D6.1 upgrade). Old wire shape was `error: string`;
- * the bus now emits `error: { name, message, data? }` and accepts both shapes on
- * the inbound path. See docs/specs/2026-05-19-plugin-ui-to-runtime-rpc-design.md §7.
- */
-export interface IPCBusErrorFrame {
-    name: string;
-    message: string;
-    data?: unknown;
-}
-/**
- * Serialize a thrown value into the structured wire shape `{name, message, data?}`.
- * Preserves Error subclass `.name` and any `.data` payload custom Error
- * subclasses may carry. Non-Error throws collapse to `name: 'Error'`.
- */
-export declare function serializeError(err: unknown): IPCBusErrorFrame;
-/**
- * Reconstruct an Error from a wire-side error field. Accepts both the legacy
- * bare-string shape (older native runtime) and the new structured shape
- * (D6.1+). Custom Error subclass prototypes cannot be restored across the bus
- * — callers should branch on `err.name` and read `(err as any).data` for
- * business fields.
- */
-export declare function deserializeError(raw: unknown): Error;
-export declare function createIPCBus(io: IPCBusIO): IPCBus;
-/**
- * Configure the global IPC bus singleton.
- * Must be called once by the plugin runtime before any generated code runs.
- */
-export declare function configureIpcBus(bus: IPCBus): void;
-/**
- * The global IPC bus singleton.
- * Access is proxied so callers can import `ipcBus` at module evaluation time
- * without requiring the bus to be configured yet.
- */
-export declare const ipcBus: IPCBus;

package/dist/internal/runtimeInvokeClient.d.ts

@@ -1,3 +0,0 @@
-import type { PluginRuntimeInvokePayload } from '../generated/capabilityClients.generated.js';
-export declare function callRuntimeInvokeStrict(payload: PluginRuntimeInvokePayload): Promise<unknown>;
-export declare function parseReplyError(raw: unknown): Error;