后端 web-contracts-src-extension-assistant-authoring
本页由当前 SDK 声明自动生成。 导入入口:@woohaa3/contracts。
ApplicationAuthoringNodeRead · ApplicationAuthoringServices · ApplicationAuthoringWriteContext · ApplicationAuthoringWriteOutcome · ApplicationCanvasAuthoringFacade · ApplicationMediaReferenceFacade · ApplicationPersonalGenerationFacade · ApplicationToolDelegationFacade · ApplicationToolGrant · ApplicationToolGrantRequest
ApplicationAuthoringNodeRead
权威节点上下文读取结果。
export type ApplicationAuthoringNodeRead = { ok: true; nodeType: string; title: string; prompt: string; source?: string; references: ReadonlyArray<{ kind: string; role?: string; text?: string; url?: string; mediaKind?: string; mediaType?: string; }>; modelContentVersion?: ModelContentVersion; snapshotHash?: string;} | { ok: false; code: string; message: string;};关联类型:ModelContentVersion
ApplicationAuthoringServices
Context 暴露给插件的 authoring/工具/个人生成端口集合。
export type ApplicationAuthoringServices = { authoring: ApplicationCanvasAuthoringFacade; references: ApplicationMediaReferenceFacade; tools: ApplicationToolDelegationFacade; personalGeneration: ApplicationPersonalGenerationFacade;};关联类型:ApplicationCanvasAuthoringFacade · ApplicationMediaReferenceFacade · ApplicationToolDelegationFacade · ApplicationPersonalGenerationFacade
ApplicationAuthoringWriteContext
一次 authoring 写入的公共上下文(用户委托 + 工作 + 稳定 operationId)。
export type ApplicationAuthoringWriteContext = { delegation: ApplicationUserDelegation; workId?: string; operationId: string;};关联类型:ApplicationUserDelegation
成员说明:
workId:宿主绑定的工作 identity(可选;准入后由工作关联提供)。operationId:稳定操作 id(幂等作用域)。
ApplicationAuthoringWriteOutcome
export type ApplicationAuthoringWriteOutcome = { ok: true; canvasId: string; nodeId: string; commandId: string; duplicate: boolean; noop: boolean; revision?: number;} | { ok: false; code: string; message: string; failedIndex?: number;};ApplicationCanvasAuthoringFacade
export type ApplicationCanvasAuthoringFacade = { readNode(input: { delegation: ApplicationUserDelegation; canvasId: string; nodeId: string; }): Promise<ApplicationAuthoringNodeRead>; submitModel(input: ApplicationAuthoringWriteContext & { canvasId: string; nodeId: string; source: string; expectedModelContentHash?: string; }): Promise<ApplicationAuthoringWriteOutcome>; receipt(input: { delegation: ApplicationUserDelegation; canvasId: string; nodeId: string; operationId: string; }): Promise<{ ok: true; committed: boolean; commandId?: string; revision?: number; } | { ok: false; code: string; message: string; }>;};关联类型:ApplicationUserDelegation · ApplicationAuthoringNodeRead · ApplicationAuthoringWriteContext · ApplicationAuthoringWriteOutcome
成员说明:
receipt:按工作/operationId 查询已提交回执(恢复/重连用)。
ApplicationMediaReferenceFacade
稳定媒体引用到受限推理输入的解析(不交出 COS 凭据/内部令牌)。
export type ApplicationMediaReferenceFacade = { resolve(input: { delegation: ApplicationUserDelegation; storageKey: string; }): Promise<{ ok: true; url: string; mediaType?: string; mediaKind?: string; expiresAt?: number; } | { ok: false; code: string; message: string; }>;};关联类型:ApplicationUserDelegation
ApplicationPersonalGenerationFacade
个人生成能力:账户模型目录与可执行性按可信 owner 隔离,不进入共享 catalog。
export type ApplicationPersonalGenerationFacade = { models(input: { delegation: ApplicationUserDelegation; }): Promise<{ models: Array<{ id: string; label: string; }>; error?: string; }>; executable(input: { delegation: ApplicationUserDelegation; }): Promise<boolean>;};关联类型:ApplicationUserDelegation
成员说明:
models:账户可用模型(使用当前 owner 的有效凭据查询)。executable:是否可执行(凭据/订阅就绪)。
ApplicationToolDelegationFacade
export type ApplicationToolDelegationFacade = { issue(request: ApplicationToolGrantRequest): Promise<ApplicationToolGrant>; revoke(workId: string, delegation?: ApplicationUserDelegation): void; authorize(input: { token: string; tool: string; canvasId?: string; nodeId?: string; cameraId?: string; clipId?: string; itemId?: string; }): { ok: true; } | { ok: false; reason: string; };};关联类型:ApplicationToolGrantRequest · ApplicationToolGrant · ApplicationUserDelegation
成员说明:
issue:签发一个受控工具 grant(寿命等于活动执行,不设调用额度或固定时钟到期)。revoke:撤销某工作的 grant(断开/取消/收尾)。authorize:工具入口强制校验(design D8):绑定 token/tool/目标范围与当前撤销状态。 工具入口 MUST 在每次操作前调用它,而不是只在会话建立时校验。校验不消耗任何额度。
ApplicationToolGrant
MCP 工具委托(grant):宿主签发、工具入口验证 。
绑定 plugin/version/work/owner/目标与允许工具;只进入受限子进程环境,不进入浏览器、日志或 公开 DTO。委托不携带调用额度,也不按固定时钟失效:寿命等于活动执行本身,由取消、终态、 撤权与连接代次决定。工具入口每次操作仍重新检查权限与失效状态。
export type ApplicationToolGrant = { token: string; canvasIds: readonly string[]; nodeIds: readonly string[]; cameraId?: string; clipId?: string; itemId?: string; tools: readonly string[]; workId: string; subject?: string; credentialEpoch?: number; world?: AssistantWorldGrantBinding; groupScope?: { canvasId: string; rootGroupId: string; scopeEpoch: number; };};关联类型:AssistantWorldGrantBinding
成员说明:
canvasIds:允许访问的画布集合。nodeIds:允许访问的节点集合(空=该画布任意节点)。tools:允许调用的工具名集合。workId:绑定的工作/回合身份(撤销按它定位;不进入模型提示词)。subject:绑定的可信 owner;撤销与跨 owner 隔离据此判定。credentialEpoch:绑定的连接代次;连接重建后旧委托不可继续使用。world:Host-issued world run binding for scoped assistant authoring. The token is minted only after the host acquired the scope/version/lease context; tools read the context from this binding, never from model-supplied arguments.groupScope:2D 组作用域绑定:工具读写被限制在根组与memberNodeIds成员内。 与world互斥;组作用域不授予共享世界写资格。
ApplicationToolGrantRequest
export type ApplicationToolGrantRequest = { mode?: AgentTargetMode; expectedScopeEpoch?: number; delegation: ApplicationUserDelegation; workId: string; canvasId: string; nodeId: string; cameraId?: string; clipId?: string; itemId?: string; tools?: readonly string[]; worldScope?: AssistantWorldScopeSelection; allowSceneAreaExpansion?: boolean; credentialEpoch?: number;};关联类型:AgentTargetMode · ApplicationUserDelegation · AssistantWorldScopeSelection
成员说明:
worldScope:Trusted world scope selection formode: "world".credentialEpoch:绑定的连接代次(可选;变更后旧委托失效)。