vibe64 0.1.34 → 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.
- package/bin/run.js +1919 -1660
- package/bin/server.js +158 -111
- package/bin/upgrade-state.js +5783 -5605
- package/dist/assets/GithubBrowserTabs-BzJF4k9Y.js +1 -0
- package/dist/assets/{StudioErrorNotice-sQfmeR-z.js → StudioErrorNotice-BdllGqRy.js} +1 -1
- package/dist/assets/{Vibe64AsyncModuleState-Dx7YKRPp.js → Vibe64AsyncModuleState-Bi0TqlIu.js} +1 -1
- package/dist/assets/Vibe64AuthSettingsButton-BuvmwGiT.js +5 -0
- package/dist/assets/Vibe64AuthSettingsButton-M44SSmZ9.css +1 -0
- package/dist/assets/{Vibe64DashboardBackButton-yE6cyYg2.js → Vibe64DashboardBackButton-Ccd4hpD6.js} +1 -1
- package/dist/assets/Vibe64DashboardShell-D67m4aWz.js +1 -0
- package/dist/assets/{Vibe64DashboardShell-MBkUHjs-.css → Vibe64DashboardShell-De2mbdpI.css} +1 -1
- package/dist/assets/{Vibe64DatabaseWorkspace-BONJdxBS.js → Vibe64DatabaseWorkspace-D3uK1gDm.js} +3 -3
- package/dist/assets/{Vibe64DatabaseWorkspace-CR4pzzcf.css → Vibe64DatabaseWorkspace-DPDMxhAW.css} +1 -1
- package/dist/assets/Vibe64OutputControls-BfESn5kJ.js +8 -0
- package/dist/assets/Vibe64OutputControls-D2CCECo5.css +1 -0
- package/dist/assets/{Vibe64RepositoryWorkspace-ByQlZbyO.js → Vibe64RepositoryWorkspace-0jAxvdA8.js} +2 -2
- package/dist/assets/{Vibe64RepositoryWorkspace-CVHcT93M.css → Vibe64RepositoryWorkspace-Agyt4O-V.css} +1 -1
- package/dist/assets/Vibe64SessionFiles-B3ONZrBL.css +1 -0
- package/dist/assets/Vibe64SessionFiles-BCOJ4QmR.js +41 -0
- package/dist/assets/{Vibe64TemporaryAiFixAction-BGlcrq4d.js → Vibe64TemporaryAiFixAction-DM2jpPbQ.js} +1 -1
- package/dist/assets/{Vibe64UiStoryboardView-Brlwdvqi.js → Vibe64UiStoryboardView-DP5af46a.js} +1 -1
- package/dist/assets/{Vibe64UnavailableSessions-zwlWlcZD.js → Vibe64UnavailableSessions-C7XwH1SS.js} +1 -1
- package/dist/assets/{_sessionId_-CvOkQbVy.js → _sessionId_-B1Ymr7c_.js} +1 -1
- package/dist/assets/{_sessionTool_-Dwod5ns9.js → _sessionTool_-DVYdREoI.js} +1 -1
- package/dist/assets/_slug_-CQseA9pt.css +1 -0
- package/dist/assets/_slug_-CYO2vjCd.js +24 -0
- package/dist/assets/{access-BVu5XYm2.js → access-Cb7dkN53.js} +1 -1
- package/dist/assets/app-BvgY7oVf.js +1 -0
- package/dist/assets/app-CZu7oxUO.css +1 -0
- package/dist/assets/{assistantRouting-CwbwfkwB.js → assistantRouting-B38ujQ7x.js} +1 -1
- package/dist/assets/{changes-olY8cnFK.js → changes-lsBcuikn.js} +1 -1
- package/dist/assets/client-CRI5CNKl.js +2 -0
- package/dist/assets/client-TGaWwOhc.css +1 -0
- package/dist/assets/conversation-CDEt9jBx.js +17 -0
- package/dist/assets/conversation-vxJGwmtW.css +1 -0
- package/dist/assets/{dashboard-BnXD-H4R.js → dashboard-D8HOAw46.js} +1 -1
- package/dist/assets/definitions-DLTX17nI.js +1 -0
- package/dist/assets/{env-DJhnLOH7.css → env-BzRtyO0w.css} +1 -1
- package/dist/assets/env-DJezQixO.js +1 -0
- package/dist/assets/health-BJvooRnJ.css +1 -0
- package/dist/assets/health-CtKdN_Nf.js +1 -0
- package/dist/assets/{history-BxlpB-YH.js → history-BdZFOtz4.js} +1 -1
- package/dist/assets/{incoming-BOxRVlOM.js → incoming-VsQNnL9m.js} +1 -1
- package/dist/assets/index-C-osVUKw.css +1 -0
- package/dist/assets/index-C4K3ntms.js +138 -0
- package/dist/assets/{integrations-BFltGDVI.js → integrations-CMQ9EDmt.js} +2 -2
- package/dist/assets/issues-DHpY5hSr.js +1 -0
- package/dist/assets/learning-DXlMuwzh.js +1 -0
- package/dist/assets/mdi-yXT-CQ6u.js +1 -0
- package/dist/assets/placement-NpX2s7u8.js +1 -0
- package/dist/assets/pull-requests-BcKNEUYH.js +1 -0
- package/dist/assets/{repository-JWLVST3D.js → repository-ClEgntHW.js} +1 -1
- package/dist/assets/roboto-latin-wght-normal-ccAYIvAh.woff2 +0 -0
- package/dist/assets/{session-C5Nj8Dlq.js → session-BlD46q-d.js} +1 -1
- package/dist/assets/settings-BwukeIKe.js +1 -0
- package/dist/assets/shared-BM2SV6fi.js +2 -0
- package/dist/assets/studioGateApi-DcCqiD9V.js +1 -0
- package/dist/assets/studioUrls-DmMMIScP.js +1 -0
- package/dist/assets/useArchivedVibe64Sessions-D5zUA-BC.js +1 -0
- package/dist/assets/useCommand-Bqxb-naz.js +1 -0
- package/dist/assets/useEndpointResource-DWoQ2keu.js +1 -0
- package/dist/assets/useRealtimeEvent-Bwapstla.js +1 -0
- package/dist/assets/{useUiFeedback-0FqKuZRP.js → useUiFeedback-BPBF_0bp.js} +1 -1
- package/dist/assets/useVibe64ConversationLog-Dy6YTPQn.js +1 -0
- package/dist/assets/useVibe64DatabaseTools-d6L09ugW.js +1 -0
- package/dist/assets/useVibe64Learning-cNKTv64W.js +1 -0
- package/dist/assets/useVibe64ProjectScope-Bp1ImZlz.js +1 -0
- package/dist/assets/useVibe64SessionData-C_jqncih.js +1 -0
- package/dist/assets/useVibe64SessionSelection-uCEIWd3b.js +1 -0
- package/dist/assets/useVibe64SystemGraph-B4RmsC9Y.js +1 -0
- package/dist/assets/{useVibe64Terminal-BPnN25WH.js → useVibe64Terminal-BbghGR4x.js} +1 -1
- package/dist/assets/vibe64AssistantHost-BL1bnKm8.js +1 -0
- package/dist/assets/{vibe64SessionFocus-kqPOPaOH.js → vibe64SessionFocus-DSJKVuRN.js} +1 -1
- package/dist/assets/{vibe64SessionInfo-BHxtTrLX.js → vibe64SessionInfo-B_r1OMN0.js} +1 -1
- package/dist/assets/{vibe64SessionPanelModel-BMf64fv7.js → vibe64SessionPanelModel-DDorOuiL.js} +1 -1
- package/dist/assets/{vibe64SessionToolDefinitions-NfLd1HZI.js → vibe64SessionToolDefinitions-BualCK_5.js} +1 -1
- package/dist/index.html +21 -20
- package/docs/colleague-usage/account-profile-and-appearance.md +8 -2
- package/docs/colleague-usage/ai-accounts-and-routing.md +123 -15
- package/docs/colleague-usage/ai-onboarding.md +230 -0
- package/docs/colleague-usage/coding-agent-goal-pause.md +5 -5
- package/docs/colleague-usage/coding-agents.md +17 -0
- package/docs/colleague-usage/colleague-watches.md +4 -23
- package/docs/colleague-usage/colleague.md +10 -2
- package/docs/colleague-usage/connected-projects.md +2 -2
- package/docs/colleague-usage/conversation-context.md +2 -0
- package/docs/colleague-usage/dashboard-navigation.md +19 -27
- package/docs/colleague-usage/database.md +6 -11
- package/docs/colleague-usage/development-copies.md +2 -1
- package/docs/colleague-usage/development-env.md +6 -0
- package/docs/colleague-usage/github-work.md +9 -0
- package/docs/colleague-usage/health-checks.md +11 -5
- package/docs/colleague-usage/integrations.md +3 -1
- package/docs/colleague-usage/learning-code-questions.md +23 -51
- package/docs/colleague-usage/learning-course-catalogue.md +8 -6
- package/docs/colleague-usage/learning-environment.md +345 -0
- package/docs/colleague-usage/learning-history.md +70 -101
- package/docs/colleague-usage/learning-mode-ui.md +122 -214
- package/docs/colleague-usage/learning-practice-projects.md +168 -78
- package/docs/colleague-usage/learning-teacher-guide.md +48 -26
- package/docs/colleague-usage/learning-with-colleague.md +171 -216
- package/docs/colleague-usage/lesson-authoring.md +32 -24
- package/docs/colleague-usage/managed-app-access.md +7 -0
- package/docs/colleague-usage/message-delivery-recovery.md +7 -6
- package/docs/colleague-usage/preview-browser-checks.md +9 -1
- package/docs/colleague-usage/preview-starting-application.md +0 -1
- package/docs/colleague-usage/preview.md +9 -1
- package/docs/colleague-usage/project-messages.md +2 -2
- package/docs/colleague-usage/project-setup.md +9 -2
- package/docs/colleague-usage/running-vibe64-on-your-computer.md +61 -0
- package/docs/colleague-usage/sessions.md +25 -33
- package/docs/colleague-usage/teaching-content.md +11 -40
- package/docs/colleague-usage/temporary-chats.md +23 -2
- package/docs/colleague-usage/voice-chat.md +5 -10
- package/docs/colleague-usage/voice-face-and-speaking-voice.md +6 -8
- package/docs/colleague-usage/voice-recovery.md +3 -2
- package/docs/templates/learn-topic/README.md +6 -6
- package/docs/templates/learn-topic/training/lessons/TOPIC-01/lesson.json +28 -7
- package/docs/templates/learn-topic/training/lessons/TOPIC-01/notes.md +19 -0
- package/docs/templates/learn-topic/training/lessons/TOPIC-01/steps/check-understanding.md +3 -0
- package/docs/templates/learn-topic/training/lessons/TOPIC-01/steps/explain-idea.md +3 -0
- package/docs/templates/learn-topic/training/lessons/TOPIC-01/steps/try-it.md +3 -0
- package/docs/templates/learn-topic/training/outline.md +1 -1
- package/docs/training-content.md +179 -65
- package/node_modules/@jskit-ai/assistant-core/package.json +1 -1
- package/node_modules/@jskit-ai/assistant-runtime/package.json +1 -1
- package/node_modules/@jskit-ai/assistant-runtime/patterns/assistant-surface/PATTERN.md +3 -2
- package/node_modules/@jskit-ai/assistant-runtime/patterns/assistant-surface/example/integrations.json +3 -2
- package/node_modules/@jskit-ai/assistant-voice/package.json +1 -1
- package/node_modules/@jskit-ai/connectors-catalog/package.json +1 -1
- package/node_modules/@jskit-ai/connectors-catalog/patterns/ai-connections/PATTERN.md +4 -3
- package/node_modules/@jskit-ai/connectors-catalog/src/shared/ai-models.json +0 -1
- package/node_modules/@local/vibe64-accounts/package.json +1 -0
- package/node_modules/@local/vibe64-colleague/package.json +2 -1
- package/node_modules/@local/vibe64-core/package.json +3 -0
- package/node_modules/@local/vibe64-execution/package.json +1 -0
- package/node_modules/@local/vibe64-execution/src/server/engines/stdioBridge.js +9 -9
- package/node_modules/@local/vibe64-genesis/README.md +10 -37
- package/node_modules/@local/vibe64-genesis/bin/vibe64-genesis-host-context +790 -779
- package/node_modules/@local/vibe64-genesis/package.json +1 -0
- package/node_modules/@local/vibe64-genesis/src/server/agentSpecs.js +255 -0
- package/node_modules/@local/vibe64-genesis/src/server/index.js +473 -450
- package/node_modules/@local/vibe64-genesis/src/server/promptContext.js +148 -148
- package/node_modules/@local/vibe64-project/package.json +2 -1
- package/node_modules/@local/vibe64-runtime/package.json +1 -2
- package/node_modules/@local/vibe64-runtime/src/server/codexAppServerProcess.js +526 -512
- package/node_modules/@local/vibe64-runtime/src/shared/assistantRoutingScores.json +0 -1
- package/node_modules/@local/vibe64-source-editor/package.json +1 -0
- package/node_modules/@local/vibe64-terminals/package.json +1 -0
- package/node_modules/@local/vibe64-terminals/src/server/opencodeSessionEnvironmentPlugin.js +129 -131
- package/node_modules/@local/vibe64-terminals/src/server/sessionWorkOperationCommand.js +1508 -1456
- package/node_modules/@local/vibe64-training/package.json +13 -27
- package/package.json +7 -7
- package/server.bundle.mjs +40946 -41456
- package/dist/assets/GithubBrowserTabs-DO5PHon-.js +0 -1
- package/dist/assets/GithubMarkdown-BQ6MfCDJ.js +0 -3
- package/dist/assets/GithubMarkdown-U7-j-qNI.css +0 -1
- package/dist/assets/Vibe64DashboardShell-CuCVMhOc.js +0 -1
- package/dist/assets/Vibe64OutputControls-DAAmA09l.js +0 -8
- package/dist/assets/Vibe64OutputControls-DPBsyDZM.css +0 -1
- package/dist/assets/Vibe64SessionFiles-B0u9HKdF.js +0 -107
- package/dist/assets/Vibe64SessionFiles-NjOMVwPR.css +0 -1
- package/dist/assets/_slug_-B31c15cc.css +0 -1
- package/dist/assets/_slug_-Dy35qLo1.js +0 -1
- package/dist/assets/app-DRXCcv05.css +0 -1
- package/dist/assets/app-zt7HwQKT.js +0 -1
- package/dist/assets/client-BrV4QPwG.js +0 -2
- package/dist/assets/client-C1bwIlu6.css +0 -1
- package/dist/assets/definitions-DaOPIkyB.js +0 -1
- package/dist/assets/env-DN0vW4EI.js +0 -1
- package/dist/assets/health-7oIQODer.css +0 -1
- package/dist/assets/health-Z6m96GDr.js +0 -1
- package/dist/assets/index-BUq-MczL.js +0 -86
- package/dist/assets/index-DtmBqE3h.css +0 -1
- package/dist/assets/issues-1iS5zoed.js +0 -1
- package/dist/assets/layout-BkWVNT37.js +0 -1
- package/dist/assets/mdi-C54lQ0i_.js +0 -1
- package/dist/assets/placement-DLsU3pCW.js +0 -1
- package/dist/assets/pull-requests-BJOwNL4k.js +0 -1
- package/dist/assets/settings-c273Ikrm.js +0 -1
- package/dist/assets/shared-YZb7ocaK.js +0 -2
- package/dist/assets/studioGateApi-DhA9IJGZ.js +0 -1
- package/dist/assets/studioUrls-Dj8rXeXO.js +0 -1
- package/dist/assets/useArchivedVibe64Sessions-CVZx2Rtm.js +0 -1
- package/dist/assets/useCommand-DWuxfAV0.js +0 -1
- package/dist/assets/useEndpointResource-MWVNfmMa.js +0 -1
- package/dist/assets/useVibe64ConversationLog-8cKh1eDm.js +0 -1
- package/dist/assets/useVibe64DatabaseTools-BcRG1s3i.js +0 -1
- package/dist/assets/useVibe64LearningMode-Bl0dGdCh.js +0 -28
- package/dist/assets/useVibe64LearningMode-C3PcXdVg.css +0 -1
- package/dist/assets/useVibe64ProjectScope-DOEVkBqX.js +0 -1
- package/dist/assets/useVibe64SessionData-DFTyLzci.js +0 -1
- package/dist/assets/useVibe64SessionSelection-j9lsllx4.js +0 -1
- package/dist/assets/useVibe64SystemGraph-tNkIwSBQ.js +0 -1
- package/dist/assets/vibe64AssistantHost-DdE_-lZF.js +0 -1
- package/dist/assets/vibe64LessonDashboard-DlKYjisq.js +0 -1
- package/dist/assets/vibe64ProjectScope.local-DqT6e5un.js +0 -1
- package/docs/colleague-usage/learning-chat-retention.md +0 -74
- package/docs/colleague-usage/learning-diagrams-and-voice.md +0 -97
- package/docs/colleague-usage/learning-lesson-watch.md +0 -95
- package/docs/colleague-usage/learning-native-session.md +0 -206
- package/docs/colleague-usage/learning-practical-exercises.md +0 -71
- package/docs/colleague-usage/learning-practical-gestures.md +0 -48
- package/docs/colleague-usage/learning-session-creation.md +0 -95
- package/docs/colleague-usage/lesson-practical-assessment.md +0 -54
- package/docs/colleague-usage/preview-lesson-presentation.md +0 -56
- 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
|
|
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
|
|
16
|
-
4. Write the outline's learner, prerequisites, final ability and lesson outcomes. Replace
|
|
17
|
-
5. To add lessons, copy the lesson directory to a new permanent code, update its code
|
|
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
|
|
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":
|
|
2
|
+
"schemaVersion": 2,
|
|
3
3
|
"code": "TOPIC-01",
|
|
4
4
|
"title": "Replace with the learner task",
|
|
5
|
-
"
|
|
5
|
+
"notes": "notes.md",
|
|
6
6
|
"prerequisites": [],
|
|
7
7
|
"estimatedMinutes": 15,
|
|
8
8
|
"visuals": [],
|
|
9
|
-
"
|
|
9
|
+
"steps": [
|
|
10
10
|
{
|
|
11
|
-
"id": "explain-
|
|
12
|
-
"
|
|
13
|
-
"
|
|
14
|
-
"
|
|
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 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
|
|
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
|
|
package/docs/training-content.md
CHANGED
|
@@ -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
|
-
|
|
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
|
-
|
|
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
|
|
69
|
-
|
|
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
|
|
74
|
-
|
|
75
|
-
|
|
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
|
-
"
|
|
83
|
-
"
|
|
84
|
-
"
|
|
85
|
-
|
|
86
|
-
|
|
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.
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
-
|
|
100
|
-
|
|
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
|
|
125
|
-
each declared file in the live practice project as
|
|
126
|
-
point. Each save from the
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
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
|
|
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
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
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
|
-
|
|
223
|
-
|
|
224
|
-
|
|
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
|
|
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
|
|
476
|
-
revision
|
|
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
|
|
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
|
|
481
|
-
|
|
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":
|
|
671
|
+
"schemaVersion": 2,
|
|
558
672
|
"learnerKey": "NDI",
|
|
559
|
-
"
|
|
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
|
|
725
|
+
live multi-machine stopping, off-host retention or power-loss durability.
|
|
612
726
|
|
|
613
727
|
## Official catalogue installation
|
|
614
728
|
|
|
@@ -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
|
|
56
|
-
|
|
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
|
|
@@ -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,
|
|
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.
|
|
16
|
-
|
|
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",
|