签名关联类型:TaskExecutionSource – TaskResultSummary
本页由当前 SDK 声明自动生成。
TaskExecutionSource · TaskExecutionState · TaskExecutionSummary · TaskExecutionTiming · TaskHistoryCandidateExtension · TaskHistoryCandidateModel · TaskHistoryCandidateProvider · TaskHistoryCandidateQuery · TaskHistoryCandidates · TaskHistoryConnectionState · TaskHistoryConnectionStatus · TaskHistoryDetailResult · TaskHistoryFilter · TaskHistoryPage · TaskHistoryQuery · TaskHistoryReader · TaskInspectionFacade · TaskInspectionSnapshot · TaskMediaState · TaskModelType · TaskRequestInput · TaskRequestSummary · TaskResultLocation · TaskResultSummary
TaskExecutionSource
export type TaskExecutionSource = (typeof TASK_EXECUTION_SOURCES)[number];TaskExecutionState
export type TaskExecutionState = (typeof TASK_EXECUTION_STATES)[number];TaskExecutionSummary
列表项:足以渲染表格与筛选,不含事件时间线。
export type TaskExecutionSummary = { taskKey: string; state: TaskExecutionState; providerId: string; providerName?: string; modelType?: TaskModelType; modelKey?: string; modelTitle?: string; canvasId?: string; canvasTitle?: string; nodeId?: string; nodeTitle?: string; runId?: string; upstreamTaskId?: string; progress?: number; attempt?: number; result?: TaskResultSummary; error?: TaskErrorSummary; source?: TaskExecutionSource; extensionId?: string; admission?: TaskAdmissionVersions; actor?: TaskExecutionActor; timing?: TaskExecutionTiming; createdAt: string; startedAt?: string; updatedAt: string; finishedAt?: string; durationMs: number; recordRevision: number;};关联类型:TaskExecutionState · TaskModelType · TaskResultSummary · TaskErrorSummary · TaskExecutionSource · TaskAdmissionVersions · TaskExecutionActor · TaskExecutionTiming
成员说明:
upstreamTaskId:上游 Provider 的任务号(如 RunningHub taskId / Ark task id)。 有它才能拿着历史去上游控制台对账。actor:可信受理 actor。 只来自冻结 delegation;旧记录缺失即{unknown:true},不反填为查看者。timing:生命周期时间与耗时。 旧记录缺失字段即不猜测;observedAt为同一次快照时刻。
TaskExecutionTiming
生命周期时间与耗时。
定义固定:total=受理至终态/observedAt;queue=首次执行开始前等待;execution=首次执行开始至
终态/observedAt(含重试等待);state=当前状态驻留(终态后不增长)。缺失可靠时间即 undefined。
export type TaskExecutionTiming = { admittedAt?: string; firstStartedAt?: string; stateChangedAt?: string; totalMs?: number; queueMs?: number; executionMs?: number; stateMs?: number; observedAt: string;};成员说明:
admittedAt:受理时间(旧记录可能缺失)。firstStartedAt:首次执行开始时间。stateChangedAt:状态最近变化时间。totalMs:受理至终态/observedAt(毫秒;负值钳 0)。queueMs:首次执行开始前等待。executionMs:首次执行开始至终态/observedAt(含重试等待)。stateMs:当前状态驻留。observedAt:观测时刻(与服务端同一快照)。
TaskHistoryCandidateExtension
插件来源候选(从历史受理事实投影;只含 extensionId,不含配置正文)。
export type TaskHistoryCandidateExtension = { extensionId: string;};TaskHistoryCandidateModel
export type TaskHistoryCandidateModel = { providerId: string; modelType: TaskModelType; modelKey: string; modelTitle?: string; providerName?: string;};关联类型:TaskModelType
TaskHistoryCandidateProvider
历史筛选候选:Provider 与模型(含保留期内已下线模型),不含 request 内容。
export type TaskHistoryCandidateProvider = { providerId: string; providerName?: string;};TaskHistoryCandidateQuery
候选查询(服务端做上限与校验)。
export type TaskHistoryCandidateQuery = { providerId?: string; modelType?: TaskModelType; limit?: number;};关联类型:TaskModelType
TaskHistoryCandidates
export type TaskHistoryCandidates = { providers: TaskHistoryCandidateProvider[]; models: TaskHistoryCandidateModel[]; plugins: TaskHistoryCandidateExtension[];};关联类型:TaskHistoryCandidateProvider · TaskHistoryCandidateModel · TaskHistoryCandidateExtension
成员说明:
plugins:plugin 来源的 extensionId(可能为空)。
TaskHistoryConnectionState
历史连接状态(页面顶部展示,带最近成功同步时间)。
export type TaskHistoryConnectionState = "connecting" | "live" | "reconnecting" | "polling" | "offline";TaskHistoryConnectionStatus
export type TaskHistoryConnectionStatus = { state: TaskHistoryConnectionState; lastSyncedAt?: string; error?: string;};关联类型:TaskHistoryConnectionState
成员说明:
lastSyncedAt:最近一次成功交付/同步时间(ISO)。error:连接或解码失败的最近原因(可诊断,不伪装健康)。
TaskHistoryDetailResult
export type TaskHistoryDetailResult = { ok: true; detail: TaskExecutionDetail;} | { ok: false; code: string; message: string;};关联类型:TaskExecutionDetail
TaskHistoryFilter
历史筛选:与契约 TaskHistoryQuery 对齐(不含 cursor/limit)。
export type TaskHistoryFilter = { state?: TaskExecutionState; states?: TaskExecutionState[]; providerId?: string; modelType?: TaskModelType; modelKey?: string; canvasId?: string; nodeId?: string; taskKey?: string; source?: TaskExecutionSource; extensionId?: string; from?: string; to?: string;};关联类型:TaskExecutionState · TaskModelType · TaskExecutionSource
TaskHistoryPage
分页结果:nextCursor 缺失表示已到末尾。
export type TaskHistoryPage = { items: TaskExecutionSummary[]; nextCursor?: string; watermark: number;};关联类型:TaskExecutionSummary
成员说明:
watermark:快照时刻的原子事件高水位;客户端据此启动可恢复订阅。
TaskHistoryQuery
历史查询筛选(服务端做上限与校验)。
export type TaskHistoryQuery = { cursor?: string; limit?: number; state?: TaskExecutionState; states?: TaskExecutionState[]; providerId?: string; modelType?: TaskModelType; modelKey?: string; canvasId?: string; nodeId?: string; taskKey?: string; source?: TaskExecutionSource; extensionId?: string; from?: string; to?: string;};关联类型:TaskExecutionState · TaskModelType · TaskExecutionSource
成员说明:
state:旧单一状态查询(与states互斥)。states:有界多状态集合(进行中=queued/pending/running)。taskKey:精确 taskKey 查找。source:执行来源筛选。extensionId:受信任插件身份筛选(仅 plugin 来源有意义)。from:ISO 时间;含边界。
TaskHistoryReader
export type TaskHistoryReader = { list(input?: TaskHistoryFilter & { cursor?: string; limit?: number; }, signal?: AbortSignal): Promise<TaskHistoryPage>; detail(taskKey: string, signal?: AbortSignal): Promise<TaskHistoryDetailResult>; candidates(query?: TaskHistoryCandidateQuery, signal?: AbortSignal): Promise<TaskHistoryCandidates>; subscribe(input: { cursor: number; onRecord: (record: TaskExecutionSummary, cursor: number) => void; onStatus?: (status: TaskHistoryConnectionStatus) => void; onResync?: () => void; onError?: (error: unknown) => void; }): () => void;};关联类型:TaskHistoryFilter · TaskHistoryPage · TaskHistoryDetailResult · TaskHistoryCandidateQuery · TaskHistoryCandidates · TaskExecutionSummary · TaskHistoryConnectionStatus
成员说明:
list:读取某一页;cursor是上一页nextCursor(opaque)。candidates:有界筛选候选(Provider/模型,含历史下线模型)。subscribe:从快照水位订阅已持久化变更。返回释放函数;释放会中止流请求、reader 与轮询 timer。 断线自动从最后确认 cursor 重连/补偿;无法续读时回调onResync要求重读快照。
TaskInspectionFacade
受限任务监控 facade。
只交给声明 tasks.inspect 的 extension;principal 由宿主从请求上下文注入(插件不得自报),
宿主在 repository 查询之前校验 site policy。facade 不交出 worker/store 句柄。
export type TaskInspectionFacade = { snapshot(input: { principal?: PrincipalContext; query?: TaskHistoryQuery; limit?: number; }): Promise<TaskInspectionSnapshot>; detail(input: { principal?: PrincipalContext; taskKey: string; }): Promise<TaskExecutionDetail | null>;};关联类型:PrincipalContext · TaskHistoryQuery · TaskInspectionSnapshot · TaskExecutionDetail
成员说明:
snapshot:全局一致快照 + 独立过滤列表(同一 observedAt)。detail:单条安全详情(可含预算内 request summary)。
TaskInspectionSnapshot
任务监控快照(同一次 observedAt;全局计数与过滤列表分开)。
stateCounts 来自全局聚合,不是当前页行数求和。
export type TaskInspectionSnapshot = { observedAt: string; stateCounts: Record<TaskExecutionState, number>; items: TaskExecutionDetail[]; nextCursor: string | null;};关联类型:TaskExecutionState · TaskExecutionDetail
TaskMediaState
二进制媒体材料化阶段。
只表示「provider 已产出、Task worker 正在把结果转存成稳定媒体」,任务本身仍是非终态。 有它时 UI 显示「媒体准备中」,成功媒体入口保持禁用;绝不能用它充当成功的第二份状态。
export type TaskMediaState = "materializing";TaskModelType
模型类型(与 catalog modelType 对齐)。
export type TaskModelType = "language" | "image" | "video" | "audio" | "motion";TaskRequestInput
参考输入安全摘要:只含稳定引用身份,不含执行期签出的 URL。
这是「这张图用了哪张素材」的溯源落点: 执行期的签名地址会过期,稳定引用不会。
export type TaskRequestInput = { role: string; mediaKind?: string; mediaType: string; assetId?: string; storageKey?: string;};TaskRequestSummary
请求参数安全摘要(仅出现在 operator/admin 详情,不在列表与事件流)。
export type TaskRequestSummary = { prompt: string; promptTruncated?: boolean; parameters: Record<string, unknown>; parametersTruncated?: boolean; inputs?: TaskRequestInput[]; worldCapture?: WorldCaptureGenerationBinding;};关联类型:TaskRequestInput · WorldCaptureGenerationBinding
成员说明:
promptTruncated:prompt 达到服务端上限被截断。parametersTruncated:parameters 达到预算被裁剪(键被剔除或深度/数量/字节受限)。inputs:稳定参考输入(顺序与提交一致)。worldCapture:Frozen static world framing used by this run (stable media/version metadata).
TaskResultLocation
产物字节的当前位置:哪个后端、什么键、能否给出 locator。
读取时现算,不落库:产物采纳后按内容寻址写进 media 命名空间,位置会随画布归属
(本地 / 托管)与主存储切换变化;持久化一个 locator 只会得到陈旧答案。
export type TaskResultLocation = { backendId: string; key: string; locator: string;};成员说明:
backendId:此刻承载字节的后端 id(local/cos/server…)。key:后端实际使用的键(已含 namespace)。locator:定位符media://<backendId>/<key>:展示与粘贴回存储层都用它。 后端实现locatorOf时用后端给的值;没实现时由宿主按同一形状派生。派生值对 「展示与排障」是准确的(如实表达了后端与键),但只有实现了readLocator的后端 才能反过来解析它。
TaskResultSummary
export type TaskResultSummary = { mediaKind: "text" | "image" | "video" | "audio" | "motion"; mediaState?: TaskMediaState; location?: TaskResultLocation; text?: string; textTruncated?: boolean; storageKey?: string; locator?: string; contentType?: string; size?: number; checksum?: string; durationSeconds?: number; fps?: number; motion?: SomaMotionMetadata; poster?: { storageKey: string; contentType?: string; size?: number; checksum?: string; };};关联类型:TaskMediaState · TaskResultLocation · SomaMotionMetadata
成员说明:
mediaState:媒体材料化阶段;缺省表示没有正在进行的转存。 与storageKey互斥:materializing 的结果没有任何稳定媒体身份,读取方不得把它当成功产物。location:字节当前位置(宿主在读取详情时补全)。 与storageKey的区别:storageKey是使用方给的稳定逻辑键,位置是「现在真的落在哪」—— 排障时判断「为什么签不出地址 / 为什么读不到」看的正是后者。text:文本结果的安全摘要(绝不包含完整 provider 响应)。textTruncated:文本摘要是否被截断(缺失表示未截断或未知)。storageKey:二进制结果的稳定 metadata(绝不含 bytes 或签名 URL)。locator:结果字节的不透明位置(media://<backend>/<opaque>)。 远端托管生成与 GPU worker 的结果只有它,storageKey可能为空或不是内容寻址形态; 消费方必须优先用它定位字节(见 materializeStableMediaResult 的 locator 分支)。durationSeconds:音视频时长(可得时)。fps:Motion sample rate; independent of video frame rate.poster:可选视频海报/封面的稳定 metadata。