@dexto/agent-management 1.5.8 → 1.6.1

package/dist/plugins/schemas.d.ts

@@ -1,9 +1,8 @@
 /**
  * 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
+ * Supports Claude Code compatible plugins:
+ * - .claude-plugin/plugin.json
  */
 import { z } from 'zod';
 /**
@@ -53,56 +52,6 @@ export declare const PluginManifestSchema: z.ZodObject<{
         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
@@ -118,10 +67,6 @@ export declare const PluginMCPConfigSchema: z.ZodObject<{
  * 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
  */
@@ -130,7 +75,7 @@ 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"]>;
+    scope: z.ZodEnum<["project", "user", "local"]>;
     installPath: z.ZodString;
     version: z.ZodOptional<z.ZodString>;
     installedAt: z.ZodOptional<z.ZodString>;
@@ -139,7 +84,7 @@ export declare const InstalledPluginEntrySchema: z.ZodObject<{
     projectPath: z.ZodOptional<z.ZodString>;
     isLocal: z.ZodOptional<z.ZodBoolean>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+    scope: z.ZodEnum<["project", "user", "local"]>;
     installPath: z.ZodString;
     version: z.ZodOptional<z.ZodString>;
     installedAt: z.ZodOptional<z.ZodString>;
@@ -148,7 +93,7 @@ export declare const InstalledPluginEntrySchema: z.ZodObject<{
     projectPath: z.ZodOptional<z.ZodString>;
     isLocal: z.ZodOptional<z.ZodBoolean>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+    scope: z.ZodEnum<["project", "user", "local"]>;
     installPath: z.ZodString;
     version: z.ZodOptional<z.ZodString>;
     installedAt: z.ZodOptional<z.ZodString>;
@@ -163,7 +108,7 @@ export declare const InstalledPluginEntrySchema: z.ZodObject<{
 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"]>;
+        scope: z.ZodEnum<["project", "user", "local"]>;
         installPath: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
         installedAt: z.ZodOptional<z.ZodString>;
@@ -172,7 +117,7 @@ export declare const InstalledPluginsFileSchema: z.ZodObject<{
         projectPath: z.ZodOptional<z.ZodString>;
         isLocal: z.ZodOptional<z.ZodBoolean>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        scope: z.ZodEnum<["project", "user", "local"]>;
         installPath: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
         installedAt: z.ZodOptional<z.ZodString>;
@@ -181,7 +126,7 @@ export declare const InstalledPluginsFileSchema: z.ZodObject<{
         projectPath: z.ZodOptional<z.ZodString>;
         isLocal: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        scope: z.ZodEnum<["project", "user", "local"]>;
         installPath: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
         installedAt: z.ZodOptional<z.ZodString>;
@@ -193,7 +138,7 @@ export declare const InstalledPluginsFileSchema: z.ZodObject<{
 }, "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"]>;
+        scope: z.ZodEnum<["project", "user", "local"]>;
         installPath: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
         installedAt: z.ZodOptional<z.ZodString>;
@@ -202,7 +147,7 @@ export declare const InstalledPluginsFileSchema: z.ZodObject<{
         projectPath: z.ZodOptional<z.ZodString>;
         isLocal: z.ZodOptional<z.ZodBoolean>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        scope: z.ZodEnum<["project", "user", "local"]>;
         installPath: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
         installedAt: z.ZodOptional<z.ZodString>;
@@ -211,7 +156,7 @@ export declare const InstalledPluginsFileSchema: z.ZodObject<{
         projectPath: z.ZodOptional<z.ZodString>;
         isLocal: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        scope: z.ZodEnum<["project", "user", "local"]>;
         installPath: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
         installedAt: z.ZodOptional<z.ZodString>;
@@ -223,7 +168,7 @@ export declare const InstalledPluginsFileSchema: z.ZodObject<{
 }, 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"]>;
+        scope: z.ZodEnum<["project", "user", "local"]>;
         installPath: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
         installedAt: z.ZodOptional<z.ZodString>;
@@ -232,7 +177,7 @@ export declare const InstalledPluginsFileSchema: z.ZodObject<{
         projectPath: z.ZodOptional<z.ZodString>;
         isLocal: z.ZodOptional<z.ZodBoolean>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        scope: z.ZodEnum<["project", "user", "local"]>;
         installPath: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
         installedAt: z.ZodOptional<z.ZodString>;
@@ -241,7 +186,7 @@ export declare const InstalledPluginsFileSchema: z.ZodObject<{
         projectPath: z.ZodOptional<z.ZodString>;
         isLocal: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        scope: z.ZodEnum<["project", "user", "local", "managed"]>;
+        scope: z.ZodEnum<["project", "user", "local"]>;
         installPath: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
         installedAt: z.ZodOptional<z.ZodString>;

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

@@ -1 +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"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/plugins/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAQ2C,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,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

@@ -12,19 +12,11 @@ const PluginManifestSchema = z.object({
   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"),
+  scope: z.enum(["project", "user", "local"]).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"),
@@ -38,7 +30,6 @@ const InstalledPluginsFileSchema = z.object({
   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,

package/dist/plugins/types.d.ts

@@ -32,18 +32,6 @@ export interface PluginManifest {
     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
  */
@@ -51,11 +39,9 @@ export interface DiscoveredPlugin {
     /** Absolute path to plugin directory */
     path: string;
     /** Parsed and validated plugin manifest */
-    manifest: PluginManifest | DextoPluginManifest;
+    manifest: PluginManifest;
     /** Source location type */
     source: 'project' | 'user';
-    /** Plugin format (claude-code or dexto) */
-    format: PluginFormat;
 }
 /**
  * A command or skill discovered within a plugin
@@ -80,15 +66,11 @@ export interface PluginMCPConfig {
  */
 export interface LoadedPlugin {
     /** Plugin manifest metadata */
-    manifest: PluginManifest | DextoPluginManifest;
-    /** Plugin format (claude-code or dexto) */
-    format: PluginFormat;
+    manifest: PluginManifest;
     /** 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[];
 }

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

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

package/dist/plugins/validate-plugin.cjs

@@ -39,29 +39,14 @@ function validatePluginDirectory(pluginPath) {
   const errors = [];
   const warnings = [];
   let manifest;
-  let format;
   const absolutePath = path.isAbsolute(pluginPath) ? pluginPath : path.resolve(pluginPath);
   if (!(0, import_fs.existsSync)(absolutePath)) {
     errors.push(`Directory does not exist: ${absolutePath}`);
     return { valid: false, errors, warnings };
   }
-  const dextoPluginDir = path.join(absolutePath, ".dexto-plugin");
-  const claudePluginDir = path.join(absolutePath, ".claude-plugin");
-  let manifestPath;
-  if ((0, import_fs.existsSync)(dextoPluginDir)) {
-    manifestPath = path.join(dextoPluginDir, "plugin.json");
-    format = "dexto";
-  } else if ((0, import_fs.existsSync)(claudePluginDir)) {
-    manifestPath = path.join(claudePluginDir, "plugin.json");
-    format = "claude-code";
-  } else {
-    errors.push("Missing .dexto-plugin or .claude-plugin directory");
-    return { valid: false, errors, warnings };
-  }
+  const manifestPath = path.join(absolutePath, ".claude-plugin", "plugin.json");
   if (!(0, import_fs.existsSync)(manifestPath)) {
-    errors.push(
-      `Missing ${format === "dexto" ? ".dexto-plugin" : ".claude-plugin"}/plugin.json`
-    );
+    errors.push("Missing .claude-plugin/plugin.json");
     return { valid: false, errors, warnings };
   }
   try {
@@ -75,8 +60,7 @@ function validatePluginDirectory(pluginPath) {
       );
       return { valid: false, errors, warnings };
     }
-    const schema = format === "dexto" ? import_schemas.DextoPluginManifestSchema : import_schemas.PluginManifestSchema;
-    const result = schema.safeParse(parsed);
+    const result = import_schemas.PluginManifestSchema.safeParse(parsed);
     if (!result.success) {
       const issues = result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`);
       errors.push(`Schema validation failed: ${issues.join("; ")}`);
@@ -112,7 +96,6 @@ function validatePluginDirectory(pluginPath) {
   return {
     valid: errors.length === 0,
     manifest,
-    format,
     errors,
     warnings
   };
@@ -143,31 +126,18 @@ function checkDirectoryHasSkills(skillsDir) {
     return false;
   }
 }
-function tryLoadManifest(pluginPath, returnFormat) {
-  const dextoManifestPath = path.join(pluginPath, ".dexto-plugin", "plugin.json");
-  const claudeManifestPath = path.join(pluginPath, ".claude-plugin", "plugin.json");
-  let manifestPath;
-  let format;
-  if ((0, import_fs.existsSync)(dextoManifestPath)) {
-    manifestPath = dextoManifestPath;
-    format = "dexto";
-  } else if ((0, import_fs.existsSync)(claudeManifestPath)) {
-    manifestPath = claudeManifestPath;
-    format = "claude-code";
-  } else {
+function tryLoadManifest(pluginPath) {
+  const manifestPath = path.join(pluginPath, ".claude-plugin", "plugin.json");
+  if (!(0, import_fs.existsSync)(manifestPath)) {
     return null;
   }
   try {
     const content = (0, import_fs.readFileSync)(manifestPath, "utf-8");
     const parsed = JSON.parse(content);
-    const schema = format === "dexto" ? import_schemas.DextoPluginManifestSchema : import_schemas.PluginManifestSchema;
-    const result = schema.safeParse(parsed);
+    const result = import_schemas.PluginManifestSchema.safeParse(parsed);
     if (!result.success) {
       return null;
     }
-    if (returnFormat) {
-      return { manifest: result.data, format };
-    }
     return result.data;
   } catch {
     return null;

package/dist/plugins/validate-plugin.d.ts

@@ -4,24 +4,16 @@
  * Validates plugin directory structure and manifest.
  * Checks for required files, valid JSON, and schema compliance.
  *
- * Supports two plugin formats:
- * - .claude-plugin/plugin.json: Claude Code compatible format
- * - .dexto-plugin/plugin.json: Dexto-native format with extended features (preferred)
+ * Supports Claude Code compatible plugins:
+ * - .claude-plugin/plugin.json
  */
-import type { PluginValidationResult, PluginManifest, DextoPluginManifest, PluginFormat } from './types.js';
-/**
- * Extended validation result with plugin format
- */
-export interface ExtendedPluginValidationResult extends PluginValidationResult {
-    /** Plugin format detected */
-    format?: PluginFormat;
-}
+import type { PluginValidationResult, PluginManifest } from './types.js';
 /**
  * Validates a plugin directory structure and manifest.
  *
  * Checks:
  * 1. Directory exists
- * 2. .dexto-plugin/plugin.json OR .claude-plugin/plugin.json exists (Dexto format preferred)
+ * 2. .claude-plugin/plugin.json exists
  * 3. plugin.json is valid JSON
  * 4. plugin.json matches schema (name is required)
  * 5. At least one command or skill exists (warning if none)
@@ -29,25 +21,15 @@ export interface ExtendedPluginValidationResult extends PluginValidationResult {
  * @param pluginPath Absolute or relative path to plugin directory
  * @returns Validation result with manifest (if valid), errors, and warnings
  */
-export declare function validatePluginDirectory(pluginPath: string): ExtendedPluginValidationResult;
-/**
- * Result of manifest loading with format information
- */
-export interface LoadedManifestResult {
-    manifest: PluginManifest | DextoPluginManifest;
-    format: PluginFormat;
-}
+export declare function validatePluginDirectory(pluginPath: string): PluginValidationResult;
 /**
  * Attempts to load and validate a plugin manifest from a directory.
  * Returns null if the manifest doesn't exist, is invalid JSON, or fails schema validation.
  *
- * Checks for .dexto-plugin first (preferred), then falls back to .claude-plugin.
- *
  * This is a shared utility used by discover-plugins, list-plugins, and import-plugin.
  *
  * @param pluginPath Absolute path to the plugin directory
- * @returns Validated manifest with format or null if not a valid plugin
+ * @returns Validated manifest or null if not a valid plugin
  */
 export declare function tryLoadManifest(pluginPath: string): PluginManifest | null;
-export declare function tryLoadManifest(pluginPath: string, returnFormat: true): LoadedManifestResult | null;
 //# sourceMappingURL=validate-plugin.d.ts.map

package/dist/plugins/validate-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/validate-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EACR,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,sBAAsB;IAC1E,6BAA6B;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,8BAA8B,CAyG1F;AAuCD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,cAAc,GAAG,mBAAmB,CAAC;IAC/C,MAAM,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;AAC3E,wBAAgB,eAAe,CAC3B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,IAAI,GACnB,oBAAoB,GAAG,IAAI,CAAC"}
+{"version":3,"file":"validate-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/validate-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,CAsFlF;AAuCD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAmBzE"}

package/dist/plugins/validate-plugin.js

@@ -1,33 +1,18 @@
 import * as path from "path";
 import { existsSync, readFileSync, readdirSync } from "fs";
-import { PluginManifestSchema, DextoPluginManifestSchema } from "./schemas.js";
+import { PluginManifestSchema } from "./schemas.js";
 function validatePluginDirectory(pluginPath) {
   const errors = [];
   const warnings = [];
   let manifest;
-  let format;
   const absolutePath = path.isAbsolute(pluginPath) ? pluginPath : path.resolve(pluginPath);
   if (!existsSync(absolutePath)) {
     errors.push(`Directory does not exist: ${absolutePath}`);
     return { valid: false, errors, warnings };
   }
-  const dextoPluginDir = path.join(absolutePath, ".dexto-plugin");
-  const claudePluginDir = path.join(absolutePath, ".claude-plugin");
-  let manifestPath;
-  if (existsSync(dextoPluginDir)) {
-    manifestPath = path.join(dextoPluginDir, "plugin.json");
-    format = "dexto";
-  } else if (existsSync(claudePluginDir)) {
-    manifestPath = path.join(claudePluginDir, "plugin.json");
-    format = "claude-code";
-  } else {
-    errors.push("Missing .dexto-plugin or .claude-plugin directory");
-    return { valid: false, errors, warnings };
-  }
+  const manifestPath = path.join(absolutePath, ".claude-plugin", "plugin.json");
   if (!existsSync(manifestPath)) {
-    errors.push(
-      `Missing ${format === "dexto" ? ".dexto-plugin" : ".claude-plugin"}/plugin.json`
-    );
+    errors.push("Missing .claude-plugin/plugin.json");
     return { valid: false, errors, warnings };
   }
   try {
@@ -41,8 +26,7 @@ function validatePluginDirectory(pluginPath) {
       );
       return { valid: false, errors, warnings };
     }
-    const schema = format === "dexto" ? DextoPluginManifestSchema : PluginManifestSchema;
-    const result = schema.safeParse(parsed);
+    const result = PluginManifestSchema.safeParse(parsed);
     if (!result.success) {
       const issues = result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`);
       errors.push(`Schema validation failed: ${issues.join("; ")}`);
@@ -78,7 +62,6 @@ function validatePluginDirectory(pluginPath) {
   return {
     valid: errors.length === 0,
     manifest,
-    format,
     errors,
     warnings
   };
@@ -109,31 +92,18 @@ function checkDirectoryHasSkills(skillsDir) {
     return false;
   }
 }
-function tryLoadManifest(pluginPath, returnFormat) {
-  const dextoManifestPath = path.join(pluginPath, ".dexto-plugin", "plugin.json");
-  const claudeManifestPath = path.join(pluginPath, ".claude-plugin", "plugin.json");
-  let manifestPath;
-  let format;
-  if (existsSync(dextoManifestPath)) {
-    manifestPath = dextoManifestPath;
-    format = "dexto";
-  } else if (existsSync(claudeManifestPath)) {
-    manifestPath = claudeManifestPath;
-    format = "claude-code";
-  } else {
+function tryLoadManifest(pluginPath) {
+  const manifestPath = path.join(pluginPath, ".claude-plugin", "plugin.json");
+  if (!existsSync(manifestPath)) {
     return null;
   }
   try {
     const content = readFileSync(manifestPath, "utf-8");
     const parsed = JSON.parse(content);
-    const schema = format === "dexto" ? DextoPluginManifestSchema : PluginManifestSchema;
-    const result = schema.safeParse(parsed);
+    const result = PluginManifestSchema.safeParse(parsed);
     if (!result.success) {
       return null;
     }
-    if (returnFormat) {
-      return { manifest: result.data, format };
-    }
     return result.data;
   } catch {
     return null;

package/dist/preferences/loader.cjs

@@ -79,11 +79,22 @@ const PREFERENCES_FILE_HEADER = `# Dexto Global Preferences
 # Documentation: https://dexto.dev/docs/configuration/preferences
 #
 # Sound Notifications:
-#   Dexto plays sounds for approval requests and task completion.
-#   To customize sounds, place audio files in ~/.dexto/sounds/:
-#     - approval.wav (or .mp3, .ogg, .aiff, .m4a) - played when tool approval is needed
-#     - complete.wav (or .mp3, .ogg, .aiff, .m4a) - played when agent finishes a task
-#   Set sounds.enabled: false to disable all sounds.
+#   Dexto plays sounds for CLI startup, approval requests, and task completion.
+#   Configure which events play sounds:
+#     sounds.enabled: true|false
+#     sounds.onStartup: true|false
+#     sounds.onApprovalRequired: true|false
+#     sounds.onTaskComplete: true|false
+#
+#   Select sound files (paths are relative to ~/.dexto/sounds):
+#     sounds.startupSoundFile: builtins/startup.wav
+#     sounds.approvalSoundFile: builtins/coin.wav
+#     sounds.completeSoundFile: builtins/success.wav
+#
+#   Tip: Use the /sounds overlay to preview and pick sounds.
+#
+#   To use custom sounds, copy files into ~/.dexto/sounds/ (subfolders ok) and set the *SoundFile
+#   keys to a relative path. Supported audio formats vary by OS (Windows reliably supports .wav).
 
 `;
 const AGENT_PREFERENCES_FILE_HEADER = `# Dexto Agent Preferences
@@ -238,8 +249,12 @@ function createInitialPreferences(options) {
     },
     sounds: {
       enabled: options.sounds?.enabled ?? true,
+      onStartup: options.sounds?.onStartup ?? false,
+      ...options.sounds?.startupSoundFile ? { startupSoundFile: options.sounds.startupSoundFile } : {},
       onApprovalRequired: options.sounds?.onApprovalRequired ?? true,
-      onTaskComplete: options.sounds?.onTaskComplete ?? true
+      ...options.sounds?.approvalSoundFile ? { approvalSoundFile: options.sounds.approvalSoundFile } : {},
+      onTaskComplete: options.sounds?.onTaskComplete ?? true,
+      ...options.sounds?.completeSoundFile ? { completeSoundFile: options.sounds.completeSoundFile } : {}
     }
   };
 }

package/dist/preferences/loader.d.ts

@@ -64,8 +64,12 @@ export interface CreatePreferencesOptions {
     /** Sound notification preferences */
     sounds?: {
         enabled?: boolean;
+        onStartup?: boolean;
+        startupSoundFile?: string;
         onApprovalRequired?: boolean;
+        approvalSoundFile?: string;
         onTaskComplete?: boolean;
+        completeSoundFile?: string;
     };
 }
 /**

package/dist/preferences/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/preferences/loader.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAGH,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACzB,MAAM,cAAc,CAAC;AAItB;;;;;GAKG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA+BxE;AA2BD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB/D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4BrF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACtC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,gBAAgB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAgB3B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCzF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qCAAqC;IACrC,MAAM,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC;CACL;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAsC7F;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACnC,GAAG,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,iBAAiB,CAAC,CA4B5B"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/preferences/loader.ts"],"names":[],"mappings":"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"}

package/dist/preferences/loader.js

@@ -39,11 +39,22 @@ const PREFERENCES_FILE_HEADER = `# Dexto Global Preferences
 # Documentation: https://dexto.dev/docs/configuration/preferences
 #
 # Sound Notifications:
-#   Dexto plays sounds for approval requests and task completion.
-#   To customize sounds, place audio files in ~/.dexto/sounds/:
-#     - approval.wav (or .mp3, .ogg, .aiff, .m4a) - played when tool approval is needed
-#     - complete.wav (or .mp3, .ogg, .aiff, .m4a) - played when agent finishes a task
-#   Set sounds.enabled: false to disable all sounds.
+#   Dexto plays sounds for CLI startup, approval requests, and task completion.
+#   Configure which events play sounds:
+#     sounds.enabled: true|false
+#     sounds.onStartup: true|false
+#     sounds.onApprovalRequired: true|false
+#     sounds.onTaskComplete: true|false
+#
+#   Select sound files (paths are relative to ~/.dexto/sounds):
+#     sounds.startupSoundFile: builtins/startup.wav
+#     sounds.approvalSoundFile: builtins/coin.wav
+#     sounds.completeSoundFile: builtins/success.wav
+#
+#   Tip: Use the /sounds overlay to preview and pick sounds.
+#
+#   To use custom sounds, copy files into ~/.dexto/sounds/ (subfolders ok) and set the *SoundFile
+#   keys to a relative path. Supported audio formats vary by OS (Windows reliably supports .wav).
 
 `;
 const AGENT_PREFERENCES_FILE_HEADER = `# Dexto Agent Preferences
@@ -198,8 +209,12 @@ function createInitialPreferences(options) {
     },
     sounds: {
       enabled: options.sounds?.enabled ?? true,
+      onStartup: options.sounds?.onStartup ?? false,
+      ...options.sounds?.startupSoundFile ? { startupSoundFile: options.sounds.startupSoundFile } : {},
       onApprovalRequired: options.sounds?.onApprovalRequired ?? true,
-      onTaskComplete: options.sounds?.onTaskComplete ?? true
+      ...options.sounds?.approvalSoundFile ? { approvalSoundFile: options.sounds.approvalSoundFile } : {},
+      onTaskComplete: options.sounds?.onTaskComplete ?? true,
+      ...options.sounds?.completeSoundFile ? { completeSoundFile: options.sounds.completeSoundFile } : {}
     }
   };
 }