跳转到内容

签名关联类型:NotificationServiceHandle – PrincipalContext

本页由当前 SDK 声明自动生成。

返回接口索引

NotificationServiceHandle · OscillateMode · PageCapturePendingEntry · PageCapturePendingResult · ParameterJournalEntry · ParameterPatch · ParameterPresentation · ParameterPreviewEntry · PayloadValidator · PluginIconAsset · PluginIconName · Point · PointHit · PopoverCommonProps · PptaskParameterControl · PreparationPhase · PreparationState · PreparedAgentRoleTurn · PreparedModelMetadata · PreparedModelResource · PreparedModelResourceVersion · PreparedSomaMotion · PresentableParameter · PrincipalContext

NotificationServiceHandle

export type NotificationServiceHandle = TaskNotificationService & {
start(): Promise<void>;
handleScopeChange(): Promise<void>;
};

关联类型:TaskNotificationService

成员说明:

  • deliveries:最近投递(诊断/回归;有界)。
  • start:启动观察(App scope 装配后调用一次)。
  • handleScopeChange:数据范围变化(账号切换):重读偏好并为新范围重建基线。

OscillateMode

export type OscillateMode = "position" | "rotation" | "scale";

PageCapturePendingEntry

页面驱动取景:宿主登记的待渲染镜头项。

export type PageCapturePendingEntry = {
attemptId?: string;
canvasId: string;
cameraId: string;
key: import("@woohaa3/contracts").WorldCaptureVersionKey;
width: number;
height: number;
kind?: "static" | "dynamic";
dynamicKey?: import("@woohaa3/contracts").WorldCaptureDynamicVersionKey;
fps?: number;
timeRange?: import("@woohaa3/contracts").WorldCaptureTimeRange;
animationNodeId?: string;
};

关联类型:WorldCaptureVersionKey · WorldCaptureDynamicVersionKey · WorldCaptureTimeRange

PageCapturePendingResult

export type PageCapturePendingResult = {
ok: true;
captures: PageCapturePendingEntry[];
} | {
ok: false;
code: string;
error: string;
};

关联类型:PageCapturePendingEntry

ParameterJournalEntry

export type ParameterJournalEntry = {
kind: "parameter";
id: string;
label: string;
nodeId: string;
modelKey: string;
before: Record<string, unknown>;
after: Record<string, unknown>;
revision?: number;
undoRevision?: number;
state: JournalEntryState;
};

关联类型:JournalEntryState

成员说明:

  • nodeId:参数分区身份。

ParameterPatch

参数面板产生的一次瞬时/提交 patch。

export type ParameterPatch = {
modelPlacement?: ModelPlacementDraft;
};

关联类型:ModelPlacementDraft

ParameterPresentation

export type ParameterPresentation = {
section?: "common" | "advanced";
order?: number;
summaryOrder?: number;
semanticId?: string;
control?: "segmented" | "search-select" | "slider" | "number" | "switch" | "textarea";
};

ParameterPreviewEntry

export type ParameterPreviewEntry = {
patch: ParameterPatch;
deadline: number;
};

关联类型:ParameterPatch

PayloadValidator

类型化 payload 校验:返回规范化 payload 或错误信息。

export type PayloadValidator<T = unknown> = (payload: unknown) => {
ok: true;
payload: T;
} | {
ok: false;
error: string;
};

PluginIconAsset

品牌图形路径(固定前缀下的站点内路径,如 /plugin-icons/litellm.png)。

export type PluginIconAsset = `${typeof PLUGIN_ICON_ASSET_PREFIX}${string}`;

PluginIconName

export type PluginIconName = (typeof PLUGIN_ICON_NAMES)[number];

Point

export type Point = {
x: number;
y: number;
};

PointHit

2D 点命中语义结果;与 Rust PointHit 的 serde 输出同构 。

export type PointHit = {
kind: "scene-area-playback";
nodeId: string;
control: "play" | "loop" | "track" | "body";
track: [
number,
number,
number,
number
];
} | {
kind: "node";
nodeId: string;
} | {
kind: "history";
nodeId: string;
} | {
kind: "port";
nodeId: string;
side: "input" | "output";
} | {
kind: "resize";
nodeId: string;
handle?: "nw" | "ne" | "sw" | "se";
} | {
kind: "edge";
edgeId: string;
} | {
kind: "edge-delete";
edgeId: string;
} | {
kind: "aggregate-handle";
direction: "input" | "output";
} | {
kind: "node-action";
nodeId: string;
actionId: string;
menu: boolean;
};

PopoverCommonProps

type PopoverCommonProps = {
open: boolean;
onOpenChange: (open: boolean) => void;
children: ReactNode;
side?: "top" | "right" | "bottom" | "left";
align?: "start" | "center" | "end";
sideOffset?: number;
className?: string;
label?: string;
dismissOnOutside?: boolean;
dismissOnEscape?: boolean;
restoreFocus?: boolean;
autoFocus?: boolean;
keepMounted?: boolean;
testId?: string;
};

成员说明:

  • open:受控 open。
  • className:popup 追加 class。
  • label:popup 可访问名(role="dialog" 的 aria-label)。
  • dismissOnOutside:是否在 outside pointerdown 时请求关闭(默认 true)。
  • dismissOnEscape:Escape 请求关闭(默认 true)。
  • restoreFocus:关闭后焦点是否回到 trigger(默认 true)。
  • autoFocus:Hover previews must not move keyboard focus into the popup.
  • keepMounted:Keep child state and ongoing operations alive while the popup is closed.
  • testId:测试标识。

PptaskParameterControl

语义控件种类。

export type PptaskParameterControl = "aspect-ratio" | "resolution" | "quality" | "background" | "voice";

PreparationPhase

export type PreparationPhase = (typeof PREPARATION_PHASES)[number];

PreparationState

稳定的准备状态;失败携带稳定 code 与 retryable。

export type PreparationState = {
state: "ready";
canvasId: string;
revision: number;
} | {
state: "preparing";
jobId: string;
phase: PreparationPhase;
completedMedia: number;
totalMedia: number;
pollAfterMs: number;
} | {
state: "failed";
code: string;
retryable: boolean;
message: string;
} | {
state: "deleted";
code: "DELETED";
};

关联类型:PreparationPhase

PreparedAgentRoleTurn

宿主准备完成、可重放的角色回合。

可序列化部分不含秘密:工具授权(grant token)、MCP 地址与凭据仍由执行通道的既有时序签发, 浏览器请求不得构造或改写本对象。

export type PreparedAgentRoleTurn = {
readonly workspace?: CanvasWorkspaceHandle;
readonly schemaVersion: 1;
readonly roleRef: AgentRoleRef;
readonly messages: readonly AgentPromptMessage[];
readonly tools: readonly string[];
readonly nativeCapabilities: readonly AgentNativeCapability[];
readonly output: AgentRoleOutput;
readonly inputDigest: string;
readonly contextDigest: string;
readonly attachmentDigests: readonly string[];
readonly target: AgentRoleTargetRef;
readonly preparedHash: string;
};

关联类型:CanvasWorkspaceHandle · AgentRoleRef · AgentPromptMessage · AgentNativeCapability · AgentRoleOutput · AgentRoleTargetRef

成员说明:

  • workspace:Trusted desktop auxiliary capability, frozen by the host after role preparation.
  • messages:已合成的规范消息(definition.instructions 在最前)。
  • tools:求交后的工具集合(角色允许 ∩ prepare 收窄 ∩ 授权 ∩ 通道能力 ∩ 实际目录)。
  • attachmentDigests:宿主准备的附件身份摘要;字节沿原附件通道传递。

PreparedModelMetadata

Rust prepare_and_register_model_resource 返回的轻量 metadata。

export type PreparedModelMetadata = {
resourceVersion: string;
resourceKey: string;
sceneVersion: string;
signature: string;
extent: number;
aabb: Aabb | null;
};

关联类型:Aabb

PreparedModelResource

不可变 prepared model resource。

  • resourceKey = sceneVersion:signature,不含节点 ID:内容相同的多个节点共享资源; placement / instance 生命周期仍按节点独立。
  • signature:只覆盖模型内容(Scene IR/version/材质/动画),不含 placement / viewport。
  • aabb / extent:与 signature 同一份规范化结果派生,供相机取景与渲染复用。
  • payload:注册到 Bevy 的完整 descriptor(含 ops),避免注册时再次序列化。
export type PreparedModelResource = {
resourceVersion: PreparedModelResourceVersion;
sceneVersion: string;
signature: string;
resourceKey: string;
ops: readonly SceneV2Op[];
aabb: Aabb | null;
extent: number;
payload: string;
};

关联类型:PreparedModelResourceVersion · SceneV2Op · Aabb

成员说明:

  • payload:注册 payload(与 modelResourcePayload 一致);只用于跨 WASM 传输。

PreparedModelResourceVersion

export type PreparedModelResourceVersion = typeof PREPARED_MODEL_RESOURCE_VERSION;

PreparedSomaMotion

export interface PreparedSomaMotion {
fps: number;
frameCount: number;
durationSeconds: number;
jointNames: string[];
faces: Uint32Array;
bindVertices: Float32Array;
globalRotations: Float32Array;
posedJoints: Float32Array;
bindTransforms: Float64Array;
localRotations: Float64Array;
rootPositions: Float64Array;
parents: Int32Array;
order: number[];
indices: Uint32Array;
weights: Float32Array;
restOffsets: Float64Array;
}

成员说明:

  • globalRotations:Internal validated row-major buffers; callers must treat prepared data as immutable.

PresentableParameter

export type PresentableParameter = {
key: string;
label: string;
type?: string;
unit?: string;
defaultValue?: unknown;
schema?: Record<string, unknown>;
presentation?: ParameterPresentation;
options?: readonly {
value: string;
label: string;
}[];
minimum?: number;
maximum?: number;
step?: number;
integer?: boolean;
hiddenWhen?: readonly {
field: string;
equals: unknown;
}[];
requiresByValue?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
};

关联类型:ParameterPresentation

成员说明:

  • schema:Original property schema, used for constraints beyond the basic control.

PrincipalContext

宿主体内的可信、冻结principal 上下文 。

只由 identity provider 建立;包含有效期与会话绑定。刻意不含 isAdmin/管理员角色:管理权 是 site-access 的授权结果,不是认证结果。核心 MUST NOT 依据角色判定管理权。

export type PrincipalContext = {
subject: string;
displayName?: string;
identityProvider: string;
sessionId?: string;
validUntil?: number;
attributes?: Readonly<Record<string, string>>;
};

成员说明:

  • subject:应用用户 owner 依据(已验证的稳定主体;不是显示名或客户端自报字段)。
  • displayName:已验证可得名称(展示用;不参与 owner 选择)。
  • identityProvider:建立该 principal 的 identity provider identity(extensionId/providerId)。
  • sessionId:会话绑定(OAuth 事务与撤权隔离用)。
  • validUntil:身份有效期(epoch ms);到期后受保护连接停止。
  • attributes:已验证的附加属性(有界字符串;由 provider 决定语义)。