@sundaeswap/sprinkles 0.6.0 → 0.7.0

package/dist/esm/Sprinkle/index.js

@@ -6,6 +6,7 @@ import { CborSet, VkeyWitness, TxCBOR } from "@blaze-cardano/core";
 import { selectCancellable, selectWithClear, inputCancellable, inputWithClear, passwordWithClear, confirmCancellable, searchCancellable } from "./prompts.js";
 import colors from "yoctocolors-cjs";
 import { OptionalKind } from "@sinclair/typebox";
+import { Value } from "@sinclair/typebox/value";
 import * as fs from "fs";
 import * as path from "path";
 export * from "@sinclair/typebox";
@@ -19,7 +20,7 @@ import { UserCancelledError } from "./types.js";
 export { NetworkSchema, MultisigScriptModule, MultisigScript, ProviderSettingsSchema, WalletSettingsSchema } from "./schemas.js";
 // Import and re-export type guards
 import { isOptional, isImport, isArray, isBigInt, isLiteral, isObject, isRef, isString, isThis, isTuple, isUnion, isSensitive } from "./type-guards.js";
-export { isOptional, isImport, isArray, isBigInt, isLiteral, isObject, isRef, isString, isThis, isTuple, isUnion, isSensitive, isNull, isNullable, unwrapNullable, hasDefault, getDefault } from "./type-guards.js";
+export { isOptional, isImport, isArray, isBigInt, isBoolean, isInteger, isLiteral, isNumber, isObject, isRef, isString, isThis, isTuple, isUnion, isSensitive, isNull, isNullable, unwrapNullable, hasDefault, getDefault } from "./type-guards.js";
 
 // Import schemas for use in this file
 
@@ -36,6 +37,10 @@ import { countSignatures, getRequiredSigners, getTxBodyHash, formatHash, mergeSi
 // Import menu modules
 import { promptObject, promptArray } from "./menus/index.js";
 import { formatPath } from "./utils/formatting.js";
+
+// Import and re-export action system
+import { ActionRegistry, ActionError, executeAction, detectMode, parseCliArgs, generateActionHelp, generateAppHelp, runCli, runMcp } from "./actions/index.js";
+export { ActionRegistry, ActionError, executeAction, detectMode, parseCliArgs, generateActionHelp, camelToKebab, kebabToCamel, coerceValue, parseArgvWithSchema, generateAppHelp, runCli, typeboxToJsonSchema, coerceMcpInput, getMcpSdk, createMcpServer, runMcp, getBuiltinActions, promptAndExecute } from "./actions/index.js";
 export class Sprinkle {
   constructor(type, storagePath, options) {
     _defineProperty(this, "storagePath", void 0);
@@ -49,9 +54,11 @@ export class Sprinkle {
       createdAt: "",
       updatedAt: ""
     });
+    _defineProperty(this, "actionRegistry", void 0);
     this.type = type;
     this.storagePath = storagePath;
     this.options = options ?? {};
+    this.actionRegistry = new ActionRegistry();
   }
 
   // --- Current Profile Accessor ---
@@ -435,8 +442,15 @@ export class Sprinkle {
         }, {
           title: "Edit settings",
           action: async () => {
-            this.settings = await this.EditStruct(this.type, this.settings);
-            this.saveSettings();
+            try {
+              this.settings = await this.EditStruct(this.type, this.settings);
+              this.saveSettings();
+            } catch (e) {
+              if (e instanceof UserCancelledError) {
+                return; // User cancelled, return to menu
+              }
+              throw e;
+            }
           }
         }, {
           title: "Switch profile",
@@ -562,6 +576,87 @@ export class Sprinkle {
   getDisplaySettings() {
     return maskSensitiveFields(this.settings, this.type);
   }
+
+  // --- Non-interactive profile management (for CLI/MCP actions) ---
+
+  /**
+   * Look up a profile entry by its ID without loading it.
+   * Returns undefined if no profile with the given ID exists.
+   */
+  getProfileById(id) {
+    return this.scanProfiles().find(p => p.id === id);
+  }
+
+  /**
+   * Create a new profile file without interactive prompts.
+   * Does NOT switch the active profile.
+   *
+   * @throws ActionError with code DUPLICATE_PROFILE if a profile with the same name already exists.
+   * @returns The created IProfileEntry
+   */
+  async createProfileNonInteractive(name, description, initialSettings) {
+    const profiles = this.scanProfiles();
+    const nameLower = name.toLowerCase();
+    const duplicate = profiles.find(p => p.meta.name.toLowerCase() === nameLower);
+    if (duplicate) {
+      throw new ActionError(`A profile named "${name}" already exists.`, "DUPLICATE_PROFILE", {
+        existingId: duplicate.id
+      });
+    }
+    const profilesDir = Sprinkle.profilesDir(this.storagePath);
+    if (!fs.existsSync(profilesDir)) {
+      fs.mkdirSync(profilesDir, {
+        recursive: true
+      });
+    }
+    const baseId = Sprinkle.sanitizeProfileId(name);
+    const id = Sprinkle.findAvailableId(profilesDir, baseId);
+    const now = new Date().toISOString();
+    const meta = {
+      name,
+      description,
+      createdAt: now,
+      updatedAt: now
+    };
+    const profileData = {
+      meta,
+      settings: initialSettings ?? {},
+      defaults: {}
+    };
+    fs.writeFileSync(path.join(profilesDir, `${id}.json`), JSON.stringify(profileData, bigIntReplacer, 2), "utf-8");
+    return {
+      id,
+      meta
+    };
+  }
+
+  /**
+   * Delete a profile file by ID.
+   *
+   * @throws ActionError with code PROFILE_NOT_FOUND if no profile with the given ID exists.
+   * @throws ActionError with code CANNOT_DELETE_ONLY_PROFILE if this is the only profile.
+   * @throws ActionError with code CANNOT_DELETE_ACTIVE_PROFILE if this is the currently active profile.
+   */
+  deleteProfileById(id) {
+    const profiles = this.scanProfiles();
+    const profile = profiles.find(p => p.id === id);
+    if (!profile) {
+      throw new ActionError(`Profile "${id}" not found.`, "PROFILE_NOT_FOUND", {
+        id
+      });
+    }
+    if (profiles.length === 1) {
+      throw new ActionError("Cannot delete the only profile.", "CANNOT_DELETE_ONLY_PROFILE", {
+        id
+      });
+    }
+    if (id === this.profileId) {
+      throw new ActionError("Cannot delete the active profile. Switch to a different profile first.", "CANNOT_DELETE_ACTIVE_PROFILE", {
+        id
+      });
+    }
+    fs.unlinkSync(Sprinkle.profilePath(this.storagePath, id));
+  }
   async TxDialog(blaze, tx, opts) {
     let currentTx = tx;
     let expanded = false;
@@ -917,7 +1012,35 @@ export class Sprinkle {
         throw new UserCancelledError();
       }
       const selection = selectionResult;
-      return this._fillInStruct(selection, path, defs);
+      // Determine if the provided default value matches the selected variant.
+      // For discriminated unions (objects with literal fields like `type`), check
+      // if the literal field values in the selected variant match those in `def`.
+      // For non-discriminated unions, fall back to structural matching with Value.Check.
+      let matchedDef = undefined;
+      if (def !== undefined) {
+        if (isObject(selection)) {
+          // Check if all literal fields in the selected variant match def
+          const literalFields = Object.entries(selection.properties ?? {}).filter(([, fieldSchema]) => isLiteral(fieldSchema));
+          if (literalFields.length > 0) {
+            const defRecord = def;
+            const allLiteralsMatch = literalFields.every(([fieldName, fieldSchema]) => defRecord[fieldName] === fieldSchema.const);
+            if (allLiteralsMatch) {
+              matchedDef = def;
+            }
+          } else {
+            // No literal discriminators - use structural check
+            if (Value.Check(selection, def)) {
+              matchedDef = def;
+            }
+          }
+        } else {
+          // Non-object variant - use structural check
+          if (Value.Check(selection, def)) {
+            matchedDef = def;
+          }
+        }
+      }
+      return this._fillInStruct(selection, path, defs, matchedDef);
     }
     if (isString(type)) {
       // Special handling for hot wallet private key - offer generation option
@@ -1076,5 +1199,177 @@ export class Sprinkle {
     }
     return def;
   }
+
+  // --- Action System ---
+
+  /**
+   * Register an action on this Sprinkle instance.
+   * Delegates to the internal ActionRegistry with name and schema validation.
+   */
+  registerAction(action) {
+    this.actionRegistry.register(action);
+  }
+
+  /**
+   * Retrieve a registered action by name.
+   * @returns The action, or undefined if not registered
+   */
+  getAction(name) {
+    return this.actionRegistry.get(name);
+  }
+
+  /**
+   * List all registered actions.
+   */
+  listActions() {
+    return this.actionRegistry.list();
+  }
+
+  /**
+   * List all registered actions grouped by category.
+   * Uncategorized actions are grouped under "default".
+   */
+  listActionsByCategory() {
+    return this.actionRegistry.listByCategory();
+  }
+
+  /**
+   * Execute a registered action by name with raw (unvalidated) input.
+   * Input is validated against the action's inputSchema before execution.
+   *
+   * @throws Error if the action name is not registered
+   */
+  async runAction(name, input) {
+    const action = this.actionRegistry.get(name);
+    if (!action) {
+      throw new Error(`Action "${name}" is not registered. Available actions: ${this.actionRegistry.list().map(a => a.name).join(", ") || "(none)"}`);
+    }
+    const context = {
+      sprinkle: this,
+      settings: this.settings
+    };
+    return executeAction(action, input, context);
+  }
+
+  /**
+   * Non-interactive profile initialization for CLI/MCP modes.
+   * Resolves a profile without any user prompts.
+   *
+   * Resolution order:
+   * 1. If profileName provided, load that profile directly
+   * 2. If exactly one profile exists, auto-select it
+   * 3. If multiple profiles exist and no name given, throw with available names
+   * 4. If no profiles exist, throw instructing user to run in interactive mode
+   */
+  async initNonInteractive(profileName) {
+    await this.migrateIfNeeded();
+    if (profileName) {
+      await this.loadProfile(profileName);
+      return;
+    }
+    const profiles = this.scanProfiles();
+    if (profiles.length === 0) {
+      throw new Error("No profiles found. Run in interactive mode to create one.");
+    }
+    if (profiles.length === 1) {
+      await this.loadProfile(profiles[0].id);
+      return;
+    }
+
+    // Multiple profiles without a --profile flag
+    const names = profiles.map(p => `"${p.id}" (${p.meta.name})`).join(", ");
+    throw new Error(`Multiple profiles found. Specify one with --profile <id>. Available profiles: ${names}`);
+  }
+
+  /**
+   * Static entry point that detects mode and runs accordingly.
+   *
+   * Modes:
+   * - "tui"  -- Interactive TUI menu (requires menu option)
+   * - "cli"  -- CLI action execution (parses argv for action name and args)
+   * - "mcp"  -- MCP protocol mode (not yet implemented)
+   * - "help" -- Print available actions and exit
+   */
+  static async run(opts) {
+    const argv = opts.argv ?? process.argv.slice(2);
+    const mode = detectMode(argv);
+    if (mode === "tui") {
+      if (!opts.menu) {
+        throw new Error("TUI mode requires a menu. Provide a menu option or pass --help to see available actions.");
+      }
+      const sprinkle = await Sprinkle.New(opts.type, opts.storagePath, opts.options);
+      // Register any provided actions
+      for (const action of opts.actions ?? []) {
+        sprinkle.registerAction(action);
+      }
+      await sprinkle.showMenu(opts.menu);
+      return;
+    }
+    if (mode === "help") {
+      const sprinkle = new Sprinkle(opts.type, opts.storagePath, opts.options);
+      for (const action of opts.actions ?? []) {
+        sprinkle.registerAction(action);
+      }
+      console.log(generateAppHelp(sprinkle.listActions()));
+      return;
+    }
+    if (mode === "cli") {
+      const {
+        actionName,
+        args
+      } = parseCliArgs(argv);
+
+      // Extract --profile flag from args if present
+      const profileName = typeof args["profile"] === "string" ? args["profile"] : undefined;
+      const sprinkle = new Sprinkle(opts.type, opts.storagePath, opts.options);
+      for (const action of opts.actions ?? []) {
+        sprinkle.registerAction(action);
+      }
+
+      // Handle action-specific --help BEFORE profile initialization
+      // (help should work without a profile)
+      if (args["help"] === true) {
+        const action = sprinkle.getAction(actionName);
+        if (action) {
+          console.log(generateActionHelp(action));
+        } else {
+          console.log(`Unknown action "${actionName}". Run --help to see available actions.`);
+        }
+        return;
+      }
+      await sprinkle.initNonInteractive(profileName);
+
+      // Remove internal flags from args before passing to action
+      const actionArgs = {
+        ...args
+      };
+      delete actionArgs["profile"];
+      delete actionArgs["help"];
+
+      // Build context and delegate to runCli for proper error routing
+      const context = {
+        sprinkle,
+        settings: sprinkle.settings
+      };
+      await runCli(sprinkle, actionName, actionArgs, context);
+      return;
+    }
+    if (mode === "mcp") {
+      // Derive a server name from the storage path basename, falling back to a
+      // sensible default.
+      const serverName = path.basename(opts.storagePath) || "sprinkle-mcp";
+      const sprinkle = new Sprinkle(opts.type, opts.storagePath, opts.options);
+      for (const action of opts.actions ?? []) {
+        sprinkle.registerAction(action);
+      }
+
+      // Read profile name from environment variable (MCP clients have no
+      // interactive terminal to prompt for profile selection).
+      const profileName = process.env["SPRINKLE_PROFILE"];
+      await sprinkle.initNonInteractive(profileName);
+      await runMcp(sprinkle, serverName);
+      return;
+    }
+  }
 }
 //# sourceMappingURL=index.js.map