@sundaeswap/sprinkles 0.6.1 → 0.8.0

package/dist/cjs/Sprinkle/index.js

@@ -9,13 +9,18 @@ var _exportNames = {
   NetworkSchema: true,
   MultisigScriptModule: true,
   MultisigScript: true,
+  NativeScriptInputSchema: true,
+  NativeScriptsParam: true,
   ProviderSettingsSchema: true,
   WalletSettingsSchema: true,
   isOptional: true,
   isImport: true,
   isArray: true,
   isBigInt: true,
+  isBoolean: true,
+  isInteger: true,
   isLiteral: true,
+  isNumber: true,
   isObject: true,
   isRef: true,
   isString: true,
@@ -30,8 +35,39 @@ var _exportNames = {
   getDefault: true,
   GetProvider: true,
   GetWallet: true,
-  GetBlaze: true
+  GetBlaze: true,
+  ActionRegistry: true,
+  ActionError: true,
+  executeAction: true,
+  detectMode: true,
+  parseCliArgs: true,
+  generateActionHelp: true,
+  camelToKebab: true,
+  kebabToCamel: true,
+  coerceValue: true,
+  parseArgvWithSchema: true,
+  generateAppHelp: true,
+  runCli: true,
+  typeboxToJsonSchema: true,
+  coerceMcpInput: true,
+  getMcpSdk: true,
+  createMcpServer: true,
+  runMcp: true,
+  getBuiltinActions: true,
+  promptAndExecute: true
 };
+Object.defineProperty(exports, "ActionError", {
+  enumerable: true,
+  get: function () {
+    return _index2.ActionError;
+  }
+});
+Object.defineProperty(exports, "ActionRegistry", {
+  enumerable: true,
+  get: function () {
+    return _index2.ActionRegistry;
+  }
+});
 Object.defineProperty(exports, "GetBlaze", {
   enumerable: true,
   get: function () {
@@ -62,6 +98,18 @@ Object.defineProperty(exports, "MultisigScriptModule", {
     return _schemas.MultisigScriptModule;
   }
 });
+Object.defineProperty(exports, "NativeScriptInputSchema", {
+  enumerable: true,
+  get: function () {
+    return _schemas.NativeScriptInputSchema;
+  }
+});
+Object.defineProperty(exports, "NativeScriptsParam", {
+  enumerable: true,
+  get: function () {
+    return _schemas.NativeScriptsParam;
+  }
+});
 Object.defineProperty(exports, "NetworkSchema", {
   enumerable: true,
   get: function () {
@@ -87,12 +135,72 @@ Object.defineProperty(exports, "WalletSettingsSchema", {
     return _schemas.WalletSettingsSchema;
   }
 });
+Object.defineProperty(exports, "camelToKebab", {
+  enumerable: true,
+  get: function () {
+    return _index2.camelToKebab;
+  }
+});
+Object.defineProperty(exports, "coerceMcpInput", {
+  enumerable: true,
+  get: function () {
+    return _index2.coerceMcpInput;
+  }
+});
+Object.defineProperty(exports, "coerceValue", {
+  enumerable: true,
+  get: function () {
+    return _index2.coerceValue;
+  }
+});
+Object.defineProperty(exports, "createMcpServer", {
+  enumerable: true,
+  get: function () {
+    return _index2.createMcpServer;
+  }
+});
+Object.defineProperty(exports, "detectMode", {
+  enumerable: true,
+  get: function () {
+    return _index2.detectMode;
+  }
+});
+Object.defineProperty(exports, "executeAction", {
+  enumerable: true,
+  get: function () {
+    return _index2.executeAction;
+  }
+});
+Object.defineProperty(exports, "generateActionHelp", {
+  enumerable: true,
+  get: function () {
+    return _index2.generateActionHelp;
+  }
+});
+Object.defineProperty(exports, "generateAppHelp", {
+  enumerable: true,
+  get: function () {
+    return _index2.generateAppHelp;
+  }
+});
+Object.defineProperty(exports, "getBuiltinActions", {
+  enumerable: true,
+  get: function () {
+    return _index2.getBuiltinActions;
+  }
+});
 Object.defineProperty(exports, "getDefault", {
   enumerable: true,
   get: function () {
     return _typeGuards.getDefault;
   }
 });
+Object.defineProperty(exports, "getMcpSdk", {
+  enumerable: true,
+  get: function () {
+    return _index2.getMcpSdk;
+  }
+});
 Object.defineProperty(exports, "hasDefault", {
   enumerable: true,
   get: function () {
@@ -111,12 +219,24 @@ Object.defineProperty(exports, "isBigInt", {
     return _typeGuards.isBigInt;
   }
 });
+Object.defineProperty(exports, "isBoolean", {
+  enumerable: true,
+  get: function () {
+    return _typeGuards.isBoolean;
+  }
+});
 Object.defineProperty(exports, "isImport", {
   enumerable: true,
   get: function () {
     return _typeGuards.isImport;
   }
 });
+Object.defineProperty(exports, "isInteger", {
+  enumerable: true,
+  get: function () {
+    return _typeGuards.isInteger;
+  }
+});
 Object.defineProperty(exports, "isLiteral", {
   enumerable: true,
   get: function () {
@@ -135,6 +255,12 @@ Object.defineProperty(exports, "isNullable", {
     return _typeGuards.isNullable;
   }
 });
+Object.defineProperty(exports, "isNumber", {
+  enumerable: true,
+  get: function () {
+    return _typeGuards.isNumber;
+  }
+});
 Object.defineProperty(exports, "isObject", {
   enumerable: true,
   get: function () {
@@ -183,6 +309,48 @@ Object.defineProperty(exports, "isUnion", {
     return _typeGuards.isUnion;
   }
 });
+Object.defineProperty(exports, "kebabToCamel", {
+  enumerable: true,
+  get: function () {
+    return _index2.kebabToCamel;
+  }
+});
+Object.defineProperty(exports, "parseArgvWithSchema", {
+  enumerable: true,
+  get: function () {
+    return _index2.parseArgvWithSchema;
+  }
+});
+Object.defineProperty(exports, "parseCliArgs", {
+  enumerable: true,
+  get: function () {
+    return _index2.parseCliArgs;
+  }
+});
+Object.defineProperty(exports, "promptAndExecute", {
+  enumerable: true,
+  get: function () {
+    return _index2.promptAndExecute;
+  }
+});
+Object.defineProperty(exports, "runCli", {
+  enumerable: true,
+  get: function () {
+    return _index2.runCli;
+  }
+});
+Object.defineProperty(exports, "runMcp", {
+  enumerable: true,
+  get: function () {
+    return _index2.runMcp;
+  }
+});
+Object.defineProperty(exports, "typeboxToJsonSchema", {
+  enumerable: true,
+  get: function () {
+    return _index2.typeboxToJsonSchema;
+  }
+});
 Object.defineProperty(exports, "unwrapNullable", {
   enumerable: true,
   get: function () {
@@ -216,6 +384,8 @@ var _encryption = require("./encryption.js");
 var _txDialog = require("./tx-dialog.js");
 var _index = require("./menus/index.js");
 var _formatting = require("./utils/formatting.js");
+var _index2 = require("./actions/index.js");
+var _utilityActions = require("./actions/builtin/utility-actions.js");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
@@ -228,12 +398,14 @@ function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e =
 // Import encryption utilities
 // Import tx-dialog utilities
 // Import menu modules
+// Import and re-export action system
 class Sprinkle {
   constructor(type, storagePath, options) {
     _defineProperty(this, "storagePath", void 0);
     _defineProperty(this, "settings", {});
     _defineProperty(this, "type", void 0);
     _defineProperty(this, "defaults", {});
+    _defineProperty(this, "addressbook", {});
     _defineProperty(this, "options", void 0);
     _defineProperty(this, "profileId", "");
     _defineProperty(this, "profileMeta", {
@@ -241,9 +413,11 @@ class Sprinkle {
       createdAt: "",
       updatedAt: ""
     });
+    _defineProperty(this, "actionRegistry", void 0);
     this.type = type;
     this.storagePath = storagePath;
     this.options = options ?? {};
+    this.actionRegistry = new _index2.ActionRegistry();
   }
 
   // --- Current Profile Accessor ---
@@ -314,6 +488,7 @@ class Sprinkle {
     this.profileMeta = parsed.meta;
     this.settings = await this.decryptSettings(parsed.settings);
     this.defaults = parsed.defaults ?? {};
+    this.addressbook = parsed.addressbook ?? {};
     // Update active profile pointer
     fs.writeFileSync(Sprinkle.activeProfilePath(this.storagePath), id, "utf-8");
   }
@@ -333,7 +508,8 @@ class Sprinkle {
     const jsonContent = JSON.stringify({
       meta: this.profileMeta,
       settings: settingsToSave,
-      defaults: this.defaults
+      defaults: this.defaults,
+      addressbook: this.addressbook
     }, _encryption.bigIntReplacer, 2);
     fs.writeFileSync(filePath, jsonContent, "utf-8");
   }
@@ -410,7 +586,8 @@ class Sprinkle {
             updatedAt: now
           },
           settings: parsed.settings,
-          defaults: parsed.defaults ?? {}
+          defaults: parsed.defaults ?? {},
+          addressbook: parsed.addressbook ?? {}
         };
         fs.mkdirSync(profilesDir, {
           recursive: true
@@ -485,7 +662,8 @@ class Sprinkle {
         updatedAt: now
       },
       settings: settingsToSave,
-      defaults: this.defaults
+      defaults: this.defaults,
+      addressbook: this.addressbook
     }, _encryption.bigIntReplacer, 2);
     fs.writeFileSync(path.join(profilesDir, `${id}.json`), jsonContent, "utf-8");
     console.log(`Profile "${name}" created as a copy.`);
@@ -579,6 +757,10 @@ class Sprinkle {
         value: -1
       });
     } else {
+      choices.push({
+        name: "Utilities",
+        value: -6
+      });
       choices.push({
         name: "Settings & Profiles",
         value: -5
@@ -602,6 +784,58 @@ class Sprinkle {
       return;
     }
     const selection = selectionResult;
+    if (selection === -6) {
+      const utilitiesMenu = {
+        title: "Utilities",
+        items: [{
+          title: "Mint Token",
+          action: async () => {
+            const result = await (0, _index2.promptAndExecute)(this, _utilityActions.mintToken);
+            if (!result.success) {
+              if (result.error.code === "USER_CANCELLED") return;
+              console.error(`\nError (${result.error.code}): ${result.error.message}\n`);
+              return;
+            }
+            const data = result.data;
+            console.log(`\nPolicy: ${data.policyId}\nToken: ${data.tokenName}\nAmount: ${data.amount}\n`);
+            const blaze = await Sprinkle.GetBlaze(this.settings.network, this.settings.provider, this.settings.wallet);
+            const tx = _sdk.Core.Transaction.fromCbor(_sdk.Core.TxCBOR(data.txCbor));
+            await this.TxDialog(blaze, tx);
+          }
+        }, {
+          title: "Simple Send",
+          action: async () => {
+            const result = await (0, _index2.promptAndExecute)(this, _utilityActions.simpleSend);
+            if (!result.success) {
+              if (result.error.code === "USER_CANCELLED") return;
+              console.error(`\nError (${result.error.code}): ${result.error.message}\n`);
+              return;
+            }
+            const data = result.data;
+            const blaze = await Sprinkle.GetBlaze(this.settings.network, this.settings.provider, this.settings.wallet);
+            const tx = _sdk.Core.Transaction.fromCbor(_sdk.Core.TxCBOR(data.txCbor));
+            await this.TxDialog(blaze, tx);
+          }
+        }, {
+          title: "Register Stake Script",
+          action: async () => {
+            const result = await (0, _index2.promptAndExecute)(this, _utilityActions.registerStakeScript);
+            if (!result.success) {
+              if (result.error.code === "USER_CANCELLED") return;
+              console.error(`\nError (${result.error.code}): ${result.error.message}\n`);
+              return;
+            }
+            const data = result.data;
+            const blaze = await Sprinkle.GetBlaze(this.settings.network, this.settings.provider, this.settings.wallet);
+            const tx = _sdk.Core.Transaction.fromCbor(_sdk.Core.TxCBOR(data.txCbor));
+            await this.TxDialog(blaze, tx);
+          }
+        }]
+      };
+      await this._showMenu(utilitiesMenu, false, [...path, "Utilities"], true);
+      await this._showMenu(menu, main, path, true);
+      return;
+    }
     if (selection === -5) {
       const settingsMenu = {
         title: "Settings & Profiles",
@@ -668,6 +902,113 @@ class Sprinkle {
           action: async () => {
             await this.deleteProfile();
           }
+        }, {
+          title: "Addressbook",
+          items: [{
+            title: "View entries",
+            action: async () => {
+              const entries = Object.entries(this.addressbook);
+              if (entries.length === 0) {
+                console.log("Addressbook is empty.");
+              } else {
+                for (const [name, ms] of entries) {
+                  const json = JSON.stringify(ms, _encryption.bigIntReplacer, 2);
+                  let hashStr = "unknown";
+                  try {
+                    hashStr = (0, _index2.toNativeScript)(ms).hash();
+                  } catch {/* skip */}
+                  console.log(_yoctocolorsCjs.default.bold(name) + "  " + _yoctocolorsCjs.default.dim(hashStr));
+                  console.log(json);
+                  console.log();
+                }
+              }
+              await (0, _prompts.selectWithClear)({
+                message: "Press Enter to continue...",
+                choices: [{
+                  name: "Continue",
+                  value: "continue"
+                }]
+              });
+            }
+          }, {
+            title: "Add entry",
+            action: async () => {
+              const name = await (0, _prompts.inputCancellable)({
+                message: "Entry name:",
+                validate: v => v.trim().length > 0 ? true : "Name cannot be empty"
+              });
+              if (name === null) return;
+              if (this.addressbook[name]) {
+                const overwrite = await (0, _prompts.confirmCancellable)({
+                  message: `Entry "${name}" already exists. Overwrite?`,
+                  default: false
+                });
+                if (!overwrite) return;
+              }
+              try {
+                const script = await this.FillInStruct(_schemas.MultisigScript);
+                this.addressbook[name] = script;
+                this.saveSettings();
+                console.log(`Added "${name}" to addressbook.`);
+              } catch (e) {
+                if (e instanceof _types.UserCancelledError) return;
+                throw e;
+              }
+            }
+          }, {
+            title: "Edit entry",
+            action: async () => {
+              const entries = Object.keys(this.addressbook);
+              if (entries.length === 0) {
+                console.log("Addressbook is empty.");
+                return;
+              }
+              const selected = await (0, _prompts.selectCancellable)({
+                message: "Select entry to edit:",
+                choices: entries.map(n => ({
+                  name: n,
+                  value: n
+                }))
+              });
+              if (selected === null) return;
+              const editName = selected;
+              try {
+                const updated = await this.EditStruct(_schemas.MultisigScript, this.addressbook[editName]);
+                this.addressbook[editName] = updated;
+                this.saveSettings();
+                console.log(`Updated "${editName}".`);
+              } catch (e) {
+                if (e instanceof _types.UserCancelledError) return;
+                throw e;
+              }
+            }
+          }, {
+            title: "Delete entry",
+            action: async () => {
+              const entries = Object.keys(this.addressbook);
+              if (entries.length === 0) {
+                console.log("Addressbook is empty.");
+                return;
+              }
+              const delSelected = await (0, _prompts.selectCancellable)({
+                message: "Select entry to delete:",
+                choices: entries.map(n => ({
+                  name: n,
+                  value: n
+                }))
+              });
+              if (delSelected === null) return;
+              const delName = delSelected;
+              const confirmed = await (0, _prompts.confirmCancellable)({
+                message: `Delete "${delName}"?`,
+                default: false
+              });
+              if (!confirmed) return;
+              delete this.addressbook[delName];
+              this.saveSettings();
+              console.log(`Deleted "${delName}".`);
+            }
+          }]
         }]
       };
       await this._showMenu(settingsMenu, false, [...path, "Settings & Profiles"], true);
@@ -761,6 +1102,88 @@ class Sprinkle {
   getDisplaySettings() {
     return (0, _encryption.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 _index2.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: {},
+      addressbook: {}
+    };
+    fs.writeFileSync(path.join(profilesDir, `${id}.json`), JSON.stringify(profileData, _encryption.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 _index2.ActionError(`Profile "${id}" not found.`, "PROFILE_NOT_FOUND", {
+        id
+      });
+    }
+    if (profiles.length === 1) {
+      throw new _index2.ActionError("Cannot delete the only profile.", "CANNOT_DELETE_ONLY_PROFILE", {
+        id
+      });
+    }
+    if (id === this.profileId) {
+      throw new _index2.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;
@@ -1070,7 +1493,67 @@ class Sprinkle {
       if (!resolvedType) {
         throw new Error(`Could not resolve type ${type["$ref"]} at ${path.join(".")}`);
       }
-      return this._fillInStruct(resolvedType, path, defs, def);
+
+      // Addressbook integration for MultisigScript fields
+      if (type["$ref"] === "MultisigScript" && Object.keys(this.addressbook).length > 0) {
+        const sourceChoice = await (0, _prompts.selectWithClear)({
+          message: "Select source for native script:",
+          choices: [{
+            name: "Enter manually",
+            value: "manual"
+          }, {
+            name: "Select from addressbook",
+            value: "addressbook"
+          }]
+        });
+        if (sourceChoice === null) throw new _types.UserCancelledError();
+        if (sourceChoice === "addressbook") {
+          const entries = Object.entries(this.addressbook);
+          const abChoices = entries.map(([name, ms]) => {
+            let hashStr = "";
+            try {
+              hashStr = "  " + _yoctocolorsCjs.default.dim((0, _index2.toNativeScript)(ms).hash());
+            } catch {/* skip */}
+            return {
+              name: name + hashStr,
+              value: name
+            };
+          });
+          const selected = await (0, _prompts.selectWithClear)({
+            message: "Select addressbook entry:",
+            choices: abChoices
+          });
+          if (selected === null) throw new _types.UserCancelledError();
+          return this.addressbook[selected];
+        }
+      }
+      const result = await this._fillInStruct(resolvedType, path, defs, def);
+
+      // Offer to save manually entered MultisigScript to addressbook
+      if (type["$ref"] === "MultisigScript" && result !== undefined) {
+        const shouldSave = await (0, _prompts.selectWithClear)({
+          message: "Save this script to the addressbook?",
+          choices: [{
+            name: "No",
+            value: false
+          }, {
+            name: "Yes",
+            value: true
+          }]
+        });
+        if (shouldSave) {
+          const entryName = await (0, _prompts.inputCancellable)({
+            message: "Addressbook entry name:",
+            validate: v => v.trim().length > 0 ? true : "Name cannot be empty"
+          });
+          if (entryName !== null) {
+            this.addressbook[entryName] = result;
+            this.saveSettings();
+            console.log(`Saved "${entryName}" to addressbook.`);
+          }
+        }
+      }
+      return result;
     }
     if ((0, _typeGuards.isOptional)(type)) {
       const pathDisplay = (0, _formatting.formatPath)(path) || "value";
@@ -1215,6 +1698,24 @@ class Sprinkle {
       }
       return BigInt(answer);
     }
+    if ((0, _typeGuards.isBoolean)(type)) {
+      const pathDisplay = (0, _formatting.formatPath)(path) || "value";
+      const answer = await (0, _prompts.selectWithClear)({
+        message: Sprinkle.ExtractMessage(type, `${pathDisplay}?`),
+        choices: [{
+          name: "Yes",
+          value: true
+        }, {
+          name: "No",
+          value: false
+        }],
+        default: def !== undefined ? def : (0, _typeGuards.hasDefault)(type) ? (0, _typeGuards.getDefault)(type) : undefined
+      });
+      if (answer === null) {
+        throw new _types.UserCancelledError();
+      }
+      return answer;
+    }
     if ((0, _typeGuards.isLiteral)(type)) {
       return type.const;
     }
@@ -1303,6 +1804,178 @@ 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 (0, _index2.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 = (0, _index2.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((0, _index2.generateAppHelp)(sprinkle.listActions()));
+      return;
+    }
+    if (mode === "cli") {
+      const {
+        actionName,
+        args
+      } = (0, _index2.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((0, _index2.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 (0, _index2.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 (0, _index2.runMcp)(sprinkle, serverName);
+      return;
+    }
+  }
 }
 exports.Sprinkle = Sprinkle;
 //# sourceMappingURL=index.js.map