@clipbus/plugin-sdk 0.7.0

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

@@ -0,0 +1,16 @@
+import type { PluginAttachmentRendererHandler, PluginAutoRunActionHandler, PluginDetectorHandler } from './runtime.handlers.generated.js';
+import type { HostClient } from './hostClients.generated.js';
+export interface MessageHandlerContext {
+    host: HostClient;
+}
+export type MessageHandler<TReq = unknown, TResp = unknown> = (request: TReq, ctx: MessageHandlerContext) => Promise<TResp> | TResp;
+export interface PluginRegistry {
+    attachmentRenderers?: Record<string, PluginAttachmentRendererHandler>;
+    detectors?: Record<string, PluginDetectorHandler>;
+    actions?: Record<string, PluginAutoRunActionHandler>;
+    messageHandlers?: Record<string, MessageHandler>;
+}
+export interface PluginSetup {
+    setup(): PluginRegistry;
+}
+export declare function definePlugin(definition: PluginRegistry | PluginSetup): PluginSetup;

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

@@ -0,0 +1,20 @@
+import type { PluginActionOperationResult, PluginActionResolveResult, PluginAttachmentResolveResult, PluginAutoRunActionInput, PluginDetectorArtifact, PluginDetectorInput, PluginResolveActionSessionInput, PluginResolveAttachmentInput } from './data.generated.js';
+import type { HostClient } from './hostClients.generated.js';
+export interface PluginAttachmentRendererHandler {
+    resolveAttachment(input: PluginResolveAttachmentInput, ctx?: {
+        host?: HostClient;
+    }): Promise<PluginAttachmentResolveResult>;
+}
+export interface PluginDetectorHandler {
+    detect(input: PluginDetectorInput, ctx?: {
+        host?: HostClient;
+    }): Promise<PluginDetectorArtifact[]>;
+}
+export interface PluginAutoRunActionHandler {
+    resolveSession(input: PluginResolveActionSessionInput, ctx?: {
+        host?: HostClient;
+    }): Promise<PluginActionResolveResult>;
+    runAutoAction(input: PluginAutoRunActionInput, ctx?: {
+        host?: HostClient;
+    }): Promise<PluginActionOperationResult>;
+}

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

@@ -0,0 +1,34 @@
+import type { PluginActionAllocateImageTempPathPayload, PluginActionAllocateImageTempPathResponse, PluginAssetRegisterImagePayload, PluginAssetRegisterImageResponse, PluginClipboardCopyTextPayload, PluginClipboardCopyTextResponse, PluginConsoleLogPayload, PluginConsoleLogResponse, PluginItemAddTagsPayload, PluginItemAddTagsResponse, PluginItemMaterializeImagePathResponse, PluginItemReadAttachmentPayload, PluginItemReadAttachmentResponse, PluginItemRemoveTagsPayload, PluginItemRemoveTagsResponse, PluginItemSetAttachmentsPayload, PluginItemSetAttachmentsResponse, PluginItemSetPinnedPayload, PluginItemSetPinnedResponse, PluginItemSetSearchExtensionPayload, PluginItemSetSearchExtensionResponse, PluginItemSetTagsPayload, PluginItemSetTagsResponse, 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>;
+    };
+    settings: {
+        get: (payload: PluginSettingsGetPayload) => Promise<PluginSettingsGetResponse>;
+        getAll: () => Promise<PluginSettingsGetAllResponse>;
+    };
+    console: {
+        log: (payload: PluginConsoleLogPayload) => Promise<PluginConsoleLogResponse>;
+    };
+};

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

@@ -0,0 +1,32 @@
+import type { 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 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;

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

@@ -0,0 +1,15 @@
+import type { PluginAttachmentPayload, PluginClipboardItem, PluginThemeTokenSnapshot } from './data.generated.js';
+import type { PluginActionHostInvokePayload, PluginAttachmentHostInvokePayload, PluginContextPayload, PluginInfoPanelOnActionPayload, PluginInfoPanelOnClosePayload } 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 _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 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/generated/ui.clipbus.generated.d.ts

@@ -0,0 +1,79 @@
+import type { PluginActionCompletePayload, PluginActionCompleteResponse, PluginActionSetButtonsPayload, PluginActionSetButtonsResponse, PluginAssetCurrentItemImageUrlResponse, PluginAssetPathReferenceImageUrlPayload, PluginAssetPathReferenceImageUrlResponse, PluginAttachmentRendererSetButtonsPayload, PluginAttachmentRendererSetButtonsResponse, PluginClipboardCopyTextPayload, PluginClipboardCopyTextResponse, PluginConsoleLogPayload, PluginConsoleLogResponse, PluginInfoPanelClosePayload, PluginInfoPanelCloseResponse, PluginInfoPanelOpenPayload, PluginInfoPanelOpenResponse, PluginItemReadAttachmentPayload, PluginItemReadAttachmentResponse, PluginNavigationOpenFilePathPayload, PluginNavigationOpenFilePathResponse, PluginNavigationOpenUrlPayload, PluginNavigationOpenUrlResponse, PluginNavigationRevealInFinderPayload, PluginNavigationRevealInFinderResponse, PluginRuntimeInvokePayload, PluginSettingsGetAllResponse, PluginSettingsGetPayload, PluginSettingsGetResponse, PluginTextInputStateChangedPayload, PluginTextInputStateChangedResponse, PluginWindowAutoFitResponse, PluginWindowSetHeightPayload, PluginWindowSetHeightResponse } from './capabilityClients.generated.js';
+import type { PluginAttachmentPayload, PluginClipboardItem, PluginThemeTokenSnapshot } from './data.generated.js';
+import type { PluginActionHostInvokePayload, PluginAttachmentHostInvokePayload, PluginContextPayload, PluginInfoPanelOnActionPayload, PluginInfoPanelOnClosePayload } from './topicSubscribers.generated.js';
+export declare const clipbus: {
+    capabilities: import("../internal/capabilities.js").CapabilitiesApi;
+    runtime: {
+        invoke: <TResp = unknown>(payload: PluginRuntimeInvokePayload) => Promise<TResp>;
+    };
+    item: {
+        current: () => PluginClipboardItem | undefined;
+        on: (fn: (payload: PluginClipboardItem) => void) => import("../internal/topic.js").Unsubscribe;
+        readAttachment: (payload: PluginItemReadAttachmentPayload) => Promise<PluginItemReadAttachmentResponse>;
+        attachment: {
+            current: () => PluginAttachmentPayload | undefined;
+            on: (fn: (payload: PluginAttachmentPayload) => void) => import("../internal/topic.js").Unsubscribe;
+        };
+    };
+    asset: {
+        currentItemImageUrl: () => Promise<PluginAssetCurrentItemImageUrlResponse>;
+        pathReferenceImageUrl: (payload: PluginAssetPathReferenceImageUrlPayload) => Promise<PluginAssetPathReferenceImageUrlResponse>;
+    };
+    clipboard: {
+        copyText: (payload: PluginClipboardCopyTextPayload) => Promise<PluginClipboardCopyTextResponse>;
+    };
+    navigation: {
+        openUrl: (payload: PluginNavigationOpenUrlPayload) => Promise<PluginNavigationOpenUrlResponse>;
+        revealInFinder: (payload: PluginNavigationRevealInFinderPayload) => Promise<PluginNavigationRevealInFinderResponse>;
+        openFilePath: (payload: PluginNavigationOpenFilePathPayload) => Promise<PluginNavigationOpenFilePathResponse>;
+    };
+    action: {
+        setButtons: (payload: PluginActionSetButtonsPayload) => Promise<PluginActionSetButtonsResponse>;
+        complete: (payload: PluginActionCompletePayload) => Promise<PluginActionCompleteResponse>;
+        draft: {
+            current: () => Record<string, unknown> | undefined;
+            on: (fn: (payload: Record<string, unknown>) => void) => import("../internal/topic.js").Unsubscribe;
+        };
+        onHostInvoke: {
+            on: (fn: (payload: PluginActionHostInvokePayload) => void) => import("../internal/topic.js").Unsubscribe;
+        };
+    };
+    attachmentRenderer: {
+        setButtons: (payload: PluginAttachmentRendererSetButtonsPayload) => Promise<PluginAttachmentRendererSetButtonsResponse>;
+        onHostInvoke: {
+            on: (fn: (payload: PluginAttachmentHostInvokePayload) => void) => import("../internal/topic.js").Unsubscribe;
+        };
+    };
+    window: {
+        setHeight: (payload: PluginWindowSetHeightPayload) => Promise<PluginWindowSetHeightResponse>;
+        autoFit: () => Promise<PluginWindowAutoFitResponse>;
+    };
+    infoPanel: {
+        open: (payload: PluginInfoPanelOpenPayload) => Promise<PluginInfoPanelOpenResponse>;
+        close: (payload: PluginInfoPanelClosePayload) => Promise<PluginInfoPanelCloseResponse>;
+        onAction: {
+            on: (fn: (payload: PluginInfoPanelOnActionPayload) => void) => import("../internal/topic.js").Unsubscribe;
+        };
+        onClose: {
+            on: (fn: (payload: PluginInfoPanelOnClosePayload) => void) => import("../internal/topic.js").Unsubscribe;
+        };
+    };
+    settings: {
+        get: (payload: PluginSettingsGetPayload) => Promise<PluginSettingsGetResponse>;
+        getAll: () => Promise<PluginSettingsGetAllResponse>;
+    };
+    console: {
+        log: (payload: PluginConsoleLogPayload) => Promise<PluginConsoleLogResponse>;
+    };
+    textInput: {
+        stateChanged: (payload: PluginTextInputStateChangedPayload) => Promise<PluginTextInputStateChangedResponse>;
+    };
+    pluginContext: {
+        current: () => PluginContextPayload | undefined;
+        on: (fn: (payload: PluginContextPayload) => void) => import("../internal/topic.js").Unsubscribe;
+    };
+    theme: {
+        current: () => PluginThemeTokenSnapshot | undefined;
+        on: (fn: (payload: PluginThemeTokenSnapshot) => void) => import("../internal/topic.js").Unsubscribe;
+    };
+};

package/dist/generated/wireConstants.generated.d.ts

@@ -0,0 +1,3 @@
+export declare const STRUCTURED_ERROR_PREFIX: "__clipbus_structured_error__:";
+export declare const CAPABILITIES_GLOBAL: "__CLIPBUS_PLUGIN_CAPABILITIES__";
+export declare const CAPABILITY_UNSUPPORTED_ERROR_NAME: "PluginCapabilityUnsupported";

package/dist/internal/capabilities.d.ts

@@ -0,0 +1,31 @@
+import type { CapabilityMethodName } from '../generated/capabilityClients.generated.js';
+/**
+ * 宿主不支持某 capability 时抛出的类型化错误。
+ * 插件可通过 `instanceof CapabilityUnsupportedError` 识别并降级处理。
+ */
+export declare class CapabilityUnsupportedError extends Error {
+    readonly capability: string;
+    constructor(capability: string);
+}
+/**
+ * 从 window 全局读取宿主注入的能力清单。
+ * 缺失/非法 → 空集（→ has() 恒 false，老宿主行为）。
+ */
+export declare function readInjectedCapabilities(global: unknown, key: string): ReadonlySet<string>;
+export interface CapabilitiesApi {
+    has(name: CapabilityMethodName): boolean;
+}
+/**
+ * 创建 capabilities 命名空间对象。
+ * `getSet` 是惰性求值函数，每次 `has()` 调用时执行（确保读到最新注入值）。
+ */
+export declare function createCapabilitiesApi(getSet: () => ReadonlySet<string>): CapabilitiesApi;
+/**
+ * 把已解码的 reply error 收敛为类型化的 CapabilityUnsupportedError（D6）。
+ *
+ * 识别两条路径：
+ * 1. 结构化路径（新宿主）：`err.name === unsupportedName`，从 `err.data.capability` 提取能力名。
+ * 2. 老宿主 freeform 路径：`err.message` 匹配 `"Unknown method: <cap>"`。
+ * 其余错误原样透传。
+ */
+export declare function mapToCapabilityError(err: Error, unsupportedName: string): Error;

package/dist/internal/index.cjs

@@ -0,0 +1,68 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/internal/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CapabilityUnsupportedError: () => CapabilityUnsupportedError,
+  createCapabilitiesApi: () => createCapabilitiesApi,
+  mapToCapabilityError: () => mapToCapabilityError,
+  readInjectedCapabilities: () => readInjectedCapabilities
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/internal/capabilities.ts
+var CapabilityUnsupportedError = class extends Error {
+  capability;
+  constructor(capability) {
+    super(`Capability not supported by host: ${capability}`);
+    this.name = "CapabilityUnsupportedError";
+    this.capability = capability;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+function readInjectedCapabilities(global, key) {
+  const obj = global;
+  const raw = obj?.[key];
+  if (Array.isArray(raw?.capabilities)) {
+    return new Set(raw.capabilities);
+  }
+  return /* @__PURE__ */ new Set();
+}
+function createCapabilitiesApi(getSet) {
+  return {
+    has: (name) => getSet().has(name)
+  };
+}
+function mapToCapabilityError(err, unsupportedName) {
+  if (err.name === unsupportedName) {
+    const cap = err.data?.capability ?? "";
+    return new CapabilityUnsupportedError(cap);
+  }
+  const m = /^Unknown method:\s*(.+)$/.exec(err.message);
+  if (m) return new CapabilityUnsupportedError(m[1]);
+  return err;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CapabilityUnsupportedError,
+  createCapabilitiesApi,
+  mapToCapabilityError,
+  readInjectedCapabilities
+});

package/dist/internal/index.d.ts

@@ -0,0 +1 @@
+export { readInjectedCapabilities, createCapabilitiesApi, mapToCapabilityError, CapabilityUnsupportedError } from './capabilities.js';

package/dist/internal/internalConsole.d.ts

@@ -0,0 +1,7 @@
+type LogFn = (...args: unknown[]) => void;
+export declare const internalConsole: Readonly<{
+    log: LogFn;
+    warn: LogFn;
+    error: LogFn;
+}>;
+export {};

package/dist/internal/ipcBus.d.ts

@@ -0,0 +1,48 @@
+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

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

package/dist/internal/topic.d.ts

@@ -0,0 +1,20 @@
+export type Unsubscribe = () => void;
+export interface Stream<T> {
+    on(listener: (event: T) => void): Unsubscribe;
+}
+export interface Topic<T> extends Stream<T> {
+    current(): T | undefined;
+}
+export interface MutableTopic<T> extends Topic<T> {
+    set(value: T): void;
+}
+export interface MutableStream<T> extends Stream<T> {
+    emit(event: T): void;
+}
+export declare function createTopic<T>(initial?: T): MutableTopic<T>;
+export declare function createStream<T>(): MutableStream<T>;
+/**
+ * Read a window global by name and return its value (or undefined in
+ * non-browser environments such as Node test runners).
+ */
+export declare function readWindowGlobal<T = unknown>(key: string): T | undefined;

package/dist/runtime/defineMessage.d.ts

@@ -0,0 +1,6 @@
+import type { MessageContract } from '../shared/defineMessage.js';
+import type { MessageHandler, MessageHandlerContext } from '../generated/runtime.definePlugin.generated.js';
+export interface RuntimeMessageContract<TReq, TResp> extends MessageContract<TReq, TResp> {
+    handle(fn: (req: TReq, ctx: MessageHandlerContext) => Promise<TResp> | TResp): readonly [string, MessageHandler];
+}
+export declare function defineMessage<TReq, TResp>(key: string): RuntimeMessageContract<TReq, TResp>;

package/dist/runtime/index.cjs

@@ -0,0 +1,163 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/runtime/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CapabilityUnsupportedError: () => CapabilityUnsupportedError,
+  actionResult: () => actionResult,
+  defineMessage: () => defineMessage,
+  definePlugin: () => definePlugin,
+  host: () => host
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/internal/internalConsole.ts
+function pick(method) {
+  if (typeof globalThis === "undefined") return () => {
+  };
+  const g = globalThis;
+  const fn = g.console?.[method];
+  if (typeof fn !== "function") return () => {
+  };
+  return fn.bind(g.console);
+}
+var internalConsole = Object.freeze({
+  log: pick("log"),
+  warn: pick("warn"),
+  error: pick("error")
+});
+
+// src/internal/ipcBus.ts
+var _instance = null;
+var ipcBus = new Proxy({}, {
+  get(_target, prop) {
+    if (!_instance) {
+      throw new Error("[clipbus-plugin] ipcBus accessed before configureIpcBus() was called.");
+    }
+    return _instance[prop];
+  }
+});
+
+// src/generated/runtime.host.generated.ts
+var host = {
+  item: {
+    setTags: (payload) => ipcBus.request("item.setTags", payload),
+    addTags: (payload) => ipcBus.request("item.addTags", payload),
+    removeTags: (payload) => ipcBus.request("item.removeTags", payload),
+    setPinned: (payload) => ipcBus.request("item.setPinned", payload),
+    setAttachments: (payload) => ipcBus.request("item.setAttachments", payload),
+    setSearchExtension: (payload) => ipcBus.request("item.setSearchExtension", payload),
+    materializeImagePath: () => ipcBus.request("item.materializeImagePath", {}),
+    readAttachment: (payload) => ipcBus.request("item.readAttachment", payload)
+  },
+  asset: {
+    registerImage: (payload) => ipcBus.request("asset.registerImage", payload)
+  },
+  clipboard: {
+    copyText: (payload) => ipcBus.request("clipboard.copyText", payload)
+  },
+  navigation: {
+    openUrl: (payload) => ipcBus.request("navigation.openUrl", payload),
+    revealInFinder: (payload) => ipcBus.request("navigation.revealInFinder", payload),
+    openFilePath: (payload) => ipcBus.request("navigation.openFilePath", payload)
+  },
+  action: {
+    allocateImageTempPath: (payload) => ipcBus.request("action.allocateImageTempPath", payload)
+  },
+  settings: {
+    get: (payload) => ipcBus.request("settings.get", payload),
+    getAll: () => ipcBus.request("settings.getAll", {})
+  },
+  console: {
+    log: (payload) => ipcBus.request("console.log", payload)
+  }
+};
+
+// src/generated/runtime.definePlugin.generated.ts
+function definePlugin(definition) {
+  if ("setup" in definition) {
+    return {
+      setup() {
+        const registry = definition.setup();
+        validateRegistry(registry);
+        return registry;
+      }
+    };
+  }
+  validateRegistry(definition);
+  return { setup() {
+    return definition;
+  } };
+}
+function validateRegistry(registry) {
+  for (const [id, handler] of Object.entries(registry.attachmentRenderers ?? {})) {
+    if (handler && typeof handler === "object" && "invokeOperation" in handler) {
+      throw new Error(`attachmentRenderers["${id}"]: invokeOperation has been removed.`);
+    }
+  }
+  for (const [id, handler] of Object.entries(registry.actions ?? {})) {
+    if (handler && typeof handler === "object" && "invokeOperation" in handler) {
+      throw new Error(`actions["${id}"]: invokeOperation has been removed.`);
+    }
+  }
+}
+
+// src/generated/runtime.actionResult.generated.ts
+var actionResult = {
+  text: (text, options) => ({
+    result: { resultKind: "text", text },
+    userMessage: options?.userMessage
+  }),
+  image: (imageTempPath, options) => ({
+    result: { resultKind: "image", imageTempPath, ...options && "imageFormatHint" in options ? { imageFormatHint: options.imageFormatHint } : {} },
+    userMessage: options?.userMessage
+  }),
+  none: (options) => ({
+    result: { resultKind: "none" },
+    userMessage: options?.userMessage
+  })
+};
+
+// src/runtime/defineMessage.ts
+function defineMessage(key) {
+  return {
+    key,
+    handle: (fn) => [key, ((req, ctx) => fn(req, ctx))]
+  };
+}
+
+// src/internal/capabilities.ts
+var CapabilityUnsupportedError = class extends Error {
+  capability;
+  constructor(capability) {
+    super(`Capability not supported by host: ${capability}`);
+    this.name = "CapabilityUnsupportedError";
+    this.capability = capability;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CapabilityUnsupportedError,
+  actionResult,
+  defineMessage,
+  definePlugin,
+  host
+});

package/dist/runtime/index.d.cts

@@ -0,0 +1,4 @@
+export * from '../generated/INDEX.runtime.generated.js';
+export { defineMessage } from './defineMessage.js';
+export type { RuntimeMessageContract } from './defineMessage.js';
+export { CapabilityUnsupportedError } from '../internal/capabilities.js';

package/dist/runtime/index.d.ts

@@ -0,0 +1,4 @@
+export * from '../generated/INDEX.runtime.generated.js';
+export { defineMessage } from './defineMessage.js';
+export type { RuntimeMessageContract } from './defineMessage.js';
+export { CapabilityUnsupportedError } from '../internal/capabilities.js';