签名关联类型:AssistantWorldFailure – BevyEdgeHover
本页由当前 SDK 声明自动生成。
AssistantWorldFailure · AssistantWorldFailureCode · AssistantWorldGrantBinding · AssistantWorldModelContent · AssistantWorldObjectSummary · AssistantWorldPatchDiagnostic · AssistantWorldPatchMatch · AssistantWorldScopeSelection · AssistantWorldWriteInput · AssistantWorldWriteOperation · AssistantWorldWriteOutcome · AuthoringGenerateMode · AuthoringLayoutProps · Axis3 · AxisDragConstraint · BackgroundActivityJob · BackgroundActivityKind · BackgroundActivityStatus · BevyAggregateConnect · BevyAggregateConnectEdge · BevyAnimationPlayback · BevyDragAttach · BevyDragAttachEdge · BevyEdgeHover
AssistantWorldFailure
export interface AssistantWorldFailure { ok: false; code: AssistantWorldFailureCode; message: string; conflicts?: WorldAuthoringConflict[]; spatialReason?: string; spatialDiagnostic?: WorldAuthoringFailure["spatialDiagnostic"]; patchDiagnostic?: AssistantWorldPatchDiagnostic; currentVersion?: WorldVersion; references?: Array<{ nodeId: string; kind: string; }>; editIndex?: number;}关联类型:AssistantWorldFailureCode · WorldAuthoringConflict · WorldAuthoringFailure · AssistantWorldPatchDiagnostic · WorldVersion
成员说明:
spatialDiagnostic:Actionable out-of-scope geometry, only when the authority could read it.patchDiagnostic:Patch-only diagnostics (patch-not-found/patch-ambiguous).currentVersion:Current authoritative version, present onversion-conflictwhen it could be read.
AssistantWorldFailureCode
export type AssistantWorldFailureCode = WorldAuthoringFailureCode | "target-unavailable" | "capability-unsupported" | "not-issued" | "unverified-run" | "unverified-stop" | "patch-not-found" | "patch-ambiguous" | "patch-noop" | "reference-conflict" | "already-exists" | "humanoid-rig-disabled";关联类型:WorldAuthoringFailureCode
AssistantWorldGrantBinding
Host binding stored with the issued tool grant, never sent to the model prompt.
export interface AssistantWorldGrantBinding { contextId: WorldId; completionId: WorldId; runId: WorldId; epoch: number; executionId: WorldId; scope: WorldScopeVersion;}关联类型:WorldId · WorldScopeVersion
AssistantWorldModelContent
Model content accepted by assistant tools. Content identity is derived by the authority.
模型没有卡片,位置只由创建操作的 transform 表达
。
export interface AssistantWorldModelContent { modelScript: string; modelScriptVersion?: string; cardPosition?: { x: number; y: number; };}成员说明:
cardPosition:新建模型时画布上的卡片落点;缺省由画布按非重叠规则决定。
AssistantWorldObjectSummary
export type AssistantWorldObjectSummary = { identity: WorldObjectIdentity; nodeId: string | null; version: WorldVersion; containment: "writable" | "read-only" | "outside" | "unknown"; contentVersion?: string; transformVersion?: string;};关联类型:WorldObjectIdentity · WorldVersion
AssistantWorldPatchDiagnostic
Actionable patch diagnostics. They name where the requested text is (or is nearly) located so the caller can widen its context instead of guessing.
export interface AssistantWorldPatchDiagnostic { occurrences: number; matches?: AssistantWorldPatchMatch[]; closest?: AssistantWorldPatchMatch; scriptLength: number;}成员说明:
occurrences:How many timesoldStringoccurred (0 for not-found, >1 for ambiguous).matches:Occurrence positions, bounded.closest:Nearest similar excerpt, present forpatch-not-found.scriptLength:Current authoritative script length in characters.
AssistantWorldPatchMatch
One place a patch oldString occurs; line is 1-based.
export interface AssistantWorldPatchMatch { line: number; column: number; excerpt: string;}成员说明:
column:1-based column inside that line.excerpt:Bounded original-text excerpt around the match.
AssistantWorldScopeSelection
Selectable authoring scopes.
export type AssistantWorldScopeSelection = { kind: "scene-area"; areaId: WorldId;} | { kind: "world-camera"; cameraId: WorldId;};关联类型:WorldId
AssistantWorldWriteInput
export interface AssistantWorldWriteInput { contextId: WorldId; operation: AssistantWorldWriteOperation;}关联类型:WorldId · AssistantWorldWriteOperation
成员说明:
contextId:Host-issued context. Never accepted from the model’s tool arguments.
AssistantWorldWriteOperation
export type AssistantWorldWriteOperation = { kind: "edit-resource"; operationId: string; edit: WorldResourceEdit;} | { kind: "create-model"; operationId: WorldId; nodeId: WorldId; instanceId?: WorldId; content: AssistantWorldModelContent; transform: WorldTransform;} | { kind: "replace-model-content"; operationId: WorldId; instanceId: WorldId; expectedVersion: WorldVersion; content: AssistantWorldModelContent; transform?: WorldTransform;} | { kind: "append-model-script"; operationId: WorldId; instanceId: WorldId; expectedVersion: WorldVersion; chunk: string;} | { kind: "patch-model-script"; operationId: WorldId; instanceId: WorldId; expectedVersion: WorldVersion; oldString: string; newString: string;} | { kind: "set-model-transform"; operationId: WorldId; instanceId: WorldId; expectedVersion: WorldVersion; transform: WorldTransform;} | { kind: "set-scene-animation-script"; motionAsset?: StoredAsset; motionTarget?: { instanceId: WorldId; expectedVersion: WorldVersion; scopeVersion?: WorldVersion; canvasRevision?: number; }; motionBaseRevision?: number; operationId: WorldId; script: string; duration: number; loop: boolean;} | { kind: "set-world-camera"; operationId: WorldId; cameraId: WorldId; expectedSettingsVersion: WorldVersion; settings: WorldCameraSettingsPatch;} | { kind: "create-world-camera"; operationId: WorldId; nodeId: WorldId; cameraId: WorldId; settings: WorldCameraSettings; cardPosition?: { x: number; y: number; };};关联类型:WorldResourceEdit · WorldId · AssistantWorldModelContent · WorldTransform · WorldVersion · StoredAsset · WorldCameraSettingsPatch · WorldCameraSettings
成员说明:
kind:Append one chunk to the authoritative script; the host composescurrent + chunk. Exact-text patch:oldStringmust occur exactly once in the current script.
AssistantWorldWriteOutcome
export type AssistantWorldWriteOutcome = { ok: true; canvasId: WorldId; commandId: string; revision: number; duplicate: boolean; noop: boolean; instanceId?: WorldId; nodeId?: WorldId; cameraId?: WorldId; settingsVersion?: WorldVersion; version?: WorldVersion; scriptLength?: number; replaced?: number; view?: WorldCameraView; target?: WorldResourceTarget; sceneArea?: WorldResourceReceipt["sceneArea"]; deleted?: boolean;} | AssistantWorldFailure;关联类型:WorldId · WorldVersion · WorldCameraView · WorldResourceTarget · WorldResourceReceipt · AssistantWorldFailure
AuthoringGenerateMode
生成目标模式。
export type AuthoringGenerateMode = "model3d" | "text" | "world" | "canvas-group";AuthoringLayoutProps
type AuthoringLayoutProps = { inspector: boolean; quickActions?: ReactNode; references?: ReactNode; mcp: ReactNode; prompt: ReactNode; assistant: ReactNode; model?: ReactNode; detail?: ReactNode; beforeSubmit?: ReactNode; submit: ReactNode; onRefresh?: () => void; onManage?: () => void; disabled?: boolean; refreshing?: boolean; presentation?: "dock" | "expanded"; requestPresentation?: (intent: PanelPresentationIntent) => void;};Axis3
export type Axis3 = "x" | "y" | "z";AxisDragConstraint
gizmo 轴拖动约束(与 Rust AxisDragConstraint 同构)。
export type AxisDragConstraint = { axis: string; direction: [ number, number ]; worldPerPixel: number;};BackgroundActivityJob
export type BackgroundActivityJob = { id: string; canvasId: string; kind: BackgroundActivityKind; title: string; status: BackgroundActivityStatus; progress?: number; detail?: string; nodeId?: string; updatedAt: string;};关联类型:BackgroundActivityKind · BackgroundActivityStatus
成员说明:
id:稳定身份:同一目标(如某镜头当前版本)只保留一条记录。canvasId:事件按画布过滤,避免跨画布串台。title:主行文案,例如「片场 · 镜头 1」。progress:进度 0..1;缺失时不显示百分比。detail:可读细节(如失败原因);缺失不显示。nodeId:可定位的画布节点(可选);浮层只做定位,不做任务详情。
BackgroundActivityKind
已知后台活动种类;新增种类时同步扩展浮层的动作文案。
export type BackgroundActivityKind = "shot-reference-recording";BackgroundActivityStatus
后台活动状态;与任务活动同构,供浮层复用状态灯与文案。
export type BackgroundActivityStatus = "queued" | "running" | "succeeded" | "failed" | "cancelled";BevyAggregateConnect
多选聚合拉线瞬时投影。
字段存在即表示应显示选区左右聚合把手;direction 表示正在拖拽的方向(null 表示仅显示
把手);cursor 为拖拽中的指针世界坐标;pendingEdges 为拖拽中命中的合法预览边。
Bevy 只被动消费该投影,不执行碰撞、不展开成员、不分配 edge id。
它是浏览器本地可丢弃状态,不进入 canonical Canvas / Y.Doc / IndexedDB。
export type BevyAggregateConnect = { direction: AggregateConnectDirection | null; cursor?: { x: number; y: number; }; pendingEdges: BevyAggregateConnectEdge[];};关联类型:AggregateConnectDirection · BevyAggregateConnectEdge
成员说明:
direction:正在拖拽的方向;仅显示把手时为null。cursor:拖拽中的指针世界坐标(仅拖拽中存在)。pendingEdges:拖拽中命中的待提交边预览。
BevyAggregateConnectEdge
聚合拉线待提交连线。 只承载虚线预览所需的最小身份:稳定 edge id 与有向端点对。
export type BevyAggregateConnectEdge = { id: string; source: string; target: string;};BevyAnimationPlayback
活动动画节点播放瞬时投影。
这是浏览器本地呈现态:只承载活动动画节点的稳定 canonical nodeId、本地时钟与已校验
的 WooHaa3-motion-ir-v1。Bevy 据此为该节点独立求值模型姿态与镜头;不进入 ServerCanvas /
CanvasCommand / Y.Doc。缺省表示当前无活动动画节点。
export type BevyAnimationPlayback = { clipId?: string; sourceIdentity?: string; generation?: number; viewMode?: "overview-observer" | "focus-preview"; nodeId: string; version: string; time: number; duration: number; looped: boolean; playing: boolean; backdrop?: string; initialCamera: { aspect?: string; azimuth: number; elevation: number; distance: number; focusOffset: [ number, number, number ]; }; cameraMotion: MotionIr["cameraMotion"]; modelMotion: MotionIr["modelMotion"];};关联类型:MotionIr
成员说明:
nodeId:活动动画节点 canonical id。version:Motion IR 版本(WooHaa3-motion-ir-v1);Bevy 据此刻意拒绝未知版本。time:当前时间(秒)。duration:时间线时长(秒)。backdrop:所播放镜头背景的具体色(#rrggbb);缺省即跟随主题。initialCamera:初始镜头(第 0 秒)。cameraMotion:已校验的镜头轨道(默认值已补齐)。modelMotion:已校验的模型轨道(默认值已补齐)。
BevyDragAttach
单节点拖动中的 Q/E 触碰粘连瞬时投影 。
字段存在即表示应显示底部操作条;mode 决定活动提示与触须侧;contactNodeId
驱动接触反馈;pendingEdges 绘制立即可见的虚线预览。Bevy 只被动消费该投影,
不执行碰撞、不锁定目标、不分配 edge ID。它是浏览器本地可丢弃状态,不进入
canonical Canvas / Y.Doc / IndexedDB cache,也不改变业务 revision。
export type BevyDragAttach = { nodeId: string; mode: DragAttachMode | null; contactNodeId?: string; pendingEdges: BevyDragAttachEdge[];};关联类型:DragAttachMode · BevyDragAttachEdge
成员说明:
nodeId:当前被拖动的节点 id。mode:当前活动粘连方向;未按住 Q/E 时为null(仅显示操作条)。contactNodeId:当前触须接触到的合法目标节点 id;无接触时缺省。pendingEdges:本次拖动已锁定的待提交边(按锁定顺序)。
BevyDragAttachEdge
拖动粘连待提交连线。
只承载绘制虚线预览所需的最小身份:稳定 edge id 与有向端点对。
export type BevyDragAttachEdge = { id: string; source: string; target: string;};BevyEdgeHover
连线悬停瞬时态。
指针下是某条连线(或其删除按钮)时携带,用于让 Bevy 在连线中点绘制删除按钮。 同样只承载浏览器本地呈现态,不进入 ServerCanvas / Y.Doc。
export type BevyEdgeHover = { edgeId: string; cursor?: { x: number; y: number; };};成员说明:
edgeId:指针下的连线 id。cursor:Pointer world position; the delete control follows the selected curve.