@sundaeswap/sprinkles 0.6.1 → 0.8.0

package/dist/cjs/Sprinkle/actions/builtin/wallet-actions.js

@@ -0,0 +1,212 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getWalletUtxos = exports.getWalletBalance = exports.getWalletAddress = void 0;
+var _typebox = require("@sinclair/typebox");
+var _sdk = require("@blaze-cardano/sdk");
+var _types = require("../types.js");
+var _blazeHelper = require("./blaze-helper.js");
+/**
+ * Built-in wallet query actions for the Sprinkle action system.
+ * These actions expose wallet address, balance, and UTxO queries as
+ * non-interactive actions available in CLI and MCP modes.
+ *
+ * All actions use category "wallet".
+ */
+
+/** Shared token entry shape for balance and UTxO output */
+const TokenEntrySchema = _typebox.Type.Object({
+  policyId: _typebox.Type.String({
+    description: "Policy ID of the token"
+  }),
+  assetName: _typebox.Type.String({
+    description: "Asset name of the token (hex)"
+  }),
+  quantity: _typebox.Type.String({
+    description: "Token quantity as string (BigInt-safe)"
+  })
+});
+
+/**
+ * `get-wallet-address` -- Returns the primary change address of the configured wallet.
+ */
+const getWalletAddress = exports.getWalletAddress = {
+  name: "get-wallet-address",
+  description: "Get the primary address of the configured wallet.",
+  category: "wallet",
+  inputSchema: _typebox.Type.Object({}),
+  outputSchema: _typebox.Type.Object({
+    address: _typebox.Type.String({
+      description: "Bech32-encoded payment/change address"
+    }),
+    network: _typebox.Type.String({
+      description: "Network name (mainnet, preview, preprod)"
+    })
+  }),
+  execute: async (_input, context) => {
+    const blaze = await (0, _blazeHelper.getBlazeFromContext)(context);
+    let address;
+    try {
+      address = await blaze.wallet.getChangeAddress();
+    } catch (err) {
+      throw new _types.ActionError(`Failed to get wallet address: ${err instanceof Error ? err.message : String(err)}`, "NO_ADDRESS", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+    if (!address) {
+      throw new _types.ActionError("The wallet returned no address. Ensure the wallet is properly configured.", "NO_ADDRESS");
+    }
+    const settings = context.settings;
+    const network = settings.network ?? "unknown";
+    return {
+      address: address.toBech32(),
+      network
+    };
+  }
+};
+
+/**
+ * `get-wallet-balance` -- Returns the ADA and token balance of the configured wallet.
+ * Aggregates lovelace and multi-asset amounts from all UTxOs.
+ * All quantities are returned as strings for BigInt-safe JSON serialization.
+ */
+const getWalletBalance = exports.getWalletBalance = {
+  name: "get-wallet-balance",
+  description: "Get the ADA and token balance of the configured wallet. Quantities returned as strings.",
+  category: "wallet",
+  inputSchema: _typebox.Type.Object({}),
+  outputSchema: _typebox.Type.Object({
+    lovelace: _typebox.Type.String({
+      description: "Total ADA balance in lovelace (as string for BigInt safety)"
+    }),
+    ada: _typebox.Type.String({
+      description: "Total ADA balance as decimal string"
+    }),
+    tokens: _typebox.Type.Array(TokenEntrySchema)
+  }),
+  execute: async (_input, context) => {
+    const blaze = await (0, _blazeHelper.getBlazeFromContext)(context);
+    let utxos;
+    try {
+      utxos = await blaze.wallet.getUnspentOutputs();
+    } catch (err) {
+      throw new _types.ActionError(`Provider error while fetching UTxOs: ${err instanceof Error ? err.message : String(err)}`, "PROVIDER_ERROR", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+
+    // Aggregate lovelace and token amounts
+    let totalLovelace = 0n;
+    const tokenMap = new Map(); // key: `${policyId}.${assetName}`
+
+    for (const utxo of utxos) {
+      const value = utxo.output().amount();
+      totalLovelace += value.coin();
+      const multiasset = value.multiasset();
+      if (multiasset) {
+        for (const [assetId, quantity] of multiasset.entries()) {
+          const policyId = _sdk.Core.AssetId.getPolicyId(assetId);
+          const assetName = _sdk.Core.AssetId.getAssetName(assetId);
+          const key = `${policyId}.${assetName}`;
+          tokenMap.set(key, (tokenMap.get(key) ?? 0n) + quantity);
+        }
+      }
+    }
+
+    // Convert tokens map to array, serializing BigInt quantities as strings
+    const tokens = Array.from(tokenMap.entries()).map(([key, quantity]) => {
+      const [policyId, assetName] = key.split(".");
+      return {
+        policyId: policyId ?? "",
+        assetName: assetName ?? "",
+        quantity: quantity.toString()
+      };
+    });
+
+    // ADA = lovelace / 1_000_000, with 6 decimal places
+    const adaWhole = totalLovelace / 1_000_000n;
+    const adaFraction = totalLovelace % 1_000_000n;
+    const ada = `${adaWhole}.${adaFraction.toString().padStart(6, "0")}`;
+    return {
+      lovelace: totalLovelace.toString(),
+      ada,
+      tokens
+    };
+  }
+};
+
+/**
+ * `get-wallet-utxos` -- Returns raw UTxO set for the configured wallet.
+ * Accepts an optional limit (default 100). Returns UTxOs and the total count.
+ */
+const getWalletUtxos = exports.getWalletUtxos = {
+  name: "get-wallet-utxos",
+  description: "Get the UTxO set for the configured wallet.",
+  category: "wallet",
+  inputSchema: _typebox.Type.Object({
+    limit: _typebox.Type.Optional(_typebox.Type.Number({
+      default: 100,
+      description: "Maximum number of UTxOs to return"
+    }))
+  }),
+  outputSchema: _typebox.Type.Object({
+    utxos: _typebox.Type.Array(_typebox.Type.Object({
+      txHash: _typebox.Type.String({
+        description: "Transaction hash of the UTxO"
+      }),
+      outputIndex: _typebox.Type.Number({
+        description: "Output index within the transaction"
+      }),
+      lovelace: _typebox.Type.String({
+        description: "Lovelace amount as string (BigInt-safe)"
+      }),
+      tokens: _typebox.Type.Array(TokenEntrySchema)
+    })),
+    total: _typebox.Type.Number({
+      description: "Total number of UTxOs (before limit)"
+    })
+  }),
+  execute: async (input, context) => {
+    const blaze = await (0, _blazeHelper.getBlazeFromContext)(context);
+    const limit = input.limit ?? 100;
+    let allUtxos;
+    try {
+      allUtxos = await blaze.wallet.getUnspentOutputs();
+    } catch (err) {
+      throw new _types.ActionError(`Provider error while fetching UTxOs: ${err instanceof Error ? err.message : String(err)}`, "PROVIDER_ERROR", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+    const total = allUtxos.length;
+    const limited = allUtxos.slice(0, limit);
+    const utxos = limited.map(utxo => {
+      const input = utxo.input();
+      const output = utxo.output();
+      const value = output.amount();
+      const tokens = [];
+      const multiasset = value.multiasset();
+      if (multiasset) {
+        for (const [assetId, quantity] of multiasset.entries()) {
+          tokens.push({
+            policyId: _sdk.Core.AssetId.getPolicyId(assetId),
+            assetName: _sdk.Core.AssetId.getAssetName(assetId),
+            quantity: quantity.toString()
+          });
+        }
+      }
+      return {
+        txHash: input.transactionId().toString(),
+        outputIndex: Number(input.index()),
+        lovelace: value.coin().toString(),
+        tokens
+      };
+    });
+    return {
+      utxos,
+      total
+    };
+  }
+};
+//# sourceMappingURL=wallet-actions.js.map

package/dist/cjs/Sprinkle/actions/builtin/wallet-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-actions.js","names":["_typebox","require","_sdk","_types","_blazeHelper","TokenEntrySchema","Type","Object","policyId","String","description","assetName","quantity","getWalletAddress","exports","name","category","inputSchema","outputSchema","address","network","execute","_input","context","blaze","getBlazeFromContext","wallet","getChangeAddress","err","ActionError","Error","message","error","settings","toBech32","getWalletBalance","lovelace","ada","tokens","Array","utxos","getUnspentOutputs","totalLovelace","tokenMap","Map","utxo","value","output","amount","coin","multiasset","assetId","entries","Core","AssetId","getPolicyId","getAssetName","key","set","get","from","map","split","toString","adaWhole","adaFraction","padStart","getWalletUtxos","limit","Optional","Number","default","txHash","outputIndex","total","input","allUtxos","length","limited","slice","push","transactionId","index"],"sources":["../../../../../src/Sprinkle/actions/builtin/wallet-actions.ts"],"sourcesContent":["/**\n * Built-in wallet query actions for the Sprinkle action system.\n * These actions expose wallet address, balance, and UTxO queries as\n * non-interactive actions available in CLI and MCP modes.\n *\n * All actions use category \"wallet\".\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type { TSchema } from \"@sinclair/typebox\";\nimport { Core } from \"@blaze-cardano/sdk\";\nimport { ActionError } from \"../types.js\";\nimport type { IAction } from \"../types.js\";\nimport { getBlazeFromContext } from \"./blaze-helper.js\";\n\n/** Shared token entry shape for balance and UTxO output */\nconst TokenEntrySchema = Type.Object({\n  policyId: Type.String({ description: \"Policy ID of the token\" }),\n  assetName: Type.String({ description: \"Asset name of the token (hex)\" }),\n  quantity: Type.String({ description: \"Token quantity as string (BigInt-safe)\" }),\n});\n\n/**\n * `get-wallet-address` -- Returns the primary change address of the configured wallet.\n */\nexport const getWalletAddress: IAction<\n  Record<string, never>,\n  { address: string; network: string },\n  TSchema\n> = {\n  name: \"get-wallet-address\",\n  description: \"Get the primary address of the configured wallet.\",\n  category: \"wallet\",\n  inputSchema: Type.Object({}),\n  outputSchema: Type.Object({\n    address: Type.String({ description: \"Bech32-encoded payment/change address\" }),\n    network: Type.String({ description: \"Network name (mainnet, preview, preprod)\" }),\n  }),\n  execute: async (_input, context) => {\n    const blaze = await getBlazeFromContext(context);\n\n    let address: Core.Address;\n    try {\n      address = await blaze.wallet.getChangeAddress();\n    } catch (err) {\n      throw new ActionError(\n        `Failed to get wallet address: ${err instanceof Error ? err.message : String(err)}`,\n        \"NO_ADDRESS\",\n        { error: err instanceof Error ? err.message : String(err) },\n      );\n    }\n\n    if (!address) {\n      throw new ActionError(\n        \"The wallet returned no address. Ensure the wallet is properly configured.\",\n        \"NO_ADDRESS\",\n      );\n    }\n\n    const settings = context.settings as unknown as { network?: string };\n    const network = settings.network ?? \"unknown\";\n\n    return {\n      address: address.toBech32(),\n      network,\n    };\n  },\n};\n\n/**\n * `get-wallet-balance` -- Returns the ADA and token balance of the configured wallet.\n * Aggregates lovelace and multi-asset amounts from all UTxOs.\n * All quantities are returned as strings for BigInt-safe JSON serialization.\n */\nexport const getWalletBalance: IAction<\n  Record<string, never>,\n  {\n    lovelace: string;\n    ada: string;\n    tokens: Array<{ policyId: string; assetName: string; quantity: string }>;\n  },\n  TSchema\n> = {\n  name: \"get-wallet-balance\",\n  description:\n    \"Get the ADA and token balance of the configured wallet. Quantities returned as strings.\",\n  category: \"wallet\",\n  inputSchema: Type.Object({}),\n  outputSchema: Type.Object({\n    lovelace: Type.String({\n      description: \"Total ADA balance in lovelace (as string for BigInt safety)\",\n    }),\n    ada: Type.String({ description: \"Total ADA balance as decimal string\" }),\n    tokens: Type.Array(TokenEntrySchema),\n  }),\n  execute: async (_input, context) => {\n    const blaze = await getBlazeFromContext(context);\n\n    let utxos: Awaited<ReturnType<typeof blaze.wallet.getUnspentOutputs>>;\n    try {\n      utxos = await blaze.wallet.getUnspentOutputs();\n    } catch (err) {\n      throw new ActionError(\n        `Provider error while fetching UTxOs: ${err instanceof Error ? err.message : String(err)}`,\n        \"PROVIDER_ERROR\",\n        { error: err instanceof Error ? err.message : String(err) },\n      );\n    }\n\n    // Aggregate lovelace and token amounts\n    let totalLovelace = 0n;\n    const tokenMap = new Map<string, bigint>(); // key: `${policyId}.${assetName}`\n\n    for (const utxo of utxos) {\n      const value = utxo.output().amount();\n      totalLovelace += value.coin();\n\n      const multiasset = value.multiasset();\n      if (multiasset) {\n        for (const [assetId, quantity] of multiasset.entries()) {\n          const policyId = Core.AssetId.getPolicyId(assetId);\n          const assetName = Core.AssetId.getAssetName(assetId);\n          const key = `${policyId}.${assetName}`;\n          tokenMap.set(key, (tokenMap.get(key) ?? 0n) + quantity);\n        }\n      }\n    }\n\n    // Convert tokens map to array, serializing BigInt quantities as strings\n    const tokens = Array.from(tokenMap.entries()).map(([key, quantity]) => {\n      const [policyId, assetName] = key.split(\".\");\n      return {\n        policyId: policyId ?? \"\",\n        assetName: assetName ?? \"\",\n        quantity: quantity.toString(),\n      };\n    });\n\n    // ADA = lovelace / 1_000_000, with 6 decimal places\n    const adaWhole = totalLovelace / 1_000_000n;\n    const adaFraction = totalLovelace % 1_000_000n;\n    const ada = `${adaWhole}.${adaFraction.toString().padStart(6, \"0\")}`;\n\n    return {\n      lovelace: totalLovelace.toString(),\n      ada,\n      tokens,\n    };\n  },\n};\n\n/**\n * `get-wallet-utxos` -- Returns raw UTxO set for the configured wallet.\n * Accepts an optional limit (default 100). Returns UTxOs and the total count.\n */\nexport const getWalletUtxos: IAction<\n  { limit?: number },\n  {\n    utxos: Array<{\n      txHash: string;\n      outputIndex: number;\n      lovelace: string;\n      tokens: Array<{ policyId: string; assetName: string; quantity: string }>;\n    }>;\n    total: number;\n  },\n  TSchema\n> = {\n  name: \"get-wallet-utxos\",\n  description: \"Get the UTxO set for the configured wallet.\",\n  category: \"wallet\",\n  inputSchema: Type.Object({\n    limit: Type.Optional(\n      Type.Number({ default: 100, description: \"Maximum number of UTxOs to return\" }),\n    ),\n  }),\n  outputSchema: Type.Object({\n    utxos: Type.Array(\n      Type.Object({\n        txHash: Type.String({ description: \"Transaction hash of the UTxO\" }),\n        outputIndex: Type.Number({ description: \"Output index within the transaction\" }),\n        lovelace: Type.String({ description: \"Lovelace amount as string (BigInt-safe)\" }),\n        tokens: Type.Array(TokenEntrySchema),\n      }),\n    ),\n    total: Type.Number({ description: \"Total number of UTxOs (before limit)\" }),\n  }),\n  execute: async (input, context) => {\n    const blaze = await getBlazeFromContext(context);\n    const limit = input.limit ?? 100;\n\n    let allUtxos: Awaited<ReturnType<typeof blaze.wallet.getUnspentOutputs>>;\n    try {\n      allUtxos = await blaze.wallet.getUnspentOutputs();\n    } catch (err) {\n      throw new ActionError(\n        `Provider error while fetching UTxOs: ${err instanceof Error ? err.message : String(err)}`,\n        \"PROVIDER_ERROR\",\n        { error: err instanceof Error ? err.message : String(err) },\n      );\n    }\n\n    const total = allUtxos.length;\n    const limited = allUtxos.slice(0, limit);\n\n    const utxos = limited.map((utxo) => {\n      const input = utxo.input();\n      const output = utxo.output();\n      const value = output.amount();\n\n      const tokens: Array<{ policyId: string; assetName: string; quantity: string }> = [];\n      const multiasset = value.multiasset();\n      if (multiasset) {\n        for (const [assetId, quantity] of multiasset.entries()) {\n          tokens.push({\n            policyId: Core.AssetId.getPolicyId(assetId),\n            assetName: Core.AssetId.getAssetName(assetId),\n            quantity: quantity.toString(),\n          });\n        }\n      }\n\n      return {\n        txHash: input.transactionId().toString(),\n        outputIndex: Number(input.index()),\n        lovelace: value.coin().toString(),\n        tokens,\n      };\n    });\n\n    return { utxos, total };\n  },\n};\n"],"mappings":";;;;;;AAQA,IAAAA,QAAA,GAAAC,OAAA;AAEA,IAAAC,IAAA,GAAAD,OAAA;AACA,IAAAE,MAAA,GAAAF,OAAA;AAEA,IAAAG,YAAA,GAAAH,OAAA;AAbA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA;AACA,MAAMI,gBAAgB,GAAGC,aAAI,CAACC,MAAM,CAAC;EACnCC,QAAQ,EAAEF,aAAI,CAACG,MAAM,CAAC;IAAEC,WAAW,EAAE;EAAyB,CAAC,CAAC;EAChEC,SAAS,EAAEL,aAAI,CAACG,MAAM,CAAC;IAAEC,WAAW,EAAE;EAAgC,CAAC,CAAC;EACxEE,QAAQ,EAAEN,aAAI,CAACG,MAAM,CAAC;IAAEC,WAAW,EAAE;EAAyC,CAAC;AACjF,CAAC,CAAC;;AAEF;AACA;AACA;AACO,MAAMG,gBAIZ,GAAAC,OAAA,CAAAD,gBAAA,GAAG;EACFE,IAAI,EAAE,oBAAoB;EAC1BL,WAAW,EAAE,mDAAmD;EAChEM,QAAQ,EAAE,QAAQ;EAClBC,WAAW,EAAEX,aAAI,CAACC,MAAM,CAAC,CAAC,CAAC,CAAC;EAC5BW,YAAY,EAAEZ,aAAI,CAACC,MAAM,CAAC;IACxBY,OAAO,EAAEb,aAAI,CAACG,MAAM,CAAC;MAAEC,WAAW,EAAE;IAAwC,CAAC,CAAC;IAC9EU,OAAO,EAAEd,aAAI,CAACG,MAAM,CAAC;MAAEC,WAAW,EAAE;IAA2C,CAAC;EAClF,CAAC,CAAC;EACFW,OAAO,EAAE,MAAAA,CAAOC,MAAM,EAAEC,OAAO,KAAK;IAClC,MAAMC,KAAK,GAAG,MAAM,IAAAC,gCAAmB,EAACF,OAAO,CAAC;IAEhD,IAAIJ,OAAqB;IACzB,IAAI;MACFA,OAAO,GAAG,MAAMK,KAAK,CAACE,MAAM,CAACC,gBAAgB,CAAC,CAAC;IACjD,CAAC,CAAC,OAAOC,GAAG,EAAE;MACZ,MAAM,IAAIC,kBAAW,CACnB,iCAAiCD,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACG,OAAO,GAAGtB,MAAM,CAACmB,GAAG,CAAC,EAAE,EACnF,YAAY,EACZ;QAAEI,KAAK,EAAEJ,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACG,OAAO,GAAGtB,MAAM,CAACmB,GAAG;MAAE,CAC5D,CAAC;IACH;IAEA,IAAI,CAACT,OAAO,EAAE;MACZ,MAAM,IAAIU,kBAAW,CACnB,2EAA2E,EAC3E,YACF,CAAC;IACH;IAEA,MAAMI,QAAQ,GAAGV,OAAO,CAACU,QAA2C;IACpE,MAAMb,OAAO,GAAGa,QAAQ,CAACb,OAAO,IAAI,SAAS;IAE7C,OAAO;MACLD,OAAO,EAAEA,OAAO,CAACe,QAAQ,CAAC,CAAC;MAC3Bd;IACF,CAAC;EACH;AACF,CAAC;;AAED;AACA;AACA;AACA;AACA;AACO,MAAMe,gBAQZ,GAAArB,OAAA,CAAAqB,gBAAA,GAAG;EACFpB,IAAI,EAAE,oBAAoB;EAC1BL,WAAW,EACT,yFAAyF;EAC3FM,QAAQ,EAAE,QAAQ;EAClBC,WAAW,EAAEX,aAAI,CAACC,MAAM,CAAC,CAAC,CAAC,CAAC;EAC5BW,YAAY,EAAEZ,aAAI,CAACC,MAAM,CAAC;IACxB6B,QAAQ,EAAE9B,aAAI,CAACG,MAAM,CAAC;MACpBC,WAAW,EAAE;IACf,CAAC,CAAC;IACF2B,GAAG,EAAE/B,aAAI,CAACG,MAAM,CAAC;MAAEC,WAAW,EAAE;IAAsC,CAAC,CAAC;IACxE4B,MAAM,EAAEhC,aAAI,CAACiC,KAAK,CAAClC,gBAAgB;EACrC,CAAC,CAAC;EACFgB,OAAO,EAAE,MAAAA,CAAOC,MAAM,EAAEC,OAAO,KAAK;IAClC,MAAMC,KAAK,GAAG,MAAM,IAAAC,gCAAmB,EAACF,OAAO,CAAC;IAEhD,IAAIiB,KAAiE;IACrE,IAAI;MACFA,KAAK,GAAG,MAAMhB,KAAK,CAACE,MAAM,CAACe,iBAAiB,CAAC,CAAC;IAChD,CAAC,CAAC,OAAOb,GAAG,EAAE;MACZ,MAAM,IAAIC,kBAAW,CACnB,wCAAwCD,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACG,OAAO,GAAGtB,MAAM,CAACmB,GAAG,CAAC,EAAE,EAC1F,gBAAgB,EAChB;QAAEI,KAAK,EAAEJ,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACG,OAAO,GAAGtB,MAAM,CAACmB,GAAG;MAAE,CAC5D,CAAC;IACH;;IAEA;IACA,IAAIc,aAAa,GAAG,EAAE;IACtB,MAAMC,QAAQ,GAAG,IAAIC,GAAG,CAAiB,CAAC,CAAC,CAAC;;IAE5C,KAAK,MAAMC,IAAI,IAAIL,KAAK,EAAE;MACxB,MAAMM,KAAK,GAAGD,IAAI,CAACE,MAAM,CAAC,CAAC,CAACC,MAAM,CAAC,CAAC;MACpCN,aAAa,IAAII,KAAK,CAACG,IAAI,CAAC,CAAC;MAE7B,MAAMC,UAAU,GAAGJ,KAAK,CAACI,UAAU,CAAC,CAAC;MACrC,IAAIA,UAAU,EAAE;QACd,KAAK,MAAM,CAACC,OAAO,EAAEvC,QAAQ,CAAC,IAAIsC,UAAU,CAACE,OAAO,CAAC,CAAC,EAAE;UACtD,MAAM5C,QAAQ,GAAG6C,SAAI,CAACC,OAAO,CAACC,WAAW,CAACJ,OAAO,CAAC;UAClD,MAAMxC,SAAS,GAAG0C,SAAI,CAACC,OAAO,CAACE,YAAY,CAACL,OAAO,CAAC;UACpD,MAAMM,GAAG,GAAG,GAAGjD,QAAQ,IAAIG,SAAS,EAAE;UACtCgC,QAAQ,CAACe,GAAG,CAACD,GAAG,EAAE,CAACd,QAAQ,CAACgB,GAAG,CAACF,GAAG,CAAC,IAAI,EAAE,IAAI7C,QAAQ,CAAC;QACzD;MACF;IACF;;IAEA;IACA,MAAM0B,MAAM,GAAGC,KAAK,CAACqB,IAAI,CAACjB,QAAQ,CAACS,OAAO,CAAC,CAAC,CAAC,CAACS,GAAG,CAAC,CAAC,CAACJ,GAAG,EAAE7C,QAAQ,CAAC,KAAK;MACrE,MAAM,CAACJ,QAAQ,EAAEG,SAAS,CAAC,GAAG8C,GAAG,CAACK,KAAK,CAAC,GAAG,CAAC;MAC5C,OAAO;QACLtD,QAAQ,EAAEA,QAAQ,IAAI,EAAE;QACxBG,SAAS,EAAEA,SAAS,IAAI,EAAE;QAC1BC,QAAQ,EAAEA,QAAQ,CAACmD,QAAQ,CAAC;MAC9B,CAAC;IACH,CAAC,CAAC;;IAEF;IACA,MAAMC,QAAQ,GAAGtB,aAAa,GAAG,UAAU;IAC3C,MAAMuB,WAAW,GAAGvB,aAAa,GAAG,UAAU;IAC9C,MAAML,GAAG,GAAG,GAAG2B,QAAQ,IAAIC,WAAW,CAACF,QAAQ,CAAC,CAAC,CAACG,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;IAEpE,OAAO;MACL9B,QAAQ,EAAEM,aAAa,CAACqB,QAAQ,CAAC,CAAC;MAClC1B,GAAG;MACHC;IACF,CAAC;EACH;AACF,CAAC;;AAED;AACA;AACA;AACA;AACO,MAAM6B,cAYZ,GAAArD,OAAA,CAAAqD,cAAA,GAAG;EACFpD,IAAI,EAAE,kBAAkB;EACxBL,WAAW,EAAE,6CAA6C;EAC1DM,QAAQ,EAAE,QAAQ;EAClBC,WAAW,EAAEX,aAAI,CAACC,MAAM,CAAC;IACvB6D,KAAK,EAAE9D,aAAI,CAAC+D,QAAQ,CAClB/D,aAAI,CAACgE,MAAM,CAAC;MAAEC,OAAO,EAAE,GAAG;MAAE7D,WAAW,EAAE;IAAoC,CAAC,CAChF;EACF,CAAC,CAAC;EACFQ,YAAY,EAAEZ,aAAI,CAACC,MAAM,CAAC;IACxBiC,KAAK,EAAElC,aAAI,CAACiC,KAAK,CACfjC,aAAI,CAACC,MAAM,CAAC;MACViE,MAAM,EAAElE,aAAI,CAACG,MAAM,CAAC;QAAEC,WAAW,EAAE;MAA+B,CAAC,CAAC;MACpE+D,WAAW,EAAEnE,aAAI,CAACgE,MAAM,CAAC;QAAE5D,WAAW,EAAE;MAAsC,CAAC,CAAC;MAChF0B,QAAQ,EAAE9B,aAAI,CAACG,MAAM,CAAC;QAAEC,WAAW,EAAE;MAA0C,CAAC,CAAC;MACjF4B,MAAM,EAAEhC,aAAI,CAACiC,KAAK,CAAClC,gBAAgB;IACrC,CAAC,CACH,CAAC;IACDqE,KAAK,EAAEpE,aAAI,CAACgE,MAAM,CAAC;MAAE5D,WAAW,EAAE;IAAuC,CAAC;EAC5E,CAAC,CAAC;EACFW,OAAO,EAAE,MAAAA,CAAOsD,KAAK,EAAEpD,OAAO,KAAK;IACjC,MAAMC,KAAK,GAAG,MAAM,IAAAC,gCAAmB,EAACF,OAAO,CAAC;IAChD,MAAM6C,KAAK,GAAGO,KAAK,CAACP,KAAK,IAAI,GAAG;IAEhC,IAAIQ,QAAoE;IACxE,IAAI;MACFA,QAAQ,GAAG,MAAMpD,KAAK,CAACE,MAAM,CAACe,iBAAiB,CAAC,CAAC;IACnD,CAAC,CAAC,OAAOb,GAAG,EAAE;MACZ,MAAM,IAAIC,kBAAW,CACnB,wCAAwCD,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACG,OAAO,GAAGtB,MAAM,CAACmB,GAAG,CAAC,EAAE,EAC1F,gBAAgB,EAChB;QAAEI,KAAK,EAAEJ,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACG,OAAO,GAAGtB,MAAM,CAACmB,GAAG;MAAE,CAC5D,CAAC;IACH;IAEA,MAAM8C,KAAK,GAAGE,QAAQ,CAACC,MAAM;IAC7B,MAAMC,OAAO,GAAGF,QAAQ,CAACG,KAAK,CAAC,CAAC,EAAEX,KAAK,CAAC;IAExC,MAAM5B,KAAK,GAAGsC,OAAO,CAACjB,GAAG,CAAEhB,IAAI,IAAK;MAClC,MAAM8B,KAAK,GAAG9B,IAAI,CAAC8B,KAAK,CAAC,CAAC;MAC1B,MAAM5B,MAAM,GAAGF,IAAI,CAACE,MAAM,CAAC,CAAC;MAC5B,MAAMD,KAAK,GAAGC,MAAM,CAACC,MAAM,CAAC,CAAC;MAE7B,MAAMV,MAAwE,GAAG,EAAE;MACnF,MAAMY,UAAU,GAAGJ,KAAK,CAACI,UAAU,CAAC,CAAC;MACrC,IAAIA,UAAU,EAAE;QACd,KAAK,MAAM,CAACC,OAAO,EAAEvC,QAAQ,CAAC,IAAIsC,UAAU,CAACE,OAAO,CAAC,CAAC,EAAE;UACtDd,MAAM,CAAC0C,IAAI,CAAC;YACVxE,QAAQ,EAAE6C,SAAI,CAACC,OAAO,CAACC,WAAW,CAACJ,OAAO,CAAC;YAC3CxC,SAAS,EAAE0C,SAAI,CAACC,OAAO,CAACE,YAAY,CAACL,OAAO,CAAC;YAC7CvC,QAAQ,EAAEA,QAAQ,CAACmD,QAAQ,CAAC;UAC9B,CAAC,CAAC;QACJ;MACF;MAEA,OAAO;QACLS,MAAM,EAAEG,KAAK,CAACM,aAAa,CAAC,CAAC,CAAClB,QAAQ,CAAC,CAAC;QACxCU,WAAW,EAAEH,MAAM,CAACK,KAAK,CAACO,KAAK,CAAC,CAAC,CAAC;QAClC9C,QAAQ,EAAEU,KAAK,CAACG,IAAI,CAAC,CAAC,CAACc,QAAQ,CAAC,CAAC;QACjCzB;MACF,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;MAAEE,KAAK;MAAEkC;IAAM,CAAC;EACzB;AACF,CAAC","ignoreList":[]}

package/dist/cjs/Sprinkle/actions/cli-adapter.js

@@ -0,0 +1,390 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.camelToKebab = camelToKebab;
+exports.coerceValue = coerceValue;
+exports.generateActionHelp = generateActionHelp;
+exports.generateAppHelp = generateAppHelp;
+exports.kebabToCamel = kebabToCamel;
+exports.parseArgvWithSchema = parseArgvWithSchema;
+exports.runCli = runCli;
+var _encryption = require("../encryption.js");
+var _typeGuards = require("../type-guards.js");
+var _runner = require("./runner.js");
+/**
+ * CLI adapter for Sprinkles actions.
+ *
+ * Provides:
+ * - Case-conversion helpers (camelToKebab / kebabToCamel)
+ * - Schema-driven type coercion (coerceValue / parseArgvWithSchema)
+ * - Help text generation (generateActionHelp / generateAppHelp)
+ * - CLI orchestrator (runCli)
+ */
+
+// Re-import Sprinkle as a type only to avoid circular deps
+
+// ---------------------------------------------------------------------------
+// Case conversion helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert a camelCase string to kebab-case.
+ * Examples:
+ *   "myFlagName" -> "my-flag-name"
+ *   "getBalance" -> "get-balance"
+ *   "URL"        -> "u-r-l"  (each uppercase letter gets a dash)
+ */
+function camelToKebab(str) {
+  if (!str) return str;
+  return str.replace(/([A-Z])/g, match => `-${match.toLowerCase()}`).replace(/^-/, "");
+}
+
+/**
+ * Convert a kebab-case string to camelCase.
+ * Examples:
+ *   "my-flag-name" -> "myFlagName"
+ *   "get-balance"  -> "getBalance"
+ */
+function kebabToCamel(str) {
+  if (!str) return str;
+  return str.replace(/-([a-z0-9])/g, (_, char) => char.toUpperCase());
+}
+
+// ---------------------------------------------------------------------------
+// Schema-driven type coercion
+// ---------------------------------------------------------------------------
+
+/**
+ * Coerce a raw CLI string value to the type expected by a TypeBox schema.
+ *
+ * Handles:
+ * - Number / Integer: parseFloat / parseInt
+ * - Boolean: "true"/"false" strings, or passthrough if already boolean
+ * - BigInt: BigInt() constructor
+ * - Array: already-array passthrough; single value wrapped in array
+ * - Object: JSON string parse
+ * - String: passthrough
+ * - Optional: unwrap and recurse on inner schema
+ * - Union: passthrough (caller should supply JSON; no schema-level heuristics)
+ */
+function coerceValue(raw, schema) {
+  // Note: TypeBox Optional<T> adds an [OptionalKind] marker but does not
+  // change the schema Kind. The guards below work correctly on Optional types.
+
+  // If the raw value is null or undefined, return as-is
+  if (raw === null || raw === undefined) return raw;
+  if ((0, _typeGuards.isNumber)(schema)) {
+    if (typeof raw === "number") return raw;
+    if (typeof raw === "string") {
+      const n = parseFloat(raw);
+      return isNaN(n) ? raw : n;
+    }
+    return raw;
+  }
+  if ((0, _typeGuards.isInteger)(schema)) {
+    if (typeof raw === "number") return Math.trunc(raw);
+    if (typeof raw === "string") {
+      const n = parseInt(raw, 10);
+      return isNaN(n) ? raw : n;
+    }
+    return raw;
+  }
+  if ((0, _typeGuards.isBoolean)(schema)) {
+    if (typeof raw === "boolean") return raw;
+    if (raw === "true") return true;
+    if (raw === "false") return false;
+    return raw;
+  }
+  if ((0, _typeGuards.isBigInt)(schema)) {
+    if (typeof raw === "bigint") return raw;
+    if (typeof raw === "string" || typeof raw === "number") {
+      try {
+        return BigInt(raw);
+      } catch {
+        return raw;
+      }
+    }
+    return raw;
+  }
+  if ((0, _typeGuards.isArray)(schema)) {
+    const itemSchema = schema.items;
+    if (Array.isArray(raw)) {
+      if (itemSchema) {
+        return raw.map(item => coerceValue(item, itemSchema));
+      }
+      return raw;
+    }
+    // Single value: wrap in array
+    const singleValue = itemSchema ? coerceValue(raw, itemSchema) : raw;
+    return [singleValue];
+  }
+  if ((0, _typeGuards.isObject)(schema)) {
+    let obj = raw;
+    // If it's a JSON string, parse it
+    if (typeof raw === "string") {
+      const trimmed = raw.trim();
+      if (trimmed.startsWith("{")) {
+        try {
+          obj = JSON.parse(trimmed);
+        } catch {
+          return raw;
+        }
+      } else {
+        return raw;
+      }
+    }
+    // Recurse into properties to coerce nested values
+    if (typeof obj === "object" && obj !== null && !Array.isArray(obj)) {
+      const props = schema.properties;
+      if (props) {
+        const result = {
+          ...obj
+        };
+        for (const [key, propSchema] of Object.entries(props)) {
+          if (key in result) {
+            result[key] = coerceValue(result[key], propSchema);
+          }
+        }
+        return result;
+      }
+    }
+    return obj;
+  }
+  if ((0, _typeGuards.isString)(schema)) {
+    if (typeof raw === "string") return raw;
+    return String(raw);
+  }
+
+  // Union / unknown / other: return as-is (caller provides JSON)
+  return raw;
+}
+
+/**
+ * Walk a TypeBox object schema and coerce each property value from raw CLI args.
+ *
+ * - Handles kebab-case -> camelCase property name mapping
+ * - Applies coerceValue for each property
+ * - Applies TypeBox defaults for omitted optional fields
+ *
+ * @param rawArgs  - Key/value record from parseCliArgs (keys may be kebab-case)
+ * @param schema   - A TypeBox TObject schema
+ * @returns        A new record with coerced values
+ */
+function parseArgvWithSchema(rawArgs, schema) {
+  if (!(0, _typeGuards.isObject)(schema)) {
+    // Non-object schema: return args as-is (best-effort)
+    return rawArgs;
+  }
+  const result = {};
+  const properties = schema.properties;
+  for (const [propName, propSchema] of Object.entries(properties)) {
+    // Look up both camelCase and kebab-case versions in rawArgs
+    const kebabName = camelToKebab(propName);
+    let rawValue = undefined;
+    if (propName in rawArgs) {
+      rawValue = rawArgs[propName];
+    } else if (kebabName !== propName && kebabName in rawArgs) {
+      rawValue = rawArgs[kebabName];
+    }
+    if (rawValue === undefined) {
+      // Apply default if defined on schema
+      if ((0, _typeGuards.hasDefault)(propSchema)) {
+        result[propName] = (0, _typeGuards.getDefault)(propSchema);
+      }
+      // Else omit: Value.Check will handle required/optional enforcement
+      continue;
+    }
+    result[propName] = coerceValue(rawValue, propSchema);
+  }
+  return result;
+}
+
+// ---------------------------------------------------------------------------
+// Help text generation
+// ---------------------------------------------------------------------------
+
+/**
+ * Describe a single TypeBox schema in a human-readable CLI type label.
+ */
+function describeType(schema) {
+  // Note: isOptional() only checks the OptionalKind marker; the other guards
+  // still work correctly on Optional-wrapped schemas.
+  if ((0, _typeGuards.isString)(schema)) return "<string>";
+  if ((0, _typeGuards.isNumber)(schema)) return "<number>";
+  if ((0, _typeGuards.isInteger)(schema)) return "<integer>";
+  if ((0, _typeGuards.isBoolean)(schema)) return "<boolean>";
+  if ((0, _typeGuards.isBigInt)(schema)) return "<bigint>";
+  if ((0, _typeGuards.isArray)(schema)) {
+    const itemSchema = schema.items;
+    const itemType = itemSchema ? describeType(itemSchema) : "<value>";
+    return `${itemType}... (repeatable)`;
+  }
+  if ((0, _typeGuards.isObject)(schema)) return "<json>";
+  if ((0, _typeGuards.isUnion)(schema)) return "<json>";
+  return "<value>";
+}
+
+/**
+ * Generate action-specific help text.
+ *
+ * Format:
+ * ```
+ * Usage: <appName> <action-name> [options]
+ *
+ * Description
+ *
+ * Options:
+ *   --flag-name <type>  Description  [default: x]  (required/optional)
+ *   ...
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function generateActionHelp(action, appName) {
+  const app = appName ?? "app";
+  const lines = [`Usage: ${app} ${action.name} [options]`, "", action.description, "", "Options:"];
+  const schema = action.inputSchema;
+  if ((0, _typeGuards.isObject)(schema)) {
+    const properties = schema.properties;
+    const required = schema.required ?? [];
+    for (const [propName, propSchema] of Object.entries(properties)) {
+      const flagName = camelToKebab(propName);
+      const typeLabel = describeType(propSchema);
+      const isReq = required.includes(propName);
+      const defaultVal = (0, _typeGuards.hasDefault)(propSchema) ? (0, _typeGuards.getDefault)(propSchema) : undefined;
+      const description = propSchema.description ?? "";
+      const requiredLabel = isReq ? "(required)" : "(optional)";
+      const defaultLabel = defaultVal !== undefined ? `  [default: ${String(defaultVal)}]` : "";
+      const descPart = description ? `  ${description}` : "";
+      lines.push(`  --${flagName} ${typeLabel}${descPart}${defaultLabel}  ${requiredLabel}`);
+    }
+  }
+  lines.push("");
+  lines.push("  --help  Show this help message");
+  return lines.join("\n");
+}
+
+/**
+ * Generate application-level help listing all registered actions.
+ *
+ * Format:
+ * ```
+ * Usage: <appName> <action> [options]
+ *
+ * Available actions:
+ *
+ *   category:
+ *     action-name  Description
+ *
+ * Global options:
+ *   --help          Show this help message
+ *   --profile <n>   Use profile by name
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function generateAppHelp(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+actions, appName) {
+  const app = appName ?? "app";
+  const lines = [`Usage: ${app} <action> [options]`, ""];
+  if (actions.length === 0) {
+    lines.push("No actions registered.");
+  } else {
+    lines.push("Available actions:");
+
+    // Group by category
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const byCategory = new Map();
+    for (const action of actions) {
+      const cat = action.category ?? "default";
+      const bucket = byCategory.get(cat);
+      if (bucket) {
+        bucket.push(action);
+      } else {
+        byCategory.set(cat, [action]);
+      }
+    }
+    for (const [category, categoryActions] of byCategory) {
+      if (category !== "default") {
+        lines.push("");
+        lines.push(`  ${category}:`);
+      }
+      for (const action of categoryActions) {
+        lines.push(`  ${action.name.padEnd(30)} ${action.description}`);
+      }
+    }
+  }
+  lines.push("");
+  lines.push("Global options:");
+  lines.push("  --help         Show this help message");
+  lines.push("  --profile <n>  Use profile by name");
+  return lines.join("\n");
+}
+
+// ---------------------------------------------------------------------------
+// CLI orchestrator
+// ---------------------------------------------------------------------------
+
+/**
+ * Run an action from CLI arguments, writing JSON output to stdout/stderr.
+ *
+ * Handles:
+ * - Action not found: JSON error to stderr, process.exit(1)
+ * - Action help (`--help` in rawArgs): prints action help to stdout
+ * - Schema-driven argument coercion via parseArgvWithSchema
+ * - Success: `{"success":true,"data":...}` JSON to stdout
+ * - Failure: `{"success":false,"error":...}` JSON to stderr, process.exit(1)
+ *
+ * @param sprinkle   - Fully-initialized Sprinkle instance
+ * @param actionName - The action to invoke
+ * @param rawArgs    - Pre-parsed key/value args from parseCliArgs (profile already removed)
+ * @param context    - The action execution context
+ * @param appName    - Optional app name for help text
+ */
+async function runCli(sprinkle, actionName, rawArgs, context, appName) {
+  const action = sprinkle.getAction(actionName);
+  if (!action) {
+    const available = sprinkle.listActions().map(a => a.name).join(", ");
+    const errorOutput = JSON.stringify({
+      success: false,
+      error: {
+        code: "ACTION_NOT_FOUND",
+        message: `Action "${actionName}" not found. Available actions: ${available || "(none)"}`
+      }
+    }, _encryption.bigIntReplacer);
+    console.error(errorOutput);
+    process.exit(1);
+  }
+
+  // Handle --help flag for action-specific help
+  if (rawArgs["help"] === true) {
+    console.log(generateActionHelp(action, appName));
+    return;
+  }
+
+  // Coerce raw string args using the action's input schema
+  const coercedInput = parseArgvWithSchema(rawArgs, action.inputSchema);
+
+  // Execute and output result
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const result = await (0, _runner.executeAction)(action, coercedInput, context);
+  if (result.success) {
+    console.log(JSON.stringify({
+      success: true,
+      data: result.data
+    }, _encryption.bigIntReplacer));
+  } else {
+    const errorOutput = JSON.stringify({
+      success: false,
+      error: {
+        code: result.error.code,
+        message: result.error.message,
+        details: result.error.details
+      }
+    }, _encryption.bigIntReplacer);
+    console.error(errorOutput);
+    process.exit(1);
+  }
+}
+//# sourceMappingURL=cli-adapter.js.map