@xtalpi/agentic-lab-skills 0.0.9 → 0.0.11

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/utils/openerInitParams.ts

@@ -1,158 +1,158 @@
-/**
- * 弹层 / 子页由 opener 打开时，用 URL `?trace=...` 与 opener `postMessage` 拉取完整初始化参数。
- *
- * **子页发送**：`{ msg: 'get-data', trace }`
- *
- * **宿主回包（流程页标准）**：
- * `{ msg: 'get-data-response', trace: '<同一 trace>', ticket_ids, valve_id, ... }`
- *
- * **兼容旧约定**：`{ msg: 'data', trace, payload: <对象> }` 或 `msg: 'data'` 且字段平铺在根上。
- *
- * 监听器内校验 `e.source === window.opener`（跨源 postMessage 仍适用）。
- *
- * Dev 无 opener 或缺 trace 时返回 `skipped`；development 可读 `VITE_DEV_OPENER_INIT_JSON` 作回退。
- */
-
-export type OpenerInitSkipped = 'no-opener-or-closed' | 'no-trace'
-
-/** 流程页 / AgenticLab 宿主标准回包 msg */
-export const OPENER_MSG_GET_DATA_RESPONSE = 'get-data-response'
-
-/** 模板 / dev 兼容回包 msg */
-export const OPENER_MSG_DATA = 'data'
-
-export interface OpenerInitDeps {
-  loadingShow: () => void
-  loadingHide: () => void
-  notifyError: (msg: unknown, ...rest: unknown[]) => void
-  /** 等待 opener 回包超时，默认 10000ms */
-  timeoutMs?: number
-}
-
-export interface OpenerInitResult {
-  ok: boolean
-  trace: string | null
-  /** 规范化后的业务参数（含 ticket_ids、valve_id 等） */
-  payload: unknown
-  skipped?: OpenerInitSkipped
-  /** 为 true 时表示 payload 来自 `VITE_DEV_OPENER_INIT_JSON`（仅 development） */
-  devFromEnv?: boolean
-}
-
-/**
- * 解析 `.env.local` 中的 `VITE_DEV_OPENER_INIT_JSON`；非 development 或未配置时返回 `null`。
- */
-export function parseDevOpenerInitFromEnv (): unknown | null {
-  if (!import.meta.env.DEV) return null
-  const raw = import.meta.env.VITE_DEV_OPENER_INIT_JSON
-  if (raw == null || typeof raw !== 'string' || raw.trim() === '') return null
-  try {
-    return JSON.parse(raw) as unknown
-  } catch {
-    console.warn('[openerInitParams] VITE_DEV_OPENER_INIT_JSON 不是合法 JSON，已忽略')
-    return null
-  }
-}
-
-function devPayloadWhenSkipped (): OpenerInitResult | null {
-  const dev = parseDevOpenerInitFromEnv()
-  if (dev == null) return null
-  return { ok: true, trace: null, payload: dev, devFromEnv: true }
-}
-
-/** 部分浏览器下 `e.source` 与缓存的 `opener` 引用不完全相等，需兼容 WindowProxy */
-function isMessageFromOpener (e: MessageEvent, opener: Window): boolean {
-  if (e.source == null) return false
-  return e.source === opener || e.source === window.opener
-}
-
-function omitMsgTrace (d: Record<string, unknown>): Record<string, unknown> {
-  const out: Record<string, unknown> = {}
-  for (const [k, v] of Object.entries(d)) {
-    if (k !== 'msg' && k !== 'trace') {
-      out[k] = v
-    }
-  }
-  return out
-}
-
-/**
- * 将宿主 postMessage 回包规范为业务 payload（供 `openerTicketIds` 等使用）。
- * @returns 匹配 trace 且 msg 合法时返回对象，否则 `null`
- */
-export function parseOpenerReplyMessage (
-  d: Record<string, unknown>,
-  trace: string
-): unknown | null {
-  if (String(d.trace) !== String(trace)) return null
-
-  if (d.msg === OPENER_MSG_GET_DATA_RESPONSE) {
-    return omitMsgTrace(d)
-  }
-
-  if (d.msg === OPENER_MSG_DATA) {
-    if ('payload' in d && d.payload != null && typeof d.payload === 'object') {
-      return d.payload
-    }
-    const flat = omitMsgTrace(d)
-    return Object.keys(flat).length > 0 ? flat : null
-  }
-
-  return null
-}
-
-/**
- * 拉取 opener 初始化参数
- */
-export async function fetchOpenerInitPayload (deps: OpenerInitDeps): Promise<OpenerInitResult> {
-  const { loadingShow, loadingHide, notifyError, timeoutMs = 120000 } = deps
-  loadingShow()
-  try {
-    const opener = window.opener as Window | null
-    if (opener == null || opener.closed) {
-      const fromEnv = devPayloadWhenSkipped()
-      if (fromEnv != null) return fromEnv
-      return { ok: false, trace: null, payload: null, skipped: 'no-opener-or-closed' }
-    }
-
-    const searchParams = new URLSearchParams(window.location.search)
-    const trace = searchParams.get('trace')
-    if (trace == null || trace === '') {
-      const fromEnv = devPayloadWhenSkipped()
-      if (fromEnv != null) return fromEnv
-      return { ok: false, trace: null, payload: null, skipped: 'no-trace' }
-    }
-
-    const payload = await new Promise<unknown>((resolve: (v: unknown) => void, reject: (e?: unknown) => void) => {
-      const timer = window.setTimeout(() => {
-        window.removeEventListener('message', onMessage)
-        const err = new Error('Timeout')
-        notifyError(err, '', '初始化超时')
-        reject(err)
-      }, timeoutMs)
-
-      const onMessage = (e: MessageEvent): void => {
-        if (!isMessageFromOpener(e, opener)) return
-        const d = e.data as Record<string, unknown> | null
-        if (d == null || typeof d !== 'object') return
-
-        const parsed = parseOpenerReplyMessage(d, trace)
-        if (parsed == null) return
-
-        window.clearTimeout(timer)
-        window.removeEventListener('message', onMessage)
-        resolve(parsed)
-      }
-
-      window.addEventListener('message', onMessage)
-      opener.postMessage({ msg: 'get-data', trace }, '*')
-    })
-
-    return { ok: true, trace, payload }
-  } catch (err) {
-    notifyError(err, '', '初始化失败')
-    throw err
-  } finally {
-    loadingHide()
-  }
-}
+/**
+ * 弹层 / 子页由 opener 打开时，用 URL `?trace=...` 与 opener `postMessage` 拉取完整初始化参数。
+ *
+ * **子页发送**：`{ msg: 'get-data', trace }`
+ *
+ * **宿主回包（流程页标准）**：
+ * `{ msg: 'get-data-response', trace: '<同一 trace>', ticket_ids, valve_id, ... }`
+ *
+ * **兼容旧约定**：`{ msg: 'data', trace, payload: <对象> }` 或 `msg: 'data'` 且字段平铺在根上。
+ *
+ * 监听器内校验 `e.source === window.opener`（跨源 postMessage 仍适用）。
+ *
+ * Dev 无 opener 或缺 trace 时返回 `skipped`；development 可读 `VITE_DEV_OPENER_INIT_JSON` 作回退。
+ */
+
+export type OpenerInitSkipped = 'no-opener-or-closed' | 'no-trace'
+
+/** 流程页 / AgenticLab 宿主标准回包 msg */
+export const OPENER_MSG_GET_DATA_RESPONSE = 'get-data-response'
+
+/** 模板 / dev 兼容回包 msg */
+export const OPENER_MSG_DATA = 'data'
+
+export interface OpenerInitDeps {
+  loadingShow: () => void
+  loadingHide: () => void
+  notifyError: (msg: unknown, ...rest: unknown[]) => void
+  /** 等待 opener 回包超时，默认 10000ms */
+  timeoutMs?: number
+}
+
+export interface OpenerInitResult {
+  ok: boolean
+  trace: string | null
+  /** 规范化后的业务参数（含 ticket_ids、valve_id 等） */
+  payload: unknown
+  skipped?: OpenerInitSkipped
+  /** 为 true 时表示 payload 来自 `VITE_DEV_OPENER_INIT_JSON`（仅 development） */
+  devFromEnv?: boolean
+}
+
+/**
+ * 解析 `.env.local` 中的 `VITE_DEV_OPENER_INIT_JSON`；非 development 或未配置时返回 `null`。
+ */
+export function parseDevOpenerInitFromEnv (): unknown | null {
+  if (!import.meta.env.DEV) return null
+  const raw = import.meta.env.VITE_DEV_OPENER_INIT_JSON
+  if (raw == null || typeof raw !== 'string' || raw.trim() === '') return null
+  try {
+    return JSON.parse(raw) as unknown
+  } catch {
+    console.warn('[openerInitParams] VITE_DEV_OPENER_INIT_JSON 不是合法 JSON，已忽略')
+    return null
+  }
+}
+
+function devPayloadWhenSkipped (): OpenerInitResult | null {
+  const dev = parseDevOpenerInitFromEnv()
+  if (dev == null) return null
+  return { ok: true, trace: null, payload: dev, devFromEnv: true }
+}
+
+/** 部分浏览器下 `e.source` 与缓存的 `opener` 引用不完全相等，需兼容 WindowProxy */
+function isMessageFromOpener (e: MessageEvent, opener: Window): boolean {
+  if (e.source == null) return false
+  return e.source === opener || e.source === window.opener
+}
+
+function omitMsgTrace (d: Record<string, unknown>): Record<string, unknown> {
+  const out: Record<string, unknown> = {}
+  for (const [k, v] of Object.entries(d)) {
+    if (k !== 'msg' && k !== 'trace') {
+      out[k] = v
+    }
+  }
+  return out
+}
+
+/**
+ * 将宿主 postMessage 回包规范为业务 payload（供 `openerTicketIds` 等使用）。
+ * @returns 匹配 trace 且 msg 合法时返回对象，否则 `null`
+ */
+export function parseOpenerReplyMessage (
+  d: Record<string, unknown>,
+  trace: string
+): unknown | null {
+  if (String(d.trace) !== String(trace)) return null
+
+  if (d.msg === OPENER_MSG_GET_DATA_RESPONSE) {
+    return omitMsgTrace(d)
+  }
+
+  if (d.msg === OPENER_MSG_DATA) {
+    if ('payload' in d && d.payload != null && typeof d.payload === 'object') {
+      return d.payload
+    }
+    const flat = omitMsgTrace(d)
+    return Object.keys(flat).length > 0 ? flat : null
+  }
+
+  return null
+}
+
+/**
+ * 拉取 opener 初始化参数
+ */
+export async function fetchOpenerInitPayload (deps: OpenerInitDeps): Promise<OpenerInitResult> {
+  const { loadingShow, loadingHide, notifyError, timeoutMs = 120000 } = deps
+  loadingShow()
+  try {
+    const opener = window.opener as Window | null
+    if (opener == null || opener.closed) {
+      const fromEnv = devPayloadWhenSkipped()
+      if (fromEnv != null) return fromEnv
+      return { ok: false, trace: null, payload: null, skipped: 'no-opener-or-closed' }
+    }
+
+    const searchParams = new URLSearchParams(window.location.search)
+    const trace = searchParams.get('trace')
+    if (trace == null || trace === '') {
+      const fromEnv = devPayloadWhenSkipped()
+      if (fromEnv != null) return fromEnv
+      return { ok: false, trace: null, payload: null, skipped: 'no-trace' }
+    }
+
+    const payload = await new Promise<unknown>((resolve: (v: unknown) => void, reject: (e?: unknown) => void) => {
+      const timer = window.setTimeout(() => {
+        window.removeEventListener('message', onMessage)
+        const err = new Error('Timeout')
+        notifyError(err, '', '初始化超时')
+        reject(err)
+      }, timeoutMs)
+
+      const onMessage = (e: MessageEvent): void => {
+        if (!isMessageFromOpener(e, opener)) return
+        const d = e.data as Record<string, unknown> | null
+        if (d == null || typeof d !== 'object') return
+
+        const parsed = parseOpenerReplyMessage(d, trace)
+        if (parsed == null) return
+
+        window.clearTimeout(timer)
+        window.removeEventListener('message', onMessage)
+        resolve(parsed)
+      }
+
+      window.addEventListener('message', onMessage)
+      opener.postMessage({ msg: 'get-data', trace }, '*')
+    })
+
+    return { ok: true, trace, payload }
+  } catch (err) {
+    notifyError(err, '', '初始化失败')
+    throw err
+  } finally {
+    loadingHide()
+  }
+}

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/utils/openerTicketIds.ts

@@ -1,32 +1,32 @@
-/**
- * 从 opener 回包 `payload` 中解析 `ticket_ids`，供 `GET /api/ticket/list` 的 `ticket_id__in` 使用。
- * 支持：`string[]`、`string`（逗号/分号/空白分隔）。
- */
-export function extractTicketIdsFromPayload (payload: unknown): string[] {
-  if (payload == null || typeof payload !== 'object') return []
-  const raw = (payload as Record<string, unknown>).ticket_ids
-  if (Array.isArray(raw)) {
-    return raw.map((x: unknown) => String(x).trim()).filter((s: string) => s.length > 0)
-  }
-  if (typeof raw === 'string') {
-    return raw
-      .split(/[,;\s]+/)
-      .map((s: string) => s.trim())
-      .filter((s: string) => s.length > 0)
-  }
-  return []
-}
-
-/**
- * 从 opener `payload` 解析 **`valve_id`**，供 `POST /api/execution/complete` 请求体使用。
- */
-export function extractValveIdFromPayload (payload: unknown): number | null {
-  if (payload == null || typeof payload !== 'object') return null
-  const raw = (payload as Record<string, unknown>).valve_id
-  if (typeof raw === 'number' && Number.isFinite(raw)) return raw
-  if (typeof raw === 'string' && raw.trim() !== '') {
-    const n = Number(raw)
-    if (Number.isFinite(n)) return n
-  }
-  return null
-}
+/**
+ * 从 opener 回包 `payload` 中解析 `ticket_ids`，供 `GET /api/ticket/list` 的 `ticket_id__in` 使用。
+ * 支持：`string[]`、`string`（逗号/分号/空白分隔）。
+ */
+export function extractTicketIdsFromPayload (payload: unknown): string[] {
+  if (payload == null || typeof payload !== 'object') return []
+  const raw = (payload as Record<string, unknown>).ticket_ids
+  if (Array.isArray(raw)) {
+    return raw.map((x: unknown) => String(x).trim()).filter((s: string) => s.length > 0)
+  }
+  if (typeof raw === 'string') {
+    return raw
+      .split(/[,;\s]+/)
+      .map((s: string) => s.trim())
+      .filter((s: string) => s.length > 0)
+  }
+  return []
+}
+
+/**
+ * 从 opener `payload` 解析 **`valve_id`**，供 `POST /api/execution/complete` 请求体使用。
+ */
+export function extractValveIdFromPayload (payload: unknown): number | null {
+  if (payload == null || typeof payload !== 'object') return null
+  const raw = (payload as Record<string, unknown>).valve_id
+  if (typeof raw === 'number' && Number.isFinite(raw)) return raw
+  if (typeof raw === 'string' && raw.trim() !== '') {
+    const n = Number(raw)
+    if (Number.isFinite(n)) return n
+  }
+  return null
+}

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/utils/orbitHttpClient.ts

@@ -1,110 +1,110 @@
-/**
- * Orbit 运行时 HTTP：优先 `window.xnb.http.client.request`（与 Book 代理、鉴权一致），
- * 无注入时回退 `fetch`。约定见仓库根目录 `OrbitAPI.md` §6.3。
- *
- * 请求体形状与 **`dev/src/global.d.ts`** 中 `XnbHttpClient.request` 对齐，避免与宿主注入类型冲突。
- */
-
-export type OrbitHttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch'
-
-export interface OrbitRequestJsonInput {
-  method: OrbitHttpMethod
-  /** 完整 URL（已含 origin），如 `https://host/api/ticket/list` */
-  url: string
-  headers?: Record<string, string>
-  /** GET 时作为 query；值会转成 string */
-  query?: Record<string, string | number | boolean | undefined | null>
-  /** POST/PUT/PATCH 时作为 JSON 体（仅在使用 Orbit `Body.json` 时） */
-  jsonBody?: Record<string, unknown>
-}
-
-/** 与 `dev/src/global.d.ts` → `XnbHttpClient.request` 的 `options` 一致 */
-export interface XnbHttpClientRequestOptions {
-  method: string
-  url: string
-  headers?: Record<string, string>
-  responseType?: number
-  query?: Record<string, string>
-  body?: { type: string; data: unknown }
-}
-
-function getXnbHttp (): Window['xnb']['http'] | undefined {
-  return window.xnb?.http
-}
-
-/**
- * 将 `client.request` 返回值规范为「业务 JSON 根对象」。
- * 兼容 `res` 或 `res.data` 为 `{ code, data, msg }` 的形态。
- */
-export function unwrapOrbitClientData (res: unknown): unknown {
-  if (res == null) return res
-  if (typeof res !== 'object') return res
-  const r = res as Record<string, unknown>
-  if ('code' in r && ('data' in r || 'msg' in r)) return res
-  if ('data' in r) {
-    const inner = r.data
-    if (inner != null && typeof inner === 'object' && 'code' in (inner as Record<string, unknown>)) {
-      return inner
-    }
-    return inner
-  }
-  return res
-}
-
-/**
- * 使用 Orbit `http.client.request`（若存在）或回退 `fetch` 发 JSON 请求。
- */
-export async function orbitRequestJson (input: OrbitRequestJsonInput): Promise<unknown> {
-  const http = getXnbHttp()
-  const client = http?.client
-  const RT = http?.ResponseType
-  const Body = http?.Body
-
-  if (client?.request != null && RT?.JSON != null) {
-    const headers: Record<string, string> = {
-      'Content-Type': 'application/json; charset=utf-8',
-      ...(input.headers ?? {})
-    }
-    const req: XnbHttpClientRequestOptions = {
-      method: input.method,
-      url: input.url,
-      headers,
-      responseType: RT.JSON
-    }
-    if (input.query != null) {
-      const q: Record<string, string> = {}
-      for (const [k, v] of Object.entries(input.query)) {
-        if (v !== undefined && v !== null) {
-          q[k] = String(v)
-        }
-      }
-      if (Object.keys(q).length > 0) req.query = q
-    }
-    if (input.jsonBody != null && Body?.json != null) {
-      req.body = Body.json(input.jsonBody) as { type: string; data: unknown }
-    }
-    const raw = await client.request(req)
-    return unwrapOrbitClientData(raw.data ?? raw)
-  }
-
-  if (input.method !== 'get') {
-    throw new Error('orbitRequestJson: 非 GET 且无 window.xnb.http.client 时无法回退 fetch')
-  }
-
-  const u = new URL(input.url)
-  if (input.query != null) {
-    for (const [k, v] of Object.entries(input.query)) {
-      if (v !== undefined && v !== null) {
-        u.searchParams.set(k, String(v))
-      }
-    }
-  }
-  const res = await fetch(u.toString(), {
-    method: 'GET',
-    headers: input.headers ?? { Accept: 'application/json' }
-  })
-  if (!res.ok) {
-    throw new Error(`HTTP ${String(res.status)}`)
-  }
-  return await res.json() as unknown
-}
+/**
+ * Orbit 运行时 HTTP：优先 `window.xnb.http.client.request`（与 Book 代理、鉴权一致），
+ * 无注入时回退 `fetch`。约定见仓库根目录 `OrbitAPI.md` §6.3。
+ *
+ * 请求体形状与 **`dev/src/global.d.ts`** 中 `XnbHttpClient.request` 对齐，避免与宿主注入类型冲突。
+ */
+
+export type OrbitHttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch'
+
+export interface OrbitRequestJsonInput {
+  method: OrbitHttpMethod
+  /** 完整 URL（已含 origin），如 `https://host/api/ticket/list` */
+  url: string
+  headers?: Record<string, string>
+  /** GET 时作为 query；值会转成 string */
+  query?: Record<string, string | number | boolean | undefined | null>
+  /** POST/PUT/PATCH 时作为 JSON 体（仅在使用 Orbit `Body.json` 时） */
+  jsonBody?: Record<string, unknown>
+}
+
+/** 与 `dev/src/global.d.ts` → `XnbHttpClient.request` 的 `options` 一致 */
+export interface XnbHttpClientRequestOptions {
+  method: string
+  url: string
+  headers?: Record<string, string>
+  responseType?: number
+  query?: Record<string, string>
+  body?: { type: string; data: unknown }
+}
+
+function getXnbHttp (): Window['xnb']['http'] | undefined {
+  return window.xnb?.http
+}
+
+/**
+ * 将 `client.request` 返回值规范为「业务 JSON 根对象」。
+ * 兼容 `res` 或 `res.data` 为 `{ code, data, msg }` 的形态。
+ */
+export function unwrapOrbitClientData (res: unknown): unknown {
+  if (res == null) return res
+  if (typeof res !== 'object') return res
+  const r = res as Record<string, unknown>
+  if ('code' in r && ('data' in r || 'msg' in r)) return res
+  if ('data' in r) {
+    const inner = r.data
+    if (inner != null && typeof inner === 'object' && 'code' in (inner as Record<string, unknown>)) {
+      return inner
+    }
+    return inner
+  }
+  return res
+}
+
+/**
+ * 使用 Orbit `http.client.request`（若存在）或回退 `fetch` 发 JSON 请求。
+ */
+export async function orbitRequestJson (input: OrbitRequestJsonInput): Promise<unknown> {
+  const http = getXnbHttp()
+  const client = http?.client
+  const RT = http?.ResponseType
+  const Body = http?.Body
+
+  if (client?.request != null && RT?.JSON != null) {
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json; charset=utf-8',
+      ...(input.headers ?? {})
+    }
+    const req: XnbHttpClientRequestOptions = {
+      method: input.method,
+      url: input.url,
+      headers,
+      responseType: RT.JSON
+    }
+    if (input.query != null) {
+      const q: Record<string, string> = {}
+      for (const [k, v] of Object.entries(input.query)) {
+        if (v !== undefined && v !== null) {
+          q[k] = String(v)
+        }
+      }
+      if (Object.keys(q).length > 0) req.query = q
+    }
+    if (input.jsonBody != null && Body?.json != null) {
+      req.body = Body.json(input.jsonBody) as { type: string; data: unknown }
+    }
+    const raw = await client.request(req)
+    return unwrapOrbitClientData(raw.data ?? raw)
+  }
+
+  if (input.method !== 'get') {
+    throw new Error('orbitRequestJson: 非 GET 且无 window.xnb.http.client 时无法回退 fetch')
+  }
+
+  const u = new URL(input.url)
+  if (input.query != null) {
+    for (const [k, v] of Object.entries(input.query)) {
+      if (v !== undefined && v !== null) {
+        u.searchParams.set(k, String(v))
+      }
+    }
+  }
+  const res = await fetch(u.toString(), {
+    method: 'GET',
+    headers: input.headers ?? { Accept: 'application/json' }
+  })
+  if (!res.ok) {
+    throw new Error(`HTTP ${String(res.status)}`)
+  }
+  return await res.json() as unknown
+}