@pitcher/cli-scripts 2.10.0 → 2.12.0

package/dist/src/mcp/tools/ld.js

@@ -0,0 +1,680 @@
+import { z } from 'zod';
+import { runLdCourseList, runLdCourseGet, runLdCourseTags, runLdCourseCreate, runLdCourseUpdate, runLdCourseDelete, runLdCoursePublish, runLdCourseUnpublish, runLdCourseGetCanvas, runLdCourseSetCanvas, runLdCourseListModules, runLdCourseAddToModules, runLdCourseRemoveFromModule, runLdCourseListAssessments, runLdCourseLinkAssessments, runLdCourseUnlinkAssessment, } from '../../commands/ld/course.js';
+import { runLdCourseCreateCanvas } from '../../commands/ld/canvasCourse.js';
+import { runLdModuleTags, runLdModuleList, runLdModuleGet, runLdModuleCreate, runLdModuleUpdate, runLdModuleDelete, runLdModuleListCourses, runLdModuleAddCourses, runLdModuleReorderCourses, runLdModuleUpdateCourse, runLdModuleRemoveCourse, } from '../../commands/ld/module.js';
+import { runLdCertTags, runLdCertList, runLdCertGet, runLdCertCreate, runLdCertUpdate, runLdCertDelete, runLdCertTrainingMaterials, runLdCertListModules, runLdCertAddModules, runLdCertReorderModules, runLdCertUpdateModule, runLdCertRemoveModule, runLdCertListCourses, runLdCertAddCourses, runLdCertReorderCourses, runLdCertUpdateCourse, runLdCertRemoveCourse, runLdCertListAssessments, runLdCertAddAssessments, runLdCertUpdateAssessment, runLdCertRemoveAssessment, } from '../../commands/ld/cert.js';
+import { runLdAssessmentTags, runLdAssessmentList, runLdAssessmentGet, runLdAssessmentCreate, runLdAssessmentUpdate, runLdAssessmentDelete, runLdAssessmentListQuestions, runLdAssessmentAddQuestion, runLdAssessmentUpdateQuestion, runLdAssessmentReorderQuestions, runLdAssessmentDeleteQuestion, runLdAssessmentPreviewStart, runLdAssessmentPreviewGrade, runLdAssessmentListCourses, } from '../../commands/ld/assessment.js';
+const instance = z.string().trim().min(1, 'Instance ID is required').describe('Instance ID (required)');
+// NOTE: no `ldUrl`/`apiKey`/`org`/`url` in any inputShape — the L&D destination + auth are
+// pinned at server boot (NG_LD_API_URL / ld-app config), never a per-call tool input.
+export const ldTools = [
+    {
+        name: 'pitcher_ld_course_create_canvas',
+        title: 'Create a canvas L&D course',
+        description: 'Create a canvas-based L&D course in one step: create a draft, set its canvas content, and optionally publish. ' +
+            'Pass the canvas JSON INLINE via `canvas`. Use the create_ld_canvas_course prompt to author the JSON well. Additive.',
+        inputShape: {
+            instanceId: instance,
+            title: z.string().describe('Course title (required)'),
+            description: z.string().optional(),
+            canvas: z
+                .string()
+                .optional()
+                .describe('Inline canvas JSON: a canvas object { content: { data: [...] }, theme? } whose content.data is the flat component array (a bare content.data array is auto-wrapped). Inline only — a file path cannot cross a host sandbox.'),
+            publish: z.boolean().optional().describe('Publish after authoring'),
+        },
+        run: runLdCourseCreateCanvas,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_course_list',
+        title: 'List L&D courses',
+        description: 'List L&D courses in an instance. Filter by status/title/tags.',
+        inputShape: {
+            instanceId: instance,
+            status: z.string().optional(),
+            title: z.string().optional(),
+            tags: z.array(z.string()).optional(),
+            limit: z.number().int().optional(),
+            offset: z.number().int().optional(),
+        },
+        run: runLdCourseList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_course_get',
+        title: 'Get an L&D course',
+        description: 'Retrieve one L&D course by id.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCourseGet,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_course_tags',
+        title: 'List L&D course tags',
+        description: 'List distinct course tags in an instance.',
+        inputShape: { instanceId: instance },
+        run: runLdCourseTags,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_course_create',
+        title: 'Create an L&D course',
+        description: 'Create an L&D course (draft). For a canvas course, prefer pitcher_ld_course_create_canvas. Additive.',
+        inputShape: {
+            instanceId: instance,
+            title: z.string(),
+            description: z.string().min(10, 'min 10 chars').describe('min 10 chars'),
+            level: z.enum(['Beginner', 'Intermediate', 'Advanced']),
+            duration: z.number().int().describe('minutes'),
+            sectionsCount: z.number().int(),
+            contentSource: z
+                .enum(['html', 'scorm', 'canvas'])
+                .optional()
+                .describe('default html; an html course requires contentHtml'),
+            contentHtml: z.string().optional().describe('Inline HTML body — required when contentSource is html'),
+            completionCriteria: z.string().optional(),
+            thumbnailUrl: z.string().optional(),
+            scormPassRequired: z.boolean().optional(),
+            tags: z.array(z.string()).optional(),
+        },
+        run: runLdCourseCreate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_course_update',
+        title: 'Update an L&D course',
+        description: 'Update fields on an L&D course.',
+        inputShape: {
+            instanceId: instance,
+            id: z.string(),
+            title: z.string().optional(),
+            description: z.string().optional(),
+            level: z.enum(['Beginner', 'Intermediate', 'Advanced']).optional(),
+            duration: z.number().int().optional(),
+            sectionsCount: z.number().int().optional(),
+            contentSource: z.enum(['html', 'scorm', 'canvas']).optional(),
+            contentHtml: z.string().optional(),
+            status: z.string().optional(),
+            completionCriteria: z.string().optional(),
+            thumbnailUrl: z.string().optional(),
+            scormPassRequired: z.boolean().optional(),
+            tags: z.array(z.string()).optional(),
+        },
+        run: runLdCourseUpdate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_course_delete',
+        title: 'Delete an L&D course',
+        description: 'Delete an L&D course and its canvas.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCourseDelete,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_course_publish',
+        title: 'Publish an L&D course',
+        description: 'Publish an L&D course.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCoursePublish,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_course_unpublish',
+        title: 'Unpublish an L&D course',
+        description: 'Unpublish an L&D course.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCourseUnpublish,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_course_get_canvas',
+        title: 'Get an L&D course canvas',
+        description: 'Retrieve the stored canvas content of a canvas course.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCourseGetCanvas,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_course_set_canvas',
+        title: 'Set an L&D course canvas',
+        description: 'Save canvas content to a course. Pass `canvas` inline JSON.',
+        inputShape: { instanceId: instance, id: z.string(), canvas: z.string().optional() },
+        run: runLdCourseSetCanvas,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_course_list_modules',
+        title: "List a course's modules",
+        description: 'List modules a course belongs to.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCourseListModules,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_course_add_to_modules',
+        title: 'Add a course to modules',
+        description: 'Link a course into one or more modules.',
+        inputShape: { instanceId: instance, id: z.string(), moduleIds: z.array(z.string()) },
+        run: runLdCourseAddToModules,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_course_remove_from_module',
+        title: 'Remove a course from a module',
+        description: 'Unlink a course from a module.',
+        inputShape: { instanceId: instance, id: z.string(), moduleId: z.string() },
+        run: runLdCourseRemoveFromModule,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_course_list_assessments',
+        title: "List a course's assessments",
+        description: 'List assessments linked to a course.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCourseListAssessments,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_course_link_assessments',
+        title: 'Link assessments to a course',
+        description: 'Link one or more assessments to a course.',
+        inputShape: { instanceId: instance, id: z.string(), assessmentIds: z.array(z.string()) },
+        run: runLdCourseLinkAssessments,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_course_unlink_assessment',
+        title: 'Unlink an assessment from a course',
+        description: 'Remove an assessment link from a course.',
+        inputShape: { instanceId: instance, id: z.string(), assessmentId: z.string() },
+        run: runLdCourseUnlinkAssessment,
+        readOnly: false,
+        write: true,
+    },
+    // ---- modules ----
+    {
+        name: 'pitcher_ld_module_tags',
+        title: 'List L&D module tags',
+        description: 'List distinct module tags in an instance.',
+        inputShape: { instanceId: instance },
+        run: runLdModuleTags,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_module_list',
+        title: 'List L&D modules',
+        description: 'List L&D modules in an instance. Filter by status/title/tags.',
+        inputShape: {
+            instanceId: instance,
+            status: z.string().optional(),
+            title: z.string().optional(),
+            tags: z.array(z.string()).optional(),
+            limit: z.number().int().optional(),
+            offset: z.number().int().optional(),
+        },
+        run: runLdModuleList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_module_get',
+        title: 'Get an L&D module',
+        description: 'Retrieve one L&D module by id.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdModuleGet,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_module_create',
+        title: 'Create an L&D module',
+        description: 'Create an L&D module (draft). Additive.',
+        inputShape: {
+            instanceId: instance,
+            title: z.string(),
+            subtitle: z.string(),
+            description: z.string(),
+            tags: z.array(z.string()).optional(),
+        },
+        run: runLdModuleCreate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_module_update',
+        title: 'Update an L&D module',
+        description: 'Update fields on an L&D module.',
+        inputShape: {
+            instanceId: instance,
+            id: z.string(),
+            title: z.string().optional(),
+            subtitle: z.string().optional(),
+            description: z.string().optional(),
+            tags: z.array(z.string()).optional(),
+        },
+        run: runLdModuleUpdate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_module_delete',
+        title: 'Delete an L&D module',
+        description: 'Delete an L&D module.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdModuleDelete,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_module_list_courses',
+        title: "List a module's courses",
+        description: 'List courses in a module.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdModuleListCourses,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_module_add_courses',
+        title: 'Add courses to a module',
+        description: 'Link one or more courses into a module. Additive.',
+        inputShape: { instanceId: instance, id: z.string(), courseIds: z.array(z.string()) },
+        run: runLdModuleAddCourses,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_module_reorder_courses',
+        title: 'Reorder a module course',
+        description: 'Move a course to a new position within a module.',
+        inputShape: { instanceId: instance, id: z.string(), courseId: z.string(), newOrder: z.number().int() },
+        run: runLdModuleReorderCourses,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_module_update_course',
+        title: 'Update a module course',
+        description: 'Update a course link within a module (e.g. isRequired).',
+        inputShape: { instanceId: instance, id: z.string(), courseId: z.string(), isRequired: z.boolean().optional() },
+        run: runLdModuleUpdateCourse,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_module_remove_course',
+        title: 'Remove a course from a module',
+        description: 'Unlink a course from a module.',
+        inputShape: { instanceId: instance, id: z.string(), courseId: z.string() },
+        run: runLdModuleRemoveCourse,
+        readOnly: false,
+        write: true,
+    },
+    // ---- certificates ----
+    {
+        name: 'pitcher_ld_cert_tags',
+        title: 'List L&D certificate tags',
+        description: 'List distinct certificate tags in an instance.',
+        inputShape: { instanceId: instance },
+        run: runLdCertTags,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_cert_list',
+        title: 'List L&D certificates',
+        description: 'List L&D certificates in an instance. Filter by status/title/tags.',
+        inputShape: {
+            instanceId: instance,
+            status: z.string().optional(),
+            title: z.string().optional(),
+            tags: z.array(z.string()).optional(),
+            limit: z.number().int().optional(),
+            offset: z.number().int().optional(),
+        },
+        run: runLdCertList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_cert_get',
+        title: 'Get an L&D certificate',
+        description: 'Retrieve one L&D certificate by id.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCertGet,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_cert_create',
+        title: 'Create an L&D certificate',
+        description: 'Create an L&D certificate. Additive.',
+        inputShape: {
+            instanceId: instance,
+            title: z.string(),
+            description: z.string().optional(),
+            tags: z.array(z.string()).optional(),
+            validityPeriod: z.number().int().optional().describe('days'),
+        },
+        run: runLdCertCreate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_update',
+        title: 'Update an L&D certificate',
+        description: 'Update fields on an L&D certificate.',
+        inputShape: {
+            instanceId: instance,
+            id: z.string(),
+            title: z.string().optional(),
+            description: z.string().optional(),
+            tags: z.array(z.string()).optional(),
+            validityPeriod: z.number().int().optional(),
+        },
+        run: runLdCertUpdate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_delete',
+        title: 'Delete an L&D certificate',
+        description: 'Delete an L&D certificate.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCertDelete,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_training_materials',
+        title: "List a certificate's training materials",
+        description: 'List the training materials (modules/courses/assessments) attached to a certificate.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCertTrainingMaterials,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_cert_list_modules',
+        title: "List a certificate's modules",
+        description: 'List modules attached to a certificate.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCertListModules,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_cert_add_modules',
+        title: 'Add modules to a certificate',
+        description: 'Attach one or more modules to a certificate. Additive.',
+        inputShape: { instanceId: instance, id: z.string(), moduleIds: z.array(z.string()) },
+        run: runLdCertAddModules,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_reorder_modules',
+        title: 'Reorder a certificate module',
+        description: 'Move a module to a new position within a certificate.',
+        inputShape: { instanceId: instance, id: z.string(), itemId: z.string(), newOrder: z.number().int() },
+        run: runLdCertReorderModules,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_update_module',
+        title: 'Update a certificate module',
+        description: 'Update a module link within a certificate (e.g. isRequired).',
+        inputShape: { instanceId: instance, id: z.string(), moduleId: z.string(), isRequired: z.boolean().optional() },
+        run: runLdCertUpdateModule,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_remove_module',
+        title: 'Remove a module from a certificate',
+        description: 'Detach a module from a certificate.',
+        inputShape: { instanceId: instance, id: z.string(), moduleId: z.string() },
+        run: runLdCertRemoveModule,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_list_courses',
+        title: "List a certificate's courses",
+        description: 'List courses attached to a certificate.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCertListCourses,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_cert_add_courses',
+        title: 'Add courses to a certificate',
+        description: 'Attach one or more courses to a certificate. Additive.',
+        inputShape: { instanceId: instance, id: z.string(), courseIds: z.array(z.string()) },
+        run: runLdCertAddCourses,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_reorder_courses',
+        title: 'Reorder a certificate course',
+        description: 'Move a course to a new position within a certificate.',
+        inputShape: { instanceId: instance, id: z.string(), itemId: z.string(), newOrder: z.number().int() },
+        run: runLdCertReorderCourses,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_update_course',
+        title: 'Update a certificate course',
+        description: 'Update a course link within a certificate (e.g. isRequired).',
+        inputShape: { instanceId: instance, id: z.string(), courseId: z.string(), isRequired: z.boolean().optional() },
+        run: runLdCertUpdateCourse,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_remove_course',
+        title: 'Remove a course from a certificate',
+        description: 'Detach a course from a certificate.',
+        inputShape: { instanceId: instance, id: z.string(), courseId: z.string() },
+        run: runLdCertRemoveCourse,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_list_assessments',
+        title: "List a certificate's assessments",
+        description: 'List assessments attached to a certificate.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdCertListAssessments,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_cert_add_assessments',
+        title: 'Add assessments to a certificate',
+        description: 'Attach assessments to a certificate. Pass `assessments` as an inline JSON array [{ id, isRequired? }]. Additive.',
+        inputShape: {
+            instanceId: instance,
+            id: z.string(),
+            assessments: z.string().describe('Inline JSON array of assessment links'),
+        },
+        run: runLdCertAddAssessments,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_update_assessment',
+        title: 'Update a certificate assessment',
+        description: 'Update an assessment link within a certificate. isRequired is required by the backend.',
+        inputShape: { instanceId: instance, id: z.string(), assessmentId: z.string(), isRequired: z.boolean() },
+        run: runLdCertUpdateAssessment,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_cert_remove_assessment',
+        title: 'Remove an assessment from a certificate',
+        description: 'Detach an assessment from a certificate.',
+        inputShape: { instanceId: instance, id: z.string(), assessmentId: z.string() },
+        run: runLdCertRemoveAssessment,
+        readOnly: false,
+        write: true,
+    },
+    // ---- assessments ----
+    {
+        name: 'pitcher_ld_assessment_tags',
+        title: 'List L&D assessment tags',
+        description: 'List distinct assessment tags in an instance.',
+        inputShape: { instanceId: instance },
+        run: runLdAssessmentTags,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_list',
+        title: 'List L&D assessments',
+        description: 'List L&D assessments in an instance. Filter by status/title.',
+        inputShape: {
+            instanceId: instance,
+            status: z.string().optional(),
+            title: z.string().optional(),
+            limit: z.number().int().optional(),
+            offset: z.number().int().optional(),
+        },
+        run: runLdAssessmentList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_get',
+        title: 'Get an L&D assessment',
+        description: 'Retrieve one L&D assessment by id.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdAssessmentGet,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_create',
+        title: 'Create an L&D assessment',
+        description: 'Create an L&D assessment (draft). Additive.',
+        inputShape: {
+            instanceId: instance,
+            title: z.string(),
+            description: z.string().optional(),
+            passingScore: z.number().int().optional(),
+            timeLimit: z.number().int().optional().describe('minutes'),
+            maxAttempts: z.number().int().optional(),
+            tags: z.array(z.string()).optional(),
+        },
+        run: runLdAssessmentCreate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_update',
+        title: 'Update an L&D assessment',
+        description: 'Update fields on an L&D assessment. Set status to published to publish.',
+        inputShape: {
+            instanceId: instance,
+            id: z.string(),
+            title: z.string().optional(),
+            description: z.string().optional(),
+            passingScore: z.number().int().optional(),
+            timeLimit: z.number().int().optional(),
+            maxAttempts: z.number().int().optional(),
+            status: z.string().optional(),
+            tags: z.array(z.string()).optional(),
+        },
+        run: runLdAssessmentUpdate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_delete',
+        title: 'Delete an L&D assessment',
+        description: 'Delete an L&D assessment.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdAssessmentDelete,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_list_questions',
+        title: "List an assessment's questions",
+        description: 'List questions in an assessment.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdAssessmentListQuestions,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_add_question',
+        title: 'Add a question to an assessment',
+        description: 'Add a question to an assessment. Pass `question` as inline JSON. Additive.',
+        inputShape: { instanceId: instance, id: z.string(), question: z.string().describe('Inline question JSON') },
+        run: runLdAssessmentAddQuestion,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_update_question',
+        title: 'Update an assessment question',
+        description: 'Update a question in an assessment. Pass `question` as inline JSON.',
+        inputShape: {
+            instanceId: instance,
+            id: z.string(),
+            questionId: z.string(),
+            question: z.string().describe('Inline question JSON'),
+        },
+        run: runLdAssessmentUpdateQuestion,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_reorder_questions',
+        title: 'Reorder assessment questions',
+        description: 'Reorder the questions in an assessment by passing the full ordered id list.',
+        inputShape: { instanceId: instance, id: z.string(), questionIds: z.array(z.string()) },
+        run: runLdAssessmentReorderQuestions,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_delete_question',
+        title: 'Delete an assessment question',
+        description: 'Delete a question from an assessment.',
+        inputShape: { instanceId: instance, id: z.string(), questionId: z.string() },
+        run: runLdAssessmentDeleteQuestion,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_preview_start',
+        title: 'Start an assessment preview',
+        description: 'Start a preview attempt for an assessment (returns preview questions/session).',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdAssessmentPreviewStart,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_preview_grade',
+        title: 'Grade an assessment preview',
+        description: 'Grade a preview attempt. Pass `answers` as inline JSON.',
+        inputShape: { instanceId: instance, id: z.string(), answers: z.string().describe('Inline answers JSON') },
+        run: runLdAssessmentPreviewGrade,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_ld_assessment_list_courses',
+        title: "List an assessment's courses",
+        description: 'List courses that link to an assessment.',
+        inputShape: { instanceId: instance, id: z.string() },
+        run: runLdAssessmentListCourses,
+        readOnly: true,
+    },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pitcher/cli-scripts",
-  "version": "2.10.0",
+  "version": "2.12.0",
   "description": "The Pitcher CLI for various tasks in its ecosystem.",
   "author": "Pitcher AG",
   "license": "MIT",