@dexto/agent-management 1.5.5 → 1.5.7

package/dist/plugins/schemas.cjs

@@ -0,0 +1,74 @@
+"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);
+var schemas_exports = {};
+__export(schemas_exports, {
+  DextoPluginManifestSchema: () => DextoPluginManifestSchema,
+  InstalledPluginEntrySchema: () => InstalledPluginEntrySchema,
+  InstalledPluginsFileSchema: () => InstalledPluginsFileSchema,
+  PluginMCPConfigSchema: () => PluginMCPConfigSchema,
+  PluginManifestSchema: () => PluginManifestSchema
+});
+module.exports = __toCommonJS(schemas_exports);
+var import_zod = require("zod");
+const AuthorSchema = import_zod.z.union([
+  import_zod.z.string(),
+  import_zod.z.object({
+    name: import_zod.z.string(),
+    email: import_zod.z.string().optional()
+  })
+]);
+const PluginManifestSchema = import_zod.z.object({
+  name: import_zod.z.string().min(1).describe("Unique plugin name (used for namespacing commands)"),
+  description: import_zod.z.string().optional().describe("Human-readable plugin description"),
+  version: import_zod.z.string().optional().describe("Semantic version (e.g., 1.0.0)"),
+  author: AuthorSchema.optional().describe("Plugin author - string or {name, email} object")
+}).passthrough().describe("Claude Code plugin manifest from .claude-plugin/plugin.json");
+const DextoPluginManifestSchema = import_zod.z.object({
+  name: import_zod.z.string().min(1).describe("Unique plugin name (used for namespacing commands)"),
+  description: import_zod.z.string().optional().describe("Human-readable plugin description"),
+  version: import_zod.z.string().optional().describe("Semantic version (e.g., 1.0.0)"),
+  author: AuthorSchema.optional().describe("Plugin author - string or {name, email} object"),
+  // Dexto-specific extensions
+  customToolProviders: import_zod.z.array(import_zod.z.string()).optional().describe('Custom tool provider types bundled with this plugin (e.g., ["plan-tools"])')
+}).passthrough().describe("Dexto-native plugin manifest from .dexto-plugin/plugin.json");
+const PluginMCPConfigSchema = import_zod.z.object({
+  mcpServers: import_zod.z.record(import_zod.z.unknown()).optional().describe("MCP servers to register")
+}).passthrough().describe("MCP configuration from .mcp.json");
+const InstalledPluginEntrySchema = import_zod.z.object({
+  scope: import_zod.z.enum(["project", "user", "local", "managed"]).describe("Installation scope"),
+  installPath: import_zod.z.string().describe("Absolute path to the installed plugin"),
+  version: import_zod.z.string().optional().describe("Plugin version"),
+  installedAt: import_zod.z.string().optional().describe("ISO timestamp of installation"),
+  lastUpdated: import_zod.z.string().optional().describe("ISO timestamp of last update"),
+  gitCommitSha: import_zod.z.string().optional().describe("Git commit SHA if installed from marketplace"),
+  projectPath: import_zod.z.string().optional().describe("Project path for project-scoped plugins"),
+  isLocal: import_zod.z.boolean().optional().describe("Whether this is a local plugin")
+}).passthrough().describe("Plugin installation entry");
+const InstalledPluginsFileSchema = import_zod.z.object({
+  version: import_zod.z.number().optional().describe("Schema version"),
+  plugins: import_zod.z.record(import_zod.z.array(InstalledPluginEntrySchema)).describe("Map of plugin identifiers to installation entries")
+}).passthrough().describe("Claude Code installed plugins manifest");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DextoPluginManifestSchema,
+  InstalledPluginEntrySchema,
+  InstalledPluginsFileSchema,
+  PluginMCPConfigSchema,
+  PluginManifestSchema
+});

package/dist/plugins/schemas.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Zod schemas for plugin validation
+ *
+ * Supports two plugin formats:
+ * - .claude-plugin/plugin.json: Claude Code compatible format
+ * - .dexto-plugin/plugin.json: Dexto-native format with extended features
+ */
+import { z } from 'zod';
+/**
+ * Schema for Claude Code plugin.json manifest
+ * Uses passthrough to allow unknown fields from Claude Code plugins
+ */
+export declare const PluginManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        email?: string | undefined;
+    }, {
+        name: string;
+        email?: string | undefined;
+    }>]>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        email?: string | undefined;
+    }, {
+        name: string;
+        email?: string | undefined;
+    }>]>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        email?: string | undefined;
+    }, {
+        name: string;
+        email?: string | undefined;
+    }>]>>;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * Schema for Dexto-native plugin.json manifest
+ * Extends Claude Code format with Dexto-specific features
+ */
+export declare const DextoPluginManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        email?: string | undefined;
+    }, {
+        name: string;
+        email?: string | undefined;
+    }>]>>;
+    customToolProviders: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        email?: string | undefined;
+    }, {
+        name: string;
+        email?: string | undefined;
+    }>]>>;
+    customToolProviders: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        email?: string | undefined;
+    }, {
+        name: string;
+        email?: string | undefined;
+    }>]>>;
+    customToolProviders: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * Schema for .mcp.json configuration
+ * Uses passthrough to allow unknown MCP server configurations
+ */
+export declare const PluginMCPConfigSchema: z.ZodObject<{
+    mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * Type for validated Claude Code plugin manifest
+ */
+export type ValidatedPluginManifest = z.output<typeof PluginManifestSchema>;
+/**
+ * Type for validated Dexto-native plugin manifest
+ */
+export type ValidatedDextoPluginManifest = z.output<typeof DextoPluginManifestSchema>;
+/**
+ * Type for validated MCP config
+ */
+export type ValidatedPluginMCPConfig = z.output<typeof PluginMCPConfigSchema>;
+/**
+ * Schema for individual plugin installation entry in installed_plugins.json
+ */
+export declare const InstalledPluginEntrySchema: z.ZodObject<{
+    scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+    installPath: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    installedAt: z.ZodOptional<z.ZodString>;
+    lastUpdated: z.ZodOptional<z.ZodString>;
+    gitCommitSha: z.ZodOptional<z.ZodString>;
+    projectPath: z.ZodOptional<z.ZodString>;
+    isLocal: z.ZodOptional<z.ZodBoolean>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+    installPath: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    installedAt: z.ZodOptional<z.ZodString>;
+    lastUpdated: z.ZodOptional<z.ZodString>;
+    gitCommitSha: z.ZodOptional<z.ZodString>;
+    projectPath: z.ZodOptional<z.ZodString>;
+    isLocal: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+    installPath: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    installedAt: z.ZodOptional<z.ZodString>;
+    lastUpdated: z.ZodOptional<z.ZodString>;
+    gitCommitSha: z.ZodOptional<z.ZodString>;
+    projectPath: z.ZodOptional<z.ZodString>;
+    isLocal: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * Schema for ~/.dexto/plugins/installed_plugins.json
+ */
+export declare const InstalledPluginsFileSchema: z.ZodObject<{
+    version: z.ZodOptional<z.ZodNumber>;
+    plugins: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        installPath: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+        lastUpdated: z.ZodOptional<z.ZodString>;
+        gitCommitSha: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodOptional<z.ZodString>;
+        isLocal: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        installPath: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+        lastUpdated: z.ZodOptional<z.ZodString>;
+        gitCommitSha: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodOptional<z.ZodString>;
+        isLocal: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        installPath: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+        lastUpdated: z.ZodOptional<z.ZodString>;
+        gitCommitSha: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodOptional<z.ZodString>;
+        isLocal: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    version: z.ZodOptional<z.ZodNumber>;
+    plugins: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        installPath: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+        lastUpdated: z.ZodOptional<z.ZodString>;
+        gitCommitSha: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodOptional<z.ZodString>;
+        isLocal: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        installPath: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+        lastUpdated: z.ZodOptional<z.ZodString>;
+        gitCommitSha: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodOptional<z.ZodString>;
+        isLocal: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        installPath: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+        lastUpdated: z.ZodOptional<z.ZodString>;
+        gitCommitSha: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodOptional<z.ZodString>;
+        isLocal: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    version: z.ZodOptional<z.ZodNumber>;
+    plugins: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        installPath: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+        lastUpdated: z.ZodOptional<z.ZodString>;
+        gitCommitSha: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodOptional<z.ZodString>;
+        isLocal: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        installPath: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+        lastUpdated: z.ZodOptional<z.ZodString>;
+        gitCommitSha: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodOptional<z.ZodString>;
+        isLocal: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        installPath: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+        lastUpdated: z.ZodOptional<z.ZodString>;
+        gitCommitSha: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodOptional<z.ZodString>;
+        isLocal: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * Type for validated installed plugins file
+ */
+export type ValidatedInstalledPluginsFile = z.output<typeof InstalledPluginsFileSchema>;
+/**
+ * Type for validated installed plugin entry
+ */
+export type ValidatedInstalledPluginEntry = z.output<typeof InstalledPluginEntrySchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/plugins/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/plugins/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAQ2C,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAasC,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;gCAKe,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAeG,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAQgB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAExF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/plugins/schemas.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+const AuthorSchema = z.union([
+  z.string(),
+  z.object({
+    name: z.string(),
+    email: z.string().optional()
+  })
+]);
+const PluginManifestSchema = z.object({
+  name: z.string().min(1).describe("Unique plugin name (used for namespacing commands)"),
+  description: z.string().optional().describe("Human-readable plugin description"),
+  version: z.string().optional().describe("Semantic version (e.g., 1.0.0)"),
+  author: AuthorSchema.optional().describe("Plugin author - string or {name, email} object")
+}).passthrough().describe("Claude Code plugin manifest from .claude-plugin/plugin.json");
+const DextoPluginManifestSchema = z.object({
+  name: z.string().min(1).describe("Unique plugin name (used for namespacing commands)"),
+  description: z.string().optional().describe("Human-readable plugin description"),
+  version: z.string().optional().describe("Semantic version (e.g., 1.0.0)"),
+  author: AuthorSchema.optional().describe("Plugin author - string or {name, email} object"),
+  // Dexto-specific extensions
+  customToolProviders: z.array(z.string()).optional().describe('Custom tool provider types bundled with this plugin (e.g., ["plan-tools"])')
+}).passthrough().describe("Dexto-native plugin manifest from .dexto-plugin/plugin.json");
+const PluginMCPConfigSchema = z.object({
+  mcpServers: z.record(z.unknown()).optional().describe("MCP servers to register")
+}).passthrough().describe("MCP configuration from .mcp.json");
+const InstalledPluginEntrySchema = z.object({
+  scope: z.enum(["project", "user", "local", "managed"]).describe("Installation scope"),
+  installPath: z.string().describe("Absolute path to the installed plugin"),
+  version: z.string().optional().describe("Plugin version"),
+  installedAt: z.string().optional().describe("ISO timestamp of installation"),
+  lastUpdated: z.string().optional().describe("ISO timestamp of last update"),
+  gitCommitSha: z.string().optional().describe("Git commit SHA if installed from marketplace"),
+  projectPath: z.string().optional().describe("Project path for project-scoped plugins"),
+  isLocal: z.boolean().optional().describe("Whether this is a local plugin")
+}).passthrough().describe("Plugin installation entry");
+const InstalledPluginsFileSchema = z.object({
+  version: z.number().optional().describe("Schema version"),
+  plugins: z.record(z.array(InstalledPluginEntrySchema)).describe("Map of plugin identifiers to installation entries")
+}).passthrough().describe("Claude Code installed plugins manifest");
+export {
+  DextoPluginManifestSchema,
+  InstalledPluginEntrySchema,
+  InstalledPluginsFileSchema,
+  PluginMCPConfigSchema,
+  PluginManifestSchema
+};

package/dist/plugins/types.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/plugins/types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Claude Code Plugin Loader Types
+ *
+ * Supports loading bundled plugins from community sources (e.g., Vercel skills repo)
+ * with compatible features. Emits warnings for unsupported features (hooks, LSP).
+ *
+ * Plugin Format:
+ * ```
+ * my-plugin/
+ * ├── .claude-plugin/
+ * │   └── plugin.json          # {name, description, version, author?}
+ * ├── commands/*.md            # Commands (→ prompts, user-invocable by default)
+ * ├── skills/* /SKILL.md       # Skills (→ prompts, user-invocable by default)
+ * ├── hooks/hooks.json         # UNSUPPORTED - shell injection
+ * ├── .mcp.json                # MCP servers to merge into config
+ * └── .lsp.json                # UNSUPPORTED - language servers
+ * ```
+ */
+/**
+ * Author can be a string or an object with name/email
+ */
+export type PluginAuthor = string | {
+    name: string;
+    email?: string | undefined;
+};
+/**
+ * Plugin manifest from .claude-plugin/plugin.json
+ */
+export interface PluginManifest {
+    name: string;
+    description?: string | undefined;
+    version?: string | undefined;
+    author?: PluginAuthor | undefined;
+}
+/**
+ * Dexto-native plugin manifest from .dexto-plugin/plugin.json
+ * Extends PluginManifest with Dexto-specific features
+ */
+export interface DextoPluginManifest extends PluginManifest {
+    /** Custom tool provider types bundled with this plugin (e.g., ["plan-tools"]) */
+    customToolProviders?: string[] | undefined;
+}
+/**
+ * Plugin format type
+ */
+export type PluginFormat = 'claude-code' | 'dexto';
+/**
+ * A discovered plugin directory with its manifest
+ */
+export interface DiscoveredPlugin {
+    /** Absolute path to plugin directory */
+    path: string;
+    /** Parsed and validated plugin manifest */
+    manifest: PluginManifest | DextoPluginManifest;
+    /** Source location type */
+    source: 'project' | 'user';
+    /** Plugin format (claude-code or dexto) */
+    format: PluginFormat;
+}
+/**
+ * A command or skill discovered within a plugin
+ */
+export interface PluginCommand {
+    /** Absolute path to .md file */
+    file: string;
+    /** Plugin name for prefixing (namespace) */
+    namespace: string;
+    /** true = from skills/ directory, false = from commands/ directory.
+     *  Note: This is metadata only; both are user-invocable by default. */
+    isSkill: boolean;
+}
+/**
+ * MCP configuration from .mcp.json
+ */
+export interface PluginMCPConfig {
+    mcpServers?: Record<string, unknown> | undefined;
+}
+/**
+ * A fully loaded plugin with all discovered content
+ */
+export interface LoadedPlugin {
+    /** Plugin manifest metadata */
+    manifest: PluginManifest | DextoPluginManifest;
+    /** Plugin format (claude-code or dexto) */
+    format: PluginFormat;
+    /** Discovered commands and skills */
+    commands: PluginCommand[];
+    /** MCP servers to merge into agent config */
+    mcpConfig?: PluginMCPConfig | undefined;
+    /** Custom tool provider types to register (Dexto-native plugins only) */
+    customToolProviders: string[];
+    /** Warnings for unsupported features found */
+    warnings: string[];
+}
+/**
+ * Installation scope for plugins
+ * - user: Installed to ~/.dexto/plugins/<name>/
+ * - project: Installed to <cwd>/.dexto/plugins/<name>/
+ * - local: Registered in-place (no copy)
+ */
+export type PluginInstallScope = 'user' | 'project' | 'local';
+/**
+ * Entry in installed_plugins.json for Dexto's plugin tracking
+ */
+export interface InstalledPluginEntry {
+    /** Installation scope */
+    scope: PluginInstallScope;
+    /** Absolute path to the installed plugin */
+    installPath: string;
+    /** Plugin version from manifest */
+    version?: string | undefined;
+    /** ISO timestamp of installation */
+    installedAt: string;
+    /** ISO timestamp of last update */
+    lastUpdated?: string | undefined;
+    /** Project path for project-scoped plugins */
+    projectPath?: string | undefined;
+    /** Whether this is a local plugin (registered in-place) */
+    isLocal?: boolean | undefined;
+    /** Whether this plugin is imported from Claude Code (not copied, just referenced) */
+    isImported?: boolean | undefined;
+}
+/**
+ * Structure of installed_plugins.json
+ */
+export interface InstalledPluginsFile {
+    /** Schema version for future compatibility */
+    version: number;
+    /** Map of plugin names to installation entries */
+    plugins: Record<string, InstalledPluginEntry[]>;
+}
+/**
+ * Plugin with source tracking for listing
+ */
+export interface ListedPlugin {
+    /** Plugin name from manifest */
+    name: string;
+    /** Plugin description */
+    description?: string | undefined;
+    /** Plugin version */
+    version?: string | undefined;
+    /** Absolute path to plugin directory */
+    path: string;
+    /** Source of plugin discovery (always 'dexto' now) */
+    source: 'dexto';
+    /** Installation scope if installed via Dexto */
+    scope?: PluginInstallScope | undefined;
+    /** ISO timestamp of installation */
+    installedAt?: string | undefined;
+}
+/**
+ * Result of plugin validation
+ */
+export interface PluginValidationResult {
+    /** Whether the plugin is valid */
+    valid: boolean;
+    /** Validated manifest if valid */
+    manifest?: PluginManifest | undefined;
+    /** Validation errors */
+    errors: string[];
+    /** Validation warnings */
+    warnings: string[];
+}
+/**
+ * Result of plugin installation
+ */
+export interface PluginInstallResult {
+    /** Whether installation succeeded */
+    success: boolean;
+    /** Plugin name from manifest */
+    pluginName: string;
+    /** Path where plugin was installed */
+    installPath: string;
+    /** Installation warnings */
+    warnings: string[];
+}
+/**
+ * Result of plugin uninstallation
+ */
+export interface PluginUninstallResult {
+    /** Whether uninstallation succeeded */
+    success: boolean;
+    /** Path that was removed */
+    removedPath?: string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"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"}