跳转到内容

签名关联类型: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 on version-conflict when 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;
}

关联类型:AssistantWorldPatchMatch

成员说明:

  • occurrences:How many times oldString occurred (0 for not-found, >1 for ambiguous).
  • matches:Occurrence positions, bounded.
  • closest:Nearest similar excerpt, present for patch-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 composes current + chunk. Exact-text patch: oldString must 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;
};

关联类型:PanelPresentationIntent

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.