@epic-web/workshop-mcp 5.18.2 → 5.19.0

package/dist/esm/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":""}

package/dist/esm/index.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { initPrompts } from './prompts.js';
+import { initResources } from './resources.js';
+import { initPromptTools, initResourceTools, initTools } from './tools.js';
+// Create server instance
+const server = new McpServer({
+    name: 'epicshop',
+    version: '1.0.0',
+    capabilities: {
+        tools: {},
+    },
+}, {
+    instructions: `
+This is intended to be used within a workshop using the Epic Workshop App
+(@epic-web/workshop-app) to help learners in the process of completing the
+workshop exercises and understanding the learning outcomes.
+
+The user's work in progress is in the \`playground\` directory. Any changes they
+ask you to make should be in this directory.
+		`.trim(),
+});
+initTools(server);
+initResourceTools(server);
+initResources(server);
+initPrompts(server);
+initPromptTools(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('epicshop MCP Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error in main():', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE1E,yBAAyB;AACzB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC3B;IACC,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE;QACb,KAAK,EAAE,EAAE;KACT;CACD,EACD;IACC,YAAY,EAAE;;;;;;;GAOb,CAAC,IAAI,EAAE;CACR,CACD,CAAA;AAED,SAAS,CAAC,MAAM,CAAC,CAAA;AACjB,iBAAiB,CAAC,MAAM,CAAC,CAAA;AACzB,aAAa,CAAC,MAAM,CAAC,CAAA;AACrB,WAAW,CAAC,MAAM,CAAC,CAAA;AACnB,eAAe,CAAC,MAAM,CAAC,CAAA;AAEvB,KAAK,UAAU,IAAI;IAClB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/B,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAA;AACtD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACtB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAA;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAChB,CAAC,CAAC,CAAA","sourcesContent":["#!/usr/bin/env node\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { initPrompts } from './prompts.js'\nimport { initResources } from './resources.js'\nimport { initPromptTools, initResourceTools, initTools } from './tools.js'\n\n// Create server instance\nconst server = new McpServer(\n\t{\n\t\tname: 'epicshop',\n\t\tversion: '1.0.0',\n\t\tcapabilities: {\n\t\t\ttools: {},\n\t\t},\n\t},\n\t{\n\t\tinstructions: `\nThis is intended to be used within a workshop using the Epic Workshop App\n(@epic-web/workshop-app) to help learners in the process of completing the\nworkshop exercises and understanding the learning outcomes.\n\nThe user's work in progress is in the \\`playground\\` directory. Any changes they\nask you to make should be in this directory.\n\t\t`.trim(),\n\t},\n)\n\ninitTools(server)\ninitResourceTools(server)\ninitResources(server)\ninitPrompts(server)\ninitPromptTools(server)\n\nasync function main() {\n\tconst transport = new StdioServerTransport()\n\tawait server.connect(transport)\n\tconsole.error('epicshop MCP Server running on stdio')\n}\n\nmain().catch((error) => {\n\tconsole.error('Fatal error in main():', error)\n\tprocess.exit(1)\n})\n"]}

package/dist/esm/prompts.d.ts

@@ -0,0 +1,13 @@
+import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+export declare const quizMeInputSchema: {
+    workshopDirectory: z.ZodString;
+    exerciseNumber: z.ZodOptional<z.ZodString>;
+};
+export declare function quizMe({ workshopDirectory, exerciseNumber: providedExerciseNumber, }: {
+    workshopDirectory: string;
+    exerciseNumber?: string;
+}): Promise<GetPromptResult>;
+export declare function initPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/esm/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/prompts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,iBAAiB;;;CAQ7B,CAAA;AAED,wBAAsB,MAAM,CAAC,EAC5B,iBAAiB,EACjB,cAAc,EAAE,sBAAsB,GACtC,EAAE;IACF,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqC3B;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,QAO5C"}

package/dist/esm/prompts.js

@@ -0,0 +1,53 @@
+import { getExercises } from '@epic-web/workshop-utils/apps.server';
+import { getWorkshopConfig } from '@epic-web/workshop-utils/config.server';
+import { z } from 'zod';
+import { exerciseContextResource } from './resources.js';
+import { handleWorkshopDirectory } from './utils.js';
+export const quizMeInputSchema = {
+    workshopDirectory: z.string().describe('The workshop directory'),
+    exerciseNumber: z
+        .string()
+        .optional()
+        .describe('The exercise number to get quizzed on (leave blank for a random exercise).'),
+};
+export async function quizMe({ workshopDirectory, exerciseNumber: providedExerciseNumber, }) {
+    const workshopRoot = await handleWorkshopDirectory(workshopDirectory);
+    const config = getWorkshopConfig();
+    let exerciseNumber = Number(providedExerciseNumber);
+    if (!providedExerciseNumber) {
+        const exercises = await getExercises();
+        const randomExercise = exercises[Math.floor(Math.random() * exercises.length)];
+        exerciseNumber = randomExercise?.exerciseNumber ?? 0;
+    }
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `
+You are an expert teacher.
+
+Below is context about exercise ${exerciseNumber} in the workshop titled "${config.title}" (subtitled "${config.subtitle}") found at ${workshopRoot}.
+
+Please use this context to provide quiz questions, one at a time, to me to help me solidify my understanding of this material. Ask me the question, I will provide a response, you will either congratulate my correct understanding and move on or guide me to the correct answer with follow-up questions and hints until I either ask you to tell me the answer or ask you to continue to the next question.
+							`.trim(),
+                },
+            },
+            {
+                role: 'user',
+                content: {
+                    type: 'resource',
+                    resource: await exerciseContextResource.getResource({
+                        workshopDirectory,
+                        exerciseNumber,
+                    }),
+                },
+            },
+        ],
+    };
+}
+export function initPrompts(server) {
+    server.prompt('quiz_me', 'Have the LLM quiz you on topics from the workshop exercises', quizMeInputSchema, quizMe);
+}
+//# sourceMappingURL=prompts.js.map

package/dist/esm/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAG1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAEpD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAChE,cAAc,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACR,4EAA4E,CAC5E;CACF,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EAC5B,iBAAiB,EACjB,cAAc,EAAE,sBAAsB,GAItC;IACA,MAAM,YAAY,GAAG,MAAM,uBAAuB,CAAC,iBAAiB,CAAC,CAAA;IACrE,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAClC,IAAI,cAAc,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAA;IACnD,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,YAAY,EAAE,CAAA;QACtC,MAAM,cAAc,GACnB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;QACxD,cAAc,GAAG,cAAc,EAAE,cAAc,IAAI,CAAC,CAAA;IACrD,CAAC;IACD,OAAO;QACN,QAAQ,EAAE;YACT;gBACC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;kCAGuB,cAAc,4BAA4B,MAAM,CAAC,KAAK,iBAAiB,MAAM,CAAC,QAAQ,eAAe,YAAY;;;QAG3I,CAAC,IAAI,EAAE;iBACV;aACD;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACR,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE,MAAM,uBAAuB,CAAC,WAAW,CAAC;wBACnD,iBAAiB;wBACjB,cAAc;qBACd,CAAC;iBACF;aACD;SACD;KACD,CAAA;AACF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAiB;IAC5C,MAAM,CAAC,MAAM,CACZ,SAAS,EACT,6DAA6D,EAC7D,iBAAiB,EACjB,MAAM,CACN,CAAA;AACF,CAAC","sourcesContent":["import { getExercises } from '@epic-web/workshop-utils/apps.server'\nimport { getWorkshopConfig } from '@epic-web/workshop-utils/config.server'\nimport { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { type GetPromptResult } from '@modelcontextprotocol/sdk/types.js'\nimport { z } from 'zod'\nimport { exerciseContextResource } from './resources.js'\nimport { handleWorkshopDirectory } from './utils.js'\n\nexport const quizMeInputSchema = {\n\tworkshopDirectory: z.string().describe('The workshop directory'),\n\texerciseNumber: z\n\t\t.string()\n\t\t.optional()\n\t\t.describe(\n\t\t\t'The exercise number to get quizzed on (leave blank for a random exercise).',\n\t\t),\n}\n\nexport async function quizMe({\n\tworkshopDirectory,\n\texerciseNumber: providedExerciseNumber,\n}: {\n\tworkshopDirectory: string\n\texerciseNumber?: string\n}): Promise<GetPromptResult> {\n\tconst workshopRoot = await handleWorkshopDirectory(workshopDirectory)\n\tconst config = getWorkshopConfig()\n\tlet exerciseNumber = Number(providedExerciseNumber)\n\tif (!providedExerciseNumber) {\n\t\tconst exercises = await getExercises()\n\t\tconst randomExercise =\n\t\t\texercises[Math.floor(Math.random() * exercises.length)]\n\t\texerciseNumber = randomExercise?.exerciseNumber ?? 0\n\t}\n\treturn {\n\t\tmessages: [\n\t\t\t{\n\t\t\t\trole: 'user',\n\t\t\t\tcontent: {\n\t\t\t\t\ttype: 'text',\n\t\t\t\t\ttext: `\nYou are an expert teacher.\n\nBelow is context about exercise ${exerciseNumber} in the workshop titled \"${config.title}\" (subtitled \"${config.subtitle}\") found at ${workshopRoot}.\n\nPlease use this context to provide quiz questions, one at a time, to me to help me solidify my understanding of this material. Ask me the question, I will provide a response, you will either congratulate my correct understanding and move on or guide me to the correct answer with follow-up questions and hints until I either ask you to tell me the answer or ask you to continue to the next question.\n\t\t\t\t\t\t\t`.trim(),\n\t\t\t\t},\n\t\t\t},\n\t\t\t{\n\t\t\t\trole: 'user',\n\t\t\t\tcontent: {\n\t\t\t\t\ttype: 'resource',\n\t\t\t\t\tresource: await exerciseContextResource.getResource({\n\t\t\t\t\t\tworkshopDirectory,\n\t\t\t\t\t\texerciseNumber,\n\t\t\t\t\t}),\n\t\t\t\t},\n\t\t\t},\n\t\t],\n\t}\n}\n\nexport function initPrompts(server: McpServer) {\n\tserver.prompt(\n\t\t'quiz_me',\n\t\t'Have the LLM quiz you on topics from the workshop exercises',\n\t\tquizMeInputSchema,\n\t\tquizMe,\n\t)\n}\n"]}

package/dist/esm/resources.d.ts

@@ -0,0 +1,73 @@
+import { type McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { type InputSchemaType } from './utils.js';
+export declare const getWorkshopContextInputSchema: {
+    workshopDirectory: z.ZodString;
+};
+export declare function getWorkshopContext({ workshopDirectory, }: InputSchemaType<typeof getWorkshopContextInputSchema>): Promise<{
+    meta: {
+        'README.md': string | null;
+        config: any;
+        instructions: string | null;
+        finishedInstructions: string | null;
+    };
+    exercises: Array<any>;
+}>;
+export declare function getWorkshopContextResource({ workshopDirectory, }: InputSchemaType<typeof getWorkshopContextInputSchema>): Promise<ReadResourceResult['contents'][number]>;
+export declare const workshopContextResource: {
+    name: string;
+    description: string;
+    uriTemplate: ResourceTemplate;
+    getResource: typeof getWorkshopContextResource;
+    inputSchema: {
+        workshopDirectory: z.ZodString;
+    };
+};
+declare function getExerciseContextResource({ workshopDirectory, exerciseNumber, }: {
+    workshopDirectory: string;
+    exerciseNumber?: number;
+}): Promise<ReadResourceResult['contents'][number]>;
+export declare const exerciseContextResource: {
+    name: string;
+    description: string;
+    uriTemplate: ResourceTemplate;
+    getResource: typeof getExerciseContextResource;
+    inputSchema: {
+        workshopDirectory: z.ZodString;
+        exerciseNumber: z.ZodOptional<z.ZodNumber>;
+    };
+};
+declare const diffBetweenAppsInputSchema: {
+    workshopDirectory: z.ZodString;
+    app1: z.ZodString;
+    app2: z.ZodString;
+};
+declare function getDiffBetweenAppsResource({ workshopDirectory, app1, app2, }: InputSchemaType<typeof diffBetweenAppsInputSchema>): Promise<ReadResourceResult['contents'][number]>;
+export declare const diffBetweenAppsResource: {
+    name: string;
+    description: string;
+    uriTemplate: ResourceTemplate;
+    getResource: typeof getDiffBetweenAppsResource;
+    inputSchema: {
+        workshopDirectory: z.ZodString;
+        app1: z.ZodString;
+        app2: z.ZodString;
+    };
+};
+declare const getExerciseStepProgressDiffInputSchema: {
+    workshopDirectory: z.ZodString;
+};
+declare function getExerciseStepProgressDiffResource({ workshopDirectory, }: InputSchemaType<typeof getExerciseStepProgressDiffInputSchema>): Promise<ReadResourceResult['contents'][number]>;
+export declare const exerciseStepProgressDiffResource: {
+    name: string;
+    description: string;
+    uriTemplate: ResourceTemplate;
+    getResource: typeof getExerciseStepProgressDiffResource;
+    inputSchema: {
+        workshopDirectory: z.ZodString;
+    };
+};
+export declare function initResources(server: McpServer): void;
+export {};
+//# sourceMappingURL=resources.d.ts.map

package/dist/esm/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/resources.ts"],"names":[],"mappings":"AAkBA,OAAO,EACN,KAAK,SAAS,EACd,gBAAgB,EAChB,MAAM,yCAAyC,CAAA;AAChD,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AAC5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAEN,KAAK,eAAe,EAEpB,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,6BAA6B;;CAMzC,CAAA;AAED,wBAAsB,kBAAkB,CAAC,EACxC,iBAAiB,GACjB,EAAE,eAAe,CAAC,OAAO,6BAA6B,CAAC;;;;;;;eAcrC,KAAK,CAAC,GAAG,CAAC;GAwC5B;AAOD,wBAAsB,0BAA0B,CAAC,EAChD,iBAAiB,GACjB,EAAE,eAAe,CAAC,OAAO,6BAA6B,CAAC,GAAG,OAAO,CACjE,kBAAkB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CACtC,CAQA;AAED,eAAO,MAAM,uBAAuB;;;;;;;;CAMnC,CAAA;AAiLD,iBAAe,0BAA0B,CAAC,EACzC,iBAAiB,EACjB,cAAc,GACd,EAAE;IACF,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB,GAAG,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAalD;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;CAMnC,CAAA;AAED,QAAA,MAAM,0BAA0B;;;;CAI/B,CAAA;AA4CD,iBAAe,0BAA0B,CAAC,EACzC,iBAAiB,EACjB,IAAI,EACJ,IAAI,GACJ,EAAE,eAAe,CAAC,OAAO,0BAA0B,CAAC,GAAG,OAAO,CAC9D,kBAAkB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CACtC,CAYA;AAOD,eAAO,MAAM,uBAAuB;;;;;;;;;;CAMnC,CAAA;AAED,QAAA,MAAM,sCAAsC;;CAE3C,CAAA;AA+BD,iBAAe,mCAAmC,CAAC,EAClD,iBAAiB,GACjB,EAAE,eAAe,CAAC,OAAO,sCAAsC,CAAC,GAAG,OAAO,CAC1E,kBAAkB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CACtC,CAUA;AAOD,eAAO,MAAM,gCAAgC;;;;;;;;CAM5C,CAAA;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,QA2F9C"}

package/dist/esm/resources.js

@@ -0,0 +1,375 @@
+import path from 'node:path';
+import { invariant } from '@epic-web/invariant';
+import { extractNumbersAndTypeFromAppNameOrPath, findSolutionDir, getApps, getExercise, getExercises, getFullPathFromAppName, getPlaygroundApp, isExerciseStepApp, isPlaygroundApp, } from '@epic-web/workshop-utils/apps.server';
+import { getAuthInfo } from '@epic-web/workshop-utils/db.server';
+import { getEpicVideoInfos, userHasAccessToWorkshop, } from '@epic-web/workshop-utils/epic-api.server';
+import { ResourceTemplate, } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { handleWorkshopDirectory, safeReadFile, } from './utils.js';
+export const getWorkshopContextInputSchema = {
+    workshopDirectory: z
+        .string()
+        .describe('The workshop directory (the root directory of the workshop repo.).'),
+};
+export async function getWorkshopContext({ workshopDirectory, }) {
+    const workshopRoot = await handleWorkshopDirectory(workshopDirectory);
+    const inWorkshop = (...d) => path.join(workshopRoot, ...d);
+    const readInWorkshop = (...d) => safeReadFile(inWorkshop(...d));
+    const output = {
+        meta: {
+            'README.md': await readInWorkshop('README.md'),
+            config: JSON.parse((await readInWorkshop('package.json')) || '{}').epicshop,
+            instructions: await readInWorkshop('exercise', 'README.mdx'),
+            finishedInstructions: await readInWorkshop('exercise', 'FINISHED.mdx'),
+        },
+        exercises: [],
+    };
+    const exercises = await getExercises();
+    for (const exercise of exercises) {
+        const exerciseInfo = {
+            fullPath: exercise.fullPath,
+            exerciseNumber: exercise.exerciseNumber,
+            title: exercise.title,
+            instructions: await safeReadFile(path.join(exercise.fullPath, 'README.mdx')),
+            finishedInstructions: await safeReadFile(path.join(exercise.fullPath, 'FINISHED.mdx')),
+            steps: exercise.steps.map((step) => {
+                return {
+                    stepNumber: step.stepNumber,
+                    title: step.problem?.title ?? step.solution?.title ?? null,
+                    problem: step.problem
+                        ? {
+                            fullPath: step.problem.fullPath,
+                            testConfig: step.problem.test,
+                            devConfig: step.problem.dev,
+                        }
+                        : 'No problem app',
+                    solution: step.solution
+                        ? {
+                            fullPath: step.solution.fullPath,
+                            testConfig: step.solution.test,
+                            devConfig: step.solution.dev,
+                        }
+                        : 'No solution app',
+                };
+            }),
+        };
+        output.exercises.push(exerciseInfo);
+    }
+    return output;
+}
+const workshopContextUriTemplate = new ResourceTemplate('epicshop://{workshopDirectory}/workshop-context', { list: undefined });
+export async function getWorkshopContextResource({ workshopDirectory, }) {
+    return {
+        uri: workshopContextUriTemplate.uriTemplate.expand({
+            workshopDirectory,
+        }),
+        mimeType: 'application/json',
+        text: JSON.stringify(await getWorkshopContext({ workshopDirectory })),
+    };
+}
+export const workshopContextResource = {
+    name: 'workshop_context',
+    description: 'The context of the workshop',
+    uriTemplate: workshopContextUriTemplate,
+    getResource: getWorkshopContextResource,
+    inputSchema: getWorkshopContextInputSchema,
+};
+const getExerciseContextInputSchema = {
+    workshopDirectory: z
+        .string()
+        .describe('The workshop directory (the root directory of the workshop repo.).'),
+    exerciseNumber: z.coerce
+        .number()
+        .optional()
+        .describe(`The exercise number to get the context for (defaults to the exercise number the playground is currently set to)`),
+};
+async function getExerciseContext({ workshopDirectory, exerciseNumber, }) {
+    await handleWorkshopDirectory(workshopDirectory);
+    const userHasAccess = await userHasAccessToWorkshop();
+    const authInfo = await getAuthInfo();
+    let stepNumber = 1;
+    const playgroundApp = await getPlaygroundApp();
+    invariant(playgroundApp, 'No playground app found');
+    const numbers = extractNumbersAndTypeFromAppNameOrPath(playgroundApp.appName);
+    const isCurrentExercise = exerciseNumber === undefined ||
+        exerciseNumber === Number(numbers?.exerciseNumber);
+    if (exerciseNumber === undefined) {
+        invariant(numbers, 'No numbers found in playground app name');
+        exerciseNumber = Number(numbers.exerciseNumber);
+        stepNumber = Number(numbers.stepNumber);
+    }
+    const exercise = await getExercise(exerciseNumber);
+    invariant(exercise, `No exercise found for exercise number ${exerciseNumber}`);
+    const videoInfos = await getEpicVideoInfos([
+        ...(exercise.instructionsEpicVideoEmbeds ?? []),
+        ...exercise.steps.flatMap((s) => s.problem?.epicVideoEmbeds ?? []),
+        ...exercise.steps.flatMap((s) => s.solution?.epicVideoEmbeds ?? []),
+        ...(exercise.finishedEpicVideoEmbeds ?? []),
+    ]);
+    function getTranscripts(embeds) {
+        if (!embeds)
+            return [];
+        if (!userHasAccess && embeds.length) {
+            return [
+                {
+                    message: `User must upgrade before they can get access to ${embeds.length} transcript${embeds.length === 1 ? '' : 's'}.`,
+                },
+            ];
+        }
+        return embeds.map((embed) => {
+            const info = videoInfos[embed];
+            if (info) {
+                if (info.status === 'error') {
+                    if (info.type === 'region-restricted') {
+                        return {
+                            embed,
+                            status: 'error',
+                            type: info.type,
+                            requestedCountry: info.requestCountry,
+                            restrictedCountry: info.restrictedCountry,
+                        };
+                    }
+                    else {
+                        return {
+                            embed,
+                            status: 'error',
+                            type: info.type,
+                            statusCode: info.statusCode,
+                            statusText: info.statusText,
+                        };
+                    }
+                }
+                else {
+                    return {
+                        embed,
+                        status: 'success',
+                        transcript: info.transcript,
+                    };
+                }
+            }
+            else {
+                return {
+                    embed,
+                    status: 'error',
+                    type: 'not-found',
+                    message: 'No transcript found',
+                };
+            }
+        });
+    }
+    async function getFileContent(filePath) {
+        return {
+            path: filePath,
+            content: (await safeReadFile(filePath)) ?? 'None found',
+        };
+    }
+    const context = {
+        currentContext: {
+            user: {
+                hasAccess: userHasAccess,
+                isAuthenticated: Boolean(authInfo),
+                email: authInfo?.email,
+            },
+            playground: isCurrentExercise
+                ? {
+                    exerciseNumber,
+                    stepNumber,
+                }
+                : 'currently set to a different exercise',
+        },
+        exerciseBackground: {
+            number: exerciseNumber,
+            intro: {
+                content: await getFileContent(path.join(exercise.fullPath, 'README.mdx')),
+                transcripts: getTranscripts(exercise.instructionsEpicVideoEmbeds),
+            },
+            outro: {
+                content: await getFileContent(path.join(exercise.fullPath, 'FINISHED.mdx')),
+                transcripts: getTranscripts(exercise.finishedEpicVideoEmbeds),
+            },
+        },
+        steps: exercise.steps
+            ? await Promise.all(exercise.steps.map(async (app) => ({
+                number: app.stepNumber,
+                isCurrent: isCurrentExercise && app.stepNumber === stepNumber,
+                problem: {
+                    content: app.problem
+                        ? await getFileContent(path.join(app.problem.fullPath, 'README.mdx'))
+                        : 'No problem found',
+                    transcripts: getTranscripts(app.problem?.epicVideoEmbeds),
+                },
+                solution: {
+                    content: app.solution
+                        ? await getFileContent(path.join(app.solution.fullPath, 'README.mdx'))
+                        : 'No solution found',
+                    transcripts: getTranscripts(app.solution?.epicVideoEmbeds),
+                },
+            })))
+            : [],
+        notes: [],
+    };
+    if (exercise.steps) {
+        if (isCurrentExercise) {
+            context.notes.push(`Reminder, the current step is ${stepNumber} of ${exercise.steps.length + 1}. The most relevant information will be in the context above within the current step.`);
+        }
+    }
+    else {
+        context.notes.push('Unusually, this exercise has no steps.');
+    }
+    return context;
+}
+const exerciseContextUriTemplate = new ResourceTemplate('epicshop://{workshopDirectory}/exercise/{exerciseNumber}', { list: undefined });
+async function getExerciseContextResource({ workshopDirectory, exerciseNumber, }) {
+    const context = await getExerciseContext({
+        workshopDirectory,
+        exerciseNumber,
+    });
+    return {
+        uri: exerciseContextUriTemplate.uriTemplate.expand({
+            workshopDirectory,
+            exerciseNumber: String(context.exerciseBackground.number),
+        }),
+        mimeType: 'application/json',
+        text: JSON.stringify(context),
+    };
+}
+export const exerciseContextResource = {
+    name: 'exercise_context',
+    description: 'The context of the exercise',
+    uriTemplate: exerciseContextUriTemplate,
+    getResource: getExerciseContextResource,
+    inputSchema: getExerciseContextInputSchema,
+};
+const diffBetweenAppsInputSchema = {
+    workshopDirectory: z.string().describe('The workshop directory'),
+    app1: z.string().describe('The ID of the first app'),
+    app2: z.string().describe('The ID of the second app'),
+};
+async function getDiffBetweenApps({ workshopDirectory, app1, app2, }) {
+    await handleWorkshopDirectory(workshopDirectory);
+    const { getDiffOutputWithRelativePaths } = await import('@epic-web/workshop-utils/diff.server');
+    const app1Name = extractNumbersAndTypeFromAppNameOrPath(app1);
+    const app2Name = extractNumbersAndTypeFromAppNameOrPath(app2);
+    const apps = await getApps();
+    const app1App = apps
+        .filter(isExerciseStepApp)
+        .find((a) => a.exerciseNumber === Number(app1Name?.exerciseNumber) &&
+        a.stepNumber === Number(app1Name?.stepNumber) &&
+        a.type === app1Name?.type);
+    const app2App = apps
+        .filter(isExerciseStepApp)
+        .find((a) => a.exerciseNumber === Number(app2Name?.exerciseNumber) &&
+        a.stepNumber === Number(app2Name?.stepNumber) &&
+        a.type === app2Name?.type);
+    invariant(app1App, `No app found for ${app1}`);
+    invariant(app2App, `No app found for ${app2}`);
+    const diffCode = await getDiffOutputWithRelativePaths(app1App, app2App);
+    if (!diffCode)
+        return 'No changes';
+    return diffCode;
+}
+async function getDiffBetweenAppsResource({ workshopDirectory, app1, app2, }) {
+    return {
+        uri: diffBetweenAppsUriTemplate.uriTemplate.expand({
+            workshopDirectory,
+            app1,
+            app2,
+        }),
+        mimeType: 'application/json',
+        text: JSON.stringify(await getDiffBetweenApps({ workshopDirectory, app1, app2 })),
+    };
+}
+const diffBetweenAppsUriTemplate = new ResourceTemplate('epicshop://{workshopDirectory}/diff-between-apps/{app1}__vs___{app2}', { list: undefined });
+export const diffBetweenAppsResource = {
+    name: 'diff_between_apps',
+    description: 'The diff between two apps',
+    uriTemplate: diffBetweenAppsUriTemplate,
+    getResource: getDiffBetweenAppsResource,
+    inputSchema: diffBetweenAppsInputSchema,
+};
+const getExerciseStepProgressDiffInputSchema = {
+    workshopDirectory: z.string().describe('The workshop directory'),
+};
+async function getExerciseStepProgressDiff({ workshopDirectory, }) {
+    await handleWorkshopDirectory(workshopDirectory);
+    const { getDiffOutputWithRelativePaths } = await import('@epic-web/workshop-utils/diff.server');
+    const apps = await getApps();
+    const playgroundApp = apps.find(isPlaygroundApp);
+    invariant(playgroundApp, 'No playground app found');
+    const baseApp = playgroundApp;
+    const solutionDir = await findSolutionDir({
+        fullPath: await getFullPathFromAppName(playgroundApp.appName),
+    });
+    const headApp = apps.find((a) => a.fullPath === solutionDir);
+    invariant(headApp, 'No playground solution app found');
+    const diffCode = await getDiffOutputWithRelativePaths(baseApp, headApp);
+    if (!diffCode)
+        return 'No changes';
+    return diffCode;
+}
+async function getExerciseStepProgressDiffResource({ workshopDirectory, }) {
+    return {
+        uri: exerciseStepProgressDiffUriTemplate.uriTemplate.expand({
+            workshopDirectory,
+        }),
+        mimeType: 'application/json',
+        text: JSON.stringify(await getExerciseStepProgressDiff({ workshopDirectory })),
+    };
+}
+const exerciseStepProgressDiffUriTemplate = new ResourceTemplate('epicshop://{workshopDirectory}/exercise-step-progress-diff', { list: undefined });
+export const exerciseStepProgressDiffResource = {
+    name: 'exercise_step_progress_diff',
+    description: 'The diff between the current exercise step and the solution',
+    uriTemplate: exerciseStepProgressDiffUriTemplate,
+    getResource: getExerciseStepProgressDiffResource,
+    inputSchema: getExerciseStepProgressDiffInputSchema,
+};
+export function initResources(server) {
+    server.resource(workshopContextResource.name, workshopContextResource.uriTemplate, { description: workshopContextResource.description }, async (_uri, { workshopDirectory }) => {
+        invariant(typeof workshopDirectory === 'string', 'A single workshopDirectory is required');
+        const resource = await workshopContextResource.getResource({
+            workshopDirectory,
+        });
+        return { contents: [resource] };
+    });
+    server.resource(exerciseContextResource.name, exerciseContextResource.uriTemplate, { description: exerciseContextResource.description }, async (_uri, { workshopDirectory, exerciseNumber: providedExerciseNumber }) => {
+        invariant(typeof workshopDirectory === 'string', 'A single workshopDirectory is required');
+        invariant(typeof providedExerciseNumber === 'string', 'A single exerciseNumber is required');
+        const exerciseNumber = Number(providedExerciseNumber);
+        invariant(!isNaN(exerciseNumber), 'exerciseNumber must be a number');
+        invariant(exerciseNumber >= 0, 'exerciseNumber must be greater than or equal to 0');
+        return {
+            contents: [
+                await exerciseContextResource.getResource({
+                    workshopDirectory,
+                    exerciseNumber,
+                }),
+            ],
+        };
+    });
+    server.resource(diffBetweenAppsResource.name, diffBetweenAppsResource.uriTemplate, { description: diffBetweenAppsResource.description }, async (_uri, { workshopDirectory, app1, app2 }) => {
+        invariant(typeof workshopDirectory === 'string', 'A single workshopDirectory is required');
+        invariant(typeof app1 === 'string', 'A single app1 is required');
+        invariant(typeof app2 === 'string', 'A single app2 is required');
+        return {
+            contents: [
+                await diffBetweenAppsResource.getResource({
+                    workshopDirectory,
+                    app1,
+                    app2,
+                }),
+            ],
+        };
+    });
+    server.resource(exerciseStepProgressDiffResource.name, exerciseStepProgressDiffResource.uriTemplate, { description: exerciseStepProgressDiffResource.description }, async (_uri, { workshopDirectory }) => {
+        invariant(typeof workshopDirectory === 'string', 'A single workshopDirectory is required');
+        return {
+            contents: [
+                await exerciseStepProgressDiffResource.getResource({
+                    workshopDirectory,
+                }),
+            ],
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map