跳转到内容

签名关联类型:Aabb – AgentModelCapabilitySource

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

返回接口索引

Aabb · AccessAction · AccessDecision · AgentAdapterAuthState · AgentAdapterCapabilities · AgentApiType · AgentCatalogResponse · AgentConnectionAuthMode · AgentConnectionBinding · AgentConnectionCapabilities · AgentConnectionModel · AgentConnectionRunCategory · AgentConnectionRuntime · AgentConnectionStatus · AgentConnectionStatusEvidence · AgentConnectionStatusKind · AgentConnectionStatusState · AgentConnectionView · AgentEngineId · AgentEntryAction · AgentEntryIntent · AgentEntryReference · AgentMcpStatusResponse · AgentModelCapabilitySource

Aabb

轴向包围盒(含 min/max)。

export type Aabb = {
min: Vec3;
max: Vec3;
};

关联类型:Vec3

AccessAction

export type AccessAction = (typeof ACCESS_ACTIONS)[number];

AccessDecision

站点 action 决策。provider 故障与用户无权限必须区分(503 vs 403)。

export type AccessDecision = {
allowed: true;
} | {
allowed: false;
code: "unauthenticated";
} | {
allowed: false;
code: "forbidden";
} | {
allowed: false;
code: "provider-unavailable";
message?: string;
};

AgentAdapterAuthState

export type AgentAdapterAuthState = (typeof AGENT_ADAPTER_AUTH_STATES)[number];

AgentAdapterCapabilities

export type AgentAdapterCapabilities = {
textDelivery?: AssistantTextCapabilities;
candidateGeneration?: {
imageInput: boolean;
maxImages: number;
};
discussion: boolean;
targets: readonly AgentTargetMode[];
tools: boolean;
workspace?: boolean;
models: "remote" | "none";
nativeCapabilities?: readonly AgentNativeCapability[];
};

关联类型:AssistantTextCapabilities · AgentTargetMode · AgentNativeCapability

成员说明:

  • textDelivery:Candidate generation uses the same connection/runtime, without canvas tools.
  • workspace:Local harness accepts a host-resolved cwd and provides its own file/shell tools.
  • nativeCapabilities:通道真实支持的内建执行能力。 角色声明与本集合求交;缺省表示不支持任何内建能力(不从旧回合继承)。

AgentApiType

export type AgentApiType = keyof typeof AGENT_API_ENGINES;

AgentCatalogResponse

目录/授权/能力查询响应(GET /catalog)。

export type AgentCatalogResponse = {
models: AgentModelView[];
capabilityRevision?: string;
error?: string;
authState: AgentAdapterAuthState;
capabilities: AgentAdapterCapabilities;
};

关联类型:AgentModelView · AgentAdapterAuthState · AgentAdapterCapabilities

AgentConnectionAuthMode

export type AgentConnectionAuthMode = (typeof AGENT_CONNECTION_AUTH_MODES)[number];

AgentConnectionBinding

一次回合冻结的连接身份。

与目标、模型一起纳入请求幂等指纹:同一 requestId 换连接/配置/凭据版本 MUST 拒绝, 不切换凭据、不重新推理。原生会话 id 是执行索引,不能跨连接或 owner 复用。

没有连接身份的历史行不会自动绑定或发起新执行。

export type AgentConnectionBinding = {
connectionId: string;
adapterId: string;
configRevision: number;
credentialEpoch: number;
capabilityRevision?: string;
};

成员说明:

  • adapterId:解析该连接的 adapter 稳定 id(与 ConversationSummary.adapterId 一致)。
  • configRevision:冻结时的非秘密配置 revision。
  • credentialEpoch:冻结时的凭据 epoch(替换/清除密钥使旧运行失效)。
  • capabilityRevision:冻结时该模型 reasoning 能力快照的修订号;旧回合缺省表示能力未知。

AgentConnectionCapabilities

连接声明的能力。

与既有 AgentAdapterCapabilities 分开:后者描述 adapter 的通用能力,本类型额外覆盖图片输入、 结构化结果、取消与恢复,供生成入口在发送前做目标/输入预检(design D3/D8)。

export type AgentConnectionCapabilities = {
textDelivery?: AssistantTextCapabilities;
discussion: boolean;
imageInput: boolean;
tools: boolean;
structuredResult: boolean;
cancel: boolean;
resume: boolean;
targets?: readonly AgentTargetMode[];
};

关联类型:AssistantTextCapabilities · AgentTargetMode

成员说明:

  • targets:通道支持的显式目标模式;缺省表示未声明(调用方不得据此猜测)。

AgentConnectionModel

连接可见模型:能力、来源与账号授权分离。

export type AgentConnectionModel = {
reasoningEfforts?: readonly AgentReasoningEffort[];
reasoning?: AgentReasoningCapability;
id: string;
label: string;
source: AgentModelCapabilitySource;
accountAuthorized: boolean;
capabilities?: Partial<Pick<AgentConnectionCapabilities, "imageInput" | "tools" | "structuredResult" | "textDelivery">>;
};

关联类型:AgentReasoningEffort · AgentReasoningCapability · AgentModelCapabilitySource · AgentConnectionCapabilities

成员说明:

  • accountAuthorized:该模型是否属于账号已授权能力。 user-provided / builtin 目标准入前不得标 true(避免手填模型冒充已授权)。
  • capabilities:模型级能力覆盖(缺省继承连接能力)。

AgentConnectionRunCategory

export type AgentConnectionRunCategory = (typeof AGENT_CONNECTION_RUN_CATEGORIES)[number];

AgentConnectionRuntime

无秘密的运行时证据;缺少依赖不得用 HTTP 推理降级。

export type AgentConnectionRuntime = {
schemaVersion: 1;
apiType: AgentApiType;
engine: AgentEngineId;
engineVersion: string;
dependency: AgentConnectionStatusEvidence;
tasks: Record<"discussion" | "imageInput" | "targetExecution", AgentConnectionStatusEvidence>;
};

关联类型:AgentApiType · AgentEngineId · AgentConnectionStatusEvidence

AgentConnectionStatus

四类证据的完整快照。

export type AgentConnectionStatus = Record<AgentConnectionStatusKind, AgentConnectionStatusEvidence>;

关联类型:AgentConnectionStatusKind · AgentConnectionStatusEvidence

AgentConnectionStatusEvidence

export type AgentConnectionStatusEvidence = {
state: AgentConnectionStatusState;
checkedAt?: string | null;
reason?: string;
};

关联类型:AgentConnectionStatusState

成员说明:

  • checkedAt:采集时间(ISO);未检查时为 null。
  • reason:可读原因(失败/待处理);不携带凭据。

AgentConnectionStatusKind

export type AgentConnectionStatusKind = (typeof AGENT_CONNECTION_STATUS_KINDS)[number];

AgentConnectionStatusState

export type AgentConnectionStatusState = (typeof AGENT_CONNECTION_STATUS_STATES)[number];

AgentConnectionView

公开连接视图:不含任何秘密。

客户端自报 owner、显示名、模型名或服务地址都不是凭据归属依据;本视图由后端按可信 owner 投影,credentialConfigured 只表示「已保存」,不回读明文 Key。

export type AgentConnectionView = {
connectionId: string;
serviceConnectionId?: string;
runtime?: AgentConnectionRuntime;
adapterId: string;
extensionId: string;
name: string;
runCategory: AgentConnectionRunCategory;
authMode: AgentConnectionAuthMode;
configRevision: number;
credentialEpoch: number;
status: AgentConnectionStatus;
ready: boolean;
capabilities: AgentConnectionCapabilities;
models: readonly AgentConnectionModel[];
capabilityRevision?: string;
modelsError?: string;
credentialConfigured: boolean;
endpointAllowed?: boolean;
reason?: string;
};

关联类型:AgentConnectionRuntime · AgentConnectionRunCategory · AgentConnectionAuthMode · AgentConnectionStatus · AgentConnectionCapabilities · AgentConnectionModel

成员说明:

  • connectionId:稳定连接身份(不从显示名/地址/token 推导)。
  • serviceConnectionId:来自服务连接来源的连接投影到该来源身份;本地 Agent 与旧连接可能缺省。
  • runtime:旧记录缺省;仅投影已由贡献方核验的引擎证据。
  • adapterId:解析 adapter 的稳定 id。
  • extensionId:贡献该连接的扩展 id。
  • configRevision:非秘密配置 revision(修改接入方式/配置递增)。
  • credentialEpoch:凭据 epoch(替换/清除密钥递增;同一 epoch 才可复用原生会话)。
  • ready:当前动作所需能力是否满足;仅当所需证据为 ready 时成立。
  • capabilityRevision:当前模型目录 reasoning 能力快照的修订号;旧记录缺省。
  • modelsError:目录读取失败原因(保留原选择,不自动换模型)。
  • credentialConfigured:是否已保存凭据(不返回明文)。
  • endpointAllowed:自定义 base URL 是否通过部署允许策略。 缺省 undefined 表示无自定义 endpoint。
  • reason:不可就绪原因(展示用)。

AgentEngineId

export type AgentEngineId = (typeof AGENT_API_ENGINES)[AgentApiType];

关联类型:AgentApiType

AgentEntryAction

export type AgentEntryAction = (typeof AGENT_ENTRY_ACTIONS)[number];

AgentEntryIntent

生成面板/详情提交的 entry intent(首轮与详情后续消息共用)。

export type AgentEntryIntent = {
connection?: AgentConnectionBinding;
action: AgentEntryAction;
canvasId: string;
nodeId?: string;
mode?: AgentTargetMode;
cameraId?: string;
clipId?: string;
itemId?: string;
worldScope?: AssistantWorldScopeSelection;
allowSceneAreaExpansion?: boolean;
model?: string;
reasoningEffort?: AgentReasoningEffort;
connectionId?: string;
roleId?: string;
expectedContentHash?: string;
prompt: string;
references?: readonly AgentEntryReference[];
};

关联类型:AgentConnectionBinding · AgentEntryAction · AgentTargetMode · AssistantWorldScopeSelection · AgentReasoningEffort · AgentEntryReference

成员说明:

  • connection:Optional public version assertion; the host still resolves ownership and credentials.
  • nodeId:目标节点;纯讨论可为空。
  • worldScope:Trusted world scope selection for mode: "world" (see AgentTargetSnapshot).
  • allowSceneAreaExpansion:Explicit per-turn permission; omitted on older turns means false.
  • model:冻结的账户模型 id(来自真实目录);缺失时由 adapter 按当前目录处理或拒绝。
  • connectionId:显式选定的来源连接;新请求缺失时拒绝。
  • roleId:显式选定的完整角色 id(<extensionId>/<roleId>)。 业务入口必须提交明确角色;核心不按 mode 猜角色,也不接受把连接 id 当角色。
  • references:显式引用(不从节点版本伪造历史)。

AgentEntryReference

引用输入:稳定 storageKey 或上游节点身份;不携带 URL/凭据。

export type AgentEntryReference = {
kind: "asset" | "node";
storageKey?: string;
nodeId?: string;
role?: string;
};

成员说明:

  • storageKey:kind=asset:稳定 storageKey。
  • nodeId:kind=node:上游节点 id。

AgentMcpStatusResponse

GET /mcp 的宿主投影:内置真实发现 + 外部连接指引(复制不等于外部已连接)。

export type AgentMcpStatusResponse = {
builtin: McpBuiltinDiscoveryView;
external: {
serverUrl: string;
transport: "streamable-http";
};
};

关联类型:McpBuiltinDiscoveryView

AgentModelCapabilitySource

export type AgentModelCapabilitySource = (typeof AGENT_MODEL_CAPABILITY_SOURCES)[number];