freelang-editor 11.7.4

package/src/stdlib-ai-native.ts

@@ -0,0 +1,176 @@
+// FreeLang v9: AI 네이티브 모듈
+// Phase 71: ai-call / rag-search / embed / similarity / chunk-text / prompt-template
+
+const toSerializable = (obj: any): any => {
+  if (obj instanceof Map) return Object.fromEntries(obj);
+  if (Array.isArray(obj)) return obj.map(toSerializable);
+  if (typeof obj === "object" && obj !== null) {
+    const result: any = {};
+    for (const [k, v] of Object.entries(obj)) {
+      result[k] = toSerializable(v);
+    }
+    return result;
+  }
+  return obj;
+};
+
+/**
+ * AI 네이티브 블록 생성
+ * - API 키 없으면 Mock 모드로 동작
+ * - embed는 FreeLang GPT 서버(30113) 연동 시도 후 fallback
+ */
+export function createAiNativeModule(): Record<string, Function> {
+  return {
+    // ── AI 모델 직접 호출 ────────────────────────────────────────────
+    "ai-call": async (model: string, prompt: any): Promise<string> => {
+      const anthropicKey = process.env.ANTHROPIC_API_KEY;
+      const openaiKey = process.env.OPENAI_API_KEY;
+      const apiKey = anthropicKey || openaiKey;
+
+      const promptStr =
+        typeof prompt === "string"
+          ? prompt
+          : typeof prompt === "object" && prompt !== null
+          ? String((prompt as any).prompt || JSON.stringify(prompt))
+          : String(prompt);
+
+      if (!apiKey) {
+        // Mock 모드: 구조화된 더미 응답
+        return `[AI Mock Response] Model: ${model}, Prompt: ${promptStr.slice(0, 50)}...`;
+      }
+
+      // Anthropic API (claude 계열)
+      if (anthropicKey && (model.startsWith("claude") || model.startsWith("anthropic"))) {
+        try {
+          const contextStr =
+            typeof prompt === "object" && prompt !== null && (prompt as any).context
+              ? `\n\nContext:\n${JSON.stringify((prompt as any).context)}`
+              : "";
+          const maxTokens =
+            typeof prompt === "object" && prompt !== null
+              ? Number((prompt as any)["max-tokens"] || (prompt as any).maxTokens || 1024)
+              : 1024;
+
+          const res = await fetch("https://api.anthropic.com/v1/messages", {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json",
+              "x-api-key": anthropicKey,
+              "anthropic-version": "2023-06-01",
+            },
+            body: JSON.stringify(toSerializable({
+              model: model === "claude-3" ? "claude-3-haiku-20240307" : model,
+              max_tokens: maxTokens,
+              messages: [
+                { role: "user", content: promptStr + contextStr },
+              ],
+            })),
+          });
+          if (res.ok) {
+            const data = (await res.json()) as any;
+            return data?.content?.[0]?.text ?? "[AI: empty response]";
+          }
+        } catch (e) {
+          return `[AI Error] ${String(e)}`;
+        }
+      }
+
+      // OpenAI API (gpt 계열)
+      if (openaiKey && (model.startsWith("gpt") || model.startsWith("openai"))) {
+        try {
+          const res = await fetch("https://api.openai.com/v1/chat/completions", {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json",
+              Authorization: `Bearer ${openaiKey}`,
+            },
+            body: JSON.stringify(toSerializable({
+              model: model === "gpt-4" ? "gpt-4-turbo-preview" : model,
+              messages: [{ role: "user", content: promptStr }],
+            })),
+          });
+          if (res.ok) {
+            const data = (await res.json()) as any;
+            return data?.choices?.[0]?.message?.content ?? "[AI: empty response]";
+          }
+        } catch (e) {
+          return `[AI Error] ${String(e)}`;
+        }
+      }
+
+      // fallback mock
+      return `[AI Mock Response] Model: ${model}, Prompt: ${promptStr.slice(0, 50)}...`;
+    },
+
+    // ── RAG 검색 ────────────────────────────────────────────────────
+    "rag-search": (query: string, opts: any): Array<{ content: string; score: number; source: string }> => {
+      const kb = opts?.kb ?? opts?.["kb"] ?? "default";
+      const limit = Number(opts?.limit ?? opts?.["limit"] ?? 5);
+      const mockResults = [
+        { content: `Mock RAG result for: ${query}`, score: 0.95, source: String(kb) },
+        { content: `Related: ${query} — context from ${kb}`, score: 0.82, source: String(kb) },
+        { content: `Additional info about ${query}`, score: 0.74, source: String(kb) },
+        { content: `Background: ${query} overview`, score: 0.61, source: String(kb) },
+        { content: `Reference: ${query} documentation`, score: 0.53, source: String(kb) },
+      ];
+      return mockResults.slice(0, limit);
+    },
+
+    // ── 임베딩 생성 ─────────────────────────────────────────────────
+    "embed": async (text: string): Promise<number[]> => {
+      const gptPort = process.env.FREELANG_GPT_PORT ?? "30113";
+      try {
+        const res = await fetch(`http://localhost:${gptPort}/api/embed`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(toSerializable({ text })),
+          signal: AbortSignal.timeout ? AbortSignal.timeout(3000) : undefined,
+        });
+        if (res.ok) {
+          const data = (await res.json()) as any;
+          if (Array.isArray(data?.embedding)) return data.embedding;
+        }
+      } catch {
+        // GPT 서버 미실행 — mock fallback
+      }
+      // Mock: 텍스트 해시 기반 더미 벡터 (10차원)
+      return Array.from({ length: 10 }, (_, i) =>
+        Math.sin((text.charCodeAt(i % text.length) + i * 7) * 0.1)
+      );
+    },
+
+    // ── 코사인 유사도 ────────────────────────────────────────────────
+    "similarity": (v1: number[], v2: number[]): number => {
+      if (!Array.isArray(v1) || !Array.isArray(v2)) return 0;
+      const len = Math.min(v1.length, v2.length);
+      if (len === 0) return 0;
+      let dot = 0, n1 = 0, n2 = 0;
+      for (let i = 0; i < len; i++) {
+        dot += v1[i] * v2[i];
+        n1 += v1[i] ** 2;
+        n2 += v2[i] ** 2;
+      }
+      const denom = Math.sqrt(n1) * Math.sqrt(n2);
+      if (denom === 0) return 0;
+      return dot / denom;
+    },
+
+    // ── 텍스트 청킹 (RAG 준비용) ─────────────────────────────────────
+    "chunk-text": (text: string, size: number = 512, overlap: number = 50): string[] => {
+      if (typeof text !== "string" || text.length === 0) return [];
+      const step = Math.max(1, size - overlap);
+      const chunks: string[] = [];
+      for (let i = 0; i < text.length; i += step) {
+        chunks.push(text.slice(i, i + size));
+        if (i + size >= text.length) break;
+      }
+      return chunks;
+    },
+
+    // ── 프롬프트 템플릿 변수 치환 ────────────────────────────────────
+    "prompt-template": (template: string, vars: Record<string, any>): string => {
+      if (typeof template !== "string") return String(template);
+      return template.replace(/\{(\w+)\}/g, (_, k) => String(vars?.[k] ?? ""));
+    },
+  };
+}

package/src/stdlib-ai-workflow.ts

@@ -0,0 +1,308 @@
+// FreeLang v11 — AI Workflow stdlib
+// AI를 편하게 쓰기 위한 고수준 함수 모음
+// ai / ai-pipe / ai-each / ai-if / ai-retry / ai-parallel / ai-chain
+
+const DEFAULT_MODEL = process.env.FL_AI_MODEL ?? "claude-3-haiku-20240307";
+
+async function callLLM(model: string, prompt: string): Promise<string> {
+  const anthropicKey = process.env.ANTHROPIC_API_KEY;
+  const openaiKey    = process.env.OPENAI_API_KEY;
+  const ollamaUrl    = process.env.OLLAMA_URL ?? "http://localhost:11434";
+
+  // Ollama (로컬 LLM)
+  if (!anthropicKey && !openaiKey) {
+    try {
+      const res = await fetch(`${ollamaUrl}/api/generate`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ model, prompt, stream: false }),
+        signal: AbortSignal.timeout(30000),
+      });
+      if (res.ok) {
+        const data = await res.json() as any;
+        return data?.response ?? "[Ollama: empty]";
+      }
+    } catch (_e) {}
+    return `[AI Mock] ${prompt.slice(0, 60)}...`;
+  }
+
+  // Anthropic
+  if (anthropicKey && !model.startsWith("gpt")) {
+    const res = await fetch("https://api.anthropic.com/v1/messages", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": anthropicKey,
+        "anthropic-version": "2023-06-01",
+      },
+      body: JSON.stringify({
+        model: model === "claude" ? DEFAULT_MODEL : model,
+        max_tokens: 1024,
+        messages: [{ role: "user", content: prompt }],
+      }),
+    });
+    if (res.ok) {
+      const data = await res.json() as any;
+      return data?.content?.[0]?.text ?? "[Anthropic: empty]";
+    }
+  }
+
+  // OpenAI
+  if (openaiKey) {
+    const res = await fetch("https://api.openai.com/v1/chat/completions", {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "Authorization": `Bearer ${openaiKey}` },
+      body: JSON.stringify({
+        model: model.startsWith("gpt") ? model : "gpt-4o-mini",
+        messages: [{ role: "user", content: prompt }],
+      }),
+    });
+    if (res.ok) {
+      const data = await res.json() as any;
+      return data?.choices?.[0]?.message?.content ?? "[OpenAI: empty]";
+    }
+  }
+
+  return `[AI Mock] ${prompt.slice(0, 60)}...`;
+}
+
+// 템플릿 변수 치환: "안녕 {name}" + {name: "김"} → "안녕 김"
+function renderPrompt(template: string, vars?: Record<string, any>): string {
+  if (!vars) return template;
+  return template.replace(/\{(\w+)\}/g, (_, k) => String(vars[k] ?? ""));
+}
+
+export function createAiWorkflowModule(): Record<string, Function> {
+  return {
+    // ── 기본 AI 호출 ──────────────────────────────────────────────
+    // ai prompt [vars] [model] -> string
+    // (ai "요약해줘: {text}" {:text "내용..."})
+    "ai": async (prompt: string, vars?: any, model?: string): Promise<string> => {
+      const m = model ?? DEFAULT_MODEL;
+      const p = renderPrompt(String(prompt), vars && typeof vars === "object" ? vars : undefined);
+      return callLLM(m, p);
+    },
+
+    // ── AI 파이프라인 ─────────────────────────────────────────────
+    // ai-pipe input fn1 fn2 fn3 ... -> 최종 결과
+    // 각 fn은 (fn [$x] (ai "..." {:x $x})) 형태
+    // (ai-pipe "원문" summarize translate format)
+    "ai-pipe": async (input: any, ...fns: Function[]): Promise<any> => {
+      let val = input;
+      for (const fn of fns) {
+        const result = fn(val);
+        val = result instanceof Promise ? await result : result;
+      }
+      return val;
+    },
+
+    // ── 배열 AI 병렬 처리 ─────────────────────────────────────────
+    // ai-each items prompt [model] -> [string]
+    // {item} 에 각 요소 자동 대입
+    // (ai-each ["사과" "바나나"] "이것의 칼로리는? {item}")
+    "ai-each": async (items: any[], prompt: string, model?: string): Promise<string[]> => {
+      if (!Array.isArray(items)) return [];
+      const m = model ?? DEFAULT_MODEL;
+      return Promise.all(items.map((item) => {
+        const vars = typeof item === "object" ? item : { item: String(item) };
+        return callLLM(m, renderPrompt(prompt, vars));
+      }));
+    },
+
+    // ── AI 조건 분기 ──────────────────────────────────────────────
+    // ai-if question input then-fn else-fn -> any
+    // LLM이 yes/no 판단 → then/else 실행
+    // (ai-if "스팸인가?" text spam-handler normal-handler)
+    "ai-if": async (
+      question: string,
+      input: any,
+      thenFn: Function,
+      elseFn: Function,
+      model?: string
+    ): Promise<any> => {
+      const m = model ?? DEFAULT_MODEL;
+      const verdict = await callLLM(m,
+        `다음 질문에 반드시 "yes" 또는 "no" 한 단어만 답하세요.\n질문: ${question}\n대상: ${String(input)}`
+      );
+      const isYes = verdict.toLowerCase().trim().startsWith("yes");
+      const result = isYes ? thenFn(input) : elseFn(input);
+      return result instanceof Promise ? await result : result;
+    },
+
+    // ── AI 재시도 ─────────────────────────────────────────────────
+    // ai-retry prompt vars maxTry [model] -> string
+    // 실패 시 최대 maxTry번 재시도
+    "ai-retry": async (prompt: string, vars: any, maxTry: number = 3, model?: string): Promise<string> => {
+      const m = model ?? DEFAULT_MODEL;
+      const p = renderPrompt(String(prompt), vars);
+      for (let i = 0; i < maxTry; i++) {
+        try {
+          const result = await callLLM(m, p);
+          if (result && !result.startsWith("[AI Mock]")) return result;
+        } catch (_e) {}
+        await new Promise((r) => setTimeout(r, 1000 * (i + 1)));
+      }
+      return await callLLM(m, p);
+    },
+
+    // ── AI 병렬 실행 ──────────────────────────────────────────────
+    // ai-parallel [{prompt vars model?} ...] -> [string]
+    // 여러 AI 호출을 동시에 실행
+    "ai-parallel": async (tasks: Array<{prompt: string; vars?: any; model?: string}>): Promise<string[]> => {
+      return Promise.all(tasks.map((t) =>
+        callLLM(t.model ?? DEFAULT_MODEL, renderPrompt(t.prompt, t.vars))
+      ));
+    },
+
+    // ── AI 체인 (메모리 포함) ────────────────────────────────────
+    // ai-chain steps input -> {result steps_log}
+    // 각 step = {prompt role?}  이전 결과가 자동으로 다음 프롬프트에 전달
+    "ai-chain": async (
+      steps: Array<{prompt: string; role?: string}>,
+      input: string,
+      model?: string
+    ): Promise<{result: string; log: string[]}> => {
+      const m = model ?? DEFAULT_MODEL;
+      let context = input;
+      const log: string[] = [];
+      for (const step of steps) {
+        const p = renderPrompt(step.prompt, { input: context, prev: context });
+        context = await callLLM(m, p);
+        log.push(context);
+      }
+      return { result: context, log };
+    },
+
+    // ── AI 스트리밍 (SSE 응답용) ──────────────────────────────────
+    // ai-stream prompt onChunk [model] -> null  (콜백으로 청크 전달)
+    "ai-stream": async (
+      prompt: string,
+      onChunk: Function,
+      model?: string
+    ): Promise<void> => {
+      const anthropicKey = process.env.ANTHROPIC_API_KEY;
+      const m = model ?? DEFAULT_MODEL;
+
+      if (anthropicKey) {
+        const res = await fetch("https://api.anthropic.com/v1/messages", {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "x-api-key": anthropicKey,
+            "anthropic-version": "2023-06-01",
+          },
+          body: JSON.stringify({
+            model: m,
+            max_tokens: 1024,
+            stream: true,
+            messages: [{ role: "user", content: prompt }],
+          }),
+        });
+        if (res.ok && res.body) {
+          const reader = res.body.getReader();
+          const decoder = new TextDecoder();
+          while (true) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            const text = decoder.decode(value);
+            for (const line of text.split("\n")) {
+              if (!line.startsWith("data: ")) continue;
+              try {
+                const data = JSON.parse(line.slice(6)) as any;
+                const chunk = data?.delta?.text;
+                if (chunk) onChunk(chunk);
+              } catch (_e) {}
+            }
+          }
+          return;
+        }
+      }
+
+      // fallback: 한 번에 전달
+      const result = await callLLM(m, prompt);
+      onChunk(result);
+    },
+
+    // ── Tool Calling 루프 ─────────────────────────────────────────
+    // ai-tools prompt tools [model] -> string
+    // tools = [{name desc fn}]  LLM이 필요한 툴 선택 → FL 함수 실행 → 결과 재전달
+    "ai-tools": async (
+      prompt: string,
+      tools: Array<{name: string; desc: string; fn: Function}>,
+      model?: string
+    ): Promise<string> => {
+      const m = model ?? DEFAULT_MODEL;
+      const toolDesc = tools.map((t) => `- ${t.name}: ${t.desc}`).join("\n");
+      const systemPrompt = `당신은 도구를 사용해 문제를 해결합니다.
+사용 가능한 도구:
+${toolDesc}
+
+도구를 사용할 때는 반드시 다음 형식으로만 응답하세요:
+TOOL: <도구이름>
+INPUT: <입력값>
+
+모든 도구 사용이 끝나면 DONE: <최종답변> 형식으로 답하세요.`;
+
+      let context = `${systemPrompt}\n\n사용자: ${prompt}`;
+      let iterations = 0;
+
+      while (iterations < 5) {
+        const response = await callLLM(m, context);
+        if (response.startsWith("DONE:")) {
+          return response.slice(5).trim();
+        }
+        const toolMatch = response.match(/TOOL:\s*(\w+)\s*\nINPUT:\s*(.+)/s);
+        if (!toolMatch) return response;
+
+        const [, toolName, toolInput] = toolMatch;
+        const tool = tools.find((t) => t.name === toolName);
+        if (!tool) return response;
+
+        const toolResult = tool.fn(toolInput.trim());
+        const result = toolResult instanceof Promise ? await toolResult : toolResult;
+        context += `\n\n어시스턴트: ${response}\n도구 결과: ${String(result)}`;
+        iterations++;
+      }
+      return await callLLM(m, context);
+    },
+
+    // ── Ollama 전용 ───────────────────────────────────────────────
+    // ollama prompt [model] -> string  (로컬 LLM 직접 호출)
+    "ollama": async (prompt: string, model: string = "llama3"): Promise<string> => {
+      const url = process.env.OLLAMA_URL ?? "http://localhost:11434";
+      try {
+        const res = await fetch(`${url}/api/generate`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ model, prompt, stream: false }),
+          signal: AbortSignal.timeout(60000),
+        });
+        if (res.ok) {
+          const data = await res.json() as any;
+          return data?.response ?? "[Ollama: empty]";
+        }
+        return `[Ollama Error] ${res.status}`;
+      } catch (e: any) {
+        return `[Ollama Error] ${e.message}`;
+      }
+    },
+
+    // ollama-models -> [string]  (설치된 모델 목록)
+    "ollama-models": async (): Promise<string[]> => {
+      const url = process.env.OLLAMA_URL ?? "http://localhost:11434";
+      try {
+        const res = await fetch(`${url}/api/tags`);
+        if (res.ok) {
+          const data = await res.json() as any;
+          return (data?.models ?? []).map((m: any) => m.name);
+        }
+      } catch (_e) {}
+      return [];
+    },
+
+    // ── 프롬프트 렌더 ─────────────────────────────────────────────
+    // ai-render template vars -> string
+    "ai-render": (template: string, vars: Record<string, any>): string =>
+      renderPrompt(String(template), vars),
+  };
+}

package/src/stdlib-ai.ts

@@ -0,0 +1,180 @@
+// FreeLang v9 AI Standard Library — Phase 100
+// Integrates: maybe-type, cot, tot, reflect, context-window, result-type, error-system, tool-registry, agent, self-improve
+
+import { Maybe, None, Uncertain, maybe, none, confident, mostLikely } from './maybe-type';
+import { ChainOfThought, ThoughtStep, CoTResult } from './cot';
+import { TreeOfThought, ThoughtBranch, ToTResult } from './tot';
+import { Reflector, ReflectionCriteria, ReflectionResult, CRITERIA } from './reflect';
+import { ContextManager, ContextEntry, ContextStrategy } from './context-window';
+import { ok, err, isOk, isErr, unwrapOr, Result, Ok, Err, ErrorCategory } from './result-type';
+import { AIErrorSystem, RecoveryStrategy } from './error-system';
+import { ToolRegistry, ToolDefinition, ToolResult } from './tool-registry';
+import { FLAgent, AgentOptions, AgentState, AgentAction } from './agent';
+import { SelfImprover, SelfImproveConfig, SelfImproveState } from './self-improve';
+
+// ── MaybeValue 타입 별칭 (외부 노출용) ────────────────────────────────────
+export type MaybeValue<T> = Maybe<T> | None;
+
+// ── defaultCriteria: CRITERIA 기반 기본 반영 기준 ─────────────────────────
+export const defaultCriteria: ReflectionCriteria[] = Object.values(CRITERIA);
+
+// ── AISession ─────────────────────────────────────────────────────────────
+// AI 추론 세션: 하나의 세션에서 COT/TOT/REFLECT/CONTEXT를 함께 관리
+export class AISession {
+  public cot: ChainOfThought;
+  public tot: TreeOfThought;
+  public reflector: Reflector;
+  public context: ContextManager;
+  public tools: ToolRegistry;
+  private results: Map<string, any> = new Map();
+
+  constructor(options: {
+    maxTokens?: number;
+    goal?: string;
+  } = {}) {
+    this.cot = new ChainOfThought();
+    this.tot = new TreeOfThought();
+    this.reflector = new Reflector();
+    // defaultCriteria 추가
+    defaultCriteria.forEach(c => this.reflector.addCriteria(c));
+    this.context = new ContextManager(options.maxTokens ?? 4096, 'sliding');
+    this.tools = new ToolRegistry();
+  }
+
+  // 결과 저장/조회
+  store(key: string, value: any): void { this.results.set(key, value); }
+  recall(key: string): any { return this.results.get(key); }
+
+  // 세션 요약 마크다운
+  summary(): string {
+    const stats = this.context.stats();
+    return [
+      '# AI Session Summary',
+      '',
+      this.cot.toMarkdown(),
+      '',
+      `**Context stats**: ${JSON.stringify(stats)}`,
+      '',
+      `**Stored results**: ${[...this.results.keys()].join(', ') || '(없음)'}`,
+    ].join('\n');
+  }
+}
+
+// ── AIWorkflow ────────────────────────────────────────────────────────────
+// AI 워크플로우 빌더 (체이닝 API)
+export class AIWorkflow {
+  private steps: Array<() => any> = [];
+  private results: any[] = [];
+
+  step(fn: () => any): AIWorkflow {
+    this.steps.push(fn);
+    return this;
+  }
+
+  async run(): Promise<any[]> {
+    this.results = [];
+    for (const step of this.steps) {
+      const result = await Promise.resolve(step());
+      this.results.push(result);
+    }
+    return this.results;
+  }
+
+  last(): any { return this.results[this.results.length - 1]; }
+}
+
+// ── 빠른 유틸리티 함수들 ──────────────────────────────────────────────────
+
+export function quickReason(goal: string, steps: string[]): string {
+  const cot = new ChainOfThought();
+  steps.forEach((s, i) => cot.step(`Step ${i + 1}`, () => s));
+  return cot.toMarkdown();
+}
+
+export function quickReflect(
+  output: any,
+  threshold = 0.7
+): { passed: boolean; score: number; feedback: string[] } {
+  const reflector = new Reflector();
+  defaultCriteria.forEach(c => reflector.addCriteria(c));
+  const result = reflector.reflect(output, threshold);
+  return {
+    passed: result.passed,
+    score: result.totalScore,
+    feedback: result.feedback,
+  };
+}
+
+export function quickMaybe<T>(value: T, confidence: number): MaybeValue<T> {
+  return maybe(confidence, value);
+}
+
+// ── AIStdLib — FL 내장 함수로 노출할 API ──────────────────────────────────
+export const AIStdLib = {
+  // 세션
+  session: (opts?: { maxTokens?: number; goal?: string }) => new AISession(opts),
+  workflow: () => new AIWorkflow(),
+
+  // 개별 AI 블록
+  cot: (_goal?: string) => new ChainOfThought(),
+  tot: (_goal?: string) => new TreeOfThought(),
+  reflect: () => {
+    const r = new Reflector();
+    defaultCriteria.forEach(c => r.addCriteria(c));
+    return r;
+  },
+  context: (maxTokens: number) => new ContextManager(maxTokens, 'sliding'),
+  tools: () => new ToolRegistry(),
+  agent: (goal: string, maxSteps: number) => new FLAgent({ goal, maxSteps }),
+  improve: <T>(config: SelfImproveConfig<T>) => new SelfImprover<T>(config),
+
+  // Result 타입
+  ok,
+  err,
+  isOk,
+  isErr,
+  unwrapOr,
+
+  // Maybe 타입
+  maybe,
+  none,
+  confident,
+  mostLikely,
+
+  // 에러 처리
+  errorSystem: () => new AIErrorSystem(),
+
+  // 빠른 유틸
+  quickReason,
+  quickReflect,
+  quickMaybe,
+};
+
+export default AIStdLib;
+
+// 타입 재수출
+export type {
+  Maybe,
+  None,
+  Uncertain,
+  ThoughtStep,
+  CoTResult,
+  ThoughtBranch,
+  ToTResult,
+  ReflectionCriteria,
+  ReflectionResult,
+  ContextEntry,
+  ContextStrategy,
+  Result,
+  Ok,
+  Err,
+  ErrorCategory,
+  RecoveryStrategy,
+  ToolDefinition,
+  ToolResult,
+  AgentOptions,
+  AgentState,
+  AgentAction,
+  SelfImproveConfig,
+  SelfImproveState,
+};