@qvac/harness 1.0.0-rc.0 → 1.0.0-rc.2

package/dist-lib/spec/hyperschema/schema.json

@@ -156,6 +156,22 @@
           "name": "sandboxMode",
           "type": "bool",
           "version": 10
+        },
+        {
+          "name": "handoffs",
+          "array": true,
+          "type": "@harness/agent-handoff",
+          "version": 19
+        },
+        {
+          "name": "plan",
+          "type": "bool",
+          "version": 19
+        },
+        {
+          "name": "model",
+          "type": "string",
+          "version": 19
         }
       ]
     },
@@ -220,6 +236,26 @@
           "array": true,
           "type": "@harness/message-attachment",
           "version": 1
+        },
+        {
+          "name": "toolCalls",
+          "type": "json",
+          "version": 19
+        },
+        {
+          "name": "toolCallId",
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "id",
+          "type": "string",
+          "version": 19
         }
       ]
     },
@@ -319,6 +355,14 @@
         {
           "key": "pause",
           "version": 19
+        },
+        {
+          "key": "steer",
+          "version": 19
+        },
+        {
+          "key": "follow-up",
+          "version": 19
         }
       ],
       "strings": true
@@ -488,6 +532,11 @@
           "name": "runId",
           "type": "string",
           "version": 19
+        },
+        {
+          "name": "maxToolRounds",
+          "type": "uint",
+          "version": 19
         }
       ]
     },
@@ -591,6 +640,22 @@
         {
           "key": "run-log-append",
           "version": 19
+        },
+        {
+          "key": "input",
+          "version": 19
+        },
+        {
+          "key": "goal",
+          "version": 19
+        },
+        {
+          "key": "fold",
+          "version": 19
+        },
+        {
+          "key": "input-rejected",
+          "version": 19
         }
       ],
       "strings": true
@@ -800,7 +865,7 @@
       "name": "loaded-model",
       "namespace": "harness",
       "compact": false,
-      "flagsPosition": -1,
+      "flagsPosition": 2,
       "fields": [
         {
           "name": "model",
@@ -813,6 +878,11 @@
           "required": true,
           "type": "uint",
           "version": 1
+        },
+        {
+          "name": "fit",
+          "type": "@harness/load-fit",
+          "version": 19
         }
       ]
     },
@@ -1399,6 +1469,21 @@
           "name": "isLoading",
           "type": "bool",
           "version": 18
+        },
+        {
+          "name": "fit",
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "fitBasis",
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "fitEvidence",
+          "type": "string",
+          "version": 19
         }
       ]
     },
@@ -2842,6 +2927,384 @@
           "version": 16
         }
       ]
+    },
+    {
+      "name": "agent-handoff",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": -1,
+      "fields": [
+        {
+          "name": "id",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "description",
+          "required": true,
+          "type": "string",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "load-fit-verdict",
+      "namespace": "harness",
+      "offset": 1,
+      "enum": [
+        {
+          "key": "fit",
+          "version": 19
+        },
+        {
+          "key": "does-not-fit",
+          "version": 19
+        },
+        {
+          "key": "unknown",
+          "version": 19
+        }
+      ],
+      "strings": true
+    },
+    {
+      "name": "load-fit-plan",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": -1,
+      "fields": [
+        {
+          "name": "nCtx",
+          "required": true,
+          "type": "int",
+          "version": 19
+        },
+        {
+          "name": "nGpuLayers",
+          "required": true,
+          "type": "int",
+          "version": 19
+        },
+        {
+          "name": "nGpuDevices",
+          "required": true,
+          "type": "int",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "load-fit",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": 2,
+      "fields": [
+        {
+          "name": "verdict",
+          "required": true,
+          "type": "@harness/load-fit-verdict",
+          "version": 19
+        },
+        {
+          "name": "reason",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "plan",
+          "type": "@harness/load-fit-plan",
+          "version": 19
+        },
+        {
+          "name": "deviceBytes",
+          "type": "float64",
+          "version": 19
+        },
+        {
+          "name": "hostBytes",
+          "type": "float64",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "knowledge-chunk",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": 2,
+      "fields": [
+        {
+          "name": "id",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "text",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "metadata",
+          "type": "json",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "knowledge-upsert-request",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": 1,
+      "fields": [
+        {
+          "name": "artifactId",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "version",
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "scope",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "chunks",
+          "required": true,
+          "array": true,
+          "type": "@harness/knowledge-chunk",
+          "version": 19
+        },
+        {
+          "name": "model",
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "dimensions",
+          "type": "uint",
+          "version": 19
+        },
+        {
+          "name": "vectors",
+          "type": "buffer",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "knowledge-upsert-response",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": 1,
+      "fields": [
+        {
+          "name": "added",
+          "required": true,
+          "type": "uint",
+          "version": 19
+        },
+        {
+          "name": "model",
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "dimensions",
+          "type": "uint",
+          "version": 19
+        },
+        {
+          "name": "vectors",
+          "type": "buffer",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "knowledge-remove-request",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": -1,
+      "fields": [
+        {
+          "name": "artifactId",
+          "required": true,
+          "type": "string",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "knowledge-remove-response",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": -1,
+      "fields": [
+        {
+          "name": "removed",
+          "required": true,
+          "type": "uint",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "knowledge-search-request",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": 2,
+      "fields": [
+        {
+          "name": "text",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "scopes",
+          "required": true,
+          "array": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "k",
+          "type": "uint",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "knowledge-hit",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": 5,
+      "fields": [
+        {
+          "name": "artifactId",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "chunkId",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "scope",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "text",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "score",
+          "required": true,
+          "type": "float64",
+          "version": 19
+        },
+        {
+          "name": "metadata",
+          "type": "json",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "knowledge-search-response",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": -1,
+      "fields": [
+        {
+          "name": "hits",
+          "required": true,
+          "array": true,
+          "type": "@harness/knowledge-hit",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "knowledge-artifact-status",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": 1,
+      "fields": [
+        {
+          "name": "artifactId",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "version",
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "scope",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "chunks",
+          "required": true,
+          "type": "uint",
+          "version": 19
+        }
+      ]
+    },
+    {
+      "name": "knowledge-status-response",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": -1,
+      "fields": [
+        {
+          "name": "model",
+          "required": true,
+          "type": "string",
+          "version": 19
+        },
+        {
+          "name": "dimensions",
+          "required": true,
+          "type": "uint",
+          "version": 19
+        },
+        {
+          "name": "chunks",
+          "required": true,
+          "type": "uint",
+          "version": 19
+        },
+        {
+          "name": "artifacts",
+          "required": true,
+          "array": true,
+          "type": "@harness/knowledge-artifact-status",
+          "version": 19
+        }
+      ]
     }
   ]
 }

package/dist-lib/spec/hyperschema/types.d.ts

@@ -32,6 +32,9 @@ export interface HarnessAgentKnobs {
   approvalMode?: HarnessApprovalMode | null
   disabledToolsets?: string[] | null
   sandboxMode?: boolean
+  handoffs?: HarnessAgentHandoff[] | null
+  plan?: boolean
+  model?: string | null
 }
 
 export type HarnessMessageRole = "system" | "user" | "assistant" | "tool"
@@ -44,6 +47,10 @@ export interface HarnessMessage {
   role: HarnessMessageRole
   content: string
   attachments?: HarnessMessageAttachment[] | null
+  toolCalls?: unknown | null
+  toolCallId?: string | null
+  name?: string | null
+  id?: string | null
 }
 
 export interface HarnessResource {
@@ -58,7 +65,7 @@ export interface HarnessAttachmentRecord {
   byteLength: number
 }
 
-export type HarnessCompletionFrameType = "start" | "decision" | "attach-result" | "fetch-result" | "rag-result" | "question-result" | "drive-result" | "invoke" | "run-log-result" | "pause"
+export type HarnessCompletionFrameType = "start" | "decision" | "attach-result" | "fetch-result" | "rag-result" | "question-result" | "drive-result" | "invoke" | "run-log-result" | "pause" | "steer" | "follow-up"
 
 export interface HarnessCompletionFrame {
   type: HarnessCompletionFrameType
@@ -92,9 +99,10 @@ export interface HarnessCompletionFrame {
   arguments?: unknown | null
   enhance?: string | null
   runId?: string | null
+  maxToolRounds?: number
 }
 
-export type HarnessCompletionEventType = "content" | "thinking" | "tool-call" | "tool-result" | "approval-ask" | "metrics" | "error" | "aborted" | "attach-ask" | "fetch-ask" | "progress" | "rag-ask" | "question-ask" | "done" | "tool-activity" | "drive-ask" | "inference-call" | "inference-sent" | "run-started" | "run-resumed" | "paused" | "recovery-required" | "round-reset" | "run-log-append"
+export type HarnessCompletionEventType = "content" | "thinking" | "tool-call" | "tool-result" | "approval-ask" | "metrics" | "error" | "aborted" | "attach-ask" | "fetch-ask" | "progress" | "rag-ask" | "question-ask" | "done" | "tool-activity" | "drive-ask" | "inference-call" | "inference-sent" | "run-started" | "run-resumed" | "paused" | "recovery-required" | "round-reset" | "run-log-append" | "input" | "goal" | "fold" | "input-rejected"
 
 export interface HarnessCompletionEvent {
   type: HarnessCompletionEventType
@@ -135,6 +143,7 @@ export type HarnessModelEventStatus = "loading" | "downloading" | "ready" | "err
 export interface HarnessLoadedModel {
   model: string
   refs: number
+  fit?: HarnessLoadFit | null
 }
 
 export interface HarnessModelEvent {
@@ -262,6 +271,9 @@ export interface HarnessModelInfo {
   actualSize?: number
   label?: string | null
   isLoading?: boolean
+  fit?: string | null
+  fitBasis?: string | null
+  fitEvidence?: string | null
 }
 
 export interface HarnessListModelsRequest {
@@ -590,6 +602,91 @@ export interface HarnessUnloadModelResponse {
   unloaded?: boolean
 }
 
+export interface HarnessAgentHandoff {
+  id: string
+  description: string
+}
+
+export type HarnessLoadFitVerdict = "fit" | "does-not-fit" | "unknown"
+
+export interface HarnessLoadFitPlan {
+  nCtx: number
+  nGpuLayers: number
+  nGpuDevices: number
+}
+
+export interface HarnessLoadFit {
+  verdict: HarnessLoadFitVerdict
+  reason: string
+  plan?: HarnessLoadFitPlan | null
+  deviceBytes?: number
+  hostBytes?: number
+}
+
+export interface HarnessKnowledgeChunk {
+  id: string
+  text: string
+  metadata?: unknown | null
+}
+
+export interface HarnessKnowledgeUpsertRequest {
+  artifactId: string
+  version?: string | null
+  scope: string
+  chunks: HarnessKnowledgeChunk[]
+  model?: string | null
+  dimensions?: number
+  vectors?: Buffer | null
+}
+
+export interface HarnessKnowledgeUpsertResponse {
+  added: number
+  model?: string | null
+  dimensions?: number
+  vectors?: Buffer | null
+}
+
+export interface HarnessKnowledgeRemoveRequest {
+  artifactId: string
+}
+
+export interface HarnessKnowledgeRemoveResponse {
+  removed: number
+}
+
+export interface HarnessKnowledgeSearchRequest {
+  text: string
+  scopes: string[]
+  k?: number
+}
+
+export interface HarnessKnowledgeHit {
+  artifactId: string
+  chunkId: string
+  scope: string
+  text: string
+  score: number
+  metadata?: unknown | null
+}
+
+export interface HarnessKnowledgeSearchResponse {
+  hits: HarnessKnowledgeHit[]
+}
+
+export interface HarnessKnowledgeArtifactStatus {
+  artifactId: string
+  version?: string | null
+  scope: string
+  chunks: number
+}
+
+export interface HarnessKnowledgeStatusResponse {
+  model: string
+  dimensions: number
+  chunks: number
+  artifacts: HarnessKnowledgeArtifactStatus[]
+}
+
 export interface SchemaTypes {
   "@harness/empty": HarnessEmpty
   "@harness/ok-response": HarnessOkResponse
@@ -683,4 +780,18 @@ export interface SchemaTypes {
   "@harness/load-model-response": HarnessLoadModelResponse
   "@harness/unload-model-request": HarnessUnloadModelRequest
   "@harness/unload-model-response": HarnessUnloadModelResponse
+  "@harness/agent-handoff": HarnessAgentHandoff
+  "@harness/load-fit-verdict": HarnessLoadFitVerdict
+  "@harness/load-fit-plan": HarnessLoadFitPlan
+  "@harness/load-fit": HarnessLoadFit
+  "@harness/knowledge-chunk": HarnessKnowledgeChunk
+  "@harness/knowledge-upsert-request": HarnessKnowledgeUpsertRequest
+  "@harness/knowledge-upsert-response": HarnessKnowledgeUpsertResponse
+  "@harness/knowledge-remove-request": HarnessKnowledgeRemoveRequest
+  "@harness/knowledge-remove-response": HarnessKnowledgeRemoveResponse
+  "@harness/knowledge-search-request": HarnessKnowledgeSearchRequest
+  "@harness/knowledge-hit": HarnessKnowledgeHit
+  "@harness/knowledge-search-response": HarnessKnowledgeSearchResponse
+  "@harness/knowledge-artifact-status": HarnessKnowledgeArtifactStatus
+  "@harness/knowledge-status-response": HarnessKnowledgeStatusResponse
 }