@qvac/core 0.2.2 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (176) hide show
  1. package/dist-lib/lib/api/agents.js +2 -3
  2. package/dist-lib/lib/api/chat.d.ts +3 -1
  3. package/dist-lib/lib/api/chat.js +9 -5
  4. package/dist-lib/lib/api/chunks.d.ts +1 -1
  5. package/dist-lib/lib/api/chunks.js +5 -15
  6. package/dist-lib/lib/api/current-mesh.d.ts +16 -1
  7. package/dist-lib/lib/api/current-mesh.js +18 -0
  8. package/dist-lib/lib/api/devices.js +6 -3
  9. package/dist-lib/lib/api/index.d.ts +2 -0
  10. package/dist-lib/lib/api/index.js +4 -2
  11. package/dist-lib/lib/api/inference-calls.d.ts +18 -0
  12. package/dist-lib/lib/api/inference-calls.js +15 -0
  13. package/dist-lib/lib/api/knowledge.js +11 -7
  14. package/dist-lib/lib/api/members.js +2 -3
  15. package/dist-lib/lib/api/rag.js +10 -2
  16. package/dist-lib/lib/api/sync.d.ts +1 -1
  17. package/dist-lib/lib/api/sync.js +2 -1
  18. package/dist-lib/lib/api/tool-activity.js +2 -2
  19. package/dist-lib/lib/api/tool-configs.js +2 -2
  20. package/dist-lib/lib/api/watchable.d.ts +6 -1
  21. package/dist-lib/lib/api/watchable.js +13 -2
  22. package/dist-lib/lib/assistant/harness.d.ts +1 -0
  23. package/dist-lib/lib/assistant/history.d.ts +1 -2
  24. package/dist-lib/lib/assistant/history.js +0 -6
  25. package/dist-lib/lib/assistant-tree.d.ts +2 -0
  26. package/dist-lib/lib/assistant-tree.js +11 -2
  27. package/dist-lib/lib/assistant.d.ts +17 -8
  28. package/dist-lib/lib/assistant.js +172 -125
  29. package/dist-lib/lib/core/chunk.d.ts +1 -0
  30. package/dist-lib/lib/core/chunk.js +32 -0
  31. package/dist-lib/lib/core/contract/devices.js +3 -2
  32. package/dist-lib/lib/core/files/rag/build.d.ts +1 -2
  33. package/dist-lib/lib/core/files/rag/build.js +1 -2
  34. package/dist-lib/lib/core/files/rag/extract/office-collabora.d.ts +1 -1
  35. package/dist-lib/lib/core/files/rag/index.d.ts +4 -24
  36. package/dist-lib/lib/core/files/rag/index.js +3 -17
  37. package/dist-lib/lib/core/files/rag/load.d.ts +1 -2
  38. package/dist-lib/lib/core/files/rag/load.js +1 -2
  39. package/dist-lib/lib/core/files/rag/produce.d.ts +1 -1
  40. package/dist-lib/lib/core/files/rag/produce.js +1 -3
  41. package/dist-lib/lib/core/files/rag/retrieval/full-text.d.ts +1 -1
  42. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +1 -4
  43. package/dist-lib/lib/core/files/rag/similarity.d.ts +5 -0
  44. package/dist-lib/lib/core/files/rag/similarity.js +6 -0
  45. package/dist-lib/lib/core/files/upload.d.ts +1 -1
  46. package/dist-lib/lib/core/harness-loan.js +1 -1
  47. package/dist-lib/lib/core/inference-calls-handoff.d.ts +20 -0
  48. package/dist-lib/lib/core/inference-calls-handoff.js +37 -0
  49. package/dist-lib/lib/core/inference-calls-receiver.d.ts +14 -0
  50. package/dist-lib/lib/core/inference-calls-receiver.js +39 -0
  51. package/dist-lib/lib/core/local/index.js +6 -0
  52. package/dist-lib/lib/core/notification.js +5 -4
  53. package/dist-lib/lib/core.d.ts +9 -1
  54. package/dist-lib/lib/core.js +98 -16
  55. package/dist-lib/lib/fs-drive-bridge.js +1 -1
  56. package/dist-lib/lib/inference-calls.d.ts +40 -0
  57. package/dist-lib/lib/inference-calls.js +266 -0
  58. package/dist-lib/lib/mesh-scoped-engine.js +5 -0
  59. package/dist-lib/lib/model-download.d.ts +2 -0
  60. package/dist-lib/lib/model-download.js +20 -5
  61. package/dist-lib/lib/oauth/keys.js +1 -0
  62. package/dist-lib/lib/oauth/spotify.js +1 -0
  63. package/dist-lib/lib/oauth/verify.d.ts +8 -0
  64. package/dist-lib/lib/oauth/verify.js +58 -0
  65. package/dist-lib/lib/oauth.d.ts +1 -0
  66. package/dist-lib/lib/oauth.js +1 -0
  67. package/dist-lib/schema/content.js +5 -1
  68. package/dist-lib/schema/engine.js +42 -1
  69. package/dist-lib/schema/qvac.d.ts +3 -0
  70. package/dist-lib/schema/qvac.js +11 -2
  71. package/dist-lib/spec/bind.js +3 -0
  72. package/dist-lib/spec/calls.js +1 -0
  73. package/dist-lib/spec/capabilities.d.ts +2 -0
  74. package/dist-lib/spec/hrpc/hrpc.json +13 -0
  75. package/dist-lib/spec/hrpc/index.js +15 -3
  76. package/dist-lib/spec/hrpc/messages.js +172 -49
  77. package/dist-lib/spec/hyperschema/index.js +172 -49
  78. package/dist-lib/spec/hyperschema/schema.json +127 -1
  79. package/dist-lib/spec/hyperschema/types.d.ts +34 -1
  80. package/dist-lib/spec/local/hyperdb/messages.js +64 -128
  81. package/dist-lib/spec/local/hyperschema/index.js +32 -64
  82. package/dist-lib/spec/local/hyperschema/schema.json +16 -0
  83. package/dist-lib/spec/mesh/hyperdb/messages.js +176 -311
  84. package/dist-lib/spec/mesh/hyperdispatch/messages.js +132 -236
  85. package/dist-lib/spec/mesh/hyperschema/index.js +132 -236
  86. package/dist-lib/spec/mesh/hyperschema/schema.json +70 -1
  87. package/dist-lib/spec/mesh/hyperschema/types.d.ts +3 -1
  88. package/package.json +14 -17
  89. package/tui/app.mjs +327 -46
  90. package/tui/lib/knowledge-import.mjs +1 -1
  91. package/tui/lib/render.mjs +17 -1
  92. package/tui/lib/selection.mjs +16 -0
  93. package/tui/lib/usage.mjs +54 -0
  94. package/.claude/skills/asana/SKILL.md +0 -86
  95. package/.claude/skills/compaction/SKILL.md +0 -132
  96. package/.claude/skills/device-mesh-debug/SKILL.md +0 -328
  97. package/.claude/skills/gh-stack/SKILL.md +0 -181
  98. package/.claude/skills/gh-stack/references/commands.md +0 -177
  99. package/.claude/skills/gh-stack/references/stack-design.md +0 -97
  100. package/.claude/skills/gh-stack/references/troubleshooting.md +0 -159
  101. package/.claude/skills/js-house-style/SKILL.md +0 -670
  102. package/.claude/skills/pr-create/SKILL.md +0 -201
  103. package/.claude/skills/pr-review/SKILL.md +0 -424
  104. package/CLAUDE.md +0 -43
  105. package/dist-lib/lib/core/files/rag/artifact/codec.d.ts +0 -3
  106. package/dist-lib/lib/core/files/rag/artifact/codec.js +0 -172
  107. package/dist-lib/lib/core/files/rag/artifact/id.d.ts +0 -10
  108. package/dist-lib/lib/core/files/rag/artifact/id.js +0 -39
  109. package/dist-lib/lib/core/files/rag/artifact/types.d.ts +0 -24
  110. package/dist-lib/lib/core/files/rag/artifact/types.js +0 -41
  111. package/dist-lib/lib/core/files/rag/chunk/chunking.d.ts +0 -12
  112. package/dist-lib/lib/core/files/rag/chunk/chunking.js +0 -117
  113. package/dist-lib/lib/core/files/rag/chunk/metadata.d.ts +0 -30
  114. package/dist-lib/lib/core/files/rag/chunk/metadata.js +0 -89
  115. package/dist-lib/lib/core/files/rag/chunk/tokenizer.d.ts +0 -7
  116. package/dist-lib/lib/core/files/rag/chunk/tokenizer.js +0 -18
  117. package/dist-lib/lib/core/files/rag/extract/csv-text.d.ts +0 -1
  118. package/dist-lib/lib/core/files/rag/extract/csv-text.js +0 -117
  119. package/dist-lib/lib/core/files/rag/extract/document-types.d.ts +0 -22
  120. package/dist-lib/lib/core/files/rag/extract/document-types.js +0 -152
  121. package/dist-lib/lib/core/files/rag/extract/extract.d.ts +0 -17
  122. package/dist-lib/lib/core/files/rag/extract/extract.js +0 -81
  123. package/dist-lib/lib/core/files/rag/extract/html-table-text.d.ts +0 -1
  124. package/dist-lib/lib/core/files/rag/extract/html-table-text.js +0 -125
  125. package/dist-lib/lib/core/files/rag/extract/html-text.d.ts +0 -1
  126. package/dist-lib/lib/core/files/rag/extract/html-text.js +0 -132
  127. package/dist-lib/lib/core/files/rag/extract/pdf-platform.d.ts +0 -17
  128. package/dist-lib/lib/core/files/rag/extract/pdf-platform.js +0 -141
  129. package/dist-lib/lib/core/files/rag/extract/pdf-text.d.ts +0 -12
  130. package/dist-lib/lib/core/files/rag/extract/pdf-text.js +0 -43
  131. package/dist-lib/lib/core/files/rag/extract/rtf-text.d.ts +0 -1
  132. package/dist-lib/lib/core/files/rag/extract/rtf-text.js +0 -15
  133. package/dist-lib/lib/core/files/rag/extract/text-decoding.d.ts +0 -1
  134. package/dist-lib/lib/core/files/rag/extract/text-decoding.js +0 -91
  135. package/dist-lib/lib/core/files/rag/extract/types.d.ts +0 -36
  136. package/dist-lib/lib/core/files/rag/extract/types.js +0 -12
  137. package/dist-lib/lib/core/files/rag/extract/utf.d.ts +0 -2
  138. package/dist-lib/lib/core/files/rag/extract/utf.js +0 -18
  139. package/dist-lib/lib/core/files/rag/retrieval/citation-match.d.ts +0 -2
  140. package/dist-lib/lib/core/files/rag/retrieval/citation-match.js +0 -16
  141. package/dist-lib/lib/core/files/rag/retrieval/coverage.d.ts +0 -4
  142. package/dist-lib/lib/core/files/rag/retrieval/coverage.js +0 -48
  143. package/dist-lib/lib/core/files/rag/retrieval/diversity.d.ts +0 -10
  144. package/dist-lib/lib/core/files/rag/retrieval/diversity.js +0 -37
  145. package/dist-lib/lib/core/files/rag/retrieval/floor.d.ts +0 -5
  146. package/dist-lib/lib/core/files/rag/retrieval/floor.js +0 -21
  147. package/dist-lib/lib/core/files/rag/retrieval/format.d.ts +0 -6
  148. package/dist-lib/lib/core/files/rag/retrieval/format.js +0 -21
  149. package/dist-lib/lib/core/files/rag/retrieval/knowledge.d.ts +0 -2
  150. package/dist-lib/lib/core/files/rag/retrieval/knowledge.js +0 -54
  151. package/dist-lib/lib/core/files/rag/retrieval/notices.d.ts +0 -16
  152. package/dist-lib/lib/core/files/rag/retrieval/notices.js +0 -27
  153. package/dist-lib/lib/core/files/rag/retrieval/scoring.d.ts +0 -8
  154. package/dist-lib/lib/core/files/rag/retrieval/scoring.js +0 -82
  155. package/dist-lib/lib/core/files/rag/retrieval/search.d.ts +0 -3
  156. package/dist-lib/lib/core/files/rag/retrieval/search.js +0 -49
  157. package/dist-lib/lib/core/files/rag/retrieval/selection.d.ts +0 -11
  158. package/dist-lib/lib/core/files/rag/retrieval/selection.js +0 -93
  159. package/dist-lib/lib/core/files/rag/retrieval/source-tag-filter.d.ts +0 -6
  160. package/dist-lib/lib/core/files/rag/retrieval/source-tag-filter.js +0 -79
  161. package/dist-lib/lib/core/files/rag/retrieval/sources.d.ts +0 -13
  162. package/dist-lib/lib/core/files/rag/retrieval/sources.js +0 -20
  163. package/dist-lib/lib/core/files/rag/retrieval/target.d.ts +0 -13
  164. package/dist-lib/lib/core/files/rag/retrieval/target.js +0 -89
  165. package/dist-lib/lib/core/files/rag/retrieval/terms.d.ts +0 -8
  166. package/dist-lib/lib/core/files/rag/retrieval/terms.js +0 -70
  167. package/dist-lib/lib/core/files/rag/retrieval/types.d.ts +0 -29
  168. package/dist-lib/lib/core/files/rag/retrieval/types.js +0 -1
  169. package/dist-lib/lib/core/files/rag/retrieval/web-sources.d.ts +0 -8
  170. package/dist-lib/lib/core/files/rag/retrieval/web-sources.js +0 -41
  171. package/dist-lib/lib/core/files/rag/retrieval/whole-document-query.d.ts +0 -1
  172. package/dist-lib/lib/core/files/rag/retrieval/whole-document-query.js +0 -96
  173. package/dist-lib/lib/core/files/rag/vector/memory.d.ts +0 -15
  174. package/dist-lib/lib/core/files/rag/vector/memory.js +0 -135
  175. package/dist-lib/lib/core/files/rag/vector/types.d.ts +0 -28
  176. package/dist-lib/lib/core/files/rag/vector/types.js +0 -1
@@ -1,6 +1,5 @@
1
1
  import { createAgent, deleteAgent, isOrphaned, listAgents, liveProviderIds, mustGetActiveAgent, updateAgent } from '../core/agent.js';
2
- import { requireMesh } from './current-mesh.js';
3
- import { watchable } from './watchable.js';
2
+ import { meshWatchable, requireMesh } from './current-mesh.js';
4
3
  export function createAgentsApi(current, deviceId, computeLender = null) {
5
4
  const withOrphaned = async (mesh, agent) => ({
6
5
  ...agent,
@@ -34,6 +33,6 @@ export function createAgentsApi(current, deviceId, computeLender = null) {
34
33
  const mesh = await requireMesh(current, meshId);
35
34
  return withOrphaned(mesh, await deleteAgent(mesh, deviceId, id));
36
35
  },
37
- agentsWatch: watchable('agentsWatch', (request) => requireMesh(current, request?.meshId), (_request, mesh) => list(mesh))
36
+ agentsWatch: meshWatchable('agentsWatch', current, (_request, mesh) => list(mesh))
38
37
  };
39
38
  }
@@ -1,5 +1,7 @@
1
1
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
2
  import { type CurrentMesh } from './current-mesh.ts';
3
3
  type ChatCapabilities = Pick<CapabilityHandlers, 'createChat' | 'listChats' | 'getChat' | 'renameChat' | 'setChatRagEnabled' | 'setChatWebSearchEnabled' | 'deleteChat' | 'chatsWatch' | 'listChatActivity' | 'chatActivityWatch' | 'searchChats'>;
4
- export declare function createChatApi(current: CurrentMesh, deviceId: Buffer | null): ChatCapabilities;
4
+ export declare function createChatApi(current: CurrentMesh, deviceId: Buffer | null, inferenceCalls?: {
5
+ forget(chatId: string): Promise<void>;
6
+ } | null): ChatCapabilities;
5
7
  export {};
@@ -2,10 +2,10 @@ import { AbortController } from 'bare-abort-controller';
2
2
  import { createChat, deleteChat, listSidebar, mustGetActiveChatListing, renameChat, setChatRagEnabled, setChatWebSearchEnabled } from '../core/chat.js';
3
3
  import { listChatActivity } from '../core/chat-activity.js';
4
4
  import { searchChats } from '../core/chat-search.js';
5
- import { requireMesh } from './current-mesh.js';
5
+ import { meshWatchable, requireMesh, selectionPin } from './current-mesh.js';
6
6
  import { watchable } from './watchable.js';
7
7
  const SEARCH_SUPERSEDED_ABORT = 'superseded by a newer chat search';
8
- export function createChatApi(current, deviceId) {
8
+ export function createChatApi(current, deviceId, inferenceCalls = null) {
9
9
  let searchAbort = null;
10
10
  const chatList = (mesh) => listSidebar(mesh);
11
11
  const chatActivity = (mesh, chatIds) => listChatActivity(mesh, chatIds ?? undefined).then((activities) => ({ activities }));
@@ -16,10 +16,14 @@ export function createChatApi(current, deviceId) {
16
16
  renameChat: async ({ id, title, meshId }) => renameChat(await requireMesh(current, meshId), id, title),
17
17
  setChatRagEnabled: async ({ id, enabled }) => setChatRagEnabled(await requireMesh(current), id, enabled ?? false),
18
18
  setChatWebSearchEnabled: async ({ id, enabled }) => setChatWebSearchEnabled(await requireMesh(current), id, enabled ?? false),
19
- deleteChat: async ({ id, meshId }) => deleteChat(await requireMesh(current, meshId), deviceId, id),
20
- chatsWatch: watchable('chatsWatch', (request) => requireMesh(current, request?.meshId), (_request, store) => chatList(store)),
19
+ deleteChat: async ({ id, meshId }) => {
20
+ const deleted = await deleteChat(await requireMesh(current, meshId), deviceId, id);
21
+ await inferenceCalls?.forget(id);
22
+ return deleted;
23
+ },
24
+ chatsWatch: meshWatchable('chatsWatch', current, (_request, store) => chatList(store)),
21
25
  listChatActivity: async (input) => chatActivity(await requireMesh(current), input?.chatIds),
22
- chatActivityWatch: watchable('chatActivityWatch', () => requireMesh(current), (request, store) => chatActivity(store, request?.chatIds)),
26
+ chatActivityWatch: watchable('chatActivityWatch', () => requireMesh(current), (request, store) => chatActivity(store, request?.chatIds), () => selectionPin(current)),
23
27
  searchChats: async (input) => {
24
28
  searchAbort?.abort(SEARCH_SUPERSEDED_ABORT);
25
29
  const controller = new AbortController();
@@ -1,5 +1,5 @@
1
1
  import { type CurrentMesh } from './current-mesh.ts';
2
2
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
3
3
  type ChunkCapabilities = Pick<CapabilityHandlers, 'appendChunk' | 'updateChunk' | 'resolveApproval' | 'listChunks' | 'listAttachmentsByKind' | 'chunksWatch' | 'runRequestsWatch'>;
4
- export declare function createChunksApi(current: CurrentMesh): ChunkCapabilities;
4
+ export declare function createChunksApi(current: CurrentMesh, deviceId: Buffer | null): ChunkCapabilities;
5
5
  export {};
@@ -1,7 +1,6 @@
1
- import { appendChunk, listAttachmentsByKind, listChunks, resolveApproval, updateChunk } from '../core/chunk.js';
2
- import { requireMesh } from './current-mesh.js';
3
- import { watchable } from './watchable.js';
4
- export function createChunksApi(current) {
1
+ import { appendChunk, listAttachmentsByKind, listChunks, listRunRequests, resolveApproval, updateChunk } from '../core/chunk.js';
2
+ import { meshWatchable, requireMesh } from './current-mesh.js';
3
+ export function createChunksApi(current, deviceId) {
5
4
  return {
6
5
  appendChunk: async ({ meshId, ...input }) => appendChunk(await requireMesh(current, meshId), input),
7
6
  updateChunk: async ({ meshId, ...input }) => {
@@ -37,7 +36,7 @@ export function createChunksApi(current) {
37
36
  limit: limit || undefined
38
37
  })
39
38
  }),
40
- chunksWatch: watchable('chunksWatch', (request) => requireMesh(current, request?.meshId), async ({ chatId, type, types, fromSeq, reverse, limit }, mesh) => ({
39
+ chunksWatch: meshWatchable('chunksWatch', current, async ({ chatId, type, types, fromSeq, reverse, limit }, mesh) => ({
41
40
  chunks: await listChunks(mesh, {
42
41
  chatId,
43
42
  type: type ?? undefined,
@@ -47,15 +46,6 @@ export function createChunksApi(current) {
47
46
  limit: limit || undefined
48
47
  })
49
48
  })),
50
- runRequestsWatch: watchable('runRequestsWatch', (request) => requireMesh(current, request?.meshId), async (_request, mesh) => {
51
- const snap = mesh.view.snapshot();
52
- try {
53
- const chunks = await snap.find('@qvac/run-requests').toArray();
54
- return { chunks };
55
- }
56
- finally {
57
- await snap.close();
58
- }
59
- })
49
+ runRequestsWatch: meshWatchable('runRequestsWatch', current, async (_request, mesh) => ({ chunks: await listRunRequests(mesh, deviceId) }))
60
50
  };
61
51
  }
@@ -1,6 +1,21 @@
1
1
  import type { Mesh } from '../core/mesh.ts';
2
- export type CurrentMesh = (meshId?: string | null) => Mesh | null | Promise<Mesh | null>;
2
+ import { type WatchPin } from './watchable.ts';
3
+ export interface CurrentMesh {
4
+ (meshId?: string | null): Mesh | null | Promise<Mesh | null>;
5
+ readonly selection?: MeshSelection;
6
+ }
7
+ export interface MeshSelection {
8
+ key(): string | null;
9
+ watch(listener: () => void): void;
10
+ unwatch(listener: () => void): void;
11
+ }
3
12
  export declare const NO_ACTIVE_MESH = "no active mesh";
4
13
  export declare const NO_SUCH_MESH = "no such mesh";
5
14
  export declare function requireMesh(current: CurrentMesh, meshId?: string | null): Promise<Mesh>;
6
15
  export declare function isMeshTransition(err: unknown): boolean;
16
+ export declare function meshWatchable<TRequest extends MeshScoped | undefined, TResult>(name: string, current: CurrentMesh, query: (request: TRequest, mesh: Mesh) => Promise<TResult>): (request: TRequest) => import("streamx").Readable<import("streamx").ReadableEvents> & AsyncIterable<TResult>;
17
+ export declare function selectionPin(current: CurrentMesh, meshId?: string | null): WatchPin | null;
18
+ interface MeshScoped {
19
+ readonly meshId?: string | null;
20
+ }
21
+ export {};
@@ -1,3 +1,4 @@
1
+ import { watchable } from './watchable.js';
1
2
  export const NO_ACTIVE_MESH = 'no active mesh';
2
3
  export const NO_SUCH_MESH = 'no such mesh';
3
4
  export async function requireMesh(current, meshId) {
@@ -11,3 +12,20 @@ export async function requireMesh(current, meshId) {
11
12
  export function isMeshTransition(err) {
12
13
  return err instanceof Error && err.message === NO_ACTIVE_MESH;
13
14
  }
15
+ export function meshWatchable(name, current, query) {
16
+ return watchable(name, (request) => requireMesh(current, request?.meshId), query, (request) => selectionPin(current, request?.meshId));
17
+ }
18
+ export function selectionPin(current, meshId) {
19
+ const selection = current.selection;
20
+ if (meshId || !selection)
21
+ return null;
22
+ const opened = selection.key();
23
+ return {
24
+ stale: () => {
25
+ const now = selection.key();
26
+ return now !== null && now !== opened;
27
+ },
28
+ watch: (listener) => selection.watch(listener),
29
+ unwatch: (listener) => selection.unwatch(listener)
30
+ };
31
+ }
@@ -1,6 +1,6 @@
1
+ import { MAX_DEVICE_NAME_CHARS, deviceNameWithinBounds } from '../../schema/qvac.js';
1
2
  import { saveDeviceCapabilities } from '../core/devices.js';
2
- import { requireMesh } from './current-mesh.js';
3
- import { watchable } from './watchable.js';
3
+ import { meshWatchable, requireMesh } from './current-mesh.js';
4
4
  const DEVICES = '@qvac/devices';
5
5
  function toEngineDevice(device, overrides = {}) {
6
6
  return {
@@ -49,7 +49,7 @@ export function createDevicesApi(current, deviceId, removeWriter, renameLocal, s
49
49
  };
50
50
  return {
51
51
  listDevices: async (request) => list(await requireMesh(current, request?.meshId)),
52
- devicesWatch: watchable('devicesWatch', (request) => requireMesh(current, request?.meshId), (_request, mesh) => list(mesh)),
52
+ devicesWatch: meshWatchable('devicesWatch', current, (_request, mesh) => list(mesh)),
53
53
  deviceInfo: async () => {
54
54
  logger.info(['api', 'devices'], 'deviceInfo handler reached');
55
55
  const computeLenderId = (await computeLender?.()) ?? undefined;
@@ -85,6 +85,9 @@ export function createDevicesApi(current, deviceId, removeWriter, renameLocal, s
85
85
  const trimmed = name.trim();
86
86
  if (!trimmed)
87
87
  throw new Error('device name must not be empty');
88
+ if (!deviceNameWithinBounds(trimmed)) {
89
+ throw new Error(`device name must be at most ${MAX_DEVICE_NAME_CHARS} characters`);
90
+ }
88
91
  const mesh = await requireMesh(current);
89
92
  const device = await mustGetDevice(mesh, id);
90
93
  await renameLocal(trimmed);
@@ -3,6 +3,7 @@ import type { AssistantCapabilityProfile, AssistantClearModelDownloadRequest, As
3
3
  import type { openLocalStore } from '../core/local/index.ts';
4
4
  import type { CurrentMesh } from './current-mesh.ts';
5
5
  import { type DiagnosticsSource } from './diagnostics.ts';
6
+ import { type InferenceCallReader } from './inference-calls.ts';
6
7
  import { type LogSource } from './logs.ts';
7
8
  import { type MeshStatusSource } from './mesh.ts';
8
9
  import { type NetworkSource } from './network.ts';
@@ -15,6 +16,7 @@ interface ApiDeps {
15
16
  meshStatus?: MeshStatusSource | null;
16
17
  network?: NetworkSource | null;
17
18
  diagnostics?: DiagnosticsSource | null;
19
+ inferenceCalls?: InferenceCallReader | null;
18
20
  logs?: LogSource | null;
19
21
  deviceId?: Buffer | null;
20
22
  lifecycle?: {
@@ -11,6 +11,7 @@ import { createAppConfigApi } from './app-config.js';
11
11
  import { createConfigApi } from './config.js';
12
12
  import { createDevicesApi } from './devices.js';
13
13
  import { createDiagnosticsApi } from './diagnostics.js';
14
+ import { createInferenceCallsApi } from './inference-calls.js';
14
15
  import { createExecutionApi } from './execution.js';
15
16
  import { createKnowledgeApi } from './knowledge.js';
16
17
  import { createFilesApi } from './files.js';
@@ -38,10 +39,10 @@ export function createApi(deps = {}) {
38
39
  ...(state ? createModelDownloadApi(state) : null),
39
40
  ...(state ? createCustomModelApi(state) : null),
40
41
  ...(mesh ? createAgentsApi(mesh, deps.deviceId ?? null, deps.computeLender ?? null) : null),
41
- ...(mesh ? createChatApi(mesh, deps.deviceId ?? null) : null),
42
+ ...(mesh ? createChatApi(mesh, deps.deviceId ?? null, deps.inferenceCalls ?? null) : null),
42
43
  ...(mesh ? createChatGroupsApi(mesh) : null),
43
44
  ...(mesh ? createApprovalRulesApi(mesh) : null),
44
- ...(mesh ? createChunksApi(mesh) : null),
45
+ ...(mesh ? createChunksApi(mesh, deps.deviceId ?? null) : null),
45
46
  ...(mesh && deps.deviceId && deps.deviceHost
46
47
  ? createDevicesApi(mesh, deps.deviceId, deps.deviceHost.removeWriter, deps.deviceHost.renameLocal, deps.deviceHost.saveProfileLocal, deps.deviceHost.readLocalProfile, deps.computeLender ?? null)
47
48
  : null),
@@ -68,6 +69,7 @@ export function createApi(deps = {}) {
68
69
  ...(mesh ? createMembersApi(mesh, state) : null),
69
70
  ...(deps.network ? createNetworkApi(deps.network) : null),
70
71
  ...(deps.diagnostics ? createDiagnosticsApi(deps.diagnostics) : null),
72
+ ...(deps.inferenceCalls ? createInferenceCallsApi(deps.inferenceCalls) : null),
71
73
  ...(deps.logs ? createLogsApi(deps.logs) : null),
72
74
  ...(deps.lifecycle
73
75
  ? {
@@ -0,0 +1,18 @@
1
+ import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
+ import type { InferenceCallEntry } from '../inference-calls.ts';
3
+ export interface InferenceCallSource {
4
+ list(chatId: string): {
5
+ calls: ReadonlyArray<InferenceCallEntry>;
6
+ truncated: boolean;
7
+ };
8
+ forget(chatId: string): Promise<void>;
9
+ }
10
+ export interface InferenceCallAnswer {
11
+ calls: ReadonlyArray<InferenceCallEntry>;
12
+ truncated: boolean;
13
+ }
14
+ export interface InferenceCallReader {
15
+ list(chatId: string): Promise<InferenceCallAnswer>;
16
+ forget(chatId: string): Promise<void>;
17
+ }
18
+ export declare function createInferenceCallsApi(reader: InferenceCallReader): Pick<CapabilityHandlers, 'inferenceCalls'>;
@@ -0,0 +1,15 @@
1
+ export function createInferenceCallsApi(reader) {
2
+ return {
3
+ inferenceCalls: async ({ chatId }) => {
4
+ const answer = await reader.list(chatId);
5
+ return {
6
+ calls: answer.calls.map((entry) => ({
7
+ runId: entry.runId,
8
+ at: entry.at,
9
+ call: entry.call
10
+ })),
11
+ truncated: answer.truncated
12
+ };
13
+ }
14
+ };
15
+ }
@@ -1,4 +1,4 @@
1
- import { requireMesh } from './current-mesh.js';
1
+ import { requireMesh, selectionPin } from './current-mesh.js';
2
2
  import { watchable } from './watchable.js';
3
3
  export { MAX_KNOWLEDGE_BYTES } from '../core/files/knowledge.js';
4
4
  export function createKnowledgeApi(current, options = {}) {
@@ -13,14 +13,18 @@ export function createKnowledgeApi(current, options = {}) {
13
13
  return (await requireMesh(current)).files.knowledge(options).removeKnowledge(request);
14
14
  },
15
15
  async listKnowledge(request) {
16
- return (await requireMesh(current)).files.knowledge(options).listKnowledge(request);
16
+ return (await requireMesh(current, request?.meshId)).files
17
+ .knowledge(options)
18
+ .listKnowledge(request);
17
19
  },
18
20
  async listIndexing(request) {
19
- return (await requireMesh(current)).files.knowledge(options).listIndexing(request);
21
+ return (await requireMesh(current, request?.meshId)).files
22
+ .knowledge(options)
23
+ .listIndexing(request);
20
24
  },
21
- knowledgeWatch: watchable('knowledgeWatch', () => requireMesh(current), async (request, mesh) => mesh.files.knowledge(options).listKnowledge(request)),
22
- indexingWatch: watchable('indexingWatch', async () => (await requireMesh(current)).files, ({ chatId }, files) => files.listIndexing(chatId)),
23
- fileStatusWatch: watchable('fileStatusWatch', async (request) => (await requireMesh(current, request?.meshId)).files, ({ chatId }, files) => files.status(chatId)),
24
- indexingProgressWatch: watchable('indexingProgressWatch', async () => (await requireMesh(current)).files, ({ chatId }, files) => Promise.resolve({ entries: files.progress(chatId) }))
25
+ knowledgeWatch: watchable('knowledgeWatch', (request) => requireMesh(current, request?.meshId), async (request, mesh) => mesh.files.knowledge(options).listKnowledge(request), (request) => selectionPin(current, request?.meshId)),
26
+ indexingWatch: watchable('indexingWatch', async (request) => (await requireMesh(current, request?.meshId)).files, ({ chatId }, files) => files.listIndexing(chatId), (request) => selectionPin(current, request?.meshId)),
27
+ fileStatusWatch: watchable('fileStatusWatch', async (request) => (await requireMesh(current, request?.meshId)).files, ({ chatId }, files) => files.status(chatId), (request) => selectionPin(current, request?.meshId)),
28
+ indexingProgressWatch: watchable('indexingProgressWatch', async (request) => (await requireMesh(current, request?.meshId)).files, ({ chatId }, files) => Promise.resolve({ entries: files.progress(chatId) }), (request) => selectionPin(current, request?.meshId))
25
29
  };
26
30
  }
@@ -1,5 +1,4 @@
1
- import { requireMesh } from './current-mesh.js';
2
- import { watchable } from './watchable.js';
1
+ import { meshWatchable, requireMesh } from './current-mesh.js';
3
2
  const MEMBERS = '@qvac/members';
4
3
  const DEVICES = '@qvac/devices';
5
4
  const RESOLVE_MEMBER_MS = 10_000;
@@ -62,7 +61,7 @@ export function createMembersApi(current, state = null) {
62
61
  };
63
62
  return {
64
63
  listMembers: async (request) => list(await requireMesh(current, request?.meshId)),
65
- membersWatch: watchable('membersWatch', (request) => requireMesh(current, request?.meshId), (_request, mesh) => list(mesh)),
64
+ membersWatch: meshWatchable('membersWatch', current, (_request, mesh) => list(mesh)),
66
65
  updateMember: async ({ id, name, meshId }) => {
67
66
  const mesh = await requireMesh(current, meshId);
68
67
  const trimmed = name.trim();
@@ -138,7 +138,11 @@ export function createRagApi(current, index, embedder, effectiveCtxSize = null)
138
138
  chatId,
139
139
  limit: clampLimit(limit),
140
140
  liveSourceIds: rows.map((row) => row.id)
141
- }, { index: vectorIndex, embed: (texts) => embed.embed({ texts }) });
141
+ }, {
142
+ index: vectorIndex,
143
+ embed: (texts) => embed.embed({ texts }),
144
+ debug: (message) => logger.debug('rag', message)
145
+ });
142
146
  return respond({
143
147
  searchedCount: hits.length,
144
148
  indexEmpty,
@@ -163,7 +167,11 @@ export function createRagApi(current, index, embedder, effectiveCtxSize = null)
163
167
  documents: hydratedDocuments,
164
168
  liveSourceIds: rows.map((row) => row.id),
165
169
  scopeDocumentIds: scopeDocumentIds.length > 0 ? scopeDocumentIds : undefined
166
- }, { index: vectorIndex, embed: (texts) => embed.embed({ texts }) });
170
+ }, {
171
+ index: vectorIndex,
172
+ embed: (texts) => embed.embed({ texts }),
173
+ debug: (message) => logger.debug('rag', message)
174
+ });
167
175
  return respond({
168
176
  searchedCount: result.searchedCount,
169
177
  indexEmpty,
@@ -1,3 +1,3 @@
1
1
  import type { CapabilityHandlers } from '../../spec/capabilities.d.ts';
2
- import type { CurrentMesh } from './current-mesh.ts';
2
+ import { type CurrentMesh } from './current-mesh.ts';
3
3
  export declare function createSyncApi(current: CurrentMesh): Pick<CapabilityHandlers, 'syncStatusWatch'>;
@@ -1,6 +1,7 @@
1
+ import { selectionPin } from './current-mesh.js';
1
2
  import { watchable } from './watchable.js';
2
3
  export function createSyncApi(current) {
3
4
  return {
4
- syncStatusWatch: watchable('syncStatusWatch', async () => (await current())?.syncActivity ?? null, (_request, activity) => activity.snapshot())
5
+ syncStatusWatch: watchable('syncStatusWatch', async () => (await current())?.syncActivity ?? null, (_request, activity) => activity.snapshot(), () => selectionPin(current))
5
6
  };
6
7
  }
@@ -1,5 +1,5 @@
1
1
  import { listToolActivity, recordToolActivity } from '../core/tool-activity.js';
2
- import { requireMesh } from './current-mesh.js';
2
+ import { requireMesh, selectionPin } from './current-mesh.js';
3
3
  import { watchable } from './watchable.js';
4
4
  const DEFAULT_LIMIT = 200;
5
5
  const MAX_LIMIT = 1000;
@@ -32,7 +32,7 @@ export function createToolActivityApi(current, deviceId) {
32
32
  });
33
33
  return {
34
34
  listToolActivity: async (request) => query(request, await requireMesh(current)),
35
- toolActivityWatch: watchable('toolActivityWatch', () => requireMesh(current), query),
35
+ toolActivityWatch: watchable('toolActivityWatch', () => requireMesh(current), query, () => selectionPin(current)),
36
36
  recordToolActivity: async (request) => {
37
37
  if (!deviceId)
38
38
  throw new Error('cannot record tool activity without a device id');
@@ -1,5 +1,5 @@
1
1
  import { deleteToolConfigs, getToolConfigs, listToolConfigs, setToolConfigs } from '../core/tool-configs.js';
2
- import { requireMesh } from './current-mesh.js';
2
+ import { requireMesh, selectionPin } from './current-mesh.js';
3
3
  import { watchable } from './watchable.js';
4
4
  function isRecord(value) {
5
5
  return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -21,7 +21,7 @@ export function createToolConfigsApi(current) {
21
21
  }),
22
22
  deleteToolConfigs: async ({ agentId, toolName }) => deleteToolConfigs(await requireMesh(current), agentId, toolName),
23
23
  listToolConfigs: async (request) => query(request, await requireMesh(current, request.meshId)),
24
- toolConfigsWatch: watchable('toolConfigsWatch', (request) => requireMesh(current, request?.meshId), query)
24
+ toolConfigsWatch: watchable('toolConfigsWatch', (request) => requireMesh(current, request?.meshId), query, (request) => selectionPin(current, request?.meshId))
25
25
  };
26
26
  }
27
27
  export { getToolConfigs };
@@ -1,5 +1,10 @@
1
1
  import { Readable } from 'streamx';
2
2
  import '../logger.ts';
3
+ export interface WatchPin {
4
+ stale(): boolean;
5
+ watch(listener: () => void): void;
6
+ unwatch(listener: () => void): void;
7
+ }
3
8
  interface WatchableStore {
4
9
  watch(listener: () => void): void;
5
10
  unwatch(listener: () => void): void;
@@ -8,5 +13,5 @@ interface WatchableStore {
8
13
  closing?: unknown;
9
14
  closed?: boolean;
10
15
  }
11
- export declare function watchable<TRequest, TResult, TStore extends WatchableStore = WatchableStore>(name: string, storeOf: (request: TRequest) => TStore | null | Promise<TStore | null>, query: (request: TRequest, store: TStore) => Promise<TResult>): (request: TRequest) => Readable & AsyncIterable<TResult>;
16
+ export declare function watchable<TRequest, TResult, TStore extends WatchableStore = WatchableStore>(name: string, storeOf: (request: TRequest) => TStore | null | Promise<TStore | null>, query: (request: TRequest, store: TStore) => Promise<TResult>, pinOf?: (request: TRequest) => WatchPin | null): (request: TRequest) => Readable & AsyncIterable<TResult>;
12
17
  export {};
@@ -24,8 +24,9 @@ function snapshotEquals(a, b) {
24
24
  function isRecord(value) {
25
25
  return typeof value === 'object' && value !== null;
26
26
  }
27
- export function watchable(name, storeOf, query) {
27
+ export function watchable(name, storeOf, query, pinOf) {
28
28
  return (request) => {
29
+ const pin = pinOf?.(request) ?? null;
29
30
  const resolved = storeOf(request);
30
31
  const pending = resolved instanceof Promise ? resolved.catch(noop) : null;
31
32
  let store = resolved instanceof Promise ? null : resolved;
@@ -56,13 +57,22 @@ export function watchable(name, storeOf, query) {
56
57
  wake?.resolve();
57
58
  wake = null;
58
59
  };
59
- const storeGone = () => store === null || ended || Boolean(store.closed) || Boolean(store.closing);
60
+ const onPinMove = () => {
61
+ if (pin?.stale())
62
+ onStoreClose();
63
+ };
64
+ const storeGone = () => store === null ||
65
+ ended ||
66
+ Boolean(store.closed) ||
67
+ Boolean(store.closing) ||
68
+ Boolean(pin?.stale());
60
69
  const stream = new Readable({
61
70
  async open(cb) {
62
71
  if (pending)
63
72
  store = (await pending) ?? null;
64
73
  store?.watch(onChange);
65
74
  store?.once?.('close', onStoreClose);
75
+ pin?.watch(onPinMove);
66
76
  cb(null);
67
77
  },
68
78
  async read(cb) {
@@ -112,6 +122,7 @@ export function watchable(name, storeOf, query) {
112
122
  reportChurn(true);
113
123
  store?.unwatch(onChange);
114
124
  store?.off?.('close', onStoreClose);
125
+ pin?.unwatch(onPinMove);
115
126
  cb(null);
116
127
  }
117
128
  });
@@ -67,6 +67,7 @@ export interface Harness {
67
67
  cacheKey?: string;
68
68
  thinkingDefault?: string;
69
69
  toolConfigs?: Record<string, Record<string, unknown>>;
70
+ captureInferenceCalls?: boolean;
70
71
  grantedDirs?: string[];
71
72
  grantedDrives?: GrantedDrive[];
72
73
  driveOp?: DriveOpFn;
@@ -17,14 +17,13 @@ export interface CompactOptions {
17
17
  readonly onFold?: () => Promise<void> | void;
18
18
  readonly meshId?: string;
19
19
  }
20
- export type CompactionTrigger = 'before-run' | 'turn-filled-window' | 'overflow';
20
+ export type CompactionTrigger = 'before-run' | 'overflow';
21
21
  export interface CompactResult {
22
22
  readonly compacted: boolean;
23
23
  readonly foldedTurns?: number;
24
24
  readonly reason?: string;
25
25
  }
26
26
  export declare function historyFromChunks(chunks: ReadonlyArray<AssistantChunk>, stale?: Partial<StaleToolRuns>): ChatMessage[];
27
- export declare function withoutOccupancy(metrics: Record<string, unknown> | undefined): typeof metrics;
28
27
  export declare function inputAvailableToRun(chunk: AssistantChunk, requestSeq: number): boolean;
29
28
  export declare function normalizeQuestion(text: string): string;
30
29
  export declare const GENERIC_ACKNOWLEDGEMENTS: Set<string>;
@@ -127,12 +127,6 @@ export function historyFromChunks(chunks, stale = {}) {
127
127
  }
128
128
  return history.filter((turn) => turn.role === 'user' || turn.content.length > 0);
129
129
  }
130
- export function withoutOccupancy(metrics) {
131
- if (!metrics)
132
- return metrics;
133
- const { cacheTokens, promptTokens, ...rest } = metrics;
134
- return rest;
135
- }
136
130
  export function inputAvailableToRun(chunk, requestSeq) {
137
131
  const userInput = Boolean(chunk.userMessage || (chunk.attachment && !chunk.runId));
138
132
  return !userInput || chunk.seq < requestSeq;
@@ -21,6 +21,7 @@ export interface AssistantTreeOptions {
21
21
  harness: HarnessFactory | ChildSpec<Harness>;
22
22
  logger?: Logger | null;
23
23
  imageCacheDir?: string;
24
+ inferenceCallsDir?: string;
24
25
  imageCacheMaxBytes?: number;
25
26
  imageCacheMaxAgeMs?: number;
26
27
  embedder?: EmbedderFactory;
@@ -35,6 +36,7 @@ export interface AssistantChildOptions {
35
36
  core?: string;
36
37
  logger?: Logger | null;
37
38
  imageCacheDir?: string;
39
+ inferenceCallsDir?: string;
38
40
  imageCacheMaxBytes?: number;
39
41
  imageCacheMaxAgeMs?: number;
40
42
  embedder?: EmbedderFactory;
@@ -5,7 +5,7 @@ import { startCustomModelPusher } from './custom-model-pusher.js';
5
5
  import { serveHarness } from '@qvac/harness';
6
6
  import { duplexPair } from '@qvac/harness/transport';
7
7
  export function assistantTree(opts) {
8
- const { core, harness, logger = null, imageCacheDir, imageCacheMaxBytes, imageCacheMaxAgeMs, embedder, extractors, onHarness, platform, preloadCurrentAgentModel } = opts;
8
+ const { core, harness, logger = null, imageCacheDir, inferenceCallsDir, imageCacheMaxBytes, imageCacheMaxAgeMs, embedder, extractors, onHarness, platform, preloadCurrentAgentModel } = opts;
9
9
  const sup = new Supervisor();
10
10
  const logged = ['child-died', 'child-restarting', 'child-ready', 'gave-up', 'stall'];
11
11
  for (const event of logged) {
@@ -13,6 +13,7 @@ export function assistantTree(opts) {
13
13
  }
14
14
  sup.on('power', (payload) => logger?.info('assistant-tree', 'power', payload));
15
15
  let offDiagnostics = null;
16
+ let offInferenceCalls = null;
16
17
  let offListModels = null;
17
18
  let offDeleteModel = null;
18
19
  let offClearKvCache = null;
@@ -59,6 +60,7 @@ export function assistantTree(opts) {
59
60
  const assistant = new QvacAssistant(engine, harness, {
60
61
  logger,
61
62
  imageCacheDir,
63
+ ...(inferenceCallsDir ? { inferenceCallsDir } : {}),
62
64
  imageCacheMaxBytes,
63
65
  imageCacheMaxAgeMs,
64
66
  ...(platform ? { platform } : {}),
@@ -67,6 +69,10 @@ export function assistantTree(opts) {
67
69
  borrowHarness: (deviceId) => core.borrowHarness(deviceId)
68
70
  });
69
71
  offDiagnostics = core.registerDiagnostics(() => assistant.diagnosticsSlice());
72
+ offInferenceCalls = core.registerInferenceCalls({
73
+ list: (chatId) => assistant.inferenceCalls(chatId),
74
+ forget: (chatId) => assistant.forgetInferenceCalls(chatId)
75
+ });
70
76
  offListModels = core.registerListModels(harnessListModels(harness));
71
77
  offDeleteModel = core.registerDeleteModel(harnessDeleteModel(harness));
72
78
  offClearKvCache = core.registerClearKvCache(harnessClearKvCache(harness));
@@ -116,6 +122,8 @@ export function assistantTree(opts) {
116
122
  stop: async (assistant) => {
117
123
  offDiagnostics?.();
118
124
  offDiagnostics = null;
125
+ offInferenceCalls?.();
126
+ offInferenceCalls = null;
119
127
  offListModels?.();
120
128
  offListModels = null;
121
129
  offDeleteModel?.();
@@ -162,7 +170,7 @@ export function assistantTree(opts) {
162
170
  return sup;
163
171
  }
164
172
  export function assistantChild(opts) {
165
- const { harness, core = 'core', logger = null, imageCacheDir, imageCacheMaxBytes, imageCacheMaxAgeMs, embedder, extractors, onHarness, preloadCurrentAgentModel, ...spec } = opts;
173
+ const { harness, core = 'core', logger = null, imageCacheDir, inferenceCallsDir, imageCacheMaxBytes, imageCacheMaxAgeMs, embedder, extractors, onHarness, preloadCurrentAgentModel, ...spec } = opts;
166
174
  return {
167
175
  ...spec,
168
176
  deps: [core],
@@ -172,6 +180,7 @@ export function assistantChild(opts) {
172
180
  harness,
173
181
  logger,
174
182
  imageCacheDir,
183
+ ...(inferenceCallsDir ? { inferenceCallsDir } : {}),
175
184
  imageCacheMaxBytes,
176
185
  imageCacheMaxAgeMs,
177
186
  embedder,