@byteplus/amk-editor-assistant 0.0.0-beta.2 → 0.0.0-beta.4

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

@@ -37,8 +37,9 @@ export interface PersistExtractUrlsResult {
     /** 转存后的长期可访问 URL，须与回调入参 urls 等长。 */
     urls: string[];
     /**
-     * 随转存结果写回素材的业务字段，SDK 原样合并并持久化。
-     * 字段名和结构完全由业务决定；SDK 不读取推荐字段，也不限制自定义嵌套结构。
+     * 随转存结果写回素材的业务字段；material_id、poster_task_id、
+     * sprite_task_id 由 SDK 维护，即使传入 null 也会被忽略。
+     * 其他字段名和结构由业务决定，SDK 不限制自定义嵌套结构。
      */
     materialPatch?: Partial<MaterialItem>;
 }
@@ -72,8 +73,12 @@ export interface MaterialConfig extends VeVeditorMaterialOptions<MaterialItem> {
      * 临时转存并发数使用 uploadConcurrency，未配置时为 5。
      * 临时地址可先抽帧并展示，抽帧字段等待素材替换成功后再写回客户存储身份。
      * SDK 只扫描初始化已加载的素材和 refreshMaterials() 的结果，不轮询素材列表。
+     * 临时素材转存时，第二参数按 URL 顺序提供原素材，可用于识别无后缀 URL 的 type/name；
+     * 用户手动输入 URL 时不提供第二参数。
      */
-    onUploadUrlMaterial?: (urls: string[]) => Promise<MaterialItem[]> | MaterialItem[];
+    onUploadUrlMaterial?: (urls: string[], context?: {
+        readonly materials: readonly MaterialItem[];
+    }) => Promise<MaterialItem[]> | MaterialItem[];
     /**
      * 从业务资产库选择素材。业务方自行实现弹窗、列表查询与勾选，只返回选中数组。
      * 同时配置 TOS `storage.media_output_destination` 与 `storage.getUploadSTS` 时，
@@ -93,16 +98,19 @@ export interface MaterialConfig extends VeVeditorMaterialOptions<MaterialItem> {
      * 配置后：入参为待刷新素材列表，支持批量；返回补丁优先按 material_id 匹配，
      * source_material_id 次之，两者都未返回时才按数组顺序兜底，
      * 返回单条或数组补丁覆盖原素材的播放字段（url / poster / sprite / source_material_id 等）。
-     * 补丁不得改写 material_id（服务端字段，业务传了也不入库）。
+     * 补丁不得改写 material_id（服务端字段）及 poster_task_id / sprite_task_id
+     *（SDK 抽帧任务状态）；即使业务返回 null，也保留 SDK 当前值。
      */
     onRefreshPlayInfo?: (materials: MaterialItem[]) => Partial<MaterialItem> | Partial<MaterialItem>[] | Promise<Partial<MaterialItem> | Partial<MaterialItem>[]>;
     /**
      * 抽帧得到的临时 http（约 24h）转存成长效地址。
      * SDK 会先用临时链上屏/落盘，再后台调用本回调换链；失败则保留临时链。
-     * 未配置则只落盘临时链；签名明确过期且图片加载失败时，SDK 最多刷新一次播放地址，不重抽。
+     * 未配置时仍会落盘临时 HTTP 链；若同时没有有效的 storage 配置，初始化会提示 warning，不阻止启动。
+     * 已存链接下次打开工程时直接复用；加载失败且明确过期时先尝试换链，未恢复则每种素材本会话最多重抽一次。
      * 推荐返回 urls + materialPatch，把刷新 URL 所需的 storage key 或其他业务字段写入素材。
-     * SDK 不限制其他 materialPatch 字段；poster_storage_key / sprite_storage_keys
-     * 中的 `tos://` 地址会作为后续自动重签依据。
+     * materialPatch 可更新其他业务字段，但 material_id、poster_task_id、
+     * sprite_task_id 由 SDK 维护，回调返回的值（包括 null）会被忽略。
+     * poster_storage_key / sprite_storage_keys 中的 `tos://` 地址会作为后续自动重签依据。
      * 兼容只返回 string[]，但该形式无法附带业务字段。
      */
     onPersistExtractUrls?: (params: {

package/dist/vendor/mediakit-assistant/assistant/types.d.ts

@@ -33,6 +33,10 @@ export interface AssistantMediaKitPromptVariables {
     readonly prefer_multi_modal_models?: never;
     /** The active inference model is owned by the SDK and caller values are ignored. */
     readonly model?: never;
+    /** Server tool selection is owned by `mcp.tools`; caller values are ignored. */
+    readonly mcp_tools?: never;
+    /** Editing exclusions are owned by `mcp.editDenyTools`; caller values are ignored. */
+    readonly mcp_edit_deny_tools?: never;
     /** Business-owned JSON-compatible values forwarded under `promptVariables.mediakit`. */
     readonly [key: string]: unknown;
 }
@@ -59,6 +63,27 @@ export type AssistantSlots = Omit<VeloSlots, "composer">;
 export type AssistantWorkspaceConfig = VeloWorkspaceConfig;
 /** Velo FullPage navigation options. */
 export type AssistantNavigationConfig = VeloNavigationConfig;
+/**
+ * Independent MCP Server options forwarded through TCC Header bindings. Each list
+ * is trimmed and deduplicated, must use names matching `^[A-Za-z0-9_-]{1,64}$`,
+ * and has an independent 8192-byte JSON limit. Omitted or invalid lists are not
+ * sent; the MCP Server resolves each option's fallback. TCC domains remain in effect.
+ */
+export interface AssistantMcpConfig {
+    /**
+     * Internal MCP tool names sent as JSON for `x-mcp-tools-override`. An empty list
+     * explicitly overrides this option to empty; the server preserves the original
+     * `x-mcp-tools` semantics, including environment fallback and domains filtering.
+     * This option is not a strict global tool whitelist.
+     */
+    readonly tools?: readonly string[];
+    /**
+     * Internal editing tool names sent as JSON for `x-mcp-edit-deny-tools-override`.
+     * An empty list clears editing exclusions. This option is validated and omitted
+     * independently of `tools`; server authorization and availability still apply.
+     */
+    readonly editDenyTools?: readonly string[];
+}
 /** Public props for the MediaKit wrapper around VeloAssistant. */
 export type AssistantProps = Omit<VeloAssistantProps, BlockedAssistantProp | AdaptedAssistantProp> & {
     /** Active model endpoint used for the Runtime Header and MediaKit prompt variables. */
@@ -67,6 +92,8 @@ export type AssistantProps = Omit<VeloAssistantProps, BlockedAssistantProp | Ada
     readonly preferMultiModalModels?: readonly string[];
     /** Resolved wire model ID(s) available to MaaS tools through Velo's agent context. */
     readonly maasModel?: string | readonly string[];
+    /** Optional MCP Server options; Profiles must declare and bind each corresponding request field. */
+    readonly mcp?: AssistantMcpConfig;
     /** Authentication read without SDK-defined Header formatting. */
     readonly auth: AssistantAuthConfig;
     readonly runtime?: AssistantRuntimeConfig;
@@ -83,6 +110,8 @@ export type AssistantFullPageProps = Omit<VeloAssistantFullPageSingleAgentProps,
     readonly preferMultiModalModels?: readonly string[];
     /** Resolved wire model ID(s) available to MaaS tools through Velo's agent context. */
     readonly maasModel?: string | readonly string[];
+    /** Optional MCP Server options; Profiles must declare and bind each corresponding request field. */
+    readonly mcp?: AssistantMcpConfig;
     /** Authentication read without SDK-defined Header formatting. */
     readonly auth: AssistantAuthConfig;
     readonly runtime?: AssistantRuntimeConfig;

package/dist/vendor/mediakit-assistant/index.d.ts

@@ -10,4 +10,4 @@ export { AssistantModelSelector, type AssistantModelSelectorGroupedProps, type A
 export { AssistantUploader, type AssistantUploaderProps, type AssistantUploaderRenderContext, } from "./plugins/uploader/assistant-uploader.js";
 export type { VeloComposerAction, VeloComposerEntity, VeloComposerTrigger, VeloFrontendToolRegistration, } from "./assistant/velo-types.js";
 export type { AssistantFileUploadContext, AssistantFileUploadHandler, AssistantUploadedFile, } from "./plugins/uploader/types.js";
-export type { AssistantAgentConfig, AssistantAuthConfig, AssistantComposerConfig, AssistantController, AssistantConversationConfig, AssistantConversationHistoryConfig, AssistantConversationPromptVariables, AssistantFullPageController, AssistantFullPageProps, AssistantMediaKitPromptVariables, AssistantNavigationConfig, AssistantPanelConfig, AssistantProps, AssistantRuntimeConfig, AssistantSlots, AssistantWorkspaceConfig, } from "./assistant/types.js";
+export type { AssistantAgentConfig, AssistantAuthConfig, AssistantComposerConfig, AssistantController, AssistantConversationConfig, AssistantConversationHistoryConfig, AssistantConversationPromptVariables, AssistantFullPageController, AssistantFullPageProps, AssistantMediaKitPromptVariables, AssistantMcpConfig, AssistantNavigationConfig, AssistantPanelConfig, AssistantProps, AssistantRuntimeConfig, AssistantSlots, AssistantWorkspaceConfig, } from "./assistant/types.js";

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

@@ -15,11 +15,8 @@ export declare const MaasModelId: Readonly<{
     readonly Seedance2Mini: "seedance-2-0-mini-260615";
     readonly SeedAudio1: "seed-audio-1.0";
 }>;
-/** Finite set of region-agnostic MaaS model IDs accepted in group configuration. */
+/** Region-agnostic MaaS model IDs accepted by typed group configuration. */
 export type MaasModelId = (typeof MaasModelId)[keyof typeof MaasModelId];
 export declare function isMaasModelId(value: unknown): value is MaasModelId;
-/** Resolves a canonical model ID to the provider-specific wire ID. */
-export declare function getMaasModelWireId(region: MaasModelRegion, modelId: MaasModelId): string;
-/** Checks whether an already-resolved wire ID is valid in the given region. */
-export declare function isMaasModelWireIdInRegion(value: string, region: MaasModelRegion): boolean;
-export declare function isMaasModelWireId(value: unknown): value is string;
+/** Resolves any non-empty model ID to a provider-specific wire ID. */
+export declare function getMaasModelWireId(region: MaasModelRegion, modelId: string): string;

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

@@ -1,6 +1,6 @@
 import { type MaasModelId, type MaasModelRegion } from "./maas-model-catalog.js";
 import type { MediaKitAssistantModel, MediaKitAssistantModelGroup, MediaKitAssistantModelGroupValue } from "./models.types.js";
-/** One selectable MaaS choice declared by the host using a canonical model ID. */
+/** One selectable MaaS choice declared by the host using a catalog model ID. */
 export interface MaasSelectableModel extends Omit<MediaKitAssistantModel, "value"> {
     readonly value: MaasModelId;
 }
@@ -18,7 +18,7 @@ export interface MaasModelGroup extends Omit<MediaKitAssistantModelGroup, "key"
 type MediaKitAssistantOrdinaryModelGroup = MediaKitAssistantModelGroup & {
     readonly region?: never;
 };
-/** Selector input supporting legacy wire-ID groups and region-aware MaaS catalog groups. */
+/** Selector input supporting ordinary groups and region-aware MaaS groups. */
 export type ModelSelectorGroup = MediaKitAssistantOrdinaryModelGroup | MaasModelGroup;
 /**
  * Validates one literal group and, for the reserved MaaS group, resolves shared

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byteplus/amk-editor-assistant",
-  "version": "0.0.0-beta.2",
+  "version": "0.0.0-beta.4",
   "description": "Assistant integration SDK for @byteplus/amk-editor.",
   "keywords": [
     "byteplus",
@@ -47,6 +47,6 @@
   },
   "amkEditor": {
     "name": "@byteplus/amk-editor",
-    "version": "0.0.0-beta.3"
+    "version": "0.0.0-beta.4"
   }
 }

package/dist/chunks/C-Y31m3C.js

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

package/dist/chunks/ztP2CGH5.js

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