@qvac/harness 0.3.3 → 0.5.0

package/dist-lib/lib/capabilities/voice.js

@@ -1,4 +1,5 @@
 import b4a from 'b4a';
+import { errorMessage } from '../guards.js';
 import { AbortedError } from '../helpers/race-abort.js';
 import { hlog } from '../log.js';
 import { normalizeForSpeech } from './speech-text.js';
@@ -7,7 +8,7 @@ export function createVoiceLane() {
     let tail = Promise.resolve();
     return (job) => {
         const run = tail.then(job);
-        tail = run.catch(() => { });
+        tail = run.catch(noop);
         return run;
     };
 }
@@ -35,8 +36,9 @@ async function drainUntilIdle(lastPieceAt, streamClosed, signal) {
         if (signal?.aborted || streamClosed() || Date.now() >= deadline)
             return;
         const last = lastPieceAt();
-        if (last > 0 && Date.now() - last >= TRANSCRIBE_DRAIN_IDLE_MS)
+        if (last > 0 && Date.now() - last >= TRANSCRIBE_DRAIN_IDLE_MS) {
             return;
+        }
         await pace(TRANSCRIBE_PACE_MS);
     }
 }
@@ -57,7 +59,7 @@ function transcribePiece(piece) {
     }
     return null;
 }
-export async function transcribeStreaming(sdk, modelId, pcm, signal) {
+export async function transcribeStreaming(sdk, pcm, { modelId, signal }) {
     const session = await sdk.transcribeStream({
         modelId,
         metadata: TRANSCRIBE_WITH_METADATA,
@@ -72,8 +74,9 @@ export async function transcribeStreaming(sdk, modelId, pcm, signal) {
         for await (const piece of session) {
             lastPieceAt = Date.now();
             const seg = transcribePiece(piece);
-            if (!seg)
+            if (!seg) {
                 continue;
+            }
             out += !out || seg.append ? seg.text : ` ${seg.text}`;
         }
         streamClosed = true;
@@ -85,16 +88,18 @@ export async function transcribeStreaming(sdk, modelId, pcm, signal) {
     try {
         await writePaced(session, pcm, signal);
         await drainUntilIdle(() => lastPieceAt, () => streamClosed, signal);
-        if (!signal?.aborted)
+        if (!signal?.aborted) {
             session.end();
+        }
         const text = await collect;
-        if (signal?.aborted)
+        if (signal?.aborted) {
             throw new AbortedError();
+        }
         return text;
     }
     catch (err) {
         session.destroy();
-        await collect.catch(() => { });
+        await collect.catch(noop);
         throw err;
     }
     finally {
@@ -117,7 +122,7 @@ export async function* speakStreamOnce(sdk, modelId, text) {
             session.end();
         }
         catch (err) {
-            hlog('tts stream input failed', { err: err instanceof Error ? err.message : String(err) });
+            hlog('tts stream input failed', { err: errorMessage(err) });
             inputError = err;
             destroyQuietly(session);
         }
@@ -154,8 +159,9 @@ function destroyQuietly(session) {
 }
 function writeSpeakable(session, fragment) {
     const spoken = speakable(fragment);
-    if (!/[A-Za-z0-9]/.test(spoken))
+    if (!/[A-Za-z0-9]/.test(spoken)) {
         return false;
+    }
     session.write(b4a.from(/^\s/.test(fragment) ? ` ${spoken}` : spoken, 'utf8'));
     return true;
 }
@@ -168,14 +174,17 @@ export function speakable(text) {
 }
 export async function speakOnce(sdk, modelId, text) {
     const spoken = speakable(text);
-    if (!spoken)
+    if (!spoken) {
         return [];
+    }
     const result = sdk.textToSpeech({ modelId, text: spoken, inputType: 'text', stream: true });
     const samples = [];
-    for await (const sample of result.bufferStream)
+    for await (const sample of result.bufferStream) {
         samples.push(sample);
-    if (!(await result.done))
+    }
+    if (!(await result.done)) {
         throw new Error('tts synthesis did not complete');
+    }
     return samples;
 }
 export function packSamples(samples) {
@@ -187,3 +196,4 @@ export function packSamples(samples) {
     }
     return bytes;
 }
+function noop() { }

package/dist-lib/lib/connect.d.ts

@@ -1,10 +1,13 @@
 import EventEmitter from 'events';
 import { type Transport } from './rpc-session.ts';
 import { type KvCacheDeletionResult } from './capabilities/kv-cache.ts';
-import type { CapabilityInfo, CompletionContext, DetectedLanguage, DetectLanguageContext, DownloadContext, EmbedContext, HarnessContract, HarnessDiagnostics, HarnessEvent, HarnessInfo, InvokeContext, ListModelsOptions, ModelInfo, ResolvedSkillCatalogEntry, SpeakContext, SpeakResult, SpeakStreamContext, ToolCatalogEntry, TranscribeContext, WarmModelContext } from './contract-types.ts';
+import type { CustomModelEntry } from './models/model-catalog.ts';
+import { type ModelSourcePreview, type PreviewModelSourceContext } from './capabilities/preview-model-source.ts';
+import type { CapabilityInfo, CompletionContext, CredentialEntry, DetectedLanguage, DetectLanguageContext, DownloadContext, EmbedContext, HarnessContract, HarnessDiagnostics, HarnessEvent, HarnessInfo, InfraModel, InvokeContext, ListModelsOptions, ModelInfo, ResolvedSkillCatalogEntry, SkillsOptions, SkillWriteResult, SpeakContext, SpeakResult, SpeakStreamContext, ToolCatalogEntry, TranscribeContext, WarmModelContext } from './contract-types.ts';
 import { type EmbedDevice } from './models/embed-config.ts';
 import type { DeleteModelSummary } from './models/model-delete.ts';
-import type { ManagedSkill, SkillFileContent } from './tools/skills/overlay-crud.ts';
+import type { CopyBaseResult, DeleteOverlayResult, ManagedSkill, SkillFileContent } from './tools/skills/overlay-crud.ts';
+import type { SkillSettingEntry } from './tools/skills/skill-settings.ts';
 export declare const HARNESS_DIED = "HARNESS_DIED";
 export declare function connectHarness(transport: Transport): RemoteHarness;
 export declare function readEmbeddingDeviceResponse(response: unknown): EmbedDevice;
@@ -30,39 +33,17 @@ export declare class RemoteHarness extends EventEmitter implements HarnessContra
     speakStream(context: SpeakStreamContext): AsyncIterable<SpeakResult>;
     getEmbeddingDevice(): Promise<EmbedDevice>;
     setEmbeddingDevice(device: EmbedDevice): Promise<void>;
-    setCredentials(entries: ReadonlyArray<{
-        key: string;
-        token?: string | null;
-        expiresAt?: number | null;
-        agentId?: string | null;
-        skill?: string | null;
-    }>): Promise<void>;
-    setSkillSettings(entries: ReadonlyArray<{
-        skill: string;
-        key: string;
-        value: string;
-        agentId?: string | null;
-    }>): Promise<void>;
+    setCredentials(entries: ReadonlyArray<CredentialEntry>): Promise<void>;
+    setSkillSettings(entries: ReadonlyArray<SkillSettingEntry>): Promise<void>;
+    setModelIdleTimeout(ms: number): Promise<void>;
     listManagedSkills(): Promise<ManagedSkill[]>;
     readSkillFile(name: string): Promise<SkillFileContent | null>;
-    writeSkillFile(name: string, content: string): Promise<{
-        ok: boolean;
-    }>;
-    copyBaseForEdit(name: string): Promise<{
-        copied: boolean;
-    }>;
-    deleteOverlaySkill(name: string): Promise<{
-        removed: boolean;
-    }>;
-    setCustomModels(entries: ReadonlyArray<{
-        name: string;
-        src: string;
-        projectionSrc?: string;
-    }>): Promise<void>;
-    skills(agentId?: string | null, modelName?: string | null, options?: {
-        readonly refresh?: boolean;
-        readonly skipCredentialProbe?: boolean;
-    }): Promise<ResolvedSkillCatalogEntry[]>;
+    writeSkillFile(name: string, content: string): Promise<SkillWriteResult>;
+    copyBaseForEdit(name: string): Promise<CopyBaseResult>;
+    deleteOverlaySkill(name: string): Promise<DeleteOverlayResult>;
+    setCustomModels(entries: ReadonlyArray<CustomModelEntry>): Promise<void>;
+    previewModelSource(context: PreviewModelSourceContext): Promise<ModelSourcePreview>;
+    skills(agentId?: string | null, modelName?: string | null, options?: SkillsOptions): Promise<ResolvedSkillCatalogEntry[]>;
     tools(): Promise<ToolCatalogEntry[]>;
     warmModel(context: WarmModelContext): Promise<void>;
     list(options?: ListModelsOptions): Promise<ModelInfo[]>;
@@ -70,10 +51,7 @@ export declare class RemoteHarness extends EventEmitter implements HarnessContra
     clearKvCache(): Promise<KvCacheDeletionResult>;
     deleteKvCache(kvCacheKey: string): Promise<KvCacheDeletionResult>;
     private _deleteKvCaches;
-    infraModels(profile: string): Promise<Array<{
-        name: string;
-        addon: string;
-    }>>;
+    infraModels(profile: string): Promise<InfraModel[]>;
     capability(): Promise<CapabilityInfo>;
     close(): void;
     describe(): Promise<HarnessInfo | null>;