@qvac/sdk 0.10.0 → 0.10.2

package/NOTICE

@@ -489,8 +489,6 @@ JavaScript Dependencies
 
   @hyperswarm/secret-stream@6.9.1
     https://github.com/holepunchto/hyperswarm-secret-stream
-  @qvac/decoder-audio@0.3.6
-    https://github.com/tetherto/qvac
   @qvac/decoder-audio@0.3.7
     https://github.com/tetherto/qvac
   @qvac/diagnostics@0.1.1
@@ -502,8 +500,6 @@ JavaScript Dependencies
     https://github.com/tetherto/qvac
   @qvac/error@0.1.1
   @qvac/infer-base@0.1.1
-  @qvac/infer-base@0.4.0
-    https://github.com/tetherto/qvac
   @qvac/infer-base@0.4.1
     https://github.com/tetherto/qvac
   @qvac/langdetect-text@0.1.2
@@ -521,9 +517,9 @@ JavaScript Dependencies
     https://github.com/tetherto/qvac
   @qvac/registry-schema@0.1.2
   @qvac/response@0.1.2
-  @qvac/transcription-parakeet@0.3.1
+  @qvac/transcription-parakeet@0.3.2
     https://github.com/tetherto/qvac
-  @qvac/transcription-whispercpp@0.6.1
+  @qvac/transcription-whispercpp@0.6.7
     https://github.com/tetherto/qvac
   @qvac/translation-nmtcpp@2.1.0
     https://github.com/tetherto/qvac
@@ -559,19 +555,19 @@ JavaScript Dependencies
     https://github.com/holepunchto/bare-events
   bare-events@2.8.2
     https://github.com/holepunchto/bare-events
-  bare-fetch@2.8.1
+  bare-fetch@2.9.0
     https://github.com/holepunchto/bare-fetch
   bare-ffmpeg@1.2.2
     https://github.com/holepunchto/bare-ffmpeg
   bare-form-data@1.2.1
     https://github.com/holepunchto/bare-form-data
-  bare-fs@4.6.0
+  bare-fs@4.7.1
     https://github.com/holepunchto/bare-fs
   bare-hrtime@2.1.1
     https://github.com/holepunchto/bare-hrtime
   bare-http-parser@1.1.3
     https://github.com/holepunchto/bare-http-parser
-  bare-http1@4.5.5
+  bare-http1@4.5.6
     https://github.com/holepunchto/bare-http1
   bare-https@2.1.3
     https://github.com/holepunchto/bare-https
@@ -581,7 +577,9 @@ JavaScript Dependencies
     https://github.com/holepunchto/bare-lief
   bare-link@3.2.1
     https://github.com/holepunchto/bare-link
-  bare-module@6.1.3
+  bare-mime@1.0.0
+    https://github.com/holepunchto/bare-mime
+  bare-module@6.2.0
     https://github.com/holepunchto/bare-module
   bare-module-lexer@1.4.7
     https://github.com/holepunchto/bare-module-lexer
@@ -595,7 +593,7 @@ JavaScript Dependencies
     https://github.com/holepunchto/bare-node
   bare-node-worker-threads@1.0.0
     https://github.com/holepunchto/bare-node
-  bare-os@3.8.7
+  bare-os@3.9.0
     https://github.com/holepunchto/bare-os
   bare-path@3.0.0
     https://github.com/holepunchto/bare-path
@@ -605,39 +603,39 @@ JavaScript Dependencies
     https://github.com/holepunchto/bare-process
   bare-rpc@1.2.0
     https://github.com/holepunchto/bare-rpc
-  bare-runtime@1.28.1
+  bare-runtime@1.28.4
     https://github.com/holepunchto/bare-runtime
-  bare-runtime-darwin-arm64@1.28.1
+  bare-runtime-darwin-arm64@1.28.4
     https://github.com/holepunchto/bare-runtime
-  bare-semver@1.0.2
+  bare-semver@1.0.3
     https://github.com/holepunchto/bare-semver
   bare-signals@4.2.0
     https://github.com/holepunchto/bare-signals
   bare-stdio@1.0.2
     https://github.com/holepunchto/bare-stdio
-  bare-stream@2.12.0
+  bare-stream@2.13.1
     https://github.com/holepunchto/bare-stream
-  bare-structured-clone@1.5.3
+  bare-structured-clone@1.5.4
     https://github.com/holepunchto/bare-structured-clone
   bare-subprocess@5.2.3
     https://github.com/holepunchto/bare-subprocess
-  bare-tcp@2.2.7
+  bare-tcp@2.2.12
     https://github.com/holepunchto/bare-tcp
   bare-thread@1.2.0
     https://github.com/holepunchto/bare-thread
-  bare-tls@2.2.1
+  bare-tls@2.2.3
     https://github.com/holepunchto/bare-tls
   bare-tty@5.1.0
     https://github.com/holepunchto/bare-tty
   bare-type@1.1.0
     https://github.com/holepunchto/bare-type
-  bare-url@2.4.0
+  bare-url@2.4.2
     https://github.com/holepunchto/bare-url
   bare-worker@4.1.6
     https://github.com/holepunchto/bare-worker
-  bare-zlib@1.3.1
+  bare-zlib@1.3.3
     https://github.com/holepunchto/bare-zlib
-  blind-relay@1.4.0
+  blind-relay@1.5.0
     https://github.com/holepunchto/blind-relay
   compact-encoding@2.19.2
     https://github.com/holepunchto/compact-encoding
@@ -647,7 +645,7 @@ JavaScript Dependencies
     https://github.com/holepunchto/events-universal
   fd-lock@2.1.1
     https://github.com/holepunchto/fd-lock
-  fs-native-extensions@1.4.5
+  fs-native-extensions@1.5.0
     https://github.com/holepunchto/fs-native-extensions
   hyperblobs@2.11.1
     https://github.com/holepunchto/hyperblobs
@@ -661,6 +659,8 @@ JavaScript Dependencies
     https://github.com/holepunchto/hypercore-storage
   hyperdb@4.22.3
     https://github.com/holepunchto/hyperdb
+  hyperdht-address@1.0.1
+    https://github.com/holepunchto/hyperdht-address
   hyperdht-stats@1.10.0
     https://github.com/holepunchto/hyperdht-stats
   hyperdispatch@1.5.1
@@ -673,7 +673,7 @@ JavaScript Dependencies
     https://github.com/holepunchto/hyperswarm-stats
   index-encoder@3.5.0
     https://github.com/holepunchto/index-encoder
-  mirror-drive@1.14.1
+  mirror-drive@1.14.2
     https://github.com/holepunchto/mirror-drive
   noise-handshake@4.2.0
     https://github.com/holepunchto/noise-handshake
@@ -745,8 +745,8 @@ JavaScript Dependencies
     https://github.com/holepunchto/corestore
   debounceify@1.1.0
     https://github.com/mafintosh/debounceify
-  dht-rpc@6.26.3
-    https://github.com/mafintosh/dht-rpc
+  dht-rpc@6.26.4
+    https://github.com/holepunchto/dht-rpc
   events@3.3.0
     https://github.com/Gozala/events
   fast-fifo@1.3.2
@@ -765,7 +765,7 @@ JavaScript Dependencies
     https://github.com/holepunchto/hypercore
   hypercore-crypto@3.6.1
     https://github.com/mafintosh/hypercore-crypto
-  hyperdht@6.29.6
+  hyperdht@6.30.0
     https://github.com/holepunchto/hyperdht
   hyperswarm@4.17.0
     https://github.com/holepunchto/hyperswarm
@@ -783,8 +783,8 @@ JavaScript Dependencies
     https://github.com/mafintosh/nat-sampler
   protocol-buffers-encodings@1.2.0
     https://github.com/mafintosh/protocol-buffers-encodings
-  protomux@3.10.1
-    https://github.com/mafintosh/protomux
+  protomux@3.10.3
+    https://github.com/holepunchto/protomux
   queue-tick@1.0.1
     https://github.com/mafintosh/queue-tick
   random-array-iterator@1.0.0

package/dist/examples/{llamacpp-native-tools.js → tools/llamacpp-native-tools.js}

@@ -1,44 +1,16 @@
-import { z } from "zod";
-import { completion, loadModel, unloadModel, QWEN3_1_7B_INST_Q4, } from "../index.js";
-// Define Zod schemas for tool parameters
-const weatherSchema = z.object({
-    city: z.string().describe("City name"),
-    country: z.string().describe("Country code").optional(),
-});
-const horoscopeSchema = z.object({
-    sign: z.string().describe("An astrological sign like Taurus or Aquarius"),
-});
-// Map tool names to their schemas for runtime validation
-const toolSchemas = {
-    get_weather: weatherSchema,
-    get_horoscope: horoscopeSchema,
-};
-// Simple tool definitions - just name, description, and Zod schema!
-const tools = [
-    {
-        name: "get_weather",
-        description: "Get current weather for a city",
-        parameters: weatherSchema,
-    },
-    {
-        name: "get_horoscope",
-        description: "Get today's horoscope for an astrological sign",
-        parameters: horoscopeSchema,
-    },
-];
+import { completion, loadModel, unloadModel, QWEN3_1_7B_INST_Q4, } from "@qvac/sdk";
+import { tools, toolSchemas, mockExecute } from "./shared.js";
 try {
-    // Load model from provided file path with tools support enabled
     const modelId = await loadModel({
         modelSrc: QWEN3_1_7B_INST_Q4,
         modelType: "llm",
         modelConfig: {
             ctx_size: 4096,
-            tools: true, // Enable tools support
+            tools: true,
         },
         onProgress: (progress) => console.log(`Loading: ${progress.percentage.toFixed(1)}%`),
     });
     console.log(`✅ Model loaded successfully! Model ID: ${modelId}`);
-    // Create conversation history
     const history = [
         {
             role: "system",
@@ -52,13 +24,11 @@ try {
     console.log("\n🤖 AI Response:");
     console.log("(Streaming with tool definitions in prompt)\n");
     const result = completion({ modelId, history, stream: true, tools });
-    // Consume token stream
     const tokensTask = (async () => {
         for await (const token of result.tokenStream) {
             process.stdout.write(token);
         }
     })();
-    // Consume tool call events
     const toolsTask = (async () => {
         for await (const evt of result.toolCallStream) {
             console.log(`\n\n→ Tool Call Detected: ${evt.call.name}(${JSON.stringify(evt.call.arguments)})`);
@@ -88,36 +58,23 @@ try {
         console.log("  No tool calls detected in response");
     }
     console.log("\n📊 Performance Stats:", stats);
-    // Execute tool calls and send results back to the model
     if (toolCalls.length > 0) {
         console.log("\n\n🔧 Simulating Tool Execution...");
-        // Simulate tool execution (in a real app, you'd call actual APIs)
         const toolResults = toolCalls.map((call) => {
-            let result = "";
-            if (call.name === "get_weather") {
-                const args = call.arguments;
-                result = `The weather in ${args.city} is sunny, 22°C with light clouds.`;
-            }
-            else if (call.name === "get_horoscope") {
-                const args = call.arguments;
-                result = `Horoscope for ${args.sign}: Today is a great day for new beginnings and creative endeavors!`;
-            }
+            const result = mockExecute(call.name, call.arguments);
             console.log(`  ✓ ${call.name}: ${result}`);
             return { toolCallId: call.id, result };
         });
-        // Add tool results to conversation history
         history.push({
             role: "assistant",
             content: await result.text,
         });
-        // Add tool results as tool messages
         for (const toolResult of toolResults) {
             history.push({
                 role: "tool",
                 content: toolResult.result,
             });
         }
-        // Send follow-up question with tool results
         console.log("\n\n🤖 Follow-up Response with Tool Results:");
         const followUpResult = completion({
             modelId,

package/dist/examples/tools/llamacpp-tools-harmony-multiturn.d.ts

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

package/dist/examples/tools/llamacpp-tools-harmony-multiturn.js

@@ -0,0 +1,81 @@
+/**
+ * Multi-turn tool-calling example using the GPT-OSS model (Harmony dialect).
+ *
+ * GPT-OSS emits one tool call per generation, so multi-tool requests need
+ * a turn-by-turn loop: send prompt + tools → mock-execute the returned
+ * `ToolCall` → append the raw assistant frame + tool result to history →
+ * repeat until the model produces a final answer (no tool call).
+ *
+ */
+import { completion, loadModel, unloadModel, GPT_OSS_20B_INST_Q4_K_M, } from "@qvac/sdk";
+import { tools, mockExecute } from "./shared.js";
+const MAX_TURNS = 5;
+let modelId;
+try {
+    modelId = await loadModel({
+        modelSrc: GPT_OSS_20B_INST_Q4_K_M,
+        modelConfig: { ctx_size: 4096, tools: true },
+        onProgress: (progress) => console.log(`Loading: ${progress.percentage.toFixed(1)}%`),
+    });
+    console.log(`✅ Model loaded: ${modelId}`);
+    const history = [
+        {
+            role: "system",
+            content: "You are a helpful assistant that can use tools to get the weather and horoscope.",
+        },
+        {
+            role: "user",
+            content: "What's the weather in Tokyo and my horoscope for Aquarius?",
+        },
+    ];
+    for (let turn = 1; turn <= MAX_TURNS; turn++) {
+        console.log(`\n========== TURN ${turn} ==========`);
+        const result = completion({ modelId, history, tools, stream: true });
+        for await (const token of result.tokenStream) {
+            process.stdout.write(token);
+        }
+        console.log();
+        const final = await result.final;
+        console.log(`\n--- TURN ${turn} SUMMARY ---`);
+        console.log(`[sdk toolCalls] ${final.toolCalls.length}`);
+        for (const call of final.toolCalls) {
+            console.log(`  → ${call.name}(${JSON.stringify(call.arguments)})`);
+        }
+        if (final.toolCalls.length === 0) {
+            console.log(`\n🎉 Final response received — exiting loop.`);
+            break;
+        }
+        // Raw, not result.text — GPT-OSS needs its own framed output in history
+        // to anchor the next turn.
+        const assistantContent = final.raw.fullText;
+        history.push({ role: "assistant", content: assistantContent });
+        for (const call of final.toolCalls) {
+            const toolResult = mockExecute(call.name, call.arguments);
+            console.log(`  ✓ mock-executed ${call.name}: ${toolResult}`);
+            history.push({ role: "tool", content: toolResult });
+        }
+        if (turn === MAX_TURNS) {
+            console.log(`\n⚠️  MAX_TURNS (${MAX_TURNS}) reached — stopping.`);
+        }
+    }
+    console.log(`\n========== HISTORY ==========`);
+    for (const msg of history) {
+        const preview = msg.content.slice(0, 120).replace(/\n/g, "\\n");
+        console.log(`[${msg.role}] ${preview}${msg.content.length > 120 ? "…" : ""}`);
+    }
+}
+catch (error) {
+    console.error("❌ Error:", error);
+    process.exit(1);
+}
+finally {
+    if (modelId) {
+        try {
+            await unloadModel({ modelId, clearStorage: false });
+            console.log(`\n[unload] done`);
+        }
+        catch (unloadError) {
+            console.error("[unload] failed:", unloadError);
+        }
+    }
+}

package/dist/examples/{llamacpp-tools-pythonic.js → tools/llamacpp-tools-pythonic.js}

@@ -1,25 +1,6 @@
-import { z } from "zod";
 import { completion, loadModel, unloadModel, } from "@qvac/sdk";
-// LFM2-1.2B-Tool emits Pythonic-style calls: [get_weather(city="Tokyo")].
+import { tools } from "./shared.js";
 const LFM_TOOL_HF = "https://huggingface.co/LiquidAI/LFM2-1.2B-Tool-GGUF/resolve/main/LFM2-1.2B-Tool-Q4_K_M.gguf";
-const weatherSchema = z.object({
-    city: z.string().describe("City name"),
-});
-const horoscopeSchema = z.object({
-    sign: z.string().describe("An astrological sign like Taurus or Aquarius"),
-});
-const tools = [
-    {
-        name: "get_weather",
-        description: "Get current weather for a city",
-        parameters: weatherSchema,
-    },
-    {
-        name: "get_horoscope",
-        description: "Get today's horoscope for an astrological sign",
-        parameters: horoscopeSchema,
-    },
-];
 try {
     const modelId = await loadModel({
         modelSrc: LFM_TOOL_HF,

package/dist/examples/tools/shared.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import type { ToolInput } from "@qvac/sdk";
+export declare const weatherSchema: z.ZodObject<{
+    city: z.ZodString;
+    country: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const horoscopeSchema: z.ZodObject<{
+    sign: z.ZodString;
+}, z.core.$strip>;
+export declare const toolSchemas: {
+    readonly get_weather: z.ZodObject<{
+        city: z.ZodString;
+        country: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly get_horoscope: z.ZodObject<{
+        sign: z.ZodString;
+    }, z.core.$strip>;
+};
+export declare const tools: ToolInput[];
+export declare function mockExecute(name: string, args: Record<string, unknown>): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/examples/tools/shared.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export const weatherSchema = z.object({
+    city: z.string().describe("City name"),
+    country: z.string().describe("Country code").optional(),
+});
+export const horoscopeSchema = z.object({
+    sign: z.string().describe("An astrological sign like Taurus or Aquarius"),
+});
+export const toolSchemas = {
+    get_weather: weatherSchema,
+    get_horoscope: horoscopeSchema,
+};
+export const tools = [
+    {
+        name: "get_weather",
+        description: "Get current weather for a city",
+        parameters: weatherSchema,
+    },
+    {
+        name: "get_horoscope",
+        description: "Get today's horoscope for an astrological sign",
+        parameters: horoscopeSchema,
+    },
+];
+export function mockExecute(name, args) {
+    if (name === "get_weather") {
+        const a = args;
+        return JSON.stringify({
+            city: a.city,
+            country: a.country ?? "unknown",
+            temperature: "22°C",
+            condition: "Partly cloudy",
+        });
+    }
+    if (name === "get_horoscope") {
+        return JSON.stringify({
+            sign: args.sign,
+            horoscope: "Today is a great day for new beginnings.",
+        });
+    }
+    return JSON.stringify({ error: `Unknown tool: ${name}` });
+}