vibe64 0.1.35 → 0.1.36

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 (208) hide show
  1. package/bin/run.js +1919 -1660
  2. package/bin/server.js +158 -111
  3. package/bin/upgrade-state.js +5783 -5605
  4. package/dist/assets/GithubBrowserTabs-BzJF4k9Y.js +1 -0
  5. package/dist/assets/{StudioErrorNotice-sQfmeR-z.js → StudioErrorNotice-BdllGqRy.js} +1 -1
  6. package/dist/assets/{Vibe64AsyncModuleState-Dx7YKRPp.js → Vibe64AsyncModuleState-Bi0TqlIu.js} +1 -1
  7. package/dist/assets/Vibe64AuthSettingsButton-BuvmwGiT.js +5 -0
  8. package/dist/assets/Vibe64AuthSettingsButton-M44SSmZ9.css +1 -0
  9. package/dist/assets/{Vibe64DashboardBackButton-yE6cyYg2.js → Vibe64DashboardBackButton-Ccd4hpD6.js} +1 -1
  10. package/dist/assets/Vibe64DashboardShell-D67m4aWz.js +1 -0
  11. package/dist/assets/{Vibe64DashboardShell-MBkUHjs-.css → Vibe64DashboardShell-De2mbdpI.css} +1 -1
  12. package/dist/assets/{Vibe64DatabaseWorkspace-BONJdxBS.js → Vibe64DatabaseWorkspace-D3uK1gDm.js} +3 -3
  13. package/dist/assets/{Vibe64DatabaseWorkspace-CR4pzzcf.css → Vibe64DatabaseWorkspace-DPDMxhAW.css} +1 -1
  14. package/dist/assets/Vibe64OutputControls-BfESn5kJ.js +8 -0
  15. package/dist/assets/Vibe64OutputControls-D2CCECo5.css +1 -0
  16. package/dist/assets/{Vibe64RepositoryWorkspace-ByQlZbyO.js → Vibe64RepositoryWorkspace-0jAxvdA8.js} +2 -2
  17. package/dist/assets/{Vibe64RepositoryWorkspace-CVHcT93M.css → Vibe64RepositoryWorkspace-Agyt4O-V.css} +1 -1
  18. package/dist/assets/Vibe64SessionFiles-B3ONZrBL.css +1 -0
  19. package/dist/assets/Vibe64SessionFiles-BCOJ4QmR.js +41 -0
  20. package/dist/assets/{Vibe64TemporaryAiFixAction-BGlcrq4d.js → Vibe64TemporaryAiFixAction-DM2jpPbQ.js} +1 -1
  21. package/dist/assets/{Vibe64UiStoryboardView-Brlwdvqi.js → Vibe64UiStoryboardView-DP5af46a.js} +1 -1
  22. package/dist/assets/{Vibe64UnavailableSessions-zwlWlcZD.js → Vibe64UnavailableSessions-C7XwH1SS.js} +1 -1
  23. package/dist/assets/{_sessionId_-CvOkQbVy.js → _sessionId_-B1Ymr7c_.js} +1 -1
  24. package/dist/assets/{_sessionTool_-Dwod5ns9.js → _sessionTool_-DVYdREoI.js} +1 -1
  25. package/dist/assets/_slug_-CQseA9pt.css +1 -0
  26. package/dist/assets/_slug_-CYO2vjCd.js +24 -0
  27. package/dist/assets/{access-BVu5XYm2.js → access-Cb7dkN53.js} +1 -1
  28. package/dist/assets/app-BvgY7oVf.js +1 -0
  29. package/dist/assets/app-CZu7oxUO.css +1 -0
  30. package/dist/assets/{assistantRouting-CwbwfkwB.js → assistantRouting-B38ujQ7x.js} +1 -1
  31. package/dist/assets/{changes-olY8cnFK.js → changes-lsBcuikn.js} +1 -1
  32. package/dist/assets/client-CRI5CNKl.js +2 -0
  33. package/dist/assets/client-TGaWwOhc.css +1 -0
  34. package/dist/assets/conversation-CDEt9jBx.js +17 -0
  35. package/dist/assets/conversation-vxJGwmtW.css +1 -0
  36. package/dist/assets/{dashboard-BnXD-H4R.js → dashboard-D8HOAw46.js} +1 -1
  37. package/dist/assets/definitions-DLTX17nI.js +1 -0
  38. package/dist/assets/{env-DJhnLOH7.css → env-BzRtyO0w.css} +1 -1
  39. package/dist/assets/env-DJezQixO.js +1 -0
  40. package/dist/assets/health-BJvooRnJ.css +1 -0
  41. package/dist/assets/health-CtKdN_Nf.js +1 -0
  42. package/dist/assets/{history-BxlpB-YH.js → history-BdZFOtz4.js} +1 -1
  43. package/dist/assets/{incoming-BOxRVlOM.js → incoming-VsQNnL9m.js} +1 -1
  44. package/dist/assets/index-C-osVUKw.css +1 -0
  45. package/dist/assets/index-C4K3ntms.js +138 -0
  46. package/dist/assets/{integrations-BFltGDVI.js → integrations-CMQ9EDmt.js} +2 -2
  47. package/dist/assets/issues-DHpY5hSr.js +1 -0
  48. package/dist/assets/learning-DXlMuwzh.js +1 -0
  49. package/dist/assets/mdi-yXT-CQ6u.js +1 -0
  50. package/dist/assets/placement-NpX2s7u8.js +1 -0
  51. package/dist/assets/pull-requests-BcKNEUYH.js +1 -0
  52. package/dist/assets/{repository-JWLVST3D.js → repository-ClEgntHW.js} +1 -1
  53. package/dist/assets/roboto-latin-wght-normal-ccAYIvAh.woff2 +0 -0
  54. package/dist/assets/{session-C5Nj8Dlq.js → session-BlD46q-d.js} +1 -1
  55. package/dist/assets/settings-BwukeIKe.js +1 -0
  56. package/dist/assets/shared-BM2SV6fi.js +2 -0
  57. package/dist/assets/studioGateApi-DcCqiD9V.js +1 -0
  58. package/dist/assets/studioUrls-DmMMIScP.js +1 -0
  59. package/dist/assets/useArchivedVibe64Sessions-D5zUA-BC.js +1 -0
  60. package/dist/assets/useCommand-Bqxb-naz.js +1 -0
  61. package/dist/assets/useEndpointResource-DWoQ2keu.js +1 -0
  62. package/dist/assets/useRealtimeEvent-Bwapstla.js +1 -0
  63. package/dist/assets/{useUiFeedback-0FqKuZRP.js → useUiFeedback-BPBF_0bp.js} +1 -1
  64. package/dist/assets/useVibe64ConversationLog-Dy6YTPQn.js +1 -0
  65. package/dist/assets/useVibe64DatabaseTools-d6L09ugW.js +1 -0
  66. package/dist/assets/useVibe64Learning-cNKTv64W.js +1 -0
  67. package/dist/assets/useVibe64ProjectScope-Bp1ImZlz.js +1 -0
  68. package/dist/assets/useVibe64SessionData-C_jqncih.js +1 -0
  69. package/dist/assets/useVibe64SessionSelection-uCEIWd3b.js +1 -0
  70. package/dist/assets/useVibe64SystemGraph-B4RmsC9Y.js +1 -0
  71. package/dist/assets/{useVibe64Terminal-BPnN25WH.js → useVibe64Terminal-BbghGR4x.js} +1 -1
  72. package/dist/assets/vibe64AssistantHost-BL1bnKm8.js +1 -0
  73. package/dist/assets/{vibe64SessionFocus-kqPOPaOH.js → vibe64SessionFocus-DSJKVuRN.js} +1 -1
  74. package/dist/assets/{vibe64SessionInfo-BHxtTrLX.js → vibe64SessionInfo-B_r1OMN0.js} +1 -1
  75. package/dist/assets/{vibe64SessionPanelModel-BMf64fv7.js → vibe64SessionPanelModel-DDorOuiL.js} +1 -1
  76. package/dist/assets/{vibe64SessionToolDefinitions-NfLd1HZI.js → vibe64SessionToolDefinitions-BualCK_5.js} +1 -1
  77. package/dist/index.html +21 -20
  78. package/docs/colleague-usage/account-profile-and-appearance.md +8 -2
  79. package/docs/colleague-usage/ai-accounts-and-routing.md +123 -15
  80. package/docs/colleague-usage/ai-onboarding.md +230 -0
  81. package/docs/colleague-usage/coding-agent-goal-pause.md +5 -5
  82. package/docs/colleague-usage/coding-agents.md +17 -0
  83. package/docs/colleague-usage/colleague-watches.md +4 -23
  84. package/docs/colleague-usage/colleague.md +10 -2
  85. package/docs/colleague-usage/connected-projects.md +2 -2
  86. package/docs/colleague-usage/conversation-context.md +2 -0
  87. package/docs/colleague-usage/dashboard-navigation.md +19 -27
  88. package/docs/colleague-usage/database.md +6 -11
  89. package/docs/colleague-usage/development-copies.md +2 -1
  90. package/docs/colleague-usage/development-env.md +6 -0
  91. package/docs/colleague-usage/github-work.md +9 -0
  92. package/docs/colleague-usage/health-checks.md +11 -5
  93. package/docs/colleague-usage/integrations.md +3 -1
  94. package/docs/colleague-usage/learning-code-questions.md +23 -51
  95. package/docs/colleague-usage/learning-course-catalogue.md +8 -6
  96. package/docs/colleague-usage/learning-environment.md +345 -0
  97. package/docs/colleague-usage/learning-history.md +70 -101
  98. package/docs/colleague-usage/learning-mode-ui.md +122 -214
  99. package/docs/colleague-usage/learning-practice-projects.md +168 -78
  100. package/docs/colleague-usage/learning-teacher-guide.md +48 -26
  101. package/docs/colleague-usage/learning-with-colleague.md +171 -216
  102. package/docs/colleague-usage/lesson-authoring.md +32 -24
  103. package/docs/colleague-usage/managed-app-access.md +7 -0
  104. package/docs/colleague-usage/message-delivery-recovery.md +7 -6
  105. package/docs/colleague-usage/preview-browser-checks.md +9 -1
  106. package/docs/colleague-usage/preview-starting-application.md +0 -1
  107. package/docs/colleague-usage/preview.md +9 -1
  108. package/docs/colleague-usage/project-messages.md +2 -2
  109. package/docs/colleague-usage/project-setup.md +9 -2
  110. package/docs/colleague-usage/running-vibe64-on-your-computer.md +61 -0
  111. package/docs/colleague-usage/sessions.md +25 -33
  112. package/docs/colleague-usage/teaching-content.md +11 -40
  113. package/docs/colleague-usage/temporary-chats.md +23 -2
  114. package/docs/colleague-usage/voice-chat.md +5 -10
  115. package/docs/colleague-usage/voice-face-and-speaking-voice.md +6 -8
  116. package/docs/colleague-usage/voice-recovery.md +3 -2
  117. package/docs/templates/learn-topic/README.md +6 -6
  118. package/docs/templates/learn-topic/training/lessons/TOPIC-01/lesson.json +28 -7
  119. package/docs/templates/learn-topic/training/lessons/TOPIC-01/notes.md +19 -0
  120. package/docs/templates/learn-topic/training/lessons/TOPIC-01/steps/check-understanding.md +3 -0
  121. package/docs/templates/learn-topic/training/lessons/TOPIC-01/steps/explain-idea.md +3 -0
  122. package/docs/templates/learn-topic/training/lessons/TOPIC-01/steps/try-it.md +3 -0
  123. package/docs/templates/learn-topic/training/outline.md +1 -1
  124. package/docs/training-content.md +179 -65
  125. package/node_modules/@jskit-ai/assistant-core/package.json +1 -1
  126. package/node_modules/@jskit-ai/assistant-runtime/package.json +1 -1
  127. package/node_modules/@jskit-ai/assistant-runtime/patterns/assistant-surface/PATTERN.md +3 -2
  128. package/node_modules/@jskit-ai/assistant-runtime/patterns/assistant-surface/example/integrations.json +3 -2
  129. package/node_modules/@jskit-ai/assistant-voice/package.json +1 -1
  130. package/node_modules/@jskit-ai/connectors-catalog/package.json +1 -1
  131. package/node_modules/@jskit-ai/connectors-catalog/patterns/ai-connections/PATTERN.md +4 -3
  132. package/node_modules/@jskit-ai/connectors-catalog/src/shared/ai-models.json +0 -1
  133. package/node_modules/@local/vibe64-accounts/package.json +1 -0
  134. package/node_modules/@local/vibe64-colleague/package.json +2 -1
  135. package/node_modules/@local/vibe64-core/package.json +3 -0
  136. package/node_modules/@local/vibe64-execution/package.json +1 -0
  137. package/node_modules/@local/vibe64-execution/src/host/execHelper.js +171 -174
  138. package/node_modules/@local/vibe64-execution/src/server/engines/stdioBridge.js +9 -9
  139. package/node_modules/@local/vibe64-genesis/README.md +10 -37
  140. package/node_modules/@local/vibe64-genesis/bin/vibe64-genesis-host-context +790 -779
  141. package/node_modules/@local/vibe64-genesis/package.json +1 -0
  142. package/node_modules/@local/vibe64-genesis/src/server/agentSpecs.js +255 -0
  143. package/node_modules/@local/vibe64-genesis/src/server/index.js +473 -450
  144. package/node_modules/@local/vibe64-genesis/src/server/promptContext.js +148 -148
  145. package/node_modules/@local/vibe64-project/package.json +2 -1
  146. package/node_modules/@local/vibe64-runtime/package.json +1 -2
  147. package/node_modules/@local/vibe64-runtime/src/server/codexAppServerProcess.js +526 -512
  148. package/node_modules/@local/vibe64-runtime/src/shared/assistantRoutingScores.json +0 -1
  149. package/node_modules/@local/vibe64-source-editor/package.json +1 -0
  150. package/node_modules/@local/vibe64-terminals/package.json +1 -0
  151. package/node_modules/@local/vibe64-terminals/src/server/opencodeSessionEnvironmentPlugin.js +129 -131
  152. package/node_modules/@local/vibe64-terminals/src/server/sessionWorkOperationCommand.js +1508 -1456
  153. package/node_modules/@local/vibe64-training/package.json +13 -27
  154. package/package.json +7 -7
  155. package/server.bundle.mjs +40946 -41456
  156. package/dist/assets/GithubBrowserTabs-DO5PHon-.js +0 -1
  157. package/dist/assets/GithubMarkdown-BQ6MfCDJ.js +0 -3
  158. package/dist/assets/GithubMarkdown-U7-j-qNI.css +0 -1
  159. package/dist/assets/Vibe64DashboardShell-CuCVMhOc.js +0 -1
  160. package/dist/assets/Vibe64OutputControls-DAAmA09l.js +0 -8
  161. package/dist/assets/Vibe64OutputControls-DPBsyDZM.css +0 -1
  162. package/dist/assets/Vibe64SessionFiles-B0u9HKdF.js +0 -107
  163. package/dist/assets/Vibe64SessionFiles-NjOMVwPR.css +0 -1
  164. package/dist/assets/_slug_-B31c15cc.css +0 -1
  165. package/dist/assets/_slug_-Dy35qLo1.js +0 -1
  166. package/dist/assets/app-DRXCcv05.css +0 -1
  167. package/dist/assets/app-zt7HwQKT.js +0 -1
  168. package/dist/assets/client-BrV4QPwG.js +0 -2
  169. package/dist/assets/client-C1bwIlu6.css +0 -1
  170. package/dist/assets/definitions-DaOPIkyB.js +0 -1
  171. package/dist/assets/env-DN0vW4EI.js +0 -1
  172. package/dist/assets/health-7oIQODer.css +0 -1
  173. package/dist/assets/health-Z6m96GDr.js +0 -1
  174. package/dist/assets/index-BUq-MczL.js +0 -86
  175. package/dist/assets/index-DtmBqE3h.css +0 -1
  176. package/dist/assets/issues-1iS5zoed.js +0 -1
  177. package/dist/assets/layout-BkWVNT37.js +0 -1
  178. package/dist/assets/mdi-C54lQ0i_.js +0 -1
  179. package/dist/assets/placement-DLsU3pCW.js +0 -1
  180. package/dist/assets/pull-requests-BJOwNL4k.js +0 -1
  181. package/dist/assets/settings-c273Ikrm.js +0 -1
  182. package/dist/assets/shared-YZb7ocaK.js +0 -2
  183. package/dist/assets/studioGateApi-DhA9IJGZ.js +0 -1
  184. package/dist/assets/studioUrls-Dj8rXeXO.js +0 -1
  185. package/dist/assets/useArchivedVibe64Sessions-CVZx2Rtm.js +0 -1
  186. package/dist/assets/useCommand-DWuxfAV0.js +0 -1
  187. package/dist/assets/useEndpointResource-MWVNfmMa.js +0 -1
  188. package/dist/assets/useVibe64ConversationLog-8cKh1eDm.js +0 -1
  189. package/dist/assets/useVibe64DatabaseTools-BcRG1s3i.js +0 -1
  190. package/dist/assets/useVibe64LearningMode-Bl0dGdCh.js +0 -28
  191. package/dist/assets/useVibe64LearningMode-C3PcXdVg.css +0 -1
  192. package/dist/assets/useVibe64ProjectScope-DOEVkBqX.js +0 -1
  193. package/dist/assets/useVibe64SessionData-DFTyLzci.js +0 -1
  194. package/dist/assets/useVibe64SessionSelection-j9lsllx4.js +0 -1
  195. package/dist/assets/useVibe64SystemGraph-tNkIwSBQ.js +0 -1
  196. package/dist/assets/vibe64AssistantHost-DdE_-lZF.js +0 -1
  197. package/dist/assets/vibe64LessonDashboard-DlKYjisq.js +0 -1
  198. package/dist/assets/vibe64ProjectScope.local-DqT6e5un.js +0 -1
  199. package/docs/colleague-usage/learning-chat-retention.md +0 -74
  200. package/docs/colleague-usage/learning-diagrams-and-voice.md +0 -97
  201. package/docs/colleague-usage/learning-lesson-watch.md +0 -95
  202. package/docs/colleague-usage/learning-native-session.md +0 -206
  203. package/docs/colleague-usage/learning-practical-exercises.md +0 -71
  204. package/docs/colleague-usage/learning-practical-gestures.md +0 -48
  205. package/docs/colleague-usage/learning-session-creation.md +0 -95
  206. package/docs/colleague-usage/lesson-practical-assessment.md +0 -54
  207. package/docs/colleague-usage/preview-lesson-presentation.md +0 -56
  208. package/docs/templates/learn-topic/training/lessons/TOPIC-01/lesson.md +0 -44
@@ -1,6 +1,6 @@
1
1
  # Copyable teaching topic template
2
2
 
3
- This is a complete directory template for an **incomplete draft topic**. It has one draft answer-based lesson and no exercise, executable check or visual. Do not teach it, award progress from its placeholder rubric, or mark it published before human review.
3
+ This is a complete directory template for an **incomplete draft topic**. It has one draft lesson in lesson format v2 (schemaVersion `2`): optional notes and three steps — a reading step (`none`), a multiple-choice step (`choice`) and a learner-ticked step (`self`) — with no exercise, automatic check or visual. Do not teach it or mark it published before human review. Check verdicts are final: there is no rubric or AI grader, and Colleague never passes a step.
4
4
 
5
5
  ## Copy and adapt
6
6
 
@@ -11,10 +11,10 @@ This is a complete directory template for an **incomplete draft topic**. It has
11
11
  ```
12
12
 
13
13
  Work in the copy. No dependency install or new application framework is needed for these content files.
14
- 2. In the copied `package.json`, replace `name` with your `learn-` repository name, `vibe64Training.topicId` with a permanent topic ID, `domainId` with the intended domain ID, and `title` with the topic title. Keep version `0.1.0`, schemaVersion `1` and status `preview` while drafting. IDs start with a letter, contain only letters, digits or hyphens, and have at most 64 characters.
15
- 3. Replace `TOPIC-01` with your permanent first lesson code: rename its directory and update the root manifest's `lessons[0].code` and `descriptor`, the lesson descriptor's `code`, the Markdown title and outline row. Replace the lesson title in both its descriptor and teaching document. Keep the root entry `draft` and `required:true`.
16
- 4. Write the outline's learner, prerequisites, final ability and lesson outcomes. Replace the lesson document's planning text with explanations, demonstrations, learner tasks, a real passing rubric, hints, misconceptions and recovery. The descriptor's `explain-outcome` assessment must still refer to the exact standalone `<a id="explain-outcome"></a>` anchor as `lesson.md#explain-outcome`. If you rename the assessment, change all three references together.
17
- 5. To add lessons, copy the lesson directory to a new permanent code, update its code/title/anchors, and append a `draft` entry with the correct descriptor path to the root manifest and outline. Declare earlier lesson prerequisites as `{ "code": "YOUR-01" }` and topic prerequisites as `{ "topicId": "another-topic" }`. Referenced lessons must exist, precede their dependants and have no cycles. A published lesson cannot require a draft lesson.
14
+ 2. In the copied `package.json`, replace `name` with your `learn-` repository name, `vibe64Training.topicId` with a permanent topic ID, `domainId` with the intended domain ID, and `title` with the topic title. Keep version `0.1.0`, the topic manifest's schemaVersion `1` and status `preview` while drafting (lessons declare their own schemaVersion `2`). IDs start with a letter, contain only letters, digits or hyphens, and have at most 64 characters.
15
+ 3. Replace `TOPIC-01` with your permanent first lesson code: rename its directory and update the root manifest's `lessons[0].code` and `descriptor`, the lesson descriptor's `code`, the notes title and outline row. Keep the root entry `draft` and `required:true`.
16
+ 4. Write the outline's learner, prerequisites, final ability and lesson outcomes. Replace `notes.md` and each `steps/*.md` body with real text a learner can follow without AI. Edit `steps` in `lesson.json`: each step has a unique `id`, `title`, `body`, `check` and `required`. Use `choice` (`question`, 2–8 `options`, `answer` as 0-based option indexes), `self` (learner ticks **Done**), `none` (reading only, never required) or `auto` (a declared check; needs an exercise). At least one step must be required. Optional `guide` points at a real Vibe64 place and optional `visual` plays declared commands; see `docs/training-content.md`.
17
+ 5. To add lessons, copy the lesson directory to a new permanent code, update its code, title and steps, and append a `draft` entry with the correct descriptor path to the root manifest and outline. Declare earlier lesson prerequisites as `{ "code": "YOUR-01" }` and topic prerequisites as `{ "topicId": "another-topic" }`. Referenced lessons must exist, precede their dependants and have no cycles. A published lesson cannot require a draft lesson.
18
18
  6. From the copied topic root, run the installed authoring command:
19
19
 
20
20
  ```sh
@@ -28,7 +28,7 @@ This is a complete directory template for an **incomplete draft topic**. It has
28
28
  ```
29
29
 
30
30
  Validation and bundling do not execute content, publish Git, install a topic or make drafts teachable. In a public Vibe64 development checkout, `node bin/run.js training ...` accepts the same arguments; run it from that checkout with the copied topic's absolute path.
31
- 7. Add practical work or a visual only when you have a real source and a supported producer. Follow the installed `docs/training-content.md` reference for exercise/check/visual descriptors, exact relative paths and declared auxiliary `assets`. Do not add fake readiness or capabilities to make a draft appear runnable.
31
+ 7. Add an exercise, an `auto` step or a visual only when you have a real source and a working check. Follow the installed `docs/training-content.md` reference (section **Lesson format v2: steps**) for exercise/check/visual descriptors, exact relative paths and declared auxiliary `assets`. Never point a step body, notes, visual or exercise at `lesson.json`: it holds the choice answers and is refused. Do not add fake readiness or capabilities to make a draft appear runnable.
32
32
  8. Trial and review the lesson with a human learner, including mistakes, assistance, recovery and relevant desktop/mobile controls. Only then change its root entry to `published`. Keep the topic `preview` until every required lesson is reviewed and published. A `released` topic cannot contain required draft lessons.
33
33
 
34
34
  Before generating a course lock, add the real source repository as root `repository.url` in the format `https://github.com/<owner>/learn-<topic>.git`, commit the intended topic and leave it clean. Use the installed publishing guide for `vibe64 training publish-manifest`; local lock generation does not create or publish a remote repository. A course chooses this whole topic, not a subset of its lessons.
@@ -1,17 +1,38 @@
1
1
  {
2
- "schemaVersion": 1,
2
+ "schemaVersion": 2,
3
3
  "code": "TOPIC-01",
4
4
  "title": "Replace with the learner task",
5
- "document": "lesson.md",
5
+ "notes": "notes.md",
6
6
  "prerequisites": [],
7
7
  "estimatedMinutes": 15,
8
8
  "visuals": [],
9
- "assessments": [
9
+ "steps": [
10
10
  {
11
- "id": "explain-outcome",
12
- "kind": "answer",
13
- "required": true,
14
- "rubric": "lesson.md#explain-outcome"
11
+ "id": "explain-idea",
12
+ "title": "Replace with the first idea",
13
+ "body": "steps/explain-idea.md",
14
+ "check": { "kind": "none" },
15
+ "required": false
16
+ },
17
+ {
18
+ "id": "check-understanding",
19
+ "title": "Replace with a check of that idea",
20
+ "body": "steps/check-understanding.md",
21
+ "check": {
22
+ "kind": "choice",
23
+ "question": "Replace with a question that has one clearly correct option.",
24
+ "options": ["Replace with the correct option", "Replace with a common misconception"],
25
+ "answer": [0]
26
+ },
27
+ "required": true
28
+ },
29
+ {
30
+ "id": "try-it",
31
+ "title": "Replace with what the learner does",
32
+ "body": "steps/try-it.md",
33
+ "guide": { "target": "preview", "navigate": true, "caption": "Replace with where to look" },
34
+ "check": { "kind": "self" },
35
+ "required": true
15
36
  }
16
37
  ]
17
38
  }
@@ -0,0 +1,19 @@
1
+ # TOPIC-01: Replace with the learner task
2
+
3
+ **Draft — replace all placeholders before publication.** These notes are optional background reading shown beside the steps. Nothing here is checked.
4
+
5
+ ## Learner and assumed knowledge
6
+
7
+ Name the learner and only the knowledge actually needed.
8
+
9
+ ## Outcomes
10
+
11
+ State the observable ability. Each required step must prove part of it with an automatic check, a choice, or the learner's own **Done**.
12
+
13
+ ## Required starting environment
14
+
15
+ Name the actual prerequisites and human-only steps. This template declares no exercise; if the lesson needs one, add and verify a real source before publication. No invented readiness.
16
+
17
+ ## Recovery and alternatives
18
+
19
+ Describe actual setup failure, leaving/returning and accessibility paths.
@@ -0,0 +1,3 @@
1
+ # Replace with a check of that idea
2
+
3
+ **Draft placeholder.** Set up the question shown below this text. Write options so the correct one is unambiguous and the others are real misconceptions. The learner sees the options, never the answer.
@@ -0,0 +1,3 @@
1
+ # Replace with the first idea
2
+
3
+ **Draft placeholder.** Explain one idea in ordinary language with a correct concrete example. A learner must be able to follow this text without AI. This reading step has no check and is not required.
@@ -0,0 +1,3 @@
1
+ # Replace with what the learner does
2
+
3
+ **Draft placeholder.** Name the exact real controls the learner uses and what they should see. The step's guide points at the Preview; change or remove it. The learner presses **Done** when finished; add an exercise and an automatic check when the result can be verified.
@@ -1,6 +1,6 @@
1
1
  # Example topic
2
2
 
3
- **Draft template — incomplete and not ready for teaching.** Replace every planning placeholder before reviewing a lesson for publication. Schema validation does not establish teaching quality or a passing learner rubric.
3
+ **Draft template — incomplete and not ready for teaching.** Replace every planning placeholder before reviewing a lesson for publication. Schema validation does not establish teaching quality or that a step's check proves the outcome.
4
4
 
5
5
  ## Learner and prerequisites
6
6
 
@@ -36,7 +36,14 @@ entry declares `code`, `descriptor`, `status` (`draft` or `published`) and
36
36
  `required`. A released topic cannot contain required draft lessons. Draft content
37
37
  is validated but remains unavailable for teaching until published and installed.
38
38
 
39
- A lesson descriptor declares schema version 1, `code`, `title`, `document`,
39
+ Lessons use lesson format v2 (see **Lesson format v2: steps** below). Format 1
40
+ is retired: `vibe64-training validate` and `publish-manifest` refuse a v1 lesson
41
+ ("Lesson X uses retired lesson format 1. Author it in format 2 with steps."), so
42
+ no new course release can contain one. Installed v1 lessons, and `bundle`, which
43
+ the installer uses, still read and verify them so earlier results stay valid.
44
+ The topic manifest itself stays schema version 1.
45
+
46
+ For reading existing content, a v1 lesson descriptor declares schema version 1, `code`, `title`, `document`,
40
47
  `estimatedMinutes`, `prerequisites` (`{code}` objects), `visuals` (`{id,descriptor}`)
41
48
  and `assessments`. Unknown fields and type coercion are rejected. IDs contain
42
49
  letters, digits or hyphens, begin with a letter and have at most 64 characters.
@@ -58,47 +65,107 @@ The managed application execution owner will run approved pinned checks; teachin
58
65
  tools do not gain arbitrary shell access. Demonstrations cannot earn learner passes.
59
66
 
60
67
  An exercise lesson may optionally declare the practice app's data-changing routes
61
- so a Learning watch can name a failed request the learner started:
62
- `appRoutes: [{method, path}]`, at most 16 unique entries. `method` is `POST`,
68
+ as `appRoutes: [{method, path}]`, at most 16 unique entries. `method` is `POST`,
63
69
  `PUT`, `PATCH` or `DELETE`; `path` starts with `/`, has no query, fragment or
64
70
  trailing slash, and each segment is a literal or `:id` (the Preview replaces
65
71
  numeric and UUID segments with `:id`). For the notes exercise:
66
72
  `"appRoutes": [{ "method": "POST", "path": "/api/notes" }]`. A failed request on
67
73
  any other path is still reported, as `other`, so route segments that might carry
68
- typed text never leave the learner's browser. Routes only label watch hints; they
69
- never grade, and a lesson without an exercise cannot declare them.
74
+ typed text never leave the learner's browser. Routes are validated with the
75
+ lesson but no current reader consumes them (they labelled the retired Learning
76
+ watch's hints); they never grade, and a lesson without an exercise cannot
77
+ declare them.
78
+
79
+ ### Lesson format v2: steps
80
+
81
+ A v2 `lesson.json` declares `schemaVersion: 2` and keeps `code`, `title`,
82
+ `prerequisites`, `estimatedMinutes`, `visuals`, `exercise`, `checks` and
83
+ `appRoutes` exactly as above. It has no `document` and no `assessments`:
84
+ an optional `notes` file (background reading) and 1–32 ordered `steps` replace
85
+ them. The fixture `tests/fixtures/training/steps-v2/` is a complete, validating
86
+ topic with every step kind; the copyable template is `docs/templates/learn-topic/`.
87
+
88
+ ```json
89
+ { "id": "open-preview", "title": "Open the Preview",
90
+ "body": "steps/open-preview.md",
91
+ "visual": { "id": "flow",
92
+ "play": [{ "name": "send", "parameters": { "label": "GET /" } }] },
93
+ "guide": { "target": "preview", "navigate": true, "caption": "Your app runs here" },
94
+ "check": { "kind": "auto", "check": "app-response", "files": [] },
95
+ "required": true }
96
+ ```
97
+
98
+ - `id` is a unique lesson ID; `title` is shown in the step list; `body` is a
99
+ Markdown file relative to the lesson descriptor. Bodies and `notes` are
100
+ included in lesson identity; two steps may share one body file.
101
+ - `required` steps decide completion: the lesson is complete when every
102
+ required step has passed. A lesson needs at least one required step.
103
+ - `visual` (optional) shows one of the lesson's declared `visuals`. `play`
104
+ lists at most 16 commands to run in order; each `name` is a command the
105
+ visual declares, and `parameters` is a `{name: string}` map that supplies
106
+ every required parameter within its `maxLength` and nothing undeclared.
107
+ - `guide` (optional) points at a real Vibe64 place: `target` is one of the
108
+ declared guide places (`preview`, `dashboard`, `database-erd`,
109
+ `database-data`, `files`, `changes`, `git-log`, `session-info`,
110
+ `architecture`, or `learning` for the **L** button). `navigate:true` opens
111
+ it as well as highlighting it (`dashboard` can only be pointed at).
112
+ `filePath` is allowed only with `files` and is a relative project path
113
+ without `..`. `caption` is at most 256 characters.
114
+ - `check.kind` is one of:
115
+ - `auto` — runs the declared check named by `check` (one of `checks[].id`)
116
+ and needs the lesson's `exercise`. A response check names no `files`
117
+ (omit them or use `[]`). A code check (`kind:"code"` in `checks`) names
118
+ 1–8 distinct exercise-relative `files`, the same file rules as a v1 code
119
+ question above.
120
+ - `choice` — `question` (at most 2000 characters), 2–8 `options` and
121
+ `answer`, a non-empty list of unique option indexes (0-based, in range).
122
+ The learner passes by selecting exactly the answer indexes.
123
+ - `self` — the learner ticks **Done** after doing the step.
124
+ - `none` — reading only; cannot be `required`. The learner may press
125
+ **Mark as done**, which records a learner-origin `read` pass (a bonus that
126
+ never counts toward completion).
127
+ A kind declares only its own fields; anything else is rejected.
128
+
129
+ **Check verdicts are final.** v2 has no rubric and no AI grader: an automatic
130
+ check or the choice comparator decides, otherwise the learner ticks a `self`
131
+ step (or marks a `none` step read). Colleague teaches and explains but never passes a step. Write step bodies
132
+ so a learner can follow them without AI.
133
+
134
+ Choice answers stay on the server. The lesson descriptor is never served to a
135
+ browser: a step body, `notes`, visual SVG/controller/asset or exercise file
136
+ cannot be any v2 lesson descriptor of the topic (for example, an exercise
137
+ `source` of `.` beside `lesson.json` is refused). The installed reader strips
138
+ `answer` from every projection; only the server comparator reads it.
70
139
 
71
140
  ### Authoring a code question
72
141
 
73
- A `code` practical asks the learner to change exercise code in the lesson
74
- Dashboard's **Code** tab and press **Check my code**. Declare it like this
75
- (the test fixture `tests/fixtures/training/code-practical/` is a complete,
76
- validating example):
142
+ A code question is an `auto` step whose `check` names a code check and whose
143
+ `files` name the exercise files the learner edits (the fixture
144
+ `tests/fixtures/training/steps-v2/` contains one):
77
145
 
78
146
  ```json
79
147
  "exercise": { "kind": "bundled", "source": "app", "reuse": "attempt" },
80
148
  "checks": [{ "id": "notes-title-required", "file": "checks/notes/title.mjs",
81
149
  "kind": "code", "timeoutSeconds": 15 }],
82
- "assessments": [{ "id": "require-note-title", "kind": "practical", "required": true,
83
- "rubric": "lesson.md#require-note-title",
84
- "evidence": { "producer": "code", "operation": "edit-and-check",
85
- "check": "notes-title-required", "files": ["notes.mjs"],
86
- "explanationRequired": true } }]
150
+ "steps": [{ "id": "require-title", "title": "Refuse empty titles",
151
+ "body": "steps/require-title.md",
152
+ "guide": { "target": "files", "navigate": true, "filePath": "notes.mjs" },
153
+ "check": { "kind": "auto", "check": "notes-title-required", "files": ["notes.mjs"] },
154
+ "required": true }]
87
155
  ```
88
156
 
89
157
  - `files` lists 1–8 exercise-relative paths the learner edits. Each must be an
90
158
  ordinary bundled exercise file (no `..`, absolute path, `.git`,
91
- `node_modules` or `.genesis` segment) and may appear once. Only `code`
92
- evidence may name files.
93
- - The check must declare `kind: "code"`; a code check can only be named by
94
- `code` evidence and an `exercise` check must not be a code check. Omitted
95
- `kind` means the existing `response` kind. `timeoutSeconds` (1–60, default
96
- 15) is allowed only on a code check. The operation is any lesson ID.
97
- - `reuse:"attempt"` is the supported exercise mode; sequence-reused baselines
98
- are not part of this first slice.
99
- - The rubric should ask for the learner's own explanation. The check alone
100
- never passes: the existing tool-free grading Helper grades the explanation
101
- against the rubric with the check result.
159
+ `node_modules` or `.genesis` segment) and may appear once.
160
+ - The check must declare `kind: "code"`. Omitted `kind` means the existing
161
+ `response` kind. `timeoutSeconds` (1–60, default 15) is allowed only on a code
162
+ check.
163
+ - `reuse:"attempt"` is the supported exercise mode for code checks.
164
+ - The check result alone is the verdict; there is no explanation rubric.
165
+
166
+ A retired v1 lesson declared the same check as `code` evidence of a practical
167
+ assessment (`tests/fixtures/training/code-practical/`); only `code` evidence may
168
+ name files or a code check, and an `exercise` check must not be a code check.
102
169
 
103
170
  The check runs with Node in the managed execution owner on a private copy laid
104
171
  out like the topic: the pinned exercise at its topic path, with only the
@@ -121,19 +188,17 @@ crashes the check before it prints a result, is "not yet passed" with a fixed
121
188
  explanation. stderr is ignored. Use plain `node:assert`-style logic rather than
122
189
  `node --test`, whose reporter writes to stdout.
123
190
 
124
- Authorship: when Main prepares a code question, Vibe64 records the SHA-256 of
125
- each declared file in the live practice project as the question's starting
126
- point. Each save from the learner's lesson Dashboard Files section is recorded server-side
127
- with its base hash, intended hash and saved hash. At **Check my code** the chain
128
- from the starting point through those saves must reach the current bytes
129
- exactly; otherwise the check is not run and the question is automatically not
130
- passed with "needs an independent attempt: other edits detected in `<file>`".
131
- In a practice lesson Main is also the learner's agent, but while a code
132
- question is open the teaching brief instructs Main not to write that question's
133
- declared files (even when asked) or send solution code, and to warn the learner
134
- that an agent edit there voids the attempt. The ledger above enforces this; there
135
- is no technical write-deny for agents in this slice. Teacher chat
136
- is not shared with the grader. The check is learner-run code on the learner's
191
+ Authorship: when the learner first opens a code step in an attempt, Vibe64
192
+ records the SHA-256 of each declared file in the live practice project as that
193
+ step's starting point. Each save from the practice project's **Dashboard →
194
+ Files** editor while a lesson is in progress in that project is recorded
195
+ server-side with its base hash, intended hash and saved hash. The ledger belongs
196
+ to the attempt (`training/users/<user-key>/code-ledgers/<attemptId>.json`), so
197
+ code from an earlier attempt never counts, and ending the attempt removes it. At **Check now** the chain from the starting point through those
198
+ saves must reach the current bytes exactly; otherwise the check is not run and
199
+ reports "needs an independent attempt: other edits detected in `<file>`". There
200
+ is no technical write-deny for agents: an agent edit in a declared file voids
201
+ the attempt through this ledger. The check is learner-run code on the learner's
137
202
  own machine and has no network isolation: for hosted use, sandboxing and network
138
203
  denial of the check job are an open gap.
139
204
 
@@ -205,25 +270,19 @@ ordered lesson identities. If a topic changes during generation, commit the
205
270
  intended content and retry. This command generates local release material only;
206
271
  it does not push Git, create a remote release, install content or enable a course.
207
272
 
208
- ### Lesson 0 is supplied by each installation
209
-
210
- Local and hosted Vibe64 are set up very differently, so "Set yourself up"
211
- (Lesson 0) is not part of the shared topic. Each installation supplies its own
212
- Lesson 0 topic and lists it first in the same course, followed by the shared,
213
- installation-agnostic topic:
273
+ ### Lesson 0 is the shared introduction
214
274
 
215
- ```json
216
- { "schemaVersion": 1, "courseId": "vibe64-getting-started-local", "title": "Getting started with local Vibe64",
217
- "release": "0.1.0", "status": "preview",
218
- "topics": [{ "topicId": "vibe64-local-setup", "release": "0.1.0" },
219
- { "topicId": "vibe64-getting-started", "release": "0.1.12" }] }
220
- ```
275
+ The getting-started course starts with V64-START-00 **Introduction to Vibe64**,
276
+ a tour of the editor on its own small practice project (the coding chat,
277
+ Preview, Dashboard, Save and Git log, Colleague, the Lesson pane, Courses and
278
+ **L**). It works the same way locally and on hosted Vibe64, and its coding-chat
279
+ steps are optional so it can be finished before an AI is connected. Connecting
280
+ an AI is not a lesson: it belongs to the AI setup screen (**Account settings →
281
+ AI Accounts**), which the introduction only points to.
221
282
 
222
- Local Vibe64 uses `learn-vibe64-local-setup` (V64-SETUP-00). It checks the
223
- machine through the real **Dashboard → Health** checks and **Account settings**,
224
- which Colleague can also read for the person. A hosted service keeps its own
225
- Lesson 0 topic in its own repository. Every later lesson stays in the shared
226
- topic and must work the same way on both.
283
+ Every lesson stays in the shared topic and must work the same way on both
284
+ hosts. Lessons without a practice project remain supported (the Lesson pane
285
+ fills the page), but the shared course does not use one.
227
286
 
228
287
  ## Server reads of installed snapshots
229
288
 
@@ -242,7 +301,21 @@ trusted caller pin, which binds topic metadata, release, repository and lesson o
242
301
  The reader freshly validates the declared inputs and complete ordered manifests,
243
302
  rejecting aliases, symlinks, missing, changed or unrecorded files.
244
303
  `readLesson({topicId,commit,topicHash,lessonCode,lessonHash})` requires the exact published
245
- lesson and returns its checked teaching text, anchored rubrics and visual metadata.
304
+ lesson. For a v1 lesson it returns its checked teaching text, anchored rubrics
305
+ and visual metadata. For a v2 lesson it returns the verified bundle (`pin`,
306
+ `lesson`, `manifest`, `hash`, `descriptorPath`), `steps` (each declared step plus
307
+ its `bodyText`), `notesText` when the lesson declares notes, and `visuals`; there
308
+ is no `document` or `rubrics`. Every lesson projection — `readTopic`,
309
+ `readLesson`, `readAdmissionIdentity` and exercise metadata — omits each choice
310
+ step's `answer`.
311
+
312
+ `readChoiceAnswer({topicId,commit,topicHash,lessonCode,lessonHash,stepId})` is the
313
+ server-only comparator accessor. It applies the same verification and draft rules
314
+ and returns `{pin,lessonCode,lessonHash,stepId,answer}` for one v2 choice step; it
315
+ refuses a v1 lesson, an unknown step or a step of another kind. Never return its
316
+ result to a browser or assistant. `compareChoiceAnswer(answer, selected)`, exported
317
+ by the same module, passes only when `selected` lists exactly the answer indexes
318
+ (any order, no duplicates).
246
319
 
247
320
  `readVisual({topicId,commit,topicHash,lessonCode,lessonHash,visualId})` reuses that
248
321
  same lesson verification and selects only its declared visual ID. It returns
@@ -472,13 +545,54 @@ topic metadata. Resume uses the stored pin, without selecting a newer release.
472
545
 
473
546
  The actor's nonempty `uid ?? username` uses the existing base64url key convention,
474
547
  without a local fallback. State lives outside projects under
475
- `training/users/<user-key>/`: `progress.json` is the schema-version-1 authority for
476
- revision and one active reservation; `active-lesson.json` is its derived summary.
548
+ `training/users/<user-key>/`: `progress.json` (schema version 2) is the authority
549
+ for revision, the one attempt in progress (`activeAttemptId`), the completed
550
+ lessons and the retained attempts; `active-lesson.json` is its derived summary.
477
551
  The reservation contains a server UUID, exact pin, creation time, retry IDs,
478
- server-derived project slug and `reserved` phase. No project/session readiness,
552
+ server-derived project slug `training-<attemptId hex>` (only for a lesson that
553
+ declares an exercise) and `reserved` phase. No project/session readiness,
479
554
  assessment outcome or grading evidence is fabricated. New directories use 0700,
480
- records 0600. Files are bounded to 64 KiB and the current pilot retains at most
481
- 64 distinct reservation request IDs; it never silently drops retry history.
555
+ records 0600. Files are bounded to 128 KiB and an attempt retains at most 64
556
+ distinct reservation request IDs; it never silently drops retry history.
557
+
558
+ One lesson is in progress at a time. Reserving the same pin again returns the
559
+ attempt in progress (adding the request ID); a different pin is refused with
560
+ 409 `VIBE64_TRAINING_LESSON_IN_PROGRESS` and `details:{attemptId,lessonCode,lessonTitle}`
561
+ before any revision check, so the caller can archive it first. A lesson in the
562
+ retired format 1 is refused (`VIBE64_TRAINING_LESSON_VERSION`). A learner keeps
563
+ at most 32 attempts: a new reservation drops the oldest ended attempts (with
564
+ their reader position) until the count and byte bounds fit, and is never
565
+ refused for space. `completedLessons` (at most 256 `{code,hash,completedAt}`)
566
+ records every finished lesson content and is never pruned, so the course list
567
+ keeps a lesson completed after its attempts are gone.
568
+
569
+ `endAttempt` takes reason `finished` (refused with
570
+ `VIBE64_TRAINING_LESSON_INCOMPLETE` unless every required step has passed; adds
571
+ the lesson to `completedLessons`), `archived` or `deleted`. After the end is
572
+ saved it removes that attempt's step results and code ledger. The archive or
573
+ deletion of its project and conversation is the lifecycle owner's job.
574
+ `activeAttemptForProject({actor,attemptId})` returns the attempt in progress
575
+ when it owns that practice project, or null.
576
+
577
+ Learn mode is a separate per-learner flag, `learning-mode.json`
578
+ `{schemaVersion:2,learnerId,on}` (absent means off). `setLearningMode({actor,on})`
579
+ saves it and never ends or changes the lesson in progress.
580
+ `readLearningMode({actor,includeTitle?})` returns
581
+ `{on,currentAttemptId,lessonCode,lessonTitle,practiceSlug}`: the current attempt
582
+ is the one in progress, `lessonTitle` is filled only with `includeTitle`, and
583
+ `practiceSlug` is empty until preparation begins.
584
+
585
+ Step results (`step-progress.json`, schema version 3) belong to the attempt in
586
+ progress: `{learnerId,revision,attemptId,lesson,results,receipts}`, at most 64
587
+ results. A result's `kind` is `auto`, `choice`, `self` or `read` (a `none`
588
+ step the learner marked done), matching the pinned step's check. A new attempt
589
+ starts with none. `readStepProgress({actor,attemptId?})`
590
+ and `readAttemptRecord({actor,attemptId})` read them.
591
+
592
+ The published `20261008-learning-practice-history` upgrade reads vibe64 0.1.35
593
+ version 1 progress through the frozen `practiceHistoryReader.js`
594
+ (`readState`, `readExerciseProjectScope`), moved unchanged from the earlier
595
+ learner state; the live store no longer reads that format.
482
596
 
483
597
  The same internal store adds `beginPreparation({actor,attemptId,expectedRevision})`,
484
598
  `recordPreparationReady({actor,attemptId,initialSessionId,expectedRevision})` and
@@ -554,9 +668,9 @@ Core's existing project record can now retain optional trusted creation metadata
554
668
  ```json
555
669
  {
556
670
  "training": {
557
- "schemaVersion": 1,
671
+ "schemaVersion": 2,
558
672
  "learnerKey": "NDI",
559
- "attemptId": "12345678-1234-4234-8234-123456789abc",
673
+ "practiceId": "12345678-1234-4234-8234-123456789abc",
560
674
  "pin": {
561
675
  "course": { "courseId": "intro-course", "release": "0.1.0" },
562
676
  "topic": {
@@ -576,7 +690,7 @@ Core's existing project record can now retain optional trusted creation metadata
576
690
 
577
691
  These are illustrative identities, not an installed course. An admitted server
578
692
  owner must supply the canonical base64url learner key from authenticated identity,
579
- the saved attempt's exact pin, and the fresh installed reader's bundled source
693
+ the practice project's ID, the saved attempt's exact pin, and the fresh installed reader's bundled source
580
694
  path. Core validates shape and bounded values; it does not authenticate this
581
695
  object or inspect installed content. The marker has no session field: learner
582
696
  state owns the initial session identity. It is copied at creation and cannot be
@@ -608,7 +722,7 @@ Project archives exclude `training/users`. Operators use the explicit
608
722
  [stopped-writer checkpoint and restore procedure](training-state-recovery.md),
609
723
  which preserves private bytes and validates candidates through the existing
610
724
  reservation and installed-content readers. Its fixture proof does not establish
611
- live fleet stopping, off-host retention or power-loss durability.
725
+ live multi-machine stopping, off-host retention or power-loss durability.
612
726
 
613
727
  ## Official catalogue installation
614
728
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/assistant-core",
3
- "version": "0.1.236",
3
+ "version": "0.1.238",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  "./client": "./src/client/index.js",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/assistant-runtime",
3
- "version": "0.1.230",
3
+ "version": "0.1.232",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  "./client": "./src/client/index.js",
@@ -52,8 +52,9 @@ and `assistantServer` in server config.
52
52
  semantic placements, an AI integration and its server resolver for an `admin` surface.
53
53
  Install `@jskit-ai/connectors-catalog` and `@jskit-ai/connectors-core` and register
54
54
  `ApplicationAiFeature` in the ordinary server feature list. Set its application ID
55
- and AI-use policy. The example explicitly selects the catalogue's no-key model;
56
- provider availability is independent of configuration. Adapt the complete files to the
55
+ and AI-use policy. The example selects Z.AI's GLM-4.7-Flash with a regular Z.AI key
56
+ in `APP_AI_API_KEY`; choose the application's own provider, model and key.
57
+ Provider availability is independent of configuration. Adapt the complete files to the
57
58
  application's existing config and placement registries.
58
59
 
59
60
  ## Variation points
@@ -7,10 +7,11 @@
7
7
  "accountMode": "shared",
8
8
  "scopes": [],
9
9
  "settings": {
10
- "model": "opencode/big-pickle"
10
+ "model": "zai/glm-4.7-flash"
11
11
  },
12
12
  "authentication": {
13
- "method": "none"
13
+ "method": "api-key",
14
+ "secretRef": "env:APP_AI_API_KEY"
14
15
  }
15
16
  }
16
17
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/assistant-voice",
3
- "version": "0.1.37",
3
+ "version": "0.1.39",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  "./client": "./src/client/index.js",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/connectors-catalog",
3
- "version": "0.1.61",
3
+ "version": "0.1.62",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  "./shared/ai": "./src/shared/ai.js",
@@ -2,7 +2,7 @@
2
2
  id: connectors/ai-connections
3
3
  title: App-owned AI connections and static model selection
4
4
  summary: Resolve an administrator environment key or an individual user's grant, then use the application's chosen AI SDK directly.
5
- keywords: ai, models, free, big-pickle, zen, zai, environment, api-key, ownership, cli
5
+ keywords: ai, models, free, zen, zai, environment, api-key, ownership, cli
6
6
  requires: @jskit-ai/connectors-core, @jskit-ai/connectors-catalog
7
7
  ---
8
8
 
@@ -12,8 +12,9 @@ requires: @jskit-ai/connectors-core, @jskit-ai/connectors-catalog
12
12
 
13
13
  Use the [AI guide](https://github.com/mobily-enterprises/jskit-ai/blob/main/packages/connectors-catalog/docs/ai.md) to choose the model, account owner and
14
14
  framework SDK before wiring requests. The shared catalogue is a deliberate
15
- static extraction, not an OpenCode runtime integration. The default Big Pickle
16
- route needs no account, user key or environment setup.
15
+ static extraction, not an OpenCode runtime integration. There is no default
16
+ model: choose the provider, model and key. Only an explicitly chosen model
17
+ labelled no account or key needs no account or environment setup.
17
18
 
18
19
  ## Framework APIs
19
20
 
@@ -5392,7 +5392,6 @@
5392
5392
  {"id":"text-embedding-ada-002","name":"text-embedding-ada-002","cost":{"input":0.1,"output":0},"limit":{"context":8192,"output":1536},"modalities":{"input":["text"],"output":["text"]},"sdkPackage":"@ai-sdk/openai","access":"paid"}
5393
5393
  ]},
5394
5394
  {"id": "opencode", "name": "OpenCode Zen", "documentationUrl": "https://opencode.ai/docs/zen", "baseURL": "https://opencode.ai/zen/v1", "environment": ["OPENCODE_API_KEY"], "sdkPackage": "@ai-sdk/openai-compatible", "models": [
5395
- {"id":"big-pickle","name":"Big Pickle","cost":{"input":0,"output":0,"cache_read":0,"cache_write":0},"limit":{"context":200000,"input":160000,"output":32000},"modalities":{"input":["text"],"output":["text"]},"sdkPackage":"@ai-sdk/openai-compatible","access":"free-no-setup"},
5396
5395
  {"id":"claude-3-5-haiku","name":"Claude Haiku 3.5","status":"deprecated","cost":{"input":0.8,"output":4,"cache_read":0.08,"cache_write":1},"limit":{"context":200000,"output":8192},"modalities":{"input":["text","image","pdf"],"output":["text"]},"sdkPackage":"@ai-sdk/anthropic","access":"paid"},
5397
5396
  {"id":"claude-fable-5","name":"Claude Fable 5","cost":{"input":10,"output":50,"cache_read":1,"cache_write":12.5},"limit":{"context":1000000,"output":128000},"modalities":{"input":["text","image","pdf"],"output":["text"]},"sdkPackage":"@ai-sdk/anthropic","access":"paid"},
5398
5397
  {"id":"claude-fable-5-1","name":"Claude Fable 5.1","cost":{"input":10,"output":50,"cache_read":0.25,"cache_write":12.5},"limit":{"context":1000000,"output":128000},"modalities":{"input":["text","image","pdf"],"output":["text"]},"sdkPackage":"@ai-sdk/anthropic","access":"paid"},
@@ -18,6 +18,7 @@
18
18
  "./server/assistantHelperUpgrade": "./src/server/assistantHelperUpgrade.js",
19
19
  "./server/completedDiscussionPlanUpgrade": "./src/server/completedDiscussionPlanUpgrade.js",
20
20
  "./server/providerCredentialsUpgrade": "./src/server/providerCredentialsUpgrade.js",
21
+ "./server/freeModelRetirementUpgrade": "./src/server/freeModelRetirementUpgrade.js",
21
22
  "./server/assistantPlanUpgrade": "./src/server/assistantPlanUpgrade.js"
22
23
  }
23
24
  }
@@ -7,6 +7,7 @@
7
7
  "./client": "./src/client/index.js",
8
8
  "./server": "./src/server/Vibe64ColleagueProvider.js",
9
9
  "./server/service": "./src/server/service.js",
10
- "./server/conversationUpgrade": "./src/server/conversationUpgrade.js"
10
+ "./server/conversationUpgrade": "./src/server/conversationUpgrade.js",
11
+ "./shared/learning-focus": "./src/shared/learningFocus.js"
11
12
  }
12
13
  }
@@ -19,6 +19,9 @@
19
19
  "./server/logging": "./src/server/logging.js",
20
20
  "./server/launchRestartRules": "./src/server/launchRestartRules.js",
21
21
  "./server/osUserIdentity": "./src/server/osUserIdentity.js",
22
+ "./server/learningSpace": "./src/server/learningSpace.js",
23
+ "./server/learningMode": "./src/server/learningMode.js",
24
+ "./server/learnThreads": "./src/server/learnThreads.js",
22
25
  "./server/personalAiProfile": "./src/server/personalAiProfile.js",
23
26
  "./server/projectServiceSelection": "./src/server/projectServiceSelection.js",
24
27
  "./server/serverResponses": "./src/server/serverResponses.js",
@@ -6,6 +6,7 @@
6
6
  "exports": {
7
7
  ".": "./src/server/index.js",
8
8
  "./server": "./src/server/index.js",
9
+ "./server/hostProfile": "./src/server/hostProfile.js",
9
10
  "./server/terminalSessions": "./src/server/engines/terminalSessions.js"
10
11
  }
11
12
  }