@qvac/sdk 0.4.0 → 0.5.0

package/dist/utils/mcp-adapter.js

@@ -0,0 +1,103 @@
+import { mapValues } from "./object.js";
+const VALID_TYPES = [
+    "string",
+    "number",
+    "integer",
+    "boolean",
+    "object",
+    "array",
+];
+function isValidType(value) {
+    return typeof value === "string" && VALID_TYPES.includes(value);
+}
+function convertMcpToolToTool(mcpTool) {
+    const inputSchema = mcpTool.inputSchema;
+    const properties = inputSchema.properties ?? {};
+    const required = inputSchema.required ?? [];
+    const convertedProperties = mapValues(properties, (prop) => {
+        const { type, description, enum: enumVal } = prop;
+        return {
+            type: isValidType(type) ? type : "string",
+            ...(description && { description }),
+            ...(enumVal && { enum: enumVal }),
+        };
+    });
+    return {
+        type: "function",
+        name: mcpTool.name,
+        description: mcpTool.description ?? "",
+        parameters: {
+            type: "object",
+            properties: convertedProperties,
+            required: required.length > 0 ? required : undefined,
+        },
+    };
+}
+function createMcpToolHandler(client, toolName) {
+    return async (args) => {
+        return client.callTool({ name: toolName, arguments: args });
+    };
+}
+export async function getMcpToolsWithHandlers(clients) {
+    const allTools = [];
+    const handlers = new Map();
+    for (const { client, includeResources } of clients) {
+        const { tools: mcpTools } = await client.listTools();
+        for (const mcpTool of mcpTools) {
+            allTools.push(convertMcpToolToTool(mcpTool));
+            handlers.set(mcpTool.name, createMcpToolHandler(client, mcpTool.name));
+        }
+        if (includeResources !== false && client.listResources) {
+            allTools.push({
+                type: "function",
+                name: "list_resources",
+                description: "List available resources from MCP server",
+                parameters: {
+                    type: "object",
+                    properties: {},
+                },
+            });
+            handlers.set("list_resources", async () => {
+                if (!client.listResources) {
+                    return { resources: [] };
+                }
+                const result = await client.listResources();
+                return {
+                    type: "text",
+                    text: JSON.stringify(result.resources, null, 2),
+                };
+            });
+            if (client.readResource) {
+                allTools.push({
+                    type: "function",
+                    name: "read_resource",
+                    description: "Read content of a specific resource by URI",
+                    parameters: {
+                        type: "object",
+                        properties: {
+                            uri: {
+                                type: "string",
+                                description: "The URI of the resource to read",
+                            },
+                        },
+                        required: ["uri"],
+                    },
+                });
+                handlers.set("read_resource", async (args) => {
+                    if (!client.readResource) {
+                        return { error: "readResource not available" };
+                    }
+                    const result = await client.readResource({
+                        uri: args["uri"],
+                    });
+                    return result.contents[0];
+                });
+            }
+        }
+    }
+    return { tools: allTools, handlers };
+}
+export async function getMcpTools(clients) {
+    const { tools } = await getMcpToolsWithHandlers(clients);
+    return tools;
+}

package/dist/utils/object.d.ts

@@ -0,0 +1,2 @@
+export declare function mapValues<T, U>(obj: Record<string, T>, fn: (value: T, key: string) => U): Record<string, U>;
+//# sourceMappingURL=object.d.ts.map

package/dist/utils/object.js

@@ -0,0 +1,3 @@
+export function mapValues(obj, fn) {
+    return Object.fromEntries(Object.entries(obj).map(([key, value]) => [key, fn(value, key)]));
+}

package/dist/utils/runtime.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Runtime detection utilities
+ * Detects the current JavaScript runtime environment
+ */
+export type Runtime = "node" | "bare" | "expo" | "unknown";
+/**
+ * Check if running in Bare runtime
+ */
+export declare const isBare: () => boolean;
+/**
+ * Check if running in React Native/Expo
+ */
+export declare const isReactNative: () => boolean;
+/**
+ * Check if running in Node.js
+ */
+export declare const isNode: () => boolean;
+/**
+ * Detects the current runtime environment
+ *
+ * Detection order:
+ * 1. Bare - Check for global Bare object
+ * 2. React Native/Expo - Check navigator.product
+ * 3. Node.js - Check process.versions.node
+ * 4. Unknown - Fallback
+ *
+ * @returns The detected runtime type
+ */
+export declare const detectRuntime: () => Runtime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/utils/runtime.js

@@ -0,0 +1,48 @@
+/**
+ * Runtime detection utilities
+ * Detects the current JavaScript runtime environment
+ */
+/**
+ * Check if running in Bare runtime
+ */
+export const isBare = () => {
+    return typeof globalThis !== "undefined" && "Bare" in globalThis;
+};
+/**
+ * Check if running in React Native/Expo
+ */
+export const isReactNative = () => {
+    return (typeof navigator !== "undefined" &&
+        navigator.product === "ReactNative");
+};
+/**
+ * Check if running in Node.js
+ */
+export const isNode = () => {
+    return (typeof process !== "undefined" &&
+        process.versions !== undefined &&
+        process.versions.node !== undefined);
+};
+/**
+ * Detects the current runtime environment
+ *
+ * Detection order:
+ * 1. Bare - Check for global Bare object
+ * 2. React Native/Expo - Check navigator.product
+ * 3. Node.js - Check process.versions.node
+ * 4. Unknown - Fallback
+ *
+ * @returns The detected runtime type
+ */
+export const detectRuntime = () => {
+    if (isBare()) {
+        return "bare";
+    }
+    if (isReactNative()) {
+        return "expo";
+    }
+    if (isNode()) {
+        return "node";
+    }
+    return "unknown";
+};

package/dist/utils/tool-helpers.d.ts

@@ -1,10 +1,12 @@
 import type { z } from "zod";
-import { type Tool } from "../schemas/tools";
+import { type Tool, type ToolCall, type ToolCallWithCall } from "../schemas/tools";
 type ZodObjectType = z.ZodObject<z.ZodRawShape>;
+export type ToolHandler = (args: Record<string, unknown>) => Promise<unknown>;
 export type ToolInput<T extends ZodObjectType = ZodObjectType> = {
     name: string;
     description: string;
     parameters: T;
+    handler?: ToolHandler;
 };
 export declare function convertToolInput(input: ToolInput): Tool;
 export declare function convertTools(inputs: ToolInput[]): Tool[];
@@ -12,6 +14,12 @@ export declare function convertTools(inputs: ToolInput[]): Tool[];
  * Validates and converts tools from either ToolInput (with Zod schemas) or full Tool format.
  * Returns validated Tool[] array.
  */
-export declare function validateTools(tools: Tool[] | ToolInput[]): Tool[];
+export type ToolHandlerMap = Map<string, ToolHandler>;
+export type ValidateToolsResult = {
+    tools: Tool[];
+    handlers: ToolHandlerMap;
+};
+export declare function validateTools(tools: Tool[] | ToolInput[]): ValidateToolsResult;
+export declare function attachHandlersToToolCalls(toolCalls: ToolCall[], handlers: ToolHandlerMap): ToolCallWithCall[];
 export {};
 //# sourceMappingURL=tool-helpers.d.ts.map

package/dist/utils/tool-helpers.js

@@ -1,4 +1,4 @@
-import { toolSchema } from "../schemas/tools.js";
+import { toolSchema, } from "../schemas/tools.js";
 import { InvalidToolsArrayError, InvalidToolSchemaError, } from "./errors-client.js";
 function zodTypeToJsonSchemaType(type) {
     switch (type) {
@@ -66,22 +66,17 @@ export function convertToolInput(input) {
 export function convertTools(inputs) {
     return inputs.map(convertToolInput);
 }
-/**
- * Validates and converts tools from either ToolInput (with Zod schemas) or full Tool format.
- * Returns validated Tool[] array.
- */
 export function validateTools(tools) {
     if (tools.length === 0) {
-        return [];
+        return { tools: [], handlers: new Map() };
     }
     const firstTool = tools[0];
     if (!firstTool) {
         throw new InvalidToolsArrayError();
     }
-    // Try to validate as full Tool format first
+    const handlers = new Map();
     const parseResult = toolSchema.safeParse(firstTool);
     if (parseResult.success) {
-        // It's already in full Tool format - validate all tools
         const validatedTools = [];
         for (const tool of tools) {
             const result = toolSchema.safeParse(tool);
@@ -90,10 +85,28 @@ export function validateTools(tools) {
             }
             validatedTools.push(result.data);
         }
-        return validatedTools;
+        return { tools: validatedTools, handlers };
     }
     else {
-        // It's ToolInput format with Zod schemas - convert them
-        return convertTools(tools);
+        const toolInputs = tools;
+        const convertedTools = convertTools(toolInputs);
+        for (const toolInput of toolInputs) {
+            if (toolInput.handler) {
+                handlers.set(toolInput.name, toolInput.handler);
+            }
+        }
+        return { tools: convertedTools, handlers };
     }
 }
+export function attachHandlersToToolCalls(toolCalls, handlers) {
+    return toolCalls.map((toolCall) => {
+        const handler = handlers.get(toolCall.name);
+        if (handler) {
+            return {
+                ...toolCall,
+                invoke: async () => await handler(toolCall.arguments),
+            };
+        }
+        return toolCall;
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/sdk",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -29,7 +29,7 @@
     "!**/package-lock.json",
     "!**/yarn.lock",
     "!**/pnpm-lock.yaml",
-    "!**/bun.lockb"
+    "!**/bun.lock"
   ],
   "scripts": {
     "lint": "eslint . --max-warnings=0 && bun run typecheck",
@@ -50,20 +50,25 @@
     "docs_api:website": "typedoc --out ./docs/api/website --entryPoints index.ts --entryPointStrategy expand --readme none",
     "docs_api:markdown": "typedoc --plugin typedoc-plugin-markdown --out ./docs/api/markdown --entryPoints index.ts --entryPointStrategy expand --readme none && sed -i '1,4d' ./docs/api/markdown/README.md",
     "docs_api": "bun run docs_api:website && bun run docs_api:markdown",
-    "update-models": "node ./scripts/update-models.js"
+    "check-models": "node ./scripts/update-models.js --check",
+    "check-models:hook": "node ./scripts/update-models.js --check --non-blocking",
+    "update-models": "node ./scripts/update-models.js",
+    "changelog:generate": "node ./scripts/changelog-generate.cjs && prettier --write changelog",
+    "docs:gen-pages": "remark \"docs/*.mdx\" --output .docs-build",
+    "docs:gen-api": "typedoc --options docs/typedoc.jsonc"
   },
   "dependencies": {
-    "@qvac/decoder-audio": "^0.1.0",
-    "@qvac/dl-filesystem": "^0.1.1",
-    "@qvac/embed-llamacpp": "^0.6.2",
+    "@qvac/decoder-audio": "^0.3.0",
+    "@qvac/dl-filesystem": "^0.1.2",
+    "@qvac/embed-llamacpp": "^0.7.5",
     "@qvac/error": "^0.1.0",
     "@qvac/langdetect-text": "^0.1.0",
-    "@qvac/llm-llamacpp": "^0.4.5",
+    "@qvac/llm-llamacpp": "^0.5.6",
     "@qvac/logging": "^0.1.0",
     "@qvac/rag": "^0.2.1",
-    "@qvac/transcription-whispercpp": "0.2.0",
-    "@qvac/translation-nmtcpp": "0.1.6",
-    "@qvac/tts-onnx": "^0.2.5",
+    "@qvac/transcription-whispercpp": "^0.3.8",
+    "@qvac/translation-nmtcpp": "^0.1.13",
+    "@qvac/tts-onnx": "^0.2.8",
     "fast-safe-stringify": "2.1.1",
     "zod": "^4.0.17"
   },
@@ -71,55 +76,65 @@
     "@eslint/js": "^9.33.0",
     "@expo/config-plugins": "^54.0.1",
     "@lancedb/lancedb": "^0.21.3",
+    "@modelcontextprotocol/sdk": "^1.12.1",
     "@sqliteai/sqlite-wasm": "3.50.4-sync.0.8.30-vector.0.9.23",
     "@types/node": "^24.2.1",
-    "bare-pack": "^1.4.2",
-    "bare-readline": "^1.1.0",
+    "bare-pack": "^1.5.1",
+    "bare-readline": "^1.2.0",
     "chromadb": "^3.0.14",
-    "expo": "^54.0.0",
     "eslint": "^9.33.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.30.0",
     "eslint-plugin-react": "^7.37.5",
+    "expo": "^54.0.0",
+    "expo-file-system": "^19.0.15",
     "globals": "^16.3.0",
     "husky": "^9.1.7",
     "hyperdb": "^4.16.1",
     "prettier": "^3.6.2",
+    "react-native-bare-kit": "^0.11.4",
+    "remark-cli": "^12.0.1",
+    "remark-code-import": "^1.2.0",
+    "remark-frontmatter": "^5.0.0",
+    "remark-mdx": "^3.1.1",
     "typedoc": "^0.28.11",
+    "typedoc-plugin-frontmatter": "^1.3.1",
     "typedoc-plugin-markdown": "^4.8.1",
     "typescript": "^5.9.2",
-    "typescript-eslint": "^8.39.0",
-    "expo-file-system": "^19.0.15",
-    "react-native-bare-kit": "^0.9.3"
+    "typescript-eslint": "^8.39.0"
   },
   "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
     "bare-abort-controller": "^1.0.0",
-    "bare-buffer": "^3.3.0",
-    "bare-crypto": "^1.9.2",
-    "bare-dns": "^2.1.2",
+    "bare-buffer": "^3.4.2",
+    "bare-crypto": "^1.11.2",
+    "bare-dns": "^2.1.4",
     "bare-fetch": "^2.5.1",
-    "bare-fs": "^4.1.6",
-    "bare-https": "^2.1.1",
+    "bare-fs": "^4.5.2",
     "bare-http1": "^4.1.6",
-    "bare-link": "^1.5.0",
-    "bare-net": "^2.0.1",
-    "bare-os": "^3.6.1",
+    "bare-https": "^2.1.1",
+    "bare-link": "^2.1.10",
+    "bare-net": "^2.2.0",
+    "bare-os": "^3.6.2",
     "bare-path": "^3.0.0",
-    "bare-process": "^4.2.1",
-    "bare-rpc": "^0.2.11",
-    "bare-runtime": "^1.24.1",
-    "bare-stream": "^2.6.5",
-    "bare-subprocess": "^5.1.1",
+    "bare-process": "^4.2.2",
+    "bare-rpc": "^1.0.0",
+    "bare-runtime": "^1.24.2",
+    "bare-stream": "^2.7.0",
+    "bare-subprocess": "^5.2.1",
     "corestore": "^7.4.5",
     "events": "^3.3.0",
+    "expo-file-system": "^19.0.15",
     "hyperdb": "^4.19.0",
     "hyperdrive": "^13.0.1",
     "hyperswarm": "^4.12.1",
-    "expo-file-system": "^19.0.15",
     "llm-splitter": "~0.2.0",
-    "react-native-bare-kit": "^0.10.4"
+    "react-native-bare-kit": "^0.11.4"
   },
   "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
     "expo-file-system": {
       "optional": true
     },
@@ -127,7 +142,5 @@
       "optional": true
     }
   },
-  "patchedDependencies": {
-    "bare-rpc@0.2.11": "patches/bare-rpc@0.2.11.patch"
-  }
+  "patchedDependencies": {}
 }

package/dist/client/api/set-config.d.ts

@@ -1,7 +0,0 @@
-import { type SDKConfig } from "../../schemas/index";
-export declare const setConfig: (config: SDKConfig) => Promise<{
-    type: "setConfig";
-    success: boolean;
-    error?: string | undefined;
-}>;
-//# sourceMappingURL=set-config.d.ts.map

package/dist/client/api/set-config.js

@@ -1,20 +0,0 @@
-import {} from "../../schemas/index.js";
-import { send } from "../rpc/rpc-client.js";
-import { setCachedConfig } from "../config-manager.js";
-import { InvalidResponseError, SetConfigFailedError, } from "../../utils/errors-client.js";
-export const setConfig = async (config) => {
-    // Cache config client-side for automatic replay on worker restart
-    setCachedConfig(config);
-    const request = {
-        type: "setConfig",
-        config,
-    };
-    const response = await send(request);
-    if (response.type !== "setConfig") {
-        throw new InvalidResponseError("setConfig");
-    }
-    if (!response.success) {
-        throw new SetConfigFailedError(response.error);
-    }
-    return response;
-};

package/dist/client/config-manager.d.ts

@@ -1,4 +0,0 @@
-import type { SDKConfig } from "../schemas/index";
-export declare const setCachedConfig: (config: SDKConfig) => void;
-export declare const getCachedConfig: () => SDKConfig;
-//# sourceMappingURL=config-manager.d.ts.map

package/dist/client/config-manager.js

@@ -1,8 +0,0 @@
-let cachedConfig;
-export const setCachedConfig = (config) => {
-    cachedConfig = config;
-    console.log("📦 Config cached client-side:", config);
-};
-export const getCachedConfig = () => {
-    return cachedConfig;
-};

package/dist/examples/llamacpp-file-logging.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=llamacpp-file-logging.d.ts.map

package/dist/schemas/set-config.d.ts

@@ -1,21 +0,0 @@
-import { z } from "zod";
-export declare const sdkConfigSchema: z.ZodObject<{
-    cacheDirectory: z.ZodOptional<z.ZodString>;
-    swarmRelays: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export declare const setConfigRequestSchema: z.ZodObject<{
-    type: z.ZodLiteral<"setConfig">;
-    config: z.ZodObject<{
-        cacheDirectory: z.ZodOptional<z.ZodString>;
-        swarmRelays: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-export declare const setConfigResponseSchema: z.ZodObject<{
-    type: z.ZodLiteral<"setConfig">;
-    success: z.ZodBoolean;
-    error: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type SDKConfig = z.infer<typeof sdkConfigSchema>;
-export type SetConfigRequest = z.infer<typeof setConfigRequestSchema>;
-export type SetConfigResponse = z.infer<typeof setConfigResponseSchema>;
-//# sourceMappingURL=set-config.d.ts.map

package/dist/schemas/set-config.js

@@ -1,14 +0,0 @@
-import { z } from "zod";
-export const sdkConfigSchema = z.object({
-    cacheDirectory: z.string().optional(),
-    swarmRelays: z.array(z.string()).optional(),
-});
-export const setConfigRequestSchema = z.object({
-    type: z.literal("setConfig"),
-    config: sdkConfigSchema,
-});
-export const setConfigResponseSchema = z.object({
-    type: z.literal("setConfig"),
-    success: z.boolean(),
-    error: z.string().optional(),
-});

package/dist/server/rpc/handlers/set-config.d.ts

@@ -1,3 +0,0 @@
-import type { SetConfigRequest, SetConfigResponse } from "../../../schemas/index";
-export declare const handleSetConfig: (request: SetConfigRequest) => SetConfigResponse;
-//# sourceMappingURL=set-config.d.ts.map

package/dist/server/rpc/handlers/set-config.js

@@ -1,18 +0,0 @@
-import { setSDKConfig } from "../../bare/registry/config-registry.js";
-export const handleSetConfig = (request) => {
-    try {
-        setSDKConfig(request.config);
-        return {
-            type: "setConfig",
-            success: true,
-        };
-    }
-    catch (error) {
-        console.error("Error setting config:", error);
-        return {
-            type: "setConfig",
-            success: false,
-            error: error instanceof Error ? error.message : "Unknown error",
-        };
-    }
-};