feat: Update npm scripts and documentation for build and start commands (#412)

* Update npm scripts and documentation for build and start commands

* Update build:web script to include dependency installation

Author: jirispilka

.actor/Dockerfile

@@ -54,4 +54,4 @@ COPY . ./
 
 
 # Run the image.
-CMD npm run start:prod --silent
+CMD npm run start --silent

AGENTS.md

@@ -342,8 +342,10 @@ We use **4 spaces** for indentation (configured in `.editorconfig`).
 
 ### Development commands
 
-- `npm run start:dev` - Start development server (uses `tsx` for direct TypeScript execution)
-- `npm run build` - Build TypeScript to JavaScript
+- `npm run start` - Start standby server (uses `tsx` for direct TypeScript execution)
+- `npm run dev` - Alias for `npm run start`
+- `npm run build` - Build TypeScript and UI widgets
+- `npm run build:web` - Build UI widgets only
 - `npm run lint` - Run ESLint
 - `npm run lint:fix` - Fix ESLint issues automatically
 - `npm run type-check` - Type check without building

DEVELOPMENT.md

@@ -54,23 +54,23 @@ The MCP server uses UI widgets from the `src/web/` directory that need to be bui
 See the [OpenAI Apps SDK documentation](https://developers.openai.com/apps-sdk) for background on MCP Apps and widgets.
 
 ```bash
-npm run build-all
+npm run build
 ```
 
-This command builds the `src/web/` internal project, then runs `npm run build`, and copies the widgets into the `dist/` directory.
+This command builds the core project and the `src/web/` widgets, then copies the widgets into the `dist/` directory.
 
 If you only want to work on the React UI widgets, all widget code lives in the self-contained `src/web/` React project. The widgets (MCP Apps) are rendered based on the structured output returned by MCP tools. If you need to add specific data to a widget, you will need to modify the corresponding MCP tool's output since widgets can only render data returned by the MCP tool call result.
 
 > **Important (UI mode):** Widget rendering is enabled only when the server runs in UI mode. Use the `ui=openai` query parameter (e.g., `/mcp?ui=openai`) or set `UI_MODE=openai`. Currently, `openai` is the only supported `ui` value.
 
-> **Important:** After changing widgets, you must rebuild the project with `npm run build-all` to refresh the React widgets in the `dist/` directory.
+> **Important:** After changing widgets, you must rebuild the project with `npm run build` to refresh the React widgets in the `dist/` directory.
 
 ### Running the MCP server locally
 
 Start the MCP server locally using:
 
 ```bash
-APIFY_TOKEN='your-apify-token' npm run start:standby
+APIFY_TOKEN='your-apify-token' npm run start
 ```
 
 This will spawn the MCP server at port `3001`.

package.json

@@ -79,28 +79,28 @@
     "typescript-eslint": "^8.23.0",
     "vitest": "^3.0.8"
   },
-   "scripts": {
-     "start": "npm run start:dev",
-     "start:prod": "node dist/main.js",
-     "start:dev": "tsx src/main.ts",
-     "start:standby": "APIFY_META_ORIGIN=\"STANDBY\" npm run start:dev",
-     "lint": "eslint .",
-     "lint:fix": "eslint . --fix",
-     "check": "npm run type-check && npm run lint:fix",
-     "build": "tsc -b src",
-     "build-all": "cd src/web && npm run build && cd ../.. && npm run build",
-     "postbuild": "mkdir -p dist/web && (cp -r src/web/dist dist/web/ 2>/dev/null || :)",
-     "build:watch": "tsc -b src -w",
-     "check:widgets": "tsx scripts/check-widgets.ts",
-     "type-check": "tsc --noEmit",
-     "test": "npm run test:unit",
-     "test:unit": "vitest run tests/unit",
-     "test:integration": "npm run build && vitest run tests/integration",
-     "clean": "tsc -b src --clean && rm -rf dist/web",
-     "evals:create-dataset": "tsx evals/create-dataset.ts",
-     "evals:run": "tsx evals/run-evaluation.ts",
-     "evals:workflow": "tsx evals/workflows/run-workflow-evals.ts"
-   },
+  "scripts": {
+    "start": "npm run start:standby",
+    "dev": "npm run start:standby",
+    "start:standby": "APIFY_META_ORIGIN=\"STANDBY\" tsx src/main.ts",
+    "build": "npm run build:core && npm run build:web",
+    "build:core": "tsc -b src",
+    "build:watch": "tsc -b src -w",
+    "build:web": "npm --prefix src/web install && npm --prefix src/web run build",
+    "postbuild": "mkdir -p dist/web && (cp -r src/web/dist dist/web/ 2>/dev/null || :)",
+    "clean": "tsc -b src --clean && rm -rf dist/web",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "check": "npm run type-check && npm run lint",
+    "check:widgets": "tsx scripts/check-widgets.ts",
+    "test": "npm run test:unit",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "npm run build && vitest run tests/integration",
+    "evals:create-dataset": "tsx evals/create-dataset.ts",
+    "evals:run": "tsx evals/run-evaluation.ts",
+    "evals:workflow": "tsx evals/workflows/run-workflow-evals.ts"
+  },
   "author": "Apify",
   "license": "MIT"
 }