unplugin-devpilot 0.0.3 → 0.0.5

package/README.md

@@ -79,6 +79,7 @@ export default defineConfig({
       wsPort: 3100, // Optional: Specify WebSocket port (will be randomly allocated if not specified)
       mcpPort: 3101, // Optional: Specify MCP server port (will use random port if specified port is occupied)
       plugins: [], // Optional: Array of DevpilotPlugin instances
+      skillPaths: ['./.github/skills/devpilot', './.cursor/skills/devpilot'], // Optional: Array of paths to core skill files
     }),
   ],
 });

package/dist/client/index.d.mts

@@ -10,6 +10,12 @@ interface ClientInfo {
 interface BaseServerFunctions {
   ping: () => string;
   updateClientInfo: (info: Omit<ClientInfo, "clientId" | "connectedAt" | "lastActiveAt">) => void;
+  storageGetItem: (namespace: string, key: string) => Promise<any>;
+  storageSetItem: (namespace: string, key: string, value: any) => Promise<void>;
+  storageRemoveItem: (namespace: string, key: string) => Promise<void>;
+  storageGetKeys: (namespace: string, base?: string) => Promise<string[]>;
+  storageHasItem: (namespace: string, key: string) => Promise<boolean>;
+  storageClear: (namespace: string, base?: string) => Promise<void>;
 }
 interface PluginServerFunctions {}
 type ServerFunctions = BaseServerFunctions & PluginServerFunctions;
@@ -36,6 +42,17 @@ interface DevpilotClientOptions {
   extendRpcHandlers?: Record<string, (...args: any[]) => any>;
 }
 //#endregion
+//#region src/client/storage.d.ts
+interface ClientStorage {
+  getItem: <T = any>(key: string) => Promise<T | null>;
+  setItem: <T = any>(key: string, value: T) => Promise<void>;
+  removeItem: (key: string) => Promise<void>;
+  getKeys: (base?: string) => Promise<string[]>;
+  hasItem: (key: string) => Promise<boolean>;
+  clear: (base?: string) => Promise<void>;
+}
+declare function createClientStorage(client: DevpilotClient<any>, namespace: string): ClientStorage;
+//#endregion
 //#region src/client/index.d.ts
 declare function createDevpilotClient<S extends Record<string, any> = ServerFunctions>(options: DevpilotClientOptions): DevpilotClient<S>;
 declare function initDevpilot<S extends Record<string, any> = ServerFunctions>(options: DevpilotClientOptions): DevpilotClient<S>;
@@ -59,4 +76,4 @@ declare function getDevpilotClient<S extends Record<string, any> = ServerFunctio
 */
 declare function defineRpcHandlers<T extends { [K in keyof T]: (...args: any[]) => any }>(handlers: T): T;
 //#endregion
-export { type DevpilotClient, type DevpilotClientOptions, type RpcHandlers, createDevpilotClient, defineRpcHandlers, getDevpilotClient, initDevpilot };
+export { type ClientStorage, type DevpilotClient, type DevpilotClientOptions, type RpcHandlers, createClientStorage, createDevpilotClient, defineRpcHandlers, getDevpilotClient, initDevpilot };

package/dist/client/index.mjs

@@ -1,3 +1,16 @@
+//#region src/client/storage.ts
+function createClientStorage(client, namespace) {
+	return {
+		getItem: (key) => client.rpcCall("storageGetItem", namespace, key),
+		setItem: (key, value) => client.rpcCall("storageSetItem", namespace, key, value),
+		removeItem: (key) => client.rpcCall("storageRemoveItem", namespace, key),
+		getKeys: (base) => client.rpcCall("storageGetKeys", namespace, base),
+		hasItem: (key) => client.rpcCall("storageHasItem", namespace, key),
+		clear: (base) => client.rpcCall("storageClear", namespace, base)
+	};
+}
+
+//#endregion
 //#region src/client/index.ts
 function generateId() {
 	return Math.random().toString(36).slice(2, 12);
@@ -143,4 +156,4 @@ function defineRpcHandlers(handlers) {
 }
 
 //#endregion
-export { createDevpilotClient, defineRpcHandlers, getDevpilotClient, initDevpilot };
+export { createClientStorage, createDevpilotClient, defineRpcHandlers, getDevpilotClient, initDevpilot };

package/dist/farm.d.mts

@@ -1,4 +1,4 @@
-import { t as unpluginDevpilot } from "./index-CQudsm6j.mjs";
+import { t as unpluginDevpilot } from "./index-DMYihCqJ.mjs";
 
 //#region src/farm.d.ts
 /**

package/dist/farm.mjs

@@ -1,4 +1,4 @@
-import { n as unpluginDevpilot } from "./src-Bm2tOOQC.mjs";
+import { n as unpluginDevpilot } from "./src-DkQU5cZx.mjs";
 
 //#region src/farm.ts
 /**

package/dist/{index-9V3dRAxA.d.mts → index-B3RgT4Na.d.mts}

@@ -1,3 +1,139 @@
+//#region ../../node_modules/.pnpm/unstorage@1.17.4/node_modules/unstorage/dist/shared/unstorage.Ca7R4QL2.d.mts
+type StorageValue = null | string | number | boolean | object;
+type WatchEvent = "update" | "remove";
+type WatchCallback = (event: WatchEvent, key: string) => any;
+type MaybePromise<T> = T | Promise<T>;
+type MaybeDefined<T> = T extends any ? T : any;
+type Unwatch = () => MaybePromise<void>;
+interface StorageMeta {
+  atime?: Date;
+  mtime?: Date;
+  ttl?: number;
+  [key: string]: StorageValue | Date | undefined;
+}
+type TransactionOptions = Record<string, any>;
+type GetKeysOptions = TransactionOptions & {
+  maxDepth?: number;
+};
+interface DriverFlags {
+  maxDepth?: boolean;
+  ttl?: boolean;
+}
+interface Driver<OptionsT = any, InstanceT = any> {
+  name?: string;
+  flags?: DriverFlags;
+  options?: OptionsT;
+  getInstance?: () => InstanceT;
+  hasItem: (key: string, opts: TransactionOptions) => MaybePromise<boolean>;
+  getItem: (key: string, opts?: TransactionOptions) => MaybePromise<StorageValue>;
+  /** @experimental */
+  getItems?: (items: {
+    key: string;
+    options?: TransactionOptions;
+  }[], commonOptions?: TransactionOptions) => MaybePromise<{
+    key: string;
+    value: StorageValue;
+  }[]>;
+  /** @experimental */
+  getItemRaw?: (key: string, opts: TransactionOptions) => MaybePromise<unknown>;
+  setItem?: (key: string, value: string, opts: TransactionOptions) => MaybePromise<void>;
+  /** @experimental */
+  setItems?: (items: {
+    key: string;
+    value: string;
+    options?: TransactionOptions;
+  }[], commonOptions?: TransactionOptions) => MaybePromise<void>;
+  /** @experimental */
+  setItemRaw?: (key: string, value: any, opts: TransactionOptions) => MaybePromise<void>;
+  removeItem?: (key: string, opts: TransactionOptions) => MaybePromise<void>;
+  getMeta?: (key: string, opts: TransactionOptions) => MaybePromise<StorageMeta | null>;
+  getKeys: (base: string, opts: GetKeysOptions) => MaybePromise<string[]>;
+  clear?: (base: string, opts: TransactionOptions) => MaybePromise<void>;
+  dispose?: () => MaybePromise<void>;
+  watch?: (callback: WatchCallback) => MaybePromise<Unwatch>;
+}
+type StorageDefinition = {
+  items: unknown;
+  [key: string]: unknown;
+};
+type StorageItemMap<T> = T extends StorageDefinition ? T["items"] : T;
+type StorageItemType<T, K> = K extends keyof StorageItemMap<T> ? StorageItemMap<T>[K] : T extends StorageDefinition ? StorageValue : T;
+interface Storage<T extends StorageValue = StorageValue> {
+  hasItem<U extends Extract<T, StorageDefinition>, K extends keyof StorageItemMap<U>>(key: K, opts?: TransactionOptions): Promise<boolean>;
+  hasItem(key: string, opts?: TransactionOptions): Promise<boolean>;
+  getItem<U extends Extract<T, StorageDefinition>, K extends string & keyof StorageItemMap<U>>(key: K, ops?: TransactionOptions): Promise<StorageItemType<T, K> | null>;
+  getItem<R = StorageItemType<T, string>>(key: string, opts?: TransactionOptions): Promise<R | null>;
+  /** @experimental */
+  getItems: <U extends T>(items: (string | {
+    key: string;
+    options?: TransactionOptions;
+  })[], commonOptions?: TransactionOptions) => Promise<{
+    key: string;
+    value: U;
+  }[]>;
+  /** @experimental See https://github.com/unjs/unstorage/issues/142 */
+  getItemRaw: <T = any>(key: string, opts?: TransactionOptions) => Promise<MaybeDefined<T> | null>;
+  setItem<U extends Extract<T, StorageDefinition>, K extends keyof StorageItemMap<U>>(key: K, value: StorageItemType<T, K>, opts?: TransactionOptions): Promise<void>;
+  setItem<U extends T>(key: string, value: U, opts?: TransactionOptions): Promise<void>;
+  /** @experimental */
+  setItems: <U extends T>(items: {
+    key: string;
+    value: U;
+    options?: TransactionOptions;
+  }[], commonOptions?: TransactionOptions) => Promise<void>;
+  /** @experimental See https://github.com/unjs/unstorage/issues/142 */
+  setItemRaw: <T = any>(key: string, value: MaybeDefined<T>, opts?: TransactionOptions) => Promise<void>;
+  removeItem<U extends Extract<T, StorageDefinition>, K extends keyof StorageItemMap<U>>(key: K, opts?: (TransactionOptions & {
+    removeMeta?: boolean;
+  }) | boolean): Promise<void>;
+  removeItem(key: string, opts?: (TransactionOptions & {
+    removeMeta?: boolean;
+  }) | boolean): Promise<void>;
+  getMeta: (key: string, opts?: (TransactionOptions & {
+    nativeOnly?: boolean;
+  }) | boolean) => MaybePromise<StorageMeta>;
+  setMeta: (key: string, value: StorageMeta, opts?: TransactionOptions) => Promise<void>;
+  removeMeta: (key: string, opts?: TransactionOptions) => Promise<void>;
+  getKeys: (base?: string, opts?: GetKeysOptions) => Promise<string[]>;
+  clear: (base?: string, opts?: TransactionOptions) => Promise<void>;
+  dispose: () => Promise<void>;
+  watch: (callback: WatchCallback) => Promise<Unwatch>;
+  unwatch: () => Promise<void>;
+  mount: (base: string, driver: Driver) => Storage;
+  unmount: (base: string, dispose?: boolean) => Promise<void>;
+  getMount: (key?: string) => {
+    base: string;
+    driver: Driver;
+  };
+  getMounts: (base?: string, options?: {
+    parents?: boolean;
+  }) => {
+    base: string;
+    driver: Driver;
+  }[];
+  keys: Storage["getKeys"];
+  get: Storage<T>["getItem"];
+  set: Storage<T>["setItem"];
+  has: Storage<T>["hasItem"];
+  del: Storage<T>["removeItem"];
+  remove: Storage<T>["removeItem"];
+}
+//#endregion
+//#region src/core/utils.d.ts
+/**
+* Resolve the module path relative to the plugin to an absolute path
+* Handles cross-platform paths (Windows, macOS, Linux) and proper escaping for imports
+* @param importMetaUrl - Pass in import.meta.url
+* @param relativePath - Path relative to the plugin
+* @example
+* ```ts
+* import { resolveModule } from 'unplugin-devpilot/core/utils'
+*
+* const skillPath = resolveModule(import.meta.url, './skill.md')
+* ```
+*/
+declare function resolveModule(importMetaUrl: string, relativePath: string): string;
+//#endregion
 //#region ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v3/helpers/typeAliases.d.cts
 type Primitive$2 = string | number | symbol | bigint | boolean | null | undefined;
 //#endregion
@@ -4108,6 +4244,7 @@ declare function defineMcpToolRegister<OutputArgs extends ZodRawShapeCompat | An
 //#region src/core/plugin/index.d.ts
 interface DevpilotPluginContext {
   wsPort: number;
+  storage: Storage;
 }
 /**
 * Resolve the module path relative to the plugin to an absolute path
@@ -4128,4 +4265,4 @@ interface DevpilotPluginContext {
 */
 declare function resolveClientModule(importMetaUrl: string, relativePath: string): string;
 //#endregion
-export { defineMcpToolRegister as i, resolveClientModule as n, McpToolRegister as r, DevpilotPluginContext as t };
+export { type resolveModule as a, defineMcpToolRegister as i, resolveClientModule as n, Storage as o, McpToolRegister as r, StorageValue as s, DevpilotPluginContext as t };

package/dist/{index-CQudsm6j.d.mts → index-DMYihCqJ.d.mts}

@@ -1,4 +1,4 @@
-import { r as McpToolRegister, t as DevpilotPluginContext } from "./index-9V3dRAxA.mjs";
+import { o as Storage, r as McpToolRegister, s as StorageValue, t as DevpilotPluginContext } from "./index-B3RgT4Na.mjs";
 import { UnpluginInstance } from "unplugin";
 import { WebSocket } from "ws";
 
@@ -25,11 +25,40 @@ interface DevpilotPlugin {
   */
   serverSetup?: (ctx: DevpilotPluginContext) => Record<string, (...args: any[]) => any>;
   mcpSetup?: (ctx: DevpilotPluginContext) => Array<McpToolRegister>;
+  /**
+  * The skill module path to be injected
+  * - npm package path: 'my-plugin/skill'
+  * - absolute path: '/path/to/skill.md'
+  *
+  * Note: relative paths need to be resolved to absolute paths first
+  * @example
+  * ```ts
+  * import { resolveSkillModule } from 'unplugin-devpilot'
+  *
+  * skillModule: resolveSkillModule(import.meta.url, './skill.md')
+  * ```
+  */
+  skillModule?: string | ((ctx: DevpilotPluginContext) => string);
 }
 interface Options {
   wsPort?: number;
   mcpPort?: number;
   plugins?: DevpilotPlugin[];
+  /**
+  * The paths to generate the core skill files
+  * - directory path: './.github/skills/devpilot' (will generate SKILL.md in this directory)
+  * - file path: './.github/skills/devpilot/SKILL.md' (will generate the specified file)
+  *
+  * If not specified, no core skill file will be generated
+  * @example
+  * ```ts
+  * Devpilot({
+  *   skillPaths: ['./.github/skills/devpilot', './.cursor/skills/devpilot'],
+  *   plugins: [],
+  * })
+  * ```
+  */
+  skillPaths?: string[];
 }
 //#endregion
 //#region ../../node_modules/.pnpm/birpc@4.0.0/node_modules/birpc/dist/index.d.mts
@@ -159,6 +188,12 @@ interface PendingTask {
 interface BaseServerFunctions {
   ping: () => string;
   updateClientInfo: (info: Omit<ClientInfo, "clientId" | "connectedAt" | "lastActiveAt">) => void;
+  storageGetItem: (namespace: string, key: string) => Promise<any>;
+  storageSetItem: (namespace: string, key: string, value: any) => Promise<void>;
+  storageRemoveItem: (namespace: string, key: string) => Promise<void>;
+  storageGetKeys: (namespace: string, base?: string) => Promise<string[]>;
+  storageHasItem: (namespace: string, key: string) => Promise<boolean>;
+  storageClear: (namespace: string, base?: string) => Promise<void>;
 }
 interface PluginServerFunctions {}
 type ServerFunctions = BaseServerFunctions & PluginServerFunctions;
@@ -222,7 +257,31 @@ declare class ClientManager {
 }
 declare const clientManager: ClientManager;
 //#endregion
+//#region src/core/skill-generator.d.ts
+/**
+* Resolve the skill module path relative to the plugin to an absolute path
+* Handles cross-platform paths (Windows, macOS, Linux) and proper escaping for imports
+* @param importMetaUrl - Pass in import.meta.url
+* @param relativePath - Path relative to the plugin
+* @example
+* ```ts
+* import { resolveSkillModule } from 'unplugin-devpilot'
+*
+* export function myPlugin(): DevpilotPlugin {
+*   return {
+*     namespace: 'my-plugin',
+*     skillModule: resolveSkillModule(import.meta.url, './skill.md'),
+*   }
+* }
+* ```
+*/
+declare function resolveSkillModule(importMetaUrl: string, relativePath: string): string;
+//#endregion
+//#region src/core/storage.d.ts
+declare const storage: Storage<StorageValue>;
+declare function getPluginStorage(namespace: string): Storage<StorageValue>;
+//#endregion
 //#region src/index.d.ts
 declare const unpluginDevpilot: UnpluginInstance<Options | undefined, false>;
 //#endregion
-export { ClientDiscoveryFilter as a, PendingTask as c, ServerFunctions as d, TaskHistory as f, BaseServerFunctions as i, PluginClientFunctions as l, Options as m, clientManager as n, ClientFunctions as o, DevpilotPlugin as p, BaseClientFunctions as r, ClientInfo as s, unpluginDevpilot as t, PluginServerFunctions as u };
+export { Options as _, clientManager as a, ClientDiscoveryFilter as c, PendingTask as d, PluginClientFunctions as f, DevpilotPlugin as g, TaskHistory as h, resolveSkillModule as i, ClientFunctions as l, ServerFunctions as m, getPluginStorage as n, BaseClientFunctions as o, PluginServerFunctions as p, storage as r, BaseServerFunctions as s, unpluginDevpilot as t, ClientInfo as u };

package/dist/index.d.mts

@@ -1,3 +1,3 @@
-import { i as defineMcpToolRegister, n as resolveClientModule, t as DevpilotPluginContext } from "./index-9V3dRAxA.mjs";
-import { a as ClientDiscoveryFilter, c as PendingTask, d as ServerFunctions, f as TaskHistory, i as BaseServerFunctions, l as PluginClientFunctions, m as Options, n as clientManager, o as ClientFunctions, p as DevpilotPlugin, r as BaseClientFunctions, s as ClientInfo, t as unpluginDevpilot, u as PluginServerFunctions } from "./index-CQudsm6j.mjs";
-export { BaseClientFunctions, BaseServerFunctions, ClientDiscoveryFilter, ClientFunctions, ClientInfo, DevpilotPlugin, DevpilotPluginContext, Options, PendingTask, PluginClientFunctions, PluginServerFunctions, ServerFunctions, TaskHistory, clientManager, unpluginDevpilot as default, unpluginDevpilot, defineMcpToolRegister, resolveClientModule };
+import { a as resolveModule, i as defineMcpToolRegister, n as resolveClientModule, t as DevpilotPluginContext } from "./index-B3RgT4Na.mjs";
+import { _ as Options, a as clientManager, c as ClientDiscoveryFilter, d as PendingTask, f as PluginClientFunctions, g as DevpilotPlugin, h as TaskHistory, i as resolveSkillModule, l as ClientFunctions, m as ServerFunctions, n as getPluginStorage, o as BaseClientFunctions, p as PluginServerFunctions, r as storage, s as BaseServerFunctions, t as unpluginDevpilot, u as ClientInfo } from "./index-DMYihCqJ.mjs";
+export { BaseClientFunctions, BaseServerFunctions, ClientDiscoveryFilter, ClientFunctions, ClientInfo, DevpilotPlugin, DevpilotPluginContext, Options, PendingTask, PluginClientFunctions, PluginServerFunctions, ServerFunctions, TaskHistory, clientManager, unpluginDevpilot as default, unpluginDevpilot, defineMcpToolRegister, getPluginStorage, resolveClientModule, resolveModule, resolveSkillModule, storage };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { n as unpluginDevpilot, r as clientManager, t as src_default } from "./src-Bm2tOOQC.mjs";
-import { n as defineMcpToolRegister, t as resolveClientModule } from "./plugin-BPkoZQbf.mjs";
+import { a as storage, i as getPluginStorage, n as unpluginDevpilot, o as clientManager, r as resolveSkillModule, t as src_default } from "./src-DkQU5cZx.mjs";
+import { n as defineMcpToolRegister, r as resolveModule, t as resolveClientModule } from "./plugin-B1Afr0m3.mjs";
 
-export { clientManager, src_default as default, defineMcpToolRegister, resolveClientModule, unpluginDevpilot };
+export { clientManager, src_default as default, defineMcpToolRegister, getPluginStorage, resolveClientModule, resolveModule, resolveSkillModule, storage, unpluginDevpilot };

package/dist/{plugin-BPkoZQbf.mjs → plugin-B1Afr0m3.mjs}

@@ -1,6 +1,24 @@
 import { dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
+//#region src/core/utils.ts
+/**
+* Resolve the module path relative to the plugin to an absolute path
+* Handles cross-platform paths (Windows, macOS, Linux) and proper escaping for imports
+* @param importMetaUrl - Pass in import.meta.url
+* @param relativePath - Path relative to the plugin
+* @example
+* ```ts
+* import { resolveModule } from 'unplugin-devpilot/core/utils'
+*
+* const skillPath = resolveModule(import.meta.url, './skill.md')
+* ```
+*/
+function resolveModule(importMetaUrl, relativePath) {
+	return pathToFileURL(join(dirname(fileURLToPath(importMetaUrl)), relativePath)).href;
+}
+
+//#endregion
 //#region src/core/plugin/mcp.ts
 function defineMcpToolRegister(name, config, cb) {
 	return () => ({
@@ -30,8 +48,8 @@ function defineMcpToolRegister(name, config, cb) {
 * ```
 */
 function resolveClientModule(importMetaUrl, relativePath) {
-	return pathToFileURL(join(dirname(fileURLToPath(importMetaUrl)), relativePath)).href;
+	return resolveModule(importMetaUrl, relativePath);
 }
 
 //#endregion
-export { defineMcpToolRegister as n, resolveClientModule as t };
+export { defineMcpToolRegister as n, resolveModule as r, resolveClientModule as t };

package/dist/plugin.d.mts

@@ -1,2 +1,2 @@
-import { i as defineMcpToolRegister, n as resolveClientModule, r as McpToolRegister, t as DevpilotPluginContext } from "./index-9V3dRAxA.mjs";
-export { DevpilotPluginContext, McpToolRegister as McpServerRegister, defineMcpToolRegister, resolveClientModule };
+import { a as resolveModule, i as defineMcpToolRegister, n as resolveClientModule, r as McpToolRegister, t as DevpilotPluginContext } from "./index-B3RgT4Na.mjs";
+export { DevpilotPluginContext, McpToolRegister as McpServerRegister, defineMcpToolRegister, resolveClientModule, resolveModule };

package/dist/plugin.mjs

@@ -1,3 +1,3 @@
-import { n as defineMcpToolRegister, t as resolveClientModule } from "./plugin-BPkoZQbf.mjs";
+import { n as defineMcpToolRegister, r as resolveModule, t as resolveClientModule } from "./plugin-B1Afr0m3.mjs";
 
-export { defineMcpToolRegister, resolveClientModule };
+export { defineMcpToolRegister, resolveClientModule, resolveModule };

package/dist/rspack.d.mts

@@ -1,4 +1,4 @@
-import { t as unpluginDevpilot } from "./index-CQudsm6j.mjs";
+import { t as unpluginDevpilot } from "./index-DMYihCqJ.mjs";
 
 //#region src/rspack.d.ts
 /**

package/dist/rspack.mjs

@@ -1,4 +1,4 @@
-import { n as unpluginDevpilot } from "./src-Bm2tOOQC.mjs";
+import { n as unpluginDevpilot } from "./src-DkQU5cZx.mjs";
 
 //#region src/rspack.ts
 /**