@sundaeswap/sprinkles 0.6.1 → 0.8.0

package/dist/types/Sprinkle/actions/builtin/utility-actions.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Built-in utility actions for the Sprinkle action system.
+ * These actions provide common Cardano operations: minting tokens,
+ * sending ADA/tokens, and registering stake scripts.
+ */
+import type { TSchema } from "@sinclair/typebox";
+import type { IAction } from "../types.js";
+import type { NativeScriptInput } from "./native-script.js";
+/**
+ * `mint-token` -- Mint native tokens using a native script derived from the wallet's payment key.
+ * The policy is a simple ScriptPubkey requiring the wallet's payment credential to sign.
+ * Requires a hot wallet.
+ */
+export declare const mintToken: IAction<{
+    tokenName: string;
+    amount: string;
+    nativeScripts?: NativeScriptInput[];
+}, {
+    policyId: string;
+    tokenName: string;
+    amount: string;
+    txCbor: string;
+}, TSchema>;
+/**
+ * `simple-send` -- Send ADA or a native token to a recipient address.
+ * Builds an unsigned transaction that can be signed via TxDialog or sign-transaction.
+ */
+export declare const simpleSend: IAction<{
+    recipientAddress: string;
+    lovelace?: string;
+    policyId?: string;
+    assetName?: string;
+    tokenAmount?: string;
+    nativeScripts?: NativeScriptInput[];
+}, {
+    txCbor: string;
+}, TSchema>;
+/**
+ * `register-stake-script` -- Register a stake script credential on-chain.
+ * Takes a script hash and builds a stake registration transaction.
+ */
+export declare const registerStakeScript: IAction<{
+    scriptHash: string;
+    nativeScripts?: NativeScriptInput[];
+}, {
+    txCbor: string;
+}, TSchema>;
+//# sourceMappingURL=utility-actions.d.ts.map

package/dist/types/Sprinkle/actions/builtin/utility-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-actions.d.ts","sourceRoot":"","sources":["../../../../../src/Sprinkle/actions/builtin/utility-actions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,CAC7B;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAA;CAAE,EAC1E;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACvE,OAAO,CAiGR,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,CAC9B;IACE,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACrC,EACD;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAClB,OAAO,CAuFR,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CACvC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAA;CAAE,EAC3D;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAClB,OAAO,CAmDR,CAAC"}

package/dist/types/Sprinkle/actions/builtin/wallet-actions.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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".
+ */
+import type { TSchema } from "@sinclair/typebox";
+import type { IAction } from "../types.js";
+/**
+ * `get-wallet-address` -- Returns the primary change address of the configured wallet.
+ */
+export declare const getWalletAddress: IAction<Record<string, never>, {
+    address: string;
+    network: string;
+}, TSchema>;
+/**
+ * `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.
+ */
+export declare const getWalletBalance: IAction<Record<string, never>, {
+    lovelace: string;
+    ada: string;
+    tokens: Array<{
+        policyId: string;
+        assetName: string;
+        quantity: string;
+    }>;
+}, TSchema>;
+/**
+ * `get-wallet-utxos` -- Returns raw UTxO set for the configured wallet.
+ * Accepts an optional limit (default 100). Returns UTxOs and the total count.
+ */
+export declare const getWalletUtxos: IAction<{
+    limit?: number;
+}, {
+    utxos: Array<{
+        txHash: string;
+        outputIndex: number;
+        lovelace: string;
+        tokens: Array<{
+            policyId: string;
+            assetName: string;
+            quantity: string;
+        }>;
+    }>;
+    total: number;
+}, TSchema>;
+//# sourceMappingURL=wallet-actions.d.ts.map

package/dist/types/Sprinkle/actions/builtin/wallet-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-actions.d.ts","sourceRoot":"","sources":["../../../../../src/Sprinkle/actions/builtin/wallet-actions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAU3C;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAAO,CACpC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACrB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACpC,OAAO,CAuCR,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAAO,CACpC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACrB;IACE,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E,EACD,OAAO,CAoER,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAClC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAClB;IACE,KAAK,EAAE,KAAK,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC1E,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACf,EACD,OAAO,CAkER,CAAC"}

package/dist/types/Sprinkle/actions/cli-adapter.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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)
+ */
+import type { TSchema } from "@sinclair/typebox";
+import type { AnyAction, IActionContext } from "./types.js";
+import type { Sprinkle } from "../index.js";
+/**
+ * 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)
+ */
+export declare function camelToKebab(str: string): string;
+/**
+ * Convert a kebab-case string to camelCase.
+ * Examples:
+ *   "my-flag-name" -> "myFlagName"
+ *   "get-balance"  -> "getBalance"
+ */
+export declare function kebabToCamel(str: string): string;
+/**
+ * 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)
+ */
+export declare function coerceValue(raw: unknown, schema: TSchema): unknown;
+/**
+ * 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
+ */
+export declare function parseArgvWithSchema(rawArgs: Record<string, unknown>, schema: TSchema): Record<string, unknown>;
+/**
+ * Generate action-specific help text.
+ *
+ * Format:
+ * ```
+ * Usage: <appName> <action-name> [options]
+ *
+ * Description
+ *
+ * Options:
+ *   --flag-name <type>  Description  [default: x]  (required/optional)
+ *   ...
+ * ```
+ */
+export declare function generateActionHelp(action: AnyAction<any>, appName?: string): string;
+/**
+ * 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
+ * ```
+ */
+export declare function generateAppHelp(actions: AnyAction<any>[], appName?: string): string;
+/**
+ * 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
+ */
+export declare function runCli<S extends TSchema>(sprinkle: Sprinkle<S>, actionName: string, rawArgs: Record<string, unknown>, context: IActionContext<S>, appName?: string): Promise<void>;
+//# sourceMappingURL=cli-adapter.d.ts.map

package/dist/types/Sprinkle/actions/cli-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-adapter.d.ts","sourceRoot":"","sources":["../../../../src/Sprinkle/actions/cli-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAcjD,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhD;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CA+FlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,OAAO,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCzB;AA2BD;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAqCR;AAED;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAgB,eAAe,CAE7B,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EACzB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAuCR;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,MAAM,CAAC,CAAC,SAAS,OAAO,EAC5C,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAoDf"}

package/dist/types/Sprinkle/actions/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Barrel export for the actions subsystem.
+ */
+export type { IAction, IActionContext, IActionResult, IActionSuccess, IActionFailure, AnyAction } from "./types.js";
+export { ActionError } from "./types.js";
+export { ActionRegistry } from "./registry.js";
+export { executeAction, detectMode, parseCliArgs } from "./runner.js";
+export { camelToKebab, kebabToCamel, coerceValue, parseArgvWithSchema, generateActionHelp, generateAppHelp, runCli, } from "./cli-adapter.js";
+export { typeboxToJsonSchema, coerceMcpInput, getMcpSdk, createMcpServer, runMcp, } from "./mcp-adapter.js";
+export { getBuiltinActions, toNativeScript, completeWithScripts } from "./builtin/index.js";
+export type { NativeScriptInput } from "./builtin/index.js";
+export { promptAndExecute } from "./tui-helpers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/Sprinkle/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Sprinkle/actions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACpH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,MAAM,GACP,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,eAAe,EACf,MAAM,GACP,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types/Sprinkle/actions/mcp-adapter.d.ts

@@ -0,0 +1,116 @@
+/**
+ * MCP adapter for Sprinkles actions.
+ *
+ * Provides:
+ * - TypeBox to JSON Schema conversion (typeboxToJsonSchema)
+ * - TypeBox to Zod conversion for MCP SDK compatibility (typeboxToZod)
+ * - BigInt string coercion for MCP input (coerceMcpInput)
+ * - Lazy MCP SDK import with graceful error (getMcpSdk)
+ * - MCP server creation from registered actions (createMcpServer)
+ * - MCP orchestrator that starts a stdio server (runMcp)
+ */
+import type { TSchema } from "@sinclair/typebox";
+import type { Sprinkle } from "../index.js";
+/**
+ * Convert a TypeBox schema to a plain JSON Schema object.
+ *
+ * Strips TypeBox-internal symbols and properties (Kind, OptionalKind, $id)
+ * and maps TypeBox-specific types to their JSON Schema equivalents:
+ * - BigInt -> { type: "string", pattern: "^-?[0-9]+$" } (JSON has no BigInt)
+ * - Sensitive string fields -> add writeOnly: true
+ * - Optional -> recurse on inner schema (Optional does not change Kind)
+ * - Union -> { anyOf: [...] }
+ * - Literal -> { type, const }
+ * - Null -> { type: "null" }
+ * - Unknown/unsupported -> {} (accepts anything)
+ */
+export declare function typeboxToJsonSchema(schema: TSchema): Record<string, unknown>;
+/**
+ * Coerce MCP JSON input values to the types expected by a TypeBox schema.
+ *
+ * MCP transmits all values as JSON, which has no BigInt type. When the schema
+ * expects a BigInt, the value arrives as a numeric string (e.g. "12345678").
+ * This function recursively walks the schema and input, converting BigInt
+ * string values to actual BigInt where needed.
+ *
+ * For all other types the value is passed through unchanged.
+ */
+export declare function coerceMcpInput(input: unknown, schema: TSchema): unknown;
+/**
+ * Zod module shape (the parts we use from zod).
+ * Typed loosely since zod is a transitive dependency of @modelcontextprotocol/sdk,
+ * not a direct dependency of Sprinkles.
+ */
+type ZodType = any;
+/**
+ * Convert a TypeBox schema to a Zod schema for MCP SDK compatibility.
+ *
+ * The MCP SDK (v1.27+) expects Zod schemas for tool input validation,
+ * not plain JSON Schema objects. This function converts TypeBox schemas
+ * to their Zod equivalents so the SDK correctly registers tool parameters.
+ *
+ * BigInt fields are represented as z.string() with a regex pattern since
+ * JSON (and thus MCP) has no BigInt type. The coerceMcpInput function
+ * handles converting these string values back to BigInt at call time.
+ */
+export declare function typeboxToZod(schema: TSchema): Promise<ZodType>;
+/**
+ * Convert a TypeBox object schema to a Zod "raw shape" (Record<string, ZodType>).
+ * This is the format expected by the MCP SDK's tool() API.
+ */
+export declare function typeboxToZodShape(schema: TSchema): Promise<Record<string, ZodType>>;
+/**
+ * MCP SDK module shape (the parts we use from @modelcontextprotocol/sdk).
+ * Typed loosely to avoid a hard dependency at compile time.
+ */
+interface IMcpSdkModule {
+    McpServer: new (opts: {
+        name: string;
+        version: string;
+    }) => any;
+}
+/**
+ * Lazily import the MCP SDK server module.
+ *
+ * Throws a clear, actionable error if the SDK is not installed, rather than
+ * a cryptic "Cannot find module" Node error.
+ */
+export declare function getMcpSdk(): Promise<IMcpSdkModule>;
+/**
+ * Create an MCP server and register all actions from a Sprinkle instance as
+ * MCP tools.
+ *
+ * Each action becomes a tool with:
+ * - name: action.name
+ * - description: action.description
+ * - input schema: typeboxToJsonSchema(action.inputSchema)
+ * - handler: coerces input, executes action, returns JSON result
+ *
+ * The Sprinkle instance must already be initialized with a profile before
+ * this function is called.
+ *
+ * @param sprinkle   - Fully-initialized Sprinkle instance
+ * @param serverName - Name to use for the MCP server
+ * @returns          The configured McpServer instance (not yet connected)
+ */
+export declare function createMcpServer<S extends TSchema>(sprinkle: Sprinkle<S>, serverName: string): Promise<any>;
+/**
+ * Start an MCP server on stdio transport.
+ *
+ * This function:
+ * 1. Creates the MCP server and registers all actions as tools
+ * 2. Creates a StdioServerTransport
+ * 3. Connects the server to the transport
+ *
+ * IMPORTANT: All logging in this function goes to stderr. stdout is reserved
+ * for the MCP protocol messages.
+ *
+ * The Sprinkle instance must already be initialized with a profile. Profile
+ * initialization is the responsibility of the caller (Sprinkle.Run()).
+ *
+ * @param sprinkle   - Fully-initialized Sprinkle instance
+ * @param serverName - Name to use for the MCP server
+ */
+export declare function runMcp<S extends TSchema>(sprinkle: Sprinkle<S>, serverName: string): Promise<void>;
+export {};
+//# sourceMappingURL=mcp-adapter.d.ts.map

package/dist/types/Sprinkle/actions/mcp-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../../../../src/Sprinkle/actions/mcp-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAoBjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiC5C;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2H5E;AAMD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CA4DvE;AAMD;;;;GAIG;AAEH,KAAK,OAAO,GAAG,GAAG,CAAC;AAmDnB;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAGpE;AAuED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoBlC;AAMD;;;GAGG;AACH,UAAU,aAAa;IAErB,SAAS,EAAE,KAAK,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,GAAG,CAAC;CACjE;AAOD;;;;;GAKG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAUxD;AAqBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,OAAO,EACrD,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,UAAU,EAAE,MAAM,GAEjB,OAAO,CAAC,GAAG,CAAC,CAgEd;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,MAAM,CAAC,CAAC,SAAS,OAAO,EAC5C,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/types/Sprinkle/actions/registry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Action registry for storing and retrieving registered actions.
+ */
+import type { TSchema } from "@sinclair/typebox";
+import type { AnyAction } from "./types.js";
+/**
+ * Registry for managing actions registered on a Sprinkle app.
+ * Enforces name uniqueness and schema validation at registration time.
+ */
+export declare class ActionRegistry<S extends TSchema> {
+    private actions;
+    /**
+     * Register an action with the registry.
+     *
+     * Validates:
+     * - Name is kebab-case (lowercase letters, digits, hyphens)
+     * - Name is unique within this registry
+     * - inputSchema and outputSchema are present
+     *
+     * @throws Error if validation fails
+     */
+    register(action: AnyAction<S>): void;
+    /**
+     * Retrieve an action by name.
+     * @returns The action, or undefined if not registered
+     */
+    get(name: string): AnyAction<S> | undefined;
+    /**
+     * Check if an action with the given name is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * List all registered actions.
+     */
+    list(): AnyAction<S>[];
+    /**
+     * Group all registered actions by their category.
+     * Actions without a category are placed under "default".
+     */
+    listByCategory(): Map<string, AnyAction<S>[]>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/types/Sprinkle/actions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/Sprinkle/actions/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,OAAO;IAC3C,OAAO,CAAC,OAAO,CAAwC;IAEvD;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IA4BpC;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS;IAI3C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE;IAItB;;;OAGG;IACH,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;CAe9C"}

package/dist/types/Sprinkle/actions/runner.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Action runner utilities: input validation, execution, mode detection, and CLI arg parsing.
+ */
+import type { TSchema } from "@sinclair/typebox";
+import type { IAction, IActionContext, IActionResult } from "./types.js";
+/**
+ * Execute an action with raw (unvalidated) input.
+ *
+ * - Validates rawInput against action.inputSchema using Value.Check
+ * - Applies defaults and transforms via Value.Decode
+ * - Calls action.execute with decoded input
+ * - Wraps all errors in ActionError for consistent error handling
+ *
+ * @returns A discriminated IActionResult -- never throws
+ */
+export declare function executeAction<TInput, TOutput, S extends TSchema>(action: IAction<TInput, TOutput, S>, rawInput: unknown, context: IActionContext<S>): Promise<IActionResult<TOutput>>;
+/**
+ * Detect the intended run mode from process argv.
+ *
+ * - No args or --interactive: "tui"
+ * - --mcp: "mcp"
+ * - --help or -h (with no positional arg): "help"
+ * - First positional arg (not starting with --): "cli"
+ * - Default fallback: "tui"
+ */
+export declare function detectMode(argv: string[]): "tui" | "cli" | "mcp" | "help";
+/**
+ * Parse CLI argv into an action name and key-value argument record.
+ *
+ * Expects:
+ * - First positional arg as the action name
+ * - Subsequent --flag value or --flag=value pairs as arguments
+ * - --no-flag for boolean negation
+ * - Values starting with { or [ are parsed as JSON
+ *
+ * Note: This is a preliminary implementation. Complex nested inputs
+ * should be provided as JSON strings (e.g. --input '{"key":"value"}').
+ *
+ * @throws Error if no action name is found in argv
+ */
+export declare function parseCliArgs(argv: string[]): {
+    actionName: string;
+    args: Record<string, unknown>;
+};
+//# sourceMappingURL=runner.d.ts.map

package/dist/types/Sprinkle/actions/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/Sprinkle/actions/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,SAAS,OAAO,EACpE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,EACnC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CA+CjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EAAE,GACb,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAehC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EAAE,GACb;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAmEvD"}

package/dist/types/Sprinkle/actions/tui-helpers.d.ts

@@ -0,0 +1,53 @@
+/**
+ * TUI helper utilities for integrating the action system with interactive prompts.
+ *
+ * Provides:
+ * - promptAndExecute: gather input via FillInStruct then run executeAction
+ *
+ * @remarks
+ * Functions in this module require a fully initialized Sprinkle instance with
+ * terminal access. They are intended for TUI mode only; in CLI or MCP mode use
+ * executeAction directly.
+ */
+import type { TSchema } from "@sinclair/typebox";
+import type { IAction, IActionResult } from "./types.js";
+import type { Sprinkle } from "../index.js";
+/**
+ * Interactively gather input for an action using FillInStruct, then execute
+ * the action and return the result.
+ *
+ * The function:
+ * 1. Calls `sprinkle.FillInStruct(action.inputSchema, defaults)` to collect
+ *    input from the user via TUI prompts.
+ * 2. Builds an `IActionContext` from the sprinkle instance.
+ * 3. Calls `executeAction(action, input, context)` and returns the result.
+ *
+ * If the user cancels the prompt (`UserCancelledError` is thrown), the function
+ * returns an `IActionFailure` with code `USER_CANCELLED` rather than throwing.
+ *
+ * Two separate schema type parameters are used:
+ * - `S`  is the concrete settings schema of the `Sprinkle` instance.
+ * - `SA` is the settings schema the action was typed against (often `TSchema`).
+ *
+ * This allows a `Sprinkle<TObject<...>>` to be passed alongside an action
+ * typed with the base `TSchema` constraint (the same pattern used by all
+ * built-in actions), while still preserving full type safety for TInput/TOutput.
+ *
+ * @param sprinkle - An initialized Sprinkle instance (TUI mode).
+ * @param action   - The action to prompt for and execute.
+ * @param defaults - Optional partial defaults pre-filled in the prompt.
+ * @returns An `IActionResult` discriminated union (never throws).
+ *
+ * @example
+ * ```ts
+ * const result = await promptAndExecute(sprinkle, greetAction);
+ * if (result.success) {
+ *   console.log(result.data.greeting);
+ * } else {
+ *   if (result.error.code === "USER_CANCELLED") return; // user backed out
+ *   console.error(result.error.message);
+ * }
+ * ```
+ */
+export declare function promptAndExecute<TInput, TOutput, S extends TSchema, SA extends TSchema>(sprinkle: Sprinkle<S>, action: IAction<TInput, TOutput, SA>, defaults?: Partial<TInput>): Promise<IActionResult<TOutput>>;
+//# sourceMappingURL=tui-helpers.d.ts.map

package/dist/types/Sprinkle/actions/tui-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-helpers.d.ts","sourceRoot":"","sources":["../../../../src/Sprinkle/actions/tui-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAAE,OAAO,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAIzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EACN,OAAO,EACP,CAAC,SAAS,OAAO,EACjB,EAAE,SAAS,OAAO,EAElB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,EAIpC,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GACzB,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAyCjC"}

package/dist/types/Sprinkle/actions/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Core action types for the action-centric architecture.
+ * Actions are pure functions that receive validated typed input
+ * and return typed output, with no interactive prompts.
+ */
+import type { TSchema, Static } from "@sinclair/typebox";
+import type { Sprinkle } from "../index.js";
+/**
+ * Utility type to extract the static type from a TypeBox schema.
+ */
+type TExact<T> = T extends TSchema ? Static<T> : T;
+/**
+ * Context passed to action execute functions.
+ * Provides access to the Sprinkle instance and typed settings shorthand.
+ */
+export interface IActionContext<S extends TSchema> {
+    /** The full Sprinkle instance (settings, wallet, provider helpers) */
+    sprinkle: Sprinkle<S>;
+    /** Typed shorthand for sprinkle.settings */
+    settings: TExact<S>;
+}
+/**
+ * Successful action result.
+ */
+export interface IActionSuccess<T> {
+    success: true;
+    data: T;
+}
+/**
+ * Failed action result.
+ */
+export interface IActionFailure {
+    success: false;
+    error: ActionError;
+}
+/**
+ * Discriminated union result type for actions.
+ */
+export type IActionResult<T> = IActionSuccess<T> | IActionFailure;
+/**
+ * Structured error type for action failures.
+ * Carries a machine-readable code and optional details.
+ */
+export declare class ActionError extends Error {
+    code: string;
+    details: unknown;
+    constructor(message: string, code: string, details?: unknown);
+}
+/**
+ * A typed action with input/output schemas and an execute function.
+ *
+ * @template TInput - The static input type (derived from inputSchema)
+ * @template TOutput - The static output type (derived from outputSchema)
+ * @template S - The Sprinkle settings schema type
+ */
+export interface IAction<TInput, TOutput, S extends TSchema> {
+    /** Unique kebab-case identifier for this action */
+    name: string;
+    /** Human-readable description of what this action does */
+    description: string;
+    /** Optional grouping category for display/help */
+    category?: string;
+    /** TypeBox schema for validating and decoding input */
+    inputSchema: TSchema;
+    /** TypeBox schema describing the output shape */
+    outputSchema: TSchema;
+    /** Pure execution function -- no interactive prompts allowed */
+    execute: (input: TInput, context: IActionContext<S>) => Promise<TOutput>;
+}
+/**
+ * Convenience alias for an action with any input/output types.
+ * Used for registry storage where exact types are not required.
+ */
+export type AnyAction<S extends TSchema> = IAction<any, any, S>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/Sprinkle/actions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/Sprinkle/actions/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,KAAK,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,OAAO;IAC/C,sEAAsE;IACtE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACT;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC;AAElE;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;gBAEL,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAM7D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,SAAS,OAAO;IACzD,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,WAAW,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,YAAY,EAAE,OAAO,CAAC;IACtB,gEAAgE;IAChE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED;;;GAGG;AAEH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC"}