@vectorx/cloud-toolkit 1.0.1 → 2.0.0

package/types/container/types.d.ts

@@ -1,3 +1,5 @@
+import type { DatabaseClient } from "@vectorx/cloud-database-client";
+import type { DatabaseRequestContext, DbColumn, DbPreviewOptions, DbTable, DbTablePreview, SqlQuery } from "../database.kit";
 import type { CloudEnvironment, CloudEnvironmentCreateRequest, CloudEnvironmentUpdateRequest } from "../env.kit";
 import type { FunDeployOptions, FunDeployResult, FunDevOptions, FunDevRuntime } from "../fun.kit";
 import type { CheckStatusRequest, CheckStatusResponse } from "../services/auth-service";
@@ -38,6 +40,91 @@ export interface IFunService {
         total: number;
     }>;
 }
+export interface IDatabaseService {
+    getOrCreateClient(ctx: DatabaseRequestContext): Promise<DatabaseClient>;
+    listTables(ctx: DatabaseRequestContext, params?: {
+        schema?: string;
+    }): Promise<{
+        tables: DbTable[];
+    }>;
+    getTableColumns(ctx: DatabaseRequestContext, params: {
+        schema?: string;
+        table: string;
+    }): Promise<{
+        columns: DbColumn[];
+    }>;
+    previewTable(ctx: DatabaseRequestContext, params: {
+        schema?: string;
+        table: string;
+        options?: DbPreviewOptions;
+    }): Promise<{
+        preview: DbTablePreview;
+    }>;
+    executeSql(ctx: DatabaseRequestContext, q: SqlQuery): Promise<{
+        rows: any[];
+        rowCount?: number;
+    }>;
+}
+export interface ICloudDevService {
+    getLangfuseConfig(params?: {
+        secret_id?: string;
+        cli_token?: string;
+    }): Promise<LangfuseConfigResult>;
+    getCloudDevLLMBaseURL(params?: {
+        secret_id?: string;
+        cli_token?: string;
+    }): string;
+    getCloudDevAnthropicLLMBaseURL(params?: {
+        secret_id?: string;
+        cli_token?: string;
+    }): string;
+    getUserInfo(params?: {
+        secret_id?: string;
+        cli_token?: string;
+    }): Promise<CloudDevUserInfo>;
+}
+export interface LangfuseConfigResult {
+    secretKey: string;
+    publicKey: string;
+    baseUrl?: string;
+}
+export interface CloudDevUserInfo {
+    nick?: string;
+    nickname?: string;
+    user_id?: string;
+    avatar?: string;
+    desc?: string;
+    [key: string]: unknown;
+}
+export interface AgentListItem {
+    agentId: string;
+    agentName: string;
+    agentType?: string;
+    status?: string;
+    createTime?: string;
+    updateTime?: string;
+    [key: string]: unknown;
+}
+export interface AgentDetail {
+    agentId: string;
+    agentName: string;
+    agentAvatar?: string;
+    agentType?: string;
+    description?: string;
+    status?: string;
+    config?: Record<string, unknown>;
+    createTime?: string;
+    updateTime?: string;
+    creator?: string;
+    [key: string]: unknown;
+}
+export interface IAgentService {
+    getAgentList(params?: {
+        pageNo?: number;
+        pageSize?: number;
+    }): Promise<AgentListItem[]>;
+    getAgentInfoById(agentId: string): Promise<AgentDetail | null>;
+}
 export interface CloudEnvInfo {
     cloud_env_name: string;
     status: number;
@@ -52,4 +139,5 @@ export interface LoginInfo {
     create_at: number;
     expire_in_sec: number;
     cloudEnvInfo?: CloudEnvInfo | null;
+    userInfo?: CloudDevUserInfo | null;
 }

package/types/database.kit.d.ts

@@ -0,0 +1,54 @@
+import type { DatabaseClient } from "@vectorx/cloud-database-client";
+export type DbTable = {
+    schema?: string;
+    name: string;
+};
+export type DbColumn = {
+    name: string;
+    dataType?: string;
+    udtName?: string;
+    nullable?: boolean;
+    ordinalPosition?: number;
+    defaultValue?: string | null;
+};
+export type DbTablePreview = {
+    rows: Array<Record<string, any>>;
+    rowCount?: number;
+};
+export type DbPreviewOptions = {
+    limit?: number;
+    offset?: number;
+    orderBy?: string;
+    orderDirection?: "asc" | "desc";
+};
+export type SqlQuery = {
+    sql: string;
+    values?: any[];
+    readonly?: boolean;
+};
+export interface DatabaseRequestContext {
+    envId?: string;
+}
+export declare function getDatabaseClient(ctx?: DatabaseRequestContext): Promise<DatabaseClient>;
+export declare function listDatabaseTables(ctx?: DatabaseRequestContext, params?: {
+    schema?: string;
+}): Promise<{
+    tables: DbTable[];
+}>;
+export declare function getDatabaseTableColumns(ctx?: DatabaseRequestContext, params?: {
+    schema?: string;
+    table: string;
+}): Promise<{
+    columns: DbColumn[];
+}>;
+export declare function previewDatabaseTable(ctx?: DatabaseRequestContext, params?: {
+    schema?: string;
+    table: string;
+    options?: DbPreviewOptions;
+}): Promise<{
+    preview: DbTablePreview;
+}>;
+export declare function executeDatabaseSql(ctx?: DatabaseRequestContext, q?: SqlQuery): Promise<{
+    rows: any[];
+    rowCount?: number;
+}>;

package/types/index.d.ts

@@ -1,6 +1,8 @@
 export * from "./agent.kit";
 export * from "./fun.kit";
 export * from "./env.kit";
+export * from "./database.kit";
+export * from "./cloud-dev.kit";
 export { Uploader } from "./utils/cos-uploader";
 export * from "./container";
 export * from "./services";

package/types/services/agent-service.d.ts

@@ -0,0 +1,11 @@
+import type { AgentDetail, AgentListItem, IAgentService } from "../container/types";
+export declare class AgentService implements IAgentService {
+    private readonly authService;
+    constructor();
+    private resolveAuthQuery;
+    getAgentList(params?: {
+        pageNo?: number;
+        pageSize?: number;
+    }): Promise<AgentListItem[]>;
+    getAgentInfoById(agentId: string): Promise<AgentDetail | null>;
+}

package/types/services/cloud-dev-service.d.ts

@@ -0,0 +1,23 @@
+import type { CloudDevUserInfo, ICloudDevService, LangfuseConfigResult } from "../container";
+export declare class CloudDevService implements ICloudDevService {
+    private readonly authService;
+    constructor();
+    private resolveAuthQuery;
+    private getCloudDevBaseUrl;
+    getLangfuseConfig(params?: {
+        secret_id?: string;
+        cli_token?: string;
+    }): Promise<LangfuseConfigResult>;
+    getCloudDevLLMBaseURL(params?: {
+        secret_id?: string;
+        cli_token?: string;
+    }): string;
+    getCloudDevAnthropicLLMBaseURL(params?: {
+        secret_id?: string;
+        cli_token?: string;
+    }): string;
+    getUserInfo(params?: {
+        secret_id?: string;
+        cli_token?: string;
+    }): Promise<CloudDevUserInfo>;
+}

package/types/services/database-service.d.ts

@@ -0,0 +1,33 @@
+import { type DatabaseClient } from "@vectorx/cloud-database-client";
+import type { IDatabaseService } from "../container/types";
+import type { DatabaseRequestContext, DbColumn, DbPreviewOptions, DbTable, DbTablePreview, SqlQuery } from "../database.kit";
+export declare class DatabaseService implements IDatabaseService {
+    private readonly authService;
+    private readonly clientCache;
+    private readonly mockRdsEndpointInfo;
+    constructor();
+    private pickDbEndpoint;
+    getOrCreateClient(ctx: DatabaseRequestContext): Promise<DatabaseClient>;
+    listTables(ctx: DatabaseRequestContext, params?: {
+        schema?: string;
+    }): Promise<{
+        tables: DbTable[];
+    }>;
+    getTableColumns(ctx: DatabaseRequestContext, params: {
+        schema?: string;
+        table: string;
+    }): Promise<{
+        columns: DbColumn[];
+    }>;
+    previewTable(ctx: DatabaseRequestContext, params: {
+        schema?: string;
+        table: string;
+        options?: DbPreviewOptions;
+    }): Promise<{
+        preview: DbTablePreview;
+    }>;
+    executeSql(ctx: DatabaseRequestContext, q: SqlQuery): Promise<{
+        rows: any[];
+        rowCount?: number;
+    }>;
+}

package/types/services/index.d.ts

@@ -1,4 +1,7 @@
 export * from "./auth-service";
 export * from "./upload-service";
+export * from "./cloud-dev-service";
 export * from "./cloud-env-service";
+export * from "./database-service";
 export * from "./fun-service";
+export * from "./agent-service";

package/types/utils/tracker/ai-apm.d.ts

@@ -0,0 +1,54 @@
+export declare const AI_MEASUREMENT_NAME = "vectorx_ai_chat_service_usage";
+export type AiSessionStatus = "success" | "fail" | "aborted";
+export interface InitAiApmOptions {
+    userId?: string;
+}
+export declare function initAiApm(options?: InitAiApmOptions): void;
+export interface AiSessionRunMeta {
+    session_id: string;
+    model?: string;
+    dev_mode?: string;
+    is_new_session?: 0 | 1;
+    message_length?: number;
+}
+export declare function reportAiSessionRun(meta: AiSessionRunMeta): void;
+export interface AiTurnCodeGeneratedMeta {
+    session_id?: string;
+    model?: string;
+    dev_mode?: string;
+    files_changed?: number;
+    lines_added?: number;
+    lines_removed?: number;
+}
+export declare function reportAiTurnCodeGenerated(meta: AiTurnCodeGeneratedMeta): void;
+export interface AiSessionCompleteMeta {
+    session_id: string;
+    model?: string;
+    dev_mode?: string;
+    duration_ms: number;
+    status: AiSessionStatus;
+    total_files_changed?: number;
+    total_lines_added?: number;
+    total_lines_removed?: number;
+    error_type?: string;
+}
+export declare function reportAiSessionComplete(meta: AiSessionCompleteMeta): void;
+export interface AiCodeChangeMeta {
+    session_id?: string;
+    tool_name?: string;
+}
+export declare function reportAiCodeChangeApplied(meta: AiCodeChangeMeta): void;
+export declare function reportAiCodeChangeRejected(meta: AiCodeChangeMeta): void;
+export interface AiBulkResolveMeta {
+    session_id?: string;
+    action: "accept" | "reject";
+    files_count?: number;
+}
+export declare function reportAiBulkResolve(meta: AiBulkResolveMeta): void;
+export interface AiMessageSentMeta {
+    session_id?: string;
+    mode?: string;
+    model?: string;
+    message_length?: number;
+}
+export declare function reportAiMessageSent(meta: AiMessageSentMeta): void;

package/types/utils/tracker/index.d.ts

@@ -2,3 +2,4 @@ export * from "./tracker";
 export * from "./device";
 export * from "./apm";
 export * from "./cli-apm";
+export * from "./ai-apm";