@xtalpi/agentic-lab-skills 0.0.9 → 0.0.11

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/api/agenticlabTickets.ts

@@ -1,110 +1,110 @@
-/**
- * AgenticLab App：Ticket 列表 HTTP。
- * 请求走 **`orbitRequestJson`**（`src/utils/orbitHttpClient.ts`），优先 **`window.xnb.http.client.request`**，见 **OrbitAPI.md** §6.3。
- */
-
-import { orbitRequestJson } from '@/utils/orbitHttpClient'
-
-export interface FetchAgenticlabTicketListParams {
-  /** 无尾部斜杠亦可，如 `https://agenticlab.example.com`；嵌入 Orbit 且仅用 http.client 时仍建议填写以便回退 fetch */
-  baseUrl: string
-  /**
-   * 可选静态 Bearer；为空时依次尝试：
-   * `await window.xnb.choreo.getUserToken()`（无参）、`VITE_DEV_TOKEN`。
-   */
-  token?: string
-  /** 业务工单号列表，对应 query `ticket_id__in`（多值逗号拼接） */
-  ticketIds: string[]
-  limit?: number
-  offset?: number
-}
-
-function joinBaseAndPath (baseUrl: string, path: string): string {
-  const trimmed = baseUrl.replace(/\/+$/, '')
-  const p = path.startsWith('/') ? path : `/${path}`
-  return `${trimmed}${p}`
-}
-
-async function resolveBearerToken (opts: { token?: string }): Promise<string | undefined> {
-  if (opts.token != null && opts.token !== '') return opts.token
-  const w = window as Window & { xnb?: { choreo?: { getUserToken?: () => Promise<string> } } }
-  const getToken = w.xnb?.choreo?.getUserToken
-  if (getToken != null) {
-    try {
-      return await getToken()
-    } catch {
-      return undefined
-    }
-  }
-  const env = import.meta.env.VITE_DEV_TOKEN
-  return env != null && env !== '' ? env : undefined
-}
-
-/**
- * `GET /api/ticket/list`，`ticket_id__in` 为逗号拼接的 ticket 业务号（与 `detail.ticket_id` 对应）。
- */
-export async function fetchAgenticlabTicketList (params: FetchAgenticlabTicketListParams): Promise<unknown[]> {
-  const { baseUrl, token, ticketIds, limit = 999999, offset = 0 } = params
-  if (!baseUrl || ticketIds.length === 0) return []
-
-  const url = joinBaseAndPath(baseUrl, '/api/ticket/list')
-  const bearer = await resolveBearerToken({ token })
-  const headers: Record<string, string> = { Accept: 'application/json' }
-  if (bearer != null && bearer !== '') {
-    headers.Authorization = `Bearer ${bearer}`
-  }
-
-  const raw = await orbitRequestJson({
-    method: 'get',
-    url,
-    headers,
-    query: {
-      limit,
-      offset,
-      ticket_id__in: ticketIds.join(',')
-    }
-  })
-  const body = raw as { code?: number; msg?: string; data?: { list?: unknown[] } }
-  if (body.code !== 200) {
-    throw new Error(body.msg != null && body.msg !== '' ? String(body.msg) : `业务 code ${String(body.code)}`)
-  }
-  return body.data?.list ?? []
-}
-
-export interface PostAgenticlabExecutionCompleteParams {
-  baseUrl: string
-  token?: string
-  /** 门控 / 执行实例标识，与后端约定一致；缺省可由 opener 或环境变量提供 */
-  valveId: number
-  /** 与列表项结构一致的工单对象数组，字段须与 `GET /api/ticket/list` 的 `list[]` 项对齐（含编辑后的 `detail` 等） */
-  tickets: Record<string, unknown>[]
-}
-
-/**
- * `POST /api/execution/complete`：提交编辑后的Ticket列表，由后端完成执行闭环。
- */
-export async function postAgenticlabExecutionComplete (params: PostAgenticlabExecutionCompleteParams): Promise<void> {
-  const { baseUrl, token, valveId, tickets } = params
-  if (!baseUrl) throw new Error('缺少 AgenticLab baseUrl')
-
-  const url = joinBaseAndPath(baseUrl, '/api/execution/complete')
-  const bearer = await resolveBearerToken({ token })
-  const headers: Record<string, string> = {
-    Accept: 'application/json',
-    'Content-Type': 'application/json; charset=utf-8'
-  }
-  if (bearer != null && bearer !== '') {
-    headers.Authorization = `Bearer ${bearer}`
-  }
-
-  const raw = await orbitRequestJson({
-    method: 'post',
-    url,
-    headers,
-    jsonBody: { valve_id: valveId, tickets }
-  })
-  const body = raw as { code?: number; msg?: string }
-  if (body.code !== 200) {
-    throw new Error(body.msg != null && body.msg !== '' ? String(body.msg) : `业务 code ${String(body.code)}`)
-  }
-}
+/**
+ * AgenticLab App：Ticket 列表 HTTP。
+ * 请求走 **`orbitRequestJson`**（`src/utils/orbitHttpClient.ts`），优先 **`window.xnb.http.client.request`**，见 **OrbitAPI.md** §6.3。
+ */
+
+import { orbitRequestJson } from '@/utils/orbitHttpClient'
+
+export interface FetchAgenticlabTicketListParams {
+  /** 无尾部斜杠亦可，如 `https://agenticlab.example.com`；嵌入 Orbit 且仅用 http.client 时仍建议填写以便回退 fetch */
+  baseUrl: string
+  /**
+   * 可选静态 Bearer；为空时依次尝试：
+   * `await window.xnb.choreo.getUserToken()`（无参）、`VITE_DEV_TOKEN`。
+   */
+  token?: string
+  /** 业务工单号列表，对应 query `ticket_id__in`（多值逗号拼接） */
+  ticketIds: string[]
+  limit?: number
+  offset?: number
+}
+
+function joinBaseAndPath (baseUrl: string, path: string): string {
+  const trimmed = baseUrl.replace(/\/+$/, '')
+  const p = path.startsWith('/') ? path : `/${path}`
+  return `${trimmed}${p}`
+}
+
+async function resolveBearerToken (opts: { token?: string }): Promise<string | undefined> {
+  if (opts.token != null && opts.token !== '') return opts.token
+  const w = window as Window & { xnb?: { choreo?: { getUserToken?: () => Promise<string> } } }
+  const getToken = w.xnb?.choreo?.getUserToken
+  if (getToken != null) {
+    try {
+      return await getToken()
+    } catch {
+      return undefined
+    }
+  }
+  const env = import.meta.env.VITE_DEV_TOKEN
+  return env != null && env !== '' ? env : undefined
+}
+
+/**
+ * `GET /api/ticket/list`，`ticket_id__in` 为逗号拼接的 ticket 业务号（与 `detail.ticket_id` 对应）。
+ */
+export async function fetchAgenticlabTicketList (params: FetchAgenticlabTicketListParams): Promise<unknown[]> {
+  const { baseUrl, token, ticketIds, limit = 999999, offset = 0 } = params
+  if (!baseUrl || ticketIds.length === 0) return []
+
+  const url = joinBaseAndPath(baseUrl, '/api/ticket/list')
+  const bearer = await resolveBearerToken({ token })
+  const headers: Record<string, string> = { Accept: 'application/json' }
+  if (bearer != null && bearer !== '') {
+    headers.Authorization = `Bearer ${bearer}`
+  }
+
+  const raw = await orbitRequestJson({
+    method: 'get',
+    url,
+    headers,
+    query: {
+      limit,
+      offset,
+      ticket_id__in: ticketIds.join(',')
+    }
+  })
+  const body = raw as { code?: number; msg?: string; data?: { list?: unknown[] } }
+  if (body.code !== 200) {
+    throw new Error(body.msg != null && body.msg !== '' ? String(body.msg) : `业务 code ${String(body.code)}`)
+  }
+  return body.data?.list ?? []
+}
+
+export interface PostAgenticlabExecutionCompleteParams {
+  baseUrl: string
+  token?: string
+  /** 门控 / 执行实例标识，与后端约定一致；缺省可由 opener 或环境变量提供 */
+  valveId: number
+  /** 与列表项结构一致的工单对象数组，字段须与 `GET /api/ticket/list` 的 `list[]` 项对齐（含编辑后的 `detail` 等） */
+  tickets: Record<string, unknown>[]
+}
+
+/**
+ * `POST /api/execution/complete`：提交编辑后的Ticket列表，由后端完成执行闭环。
+ */
+export async function postAgenticlabExecutionComplete (params: PostAgenticlabExecutionCompleteParams): Promise<void> {
+  const { baseUrl, token, valveId, tickets } = params
+  if (!baseUrl) throw new Error('缺少 AgenticLab baseUrl')
+
+  const url = joinBaseAndPath(baseUrl, '/api/execution/complete')
+  const bearer = await resolveBearerToken({ token })
+  const headers: Record<string, string> = {
+    Accept: 'application/json',
+    'Content-Type': 'application/json; charset=utf-8'
+  }
+  if (bearer != null && bearer !== '') {
+    headers.Authorization = `Bearer ${bearer}`
+  }
+
+  const raw = await orbitRequestJson({
+    method: 'post',
+    url,
+    headers,
+    jsonBody: { valve_id: valveId, tickets }
+  })
+  const body = raw as { code?: number; msg?: string }
+  if (body.code !== 200) {
+    throw new Error(body.msg != null && body.msg !== '' ? String(body.msg) : `业务 code ${String(body.code)}`)
+  }
+}

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/entries/bitable.ts

@@ -1,4 +1,4 @@
-import View from '../views/bitable.vue'
-import packageData from '../../package.json'
-
-export { View, packageData }
+import View from '../views/bitable.vue'
+import packageData from '../../package.json'
+
+export { View, packageData }

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/entries/custom-page.ts

@@ -1,4 +1,4 @@
-import View from '../views/custom-page.vue'
-import packageData from '../../package.json'
-
-export { View, packageData }
+import View from '../views/custom-page.vue'
+import packageData from '../../package.json'
+
+export { View, packageData }

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

@@ -1 +1 @@
-export { View, packageData } from './entries/bitable'
+export { View, packageData } from './entries/bitable'

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/styles/orbit-quasar-host.scss

@@ -1,19 +1,19 @@
-/**
- * Orbit Cell 内 Quasar 子树：根节点加 `class="orbit-quasar-host"` 后，本节点以下生效。
- * - 主色：`color="primary"` / `.bg-primary` → `var(--q-primary)`
- * - `q-btn`：紧凑内边距；关闭默认全大写
- *
- * 复用：在 SFC 的 `<style scoped lang="scss">` 内首行 `@import '@/styles/orbit-quasar-host.scss';`
- * （须 scoped + `:deep(.q-btn)`，否则子组件 DOM 无法命中）
- * 主题调整：新增/修改主色或全局 `q-btn` 表现请只改本文件；页面结构见 `src/views/bitable.vue`。
- * 按钮分工：`primary` 仅提交等持久化写回；`outline` 仅刷新/检查等页面数据交互（见 lab-orbit-component-builder SKILL 规则 2）。
- */
-.orbit-quasar-host {
-  --orbit-primary: #123aff;
-  --q-primary: var(--orbit-primary);
-
-  :deep(.q-btn) {
-    padding: 0 10px;
-    text-transform: none;
-  }
-}
+/**
+ * Orbit Cell 内 Quasar 子树：根节点加 `class="orbit-quasar-host"` 后，本节点以下生效。
+ * - 主色：`color="primary"` / `.bg-primary` → `var(--q-primary)`
+ * - `q-btn`：紧凑内边距；关闭默认全大写
+ *
+ * 复用：在 SFC 的 `<style scoped lang="scss">` 内首行 `@import '@/styles/orbit-quasar-host.scss';`
+ * （须 scoped + `:deep(.q-btn)`，否则子组件 DOM 无法命中）
+ * 主题调整：新增/修改主色或全局 `q-btn` 表现请只改本文件；页面结构见 `src/views/bitable.vue`。
+ * 按钮分工：`primary` 仅提交等持久化写回；`outline` 仅刷新/检查等页面数据交互（见 lab-orbit-component-builder SKILL 规则 2）。
+ */
+.orbit-quasar-host {
+  --orbit-primary: #123aff;
+  --q-primary: var(--orbit-primary);
+
+  :deep(.q-btn) {
+    padding: 0 10px;
+    text-transform: none;
+  }
+}

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/types/context.ts

@@ -1,15 +1,15 @@
-export interface XnbContext {
-  bookPath: string
-  cellUid: string
-  notifySuccess: (msg: string) => void
-  notifyError: (msg: any) => void
-  loadingShow: (opts?: any) => void
-  loadingHide: () => void
-  userData: Record<string, any>
-  getUserData: () => Record<string, any>
-  updateUserData: (data: any) => void
-  mergeUserData: (data: any) => void
-  getInstanceById: (id: string) => any
-  getInstanceValueById: (id: string) => any
-  setInstanceValueById: (id: string, value: any) => void
-}
+export interface XnbContext {
+  bookPath: string
+  cellUid: string
+  notifySuccess: (msg: string) => void
+  notifyError: (msg: any) => void
+  loadingShow: (opts?: any) => void
+  loadingHide: () => void
+  userData: Record<string, any>
+  getUserData: () => Record<string, any>
+  updateUserData: (data: any) => void
+  mergeUserData: (data: any) => void
+  getInstanceById: (id: string) => any
+  getInstanceValueById: (id: string) => any
+  setInstanceValueById: (id: string, value: any) => void
+}

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/types/xnb-context.ts

@@ -1,70 +1,70 @@
-/**
- * 与「超级表格 / 子 Cell」协作相关的 xnbContext 形状（精简版，便于本模板内类型对齐）。
- * 完整类型定义以你们宿主或正式项目中的 `Types/context` 等为准；本处仅保留模板示例所需字段。
- */
-
-/**
- * 单张子表在 XNBBitable 侧的常见形状（`getSubBitable` / `getAllSubBitable` 返回值对齐用）。
- * 宿主实现字段可能更多；此处保留示例所需最小集。
- */
-export interface DemoBitableSheet {
-  index?: string
-  name?: string
-  row?: number
-  items: unknown[]
-  data_columns: unknown[]
-  config?: unknown
-  [key: string]: unknown
-}
-
-/** 子表创建时单张 bitable 的配置骨架（创建前常补全 items / data_columns / config） */
-export interface DemoSubBitableOption {
-  index?: string
-  name?: string
-  rowFocus?: number
-  columnFocus?: number
-  items?: unknown[]
-  data_columns?: unknown[]
-  config?: unknown[]
-  [key: string]: unknown
-}
-
-/** 宿主注入的 XNBBitable 构造函数（典型用法：`new XNBBitable({ bookPath, cellUid })`） */
-export interface XNBBitableChoreo {
-  getSubCell (): Promise<string | null>
-  createSubBitable (bitables: unknown[], sheetName: string): Promise<string>
-  /** 多子表时用于按 `index` 命中目标子表；单表场景常返回长度为 1 的数组 */
-  getAllSubBitable (refresh?: boolean): Promise<DemoBitableSheet[]>
-  getSubBitable (refresh?: boolean): Promise<DemoBitableSheet>
-  /**
-   * 为子表追加列定义（常见签名第三参为 `[]`）。
-   * 与 `bitable-list-lifecycle.js` 一致：重建列前常先清空 `bitable.data_columns` 再调用。
-   */
-  addColumns (bitable: Record<string, unknown>, dataColumns: unknown[], extra: unknown[]): Promise<void>
-  updateSubBitable (bitables: unknown[], opts?: Record<string, unknown>): Promise<void>
-  delay (ms: number): Promise<void>
-}
-
-export type XNBBitableConstructor = new (opts: { bookPath: string; cellUid: string }) => XNBBitableChoreo
-
-/** window.xnb.event 最小形状（仅示例里 on/off/emit） */
-export interface XnbEventBus {
-  on: (channel: string, handler: (...args: unknown[]) => void) => void
-  off: (channel: string, handler: (...args: unknown[]) => void) => void
-  emit: (channel: string, ...args: unknown[]) => void
-}
-
-/** 超级表格 Cell 场景下 xnbContext 常用字段（宿主注入上下文 + XNBBitable 类） */
-export interface XnbSuperCellContext {
-  bookPath: string
-  cellUid: string
-  /** 类本身，由宿主注入；dev 环境见 dev/src/mockXNBBitable.ts */
-  XNBBitable?: XNBBitableConstructor
-  loadingShow?: (opts?: unknown) => void
-  loadingHide?: () => void
-  notifySuccess?: (msg: string) => void
-  notifyError?: (msg: unknown, ...rest: unknown[]) => void
-  getUserData?: () => Record<string, unknown>
-  updateUserData?: (data: Record<string, unknown>) => Promise<void> | void
-  [key: string]: unknown
-}
+/**
+ * 与「超级表格 / 子 Cell」协作相关的 xnbContext 形状（精简版，便于本模板内类型对齐）。
+ * 完整类型定义以你们宿主或正式项目中的 `Types/context` 等为准；本处仅保留模板示例所需字段。
+ */
+
+/**
+ * 单张子表在 XNBBitable 侧的常见形状（`getSubBitable` / `getAllSubBitable` 返回值对齐用）。
+ * 宿主实现字段可能更多；此处保留示例所需最小集。
+ */
+export interface DemoBitableSheet {
+  index?: string
+  name?: string
+  row?: number
+  items: unknown[]
+  data_columns: unknown[]
+  config?: unknown
+  [key: string]: unknown
+}
+
+/** 子表创建时单张 bitable 的配置骨架（创建前常补全 items / data_columns / config） */
+export interface DemoSubBitableOption {
+  index?: string
+  name?: string
+  rowFocus?: number
+  columnFocus?: number
+  items?: unknown[]
+  data_columns?: unknown[]
+  config?: unknown[]
+  [key: string]: unknown
+}
+
+/** 宿主注入的 XNBBitable 构造函数（典型用法：`new XNBBitable({ bookPath, cellUid })`） */
+export interface XNBBitableChoreo {
+  getSubCell (): Promise<string | null>
+  createSubBitable (bitables: unknown[], sheetName: string): Promise<string>
+  /** 多子表时用于按 `index` 命中目标子表；单表场景常返回长度为 1 的数组 */
+  getAllSubBitable (refresh?: boolean): Promise<DemoBitableSheet[]>
+  getSubBitable (refresh?: boolean): Promise<DemoBitableSheet>
+  /**
+   * 为子表追加列定义（常见签名第三参为 `[]`）。
+   * 与 `bitable-list-lifecycle.js` 一致：重建列前常先清空 `bitable.data_columns` 再调用。
+   */
+  addColumns (bitable: Record<string, unknown>, dataColumns: unknown[], extra: unknown[]): Promise<void>
+  updateSubBitable (bitables: unknown[], opts?: Record<string, unknown>): Promise<void>
+  delay (ms: number): Promise<void>
+}
+
+export type XNBBitableConstructor = new (opts: { bookPath: string; cellUid: string }) => XNBBitableChoreo
+
+/** window.xnb.event 最小形状（仅示例里 on/off/emit） */
+export interface XnbEventBus {
+  on: (channel: string, handler: (...args: unknown[]) => void) => void
+  off: (channel: string, handler: (...args: unknown[]) => void) => void
+  emit: (channel: string, ...args: unknown[]) => void
+}
+
+/** 超级表格 Cell 场景下 xnbContext 常用字段（宿主注入上下文 + XNBBitable 类） */
+export interface XnbSuperCellContext {
+  bookPath: string
+  cellUid: string
+  /** 类本身，由宿主注入；dev 环境见 dev/src/mockXNBBitable.ts */
+  XNBBitable?: XNBBitableConstructor
+  loadingShow?: (opts?: unknown) => void
+  loadingHide?: () => void
+  notifySuccess?: (msg: string) => void
+  notifyError?: (msg: unknown, ...rest: unknown[]) => void
+  getUserData?: () => Record<string, unknown>
+  updateUserData?: (data: Record<string, unknown>) => Promise<void> | void
+  [key: string]: unknown
+}