@dmindai/sdk 0.1.0

package/README.md

@@ -0,0 +1,145 @@
+# DMind SDK
+
+TypeScript SDK for the [DMind AI](https://huggingface.co/DMindAI/DMind-3-nano) platform — chat completions with built-in crypto trading tools.
+
+## Installation
+
+```bash
+npm install @dmindai/sdk
+```
+
+## Quick Start
+
+```ts
+import {
+  DMind,
+  SEARCH_TOKEN,
+  EXECUTE_SWAP,
+  type SearchTokenInput,
+  type ExecuteSwapInput,
+} from "@dmindai/sdk";
+
+// 1. Implement the two built-in tools with your own backend logic
+//    params is fully typed — IDE will auto-complete all fields from SearchTokenInput / ExecuteSwapInput
+
+const searchToken = SEARCH_TOKEN.implement(async (params: SearchTokenInput) => {
+  const tokens = await myTokenService.search(params);
+  return { tokens };
+});
+
+const executeSwap = EXECUTE_SWAP.implement(async (params: ExecuteSwapInput) => {
+  const result = await myDexService.buildSwap(params);
+  return { transaction: result.transaction, quote: result.quote };
+});
+
+// 2. Create the DMind client
+
+const dmind = new DMind({
+  baseUrl: "http://localhost:8000/v1", // vLLM local server
+  apiKey: "your-api-key", // optional
+});
+
+// 3. Send a chat request with tool definitions
+
+const response = await dmind.chat.send({
+  messages: [{ role: "user", content: "Swap 1 SOL to USDC on Solana" }],
+  model: "dmind-3-nano",
+  tools: [searchToken.toDefinition(), executeSwap.toDefinition()],
+  toolChoice: "auto",
+});
+
+// 4. Handle the tool call
+
+const toolCall = response.choices[0].message.toolCalls?.[0];
+if (toolCall) {
+  const args = searchToken.parseInput(JSON.parse(toolCall.function.arguments));
+  console.log("Tool called:", toolCall.function.name, args);
+}
+```
+
+## Built-in Tools
+
+The SDK provides two fixed tools matching the [DMind-3-nano model card](https://huggingface.co/DMindAI/DMind-3-nano#tool-definitions--schemas). Their names, descriptions, and parameter schemas cannot be modified.
+
+### SEARCH_TOKEN
+
+Search for a cryptocurrency token on-chain to retrieve its metadata or address.
+
+| Parameter | Type   | Required | Description                                            |
+| --------- | ------ | -------- | ------------------------------------------------------ |
+| symbol    | string | No       | Token ticker symbol (e.g. `SOL`, `USDC`)               |
+| address   | string | No       | Contract address of the token                          |
+| chain     | string | No       | Target blockchain: `solana`, `ethereum`, `bsc`, `base` |
+| keyword   | string | No       | Free-text search keywords                              |
+
+### EXECUTE_SWAP
+
+Propose a token swap transaction.
+
+| Parameter            | Type   | Required | Description                             |
+| -------------------- | ------ | -------- | --------------------------------------- |
+| inputTokenSymbol     | string | Yes      | Symbol of the token being sold          |
+| inputTokenCA         | string | No       | Contract address of the input token     |
+| outputTokenCA        | string | No       | Contract address of the output token    |
+| inputTokenAmount     | number | No       | Absolute amount to swap                 |
+| inputTokenPercentage | number | No       | Percentage of balance to swap (0.0–1.0) |
+| outputTokenAmount    | number | No       | Minimum output amount expected          |
+
+### Using Tools Without Execute Logic
+
+The tools can also be used directly without `implement()` — for schema definitions and input parsing only:
+
+```ts
+import { SEARCH_TOKEN, EXECUTE_SWAP } from "@dmindai/sdk";
+
+// Get the fixed JSON schema for the chat API
+const tools = [SEARCH_TOKEN.toDefinition(), EXECUTE_SWAP.toDefinition()];
+
+// Parse and validate raw tool call arguments
+const args = SEARCH_TOKEN.parseInput({ symbol: "SOL", chain: "solana" });
+```
+
+## Streaming
+
+```ts
+const stream = await dmind.chat.send({
+  messages: [{ role: "user", content: "Find the USDC token on Ethereum" }],
+  model: "dmind-3-nano",
+  tools: [searchToken.toDefinition()],
+  stream: true,
+});
+
+for await (const chunk of stream) {
+  process.stdout.write(chunk.choices[0].delta.content ?? "");
+}
+```
+
+## Multi-turn Tool Loop
+
+For automated multi-turn conversations with tool execution:
+
+```ts
+import { DMind, runLoop } from "@dmindai/sdk";
+
+const dmind = new DMind({
+  modelGenerate: async (messages) => {
+    // call your model inference here
+    return modelResponse;
+  },
+  tools: {
+    SEARCH_TOKEN: async (args) => {
+      return await myTokenService.search(args);
+    },
+    EXECUTE_SWAP: async (args) => {
+      return await myDexService.buildSwap(args);
+    },
+  },
+});
+
+const result = await runLoop(dmind, [
+  { role: "user", content: "Swap 0.5 SOL to USDC" },
+]);
+
+console.log(result.final); // final parsed result
+console.log(result.toolHops); // number of tool calls executed
+```

package/dist/chat-types.d.ts

@@ -0,0 +1,137 @@
+export interface ContentPartText {
+    type: "text";
+    text: string;
+}
+export interface ContentPartImage {
+    type: "image_url";
+    imageUrl: {
+        url: string;
+        detail?: "auto" | "low" | "high";
+    };
+}
+export type ContentPart = ContentPartText | ContentPartImage;
+export interface SystemMessage {
+    role: "system";
+    content: string;
+    name?: string;
+}
+export interface UserMessage {
+    role: "user";
+    content: string | ContentPart[];
+    name?: string;
+}
+export interface ChatAssistantMessage {
+    role: "assistant";
+    content?: string | null;
+    toolCalls?: ChatToolCall[];
+    reasoning?: string | null;
+    refusal?: string | null;
+}
+export interface ChatToolMessage {
+    role: "tool";
+    toolCallId: string;
+    content: string;
+}
+export type ChatMessage = SystemMessage | UserMessage | ChatAssistantMessage | ChatToolMessage;
+export interface ChatToolCallFunction {
+    name: string;
+    arguments: string;
+}
+export interface ChatToolCall {
+    id: string;
+    type: "function";
+    function: ChatToolCallFunction;
+}
+export interface ToolFunctionDefinition {
+    name: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+    strict?: boolean;
+}
+export interface ToolDefinition {
+    type: "function";
+    function: ToolFunctionDefinition;
+}
+export type ToolChoiceOption = "auto" | "none" | "required" | {
+    type: "function";
+    function: {
+        name: string;
+    };
+};
+export interface ChatRequest {
+    messages: ChatMessage[];
+    model?: string;
+    stream?: boolean;
+    temperature?: number;
+    maxTokens?: number;
+    maxCompletionTokens?: number;
+    topP?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+    stop?: string | string[];
+    seed?: number;
+    tools?: ToolDefinition[];
+    toolChoice?: ToolChoiceOption;
+    parallelToolCalls?: boolean;
+    responseFormat?: {
+        type: "text" | "json_object";
+    };
+}
+export interface TokenUsage {
+    completionTokens: number;
+    promptTokens: number;
+    totalTokens: number;
+}
+export interface ChatResponseChoice {
+    index: number;
+    message: ChatAssistantMessage;
+    finishReason: string | null;
+}
+export interface ChatResponse {
+    id: string;
+    object: "chat.completion";
+    created: number;
+    model: string;
+    choices: ChatResponseChoice[];
+    usage?: TokenUsage;
+}
+export interface ChatStreamingToolCall {
+    index: number;
+    id?: string;
+    type?: "function";
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+}
+export interface ChatStreamingDelta {
+    role?: "assistant";
+    content?: string | null;
+    toolCalls?: ChatStreamingToolCall[];
+    reasoning?: string | null;
+    refusal?: string | null;
+}
+export interface ChatStreamingChoice {
+    index: number;
+    delta: ChatStreamingDelta;
+    finishReason: string | null;
+}
+export interface ChatStreamingChunk {
+    id: string;
+    object: "chat.completion.chunk";
+    created: number;
+    model: string;
+    choices: ChatStreamingChoice[];
+    usage?: TokenUsage;
+}
+import type { ModelGenerate, ModelProfile, ProtocolMode, ToolHandlers } from "./types";
+export interface DMindOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    defaultHeaders?: Record<string, string>;
+    protocolMode?: ProtocolMode;
+    modelGenerate?: ModelGenerate;
+    tools?: ToolHandlers;
+    modelProfile?: ModelProfile;
+}

package/dist/chat-types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Message types
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=chat-types.js.map

package/dist/chat-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-types.js","sourceRoot":"","sources":["../src/chat-types.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E"}

package/dist/chat.d.ts

@@ -0,0 +1,16 @@
+import { type ChatRequest, type ChatResponse, type ChatStreamingChunk, type DMindOptions } from "./chat-types";
+export declare class Chat {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModel?;
+    private readonly defaultHeaders;
+    /** @internal Created internally by the DMind constructor. */
+    constructor(options: DMindOptions);
+    send(request: ChatRequest & {
+        stream?: false;
+    }): Promise<ChatResponse>;
+    send(request: ChatRequest & {
+        stream: true;
+    }): Promise<AsyncIterable<ChatStreamingChunk>>;
+    send(request: ChatRequest): Promise<ChatResponse | AsyncIterable<ChatStreamingChunk>>;
+}

package/dist/chat.js

@@ -0,0 +1,286 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Chat = void 0;
+const errors_1 = require("./errors");
+// ---------------------------------------------------------------------------
+// camelCase -> snake_case request serialization
+// ---------------------------------------------------------------------------
+function serializeContentPart(part) {
+    if (part.type === "text") {
+        return { type: "text", text: part.text };
+    }
+    return {
+        type: "image_url",
+        image_url: { url: part.imageUrl.url, detail: part.imageUrl.detail },
+    };
+}
+function serializeToolCall(tc) {
+    return {
+        id: tc.id,
+        type: tc.type,
+        function: { name: tc.function.name, arguments: tc.function.arguments },
+    };
+}
+function serializeMessage(msg) {
+    switch (msg.role) {
+        case "system":
+            return { role: "system", content: msg.content, ...(msg.name && { name: msg.name }) };
+        case "user": {
+            const content = typeof msg.content === "string"
+                ? msg.content
+                : msg.content.map(serializeContentPart);
+            return { role: "user", content, ...(msg.name && { name: msg.name }) };
+        }
+        case "assistant": {
+            const out = { role: "assistant" };
+            if (msg.content !== undefined)
+                out.content = msg.content;
+            if (msg.toolCalls?.length)
+                out.tool_calls = msg.toolCalls.map(serializeToolCall);
+            if (msg.reasoning !== undefined)
+                out.reasoning = msg.reasoning;
+            if (msg.refusal !== undefined)
+                out.refusal = msg.refusal;
+            return out;
+        }
+        case "tool":
+            return { role: "tool", tool_call_id: msg.toolCallId, content: msg.content };
+    }
+}
+function serializeToolDef(def) {
+    return {
+        type: def.type,
+        function: {
+            name: def.function.name,
+            ...(def.function.description && { description: def.function.description }),
+            ...(def.function.parameters && { parameters: def.function.parameters }),
+            ...(def.function.strict !== undefined && { strict: def.function.strict }),
+        },
+    };
+}
+function serializeToolChoice(choice) {
+    if (typeof choice === "string")
+        return choice;
+    return { type: choice.type, function: { name: choice.function.name } };
+}
+function buildRequestBody(request, defaultModel) {
+    const body = {
+        messages: request.messages.map(serializeMessage),
+    };
+    const model = request.model ?? defaultModel;
+    if (model)
+        body.model = model;
+    if (request.stream !== undefined)
+        body.stream = request.stream;
+    if (request.temperature !== undefined)
+        body.temperature = request.temperature;
+    if (request.maxTokens !== undefined)
+        body.max_tokens = request.maxTokens;
+    if (request.maxCompletionTokens !== undefined)
+        body.max_completion_tokens = request.maxCompletionTokens;
+    if (request.topP !== undefined)
+        body.top_p = request.topP;
+    if (request.frequencyPenalty !== undefined)
+        body.frequency_penalty = request.frequencyPenalty;
+    if (request.presencePenalty !== undefined)
+        body.presence_penalty = request.presencePenalty;
+    if (request.stop !== undefined)
+        body.stop = request.stop;
+    if (request.seed !== undefined)
+        body.seed = request.seed;
+    if (request.tools?.length)
+        body.tools = request.tools.map(serializeToolDef);
+    if (request.toolChoice !== undefined)
+        body.tool_choice = serializeToolChoice(request.toolChoice);
+    if (request.parallelToolCalls !== undefined)
+        body.parallel_tool_calls = request.parallelToolCalls;
+    if (request.responseFormat !== undefined)
+        body.response_format = request.responseFormat;
+    return body;
+}
+// ---------------------------------------------------------------------------
+// snake_case -> camelCase response deserialization
+// ---------------------------------------------------------------------------
+function parseToolCall(raw) {
+    return {
+        id: raw.id,
+        type: raw.type ?? "function",
+        function: { name: raw.function.name, arguments: raw.function.arguments },
+    };
+}
+function parseAssistantMessage(raw) {
+    const msg = { role: "assistant" };
+    if (raw.content !== undefined)
+        msg.content = raw.content;
+    if (raw.tool_calls?.length)
+        msg.toolCalls = raw.tool_calls.map(parseToolCall);
+    if (raw.reasoning !== undefined)
+        msg.reasoning = raw.reasoning;
+    if (raw.refusal !== undefined)
+        msg.refusal = raw.refusal;
+    return msg;
+}
+function parseUsage(raw) {
+    if (!raw)
+        return undefined;
+    return {
+        completionTokens: raw.completion_tokens ?? 0,
+        promptTokens: raw.prompt_tokens ?? 0,
+        totalTokens: raw.total_tokens ?? 0,
+    };
+}
+function parseChoice(raw) {
+    return {
+        index: raw.index ?? 0,
+        message: parseAssistantMessage(raw.message ?? {}),
+        finishReason: raw.finish_reason ?? null,
+    };
+}
+function parseChatResponse(raw) {
+    return {
+        id: raw.id ?? "",
+        object: "chat.completion",
+        created: raw.created ?? 0,
+        model: raw.model ?? "",
+        choices: (raw.choices ?? []).map(parseChoice),
+        usage: parseUsage(raw.usage),
+    };
+}
+function parseStreamingToolCall(raw) {
+    const tc = { index: raw.index ?? 0 };
+    if (raw.id !== undefined)
+        tc.id = raw.id;
+    if (raw.type !== undefined)
+        tc.type = raw.type;
+    if (raw.function) {
+        tc.function = {};
+        if (raw.function.name !== undefined)
+            tc.function.name = raw.function.name;
+        if (raw.function.arguments !== undefined)
+            tc.function.arguments = raw.function.arguments;
+    }
+    return tc;
+}
+function parseStreamingDelta(raw) {
+    const delta = {};
+    if (raw.role !== undefined)
+        delta.role = raw.role;
+    if (raw.content !== undefined)
+        delta.content = raw.content;
+    if (raw.tool_calls?.length)
+        delta.toolCalls = raw.tool_calls.map(parseStreamingToolCall);
+    if (raw.reasoning !== undefined)
+        delta.reasoning = raw.reasoning;
+    if (raw.refusal !== undefined)
+        delta.refusal = raw.refusal;
+    return delta;
+}
+function parseStreamingChoice(raw) {
+    return {
+        index: raw.index ?? 0,
+        delta: parseStreamingDelta(raw.delta ?? {}),
+        finishReason: raw.finish_reason ?? null,
+    };
+}
+function parseStreamingChunk(raw) {
+    return {
+        id: raw.id ?? "",
+        object: "chat.completion.chunk",
+        created: raw.created ?? 0,
+        model: raw.model ?? "",
+        choices: (raw.choices ?? []).map(parseStreamingChoice),
+        usage: parseUsage(raw.usage),
+    };
+}
+// ---------------------------------------------------------------------------
+// SSE async iterator
+// ---------------------------------------------------------------------------
+async function* parseSSEStream(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith(":"))
+                    continue;
+                if (trimmed.startsWith("data:")) {
+                    const payload = trimmed.slice("data:".length).trim();
+                    if (payload === "[DONE]")
+                        return;
+                    try {
+                        yield parseStreamingChunk(JSON.parse(payload));
+                    }
+                    catch {
+                        // skip malformed JSON chunks
+                    }
+                }
+            }
+        }
+        if (buffer.trim().startsWith("data:")) {
+            const payload = buffer.trim().slice("data:".length).trim();
+            if (payload && payload !== "[DONE]") {
+                try {
+                    yield parseStreamingChunk(JSON.parse(payload));
+                }
+                catch {
+                    // skip
+                }
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+// ---------------------------------------------------------------------------
+// Chat class
+// ---------------------------------------------------------------------------
+class Chat {
+    /** @internal Created internally by the DMind constructor. */
+    constructor(options) {
+        this.apiKey = options.apiKey ?? "";
+        this.baseUrl = (options.baseUrl ?? "").replace(/\/+$/, "");
+        this.defaultModel = options.defaultModel;
+        this.defaultHeaders = options.defaultHeaders ?? {};
+    }
+    async send(request) {
+        const body = buildRequestBody(request, this.defaultModel);
+        const response = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+                ...this.defaultHeaders,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            let detail;
+            try {
+                detail = await response.json();
+            }
+            catch {
+                detail = await response.text().catch(() => null);
+            }
+            throw new errors_1.SDKError("E_RUNTIME", `Chat API returned ${response.status}: ${response.statusText}`, detail);
+        }
+        if (request.stream) {
+            if (!response.body) {
+                throw new errors_1.SDKError("E_RUNTIME", "Streaming response has no body.");
+            }
+            return parseSSEStream(response.body);
+        }
+        const json = await response.json();
+        return parseChatResponse(json);
+    }
+}
+exports.Chat = Chat;
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const OFFICIAL_START = "<start_function_call>";
+export declare const OFFICIAL_END = "<end_function_call>";
+export declare const LEGACY_START = "<function_calls>";
+export declare const LEGACY_END = "</function_calls>";
+export declare const FUNCTION_RESPONSE_START = "<function_response>";
+export declare const FUNCTION_RESPONSE_END = "</function_response>";

package/dist/constants.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FUNCTION_RESPONSE_END = exports.FUNCTION_RESPONSE_START = exports.LEGACY_END = exports.LEGACY_START = exports.OFFICIAL_END = exports.OFFICIAL_START = void 0;
+exports.OFFICIAL_START = "<start_function_call>";
+exports.OFFICIAL_END = "<end_function_call>";
+exports.LEGACY_START = "<function_calls>";
+exports.LEGACY_END = "</function_calls>";
+exports.FUNCTION_RESPONSE_START = "<function_response>";
+exports.FUNCTION_RESPONSE_END = "</function_response>";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG,uBAAuB,CAAC;AACzC,QAAA,YAAY,GAAG,qBAAqB,CAAC;AACrC,QAAA,YAAY,GAAG,kBAAkB,CAAC;AAClC,QAAA,UAAU,GAAG,mBAAmB,CAAC;AACjC,QAAA,uBAAuB,GAAG,qBAAqB,CAAC;AAChD,QAAA,qBAAqB,GAAG,sBAAsB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+export type SDKErrorCode = "E_NO_WRAPPER" | "E_WRONG_PROTOCOL" | "E_JSON_INVALID" | "E_TOOL_UNKNOWN" | "E_PARAM_MISSING" | "E_PARAM_FORBIDDEN" | "E_PARAM_INVALID" | "E_INVOKE_COUNT" | "E_RUNTIME";
+export interface ValidationIssue {
+    code: SDKErrorCode;
+    message: string;
+}
+export declare class SDKError extends Error {
+    readonly code: SDKErrorCode;
+    readonly details?: unknown;
+    constructor(code: SDKErrorCode, message: string, details?: unknown);
+}

package/dist/errors.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDKError = void 0;
+class SDKError extends Error {
+    constructor(code, message, details) {
+        super(message);
+        this.name = "SDKError";
+        this.code = code;
+        this.details = details;
+    }
+}
+exports.SDKError = SDKError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAgBA,MAAa,QAAS,SAAQ,KAAK;IAIjC,YAAY,IAAkB,EAAE,OAAe,EAAE,OAAiB;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAVD,4BAUC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./chat-types";
+export * from "./chat";
+export * from "./constants";
+export * from "./errors";
+export * from "./parser";
+export * from "./profiles";
+export * from "./runtime";
+export * from "./sdk";
+export * from "./tool";
+export * from "./tools";
+export * from "./types";
+export * from "./validator";