@talex-touch/utils 1.0.42 → 1.0.45

package/transport/sdk/constants.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Constants for TuffTransport SDK
+ * @module @talex-touch/utils/transport/sdk/constants
+ */
+
+/**
+ * Default timeout for transport requests (ms)
+ */
+export const DEFAULT_TIMEOUT = 10_000
+
+/**
+ * Stream message types
+ */
+export const STREAM_MESSAGE_TYPES = {
+  DATA: 'data',
+  ERROR: 'error',
+  END: 'end',
+} as const
+
+/**
+ * Stream event name suffixes
+ */
+export const STREAM_SUFFIXES = {
+  START: ':stream:start',
+  DATA: ':stream:data',
+  END: ':stream:end',
+  ERROR: ':stream:error',
+  CANCEL: ':stream:cancel',
+} as const

package/transport/sdk/domains/agents-market.ts

@@ -0,0 +1,47 @@
+import type {
+  AgentsMarketCategoriesResponse,
+  AgentsMarketInfo,
+  AgentsMarketInstallResponse,
+  AgentsMarketSearchRequest,
+  AgentsMarketSearchResponse,
+} from '../../events/types'
+import type { ITuffTransport } from '../../types'
+import { AgentsEvents } from '../../events'
+
+export type MarketAgentInfo = AgentsMarketInfo
+export type AgentSearchOptions = AgentsMarketSearchRequest
+export type AgentSearchResult = AgentsMarketSearchResponse
+export type AgentInstallResult = AgentsMarketInstallResponse
+export type AgentCategory = AgentsMarketCategoriesResponse[number]
+
+export interface AgentMarketSdk {
+  searchAgents: (options?: AgentSearchOptions) => Promise<AgentSearchResult>
+  getAgentDetails: (agentId: string) => Promise<MarketAgentInfo | null>
+  getFeaturedAgents: () => Promise<MarketAgentInfo[]>
+  getInstalledAgents: () => Promise<MarketAgentInfo[]>
+  getCategories: () => Promise<AgentCategory[]>
+  installAgent: (agentId: string, version?: string) => Promise<AgentInstallResult>
+  uninstallAgent: (agentId: string) => Promise<AgentInstallResult>
+  checkUpdates: () => Promise<MarketAgentInfo[]>
+}
+
+export function createAgentMarketSdk(transport: ITuffTransport): AgentMarketSdk {
+  return {
+    searchAgents: options => transport.send(AgentsEvents.market.search, options),
+
+    getAgentDetails: agentId => transport.send(AgentsEvents.market.get, { agentId }),
+
+    getFeaturedAgents: () => transport.send(AgentsEvents.market.featured),
+
+    getInstalledAgents: () => transport.send(AgentsEvents.market.installed),
+
+    getCategories: () => transport.send(AgentsEvents.market.categories),
+
+    installAgent: (agentId, version) =>
+      transport.send(AgentsEvents.market.install, { agentId, version }),
+
+    uninstallAgent: agentId => transport.send(AgentsEvents.market.uninstall, { agentId }),
+
+    checkUpdates: () => transport.send(AgentsEvents.market.checkUpdates),
+  }
+}

package/transport/sdk/domains/agents.ts

@@ -0,0 +1,62 @@
+import type {
+  AgentsCancelResponse,
+  AgentsExecuteImmediateRequest,
+  AgentsExecuteImmediateResponse,
+  AgentsExecuteRequest,
+  AgentsExecuteResponse,
+  AgentsGetResponse,
+  AgentsListResponse,
+  AgentsStatsResponse,
+  AgentsTaskCancelledPayload,
+  AgentsTaskCompletedPayload,
+  AgentsTaskFailedPayload,
+  AgentsTaskProgressPayload,
+  AgentsTaskStartedPayload,
+  AgentsTaskStatusResponse,
+  AgentsToolsGetResponse,
+  AgentsToolsListResponse,
+  AgentsUpdatePriorityResponse,
+} from '../../events/types'
+import type { ITuffTransport } from '../../types'
+import { AgentsEvents } from '../../events'
+
+export interface AgentsSdk {
+  list: () => Promise<AgentsListResponse>
+  listAll: () => Promise<AgentsListResponse>
+  get: (id: string) => Promise<AgentsGetResponse>
+  execute: (task: AgentsExecuteRequest) => Promise<AgentsExecuteResponse>
+  executeImmediate: (task: AgentsExecuteImmediateRequest) => Promise<AgentsExecuteImmediateResponse>
+  cancel: (taskId: string) => Promise<AgentsCancelResponse>
+  getTaskStatus: (taskId: string) => Promise<AgentsTaskStatusResponse>
+  updatePriority: (taskId: string, priority: number) => Promise<AgentsUpdatePriorityResponse>
+  getStats: () => Promise<AgentsStatsResponse>
+  listTools: () => Promise<AgentsToolsListResponse>
+  getTool: (toolId: string) => Promise<AgentsToolsGetResponse>
+  onTaskStarted: (handler: (payload: AgentsTaskStartedPayload) => void) => () => void
+  onTaskProgress: (handler: (payload: AgentsTaskProgressPayload) => void) => () => void
+  onTaskCompleted: (handler: (payload: AgentsTaskCompletedPayload) => void) => () => void
+  onTaskFailed: (handler: (payload: AgentsTaskFailedPayload) => void) => () => void
+  onTaskCancelled: (handler: (payload: AgentsTaskCancelledPayload) => void) => () => void
+}
+
+export function createAgentsSdk(transport: ITuffTransport): AgentsSdk {
+  return {
+    list: () => transport.send(AgentsEvents.api.list),
+    listAll: () => transport.send(AgentsEvents.api.listAll),
+    get: id => transport.send(AgentsEvents.api.get, { id }),
+    execute: task => transport.send(AgentsEvents.api.execute, task),
+    executeImmediate: task => transport.send(AgentsEvents.api.executeImmediate, task),
+    cancel: taskId => transport.send(AgentsEvents.api.cancel, { taskId }),
+    getTaskStatus: taskId => transport.send(AgentsEvents.api.taskStatus, { taskId }),
+    updatePriority: (taskId, priority) =>
+      transport.send(AgentsEvents.api.updatePriority, { taskId, priority }),
+    getStats: () => transport.send(AgentsEvents.api.stats),
+    listTools: () => transport.send(AgentsEvents.api.tools.list),
+    getTool: toolId => transport.send(AgentsEvents.api.tools.get, { toolId }),
+    onTaskStarted: handler => transport.on(AgentsEvents.push.taskStarted, handler),
+    onTaskProgress: handler => transport.on(AgentsEvents.push.taskProgress, handler),
+    onTaskCompleted: handler => transport.on(AgentsEvents.push.taskCompleted, handler),
+    onTaskFailed: handler => transport.on(AgentsEvents.push.taskFailed, handler),
+    onTaskCancelled: handler => transport.on(AgentsEvents.push.taskCancelled, handler),
+  }
+}

package/transport/sdk/domains/app.ts

@@ -0,0 +1,48 @@
+import type { ITuffTransport } from '../../types'
+import { AppEvents } from '../../events'
+
+export interface AppSdk {
+  close: () => Promise<void>
+  hide: () => Promise<void>
+  minimize: () => Promise<void>
+  focus: () => Promise<void>
+  openDevTools: (options?: Parameters<ITuffTransport['send']>[1]) => Promise<void>
+
+  getCwd: () => Promise<string>
+  getOS: () => Promise<unknown>
+  getPackage: () => Promise<unknown>
+  getPath: (name: string) => Promise<string | null>
+  getSecureValue: (key: string) => Promise<string | null>
+  setSecureValue: (key: string, value: string | null) => Promise<void>
+
+  openExternal: (url: string) => Promise<void>
+  showInFolder: (path: string) => Promise<void>
+  openApp: (options: { appName?: string, path?: string }) => Promise<void>
+  openPromptsFolder: () => Promise<void>
+  executeCommand: (options: { command: string }) => Promise<unknown>
+  readFile: (path: string) => Promise<string>
+}
+
+export function createAppSdk(transport: ITuffTransport): AppSdk {
+  return {
+    close: () => transport.send(AppEvents.window.close),
+    hide: () => transport.send(AppEvents.window.hide),
+    minimize: () => transport.send(AppEvents.window.minimize),
+    focus: () => transport.send(AppEvents.window.focus),
+    openDevTools: options => transport.send(AppEvents.debug.openDevTools, options as any),
+
+    getCwd: () => transport.send(AppEvents.system.getCwd),
+    getOS: () => transport.send(AppEvents.system.getOS),
+    getPackage: () => transport.send(AppEvents.system.getPackage),
+    getPath: name => transport.send(AppEvents.system.getPath, { name }),
+    getSecureValue: key => transport.send(AppEvents.system.getSecureValue, { key }),
+    setSecureValue: (key, value) => transport.send(AppEvents.system.setSecureValue, { key, value }),
+
+    openExternal: url => transport.send(AppEvents.system.openExternal, { url }),
+    showInFolder: path => transport.send(AppEvents.system.showInFolder, { path }),
+    openApp: options => transport.send(AppEvents.system.openApp, options),
+    openPromptsFolder: () => transport.send(AppEvents.system.openPromptsFolder),
+    executeCommand: options => transport.send(AppEvents.system.executeCommand, options as any),
+    readFile: path => transport.send(AppEvents.system.readFile, { source: path }),
+  }
+}

package/transport/sdk/domains/disposable.ts

@@ -0,0 +1,35 @@
+export type Disposer = () => void
+
+export interface DisposableBag {
+  add: (...disposers: Array<Disposer | null | undefined | false>) => void
+  dispose: () => void
+  readonly size: number
+}
+
+export function createDisposableBag(): DisposableBag {
+  const disposers = new Set<Disposer>()
+
+  return {
+    add: (...items) => {
+      for (const item of items) {
+        if (typeof item === 'function') {
+          disposers.add(item)
+        }
+      }
+    },
+    dispose: () => {
+      for (const disposer of disposers) {
+        try {
+          disposer()
+        }
+        catch {
+          // ignore disposer errors
+        }
+      }
+      disposers.clear()
+    },
+    get size() {
+      return disposers.size
+    },
+  }
+}

package/transport/sdk/domains/download.ts

@@ -0,0 +1,139 @@
+import type {
+  DownloadAddTaskRequest,
+  DownloadAddTaskResponse,
+  DownloadClearHistoryItemRequest,
+  DownloadGetConfigResponse,
+  DownloadGetErrorStatsResponse,
+  DownloadGetHistoryRequest,
+  DownloadGetHistoryResponse,
+  DownloadGetLogsResponse,
+  DownloadGetNotificationConfigResponse,
+  DownloadGetStatsResponse,
+  DownloadGetTasksByStatusRequest,
+  DownloadGetTasksResponse,
+  DownloadGetTaskStatusResponse,
+  DownloadGetTempStatsResponse,
+  DownloadMigrationNeededResponse,
+  DownloadMigrationRetryResponse,
+  DownloadMigrationStartResponse,
+  DownloadMigrationStatusResponse,
+  DownloadNotificationClickedPayload,
+  DownloadOpResponse,
+  DownloadTaskIdRequest,
+  DownloadTaskPayload,
+  DownloadTaskRetryingPayload,
+  DownloadUpdateConfigRequest,
+  DownloadUpdateNotificationConfigRequest,
+  DownloadUpdatePriorityRequest,
+} from '../../events/types'
+import type { ITuffTransport } from '../../types'
+import { DownloadEvents } from '../../events'
+
+export interface DownloadSdk {
+  addTask: (request: DownloadAddTaskRequest) => Promise<DownloadAddTaskResponse>
+  pauseTask: (payload: DownloadTaskIdRequest) => Promise<DownloadOpResponse>
+  resumeTask: (payload: DownloadTaskIdRequest) => Promise<DownloadOpResponse>
+  cancelTask: (payload: DownloadTaskIdRequest) => Promise<DownloadOpResponse>
+  retryTask: (payload: DownloadTaskIdRequest) => Promise<DownloadOpResponse>
+  removeTask: (payload: DownloadTaskIdRequest) => Promise<DownloadOpResponse>
+  updatePriority: (payload: DownloadUpdatePriorityRequest) => Promise<DownloadOpResponse>
+  pauseAll: () => Promise<DownloadOpResponse>
+  resumeAll: () => Promise<DownloadOpResponse>
+  cancelAll: () => Promise<DownloadOpResponse>
+
+  getAllTasks: () => Promise<DownloadGetTasksResponse>
+  getTasksByStatus: (payload: DownloadGetTasksByStatusRequest) => Promise<DownloadGetTasksResponse>
+  getTaskStatus: (payload: DownloadTaskIdRequest) => Promise<DownloadGetTaskStatusResponse>
+
+  getConfig: () => Promise<DownloadGetConfigResponse>
+  updateConfig: (payload: DownloadUpdateConfigRequest) => Promise<DownloadOpResponse>
+  getNotificationConfig: () => Promise<DownloadGetNotificationConfigResponse>
+  updateNotificationConfig: (
+    payload: DownloadUpdateNotificationConfigRequest,
+  ) => Promise<DownloadOpResponse>
+
+  getHistory: (payload?: DownloadGetHistoryRequest) => Promise<DownloadGetHistoryResponse>
+  clearHistory: () => Promise<DownloadOpResponse>
+  clearHistoryItem: (payload: DownloadClearHistoryItemRequest) => Promise<DownloadOpResponse>
+
+  openFile: (payload: DownloadTaskIdRequest) => Promise<DownloadOpResponse>
+  showInFolder: (payload: DownloadTaskIdRequest) => Promise<DownloadOpResponse>
+  deleteFile: (payload: DownloadTaskIdRequest) => Promise<DownloadOpResponse>
+
+  cleanupTemp: () => Promise<DownloadOpResponse>
+  getTempStats: () => Promise<DownloadGetTempStatsResponse>
+
+  getLogs: (payload?: { limit?: number }) => Promise<DownloadGetLogsResponse>
+  getErrorStats: () => Promise<DownloadGetErrorStatsResponse>
+  clearLogs: () => Promise<DownloadOpResponse>
+
+  getStats: () => Promise<DownloadGetStatsResponse>
+
+  checkMigrationNeeded: () => Promise<DownloadMigrationNeededResponse>
+  startMigration: () => Promise<DownloadMigrationStartResponse>
+  retryMigration: () => Promise<DownloadMigrationRetryResponse>
+  getMigrationStatus: () => Promise<DownloadMigrationStatusResponse>
+
+  onTaskAdded: (handler: (task: DownloadTaskPayload) => void) => () => void
+  onTaskProgress: (handler: (task: DownloadTaskPayload) => void) => () => void
+  onTaskCompleted: (handler: (task: DownloadTaskPayload) => void) => () => void
+  onTaskFailed: (handler: (task: DownloadTaskPayload) => void) => () => void
+  onTaskUpdated: (handler: (task: DownloadTaskPayload) => void) => () => void
+  onTaskRetrying: (handler: (payload: DownloadTaskRetryingPayload) => void) => () => void
+  onNotificationClicked: (handler: (payload: DownloadNotificationClickedPayload) => void) => () => void
+}
+
+export function createDownloadSdk(transport: ITuffTransport): DownloadSdk {
+  return {
+    addTask: request => transport.send(DownloadEvents.task.add, request),
+    pauseTask: payload => transport.send(DownloadEvents.task.pause, payload),
+    resumeTask: payload => transport.send(DownloadEvents.task.resume, payload),
+    cancelTask: payload => transport.send(DownloadEvents.task.cancel, payload),
+    retryTask: payload => transport.send(DownloadEvents.task.retry, payload),
+    removeTask: payload => transport.send(DownloadEvents.task.remove, payload),
+    updatePriority: payload => transport.send(DownloadEvents.task.updatePriority, payload),
+    pauseAll: () => transport.send(DownloadEvents.task.pauseAll),
+    resumeAll: () => transport.send(DownloadEvents.task.resumeAll),
+    cancelAll: () => transport.send(DownloadEvents.task.cancelAll),
+
+    getAllTasks: () => transport.send(DownloadEvents.list.getAll),
+    getTasksByStatus: payload => transport.send(DownloadEvents.list.getByStatus, payload),
+    getTaskStatus: payload => transport.send(DownloadEvents.task.getStatus, payload),
+
+    getConfig: () => transport.send(DownloadEvents.config.get),
+    updateConfig: payload => transport.send(DownloadEvents.config.update, payload),
+    getNotificationConfig: () => transport.send(DownloadEvents.config.getNotification),
+    updateNotificationConfig: payload =>
+      transport.send(DownloadEvents.config.updateNotification, payload),
+
+    getHistory: payload => transport.send(DownloadEvents.history.get, payload ?? {}),
+    clearHistory: () => transport.send(DownloadEvents.history.clear),
+    clearHistoryItem: payload => transport.send(DownloadEvents.history.clearItem, payload),
+
+    openFile: payload => transport.send(DownloadEvents.file.open, payload),
+    showInFolder: payload => transport.send(DownloadEvents.file.showInFolder, payload),
+    deleteFile: payload => transport.send(DownloadEvents.file.delete, payload),
+
+    cleanupTemp: () => transport.send(DownloadEvents.maintenance.cleanupTemp),
+    getTempStats: () => transport.send(DownloadEvents.temp.getStats),
+
+    getLogs: payload => transport.send(DownloadEvents.logs.get, payload ?? {}),
+    getErrorStats: () => transport.send(DownloadEvents.logs.getErrorStats),
+    clearLogs: () => transport.send(DownloadEvents.logs.clear),
+
+    getStats: () => transport.send(DownloadEvents.stats.get),
+
+    checkMigrationNeeded: () => transport.send(DownloadEvents.migration.checkNeeded),
+    startMigration: () => transport.send(DownloadEvents.migration.start),
+    retryMigration: () => transport.send(DownloadEvents.migration.retry),
+    getMigrationStatus: () => transport.send(DownloadEvents.migration.status),
+
+    onTaskAdded: handler => transport.on(DownloadEvents.push.taskAdded, handler),
+    onTaskProgress: handler => transport.on(DownloadEvents.push.taskProgress, handler),
+    onTaskCompleted: handler => transport.on(DownloadEvents.push.taskCompleted, handler),
+    onTaskFailed: handler => transport.on(DownloadEvents.push.taskFailed, handler),
+    onTaskUpdated: handler => transport.on(DownloadEvents.push.taskUpdated, handler),
+    onTaskRetrying: handler => transport.on(DownloadEvents.push.taskRetrying, handler),
+    onNotificationClicked: handler => transport.on(DownloadEvents.push.notificationClicked, handler),
+  }
+}

package/transport/sdk/domains/index.ts

@@ -0,0 +1,13 @@
+export * from './agents'
+export * from './agents-market'
+export * from './app'
+export * from './disposable'
+export * from './download'
+export * from './intelligence'
+export * from './market'
+export * from './notification'
+export * from './permission'
+export * from './platform'
+export * from './plugin'
+export * from './settings'
+export * from './update'