@qvac/harness 0.0.0 → 0.1.1

package/dist/harness.cjs

@@ -0,0 +1,18 @@
+const path = require('path')
+const Sidecar = require('bare-sidecar')
+const stow = require('bare-stow/host')
+
+const bundle = path.join(__dirname, "./harness.bundle")
+
+module.exports = {
+  async start(args = [], opts = {}) {
+    const sidecar = new Sidecar(bundle, args, opts)
+
+    const ipc = stow.wrap(sidecar)
+    const exit = new Promise((resolve) =>
+      sidecar.once('exit', (code, status) => resolve({ code, status }))
+    )
+
+    return { ipc, sidecar, exit }
+  }
+}

package/dist/harness.d.ts

@@ -0,0 +1,8 @@
+export function start(
+  args?: string[],
+  opts?: object
+): Promise<{
+  ipc: import('bare-stow/host').IPC
+  sidecar: import('bare-sidecar')
+  exit: Promise<{ code: number | null; status: number | null }>
+}>

package/dist/prebuilds-manifest.json

@@ -0,0 +1,379 @@
+{
+  "packages": {
+    "@qvac/audiogen-ggml": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-x64"
+    ],
+    "bare-abort": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-bmp": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-buffer": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-channel": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-cpu-info": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-crypto": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-dns": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-exif": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-ffmpeg": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-fs": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-gif": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-gpu-info": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-heif": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-hrtime": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-ico": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-image-resample": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-inspect": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-jpeg": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-logger": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-os": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-path": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-performance": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-pipe": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-png": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-sidecar": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-signals": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-stdio": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-storage": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-structured-clone": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-subprocess": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-svg": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-tcp": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-tiff": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-tls": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-tty": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-type": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-url": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-webp": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "bare-zlib": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "fs-native-extensions": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "quickbit-native": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "rabin-native": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "rocksdb-native": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "simdle-native": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "sodium-native": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ],
+    "udx-native": [
+      "darwin-arm64",
+      "darwin-x64",
+      "linux-arm64",
+      "linux-x64",
+      "win32-arm64",
+      "win32-x64"
+    ]
+  }
+}

package/dist-lib/index.d.ts

@@ -0,0 +1,240 @@
+import type { AbortSignal as BareAbortSignal } from 'bare-abort-controller';
+import ReadyResource from 'ready-resource';
+import { type Agent, type ApproveFn, type AskUserFn, type AttachFn, type CompletionEvent, type FetchAttachmentFn, type Message, type ProgressFn, type RagSearchFn, type ResponseFormat, type ToolDefinition, type ToolExecuteContext } from './lib/capabilities/completion.ts';
+import { type DownloadArgs, type DownloadEventStream } from './lib/capabilities/download.ts';
+import { type EmbedContext } from './lib/capabilities/embed.ts';
+import { type KvCacheDeletionResult } from './lib/capabilities/kv-cache.ts';
+import type { LlmGenerationParams } from './lib/models/llm-presets.ts';
+import { type SpeakContext, type SpeakResult, type SpeakStreamContext, type TranscribeContext } from './lib/capabilities/voice.ts';
+import type { CapabilityInfo, HarnessDiagnostics } from './lib/contract-types.ts';
+import { type CustomModelEntry } from './lib/models/model-catalog.ts';
+import { type ListModelsOptions, type ModelInfo } from './lib/models/model-list.ts';
+import { type DeleteModelSummary } from './lib/models/model-delete.ts';
+import { type EmbedDevice } from './lib/models/embed-config.ts';
+import { type SdkLoader } from './lib/sdk-loader.ts';
+import type { ImageClamps } from './lib/models/model-catalog.ts';
+import { type ToolCatalogEntry } from './lib/tools/catalog.ts';
+import { type MusicClamps, type MusicModelStages } from './lib/tools/generate-music.ts';
+import type { CredentialStoreFn, CredentialStoreValue } from './lib/tools/skills/auth-resolver.ts';
+import { type ManagedSkill, type SkillFileContent } from './lib/tools/skills/overlay-crud.ts';
+import { type DriveOpFn, type GrantedDrive } from './lib/tools/fs/remote.ts';
+import type { ResolvedSkillCatalogEntry } from './lib/tools/skills/catalog.ts';
+import { type SkillSettingEntry } from './lib/tools/skills/skill-settings.ts';
+export * from './lib/capabilities/completion.ts';
+export { attachmentTurn, loadedSkillsFrom, skillLoadedTurn } from './lib/capabilities/tool-turns.ts';
+export * from './lib/capabilities/download.ts';
+export type { EmbedContext } from './lib/capabilities/embed.ts';
+export type { SpeakContext, SpeakResult, SpeakStreamContext, TranscribeContext } from './lib/capabilities/voice.ts';
+export type { EmbedDevice } from './lib/models/embed-config.ts';
+export type { MemoryBudget } from './lib/hardware/memory-budget.ts';
+export * from './lib/models/model-catalog.ts';
+export * from './lib/models/model-list.ts';
+export type { DeleteModelResult, DeleteModelSummary } from './lib/models/model-delete.ts';
+export { harnessChild, spawnHarness, type HarnessChildOptions, type SpawnHarnessOptions } from './lib/spawn.ts';
+export { settingsDimension, settingsSteps } from './lib/tools/generate-image.ts';
+export * from './lib/tools/skills/catalog.ts';
+export { requiredSettings, settingEnvName, type SkillSettingEntry, type SkillSettingsFn } from './lib/tools/skills/skill-settings.ts';
+export type { ToolCatalogEntry } from './lib/tools/catalog.ts';
+export { TOOLSETS, toolsetEnabled, type Toolset } from './lib/tools/toolsets.ts';
+export { markCredentialRejected, markCredentialValid, recordCredentialHealth, resetAllCredentialHealth, resetCredentialHealth } from './lib/tools/skills/credential-health.ts';
+export type { InstallStep, SkillRequires, SkillSetup, SkillSetupField, SkillSetupRoute } from './lib/tools/skills/manifest.ts';
+export { readSetup as normalizeSkillSetup } from './lib/tools/skills/manifest-parse.ts';
+export type { CredentialRecord, CredentialStoreValue } from './lib/tools/skills/auth-resolver.ts';
+export { isAvailableState, SKILL_STATE, type SkillState } from './lib/tools/skills/skill-state.ts';
+export { connectHarness, HARNESS_DIED, RemoteHarness } from './lib/connect.ts';
+export type { KvCacheDeletionResult } from './lib/capabilities/kv-cache.ts';
+export type { AgentKnobs, ApprovalCall, ChatMessage, DownloadContext, HarnessContract, HarnessDiagnostics, HarnessEvent, HarnessInfo, HarnessStatus, ModelState } from './lib/contract-types.ts';
+import type { HarnessInfo } from './lib/contract-types.ts';
+export { serveHarness } from './lib/serve.ts';
+export { hlog, setHarnessLog, setHarnessLogSink } from './lib/log.ts';
+export { harnessHooks } from './lib/hooks/registry.ts';
+export { EgressGuardHook, SkillCatalogGuardHook } from './lib/hooks/built-in/index.ts';
+export type { ToolCallDisplay, ToolExecutionOutcome } from './lib/tool-call-display.ts';
+export type { HarnessHook, HookContext, HookResult } from './lib/hooks/types.ts';
+export interface ImageModelOptions {
+    model: string;
+    llmModel?: string;
+    vaeModel?: string;
+    prediction?: 'flux2_flow';
+}
+export interface MusicModelOptions extends MusicModelStages {
+    inferenceSteps?: number;
+    useGpu?: boolean;
+}
+export interface HarnessOptions {
+    tools?: ToolDefinition[];
+    sdkLoader?: SdkLoader;
+    skillsDir?: string;
+    projectionModel?: string | Record<string, string>;
+    imageModel?: string | ImageModelOptions;
+    imageClamps?: ImageClamps;
+    musicModel?: string | MusicModelOptions;
+    musicClamps?: MusicClamps;
+    llmDevice?: 'cpu' | 'gpu';
+    llmGpuLayers?: number;
+    contextSize?: number;
+    kvCacheK?: string;
+    kvCacheV?: string;
+    embedDevice?: EmbedDevice;
+    embedGpuLayers?: number;
+    embedBatchSize?: number;
+    transcriptionDevice?: 'cpu' | 'gpu';
+    credentialStore?: CredentialStoreFn;
+    platform?: string;
+}
+export interface CompletionContext {
+    model: string;
+    agent?: Agent;
+    messages: Message[];
+    cacheKey?: string;
+    thinkingDefault?: string;
+    toolConfigs?: Record<string, Record<string, unknown>>;
+    generationParams?: LlmGenerationParams;
+    responseFormat?: ResponseFormat;
+    grantedDirs?: string[];
+    grantedDrives?: GrantedDrive[];
+    driveOp?: DriveOpFn;
+    grantedWriteDirs?: string[];
+    approve?: ApproveFn;
+    attach?: AttachFn;
+    fetchAttachment?: FetchAttachmentFn;
+    ragSearch?: RagSearchFn;
+    progress?: ProgressFn;
+    askUser?: AskUserFn;
+    signal?: BareAbortSignal;
+}
+export declare class Harness extends ReadyResource {
+    private _tools;
+    private _sdk;
+    private readonly _loads;
+    private readonly _modelStatus;
+    private _models;
+    private _embedModels;
+    private readonly _retiredEmbedModels;
+    private _embedLane;
+    private _embedFaults;
+    private readonly _embedGpuLayers?;
+    private readonly _embedBatchSize;
+    private _embedControl;
+    private _ttsModels;
+    private _transcriptionModels;
+    private _voiceLane;
+    private _state;
+    private _skillsDir?;
+    private _overlayWatcher;
+    private _supportedSkills;
+    private _projectionModel;
+    private _customProjection;
+    private readonly _llmDevice?;
+    private readonly _llmGpuLayers?;
+    private readonly _contextSize?;
+    private readonly _kvCacheK?;
+    private readonly _kvCacheV?;
+    private readonly _transcriptionDevice?;
+    private _allSkills;
+    private _credentialStore?;
+    private _credentials;
+    private _settings;
+    private _platform?;
+    private _diffusionSdk;
+    private _imageRuntime;
+    private _musicSdk;
+    private _musicRuntime;
+    private _capability;
+    private _capabilityInflight;
+    private readonly _modelFaults;
+    constructor({ tools, sdkLoader, skillsDir, projectionModel, imageModel, imageClamps, musicModel, musicClamps, llmDevice, llmGpuLayers, contextSize, kvCacheK, kvCacheV, embedDevice, embedGpuLayers, embedBatchSize, transcriptionDevice, credentialStore, platform }?: HarnessOptions);
+    _open(): Promise<void>;
+    get suspended(): boolean;
+    get skillNames(): string[];
+    setCredentials(entries: ReadonlyArray<{
+        key: string;
+        token?: string | null;
+        expiresAt?: number | null;
+        agentId?: string | null;
+        skill?: string | null;
+    }>): void;
+    setSkillSettings(entries: ReadonlyArray<SkillSettingEntry>): void;
+    skillSettings(skill: string, agentId?: string | null): Record<string, string>;
+    private _baseSkillsDir;
+    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;
+    }>;
+    resolveCredential(key: string, ctx?: ToolExecuteContext): Promise<CredentialStoreValue> | CredentialStoreValue;
+    private _completionSkills;
+    skills(agentId?: string | null, modelName?: string | null, options?: {
+        refresh?: boolean;
+        skipCredentialProbe?: boolean;
+        skipBinProbe?: boolean;
+    }): Promise<ResolvedSkillCatalogEntry[]>;
+    private _reloadSkills;
+    private _startOverlayWatch;
+    tools(): Promise<ToolCatalogEntry[]>;
+    private _binVersionCache;
+    private _binVersionInflight;
+    private _probeBinVersions;
+    private _runBinVersionProbes;
+    get toolNames(): string[];
+    get supportsImages(): boolean;
+    supportsImagesFor(model: string): boolean;
+    private _projectionFor;
+    setCustomModels(entries: ReadonlyArray<CustomModelEntry>): void;
+    describe(): Promise<HarnessInfo>;
+    diagnostics(): HarnessDiagnostics;
+    private _loadedModels;
+    private _loadPluginSdk;
+    private _loadDiffusionSdk;
+    private _loadMusicSdk;
+    private _deviceConfig;
+    private _createPool;
+    private _createEmbedPool;
+    private _createTtsPool;
+    private _createTranscriptionPool;
+    private _notifyModel;
+    private _collectRetiredEmbedPool;
+    private _releaseEmbedResource;
+    private _releaseEmbedResourceAfter;
+    private _destroyEmbedPools;
+    private _enqueueEmbedControl;
+    getEmbeddingDevice(): EmbedDevice;
+    setEmbeddingDevice(device: EmbedDevice): Promise<void>;
+    private _setEmbeddingDevice;
+    presuspend(): Promise<void>;
+    suspend(): Promise<void>;
+    private _sdkLifecycle;
+    private _releaseRuntimes;
+    resume(): Promise<void>;
+    wakeup(): Promise<void>;
+    _close(): Promise<void>;
+    download(args: DownloadArgs): DownloadEventStream;
+    embed({ model, texts, signal }: EmbedContext): Promise<number[][]>;
+    private _defaultVoiceSrc;
+    private _voiceJob;
+    transcribe({ model, audio, signal }: TranscribeContext): Promise<string>;
+    speak({ model, text, signal }: SpeakContext): Promise<SpeakResult>;
+    speakStream({ model, text, signal }: SpeakStreamContext): AsyncIterable<SpeakResult>;
+    list(options?: ListModelsOptions): Promise<ModelInfo[]>;
+    deleteModel(name: string): Promise<DeleteModelSummary>;
+    clearKvCache(): Promise<KvCacheDeletionResult>;
+    infraModels(profile: string): Promise<Array<{
+        name: string;
+        addon: string;
+    }>>;
+    capability(): Promise<CapabilityInfo>;
+    warmModel({ model, agent, signal }: {
+        model: string;
+        agent?: Agent;
+        signal?: BareAbortSignal;
+    }): Promise<void>;
+    completion({ model, agent, messages, cacheKey, thinkingDefault, toolConfigs, generationParams, responseFormat, grantedDirs, grantedDrives, driveOp, grantedWriteDirs, approve, attach, fetchAttachment, ragSearch, progress, askUser, signal }: CompletionContext): AsyncGenerator<CompletionEvent>;
+    private _evictWedgedModel;
+    private _evictAfterLeases;
+}