@ty_krystal/sei-ai 0.1.8 → 0.1.12

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @ty_krystal/sei-ai
 $ sei-ai COMMAND
 running command...
 $ sei-ai (--version)
-@ty_krystal/sei-ai/0.1.8 linux-x64 node-v24.17.0
+@ty_krystal/sei-ai/0.1.12 linux-x64 node-v24.17.0
 $ sei-ai --help [COMMAND]
 USAGE
   $ sei-ai COMMAND
@@ -82,8 +82,6 @@ DESCRIPTION
   Fetches the SEI OpenAPI document and renders a markdown or JSON summary.
 ```
 
-_See code: [src/commands/api-docs.ts](https://github.com/tanyu/sei-ai/blob/v0.1.8/src/commands/api-docs.ts)_
-
 ## `sei-ai call METHOD PATH`
 
 Call a SEI endpoint
@@ -121,8 +119,6 @@ DESCRIPTION
   Makes an authenticated request to a SEI endpoint.
 ```
 
-_See code: [src/commands/call.ts](https://github.com/tanyu/sei-ai/blob/v0.1.8/src/commands/call.ts)_
-
 ## `sei-ai dict:add-category NAME TYPECODE`
 
 Add a dictionary category
@@ -165,8 +161,6 @@ DESCRIPTION
   Builds and saves a SEI dictionary category row.
 ```
 
-_See code: [src/commands/dict/add-category.ts](https://github.com/tanyu/sei-ai/blob/v0.1.8/src/commands/dict/add-category.ts)_
-
 ## `sei-ai dict:add-item CODE NAME TYPECODE`
 
 Add a dictionary item
@@ -210,8 +204,6 @@ DESCRIPTION
   Builds and saves a SEI dictionary item row.
 ```
 
-_See code: [src/commands/dict/add-item.ts](https://github.com/tanyu/sei-ai/blob/v0.1.8/src/commands/dict/add-item.ts)_
-
 ## `sei-ai dict:list`
 
 List dictionary entries
@@ -244,8 +236,6 @@ DESCRIPTION
   Queries SEI dictionary data and optionally renders the tree structure.
 ```
 
-_See code: [src/commands/dict/list.ts](https://github.com/tanyu/sei-ai/blob/v0.1.8/src/commands/dict/list.ts)_
-
 ## `sei-ai help [COMMAND]`
 
 Display help for sei-ai.
@@ -303,8 +293,6 @@ DESCRIPTION
   Executes the base seed SQL and clears SEI caches.
 ```
 
-_See code: [src/commands/init/base-data.ts](https://github.com/tanyu/sei-ai/blob/v0.1.8/src/commands/init/base-data.ts)_
-
 ## `sei-ai plugins`
 
 List installed plugins.
@@ -626,8 +614,6 @@ DESCRIPTION
   Sends a SEI query payload.
 ```
 
-_See code: [src/commands/query.ts](https://github.com/tanyu/sei-ai/blob/v0.1.8/src/commands/query.ts)_
-
 ## `sei-ai query-sql SQL`
 
 Query SEI with SQL
@@ -664,8 +650,6 @@ ALIASES
   $ sei-ai sql
 ```
 
-_See code: [src/commands/query-sql.ts](https://github.com/tanyu/sei-ai/blob/v0.1.8/src/commands/query-sql.ts)_
-
 ## `sei-ai relogin`
 
 Refresh the login token
@@ -692,8 +676,6 @@ DESCRIPTION
   Forces a fresh ai-login and prints the new token.
 ```
 
-_See code: [src/commands/relogin.ts](https://github.com/tanyu/sei-ai/blob/v0.1.8/src/commands/relogin.ts)_
-
 ## `sei-ai save`
 
 Save SEI data
@@ -725,8 +707,6 @@ DESCRIPTION
   Sends a SEI save payload.
 ```
 
-_See code: [src/commands/save.ts](https://github.com/tanyu/sei-ai/blob/v0.1.8/src/commands/save.ts)_
-
 ## `sei-ai sql SQL`
 
 Query SEI with SQL

package/dist/commands/api-docs.d.ts

@@ -1,4 +1,4 @@
-import { SeiCommand } from '@ty_krystal/sei-ai-core';
+import { SeiCommand } from '../core/index.js';
 export default class ApiDocsCommand extends SeiCommand {
     static description: string;
     static flags: {

package/dist/commands/api-docs.js

@@ -1,5 +1,5 @@
 import { Flags } from '@oclif/core';
-import { runApiDocs, SeiCommand } from '@ty_krystal/sei-ai-core';
+import { runApiDocs, SeiCommand } from '../core/index.js';
 export default class ApiDocsCommand extends SeiCommand {
     static description = 'Fetches the SEI OpenAPI document and renders a markdown or JSON summary.';
     static flags = {

package/dist/commands/call.d.ts

@@ -1,4 +1,4 @@
-import { SeiCommand } from '@ty_krystal/sei-ai-core';
+import { SeiCommand } from '../core/index.js';
 export default class CallCommand extends SeiCommand {
     static args: {
         method: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;

package/dist/commands/call.js

@@ -1,5 +1,5 @@
 import { Args, Flags } from '@oclif/core';
-import { runCall, SeiCommand } from '@ty_krystal/sei-ai-core';
+import { runCall, SeiCommand } from '../core/index.js';
 export default class CallCommand extends SeiCommand {
     static args = {
         method: Args.string({ description: 'HTTP method', required: true }),

package/dist/commands/dict/add-category.d.ts

@@ -1,4 +1,4 @@
-import { SeiCommand } from '@ty_krystal/sei-ai-core';
+import { SeiCommand } from '../../core/index.js';
 export default class DictAddCategoryCommand extends SeiCommand {
     static args: {
         name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;

package/dist/commands/dict/add-category.js

@@ -1,5 +1,5 @@
 import { Args, Flags } from '@oclif/core';
-import { runDictAddCategory, SeiCommand } from '@ty_krystal/sei-ai-core';
+import { runDictAddCategory, SeiCommand } from '../../core/index.js';
 export default class DictAddCategoryCommand extends SeiCommand {
     static args = {
         name: Args.string({ description: '字典名称', required: true }),

package/dist/commands/dict/add-item.d.ts

@@ -1,4 +1,4 @@
-import { SeiCommand } from '@ty_krystal/sei-ai-core';
+import { SeiCommand } from '../../core/index.js';
 export default class DictAddItemCommand extends SeiCommand {
     static args: {
         code: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;

package/dist/commands/dict/add-item.js

@@ -1,5 +1,5 @@
 import { Args, Flags } from '@oclif/core';
-import { runDictAddItem, SeiCommand } from '@ty_krystal/sei-ai-core';
+import { runDictAddItem, SeiCommand } from '../../core/index.js';
 export default class DictAddItemCommand extends SeiCommand {
     static args = {
         code: Args.string({ description: '字典项编码', required: true }),

package/dist/commands/dict/list.d.ts

@@ -1,4 +1,4 @@
-import { SeiCommand } from '@ty_krystal/sei-ai-core';
+import { SeiCommand } from '../../core/index.js';
 export default class DictListCommand extends SeiCommand {
     static description: string;
     static flags: {

package/dist/commands/dict/list.js

@@ -1,5 +1,5 @@
 import { Flags } from '@oclif/core';
-import { runDictList, SeiCommand } from '@ty_krystal/sei-ai-core';
+import { runDictList, SeiCommand } from '../../core/index.js';
 export default class DictListCommand extends SeiCommand {
     static description = 'Queries SEI dictionary data and optionally renders the tree structure.';
     static flags = {

package/dist/commands/init/base-data.d.ts

@@ -1,4 +1,4 @@
-import { SeiCommand } from '@ty_krystal/sei-ai-core';
+import { SeiCommand } from '../../core/index.js';
 export default class InitBaseDataCommand extends SeiCommand {
     static description: string;
     static flags: {

package/dist/commands/init/base-data.js

@@ -1,5 +1,5 @@
 import { Flags } from '@oclif/core';
-import { runInitBaseData, SeiCommand } from '@ty_krystal/sei-ai-core';
+import { runInitBaseData, SeiCommand } from '../../core/index.js';
 export default class InitBaseDataCommand extends SeiCommand {
     static description = 'Executes the base seed SQL and clears SEI caches.';
     static flags = {

package/dist/commands/query-sql.d.ts

@@ -1,4 +1,4 @@
-import { SeiCommand } from '@ty_krystal/sei-ai-core';
+import { SeiCommand } from '../core/index.js';
 export default class QuerySqlCommand extends SeiCommand {
     static aliases: string[];
     static args: {

package/dist/commands/query-sql.js

@@ -1,5 +1,5 @@
 import { Args, Flags } from '@oclif/core';
-import { buildQuerySqlPayload, runQuerySql, SeiCommand } from '@ty_krystal/sei-ai-core';
+import { buildQuerySqlPayload, runQuerySql, SeiCommand } from '../core/index.js';
 export default class QuerySqlCommand extends SeiCommand {
     static aliases = ['sql'];
     static args = {

package/dist/commands/query.d.ts

@@ -1,4 +1,4 @@
-import { SeiCommand } from '@ty_krystal/sei-ai-core';
+import { SeiCommand } from '../core/index.js';
 export default class QueryCommand extends SeiCommand {
     static description: string;
     static flags: {

package/dist/commands/query.js

@@ -1,5 +1,5 @@
 import { Flags } from '@oclif/core';
-import { runQuery, SeiCommand } from '@ty_krystal/sei-ai-core';
+import { runQuery, SeiCommand } from '../core/index.js';
 export default class QueryCommand extends SeiCommand {
     static description = 'Sends a SEI query payload.';
     static flags = {

package/dist/commands/relogin.d.ts

@@ -1,4 +1,4 @@
-import { SeiCommand } from '@ty_krystal/sei-ai-core';
+import { SeiCommand } from '../core/index.js';
 export default class ReloginCommand extends SeiCommand {
     static description: string;
     static flags: {

package/dist/commands/relogin.js

@@ -1,4 +1,4 @@
-import { runRelogin, SeiCommand } from '@ty_krystal/sei-ai-core';
+import { runRelogin, SeiCommand } from '../core/index.js';
 export default class ReloginCommand extends SeiCommand {
     static description = 'Forces a fresh ai-login and prints the new token.';
     static flags = {

package/dist/commands/save.d.ts

@@ -1,4 +1,4 @@
-import { SeiCommand } from '@ty_krystal/sei-ai-core';
+import { SeiCommand } from '../core/index.js';
 export default class SaveCommand extends SeiCommand {
     static description: string;
     static flags: {

package/dist/commands/save.js

@@ -1,5 +1,5 @@
 import { Flags } from '@oclif/core';
-import { runSave, SeiCommand } from '@ty_krystal/sei-ai-core';
+import { runSave, SeiCommand } from '../core/index.js';
 export default class SaveCommand extends SeiCommand {
     static description = 'Sends a SEI save payload.';
     static flags = {

package/dist/commands.d.ts

@@ -0,0 +1,24 @@
+import ApiDocsCommand from './commands/api-docs.js';
+import CallCommand from './commands/call.js';
+import DictAddCategoryCommand from './commands/dict/add-category.js';
+import DictAddItemCommand from './commands/dict/add-item.js';
+import DictListCommand from './commands/dict/list.js';
+import InitBaseDataCommand from './commands/init/base-data.js';
+import QuerySqlCommand from './commands/query-sql.js';
+import QueryCommand from './commands/query.js';
+import ReloginCommand from './commands/relogin.js';
+import SaveCommand from './commands/save.js';
+declare const _default: {
+    readonly 'api-docs': typeof ApiDocsCommand;
+    readonly call: typeof CallCommand;
+    readonly 'dict:add-category': typeof DictAddCategoryCommand;
+    readonly 'dict:add-item': typeof DictAddItemCommand;
+    readonly 'dict:list': typeof DictListCommand;
+    readonly 'init:base-data': typeof InitBaseDataCommand;
+    readonly query: typeof QueryCommand;
+    readonly 'query-sql': typeof QuerySqlCommand;
+    readonly relogin: typeof ReloginCommand;
+    readonly save: typeof SaveCommand;
+    readonly sql: typeof QuerySqlCommand;
+};
+export default _default;

package/dist/commands.js

@@ -0,0 +1,23 @@
+import ApiDocsCommand from './commands/api-docs.js';
+import CallCommand from './commands/call.js';
+import DictAddCategoryCommand from './commands/dict/add-category.js';
+import DictAddItemCommand from './commands/dict/add-item.js';
+import DictListCommand from './commands/dict/list.js';
+import InitBaseDataCommand from './commands/init/base-data.js';
+import QuerySqlCommand from './commands/query-sql.js';
+import QueryCommand from './commands/query.js';
+import ReloginCommand from './commands/relogin.js';
+import SaveCommand from './commands/save.js';
+export default {
+    'api-docs': ApiDocsCommand,
+    call: CallCommand,
+    'dict:add-category': DictAddCategoryCommand,
+    'dict:add-item': DictAddItemCommand,
+    'dict:list': DictListCommand,
+    'init:base-data': InitBaseDataCommand,
+    query: QueryCommand,
+    'query-sql': QuerySqlCommand,
+    relogin: ReloginCommand,
+    save: SaveCommand,
+    sql: QuerySqlCommand,
+};

package/dist/core/cli-actions.d.ts

@@ -0,0 +1,94 @@
+export declare function runApiDocs(options: {
+    client: {
+        readApiDocs(): Promise<unknown>;
+    };
+    keyword?: string;
+    format?: 'json' | 'markdown';
+    outputPath?: string;
+}): Promise<void>;
+export declare function runRelogin(options: {
+    client: {
+        relogin(): Promise<string>;
+    };
+}): Promise<void>;
+export declare function runCall(options: {
+    client: {
+        call(method: string, path: string, payload?: unknown, requestOptions?: Record<string, unknown>): Promise<unknown>;
+    };
+    method: string;
+    path: string;
+    payload?: unknown;
+    allowFailure?: boolean;
+    allowEmpty?: boolean;
+    skipAuth?: boolean;
+}): Promise<void>;
+export declare function runQuery(options: {
+    client: {
+        query(payload: unknown, requestOptions?: Record<string, unknown>): Promise<unknown>;
+    };
+    payload: unknown;
+    allowFailure?: boolean;
+}): Promise<void>;
+export declare function runSave(options: {
+    client: {
+        save(payload: unknown, requestOptions?: Record<string, unknown>): Promise<unknown>;
+    };
+    payload: unknown;
+    allowFailure?: boolean;
+}): Promise<void>;
+export declare function runQuerySql(options: {
+    client: {
+        querySql(sql: string, page?: number, size?: number, requestOptions?: Record<string, unknown>): Promise<unknown>;
+    };
+    sql: string;
+    page?: number;
+    size?: number;
+    allowFailure?: boolean;
+}): Promise<void>;
+export declare function runDictList(options: {
+    client: {
+        query(payload: unknown, requestOptions?: Record<string, unknown>): Promise<unknown>;
+    };
+    typeCode?: string;
+    keyword?: string;
+    size?: number;
+    flat?: boolean;
+    allowFailure?: boolean;
+}): Promise<void>;
+export declare function runDictAddCategory(options: {
+    client: {
+        save(payload: unknown, requestOptions?: Record<string, unknown>): Promise<unknown>;
+    };
+    typeCode: string;
+    name: string;
+    rowOptions?: Record<string, unknown>;
+    allowFailure?: boolean;
+}): Promise<void>;
+export declare function runDictAddItem(options: {
+    client: {
+        save(payload: unknown, requestOptions?: Record<string, unknown>): Promise<unknown>;
+    };
+    typeCode: string;
+    code: string;
+    name: string;
+    rowOptions?: Record<string, unknown>;
+    allowFailure?: boolean;
+}): Promise<void>;
+export declare function runInitBaseData(options: {
+    client: {
+        executeDdlStatements(statements: string[], requestOptions?: Record<string, unknown>): Promise<unknown>;
+        call(method: string, path: string, payload?: unknown, requestOptions?: Record<string, unknown>): Promise<unknown>;
+    };
+    sqlFile?: string;
+    sysid?: string;
+    adminUid?: string;
+    adminName?: string;
+    adminRole?: string;
+    adminRoleName?: string;
+    adminPassword?: string;
+    resetAdminPassword?: boolean;
+    allowFailure?: boolean;
+}): Promise<void>;
+export declare function writeOutput(path: string | undefined, text: string): Promise<void>;
+export declare function resolveBaseSeedSqlPath(path: string | undefined): string;
+export declare function formatActionError(error: unknown): string;

package/dist/core/cli-actions.js

@@ -0,0 +1,155 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { BASE_SEED_DEFAULT_ADMIN_ROLE, BASE_SEED_DEFAULT_ADMIN_UID } from './constants.js';
+import { formatCliError, SeiMcpError } from './errors.js';
+import { buildBaseSeedSqlVars, buildDictCategoryRow, buildDictItemRow, buildDictQueryPayload, buildDictSavePayload, buildDictTree, removeSqlCommentLines, renderBaseSeedSql, splitSqlStatements, } from './cli-helpers.js';
+import { printJson } from './command-base/output.js';
+import { buildOpenApiDocSummary, renderOpenApiMarkdown } from './openapi.js';
+export async function runApiDocs(options) {
+    const raw = await options.client.readApiDocs();
+    const summary = buildOpenApiDocSummary(raw, options.keyword);
+    const output = options.format === 'json' ? `${JSON.stringify(summary, null, 2)}\n` : renderOpenApiMarkdown(summary);
+    await writeOutput(options.outputPath, output);
+}
+export async function runRelogin(options) {
+    const token = await options.client.relogin();
+    printJson({
+        success: true,
+        code: 1,
+        message: '重新登录成功',
+        data: { token },
+    });
+}
+export async function runCall(options) {
+    const response = await options.client.call(options.method, options.path, options.payload, {
+        allowFailure: options.allowFailure,
+        allowEmpty: options.allowEmpty,
+        skipAuth: options.skipAuth,
+    });
+    printJson(response);
+}
+export async function runQuery(options) {
+    const response = await options.client.query(options.payload, {
+        allowFailure: options.allowFailure,
+    });
+    printJson(response);
+}
+export async function runSave(options) {
+    const response = await options.client.save(options.payload, {
+        allowFailure: options.allowFailure,
+    });
+    printJson(response);
+}
+export async function runQuerySql(options) {
+    const response = await options.client.querySql(options.sql, options.page, options.size, {
+        allowFailure: options.allowFailure,
+    });
+    printJson(response);
+}
+export async function runDictList(options) {
+    const payload = buildDictQueryPayload(options.typeCode, options.keyword, options.size ?? 1000);
+    const response = await options.client.query(payload, {
+        allowFailure: options.allowFailure,
+    });
+    if (!options.flat && isObject(response) && isObject(response.data) && Array.isArray(response.data.rows)) {
+        response.data.tree = buildDictTree(response.data.rows);
+    }
+    printJson(response);
+}
+export async function runDictAddCategory(options) {
+    const payload = buildDictSavePayload(buildDictCategoryRow({
+        body: stringOrUndefined(options.rowOptions?.body),
+        code: stringOrUndefined(options.rowOptions?.code),
+        ctype: stringOrUndefined(options.rowOptions?.ctype),
+        dictFlag: numberOrUndefined(options.rowOptions?.dictFlag),
+        ename: stringOrUndefined(options.rowOptions?.ename),
+        memo: stringOrUndefined(options.rowOptions?.memo),
+        name: options.name,
+        sort: numberOrUndefined(options.rowOptions?.sort),
+        sysid: stringOrUndefined(options.rowOptions?.sysid),
+        typeCode: options.typeCode,
+        uuid: stringOrUndefined(options.rowOptions?.uuid),
+    }));
+    const response = await options.client.save(payload, {
+        allowFailure: options.allowFailure,
+    });
+    printJson(response);
+}
+export async function runDictAddItem(options) {
+    const payload = buildDictSavePayload(buildDictItemRow({
+        body: stringOrUndefined(options.rowOptions?.body),
+        code: options.code,
+        ctype: stringOrUndefined(options.rowOptions?.ctype),
+        dictFlag: numberOrUndefined(options.rowOptions?.dictFlag),
+        ename: stringOrUndefined(options.rowOptions?.ename),
+        memo: stringOrUndefined(options.rowOptions?.memo),
+        name: options.name,
+        parent: stringOrUndefined(options.rowOptions?.parent),
+        sort: numberOrUndefined(options.rowOptions?.sort),
+        sysid: stringOrUndefined(options.rowOptions?.sysid),
+        typeCode: options.typeCode,
+        uuid: stringOrUndefined(options.rowOptions?.uuid),
+    }));
+    const response = await options.client.save(payload, {
+        allowFailure: options.allowFailure,
+    });
+    printJson(response);
+}
+export async function runInitBaseData(options) {
+    const sqlFile = resolveBaseSeedSqlPath(options.sqlFile);
+    const template = await readFile(sqlFile, 'utf8');
+    const sql = renderBaseSeedSql(template, buildBaseSeedSqlVars({
+        adminName: options.adminName,
+        adminPassword: options.adminPassword,
+        adminRole: options.adminRole,
+        adminRoleName: options.adminRoleName,
+        adminUid: options.adminUid,
+        resetAdminPassword: options.resetAdminPassword,
+        sysid: options.sysid,
+    }));
+    const statements = splitSqlStatements(removeSqlCommentLines(sql));
+    if (statements.length === 0) {
+        throw new SeiMcpError('初始化 SQL 文件没有可执行语句', 'INVALID_PARAMS');
+    }
+    const executed = await options.client.executeDdlStatements(statements, {
+        allowFailure: options.allowFailure,
+    });
+    await options.client.call('POST', '/api/sei/data/removeAllCache', {}, { allowFailure: false }).catch(() => undefined);
+    printJson({
+        success: true,
+        code: 1,
+        message: '基础源数据初始化完成',
+        data: {
+            executed: Array.isArray(executed) ? executed.length : 0,
+            sqlFile,
+            admin: options.adminUid ?? BASE_SEED_DEFAULT_ADMIN_UID,
+            role: options.adminRole ?? BASE_SEED_DEFAULT_ADMIN_ROLE,
+        },
+    });
+}
+export async function writeOutput(path, text) {
+    if (!path) {
+        process.stdout.write(text);
+        return;
+    }
+    await writeFile(path, text, 'utf8');
+    process.stdout.write(`已写入：${path}\n`);
+}
+export function resolveBaseSeedSqlPath(path) {
+    if (path) {
+        return resolve(path);
+    }
+    return resolve(process.cwd(), '.codex/skills/sei-ai/scripts/init-base-data.sql');
+}
+export function formatActionError(error) {
+    return formatCliError(error);
+}
+function stringOrUndefined(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function numberOrUndefined(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}

package/dist/core/cli-helpers.d.ts

@@ -0,0 +1,39 @@
+export interface DictRowInput {
+    body?: string;
+    ctype?: string;
+    dictFlag?: number;
+    ename?: string;
+    memo?: string;
+    sort?: number;
+    sysid?: string;
+    uuid?: string;
+}
+export interface DictCategoryInput extends DictRowInput {
+    code?: string;
+    name: string;
+    typeCode: string;
+}
+export interface DictItemInput extends DictRowInput {
+    code: string;
+    name: string;
+    parent?: string;
+    typeCode: string;
+}
+export interface InitBaseDataInput {
+    adminName?: string;
+    adminPassword?: string;
+    adminRole?: string;
+    adminRoleName?: string;
+    adminUid?: string;
+    resetAdminPassword?: boolean;
+    sysid?: string;
+}
+export declare function buildDictQueryPayload(typeCode?: string, keyword?: string, size?: number): Record<string, unknown>;
+export declare function buildDictSavePayload(row: Record<string, unknown>): Record<string, unknown>;
+export declare function buildDictCategoryRow(input: DictCategoryInput): Record<string, unknown>;
+export declare function buildDictItemRow(input: DictItemInput): Record<string, unknown>;
+export declare function buildDictTree(rows: unknown): Array<Record<string, unknown>>;
+export declare function buildBaseSeedSqlVars(input: InitBaseDataInput): Record<string, string>;
+export declare function renderBaseSeedSql(template: string, values: Record<string, string>): string;
+export declare function removeSqlCommentLines(sql: string): string;
+export declare function splitSqlStatements(sql: string): string[];