mirror of
https://github.com/webstudio-is/webstudio.git
synced 2026-11-09 05:26:24 +09:00
Oleg Isonen
dde30ffb54
## Summary This improves how agents discover, author, inspect, and verify Webstudio projects while reducing unnecessary MCP context usage. ## What changed - Adds an **Agents** section to Project Settings with ready-to-run setup commands and client configuration for Claude Code, Codex, Cursor, and VS Code. - Makes large list and schema responses compact and paginated by default, with **verbose** available when complete records or diagnostics are needed. - Applies consistent compact output to assets, instances, styles, design tokens, CLI schemas, and project-session metadata. - Returns actionable expression warnings for props, resources, and Collection bindings, including unknown variables and risky render-time mutation resources. - Improves Collection expression guidance so agents can bind array items with the correct scoped variables. - Reports rendered audit outcomes explicitly as complete, partial, confirmation-required, or failed. - Expands runtime output schemas so MCP clients can validate responses reliably. - Strengthens the packaged CLI smoke workflow with a realistic seven-page stdio MCP scenario. ## Architecture - Consolidates `project-build` from 65 file-oriented entrypoints to 11 architecture-owned surfaces. - Separates the core model, contracts, runtime authoring, transfer, state, project sessions, MCP, visual tooling, persistence codecs, and authenticated server services. - Isolates Node-only JSX evaluation from browser-safe transfer utilities and authenticated server modules. - Keeps persistence codecs independent from authenticated database services, preventing unrelated module initialization. - Defines shared instance-path types once and reuses them across runtime modules. - Preserves Immer initialization through explicit package side-effect metadata. - Adds package tests that prevent a return to source-file entrypoints or generic exposure of Node-only surfaces. ## Validation - Full repository checks, tests, typechecks, generated-file checks, and fixtures - All 163 Builder test files and 2,141 tests - All 71 project-build test files and 1,794 tests - Lint and package-boundary validation - Full packed CLI release smoke test, including install, preview, agent setup, seven-page stdio MCP workflow, rendered audit, and structured commands
65 lines
2.0 KiB
TypeScript
65 lines
2.0 KiB
TypeScript
import type { CompactBuild } from "@webstudio-is/project-build";
|
|
import type { RuntimeOperationId } from "@webstudio-is/project-build/contracts";
|
|
import { executeBuilderRuntimeOperation } from "@webstudio-is/project-build/runtime";
|
|
import { BuilderRuntimeError } from "@webstudio-is/project-build/runtime";
|
|
import { builderRuntimeContext } from "@webstudio-is/project-build/runtime";
|
|
import { type BuilderRuntimeMutation } from "@webstudio-is/project-build/runtime";
|
|
import type { BuilderState } from "@webstudio-is/project-build/state";
|
|
import { createBuilderStateFromCompactBuild } from "@webstudio-is/project-build/state";
|
|
import { type Asset } from "@webstudio-is/sdk";
|
|
import { throwApiError } from "./api-errors.server";
|
|
|
|
export const createBuilderRuntimeState = (
|
|
build: CompactBuild,
|
|
assets?: Asset[]
|
|
): BuilderState =>
|
|
createBuilderStateFromCompactBuild(
|
|
assets === undefined ? build : { ...build, assets }
|
|
);
|
|
|
|
export const executeApiRuntimeOperation = async <Result>({
|
|
id,
|
|
build,
|
|
assets,
|
|
input,
|
|
}: {
|
|
id: RuntimeOperationId;
|
|
build: CompactBuild;
|
|
assets?: Asset[];
|
|
input: unknown;
|
|
}): Promise<Result> => {
|
|
try {
|
|
return await executeBuilderRuntimeOperation<Result>({
|
|
id,
|
|
state: createBuilderRuntimeState(build, assets),
|
|
input,
|
|
context: {
|
|
createId: builderRuntimeContext.createId,
|
|
projectId: build.projectId,
|
|
projectVersion: build.version,
|
|
},
|
|
});
|
|
} catch (error) {
|
|
if (error instanceof BuilderRuntimeError) {
|
|
return throwApiError(
|
|
error.code === "INVALID_INPUT" ? "BAD_REQUEST" : error.code,
|
|
error.message,
|
|
{
|
|
webstudioCode: error.code,
|
|
issues: error.issues,
|
|
}
|
|
);
|
|
}
|
|
throw error;
|
|
}
|
|
};
|
|
|
|
export const executeApiRuntimeMutation = <
|
|
Result extends Record<string, unknown> = Record<string, unknown>,
|
|
>(args: {
|
|
id: RuntimeOperationId;
|
|
build: CompactBuild;
|
|
assets?: Asset[];
|
|
input: unknown;
|
|
}) => executeApiRuntimeOperation<BuilderRuntimeMutation<Result>>(args);
|