ac-storage 0.16.2 → 0.16.4

package/afron/packages/types/types/ipc/invokers.d.ts

@@ -0,0 +1,181 @@
+import { ChatAIModelData } from '../chatai/chatai-model';
+import { GlobalModelConfiguration, ProfileStorage } from '../storage-struct';
+import { RTMetadata, RTMetadataTree } from '../rt/rt';
+import { RTFormNaive, RTPromptDataEditable, RTPromptMetadata } from '../rt/form';
+import { RTFlowData } from '../rt';
+
+import { EResult, ENoResult, } from './result';
+import { CustomModel, HistoryMessage, HistoryMetadata, HistorySearch, InputFileHash, InputFilePreview, InputFilesUpdateInfo, VersionInfo } from './data';
+import { KeyValueInput } from './declared';
+import { RTVar, RTVarCreate, RTVarUpdate } from '../rt-var';
+
+export interface IPCInvokerGeneral {
+    echo(message: string): EResult<string>;
+    openBrowser(url: string): ENoResult;
+    getCurrentVersion(): EResult<string>;
+    getAvailableVersion(prerelease: boolean): EResult<VersionInfo>;
+    getChatAIModels(): EResult<ChatAIModelData>;
+
+    existsLegacyData(): EResult<boolean>;
+    migrateLegacyData(): ENoResult;
+    ignoreLegacyData(): ENoResult;
+}
+export declare namespace IPCInvokers {
+    interface General {
+        echo(message: string): EResult<string>;
+        openBrowser(url: string): ENoResult;
+        getCurrentVersion(): EResult<string>;
+        getAvailableVersion(prerelease: boolean): EResult<VersionInfo>;
+        getChatAIModels(): EResult<ChatAIModelData>;
+
+        existsLegacyData(): EResult<boolean>;
+        migrateLegacyData(): ENoResult;
+        ignoreLegacyData(): ENoResult;
+    }
+
+    interface GlobalStorage {
+        get(storageName: string, keys: string[]): EResult<Record<string, any>>;
+        set(storageName: string, data: KeyValueInput): ENoResult;
+    }
+
+    interface MasterKey {
+        init(): EResult<'normal' | 'need-recovery' | 'no-data' | 'invalid-data'>;
+        reset(recoveryKey: string): ENoResult;
+        recover(recoveryKey: string): EResult<boolean>;
+    }
+
+    interface Profiles {
+        create(): EResult<string>;
+        delete(profileName: string): ENoResult;
+        getIds(): EResult<string[]>;
+
+        getLast(): EResult<string | null>;
+        setLast(profileName: string | null): ENoResult;
+
+        getOrphanIds(): EResult<string[]>;
+        recoverOrphan(profileId: string): ENoResult;
+    }
+
+    interface Profile {
+        getCustomModels(profileId: string): EResult<CustomModel[]>;
+        setCustomModel(profileId: string, model: CustomModel): EResult<string>;
+        removeCustomModel(profileId: string, customId: string): ENoResult;
+
+        getGlobalModelConfig(profileId: string, modelId: string): EResult<GlobalModelConfiguration>;
+        setGlobalModelConfig(profileId: string, modelId: string, config: GlobalModelConfiguration): ENoResult;
+    }
+
+    interface ProfileStorage {
+        get(profileId: string, accessor: string, keys: string[]): EResult<Record<string, any>>;
+        set(profileId: string, accessor: string, data: KeyValueInput): ENoResult;
+        getAsText(profileId: string, accessor: string): EResult<string>;
+        setAsText(profileId: string, accessor: string, value: string): ENoResult;
+        getAsBinary(profileId: string, accessor: string): EResult<Buffer>;
+        setAsBinary(profileId: string, accessor: string, content: Buffer): ENoResult;
+        verifyAsSecret(profileId: string, accessor: string, keys: string[]): EResult<boolean[]>;
+        setAsSecret(profileId: string, accessor: string, data: KeyValueInput): ENoResult;
+        removeAsSecret(profileId: string, accessor: string, keys: string[]): ENoResult;
+    }
+
+    interface ProfileSessions {
+        add(profileId: string): EResult<string>;
+        remove(profileId: string, sessionId: string): ENoResult;
+        undoRemoved(profileId: string): EResult<string>;
+        reorder(profileId: string, sessions: string[]): ENoResult;
+        getIds(profileId: string): EResult<string[]>;
+    }
+
+    interface ProfileSession {
+        getFormValues(profileId: string, sessionId: string, rtId: string): EResult<Record<string, any>>;
+        setFormValues(profileId: string, sessionId: string, rtId: string, values: Record<string, any>): ENoResult;
+    }
+
+    interface ProfileSessionStorage {
+        get(profileId: string, sessionId: string, accessor: string, keys: string[]): EResult<Record<string, any>>;
+        set(profileId: string, sessionId: string, accessor: string, key: KeyValueInput): ENoResult;
+        // getInputFiles(profileId: string, sessionId: string, fileHashes: string[]): EResult<InputFileEntry[]>;
+        getInputFilePreviews(profileId: string, sessionId: string): EResult<InputFilePreview[]>;
+        addInputFile(profileId: string, sessionId: string, filename: string, dataURI: string): EResult<InputFilePreview>;
+        updateInputFiles(profileId: string, sessionId: string, fileHashes: InputFileHash[]): EResult<InputFilesUpdateInfo>;
+    }
+
+    interface ProfileSessionHistory {
+        get(profileId: string, sessionId: string, offset: number, limit: number, desc: boolean): EResult<HistoryMetadata[]>;
+        search(profileId: string, sessionId: string, offset: number, limit: number, search: HistorySearch): EResult<HistoryMetadata[]>;
+        getMessage(profileId: string, sessionId: string, historyId: number[]): EResult<HistoryMessage[]>;
+        deleteMessage(profileId: string, sessionId: string, historyId: number, origin: 'in' | 'out' | 'both'): ENoResult;
+        delete(profileId: string, sessionId: string, historyKey: number): ENoResult;
+        deleteAll(profileId: string, sessionId: string): ENoResult;
+    }
+
+    interface ProfileRTs {
+        getTree(profileId: string): EResult<RTMetadataTree>;
+        updateTree(profileId: string, tree: RTMetadataTree): ENoResult;
+        /** @deprecated use createUsingTemplate instead */
+        add(profileId: string, rt: RTMetadata): ENoResult;
+        createUsingTemplate(profileId: string, rtMetadata: RTMetadata, templateId: string): ENoResult;
+        remove(profileId: string, rtId: string): ENoResult;
+
+        existsId(profileId: string, rtId: string): EResult<boolean>;
+
+        generateId(profileId: string): EResult<string>;
+        changeId(profileId: string, oldRTId: string, newRTId: string): ENoResult;
+
+        importFile(token: string, profileId: string): ENoResult;
+        exportFile(token: string, profileId: string, rtId: string): ENoResult;
+    }
+
+    interface ProfileRT {
+        getMetadata(profileId: string, rtId: string): EResult<ProfileStorage.RT.Index>;
+        setMetadata(profileId: string, rtId: string, metadata: KeyValueInput): ENoResult;
+        reflectMetadata(profileId: string, rtId: string): ENoResult;
+
+        getForms(profileId: string, rtId: string): EResult<RTFormNaive[]>;
+    }
+
+    interface ProfileRTStorage {
+        get(profileId: string, rtId: string, accessor: string, keys: string[]): EResult<Record<string, any>>;
+        set(profileId: string, rtId: string, accessor: string, data: KeyValueInput): ENoResult;
+    }
+
+    interface ProfileRTPrompt {
+        getMetadata(profileId: string, rtId: string, promptId: string): EResult<RTPromptMetadata>;
+        setMetadata(profileId: string, rtId: string, promptId: string, metadata: RTPromptDataEditable): ENoResult;
+
+        getName(profileId: string, rtId: string, promptId: string): EResult<string>;
+        setName(profileId: string, rtId: string, promptId: string, name: string): ENoResult;
+
+        getVariableNames(profileId: string, rtId: string, promptId: string): EResult<string[]>;
+
+        getVariables(profileId: string, rtId: string, promptId: string): EResult<RTVar[]>;
+        setVariables(profileId: string, rtId: string, promptId: string, forms: (RTVarCreate | RTVarUpdate)[]): EResult<string[]>;
+        removeVariables(profileId: string, rtId: string, promptId: string, formIds: string[]): ENoResult;
+        getContents(profileId: string, rtId: string, promptId: string): EResult<string>;
+        setContents(profileId: string, rtId: string, promptId: string, contents: string): ENoResult;
+    }
+
+    interface ProfileRTFlow {
+        getFlowData(profileId: string, rtId: string): EResult<RTFlowData>;
+        setFlowData(profileId: string, rtId: string, data: RTFlowData): ENoResult;
+
+        getPrompts(profileId: string, rtId: string): EResult<ProfileStorage.RT.PromptOrder>;
+        setPrompts(profileId: string, rtId: string, order: ProfileStorage.RT.PromptOrder): ENoResult;
+
+        /**
+         * 프롬프트 추가
+         * @return 갱신된 프롬프트 순서 정보 
+         */
+        addPrompt(profileId: string, rtId: string, promptId: string, promptName: string): EResult<ProfileStorage.RT.PromptOrder>;
+        /**
+         * 프롬프트 제거
+         * @return 갱신된 프롬프트 순서 정보 
+         */
+        removePrompt(profileId: string, rtId: string, promptId: string): EResult<ProfileStorage.RT.PromptOrder>;
+    }
+
+    interface Request {
+        requestRT(token: string, profileId: string, sessionId: string): ENoResult;
+        previewPrompt(token: string, profileId: string, sessionId: string): ENoResult;
+        abort(token: string): ENoResult;
+    }
+}

package/afron/packages/types/types/ipc/listeners.d.ts

@@ -0,0 +1,7 @@
+import { ENoResult, EResult } from  './result';
+
+export type IPCListenersInterface = {
+    AddRequestListener(listener: (event: any, token: string, data: any) => void): EResult<number>;
+    RemoveRequestListener(bindId: number): ENoResult;
+}
+

package/afron/packages/types/types/ipc/result.d.ts

@@ -0,0 +1,3 @@
+export type EError = { name: string, message: string, [key: string]: any };
+export type EResult<T> = Promise<readonly [EError] | readonly [null, T]>;
+export type ENoResult = Promise<readonly [EError | null]>;

package/afron/packages/types/types/ipc-invokers.d.ts

@@ -0,0 +1,111 @@
+/**
+ * electron에서 ipcRenderer.invoke() 를 통해 front로 노출시킬 명령어
+ * 
+ * share/ipc-command.d.ts 와 electron/types/ipc.ts 는 동일하게 유지되어야 함
+ */
+export enum IPCInvokerName {
+    Echo = 'Echo',
+    OpenBrowser = 'OpenBrowser',
+    GetChatAIModels = 'GetChatAIModels',
+    
+    /* 요청 수행 */
+    FetchData = 'FetchData',
+    AbortFetchRequest = 'AbortFetchRequest',
+    GetFetchResponse = 'GetFetchResponse',
+
+    /* 마스터 키 */
+    InitMasterKey = 'InitMasterKey',
+    ResetMasterKey = 'ResetMasterKey',
+    RecoverMasterKey = 'RecoverMasterKey',
+
+    /* 전역 스토리지 */
+    GetGlobalData = 'GetGlobalData',
+    SetGlobalData = 'SetGlobalData',
+
+    /* 프로필 */
+    CreateProfile = 'CreateProfile',
+    DeleteProfile = 'DeleteProfile',
+
+    /* 프로필 목록 */
+    GetProfileList = 'GetProfileList',
+    GetLastProfile = 'GetLastProfile',
+    SetLastProfile = 'SetLastProfile',
+    
+    /* 프로필 저장소 */
+    GetProfileData = 'GetProfileData',
+    SetProfileData = 'SetProfileData',
+    PushProfileDataToArray = 'PushProfileDataToArray',
+    GetProfileDataAsText = 'GetProfileDataAsText',
+    SetProfileDataAsText = 'SetProfileDataAsText',
+    GetProfileDataAsBinary = 'GetProfileDataAsBinary',
+    SetProfileDataAsBinary = 'SetProfileDataAsBinary',
+    VerifyProfileDataAsSecret = 'VerifyProfileDataAsSecret',
+    SetProfileDataAsSecret = 'SetProfileDataAsSecret',
+    RemoveProfileDataAsSecret = 'RemoveProfileDataAsSecret',
+    PushProfileDataToArrayAsSecret = 'PushProfileDataToArrayAsSecret',
+    
+    /* 프로필 프롬프트 */
+    GetProfilePromptTree = 'GetProfilePromptTree',
+    UpdateProfilePromptTree = 'UpdateProfilePromptTree',
+    AddProfilePrompt = 'AddProfilePrompt',
+    RemoveProfilePrompt = 'RemoveProfilePrompt',
+
+    /* 프로필 세션 */
+    AddProfileSession = 'AddProfileSession',
+    RemoveProfileSession = 'RemoveProfileSession',
+    GetProfileSessionIds = 'GetProfileSessionIds',
+    ReorderProfileSessions = 'ReorderProfileSessions',
+    UndoRemoveProfileSession = 'UndoRemoveProfileSession',
+
+    /* 프로필 세션 저장소 */
+    GetProfileSessionData = 'GetProfileSessionData',
+    SetProfileSessionData = 'SetProfileSessionData',
+    
+    /* 프로필 세션 히스토리 */
+    GetProfileSessionHistoryMetadata = 'GetProfileSessionHistoryMetadata',
+    SearchProfileSessionHistoryMetadata = 'SearchProfileSessionHistoryMetadata',
+    GetProfileSessionHistoryMessage = 'GetProfileSessionHistoryMessage',
+    AddProfileSessionHistory = 'AddProfileSessionHistory',
+    DeleteProfileSessionHistory = 'DeleteProfileSessionHistory',
+    DeleteAllProfileSessionHistory = 'DeleteAllProfileSessionHistory',
+
+    /* 프로필 RT (전역) */
+    GetProfileRTTree = 'GetProfileRTTree',
+    UpdateProfileRTTree = 'UpdateProfileRTTree',
+    AddProfileRT = 'AddProfileRT',
+    RemoveProfileRT = 'RemoveProfileRT',
+    GetProfileRTMode = 'GetProfileRTMode',
+    SetProfileRTMode = 'SetProfileRTMode',
+    GetProfileRTPromptData = 'GetProfileRTPromptData',
+    SetProfileRTPromptData = 'SetProfileRTPromptData',
+    HasProfileRTId = 'HasProfileRTId',
+    GenerateProfileRTId = 'GenerateProfileRTId',
+    ChangeProfileRTId = 'ChangeProfileRTId',
+    GetProfileRTData = 'GetProfileRTData',
+    SetProfileRTData = 'SetProfileRTData',
+    ReflectProfileRTMetadata = 'ReflectProfileRTMetadata',
+
+    /* 프로필 RT */
+    AddProfileRTNode = 'AddProfileRTNode',
+    RemoveProfileRTNode = 'RemoveProfileRTNode',
+    UpdateProfileRTNodeData = 'UpdateProfileRTNodeData',
+    ConnectProfileRTNode = 'ConnectProfileRTNode',
+    DisconnectProfileRTNode = 'DisconnectProfileRTNode',
+
+    GetProfileRTMetadata = 'GetProfileRTMetadata',
+    SetProfileRTMetadata = 'SetProfileRTMetadata',
+
+    GetProfileRTPromptMetadata = 'GetProfileRTPromptMetadata',
+    SetProfileRTPromptMetadata = 'SetProfileRTPromptMetadata',
+    GetProfileRTPromptForms = 'GetProfileRTPromptForms',
+    SetProfileRTPromptForm = 'SetProfileRTPromptForm',
+    RemoveProfileRTPromptForm = 'RemoveProfileRTPromptForm',
+    GetProfileRTPromptContents = 'GetProfileRTPromptContents',
+    SetProfileRTPromptContents = 'SetProfileRTPromptContents',
+
+    /* 프로필 RT 요청 */
+    RequestProfileRT = 'RequestProfileRT',
+    AbortProfileRTRequest = 'AbortProfileRTRequest',
+}
+
+export {};

package/afron/packages/types/types/ipc-listeners.d.ts

@@ -0,0 +1,6 @@
+export enum IPCListenerName {
+    AddRequestListener = 'AddRequestListener',
+    RemoveRequestListener = 'RemoveRequestListener',
+}
+
+export {};

package/afron/packages/types/types/prompt-form.d.ts

@@ -0,0 +1,65 @@
+// declare global {
+//     type PromptVarType = 'text' | 'number' | 'checkbox' | 'select' | 'struct' | 'array';
+
+//     type PromptVar = (
+//         PromptVarText | PromptVarNumber | PromptVarCheckbox | PromptVarSelect | PromptVarStruct | PromptVarArray
+//     );
+
+//     type BasePromptVar = {
+//         /**
+//          * setter 작업시 id가 없다면 생성, 있다면 갱신 작업 수행
+//         */
+//         id?: string;
+//         name: string;
+//         display_name: string;
+
+//         include_type: 'form' | 'constant' | 'external';
+//         /** include_type='constant' 인 경우 값 */
+//         value?: unknown;
+//         /** include_type='external' 인 경우 외부 id 값 */
+//         external_id?: string;
+//         /**
+//          * include_type='form' 인 경우 외부 form Id
+//          * 
+//          * null인 경우 promptVar의 id가 form_id가 됨 (이전버전 호환성)
+//         */
+//         form_id?: string | null;
+//     }
+//     interface PromptVarText extends BasePromptVar {
+//         type: 'text';
+//         default_value?: string;
+//         placeholder: string;
+//         allow_multiline: boolean;
+//     }
+//     interface PromptVarNumber extends BasePromptVar {
+//         type: 'number';
+//         allow_decimal: boolean;
+//         default_value?: number;
+//         maximum_value?: number;
+//         minimum_value?: number;
+//     }
+//     interface PromptVarCheckbox extends BasePromptVar {
+//         type: 'checkbox';
+//         default_value?: boolean;
+//     }
+//     interface PromptVarSelect extends BasePromptVar {
+//         type: 'select';
+//         default_value?: string;
+//         options: {
+//             name: string;
+//             value: string;
+//         }[];
+//     }
+//     interface PromptVarStruct extends BasePromptVar {
+//         type: 'struct';
+//         fields: Exclude<PromptVar, PromptVarStruct | PromptVarArray>[];
+//     }
+//     interface PromptVarArray extends BasePromptVar {
+//         type: 'array';
+//         minimum_length?: number;
+//         maximum_length?: number;
+//         element: Exclude<PromptVar, PromptVarArray>;
+//     }
+// }
+
+export { };

package/afron/packages/types/types/rt/event.d.ts

@@ -0,0 +1,71 @@
+import '../prompt-form';
+
+type RTEventDataError = {
+    type: 'error'
+    detail: string[];
+} & (
+        {
+            reason_id:
+            'no_result'
+            | 'prompt_build_failed'
+            | 'prompt_execute_failed'
+            | 'fetch_failed'
+            | 'request_failed'
+            | 'invalid_model'
+            | 'aborted'
+            | 'other';
+        } | {
+            reason_id: 'http_error'
+            http_status: number;
+        } | {
+            reason_id: 'env_error';
+            title: string;
+        }
+    )
+type RTEventDataUpdate = {
+    type: 'update'
+    update_types: ('input' | 'output' | 'history')[];
+}
+type RTEventDataSend = {
+    type: 'send_raw_request_preview';
+    preview: RTEventPreviewData;
+} | {
+    type: 'send_info';
+
+    title: string;
+    description: string;
+    item: Array<{
+        name?: string;
+        value: string;
+    }>;
+}
+type RTEventDataOutput = {
+    type: 'stream_output';
+    text: string;
+} | {
+    type: 'clear_output';
+} | {
+    type: 'set_output';
+    text: string;
+}
+type RTEventDataOthers = {
+    type: 'close';
+}
+
+export type RTEventPreviewData = {
+    url: string;
+    headers: object;
+    data: object;
+};
+
+export type RTEventDataWithoutId = (
+    RTEventDataError
+    | RTEventDataSend
+    | RTEventDataUpdate
+    | RTEventDataOutput
+    | RTEventDataOthers
+);
+
+export type RTEventData = {
+    id: string;
+} & RTEventDataWithoutId;

package/afron/packages/types/types/rt/flow.d.ts

@@ -0,0 +1,63 @@
+import { SupportedVerbosity } from '../chatai';
+
+export type FlowNodeType = (
+    'rt-run'
+    | 'rt-output'
+    | 'prompt-template'
+    | 'llm-fetch'
+);
+
+export type RTFlowData = Record<string, RTFlowNodeData>;
+export type RTFlowNodeData<TData = Record<string, any>> = {
+    type: FlowNodeType;
+    description: string;
+    data: TData;
+    connection: Array<{
+        from_handle: string;
+        to_node: string;
+        to_handle: string;
+    }>;
+    position: {
+        x: number;
+        y: number;
+    };
+}
+
+export declare namespace RTFlowNodeOptions {
+    interface RTStart {
+        start_trigger: 'start' | 'press-button';
+
+        button_label: string;
+
+        include_chat_history: boolean;
+
+        allow_input_text: boolean;
+        allow_input_image: boolean;
+        allow_input_pdf: boolean;
+        allow_input_files: boolean;
+    }
+
+    interface PromptTemplate {
+        prompt_id: string | null;
+    }
+
+    interface LLM {
+        model: string;
+        model_selection: boolean;
+
+
+        temperature: number;
+        top_p: number;
+        max_tokens: number;
+        use_thinking: boolean;
+        thinking_tokens: number;
+        gpt_reasoning_effort: SupportedVerbosity;
+        gpt_verbosity: SupportedVerbosity;
+    }
+
+    interface Output {
+        include_history: boolean;
+    }
+}
+
+export { };

package/afron/packages/types/types/rt/form.d.ts

@@ -0,0 +1,41 @@
+import { ProfileStorage } from '../storage-struct';
+import { RTVarDataNaive, RTVarData } from '../rt-var';
+
+export type RTPromptMetadata = Pick<ProfileStorage.RT.Prompt,
+    'id' | 'name' | 'variables' | 'model'
+>
+
+export type RTPromptDataEditable = {
+    name?: string;
+    model?: {
+        temperature?: number;
+        top_p?: number;
+        max_tokens?: number;
+        use_thinking?: boolean;
+        thinking_tokens?: number;
+    };
+    contents?: string;
+}
+
+export type BaseRTForm = {
+    display_name: string;
+    display_on_header: boolean;
+}
+
+export type RTFormNaive = BaseRTForm & RTVarDataNaive & {
+    id: string;
+    refs: RTFormRef[];
+};
+export type RTForm = BaseRTForm & RTVarData & {
+    id: string;
+    refs: RTFormRef[];
+};
+
+/** 이 Form을 참조하는 RT 변수 */
+export type RTFormRef = {
+    type: 'prompt' | 'global';
+    prompt_id?: string;
+    variable_id: string;
+};
+
+export { }

package/afron/packages/types/types/rt/index.d.ts

@@ -0,0 +1,4 @@
+export * from './flow';
+export * from './form';
+export * from './event';
+export * from './rt';

package/afron/packages/types/types/rt/rt.d.ts

@@ -0,0 +1,61 @@
+import '../prompt-form';
+
+export type RTMetadata = {
+    name: string;
+    id: string;
+    mode: RTMode;
+}
+
+/** RT 트리 구조 */
+export type RTMetadataTree = (
+    RTMetadataNode | RTMetadataDirectory
+)[];
+export type RTMetadataNode = {
+    type: 'node';
+    name: string;
+    id: string;
+}
+export type RTMetadataDirectory = {
+    type: 'directory';
+    name: string;
+    children: RTMetadataNode[];
+}
+
+
+export declare namespace RTMetadatas {
+    type Tree = (Node | Directory)[]
+    type Node = {
+        type: 'node';
+        name: string;
+        id: string;
+    }
+    type Directory = {
+        type: 'directory';
+        name: string;
+        children: Node[];
+    }
+}
+
+
+export type RTMode = 'prompt_only' | 'flow';
+
+export type RTInput = {
+    input: string;
+    inputFiles: InputFile[];
+    chat?: RTInputMessage[];
+
+    form: Record<string, any>;
+    modelId: string;
+    rtId: string;
+    sessionId: string;
+}
+export type RTInputMessage = {
+    type: 'chat';
+    message: RTInputMessagePart[];
+}
+export type RTInputMessagePart = {
+    type: 'text' | 'image';
+    value: string;
+}
+
+export { };

package/afron/packages/types/types/rt-var/index.ts

@@ -0,0 +1,5 @@
+export * from './rt-var';
+export * from './rt-var-stored';
+export * from './rt-var-create';
+export * from './rt-var-update';
+export * from './var-data';

package/afron/packages/types/types/rt-var/rt-var-create.ts

@@ -0,0 +1,39 @@
+import { RTVarData } from './var-data';
+
+/**
+ * RTVar 생성 타입 정의
+ * 
+ * 기존 PromptVar과 비교해 id 필드의 유무로 생성 구분
+ */
+export type RTVarCreate = (
+    RTVarExternalCreate
+    | RTVarConstantCreate
+    | RTVarFormCreate
+);
+
+export type BaseRTVarCreate = {
+    name: string;
+}
+
+export interface RTVarExternalCreate extends BaseRTVarCreate {
+    include_type: 'external';
+    external_id: string;
+}
+export interface RTVarConstantCreate extends BaseRTVarCreate {
+    include_type: 'constant';
+    value: any;
+}
+export type RTVarFormCreate = BaseRTVarCreate & {
+    include_type: 'form';
+} & (
+        {
+            // form_id가 없는 경우 새로운 form 생성
+            form_id?: undefined | null;
+            form_name?: string;
+            // 생성한 form의 RTVarData 정의
+            data: RTVarData;
+        } | {
+            // form_id가 있으면 존재하는 form을 참조
+            form_id: string;
+        }
+    )