feat: manually mirror opencoze's code from bytedance

Change-Id: I09a73aadda978ad9511264a756b2ce51f5761adf

frontend/packages/studio/entity-adapter/.storybook/main.js

@@ -0,0 +1,31 @@
+import { mergeConfig } from 'vite';
+import svgr from 'vite-plugin-svgr';
+
+/** @type { import('@storybook/react-vite').StorybookConfig } */
+const config = {
+  stories: ['../stories/**/*.mdx', '../stories/**/*.stories.tsx'],
+  addons: [
+    '@storybook/addon-links',
+    '@storybook/addon-essentials',
+    '@storybook/addon-onboarding',
+    '@storybook/addon-interactions',
+  ],
+  framework: {
+    name: '@storybook/react-vite',
+    options: {},
+  },
+  docs: {
+    autodocs: 'tag',
+  },
+  viteFinal: config =>
+    mergeConfig(config, {
+      plugins: [
+        svgr({
+          svgrOptions: {
+            native: false,
+          },
+        }),
+      ],
+    }),
+};
+export default config;

frontend/packages/studio/entity-adapter/.storybook/preview.js

@@ -0,0 +1,14 @@
+/** @type { import('@storybook/react').Preview } */
+const preview = {
+  parameters: {
+    actions: { argTypesRegex: "^on[A-Z].*" },
+    controls: {
+      matchers: {
+        color: /(background|color)$/i,
+        date: /Date$/i,
+      },
+    },
+  },
+};
+
+export default preview;

frontend/packages/studio/entity-adapter/.stylelintrc.js

@@ -0,0 +1,5 @@
+const { defineConfig } = require('@coze-arch/stylelint-config');
+
+module.exports = defineConfig({
+  extends: [],
+});

frontend/packages/studio/entity-adapter/README.md

@@ -0,0 +1,16 @@
+# @coze-studio/entity-adapter
+
+> Project template for react component with storybook.
+
+## Features
+
+- [x] eslint & ts
+- [x] esm bundle
+- [x] umd bundle
+- [x] storybook
+
+## Commands
+
+- init: `rush update`
+- dev: `npm run dev`
+- build: `npm run build`

frontend/packages/studio/entity-adapter/config/rush-project.json

@@ -0,0 +1,12 @@
+{
+  "operationSettings": [
+    {
+      "operationName": "test:cov",
+      "outputFolderNames": ["coverage"]
+    },
+    {
+      "operationName": "ts-check",
+      "outputFolderNames": ["dist"]
+    }
+  ]
+}

frontend/packages/studio/entity-adapter/eslint.config.js

@@ -0,0 +1,7 @@
+const { defineConfig } = require('@coze-arch/eslint-config');
+
+module.exports = defineConfig({
+  packageRoot: __dirname,
+  preset: 'web',
+  rules: {},
+});

frontend/packages/studio/entity-adapter/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@coze-studio/entity-adapter",
+  "version": "0.0.1",
+  "description": "coze entity adapter, eg: create update Agent or Project",
+  "license": "Apache-2.0",
+  "author": "gaoyuanhan.duty@bytedance.com",
+  "maintainers": [],
+  "main": "src/index.ts",
+  "scripts": {
+    "build": "exit 0",
+    "lint": "eslint ./ --cache",
+    "test": "vitest --run --passWithNoTests",
+    "test:cov": "npm run test -- --coverage"
+  },
+  "dependencies": {
+    "@coze-agent-ide/space-bot": "workspace:*",
+    "@coze-arch/bot-api": "workspace:*",
+    "@coze-arch/bot-flags": "workspace:*",
+    "@coze-arch/bot-studio-store": "workspace:*",
+    "@coze-arch/coze-design": "0.0.6-alpha.346d77",
+    "@coze-arch/i18n": "workspace:*",
+    "@coze-common/biz-components": "workspace:*",
+    "@coze-studio/bot-detail-store": "workspace:*",
+    "@coze-studio/components": "workspace:*",
+    "classnames": "^2.3.2"
+  },
+  "devDependencies": {
+    "@coze-arch/bot-typings": "workspace:*",
+    "@coze-arch/eslint-config": "workspace:*",
+    "@coze-arch/stylelint-config": "workspace:*",
+    "@coze-arch/ts-config": "workspace:*",
+    "@coze-arch/vitest-config": "workspace:*",
+    "@testing-library/jest-dom": "^6.1.5",
+    "@testing-library/react": "^14.1.2",
+    "@testing-library/react-hooks": "^8.0.1",
+    "@types/react": "18.2.37",
+    "@types/react-dom": "18.2.15",
+    "@vitest/coverage-v8": "~3.0.5",
+    "react": "~18.2.0",
+    "react-dom": "~18.2.0",
+    "stylelint": "^15.11.0",
+    "vite-plugin-svgr": "~3.3.0",
+    "vitest": "~3.0.5"
+  },
+  "peerDependencies": {
+    "react": ">=18.2.0",
+    "react-dom": ">=18.2.0"
+  }
+}
+

frontend/packages/studio/entity-adapter/src/hooks/use-create-agent.tsx

@@ -0,0 +1,45 @@
+/*
+ * Copyright 2025 coze-dev Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+ 
+import { useRef } from 'react';
+
+import { type DraftBot } from '@coze-arch/bot-api/developer_api';
+
+import {
+  type CreateAgentEntityProps,
+  useCreateOrUpdateAgent,
+} from './use-create-or-update-agent';
+
+export const useCreateAgent = ({
+  spaceId,
+  onSuccess,
+  showSpace,
+  onBefore,
+  onError,
+  bizCreateFrom,
+}: Omit<CreateAgentEntityProps, 'mode' | 'botInfoRef'>) => {
+  const botInfoRef = useRef<DraftBot>({ visibility: 0 });
+  return useCreateOrUpdateAgent({
+    spaceId,
+    botInfoRef,
+    onBefore,
+    onSuccess,
+    onError,
+    mode: 'add',
+    showSpace,
+    bizCreateFrom,
+  });
+};

frontend/packages/studio/entity-adapter/src/hooks/use-create-or-update-agent/index.tsx

@@ -0,0 +1,215 @@
+/*
+ * Copyright 2025 coze-dev Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+ 
+import { type MutableRefObject, useEffect, useState, Fragment } from 'react';
+
+import { useBotInfoStore } from '@coze-studio/bot-detail-store/bot-info'; // Keep if botId is needed directly
+import {
+  PictureUpload,
+  type UploadValue,
+} from '@coze-common/biz-components/picture-upload';
+import { I18n } from '@coze-arch/i18n';
+import { Modal } from '@coze-arch/coze-design';
+import { useSpaceStore } from '@coze-arch/bot-studio-store';
+import {
+  FileBizType,
+  IconType,
+  type DraftBot,
+} from '@coze-arch/bot-api/developer_api';
+import {
+  useAgentPersistence,
+  useAgentFormManagement,
+  AgentInfoForm,
+} from '@coze-agent-ide/space-bot/hook';
+export interface CreateAgentEntityProps {
+  onBefore?: () => void;
+  onError?: () => void;
+  /** 只有需要 onSuccess 回调阻断弹窗自动关闭时，才需要返回 Promise */
+  onSuccess?: (
+    botId?: string,
+    spaceId?: string,
+    extra?: {
+      botName?: string;
+      botAvatar?: string;
+      botDesc?: string;
+    },
+  ) => void | Promise<void>;
+  botInfoRef?: MutableRefObject<DraftBot | undefined>;
+  mode: 'update' | 'add';
+  showSpace?: boolean;
+  /**
+   * 需要从外部控制在哪个空间创建 bot 时，传入此参数
+   * 仅适用于创建
+   */
+  spaceId?: string;
+  /**
+   * navi 导航栏
+   * space workspace 右上角的按钮
+   * */
+  bizCreateFrom?: 'navi' | 'space';
+}
+
+const getPictureUploadInitValue = (
+  botInfo?: Partial<DraftBot>,
+): UploadValue | undefined => {
+  if (!botInfo?.icon_url) {
+    return;
+  }
+  return [
+    {
+      url: botInfo.icon_url || '',
+      uid: botInfo.icon_uri || '',
+    },
+  ];
+};
+
+export const useCreateOrUpdateAgent = ({
+  botInfoRef,
+  onBefore,
+  onSuccess,
+  onError,
+  mode,
+  showSpace = false, // 默认不显示
+  spaceId: outerSpaceId,
+  bizCreateFrom,
+}: CreateAgentEntityProps) => {
+  const [visible, setVisible] = useState(false);
+
+  const botId = useBotInfoStore(state => state.botId);
+  const {
+    space: { id: spaceId, hide_operation },
+    spaces: { bot_space_list: list },
+  } = useSpaceStore();
+
+  const {
+    formRef,
+    isOkButtonDisable,
+    checkErr,
+    errMsg,
+    confirmDisabled,
+    setCheckErr,
+    setErrMsg,
+    handleFormValuesChange,
+    getValues,
+    resetFormState,
+  } = useAgentFormManagement({ initialBotInfo: botInfoRef?.current });
+
+  const {
+    loading: persistenceLoading,
+    handleCreateBot,
+    handleUpdateBot,
+  } = useAgentPersistence({
+    mode,
+    botId,
+    currentSpaceId: spaceId,
+    outerSpaceId,
+    getValues,
+    onSuccess,
+    onError,
+    onBefore,
+    setVisible,
+    setCheckErr,
+    setErrMsg,
+    bizCreateFrom,
+    showSpace,
+  });
+
+  useEffect(() => {
+    if (visible) {
+      useSpaceStore
+        .getState()
+        .fetchSpaces()
+        .then(res => {
+          if (!formRef.current?.formApi?.getValues()?.spaceId) {
+            formRef.current?.formApi?.setValue(
+              'spaceId',
+              hide_operation
+                ? res?.bot_space_list?.[0].id
+                : (spaceId ?? res?.bot_space_list?.[0].id),
+            );
+          }
+        });
+    }
+    if (visible) {
+      resetFormState();
+    }
+  }, [visible]);
+
+  /**
+   * @param _ 开源版本暂不支持此参数
+   */
+  const startEdit = (_?: boolean) => {
+    setVisible(true);
+  };
+
+  const formInitialValues = botInfoRef?.current || {};
+  return {
+    startEdit,
+    modal: (
+      <Fragment>
+        <Modal
+          data-testid="bot.ide.bot_creator.create_bot_modal"
+          visible={visible}
+          maskClosable={false}
+          onCancel={() => {
+            setVisible(false);
+          }}
+          title={
+            mode === 'add'
+              ? I18n.t('bot_list_create')
+              : I18n.t('bot_edit_title')
+          }
+          okText={I18n.t('Confirm')}
+          cancelText={I18n.t('Cancel')}
+          okButtonProps={{
+            disabled: isOkButtonDisable || confirmDisabled,
+            loading: persistenceLoading,
+          }}
+          footer={null}
+          keepDOM={false}
+          icon={null}
+          onOk={() => {
+            mode === 'add' ? handleCreateBot() : handleUpdateBot();
+          }}
+        >
+          <AgentInfoForm
+            ref={formRef}
+            mode={mode}
+            showSpace={showSpace}
+            initialValues={formInitialValues}
+            spacesList={list || []}
+            currentSpaceId={outerSpaceId || spaceId}
+            hideOperation={hide_operation}
+            checkErr={checkErr}
+            errMsg={errMsg}
+            onValuesChange={handleFormValuesChange}
+            slot={
+              <PictureUpload
+                accept=".jpeg,.jpg,.png,.gif"
+                label={I18n.t('bot_edit_profile_pircture')}
+                field="bot_uri"
+                initValue={getPictureUploadInitValue(formInitialValues)}
+                rules={[{ required: true }]}
+                fileBizType={FileBizType.BIZ_BOT_ICON}
+                iconType={IconType.Bot}
+              />
+            }
+          />
+        </Modal>
+      </Fragment>
+    ),
+  };
+};

frontend/packages/studio/entity-adapter/src/hooks/use-update-agent.tsx

@@ -0,0 +1,41 @@
+/*
+ * Copyright 2025 coze-dev Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+ 
+import { type MutableRefObject } from 'react';
+
+import { type DraftBot } from '@coze-arch/bot-api/developer_api';
+
+import { useCreateOrUpdateAgent } from './use-create-or-update-agent';
+
+export const useUpdateAgent = ({
+  botInfoRef,
+  onSuccess,
+}: {
+  botInfoRef?: MutableRefObject<DraftBot | undefined>;
+  onSuccess?: (
+    botId?: string,
+    spaceId?: string,
+    extra?: {
+      botName?: string;
+      botAvatar?: string;
+    },
+  ) => void;
+}) =>
+  useCreateOrUpdateAgent({
+    botInfoRef,
+    onSuccess,
+    mode: 'update',
+  });

frontend/packages/studio/entity-adapter/src/index.ts

@@ -0,0 +1,18 @@
+/*
+ * Copyright 2025 coze-dev Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+ 
+export { useCreateAgent } from './hooks/use-create-agent';
+export { useUpdateAgent } from './hooks/use-update-agent';

frontend/packages/studio/entity-adapter/src/typings.d.ts

@@ -0,0 +1,17 @@
+/*
+ * Copyright 2025 coze-dev Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+ 
+/// <reference types='@coze-arch/bot-typings' />

frontend/packages/studio/entity-adapter/tsconfig.build.json

@@ -0,0 +1,57 @@
+{
+  "extends": "@coze-arch/ts-config/tsconfig.web.json",
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "jsx": "react-jsx",
+    "lib": ["DOM", "ESNext"],
+    "module": "ESNext",
+    "target": "ES2020",
+    "moduleResolution": "bundler",
+    "tsBuildInfoFile": "dist/tsconfig.build.tsbuildinfo"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"],
+  "references": [
+    {
+      "path": "../../agent-ide/space-bot/tsconfig.build.json"
+    },
+    {
+      "path": "../../arch/bot-api/tsconfig.build.json"
+    },
+    {
+      "path": "../../arch/bot-flags/tsconfig.build.json"
+    },
+    {
+      "path": "../../arch/bot-store/tsconfig.build.json"
+    },
+    {
+      "path": "../../arch/bot-typings/tsconfig.build.json"
+    },
+    {
+      "path": "../../arch/i18n/tsconfig.build.json"
+    },
+    {
+      "path": "../../common/biz-components/tsconfig.build.json"
+    },
+    {
+      "path": "../components/tsconfig.build.json"
+    },
+    {
+      "path": "../../../config/eslint-config/tsconfig.build.json"
+    },
+    {
+      "path": "../../../config/stylelint-config/tsconfig.build.json"
+    },
+    {
+      "path": "../../../config/ts-config/tsconfig.build.json"
+    },
+    {
+      "path": "../../../config/vitest-config/tsconfig.build.json"
+    },
+    {
+      "path": "../stores/bot-detail/tsconfig.build.json"
+    }
+  ]
+}

frontend/packages/studio/entity-adapter/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "exclude": ["**/*"],
+  "compilerOptions": {
+    "composite": true
+  },
+  "references": [
+    {
+      "path": "./tsconfig.build.json"
+    },
+    {
+      "path": "./tsconfig.misc.json"
+    }
+  ]
+}

frontend/packages/studio/entity-adapter/tsconfig.misc.json

@@ -0,0 +1,20 @@
+{
+  "extends": "@coze-arch/ts-config/tsconfig.web.json",
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "rootDir": "./",
+    "outDir": "./dist",
+    "jsx": "react-jsx",
+    "lib": ["DOM", "ESNext"],
+    "module": "ESNext",
+    "target": "ES2020",
+    "moduleResolution": "bundler"
+  },
+  "include": ["__tests__", "vitest.config.ts", "stories"],
+  "exclude": ["./dist"],
+  "references": [
+    {
+      "path": "./tsconfig.build.json"
+    }
+  ]
+}

frontend/packages/studio/entity-adapter/vitest.config.ts

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2025 coze-dev Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+ 
+import { defineConfig } from '@coze-arch/vitest-config';
+
+export default defineConfig({
+  dirname: __dirname,
+  preset: 'web',
+});