签名关联类型: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 formode: "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"; };};AgentModelCapabilitySource
export type AgentModelCapabilitySource = (typeof AGENT_MODEL_CAPABILITY_SOURCES)[number];