@volcengine/amk-editor-assistant 1.0.0 → 1.0.1-beta.7

package/dist/tools/request-resource-selection.d.ts

@@ -14,12 +14,12 @@ export interface RequestResourceSelectionTool {
     readonly parameters: {
         readonly type: "object";
         readonly properties: Readonly<Record<string, unknown>>;
-        readonly required: readonly ["action"];
+        readonly required: readonly ["resourceType"];
         readonly additionalProperties: false;
     };
     readonly handler: (args: RequestResourceSelectionArgs) => Promise<RequestResourceSelectionResult>;
     readonly render: (props: RequestResourceSelectionToolCardProps) => ReactElement;
 }
-/** Frontend tool matching the mediakit-cut Agent resource selection contract. */
+/** Human-in-the-loop resource picker exposed to the Agent as a frontend Tool. */
 export declare function createRequestResourceSelectionTool(options: CreateRequestResourceSelectionToolOptions): RequestResourceSelectionTool;
 export declare const REQUEST_RESOURCE_SELECTION_TOOL_NAME = "request_resource_selection";

package/dist/tools/resource-selection/model.d.ts

@@ -1,106 +1,68 @@
 import type { AmkApiClient } from "../../vendor/amk-editor/index.js";
-export declare const RESOURCE_SELECTION_ACTIONS: readonly ["transition", "font", "text_style", "filter", "effect"];
-export type ResourceSelectionAction = (typeof RESOURCE_SELECTION_ACTIONS)[number];
-export declare const TEXT_ANIMATION_RESOURCE_TYPES: readonly ["enter_animation", "out_animation", "loop_animation"];
-export type TextAnimationResourceType = (typeof TEXT_ANIMATION_RESOURCE_TYPES)[number];
+export declare const RESOURCE_SELECTION_TYPES: readonly ["transition", "font", "word_art", "enter_animation", "out_animation", "loop_animation", "lut", "effect"];
+export type ResourceSelectionType = (typeof RESOURCE_SELECTION_TYPES)[number];
 export interface ResourceSelectionCandidate {
     readonly id: string;
     readonly name: string;
     readonly note?: string | undefined;
-    readonly source?: string | undefined;
     readonly posterUrl?: string | undefined;
-    readonly fileUrl?: string | undefined;
-    readonly panel?: string | undefined;
     readonly categoryKey?: string | undefined;
     readonly categoryName?: string | undefined;
-    readonly textres?: string | undefined;
-    readonly fontType?: string | undefined;
-    readonly TextRes?: string | undefined;
-    readonly FontType?: string | undefined;
 }
 export interface RequestResourceSelectionArgs {
-    readonly action: ResourceSelectionAction;
-    readonly requestId?: string;
-    readonly title?: string;
-    readonly reason?: string;
-    readonly region?: "cn-north" | "johor";
-    readonly resourceType?: string;
-    readonly candidates?: readonly ResourceSelectionCandidate[];
+    readonly resourceType: ResourceSelectionType;
+    readonly prompt?: string;
 }
 export type RequestResourceSelectionResult = {
-    readonly action: ResourceSelectionAction;
-    readonly selected: ResourceSelectionCandidate;
+    readonly status: "selected";
+    readonly resourceType: ResourceSelectionType;
+    readonly resource: Pick<ResourceSelectionCandidate, "id" | "name">;
 } | {
-    readonly action: ResourceSelectionAction;
-    readonly cancelled: true;
+    readonly status: "cancelled";
+    readonly resourceType: ResourceSelectionType;
+    readonly reason: "user_cancelled";
+    readonly allowAutomaticRetry: false;
+    readonly message: string;
 };
 export interface ResourceSelectionLoadResult {
     readonly candidates: readonly ResourceSelectionCandidate[];
-    readonly defaultFontId?: string | undefined;
-    readonly defaultTextStyleId?: string | undefined;
 }
 export type ResourceSelectionCandidateLoader = (args: RequestResourceSelectionArgs) => Promise<ResourceSelectionLoadResult>;
 export declare const RESOURCE_SELECTION_CONFIG: {
     readonly transition: {
         readonly title: "请选择转场效果";
-        readonly resourceType: "transition";
         readonly resourceKey: "transitions";
-        readonly panel: "transition";
     };
     readonly font: {
         readonly title: "请选择字体";
-        readonly resourceType: "font";
         readonly resourceKey: "fonts";
-        readonly panel: "font";
     };
-    readonly text_style: {
+    readonly word_art: {
         readonly title: "请选择花字";
-        readonly resourceType: "text_style";
         readonly resourceKey: "word_arts";
-        readonly panel: "text";
     };
-    readonly filter: {
+    readonly lut: {
         readonly title: "请选择滤镜";
-        readonly resourceType: "lut_filter";
         readonly resourceKey: "filters";
-        readonly panel: "filter";
     };
     readonly effect: {
         readonly title: "请选择特效";
-        readonly resourceType: "effect";
         readonly resourceKey: "effects";
-        readonly panel: "effect";
     };
-};
-declare const TEXT_ANIMATION_SELECTION_CONFIG: {
     readonly enter_animation: {
         readonly title: "请选择入场动画";
-        readonly resourceType: "enter_animation";
         readonly resourceKey: "text_enter_animations";
-        readonly panel: "text";
     };
     readonly out_animation: {
         readonly title: "请选择出场动画";
-        readonly resourceType: "out_animation";
         readonly resourceKey: "text_out_animations";
-        readonly panel: "text";
     };
     readonly loop_animation: {
         readonly title: "请选择循环动画";
-        readonly resourceType: "loop_animation";
         readonly resourceKey: "text_loop_animations";
-        readonly panel: "text";
     };
 };
-export type ResourceSelectionConfig = (typeof RESOURCE_SELECTION_CONFIG)[ResourceSelectionAction] | (typeof TEXT_ANIMATION_SELECTION_CONFIG)[TextAnimationResourceType];
-/**
- * `action` is the legacy, broad selection family. Text animations are carried
- * in the more specific `resourceType`, which must win over `text_style`.
- */
-export declare function resolveResourceSelectionConfig(args: Pick<RequestResourceSelectionArgs, "action" | "resourceType">): ResourceSelectionConfig;
-export declare function isResourceSelectionAction(value: unknown): value is ResourceSelectionAction;
-export declare function normalizeResourceSelectionCandidates(candidates: unknown): ResourceSelectionCandidate[];
-export declare function enrichTextResourceCandidate(action: ResourceSelectionAction, candidate: ResourceSelectionCandidate, defaults?: Pick<ResourceSelectionLoadResult, "defaultFontId" | "defaultTextStyleId">, resourceType?: string): ResourceSelectionCandidate;
+export declare function resolveResourceSelectionConfig(resourceType: ResourceSelectionType): (typeof RESOURCE_SELECTION_CONFIG)[ResourceSelectionType];
+export declare function isResourceSelectionType(value: unknown): value is ResourceSelectionType;
 /** Loads all editor preset groups once, then serves each modal from cache. */
-export declare function createPresetResourceSelectionLoader(client: Pick<AmkApiClient, "requestJson">): ResourceSelectionCandidateLoader;
-export {};
+export declare function createPresetResourceSelectionLoader(client: Pick<AmkApiClient, "requestJson">): ResourceSelectionCandidateLoader;

package/dist/tools/resource-selection/resource-selection-modal.d.ts

@@ -2,5 +2,5 @@ import type { ResourceSelectionModalController } from "./controller.js";
 export interface ResourceSelectionModalProps {
     readonly controller: ResourceSelectionModalController;
 }
-/** Reusable modal used by all transition/font/text-style/filter/effect requests. */
+/** Reusable modal used by all supported resource selection requests. */
 export declare function ResourceSelectionModal({ controller, }: ResourceSelectionModalProps): import("react").JSX.Element | null;

package/dist/tools/sync-materials.d.ts

@@ -0,0 +1,9 @@
+export declare const SYNC_MATERIALS_TOOL_MATCHER: RegExp;
+interface SyncMaterialsToolProps {
+    readonly status?: string;
+    readonly item?: {
+        readonly status?: string;
+    };
+}
+export declare function createSyncMaterialsTool(onComplete: () => void): (props: SyncMaterialsToolProps) => null;
+export {};

package/dist/types.d.ts

@@ -60,7 +60,7 @@ export type AmkEditorAssistantModelGroupChangeEvent = MediaKitAssistantModelGrou
 export type AmkEditorAssistantModelChangeEvent = AmkEditorAssistantSelectableModel | AmkEditorAssistantModelGroupChangeEvent;
 export type AmkEditorAssistantModel = string | readonly AmkEditorAssistantSelectableModel[] | readonly AmkEditorAssistantModelGroup[];
 /** Assistant presentation props plus AMK-specific integration options. */
-export type AmkEditorAssistantConfig = Omit<Omit<AssistantProps, "auth" | "agentId" | "model">, "conversation"> & {
+export type AmkEditorAssistantConfig = Omit<Omit<AssistantProps, "auth" | "agentId" | "model" | "theme">, "conversation"> & {
     /** A single endpoint initializes directly; an array enables model selection. */
     readonly model: AmkEditorAssistantModel;
     /** Receives the selected model, or the full change event for grouped models. */

package/dist/vendor/amk-editor/amk-editor.d.ts

@@ -1,4 +1,4 @@
-import type { AmkMaterialImportType, AmkMaterialImportRequestOptions, AmkEditorOptions, AmkExportRequestResult, AmkProjectSnapshot, MaterialItem, VeVeditorInstance } from './types';
+import type { AmkMaterialImportType, AmkMaterialImportRequestOptions, AmkEditorOptions, AmkExportRequestResult, AmkProjectSnapshot, AmkProjectInfo, MaterialItem, VeVeditorInstance } from './types';
 import { type AmkI18nInstance } from './i18n';
 import { type AmkInvokeToolParams } from './api/client';
 export declare class AmkEditor {
@@ -26,6 +26,7 @@ export declare class AmkEditor {
     private readonly bootstrapAbortController;
     private destroyed;
     private projectName?;
+    private projectInfo?;
     private editorRevision;
     private projectHydrated;
     private lastKnownTrack;
@@ -50,6 +51,8 @@ export declare class AmkEditor {
     /** 完整工程与轻量 editor 刷新共用队列，保证后发请求最后应用。 */
     private runtimeRefreshQueue;
     private projectRefreshInFlight?;
+    private materialsRefreshInFlight?;
+    private projectInfoRefreshInFlight?;
     private editParamRefreshInFlight?;
     private pendingSaveCount;
     private readonly asrPollingControllers;
@@ -147,6 +150,10 @@ export declare class AmkEditor {
      * 适合素材引用面板等必须包含最新导出产物的场景。
      */
     fetchProjectMaterials(): Promise<MaterialItem[]>;
+    /** 重新拉取全部素材并更新素材面板；不重新拉取或替换 Track、工程名。 */
+    refreshMaterials(): Promise<MaterialItem[]>;
+    /** 拉取完整工程元信息并应用相关字段；不刷新素材或 Track，也不回写工程。 */
+    refreshProjectInfo(): Promise<AmkProjectInfo>;
     /**
      * 重新拉取服务端工程，并把最新素材与 Track 热更新到当前编辑器。
      * 用于 Agent 完成远端编辑后刷新右侧预览；不会产生撤销记录，也不会把回灌事件再次保存到服务端。

package/dist/vendor/amk-editor/api/project.d.ts

@@ -1,5 +1,5 @@
 import type { AmkApiClient } from './client';
-import type { AmkProjectSnapshot, MaterialItem } from '../types';
+import type { AmkProjectSnapshot, AmkProjectInfo, MaterialItem } from '../types';
 type EditingApiClient = Pick<AmkApiClient, 'requestJson'>;
 export type LoadedAmkProject = AmkProjectSnapshot & {
     editorRevision: number;
@@ -15,6 +15,10 @@ export type SavedAmkEditor = {
 export declare function fetchAmkProjectMaterials(client: EditingApiClient, projectId: string, options?: {
     signal?: AbortSignal;
 }): Promise<MaterialItem[]>;
+/** 只读取工程元信息，不请求素材列表和 editor 文档。 */
+export declare function fetchAmkProjectInfo(client: EditingApiClient, projectId: string, options?: {
+    signal?: AbortSignal;
+}): Promise<AmkProjectInfo>;
 export declare function fetchAmkProject(client: EditingApiClient, projectId: string, options?: {
     signal?: AbortSignal;
 }): Promise<LoadedAmkProject>;

package/dist/vendor/amk-editor/index.d.ts

@@ -5,4 +5,4 @@ export type { AmkApiClientOptions, AmkInvokeToolParams } from './api/client';
 export type { PresetLibrary, PresetLibraryItem, PresetLibraryResourceKey, } from './api/preset-library';
 export { AMK_I18N_KEYS, createAmkI18n, tAmk, getGlobalAmkI18n, setGlobalAmkI18n, } from './i18n';
 export type { AmkI18nInstance, AmkI18nOptions, Locale, LocaleMessages, Messages, } from './i18n';
-export type { AmkEditorOptions, AmkEditorStorageConfig, AmkEditorUploadSTSCredentials, AmkEditorConfig, AmkEditorDecodeOptions, AmkEditorExportConfig, AmkEditorGetHeaders, AmkEditorHeaderConfig, AmkEditorHeaderTitleUpdateSuccess, AmkEditorInternalConfig, AmkMaterialImportType, AmkMaterialImportRequestOptions, AmkExportRequestResult, AmkExportTaskCreatedEvent, AmkProjectSnapshot, ExportVideoParams, MaterialConfig, MaterialItem, PersistExtractUrlsResult, RecommendedExtractStorageFields, SystemMaterialItem, Theme, VeVeditorInstance, } from './types';
+export type { AmkEditorOptions, AmkEditorStorageConfig, AmkEditorUploadSTSCredentials, AmkEditorConfig, AmkEditorDecodeOptions, AmkEditorExportConfig, AmkEditorGetHeaders, AmkEditorHeaderConfig, AmkEditorHeaderTitleUpdateSuccess, AmkEditorInternalConfig, AmkMaterialImportType, AmkMaterialImportRequestOptions, AmkExportRequestResult, AmkExportTaskCreatedEvent, AmkProjectSnapshot, AmkProjectInfo, ExportVideoParams, MaterialConfig, MaterialItem, PersistExtractUrlsResult, RecommendedExtractStorageFields, SystemMaterialItem, Theme, VeVeditorInstance, } from './types';

package/dist/vendor/amk-editor/types.d.ts

@@ -230,7 +230,15 @@ export interface VeVeditorInstance {
     [key: string]: unknown;
 }
 /** 内置 get/update 工程快照（不导出给宿主配置） */
+/** 工程接口返回的元信息；保留服务端扩展字段，供宿主及后续 UI 使用。 */
+export type AmkProjectInfo = {
+    project_id: string;
+    name: string;
+    description?: string;
+    [key: string]: unknown;
+};
 export type AmkProjectSnapshot = {
+    projectInfo?: AmkProjectInfo;
     projectName?: string;
     materials?: MaterialItem[];
     editParam?: Record<string, unknown>;

package/dist/vendor/mediakit-assistant/plugins/composer/composer-plugins.d.ts

@@ -12,6 +12,8 @@ export interface AssistantUploaderPluginProps {
     readonly onFileUpload: AssistantFileUploadHandler;
 }
 interface AssistantModelSelectorPluginBaseProps {
+    /** Overrides Assistant locale for the model picker's built-in labels. */
+    readonly locale?: string;
     /** Custom content rendered in the model panel header. */
     readonly panelHeader?: ReactNode;
     /** Custom content rendered when the active model group has no models. */

package/dist/vendor/mediakit-assistant/plugins/model-selector/assistant-model-selector.d.ts

@@ -1,6 +1,8 @@
 import { type ReactNode } from "react";
 import type { MediaKitAssistantModelGroup, MediaKitAssistantModelGroupChangeEvent, MediaKitAssistantModelGroupValue } from "./models.types.js";
 interface AssistantModelSelectorBaseProps {
+    /** Locale for built-in labels. Business-provided group and model text is not translated. */
+    readonly locale?: string | undefined;
     /** Disables the selector trigger. */
     readonly disabled?: boolean;
     /** Additional class applied to the selector root. */
@@ -11,6 +13,8 @@ interface AssistantModelSelectorBaseProps {
     readonly emptyState?: ReactNode;
     /** Reports popover visibility changes. */
     readonly onOpenChange?: (open: boolean) => void;
+    /** Theme classes applied to the trigger and its portaled panel. */
+    readonly theme?: string;
 }
 /** Configuration for the standalone grouped model selector. */
 export interface AssistantModelSelectorProps extends AssistantModelSelectorBaseProps {

package/dist/vendor/velo-assistant-tob/index.d.ts

@@ -1,7 +1,7 @@
 import type { ComponentType, CSSProperties, ReactNode } from "react";
 
 /**
- * Compile-only surface for velo-assistant-tob@0.0.36-beta.10.
+ * Compile-only surface for velo-assistant-tob@0.0.39-beta.7.
  * That release contains JSX implementation text in dist/index.d.ts. Runtime
  * imports still resolve to the package; remove this shim after it republishes
  * valid declarations.
@@ -130,7 +130,8 @@ export interface VeloAssistantProps {
   readonly attachments?: Readonly<Record<string, unknown>>;
   readonly panel?: VeloPanelConfig;
   readonly scene?: Readonly<Record<string, unknown>>;
-  readonly theme?: Readonly<Record<string, unknown>>;
+  /** VeDesign theme CSS class, such as `light` or `dark`. */
+  readonly theme?: string;
   readonly toolRenderers?: readonly {
     readonly match: string | RegExp;
     readonly render: ComponentType<Readonly<Record<string, unknown>>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volcengine/amk-editor-assistant",
-  "version": "1.0.0",
+  "version": "1.0.1-beta.7",
   "description": "Assistant integration SDK for @volcengine/amk-editor.",
   "keywords": [
     "volcengine",
@@ -34,9 +34,6 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "dependencies": {
-    "lit": "^3.3.3"
-  },
   "peerDependencies": {
     "react": "^18.2.0 || ^19.0.0",
     "react-dom": "^18.2.0 || ^19.0.0"

package/dist/chunks/DEK4uoWu.js

@@ -1,4 +0,0 @@
-import { E as a } from "./DJmsgPmR.js";
-export {
-  a as Mermaid
-};

package/dist/chunks/DIc_Gnqs.js

@@ -1,6 +0,0 @@
-import { I as r } from "./DktfaYnC.js";
-import { y as e } from "./DktfaYnC.js";
-export {
-  e as createFlowDiagram,
-  r as diagram
-};