@qvac/core 0.0.0 → 0.1.0

package/dist/assistant.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, "./assistant.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/assistant.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,380 @@
+{
+  "packages": {
+    "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-system-logger": [
+      "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/client.d.ts

@@ -0,0 +1,2 @@
+export { Client } from './lib/client.ts';
+export type { Capabilities, WatchStream } from './lib/api/index.ts';

package/dist-lib/client.js

@@ -0,0 +1 @@
+export { Client } from "./lib/client.js";

package/dist-lib/index.d.ts

@@ -0,0 +1,13 @@
+export type { AssistantAgent, AssistantAgentList, AssistantConfigValue } from './spec/hyperschema/types.d.ts';
+export type { Logger } from './lib/logger-type.ts';
+export { setLogger } from './lib/logger.ts';
+export { Core } from './lib/core.ts';
+export { Client } from './lib/client.ts';
+export { AssistantClient } from './lib/assistant-client.ts';
+export { harnessDeleteModel, harnessListModels, harnessSkillCatalog, harnessTools, QvacAssistant, type Harness, type ListModelsOptions, type ModelInfo, type ModelType, type Skill, type ToolCatalogEntry } from './lib/assistant.ts';
+export { assistantChild, assistantTree, type AssistantChildOptions, type AssistantTreeOptions, type EmbedderFactory, type HarnessContext, type HarnessFactory } from './lib/assistant-tree.ts';
+export { ASSISTANT_WAKEUP_LINGER_MS, createAssistantSuspendLifecycle, type AssistantSuspendLifecycleOptions } from './lib/suspend-lifecycle.ts';
+export { default as Supervisor } from 'bare-supervisor';
+export type { AssistantDiagnostics, DiagnosticsSlice, HarnessDiagnostics, RunSummary } from './lib/diagnostics.ts';
+export { clientSessions, duplexPair, type ClientSessions } from '@qvac/harness/transport';
+export { groupAttachmentsByMessage, replyMessageId, REPLY_MESSAGE_PREFIX } from './lib/core/files/records/linkage.ts';

package/dist-lib/index.js

@@ -0,0 +1,10 @@
+export { setLogger } from "./lib/logger.js";
+export { Core } from "./lib/core.js";
+export { Client } from "./lib/client.js";
+export { AssistantClient } from "./lib/assistant-client.js";
+export { harnessDeleteModel, harnessListModels, harnessSkillCatalog, harnessTools, QvacAssistant } from "./lib/assistant.js";
+export { assistantChild, assistantTree } from "./lib/assistant-tree.js";
+export { ASSISTANT_WAKEUP_LINGER_MS, createAssistantSuspendLifecycle } from "./lib/suspend-lifecycle.js";
+export { default as Supervisor } from 'bare-supervisor';
+export { clientSessions, duplexPair } from '@qvac/harness/transport';
+export { groupAttachmentsByMessage, replyMessageId, REPLY_MESSAGE_PREFIX } from "./lib/core/files/records/linkage.js";

package/dist-lib/lib/agent-icons.d.ts

@@ -0,0 +1,3 @@
+import type { QvacAgentIconName } from '../spec/mesh/hyperschema/types.d.ts';
+export type { QvacAgentIconName };
+export declare const DEFAULT_AGENT_ICON_NAME: QvacAgentIconName;

package/dist-lib/lib/agent-icons.js

@@ -0,0 +1 @@
+export const DEFAULT_AGENT_ICON_NAME = 'artificial-intelligence';

package/dist-lib/lib/api/agents.d.ts

@@ -0,0 +1,5 @@
+import { type CurrentMesh } from './current-mesh.ts';
+import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
+type AgentCapabilities = Pick<CapabilityHandlers, 'createAgent' | 'listAgents' | 'getAgent' | 'updateAgent' | 'deleteAgent' | 'agentsWatch'>;
+export declare function createAgentsApi(current: CurrentMesh, deviceId: Buffer | null): AgentCapabilities;
+export {};

package/dist-lib/lib/api/agents.js

@@ -0,0 +1,38 @@
+import { createAgent, deleteAgent, isOrphaned, listAgents, liveProviderIds, mustGetActiveAgent, updateAgent } from "../core/agent.js";
+import { requireMesh } from "./current-mesh.js";
+import { watchable } from "./watchable.js";
+export function createAgentsApi(current, deviceId) {
+    const withOrphaned = async (mesh, agent) => ({
+        ...agent,
+        orphaned: await isOrphaned(mesh, agent)
+    });
+    const list = async (mesh) => {
+        const [agents, live] = await Promise.all([listAgents(mesh), liveProviderIds(mesh)]);
+        return {
+            agents: agents.map((agent) => ({
+                ...agent,
+                orphaned: !live.has(agent.providerDeviceId.toString('hex'))
+            }))
+        };
+    };
+    return {
+        createAgent: async (input) => {
+            const mesh = await requireMesh(current);
+            return withOrphaned(mesh, await createAgent(mesh, input));
+        },
+        listAgents: async () => list(await requireMesh(current)),
+        getAgent: async ({ id }) => {
+            const mesh = await requireMesh(current);
+            return withOrphaned(mesh, await mustGetActiveAgent(mesh, id));
+        },
+        updateAgent: async (input) => {
+            const mesh = await requireMesh(current);
+            return withOrphaned(mesh, await updateAgent(mesh, input));
+        },
+        deleteAgent: async ({ id }) => {
+            const mesh = await requireMesh(current);
+            return withOrphaned(mesh, await deleteAgent(mesh, deviceId, id));
+        },
+        agentsWatch: watchable('agentsWatch', () => requireMesh(current), (_request, mesh) => list(mesh))
+    };
+}

package/dist-lib/lib/api/app-config.d.ts

@@ -0,0 +1,5 @@
+import type { openLocalStore } from '../core/local/index.ts';
+import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
+type LocalStore = Awaited<ReturnType<typeof openLocalStore>>;
+export declare function createAppConfigApi(state: LocalStore): Pick<CapabilityHandlers, 'getConfig' | 'setConfig' | 'setModelPaused' | 'configWatchTyped'>;
+export {};

package/dist-lib/lib/api/app-config.js

@@ -0,0 +1,108 @@
+import { watchable } from "./watchable.js";
+const EMPTY_CAPABILITIES = {
+    chat: false,
+    transcription: false,
+    tts: false,
+    embeddings: false,
+    knowledge: false
+};
+const EMPTY_DELEGATION = {
+    enabled: false,
+    targetDeviceId: null,
+    targetAgentId: null,
+    capabilities: EMPTY_CAPABILITIES
+};
+const DEFAULT_CONFIG = {
+    activeAgentId: null,
+    activeChatId: null,
+    thinkingEnabled: true,
+    ctxSize: 0,
+    lastModelName: null,
+    onboardingCompleted: false,
+    delegation: EMPTY_DELEGATION,
+    pausedModels: []
+};
+function normalizeDelegation(raw) {
+    if (!raw || typeof raw !== 'object') {
+        return { ...EMPTY_DELEGATION, capabilities: { ...EMPTY_CAPABILITIES } };
+    }
+    const d = raw;
+    const c = (d.capabilities ?? {});
+    return {
+        enabled: d.enabled ?? false,
+        targetDeviceId: d.targetDeviceId ?? null,
+        targetAgentId: d.targetAgentId ?? null,
+        capabilities: {
+            chat: c.chat ?? false,
+            transcription: c.transcription ?? false,
+            tts: c.tts ?? false,
+            embeddings: c.embeddings ?? false,
+            knowledge: c.knowledge ?? false
+        }
+    };
+}
+function toConfig(row) {
+    if (!row)
+        return { ...DEFAULT_CONFIG, delegation: normalizeDelegation(null) };
+    return {
+        activeAgentId: row.activeAgentId ?? null,
+        activeChatId: row.activeChatId ?? null,
+        thinkingEnabled: row.thinkingEnabled ?? true,
+        ctxSize: row.ctxSize ?? 0,
+        lastModelName: row.lastModelName ?? null,
+        onboardingCompleted: row.onboardingCompleted ?? false,
+        delegation: normalizeDelegation(row.delegation),
+        pausedModels: row.pausedModels ?? []
+    };
+}
+function applyWrite(current, update) {
+    return {
+        activeAgentId: update.activeAgentId ?? null,
+        activeChatId: update.activeChatId ?? null,
+        thinkingEnabled: update.thinkingEnabled ?? true,
+        ctxSize: update.ctxSize ?? 0,
+        lastModelName: current.lastModelName,
+        onboardingCompleted: update.onboardingCompleted ?? false,
+        delegation: normalizeDelegation(update.delegation),
+        pausedModels: current.pausedModels
+    };
+}
+async function readConfig(state) {
+    return toConfig(await state.getAppConfigRow());
+}
+function toRow(config) {
+    return {
+        activeAgentId: config.activeAgentId,
+        activeChatId: config.activeChatId,
+        thinkingEnabled: config.thinkingEnabled,
+        ctxSize: config.ctxSize,
+        lastModelName: config.lastModelName,
+        onboardingCompleted: config.onboardingCompleted,
+        delegation: config.delegation,
+        pausedModels: config.pausedModels
+    };
+}
+export function createAppConfigApi(state) {
+    return {
+        getConfig(_) {
+            return readConfig(state);
+        },
+        async setConfig(update) {
+            const row = await state.updateAppConfigRow((current) => toRow(applyWrite(toConfig(current), update)));
+            return toConfig(row);
+        },
+        async setModelPaused(input) {
+            const row = await state.updateAppConfigRow((current) => {
+                const config = toConfig(current);
+                const paused = new Set(config.pausedModels);
+                if (input.paused)
+                    paused.add(input.name);
+                else
+                    paused.delete(input.name);
+                return toRow({ ...config, pausedModels: [...paused] });
+            });
+            return toConfig(row);
+        },
+        configWatchTyped: watchable('configWatchTyped', () => state, () => readConfig(state))
+    };
+}

package/dist-lib/lib/api/approval-rules.d.ts

@@ -0,0 +1,3 @@
+import { type CurrentMesh } from './current-mesh.ts';
+import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
+export declare function createApprovalRulesApi(current: CurrentMesh): Pick<CapabilityHandlers, 'listApprovalRules'>;

package/dist-lib/lib/api/approval-rules.js

@@ -0,0 +1,9 @@
+import { listApprovalRules } from "../core/approval-rules.js";
+import { requireMesh } from "./current-mesh.js";
+export function createApprovalRulesApi(current) {
+    return {
+        listApprovalRules: async () => ({
+            rules: await listApprovalRules(await requireMesh(current))
+        })
+    };
+}

package/dist-lib/lib/api/attachments.d.ts

@@ -0,0 +1,8 @@
+import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
+import { type CurrentMesh } from './current-mesh.ts';
+export { MAX_ATTACHMENT_BYTES } from '../core/files/attachments.ts';
+export declare function createAttachmentsApi(current: CurrentMesh, options?: {
+    maxBytes?: number;
+    deviceId?: Buffer | null;
+    inactivityMs?: number;
+}): Pick<CapabilityHandlers, 'uploadAttachment' | 'downloadAttachment' | 'deleteAttachment'>;

package/dist-lib/lib/api/attachments.js

@@ -0,0 +1,15 @@
+import { requireMesh } from "./current-mesh.js";
+export { MAX_ATTACHMENT_BYTES } from "../core/files/attachments.js";
+export function createAttachmentsApi(current, options = {}) {
+    return {
+        async *uploadAttachment(frames) {
+            yield* (await requireMesh(current)).files.attachments(options).uploadAttachment(frames);
+        },
+        async *downloadAttachment(request) {
+            yield* (await requireMesh(current)).files.attachments(options).downloadAttachment(request);
+        },
+        async deleteAttachment(request) {
+            return (await requireMesh(current)).files.attachments(options).deleteAttachment(request);
+        }
+    };
+}

package/dist-lib/lib/api/chat-groups.d.ts

@@ -0,0 +1,5 @@
+import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
+import { type CurrentMesh } from './current-mesh.ts';
+type ChatGroupCapabilities = Pick<CapabilityHandlers, 'createChatGroup' | 'listChatGroups' | 'renameChatGroup' | 'deleteChatGroup' | 'setChatGroup'>;
+export declare function createChatGroupsApi(current: CurrentMesh): ChatGroupCapabilities;
+export {};

package/dist-lib/lib/api/chat-groups.js

@@ -0,0 +1,12 @@
+import { createChatGroup, deleteChatGroup, listChatGroups, renameChatGroup } from "../core/chat-group.js";
+import { setChatGroup } from "../core/chat.js";
+import { requireMesh } from "./current-mesh.js";
+export function createChatGroupsApi(current) {
+    return {
+        createChatGroup: async ({ name }) => createChatGroup(await requireMesh(current), { name }),
+        listChatGroups: async () => listChatGroups(await requireMesh(current)).then((groups) => ({ groups })),
+        renameChatGroup: async ({ id, name }) => renameChatGroup(await requireMesh(current), id, name),
+        deleteChatGroup: async ({ id }) => deleteChatGroup(await requireMesh(current), id),
+        setChatGroup: async ({ id, groupId }) => setChatGroup(await requireMesh(current), id, groupId)
+    };
+}

package/dist-lib/lib/api/chat.d.ts

@@ -0,0 +1,5 @@
+import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
+import { type CurrentMesh } from './current-mesh.ts';
+type ChatCapabilities = Pick<CapabilityHandlers, 'createChat' | 'listChats' | 'getChat' | 'renameChat' | 'setChatRagEnabled' | 'setChatWebSearchEnabled' | 'deleteChat' | 'chatsWatch' | 'listChatActivity' | 'chatActivityWatch' | 'searchChats'>;
+export declare function createChatApi(current: CurrentMesh, deviceId: Buffer | null): ChatCapabilities;
+export {};