@dmindai/sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./chat-types"), exports);
+__exportStar(require("./chat"), exports);
+__exportStar(require("./constants"), exports);
+__exportStar(require("./errors"), exports);
+__exportStar(require("./parser"), exports);
+__exportStar(require("./profiles"), exports);
+__exportStar(require("./runtime"), exports);
+__exportStar(require("./sdk"), exports);
+__exportStar(require("./tool"), exports);
+__exportStar(require("./tools"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./validator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,yCAAuB;AACvB,8CAA4B;AAC5B,2CAAyB;AACzB,2CAAyB;AACzB,6CAA2B;AAC3B,4CAA0B;AAC1B,wCAAsB;AACtB,yCAAuB;AACvB,0CAAwB;AACxB,0CAAwB;AACxB,8CAA4B"}

package/dist/parser.d.ts

@@ -0,0 +1,3 @@
+import type { ParseOptions, ParsedResult, ProtocolMode, ToolCallResult } from "./types";
+export declare function parse(raw: string, mode?: ProtocolMode, options?: ParseOptions): ParsedResult;
+export declare function parseOfficial(raw: string, options?: ParseOptions): ToolCallResult | ParsedResult;

package/dist/parser.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse = parse;
+exports.parseOfficial = parseOfficial;
+const constants_1 = require("./constants");
+const utils_1 = require("./utils");
+const OFFICIAL_BLOCK_RE = /<start_function_call>([\s\S]*?)<end_function_call>/g;
+const LEGACY_BLOCK_RE = /<function_calls>([\s\S]*?)<\/function_calls>/g;
+const LEGACY_INVOKE_RE = /<invoke\s+name=(?:"([^"]+)"|'([^']+)')\s*>([\s\S]*?)<\/invoke>/g;
+const LEGACY_PARAM_RE = /<parameter\s+name=(?:"([^"]+)"|'([^']+)')\s*>([\s\S]*?)<\/parameter>/g;
+function parseOfficialPayload(payload, raw, options = {}) {
+    const trimmed = payload.trim();
+    if (!trimmed.startsWith("call:")) {
+        return (0, utils_1.makeParseError)("E_JSON_INVALID", "Official function call must start with `call:`.", raw);
+    }
+    const body = trimmed.slice("call:".length);
+    const jsonIndex = body.indexOf("{");
+    if (jsonIndex < 0) {
+        return (0, utils_1.makeParseError)("E_JSON_INVALID", "Official function call payload is missing JSON args.", raw);
+    }
+    const tool = body.slice(0, jsonIndex).trim();
+    const argsText = body.slice(jsonIndex).trim();
+    if (tool.length === 0) {
+        return (0, utils_1.makeParseError)("E_PARAM_MISSING", "Tool name is missing.", raw);
+    }
+    if (options.allowedTools && !options.allowedTools.has(tool)) {
+        return (0, utils_1.makeParseError)("E_TOOL_UNKNOWN", `Unknown tool: ${tool}.`, raw);
+    }
+    let args;
+    try {
+        args = JSON.parse(argsText);
+    }
+    catch (error) {
+        return (0, utils_1.makeParseError)("E_JSON_INVALID", `Failed to parse tool args JSON: ${error.message}`, raw);
+    }
+    if (!(0, utils_1.isPlainObject)(args)) {
+        return (0, utils_1.makeParseError)("E_JSON_INVALID", "Tool args must be a JSON object.", raw);
+    }
+    return {
+        type: "tool_call",
+        tool,
+        args,
+        raw,
+        protocol: "official"
+    };
+}
+function parseLegacyPayload(payload, raw, options = {}) {
+    const invokeMatches = [...payload.matchAll(LEGACY_INVOKE_RE)];
+    if (invokeMatches.length !== 1) {
+        return (0, utils_1.makeParseError)("E_INVOKE_COUNT", `Legacy payload must contain exactly 1 invoke node, got ${invokeMatches.length}.`, raw);
+    }
+    const [, dqName, sqName, invokeBody] = invokeMatches[0];
+    const tool = (dqName ?? sqName ?? "").trim();
+    if (tool.length === 0) {
+        return (0, utils_1.makeParseError)("E_PARAM_MISSING", "Tool name is missing.", raw);
+    }
+    if (options.allowedTools && !options.allowedTools.has(tool)) {
+        return (0, utils_1.makeParseError)("E_TOOL_UNKNOWN", `Unknown tool: ${tool}.`, raw);
+    }
+    const args = {};
+    for (const paramMatch of invokeBody.matchAll(LEGACY_PARAM_RE)) {
+        const [, dqParamName, sqParamName, paramValue] = paramMatch;
+        const key = (dqParamName ?? sqParamName ?? "").trim();
+        if (!key) {
+            continue;
+        }
+        args[key] = (0, utils_1.parseLooseXmlValue)(paramValue);
+    }
+    return {
+        type: "tool_call",
+        tool,
+        args,
+        raw,
+        protocol: "legacy"
+    };
+}
+function matchOfficial(raw, options = {}) {
+    const matches = [...raw.matchAll(OFFICIAL_BLOCK_RE)];
+    if (matches.length === 0) {
+        if (raw.includes("call:") ||
+            raw.includes(constants_1.OFFICIAL_START) ||
+            raw.includes(constants_1.OFFICIAL_END)) {
+            return (0, utils_1.makeParseError)("E_NO_WRAPPER", "Function call content detected but official wrapper is missing.", raw);
+        }
+        return { type: "text", text: raw, raw };
+    }
+    if (matches.length !== 1) {
+        return (0, utils_1.makeParseError)("E_INVOKE_COUNT", `Official mode expects exactly 1 function call block, got ${matches.length}.`, raw);
+    }
+    const [match] = matches;
+    const outside = raw.replace(match[0], "").trim();
+    if (outside.length > 0) {
+        return (0, utils_1.makeParseError)("E_WRONG_PROTOCOL", "Official function-call output cannot mix wrapper with extra text.", raw);
+    }
+    return parseOfficialPayload(match[1], raw, options);
+}
+function matchLegacy(raw, options = {}) {
+    const matches = [...raw.matchAll(LEGACY_BLOCK_RE)];
+    if (matches.length === 0) {
+        if (raw.includes(constants_1.LEGACY_START) ||
+            raw.includes(constants_1.LEGACY_END) ||
+            raw.includes("<invoke")) {
+            return (0, utils_1.makeParseError)("E_NO_WRAPPER", "Legacy function call tags detected but wrapper is incomplete.", raw);
+        }
+        return { type: "text", text: raw, raw };
+    }
+    if (matches.length !== 1) {
+        return (0, utils_1.makeParseError)("E_INVOKE_COUNT", `Legacy mode expects exactly 1 function_calls block, got ${matches.length}.`, raw);
+    }
+    const [match] = matches;
+    const outside = raw.replace(match[0], "").trim();
+    if (outside.length > 0) {
+        return (0, utils_1.makeParseError)("E_WRONG_PROTOCOL", "Legacy function-call output cannot mix wrapper with extra text.", raw);
+    }
+    return parseLegacyPayload(match[1], raw, options);
+}
+function hasLegacyTags(raw) {
+    return (raw.includes(constants_1.LEGACY_START) || raw.includes(constants_1.LEGACY_END) || raw.includes("<invoke"));
+}
+function hasOfficialTags(raw) {
+    return (raw.includes(constants_1.OFFICIAL_START) || raw.includes(constants_1.OFFICIAL_END) || raw.includes("call:"));
+}
+function parse(raw, mode = "official", options = {}) {
+    if (mode === "official") {
+        if (hasLegacyTags(raw)) {
+            return (0, utils_1.makeParseError)("E_WRONG_PROTOCOL", "Legacy protocol tags detected in official mode.", raw);
+        }
+        return matchOfficial(raw, options);
+    }
+    if (mode === "legacy") {
+        if (hasOfficialTags(raw)) {
+            return (0, utils_1.makeParseError)("E_WRONG_PROTOCOL", "Official protocol tags detected in legacy mode.", raw);
+        }
+        return matchLegacy(raw, options);
+    }
+    const officialCandidate = matchOfficial(raw, options);
+    if (officialCandidate.type === "tool_call") {
+        return officialCandidate;
+    }
+    if (officialCandidate.type === "parse_error" &&
+        officialCandidate.code !== "E_NO_WRAPPER") {
+        return officialCandidate;
+    }
+    const legacyCandidate = matchLegacy(raw, options);
+    if (legacyCandidate.type === "tool_call") {
+        return legacyCandidate;
+    }
+    if (legacyCandidate.type === "parse_error" &&
+        legacyCandidate.code !== "E_NO_WRAPPER") {
+        return legacyCandidate;
+    }
+    if (hasOfficialTags(raw) || hasLegacyTags(raw)) {
+        return (0, utils_1.makeParseError)("E_NO_WRAPPER", "Function call-like content detected but no valid wrapper found.", raw);
+    }
+    return { type: "text", text: raw, raw };
+}
+function parseOfficial(raw, options = {}) {
+    return parse(raw, "official", options);
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":";;AA4MA,sBA0DC;AAED,sCAKC;AA7QD,2CAKqB;AAErB,mCAA4E;AAE5E,MAAM,iBAAiB,GAAG,qDAAqD,CAAC;AAChF,MAAM,eAAe,GAAG,+CAA+C,CAAC;AACxE,MAAM,gBAAgB,GAAG,iEAAiE,CAAC;AAC3F,MAAM,eAAe,GACnB,uEAAuE,CAAC;AAE1E,SAAS,oBAAoB,CAC3B,OAAe,EACf,GAAW,EACX,UAAwB,EAAE;IAE1B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,IAAA,sBAAc,EACnB,gBAAgB,EAChB,iDAAiD,EACjD,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,IAAA,sBAAc,EACnB,gBAAgB,EAChB,sDAAsD,EACtD,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IAE9C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAA,sBAAc,EAAC,iBAAiB,EAAE,uBAAuB,EAAE,GAAG,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,OAAO,IAAA,sBAAc,EAAC,gBAAgB,EAAE,iBAAiB,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAA,sBAAc,EACnB,gBAAgB,EAChB,mCAAoC,KAAe,CAAC,OAAO,EAAE,EAC7D,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,IAAA,qBAAa,EAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,IAAA,sBAAc,EAAC,gBAAgB,EAAE,kCAAkC,EAAE,GAAG,CAAC,CAAC;IACnF,CAAC;IAED,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,IAAI;QACJ,IAAI;QACJ,GAAG;QACH,QAAQ,EAAE,UAAU;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,OAAe,EACf,GAAW,EACX,UAAwB,EAAE;IAE1B,MAAM,aAAa,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC9D,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAA,sBAAc,EACnB,gBAAgB,EAChB,0DAA0D,aAAa,CAAC,MAAM,GAAG,EACjF,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAA,sBAAc,EAAC,iBAAiB,EAAE,uBAAuB,EAAE,GAAG,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,OAAO,IAAA,sBAAc,EAAC,gBAAgB,EAAE,iBAAiB,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,KAAK,MAAM,UAAU,IAAI,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9D,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,GAAG,UAAU,CAAC;QAC5D,MAAM,GAAG,GAAG,CAAC,WAAW,IAAI,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAA,0BAAkB,EAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,IAAI;QACJ,IAAI;QACJ,GAAG;QACH,QAAQ,EAAE,QAAQ;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,GAAW,EAAE,UAAwB,EAAE;IAC5D,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACrD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,IACE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrB,GAAG,CAAC,QAAQ,CAAC,0BAAc,CAAC;YAC5B,GAAG,CAAC,QAAQ,CAAC,wBAAY,CAAC,EAC1B,CAAC;YACD,OAAO,IAAA,sBAAc,EACnB,cAAc,EACd,iEAAiE,EACjE,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAA,sBAAc,EACnB,gBAAgB,EAChB,4DAA4D,OAAO,CAAC,MAAM,GAAG,EAC7E,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;IACxB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,IAAA,sBAAc,EACnB,kBAAkB,EAClB,mEAAmE,EACnE,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,UAAwB,EAAE;IAC1D,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,IACE,GAAG,CAAC,QAAQ,CAAC,wBAAY,CAAC;YAC1B,GAAG,CAAC,QAAQ,CAAC,sBAAU,CAAC;YACxB,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EACvB,CAAC;YACD,OAAO,IAAA,sBAAc,EACnB,cAAc,EACd,+DAA+D,EAC/D,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAA,sBAAc,EACnB,gBAAgB,EAChB,2DAA2D,OAAO,CAAC,MAAM,GAAG,EAC5E,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;IACxB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,IAAA,sBAAc,EACnB,kBAAkB,EAClB,iEAAiE,EACjE,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,OAAO,CACL,GAAG,CAAC,QAAQ,CAAC,wBAAY,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,sBAAU,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAClF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,OAAO,CACL,GAAG,CAAC,QAAQ,CAAC,0BAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,wBAAY,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CACpF,CAAC;AACJ,CAAC;AAED,SAAgB,KAAK,CACnB,GAAW,EACX,OAAqB,UAAU,EAC/B,UAAwB,EAAE;IAE1B,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,IAAA,sBAAc,EACnB,kBAAkB,EAClB,iDAAiD,EACjD,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,IAAA,sBAAc,EACnB,kBAAkB,EAClB,iDAAiD,EACjD,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,iBAAiB,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,iBAAiB,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC3C,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,IACE,iBAAiB,CAAC,IAAI,KAAK,aAAa;QACxC,iBAAiB,CAAC,IAAI,KAAK,cAAc,EACzC,CAAC;QACD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,eAAe,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACzC,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IACE,eAAe,CAAC,IAAI,KAAK,aAAa;QACtC,eAAe,CAAC,IAAI,KAAK,cAAc,EACvC,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAA,sBAAc,EACnB,cAAc,EACd,iEAAiE,EACjE,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAC1C,CAAC;AAED,SAAgB,aAAa,CAC3B,GAAW,EACX,UAAwB,EAAE;IAE1B,OAAO,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/profiles.d.ts

@@ -0,0 +1,3 @@
+import type { ModelProfile } from "./types";
+export declare const DMIND_3_NANO_PROFILE: ModelProfile;
+export declare function toolNameSet(profile: ModelProfile): Set<string>;

package/dist/profiles.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DMIND_3_NANO_PROFILE = void 0;
+exports.toolNameSet = toolNameSet;
+const utils_1 = require("./utils");
+const CHAIN_VALUES = ["solana", "ethereum", "bsc", "base"];
+function validateSearchToken(args) {
+    const errors = [];
+    const hasSearchSeed = (0, utils_1.isNonEmptyString)(args.symbol) ||
+        (0, utils_1.isNonEmptyString)(args.address) ||
+        (0, utils_1.isNonEmptyString)(args.keyword);
+    if (!hasSearchSeed) {
+        errors.push({
+            code: "E_PARAM_MISSING",
+            message: "SEARCH_TOKEN requires at least one of symbol, address, or keyword."
+        });
+    }
+    if (args.address !== undefined && (0, utils_1.isNonEmptyString)(args.address)) {
+        if (!(0, utils_1.isLikelyTokenAddress)(args.address)) {
+            errors.push({
+                code: "E_PARAM_INVALID",
+                message: "SEARCH_TOKEN.address format is invalid."
+            });
+        }
+    }
+    return errors;
+}
+function validateExecuteSwap(args) {
+    const errors = [];
+    if (args.inputTokenAmount !== undefined &&
+        args.inputTokenPercentage !== undefined) {
+        errors.push({
+            code: "E_PARAM_FORBIDDEN",
+            message: "inputTokenAmount and inputTokenPercentage are mutually exclusive."
+        });
+    }
+    if (args.inputTokenAmount !== undefined &&
+        typeof args.inputTokenAmount === "number" &&
+        args.inputTokenAmount <= 0) {
+        errors.push({
+            code: "E_PARAM_INVALID",
+            message: "inputTokenAmount must be greater than 0."
+        });
+    }
+    if (args.outputTokenAmount !== undefined &&
+        typeof args.outputTokenAmount === "number" &&
+        args.outputTokenAmount <= 0) {
+        errors.push({
+            code: "E_PARAM_INVALID",
+            message: "outputTokenAmount must be greater than 0."
+        });
+    }
+    const maybeAddressKeys = ["inputTokenCA", "outputTokenCA"];
+    for (const key of maybeAddressKeys) {
+        const value = args[key];
+        if (value !== undefined && (0, utils_1.isNonEmptyString)(value) && !(0, utils_1.isLikelyTokenAddress)(value)) {
+            errors.push({
+                code: "E_PARAM_INVALID",
+                message: `${key} format is invalid.`
+            });
+        }
+    }
+    return errors;
+}
+exports.DMIND_3_NANO_PROFILE = {
+    id: "dmind-3-nano",
+    tools: {
+        SEARCH_TOKEN: {
+            strict: true,
+            parameters: {
+                symbol: { type: "string", nonEmpty: true },
+                address: { type: "string", nonEmpty: true },
+                chain: { type: "string", enum: CHAIN_VALUES, nonEmpty: true },
+                keyword: { type: "string", nonEmpty: true }
+            },
+            customValidate: validateSearchToken
+        },
+        EXECUTE_SWAP: {
+            strict: true,
+            parameters: {
+                inputTokenSymbol: { type: "string", required: true, nonEmpty: true },
+                inputTokenCA: { type: "string", nonEmpty: true },
+                outputTokenCA: { type: "string", nonEmpty: true },
+                inputTokenAmount: { type: "number" },
+                inputTokenPercentage: { type: "number", min: 0, max: 1 },
+                outputTokenAmount: { type: "number" }
+            },
+            customValidate: validateExecuteSwap
+        }
+    }
+};
+function toolNameSet(profile) {
+    return new Set(Object.keys(profile.tools));
+}
+//# sourceMappingURL=profiles.js.map

package/dist/profiles.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,2 @@
+import type { SDKCore, Message, RunLoopOptions, RunLoopResult } from "./types";
+export declare function runLoop(sdk: SDKCore, messages: Message[], options?: RunLoopOptions): Promise<RunLoopResult>;

package/dist/runtime.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runLoop = runLoop;
+function toParseError(raw, message) {
+    return {
+        type: "parse_error",
+        code: "E_INVOKE_COUNT",
+        message,
+        raw
+    };
+}
+async function runLoop(sdk, messages, options = {}) {
+    const mode = options.mode;
+    const maxToolHops = options.maxToolHops ?? 3;
+    const functionResponseRole = options.functionResponseRole ?? "user";
+    const history = [...messages];
+    let toolHops = 0;
+    while (true) {
+        const raw = await sdk.generate(history);
+        history.push({ role: "assistant", content: raw });
+        const parsed = sdk.parse(raw, mode);
+        if (parsed.type !== "tool_call") {
+            return { final: parsed, messages: history, toolHops };
+        }
+        if (toolHops >= maxToolHops) {
+            return {
+                final: toParseError(raw, `Tool call count exceeds maxToolHops=${maxToolHops}.`),
+                messages: history,
+                toolHops
+            };
+        }
+        const validation = sdk.validate(parsed);
+        if (!validation.ok) {
+            return {
+                final: {
+                    type: "parse_error",
+                    code: "E_PARAM_INVALID",
+                    message: validation.errors.join("; "),
+                    raw
+                },
+                messages: history,
+                toolHops
+            };
+        }
+        const result = await sdk.execute(parsed);
+        const payload = sdk.wrapResponse({ status: "ok", result });
+        history.push({
+            role: functionResponseRole,
+            content: payload
+        });
+        toolHops += 1;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":";;AAiBA,0BAsDC;AA/DD,SAAS,YAAY,CAAC,GAAW,EAAE,OAAe;IAChD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,gBAAgB;QACtB,OAAO;QACP,GAAG;KACJ,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,OAAO,CAC3B,GAAY,EACZ,QAAmB,EACnB,UAA0B,EAAE;IAE5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAC7C,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,MAAM,CAAC;IACpE,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAE9B,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEpC,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QACxD,CAAC;QAED,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;YAC5B,OAAO;gBACL,KAAK,EAAE,YAAY,CACjB,GAAG,EACH,uCAAuC,WAAW,GAAG,CACtD;gBACD,QAAQ,EAAE,OAAO;gBACjB,QAAQ;aACT,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,OAAO;gBACL,KAAK,EAAE;oBACL,IAAI,EAAE,aAAa;oBACnB,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;oBACrC,GAAG;iBACJ;gBACD,QAAQ,EAAE,OAAO;gBACjB,QAAQ;aACT,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QACH,QAAQ,IAAI,CAAC,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/sdk.d.ts

@@ -0,0 +1,22 @@
+import { Chat } from "./chat";
+import type { DMindOptions } from "./chat-types";
+import type { BasicValidationResult, DetailedValidationResult, SDKCore, Message, ParsedResult, ProtocolMode, ToolCallResult } from "./types";
+export declare class DMind implements SDKCore {
+    readonly chat: Chat;
+    private readonly _apiKey?;
+    private readonly _baseUrl?;
+    private readonly protocolMode;
+    private readonly modelGenerate?;
+    private readonly tools;
+    private readonly modelProfile;
+    private readonly allowedTools;
+    constructor(options?: DMindOptions);
+    get apiKey(): string | undefined;
+    get baseUrl(): string | undefined;
+    generate(messages: Message[]): Promise<string>;
+    parse(raw: string, mode?: ProtocolMode): ParsedResult;
+    validate(call: ToolCallResult): BasicValidationResult;
+    validateDetailed(call: ToolCallResult): DetailedValidationResult;
+    execute(call: ToolCallResult): Promise<any>;
+    wrapResponse(payload: any): string;
+}

package/dist/sdk.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DMind = void 0;
+const chat_1 = require("./chat");
+const constants_1 = require("./constants");
+const errors_1 = require("./errors");
+const parser_1 = require("./parser");
+const profiles_1 = require("./profiles");
+const validator_1 = require("./validator");
+class DMind {
+    constructor(options = {}) {
+        this._apiKey = options.apiKey;
+        this._baseUrl = options.baseUrl;
+        this.protocolMode = options.protocolMode ?? "official";
+        this.modelGenerate = options.modelGenerate;
+        this.tools = options.tools ?? {};
+        this.modelProfile = options.modelProfile ?? profiles_1.DMIND_3_NANO_PROFILE;
+        this.allowedTools = (0, profiles_1.toolNameSet)(this.modelProfile);
+        this.chat = new chat_1.Chat(options);
+    }
+    get apiKey() {
+        return this._apiKey;
+    }
+    get baseUrl() {
+        return this._baseUrl;
+    }
+    async generate(messages) {
+        if (!this.modelGenerate) {
+            throw new errors_1.SDKError("E_RUNTIME", "modelGenerate is not configured. Pass options.modelGenerate in constructor.");
+        }
+        return this.modelGenerate(messages);
+    }
+    parse(raw, mode = this.protocolMode) {
+        return (0, parser_1.parse)(raw, mode, { allowedTools: this.allowedTools });
+    }
+    validate(call) {
+        return (0, validator_1.validate)(call, this.modelProfile);
+    }
+    validateDetailed(call) {
+        return (0, validator_1.validateDetailed)(call, this.modelProfile);
+    }
+    async execute(call) {
+        const validation = (0, validator_1.validateDetailed)(call, this.modelProfile);
+        if (!validation.ok) {
+            throw new errors_1.SDKError(validation.errors[0].code, validation.errors.map((x) => `${x.code}: ${x.message}`).join("; "), validation.errors);
+        }
+        const handler = this.tools[call.tool];
+        if (!handler) {
+            throw new errors_1.SDKError("E_TOOL_UNKNOWN", `No tool executor registered for ${call.tool}.`);
+        }
+        return handler(call.args);
+    }
+    wrapResponse(payload) {
+        return `${constants_1.FUNCTION_RESPONSE_START}${JSON.stringify(payload)}${constants_1.FUNCTION_RESPONSE_END}`;
+    }
+}
+exports.DMind = DMind;
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":";;;AAAA,iCAA8B;AAE9B,2CAGqB;AACrB,qCAAoC;AACpC,qCAAiC;AACjC,yCAA+D;AAY/D,2CAAyD;AAEzD,MAAa,KAAK;IAWhB,YAAY,UAAwB,EAAE;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,UAAU,CAAC;QACvD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,+BAAoB,CAAC;QACjE,IAAI,CAAC,YAAY,GAAG,IAAA,sBAAW,EAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,IAAI,WAAI,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAmB;QAChC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,iBAAQ,CAChB,WAAW,EACX,6EAA6E,CAC9E,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,OAAqB,IAAI,CAAC,YAAY;QACvD,OAAO,IAAA,cAAK,EAAC,GAAG,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,QAAQ,CAAC,IAAoB;QAC3B,OAAO,IAAA,oBAAQ,EAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAED,gBAAgB,CAAC,IAAoB;QACnC,OAAO,IAAA,4BAAgB,EAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAoB;QAChC,MAAM,UAAU,GAAG,IAAA,4BAAgB,EAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,IAAI,iBAAQ,CAChB,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EACzB,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAClE,UAAU,CAAC,MAAM,CAClB,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,iBAAQ,CAChB,gBAAgB,EAChB,mCAAmC,IAAI,CAAC,IAAI,GAAG,CAChD,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,YAAY,CAAC,OAAY;QACvB,OAAO,GAAG,mCAAuB,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,iCAAqB,EAAE,CAAC;IACxF,CAAC;CACF;AA3ED,sBA2EC"}

package/dist/tool.d.ts

@@ -0,0 +1,47 @@
+import type { z } from "zod";
+import type { ToolDefinition } from "./chat-types";
+export interface ToolExecuteContext {
+    numberOfTurns: number;
+    toolCallId?: string;
+}
+export type ToolExecuteFn<TInput, TOutput> = (params: TInput, context?: ToolExecuteContext) => Promise<TOutput> | TOutput;
+export type ToolGeneratorFn<TInput, TOutput, TEvent> = (params: TInput, context?: ToolExecuteContext) => AsyncGenerator<TEvent, TOutput, unknown>;
+export interface Tool<TInput = unknown, TOutput = unknown, TEvent = never> {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: z.ZodType<TInput>;
+    readonly outputSchema?: z.ZodType<TOutput>;
+    readonly eventSchema?: z.ZodType<TEvent>;
+    readonly execute: ToolExecuteFn<TInput, TOutput> | ToolGeneratorFn<TInput, TOutput, TEvent> | false;
+    readonly type: "regular" | "generator" | "manual";
+    toDefinition(): ToolDefinition;
+    parseInput(raw: unknown): TInput;
+    implement<R = TOutput>(fn: ToolExecuteFn<TInput, R>): Tool<TInput, R, never>;
+}
+interface BaseToolConfig<TInput, TOutput> {
+    name: string;
+    description: string;
+    inputSchema: z.ZodType<TInput>;
+    outputSchema?: z.ZodType<TOutput>;
+    /** Hardcoded JSON Schema parameters for toDefinition(). When set, bypasses Zod toJSONSchema(). */
+    jsonSchemaParameters?: Record<string, unknown>;
+}
+export interface RegularToolConfig<TInput, TOutput> extends BaseToolConfig<TInput, TOutput> {
+    eventSchema?: undefined;
+    execute: ToolExecuteFn<TInput, TOutput>;
+}
+export interface GeneratorToolConfig<TInput, TOutput, TEvent> extends BaseToolConfig<TInput, TOutput> {
+    eventSchema: z.ZodType<TEvent>;
+    execute: ToolGeneratorFn<TInput, TOutput, TEvent>;
+}
+export interface ManualToolConfig<TInput, TOutput> extends BaseToolConfig<TInput, TOutput> {
+    execute: false;
+}
+export type ToolConfig<TInput, TOutput, TEvent = never> = RegularToolConfig<TInput, TOutput> | GeneratorToolConfig<TInput, TOutput, TEvent> | ManualToolConfig<TInput, TOutput>;
+export type InferToolInput<T> = T extends Tool<infer I, any, any> ? I : never;
+export type InferToolOutput<T> = T extends Tool<any, infer O, any> ? O : never;
+export type InferToolEvent<T> = T extends Tool<any, any, infer E> ? E : never;
+export declare function tool<TInput, TOutput>(config: RegularToolConfig<TInput, TOutput>): Tool<TInput, TOutput, never>;
+export declare function tool<TInput, TOutput, TEvent>(config: GeneratorToolConfig<TInput, TOutput, TEvent>): Tool<TInput, TOutput, TEvent>;
+export declare function tool<TInput, TOutput>(config: ManualToolConfig<TInput, TOutput>): Tool<TInput, TOutput, never>;
+export {};

package/dist/tool.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tool = tool;
+// ---------------------------------------------------------------------------
+// tool() factory
+// ---------------------------------------------------------------------------
+function buildDefinition(config) {
+    let parameters;
+    if (config.jsonSchemaParameters) {
+        parameters = config.jsonSchemaParameters;
+    }
+    else {
+        const jsonSchema = config.inputSchema.toJSONSchema?.();
+        const { $schema: _, ...rest } = jsonSchema ?? {};
+        parameters = rest;
+    }
+    return {
+        type: "function",
+        function: {
+            name: config.name,
+            description: config.description,
+            parameters,
+        },
+    };
+}
+function createTool(config) {
+    const resolvedType = config.execute === false
+        ? "manual"
+        : config.eventSchema
+            ? "generator"
+            : "regular";
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: config.inputSchema,
+        outputSchema: config.outputSchema,
+        eventSchema: config
+            .eventSchema,
+        execute: config.execute,
+        type: resolvedType,
+        toDefinition() {
+            return buildDefinition(config);
+        },
+        parseInput(raw) {
+            return config.inputSchema.parse(raw);
+        },
+        implement(fn) {
+            return createTool({
+                name: config.name,
+                description: config.description,
+                inputSchema: config.inputSchema,
+                jsonSchemaParameters: config.jsonSchemaParameters,
+                execute: fn,
+            });
+        },
+    };
+}
+function tool(config) {
+    return createTool(config);
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":";;AAsKA,oBAIC;AAnFD,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,SAAS,eAAe,CAAC,MAKxB;IACC,IAAI,UAAmC,CAAC;IAExC,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAChC,UAAU,GAAG,MAAM,CAAC,oBAAoB,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAI,MAAM,CAAC,WAAmB,CAAC,YAAY,EAAE,EAAE,CAAC;QAChE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,UAAU,IAAI,EAAE,CAAC;QACjD,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU;SACX;KACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,MAA2C;IAE3C,MAAM,YAAY,GAChB,MAAM,CAAC,OAAO,KAAK,KAAK;QACtB,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,MAAM,CAAC,WAAW;YAClB,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,SAAS,CAAC;IAElB,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,WAAW,EAAG,MAAuD;aAClE,WAAW;QACd,OAAO,EAAE,MAAM,CAAC,OAAc;QAC9B,IAAI,EAAE,YAAY;QAElB,YAAY;YACV,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QAED,UAAU,CAAC,GAAY;YACrB,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QAED,SAAS,CAAc,EAA4B;YACjD,OAAO,UAAU,CAAY;gBAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;gBACjD,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAWD,SAAgB,IAAI,CAClB,MAA2C;IAE3C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/tools/execute-swap.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export interface ExecuteSwapInput {
+    /** Symbol of the token being sold (e.g. SOL) */
+    inputTokenSymbol: string;
+    /** Contract address of the input token */
+    inputTokenCA?: string;
+    /** Contract address of the output token */
+    outputTokenCA?: string;
+    /** Absolute amount of input token to swap */
+    inputTokenAmount?: number;
+    /** Percentage of input token balance to swap (0.0–1.0) */
+    inputTokenPercentage?: number;
+    /** Minimum amount of output token expected */
+    outputTokenAmount?: number;
+}
+export declare const executeSwapInputSchema: z.ZodType<ExecuteSwapInput>;
+export declare const EXECUTE_SWAP: import("../tool").Tool<ExecuteSwapInput, unknown, never>;