@sema-agent/client-core 0.67.2 → 0.68.0

package/dist/workflowClient.d.ts

@@ -63,6 +63,28 @@ export interface LiveWorkflowConfig {
  *  tolerates absent/permissive fields and never throws (the graceful-degrade contract lives above, in the
  *  source loop; this just maps a well-formed run). Exported for the mock-parity unit cross-check. */
 export declare function projectWorkflowRun(run: WorkflowRun): WorkflowRunState;
+/** `parks[]` 的一行 —— **恰好三键**,凭据席位在本型上不存在(见上段 ①)。 */
+export interface WorkflowParkRowView {
+    /** 这只 park 属于哪一次调用(与 `agents[].callKey` join 得上)。 */
+    callKey: string;
+    /** 停着的那只审批属于哪个会话(宿主按它路由)。 */
+    sessionId: string;
+    /** 最初跑出这只 park 的那条 run。 */
+    originRunId: string;
+}
+/**
+ * `GET /v1/workflows/:id` 的 `parks[]` → 三键行;**整键缺席 ⇒ `undefined`**(与空数组逐字可分)。
+ *
+ * 🔴 **`undefined` 与 `[]` 不是一回事**,这是本读器最承重的一格:
+ *    · `undefined` —— 这条记录上没有 `parks` 这一键(旧引擎写的)⇒ **证不出**有没有 park;
+ *    · `[]`        —— 这条记录有这一键且是空的 ⇒ 一句正面事实:这条 run 上没有 park。
+ * 🔴 **坏行只丢自己**(与本包 `wiring_manifest.mcp[]` 的处置同尺):三键缺一 / 非串 / 空串 的行
+ *    整条丢弃,其余行保序留下;**非空输入而全部坏行 ⇒ 返回 `[]`**?—— **不**:那会把「读不出」
+ *    伪装成「零 park」。全坏 ⇒ `undefined`(诚实缺席)。
+ * 🔴 `parks` 不是数组(对象 / 串 / null)⇒ 当整键缺席(非投影口喂进来的形)。
+ * 🔴 纯函数、零副作用、**绝不抛**。
+ */
+export declare function readWorkflowParks(run: unknown): readonly WorkflowParkRowView[] | undefined;
 /** 台账里的一个 agent(读口产物,只读快照;缺席 = 不知道,绝不渲成 0/空)。 */
 export interface WorkflowActivityAgentView {
     /** `ctx.agent` 调用的稳定身份(SSE 主键);老引擎/无 callKey 的帧上缺席。 */

package/dist/workflowClient.js

@@ -381,6 +381,43 @@ export function projectWorkflowRun(run) {
         state.description = run.description;
     return state;
 }
+/**
+ * `GET /v1/workflows/:id` 的 `parks[]` → 三键行;**整键缺席 ⇒ `undefined`**(与空数组逐字可分)。
+ *
+ * 🔴 **`undefined` 与 `[]` 不是一回事**,这是本读器最承重的一格:
+ *    · `undefined` —— 这条记录上没有 `parks` 这一键(旧引擎写的)⇒ **证不出**有没有 park;
+ *    · `[]`        —— 这条记录有这一键且是空的 ⇒ 一句正面事实:这条 run 上没有 park。
+ * 🔴 **坏行只丢自己**(与本包 `wiring_manifest.mcp[]` 的处置同尺):三键缺一 / 非串 / 空串 的行
+ *    整条丢弃,其余行保序留下;**非空输入而全部坏行 ⇒ 返回 `[]`**?—— **不**:那会把「读不出」
+ *    伪装成「零 park」。全坏 ⇒ `undefined`(诚实缺席)。
+ * 🔴 `parks` 不是数组(对象 / 串 / null)⇒ 当整键缺席(非投影口喂进来的形)。
+ * 🔴 纯函数、零副作用、**绝不抛**。
+ */
+export function readWorkflowParks(run) {
+    if (typeof run !== 'object' || run === null || Array.isArray(run))
+        return undefined;
+    const raw = run.parks;
+    if (!Array.isArray(raw))
+        return undefined;
+    const rows = [];
+    for (const r of raw) {
+        if (typeof r !== 'object' || r === null || Array.isArray(r))
+            continue;
+        const o = r;
+        const callKey = typeof o.callKey === 'string' && o.callKey.length > 0 ? o.callKey : undefined;
+        const sessionId = typeof o.sessionId === 'string' && o.sessionId.length > 0 ? o.sessionId : undefined;
+        const originRunId = typeof o.originRunId === 'string' && o.originRunId.length > 0 ? o.originRunId : undefined;
+        if (callKey === undefined || sessionId === undefined || originRunId === undefined)
+            continue;
+        // 🔴 **逐键铸**,不 spread:上游在这张行上多放一个键(尤其是凭据形)时,它在结构上到不了
+        //    本包的产物。这不是风格选择 —— 它是本段 ① 那条红线的实现。
+        rows.push({ callKey, sessionId, originRunId });
+    }
+    // 非空输入而一行都没活下来 ⇒ 读不出,不是「零 park」(绝不铸 `[]` 冒充一句正面事实)。
+    if (raw.length > 0 && rows.length === 0)
+        return undefined;
+    return rows;
+}
 // ── 轮询/退避节拍(REF-CC-131,域词表-15):三个 3000ms 常量语义各不相同,拆开命名——合并成一个
 // 会把三条独立的退避策略绑死在一起(其中任一策略调优都会误伤另外两条)。──────────────────────
 /** owner 名下暂无任何 run(`resolveRunId` 回 null)时的重试间隔:不是错误,只是「还没有可监的