跳转到内容

签名关联类型: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。