跳转到内容

后端 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 for mode: "world".
  • credentialEpoch:绑定的连接代次(可选;变更后旧委托失效)。