@tutorflow/cli 0.3.1 → 0.4.0

package/dist/commands/course.js

@@ -1,104 +1,33 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.courseCommand = courseCommand;
 const commander_1 = require("commander");
-const prompts_1 = require("@clack/prompts");
-const open_1 = __importDefault(require("open"));
-const client_1 = require("../client");
-const output_1 = require("../utils/output");
-const runtime_1 = require("../utils/runtime");
+const args_1 = require("../utils/args");
+const resource_1 = require("../content/resource");
+const COURSES = { path: 'courses', noun: 'course' };
 function courseCommand() {
-    const course = new commander_1.Command('course').description('Manage courses');
-    course
-        .command('create')
-        .argument('[prompt]', 'Prompt describing the course content')
-        .option('-l, --lessons <number>', 'Number of lessons', '8')
-        .option('-lang, --language <lang>', 'Language code', 'en')
-        .option('--open', 'Open the result in a browser when done (TTY only)')
-        .action((0, runtime_1.command)(async (prompt, options) => {
-        let coursePrompt = prompt;
-        if (!coursePrompt) {
-            (0, runtime_1.requireInteractive)('Pass a prompt argument: tutorflow course create "Beginner Python"');
-            const result = await (0, prompts_1.text)({ message: 'Describe the course content:' });
-            if (typeof result === 'symbol') {
-                throw new runtime_1.CliError('Cancelled', { code: 'ECANCELLED', exitCode: 130 });
-            }
-            coursePrompt = result;
-        }
-        const client = await client_1.ApiClient.createAuthenticated();
-        const s = (0, runtime_1.isJsonMode)() || !(0, runtime_1.isInteractive)() ? null : (0, prompts_1.spinner)();
-        s?.start('Creating course...');
-        let response;
-        try {
-            response = await client.request('POST', '/v1/platform/courses', {
-                prompt: coursePrompt,
-                lessonCount: parseInt(options.lessons, 10),
-                language: options.language,
-                mode: 'sync',
-            });
-        }
-        finally {
-            s?.stop('Done');
-        }
-        (0, output_1.printResult)(response);
-        if (options.open && response.previewUrl && (0, runtime_1.isInteractive)()) {
-            const shouldOpen = await (0, prompts_1.confirm)({ message: 'Open in browser?' });
-            if (shouldOpen === true)
-                await (0, open_1.default)(response.previewUrl);
-        }
-    }));
-    course
-        .command('list')
-        .option('-l, --limit <number>', 'Number of results', '10')
-        .option('-o, --offset <number>', 'Number of rows to skip', '0')
-        .option('-s, --status <status>', 'Filter by status')
-        .action((0, runtime_1.command)(async (options) => {
-        const client = await client_1.ApiClient.createAuthenticated();
-        const qs = new URLSearchParams({ limit: options.limit, offset: options.offset });
-        if (options.status)
-            qs.set('status', options.status);
-        const response = await client.request('GET', `/v1/platform/courses?${qs.toString()}`);
-        const courses = Array.isArray(response) ? response : response.items ?? response.data ?? [];
-        if ((0, runtime_1.isJsonMode)()) {
-            (0, output_1.printResult)(courses);
-        }
-        else {
-            (0, output_1.printResult)(courses.map((c) => ({
-                ID: c.id,
-                Title: c.title || 'Untitled',
-                Status: c.status,
-                Created: new Date(c.createdAt).toLocaleDateString(),
-            })));
-        }
-    }));
-    course
-        .command('get <id>')
-        .description('Fetch a single course by ID')
-        .action((0, runtime_1.command)(async (id) => {
-        const client = await client_1.ApiClient.createAuthenticated();
-        const response = await client.request('GET', `/v1/platform/courses/${id}`);
-        (0, output_1.printResult)(response);
-    }));
-    course
-        .command('open <id>')
-        .description('Open a course in the browser')
-        .action((0, runtime_1.command)(async (id) => {
-        const client = await client_1.ApiClient.createAuthenticated();
-        const response = await client.request('GET', `/v1/platform/courses/${id}`);
-        if (!response.previewUrl) {
-            throw new runtime_1.CliError('No preview URL available for this course', {
-                code: 'ENOPREVIEW',
-                exitCode: 1,
-            });
-        }
-        if ((0, runtime_1.isInteractive)())
-            await (0, open_1.default)(response.previewUrl);
-        (0, output_1.printResult)({ previewUrl: response.previewUrl });
-        (0, output_1.printStatus)('Opening in browser...', 'success');
-    }));
+    const course = new commander_1.Command('course').description('Generate and manage classroom courses');
+    (0, resource_1.addGenerateCommand)(course, {
+        ...COURSES,
+        description: 'Generate a course with every lesson (3 credits for the outline + 3 per lesson)',
+        promptLabel: 'Describe the course',
+        example: 'tutorflow course generate "Beginner Python" --lessons 5 --wait',
+        configure: (cmd) => cmd
+            .option('-n, --lessons <number>', 'Number of lessons')
+            .option('-l, --language <lang>', 'Language code', 'en')
+            .option('--level <level>', 'Learner level, e.g. beginner')
+            .option('--title <title>', 'Course title (generated when omitted)')
+            .option('--description <text>', 'Course description'),
+        buildBody: (prompt, options) => ({
+            prompt,
+            lessonCount: (0, args_1.parsePositiveInt)(options.lessons, '--lessons'),
+            language: options.language,
+            level: options.level,
+            title: options.title,
+            description: options.description,
+        }),
+    });
+    (0, resource_1.addCrudCommands)(course, COURSES);
     return course;
 }
 //# sourceMappingURL=course.js.map

package/dist/commands/course.js.map

@@ -1 +1 @@
-{"version":3,"file":"course.js","sourceRoot":"","sources":["../../src/commands/course.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"course.js","sourceRoot":"","sources":["../../src/commands/course.ts"],"names":[],"mappings":";;AAcA,sCA0BC;AAxCD,yCAAoC;AACpC,wCAAiD;AACjD,kDAA6F;AAU7F,MAAM,OAAO,GAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAElE,SAAgB,aAAa;IAC3B,MAAM,MAAM,GAAG,IAAI,mBAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,uCAAuC,CAAC,CAAC;IAE1F,IAAA,6BAAkB,EAAwB,MAAM,EAAE;QAChD,GAAG,OAAO;QACV,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE,gEAAgE;QACzE,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CACjB,GAAG;aACA,MAAM,CAAC,wBAAwB,EAAE,mBAAmB,CAAC;aACrD,MAAM,CAAC,uBAAuB,EAAE,eAAe,EAAE,IAAI,CAAC;aACtD,MAAM,CAAC,iBAAiB,EAAE,8BAA8B,CAAC;aACzD,MAAM,CAAC,iBAAiB,EAAE,uCAAuC,CAAC;aAClE,MAAM,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;QACzD,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YAC/B,MAAM;YACN,WAAW,EAAE,IAAA,uBAAgB,EAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC;YAC3D,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;KACH,CAAC,CAAC;IACH,IAAA,0BAAe,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/credits.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function creditsCommand(): Command;
+//# sourceMappingURL=credits.d.ts.map

package/dist/commands/credits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.d.ts","sourceRoot":"","sources":["../../src/commands/credits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,cAAc,IAAI,OAAO,CAqCxC"}

package/dist/commands/credits.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.creditsCommand = creditsCommand;
+const commander_1 = require("commander");
+const output_1 = require("../utils/output");
+const runtime_1 = require("../utils/runtime");
+const args_1 = require("../utils/args");
+const context_1 = require("../content/context");
+function creditsCommand() {
+    const credits = new commander_1.Command('credits').description('AI Credit balance and history (one ledger per organization)');
+    credits
+        .command('balance')
+        .description('Show the AI Credit balance this key spends from')
+        .action((0, runtime_1.command)(async () => {
+        const client = await (0, context_1.createContentClient)();
+        (0, output_1.printResult)(await client.request('GET', '/v1/content/credits'));
+    }));
+    credits
+        .command('history')
+        .description('List AI Credit charges, refunds and adjustments, newest first')
+        .option('-l, --limit <number>', 'Rows per page (max 100)', '20')
+        .option('--cursor <cursor>', 'meta.nextCursor from the previous page')
+        .option('--from <iso>', 'Only rows at or after this ISO 8601 time')
+        .option('--to <iso>', 'Only rows before this ISO 8601 time')
+        .option('--type <type>', 'Credit history type')
+        .action((0, runtime_1.command)(async (options) => {
+        const limit = (0, args_1.parsePositiveInt)(options.limit, '--limit');
+        const client = await (0, context_1.createContentClient)();
+        const qs = new URLSearchParams({ limit: String(limit) });
+        for (const key of ['cursor', 'from', 'to', 'type']) {
+            const value = options[key];
+            if (value)
+                qs.set(key, value);
+        }
+        (0, output_1.printResult)(await client.request('GET', `/v1/content/credits/history?${qs}`));
+    }));
+    return credits;
+}
+//# sourceMappingURL=credits.js.map

package/dist/commands/credits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.js","sourceRoot":"","sources":["../../src/commands/credits.ts"],"names":[],"mappings":";;AAMA,wCAqCC;AA3CD,yCAAoC;AACpC,4CAA8C;AAC9C,8CAA2C;AAC3C,wCAAiD;AACjD,gDAAyD;AAEzD,SAAgB,cAAc;IAC5B,MAAM,OAAO,GAAG,IAAI,mBAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,6DAA6D,CAAC,CAAC;IAElH,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,iDAAiD,CAAC;SAC9D,MAAM,CACL,IAAA,iBAAO,EAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAmB,GAAE,CAAC;QAC3C,IAAA,oBAAW,EAAC,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CACH,CAAC;IAEJ,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,+DAA+D,CAAC;SAC5E,MAAM,CAAC,sBAAsB,EAAE,yBAAyB,EAAE,IAAI,CAAC;SAC/D,MAAM,CAAC,mBAAmB,EAAE,wCAAwC,CAAC;SACrE,MAAM,CAAC,cAAc,EAAE,0CAA0C,CAAC;SAClE,MAAM,CAAC,YAAY,EAAE,qCAAqC,CAAC;SAC3D,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC;SAC9C,MAAM,CACL,IAAA,iBAAO,EACL,KAAK,EAAE,OAAsF,EAAE,EAAE;QAC/F,MAAM,KAAK,GAAG,IAAA,uBAAgB,EAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAmB,GAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzD,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAU,EAAE,CAAC;YAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,KAAK;gBAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,IAAA,oBAAW,EAAC,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,+BAA+B,EAAE,EAAE,CAAC,CAAC,CAAC;IAChF,CAAC,CACF,CACF,CAAC;IAEJ,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/commands/evaluate.d.ts

@@ -1,3 +1,6 @@
 import { Command } from 'commander';
+/** `tutorflow evaluate`: grade one answer synchronously (1 credit). */
 export declare function evaluateCommand(): Command;
+/** `tutorflow evaluation …`: past evaluations and the learner model. */
+export declare function evaluationCommand(): Command;
 //# sourceMappingURL=evaluate.d.ts.map

package/dist/commands/evaluate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/commands/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BpC,wBAAgB,eAAe,IAAI,OAAO,CAiEzC"}
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/commands/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsCpC,uEAAuE;AACvE,wBAAgB,eAAe,IAAI,OAAO,CA+BzC;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,IAAI,OAAO,CAkE3C"}

package/dist/commands/evaluate.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.evaluateCommand = evaluateCommand;
+exports.evaluationCommand = evaluationCommand;
 const commander_1 = require("commander");
 const prompts_1 = require("@clack/prompts");
-const client_1 = require("../client");
 const output_1 = require("../utils/output");
 const runtime_1 = require("../utils/runtime");
+const args_1 = require("../utils/args");
+const context_1 = require("../content/context");
 const VALID_TYPES = ['exact', 'rubric_short_answer', 'open_ended'];
 const TYPE_ALIASES = {
     exact: 'exact',
@@ -14,56 +16,112 @@ const TYPE_ALIASES = {
     'open-ended': 'open_ended',
     open_ended: 'open_ended',
 };
+/** `tutorflow evaluate`: grade one answer synchronously (1 credit). */
 function evaluateCommand() {
     return new commander_1.Command('evaluate')
-        .description('Evaluate student responses')
+        .description('Grade a learner answer (1 credit); concept tags feed the learner model')
         .option('-t, --type <type>', 'Evaluation type (exact | rubric_short_answer | open_ended). Aliases: rubric, open-ended')
         .option('-q, --question <text>', 'The question being evaluated')
-        .option('-a, --student-answer <text>', "Student's answer")
+        .option('-a, --student-answer <text>', "Learner's answer")
         .option('-e, --expected-answer <text>', 'Reference answer (required for exact)')
         .option('--rubric-json <json>', 'Rubric JSON for rubric_short_answer evaluations')
         .option('--max-score <number>', 'Maximum score for the evaluation')
         .option('-l, --language <lang>', 'Feedback language', 'en')
+        .option('--learner-id <id>', 'Your id for the learner; feeds `evaluation mastery <id>`')
+        .option('--concept-tags <list>', 'Comma-separated concepts this question measures')
+        .option('--subject <subject>', 'Subject of the question')
         .option('--idempotency-key <key>', 'Idempotency key for safe retries')
         .action((0, runtime_1.command)(async (options) => {
-        let evalType = normalizeType(options.type);
-        if (!evalType) {
-            (0, runtime_1.requireInteractive)(`Pass --type ${VALID_TYPES.join('|')}`);
-            const result = await (0, prompts_1.select)({
-                message: 'Select evaluation type:',
-                options: [
-                    { value: 'exact', label: 'Exact Match' },
-                    { value: 'rubric_short_answer', label: 'Rubric-based' },
-                    { value: 'open_ended', label: 'Open-ended AI Evaluation' },
-                ],
-            });
-            if (typeof result === 'symbol') {
-                throw new runtime_1.CliError('Cancelled', { code: 'ECANCELLED', exitCode: 130 });
-            }
-            evalType = result;
-        }
-        const question = options.question ?? (await promptOrThrow('Enter the question:', '--question'));
-        const studentAnswer = options.studentAnswer ??
-            (await promptOrThrow('Enter the student answer:', '--student-answer'));
-        let expectedAnswer = options.expectedAnswer;
-        if (evalType === 'exact' && !expectedAnswer) {
-            expectedAnswer = await promptOrThrow('Enter the expected answer:', '--expected-answer');
-        }
-        const rubric = parseRubric(evalType, options.rubricJson);
-        const client = await client_1.ApiClient.createAuthenticated();
-        const response = await client.request('POST', '/v1/platform/evaluations', {
-            evaluationType: evalType,
-            questionText: question,
-            learnerAnswer: studentAnswer,
-            referenceAnswer: expectedAnswer,
-            rubric,
-            maxScore: parseOptionalInteger(options.maxScore, '--max-score'),
-            language: options.language,
-            mode: 'sync',
-        }, options.idempotencyKey ? { 'Idempotency-Key': options.idempotencyKey } : undefined);
-        (0, output_1.printResult)(response);
+        const body = await buildEvaluationBody(options);
+        const ctx = await (0, context_1.resolveContentContext)();
+        (0, output_1.printResult)(await ctx.client.request('POST', (0, context_1.classroomPath)(ctx, '/evaluations'), body, (0, args_1.idempotencyHeaders)(options.idempotencyKey)));
     }));
 }
+/** `tutorflow evaluation …`: past evaluations and the learner model. */
+function evaluationCommand() {
+    const evaluation = new commander_1.Command('evaluation').description('Read past evaluations and the learner model built from them');
+    evaluation
+        .command('list')
+        .description('List evaluations of the classroom, newest first')
+        .option('-l, --limit <number>', 'Items per page', '20')
+        .option('--cursor <cursor>', 'meta.nextCursor from the previous page')
+        .option('--learner-id <id>', 'Only this learner (the id evaluations were sent with)')
+        .option('--status <status>', 'Filter by status, e.g. COMPLETED')
+        .option('--type <type>', 'Filter by evaluation type')
+        .action((0, runtime_1.command)(async (options) => {
+        const limit = (0, args_1.parsePositiveInt)(options.limit, '--limit');
+        const evaluationType = normalizeType(options.type);
+        const ctx = await (0, context_1.resolveContentContext)();
+        const qs = new URLSearchParams({ limit: String(limit) });
+        if (options.cursor)
+            qs.set('cursor', options.cursor);
+        if (options.learnerId)
+            qs.set('learner', options.learnerId);
+        if (options.status)
+            qs.set('status', options.status);
+        if (evaluationType)
+            qs.set('evaluationType', evaluationType);
+        (0, output_1.printResult)(await ctx.client.request('GET', `${(0, context_1.classroomPath)(ctx, '/evaluations')}?${qs}`));
+    }));
+    evaluation
+        .command('get <evaluationId>')
+        .description('Show one evaluation')
+        .action((0, runtime_1.command)(async (id) => {
+        const ctx = await (0, context_1.resolveContentContext)();
+        (0, output_1.printResult)(await ctx.client.request('GET', (0, context_1.classroomPath)(ctx, `/evaluations/${(0, context_1.segment)(id)}`)));
+    }));
+    evaluation
+        .command('concepts')
+        .description('List the concepts evaluations have tagged in this classroom')
+        .action((0, runtime_1.command)(async () => {
+        const ctx = await (0, context_1.resolveContentContext)();
+        (0, output_1.printResult)(await ctx.client.request('GET', (0, context_1.classroomPath)(ctx, '/concepts')));
+    }));
+    evaluation
+        .command('mastery <learnerId>')
+        .description("Show a learner's mastery per concept")
+        .action((0, runtime_1.command)(async (learnerId) => {
+        const ctx = await (0, context_1.resolveContentContext)();
+        (0, output_1.printResult)(await ctx.client.request('GET', (0, context_1.classroomPath)(ctx, `/mastery/${(0, context_1.segment)(learnerId)}`)));
+    }));
+    return evaluation;
+}
+async function buildEvaluationBody(options) {
+    const evaluationType = normalizeType(options.type) ?? (await promptType());
+    const questionText = await (0, args_1.valueOrPrompt)(options.question, 'Enter the question:', 'Pass --question <text>.');
+    const learnerAnswer = await (0, args_1.valueOrPrompt)(options.studentAnswer, 'Enter the student answer:', 'Pass --student-answer <text>.');
+    const referenceAnswer = evaluationType === 'exact'
+        ? await (0, args_1.valueOrPrompt)(options.expectedAnswer, 'Enter the expected answer:', 'Pass --expected-answer <text>.')
+        : options.expectedAnswer;
+    return (0, args_1.compact)({
+        evaluationType,
+        questionText,
+        learnerAnswer,
+        referenceAnswer,
+        rubric: parseRubric(evaluationType, options.rubricJson),
+        maxScore: (0, args_1.parsePositiveInt)(options.maxScore, '--max-score'),
+        language: options.language,
+        learnerExternalId: options.learnerId,
+        conceptTags: (0, args_1.splitList)(options.conceptTags),
+        subject: options.subject,
+        mode: 'sync',
+    });
+}
+async function promptType() {
+    (0, runtime_1.requireInteractive)(`Pass --type ${VALID_TYPES.join('|')}`);
+    const result = await (0, prompts_1.select)({
+        message: 'Select evaluation type:',
+        options: [
+            { value: 'exact', label: 'Exact Match' },
+            { value: 'rubric_short_answer', label: 'Rubric-based' },
+            { value: 'open_ended', label: 'Open-ended AI Evaluation' },
+        ],
+    });
+    if (typeof result === 'symbol') {
+        throw new runtime_1.CliError('Cancelled', { code: 'ECANCELLED', exitCode: 130 });
+    }
+    return result;
+}
 function normalizeType(type) {
     if (!type)
         return undefined;
@@ -73,21 +131,12 @@ function normalizeType(type) {
     }
     return normalized;
 }
-function parseOptionalInteger(value, flagName) {
-    if (value === undefined)
-        return undefined;
-    const parsed = Number.parseInt(value, 10);
-    if (!Number.isInteger(parsed)) {
-        throw new runtime_1.CliError(`${flagName} must be an integer`, { code: 'EINVAL', exitCode: 2 });
-    }
-    return parsed;
-}
 function parseRubric(type, rubricJson) {
     if (type !== 'rubric_short_answer')
         return undefined;
     if (!rubricJson) {
         throw new runtime_1.CliError('rubric_short_answer requires --rubric-json <json>.', {
-            code: 'ENOINTERACTIVE',
+            code: 'EINVAL',
             exitCode: 2,
         });
     }
@@ -101,12 +150,4 @@ function parseRubric(type, rubricJson) {
         });
     }
 }
-async function promptOrThrow(message, flagHint) {
-    (0, runtime_1.requireInteractive)(`Pass ${flagHint} <text>.`);
-    const result = await (0, prompts_1.text)({ message });
-    if (!result || typeof result === 'symbol') {
-        throw new runtime_1.CliError('Cancelled', { code: 'ECANCELLED', exitCode: 130 });
-    }
-    return result;
-}
 //# sourceMappingURL=evaluate.js.map

package/dist/commands/evaluate.js.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../src/commands/evaluate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../src/commands/evaluate.ts"],"names":[],"mappings":"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"}

package/dist/commands/interactive.d.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+import { type ResourceSpec } from '../content/resource';
+interface InteractiveSpec extends ResourceSpec {
+    command: string;
+    description: string;
+    briefCredits: string;
+    buildCredits: string;
+}
+export declare function interactiveCommand(spec: InteractiveSpec): Command;
+export declare function gameCommand(): Command;
+export declare function simulationCommand(): Command;
+export {};
+//# sourceMappingURL=interactive.d.ts.map

package/dist/commands/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/commands/interactive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,EAKL,KAAK,YAAY,EAElB,MAAM,qBAAqB,CAAC;AAY7B,UAAU,eAAgB,SAAQ,YAAY;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAWD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CA+DjE;AAwCD,wBAAgB,WAAW,IAAI,OAAO,CASrC;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAS3C"}

package/dist/commands/interactive.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.interactiveCommand = interactiveCommand;
+exports.gameCommand = gameCommand;
+exports.simulationCommand = simulationCommand;
+const commander_1 = require("commander");
+const output_1 = require("../utils/output");
+const runtime_1 = require("../utils/runtime");
+const args_1 = require("../utils/args");
+const context_1 = require("../content/context");
+const resource_1 = require("../content/resource");
+const runs_1 = require("../content/runs");
+/**
+ * Games and simulations share one lifecycle: create → brief (plan) → build →
+ * revise. The CLI always asks for the 202 answer (Prefer: respond-async)
+ * instead of the SSE stream, and --wait polls the resource's run route.
+ */
+const VISIBILITIES = ['PUBLIC', 'PRIVATE'];
+const ASYNC_HEADERS = { Prefer: 'respond-async' };
+function interactiveCommand(spec) {
+    const root = new commander_1.Command(spec.command).description(spec.description);
+    root
+        .command('create')
+        .description(`Create an empty ${spec.noun}; then run brief and build`)
+        .requiredOption('--title <title>', 'Title')
+        .option('--description <text>', 'Description')
+        .option('--visibility <visibility>', 'PUBLIC or PRIVATE', 'PRIVATE')
+        .option('--idempotency-key <key>', 'Idempotency key for safe retries')
+        .action((0, runtime_1.command)(async (options) => {
+        const visibility = (0, args_1.parseChoice)(options.visibility, '--visibility', VISIBILITIES);
+        const ctx = await (0, context_1.resolveContentContext)();
+        (0, output_1.printResult)(await ctx.client.request('POST', (0, resource_1.resourcePath)(ctx, spec), (0, args_1.compact)({ title: options.title, description: options.description, visibility }), (0, args_1.idempotencyHeaders)(options.idempotencyKey)));
+    }));
+    addStep(root, spec, {
+        name: 'brief',
+        description: `Plan the ${spec.noun} (${spec.briefCredits})`,
+        configure: (cmd) => cmd.option('--reference <markdown>', 'Reference material in Markdown'),
+        body: (options) => (0, args_1.compact)({ referenceMarkdown: options.reference }),
+    });
+    addStep(root, spec, {
+        name: 'build',
+        description: `Build the ${spec.noun} from its plan (${spec.buildCredits})`,
+        configure: (cmd) => cmd,
+        body: () => undefined,
+    });
+    addStep(root, spec, {
+        name: 'revise',
+        description: `Revise the ${spec.noun} from feedback (${spec.buildCredits})`,
+        configure: (cmd) => cmd.requiredOption('--feedback <text>', 'What to change'),
+        body: (options) => ({ feedback: options.feedback }),
+    });
+    root
+        .command('status <id>')
+        .description('Show the running step and how the last one ended')
+        .action((0, runtime_1.command)(async (id) => {
+        const ctx = await (0, context_1.resolveContentContext)();
+        (0, output_1.printResult)(await ctx.client.request('GET', (0, resource_1.resourcePath)(ctx, spec, id, '/run')));
+    }));
+    (0, resource_1.addCrudCommands)(root, spec);
+    return root;
+}
+function addStep(root, spec, step) {
+    const cmd = step.configure(root.command(`${step.name} <id>`).description(step.description));
+    (0, resource_1.addWaitOptions)(cmd).option('--idempotency-key <key>', 'Idempotency key for safe retries');
+    cmd.action((0, runtime_1.command)(async (id, options) => {
+        const timeoutSeconds = (0, resource_1.parseTimeout)(options);
+        const ctx = await (0, context_1.resolveContentContext)();
+        const accepted = await startStep(ctx, spec, id, step.name, step.body(options), options);
+        (0, output_1.printResult)(options.wait
+            ? await (0, runs_1.waitForResourceRun)(ctx, spec.path, id, accepted.runId ?? undefined, timeoutSeconds)
+            : accepted);
+    }));
+}
+function startStep(ctx, spec, id, step, body, options) {
+    return ctx.client.request('POST', (0, resource_1.resourcePath)(ctx, spec, id, `/${step}`), body, {
+        ...ASYNC_HEADERS,
+        ...(0, args_1.idempotencyHeaders)(options.idempotencyKey),
+    });
+}
+function gameCommand() {
+    return interactiveCommand({
+        path: 'games',
+        noun: 'game',
+        command: 'game',
+        description: 'Create, plan and build classroom games',
+        briefCredits: '1 credit',
+        buildCredits: '40 credits',
+    });
+}
+function simulationCommand() {
+    return interactiveCommand({
+        path: 'simulations',
+        noun: 'simulation',
+        command: 'simulation',
+        description: 'Create, plan and build classroom simulations',
+        briefCredits: '1 credit',
+        buildCredits: '20 credits for 2D, 30 for 3D',
+    });
+}
+//# sourceMappingURL=interactive.js.map

package/dist/commands/interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../src/commands/interactive.ts"],"names":[],"mappings":"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"}

package/dist/commands/learner.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+/** Learner routes are live-only: test keys answer 403 content_sandbox_unsupported. */
+export declare function learnerCommand(): Command;
+//# sourceMappingURL=learner.d.ts.map

package/dist/commands/learner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learner.d.ts","sourceRoot":"","sources":["../../src/commands/learner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,sFAAsF;AACtF,wBAAgB,cAAc,IAAI,OAAO,CAsFxC"}