@qvac/core 0.2.0 → 0.2.2

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 (265) hide show
  1. package/.claude/skills/compaction/SKILL.md +9 -4
  2. package/.claude/skills/pr-create/SKILL.md +24 -3
  3. package/.claude/skills/pr-review/SKILL.md +248 -40
  4. package/CLAUDE.md +1 -3
  5. package/README.md +3 -1
  6. package/dist-lib/client.js +1 -1
  7. package/dist-lib/index.js +8 -8
  8. package/dist-lib/lib/api/agents.d.ts +1 -1
  9. package/dist-lib/lib/api/agents.js +10 -9
  10. package/dist-lib/lib/api/app-config.js +1 -1
  11. package/dist-lib/lib/api/approval-rules.js +9 -5
  12. package/dist-lib/lib/api/attachments.js +25 -3
  13. package/dist-lib/lib/api/chat-groups.d.ts +1 -1
  14. package/dist-lib/lib/api/chat-groups.js +5 -4
  15. package/dist-lib/lib/api/chat.js +8 -8
  16. package/dist-lib/lib/api/chunks.js +11 -11
  17. package/dist-lib/lib/api/config.js +1 -1
  18. package/dist-lib/lib/api/custom-models.js +2 -2
  19. package/dist-lib/lib/api/devices.d.ts +1 -1
  20. package/dist-lib/lib/api/devices.js +9 -9
  21. package/dist-lib/lib/api/diagnostics.js +1 -1
  22. package/dist-lib/lib/api/effective-ctx-size.js +1 -1
  23. package/dist-lib/lib/api/execution.js +4 -4
  24. package/dist-lib/lib/api/files.js +2 -2
  25. package/dist-lib/lib/api/index.d.ts +1 -0
  26. package/dist-lib/lib/api/index.js +33 -33
  27. package/dist-lib/lib/api/instrument.js +1 -1
  28. package/dist-lib/lib/api/knowledge.js +4 -4
  29. package/dist-lib/lib/api/logs.js +1 -1
  30. package/dist-lib/lib/api/members.d.ts +4 -1
  31. package/dist-lib/lib/api/members.js +88 -18
  32. package/dist-lib/lib/api/mesh.d.ts +13 -3
  33. package/dist-lib/lib/api/mesh.js +25 -2
  34. package/dist-lib/lib/api/model-download.js +1 -1
  35. package/dist-lib/lib/api/network.js +1 -1
  36. package/dist-lib/lib/api/notifications.js +3 -3
  37. package/dist-lib/lib/api/rag.js +7 -7
  38. package/dist-lib/lib/api/sync.js +1 -1
  39. package/dist-lib/lib/api/tool-activity.js +4 -4
  40. package/dist-lib/lib/api/tool-configs.js +5 -5
  41. package/dist-lib/lib/api/watchable.js +1 -1
  42. package/dist-lib/lib/assistant/fetch-body.d.ts +5 -0
  43. package/dist-lib/lib/assistant/fetch-body.js +36 -0
  44. package/dist-lib/lib/assistant/harness.d.ts +225 -0
  45. package/dist-lib/lib/assistant/harness.js +154 -0
  46. package/dist-lib/lib/assistant/history.d.ts +32 -0
  47. package/dist-lib/lib/assistant/history.js +232 -0
  48. package/dist-lib/lib/assistant/message.d.ts +45 -0
  49. package/dist-lib/lib/assistant/message.js +47 -0
  50. package/dist-lib/lib/assistant/skill-encode.d.ts +21 -0
  51. package/dist-lib/lib/assistant/skill-encode.js +71 -0
  52. package/dist-lib/lib/assistant-client.js +2 -2
  53. package/dist-lib/lib/assistant-tree.js +10 -4
  54. package/dist-lib/lib/assistant.d.ts +25 -285
  55. package/dist-lib/lib/assistant.js +250 -637
  56. package/dist-lib/lib/audio-format.js +2 -2
  57. package/dist-lib/lib/client.js +2 -2
  58. package/dist-lib/lib/collabora/convert.js +1 -1
  59. package/dist-lib/lib/collabora/entry.js +1 -1
  60. package/dist-lib/lib/collabora/worker.js +1 -1
  61. package/dist-lib/lib/compaction.d.ts +1 -2
  62. package/dist-lib/lib/compaction.js +8 -6
  63. package/dist-lib/lib/constants.js +1 -1
  64. package/dist-lib/lib/core/account-recovery.d.ts +19 -0
  65. package/dist-lib/lib/core/account-recovery.js +50 -0
  66. package/dist-lib/lib/core/agent.js +8 -4
  67. package/dist-lib/lib/core/app-build.d.ts +1 -1
  68. package/dist-lib/lib/core/approval-rules.d.ts +1 -0
  69. package/dist-lib/lib/core/approval-rules.js +3 -1
  70. package/dist-lib/lib/core/archived-mesh.d.ts +25 -0
  71. package/dist-lib/lib/core/archived-mesh.js +162 -0
  72. package/dist-lib/lib/core/chat-activity.js +1 -1
  73. package/dist-lib/lib/core/chat-group.d.ts +1 -0
  74. package/dist-lib/lib/core/chat-group.js +24 -4
  75. package/dist-lib/lib/core/chat-search.js +2 -2
  76. package/dist-lib/lib/core/chat.js +5 -5
  77. package/dist-lib/lib/core/chunk.d.ts +1 -1
  78. package/dist-lib/lib/core/chunk.js +4 -4
  79. package/dist-lib/lib/core/contract/agents.js +1 -1
  80. package/dist-lib/lib/core/contract/approval-rules.js +6 -4
  81. package/dist-lib/lib/core/contract/attestations.js +1 -1
  82. package/dist-lib/lib/core/contract/chat-group.js +1 -1
  83. package/dist-lib/lib/core/contract/chat.js +1 -1
  84. package/dist-lib/lib/core/contract/chunks.js +2 -2
  85. package/dist-lib/lib/core/contract/compute.d.ts +11 -0
  86. package/dist-lib/lib/core/contract/compute.js +45 -0
  87. package/dist-lib/lib/core/contract/devices.js +16 -3
  88. package/dist-lib/lib/core/contract/index.d.ts +3 -1
  89. package/dist-lib/lib/core/contract/index.js +19 -16
  90. package/dist-lib/lib/core/contract/indexing.js +2 -2
  91. package/dist-lib/lib/core/contract/joined-meshes.js +1 -1
  92. package/dist-lib/lib/core/contract/knowledge.js +2 -2
  93. package/dist-lib/lib/core/contract/members.js +2 -2
  94. package/dist-lib/lib/core/contract/seal.d.ts +2 -0
  95. package/dist-lib/lib/core/contract/seal.js +8 -0
  96. package/dist-lib/lib/core/contract/seed-defaults.js +1 -1
  97. package/dist-lib/lib/core/contract/tool-activity.js +1 -1
  98. package/dist-lib/lib/core/contract/tool-configs.js +3 -3
  99. package/dist-lib/lib/core/contract/writers.js +66 -42
  100. package/dist-lib/lib/core/departures.js +1 -1
  101. package/dist-lib/lib/core/device-invites.js +1 -1
  102. package/dist-lib/lib/core/document-attachment.js +2 -2
  103. package/dist-lib/lib/core/files/attachments.js +3 -3
  104. package/dist-lib/lib/core/files/index.d.ts +2 -2
  105. package/dist-lib/lib/core/files/index.js +19 -19
  106. package/dist-lib/lib/core/files/knowledge.js +3 -3
  107. package/dist-lib/lib/core/files/preview/image.js +1 -1
  108. package/dist-lib/lib/core/files/preview/index.js +6 -6
  109. package/dist-lib/lib/core/files/processing/claims.js +1 -1
  110. package/dist-lib/lib/core/files/processing/document.js +5 -5
  111. package/dist-lib/lib/core/files/processing/index.js +8 -8
  112. package/dist-lib/lib/core/files/processing/ownership.js +1 -1
  113. package/dist-lib/lib/core/files/processing/protocol.js +3 -3
  114. package/dist-lib/lib/core/files/processing/source.js +1 -1
  115. package/dist-lib/lib/core/files/rag/artifact/codec.js +1 -1
  116. package/dist-lib/lib/core/files/rag/artifact/id.js +1 -1
  117. package/dist-lib/lib/core/files/rag/artifact/types.d.ts +4 -4
  118. package/dist-lib/lib/core/files/rag/build.js +2 -2
  119. package/dist-lib/lib/core/files/rag/chunk/chunking.js +2 -2
  120. package/dist-lib/lib/core/files/rag/document-types.d.ts +3 -3
  121. package/dist-lib/lib/core/files/rag/extract/document-types.d.ts +9 -9
  122. package/dist-lib/lib/core/files/rag/extract/extract.js +7 -7
  123. package/dist-lib/lib/core/files/rag/extract/html-text.js +1 -1
  124. package/dist-lib/lib/core/files/rag/extract/office-collabora.js +2 -2
  125. package/dist-lib/lib/core/files/rag/extract/pdf-platform.js +1 -1
  126. package/dist-lib/lib/core/files/rag/extract/pdf-text.js +1 -1
  127. package/dist-lib/lib/core/files/rag/extract/text-decoding.js +1 -1
  128. package/dist-lib/lib/core/files/rag/extract/types.d.ts +2 -2
  129. package/dist-lib/lib/core/files/rag/index.js +22 -22
  130. package/dist-lib/lib/core/files/rag/load.js +5 -5
  131. package/dist-lib/lib/core/files/rag/policy.js +2 -2
  132. package/dist-lib/lib/core/files/rag/produce.js +5 -5
  133. package/dist-lib/lib/core/files/rag/retrieval/coverage.js +2 -2
  134. package/dist-lib/lib/core/files/rag/retrieval/diversity.js +1 -1
  135. package/dist-lib/lib/core/files/rag/retrieval/floor.js +2 -2
  136. package/dist-lib/lib/core/files/rag/retrieval/format.js +1 -1
  137. package/dist-lib/lib/core/files/rag/retrieval/full-text.js +18 -11
  138. package/dist-lib/lib/core/files/rag/retrieval/knowledge.js +6 -5
  139. package/dist-lib/lib/core/files/rag/retrieval/scoring.js +2 -2
  140. package/dist-lib/lib/core/files/rag/retrieval/search.js +7 -4
  141. package/dist-lib/lib/core/files/rag/retrieval/selection.d.ts +1 -0
  142. package/dist-lib/lib/core/files/rag/retrieval/selection.js +32 -2
  143. package/dist-lib/lib/core/files/rag/retrieval/sources.js +2 -2
  144. package/dist-lib/lib/core/files/rag/retrieval/terms.js +1 -1
  145. package/dist-lib/lib/core/files/rag/retrieval/types.d.ts +1 -0
  146. package/dist-lib/lib/core/files/rag/retrieval/web-sources.js +1 -1
  147. package/dist-lib/lib/core/files/records/chunks.js +1 -1
  148. package/dist-lib/lib/core/files/records/index.js +8 -8
  149. package/dist-lib/lib/core/files/records/knowledge.js +2 -2
  150. package/dist-lib/lib/core/files/records/output.js +1 -1
  151. package/dist-lib/lib/core/files/records/reclaim.js +5 -5
  152. package/dist-lib/lib/core/files/records/routing.js +7 -7
  153. package/dist-lib/lib/core/files/store/blob.js +2 -2
  154. package/dist-lib/lib/core/files/store/index.js +7 -7
  155. package/dist-lib/lib/core/files/store/reference.js +2 -2
  156. package/dist-lib/lib/core/files/store/server.js +1 -1
  157. package/dist-lib/lib/core/files/store/sweep.js +1 -1
  158. package/dist-lib/lib/core/files/upload-input.js +2 -2
  159. package/dist-lib/lib/core/files/upload.d.ts +1 -1
  160. package/dist-lib/lib/core/files/upload.js +6 -6
  161. package/dist-lib/lib/core/harness-loan.d.ts +29 -0
  162. package/dist-lib/lib/core/harness-loan.js +187 -0
  163. package/dist-lib/lib/core/helpers/index.d.ts +2 -1
  164. package/dist-lib/lib/core/helpers/index.js +4 -4
  165. package/dist-lib/lib/core/hosted-agents.js +2 -2
  166. package/dist-lib/lib/core/identity.d.ts +2 -0
  167. package/dist-lib/lib/core/identity.js +4 -2
  168. package/dist-lib/lib/core/invite.d.ts +1 -0
  169. package/dist-lib/lib/core/invite.js +4 -2
  170. package/dist-lib/lib/core/local/index.d.ts +12 -3
  171. package/dist-lib/lib/core/local/index.js +75 -16
  172. package/dist-lib/lib/core/membership.d.ts +3 -0
  173. package/dist-lib/lib/core/membership.js +15 -1
  174. package/dist-lib/lib/core/mesh-seed-handoff.js +1 -1
  175. package/dist-lib/lib/core/mesh.d.ts +9 -3
  176. package/dist-lib/lib/core/mesh.js +41 -26
  177. package/dist-lib/lib/core/migrations/agent-catalog.js +1 -1
  178. package/dist-lib/lib/core/migrations/index.js +5 -3
  179. package/dist-lib/lib/core/migrations/membership.js +2 -2
  180. package/dist-lib/lib/core/migrations/seal.d.ts +3 -0
  181. package/dist-lib/lib/core/migrations/seal.js +30 -0
  182. package/dist-lib/lib/core/next-frame.js +1 -1
  183. package/dist-lib/lib/core/notification.js +1 -1
  184. package/dist-lib/lib/core/ota-config.js +1 -1
  185. package/dist-lib/lib/core/secret-handoff.js +1 -1
  186. package/dist-lib/lib/core/send.js +3 -3
  187. package/dist-lib/lib/core/skill-overlay-handoff.js +1 -1
  188. package/dist-lib/lib/core/skill-overlay-receiver.js +2 -2
  189. package/dist-lib/lib/core/skill-secrets.js +3 -3
  190. package/dist-lib/lib/core/sync/devices.js +1 -1
  191. package/dist-lib/lib/core/sync/index.js +8 -5
  192. package/dist-lib/lib/core/sync-status.js +1 -1
  193. package/dist-lib/lib/core/system-info.js +1 -1
  194. package/dist-lib/lib/core/tool-activity.js +2 -2
  195. package/dist-lib/lib/core/tool-configs.js +2 -2
  196. package/dist-lib/lib/core.d.ts +41 -3
  197. package/dist-lib/lib/core.js +525 -90
  198. package/dist-lib/lib/credential-pusher.js +4 -4
  199. package/dist-lib/lib/deadline.js +1 -1
  200. package/dist-lib/lib/fs-drive-bridge.js +4 -2
  201. package/dist-lib/lib/integrations/index.js +3 -3
  202. package/dist-lib/lib/integrations/oauth-providers.js +1 -1
  203. package/dist-lib/lib/integrations/setup-routes.d.ts +5 -5
  204. package/dist-lib/lib/integrations/setup-routes.js +3 -3
  205. package/dist-lib/lib/knowledge-search.js +1 -1
  206. package/dist-lib/lib/log.js +3 -3
  207. package/dist-lib/lib/mesh-scoped-engine.d.ts +3 -0
  208. package/dist-lib/lib/mesh-scoped-engine.js +96 -0
  209. package/dist-lib/lib/model-context.d.ts +2 -2
  210. package/dist-lib/lib/model-context.js +1 -1
  211. package/dist-lib/lib/model-download.js +6 -6
  212. package/dist-lib/lib/oauth/asana.js +3 -3
  213. package/dist-lib/lib/oauth/browser-connect.js +1 -1
  214. package/dist-lib/lib/oauth/client.js +2 -2
  215. package/dist-lib/lib/oauth/common.d.ts +1 -1
  216. package/dist-lib/lib/oauth/common.js +1 -1
  217. package/dist-lib/lib/oauth/flow-core.js +3 -3
  218. package/dist-lib/lib/oauth/flow.js +2 -2
  219. package/dist-lib/lib/oauth/google.js +4 -4
  220. package/dist-lib/lib/oauth/host.js +3 -3
  221. package/dist-lib/lib/oauth/loopback.js +1 -1
  222. package/dist-lib/lib/oauth/notion.js +3 -3
  223. package/dist-lib/lib/oauth/providers.js +1 -1
  224. package/dist-lib/lib/oauth/resolve.js +1 -1
  225. package/dist-lib/lib/oauth/spotify.js +3 -3
  226. package/dist-lib/lib/oauth/token-exchange.js +1 -1
  227. package/dist-lib/lib/oauth.client.js +2 -2
  228. package/dist-lib/lib/oauth.js +12 -12
  229. package/dist-lib/lib/run-notices.d.ts +7 -7
  230. package/dist-lib/lib/run-transcript.js +1 -1
  231. package/dist-lib/schema/build.js +12 -6
  232. package/dist-lib/schema/content.d.ts +11 -11
  233. package/dist-lib/schema/engine.js +193 -30
  234. package/dist-lib/schema/field-order.js +2 -2
  235. package/dist-lib/schema/local.js +18 -4
  236. package/dist-lib/schema/qvac.js +15 -6
  237. package/dist-lib/spec/bind.js +41 -0
  238. package/dist-lib/spec/calls.js +12 -0
  239. package/dist-lib/spec/capabilities.d.ts +36 -12
  240. package/dist-lib/spec/hrpc/hrpc.json +161 -5
  241. package/dist-lib/spec/hrpc/index.js +154 -9
  242. package/dist-lib/spec/hrpc/messages.js +549 -129
  243. package/dist-lib/spec/hyperschema/index.js +549 -129
  244. package/dist-lib/spec/hyperschema/schema.json +370 -40
  245. package/dist-lib/spec/hyperschema/types.d.ts +85 -1
  246. package/dist-lib/spec/local/hyperdb/db.json +15 -0
  247. package/dist-lib/spec/local/hyperdb/index.js +70 -1
  248. package/dist-lib/spec/local/hyperdb/messages.js +300 -117
  249. package/dist-lib/spec/local/hyperschema/index.js +97 -4
  250. package/dist-lib/spec/local/hyperschema/schema.json +58 -1
  251. package/dist-lib/spec/local/hyperschema/types.d.ts +14 -0
  252. package/dist-lib/spec/mesh/hyperdb/messages.js +393 -288
  253. package/dist-lib/spec/mesh/hyperdispatch/dispatch.json +6 -0
  254. package/dist-lib/spec/mesh/hyperdispatch/index.js +18 -1
  255. package/dist-lib/spec/mesh/hyperdispatch/messages.js +176 -85
  256. package/dist-lib/spec/mesh/hyperschema/index.js +176 -85
  257. package/dist-lib/spec/mesh/hyperschema/schema.json +71 -21
  258. package/dist-lib/spec/mesh/hyperschema/types.d.ts +14 -1
  259. package/package.json +16 -10
  260. package/tui/README.md +7 -0
  261. package/tui/app.mjs +311 -14
  262. package/tui/lib/busy-words.mjs +57 -5
  263. package/tui/lib/export.mjs +1 -0
  264. package/tui/lib/render.mjs +9 -2
  265. package/tui/main.mjs +5 -2
@@ -1,6 +1,6 @@
1
1
  import b4a from 'b4a';
2
2
  import { Readable } from 'streamx';
3
- import "../logger.js";
3
+ import '../logger.js';
4
4
  const SCOPE = ['api', 'watch'];
5
5
  const CHURN_WINDOW_MS = 1000;
6
6
  function snapshotEquals(a, b) {
@@ -0,0 +1,5 @@
1
+ import defaultFetch from '#fetch';
2
+ import { type AbortSignal } from 'bare-abort-controller';
3
+ export type FetchBody = Awaited<ReturnType<typeof defaultFetch>>['body'];
4
+ export declare function raceInactivity<T>(promise: Promise<T>, signal: AbortSignal | undefined, timeoutMs: number): Promise<T>;
5
+ export declare function drainBody(body: FetchBody, signal: AbortSignal | undefined, timeoutMs: number): Promise<Uint8Array | null>;
@@ -0,0 +1,36 @@
1
+ import defaultFetch from '#fetch';
2
+ import b4a from 'b4a';
3
+ import {} from 'bare-abort-controller';
4
+ import { raceAbort } from '@qvac/harness/race-abort';
5
+ export async function raceInactivity(promise, signal, timeoutMs) {
6
+ let timer = null;
7
+ const expired = new Promise((_, reject) => {
8
+ timer = setTimeout(() => reject(new Error('blob read timed out')), timeoutMs);
9
+ });
10
+ try {
11
+ return await raceAbort(Promise.race([promise, expired]), signal);
12
+ }
13
+ finally {
14
+ if (timer !== null)
15
+ clearTimeout(timer);
16
+ }
17
+ }
18
+ export async function drainBody(body, signal, timeoutMs) {
19
+ if (!body)
20
+ return null;
21
+ const reader = body.getReader();
22
+ const parts = [];
23
+ try {
24
+ for (;;) {
25
+ const read = await raceInactivity(reader.read(), signal, timeoutMs);
26
+ if (read.done)
27
+ break;
28
+ parts.push(b4a.from(read.value));
29
+ }
30
+ }
31
+ catch {
32
+ await reader.cancel();
33
+ return null;
34
+ }
35
+ return b4a.concat(parts);
36
+ }
@@ -0,0 +1,225 @@
1
+ import type { AbortSignal } from 'bare-abort-controller';
2
+ import type { ApprovalCall, MemoryBudget } from '@qvac/harness';
3
+ import type { ManagedSkill, SkillFileContent } from '@qvac/harness/lib/tools/skills/overlay-crud.ts';
4
+ import type { SkillManagementHooks } from '../core.ts';
5
+ import type { DriveOpFn, GrantedDrive } from '@qvac/harness/lib/tools/fs/remote.ts';
6
+ import type { AssistantAgent, AssistantCapabilityProfile, AssistantChunkContentAttachment, AssistantDeleteModelRequest, AssistantDeleteModelResponse, AssistantKvCacheDeletionResponse, AssistantListModelsRequest, AssistantModelInfoList, AssistantSkillCatalogResponse, AssistantSpeakRequest, AssistantSpeakResponse, AssistantToolCatalogResponse, AssistantToolReportEntry, AssistantTranscribeRequest, AssistantTranscribeResponse } from '../../spec/hyperschema/types.d.ts';
7
+ import type { HarnessDiagnostics } from '../diagnostics.ts';
8
+ import type { DownloadArgs, DownloadEventStream, ImageDownloadObservation } from '../model-download.ts';
9
+ import type { AttachInput, AttachmentMeta, ChatMessage, FetchedAttachment } from './message.ts';
10
+ import type { Skill } from './skill-encode.ts';
11
+ export interface HarnessEvent {
12
+ type: string;
13
+ text?: string;
14
+ message?: string;
15
+ [key: string]: unknown;
16
+ }
17
+ export interface ModelState {
18
+ status: string;
19
+ model?: string;
20
+ percentage?: number;
21
+ downloaded?: number;
22
+ total?: number;
23
+ catalogChanged?: boolean;
24
+ }
25
+ export interface HarnessInfo {
26
+ toolNames: string[];
27
+ skills: string[];
28
+ supportsImages: boolean;
29
+ }
30
+ export type ModelType = string;
31
+ export interface ModelInfo {
32
+ name: string;
33
+ type: ModelType;
34
+ registryPath: string;
35
+ registrySource: string;
36
+ isCached: boolean;
37
+ isLoaded: boolean;
38
+ supportsImages?: boolean;
39
+ expectedSize: number;
40
+ actualSize?: number;
41
+ }
42
+ export interface ListModelsOptions {
43
+ type?: ModelType;
44
+ cachedOnly?: boolean;
45
+ fullRegistry?: boolean;
46
+ }
47
+ export interface DeleteModelSummary {
48
+ name: string;
49
+ removed: number;
50
+ freedBytes: number;
51
+ }
52
+ export interface ToolCatalogEntry {
53
+ name: string;
54
+ description: string;
55
+ skillGated: boolean;
56
+ scopeRequired: boolean;
57
+ toolset?: string | null;
58
+ rootsRequired?: boolean;
59
+ writeRootsRequired?: boolean;
60
+ promptChars?: number;
61
+ }
62
+ export interface Harness {
63
+ completion(context: {
64
+ model: string;
65
+ agent: AssistantAgent;
66
+ messages: ChatMessage[];
67
+ cacheKey?: string;
68
+ thinkingDefault?: string;
69
+ toolConfigs?: Record<string, Record<string, unknown>>;
70
+ grantedDirs?: string[];
71
+ grantedDrives?: GrantedDrive[];
72
+ driveOp?: DriveOpFn;
73
+ grantedWriteDirs?: string[];
74
+ generationParams?: {
75
+ temp?: number;
76
+ top_p?: number;
77
+ top_k?: number;
78
+ presence_penalty?: number;
79
+ repeat_penalty?: number;
80
+ frequency_penalty?: number;
81
+ reasoning_budget: 0 | -1;
82
+ };
83
+ responseFormat?: {
84
+ type: 'text';
85
+ } | {
86
+ type: 'json_object';
87
+ } | {
88
+ type: 'json_schema';
89
+ json_schema: {
90
+ name: string;
91
+ description?: string;
92
+ schema: Record<string, unknown>;
93
+ strict?: boolean;
94
+ };
95
+ };
96
+ approve?: (call: ApprovalCall) => Promise<boolean>;
97
+ attach?: (input: AttachInput) => Promise<AssistantChunkContentAttachment>;
98
+ fetchAttachment?: (query: {
99
+ attachmentId?: string;
100
+ signal?: AbortSignal;
101
+ meta?: boolean;
102
+ }) => Promise<FetchedAttachment | AttachmentMeta | null>;
103
+ ragSearch?: (input: {
104
+ query: string;
105
+ limit?: number;
106
+ }) => Promise<{
107
+ enabled: boolean;
108
+ indexEmpty: boolean;
109
+ hasKnowledge: boolean;
110
+ pendingReferenced?: boolean;
111
+ errorMessage?: string | null;
112
+ hits: ReadonlyArray<{
113
+ content: string;
114
+ metadataJson?: string | null;
115
+ score: number;
116
+ }>;
117
+ }>;
118
+ progress?: (update: {
119
+ percentage: number;
120
+ } | null) => void;
121
+ signal?: AbortSignal;
122
+ }): AsyncIterable<HarnessEvent>;
123
+ describe?(): Promise<HarnessInfo | null> | HarnessInfo;
124
+ embed?(context: {
125
+ model: string;
126
+ texts: string[];
127
+ signal?: AbortSignal;
128
+ }): Promise<number[][]>;
129
+ list?(options?: ListModelsOptions): Promise<ReadonlyArray<ModelInfo>>;
130
+ warmModel?(context: {
131
+ model: string;
132
+ agent?: AssistantAgent;
133
+ signal?: AbortSignal;
134
+ }): Promise<void>;
135
+ deleteModel?(name: string): Promise<DeleteModelSummary>;
136
+ clearKvCache?(): Promise<AssistantKvCacheDeletionResponse>;
137
+ deleteKvCache?(kvCacheKey: string): Promise<AssistantKvCacheDeletionResponse>;
138
+ infraModels?(profile: string): Promise<ReadonlyArray<{
139
+ name: string;
140
+ addon: string;
141
+ }>>;
142
+ capability?(): Promise<{
143
+ capabilityProfile: AssistantCapabilityProfile;
144
+ recommendedModelName: string;
145
+ memoryBudget?: MemoryBudget;
146
+ }>;
147
+ download?(args: DownloadArgs): DownloadEventStream;
148
+ transcribe?(context: {
149
+ model: string;
150
+ audio: Buffer;
151
+ signal?: AbortSignal;
152
+ }): Promise<string>;
153
+ speak?(context: {
154
+ model: string;
155
+ text: string;
156
+ signal?: AbortSignal;
157
+ }): Promise<{
158
+ audio: Buffer;
159
+ sampleRate: number;
160
+ }>;
161
+ speakStream?(context: {
162
+ model: string;
163
+ text: AsyncIterable<string>;
164
+ signal?: AbortSignal;
165
+ }): AsyncIterable<{
166
+ audio: Buffer;
167
+ sampleRate: number;
168
+ }>;
169
+ setCredentials?(entries: ReadonlyArray<{
170
+ key: string;
171
+ token?: string | null;
172
+ expiresAt?: number | null;
173
+ agentId?: string | null;
174
+ }>): void | Promise<void>;
175
+ setCustomModels?(entries: ReadonlyArray<{
176
+ name: string;
177
+ src: string;
178
+ projectionSrc?: string;
179
+ }>): void | Promise<void>;
180
+ on?(event: 'model' | 'status', listener: (...args: never[]) => void): unknown;
181
+ off?(event: 'model' | 'status', listener: (...args: never[]) => void): unknown;
182
+ presuspend?(): Promise<void> | void;
183
+ suspend?(): Promise<void> | void;
184
+ wakeup?(): Promise<void> | void;
185
+ resume?(): Promise<void> | void;
186
+ skills?(agentId?: string | null, modelName?: string | null, options?: {
187
+ readonly refresh?: boolean;
188
+ readonly skipCredentialProbe?: boolean;
189
+ }): Promise<ReadonlyArray<Skill>>;
190
+ tools?(): Promise<ReadonlyArray<ToolCatalogEntry>>;
191
+ listManagedSkills?(): Promise<ReadonlyArray<ManagedSkill>>;
192
+ readSkillFile?(name: string): Promise<SkillFileContent | null>;
193
+ writeSkillFile?(name: string, content: string): Promise<{
194
+ ok: boolean;
195
+ }>;
196
+ copyBaseForEdit?(name: string): Promise<{
197
+ copied: boolean;
198
+ }>;
199
+ deleteOverlaySkill?(name: string): Promise<{
200
+ removed: boolean;
201
+ }>;
202
+ diagnostics?(): HarnessDiagnostics;
203
+ fetchDiagnostics?(): Promise<HarnessDiagnostics | null>;
204
+ toolNames?: string[];
205
+ skillNames?: string[];
206
+ supportsImages?: boolean;
207
+ supportsImagesFor?(model: string): boolean;
208
+ }
209
+ export declare function harnessListModels(harness: Pick<Harness, 'list'>): (options: AssistantListModelsRequest) => Promise<AssistantModelInfoList>;
210
+ export declare function harnessDeleteModel(harness: Pick<Harness, 'deleteModel'>): (options: AssistantDeleteModelRequest) => Promise<AssistantDeleteModelResponse>;
211
+ export declare function harnessClearKvCache(harness: Pick<Harness, 'clearKvCache'>): () => Promise<AssistantKvCacheDeletionResponse>;
212
+ export declare function harnessTranscribe(harness: Pick<Harness, 'transcribe'>): (request: AssistantTranscribeRequest) => Promise<AssistantTranscribeResponse>;
213
+ export declare function harnessSpeak(harness: Pick<Harness, 'speak'>): (request: AssistantSpeakRequest) => Promise<AssistantSpeakResponse>;
214
+ export declare function harnessSkillCatalog(harness: Pick<Harness, 'skills'>, syncCredentials?: () => Promise<void> | undefined): (agentId?: string | null, modelName?: string | null, options?: {
215
+ readonly refresh?: boolean;
216
+ readonly skipCredentialProbe?: boolean;
217
+ }) => Promise<AssistantSkillCatalogResponse>;
218
+ export declare function harnessSkillManagement(harness: Pick<Harness, 'listManagedSkills' | 'readSkillFile' | 'writeSkillFile' | 'copyBaseForEdit' | 'deleteOverlaySkill'>): SkillManagementHooks;
219
+ export declare function harnessTools(harness: Pick<Harness, 'tools'>): () => Promise<AssistantToolCatalogResponse>;
220
+ export declare function toolReportEntry(tool: ToolCatalogEntry): AssistantToolReportEntry;
221
+ export declare function harnessSpeakStream(harness: Pick<Harness, 'speakStream'>): (text: AsyncIterable<string>) => AsyncIterable<AssistantSpeakResponse>;
222
+ export declare function harnessDeathReason(status: unknown): string;
223
+ export declare function harnessDied(status: unknown): boolean;
224
+ export declare function modelCatalogChanged(state: unknown): boolean;
225
+ export declare function imageDownloadProgress(state: unknown): ImageDownloadObservation | null;
@@ -0,0 +1,154 @@
1
+ import { diffusionDownloadName } from '@qvac/harness/lib/models/model-catalog.ts';
2
+ import { RUN_FAILURE_REASONS } from '../run-notices.js';
3
+ import { toEngineSkill } from './skill-encode.js';
4
+ export function harnessListModels(harness) {
5
+ return async ({ type, cachedOnly, fullRegistry } = {}) => ({
6
+ models: [
7
+ ...((await harness.list?.({
8
+ type: type ?? undefined,
9
+ cachedOnly: cachedOnly ?? undefined,
10
+ fullRegistry: fullRegistry ?? undefined
11
+ })) ?? [])
12
+ ]
13
+ });
14
+ }
15
+ export function harnessDeleteModel(harness) {
16
+ return async ({ name }) => (await harness.deleteModel?.(name)) ?? { name, removed: 0, freedBytes: 0 };
17
+ }
18
+ export function harnessClearKvCache(harness) {
19
+ return async () => (await harness.clearKvCache?.()) ?? {
20
+ status: 'unsupported',
21
+ error: 'Harness does not support KV cache deletion'
22
+ };
23
+ }
24
+ export function harnessTranscribe(harness) {
25
+ return async ({ audio, model }) => {
26
+ if (!harness.transcribe)
27
+ throw new Error('harness does not support transcribe');
28
+ return { text: await harness.transcribe({ audio, model: model ?? '' }) };
29
+ };
30
+ }
31
+ export function harnessSpeak(harness) {
32
+ return async ({ text, model }) => {
33
+ if (!harness.speak)
34
+ throw new Error('harness does not support speak');
35
+ const { audio, sampleRate } = await harness.speak({ text, model: model ?? '' });
36
+ return { audio, sampleRate };
37
+ };
38
+ }
39
+ export function harnessSkillCatalog(harness, syncCredentials) {
40
+ return async (agentId, modelName, options) => {
41
+ if (options?.refresh)
42
+ await syncCredentials?.();
43
+ return {
44
+ skills: ((await harness.skills?.(agentId, modelName, options)) ?? []).map(toEngineSkill)
45
+ };
46
+ };
47
+ }
48
+ export function harnessSkillManagement(harness) {
49
+ return {
50
+ async listManagedSkills() {
51
+ return {
52
+ skills: ((await harness.listManagedSkills?.()) ?? []).map((skill) => ({
53
+ name: skill.name,
54
+ origin: skill.origin,
55
+ overridesBase: skill.overridesBase
56
+ }))
57
+ };
58
+ },
59
+ async readSkillFile(name) {
60
+ const file = await harness.readSkillFile?.(name);
61
+ return file ? { found: true, content: file.content, origin: file.origin } : { found: false };
62
+ },
63
+ async writeSkillFile(name, content) {
64
+ if (!harness.writeSkillFile)
65
+ return { ok: false };
66
+ return harness.writeSkillFile(name, content);
67
+ },
68
+ async copySkillForEdit(name) {
69
+ return { copied: (await harness.copyBaseForEdit?.(name))?.copied ?? false };
70
+ },
71
+ async deleteOverlaySkill(name) {
72
+ return { removed: (await harness.deleteOverlaySkill?.(name))?.removed ?? false };
73
+ }
74
+ };
75
+ }
76
+ export function harnessTools(harness) {
77
+ return async () => ({
78
+ tools: ((await harness.tools?.()) ?? []).map((tool) => ({
79
+ ...toolReportEntry(tool),
80
+ description: tool.description
81
+ }))
82
+ });
83
+ }
84
+ export function toolReportEntry(tool) {
85
+ return {
86
+ name: tool.name,
87
+ promptChars: tool.promptChars ?? 0,
88
+ toolset: tool.toolset ?? null,
89
+ skillGated: tool.skillGated === true,
90
+ scopeRequired: tool.scopeRequired === true,
91
+ rootsRequired: tool.rootsRequired === true,
92
+ writeRootsRequired: tool.writeRootsRequired === true
93
+ };
94
+ }
95
+ export function harnessSpeakStream(harness) {
96
+ return async function* (text) {
97
+ if (!harness.speakStream)
98
+ throw new Error('harness does not support speakStream');
99
+ for await (const { audio, sampleRate } of harness.speakStream({ model: '', text })) {
100
+ yield { audio, sampleRate };
101
+ }
102
+ };
103
+ }
104
+ export function harnessDeathReason(status) {
105
+ const HARNESS_DIED = RUN_FAILURE_REASONS.harnessDied;
106
+ if (typeof status !== 'object' || status === null)
107
+ return HARNESS_DIED;
108
+ const record = status;
109
+ const detail = typeof record.error === 'string' && record.error ? record.error : null;
110
+ const code = typeof record.code === 'string' && record.code ? record.code : null;
111
+ if (!detail)
112
+ return code ? `${HARNESS_DIED} (${code})` : HARNESS_DIED;
113
+ return code ? `${HARNESS_DIED}: ${detail} (${code})` : `${HARNESS_DIED}: ${detail}`;
114
+ }
115
+ export function harnessDied(status) {
116
+ if (typeof status !== 'object' || status === null || !('state' in status))
117
+ return false;
118
+ return status.state === 'died';
119
+ }
120
+ export function modelCatalogChanged(state) {
121
+ return (typeof state === 'object' &&
122
+ state !== null &&
123
+ 'catalogChanged' in state &&
124
+ state.catalogChanged === true);
125
+ }
126
+ export function imageDownloadProgress(state) {
127
+ if (typeof state !== 'object' ||
128
+ state === null ||
129
+ !('status' in state) ||
130
+ (state.status !== 'downloading' && state.status !== 'downloaded') ||
131
+ !('model' in state) ||
132
+ typeof state.model !== 'string' ||
133
+ !('percentage' in state) ||
134
+ typeof state.percentage !== 'number' ||
135
+ !Number.isFinite(state.percentage) ||
136
+ !('downloaded' in state) ||
137
+ typeof state.downloaded !== 'number' ||
138
+ !Number.isFinite(state.downloaded) ||
139
+ !('total' in state) ||
140
+ typeof state.total !== 'number' ||
141
+ !Number.isFinite(state.total)) {
142
+ return null;
143
+ }
144
+ const model = diffusionDownloadName(state.model);
145
+ if (!model)
146
+ return null;
147
+ return {
148
+ model,
149
+ phase: state.status === 'downloading' ? 'downloading' : 'complete',
150
+ percentage: state.percentage,
151
+ downloaded: state.downloaded,
152
+ total: state.total
153
+ };
154
+ }
@@ -0,0 +1,32 @@
1
+ import type { AbortSignal } from 'bare-abort-controller';
2
+ import type { AssistantChunk } from '../../spec/hyperschema/types.d.ts';
3
+ import type { Capabilities } from '../api/index.ts';
4
+ import type { ChatMessage } from './message.ts';
5
+ export declare const TERMINAL_STATES: Set<string>;
6
+ export declare const HISTORY_TYPES: AssistantChunk['type'][];
7
+ export declare const SKILL_TOOL = "skill";
8
+ export interface StaleToolRuns {
9
+ runIds: Set<string>;
10
+ questionChunkIds: Set<string>;
11
+ }
12
+ export declare function listHistoryChunks(engine: Pick<Capabilities, 'listChunks'>, chatId: string): Promise<AssistantChunk[]>;
13
+ export declare function latestAttemptStarts(chunks: ReadonlyArray<AssistantChunk>): Map<string, number>;
14
+ export declare function beforeLatestAttempt(chunk: AssistantChunk, starts: Map<string, number>): boolean;
15
+ export interface CompactOptions {
16
+ readonly signal?: AbortSignal;
17
+ readonly onFold?: () => Promise<void> | void;
18
+ readonly meshId?: string;
19
+ }
20
+ export type CompactionTrigger = 'before-run' | 'turn-filled-window' | 'overflow';
21
+ export interface CompactResult {
22
+ readonly compacted: boolean;
23
+ readonly foldedTurns?: number;
24
+ readonly reason?: string;
25
+ }
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
+ export declare function inputAvailableToRun(chunk: AssistantChunk, requestSeq: number): boolean;
29
+ export declare function normalizeQuestion(text: string): string;
30
+ export declare const GENERIC_ACKNOWLEDGEMENTS: Set<string>;
31
+ export declare function isGenericAcknowledgement(question: string): boolean;
32
+ export declare function staleToolRunIds(historyChunks: ReadonlyArray<AssistantChunk>, approvalChunks: ReadonlyArray<AssistantChunk>, currentRunId: string): StaleToolRuns;