@novedu/cli 0.20.0 → 0.21.0

package/dist/main.js

@@ -2591,6 +2591,10 @@ async function loadQuizFrom(url, fetcher, opts = {}) {
 		};
 	}
 }
+const tutorToolNameSchema = z.enum(["random_number"]).meta({
+	id: "tutorToolName",
+	description: "Name of a built-in tutor tool."
+});
 //#endregion
 //#region ../lib/tutors/schemas.ts
 /**
@@ -2626,6 +2630,7 @@ const TutorSchema = z.strictObject({
 		id: "llm",
 		description: "The model and provider that back this tutor."
 	}),
+	tools: z.array(tutorToolNameSchema).default([]).meta({ description: "Optional built-in tools the tutor's model may call (e.g. random_number). Off by default; mention enabled tools in tutor_instructions so the model uses them." }),
 	prompt: z.strictObject({
 		fragment_files: z.array(FragmentFileRefSchema).default([]).meta({ description: "Optional fragment libraries used by this tutor." }),
 		text_files: z.array(TextFileRefSchema).default([]).meta({ description: "Optional plain-text files (markdown / source) embedded verbatim via {{file \"alias\"}} markers." }),
@@ -2666,6 +2671,7 @@ async function loadAndBuildTutorPrompt(url, fetchImpl, opts = {}) {
 		model: tutor.llm.model,
 		provider: tutor.llm.provider,
 		imageInput: tutor.llm.imageInput ?? true,
+		tools: tutor.tools,
 		anonymous: tutor.anonymous ?? true,
 		title: tutor.title,
 		description: tutor.description,
@@ -2837,7 +2843,8 @@ const promptDumpers = {
 					provider: result.provider,
 					model: result.model
 				},
-				system: result.prompt
+				system: result.prompt,
+				tools: result.tools
 			}
 		};
 	} },
@@ -3637,6 +3644,7 @@ function formatResult(result, source) {
 		lines.push(`  model: ${result.model}`);
 		lines.push(`  system prompt: ${result.prompt.length} chars`);
 		lines.push(`  imageInput: ${result.imageInput}   anonymous: ${result.anonymous}` + (result.exampleQuestions.length ? `   exampleQuestions: ${result.exampleQuestions.length}` : ""));
+		if (result.tools.length) lines.push(`  tools: ${result.tools.join(", ")}`);
 		if (result.warnings.length) {
 			lines.push("");
 			lines.push(yellow(`${result.warnings.length} warning(s):`));
@@ -3889,6 +3897,7 @@ function formatPromptDump(dump, sections, source) {
 	const lines = [green(`✔ Prompts — ${dump.kind}`) + dim(` — ${source}`)];
 	lines.push(`  id: ${dump.id}`);
 	lines.push(`  provider: ${dump.llm.provider}   model: ${dump.llm.model}`);
+	if (dump.kind === "tutor" && dump.tools.length > 0) lines.push(`  tools: ${dump.tools.join(", ")}`);
 	lines.push(`  prompts: ${sections.length}`);
 	for (const section of sections) lines.push(`    ${section.name}: ${section.text.length} chars`);
 	lines.push("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@novedu/cli",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Command-line companion for the Novedu chat app. Validates tutor, fragment, quiz, writing, coding and eval YAML definitions, dumps the exact LLM prompts an activity produces, and evaluates a quiz's grading rubric against golden answers; signs in with Entra ID and manages codes, app-hosted files and images over the app's API.",
   "type": "module",
   "repository": {