@vetta-org/plugin-sdk 0.0.3 → 0.1.0

package/dist/fs.d.ts

@@ -0,0 +1,43 @@
+export interface PluginFsEntry {
+    name: string;
+    path: string;
+    isDirectory: boolean;
+    size: number;
+    modifiedAt: number;
+}
+export interface PluginFsFileRef {
+    name: string;
+    path: string;
+    relPath: string;
+}
+export interface PluginFsStatResult {
+    size: number;
+    modifiedAt: number;
+    createdAt: number;
+}
+export interface PluginFsReadResult {
+    content: string;
+    encoding: "utf8" | "base64";
+}
+export interface PluginFsBinaryReadResult {
+    data: string;
+    mimeType: string;
+    size: number;
+}
+export interface PluginFsApi {
+    readDir(dirPath: string): Promise<PluginFsEntry[]>;
+    readFile(filePath: string): Promise<PluginFsReadResult>;
+    readBinaryFile(filePath: string): Promise<PluginFsBinaryReadResult>;
+    /** Pass `encoding: "base64"` to write binary payloads (decoded from base64 text). */
+    writeFile(filePath: string, content: string, encoding?: "utf8" | "base64"): Promise<void>;
+    stat(filePath: string): Promise<PluginFsStatResult | null>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    delete(targetPath: string): Promise<void>;
+    move(sourcePath: string, destDir: string): Promise<void>;
+    createDirectory(dirPath: string): Promise<void>;
+    listFilesRecursive(rootPath: string): Promise<PluginFsFileRef[]>;
+    /** Watch one directory for host-debounced changes. Requires `fs.read`. */
+    watchDirectory(dirPath: string, listener: (changedPath: string) => void): Disposable;
+}
+import type { Disposable } from "./disposable.js";
+//# sourceMappingURL=fs.d.ts.map

package/dist/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACpE,qFAAqF;IACrF,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACjE,0EAA0E;IAC1E,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,UAAU,CAAC;CACrF;AACD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["export interface PluginFsEntry {\n\tname: string;\n\tpath: string;\n\tisDirectory: boolean;\n\tsize: number;\n\tmodifiedAt: number;\n}\n\nexport interface PluginFsFileRef {\n\tname: string;\n\tpath: string;\n\trelPath: string;\n}\n\nexport interface PluginFsStatResult {\n\tsize: number;\n\tmodifiedAt: number;\n\tcreatedAt: number;\n}\n\nexport interface PluginFsReadResult {\n\tcontent: string;\n\tencoding: \"utf8\" | \"base64\";\n}\n\nexport interface PluginFsBinaryReadResult {\n\tdata: string;\n\tmimeType: string;\n\tsize: number;\n}\n\nexport interface PluginFsApi {\n\treadDir(dirPath: string): Promise<PluginFsEntry[]>;\n\treadFile(filePath: string): Promise<PluginFsReadResult>;\n\treadBinaryFile(filePath: string): Promise<PluginFsBinaryReadResult>;\n\t/** Pass `encoding: \"base64\"` to write binary payloads (decoded from base64 text). */\n\twriteFile(filePath: string, content: string, encoding?: \"utf8\" | \"base64\"): Promise<void>;\n\tstat(filePath: string): Promise<PluginFsStatResult | null>;\n\trename(oldPath: string, newPath: string): Promise<void>;\n\tdelete(targetPath: string): Promise<void>;\n\tmove(sourcePath: string, destDir: string): Promise<void>;\n\tcreateDirectory(dirPath: string): Promise<void>;\n\tlistFilesRecursive(rootPath: string): Promise<PluginFsFileRef[]>;\n\t/** Watch one directory for host-debounced changes. Requires `fs.read`. */\n\twatchDirectory(dirPath: string, listener: (changedPath: string) => void): Disposable;\n}\nimport type { Disposable } from \"./disposable.js\";\n"]}

package/dist/fs.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fs.js.map

package/dist/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"","sourcesContent":["export interface PluginFsEntry {\n\tname: string;\n\tpath: string;\n\tisDirectory: boolean;\n\tsize: number;\n\tmodifiedAt: number;\n}\n\nexport interface PluginFsFileRef {\n\tname: string;\n\tpath: string;\n\trelPath: string;\n}\n\nexport interface PluginFsStatResult {\n\tsize: number;\n\tmodifiedAt: number;\n\tcreatedAt: number;\n}\n\nexport interface PluginFsReadResult {\n\tcontent: string;\n\tencoding: \"utf8\" | \"base64\";\n}\n\nexport interface PluginFsBinaryReadResult {\n\tdata: string;\n\tmimeType: string;\n\tsize: number;\n}\n\nexport interface PluginFsApi {\n\treadDir(dirPath: string): Promise<PluginFsEntry[]>;\n\treadFile(filePath: string): Promise<PluginFsReadResult>;\n\treadBinaryFile(filePath: string): Promise<PluginFsBinaryReadResult>;\n\t/** Pass `encoding: \"base64\"` to write binary payloads (decoded from base64 text). */\n\twriteFile(filePath: string, content: string, encoding?: \"utf8\" | \"base64\"): Promise<void>;\n\tstat(filePath: string): Promise<PluginFsStatResult | null>;\n\trename(oldPath: string, newPath: string): Promise<void>;\n\tdelete(targetPath: string): Promise<void>;\n\tmove(sourcePath: string, destDir: string): Promise<void>;\n\tcreateDirectory(dirPath: string): Promise<void>;\n\tlistFilesRecursive(rootPath: string): Promise<PluginFsFileRef[]>;\n\t/** Watch one directory for host-debounced changes. Requires `fs.read`. */\n\twatchDirectory(dirPath: string, listener: (changedPath: string) => void): Disposable;\n}\nimport type { Disposable } from \"./disposable.js\";\n"]}

package/dist/hooks.d.ts

@@ -0,0 +1,37 @@
+import type { ConversationMessage, ConversationState } from "./conversation.js";
+import type { PluginLocales, PluginTranslate } from "./i18n.js";
+import type { PluginPromptAttachment } from "./prompt-attachment.js";
+export interface PluginI18nContextValue {
+    /** This plugin's catalogs, keyed by locale code. */
+    locales: PluginLocales;
+    /** Fallback locale when a key is missing in the current locale. */
+    defaultLocale: string;
+}
+/**
+ * Internal: the host wraps plugin-rendered components in this context's Provider,
+ * carrying THIS plugin's catalogs. Module Federation shares this single SDK
+ * instance, so the value the host provides is visible to {@link useTranslation}.
+ */
+export declare const __PluginI18nContext: import("react").Context<PluginI18nContextValue>;
+export interface PluginTranslation {
+    /** The host's current locale code (e.g. "zh"). */
+    locale: string;
+    /** Resolve a bare catalog key at the current locale, with optional `{{params}}`. */
+    t: PluginTranslate;
+}
+/**
+ * Reactive translation for plugin React components — re-renders when the host
+ * language changes. `t` resolves a BARE catalog key (no `%...%` wrapper) against
+ * THIS plugin's catalogs; the host provides them via __PluginI18nContext.
+ */
+export declare function useTranslation(): PluginTranslation;
+/** Reactive: the currently-active conversation's state. */
+export declare function useActiveConversation(): ConversationState;
+/** Reactive: the active conversation's messages. */
+export declare function useConversationMessages(): ConversationMessage[];
+/**
+ * Reactive: the plugin-owned one-shot context attached to the next prompt.
+ * Clears automatically after send, capsule close, or session switch.
+ */
+export declare function usePromptAttachment(): PluginPromptAttachment | null;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEhE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAIrE,MAAM,WAAW,sBAAsB;IACtC,oDAAoD;IACpD,OAAO,EAAE,aAAa,CAAC;IACvB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iDAG9B,CAAC;AAEH,MAAM,WAAW,iBAAiB;IACjC,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,CAAC,EAAE,eAAe,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CAQlD;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,IAAI,iBAAiB,CAEzD;AAED,oDAAoD;AACpD,wBAAgB,uBAAuB,IAAI,mBAAmB,EAAE,CAE/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,sBAAsB,GAAG,IAAI,CAEnE","sourcesContent":["import { createContext, useCallback, useContext } from \"react\";\nimport type { ConversationMessage, ConversationState } from \"./conversation.js\";\nimport { requireBridge } from \"./host-bridge.js\";\nimport type { PluginLocales, PluginTranslate } from \"./i18n.js\";\nimport { resolveCatalogKey } from \"./i18n.js\";\nimport type { PluginPromptAttachment } from \"./prompt-attachment.js\";\n\n// ─── i18n context (host-provided, per plugin) ───\n\nexport interface PluginI18nContextValue {\n\t/** This plugin's catalogs, keyed by locale code. */\n\tlocales: PluginLocales;\n\t/** Fallback locale when a key is missing in the current locale. */\n\tdefaultLocale: string;\n}\n\n/**\n * Internal: the host wraps plugin-rendered components in this context's Provider,\n * carrying THIS plugin's catalogs. Module Federation shares this single SDK\n * instance, so the value the host provides is visible to {@link useTranslation}.\n */\nexport const __PluginI18nContext = createContext<PluginI18nContextValue>({\n\tlocales: {},\n\tdefaultLocale: \"zh\",\n});\n\nexport interface PluginTranslation {\n\t/** The host's current locale code (e.g. \"zh\"). */\n\tlocale: string;\n\t/** Resolve a bare catalog key at the current locale, with optional `{{params}}`. */\n\tt: PluginTranslate;\n}\n\n/**\n * Reactive translation for plugin React components — re-renders when the host\n * language changes. `t` resolves a BARE catalog key (no `%...%` wrapper) against\n * THIS plugin's catalogs; the host provides them via __PluginI18nContext.\n */\nexport function useTranslation(): PluginTranslation {\n\tconst locale = requireBridge().useLocale();\n\tconst { locales, defaultLocale } = useContext(__PluginI18nContext);\n\tconst t = useCallback<PluginTranslate>(\n\t\t(key, params) => resolveCatalogKey(key, locales, locale, defaultLocale, params),\n\t\t[locales, locale, defaultLocale],\n\t);\n\treturn { locale, t };\n}\n\n/** Reactive: the currently-active conversation's state. */\nexport function useActiveConversation(): ConversationState {\n\treturn requireBridge().useActiveConversation();\n}\n\n/** Reactive: the active conversation's messages. */\nexport function useConversationMessages(): ConversationMessage[] {\n\treturn requireBridge().useConversationMessages();\n}\n\n/**\n * Reactive: the plugin-owned one-shot context attached to the next prompt.\n * Clears automatically after send, capsule close, or session switch.\n */\nexport function usePromptAttachment(): PluginPromptAttachment | null {\n\treturn requireBridge().usePromptAttachment();\n}\n"]}

package/dist/hooks.js

@@ -0,0 +1,39 @@
+import { createContext, useCallback, useContext } from "react";
+import { requireBridge } from "./host-bridge.js";
+import { resolveCatalogKey } from "./i18n.js";
+/**
+ * Internal: the host wraps plugin-rendered components in this context's Provider,
+ * carrying THIS plugin's catalogs. Module Federation shares this single SDK
+ * instance, so the value the host provides is visible to {@link useTranslation}.
+ */
+export const __PluginI18nContext = createContext({
+    locales: {},
+    defaultLocale: "zh",
+});
+/**
+ * Reactive translation for plugin React components — re-renders when the host
+ * language changes. `t` resolves a BARE catalog key (no `%...%` wrapper) against
+ * THIS plugin's catalogs; the host provides them via __PluginI18nContext.
+ */
+export function useTranslation() {
+    const locale = requireBridge().useLocale();
+    const { locales, defaultLocale } = useContext(__PluginI18nContext);
+    const t = useCallback((key, params) => resolveCatalogKey(key, locales, locale, defaultLocale, params), [locales, locale, defaultLocale]);
+    return { locale, t };
+}
+/** Reactive: the currently-active conversation's state. */
+export function useActiveConversation() {
+    return requireBridge().useActiveConversation();
+}
+/** Reactive: the active conversation's messages. */
+export function useConversationMessages() {
+    return requireBridge().useConversationMessages();
+}
+/**
+ * Reactive: the plugin-owned one-shot context attached to the next prompt.
+ * Clears automatically after send, capsule close, or session switch.
+ */
+export function usePromptAttachment() {
+    return requireBridge().usePromptAttachment();
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAY9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAyB;IACxE,OAAO,EAAE,EAAE;IACX,aAAa,EAAE,IAAI;CACnB,CAAC,CAAC;AASH;;;;GAIG;AACH,MAAM,UAAU,cAAc,GAAsB;IACnD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC,SAAS,EAAE,CAAC;IAC3C,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IACnE,MAAM,CAAC,GAAG,WAAW,CACpB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAC/E,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAChC,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAAA,CACrB;AAED,2DAA2D;AAC3D,MAAM,UAAU,qBAAqB,GAAsB;IAC1D,OAAO,aAAa,EAAE,CAAC,qBAAqB,EAAE,CAAC;AAAA,CAC/C;AAED,oDAAoD;AACpD,MAAM,UAAU,uBAAuB,GAA0B;IAChE,OAAO,aAAa,EAAE,CAAC,uBAAuB,EAAE,CAAC;AAAA,CACjD;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,GAAkC;IACpE,OAAO,aAAa,EAAE,CAAC,mBAAmB,EAAE,CAAC;AAAA,CAC7C","sourcesContent":["import { createContext, useCallback, useContext } from \"react\";\nimport type { ConversationMessage, ConversationState } from \"./conversation.js\";\nimport { requireBridge } from \"./host-bridge.js\";\nimport type { PluginLocales, PluginTranslate } from \"./i18n.js\";\nimport { resolveCatalogKey } from \"./i18n.js\";\nimport type { PluginPromptAttachment } from \"./prompt-attachment.js\";\n\n// ─── i18n context (host-provided, per plugin) ───\n\nexport interface PluginI18nContextValue {\n\t/** This plugin's catalogs, keyed by locale code. */\n\tlocales: PluginLocales;\n\t/** Fallback locale when a key is missing in the current locale. */\n\tdefaultLocale: string;\n}\n\n/**\n * Internal: the host wraps plugin-rendered components in this context's Provider,\n * carrying THIS plugin's catalogs. Module Federation shares this single SDK\n * instance, so the value the host provides is visible to {@link useTranslation}.\n */\nexport const __PluginI18nContext = createContext<PluginI18nContextValue>({\n\tlocales: {},\n\tdefaultLocale: \"zh\",\n});\n\nexport interface PluginTranslation {\n\t/** The host's current locale code (e.g. \"zh\"). */\n\tlocale: string;\n\t/** Resolve a bare catalog key at the current locale, with optional `{{params}}`. */\n\tt: PluginTranslate;\n}\n\n/**\n * Reactive translation for plugin React components — re-renders when the host\n * language changes. `t` resolves a BARE catalog key (no `%...%` wrapper) against\n * THIS plugin's catalogs; the host provides them via __PluginI18nContext.\n */\nexport function useTranslation(): PluginTranslation {\n\tconst locale = requireBridge().useLocale();\n\tconst { locales, defaultLocale } = useContext(__PluginI18nContext);\n\tconst t = useCallback<PluginTranslate>(\n\t\t(key, params) => resolveCatalogKey(key, locales, locale, defaultLocale, params),\n\t\t[locales, locale, defaultLocale],\n\t);\n\treturn { locale, t };\n}\n\n/** Reactive: the currently-active conversation's state. */\nexport function useActiveConversation(): ConversationState {\n\treturn requireBridge().useActiveConversation();\n}\n\n/** Reactive: the active conversation's messages. */\nexport function useConversationMessages(): ConversationMessage[] {\n\treturn requireBridge().useConversationMessages();\n}\n\n/**\n * Reactive: the plugin-owned one-shot context attached to the next prompt.\n * Clears automatically after send, capsule close, or session switch.\n */\nexport function usePromptAttachment(): PluginPromptAttachment | null {\n\treturn requireBridge().usePromptAttachment();\n}\n"]}

package/dist/host-bridge.d.ts

@@ -0,0 +1,14 @@
+import type { ConversationMessage, ConversationState, PluginConversationApi } from "./conversation.js";
+import type { PluginPromptAttachment } from "./prompt-attachment.js";
+export interface PluginHostBridge {
+    useActiveConversation(): ConversationState;
+    useConversationMessages(): ConversationMessage[];
+    usePromptAttachment(): PluginPromptAttachment | null;
+    /** Reactive: the host's current locale code (e.g. "zh"). */
+    useLocale(): string;
+    conversation: PluginConversationApi;
+}
+export declare function __setPluginHostBridge(bridge: PluginHostBridge): void;
+/** Package-internal: throws if the host has not installed the bridge yet. */
+export declare function requireBridge(): PluginHostBridge;
+//# sourceMappingURL=host-bridge.d.ts.map

package/dist/host-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-bridge.d.ts","sourceRoot":"","sources":["../src/host-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACvG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAUrE,MAAM,WAAW,gBAAgB;IAChC,qBAAqB,IAAI,iBAAiB,CAAC;IAC3C,uBAAuB,IAAI,mBAAmB,EAAE,CAAC;IACjD,mBAAmB,IAAI,sBAAsB,GAAG,IAAI,CAAC;IACrD,4DAA4D;IAC5D,SAAS,IAAI,MAAM,CAAC;IACpB,YAAY,EAAE,qBAAqB,CAAC;CACpC;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAEpE;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,IAAI,gBAAgB,CAKhD","sourcesContent":["import type { ConversationMessage, ConversationState, PluginConversationApi } from \"./conversation.js\";\nimport type { PluginPromptAttachment } from \"./prompt-attachment.js\";\n\n// ─── Host bridge ───\n//\n// React hooks and conversation state read the host's jotai store. plugin-sdk\n// cannot depend on desktop-app, so the host injects its implementation at\n// startup (installPluginHostShim → __setPluginHostBridge). Module Federation\n// makes host and plugins share this single pluginSdk instance, so the bridge\n// the host sets is visible to the hooks the plugin calls.\n\nexport interface PluginHostBridge {\n\tuseActiveConversation(): ConversationState;\n\tuseConversationMessages(): ConversationMessage[];\n\tusePromptAttachment(): PluginPromptAttachment | null;\n\t/** Reactive: the host's current locale code (e.g. \"zh\"). */\n\tuseLocale(): string;\n\tconversation: PluginConversationApi;\n}\n\nlet hostBridge: PluginHostBridge | undefined;\n\nexport function __setPluginHostBridge(bridge: PluginHostBridge): void {\n\thostBridge = bridge;\n}\n\n/** Package-internal: throws if the host has not installed the bridge yet. */\nexport function requireBridge(): PluginHostBridge {\n\tif (!hostBridge) {\n\t\tthrow new Error(\"Vetta plugin host bridge is not installed\");\n\t}\n\treturn hostBridge;\n}\n"]}

package/dist/host-bridge.js

@@ -0,0 +1,12 @@
+let hostBridge;
+export function __setPluginHostBridge(bridge) {
+    hostBridge = bridge;
+}
+/** Package-internal: throws if the host has not installed the bridge yet. */
+export function requireBridge() {
+    if (!hostBridge) {
+        throw new Error("Vetta plugin host bridge is not installed");
+    }
+    return hostBridge;
+}
+//# sourceMappingURL=host-bridge.js.map

package/dist/host-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-bridge.js","sourceRoot":"","sources":["../src/host-bridge.ts"],"names":[],"mappings":"AAoBA,IAAI,UAAwC,CAAC;AAE7C,MAAM,UAAU,qBAAqB,CAAC,MAAwB,EAAQ;IACrE,UAAU,GAAG,MAAM,CAAC;AAAA,CACpB;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa,GAAqB;IACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,UAAU,CAAC;AAAA,CAClB","sourcesContent":["import type { ConversationMessage, ConversationState, PluginConversationApi } from \"./conversation.js\";\nimport type { PluginPromptAttachment } from \"./prompt-attachment.js\";\n\n// ─── Host bridge ───\n//\n// React hooks and conversation state read the host's jotai store. plugin-sdk\n// cannot depend on desktop-app, so the host injects its implementation at\n// startup (installPluginHostShim → __setPluginHostBridge). Module Federation\n// makes host and plugins share this single pluginSdk instance, so the bridge\n// the host sets is visible to the hooks the plugin calls.\n\nexport interface PluginHostBridge {\n\tuseActiveConversation(): ConversationState;\n\tuseConversationMessages(): ConversationMessage[];\n\tusePromptAttachment(): PluginPromptAttachment | null;\n\t/** Reactive: the host's current locale code (e.g. \"zh\"). */\n\tuseLocale(): string;\n\tconversation: PluginConversationApi;\n}\n\nlet hostBridge: PluginHostBridge | undefined;\n\nexport function __setPluginHostBridge(bridge: PluginHostBridge): void {\n\thostBridge = bridge;\n}\n\n/** Package-internal: throws if the host has not installed the bridge yet. */\nexport function requireBridge(): PluginHostBridge {\n\tif (!hostBridge) {\n\t\tthrow new Error(\"Vetta plugin host bridge is not installed\");\n\t}\n\treturn hostBridge;\n}\n"]}

package/dist/i18n.d.ts

@@ -0,0 +1,35 @@
+import type { Disposable } from "./disposable.js";
+/** A flat catalog: translation key → localized string. */
+export type PluginLocaleCatalog = Record<string, string>;
+/** Every catalog a plugin ships, keyed by locale code (e.g. "zh", "en"). */
+export type PluginLocales = Record<string, PluginLocaleCatalog>;
+/** Replace `{{name}}` placeholders in a resolved string with `params`. */
+export declare function interpolatePluginText(text: string, params?: Record<string, string | number>): string;
+/**
+ * Resolve a bare catalog key against a plugin's catalogs. Fallback chain:
+ * current-locale catalog → the plugin's `defaultLocale` catalog → the bare key
+ * itself (a dev signal for a missing translation). Then interpolate `{{params}}`.
+ */
+export declare function resolveCatalogKey(key: string, locales: PluginLocales, currentLocale: string, defaultLocale: string, params?: Record<string, string | number>): string;
+/**
+ * Resolve a host-rendered plugin string. A value of the exact form `%key%` is a
+ * catalog key (resolved via {@link resolveCatalogKey}); any other string is a
+ * literal and returned unchanged — backwards compatible with bare strings.
+ */
+export declare function resolvePluginText(raw: string, locales: PluginLocales, currentLocale: string, defaultLocale: string, params?: Record<string, string | number>): string;
+export type PluginTranslate = (key: string, params?: Record<string, string | number>) => string;
+/**
+ * This plugin's i18n surface on the context. `locale` always equals the host's
+ * current language; `t` resolves a BARE catalog key (no `%...%` wrapper) against
+ * this plugin's catalogs at the current locale. Imperative — for plugin React
+ * components prefer the reactive {@link useTranslation} hook.
+ */
+export interface PluginI18nApi {
+    /** The host's current locale code (e.g. "zh"). */
+    readonly locale: string;
+    /** Resolve a bare catalog key at the current locale, with optional `{{params}}`. */
+    t: PluginTranslate;
+    /** Fired when the host language changes. */
+    onChange(listener: (locale: string) => void): Disposable;
+}
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,4DAA0D;AAC1D,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzD,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEhE,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAGpG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,MAAM,CAIR;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,MAAM,CAIR;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;AAEhG;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,CAAC,EAAE,eAAe,CAAC;IACnB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,UAAU,CAAC;CACzD","sourcesContent":["import type { Disposable } from \"./disposable.js\";\n\n/** A flat catalog: translation key → localized string. */\nexport type PluginLocaleCatalog = Record<string, string>;\n/** Every catalog a plugin ships, keyed by locale code (e.g. \"zh\", \"en\"). */\nexport type PluginLocales = Record<string, PluginLocaleCatalog>;\n\n/** Replace `{{name}}` placeholders in a resolved string with `params`. */\nexport function interpolatePluginText(text: string, params?: Record<string, string | number>): string {\n\tif (!params) return text;\n\treturn text.replace(/\\{\\{(\\w+)\\}\\}/g, (match, name: string) => (name in params ? String(params[name]) : match));\n}\n\n/**\n * Resolve a bare catalog key against a plugin's catalogs. Fallback chain:\n * current-locale catalog → the plugin's `defaultLocale` catalog → the bare key\n * itself (a dev signal for a missing translation). Then interpolate `{{params}}`.\n */\nexport function resolveCatalogKey(\n\tkey: string,\n\tlocales: PluginLocales,\n\tcurrentLocale: string,\n\tdefaultLocale: string,\n\tparams?: Record<string, string | number>,\n): string {\n\tconst fromCurrent = locales[currentLocale]?.[key];\n\tconst fromDefault = locales[defaultLocale]?.[key];\n\treturn interpolatePluginText(fromCurrent ?? fromDefault ?? key, params);\n}\n\nconst I18N_KEY_PATTERN = /^%([^%]+)%$/;\n\n/**\n * Resolve a host-rendered plugin string. A value of the exact form `%key%` is a\n * catalog key (resolved via {@link resolveCatalogKey}); any other string is a\n * literal and returned unchanged — backwards compatible with bare strings.\n */\nexport function resolvePluginText(\n\traw: string,\n\tlocales: PluginLocales,\n\tcurrentLocale: string,\n\tdefaultLocale: string,\n\tparams?: Record<string, string | number>,\n): string {\n\tconst match = I18N_KEY_PATTERN.exec(raw);\n\tif (!match) return raw;\n\treturn resolveCatalogKey(match[1], locales, currentLocale, defaultLocale, params);\n}\n\nexport type PluginTranslate = (key: string, params?: Record<string, string | number>) => string;\n\n/**\n * This plugin's i18n surface on the context. `locale` always equals the host's\n * current language; `t` resolves a BARE catalog key (no `%...%` wrapper) against\n * this plugin's catalogs at the current locale. Imperative — for plugin React\n * components prefer the reactive {@link useTranslation} hook.\n */\nexport interface PluginI18nApi {\n\t/** The host's current locale code (e.g. \"zh\"). */\n\treadonly locale: string;\n\t/** Resolve a bare catalog key at the current locale, with optional `{{params}}`. */\n\tt: PluginTranslate;\n\t/** Fired when the host language changes. */\n\tonChange(listener: (locale: string) => void): Disposable;\n}\n"]}

package/dist/i18n.js

@@ -0,0 +1,29 @@
+/** Replace `{{name}}` placeholders in a resolved string with `params`. */
+export function interpolatePluginText(text, params) {
+    if (!params)
+        return text;
+    return text.replace(/\{\{(\w+)\}\}/g, (match, name) => (name in params ? String(params[name]) : match));
+}
+/**
+ * Resolve a bare catalog key against a plugin's catalogs. Fallback chain:
+ * current-locale catalog → the plugin's `defaultLocale` catalog → the bare key
+ * itself (a dev signal for a missing translation). Then interpolate `{{params}}`.
+ */
+export function resolveCatalogKey(key, locales, currentLocale, defaultLocale, params) {
+    const fromCurrent = locales[currentLocale]?.[key];
+    const fromDefault = locales[defaultLocale]?.[key];
+    return interpolatePluginText(fromCurrent ?? fromDefault ?? key, params);
+}
+const I18N_KEY_PATTERN = /^%([^%]+)%$/;
+/**
+ * Resolve a host-rendered plugin string. A value of the exact form `%key%` is a
+ * catalog key (resolved via {@link resolveCatalogKey}); any other string is a
+ * literal and returned unchanged — backwards compatible with bare strings.
+ */
+export function resolvePluginText(raw, locales, currentLocale, defaultLocale, params) {
+    const match = I18N_KEY_PATTERN.exec(raw);
+    if (!match)
+        return raw;
+    return resolveCatalogKey(match[1], locales, currentLocale, defaultLocale, params);
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAOA,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAwC,EAAU;IACrG,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAAA,CAChH;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAChC,GAAW,EACX,OAAsB,EACtB,aAAqB,EACrB,aAAqB,EACrB,MAAwC,EAC/B;IACT,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO,qBAAqB,CAAC,WAAW,IAAI,WAAW,IAAI,GAAG,EAAE,MAAM,CAAC,CAAC;AAAA,CACxE;AAED,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAChC,GAAW,EACX,OAAsB,EACtB,aAAqB,EACrB,aAAqB,EACrB,MAAwC,EAC/B;IACT,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC;IACvB,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;AAAA,CAClF","sourcesContent":["import type { Disposable } from \"./disposable.js\";\n\n/** A flat catalog: translation key → localized string. */\nexport type PluginLocaleCatalog = Record<string, string>;\n/** Every catalog a plugin ships, keyed by locale code (e.g. \"zh\", \"en\"). */\nexport type PluginLocales = Record<string, PluginLocaleCatalog>;\n\n/** Replace `{{name}}` placeholders in a resolved string with `params`. */\nexport function interpolatePluginText(text: string, params?: Record<string, string | number>): string {\n\tif (!params) return text;\n\treturn text.replace(/\\{\\{(\\w+)\\}\\}/g, (match, name: string) => (name in params ? String(params[name]) : match));\n}\n\n/**\n * Resolve a bare catalog key against a plugin's catalogs. Fallback chain:\n * current-locale catalog → the plugin's `defaultLocale` catalog → the bare key\n * itself (a dev signal for a missing translation). Then interpolate `{{params}}`.\n */\nexport function resolveCatalogKey(\n\tkey: string,\n\tlocales: PluginLocales,\n\tcurrentLocale: string,\n\tdefaultLocale: string,\n\tparams?: Record<string, string | number>,\n): string {\n\tconst fromCurrent = locales[currentLocale]?.[key];\n\tconst fromDefault = locales[defaultLocale]?.[key];\n\treturn interpolatePluginText(fromCurrent ?? fromDefault ?? key, params);\n}\n\nconst I18N_KEY_PATTERN = /^%([^%]+)%$/;\n\n/**\n * Resolve a host-rendered plugin string. A value of the exact form `%key%` is a\n * catalog key (resolved via {@link resolveCatalogKey}); any other string is a\n * literal and returned unchanged — backwards compatible with bare strings.\n */\nexport function resolvePluginText(\n\traw: string,\n\tlocales: PluginLocales,\n\tcurrentLocale: string,\n\tdefaultLocale: string,\n\tparams?: Record<string, string | number>,\n): string {\n\tconst match = I18N_KEY_PATTERN.exec(raw);\n\tif (!match) return raw;\n\treturn resolveCatalogKey(match[1], locales, currentLocale, defaultLocale, params);\n}\n\nexport type PluginTranslate = (key: string, params?: Record<string, string | number>) => string;\n\n/**\n * This plugin's i18n surface on the context. `locale` always equals the host's\n * current language; `t` resolves a BARE catalog key (no `%...%` wrapper) against\n * this plugin's catalogs at the current locale. Imperative — for plugin React\n * components prefer the reactive {@link useTranslation} hook.\n */\nexport interface PluginI18nApi {\n\t/** The host's current locale code (e.g. \"zh\"). */\n\treadonly locale: string;\n\t/** Resolve a bare catalog key at the current locale, with optional `{{params}}`. */\n\tt: PluginTranslate;\n\t/** Fired when the host language changes. */\n\tonChange(listener: (locale: string) => void): Disposable;\n}\n"]}

package/dist/images.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A reference to an image produced out-of-band by the host (e.g. an image
+ * tool's result). The bytes are NOT carried inline — `url` is a host media
+ * URL (Range-capable, usable directly as an `<img src>`).
+ */
+export interface PluginImageRef {
+    id: string;
+    url: string;
+    mimeType?: string;
+    /**
+     * The edit-lineage root id this image belongs to (base image + all its edits
+     * share one rootId). Lets the host dedup per-message previews — only the
+     * latest message producing a given rootId renders the version swiper.
+     */
+    rootId?: string;
+}
+//# sourceMappingURL=images.d.ts.map

package/dist/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB","sourcesContent":["/**\n * A reference to an image produced out-of-band by the host (e.g. an image\n * tool's result). The bytes are NOT carried inline — `url` is a host media\n * URL (Range-capable, usable directly as an `<img src>`).\n */\nexport interface PluginImageRef {\n\tid: string;\n\turl: string;\n\tmimeType?: string;\n\t/**\n\t * The edit-lineage root id this image belongs to (base image + all its edits\n\t * share one rootId). Lets the host dedup per-message previews — only the\n\t * latest message producing a given rootId renders the version swiper.\n\t */\n\trootId?: string;\n}\n"]}

package/dist/images.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=images.js.map

package/dist/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * A reference to an image produced out-of-band by the host (e.g. an image\n * tool's result). The bytes are NOT carried inline — `url` is a host media\n * URL (Range-capable, usable directly as an `<img src>`).\n */\nexport interface PluginImageRef {\n\tid: string;\n\turl: string;\n\tmimeType?: string;\n\t/**\n\t * The edit-lineage root id this image belongs to (base image + all its edits\n\t * share one rootId). Lets the host dedup per-message previews — only the\n\t * latest message producing a given rootId renders the version swiper.\n\t */\n\trootId?: string;\n}\n"]}