@qvac/core 0.7.0 → 0.7.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 (74) hide show
  1. package/CHANGELOG.md +80 -1
  2. package/dist-lib/lib/api/chat.d.ts +1 -1
  3. package/dist-lib/lib/api/chat.js +9 -0
  4. package/dist-lib/lib/api/index.d.ts +2 -1
  5. package/dist-lib/lib/api/index.js +2 -1
  6. package/dist-lib/lib/api/network.d.ts +8 -1
  7. package/dist-lib/lib/api/network.js +6 -0
  8. package/dist-lib/lib/assistant/harness.d.ts +2 -0
  9. package/dist-lib/lib/assistant.js +9 -4
  10. package/dist-lib/lib/core/agent.d.ts +2 -0
  11. package/dist-lib/lib/core/agent.js +16 -5
  12. package/dist-lib/lib/core/blind-peers.d.ts +4 -0
  13. package/dist-lib/lib/core/blind-peers.js +1 -0
  14. package/dist-lib/lib/core/chat-copy.d.ts +4 -0
  15. package/dist-lib/lib/core/chat-copy.js +1 -1
  16. package/dist-lib/lib/core/chat-fork.d.ts +21 -0
  17. package/dist-lib/lib/core/chat-fork.js +245 -0
  18. package/dist-lib/lib/core/chat-move.js +1 -4
  19. package/dist-lib/lib/core/chat.d.ts +1 -0
  20. package/dist-lib/lib/core/chat.js +1 -1
  21. package/dist-lib/lib/core/departures.d.ts +5 -1
  22. package/dist-lib/lib/core/departures.js +15 -1
  23. package/dist-lib/lib/core/fs-drives.d.ts +8 -1
  24. package/dist-lib/lib/core/fs-drives.js +47 -15
  25. package/dist-lib/lib/core/harness-loan.d.ts +4 -20
  26. package/dist-lib/lib/core/harness-loan.js +7 -184
  27. package/dist-lib/lib/core/id.d.ts +1 -0
  28. package/dist-lib/lib/core/id.js +3 -0
  29. package/dist-lib/lib/core/mesh.d.ts +3 -2
  30. package/dist-lib/lib/core/mesh.js +11 -1
  31. package/dist-lib/lib/core/migrations/agent-tools-scope.d.ts +2 -0
  32. package/dist-lib/lib/core/migrations/agent-tools-scope.js +24 -0
  33. package/dist-lib/lib/core/migrations/index.js +3 -1
  34. package/dist-lib/lib/core/peer-duplex.d.ts +32 -0
  35. package/dist-lib/lib/core/peer-duplex.js +207 -0
  36. package/dist-lib/lib/core.d.ts +17 -1
  37. package/dist-lib/lib/core.js +183 -10
  38. package/dist-lib/lib/doctor/checks.js +4 -1
  39. package/dist-lib/lib/inference-calls.d.ts +1 -2
  40. package/dist-lib/lib/inference-calls.js +1 -5
  41. package/dist-lib/lib/mesh-scoped-engine.js +3 -0
  42. package/dist-lib/lib/model-download.d.ts +0 -9
  43. package/dist-lib/lib/model-download.js +1 -13
  44. package/dist-lib/lib/persistent-dir.d.ts +1 -0
  45. package/dist-lib/lib/persistent-dir.js +9 -0
  46. package/dist-lib/lib/run-replay.d.ts +1 -2
  47. package/dist-lib/lib/run-replay.js +1 -5
  48. package/dist-lib/lib/test-env.d.ts +1 -0
  49. package/dist-lib/lib/test-env.js +4 -0
  50. package/dist-lib/schema/engine.js +45 -1
  51. package/dist-lib/schema/field-order.js +1 -1
  52. package/dist-lib/schema/qvac.js +10 -1
  53. package/dist-lib/spec/bind.js +14 -0
  54. package/dist-lib/spec/calls.js +3 -0
  55. package/dist-lib/spec/capabilities.d.ts +6 -0
  56. package/dist-lib/spec/hrpc/hrpc.json +39 -0
  57. package/dist-lib/spec/hrpc/index.js +41 -4
  58. package/dist-lib/spec/hrpc/messages.js +1420 -1289
  59. package/dist-lib/spec/hyperschema/index.js +1420 -1289
  60. package/dist-lib/spec/hyperschema/schema.json +102 -0
  61. package/dist-lib/spec/hyperschema/types.d.ts +29 -0
  62. package/dist-lib/spec/mesh/hyperdb/messages.js +295 -248
  63. package/dist-lib/spec/mesh/hyperdispatch/messages.js +45 -5
  64. package/dist-lib/spec/mesh/hyperschema/index.js +45 -5
  65. package/dist-lib/spec/mesh/hyperschema/schema.json +31 -1
  66. package/dist-lib/spec/mesh/hyperschema/types.d.ts +9 -1
  67. package/package.json +10 -7
  68. package/tui/README.md +8 -5
  69. package/tui/app.mjs +151 -67
  70. package/tui/boot.mjs +5 -1
  71. package/tui/index.mjs +2 -1
  72. package/tui/lib/fork-command.mjs +43 -0
  73. package/dist-lib/lib/image-cache-dir.d.ts +0 -1
  74. package/dist-lib/lib/image-cache-dir.js +0 -5
@@ -1,12 +1,12 @@
1
1
  // This file is autogenerated by the hyperschema compiler
2
- // Schema Version: 14
2
+ // Schema Version: 15
3
3
  /* eslint-disable camelcase */
4
4
  /* eslint-disable quotes */
5
5
  /* eslint-disable space-before-function-paren */
6
6
 
7
7
  import { c } from 'hyperschema/runtime'
8
8
 
9
- const VERSION = 14
9
+ const VERSION = 15
10
10
 
11
11
  // eslint-disable-next-line no-unused-vars
12
12
  let version = VERSION
@@ -2102,7 +2102,8 @@ const encoding45 = {
2102
2102
  ((version >= 5 && m.groupId) ? 16 : 0) |
2103
2103
  ((version >= 6 && m.rank) ? 32 : 0) |
2104
2104
  ((version >= 6 && m.rankedAt) ? 64 : 0) |
2105
- ((version >= 12 && m.readThrough) ? 128 : 0)
2105
+ ((version >= 12 && m.readThrough) ? 128 : 0) |
2106
+ ((version >= 15 && m.forkedFrom) ? 256 : 0)
2106
2107
 
2107
2108
  c.string.preencode(state, m.id)
2108
2109
  c.string.preencode(state, m.agentId)
@@ -2116,6 +2117,7 @@ const encoding45 = {
2116
2117
  if (version >= 6 && m.rank) c.float64.preencode(state, m.rank)
2117
2118
  if (version >= 6 && m.rankedAt) c.uint.preencode(state, m.rankedAt)
2118
2119
  if (version >= 12 && m.readThrough) c.uint.preencode(state, m.readThrough)
2120
+ if (version >= 15 && m.forkedFrom) encoding45_12.preencode(state, m.forkedFrom)
2119
2121
  },
2120
2122
  encode(state, m) {
2121
2123
  const flags =
@@ -2126,7 +2128,8 @@ const encoding45 = {
2126
2128
  ((version >= 5 && m.groupId) ? 16 : 0) |
2127
2129
  ((version >= 6 && m.rank) ? 32 : 0) |
2128
2130
  ((version >= 6 && m.rankedAt) ? 64 : 0) |
2129
- ((version >= 12 && m.readThrough) ? 128 : 0)
2131
+ ((version >= 12 && m.readThrough) ? 128 : 0) |
2132
+ ((version >= 15 && m.forkedFrom) ? 256 : 0)
2130
2133
 
2131
2134
  c.string.encode(state, m.id)
2132
2135
  c.string.encode(state, m.agentId)
@@ -2140,6 +2143,7 @@ const encoding45 = {
2140
2143
  if (version >= 6 && m.rank) c.float64.encode(state, m.rank)
2141
2144
  if (version >= 6 && m.rankedAt) c.uint.encode(state, m.rankedAt)
2142
2145
  if (version >= 12 && m.readThrough) c.uint.encode(state, m.readThrough)
2146
+ if (version >= 15 && m.forkedFrom) encoding45_12.encode(state, m.forkedFrom)
2143
2147
  },
2144
2148
  decode(state) {
2145
2149
  const r0 = c.string.decode(state)
@@ -2161,7 +2165,8 @@ const encoding45 = {
2161
2165
  groupId: (version >= 5 && (flags & 16) !== 0) ? c.string.decode(state) : null,
2162
2166
  rank: (version >= 6 && (flags & 32) !== 0) ? c.float64.decode(state) : 0,
2163
2167
  rankedAt: (version >= 6 && (flags & 64) !== 0) ? c.uint.decode(state) : 0,
2164
- readThrough: (version >= 12 && (flags & 128) !== 0) ? c.uint.decode(state) : 0
2168
+ readThrough: (version >= 12 && (flags & 128) !== 0) ? c.uint.decode(state) : 0,
2169
+ forkedFrom: (version >= 15 && (flags & 256) !== 0) ? encoding45_12.decode(state) : null
2165
2170
  }
2166
2171
  }
2167
2172
  }
@@ -7063,6 +7068,39 @@ const encoding177 = {
7063
7068
  }
7064
7069
  }
7065
7070
 
7071
+ // @qvac/chat-fork-source
7072
+ const encoding178 = {
7073
+ preencode(state, m) {
7074
+ c.string.preencode(state, m.meshId)
7075
+ c.string.preencode(state, m.chatId)
7076
+ state.end++ // max flag is 1 so always one byte
7077
+
7078
+ if (version >= 15 && m.runId) c.string.preencode(state, m.runId)
7079
+ },
7080
+ encode(state, m) {
7081
+ const flags = (version >= 15 && m.runId) ? 1 : 0
7082
+
7083
+ c.string.encode(state, m.meshId)
7084
+ c.string.encode(state, m.chatId)
7085
+ c.uint.encode(state, flags)
7086
+
7087
+ if (version >= 15 && m.runId) c.string.encode(state, m.runId)
7088
+ },
7089
+ decode(state) {
7090
+ const r0 = c.string.decode(state)
7091
+ const r1 = c.string.decode(state)
7092
+ const flags = c.uint.decode(state)
7093
+
7094
+ return {
7095
+ meshId: r0,
7096
+ chatId: r1,
7097
+ runId: (version >= 15 && (flags & 1) !== 0) ? c.string.decode(state) : null
7098
+ }
7099
+ }
7100
+ }
7101
+
7102
+ // @qvac/chat-v1.forkedFrom, deferred due to recusive use
7103
+ const encoding45_12 = c.frame(encoding178)
7066
7104
  // @qvac/device-v1.toolCatalog, deferred due to recusive use
7067
7105
  const encoding47_18 = c.array(c.frame(encoding112))
7068
7106
  // @qvac/report-device-capabilities-operation-v1.toolCatalog, deferred due to recusive use
@@ -7481,6 +7519,8 @@ function getEncoding(name) {
7481
7519
  return encoding176
7482
7520
  case '@qvac/mesh-seed':
7483
7521
  return encoding177
7522
+ case '@qvac/chat-fork-source':
7523
+ return encoding178
7484
7524
  default:
7485
7525
  throw new Error('Encoder not found ' + name)
7486
7526
  }
@@ -1,12 +1,12 @@
1
1
  // This file is autogenerated by the hyperschema compiler
2
- // Schema Version: 14
2
+ // Schema Version: 15
3
3
  /* eslint-disable camelcase */
4
4
  /* eslint-disable quotes */
5
5
  /* eslint-disable space-before-function-paren */
6
6
 
7
7
  import { c } from 'hyperschema/runtime'
8
8
 
9
- const VERSION = 14
9
+ const VERSION = 15
10
10
 
11
11
  // eslint-disable-next-line no-unused-vars
12
12
  let version = VERSION
@@ -2102,7 +2102,8 @@ const encoding45 = {
2102
2102
  ((version >= 5 && m.groupId) ? 16 : 0) |
2103
2103
  ((version >= 6 && m.rank) ? 32 : 0) |
2104
2104
  ((version >= 6 && m.rankedAt) ? 64 : 0) |
2105
- ((version >= 12 && m.readThrough) ? 128 : 0)
2105
+ ((version >= 12 && m.readThrough) ? 128 : 0) |
2106
+ ((version >= 15 && m.forkedFrom) ? 256 : 0)
2106
2107
 
2107
2108
  c.string.preencode(state, m.id)
2108
2109
  c.string.preencode(state, m.agentId)
@@ -2116,6 +2117,7 @@ const encoding45 = {
2116
2117
  if (version >= 6 && m.rank) c.float64.preencode(state, m.rank)
2117
2118
  if (version >= 6 && m.rankedAt) c.uint.preencode(state, m.rankedAt)
2118
2119
  if (version >= 12 && m.readThrough) c.uint.preencode(state, m.readThrough)
2120
+ if (version >= 15 && m.forkedFrom) encoding45_12.preencode(state, m.forkedFrom)
2119
2121
  },
2120
2122
  encode(state, m) {
2121
2123
  const flags =
@@ -2126,7 +2128,8 @@ const encoding45 = {
2126
2128
  ((version >= 5 && m.groupId) ? 16 : 0) |
2127
2129
  ((version >= 6 && m.rank) ? 32 : 0) |
2128
2130
  ((version >= 6 && m.rankedAt) ? 64 : 0) |
2129
- ((version >= 12 && m.readThrough) ? 128 : 0)
2131
+ ((version >= 12 && m.readThrough) ? 128 : 0) |
2132
+ ((version >= 15 && m.forkedFrom) ? 256 : 0)
2130
2133
 
2131
2134
  c.string.encode(state, m.id)
2132
2135
  c.string.encode(state, m.agentId)
@@ -2140,6 +2143,7 @@ const encoding45 = {
2140
2143
  if (version >= 6 && m.rank) c.float64.encode(state, m.rank)
2141
2144
  if (version >= 6 && m.rankedAt) c.uint.encode(state, m.rankedAt)
2142
2145
  if (version >= 12 && m.readThrough) c.uint.encode(state, m.readThrough)
2146
+ if (version >= 15 && m.forkedFrom) encoding45_12.encode(state, m.forkedFrom)
2143
2147
  },
2144
2148
  decode(state) {
2145
2149
  const r0 = c.string.decode(state)
@@ -2161,7 +2165,8 @@ const encoding45 = {
2161
2165
  groupId: (version >= 5 && (flags & 16) !== 0) ? c.string.decode(state) : null,
2162
2166
  rank: (version >= 6 && (flags & 32) !== 0) ? c.float64.decode(state) : 0,
2163
2167
  rankedAt: (version >= 6 && (flags & 64) !== 0) ? c.uint.decode(state) : 0,
2164
- readThrough: (version >= 12 && (flags & 128) !== 0) ? c.uint.decode(state) : 0
2168
+ readThrough: (version >= 12 && (flags & 128) !== 0) ? c.uint.decode(state) : 0,
2169
+ forkedFrom: (version >= 15 && (flags & 256) !== 0) ? encoding45_12.decode(state) : null
2165
2170
  }
2166
2171
  }
2167
2172
  }
@@ -7063,6 +7068,39 @@ const encoding177 = {
7063
7068
  }
7064
7069
  }
7065
7070
 
7071
+ // @qvac/chat-fork-source
7072
+ const encoding178 = {
7073
+ preencode(state, m) {
7074
+ c.string.preencode(state, m.meshId)
7075
+ c.string.preencode(state, m.chatId)
7076
+ state.end++ // max flag is 1 so always one byte
7077
+
7078
+ if (version >= 15 && m.runId) c.string.preencode(state, m.runId)
7079
+ },
7080
+ encode(state, m) {
7081
+ const flags = (version >= 15 && m.runId) ? 1 : 0
7082
+
7083
+ c.string.encode(state, m.meshId)
7084
+ c.string.encode(state, m.chatId)
7085
+ c.uint.encode(state, flags)
7086
+
7087
+ if (version >= 15 && m.runId) c.string.encode(state, m.runId)
7088
+ },
7089
+ decode(state) {
7090
+ const r0 = c.string.decode(state)
7091
+ const r1 = c.string.decode(state)
7092
+ const flags = c.uint.decode(state)
7093
+
7094
+ return {
7095
+ meshId: r0,
7096
+ chatId: r1,
7097
+ runId: (version >= 15 && (flags & 1) !== 0) ? c.string.decode(state) : null
7098
+ }
7099
+ }
7100
+ }
7101
+
7102
+ // @qvac/chat-v1.forkedFrom, deferred due to recusive use
7103
+ const encoding45_12 = c.frame(encoding178)
7066
7104
  // @qvac/device-v1.toolCatalog, deferred due to recusive use
7067
7105
  const encoding47_18 = c.array(c.frame(encoding112))
7068
7106
  // @qvac/report-device-capabilities-operation-v1.toolCatalog, deferred due to recusive use
@@ -7481,6 +7519,8 @@ function getEncoding(name) {
7481
7519
  return encoding176
7482
7520
  case '@qvac/mesh-seed':
7483
7521
  return encoding177
7522
+ case '@qvac/chat-fork-source':
7523
+ return encoding178
7484
7524
  default:
7485
7525
  throw new Error('Encoder not found ' + name)
7486
7526
  }
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": 14,
2
+ "version": 15,
3
3
  "schema": [
4
4
  {
5
5
  "name": "chunk-type",
@@ -1413,6 +1413,11 @@
1413
1413
  "name": "readThrough",
1414
1414
  "type": "uint",
1415
1415
  "version": 12
1416
+ },
1417
+ {
1418
+ "name": "forkedFrom",
1419
+ "type": "@qvac/chat-fork-source",
1420
+ "version": 15
1416
1421
  }
1417
1422
  ]
1418
1423
  },
@@ -4253,6 +4258,31 @@
4253
4258
  "version": 1
4254
4259
  }
4255
4260
  ]
4261
+ },
4262
+ {
4263
+ "name": "chat-fork-source",
4264
+ "namespace": "qvac",
4265
+ "compact": false,
4266
+ "flagsPosition": 2,
4267
+ "fields": [
4268
+ {
4269
+ "name": "meshId",
4270
+ "required": true,
4271
+ "type": "string",
4272
+ "version": 15
4273
+ },
4274
+ {
4275
+ "name": "chatId",
4276
+ "required": true,
4277
+ "type": "string",
4278
+ "version": 15
4279
+ },
4280
+ {
4281
+ "name": "runId",
4282
+ "type": "string",
4283
+ "version": 15
4284
+ }
4285
+ ]
4256
4286
  }
4257
4287
  ]
4258
4288
  }
@@ -1,5 +1,5 @@
1
1
  // This file is autogenerated by hyperschema-ts
2
- // Schema version: 14
2
+ // Schema version: 15
3
3
  // Do not edit manually.
4
4
 
5
5
  export type QvacChunkType = "user-message" | "content" | "thinking" | "tool-call" | "tool-result" | "attachment" | "approval-request" | "run-status" | "run-request" | "sources" | "compaction"
@@ -256,6 +256,7 @@ export interface QvacChatV1 {
256
256
  rank?: number
257
257
  rankedAt?: number
258
258
  readThrough?: number
259
+ forkedFrom?: QvacChatForkSource | null
259
260
  }
260
261
 
261
262
  export type QvacChat = (QvacChatV1 & { version?: number })
@@ -844,6 +845,12 @@ export interface QvacMeshSeedV1 {
844
845
 
845
846
  export type QvacMeshSeed = (QvacMeshSeedV1 & { version?: number })
846
847
 
848
+ export interface QvacChatForkSource {
849
+ meshId: string
850
+ chatId: string
851
+ runId?: string | null
852
+ }
853
+
847
854
  export interface SchemaTypes {
848
855
  "@qvac/chunk-type": QvacChunkType
849
856
  "@qvac/run-state": QvacRunState
@@ -1023,4 +1030,5 @@ export interface SchemaTypes {
1023
1030
  "@qvac/open-join": QvacOpenJoin
1024
1031
  "@qvac/mesh-seed-v1": QvacMeshSeedV1
1025
1032
  "@qvac/mesh-seed": QvacMeshSeed
1033
+ "@qvac/chat-fork-source": QvacChatForkSource
1026
1034
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qvac/core",
3
- "version": "0.7.0",
3
+ "version": "0.7.2",
4
4
  "type": "module",
5
5
  "description": "Peer-to-peer AI across your devices",
6
6
  "engines": {
@@ -151,6 +151,7 @@
151
151
  "models-by-task": "bare examples/models-by-task.mjs",
152
152
  "models-watch": "bare examples/models-watch.mjs",
153
153
  "model-downloads-held": "bare examples/model-downloads-held.mjs",
154
+ "blind-peering": "bare examples/blind-peering.mjs",
154
155
  "chunks-delta-watch": "bare examples/chunks-delta-watch.mjs",
155
156
  "mesh-pair-and-migrate": "bare examples/mesh-pair-and-migrate.mjs",
156
157
  "mesh-scoped-catalog": "bare examples/mesh-scoped-catalog.mjs",
@@ -159,11 +160,12 @@
159
160
  "mesh-lab": "bare examples/mesh-lab.mjs",
160
161
  "chat-read-marker": "bare examples/chat-read-marker.mjs",
161
162
  "chat-move": "bare examples/chat-move.mjs",
163
+ "chat-fork": "bare examples/chat-fork.mjs",
162
164
  "custom-models": "bare examples/custom-models.mjs",
163
165
  "mesh-recover-account": "bare examples/mesh-recover-account.mjs",
164
166
  "mesh-user-names": "bare examples/mesh-user-names.mjs",
165
167
  "test": "npm run test:bare && npm run bench:rag:test",
166
- "test:bare": "QVAC_NO_SKILL_BIN_PROBE=1 brittle-jobs -j 2 --retries 1 --timeout 600000 'test/*.ts' 'test/{api,basic,host,rag}/**/*.ts' 'test/tui/**/!(helpers).ts'",
168
+ "test:bare": "QVAC_NO_SKILL_BIN_PROBE=1 QVAC_TEST=1 brittle-jobs -j 2 --retries 1 --timeout 600000 'test/*.ts' 'test/{api,basic,host,rag}/**/*.ts' 'test/tui/**/!(helpers).ts'",
167
169
  "test:model": "QVAC_TEST_MODELS=1 npm run test:bare",
168
170
  "format": "prettier . --write",
169
171
  "lint": "prettier . --check && lunte && tsc --noEmit",
@@ -231,8 +233,8 @@
231
233
  }
232
234
  },
233
235
  "dependencies": {
234
- "@qvac/harness": "^0.8.6",
235
- "@qvac/skills": "0.1.12",
236
+ "@qvac/harness": "^0.8.7",
237
+ "@qvac/skills": "0.1.14",
236
238
  "asenion": "^0.1.0",
237
239
  "autobee": "^2.11.8",
238
240
  "b4a": "^1.9.0",
@@ -264,7 +266,7 @@
264
266
  "bare-url": "^2.4.5",
265
267
  "bare-worker": "^4.5.0",
266
268
  "blind-peer": "^3.10.2",
267
- "blind-peering": "^2.7.0",
269
+ "blind-peering": "2.9.5",
268
270
  "compact-encoding": "^3.4.0",
269
271
  "corestore": "^7.12.6",
270
272
  "hrpc": "^4.3.0",
@@ -310,8 +312,8 @@
310
312
  "holepunch-types": "^0.2.2",
311
313
  "hyperdht": "^6.32.0",
312
314
  "hyperschema-regen": "^3.0.1",
313
- "lunte": "^1.8.3",
314
- "lunte-plugin-qvac": "^0.1.0",
315
+ "lunte": "^1.8.6",
316
+ "lunte-plugin-qvac": "^0.2.0",
315
317
  "prettier": "^3.6.2",
316
318
  "prettier-config-holepunch": "^2.0.0",
317
319
  "prettytap": "^0.2.0",
@@ -336,6 +338,7 @@
336
338
  "localwatch@1.4.3": "patches/localwatch@1.4.3.patch",
337
339
  "bare-stow@0.1.5": "patches/bare-stow@0.1.5.patch",
338
340
  "@qvac/inference@0.21.0": "patches/@qvac%2Finference@0.21.0.patch",
341
+ "blind-peering@2.9.5": "patches/blind-peering@2.9.5.patch",
339
342
  "hyperdb@6.9.0": "patches/hyperdb@6.9.0.patch"
340
343
  },
341
344
  "overrides": {
package/tui/README.md CHANGED
@@ -42,19 +42,22 @@ Bare's native TTY; the TUI will not run under node.
42
42
  ## Usage
43
43
 
44
44
  ```
45
- duck [--storage <dir>] [--temp] [--headless] [--fake-models]
45
+ duck [--storage <dir>] [--temp] [--headless] [--join <invite>] [--fake-models]
46
46
  ```
47
47
 
48
- Flags may appear in any order. Joining a mesh is `/join qvac://mesh/…` inside
49
- the app, not a boot argument.
48
+ Flags may appear in any order. Inside the app, `/join qvac://mesh/…` moves a
49
+ running instance to another mesh.
50
50
 
51
51
  - `--storage <dir>` — a self-contained root (its own corestore and SDK home
52
52
  under `<dir>`). `QVAC_STORAGE` is the env fallback.
53
53
  - `--temp` — the same, in a throwaway dir. `QVAC_TEMP=1` is the env fallback.
54
- - `--headless` — brings the same stack up with no TUI: prints the mesh invite,
55
- then streams logs (including the sidecar child's own output) to stdout until
54
+ - `--headless` — brings the same stack up with no TUI: prints this device's invite
55
+ (it adds one of your own devices), then streams logs (including the sidecar child's own output) to stdout until
56
56
  ctrl+C. A mesh peer to point other instances at, and the only live view of
57
57
  the boot the TUI hides.
58
+ - `--join <invite>` (`-j`) — joins that mesh invite at boot, with no preview
59
+ step, then prints this device's invite, as without the flag. For a headless peer that has no
60
+ prompt to `/join` from.
58
61
  - `--fake-models` — adds the `quack` model, a fake LLM that runs no inference:
59
62
  it replies with `quack` repeated a number of times taken from a hash of the
60
63
  prompt, so the same prompt always gets the same reply. Pick it with